devcopilot 0.2.0__py3-none-any.whl

config/paths.py

@@ -0,0 +1,91 @@
+"""Shared filesystem paths for DevCopilot configuration."""
+
+from pathlib import Path
+import shutil
+
+DEVCOPILOT_CONFIG_DIRNAME = ".dc"
+FCC_CONFIG_DIRNAME = ".fcc"
+
+ENV_FILENAME = ".env"
+
+LEGACY_REPO_DIRNAME = "free-claude-code"
+LEGACY_XDG_CONFIG_DIRNAME = ".config"
+
+CLAUDE_WORKSPACE_DIRNAME = "agent_workspace"
+LOGS_DIRNAME = "logs"
+SERVER_LOG_FILENAME = "server.log"
+CODEX_MODEL_CATALOG_FILENAME = "codex-model-catalog.json"
+
+
+def repo_env_path() -> Path:
+    """Local development .env inside the repository."""
+    return Path.cwd() / ENV_FILENAME
+
+
+def config_dir_path() -> Path:
+    """
+    Priority:
+
+    1. repo/.env
+    2. ~/.dc
+    3. migrate from ~/.fcc
+    """
+
+    home = Path.home()
+
+    dc_dir = home / DEVCOPILOT_CONFIG_DIRNAME
+    fcc_dir = home / FCC_CONFIG_DIRNAME
+
+    # Development mode
+    if repo_env_path().exists():
+        return Path.cwd()
+
+    # Existing DevCopilot config
+    if dc_dir.exists():
+        return dc_dir
+
+    # Migrate legacy FCC config
+    if fcc_dir.exists():
+        dc_dir.mkdir(parents=True, exist_ok=True)
+
+        fcc_env = fcc_dir / ENV_FILENAME
+        dc_env = dc_dir / ENV_FILENAME
+
+        if fcc_env.exists() and not dc_env.exists():
+            shutil.copy2(fcc_env, dc_env)
+
+        return dc_dir
+
+    # First startup
+    dc_dir.mkdir(parents=True, exist_ok=True)
+    return dc_dir
+
+
+def managed_env_path() -> Path:
+    """Return active env path."""
+
+    if repo_env_path().exists():
+        return repo_env_path()
+
+    return config_dir_path() / ENV_FILENAME
+
+
+def legacy_env_paths() -> tuple[Path, ...]:
+    home = Path.home()
+
+    return (
+        home / LEGACY_REPO_DIRNAME / ENV_FILENAME,
+        home / LEGACY_XDG_CONFIG_DIRNAME / LEGACY_REPO_DIRNAME / ENV_FILENAME,
+    )
+
+
+def default_claude_workspace_path() -> Path:
+    return config_dir_path() / CLAUDE_WORKSPACE_DIRNAME
+
+
+def server_log_path() -> Path:
+    return config_dir_path() / LOGS_DIRNAME / SERVER_LOG_FILENAME
+
+
+def codex_model_catalog_path() -> Path:
+    return config_dir_path() / CODEX_MODEL_CATALOG_FILENAME

config/provider_catalog.py

