i1SrSSKJr SSKrSSKrSSKrSSKrSSKJr SSK J r J r SSK J r SSK Jr SSKJr SS KJr SS jrSS jrSS jr"S S\5rS/rg)zFile search middleware for Anthropic text editor and memory tools. This module provides Glob and Grep search tools that operate on files stored in state or filesystem. ) annotationsN)suppress)datetimetimezone)Path)Literal)tool)AgentMiddlewarecl^^SU;aSU;ag/mSUU4SjjmT"U5 T$![a gf=f)z?Expand brace patterns like ``*.{py,pyi}`` into a list of globs.}{Nc>URS5nUS:XaTRU5 gURSU5nUS:Xa[eUSUnXS-SnXS-UnU(d[eURS5HnT"X6-U-5 M g)Nr r ,)findappend ValueErrorsplit) currentstartendprefixsuffixinneroption_expandexpandeds a/home/james-whalen/.local/lib/python3.13/site-packages/langchain/agents/middleware/file_search.pyr)_expand_include_patterns.._expands S! B; OOG $ ll3& "9 %q# C( kk#&F FOf, -')rstrreturnNone)r)patternrrs @@r_expand_include_patternsr&sK g~#W,H..& O s & 33c^T(dg[U4SjS55(ag[T5nUcgUH-n[R"[R "U55 M/ g![R a gf=f)z/Validate glob pattern used for include filters.Fc3,># UH oT;v M g7fN).0charr%s r ,_is_valid_include_pattern..>s <';t7?';s)  T)anyr&recompilefnmatch translateerror)r%r candidates` r_is_valid_include_patternr99st  <'; <<<'0H!I JJw((3 4"  88s3A))B?BcT^[U5nU(dg[U4SjU55$)z8Return True if the basename matches the include pattern.Fc3R># UHn[R"TU5v M g7fr))r5)r+r8basenames rr-)_match_include_pattern..TsNX wx33Xs$')r&r2)r<r%rs` r_match_include_patternr>Ns$'0H  NXN NNr!c\rSrSrSrSSS.S SjjrSSjrSSjrSS jrSS jr S r g )FilesystemFileSearchMiddlewareWa>Provides Glob and Grep search over filesystem files. This middleware adds two tools that search through local filesystem: - Glob: Fast file pattern matching by file path - Grep: Fast content search using ripgrep or Python fallback Example: ```python from langchain.agents import create_agent from langchain.agents.middleware import ( FilesystemFileSearchMiddleware, ) agent = create_agent( model=model, tools=[], middleware=[ FilesystemFileSearchMiddleware(root_path="/workspace"), ], ) ``` T ) use_ripgrepmax_file_size_mbc^[U5R5TlUTlUS-S-Tl[ SSU4Sjjj5n[ SSU4Sjjj5nUTlUTlXE/Tlg) aInitialize the search middleware. Args: root_path: Root directory to search. use_ripgrep: Whether to use ripgrep for search (default: True). Falls back to Python if ripgrep unavailable. max_file_size_mb: Maximum file size to search in MB (default: 10). icr>T RU5nUR5(aUR5(dg/nUR U5HnUR 5(dMS[ URT R55-nUR5n[R"UR[RS9R5nUR!XW45 M U(dgUVV s/sHupUPM n nn SR#U 5$![a gf=fs sn nf)aFast file pattern matching tool that works with any codebase size. Supports glob patterns like **/*.js or src/**/*.ts. Returns matching file paths sorted by modification time. Use this tool when you need to find files by name patterns. Args: pattern: The glob pattern to match files against. path: The directory to search in. If not specified, searches from root. Returns: Newline-separated list of matching file paths, sorted by modification time (most recently modified first). Returns "No files found" if no matches. zNo files found/)tzr0)_validate_and_resolve_pathrexistsis_dirglobis_filer" relative_to root_pathstatr fromtimestampst_mtimerutc isoformatrjoin) r%path base_fullmatchingmatch virtual_pathrP modified_atp_ file_pathsselfs r glob_search.glob_searchs" ( ;;DA ##%%Y-=-=-?-?'/1H"0==??#&U->->t~~-N)O#OL ::[R"U5 U(a[U5(dgSnTR(aH[ [ [R[R5 TRXU5nSSS5 UcTRXU5nU(dgTRXS5$![RanSU3sSnA$SnAff=f!,(df  Nb=f)aFast content search tool that works with any codebase size. Searches file contents using regular expressions. Supports full regex syntax and filters files by pattern with the include parameter. Args: pattern: The regular expression pattern to search for in file contents. path: The directory to search in. If not specified, searches from root. include: File pattern to filter (e.g., "*.js", "*.{ts,tsx}"). output_mode: Output format: - "files_with_matches": Only file paths containing matches (default) - "content": Matching lines with file:line:content format - "count": Count of matches per file Returns: Search results formatted according to output_mode. Returns "No matches found" if no results. zInvalid regex pattern: NzInvalid include patternzNo matches found) r3r4r7r9rCrFileNotFoundError subprocessCalledProcessErrorTimeoutExpired_ripgrep_search_python_search_format_grep_results)r%rVinclude output_modeeresultsr_s r grep_search.grep_searchs4 5 7#8AA0G%11-- #227'JG --gWE),,WB B188 5044 5s)B:1C :CCCC C.)rG)r%r"rVr"r#r")rGNfiles_with_matches) r%r"rVr"rj str | Nonerkz1Literal['files_with_matches', 'content', 'count']r#r") rresolverOrCmax_file_size_bytesr r`rntools)r_rOrCrDr`rns` r__init__'FilesystemFileSearchMiddleware.__init__osi002&#3d#:T#A  & )& ) & )P "&Ma 3 C3 C3 C 3 CK 3 C  3 C 3 Cj'&!/ r!c@URS5(dSU-nSU;dSU;a Sn[U5eURS5nURU- R 5nUR UR5 U$![a SU3n[U5Sef=f)z7Validate and resolve a virtual path to filesystem path.rGz..~zPath traversal not allowedzPath outside root directory: N) startswithrlstriprOrrrN)r_rVmsgrelative full_paths rrI9FilesystemFileSearchMiddleware._validate_and_resolve_pathss##:D 4<3$;.CS/ !;;s#^^h.779  ,  ! !$.. 1   ,1$8CS/t + ,s $BBcJURU5nUR5(d0$SS/nU(aURSU/5 URSU[ U5/5 [ R "USSSSS9n0nURR5Hn[R"U5n U S S :Xa|U S S S n S[ [U 5RUR 55-n U S Sn U S SS R#S5n X;a/X{'X{R%X45 MM U$![a 0s$f=f![ R[4a URXU5s$f=f![R&[(4a GMf=f)z Search using ripgrep subprocess.rgz--jsonz--globz--TF)capture_outputtexttimeoutchecktyperYdatarVrrG line_numberlinesr0)rIrrJextendr"rdrunrfrcrhstdout splitlinesjsonloadsrrNrOrstriprJSONDecodeErrorKeyError)r_r% base_pathrjrWcmdresultrmlinerrVrZline_num line_texts rrg.FilesystemFileSearchMiddleware._ripgrep_searchs 77 BI!!IX  JJ'* + D'3y>23 D^^# F57MM,,.D zz$'<7*</7D#&T$Z-C-CDNN-S)T#TL#F|M:H $V W 5f = D DT JI#202-)00(1FG+/ [ I .))+<= D&&w7C C D&(((3  s6D?&EBF? E E,F?FF"!F"cURU5nUR5(d0$[R"U5n0nUR S5HnUR 5(dMU(a[URU5(dM>UR5RUR:aMhUR5n[UR!5S5HaupUR#U 5(dMS[%UR'UR(55-n X;a/Xk'XkR+X45 Mc M U$![a 0s$f=f![[4a GM$f=f)z%Search using Python regex (fallback).*rrG)rIrrJr3r4rglobrMr>namerPst_sizers read_textUnicodeDecodeErrorPermissionError enumeratersearchr"rNrOr) r_r%rrjrWregexrm file_pathcontentrrrZs rrh-FilesystemFileSearchMiddleware._python_search3sW 77 BI!!I 7#46#-I$$&&5inngNN~~''$*B*BB #--/ #,G,>,>,@!"D<<%%#&Y-B-B4>>-R)S#SL#202-)00(1AB #E%.2G I 0'8  s#E<E# E E #E87E8c $US:Xa(SR[UR555$US:XaY/n[UR55H)nXHupVURUSUSU35 M M+ SRU5$US:XaV/n[UR55H&n[ X5nURUSU35 M( SRU5$SR[UR555$)z)Format grep results based on output mode.rpr0r:count)rUsortedkeysrlen)r_rmrkrrrrrs rri3FilesystemFileSearchMiddleware._format_grep_results^s . .99VGLLN34 4 ) #E#GLLN3 &-&8NHLLI;az4&!AB'9499U# # ' !E#GLLN3 G./ {!E734499U# #yy /00r!)r`rnrsrOrtrCN)rOr"rCboolrDintr#r$)rVr"r#r)r%r"rr"rjrqr# dict[str, list[tuple[int, str]]])rmrrkr"r#r") __name__ __module__ __qualname____firstlineno____doc__rurIrgrhri__static_attributes__r*r!rr@r@Ws6! " u0u0 u0  u0  u0n033'*35?3 )3j))'*)5?) ))V1111 1r!r@)r%r"r#zlist[str] | None)r%r"r#r)r<r"r%r"r#r)r __future__rr5rr3rd contextlibrrrpathlibrtypingrlangchain_core.toolsr !langchain.agents.middleware.typesr r&r9r>r@__all__r*r!rrsY # '%=D*Ob1_b1L % r!