soliplex 0.75.4__tar.gz → 0.76__tar.gz

{soliplex-0.75.4/src/soliplex.egg-info → soliplex-0.76}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: soliplex
-Version: 0.75.4
+Version: 0.76
 Summary: An AI-powered Retrieval-Augmented Generation (RAG) system with a modern web interface.
 Author-email: Enfold <info@enfoldsystems.net>
 Classifier: Programming Language :: Python :: 3
@@ -13,13 +13,13 @@ Requires-Dist: aiohttp<3.15,>=3.14.2
 Requires-Dist: aiosqlite
 Requires-Dist: alembic<1.19,>=1.18.4
 Requires-Dist: authlib
-Requires-Dist: bubble-sandbox<0.11,>=0.10.0
+Requires-Dist: bubble-sandbox<0.12,>=0.11.0
 Requires-Dist: cryptography>=50.0.0
 Requires-Dist: fastapi
 Requires-Dist: fastmcp<3.4,>=3.3.0
 Requires-Dist: fakeredis!=2.35.0
 Requires-Dist: greenlet
-Requires-Dist: haiku.rag-slim<0.74,>=0.73.0
+Requires-Dist: haiku.rag-slim<0.75,>=0.74.0
 Requires-Dist: idna>=3.15
 Requires-Dist: itsdangerous
 Requires-Dist: joserfc<1.7,>=1.6.7
@@ -46,6 +46,17 @@ Dynamic: license-file
 
 An AI-powered Retrieval-Augmented Generation (RAG) system with a modern web interface.
 