@@ -0,0 +1,259 @@
+"""Neutral provider catalog: IDs, credentials, defaults, proxy and capability metadata.
+
+Adapter factories live in :mod:`providers.registry`; this module stays free of
+provider implementation imports (see contract tests).
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Literal
+
+TransportType = Literal["openai_chat", "anthropic_messages"]
+
+# Default upstream base URLs (also re-exported via :mod:`providers.defaults`)
+NVIDIA_NIM_DEFAULT_BASE = "https://integrate.api.nvidia.com/v1"
+# Moonshot Kimi Anthropic-compatible Messages API (POST …/messages).
+KIMI_DEFAULT_BASE = "https://api.moonshot.ai/anthropic/v1"
+WAFER_DEFAULT_BASE = "https://pass.wafer.ai/v1"
+# DeepSeek Anthropic-compatible Messages API (not OpenAI ``/v1`` chat completions).
+DEEPSEEK_ANTHROPIC_DEFAULT_BASE = "https://api.deepseek.com/anthropic"
+# Historical export name: DeepSeek upstream is the native Anthropic path above.
+DEEPSEEK_DEFAULT_BASE = DEEPSEEK_ANTHROPIC_DEFAULT_BASE
+FIREWORKS_DEFAULT_BASE = "https://api.fireworks.ai/inference/v1"
+OPENROUTER_DEFAULT_BASE = "https://openrouter.ai/api/v1"
+MISTRAL_DEFAULT_BASE = "https://api.mistral.ai/v1"
+# Codestral IDE/personal endpoint (distinct from La Plateforme ``api.mistral.ai`` keys).
+CODESTRAL_DEFAULT_BASE = "https://codestral.mistral.ai/v1"
+LMSTUDIO_DEFAULT_BASE = "http://localhost:1234/v1"
+LLAMACPP_DEFAULT_BASE = "http://localhost:8080/v1"
+OLLAMA_DEFAULT_BASE = "http://localhost:11434"
+OPENCODE_DEFAULT_BASE = "https://opencode.ai/zen/v1"
+OPENCODE_GO_DEFAULT_BASE = "https://opencode.ai/zen/go/v1"
+# Z.ai Anthropic-compatible Messages API (not OpenAI Coding Plan chat completions).
+ZAI_DEFAULT_BASE = "https://api.z.ai/api/anthropic/v1"
+# Google AI Studio Gemini API OpenAI-compat layer (not Vertex AI).
+GEMINI_DEFAULT_BASE = "https://generativelanguage.googleapis.com/v1beta/openai/"
+GROQ_DEFAULT_BASE = "https://api.groq.com/openai/v1"
+CEREBRAS_DEFAULT_BASE = "https://api.cerebras.ai/v1"
+
+
+@dataclass(frozen=True, slots=True)
+class ProviderDescriptor:
+    """Metadata for building :class:`~providers.base.ProviderConfig` and factory wiring."""
+
+    provider_id: str
+    transport_type: TransportType
+    capabilities: tuple[str, ...]
+    credential_env: str | None = None
+    credential_url: str | None = None
+    credential_attr: str | None = None
+    static_credential: str | None = None
+    default_base_url: str | None = None
+    base_url_attr: str | None = None
+    proxy_attr: str | None = None
+
+
+PROVIDER_CATALOG: dict[str, ProviderDescriptor] = {
+    "nvidia_nim": ProviderDescriptor(
+        provider_id="nvidia_nim",
+        transport_type="openai_chat",
+        credential_env="NVIDIA_NIM_API_KEY",
+        credential_url="https://build.nvidia.com/settings/api-keys",
+        credential_attr="nvidia_nim_api_key",
+        default_base_url=NVIDIA_NIM_DEFAULT_BASE,
+        proxy_attr="nvidia_nim_proxy",
+        capabilities=("chat", "streaming", "tools", "thinking", "rate_limit"),
+    ),
+    "open_router": ProviderDescriptor(
+        provider_id="open_router",
+        transport_type="anthropic_messages",
+        credential_env="OPENROUTER_API_KEY",
+        credential_url="https://openrouter.ai/keys",
+        credential_attr="open_router_api_key",
+        default_base_url=OPENROUTER_DEFAULT_BASE,
+        proxy_attr="open_router_proxy",
+        capabilities=("chat", "streaming", "tools", "thinking", "native_anthropic"),
+    ),
+    "gemini": ProviderDescriptor(
+        provider_id="gemini",
+        transport_type="openai_chat",
+        credential_env="GEMINI_API_KEY",
+        credential_url="https://aistudio.google.com/apikey",
+        credential_attr="gemini_api_key",
+        default_base_url=GEMINI_DEFAULT_BASE,
+        proxy_attr="gemini_proxy",
+        capabilities=("chat", "streaming", "tools", "thinking", "rate_limit"),
+    ),
+    "deepseek": ProviderDescriptor(
+        provider_id="deepseek",
+        transport_type="anthropic_messages",
+        credential_env="DEEPSEEK_API_KEY",
+        credential_url="https://platform.deepseek.com/api_keys",
+        credential_attr="deepseek_api_key",
+        default_base_url=DEEPSEEK_ANTHROPIC_DEFAULT_BASE,
+        capabilities=("chat", "streaming", "tools", "thinking", "native_anthropic"),
+    ),
+    "mistral": ProviderDescriptor(
+        provider_id="mistral",
+        transport_type="openai_chat",
+        credential_env="MISTRAL_API_KEY",
+        credential_url="https://console.mistral.ai/",
+        credential_attr="mistral_api_key",
+        default_base_url=MISTRAL_DEFAULT_BASE,
+        proxy_attr="mistral_proxy",
+        capabilities=("chat", "streaming", "tools", "thinking", "rate_limit"),
+    ),
+    "mistral_codestral": ProviderDescriptor(
+        provider_id="mistral_codestral",
+        transport_type="openai_chat",
+        credential_env="CODESTRAL_API_KEY",
+        credential_url="https://console.mistral.ai/",
+        credential_attr="codestral_api_key",
+        default_base_url=CODESTRAL_DEFAULT_BASE,
+        proxy_attr="codestral_proxy",
+        capabilities=("chat", "streaming", "tools", "thinking", "rate_limit"),
+    ),
+    "opencode": ProviderDescriptor(
+        provider_id="opencode",
+        transport_type="openai_chat",
+        credential_env="OPENCODE_API_KEY",
+        credential_url="https://opencode.ai/auth",
+        credential_attr="opencode_api_key",
+        default_base_url=OPENCODE_DEFAULT_BASE,
+        proxy_attr="opencode_proxy",
+        capabilities=("chat", "streaming", "tools", "thinking", "rate_limit"),
+    ),
+    "opencode_go": ProviderDescriptor(
+        provider_id="opencode_go",
+        transport_type="openai_chat",
+        credential_env="OPENCODE_API_KEY",
+        credential_url="https://opencode.ai/auth",
+        credential_attr="opencode_api_key",
+        default_base_url=OPENCODE_GO_DEFAULT_BASE,
+        proxy_attr="opencode_go_proxy",
+        capabilities=("chat", "streaming", "tools", "thinking", "rate_limit"),
+    ),
+    "wafer": ProviderDescriptor(
+        provider_id="wafer",
+        transport_type="anthropic_messages",
+        credential_env="WAFER_API_KEY",
+        credential_url="https://www.wafer.ai/pass",
+        credential_attr="wafer_api_key",
+        default_base_url=WAFER_DEFAULT_BASE,
+        proxy_attr="wafer_proxy",
+        capabilities=("chat", "streaming", "tools", "thinking", "native_anthropic"),
+    ),
+    "kimi": ProviderDescriptor(
+        provider_id="kimi",
+        transport_type="anthropic_messages",
+        credential_env="KIMI_API_KEY",
+        credential_url="https://platform.moonshot.cn/console/api-keys",
+        credential_attr="kimi_api_key",
+        default_base_url=KIMI_DEFAULT_BASE,
+        proxy_attr="kimi_proxy",
+        capabilities=(
+            "chat",
+            "streaming",
+            "tools",
+            "thinking",
+            "native_anthropic",
+        ),
+    ),
+    "cerebras": ProviderDescriptor(
+        provider_id="cerebras",
+        transport_type="openai_chat",
+        credential_env="CEREBRAS_API_KEY",
+        credential_url="https://cloud.cerebras.ai",
+        credential_attr="cerebras_api_key",
+        default_base_url=CEREBRAS_DEFAULT_BASE,
+        proxy_attr="cerebras_proxy",
+        capabilities=("chat", "streaming", "tools", "thinking", "rate_limit"),
+    ),
+    "groq": ProviderDescriptor(
+        provider_id="groq",
+        transport_type="openai_chat",
+        credential_env="GROQ_API_KEY",
+        credential_url="https://console.groq.com/keys",
+        credential_attr="groq_api_key",
+        default_base_url=GROQ_DEFAULT_BASE,
+        proxy_attr="groq_proxy",
+        capabilities=("chat", "streaming", "tools", "thinking", "rate_limit"),
+    ),
+    "fireworks": ProviderDescriptor(
+        provider_id="fireworks",
+        transport_type="anthropic_messages",
+        credential_env="FIREWORKS_API_KEY",
+        credential_url="https://fireworks.ai/account/api-keys",
+        credential_attr="fireworks_api_key",
+        default_base_url=FIREWORKS_DEFAULT_BASE,
+        proxy_attr="fireworks_proxy",
+        capabilities=(
+            "chat",
+            "streaming",
+            "tools",
+            "thinking",
+            "native_anthropic",
+            "rate_limit",
+        ),
+    ),
+    "zai": ProviderDescriptor(
+        provider_id="zai",
+        transport_type="anthropic_messages",
+        credential_env="ZAI_API_KEY",
+        credential_attr="zai_api_key",
+        default_base_url=ZAI_DEFAULT_BASE,
+        proxy_attr="zai_proxy",
+        capabilities=(
+            "chat",
+            "streaming",
+            "tools",
+            "thinking",
+            "native_anthropic",
+            "rate_limit",
+        ),
+    ),
+    "lmstudio": ProviderDescriptor(
+        provider_id="lmstudio",
+        transport_type="anthropic_messages",
+        static_credential="lm-studio",
+        default_base_url=LMSTUDIO_DEFAULT_BASE,
+        base_url_attr="lm_studio_base_url",
+        proxy_attr="lmstudio_proxy",
+        capabilities=("chat", "streaming", "tools", "native_anthropic", "local"),
+    ),
+    "llamacpp": ProviderDescriptor(
+        provider_id="llamacpp",
+        transport_type="anthropic_messages",
+        static_credential="llamacpp",
+        default_base_url=LLAMACPP_DEFAULT_BASE,
+        base_url_attr="llamacpp_base_url",
+        proxy_attr="llamacpp_proxy",
+        capabilities=("chat", "streaming", "tools", "native_anthropic", "local"),
+    ),
+    "ollama": ProviderDescriptor(
+        provider_id="ollama",
+        transport_type="anthropic_messages",
+        static_credential="ollama",
+        default_base_url=OLLAMA_DEFAULT_BASE,
+        base_url_attr="ollama_base_url",
+        capabilities=(
+            "chat",
+            "streaming",
+            "tools",
+            "thinking",
+            "native_anthropic",
+            "local",
+        ),
+    ),
+}
+
+# Key order:
+# NVIDIA NIM first (README default), DeepSeek fourth, Wafer ninth / Kimi tenth; then cerebras /
+# groq / fireworks overlap; remainder and locals last per project plan (
+# github.com/cheahjs/free-llm-api-resources Free Providers TOC as rough guide beyond fixed slots).
+# ``SUPPORTED_PROVIDER_IDS`` inherits this insertion order for UI and error-message listing.
+SUPPORTED_PROVIDER_IDS: tuple[str, ...] = tuple(PROVIDER_CATALOG.keys())
+
+if len(set(SUPPORTED_PROVIDER_IDS)) != len(SUPPORTED_PROVIDER_IDS):
+    raise AssertionError("Duplicate provider ids in PROVIDER_CATALOG key order")

config/provider_ids.py

@@ -0,0 +1,7 @@
+"""Canonical provider id tuple (re-exported from the provider catalog)."""
+
+from __future__ import annotations
+
+from .provider_catalog import SUPPORTED_PROVIDER_IDS
+
+__all__ = ("SUPPORTED_PROVIDER_IDS",)