kolega-code 0.1.0__tar.gz → 0.3.0__tar.gz

{kolega_code-0.1.0 → kolega_code-0.3.0}/.env.example

@@ -6,6 +6,10 @@ OPENAI_API_KEY=
 GOOGLE_API_KEY=
 MOONSHOT_API_KEY=
 DEEPSEEK_API_KEY=
+ZAI_API_KEY=
+KIMI_CODING_API_KEY=
+
+KOLEGA_CODE_THINKING_EFFORT=
 
 BROWSERLESS_API_KEY=
 

kolega_code-0.3.0/.github/workflows/ci.yml

@@ -0,0 +1,46 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+    types: [opened, synchronize, reopened, ready_for_review]
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  tests:
+    name: Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: Install dependencies
+        run: uv sync --extra dev --frozen
+
+      - name: Run fast tests
+        run: uv run pytest -ra --durations=50 --import-mode=importlib -m "not slow"

{kolega_code-0.1.0 → kolega_code-0.3.0}/.github/workflows/docs.yml

@@ -6,13 +6,15 @@ on:
     paths:
       - "docs/**"
       - ".github/workflows/docs.yml"
+  pull_request:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - ".github/workflows/docs.yml"
   workflow_dispatch:
 
-# Allow this workflow to publish to GitHub Pages.
 permissions:
   contents: read
-  pages: write
-  id-token: write
 
 # Allow one concurrent deployment; don't cancel an in-progress production deploy.
 concurrency:
@@ -43,13 +45,18 @@ jobs:
         run: npm run build
 
       - name: Upload Pages artifact
+        if: github.event_name != 'pull_request'
         uses: actions/upload-pages-artifact@v3
         with:
           path: docs/dist
 
   deploy:
+    if: github.event_name != 'pull_request'
     needs: build
     runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}

