Merge remote-tracking branch 'upstream/main'

.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false

.env.example

@@ -1,15 +1,23 @@
-# Required environment variables
+# Discord Configuration
 DISCORD_APPLICATION_ID=
-DISCORD_API_TOKEN= # Bot token
-OPENAI_API_KEY=sk-* # OpenAI API key, starting with sk-
-REDPILL_API_KEY= # REDPILL API Key
-GROQ_API_KEY=gsk_*
+DISCORD_API_TOKEN=        # Bot token
+DISCORD_VOICE_CHANNEL_ID= # The ID of the voice channel the bot should join (optional)
+
+# AI Model API Keys
+OPENAI_API_KEY= # OpenAI API key, starting with sk-
+
+ETERNALAI_URL=
+ETERNALAI_API_KEY=
+
+GROK_API_KEY= # GROK API Key
+GROQ_API_KEY= # Starts with gsk_
 OPENROUTER_API_KEY=
 GOOGLE_GENERATIVE_AI_API_KEY= # Gemini API key
 
+# Speech Synthesis
 ELEVENLABS_XI_API_KEY= # API key from elevenlabs
 
-# ELEVENLABS SETTINGS
+# ElevenLabs Settings
 ELEVENLABS_MODEL_ID=eleven_multilingual_v2
 ELEVENLABS_VOICE_ID=21m00Tcm4TlvDq8ikWAM
 ELEVENLABS_VOICE_STABILITY=0.5
@@ -19,70 +27,151 @@ ELEVENLABS_VOICE_USE_SPEAKER_BOOST=false
 ELEVENLABS_OPTIMIZE_STREAMING_LATENCY=4
 ELEVENLABS_OUTPUT_FORMAT=pcm_16000
 
+# Twitter/X Configuration
 TWITTER_DRY_RUN=false
 TWITTER_USERNAME= # Account username
 TWITTER_PASSWORD= # Account password
-TWITTER_EMAIL= # Account email
+TWITTER_EMAIL=    # Account email
+TWITTER_2FA_SECRET=
 TWITTER_COOKIES= # Account cookies
-
+TWITTER_POLL_INTERVAL=120 # How often (in seconds) the bot should check for interactions
 X_SERVER_URL=
 XAI_API_KEY=
 XAI_MODEL=
 
-#USE IMAGE GEN
-IMAGE_GEN= #TRUE
-
-#Leave blank to use local embeddings 
-USE_OPENAI_EMBEDDING=  #TRUE
-
-#OpenRouter (Use one model for everything or set individual for small, medium, large tasks)
-#leave blank to use defaults hermes 70b for small tasks & 405b for medium/large tasks
-OPENROUTER_MODEL=
-SMALL_OPENROUTER_MODEL= 
-MEDIUM_OLLAMA_MODEL= 
-LARGE_OLLAMA_MODEL= 
+# Post Interval Settings (in minutes)
+POST_INTERVAL_MIN= # Default: 90
+POST_INTERVAL_MAX= # Default: 180
+POST_IMMEDIATELY=
 
+# Feature Flags
+IMAGE_GEN=            # Set to TRUE to enable image generation
+USE_OPENAI_EMBEDDING= # Set to TRUE for OpenAI/1536, leave blank for local
+USE_OLLAMA_EMBEDDING= # Set to TRUE for OLLAMA/1024, leave blank for local
 
-#Set to Use for New OLLAMA provider 
-OLLAMA_SERVER_URL=   #Leave blank for default localhost:11434
-OLLAMA_MODEL= 
-OLLAMA_EMBEDDING_MODEL=     #default mxbai-embed-large
-#To use custom model types for different tasks set these
-SMALL_OLLAMA_MODEL=         #default llama3.2
-MEDIUM_OLLAMA_MODEL=        #default herems3
-LARGE_OLLAMA_MODEL=         #default hermes3:70b
+# OpenRouter Models
+OPENROUTER_MODEL= # Default: uses hermes 70b/405b
+SMALL_OPENROUTER_MODEL=
+MEDIUM_OPENROUTER_MODEL=
+LARGE_OPENROUTER_MODEL=
 
