boltz-api 0.30.3

package/src/resources/protein/library-screen.ts

@@ -0,0 +1,4306 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { CursorPage, type CursorPageParams, PagePromise } from '../../core/pagination';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+/**
+ * Screen an existing library of proteins against a target structure. Results are scored by binding confidence (likelihood of protein-protein interaction) and structure confidence.
+ */
+export class LibraryScreen extends APIResource {
+  /**
+   * Retrieve a library screen by ID, including progress and status
+   *
+   * @example
+   * ```ts
+   * const libraryScreen =
+   *   await client.protein.libraryScreen.retrieve('id');
+   * ```
+   */
+  retrieve(
+    id: string,
+    query: LibraryScreenRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<LibraryScreenRetrieveResponse> {
+    return this._client.get(path`/compute/v1/protein/library-screen/${id}`, { query, ...options });
+  }
+
+  /**
+   * List protein library screens, optionally filtered by workspace
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const libraryScreenListResponse of client.protein.libraryScreen.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    query: LibraryScreenListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<LibraryScreenListResponsesCursorPage, LibraryScreenListResponse> {
+    return this._client.getAPIList(
+      '/compute/v1/protein/library-screen',
+      CursorPage<LibraryScreenListResponse>,
+      { query, ...options },
+    );
+  }
+
+  /**
+   * Permanently delete the input, output, and result data associated with this
+   * library screen. The library screen record itself is retained with a
+   * `data_deleted_at` timestamp. This action is irreversible.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.protein.libraryScreen.deleteData('id');
+   * ```
+   */
+  deleteData(id: string, options?: RequestOptions): APIPromise<LibraryScreenDeleteDataResponse> {
+    return this._client.post(path`/compute/v1/protein/library-screen/${id}/delete-data`, options);
+  }
+
+  /**
+   * Estimate the cost of a protein library screen without creating any resource or
+   * consuming GPU.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.protein.libraryScreen.estimateCost({
+   *     proteins: [
+   *       {
+   *         entities: [
+   *           {
+   *             chain_ids: ['string'],
+   *             type: 'protein',
+   *             value: 'value',
+   *           },
+   *         ],
+   *       },
+   *     ],
+   *     target: {
+   *       chain_selection: {
+   *         A: {
+   *           chain_type: 'polymer',
+   *           crop_residues: [
+   *             0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12,
+   *           ],
+   *         },
+   *       },
+   *       structure: {
+   *         type: 'url',
+   *         url: 'https://example.com',
+   *       },
+   *       type: 'structure_template',
+   *     },
+   *   });
+   * ```
+   */
+  estimateCost(
+    body: LibraryScreenEstimateCostParams,
+    options?: RequestOptions,
+  ): APIPromise<LibraryScreenEstimateCostResponse> {
+    return this._client.post('/compute/v1/protein/library-screen/estimate-cost', { body, ...options });
+  }
+
+  /**
+   * Retrieve paginated results from a protein library screen
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const libraryScreenListResultsResponse of client.protein.libraryScreen.listResults(
+   *   'id',
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  listResults(
+    id: string,
+    query: LibraryScreenListResultsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<LibraryScreenListResultsResponsesCursorPage, LibraryScreenListResultsResponse> {
+    return this._client.getAPIList(
+      path`/compute/v1/protein/library-screen/${id}/results`,
+      CursorPage<LibraryScreenListResultsResponse>,
+      { query, ...options },
+    );
+  }
+
+  /**
+   * Screen a set of protein candidates against a target
+   *
+   * @example
+   * ```ts
+   * const response = await client.protein.libraryScreen.start({
+   *   proteins: [
+   *     {
+   *       entities: [
+   *         {
+   *           chain_ids: ['string'],
+   *           type: 'protein',
+   *           value: 'value',
+   *         },
+   *       ],
+   *     },
+   *   ],
+   *   target: {
+   *     chain_selection: {
+   *       A: {
+   *         chain_type: 'polymer',
+   *         crop_residues: [
+   *           0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12,
+   *         ],
+   *       },
+   *     },
+   *     structure: { type: 'url', url: 'https://example.com' },
+   *     type: 'structure_template',
+   *   },
+   * });
+   * ```
+   */
+  start(body: LibraryScreenStartParams, options?: RequestOptions): APIPromise<LibraryScreenStartResponse> {
+    return this._client.post('/compute/v1/protein/library-screen', { body, ...options });
+  }
+
+  /**
+   * Stop an in-progress protein library screen early
+   *
+   * @example
+   * ```ts
+   * const response = await client.protein.libraryScreen.stop(
+   *   'id',
+   * );
+   * ```
+   */
+  stop(id: string, options?: RequestOptions): APIPromise<LibraryScreenStopResponse> {
+    return this._client.post(path`/compute/v1/protein/library-screen/${id}/stop`, options);
+  }
+}
+
+export type LibraryScreenListResponsesCursorPage = CursorPage<LibraryScreenListResponse>;
+
+export type LibraryScreenListResultsResponsesCursorPage = CursorPage<LibraryScreenListResultsResponse>;
+
+/**
+ * A protein library screening engine run
+ */
+export interface LibraryScreenRetrieveResponse {
+  /**
+   * Unique ProteinLibraryScreen identifier
+   */
+  id: string;
+
+  completed_at: string | null;
+
+  created_at: string;
+
+  /**
+   * When the input, output, and result data was permanently deleted. Null if data
+   * has not been deleted.
+   */
+  data_deleted_at: string | null;
+
+  /**
+   * Engine used for protein library screen
+   */
+  engine: 'boltz-protein-screen';
+
+  /**
+   * Engine version used for protein library screen
+   */
+  engine_version: string;
+
+  error: LibraryScreenRetrieveResponse.Error | null;
+
+  /**
+   * Pipeline input (null if data deleted)
+   */
+  input: LibraryScreenRetrieveResponse.Input | null;
+
+  /**
+   * Whether this resource was created with a live API key.
+   */
+  livemode: boolean;
+
+  progress: LibraryScreenRetrieveResponse.Progress | null;
+
+  started_at: string | null;
+
+  status: 'pending' | 'running' | 'succeeded' | 'failed' | 'stopped';
+
+  stopped_at: string | null;
+
+  /**
+   * Workspace ID
+   */
+  workspace_id: string;
+
+  /**
+   * Client-provided idempotency key
+   */
+  idempotency_key?: string;
+}
+
+export namespace LibraryScreenRetrieveResponse {
+  export interface Error {
+    /**
+     * Machine-readable error code
+     */
+    code: string;
+
+    /**
+     * Human-readable error message
+     */
+    message: string;
+
+    /**
+     * Additional field-level error details keyed by input path, when available.
+     */
+    details?: unknown;
+  }
+
+  /**
+   * Pipeline input (null if data deleted)
+   */
+  export interface Input {
+    proteins: Input.Proteins;
+
+    /**
+     * Target specification (structure template or template-free)
+     */
+    target: Input.StructureTemplateTargetResponse | Input.NoTemplateTargetResponse;
+  }
+
+  export namespace Input {
+    export interface Proteins {
+      /**
+       * URL to download the file
+       */
+      url: string;
+
+      /**
+       * When the presigned URL expires
+       */
+      url_expires_at: string;
+    }
+
+    /**
+     * Target defined by an uploaded 3D structure (CIF or PDB file). Only chains
+     * included in chain_selection are used.
+     */
+    export interface StructureTemplateTargetResponse {
+      /**
+       * Chains selected from the uploaded structure, keyed by chain ID. Only chains
+       * listed here are included in the engine run — any chains omitted from this
+       * mapping are ignored. Each value defines which residues to keep, which are
+       * epitope residues, and which are flexible.
+       */
+      chain_selection: {
+        [key: string]:
+          | StructureTemplateTargetResponse.StructureTemplateTargetPolymerChainSpec
+          | StructureTemplateTargetResponse.StructureTemplateTargetLigandChainSpec;
+      };
+
+      structure: StructureTemplateTargetResponse.Structure;
+
+      type: 'structure_template';
+    }
+
+    export namespace StructureTemplateTargetResponse {
+      /**
+       * Per-chain specification for a polymer (protein/RNA/DNA) chain in a structure
+       * template target.
+       */
+      export interface StructureTemplateTargetPolymerChainSpec {
+        chain_type: 'polymer';
+
+        /**
+         * 0-indexed residue indices to retain from this chain, or 'all' to keep all
+         * residues. Residues not listed are excluded from the engine run.
+         */
+        crop_residues: Array<number> | 'all';
+
+        /**
+         * 0-indexed residue indices where binder contact is desired (the epitope). All
+         * indices must be present in crop_residues.
+         */
+        epitope_residues?: Array<number>;
+
+        /**
+         * 0-indexed residue indices allowed to move during design (e.g. flexible loop
+         * regions). All indices must be present in crop_residues.
+         */
+        flexible_residues?: Array<number>;
+      }
+
+      /**
+       * Per-chain specification for a ligand chain in a structure template target. The
+       * full ligand is always included.
+       */
+      export interface StructureTemplateTargetLigandChainSpec {
+        chain_type: 'ligand';
+      }
+
+      export interface Structure {
+        /**
+         * URL to download the file
+         */
+        url: string;
+
+        /**
+         * When the presigned URL expires
+         */
+        url_expires_at: string;
+      }
+    }
+
+    /**
+     * Target defined by sequences only, without a 3D structure template
+     */
+    export interface NoTemplateTargetResponse {
+      /**
+       * Entities (proteins, RNA, DNA, ligands) defining the target complex.
+       */
+      entities: Array<
+        | NoTemplateTargetResponse.ProteinEntityResponse
+        | NoTemplateTargetResponse.RnaEntityResponse
+        | NoTemplateTargetResponse.DnaEntityResponse
+        | NoTemplateTargetResponse.LigandCcdEntityResponse
+        | NoTemplateTargetResponse.LigandSmilesEntityResponse
+      >;
+
+      type: 'no_template';
+
+      /**
+       * Covalent bond constraints between atoms in the target complex. Atom-level ligand
+       * references currently support ligand_ccd only; ligand_smiles is unsupported.
+       */
+      bonds?: Array<NoTemplateTargetResponse.Bond>;
+
+      /**
+       * Structural constraints (pocket and contact). Atom-level ligand references
+       * currently support ligand_ccd only; ligand_smiles is unsupported.
+       */
+      constraints?: Array<
+        NoTemplateTargetResponse.PocketConstraintResponse | NoTemplateTargetResponse.ContactConstraintResponse
+      >;
+
+      /**
+       * Chain IDs of ligand entities that are part of the binding epitope. Ligands are
+       * marked as epitope in full (no residue-level selection).
+       */
+      epitope_ligand_chains?: Array<string>;
+
+      /**
+       * Polymer chain residues where binder contact is desired (the epitope). Each key
+       * is a chain ID of a polymer entity, each value is an array of 0-indexed residue
+       * indices.
+       */
+      epitope_residues?: { [key: string]: Array<number> };
+    }
+
+    export namespace NoTemplateTargetResponse {
+      export interface ProteinEntityResponse {
+        /**
+         * Chain IDs for this entity
+         */
+        chain_ids: Array<string>;
+
+        type: 'protein';
+
+        /**
+         * Amino acid sequence (one-letter codes)
+         */
+        value: string;
+
+        /**
+         * Whether the sequence is cyclic
+         */
+        cyclic?: boolean;
+
+        /**
+         * Post-translational modifications. Optional; defaults to an empty list when
+         * omitted.
+         */
+        modifications?: Array<
+          ProteinEntityResponse.CcdModificationResponse | ProteinEntityResponse.SmilesModificationResponse
+        >;
+      }
+
+      export namespace ProteinEntityResponse {
+        export interface CcdModificationResponse {
+          /**
+           * 0-based index of the residue to modify
+           */
+          residue_index: number;
+
+          type: 'ccd';
+
+          /**
+           * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+           * phosphoserine)
+           */
+          value: string;
+        }
+
+        export interface SmilesModificationResponse {
+          /**
+           * 0-based index of the residue to modify
+           */
+          residue_index: number;
+
+          type: 'smiles';
+
+          /**
+           * SMILES string for the modification
+           */
+          value: string;
+        }
+      }
+
+      export interface RnaEntityResponse {
+        /**
+         * Chain IDs for this entity
+         */
+        chain_ids: Array<string>;
+
+        type: 'rna';
+
+        /**
+         * RNA nucleotide sequence (A, C, G, U, N)
+         */
+        value: string;
+
+        /**
+         * Whether the sequence is cyclic
+         */
+        cyclic?: boolean;
+
+        /**
+         * Chemical modifications. Optional; defaults to an empty list when omitted.
+         */
+        modifications?: Array<
+          RnaEntityResponse.CcdModificationResponse | RnaEntityResponse.SmilesModificationResponse
+        >;
+      }
+
+      export namespace RnaEntityResponse {
+        export interface CcdModificationResponse {
+          /**
+           * 0-based index of the residue to modify
+           */
+          residue_index: number;
+
+          type: 'ccd';
+
+          /**
+           * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+           * phosphoserine)
+           */
+          value: string;
+        }
+
+        export interface SmilesModificationResponse {
+          /**
+           * 0-based index of the residue to modify
+           */
+          residue_index: number;
+
+          type: 'smiles';
+
+          /**
+           * SMILES string for the modification
+           */
+          value: string;
+        }
+      }
+
+      export interface DnaEntityResponse {
+        /**
+         * Chain IDs for this entity
+         */
+        chain_ids: Array<string>;
+
+        type: 'dna';
+
+        /**
+         * DNA nucleotide sequence (A, C, G, T, N)
+         */
+        value: string;
+
+        /**
+         * Whether the sequence is cyclic
+         */
+        cyclic?: boolean;
+
+        /**
+         * Chemical modifications. Optional; defaults to an empty list when omitted.
+         */
+        modifications?: Array<
+          DnaEntityResponse.CcdModificationResponse | DnaEntityResponse.SmilesModificationResponse
+        >;
+      }
+
+      export namespace DnaEntityResponse {
+        export interface CcdModificationResponse {
+          /**
+           * 0-based index of the residue to modify
+           */
+          residue_index: number;
+
+          type: 'ccd';
+
+          /**
+           * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+           * phosphoserine)
+           */
+          value: string;
+        }
+
+        export interface SmilesModificationResponse {
+          /**
+           * 0-based index of the residue to modify
+           */
+          residue_index: number;
+
+          type: 'smiles';
+
+          /**
+           * SMILES string for the modification
+           */
+          value: string;
+        }
+      }
+
+      export interface LigandCcdEntityResponse {
+        /**
+         * Chain IDs for this ligand
+         */
+        chain_ids: Array<string>;
+
+        type: 'ligand_ccd';
+
+        /**
+         * CCD code (e.g., ATP, ADP)
+         */
+        value: string;
+      }
+
+      export interface LigandSmilesEntityResponse {
+        /**
+         * Chain IDs for this ligand
+         */
+        chain_ids: Array<string>;
+
+        type: 'ligand_smiles';
+
+        /**
+         * SMILES string representing the ligand
+         */
+        value: string;
+      }
+
+      /**
+       * Bond between two atoms. Atom-level ligand references currently support
+       * ligand_ccd entities only; ligand_smiles is unsupported.
+       */
+      export interface Bond {
+        /**
+         * Ligand atom reference. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        atom1: Bond.LigandAtomResponse | Bond.PolymerAtomResponse;
+
+        /**
+         * Ligand atom reference. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        atom2: Bond.LigandAtomResponse | Bond.PolymerAtomResponse;
+      }
+
+      export namespace Bond {
+        /**
+         * Ligand atom reference. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        export interface LigandAtomResponse {
+          /**
+           * Standardized atom name (verifiable in CIF file on RCSB). Atom-level references
+           * to ligand_smiles entities are currently unsupported; use ligand_ccd instead.
+           */
+          atom_name: string;
+
+          /**
+           * Chain ID containing the atom
+           */
+          chain_id: string;
+
+          type: 'ligand_atom';
+        }
+
+        export interface PolymerAtomResponse {
+          /**
+           * Standardized atom name (verifiable in CIF file on RCSB)
+           */
+          atom_name: string;
+
+          /**
+           * Chain ID containing the atom
+           */
+          chain_id: string;
+
+          /**
+           * 0-based residue index
+           */
+          residue_index: number;
+
+          type: 'polymer_atom';
+        }
+
+        /**
+         * Ligand atom reference. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        export interface LigandAtomResponse {
+          /**
+           * Standardized atom name (verifiable in CIF file on RCSB). Atom-level references
+           * to ligand_smiles entities are currently unsupported; use ligand_ccd instead.
+           */
+          atom_name: string;
+
+          /**
+           * Chain ID containing the atom
+           */
+          chain_id: string;
+
+          type: 'ligand_atom';
+        }
+
+        export interface PolymerAtomResponse {
+          /**
+           * Standardized atom name (verifiable in CIF file on RCSB)
+           */
+          atom_name: string;
+
+          /**
+           * Chain ID containing the atom
+           */
+          chain_id: string;
+
+          /**
+           * 0-based residue index
+           */
+          residue_index: number;
+
+          type: 'polymer_atom';
+        }
+      }
+
+      /**
+       * Constrains the binder to interact with specific pocket residues on the target.
+       */
+      export interface PocketConstraintResponse {
+        /**
+         * Chain ID of the binder molecule
+         */
+        binder_chain_id: string;
+
+        /**
+         * Binding pocket residues keyed by chain ID. Each key is a chain ID (e.g. "A") and
+         * the value is an array of 0-indexed residue indices that define the pocket on
+         * that chain.
+         */
+        contact_residues: { [key: string]: Array<number> };
+
+        /**
+         * Maximum allowed distance in Angstroms between binder and pocket residues.
+         * Typical range: 4-8 A.
+         */
+        max_distance_angstrom: number;
+
+        type: 'pocket';
+
+        /**
+         * Whether to force the constraint
+         */
+        force?: boolean;
+      }
+
+      /**
+       * Contact constraint between two tokens. Atom-level ligand references currently
+       * support ligand_ccd entities only; ligand_smiles is unsupported.
+       */
+      export interface ContactConstraintResponse {
+        /**
+         * Maximum distance in Angstroms
+         */
+        max_distance_angstrom: number;
+
+        /**
+         * Ligand contact token. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        token1:
+          | ContactConstraintResponse.PolymerContactTokenResponse
+          | ContactConstraintResponse.LigandContactTokenResponse;
+
+        /**
+         * Ligand contact token. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        token2:
+          | ContactConstraintResponse.PolymerContactTokenResponse
+          | ContactConstraintResponse.LigandContactTokenResponse;
+
+        type: 'contact';
+
+        /**
+         * Whether to force the constraint
+         */
+        force?: boolean;
+      }
+
+      export namespace ContactConstraintResponse {
+        export interface PolymerContactTokenResponse {
+          /**
+           * Chain ID
+           */
+          chain_id: string;
+
+          /**
+           * 0-based residue index
+           */
+          residue_index: number;
+
+          type: 'polymer_contact';
+        }
+
+        /**
+         * Ligand contact token. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        export interface LigandContactTokenResponse {
+          /**
+           * Atom name. Atom-level references to ligand_smiles entities are currently
+           * unsupported; use ligand_ccd instead.
+           */
+          atom_name: string;
+
+          /**
+           * Chain ID
+           */
+          chain_id: string;
+
+          type: 'ligand_contact';
+        }
+
+        export interface PolymerContactTokenResponse {
+          /**
+           * Chain ID
+           */
+          chain_id: string;
+
+          /**
+           * 0-based residue index
+           */
+          residue_index: number;
+
+          type: 'polymer_contact';
+        }
+
+        /**
+         * Ligand contact token. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        export interface LigandContactTokenResponse {
+          /**
+           * Atom name. Atom-level references to ligand_smiles entities are currently
+           * unsupported; use ligand_ccd instead.
+           */
+          atom_name: string;
+
+          /**
+           * Chain ID
+           */
+          chain_id: string;
+
+          type: 'ligand_contact';
+        }
+      }
+    }
+  }
+
+  export interface Progress {
+    /**
+     * Number of accepted proteins that reached terminal failure during screening.
+     */
+    num_proteins_failed: number;
+
+    /**
+     * Number of accepted proteins that produced usable screening results.
+     */
+    num_proteins_screened: number;
+
+    /**
+     * Total number of proteins accepted into the screening run.
+     */
+    total_proteins_to_screen: number;
+
+    /**
+     * ID of the latest result
+     */
+    latest_result_id?: string;
+  }
+}
+
+/**
+ * Summary of a protein library screening engine run (excludes input)
+ */
+export interface LibraryScreenListResponse {
+  /**
+   * Unique ProteinLibraryScreenSummary identifier
+   */
+  id: string;
+
+  completed_at: string | null;
+
+  created_at: string;
+
+  /**
+   * When the input, output, and result data was permanently deleted. Null if data
+   * has not been deleted.
+   */
+  data_deleted_at: string | null;
+
+  /**
+   * Engine used for protein library screen
+   */
+  engine: 'boltz-protein-screen';
+
+  /**
+   * Engine version used for protein library screen
+   */
+  engine_version: string;
+
+  error: LibraryScreenListResponse.Error | null;
+
+  /**
+   * Whether this resource was created with a live API key.
+   */
+  livemode: boolean;
+
+  progress: LibraryScreenListResponse.Progress | null;
+
+  started_at: string | null;
+
+  status: 'pending' | 'running' | 'succeeded' | 'failed' | 'stopped';
+
+  stopped_at: string | null;
+
+  /**
+   * Workspace ID
+   */
+  workspace_id: string;
+
+  /**
+   * Client-provided idempotency key
+   */
+  idempotency_key?: string;
+}
+
+export namespace LibraryScreenListResponse {
+  export interface Error {
+    /**
+     * Machine-readable error code
+     */
+    code: string;
+
+    /**
+     * Human-readable error message
+     */
+    message: string;
+
+    /**
+     * Additional field-level error details keyed by input path, when available.
+     */
+    details?: unknown;
+  }
+
+  export interface Progress {
+    /**
+     * Number of accepted proteins that reached terminal failure during screening.
+     */
+    num_proteins_failed: number;
+
+    /**
+     * Number of accepted proteins that produced usable screening results.
+     */
+    num_proteins_screened: number;
+
+    /**
+     * Total number of proteins accepted into the screening run.
+     */
+    total_proteins_to_screen: number;
+
+    /**
+     * ID of the latest result
+     */
+    latest_result_id?: string;
+  }
+}
+
+export interface LibraryScreenDeleteDataResponse {
+  /**
+   * ID of the resource whose data was deleted
+   */
+  id: string;
+
+  data_deleted: true;
+
+  /**
+   * When the data was deleted
+   */
+  data_deleted_at: string;
+}
+
+/**
+ * Estimate response with monetary values encoded as decimal strings to preserve
+ * precision.
+ */
+export interface LibraryScreenEstimateCostResponse {
+  /**
+   * Cost breakdown for the billed application.
+   */
+  breakdown: LibraryScreenEstimateCostResponse.Breakdown;
+
+  disclaimer: string;
+
+  /**
+   * Estimated total cost as a decimal string
+   */
+  estimated_cost_usd: string;
+}
+
+export namespace LibraryScreenEstimateCostResponse {
+  /**
+   * Cost breakdown for the billed application.
+   */
+  export interface Breakdown {
+    application:
+      | 'structure_and_binding'
+      | 'small_molecule_design'
+      | 'small_molecule_library_screen'
+      | 'protein_design'
+      | 'protein_library_screen'
+      | 'adme';
+
+    /**
+     * Estimated cost per displayed unit as a decimal string, rounded up to 4 decimal
+     * places. This may include token-size multipliers or generation overhead;
+     * estimated_cost_usd is the authoritative total.
+     */
+    cost_per_unit_usd: string;
+
+    /**
+     * Number of units shown for the estimate. For structure-and-binding, this is the
+     * requested number of samples. For protein and small-molecule design/screen
+     * endpoints, this is the requested number of proteins or molecules.
+     */
+    num_units: number;
+  }
+}
+
+/**
+ * Result for a single screened protein
+ */
+export interface LibraryScreenListResultsResponse {
+  /**
+   * Unique result ID
+   */
+  id: string;
+
+  artifacts: LibraryScreenListResultsResponse.Artifacts;
+
+  created_at: string;
+
+  /**
+   * Entities of the screened complex. Includes both screened and fixed entities from
+   * the input.
+   */
+  entities: Array<
+    | LibraryScreenListResultsResponse.ProteinEntity
+    | LibraryScreenListResultsResponse.RnaEntity
+    | LibraryScreenListResultsResponse.DnaEntity
+    | LibraryScreenListResultsResponse.LigandCcdEntity
+    | LibraryScreenListResultsResponse.LigandSmilesEntity
+  >;
+
+  /**
+   * Structural and binding quality metrics for a screened protein
+   */
+  metrics: LibraryScreenListResultsResponse.Metrics;
+
+  /**
+   * Client-provided identifier for this protein, if provided
+   */
+  external_id?: string;
+
+  /**
+   * Warnings about potential quality issues with this result.
+   */
+  warnings?: Array<LibraryScreenListResultsResponse.Warning>;
+}
+
+export namespace LibraryScreenListResultsResponse {
+  export interface Artifacts {
+    archive: Artifacts.Archive;
+
+    structure: Artifacts.Structure;
+  }
+
+  export namespace Artifacts {
+    export interface Archive {
+      /**
+       * URL to download the file
+       */
+      url: string;
+
+      /**
+       * When the presigned URL expires
+       */
+      url_expires_at: string;
+    }
+
+    export interface Structure {
+      /**
+       * URL to download the file
+       */
+      url: string;
+
+      /**
+       * When the presigned URL expires
+       */
+      url_expires_at: string;
+    }
+  }
+
+  export interface ProteinEntity {
+    /**
+     * Chain IDs for this entity
+     */
+    chain_ids: Array<string>;
+
+    type: 'protein';
+
+    /**
+     * Amino acid sequence (one-letter codes)
+     */
+    value: string;
+
+    /**
+     * Whether the sequence is cyclic
+     */
+    cyclic?: boolean;
+
+    /**
+     * Post-translational modifications. Optional; defaults to an empty list when
+     * omitted.
+     */
+    modifications?: Array<ProteinEntity.CcdModification | ProteinEntity.SmilesModification>;
+  }
+
+  export namespace ProteinEntity {
+    export interface CcdModification {
+      /**
+       * 0-based index of the residue to modify
+       */
+      residue_index: number;
+
+      type: 'ccd';
+
+      /**
+       * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+       * phosphoserine)
+       */
+      value: string;
+    }
+
+    export interface SmilesModification {
+      /**
+       * 0-based index of the residue to modify
+       */
+      residue_index: number;
+
+      type: 'smiles';
+
+      /**
+       * SMILES string for the modification
+       */
+      value: string;
+    }
+  }
+
+  export interface RnaEntity {
+    /**
+     * Chain IDs for this entity
+     */
+    chain_ids: Array<string>;
+
+    type: 'rna';
+
+    /**
+     * RNA nucleotide sequence (A, C, G, U, N)
+     */
+    value: string;
+
+    /**
+     * Whether the sequence is cyclic
+     */
+    cyclic?: boolean;
+
+    /**
+     * Chemical modifications. Optional; defaults to an empty list when omitted.
+     */
+    modifications?: Array<RnaEntity.CcdModification | RnaEntity.SmilesModification>;
+  }
+
+  export namespace RnaEntity {
+    export interface CcdModification {
+      /**
+       * 0-based index of the residue to modify
+       */
+      residue_index: number;
+
+      type: 'ccd';
+
+      /**
+       * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+       * phosphoserine)
+       */
+      value: string;
+    }
+
+    export interface SmilesModification {
+      /**
+       * 0-based index of the residue to modify
+       */
+      residue_index: number;
+
+      type: 'smiles';
+
+      /**
+       * SMILES string for the modification
+       */
+      value: string;
+    }
+  }
+
+  export interface DnaEntity {
+    /**
+     * Chain IDs for this entity
+     */
+    chain_ids: Array<string>;
+
+    type: 'dna';
+
+    /**
+     * DNA nucleotide sequence (A, C, G, T, N)
+     */
+    value: string;
+
+    /**
+     * Whether the sequence is cyclic
+     */
+    cyclic?: boolean;
+
+    /**
+     * Chemical modifications. Optional; defaults to an empty list when omitted.
+     */
+    modifications?: Array<DnaEntity.CcdModification | DnaEntity.SmilesModification>;
+  }
+
+  export namespace DnaEntity {
+    export interface CcdModification {
+      /**
+       * 0-based index of the residue to modify
+       */
+      residue_index: number;
+
+      type: 'ccd';
+
+      /**
+       * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+       * phosphoserine)
+       */
+      value: string;
+    }
+
+    export interface SmilesModification {
+      /**
+       * 0-based index of the residue to modify
+       */
+      residue_index: number;
+
+      type: 'smiles';
+
+      /**
+       * SMILES string for the modification
+       */
+      value: string;
+    }
+  }
+
+  export interface LigandCcdEntity {
+    /**
+     * Chain IDs for this ligand
+     */
+    chain_ids: Array<string>;
+
+    type: 'ligand_ccd';
+
+    /**
+     * CCD code (e.g., ATP, ADP)
+     */
+    value: string;
+  }
+
+  export interface LigandSmilesEntity {
+    /**
+     * Chain IDs for this ligand
+     */
+    chain_ids: Array<string>;
+
+    type: 'ligand_smiles';
+
+    /**
+     * SMILES string representing the ligand
+     */
+    value: string;
+  }
+
+  /**
+   * Structural and binding quality metrics for a screened protein
+   */
+  export interface Metrics {
+    /**
+     * Confidence that the protein binds the target (0-1). Primary metric for hit
+     * discovery.
+     */
+    binding_confidence: number;
+
+    /**
+     * Fraction of the sequence forming alpha helices (0-1).
+     */
+    helix_fraction: number;
+
+    /**
+     * Interface predicted TM score (0-1). Confidence in the protein-protein interface.
+     */
+    iptm: number;
+
+    /**
+     * Fraction of the sequence in coil/loop regions (0-1).
+     */
+    loop_fraction: number;
+
+    /**
+     * Minimum predicted aligned error at the interface (Angstroms). Lower values
+     * indicate higher confidence.
+     */
+    min_interaction_pae: number;
+
+    /**
+     * Fraction of the sequence forming beta sheets (0-1).
+     */
+    sheet_fraction: number;
+
+    /**
+     * Confidence in the predicted 3D structure (0-1).
+     */
+    structure_confidence: number;
+  }
+
+  /**
+   * A warning about a potential quality issue with a result
+   */
+  export interface Warning {
+    /**
+     * Machine-readable warning code (e.g. "low_confidence", "unusual_geometry")
+     */
+    code: string;
+
+    /**
+     * Human-readable description of the warning
+     */
+    message: string;
+  }
+}
+
+/**
+ * A protein library screening engine run
+ */
+export interface LibraryScreenStartResponse {
+  /**
+   * Unique ProteinLibraryScreen identifier
+   */
+  id: string;
+
+  completed_at: string | null;
+
+  created_at: string;
+
+  /**
+   * When the input, output, and result data was permanently deleted. Null if data
+   * has not been deleted.
+   */
+  data_deleted_at: string | null;
+
+  /**
+   * Engine used for protein library screen
+   */
+  engine: 'boltz-protein-screen';
+
+  /**
+   * Engine version used for protein library screen
+   */
+  engine_version: string;
+
+  error: LibraryScreenStartResponse.Error | null;
+
+  /**
+   * Pipeline input (null if data deleted)
+   */
+  input: LibraryScreenStartResponse.Input | null;
+
+  /**
+   * Whether this resource was created with a live API key.
+   */
+  livemode: boolean;
+
+  progress: LibraryScreenStartResponse.Progress | null;
+
+  started_at: string | null;
+
+  status: 'pending' | 'running' | 'succeeded' | 'failed' | 'stopped';
+
+  stopped_at: string | null;
+
+  /**
+   * Workspace ID
+   */
+  workspace_id: string;
+
+  /**
+   * Client-provided idempotency key
+   */
+  idempotency_key?: string;
+}
+
+export namespace LibraryScreenStartResponse {
+  export interface Error {
+    /**
+     * Machine-readable error code
+     */
+    code: string;
+
+    /**
+     * Human-readable error message
+     */
+    message: string;
+
+    /**
+     * Additional field-level error details keyed by input path, when available.
+     */
+    details?: unknown;
+  }
+
+  /**
+   * Pipeline input (null if data deleted)
+   */
+  export interface Input {
+    proteins: Input.Proteins;
+
+    /**
+     * Target specification (structure template or template-free)
+     */
+    target: Input.StructureTemplateTargetResponse | Input.NoTemplateTargetResponse;
+  }
+
+  export namespace Input {
+    export interface Proteins {
+      /**
+       * URL to download the file
+       */
+      url: string;
+
+      /**
+       * When the presigned URL expires
+       */
+      url_expires_at: string;
+    }
+
+    /**
+     * Target defined by an uploaded 3D structure (CIF or PDB file). Only chains
+     * included in chain_selection are used.
+     */
+    export interface StructureTemplateTargetResponse {
+      /**
+       * Chains selected from the uploaded structure, keyed by chain ID. Only chains
+       * listed here are included in the engine run — any chains omitted from this
+       * mapping are ignored. Each value defines which residues to keep, which are
+       * epitope residues, and which are flexible.
+       */
+      chain_selection: {
+        [key: string]:
+          | StructureTemplateTargetResponse.StructureTemplateTargetPolymerChainSpec
+          | StructureTemplateTargetResponse.StructureTemplateTargetLigandChainSpec;
+      };
+
+      structure: StructureTemplateTargetResponse.Structure;
+
+      type: 'structure_template';
+    }
+
+    export namespace StructureTemplateTargetResponse {
+      /**
+       * Per-chain specification for a polymer (protein/RNA/DNA) chain in a structure
+       * template target.
+       */
+      export interface StructureTemplateTargetPolymerChainSpec {
+        chain_type: 'polymer';
+
+        /**
+         * 0-indexed residue indices to retain from this chain, or 'all' to keep all
+         * residues. Residues not listed are excluded from the engine run.
+         */
+        crop_residues: Array<number> | 'all';
+
+        /**
+         * 0-indexed residue indices where binder contact is desired (the epitope). All
+         * indices must be present in crop_residues.
+         */
+        epitope_residues?: Array<number>;
+
+        /**
+         * 0-indexed residue indices allowed to move during design (e.g. flexible loop
+         * regions). All indices must be present in crop_residues.
+         */
+        flexible_residues?: Array<number>;
+      }
+
+      /**
+       * Per-chain specification for a ligand chain in a structure template target. The
+       * full ligand is always included.
+       */
+      export interface StructureTemplateTargetLigandChainSpec {
+        chain_type: 'ligand';
+      }
+
+      export interface Structure {
+        /**
+         * URL to download the file
+         */
+        url: string;
+
+        /**
+         * When the presigned URL expires
+         */
+        url_expires_at: string;
+      }
+    }
+
+    /**
+     * Target defined by sequences only, without a 3D structure template
+     */
+    export interface NoTemplateTargetResponse {
+      /**
+       * Entities (proteins, RNA, DNA, ligands) defining the target complex.
+       */
+      entities: Array<
+        | NoTemplateTargetResponse.ProteinEntityResponse
+        | NoTemplateTargetResponse.RnaEntityResponse
+        | NoTemplateTargetResponse.DnaEntityResponse
+        | NoTemplateTargetResponse.LigandCcdEntityResponse
+        | NoTemplateTargetResponse.LigandSmilesEntityResponse
+      >;
+
+      type: 'no_template';
+
+      /**
+       * Covalent bond constraints between atoms in the target complex. Atom-level ligand
+       * references currently support ligand_ccd only; ligand_smiles is unsupported.
+       */
+      bonds?: Array<NoTemplateTargetResponse.Bond>;
+
+      /**
+       * Structural constraints (pocket and contact). Atom-level ligand references
+       * currently support ligand_ccd only; ligand_smiles is unsupported.
+       */
+      constraints?: Array<
+        NoTemplateTargetResponse.PocketConstraintResponse | NoTemplateTargetResponse.ContactConstraintResponse
+      >;
+
+      /**
+       * Chain IDs of ligand entities that are part of the binding epitope. Ligands are
+       * marked as epitope in full (no residue-level selection).
+       */
+      epitope_ligand_chains?: Array<string>;
+
+      /**
+       * Polymer chain residues where binder contact is desired (the epitope). Each key
+       * is a chain ID of a polymer entity, each value is an array of 0-indexed residue
+       * indices.
+       */
+      epitope_residues?: { [key: string]: Array<number> };
+    }
+
+    export namespace NoTemplateTargetResponse {
+      export interface ProteinEntityResponse {
+        /**
+         * Chain IDs for this entity
+         */
+        chain_ids: Array<string>;
+
+        type: 'protein';
+
+        /**
+         * Amino acid sequence (one-letter codes)
+         */
+        value: string;
+
+        /**
+         * Whether the sequence is cyclic
+         */
+        cyclic?: boolean;
+
+        /**
+         * Post-translational modifications. Optional; defaults to an empty list when
+         * omitted.
+         */
+        modifications?: Array<
+          ProteinEntityResponse.CcdModificationResponse | ProteinEntityResponse.SmilesModificationResponse
+        >;
+      }
+
+      export namespace ProteinEntityResponse {
+        export interface CcdModificationResponse {
+          /**
+           * 0-based index of the residue to modify
+           */
+          residue_index: number;
+
+          type: 'ccd';
+
+          /**
+           * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+           * phosphoserine)
+           */
+          value: string;
+        }
+
+        export interface SmilesModificationResponse {
+          /**
+           * 0-based index of the residue to modify
+           */
+          residue_index: number;
+
+          type: 'smiles';
+
+          /**
+           * SMILES string for the modification
+           */
+          value: string;
+        }
+      }
+
+      export interface RnaEntityResponse {
+        /**
+         * Chain IDs for this entity
+         */
+        chain_ids: Array<string>;
+
+        type: 'rna';
+
+        /**
+         * RNA nucleotide sequence (A, C, G, U, N)
+         */
+        value: string;
+
+        /**
+         * Whether the sequence is cyclic
+         */
+        cyclic?: boolean;
+
+        /**
+         * Chemical modifications. Optional; defaults to an empty list when omitted.
+         */
+        modifications?: Array<
+          RnaEntityResponse.CcdModificationResponse | RnaEntityResponse.SmilesModificationResponse
+        >;
+      }
+
+      export namespace RnaEntityResponse {
+        export interface CcdModificationResponse {
+          /**
+           * 0-based index of the residue to modify
+           */
+          residue_index: number;
+
+          type: 'ccd';
+
+          /**
+           * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+           * phosphoserine)
+           */
+          value: string;
+        }
+
+        export interface SmilesModificationResponse {
+          /**
+           * 0-based index of the residue to modify
+           */
+          residue_index: number;
+
+          type: 'smiles';
+
+          /**
+           * SMILES string for the modification
+           */
+          value: string;
+        }
+      }
+
+      export interface DnaEntityResponse {
+        /**
+         * Chain IDs for this entity
+         */
+        chain_ids: Array<string>;
+
+        type: 'dna';
+
+        /**
+         * DNA nucleotide sequence (A, C, G, T, N)
+         */
+        value: string;
+
+        /**
+         * Whether the sequence is cyclic
+         */
+        cyclic?: boolean;
+
+        /**
+         * Chemical modifications. Optional; defaults to an empty list when omitted.
+         */
+        modifications?: Array<
+          DnaEntityResponse.CcdModificationResponse | DnaEntityResponse.SmilesModificationResponse
+        >;
+      }
+
+      export namespace DnaEntityResponse {
+        export interface CcdModificationResponse {
+          /**
+           * 0-based index of the residue to modify
+           */
+          residue_index: number;
+
+          type: 'ccd';
+
+          /**
+           * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+           * phosphoserine)
+           */
+          value: string;
+        }
+
+        export interface SmilesModificationResponse {
+          /**
+           * 0-based index of the residue to modify
+           */
+          residue_index: number;
+
+          type: 'smiles';
+
+          /**
+           * SMILES string for the modification
+           */
+          value: string;
+        }
+      }
+
+      export interface LigandCcdEntityResponse {
+        /**
+         * Chain IDs for this ligand
+         */
+        chain_ids: Array<string>;
+
+        type: 'ligand_ccd';
+
+        /**
+         * CCD code (e.g., ATP, ADP)
+         */
+        value: string;
+      }
+
+      export interface LigandSmilesEntityResponse {
+        /**
+         * Chain IDs for this ligand
+         */
+        chain_ids: Array<string>;
+
+        type: 'ligand_smiles';
+
+        /**
+         * SMILES string representing the ligand
+         */
+        value: string;
+      }
+
+      /**
+       * Bond between two atoms. Atom-level ligand references currently support
+       * ligand_ccd entities only; ligand_smiles is unsupported.
+       */
+      export interface Bond {
+        /**
+         * Ligand atom reference. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        atom1: Bond.LigandAtomResponse | Bond.PolymerAtomResponse;
+
+        /**
+         * Ligand atom reference. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        atom2: Bond.LigandAtomResponse | Bond.PolymerAtomResponse;
+      }
+
+      export namespace Bond {
+        /**
+         * Ligand atom reference. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        export interface LigandAtomResponse {
+          /**
+           * Standardized atom name (verifiable in CIF file on RCSB). Atom-level references
+           * to ligand_smiles entities are currently unsupported; use ligand_ccd instead.
+           */
+          atom_name: string;
+
+          /**
+           * Chain ID containing the atom
+           */
+          chain_id: string;
+
+          type: 'ligand_atom';
+        }
+
+        export interface PolymerAtomResponse {
+          /**
+           * Standardized atom name (verifiable in CIF file on RCSB)
+           */
+          atom_name: string;
+
+          /**
+           * Chain ID containing the atom
+           */
+          chain_id: string;
+
+          /**
+           * 0-based residue index
+           */
+          residue_index: number;
+
+          type: 'polymer_atom';
+        }
+
+        /**
+         * Ligand atom reference. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        export interface LigandAtomResponse {
+          /**
+           * Standardized atom name (verifiable in CIF file on RCSB). Atom-level references
+           * to ligand_smiles entities are currently unsupported; use ligand_ccd instead.
+           */
+          atom_name: string;
+
+          /**
+           * Chain ID containing the atom
+           */
+          chain_id: string;
+
+          type: 'ligand_atom';
+        }
+
+        export interface PolymerAtomResponse {
+          /**
+           * Standardized atom name (verifiable in CIF file on RCSB)
+           */
+          atom_name: string;
+
+          /**
+           * Chain ID containing the atom
+           */
+          chain_id: string;
+
+          /**
+           * 0-based residue index
+           */
+          residue_index: number;
+
+          type: 'polymer_atom';
+        }
+      }
+
+      /**
+       * Constrains the binder to interact with specific pocket residues on the target.
+       */
+      export interface PocketConstraintResponse {
+        /**
+         * Chain ID of the binder molecule
+         */
+        binder_chain_id: string;
+
+        /**
+         * Binding pocket residues keyed by chain ID. Each key is a chain ID (e.g. "A") and
+         * the value is an array of 0-indexed residue indices that define the pocket on
+         * that chain.
+         */
+        contact_residues: { [key: string]: Array<number> };
+
+        /**
+         * Maximum allowed distance in Angstroms between binder and pocket residues.
+         * Typical range: 4-8 A.
+         */
+        max_distance_angstrom: number;
+
+        type: 'pocket';
+
+        /**
+         * Whether to force the constraint
+         */
+        force?: boolean;
+      }
+
+      /**
+       * Contact constraint between two tokens. Atom-level ligand references currently
+       * support ligand_ccd entities only; ligand_smiles is unsupported.
+       */
+      export interface ContactConstraintResponse {
+        /**
+         * Maximum distance in Angstroms
+         */
+        max_distance_angstrom: number;
+
+        /**
+         * Ligand contact token. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        token1:
+          | ContactConstraintResponse.PolymerContactTokenResponse
+          | ContactConstraintResponse.LigandContactTokenResponse;
+
+        /**
+         * Ligand contact token. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        token2:
+          | ContactConstraintResponse.PolymerContactTokenResponse
+          | ContactConstraintResponse.LigandContactTokenResponse;
+
+        type: 'contact';
+
+        /**
+         * Whether to force the constraint
+         */
+        force?: boolean;
+      }
+
+      export namespace ContactConstraintResponse {
+        export interface PolymerContactTokenResponse {
+          /**
+           * Chain ID
+           */
+          chain_id: string;
+
+          /**
+           * 0-based residue index
+           */
+          residue_index: number;
+
+          type: 'polymer_contact';
+        }
+
+        /**
+         * Ligand contact token. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        export interface LigandContactTokenResponse {
+          /**
+           * Atom name. Atom-level references to ligand_smiles entities are currently
+           * unsupported; use ligand_ccd instead.
+           */
+          atom_name: string;
+
+          /**
+           * Chain ID
+           */
+          chain_id: string;
+
+          type: 'ligand_contact';
+        }
+
+        export interface PolymerContactTokenResponse {
+          /**
+           * Chain ID
+           */
+          chain_id: string;
+
+          /**
+           * 0-based residue index
+           */
+          residue_index: number;
+
+          type: 'polymer_contact';
+        }
+
+        /**
+         * Ligand contact token. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        export interface LigandContactTokenResponse {
+          /**
+           * Atom name. Atom-level references to ligand_smiles entities are currently
+           * unsupported; use ligand_ccd instead.
+           */
+          atom_name: string;
+
+          /**
+           * Chain ID
+           */
+          chain_id: string;
+
+          type: 'ligand_contact';
+        }
+      }
+    }
+  }
+
+  export interface Progress {
+    /**
+     * Number of accepted proteins that reached terminal failure during screening.
+     */
+    num_proteins_failed: number;
+
+    /**
+     * Number of accepted proteins that produced usable screening results.
+     */
+    num_proteins_screened: number;
+
+    /**
+     * Total number of proteins accepted into the screening run.
+     */
+    total_proteins_to_screen: number;
+
+    /**
+     * ID of the latest result
+     */
+    latest_result_id?: string;
+  }
+}
+
+/**
+ * A protein library screening engine run
+ */
+export interface LibraryScreenStopResponse {
+  /**
+   * Unique ProteinLibraryScreen identifier
+   */
+  id: string;
+
+  completed_at: string | null;
+
+  created_at: string;
+
+  /**
+   * When the input, output, and result data was permanently deleted. Null if data
+   * has not been deleted.
+   */
+  data_deleted_at: string | null;
+
+  /**
+   * Engine used for protein library screen
+   */
+  engine: 'boltz-protein-screen';
+
+  /**
+   * Engine version used for protein library screen
+   */
+  engine_version: string;
+
+  error: LibraryScreenStopResponse.Error | null;
+
+  /**
+   * Pipeline input (null if data deleted)
+   */
+  input: LibraryScreenStopResponse.Input | null;
+
+  /**
+   * Whether this resource was created with a live API key.
+   */
+  livemode: boolean;
+
+  progress: LibraryScreenStopResponse.Progress | null;
+
+  started_at: string | null;
+
+  status: 'pending' | 'running' | 'succeeded' | 'failed' | 'stopped';
+
+  stopped_at: string | null;
+
+  /**
+   * Workspace ID
+   */
+  workspace_id: string;
+
+  /**
+   * Client-provided idempotency key
+   */
+  idempotency_key?: string;
+}
+
+export namespace LibraryScreenStopResponse {
+  export interface Error {
+    /**
+     * Machine-readable error code
+     */
+    code: string;
+
+    /**
+     * Human-readable error message
+     */
+    message: string;
+
+    /**
+     * Additional field-level error details keyed by input path, when available.
+     */
+    details?: unknown;
+  }
+
+  /**
+   * Pipeline input (null if data deleted)
+   */
+  export interface Input {
+    proteins: Input.Proteins;
+
+    /**
+     * Target specification (structure template or template-free)
+     */
+    target: Input.StructureTemplateTargetResponse | Input.NoTemplateTargetResponse;
+  }
+
+  export namespace Input {
+    export interface Proteins {
+      /**
+       * URL to download the file
+       */
+      url: string;
+
+      /**
+       * When the presigned URL expires
+       */
+      url_expires_at: string;
+    }
+
+    /**
+     * Target defined by an uploaded 3D structure (CIF or PDB file). Only chains
+     * included in chain_selection are used.
+     */
+    export interface StructureTemplateTargetResponse {
+      /**
+       * Chains selected from the uploaded structure, keyed by chain ID. Only chains
+       * listed here are included in the engine run — any chains omitted from this
+       * mapping are ignored. Each value defines which residues to keep, which are
+       * epitope residues, and which are flexible.
+       */
+      chain_selection: {
+        [key: string]:
+          | StructureTemplateTargetResponse.StructureTemplateTargetPolymerChainSpec
+          | StructureTemplateTargetResponse.StructureTemplateTargetLigandChainSpec;
+      };
+
+      structure: StructureTemplateTargetResponse.Structure;
+
+      type: 'structure_template';
+    }
+
+    export namespace StructureTemplateTargetResponse {
+      /**
+       * Per-chain specification for a polymer (protein/RNA/DNA) chain in a structure
+       * template target.
+       */
+      export interface StructureTemplateTargetPolymerChainSpec {
+        chain_type: 'polymer';
+
+        /**
+         * 0-indexed residue indices to retain from this chain, or 'all' to keep all
+         * residues. Residues not listed are excluded from the engine run.
+         */
+        crop_residues: Array<number> | 'all';
+
+        /**
+         * 0-indexed residue indices where binder contact is desired (the epitope). All
+         * indices must be present in crop_residues.
+         */
+        epitope_residues?: Array<number>;
+
+        /**
+         * 0-indexed residue indices allowed to move during design (e.g. flexible loop
+         * regions). All indices must be present in crop_residues.
+         */
+        flexible_residues?: Array<number>;
+      }
+
+      /**
+       * Per-chain specification for a ligand chain in a structure template target. The
+       * full ligand is always included.
+       */
+      export interface StructureTemplateTargetLigandChainSpec {
+        chain_type: 'ligand';
+      }
+
+      export interface Structure {
+        /**
+         * URL to download the file
+         */
+        url: string;
+
+        /**
+         * When the presigned URL expires
+         */
+        url_expires_at: string;
+      }
+    }
+
+    /**
+     * Target defined by sequences only, without a 3D structure template
+     */
+    export interface NoTemplateTargetResponse {
+      /**
+       * Entities (proteins, RNA, DNA, ligands) defining the target complex.
+       */
+      entities: Array<
+        | NoTemplateTargetResponse.ProteinEntityResponse
+        | NoTemplateTargetResponse.RnaEntityResponse
+        | NoTemplateTargetResponse.DnaEntityResponse
+        | NoTemplateTargetResponse.LigandCcdEntityResponse
+        | NoTemplateTargetResponse.LigandSmilesEntityResponse
+      >;
+
+      type: 'no_template';
+
+      /**
+       * Covalent bond constraints between atoms in the target complex. Atom-level ligand
+       * references currently support ligand_ccd only; ligand_smiles is unsupported.
+       */
+      bonds?: Array<NoTemplateTargetResponse.Bond>;
+
+      /**
+       * Structural constraints (pocket and contact). Atom-level ligand references
+       * currently support ligand_ccd only; ligand_smiles is unsupported.
+       */
+      constraints?: Array<
+        NoTemplateTargetResponse.PocketConstraintResponse | NoTemplateTargetResponse.ContactConstraintResponse
+      >;
+
+      /**
+       * Chain IDs of ligand entities that are part of the binding epitope. Ligands are
+       * marked as epitope in full (no residue-level selection).
+       */
+      epitope_ligand_chains?: Array<string>;
+
+      /**
+       * Polymer chain residues where binder contact is desired (the epitope). Each key
+       * is a chain ID of a polymer entity, each value is an array of 0-indexed residue
+       * indices.
+       */
+      epitope_residues?: { [key: string]: Array<number> };
+    }
+
+    export namespace NoTemplateTargetResponse {
+      export interface ProteinEntityResponse {
+        /**
+         * Chain IDs for this entity
+         */
+        chain_ids: Array<string>;
+
+        type: 'protein';
+
+        /**
+         * Amino acid sequence (one-letter codes)
+         */
+        value: string;
+
+        /**
+         * Whether the sequence is cyclic
+         */
+        cyclic?: boolean;
+
+        /**
+         * Post-translational modifications. Optional; defaults to an empty list when
+         * omitted.
+         */
+        modifications?: Array<
+          ProteinEntityResponse.CcdModificationResponse | ProteinEntityResponse.SmilesModificationResponse
+        >;
+      }
+
+      export namespace ProteinEntityResponse {
+        export interface CcdModificationResponse {
+          /**
+           * 0-based index of the residue to modify
+           */
+          residue_index: number;
+
+          type: 'ccd';
+
+          /**
+           * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+           * phosphoserine)
+           */
+          value: string;
+        }
+
+        export interface SmilesModificationResponse {
+          /**
+           * 0-based index of the residue to modify
+           */
+          residue_index: number;
+
+          type: 'smiles';
+
+          /**
+           * SMILES string for the modification
+           */
+          value: string;
+        }
+      }
+
+      export interface RnaEntityResponse {
+        /**
+         * Chain IDs for this entity
+         */
+        chain_ids: Array<string>;
+
+        type: 'rna';
+
+        /**
+         * RNA nucleotide sequence (A, C, G, U, N)
+         */
+        value: string;
+
+        /**
+         * Whether the sequence is cyclic
+         */
+        cyclic?: boolean;
+
+        /**
+         * Chemical modifications. Optional; defaults to an empty list when omitted.
+         */
+        modifications?: Array<
+          RnaEntityResponse.CcdModificationResponse | RnaEntityResponse.SmilesModificationResponse
+        >;
+      }
+
+      export namespace RnaEntityResponse {
+        export interface CcdModificationResponse {
+          /**
+           * 0-based index of the residue to modify
+           */
+          residue_index: number;
+
+          type: 'ccd';
+
+          /**
+           * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+           * phosphoserine)
+           */
+          value: string;
+        }
+
+        export interface SmilesModificationResponse {
+          /**
+           * 0-based index of the residue to modify
+           */
+          residue_index: number;
+
+          type: 'smiles';
+
+          /**
+           * SMILES string for the modification
+           */
+          value: string;
+        }
+      }
+
+      export interface DnaEntityResponse {
+        /**
+         * Chain IDs for this entity
+         */
+        chain_ids: Array<string>;
+
+        type: 'dna';
+
+        /**
+         * DNA nucleotide sequence (A, C, G, T, N)
+         */
+        value: string;
+
+        /**
+         * Whether the sequence is cyclic
+         */
+        cyclic?: boolean;
+
+        /**
+         * Chemical modifications. Optional; defaults to an empty list when omitted.
+         */
+        modifications?: Array<
+          DnaEntityResponse.CcdModificationResponse | DnaEntityResponse.SmilesModificationResponse
+        >;
+      }
+
+      export namespace DnaEntityResponse {
+        export interface CcdModificationResponse {
+          /**
+           * 0-based index of the residue to modify
+           */
+          residue_index: number;
+
+          type: 'ccd';
+
+          /**
+           * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+           * phosphoserine)
+           */
+          value: string;
+        }
+
+        export interface SmilesModificationResponse {
+          /**
+           * 0-based index of the residue to modify
+           */
+          residue_index: number;
+
+          type: 'smiles';
+
+          /**
+           * SMILES string for the modification
+           */
+          value: string;
+        }
+      }
+
+      export interface LigandCcdEntityResponse {
+        /**
+         * Chain IDs for this ligand
+         */
+        chain_ids: Array<string>;
+
+        type: 'ligand_ccd';
+
+        /**
+         * CCD code (e.g., ATP, ADP)
+         */
+        value: string;
+      }
+
+      export interface LigandSmilesEntityResponse {
+        /**
+         * Chain IDs for this ligand
+         */
+        chain_ids: Array<string>;
+
+        type: 'ligand_smiles';
+
+        /**
+         * SMILES string representing the ligand
+         */
+        value: string;
+      }
+
+      /**
+       * Bond between two atoms. Atom-level ligand references currently support
+       * ligand_ccd entities only; ligand_smiles is unsupported.
+       */
+      export interface Bond {
+        /**
+         * Ligand atom reference. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        atom1: Bond.LigandAtomResponse | Bond.PolymerAtomResponse;
+
+        /**
+         * Ligand atom reference. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        atom2: Bond.LigandAtomResponse | Bond.PolymerAtomResponse;
+      }
+
+      export namespace Bond {
+        /**
+         * Ligand atom reference. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        export interface LigandAtomResponse {
+          /**
+           * Standardized atom name (verifiable in CIF file on RCSB). Atom-level references
+           * to ligand_smiles entities are currently unsupported; use ligand_ccd instead.
+           */
+          atom_name: string;
+
+          /**
+           * Chain ID containing the atom
+           */
+          chain_id: string;
+
+          type: 'ligand_atom';
+        }
+
+        export interface PolymerAtomResponse {
+          /**
+           * Standardized atom name (verifiable in CIF file on RCSB)
+           */
+          atom_name: string;
+
+          /**
+           * Chain ID containing the atom
+           */
+          chain_id: string;
+
+          /**
+           * 0-based residue index
+           */
+          residue_index: number;
+
+          type: 'polymer_atom';
+        }
+
+        /**
+         * Ligand atom reference. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        export interface LigandAtomResponse {
+          /**
+           * Standardized atom name (verifiable in CIF file on RCSB). Atom-level references
+           * to ligand_smiles entities are currently unsupported; use ligand_ccd instead.
+           */
+          atom_name: string;
+
+          /**
+           * Chain ID containing the atom
+           */
+          chain_id: string;
+
+          type: 'ligand_atom';
+        }
+
+        export interface PolymerAtomResponse {
+          /**
+           * Standardized atom name (verifiable in CIF file on RCSB)
+           */
+          atom_name: string;
+
+          /**
+           * Chain ID containing the atom
+           */
+          chain_id: string;
+
+          /**
+           * 0-based residue index
+           */
+          residue_index: number;
+
+          type: 'polymer_atom';
+        }
+      }
+
+      /**
+       * Constrains the binder to interact with specific pocket residues on the target.
+       */
+      export interface PocketConstraintResponse {
+        /**
+         * Chain ID of the binder molecule
+         */
+        binder_chain_id: string;
+
+        /**
+         * Binding pocket residues keyed by chain ID. Each key is a chain ID (e.g. "A") and
+         * the value is an array of 0-indexed residue indices that define the pocket on
+         * that chain.
+         */
+        contact_residues: { [key: string]: Array<number> };
+
+        /**
+         * Maximum allowed distance in Angstroms between binder and pocket residues.
+         * Typical range: 4-8 A.
+         */
+        max_distance_angstrom: number;
+
+        type: 'pocket';
+
+        /**
+         * Whether to force the constraint
+         */
+        force?: boolean;
+      }
+
+      /**
+       * Contact constraint between two tokens. Atom-level ligand references currently
+       * support ligand_ccd entities only; ligand_smiles is unsupported.
+       */
+      export interface ContactConstraintResponse {
+        /**
+         * Maximum distance in Angstroms
+         */
+        max_distance_angstrom: number;
+
+        /**
+         * Ligand contact token. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        token1:
+          | ContactConstraintResponse.PolymerContactTokenResponse
+          | ContactConstraintResponse.LigandContactTokenResponse;
+
+        /**
+         * Ligand contact token. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        token2:
+          | ContactConstraintResponse.PolymerContactTokenResponse
+          | ContactConstraintResponse.LigandContactTokenResponse;
+
+        type: 'contact';
+
+        /**
+         * Whether to force the constraint
+         */
+        force?: boolean;
+      }
+
+      export namespace ContactConstraintResponse {
+        export interface PolymerContactTokenResponse {
+          /**
+           * Chain ID
+           */
+          chain_id: string;
+
+          /**
+           * 0-based residue index
+           */
+          residue_index: number;
+
+          type: 'polymer_contact';
+        }
+
+        /**
+         * Ligand contact token. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        export interface LigandContactTokenResponse {
+          /**
+           * Atom name. Atom-level references to ligand_smiles entities are currently
+           * unsupported; use ligand_ccd instead.
+           */
+          atom_name: string;
+
+          /**
+           * Chain ID
+           */
+          chain_id: string;
+
+          type: 'ligand_contact';
+        }
+
+        export interface PolymerContactTokenResponse {
+          /**
+           * Chain ID
+           */
+          chain_id: string;
+
+          /**
+           * 0-based residue index
+           */
+          residue_index: number;
+
+          type: 'polymer_contact';
+        }
+
+        /**
+         * Ligand contact token. Atom-level ligand references currently support ligand_ccd
+         * entities only; ligand_smiles is unsupported.
+         */
+        export interface LigandContactTokenResponse {
+          /**
+           * Atom name. Atom-level references to ligand_smiles entities are currently
+           * unsupported; use ligand_ccd instead.
+           */
+          atom_name: string;
+
+          /**
+           * Chain ID
+           */
+          chain_id: string;
+
+          type: 'ligand_contact';
+        }
+      }
+    }
+  }
+
+  export interface Progress {
+    /**
+     * Number of accepted proteins that reached terminal failure during screening.
+     */
+    num_proteins_failed: number;
+
+    /**
+     * Number of accepted proteins that produced usable screening results.
+     */
+    num_proteins_screened: number;
+
+    /**
+     * Total number of proteins accepted into the screening run.
+     */
+    total_proteins_to_screen: number;
+
+    /**
+     * ID of the latest result
+     */
+    latest_result_id?: string;
+  }
+}
+
+export interface LibraryScreenRetrieveParams {
+  /**
+   * Workspace ID. Only used with admin API keys. Ignored (or validated) for
+   * workspace-scoped keys.
+   */
+  workspace_id?: string;
+}
+
+export interface LibraryScreenListParams extends CursorPageParams {
+  /**
+   * Filter by workspace ID. Only used with admin API keys. If not provided, defaults
+   * to the workspace associated with the API key, or the default workspace for admin
+   * keys.
+   */
+  workspace_id?: string;
+}
+
+export interface LibraryScreenEstimateCostParams {
+  /**
+   * List of protein entries to screen.
+   */
+  proteins: Array<LibraryScreenEstimateCostParams.Protein>;
+
+  /**
+   * Target specification (structure template or template-free)
+   */
+  target:
+    | LibraryScreenEstimateCostParams.StructureTemplateTarget
+    | LibraryScreenEstimateCostParams.NoTemplateTarget;
+
+  /**
+   * Client-provided key to prevent duplicate submissions on retries
+   */
+  idempotency_key?: string;
+
+  /**
+   * Target workspace ID (admin keys only; ignored for workspace keys)
+   */
+  workspace_id?: string;
+}
+
+export namespace LibraryScreenEstimateCostParams {
+  /**
+   * A protein screen entry with entities and optional ID
+   */
+  export interface Protein {
+    /**
+     * Entities that make up this protein complex
+     */
+    entities: Array<
+      | Protein.ProteinEntity
+      | Protein.RnaEntity
+      | Protein.DnaEntity
+      | Protein.LigandCcdEntity
+      | Protein.LigandSmilesEntity
+    >;
+
+    /**
+     * Optional client-provided identifier for this entry
+     */
+    id?: string;
+  }
+
+  export namespace Protein {
+    export interface ProteinEntity {
+      /**
+       * Chain IDs for this entity
+       */
+      chain_ids: Array<string>;
+
+      type: 'protein';
+
+      /**
+       * Amino acid sequence (one-letter codes)
+       */
+      value: string;
+
+      /**
+       * Whether the sequence is cyclic
+       */
+      cyclic?: boolean;
+
+      /**
+       * Post-translational modifications. Optional; defaults to an empty list when
+       * omitted.
+       */
+      modifications?: Array<ProteinEntity.CcdModification | ProteinEntity.SmilesModification>;
+    }
+
+    export namespace ProteinEntity {
+      export interface CcdModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'ccd';
+
+        /**
+         * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+         * phosphoserine)
+         */
+        value: string;
+      }
+
+      export interface SmilesModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'smiles';
+
+        /**
+         * SMILES string for the modification
+         */
+        value: string;
+      }
+    }
+
+    export interface RnaEntity {
+      /**
+       * Chain IDs for this entity
+       */
+      chain_ids: Array<string>;
+
+      type: 'rna';
+
+      /**
+       * RNA nucleotide sequence (A, C, G, U, N)
+       */
+      value: string;
+
+      /**
+       * Whether the sequence is cyclic
+       */
+      cyclic?: boolean;
+
+      /**
+       * Chemical modifications. Optional; defaults to an empty list when omitted.
+       */
+      modifications?: Array<RnaEntity.CcdModification | RnaEntity.SmilesModification>;
+    }
+
+    export namespace RnaEntity {
+      export interface CcdModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'ccd';
+
+        /**
+         * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+         * phosphoserine)
+         */
+        value: string;
+      }
+
+      export interface SmilesModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'smiles';
+
+        /**
+         * SMILES string for the modification
+         */
+        value: string;
+      }
+    }
+
+    export interface DnaEntity {
+      /**
+       * Chain IDs for this entity
+       */
+      chain_ids: Array<string>;
+
+      type: 'dna';
+
+      /**
+       * DNA nucleotide sequence (A, C, G, T, N)
+       */
+      value: string;
+
+      /**
+       * Whether the sequence is cyclic
+       */
+      cyclic?: boolean;
+
+      /**
+       * Chemical modifications. Optional; defaults to an empty list when omitted.
+       */
+      modifications?: Array<DnaEntity.CcdModification | DnaEntity.SmilesModification>;
+    }
+
+    export namespace DnaEntity {
+      export interface CcdModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'ccd';
+
+        /**
+         * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+         * phosphoserine)
+         */
+        value: string;
+      }
+
+      export interface SmilesModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'smiles';
+
+        /**
+         * SMILES string for the modification
+         */
+        value: string;
+      }
+    }
+
+    export interface LigandCcdEntity {
+      /**
+       * Chain IDs for this ligand
+       */
+      chain_ids: Array<string>;
+
+      type: 'ligand_ccd';
+
+      /**
+       * CCD code (e.g., ATP, ADP)
+       */
+      value: string;
+    }
+
+    export interface LigandSmilesEntity {
+      /**
+       * Chain IDs for this ligand
+       */
+      chain_ids: Array<string>;
+
+      type: 'ligand_smiles';
+
+      /**
+       * SMILES string representing the ligand
+       */
+      value: string;
+    }
+  }
+
+  /**
+   * Target defined by an uploaded 3D structure (CIF or PDB file). Only chains
+   * included in chain_selection are used.
+   */
+  export interface StructureTemplateTarget {
+    /**
+     * Chains selected from the uploaded structure, keyed by chain ID. Only chains
+     * listed here are included in the engine run — any chains omitted from this
+     * mapping are ignored. Each value defines which residues to keep, which are
+     * epitope residues, and which are flexible.
+     */
+    chain_selection: {
+      [key: string]:
+        | StructureTemplateTarget.StructureTemplateTargetPolymerChainSpec
+        | StructureTemplateTarget.StructureTemplateTargetLigandChainSpec;
+    };
+
+    /**
+     * How to provide a CIF structure file. URLs are auto-detected; base64 uploads must
+     * use chemical/x-cif media type.
+     */
+    structure: StructureTemplateTarget.URLSource | StructureTemplateTarget.CifBase64Source;
+
+    type: 'structure_template';
+  }
+
+  export namespace StructureTemplateTarget {
+    /**
+     * Per-chain specification for a polymer (protein/RNA/DNA) chain in a structure
+     * template target.
+     */
+    export interface StructureTemplateTargetPolymerChainSpec {
+      chain_type: 'polymer';
+
+      /**
+       * 0-indexed residue indices to retain from this chain, or 'all' to keep all
+       * residues. Residues not listed are excluded from the engine run.
+       */
+      crop_residues: Array<number> | 'all';
+
+      /**
+       * 0-indexed residue indices where binder contact is desired (the epitope). All
+       * indices must be present in crop_residues.
+       */
+      epitope_residues?: Array<number>;
+
+      /**
+       * 0-indexed residue indices allowed to move during design (e.g. flexible loop
+       * regions). All indices must be present in crop_residues.
+       */
+      flexible_residues?: Array<number>;
+    }
+
+    /**
+     * Per-chain specification for a ligand chain in a structure template target. The
+     * full ligand is always included.
+     */
+    export interface StructureTemplateTargetLigandChainSpec {
+      chain_type: 'ligand';
+    }
+
+    export interface URLSource {
+      type: 'url';
+
+      url: string;
+    }
+
+    export interface CifBase64Source {
+      /**
+       * Base64-encoded CIF file contents
+       */
+      data: string;
+
+      /**
+       * Must be chemical/x-cif for CIF files
+       */
+      media_type: 'chemical/x-cif';
+
+      type: 'base64';
+    }
+  }
+
+  /**
+   * Target defined by sequences only, without a 3D structure template
+   */
+  export interface NoTemplateTarget {
+    /**
+     * Entities (proteins, RNA, DNA, ligands) defining the target complex.
+     */
+    entities: Array<
+      | NoTemplateTarget.ProteinEntity
+      | NoTemplateTarget.RnaEntity
+      | NoTemplateTarget.DnaEntity
+      | NoTemplateTarget.LigandCcdEntity
+      | NoTemplateTarget.LigandSmilesEntity
+    >;
+
+    type: 'no_template';
+
+    /**
+     * Covalent bond constraints between atoms in the target complex. Atom-level ligand
+     * references currently support ligand_ccd only; ligand_smiles is unsupported.
+     */
+    bonds?: Array<NoTemplateTarget.Bond>;
+
+    /**
+     * Structural constraints (pocket and contact). Atom-level ligand references
+     * currently support ligand_ccd only; ligand_smiles is unsupported.
+     */
+    constraints?: Array<NoTemplateTarget.PocketConstraint | NoTemplateTarget.ContactConstraint>;
+
+    /**
+     * Chain IDs of ligand entities that are part of the binding epitope. Ligands are
+     * marked as epitope in full (no residue-level selection).
+     */
+    epitope_ligand_chains?: Array<string>;
+
+    /**
+     * Polymer chain residues where binder contact is desired (the epitope). Each key
+     * is a chain ID of a polymer entity, each value is an array of 0-indexed residue
+     * indices.
+     */
+    epitope_residues?: { [key: string]: Array<number> };
+  }
+
+  export namespace NoTemplateTarget {
+    export interface ProteinEntity {
+      /**
+       * Chain IDs for this entity
+       */
+      chain_ids: Array<string>;
+
+      type: 'protein';
+
+      /**
+       * Amino acid sequence (one-letter codes)
+       */
+      value: string;
+
+      /**
+       * Whether the sequence is cyclic
+       */
+      cyclic?: boolean;
+
+      /**
+       * Post-translational modifications. Optional; defaults to an empty list when
+       * omitted.
+       */
+      modifications?: Array<ProteinEntity.CcdModification | ProteinEntity.SmilesModification>;
+    }
+
+    export namespace ProteinEntity {
+      export interface CcdModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'ccd';
+
+        /**
+         * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+         * phosphoserine)
+         */
+        value: string;
+      }
+
+      export interface SmilesModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'smiles';
+
+        /**
+         * SMILES string for the modification
+         */
+        value: string;
+      }
+    }
+
+    export interface RnaEntity {
+      /**
+       * Chain IDs for this entity
+       */
+      chain_ids: Array<string>;
+
+      type: 'rna';
+
+      /**
+       * RNA nucleotide sequence (A, C, G, U, N)
+       */
+      value: string;
+
+      /**
+       * Whether the sequence is cyclic
+       */
+      cyclic?: boolean;
+
+      /**
+       * Chemical modifications. Optional; defaults to an empty list when omitted.
+       */
+      modifications?: Array<RnaEntity.CcdModification | RnaEntity.SmilesModification>;
+    }
+
+    export namespace RnaEntity {
+      export interface CcdModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'ccd';
+
+        /**
+         * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+         * phosphoserine)
+         */
+        value: string;
+      }
+
+      export interface SmilesModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'smiles';
+
+        /**
+         * SMILES string for the modification
+         */
+        value: string;
+      }
+    }
+
+    export interface DnaEntity {
+      /**
+       * Chain IDs for this entity
+       */
+      chain_ids: Array<string>;
+
+      type: 'dna';
+
+      /**
+       * DNA nucleotide sequence (A, C, G, T, N)
+       */
+      value: string;
+
+      /**
+       * Whether the sequence is cyclic
+       */
+      cyclic?: boolean;
+
+      /**
+       * Chemical modifications. Optional; defaults to an empty list when omitted.
+       */
+      modifications?: Array<DnaEntity.CcdModification | DnaEntity.SmilesModification>;
+    }
+
+    export namespace DnaEntity {
+      export interface CcdModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'ccd';
+
+        /**
+         * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+         * phosphoserine)
+         */
+        value: string;
+      }
+
+      export interface SmilesModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'smiles';
+
+        /**
+         * SMILES string for the modification
+         */
+        value: string;
+      }
+    }
+
+    export interface LigandCcdEntity {
+      /**
+       * Chain IDs for this ligand
+       */
+      chain_ids: Array<string>;
+
+      type: 'ligand_ccd';
+
+      /**
+       * CCD code (e.g., ATP, ADP)
+       */
+      value: string;
+    }
+
+    export interface LigandSmilesEntity {
+      /**
+       * Chain IDs for this ligand
+       */
+      chain_ids: Array<string>;
+
+      type: 'ligand_smiles';
+
+      /**
+       * SMILES string representing the ligand
+       */
+      value: string;
+    }
+
+    /**
+     * Bond between two atoms. Atom-level ligand references currently support
+     * ligand_ccd entities only; ligand_smiles is unsupported.
+     */
+    export interface Bond {
+      /**
+       * Ligand atom reference. Atom-level ligand references currently support ligand_ccd
+       * entities only; ligand_smiles is unsupported.
+       */
+      atom1: Bond.LigandAtom | Bond.PolymerAtom;
+
+      /**
+       * Ligand atom reference. Atom-level ligand references currently support ligand_ccd
+       * entities only; ligand_smiles is unsupported.
+       */
+      atom2: Bond.LigandAtom | Bond.PolymerAtom;
+    }
+
+    export namespace Bond {
+      /**
+       * Ligand atom reference. Atom-level ligand references currently support ligand_ccd
+       * entities only; ligand_smiles is unsupported.
+       */
+      export interface LigandAtom {
+        /**
+         * Standardized atom name (verifiable in CIF file on RCSB). Atom-level references
+         * to ligand_smiles entities are currently unsupported; use ligand_ccd instead.
+         */
+        atom_name: string;
+
+        /**
+         * Chain ID containing the atom
+         */
+        chain_id: string;
+
+        type: 'ligand_atom';
+      }
+
+      export interface PolymerAtom {
+        /**
+         * Standardized atom name (verifiable in CIF file on RCSB)
+         */
+        atom_name: string;
+
+        /**
+         * Chain ID containing the atom
+         */
+        chain_id: string;
+
+        /**
+         * 0-based residue index
+         */
+        residue_index: number;
+
+        type: 'polymer_atom';
+      }
+
+      /**
+       * Ligand atom reference. Atom-level ligand references currently support ligand_ccd
+       * entities only; ligand_smiles is unsupported.
+       */
+      export interface LigandAtom {
+        /**
+         * Standardized atom name (verifiable in CIF file on RCSB). Atom-level references
+         * to ligand_smiles entities are currently unsupported; use ligand_ccd instead.
+         */
+        atom_name: string;
+
+        /**
+         * Chain ID containing the atom
+         */
+        chain_id: string;
+
+        type: 'ligand_atom';
+      }
+
+      export interface PolymerAtom {
+        /**
+         * Standardized atom name (verifiable in CIF file on RCSB)
+         */
+        atom_name: string;
+
+        /**
+         * Chain ID containing the atom
+         */
+        chain_id: string;
+
+        /**
+         * 0-based residue index
+         */
+        residue_index: number;
+
+        type: 'polymer_atom';
+      }
+    }
+
+    /**
+     * Constrains the binder to interact with specific pocket residues on the target.
+     */
+    export interface PocketConstraint {
+      /**
+       * Chain ID of the binder molecule
+       */
+      binder_chain_id: string;
+
+      /**
+       * Binding pocket residues keyed by chain ID. Each key is a chain ID (e.g. "A") and
+       * the value is an array of 0-indexed residue indices that define the pocket on
+       * that chain.
+       */
+      contact_residues: { [key: string]: Array<number> };
+
+      /**
+       * Maximum allowed distance in Angstroms between binder and pocket residues.
+       * Typical range: 4-8 A.
+       */
+      max_distance_angstrom: number;
+
+      type: 'pocket';
+
+      /**
+       * Whether to force the constraint
+       */
+      force?: boolean;
+    }
+
+    /**
+     * Contact constraint between two tokens. Atom-level ligand references currently
+     * support ligand_ccd entities only; ligand_smiles is unsupported.
+     */
+    export interface ContactConstraint {
+      /**
+       * Maximum distance in Angstroms
+       */
+      max_distance_angstrom: number;
+
+      /**
+       * Ligand contact token. Atom-level ligand references currently support ligand_ccd
+       * entities only; ligand_smiles is unsupported.
+       */
+      token1: ContactConstraint.PolymerContactToken | ContactConstraint.LigandContactToken;
+
+      /**
+       * Ligand contact token. Atom-level ligand references currently support ligand_ccd
+       * entities only; ligand_smiles is unsupported.
+       */
+      token2: ContactConstraint.PolymerContactToken | ContactConstraint.LigandContactToken;
+
+      type: 'contact';
+
+      /**
+       * Whether to force the constraint
+       */
+      force?: boolean;
+    }
+
+    export namespace ContactConstraint {
+      export interface PolymerContactToken {
+        /**
+         * Chain ID
+         */
+        chain_id: string;
+
+        /**
+         * 0-based residue index
+         */
+        residue_index: number;
+
+        type: 'polymer_contact';
+      }
+
+      /**
+       * Ligand contact token. Atom-level ligand references currently support ligand_ccd
+       * entities only; ligand_smiles is unsupported.
+       */
+      export interface LigandContactToken {
+        /**
+         * Atom name. Atom-level references to ligand_smiles entities are currently
+         * unsupported; use ligand_ccd instead.
+         */
+        atom_name: string;
+
+        /**
+         * Chain ID
+         */
+        chain_id: string;
+
+        type: 'ligand_contact';
+      }
+
+      export interface PolymerContactToken {
+        /**
+         * Chain ID
+         */
+        chain_id: string;
+
+        /**
+         * 0-based residue index
+         */
+        residue_index: number;
+
+        type: 'polymer_contact';
+      }
+
+      /**
+       * Ligand contact token. Atom-level ligand references currently support ligand_ccd
+       * entities only; ligand_smiles is unsupported.
+       */
+      export interface LigandContactToken {
+        /**
+         * Atom name. Atom-level references to ligand_smiles entities are currently
+         * unsupported; use ligand_ccd instead.
+         */
+        atom_name: string;
+
+        /**
+         * Chain ID
+         */
+        chain_id: string;
+
+        type: 'ligand_contact';
+      }
+    }
+  }
+}
+
+export interface LibraryScreenListResultsParams extends CursorPageParams {
+  /**
+   * Workspace ID. Only used with admin API keys. Ignored (or validated) for
+   * workspace-scoped keys.
+   */
+  workspace_id?: string;
+}
+
+export interface LibraryScreenStartParams {
+  /**
+   * List of protein entries to screen.
+   */
+  proteins: Array<LibraryScreenStartParams.Protein>;
+
+  /**
+   * Target specification (structure template or template-free)
+   */
+  target: LibraryScreenStartParams.StructureTemplateTarget | LibraryScreenStartParams.NoTemplateTarget;
+
+  /**
+   * Client-provided key to prevent duplicate submissions on retries
+   */
+  idempotency_key?: string;
+
+  /**
+   * Target workspace ID (admin keys only; ignored for workspace keys)
+   */
+  workspace_id?: string;
+}
+
+export namespace LibraryScreenStartParams {
+  /**
+   * A protein screen entry with entities and optional ID
+   */
+  export interface Protein {
+    /**
+     * Entities that make up this protein complex
+     */
+    entities: Array<
+      | Protein.ProteinEntity
+      | Protein.RnaEntity
+      | Protein.DnaEntity
+      | Protein.LigandCcdEntity
+      | Protein.LigandSmilesEntity
+    >;
+
+    /**
+     * Optional client-provided identifier for this entry
+     */
+    id?: string;
+  }
+
+  export namespace Protein {
+    export interface ProteinEntity {
+      /**
+       * Chain IDs for this entity
+       */
+      chain_ids: Array<string>;
+
+      type: 'protein';
+
+      /**
+       * Amino acid sequence (one-letter codes)
+       */
+      value: string;
+
+      /**
+       * Whether the sequence is cyclic
+       */
+      cyclic?: boolean;
+
+      /**
+       * Post-translational modifications. Optional; defaults to an empty list when
+       * omitted.
+       */
+      modifications?: Array<ProteinEntity.CcdModification | ProteinEntity.SmilesModification>;
+    }
+
+    export namespace ProteinEntity {
+      export interface CcdModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'ccd';
+
+        /**
+         * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+         * phosphoserine)
+         */
+        value: string;
+      }
+
+      export interface SmilesModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'smiles';
+
+        /**
+         * SMILES string for the modification
+         */
+        value: string;
+      }
+    }
+
+    export interface RnaEntity {
+      /**
+       * Chain IDs for this entity
+       */
+      chain_ids: Array<string>;
+
+      type: 'rna';
+
+      /**
+       * RNA nucleotide sequence (A, C, G, U, N)
+       */
+      value: string;
+
+      /**
+       * Whether the sequence is cyclic
+       */
+      cyclic?: boolean;
+
+      /**
+       * Chemical modifications. Optional; defaults to an empty list when omitted.
+       */
+      modifications?: Array<RnaEntity.CcdModification | RnaEntity.SmilesModification>;
+    }
+
+    export namespace RnaEntity {
+      export interface CcdModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'ccd';
+
+        /**
+         * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+         * phosphoserine)
+         */
+        value: string;
+      }
+
+      export interface SmilesModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'smiles';
+
+        /**
+         * SMILES string for the modification
+         */
+        value: string;
+      }
+    }
+
+    export interface DnaEntity {
+      /**
+       * Chain IDs for this entity
+       */
+      chain_ids: Array<string>;
+
+      type: 'dna';
+
+      /**
+       * DNA nucleotide sequence (A, C, G, T, N)
+       */
+      value: string;
+
+      /**
+       * Whether the sequence is cyclic
+       */
+      cyclic?: boolean;
+
+      /**
+       * Chemical modifications. Optional; defaults to an empty list when omitted.
+       */
+      modifications?: Array<DnaEntity.CcdModification | DnaEntity.SmilesModification>;
+    }
+
+    export namespace DnaEntity {
+      export interface CcdModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'ccd';
+
+        /**
+         * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+         * phosphoserine)
+         */
+        value: string;
+      }
+
+      export interface SmilesModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'smiles';
+
+        /**
+         * SMILES string for the modification
+         */
+        value: string;
+      }
+    }
+
+    export interface LigandCcdEntity {
+      /**
+       * Chain IDs for this ligand
+       */
+      chain_ids: Array<string>;
+
+      type: 'ligand_ccd';
+
+      /**
+       * CCD code (e.g., ATP, ADP)
+       */
+      value: string;
+    }
+
+    export interface LigandSmilesEntity {
+      /**
+       * Chain IDs for this ligand
+       */
+      chain_ids: Array<string>;
+
+      type: 'ligand_smiles';
+
+      /**
+       * SMILES string representing the ligand
+       */
+      value: string;
+    }
+  }
+
+  /**
+   * Target defined by an uploaded 3D structure (CIF or PDB file). Only chains
+   * included in chain_selection are used.
+   */
+  export interface StructureTemplateTarget {
+    /**
+     * Chains selected from the uploaded structure, keyed by chain ID. Only chains
+     * listed here are included in the engine run — any chains omitted from this
+     * mapping are ignored. Each value defines which residues to keep, which are
+     * epitope residues, and which are flexible.
+     */
+    chain_selection: {
+      [key: string]:
+        | StructureTemplateTarget.StructureTemplateTargetPolymerChainSpec
+        | StructureTemplateTarget.StructureTemplateTargetLigandChainSpec;
+    };
+
+    /**
+     * How to provide a CIF structure file. URLs are auto-detected; base64 uploads must
+     * use chemical/x-cif media type.
+     */
+    structure: StructureTemplateTarget.URLSource | StructureTemplateTarget.CifBase64Source;
+
+    type: 'structure_template';
+  }
+
+  export namespace StructureTemplateTarget {
+    /**
+     * Per-chain specification for a polymer (protein/RNA/DNA) chain in a structure
+     * template target.
+     */
+    export interface StructureTemplateTargetPolymerChainSpec {
+      chain_type: 'polymer';
+
+      /**
+       * 0-indexed residue indices to retain from this chain, or 'all' to keep all
+       * residues. Residues not listed are excluded from the engine run.
+       */
+      crop_residues: Array<number> | 'all';
+
+      /**
+       * 0-indexed residue indices where binder contact is desired (the epitope). All
+       * indices must be present in crop_residues.
+       */
+      epitope_residues?: Array<number>;
+
+      /**
+       * 0-indexed residue indices allowed to move during design (e.g. flexible loop
+       * regions). All indices must be present in crop_residues.
+       */
+      flexible_residues?: Array<number>;
+    }
+
+    /**
+     * Per-chain specification for a ligand chain in a structure template target. The
+     * full ligand is always included.
+     */
+    export interface StructureTemplateTargetLigandChainSpec {
+      chain_type: 'ligand';
+    }
+
+    export interface URLSource {
+      type: 'url';
+
+      url: string;
+    }
+
+    export interface CifBase64Source {
+      /**
+       * Base64-encoded CIF file contents
+       */
+      data: string;
+
+      /**
+       * Must be chemical/x-cif for CIF files
+       */
+      media_type: 'chemical/x-cif';
+
+      type: 'base64';
+    }
+  }
+
+  /**
+   * Target defined by sequences only, without a 3D structure template
+   */
+  export interface NoTemplateTarget {
+    /**
+     * Entities (proteins, RNA, DNA, ligands) defining the target complex.
+     */
+    entities: Array<
+      | NoTemplateTarget.ProteinEntity
+      | NoTemplateTarget.RnaEntity
+      | NoTemplateTarget.DnaEntity
+      | NoTemplateTarget.LigandCcdEntity
+      | NoTemplateTarget.LigandSmilesEntity
+    >;
+
+    type: 'no_template';
+
+    /**
+     * Covalent bond constraints between atoms in the target complex. Atom-level ligand
+     * references currently support ligand_ccd only; ligand_smiles is unsupported.
+     */
+    bonds?: Array<NoTemplateTarget.Bond>;
+
+    /**
+     * Structural constraints (pocket and contact). Atom-level ligand references
+     * currently support ligand_ccd only; ligand_smiles is unsupported.
+     */
+    constraints?: Array<NoTemplateTarget.PocketConstraint | NoTemplateTarget.ContactConstraint>;
+
+    /**
+     * Chain IDs of ligand entities that are part of the binding epitope. Ligands are
+     * marked as epitope in full (no residue-level selection).
+     */
+    epitope_ligand_chains?: Array<string>;
+
+    /**
+     * Polymer chain residues where binder contact is desired (the epitope). Each key
+     * is a chain ID of a polymer entity, each value is an array of 0-indexed residue
+     * indices.
+     */
+    epitope_residues?: { [key: string]: Array<number> };
+  }
+
+  export namespace NoTemplateTarget {
+    export interface ProteinEntity {
+      /**
+       * Chain IDs for this entity
+       */
+      chain_ids: Array<string>;
+
+      type: 'protein';
+
+      /**
+       * Amino acid sequence (one-letter codes)
+       */
+      value: string;
+
+      /**
+       * Whether the sequence is cyclic
+       */
+      cyclic?: boolean;
+
+      /**
+       * Post-translational modifications. Optional; defaults to an empty list when
+       * omitted.
+       */
+      modifications?: Array<ProteinEntity.CcdModification | ProteinEntity.SmilesModification>;
+    }
+
+    export namespace ProteinEntity {
+      export interface CcdModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'ccd';
+
+        /**
+         * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+         * phosphoserine)
+         */
+        value: string;
+      }
+
+      export interface SmilesModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'smiles';
+
+        /**
+         * SMILES string for the modification
+         */
+        value: string;
+      }
+    }
+
+    export interface RnaEntity {
+      /**
+       * Chain IDs for this entity
+       */
+      chain_ids: Array<string>;
+
+      type: 'rna';
+
+      /**
+       * RNA nucleotide sequence (A, C, G, U, N)
+       */
+      value: string;
+
+      /**
+       * Whether the sequence is cyclic
+       */
+      cyclic?: boolean;
+
+      /**
+       * Chemical modifications. Optional; defaults to an empty list when omitted.
+       */
+      modifications?: Array<RnaEntity.CcdModification | RnaEntity.SmilesModification>;
+    }
+
+    export namespace RnaEntity {
+      export interface CcdModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'ccd';
+
+        /**
+         * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+         * phosphoserine)
+         */
+        value: string;
+      }
+
+      export interface SmilesModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'smiles';
+
+        /**
+         * SMILES string for the modification
+         */
+        value: string;
+      }
+    }
+
+    export interface DnaEntity {
+      /**
+       * Chain IDs for this entity
+       */
+      chain_ids: Array<string>;
+
+      type: 'dna';
+
+      /**
+       * DNA nucleotide sequence (A, C, G, T, N)
+       */
+      value: string;
+
+      /**
+       * Whether the sequence is cyclic
+       */
+      cyclic?: boolean;
+
+      /**
+       * Chemical modifications. Optional; defaults to an empty list when omitted.
+       */
+      modifications?: Array<DnaEntity.CcdModification | DnaEntity.SmilesModification>;
+    }
+
+    export namespace DnaEntity {
+      export interface CcdModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'ccd';
+
+        /**
+         * CCD code from RCSB PDB (e.g. 'MSE' for selenomethionine, 'SEP' for
+         * phosphoserine)
+         */
+        value: string;
+      }
+
+      export interface SmilesModification {
+        /**
+         * 0-based index of the residue to modify
+         */
+        residue_index: number;
+
+        type: 'smiles';
+
+        /**
+         * SMILES string for the modification
+         */
+        value: string;
+      }
+    }
+
+    export interface LigandCcdEntity {
+      /**
+       * Chain IDs for this ligand
+       */
+      chain_ids: Array<string>;
+
+      type: 'ligand_ccd';
+
+      /**
+       * CCD code (e.g., ATP, ADP)
+       */
+      value: string;
+    }
+
+    export interface LigandSmilesEntity {
+      /**
+       * Chain IDs for this ligand
+       */
+      chain_ids: Array<string>;
+
+      type: 'ligand_smiles';
+
+      /**
+       * SMILES string representing the ligand
+       */
+      value: string;
+    }
+
+    /**
+     * Bond between two atoms. Atom-level ligand references currently support
+     * ligand_ccd entities only; ligand_smiles is unsupported.
+     */
+    export interface Bond {
+      /**
+       * Ligand atom reference. Atom-level ligand references currently support ligand_ccd
+       * entities only; ligand_smiles is unsupported.
+       */
+      atom1: Bond.LigandAtom | Bond.PolymerAtom;
+
+      /**
+       * Ligand atom reference. Atom-level ligand references currently support ligand_ccd
+       * entities only; ligand_smiles is unsupported.
+       */
+      atom2: Bond.LigandAtom | Bond.PolymerAtom;
+    }
+
+    export namespace Bond {
+      /**
+       * Ligand atom reference. Atom-level ligand references currently support ligand_ccd
+       * entities only; ligand_smiles is unsupported.
+       */
+      export interface LigandAtom {
+        /**
+         * Standardized atom name (verifiable in CIF file on RCSB). Atom-level references
+         * to ligand_smiles entities are currently unsupported; use ligand_ccd instead.
+         */
+        atom_name: string;
+
+        /**
+         * Chain ID containing the atom
+         */
+        chain_id: string;
+
+        type: 'ligand_atom';
+      }
+
+      export interface PolymerAtom {
+        /**
+         * Standardized atom name (verifiable in CIF file on RCSB)
+         */
+        atom_name: string;
+
+        /**
+         * Chain ID containing the atom
+         */
+        chain_id: string;
+
+        /**
+         * 0-based residue index
+         */
+        residue_index: number;
+
+        type: 'polymer_atom';
+      }
+
+      /**
+       * Ligand atom reference. Atom-level ligand references currently support ligand_ccd
+       * entities only; ligand_smiles is unsupported.
+       */
+      export interface LigandAtom {
+        /**
+         * Standardized atom name (verifiable in CIF file on RCSB). Atom-level references
+         * to ligand_smiles entities are currently unsupported; use ligand_ccd instead.
+         */
+        atom_name: string;
+
+        /**
+         * Chain ID containing the atom
+         */
+        chain_id: string;
+
+        type: 'ligand_atom';
+      }
+
+      export interface PolymerAtom {
+        /**
+         * Standardized atom name (verifiable in CIF file on RCSB)
+         */
+        atom_name: string;
+
+        /**
+         * Chain ID containing the atom
+         */
+        chain_id: string;
+
+        /**
+         * 0-based residue index
+         */
+        residue_index: number;
+
+        type: 'polymer_atom';
+      }
+    }
+
+    /**
+     * Constrains the binder to interact with specific pocket residues on the target.
+     */
+    export interface PocketConstraint {
+      /**
+       * Chain ID of the binder molecule
+       */
+      binder_chain_id: string;
+
+      /**
+       * Binding pocket residues keyed by chain ID. Each key is a chain ID (e.g. "A") and
+       * the value is an array of 0-indexed residue indices that define the pocket on
+       * that chain.
+       */
+      contact_residues: { [key: string]: Array<number> };
+
+      /**
+       * Maximum allowed distance in Angstroms between binder and pocket residues.
+       * Typical range: 4-8 A.
+       */
+      max_distance_angstrom: number;
+
+      type: 'pocket';
+
+      /**
+       * Whether to force the constraint
+       */
+      force?: boolean;
+    }
+
+    /**
+     * Contact constraint between two tokens. Atom-level ligand references currently
+     * support ligand_ccd entities only; ligand_smiles is unsupported.
+     */
+    export interface ContactConstraint {
+      /**
+       * Maximum distance in Angstroms
+       */
+      max_distance_angstrom: number;
+
+      /**
+       * Ligand contact token. Atom-level ligand references currently support ligand_ccd
+       * entities only; ligand_smiles is unsupported.
+       */
+      token1: ContactConstraint.PolymerContactToken | ContactConstraint.LigandContactToken;
+
+      /**
+       * Ligand contact token. Atom-level ligand references currently support ligand_ccd
+       * entities only; ligand_smiles is unsupported.
+       */
+      token2: ContactConstraint.PolymerContactToken | ContactConstraint.LigandContactToken;
+
+      type: 'contact';
+
+      /**
+       * Whether to force the constraint
+       */
+      force?: boolean;
+    }
+
+    export namespace ContactConstraint {
+      export interface PolymerContactToken {
+        /**
+         * Chain ID
+         */
+        chain_id: string;
+
+        /**
+         * 0-based residue index
+         */
+        residue_index: number;
+
+        type: 'polymer_contact';
+      }
+
+      /**
+       * Ligand contact token. Atom-level ligand references currently support ligand_ccd
+       * entities only; ligand_smiles is unsupported.
+       */
+      export interface LigandContactToken {
+        /**
+         * Atom name. Atom-level references to ligand_smiles entities are currently
+         * unsupported; use ligand_ccd instead.
+         */
+        atom_name: string;
+
+        /**
+         * Chain ID
+         */
+        chain_id: string;
+
+        type: 'ligand_contact';
+      }
+
+      export interface PolymerContactToken {
+        /**
+         * Chain ID
+         */
+        chain_id: string;
+
+        /**
+         * 0-based residue index
+         */
+        residue_index: number;
+
+        type: 'polymer_contact';
+      }
+
+      /**
+       * Ligand contact token. Atom-level ligand references currently support ligand_ccd
+       * entities only; ligand_smiles is unsupported.
+       */
+      export interface LigandContactToken {
+        /**
+         * Atom name. Atom-level references to ligand_smiles entities are currently
+         * unsupported; use ligand_ccd instead.
+         */
+        atom_name: string;
+
+        /**
+         * Chain ID
+         */
+        chain_id: string;
+
+        type: 'ligand_contact';
+      }
+    }
+  }
+}
+
+export declare namespace LibraryScreen {
+  export {
+    type LibraryScreenRetrieveResponse as LibraryScreenRetrieveResponse,
+    type LibraryScreenListResponse as LibraryScreenListResponse,
+    type LibraryScreenDeleteDataResponse as LibraryScreenDeleteDataResponse,
+    type LibraryScreenEstimateCostResponse as LibraryScreenEstimateCostResponse,
+    type LibraryScreenListResultsResponse as LibraryScreenListResultsResponse,
+    type LibraryScreenStartResponse as LibraryScreenStartResponse,
+    type LibraryScreenStopResponse as LibraryScreenStopResponse,
+    type LibraryScreenListResponsesCursorPage as LibraryScreenListResponsesCursorPage,
+    type LibraryScreenListResultsResponsesCursorPage as LibraryScreenListResultsResponsesCursorPage,
+    type LibraryScreenRetrieveParams as LibraryScreenRetrieveParams,
+    type LibraryScreenListParams as LibraryScreenListParams,
+    type LibraryScreenEstimateCostParams as LibraryScreenEstimateCostParams,
+    type LibraryScreenListResultsParams as LibraryScreenListResultsParams,
+    type LibraryScreenStartParams as LibraryScreenStartParams,
+  };
+}