{kolega_code-0.1.0 → kolega_code-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kolega-code
-Version: 0.1.0
+Version: 0.3.0
 Summary: Local-first AI coding agent for the terminal
 Project-URL: Homepage, https://kolega-ai.github.io/kolega-code/
 Project-URL: Documentation, https://kolega-ai.github.io/kolega-code/
@@ -49,6 +49,7 @@ Requires-Dist: jinja2==3.1.6
 Requires-Dist: langfuse==3.14.5
 Requires-Dist: nest-asyncio==1.6.0
 Requires-Dist: openai==1.109.1
+Requires-Dist: packaging==25.0
 Requires-Dist: pathspec==1.1.1
 Requires-Dist: playwright==1.59.0
 Requires-Dist: psutil==7.2.2
@@ -78,7 +79,7 @@ The package owns the `kolega_code` import namespace and provides the
 Install with the public installer:
 
 ```bash
-curl -fsSL https://kolega.dev/install-kolega-code | sh
+curl -fsSL https://kolega.dev/install-kolega-code.sh | sh
 ```
 
 Or install directly from PyPI with uv:
@@ -96,11 +97,14 @@ kolega-code --version
 Upgrade or uninstall:
 
 ```bash
-uv tool upgrade kolega-code
+kolega-code update
 uv tool uninstall kolega-code
 ```
 
-Run the Textual UI and open the Settings tab to select Moonshot Kimi K2.6 or DeepSeek V4 Pro and save your API key:
+Running the installer again also updates an existing install to the latest
+released version.
+
+Run the Textual UI and open the Settings tab to pick any provider and model from the catalog, choose the model's thinking effort, and save your API key:
 
 ```bash
 kolega-code .
@@ -115,16 +119,20 @@ kolega-code . --resume
 kolega-code . --resume <thread-or-session-id>
 ```
 
-You can also set `MOONSHOT_API_KEY`, `DEEPSEEK_API_KEY`, or keep using env/flag based configuration for non-UI commands:
+You can also use env/flag based configuration for non-UI commands. API key
+variables provide credentials only; set a provider/model explicitly or save one
+in the Settings UI:
 
 ```bash
+export KOLEGA_CODE_PROVIDER=deepseek
+export DEEPSEEK_API_KEY=...
 kolega-code ask "summarize this repository" --project .
 kolega-code ask "summarize this repository" --project . --provider deepseek --model deepseek-v4-pro
 kolega-code sessions list --project .
 kolega-code doctor --project .
 ```
 
-The Settings UI supports Moonshot `kimi-k2.6` and DeepSeek `deepseek-v4-pro`. A saved UI selection is used for all agent model roles and API keys are stored in the local CLI settings file with restrictive permissions. Existing environment and model/provider flag overrides continue to work. Local session state is stored under the platform state directory unless `KOLEGA_CODE_STATE_DIR` is set.
+The Settings UI exposes every model in the catalog (`kolega_code/llm/specs.py`) across all supported providers — the provider and model dropdowns are derived from that catalog, so adding a model there makes it selectable in the UI automatically. A saved UI selection is used for all agent model roles, and switching models resets thinking effort to that model's default. API keys are stored in the local CLI settings file with restrictive permissions. Existing environment and model/provider flag overrides continue to work, but API key variables alone never select a provider or model. Local session state is stored under the platform state directory unless `KOLEGA_CODE_STATE_DIR` is set.
 
 ## From source
 

{kolega_code-0.1.0 → kolega_code-0.3.0}/README.md

@@ -10,7 +10,7 @@ The package owns the `kolega_code` import namespace and provides the
 Install with the public installer:
 
 ```bash
-curl -fsSL https://kolega.dev/install-kolega-code | sh
+curl -fsSL https://kolega.dev/install-kolega-code.sh | sh
 ```
 
 Or install directly from PyPI with uv:
@@ -28,11 +28,14 @@ kolega-code --version
 Upgrade or uninstall:
 
 ```bash
-uv tool upgrade kolega-code
+kolega-code update
 uv tool uninstall kolega-code
 ```
 
-Run the Textual UI and open the Settings tab to select Moonshot Kimi K2.6 or DeepSeek V4 Pro and save your API key:
+Running the installer again also updates an existing install to the latest
+released version.
+
+Run the Textual UI and open the Settings tab to pick any provider and model from the catalog, choose the model's thinking effort, and save your API key:
 
 ```bash
 kolega-code .
@@ -47,16 +50,20 @@ kolega-code . --resume
 kolega-code . --resume <thread-or-session-id>
 ```
 
-You can also set `MOONSHOT_API_KEY`, `DEEPSEEK_API_KEY`, or keep using env/flag based configuration for non-UI commands:
+You can also use env/flag based configuration for non-UI commands. API key
+variables provide credentials only; set a provider/model explicitly or save one
+in the Settings UI:
 
 ```bash
+export KOLEGA_CODE_PROVIDER=deepseek
+export DEEPSEEK_API_KEY=...
 kolega-code ask "summarize this repository" --project .
 kolega-code ask "summarize this repository" --project . --provider deepseek --model deepseek-v4-pro
 kolega-code sessions list --project .
 kolega-code doctor --project .
 ```
 
-The Settings UI supports Moonshot `kimi-k2.6` and DeepSeek `deepseek-v4-pro`. A saved UI selection is used for all agent model roles and API keys are stored in the local CLI settings file with restrictive permissions. Existing environment and model/provider flag overrides continue to work. Local session state is stored under the platform state directory unless `KOLEGA_CODE_STATE_DIR` is set.
+The Settings UI exposes every model in the catalog (`kolega_code/llm/specs.py`) across all supported providers — the provider and model dropdowns are derived from that catalog, so adding a model there makes it selectable in the UI automatically. A saved UI selection is used for all agent model roles, and switching models resets thinking effort to that model's default. API keys are stored in the local CLI settings file with restrictive permissions. Existing environment and model/provider flag overrides continue to work, but API key variables alone never select a provider or model. Local session state is stored under the platform state directory unless `KOLEGA_CODE_STATE_DIR` is set.
 
 ## From source
 

{kolega_code-0.1.0 → kolega_code-0.3.0}/RELEASING.md

@@ -1,7 +1,7 @@
 # Releasing Kolega Code
 
 This project publishes the `kolega-code` package to PyPI and serves the public
-installer from `https://kolega.dev/install-kolega-code`.
+installer from `https://kolega.dev/install-kolega-code.sh`.
 
 ## First PyPI release
 
@@ -29,8 +29,8 @@ the organization request.
 4. Create and push a matching tag:
 
    ```bash
-   git tag v0.1.0
-   git push origin v0.1.0
+   git tag v0.3.0
+   git push origin v0.3.0
    ```
 
 5. Approve the `pypi` environment deployment in GitHub Actions.
@@ -47,19 +47,19 @@ the organization request.
 The canonical installer source is tracked at:
 
 ```text
-scripts/install-kolega-code
+scripts/install-kolega-code.sh
 ```
 
 The `kolega.dev` site repo should publish that file verbatim at:
 
 ```text
-https://kolega.dev/install-kolega-code
+https://kolega.dev/install-kolega-code.sh
 ```
 
 After updating the site, verify:
 
 ```bash
-curl -fsSL https://kolega.dev/install-kolega-code | sh
+curl -fsSL https://kolega.dev/install-kolega-code.sh | sh
 ```
 
 ## Transfer to the PyPI organization

{kolega_code-0.1.0 → kolega_code-0.3.0}/conftest.py

@@ -17,6 +17,7 @@ CLI_CONFIG_ENV_KEYS = {
     "KOLEGA_CODE_EDIT_MODEL",
     "KOLEGA_CODE_THINKING_PROVIDER",
     "KOLEGA_CODE_THINKING_MODEL",
+    "KOLEGA_CODE_THINKING_EFFORT",
     "KOLEGA_CODE_THINKING_TOKENS",
     "KOLEGA_CODE_ENVIRONMENT",
 }
@@ -28,7 +29,8 @@ def pytest_configure() -> None:
 
 
 @pytest.fixture
-def isolated_cli_env(monkeypatch: pytest.MonkeyPatch) -> None:
+def isolated_cli_env(monkeypatch: pytest.MonkeyPatch, tmp_path: Path) -> None:
     """Remove process CLI config so unit tests don't depend on a developer .env."""
     for key in {*API_KEY_ENV.values(), *CLI_CONFIG_ENV_KEYS}:
         monkeypatch.delenv(key, raising=False)
+    monkeypatch.setenv("KOLEGA_CODE_STATE_DIR", str(tmp_path / "state"))