ripperdoc 0.3.1__py3-none-any.whl → 0.3.2__py3-none-any.whl

ripperdoc/cli/ui/provider_options.py

@@ -81,39 +81,20 @@ def default_model_for_protocol(protocol: ProviderType) -> str:
 
 KNOWN_PROVIDERS = ProviderRegistry(
     providers=[
-        ProviderOption(
-            key="deepseek",
-            protocol=ProviderType.OPENAI_COMPATIBLE,
-            default_model="deepseek-chat",
-            model_suggestions=("deepseek-chat", "deepseek-reasoner"),
-            default_api_base="https://api.deepseek.com/v1",
-        ),
+        # === Major Cloud Providers ===
         ProviderOption(
             key="openai",
             protocol=ProviderType.OPENAI_COMPATIBLE,
             default_model="gpt-4o-mini",
             model_suggestions=(
-                "gpt-5.1",
-                "gpt-5.1-chat",
-                "gpt-5.1-codex",
                 "gpt-4o",
+                "gpt-4o-mini",
                 "gpt-4-turbo",
                 "o1-preview",
                 "o1-mini",
             ),
             default_api_base="https://api.openai.com/v1",
         ),
-        ProviderOption(
-            key="openrouter",
-            protocol=ProviderType.OPENAI_COMPATIBLE,
-            default_model="openai/gpt-4o-mini",
-            model_suggestions=(
-                "openai/gpt-4o-mini",
-                "meta-llama/llama-3.1-8b-instruct",
-                "google/gemini-flash-1.5",
-            ),
-            default_api_base="https://openrouter.ai/api/v1",
-        ),
         ProviderOption(
             key="anthropic",
             protocol=ProviderType.ANTHROPIC,
@@ -122,118 +103,277 @@ KNOWN_PROVIDERS = ProviderRegistry(
                 "claude-3-5-sonnet-20241022",
                 "claude-3-5-haiku-20241022",
                 "claude-3-opus-20240229",
-                "claude-3-sonnet-20240229",
-                "claude-3-haiku-20240307",
             ),
             default_api_base=None,
         ),
         ProviderOption(
-            key="openai_compatible",
+            key="google",
+            protocol=ProviderType.GEMINI,
+            default_model="gemini-1.5-pro",
+            model_suggestions=(
+                "gemini-2.0-flash-exp",
+                "gemini-1.5-pro",
+                "gemini-1.5-flash",
+            ),
+            default_api_base="https://generativelanguage.googleapis.com/v1beta",
+        ),
+        # === Aggregators & Open Router ===
+        ProviderOption(
+            key="openrouter",
             protocol=ProviderType.OPENAI_COMPATIBLE,
-            default_model="gpt-4o-mini",
+            default_model="openai/gpt-4o-mini",
             model_suggestions=(
-                "gpt-4o-mini",
-                "gpt-4o",
-                "gpt-3.5-turbo",
+                "openai/gpt-4o-mini",
+                "anthropic/claude-3.5-sonnet",
+                "google/gemini-flash-1.5",
+                "meta-llama/llama-3.1-70b-instruct",
             ),
-            default_api_base=None,
+            default_api_base="https://openrouter.ai/api/v1",
         ),
         ProviderOption(
-            key="mistralai",
+            key="poe",
             protocol=ProviderType.OPENAI_COMPATIBLE,
-            default_model="mistral-small-creative",
+            default_model="gpt-4o",
             model_suggestions=(
-                "mistral-small-creative",
-                "mistral-large-latest",
-                "mistral-small-latest",
-                "devstral-2512",
-                "ministral-14b-2512",
-                "ministral-8b-2512",
-                "codestral-latest",
-                "pixtral-large-latest",
+                "gpt-4o",
+                "claude-3.5-sonnet",
+                "gemini-1.5-pro",
+                "mistral-large",
             ),
-            default_api_base="https://api.mistral.ai/v1",
+            default_api_base="https://api.poe.com/v1",
         ),
+        # === Chinese Providers ===
         ProviderOption(
-            key="google",
-            protocol=ProviderType.GEMINI,
-            default_model="gemini-1.5-pro",
+            key="deepseek",
+            protocol=ProviderType.ANTHROPIC,
+            default_model="deepseek-chat",
             model_suggestions=(
-                "gemini-2.5-pro",
-                "gemini-2.5-flash-lite",
-                "gemini-2.5-flash",
-                "gemini-3-pro-preview",
-                "gemini-3-flash-preview",
+                "deepseek-chat",
+                "deepseek-reasoner",
             ),
-            default_api_base="https://generativelanguage.googleapis.com/v1beta",
+            default_api_base="https://api.deepseek.com/v1",
+        ),
+        ProviderOption(
+            key="zhipu",
+            protocol=ProviderType.ANTHROPIC,
+            default_model="glm-4-flash",
+            model_suggestions=(
+                "glm-4-plus",
+                "glm-4-flash",
+                "glm-4.7",
+                "glm-4.6",
+                "glm-4.5",
+                "glm-4-air",
+            ),
+            default_api_base="https://open.bigmodel.cn/api/anthropic",
         ),
         ProviderOption(
             key="moonshot",
             protocol=ProviderType.OPENAI_COMPATIBLE,
-            default_model="kimi-k2-turbo-preview",
+            default_model="moonshot-v1-auto",
             model_suggestions=(
-                "kimi-k2-0905-preview",
+                "moonshot-v1-auto",
                 "kimi-k2-0711-preview",
                 "kimi-k2-turbo-preview",
                 "kimi-k2-thinking",
-                "kimi-k2-thinking-turbo",
+                "kimi-k2-0905-preview",
             ),
             default_api_base="https://api.moonshot.cn/v1",
         ),
         ProviderOption(
-            key="qwen",
+            key="volcengine",
             protocol=ProviderType.OPENAI_COMPATIBLE,
-            default_model="qwen-turbo",
+            default_model="doubao-pro-32k",
+            model_suggestions=(
+                # Doubao Pro 系列
+                "doubao-pro-32k",
+                "doubao-pro-256k",
+                "doubao-pro-32k-functioncall-241028",
+                "doubao-pro-32k-character-241215",
+                # Doubao 1.5 系列
+                "Doubao-1.5-pro",
+                "doubao-1.5-pro-32k",
+                "doubao-1.5-pro-32k-character",
+                "Doubao-1.5-pro-256k",
+                "Doubao-1.5-vision-pro",
+                "doubao-1.5-vision-pro",
+                "Doubao-1.5-lite-32k",
+                # Doubao Lite 系列
+                "Doubao-lite-32k",
+                "Doubao-lite-128k",
+                "Doubao-lite-4k-character-240828",
+                "Doubao-lite-32k-character-241015",
+                # DeepSeek 系列
+                "DeepSeek-V3",
+                "DeepSeek-R1",
+                "DeepSeek-R1-Distill-Qwen-32B",
+                "DeepSeek-R1-Distill-Qwen-7B",
+                # Vision 系列
+                "Doubao-vision-lite-32k",
+            ),
+            default_api_base="https://ark.cn-beijing.volces.com/api/v3",
+        ),
+        ProviderOption(
+            key="aliyun",
+            protocol=ProviderType.OPENAI_COMPATIBLE,
+            default_model="qwen-plus",
             model_suggestions=(
-                "qwen-turbo",
                 "qwen-plus",
+                "qwen-turbo",
                 "qwen-max",
-                "qwen2.5-32b",
-                "qwen2.5-coder-32b",
+                "qwen-coder-plus",
             ),
             default_api_base="https://dashscope.aliyuncs.com/compatible-mode/v1",
         ),
         ProviderOption(
-            key="zhipu",
+            key="minimax",
+            protocol=ProviderType.OPENAI_COMPATIBLE,
+            default_model="abab6.5s",
+            model_suggestions=(
+                # abab 系列
+                "abab6.5s",
+                "abab6.5g",
+                "abab6.5t",
+                "abab6",
+                "abab5.5s",
+                "abab5",
+                # 01 系列
+                "minimax-01",
+                # M2 系列
+                "MiniMax-M2",
+                "MiniMax-M2-Stable",
+            ),
+            default_api_base="https://api.minimax.chat/v1",
+        ),
+        ProviderOption(
+            key="z.ai",
             protocol=ProviderType.OPENAI_COMPATIBLE,
             default_model="glm-4-flash",
             model_suggestions=(
+                "glm-4-flash",
                 "glm-4-plus",
-                "glm-4-air-250414",
-                "glm-4-airx",
-                "glm-4-long",
-                "glm-4-flashx",
-                "glm-4-flash-250414",
                 "glm-4.6",
-                "glm-4.5",
-                "glm-4.5-air",
-                "glm-4.5-airx",
-                "glm-4.5-x",
-                "glm-4.5-flash",
             ),
-            default_api_base="https://open.bigmodel.cn/api/paas/v4",
+            default_api_base="https://api.z.ai/api/paas/v4",
         ),
+        # === Western AI Companies ===
         ProviderOption(
-            key="minimax",
+            key="mistralai",
             protocol=ProviderType.OPENAI_COMPATIBLE,
-            default_model="MiniMax-M2",
-            model_suggestions=("MiniMax-M2",),
-            default_api_base="https://api.minimax.chat/v1",
+            default_model="mistral-large-latest",
+            model_suggestions=(
+                # Mistral Chat 系列
+                "mistral-large-latest",
+                "mistral-small-latest",
+                "mistral-nemo",
+                "mistral-mini",
+                # 免费模型
+                "mistral-7b",
+                "mistral-8b",
+                # Mistral Code 系列
+                "codestral-latest",
+                # 多模态
+                "pixtral-large-latest",
+            ),
+            default_api_base="https://api.mistral.ai/v1",
+        ),
+        ProviderOption(
+            key="groq",
+            protocol=ProviderType.OPENAI_COMPATIBLE,
+            default_model="llama-3.3-70b-versatile",
+            model_suggestions=(
+                # Llama 系列
+                "llama-3.3-70b-versatile",
+                "llama-3.1-8b-instant",
+                "llama3-70b-8192",
+                "llama3-8b-8192",
+                # Gemma 系列
+                "gemma2-9b-it",
+                "gemma-7b-it",
+                # Mistral 系列
+                "mistral-saba-24b",
+                "mixtral-8x7b-32768",
+            ),
+            default_api_base="https://api.groq.com/openai/v1",
+        ),
+        ProviderOption(
+            key="grok",
+            protocol=ProviderType.OPENAI_COMPATIBLE,
+            default_model="grok-3",
+            model_suggestions=(
+                "grok-4",
+                "grok-3",
+                "grok-3-fast",
+                "grok-3-mini",
+                "grok-3-mini-fast",
+            ),
+            default_api_base="https://api.x.ai/v1",
+        ),
+        ProviderOption(
+            key="cohere",
+            protocol=ProviderType.OPENAI_COMPATIBLE,
+            default_model="command-r-plus-08-2024",
+            model_suggestions=(
+                "command-r-plus-08-2024",
+                "command-r-08-2024",
+                "command-r7b-12-2024",
+            ),
+            default_api_base="https://api.cohere.ai/v1",
+        ),
+        ProviderOption(
+            key="together",
+            protocol=ProviderType.OPENAI_COMPATIBLE,
+            default_model="meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo",
+            model_suggestions=(
+                "meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo",
+                "Qwen/Qwen2.5-72B-Instruct-Turbo",
+                "mistralai/Mixtral-8x7B-Instruct-v0.1",
+            ),
+            default_api_base="https://api.together.xyz/v1",
+        ),
+        ProviderOption(
+            key="perplexity",
+            protocol=ProviderType.OPENAI_COMPATIBLE,
+            default_model="llama-3.1-sonar-small-128k-online",
+            model_suggestions=(
+                "llama-3.1-sonar-small-128k-online",
+                "llama-3.1-sonar-large-128k-online",
+            ),
+            default_api_base="https://api.perplexity.ai",
         ),
         ProviderOption(
             key="siliconflow",
             protocol=ProviderType.OPENAI_COMPATIBLE,
-            default_model="deepseek-ai/DeepSeek-V3.2",
+            default_model="Qwen/Qwen2.5-72B-Instruct",
             model_suggestions=(
-                "deepseek-ai/DeepSeek-V3.2",
-                "Qwen/Qwen2.5-32B-Instruct",
-                "Qwen/Qwen3-Coder-480B-A35B-Instruct",
-                "zai-org/GLM-4.6",
-                "moonshotai/Kimi-K2-Thinking",
-                "MiniMaxAI/MiniMax-M2",
+                "Qwen/Qwen2.5-72B-Instruct",
+                "deepseek-ai/DeepSeek-V3",
+                "01-ai/Yi-1.5-34B-Chat",
             ),
             default_api_base="https://api.siliconflow.cn/v1",
         ),
+        # === Generic / Custom ===
+        ProviderOption(
+            key="openai_compatible",
+            protocol=ProviderType.OPENAI_COMPATIBLE,
+            default_model="gpt-4o-mini",
+            model_suggestions=(
+                "gpt-4o-mini",
+                "gpt-4o",
+                "llama-3.1-70b",
+            ),
+            default_api_base=None,
+        ),
+        ProviderOption(
+            key="anthropic_compatible",
+            protocol=ProviderType.ANTHROPIC,
+            default_model="claude-3-5-sonnet-20241022",
+            model_suggestions=(
+                "claude-3-5-sonnet-20241022",
+                "claude-3-5-haiku-20241022",
+            ),
+            default_api_base=None,
+        ),
     ],
     default_key="deepseek",
 )

