@ancatag/n-r 0.2.18 → 0.2.19

package/dist/chat.d.ts

@@ -2,14 +2,14 @@
  * Chat Completions API
  * Handles chat completion requests (streaming and non-streaming)
  */
-import { GrpcClient } from "./grpc-client.js";
 import { HttpClient } from "./http-client.js";
-import type { ChatCompletionChunk, ChatCompletionRequest, ChatCompletionResponse } from "./types.js";
+import type { ChatCompletionChunk, ChatCompletionRequest, ChatCompletionResponse, NovaClientConfig } from "./types.js";
 export declare class ChatCompletions {
     private readonly httpClient;
-    private readonly grpcClient?;
-    constructor(httpClient: HttpClient, grpcClient?: GrpcClient | undefined);
-    private isGrpc;
+    private readonly config;
+    private grpcClientInstance?;
+    constructor(httpClient: HttpClient, config: NovaClientConfig);
+    private getGrpcClient;
     /**
      * Create a chat completion (non-streaming)
      */

package/dist/chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EACX,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,MAAM,YAAY,CAAC;AAEpB,qBAAa,eAAe;IAE1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBADX,UAAU,EAAE,UAAU,EACtB,UAAU,CAAC,EAAE,UAAU,YAAA;IAGzC,OAAO,CAAC,MAAM;IAId;;OAEG;IACG,MAAM,CACX,OAAO,EAAE,qBAAqB,GAC5B,OAAO,CAAC,sBAAsB,CAAC;IAqBlC;;;OAGG;IACI,YAAY,CAClB,OAAO,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,WAAW,GAClB,cAAc,CAAC,mBAAmB,EAAE,IAAI,EAAE,OAAO,CAAC;CA2DrD"}
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EACX,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,MAAM,YAAY,CAAC;AAEpB,qBAAa,eAAe;IAG1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHxB,OAAO,CAAC,kBAAkB,CAAC,CAAa;gBAEtB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,gBAAgB;YAG5B,aAAa;IAW3B;;OAEG;IACG,MAAM,CACX,OAAO,EAAE,qBAAqB,GAC5B,OAAO,CAAC,sBAAsB,CAAC;IAsBlC;;;OAGG;IACI,YAAY,CAClB,OAAO,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,WAAW,GAClB,cAAc,CAAC,mBAAmB,EAAE,IAAI,EAAE,OAAO,CAAC;CA4DrD"}

package/dist/chat.js

@@ -4,20 +4,29 @@
  */
 export class ChatCompletions {
     httpClient;
-    grpcClient;
-    constructor(httpClient, grpcClient) {
+    config;
+    grpcClientInstance;
+    constructor(httpClient, config) {
         this.httpClient = httpClient;
-        this.grpcClient = grpcClient;
+        this.config = config;
     }
-    isGrpc() {
-        return Boolean(this.grpcClient);
+    async getGrpcClient() {
+        if (this.config.transport !== "grpc") {
+            return undefined;
+        }
+        if (!this.grpcClientInstance) {
+            const { GrpcClient } = await import("./grpc-client.js");
+            this.grpcClientInstance = new GrpcClient(this.config);
+        }
+        return this.grpcClientInstance;
     }
     /**
      * Create a chat completion (non-streaming)
      */
     async create(request) {
-        if (this.isGrpc() && this.grpcClient) {
-            return this.grpcClient.createChatCompletion(request);
+        const grpcClient = await this.getGrpcClient();
+        if (grpcClient) {
+            return grpcClient.createChatCompletion(request);
         }
         // Filter out undefined values to avoid sending them to the API
         const filteredRequest = Object.fromEntries(Object.entries(request).filter(([_, value]) => value !== undefined));
@@ -32,8 +41,9 @@ export class ChatCompletions {
      * Returns an async iterator over chunks
      */
     async *createStream(request, signal) {
-        if (this.isGrpc() && this.grpcClient) {
-            for await (const chunk of this.grpcClient.createChatCompletionStream(request)) {
+        const grpcClient = await this.getGrpcClient();
+        if (grpcClient) {
+            for await (const chunk of grpcClient.createChatCompletionStream(request)) {
                 yield chunk;
             }
             return;

package/dist/chat.js.map

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

package/dist/client.d.ts

@@ -9,7 +9,6 @@ export declare class NovaClient {
     readonly chat: ChatCompletions;
     readonly models: Models;
     private readonly httpClient;
-    private readonly grpcClient?;
     constructor(config: NovaClientConfig);
     private shouldUseGrpc;
     /**

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,YAAY,CAAC;AAElE,qBAAa,UAAU;IACtB,SAAgB,IAAI,EAAE,eAAe,CAAC;IACtC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAa;gBAE7B,MAAM,EAAE,gBAAgB;IASpC,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,SAAS,IAAI,MAAM;CAMnB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,YAAY,CAAC;AAElE,qBAAa,UAAU;IACtB,SAAgB,IAAI,EAAE,eAAe,CAAC;IACtC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;gBAE5B,MAAM,EAAE,gBAAgB;IAMpC,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,SAAS,IAAI,MAAM;CAMnB"}

package/dist/client.js

@@ -3,21 +3,16 @@
  * Main client class for interacting with Nova AI API
  */
 import { ChatCompletions } from "./chat.js";
-import { GrpcClient } from "./grpc-client.js";
 import { HttpClient } from "./http-client.js";
 import { Models } from "./models.js";
 export class NovaClient {
     chat;
     models;
     httpClient;
-    grpcClient;
     constructor(config) {
         this.httpClient = new HttpClient(config);
-        if (this.shouldUseGrpc(config.transport)) {
-            this.grpcClient = new GrpcClient(config);
-        }
-        this.chat = new ChatCompletions(this.httpClient, this.grpcClient);
-        this.models = new Models(this.httpClient, this.grpcClient);
+        this.chat = new ChatCompletions(this.httpClient, config);
+        this.models = new Models(this.httpClient, config);
     }
     shouldUseGrpc(transport) {
         return transport === "grpc";

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,MAAM,OAAO,UAAU;IACN,IAAI,CAAkB;IACtB,MAAM,CAAS;IACd,UAAU,CAAa;IACvB,UAAU,CAAc;IAEzC,YAAY,MAAwB;QACnC,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5D,CAAC;IAEO,aAAa,CAAC,SAAyB;QAC9C,OAAO,SAAS,KAAK,MAAM,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,SAAS;QACR,oEAAoE;QACpE,MAAM,GAAG,GAAI,IAAI,CAAC,UAAkB,CAAC,MAAgB,CAAC;QACtD,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE;YAAE,OAAO,GAAG,CAAC;QACjC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,CAAC;CACD"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,MAAM,OAAO,UAAU;IACN,IAAI,CAAkB;IACtB,MAAM,CAAS;IACd,UAAU,CAAa;IAExC,YAAY,MAAwB;QACnC,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAEO,aAAa,CAAC,SAAyB;QAC9C,OAAO,SAAS,KAAK,MAAM,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,SAAS;QACR,oEAAoE;QACpE,MAAM,GAAG,GAAI,IAAI,CAAC,UAAkB,CAAC,MAAgB,CAAC;QACtD,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE;YAAE,OAAO,GAAG,CAAC;QACjC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,CAAC;CACD"}

package/dist/index.d.ts

@@ -37,7 +37,7 @@ export declare const NOVA_SERVICE_PROTO: string;
 export declare const ENGINE_PROTO: string;
 export { ChatCompletions } from "./chat.js";
 export { NovaClient } from "./client.js";
-export { GrpcClient } from "./grpc-client.js";
+export type { GrpcClient } from "./grpc-client.js";
 export { HttpClient } from "./http-client.js";
 export { Models } from "./models.js";
 export type { ChatCompletionChoice, ChatCompletionChunk, ChatCompletionChunkChoice, ChatCompletionError, ChatCompletionRequest, ChatCompletionResponse, ChatCompletionUsage, ChatMessage, Model, NovaClientConfig, NovaTransport, } from "./types.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAOH,eAAO,MAAM,kBAAkB,QAI9B,CAAC;AACF,eAAO,MAAM,YAAY,QAA2C,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EACX,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,WAAW,EACX,KAAK,EACL,gBAAgB,EAChB,aAAa,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAOH,eAAO,MAAM,kBAAkB,QAI9B,CAAC;AACF,eAAO,MAAM,YAAY,QAA2C,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EACX,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,WAAW,EACX,KAAK,EACL,gBAAgB,EAChB,aAAa,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -40,7 +40,6 @@ export const NOVA_SERVICE_PROTO = join(__dirname, "proto", "nova-service.proto")
 export const ENGINE_PROTO = join(__dirname, "proto", "engine.proto");
 export { ChatCompletions } from "./chat.js";
 export { NovaClient } from "./client.js";
-export { GrpcClient } from "./grpc-client.js";
 export { HttpClient } from "./http-client.js";
 export { Models } from "./models.js";
 export { NovaError } from "./types.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CACrC,SAAS,EACT,OAAO,EACP,oBAAoB,CACpB,CAAC;AACF,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAcrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CACrC,SAAS,EACT,OAAO,EACP,oBAAoB,CACpB,CAAC;AACF,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAcrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/models.d.ts

@@ -2,14 +2,14 @@
  * Models API
  * Handles model listing and retrieval
  */
-import { GrpcClient } from "./grpc-client.js";
 import { HttpClient } from "./http-client.js";
-import type { Model } from "./types.js";
+import type { Model, NovaClientConfig } from "./types.js";
 export declare class Models {
     private readonly httpClient;
-    private readonly grpcClient?;
-    constructor(httpClient: HttpClient, grpcClient?: GrpcClient | undefined);
-    private isGrpc;
+    private readonly config;
+    private grpcClientInstance?;
+    constructor(httpClient: HttpClient, config: NovaClientConfig);
+    private getGrpcClient;
     /**
      * List all available models for the API key
      */

package/dist/models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,qBAAa,MAAM;IAEjB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBADX,UAAU,EAAE,UAAU,EACtB,UAAU,CAAC,EAAE,UAAU,YAAA;IAGzC,OAAO,CAAC,MAAM;IAId;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAS9B;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;CAI1C"}
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE1D,qBAAa,MAAM;IAIjB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJxB,OAAO,CAAC,kBAAkB,CAAC,CAAa;gBAGtB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,gBAAgB;YAG5B,aAAa;IAW3B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAU9B;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;CAI1C"}

package/dist/models.js

@@ -4,20 +4,29 @@
  */
 export class Models {
     httpClient;
-    grpcClient;
-    constructor(httpClient, grpcClient) {
+    config;
+    grpcClientInstance;
+    constructor(httpClient, config) {
         this.httpClient = httpClient;
-        this.grpcClient = grpcClient;
+        this.config = config;
     }
-    isGrpc() {
-        return Boolean(this.grpcClient);
+    async getGrpcClient() {
+        if (this.config.transport !== "grpc") {
+            return undefined;
+        }
+        if (!this.grpcClientInstance) {
+            const { GrpcClient } = await import("./grpc-client.js");
+            this.grpcClientInstance = new GrpcClient(this.config);
+        }
+        return this.grpcClientInstance;
     }
     /**
      * List all available models for the API key
      */
     async list() {
-        if (this.isGrpc() && this.grpcClient) {
-            return this.grpcClient.listModels();
+        const grpcClient = await this.getGrpcClient();
+        if (grpcClient) {
+            return grpcClient.listModels();
         }
         const response = await this.httpClient.get("v1/models");
         return response.data || [];

package/dist/models.js.map

@@ -1 +1 @@
-{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,OAAO,MAAM;IAEA;IACA;IAFlB,YACkB,UAAsB,EACtB,UAAuB;QADvB,eAAU,GAAV,UAAU,CAAY;QACtB,eAAU,GAAV,UAAU,CAAa;IACtC,CAAC;IAEI,MAAM;QACb,OAAO,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACT,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;QACrC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAoB,WAAW,CAAC,CAAC;QAC3E,OAAO,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,OAAe;QACxB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAQ,aAAa,OAAO,EAAE,CAAC,CAAC;QAC1E,OAAO,QAAQ,CAAC;IACjB,CAAC;CACD"}
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,OAAO,MAAM;IAIA;IACA;IAJV,kBAAkB,CAAc;IAExC,YACkB,UAAsB,EACtB,MAAwB;QADxB,eAAU,GAAV,UAAU,CAAY;QACtB,WAAM,GAAN,MAAM,CAAkB;IACvC,CAAC;IAEI,KAAK,CAAC,aAAa;QAC1B,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;YACtC,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC9B,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;YACxD,IAAI,CAAC,kBAAkB,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,IAAI,CAAC,kBAAkB,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACT,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC9C,IAAI,UAAU,EAAE,CAAC;YAChB,OAAO,UAAU,CAAC,UAAU,EAAE,CAAC;QAChC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAoB,WAAW,CAAC,CAAC;QAC3E,OAAO,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,OAAe;QACxB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAQ,aAAa,OAAO,EAAE,CAAC,CAAC;QAC1E,OAAO,QAAQ,CAAC;IACjB,CAAC;CACD"}

package/dist/proto/engine.proto

@@ -0,0 +1,431 @@
+syntax = "proto3";
+
+package engine;
+
+// ===================================================================
+// NOVA ENGINE SERVICE
+// ===================================================================
+// Multi-modal AI generation service with intelligent model selection
+
+service EngineService {
+  // Model Selection
+  rpc SelectModel(SelectModelRequest) returns (SelectModelResponse);
+  rpc GetAvailableModels(GetModelsRequest) returns (GetModelsResponse);
+  rpc GetModelPresets(GetPresetsRequest) returns (GetPresetsResponse);
+  
+  // Generation - Text
+  rpc GenerateText(GenerateTextRequest) returns (stream GenerateTextResponse);
+  
+  // Generation - Image (Future)
+  rpc GenerateImage(GenerateImageRequest) returns (GenerateImageResponse);
+  
+  // Generation - Video (Future)
+  rpc GenerateVideo(GenerateVideoRequest) returns (GenerateVideoResponse);
+  
+  // Generation - Audio (Future)
+  rpc GenerateAudio(GenerateAudioRequest) returns (GenerateAudioResponse);
+  
+  // Provider Management
+  rpc GetProviders(GetProvidersRequest) returns (GetProvidersResponse);
+  rpc UpdateProvider(UpdateProviderRequest) returns (UpdateProviderResponse);
+  rpc CheckProviderHealth(CheckHealthRequest) returns (CheckHealthResponse);
+  
+  // Analytics & Metrics
+  rpc GetGenerationMetrics(GetMetricsRequest) returns (GetMetricsResponse);
+  rpc GetUsageStats(GetUsageStatsRequest) returns (GetUsageStatsResponse);
+  
+  // Cache Management
+  rpc ClearCache(ClearCacheRequest) returns (ClearCacheResponse);
+  rpc GetCacheStats(CacheStatsRequest) returns (CacheStatsResponse);
+}
+
+// ===================================================================
+// COMMON MESSAGES
+// ===================================================================
+
+message Empty {}
+
+message ErrorResponse {
+  string code = 1;
+  string message = 2;
+  map<string, string> details = 3;
+}
+
+// ===================================================================
+// MODEL SELECTION MESSAGES
+// ===================================================================
+
+message SelectModelRequest {
+  string character_id = 1;
+  string generation_type = 2; // "text", "image", "video", "audio"
+  optional string preferred_provider = 3;
+  optional string preferred_model = 4;
+}
+
+message SelectModelResponse {
+  string model_id = 1;
+  string model_name = 2;
+  string model_identifier = 3;
+  string provider = 4;
+  string integration_id = 5;
+  ModelConfig config = 6;
+  bool success = 7;
+  optional string error_message = 8;
+}
+
+message ModelConfig {
+  optional double temperature = 1;
+  optional int32 max_tokens = 2;
+  optional double top_p = 3;
+  repeated string stop_sequences = 4;
+  map<string, string> additional_params = 5;
+}
+
+message GetModelsRequest {
+  string generation_type = 1;
+  optional bool active_only = 2;
+  optional string provider = 3;
+}
+
+message GetModelsResponse {
+  repeated ModelInfo models = 1;
+}
+
+message ModelInfo {
+  string id = 1;
+  string name = 2;
+  string identifier = 3;
+  string type = 4;
+  string provider = 5;
+  string provider_name = 6;
+  bool is_active = 7;
+  bool is_default = 8;
+  int32 priority = 9;
+  optional ModelConfig default_config = 10;
+}
+
+message GetPresetsRequest {
+  optional string tier = 1;
+  optional bool active_only = 2;
+}
+
+message GetPresetsResponse {
+  repeated PresetInfo presets = 1;
+}
+
+message PresetInfo {
+  string id = 1;
+  string name = 2;
+  string description = 3;
+  string tier = 4;
+  bool is_active = 5;
+  bool is_default = 6;
+  optional ModelInfo model = 7;
+}
+
+// ===================================================================
+// TEXT GENERATION MESSAGES
+// ===================================================================
+
+message GenerateTextRequest {
+  string request_id = 1;
+  string model_id = 2;
+  repeated ChatMessage messages = 3;
+  optional string character_id = 4;
+  optional string user_id = 5;
+  optional string message_id = 6;
+  map<string, string> metadata = 7;
+  ModelConfig config = 8;
+  bool stream = 9;
+  optional string prompt = 10;
+}
+
+message ChatMessage {
+  string role = 1; // "user", "assistant", "system"
+  string content = 2;
+  optional string name = 3;
+}
+
+message GenerateTextResponse {
+  string request_id = 1;
+  string content = 2; // Text chunk for streaming
+  bool is_complete = 3;
+  optional GenerationMetadata generation_metadata = 4;
+  optional string error_message = 5;
+}
+
+message GenerationMetadata {
+  int32 tokens_used = 1;
+  int32 input_tokens = 2;
+  int32 output_tokens = 3;
+  int32 response_time_ms = 4;
+  bool cache_hit = 5;
+  bool semantic_match = 6;
+  string model_used = 7;
+  string provider_used = 8;
+  optional double estimated_cost = 9;
+}
+
+// ===================================================================
+// IMAGE GENERATION MESSAGES
+// ===================================================================
+
+message GenerateImageRequest {
+  string request_id = 1;
+  string model_id = 2;
+  string prompt = 3;
+  optional string negative_prompt = 4;
+  optional string character_id = 5;
+  optional string user_id = 6;
+  ImageConfig config = 7;
+  map<string, string> metadata = 8;
+}
+
+message ImageConfig {
+  int32 width = 1;
+  int32 height = 2;
+  int32 num_images = 3;
+  optional string style = 4;
+  optional double guidance_scale = 5;
+  optional int32 steps = 6;
+  optional string quality = 7; // "standard", "hd"
+}
+
+message GenerateImageResponse {
+  string request_id = 1;
+  repeated string image_urls = 2;
+  repeated bytes image_data = 3; // Optional raw image data
+  GenerationMetadata generation_metadata = 4;
+  bool success = 5;
+  optional string error_message = 6;
+}
+
+// ===================================================================
+// VIDEO GENERATION MESSAGES
+// ===================================================================
+
+message GenerateVideoRequest {
+  string request_id = 1;
+  string model_id = 2;
+  string prompt = 3;
+  optional string character_id = 4;
+  optional string user_id = 5;
+  VideoConfig config = 6;
+  map<string, string> metadata = 7;
+}
+
+message VideoConfig {
+  int32 duration_seconds = 1;
+  optional int32 fps = 2;
+  optional string resolution = 3; // "720p", "1080p", "4k"
+  optional string style = 4;
+  optional string aspect_ratio = 5; // "16:9", "9:16", "1:1"
+}
+
+message GenerateVideoResponse {
+  string request_id = 1;
+  string video_url = 2;
+  optional string thumbnail_url = 3;
+  GenerationMetadata generation_metadata = 4;
+  bool success = 5;
+  optional string error_message = 6;
+}
+
+// ===================================================================
+// AUDIO GENERATION MESSAGES
+// ===================================================================
+
+message GenerateAudioRequest {
+  string request_id = 1;
+  string model_id = 2;
+  string text = 3;
+  optional string character_id = 4;
+  optional string user_id = 5;
+  AudioConfig config = 6;
+  map<string, string> metadata = 7;
+}
+
+message AudioConfig {
+  optional string voice = 1;
+  optional double speed = 2;
+  optional int32 sample_rate = 3;
+  optional string format = 4; // "mp3", "wav", "ogg"
+  optional double stability = 5;
+  optional double similarity_boost = 6;
+}
+
+message GenerateAudioResponse {
+  string request_id = 1;
+  string audio_url = 2;
+  optional bytes audio_data = 3;
+  GenerationMetadata generation_metadata = 4;
+  bool success = 5;
+  optional string error_message = 6;
+}
+
+// ===================================================================
+// PROVIDER MANAGEMENT MESSAGES
+// ===================================================================
+
+message GetProvidersRequest {
+  optional string type = 1; // Filter by type: "text", "image", "video", "audio"
+  optional bool enabled_only = 2;
+}
+
+message GetProvidersResponse {
+  repeated ProviderInfo providers = 1;
+}
+
+message ProviderInfo {
+  string id = 1;
+  string name = 2;
+  string provider = 3;
+  string type = 4;
+  bool is_enabled = 5;
+  string status = 6;
+  int32 priority = 7;
+  ProviderHealth health = 8;
+  repeated string supported_features = 9;
+}
+
+message ProviderHealth {
+  bool is_healthy = 1;
+  int64 last_check_timestamp = 2;
+  optional int32 response_time_ms = 3;
+  optional string error_message = 4;
+  double uptime_percentage = 5;
+}
+
+message UpdateProviderRequest {
+  string provider_id = 1;
+  optional bool is_enabled = 2;
+  optional string status = 3;
+  optional int32 priority = 4;
+  map<string, string> config_updates = 5;
+}
+
+message UpdateProviderResponse {
+  bool success = 1;
+  string message = 2;
+  optional ProviderInfo updated_provider = 3;
+}
+
+message CheckHealthRequest {
+  optional string provider_id = 1; // Check specific provider or all if empty
+}
+
+message CheckHealthResponse {
+  map<string, ProviderHealth> health_status = 1;
+  int32 healthy_count = 2;
+  int32 total_count = 3;
+}
+
+// ===================================================================
+// ANALYTICS MESSAGES
+// ===================================================================
+
+message GetMetricsRequest {
+  string period_type = 1; // "hourly", "daily", "monthly"
+  int64 start_timestamp = 2;
+  int64 end_timestamp = 3;
+  optional string generation_type = 4;
+  optional string provider_id = 5;
+  optional string model_id = 6;
+}
+
+message GetMetricsResponse {
+  repeated MetricData metrics = 1;
+  MetricSummary summary = 2;
+}
+
+message MetricData {
+  int64 period_start = 1;
+  int64 period_end = 2;
+  string generation_type = 3;
+  int32 total_requests = 4;
+  int32 successful_requests = 5;
+  int32 failed_requests = 6;
+  int32 cached_requests = 7;
+  double avg_response_time = 8;
+  double p95_response_time = 9;
+  double cache_hit_rate = 10;
+  TokenUsage token_usage = 11;
+  double total_cost = 12;
+}
+
+message MetricSummary {
+  int32 total_requests = 1;
+  int32 total_successful = 2;
+  int32 total_failed = 3;
+  int32 total_cached = 4;
+  double overall_cache_hit_rate = 5;
+  double total_cost = 6;
+  TokenUsage total_tokens = 7;
+}
+
+message TokenUsage {
+  int32 input_tokens = 1;
+  int32 output_tokens = 2;
+  int32 total_tokens = 3;
+}
+
+message GetUsageStatsRequest {
+  optional string character_id = 1;
+  optional string user_id = 2;
+  int64 start_timestamp = 3;
+  int64 end_timestamp = 4;
+}
+
+message GetUsageStatsResponse {
+  map<string, int32> generations_by_type = 1;
+  TokenUsage total_tokens = 2;
+  double total_cost = 3;
+  int32 cache_hits = 4;
+  double cache_hit_rate = 5;
+  repeated ModelUsage model_usage = 6;
+}
+
+message ModelUsage {
+  string model_id = 1;
+  string model_name = 2;
+  int32 request_count = 3;
+  TokenUsage tokens = 4;
+  double cost = 5;
+}
+
+// ===================================================================
+// CACHE MANAGEMENT MESSAGES
+// ===================================================================
+
+message ClearCacheRequest {
+  optional string cache_type = 1; // "all", "generation", "model", "embedding"
+  optional string generation_type = 2; // Clear cache for specific type
+  optional bool force = 3; // Force clear even if recently used
+}
+
+message ClearCacheResponse {
+  bool success = 1;
+  string message = 2;
+  int32 entries_cleared = 3;
+}
+
+message CacheStatsRequest {
+  optional string cache_type = 1;
+}
+
+message CacheStatsResponse {
+  int64 total_entries = 1;
+  int64 total_hits = 2;
+  int64 total_misses = 3;
+  double hit_rate = 4;
+  int64 memory_usage_bytes = 5;
+  map<string, CacheTypeStats> stats_by_type = 6;
+}
+
+message CacheTypeStats {
+  string type = 1;
+  int64 entries = 2;
+  int64 hits = 3;
+  int64 misses = 4;
+  double hit_rate = 5;
+}