-# For asking Claude stuff
-ANTHROPIC_API_KEY=
-
-# Heurist API (Get API Key at https://heurist.ai/dev-access)
-HEURIST_API_KEY=
+# REDPILL Configuration
+# https://docs.red-pill.ai/get-started/supported-models
+REDPILL_API_KEY= # REDPILL API Key
+REDPILL_MODEL=
+SMALL_REDPILL_MODEL=  # Default: gpt-4o-mini
+MEDIUM_REDPILL_MODEL= # Default: gpt-4o
+LARGE_REDPILL_MODEL=  # Default: gpt-4o
+
+# Ollama Configuration
+OLLAMA_SERVER_URL= # Default: localhost:11434
+OLLAMA_MODEL=
+OLLAMA_EMBEDDING_MODEL= # Default: mxbai-embed-large
+SMALL_OLLAMA_MODEL=     # Default: llama3.2
+MEDIUM_OLLAMA_MODEL=    # Default: hermes3
+LARGE_OLLAMA_MODEL=     # Default: hermes3:70b
+
+#LlamaLocal Configuration
+LLAMALOCAL_PATH= # Default: "" which is the current directory in plugin-node/dist/ which gets destroyed and recreated on every build
+
+# API Keys
+ANTHROPIC_API_KEY= # For Claude
+HEURIST_API_KEY=   # Get from https://heurist.ai/dev-access
+
+# Heurist Models
 SMALL_HEURIST_LANGUAGE_MODEL=
 MEDIUM_HEURIST_LANGUAGE_MODEL=
 LARGE_HEURIST_LANGUAGE_MODEL=
 HEURIST_IMAGE_MODEL=
 
-WALLET_PRIVATE_KEY=EXAMPLE_WALLET_PRIVATE_KEY
-WALLET_PUBLIC_KEY=EXAMPLE_WALLET_PUBLIC_KEY
+# EVM
+EVM_PRIVATE_KEY=
+
+# Solana
+SOLANA_PRIVATE_KEY=
+SOLANA_PUBLIC_KEY=
+
+# Fallback Wallet Configuration (deprecated)
+WALLET_PRIVATE_KEY=
+WALLET_PUBLIC_KEY=
 
 BIRDEYE_API_KEY=
 
+# Solana Configuration
 SOL_ADDRESS=So11111111111111111111111111111111111111112
 SLIPPAGE=1
 BASE_MINT=So11111111111111111111111111111111111111112
 RPC_URL=https://api.mainnet-beta.solana.com
 HELIUS_API_KEY=
 
-
-## Telegram
+# Telegram Configuration
 TELEGRAM_BOT_TOKEN=
 
+# Together Configuration
 TOGETHER_API_KEY=
+
+# Server Configuration
 SERVER_PORT=3000
 
-# Starknet
+# Starknet Configuration
 STARKNET_ADDRESS=
 STARKNET_PRIVATE_KEY=
+STARKNET_RPC_URL=
+
+# Intiface Configuration
+INTIFACE_WEBSOCKET_URL=ws://localhost:12345
+
+# Farcaster
+FARCASTER_HUB_URL=
+FARCASTER_FID=
+FARCASTER_PRIVATE_KEY=
+
+# Coinbase
+COINBASE_COMMERCE_KEY= # from coinbase developer portal
+COINBASE_API_KEY=      # from coinbase developer portal
+COINBASE_PRIVATE_KEY=  # from coinbase developer portal
+# if not configured it will be generated and written to runtime.character.settings.secrets.COINBASE_GENERATED_WALLET_ID and runtime.character.settings.secrets.COINBASE_GENERATED_WALLET_HEX_SEED
+COINBASE_GENERATED_WALLET_ID=       # not your address but the wallet id from generating a wallet through the plugin
+COINBASE_GENERATED_WALLET_HEX_SEED= # not your address but the wallet hex seed from generating a wallet through the plugin and calling export
+
+# Conflux Configuration
+CONFLUX_CORE_PRIVATE_KEY=
+CONFLUX_CORE_SPACE_RPC_URL=
+CONFLUX_ESPACE_PRIVATE_KEY=
+CONFLUX_ESPACE_RPC_URL=
+CONFLUX_MEME_CONTRACT_ADDRESS=
+
+#ZeroG
+ZEROG_INDEXER_RPC=
+ZEROG_EVM_RPC=
+ZEROG_PRIVATE_KEY=
+ZEROG_FLOW_ADDRESS=
+
+# Coinbase
+COINBASE_COMMERCE_KEY=
+COINBASE_API_KEY=
+COINBASE_PRIVATE_KEY=
+
+COINBASE_GENERATED_WALLET_ID=
+COINBASE_GENERATED_WALLET_HEX_SEED=
+
+# TEE Configuration
+DSTACK_SIMULATOR_ENDPOINT=
+WALLET_SECRET_SALT= # ONLY DEFINE IF YOU WANT TO USE TEE Plugin, otherwise it will throw errors
+
+# Galadriel Configuration
+GALADRIEL_API_KEY=gal-* # Get from https://dashboard.galadriel.com/
+
+# fal.ai Configuration
+FAL_API_KEY=
+FAL_AI_LORA_PATH=
+
+# WhatsApp Cloud API Configuration
+WHATSAPP_ACCESS_TOKEN=         # Permanent access token from Facebook Developer Console
+WHATSAPP_PHONE_NUMBER_ID=      # Phone number ID from WhatsApp Business API
+WHATSAPP_BUSINESS_ACCOUNT_ID=  # Business Account ID from Facebook Business Manager
+WHATSAPP_WEBHOOK_VERIFY_TOKEN= # Custom string for webhook verification
+WHATSAPP_API_VERSION=v17.0     # WhatsApp API version (default: v17.0)
 
 # ICP
 INTERNET_COMPUTER_PRIVATE_KEY=

