deepy-cli 0.2.0__tar.gz → 0.2.2__tar.gz

{deepy_cli-0.2.0 → deepy_cli-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: deepy-cli
-Version: 0.2.0
+Version: 0.2.2
 Summary: Deepy - Vibe coding for DeepSeek models in your terminal
 Keywords: deepseek,coding-agent,terminal,cli,agents
 Author: kirineko
@@ -342,7 +342,7 @@ A concise `AGENTS.md` works best:
 ## Commands
 - Test: `uv run pytest`
 - Lint: `uv run ruff check`
-- Type check: `uv run pyright`
+- Type check: `uv run ty check src`
 
 ## Architecture
 - Keep CLI entry points thin; put reusable behavior under `src/`.
@@ -369,7 +369,7 @@ create or refresh the project root `AGENTS.md`.
 uv sync --group dev
 uv run pytest
 uv run ruff check
-uv run pyright
+uv run ty check src
 uv build
 ```
 

{deepy_cli-0.2.0 → deepy_cli-0.2.2}/README.md

@@ -313,7 +313,7 @@ A concise `AGENTS.md` works best:
 ## Commands
 - Test: `uv run pytest`
 - Lint: `uv run ruff check`
-- Type check: `uv run pyright`
+- Type check: `uv run ty check src`
 
 ## Architecture
 - Keep CLI entry points thin; put reusable behavior under `src/`.
@@ -340,7 +340,7 @@ create or refresh the project root `AGENTS.md`.
 uv sync --group dev
 uv run pytest
 uv run ruff check
-uv run pyright
+uv run ty check src
 uv build
 ```
 

{deepy_cli-0.2.0 → deepy_cli-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "deepy-cli"
-version = "0.2.0"
+version = "0.2.2"
 description = "Deepy - Vibe coding for DeepSeek models in your terminal"
 readme = "README.md"
 authors = [
@@ -39,10 +39,10 @@ Issues = "https://github.com/kirineko/deepy/issues"
 
 [dependency-groups]
 dev = [
-    "pyright>=1.1.407",
     "pytest>=8.0",
     "pytest-asyncio>=0.24",
     "ruff>=0.14",
+    "ty>=0.0.32",
 ]
 
 [tool.pytest.ini_options]
@@ -54,13 +54,6 @@ target-version = "py312"
 src = ["src", "tests"]
 exclude = ["dist", "reference", "spec"]
 
-[tool.pyright]
-pythonVersion = "3.12"
-typeCheckingMode = "off"
-include = ["src", "tests"]
-exclude = ["dist", "reference", "spec"]
-reportMissingTypeStubs = false
-
 [tool.uv.build-backend]
 module-name = "deepy"
 

{deepy_cli-0.2.0 → deepy_cli-0.2.2}/src/deepy/__init__.py

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

{deepy_cli-0.2.0 → deepy_cli-0.2.2}/src/deepy/cli.py

@@ -4,7 +4,7 @@ import argparse
 import asyncio
 import sys
 from pathlib import Path
-from typing import Sequence
+from typing import Any, Sequence
 
 import tomli_w
 
@@ -198,7 +198,7 @@ def _cmd_config_theme(args: argparse.Namespace) -> int:
     return 0
 
 
-def _doctor(args: argparse.Namespace) -> tuple[int, dict[str, object]]:
+def _doctor(args: argparse.Namespace) -> tuple[int, dict[str, Any]]:
     settings = load_settings(args.config)
     checks: list[dict[str, object]] = []
 
@@ -251,7 +251,7 @@ def _doctor(args: argparse.Namespace) -> tuple[int, dict[str, object]]:
     }
 
 
-async def _doctor_live(settings: Settings) -> dict[str, object]:
+async def _doctor_live(settings: Settings) -> dict[str, Any]:
     from agents import Agent, RunConfig, Runner
 
     provider = build_provider_bundle(settings)

deepy_cli-0.2.2/src/deepy/data/tools/modify.md

@@ -0,0 +1,26 @@
+## modify
+
+Create new files or edit existing files.
+
+Use `content` only when the target file does not exist. For existing files, use
+`old_string` and `new_string` for the smallest reliable replacement. You may
+attempt an exact replacement directly when you already know the current text;
+Deepy records the required file snapshot internally when no prior snapshot
+exists. Read first when you need to inspect context. Do not rewrite an existing
+scaffolded file with full content; replace the specific generated block instead.
+
+Args for new files: `file_path`, `content`.
+
+Args for existing files: `file_path`, `old_string`, `new_string`, optional
+`replace_all`, optional `snippet_id`.
+
+Existing-file edits must have a managed snapshot before Deepy commits changes;
+`modify` can create that snapshot internally for direct exact replacements. Stale
+edits are rejected. Repeated matches are rejected unless `replace_all` is true;
+candidate snippets can be reused with `snippet_id`. Success includes diff
+metadata.
+
+If several `old_string` attempts fail and you know the complete desired file content,
+re-read the file and use the managed whole-file replacement path. Do not delete the file
+and recreate it with shell commands or here-strings; that bypasses Deepy's encoding,
+newline, and stale-write protections, especially on Windows.

{deepy_cli-0.2.0 → deepy_cli-0.2.2}/src/deepy/llm/agent.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from pathlib import Path
+from typing import TYPE_CHECKING
 
 from deepy.config import Settings
 from deepy.prompts import build_system_prompt
@@ -10,6 +11,9 @@ from deepy.tools.agents import build_function_tools
 
 from .provider import ProviderBundle, build_provider_bundle
 
+if TYPE_CHECKING:
+    from agents.mcp import MCPServer
+
 
 def build_deepy_agent(
     settings: Settings,
@@ -18,7 +22,7 @@ def build_deepy_agent(
     project_root: Path,
     provider: ProviderBundle | None = None,
     loaded_skills: list[SkillInfo] | None = None,
-    mcp_servers: list[object] | None = None,
+    mcp_servers: list[MCPServer] | None = None,
     preferred_mcp_web_search_tools: list[str] | None = None,
 ):
     from agents import Agent

{deepy_cli-0.2.0 → deepy_cli-0.2.2}/src/deepy/llm/context.py

@@ -1,16 +1,19 @@
 from __future__ import annotations
 
-from collections.abc import Callable
 from math import ceil
 from typing import Any
 
 from deepy.config import Settings
+from deepy.types.sdk import SessionInputCallback
 from deepy.utils import json as json_utils
 
+tiktoken: Any | None
 try:
-    import tiktoken
+    import tiktoken as _tiktoken
 except Exception:  # pragma: no cover - optional dependency fallback.
-    tiktoken = None  # type: ignore[assignment]
+    tiktoken = None
+else:
+    tiktoken = _tiktoken
 
 _ENCODING = None
 
@@ -38,11 +41,8 @@ def estimate_tokens_for_items(items: list[dict[str, Any]]) -> int:
     return sum(estimate_tokens_for_item(item) for item in items)
 
 
-def build_session_input_callback(settings: Settings) -> Callable[
-    [list[dict[str, Any]], list[dict[str, Any]]],
-    list[dict[str, Any]],
-]:
-    def callback(history: list[dict[str, Any]], new_input: list[dict[str, Any]]) -> list[dict[str, Any]]:
+def build_session_input_callback(settings: Settings) -> SessionInputCallback:
+    def callback(history: list[Any], new_input: list[Any]) -> list[Any]:
         return [*history, *new_input]
 
     return callback

{deepy_cli-0.2.0 → deepy_cli-0.2.2}/src/deepy/llm/provider.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 from dataclasses import dataclass
 from typing import Any
 
+from agents import Model, ModelSettings
 from agents import OpenAIChatCompletionsModel
 
 from deepy.config import Settings
@@ -17,8 +18,8 @@ from .replay import (
 @dataclass(frozen=True)
 class ProviderBundle:
     client: object
-    model: object
-    model_settings: object
+    model: Model
+    model_settings: ModelSettings
 
 
 class DeepyOpenAIChatCompletionsModel(OpenAIChatCompletionsModel):

{deepy_cli-0.2.0 → deepy_cli-0.2.2}/src/deepy/llm/replay.py

@@ -105,9 +105,9 @@ def sanitize_chat_completion_stream_event(event: Any) -> Any | None:
     if getattr(event, "type", None) == "response.completed":
         response = getattr(event, "response", None)
         output = getattr(response, "output", None)
-        if isinstance(output, list):
+        if response is not None and isinstance(output, list):
             try:
-                response.output = sanitize_model_response_output(output)
+                cast(Any, response).output = sanitize_model_response_output(output)
             except Exception:
                 pass
     return event

{deepy_cli-0.2.0 → deepy_cli-0.2.2}/src/deepy/llm/runner.py

@@ -130,7 +130,7 @@ async def run_prompt_once(
             input=prompt,
             max_turns=max_turns,
             run_config=run_config,
-            session=session,
+            session=session,  # ty: ignore[invalid-argument-type] - DeepyJsonlSession matches the SDK Session protocol at runtime.
         )
         if should_interrupt is not None:
             interrupt_task = asyncio.create_task(
@@ -349,7 +349,7 @@ def _max_turns_output(chunks: list[str], *, max_turns: int) -> str:
 
 def format_deepseek_api_error(error: Any) -> str:
     status_code = _safe_int(getattr(error, "status_code", None))
-    status = DEEPSEEK_ERROR_CODES.get(status_code)
+    status = DEEPSEEK_ERROR_CODES.get(status_code) if status_code is not None else None
     title = f"DeepSeek API error {status_code}" if status_code is not None else "DeepSeek API error"
     if status is not None:
         title = f"{title}: {status.title}"

{deepy_cli-0.2.0 → deepy_cli-0.2.2}/src/deepy/mcp.py

@@ -155,7 +155,12 @@ class DeepyMcpRuntime:
             await self._manager.cleanup_all()
 
     def _build_sdk_servers(self) -> list[Any]:
-        from agents.mcp import MCPServerStdio, MCPServerStreamableHttp
+        from agents.mcp import (
+            MCPServerStdio,
+            MCPServerStdioParams,
+            MCPServerStreamableHttp,
+            MCPServerStreamableHttpParams,
+        )
 
         servers: list[Any] = []
         for definition in self.definitions:
@@ -173,7 +178,7 @@ class DeepyMcpRuntime:
                 )
                 continue
             if definition.transport == "stdio":
-                params: dict[str, Any] = {"command": definition.command or ""}
+                params: MCPServerStdioParams = {"command": definition.command or ""}
                 if definition.args:
                     params["args"] = list(definition.args)
                 if definition.env:
@@ -189,7 +194,7 @@ class DeepyMcpRuntime:
                     ),
                 )
             else:
-                params = {"url": definition.url or ""}
+                params: MCPServerStreamableHttpParams = {"url": definition.url or ""}
                 if definition.headers:
                     params["headers"] = dict(definition.headers)
                 server = MCPServerStreamableHttp(

{deepy_cli-0.2.0 → deepy_cli-0.2.2}/src/deepy/prompts/system.py

@@ -45,7 +45,7 @@ def build_system_prompt(
 Core rules:
 - Work in the repo with tools: inspect, modify, test, verify.
 - Preserve user changes. Prefer small, verifiable edits.
-- Read before changing existing files.
+- Read existing files when you need context; exact `modify` edits can establish the managed snapshot internally.
 - Use `modify` for file changes: `content` only creates new files; existing files use `old_string`/`new_string`.
 - After project generators create scaffold files, read and edit the generated block instead of replacing the file.
 - Run shell commands using the Runtime context's command dialect and path style: `powershell` -> PowerShell with Windows paths; `cmd` -> cmd; `posix` -> POSIX shell.

{deepy_cli-0.2.0 → deepy_cli-0.2.2}/src/deepy/skills.py

@@ -116,7 +116,7 @@ def _format_skills(skills: Iterable[SkillInfo], *, include_paths: bool) -> str:
 
 
 def _builtin_skills_root() -> Path:
-    return Path(resources.files("deepy.data").joinpath("skills"))
+    return Path(str(resources.files("deepy.data").joinpath("skills")))
 
 
 def _discover_skills_root(root: Path, *, scope: str) -> list[SkillInfo]:

{deepy_cli-0.2.0 → deepy_cli-0.2.2}/src/deepy/tools/agents.py

@@ -1,17 +1,20 @@
 from __future__ import annotations
 
-from typing import Any
+from typing import TYPE_CHECKING, Any
 
 from deepy.utils import json as json_utils
 
 from .builtin import ToolRuntime
 
+if TYPE_CHECKING:
+    from agents import Tool
+
 
 def build_function_tools(
     runtime: ToolRuntime,
     *,
     preferred_mcp_web_search_tools: list[str] | None = None,
-) -> list[object]:
+) -> list[Tool]:
     from agents.tool import FunctionTool
 
     async def invoke_shell(_context: object, raw_input: str) -> str:
@@ -104,7 +107,8 @@ def build_function_tools(
             name="modify",
             description=(
                 "Create new files or edit existing files. Use content only for files that do not "
-                "exist. For existing files, read first and use old_string/new_string."
+                "exist. For existing files, use old_string/new_string; read first when you need "
+                "to inspect context."
             ),
             params_json_schema=MODIFY_SCHEMA,
             on_invoke_tool=invoke_modify,

{deepy_cli-0.2.0 → deepy_cli-0.2.2}/src/deepy/tools/builtin.py

@@ -22,6 +22,7 @@ from html.parser import HTMLParser
 from pathlib import Path
 
 from deepy.config import DEFAULT_WEB_SEARCH_SEARXNG_URL, Settings, mask_secret
+from deepy.types.tool_payloads import AskUserOption, AskUserQuestion
 from deepy.utils import json as json_utils
 
 from .file_state import FileSnippet, FileState
@@ -728,7 +729,7 @@ def _decide_search_language_with_llm(query: str, settings: Settings) -> dict[str
     )
     parsed = _parse_json_response(_web_search_chat(settings, prompt))
     dominant_language = parsed.get("dominant_language")
-    if dominant_language not in {"en", "zh"}:
+    if not isinstance(dominant_language, str) or dominant_language not in {"en", "zh"}:
         raise ValueError(f"Unexpected dominant language: {dominant_language}")
     reason = parsed.get("reason")
     return {
@@ -1249,7 +1250,7 @@ class ToolRuntime:
             )
             self.file_state.mark_read(target, full=False)
             snippet_metadata = _snippet_metadata(snippet)
-        metadata = {
+        metadata: dict[str, object] = {
             "path": str(target),
             "kind": "file",
             "startLine": start + 1,
@@ -1301,7 +1302,14 @@ class ToolRuntime:
                 "modify",
                 "Provide content for a new file, or both old_string and new_string for an existing file.",
             ).to_json()
-        return self.edit(path, old, new, replace_all=replace_all, snippet_id=snippet_id)
+        return self.edit(
+            path,
+            old,
+            new,
+            replace_all=replace_all,
+            snippet_id=snippet_id,
+            auto_read_if_missing_snapshot=True,
+        )
 
     def write(self, path: str, content: object) -> str:
         name = "write"
@@ -1322,7 +1330,7 @@ class ToolRuntime:
         encoding = (
             existing_metadata.encoding
             if existing_metadata is not None
-            else _default_new_text_encoding(text_content, platform_name=self.platform_name)
+            else _default_new_text_encoding()
         )
         line_endings = _detect_line_endings(old_content or text_content)
         normalized_content = _normalize_line_endings(text_content, line_endings)
@@ -1350,6 +1358,7 @@ class ToolRuntime:
         new: str,
         replace_all: bool = False,
         snippet_id: str | None = None,
+        auto_read_if_missing_snapshot: bool = False,
     ) -> str:
         name = "edit"
         if not old:
@@ -1376,6 +1385,14 @@ class ToolRuntime:
             target = _resolve_in_cwd(self.cwd, path)
         if not target.exists():
             return ToolResult.error_result(name, f"File does not exist: {target}").to_json()
+        auto_read_before_modify = False
+        if (
+            auto_read_if_missing_snapshot
+            and snippet is None
+            and self.file_state.snapshot_status(target) == "missing"
+        ):
+            self.file_state.mark_read(target)
+            auto_read_before_modify = True
         ok, error = self.file_state.check_writable(
             target,
             require_read=True,
@@ -1453,7 +1470,7 @@ class ToolRuntime:
         _write_text_with_encoding(target, updated, text_metadata.encoding)
         self.file_state.mark_written(target)
         diff = _unified_diff(text, updated, path=str(target))
-        metadata = {
+        metadata: dict[str, object] = {
             "path": str(target),
             "file_path": str(target),
             "occurrences": occurrences if replace_all else 1,
@@ -1464,6 +1481,8 @@ class ToolRuntime:
             "diff": diff,
             "diff_preview": diff,
         }
+        if auto_read_before_modify:
+            metadata["autoReadBeforeModify"] = True
         if snippet is not None:
             metadata["scope"] = _format_scope_metadata(target, snippet, scope, text)
         return ToolResult.ok_result(name, f"Edited {target}", metadata=metadata).to_json()
@@ -1542,7 +1561,6 @@ class ToolRuntime:
             self.cwd = final_cwd
         returncode = exit_code if exit_code is not None else process.returncode
         output, output_truncated = _truncate_output(stdout + (stderr or ""))
-        result = ToolResult.ok_result if returncode == 0 else ToolResult.error_result
         metadata = _shell_metadata(
             self.cwd,
             process_id,
@@ -1558,12 +1576,12 @@ class ToolRuntime:
             }
         )
         if returncode == 0:
-            return result(
+            return ToolResult.ok_result(
                 name,
                 output,
                 metadata=metadata,
             ).to_json()
-        return result(
+        return ToolResult.error_result(
             name,
             f"Command exited with code {returncode}.",
             output=output,
@@ -1916,17 +1934,10 @@ def _python_text_encoding(encoding: str) -> str:
     return "utf8"
 
 
-def _default_new_text_encoding(content: str, *, platform_name: str | None = None) -> str:
-    resolved_platform = platform_name or sys.platform
-    if resolved_platform.startswith("win") and _contains_non_ascii(content):
-        return "utf8-sig"
+def _default_new_text_encoding() -> str:
     return "utf8"
 
 
-def _contains_non_ascii(text: str) -> bool:
-    return any(ord(char) > 0x7F for char in text)
-
-
 def _write_text_with_encoding(path: Path, content: str, encoding: str) -> None:
     path.write_bytes(content.encode(_python_text_encoding(encoding)))
 
@@ -1974,24 +1985,24 @@ def _format_notebook(path: Path) -> tuple[str, str | None]:
     cells = parsed.get("cells")
     lines: list[str] = []
     if isinstance(cells, list):
-        for index, cell in enumerate(cells):
-            if not isinstance(cell, dict):
+        for index, raw_cell in enumerate(cells):
+            cell = _string_key_dict(raw_cell)
+            if cell is None:
                 continue
-            cell_type = cell.get("cell_type") if isinstance(cell.get("cell_type"), str) else "unknown"
+            raw_cell_type = cell.get("cell_type")
+            cell_type = raw_cell_type if isinstance(raw_cell_type, str) else "unknown"
             lines.append(f"# Cell {index + 1} ({cell_type})")
             lines.extend(_normalize_notebook_field(cell.get("source")))
 
             outputs = cell.get("outputs")
             if not isinstance(outputs, list):
                 continue
-            for output_index, output in enumerate(outputs):
-                if not isinstance(output, dict):
+            for output_index, raw_output in enumerate(outputs):
+                output = _string_key_dict(raw_output)
+                if output is None:
                     continue
-                output_type = (
-                    output.get("output_type")
-                    if isinstance(output.get("output_type"), str)
-                    else "output"
-                )
+                raw_output_type = output.get("output_type")
+                output_type = raw_output_type if isinstance(raw_output_type, str) else "output"
                 lines.append(f"# Output {output_index + 1} ({output_type})")
                 lines.extend(_format_notebook_output(output))
 
@@ -2011,12 +2022,13 @@ def _normalize_notebook_field(value: object) -> list[str]:
 def _format_notebook_output(output: dict[str, object]) -> list[str]:
     lines = _normalize_notebook_field(output.get("text"))
     data = output.get("data")
-    if isinstance(data, dict):
-        lines.extend(_normalize_notebook_field(data.get("text/plain")))
-        image_png = data.get("image/png")
+    data_dict = _string_key_dict(data)
+    if data_dict is not None:
+        lines.extend(_normalize_notebook_field(data_dict.get("text/plain")))
+        image_png = data_dict.get("image/png")
         if isinstance(image_png, str):
             lines.append(f"[image/png {len(image_png)} chars]")
-        image_jpeg = data.get("image/jpeg")
+        image_jpeg = data_dict.get("image/jpeg")
         if isinstance(image_jpeg, str):
             lines.append(f"[image/jpeg {len(image_jpeg)} chars]")
     traceback = output.get("traceback")
@@ -2025,6 +2037,14 @@ def _format_notebook_output(output: dict[str, object]) -> list[str]:
     return lines or ["[output omitted]"]
 
 
+def _string_key_dict(value: object) -> dict[str, object] | None:
+    if not isinstance(value, dict):
+        return None
+    if not all(isinstance(key, str) for key in value):
+        return None
+    return {key: item for key, item in value.items() if isinstance(key, str)}
+
+
 @dataclass(frozen=True)
 class PageRange:
     start: int
@@ -2360,7 +2380,7 @@ def _now_iso() -> str:
     return time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime())
 
 
-def _terminate_process(process: subprocess.Popen[str]) -> None:
+def _terminate_process(process: subprocess.Popen[bytes]) -> None:
     try:
         if os.name != "nt":
             os.killpg(process.pid, signal.SIGKILL)
@@ -2483,13 +2503,14 @@ def _gitignore_pattern_matches(pattern: str, relative_path: str, is_dir: bool) -
     return any(fnmatch(part, normalized_pattern) for part in parts)
 
 
-def _parse_ask_user_questions(value: object) -> tuple[list[dict[str, object]], str | None]:
+def _parse_ask_user_questions(value: object) -> tuple[list[AskUserQuestion], str | None]:
     if not isinstance(value, list) or not value:
         return [], '"questions" must be a non-empty array.'
 
-    questions: list[dict[str, object]] = []
-    for index, item in enumerate(value):
-        if not isinstance(item, dict):
+    questions: list[AskUserQuestion] = []
+    for index, raw_item in enumerate(value):
+        item = _string_key_dict(raw_item)
+        if item is None:
             return [], f"Question at index {index} must be an object."
 
         question = _trimmed_string(item.get("question"))
@@ -2500,9 +2521,10 @@ def _parse_ask_user_questions(value: object) -> tuple[list[dict[str, object]], s
         if not isinstance(raw_options, list) or not raw_options:
             return [], f'Question at index {index} must include a non-empty "options" array.'
 
-        options: list[dict[str, str]] = []
-        for option_index, option in enumerate(raw_options):
-            if not isinstance(option, dict):
+        options: list[AskUserOption] = []
+        for option_index, raw_option in enumerate(raw_options):
+            option = _string_key_dict(raw_option)
+            if option is None:
                 return [], f"Option {option_index} for question {index} must be an object."
 
             label = _trimmed_string(option.get("label"))
@@ -2512,13 +2534,13 @@ def _parse_ask_user_questions(value: object) -> tuple[list[dict[str, object]], s
                     f'Option {option_index} for question {index} is missing a non-empty "label" string.',
                 )
 
-            parsed_option = {"label": label}
+            parsed_option: AskUserOption = {"label": label}
             description = _trimmed_string(option.get("description"))
             if description:
                 parsed_option["description"] = description
             options.append(parsed_option)
 
-        parsed_question: dict[str, object] = {
+        parsed_question: AskUserQuestion = {
             "question": question,
             "options": options,
         }
@@ -2530,15 +2552,13 @@ def _parse_ask_user_questions(value: object) -> tuple[list[dict[str, object]], s
     return questions, None
 
 
-def _build_question_summary(questions: list[dict[str, object]]) -> str:
+def _build_question_summary(questions: list[AskUserQuestion]) -> str:
     lines = ["Waiting for user input."]
     for index, item in enumerate(questions):
         lines.append("")
         lines.append(f"{index + 1}. {item['question']}")
         lines.append(f"   Mode: {'multi-select' if item.get('multiSelect') else 'single-select'}")
         for option in item["options"]:
-            if not isinstance(option, dict):
-                continue
             lines.append(f"   - {option['label']}")
             if option.get("description"):
                 lines.append(f"     {option['description']}")

{deepy_cli-0.2.0 → deepy_cli-0.2.2}/src/deepy/tools/file_state.py

@@ -2,6 +2,10 @@ from __future__ import annotations
 
 from dataclasses import dataclass, field
 from pathlib import Path
+from typing import Literal
+
+
+SnapshotStatus = Literal["missing", "full", "partial", "deleted", "stale"]
 
 
 @dataclass
@@ -58,6 +62,18 @@ class FileState:
             return False, "File changed since it was read; read it again before editing."
         return True, None
 
+    def snapshot_status(self, path: Path) -> SnapshotStatus:
+        resolved = path.resolve()
+        snapshot = self._snapshots.get(resolved)
+        if snapshot is None:
+            return "missing"
+        if not resolved.exists():
+            return "deleted"
+        stat = resolved.stat()
+        if stat.st_mtime_ns != snapshot.mtime_ns or stat.st_size != snapshot.size:
+            return "stale"
+        return "full" if snapshot.full_read else "partial"
+
     def mark_written(self, path: Path) -> None:
         if path.exists():
             self.mark_read(path)

{deepy_cli-0.2.0 → deepy_cli-0.2.2}/src/deepy/tools/result.py

@@ -17,7 +17,7 @@ class ToolResult:
     followUpMessages: list[dict[str, Any]] | None = None
 
     def to_dict(self) -> dict[str, Any]:
-        payload = {
+        payload: dict[str, Any] = {
             "ok": self.ok,
             "name": self.name,
             "output": self.output,

deepy_cli-0.2.2/src/deepy/types/__init__.py

@@ -0,0 +1,2 @@
+"""Shared Deepy type definitions."""
+