Handles, you guessed it! Memory! - It has both in-session and persistent memories (datastore)

How it works

1. In-Session
   1. Creates a memory table
   2. When updating we insert a table to the memory table: { Role: string, Content: string }
   3. And just return the memory table when reading
   4. Fires MaxEntriesExceeded once MaxEntries exceeds
2. Persistent
   1. Uses Datastores with the SessionId as the key
   2. Saves, Updates, and Returns a table inside the datastore
   3. Fires MaxEntriesExceeded once MaxEntries exceeds

Constructor

• GorillaMemory.new(MaxEntries: number, SessionId: string | number)
  • Creates a new GorillaMemory object.
  • Parameters:
    • MaxEntries: number - Defaults to 100. The maximum number of "entries" (pairs of Role and Content) to store in memory before the MaxEntriesExceeded signal is fired.
    • SessionId: string | number - Defaults to 'Global'. This ID is used for persistent memory storage.

Methods

In-session:

• GorillaMemory:Read(): table

  • Returns the in session memory table

• GorillaMemory:Update(Input: string, Role: string)

  • Adds a new entry to the in-session memory. Each entry consists of a Role and Input.

  Note: This method checks if MaxEntries has been exceeded and fires the MaxEntriesExceeded signal if it has.

• GorillaMemory:Clear()

  • Clears the in-session memory table.

Persistent:

• GorillaMemory:ReadPersistent(): table

  • Reads the saved persistent memory for the current SessionId. Returns the memory table or nil if an error occurs.

• GorillaMemory:UpdatePersistent(Input: string, Role: string)

  • Updates the persistent memory for the current SessionId by adding a new { Role, Content } entry.

  Note: This method checks if MaxEntries has been exceeded and fires the MaxEntriesExceeded signal if it has.

• GorillaMemory:ClearPersistent()

  • Clears all saved persistent memory for the current SessionId.

Properties & Signals