@mate-academy/llm-gateway 8.8.2 → 8.8.3

package/dist/providers/GoogleGenerativeAI/schemas/GoogleSchemaAdapter.d.ts

@@ -0,0 +1,12 @@
+import type { SchemaAdapterInterface } from '../../../utilities/schema';
+/**
+ * Schema adapter for Google Generative AI provider.
+ * Converts JSON Schema to Google's Type-based format.
+ */
+export declare class GoogleSchemaAdapter implements SchemaAdapterInterface {
+    convertSchema(jsonSchema: any): any;
+    /**
+     * Converts JSON Schema to Google's Type-based format
+     */
+    private convertJsonSchemaToGoogleFormat;
+}

package/dist/providers/GoogleGenerativeAI/schemas/GoogleSchemaAdapter.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoogleSchemaAdapter = void 0;
+const genai_1 = require("@google/genai");
+/**
+ * Schema adapter for Google Generative AI provider.
+ * Converts JSON Schema to Google's Type-based format.
+ */
+class GoogleSchemaAdapter {
+    convertSchema(jsonSchema) {
+        return this.convertJsonSchemaToGoogleFormat(jsonSchema);
+    }
+    /**
+     * Converts JSON Schema to Google's Type-based format
+     */
+    convertJsonSchemaToGoogleFormat(jsonSchema) {
+        // Handle null type
+        if (jsonSchema.type === 'null') {
+            return { type: genai_1.Type.STRING, nullable: true };
+        }
+        // Handle arrays with anyOf (for unions)
+        if (jsonSchema.anyOf) {
+            // For now, we'll use the first type in the union
+            // This is a simplification - full union support would be more complex
+            return this.convertJsonSchemaToGoogleFormat(jsonSchema.anyOf[0]);
+        }
+        // Handle objects
+        if (jsonSchema.type === 'object') {
+            const properties = {};
+            const required = jsonSchema.required || [];
+            for (const [key, value] of Object.entries(jsonSchema.properties || {})) {
+                const convertedProperty = this.convertJsonSchemaToGoogleFormat(value);
+                properties[key] = convertedProperty;
+            }
+            return {
+                type: genai_1.Type.OBJECT,
+                properties,
+                required,
+                propertyOrdering: Object.keys(properties),
+            };
+        }
+        // Handle arrays
+        if (jsonSchema.type === 'array') {
+            return {
+                type: genai_1.Type.ARRAY,
+                items: this.convertJsonSchemaToGoogleFormat(jsonSchema.items || {}),
+            };
+        }
+        // Handle strings
+        if (jsonSchema.type === 'string') {
+            if (jsonSchema.enum) {
+                return {
+                    type: genai_1.Type.STRING,
+                    enum: jsonSchema.enum,
+                };
+            }
+            return { type: genai_1.Type.STRING };
+        }
+        // Handle numbers
+        if (jsonSchema.type === 'number' || jsonSchema.type === 'integer') {
+            return { type: genai_1.Type.NUMBER };
+        }
+        // Handle booleans
+        if (jsonSchema.type === 'boolean') {
+            return { type: genai_1.Type.BOOLEAN };
+        }
+        // Default fallback
+        return { type: genai_1.Type.STRING };
+    }
+}
+exports.GoogleSchemaAdapter = GoogleSchemaAdapter;
+//# sourceMappingURL=GoogleSchemaAdapter.js.map

package/dist/providers/GoogleGenerativeAI/schemas/GoogleSchemaAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleSchemaAdapter.js","sourceRoot":"","sources":["../../../../src/providers/GoogleGenerativeAI/schemas/GoogleSchemaAdapter.ts"],"names":[],"mappings":";;;AAAA,yCAAqC;AAGrC;;;GAGG;AACH,MAAa,mBAAmB;IAC9B,aAAa,CAAC,UAAe;QAC3B,OAAO,IAAI,CAAC,+BAA+B,CAAC,UAAU,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACK,+BAA+B,CAAC,UAAe;QACrD,mBAAmB;QACnB,IAAI,UAAU,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC/B,OAAO,EAAE,IAAI,EAAE,YAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC/C,CAAC;QAED,wCAAwC;QACxC,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,iDAAiD;YACjD,sEAAsE;YACtE,OAAO,IAAI,CAAC,+BAA+B,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,CAAC;QAED,iBAAiB;QACjB,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,UAAU,GAAwB,EAAE,CAAC;YAC3C,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC;YAE3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;gBACvE,MAAM,iBAAiB,GAAG,IAAI,CAAC,+BAA+B,CAAC,KAAK,CAAC,CAAC;gBACtE,UAAU,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC;YACtC,CAAC;YAED,OAAO;gBACL,IAAI,EAAE,YAAI,CAAC,MAAM;gBACjB,UAAU;gBACV,QAAQ;gBACR,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;aAC1C,CAAC;QACJ,CAAC;QAED,gBAAgB;QAChB,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAChC,OAAO;gBACL,IAAI,EAAE,YAAI,CAAC,KAAK;gBAChB,KAAK,EAAE,IAAI,CAAC,+BAA+B,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC;aACpE,CAAC;QACJ,CAAC;QAED,iBAAiB;QACjB,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACjC,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;gBACpB,OAAO;oBACL,IAAI,EAAE,YAAI,CAAC,MAAM;oBACjB,IAAI,EAAE,UAAU,CAAC,IAAI;iBACtB,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,YAAI,CAAC,MAAM,EAAE,CAAC;QAC/B,CAAC;QAED,iBAAiB;QACjB,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAClE,OAAO,EAAE,IAAI,EAAE,YAAI,CAAC,MAAM,EAAE,CAAC;QAC/B,CAAC;QAED,kBAAkB;QAClB,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,EAAE,IAAI,EAAE,YAAI,CAAC,OAAO,EAAE,CAAC;QAChC,CAAC;QAED,mBAAmB;QACnB,OAAO,EAAE,IAAI,EAAE,YAAI,CAAC,MAAM,EAAE,CAAC;IAC/B,CAAC;CACF;AAvED,kDAuEC"}

