Symbol visibility macro for all exported symbols.
void(* entropic_error_callback_t)(entropic_error_t code, const char *message, void *user_data)
Error callback type for async error reporting.
ENTROPIC_EXPORT const char * entropic_error_name(entropic_error_t code)
Get the human-readable name for an error code.
entropic_error_t
Error codes returned by all C API functions.
@ ENTROPIC_ERROR_NOT_IMPLEMENTED
Feature stub, not yet available (v1.8.9)
@ ENTROPIC_ERROR_TOOL_NOT_FOUND
Requested tool not registered.
@ ENTROPIC_ERROR_TIER_MODEL_TOO_LARGE
A single tier's model weights+KV exceed the engine's VRAM budget; eviction cannot help (v2....
@ ENTROPIC_ERROR_NO_VISION_TIER
Image content present but no vision-capable tier (v2.1.8, gh#41)
@ ENTROPIC_ERROR_ADAPTER_SWAP_FAILED
Swap failed (e.g., base model not ACTIVE) (v1.9.2)
@ ENTROPIC_ERROR_ADAPTER_NOT_FOUND
Adapter name not recognized (v1.9.2)
@ ENTROPIC_ERROR_IN_USE
Resource is currently active and cannot be removed (v1.9.6)
@ ENTROPIC_ERROR_CANCELLED
Operation cancelled via cancel token.
@ ENTROPIC_ERROR_ALREADY_EXISTS
Named resource already exists (v1.9.6)
@ ENTROPIC_ERROR_INTERNAL
Unexpected internal error (bug)
@ ENTROPIC_ERROR_COMPACTION_FAILED
Custom compactor returned non-zero and default fallback also failed (v1.9.9)
@ ENTROPIC_ERROR_ALREADY_RUNNING
entropic_run already in progress on handle (v1.8.9)
@ ENTROPIC_ERROR_SERVER_NOT_FOUND
MCP server name not found (v1.8.7)
@ ENTROPIC_ERROR_IDENTITY_NOT_FOUND
Identity name not in config (v1.8.9)
@ ENTROPIC_ERROR_SERVER_ALREADY_EXISTS
MCP server name already registered (v1.8.7)
@ ENTROPIC_ERROR_NOT_RUNNING
Interrupt called but nothing running (v1.8.9)
@ ENTROPIC_ERROR_STATE_INCOMPATIBLE
State buffer incompatible with current model (v1.9.13)
@ ENTROPIC_ERROR_TIMEOUT
Operation exceeded time limit.
@ ENTROPIC_ERROR_GRAMMAR_NOT_FOUND
Grammar key not in registry (v1.9.3)
@ ENTROPIC_ERROR_PLUGIN_LOAD_FAILED
dlopen/dlsym failed on plugin .so
@ ENTROPIC_ERROR_CONNECTION_FAILED
Transport connection failed (v1.8.7)
@ ENTROPIC_ERROR_IMAGE_LOAD_FAILED
Image file could not be read or decoded (v1.9.11)
@ ENTROPIC_ERROR_UNSUPPORTED_URL
Remote URL not supported — local file or data URI only (v1.9.11)
@ ENTROPIC_ERROR_INVALID_ARGUMENT
NULL pointer, empty string, out-of-range value.
@ ENTROPIC_ERROR_QUEUE_FULL
Mid-gen user-message queue at capacity (v2.1.10, gh#40)
@ ENTROPIC_ERROR_EVAL_CONTEXT_FULL
Sequence exceeds model context window (v1.9.10)
@ ENTROPIC_ERROR_TOOL_EXECUTION_FAILED
Tool call returned error (v1.8.9)
@ ENTROPIC_ERROR_IMAGE_TOO_LARGE
Image exceeds max_file_size (v1.9.11)
@ ENTROPIC_ERROR_VALIDATION_FAILED
Critique generation failed — infrastructure, not content (v1.9.8)
@ ENTROPIC_ERROR_INVALID_HANDLE
NULL or destroyed handle (v1.8.9)
@ ENTROPIC_ERROR_OUT_OF_MEMORY
Allocation failed (system RAM or VRAM)
@ ENTROPIC_ERROR_MMPROJ_LOAD_FAILED
mmproj GGUF failed to load (v1.9.11)
@ ENTROPIC_ERROR_TIME_LIMIT_EXCEEDED
Generation terminated by time cap (v1.9.7)
@ ENTROPIC_ERROR_STORAGE_FAILED
Storage operation failed (v1.8.9)
@ ENTROPIC_ERROR_EVAL_FAILED
Evaluation failed (llama_decode error) (v1.9.10)
@ ENTROPIC_ERROR_PLUGIN_VERSION_MISMATCH
Plugin API version != engine expected version.
@ ENTROPIC_ERROR_ADAPTER_LOAD_FAILED
LoRA file invalid or incompatible with base model (v1.9.2)
@ ENTROPIC_ERROR_GRAMMAR_INVALID
GBNF parse failed (v1.9.3)
@ ENTROPIC_ERROR_NOT_SUPPORTED
Capability not supported by this backend (v1.9.13)
@ ENTROPIC_ERROR_LIMIT_REACHED
Resource limit exceeded (e.g., max_identities) (v1.9.6)
@ ENTROPIC_ERROR_PROFILE_NOT_FOUND
Profile name not in registry (v1.9.7)
@ ENTROPIC_ERROR_ADAPTER_CANCELLED
ON_ADAPTER_SWAP hook cancelled the operation (v1.9.2)
@ ENTROPIC_ERROR_IO
File/network I/O error.
@ ENTROPIC_ERROR_GENERATE_FAILED
Generation failed (context overflow, model error)
@ ENTROPIC_ERROR_INVALID_CONFIG
Config validation failed (missing fields, bad values)
@ ENTROPIC_ERROR_INVALID_STATE
Operation not valid in current state (e.g., generate before activate)
@ ENTROPIC_ERROR_MODEL_NOT_FOUND
Model file does not exist at resolved path.
@ ENTROPIC_ERROR_PERMISSION_DENIED
Tool call blocked by permission manager.
@ ENTROPIC_ERROR_MODEL_NOT_ACTIVE
Model exists but not in ACTIVE state (v1.9.10)
@ ENTROPIC_ERROR_SPECULATIVE_INCOMPATIBLE_ARCH
Target/draft architecture is recurrent or hybrid; speculative refused (v2.1.11, gh#36)
@ ENTROPIC_ERROR_INTERRUPTED
Operation interrupted via entropic_interrupt (v1.8.9)
@ ENTROPIC_ERROR_MCP_KEY_DENIED
Tool call denied by MCP key set (v1.9.4)
@ ENTROPIC_ERROR_LOAD_FAILED
Model load failed (corrupt file, OOM, unsupported format)
ENTROPIC_EXPORT const char * entropic_last_error(entropic_handle_t handle)
Get the last error message for a handle.
struct entropic_engine * entropic_handle_t
Opaque handle to an entropic engine instance.
ENTROPIC_EXPORT entropic_error_t entropic_set_error_callback(entropic_handle_t handle, entropic_error_callback_t callback, void *user_data)
Register an error callback on a handle.
Engine handle struct — owns all subsystems.