bump package version

Author: saqadri

examples/mcp_root_test/test_data/plots/3d_accelerometer_by_exercise.png

@@ -5,6 +5,54 @@
 from mcp_agent.agents.agent import Agent
 from mcp_agent.workflows.llm.augmented_llm import RequestParams
 from mcp_agent.workflows.llm.augmented_llm_openai import OpenAIAugmentedLLM
+from dataclasses import dataclass
+from typing import Optional, Type, TypeVar
+
+T = TypeVar("T", bound=OpenAIAugmentedLLM)
+
+
+@dataclass
+class AgentState:
+    """Container for agent and its associated LLM"""
+
+    agent: Agent
+    llm: Optional[OpenAIAugmentedLLM] = None
+
+
+async def get_agent_state(
+    key: str,
+    agent_class: Type[Agent],
+    llm_class: Optional[Type[T]] = None,
+    **agent_kwargs,
+) -> AgentState:
+    """
+    Get or create agent state, reinitializing connections if retrieved from session.
+
+    Args:
+        key: Session state key
+        agent_class: Agent class to instantiate
+        llm_class: Optional LLM class to attach
+        **agent_kwargs: Arguments for agent instantiation
+    """
+    if key not in st.session_state:
+        # Create new agent
+        agent = agent_class(
+            connection_persistence=False,
+            **agent_kwargs,
+        )
+        await agent.initialize()
+
+        # Attach LLM if specified
+        llm = None
+        if llm_class:
+            llm = await agent.attach_llm(llm_class)
+
+        state: AgentState = AgentState(agent=agent, llm=llm)
+        st.session_state[key] = state
+    else:
+        state = st.session_state[key]
+
+    return state
 
 
 def format_list_tools_result(list_tools_result: ListToolsResult):
@@ -17,18 +65,20 @@ def format_list_tools_result(list_tools_result: ListToolsResult):
 async def main():
     await app.initialize()
 
