import type { SynthesisPlan, SynthesisRoute } from './types'; export declare const SYNTHESIS_PLAN_REQUEST_SCHEMA: { readonly type: "object"; readonly additionalProperties: false; readonly required: readonly ["target"]; readonly properties: { readonly target: { readonly type: "string"; readonly pattern: "\\S"; readonly description: "Target phase as a formula (e.g. \"LiCoO2\", \"BaTiO3\") or an entry id present in the thermodynamic data. A formula picks the lowest-energy matching entry."; }; readonly max_precursors: { readonly type: "integer"; readonly minimum: 1; readonly maximum: 4; readonly default: 2; readonly description: "Largest number of precursors combined in one firing. 1 also finds single-precursor decomposition routes, 3-4 are slower and rarely cleaner."; }; readonly two_step: { readonly type: "boolean"; readonly default: false; readonly description: "Also search two-step routes: synthesize an intermediate first, then react it on to the target. Useful when every direct route has a more favorable competing phase."; }; readonly conditions: { readonly type: "object"; readonly additionalProperties: false; readonly properties: { readonly temperature: { readonly type: "number"; readonly minimum: 0; readonly maximum: 2000; readonly default: 0; readonly description: "Firing temperature in K. Solids keep their 0 K computed energies; gases get μ(T, p) so carbonate/hydroxide decomposition and O2 release become temperature dependent."; }; readonly open_species: { readonly type: "array"; readonly items: { readonly type: "string"; readonly enum: readonly ["O2", "N2", "H2", "CO", "CO2", "H2O", "F2"]; }; readonly description: "Gases the reaction may release to or take from the atmosphere, e.g. [\"O2\", \"CO2\"] for firing carbonates in air. Required for precursors containing elements absent from the target (C in Li2CO3, H in LiOH)."; }; readonly partial_pressures: { readonly type: "object"; readonly additionalProperties: false; readonly properties: { [k: string]: { type: string; exclusiveMinimum: number; }; }; readonly description: "Partial pressures in bar. Default is ambient air (O2 0.21, CO2 4e-4, H2O 0.03)."; }; }; }; readonly precursors: { readonly type: "object"; readonly additionalProperties: false; readonly properties: { readonly allow: { readonly type: "array"; readonly items: { readonly type: "string"; }; readonly description: "Only these formulas/entry ids may be precursors (e.g. what is on the shelf)."; }; readonly block: { readonly type: "array"; readonly items: { readonly type: "string"; }; readonly description: "Never use these formulas/entry ids as precursors."; }; readonly max_e_above_hull: { readonly type: "number"; readonly minimum: 0; readonly default: 0.03; readonly description: "Max 0 K hull distance (eV/atom) for a phase to count as an obtainable precursor."; }; readonly only_common: { readonly type: "boolean"; readonly description: "Restrict to the built-in library of commercial precursors (carbonates, oxides, hydroxides, ...). Default: true when the library covers every target element."; }; readonly max_elements: { readonly type: "integer"; readonly minimum: 1; readonly description: "Max distinct elements per precursor. Default: one fewer than the target; library precursors always pass."; }; }; }; readonly scoring: { readonly type: "object"; readonly additionalProperties: false; readonly description: "Override ranking weights (defaults: selectivity 3, inverse_hull 2, driving_force 0.5, competition 1, practicality 2, simplicity 0.5)."; readonly properties: { [k: string]: { type: string; minimum: number; }; }; }; readonly max_routes: { readonly type: "integer"; readonly minimum: 1; readonly maximum: 200; readonly default: 20; }; readonly target_mass_g: { readonly type: "number"; readonly exclusiveMinimum: 0; readonly default: 1; readonly description: "Target mass the recipe quantities are scaled to."; }; }; }; export declare const SYNTHESIS_PLANNER_TOOL: { readonly name: "plan_synthesis"; readonly description: "Rank solid-state synthesis routes to a target inorganic phase from simulated convex-hull data (formation energies per atom from DFT, ML potentials or experiment). For every precursor set it balances the reaction (with optional gas release/uptake), computes the reaction energy, the competing phases that can form from the same mixture with their driving forces, the inverse hull energy (https://doi.org/10.1038/s44160-024-00502-y), the temperature at which gas-releasing reactions turn favorable, and a bench recipe (masses for a given target mass, heating window, procedure). Returns routes best-first with per-term score breakdowns and plain-language rationale. Needs thermodynamic entries covering the target's chemical system plus any precursor-only elements (C for carbonates, H for hydroxides) and the corresponding open_species."; readonly input_schema: { readonly type: "object"; readonly additionalProperties: false; readonly required: readonly ["target"]; readonly properties: { readonly target: { readonly type: "string"; readonly pattern: "\\S"; readonly description: "Target phase as a formula (e.g. \"LiCoO2\", \"BaTiO3\") or an entry id present in the thermodynamic data. A formula picks the lowest-energy matching entry."; }; readonly max_precursors: { readonly type: "integer"; readonly minimum: 1; readonly maximum: 4; readonly default: 2; readonly description: "Largest number of precursors combined in one firing. 1 also finds single-precursor decomposition routes, 3-4 are slower and rarely cleaner."; }; readonly two_step: { readonly type: "boolean"; readonly default: false; readonly description: "Also search two-step routes: synthesize an intermediate first, then react it on to the target. Useful when every direct route has a more favorable competing phase."; }; readonly conditions: { readonly type: "object"; readonly additionalProperties: false; readonly properties: { readonly temperature: { readonly type: "number"; readonly minimum: 0; readonly maximum: 2000; readonly default: 0; readonly description: "Firing temperature in K. Solids keep their 0 K computed energies; gases get μ(T, p) so carbonate/hydroxide decomposition and O2 release become temperature dependent."; }; readonly open_species: { readonly type: "array"; readonly items: { readonly type: "string"; readonly enum: readonly ["O2", "N2", "H2", "CO", "CO2", "H2O", "F2"]; }; readonly description: "Gases the reaction may release to or take from the atmosphere, e.g. [\"O2\", \"CO2\"] for firing carbonates in air. Required for precursors containing elements absent from the target (C in Li2CO3, H in LiOH)."; }; readonly partial_pressures: { readonly type: "object"; readonly additionalProperties: false; readonly properties: { [k: string]: { type: string; exclusiveMinimum: number; }; }; readonly description: "Partial pressures in bar. Default is ambient air (O2 0.21, CO2 4e-4, H2O 0.03)."; }; }; }; readonly precursors: { readonly type: "object"; readonly additionalProperties: false; readonly properties: { readonly allow: { readonly type: "array"; readonly items: { readonly type: "string"; }; readonly description: "Only these formulas/entry ids may be precursors (e.g. what is on the shelf)."; }; readonly block: { readonly type: "array"; readonly items: { readonly type: "string"; }; readonly description: "Never use these formulas/entry ids as precursors."; }; readonly max_e_above_hull: { readonly type: "number"; readonly minimum: 0; readonly default: 0.03; readonly description: "Max 0 K hull distance (eV/atom) for a phase to count as an obtainable precursor."; }; readonly only_common: { readonly type: "boolean"; readonly description: "Restrict to the built-in library of commercial precursors (carbonates, oxides, hydroxides, ...). Default: true when the library covers every target element."; }; readonly max_elements: { readonly type: "integer"; readonly minimum: 1; readonly description: "Max distinct elements per precursor. Default: one fewer than the target; library precursors always pass."; }; }; }; readonly scoring: { readonly type: "object"; readonly additionalProperties: false; readonly description: "Override ranking weights (defaults: selectivity 3, inverse_hull 2, driving_force 0.5, competition 1, practicality 2, simplicity 0.5)."; readonly properties: { [k: string]: { type: string; minimum: number; }; }; }; readonly max_routes: { readonly type: "integer"; readonly minimum: 1; readonly maximum: 200; readonly default: 20; }; readonly target_mass_g: { readonly type: "number"; readonly exclusiveMinimum: 0; readonly default: 1; readonly description: "Target mass the recipe quantities are scaled to."; }; }; }; }; export declare function format_route_text(route: SynthesisRoute, rank?: number): string; export declare function format_plan_text(plan: SynthesisPlan, max_routes?: number): string;