Merge pull request #36 from dreamer-coding/main

Author: dreamer-coding

README.md

@@ -48,7 +48,7 @@ To get started with Jellyfish, ensure you have the following installed:
    # ======================
    [wrap-git]
    url = https://github.com/fossillogic/fossil-jellyfish.git
-   revision = v0.1.2
+   revision = v0.1.3
 
    [provide]
    fossil-jellyfish = fossil_fish_dep

code/logic/fossil/ai/framework.h

@@ -15,7 +15,7 @@
 #define FOSSIL_JELLYFISH_AI_FRAMEWORK_H
 
 #include "jellyfish.h"
-#include "iochat.h"
 #include "language.h"
+#include "iochat.h"
 
 #endif /* FOSSIL_JELLYFISH_AI_FRAMEWORK_H */

code/logic/fossil/ai/iochat.h

@@ -33,7 +33,7 @@ extern "C"
  * @param context_name Optional name for the context/session.
  * @return 0 on success, non-zero on failure.
  */
-int fossil_io_chat_start(const char *context_name, fossil_jellyfish_chain *chain);
+int fossil_io_chat_start(const char *context_name, fossil_jellyfish_chain_t *chain);
 
 /**
  * @brief Processes a user input and generates a chatbot response.
@@ -46,7 +46,7 @@ int fossil_io_chat_start(const char *context_name, fossil_jellyfish_chain *chain
  * @param size    Size of output buffer.
  * @return        0 if response found, -1 if unknown.
  */
-int fossil_io_chat_respond(fossil_jellyfish_chain *chain, const char *input, char *output, size_t size);
+int fossil_io_chat_respond(fossil_jellyfish_chain_t *chain, const char *input, char *output, size_t size);
 
 /**
  * @brief Ends the current conversation session and performs cleanup.
@@ -55,7 +55,7 @@ int fossil_io_chat_respond(fossil_jellyfish_chain *chain, const char *input, cha
  *
  * @return 0 on success.
  */
-int fossil_io_chat_end(fossil_jellyfish_chain *chain);
+int fossil_io_chat_end(fossil_jellyfish_chain_t *chain);
 
 /**
  * @brief Injects a system message into the chain (e.g. "Hello", "System Ready").
@@ -66,7 +66,7 @@ int fossil_io_chat_end(fossil_jellyfish_chain *chain);
  * @param message System-level message.
  * @return 0 on success.
  */
-int fossil_io_chat_inject_system_message(fossil_jellyfish_chain *chain, const char *message);
+int fossil_io_chat_inject_system_message(fossil_jellyfish_chain_t *chain, const char *message);
 
 /**
  * @brief Appends a chatbot-generated response to the chain memory.
@@ -78,15 +78,15 @@ int fossil_io_chat_inject_system_message(fossil_jellyfish_chain *chain, const ch
  * @param output  Chatbot response to learn.
  * @return 0 on success.
  */
-int fossil_io_chat_learn_response(fossil_jellyfish_chain *chain, const char *input, const char *output);
+int fossil_io_chat_learn_response(fossil_jellyfish_chain_t *chain, const char *input, const char *output);
 
 /**
  * @brief Returns the number of conversational turns remembered.
  *
  * @param chain Jellyfish chain.
  * @return Number of user-input/output pairs.
  */
-int fossil_io_chat_turn_count(const fossil_jellyfish_chain *chain);
+int fossil_io_chat_turn_count(const fossil_jellyfish_chain_t *chain);
 
 /**
  * @brief Summarizes the session into a concise text form.
@@ -98,7 +98,7 @@ int fossil_io_chat_turn_count(const fossil_jellyfish_chain *chain);
  * @param size      Size of the output buffer.
  * @return 0 on success, -1 if summary couldn't be generated.
  */
-int fossil_io_chat_summarize_session(const fossil_jellyfish_chain *chain, char *summary, size_t size);
+int fossil_io_chat_summarize_session(const fossil_jellyfish_chain_t *chain, char *summary, size_t size);
 
 /**
  * @brief Filters the most recent N turns into a temporary sub-chain.
@@ -110,7 +110,7 @@ int fossil_io_chat_summarize_session(const fossil_jellyfish_chain *chain, char *
  * @param turn_count Number of recent user turns to include.
  * @return 0 on success.
  */
-int fossil_io_chat_filter_recent(const fossil_jellyfish_chain *chain, fossil_jellyfish_chain *out_chain, int turn_count);
+int fossil_io_chat_filter_recent(const fossil_jellyfish_chain_t *chain, fossil_jellyfish_chain_t *out_chain, int turn_count);
 
 /**
  * @brief Exports the current conversation history to a text file.
@@ -119,7 +119,7 @@ int fossil_io_chat_filter_recent(const fossil_jellyfish_chain *chain, fossil_jel
  * @param filepath  Destination path for output.
  * @return 0 on success, -1 on error.
  */
