i_storage_backend.h

Go to the documentation of this file.

// SPDX-License-Identifier: Apache-2.0
#pragma once
 
#include <entropic/types/error.h>
 
#include <stddef.h>
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef struct entropic_storage_backend* entropic_storage_backend_t;
 
// ── Lifecycle ─────────────────────────────────────────────
 
ENTROPIC_EXPORT entropic_storage_backend_t
entropic_storage_create(const char* db_path);
 
ENTROPIC_EXPORT entropic_error_t
entropic_storage_initialize(entropic_storage_backend_t storage);
 
ENTROPIC_EXPORT void
entropic_storage_destroy(entropic_storage_backend_t storage);
 
// ── Conversation CRUD ─────────────────────────────────────
 
ENTROPIC_EXPORT char*
entropic_storage_create_conversation(
    entropic_storage_backend_t storage,
    const char* title,
    const char* project_path,
    const char* model_id);
 
ENTROPIC_EXPORT entropic_error_t
entropic_storage_save_conversation(
    entropic_storage_backend_t storage,
    const char* conversation_id,
    const char* messages_json);
 
ENTROPIC_EXPORT entropic_error_t
entropic_storage_load_conversation(
    entropic_storage_backend_t storage,
    const char* conversation_id,
    char** result_json);
 
ENTROPIC_EXPORT entropic_error_t
entropic_storage_list_conversations(
    entropic_storage_backend_t storage,
    int limit,
    int offset,
    char** result_json);
 
ENTROPIC_EXPORT entropic_error_t
entropic_storage_search_conversations(
    entropic_storage_backend_t storage,
    const char* query,
    int limit,
    char** result_json);
 
ENTROPIC_EXPORT entropic_error_t
entropic_storage_delete_conversation(
    entropic_storage_backend_t storage,
    const char* conversation_id);
 
// ── Delegation storage ────────────────────────────────────
 
ENTROPIC_EXPORT entropic_error_t
entropic_storage_create_delegation(
    entropic_storage_backend_t storage,
    const char* parent_conversation_id,
    const char* delegating_tier,
    const char* target_tier,
    const char* task,
    int max_turns,
    char** result_json);
 
ENTROPIC_EXPORT entropic_error_t
entropic_storage_complete_delegation(
    entropic_storage_backend_t storage,
    const char* delegation_id,
    const char* status,
    const char* result_summary);
 
ENTROPIC_EXPORT entropic_error_t
entropic_storage_get_delegations(
    entropic_storage_backend_t storage,
    const char* conversation_id,
    char** result_json);
 
// ── Compaction snapshots ──────────────────────────────────
 
ENTROPIC_EXPORT entropic_error_t
entropic_storage_save_snapshot(
    entropic_storage_backend_t storage,
    const char* conversation_id,
    const char* messages_json);
 
// ── Statistics ────────────────────────────────────────────
 
ENTROPIC_EXPORT entropic_error_t
entropic_storage_get_stats(
    entropic_storage_backend_t storage,
    char** result_json);
 
#ifdef __cplusplus
}
#endif