Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
docs: enhance custom provider creation documentation and scripts to support output directory option
[email protected]f170e237a169
diff --git a/fern/pages/src/providers/py-custom.mdx b/fern/pages/src/providers/py-custom.mdxindex a0f88f7ca..126f9e936 100644--- a/fern/pages/src/providers/py-custom.mdx+++ b/fern/pages/src/providers/py-custom.mdx@@ -44,9 +44,15 @@ make create-provider name=myprovider# Create an agentic providermake create-provider name=myagent agentic=true++# Create provider with custom output directory+make create-provider name=myprovider output=/path/to/custom/dir++# Combine options+make create-provider name=myagent agentic=true output=/my/custom/path```-This will create a new provider in `python/providers/<provider-name>/` with:+This will create a new provider in the specified directory (default: `python/providers/<provider-name>/`) with:- Complete package structure with `pyproject.toml`- Provider implementation template- Demo scriptdiff --git a/python/Makefile b/python/Makefileindex 29b3a0af6..ba5c72915 100644--- a/python/Makefile+++ b/python/Makefile@@ -15,14 +15,17 @@ provider:create-provider:@if [ -z "$(name)" ]; then\- echo "Please provide a provider name: make create-provider name=<provider-name> [agentic=true]";\+ echo "Please provide a provider name: make create-provider name=<provider-name> [agentic=true] [output=<directory>]";\exit 1;\fi- @if [ "$(agentic)" = "true" ]; then\- python scripts/create_provider.py $(name) --agentic;\- else\- python scripts/create_provider.py $(name);\- fi+ @ARGS="$(name)";\+ if [ "$(agentic)" = "true" ]; then\+ ARGS="$$ARGS --agentic";\+ fi;\+ if [ ! -z "$(output)" ]; then\+ ARGS="$$ARGS --output-dir $(output)";\+ fi;\+ bash scripts/create-provider.sh $$ARGSenv:@echo "* creating new environment"diff --git a/python/scripts/create-provider.sh b/python/scripts/create-provider.shindex 9acf3b67d..29a95d417 100644--- a/python/scripts/create-provider.sh+++ b/python/scripts/create-provider.sh@@ -3,22 +3,41 @@# Check if provider name is providedif [ -z "$1" ]; thenecho "Please provide a provider name"- echo "Usage: ./scripts/create-provider.sh <provider-name> [--agentic]"+ echo "Usage: ./scripts/create-provider.sh <provider-name> [--agentic] [--output-dir <directory>]"exit 1fiPROVIDER_NAME=$1-PROVIDER_PATH="python/providers/$PROVIDER_NAME"+shift++# Default output directory+OUTPUT_DIR="python/providers"+IS_AGENTIC=false++# Parse optional arguments+while [[ $# -gt 0 ]]; do+ case $1 in+ --agentic)+ IS_AGENTIC=true+ shift+ ;;+ --output-dir)+ OUTPUT_DIR="$2"+ shift 2+ ;;+ *)+ echo "Unknown option: $1"+ echo "Usage: ./scripts/create-provider.sh <provider-name> [--agentic] [--output-dir <directory>]"+ exit 1+ ;;+ esac+done++PROVIDER_PATH="$OUTPUT_DIR/$PROVIDER_NAME"# Convert to title case (e.g., myai -> Myai)CAPITAL_PROVIDER_NAME="$(tr '[:lower:]' '[:upper:]' <<< ${PROVIDER_NAME:0:1})${PROVIDER_NAME:1}"PACKAGE_NAME="composio_$PROVIDER_NAME"-# Check if provider should be agentic-IS_AGENTIC=false-if [ "$2" = "--agentic" ]; then- IS_AGENTIC=true-fi-# Check if provider directory already existsif [ -d "$PROVIDER_PATH" ]; thenecho "❌ Provider '$PROVIDER_NAME' already exists in $PROVIDER_PATH"@@ -73,7 +92,7 @@ setup(classifiers=["Development Status :: 3 - Alpha","Intended Audience :: Developers",- "License :: OSI Approved :: MIT License",+ "License :: OSI Approved :: Apache Software License","Programming Language :: Python :: 3","Programming Language :: Python :: 3.10","Programming Language :: Python :: 3.11",@@ -100,15 +119,19 @@ cat > "$PROVIDER_PATH/$PACKAGE_NAME/provider.py" << EOL${CAPITAL_PROVIDER_NAME} Provider implementation."""-from typing import Any, Callable, Dict, List, Sequence-from composio.core.provider import AgenticProvider, AgenticProviderExecuteFn+from __future__ import annotations++import typing as t++from composio.core.provider import AgenticProvider+from composio.core.provider.agentic import AgenticProviderExecuteFnfrom composio.types import Tool# Define your tool formatclass ${CAPITAL_PROVIDER_NAME}Tool:"""${CAPITAL_PROVIDER_NAME} tool format"""- def __init__(self, name: str, description: str, execute: Callable, schema: dict):+ def __init__(self, name: str, description: str, execute: t.Callable, schema: dict):self.name = nameself.description = descriptionself.execute = execute@@ -116,7 +139,7 @@ class ${CAPITAL_PROVIDER_NAME}Tool:class ${CAPITAL_PROVIDER_NAME}Provider(- AgenticProvider[${CAPITAL_PROVIDER_NAME}Tool, List[${CAPITAL_PROVIDER_NAME}Tool]],+ AgenticProvider[${CAPITAL_PROVIDER_NAME}Tool, t.List[${CAPITAL_PROVIDER_NAME}Tool]],name="${PROVIDER_NAME}"):"""@@ -129,7 +152,7 @@ class ${CAPITAL_PROVIDER_NAME}Provider(execute_tool: AgenticProviderExecuteFn) -> ${CAPITAL_PROVIDER_NAME}Tool:"""Wrap a tool in the ${PROVIDER_NAME} format."""- def execute_wrapper(**kwargs) -> Dict:+ def execute_wrapper(**kwargs) -> t.Dict:result = execute_tool(tool.slug, kwargs)if not result.get("successful", False):raise Exception(result.get("error", "Tool execution failed"))@@ -144,9 +167,9 @@ class ${CAPITAL_PROVIDER_NAME}Provider(def wrap_tools(self,- tools: Sequence[Tool],+ tools: t.Sequence[Tool],execute_tool: AgenticProviderExecuteFn- ) -> List[${CAPITAL_PROVIDER_NAME}Tool]:+ ) -> t.List[${CAPITAL_PROVIDER_NAME}Tool]:"""Get composio tools wrapped as a list of ${CAPITAL_PROVIDER_NAME} tools."""@@ -158,7 +181,10 @@ cat > "$PROVIDER_PATH/$PACKAGE_NAME/provider.py" << EOL${CAPITAL_PROVIDER_NAME} Provider implementation."""-from typing import List, Optional, Sequence, TypeAlias, Dict+from __future__ import annotations++import typing as t+from composio.core.provider import NonAgenticProviderfrom composio.types import Tool, Modifiers, ToolExecutionResponse@@ -173,7 +199,7 @@ class ${CAPITAL_PROVIDER_NAME}Tool:# Define your tool collection format-${CAPITAL_PROVIDER_NAME}ToolCollection: TypeAlias = List[${CAPITAL_PROVIDER_NAME}Tool]+${CAPITAL_PROVIDER_NAME}ToolCollection: t.TypeAlias = t.List[${CAPITAL_PROVIDER_NAME}Tool]class ${CAPITAL_PROVIDER_NAME}Provider(@@ -196,7 +222,7 @@ class ${CAPITAL_PROVIDER_NAME}Provider(})- def wrap_tools(self, tools: Sequence[Tool]) -> ${CAPITAL_PROVIDER_NAME}ToolCollection:+ def wrap_tools(self, tools: t.Sequence[Tool]) -> ${CAPITAL_PROVIDER_NAME}ToolCollection:"""Transform a collection of tools"""return [self.wrap_tool(tool) for tool in tools]@@ -204,7 +230,7 @@ class ${CAPITAL_PROVIDER_NAME}Provider(self,user_id: str,tool_call: dict,- modifiers: Optional[Modifiers] = None+ modifiers: t.Optional[Modifiers] = None) -> ToolExecutionResponse:"""Execute a tool call.@@ -224,9 +250,9 @@ class ${CAPITAL_PROVIDER_NAME}Provider(def handle_tool_calls(self,user_id: str,- response: Dict,- modifiers: Optional[Modifiers] = None- ) -> List[ToolExecutionResponse]:+ response: t.Union[dict, t.Any],+ modifiers: t.Optional[Modifiers] = None+ ) -> t.List[ToolExecutionResponse]:"""Handle tool calls from ${CAPITAL_PROVIDER_NAME} response.@@ -236,6 +262,17 @@ class ${CAPITAL_PROVIDER_NAME}Provider(:return: A list of output objects from the tool calls."""# TODO: Implement based on ${CAPITAL_PROVIDER_NAME}'s response format+ # Example:+ # outputs = []+ # for tool_call in response.tool_calls:+ # outputs.append(+ # self.execute_tool_call(+ # user_id=user_id,+ # tool_call=tool_call,+ # modifiers=modifiers,+ # )+ # )+ # return outputsraise NotImplementedError("Tool call handling not implemented yet")EOLfi@@ -253,7 +290,7 @@ ${CAPITAL_PROVIDER_NAME} demo.import asyncio# from ${PROVIDER_NAME}_framework import Agent, Runner # Import your agent framework-from $PACKAGE_NAME import ${CAPITAL_PROVIDER_NAME}Provider+from composio_${PROVIDER_NAME} import ${CAPITAL_PROVIDER_NAME}Providerfrom composio import Composio@@ -300,7 +337,7 @@ cat > "$PROVIDER_PATH/${PROVIDER_NAME}_demo.py" << EOL${CAPITAL_PROVIDER_NAME} demo."""-from $PACKAGE_NAME import ${CAPITAL_PROVIDER_NAME}Provider+from composio_${PROVIDER_NAME} import ${CAPITAL_PROVIDER_NAME}Provider# from ${PROVIDER_NAME} import ${CAPITAL_PROVIDER_NAME} # Import your AI clientfrom composio import Composio@@ -363,7 +400,7 @@ uv add $PACKAGE_NAME\`\`\`pythonfrom composio import Composio-from $PACKAGE_NAME import ${CAPITAL_PROVIDER_NAME}Provider+from composio_${PROVIDER_NAME} import ${CAPITAL_PROVIDER_NAME}Provider# Initialize Composio with ${CAPITAL_PROVIDER_NAME} providercomposio = Composio(@@ -387,7 +424,7 @@ tools = composio.tools.get(\`\`\`pythonfrom composio import Composio-from $PACKAGE_NAME import ${CAPITAL_PROVIDER_NAME}Provider+from composio_${PROVIDER_NAME} import ${CAPITAL_PROVIDER_NAME}Provider# Initialize providerprovider = ${CAPITAL_PROVIDER_NAME}Provider()@@ -472,7 +509,7 @@ We welcome contributions! Please see our [Contributing Guide](../../CONTRIBUTING## License-ISC License+Apache License 2.0## Support