/**
 * @fileoverview Search PubChem for chemical compounds by name, SMILES, InChIKey,
 * formula, substructure, superstructure, or 2D similarity.
 * @module mcp-server/tools/definitions/search-compounds
 */
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const searchCompounds: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
    searchType: z.ZodEnum<{
        formula: "formula";
        identifier: "identifier";
        similarity: "similarity";
        substructure: "substructure";
        superstructure: "superstructure";
    }>;
    identifierType: z.ZodOptional<z.ZodEnum<{
        inchikey: "inchikey";
        name: "name";
        smiles: "smiles";
    }>>;
    identifiers: z.ZodOptional<z.ZodArray<z.ZodString>>;
    formula: z.ZodOptional<z.ZodString>;
    allowOtherElements: z.ZodDefault<z.ZodBoolean>;
    query: z.ZodOptional<z.ZodString>;
    queryType: z.ZodOptional<z.ZodEnum<{
        cid: "cid";
        smiles: "smiles";
    }>>;
    threshold: z.ZodDefault<z.ZodNumber>;
    offset: z.ZodDefault<z.ZodNumber>;
    maxResults: z.ZodDefault<z.ZodNumber>;
    properties: z.ZodOptional<z.ZodArray<z.ZodEnum<{
        [x: string]: string;
    }>>>;
}, z.core.$strip>, z.ZodObject<{
    results: z.ZodArray<z.ZodObject<{
        cid: z.ZodNumber;
        identifier: z.ZodOptional<z.ZodString>;
        properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
    }, z.core.$strip>>;
    unresolvedIdentifiers: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strip>, readonly [{
    readonly reason: "missing_identifier_args";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "searchType is \"identifier\" but identifierType or identifiers were omitted";
    readonly recovery: "Set identifierType (name/smiles/inchikey) and pass a non-empty identifiers array (1-25 entries).";
}, {
    readonly reason: "missing_formula";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "searchType is \"formula\" but the formula field was omitted or blank";
    readonly recovery: "Pass formula in Hill notation, for example \"C6H12O6\" or \"CaH2O2\".";
}, {
    readonly reason: "missing_structure_args";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "substructure/superstructure/similarity search with query or queryType omitted, or a blank query";
    readonly recovery: "Provide both query (SMILES string or CID as string) and queryType (\"smiles\" or \"cid\").";
}, {
    readonly reason: "invalid_cid_query";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "structure/similarity search with queryType \"cid\" but query is not a positive integer CID";
    readonly recovery: "Pass a positive integer CID string (e.g. \"2244\"), or set queryType \"smiles\" with a SMILES query.";
}, {
    readonly reason: "identifier_rejected";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly when: "identifier search where PubChem rejected every identifier in the batch as unreadable (HTTP 400) — for SMILES, a string it could not standardize into a structure. A batch with any other outcome lists rejected inputs in unresolvedIdentifiers instead";
    readonly recovery: "Check each identifier against identifierType: for SMILES, balanced ring closures and parentheses, valid element symbols, and no \"*\" wildcard atoms; otherwise set identifierType to the form the identifiers are in.";
}, {
    readonly reason: "search_query_rejected";
    readonly code: JsonRpcErrorCode.ValidationError;
    readonly thrownBy: "service";
    readonly when: "PubChem failed a formula, substructure, superstructure, or similarity search with HTTP 500 \"Search status indicates failure\" — its answer for a malformed SMILES or formula, a SMILES with a \"*\" wildcard atom, or a CID with no record";
    readonly recovery: "Fix the SMILES syntax or remove \"*\" atoms, write the formula in Hill notation (e.g. \"C6H12O6\"), or confirm the CID exists with pubchem_get_compound_details.";
}], {
    readonly searchType: z.ZodString;
    readonly totalFound: z.ZodOptional<z.ZodNumber>;
    readonly totalFoundAtLeast: z.ZodOptional<z.ZodNumber>;
    readonly offset: z.ZodNumber;
    readonly nextOffset: z.ZodOptional<z.ZodNumber>;
    readonly truncated: z.ZodOptional<z.ZodBoolean>;
    readonly shown: z.ZodOptional<z.ZodNumber>;
    readonly cap: z.ZodOptional<z.ZodNumber>;
    readonly notice: z.ZodOptional<z.ZodString>;
}>;
//# sourceMappingURL=search-compounds.tool.d.ts.map