-int fossil_io_chat_export_history(const fossil_jellyfish_chain *chain, const char *filepath);
+int fossil_io_chat_export_history(const fossil_jellyfish_chain_t *chain, const char *filepath);
 
 /**
  * @brief Imports a context file and loads it into the chain.
@@ -130,7 +130,7 @@ int fossil_io_chat_export_history(const fossil_jellyfish_chain *chain, const cha
  * @param filepath  Source path of saved context.
  * @return 0 on success, -1 if parsing fails.
  */
-int fossil_io_chat_import_context(fossil_jellyfish_chain *chain, const char *filepath);
+int fossil_io_chat_import_context(fossil_jellyfish_chain_t *chain, const char *filepath);
 
 #ifdef __cplusplus
 }
@@ -142,7 +142,132 @@ namespace fossil {
 
 namespace ai {
 
+    class IOChat {
+    public:
+        /**
+         * @brief Starts a new conversation session.
+         * 
+         * Initializes a context for handling multi-turn dialogue.
+         * 
+         * @param context_name Optional name for the context/session.
+         * @return 0 on success, non-zero on failure.
+         */
+        static int start(const char *context_name, fossil_jellyfish_chain_t *chain) {
+            return fossil_io_chat_start(context_name, chain);
+        }
 
+        /**
+         * @brief Processes a user input and generates a chatbot response.
+         * 
+         * Leverages the Jellyfish memory chain to reason about the input.
+         * 
+         * @param input User input string.
+         * @param output Output buffer to receive response.
+         * @param size Size of output buffer.
+         * @return 0 if response found, -1 if unknown.
+         */
+        static int respond(fossil_jellyfish_chain_t *chain, const char *input, char *output, size_t size) {
+            return fossil_io_chat_respond(chain, input, output, size);
+        }
+
+        /**
+         * @brief Ends the current conversation session and performs cleanup.
+         * 
+         * Frees temporary memory, flushes session logs, or persists updates.
+         * 
+         * @return 0 on success.
+         */
+        static int end(fossil_jellyfish_chain_t *chain) {
+            return fossil_io_chat_end(chain);
+        }
+
+        /**
+         * @brief Injects a system message into the chain (e.g. "Hello", "System Ready").
+         * 
+         * System messages are logged as immutable memory blocks with device signature.
+         * 
+         * @param message System-level message.
+         * @return 0 on success.
+         */
+        static int inject_system_message(fossil_jellyfish_chain_t *chain, const char *message) {
+            return fossil_io_chat_inject_system_message(chain, message);
+        }
+
+        /**
+         * @brief Learns a new response based on user input and chatbot output.
+         * 
+         * Updates the Jellyfish memory chain with the new information.
+         * 
+         * @param input User input string.
+         * @param output Chatbot output string.
+         * @return 0 on success, -1 on error.
+         */
+        static int learn_response(fossil_jellyfish_chain_t *chain, const char *input, const char *output) {
+            return fossil_io_chat_learn_response(chain, input, output);
+        }
+
+        /**
+         * @brief Returns the number of conversational turns remembered.
+         * 
+         * @param chain Jellyfish chain.
+         * @return Number of user-input/output pairs.
+         */
+        static int turn_count(const fossil_jellyfish_chain_t *chain) {
+            return fossil_io_chat_turn_count(chain);
+        }
+
+        /**
+         * @brief Summarizes the session into a concise text form.
+         * 
+         * This scans the chat blocks and returns a summary paragraph based on user turns.
+         * 
+         * @param chain Jellyfish chain to summarize.
+         * @param summary Output buffer to store summary.
+         * @param size Size of the output buffer.
+         * @return 0 on success, -1 if summary couldn't be generated.
+         */
+        static int summarize_session(const fossil_jellyfish_chain_t *chain, char *summary, size_t size) {
+            return fossil_io_chat_summarize_session(chain, summary, size);
+        }
+
+        /**
+         * @brief Filters the most recent N turns into a temporary sub-chain.
+         * 
+         * Useful for generating context-limited decisions.
+         * 
+         * @param chain Original chat chain.
+         * @param out_chain Output chain filled with most recent turns.
+         * @param turn_count Number of recent user turns to include.
+         * @return 0 on success.
+         */
+        static int filter_recent(const fossil_jellyfish_chain_t *chain, fossil_jellyfish_chain_t *out_chain, int turn_count) {
+            return fossil_io_chat_filter_recent(chain, out_chain, turn_count);
+        }
+
+        /**
+         * @brief Exports the current conversation history to a text file.
+         * 
+         * @param chain Jellyfish chain to serialize.
+         * @param filepath Destination path for output.
+         * @return 0 on success, -1 on error.
+         */
+        static int export_history(const fossil_jellyfish_chain_t *chain, const char *filepath) {
+            return fossil_io_chat_export_history(chain, filepath);
+        }
+
+        /**
+         * @brief Imports a context file and loads it into the chain.
+         * 
+         * Useful for bootstrapping or restoring previous sessions.
+         * 
+         * @param chain Destination Jellyfish chain.
+         * @param filepath Source path of saved context.
+         * @return 0 on success, -1 if parsing fails.
+         */
+        static int import_context(fossil_jellyfish_chain_t *chain, const char *filepath) {
+            return fossil_io_chat_import_context(chain, filepath);
+        }
+    };
 
 } // namespace ai