Merge branch 'develop'

Signed-off-by: Yam Marcovitz <[email protected]>

Author: kichanyurd

CHANGELOG.md

@@ -6,9 +6,21 @@ All notable changes to Parlant will be documented here.
 
 TBD
 
+## [3.0.1] - 2025-08-16
+
+### Changed
+
+- Move tool call success log to DEBUG level
+
+### Fixed
+
+- Fix tool-based variable not enabling the associated tool on the server
+- Fix authorization errors throwing 500 instead of 403
+- Changed OpenAI LLM request operation level to TRACE to fix evaluation progress bars
+
 ## [3.0.0] - 2025-08-15
 
-Please see the announcement at https://parlant.io/blog/parlant-3-0-release
+- Please see the announcement at https://parlant.io/blog/parlant-3-0-release
 
 ## [2.2.0] - 2025-05-20
 

README.md

@@ -28,8 +28,6 @@
 
 </div>
 
----
-
 ## 🎯 The Problem Every AI Developer Faces
 
 You build an AI agent. It works great in testing. Then real users start talking to it and...
@@ -89,7 +87,9 @@ async def main():
             tools=[get_weather]
         )
 
-        # 🎉 Agent ready at http://localhost:8800
+        # 🎉 Test playground ready at http://localhost:8800
+        # Integrate the official React widget into your app,
+        # or follow the tutorial to build your own frontend!
 
 if __name__ == "__main__":
     import asyncio
@@ -100,32 +100,40 @@ if __name__ == "__main__":
 
 ## 🎬 See It In Action
 
-<img alt="Parlant Demo" src="https://www.parlant.io/img/example-scheduling-journey.gif" width="100%" />
+<img alt="Parlant Demo" src="https://github.com/emcie-co/parlant/blob/develop/docs/demo.gif?raw=true" width="100%" />
 
 ## 🔥 Why Developers Are Switching to Parlant
 
-<table>
+<table width="100%">
 <tr>
-<td width="50%">
+  <td width="50%">
 
 ### 🏗️ **Traditional AI Frameworks**
 
+  </td>
+  <td width="50%">
+
+### ⚡ **Parlant**
+
+  </td>
+</tr>
+<tr>
+<td width="50%">
+
 - Write complex system prompts
 - Hope the LLM follows them
 - Debug unpredictable behaviors
-- Scale by adding more prompt engineering
-- Cross fingers for production reliability
+- Scale by prompt engineering
+- Cross fingers for reliability
 
 </td>
 <td width="50%">
 
-### ⚡ **Parlant**
-
 - Define rules in natural language
 - **Guaranteed** rule compliance
 - Predictable, consistent behavior
-- Scale by adding more guidelines
-- Production-ready reliability from day one
+- Scale by adding guidelines
+- Production-ready from day one
 
 </td>
 </tr>
@@ -138,18 +146,19 @@ if __name__ == "__main__":
 |  **Financial Services**  |     **Healthcare**      |       **E-commerce**        |       **Legal Tech**       |
 | :----------------------: | :---------------------: | :-------------------------: | :------------------------: |
 | Compliance-first design  |   HIPAA-ready agents    |  Customer service at scale  |   Precise legal guidance   |
-| Risk management built-in | Patient data protection | Order processing automation | Document review assistance |
+| Built-in risk management | Patient data protection | Order processing automation | Document review assistance |
 
 </div>
 
 ## 🛠️ Enterprise-Grade Features
 
+- **🧭 Conversational Journeys** - Lead the customer step-by-step to a goal
 - **🎯 Dynamic Guideline Matching** - Context-aware rule application
 - **🔧 Reliable Tool Integration** - APIs, databases, external services
 - **📊 Conversation Analytics** - Deep insights into agent behavior
 - **🔄 Iterative Refinement** - Continuously improve agent responses
 - **🛡️ Built-in Guardrails** - Prevent hallucination and off-topic responses
