@llumiverse/common 0.22.1 → 0.23.0-dev-20251118

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@llumiverse/common",
-    "version": "0.22.1",
+    "version": "0.23.0-dev-20251118",
     "type": "module",
     "description": "Public types, enums and options used by Llumiverse API.",
     "files": [
@@ -68,11 +68,11 @@
         "url": "git+ssh://git@github.com/vertesia/llumiverse.git"
     },
     "devDependencies": {
-        "rimraf": "^6.0.1",
+        "rimraf": "^6.1.0",
         "ts-dual-module": "^0.6.3",
-        "typescript": "^5.9.2",
+        "typescript": "^5.9.3",
         "vitest": "^3.2.4",
-        "@types/node": "^22.17.1"
+        "@types/node": "^22.19.0"
     },
     "dependencies": {},
     "ts_dual_module": {

package/src/options/vertexai.ts

@@ -246,6 +246,50 @@ function getImagenOptions(model: string, option?: ModelOptions): ModelOptionsInf
 }
 
 function getGeminiOptions(model: string, _option?: ModelOptions): ModelOptionsInfo {
+    // Special handling for gemini-2.5-flash-image
+    if (model.includes("gemini-2.5-flash-image")) {
+        const options: ModelOptionInfoItem[] = [
+            {
+                name: SharedOptions.temperature,
+                type: OptionType.numeric,
+                min: 0.0,
+                max: 2.0,
+                default: 0.7,
+                step: 0.01,
+                description: "Sampling temperature"
+            },
+            {
+                name: SharedOptions.top_p,
+                type: OptionType.numeric,
+                min: 0.0,
+                max: 1.0,
+                step: 0.01,
+                description: "Nucleus sampling probability"
+            },
+            {
+                name: "candidate_count",
+                type: OptionType.numeric,
+                min: 1,
+                max: 8,
+                default: 1,
+                integer: true,
+                description: "Number of candidates to generate"
+            },
+            {
+                name: SharedOptions.max_tokens,
+                type: OptionType.numeric,
+                min: 1,
+                max: 32768,
+                integer: true,
+                step: 200,
+                description: "Maximum output tokens"
+            }
+        ];
+        return {
+            _option_id: "vertexai-gemini",
+            options
+        };
+    }
     // Special handling for gemini-2.5-flash-image
     if (model.includes("gemini-2.5-flash-image")) {
         const max_tokens_limit = 32768;

package/src/types.ts

@@ -252,11 +252,24 @@ export interface CompletionStream<PromptT = any> extends AsyncIterable<string> {
     completion: ExecutionResponse<PromptT> | undefined;
 }
 
+/**
+ * Minimal logger interface for LLM drivers.
+ * Follows pino v10 signature: supports message-only or object-first (never message-first).
+ * - Message-only: logger.info("message")
+ * - Object-first: logger.info({ data }, "message")
+ * - PREVENTS: logger.info("message", { data }) - compile error (objects not allowed in ...args)
+ * 
+ * Additional args must be primitives (string | number | boolean) for string interpolation.
+ */
 export interface Logger {
-    debug: (...obj: any[]) => void;
-    info: (...obj: any[]) => void;
-    warn: (...obj: any[]) => void;
-    error: (...obj: any[]) => void;
+    debug(msg: string, ...args: (string | number | boolean)[]): void;
+    debug<T>(obj: T, msg?: T extends string ? never : string, ...args: (string | number | boolean)[]): void;
+    info(msg: string, ...args: (string | number | boolean)[]): void;
+    info<T>(obj: T, msg?: T extends string ? never : string, ...args: (string | number | boolean)[]): void;
+    warn(msg: string, ...args: (string | number | boolean)[]): void;
+    warn<T>(obj: T, msg?: T extends string ? never : string, ...args: (string | number | boolean)[]): void;
+    error(msg: string, ...args: (string | number | boolean)[]): void;
+    error<T>(obj: T, msg?: T extends string ? never : string, ...args: (string | number | boolean)[]): void;
 }
 
 export interface DriverOptions {