ڎj++dZddlmZddlZddlZddlZddlmZmZm Z ddl m Z m Z ddl mZmZmZmZdd lmZmZdd lmZerd d lmZddZGddeZdS)zThe glob tool in agentscope.) annotationsN) TYPE_CHECKINGAnyList) TextBlockToolResultState)PermissionBehaviorPermissionContextPermissionDecisionPermissionRule)ToolBaseToolMiddlewareBase) ToolChunk) BackendBasereturnstrc|ddlm}|dd}t |S)a,Resolve the on-disk path of the bundled ``_glob_helper.py`` script. Used by :class:`Glob` when no explicit ``glob_helper_path`` is provided (i.e. the local-workspace case). The path is obtained via :mod:`importlib.resources` so it works for both editable and installed packages. rNz!agentscope.tool._builtin._scriptsz_glob_helper.py)importlib.resources resourcesfilesjoinpathr)_resrefs LC:\Projects\DSCons\.venv\Lib\site-packages\agentscope\tool\_builtin\_glob.py_default_glob_helper_pathrsH'&&&&& **8 9 9 B B  C s88OceZdZUdZdZded< dZded< dddd dd d d d gd Zded<dZded<dZ ded<dZ ded<dZ ded<dZ ded< d.d/fd! Z d0d&Zd1d(Zd2d*Z d3d4d-ZxZS)5Globz-The glob tool for fast file pattern matching.rnameaFast file pattern matching tool that works with any codebase size. Supports glob patterns like "**/*.js" or "src/**/*.ts" and returns matching file paths sorted by modification time (newest first). Use this tool when you need to find files by pattern across the codebase. descriptionobjectstringzBThe glob pattern to match against (e.g., '**/*.py', 'src/**/*.ts'))typer#zIThe base directory to search from (defaults to current working directory))patternpathr')r& propertiesrequireddict[str, Any] input_schemaFboolis_mcpT is_read_onlyis_concurrency_safeis_external_toolis_state_injectedNbackendBackendBase | Noneglob_helper_path str | None middlewaresList[ToolMiddlewareBase] | NonerNonecddlm}t||p ||_t |j||_||n t |_dS)a7Initialize the glob tool. Args: middlewares (`List[ToolMiddlewareBase] | None`, optional): Tool middlewares wrapping the tool execution. backend (`BackendBase | None`, optional): The sandbox backend to use. When ``None``, a :class:`LocalBackend` is created automatically. glob_helper_path (`str | None`, optional): Filesystem path (inside the backend's environment) to the ``_glob_helper.py`` script. When ``None``, the path is resolved from the installed package resources (suitable for :class:`LocalBackend`). Remote backends (Docker, E2B) should pass the path where the script was deployed during workspace initialization. r) LocalBackend)r7N)_backendr;super__init__ isinstance _is_localr_glob_helper_path)selfr3r5r7r; __class__s rr>z Glob.__init__Qs, +***** [1111<<>> $DM<@@ +  *,, r tool_inputcontextr r c<KttjdS)zCheck permissions for glob pattern matching. Glob is a read-only tool. Return PASSTHROUGH to let the engine handle EXPLORE mode and rule matching. z#Glob pattern matching is read-only.)behaviormessage)r r PASSTHROUGH)rBrDrEs rcheck_permissionszGlob.check_permissionsus("'39    r rule_contentcK|dS|dd}|rtj||rdS|dd}|rtj||rdSdS)aCheck if a permission rule matches the glob pattern or path. Matches rule_content as a glob pattern against the "pattern" or "path" parameters. This allows rules to match either the search pattern itself or the directory being searched. If rule_content is None, matches all invocations (tool-name-level rule). Args: rule_content (`str | None`): Glob pattern to match (e.g., "src/**" to match searches in src), or None to match all invocations tool_input (`dict[str, Any]`): The tool input data containing "pattern" and optional "path" Returns: `bool`: True if the rule matches the pattern or path, False otherwise NTr(r'F)getfnmatch)rBrKrDr(r's r match_rulezGlob.match_rules0  4~~fb))  GOD,77 4..B//  ww == 4urList[PermissionRule]c K|jd{V}|dp|}|j||}|ddz}t |j|tjdgS)aGenerate suggested permission rules for the glob search. Suggests a rule based on the search path. If no path is provided, suggests a rule for the current directory. Args: tool_input (`dict[str, Any]`): The tool input data containing optional "path" key Returns: `List[PermissionRule]`: A single suggested rule covering the search directory Nr()cwdz/\z/** suggested) tool_namerKrGsource) r<getcwdrNabspathrstripr r"r ALLOW)rBrD backend_cwdr(abs_pathr's rgenerate_suggestionszGlob.generate_suggestionss"!M0022222222 ~~f%%4 =((;(??//%((50 )$+1"      rr(rcK|r|n|jd{V}|j|d{Vs.tt d|gt jdS|jr tj nd}||j d|d|g}|j |d d{V}| s`|j d d }tt |rd|ndgt jdS t!j|jd d }n#t jt(f$rg}YnwxYwt+|dkr.tt d|gt jdStt d|gt jdS)aExecute the glob pattern matching and return the results. Invokes the standalone ``_glob_helper.py`` script via ``exec_shell``. The script performs high-performance ``os.walk`` + ``os.scandir`` matching and returns results sorted by modification time (newest first) as JSON. This unified path works identically across Local, Docker, and E2B backends. Args: pattern (`str`): The glob pattern to match against (e.g. ``**/*.py``). path (`str | None`, optional): Base directory to search from. Defaults to the current working directory when ``None``. Returns: `ToolChunk`: On success, the matched file paths joined by newlines (or a "no files found" message). If the base directory is missing or the helper fails, an error chunk with ``ToolResultState.ERROR``. NzDirectory not found: )textT)contentstateis_lastpython3z --patternz --base-dirg>@)timeoutzutf-8replace)errorszGlob helper failed: z(Glob helper failed with no error output.rz!No files found matching pattern:  )r<rWis_dirrrr ERRORr@sys executablerA exec_shellokstderrdecodestripjsonloadsstdoutJSONDecodeError ValueErrorlenRUNNINGjoin) rBr'r(base_dirpythoncommandresultrnmatchess rcallz Glob.calls}: A444=+?+?+A+A%A%A%A%A%A%A ]))(33333333 #E8#E#EFFF&+  $(>@y   "      }///FFFFFFFF yy{{ ]))'))DDJJLLF!HrJrPr]r~ __classcell__)rCs@rr!r!*s77D/ K    2! 3 ! :   K$$L"FL $$$$$"""""#####'+'+7; " " " " " " " H     %%%%N! ! ! ! L c c c c c c c c c rr!)rr)r __future__rrOrqrjtypingrrrrHrr permissionr r r r _baserr _responserr<rrr!rrrsB"""""""" ++++++++++11111111 10000000!!!!!!&%%%%%%"G G G G G 8G G G G G r