Skip to main content

qualia_mcp/
registry.rs

1//! Canonical Registry of all Model Context Protocol (MCP) tools for QualiaDB.
2//!
3//! Exposes the complete suite of capabilities required to build software,
4//! run simulations, perform formal reasoning, and query the codebase audit.
5//! Follows `AGENTS.md` §0-B (<500 lines).
6
7use crate::types::McpToolDescriptor;
8use serde_json::{json, Value};
9
10/// Returns all stable MCP tools exposed by the Qualia MCP subsystem.
11pub fn stable_mcp_tools() -> &'static [McpToolDescriptor] {
12    &[
13        // ── Graph & Codebase Audit ──────────────────────────────────────────
14        McpToolDescriptor {
15            name: "query_sparql",
16            description: "Execute a SPARQL query against the in-process daemon graph or a .q42 vault (pass vault_path: 'audit' for codebase.q42).",
17            input_schema: r#"{"type":"object","required":["query"],"properties":{"query":{"type":"string"},"limit":{"type":"integer"},"vault_path":{"type":"string"}}}"#,
18        },
19        McpToolDescriptor {
20            name: "query_graph",
21            description: "Run bare-metal graph traversal against the in-memory daemon graph.",
22            input_schema: r#"{"type":"object","properties":{"sanctuary_override":{"type":"string"}}}"#,
23        },
24        McpToolDescriptor {
25            name: "codebase_audit",
26            description: "Fast lookup of functions, signatures, methods, and files across the entire QualiaDB codebase audit (C:\\github\\qualiaDB\\.audit\\codebase.q42).",
27            input_schema: r#"{"type":"object","properties":{"search":{"type":"string"},"limit":{"type":"integer"},"query":{"type":"string"},"vault_path":{"type":"string"}}}"#,
28        },
29        McpToolDescriptor {
30            name: "get_graph_stats",
31            description: "Return quin count, capacity, and utilization for the resident daemon graph.",
32            input_schema: r#"{"type":"object","properties":{}}"#,
33        },
34        McpToolDescriptor {
35            name: "list_ontologies",
36            description: "List startup ontology catalog entries and on-disk presence.",
37            input_schema: r#"{"type":"object","properties":{}}"#,
38        },
39        McpToolDescriptor {
40            name: "ingest_ontology",
41            description: "Parse TTL/N3/q42 ontology file and extend the daemon graph.",
42            input_schema: r#"{"type":"object","required":["path"],"properties":{"path":{"type":"string"},"context_hash":{"type":"integer"}}}"#,
43        },
44        McpToolDescriptor {
45            name: "get_did_info",
46            description: "Parse a did:q42 identifier into its topological pointer hash.",
47            input_schema: r#"{"type":"object","required":["did"],"properties":{"did":{"type":"string"}}}"#,
48        },
49        McpToolDescriptor {
50            name: "get_wallet_status",
51            description: "Inspect queued ILP micropayments from pending_payments.ndjson.",
52            input_schema: r#"{"type":"object","properties":{}}"#,
53        },
54        // ── VibeScript DSL, Etalon-Vibe SDK & Software Building ─────────────
55        McpToolDescriptor {
56            name: "vibe_check",
57            description: "Parse and typecheck VibeScript 0.1 source code. Returns diagnostics, AST validation, and evidential typing.",
58            input_schema: r#"{"type":"object","required":["source"],"properties":{"source":{"type":"string"}}}"#,
59        },
60        McpToolDescriptor {
61            name: "vibe_compile",
62            description: "Compile VibeScript source into stack-based bytecode Chunk for Webizen VM.",
63            input_schema: r#"{"type":"object","required":["source"],"properties":{"source":{"type":"string"}}}"#,
64        },
65        McpToolDescriptor {
66            name: "vibe_format",
67            description: "Canonical pretty-printer formatting for VibeScript source declarations.",
68            input_schema: r#"{"type":"object","required":["source"],"properties":{"source":{"type":"string"}}}"#,
69        },
70        McpToolDescriptor {
71            name: "vibe_invoke",
72            description: "Invoke bound generic Poet snapshot capabilities. Hypermedia and qualia.species asset operations use Synth ProductionSession via synth_produce_present; discover them with synth_operations.",
73            input_schema: r#"{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"args":{"type":"object"}}}"#,
74        },
75        McpToolDescriptor {
76            name: "vibe_eval",
77            description: "Evaluate VibeScript source code against the live snapshot and return exported bindings and quin count.",
78            input_schema: r#"{"type":"object","required":["source"],"properties":{"source":{"type":"string"}}}"#,
79        },
80        McpToolDescriptor {
81            name: "vibe_catalog",
82            description: "List bound generic Poet snapshot IDs by prefix/seam. This is a different execution host from the Hypermedia asset catalog exposed by synth_operations.",
83            input_schema: r#"{"type":"object","properties":{"prefix":{"type":"string"},"seam":{"type":"string"},"limit":{"type":"integer"}}}"#,
84        },
85        McpToolDescriptor {
86            name: "etalon_vibe_sdk",
87            description: "Inspect the 11 Etalon-Vibe SDK provider namespaces (mech, gpu, forge, render, signal, sense, p64, nquin, infer, qgraph, modality), 37 descriptors, and 5-field NQuin48 parity.",
88            input_schema: r#"{"type":"object","properties":{"provider":{"type":"string"}}}"#,
89        },
90        McpToolDescriptor {
91            name: "wgsl_forge",
92            description: "Deterministic WGSL generation, Naga validation, Roofline arithmetic intensity, schedule pruning, and attention synthesis.",
93            input_schema: r#"{"type":"object","properties":{"op":{"type":"string","enum":["list_kernels","generate","validate","roofline","schedule_candidates","attention_synthesize"]},"kernel":{"type":"string"},"target":{"type":"string"},"workgroup_size":{"type":"integer"},"items_per_invocation":{"type":"integer"},"vector_width":{"type":"integer"},"source":{"type":"string"},"n":{"type":"integer"},"head_dim":{"type":"integer"},"head_count":{"type":"integer"},"context_tokens":{"type":"integer"},"batch_tokens":{"type":"integer"},"mode":{"type":"string"}}}"#,
94        },
95        McpToolDescriptor {
96            name: "poet_authoring",
97            description: "POET shell authoring and Shed catalog (shed_catalog, manifold_create, container_place, nested_link, toolchest_list, manifold_inspect, etc.).",
98            input_schema: r#"{"type":"object","properties":{"op":{"type":"string","enum":["shed_catalog","manifold_create","container_place","nested_link","subject_declare","participant_invite","toolchest_list","manifold_inspect","toolchain_execute","studio_configure","ide_evaluate","qapp_scaffold","theme_configure","inspector_bind","timeline_scrub","viewport_configure","export_bundle"]},"args":{"type":"object"}}}"#,
99        },
100        McpToolDescriptor {
101            name: "poet_studio_domain",
102            description: "Cross-cutting Shed capability runner: apply any toolbox (ComputationalGeometry, Logic, Semantics, Economics, Science, ML, Studio) across containers with target_container.",
103            input_schema: r#"{"type":"object","properties":{"capability":{"type":"string"},"tool":{"type":"string"},"domain":{"type":"string"},"op":{"type":"string"},"target_container":{"type":"string"},"artifact_id":{"type":"string"},"args":{"type":"object"}}}"#,
104        },
105        McpToolDescriptor {
106            name: "poet_artifact_lifecycle",
107            description: "Full MCP lifecycle (create, edit, inspect, import, export, undo, redo, list) for POET Studio artifacts and QualiaDB/industry formats.",
108            input_schema: r#"{"type":"object","properties":{"action":{"type":"string","enum":["create","edit","inspect","import","export","undo","redo","list_artifacts"]},"artifact_id":{"type":"string"},"domain":{"type":"string"},"format":{"type":"string"},"mutation":{"type":"string"},"args":{"type":"object"}}}"#,
109        },
110        // ── Living-World Anatomy & Omniversal Cosmic Coordinates (0.0.41) ───
111        McpToolDescriptor {
112            name: "living_world_anatomy",
113            description: "Living-world botanical (Scales 1..4 PO: / APC:) and comparative vertebrate (Scale 5 UBERON: 18-joint PGA rig & 3-layer osteology/myology/integument peel) anatomical ontology and zero-heap ray-sphere Loupe picking.",
114            input_schema: r#"{"type":"object","properties":{"op":{"type":"string","enum":["catalog","pins","pin_by_id","ray_pick","root_flare","layer_peel"]},"scale":{"type":"integer"},"pin_id":{"type":"string"},"ray_origin":{"type":"array","items":{"type":"number"}},"ray_dir":{"type":"array","items":{"type":"number"}},"max_dist":{"type":"number"},"base_radius":{"type":"number"},"depth_m":{"type":"number"},"flare_factor":{"type":"number"},"osteology_vis":{"type":"number"},"myology_vis":{"type":"number"},"integument_vis":{"type":"number"},"explode":{"type":"number"}}}"#,
115        },
116        McpToolDescriptor {
117            name: "cosmic_coordinates",
118            description: "Omniversal Coordinate System (OCS v2.2.0): celestial profiles, FLRW redshift cosmology, pulsar dispersion delay, warp velocity/Cochrane curves, HEALPix indexing, and USRI realm classes.",
119            input_schema: r#"{"type":"object","properties":{"op":{"type":"string","enum":["celestial_profile","redshift","pulsar_dispersion","warp","healpix","usri_realm"]},"body":{"type":"string"},"z":{"type":"number","description":"Redshift for op=redshift; signed integer direction component for op=healpix."},"dm_pc_cm3":{"type":"number"},"freq_hz":{"type":"number"},"warp_factor":{"type":"number"},"scale":{"type":"string","enum":["tos","tng"]},"x":{"type":"integer"},"y":{"type":"integer"},"nside":{"type":"integer"},"realm":{"type":"string"}},"additionalProperties":false,"allOf":[{"if":{"properties":{"op":{"const":"healpix"}},"required":["op"]},"then":{"properties":{"z":{"type":"integer"},"nside":{"type":"integer","minimum":1,"maximum":536870912}}}}]}"#,
120        },
121        // ── Simulation: Geomechanics, Space Weather, Fire Ecology ───────────
122        McpToolDescriptor {
123            name: "sim_soil_compaction",
124            description: "Evaluate soil compaction, void ratio, and moisture-density Proctor curve for geotechnical engineering.",
125            input_schema: r#"{"type":"object","required":["moisture_ratio"],"properties":{"moisture_ratio":{"type":"number"},"compaction_energy_knm_m3":{"type":"number"},"specific_gravity":{"type":"number"}}}"#,
126        },
127        McpToolDescriptor {
128            name: "sim_trench_excavation",
129            description: "Evaluate trench stability, active earth pressure, and cutting force using Mohr-Coulomb failure criteria.",
130            input_schema: r#"{"type":"object","required":["trench_depth_m"],"properties":{"trench_depth_m":{"type":"number"},"cohesion_kpa":{"type":"number"},"friction_angle_deg":{"type":"number"},"soil_unit_weight_kn_m3":{"type":"number"},"water_table_depth_m":{"type":"number"}}}"#,
131        },
132        McpToolDescriptor {
133            name: "sim_space_weather_eval",
134            description: "Evaluate Schwabe/Hale solar cycles, solar irradiance (EUV/TSI), cosmic ray modulation, and magnetic reconnection.",
135            input_schema: r#"{"type":"object","required":["year_ce"],"properties":{"year_ce":{"type":"number"},"imf_bz_nt":{"type":"number"},"solar_wind_speed_km_s":{"type":"number"}}}"#,
136        },
137        McpToolDescriptor {
138            name: "sim_fire_ecology_eval",
139            description: "Evaluate Olson fuel accumulation, dead fuel moisture (DFMC), Byram fireline intensity, and Rothermel rate of spread.",
140            input_schema: r#"{"type":"object","required":["air_temp_c","relative_humidity_pct"],"properties":{"air_temp_c":{"type":"number"},"relative_humidity_pct":{"type":"number"},"wind_speed_kmh":{"type":"number"},"stand_age_years":{"type":"number"}}}"#,
141        },
142        // ── Geospatial & Planetary Coordinates ──────────────────────────────
143        McpToolDescriptor {
144            name: "geospatial_transform",
145            description: "Transform 3D geodetic coordinates between WGS84, ECEF, ENU, and MGRS frames.",
146            input_schema: r#"{"type":"object","required":["op"],"properties":{"op":{"type":"string","enum":["wgs84_to_ecef","ecef_to_wgs84","ecef_to_enu","wgs84_to_mgrs"]},"lat_deg":{"type":"number"},"lon_deg":{"type":"number"},"alt_m":{"type":"number"},"x":{"type":"number"},"y":{"type":"number"},"z":{"type":"number"},"ref_lat_deg":{"type":"number"},"ref_lon_deg":{"type":"number"},"ref_alt_m":{"type":"number"}}}"#,
147        },
148        McpToolDescriptor {
149            name: "geospatial_hilbert",
150            description: "Encode and decode 2D and 3D Hilbert curve spatial indices for zero-heap spatial hashing.",
151            input_schema: r#"{"type":"object","required":["op"],"properties":{"op":{"type":"string","enum":["encode_2d","decode_2d","encode_3d"]},"order":{"type":"integer"},"x":{"type":"integer"},"y":{"type":"integer"},"z":{"type":"integer"},"index":{"type":"integer"}}}"#,
152        },
153        McpToolDescriptor {
154            name: "geospatial_strata",
155            description: "Query geological strata, lithology, and hydrogeological properties from WFS catalogs.",
156            input_schema: r#"{"type":"object","required":["unit_code"],"properties":{"unit_code":{"type":"string"},"easting":{"type":"number"},"northing":{"type":"number"}}}"#,
157        },
158        // ── Vision, Biosense & Media ────────────────────────────────────────
159        McpToolDescriptor {
160            name: "computer_vision",
161            description: "Native computer_vision specialized library: super-resolution, rgb_to_gray, mesh quality cleanup, class scoring.",
162            input_schema: r#"{"type":"object","required":["op"],"properties":{"op":{"type":"string","enum":["list","capability_summary","rgb_to_gray","super_resolve","mesh_quality_cleanup","class_score_to_sigma"]},"width":{"type":"integer"},"height":{"type":"integer"},"scale":{"type":"integer"},"kernel":{"type":"string","enum":["nearest","bilinear","bicubic","lanczos3"]},"rgb":{"type":"array","items":{"type":"integer"}},"class_hash":{"type":"integer"},"score":{"type":"number"},"positions":{"type":"array","items":{"type":"array","items":{"type":"number"}}},"indices":{"type":"array","items":{"type":"integer"}},"weld_epsilon":{"type":"number"}}}"#,
163        },
164        McpToolDescriptor {
165            name: "vision_rppg",
166            description: "Remote photoplethysmography pulse estimation from raw RGB video channel traces.",
167            input_schema: r#"{"type":"object","required":["r","g","b"],"properties":{"r":{"type":"array","items":{"type":"number"}},"g":{"type":"array","items":{"type":"number"}},"b":{"type":"array","items":{"type":"number"}},"fps":{"type":"number"}}}"#,
168        },
169        McpToolDescriptor {
170            name: "vision_respiration",
171            description: "Estimate respiration rate (breaths per minute) from motion and optical biosensing traces.",
172            input_schema: r#"{"type":"object","required":["trace"],"properties":{"trace":{"type":"array","items":{"type":"number"}},"fps":{"type":"number"}}}"#,
173        },
174        McpToolDescriptor {
175            name: "vision_liveness_pad",
176            description: "Presentation Attack Detection (liveness analysis) on biometric facial tracking.",
177            input_schema: r#"{"type":"object","properties":{"landmark_jitter":{"type":"number"},"profile_asymmetry":{"type":"number"},"non_rigid_depth_var":{"type":"number"}}}"#,
178        },
179        // ── Auditory Intelligence ───────────────────────────────────────────
180        McpToolDescriptor {
181            name: "audio_features",
182            description: "Native qualia-audio features: log_mel spectrogram, pitch_yin (YIN fundamental frequency), loudness_r128 (EBU R128 LUFS).",
183            input_schema: r#"{"type":"object","required":["op"],"properties":{"op":{"type":"string","enum":["list","capability_summary","log_mel","pitch_yin","loudness_r128"]},"samples":{"type":"array","items":{"type":"number"}},"sample_rate":{"type":"integer"},"n_mel":{"type":"integer"}}}"#,
184        },
185        McpToolDescriptor {
186            name: "audio_spatial_hrtf",
187            description: "Zero-heap 3D spatial audio positioning, distance attenuation, and binaural stereo panning.",
188            input_schema: r#"{"type":"object","required":["emitter_x","emitter_y","emitter_z"],"properties":{"emitter_x":{"type":"number"},"emitter_y":{"type":"number"},"emitter_z":{"type":"number"},"listener_x":{"type":"number"},"listener_y":{"type":"number"},"listener_z":{"type":"number"}}}"#,
189        },
190        // ── Logic Modalities & N3 Reasoning ─────────────────────────────────
191        McpToolDescriptor {
192            name: "evaluate_modality",
193            description: "Evaluate logic modalities: LTL temporal traces, ASP stable models, deontic norms, epistemic belief/knowledge, paraconsistent merge.",
194            input_schema: r#"{"type":"object","required":["modality"],"properties":{"modality":{"type":"string"},"quins":{"type":"array"},"trace":{"type":"array"},"formula":{"type":"object"},"now_unix":{"type":"integer"},"agent_did_hash":{"type":"integer"},"world_hash":{"type":"integer"}}}"#,
195        },
196        McpToolDescriptor {
197            name: "evaluate_logic_rules",
198            description: "Load N3 rules into RuleEngine and fire them in the Webizen VM.",
199            input_schema: r#"{"type":"object","required":["n3_source","quin"],"properties":{"n3_source":{"type":"string"},"quin":{"type":"object"},"ruleset_name":{"type":"string"}}}"#,
200        },
201        McpToolDescriptor {
202            name: "symbolic_logic_infer",
203            description: "Defeasible forward-chaining or bounded SAT with caller facts, rules, and clauses.",
204            input_schema: r#"{"type":"object","properties":{"solver":{"type":"string","enum":["defeasible","sat"]},"facts":{"type":"array"},"rules":{"type":"array"},"clauses":{"type":"array"},"max_iterations":{"type":"integer"}}}"#,
205        },
206        McpToolDescriptor {
207            name: "inject_test_quin",
208            description: "Inject a deterministic test Quin through the paraconsistent router.",
209            input_schema: r#"{"type":"object","properties":{}}"#,
210        },
211        // ── SHACL Constraints & Verification ────────────────────────────────
212        McpToolDescriptor {
213            name: "validate_shacl",
214            description: "Validate quins for target subject/property against SHACL constraints.",
215            input_schema: r#"{"type":"object","required":["quins","target_subject","target_property","constraints"],"properties":{"quins":{"type":"array"},"target_subject":{"type":"integer"},"target_property":{"type":"integer"},"constraints":{"type":"array"}}}"#,
216        },
217        McpToolDescriptor {
218            name: "validate_enumerated_identity",
219            description: "SHACL identity extension: validate identity as enumerated multi-attested state.",
220            input_schema: r#"{"type":"object","required":["bindings"],"properties":{"bindings":{"type":"array"},"min_distinct":{"type":"integer"},"min_attested":{"type":"integer"}}}"#,
221        },
222        McpToolDescriptor {
223            name: "shacl_credential_gate",
224            description: "Decide whether a verified W3C Verifiable Credential gates a SHACL target node.",
225            input_schema: r#"{"type":"object","required":["focus_node","gate","credential"],"properties":{"focus_node":{"type":"integer"},"gate":{"type":"object"},"credential":{"type":"object"}}}"#,
226        },
227        McpToolDescriptor {
228            name: "shacl_degrade_violations",
229            description: "SHACL identity extension: real-time severity degradation off-grid.",
230            input_schema: r#"{"type":"object","required":["violations"],"properties":{"violations":{"type":"array"},"mode":{"type":"string"}}}"#,
231        },
232        McpToolDescriptor {
233            name: "shacl_route",
234            description: "Decentralized shape-target routing between shapes and loci.",
235            input_schema: r#"{"type":"object","required":["routes"],"properties":{"routes":{"type":"array"},"query_locus":{"type":"integer"},"query_shape":{"type":"integer"}}}"#,
236        },
237        // ── QApps Host Runtime ──────────────────────────────────────────────
238        McpToolDescriptor {
239            name: "list_qapps",
240            description: "List installed qapps from storage Qapps directory.",
241            input_schema: r#"{"type":"object","properties":{}}"#,
242        },
243        McpToolDescriptor {
244            name: "get_qapp_manifest",
245            description: "Load qapp.json manifest for an installed or bundled qapp.",
246            input_schema: r#"{"type":"object","required":["qapp_name"],"properties":{"qapp_name":{"type":"string"}}}"#,
247        },
248        McpToolDescriptor {
249            name: "inspect_qapp_readiness",
250            description: "Check manifest, entrypoints, and ontology readiness for a qapp.",
251            input_schema: r#"{"type":"object","required":["qapp_name"],"properties":{"qapp_name":{"type":"string"}}}"#,
252        },
253        McpToolDescriptor {
254            name: "list_qapp_updates",
255            description: "Compare installed qapp versions against bundled update offers.",
256            input_schema: r#"{"type":"object","properties":{}}"#,
257        },
258        McpToolDescriptor {
259            name: "describe_qapp_surface_schema",
260            description: "Describe the current QApp host surface schema exposed by Qualia.",
261            input_schema: r#"{"type":"object","properties":{}}"#,
262        },
263        // ── Scientific & Engineering Compute ────────────────────────────────
264        McpToolDescriptor {
265            name: "matrix_operation",
266            description: "Linear algebra: multiply, transpose, solve, or inverse matrices.",
267            input_schema: r#"{"type":"object","required":["op"],"properties":{"op":{"type":"string","enum":["multiply","transpose","solve","inverse"]},"left":{"type":"object"},"right":{"type":"object"},"matrices":{"type":"array"},"result_id":{"type":"string"}}}"#,
268        },
269        McpToolDescriptor {
270            name: "algebra_solve_polynomial",
271            description: "Find all roots of a polynomial given descending coefficients.",
272            input_schema: r#"{"type":"object","required":["coeffs"],"properties":{"coeffs":{"type":"array","items":{"type":"number"}}}}"#,
273        },
274        McpToolDescriptor {
275            name: "algebra_matrix_analyze",
276            description: "Determinant, eigenvalues, symmetric eigensystem, or SVD of a matrix.",
277            input_schema: r#"{"type":"object","required":["op","rows","data"],"properties":{"op":{"type":"string","enum":["determinant","eigenvalues","eigen_symmetric","svd"]},"rows":{"type":"integer"},"cols":{"type":"integer"},"data":{"type":"array","items":{"type":"number"}}}}"#,
278        },
279        McpToolDescriptor {
280            name: "cas",
281            description: "Symbolic algebra: differentiate, simplify, expand, evaluate, solve quadratic, factor.",
282            input_schema: r#"{"type":"object","required":["op"],"properties":{"op":{"type":"string","enum":["differentiate","simplify","expand","evaluate","solve_quadratic","factor"]},"expr":{"type":"string"},"var":{"type":"string"},"env":{"type":"object"},"a":{"type":"number"},"b":{"type":"number"},"c":{"type":"number"}}}"#,
283        },
284        McpToolDescriptor {
285            name: "ode_solve",
286            description: "Run configurable CFD or molecular-dynamics simulation step.",
287            input_schema: r#"{"type":"object","properties":{"type":{"type":"string","enum":["cfd","distributed","molecular_dynamics"]},"nx":{"type":"integer"},"ny":{"type":"integer"},"dx":{"type":"number"},"time_step":{"type":"number"},"total_time":{"type":"number"}}}"#,
288        },
289        McpToolDescriptor {
290            name: "chemical_analysis",
291            description: "Predict molecular properties from SMILES or chemical formula.",
292            input_schema: r#"{"type":"object","properties":{"smiles":{"type":"string"},"formula":{"type":"string"},"molecular_weight":{"type":"number"},"prop":{"type":"string"}}}"#,
293        },
294        McpToolDescriptor {
295            name: "chemical_descriptors",
296            description: "Compute Lipinski and Veber descriptors from a SMILES string.",
297            input_schema: r#"{"type":"object","required":["smiles"],"properties":{"smiles":{"type":"string"}}}"#,
298        },
299        McpToolDescriptor {
300            name: "statistical_analysis",
301            description: "Descriptive statistics (mean, variance, correlation) on tabular data.",
302            input_schema: r#"{"type":"object","required":["rows"],"properties":{"stat":{"type":"string","enum":["mean","variance","correlation"]},"rows":{"type":"array"},"columns":{"type":"array","items":{"type":"string"}},"column":{"type":"string"},"column_y":{"type":"string"}}}"#,
303        },
304        McpToolDescriptor {
305            name: "financial_model",
306            description: "Black-Scholes option pricing or portfolio risk analysis.",
307            input_schema: r#"{"type":"object","properties":{"op":{"type":"string","enum":["option","risk"]},"underlying_price":{"type":"number"},"strike":{"type":"number"},"volatility":{"type":"number"},"assets":{"type":"array"},"cash_balance":{"type":"number"}}}"#,
308        },
309        McpToolDescriptor {
310            name: "medical_score",
311            description: "Clinical diagnostic and prognostic score analysis.",
312            input_schema: r#"{"type":"object","properties":{"patient_id":{"type":"string"},"score":{"type":"string","enum":["diagnosis","treatment","prognosis","prevention"]},"patient":{"type":"object"}}}"#,
313        },
314        McpToolDescriptor {
315            name: "clinical_risk",
316            description: "Clinical risk scores: framingham, cha2ds2_vasc, sofa, egfr.",
317            input_schema: r#"{"type":"object","properties":{"score":{"type":"string","enum":["framingham","cha2ds2","cha2ds2_vasc","sofa","egfr","renal"]},"age":{"type":"integer"},"input":{"type":"object"}}}"#,
318        },
319        McpToolDescriptor {
320            name: "engineering_analysis_op",
321            description: "Structural, thermal, or dynamic FEA analysis.",
322            input_schema: r#"{"type":"object","properties":{"analysis":{"type":"string","enum":["structural","thermal","dynamic"]},"model":{"type":"object"},"youngs_modulus":{"type":"number"}}}"#,
323        },
324        McpToolDescriptor {
325            name: "computational_geometry",
326            description: "2D convex hull, Delaunay, Voronoi, nearest site, 3D primitive mesh generation.",
327            input_schema: r#"{"type":"object","required":["op"],"properties":{"op":{"type":"string","enum":["orientation_2","convex_hull_2","triangle_topology","delaunay_2","voronoi_2","nearest_site","mesh_topology","create_box","create_sphere","create_cylinder","create_plane"]},"points":{"type":"array","items":{"type":"array","items":{"type":"number"}}},"vertex_count":{"type":"integer"},"triangles":{"type":"array","items":{"type":"array","items":{"type":"integer"}}},"width":{"type":"number"},"height":{"type":"number"},"depth":{"type":"number"},"radius":{"type":"number"},"size":{"type":"number"},"lat_segments":{"type":"integer"},"lon_segments":{"type":"integer"},"segments":{"type":"integer"},"query":{"type":"array","items":{"type":"number"}}},"additionalProperties":false}"#,
328        },
329        McpToolDescriptor {
330            name: "geometry_manifests",
331            description: "Per-op computational geometry capability manifests and resource budgets.",
332            input_schema: r#"{"type":"object","properties":{"op":{"type":"string"}}}"#,
333        },
334        McpToolDescriptor {
335            name: "geometric_algebra_op",
336            description: "3D vector cross product, dot product, or angle.",
337            input_schema: r#"{"type":"object","required":["a","b"],"properties":{"op":{"type":"string","enum":["cross","angle","dot"]},"a":{"type":"array","items":{"type":"number"}},"b":{"type":"array","items":{"type":"number"}}}}"#,
338        },
339        McpToolDescriptor {
340            name: "bioinformatics_align",
341            description: "Pairwise nucleotide or protein sequence alignment (Smith-Waterman).",
342            input_schema: r#"{"type":"object","required":["query","target"],"properties":{"query":{"type":"string"},"target":{"type":"string"},"mode":{"type":"string","enum":["dna","protein"]}}}"#,
343        },
344        McpToolDescriptor {
345            name: "conditioning_compile",
346            description: "Compile conditioning profile into execution contract and budget plan.",
347            input_schema: r#"{"type":"object","properties":{"profile":{"type":"object"}}}"#,
348        },
349        McpToolDescriptor {
350            name: "conditioning_validate",
351            description: "Validate conditioning profile specification against schema rules.",
352            input_schema: r#"{"type":"object","properties":{"profile":{"type":"object"}}}"#,
353        },
354        // ── Data Formats: Zero-Heap RDF, JSON, CSV ──────────────────────────
355        McpToolDescriptor {
356            name: "parse_rdf",
357            description: "Stream RDF formats (nt, turtle, nquads, trig, n3, jsonld, cbor) into quins.",
358            input_schema: r#"{"type":"object","required":["format"],"properties":{"format":{"type":"string"},"rdf_data":{"type":"string"},"file_path":{"type":"string"},"ingest_to_graph":{"type":"boolean"}}}"#,
359        },
360        McpToolDescriptor {
361            name: "parse_json",
362            description: "Stream JSON objects into Quins via zero-heap field mappings.",
363            input_schema: r#"{"type":"object","required":["field_mappings"],"properties":{"json_data":{"type":"string"},"file_path":{"type":"string"},"field_mappings":{"type":"array"}}}"#,
364        },
365        McpToolDescriptor {
366            name: "parse_csv",
367            description: "Stream CSV tabular data into Quins via zero-heap field mappings.",
368            input_schema: r#"{"type":"object","required":["field_mappings"],"properties":{"csv_data":{"type":"string"},"file_path":{"type":"string"},"field_mappings":{"type":"array"}}}"#,
369        },
370        McpToolDescriptor {
371            name: "serialize_rdf",
372            description: "Serialize quins or graph slice to RDF/RDF-Star formats.",
373            input_schema: r#"{"type":"object","properties":{"quins":{"type":"array"},"format":{"type":"string"},"output":{"type":"string","enum":["inline","file"]}}}"#,
374        },
375        McpToolDescriptor {
376            name: "serialize_json",
377            description: "Serialize quins to JSON array.",
378            input_schema: r#"{"type":"object","required":["field_names","predicate_hashes"],"properties":{"quins":{"type":"array"},"field_names":{"type":"array"},"predicate_hashes":{"type":"array"}}}"#,
379        },
380        McpToolDescriptor {
381            name: "serialize_csv",
382            description: "Serialize quins to CSV tabular output.",
383            input_schema: r#"{"type":"object","required":["headers","predicate_hashes"],"properties":{"quins":{"type":"array"},"headers":{"type":"array"},"predicate_hashes":{"type":"array"}}}"#,
384        },
385        // ── Cooperative Governance ──────────────────────────────────────────
386        McpToolDescriptor {
387            name: "values_check",
388            description: "Values abuse-check (human-rights dignity guard).",
389            input_schema: r#"{"type":"object","required":["agentType"],"properties":{"agentType":{"type":"string"},"claimsDignityRight":{"type":"boolean"}}}"#,
390        },
391        McpToolDescriptor {
392            name: "values_evaluate",
393            description: "Deontic-contract reasoner in values terms.",
394            input_schema: r#"{"type":"object","required":["modality","party","action"],"properties":{"modality":{"type":"string","enum":["forbid","oblige","permit"]},"party":{"type":"string"},"action":{"type":"string"}}}"#,
395        },
396        McpToolDescriptor {
397            name: "jural_correlate",
398            description: "Hohfeldian jural correlation and opposites for 8 positions.",
399            input_schema: r#"{"type":"object","required":["position"],"properties":{"position":{"type":"string","enum":["claim","duty","privilege","no-right","power","liability","immunity","disability"]}}}"#,
400        },
401        McpToolDescriptor {
402            name: "deontic_govern",
403            description: "Interaction governance runtime PolicyMode mapping.",
404            input_schema: r#"{"type":"object","required":["status"],"properties":{"status":{"type":"string"}}}"#,
405        },
406        McpToolDescriptor {
407            name: "mcp_cooperate",
408            description: "Track-M agent cooperation gate authorization check.",
409            input_schema: r#"{"type":"object","required":["caller","verified"],"properties":{"caller":{"type":"string"},"verified":{"type":"boolean"},"grounded":{"type":"boolean"}}}"#,
410        },
411        // ── Quantum Computing & Optimization ────────────────────────────────
412        McpToolDescriptor {
413            name: "qpu_optimize",
414            description: "Formulate a QUBO/circuit job from problem description and classical solve.",
415            input_schema: r#"{"type":"object","required":["problem"],"properties":{"problem":{"type":"object"}}}"#,
416        },
417        McpToolDescriptor {
418            name: "qpu_dft",
419            description: "Bounded Thomas-Fermi DFT ground-state energy evaluation.",
420            input_schema: r#"{"type":"object","properties":{"grid_resolution":{"type":"integer"},"quins":{"type":"array"}}}"#,
421        },
422        McpToolDescriptor {
423            name: "qpu_status",
424            description: "Return QPU bridge connection and job-queue status.",
425            input_schema: r#"{"type":"object","properties":{}}"#,
426        },
427        // ── Local LLM Intelligence ─────────────────────────────────────────
428        McpToolDescriptor {
429            name: "llm_infer",
430            description: "Run local GGUF autoregressive inference loop.",
431            input_schema: r#"{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string"},"model_path":{"type":"string"}}}"#,
432        },
433        McpToolDescriptor {
434            name: "llm_chat",
435            description: "Multi-turn chat completion via local GGUF inference stack.",
436            input_schema: r#"{"type":"object","required":["messages"],"properties":{"messages":{"type":"array"}}}"#,
437        },
438        McpToolDescriptor {
439            name: "list_models",
440            description: "Discover GGUF models under storage and resident mounted models.",
441            input_schema: r#"{"type":"object","properties":{}}"#,
442        },
443        // ── System Status & Tasks ───────────────────────────────────────────
444        McpToolDescriptor {
445            name: "get_system_status",
446            description: "Return runtime status for the Qualia MCP surface.",
447            input_schema: r#"{"type":"object","properties":{}}"#,
448        },
449        McpToolDescriptor {
450            name: "list_capabilities",
451            description: "List the canonical Qualia capability catalogue.",
452            input_schema: r#"{"type":"object","properties":{"domain":{"type":"string"}}}"#,
453        },
454        McpToolDescriptor {
455            name: "get_pending_tasks",
456            description: "Get tasks pending in the ambient orchestrator.",
457            input_schema: r#"{"type":"object","properties":{}}"#,
458        },
459        McpToolDescriptor {
460            name: "run_docs_tests",
461            description: "Run headless test suites (logic, wasm, native).",
462            input_schema: r#"{"type":"object","properties":{"mode":{"type":"string","enum":["logic","wasm","native","both"]}}}"#,
463        },
464    ]
465}
466
467/// Generates the JSON-RPC `tools/list` response object.
468pub fn tool_list_json() -> Value {
469    let tools = stable_mcp_tools();
470    let mut mapped = Vec::with_capacity(tools.len());
471
472    for tool in tools {
473        let schema: Value = serde_json::from_str(tool.input_schema).unwrap_or_else(|_| json!({"type": "object"}));
474        mapped.push(json!({
475            "name": tool.name,
476            "description": tool.description,
477            "inputSchema": schema,
478        }));
479    }
480
481    json!({
482        "tools": mapped
483    })
484}
485
486#[cfg(test)]
487mod contract_tests {
488    use super::*;
489    #[test]
490    fn mesh_topology_schema_advertises_the_arguments_consumed_by_dispatch() {
491        let schema: Value = serde_json::from_str(stable_mcp_tools().iter().find(|tool| tool.name == "computational_geometry").unwrap().input_schema).unwrap();
492        assert_eq!(schema["properties"]["vertex_count"]["type"], "integer");
493        assert_eq!(schema["properties"]["triangles"]["type"], "array");
494        let result = crate::tools::computational_geometry(br#"{"op":"mesh_topology","vertex_count":3,"triangles":[[0,1,2]]}"#).unwrap();
495        let result: Value = serde_json::from_str(&result).unwrap();
496        assert!(result.get("error").is_none());
497    }
498}