@adminforth/completion-adapter-google-gemini 1.0.0

package/.woodpecker/buildRelease.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+
+npm run build 2>&1 | tee build.log
+build_status=${PIPESTATUS[0]}
+
+if [ $build_status -ne 0 ]; then
+  echo "Build failed. Exiting with status code $build_status"
+  exit $build_status
+fi

package/.woodpecker/buildSlackNotify.sh

@@ -0,0 +1,44 @@
+#!/bin/sh
+
+set -x
+
+COMMIT_SHORT_SHA=$(echo $CI_COMMIT_SHA | cut -c1-8)
+
+STATUS=${1}
+
+if [ "$STATUS" = "success" ]; then
+  MESSAGE="Did a build without issues on \`$CI_REPO_NAME/$CI_COMMIT_BRANCH\`. Commit: _${CI_COMMIT_MESSAGE}_ (<$CI_COMMIT_URL|$COMMIT_SHORT_SHA>)"
+
+  curl  -s -X POST -H "Content-Type: application/json" -d '{
+    "username": "'"$CI_COMMIT_AUTHOR"'",
+    "icon_url": "'"$CI_COMMIT_AUTHOR_AVATAR"'",
+    "attachments": [
+      {
+          "mrkdwn_in": ["text", "pretext"],
+          "color": "#36a64f",
+          "text": "'"$MESSAGE"'"
+      }
+    ]
+  }' "$DEVELOPERS_SLACK_WEBHOOK"
+  exit 0
+fi
+export BUILD_LOG=$(cat ./build.log)
+
+BUILD_LOG=$(echo $BUILD_LOG | sed 's/"/\\"/g')
+
+MESSAGE="Broke \`$CI_REPO_NAME/$CI_COMMIT_BRANCH\` with commit _${CI_COMMIT_MESSAGE}_ (<$CI_COMMIT_URL|$COMMIT_SHORT_SHA>)"
+CODE_BLOCK="\`\`\`$BUILD_LOG\n\`\`\`"
+
+echo "Sending slack message to developers $MESSAGE"
+curl -sS -X POST -H "Content-Type: application/json" -d '{
+  "username": "'"$CI_COMMIT_AUTHOR"'",
+  "icon_url": "'"$CI_COMMIT_AUTHOR_AVATAR"'",
+  "attachments": [
+    {
+        "mrkdwn_in": ["text", "pretext"],
+        "color": "#8A1C12",
+        "text": "'"$CODE_BLOCK"'",
+        "pretext": "'"$MESSAGE"'"
+    }
+  ]
+}' "$DEVELOPERS_SLACK_WEBHOOK" 2>&1

package/.woodpecker/release.yml

@@ -0,0 +1,56 @@
+clone:
+  git:
+    image: woodpeckerci/plugin-git
+    settings:
+      partial: false
+      depth: 5
+
+steps:
+  init-secrets:
+    when:
+      - event: push
+    image: infisical/cli
+    environment:
+      INFISICAL_TOKEN:
+        from_secret: VAULT_TOKEN
+    commands:
+      - infisical export --domain https://vault.devforth.io/api --format=dotenv-export --env="prod" > /woodpecker/deploy.vault.env
+
+  build:
+    image: devforth/node20-pnpm:latest
+    when:
+      - event: push
+    commands:
+      - . /woodpecker/deploy.vault.env
+      - pnpm install
+      - /bin/bash ./.woodpecker/buildRelease.sh
+      - npm audit signatures
+
+  release:
+    image: devforth/node20-pnpm:latest
+    when:
+      - event:
+          - push
+        branch:
+          - main
+    commands:
+      - . /woodpecker/deploy.vault.env
+      - pnpm exec semantic-release
+
+  slack-on-failure:
+    image: curlimages/curl
+    when:
+      - event: push
+        status: [failure]
+    commands:
+      - . /woodpecker/deploy.vault.env
+      - /bin/sh ./.woodpecker/buildSlackNotify.sh failure
+
+  slack-on-success:
+    image: curlimages/curl
+    when:
+      - event: push
+        status: [success]
+    commands:
+      - . /woodpecker/deploy.vault.env
+      - /bin/sh ./.woodpecker/buildSlackNotify.sh success

