@vdegenne/gemini 0.1.1

package/lib/index.d.ts

@@ -0,0 +1,31 @@
+import { Type } from '@google/genai';
+export declare const geminiModels: readonly ['gemini-3.5-flash', 'gemini-3.1-flash-lite', 'gemini-2.5-pro', 'gemini-2.5-flash-lite', 'gemini-2.5-flash'];
+export type GeminiModel = (typeof geminiModels)[number];
+type GeminiSchema = {
+    [k: string]: any;
+};
+type GeminiOptionsBase = {
+    apiKey: string;
+    model: GeminiModel;
+    systemInstruction?: string | string[];
+    previousInteractionId?: string;
+    thinkingLevel?: 'minimal' | 'low' | 'medium' | 'high';
+    debug?: boolean;
+};
+export declare class RateLimitError extends Error {
+    constructor(message?: string);
+}
+export declare function askGemini<T extends object>(input: string, options: GeminiOptionsBase & {
+    schema: GeminiSchema;
+}): Promise<{
+    output: T | undefined;
+    previousInteractionId: string;
+}>;
+export declare function askGemini(input: string, options: GeminiOptionsBase & {
+    schema?: undefined;
+}): Promise<{
+    output: string | undefined;
+    previousInteractionId: string;
+}>;
+export { Type };
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,IAAI,EAAC,MAAM,eAAe,CAAA;AAE/C,eAAO,MAAM,YAAY,YACxB,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,CACT,CAAA;AACV,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvD,KAAK,YAAY,GAAG;IACnB,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;CAChB,CAAA;AAED,KAAK,iBAAiB,GAAG;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,WAAW,CAAA;IAClB,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACrC,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,aAAa,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;IACrD,KAAK,CAAC,EAAE,OAAO,CAAA;CACf,CAAA;AAED,qBAAa,cAAe,SAAQ,KAAK;IACxC,YAAY,OAAO,SAA+B,EAGjD;CACD;AAgBD,wBAAsB,SAAS,CAAC,CAAC,SAAS,MAAM,EAC/C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,iBAAiB,GAAG;IAC5B,MAAM,EAAE,YAAY,CAAA;CACpB,GACC,OAAO,CAAC;IACV,MAAM,EAAE,CAAC,GAAG,SAAS,CAAA;IACrB,qBAAqB,EAAE,MAAM,CAAA;CAC7B,CAAC,CAAA;AAEF,wBAAsB,SAAS,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,iBAAiB,GAAG;IAC5B,MAAM,CAAC,EAAE,SAAS,CAAA;CAClB,GACC,OAAO,CAAC;IACV,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,qBAAqB,EAAE,MAAM,CAAA;CAC7B,CAAC,CAAA;AA6FF,OAAO,EAAC,IAAI,EAAC,CAAA"}

package/lib/index.js

@@ -0,0 +1,97 @@
+import { GoogleGenAI, Type } from '@google/genai';
+export const geminiModels = [
+    'gemini-3.5-flash', //
+    'gemini-3.1-flash-lite',
+    'gemini-2.5-pro',
+    'gemini-2.5-flash-lite',
+    'gemini-2.5-flash',
+];
+export class RateLimitError extends Error {
+    constructor(message = 'Gemini rate limit exceeded') {
+        super(message);
+        this.name = 'RateLimitError';
+    }
+}
+function isRateLimitError(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    return (error.status === 429 ||
+        error.code === 429 ||
+        error.message.toLowerCase().includes('rate limit') ||
+        error.message.toLowerCase().includes('quota') ||
+        error.message.toLowerCase().includes('resource exhausted'));
+}
+export async function askGemini(input, options) {
+    const { apiKey, model, thinkingLevel: thinking_level = 'medium', systemInstruction, previousInteractionId: previous_interaction_id, schema, debug, } = options;
+    const ai = new GoogleGenAI({ apiKey });
+    const system_instruction = Array.isArray(systemInstruction)
+        ? systemInstruction
+            .map((instruction) => instruction.trim())
+            .filter(Boolean)
+            .join('\n')
+        : systemInstruction?.trim();
+    const generation_config = {
+        max_output_tokens: 65536,
+        thinking_level,
+    };
+    if (debug) {
+        console.log(`
+=======================
+Gemini request
+=======================
+input:
+${input}
+
+model:
+${model}
+
+thinking level:
+${thinking_level}
+
+previous interaction id:
+${previous_interaction_id ?? 'none'}
+
+system instruction:
+${system_instruction ?? 'none'}
+
+schema:
+${schema ? JSON.stringify(schema, null, 2) : 'none'}
+=======================
+`);
+    }
+    try {
+        const response = await ai.interactions.create({
+            previous_interaction_id,
+            model,
+            generation_config,
+            input,
+            system_instruction,
+            ...(schema
+                ? {
+                    response_format: {
+                        type: 'text',
+                        mime_type: 'application/json',
+                        schema,
+                    },
+                }
+                : {}),
+        });
+        return {
+            output: response.output_text
+                ? schema
+                    ? JSON.parse(response.output_text)
+                    : response.output_text
+                : undefined,
+            previousInteractionId: response.id,
+        };
+    }
+    catch (error) {
+        if (isRateLimitError(error)) {
+            throw new RateLimitError();
+        }
+        throw error;
+    }
+}
+export { Type };
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,39 @@
+{
+	"name": "@vdegenne/gemini",
+	"version": "0.1.1",
+	"description": "",
+	"type": "module",
+	"exports": {
+		".": {
+			"import": "./lib/index.js",
+			"types": "./lib/index.d.ts"
+		}
+	},
+	"files": [
+		"./lib/"
+	],
+	"scripts": {
+		"build": "wireit"
+	},
+	"devDependencies": {
+		"typescript": "^7.0.2",
+		"wireit": "^0.14.13"
+	},
+	"wireit": {
+		"build": {
+			"command": "tsc --pretty",
+			"clean": "if-file-deleted",
+			"files": [
+				"./tsconfig.json",
+				"./src"
+			],
+			"output": [
+				"./lib"
+			]
+		}
+	},
+	"dependencies": {
+		"@google/genai": "^2.12.0",
+		"@modelcontextprotocol/sdk": "^1.29.0"
+	}
+}