Merge branch 'main' into docs/add-langchain-integration-readme

Author: glebedel

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.0.4"
+  ".": "0.3.0"
 }

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.3.0](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v0.0.4...stackone-ai-v0.3.0) (2025-08-19)
+
+
+### Features
+
+* add CLAUDE.md for Claude Code guidance ([#15](https://github.com/StackOneHQ/stackone-ai-python/issues/15)) ([ac9fe98](https://github.com/StackOneHQ/stackone-ai-python/commit/ac9fe9857f44c19394654dfcbe23fecc5cf9fbb0))
+* bring Python SDK to feature parity with Node SDK ([#17](https://github.com/StackOneHQ/stackone-ai-python/issues/17)) ([8b6de99](https://github.com/StackOneHQ/stackone-ai-python/commit/8b6de99184227cb7f1580964dc3eae14f8f60fc1))
+* remove automatic STACKONE_ACCOUNT_ID environment variable loading ([#23](https://github.com/StackOneHQ/stackone-ai-python/issues/23)) ([aa0aaf6](https://github.com/StackOneHQ/stackone-ai-python/commit/aa0aaf6d6bf528f8e29def9b008db23cf94b97c7))
+* simplify meta tool function names to match Node SDK ([#19](https://github.com/StackOneHQ/stackone-ai-python/issues/19)) ([4572609](https://github.com/StackOneHQ/stackone-ai-python/commit/4572609a9b85a88fc3067be12f821ec0bc54e769))
+
+
+### Miscellaneous Chores
+
+* release 0.3.0 ([#24](https://github.com/StackOneHQ/stackone-ai-python/issues/24)) ([beea911](https://github.com/StackOneHQ/stackone-ai-python/commit/beea91165ed2ba3eb5f5ad6ca8656344561b0b43))
+
 ## [0.0.4](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v0.0.3...stackone-ai-v0.0.4) (2025-03-05)
 
 

CLAUDE.md

@@ -79,7 +79,7 @@ tools = StackOneToolSet(include_tools=["hris_*", "!hris_create_*"])
 # Uses environment variables or direct configuration
 toolset = StackOneToolSet(
     api_key="your-api-key",  # or STACKONE_API_KEY env var
-    account_id="optional-id"  # or STACKONE_ACCOUNT_ID env var
+    account_id="optional-id"  # explicit account ID required
 )
 ```
 

examples/meta_tools_example.py

@@ -31,7 +31,7 @@ def example_meta_tools_basic():
     meta_tools = all_tools.meta_tools()
 
     # Get the filter tool to search for relevant tools
-    filter_tool = meta_tools.get_tool("meta_filter_relevant_tools")
+    filter_tool = meta_tools.get_tool("meta_search_tools")
     if filter_tool:
         # Search for employee management tools
         result = filter_tool.call(query="manage employees create update list", limit=5, minScore=0.0)
@@ -55,7 +55,7 @@ def example_meta_tools_with_execution():
     meta_tools = all_tools.meta_tools()
 
     # Step 1: Search for relevant tools
-    filter_tool = meta_tools.get_tool("meta_filter_relevant_tools")
+    filter_tool = meta_tools.get_tool("meta_search_tools")
     execute_tool = meta_tools.get_tool("meta_execute_tool")
 
     if filter_tool and execute_tool:
@@ -138,7 +138,7 @@ def example_with_openai():
             messages=[
                 {
                     "role": "system",
-                    "content": "You are an HR assistant. Use meta_filter_relevant_tools to find appropriate tools, then meta_execute_tool to execute them.",
+                    "content": "You are an HR assistant. Use meta_search_tools to find appropriate tools, then meta_execute_tool to execute them.",
                 },
                 {"role": "user", "content": "Can you help me find tools for managing employee records?"},
             ],

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stackone-ai"
-version = "0.0.4"
+version = "0.3.0"
 description = "agents performing actions on your SaaS"
 readme = "README.md"
 requires-python = ">=3.11"

stackone_ai/__init__.py

@@ -4,4 +4,4 @@
 from .toolset import StackOneToolSet
 
 __all__ = ["StackOneToolSet", "StackOneTool", "Tools"]
-__version__ = "0.0.4"
+__version__ = "0.3.0"

stackone_ai/meta_tools.py

@@ -16,7 +16,7 @@
 
 
 class MetaToolSearchResult(BaseModel):
-    """Result from meta_filter_relevant_tools"""
+    """Result from meta_search_tools"""
 
     name: str
     description: str
@@ -106,16 +106,16 @@ def search(self, query: str, limit: int = 5, min_score: float = 0.0) -> list[Met
         return search_results
 
 
-def create_meta_filter_tool(index: ToolIndex) -> StackOneTool:
-    """Create the meta_filter_relevant_tools tool
+def create_meta_search_tools(index: ToolIndex) -> StackOneTool:
+    """Create the meta_search_tools tool
 
     Args:
         index: Tool search index
 
     Returns:
-        Meta tool for filtering relevant tools
+        Meta tool for searching relevant tools
     """
-    name = "meta_filter_relevant_tools"
+    name = "meta_search_tools"
     description = (
         "Searches for relevant tools based on a natural language query. "
         "This tool should be called first to discover available tools before executing them."
@@ -180,8 +180,8 @@ def execute_filter(arguments: str | JsonDict | None = None) -> JsonDict:
     )
 
     # Create a wrapper class that delegates execute to our custom function
-    class MetaFilterTool(StackOneTool):
-        """Meta tool for filtering relevant tools"""
+    class MetaSearchTool(StackOneTool):
+        """Meta tool for searching relevant tools"""
 
         def __init__(self) -> None:
             super().__init__(
@@ -195,7 +195,7 @@ def __init__(self) -> None:
         def execute(self, arguments: str | JsonDict | None = None) -> JsonDict:
             return execute_filter(arguments)
 
-    return MetaFilterTool()
+    return MetaSearchTool()
 
 
 def create_meta_execute_tool(tools_collection: Tools) -> StackOneTool:
@@ -210,7 +210,7 @@ def create_meta_execute_tool(tools_collection: Tools) -> StackOneTool:
     name = "meta_execute_tool"
     description = (
         "Executes a tool by name with the provided parameters. "
-        "Use this after discovering tools with meta_filter_relevant_tools."
+        "Use this after discovering tools with meta_search_tools."
     )
 
     parameters = ToolParameters(

stackone_ai/models.py

@@ -486,22 +486,22 @@ def meta_tools(self) -> "Tools":
         Meta tools enable dynamic tool discovery and execution based on natural language queries.
 
         Returns:
-            Tools collection containing meta_filter_relevant_tools and meta_execute_tool
+            Tools collection containing meta_search_tools and meta_execute_tool
 
         Note:
             This feature is in beta and may change in future versions
         """
         from stackone_ai.meta_tools import (
             ToolIndex,
             create_meta_execute_tool,
-            create_meta_filter_tool,
+            create_meta_search_tools,
         )
 
         # Create search index
         index = ToolIndex(self.tools)
 
         # Create meta tools
-        filter_tool = create_meta_filter_tool(index)
+        filter_tool = create_meta_search_tools(index)
         execute_tool = create_meta_execute_tool(self)
 
         return Tools([filter_tool, execute_tool])

stackone_ai/toolset.py

@@ -42,7 +42,7 @@ def __init__(
 
         Args:
             api_key: Optional API key. If not provided, will try to get from STACKONE_API_KEY env var
-            account_id: Optional account ID. If not provided, will try to get from STACKONE_ACCOUNT_ID env var
+            account_id: Optional account ID
             base_url: Optional base URL override for API requests. If not provided, uses the URL from the OAS
 
         Raises:
@@ -55,7 +55,7 @@ def __init__(
                 "STACKONE_API_KEY environment variable"
             )
         self.api_key: str = api_key_value
-        self.account_id = account_id or os.getenv("STACKONE_ACCOUNT_ID")
+        self.account_id = account_id
         self.base_url = base_url
 
     def _parse_parameters(self, parameters: list[dict[str, Any]]) -> dict[str, dict[str, str]]:

tests/test_meta_tools.py

@@ -4,7 +4,11 @@
 import responses
 
 from stackone_ai import StackOneTool, Tools
-from stackone_ai.meta_tools import ToolIndex, create_meta_execute_tool, create_meta_filter_tool
+from stackone_ai.meta_tools import (
+    ToolIndex,
+    create_meta_execute_tool,
+    create_meta_search_tools,
+)
 from stackone_ai.models import ExecuteConfig, ToolParameters
 
 
@@ -128,21 +132,21 @@ def test_search_limit(self, sample_tools):
         assert len(results) <= 3
 
 
-class TestMetaFilterTool:
-    """Test the meta_filter_relevant_tools functionality"""
+class TestMetaSearchTool:
+    """Test the meta_search_tools functionality"""
 
     def test_filter_tool_creation(self, sample_tools):
         """Test creating the filter tool"""
         index = ToolIndex(sample_tools)
-        filter_tool = create_meta_filter_tool(index)
+        filter_tool = create_meta_search_tools(index)
 
-        assert filter_tool.name == "meta_filter_relevant_tools"
+        assert filter_tool.name == "meta_search_tools"
         assert "natural language query" in filter_tool.description.lower()
 
     def test_filter_tool_execute(self, sample_tools):
         """Test executing the filter tool"""
         index = ToolIndex(sample_tools)
-        filter_tool = create_meta_filter_tool(index)
+        filter_tool = create_meta_search_tools(index)
 
         # Execute with a query
         result = filter_tool.execute(
@@ -167,7 +171,7 @@ def test_filter_tool_execute(self, sample_tools):
     def test_filter_tool_call(self, sample_tools):
         """Test calling the filter tool with call method"""
         index = ToolIndex(sample_tools)
-        filter_tool = create_meta_filter_tool(index)
+        filter_tool = create_meta_search_tools(index)
 
         # Call with kwargs
         result = filter_tool.call(query="candidate", limit=2)
@@ -237,15 +241,15 @@ def test_meta_tools_creation(self, tools_collection):
 
         # Check tool names
         tool_names = [tool.name for tool in meta_tools.tools]
-        assert "meta_filter_relevant_tools" in tool_names
+        assert "meta_search_tools" in tool_names
         assert "meta_execute_tool" in tool_names
 
     def test_meta_tools_functionality(self, tools_collection):
         """Test that meta tools work correctly"""
         meta_tools = tools_collection.meta_tools()
 
         # Get the filter tool
-        filter_tool = meta_tools.get_tool("meta_filter_relevant_tools")
+        filter_tool = meta_tools.get_tool("meta_search_tools")
         assert filter_tool is not None
 
         # Search for tools