Merge branch 'master' into feat/v1-v2-shift

docs/framework/letta.mdx

@@ -1,29 +1,42 @@
 ---
 title: "Using Composio With Letta"
 sidebarTitle: "Letta"
-description: "Integrate Composio with Letta to let them seamlessly interact with external apps"
+description: "Integrate Composio with Letta agents to let them seamlessly interact with external apps"
 ---
 
 ## Star A Repository on GitHub
 In this example, we will use Letta Agent to star a repository on GitHub using Composio Tools
 
 <Steps>
 <Step title="Install Packages">
+<CodeGroup>
 ```bash Python
-pip install composio_langchain letta
+pip install letta-client composio_langchain
+```
+```bash JavaScript
+npm i composio-core @letta-ai/letta-client
 ```
+</CodeGroup>
 </Step>
 <Step title="Import Libraries & Configure Client">
-```bash Python
-from letta import EmbeddingConfig, LLMConfig, create_client
-from composio_langchain import Action, ComposioToolSet
+<CodeGroup>
+```python Python
+from letta_client import Letta
+from composio_langchain import Action, ComposioToolSet, App
 
-client = create_client()
+client = Letta(base_url="http://localhost:8283")
+```
+```javascript JavaScript
+import { LettaClient } from '@letta-ai/letta-client'
+import { ComposioToolSet } from "composio-core"
 
-# set automatic defaults for LLM/embedding config
-client.set_default_llm_config(LLMConfig.default_config(model_name="gpt-4"))
-client.set_default_embedding_config(EmbeddingConfig.default_config(model_name="text-embedding-ada-002"))
+const client = new LettaClient({
+    baseUrl: "http://localhost:8283",
+});
+
+const toolset = new ComposioToolSet()
 ```
+</CodeGroup>
 </Step>
 
 <Step title="Connect Your GitHub Account">
@@ -38,30 +51,83 @@ toolset = ComposioToolSet()
 request = toolset.initiate_connection(app=App.GITHUB)
 print(f"Open this URL to authenticate: {request.redirectUrl}")
 ```
+```javascript JavaScript
+const connection = await toolset.connectedAccounts.initiate({appName: "github"})
+console.log(`Open this URL to authenticate: ${connection.redirectUrl}`);
+```
 </CodeGroup>
-<Tip>
-Don't forget to set your `COMPOSIO_API_KEY` and `OPENAI_API_KEY` in your environment variables.
-</Tip>
 </Step>
-
 <Step title="Add GitHub action to Client">
-You can get all the tools for a given app or specific actions as shown below. Learn more [here](../../patterns/tools/use-tools/use-specific-actions)
+Adding tools to the client
 <CodeGroup>
 ```python Python
-composio_tool = client.load_composio_tool(Action.GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER)
-agent_state = client.create_agent()
-client.add_tool_to_agent(
-    agent_id=agent_state.id,
-    tool_id=composio_tool.id
+tool = client.tools.add_composio_tool(composio_action_name=Action.GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER.name)
+```
+```javascript JavaScript
+const tool = await client.tools.addComposioTool(
+    "GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER",
 )
 ```
 </CodeGroup>
-
+</Step>
+<Step title="Create the agent">
+<CodeGroup>
+```python Python
+agent = client.agents.create(
+    name="GitHub Agent",
+    memory_blocks=[
+        {"label": "persona", "value": "I am a helpful assistant"}
+    ],
+    model="openai/gpt-4o",
+    embedding="openai/text-embedding-ada-002", 
+    tool_ids=[tool.id]
+)
+```
+```javascript JavaScript
+const agent = await client.agents.create({
+    name: "GitHub Agent",
+    memoryBlocks: [
+        {
+            value: "I am a helpful assistant",
+            label: "persona",
+        },
+    ],
+    model: "openai/gpt-4o",
+    embedding: "openai/text-embedding-ada-002",
+    toolIds: [tool.id],
+});
+```
+</CodeGroup>
 </Step>
 <Step title="Execute the Agent">
+<CodeGroup>
 ```python Python
-response = client.send_message(agent_id=agent_state.id, role="user", message="Star the repo composiohq/composio")
-print(response)
+response = client.agents.messages.create(
+    agent_id=agent.id,
+    messages=[
+        {
+            "role": "user",
+            "content": "Star the github repo composioHQ/composio/"
+        }
+    ]
+)
+for message in response.messages:
+    print(message)
 ```
