entropic-engine 2.2.0__tar.gz → 2.2.1__tar.gz

{entropic_engine-2.2.0/python/src/entropic_engine.egg-info → entropic_engine-2.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: entropic-engine
-Version: 2.2.0
+Version: 2.2.1
 Summary: Local-first agentic inference engine — Python wrapper over librentropic.so
 Author: Tristan VanFossen
 License-Expression: LGPL-3.0-or-later

entropic_engine-2.2.1/VERSION

@@ -0,0 +1 @@
+2.2.1

{entropic_engine-2.2.0 → entropic_engine-2.2.1}/python/src/entropic/__init__.py

@@ -44,58 +44,16 @@ except PackageNotFoundError:  # pragma: no cover — uninstalled source-tree run
     _version_file = Path(__file__).resolve().parents[3] / "VERSION"
     __version__ = _version_file.read_text().strip() if _version_file.exists() else "0.0.0+local"
 
-_LAZY_EXPORTS = frozenset(
-    {
-        "AgentState",
-        "EntropicError",
-        # Issue #8 (v2.1.4): EntropicHookPoint enum + 4 new ABI symbols.
-        "EntropicHookPoint",
-        "HOOK_CB",
-        # gh#22 (v2.1.5): C-ABI-documentation-spelled CFUNCTYPE aliases.
-        "HOOK_CALLBACK_CB",
-        "TOKEN_STREAM_CB",
-        "STATE_OBSERVER_CB",
-        "STREAM_OBSERVER_CB",
-        "TOKEN_CB",
-        # gh#29 (v2.1.5): delegation callbacks — replaces auto-merge.
-        "DELEGATION_START_CB",
-        "DELEGATION_COMPLETE_CB",
-        "EntDecision",
-        "EntDelegationRequest",
-        "EntDelegationResult",
-        "entropic_set_delegation_callbacks",
-        # gh#30 (v2.1.5): validation retry controls.
-        "ATTEMPT_BOUNDARY_CB",
-        "entropic_set_attempt_boundary_cb",
-        "entropic_validation_accept_last",
-        "entropic_validation_resume_retry",
-        "entropic_validation_set_auto_retry",
-        "entropic_alloc",
-        "entropic_api_version",
-        "entropic_configure_dir",
-        "entropic_context_clear",
-        "entropic_context_count",
-        # gh#22 (v2.1.5): closes gh#8 partial gap.
-        "entropic_context_get",
-        # gh#39 (v2.1.8): token-level context pressure.
-        "entropic_context_usage",
-        "entropic_create",
-        "entropic_destroy",
-        "entropic_free",
-        "entropic_handle_t",
-        "entropic_interrupt",
-        "entropic_register_hook",
-        "entropic_register_mcp_server",
-        "entropic_run",
-        "entropic_run_streaming",
-        # gh#37 (v2.1.8): multimodal messages entry points.
-        "entropic_run_messages",
-        "entropic_run_messages_streaming",
-        "entropic_set_state_observer",
-        "entropic_set_stream_observer",
-        "entropic_version",
-    }
-)
+# v2.2.1: the lazy-export set is now derived from the auto-generated
+# manifest emitted by ``scripts/gen_bindings.py``. The manifest module
+# does NOT import ctypes or load librentropic.so, so reading it here
+# preserves the PEP 562 lazy-binding contract: ``entropic install-engine``
+# can run before the .so exists on disk and still ``import entropic``
+# successfully. The set covers every ENTROPIC_EXPORT in the C header
+# plus the IntEnum / Structure / CFUNCTYPE typedefs the generator
+# produces. To audit the surface, read
+# ``python/src/entropic/_bindings_manifest.py``.
+from entropic._bindings_manifest import EXPORTS as _LAZY_EXPORTS
 
 # Issue #8 (v2.1.4): Pythonic facade — top-level re-exports of the
 # decorator + helpers from the per-module surfaces. Keeps `entropic`

entropic_engine-2.2.1/python/src/entropic/_bindings.py

@@ -0,0 +1,336 @@
+# SPDX-License-Identifier: LGPL-3.0-or-later
+# AUTO-GENERATED by scripts/gen_bindings.py — do not edit.
+# Run ``inv gen-bindings`` to regenerate; ``inv gen-bindings --check``
+# runs in pre-commit and fails if the committed file drifts from the
+# header. Source: include/entropic/entropic.h + types/*.h.
+"""ctypes bindings for librentropic.so (auto-generated).
+
+This module exposes the entropic C ABI as a flat collection of ctypes
+function objects, IntEnum classes, ctypes.Structure types, and CFUNCTYPE
+callback typedefs. Symbol names match the C header verbatim.
+
+For symbols not exposed here (none, by construction — the generator
+covers every ENTROPIC_EXPORT in entropic.h), load librentropic.so
+directly via :func:`entropic._loader.load`.
+"""
+
+from __future__ import annotations
+
+import ctypes
+import enum
+
+from entropic._loader import load
+
+_lib = load()
+
+# Opaque handle. C side: ``struct entropic_engine*``. From Python it is
+# a void* the C functions interpret; pass ``ctypes.byref(handle)`` for
+# out-params and ``handle`` for in-params.
+entropic_handle_t = ctypes.c_void_p
+
+
+## @brief Pin restype/argtypes on a ctypes symbol from the loaded .so.
+## @utility
+## @version 2.2.1
+def _bind(name, restype, *argtypes):
+    """Pin restype/argtypes on a symbol from the loaded library.
+
+    Helper used by every binding line below.
+    """
+    fn = getattr(_lib, name)
+    fn.restype = restype
+    fn.argtypes = list(argtypes)
+    return fn
+
+
+# ── Enums ─────────────────────────────────────
+
+class EntropicError(enum.IntEnum):
+    """Mirrors ``entropic_error_t`` from the C header."""
+
+    OK = 0
+    INVALID_ARGUMENT = 1
+    INVALID_CONFIG = 2
+    INVALID_STATE = 3
+    MODEL_NOT_FOUND = 4
+    LOAD_FAILED = 5
+    GENERATE_FAILED = 6
+    TOOL_NOT_FOUND = 7
+    PERMISSION_DENIED = 8
+    PLUGIN_VERSION_MISMATCH = 9
+    PLUGIN_LOAD_FAILED = 10
+    TIMEOUT = 11
+    CANCELLED = 12
+    OUT_OF_MEMORY = 13
+    IO = 14
+    INTERNAL = 15
+    SERVER_ALREADY_EXISTS = 16
+    SERVER_NOT_FOUND = 17
+    CONNECTION_FAILED = 18
+    INVALID_HANDLE = 19
+    TOOL_EXECUTION_FAILED = 20
+    STORAGE_FAILED = 21
+    IDENTITY_NOT_FOUND = 22
+    ALREADY_RUNNING = 23
+    NOT_RUNNING = 24
+    NOT_IMPLEMENTED = 25
+    INTERRUPTED = 26
+    ADAPTER_NOT_FOUND = 27
+    ADAPTER_LOAD_FAILED = 28
+    ADAPTER_SWAP_FAILED = 29
+    ADAPTER_CANCELLED = 30
+    GRAMMAR_NOT_FOUND = 31
+    GRAMMAR_INVALID = 32
+    MCP_KEY_DENIED = 33
+    LIMIT_REACHED = 34
+    ALREADY_EXISTS = 35
+    IN_USE = 36
+    PROFILE_NOT_FOUND = 37
+    TIME_LIMIT_EXCEEDED = 38
+    VALIDATION_FAILED = 39
+    COMPACTION_FAILED = 40
+    MODEL_NOT_ACTIVE = 41
+    EVAL_CONTEXT_FULL = 42
+    EVAL_FAILED = 43
+    IMAGE_LOAD_FAILED = 44
+    IMAGE_TOO_LARGE = 45
+    MMPROJ_LOAD_FAILED = 46
+    UNSUPPORTED_URL = 47
+    NOT_SUPPORTED = 48
+    STATE_INCOMPATIBLE = 49
+    NO_VISION_TIER = 50
+    QUEUE_FULL = 51
+    SPECULATIVE_INCOMPATIBLE_ARCH = 52
+
+class AgentState(enum.IntEnum):
+    """Mirrors ``entropic_agent_state_t`` from the C header."""
+
+    IDLE = 0
+    PLANNING = 1
+    EXECUTING = 2
+    WAITING_TOOL = 3
+    VERIFYING = 4
+    DELEGATING = 5
+    COMPLETE = 6
+    ERROR = 7
+    INTERRUPTED = 8
+    PAUSED = 9
+
+class EntropicModelState(enum.IntEnum):
+    """Mirrors ``entropic_model_state_t`` from the C header."""
+
+    COLD = 0
+    WARM = 1
+    ACTIVE = 2
+
+class EntropicDirectiveType(enum.IntEnum):
+    """Mirrors ``entropic_directive_type_t`` from the C header."""
+
+    STOP_PROCESSING = 0
+    TIER_CHANGE = 1
+    DELEGATE = 2
+    PIPELINE = 3
+    COMPLETE = 4
+    CLEAR_SELF_TODOS = 5
+    INJECT_CONTEXT = 6
+    PRUNE_MESSAGES = 7
+    CONTEXT_ANCHOR = 8
+    PHASE_CHANGE = 9
+    NOTIFY_PRESENTER = 10
+
+class EntropicComputeBackend(enum.IntEnum):
+    """Mirrors ``entropic_compute_backend_t`` from the C header."""
+
+    CPU = 0
+    CUDA = 1
+    VULKAN = 2
+
+class EntropicHookPoint(enum.IntEnum):
+    """Mirrors ``entropic_hook_point_t`` from the C header."""
+
+    PRE_GENERATE = 0
+    POST_GENERATE = 1
+    ON_STREAM_TOKEN = 2
+    PRE_TOOL_CALL = 3
+    POST_TOOL_CALL = 4
+    ON_LOOP_ITERATION = 5
+    ON_STATE_CHANGE = 6
+    ON_ERROR = 7
+    ON_DELEGATE = 8
+    ON_DELEGATE_COMPLETE = 9
+    ON_CONTEXT_ASSEMBLE = 10
+    ON_PRE_COMPACT = 11
+    ON_POST_COMPACT = 12
+    ON_MODEL_LOAD = 13
+    ON_MODEL_UNLOAD = 14
+    ON_PERMISSION_CHECK = 15
+    ON_ADAPTER_SWAP = 16
+    ON_VRAM_PRESSURE = 17
+    ON_DIRECTIVE = 18
+    ON_CUSTOM_DIRECTIVE = 19
+    ON_LOOP_START = 20
+    ON_LOOP_END = 21
+    ON_COMPLETE = 22
+
+class EntDecision(enum.IntEnum):
+    """Mirrors ``ent_decision_t`` from the C header."""
+
+    ACCEPT = 0
+    REJECT = 1
+
+class EntropicMcpAccessLevel(enum.IntEnum):
+    """Mirrors ``entropic_mcp_access_level_t`` from the C header."""
+
+    NONE = 0
+    READ = 1
+    WRITE = 2
+
+# ── Structs ───────────────────────────────────
+
+class EntDelegationRequest(ctypes.Structure):
+    """Mirrors ``ent_delegation_request_t`` from the C header."""
+
+    _fields_ = [
+        ("delegation_id", ctypes.c_char_p),
+        ("target_tier", ctypes.c_char_p),
+        ("task", ctypes.c_char_p),
+        ("depth", ctypes.c_int),
+        ("is_pipeline", ctypes.c_int),
+    ]
+
+class EntDelegationResult(ctypes.Structure):
+    """Mirrors ``ent_delegation_result_t`` from the C header."""
+
+    _fields_ = [
+        ("delegation_id", ctypes.c_char_p),
+        ("target_tier", ctypes.c_char_p),
+        ("success", ctypes.c_int),
+        ("summary", ctypes.c_char_p),
+        ("patch", ctypes.c_char_p),
+        ("patch_len", ctypes.c_size_t),
+        ("files_touched", ctypes.POINTER(ctypes.c_char_p)),
+        ("files_touched_len", ctypes.c_size_t),
+    ]
+
+class EntropicLogprobResult(ctypes.Structure):
+    """Mirrors ``entropic_logprob_result_t`` from the C header."""
+
+    _fields_ = [
+        ("logprobs", ctypes.POINTER(ctypes.c_float)),
+        ("tokens", ctypes.POINTER(ctypes.c_int32)),
+        ("perplexity", ctypes.c_float),
+        ("total_logprob", ctypes.c_float),
+        ("n_tokens", ctypes.c_int),
+        ("n_logprobs", ctypes.c_int),
+    ]
+
+# ── Callback typedefs (named) ─────────────────
+
+HOOK_CB = ctypes.CFUNCTYPE(ctypes.c_int, ctypes.c_int, ctypes.c_char_p, ctypes.POINTER(ctypes.c_char_p), ctypes.c_void_p)
+DELEGATION_START_CB = ctypes.CFUNCTYPE(ctypes.c_int, ctypes.POINTER(EntDelegationRequest), ctypes.c_void_p)
+DELEGATION_COMPLETE_CB = ctypes.CFUNCTYPE(ctypes.c_int, ctypes.POINTER(EntDelegationResult), ctypes.c_void_p)
+ATTEMPT_BOUNDARY_CB = ctypes.CFUNCTYPE(None, ctypes.c_int, ctypes.c_void_p)
+COMPACTOR_CB = ctypes.CFUNCTYPE(ctypes.c_int, ctypes.c_char_p, ctypes.c_char_p, ctypes.POINTER(ctypes.c_char_p), ctypes.POINTER(ctypes.c_char_p), ctypes.c_void_p)
+
+# ── Callback typedefs (from inline params) ────
+
+TOKEN_CB = ctypes.CFUNCTYPE(None, ctypes.c_char_p, ctypes.c_size_t, ctypes.c_void_p)
+STREAM_OBSERVER_CB = ctypes.CFUNCTYPE(None, ctypes.c_char_p, ctypes.c_size_t, ctypes.c_void_p)
+STATE_OBSERVER_CB = ctypes.CFUNCTYPE(None, ctypes.c_int, ctypes.c_void_p)
+CRITIQUE_START_CB = ctypes.CFUNCTYPE(None, ctypes.c_void_p)
+CRITIQUE_END_CB = ctypes.CFUNCTYPE(None, ctypes.c_void_p)
+QUEUE_OBSERVER_CB = ctypes.CFUNCTYPE(None, ctypes.c_char_p, ctypes.c_size_t, ctypes.c_void_p)
+
+# gh#22 backward-compat aliases for the CFUNCTYPE typedefs.
+HOOK_CALLBACK_CB = HOOK_CB
+TOKEN_STREAM_CB = TOKEN_CB
+
+# ── Bindings ──────────────────────────────────
+
+entropic_create = _bind("entropic_create", ctypes.c_int, ctypes.POINTER(entropic_handle_t))
+entropic_configure = _bind("entropic_configure", ctypes.c_int, entropic_handle_t, ctypes.c_char_p)
+entropic_configure_from_file = _bind("entropic_configure_from_file", ctypes.c_int, entropic_handle_t, ctypes.c_char_p)
+entropic_configure_dir = _bind("entropic_configure_dir", ctypes.c_int, entropic_handle_t, ctypes.c_char_p)
+entropic_destroy = _bind("entropic_destroy", None, entropic_handle_t)
+entropic_version = _bind("entropic_version", ctypes.c_char_p)
+entropic_api_version = _bind("entropic_api_version", ctypes.c_int)
+entropic_alloc = _bind("entropic_alloc", ctypes.c_void_p, ctypes.c_size_t)
+entropic_free = _bind("entropic_free", None, ctypes.c_void_p)
+entropic_run = _bind("entropic_run", ctypes.c_int, entropic_handle_t, ctypes.c_char_p, ctypes.POINTER(ctypes.c_char_p))
+entropic_run_streaming = _bind("entropic_run_streaming", ctypes.c_int, entropic_handle_t, ctypes.c_char_p, TOKEN_CB, ctypes.c_void_p, ctypes.POINTER(ctypes.c_int))
+entropic_run_messages = _bind("entropic_run_messages", ctypes.c_int, entropic_handle_t, ctypes.c_char_p, ctypes.POINTER(ctypes.c_char_p))
+entropic_run_messages_streaming = _bind("entropic_run_messages_streaming", ctypes.c_int, entropic_handle_t, ctypes.c_char_p, TOKEN_CB, ctypes.c_void_p, ctypes.POINTER(ctypes.c_int))
+entropic_set_stream_observer = _bind("entropic_set_stream_observer", ctypes.c_int, entropic_handle_t, STREAM_OBSERVER_CB, ctypes.c_void_p)
+entropic_set_state_observer = _bind("entropic_set_state_observer", ctypes.c_int, entropic_handle_t, STATE_OBSERVER_CB, ctypes.c_void_p)
+entropic_set_critique_callbacks = _bind("entropic_set_critique_callbacks", ctypes.c_int, entropic_handle_t, CRITIQUE_START_CB, CRITIQUE_END_CB, ctypes.c_void_p)
+entropic_interrupt = _bind("entropic_interrupt", ctypes.c_int, entropic_handle_t)
+entropic_queue_user_message = _bind("entropic_queue_user_message", ctypes.c_int, entropic_handle_t, ctypes.c_char_p)
+entropic_user_message_queue_depth = _bind("entropic_user_message_queue_depth", ctypes.c_int, entropic_handle_t, ctypes.POINTER(ctypes.c_size_t))
+entropic_clear_user_message_queue = _bind("entropic_clear_user_message_queue", ctypes.c_int, entropic_handle_t)
+entropic_set_queue_observer = _bind("entropic_set_queue_observer", ctypes.c_int, entropic_handle_t, QUEUE_OBSERVER_CB, ctypes.c_void_p)
+entropic_speculative_compat = _bind("entropic_speculative_compat", ctypes.c_int, entropic_handle_t, ctypes.POINTER(ctypes.c_int), ctypes.POINTER(ctypes.c_char_p))
+entropic_context_clear = _bind("entropic_context_clear", ctypes.c_int, entropic_handle_t)
+entropic_context_get = _bind("entropic_context_get", ctypes.c_int, entropic_handle_t, ctypes.POINTER(ctypes.c_char_p))
+entropic_context_count = _bind("entropic_context_count", ctypes.c_int, entropic_handle_t, ctypes.POINTER(ctypes.c_size_t))
+entropic_context_usage = _bind("entropic_context_usage", ctypes.c_int, entropic_handle_t, ctypes.POINTER(ctypes.c_size_t), ctypes.POINTER(ctypes.c_size_t))
+entropic_metrics_json = _bind("entropic_metrics_json", ctypes.c_int, entropic_handle_t, ctypes.POINTER(ctypes.c_char_p))
+entropic_set_delegation_callbacks = _bind("entropic_set_delegation_callbacks", ctypes.c_int, entropic_handle_t, DELEGATION_START_CB, DELEGATION_COMPLETE_CB, ctypes.c_void_p)
+entropic_validation_set_auto_retry = _bind("entropic_validation_set_auto_retry", ctypes.c_int, entropic_handle_t, ctypes.c_int)
+entropic_validation_resume_retry = _bind("entropic_validation_resume_retry", ctypes.c_int, entropic_handle_t)
+entropic_validation_accept_last = _bind("entropic_validation_accept_last", ctypes.c_int, entropic_handle_t)
+entropic_set_attempt_boundary_cb = _bind("entropic_set_attempt_boundary_cb", ctypes.c_int, entropic_handle_t, ATTEMPT_BOUNDARY_CB, ctypes.c_void_p)
+entropic_register_mcp_server = _bind("entropic_register_mcp_server", ctypes.c_int, entropic_handle_t, ctypes.c_char_p, ctypes.c_char_p)
+entropic_deregister_mcp_server = _bind("entropic_deregister_mcp_server", ctypes.c_int, entropic_handle_t, ctypes.c_char_p)
+entropic_list_mcp_servers = _bind("entropic_list_mcp_servers", ctypes.c_char_p, entropic_handle_t)
+entropic_storage_open = _bind("entropic_storage_open", ctypes.c_int, entropic_handle_t, ctypes.c_char_p)
+entropic_storage_close = _bind("entropic_storage_close", ctypes.c_int, entropic_handle_t)
+entropic_load_identity = _bind("entropic_load_identity", ctypes.c_int, entropic_handle_t, ctypes.c_char_p)
+entropic_get_identity = _bind("entropic_get_identity", ctypes.c_int, entropic_handle_t, ctypes.POINTER(ctypes.c_char_p))
+entropic_register_hook = _bind("entropic_register_hook", ctypes.c_int, entropic_handle_t, ctypes.c_int, HOOK_CB, ctypes.c_void_p, ctypes.c_int)
+entropic_deregister_hook = _bind("entropic_deregister_hook", ctypes.c_int, entropic_handle_t, ctypes.c_int, HOOK_CB, ctypes.c_void_p)
+entropic_adapter_load = _bind("entropic_adapter_load", ctypes.c_int, entropic_handle_t, ctypes.c_char_p, ctypes.c_char_p, ctypes.c_char_p, ctypes.c_float)
+entropic_adapter_unload = _bind("entropic_adapter_unload", ctypes.c_int, entropic_handle_t, ctypes.c_char_p)
+entropic_adapter_swap = _bind("entropic_adapter_swap", ctypes.c_int, entropic_handle_t, ctypes.c_char_p)
+entropic_adapter_state = _bind("entropic_adapter_state", ctypes.c_int, entropic_handle_t, ctypes.c_char_p)
+entropic_adapter_info = _bind("entropic_adapter_info", ctypes.c_char_p, entropic_handle_t, ctypes.c_char_p)
+entropic_adapter_list = _bind("entropic_adapter_list", ctypes.c_char_p, entropic_handle_t)
+entropic_grammar_register = _bind("entropic_grammar_register", ctypes.c_int, entropic_handle_t, ctypes.c_char_p, ctypes.c_char_p)
+entropic_grammar_register_file = _bind("entropic_grammar_register_file", ctypes.c_int, entropic_handle_t, ctypes.c_char_p, ctypes.c_char_p)
+entropic_grammar_deregister = _bind("entropic_grammar_deregister", ctypes.c_int, entropic_handle_t, ctypes.c_char_p)
+entropic_grammar_get = _bind("entropic_grammar_get", ctypes.c_char_p, entropic_handle_t, ctypes.c_char_p)
+entropic_grammar_validate = _bind("entropic_grammar_validate", ctypes.c_char_p, ctypes.c_char_p)
+entropic_grammar_list = _bind("entropic_grammar_list", ctypes.c_char_p, entropic_handle_t)
+entropic_profile_register = _bind("entropic_profile_register", ctypes.c_int, entropic_handle_t, ctypes.c_char_p)
+entropic_profile_deregister = _bind("entropic_profile_deregister", ctypes.c_int, entropic_handle_t, ctypes.c_char_p)
+entropic_profile_get = _bind("entropic_profile_get", ctypes.c_char_p, entropic_handle_t, ctypes.c_char_p)
+entropic_profile_list = _bind("entropic_profile_list", ctypes.c_char_p, entropic_handle_t)
+entropic_throughput_tok_per_sec = _bind("entropic_throughput_tok_per_sec", ctypes.c_double, entropic_handle_t, ctypes.c_char_p)
+entropic_throughput_reset = _bind("entropic_throughput_reset", None, entropic_handle_t, ctypes.c_char_p)
+entropic_grant_mcp_key = _bind("entropic_grant_mcp_key", ctypes.c_int, entropic_handle_t, ctypes.c_char_p, ctypes.c_char_p, ctypes.c_int)
+entropic_revoke_mcp_key = _bind("entropic_revoke_mcp_key", ctypes.c_int, entropic_handle_t, ctypes.c_char_p, ctypes.c_char_p)
+entropic_check_mcp_key = _bind("entropic_check_mcp_key", ctypes.c_int, entropic_handle_t, ctypes.c_char_p, ctypes.c_char_p, ctypes.c_int)
+entropic_list_mcp_keys = _bind("entropic_list_mcp_keys", ctypes.c_char_p, entropic_handle_t, ctypes.c_char_p)
+entropic_grant_mcp_key_from = _bind("entropic_grant_mcp_key_from", ctypes.c_int, entropic_handle_t, ctypes.c_char_p, ctypes.c_char_p, ctypes.c_char_p, ctypes.c_int)
+entropic_serialize_mcp_keys = _bind("entropic_serialize_mcp_keys", ctypes.c_char_p, entropic_handle_t)
+entropic_deserialize_mcp_keys = _bind("entropic_deserialize_mcp_keys", ctypes.c_int, entropic_handle_t, ctypes.c_char_p)
+entropic_audit_flush = _bind("entropic_audit_flush", ctypes.c_int, entropic_handle_t)
+entropic_audit_count = _bind("entropic_audit_count", ctypes.c_int, entropic_handle_t, ctypes.POINTER(ctypes.c_size_t))
+entropic_audit_read = _bind("entropic_audit_read", ctypes.c_int, entropic_handle_t, ctypes.c_char_p, ctypes.c_char_p, ctypes.POINTER(ctypes.c_char_p))
+entropic_create_identity = _bind("entropic_create_identity", ctypes.c_int, entropic_handle_t, ctypes.c_char_p)
+entropic_update_identity = _bind("entropic_update_identity", ctypes.c_int, entropic_handle_t, ctypes.c_char_p, ctypes.c_char_p)
+entropic_destroy_identity = _bind("entropic_destroy_identity", ctypes.c_int, entropic_handle_t, ctypes.c_char_p)
+entropic_get_identity_config = _bind("entropic_get_identity_config", ctypes.c_char_p, entropic_handle_t, ctypes.c_char_p)
+entropic_list_identities = _bind("entropic_list_identities", ctypes.c_char_p, entropic_handle_t)
+entropic_identity_count = _bind("entropic_identity_count", ctypes.c_int, entropic_handle_t, ctypes.POINTER(ctypes.c_size_t), ctypes.POINTER(ctypes.c_size_t))
+entropic_compact = _bind("entropic_compact", ctypes.c_int, entropic_handle_t, ctypes.c_char_p, ctypes.POINTER(ctypes.c_char_p))
+entropic_register_compactor = _bind("entropic_register_compactor", ctypes.c_int, entropic_handle_t, ctypes.c_char_p, COMPACTOR_CB, ctypes.c_void_p)
+entropic_deregister_compactor = _bind("entropic_deregister_compactor", ctypes.c_int, entropic_handle_t, ctypes.c_char_p)
+entropic_get_default_compactor = _bind("entropic_get_default_compactor", ctypes.c_int, entropic_handle_t, ctypes.POINTER(COMPACTOR_CB), ctypes.POINTER(ctypes.c_void_p))
+entropic_get_logprobs = _bind("entropic_get_logprobs", ctypes.c_int, entropic_handle_t, ctypes.c_char_p, ctypes.POINTER(ctypes.c_int32), ctypes.c_int, ctypes.POINTER(EntropicLogprobResult))
+entropic_compute_perplexity = _bind("entropic_compute_perplexity", ctypes.c_int, entropic_handle_t, ctypes.c_char_p, ctypes.POINTER(ctypes.c_int32), ctypes.c_int, ctypes.POINTER(ctypes.c_float))
+entropic_free_logprob_result = _bind("entropic_free_logprob_result", None, ctypes.POINTER(EntropicLogprobResult))
+entropic_validation_set_enabled = _bind("entropic_validation_set_enabled", ctypes.c_int, entropic_handle_t, ctypes.c_bool)
+entropic_validation_set_identity = _bind("entropic_validation_set_identity", ctypes.c_int, entropic_handle_t, ctypes.c_char_p, ctypes.c_bool)
+entropic_validation_last_result = _bind("entropic_validation_last_result", ctypes.c_char_p, entropic_handle_t)
+entropic_model_has_vision = _bind("entropic_model_has_vision", ctypes.c_int, entropic_handle_t, ctypes.c_char_p)
+entropic_get_diagnostic_prompt = _bind("entropic_get_diagnostic_prompt", ctypes.c_int, entropic_handle_t, ctypes.POINTER(ctypes.c_char_p))

entropic_engine-2.2.1/python/src/entropic/_bindings_manifest.py

@@ -0,0 +1,126 @@
+# SPDX-License-Identifier: LGPL-3.0-or-later
+# AUTO-GENERATED by scripts/gen_bindings.py — do not edit.
+"""Exported names for the entropic ctypes bindings.
+
+This file is imported eagerly by ``entropic.__init__`` to populate
+the public ``_LAZY_EXPORTS`` set without loading ``librentropic.so``.
+"""
+
+from __future__ import annotations
+
+EXPORTS = frozenset(
+    {
+        "ATTEMPT_BOUNDARY_CB",
+        "AgentState",
+        "COMPACTOR_CB",
+        "CRITIQUE_END_CB",
+        "CRITIQUE_START_CB",
+        "DELEGATION_COMPLETE_CB",
+        "DELEGATION_START_CB",
+        "EntDecision",
+        "EntDelegationRequest",
+        "EntDelegationResult",
+        "EntropicComputeBackend",
+        "EntropicDirectiveType",
+        "EntropicError",
+        "EntropicHookPoint",
+        "EntropicLogprobResult",
+        "EntropicMcpAccessLevel",
+        "EntropicModelState",
+        "HOOK_CALLBACK_CB",
+        "HOOK_CB",
+        "QUEUE_OBSERVER_CB",
+        "STATE_OBSERVER_CB",
+        "STREAM_OBSERVER_CB",
+        "TOKEN_CB",
+        "TOKEN_STREAM_CB",
+        "entropic_adapter_info",
+        "entropic_adapter_list",
+        "entropic_adapter_load",
+        "entropic_adapter_state",
+        "entropic_adapter_swap",
+        "entropic_adapter_unload",
+        "entropic_alloc",
+        "entropic_api_version",
+        "entropic_audit_count",
+        "entropic_audit_flush",
+        "entropic_audit_read",
+        "entropic_check_mcp_key",
+        "entropic_clear_user_message_queue",
+        "entropic_compact",
+        "entropic_compute_perplexity",
+        "entropic_configure",
+        "entropic_configure_dir",
+        "entropic_configure_from_file",
+        "entropic_context_clear",
+        "entropic_context_count",
+        "entropic_context_get",
+        "entropic_context_usage",
+        "entropic_create",
+        "entropic_create_identity",
+        "entropic_deregister_compactor",
+        "entropic_deregister_hook",
+        "entropic_deregister_mcp_server",
+        "entropic_deserialize_mcp_keys",
+        "entropic_destroy",
+        "entropic_destroy_identity",
+        "entropic_free",
+        "entropic_free_logprob_result",
+        "entropic_get_default_compactor",
+        "entropic_get_diagnostic_prompt",
+        "entropic_get_identity",
+        "entropic_get_identity_config",
+        "entropic_get_logprobs",
+        "entropic_grammar_deregister",
+        "entropic_grammar_get",
+        "entropic_grammar_list",
+        "entropic_grammar_register",
+        "entropic_grammar_register_file",
+        "entropic_grammar_validate",
+        "entropic_grant_mcp_key",
+        "entropic_grant_mcp_key_from",
+        "entropic_handle_t",
+        "entropic_identity_count",
+        "entropic_interrupt",
+        "entropic_list_identities",
+        "entropic_list_mcp_keys",
+        "entropic_list_mcp_servers",
+        "entropic_load_identity",
+        "entropic_metrics_json",
+        "entropic_model_has_vision",
+        "entropic_profile_deregister",
+        "entropic_profile_get",
+        "entropic_profile_list",
+        "entropic_profile_register",
+        "entropic_queue_user_message",
+        "entropic_register_compactor",
+        "entropic_register_hook",
+        "entropic_register_mcp_server",
+        "entropic_revoke_mcp_key",
+        "entropic_run",
+        "entropic_run_messages",
+        "entropic_run_messages_streaming",
+        "entropic_run_streaming",
+        "entropic_serialize_mcp_keys",
+        "entropic_set_attempt_boundary_cb",
+        "entropic_set_critique_callbacks",
+        "entropic_set_delegation_callbacks",
+        "entropic_set_queue_observer",
+        "entropic_set_state_observer",
+        "entropic_set_stream_observer",
+        "entropic_speculative_compat",
+        "entropic_storage_close",
+        "entropic_storage_open",
+        "entropic_throughput_reset",
+        "entropic_throughput_tok_per_sec",
+        "entropic_update_identity",
+        "entropic_user_message_queue_depth",
+        "entropic_validation_accept_last",
+        "entropic_validation_last_result",
+        "entropic_validation_resume_retry",
+        "entropic_validation_set_auto_retry",
+        "entropic_validation_set_enabled",
+        "entropic_validation_set_identity",
+        "entropic_version",
+    }
+)

{entropic_engine-2.2.0 → entropic_engine-2.2.1/python/src/entropic_engine.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: entropic-engine
-Version: 2.2.0
+Version: 2.2.1
 Summary: Local-first agentic inference engine — Python wrapper over librentropic.so
 Author: Tristan VanFossen
 License-Expression: LGPL-3.0-or-later

{entropic_engine-2.2.0 → entropic_engine-2.2.1}/python/src/entropic_engine.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ pyproject.toml
 python/src/entropic/__init__.py
 python/src/entropic/__main__.py
 python/src/entropic/_bindings.py
+python/src/entropic/_bindings_manifest.py
 python/src/entropic/_loader.py
 python/src/entropic/cli.py
 python/src/entropic/helpers.py

entropic_engine-2.2.0/VERSION

@@ -1 +0,0 @@
-2.2.0

entropic_engine-2.2.0/python/src/entropic/_bindings.py

@@ -1,493 +0,0 @@
-# SPDX-License-Identifier: LGPL-3.0-or-later
-"""ctypes bindings for librentropic.so.
-
-This module exposes the entropic C ABI as a flat collection of ctypes
-function objects. It is *not* an OOP wrapper — symbols match the C
-header verbatim (``entropic_create``, ``entropic_run_streaming``, etc.).
-
-Bindings are intentionally a hand-curated subset of the full surface
-declared in ``include/entropic/entropic.h``. The full surface can be
-regenerated via ``inv gen-bindings``; this hand-written file pins the
-symbols most consumers need at v2.1.0 release time and keeps the
-wheel small (~50 KB).
-
-For symbols not exposed here, load librentropic.so directly:
-
-    from entropic._loader import load
-    lib = load()
-    lib.entropic_some_other_symbol.argtypes = [...]
-"""
-
-from __future__ import annotations
-
-import ctypes
-import enum
-
-from entropic._loader import load
-
-_lib = load()
-
-# ── Opaque handle ────────────────────────────────────────────────────────
-# The C header types entropic_handle_t as `struct entropic_engine*`, an
-# opaque forward declaration. From Python it's just a void* — callers
-# pass `ctypes.byref(handle)` for out-params and `handle` for ins.
-entropic_handle_t = ctypes.c_void_p
-
-
-# ── Enums ────────────────────────────────────────────────────────────────
-class EntropicError(enum.IntEnum):
-    """Mirrors ``entropic_error_t`` from include/entropic/types/error.h.
-
-    Same drift hazard as :class:`AgentState`: an IntEnum that doesn't match
-    the C ABI silently mislabels error codes (issue #1: pre-2.1.1 wrapper
-    had 11 entries against 47 in the C header, and the entries it did have
-    were misaligned by integer value). ``tests/unit/test_bindings_abi.py``
-    pins these against the canonical header — do not edit one without
-    the other.
-    """
-
-    OK = 0
-    INVALID_ARGUMENT = 1
-    INVALID_CONFIG = 2
-    INVALID_STATE = 3
-    MODEL_NOT_FOUND = 4
-    LOAD_FAILED = 5
-    GENERATE_FAILED = 6
-    TOOL_NOT_FOUND = 7
-    PERMISSION_DENIED = 8
-    PLUGIN_VERSION_MISMATCH = 9
-    PLUGIN_LOAD_FAILED = 10
-    TIMEOUT = 11
-    CANCELLED = 12
-    OUT_OF_MEMORY = 13
-    IO = 14
-    INTERNAL = 15
-    SERVER_ALREADY_EXISTS = 16
-    SERVER_NOT_FOUND = 17
-    CONNECTION_FAILED = 18
-    INVALID_HANDLE = 19
-    TOOL_EXECUTION_FAILED = 20
-    STORAGE_FAILED = 21
-    IDENTITY_NOT_FOUND = 22
-    ALREADY_RUNNING = 23
-    NOT_RUNNING = 24
-    NOT_IMPLEMENTED = 25
-    INTERRUPTED = 26
-    ADAPTER_NOT_FOUND = 27
-    ADAPTER_LOAD_FAILED = 28
-    ADAPTER_SWAP_FAILED = 29
-    ADAPTER_CANCELLED = 30
-    GRAMMAR_NOT_FOUND = 31
-    GRAMMAR_INVALID = 32
-    MCP_KEY_DENIED = 33
-    LIMIT_REACHED = 34
-    ALREADY_EXISTS = 35
-    IN_USE = 36
-    PROFILE_NOT_FOUND = 37
-    TIME_LIMIT_EXCEEDED = 38
-    VALIDATION_FAILED = 39
-    COMPACTION_FAILED = 40
-    MODEL_NOT_ACTIVE = 41
-    EVAL_CONTEXT_FULL = 42
-    EVAL_FAILED = 43
-    IMAGE_LOAD_FAILED = 44
-    IMAGE_TOO_LARGE = 45
-    MMPROJ_LOAD_FAILED = 46
-    UNSUPPORTED_URL = 47
-    NOT_SUPPORTED = 48
-    STATE_INCOMPATIBLE = 49
-    NO_VISION_TIER = 50  # gh#41 (v2.1.8)
-
-
-class AgentState(enum.IntEnum):
-    """Mirrors ``entropic_agent_state_t`` from include/entropic/types/enums.h.
-
-    Drift from the C header silently mislabels every state from 1 onward,
-    since IntEnum maps by integer value. ``tests/unit/test_bindings_abi.py``
-    parses the canonical header and asserts every (name, value) pair here
-    matches; do not edit one without the other.
-    """
-
-    IDLE = 0
-    PLANNING = 1
-    EXECUTING = 2
-    WAITING_TOOL = 3
-    VERIFYING = 4
-    DELEGATING = 5
-    COMPLETE = 6
-    ERROR = 7
-    INTERRUPTED = 8
-    PAUSED = 9
-
-
-class EntropicHookPoint(enum.IntEnum):
-    """Mirrors ``entropic_hook_point_t`` from include/entropic/types/hooks.h.
-
-    Issue #8 (v2.1.4). ``ENTROPIC_HOOK_COUNT_`` (the sentinel) is
-    intentionally NOT included — it's not a valid hook point. The
-    ABI conformance test pins every (name, value) pair against the
-    canonical header.
-    """
-
-    PRE_GENERATE = 0
-    POST_GENERATE = 1
-    ON_STREAM_TOKEN = 2
-    PRE_TOOL_CALL = 3
-    POST_TOOL_CALL = 4
-    ON_LOOP_ITERATION = 5
-    ON_STATE_CHANGE = 6
-    ON_ERROR = 7
-    ON_DELEGATE = 8
-    ON_DELEGATE_COMPLETE = 9
-    ON_CONTEXT_ASSEMBLE = 10
-    ON_PRE_COMPACT = 11
-    ON_POST_COMPACT = 12
-    ON_MODEL_LOAD = 13
-    ON_MODEL_UNLOAD = 14
-    ON_PERMISSION_CHECK = 15
-    ON_ADAPTER_SWAP = 16
-    ON_VRAM_PRESSURE = 17
-    ON_DIRECTIVE = 18
-    ON_CUSTOM_DIRECTIVE = 19
-    ON_LOOP_START = 20
-    ON_LOOP_END = 21
-    ON_COMPLETE = 22
-
-
-# ── Callback signatures (CFUNCTYPE) ──────────────────────────────────────
-# Each named here has a stable address; reusing the same CFUNCTYPE across
-# bindings ensures function pointers we hand to C remain alive as long
-# as the holding Python reference does.
-TOKEN_CB = ctypes.CFUNCTYPE(None, ctypes.c_char_p, ctypes.c_size_t, ctypes.c_void_p)
-"""Stream callback: (token: bytes, len: size_t, user_data: void*) -> None."""
-
-STATE_OBSERVER_CB = ctypes.CFUNCTYPE(None, ctypes.c_int, ctypes.c_void_p)
-"""State observer: (state: AgentState, user_data: void*) -> None."""
-
-# Issue #8 (v2.1.4): stream observer + hook callback signatures.
-STREAM_OBSERVER_CB = ctypes.CFUNCTYPE(None, ctypes.c_char_p, ctypes.c_size_t, ctypes.c_void_p)
-"""Stream observer: (token: bytes, len: size_t, user_data: void*) -> None.
-
-Same shape as TOKEN_CB; lives in a distinct CFUNCTYPE so streams.py can
-keep its observer registry independent of the per-call streaming path.
-"""
-
-HOOK_CB = ctypes.CFUNCTYPE(
-    ctypes.c_int,  # return: int (0=ok, !=0=cancel)
-    ctypes.c_int,  # hook_point: entropic_hook_point_t
-    ctypes.c_char_p,  # context_json: const char*
-    ctypes.POINTER(ctypes.c_char_p),  # modified_json: char**
-    ctypes.c_void_p,  # user_data: void*
-)
-"""Hook callback signature.
-
-Maps to ``entropic_hook_callback_t`` in include/entropic/types/hooks.h.
-The callback receives the hook context as JSON, may write a transformed
-result via ``*modified_json`` (allocate with malloc — engine free()s),
-and returns 0 for OK or non-zero to cancel/reject.
-"""
-
-# gh#22 (v2.1.5): C-ABI-documentation-spelled aliases for the CFUNCTYPE
-# typedefs. The wrapper picked terse names internally (HOOK_CB, TOKEN_CB,
-# STREAM_OBSERVER_CB); the C header documents them as
-# entropic_hook_callback_t, entropic_token_callback_t, etc. Consumers
-# coming from the C ABI docs expect the spelled-out names. Keep both
-# spellings; old code continues to work.
-HOOK_CALLBACK_CB = HOOK_CB
-"""Alias for :data:`HOOK_CB` matching the C ABI docs (gh#22)."""
-
-TOKEN_STREAM_CB = TOKEN_CB
-"""Alias for :data:`TOKEN_CB` matching the C ABI docs (gh#22)."""
-
-
-## @brief Pin restype/argtypes on a symbol from the loaded library.
-## @utility
-## @version 2.1.0
-def _bind(name: str, restype, *argtypes):
-    """Pin restype/argtypes on a symbol from the loaded library."""
-    fn = getattr(_lib, name)
-    fn.restype = restype
-    fn.argtypes = list(argtypes)
-    return fn
-
-
-# ── Lifecycle ────────────────────────────────────────────────────────────
-entropic_create = _bind("entropic_create", ctypes.c_int, ctypes.POINTER(entropic_handle_t))
-entropic_destroy = _bind("entropic_destroy", None, entropic_handle_t)
-
-entropic_configure_dir = _bind(
-    "entropic_configure_dir",
-    ctypes.c_int,
-    entropic_handle_t,
-    ctypes.c_char_p,
-)
-
-# ── Version / API ────────────────────────────────────────────────────────
-entropic_api_version = _bind("entropic_api_version", ctypes.c_int)
-entropic_version = _bind("entropic_version", ctypes.c_char_p)
-
-# ── Inference ────────────────────────────────────────────────────────────
-entropic_run = _bind(
-    "entropic_run",
-    ctypes.c_int,
-    entropic_handle_t,
-    ctypes.c_char_p,
-    ctypes.POINTER(ctypes.c_char_p),
-)
-"""(handle, input, out_result_json) → entropic_error_t.
-
-The C function allocates ``*out_result_json`` via malloc; callers must
-free it via :data:`entropic_free`.
-"""
-
-entropic_run_streaming = _bind(
-    "entropic_run_streaming",
-    ctypes.c_int,
-    entropic_handle_t,
-    ctypes.c_char_p,
-    TOKEN_CB,
-    ctypes.c_void_p,
-    ctypes.POINTER(ctypes.c_int),
-)
-
-# gh#37 (v2.1.8): multimodal messages entry points. messages_json is a
-# JSON array (OpenAI-compatible content arrays); content_parts survive
-# end-to-end. See entropic_run() for the back-compat text-only path.
-entropic_run_messages = _bind(
-    "entropic_run_messages",
-    ctypes.c_int,
-    entropic_handle_t,
-    ctypes.c_char_p,
-    ctypes.POINTER(ctypes.c_char_p),
-)
-"""(handle, messages_json, out_result_json) → entropic_error_t.
-
-The C function allocates ``*out_result_json`` via malloc; callers must
-free it via :data:`entropic_free`.
-"""
-
-entropic_run_messages_streaming = _bind(
-    "entropic_run_messages_streaming",
-    ctypes.c_int,
-    entropic_handle_t,
-    ctypes.c_char_p,
-    TOKEN_CB,
-    ctypes.c_void_p,
-    ctypes.POINTER(ctypes.c_int),
-)
-
-entropic_interrupt = _bind("entropic_interrupt", ctypes.c_int, entropic_handle_t)
-
-entropic_free = _bind("entropic_free", None, ctypes.c_void_p)
-
-# ── Conversation context ─────────────────────────────────────────────────
-entropic_context_clear = _bind("entropic_context_clear", ctypes.c_int, entropic_handle_t)
-entropic_context_count = _bind(
-    "entropic_context_count",
-    ctypes.c_int,
-    entropic_handle_t,
-    ctypes.POINTER(ctypes.c_size_t),
-)
-
-# gh#39 (v2.1.8): token-level context pressure for consumer UIs
-# (e.g. "6727/32768 tokens (20%)" gauges). Mirrors the
-# `Context: N/M tokens` line emitted by core.context_manager.
-entropic_context_usage = _bind(
-    "entropic_context_usage",
-    ctypes.c_int,
-    entropic_handle_t,
-    ctypes.POINTER(ctypes.c_size_t),
-    ctypes.POINTER(ctypes.c_size_t),
-)
-"""(handle, out_tokens_used, out_capacity) -> entropic_error_t.
-
-Reads the active tier's current context pressure. Both outputs are
-``size_t``. Returns ``ENTROPIC_ERROR_INVALID_STATE`` before any tier
-is locked.
-"""
-
-# gh#22 (v2.1.5): closes the gh#8 partial gap. The C ABI exposes
-# entropic_context_get(handle, char** out_messages_json) — the engine
-# allocates *out_messages_json via malloc and the caller must free it
-# via entropic_free.
-entropic_context_get = _bind(
-    "entropic_context_get",
-    ctypes.c_int,
-    entropic_handle_t,
-    ctypes.POINTER(ctypes.c_char_p),
-)
-"""(handle, out_messages_json) -> entropic_error_t.
-
-Returns the current conversation as a JSON array string in
-``*out_messages_json``. Caller frees with :data:`entropic_free`.
-"""
-
-# ── Observers ────────────────────────────────────────────────────────────
-entropic_set_state_observer = _bind(
-    "entropic_set_state_observer",
-    ctypes.c_int,
-    entropic_handle_t,
-    STATE_OBSERVER_CB,
-    ctypes.c_void_p,
-)
-
-# Issue #8 (v2.1.4): persistent stream observer (fires for ALL streaming
-# output regardless of which entry point invoked the model — vs. the
-# per-call TOKEN_CB on entropic_run_streaming). Wired by streams.py.
-entropic_set_stream_observer = _bind(
-    "entropic_set_stream_observer",
-    ctypes.c_int,
-    entropic_handle_t,
-    STREAM_OBSERVER_CB,
-    ctypes.c_void_p,
-)
-
-
-# ── Delegation callbacks (v2.1.5, gh#29) ─────────────────────────────────
-# Replaces the silent auto-merge-to-develop behavior. Consumers register
-# on_start (pre-delegation gate) and on_complete (patch delivery). The
-# engine NEVER applies patches; the consumer does it with user consent
-# (see entropic.helpers.apply_patch). See include/entropic/entropic.h for
-# the C ABI documentation.
-
-
-class EntDecision(enum.IntEnum):
-    """Mirrors ``ent_decision_t`` from entropic.h (gh#29, v2.1.5)."""
-
-    ACCEPT = 0
-    REJECT = 1
-
-
-class EntDelegationRequest(ctypes.Structure):
-    """Mirrors ``ent_delegation_request_t`` from entropic.h.
-
-    All pointers are owned by the engine and valid only for the
-    callback's duration. Copy any string the Python side needs to retain.
-    """
-
-    _fields_ = [
-        ("delegation_id", ctypes.c_char_p),
-        ("target_tier", ctypes.c_char_p),
-        ("task", ctypes.c_char_p),
-        ("depth", ctypes.c_int),
-        ("is_pipeline", ctypes.c_int),
-    ]
-
-
-class EntDelegationResult(ctypes.Structure):
-    """Mirrors ``ent_delegation_result_t`` from entropic.h.
-
-    ``files_touched`` is a NULL-terminated array of relative path
-    strings; iterate by index up to ``files_touched_len``. The patch
-    buffer is a unified diff suitable for ``git apply``.
-    """
-
-    _fields_ = [
-        ("delegation_id", ctypes.c_char_p),
-        ("target_tier", ctypes.c_char_p),
-        ("success", ctypes.c_int),
-        ("summary", ctypes.c_char_p),
-        ("patch", ctypes.c_char_p),
-        ("patch_len", ctypes.c_size_t),
-        ("files_touched", ctypes.POINTER(ctypes.c_char_p)),
-        ("files_touched_len", ctypes.c_size_t),
-    ]
-
-
-DELEGATION_START_CB = ctypes.CFUNCTYPE(
-    ctypes.c_int,  # ent_decision_t
-    ctypes.POINTER(EntDelegationRequest),
-    ctypes.c_void_p,
-)
-"""CFUNCTYPE for ``ent_delegation_start_cb`` (gh#29, v2.1.5)."""
-
-DELEGATION_COMPLETE_CB = ctypes.CFUNCTYPE(
-    ctypes.c_int,  # ent_decision_t
-    ctypes.POINTER(EntDelegationResult),
-    ctypes.c_void_p,
-)
-"""CFUNCTYPE for ``ent_delegation_complete_cb`` (gh#29, v2.1.5)."""
-
-entropic_set_delegation_callbacks = _bind(
-    "entropic_set_delegation_callbacks",
-    ctypes.c_int,
-    entropic_handle_t,
-    DELEGATION_START_CB,
-    DELEGATION_COMPLETE_CB,
-    ctypes.c_void_p,
-)
-
-
-# ── Validation retry controls (v2.1.5, gh#30) ────────────────────────────
-# Lets consumers gate the constitutional revision loop instead of having
-# the engine race them with auto-revision. See entropic.h for the full
-# behavior contract.
-
-ATTEMPT_BOUNDARY_CB = ctypes.CFUNCTYPE(
-    None,  # void
-    ctypes.c_int,  # attempt_n
-    ctypes.c_void_p,
-)
-"""CFUNCTYPE for ``ent_validation_attempt_boundary_cb`` (gh#30, v2.1.5)."""
-
-entropic_validation_set_auto_retry = _bind(
-    "entropic_validation_set_auto_retry",
-    ctypes.c_int,
-    entropic_handle_t,
-    ctypes.c_int,  # enabled
-)
-
-entropic_validation_resume_retry = _bind(
-    "entropic_validation_resume_retry",
-    ctypes.c_int,
-    entropic_handle_t,
-)
-
-entropic_validation_accept_last = _bind(
-    "entropic_validation_accept_last",
-    ctypes.c_int,
-    entropic_handle_t,
-)
-
-entropic_set_attempt_boundary_cb = _bind(
-    "entropic_set_attempt_boundary_cb",
-    ctypes.c_int,
-    entropic_handle_t,
-    ATTEMPT_BOUNDARY_CB,
-    ctypes.c_void_p,
-)
-
-
-# ── Memory ───────────────────────────────────────────────────────────────
-# Issue #8 (v2.1.4): heap allocator that pairs with entropic_free. Hook
-# callbacks use this when writing modified_json (engine free()s on
-# consumption — a Python `bytes` reference would be freed by Python's
-# refcounter long before the engine reads it).
-entropic_alloc = _bind("entropic_alloc", ctypes.c_void_p, ctypes.c_size_t)
-
-
-# ── MCP server registration ──────────────────────────────────────────────
-# Issue #8 (v2.1.4): runtime MCP server registration (vs. config-file
-# discovery). Pythonic wrapper in entropic.mcp.register_server.
-entropic_register_mcp_server = _bind(
-    "entropic_register_mcp_server",
-    ctypes.c_int,
-    entropic_handle_t,
-    ctypes.c_char_p,  # name
-    ctypes.c_char_p,  # config_json
-)
-
-
-# ── Hook registration ────────────────────────────────────────────────────
-# Issue #8 (v2.1.4): low-level hook registration. Pythonic @hook
-# decorator in entropic.hooks; that module owns the CFUNCTYPE-keepalive
-# registry so callbacks aren't garbage-collected mid-call.
-entropic_register_hook = _bind(
-    "entropic_register_hook",
-    ctypes.c_int,
-    entropic_handle_t,
-    ctypes.c_int,  # hook_point
-    HOOK_CB,  # callback
-    ctypes.c_void_p,  # user_data
-    ctypes.c_int,  # priority
-)