deepy-cli 0.2.12__tar.gz → 0.2.13__tar.gz

{deepy_cli-0.2.12 → deepy_cli-0.2.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: deepy-cli
-Version: 0.2.12
+Version: 0.2.13
 Summary: Deepy - Vibe coding for DeepSeek models in your terminal
 Keywords: deepseek,coding-agent,terminal,cli,agents
 Author: kirineko
@@ -15,8 +15,10 @@ Classifier: Topic :: Terminals
 Requires-Dist: openai-agents>=0.17.0
 Requires-Dist: openai>=2.26,<3
 Requires-Dist: orjson>=3.10,<4
+Requires-Dist: pathspec>=1.1.1
 Requires-Dist: pydantic>=2.12,<3
 Requires-Dist: prompt-toolkit>=3.0,<4
+Requires-Dist: regex>=2026.5.9
 Requires-Dist: pyyaml>=6.0,<7
 Requires-Dist: rich>=14.2,<15
 Requires-Dist: textual>=8.2,<9

{deepy_cli-0.2.12 → deepy_cli-0.2.13}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "deepy-cli"
-version = "0.2.12"
+version = "0.2.13"
 description = "Deepy - Vibe coding for DeepSeek models in your terminal"
 readme = "README.md"
 authors = [
@@ -21,8 +21,10 @@ dependencies = [
     "openai-agents>=0.17.0",
     "openai>=2.26,<3",
     "orjson>=3.10,<4",
+    "pathspec>=1.1.1",
     "pydantic>=2.12,<3",
     "prompt-toolkit>=3.0,<4",
+    "regex>=2026.5.9",
     "pyyaml>=6.0,<7",
     "rich>=14.2,<15",
     "textual>=8.2,<9",

{deepy_cli-0.2.12 → deepy_cli-0.2.13}/src/deepy/__init__.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-__version__ = "0.2.12"
+__version__ = "0.2.13"
 
 
 def main() -> None:

deepy_cli-0.2.13/src/deepy/data/tools/Search.md

@@ -0,0 +1,20 @@
+## Search
+
+Search local project files without shell `grep`, `find`, or `rg`.
+
+Args: `query`, `path`, `glob`, `mode`, `output_mode`, `case_sensitive`,
+`context`, `limit`, `offset`, `include_ignored`.
+
+Use `Search` for repository code/text search before falling back to `shell`.
+It is built into Deepy and does not require ripgrep or platform-specific shell
+commands. It is read-only.
+
+Defaults and guidance:
+- Use `mode: "literal"` unless the user clearly needs a regex.
+- Use `output_mode: "files"` for broad discovery, then `read_file` specific
+  files or rerun with `output_mode: "content"`.
+- Use `output_mode: "count"` to understand match distribution.
+- Use `glob` or a narrower `path` to keep results focused.
+- Use `limit` and `offset` to page through large result sets.
+- Leave `include_ignored` false unless ignored build artifacts or dependencies
+  are explicitly relevant. Sensitive files are still filtered.

{deepy_cli-0.2.12 → deepy_cli-0.2.13}/src/deepy/prompts/system.py

@@ -45,6 +45,7 @@ def build_system_prompt(
 Core rules:
 - Work in the repo with tools: inspect, edit, test, verify.
 - Preserve user changes. Prefer small, verifiable edits.
+- Use `Search` for local project code/text search instead of shell `grep`, `find`, or `rg`; narrow with `path`, `glob`, `output_mode`, `limit`, and `offset`.
 - Read existing files when you need context; exact `edit_text` edits can establish the managed snapshot internally.
 - Use `edit_text` for one small single-file exact edit. Use structured `apply_patch.operations` when a change has multiple edits in one file, touches multiple files, creates/deletes/moves files, or replaces a larger block. Use `write_file` for new files or explicit whole-file replacement.
 - After project generators create scaffold files, read and edit the generated block instead of replacing the file.

{deepy_cli-0.2.12 → deepy_cli-0.2.13}/src/deepy/prompts/tool_docs.py

@@ -5,6 +5,7 @@ from importlib import resources
 
 TOOL_DOC_FILES = (
     "shell.md",
+    "Search.md",
     "read_file.md",
     "edit_text.md",
     "write_file.md",

{deepy_cli-0.2.12 → deepy_cli-0.2.13}/src/deepy/tools/agents.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import asyncio
 from typing import TYPE_CHECKING, Any
 
 from deepy.utils import json as json_utils
@@ -26,6 +27,22 @@ def build_function_tools(
         questions = args.get("questions")
         return runtime.ask_user_question(questions if isinstance(questions, list) else [])
 
+    async def invoke_search(_context: object, raw_input: str) -> str:
+        args = _tool_args(raw_input)
+        return await asyncio.to_thread(
+            runtime.search,
+            _string_arg(args, "query"),
+            path=_string_arg(args, "path") or ".",
+            glob=_optional_string_arg(args, "glob"),
+            mode=_string_arg(args, "mode") or "literal",
+            output_mode=_string_arg(args, "output_mode") or "content",
+            case_sensitive=_bool_arg(args, "case_sensitive", True),
+            context=_int_arg(args, "context", 0),
+            limit=_int_arg(args, "limit", 100),
+            offset=_int_arg(args, "offset", 0),
+            include_ignored=_bool_arg(args, "include_ignored", False),
+        )
+
     async def invoke_read_file(_context: object, raw_input: str) -> str:
         args = _tool_args(raw_input)
         return runtime.read_file(
@@ -114,6 +131,17 @@ def build_function_tools(
             on_invoke_tool=invoke_ask_user_question,
             strict_json_schema=False,
         ),
+        FunctionTool(
+            name="Search",
+            description=(
+                "Search local project files without shell grep or rg. Prefer this for repository "
+                "code/text search. Defaults to literal content search; use regex mode only when "
+                "a regular expression is intentional."
+            ),
+            params_json_schema=SEARCH_SCHEMA,
+            on_invoke_tool=invoke_search,
+            strict_json_schema=True,
+        ),
         FunctionTool(
             name="read_file",
             description=(
@@ -303,6 +331,67 @@ ASK_USER_QUESTION_SCHEMA: dict[str, Any] = {
     "additionalProperties": False,
 }
 
+SEARCH_SCHEMA: dict[str, Any] = {
+    "type": "object",
+    "properties": {
+        "query": {
+            "type": "string",
+            "description": "Literal string or regex pattern to search for in local project files.",
+        },
+        "path": {
+            "type": "string",
+            "description": "Project-relative file or directory path to search. Use '.' for the project.",
+        },
+        "glob": {
+            "type": ["string", "null"],
+            "description": "Optional glob filter against project-relative paths, such as '*.py'.",
+        },
+        "mode": {
+            "type": "string",
+            "enum": ["literal", "regex"],
+            "description": "Search mode. Use literal by default; use regex only intentionally.",
+        },
+        "output_mode": {
+            "type": "string",
+            "enum": ["content", "files", "count"],
+            "description": "Return matching lines, matching file paths, or per-file counts.",
+        },
+        "case_sensitive": {
+            "type": "boolean",
+            "description": "Whether matching is case-sensitive.",
+        },
+        "context": {
+            "type": "integer",
+            "description": "Number of context lines before and after content matches.",
+        },
+        "limit": {
+            "type": "integer",
+            "description": "Maximum number of result entries to return. Use 0 for unlimited sparingly.",
+        },
+        "offset": {
+            "type": "integer",
+            "description": "Number of result entries to skip for pagination.",
+        },
+        "include_ignored": {
+            "type": "boolean",
+            "description": "Whether to include gitignored files. Sensitive files are still filtered.",
+        },
+    },
+    "required": [
+        "query",
+        "path",
+        "glob",
+        "mode",
+        "output_mode",
+        "case_sensitive",
+        "context",
+        "limit",
+        "offset",
+        "include_ignored",
+    ],
+    "additionalProperties": False,
+}
+
 READ_FILE_SCHEMA: dict[str, Any] = {
     "type": "object",
     "properties": {

{deepy_cli-0.2.12 → deepy_cli-0.2.13}/src/deepy/tools/builtin.py

@@ -29,6 +29,7 @@ from deepy.utils import json as json_utils
 
 from .file_state import FileSnippet, FileState
 from .result import ToolResult
+from .search import SearchMode, SearchOutputMode, SearchRequest, search_project
 from .shell_output import decode_shell_output
 from .shell_utils import RuntimeEnvironment
 from .shell_utils import build_disable_extglob_command
@@ -1572,6 +1573,46 @@ class ToolRuntime:
     ) -> str:
         return self._read_file_result(path, start_line=start_line, limit=limit, pages=pages)
 
+    def search(
+        self,
+        query: str,
+        *,
+        path: str = ".",
+        glob: str | None = None,
+        mode: str = "literal",
+        output_mode: str = "content",
+        case_sensitive: bool = True,
+        context: int = 0,
+        limit: int = 100,
+        offset: int = 0,
+        include_ignored: bool = False,
+    ) -> str:
+        name = "Search"
+        request = SearchRequest(
+            query=query,
+            path=path,
+            glob=glob,
+            mode=cast(SearchMode, mode),
+            output_mode=cast(SearchOutputMode, output_mode),
+            case_sensitive=case_sensitive,
+            context=context,
+            limit=limit,
+            offset=offset,
+            include_ignored=include_ignored,
+        )
+        page = search_project(self.cwd, request)
+        error = page.metadata.get("error")
+        error_code = page.metadata.get("error_code")
+        if isinstance(error, str) and error_code:
+            return ToolResult.error_result(name, error, metadata=page.metadata).to_json()
+        if error_code and not page.output:
+            return ToolResult.error_result(
+                name,
+                "Search failed.",
+                metadata=page.metadata,
+            ).to_json()
+        return ToolResult.ok_result(name, page.output, metadata=page.metadata).to_json()
+
     def write(
         self,
         path: str,