cactus-react-native 1.7.0 → 1.10.1

package/README.md

@@ -1018,6 +1018,10 @@ Releases all resources associated with the model. Automatically calls `stop()` f
 
 Returns available models.
 
+**`getModelName(): string`**
+
+Returns the model slug or path the instance was created with.
+
 ### useCactusLM Hook
 
 The `useCactusLM` hook manages a `CactusLM` instance with reactive state. When model parameters (`model`, `corpusDir`, `cacheIndex`, `options`) change, the hook creates a new instance and resets all state. The hook automatically cleans up resources when the component unmounts.
@@ -1111,6 +1115,15 @@ Feeds audio samples into the streaming session and returns the current transcrip
 
 Stops the streaming session and returns the final confirmed transcription text. Throws an error if no session is active.
 
+**`detectLanguage(params: CactusSTTDetectLanguageParams): Promise<CactusSTTDetectLanguageResult>`**
+
+Detects the spoken language in the given audio. Automatically calls `init()` if not already initialized. Throws an error if a generation is already in progress.
+
+**Parameters:**
+- `audio` - Path to the audio file or raw PCM samples as a byte array.
+- `options`:
+  - `useVad` - Whether to apply VAD before detection (default: `true`).
+
 **`audioEmbed(params: CactusSTTAudioEmbedParams): Promise<CactusSTTAudioEmbedResult>`**
 
 Generates embeddings for the given audio file. Automatically calls `init()` if not already initialized. Throws an error if a generation is already in progress.
@@ -1134,6 +1147,10 @@ Releases all resources associated with the model. Stops any active streaming ses
 
 Returns available speech-to-text models.
 
+**`getModelName(): string`**
+
+Returns the model slug or path the instance was created with.
+
 ### useCactusSTT Hook
 
 The `useCactusSTT` hook manages a `CactusSTT` instance with reactive state. When model parameters (`model`, `options`) change, the hook creates a new instance and resets all state. The hook automatically cleans up resources when the component unmounts.
@@ -1216,6 +1233,10 @@ Releases all resources associated with the model. Safe to call even if the model
 
 Returns available VAD models.
 
+**`getModelName(): string`**
+
+Returns the model slug or path the instance was created with.
+
 ### useCactusVAD Hook
 
 The `useCactusVAD` hook manages a `CactusVAD` instance with reactive state. When model parameters (`model`, `options`) change, the hook creates a new instance and resets all state. The hook automatically cleans up resources when the component unmounts.
@@ -1314,6 +1335,20 @@ The `useCactusIndex` hook manages a `CactusIndex` instance with reactive state.
 - `compact(): Promise<void>` - Optimizes the index. Sets `isProcessing` to `true` during operation.
 - `destroy(): Promise<void>` - Releases all resources. Automatically called when the component unmounts.
 
+### getRegistry
+
+**`getRegistry(): Promise<{ [key: string]: CactusModel }>`**
+
+Returns all available models from HuggingFace, keyed by model slug. Result is cached across calls.
+
+```typescript
+import { getRegistry } from 'cactus-react-native';
+
+const registry = await getRegistry();
+const model = registry['qwen3-0.6b'];
+console.log(model.quantization.int4.url);
+```
+
 ## Type Definitions
 
 ### CactusLMParams
@@ -1647,6 +1682,32 @@ interface CactusSTTStreamTranscribeStopResult {
 }
 ```
 
+### CactusSTTDetectLanguageOptions
+
+```typescript
+interface CactusSTTDetectLanguageOptions {
+  useVad?: boolean;
+}
+```
+
+### CactusSTTDetectLanguageParams
+
+```typescript
+interface CactusSTTDetectLanguageParams {
+  audio: string | number[];
+  options?: CactusSTTDetectLanguageOptions;
+}
+```
+
+### CactusSTTDetectLanguageResult
+
+```typescript
+interface CactusSTTDetectLanguageResult {
+  language: string;
+  confidence?: number;
+}
+```
+
 ### CactusVADParams
 
 ```typescript

package/android/gradle.properties