+```javascript JavaScript
+const response = await client.agents.messages.create(agent.id, {
+    messages: [
+        {
+            role: "user",
+            content: "Star the github repo composiohq/composio",
+        },
+    ],
+});
+
+for (const message of response.messages) {
+    console.log(message);
+}
+```
+</CodeGroup>
 </Step>
 </Steps>

docs/framework/smolagents.mdx

@@ -0,0 +1,74 @@
+---
+title: "Using Composio With Smol Agents"
+sidebarTitle: "Smol Agents"
+description: "Integrate Composio with Smol agents to let them seamlessly interact with external apps"
+---
+
+## Star A Repository on GitHub
+In this example, we will use SmolAgent's Code Agent to star a repository on GitHub using Composio Tools
+
+<Steps>
+<Step title="Install Packages">
+<CodeGroup>
+```bash Python
+pip install composio-smol smolagents
+```
+</CodeGroup>
+</Step>
+<Step title="Import Libraries & Initialize ComposioToolSet">
+<CodeGroup>
+```python Python
+from composio_smol import ComposioToolSet, Action, App
+from smolagents import CodeAgent, HfApiModel
+from dotenv import load_dotenv
+
+load_dotenv()
+
+composio_toolset = ComposioToolSet()
+```
+</CodeGroup>
+</Step>
+
+<Step title="Connect Your GitHub Account">
+    <Info>You need to have an active GitHub Integration. Learn how to do this [here](https://youtu.be/LmyWy4LiedQ?si=u5uFArlNL0tew0Wf)</Info>
+    <CodeGroup>
+        ```shell CLI
+        composio login
+        composio add github
+        ```
+        ```python Python
+        request = composio_toolset.initiate_connection(app=App.GITHUB)
+        print(f"Open this URL to authenticate: {request.redirectUrl}")
+        ```
+    </CodeGroup>
+    <Tip>
+        Don't forget to set your `COMPOSIO_API_KEY` in your environment variables.
+    </Tip>
+</Step>
+
+<Step title="Get All GitHub Tools">
+You can get all the tools for a given app as shown below, but you can get **specific actions** and filter actions using **usecase** & **tags**. Learn more [here](../../patterns/tools/use-tools/use-specific-actions)
+<CodeGroup>
+```python Python
+tools = composio_toolset.get_tools(actions=[Action.GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER])
+```
+</CodeGroup>
+
+</Step>
+<Step title="Define the Agent">
+<CodeGroup>
+```python Python
+agent = CodeAgent(tools=tools, model=HfApiModel())
+```
+</CodeGroup>
+</Step>
+
+<Step title="Execute the Agent">
+<CodeGroup>
+```python Python
+task = "Star a repo composiohq/composio on GitHub"
+agent.run(task)
+```
+</CodeGroup>
+</Step>
+</Steps>

docs/mint.json

@@ -110,7 +110,8 @@
               ]
             },
             "patterns/tools/custom-integration",