.eslintrc.json

@@ -0,0 +1,47 @@
+{
+  "plugins": [
+    "@stylistic"
+  ],
+  "extends": [
+    "next/core-web-vitals",
+    "plugin:@stylistic/recommended-extends"
+  ],
+  "rules": {
+    "@stylistic/indent": [
+      "error",
+      4,
+      {
+        "SwitchCase": 1
+      }
+    ],
+    "@stylistic/no-tabs": "error",
+    "@stylistic/member-delimiter-style": [
+      "error",
+      {
+        "multiline": {
+          "delimiter": "semi",
+          "requireLast": true
+        },
+        "singleline": {
+          "delimiter": "semi",
+          "requireLast": false
+        }
+      }
+    ],
+    "@stylistic/eol-last": [
+      "error",
+      "always"
+    ],
+    "@stylistic/multiline-ternary": "off",
+    "@stylistic/semi": [
+      "error",
+      "always"
+    ],
+    "@stylistic/quotes": "off",
+    "@stylistic/comma-dangle": "off",
+    "@stylistic/brace-style": [
+      "error",
+      "1tbs"
+    ]
+  }
+}

.github/pull_request_template.md

@@ -47,7 +47,7 @@ If a docs change is needed: I have updated the documentation accordingly.
 ## Detailed testing steps
 
 <!--
-None, automtated tests are fine.
+None, automated tests are fine.
 -->
 
 <!--
@@ -77,3 +77,9 @@ None, automtated tests are fine.
 <!--
 ## Deployment instructions
 -->
+
+<!-- If you are on Discord, please join https://discord.gg/ai16z and state your Discord username here for contribute role and join us in #development-feed -->
+<!--
+## Discord username
+
+-->

.github/workflows/ci.yaml

@@ -25,13 +25,21 @@ jobs:
             - name: Run Prettier
               run: pnpm run prettier --check .
 
+            - name: Run Linter
+              run: pnpm run lint
+
             - name: Create test env file
               run: |
                   echo "TEST_DATABASE_CLIENT=sqlite" > packages/core/.env.test
                   echo "NODE_ENV=test" >> packages/core/.env.test
 
-            # - name: Run tests
-            # run: cd packages/core && pnpm test // YOLO FOR NOW
+            - name: Run tests
+              run: cd packages/core && pnpm test
 
             - name: Build packages
               run: pnpm run build
+
+            # - name: Upload coverage reports to Codecov
+            #   uses: codecov/codecov-action@v5
+            #   with:
+            #       token: ${{ secrets.CODECOV_TOKEN }}

.github/workflows/pr.yaml

@@ -25,4 +25,4 @@ jobs:
             - name: Set status
               if: failure()
               run: |
-                  gh pr comment ${{ github.event.pull_request.number }} --body "❌ PR title does not match the required pattern. Please use the format: 'type: description' (e.g., 'feat: add new feature')."
+                  gh pr comment ${{ github.event.pull_request.number }} --body "❌ PR title does not match the required pattern. Please use the format: 'type: description' (e.g., 'feat|fix|docs|style|refactor|test|chore: title')."