fix(examples): use BambooHR tools instead of HiBob

Address PR review feedback requesting actual existing Falcon connector
tools. Migrate all examples from hibob_* to bamboohr_* tools which are
confirmed to exist in production Falcon connectors.

Changes include:
- file_uploads.py: bamboohr_upload_employee_document
- index.py: bamboohr_list_employees
- openai_integration.py: bamboohr_get_employee, bamboohr_*_employments
- All other examples: bamboohr_* action filters

This ensures examples demonstrate tools that actually exist in the
StackOne platform.

Author: ryoppippi

examples/crewai_integration.py

@@ -18,7 +18,7 @@
 
 def crewai_integration():
     toolset = StackOneToolSet()
-    tools = toolset.fetch_tools(actions=["hibob_*"], account_ids=[account_id])
+    tools = toolset.fetch_tools(actions=["bamboohr_*"], account_ids=[account_id])
 
     # CrewAI uses LangChain tools natively
     langchain_tools = tools.to_langchain()

examples/file_uploads.py

@@ -1,6 +1,6 @@
 """
 Example demonstrating file upload functionality using StackOne.
-Shows how to upload an employee document using an HRIS integration.
+Shows how to upload an employee document using a BambooHR integration.
 
 This example is runnable with the following command:
 ```bash
@@ -24,7 +24,7 @@
 """
 # Resume content
 
-This is a sample resume content that will be uploaded using the `hibob_upload_employee_document` tool.
+This is a sample resume content that will be uploaded using the `bamboohr_upload_employee_document` tool.
 """
 
 resume_content = """
@@ -46,7 +46,7 @@
 """
 # Upload employee document
 
-This function uploads a resume using the `hibob_upload_employee_document` tool.
+This function uploads a resume using the `bamboohr_upload_employee_document` tool.
 
 """
 
@@ -57,9 +57,9 @@ def upload_employee_document() -> None:
         resume_file.write_text(resume_content)
 
         toolset = StackOneToolSet()
-        tools = toolset.fetch_tools(actions=["hibob_*"], account_ids=[account_id])
+        tools = toolset.fetch_tools(actions=["bamboohr_*"], account_ids=[account_id])
 
-        upload_tool = tools.get_tool("hibob_upload_employee_document")
+        upload_tool = tools.get_tool("bamboohr_upload_employee_document")
         assert upload_tool is not None
 
         with open(resume_file, "rb") as f:

examples/index.py

@@ -72,11 +72,11 @@
 def quickstart():
     toolset = StackOneToolSet()
 
-    # Get all HiBob-related tools using MCP-backed fetch_tools()
-    tools = toolset.fetch_tools(actions=["hibob_*"], account_ids=[account_id])
+    # Get all BambooHR-related tools using MCP-backed fetch_tools()
+    tools = toolset.fetch_tools(actions=["bamboohr_*"], account_ids=[account_id])
 
     # Use a specific tool
-    employee_tool = tools.get_tool("hibob_list_employees")
+    employee_tool = tools.get_tool("bamboohr_list_employees")
     assert employee_tool is not None
 
     employees = employee_tool.execute()

examples/langchain_integration.py

@@ -19,7 +19,7 @@
 
 def langchain_integration() -> None:
     toolset = StackOneToolSet()
-    tools = toolset.fetch_tools(actions=["hibob_*"], account_ids=[account_id])
+    tools = toolset.fetch_tools(actions=["bamboohr_*"], account_ids=[account_id])
 
     # Convert to LangChain format and verify
     langchain_tools = tools.to_langchain()

examples/meta_tools_example.py

@@ -24,8 +24,8 @@ def example_meta_tools_basic():
     toolset = StackOneToolSet()
 
     # Get all available tools using MCP-backed fetch_tools()
-    all_tools = toolset.fetch_tools(actions=["hibob_*"])
-    print(f"Total HiBob tools available: {len(all_tools)}")
+    all_tools = toolset.fetch_tools(actions=["bamboohr_*"])
+    print(f"Total BambooHR tools available: {len(all_tools)}")
 
     # Get meta tools for dynamic discovery
     meta_tools = all_tools.meta_tools()
@@ -93,9 +93,9 @@ def example_with_openai():
         # Initialize StackOne toolset
         toolset = StackOneToolSet()
 
-        # Get HiBob tools and their meta tools using MCP-backed fetch_tools()
-        hibob_tools = toolset.fetch_tools(actions=["hibob_*"])
-        meta_tools = hibob_tools.meta_tools()
+        # Get BambooHR tools and their meta tools using MCP-backed fetch_tools()
+        bamboohr_tools = toolset.fetch_tools(actions=["bamboohr_*"])
+        meta_tools = bamboohr_tools.meta_tools()
 
         # Convert to OpenAI format
         openai_tools = meta_tools.to_openai()
@@ -142,7 +142,7 @@ def example_with_langchain():
         toolset = StackOneToolSet()
 
         # Get tools and convert to LangChain format using MCP-backed fetch_tools()
-        tools = toolset.fetch_tools(actions=["hibob_list_*"])
+        tools = toolset.fetch_tools(actions=["bamboohr_list_*"])
         langchain_tools = tools.to_langchain()
 
         # Get meta tools as well

examples/openai_integration.py

@@ -36,9 +36,9 @@ def openai_integration() -> None:
     # Filter tools to only the ones we need to avoid context window limits
     tools = toolset.fetch_tools(
         actions=[
-            "hibob_get_employee",
-            "hibob_list_employee_employments",
-            "hibob_get_employee_employment",
+            "bamboohr_get_employee",
+            "bamboohr_list_employee_employments",
+            "bamboohr_get_employee_employment",
         ],
         account_ids=[account_id],
     )

examples/stackone_account_ids.py

@@ -19,14 +19,14 @@ def stackone_account_ids():
     """
     Set the account ID whilst getting tools using fetch_tools().
     """
-    tools = toolset.fetch_tools(actions=["hibob_*"], account_ids=["test_id"])
+    tools = toolset.fetch_tools(actions=["bamboohr_*"], account_ids=["test_id"])
 
     """
     You can override the account ID on fetched tools.
     """
     tools.set_account_id("a_different_id")
 
-    employee_tool = tools.get_tool("hibob_get_employee")
+    employee_tool = tools.get_tool("bamboohr_get_employee")
     assert employee_tool is not None
 
     """

stackone_ai/integrations/langgraph.py

@@ -7,7 +7,7 @@
     from stackone_ai.integrations.langgraph import to_tool_node
 
     toolset = StackOneToolSet()
-    tools = toolset.fetch_tools(actions=["hibob_*"], account_ids=["..."])
+    tools = toolset.fetch_tools(actions=["bamboohr_*"], account_ids=["..."])
     node = to_tool_node(tools)  # langgraph.prebuilt.ToolNode
 """