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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: deepy-cli
-Version: 0.2.0
+Version: 0.2.1
 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.1}/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.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "deepy-cli"
-version = "0.2.0"
+version = "0.2.1"
 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.1}/src/deepy/__init__.py

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

{deepy_cli-0.2.0 → deepy_cli-0.2.1}/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.0 → deepy_cli-0.2.1}/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.1}/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.1}/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.1}/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.1}/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.1}/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.1}/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.1}/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:

{deepy_cli-0.2.0 → deepy_cli-0.2.1}/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,
@@ -1322,7 +1323,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)
@@ -1453,7 +1454,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,
@@ -1542,7 +1543,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 +1558,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 +1916,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 +1967,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 +2004,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 +2019,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 +2362,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 +2485,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 +2503,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 +2516,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 +2534,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.1}/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.1/src/deepy/types/__init__.py

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

deepy_cli-0.2.1/src/deepy/types/sdk.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+from collections.abc import Callable
+
+from agents.items import TResponseInputItem
+
+
+SessionInputCallback = Callable[
+    [list[TResponseInputItem], list[TResponseInputItem]],
+    list[TResponseInputItem],
+]
+

deepy_cli-0.2.1/src/deepy/types/tool_payloads.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from typing import NotRequired, TypedDict
+
+
+class AskUserOption(TypedDict):
+    label: str
+    description: NotRequired[str]
+
+
+class AskUserQuestion(TypedDict):
+    question: str
+    options: list[AskUserOption]
+    multiSelect: NotRequired[bool]
+

{deepy_cli-0.2.0 → deepy_cli-0.2.1}/src/deepy/ui/exit_summary.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from dataclasses import dataclass
+from collections.abc import Sequence
 from typing import Any, Mapping
 
 
@@ -55,7 +56,7 @@ def extract_usage_fields(usage: Any) -> UsageFields:
 def build_exit_summary_text(
     *,
     session: Any | None = None,
-    messages: list[Mapping[str, Any]] | None = None,
+    messages: Sequence[Mapping[str, Any]] | None = None,
     model: str | None = None,
 ) -> str:
     usage = extract_usage_fields(_get_usage(session))

{deepy_cli-0.2.0 → deepy_cli-0.2.1}/src/deepy/ui/local_command.py

@@ -22,10 +22,13 @@ from deepy.tools.shell_output import decode_shell_output_bytes
 from deepy.tools.shell_utils import RuntimeEnvironment, detect_runtime_environment
 from deepy.utils import json as json_utils
 
+pty: Any | None
 try:
-    import pty
+    import pty as _pty
 except ImportError:  # pragma: no cover - exercised on Windows.
-    pty = None  # type: ignore[assignment]
+    pty = None
+else:
+    pty = _pty
 
 DEFAULT_LOCAL_COMMAND_TIMEOUT_MS = 120_000
 DEFAULT_DISPLAY_OUTPUT_LIMIT = 30_000
@@ -389,9 +392,12 @@ def _read_pipe_output(
     stream = process.stdout
     if stream is None:
         return
+    read1 = getattr(stream, "read1", None)
+    if not callable(read1):
+        return
     while True:
         try:
-            chunk = stream.read1(4096)
+            chunk = read1(4096)
         except Exception:
             return
         if not chunk: