@composio/google 0.1.12-alpha.12

package/README.md

@@ -0,0 +1,147 @@
+# @composio/google
+
+Google GenAI Provider for Composio SDK.
+
+## Features
+
+- **Google GenAI Integration**: Seamless integration with Google's Generative AI models (Gemini)
+- **Function Calling Support**: Convert Composio tools to Google GenAI function declarations
+- **Type Safety**: Full TypeScript support with proper type definitions
+- **Execution Modifiers**: Support for transforming tool inputs and outputs
+- **Flexible Authentication**: Support for custom authentication parameters
+- **Streaming Support**: First-class support for streaming responses
+
+## Installation
+
+```bash
+npm install @composio/core @composio/google @google/genai
+# or
+yarn add @composio/core @composio/google @google/genai
+# or
+pnpm add @composio/core @composio/google @google/genai
+```
+
+## Environment Variables
+
+Required environment variables:
+
+- `COMPOSIO_API_KEY`: Your Composio API key
+- `GEMINI_API_KEY`: Your Google AI API key
+
+Optional environment variables:
+
+- `GOOGLE_PROJECT_ID`: Your Google Cloud project ID (for custom deployments)
+- `GOOGLE_LOCATION`: Your Google Cloud location (for custom deployments)
+
+## Quick Start
+
+```typescript
+import { Composio } from '@composio/core';
+import { GoogleProvider } from '@composio/google';
+import { GoogleGenerativeAI } from '@google/genai';
+
+// Initialize Google GenAI
+const genAI = new GoogleGenerativeAI(process.env.GEMINI_API_KEY);
+
+// Initialize Composio with Google provider
+const composio = new Composio({
+  apiKey: process.env.COMPOSIO_API_KEY,
+  provider: new GoogleProvider(),
+});
+
+// Get available tools
+const tools = await composio.tools.get('user123', {
+  toolkits: ['gmail', 'calendar'],
+  limit: 10,
+});
+```
+
+## Examples
+
+Check out our complete example implementations:
+
+- [Basic Google Integration](../../examples/google/src/index.ts)
+
+## Provider Configuration
+
+The Google provider can be configured with various options:
+
+```typescript
+const provider = new GoogleProvider({
+  // Custom project configuration
+  projectId: 'your-project-id',
+  location: 'your-location',
+  // Custom execution modifiers
+  modifiers: {
+    beforeExecute: params => {
+      // Transform parameters before execution
+      return params;
+    },
+    afterExecute: response => {
+      // Transform response after execution
+      return response;
+    },
+  },
+});
+```
+
+## API Reference
+
+### GoogleProvider Class
+
+The `GoogleProvider` class extends `BaseNonAgenticProvider` and provides Google GenAI-specific functionality.
+
+#### Methods
+
+##### `wrapTool(tool: Tool): GoogleTool`
+
+Wraps a Composio tool in the Google GenAI function declaration format.
+
+```typescript
+const wrappedTool = provider.wrapTool(composioTool);
+```
+
+##### `wrapTools(tools: Tool[]): GoogleGenAIToolCollection`
+
+Wraps multiple Composio tools in the Google GenAI function declaration format.
+
+```typescript
+const wrappedTools = provider.wrapTools(composioTools);
+```
+
+##### `executeToolCall(userId: string, tool: GoogleGenAIFunctionCall, options?: ExecuteToolFnOptions, modifiers?: ExecuteToolModifiers): Promise<string>`
+
+Executes a tool call from Google GenAI and returns the result as a JSON string.
+
+```typescript
+const result = await provider.executeToolCall('user123', functionCall, options, modifiers);
+```
+
+#### Types
+
+```typescript
+interface GoogleGenAIFunctionCall {
+  name: string;
+  args: Record<string, unknown>;
+}
+
+type GoogleTool = {
+  name: string;
+  description: string;
+  parameters: Schema;
+};
+
+type GoogleGenAIToolCollection = GoogleTool[];
+```
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](../../CONTRIBUTING.md) for more details.
+
+## License
+
+ISC License
+
+## Support
+
+For support, please visit our [Documentation](https://docs.composio.dev) or join our [Discord Community](https://discord.gg/composio).

package/dist/index.cjs

@@ -0,0 +1,76 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  GoogleProvider: () => GoogleProvider
+});
+module.exports = __toCommonJS(index_exports);
+var import_core = require("@composio/core");
+var GoogleProvider = class extends import_core.BaseNonAgenticProvider {
+  name = "google";
+  /**
+   * Wrap a Composio tool in the Google GenAI function declaration format.
+   * @param tool - The Composio tool to wrap.
+   * @returns The wrapped tool in Google GenAI format.
+   */
+  wrapTool(tool) {
+    return {
+      name: tool.slug,
+      description: tool.description || "",
+      parameters: {
+        type: "object",
+        description: tool.description || "",
+        properties: tool.inputParameters?.properties || {},
+        required: tool.inputParameters?.required || []
+      }
+    };
+  }
+  /**
+   * Wrap a list of Composio tools in the Google GenAI function declaration format.
+   * @param tools - The Composio tools to wrap.
+   * @returns The wrapped tools in Google GenAI format.
+   */
+  wrapTools(tools) {
+    return tools.map((tool) => this.wrapTool(tool));
+  }
+  /**
+   * Execute a tool call from Google GenAI.
+   * @param userId - The user id.
+   * @param tool - The Google GenAI function call to execute.
+   * @param options - Optional execution options.
+   * @param modifiers - Optional execution modifiers.
+   * @returns The result of the tool call as a JSON string.
+   */
+  async executeToolCall(userId, tool, options, modifiers) {
+    const payload = {
+      arguments: tool.args,
+      connectedAccountId: options?.connectedAccountId,
+      customAuthParams: options?.customAuthParams,
+      userId
+    };
+    const result = await this.executeTool(tool.name, payload, modifiers);
+    return JSON.stringify(result);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GoogleProvider
+});

