agentbyte 0.22.1__tar.gz → 0.22.3__tar.gz

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

@@ -4,6 +4,24 @@ All notable changes to Agentbyte are documented in this file.
 
 The format follows Keep a Changelog principles and semantic versioning.
 
+## [0.22.3] - 2026-07-07
+
+### Fixed
+
+- Fixed `SqlUsageBackend` Postgres writes by normalizing timezone-aware `recorded_at` timestamps to naive UTC before persistence, avoiding asyncpg datetime binding errors that left `llm_usage_events` empty on PostgreSQL-backed runtimes while SQLite continued to work.
+
+## [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.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentbyte
-Version: 0.22.1
+Version: 0.22.3
 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.3**
 
 ## Current Capabilities
 

{agentbyte-0.22.1 → agentbyte-0.22.3}/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.3**
 
 ## Current Capabilities
 

agentbyte-0.22.3/src/agentbyte/__about__.py

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

{agentbyte-0.22.1 → agentbyte-0.22.3}/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.1 → agentbyte-0.22.3}/src/agentbyte/middleware/sql_usage.py

@@ -39,6 +39,13 @@ from sqlmodel import Field, SQLModel
 from .usage_logger import UsageEvent, UsagePersistenceBackend
 
 
+def _normalize_recorded_at(value: datetime) -> datetime:
+    """Store usage timestamps as naive UTC for cross-database compatibility."""
+    if value.tzinfo is None:
+        return value
+    return value.astimezone(timezone.utc).replace(tzinfo=None)
+
+
 class LlmUsageEvent(SQLModel, table=True):
     """SQLModel table that stores one row per LLM call.
 
@@ -132,7 +139,7 @@ class SqlUsageBackend(UsagePersistenceBackend):
                 tool_calls=event.tool_calls,
                 memory_operations=event.memory_operations,
                 cost_estimate=event.cost_estimate,
-                recorded_at=event.recorded_at,
+                recorded_at=_normalize_recorded_at(event.recorded_at),
             )
             session.add(row)
             await session.commit()

agentbyte-0.22.3/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 → agentbyte-0.22.3}/tests/middleware/test_sql_usage.py

@@ -9,6 +9,7 @@ from __future__ import annotations
 
 import asyncio
 from collections.abc import AsyncGenerator
+from datetime import datetime, timezone
 from typing import Any
 
 import pytest
@@ -188,6 +189,34 @@ async def test_multiple_calls_write_multiple_rows(middleware, model_ctx, engine)
     assert len(await _rows(engine)) == 3
 
 
+@pytest.mark.asyncio
+async def test_timezone_aware_recorded_at_is_normalized_for_storage(backend, engine) -> None:
+    from agentbyte.middleware.usage_logger import UsageEvent
+
+    await backend.write(
+        UsageEvent(
+            session_id="sess-aware",
+            user_id="user-aware",
+            identifier="test-app",
+            agent_name="test-agent",
+            model="gpt-4o",
+            duration_ms=1,
+            llm_calls=1,
+            tokens_input=1,
+            tokens_output=1,
+            tool_calls=0,
+            memory_operations=0,
+            cost_estimate=0.001,
+            recorded_at=datetime(2026, 7, 7, 12, 0, tzinfo=timezone.utc),
+        )
+    )
+
+    rows = await _rows(engine)
+    assert len(rows) == 1
+    assert rows[0].recorded_at.tzinfo is None
+    assert rows[0].recorded_at == datetime(2026, 7, 7, 12, 0)
+
+
 @pytest.mark.asyncio
 async def test_run_id_injected_by_agent_run() -> None:
     """agent.run() must stamp run_id when not already present."""

agentbyte-0.22.1/src/agentbyte/__about__.py

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