json_heal.h

Go to the documentation of this file.

#ifndef __CWIST_JSON_HEAL_H__
#define __CWIST_JSON_HEAL_H__
 
#include <stdbool.h>
#include <stddef.h>
#include <cjson/cJSON.h>
 
/* -------------------------------------------------------------------------
 * Schema descriptor  (shared with zod.h)
 * ---------------------------------------------------------------------- */
 
typedef enum {
    CWIST_FIELD_STRING = 0,
    CWIST_FIELD_INT,
    CWIST_FIELD_FLOAT,
    CWIST_FIELD_BOOL,
    CWIST_FIELD_OBJECT,
    CWIST_FIELD_ARRAY,
} cwist_field_type_t;
 
#define CWIST_SCHEMA_MAX_ALIASES 8
 
typedef struct cwist_schema_field {
    const char *name;                             
    const char *aliases[CWIST_SCHEMA_MAX_ALIASES];
    cwist_field_type_t type;                             
    bool required;                         
} cwist_schema_field_t;
 
typedef struct cwist_schema {
    const cwist_schema_field_t *fields;
    int field_count;
} cwist_schema_t;
 
/* -------------------------------------------------------------------------
 * L3 SLLM callback
 * ---------------------------------------------------------------------- */
 
typedef char *(*cwist_sllm_heal_fn)(const char *broken_json, const cwist_schema_t *schema,
                                    void *userdata);
 
/* -------------------------------------------------------------------------
 * Healing configuration
 * ---------------------------------------------------------------------- */
 
typedef struct cwist_heal_config {
    double threshold;     
    const cwist_schema_t *schema;       
    cwist_sllm_heal_fn sllm_fn;       
    void *sllm_userdata; 
} cwist_heal_config_t;
 
/* -------------------------------------------------------------------------
 * Result
 * ---------------------------------------------------------------------- */
 
#define CWIST_HEAL_LOG_MAX 512
 
typedef struct cwist_heal_result {
    char *json; 
    bool healed; 
    int level; 
    double confidence; 
    char log[CWIST_HEAL_LOG_MAX]; 
} cwist_heal_result_t;
 
/* -------------------------------------------------------------------------
 * Public API
 * ---------------------------------------------------------------------- */
 
cwist_heal_result_t cwist_json_heal(const char *input, const cwist_heal_config_t *cfg);
 
int cwist_json_schema_align(cJSON *obj, const cwist_schema_t *schema, char *log, size_t log_sz);
 
void cwist_heal_result_free(cwist_heal_result_t *r);
 
#endif /* __CWIST_JSON_HEAL_H__ */