deepy-cli 0.2.21__tar.gz → 0.2.23__tar.gz

{deepy_cli-0.2.21 → deepy_cli-0.2.23}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: deepy-cli
-Version: 0.2.21
+Version: 0.2.23
 Summary: Deepy - Vibe coding for DeepSeek models in your terminal
 Keywords: deepseek,coding-agent,terminal,cli,agents
 Author: kirineko
@@ -41,11 +41,11 @@ Description-Content-Type: text/markdown
 </p>
 
 <p align="center">
-  <a href="https://deepy.kirineko.tech/"><strong>Install Website</strong></a>
+  <a href="https://deepy.kirineko.tech/"><strong>Install</strong></a>
   ·
-  <a href="https://kirineko.github.io/deepy/">GitHub Pages</a>
+  <a href="https://kirineko.github.io/deepy/">Home</a>
   ·
-  <a href="README.zh-CN.md">中文文档</a>
+  <a href="README.zh-CN.md">中文</a>
 </p>
 
 ![Deepy terminal welcome screen](asset/welcome.webp)
@@ -64,7 +64,7 @@ also supporting OpenAI-compatible providers.
   supporting OpenAI-compatible providers such as OpenRouter and Xiaomi MiMo.
 - **Transparent terminal execution**: thinking, tool calls, diffs, shell output,
   usage, and context pressure stay visible in the transcript.
-- **Project memory and continuity**: `AGENTS.md` rules, JSONL sessions,
+- **Project memory and continuity**: `AGENTS.md` rules, local SQLite sessions,
   `/resume`, `/compact`, automatic compacting, and context-window status keep
   long project work recoverable.
 - **Extensible agent ecosystem**: Agent Skills, MCP servers, subagents, and
@@ -283,6 +283,10 @@ deepy sessions show <session-id>
 deepy run "summarize this project"
 ```
 
+Deepy stores active project sessions in a local SQLite session store. Historical
+JSONL session files from older Deepy versions are not imported, listed, or
+resumed by current session commands.
+
 Inside the interactive terminal:
 
 ```text

{deepy_cli-0.2.21 → deepy_cli-0.2.23}/README.md

@@ -9,11 +9,11 @@
 </p>
 
 <p align="center">
-  <a href="https://deepy.kirineko.tech/"><strong>Install Website</strong></a>
+  <a href="https://deepy.kirineko.tech/"><strong>Install</strong></a>
   ·
-  <a href="https://kirineko.github.io/deepy/">GitHub Pages</a>
+  <a href="https://kirineko.github.io/deepy/">Home</a>
   ·
-  <a href="README.zh-CN.md">中文文档</a>
+  <a href="README.zh-CN.md">中文</a>
 </p>
 
 ![Deepy terminal welcome screen](asset/welcome.webp)
@@ -32,7 +32,7 @@ also supporting OpenAI-compatible providers.
   supporting OpenAI-compatible providers such as OpenRouter and Xiaomi MiMo.
 - **Transparent terminal execution**: thinking, tool calls, diffs, shell output,
   usage, and context pressure stay visible in the transcript.
-- **Project memory and continuity**: `AGENTS.md` rules, JSONL sessions,
+- **Project memory and continuity**: `AGENTS.md` rules, local SQLite sessions,
   `/resume`, `/compact`, automatic compacting, and context-window status keep
   long project work recoverable.
 - **Extensible agent ecosystem**: Agent Skills, MCP servers, subagents, and
@@ -251,6 +251,10 @@ deepy sessions show <session-id>
 deepy run "summarize this project"
 ```
 
+Deepy stores active project sessions in a local SQLite session store. Historical
+JSONL session files from older Deepy versions are not imported, listed, or
+resumed by current session commands.
+
 Inside the interactive terminal:
 
 ```text

