update

src/interface.jl

@@ -1,6 +1,6 @@
 module interface
     
-export addNewMessage
+export add_new_message
 
 using JSON3, DataStructures, Dates, UUIDs, HTTP, Random
 using GeneralUtils
@@ -47,7 +47,7 @@ using ..type, ..util, ..llmfunction
 
   Return\n
   -----
-    message left
+    nothing
 
   Example\n
   -----
@@ -72,13 +72,13 @@ using ..type, ..util, ..llmfunction
             msgMeta,
             agentConfig,
             )
-  julia> YiemAgent.addNewMessage(a, "user", "hello")
+  julia> YiemAgent.add_new_message(a, "user", "hello")
   ```
 
   Signature\n
   -----
-""" #WORKING
+"""
-function addNewMessage(a::T1, role::String, text::T2; 
+function add_new_message(a::T1, role::String, text::T2; 
                       maximumMsg::Integer=20) where {T1<:agent, T2<:AbstractString}
   if role ∉ ["system", "user", "assistant"]   # guard against typo
     error("role is not in agent.availableRole $(@__LINE__)")

src/type.jl

@@ -1,6 +1,6 @@
 module type
   
-export agent, sommelier, initAgentMemory
+export agent, sommelier, clearhistory
 
 using Dates, UUIDs, DataStructures, JSON3
 using GeneralUtils
@@ -67,7 +67,7 @@ abstract type agent end
                     tools=tools
                   )
 ```
-"""
+""" #TODO update document
 @kwdef mutable struct sommelier <: agent
   name::String
   id::String
@@ -154,29 +154,52 @@ function sommelier(
   return newAgent
 end
 
+""" Clear agent history.
 
+  Arguments\n
+  -----
+    a::agent
+      an agent
 
-# function initAgentMemory(a::T) where {T<:agent}
+  Return\n
-#   a.chathistory = Dict{String,Any}()
+  -----
-#   a.mctstree = Dict{Symbol, Any}()
+    nothing
-#   a.plan[:activeplan] = Dict{Symbol, Any}()
-#   a.plan[:currenttrajectory] = Dict{Symbol, Any}()
-# end
 
+  Example\n
+  -----
+  ```jldoctest
+  julia> using YiemAgent, MQTTClient, GeneralUtils
+  julia> client, connection = MakeConnection("test.mosquitto.org", 1883)
+  julia> connect(client, connection)
+  julia> msgMeta = GeneralUtils.generate_msgMeta("testtopic")
+  julia> agentConfig = Dict(
+            :receiveprompt=>Dict(
+              :mqtttopic=> "testtopic/receive",
+            ),
+            :receiveinternal=>Dict(  
+              :mqtttopic=> "testtopic/internal",
+            ),
+            :text2text=>Dict(
+              :mqtttopic=> "testtopic/text2text",
+            ),
+          )
+  julia> a = YiemAgent.sommelier(
+            client,
+            msgMeta,
+            agentConfig,
+            )
+  julia> YiemAgent.add_new_message(a, "user", "hello")
+  julia> YiemAgent.clearhistory(a)
+  ```
 
-function clearMessage(a::T)  where {T<:agent}
+  Signature\n
-  for i in eachindex(a.messages)
+  -----
-    if length(a.messages) > 0 
+""" #TODO update document
-      pop!(a.messages)
+function clearhistory(a::T)  where {T<:agent}
-    else
+  empty!(a.chathistory)
-      break
+  empty!(a.mctstree)
-    end
+  empty!(a.plan[:activeplan])
-  end
+  empty!(a.plan[:currenttrajectory])
-  
-  a.memory = newAgentMemory()
-
-  # @show a.messages
-  # @show a.memory
 end