engine_handle.h File Reference

Private definition of the entropic_engine struct. More...

#include <entropic/config/bundled_models.h>
#include <entropic/core/compactor_registry.h>
#include <entropic/core/constitutional_validator.h>
#include <entropic/core/engine.h>
#include <entropic/core/hook_registry.h>
#include <entropic/core/identity_manager.h>
#include <entropic/entropic.h>
#include <entropic/inference/orchestrator.h>
#include <entropic/mcp/mcp_authorization.h>
#include <entropic/mcp/external_bridge.h>
#include "http_listener.h"
#include <entropic/mcp/server_manager.h>
#include <entropic/mcp/tool_executor.h>
#include <entropic/storage/audit_logger.h>
#include <entropic/types/session_logger.h>
#include <entropic/storage/backend.h>
#include <entropic/types/config.h>
#include <entropic/types/error.h>
#include <entropic/types/logging.h>
#include <entropic/types/run_scope.h>
#include <atomic>
#include <filesystem>
#include <map>
#include <memory>
#include <mutex>
#include <optional>
#include <string>

Include dependency graph for engine_handle.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	EntropicWorkspace
	A named repository a session's tools operate in (gh#166). More...
struct	entropic_engine
	Engine handle struct — owns all subsystems. More...
class	entropic::HandleApiLock
	gh#59 (v2.3.1): RAII guard combining api_mutex + log scope. More...
class	entropic::HandleTurnGuard
	gh#144 (v2.12.0): RAII turn claim + log scope, for the RUN paths. More...

Namespaces
namespace	entropic
	Activate model on GPU (WARM → ACTIVE).

Functions
EntropicWorkspace *	entropic::workspace_for (entropic_handle_t h, const std::string &key)
	The workspace a session is bound to, or nullptr for the default.
entropic::ServerManager *	entropic::workspace_servers (entropic_handle_t h, const std::string &key)
	The MCP servers a session's tools must run against (gh#166).
void	entropic::wire_outside_root_approver (entropic_handle_t h)
	Point the DEFAULT server set's filesystem server at the handle's path-approval slot (v2.13.0).
std::filesystem::path	entropic::expected_bridge_socket (entropic_handle_t h)
	The socket this handle's external bridge binds, or empty when the handle runs no bridge (v2.14.0, gh#200).
std::filesystem::path	entropic::bridge_project_dir (entropic_handle_t h)
	The project dir the external bridge derives its socket from.
void	entropic::wire_external_server_policy (entropic_handle_t h, ServerManager &servers, bool with_declared)
	Give a server set the handle's external-server policy (v2.14.0).
void	entropic::apply_workspace_app_context (entropic_handle_t h, const std::string &workspace, const std::optional< std::string > &app_context)
	Give a workspace's sessions prompts built on its own app_context (gh#179), or return them to the handle's.
ENTROPIC_EXPORT void	entropic::swap_session_tool_dir (const std::string &session_key, const std::filesystem::path &path, bool entering, void *ud)
	The facade's gh#160 ScopedSandbox swap callback.
std::size_t	entropic::release_session_tool_state (entropic_handle_t h, const std::string &key)
	Release a session's per-session tool state on every server set (gh#158).

Detailed Description

Private definition of the entropic_engine struct.

The public C API uses entropic_handle_t (opaque pointer to struct entropic_engine). This header defines the struct body. It is private to the facade — no external consumer or test should include it.

Subsystems are nullable unique_ptrs for lazy init: created during entropic_configure(), not entropic_create(). Phase 0 owns only hook_registry, api_mutex, last_error, and state flags.

Version

2.0.0

Definition in file engine_handle.h.