package/Changelog.md

@@ -0,0 +1,5 @@
+## [1.0.0] - 2024-12-06
+
+### Added
+
+- Added Google Gemini completion adapter.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Devforth.io
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/build.log

@@ -0,0 +1,4 @@
+
+> @adminforth/completion-adapter-google-gemini@2.0.6 build
+> tsc
+

package/dist/index.js

@@ -0,0 +1,113 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { ChatGoogleGenerativeAI } from "@langchain/google-genai";
+import { GoogleGenAI } from "@google/genai";
+import pRetry from 'p-retry';
+import { logger } from "adminforth";
+const GOOGLE_LANGCHAIN_AGENT_OPTION_KEYS = [
+    "temperature",
+    "topP",
+    "topK",
+    "stopSequences",
+    "safetySettings",
+    "apiVersion",
+    "baseUrl",
+    "customHeaders",
+    "streaming",
+    "json",
+    "streamUsage",
+    "convertSystemMessageToHumanContent",
+    "thinkingConfig",
+];
+function getGoogleLangChainAgentOptions(extraRequestBodyParameters) {
+    const options = {};
+    if (!extraRequestBodyParameters) {
+        return options;
+    }
+    for (const key of GOOGLE_LANGCHAIN_AGENT_OPTION_KEYS) {
+        if (key in extraRequestBodyParameters) {
+            options[key] = extraRequestBodyParameters[key];
+        }
+    }
+    return options;
+}
+export default class CompletionAdapterGoogleGemini {
+    constructor(options) {
+        this.complete = (requestOrContent_1, ...args_1) => __awaiter(this, [requestOrContent_1, ...args_1], void 0, function* (requestOrContent, stopOrMaxTokens = 50, maxTokensOrOutputSchema = 50, outputSchema) {
+            const request = typeof requestOrContent === "string"
+                ? {
+                    content: requestOrContent,
+                    maxTokens: typeof stopOrMaxTokens === "number"
+                        ? stopOrMaxTokens
+                        : typeof maxTokensOrOutputSchema === "number"
+                            ? maxTokensOrOutputSchema
+                            : 50,
+                    outputSchema: typeof stopOrMaxTokens === "number"
+                        ? maxTokensOrOutputSchema
+                        : outputSchema,
+                }
+                : requestOrContent;
+            const { content, maxTokens: requestMaxTokens = 50, outputSchema: requestOutputSchema, } = request;
+            const ai = new GoogleGenAI({
+                apiKey: this.options.geminiApiKey,
+            });
+            const tryToGenerate = () => __awaiter(this, void 0, void 0, function* () {
+                logger.debug("Making Google Gemini API call");
+                try {
+                    const response = yield ai.models.generateContent({
+                        model: this.options.model || "gemini-3-flash-preview",
+                        contents: content,
+                        config: Object.assign({ responseJsonSchema: requestOutputSchema ? requestOutputSchema : undefined, maxOutputTokens: requestMaxTokens }, this.options.extraRequestBodyParameters),
+                    });
+                    logger.debug(`Google Gemini SUCCESSFUL API response: ${response}`);
+                    return {
+                        content: response.text,
+                    };
+                }
+                catch (error) {
+                    logger.error(`Error during Google Gemini API call: ${error}`);
+                    throw new Error(`Error during Google Gemini API call: ${JSON.parse(error.message).error.message}`);
+                }
+            });
+            const result = yield pRetry(tryToGenerate, {
+                retries: 5,
+                onFailedAttempt: ({ error, attemptNumber, retriesLeft, retriesConsumed }) => {
+                    logger.debug(`Attempt ${attemptNumber} failed. ${retriesLeft} retries left. ${retriesConsumed} retries consumed.`);
+                },
+            });
+            return result;
+        });
+        this.options = options;
+    }
+    validate() {
+        if (!this.options.geminiApiKey) {
+            throw new Error("geminiApiKey is required");
+        }
+    }
+    measureTokensCount(content) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Implement token counting logic here
+            const ai = new GoogleGenAI({
+                apiKey: this.options.geminiApiKey,
+            });
+            const countTokensResponse = yield ai.models.countTokens({
+                model: "gemini-2.0-flash",
+                contents: content,
+            });
+            return countTokensResponse.totalTokens;
+        });
+    }
+    getLangChainAgentSpec(params) {
+        const modelOptions = getGoogleLangChainAgentOptions(this.options.extraRequestBodyParameters);
+        return {
+            model: new ChatGoogleGenerativeAI(Object.assign({ model: this.options.model || "gemini-3-flash-preview", apiKey: this.options.geminiApiKey, maxOutputTokens: params.maxTokens }, modelOptions)),
+        };
+    }
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/index.ts