@@ -2,4 +2,4 @@ Cactus_kotlinVersion=2.0.21
 Cactus_minSdkVersion=24
 Cactus_targetSdkVersion=34
 Cactus_compileSdkVersion=35
-Cactus_ndkVersion=27.1.12297006
+Cactus_ndkVersion=28.2.13676358

package/cpp/HybridCactus.cpp

@@ -212,6 +212,54 @@ std::shared_ptr<Promise<std::string>> HybridCactus::transcribe(
   });
 }
 
+std::shared_ptr<Promise<std::string>> HybridCactus::detectLanguage(
+    const std::variant<std::vector<double>, std::string> &audio,
+    double responseBufferSize,
+    const std::optional<std::string> &optionsJson) {
+  return Promise<std::string>::async(
+      [this, audio, optionsJson, responseBufferSize]() -> std::string {
+        std::lock_guard<std::mutex> lock(this->_modelMutex);
+
+        if (!this->_model) {
+          throw std::runtime_error("Cactus model is not initialized");
+        }
+
+        std::string responseBuffer;
+        responseBuffer.resize(responseBufferSize);
+
+        int result;
+        if (std::holds_alternative<std::string>(audio)) {
+          result = cactus_detect_language(
+              this->_model, std::get<std::string>(audio).c_str(),
+              responseBuffer.data(), responseBufferSize,
+              optionsJson ? optionsJson->c_str() : nullptr, nullptr, 0);
+        } else {
+          const auto &audioDoubles = std::get<std::vector<double>>(audio);
+
+          std::vector<uint8_t> audioBytes;
+          audioBytes.reserve(audioDoubles.size());
+
+          for (double d : audioDoubles) {
+            d = std::clamp(d, 0.0, 255.0);
+            audioBytes.emplace_back(static_cast<uint8_t>(d));
+          }
+
+          result = cactus_detect_language(
+              this->_model, nullptr, responseBuffer.data(), responseBufferSize,
+              optionsJson ? optionsJson->c_str() : nullptr, audioBytes.data(),
+              audioBytes.size());
+        }
+
+        if (result < 0) {
+          throw std::runtime_error("Cactus detect language failed: " +
+                                   std::string(cactus_get_last_error()));
+        }
+
+        responseBuffer.resize(strlen(responseBuffer.c_str()));
+        return responseBuffer;
+      });
+}
+
 std::shared_ptr<Promise<void>> HybridCactus::streamTranscribeStart(
     const std::optional<std::string> &optionsJson) {
   return Promise<void>::async([this, optionsJson]() -> void {
@@ -477,7 +525,7 @@ std::shared_ptr<Promise<void>> HybridCactus::destroy() {
 std::shared_ptr<Promise<void>>
 HybridCactus::setTelemetryEnvironment(const std::string &cacheDir) {
   return Promise<void>::async([cacheDir]() -> void {
-    cactus_set_telemetry_environment("react-native-v1.7", cacheDir.c_str());
+    cactus_set_telemetry_environment("react-native", cacheDir.c_str(), "1.10.0");
   });
 }
 

package/cpp/HybridCactus.hpp

@@ -39,6 +39,11 @@ public:
                                              double /* tokenId */)>> &callback)
       override;
 
+  std::shared_ptr<Promise<std::string>>
+  detectLanguage(const std::variant<std::vector<double>, std::string> &audio,
+                 double responseBufferSize,
+                 const std::optional<std::string> &optionsJson) override;
+
   std::shared_ptr<Promise<void>>
   streamTranscribeStart(const std::optional<std::string> &optionsJson) override;
 

package/cpp/cactus_ffi.h

@@ -76,6 +76,16 @@ CACTUS_FFI_EXPORT int cactus_transcribe(
     size_t pcm_buffer_size
 );
 
+CACTUS_FFI_EXPORT int cactus_detect_language(
+    cactus_model_t model,
+    const char* audio_file_path,            // NULL if using pcm_buffer
+    char* response_buffer,
+    size_t buffer_size,
+    const char* options_json,               // optional
+    const uint8_t* pcm_buffer,              // NULL if using audio_file_path
+    size_t pcm_buffer_size
+);
+
 CACTUS_FFI_EXPORT cactus_stream_transcribe_t cactus_stream_transcribe_start(
     cactus_model_t model,
     const char* options_json                // optional
@@ -189,7 +199,10 @@ CACTUS_FFI_EXPORT void cactus_index_destroy(cactus_index_t index);
 
 CACTUS_FFI_EXPORT const char* cactus_get_last_error(void);
 
-CACTUS_FFI_EXPORT void cactus_set_telemetry_environment(const char* framework, const char* cache_location);
+CACTUS_FFI_EXPORT void cactus_set_telemetry_environment(const char* framework, const char* cache_location, const char* version);
+CACTUS_FFI_EXPORT void cactus_set_app_id(const char* app_id);
+CACTUS_FFI_EXPORT void cactus_telemetry_flush(void);
+CACTUS_FFI_EXPORT void cactus_telemetry_shutdown(void);
 
 #ifdef __cplusplus
 }

package/ios/cactus.xcframework/ios-arm64/cactus.framework/Headers/cactus_cloud.h

@@ -0,0 +1,48 @@
+#ifndef CACTUS_CLOUD_H
+#define CACTUS_CLOUD_H
+
+#include "cactus_utils.h"
+#include <string>
+#include <vector>
+
+namespace cactus {
+namespace ffi {
+
+struct CloudResponse {
+    std::string transcript;
+    std::string api_key_hash;
+    bool used_cloud = false;
+    std::string error;
+};
+
+struct CloudCompletionRequest {
+    std::vector<cactus::engine::ChatMessage> messages;
+    std::vector<ToolFunction> tools;
+    std::string local_output;
+    std::vector<std::string> local_function_calls;
+    bool has_images = false;
+    std::string cloud_key;
+};
+
+struct CloudCompletionResult {
+    bool ok = false;
+    bool used_cloud = false;
+    std::string response;
+    std::vector<std::string> function_calls;
+    std::string error;
+};
+
+std::string cloud_base64_encode(const uint8_t* data, size_t len);
+std::vector<uint8_t> cloud_build_wav(const uint8_t* pcm, size_t pcm_bytes);
+std::string resolve_cloud_api_key(const char* cloud_key_param);
+CloudResponse cloud_transcribe_request(const std::string& audio_b64,
+                                       const std::string& fallback_text,
+                                       long timeout_seconds = 15L,
+                                       const char* cloud_key = nullptr);
+CloudCompletionResult cloud_complete_request(const CloudCompletionRequest& request,
+                                             long timeout_ms);
+
+} // namespace ffi
+} // namespace cactus
+
+#endif // CACTUS_CLOUD_H

package/ios/cactus.xcframework/ios-arm64/cactus.framework/Headers/cactus_ffi.h

@@ -76,6 +76,16 @@ CACTUS_FFI_EXPORT int cactus_transcribe(
     size_t pcm_buffer_size
 );
 
+CACTUS_FFI_EXPORT int cactus_detect_language(
+    cactus_model_t model,
+    const char* audio_file_path,            // NULL if using pcm_buffer
+    char* response_buffer,
+    size_t buffer_size,
+    const char* options_json,               // optional
+    const uint8_t* pcm_buffer,              // NULL if using audio_file_path
+    size_t pcm_buffer_size
+);
+
 CACTUS_FFI_EXPORT cactus_stream_transcribe_t cactus_stream_transcribe_start(
     cactus_model_t model,
     const char* options_json                // optional
@@ -189,7 +199,10 @@ CACTUS_FFI_EXPORT void cactus_index_destroy(cactus_index_t index);
 
 CACTUS_FFI_EXPORT const char* cactus_get_last_error(void);
 
-CACTUS_FFI_EXPORT void cactus_set_telemetry_environment(const char* framework, const char* cache_location);
+CACTUS_FFI_EXPORT void cactus_set_telemetry_environment(const char* framework, const char* cache_location, const char* version);
+CACTUS_FFI_EXPORT void cactus_set_app_id(const char* app_id);
+CACTUS_FFI_EXPORT void cactus_telemetry_flush(void);
+CACTUS_FFI_EXPORT void cactus_telemetry_shutdown(void);
 
 #ifdef __cplusplus
 }