ayder-cli 2.3.1__tar.gz → 2.4.0__tar.gz

{ayder_cli-2.3.1 → ayder_cli-2.4.0}/AGENTS.md

@@ -87,6 +87,7 @@ ayder-cli/
 │   ├── providers/              # LLM provider implementations
 │   │   ├── base.py             # AIProvider protocol, NormalizedStreamChunk
 │   │   ├── orchestrator.py  # Factory: create(config) → provider
+│   │   ├── evren.py            # evren gateway terms-of-use acceptance (/model)
 │   │   └── impl/               # Individual provider drivers
 │   │       ├── openai.py       # OpenAIProvider (base for most drivers)
 │   │       ├── ollama.py       # OllamaProvider (native + XML fallback)
@@ -385,6 +386,22 @@ uv run poe test-cov      # With coverage report
 - **Coverage**: Maintain existing coverage levels
 - **Timeout**: Use `--timeout=30` to prevent hanging tests
 
+### Test Definitions
+
+Plans and reviews use these values.
+
+- **Kinds**
+  - `baseline regression` — fails on the parent commit for a named reason, passes on the fix.
+  - `new interface` — fails at its assertion once a minimal callable version exists (never on an `ImportError`).
+  - `preservation` — passes before and after the change; its assertion depends on the behaviour it preserves.
+- **Layers**
+  - `unit` — a function or class, without a Textual app.
+  - `tui` — a Textual app driven under `App.run_test()`.
+- **Environment**
+  - `local-faked` — the only one. No network: HTTP is faked with `httpx.MockTransport` passed to the SDK client; other I/O uses `unittest.mock`. No test reaches a real provider.
+
+The gate procedure lives in [docs/GATE.md](docs/GATE.md).
+
 ### Writing Tests
 
 ```python

{ayder_cli-2.3.1 → ayder_cli-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ayder-cli
-Version: 2.3.1
+Version: 2.4.0
 Summary: AI agent for any LLMs
 Project-URL: Homepage, https://github.com/ayder/ayder-cli
 Project-URL: Repository, https://github.com/ayder/ayder-cli.git
@@ -155,6 +155,8 @@ in the core install.
 
 ayder-cli uses a flexible profile-based configuration system. On the first run, it creates a config file at `~/.ayder/config.toml`.
 
+The generated file includes an `[llm.evren]` profile for the evren gateway (`https://evren-llmapi.ssyz.org.tr/v1`) with an empty `api_key`. Fill in your key and switch to it with `/provider evren`.
+
 **Key Concepts:**
 - **Profile Name:** A custom named section (e.g., `[llm.my_ollama]`). You can define as many profiles as you want.
 - **Driver:** The underlying native SDK or adapter used by the profile (`ollama`, `openai`, `anthropic`, `google`, `deepseek`, `qwen`, or `glm`). Each driver guarantees full support for native tool calling and streaming.
@@ -319,6 +321,10 @@ Once a profile is active, use `/model` in the TUI to swap models on the fly:
 - **Interactive Picker:** `/model` with no arguments queries the active driver for available models and opens a picker.
 - **Direct Switch:** `/model <model-name>` immediately switches to that model.
 
+If the provider rejects the listing request, `/model` shows the server's error.
+
+For the evren gateway (`evren-llmapi.ssyz.org.tr`), if your account has not accepted the current terms of use, `/model` shows them and asks you to Approve or Deny; Approve accepts them on the server.
+
 Changes made with `/model` apply to the current session only. To make a model the permanent default, update `model = "..."` in your `config.toml`.
 
 ## Usage

{ayder_cli-2.3.1 → ayder_cli-2.4.0}/README.md

@@ -112,6 +112,8 @@ in the core install.
 
 ayder-cli uses a flexible profile-based configuration system. On the first run, it creates a config file at `~/.ayder/config.toml`.
 
+The generated file includes an `[llm.evren]` profile for the evren gateway (`https://evren-llmapi.ssyz.org.tr/v1`) with an empty `api_key`. Fill in your key and switch to it with `/provider evren`.
+
 **Key Concepts:**
 - **Profile Name:** A custom named section (e.g., `[llm.my_ollama]`). You can define as many profiles as you want.
 - **Driver:** The underlying native SDK or adapter used by the profile (`ollama`, `openai`, `anthropic`, `google`, `deepseek`, `qwen`, or `glm`). Each driver guarantees full support for native tool calling and streaming.