@@ -0,0 +1,162 @@
+import type { AdapterOptions } from "./types.js";
+import type { CompletionAdapter } from "adminforth";
+import { ChatGoogleGenerativeAI } from "@langchain/google-genai";
+import { GoogleGenAI } from "@google/genai";
+import pRetry from 'p-retry';
+import { logger } from "adminforth";
+
+type CompletionRequestInput = {
+  content: string;
+  maxTokens?: number;
+  outputSchema?: any;
+};
+
+type AgentModelPurpose = "primary" | "summary";
+
+const GOOGLE_LANGCHAIN_AGENT_OPTION_KEYS = [
+  "temperature",
+  "topP",
+  "topK",
+  "stopSequences",
+  "safetySettings",
+  "apiVersion",
+  "baseUrl",
+  "customHeaders",
+  "streaming",
+  "json",
+  "streamUsage",
+  "convertSystemMessageToHumanContent",
+  "thinkingConfig",
+] as const;
+
+function getGoogleLangChainAgentOptions(
+  extraRequestBodyParameters?: Record<string, unknown>,
+) {
+  const options: Record<string, unknown> = {};
+
+  if (!extraRequestBodyParameters) {
+    return options;
+  }
+
+  for (const key of GOOGLE_LANGCHAIN_AGENT_OPTION_KEYS) {
+    if (key in extraRequestBodyParameters) {
+      options[key] = extraRequestBodyParameters[key];
+    }
+  }
+
+  return options;
+}
+
+export default class CompletionAdapterGoogleGemini
+  implements CompletionAdapter
+{
+  options: AdapterOptions;
+
+  constructor(options: AdapterOptions) {
+    this.options = options;
+  }
+  
+  validate() {
+    if (!this.options.geminiApiKey) {
+      throw new Error("geminiApiKey is required");
+    }
+  }
+
+  async measureTokensCount(content: string): Promise<number> {
+    // Implement token counting logic here
+    const ai = new GoogleGenAI({
+      apiKey: this.options.geminiApiKey,
+    });
+    const countTokensResponse = await ai.models.countTokens({
+      model: "gemini-2.0-flash",
+      contents: content,
+    });
+
+    return countTokensResponse.totalTokens;
+  }
+
+  getLangChainAgentSpec(params: {
+    maxTokens: number;
+    purpose: AgentModelPurpose;
+  }) {
+    const modelOptions = getGoogleLangChainAgentOptions(
+      this.options.extraRequestBodyParameters,
+    );
+
+    return {
+      model: new ChatGoogleGenerativeAI({
+        model: this.options.model || "gemini-3-flash-preview",
+        apiKey: this.options.geminiApiKey,
+        maxOutputTokens: params.maxTokens,
+        ...modelOptions,
+      } as any),
+    };
+  }
+
+
+  complete = async (
+    requestOrContent: CompletionRequestInput | string,
+    stopOrMaxTokens: string[] | number = 50,
+    maxTokensOrOutputSchema: number | any = 50,
+    outputSchema?: any,
+  ): Promise<{
+    content?: string;
+    finishReason?: string;
+    error?: string;
+  }> => {
+    const request =
+      typeof requestOrContent === "string"
+        ? {
+            content: requestOrContent,
+            maxTokens:
+              typeof stopOrMaxTokens === "number"
+                ? stopOrMaxTokens
+                : typeof maxTokensOrOutputSchema === "number"
+                  ? maxTokensOrOutputSchema
+                  : 50,
+            outputSchema:
+              typeof stopOrMaxTokens === "number"
+                ? maxTokensOrOutputSchema
+                : outputSchema,
+          }
+        : requestOrContent;
+    const {
+      content,
+      maxTokens: requestMaxTokens = 50,
+      outputSchema: requestOutputSchema,
+    } = request;
+
+    const ai = new GoogleGenAI({
+      apiKey: this.options.geminiApiKey,
+    });
+
+    const tryToGenerate = async () => {
+      logger.debug("Making Google Gemini API call");
+      try {
+        const response = await ai.models.generateContent({
+          model: this.options.model || "gemini-3-flash-preview",
+          contents: content,
+          config: {
+            responseJsonSchema: requestOutputSchema ? requestOutputSchema : undefined,
+            maxOutputTokens: requestMaxTokens,
+            ...this.options.extraRequestBodyParameters,
+          },
+        });
+        logger.debug(`Google Gemini SUCCESSFUL API response: ${response}`);
+        return {
+          content: response.text,
+        };
+      } catch (error) {
+        logger.error(`Error during Google Gemini API call: ${error}`);
+        throw new Error(`Error during Google Gemini API call: ${JSON.parse(error.message).error.message}`);
+      }
+    }
+    const result = await pRetry(tryToGenerate, {
+      retries: 5,
+      onFailedAttempt: ({error, attemptNumber, retriesLeft, retriesConsumed}) => {
+        logger.debug(`Attempt ${attemptNumber} failed. ${retriesLeft} retries left. ${retriesConsumed} retries consumed.`);
+      },
+    })
+    return result;
+  };
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@adminforth/completion-adapter-google-gemini",
+  "version": "1.0.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "keywords": [],
+  "author": "DevForth (https://devforth.io)",
+  "license": "MIT",
+  "description": "",
+  "dependencies": {
+    "@google/genai": "^1.35.0",
+    "@langchain/google-genai": "2.1.27",
+    "p-retry": "^7.1.1"
+  },
+  "peerDependencies": {
+    "adminforth": "^2.24.0"
+  },
+  "release": {
+    "plugins": [
+      "@semantic-release/commit-analyzer",
+      "@semantic-release/release-notes-generator",
+      "@semantic-release/npm",
+      "@semantic-release/github",
+      [
+        "semantic-release-slack-bot",
+        {
+          "packageName": "@adminforth/completion-adapter-google-gemini",
+          "notifyOnSuccess": true,
+          "notifyOnFail": true,
+          "slackIcon": ":package:",
+          "markdownReleaseNotes": true
+        }
+      ]
+    ],
+    "branches": [
+      "main",
+      {
+        "name": "next",
+        "prerelease": true
+      }
+    ]
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "semantic-release": "^24.2.1",
+    "semantic-release-slack-bot": "^4.0.2"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "es2016",                                  /* Set the JavaScript language version for emitted JavaScript and include*/ 
+    "module": "node16",                                /* Specify what module code is generated. */
+    "outDir": "./dist",                                   /* Specify an output folder for all emitted files. */
+    "esModuleInterop": true,                             /* Emit additional JavaScript to ease support for importing CommonJS modules.  */
+    "forceConsistentCasingInFileNames": true,            /* Ensure that casing is correct in imports. */
+    "strict": false,                                     /* Enable all strict type-checking options. */
+    "skipLibCheck": true,                                 /* Skip type checking all .d.ts files. */
+  },
+  "exclude": ["node_modules", "dist", "custom"],           /* Exclude files from compilation. */
+}

package/types.ts

@@ -0,0 +1,19 @@
+export interface AdapterOptions {
+  /**
+   * Google API key. Go to https://aistudio.google.com/api-keys, go to Dashboard -> API keys -> Create new secret key
+   * Set geminiApiKey: process.env.GEMINI_API_KEY to access it
+   */
+  geminiApiKey: string;
+
+  /**
+   * Model name. Go to https://ai.google.dev/gemini-api/docs/models, select model and copy name.
+   * Default is `gemini-3-flash-preview`. Use e.g. more expensive `gemini-3-pro-preview` for more powerful model.
+   */
+  model?: string;
+
+
+  /**
+   * Additional request body parameters to include in the API request.
+   */
+  extraRequestBodyParameters?: Record<string, unknown>;
+}