docs: add comprehensive LangChain integration section to README (#20)

* docs: add comprehensive LangChain integration section to README

- Add detailed LangChain integration examples showing tool conversion and usage

- Include CrewAI integration section demonstrating LangChain compatibility

- Provide practical code examples for model binding and tool execution

- Position section after Meta Tools for logical flow

* docs: move Features section above examples for better structure

- Relocated Features section to appear after Quick Start but before detailed examples

- Improves README flow by highlighting key features early

- Maintains logical progression from installation -> features -> examples

* docs: restructure README sections and fix documentation links

- Move Features section immediately after project overview

- Restructure LangChain and CrewAI integrations into collapsible Integration Examples section

- Reorder Meta Tools section to appear after Integration Examples

- Replace broken docs/ links with working examples/ directory links

- Consolidate documentation sections into single Examples section

* docs: add PyPI and GitHub release badges to README

- Add PyPI version badge linking to package page

- Add GitHub release badge showing latest version

- Improve README visual appeal and provide quick access to version info

---------

Co-authored-by: Guillaume <[email protected]>

Author: ryoppippi

README.md

@@ -1,7 +1,23 @@
 # StackOne AI SDK
 
+[![PyPI version](https://badge.fury.io/py/stackone-ai.svg)](https://badge.fury.io/py/stackone-ai)
+[![GitHub release (latest by date)](https://img.shields.io/github/v/release/StackOneHQ/stackone-ai-python)](https://github.com/StackOneHQ/stackone-ai-python/releases)
+
 StackOne AI provides a unified interface for accessing various SaaS tools through AI-friendly APIs.
 
+## Features
+
+- Unified interface for multiple SaaS tools
+- AI-friendly tool descriptions and parameters
+- **Tool Calling**: Direct method calling with `tool.call()` for intuitive usage
+- **Glob Pattern Filtering**: Advanced tool filtering with patterns like `"hris_*"` and exclusions `"!hris_delete_*"`
+- **Meta Tools** (Beta): Dynamic tool discovery and execution based on natural language queries
+- Integration with popular AI frameworks:
+  - OpenAI Functions
+  - LangChain Tools
+  - CrewAI Tools
+  - LangGraph Tool Node
+
 ## Installation
 
 ```bash
@@ -30,6 +46,77 @@ employee = employee_tool.call(id="employee-id")
 employee = employee_tool.execute({"id": "employee-id"})
 ```
 
+## Integration Examples
+
+<details>
+<summary>LangChain Integration</summary>
+
+StackOne tools work seamlessly with LangChain, enabling powerful AI agent workflows:
+
+```python
+from langchain_openai import ChatOpenAI
+from stackone_ai import StackOneToolSet
+
+# Initialize StackOne tools
+toolset = StackOneToolSet()
+tools = toolset.get_tools("hris_*", account_id="your-account-id")
+
+# Convert to LangChain format
+langchain_tools = tools.to_langchain()
+
+# Use with LangChain models
+model = ChatOpenAI(model="gpt-4o-mini")
+model_with_tools = model.bind_tools(langchain_tools)
+
+# Execute AI-driven tool calls
+response = model_with_tools.invoke("Get employee information for ID: emp123")
+
+# Handle tool calls
+for tool_call in response.tool_calls:
+    tool = tools.get_tool(tool_call["name"])
+    if tool:
+        result = tool.execute(tool_call["args"])
+        print(f"Result: {result}")
+```
+
+</details>
+
+<details>
+<summary>CrewAI Integration</summary>
+
+CrewAI uses LangChain tools natively, making integration seamless:
+
+```python
+from crewai import Agent, Crew, Task
+from stackone_ai import StackOneToolSet
+
+# Get tools and convert to LangChain format
+toolset = StackOneToolSet()
+tools = toolset.get_tools("hris_*", account_id="your-account-id")
+langchain_tools = tools.to_langchain()
+
+# Create CrewAI agent with StackOne tools
+agent = Agent(
+    role="HR Manager",
+    goal="Analyze employee data and generate insights",
+    backstory="Expert in HR analytics and employee management",
+    tools=langchain_tools,
+    llm="gpt-4o-mini"
+)
+
+# Define task and execute
+task = Task(
+    description="Find all employees in the engineering department",
+    agent=agent,
+    expected_output="List of engineering employees with their details"
+)
+
+crew = Crew(agents=[agent], tasks=[task])
+result = crew.kickoff()
+```
+
+</details>
+
 ## Meta Tools (Beta)
 
 Meta tools enable dynamic tool discovery and execution without hardcoding tool names:
@@ -48,34 +135,19 @@ execute_tool = meta_tools.get_tool("meta_execute_tool")
 result = execute_tool.call(toolName="hris_list_employees", params={"limit": 10})
 ```
 
-## Features
-
-- Unified interface for multiple SaaS tools
-- AI-friendly tool descriptions and parameters
-- **Tool Calling**: Direct method calling with `tool.call()` for intuitive usage
-- **Glob Pattern Filtering**: Advanced tool filtering with patterns like `"hris_*"` and exclusions `"!hris_delete_*"`
-- **Meta Tools** (Beta): Dynamic tool discovery and execution based on natural language queries
-- Integration with popular AI frameworks:
-  - OpenAI Functions
-  - LangChain Tools
-  - CrewAI Tools
-  - LangGraph Tool Node
-
-## Documentation
-
-For more examples and documentation, visit:
-
-- [Error Handling](docs/error-handling.md)
-- [StackOne Account IDs](docs/stackone-account-ids.md)
-- [Available Tools](docs/available-tools.md)
-- [File Uploads](docs/file-uploads.md)
+## Examples
 
-## AI Framework Integration
+For more examples, check out the [examples/](examples/) directory:
 
-- [OpenAI Integration](docs/openai-integration.md)
-- [LangChain Integration](docs/langchain-integration.md)
-- [CrewAI Integration](docs/crewai-integration.md)
-- [LangGraph Tool Node](docs/langgraph-tool-node.md)
+- [Error Handling](examples/error_handling.py)
+- [StackOne Account IDs](examples/stackone_account_ids.py)
+- [Available Tools](examples/available_tools.py)
+- [File Uploads](examples/file_uploads.py)
+- [OpenAI Integration](examples/openai_integration.py)
+- [LangChain Integration](examples/langchain_integration.py)
+- [CrewAI Integration](examples/crewai_integration.py)
+- [LangGraph Tool Node](examples/langgraph_tool_node.py)
+- [Meta Tools](examples/meta_tools_example.py)
 
 ## License