@@ -276,6 +278,10 @@ Once a profile is active, use `/model` in the TUI to swap models on the fly:
 - **Interactive Picker:** `/model` with no arguments queries the active driver for available models and opens a picker.
 - **Direct Switch:** `/model <model-name>` immediately switches to that model.
 
+If the provider rejects the listing request, `/model` shows the server's error.
+
+For the evren gateway (`evren-llmapi.ssyz.org.tr`), if your account has not accepted the current terms of use, `/model` shows them and asks you to Approve or Deny; Approve accepts them on the server.
+
 Changes made with `/model` apply to the current session only. To make a model the permanent default, update `model = "..."` in your `config.toml`.
 
 ## Usage

ayder_cli-2.4.0/docs/GATE.md

@@ -0,0 +1,28 @@
+# Gate
+
+The procedure an agent follows to gate a candidate commit. Follow the steps in order and do
+not interpret the results. Never edit a file, fix a failure, skip a step or create a worktree.
+Test definitions live in [AGENTS.md](../AGENTS.md#test-definitions).
+
+Input: the candidate SHA.
+
+1. `git rev-parse HEAD` → expected: exactly the candidate SHA.
+2. `git status --porcelain` → expected: empty output.
+3. `uv run poe check-all` → expected: exit code 0. This runs lint, typecheck, the logging
+   gates and the test suite, and stops at the first failing task.
+4. Copy the final pytest summary line (`=== N passed, M skipped in …s ===`) verbatim.
+
+Last measured: `2494 passed, 2 skipped` on `feat/evren-terms` with the evren default profile (2026-09-29).
+
+## Report format
+
+```text
+SHA: <candidate SHA>
+1 git rev-parse HEAD: <output> (match|MISMATCH)
+2 git status --porcelain: <empty|output>
+3 uv run poe check-all: exit <code>
+4 summary: <pytest summary line verbatim>
+GATE COMPLETE | GATE FAILED at step <n>
+```
+
+`GATE COMPLETE` only when steps 1–3 meet their expected results.

{ayder_cli-2.3.1 → ayder_cli-2.4.0}/docs/PROJECT_STRUCTURE.md

@@ -220,7 +220,7 @@ cli.py:main()
 | `tui/adapter.py` | Adapter glue between `AyderApp` and `ChatLoop` | callback wiring helpers |
 | `tui/commands.py` | Slash command handlers | `COMMAND_MAP`, `handle_*()` |
 | `tui/widgets.py` | Custom widgets | `ChatView`, `ToolPanel`, `CLIInputBar`, `StatusBar`, `AutoCompleteInput` |
-| `tui/screens.py` | Modal screens | `AgentListScreen`, `CLIConfirmScreen`, `CLIHelpScreen`, `CLIMultiSelectScreen`, `CLIPermissionScreen`, `CLISafeModeScreen`, `CLISelectScreen`, `TaskEditScreen` |
+| `tui/screens.py` | Modal screens | `AgentListScreen`, `CLIConfirmScreen`, `CLIHelpScreen`, `CLIMultiSelectScreen`, `CLIPermissionScreen`, `CLISafeModeScreen`, `CLISelectScreen`, `EvrenTermsScreen`, `TaskEditScreen` |
 | `tui/parser.py` | TUI-specific parsing | `content_processor()` |
 | `tui/helpers.py` | UI helpers | `create_tui_banner()` |
 | `tui/keybindings.py` | Keybinding declarations | `BINDINGS` |
@@ -242,6 +242,7 @@ All LLM provider implementations live here. Previously some sat under `services/
 | `providers/__init__.py` | Re-exports | `AIProvider`, `NormalizedStreamChunk`, `ToolCallDef`, `provider_orchestrator` |
 | `providers/base.py` | Provider protocol + shared DTOs | `AIProvider`, `NormalizedStreamChunk`, `ToolCallDef`, `_ToolCall`, `_FunctionCall` |
 | `providers/orchestrator.py` | Driver-keyed provider factory | `ProviderOrchestrator`, `provider_orchestrator` |
+| `providers/evren.py` | evren gateway terms-of-use acceptance (used by `/model`) | `EVREN_HOST`, `EvrenTerms`, `is_evren_terms_error`, `fetch_terms`, `accept_terms` |
 | `providers/impl/ollama.py` | Native Ollama provider (ollama SDK) | `OllamaProvider` |
 | `providers/impl/ollama_inspector.py` | Ollama model introspection | `OllamaInspector`, `ModelInfo`, `RuntimeState` |
 | `providers/impl/openai.py` | OpenAI / OpenAI-compatible backend | `OpenAIProvider` |

{ayder_cli-2.3.1 → ayder_cli-2.4.0}/docs/config.toml.example

@@ -206,6 +206,15 @@ think = true                        # default; set false if the selected model r
 # reasoning_effort = "medium" # choose a value supported by the selected model
 # # temperature / think are NOT applied by the openai driver.
 
+# evren gateway (OpenAI-compatible). A fresh config.toml ships this profile with
+# an empty api_key. The first `/model` asks you to accept evren's terms of use.
+# [llm.evren]
+# driver = "openai"
+# base_url = "https://evren-llmapi.ssyz.org.tr/v1"
+# api_key = ""               # your evren key
+# model = "deepseek-v4-flash"
+# num_ctx = 131072
+
 # =============================================================================
 # Agents
 # =============================================================================

{ayder_cli-2.3.1 → ayder_cli-2.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ayder-cli"
-version = "2.3.1"
+version = "2.4.0"
 description = "AI agent for any LLMs"
 readme = "README.md"
 requires-python = ">=3.12"

{ayder_cli-2.3.1 → ayder_cli-2.4.0}/scripts/check_exception_handlers.py

@@ -24,7 +24,7 @@ DEFAULT_BASELINE = REPO / "scripts" / "exception_baseline.txt"
 
 # Frozen census (§C10). A different number means the gate is looking at the
 # wrong tree, or the census moved without the plan being updated.
-EXPECTED_BROAD = 138
+EXPECTED_BROAD = 137
 BRANCHING = (ast.If, ast.Try, ast.For, ast.While, ast.With, ast.Match)
 TERMINAL = (ast.Return, ast.Break, ast.Continue, ast.Pass)
 

{ayder_cli-2.3.1 → ayder_cli-2.4.0}/scripts/check_log_arguments.py

@@ -203,13 +203,13 @@ FROZEN_CHAIN_SITES: dict[tuple[str, str, str, str], tuple[str, int]] = {
     ("log.py", "emit_event", "bind", "**"): ("Name(id='fields', ctx=Load())", 1),
 }
 
-# The 100 `exception=True` inputs are homogeneous, so they are governed as one
-# package-wide shape/count rule rather than 100 site identities - their per-site
+# The 101 `exception=True` inputs are homogeneous, so they are governed as one
+# package-wide shape/count rule rather than 101 site identities - their per-site
 # discipline is C10's.
-FROZEN_EXCEPTION_TRUE = 100
+FROZEN_EXCEPTION_TRUE = 101
 
 # Live chain inputs, counted per method. Printed on every run.
-CHAIN_TALLY: dict[str, int] = {"bind": 6, "opt": 104, "patch": 0}
+CHAIN_TALLY: dict[str, int] = {"bind": 6, "opt": 105, "patch": 0}
 
 # The reviewed composition of THE COMMITTED baseline, frozen by the Phase 5
 # census: 252 retained non-path + 22 paths + 2 deferred interpolated rows, plus

{ayder_cli-2.3.1 → ayder_cli-2.4.0}/src/ayder_cli/core/config.py

@@ -45,6 +45,16 @@ DEFAULTS: Dict[str, Any] = {
         "model": "gemini-3-flash",
         "num_ctx": 65536,
     },
+    # Extra [llm.<name>] profiles written into a freshly created config.toml.
+    "extra_llm_profiles": {
+        "evren": {
+            "driver": "openai",
+            "base_url": "https://evren-llmapi.ssyz.org.tr/v1",
+            "api_key": "",
+            "model": "deepseek-v4-flash",
+            "num_ctx": 131072,
+        },
+    },
     "editor": "vim",
     "verbose": False,
     "logging": {

{ayder_cli-2.3.1 → ayder_cli-2.4.0}/src/ayder_cli/core/config_migration.py

@@ -74,6 +74,8 @@ def render_v2_config(
         section = dict(defaults.get(provider, {}))
         section.setdefault("driver", _DRIVER_BY_PROVIDER[provider])
         llm_profiles[provider] = section
+    for name, section in defaults.get("extra_llm_profiles", {}).items():
+        llm_profiles[name] = dict(section)
     if llm_overrides:
         for name, section in llm_overrides.items():
             merged = dict(llm_profiles.get(name, {}))

{ayder_cli-2.3.1 → ayder_cli-2.4.0}/src/ayder_cli/providers/base.py

@@ -56,7 +56,8 @@ class AIProvider(ABC):
         List available models from the provider.
         
         Returns:
-            List of model name strings. Empty list if not supported or on error.
+            List of model name strings. Empty list if the driver does not
+            support listing; drivers may raise on server errors.
         """
         return []
     

ayder_cli-2.4.0/src/ayder_cli/providers/evren.py

@@ -0,0 +1,61 @@
+"""evren LLM gateway: terms-of-use acceptance.
+
+The gateway (https://evren-llmapi.ssyz.org.tr) is OpenAI-compatible but refuses every
+call with HTTP 403 ``terms_not_accepted`` until the account accepts the current terms.
+"""
+
+from dataclasses import dataclass
+from typing import Final
+from urllib.parse import urlsplit
+
+from openai import AsyncOpenAI, PermissionDeniedError
+
+from ayder_cli.core.config import Config
+
+EVREN_HOST: Final[str] = "evren-llmapi.ssyz.org.tr"
+
+
+@dataclass(frozen=True)
+class EvrenTerms:
+    """One published version of the evren terms of use."""
+
+    version: int
+    content: str
+
+
+def is_evren_terms_error(base_url: str | None, exc: BaseException) -> bool:
+    """True when ``exc`` is evren refusing a call until its terms are accepted."""
+    if not base_url or urlsplit(base_url).hostname != EVREN_HOST:
+        return False
+    return isinstance(exc, PermissionDeniedError) and exc.code == "terms_not_accepted"
+
+
+def make_client(config: Config) -> AsyncOpenAI:
+    """Build a client for the provider's configured base URL and key."""
+    return AsyncOpenAI(base_url=config.base_url, api_key=config.api_key)
+
+
+async def fetch_terms(client: AsyncOpenAI) -> EvrenTerms:
+    """Fetch the current terms text.
+
+    Raises the SDK's ``APIError`` on a failed request and ``ValueError`` on a
+    response without an integer ``version`` and a string ``content``.
+    """
+    data = await client.get("terms/text", cast_to=object)
+    if not isinstance(data, dict):
+        raise ValueError(f"unexpected evren terms response: {data!r}")
+    version, content = data.get("version"), data.get("content")
+    if not isinstance(version, int) or not isinstance(content, str):
+        raise ValueError(f"unexpected evren terms response: {data!r}")
+    return EvrenTerms(version, content)
+
+
+async def accept_terms(client: AsyncOpenAI, version: int) -> int:
+    """Accept terms ``version``; return the version the server recorded.
+
+    Falls back to ``version`` when the response does not name one. Raises the
+    SDK's ``APIError`` on a failed request.
+    """
+    data = await client.post("terms/accept", body={"version": version}, cast_to=object)
+    accepted = data.get("accepted_version") if isinstance(data, dict) else None
+    return accepted if isinstance(accepted, int) else version

{ayder_cli-2.3.1 → ayder_cli-2.4.0}/src/ayder_cli/providers/impl/openai.py

@@ -36,16 +36,11 @@ class OpenAIProvider(AIProvider):
     async def list_models(self) -> List[str]:
         """
         List available models from the OpenAI-compatible API.
-        
-        Returns empty list if the API doesn't support model listing.
+
+        Server and transport errors propagate so the caller can report them.
         """
-        try:
-            response = await self.client.models.list()
-            # Extract model IDs from the response
-            return [model.id for model in response.data if hasattr(model, "id")]
-        except Exception:  # noqa: BLE001 - OpenAI SDK boundary: servers that omit model listing raise arbitrary client errors
-            logger.opt(exception=True).warning("Failed to list models")
-            return []
+        response = await self.client.models.list()
+        return [model.id for model in response.data if hasattr(model, "id")]
 
     async def chat(
         self,

{ayder_cli-2.3.1 → ayder_cli-2.4.0}/src/ayder_cli/themes/ayder.py

@@ -358,6 +358,43 @@ CLIHelpScreen #help-content {
     height: auto;
 }
 
+/* EvrenTermsScreen - evren terms-of-use modal with Approve / Deny.
+   Targets 'EvrenTermsScreen' in screens.py. */
+EvrenTermsScreen {
+    align: center middle;
+}
+
+EvrenTermsScreen > Vertical {
+    width: 90%;
+    height: 85%;
+    background: ansi_black;
+    border: solid ansi_bright_blue;
+    padding: 1 2;
+}
+
+EvrenTermsScreen .prompt {
+    text-style: bold;
+    color: ansi_bright_blue;
+    text-align: center;
+    width: 100%;
+    margin-bottom: 1;
+}
+
+EvrenTermsScreen #terms-scroll {
+    height: 1fr;
+    color: ansi_white;
+}
+
+EvrenTermsScreen #terms-buttons {
+    height: auto;
+    align: center middle;
+    margin-top: 1;
+}
+
+EvrenTermsScreen Button {
+    margin: 0 2;
+}
+
 /* Generic text selection highlight color. */
 .selection {
     background: ansi_blue;

{ayder_cli-2.3.1 → ayder_cli-2.4.0}/src/ayder_cli/themes/claude.py

@@ -314,6 +314,43 @@ CLIHelpScreen #help-content {
     height: auto;
 }
 
+/* EvrenTermsScreen - evren terms-of-use modal with Approve / Deny.
+   Targets 'EvrenTermsScreen' in screens.py. */
+EvrenTermsScreen {
+    align: center middle;
+}
+
+EvrenTermsScreen > Vertical {
+    width: 90%;
+    height: 85%;
+    background: #12122a;
+    border: solid #5eaff5;
+    padding: 1 2;
+}
+
+EvrenTermsScreen .prompt {
+    text-style: bold;
+    color: #5eaff5;
+    text-align: center;
+    width: 100%;
+    margin-bottom: 1;
+}
+
+EvrenTermsScreen #terms-scroll {
+    height: 1fr;
+    color: #b8b8c8;
+}
+
+EvrenTermsScreen #terms-buttons {
+    height: auto;
+    align: center middle;
+    margin-top: 1;
+}
+
+EvrenTermsScreen Button {
+    margin: 0 2;
+}
+
 /* Generic text selection highlight color. */
 .selection {
     background: #264f78;

{ayder_cli-2.3.1 → ayder_cli-2.4.0}/src/ayder_cli/tui/commands.py

@@ -15,11 +15,14 @@ from ayder_cli.core.context import ProjectContext
 from ayder_cli.core.reasoning import get_effort_label
 from ayder_cli.log import LOG_LEVELS, get_logger
 from ayder_cli.logging_config import setup_logging
-from ayder_cli.providers import provider_orchestrator, ProviderUnavailableError
+import openai
+
+from ayder_cli.providers import evren, provider_orchestrator, ProviderUnavailableError
 from ayder_cli.tools.builtins.skill import SkillInfo, discover_skills, skill
 from ayder_cli.tui.screens import (
     AgentListScreen,
     CLISelectScreen,
+    EvrenTermsScreen,
     CLIMultiSelectScreen,
     CLIPermissionScreen,
     TaskEditScreen,
@@ -136,7 +139,9 @@ def _apply_provider_switch(
     app.request_turn(prepare=_prepare, run_loop=False)
 
 
-async def _list_and_show_models(app: AyderApp, chat_view: ChatView) -> None:
+async def _list_and_show_models(
+    app: AyderApp, chat_view: ChatView, *, terms_prompted: bool = False
+) -> None:
     """Async helper to list models and show selector."""
     try:
         models = await app.llm.list_models()
@@ -173,9 +178,43 @@ async def _list_and_show_models(app: AyderApp, chat_view: ChatView) -> None:
         )
     except Exception as e:  # noqa: BLE001 - slash-command guard: /model reports listing failures in chat rather than killing the app
         logger.opt(exception=True).error("Model listing failed")
+        if not terms_prompted and evren.is_evren_terms_error(app.config.base_url, e):
+            await _prompt_evren_terms(app, chat_view)
+            return
         chat_view.add_system_message(f"Error listing models: {e}")
 
 
+async def _prompt_evren_terms(app: AyderApp, chat_view: ChatView) -> None:
+    """Show the evren terms; on Approve accept them and list models again."""
+    client = evren.make_client(app.config)
+    try:
+        terms = await evren.fetch_terms(client)
+    except (openai.APIError, ValueError) as e:
+        logger.opt(exception=True).warning("Fetching evren terms failed")
+        chat_view.add_system_message(f"Could not load evren terms: {e}")
+        return
+
+    async def _accept_and_relist() -> None:
+        try:
+            accepted = await evren.accept_terms(client, terms.version)
+        except openai.APIError as e:
+            logger.opt(exception=True).warning("Accepting evren terms failed")
+            chat_view.add_system_message(f"Could not accept evren terms: {e}")
+            return
+        chat_view.add_system_message(f"Accepted evren terms v{accepted}.")
+        await _list_and_show_models(app, chat_view, terms_prompted=True)
+
+    def on_decision(approved: bool | None) -> None:
+        if approved:
+            app.run_worker(_accept_and_relist(), exclusive=False)
+        else:
+            chat_view.add_system_message(
+                "evren terms not accepted; models cannot be listed until they are."
+            )
+
+    app.push_screen(EvrenTermsScreen(terms), on_decision)
+
+
 def handle_model(app: AyderApp, args: str, chat_view: ChatView) -> None:
     """Handle /model command."""
     if not args.strip():

{ayder_cli-2.3.1 → ayder_cli-2.4.0}/src/ayder_cli/tui/screens.py

@@ -1,12 +1,13 @@
-"""Modal screens for the TUI: confirm, permission, safe mode, select, task edit, help."""
+"""Modal screens for the TUI: confirm, permission, safe mode, select, task edit, help, evren terms."""
 
 from textual.app import ComposeResult
-from textual.containers import Vertical, VerticalScroll
+from textual.containers import Horizontal, Vertical, VerticalScroll
 from textual.css.query import NoMatches
-from textual.widgets import Static, Input, Label, TextArea
+from textual.widgets import Button, Input, Label, Markdown, Static, TextArea
 from textual.screen import ModalScreen
 from rich.text import Text
 
+from ayder_cli.providers.evren import EvrenTerms
 from ayder_cli.tui.keybindings import get_keybindings_by_category
 from ayder_cli.tui.types import ConfirmResult
 from ayder_cli.log import get_logger
@@ -767,3 +768,37 @@ class CLIHelpScreen(ModalScreen[None]):
 
     def action_dismiss_help(self) -> None:
         self.dismiss(None)
+
+
+class EvrenTermsScreen(ModalScreen[bool]):
+    """Shows the evren terms of use; dismisses True on Approve, False on Deny.
+
+    Deny holds focus when the modal opens so a stray Enter never accepts.
+    """
+
+    BINDINGS = [("escape", "deny", "Deny")]
+
+    def __init__(self, terms: EvrenTerms) -> None:
+        super().__init__()
+        self.terms = terms
+
+    def compose(self) -> ComposeResult:
+        with Vertical():
+            yield Label(
+                f"evren — Terms of Use v{self.terms.version}", classes="prompt", markup=False
+            )
+            with VerticalScroll(id="terms-scroll"):
+                yield Markdown(self.terms.content, id="terms-content")
+            with Horizontal(id="terms-buttons"):
+                yield Button("Approve", id="terms-approve", variant="success")
+                yield Button("Deny", id="terms-deny", variant="error")
+
+    def on_mount(self) -> None:
+        self.query_one("#terms-deny", Button).focus()
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        event.stop()
+        self.dismiss(event.button.id == "terms-approve")
+
+    def action_deny(self) -> None:
+        self.dismiss(False)

ayder_cli-2.4.0/tests/core/test_default_config_evren.py

@@ -0,0 +1,44 @@
+"""The first-run config.toml ships an evren profile with an empty API key."""
+
+import tomllib
+
+import pytest
+
+from ayder_cli.core import config as config_module
+from ayder_cli.core.config import DEFAULTS, load_config_for_provider
+from ayder_cli.core.config_migration import ensure_latest_config
+
+EVREN_PROFILE = {
+    "driver": "openai",
+    "base_url": "https://evren-llmapi.ssyz.org.tr/v1",
+    "api_key": "",
+    "model": "deepseek-v4-flash",
+    "num_ctx": 131072,
+}
+
+
+@pytest.fixture
+def fresh_config(tmp_path, monkeypatch):
+    path = tmp_path / ".ayder" / "config.toml"
+    monkeypatch.setattr(config_module, "CONFIG_DIR", path.parent)
+    monkeypatch.setattr(config_module, "CONFIG_PATH", path)
+    ensure_latest_config(path, defaults=DEFAULTS)
+    return path
+
+
+def test_first_run_config_has_evren_profile(fresh_config):
+    data = tomllib.loads(fresh_config.read_text())
+
+    assert data["llm"]["evren"] == EVREN_PROFILE
+    assert data["app"]["provider"] == "openai"
+
+
+def test_evren_profile_loads_with_empty_key(fresh_config):
+    cfg = load_config_for_provider("evren")
+
+    assert (cfg.driver, cfg.base_url, cfg.api_key, cfg.model) == (
+        "openai",
+        "https://evren-llmapi.ssyz.org.tr/v1",
+        "",
+        "deepseek-v4-flash",
+    )

ayder_cli-2.4.0/tests/providers/test_evren.py

@@ -0,0 +1,79 @@
+"""evren terms helpers: error detection, terms fetch, terms acceptance."""
+
+import json
+
+import httpx
+import openai
+import pytest
+
+from ayder_cli.providers.evren import EvrenTerms, accept_terms, fetch_terms, is_evren_terms_error
+
+EVREN = "https://evren-llmapi.ssyz.org.tr/v1"
+TERMS_CONTENT = "# EVREN Kullanım Şartları\n\nMadde 1."
+
+
+def _status_error(cls: type[openai.APIStatusError], status: int, code: str) -> openai.APIStatusError:
+    request = httpx.Request("GET", f"{EVREN}/models")
+    body = {"message": "refused", "type": "permission_error", "param": None, "code": code}
+    return cls("refused", response=httpx.Response(status, request=request), body=body)
+
+
+TERMS_403 = _status_error(openai.PermissionDeniedError, 403, "terms_not_accepted")
+
+
+@pytest.mark.parametrize(
+    ("base_url", "exc", "expected"),
+    [
+        (EVREN, TERMS_403, True),
+        ("https://evren-llmapi.ssyz.org.tr/", TERMS_403, True),
+        ("https://api.example.com/v1", TERMS_403, False),
+        (EVREN, _status_error(openai.PermissionDeniedError, 403, "forbidden"), False),
+        (EVREN, _status_error(openai.NotFoundError, 404, "terms_not_accepted"), False),
+        (EVREN, RuntimeError("terms_not_accepted"), False),
+        (None, TERMS_403, False),
+    ],
+)
+def test_is_evren_terms_error(base_url, exc, expected):
+    assert is_evren_terms_error(base_url, exc) is expected
+
+
+def _client(responses: dict[str, httpx.Response], requests: list[httpx.Request]) -> openai.AsyncOpenAI:
+    def handler(request: httpx.Request) -> httpx.Response:
+        requests.append(request)
+        return responses[request.url.path]
+
+    return openai.AsyncOpenAI(
+        base_url=EVREN,
+        api_key="k",
+        max_retries=0,
+        http_client=httpx.AsyncClient(transport=httpx.MockTransport(handler)),
+    )
+
+
+@pytest.mark.asyncio
+async def test_fetch_terms():
+    requests: list[httpx.Request] = []
+    body = {"version": 1, "doc_path": "docs/legal/x.md", "content": TERMS_CONTENT}
+    client = _client({"/v1/terms/text": httpx.Response(200, json=body)}, requests)
+
+    assert await fetch_terms(client) == EvrenTerms(version=1, content=TERMS_CONTENT)
+    assert [(r.method, r.url.path) for r in requests] == [("GET", "/v1/terms/text")]
+    assert requests[0].headers["Authorization"] == "Bearer k"
+
+
+@pytest.mark.asyncio
+@pytest.mark.parametrize(
+    "response_body",
+    [
+        {"accepted_version": 1, "accepted_at": "2026-09-29T11:27:40.291459+00:00"},
+        {},
+    ],
+)
+async def test_accept_terms(response_body):
+    requests: list[httpx.Request] = []
+    client = _client({"/v1/terms/accept": httpx.Response(200, json=response_body)}, requests)
+
+    assert await accept_terms(client, 1) == 1
+    assert [(r.method, r.url.path) for r in requests] == [("POST", "/v1/terms/accept")]
+    assert json.loads(requests[0].content) == {"version": 1}
+