chore: merge main into refactor/migrate-requests-to-httpx

Resolved conflicts in:
- pyproject.toml: Added new ty dependency from main
- tests/test_meta_tools.py: Updated test URLs to use hibob while keeping httpx/respx approach
- uv.lock: Regenerated to incorporate changes from both branches

All tests passing after merge.

Author: ryoppippi

.claude/rules/development-workflow.md

@@ -18,15 +18,15 @@ This rule provides code style guidelines and project conventions for the StackOn
 
 - Full type annotations required for all public APIs
 - Use Python 3.11+ typing features
-- Run `just mypy` to verify type correctness
-- Strict mypy configuration is enforced
+- Run `just ty` to verify type correctness
+- Strict ty configuration is enforced
 
 ## Pre-commit Hooks
 
 Pre-commit hooks are configured for:
 
 - ruff linting
-- mypy type checking
+- ty type checking
 
 Run `just install` to set up hooks.
 
@@ -36,7 +36,7 @@ Run `just install` to set up hooks.
 just install       # Install dependencies and pre-commit hooks
 just lint          # Run ruff linting
 just lint-fix      # Auto-fix linting issues
-just mypy          # Run type checking
+just ty            # Run type checking
 just test          # Run all tests
 just test-tools    # Run tool-specific tests
 just test-examples # Run example tests

.github/workflows/ci.yaml

@@ -12,8 +12,24 @@ concurrency:
 
 permissions:
   contents: read
+  pages: write
+  id-token: write
 
 jobs:
+  gitleaks:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        with:
+          fetch-depth: 0
+
+      - name: Setup Nix
+        uses: ./.github/actions/setup-nix
+
+      - name: Run Gitleaks
+        run: nix develop --command just gitleaks
+
   typos:
     runs-on: ubuntu-latest
     steps:
@@ -54,8 +70,51 @@ jobs:
       - name: Run Lint
         run: nix develop --command just lint
 
-      - name: Run Mypy
-        run: nix develop --command just mypy
+      - name: Run Ty
+        run: nix develop --command just ty
 
       - name: Run Tests
         run: nix develop --command just test
+
+  coverage:
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
+    env:
+      STACKONE_API_KEY: ${{ secrets.STACKONE_API_KEY }}
+      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+
+      - name: Setup Nix
+        uses: ./.github/actions/setup-nix
+
+      - name: Install dependencies
+        run: nix develop --command just install --all-extras
+
+      - name: Run Tests with Coverage
+        run: nix develop --command just coverage
+
+      - name: Create Coverage Badge
+        uses: jaywcjlove/coverage-badges-cli@bd6ccbf422c0ed54c01f283019fd2bc648f58541 # v2.2.0
+        with:
+          source: coverage/coverage.json
+          output: coverage/badges.svg
+          jsonPath: totals.percent_covered
+
+      - name: Upload coverage artifact
+        uses: actions/upload-pages-artifact@7b1f4a764d45c48632c6b24a0339c27f5614fb0b # v3.0.2
+        with:
+          path: coverage/
+
+  deploy-coverage:
+    needs: coverage
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # v4.0.5

.gitignore

@@ -5,6 +5,8 @@
 .pytest_cache
 .python-version
 __pycache__
+.coverage
+coverage/
 
 .DS_Store
 

.gitleaks.toml

@@ -0,0 +1,13 @@
+# Gitleaks configuration
+# https://github.com/gitleaks/gitleaks
+
+[extend]
+useDefault = true
+
+[allowlist]
+description = "Global allowlist"
+paths = [
+    '''\.lock$''',
+    '''\.snap$''',
+    '''uv\.lock$''',
+]

CLAUDE.md

@@ -33,7 +33,7 @@ just install           # Install dependencies and pre-commit hooks
 # Code quality
 just lint             # Run ruff linting
 just lint-fix         # Auto-fix linting issues
-just mypy             # Run type checking
+just ty               # Run type checking
 
 # Testing
 just test             # Run all tests
@@ -88,7 +88,7 @@ toolset = StackOneToolSet(
 ### Type Safety
 
 - Full type annotations required (Python 3.11+)
-- Strict mypy configuration
+- Strict ty configuration
 - Use generics for better IDE support
 
 ### Testing
@@ -100,7 +100,7 @@ toolset = StackOneToolSet(
 ## Important Considerations
 
 1. **Dependencies**: See `package-installation` rule for uv dependency management
-2. **Pre-commit**: Hooks configured for ruff and mypy - run on all commits
+2. **Pre-commit**: Hooks configured for ruff and ty - run on all commits
 3. **Python Version**: Requires Python >=3.11
 4. **Error Handling**: Custom exceptions (`StackOneError`, `StackOneAPIError`)
 5. **File Uploads**: Binary parameters auto-detected from OpenAPI specs

README.md

@@ -2,6 +2,7 @@
 
 [![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)
+[![Coverage](https://stackonehq.github.io/stackone-ai-python/badges.svg)](https://stackonehq.github.io/stackone-ai-python/html/)
 
 StackOne AI provides a unified interface for accessing various SaaS tools through AI-friendly APIs.
 
@@ -47,7 +48,7 @@ The Nix development environment includes:
 
 - Python with uv package manager
 - Automatic dependency installation
-- Git hooks (treefmt + mypy) auto-configured
+- Git hooks (treefmt + ty) auto-configured
 - Consistent environment across all platforms
 
 ### Using pip/uv

examples/crewai_integration.py

@@ -18,7 +18,7 @@
 
 def crewai_integration():
     toolset = StackOneToolSet()
-    tools = toolset.fetch_tools(actions=["hris_*"], 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 `hris_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 `hris_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=["hris_*"], account_ids=[account_id])
+        tools = toolset.fetch_tools(actions=["bamboohr_*"], account_ids=[account_id])
 
-        upload_tool = tools.get_tool("hris_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

@@ -1,5 +1,5 @@
 """
-StackOne AI SDK provides an AI-friendly interface for accessing various SaaS tools through the StackOne Unified API.
+StackOne AI SDK provides an AI-friendly interface for accessing various SaaS tools through the StackOne API.
 
 This SDK is available on [PyPI](https://pypi.org/project/stackone-ai/) for python projects. There is a node version in the works.
 
@@ -72,11 +72,11 @@
 def quickstart():
     toolset = StackOneToolSet()
 
-    # Get all HRIS-related tools using MCP-backed fetch_tools()
-    tools = toolset.fetch_tools(actions=["hris_*"], 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("hris_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=["hris_*"], 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()