+## Overview
+
+Soliplex is a self-hosted, full-stack RAG/AI system: a FastAPI backend
+(a thin configuration and authentication layer around
+[pydantic-ai](https://ai.pydantic.dev/)), a hardened
+[Flutter client](https://github.com/soliplex/frontend), and a terminal UI.
+
+See the [Overview](docs/overview.md) for what Soliplex is, when (and when not)
+to use it, how it compares to alternatives, and the full feature and
+architecture breakdown.
+
 ## Quickstart
 
 The fastest way to stand up and run your own Soliplex is to let a
@@ -123,17 +134,6 @@ and then *"What is a Soliplex installation?"*
 > and developing on the backend itself. If you only want to *use* Soliplex,
 > the two skills above are all you need.
 
-## Overview
-
-Soliplex is a self-hosted, full-stack RAG/AI system: a FastAPI backend
-(a thin configuration and authentication layer around
-[pydantic-ai](https://ai.pydantic.dev/)), a hardened
-[Flutter client](https://github.com/soliplex/frontend), and a terminal UI.
-
-See the [Overview](docs/overview.md) for what Soliplex is, when (and when not)
-to use it, how it compares to alternatives, and the full feature and
-architecture breakdown.
-
 ## Running from source
 
 The skills-based [Quickstart](#quickstart) above is the recommended path for
@@ -150,6 +150,26 @@ most users. To run Soliplex from a checkout of this repository instead, see:
 - [Client Setup](docs/client.md) -- run the Flutter web client.
 - [Docker Deployment](docs/docker.md) -- run the full stack with Docker Compose.
 
+## Documentation
+
+The full documentation set lives in [`docs/`](docs/) and is published as a
+[Zensical site](https://soliplex.github.io/soliplex/):
+
+> **Tip:** the same documentation is also available as the `soliplex-docs`
+> Agent Skill, so a skills-compatible agent can answer questions straight from
+> it -- see the [Quickstart](#quickstart) above.
+
+- [Overview](docs/overview.md)
+- [Prerequisites](docs/prerequisites.md)
+- [Server Setup](docs/server/index.md) and
+  [CLI Reference](docs/server/cli.md)
+- [Client Setup](docs/client.md)
+- [Docker Deployment](docs/docker.md)
+- [RAG Database](docs/rag.md)
+- [Documentation Skill](docs/docs-skill.md)
+- [Configuration](docs/config/)
+- [Usage](docs/usage.md)
+
 ## Configuration
 
 Soliplex is configured by a tree of YAML files rooted at an
@@ -173,26 +193,6 @@ Soliplex is configured by a tree of YAML files rooted at an
   [Console logging](docs/config/logging.md),
   [SQLAlchemy DBURIs](docs/config/dburis.md)
 
-## Documentation
-
-The full documentation set lives in [`docs/`](docs/) and is published as a
-[Zensical site](https://soliplex.github.io/soliplex/):
-
-> **Tip:** the same documentation is also available as the `soliplex-docs`
-> Agent Skill, so a skills-compatible agent can answer questions straight from
-> it -- see the [Quickstart](#quickstart) above.
-
-- [Overview](docs/overview.md)
-- [Prerequisites](docs/prerequisites.md)
-- [Server Setup](docs/server/index.md) and
-  [CLI Reference](docs/server/cli.md)
-- [Client Setup](docs/client.md)
-- [Docker Deployment](docs/docker.md)
-- [RAG Database](docs/rag.md)
-- [Documentation Skill](docs/docs-skill.md)
-- [Configuration](docs/config/)
-- [Usage](docs/usage.md)
-
 ## Development
 
 Contributor guidance -- setup, build and test commands, code style, the

{soliplex-0.75.4 → soliplex-0.76}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "soliplex"
-version = "0.75.4"
+version = "0.76"
 description = "An AI-powered Retrieval-Augmented Generation (RAG) system with a modern web interface."
 authors = [{ name = "Enfold", email = "info@enfoldsystems.net" }]
 readme = "README.md"
@@ -19,13 +19,13 @@ dependencies = [
     "aiosqlite",
     "alembic >= 1.18.4, < 1.19",
     "authlib",
-    "bubble-sandbox >= 0.10.0, < 0.11",
+    "bubble-sandbox >= 0.11.0, < 0.12",
     "cryptography >= 50.0.0",  # PYSEC-2026-3552
     "fastapi",
     "fastmcp >= 3.3.0, < 3.4",
     "fakeredis != 2.35.0",  # brownbag
     "greenlet",
-    "haiku.rag-slim >= 0.73.0, < 0.74",
+    "haiku.rag-slim >= 0.74.0, < 0.75",
     "idna >= 3.15",
     "itsdangerous",
     "joserfc >= 1.6.7, < 1.7",  # CVE-2026-48990

{soliplex-0.75.4 → soliplex-0.76}/src/soliplex/agents.py

@@ -4,8 +4,10 @@ import dataclasses
 import typing
 
 import pydantic_ai
-from haiku.rag.capabilities import AnalysisCapability
-from haiku.rag.capabilities import RAGCapability
+from haiku.rag.capabilities import analysis as hr_caps_analysis
+from haiku.rag.capabilities import compaction as hr_caps_compaction
+from haiku.rag.capabilities import policy as hr_caps_policy
+from haiku.rag.capabilities import rag as hr_caps_rag
 from pydantic_ai import agent as ai_agent
 from pydantic_ai import capabilities as ai_capabilities
 from pydantic_ai import tools as ai_tools
@@ -20,6 +22,18 @@ from soliplex.config import tools as config_tools
 
 ToolConfigMap = dict[str, typing.Any]
 
+# Capabilities which take 'vision' from agent config's 'multimodal'
+HR_VisionCapabilities = (
+    hr_caps_rag.RAGCapability | hr_caps_analysis.AnalysisCapability
+)
+
+# Capabilities which can always be eagerly loaded
+HookOnlyCapabilities = (
+    hr_caps_compaction.EvidenceCompactionCapability
+    | hr_caps_policy.CitationPolicyCapability
+    | cap_rag_audit.RAGAccessAuditCapability
+)
+
 
 class CapabilityConfig(typing.Protocol):
     """Room-specific native capabilities and their audit targets."""
@@ -114,16 +128,20 @@ def get_default_agent_from_configs(
     # agent's model, not haiku.rag's configured model, so gate on the room
     # agent's declared multimodality.
     for capability in capabilities:
-        if isinstance(capability, (RAGCapability, AnalysisCapability)):
+        if isinstance(capability, HR_VisionCapabilities):
             capability.vision = agent_config.multimodal
 
     # A single model-facing capability loads eagerly so its tools are visible;
-    # multiple stay deferred so the model routes between them via
-    # load_capability. The audit capability is hook-only and always eager.
+    #
+    # Multiple stay deferred so the model routes between them via
+    # 'load_capability'.
+    #
+    # Hook-only capabilities expose no tools to route
+    # between, so they neither defer nor count.
     routing_capabilities = [
         capability
         for capability in capabilities
-        if not isinstance(capability, cap_rag_audit.RAGAccessAuditCapability)
+        if not isinstance(capability, HookOnlyCapabilities)
     ]
     defer_loading = len(routing_capabilities) > 1
     for capability in routing_capabilities:

{soliplex-0.75.4 → soliplex-0.76}/src/soliplex/config/agents.py

@@ -5,6 +5,7 @@ import enum
 import functools
 import pathlib
 import typing
+import warnings
 from collections import abc
 
 from pydantic_ai import capabilities as ai_capabilities
@@ -50,13 +51,29 @@ class UnknownCapability(KeyError):
     def __init__(self, name, _config_path=None):
         self.name = name
         self._config_path = _config_path
-        if _config_path is not None:
-            super().__init__(
-                f"Unknown capability name: {name} "
-                f"(configured in {_config_path})"
-            )
-        else:
-            super().__init__(f"Unknown capability name: {name}")
+
+        super().__init__(
+            f"Unknown capability name: {name} (configured in {_config_path})"
+        )
+
+
+class UnknownAgentConfigKind(KeyError):
+    def __init__(self, kind, _config_path=None):
+        self.kind = kind
+        self._config_path = _config_path
+        super().__init__(
+            f"Unknown agent config kind: {kind} (configured in {_config_path})"
+        )
+
+
+class AgentConfigKindMismatch(ValueError):
+    def __init__(self, found_kind, expected_kind):
+        self.found_kind = found_kind
+        self.expected_kind = expected_kind
+        super().__init__(
+            "Agent config kind mismatch: "
+            f"found '{found_kind}', expected '{expected_kind}'"
+        )
 
 
 class LLMProviderType(enum.StrEnum):
@@ -97,6 +114,13 @@ def _apply_agent_config_template(
     return config_dict
 
 
+ACC_BBB_NO_NAME_KEY_DEPRECATED = """\
+AgentCapabilityConfig.from_yaml: '{<name>: <kwargs>}' form is deprecated;
+use '{"name": <name>, "kwargs": <kwargs>}' instead.  Support for the form
+will be removed after 'v0.76'.
+"""
+
+
 @dataclasses.dataclass(kw_only=True)
 class AgentCapabilityConfig:
     name: str
@@ -104,36 +128,47 @@ class AgentCapabilityConfig:
 
     _config_path: pathlib.Path = None
 
+    @classmethod
+    def from_yaml(
+        cls,
+        config_path: pathlib.Path,
+        config_dict_or_str: str | dict,
+    ):
+        if isinstance(config_dict_or_str, str):
+            name = config_dict_or_str
+            config_dict = {"name": name}
+        else:
+            if "name" not in config_dict_or_str:  # BBB deprecated
+                warnings.warn(
+                    ACC_BBB_NO_NAME_KEY_DEPRECATED,
+                    DeprecationWarning,
+                    stacklevel=2,
+                )
+                ((name, kwargs),) = config_dict_or_str.items()
+                config_dict = {"name": name, "kwargs": kwargs}
+            else:
+                name = config_dict_or_str["name"]
+                config_dict = config_dict_or_str
+
+        if name not in AGENT_CAPABILITY_CLASSES_BY_NAME:
+            raise UnknownCapability(name, config_path)
+
+        return cls(**config_dict, _config_path=config_path)
+
+    @property
+    def as_yaml(self) -> dict:
+        return {"name": self.name, "kwargs": self.kwargs}
+
     @property
     def as_capability(self) -> ai_capabilities.AbstractCapability:
         try:
             cap_klass = AGENT_CAPABILITY_CLASSES_BY_NAME[self.name]
         except KeyError:
-            raise UnknownCapability(self.name) from None
+            raise UnknownCapability(self.name, self._config_path) from None
 
         return cap_klass(**self.kwargs)
 
 
-def extract_capability_config(
-    cap_config: str | dict[str, typing.Any],
-    _config_path: pathlib.Path,
-) -> AgentCapabilityConfig:
-    if isinstance(cap_config, str):
-        name = cap_config
-        kwargs = {}
-    else:
-        ((name, kwargs),) = cap_config.items()
-
-    if name not in AGENT_CAPABILITY_CLASSES_BY_NAME:
-        raise UnknownCapability(name, _config_path)
-
-    return AgentCapabilityConfig(
-        name=name,
-        kwargs=kwargs,
-        _config_path=_config_path,
-    )
-
-
 @dataclasses.dataclass(kw_only=True)
 class AgentConfig:
     #
@@ -177,6 +212,11 @@ class AgentConfig:
         if system_prompt is not None:
             self._system_prompt_text = system_prompt
 
+    @classmethod
+    def _check_kind(cls, kind):
+        if kind not in (None, cls.kind):
+            raise AgentConfigKindMismatch(kind, cls.kind)
+
     @classmethod
     def from_yaml(
         cls,
@@ -185,6 +225,9 @@ class AgentConfig:
         config_dict: dict,
     ):
         try:
+            kind = config_dict.pop("kind", None)
+            cls._check_kind(kind)
+
             config_dict["_installation_config"] = installation_config
             config_dict["_config_path"] = config_path
 
@@ -210,7 +253,7 @@ class AgentConfig:
             capabilities = config_dict.pop("capabilities", None)
             if capabilities is not None:
                 config_dict["_capability_configs"] = [
-                    extract_capability_config(cap, config_path)
+                    AgentCapabilityConfig.from_yaml(config_path, cap)
                     for cap in capabilities
                 ]
 
@@ -282,24 +325,25 @@ class AgentConfig:
             if self._system_prompt_text is None
             else self._system_prompt_text
         )
-        if self.provider_base_url is None:
-            provider_base_url = self._installation_config.get_environment(
-                "OLLAMA_BASE_URL"
-            )
-        else:
-            provider_base_url = self.provider_base_url
+        capabilities = {}
+
+        for cap_cfg in self._capability_configs:
+            cap_list = capabilities.setdefault("capabilities", [])
+            cap_list.append(cap_cfg.as_yaml)
 
         return {
             "id": self.id,
+            "kind": self.kind,
             "model_name": self.model_name,
             "retries": self.retries,
             "system_prompt": prompt,
             "model_settings": self.model_settings,
             "multimodal": self.multimodal,
             "provider_type": str(self.provider_type),
-            "provider_base_url": provider_base_url,
+            "provider_base_url": self.provider_base_url,
             "provider_key": self.provider_key,  # "secret:SECRET_NAME"
-        }
+            "agui_feature_names": self.agui_feature_names,
+        } | capabilities
 
 
 AgentFactory = abc.Callable[[], ai_ag_abstract.AbstractAgent]
@@ -342,6 +386,11 @@ class FactoryAgentConfig:
 
         return self._factory
 
+    @classmethod
+    def _check_kind(cls, kind):
+        if kind not in (None, cls.kind):
+            raise AgentConfigKindMismatch(kind, cls.kind)
+
     @classmethod
     def from_yaml(
         cls,
@@ -350,6 +399,9 @@ class FactoryAgentConfig:
         config_dict: dict,
     ):
         try:
+            kind = config_dict.pop("kind", None)
+            cls._check_kind(kind)
+
             config_dict["_installation_config"] = installation_config
             config_dict["_config_path"] = config_path
 
@@ -379,6 +431,7 @@ class FactoryAgentConfig:
             "factory_name": self.factory_name,
             "with_agent_config": self.with_agent_config,
             "extra_config": self.extra_config,
+            "agui_feature_names": self.agui_feature_names,
         }
 
 
@@ -400,14 +453,17 @@ def extract_agent_config(
     config_path: pathlib.Path,
     config_dict: dict,
 ) -> AgentConfig:  # or subclass
-    agent_kind = config_dict.get("kind")
 
-    if agent_kind is not None:  # kind is a typing.ClassVar
-        config_dict = {
-            key: value for key, value in config_dict.items() if key != "kind"
-        }
+    # YAML not required to specify 'kind'
+    agent_kind = config_dict.get("kind", AgentConfig.kind)
 
-    ac_class = AGENT_CONFIG_CLASSES_BY_KIND.get(agent_kind, AgentConfig)
+    try:
+        ac_class = AGENT_CONFIG_CLASSES_BY_KIND[agent_kind]
+    except KeyError:
+        raise UnknownAgentConfigKind(
+            agent_kind,
+            config_path,
+        ) from None
 
     return ac_class.from_yaml(
         installation_config,

{soliplex-0.75.4 → soliplex-0.76}/src/soliplex/config/installation.py

@@ -857,13 +857,14 @@ class InstallationConfig:
                 for mwc_yaml in config_dict.get("middleware_stack", ())
             ]
 
-            config_dict["app_router_operations"] = [
-                config_routing.app_router_operation_from_yaml(
-                    config_path,
-                    ar_yaml,
-                )
-                for ar_yaml in config_dict.get("app_router_operations", ())
-            ]
+            aro_klasses_by_kind = config_routing.APP_ROUTER_OPERATIONS_BY_KIND
+            aros, aros_cfg = config_dict.pop("app_router_operations", []), []
+
+            for aro in aros:
+                klass = aro_klasses_by_kind[aro["kind"]]
+                aros_cfg.append(klass.from_yaml(config_path, aro))
+
+            config_dict["app_router_operations"] = aros_cfg
 
             secret_configs = [
                 config_secrets.SecretConfig.from_yaml(
@@ -1067,6 +1068,8 @@ class InstallationConfig:
     def as_yaml(self) -> dict:
         result = {
             "id": self.id,
+            "server_name": self.server_name,
+            "server_description": self.server_description,
             "meta": self.meta.as_yaml,
             "secrets": [secret.as_yaml for secret in self.secrets],
             # Dump the resolved version, not the original config
@@ -1076,13 +1079,31 @@ class InstallationConfig:
             "filesystem_skills_paths": [
                 str(path) for path in self.filesystem_skills_paths
             ],
-            "logging_config_file": str(self._logging_config_file),
             "oidc_paths": [str(path) for path in self.oidc_paths],
             "room_paths": [str(path) for path in self.room_paths],
             "completion_paths": [str(path) for path in self.completion_paths],
             "quizzes_paths": [str(path) for path in self.quizzes_paths],
+            "thread_persistence_dburi": {
+                "sync": self._thread_persistence_dburi_sync,
+                "async": self._thread_persistence_dburi_async,
+            },
+            "authorization_dburi": {
+                "sync": self._authorization_dburi_sync,
+                "async": self._authorization_dburi_async,
+            },
         }
 
+        if self.disable_dotenv:
+            result["disable_dotenv"] = True
+
+        if self.middleware_stack:
+            result["middleware_stack"] = [
+                layer.as_yaml for layer in self.middleware_stack
+            ]
+
+        if self._skill_configs is not None:
+            result["skill_configs"] = self._skill_configs
+
         if self.rooms_upload_path:
             result["rooms_upload_path"] = str(self.rooms_upload_path)
 
@@ -1098,6 +1119,15 @@ class InstallationConfig:
         if self.logfire_config is not None:
             result["logfire_config"] = self.logfire_config.as_yaml
 
+        if self._logging_config_file is not None:
+            result["logging_config_file"] = str(self._logging_config_file)
+
+        if self._logging_headers_map is not None:
+            result["logging_headers_map"] = self.logging_headers_map
+
+        if self._logging_claims_map is not None:
+            result["logging_claims_map"] = self.logging_claims_map
+
         if self.app_router_operations:
             result["app_router_operations"] = [
                 aro.as_yaml for aro in self.app_router_operations