add plugin metadata and agent test

Author: mossv2

plugins/membase/plugin_metadata.yml

@@ -0,0 +1,23 @@
+# General Information
+plugin_name: "membase"           # Name of the plugin
+author: "felix from unibase"                # Author and team name
+logo_url: "https://www.unibase.io/favicon.ico"                      # URL to the author photo or team logo (512x512 recommended)
+release_date: "14-04-2025"          # Release date (DD-MM-YYYY)
+
+# Description
+short_description: "Membase is a plugin for the Game SDK that allows you to store and retrieve memories from membase database."      # One-liner description for listings
+detailed_description: "Membase is a plugin for the Game SDK that allows you to store and retrieve memories from membase database."   # Full description with features and benefits
+
+# Media & Assets
+plugin_logo_url: "https://www.unibase.io/favicon.ico"        # URL to the plugin logo (512x512 recommended) (if any or fallback to logo_url)
+screenshots:               # List of screenshots showcasing the plugin
+  - "https://github.com/unibaseio/membase/blob/main/assets/virtual_case.png"                     # e.g., "https://example.com/screenshot1.png"
+  - "https://github.com/unibaseio/membase/blob/main/assets/virtual_reload.png"
+demo_video_url: ""         # Link to a demo or walkthrough video (if available)
+documentation_url: "https://www.unibase.io/"      # Link to the plugin's official documentation (if available)
+changelog_url: ""          # Link to the changelog (if maintained)
+
+# Contact & Support
+x_account_handle: ""       # X (formerly known as Twitter) account handle (ie: @GAME_Virtuals)
+support_contact: ""        # Email or Slack/Discord link for user support
+community_link: ""         # Forum or community link (if any)

plugins/membase/test_membase_agent.py

@@ -0,0 +1,92 @@
+import os
+from typing import Literal, Tuple
+from game_sdk.game.custom_types import Function, FunctionResultStatus, Argument
+from membase_plugin_gamesdk.membase_plugin_gamesdk import MembasePlugin
+from game_sdk.game.chat_agent import Chat, ChatAgent
+
+
+# set your own account and agent name
+# or set environment variables
+default_account = "game_sdk_test"
+default_agent_name = "game_sdk_test_agent"
+default_conversation_id = "67fd033a0740eed72502b65e"
+
+game_api_key = os.environ.get("GAME_API_KEY")
+chat_agent = ChatAgent(
+    prompt="You are a helpful assistant.",
+    api_key=game_api_key,
+)
+
+membase_plugin = MembasePlugin(
+  account=default_account,
+  agent_name=default_agent_name,
+  auto_upload_to_hub=True,
+  preload_from_hub=False,
+)
+
+
+def save_memory_executable(membase_plugin: MembasePlugin, memory: str, memory_type: Literal["user", "assistant"]) -> Tuple[FunctionResultStatus, str, dict]:
+    try:
+        membase_plugin.add_memory(memory, memory_type)
+        return FunctionResultStatus.DONE, "Memory added successfully", {}
+    except Exception as e:
+        return FunctionResultStatus.FAILED, str(e), {}
+
+def get_memory_executable(membase_plugin: MembasePlugin, recent_n: int = 10) -> Tuple[FunctionResultStatus, str, dict]:
+    try:    
+        memory = membase_plugin.get_memory(recent_n=recent_n)
+        result = ""
+        for msg in memory:
+            result += f"{msg.role}: {msg.content}\n"
+        return FunctionResultStatus.DONE, result, {}
+    except Exception as e:
+        return FunctionResultStatus.FAILED, str(e), {}
+
+action_space = [
+    Function(
+        fn_name="save_memory",
+        fn_description="Save a memory to the membase database",
+        args=[
+            Argument(name="memory", type="str", description="The memory to save"),
+            Argument(name="memory_type", type=["user", "assistant"], description="The type of memory to save"),
+        ],
+        executable=lambda memory, memory_type: save_memory_executable(membase_plugin, memory, memory_type),
+    ),
+    Function(
+        fn_name="get_memory",
+        fn_description="Get the last n memories from the membase database",
+        args=[
+            Argument(name="recent_n", type="int", description="The number of memories to retrieve"),
+        ],
+        executable=lambda recent_n: get_memory_executable(membase_plugin, recent_n),
+    )
+]
+
+chat = chat_agent.create_chat(
+    partner_id=default_account,
+    partner_name=default_agent_name,
+    action_space=action_space,
+)
+
+membase_plugin.switch_conversation_id(default_conversation_id)
+membase_plugin.reload_memory(default_conversation_id)
+
+chat_continue = True
+while chat_continue:
+
+    user_message = input("Enter a message: ")
+
+    response = chat.next(user_message)
+
+    if response.function_call:
+        print(f"Function call: {response.function_call.fn_name}")
+
+    if response.message:
+        print(f"Response: {response.message}")
+
+    if response.is_finished:
+        chat_continue = False
+        break
+
+print("Chat ended")
+