deepy-cli 0.1.1__py3-none-any.whl

deepy/utils/error_logger.py

@@ -0,0 +1,107 @@
+from __future__ import annotations
+
+import re
+from collections.abc import Mapping
+from pathlib import Path
+from typing import Any
+
+from .debug_logger import normalize_error
+from . import json as json_utils
+
+MAX_ERROR_LOG_ENTRIES = 20
+CONTENT_PREVIEW_CHARS = 100
+
+_SENSITIVE_PATTERNS = (
+    re.compile(r"(Authorization:\s*Bearer\s+)[^\s\r\n]+", re.IGNORECASE),
+    re.compile(
+        r"((?:\"?(?:api[Kk]ey|api_key|secret|token)\"?\s*[:=]\s*\"?))[^\",}\s]+",
+        re.IGNORECASE,
+    ),
+)
+
+
+def error_log_path(deepy_home: Path | None = None) -> Path:
+    home = deepy_home or Path.home() / ".deepy"
+    return home / "logs" / "error.log"
+
+
+def mask_sensitive(text: str) -> str:
+    masked = text
+    for pattern in _SENSITIVE_PATTERNS:
+        masked = pattern.sub(r"\1***MASKED***", masked)
+    return masked
+
+
+def log_api_error(entry: Mapping[str, Any], *, deepy_home: Path | None = None) -> None:
+    try:
+        path = error_log_path(deepy_home)
+        path.parent.mkdir(parents=True, exist_ok=True)
+        payload = _sanitize_error_entry(entry)
+        with path.open("a", encoding="utf-8") as fh:
+            fh.write(json_utils.dumps(payload))
+            fh.write("\n")
+        _trim_error_log(path)
+    except Exception:
+        return
+
+
+def _sanitize_error_entry(entry: Mapping[str, Any]) -> dict[str, Any]:
+    error = entry.get("error")
+    normalized_error = (
+        normalize_error(error)
+        if isinstance(error, BaseException)
+        else dict(error)
+        if isinstance(error, Mapping)
+        else normalize_error(error or "")
+    )
+    sanitized = {
+        "timestamp": entry.get("timestamp"),
+        "location": entry.get("location"),
+        "requestId": entry.get("requestId"),
+        "sessionId": entry.get("sessionId"),
+        "model": entry.get("model"),
+        "baseURL": entry.get("baseURL"),
+        "error": {
+            "name": normalized_error.get("name", "UnknownError"),
+            "message": mask_sensitive(str(normalized_error.get("message", ""))),
+        },
+        "request": _sanitize_request(entry.get("request", {})),
+    }
+    stack = normalized_error.get("stack")
+    if stack:
+        sanitized["error"]["stack"] = mask_sensitive(str(stack))
+    if "response" in entry:
+        response = entry["response"]
+        sanitized["response"] = mask_sensitive(response) if isinstance(response, str) else response
+    return {key: value for key, value in sanitized.items() if value is not None}
+
+
+def _sanitize_request(value: Any) -> Any:
+    if isinstance(value, str):
+        masked = mask_sensitive(value)
+        if len(masked) <= CONTENT_PREVIEW_CHARS:
+            return masked
+        return masked[:CONTENT_PREVIEW_CHARS] + f"...(total {len(masked)} chars)"
+    if isinstance(value, list):
+        return [_sanitize_request(item) for item in value]
+    if isinstance(value, dict):
+        result = {}
+        for key, item in value.items():
+            if _is_sensitive_key(str(key)) and isinstance(item, str):
+                result[key] = "***MASKED***"
+            else:
+                result[key] = _sanitize_request(item)
+        return result
+    return value
+
+
+def _is_sensitive_key(key: str) -> bool:
+    normalized = key.replace("-", "_").lower()
+    return normalized in {"apikey", "api_key", "secret", "authorization", "token"}
+
+
+def _trim_error_log(path: Path) -> None:
+    lines = [line for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]
+    if len(lines) <= MAX_ERROR_LOG_ENTRIES:
+        return
+    path.write_text("\n".join(lines[-MAX_ERROR_LOG_ENTRIES:]) + "\n", encoding="utf-8")

