hyperforge-passthrough 1.0.0.post19__tar.gz

hyperforge_passthrough-1.0.0.post19/PKG-INFO

@@ -0,0 +1,19 @@
+Metadata-Version: 2.4
+Name: hyperforge_passthrough
+Version: 1.0.0.post19
+Summary: Passthrough Hyperforge agent
+Author-email: Nuclia <nucliadb@nuclia.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://progress.com
+Project-URL: Repository, https://github.com/nuclia/forge
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <4,>=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: hyperforge
+
+# Passthrough Hyperforge agents

hyperforge_passthrough-1.0.0.post19/README.md

@@ -0,0 +1 @@
+# Passthrough Hyperforge agents

hyperforge_passthrough-1.0.0.post19/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "hyperforge_passthrough"
+version = "1.0.0.post19"
+license = "Apache-2.0"
+description = "Passthrough Hyperforge agent"
+authors = [{ name = "Nuclia", email = "nucliadb@nuclia.com" }]
+readme = "README.md"
+classifiers = [
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+requires-python = ">=3.10, <4"
+dependencies = ["hyperforge"]
+
+[dependency-groups]
+dev = [
+    "pytest",
+    "pytest-benchmark",
+    "pytest-docker-fixtures>=1.4.2",
+    "pytest-lazy-fixtures",
+    "pytest-recording",
+    "pytest-asyncio",
+    "pytest-cov",
+    "pytest-mock",
+]
+
+[project.urls]
+Homepage = "https://progress.com"
+Repository = "https://github.com/nuclia/forge"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"

hyperforge_passthrough-1.0.0.post19/setup.cfg

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

hyperforge_passthrough-1.0.0.post19/src/hyperforge_passthrough/__init__.py

@@ -0,0 +1,4 @@
+from .agent import PassthroughAgent
+
+
+__all__ = ["PassthroughAgent"]

hyperforge_passthrough-1.0.0.post19/src/hyperforge_passthrough/agent.py

@@ -0,0 +1,77 @@
+"""
+Passthrough generation agent.
+
+Returns the retrieved context chunks directly as the answer, with no LLM call.
+Useful for testing and for workflows where the context agent already provides
+a complete answer (e.g. the built-in ``static`` context agent).
+"""
+
+from hyperforge.agent import Agent
+from hyperforge.configure import agent
+from hyperforge.manager import Manager
+from hyperforge.memory import QuestionMemory
+from hyperforge.trace import trace_agent
+
+from hyperforge_passthrough.config import PassthroughAgentConfig
+
+
+@agent(
+    id="passthrough",
+    agent_type="generation",
+    title="Passthrough",
+    description=(
+        "Return the retrieved context directly as the answer without any LLM call. "
+        "Useful for testing or when the context agent already contains the final answer."
+    ),
+    config_schema=PassthroughAgentConfig,
+)
+class PassthroughAgent(Agent[PassthroughAgentConfig]):
+    __root_agent__ = True
+
+    @trace_agent
+    async def __call__(
+        self,
+        memory: QuestionMemory,
+        manager: Manager,
+    ) -> None:
+        if self.config.rich_context:
+            # Gather all context data and pass it through add_answer so it
+            # arrives in possible_answer with all fields populated.
+            # convert_arag_answer_to_content will parse it thoroughly.
+            chunks = [
+                chunk for ctx in memory.contexts for chunk in ctx.chunks if chunk.text
+            ]
+            structured_data = [
+                s for ctx in memory.contexts for s in ctx.structured if s
+            ]
+            images = {
+                k: img
+                for ctx in memory.contexts
+                for k, img in (ctx.images or {}).items()
+            }
+            image_urls = [
+                url for ctx in memory.contexts for url in ctx.image_urls if url
+            ]
+            await memory.add_answer(
+                "",
+                "passthrough",
+                "/generation/passthrough",
+                chunks=chunks,
+                structured=structured_data,
+                images=images,
+                image_urls=image_urls,
+            )
+            return
+
+        # Default behaviour: concatenate all context chunks as a plain-text answer.
+        parts = []
+        for ctx in memory.contexts:
+            for chunk in ctx.chunks:
+                if chunk.text:
+                    parts.append(chunk.text)
+            for structured in ctx.structured:
+                if structured:
+                    parts.append(structured)
+
+        answer = "\n\n".join(parts) if parts else "(no context retrieved)"
+        await memory.add_answer(answer, "passthrough", "/generation/passthrough")

hyperforge_passthrough-1.0.0.post19/src/hyperforge_passthrough/config.py

@@ -0,0 +1,22 @@
+from typing import Literal
+
+from hyperforge.agent import AgentConfig
+from pydantic import Field
+from pydantic.config import ConfigDict
+
+
+class PassthroughAgentConfig(AgentConfig):
+    """Configuration for the passthrough generation agent."""
+
+    model_config = ConfigDict(title="Passthrough")
+    module: Literal["passthrough"] = "passthrough"
+    rich_context: bool = Field(
+        default=False,
+        title="Rich context output",
+        description=(
+            "When enabled, context results are emitted as structured MCP content blocks "
+            "(chunks, images, structured data) via their existing callback messages instead "
+            "of being concatenated into a plain-text answer. "
+            "Use this when the output is complex."
+        ),
+    )

hyperforge_passthrough-1.0.0.post19/src/hyperforge_passthrough.egg-info/PKG-INFO

@@ -0,0 +1,19 @@
+Metadata-Version: 2.4
+Name: hyperforge_passthrough
+Version: 1.0.0.post19
+Summary: Passthrough Hyperforge agent
+Author-email: Nuclia <nucliadb@nuclia.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://progress.com
+Project-URL: Repository, https://github.com/nuclia/forge
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <4,>=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: hyperforge
+
+# Passthrough Hyperforge agents

hyperforge_passthrough-1.0.0.post19/src/hyperforge_passthrough.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+src/hyperforge_passthrough/__init__.py
+src/hyperforge_passthrough/agent.py
+src/hyperforge_passthrough/config.py
+src/hyperforge_passthrough.egg-info/PKG-INFO
+src/hyperforge_passthrough.egg-info/SOURCES.txt
+src/hyperforge_passthrough.egg-info/dependency_links.txt
+src/hyperforge_passthrough.egg-info/requires.txt
+src/hyperforge_passthrough.egg-info/top_level.txt
+tests/test_passthrough.py

hyperforge_passthrough-1.0.0.post19/src/hyperforge_passthrough.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

hyperforge_passthrough-1.0.0.post19/src/hyperforge_passthrough.egg-info/requires.txt

@@ -0,0 +1 @@
+hyperforge

hyperforge_passthrough-1.0.0.post19/src/hyperforge_passthrough.egg-info/top_level.txt

@@ -0,0 +1 @@
+hyperforge_passthrough

hyperforge_passthrough-1.0.0.post19/tests/test_passthrough.py

@@ -0,0 +1,68 @@
+import pytest
+from hyperforge.engine import main as arag_main
+from hyperforge.interaction import AragAnswer
+
+pytestmark = pytest.mark.asyncio
+
+
+CONFIG = {
+    "drivers": [],
+    "rules": {},
+    "memory": {},
+    "workflow": {
+        "id": "default",
+        "name": "Default workflow",
+        "description": "Default workflow for testing",
+        "parameters": {},
+    },
+    "preprocess": [],
+    "postprocess": [],
+    "context": [
+        {
+            "module": "static",
+            "title": "Static Agent",
+            "context": "My data",
+            "structured": '{"source": "static"}',
+            "prune_context": False,
+        }
+    ],
+    "generation": [
+        {
+            "module": "passthrough",
+            "title": "Passthrough",
+            "rich_context": True,
+        }
+    ],
+}
+
+
+async def test_passthrough_rich_context_emits_possible_answer_from_pipeline():
+    answers: list[AragAnswer] = []
+
+    async def callback(obj: AragAnswer):
+        answers.append(obj)
+
+    await arag_main(
+        agent_id="default",
+        question="Return the static context",
+        config=CONFIG,
+        callback=callback,
+        loaded_modules=["hyperforge_passthrough", "hyperforge_static"],
+    )
+
+    context_msg = next(
+        (answer for answer in answers if answer.context is not None), None
+    )
+    assert context_msg is not None
+    assert len(context_msg.context.chunks) == 1
+    assert context_msg.context.chunks[0].text == "My data"
+    assert context_msg.context.structured == ['{"source": "static"}']
+
+    possible_answer_msg = next(
+        (answer for answer in answers if answer.possible_answer is not None),
+        None,
+    )
+    assert possible_answer_msg is not None
+    assert possible_answer_msg.possible_answer.answer == ""
+    assert possible_answer_msg.possible_answer.chunks[0].text == "My data"
+    assert possible_answer_msg.possible_answer.structured == ['{"source": "static"}']