blaxel 0.2.29__tar.gz → 0.2.31__tar.gz

blaxel-0.2.31/Makefile

@@ -0,0 +1,102 @@
+ARGS:= $(wordlist 2,$(words $(MAKECMDGOALS)),$(MAKECMDGOALS))
+
+# Get git commit hash automatically
+GIT_COMMIT := $(shell git rev-parse HEAD 2>/dev/null || echo "unknown")
+GIT_COMMIT_SHORT := $(shell git rev-parse --short HEAD 2>/dev/null || echo "unknown")
+
+install:
+	uv sync --all-groups --all-packages --all-extras
+
+install-groups:
+	uv sync --refresh --force-reinstall --extra telemetry --extra langgraph
+
+sdk-sandbox:
+	@echo "Downloading sandbox definition from blaxel-ai/sandbox"
+	@curl -H "Authorization: token $$(gh auth token)" \
+		-H "Accept: application/vnd.github.v3.raw" \
+		-o ./definition.yml \
+		https://api.github.com/repos/blaxel-ai/sandbox/contents/sandbox-api/docs/openapi.yml?ref=main
+	rm -rf src/blaxel/core/sandbox/client/api src/blaxel/core/sandbox/client/models
+	.venv/bin/openapi-python-client generate \
+		--path=definition.yml \
+		--output-path=./tmp-sdk-sandbox \
+		--overwrite \
+		--custom-template-path=./templates \
+		--config=./openapi-python-client.yml
+	cp -r ./tmp-sdk-sandbox/blaxel/* ./src/blaxel/core/sandbox/client
+	rm -rf ./tmp-sdk-sandbox
+	uv run ruff format
+	uv run ruff check --fix
+
+sdk-controlplane:
+	@echo "Downloading controlplane definition from blaxel-ai/controlplane"
+	@curl -H "Authorization: token $$(gh auth token)" \
+		-H "Accept: application/vnd.github.v3.raw" \
+		-o ./definition.yml \
+		https://api.github.com/repos/blaxel-ai/controlplane/contents/api/api/definitions/controlplane.yml?ref=main
+	rm -rf src/blaxel/core/client/api src/blaxel/core/client/models
+	.venv/bin/openapi-python-client generate \
+		--path=definition.yml \
+		--output-path=./tmp-sdk-python \
+		--overwrite \
+		--custom-template-path=./templates \
+		--config=./openapi-python-client.yml
+	cp -r ./tmp-sdk-python/blaxel/* ./src/blaxel/core/client
+	rm -rf ./tmp-sdk-python
+	uv run ruff format
+	uv run ruff check --fix
+
+sdk: sdk-sandbox sdk-controlplane
+
+# Build with commit hash injection
+build:
+	@echo "🔨 Building Python SDK with commit: $(GIT_COMMIT_SHORT)"
+	@echo "💉 Injecting commit hash into pyproject.toml"
+	@if [ -f pyproject.toml ]; then \
+		if grep -q "^\[tool\.blaxel\]" pyproject.toml; then \
+			sed -i.bak 's/^commit = .*/commit = "$(GIT_COMMIT)"/' pyproject.toml && rm pyproject.toml.bak; \
+		else \
+			echo "" >> pyproject.toml; \
+			echo "[tool.blaxel]" >> pyproject.toml; \
+			echo 'commit = "$(GIT_COMMIT)"' >> pyproject.toml; \
+		fi; \
+	fi
+	@echo "✅ Build completed with commit: $(GIT_COMMIT_SHORT)"
+
+# Clean build artifacts and reset pyproject.toml
+clean:
+	@echo "🧹 Cleaning build artifacts"
+	@git checkout pyproject.toml 2>/dev/null || true
+	@rm -rf dist/ build/ *.egg-info/
+	@echo "✅ Clean completed"
+
+doc:
+	rm -rf docs
+	uv run pdoc blaxel src/* -o docs --force --skip-errors
+
+lint:
+	uv run ruff check --fix
+
+tag:
+	git checkout main
+	git pull origin main
+	git tag -a v$(ARGS) -m "Release v$(ARGS)"
+	git push origin v$(ARGS)
+
+test:
+	uv sync --group test
+	uv run pytest tests/ -v --ignore=tests/integration/
+
+test-with-telemetry:
+	uv sync --group test --extra telemetry
+	pip install -e .
+	uv run pytest tests/ -v
+
+install-dev:
+	uv sync --group test
+	pip install -e .
+
+%:
+	@:
+
+.PHONY: sdk

blaxel-0.2.31/PKG-INFO

@@ -0,0 +1,229 @@
+Metadata-Version: 2.4
+Name: blaxel
+Version: 0.2.31
+Summary: Blaxel - AI development platform SDK
+Project-URL: Homepage, https://blaxel.ai
+Project-URL: Documentation, https://docs.blaxel.ai
+Project-URL: Repository, https://github.com/blaxel-ai/sdk-python
+Project-URL: Changelog, https://docs.blaxel.ai/changelog
+Author-email: cploujoux <cploujoux@blaxel.ai>
+License-File: LICENSE
+Requires-Python: <3.14,>=3.10
+Requires-Dist: attrs>=21.3.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp>=1.9.4
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyjwt>=2.0.0
+Requires-Dist: python-dateutil>=2.8.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: requests>=2.32.3
+Requires-Dist: sentry-sdk>=2.46.0
+Requires-Dist: tomli>=2.2.1
+Requires-Dist: websockets<16.0.0
+Provides-Extra: all
+Requires-Dist: crewai==0.159.0; extra == 'all'
+Requires-Dist: google-adk>=1.4.0; extra == 'all'
+Requires-Dist: langchain-anthropic>=0.3.10; extra == 'all'
+Requires-Dist: langchain-cerebras>=0.5.0; extra == 'all'
+Requires-Dist: langchain-cohere>=0.4.3; extra == 'all'
+Requires-Dist: langchain-community<0.4.0,>=0.3.3; extra == 'all'
+Requires-Dist: langchain-core<0.4.0,>=0.3.13; extra == 'all'
+Requires-Dist: langchain-deepseek-official>=0.1.0.post1; extra == 'all'
+Requires-Dist: langchain-openai>=0.3.10; extra == 'all'
+Requires-Dist: langchain-xai>=0.2.2; extra == 'all'
+Requires-Dist: langgraph<0.3.0,>=0.2.40; extra == 'all'
+Requires-Dist: litellm==1.74.9; extra == 'all'
+Requires-Dist: litellm>=1.63.11; extra == 'all'
+Requires-Dist: livekit-agents[anthropic,cartesia,deepgram,elevenlabs,groq,openai,silero,turn-detector]~=1.0; extra == 'all'
+Requires-Dist: livekit-plugins-noise-cancellation~=0.2; extra == 'all'
+Requires-Dist: llama-index-llms-anthropic>=0.6.14; extra == 'all'
+Requires-Dist: llama-index-llms-cerebras>=0.2.2; extra == 'all'
+Requires-Dist: llama-index-llms-cohere>=0.4.1; extra == 'all'
+Requires-Dist: llama-index-llms-deepseek>=0.1.1; extra == 'all'
+Requires-Dist: llama-index-llms-google-genai>=0.1.13; extra == 'all'
+Requires-Dist: llama-index-llms-groq>=0.3.1; extra == 'all'
+Requires-Dist: llama-index-llms-mistralai>=0.4.0; extra == 'all'
+Requires-Dist: llama-index-llms-openai>=0.3.42; extra == 'all'
+Requires-Dist: llama-index>=0.12.46; extra == 'all'
+Requires-Dist: openai-agents>=0.0.19; extra == 'all'
+Requires-Dist: openai==1.99.9; extra == 'all'
+Requires-Dist: opentelemetry-exporter-otlp>=1.28.0; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-anthropic==0.41.0; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-cohere==0.41.0; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-crewai==0.41.0; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-fastapi==0.56b0; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-google-generativeai==0.41.0; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-langchain>=0.35.0; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-llamaindex>=0.40.7; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-ollama==0.41.0; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-openai==0.41.0; extra == 'all'
+Requires-Dist: pillow>=10.0.0; extra == 'all'
+Requires-Dist: pydantic-ai>=0.0.48; extra == 'all'
+Provides-Extra: core
+Provides-Extra: crewai
+Requires-Dist: crewai==0.159.0; extra == 'crewai'
+Requires-Dist: litellm==1.74.9; extra == 'crewai'
+Requires-Dist: openai==1.99.9; extra == 'crewai'
+Requires-Dist: opentelemetry-instrumentation-crewai==0.41.0; extra == 'crewai'
+Provides-Extra: dev
+Requires-Dist: pyright; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: uv; extra == 'dev'
+Provides-Extra: googleadk
+Requires-Dist: google-adk>=1.4.0; extra == 'googleadk'
+Requires-Dist: litellm>=1.63.11; extra == 'googleadk'
+Provides-Extra: langgraph
+Requires-Dist: langchain-anthropic>=0.3.10; extra == 'langgraph'
+Requires-Dist: langchain-cerebras>=0.5.0; extra == 'langgraph'
+Requires-Dist: langchain-cohere>=0.4.3; extra == 'langgraph'
+Requires-Dist: langchain-community<0.4.0,>=0.3.3; extra == 'langgraph'
+Requires-Dist: langchain-core<0.4.0,>=0.3.13; extra == 'langgraph'
+Requires-Dist: langchain-deepseek-official>=0.1.0.post1; extra == 'langgraph'
+Requires-Dist: langchain-openai>=0.3.10; extra == 'langgraph'
+Requires-Dist: langchain-xai>=0.2.2; extra == 'langgraph'
+Requires-Dist: langgraph<0.3.0,>=0.2.40; extra == 'langgraph'
+Requires-Dist: opentelemetry-instrumentation-langchain>=0.35.0; extra == 'langgraph'
+Requires-Dist: pillow>=10.0.0; extra == 'langgraph'
+Provides-Extra: livekit
+Requires-Dist: livekit-agents[anthropic,cartesia,deepgram,elevenlabs,groq,openai,silero,turn-detector]~=1.0; extra == 'livekit'
+Requires-Dist: livekit-plugins-noise-cancellation~=0.2; extra == 'livekit'
+Provides-Extra: llamaindex
+Requires-Dist: llama-index-llms-anthropic>=0.6.14; extra == 'llamaindex'
+Requires-Dist: llama-index-llms-cerebras>=0.2.2; extra == 'llamaindex'
+Requires-Dist: llama-index-llms-cohere>=0.4.1; extra == 'llamaindex'
+Requires-Dist: llama-index-llms-deepseek>=0.1.1; extra == 'llamaindex'
+Requires-Dist: llama-index-llms-google-genai>=0.1.13; extra == 'llamaindex'
+Requires-Dist: llama-index-llms-groq>=0.3.1; extra == 'llamaindex'
+Requires-Dist: llama-index-llms-mistralai>=0.4.0; extra == 'llamaindex'
+Requires-Dist: llama-index-llms-openai>=0.3.42; extra == 'llamaindex'
+Requires-Dist: llama-index>=0.12.46; extra == 'llamaindex'
+Requires-Dist: opentelemetry-instrumentation-llamaindex>=0.40.7; extra == 'llamaindex'
+Provides-Extra: openai
+Requires-Dist: openai-agents>=0.0.19; extra == 'openai'
+Provides-Extra: pydantic
+Requires-Dist: pydantic-ai>=0.0.48; extra == 'pydantic'
+Provides-Extra: telemetry
+Requires-Dist: opentelemetry-exporter-otlp>=1.28.0; extra == 'telemetry'
+Requires-Dist: opentelemetry-instrumentation-anthropic==0.41.0; extra == 'telemetry'
+Requires-Dist: opentelemetry-instrumentation-cohere==0.41.0; extra == 'telemetry'
+Requires-Dist: opentelemetry-instrumentation-fastapi==0.56b0; extra == 'telemetry'
+Requires-Dist: opentelemetry-instrumentation-google-generativeai==0.41.0; extra == 'telemetry'
+Requires-Dist: opentelemetry-instrumentation-ollama==0.41.0; extra == 'telemetry'
+Requires-Dist: opentelemetry-instrumentation-openai==0.41.0; extra == 'telemetry'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="https://blaxel.ai/logo.png" alt="Blaxel" width=500/>
+</p>
+
+# Python SDK
+
+**Blaxel is a computing platform for AI agent builders, with all the services and infrastructure to build and deploy agents efficiently.** This repository contains the Python SDK to create and manage resources on Blaxel.
+
+## Table of Contents
+
+- [Installation](#installation)
+  - [Authentication](#authentication)
+- [Features](#features)
+- [Quickstart](#quickstart)
+- [Contributing](#contributing)
+- [License](#license)
+
+
+
+## Installation
+
+Install Blaxel SDK which lets you manage Blaxel resources.
+
+```bash
+# Base package (core functionality)
+pip install blaxel
+
+# With specific modules
+pip install "blaxel[telemetry]"
+pip install "blaxel[core,telemetry,crewai]"
+
+# Everything
+pip install "blaxel[all]"
+```
+
+### Available modules
+
+- `blaxel.core` - Core functionality (always available)
+- `blaxel.telemetry` - Telemetry and monitoring
+- `blaxel.crewai` - CrewAI integration
+- `blaxel.openai` - OpenAI integration
+- `blaxel.langgraph` - LangGraph integration
+- `blaxel.livekit` - LiveKit integration
+- `blaxel.llamaindex` - LlamaIndex integration
+- `blaxel.pydantic` - Pydantic AI integration
+- `blaxel.googleadk` - Google ADK integration
+
+
+
+### Authentication
+
+The Blaxel SDK authenticates with your workspace using credentials from these sources, in priority order:
+1. When running on Blaxel, authentication is handled automatically
+2. Variables in your .env file (`BL_WORKSPACE` and `BL_API_KEY`, or see [this page](https://docs.blaxel.ai/Agents/Variables-and-secrets) for other authentication options).
+3. Environment variables from your machine
+4. Configuration file created locally when you log in through Blaxel CLI (or deploy on Blaxel)
+
+When developing locally, the recommended method is to just log in to your workspace with Blaxel CLI. This allows you to run Blaxel SDK functions that will automatically connect to your workspace without additional setup. When you deploy on Blaxel, this connection persists automatically.
+
+When running Blaxel SDK from a remote server that is not Blaxel-hosted, we recommend using environment variables as described in the third option above.
+
+
+
+## Features
+- Agents & MCP servers
+  - [Create MCP servers](https://docs.blaxel.ai/Functions/Create-MCP-server)
+  - [Connect to MCP servers and model APIs hosted on Blaxel](https://docs.blaxel.ai/Agents/Develop-an-agent-ts)
+  - [Call agents from another agent](https://docs.blaxel.ai/Agents/Develop-an-agent-ts#connect-to-another-agent-multi-agent-chaining)
+  - [Deploy on Blaxel](https://docs.blaxel.ai/Agents/Deploy-an-agent)
+- Sandboxes
+  - [Create and update sandboxes and sandbox previews](https://docs.blaxel.ai/Sandboxes/Overview)
+  - [Run filesystem operations and processes on a sandbox](https://docs.blaxel.ai/Sandboxes/Processes)
+- [Use environment variables or secrets](https://docs.blaxel.ai/Agents/Variables-and-secrets)
+
+
+
+## Quickstart
+
+Blaxel CLI gives you a quick way to create new applications: agents, MCP servers, jobs, etc - and deploy them to Blaxel.
+
+**Prerequisites**:
+- **Node.js:** v18 or later.
+- **Blaxel CLI:** Make sure you have Blaxel CLI installed. If not, [install it](https://docs.blaxel.ai/cli-reference/introduction):
+  ```bash
+  curl -fsSL \
+  https://raw.githubusercontent.com/blaxel-ai/toolkit/main/install.sh \
+  | BINDIR=/usr/local/bin sudo -E sh
+  ```
+- **Blaxel login:** Login to Blaxel:
+  ```bash
+    bl login YOUR-WORKSPACE
+  ```
+
+```bash
+bl create-agent-app myfolder
+cd myfolder
+bl deploy
+```
+
+Also available:
+-  `bl create-mcp-server`
+-  `bl create-job`
+
+
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

blaxel-0.2.31/pyproject.toml

@@ -0,0 +1,151 @@
+[project]
+name = "blaxel"
+version = "0.2.31"
+description = "Blaxel - AI development platform SDK"
+readme = "README.md"
+authors = [{ name = "cploujoux", email = "cploujoux@blaxel.ai" }]
+requires-python = ">=3.10,<3.14"
+dependencies = [
+  # Core dependencies that are always needed
+  "pydantic>=2.0.0",
+  "pyjwt>=2.0.0",
+  "python-dateutil>=2.8.0",
+  "pyyaml>=6.0.0",
+  "requests>=2.32.3",
+  "tomli>=2.2.1",
+  "websockets<16.0.0",
+  "attrs>=21.3.0",
+  "httpx>=0.27.0",
+  "mcp>=1.9.4",
+  "sentry-sdk>=2.46.0",
+]
+
+[project.optional-dependencies]
+# Core functionality (always include blaxel.core dependencies)
+core = []
+
+# Telemetry module
+telemetry = [
+  "opentelemetry-exporter-otlp>=1.28.0",
+  "opentelemetry-instrumentation-anthropic==0.41.0",
+  "opentelemetry-instrumentation-cohere==0.41.0",
+  "opentelemetry-instrumentation-fastapi==0.56b0",
+  "opentelemetry-instrumentation-google-generativeai==0.41.0",
+  "opentelemetry-instrumentation-ollama==0.41.0",
+  "opentelemetry-instrumentation-openai==0.41.0",
+]
+
+# CrewAI module
+crewai = [
+  "crewai==0.159.0",
+  "litellm==1.74.9",
+  "openai==1.99.9",
+  "opentelemetry-instrumentation-crewai==0.41.0",
+]
+
+# OpenAI module
+openai = ["openai-agents>=0.0.19"]
+
+# LangGraph module
+langgraph = [
+  "langgraph>=0.2.40,<0.3.0",
+  "langchain-cohere>=0.4.3",
+  "langchain-community>=0.3.3,<0.4.0",
+  "langchain-core>=0.3.13,<0.4.0",
+  "langchain-deepseek-official>=0.1.0.post1",
+  "langchain-openai>=0.3.10",
+  "langchain-xai>=0.2.2",
+  "langchain-anthropic>=0.3.10",
+  "langchain-cerebras>=0.5.0",
+  "opentelemetry-instrumentation-langchain>=0.35.0",
+  "pillow>=10.0.0",
+]
+
+# LiveKit module
+livekit = [
+  "livekit-agents[openai,groq,anthropic,cartesia,deepgram,elevenlabs,silero,turn-detector]~=1.0",
+  "livekit-plugins-noise-cancellation~=0.2",
+]
+
+# LlamaIndex module
+llamaindex = [
+  "llama-index>=0.12.46",
+  "llama-index-llms-anthropic>=0.6.14",
+  "llama-index-llms-cerebras>=0.2.2",
+  "llama-index-llms-cohere>=0.4.1",
+  "llama-index-llms-deepseek>=0.1.1",
+  "llama-index-llms-google-genai>=0.1.13",
+  "llama-index-llms-groq>=0.3.1",
+  "llama-index-llms-mistralai>=0.4.0",
+  "llama-index-llms-openai>=0.3.42",
+  "opentelemetry-instrumentation-llamaindex>=0.40.7",
+]
+
+# Pydantic module
+pydantic = ["pydantic-ai>=0.0.48"]
+
+# Google ADK module
+googleadk = ["google-adk>=1.4.0", "litellm>=1.63.11"]
+
+# Convenience extras for common combinations
+all = [
+  "blaxel[core,telemetry,crewai,openai,langgraph,livekit,llamaindex,pydantic,googleadk]",
+]
+
+# Development dependencies
+dev = ["ruff", "pyright", "pytest", "uv"]
+
+[project.urls]
+Homepage = "https://blaxel.ai"
+Documentation = "https://docs.blaxel.ai"
+Repository = "https://github.com/blaxel-ai/sdk-python"
+Changelog = "https://docs.blaxel.ai/changelog"
+
+[tool.ruff]
+line-length = 100
+
+[tool.ruff.lint]
+select = ["F", "I", "UP"]
+ignore = ["UP006", "UP007", "UP035", "UP028"]
+
+[tool.pyright]
+# Add pyright configurations here if needed
+# reportMissingImports = true
+# pythonVersion = "3.9"
+
+[tool.pytest.ini_options]
+# Add pytest configurations here
+# minversion = "6.0"
+# addopts = "-ra -q"
+testpaths = ["tests"]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/blaxel"]
+
+[dependency-groups]
+dev = [
+  "nest-asyncio>=1.6.0",
+  "asgi-correlation-id>=4.3.4,<5.0.0",
+  "fastapi>=0.115.12",
+  "nest-asyncio>=1.6.0",
+  "pdoc3>=0.11.5",
+  "python-dotenv>=1.1.0",
+  "ruff>=0.8.2",
+  "openapi-python-client==0.25.3",
+]
+test = [
+  "pytest>=8.0.0",
+  "pytest-asyncio>=0.24.0",
+  "pytest-cov>=6.0.0",
+  "pytest-mock>=3.14.0",
+  "coverage>=7.0.0",
+  "aiohttp>=3.11.16",
+  "flask>=3.0.0",
+  "requests>=2.32.0",
+]

blaxel-0.2.31/src/blaxel/__init__.py

@@ -0,0 +1,12 @@
+"""Blaxel - AI development platform SDK."""
+
+from .core.common.autoload import autoload
+from .core.common.env import env
+from .core.common.settings import settings
+
+__version__ = "0.2.31"
+__commit__ = "43ad41354e2f27bae2471030eeaf702cf8e811ba"
+__sentry_dsn__ = "https://9711de13cd02b285ca4378c01de8dc30@o4508714045276160.ingest.us.sentry.io/4510461121462272"
+__all__ = ["autoload", "settings", "env"]
+
+autoload()

blaxel-0.2.31/src/blaxel/core/agents/__init__.py

@@ -0,0 +1,130 @@
+import json
+from logging import getLogger
+from typing import Any, Awaitable
+
+from ..cache import find_from_cache
+from ..client import client
+from ..client.api.agents import get_agent
+from ..client.models import Agent
+from ..common.internal import get_forced_url, get_global_unique_hash
+from ..common.settings import settings
+
+logger = getLogger(__name__)
+
+
+class BlAgent:
+    def __init__(self, name: str):
+        self.name = name
+
+    @property
+    def internal_url(self):
+        """Get the internal URL for the agent using a hash of workspace and agent name."""
+        hash = get_global_unique_hash(settings.workspace, "agent", self.name)
+        return f"{settings.run_internal_protocol}://bl-{settings.env}-{hash}.{settings.run_internal_hostname}"
+
+    @property
+    def forced_url(self):
+        """Get the forced URL from environment variables if set."""
+        return get_forced_url("agent", self.name)
+
+    @property
+    def external_url(self):
+        return f"{settings.run_url}/{settings.workspace}/agents/{self.name}"
+
+    @property
+    def fallback_url(self):
+        if self.external_url != self.url:
+            return self.external_url
+        return None
+
+    @property
+    def url(self):
+        if self.forced_url:
+            return self.forced_url
+        if settings.run_internal_hostname:
+            return self.internal_url
+        return self.external_url
+
+    def call(self, url, input_data, headers: dict = {}, params: dict = {}):
+        body = input_data
+        if not isinstance(body, str):
+            body = json.dumps(body)
+
+        # Merge settings headers with provided headers
+        merged_headers = {
+            **settings.headers,
+            "Content-Type": "application/json",
+            **headers,
+        }
+
+        return client.get_httpx_client().post(url, headers=merged_headers, data=body, params=params)
+
+    async def acall(self, url, input_data, headers: dict = {}, params: dict = {}):
+        logger.debug(f"Agent Calling: {self.name}")
+        body = input_data
+        if not isinstance(body, str):
+            body = json.dumps(body)
+
+        # Merge settings headers with provided headers
+        merged_headers = {
+            **settings.headers,
+            "Content-Type": "application/json",
+            **headers,
+        }
+
+        return await client.get_async_httpx_client().post(
+            url, headers=merged_headers, data=body, params=params
+        )
+
+    def run(self, input: Any, headers: dict = {}, params: dict = {}) -> str:
+        logger.debug(f"Agent Calling: {self.name}")
+        response = self.call(self.url, input, headers, params)
+        if response.status_code >= 400:
+            if not self.fallback_url:
+                raise Exception(
+                    f"Agent {self.name} returned status code {response.status_code} with body {response.text}"
+                )
+            response = self.call(self.fallback_url, input, headers, params)
+            if response.status_code >= 400:
+                raise Exception(
+                    f"Agent {self.name} returned status code {response.status_code} with body {response.text}"
+                )
+        return response.text
+
+    async def arun(self, input: Any, headers: dict = {}, params: dict = {}) -> Awaitable[str]:
+        logger.debug(f"Agent Calling: {self.name}")
+        response = await self.acall(self.url, input, headers, params)
+        if response.status_code >= 400:
+            if not self.fallback_url:
+                raise Exception(
+                    f"Agent {self.name} returned status code {response.status_code} with body {response.text}"
+                )
+            response = await self.acall(self.fallback_url, input, headers, params)
+            if response.status_code >= 400:
+                raise Exception(
+                    f"Agent {self.name} returned status code {response.status_code} with body {response.text}"
+                )
+        return response.text
+
+    def __str__(self):
+        return f"Agent {self.name}"
+
+    def __repr__(self):
+        return self.__str__()
+
+
+def bl_agent(name: str):
+    return BlAgent(name)
+
+
+async def get_agent_metadata(name):
+    cache_data = await find_from_cache("Agent", name)
+    if cache_data:
+        return Agent.from_dict(cache_data)
+    try:
+        return await get_agent.asyncio(client=client, agent_name=name)
+    except Exception:
+        return None
+
+
+__all__ = ["BlAgent", "bl_agent", "get_agent_metadata"]