InferQ · hashangit · Dec 26, 2025 · Dec 26, 2025 · Dec 26, 2025 · Dec 26, 2025
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,19 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.4.7] - 2025-12-27
+
+### 🛠️ Stability & Robustness (PES Agent)
+- **Execution Loop Integrity**: Addressed a critical issue where `item.result` was not being populated if the execution loop terminated due to max iterations or lacked explicit final content.
+- **Enhanced Fallback Logic**:
+    - **Smart Result Capture**: Implemented intelligent fallback to the *last* tool execution result when explicit LLM content is missing.
+    - **Context Awareness**: Updated context building for synthesis and subsequent steps to utilize tool results when `item.result` is empty, eliminating "undefined" errors in prompts.
+    - **Stale Content Protection**: Ensured `lastContent` is only updated with meaningful content, preventing empty strings from overriding valid previous outputs.
+- **HITL Resumption Fixes**:
+    - **State Reset**: Fixed a bug where resuming from a suspended state failed to reset `isPaused` and item status, causing the execution loop to skip the resumed task.
+    - **A2A Integration**: Ensured Agent-to-Agent (A2A) task results are correctly captured and used in the result fallback chain.
+- **Regression Testing**: Added `test/pes-agent-result.test.ts` with deep state verification to prevent future regressions in result population and resumption flows.
+
 ## [0.4.6] - 2025-12-26
 
 ### 🚦 Tool-Aware Execution Framework (TAEF)

diff --git a/README.md b/README.md
@@ -1,6 +1,6 @@
 
 
-# ✨ ART: Agentic Runtime Framework (beta) <img src="https://img.shields.io/badge/Version-v0.4.6-blue" alt="Version 0.4.6">
+# ✨ ART: Agentic Runtime Framework (beta) <img src="https://img.shields.io/badge/Version-v0.4.7-blue" alt="Version 0.4.7">
 
 <p align="center">
   <img src="docs/art-logo.jpeg" alt="ART Framework Logo" width="200"/>

