kolega-code 0.36.0__tar.gz → 0.37.0__tar.gz

{kolega_code-0.36.0 → kolega_code-0.37.0}/CHANGELOG.md

@@ -6,6 +6,29 @@ This project uses GitHub Releases for detailed generated release notes. This fil
 
 ## Unreleased
 
+## 0.37.0 - 2026-09-09
+
+### Added
+
+- **DeepSeek V4.1 Flash (preview).** DeepSeek's temporary
+  `deepseek-v4.1-flash-expires-on-0910` model is available under **DeepSeek V4.1
+  Flash (Preview, expires Sep 10)** in the model picker, with vision, hosted web
+  search, and `none`/`low`/`high`/`max` reasoning effort (default `high`). It is
+  not the default and is not aliased to a stable model; the ID expires on
+  September 10, 2026, after which an available stable model must be selected.
+
+### Fixed
+
+- Pin PDFium and the Intel Python 3.11/3.12 ONNX Runtime dependency to restore
+  compatible wheel selection on macOS Monterey for both the installer and direct
+  package installs. Intel Monterey requires Python 3.11 or 3.12.
+- Settings saves are merged with concurrent writers instead of replacing the whole
+  file, so a long-running instance can no longer drop a gateway token or API key
+  another process saved after it started.
+- `kolega-code gateway status` now reports an installed background service that
+  is failing to start (service state, start count, last exit code, log path)
+  instead of only printing "not running".
+
 ## 0.36.0 - 2026-09-07
 
 ### Added