package/dist/index.d.cts

@@ -0,0 +1,60 @@
+import { BaseNonAgenticProvider, Tool, ExecuteToolFnOptions, ExecuteToolModifiers } from '@composio/core';
+import { FunctionDeclaration } from '@google/genai';
+
+/**
+ * Google GenAI Provider
+ *
+ * This provider provides a set of tools for interacting with Google's GenAI API.
+ * It supports both the Gemini Developer API and Vertex AI implementations.
+ *
+ * @packageDocumentation
+ * @module providers/google
+ */
+
+/**
+ * Interface for Google GenAI function declaration
+ * Based on the FunctionDeclaration type from @google/genai
+ */
+type GoogleTool = FunctionDeclaration;
+/**
+ * Interface for Google GenAI function call
+ * Based on the FunctionCall type from @google/genai
+ */
+interface GoogleGenAIFunctionCall {
+    name: string;
+    args: Record<string, unknown>;
+}
+/**
+ * Type for a collection of Google GenAI function declarations
+ */
+type GoogleGenAIToolCollection = GoogleTool[];
+/**
+ * Google GenAI Provider for Composio SDK
+ * Implements the BaseNonAgenticProvider to wrap Composio tools for use with Google's GenAI API
+ */
+declare class GoogleProvider extends BaseNonAgenticProvider<GoogleGenAIToolCollection, GoogleTool> {
+    readonly name = "google";
+    /**
+     * Wrap a Composio tool in the Google GenAI function declaration format.
+     * @param tool - The Composio tool to wrap.
+     * @returns The wrapped tool in Google GenAI format.
+     */
+    wrapTool(tool: Tool): GoogleTool;
+    /**
+     * Wrap a list of Composio tools in the Google GenAI function declaration format.
+     * @param tools - The Composio tools to wrap.
+     * @returns The wrapped tools in Google GenAI format.
+     */
+    wrapTools(tools: Tool[]): GoogleGenAIToolCollection;
+    /**
+     * Execute a tool call from Google GenAI.
+     * @param userId - The user id.
+     * @param tool - The Google GenAI function call to execute.
+     * @param options - Optional execution options.
+     * @param modifiers - Optional execution modifiers.
+     * @returns The result of the tool call as a JSON string.
+     */
+    executeToolCall(userId: string, tool: GoogleGenAIFunctionCall, options?: ExecuteToolFnOptions, modifiers?: ExecuteToolModifiers): Promise<string>;
+}
+
+export { type GoogleGenAIFunctionCall, type GoogleGenAIToolCollection, GoogleProvider, type GoogleTool };

package/dist/index.d.ts

