soliplex 0.75.3__tar.gz → 0.76__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: soliplex
-Version: 0.75.3
+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.3 → soliplex-0.76}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "soliplex"
-version = "0.75.3"
+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
@@ -93,6 +93,7 @@ markers = [
 
 [tool.coverage.run]
 omit = [
+    "scripts/lint_textio.py",   # runs its own '--self-test' during lint
     "src/soliplex/cli/__init__.py",
     "src/soliplex/tui.py",
 ]

{soliplex-0.75.3 → 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.3 → soliplex-0.76}/src/soliplex/agui/__init__.py

@@ -8,6 +8,7 @@ import typing
 
 import fastapi
 from ag_ui import core as agui_core
+from pydantic_ai import ui as ai_ui
 from sqlalchemy.ext import asyncio as sqla_asyncio
 
 AGUI_Events = list[agui_core.Event]
@@ -22,6 +23,16 @@ _COMPACTIBLE_TYPES = {  # event_type: compacting_attr
     agui_core.EventType.TOOL_CALL_ARGS: "tool_call_id",
 }
 
+#
+#   Events which terminate a run's event stream
+#
+TERMINAL_EVENT_TYPES = frozenset(
+    [
+        agui_core.EventType.RUN_FINISHED,
+        agui_core.EventType.RUN_ERROR,
+    ]
+)
+
 
 class AGUI_Exception(ValueError):
     status_code = 400
@@ -582,6 +593,24 @@ async def compact_event_stream(stream: AGUI_EventStream):
                 yield event
 
 
+async def with_final_state(
+    *,
+    stream: AGUI_EventStream,
+    deps: ai_ui.StateHandler | None,
+) -> AGUI_EventStream:
+    """Yield events from 'stream', adding a final AG-UI state snapshot.
+
+    The snapshot precedes the run's terminal event: AG-UI clients may stop
+    reading after a terminal event, and on replay the parser only accepts a
+    snapshot while the run is still in the RUNNING state.
+    """
+    async for event in stream:
+        if deps is not None and event.type in TERMINAL_EVENT_TYPES:
+            yield agui_core.StateSnapshotEvent(snapshot=deps.state)
+
+        yield event
+
+
 async def get_the_threads(request: fastapi.Request) -> ThreadStorage:
     from . import persistence
 

{soliplex-0.75.3 → soliplex-0.76}/src/soliplex/agui/parser.py

@@ -244,6 +244,15 @@ class EventStreamParser:
     result: typing.Any = None
 
     state: dict = dataclasses.field(default_factory=dict)
+
+    #   Currently-skipped deltas: non-empty means our 'state' is incomplete.
+    #   See 'STATE_DELTA' handling below (#1257).
+    invalid_state_deltas: Events = dataclasses.field(default_factory=list)
+
+    #   All skipped deltas, preserved even when a snapshot heals our 'state'.
+    #   See 'STATE_DELTA' handling below (#1257).
+    skipped_state_deltas: Events = dataclasses.field(default_factory=list)
+
     messages: Messages = dataclasses.field(default_factory=list)
 
     messages_by_id: MessagesByID = dataclasses.field(default_factory=dict)
@@ -484,15 +493,37 @@ class EventStreamParser:
             case agui_core.EventType.STATE_DELTA:
                 self._assert_running(event)
 
-                new_state = jsonpatch.apply_patch(self.state, event.delta)
+                try:
+                    new_state = jsonpatch.apply_patch(self.state, event.delta)
+
+                except (
+                    jsonpatch.JsonPatchException,
+                    jsonpatch.JsonPointerException,
+                ):
+                    # The delta was recorded against state we don't have,
+                    # and therefore cannot be applied.  Skip it, but record
+                    # it twice:
+                    #
+                    # - 'invalid_state_deltas' signals that our current 'state'
+                    #   is incomplete.
+                    #
+                    # - 'skipped_state_deltas' preserves the skip for later
+                    #   debugging, even when a subsequent 'STATE_SNAPSHOT"
+                    #   clears the invalid list.
+                    self.invalid_state_deltas.append(event)
+                    self.skipped_state_deltas.append(event)
 
-                self.state = new_state
+                else:
+                    self.state = new_state
 
             case agui_core.EventType.STATE_SNAPSHOT:
                 self._assert_running(event)
 
                 self.state = event.snapshot
 
+                # Clear the invalid list, because our 'state' is now correct.
+                self.invalid_state_deltas.clear()
+
             case agui_core.EventType.MESSAGES_SNAPSHOT:
                 self._assert_running(event)
 

{soliplex-0.75.3 → soliplex-0.76}/src/soliplex/agui/persistence.py

@@ -962,7 +962,11 @@ async def drive_agui_turn(
 
     ``run_stream_kwargs`` is forwarded verbatim to the Pydantic AI adapter.
     """
-    event_stream = adapter.run_stream(**(run_stream_kwargs or {}))
+    stream_kwargs = run_stream_kwargs or {}
+    event_stream = agui.with_final_state(
+        stream=adapter.run_stream(**stream_kwargs),
+        deps=stream_kwargs.get("deps"),
+    )
     compacted = agui.compact_event_stream(event_stream)
     async for event in compacted:
         try:

{soliplex-0.75.3 → soliplex-0.76}/src/soliplex/cli/admin_users.py

@@ -472,7 +472,7 @@ def admin_users_as_yaml(
     yaml_text = _admin_users_as_yaml(discriminators)
 
     if output is not None:
-        output.write_text(yaml_text)
+        output.write_text(yaml_text, encoding="utf-8")
     else:
         print(yaml_text, end="")
 
@@ -508,7 +508,7 @@ def admin_users_from_yaml(
     cli_util._check_ram_dburi(dburi, "admin-users from-yaml")
 
     if input_ is not None:
-        yaml_text = input_.read_text()
+        yaml_text = input_.read_text(encoding="utf-8")
     else:
         yaml_text = sys.stdin.read()
 

{soliplex-0.75.3 → soliplex-0.76}/src/soliplex/cli/audit.py

@@ -1060,7 +1060,7 @@ def _load_logging_config(the_installation):
     pyl_config = the_installation._config.logging_config_file
     if pyl_config is None:
         return None
-    with pyl_config.open() as f:
+    with pyl_config.open(encoding="utf-8") as f:
         return yaml.safe_load(f)
 
 

{soliplex-0.75.3 → soliplex-0.76}/src/soliplex/cli/room_authz.py

@@ -325,7 +325,7 @@ def room_authz_as_yaml(
     yaml_text = _room_policy_as_yaml(policy)
 
     if output is not None:
-        output.write_text(yaml_text)
+        output.write_text(yaml_text, encoding="utf-8")
     else:
         print(yaml_text, end="")
 
@@ -372,7 +372,7 @@ def room_authz_from_yaml(
     cli_util._check_ram_dburi(dburi, "room-authz from-yaml")
 
     if input_ is not None:
-        yaml_text = input_.read_text()
+        yaml_text = input_.read_text(encoding="utf-8")
     else:
         yaml_text = sys.stdin.read()
 

{soliplex-0.75.3 → 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
                 ]
 
@@ -236,7 +279,7 @@ class AgentConfig:
             system_prompt_file = (
                 self._config_path.parent / self._system_prompt_path
             )
-            return system_prompt_file.read_text()
+            return system_prompt_file.read_text(encoding="utf-8")
 
         else:  # pragma: NO COVER
             pass
@@ -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,