{kolega_code-0.36.0 → kolega_code-0.37.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kolega-code
-Version: 0.36.0
+Version: 0.37.0
 Summary: Multi-agent coding in the terminal
 Project-URL: Homepage, https://kolega-ai.github.io/kolega-code/
 Project-URL: Documentation, https://kolega-ai.github.io/kolega-code/
@@ -47,6 +47,7 @@ Requires-Dist: markdownify==1.2.3
 Requires-Dist: markitdown[docx,pdf,pptx,xls,xlsx]==0.1.6
 Requires-Dist: mcp==1.28.1
 Requires-Dist: nest-asyncio==1.6.0
+Requires-Dist: onnxruntime==1.19.2; sys_platform == 'darwin' and platform_machine == 'x86_64' and python_version < '3.13'
 Requires-Dist: onnxruntime==1.27.0; python_version >= '3.14' and sys_platform != 'win32'
 Requires-Dist: openai==2.46.0
 Requires-Dist: packaging==25.0
@@ -56,6 +57,7 @@ Requires-Dist: playwright==1.59.0
 Requires-Dist: psutil==7.2.2
 Requires-Dist: pydantic==2.13.4
 Requires-Dist: pygments==2.20.0
+Requires-Dist: pypdfium2==5.11.0
 Requires-Dist: python-dotenv==1.2.2
 Requires-Dist: pyyaml==6.0.3
 Requires-Dist: readability-lxml==0.8.4.1

{kolega_code-0.36.0 → kolega_code-0.37.0}/kolega_code/__init__.py

@@ -174,4 +174,4 @@ __all__ = [
     "parse_git_status_output",
 ]
 
-__version__ = "0.36.0"
+__version__ = "0.37.0"

{kolega_code-0.36.0 → kolega_code-0.37.0}/kolega_code/agent/__init__.py

@@ -51,4 +51,4 @@ __all__ = [
     "ToolExtension",
 ]
 
-__version__ = "0.36.0"
+__version__ = "0.37.0"

{kolega_code-0.36.0 → kolega_code-0.37.0}/kolega_code/cli/gateway.py

@@ -33,6 +33,7 @@ from kolega_code.gateway.service import (
     install_service,
     is_service_installed,
     restart_service,
+    service_state_summary,
     uninstall_service,
 )
 
@@ -290,6 +291,7 @@ def _gateway_status(config: GatewayConfig) -> int:
     if payload is not None:
         # A heartbeat from a process that no longer exists (e.g. SIGKILLed).
         print(f"gateway: not running (stale heartbeat from pid {payload.get('pid')})")
+        _print_service_state(config)
         return 0
     lock = FileLock(str(config.state_dir / LOCK_FILE_NAME))
     try:
@@ -303,9 +305,20 @@ def _gateway_status(config: GatewayConfig) -> int:
         return 0
     lock.release()
     print(f"gateway: not running (state: {config.state_dir})")
+    _print_service_state(config)
     return 0
 
 
+def _print_service_state(config: GatewayConfig) -> None:
+    summary = service_state_summary()
+    if summary is None:
+        return
+    print(f"  service: {summary}")
+    log_path = config.state_dir / "gateway.log"
+    if log_path.exists():
+        print(f"  log: {log_path}")
+
+
 def _pid_alive(pid: Any) -> bool:
     if not isinstance(pid, int) or pid <= 0:
         return False

{kolega_code-0.36.0 → kolega_code-0.37.0}/kolega_code/cli/provider_registry.py

@@ -70,6 +70,7 @@ MODEL_LABELS: dict[str, str] = {
     "kimi-for-coding": "Kimi for Coding",
     "kimi-for-coding-highspeed": "Kimi for Coding (HighSpeed)",
     # DeepSeek
+    "deepseek-v4.1-flash-expires-on-0910": "DeepSeek V4.1 Flash (Preview, expires Sep 10)",
     "deepseek-v4-pro": "DeepSeek V4 Pro",
     "deepseek-v4-flash": "DeepSeek V4 Flash",
     "deepseek-v4-flash-vision-exp": "DeepSeek V4 Flash Vision (Exp)",

{kolega_code-0.36.0 → kolega_code-0.37.0}/kolega_code/cli/settings.py

@@ -2,11 +2,15 @@
 
 from __future__ import annotations
 
+import copy
 import json
 from dataclasses import dataclass, field
 from pathlib import Path
 from typing import Any, Optional
 
+from filelock import FileLock
+from filelock import Timeout as FileLockTimeout
+
 from kolega_code.local_state import write_private_text
 from kolega_code.llm.specs.custom_endpoints import (
     API_STYLES,
@@ -33,6 +37,41 @@ class SettingsStoreError(RuntimeError):
     """Raised when CLI settings cannot be loaded or saved."""
 
 
+SETTINGS_LOCK_TIMEOUT_SECONDS = 10.0
+
+
+def _merge_settings_documents(
+    base: dict[str, Any],
+    current: dict[str, Any],
+    on_disk: dict[str, Any],
+) -> dict[str, Any]:
+    """Apply one writer's changes on top of the current document.
+
+    ``base`` is the state the writer loaded, so keys it did not touch keep the
+    on-disk value and a stale writer cannot revert another process's change.
+    Nested dicts merge key by key, and keys the writer never saw survive.
+    """
+    merged: dict[str, Any] = {}
+    for key in set(base) | set(current) | set(on_disk):
+        if key not in current:
+            if key in base:
+                continue
+            if key in on_disk:
+                merged[key] = on_disk[key]
+            continue
+        if key in base and base[key] == current[key]:
+            merged[key] = on_disk[key] if key in on_disk else current[key]
+            continue
+        if key not in base and current[key] is None and key in on_disk:
+            merged[key] = on_disk[key]
+            continue
+        if isinstance(base.get(key), dict) and isinstance(current[key], dict) and isinstance(on_disk.get(key), dict):
+            merged[key] = _merge_settings_documents(base[key], current[key], on_disk[key])
+            continue
+        merged[key] = current[key]
+    return merged
+
+
 def _coerce_model_entries(raw: object) -> dict[str, dict]:
     """Normalize a stored key -> {provider, model, ...} mapping.
 
@@ -272,6 +311,9 @@ class CliSettings:
     # Additive optional field — absent in older files -> empty mapping.
     custom_endpoints: dict[str, dict] = field(default_factory=dict)
     schema_version: int = SETTINGS_SCHEMA_VERSION
+    # The document this instance was loaded from, used as the merge base by
+    # SettingsStore.save(). Never serialized.
+    _merge_base: Optional[dict[str, Any]] = field(default=None, repr=False, compare=False)
 
     @classmethod
     def from_dict(cls, data: dict) -> "CliSettings":
@@ -452,12 +494,47 @@ class SettingsStore:
 
     def load(self) -> CliSettings:
         if not self.path.exists():
-            return CliSettings()
+            settings = CliSettings()
+            settings._merge_base = copy.deepcopy(settings.to_dict())
+            return settings
         try:
-            return CliSettings.from_dict(json.loads(self.path.read_text(encoding="utf-8")))
+            data = json.loads(self.path.read_text(encoding="utf-8"))
+            settings = CliSettings.from_dict(data)
         except json.JSONDecodeError as exc:
             raise SettingsStoreError(f"Settings file is not valid JSON: {self.path}") from exc
+        # The merge base is what this process understood, not the raw file:
+        # a key it never saw (newer schema, hand-edit) must survive its save.
+        settings._merge_base = copy.deepcopy(settings.to_dict())
+        if isinstance(data, dict) and "schema_version" in data:
+            settings._merge_base["schema_version"] = data["schema_version"]
+        return settings
 
     def save(self, settings: CliSettings) -> None:
-        payload = json.dumps(settings.to_dict(), indent=2, sort_keys=True)
-        write_private_text(self.path, payload + "\n")
+        """Write this instance's changes, keeping concurrent writers' fields."""
+        lock = FileLock(f"{self.path}.lock")
+        try:
+            lock.acquire(timeout=SETTINGS_LOCK_TIMEOUT_SECONDS)
+        except FileLockTimeout as exc:
+            raise SettingsStoreError(f"Timed out locking the settings file: {self.path}") from exc
+        try:
+            merged = self._merged_document(settings)
+            payload = json.dumps(merged, indent=2, sort_keys=True)
+            write_private_text(self.path, payload + "\n")
+        finally:
+            lock.release()
+        settings._merge_base = copy.deepcopy(merged)
+
+    def _merged_document(self, settings: CliSettings) -> dict[str, Any]:
+        current = settings.to_dict()
+        if settings._merge_base is None:
+            return current
+        return _merge_settings_documents(settings._merge_base, current, self._read_document())
+
+    def _read_document(self) -> dict[str, Any]:
+        try:
+            raw = json.loads(self.path.read_text(encoding="utf-8"))
+        except FileNotFoundError:
+            return {}
+        except (json.JSONDecodeError, OSError) as exc:
+            raise SettingsStoreError(f"Settings file is not valid JSON: {self.path}") from exc
+        return raw if isinstance(raw, dict) else {}

{kolega_code-0.36.0 → kolega_code-0.37.0}/kolega_code/gateway/service.py

@@ -12,6 +12,7 @@ from __future__ import annotations
 
 import os
 import plistlib
+import re
 import shlex
 import shutil
 import subprocess
@@ -214,6 +215,41 @@ def run_service_command(argv: list[str]) -> subprocess.CompletedProcess[str] | N
         return None
 
 
+def service_state_summary(
+    *,
+    systemd_dir: Optional[Path] = None,
+    launchd_dir: Optional[Path] = None,
+    platform: Optional[str] = None,
+) -> Optional[str]:
+    """One line of service-manager state for an installed gateway, else None.
+
+    ``gateway status`` uses this to explain a service that is installed but not
+    running, which the daemon's own status file cannot show.
+    """
+    platform = platform if platform is not None else sys.platform
+    if not is_service_installed(systemd_dir=systemd_dir, launchd_dir=launchd_dir, platform=platform):
+        return None
+    if platform == "darwin":
+        proc = run_service_command(["launchctl", "print", f"gui/{os.getuid()}/{LAUNCHD_LABEL}"])
+        if proc is None or proc.returncode != 0:
+            return "launchd agent installed but not loaded"
+        output = proc.stdout or ""
+        parts: list[str] = []
+        state = re.search(r"^\s*state = (.+)$", output, re.MULTILINE)
+        if state:
+            parts.append(f"state {state.group(1).strip()}")
+        runs = re.search(r"^\s*runs = (\d+)$", output, re.MULTILINE)
+        if runs:
+            parts.append(f"{runs.group(1)} starts")
+        last_exit = re.search(r"^\s*last exit code = (\d+)$", output, re.MULTILINE)
+        if last_exit:
+            parts.append(f"last exit code {last_exit.group(1)}")
+        return "launchd agent " + (", ".join(parts) if parts else "loaded")
+    proc = run_service_command(["systemctl", "--user", "is-active", SERVICE_NAME])
+    state_text = (proc.stdout or "").strip() if proc is not None else ""
+    return f"systemd unit {state_text or 'unknown'}"
+
+
 def restart_service(
     *,
     unit_path: Optional[Path] = None,

{kolega_code-0.36.0 → kolega_code-0.37.0}/kolega_code/llm/specs/accessors.py

@@ -201,8 +201,12 @@ def preferred_edit_protocol(provider: str, model_name: str) -> Optional[str]:
 # takes its catalog value instead.
 DEEPSEEK_WIRE_OUTPUT_CAP = 64000
 
-# Routes whose catalog max_completion_tokens is itself the real ceiling.
-_UNCLAMPED_DEEPSEEK_ROUTES = {("deepseek", "deepseek-v4-flash"), ("deepseek", "deepseek-v4-flash-vision-exp")}
+# Routes that use the catalog output budget without the legacy Pro/chat clamp.
+_UNCLAMPED_DEEPSEEK_ROUTES = {
+    ("deepseek", "deepseek-v4-flash"),
+    ("deepseek", "deepseek-v4-flash-vision-exp"),
+    ("deepseek", "deepseek-v4.1-flash-expires-on-0910"),
+}
 
 
 def is_deepseek_model(model_name: str) -> bool:

{kolega_code-0.36.0 → kolega_code-0.37.0}/kolega_code/llm/specs/catalog/deepseek.py

@@ -79,4 +79,25 @@ DEEPSEEK_SPECS = {
             mode="openai_responses_reasoning",
         ),
     },
+    # Append previews: settings uses the first catalog model as provider fallback.
+    # Unlisted preview, verified on /responses on 2026-09-09. The ID advertises
+    # expiry on September 10; do not alias it to a stable model or make it default.
+    # Vision, hosted search, tools, and all four exposed efforts work live.
+    # Retain the Flash-family 1M context budget provisionally (not independently
+    # measured for this preview). The API accepts 384000 output tokens and reports
+    # a maximum of 393216; keep the existing conservative Flash output budget.
+    ("deepseek", "deepseek-v4.1-flash-expires-on-0910"): {
+        "context_length": 1000000,
+        "max_completion_tokens": 384000,
+        "input_budget": "window_minus_output",
+        "default_temperature": 1.0,
+        "supports_vision": True,
+        "supports_hosted_web_search": True,
+        "preferred_edit_protocol": "claude_code",
+        "thinking_effort": ThinkingEffortSpec(
+            options=("none", "low", "high", "max"),
+            default="high",
+            mode="openai_responses_reasoning",
+        ),
+    },
 }

{kolega_code-0.36.0 → kolega_code-0.37.0}/pyproject.toml

@@ -8,7 +8,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "kolega-code"
-version = "0.36.0"
+version = "0.37.0"
 description = "Multi-agent coding in the terminal"
 readme = "README.md"
 license = "BUSL-1.1"
@@ -69,6 +69,9 @@ dependencies = [
     "markitdown[docx,pdf,pptx,xls,xlsx]==0.1.6",
     "mcp==1.28.1",
     "nest-asyncio==1.6.0",
+    # Magika: 1.19.2 has Monterey-compatible Intel wheels for Python 3.11/3.12.
+    # It has no Python 3.13 wheels; that interpreter requires newer macOS.
+    "onnxruntime==1.19.2; sys_platform == 'darwin' and platform_machine == 'x86_64' and python_version < '3.13'",
     # Magika's cross-platform resolution selects onnxruntime 1.20.1, which has no CPython 3.14 wheels.
     "onnxruntime==1.27.0; python_version >= '3.14' and sys_platform != 'win32'",
     "openai==2.46.0",
@@ -78,6 +81,9 @@ dependencies = [
     "playwright==1.59.0",
     "psutil==7.2.2",
     "pydantic==2.13.4",
+    # MarkItDown/pdfplumber: newer PDFium wheels require macOS 13.
+    # Preserve Intel macOS 12 installs; bumps must pass the Monterey wheel guard.
+    "pypdfium2==5.11.0",
     "python-dotenv==1.2.2",
     # Load-bearing for the web UI: code highlighting is generated with the same
     # Pygments styles the TUI renders with, so both stay identical.