ripperdoc/cli/ui/rich_ui.py

@@ -24,7 +24,7 @@ from prompt_toolkit.shortcuts.prompt import CompleteStyle
 from prompt_toolkit.styles import Style
 
 from ripperdoc.core.config import get_global_config, provider_protocol, model_supports_vision
-from ripperdoc.core.default_tools import get_default_tools
+from ripperdoc.core.default_tools import filter_tools_by_names, get_default_tools
 from ripperdoc.core.theme import get_theme_manager
 from ripperdoc.core.query import query, QueryContext
 from ripperdoc.core.system_prompt import build_system_prompt
@@ -84,6 +84,7 @@ from ripperdoc.utils.messages import (
 from ripperdoc.utils.log import enable_session_file_logging, get_logger
 from ripperdoc.utils.path_ignore import build_ignore_filter
 from ripperdoc.cli.ui.file_mention_completer import FileMentionCompleter
+from ripperdoc.cli.ui.tips import get_random_tip
 from ripperdoc.utils.message_formatting import stringify_message_content
 from ripperdoc.utils.image_utils import read_image_as_base64, is_image_file
 
@@ -706,9 +707,10 @@ class RichUI:
         dynamic_tools = await load_dynamic_mcp_tools_async(self.project_path)
 
         if dynamic_tools and self.query_context:
-            self.query_context.tools = merge_tools_with_dynamic(
-                self.query_context.tools, dynamic_tools
-            )
+            merged_tools = merge_tools_with_dynamic(self.query_context.tools, dynamic_tools)
+            if self.allowed_tools is not None:
+                merged_tools = filter_tools_by_names(merged_tools, self.allowed_tools)
+            self.query_context.tools = merged_tools
 
         logger.debug(
             "[ui] Prepared tools and MCP servers",
@@ -1557,13 +1559,9 @@ class RichUI:
         console.print(create_welcome_panel())
         console.print()
 
-        # Display status
-        console.print(create_status_bar())
-        console.print()
-        console.print(
-            "[dim]Tip: type '/' then press Tab to see available commands. Type '@' to mention files. "
-            "Press Alt+Enter for newline. Press Tab to toggle thinking mode.[/dim]\n"
-        )
+        # Display random tip
+        random_tip = get_random_tip()
+        console.print(f"[dim italic]💡 {random_tip}[/dim italic]\n")
 
         session = self.get_prompt_session()
         logger.info(

ripperdoc/cli/ui/tips.py

@@ -0,0 +1,89 @@
+"""Random tips for Ripperdoc CLI.
+
+This module provides a collection of tips and tricks for using Ripperdoc,
+displayed randomly at startup to help users discover features.
+"""
+
+import random
+from typing import List
+
+# Tips database - organized by category
+TIPS: List[str] = [
+    # Navigation & Input
+    "Press Tab to toggle thinking mode - see the AI's full reasoning process.",
+    "Use @ followed by a file path to reference files in your conversation.",
+    "Press Alt+Enter to insert newlines in your input for multi-line prompts.",
+    "Type / then press Tab to see all available slash commands.",
+    "Double-press Ctrl+C to quickly exit Ripperdoc.",
+
+    # Slash Commands
+    "Use /help to see all available commands and get started.",
+    "Use /clear to clear the current conversation and start fresh.",
+    "Use /compact to compress conversation history when tokens run low.",
+    "Use /status to check your session statistics and context usage.",
+    "Use /cost to estimate token costs for your current session.",
+    "Use /theme to switch between different visual themes (light, dark, etc.).",
+    "Use /models to list and switch between different AI models.",
+    "Use /tools to see what tools are available to the AI agent.",
+    "Use /agents to manage specialized AI agents for specific tasks.",
+    "Use /config to view or modify your Ripperdoc configuration.",
+    "Use /todos to track tasks and manage your todo list.",
+
+    # Advanced Features
+    "Use /plan to enter planning mode for complex tasks requiring exploration.",
+    "Use /memory to enable persistent memory across sessions.",
+    "Use /skills to load and manage custom skill packages.",
+    "Use /mcp to configure Model Context Protocol servers for extended capabilities.",
+    "Use /permissions to adjust tool permission settings.",
+    "Use /context to manage context window and conversation history.",
+    "Use /resume to continue your most recent conversation.",
+
+    # Productivity
+    "Use /exit to cleanly shut down Ripperdoc and save your session.",
+    "Use /doctor to diagnose common issues and configuration problems.",
+    "Use /hooks to manage custom hooks for session lifecycle events.",
+
+    # File Operations
+    "Reference images with @path/to/image.png if your model supports vision.",
+    "Use /tasks to view and manage background tasks.",
+
+    # Hidden/Power User Features
+    "Create custom commands in .ripperdoc/commands/ for reusable workflows.",
+    "Configure hooks in .ripperdoc/hooks/ to automate session events.",
+    "Use --yolo mode to skip all permission prompts (use with caution!).",
+    "Pipe stdin into Ripperdoc: echo 'your query' | ripperdoc",
+    "Use -p flag for single-shot queries: ripperdoc -p 'your prompt'",
+
+    # MCP & Extensions
+    "Connect to MCP servers to extend Ripperdoc with external tools and data sources.",
+    "Use /skills to enable specialized capabilities like PDF or spreadsheet processing.",
+
+    # Session Management
+    "Sessions are automatically saved in .ripperdoc/sessions/.",
+    "Use /continue or -c flag to resume your last conversation.",
+
+    # Cost & Performance
+    "Enable auto-compact in settings to automatically manage token usage.",
+    "Use /cost to monitor token consumption and estimate API costs.",
+
+    # Tips about Tips
+    "A new tip appears each time you start Ripperdoc - try restarting to see more!",
+]
+
+
+def get_random_tip() -> str:
+    """Get a random tip from the tips database.
+
+    Returns:
+        A randomly selected tip string.
+    """
+    return random.choice(TIPS)
+
+
+def get_tips_count() -> int:
+    """Get the total number of tips available.
+
+    Returns:
+        The count of tips in the database.
+    """
+    return len(TIPS)