{deepy_cli-0.2.21 → deepy_cli-0.2.23}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "deepy-cli"
-version = "0.2.21"
+version = "0.2.23"
 description = "Deepy - Vibe coding for DeepSeek models in your terminal"
 readme = "README.md"
 authors = [

{deepy_cli-0.2.21 → deepy_cli-0.2.23}/src/deepy/__init__.py

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

{deepy_cli-0.2.21 → deepy_cli-0.2.23}/src/deepy/cli.py

@@ -29,9 +29,10 @@ from .config import (
 )
 from .config.settings import DEFAULT_UI_THEME, UI_THEMES
 from .errors import format_error_display
+from .llm.cache_context import format_cache_usage
 from .llm.provider import build_provider_bundle
 from .llm.runner import DEFAULT_MAX_TURNS, run_prompt_once
-from .sessions import DeepyJsonlSession, list_session_entries
+from .sessions import DeepySession, list_session_entries
 from .skills import discover_skills, find_skill, format_skills_for_terminal, read_skill_body
 from .status import build_status_report, format_status_report, status_report_to_dict
 from .usage import TokenUsage, format_usage_line, usage_from_run_result
@@ -593,11 +594,11 @@ def _cmd_sessions(args: argparse.Namespace) -> int:
         for entry in entries:
             print(
                 f"{entry.id}\tupdated={entry.updated_at}\thistory_estimate={entry.active_tokens}\t"
-                f"{format_usage_line(entry.usage)}"
+                f"{format_usage_line(entry.usage)}\tcache={_format_session_cache(entry)}"
             )
         return 0
     if args.sessions_command == "show":
-        session = DeepyJsonlSession.open(Path.cwd(), args.session_id)
+        session = DeepySession.open(Path.cwd(), args.session_id)
         items = asyncio.run(session.get_items())
         entry = next(
             (item for item in list_session_entries(Path.cwd()) if item.id == args.session_id),
@@ -608,6 +609,11 @@ def _cmd_sessions(args: argparse.Namespace) -> int:
                 {
                     "session_id": args.session_id,
                     "usage": entry.usage if entry is not None else None,
+                    "cache_prefix_generation": entry.cache_prefix_generation
+                    if entry is not None
+                    else 0,
+                    "cache_break_reason": entry.cache_break_reason if entry is not None else None,
+                    "cache_usage": entry.cache_usage if entry is not None else None,
                     "items": items,
                 }
             )
@@ -616,6 +622,20 @@ def _cmd_sessions(args: argparse.Namespace) -> int:
     return 1
 
 
+def _format_session_cache(entry: Any) -> str:
+    parts = []
+    generation = getattr(entry, "cache_prefix_generation", 0)
+    if generation:
+        parts.append(f"gen {generation}")
+    usage = format_cache_usage(getattr(entry, "cache_usage", None))
+    if usage != "unknown":
+        parts.append(usage)
+    reason = getattr(entry, "cache_break_reason", None)
+    if reason:
+        parts.append(f"break {reason}")
+    return " · ".join(parts) if parts else "unknown"
+
+
 def _cmd_skills(args: argparse.Namespace) -> int:
     if args.skills_command == "list":
         print(format_skills_for_terminal(discover_skills(Path.cwd())))

{deepy_cli-0.2.21 → deepy_cli-0.2.23}/src/deepy/config/__init__.py

@@ -10,6 +10,7 @@ from .settings import (
     DEFAULT_PROVIDER,
     DEFAULT_RESERVED_CONTEXT_TOKENS,
     DEFAULT_UI_THEME,
+    DEFAULT_UI_VIEW_MODE,
     DEFAULT_WEB_SEARCH_SEARXNG_URL,
     DEFAULT_XIAOMI_BASE_URL,
     DeepSeekModelInfo,
@@ -26,6 +27,7 @@ from .settings import (
     TestShellToolConfig,
     UI_THEME_OPTIONS,
     UI_THEMES,
+    UI_VIEW_MODES,
     ToolsConfig,
     UiConfig,
     XIAOMI_MODEL_CATALOG,
@@ -43,6 +45,7 @@ from .settings import (
     is_valid_thinking_mode,
     is_valid_thinking_mode_for_provider,
     is_valid_ui_theme,
+    is_valid_ui_view_mode,
     is_valid_reasoning_mode,
     load_settings,
     mask_secret,
@@ -53,6 +56,7 @@ from .settings import (
     update_config_model_settings,
     update_config_input_suggestions_enabled,
     update_config_theme,
+    update_config_view_mode,
     ui_theme_from_selection,
     ui_theme_number,
     write_config,
@@ -68,6 +72,7 @@ __all__ = [
     "DEFAULT_PROVIDER",
     "DEFAULT_RESERVED_CONTEXT_TOKENS",
     "DEFAULT_UI_THEME",
+    "DEFAULT_UI_VIEW_MODE",
     "DEFAULT_WEB_SEARCH_SEARXNG_URL",
     "DEFAULT_XIAOMI_BASE_URL",
     "DeepSeekModelInfo",
@@ -84,6 +89,7 @@ __all__ = [
     "TestShellToolConfig",
     "UI_THEME_OPTIONS",
     "UI_THEMES",
+    "UI_VIEW_MODES",
     "ToolsConfig",
     "UiConfig",
     "XIAOMI_MODEL_CATALOG",
@@ -101,6 +107,7 @@ __all__ = [
     "is_valid_thinking_mode",
     "is_valid_thinking_mode_for_provider",
     "is_valid_ui_theme",
+    "is_valid_ui_view_mode",
     "is_valid_reasoning_mode",
     "load_settings",
     "mask_secret",
@@ -111,6 +118,7 @@ __all__ = [
     "update_config_model_settings",
     "update_config_input_suggestions_enabled",
     "update_config_theme",
+    "update_config_view_mode",
     "ui_theme_from_selection",
     "ui_theme_number",
     "write_config",

{deepy_cli-0.2.21 → deepy_cli-0.2.23}/src/deepy/config/settings.py

@@ -23,6 +23,7 @@ DEFAULT_MCP_CLEANUP_TIMEOUT_SECONDS = 10.0
 DEFAULT_MCP_CLIENT_SESSION_TIMEOUT_SECONDS = 30.0
 DEFAULT_MCP_CACHE_TOOLS_LIST = True
 DEFAULT_INPUT_SUGGESTIONS_ENABLED = True
+DEFAULT_UI_VIEW_MODE = "concise"
 DEFAULT_PROVIDER = "deepseek"
 DEFAULT_OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1"
 DEFAULT_XIAOMI_BASE_URL = "https://api.xiaomimimo.com/v1"
@@ -47,6 +48,7 @@ THINKING_MODES = set(DEEPSEEK_REASONING_MODES) | set(SWITCH_ONLY_THINKING_MODES)
 PROVIDERS = {"deepseek", "openrouter", "xiaomi"}
 UI_THEMES = {"dark", "light"}
 UI_THEME_OPTIONS = (("1", "dark"), ("2", "light"))
+UI_VIEW_MODES = {"concise", "full"}
 
 
 @dataclass(frozen=True)
@@ -562,6 +564,7 @@ class UiConfig:
     theme: str = DEFAULT_UI_THEME
     theme_configured: bool = False
     input_suggestions_enabled: bool = DEFAULT_INPUT_SUGGESTIONS_ENABLED
+    view_mode: str = DEFAULT_UI_VIEW_MODE
 
     @classmethod
     def from_mapping(cls, raw: Mapping[str, Any]) -> Self:
@@ -570,19 +573,24 @@ class UiConfig:
             raw.get("input_suggestions_enabled"),
             DEFAULT_INPUT_SUGGESTIONS_ENABLED,
         )
+        view_mode = _as_str(raw.get("view_mode"), DEFAULT_UI_VIEW_MODE)
+        if view_mode not in UI_VIEW_MODES:
+            view_mode = DEFAULT_UI_VIEW_MODE
         if isinstance(theme, str) and theme.strip() == "auto":
             return cls(
                 theme=DEFAULT_UI_THEME,
                 theme_configured=True,
                 input_suggestions_enabled=input_suggestions_enabled,
+                view_mode=view_mode,
             )
         if isinstance(theme, str) and theme.strip() in UI_THEMES:
             return cls(
                 theme=theme.strip(),
                 theme_configured=True,
                 input_suggestions_enabled=input_suggestions_enabled,
+                view_mode=view_mode,
             )
-        return cls(input_suggestions_enabled=input_suggestions_enabled)
+        return cls(input_suggestions_enabled=input_suggestions_enabled, view_mode=view_mode)
 
 
 @dataclass(frozen=True)
@@ -649,6 +657,10 @@ def is_valid_ui_theme(value: str) -> bool:
     return value in UI_THEMES
 
 
+def is_valid_ui_view_mode(value: str) -> bool:
+    return value in UI_VIEW_MODES
+
+
 def is_supported_deepseek_model(value: str) -> bool:
     return value in SUPPORTED_DEEPSEEK_MODELS
 
@@ -758,6 +770,7 @@ def write_config(
         "ui": {
             "theme": theme,
             "input_suggestions_enabled": DEFAULT_INPUT_SUGGESTIONS_ENABLED,
+            "view_mode": DEFAULT_UI_VIEW_MODE,
         },
     }
     path.parent.mkdir(parents=True, exist_ok=True)
@@ -846,6 +859,20 @@ def update_config_input_suggestions_enabled(config_path: Path, enabled: bool) ->
     _write_private_toml(path, raw)
 
 
+def update_config_view_mode(config_path: Path, view_mode: str) -> None:
+    if not is_valid_ui_view_mode(view_mode):
+        raise ValueError("View mode must be one of: concise, full.")
+    path = config_path.expanduser()
+    if path.suffix == ".json":
+        raise ValueError("Deepy only supports TOML config files; JSON config is not supported.")
+    raw = _read_toml_mapping(path)
+    ui = raw.get("ui")
+    ui_map = dict(ui) if isinstance(ui, Mapping) else {}
+    ui_map["view_mode"] = view_mode
+    raw["ui"] = ui_map
+    _write_private_toml(path, raw)
+
+
 def _read_toml_mapping(path: Path) -> dict[str, Any]:
     if not path.exists():
         return {}

deepy_cli-0.2.23/src/deepy/data/tools/Read.md

@@ -0,0 +1,17 @@
+## Read
+
+Read one or more files or directories.
+
+Args:
+- `path`: single target path.
+- `files`: array of read targets for batch reads.
+- Optional range controls: `range` (`"20-80"`), `head`, `tail`, `offset`, `limit`.
+- Optional `pages` for PDF page ranges.
+
+Use `Read` before replacing an existing whole file with `Write`, and whenever
+you need exact context for `Update`. When several files are relevant, prefer one
+batch call with `files` instead of serial single-file reads.
+
+Text output includes line numbers and total line metadata. Successful text reads
+record runtime-managed read state for later `Write` or `Update`; the model does
+not need to copy snapshot ids, tokens, or content hashes.

{deepy_cli-0.2.21 → deepy_cli-0.2.23}/src/deepy/data/tools/Search.md

@@ -11,7 +11,7 @@ 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
+- Use `output_mode: "files"` for broad discovery, then `Read` 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.

deepy_cli-0.2.23/src/deepy/data/tools/Update.md

@@ -0,0 +1,19 @@
+## Update
+
+Apply exact text replacements to one or more files.
+
+Args:
+- Single edit: `path`, `old`, `new`.
+- Multiple edits in one file: `path`, `edits: [{old, new}]`.
+- Multiple files: `edits: [{path, old, new}]`.
+- Optional `replace_all` and `expected_occurrences`.
+
+Use `Update` for existing code, tests, docs, and config when the current text is
+known. The `old` text is whitespace-sensitive plain text and must match exactly.
+For broad replacements, use `replace_all=true` with `expected_occurrences`.
+
+Deepy stages and validates all edits in a call before writing. If any edit is
+stale, missing, ambiguous, count-mismatched, or unsupported, no file is changed
+and the result identifies the failing edit. No-op edits are skipped when other
+edits in the same call make real changes; an all-no-op call succeeds with no-op
+metadata and does not write files.

deepy_cli-0.2.23/src/deepy/data/tools/Write.md

@@ -0,0 +1,12 @@
+## Write
+
+Create a new text file or replace a whole existing text file.
+
+Args:
+- `path`: target file path.
+- `content`: complete file content.
+- `overwrite`: set to `true` only for intentional existing-file replacement.
+
+For existing files, call `Read` first so Deepy can verify the file is fresh
+before replacement. Use `Update` for exact targeted edits instead of rewriting a
+whole file.