pub struct SearchFilesInput {
pub query: String,
pub limit: Option<u32>,
pub current_file: Option<String>,
pub changed_with: Option<String>,
pub resolve: Option<bool>,
pub estimate: Option<bool>,
pub max_tokens: Option<u64>,
pub debug_ranking: Option<bool>,
pub rank_by: Option<String>,
pub anchor_path: Option<String>,
pub include_vendor: Option<bool>,
pub include_personal_tooling: Option<bool>,
}Expand description
Input for search_files.
Fields§
§query: StringFilename, folder name, or partial path. Required for search and resolve modes. Optional when changed_with is provided.
limit: Option<u32>Optional maximum number of matches to return (default 20, capped at 50).
current_file: Option<String>Optional current file path to boost local results.
changed_with: Option<String>Deprecated since v7.x: prefer rank_by="path+cochange" with
anchor_path=<path>. This compatibility path still finds files that
frequently co-change with this file via git temporal coupling, but is
scheduled for removal in v8.x.
resolve: Option<bool>Set to true for exact path resolution mode: resolves an ambiguous filename or partial path to one exact project path.
estimate: Option<bool>When true, return an approximate token cost estimate instead of actual content.
max_tokens: Option<u64>Optional maximum token budget for the response.
debug_ranking: Option<bool>When true, append a compact ranking explanation unless ranking diagnostics are disabled by policy.
Missing values default off; SYMFORGE_DEBUG_RANKING=1 may still default diagnostics on operationally.
rank_by: Option<String>Optional ranking mode. "frecency" requests call-time frecency
resolution: available session or persistent history is fused with
path ranking, otherwise the response includes explicit fallback,
unavailable, or disabled-by-policy evidence.
"path+cochange" fuses path match with the coupling store when
anchor_path is set and ready coupling data exists; otherwise the
response reports call-time preparation, fallback, unavailable, stale,
or disabled-by-policy evidence.
Any other value (including None) preserves the default
tier-based ordering exactly.
The separate changed_with= branch is preserved for compatibility.
anchor_path: Option<String>Anchor file used as the co-change pivot when rank_by="path+cochange".
include_vendor: Option<bool>When true, include vendored/third-party paths (vendor/, node_modules/, third_party/). Default false – vendor noise dominates path lookup in repos with embedded grammars.
include_personal_tooling: Option<bool>When true, include personal tooling paths (.claude/gsd-*). Default false – personal sidecars rarely answer codebase path questions.
Trait Implementations§
Source§impl<'de> Deserialize<'de> for SearchFilesInput
impl<'de> Deserialize<'de> for SearchFilesInput
Source§fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
Source§impl JsonSchema for SearchFilesInput
impl JsonSchema for SearchFilesInput
Source§fn schema_id() -> Cow<'static, str>
fn schema_id() -> Cow<'static, str>
Source§fn json_schema(generator: &mut SchemaGenerator) -> Schema
fn json_schema(generator: &mut SchemaGenerator) -> Schema
Source§fn inline_schema() -> bool
fn inline_schema() -> bool
$ref keyword. Read moreAuto Trait Implementations§
impl Freeze for SearchFilesInput
impl RefUnwindSafe for SearchFilesInput
impl Send for SearchFilesInput
impl Sync for SearchFilesInput
impl Unpin for SearchFilesInput
impl UnsafeUnpin for SearchFilesInput
impl UnwindSafe for SearchFilesInput
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<T> DeserializeOwned for Twhere
T: for<'de> Deserialize<'de>,
impl<A, B, T> HttpServerConnExec<A, B> for Twhere
B: Body,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more