Struct PathfinderServer 

pub struct PathfinderServer { /* private fields */ }

The main Pathfinder MCP server.

Holds shared workspace state and dispatches MCP tool calls.

Implementations

impl PathfinderServer

pub async fn new( workspace_root: WorkspaceRoot, config: PathfinderConfig, ) -> Self

Create a new Pathfinder server backed by the real Ripgrep scout, Tree-sitter surgeon, and LspClient for LSP operations.

Zero-Config language detection (PRD §6.5) runs synchronously during construction. LSP processes are started lazily — only when the first LSP-dependent tool call is made for a given language.

If Zero-Config detection fails (e.g., unreadable workspace directory), the server falls back to NoOpLawyer and logs a warning. All tools remain functional in degraded mode.

pub fn with_engines( workspace_root: WorkspaceRoot, config: PathfinderConfig, sandbox: Sandbox, scout: Arc<dyn Scout>, surgeon: Arc<dyn Surgeon>, ) -> Self

Create a server with injected Scout and Surgeon engines (for testing).

Uses a NoOpLawyer for LSP operations — keeps existing tests unchanged.

pub fn with_all_engines( workspace_root: WorkspaceRoot, _config: PathfinderConfig, sandbox: Sandbox, scout: Arc<dyn Scout>, surgeon: Arc<dyn Surgeon>, lawyer: Arc<dyn Lawyer>, ) -> Self

Create a server with all three engines injected (for testing with a MockLawyer).

impl PathfinderServer

pub fn search_codebase_tool_attr() -> Tool

Generated tool metadata function for search_codebase

pub fn get_repo_map_tool_attr() -> Tool

Generated tool metadata function for get_repo_map

pub fn read_symbol_scope_tool_attr() -> Tool

Generated tool metadata function for read_symbol_scope

pub fn read_source_file_tool_attr() -> Tool

Generated tool metadata function for read_source_file

pub fn replace_batch_tool_attr() -> Tool

Generated tool metadata function for replace_batch

pub fn read_with_deep_context_tool_attr() -> Tool

Generated tool metadata function for read_with_deep_context

pub fn get_definition_tool_attr() -> Tool

Generated tool metadata function for get_definition

pub fn analyze_impact_tool_attr() -> Tool

Generated tool metadata function for analyze_impact

pub fn lsp_health_tool_attr() -> Tool

Generated tool metadata function for lsp_health

pub fn replace_body_tool_attr() -> Tool

Generated tool metadata function for replace_body

pub fn replace_full_tool_attr() -> Tool

Generated tool metadata function for replace_full

pub fn insert_before_tool_attr() -> Tool

Generated tool metadata function for insert_before

pub fn insert_after_tool_attr() -> Tool

Generated tool metadata function for insert_after

pub fn insert_into_tool_attr() -> Tool

Generated tool metadata function for insert_into

pub fn delete_symbol_tool_attr() -> Tool

Generated tool metadata function for delete_symbol

pub fn validate_only_tool_attr() -> Tool

Generated tool metadata function for validate_only

pub fn create_file_tool_attr() -> Tool

Generated tool metadata function for create_file

pub fn delete_file_tool_attr() -> Tool

Generated tool metadata function for delete_file

pub fn read_file_tool_attr() -> Tool

Generated tool metadata function for read_file

pub fn write_file_tool_attr() -> Tool

Generated tool metadata function for write_file

Trait Implementations

impl Clone for PathfinderServer

fn clone(&self) -> PathfinderServer

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl ServerHandler for PathfinderServer

fn get_info(&self) -> ServerInfo

async fn call_tool( &self, request: CallToolRequestParams, context: RequestContext<RoleServer>, ) -> Result<CallToolResult, ErrorData>

async fn list_tools( &self, _request: Option<PaginatedRequestParams>, _context: RequestContext<RoleServer>, ) -> Result<ListToolsResult, ErrorData>

fn get_tool(&self, name: &str) -> Option<Tool>

Get a tool definition by name.

fn enqueue_task( &self, _request: CallToolRequestParams, _context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<CreateTaskResult, ErrorData>> + Send

fn ping( &self, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + Send

fn initialize( &self, request: InitializeRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<InitializeResult, ErrorData>> + Send

fn complete( &self, request: CompleteRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<CompleteResult, ErrorData>> + Send

fn set_level( &self, request: SetLevelRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + Send

fn get_prompt( &self, request: GetPromptRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<GetPromptResult, ErrorData>> + Send

fn list_prompts( &self, request: Option<PaginatedRequestParams>, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<ListPromptsResult, ErrorData>> + Send

fn list_resources( &self, request: Option<PaginatedRequestParams>, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<ListResourcesResult, ErrorData>> + Send

fn list_resource_templates( &self, request: Option<PaginatedRequestParams>, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<ListResourceTemplatesResult, ErrorData>> + Send

fn read_resource( &self, request: ReadResourceRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<ReadResourceResult, ErrorData>> + Send

fn subscribe( &self, request: SubscribeRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + Send

fn unsubscribe( &self, request: UnsubscribeRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + Send

fn on_custom_request( &self, request: CustomRequest, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<CustomResult, ErrorData>> + Send

fn on_cancelled( &self, notification: CancelledNotificationParam, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + Send

fn on_progress( &self, notification: ProgressNotificationParam, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + Send

fn on_initialized( &self, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + Send

fn on_roots_list_changed( &self, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + Send

fn on_custom_notification( &self, notification: CustomNotification, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + Send

fn list_tasks( &self, request: Option<PaginatedRequestParams>, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<ListTasksResult, ErrorData>> + Send

fn get_task_info( &self, request: GetTaskInfoParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<GetTaskResult, ErrorData>> + Send

fn get_task_result( &self, request: GetTaskResultParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<GetTaskPayloadResult, ErrorData>> + Send

fn cancel_task( &self, request: CancelTaskParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<CancelTaskResult, ErrorData>> + Send