-            "patterns/tools/serve-tools"
+            "patterns/tools/serve-tools",
+            "patterns/tools/versioning"
       ]
     },
     {
@@ -146,6 +147,7 @@
         {
           "group": "Other Frameworks",
           "pages": [
+            "framework/smolagents",
             "framework/camelai",
             "javascript/cloudflare",
             "framework/griptape",

docs/patterns/tools/versioning.mdx

@@ -0,0 +1,56 @@
+---
+title: "Action Versioning"
+sidebarTitle: "Action Versioning"
+description: "Learn how to use versioned actions in Composio"
+---
+
+Composio supports semantic versioning for actions to ensure stable and consistent interfaces. This guide explains how version specifiers work and how to use them in your applications.
+
+## Versioning Policies
+
+Composio follows semantic versioning principles:
+
+- **Minor Version Changes** (0_1 → 0_2)
+  - Non-breaking interface changes
+  - Examples: Adding optional parameters, extending functionality
+  - Backward compatible with previous minor versions
+
+- **Major Version Changes** (0_3 → 1_0)
+  - Breaking interface changes
+  - Examples: Action deprecation or replacement, Changes in required parameters, Changes in parameter types or formats
+  - May require updates to existing code
+
+## Version Specifiers
+
+Composio provides several ways to specify which version of an action you want to use:
+
+- `latest` - Uses the most recent version available. For example, if an action has versions 0_1, 0_2, 0_3, 1_0, and 1_1, `latest` will resolve to `1_1`.
+- `latest:base` - Uses the latest version before a major version change. Using the same example versions, `latest:base` would resolve to `0_3`.
+- `x_y` - Explicitly specify major (x) and minor (y) versions, like `0_1` or `1_0`.
+
+## Using Versions in Code
+
+Here's how to specify versions when using Composio:
+
+<CodeGroup>
+```python Python {7,10,13}
+from composio_langchain import ComposioToolSet, Action
+
+# Initialize toolset
+toolset = ComposioToolSet()
+
+# Use latest base version (default)
+tools = toolset.get_tools(actions=[Action.GITHUB_META_ROOT @ "latest:base"])
+
+# Use latest version
+tools = toolset.get_tools(actions=[Action.GITHUB_META_ROOT @ "latest"])
+
+# Use specific version
+tools = toolset.get_tools(actions=[Action.GITHUB_META_ROOT @ "0_1"])
+```
+``` javascript JavaScript
+coming soon!
+```
+</CodeGroup>
+
+<Info>If no version is specified it defaults to `latest:base`</Info>

js/Testing.MD

@@ -10,6 +10,7 @@ The test suite is designed to run across multiple environments. Before running t
    - GitHub integration is enabled and active
    - Gmail integration is enabled and active 
    - CodeInterpreter is configured for the default entity
+   - Github drive and file_id is configured for the default entity
 
 3. Trigger Configuration
    - At least one trigger must be active in the system

js/config/getTestConfig.ts

@@ -1,17 +1,24 @@
-export const env = process.env.TEST_ENV  || "staging"
+export const env = "staging";
 const CURRENT_FILE_DIR = __dirname;
 
 export type BACKEND_CONFIG = {
-    COMPOSIO_API_KEY: string;
-    BACKEND_HERMES_URL: string;
-}
+  COMPOSIO_API_KEY: string;
+  BACKEND_HERMES_URL: string;
+  drive: {
+    downloadable_file_id: string;
+  };
+};
 
 export const getTestConfig = (): BACKEND_CONFIG => {
-    const path = `${CURRENT_FILE_DIR}/test.config.${env}.json`;
-    try {
-        return JSON.parse(JSON.stringify(require(path))) as unknown as BACKEND_CONFIG;
-    } catch (error) {
-        console.error("Error loading test config file:", error);
-        throw new Error(`Error loading test config file. You  can create test.config.${env}.json file in the config folder.`);
-    }
-}
+  const path = `${CURRENT_FILE_DIR}/test.config.${env}.json`;
+  try {
+    return JSON.parse(
+      JSON.stringify(require(path))
+    ) as unknown as BACKEND_CONFIG;
+  } catch (error) {
+    console.error("Error loading test config file:", error);
+    throw new Error(
+      `Error loading test config file. You  can create test.config.${env}.json file in the config folder.`
+    );
+  }
+};

js/config/test.config.local.json

@@ -1,4 +1,7 @@
 {
     "COMPOSIO_API_KEY": "",
-    "BACKEND_HERMES_URL": "http://localhost:9900"
+    "BACKEND_HERMES_URL": "http://localhost:9900",
+    "drive":{
+        "downloadable_file_id":"18rcI9N7cJRG15E2qyWXtNSFeDg4Rj-T3"
+    }
 }

js/config/test.config.prod.json

@@ -1,4 +1,7 @@
 {
     "COMPOSIO_API_KEY": "pv7s0lpq7z5vu27cikyls",
-    "BACKEND_HERMES_URL": "https://backend.composio.dev"
+    "BACKEND_HERMES_URL": "https://backend.composio.dev",
+    "drive":{
+        "downloadable_file_id":"18rcI9N7cJRG15E2qyWXtNSFeDg4Rj-T3"
+    }
 }

js/config/test.config.staging.json

@@ -1,4 +1,7 @@
 {
     "COMPOSIO_API_KEY": "gxpf3a5v864651jp741heq",
-    "BACKEND_HERMES_URL": "https://staging-backend.composio.dev"
+    "BACKEND_HERMES_URL": "https://staging-backend.composio.dev",
+    "drive":{
+        "downloadable_file_id":"1K23Tyfb35lpu_syfdsx1w6UfIJ9DRgwq"
+    }
 }

js/openapi-ts.config.js

@@ -3,7 +3,7 @@ import { defineConfig } from "@hey-api/openapi-ts";
 
 export default defineConfig({
     client: "@hey-api/client-axios",
-    input: "http://localhost:9900/openapi.json",
+    input: "https://backend.composio.dev/openapi.json",
     output: "src/sdk/client",
     services: {
         asClass: true,