entropic::StorageInterface Struct Reference

Storage interface for conversation persistence. More...

#include <entropic/core/engine_types.h>

Public Attributes
bool(*	create_conversation )(const char *title, std::string &conversation_id, void *user_data) = nullptr
	Create a root conversation row.
bool(*	save_snapshot )(const char *conversation_id, const char *messages_json, void *user_data) = nullptr
	Save a compaction snapshot (full history before compaction).
bool(*	create_delegation )(const char *parent_id, const char *delegating_tier, const char *target_tier, const char *task, int max_turns, std::string &delegation_id, std::string &child_conversation_id, void *user_data) = nullptr
	Create a delegation record with child conversation.
bool(*	complete_delegation )(const char *delegation_id, const char *status, const char *summary, void *user_data) = nullptr
	Complete a delegation record.
bool(*	save_conversation )(const char *conversation_id, const char *messages_json, void *user_data) = nullptr
	Save messages to a conversation.
bool(*	load_delegation_with_messages )(const char *delegation_id, std::string &result_json, void *user_data) = nullptr
	Load a delegation's full child conversation (gh#32, v2.1.6).
bool(*	latest_delegation_for_target )(const char *target_tier, std::string &delegation_id, void *user_data) = nullptr
	Most recent COMPLETED delegation to a tier (gh#162, v2.13.0).
void *	user_data = nullptr
	Opaque pointer (storage backend)

Detailed Description

Storage interface for conversation persistence.

Injected by the facade. Allows core.so to persist conversations, delegation records, and compaction snapshots without depending on storage.so. All callbacks are optional (nullptr = no-op).

Version

1.8.8

Definition at line 597 of file engine_types.h.

Member Data Documentation

complete_delegation

bool(* entropic::StorageInterface::complete_delegation) (const char *delegation_id, const char *status, const char *summary, void *user_data) = nullptr

Complete a delegation record.

Parameters

delegation_id	Delegation ID.
status	"completed" or "failed".
summary	Result summary (may be nullptr).
user_data	Opaque pointer.

Returns

true on success.

Definition at line 653 of file engine_types.h.

create_conversation

bool(* entropic::StorageInterface::create_conversation) (const char *title, std::string &conversation_id, void *user_data) = nullptr

Create a root conversation row.

Called once at AgentEngine::run() init when storage is wired so the engine's LoopContext::conversation_id is populated for the rest of the session. Pre-v2.1.12 (gh#48): no callback existed, root conversation_id stayed empty, every delegation's foreign-key insert into delegations(parent_conversation_id) failed silently against the empty parent string.

Parameters

	title	Display title (e.g., session description).
[out]	conversation_id	Newly created conversation ID.
	user_data	Opaque pointer.

Returns

true on success and conversation_id populated.

Version

2.1.12

Definition at line 612 of file engine_types.h.

create_delegation

bool(* entropic::StorageInterface::create_delegation) (const char *parent_id, const char *delegating_tier, const char *target_tier, const char *task, int max_turns, std::string &delegation_id, std::string &child_conversation_id, void *user_data) = nullptr

Create a delegation record with child conversation.

Parameters

	parent_id	Parent conversation ID.
	delegating_tier	Source tier.
	target_tier	Target tier.
	task	Task description.
	max_turns	Turn limit (0 = unlimited).
[out]	delegation_id	Created delegation ID.
[out]	child_conversation_id	Created child conversation ID.
	user_data	Opaque pointer.

Returns

true on success.

Definition at line 637 of file engine_types.h.

latest_delegation_for_target

bool(* entropic::StorageInterface::latest_delegation_for_target) (const char *target_tier, std::string &delegation_id, void *user_data) = nullptr

Most recent COMPLETED delegation to a tier (gh#162, v2.13.0).

Backs entropic.resume_delegation's target form: the lead names the specialist, not a storage id it would have to fetch first.

Parameters

	target_tier	Tier to search for.
[out]	delegation_id	Resolved id on success.
	user_data	Opaque pointer (storage backend).

Returns

true when a completed delegation to that tier exists.

Definition at line 695 of file engine_types.h.

load_delegation_with_messages

bool(* entropic::StorageInterface::load_delegation_with_messages) (const char *delegation_id, std::string &result_json, void *user_data) = nullptr

Load a delegation's full child conversation (gh#32, v2.1.6).

Resolves the delegation by id, then loads the child conversation it spawned. Returns a JSON object whose top-level fields include target_tier, messages (array), and delegation_id. The engine uses this on resume_delegation to seed a fresh child context with the prior conversation history.

Parameters

	delegation_id	Delegation id (storage PK).
[out]	result_json	Conversation JSON (target_tier + messages).
	user_data	Opaque pointer (storage backend).

Returns

true on success and the delegation+conversation were found.

Definition at line 681 of file engine_types.h.

save_conversation

bool(* entropic::StorageInterface::save_conversation) (const char *conversation_id, const char *messages_json, void *user_data) = nullptr

Save messages to a conversation.

Parameters

conversation_id	Conversation ID.
messages_json	JSON array of message objects.
user_data	Opaque pointer.

Returns

true on success.

Definition at line 664 of file engine_types.h.

save_snapshot

bool(* entropic::StorageInterface::save_snapshot) (const char *conversation_id, const char *messages_json, void *user_data) = nullptr

Save a compaction snapshot (full history before compaction).

Parameters

conversation_id	Conversation to snapshot.
messages_json	JSON array of all messages.
user_data	Opaque pointer.

Returns

true on success.

Definition at line 622 of file engine_types.h.

user_data

void* entropic::StorageInterface::user_data = nullptr

Opaque pointer (storage backend)

Definition at line 700 of file engine_types.h.

---

The documentation for this struct was generated from the following file:

• entropic/core/engine_types.h