@@ -0,0 +1,60 @@
+import { BaseNonAgenticProvider, Tool, ExecuteToolFnOptions, ExecuteToolModifiers } from '@composio/core';
+import { FunctionDeclaration } from '@google/genai';
+
+/**
+ * Google GenAI Provider
+ *
+ * This provider provides a set of tools for interacting with Google's GenAI API.
+ * It supports both the Gemini Developer API and Vertex AI implementations.
+ *
+ * @packageDocumentation
+ * @module providers/google
+ */
+
+/**
+ * Interface for Google GenAI function declaration
+ * Based on the FunctionDeclaration type from @google/genai
+ */
+type GoogleTool = FunctionDeclaration;
+/**
+ * Interface for Google GenAI function call
+ * Based on the FunctionCall type from @google/genai
+ */
+interface GoogleGenAIFunctionCall {
+    name: string;
+    args: Record<string, unknown>;
+}
+/**
+ * Type for a collection of Google GenAI function declarations
+ */
+type GoogleGenAIToolCollection = GoogleTool[];
+/**
+ * Google GenAI Provider for Composio SDK
+ * Implements the BaseNonAgenticProvider to wrap Composio tools for use with Google's GenAI API
+ */
+declare class GoogleProvider extends BaseNonAgenticProvider<GoogleGenAIToolCollection, GoogleTool> {
+    readonly name = "google";
+    /**
+     * Wrap a Composio tool in the Google GenAI function declaration format.
+     * @param tool - The Composio tool to wrap.
+     * @returns The wrapped tool in Google GenAI format.
+     */
+    wrapTool(tool: Tool): GoogleTool;
+    /**
+     * Wrap a list of Composio tools in the Google GenAI function declaration format.
+     * @param tools - The Composio tools to wrap.
+     * @returns The wrapped tools in Google GenAI format.
+     */
+    wrapTools(tools: Tool[]): GoogleGenAIToolCollection;
+    /**
+     * Execute a tool call from Google GenAI.
+     * @param userId - The user id.
+     * @param tool - The Google GenAI function call to execute.
+     * @param options - Optional execution options.
+     * @param modifiers - Optional execution modifiers.
+     * @returns The result of the tool call as a JSON string.
+     */
+    executeToolCall(userId: string, tool: GoogleGenAIFunctionCall, options?: ExecuteToolFnOptions, modifiers?: ExecuteToolModifiers): Promise<string>;
+}
+
+export { type GoogleGenAIFunctionCall, type GoogleGenAIToolCollection, GoogleProvider, type GoogleTool };

package/dist/index.js

@@ -0,0 +1,53 @@
+// src/index.ts
+import {
+  BaseNonAgenticProvider
+} from "@composio/core";
+var GoogleProvider = class extends BaseNonAgenticProvider {
+  name = "google";
+  /**
+   * Wrap a Composio tool in the Google GenAI function declaration format.
+   * @param tool - The Composio tool to wrap.
+   * @returns The wrapped tool in Google GenAI format.
+   */
+  wrapTool(tool) {
+    return {
+      name: tool.slug,
+      description: tool.description || "",
+      parameters: {
+        type: "object",
+        description: tool.description || "",
+        properties: tool.inputParameters?.properties || {},
+        required: tool.inputParameters?.required || []
+      }
+    };
+  }
+  /**
+   * Wrap a list of Composio tools in the Google GenAI function declaration format.
+   * @param tools - The Composio tools to wrap.
+   * @returns The wrapped tools in Google GenAI format.
+   */
+  wrapTools(tools) {
+    return tools.map((tool) => this.wrapTool(tool));
+  }
+  /**
+   * Execute a tool call from Google GenAI.
+   * @param userId - The user id.
+   * @param tool - The Google GenAI function call to execute.
+   * @param options - Optional execution options.
+   * @param modifiers - Optional execution modifiers.
+   * @returns The result of the tool call as a JSON string.
+   */
+  async executeToolCall(userId, tool, options, modifiers) {
+    const payload = {
+      arguments: tool.args,
+      connectedAccountId: options?.connectedAccountId,
+      customAuthParams: options?.customAuthParams,
+      userId
+    };
+    const result = await this.executeTool(tool.name, payload, modifiers);
+    return JSON.stringify(result);
+  }
+};
+export {
+  GoogleProvider
+};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@composio/google",
+  "version": "0.1.12-alpha.12",
+  "description": "Google GenAI Provider for Composio SDK",
+  "main": "dist/index.js",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "README.md",
+    "dist"
+  ],
+  "keywords": [
+    "composio",
+    "provider",
+    "google",
+    "genai",
+    "gemini"
+  ],
+  "author": "",
+  "license": "ISC",
+  "peerDependencies": {
+    "@composio/core": "0.1.12-alpha.12",
+    "@google/genai": "^1.1.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.3",
+    "@composio/core": "0.1.12-alpha.12"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run"
+  },
+  "types": "dist/index.d.ts"
+}