Merge branch 'develop'

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

Author: kichanyurd

.devcontainer/devcontainer.json

@@ -30,7 +30,8 @@
         "mutantdino.resourcemonitor",
         "njpwerner.autodocstring",
         "tamasfe.even-better-toml",
-        "zeshuaro.vscode-python-poetry"
+        "zeshuaro.vscode-python-poetry",
+        "streetsidesoftware.code-spell-checker"
       ]
     }
   },

CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to Parlant will be documented here.
 ## [Unreleased]
 TBD
 
+## [2.1.2] - 2025-05-07
+
+### Changed
+- Remove interaction history from utterance recomposition prompt
+- Use tool calls from the entire interaction for utterance field substitution
+- Improve error handling and reporting with utterance rendering failures
+
+### Fixed
+- Always reason about utterance selection to improve performance
+
 ## [2.1.1] - 2025-04-30
 
 ### Fixed

README.md

@@ -3,10 +3,10 @@
 <!--<img alt="Parlant Banner" src="https://github.com/emcie-co/parlant/blob/develop/banner.png?raw=true" />-->
 
 
-
-  <h3>Parlant: The Conversation Modeling Engine</h3>
+<h1>Parlant</h1>
+  <h3>The Conversation Modeling Engine</h3>
 
-**Stop fighting with prompts and take charge of GenAI interactions!**
+Parlant is the open-source framework for safe, compliant, and custom generative AI conversations. It gives you the power of LLMs without the unpredictability.
 
   <a href="https://trendshift.io/repositories/12768" target="_blank"><img src="https://trendshift.io/api/badge/repositories/12768" alt="emcie-co%2Fparlant | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
 
