Skip to main content

qualia_mcp/tools/
quantum.rs

1//! MCP tools for Quantum Computing, QUBO Optimization, and DFT Density Functional Theory.
2//!
3//! Migrated from legacy `mcp_stub_impls.rs` to dedicated library module.
4//! Designed according to `AGENTS.md` ยง0-B (<500 lines).
5
6use crate::types::{parse_quin_slice, parse_tool_args, McpSystemError};
7use serde_json::json;
8
9/// `qpu_optimize` tool โ€” formulates a problem via PreSolver, loads QUBO Hamiltonian into QuboMatrix, and solves classically.
10pub fn qpu_optimize(args: &[u8]) -> Result<String, McpSystemError> {
11    use qualia_core_db::qubo_compiler::{solve_classical, QuboMatrix};
12    use qualia_core_db::solvers::qpu::pre_solver::{PreSolver, ProblemDescription, QuboFormulation};
13
14    let v = parse_tool_args(args)?;
15    let problem_val = v.get("problem").ok_or(McpSystemError::InvalidParameters)?;
16    let problem: ProblemDescription = serde_json::from_value(problem_val.clone())
17        .map_err(|_| McpSystemError::InvalidParameters)?;
18
19    let mut solver = PreSolver::new();
20    let job = solver
21        .formulate(&problem)
22        .map_err(|_| McpSystemError::ParseError)?;
23
24    let mut matrix = QuboMatrix::new(problem.variables.len().max(1));
25    if let Some(ham) = job.hamiltonian.as_deref() {
26        if let Ok(form) = serde_json::from_str::<QuboFormulation>(ham) {
27            for (idx, coeff) in form.linear_terms {
28                matrix.set_linear(idx as usize, coeff);
29            }
30            for (a, b, coeff) in form.quadratic_terms {
31                matrix.set_quadratic(a as usize, b as usize, coeff);
32            }
33        }
34    }
35
36    let mut assignment = vec![0u8; matrix.num_vars];
37    let energy = solve_classical(&matrix, &mut assignment);
38
39    let payload = json!({
40        "jobParameters": job,
41        "classicalEnergy": energy,
42        "assignment": assignment,
43        "numVariables": matrix.num_vars,
44    });
45    serde_json::to_string(&payload).map_err(|_| McpSystemError::ParseError)
46}
47
48/// `qpu_dft` tool โ€” computes ground-state energy of electron quins on a density grid via Thomas-Fermi / DFT.
49pub fn qpu_dft(args: &[u8]) -> Result<String, McpSystemError> {
50    let v = parse_tool_args(args)?;
51    let resolution = v
52        .get("grid_resolution")
53        .and_then(|x| x.as_u64())
54        .unwrap_or(8) as usize;
55    let quins = if v.get("quins").is_some() {
56        parse_quin_slice(&v, "quins")?
57    } else {
58        Vec::new()
59    };
60
61    let mut dft = qualia_core_db::quantum_dft::ElectronDensity::new(resolution.max(2));
62    let energy = dft.calculate_ground_state_energy(&quins);
63    let payload = json!({
64        "groundStateEnergy": energy,
65        "gridResolution": dft.grid_resolution,
66        "electronQuinCount": quins.iter().filter(|q| q.predicate == qualia_core_db::q_hash("HAS_ELECTRON")).count(),
67    });
68    serde_json::to_string(&payload).map_err(|_| McpSystemError::ParseError)
69}
70
71/// Helper mapping `QPUJobStatus` to string label.
72fn qpu_job_status_label(status: qualia_core_db::specialized_libs::qpu_bridge::QPUJobStatus) -> &'static str {
73    use qualia_core_db::specialized_libs::qpu_bridge::QPUJobStatus;
74    match status {
75        QPUJobStatus::Queued => "queued",
76        QPUJobStatus::Running => "running",
77        QPUJobStatus::Completed => "completed",
78        QPUJobStatus::Failed => "failed",
79        QPUJobStatus::Cancelled => "cancelled",
80        QPUJobStatus::Timeout => "timeout",
81    }
82}
83
84/// `qpu_status` tool โ€” inspects connection flag and current job queue status of the QPU bridge manager.
85pub fn qpu_status(_args: &[u8]) -> Result<String, McpSystemError> {
86    use qualia_core_db::specialized_libs::qpu_bridge::QPUBridgeManager;
87    let bridge = QPUBridgeManager::new();
88    let payload = json!({
89        "connected": bridge.is_connected(),
90        "jobStatus": qpu_job_status_label(bridge.get_job_status()),
91    });
92    serde_json::to_string(&payload).map_err(|_| McpSystemError::ParseError)
93}