gemini-agent-framework 0.1.2__tar.gz → 0.1.3__tar.gz

{gemini_agent_framework-0.1.2 → gemini_agent_framework-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemini-agent-framework
-Version: 0.1.2
+Version: 0.1.3
 Summary: A framework for building agents that use Gemini's function calling capabilities
 Project-URL: Homepage, https://github.com/m7mdony/gemini-agent-framework
 Project-URL: Documentation, https://github.com/m7mdony/gemini-agent-framework#readme

{gemini_agent_framework-0.1.2 → gemini_agent_framework-0.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "gemini-agent-framework"
-version = "0.1.2"
+version = "0.1.3"
 description = "A framework for building agents that use Gemini's function calling capabilities"
 readme = "README.md"
 requires-python = ">=3.8"

gemini_agent_framework-0.1.3/src/gemini_agent/__init__.py

@@ -0,0 +1,4 @@
+from .agent import Agent
+
+__version__ = "0.1.1"
+__all__ = ["Agent"] 

{gemini_agent_framework-0.1.2 → gemini_agent_framework-0.1.3}/src/gemini_agent/agent.py

@@ -4,6 +4,7 @@ import inspect
 from functools import wraps
 from typing import List, Callable, Dict, Any, Optional
 from dotenv import load_dotenv
+from datetime import datetime
 
 load_dotenv()
 
@@ -76,6 +77,7 @@ class Agent:
         self._tool_functions: Dict[str, Callable] = {}  # Map name to actual function
         self._tool_instances: Dict[str, Any] = {}  # Store instances for class methods
         self._intermediate_results: Dict[str, Any] = {}  # Store intermediate results
+        self._stored_variables: Dict[str, Dict[str, Any]] = {}  # Store variables with metadata
 
         if tools:
             self._process_tools(tools)
@@ -138,8 +140,52 @@ class Agent:
 
             self._registered_tools_json.append(declaration_json)
 
+    def set_variable(self, name: str, value: Any, description: str = "", type_hint: type = None) -> None:
+        """
+        Stores a variable in the agent's memory with metadata.
+
+        Args:
+            name: The name of the variable
+            value: The actual value to store
+            description: A description of what the variable represents
+            type_hint: Optional type hint for the variable
+        """
+        self._stored_variables[name] = {
+            'value': value,
+            'description': description,
+            'type': type_hint or type(value).__name__,
+            'created_at': datetime.now().isoformat()
+        }
+
+    def get_variable(self, name: str) -> Any:
+        """
+        Retrieves a stored variable's value.
+
+        Args:
+            name: The name of the variable to retrieve
+
+        Returns:
+            The stored value or None if not found
+        """
+        return self._stored_variables.get(name, {}).get('value')
+
+    def list_variables(self) -> Dict[str, Dict[str, Any]]:
+        """
+        Returns information about all stored variables.
+
+        Returns:
+            Dictionary of variable names to their metadata
+        """
+        return {name: {k: v for k, v in data.items() if k != 'value'} 
+                for name, data in self._stored_variables.items()}
+
     def _get_system_prompt(self) -> str:
         """Returns a system prompt that guides the model in breaking down complex operations."""
+        variables_info = "\n".join([
+            f"- {name}: {data['description']} (Type: {data['type']})"
+            for name, data in self._stored_variables.items()
+        ])
+        
         return """You are an AI assistant that can break down complex tasks into sequential steps using available tools.
         When faced with a complex request:
         1. Analyze the request to identify which tools can be used
@@ -152,13 +198,49 @@ class Agent:
         Available tools:
         {tools_list}
         
+        Available variables:
+        {variables_list}
+        
+        IMPORTANT - Variable Usage:
+        When you need to use a stored variable in a function call, you MUST use the following syntax:
+        - For function arguments: {{"variable": "variable_name"}}
+        - For example, if you want to use the 'current_user' variable in a function call:
+          {{"user_id": {{"variable": "current_user"}}}}
+        
         Remember:
         - Always perform one operation at a time
         - Use intermediate results from previous steps
         - If a step requires multiple tools, execute them sequentially
         - If you're unsure about the next step, explain your reasoning
-        """.format(tools_list="\n".join([f"- {name}: {desc}" for name, desc in 
-            [(tool['name'], tool['description']) for tool in self._registered_tools_json]]))
+        - You can use both stored variables and values from the prompt
+        - When using stored variables, ALWAYS use the {{"variable": "variable_name"}} syntax
+        """.format(
+            tools_list="\n".join([f"- {name}: {desc}" for name, desc in 
+                [(tool['name'], tool['description']) for tool in self._registered_tools_json]]),
+            variables_list=variables_info
+        )
+
+    def _substitute_variables(self, args: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Substitutes stored variable values in function arguments.
+
+        Args:
+            args: Dictionary of argument names to values
+
+        Returns:
+            Dictionary with variable values substituted where applicable
+        """
+        substituted_args = {}
+        for name, value in args.items():
+            if isinstance(value, dict) and "variable" in value:
+                var_name = value["variable"]
+                if var_name in self._stored_variables:
+                    substituted_args[name] = self._stored_variables[var_name]['value']
+                else:
+                    substituted_args[name] = value
+            else:
+                substituted_args[name] = value
+        return substituted_args
 
     def _call_gemini_api(self, payload: Dict[str, Any]) -> Dict[str, Any]:
         """Makes a POST request to the Gemini generateContent endpoint."""
@@ -210,7 +292,7 @@ class Agent:
         current_contents = conversation_history if conversation_history else []
         if system_prompt and not current_contents:
             current_contents.append({'role': 'user', 'parts': [{'text': system_prompt}]})
-            current_contents.append({'role': 'model', 'parts': [{'text': "I understand I should break down complex tasks into sequential steps using the available tools."}]})
+            current_contents.append({'role': 'model', 'parts': [{'text': "I understand I should break down complex tasks into sequential steps using the available tools and variables."}]})
 
         current_contents.append({'role': 'user', 'parts': [{'text': user_prompt}]})
         payload: Dict[str, Any] = {"contents": current_contents}
@@ -242,7 +324,6 @@ class Agent:
 
         while True:
             response_data = self._call_gemini_api(payload)
-
             if "error" in response_data:
                 print(f"API call failed: {response_data['error'].get('message', 'Unknown API error')}")
                 return response_data
@@ -285,6 +366,8 @@ class Agent:
                             tool_function = self._tool_functions[tool_name]
                             print(f"--- Calling Function: {tool_name}({args}) ---")
                             
+                            # Substitute both stored variables and intermediate results
+                            args = self._substitute_variables(args)
                             for key, value in args.items():
                                 if isinstance(value, str) and value.startswith('$'):
                                     result_key = value[1:]

gemini_agent_framework-0.1.3/tests/__init__.py

@@ -0,0 +1,3 @@
+"""
+Test package for the Gemini Agent Framework.
+""" 

{gemini_agent_framework-0.1.2 → gemini_agent_framework-0.1.3}/tests/test_agent.py

@@ -1,6 +1,6 @@
 import os
 from dotenv import load_dotenv
-from gemini_agent import Agent
+from framework_agent import Agent
 
 load_dotenv()
 

gemini_agent_framework-0.1.3/tests/test_variables.py

@@ -0,0 +1,133 @@
+from agent import Agent
+import os
+from dotenv import load_dotenv
+import json
+from bs4 import BeautifulSoup
+
+load_dotenv()
+
+class HTMLAnalyzer:
+    @Agent.description("Count the number of input tags in an HTML page")
+    @Agent.parameters({
+        'html_content': {'type': str, 'description': 'The HTML content to analyze'}
+    })
+    def count_inputs(self, html_content: str) -> dict:
+        soup = BeautifulSoup(html_content, 'html.parser')
+        input_tags = soup.find_all('input')
+        return {
+            "count": len(input_tags),
+            "input_types": [tag.get('type', 'unknown') for tag in input_tags]
+        }
+
+# Create HTML pages
+home_page = """
+<!DOCTYPE html>
+<html>
+<head>
+    <title>Home Page</title>
+</head>
+<body>
+    <header>
+        <nav>
+            <a href="/">Home</a>
+            <a href="/about">About</a>
+            <a href="/contact">Contact</a>
+        </nav>
+    </header>
+    <main>
+        <h1>Welcome to Our Website</h1>
+        <p>This is a simple home page with no input fields.</p>
+    </main>
+    <footer>
+        <p>&copy; 2024 Our Website</p>
+    </footer>
+</body>
+</html>
+"""
+
+login_page = """
+<!DOCTYPE html>
+<html>
+<head>
+    <title>Login Page</title>
+</head>
+<body>
+    <header>
+        <nav>
+            <a href="/">Home</a>
+            <a href="/login">Login</a>
+        </nav>
+    </header>
+    <main>
+        <h1>Login</h1>
+        <form action="/login" method="POST">
+            <div>
+                <label for="username">Username:</label>
+                <input type="text" id="username" name="username" required>
+            </div>
+            <div>
+                <label for="password">Password:</label>
+                <input type="password" id="password" name="password" required>
+            </div>
+            <div>
+                <input type="checkbox" id="remember" name="remember">
+                <label for="remember">Remember me</label>
+            </div>
+            <button type="submit">Login</button>
+        </form>
+    </main>
+    <footer>
+        <p>&copy; 2024 Our Website</p>
+    </footer>
+</body>
+</html>
+"""
+
+# Create the analyzer instance
+html_analyzer = HTMLAnalyzer()
+
+# Create the agent with our tool
+agent = Agent(
+    api_key=os.getenv("GEMINI_API_KEY"),
+    tools=[html_analyzer.count_inputs]
+)
+
+# Store the HTML pages as variables
+agent.set_variable(
+    name="home_page",
+    value=home_page,
+    description="The HTML content of the home page",
+    type_hint=str
+)
+
+
+
+# Example 1: Count inputs in home page
+print("\nExample 1: Count inputs in home page")
+response = agent.prompt(
+    "How many input tags are in the home page?",
+    response_structure={
+        "type": "object",
+        "properties": {
+            "count": {"type": "integer"},
+            "input_types": {"type": "array", "items": {"type": "string"}}
+        },
+        "required": ["count", "input_types"]
+    }
+)
+print(json.dumps(response, indent=2))
+
+# Example 2: Count inputs in login page
+print("\nExample 2: Count inputs in login page")
+response = agent.prompt(
+    "How many input tags are in this page  "+ login_page,
+    response_structure={
+        "type": "object",
+        "properties": {
+            "count": {"type": "integer"},
+            "input_types": {"type": "array", "items": {"type": "string"}}
+        },
+        "required": ["count", "input_types"]
+    }
+)
+print(json.dumps(response, indent=2)) 

gemini_agent_framework-0.1.2/src/gemini_agent/__init__.py

@@ -1,4 +0,0 @@
-from .agent import Agent
-
-__version__ = "0.1.2"
-__all__ = ["Agent"]