extending the api with more functions

Author: dreamer-coding

code/logic/fossil/ai/jellyfish.h

@@ -41,8 +41,11 @@ typedef struct {
     uint8_t hash[FOSSIL_JELLYFISH_HASH_SIZE];
     uint64_t timestamp;
     int valid;
+    float confidence;   // New: how trusted this block is (0.0 - 1.0)
+    uint32_t usage_count; // New: how often it's used
 } fossil_jellyfish_block;
 
+
 /**
  * Represents a chain of jellyfish blocks.
  * This structure holds the memory for the jellyfish AI and tracks the number of blocks.
@@ -141,6 +144,26 @@ int fossil_jellyfish_load(fossil_jellyfish_chain *chain, const char *filepath);
  */
 const char* fossil_jellyfish_reason_fuzzy(fossil_jellyfish_chain *chain, const char *input);
 
+/**
+ * Get the reason chain for a given input.
+ * This function provides a detailed explanation of how the AI arrived at its reasoning.
+ * 
+ * @param chain Pointer to the jellyfish chain.
+ * @param input The input string to reason about.
+ * @param depth The depth of reasoning to explore (0 for no depth).
+ * @return A string explaining the reasoning process, or "Unknown" if not found.
+ */
+const char* fossil_jellyfish_reason_chain(fossil_jellyfish_chain *chain, const char *input, int depth);
+
+/**
+ * Decay the confidence of the jellyfish chain.
+ * This reduces the confidence of all blocks in the chain by a specified decay rate.
+ * 
+ * @param chain Pointer to the jellyfish chain.
+ * @param decay_rate The rate at which to decay confidence (0.0 - 1.0).
+ */
+void fossil_jellyfish_decay_confidence(fossil_jellyfish_chain *chain, float decay_rate);
+
 
 #ifdef __cplusplus
 }
@@ -276,6 +299,29 @@ namespace ai {
             return fossil_jellyfish_load(&chain, filepath.c_str());
         }
 
+        /**
+         * Get the reason chain for a given input.
+         * This function provides a detailed explanation of how the AI arrived at its reasoning.
+         *
+         * @param input The input string to reason about.
+         * @param depth The depth of reasoning to explore (0 for no depth).
+         * @return A string explaining the reasoning process, or "Unknown" if not found.
+         */
+        std::string reason_chain(const std::string &input, int depth = 0) {
+            const char *result = fossil_jellyfish_reason_chain(&chain, input.c_str(), depth);
+            return std::string(result);
+        }
+
+        /**
+         * Decay the confidence of the jellyfish chain.
+         * This reduces the confidence of all blocks in the chain by a specified decay rate.
+         *
+         * @param decay_rate The rate at which to decay confidence (0.0 - 1.0).
+         */
+        void decay_confidence(float decay_rate) {
+            fossil_jellyfish_decay_confidence(&chain, decay_rate);
+        }
+
     private:
         fossil_jellyfish_chain chain; // The jellyfish chain instance
     };

code/logic/jellyfish.c

@@ -50,21 +50,26 @@ void fossil_jellyfish_init(fossil_jellyfish_chain *chain) {
 
 void fossil_jellyfish_learn(fossil_jellyfish_chain *chain, const char *input, const char *output) {
     if (chain->count >= FOSSIL_JELLYFISH_MAX_MEM) {
-        fossil_jellyfish_cleanup(chain); // Reclaim space
+        fossil_jellyfish_cleanup(chain);
     }
 
     fossil_jellyfish_block *block = &chain->memory[chain->count++];
     strncpy(block->input, input, FOSSIL_JELLYFISH_INPUT_SIZE - 1);
     strncpy(block->output, output, FOSSIL_JELLYFISH_OUTPUT_SIZE - 1);
     block->timestamp = (uint64_t)time(NULL);
     block->valid = 1;
+    block->confidence = 1.0f;
+    block->usage_count = 0;
 
     fossil_jellyfish_hash(input, output, block->hash);
 }
 
 const char* fossil_jellyfish_reason(fossil_jellyfish_chain *chain, const char *input) {
     for (size_t i = 0; i < chain->count; ++i) {
         if (chain->memory[i].valid && strncmp(chain->memory[i].input, input, FOSSIL_JELLYFISH_INPUT_SIZE) == 0) {
+            chain->memory[i].usage_count++;
+            if (chain->memory[i].confidence < 1.0f)
+                chain->memory[i].confidence += 0.05f;
             return chain->memory[i].output;
         }
     }
@@ -75,7 +80,7 @@ const char* fossil_jellyfish_reason(fossil_jellyfish_chain *chain, const char *i
 void fossil_jellyfish_cleanup(fossil_jellyfish_chain *chain) {
     size_t new_count = 0;
     for (size_t i = 0; i < chain->count; ++i) {
-        if (chain->memory[i].valid && (time(NULL) - chain->memory[i].timestamp < 3600)) {
+        if (chain->memory[i].valid && chain->memory[i].confidence >= 0.05f) {
             chain->memory[new_count++] = chain->memory[i];
         }
     }
@@ -143,3 +148,23 @@ const char* fossil_jellyfish_reason_fuzzy(fossil_jellyfish_chain *chain, const c
 
     return best_output;
 }
+
+void fossil_jellyfish_decay_confidence(fossil_jellyfish_chain *chain, float decay_rate) {
+    for (size_t i = 0; i < chain->count; ++i) {
+        if (!chain->memory[i].valid) continue;
+
+        chain->memory[i].confidence -= decay_rate;
+        if (chain->memory[i].confidence < 0.05f) {
+            chain->memory[i].valid = 0; // mark for cleanup
+        }
+    }
+}
+
+const char* fossil_jellyfish_reason_chain(fossil_jellyfish_chain *chain, const char *input, int depth) {
+    if (depth <= 0) return input;
+
+    const char *first = fossil_jellyfish_reason_fuzzy(chain, input);
+    if (strcmp(first, "Unknown") == 0) return first;
+
+    return fossil_jellyfish_reason_chain(chain, first, depth - 1);
+}