feedsummary-core 1.0.2__tar.gz

feedsummary_core-1.0.2/.github/workflows/release.yaml

@@ -0,0 +1,101 @@
+name: Release to PyPI + GitHub Releases
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  gate:
+    name: Validate tag is semver vX.Y.Z
+    runs-on: ubuntu-latest
+    outputs:
+      is_semver: ${{ steps.check.outputs.is_semver }}
+    steps:
+      - name: Check tag format
+        id: check
+        shell: bash
+        run: |
+          TAG="${GITHUB_REF_NAME}"
+          if [[ "$TAG" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "is_semver=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "is_semver=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  build:
+    name: Build distributions
+    needs: gate
+    if: needs.gate.outputs.is_semver == 'true'
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build twine
+
+      - name: Build sdist + wheel
+        run: python -m build
+
+      - name: Twine check
+        run: python -m twine check dist/*
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/*
+
+  publish_pypi:
+    name: Publish to PyPI
+    needs: [gate, build]
+    if: needs.gate.outputs.is_semver == 'true'
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/feedsummary_core/
+
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+
+      - name: Publish to PyPI (Trusted Publishing)
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist
+  github_release:
+    name: Create GitHub Release
+    needs: [gate, build]
+    if: needs.gate.outputs.is_semver == 'true'
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+
+      - name: Create GitHub Release and upload artifacts
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.ref_name }}
+          name: ${{ github.ref_name }}
+          generate_release_notes: true
+          files: |
+            dist/*

feedsummary_core-1.0.2/.gitignore

@@ -0,0 +1,207 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/

feedsummary_core-1.0.2/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Martin Vesterlund
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

feedsummary_core-1.0.2/PKG-INFO

@@ -0,0 +1,26 @@
+Metadata-Version: 2.4
+Name: feedsummary-core
+Version: 1.0.2
+Summary: Core library for FeedSummary.
+Author: Martin Vesterlund
+License-Expression: BSD-3-Clause
+Keywords: rss,summarization,llm
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.13.3
+Requires-Dist: aiolimiter>=1.2.1
+Requires-Dist: feedparser>=6.0.12
+Requires-Dist: tenacity>=9.1.4
+Requires-Dist: tinydb>=4.8.2
+Requires-Dist: tld>=0.13.1
+Requires-Dist: PyYAML>=6.0.3
+Requires-Dist: trafilatura>=2.0.0
+Requires-Dist: ollama>=0.6.1
+Requires-Dist: lxml_html_clean>=0.4.3
+Dynamic: license-file
+
+# feedSummaryBase
+Common functionality for the feedSummary

feedsummary_core-1.0.2/README.md

@@ -0,0 +1,2 @@
+# feedSummaryBase
+Common functionality for the feedSummary

feedsummary_core-1.0.2/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=69", "wheel", "setuptools-scm>=8"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "feedsummary-core"
+dynamic = ["version"]
+description = "Core library for FeedSummary."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "BSD-3-Clause"
+license-files = [ "LICENSE" ]
+authors = [{ name = "Martin Vesterlund" }]
+keywords = ["rss", "summarization", "llm"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Operating System :: OS Independent",
+]
+
+dependencies = [
+  "aiohttp>=3.13.3",          # :contentReference[oaicite:1]{index=1}
+  "aiolimiter>=1.2.1",        # :contentReference[oaicite:2]{index=2}
+  "feedparser>=6.0.12",       # :contentReference[oaicite:3]{index=3}
+  "tenacity>=9.1.4",          # :contentReference[oaicite:4]{index=4}
+  "tinydb>=4.8.2",            # :contentReference[oaicite:5]{index=5}
+  "tld>=0.13.1",              # :contentReference[oaicite:6]{index=6}
+  "PyYAML>=6.0.3",            # :contentReference[oaicite:7]{index=7}
+  "trafilatura>=2.0.0",       # :contentReference[oaicite:8]{index=8}
+  "ollama>=0.6.1",            # :contentReference[oaicite:9]{index=9}
+  "lxml_html_clean>=0.4.3",   # :contentReference[oaicite:10]{index=10}
+]
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools_scm]
+version_file = "src/feedsummary_core/_version.py"
+
+[tool.ruff]
+line-length = 100

feedsummary_core-1.0.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

feedsummary_core-1.0.2/src/feedsummary_core/__init__.py

@@ -0,0 +1,38 @@
+# LICENSE HEADER MANAGED BY add-license-header
+#
+# BSD 3-Clause License
+#
+# Copyright (c) 2026, Martin Vesterlund
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice, this
+#    list of conditions and the following disclaimer.
+#
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from
+#    this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+
+try:
+    from ._version import version as __version__
+except Exception:
+    __version__ = "0+unknown"
+
+__all__ = ["__version__"]

feedsummary_core-1.0.2/src/feedsummary_core/_version.py

@@ -0,0 +1,34 @@
+# file generated by setuptools-scm
+# don't change, don't track in version control
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+    COMMIT_ID = Union[str, None]
+else:
+    VERSION_TUPLE = object
+    COMMIT_ID = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+commit_id: COMMIT_ID
+__commit_id__: COMMIT_ID
+
+__version__ = version = '1.0.2'
+__version_tuple__ = version_tuple = (1, 0, 2)
+
+__commit_id__ = commit_id = 'g1ddc4d235'

feedsummary_core-1.0.2/src/feedsummary_core/llm_client/__init__.py

@@ -0,0 +1,94 @@
+# LICENSE HEADER MANAGED BY add-license-header
+#
+# BSD 3-Clause License
+#
+# Copyright (c) 2026, Martin Vesterlund
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice, this
+#    list of conditions and the following disclaimer.
+#
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from
+#    this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+from __future__ import annotations
+
+from llmClient.fallback_client import FallbackLLMClient, FallbackPolicy
+
+from typing import Any, Dict, List, Optional, Protocol
+
+
+class LLMError(Exception):
+    pass
+
+
+class LLMClient(Protocol):
+    async def chat(self, messages: List[Dict[str, str]], *, temperature: float = 0.2) -> str: ...
+
+
+def _create_single_llm(llm_cfg: Dict[str, Any]):
+    provider = (llm_cfg.get("provider") or "ollama").lower()
+
+    if provider == "ollama_cloud":
+        from llmClient.ollama_cloud import OllamaCloudClient
+
+        return OllamaCloudClient(llm_cfg)
+
+    if provider == "ollama_local":
+        from llmClient.ollama_local import OllamaLocalClient, OllamaConfig
+
+        cfg = OllamaConfig(
+            base_url=str(llm_cfg.get("base_url", "http://localhost:11434")),
+            model=str(llm_cfg.get("model", "llama3.1:latest")),
+            max_rps=float(llm_cfg.get("max_rps", 1.0)),
+            first_byte_timeout_s=int(llm_cfg.get("first_byte_timeout_s", 900)),
+            sock_read_timeout_s=int(llm_cfg.get("sock_read_timeout_s", 300)),
+            progress_log_every_s=float(llm_cfg.get("progress_log_every_s", 2.0)),
+            max_retries=int(llm_cfg.get("max_retries", 3)),
+        )
+        return OllamaLocalClient(cfg)
+
+    raise ValueError(f"Unsupported LLM provider: {provider}")
+
+
+def create_llm_client(config: Dict[str, Any]):
+    """
+    Bygger primary från config['llm'] och (om finns) fallback från config['llm_fallback'].
+
+    Fallback triggas när cloud slår i quota igen efter retry.
+    """
+    llm_cfg = config.get("llm") or {}
+    primary = _create_single_llm(llm_cfg)
+
+    fallback_cfg: Optional[Dict[str, Any]] = config.get("llm_fallback")
+    fallback = _create_single_llm(fallback_cfg) if isinstance(fallback_cfg, dict) else None
+
+    # policy kan ligga under llm.quota eller llm_fallback_policy – välj det du gillar
+    quota_cfg = llm_cfg.get("quota") or {}
+    policy = FallbackPolicy(
+        max_quota_retries=int(quota_cfg.get("max_quota_retries", 1)),
+        default_wait_s=int(quota_cfg.get("default_wait_s", 30)),
+    )
+
+    if fallback:
+        return FallbackLLMClient(primary=primary, fallback=fallback, policy=policy)
+
+    return primary

feedsummary_core-1.0.2/src/feedsummary_core/llm_client/fallback_client.py

@@ -0,0 +1,113 @@
+# LICENSE HEADER MANAGED BY add-license-header
+#
+# BSD 3-Clause License
+#
+# Copyright (c) 2026, Martin Vesterlund
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice, this
+#    list of conditions and the following disclaimer.
+#
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from
+#    this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+
+from __future__ import annotations
+
+import asyncio
+import logging
+from dataclasses import dataclass
+from typing import Dict, List, Optional, Protocol
+
+from llm_client import LLMRateLimitError
+
+log = logging.getLogger(__name__)
+
+
+class LLMClient(Protocol):
+    async def chat(self, messages: List[Dict[str, str]], *, temperature: float = 0.2) -> str: ...
+
+
+@dataclass
+class FallbackPolicy:
+    max_quota_retries: int = 1  # "vid retry" -> om det slår i igen efter 1 retry: fallback
+    default_wait_s: int = 30  # om retry_after saknas
+    jitter_s: float = 0.0  # håll 0 om du vill vara deterministisk
+
+
+class FallbackLLMClient:
+    """
+    Wrapper som kör primary, men om quota/rate-limit kvarstår efter retry -> fallback.
+
+    Beteende:
+      - Får vi LLMRateLimitError:
+          * vänta retry_after (eller default_wait_s)
+          * försök igen upp till max_quota_retries
+      - Om fortfarande rate limited:
+          * växla permanent till fallback (för resten av processen)
+    """
+
+    def __init__(
+        self,
+        primary: LLMClient,
+        fallback: Optional[LLMClient],
+        policy: Optional[FallbackPolicy] = None,
+    ):
+        self.primary = primary
+        self.fallback = fallback
+        self.policy = policy or FallbackPolicy()
+        self._force_fallback = False
+
+    async def chat(self, messages: List[Dict[str, str]], *, temperature: float = 0.2) -> str:
+        # Om vi redan växlat till fallback
+        if self._force_fallback:
+            if not self.fallback:
+                raise RuntimeError("Fallback aktiverad men llm_fallback saknas i config.")
+            return await self.fallback.chat(messages, temperature=temperature)
+
+        # Försök primary med quota-retries
+        attempt = 0
+        while True:
+            try:
+                return await self.primary.chat(messages, temperature=temperature)
+            except LLMRateLimitError as e:
+                attempt += 1
+                wait_s = int(e.retry_after_seconds or self.policy.default_wait_s)
+
+                # Om vi redan testat retry och slår i igen -> fallback
+                if attempt > self.policy.max_quota_retries:
+                    if not self.fallback:
+                        # ingen fallback konfigurerad
+                        raise
+                    log.warning(
+                        "LLM quota/rate-limit kvarstår efter %d retry(s). Växlar till fallback.",
+                        self.policy.max_quota_retries,
+                    )
+                    self._force_fallback = True
+                    return await self.fallback.chat(messages, temperature=temperature)
+
+                log.warning(
+                    "LLM rate-limited (attempt %d/%d). Väntar %ss och retry...",
+                    attempt,
+                    self.policy.max_quota_retries,
+                    wait_s,
+                )
+                await asyncio.sleep(wait_s)