package/dist/providers/GoogleGenerativeAI/services/GoogleGenerativeAIAssistance.service.d.ts

@@ -0,0 +1,71 @@
+import { GoogleGenAI } from '@google/genai';
+import { type LLMAssistanceOptions, type LLMAssistanceResult, type LLMAssistanceMessage, type LLMCreateChatOptions, type LLMCreateChatResult, type LLMCreateFileStorageOptions, type LLMCreateFileStorageResult, type LLMInstanceOptions, type LLMModel, LLMProviders, type LLMUploadedFile, type LLMUploadFileOptions, type LLMUploadFileResult, type LLMStructuredResult } from '../../../LLMService.typedefs';
+import { type LLMLoggerInterface } from '../../../utilities/logger';
+import { type LLMReporterInterface } from '../../../utilities/reporter';
+import { LLMAssistanceService } from '../../../services';
+import { type LLMSchemaInterface } from '../../../utilities/schema';
+export declare class GoogleGenerativeAIAssistanceService<Reporter extends LLMReporterInterface<any> | undefined> extends LLMAssistanceService<LLMProviders.GoogleGenerativeAI, Reporter> {
+    private cachedContent;
+    private chatSessions;
+    private uploadedFiles;
+    private uncachedFileStorages;
+    private chatInstructions;
+    constructor(logger: LLMLoggerInterface | undefined, reporter: Reporter, options?: LLMInstanceOptions[LLMProviders.GoogleGenerativeAI]);
+    get instance(): GoogleGenAI;
+    uploadFile(fileOptions: LLMUploadFileOptions<Reporter>): Promise<LLMUploadFileResult>;
+    getFile(path: string): Promise<LLMUploadedFile | null>;
+    deleteFile(fileId: string): Promise<void>;
+    createFileStorage(options: LLMCreateFileStorageOptions<LLMProviders.GoogleGenerativeAI, Reporter>): Promise<LLMCreateFileStorageResult>;
+    deleteFileStorage(fileStorageId: string): Promise<void>;
+    createChat(options: LLMCreateChatOptions<LLMProviders.GoogleGenerativeAI, Reporter>): Promise<LLMCreateChatResult>;
+    deleteChat(chatId: string): Promise<void>;
+    private getStorageFileParts;
+    protected assistInChatText(options: LLMAssistanceOptions<LLMProviders.GoogleGenerativeAI, Reporter>): Promise<LLMAssistanceResult>;
+    protected assistInChatStructured(options: LLMAssistanceOptions<LLMProviders.GoogleGenerativeAI, Reporter> & {
+        schema: LLMSchemaInterface;
+    }): Promise<LLMStructuredResult>;
+    private prepareChatMessage;
+    private sendStructuredFollowUp;
+    /**
+     * The conversation one round was sent with: the chat's system instruction,
+     * the history the SDK holds for the session, and the parts this round adds.
+     * Built before the request goes out so a round that throws traces the same
+     * transcript a successful one does.
+     */
+    private buildRoundConversation;
+    /**
+     * One round's usage, mapped exactly as the run total is mapped for metrics,
+     * so the per-round generations add up to the single metrics point the run
+     * still writes.
+     */
+    private buildUsageMetrics;
+    private readonly buildRoundOutcome;
+    private extractUsageFromResponse;
+    private combineUsage;
+    private convertCustomToolsToGoogle;
+    private executeGoogleToolLoop;
+    /**
+     * The visible assistant text a continuing tool-loop round produced, joined
+     * from the response's text parts. Thinking parts (`part.thought`) are
+     * excluded so only the visible narration channel is surfaced.
+     */
+    private extractVisibleToolRoundText;
+    private executeGoogleFunctionCalls;
+    private buildFunctionResponseParts;
+    private executeSingleGoogleFunctionCall;
+    /**
+     * Gemini 3 models accept image bytes inside `functionResponse.parts`. Each
+     * image blob carries a unique `displayName` the `response` payload then
+     * references via `{ $ref: displayName }`.
+     */
+    private buildNativeFunctionResponsePart;
+    /**
+     * Gemini 2.5 models cannot carry images in a function response, so image
+     * bytes are appended as sibling user-content parts after every function
+     * response in the same message.
+     */
+    private buildAppendedFunctionResponseParts;
+    private buildInlineImageParts;
+    private fetchToolImageBlob;
+    countTokens(messages: LLMAssistanceMessage[], model: LLMModel<LLMProviders.GoogleGenerativeAI>): Promise<number>;
+}