deepy/utils/json.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+import json
+from typing import Any
+
+try:
+    import orjson
+except Exception:  # pragma: no cover - exercised when optional wheel is unavailable.
+    orjson = None  # type: ignore[assignment]
+
+JSONDecodeError = json.JSONDecodeError
+
+
+def dumps(value: Any) -> str:
+    if orjson is not None:
+        return orjson.dumps(value).decode("utf-8")
+    return json.dumps(value, ensure_ascii=False, separators=(",", ":"))
+
+
+def dumps_pretty(value: Any) -> str:
+    if orjson is not None:
+        return orjson.dumps(value, option=orjson.OPT_INDENT_2).decode("utf-8")
+    return json.dumps(value, ensure_ascii=False, indent=2)
+
+
+def loads(text: str | bytes | bytearray) -> Any:
+    if orjson is not None:
+        return orjson.loads(text)
+    return json.loads(text)

deepy/utils/notify.py

@@ -0,0 +1,66 @@
+from __future__ import annotations
+
+import os
+import subprocess
+from collections.abc import Callable, Mapping
+from pathlib import Path
+from typing import Any
+
+
+Spawn = Callable[..., Any]
+
+
+def format_duration_seconds(duration_ms: float | int) -> str:
+    try:
+        safe_ms = max(float(duration_ms), 0)
+    except (TypeError, ValueError):
+        safe_ms = 0
+    return str(int(safe_ms // 1000))
+
+
+def build_notify_env(
+    duration_ms: float | int,
+    base_env: Mapping[str, str] | None = None,
+) -> dict[str, str]:
+    env = dict(base_env or os.environ)
+    env["DURATION"] = format_duration_seconds(duration_ms)
+    return env
+
+
+def launch_notify_script(
+    notify_path: str | None,
+    duration_ms: float | int,
+    working_directory: str | Path | None = None,
+    *,
+    spawn_process: Spawn | None = None,
+) -> None:
+    command_path = (notify_path or "").strip()
+    if not command_path:
+        return
+
+    cwd = str(working_directory) if working_directory is not None else None
+    env = build_notify_env(duration_ms)
+    spawn = spawn_process or subprocess.Popen
+    options = {
+        "cwd": cwd,
+        "env": env,
+        "stdin": subprocess.DEVNULL,
+        "stdout": subprocess.DEVNULL,
+        "stderr": subprocess.DEVNULL,
+        "start_new_session": os.name != "nt",
+    }
+    try:
+        spawn([command_path], **options)
+    except OSError as exc:
+        if os.name == "nt" or exc.errno not in {8, 13}:
+            return
+        _spawn_fallback_shell(spawn, command_path, options)
+    except Exception:
+        return
+
+
+def _spawn_fallback_shell(spawn: Spawn, command_path: str, options: dict[str, Any]) -> None:
+    try:
+        spawn(["/bin/sh", command_path], **options)
+    except Exception:
+        return

deepy_cli-0.1.1.dist-info/METADATA

@@ -0,0 +1,205 @@
+Metadata-Version: 2.3
+Name: deepy-cli
+Version: 0.1.1
+Summary: Deepy - Vibe coding for DeepSeek models in your terminal
+Keywords: deepseek,coding-agent,terminal,cli,agents
+Author: kirineko
+Author-email: kirineko <kirineko@qq.com>
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Classifier: Topic :: Terminals
+Requires-Dist: openai-agents>=0.17.0
+Requires-Dist: openai>=2.26,<3
+Requires-Dist: orjson>=3.10,<4
+Requires-Dist: pydantic>=2.12,<3
+Requires-Dist: prompt-toolkit>=3.0,<4
+Requires-Dist: rich>=13.9,<15
+Requires-Dist: tiktoken>=0.9,<1
+Requires-Dist: tomli-w>=1
+Requires-Python: >=3.12
+Project-URL: Homepage, https://kirineko.github.io/deepy/
+Project-URL: Repository, https://github.com/kirineko/deepy
+Project-URL: Issues, https://github.com/kirineko/deepy/issues
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/kirineko/deepy/main/asset/deepy-logo.png" alt="Deepy logo" width="160">
+</p>
+
+<h1 align="center">Deepy</h1>
+
+<p align="center">
+  A cute terminal coding agent for DeepSeek models.
+  <br>
+  Read, edit, run tools, search the web, and keep project context in one terminal session.
+</p>
+
+<p align="center">
+  <a href="https://kirineko.github.io/deepy/">Website</a>
+  ·
+  <a href="README.zh-CN.md">中文文档</a>
+  ·
+  <a href="#quick-start">Quick Start</a>
+</p>
+
+![Deepy welcome screen](https://raw.githubusercontent.com/kirineko/deepy/main/asset/welcome.jpg)
+
+## What Is Deepy?
+
+Deepy is a Python terminal coding agent built for DeepSeek's OpenAI-compatible
+models. It keeps the workflow inside your terminal: ask questions, inspect a
+project, edit files, run commands, search or fetch web content, and resume the
+same project session later.
+
+Deepy is designed around DeepSeek V4 thinking mode, long context, cache-friendly
+prompting, and a Rich terminal interface that makes tool calls, diffs, usage, and
+context state visible while the agent works.
+
+## Highlights
+
+- DeepSeek-first model setup with `deepseek-v4-pro`, thinking enabled, and
+  `reasoning_effort=max` by default.
+- OpenAI Agents SDK integration through `OpenAIChatCompletionsModel`.
+- Project-aware coding tools for reading files, modifying files, running shell
+  commands, and showing readable diffs.
+- Web research tools for search and direct URL fetching when a task needs fresh
+  information.
+- Session history, `/resume`, `/new`, automatic context tracking, and compacting
+  for long project work.
+- TOML-only private configuration at `~/.deepy/config.toml`.
+- Terminal UI with Markdown rendering, DeepSeek thinking display, per-turn usage,
+  context window status, and version update checks.
+
+## See It Work
+
+### Start In A Project
+
+Deepy shows the current model, thinking settings, working directory, and the core
+commands directly on startup.
+
+![Deepy startup screen](https://raw.githubusercontent.com/kirineko/deepy/main/asset/welcome.jpg)
+
+### Build And Verify Code
+
+Ask Deepy to implement a change, write tests, run the project test command, and
+summarize the result.
+
+![Deepy coding workflow with diff](https://raw.githubusercontent.com/kirineko/deepy/main/asset/coding-1.jpg)
+
+Deepy can also turn command output into a readable project summary, including
+files created, code snippets, and test coverage.
+
+![Deepy project summary](https://raw.githubusercontent.com/kirineko/deepy/main/asset/coding-2.jpg)
+
+### Research With Sources
+
+Deepy includes WebSearch and WebFetch tools, so a terminal session can gather
+current information and fetch exact pages when a URL is provided.
+
+![Deepy web research workflow](https://raw.githubusercontent.com/kirineko/deepy/main/asset/websearch.jpg)
+
+## Quick Start
+
+Install from PyPI after the first release:
+
+```bash
+uv tool install deepy-cli
+```
+
+The installed command is still `deepy`.
+
+Install the latest code from GitHub:
+
+```bash
+uv tool install git+https://github.com/kirineko/deepy.git
+```
+
+Configure your DeepSeek API key:
+
+```bash
+deepy config setup
+```
+
+Start Deepy in a project:
+
+```bash
+cd your-project
+deepy
+```
+
+## Configuration
+
+Deepy only uses TOML configuration. JSON config files are intentionally rejected.
+
+```toml
+# ~/.deepy/config.toml
+api_key = "sk-..."
+model = "deepseek-v4-pro"
+base_url = "https://api.deepseek.com"
+context_window_tokens = 1048576
+compact_threshold = 0.8
+```
+
+You can also initialize config non-interactively:
+
+```bash
+deepy config init --api-key sk-... --model deepseek-v4-pro
+```
+
+## Common Commands
+
+```bash
+deepy --version
+deepy config setup
+deepy doctor
+deepy doctor --live --json
+deepy status
+deepy skills list
+deepy sessions list
+deepy sessions show <session-id>
+deepy run "summarize this project"
+```
+
+Inside the interactive terminal:
+
+```text
+/skills   List available skills
+/new      Start a fresh conversation
+/resume   Pick a previous session
+/         Open the command menu
+Esc       Interrupt the current model turn
+Ctrl+D    Press twice to quit
+```
+
+## Project Rules And Skills
+
+Deepy automatically loads project instructions from:
+
+- `AGENTS.md`
+- `.deepy/skills/*/SKILL.md`
+
+This lets each repository define local conventions, commands, review rules, and
+domain-specific skills without changing global config.
+
+## Development
+
+```bash
+uv sync --group dev
+uv run pytest
+uv run ruff check
+uv run pyright
+uv build
+```
+
+The Python package is built from `src/deepy`. GitHub Pages files and screenshot
+assets live outside the package directory and are not included in the wheel.
+
+## Release Status
+
+Deepy is preparing its first public `0.1.1` release. The current release path is
+GitHub + PyPI. Standalone binaries and npm wrappers can be added later, but the
+primary distribution is the Python CLI.

deepy_cli-0.1.1.dist-info/RECORD

@@ -0,0 +1,69 @@
+deepy/__init__.py,sha256=5cR0JYreh1wX-ToXif56ZZtdYc1iFPZY6BsOxbyMRa4,134
+deepy/__main__.py,sha256=GbvZLVkm17UpUjvRqNrXYfXT7Sp_1hBKBUkHnEmHyzY,98
+deepy/cli.py,sha256=Cfs04xpp8PtZhnNzzzzYiuWJd8QmG4rt1Y-iHCUmtcE,15424
+deepy/config/__init__.py,sha256=4nbHBKOXVmKe4Tqt37ts8axNkbp90xn3RowT-UkCcMQ,367
+deepy/config/settings.py,sha256=ynGrtXjmaCAa86IXZ9T2bMk42HfoowGnbQGdd7Sct-Y,7737
+deepy/data/__init__.py,sha256=7Hd6xELwjY_ZosUmWM4_nR_B3Hd1aBHkonGKp6-2wLo,30
+deepy/data/tools/AskUserQuestion.md,sha256=zHLiswVJdOpwdmagkbmOrtUFGVQF7AxhjEOFUEbEzho,436
+deepy/data/tools/WebFetch.md,sha256=CBeAlBt8eucnOKByd3HmtU__of18AkChw_P3GdgoeHo,313
+deepy/data/tools/WebSearch.md,sha256=EyBaXOldfJMJaQ6FUohnpO9LMOjAx65mBNCg8i9pO5s,311
+deepy/data/tools/__init__.py,sha256=HoFjP9gt9ZsizwNYPcP46yy_r7h0xCxSNqAgqLO2BpQ,35
+deepy/data/tools/bash.md,sha256=PWVXjSV4t_BKgk34oKX-oyFSWiHX8Vi65HsVVCMHS9U,211
+deepy/data/tools/edit.md,sha256=igbrtEyAgUU_OccGuBlrr19HwLOcOArhRIBtw6wxmZ8,597
+deepy/data/tools/modify.md,sha256=nqhq-nP55XzLPtLr4kUayW1mrtZ1vD8REgJeHsagjaQ,710
+deepy/data/tools/read.md,sha256=9ePk8JIA7evlBhILHy67yASNFvCUVFgwClWfLaYZbD4,248
+deepy/data/tools/write.md,sha256=63dLjU5cL1VLk8ct_MN9KdJ6cgYkp6_OYFUwYI0Ip9A,526
+deepy/errors.py,sha256=WRcKcutAJRT57dBivsV1eLyXhxN5RKhwlHhnGdKCfCA,2342
+deepy/llm/__init__.py,sha256=5n_CsURb7ik_eDudoQtG15-j9OXpS9bD39b0tH8PuAk,383
+deepy/llm/agent.py,sha256=UgfsTT_nuPPHcxSL82Z_20-7C9XgHtAZxXiVqmvaxPs,882
+deepy/llm/context.py,sha256=2MDVUb53gImHwopN1DfAweNtsXdGWL9S8pB8q29Rk2U,3135
+deepy/llm/events.py,sha256=YWURYdOau3neHR59JFcHUmVt9KTWMgPZyMr7r1auaJs,6164
+deepy/llm/model_capabilities.py,sha256=R76S8b_GDUu2wNHb8peE0yfBjzn5_BvEP5kJYMHvMCk,201
+deepy/llm/provider.py,sha256=JbJE_Qpnp2WbA92wAchhcWumCD3urFO3WVl4paAHxgw,2615
+deepy/llm/replay.py,sha256=-Vyy2SSsjJz9ATK1NB9e4n9HWRgX8JrUYPHBKBWT0OU,3577
+deepy/llm/runner.py,sha256=ygS4QIxjWZmQFSE4t-pYatUKUPvra44yf9lQcqX6EUw,14579
+deepy/llm/thinking.py,sha256=_Op1WRu7jJTOB_maEVVOXp6apBeo61THsJ89CaUot_I,779
+deepy/prompts/__init__.py,sha256=bU-z28bvraJ2JhC0XDLXcQHaw5IFC-8VFkZSCgp9nrU,177
+deepy/prompts/compact.py,sha256=fUWxwm1Mw-6F5zLYrkFaRfbwUg8uEQAXQjvvMfiYUHU,4637
+deepy/prompts/rules.py,sha256=Yog9fI4dHhV8dkM4m7FqPh29bh697Kv8pMlb4powgPI,738
+deepy/prompts/runtime_context.py,sha256=f26qizl6FQ1wcH5rhjU9UemFrBfGw-0EcXyB2MN-_RU,3023
+deepy/prompts/system.py,sha256=DYvulpwJZn9WRTcaSGv6XuX77HL8Q1WngVaRumaev3E,2397
+deepy/prompts/tool_docs.py,sha256=qBvdkt0fBU9JgadO3ESvspZelPyDygYSN8G5Z2ZVCSE,464
+deepy/sessions/__init__.py,sha256=yK7N3T-3Xr54afV-P_1knPLLPyV55alLgLEuAEj8SoA,306
+deepy/sessions/jsonl.py,sha256=bAGf1PFfeBKXSLFJ0dMNO9FjVxq6GKju4TbnGd42T0g,11111
+deepy/sessions/manager.py,sha256=SvmhhX9oejSligmuY5o8SbyfMmwe2NBNPRPNDg7kpUw,6373
+deepy/skills.py,sha256=YS7rrKDwRpaEnZPz1sc7GPwjID-ceGqdDAn1qDMFGcM,6237
+deepy/status.py,sha256=I_oVHnzUQYo-c_TzuiakBIulWm1Ij0oCRR5lMUp1LH4,2174
+deepy/tools/__init__.py,sha256=SCYbbivinxZvXfMdj8Tm2VdjPD_R4pqpApXQ0YfcXGU,141
+deepy/tools/agents.py,sha256=CrL_IhQZo-Qnb0mHwHhnZlYjcIJCq7Mm3cd9_r9grVg,11756
+deepy/tools/builtin.py,sha256=CfmJvr5cdojXA5nUh6wtQUpxmFy-CzBtKkr_E-tp19s,76335
+deepy/tools/file_state.py,sha256=eQ8CPI3u9-bHtWJQx59yUAxvTYqXfKnH0u9s2iQJrj4,2513
+deepy/tools/result.py,sha256=hiAh3BvpP1GDy9HNZ34i7HTrFFnnkU-WCJNgZThdzqE,1472
+deepy/tools/shell_utils.py,sha256=rDPydIjnRXmXB-mkgI3c-D3U7Ds_FP5XjOoDTwfxZdY,2736
+deepy/ui/__init__.py,sha256=B8PIjC9VoNM5OnIGnscFbZnL5PTyZNNAtxrAgpeZyoU,179
+deepy/ui/app.py,sha256=_M1ZiCf8CA4c1-hMYcXT875D5hLV-gPMqAY_tomKs94,3566
+deepy/ui/ask_user_question.py,sha256=Vq7ueG2twvUdhc7bUQKfmjOUoZh7GMlopAZ5zmL7yw4,5466
+deepy/ui/exit_summary.py,sha256=mCa_2ZpyFro0rnyiDAIqm9PKWICEE_sl_1CqJT52v2A,4383
+deepy/ui/loading_text.py,sha256=mtfVYk473UYuudzvnLfba6dshef4BS4LqrwtRw8-ngA,2554
+deepy/ui/markdown.py,sha256=HprZ4N2aPZpQDUKmgsDa2USxMIHrYMBRbpMNNjSGaRA,4542
+deepy/ui/message_view.py,sha256=3Sc_Bd2rArHyHjWz0M4qZ3qjcfn0bDG5egsD3e8CM58,17383
+deepy/ui/prompt_buffer.py,sha256=0xXGDacXpMNAUWgsDG0pxL7kwqfpepdrxAZHUvsEO7U,5626
+deepy/ui/prompt_input.py,sha256=TEKj9UboK3NHaHTf_0TFjonBs2bZxOBLjF-2FHkEnQg,9482
+deepy/ui/session_list.py,sha256=HplyK_683Kx36QMd7rztY-YyawgnewP-V4M7wPhyQTs,3720
+deepy/ui/session_picker.py,sha256=Jkrdi6PBGAP32dRu5iCA79Z7vVKx9oQD0mZKuDilhHU,5848
+deepy/ui/slash_commands.py,sha256=gqgjwxTug3I2dYbdp8Z7Ut0LsWHra1B66w9xhskMGVg,2014
+deepy/ui/styles.py,sha256=Kc5xUXBbYpWo7nwbQIiXja4T2ZuBQxy8CLIkiRmVqHY,444
+deepy/ui/terminal.py,sha256=Fx4Mq_LowVtq9PeGfICgUswR4B-YrHQpEl8o8pFg268,32491
+deepy/ui/thinking_state.py,sha256=SnI-GvyS_kBnOk2MuBaWaqydAAhLqk633aPWHpCeXeg,876
+deepy/ui/welcome.py,sha256=DGh_nn87elxP_NmUKEhWpjpJxgsadz3FQLG0ZvPLTLQ,5420
+deepy/update_check.py,sha256=qpnedWkviXUM5iNsxXy0zzG7OKmgSFOJ5zo7TjXvgy4,6224
+deepy/usage.py,sha256=sTu0IvtdA4eTGEVu67aRs9OOleabtlhcK9VgdKhdJnY,7067
+deepy/utils/__init__.py,sha256=AfdNc4yFSXzr7wTJdrq1laZ66gcLR100BNL6ttE6ujQ,462
+deepy/utils/debug_logger.py,sha256=DiGG7PyDB89HrUJzNmE3_ZCrb3jqckBkqzLp4v6uewo,1953
+deepy/utils/error_logger.py,sha256=YnDlNQkd66gaRrULfGeKg5VPKyl4phpVPHWSnvL8AkU,3589
+deepy/utils/json.py,sha256=UsyfiG-j7VXfloSJJ1JWe4qNRPQnZhTCvWdh90a7XrA,793
+deepy/utils/notify.py,sha256=9QHUQKSG3Ga3BeMzRLgV3AR55yz40kTzcmgNKs6Q_Sc,1740
+deepy_cli-0.1.1.dist-info/WHEEL,sha256=fWriCkzqm-pffF5af4gJC9iI5FMFaJTuN9UxxxzOmdY,81
+deepy_cli-0.1.1.dist-info/entry_points.txt,sha256=5xFsmkF0x9FgCI1UB8oMpgJ7g1m9MqGMjaO6rv7nNw4,42
+deepy_cli-0.1.1.dist-info/METADATA,sha256=hEkl7mKFesXNCpV2sR7zrdv-WfBN-UGybud5fhEP1fo,5858
+deepy_cli-0.1.1.dist-info/RECORD,,

deepy_cli-0.1.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.11.14
+Root-Is-Purelib: true
+Tag: py3-none-any

deepy_cli-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+deepy = deepy.cli:main
+