hivemind-persona-agent-plugin 0.0.1__tar.gz

hivemind_persona_agent_plugin-0.0.1/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: hivemind-persona-agent-plugin
+Version: 0.0.1
+Summary: ovos-persona (LLM/solver) agent protocol plugin for HiveMind-core
+Author-email: jarbasAi <jarbasai@mailfence.com>
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/JarbasHiveMind/hivemind-persona-agent-plugin
+Project-URL: Issues, https://github.com/JarbasHiveMind/hivemind-persona-agent-plugin/issues
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: ovos-bus-client<2.0.0,>=1.3.1
+Requires-Dist: ovos-config<3.0.0,>=0.0.12
+Requires-Dist: ovos-utils<1.0.0,>=0.8.2
+Requires-Dist: hivemind-bus-client<1.0.0,>=0.7.0a2
+Requires-Dist: hivemind-plugin-manager<1.0.0,>=0.5.0
+Requires-Dist: pyee<13.0.0,>=8.1.0
+Requires-Dist: ovos-persona<2.0.0,>=0.1.0
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+
+# hivemind-persona-agent-plugin
+
+An [ovos-persona](https://github.com/OpenVoiceOS/ovos-persona) agent protocol for
+[HiveMind-core](https://github.com/JarbasHiveMind/HiveMind-core): the hub answers
+natural-language queries from an LLM/solver persona instead of a full OVOS skills
+stack.
+
+It is the clean implementation of `AgentProtocol.natural_language_query` — the
+persona *is* a question-answerer, so the seam maps directly onto
+`Persona.stream`, yielding the answer sentence by sentence (and a final `None`
+end-of-query sentinel) so a satellite can start speaking before generation
+finishes.
+
+## Configure
+
+```json
+{
+  "agent_protocol": {
+    "module": "hivemind-persona-agent-plugin",
+    "hivemind-persona-agent-plugin": {
+      "persona": "~/.config/ovos_persona/persona.json"
+    }
+  }
+}
+```
+
+`persona` may be a path to a persona JSON file or an inline persona config dict.

hivemind_persona_agent_plugin-0.0.1/README.md

@@ -0,0 +1,27 @@
+# hivemind-persona-agent-plugin
+
+An [ovos-persona](https://github.com/OpenVoiceOS/ovos-persona) agent protocol for
+[HiveMind-core](https://github.com/JarbasHiveMind/HiveMind-core): the hub answers
+natural-language queries from an LLM/solver persona instead of a full OVOS skills
+stack.
+
+It is the clean implementation of `AgentProtocol.natural_language_query` — the
+persona *is* a question-answerer, so the seam maps directly onto
+`Persona.stream`, yielding the answer sentence by sentence (and a final `None`
+end-of-query sentinel) so a satellite can start speaking before generation
+finishes.
+
+## Configure
+
+```json
+{
+  "agent_protocol": {
+    "module": "hivemind-persona-agent-plugin",
+    "hivemind-persona-agent-plugin": {
+      "persona": "~/.config/ovos_persona/persona.json"
+    }
+  }
+}
+```
+
+`persona` may be a path to a persona JSON file or an inline persona config dict.

hivemind_persona_agent_plugin-0.0.1/hivemind_persona_agent_plugin/__init__.py

@@ -0,0 +1,45 @@
+"""HiveMind agent protocol backed by an ovos-persona LLM/solver.
+
+Answers natural-language queries directly from the persona — no OVOS bus
+round-trip — streaming the model's output as it is produced. This is the
+clean case for ``AgentProtocol.natural_language_query``: the agent *is* a
+question-answerer, so the abstraction maps straight onto ``Persona.stream``.
+"""
+import dataclasses
+import json
+import os
+from typing import Any, Dict, Iterator, Optional
+
+from ovos_persona import Persona
+from ovos_utils.log import LOG
+
+from hivemind_plugin_manager.protocols import AgentProtocol
+
+from hivemind_persona_agent_plugin.version import __version__
+
+
+@dataclasses.dataclass
+class PersonaAgentProtocol(AgentProtocol):
+    """AgentProtocol that answers queries from an ovos-persona."""
+    config: Dict[str, Any] = dataclasses.field(default_factory=dict)
+
+    def __post_init__(self):
+        cfg = self.config.get("persona", {})
+        if isinstance(cfg, str):  # a path to a persona.json
+            with open(os.path.expanduser(cfg)) as f:
+                cfg = json.load(f)
+        self.persona = Persona(name=cfg.get("name", "HiveMind Persona"),
+                               config=cfg)
+
+    def natural_language_query(self, utterance: str,
+                               lang: str) -> "Iterator[Optional[str]]":
+        """Stream the persona's answer sentence by sentence, then yield the
+        ``None`` end-of-query sentinel."""
+        messages = [{"role": "user", "content": utterance}]
+        try:
+            for chunk in self.persona.stream(messages, lang=lang):
+                if chunk:
+                    yield chunk
+        except Exception:
+            LOG.exception("persona natural_language_query failed")
+        yield None

hivemind_persona_agent_plugin-0.0.1/hivemind_persona_agent_plugin/version.py

@@ -0,0 +1,7 @@
+# START_VERSION_BLOCK
+VERSION_MAJOR = 0
+VERSION_MINOR = 0
+VERSION_BUILD = 1
+VERSION_ALPHA = 0
+# END_VERSION_BLOCK
+__version__ = VERSION = f"{VERSION_MAJOR}.{VERSION_MINOR}.{VERSION_BUILD}" + (f"a{VERSION_ALPHA}" if VERSION_ALPHA else "")

hivemind_persona_agent_plugin-0.0.1/hivemind_persona_agent_plugin.egg-info/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: hivemind-persona-agent-plugin
+Version: 0.0.1
+Summary: ovos-persona (LLM/solver) agent protocol plugin for HiveMind-core
+Author-email: jarbasAi <jarbasai@mailfence.com>
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/JarbasHiveMind/hivemind-persona-agent-plugin
+Project-URL: Issues, https://github.com/JarbasHiveMind/hivemind-persona-agent-plugin/issues
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: ovos-bus-client<2.0.0,>=1.3.1
+Requires-Dist: ovos-config<3.0.0,>=0.0.12
+Requires-Dist: ovos-utils<1.0.0,>=0.8.2
+Requires-Dist: hivemind-bus-client<1.0.0,>=0.7.0a2
+Requires-Dist: hivemind-plugin-manager<1.0.0,>=0.5.0
+Requires-Dist: pyee<13.0.0,>=8.1.0
+Requires-Dist: ovos-persona<2.0.0,>=0.1.0
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+
+# hivemind-persona-agent-plugin
+
+An [ovos-persona](https://github.com/OpenVoiceOS/ovos-persona) agent protocol for
+[HiveMind-core](https://github.com/JarbasHiveMind/HiveMind-core): the hub answers
+natural-language queries from an LLM/solver persona instead of a full OVOS skills
+stack.
+
+It is the clean implementation of `AgentProtocol.natural_language_query` — the
+persona *is* a question-answerer, so the seam maps directly onto
+`Persona.stream`, yielding the answer sentence by sentence (and a final `None`
+end-of-query sentinel) so a satellite can start speaking before generation
+finishes.
+
+## Configure
+
+```json
+{
+  "agent_protocol": {
+    "module": "hivemind-persona-agent-plugin",
+    "hivemind-persona-agent-plugin": {
+      "persona": "~/.config/ovos_persona/persona.json"
+    }
+  }
+}
+```
+
+`persona` may be a path to a persona JSON file or an inline persona config dict.

hivemind_persona_agent_plugin-0.0.1/hivemind_persona_agent_plugin.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+hivemind_persona_agent_plugin/__init__.py
+hivemind_persona_agent_plugin/version.py
+hivemind_persona_agent_plugin.egg-info/PKG-INFO
+hivemind_persona_agent_plugin.egg-info/SOURCES.txt
+hivemind_persona_agent_plugin.egg-info/dependency_links.txt
+hivemind_persona_agent_plugin.egg-info/entry_points.txt
+hivemind_persona_agent_plugin.egg-info/requires.txt
+hivemind_persona_agent_plugin.egg-info/top_level.txt
+tests/test_import.py

hivemind_persona_agent_plugin-0.0.1/hivemind_persona_agent_plugin.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

hivemind_persona_agent_plugin-0.0.1/hivemind_persona_agent_plugin.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[hivemind.agent.protocol]
+hivemind-persona-agent-plugin = hivemind_persona_agent_plugin:PersonaAgentProtocol

hivemind_persona_agent_plugin-0.0.1/hivemind_persona_agent_plugin.egg-info/requires.txt

@@ -0,0 +1,15 @@
+ovos-bus-client<2.0.0,>=1.3.1
+ovos-config<3.0.0,>=0.0.12
+ovos-utils<1.0.0,>=0.8.2
+hivemind-bus-client<1.0.0,>=0.7.0a2
+hivemind-plugin-manager<1.0.0,>=0.5.0
+pyee<13.0.0,>=8.1.0
+ovos-persona<2.0.0,>=0.1.0
+
+[dev]
+pytest
+pytest-cov
+
+[test]
+pytest
+pytest-cov

hivemind_persona_agent_plugin-0.0.1/hivemind_persona_agent_plugin.egg-info/top_level.txt

@@ -0,0 +1 @@
+hivemind_persona_agent_plugin

hivemind_persona_agent_plugin-0.0.1/pyproject.toml

@@ -0,0 +1,54 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "hivemind-persona-agent-plugin"
+dynamic = ["version"]
+description = "ovos-persona (LLM/solver) agent protocol plugin for HiveMind-core"
+license = { text = "Apache-2.0" }
+readme = "README.md"
+authors = [
+    { name = "jarbasAi", email = "jarbasai@mailfence.com" }
+]
+requires-python = ">=3.10"
+dependencies = [
+    "ovos-bus-client>=1.3.1,<2.0.0",
+    "ovos-config>=0.0.12,<3.0.0",
+    "ovos-utils>=0.8.2,<1.0.0",
+    "hivemind-bus-client>=0.7.0a2,<1.0.0",
+    # NOTE: floor stays at 0.5.0 while #27 is in CI as a branch install
+    # (gh-automations only bumps version.py on merge to dev). Tighten
+    # to >=0.6.0a1 once #27 is released.
+    "hivemind-plugin-manager>=0.5.0,<1.0.0",
+    "pyee>=8.1.0,<13.0.0",
+    "ovos-persona>=0.1.0,<2.0.0",
+]
+
+[project.optional-dependencies]
+test = [
+    "pytest",
+    "pytest-cov",
+]
+# Alias so gh-automations' `pip install -e ".[dev]"` first-attempt path
+# resolves; without `dev` it falls through to a buggy `pip install test`
+# literal branch in the upstream workflow.
+dev = [
+    "pytest",
+    "pytest-cov",
+]
+
+[project.urls]
+Homepage = "https://github.com/JarbasHiveMind/hivemind-persona-agent-plugin"
+Issues = "https://github.com/JarbasHiveMind/hivemind-persona-agent-plugin/issues"
+
+[project.entry-points."hivemind.agent.protocol"]
+"hivemind-persona-agent-plugin" = "hivemind_persona_agent_plugin:PersonaAgentProtocol"
+
+
+[tool.setuptools.dynamic]
+version = { attr = "hivemind_persona_agent_plugin.version.__version__" }
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["hivemind_persona_agent_plugin*"]

hivemind_persona_agent_plugin-0.0.1/setup.cfg

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

hivemind_persona_agent_plugin-0.0.1/tests/test_import.py

@@ -0,0 +1,11 @@
+def test_is_agent_protocol_subclass():
+    from hivemind_plugin_manager.protocols import AgentProtocol
+    from hivemind_persona_agent_plugin import PersonaAgentProtocol
+    assert issubclass(PersonaAgentProtocol, AgentProtocol)
+
+
+def test_implements_mandatory_nlq():
+    # the streaming abc method is satisfied (class is concrete/instantiable)
+    from hivemind_persona_agent_plugin import PersonaAgentProtocol
+    assert "natural_language_query" not in getattr(
+        PersonaAgentProtocol, "__abstractmethods__", set())