Entropic 2.3.8
Local-first agentic inference engine
Loading...
Searching...
No Matches
error.h
Go to the documentation of this file.
1// SPDX-License-Identifier: Apache-2.0
20#pragma once
21
22#include <stddef.h>
24
25#ifdef __cplusplus
26extern "C" {
27#endif
28
35typedef enum {
91
99
112ENTROPIC_EXPORT const char* entropic_last_error(entropic_handle_t handle);
113
130ENTROPIC_EXPORT const char* entropic_error_name(entropic_error_t code);
131
146 entropic_error_t code,
147 const char* message,
148 void* user_data);
149
163 entropic_handle_t handle,
165 void* user_data);
166
167#ifdef __cplusplus
168}
169#endif
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.
Definition error.h:145
ENTROPIC_EXPORT const char * entropic_error_name(entropic_error_t code)
Get the human-readable name for an error code.
Definition error.cpp:84
entropic_error_t
Error codes returned by all C API functions.
Definition error.h:35
@ ENTROPIC_OK
Success.
Definition error.h:36
@ ENTROPIC_ERROR_NOT_IMPLEMENTED
Feature stub, not yet available (v1.8.9)
Definition error.h:61
@ ENTROPIC_ERROR_TOOL_NOT_FOUND
Requested tool not registered.
Definition error.h:43
@ ENTROPIC_ERROR_TIER_MODEL_TOO_LARGE
A single tier's model weights+KV exceed the engine's VRAM budget; eviction cannot help (v2....
Definition error.h:89
@ ENTROPIC_ERROR_NO_VISION_TIER
Image content present but no vision-capable tier (v2.1.8, gh#41)
Definition error.h:86
@ ENTROPIC_ERROR_ADAPTER_SWAP_FAILED
Swap failed (e.g., base model not ACTIVE) (v1.9.2)
Definition error.h:65
@ ENTROPIC_ERROR_ADAPTER_NOT_FOUND
Adapter name not recognized (v1.9.2)
Definition error.h:63
@ ENTROPIC_ERROR_IN_USE
Resource is currently active and cannot be removed (v1.9.6)
Definition error.h:72
@ ENTROPIC_ERROR_CANCELLED
Operation cancelled via cancel token.
Definition error.h:48
@ ENTROPIC_ERROR_ALREADY_EXISTS
Named resource already exists (v1.9.6)
Definition error.h:71
@ ENTROPIC_ERROR_INTERNAL
Unexpected internal error (bug)
Definition error.h:51
@ ENTROPIC_ERROR_COMPACTION_FAILED
Custom compactor returned non-zero and default fallback also failed (v1.9.9)
Definition error.h:76
@ ENTROPIC_ERROR_ALREADY_RUNNING
entropic_run already in progress on handle (v1.8.9)
Definition error.h:59
@ ENTROPIC_ERROR_SERVER_NOT_FOUND
MCP server name not found (v1.8.7)
Definition error.h:53
@ ENTROPIC_ERROR_IDENTITY_NOT_FOUND
Identity name not in config (v1.8.9)
Definition error.h:58
@ ENTROPIC_ERROR_SERVER_ALREADY_EXISTS
MCP server name already registered (v1.8.7)
Definition error.h:52
@ ENTROPIC_ERROR_NOT_RUNNING
Interrupt called but nothing running (v1.8.9)
Definition error.h:60
@ ENTROPIC_ERROR_STATE_INCOMPATIBLE
State buffer incompatible with current model (v1.9.13)
Definition error.h:85
@ ENTROPIC_ERROR_TIMEOUT
Operation exceeded time limit.
Definition error.h:47
@ ENTROPIC_ERROR_GRAMMAR_NOT_FOUND
Grammar key not in registry (v1.9.3)
Definition error.h:67
@ ENTROPIC_ERROR_PLUGIN_LOAD_FAILED
dlopen/dlsym failed on plugin .so
Definition error.h:46
@ ENTROPIC_ERROR_CONNECTION_FAILED
Transport connection failed (v1.8.7)
Definition error.h:54
@ ENTROPIC_ERROR_IMAGE_LOAD_FAILED
Image file could not be read or decoded (v1.9.11)
Definition error.h:80
@ ENTROPIC_ERROR_UNSUPPORTED_URL
Remote URL not supported — local file or data URI only (v1.9.11)
Definition error.h:83
@ ENTROPIC_ERROR_INVALID_ARGUMENT
NULL pointer, empty string, out-of-range value.
Definition error.h:37
@ ENTROPIC_ERROR_QUEUE_FULL
Mid-gen user-message queue at capacity (v2.1.10, gh#40)
Definition error.h:87
@ ENTROPIC_ERROR_EVAL_CONTEXT_FULL
Sequence exceeds model context window (v1.9.10)
Definition error.h:78
@ ENTROPIC_ERROR_TOOL_EXECUTION_FAILED
Tool call returned error (v1.8.9)
Definition error.h:56
@ ENTROPIC_ERROR_IMAGE_TOO_LARGE
Image exceeds max_file_size (v1.9.11)
Definition error.h:81
@ ENTROPIC_ERROR_VALIDATION_FAILED
Critique generation failed — infrastructure, not content (v1.9.8)
Definition error.h:75
@ ENTROPIC_ERROR_INVALID_HANDLE
NULL or destroyed handle (v1.8.9)
Definition error.h:55
@ ENTROPIC_ERROR_OUT_OF_MEMORY
Allocation failed (system RAM or VRAM)
Definition error.h:49
@ ENTROPIC_ERROR_MMPROJ_LOAD_FAILED
mmproj GGUF failed to load (v1.9.11)
Definition error.h:82
@ ENTROPIC_ERROR_TIME_LIMIT_EXCEEDED
Generation terminated by time cap (v1.9.7)
Definition error.h:74
@ ENTROPIC_ERROR_STORAGE_FAILED
Storage operation failed (v1.8.9)
Definition error.h:57
@ ENTROPIC_ERROR_EVAL_FAILED
Evaluation failed (llama_decode error) (v1.9.10)
Definition error.h:79
@ ENTROPIC_ERROR_PLUGIN_VERSION_MISMATCH
Plugin API version != engine expected version.
Definition error.h:45
@ ENTROPIC_ERROR_ADAPTER_LOAD_FAILED
LoRA file invalid or incompatible with base model (v1.9.2)
Definition error.h:64
@ ENTROPIC_ERROR_GRAMMAR_INVALID
GBNF parse failed (v1.9.3)
Definition error.h:68
@ ENTROPIC_ERROR_NOT_SUPPORTED
Capability not supported by this backend (v1.9.13)
Definition error.h:84
@ ENTROPIC_ERROR_LIMIT_REACHED
Resource limit exceeded (e.g., max_identities) (v1.9.6)
Definition error.h:70
@ ENTROPIC_ERROR_PROFILE_NOT_FOUND
Profile name not in registry (v1.9.7)
Definition error.h:73
@ ENTROPIC_ERROR_ADAPTER_CANCELLED
ON_ADAPTER_SWAP hook cancelled the operation (v1.9.2)
Definition error.h:66
@ ENTROPIC_ERROR_IO
File/network I/O error.
Definition error.h:50
@ ENTROPIC_ERROR_GENERATE_FAILED
Generation failed (context overflow, model error)
Definition error.h:42
@ ENTROPIC_ERROR_INVALID_CONFIG
Config validation failed (missing fields, bad values)
Definition error.h:38
@ ENTROPIC_ERROR_INVALID_STATE
Operation not valid in current state (e.g., generate before activate)
Definition error.h:39
@ ENTROPIC_ERROR_MODEL_NOT_FOUND
Model file does not exist at resolved path.
Definition error.h:40
@ ENTROPIC_ERROR_PERMISSION_DENIED
Tool call blocked by permission manager.
Definition error.h:44
@ ENTROPIC_ERROR_MODEL_NOT_ACTIVE
Model exists but not in ACTIVE state (v1.9.10)
Definition error.h:77
@ ENTROPIC_ERROR_SPECULATIVE_INCOMPATIBLE_ARCH
Target/draft architecture is recurrent or hybrid; speculative refused (v2.1.11, gh#36)
Definition error.h:88
@ ENTROPIC_ERROR_INTERRUPTED
Operation interrupted via entropic_interrupt (v1.8.9)
Definition error.h:62
@ ENTROPIC_ERROR_MCP_KEY_DENIED
Tool call denied by MCP key set (v1.9.4)
Definition error.h:69
@ ENTROPIC_ERROR_LOAD_FAILED
Model load failed (corrupt file, OOM, unsupported format)
Definition error.h:41
ENTROPIC_EXPORT const char * entropic_last_error(entropic_handle_t handle)
Get the last error message for a handle.
Definition entropic.cpp:90
struct entropic_engine * entropic_handle_t
Opaque handle to an entropic engine instance.
Definition error.h:98
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.
Definition error.cpp:98
Engine handle struct — owns all subsystems.