@cyanheads/protein-mcp-server 0.1.0

package/dist/services/rcsb/rcsb-service.js

@@ -0,0 +1,473 @@
+/**
+ * @fileoverview RCSB service — wraps the RCSB Search API v2 (text / sequence /
+ * chemical search + server-side faceted aggregation), the Data API GraphQL
+ * endpoint (batched entry metadata + ligand binding-site residues via
+ * `rcsb_target_neighbors`), the REST chemical-component endpoint, and coordinate
+ * file URLs. The PDB's full query surface lives only here; predicted models are
+ * served by the AlphaFold / 3D-Beacons services.
+ * @module services/rcsb/rcsb-service
+ */
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { fetchJson } from '../shared/http.js';
+/** Match-all base terminal — every entry carries a release date. */
+const MATCH_ALL = {
+    type: 'terminal',
+    service: 'text',
+    parameters: { attribute: 'rcsb_accession_info.initial_release_date', operator: 'exists' },
+};
+export class RcsbService {
+    searchUrl;
+    graphqlUrl;
+    dataRestBase;
+    filesBase;
+    constructor(_config, _storage, serverConfig) {
+        this.searchUrl = `${serverConfig.rcsbSearchBaseUrl}/rcsbsearch/v2/query`;
+        this.graphqlUrl = `${serverConfig.rcsbDataBaseUrl}/graphql`;
+        this.dataRestBase = `${serverConfig.rcsbDataBaseUrl}/rest/v1/core`;
+        this.filesBase = serverConfig.rcsbFilesBaseUrl;
+    }
+    // ─── Search ────────────────────────────────────────────────────────────────
+    /** Full-text / filtered structure search, optionally with a facet breakdown. */
+    async search(params, ctx, facets) {
+        const query = buildQuery(params);
+        const returnType = params.sequence ? 'polymer_entity' : 'entry';
+        const body = {
+            query,
+            return_type: returnType,
+            request_options: {
+                ...contentTypeOption(params.contentType),
+                paginate: { start: params.start ?? 0, rows: params.limit ?? 25 },
+                ...(facets && facets.length > 0 ? { facets: facets.map(toRcsbFacet) } : {}),
+                scoring_strategy: 'combined',
+            },
+        };
+        const raw = await this.postSearch(body, ctx, 'RcsbService.search');
+        return {
+            total: raw.total_count ?? 0,
+            hits: normalizeHits(raw.result_set),
+            ...(facets && facets.length > 0 ? { facets: normalizeFacets(raw.facets, facets) } : {}),
+        };
+    }
+    /** mmseqs2 sequence-similarity search. Returns polymer-entity hits. */
+    async searchSequence(sequence, opts, ctx) {
+        const body = {
+            query: {
+                type: 'terminal',
+                service: 'sequence',
+                parameters: {
+                    evalue_cutoff: opts.maxEvalue ?? 1,
+                    identity_cutoff: opts.minIdentity ?? 0,
+                    sequence_type: 'protein',
+                    value: sequence,
+                },
+            },
+            return_type: 'polymer_entity',
+            request_options: {
+                ...contentTypeOption(opts.contentType),
+                paginate: { start: 0, rows: opts.limit ?? 25 },
+                scoring_strategy: 'sequence',
+            },
+        };
+        const raw = await this.postSearch(body, ctx, 'RcsbService.searchSequence');
+        return { total: raw.total_count ?? 0, hits: normalizeHits(raw.result_set) };
+    }
+    /** Find entries containing a given ligand (exact chemical component ID). */
+    async searchByLigand(compId, opts, ctx) {
+        const body = {
+            query: {
+                type: 'terminal',
+                service: 'text_chem',
+                parameters: {
+                    attribute: 'rcsb_chem_comp_container_identifiers.comp_id',
+                    operator: 'exact_match',
+                    value: compId.toUpperCase(),
+                },
+            },
+            return_type: 'entry',
+            request_options: {
+                ...contentTypeOption(opts.contentType ?? 'experimental'),
+                paginate: { start: 0, rows: opts.limit ?? 25 },
+            },
+        };
+        const raw = await this.postSearch(body, ctx, 'RcsbService.searchByLigand');
+        return { total: raw.total_count ?? 0, hits: normalizeHits(raw.result_set) };
+    }
+    /** Resolve a ligand name/synonym to candidate chemical component IDs. */
+    async findChemComps(query, limit, ctx) {
+        // Match the term against both the formal component name and its synonyms:
+        // common names ("heme", "aspirin") live in synonyms, not the formal name
+        // ("PROTOPORPHYRIN IX CONTAINING FE"). A plain full_text search over
+        // mol_definition matches far too broadly and buries the intended component.
+        const chemTerm = (attribute) => ({
+            type: 'terminal',
+            service: 'text_chem',
+            parameters: { attribute, operator: 'contains_words', value: query },
+        });
+        const body = {
+            query: {
+                type: 'group',
+                logical_operator: 'or',
+                nodes: [chemTerm('chem_comp.name'), chemTerm('rcsb_chem_comp_synonyms.name')],
+            },
+            return_type: 'mol_definition',
+            request_options: { paginate: { start: 0, rows: limit } },
+        };
+        const raw = await this.postSearch(body, ctx, 'RcsbService.findChemComps');
+        return normalizeHits(raw.result_set).map((h) => h.id);
+    }
+    /** Facet-only aggregation over an optional scoping query (no row pull). */
+    async analyzeFacets(params, facets, ctx) {
+        const body = {
+            query: buildQuery(params),
+            return_type: 'entry',
+            request_options: {
+                ...contentTypeOption(params.contentType),
+                facets: facets.map(toRcsbFacet),
+                paginate: { start: 0, rows: 0 },
+            },
+        };
+        const raw = await this.postSearch(body, ctx, 'RcsbService.analyzeFacets');
+        return { total: raw.total_count ?? 0, facets: normalizeFacets(raw.facets, facets) };
+    }
+    // ─── GraphQL metadata ────────────────────────────────────────────────────────
+    /** Batched entry metadata for up to N PDB IDs in one GraphQL call. */
+    async getEntries(ids, ctx) {
+        if (ids.length === 0)
+            return [];
+        const data = await this.graphql(ENTRIES_QUERY, { ids: ids.map((id) => id.toUpperCase()) }, ctx, 'RcsbService.getEntries');
+        return (data.entries ?? []).filter((e) => e != null).map(normalizeEntry);
+    }
+    /** Resolve a PDB entry to its cross-referenced UniProt accession(s). */
+    async resolveUniprot(pdbId, ctx) {
+        const data = await this.graphql(XREF_QUERY, { id: pdbId.toUpperCase() }, ctx, 'RcsbService.resolveUniprot');
+        const accessions = new Set();
+        for (const entity of data.entry?.polymer_entities ?? []) {
+            for (const ref of entity.rcsb_polymer_entity_container_identifiers
+                ?.reference_sequence_identifiers ?? []) {
+                if (/uniprot/i.test(ref.database_name ?? '') && ref.database_accession) {
+                    accessions.add(ref.database_accession.toUpperCase());
+                }
+            }
+        }
+        return [...accessions];
+    }
+    /** First polymer entity's one-letter sequence for a PDB entry. */
+    async getSequence(pdbId, ctx) {
+        const data = await this.graphql(SEQUENCE_QUERY, { id: pdbId.toUpperCase() }, ctx, 'RcsbService.getSequence');
+        const entity = data.entry?.polymer_entities?.find((e) => e.entity_poly?.pdbx_seq_one_letter_code_can);
+        const seq = entity?.entity_poly?.pdbx_seq_one_letter_code_can;
+        if (!entity || !seq)
+            return null;
+        return { entityId: entity.rcsb_id ?? pdbId, sequence: seq.replace(/\s+/g, '') };
+    }
+    /** Ligand binding-site residues for an entry, optionally filtered to one ligand. */
+    async getBindingSites(pdbId, compId, ctx) {
+        const data = await this.graphql(BINDING_SITE_QUERY, { id: pdbId.toUpperCase() }, ctx, 'RcsbService.getBindingSites');
+        const sites = [];
+        const want = compId?.toUpperCase();
+        for (const nonpoly of data.entry?.nonpolymer_entities ?? []) {
+            const ligand = nonpoly.rcsb_nonpolymer_entity_container_identifiers?.nonpolymer_comp_id;
+            if (!ligand || (want && ligand.toUpperCase() !== want))
+                continue;
+            for (const inst of nonpoly.nonpolymer_entity_instances ?? []) {
+                const neighbors = inst.rcsb_target_neighbors ?? [];
+                if (neighbors.length === 0)
+                    continue;
+                sites.push({
+                    ligandCompId: ligand,
+                    ...(inst.rcsb_nonpolymer_entity_instance_container_identifiers?.auth_asym_id
+                        ? {
+                            ligandAsymId: inst.rcsb_nonpolymer_entity_instance_container_identifiers.auth_asym_id,
+                        }
+                        : {}),
+                    residues: neighbors
+                        .map(normalizeNeighbor)
+                        .filter((r) => r != null)
+                        .sort((a, b) => (a.distance ?? Infinity) - (b.distance ?? Infinity)),
+                });
+            }
+        }
+        return sites;
+    }
+    // ─── REST chemical component ──────────────────────────────────────────────────
+    /** Chemical-component metadata (formula, weight, SMILES, InChIKey). */
+    async getChemComp(compId, ctx) {
+        const id = compId.toUpperCase();
+        let raw;
+        try {
+            raw = await fetchJson(`${this.dataRestBase}/chemcomp/${encodeURIComponent(id)}`, ctx, {
+                operation: 'RcsbService.getChemComp',
+                label: 'RCSB Data API',
+                baseDelayMs: 400,
+            });
+        }
+        catch (err) {
+            if (err instanceof McpError && err.code === JsonRpcErrorCode.NotFound)
+                return null;
+            throw err;
+        }
+        return normalizeChemComp(id, raw);
+    }
+    // ─── Files ────────────────────────────────────────────────────────────────────
+    /** Construct a coordinate-file download URL for a PDB entry. */
+    coordinateFileUrl(pdbId, format) {
+        return `${this.filesBase}/download/${pdbId.toUpperCase()}.${format}`;
+    }
+    // ─── Private ───────────────────────────────────────────────────────────────────
+    postSearch(body, ctx, operation) {
+        return fetchJson(this.searchUrl, ctx, {
+            method: 'POST',
+            body: JSON.stringify(body),
+            headers: { 'Content-Type': 'application/json' },
+            operation,
+            label: 'RCSB Search API',
+            baseDelayMs: 400,
+        });
+    }
+    async graphql(query, variables, ctx, operation) {
+        const body = await fetchJson(this.graphqlUrl, ctx, {
+            method: 'POST',
+            body: JSON.stringify({ query, variables }),
+            headers: { 'Content-Type': 'application/json' },
+            operation,
+            label: 'RCSB GraphQL API',
+            baseDelayMs: 400,
+        });
+        if (body.data)
+            return body.data;
+        const message = body.errors?.[0]?.message ?? 'unknown error';
+        throw new McpError(JsonRpcErrorCode.InternalError, `RCSB GraphQL error: ${message}`, {
+            retryable: false,
+        });
+    }
+}
+// ─── Query builders ──────────────────────────────────────────────────────────
+/** Build the RCSB query node from search params (match-all when no constraint given). */
+export function buildQuery(params) {
+    const nodes = [];
+    if (params.text) {
+        nodes.push({ type: 'terminal', service: 'full_text', parameters: { value: params.text } });
+    }
+    if (params.sequence) {
+        nodes.push({
+            type: 'terminal',
+            service: 'sequence',
+            parameters: {
+                evalue_cutoff: params.maxEvalue ?? 1,
+                identity_cutoff: params.minIdentity ?? 0,
+                sequence_type: 'protein',
+                value: params.sequence,
+            },
+        });
+    }
+    if (params.organism) {
+        nodes.push(textNode('rcsb_entity_source_organism.ncbi_scientific_name', 'contains_phrase', params.organism));
+    }
+    if (params.method) {
+        nodes.push(textNode('exptl.method', 'exact_match', params.method));
+    }
+    if (typeof params.maxResolution === 'number') {
+        nodes.push(textNode('rcsb_entry_info.resolution_combined', 'less_or_equal', params.maxResolution));
+    }
+    if (nodes.length === 0)
+        return MATCH_ALL;
+    if (nodes.length === 1)
+        return nodes[0];
+    return { type: 'group', logical_operator: 'and', nodes };
+}
+function textNode(attribute, operator, value) {
+    return { type: 'terminal', service: 'text', parameters: { attribute, operator, value } };
+}
+function contentTypeOption(contentType) {
+    if (!contentType)
+        return {};
+    return { results_content_type: [contentType] };
+}
+/** Translate a friendly FacetSpec into the RCSB facet request shape (recursively). */
+export function toRcsbFacet(spec) {
+    const facet = {
+        name: spec.dimension,
+        aggregation_type: spec.aggregation,
+        attribute: spec.attribute,
+        min_interval_population: 1,
+    };
+    if (spec.aggregation !== 'terms' && spec.interval !== undefined)
+        facet.interval = spec.interval;
+    if (spec.child)
+        facet.facets = [toRcsbFacet(spec.child)];
+    return facet;
+}
+// ─── Normalizers ──────────────────────────────────────────────────────────────
+function normalizeHits(resultSet) {
+    return (resultSet ?? []).map((r) => ({ id: r.identifier, score: r.score }));
+}
+function normalizeFacets(raw, specs) {
+    const byAttr = new Map((raw ?? []).map((f) => [f.attribute ?? f.name, f]));
+    return specs.map((spec) => {
+        const match = byAttr.get(spec.attribute) ?? byAttr.get(spec.dimension);
+        return {
+            dimension: spec.dimension,
+            attribute: spec.attribute,
+            buckets: normalizeBuckets(match?.buckets, spec.child),
+        };
+    });
+}
+function normalizeBuckets(raw, child) {
+    return (raw ?? []).map((b) => {
+        const label = b.label ?? (b.value != null ? String(b.value) : '');
+        const count = b.population ?? b.count ?? 0;
+        const bucket = { label, count };
+        if (child && b.facets) {
+            bucket.children = [
+                {
+                    dimension: child.dimension,
+                    attribute: child.attribute,
+                    buckets: normalizeBuckets(b.facets[0]?.buckets, child.child),
+                },
+            ];
+        }
+        return bucket;
+    });
+}
+function normalizeEntry(raw) {
+    const polymerEntities = (raw.polymer_entities ?? []).map(normalizePolymerEntity);
+    const organisms = [
+        ...new Set(polymerEntities.map((e) => e.organism).filter((o) => !!o)),
+    ];
+    const ligands = (raw.nonpolymer_entities ?? [])
+        .map(normalizeLigand)
+        .filter((l) => l != null);
+    const methods = (raw.exptl ?? []).map((e) => e.method).filter((m) => !!m);
+    const resolution = raw.rcsb_entry_info?.resolution_combined?.[0];
+    return {
+        id: raw.rcsb_id,
+        ...(raw.struct?.title ? { title: raw.struct.title } : {}),
+        ...(methods.length > 0 ? { methods } : {}),
+        ...(typeof resolution === 'number' ? { resolution } : {}),
+        ...(typeof raw.rcsb_entry_info?.molecular_weight === 'number'
+            ? { molecularWeight: raw.rcsb_entry_info.molecular_weight }
+            : {}),
+        ...(raw.rcsb_accession_info?.initial_release_date
+            ? { releaseDate: raw.rcsb_accession_info.initial_release_date }
+            : {}),
+        organisms,
+        polymerEntities,
+        ligands,
+    };
+}
+function normalizePolymerEntity(raw) {
+    const organism = raw.rcsb_entity_source_organism?.find((o) => o.ncbi_scientific_name)?.ncbi_scientific_name;
+    const chains = raw.rcsb_polymer_entity_container_identifiers?.auth_asym_ids;
+    return {
+        entityId: raw.rcsb_id ?? '',
+        ...(raw.rcsb_polymer_entity?.pdbx_description
+            ? { description: raw.rcsb_polymer_entity.pdbx_description }
+            : {}),
+        ...(organism ? { organism } : {}),
+        ...(chains && chains.length > 0 ? { chains } : {}),
+        ...(typeof raw.entity_poly?.rcsb_sample_sequence_length === 'number'
+            ? { sequenceLength: raw.entity_poly.rcsb_sample_sequence_length }
+            : {}),
+    };
+}
+function normalizeLigand(raw) {
+    const compId = raw.rcsb_nonpolymer_entity_container_identifiers?.nonpolymer_comp_id;
+    if (!compId)
+        return;
+    const chem = raw.nonpolymer_comp?.chem_comp;
+    return {
+        compId,
+        ...(chem?.name ? { name: chem.name } : {}),
+        ...(chem?.formula ? { formula: chem.formula } : {}),
+    };
+}
+function normalizeNeighbor(raw) {
+    if (!raw.target_comp_id || !raw.target_asym_id)
+        return;
+    return {
+        residueCompId: raw.target_comp_id,
+        asymId: raw.target_asym_id,
+        ...(typeof raw.target_seq_id === 'number' ? { seqId: raw.target_seq_id } : {}),
+        ...(typeof raw.distance === 'number' ? { distance: raw.distance } : {}),
+    };
+}
+function normalizeChemComp(id, raw) {
+    const descriptors = raw.rcsb_chem_comp_descriptor;
+    const smiles = descriptors?.SMILES_stereo ??
+        descriptors?.SMILES ??
+        raw.pdbx_chem_comp_descriptor?.find((d) => d.type === 'SMILES_CANONICAL')?.descriptor ??
+        raw.pdbx_chem_comp_descriptor?.find((d) => d.type === 'SMILES')?.descriptor;
+    const inchikey = descriptors?.InChIKey ??
+        raw.pdbx_chem_comp_descriptor?.find((d) => d.type === 'InChIKey')?.descriptor;
+    return {
+        compId: id,
+        ...(raw.chem_comp?.name ? { name: raw.chem_comp.name } : {}),
+        ...(raw.chem_comp?.formula ? { formula: raw.chem_comp.formula } : {}),
+        ...(typeof raw.chem_comp?.formula_weight === 'number'
+            ? { formulaWeight: raw.chem_comp.formula_weight }
+            : {}),
+        ...(smiles ? { smiles } : {}),
+        ...(inchikey ? { inchikey } : {}),
+        ...(raw.chem_comp?.type ? { type: raw.chem_comp.type } : {}),
+    };
+}
+// ─── GraphQL queries ──────────────────────────────────────────────────────────
+const ENTRIES_QUERY = `query Entries($ids: [String!]!) {
+  entries(entry_ids: $ids) {
+    rcsb_id
+    struct { title }
+    exptl { method }
+    rcsb_entry_info { resolution_combined molecular_weight }
+    rcsb_accession_info { initial_release_date }
+    polymer_entities {
+      rcsb_id
+      rcsb_polymer_entity { pdbx_description }
+      rcsb_polymer_entity_container_identifiers { auth_asym_ids }
+      entity_poly { rcsb_sample_sequence_length }
+      rcsb_entity_source_organism { ncbi_scientific_name }
+    }
+    nonpolymer_entities {
+      rcsb_nonpolymer_entity_container_identifiers { nonpolymer_comp_id }
+      nonpolymer_comp { chem_comp { name formula } }
+    }
+  }
+}`;
+const XREF_QUERY = `query Xref($id: String!) {
+  entry(entry_id: $id) {
+    polymer_entities {
+      rcsb_polymer_entity_container_identifiers {
+        reference_sequence_identifiers { database_accession database_name }
+      }
+    }
+  }
+}`;
+const SEQUENCE_QUERY = `query Sequence($id: String!) {
+  entry(entry_id: $id) {
+    polymer_entities {
+      rcsb_id
+      entity_poly { pdbx_seq_one_letter_code_can }
+    }
+  }
+}`;
+const BINDING_SITE_QUERY = `query BindingSite($id: String!) {
+  entry(entry_id: $id) {
+    nonpolymer_entities {
+      rcsb_nonpolymer_entity_container_identifiers { nonpolymer_comp_id }
+      nonpolymer_entity_instances {
+        rcsb_nonpolymer_entity_instance_container_identifiers { auth_asym_id }
+        rcsb_target_neighbors { target_asym_id target_comp_id target_seq_id distance }
+      }
+    }
+  }
+}`;
+// ─── Init/accessor ──────────────────────────────────────────────────────────────
+let _service;
+export function initRcsbService(config, storage, serverConfig) {
+    _service = new RcsbService(config, storage, serverConfig);
+}
+export function getRcsbService() {
+    if (!_service)
+        throw new Error('RcsbService not initialized — call initRcsbService() in setup()');
+    return _service;
+}
+//# sourceMappingURL=rcsb-service.js.map