-- **📱 React Widget** - Drop-in chat UI for any web app
+- **📱 React Widget** - [Drop-in chat UI for any web app](https://github.com/emcie-co/parlant-chat-react)
 - **🔍 Full Explainability** - Understand every decision your agent makes
 
 ## 📈 Join 1000+ Developers Building Better AI
@@ -166,7 +175,7 @@ _Financial institutions • Healthcare providers • Legal firms • E-commerce
 
 ## 🏃‍♂️ Quick Start Paths
 
-<table>
+<table border="0">
 <tr>
 <td><strong>🎯 I want to test it myself</strong></td>
 <td><a href="https://www.parlant.io/docs/quickstart/installation">→ 5-minute quickstart</a></td>
@@ -183,9 +192,7 @@ _Financial institutions • Healthcare providers • Legal firms • E-commerce
 
 ## 🌟 What Developers Are Saying
 
-> _"Finally! An AI framework that actually works in production. Parlant solved our consistency issues overnight."_ > **— Sarah Chen, Lead AI Engineer @ FinTech Startup**
-
-> _"The difference is night and day. Our agents went from 60% accuracy to 95%+ with Parlant's guideline system."_ > **— Marcus Rodriguez, CTO @ HealthTech Company**
+> _"By far the most elegant conversational AI framework that I've come across! Developing with Parlant is pure joy."_ **— Vishal Ahuja, Senior Lead, Customer-Facing Conversational AI @ JPMorgan Chase**
 
 ## 🤝 Community & Support
 

docs/demo.gif

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "parlant"
-version = "3.0.0"
+version = "3.0.1"
 license = "Apache-2.0"
 description = ""
 authors = ["Yam Marcovitz <[email protected]>", "Dor Zohar <[email protected]>"]

pyproject.toml

@@ -132,7 +132,7 @@ async def generate(
     ) -> SchematicGenerationResult[T]:
         with self._logger.scope("OpenAISchematicGenerator"):
             with self._logger.operation(
-                f"LLM Request ({self.schema.__name__})", level=LogLevel.DEBUG
+                f"LLM Request ({self.schema.__name__})", level=LogLevel.TRACE
             ):
                 return await self._do_generate(prompt, hints)
 
@@ -399,7 +399,7 @@ def extract_tags(category: str) -> list[ModerationTag]:
 
             return mapping.get(category.replace("/", "_").replace("-", "_"), [])
 
-        with self._logger.operation("OpenAI Moderation Request", level=LogLevel.DEBUG):
+        with self._logger.operation("OpenAI Moderation Request", level=LogLevel.TRACE):
             response = await self._client.moderations.create(
                 input=content,
                 model=self.model_name,

src/parlant/adapters/nlp/openai_service.py

@@ -41,6 +41,7 @@
 from parlant.api import logs
 from parlant.api import canned_responses
 from parlant.api.authorization import (
+    AuthorizationException,
     AuthorizationPolicy,
     Operation,
     RateLimitExceededException,
@@ -178,13 +179,24 @@ async def add_correlation_id(
     async def rate_limit_exceeded_handler(
         request: Request, exc: RateLimitExceededException
     ) -> HTTPException:
-        logger.warning(f"Rate limit exceeded: {exc}")
+        logger.trace(f"Rate limit exceeded: {exc}")
 
         raise HTTPException(
             status_code=status.HTTP_429_TOO_MANY_REQUESTS,
             detail=str(exc),
         )
 
+    @api_app.exception_handler(AuthorizationException)
+    async def authorization_error_handler(
+        request: Request, exc: AuthorizationException
+    ) -> HTTPException:
+        logger.trace(f"Authorization error: {exc}")
+
+        raise HTTPException(
+            status_code=status.HTTP_403_FORBIDDEN,
+            detail=str(exc),
+        )
+
     @api_app.exception_handler(ItemNotFoundError)
     async def item_not_found_error_handler(
         request: Request, exc: ItemNotFoundError

src/parlant/api/app.py

@@ -219,8 +219,8 @@ def name(self) -> str:
         return "production"
 
     @override
-    async def check_permission(self, request: Request, permission: Operation) -> bool:
-        if permission in [
+    async def check_permission(self, request: Request, operation: Operation) -> bool:
+        if operation in [
             Operation.CREATE_GUEST_SESSION,
             Operation.READ_SESSION,
             Operation.LIST_EVENTS,

src/parlant/api/authorization.py

@@ -266,7 +266,7 @@ async def _run_tool(
                     tool_call.arguments,
                 )
 
-                self._logger.trace(
+                self._logger.debug(
                     f"Execution::Result: Tool call succeeded ({tool_call.tool_id.to_string()}/{tool_call.id})\n{json.dumps(asdict(result), indent=2, default=str)}"
                 )
             except Exception as exc:

src/parlant/core/engines/alpha/tool_calling/tool_caller.py

@@ -104,7 +104,7 @@ async def generate_events(
         _ = preexecution_state  # Not used for now, but good to have for extensibility
 
         if not context.state.tool_enabled_guideline_matches:
-            self._logger.debug("Skipping tool calling; no tools associated with guidelines found")
+            self._logger.trace("Skipping tool calling; no tools associated with guidelines found")
             return ToolEventGenerationResult(generations=[], events=[], insights=ToolInsights())
 
         await context.session_event_emitter.emit_status_event(

src/parlant/core/engines/alpha/tool_event_generator.py

@@ -12,4 +12,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-VERSION = "3.0.0"
+VERSION = "3.0.1"