@@ -53,6 +53,10 @@ parlant guideline create \
     --action "thank them for checking out Parlant"
 # Now start a new conversation and greet the agent
 ```
+
+## Quick Demo
+<img alt="Parlant Banner" src="https://github.com/emcie-co/parlant/blob/develop/ParlantGIF.gif?raw=true" />
+
 
 ## What is Conversation Modeling?
 You've built an AI agent—that's great! However, when you actually test it, you see it's not handling many customer interactions properly, and your business experts are displeased with it. What do you do?
@@ -65,12 +69,9 @@ A conversation model is a structured, domain-specific set of principles, actions
 
 The problem of getting your AI agent to say what _you_ want it to say is a hard one, experienced by virtually anyone building customer-facing agents. Here's how Conversation Modeling compares to other approaches to solving this problem.
 
-- **Flow engines** (such as [Rasa](https://github.com/RasaHQ/rasa), [Botpress](https://github.com/botpress/botpress) or [LangFlow](https://github.com/langflow-ai/langflow)) _force_ the user to interact according to predefined flows. In contrast, a **CM engine** dynamically _adapts_ to a user's natural interaction patterns while conforming to your rules.
-
-- **Free-form prompt engineering** (such as with [LangGraph](https://www.langchain.com/langgraph) or [LlamaIndex](https://docs.llamaindex.ai/)) leads to _inconsistency_, frequently failing to uphold requirements. Conversely, a **CM engine** leverages structure to _enforce_ conformance to a Conversation Model.
+- **Flow engines** _force_ the user to interact according to predefined flows. In contrast, a **CM engine** dynamically _adapts_ to a user's natural interaction patterns while conforming to your rules.
 
-## Quick Demo
-<img alt="Parlant Banner" src="https://github.com/emcie-co/parlant/blob/develop/ParlantGIF.gif?raw=true" />
+- **Free-form prompt engineering** leads to _inconsistency_, frequently failing to uphold requirements. Conversely, a **CM engine** leverages structure to _enforce_ conformance to a Conversation Model.
 
 
 ## Who uses Parlant?

poetry.lock

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

pyproject.toml

@@ -10,8 +10,8 @@
 		<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
 		<link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:ital,wght@0,100;0,200;0,300;0,400;0,500;0,600;0,700;1,100;1,200;1,300;1,400;1,500;1,600;1,700&display=swap" rel="stylesheet" />
 		<title>Parlant</title>
-		<script type="module" crossorigin src="/chat/assets/index-BnUKjToq.js"></script>
-		<link rel="stylesheet" crossorigin href="/chat/assets/index-BxadTjeo.css">
+		<script type="module" crossorigin src="/chat/assets/index-BHV6vFSJ.js"></script>
+		<link rel="stylesheet" crossorigin href="/chat/assets/index-CZpORbbw.css">
 	</head>
 	<body>
 		<div id="root"></div>

src/parlant/api/chat/dist/assets/index-BnUKjToq.js renamed to src/parlant/api/chat/dist/assets/index-BHV6vFSJ.js

@@ -44,3 +44,44 @@ body {
 img {
 	user-select: none;
 }
+
+.bubblesWrapper {
+	height: fit-content;
+	width: fit-content;
+	background-color: #F5F9F7;
+	padding: 10px;
+	margin: 10px;
+	margin-inline: 20px;
+	border-radius: 15px;
+}
+
+.bubbles {
+	height: 15px;
+	width: 31px;
+	aspect-ratio: 2.5;
+	--_g: no-repeat radial-gradient(farthest-side, #333333 90%, #0000);
+	background: var(--_g), var(--_g), var(--_g);
+	background-size: 25% 50%;
+	animation: l43 1s infinite linear;
+}
+
+@keyframes l43 {
+	0% {
+	  background-position: calc(0*100%/2) 50%, calc(1*100%/2) 50%, calc(2*100%/2) 50%;
+	}
+	20% {
+	  background-position: calc(0*100%/2) 0, calc(1*100%/2) 50%, calc(2*100%/2) 50%;
+	}
+	40% {
+	  background-position: calc(0*100%/2) 100%, calc(1*100%/2) 0, calc(2*100%/2) 50%;
+	}
+	60% {
+	  background-position: calc(0*100%/2) 50%, calc(1*100%/2) 100%, calc(2*100%/2) 0;
+	}
+	80% {
+	  background-position: calc(0*100%/2) 50%, calc(1*100%/2) 50%, calc(2*100%/2) 100%;
+	}
+	100% {
+	  background-position: calc(0*100%/2) 50%, calc(1*100%/2) 50%, calc(2*100%/2) 50%;
+	}
+}

src/parlant/api/chat/dist/assets/index-BxadTjeo.css renamed to src/parlant/api/chat/dist/assets/index-CZpORbbw.css

@@ -183,6 +183,9 @@ const SessionView = (): ReactElement => {
 	useEffect(formatMessagesFromEvents, [lastEvents]);
 	useEffect(scrollToLastMessage, [messages?.length, pendingMessage, isFirstScroll]);
 	useEffect(resetSession, [session?.id]);
+	useEffect(() => {
+		if (showThinking) lastMessageRef?.current?.scrollIntoView({behavior: 'smooth'});
+	}, [showThinking]);
 	useEffect(() => {
 		if (agents && agent?.id) setIsMissingAgent(!agents?.find((a) => a.id === agent?.id));
 	}, [agents, agent?.id]);
@@ -260,6 +263,13 @@ const SessionView = (): ReactElement => {
 										</div>
 									</React.Fragment>
 								))}
+								{(showTyping || showThinking) && (
+									<div ref={lastMessageRef} className='flex snap-end flex-col max-w-[min(1020px,100%)] w-[1020px] self-center'>
+										<div className='bubblesWrapper snap-end' aria-hidden="true">
+											<div className='bubbles' />
+										</div>
+									</div>
+								)}
 							</div>
 							<div className={twMerge('w-full flex justify-between', isMissingAgent && 'hidden')}>
 								<Spacer />
@@ -304,7 +314,7 @@ const SessionView = (): ReactElement => {
 										className='box-shadow-none placeholder:text-[#282828] resize-none border-none h-full rounded-none min-h-[unset] p-0 whitespace-nowrap no-scrollbar font-inter font-light text-[16px] leading-[18px] bg-white'
 									/>
 									<p className={twMerge('absolute invisible left-[0.25em] -bottom-[28px] font-normal text-[#A9AFB7] text-[14px] font-inter', (showTyping || showThinking) && 'visible')}>
-										{showTyping ? `${agent?.name} is typing...` : `${agent?.name} is online`}
+										{showTyping ? `${agent?.name} is typing...` : `${agent?.name} is thinking...`}
 									</p>
 									<Button variant='ghost' data-testid='submit-button' className='max-w-[60px] rounded-full hover:bg-white' ref={submitButtonRef} disabled={!message?.trim() || !agent?.id} onClick={() => postMessage(message)}>
 										<img src='icons/send.svg' alt='Send' height={19.64} width={21.52} className='h-10' />