agentbyte 0.22.1__tar.gz → 0.22.2__tar.gz

{agentbyte-0.22.1 → agentbyte-0.22.2}/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to Agentbyte are documented in this file.
 
 The format follows Keep a Changelog principles and semantic versioning.
 
+## [0.22.2] - 2026-07-05
+
+### Added
+
+- Added `AgentResponse.final_message` and `AgentResponse.structured_output` convenience accessors for consuming final assistant output without manually indexing `response.messages[-1]`.
+- Added the FastAPI agent API frontend integration updates, including the API-loaded agent landing page, contracting workspace routing, feedback UI flow, tool-step rendering, and context inspector refinements.
+
+### Changed
+
+- Updated the FastAPI agent API example to consume structured output through the new `AgentResponse.structured_output` accessor.
+- Updated the FastAPI study docs and UI developer guide to match the integrated API, session history, feedback, citation, and frontend behavior.
+
 ## [0.22.1] - 2026-06-30
 
 ### Added

{agentbyte-0.22.1 → agentbyte-0.22.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentbyte
-Version: 0.22.1
+Version: 0.22.2
 Summary: A toolkit for designing multiagent systems
 Author-email: MrDataPsycho <mr.data.psycho@gmail.com>
 License-Expression: LicenseRef-Proprietary
@@ -78,7 +78,7 @@ Description-Content-Type: text/markdown
 
 Agentbyte is an observability-first agentic AI framework for building and studying multiagent systems with a learning-first, implementation-oriented workflow.
 
-Current release: **0.22.1**
+Current release: **0.22.2**
 
 ## Current Capabilities
 

{agentbyte-0.22.1 → agentbyte-0.22.2}/README.md

@@ -2,7 +2,7 @@
 
 Agentbyte is an observability-first agentic AI framework for building and studying multiagent systems with a learning-first, implementation-oriented workflow.
 
-Current release: **0.22.1**
+Current release: **0.22.2**
 
 ## Current Capabilities
 

agentbyte-0.22.2/src/agentbyte/__about__.py

@@ -0,0 +1,2 @@
+__version__ = "0.22.2"
+VERSION = __version__

{agentbyte-0.22.1 → agentbyte-0.22.2}/src/agentbyte/agents/types.py

@@ -8,7 +8,7 @@ from typing import Any, Dict, List, Literal, Optional, Sequence, Union
 from pydantic import BaseModel, ConfigDict, Field
 
 from agentbyte.context import AgentContext, ToolApprovalRequest
-from agentbyte.messages import Message, Usage
+from agentbyte.messages import AssistantMessage, Message, Usage
 from agentbyte.types import ToolResult
 
 
@@ -213,6 +213,24 @@ class AgentResponse(BaseModel):
             return ""
         return self.context.messages[-1].content
 
+    @property
+    def final_message(self) -> AssistantMessage | None:
+        """Final assistant message if the run ended with one."""
+        if not self.context.messages:
+            return None
+        message = self.context.messages[-1]
+        if isinstance(message, AssistantMessage):
+            return message
+        return None
+
+    @property
+    def structured_output(self) -> BaseModel | None:
+        """Structured output attached to the final assistant message, if any."""
+        final_message = self.final_message
+        if final_message is None:
+            return None
+        return final_message.structured_content
+
     def __str__(self) -> str:
         """Returns a user-friendly string representation with messages and usage."""
         # Concat all message str representations

agentbyte-0.22.2/tests/agents/test_agent_response_accessors.py

@@ -0,0 +1,57 @@
+"""AgentResponse convenience accessor tests."""
+
+from pydantic import BaseModel
+
+from agentbyte.agents.types import AgentResponse
+from agentbyte.context import AgentContext
+from agentbyte.messages import AssistantMessage, Message, UserMessage
+
+
+class ExampleOutput(BaseModel):
+    value: str
+
+
+def _response_with(*messages: Message) -> AgentResponse:
+    context = AgentContext()
+    for message in messages:
+        context.add_message(message)
+    return AgentResponse(context=context, source="test-agent", finish_reason="stop")
+
+
+def test_agent_response_accessors_empty_context() -> None:
+    response = _response_with()
+
+    assert response.final_message is None
+    assert response.structured_output is None
+    assert response.final_content == ""
+
+
+def test_agent_response_accessors_non_assistant_final_message() -> None:
+    response = _response_with(UserMessage(content="question", source="user"))
+
+    assert response.final_message is None
+    assert response.structured_output is None
+    assert response.final_content == "question"
+
+
+def test_agent_response_accessors_plain_assistant_final_message() -> None:
+    assistant = AssistantMessage(content="answer", source="assistant")
+    response = _response_with(UserMessage(content="question", source="user"), assistant)
+
+    assert response.final_message is assistant
+    assert response.structured_output is None
+    assert response.final_content == "answer"
+
+
+def test_agent_response_accessors_structured_assistant_final_message() -> None:
+    structured = ExampleOutput(value="answer")
+    assistant = AssistantMessage(
+        content="",
+        source="assistant",
+        structured_content=structured,
+    )
+    response = _response_with(UserMessage(content="question", source="user"), assistant)
+
+    assert response.final_message is assistant
+    assert response.structured_output is structured
+    assert response.final_content == ""

agentbyte-0.22.1/src/agentbyte/__about__.py

@@ -1,2 +0,0 @@
-__version__ = "0.22.1"
-VERSION = __version__