* @brief Creates a DuckDB scalar function with Infera execution metadata. * * Infera functions generally read or mutate model engine state, and many

Handles the download and caching of a remote model from a URL. If the model for the given URL is already present in the local cache, this function pe

Return the cache directory path used by Infera for remote models.

Sets the last error for the current thread. This stores the given error in a thread-local variable so it can be retrieved later by FFI clients using

* @brief Retrieves the last error message from the Infera Rust core. * @return A string containing the error message, or "unknown error" if not set.

* @brief Extracts numerical features from a DataChunk. * * Iterates over the input DataChunk (skipping the first column, which is the * model name)

* @brief Registers all the Infera functions with DuckDB. * * This internal helper function is called by the extension loading mechanism to * regist

* @brief Validates the input arguments and extracts the model name. * * Checks that there are at least two arguments and that the first argument (th

Clears the entire cache directory by deleting its contents. If the directory does not exist, this is a no-op.

Gets metadata about cached files sorted by access time (oldest first).

Compute (rows, cols) from a tensor shape by flattening all dimensions after the first into cols. Rules: - Scalar (shape = []): (1, 1) - 1D (shape = [

Updates the access time of a cached file by touching it.

Marks the file as "committed," preventing its deletion on drop. This should be called only after the file has been successfully and atomically moved t

Download a file from a URL to a local path with timeout, optionally verifying via ETag.

Evicts least recently used cache files until cache size is below limit.

Calculates total cache size in bytes.

Gets the cache size limit in bytes from environment variable or default.

* @brief Implements the `infera_clear_cache()` SQL function. * * Clears the entire model cache directory, freeing up disk space. * * @param args T

* @brief Implements the `infera_get_cache_info()` SQL function. * * Returns cache statistics as a JSON string. * * @param args The input arguments

* @brief Implements the `infera_get_loaded_models()` SQL function. * * Returns a JSON array of the names of all currently loaded models. * * @para

* @brief Implements the `infera_get_model_info(name)` SQL function. * * Retrieves metadata for a specific model and returns it as a JSON string. *

* @brief Implements the `infera_get_version()` SQL function. * * Fetches version and build information from the Rust core and returns it as a * JSO

* @brief Implements the `infera_load_model(name, path)` SQL function. * * Takes a model name and a file path/URL, passing them to the Rust core to

* @brief Implements the `infera_predict(name, ...features)` SQL function. * * Extracts features, runs inference using the Rust core, and populates t

* @brief Implements the `infera_predict_from_blob(name, blob)` SQL function. * * Runs inference on raw blob data. The result is a list of floats. *

* @brief Implements the `infera_predict_multi(name, ...features)` SQL function. * * Similar to `Predict`, but returns the model's output as a JSON-e

* @brief Implements the `infera_predict_multi_list(name, ...features)` SQL function. * * Similar to `PredictMulti`, but returns the model's output a

* @brief Implements the `infera_set_autoload_dir(path)` SQL function. * * This function takes a directory path, passes it to the Rust core to load a

* @brief Implements the `infera_unload_model(name)` SQL function. * * Unloads a model from the Infera engine by its name. * * @param args The inpu

Creates a new `InferaInferenceResult` representing an error state. The `data` pointer is null and the `status` is set to -1.

Load configuration from environment variables

Get cache directory from INFERA_CACHE_DIR or default

Get cache eviction strategy from INFERA_CACHE_EVICTION or default (LRU)

Get cache size limit from INFERA_CACHE_SIZE_LIMIT or default (1GB)

Get HTTP retry attempts from INFERA_HTTP_RETRY_ATTEMPTS or default (3)

Get HTTP retry delay from INFERA_HTTP_RETRY_DELAY or default (1000ms)

Get HTTP timeout from INFERA_HTTP_TIMEOUT or default (30 seconds)

Get log level from INFERA_LOG_LEVEL or default (WARN)

Get verbose logging setting from INFERA_VERBOSE or default (false)

Exported entry point expected by DuckDB when loading a C++ loadable extension. The build system passes -Wl,-exported_symbol,_infera_duckdb_cpp_init so

Legacy/alternative entry point used by some tooling paths.

Creates a new guard for the given path.

Check if a log message should be printed based on current log level