Update instructor dependency to 1.7.7 and fix the streamlit example

Author: saqadri

examples/mcp_basic_agent/main.py

@@ -80,11 +80,9 @@ async def example_usage():
             llm = await finder_agent.attach_llm(AnthropicAugmentedLLM)
 
             result = await llm.generate_str(
-                message="Print the first 2 paragraphs of https://www.anthropic.com/research/building-effective-agents",
-            )
-            logger.info(
-                f"First 2 paragraphs of Building Effective Agents blog post: {result}"
+                message="Print the first 2 paragraphs of https://modelcontextprotocol.io/introduction",
             )
+            logger.info(f"First 2 paragraphs of Model Context Protocol docs: {result}")
 
             # Multi-turn conversations
             result = await llm.generate_str(

examples/mcp_basic_ollama_agent/main.py

@@ -42,7 +42,7 @@ async def example_usage():
 
             # Let's switch the same agent to a different LLM
             result = await llm.generate_str(
-                message="Print the first 2 paragraphs of https://www.anthropic.com/research/building-effective-agents",
+                message="Print the first 2 paragraphs of https://modelcontextprotocol.io/introduction",
                 request_params=RequestParams(model="llama3.1:8b"),
             )
             logger.info(f"Result: {result}")

examples/streamlit_mcp_basic_agent/README.md

@@ -5,14 +5,12 @@ This Streamlit example shows a "finder" Agent which has access to the 'fetch' an
 You can ask it information about local files or URLs, and it will make the determination on what to use at what time to satisfy the request.
 
 To run this example:
-```bash
-streamlit run main.py
-```
 
 With uv:
 
 ```bash
-uv run streamlit run ./main.py
+uv pip install -r requirements.txt
+uv run streamlit run main.py
 ```
 
 <img src="https://github.com/user-attachments/assets/7ad27d23-9ed6-4e0e-ba7f-2d3b0afef847" height="512">

examples/streamlit_mcp_basic_agent/mcp_agent.config.yaml

@@ -10,6 +10,7 @@ logger:
   http_endpoint:
   http_headers:
   http_timeout: 5
+  progress_display: false
 
 mcp:
   servers:

examples/streamlit_mcp_basic_agent/pyproject.toml

@@ -10,20 +10,18 @@ logger:
   http_endpoint:
   http_headers:
   http_timeout: 5
+  progress_display: false
 
 mcp:
   servers:
     qdrant:
       command: "uvx"
-      args:
-        [
-          "mcp-server-qdrant"
-        ]
+      args: ["mcp-server-qdrant"]
       env:
         {
           "QDRANT_URL": "http://localhost:6333",
           "COLLECTION_NAME": "my_collection",
-          "EMBEDDING_MODEL": "BAAI/bge-small-en-v1.5"
+          "EMBEDDING_MODEL": "BAAI/bge-small-en-v1.5",
         }
 
 openai:

examples/streamlit_mcp_rag_agent/mcp_agent.config.yaml

@@ -1,46 +1,82 @@
-# Graded Report for 'The Battle of Glimmerwood'
+# Graded Report: Evaluation of "The Battle of Glimmerwood"
 
-This report provides aggregated feedback on the student's short story, covering three key areas: Proofreading and Grammar, Factual/Logical Consistency, and APA Style Adherence. Below are detailed observations and recommendations for improvement.
+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.
 
-## I. Proofreading and Grammar
+---
 
-- **Spelling and Word Choice:**
-  - Replace "knowed" with "known".
-  - Change "live peacefully" to "lived peacefully".
-  - Correct "shaterred" to "shattered" and "aproached" to "approached".
-  - Adjust verbs for past tense consistency (e.g., "attack" to "attacked", "lead" to "led", "aim" to "aimed").
+## 1. Proofreading Feedback
 
-- **Punctuation and Sentence Structure:**
-  - Address comma splices by splitting run-on sentences or using semicolons appropriately.
-  - Add missing apostrophes for possessives (e.g., "forests natural defenses" should be "forest's natural defenses", "Glimmerstones true power" should be "Glimmerstones' true power").
-  - Improve overall clarity by breaking overly long sentences into shorter, more digestible segments.
+The text contains several typographical, grammatical, and punctuation issues. Key points include:
 
-## II. Factuality and Logical Consistency
+- **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"*.
 
-- **Narrative Consistency:**
-  - The fantasy world is generally well-established with a mystical setting and clear roles (villagers, Dark Marauders, heroic Elara).
-  
-- **Ambiguity in Key Elements:**
-  - There is an inconsistency regarding the Glimmerstones. Initially presented as objects believed to grant immortality, their true power is later described as unconfirmed. Clarifying this point would enhance the logical coherence of the narrative.
+- **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"*).
 
-## III. APA Style Adherence
+- **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.
 
-- **Title Page and Formatting:**
-  - APA style requires a dedicated title page with the title in title case, centered along with author and institutional information. The markdown header ("## The Battle of Glimmerwood") does not meet this requirement.
+Addressing these issues will enhance readability and ensure the narrative is polished.
 
-- **Running Head and Page Numbers:**
-  - Include a running head (a shortened version of the title) and page numbers on each page of the document.
+---
 
-- **General Formatting Guidelines:**
-  - The document should adhere to 1-inch margins, be double spaced, and use a consistent font (e.g., 12-point Times New Roman).
-  - Any references or external sources must be cited in APA format, with a reference list using hanging indents.
+## 2. Fact-Checking and Logical Consistency
 
-## IV. Overall Recommendations
+The story is set within a fantasy framework and largely maintains internal consistency. Notable points include:
 
-- Correct all identified spelling and grammatical errors.
-- Rework sentences to eliminate comma splices and improve clarity.
-- Clarify the ambiguous narrative elements (specifically the true nature and role of the Glimmerstones) to enhance logical consistency.
-- Reformat the document to comply fully with APA guidelines, including the creation of a separate title page, inclusion of a running head, and proper citation formatting where necessary.
+- **Consistency with the Genre:**
+  - The narrative establishes a mystical setting (Glimmerwood) with magical creatures and powerful artifacts (Glimmerstones) that fit within the fantasy genre.
 
-**Conclusion:**
-Implementing these recommendations will significantly improve the clarity, coherence, and professional presentation of the narrative. The feedback provided should serve as a comprehensive guide to refining the story both stylistically and academically.
+- **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.

examples/workflow_orchestrator_worker/graded_report.md

@@ -108,7 +108,7 @@ async def example_usage():
         # This should route the query to fetch MCP server (inferring just by the server name alone!)
         # You can also specify a server description in mcp_agent.config.yaml to help the router make a more informed decision
         results = await anthropic_router.route_to_server(
-            request="Print the first two paragraphs of https://www.anthropic.com/research/building-effective-agents",
+            request="Print the first two paragraphs of https://modelcontextprotocol.io/introduction",
             top_k=1,
         )
         logger.info("Router Results:", data=results)

examples/workflow_router/main.py

@@ -1,6 +1,6 @@
 [project]
 name = "mcp-agent"
-version = "0.0.10"
+version = "0.0.11"
 description = "Build effective agents with Model Context Protocol (MCP) using simple, composable patterns."
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -15,7 +15,7 @@ classifiers = [
 requires-python = ">=3.10"
 dependencies = [
     "fastapi>=0.115.6",
-    "instructor>=1.7.0",
+    "instructor>=1.7.7",
     "mcp>=1.2.1",
     "opentelemetry-distro>=0.50b0",
     "opentelemetry-exporter-otlp-proto-http>=1.29.0",
@@ -33,7 +33,7 @@ temporal = [
     "temporalio>=1.8.0",
 ]
 anthropic = [
-    "anthropic>=0.42.0",
+    "anthropic>=0.48.0",
     "instructor[anthropic]>=1.7.2",
 ]
 openai = [
@@ -67,7 +67,4 @@ silsila = "mcp_agent.cli.__main__:app"
 include = ["mcp-agent"]
 
 [tool.setuptools.package-data]
-mcp-agent = ["data/*.json"]
-
-[tool.uv.workspace]
-members = ["examples/streamlit_mcp_basic_agent"]
+mcp-agent = ["data/*.json"]

pyproject.toml

@@ -268,14 +268,14 @@ async def call_tool(
 
         if SEP in name:  # Namespaced tool name
             parts = name.split(SEP)
-            
+
             for i in range(len(parts) - 1, 0, -1):
                 potential_server_name = SEP.join(parts[:i])
                 if potential_server_name in self.server_names:
                     server_name = potential_server_name
                     local_tool_name = SEP.join(parts[i:])
                     break
-                
+
             if server_name is None:
                 server_name, local_tool_name = name.split(SEP, 1)
         else:

src/mcp_agent/mcp/mcp_aggregator.py

@@ -3,7 +3,6 @@
 
 from pydantic import BaseModel
 
-import instructor
 from anthropic import Anthropic
 from anthropic.types import (
     ContentBlock,
@@ -271,6 +270,8 @@ async def generate_structured(
         # We need to do this in a two-step process because Instructor doesn't
         # know how to invoke MCP tools via call_tool, so we'll handle all the
         # processing first and then pass the final response through Instructor
+        import instructor
+
         response = await self.generate_str(
             message=message,
             request_params=request_params,

src/mcp_agent/workflows/llm/augmented_llm_anthropic.py

@@ -1,7 +1,6 @@
 import json
 from typing import Iterable, List, Type
 
-import instructor
 from openai import OpenAI
 from openai.types.chat import (
     ChatCompletionAssistantMessageParam,
@@ -291,6 +290,8 @@ async def generate_structured(
         # We need to do this in a two-step process because Instructor doesn't
         # know how to invoke MCP tools via call_tool, so we'll handle all the
         # processing first and then pass the final response through Instructor
+        import instructor
+
         response = await self.generate_str(
             message=message,
             request_params=request_params,