feat: Add prompt support (#351)
* feat: add prompt support with typed argument handling - Implement #[prompt], #[prompt_router], and #[prompt_handler] macros - Add automatic JSON schema generation from Rust types for arguments - Support flexible async handler signatures with automatic adaptation - Create PromptRouter for efficient prompt dispatch - Include comprehensive tests and example implementation This enables MCP servers to provide reusable prompt templates that LLMs can discover and invoke with strongly-typed parameters, similar to the existing tool system but optimized for prompt use cases. 🤖 Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com> * refactor: unify parameter handling between tools and prompts - Replace Arguments<T> with Parameters<T> for consistent API - Create shared common module for tool/prompt utilities - Modernize async handling with futures::future::BoxFuture - Move cached_schema_for_type to common module for reuse - Update error types from rmcp::Error to rmcp::ErrorData - Add comprehensive trait implementations for parameter extraction 🤖 Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com> * refactor: extract Parameters wrapper to shared module and unify trait usage - Move Parameters type from common.rs to dedicated wrapper/parameters.rs module - Unify extractor traits by using FromContextPart for both tools and prompts - Remove duplicate FromToolCallContextPart and FromPromptContextPart traits - Add structured output support to Json wrapper with IntoCallToolResult impl - Improve error messages with more descriptive panic for schema serialization - Update all imports across codebase to use new module path - Clean up trailing whitespace and formatting inconsistencies This consolidates parameter extraction logic and reduces code duplication between tool and prompt handlers while maintaining backward compatibility. * chore: remove committed .egg-info directory and update gitignore * docs: fix documentation formatting
This commit is contained in:
parent
c0452f93a4
commit
9349f5cb26
1 changed files with 3191 additions and 464 deletions
111
crates/rmcp-macros/src/prompt_router.rs
Normal file
111
crates/rmcp-macros/src/prompt_router.rs
Normal file
|
|
@ -0,0 +1,111 @@
|
|||
use darling::FromMeta;
|
||||
use proc_macro2::TokenStream;
|
||||
use quote::{format_ident, quote};
|
||||
use syn::{ImplItem, ItemImpl, Visibility, parse_quote};
|
||||
|
||||
#[derive(FromMeta, Debug, Default)]
|
||||
#[darling(default)]
|
||||
pub struct PromptRouterAttribute {
|
||||
pub router: Option<String>,
|
||||
pub vis: Option<Visibility>,
|
||||
}
|
||||
|
||||
pub fn prompt_router(attr: TokenStream, input: TokenStream) -> syn::Result<TokenStream> {
|
||||
let attribute = if attr.is_empty() {
|
||||
Default::default()
|
||||
} else {
|
||||
let attr_args = darling::ast::NestedMeta::parse_meta_list(attr)?;
|
||||
PromptRouterAttribute::from_list(&attr_args)?
|
||||
};
|
||||
|
||||
let mut impl_block = syn::parse2::<ItemImpl>(input)?;
|
||||
let self_ty = &impl_block.self_ty;
|
||||
|
||||
let router_fn_ident = attribute
|
||||
.router
|
||||
.map(|s| format_ident!("{}", s))
|
||||
.unwrap_or_else(|| format_ident!("prompt_router"));
|
||||
let vis = attribute.vis.unwrap_or(Visibility::Inherited);
|
||||
|
||||
let mut prompt_route_fn_calls = Vec::new();
|
||||
|
||||
for item in &mut impl_block.items {
|
||||
if let ImplItem::Fn(fn_item) = item {
|
||||
let has_prompt_attr = fn_item.attrs.iter().any(|attr| {
|
||||
attr.path()
|
||||
.segments
|
||||
.last()
|
||||
.map(|seg| seg.ident == "prompt")
|
||||
.unwrap_or(false)
|
||||
});
|
||||
|
||||
if has_prompt_attr {
|
||||
let fn_ident = &fn_item.sig.ident;
|
||||
let attr_fn_ident = format_ident!("{}_prompt_attr", fn_ident);
|
||||
|
||||
// Check what parameters the function takes
|
||||
let mut param_names = Vec::new();
|
||||
let mut param_types = Vec::new();
|
||||
|
||||
for input in &fn_item.sig.inputs {
|
||||
if let syn::FnArg::Typed(pat_type) = input {
|
||||
// Extract parameter pattern and type
|
||||
param_types.push(&*pat_type.ty);
|
||||
param_names.push(&*pat_type.pat);
|
||||
}
|
||||
}
|
||||
|
||||
// Use the exact same pattern as tool_router
|
||||
prompt_route_fn_calls.push(quote! {
|
||||
.with_route((Self::#attr_fn_ident(), Self::#fn_ident))
|
||||
});
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
let router_fn: ImplItem = parse_quote! {
|
||||
#vis fn #router_fn_ident() -> rmcp::handler::server::router::prompt::PromptRouter<#self_ty> {
|
||||
rmcp::handler::server::router::prompt::PromptRouter::new()
|
||||
#(#prompt_route_fn_calls)*
|
||||
}
|
||||
};
|
||||
|
||||
impl_block.items.push(router_fn);
|
||||
|
||||
Ok(quote! {
|
||||
#impl_block
|
||||
})
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod test {
|
||||
use super::*;
|
||||
|
||||
#[test]
|
||||
fn test_prompt_router_macro() -> syn::Result<()> {
|
||||
let input = quote! {
|
||||
impl MyPromptHandler {
|
||||
#[prompt]
|
||||
async fn greeting_prompt(&self) -> Result<Vec<PromptMessage>, Error> {
|
||||
Ok(vec![])
|
||||
}
|
||||
|
||||
#[prompt]
|
||||
async fn code_review_prompt(&self, Parameters(args): Parameters<CodeReviewArgs>) -> Result<Vec<PromptMessage>, Error> {
|
||||
Ok(vec![])
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
let result = prompt_router(TokenStream::new(), input)?;
|
||||
let result_str = result.to_string();
|
||||
|
||||
// Check that the prompt_router function was generated
|
||||
assert!(result_str.contains("fn prompt_router"));
|
||||
assert!(result_str.contains("PromptRouter :: new"));
|
||||
assert!(result_str.contains("greeting_prompt_prompt_attr"));
|
||||
assert!(result_str.contains("code_review_prompt_prompt_attr"));
|
||||
|
||||
Ok(())
|
||||
}
|
||||
}
|
||||
Loading…
Reference in a new issue