@ancatag/n-r 0.2.18 → 0.2.19

package/dist/proto/generated/nova-service.js

@@ -0,0 +1,122 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.11.2
+//   protoc               v6.33.4
+// source: nova-service.proto
+import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
+export const protobufPackage = "nova.service";
+export var GenerationType;
+(function (GenerationType) {
+    GenerationType[GenerationType["GENERATION_TYPE_UNSPECIFIED"] = 0] = "GENERATION_TYPE_UNSPECIFIED";
+    GenerationType[GenerationType["GENERATION_TYPE_TEXT"] = 1] = "GENERATION_TYPE_TEXT";
+    GenerationType[GenerationType["GENERATION_TYPE_IMAGE"] = 2] = "GENERATION_TYPE_IMAGE";
+    GenerationType[GenerationType["GENERATION_TYPE_VIDEO"] = 3] = "GENERATION_TYPE_VIDEO";
+    GenerationType[GenerationType["GENERATION_TYPE_AUDIO"] = 4] = "GENERATION_TYPE_AUDIO";
+    GenerationType[GenerationType["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(GenerationType || (GenerationType = {}));
+export var StreamingMode;
+(function (StreamingMode) {
+    StreamingMode[StreamingMode["STREAMING_MODE_NONE"] = 0] = "STREAMING_MODE_NONE";
+    /** STREAMING_MODE_TOKEN - Stream token by token */
+    StreamingMode[StreamingMode["STREAMING_MODE_TOKEN"] = 1] = "STREAMING_MODE_TOKEN";
+    /** STREAMING_MODE_CHUNK - Stream in chunks */
+    StreamingMode[StreamingMode["STREAMING_MODE_CHUNK"] = 2] = "STREAMING_MODE_CHUNK";
+    StreamingMode[StreamingMode["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(StreamingMode || (StreamingMode = {}));
+export var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode[ErrorCode["ERROR_CODE_UNSPECIFIED"] = 0] = "ERROR_CODE_UNSPECIFIED";
+    ErrorCode[ErrorCode["ERROR_CODE_SUCCESS"] = 1] = "ERROR_CODE_SUCCESS";
+    ErrorCode[ErrorCode["ERROR_CODE_INVALID_REQUEST"] = 2] = "ERROR_CODE_INVALID_REQUEST";
+    ErrorCode[ErrorCode["ERROR_CODE_AUTHENTICATION_FAILED"] = 3] = "ERROR_CODE_AUTHENTICATION_FAILED";
+    ErrorCode[ErrorCode["ERROR_CODE_ACCESS_DENIED"] = 4] = "ERROR_CODE_ACCESS_DENIED";
+    ErrorCode[ErrorCode["ERROR_CODE_MODEL_NOT_FOUND"] = 5] = "ERROR_CODE_MODEL_NOT_FOUND";
+    ErrorCode[ErrorCode["ERROR_CODE_PROVIDER_UNAVAILABLE"] = 6] = "ERROR_CODE_PROVIDER_UNAVAILABLE";
+    ErrorCode[ErrorCode["ERROR_CODE_RATE_LIMIT_EXCEEDED"] = 7] = "ERROR_CODE_RATE_LIMIT_EXCEEDED";
+    ErrorCode[ErrorCode["ERROR_CODE_QUOTA_EXCEEDED"] = 8] = "ERROR_CODE_QUOTA_EXCEEDED";
+    ErrorCode[ErrorCode["ERROR_CODE_PROMPT_TOO_LONG"] = 9] = "ERROR_CODE_PROMPT_TOO_LONG";
+    ErrorCode[ErrorCode["ERROR_CODE_PARAMETER_ERROR"] = 10] = "ERROR_CODE_PARAMETER_ERROR";
+    ErrorCode[ErrorCode["ERROR_CODE_GENERATION_FAILED"] = 11] = "ERROR_CODE_GENERATION_FAILED";
+    ErrorCode[ErrorCode["ERROR_CODE_TIMEOUT"] = 12] = "ERROR_CODE_TIMEOUT";
+    ErrorCode[ErrorCode["ERROR_CODE_INTERNAL_ERROR"] = 13] = "ERROR_CODE_INTERNAL_ERROR";
+    ErrorCode[ErrorCode["ERROR_CODE_SERVICE_UNAVAILABLE"] = 14] = "ERROR_CODE_SERVICE_UNAVAILABLE";
+    ErrorCode[ErrorCode["ERROR_CODE_NOT_IMPLEMENTED"] = 15] = "ERROR_CODE_NOT_IMPLEMENTED";
+    ErrorCode[ErrorCode["ERROR_CODE_DATABASE_ERROR"] = 16] = "ERROR_CODE_DATABASE_ERROR";
+    ErrorCode[ErrorCode["ERROR_CODE_CACHE_ERROR"] = 17] = "ERROR_CODE_CACHE_ERROR";
+    ErrorCode[ErrorCode["ERROR_CODE_VECTOR_DB_ERROR"] = 18] = "ERROR_CODE_VECTOR_DB_ERROR";
+    ErrorCode[ErrorCode["ERROR_CODE_PROVIDER_TIMEOUT"] = 19] = "ERROR_CODE_PROVIDER_TIMEOUT";
+    ErrorCode[ErrorCode["ERROR_CODE_PROVIDER_RATE_LIMIT"] = 20] = "ERROR_CODE_PROVIDER_RATE_LIMIT";
+    ErrorCode[ErrorCode["ERROR_CODE_PROVIDER_AUTH_ERROR"] = 21] = "ERROR_CODE_PROVIDER_AUTH_ERROR";
+    ErrorCode[ErrorCode["ERROR_CODE_PROVIDER_QUOTA_EXCEEDED"] = 22] = "ERROR_CODE_PROVIDER_QUOTA_EXCEEDED";
+    ErrorCode[ErrorCode["ERROR_CODE_PROVIDER_INVALID_REQUEST"] = 23] = "ERROR_CODE_PROVIDER_INVALID_REQUEST";
+    ErrorCode[ErrorCode["ERROR_CODE_PROVIDER_GENERATION_FAILED"] = 24] = "ERROR_CODE_PROVIDER_GENERATION_FAILED";
+    ErrorCode[ErrorCode["ERROR_CODE_MAINTENANCE_MODE"] = 25] = "ERROR_CODE_MAINTENANCE_MODE";
+    ErrorCode[ErrorCode["ERROR_CODE_DEPRECATED_MODEL"] = 26] = "ERROR_CODE_DEPRECATED_MODEL";
+    ErrorCode[ErrorCode["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(ErrorCode || (ErrorCode = {}));
+export var ErrorCategory;
+(function (ErrorCategory) {
+    ErrorCategory[ErrorCategory["ERROR_CATEGORY_UNSPECIFIED"] = 0] = "ERROR_CATEGORY_UNSPECIFIED";
+    /** ERROR_CATEGORY_CLIENT - Client error (4xx) */
+    ErrorCategory[ErrorCategory["ERROR_CATEGORY_CLIENT"] = 1] = "ERROR_CATEGORY_CLIENT";
+    /** ERROR_CATEGORY_SERVER - Server error (5xx) */
+    ErrorCategory[ErrorCategory["ERROR_CATEGORY_SERVER"] = 2] = "ERROR_CATEGORY_SERVER";
+    /** ERROR_CATEGORY_PROVIDER - Provider error */
+    ErrorCategory[ErrorCategory["ERROR_CATEGORY_PROVIDER"] = 3] = "ERROR_CATEGORY_PROVIDER";
+    /** ERROR_CATEGORY_RATE_LIMIT - Rate limiting */
+    ErrorCategory[ErrorCategory["ERROR_CATEGORY_RATE_LIMIT"] = 4] = "ERROR_CATEGORY_RATE_LIMIT";
+    /** ERROR_CATEGORY_AUTHENTICATION - Auth related */
+    ErrorCategory[ErrorCategory["ERROR_CATEGORY_AUTHENTICATION"] = 5] = "ERROR_CATEGORY_AUTHENTICATION";
+    /** ERROR_CATEGORY_AUTHORIZATION - Permission related */
+    ErrorCategory[ErrorCategory["ERROR_CATEGORY_AUTHORIZATION"] = 6] = "ERROR_CATEGORY_AUTHORIZATION";
+    /** ERROR_CATEGORY_VALIDATION - Input validation */
+    ErrorCategory[ErrorCategory["ERROR_CATEGORY_VALIDATION"] = 7] = "ERROR_CATEGORY_VALIDATION";
+    /** ERROR_CATEGORY_QUOTA - Quota/limit exceeded */
+    ErrorCategory[ErrorCategory["ERROR_CATEGORY_QUOTA"] = 8] = "ERROR_CATEGORY_QUOTA";
+    /** ERROR_CATEGORY_NOT_FOUND - Resource not found */
+    ErrorCategory[ErrorCategory["ERROR_CATEGORY_NOT_FOUND"] = 9] = "ERROR_CATEGORY_NOT_FOUND";
+    /** ERROR_CATEGORY_NOT_IMPLEMENTED - Feature not implemented */
+    ErrorCategory[ErrorCategory["ERROR_CATEGORY_NOT_IMPLEMENTED"] = 10] = "ERROR_CATEGORY_NOT_IMPLEMENTED";
+    /** ERROR_CATEGORY_MAINTENANCE - Service maintenance */
+    ErrorCategory[ErrorCategory["ERROR_CATEGORY_MAINTENANCE"] = 11] = "ERROR_CATEGORY_MAINTENANCE";
+    /** ERROR_CATEGORY_TEMPORARY - Temporary error, retry later */
+    ErrorCategory[ErrorCategory["ERROR_CATEGORY_TEMPORARY"] = 12] = "ERROR_CATEGORY_TEMPORARY";
+    /** ERROR_CATEGORY_PERMANENT - Permanent error, no retry */
+    ErrorCategory[ErrorCategory["ERROR_CATEGORY_PERMANENT"] = 13] = "ERROR_CATEGORY_PERMANENT";
+    ErrorCategory[ErrorCategory["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(ErrorCategory || (ErrorCategory = {}));
+export var StatusCode;
+(function (StatusCode) {
+    StatusCode[StatusCode["STATUS_CODE_HEALTHY"] = 0] = "STATUS_CODE_HEALTHY";
+    StatusCode[StatusCode["STATUS_CODE_DEGRADED"] = 1] = "STATUS_CODE_DEGRADED";
+    StatusCode[StatusCode["STATUS_CODE_UNHEALTHY"] = 2] = "STATUS_CODE_UNHEALTHY";
+    StatusCode[StatusCode["STATUS_CODE_MAINTENANCE"] = 3] = "STATUS_CODE_MAINTENANCE";
+    StatusCode[StatusCode["STATUS_CODE_UNKNOWN"] = 4] = "STATUS_CODE_UNKNOWN";
+    StatusCode[StatusCode["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(StatusCode || (StatusCode = {}));
+export const NOVA_SERVICE_PACKAGE_NAME = "nova.service";
+export function NovaServiceControllerMethods() {
+    return function (constructor) {
+        const grpcMethods = [
+            "generateText",
+            "streamText",
+            "generateImage",
+            "generateAudio",
+            "generateVideo",
+            "healthCheck",
+            "listModels",
+            "listPresets",
+        ];
+        for (const method of grpcMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            GrpcMethod("NovaService", method)(constructor.prototype[method], method, descriptor);
+        }
+        const grpcStreamMethods = [];
+        for (const method of grpcStreamMethods) {
+            const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+            GrpcStreamMethod("NovaService", method)(constructor.prototype[method], method, descriptor);
+        }
+    };
+}
+export const NOVA_SERVICE_NAME = "NovaService";
+//# sourceMappingURL=nova-service.js.map

package/dist/proto/generated/nova-service.js.map

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

package/dist/proto/nova-service.proto

@@ -0,0 +1,472 @@
+// ===================================================================
+// NOVA SERVICE gRPC DEFINITION
+// ===================================================================
+// Multi-modal AI generation service with flexible model selection
+// Supports text, image, video, and audio generation
+
+syntax = "proto3";
+
+package nova.service;
+
+import "google/protobuf/timestamp.proto";
+import "google/protobuf/duration.proto";
+
+// ===================================================================
+// SERVICE DEFINITION
+// ===================================================================
+
+service NovaService {
+  // Text Generation (FULLY IMPLEMENTED with Ollama)
+  rpc GenerateText(GenerateTextRequest) returns (GenerateTextResponse);
+  rpc StreamText(GenerateTextRequest) returns (stream GenerateTextStreamResponse);
+  
+  // Image Generation (NULL IMPLEMENTATION - Coming Soon)
+  rpc GenerateImage(GenerateImageRequest) returns (GenerateImageResponse);
+  
+  // Audio Generation (NULL IMPLEMENTATION - Coming Soon)
+  rpc GenerateAudio(GenerateAudioRequest) returns (GenerateAudioResponse);
+  
+  // Video Generation (NULL IMPLEMENTATION - Coming Soon)
+  rpc GenerateVideo(GenerateVideoRequest) returns (GenerateVideoResponse);
+  
+  // Administrative & Management
+  rpc HealthCheck(HealthCheckRequest) returns (HealthCheckResponse);
+  rpc ListModels(ListModelsRequest) returns (ListModelsResponse);
+  rpc ListPresets(ListPresetsRequest) returns (ListPresetsResponse);
+}
+
+// ===================================================================
+// GENERATION TYPE ENUMS
+// ===================================================================
+
+enum GenerationType {
+  GENERATION_TYPE_UNSPECIFIED = 0;
+  GENERATION_TYPE_TEXT = 1;
+  GENERATION_TYPE_IMAGE = 2;
+  GENERATION_TYPE_VIDEO = 3;
+  GENERATION_TYPE_AUDIO = 4;
+}
+
+enum StreamingMode {
+  STREAMING_MODE_NONE = 0;
+  STREAMING_MODE_TOKEN = 1;        // Stream token by token
+  STREAMING_MODE_CHUNK = 2;        // Stream in chunks
+}
+
+// ===================================================================
+// MODEL SELECTION STRATEGIES
+// ===================================================================
+
+message ModelSelection {
+  oneof selection_strategy {
+    // Option 1: Use a preset ID (RECOMMENDED)
+    string preset_id = 1;
+    
+    // Option 2: Specify exact model UUID
+    string model_id = 2;
+    
+    // Option 3: Provider + Generation Type + Parameters
+    ProviderSelection provider_selection = 3;
+    
+    // Option 4: Auto-select best model for generation type
+    GenerationType auto_select = 4;
+  }
+}
+
+message ProviderSelection {
+  string provider_id = 1;    // ProviderIntegration.id
+  GenerationType type = 2;   // Text, Image, Video, Audio
+  map<string, string> parameters = 3; // Provider-specific params
+  int32 priority = 4;        // Selection priority
+}
+
+// ===================================================================
+// REQUEST/RESPONSE MESSAGES
+// ===================================================================
+
+// ----- TEXT GENERATION -----
+
+message GenerateTextRequest {
+  string prompt = 1;
+  GenerationContext context = 2;
+  ModelSelection model_selection = 3;
+  
+  // Generation parameters
+  int32 max_tokens = 4;
+  float temperature = 5;
+  float top_p = 6;
+  float top_k = 7;
+  string stop_sequences = 8;
+  bool include_context = 9;
+  
+  // Streaming
+  StreamingMode streaming_mode = 10;
+  bool enable_streaming = 11;
+  
+  // Request metadata
+  string request_id = 12;
+  string client_id = 13;
+  string character_id = 14;
+  string user_id = 15;
+  google.protobuf.Duration timeout = 16;
+  
+  // Generation options
+  bool enable_cache = 17;
+  bool enable_semantic_cache = 18;
+  bool retry_on_failure = 19;
+  int32 max_retries = 20;
+}
+
+message GenerateTextResponse {
+  GenerationResult result = 1;
+  ModelInfo used_model = 2;
+  UsageStats usage = 3;
+  google.protobuf.Duration processing_time = 4;
+  bool cached = 5;
+  bool semantic_cache_hit = 6;
+}
+
+message GenerateTextStreamResponse {
+  string token = 1;
+  int32 token_index = 2;
+  ModelInfo used_model = 3;
+  GenerationError error = 4;
+  bool completed = 5;
+  UsageStats usage = 6;
+}
+
+// ----- IMAGE GENERATION (NULL IMPLEMENTATION) -----
+
+message GenerateImageRequest {
+  string prompt = 1;
+  GenerationContext context = 2;
+  ModelSelection model_selection = 3;
+  
+  // Image parameters
+  int32 width = 4;
+  int32 height = 5;
+  string style = 6;
+  int32 num_images = 7;
+  string negative_prompt = 8;
+  
+  // Request metadata
+  string request_id = 9;
+  string client_id = 10;
+  string character_id = 11;
+  string user_id = 12;
+  google.protobuf.Duration timeout = 13;
+  
+  // Generation options
+  bool enable_cache = 14;
+  bool retry_on_failure = 15;
+}
+
+message GenerateImageResponse {
+  // NULL IMPLEMENTATION - Coming Soon
+  GenerationError error = 1; // Returns "NOT_IMPLEMENTED" with message
+  string message = 2;        // "Image generation coming soon"
+  GenerationResult result = 3;
+  ModelInfo used_model = 4;
+}
+
+// ----- AUDIO GENERATION (NULL IMPLEMENTATION) -----
+
+message GenerateAudioRequest {
+  string text = 1;
+  GenerationContext context = 2;
+  ModelSelection model_selection = 3;
+  
+  // Audio parameters
+  string voice = 4;
+  float speed = 5;
+  float pitch = 6;
+  string format = 7;
+  
+  // Request metadata
+  string request_id = 8;
+  string client_id = 9;
+  string character_id = 10;
+  string user_id = 11;
+  google.protobuf.Duration timeout = 12;
+  
+  // Generation options
+  bool enable_cache = 13;
+  bool retry_on_failure = 14;
+}
+
+message GenerateAudioResponse {
+  // NULL IMPLEMENTATION - Coming Soon
+  GenerationError error = 1; // Returns "NOT_IMPLEMENTED" with message
+  string message = 2;        // "Audio generation coming soon"
+  GenerationResult result = 3;
+  ModelInfo used_model = 4;
+}
+
+// ----- VIDEO GENERATION (NULL IMPLEMENTATION) -----
+
+message GenerateVideoRequest {
+  string prompt = 1;
+  GenerationContext context = 2;
+  ModelSelection model_selection = 3;
+  
+  // Video parameters
+  int32 duration = 4;
+  int32 width = 5;
+  int32 height = 6;
+  int32 fps = 7;
+  string style = 8;
+  
+  // Request metadata
+  string request_id = 9;
+  string client_id = 10;
+  string character_id = 11;
+  string user_id = 12;
+  google.protobuf.Duration timeout = 13;
+  
+  // Generation options
+  bool enable_cache = 14;
+  bool retry_on_failure = 15;
+}
+
+message GenerateVideoResponse {
+  // NULL IMPLEMENTATION - Coming Soon
+  GenerationError error = 1; // Returns "NOT_IMPLEMENTED" with message
+  string message = 2;        // "Video generation coming soon"
+  GenerationResult result = 3;
+  ModelInfo used_model = 4;
+}
+
+// ===================================================================
+// CONTEXT & SUPPORTING MESSAGES
+// ===================================================================
+
+message GenerationContext {
+  // Character context
+  string character_id = 1;
+  CharacterPersonality personality = 2;
+  
+  // Conversation history (for context)
+  repeated Message conversation_history = 3;
+  
+  // User preferences
+  map<string, string> user_preferences = 4;
+  
+  // Session information
+  string session_id = 5;
+  google.protobuf.Timestamp session_start = 6;
+  
+  // Custom metadata
+  map<string, string> metadata = 7;
+}
+
+message CharacterPersonality {
+  string name = 1;
+  string description = 2;
+  repeated string traits = 3;
+  string background = 4;
+  repeated string interests = 5;
+  string speaking_style = 6;
+  map<string, string> custom_fields = 7;
+}
+
+message Message {
+  string role = 1;        // "user", "assistant", "system"
+  string content = 2;
+  google.protobuf.Timestamp timestamp = 3;
+  map<string, string> metadata = 4;
+}
+
+// ===================================================================
+// RESULT & ERROR MESSAGES
+// ===================================================================
+
+message GenerationResult {
+  string result = 1;              // Main result (text, URL, etc.)
+  repeated string additional_data = 2; // Extra information
+  map<string, string> metadata = 3;     // Generation metadata
+  string content_type = 4;        // "text", "image_url", "audio_url", etc.
+  google.protobuf.Timestamp generated_at = 5;
+}
+
+message ModelInfo {
+  string model_id = 1;
+  string model_name = 2;
+  string provider_id = 3;
+  string provider_name = 4;
+  GenerationType generation_type = 5;
+  map<string, string> configuration = 6;
+  string version = 7;
+}
+
+message UsageStats {
+  int32 input_tokens = 1;
+  int32 output_tokens = 2;
+  int32 total_tokens = 3;
+  double cost_estimate = 4;
+  int32 requests_made = 5;
+  int32 cache_hits = 6;
+  int32 semantic_cache_hits = 7;
+}
+
+message GenerationError {
+  ErrorCode error_code = 1;
+  string error_message = 2;
+  string error_details = 3;
+  bool retryable = 4;
+  int32 retry_after_seconds = 5;
+  ErrorCategory category = 6;
+  
+  // Context about the error
+  string provider_id = 7;
+  string model_id = 8;
+  string request_id = 9;
+  
+  // Debug information
+  map<string, string> debug_info = 10;
+}
+
+enum ErrorCode {
+  ERROR_CODE_UNSPECIFIED = 0;
+  ERROR_CODE_SUCCESS = 1;
+  ERROR_CODE_INVALID_REQUEST = 2;
+  ERROR_CODE_AUTHENTICATION_FAILED = 3;
+  ERROR_CODE_ACCESS_DENIED = 4;
+  ERROR_CODE_MODEL_NOT_FOUND = 5;
+  ERROR_CODE_PROVIDER_UNAVAILABLE = 6;
+  ERROR_CODE_RATE_LIMIT_EXCEEDED = 7;
+  ERROR_CODE_QUOTA_EXCEEDED = 8;
+  ERROR_CODE_PROMPT_TOO_LONG = 9;
+  ERROR_CODE_PARAMETER_ERROR = 10;
+  ERROR_CODE_GENERATION_FAILED = 11;
+  ERROR_CODE_TIMEOUT = 12;
+  ERROR_CODE_INTERNAL_ERROR = 13;
+  ERROR_CODE_SERVICE_UNAVAILABLE = 14;
+  ERROR_CODE_NOT_IMPLEMENTED = 15;
+  ERROR_CODE_DATABASE_ERROR = 16;
+  ERROR_CODE_CACHE_ERROR = 17;
+  ERROR_CODE_VECTOR_DB_ERROR = 18;
+  ERROR_CODE_PROVIDER_TIMEOUT = 19;
+  ERROR_CODE_PROVIDER_RATE_LIMIT = 20;
+  ERROR_CODE_PROVIDER_AUTH_ERROR = 21;
+  ERROR_CODE_PROVIDER_QUOTA_EXCEEDED = 22;
+  ERROR_CODE_PROVIDER_INVALID_REQUEST = 23;
+  ERROR_CODE_PROVIDER_GENERATION_FAILED = 24;
+  ERROR_CODE_MAINTENANCE_MODE = 25;
+  ERROR_CODE_DEPRECATED_MODEL = 26;
+}
+
+enum ErrorCategory {
+  ERROR_CATEGORY_UNSPECIFIED = 0;
+  ERROR_CATEGORY_CLIENT = 1;           // Client error (4xx)
+  ERROR_CATEGORY_SERVER = 2;           // Server error (5xx)
+  ERROR_CATEGORY_PROVIDER = 3;         // Provider error
+  ERROR_CATEGORY_RATE_LIMIT = 4;       // Rate limiting
+  ERROR_CATEGORY_AUTHENTICATION = 5;   // Auth related
+  ERROR_CATEGORY_AUTHORIZATION = 6;    // Permission related
+  ERROR_CATEGORY_VALIDATION = 7;       // Input validation
+  ERROR_CATEGORY_QUOTA = 8;            // Quota/limit exceeded
+  ERROR_CATEGORY_NOT_FOUND = 9;        // Resource not found
+  ERROR_CATEGORY_NOT_IMPLEMENTED = 10; // Feature not implemented
+  ERROR_CATEGORY_MAINTENANCE = 11;     // Service maintenance
+  ERROR_CATEGORY_TEMPORARY = 12;       // Temporary error, retry later
+  ERROR_CATEGORY_PERMANENT = 13;       // Permanent error, no retry
+}
+
+// ===================================================================
+// ADMINISTRATIVE MESSAGES
+// ===================================================================
+
+message HealthCheckRequest {
+  bool include_details = 1;
+  bool check_providers = 2;
+  bool check_cache = 3;
+  bool check_database = 4;
+}
+
+message HealthCheckResponse {
+  ServiceStatus status = 1;
+  string message = 2;
+  google.protobuf.Timestamp timestamp = 3;
+  repeated ProviderHealth provider_health = 4;
+  SystemMetrics metrics = 5;
+}
+
+message ServiceStatus {
+  StatusCode status = 1;
+  int32 uptime_seconds = 2;
+  int32 total_requests = 3;
+  int32 active_requests = 4;
+  double cpu_usage = 5;
+  double memory_usage = 6;
+  int32 cache_hit_rate = 7;
+  int32 semantic_cache_hit_rate = 8;
+}
+
+enum StatusCode {
+  STATUS_CODE_HEALTHY = 0;
+  STATUS_CODE_DEGRADED = 1;
+  STATUS_CODE_UNHEALTHY = 2;
+  STATUS_CODE_MAINTENANCE = 3;
+  STATUS_CODE_UNKNOWN = 4;
+}
+
+message ProviderHealth {
+  string provider_id = 1;
+  string provider_name = 2;
+  bool is_healthy = 3;
+  int32 response_time_ms = 4;
+  repeated GenerationType supported_types = 5;
+  string error_message = 6;
+  google.protobuf.Timestamp last_check = 7;
+}
+
+message SystemMetrics {
+  int32 total_providers = 1;
+  int32 active_providers = 2;
+  int32 total_models = 3;
+  int32 active_models = 4;
+  int32 total_presets = 5;
+  int32 active_clients = 6;
+  int32 cache_size = 7;
+  int32 vector_cache_size = 8;
+}
+
+message ListModelsRequest {
+  GenerationType type = 1;
+  bool active_only = 2;
+  string provider_id = 3;
+  bool include_inactive = 4;
+}
+
+message ListModelsResponse {
+  repeated ModelInfo models = 1;
+  int32 total_count = 2;
+  int32 active_count = 3;
+}
+
+message ListPresetsRequest {
+  GenerationType type = 1;
+  string tier = 2;  // "free", "basic", "premium", "unlimited"
+  bool active_only = 3;
+}
+
+message ModelPreset {
+  string preset_id = 1;
+  string name = 2;
+  string description = 3;
+  string tier = 4;
+  GenerationType type = 5;
+  string model_id = 6;
+  ModelInfo model_info = 7;
+  map<string, string> parameters = 8;
+  bool is_default = 9;
+  bool is_active = 10;
+  map<string, string> features = 11;
+}
+
+message ListPresetsResponse {
+  repeated ModelPreset presets = 1;
+  int32 total_count = 2;
+  int32 active_count = 3;
+}
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ancatag/n-r",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "description": "Official Node.js/TypeScript SDK for Nova AI API with route-config-based orchestration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -41,7 +41,21 @@
   "engines": {
     "node": ">=18.0.0"
   },
+  "peerDependencies": {
+    "@grpc/grpc-js": "^1.14.3",
+    "@grpc/proto-loader": "^0.8.0"
+  },
+  "peerDependenciesMeta": {
+    "@grpc/grpc-js": {
+      "optional": true
+    },
+    "@grpc/proto-loader": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@grpc/grpc-js": "^1.14.3",
+    "@grpc/proto-loader": "^0.8.0",
     "@types/node": "^25.3.0",
     "@vitest/coverage-v8": "^4.0.18",
     "ts-node": "^10.9.2",
@@ -51,14 +65,10 @@
     "vitest": "^4.0.18"
   },
   "type": "module",
-  "dependencies": {
-    "@grpc/grpc-js": "^1.14.3",
-    "@grpc/proto-loader": "^0.8.0"
-  },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && mkdir -p dist/proto && cp src/proto/*.proto dist/proto/",
     "generate": "tsx ./scripts/generate.ts",
-    "dev": "tsc --watch",
+    "dev": "npm run build && tsc --watch",
     "clean": "rm -rf dist",
     "type-check": "tsc --noEmit",
     "test": "vitest run",