-    finder_agent = Agent(
+    # Use the state management pattern
+    state = await get_agent_state(
+        key="finder_agent",
+        agent_class=Agent,
+        llm_class=OpenAIAugmentedLLM,
         name="finder",
         instruction="""You are an agent with access to the filesystem,
         as well as the ability to fetch URLs. Your job is to identify
         the closest match to a user's request, make the appropriate tool calls,
         and return the URI and CONTENTS of the closest match.""",
         server_names=["fetch", "filesystem"],
     )
-    await finder_agent.initialize()
-    llm = await finder_agent.attach_llm(OpenAIAugmentedLLM)
 
-    tools = await finder_agent.list_tools()
+    tools = await state.agent.list_tools()
     tools_str = format_list_tools_result(tools)
 
     st.title("💬 Basic Agent Chatbot")
@@ -53,8 +103,17 @@ async def main():
         with st.chat_message("assistant"):
             response = ""
             with st.spinner("Thinking..."):
-                response = await llm.generate_str(
-                    message=prompt, request_params=RequestParams(use_history=True)
+                # Pass the conversation history to the LLM
+                conversation_history = st.session_state["messages"][
+                    1:
+                ]  # Skip the initial greeting
+
+                response = await state.llm.generate_str(
+                    message=prompt,
+                    request_params=RequestParams(
+                        use_history=True,
+                        history=conversation_history,  # Pass the conversation history
+                    ),
                 )
             st.markdown(response)
 

examples/mcp_root_test/test_data/plots/accelerometer_time_series.png

@@ -1,82 +1,112 @@
-# Graded Report: Evaluation of "The Battle of Glimmerwood"
-
-This report consolidates feedback on the short story in three key areas: proofreading, factual/logical consistency, and APA style adherence. The goal is to offer actionable recommendations to improve both the narrative clarity and its academic presentation.
-
----
-
-## 1. Proofreading Feedback
-
-The text contains several typographical, grammatical, and punctuation issues. Key points include:
-
-- **Spelling Errors:**
-  - *"knowed"* should be replaced by *"known"*.
-  - *"choas"* should be corrected to *"chaos"*.
-  - *"shaterred"* should be changed to *"shattered"*.
-  - *"aproached"* should be corrected to *"approached"*.
-
-- **Grammatical Inconsistencies:**
-  - Phrases like *"who were live peacefully"* need revision to *"who lived peacefully"*.
-  - Some verb tenses and subject-verb agreements are inconsistent (e.g., *"aim"* vs. *"aimed"*; *"captured"* instead of *"capture"*).
-
-- **Punctuation Issues:**
-  - Comma splices in sentences (e.g., joining two independent clauses with only a comma) should be revised using semicolons or by splitting into separate sentences.
-  - Missing commas after introductory phrases and before non-restrictive clauses reduce clarity.
-
-Addressing these issues will enhance readability and ensure the narrative is polished.
-
----
-
-## 2. Fact-Checking and Logical Consistency
-
-The story is set within a fantasy framework and largely maintains internal consistency. Notable points include:
-
-- **Consistency with the Genre:**
-  - The narrative establishes a mystical setting (Glimmerwood) with magical creatures and powerful artifacts (Glimmerstones) that fit within the fantasy genre.
-
-- **Ambiguity in Plot Elements:**
-  - The true power of the Glimmerstones is left ambiguous (stated as never being fully confirmed), which could be a deliberate narrative device but may confuse readers if not further clarified.
-  - The rapid resolution of conflict—such as the sudden appearance of magical defenses—could be enhanced by providing more background on the villagers’ relationship with these creatures.
-
-Overall, while the internal logic is maintained, clarifying these ambiguities could strengthen the narrative coherence.
-
----
-
-## 3. APA Style and Formatting Evaluation
-
-The document in its current Markdown format does not adhere to APA formatting guidelines. Key considerations include:
-
-- **Title Page and Running Head:**
-  - APA style requires a separate title page with centered title, author information, institutional affiliation, and a running head with page numbers. The narrative presently uses a markdown header instead.
-
-- **Headings and Text Formatting:**
-  - APA requires a specific hierarchy for headings. Replace Markdown-style headers with APA-compliant formatting (e.g., centered, bold, and appropriately leveled headings).
-  - Use 12-point Times New Roman font, double spacing, and 1-inch margins throughout the document.
-
-- **References and Citations:**
-  - If external sources are cited, they must be formatted with hanging indents and correct capitalization. Although the narrative does not include citations, any future references should comply with APA guidelines.
-
-Adopting these APA standards will ensure the document meets academic requirements and appears professionally formatted.
-
----
-
-## 4. Overall Recommendations
-
-While "The Battle of Glimmerwood" is imaginative and engaging, consider the following actions to further refine the work:
-
-- **Proofreading:** Address the identified spelling, grammar, and punctuation errors to improve clarity and professionalism.
-- **Narrative Clarity:** Provide additional context for certain fantasy elements (e.g., the nature of the Glimmerstones and the villagers’ relationship with magical creatures) to bolster logical consistency.
-- **APA Formatting:** Transition the document from Markdown to an APA-compliant format by creating a proper title page, adjusting heading styles, and ensuring standard text formatting (12-point Times New Roman, double spacing, 1-inch margins).
-
-Implementing these revisions will enhance both the readability and academic rigor of the work.
-
----
-
-*End of Report*
-
----
-
-## Final Consolidation and Objective Completion
-
-Based on the analysis across proofreading, factual/logical consistency, and APA style adherence, all criteria have been met. Minor enhancements, such as adding a dedicated fact-checking section, have been recommended, but these do not impede the overall completion of the objective.
-
-Objective Status: Complete.
+# Graded Report for 'The Battle of Glimmerwood'
+
+## Proofreading Feedback
+
+**Corrections and Feedback:**
+
+1. **Sentence 1:**
+   - Original: "In the heart of Glimmerwood, a mystical forest knowed for its radiant trees, a small village thrived."
+   - Correction: Change "knowed" to “known.”
+   - Revised: "In the heart of Glimmerwood, a mystical forest known for its radiant trees, a small village thrived."
+
+2. **Sentence 2:**
+   - Original: "The villagers, who were live peacefully, shared their home with the forest's magical creatures, especially the Glimmerfoxes whose fur shimmer like moonlight."
+   - Corrections:
+      - Change “were live” to "lived."
+      - Change "shimmer" to "shimmered."
+      - Add a comma after "Glimmerfoxes."
+   - Revised: "The villagers, who lived peacefully, shared their home with the forest's magical creatures, especially the Glimmerfoxes, whose fur shimmered like moonlight."
+
+3. **Sentence 3:**
+   - Original: "One fateful evening, the peace was shaterred when the infamous Dark Marauders attack."
+   - Corrections:
+     - Change "shaterred" to "shattered."
+     - Change "attack" to "attacked."
+   - Revised: "One fateful evening, the peace was shattered when the infamous Dark Marauders attacked."
+
+4. **Sentence 4:**
+   - Original: "Lead by the cunning Captain Thorn, the bandits aim to steal the precious Glimmerstones which was believed to grant immortality."
+   - Corrections:
+     - Change "Lead" to "Led."
+     - Change "aim" to "aimed."
+     - Change "was" to "were."
+     - Add a comma after "Glimmerstones."
+   - Revised: "Led by the cunning Captain Thorn, the bandits aimed to steal the precious Glimmerstones, which were believed to grant immortality."
+
+5. **Sentence 5:**
+   - Original: "Amidst the choas, a young girl named Elara stood her ground, she rallied the villagers and devised a clever plan."
+   - Corrections:
+     - Correct the spelling from "choas" to "chaos."
+     - Consider separating into two sentences for clarity.
+     - Add a comma after "villagers."
+   - Revised: "Amidst the chaos, a young girl named Elara stood her ground. She rallied the villagers and devised a clever plan."
+
+6. **Sentence 6:**
+   - Original: "Using the forests natural defenses they lured the marauders into a trap."
+   - Correction: Add an apostrophe to "forests" to make it possessive.
+   - Revised: "Using the forest's natural defenses, they lured the marauders into a trap."
+
+7. **Sentence 7:**
+   - Original: "As the bandits aproached the village square, a herd of Glimmerfoxes emerged, blinding them with their dazzling light, the villagers seized the opportunity to captured the invaders."
+   - Corrections:
+     - Correct the spelling from "aproached" to "approached."
+     - Consider separating into two sentences for clarity.
+     - Change "captured" to "capture."
+   - Revised: "As the bandits approached the village square, a herd of Glimmerfoxes emerged, blinding them with their dazzling light. The villagers seized the opportunity to capture the invaders."
+
+8. **Sentence 8:**
+   - Original: "Elara's bravery was celebrated and she was hailed as the 'Guardian of Glimmerwood'."
+   - Correction: Add a comma after "celebrated."
+   - Revised: "Elara's bravery was celebrated, and she was hailed as the 'Guardian of Glimmerwood.'"
+
+9. **Sentence 9:**
+   - Original: "The Glimmerstones were secured in a hidden grove protected by an ancient spell."
+   - Feedback: This sentence is grammatically correct.
+
+10. **Sentence 10:**
+    - Original: "However, not all was as it seemed. The Glimmerstones true power was never confirm, and whispers of a hidden agenda linger among the villagers."
+    - Corrections:
+      - Add an apostrophe to "Glimmerstones" to make it possessive.
+      - Change "confirm" to "confirmed."
+      - Change "linger" to "lingered."
+   - Revised: "However, not all was as it seemed. The Glimmerstones' true power was never confirmed, and whispers of a hidden agenda lingered among the villagers."
+
+## Factuality and Logical Consistency
+
+1. **Setting Description:**
+   - The story effectively describes Glimmerwood, a mystical forest known for its radiant trees, setting a consistent fantasy tone with magical creatures like Glimmerfoxes.
+
+2. **Character and Plot Consistency:**
+   - The scenario with Elara rallying the villagers against the Dark Marauders aligns with common fantasy hero themes.
+   - The belief in Glimmerstones granting immortality is inconsistent with the unresolved mystery of their true power, suggesting a need for earlier acknowledgment.
+   - The forest's defenses and Glimmerfoxes' role in trapping marauders is plausible within the fantasy context, showcasing Elara’s bravery and cleverness.
+
+3. **Logical Inconsistencies:**
+   - The transition between invasion and resolution is abrupt; more detail would fortify understanding of the trap setup.
+   - The mention of a "hidden agenda" requires clarification if pivotal to the plot.
+
+## Adherence to APA Style Guidelines
+
+1. **Title and Headings:**
+   - Ensure the title "The Battle of Glimmerwood" appears centered and bolded.
+
+2. **Font and Spacing:**
+   - Consistent use of a 12-point Times New Roman font with double spacing.
+
+3. **Margins:**
+   - Standard 1-inch margins should be present on all sides.
+
+4. **Grammar and Clarity:**
+   - Improvements made by correcting grammar errors like "knowed" to "known" and resolving run-on sentences for clarity.
+   - Proper past tense usage enforced for verbs such as "attack" to "attacked."
+
+5. **Tone and Engagement:**
+   - A formal but narrative tone is maintained while using engaging language to enhance plot and characters in adherence to style.
+
+### Suggestions for Enhancement:
+
+- **Character Development:** Additional background or internal dialogues for characters like Elara can heighten reader engagement.
+- **Descriptive Language:** Employing vivid descriptions for mystical elements enhances immersion.
+- **Conflict Resolution:** Detailed explanation of invasion repulsion strategies provides satisfying conflict resolution.
+
+The feedback provided aims to refine the overall storytelling experience while ensuring adherence to APA formatting standards where applicable.

examples/mcp_root_test/test_data/plots/exercise_and_weight_distribution.png

@@ -1,6 +1,6 @@
 [project]
 name = "mcp-agent"
-version = "0.0.14"
+version = "0.0.15"
 description = "Build effective agents with Model Context Protocol (MCP) using simple, composable patterns."
 readme = "README.md"
 license = { file = "LICENSE" }