minimalcode 1.5.2__py3-none-any.whl

minimalcode/defaults.json

@@ -0,0 +1,491 @@
+{
+  "provider": "deepseek",
+  "model": "deepseek-flash",
+  "thinking": "high",
+  "max_turns": 1000,
+  "session": {
+    "save": true
+  },
+  "shell": {
+    "path": null,
+    "timeout_seconds": 120,
+    "max_output_chars": 60000
+  },
+  "tools": {
+    "allow": null,
+    "allow_outside_workspace": false,
+    "max_file_chars": 160000,
+    "max_file_bytes": 5000000,
+    "max_results": 200,
+    "max_parallel": 4
+  },
+  "sandbox": {
+    "enabled": false,
+    "backend": "local",
+    "allowed_roots": [],
+    "network_policy": "deny",
+    "allowed_hosts": [],
+    "timeout_seconds": 120,
+    "max_output_chars": 60000,
+    "allow_sensitive_files": false,
+    "max_memory_mb": 0,
+    "max_processes": 0,
+    "docker_image": "alpine:3"
+  },
+  "subagent": {
+    "enabled": true,
+    "max_depth": 2,
+    "max_turns": 40,
+    "max_parallel": 4,
+    "timeout_seconds": 900
+  },
+  "context": {
+    "compact_at": 0.8,
+    "keep_messages": 12,
+    "max_instruction_chars": 60000
+  },
+  "output": {
+    "markdown_highlight": true,
+    "theme": "dark"
+  },
+  "providers": {
+    "deepseek": {
+      "protocol": "openai_responses",
+      "base_url": "https://api.deepseek.com/v1",
+      "api_key_env": "DEEPSEEK_API_KEY",
+      "context_window": 1000000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "send_reasoning_effort": true,
+      "headers": {},
+      "extra_body": {},
+      "web_tools": {
+        "enabled": true,
+        "base_url": "https://api.deepseek.com/v1/tools",
+        "search_path": "search",
+        "fetch_path": "fetch",
+        "timeout_seconds": 60,
+        "default_count": 10,
+        "max_count": 50,
+        "max_content_chars": 120000,
+        "headers": {}
+      },
+      "vision": {
+        "enabled": true,
+        "base_url": "https://api.deepseek.com/v1",
+        "model": "deepseek-flash",
+        "timeout_seconds": 120,
+        "max_image_bytes": 33554432,
+        "max_chars": 8000,
+        "detail": "auto",
+        "headers": {}
+      }
+    },
+    "deepseek-anthropic": {
+      "protocol": "anthropic_messages",
+      "base_url": "https://api.deepseek.com/anthropic",
+      "api_key_env": "DEEPSEEK_API_KEY",
+      "model": "deepseek-flash",
+      "context_window": 1000000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "send_reasoning_effort": true,
+      "max_tokens": 8192,
+      "headers": {},
+      "extra_body": {}
+    },
+    "deepseek-web": {
+      "protocol": "deepseek_web",
+      "base_url": "https://chat.deepseek.com",
+      "api_key_env": "DEEPSEEK_WEB_TOKEN",
+      "model": "default",
+      "cookie_env": "DEEPSEEK_WEB_COOKIE",
+      "context_window": 262000,
+      "timeout_seconds": 300,
+      "stream": true,
+      "tool_mode": "text",
+      "model_type": "default",
+      "web_search": false,
+      "headers": {
+        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
+        "Origin": "https://chat.deepseek.com",
+        "Referer": "https://chat.deepseek.com/"
+      },
+      "extra_body": {}
+    },
+    "openai": {
+      "protocol": "openai_responses",
+      "base_url": "https://api.openai.com/v1",
+      "api_key_env": "OPENAI_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "headers": {},
+      "extra_body": {}
+    },
+    "anthropic": {
+      "protocol": "anthropic_messages",
+      "base_url": "https://api.anthropic.com/v1",
+      "api_key_env": "ANTHROPIC_API_KEY",
+      "context_window": 200000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "max_tokens": 8192,
+      "headers": {},
+      "extra_body": {}
+    },
+    "google": {
+      "protocol": "openai_chat",
+      "base_url": "https://generativelanguage.googleapis.com/v1beta/openai",
+      "api_key_env": "GEMINI_API_KEY",
+      "context_window": 1000000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "openrouter": {
+      "protocol": "openai_chat",
+      "base_url": "https://openrouter.ai/api/v1",
+      "api_key_env": "OPENROUTER_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "groq": {
+      "protocol": "openai_chat",
+      "base_url": "https://api.groq.com/openai/v1",
+      "api_key_env": "GROQ_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "mistral": {
+      "protocol": "openai_chat",
+      "base_url": "https://api.mistral.ai/v1",
+      "api_key_env": "MISTRAL_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "xai": {
+      "protocol": "openai_chat",
+      "base_url": "https://api.x.ai/v1",
+      "api_key_env": "XAI_API_KEY",
+      "context_window": 256000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "moonshot": {
+      "protocol": "openai_chat",
+      "base_url": "https://api.moonshot.cn/v1",
+      "api_key_env": "MOONSHOT_API_KEY",
+      "context_window": 256000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "zhipu": {
+      "protocol": "openai_chat",
+      "base_url": "https://open.bigmodel.cn/api/paas/v4",
+      "api_key_env": "ZHIPUAI_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "dashscope": {
+      "protocol": "openai_chat",
+      "base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1",
+      "api_key_env": "DASHSCOPE_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "siliconflow": {
+      "protocol": "openai_chat",
+      "base_url": "https://api.siliconflow.cn/v1",
+      "api_key_env": "SILICONFLOW_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "together": {
+      "protocol": "openai_chat",
+      "base_url": "https://api.together.ai/v1",
+      "api_key_env": "TOGETHER_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "fireworks": {
+      "protocol": "openai_chat",
+      "base_url": "https://api.fireworks.ai/inference/v1",
+      "api_key_env": "FIREWORKS_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "perplexity": {
+      "protocol": "openai_chat",
+      "base_url": "https://api.perplexity.ai",
+      "api_key_env": "PERPLEXITY_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "cerebras": {
+      "protocol": "openai_chat",
+      "base_url": "https://api.cerebras.ai/v1",
+      "api_key_env": "CEREBRAS_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "sambanova": {
+      "protocol": "openai_chat",
+      "base_url": "https://api.sambanova.ai/v1",
+      "api_key_env": "SAMBANOVA_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "nebius": {
+      "protocol": "openai_chat",
+      "base_url": "https://api.studio.nebius.com/v1",
+      "api_key_env": "NEBIUS_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "deepinfra": {
+      "protocol": "openai_chat",
+      "base_url": "https://api.deepinfra.com/v1/openai",
+      "api_key_env": "DEEPINFRA_TOKEN",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "novita": {
+      "protocol": "openai_chat",
+      "base_url": "https://api.novita.ai/openai/v1",
+      "api_key_env": "NOVITA_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "cohere": {
+      "protocol": "openai_chat",
+      "base_url": "https://api.cohere.ai/compatibility/v1",
+      "api_key_env": "COHERE_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "github": {
+      "protocol": "openai_chat",
+      "base_url": "https://models.github.ai/inference",
+      "api_key_env": "GITHUB_TOKEN",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "volcengine": {
+      "protocol": "openai_chat",
+      "base_url": "https://ark.cn-beijing.volces.com/api/v3",
+      "api_key_env": "ARK_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "minimax": {
+      "protocol": "openai_chat",
+      "base_url": "https://api.minimax.io/v1",
+      "api_key_env": "MINIMAX_API_KEY",
+      "context_window": 1000000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "hunyuan": {
+      "protocol": "openai_chat",
+      "base_url": "https://api.hunyuan.cloud.tencent.com/v1",
+      "api_key_env": "HUNYUAN_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "qianfan": {
+      "protocol": "openai_chat",
+      "base_url": "https://qianfan.baidubce.com/v2",
+      "api_key_env": "QIANFAN_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "modelscope": {
+      "protocol": "openai_chat",
+      "base_url": "https://api-inference.modelscope.cn/v1",
+      "api_key_env": "MODELSCOPE_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "baichuan": {
+      "protocol": "openai_chat",
+      "base_url": "https://api.baichuan-ai.com/v1",
+      "api_key_env": "BAICHUAN_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "yi": {
+      "protocol": "openai_chat",
+      "base_url": "https://api.lingyiwanwu.com/v1",
+      "api_key_env": "YI_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "stepfun": {
+      "protocol": "openai_chat",
+      "base_url": "https://api.stepfun.com/v1",
+      "api_key_env": "STEP_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "spark": {
+      "protocol": "openai_chat",
+      "base_url": "https://spark-api-open.xf-yun.com/v1",
+      "api_key_env": "SPARK_API_PASSWORD",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "ppio": {
+      "protocol": "openai_chat",
+      "base_url": "https://api.ppio.com/openai/v1",
+      "api_key_env": "PPIO_API_KEY",
+      "context_window": 128000,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "ollama": {
+      "protocol": "openai_chat",
+      "base_url": "http://localhost:11434/v1",
+      "require_api_key": false,
+      "context_window": 32768,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "lmstudio": {
+      "protocol": "openai_chat",
+      "base_url": "http://localhost:1234/v1",
+      "require_api_key": false,
+      "context_window": 32768,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    },
+    "vllm": {
+      "protocol": "openai_chat",
+      "base_url": "http://localhost:8000/v1",
+      "require_api_key": false,
+      "context_window": 32768,
+      "timeout_seconds": 120,
+      "stream": true,
+      "include_usage": false,
+      "headers": {},
+      "extra_body": {}
+    }
+  }
+}

minimalcode/errors.py

@@ -0,0 +1,31 @@
+class MinimalCodeError(RuntimeError):
+    """Base exception for expected MinimalCode failures."""
+
+
+class ConfigError(MinimalCodeError):
+    """Raised when MinimalCode configuration is invalid."""
+
+
+class ShellError(MinimalCodeError):
+    """Raised when no supported shell can be started."""
+
+
+class ProviderError(MinimalCodeError):
+    def __init__(
+        self,
+        message: str,
+        *,
+        status_code: int | None = None,
+        body: str | None = None,
+    ):
+        super().__init__(message)
+        self.status_code = status_code
+        self.body = body
+
+
+class ToolError(MinimalCodeError):
+    """Raised for invalid or unsafe tool input."""
+
+
+class ClipboardError(MinimalCodeError):
+    """Raised when an image cannot be read from the system clipboard."""

minimalcode/highlight/__init__.py

@@ -0,0 +1,47 @@
+"""Streamed Markdown rendering and terminal color helpers.
+
+The renderer turns assistant deltas into styled terminal output as they arrive,
+so text appears while the model is still producing it, and it strips terminal
+control sequences from untrusted text before that text reaches a real terminal.
+``__all__`` is the complete public surface: the renderer, the sanitizer and its
+one-shot wrapper, the palette constants, and the helpers that color an activity
+tag or remove SGR codes. Deciding what to print, drawing progress indicators, and
+reading theme settings belong to ``cli``/``agent``, and the parser covers the
+Markdown this project emits rather than all of CommonMark. Invariants: every byte
+of untrusted input passes through ``TerminalSanitizer`` first, and with color
+disabled the renderer writes the original Markdown unchanged so redirected and
+JSON output stay parseable; the private helpers that lived on the pre-0.7 single
+``highlight`` module are imported from the submodule that defines them.
+"""
+
+from __future__ import annotations
+
+import re
+from typing import TextIO
+
+from . import color
+from .markdown import MarkdownHighlighter
+from .palette import ACTIVITY_TAG, RESET, strip_ansi
+from .sanitize import TerminalSanitizer, sanitize_terminal_text
+from .thinking import ThinkingRenderer
+
+__all__ = [
+    "ACTIVITY_TAG",
+    "RESET",
+    "MarkdownHighlighter",
+    "TerminalSanitizer",
+    "ThinkingRenderer",
+    "sanitize_terminal_text",
+    "strip_ansi",
+    "style_activity_tag",
+]
+
+
+def style_activity_tag(text: str, stream: TextIO) -> str:
+    """Color a leading ``[tool]`` activity tag when the stream supports ANSI."""
+    text = sanitize_terminal_text(text)
+    match = re.match(r"^(\[[^\]\n]+\])", text)
+    if match is None or not color._supports_color(stream):
+        return text
+    tag = match.group(1)
+    return f"{ACTIVITY_TAG}{tag}{RESET}{text[len(tag) :]}"