package/dist/services/rcsb/rcsb-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rcsb-service.js","sourceRoot":"","sources":["../../../src/services/rcsb/rcsb-service.ts"],"names":[],"mappings":"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"}

package/dist/services/rcsb/types.d.ts

@@ -0,0 +1,150 @@
+/**
+ * @fileoverview Domain types for the RCSB service — normalized shapes the tools
+ * consume, decoupled from the raw Search/GraphQL payloads. Optional fields mirror
+ * real upstream sparsity (missing = unknown, never fabricated).
+ * @module services/rcsb/types
+ */
+/** A single search hit before metadata enrichment. */
+export interface SearchHit {
+    /** Identifier (PDB entry ID, polymer-entity ID, or chem-comp ID per return type). */
+    id: string;
+    /** RCSB relevance score. */
+    score: number;
+}
+/** One facet bucket; `children` present only for multidimensional (nested) facets. */
+export interface FacetBucket {
+    /** Nested sub-facets for multidimensional cross-tabs. */
+    children?: FacetDimension[];
+    /** Count of entries in the bucket. */
+    count: number;
+    /** Bucket label (category value, numeric bin start, or period). */
+    label: string;
+}
+/** A facet dimension and its buckets. */
+export interface FacetDimension {
+    /** RCSB attribute path the dimension aggregates on. */
+    attribute: string;
+    /** Aggregation buckets, count-descending for terms / order-preserving for histograms. */
+    buckets: FacetBucket[];
+    /** Friendly dimension name (e.g. `method`, `organism`, `release_year`). */
+    dimension: string;
+    /** True when buckets were capped by the per-dimension limit. */
+    truncated?: boolean;
+}
+/** Result of a structure search. */
+export interface SearchResult {
+    /** Optional facet breakdown when requested. */
+    facets?: FacetDimension[];
+    /** The current page of hits. */
+    hits: SearchHit[];
+    /** Total matches upstream (before pagination). */
+    total: number;
+}
+/** A modeled polymer (protein/nucleic) entity within an entry. */
+export interface PolymerEntityMeta {
+    /** Author-assigned chain IDs for this entity. */
+    chains?: string[];
+    /** Free-text description (e.g. "Hemoglobin subunit alpha"). */
+    description?: string;
+    /** Entity identifier (e.g. `4HHB_1`). */
+    entityId: string;
+    /** Source organism scientific name. */
+    organism?: string;
+    /** One-letter canonical sequence (present only when explicitly requested). */
+    sequence?: string;
+    /** Residue count of the sample sequence. */
+    sequenceLength?: number;
+}
+/** A bound non-polymer (ligand) component within an entry. */
+export interface LigandMeta {
+    /** Chemical component ID (e.g. `HEM`, `STI`). */
+    compId: string;
+    /** Molecular formula when available. */
+    formula?: string;
+    /** Chemical name when available. */
+    name?: string;
+}
+/** Normalized entry-level metadata from the GraphQL batch. */
+export interface EntryMeta {
+    /** PDB entry ID. */
+    id: string;
+    /** Bound ligands (non-polymer entities). */
+    ligands: LigandMeta[];
+    /** Experimental method(s) (e.g. ["X-RAY DIFFRACTION"]). */
+    methods?: string[];
+    /** Deposited structure molecular weight (kDa). */
+    molecularWeight?: number;
+    /** Distinct source organisms across polymer entities. */
+    organisms: string[];
+    /** Modeled polymer entities. */
+    polymerEntities: PolymerEntityMeta[];
+    /** Initial release date (ISO 8601). */
+    releaseDate?: string;
+    /** Best resolution in Å when applicable. */
+    resolution?: number;
+    /** Structure title. */
+    title?: string;
+}
+/** One protein residue lining a ligand's binding pocket. */
+export interface BindingResidue {
+    /** Author/asym chain ID the residue belongs to. */
+    asymId: string;
+    /** Contact distance to the ligand in Å. */
+    distance?: number;
+    /** Residue chemical component ID (e.g. `ASP`). */
+    residueCompId: string;
+    /** Sequence position of the residue. */
+    seqId?: number;
+}
+/** A ligand instance and the residues lining its pocket. */
+export interface BindingSite {
+    /** Ligand instance chain (asym) ID. */
+    ligandAsymId?: string;
+    /** Ligand chemical component ID. */
+    ligandCompId: string;
+    /** Interacting protein residues, nearest first. */
+    residues: BindingResidue[];
+}
+/** Chemical-component metadata for a ligand. */
+export interface ChemComp {
+    /** Component ID (e.g. `STI`). */
+    compId: string;
+    /** Molecular formula. */
+    formula?: string;
+    /** Formula weight (Da). */
+    formulaWeight?: number;
+    /** InChIKey when available. */
+    inchikey?: string;
+    /** Chemical name. */
+    name?: string;
+    /** Isomeric SMILES when available. */
+    smiles?: string;
+    /** Component type (e.g. "non-polymer"). */
+    type?: string;
+}
+/** Content-type scope for a search. */
+export type ContentType = 'experimental' | 'computational';
+/** Inputs to a structure search (shared by search + analyze tools). */
+export interface StructureSearchParams {
+    /** Result content scope. */
+    contentType?: ContentType;
+    /** Page size. */
+    limit?: number;
+    /** Max E-value for a sequence query. */
+    maxEvalue?: number;
+    /** Maximum resolution in Å. */
+    maxResolution?: number;
+    /** Experimental method filter (e.g. "X-RAY DIFFRACTION"). */
+    method?: string;
+    /** Minimum sequence identity (0–1) for a sequence query. */
+    minIdentity?: number;
+    /** Source organism filter (scientific name). */
+    organism?: string;
+    /** Protein sequence (one-letter) for an mmseqs2 search. */
+    sequence?: string;
+    /** Page offset. */
+    start?: number;
+    /** Free-text query. */
+    text?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/rcsb/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/rcsb/types.ts"],"names":[],"mappings":"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"}

package/dist/services/rcsb/types.js

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Domain types for the RCSB service — normalized shapes the tools
+ * consume, decoupled from the raw Search/GraphQL payloads. Optional fields mirror
+ * real upstream sparsity (missing = unknown, never fabricated).
+ * @module services/rcsb/types
+ */
+export {};
+//# sourceMappingURL=types.js.map