@omnikit-ai/sdk 2.0.8 → 2.0.10

package/dist/index.d.mts

@@ -229,12 +229,12 @@ interface LLMMessage {
     }>;
 }
 /**
- * Available LLM models for InvokeLLM
- * - 'gemini-flash': Fast and cost-effective (default)
- * - 'gemini-pro': Smarter with extended thinking (128 token thinking budget)
- * - 'gemini-pro-3': Gemini 3 Pro Preview with low thinking effort
+ * Available LLM models:
+ * - Gemini 2.5: 'gemini-2.5-flash-lite' (fastest), 'gemini-2.5-flash', 'gemini-2.5-pro'
+ * - Gemini 3: 'gemini-3-flash' (best multimodal), 'gemini-3-pro' (advanced reasoning)
+ * - Legacy aliases: 'gemini-flash', 'gemini-pro', 'gemini-pro-3' (for backward compatibility)
  */
-type LLMModel = 'gemini-flash' | 'gemini-pro' | 'gemini-pro-3';
+type LLMModel = 'gemini-2.5-flash-lite' | 'gemini-2.5-flash' | 'gemini-2.5-pro' | 'gemini-3-flash' | 'gemini-3-pro' | 'gemini-flash' | 'gemini-pro' | 'gemini-pro-3';
 interface LLMParams {
     /** Message-based format for advanced use */
     messages?: LLMMessage[];
@@ -254,10 +254,11 @@ interface LLMParams {
         type: 'json_object';
     } | Record<string, any>;
     /**
-     * Model to use for LLM processing
-     * - 'gemini-flash': Fast and cost-effective (default)
-     * - 'gemini-pro': Smarter with extended thinking for complex reasoning
-     * - 'gemini-pro-3': Gemini 3 Pro Preview with low thinking effort
+     * Model to use for LLM processing.
+     * Defaults: 'gemini-2.5-flash-lite' for text, 'gemini-3-flash' for files/images.
+     * - 'gemini-2.5-flash-lite': Fastest, best for simple text tasks
+     * - 'gemini-3-flash': Best multimodal (images, PDFs, videos)
+     * - 'gemini-2.5-pro' / 'gemini-3-pro': Advanced reasoning
      */
     model?: LLMModel | string;
     /**
@@ -1186,6 +1187,11 @@ declare class APIClient implements OmnikitClient {
     private _metadataListeners;
     private _userListeners;
     constructor(config: OmnikitConfig);
+    /**
+     * Initialize built-in services with their definitions
+     * These services don't require backend schema - they're defined in the SDK
+     */
+    private initializeBuiltInServices;
     /**
      * Load metadata from localStorage cache, falling back to initial config
      * Guards localStorage access for Deno/Node compatibility

package/dist/index.d.ts

@@ -229,12 +229,12 @@ interface LLMMessage {
     }>;
 }
 /**
- * Available LLM models for InvokeLLM
- * - 'gemini-flash': Fast and cost-effective (default)
- * - 'gemini-pro': Smarter with extended thinking (128 token thinking budget)
- * - 'gemini-pro-3': Gemini 3 Pro Preview with low thinking effort
+ * Available LLM models:
+ * - Gemini 2.5: 'gemini-2.5-flash-lite' (fastest), 'gemini-2.5-flash', 'gemini-2.5-pro'
+ * - Gemini 3: 'gemini-3-flash' (best multimodal), 'gemini-3-pro' (advanced reasoning)
+ * - Legacy aliases: 'gemini-flash', 'gemini-pro', 'gemini-pro-3' (for backward compatibility)
  */
-type LLMModel = 'gemini-flash' | 'gemini-pro' | 'gemini-pro-3';
+type LLMModel = 'gemini-2.5-flash-lite' | 'gemini-2.5-flash' | 'gemini-2.5-pro' | 'gemini-3-flash' | 'gemini-3-pro' | 'gemini-flash' | 'gemini-pro' | 'gemini-pro-3';
 interface LLMParams {
     /** Message-based format for advanced use */
     messages?: LLMMessage[];
@@ -254,10 +254,11 @@ interface LLMParams {
         type: 'json_object';
     } | Record<string, any>;
     /**
-     * Model to use for LLM processing
-     * - 'gemini-flash': Fast and cost-effective (default)
-     * - 'gemini-pro': Smarter with extended thinking for complex reasoning
-     * - 'gemini-pro-3': Gemini 3 Pro Preview with low thinking effort
+     * Model to use for LLM processing.
+     * Defaults: 'gemini-2.5-flash-lite' for text, 'gemini-3-flash' for files/images.
+     * - 'gemini-2.5-flash-lite': Fastest, best for simple text tasks
+     * - 'gemini-3-flash': Best multimodal (images, PDFs, videos)
+     * - 'gemini-2.5-pro' / 'gemini-3-pro': Advanced reasoning
      */
     model?: LLMModel | string;
     /**
@@ -1186,6 +1187,11 @@ declare class APIClient implements OmnikitClient {
     private _metadataListeners;
     private _userListeners;
     constructor(config: OmnikitConfig);
+    /**
+     * Initialize built-in services with their definitions
+     * These services don't require backend schema - they're defined in the SDK
+     */
+    private initializeBuiltInServices;
     /**
      * Load metadata from localStorage cache, falling back to initial config
      * Guards localStorage access for Deno/Node compatibility

package/dist/index.js

@@ -437,6 +437,14 @@ var LiveVoiceSessionImpl = class {
 
 // src/client.ts
 var LLM_MODEL_MAP = {
+  // Gemini 2.5 models
+  "gemini-2.5-flash-lite": "vertex_ai/gemini-2.5-flash-lite",
+  "gemini-2.5-flash": "vertex_ai/gemini-2.5-flash",
+  "gemini-2.5-pro": "vertex_ai/gemini-2.5-pro",
+  // Gemini 3 models
+  "gemini-3-flash": "vertex_ai/gemini-3-flash-preview",
+  "gemini-3-pro": "vertex_ai/gemini-3-pro-preview",
+  // Legacy aliases (for backward compatibility)
   "gemini-flash": "vertex_ai/gemini-2.5-flash",
   "gemini-pro": "vertex_ai/gemini-2.5-pro",
   "gemini-pro-3": "vertex_ai/gemini-3-pro-preview"
@@ -521,10 +529,96 @@ var APIClient = class {
         this.userToken = detectedToken;
       }
     }
+    this.initializeBuiltInServices();
     this.ensureInitialized().catch((err) => {
       console.warn("[Omnikit SDK] Background initialization failed:", err);
     });
   }
+  /**
+   * Initialize built-in services with their definitions
+   * These services don't require backend schema - they're defined in the SDK
+   */
+  initializeBuiltInServices() {
+    const builtInServices = [
+      {
+        name: "SendEmail",
+        path: "/services/email",
+        description: "Send an email",
+        method: "POST",
+        params: { to: "string", subject: "string", body: "string" }
+      },
+      {
+        name: "InvokeLLM",
+        path: "/services/llm",
+        description: "Invoke a language model",
+        method: "POST",
+        params: { messages: "array", model: "string" }
+      },
+      {
+        name: "GenerateImage",
+        path: "/services/images",
+        description: "Generate an image from a prompt",
+        method: "POST",
+        async: true,
+        params: { prompt: "string" }
+      },
+      {
+        name: "GenerateSpeech",
+        path: "/services/speech",
+        description: "Generate speech from text",
+        method: "POST",
+        async: true,
+        params: { text: "string" }
+      },
+      {
+        name: "GenerateVideo",
+        path: "/services/video",
+        description: "Generate a video from a prompt",
+        method: "POST",
+        async: true,
+        params: { prompt: "string" }
+      },
+      {
+        name: "ExtractData",
+        path: "/services/extract-text",
+        description: "Extract structured data from text or files",
+        method: "POST",
+        async: true,
+        params: { file_url: "string" }
+      },
+      {
+        name: "SendSMS",
+        path: "/services/sms",
+        description: "Send an SMS message",
+        method: "POST",
+        params: { to: "string", body: "string" }
+      },
+      {
+        name: "UploadFile",
+        path: "/services/files",
+        description: "Upload a file (public)",
+        method: "POST",
+        params: { file: "File" }
+      },
+      {
+        name: "UploadPrivateFile",
+        path: "/services/files/private",
+        description: "Upload a private file",
+        method: "POST",
+        params: { file: "File" }
+      },
+      {
+        name: "CreateFileSignedUrl",
+        path: "/services/files/signed-url",
+        description: "Create a signed URL for a private file",
+        method: "POST",
+        params: { file_uri: "string" }
+      }
+    ];
+    builtInServices.forEach((service) => {
+      this._services[service.name] = this.createServiceMethod(service);
+    });
+  }
   /**
    * Load metadata from localStorage cache, falling back to initial config
    * Guards localStorage access for Deno/Node compatibility
@@ -1183,51 +1277,11 @@ Example: await ${collectionName}.list({ limit: 100, sort: '-created_at' })`,
             if (method) {
               response = await method(params, useServiceToken);
             } else {
-              const servicePathMap = {
-                "SendEmail": "services/email",
-                "InvokeLLM": "services/llm",
-                "GenerateImage": "services/images",
-                "GenerateSpeech": "services/speech",
-                "GenerateVideo": "services/video",
-                "ExtractData": "services/extract-text",
-                "SendSMS": "services/sms",
-                "UploadFile": "services/files",
-                "UploadPrivateFile": "services/files/private/init",
-                "CreateFileSignedUrl": "services/files/signed-url"
-              };
-              const servicePath = servicePathMap[normalizedName];
-              if (!servicePath) {
-                throw new OmnikitError(
-                  `Service '${serviceName}' not found. Known services: ${Object.keys(servicePathMap).join(", ")} (camelCase also supported)`,
-                  404,
-                  "SERVICE_NOT_FOUND"
-                );
-              }
-              const headers = {
-                "Content-Type": "application/json"
-              };
-              if (client._apiKey) {
-                headers["X-API-Key"] = client._apiKey;
-              } else if (client.userToken) {
-                headers["Authorization"] = `Bearer ${client.userToken}`;
-              }
-              const fetchResponse = await fetch(
-                `${client.baseUrl}/apps/${client.appId}/${servicePath}`,
-                {
-                  method: "POST",
-                  headers,
-                  body: JSON.stringify(params || {})
-                }
+              throw new OmnikitError(
+                `Service '${serviceName}' not found. Known services: SendEmail, InvokeLLM, GenerateImage, GenerateSpeech, GenerateVideo, ExtractData, SendSMS, UploadFile, UploadPrivateFile, CreateFileSignedUrl (camelCase also supported)`,
+                404,
+                "SERVICE_NOT_FOUND"
               );
-              if (!fetchResponse.ok) {
-                const error = await fetchResponse.json().catch(() => ({}));
-                throw new OmnikitError(
-                  error.detail || `Service call failed: ${fetchResponse.statusText}`,
-                  fetchResponse.status,
-                  "SERVICE_CALL_FAILED"
-                );
-              }
-              response = await fetchResponse.json();
             }
             if (response && response.async && response.job_id) {
               if (asyncOptions?.returnJobId) {