Merge branch 'main' into update_makefile

Author: Abhijit L

.flake8

@@ -1,4 +1,4 @@
 [flake8]
 max-line-length = 88
-exclude = .git,.github,.chglog,__pycache__,docs,venv
+exclude = .git,.github,.chglog,__pycache__,docs,venv,env,mypy_cache
 max-complexity = 10

changelogs/LATEST-WEEKLY-CHANGELOG.md

@@ -1,8 +1,10 @@
-# Update v0.0.2-weekly - June 30, 2025
+## Update: Version v0.0.3-weekly (July 7, 2025)
 
-We're excited to share the latest updates in our v0.0.2-weekly release. For a detailed look at the changes between this and our previous release, please visit our [GitHub page](https://github.com/getjavelin/compare/v0.0.1-weekly...v0.0.2-weekly).
+Explore what's new in the latest release of our software. 
 
-Stay tuned for more updates in the upcoming releases!
+For more details on the changes made in this update, you can view the specific comparisons:
+- To see what's different from the previous weekly version, check out the [comparison with v0.0.2-weekly](https://github.com/getjavelin/javelin-python/compare/v0.0.2-weekly...v0.0.3-weekly).
+- For ongoing developments beyond this release, take a look at the [comparison with our latest work](https://github.com/getjavelin/javelin-python/compare/v0.0.3-weekly...HEAD).
 
 ---
 

changelogs/WEEKLY-CHANGELOG.md

@@ -1,3 +1,13 @@
+## Update: Version v0.0.3-weekly (July 7, 2025)
+
+Explore what's new in the latest release of our software. 
+
+For more details on the changes made in this update, you can view the specific comparisons:
+- To see what's different from the previous weekly version, check out the [comparison with v0.0.2-weekly](https://github.com/getjavelin/javelin-python/compare/v0.0.2-weekly...v0.0.3-weekly).
+- For ongoing developments beyond this release, take a look at the [comparison with our latest work](https://github.com/getjavelin/javelin-python/compare/v0.0.3-weekly...HEAD).
+
+---
+
 # Update v0.0.2-weekly - June 30, 2025
 
 We're excited to share the latest updates in our v0.0.2-weekly release. For a detailed look at the changes between this and our previous release, please visit our [GitHub page](https://github.com/getjavelin/compare/v0.0.1-weekly...v0.0.2-weekly).

examples/agents/adk_gemini_agent_javelin/__init__.py

@@ -1 +0,0 @@
-from .agent import root_agent

examples/agents/adk_gemini_agent_javelin/agent.py

@@ -69,9 +69,10 @@
 # Coordinator agent
 root_agent = SequentialAgent(
     name="GeminiMultiAgentCoordinator",
-    sub_agents=[research_agent, summary_agent, report_agent]
+    sub_agents=[research_agent, summary_agent, report_agent],
 )
 
+
 async def main():
     session_service = InMemorySessionService()
     session_service.create_session("gemini_multi_agent_app", "user", "sess")
@@ -93,5 +94,6 @@ async def main():
 
     print("\n--- Final Report ---\n", final_answer)
 
+
 if __name__ == "__main__":
     asyncio.run(main())

examples/agents/adk_openai_agent_javelin/__init__.py

@@ -1 +0,0 @@
-from .agent import root_agent

examples/agents/adk_openai_agent_javelin/agent.py

@@ -69,7 +69,7 @@
 # Coordinator agent running all three sequentially
 coordinator = SequentialAgent(
     name="OpenAI_MultiAgentCoordinator",
-    sub_agents=[research_agent, summary_agent, report_agent]
+    sub_agents=[research_agent, summary_agent, report_agent],
 )
 root_agent = coordinator
 
@@ -96,5 +96,6 @@ async def main():
 
     print("\n--- Final Report ---\n", final_answer)
 
+
 if __name__ == "__main__":
-    asyncio.run(main())
+    asyncio.run(main())

examples/agents/openai_agents_javelin.py

@@ -27,17 +27,19 @@
 javelin_base_url = os.getenv("JAVELIN_BASE_URL", "")
 
 if not (openai_api_key and javelin_api_key and javelin_base_url):
-    raise ValueError("Missing OPENAI_API_KEY, JAVELIN_API_KEY, or JAVELIN_BASE_URL in .env")
+    raise ValueError(
+        "Missing OPENAI_API_KEY, JAVELIN_API_KEY, or JAVELIN_BASE_URL in .env"
+    )
 
 # Create async OpenAI client
 async_openai_client = AsyncOpenAI(api_key=openai_api_key)
 
 # Register with Javelin
-javelin_client = JavelinClient(JavelinConfig(
-    javelin_api_key=javelin_api_key,
-    base_url=javelin_base_url
-))
-javelin_client.register_openai(async_openai_client, route_name="openai_univ")  # Adjust route name if needed
+javelin_client = JavelinClient(
+    JavelinConfig(javelin_api_key=javelin_api_key, base_url=javelin_base_url)
+)
+# Adjust route name if needed
+javelin_client.register_openai(async_openai_client, route_name="openai_univ")
 
 # Let the Agents SDK use this Javelin-patched client globally
 set_default_openai_client(async_openai_client)
@@ -59,7 +61,7 @@
 ##############################################################################
 translator_agent = Agent(
     name="TranslatorAgent",
-    instructions="Translate any English text into Spanish. Keep it concise."
+    instructions="Translate any English text into Spanish. Keep it concise.",
 )
 
 ##############################################################################
@@ -78,18 +80,20 @@
     tools=[
         faux_search_agent.as_tool(
             tool_name="summarize_topic",
-            tool_description="Produce a concise internal summary of the user’s topic."
+            tool_description="Produce a concise internal summary of the user’s topic.",
         ),
         translator_agent.as_tool(
             tool_name="translate_to_spanish",
-            tool_description="Translate text into Spanish."
+            tool_description="Translate text into Spanish.",
         ),
     ],
 )
 
 ##############################################################################
 # 5) Demo Usage
 ##############################################################################
+
+
 async def main():
     user_query = "Why is pollution increasing ?"
     print(f"\n=== User Query: {user_query} ===\n")
@@ -98,5 +102,6 @@ async def main():
     print("=== Final Output ===\n")
     print(final_result.final_output)
 
+
 if __name__ == "__main__":
     asyncio.run(main())

examples/anthropic/anthropic_api_function_calling.py

@@ -16,10 +16,10 @@
 # Headers
 headers = {
     "Content-Type": "application/json",
-    "x-javelin-route": "anthropic_univ", # add your universal route
-    "x-javelin-model": "claude-3-5-sonnet-20240620", # add any supported model
+    "x-javelin-route": "anthropic_univ",  # add your universal route
+    "x-javelin-model": "claude-3-5-sonnet-20240620",  # add any supported model
     "x-javelin-provider": "https://api.anthropic.com/v1",
-    "x-api-key": os.getenv("ANTHROPIC_API_KEY"), 
+    "x-api-key": os.getenv("ANTHROPIC_API_KEY"),
     "anthropic-version": "2023-06-01",
 }
 client.set_headers(headers)
@@ -44,7 +44,9 @@
 messages = [
     {
         "role": "user",
-        "content": [{"type": "text", "text": "What's the weather like in Mumbai in celsius?"}],
+        "content": [
+            {"type": "text", "text": "What's the weather like in Mumbai in celsius?"}
+        ],
     }
 ]
 

examples/anthropic/anthropic_function_call.py

@@ -6,6 +6,7 @@
 
 # Load environment variables
 from dotenv import load_dotenv
+
 load_dotenv()
 
 # Javelin Setup
@@ -25,7 +26,10 @@
 
 # Messages and dummy tool call (check if tool support throws any error)
 messages = [
-    {"role": "user", "content": "Please call the tool to fetch today's weather in Paris."}
+    {
+        "role": "user",
+        "content": "Please call the tool to fetch today's weather in Paris.",
+    }
 ]
 
 tools = [
@@ -37,11 +41,12 @@
             "properties": {
                 "city": {"type": "string", "description": "Name of the city"},
             },
-            "required": ["city"]
-        }
+            "required": ["city"],
+        },
     }
 ]
 
+
 async def run_anthropic_test():
     print("\n==== Testing Anthropic Function Calling Support via Javelin ====")
     try:
@@ -64,5 +69,6 @@ async def run_anthropic_test():
     except Exception as e:
         print(f"Function/tool call failed for Anthropic: {str(e)}")
 
+
 if __name__ == "__main__":
     asyncio.run(run_anthropic_test())