diff --git a/docs/components/assets/hierarchy.js b/docs/components/assets/hierarchy.js
diff --git a/docs/components/classes/A2ATaskSocket.html b/docs/components/classes/A2ATaskSocket.html
diff --git a/docs/components/classes/ARTError.html b/docs/components/classes/ARTError.html
diff --git a/docs/components/classes/AdapterInstantiationError.html b/docs/components/classes/AdapterInstantiationError.html
diff --git a/docs/components/classes/AgentDiscoveryService.html b/docs/components/classes/AgentDiscoveryService.html
diff --git a/docs/components/classes/AgentFactory.html b/docs/components/classes/AgentFactory.html
diff --git a/docs/components/classes/AnthropicAdapter.html b/docs/components/classes/AnthropicAdapter.html
diff --git a/docs/components/classes/ApiKeyStrategy.html b/docs/components/classes/ApiKeyStrategy.html
diff --git a/docs/components/classes/ApiQueueTimeoutError.html b/docs/components/classes/ApiQueueTimeoutError.html
diff --git a/docs/components/classes/AuthManager.html b/docs/components/classes/AuthManager.html
diff --git a/docs/components/classes/CalculatorTool.html b/docs/components/classes/CalculatorTool.html
diff --git a/docs/components/classes/ConversationSocket.html b/docs/components/classes/ConversationSocket.html
diff --git a/docs/components/classes/DeepSeekAdapter.html b/docs/components/classes/DeepSeekAdapter.html
diff --git a/docs/components/classes/GeminiAdapter.html b/docs/components/classes/GeminiAdapter.html
diff --git a/docs/components/classes/GenericOAuthStrategy.html b/docs/components/classes/GenericOAuthStrategy.html
diff --git a/docs/components/classes/GroqAdapter.html b/docs/components/classes/GroqAdapter.html
diff --git a/docs/components/classes/InMemoryStorageAdapter.html b/docs/components/classes/InMemoryStorageAdapter.html
diff --git a/docs/components/classes/IndexedDBStorageAdapter.html b/docs/components/classes/IndexedDBStorageAdapter.html
diff --git a/docs/components/classes/LLMStreamSocket.html b/docs/components/classes/LLMStreamSocket.html
diff --git a/docs/components/classes/LocalInstanceBusyError.html b/docs/components/classes/LocalInstanceBusyError.html
diff --git a/docs/components/classes/LocalProviderConflictError.html b/docs/components/classes/LocalProviderConflictError.html
diff --git a/docs/components/classes/Logger.html b/docs/components/classes/Logger.html
diff --git a/docs/components/classes/McpClientController.html b/docs/components/classes/McpClientController.html
diff --git a/docs/components/classes/McpManager.html b/docs/components/classes/McpManager.html
diff --git a/docs/components/classes/McpProxyTool.html b/docs/components/classes/McpProxyTool.html
diff --git a/docs/components/classes/ObservationSocket.html b/docs/components/classes/ObservationSocket.html
diff --git a/docs/components/classes/OllamaAdapter.html b/docs/components/classes/OllamaAdapter.html
diff --git a/docs/components/classes/OpenAIAdapter.html b/docs/components/classes/OpenAIAdapter.html
diff --git a/docs/components/classes/OpenRouterAdapter.html b/docs/components/classes/OpenRouterAdapter.html
diff --git a/docs/components/classes/PESAgent.html b/docs/components/classes/PESAgent.html
diff --git a/docs/components/classes/PKCEOAuthStrategy.html b/docs/components/classes/PKCEOAuthStrategy.html
diff --git a/docs/components/classes/ProviderManagerImpl.html b/docs/components/classes/ProviderManagerImpl.html
diff --git a/docs/components/classes/StateManager.html b/docs/components/classes/StateManager.html
diff --git a/docs/components/classes/SupabaseStorageAdapter.html b/docs/components/classes/SupabaseStorageAdapter.html
diff --git a/docs/components/classes/TaskDelegationService.html b/docs/components/classes/TaskDelegationService.html
diff --git a/docs/components/classes/ToolRegistry.html b/docs/components/classes/ToolRegistry.html
diff --git a/docs/components/classes/TypedSocket.html b/docs/components/classes/TypedSocket.html
diff --git a/docs/components/classes/UISystem.html b/docs/components/classes/UISystem.html
diff --git a/docs/components/classes/UnknownProviderError.html b/docs/components/classes/UnknownProviderError.html
diff --git a/docs/components/classes/ZyntopiaOAuthStrategy.html b/docs/components/classes/ZyntopiaOAuthStrategy.html
diff --git a/docs/components/enums/A2ATaskPriority.html b/docs/components/enums/A2ATaskPriority.html
diff --git a/docs/components/enums/A2ATaskStatus.html b/docs/components/enums/A2ATaskStatus.html
diff --git a/docs/components/enums/ErrorCode.html b/docs/components/enums/ErrorCode.html
diff --git a/docs/components/enums/LogLevel.html b/docs/components/enums/LogLevel.html
diff --git a/docs/components/enums/MessageRole.html b/docs/components/enums/MessageRole.html
diff --git a/docs/components/enums/ModelCapability.html b/docs/components/enums/ModelCapability.html
diff --git a/docs/components/enums/ObservationType.html b/docs/components/enums/ObservationType.html
diff --git a/docs/components/enums/TodoItemStatus.html b/docs/components/enums/TodoItemStatus.html
diff --git a/docs/components/functions/createArtInstance.html b/docs/components/functions/createArtInstance.html
@@ -13,4 +13,4 @@
 </div><div class="tsd-tag-example"><h4 class="tsd-anchor-link" id="example">Example<a href="#example" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h4><pre><code class="ts"><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">art</span><span class="hl-1"> = </span><span class="hl-4">await</span><span class="hl-1"> </span><span class="hl-0">createArtInstance</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-5">storage:</span><span class="hl-1"> { </span><span class="hl-5">type:</span><span class="hl-1"> </span><span class="hl-2">&#39;indexedDB&#39;</span><span class="hl-1">, </span><span class="hl-5">dbName:</span><span class="hl-1"> </span><span class="hl-2">&#39;myAgentDb&#39;</span><span class="hl-1"> },</span><br/><span class="hl-1">  </span><span class="hl-5">reasoning:</span><span class="hl-1"> { </span><span class="hl-5">provider:</span><span class="hl-1"> </span><span class="hl-2">&#39;openai&#39;</span><span class="hl-1">, </span><span class="hl-5">apiKey:</span><span class="hl-1"> </span><span class="hl-2">&#39;...&#39;</span><span class="hl-1"> },</span><br/><span class="hl-1">  </span><span class="hl-5">tools:</span><span class="hl-1"> [</span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">CalculatorTool</span><span class="hl-1">()]</span><br/><span class="hl-1">});</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">response</span><span class="hl-1"> = </span><span class="hl-4">await</span><span class="hl-1"> </span><span class="hl-5">art</span><span class="hl-1">.</span><span class="hl-0">process</span><span class="hl-1">({ </span><span class="hl-5">query:</span><span class="hl-1"> </span><span class="hl-2">&quot;Calculate 5*5&quot;</span><span class="hl-1">, </span><span class="hl-5">threadId:</span><span class="hl-1"> </span><span class="hl-2">&quot;thread1&quot;</span><span class="hl-1"> });</span>
 </code><button type="button">Copy</button></pre>
 
-</div></div><aside class="tsd-sources"><ul><li>Defined in <a href="https://github.com/hashangit/ART/blob/d06039b44058bed1408965572429e0afec31142a/src/core/agent-factory.ts#L358">src/core/agent-factory.ts:358</a></li></ul></aside></div></li></ul></section></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">ART Framework API Docs</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>
+</div></div><aside class="tsd-sources"><ul><li>Defined in <a href="https://github.com/hashangit/ART/blob/45b3c2fd7980335bcddd7242e2c72a43e33777f7/src/core/agent-factory.ts#L358">src/core/agent-factory.ts:358</a></li></ul></aside></div></li></ul></section></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">ART Framework API Docs</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>
diff --git a/docs/components/functions/generateUUID.html b/docs/components/functions/generateUUID.html
@@ -2,4 +2,4 @@
 </div><h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">string</span></h4><p>A randomly generated UUID string (e.g., &quot;f47ac10b-58cc-4372-a567-0e02b2c3d479&quot;).</p>
 <div class="tsd-comment tsd-typography"><div class="tsd-tag-remarks"><h4 class="tsd-anchor-link" id="remarks">Remarks<a href="#remarks" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h4><p>Uses the underlying 'uuid' library's v4 implementation.</p>
 </div><div class="tsd-tag-see"><h4 class="tsd-anchor-link" id="see">See<a href="#see" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h4><p><a href="https://www.npmjs.com/package/uuid">uuid npm package</a></p>
-</div></div><aside class="tsd-sources"><ul><li>Defined in <a href="https://github.com/hashangit/ART/blob/d06039b44058bed1408965572429e0afec31142a/src/utils/uuid.ts#L17">src/utils/uuid.ts:17</a></li></ul></aside></div></li></ul></section></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">ART Framework API Docs</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>
+</div></div><aside class="tsd-sources"><ul><li>Defined in <a href="https://github.com/hashangit/ART/blob/45b3c2fd7980335bcddd7242e2c72a43e33777f7/src/utils/uuid.ts#L17">src/utils/uuid.ts:17</a></li></ul></aside></div></li></ul></section></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">ART Framework API Docs</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>