Merge branch 'develop' into agentic-JSDoc

Author: Ed-Marcavage

.env.example

@@ -1,3 +1,7 @@
+# Cache Configs
+CACHE_STORE=database # Defaults to database. Other available cache store: redis and filesystem
+REDIS_URL= # Redis URL - could be a local redis instance or cloud hosted redis. Also support rediss:// urls
+
 # Discord Configuration
 DISCORD_APPLICATION_ID=
 DISCORD_API_TOKEN=              # Bot token
@@ -54,7 +58,6 @@ TWITTER_PASSWORD=               # Account password
 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
 TWITTER_SEARCH_ENABLE=FALSE     # Enable timeline search, WARNING this greatly increases your chance of getting banned
 TWITTER_TARGET_USERS=           # Comma separated list of Twitter user names to interact with
@@ -188,6 +191,11 @@ TOGETHER_API_KEY=
 # Server Configuration
 SERVER_PORT=3000
 
+# Abstract Configuration
+ABSTRACT_ADDRESS=
+ABSTRACT_PRIVATE_KEY=
+ABSTRACT_RPC_URL=https://api.testnet.abs.xyz
+
 # Starknet Configuration
 STARKNET_ADDRESS=
 STARKNET_PRIVATE_KEY=
@@ -332,3 +340,7 @@ STORY_PRIVATE_KEY= # Story private key
 STORY_API_BASE_URL= # Story API base URL
 STORY_API_KEY= # Story API key
 PINATA_JWT= # Pinata JWT for uploading files to IPFS
+
+# Cronos zkEVM
+CRONOSZKEVM_ADDRESS=
+CRONOSZKEVM_PRIVATE_KEY=

.github/workflows/codeql.yml

@@ -0,0 +1,55 @@
+name: "CodeQL Advanced"
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+  schedule:
+    - cron: '29 8 * * 6'
+
+jobs:
+  analyze:
+    name: Analyze (${{ matrix.language }})
+    runs-on: ${{ (matrix.language == 'swift' && 'macos-latest') || 'ubuntu-latest' }}
+    permissions:
+      # required for all workflows
+      security-events: write
+
+      # required to fetch internal or private CodeQL packs
+      packages: read
+
+      # only required for workflows in private repositories
+      actions: read
+      contents: read
+
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+        - language: javascript-typescript
+          build-mode: none
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v3
+      with:
+        languages: ${{ matrix.language }}
+        build-mode: ${{ matrix.build-mode }}
+        
+    - if: matrix.build-mode == 'manual'
+      shell: bash
+      run: |
+        echo 'If you are using a "manual" build mode for one or more of the' \
+          'languages you are analyzing, replace this with the commands to build' \
+          'your code, for example:'
+        echo '  make bootstrap'
+        echo '  make release'
+        exit 1
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v3
+      with:
+        category: "/language:${{matrix.language}}"

.github/workflows/generate-readme-translations.yml

@@ -0,0 +1,88 @@
+name: Generate Readme Translations
+on:
+    push:
+        branches:
+            - "1222--README-ci-auto-translation"
+
+jobs:
+    translation:
+        runs-on: ubuntu-latest
+        strategy:
+            matrix:
+                language: [
+                    {code: 'CN', name: 'Chinese'},
+                    {code: 'DE', name: 'German'},
+                    {code: 'ES', name: 'Spanish'},
+                    {code: 'FR', name: 'French'},
+                    {code: 'HE', name: 'Hebrew'},
+                    {code: 'IT', name: 'Italian'},
+                    {code: 'JA', name: 'Japanese'},
+                    {code: 'KOR', name: 'Korean'},
+                    {code: 'PTBR', name: 'Portuguese (Brazil)'},
+                    {code: 'RU', name: 'Russian'},
+                    {code: 'TH', name: 'Thai'},
+                    {code: 'TR', name: 'Turkish'},
+                    {code: 'VI', name: 'Vietnamese'}
+                ]
+        permissions:
+            contents: write
+        steps:
+            - uses: actions/checkout@v4
+              with:
+                  ref: main
+                  token: ${{ secrets.GH_TOKEN }}
+
+            - name: Translate to ${{ matrix.language.name }}
+              uses: 0xjord4n/aixion@v1.2.1
+              id: aixion
+              with:
+                config: >
+                  {
+                    "provider": "openai",
+                    "provider_options": {
+                      "api_key": "${{ secrets.OPENAI_API_KEY }}"
+                    },
+                    "messages": [
+                      {
+                        "role": "system",
+                        "content": "You will be provided with a markdown file in English, and your task is to translate it into ${{ matrix.language.name }}."
+                      },
+                      {
+                        "role": "user",
+                        "content_path": "README.md"
+                      }
+                    ],
+                    "save_path": "README_${{ matrix.language.code }}.md",
+                    "model": "gpt-4o"
+                  }
+
+            # Upload each translated file as an artifact
+            - name: Upload translation
+              uses: actions/upload-artifact@v4
+              with:
+                name: readme-${{ matrix.language.code }}
+                path: README_${{ matrix.language.code }}.md
+
+    commit:
+        needs: translation
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+              with:
+                  ref: main
+                  token: ${{ secrets.GH_TOKEN }}
+
+            # Download all translation artifacts
+            - name: Download all translations
+              uses: actions/download-artifact@v4
+              with:
+                pattern: readme-*
+                merge-multiple: true
+
+            - name: Commit all translations
+              uses: stefanzweifel/git-auto-commit-action@v5
+              with:
+                  commit_message: "chore: update all README translations"
+                  branch: main
+                  file_pattern: "README_*.md"
+                  commit_author: "GitHub Action <actions@github.com>"

.github/workflows/greetings.yml

@@ -0,0 +1,17 @@
+name: Greetings
+
+on: [pull_request_target, issues]
+
+jobs:
+  greeting:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+    steps:
+    - uses: actions/first-interaction@v1
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        issue-message: "Hello @${{ github.actor }}! Welcome to the ai16z community. Thank you for opening your first issue; we appreciate your contribution. You are now a ai16z contributor!"
+        pr-message: "Hi @${{ github.actor }}! Welcome to the ai16z community. Thanks for submitting your first pull request; your efforts are helping us accelerate towards AGI. We'll review it shortly. You are now a ai16z contributor!"
+

.github/workflows/integrationTests.yaml

@@ -1,30 +1,17 @@
-name: integration-test
+name: Integration Tests
 on:
     push:
         branches:
             - "*"
-    pull_request:
+    pull_request_target:
         branches:
             - "*"
-jobs:
-    smoke-tests:
-        runs-on: ubuntu-latest
-        steps:
-            - uses: actions/checkout@v4
 
-            - uses: pnpm/action-setup@v3
-              with:
-                  version: 9.4.0
-
-            - uses: actions/setup-node@v4
-              with:
-                  node-version: "23"
-                  cache: "pnpm"
-
-            - name: Run smoke tests
-              run: pnpm run smokeTests
+jobs:
     integration-tests:
         runs-on: ubuntu-latest
+        env:
+            OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
         steps:
             - uses: actions/checkout@v4
 
@@ -43,13 +30,12 @@ jobs:
             - name: Build packages
               run: pnpm build
 
-            - name: Run integration tests
-              env:
-                  OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+            - name: Check for API key
               run: |
                   if [ -z "$OPENAI_API_KEY" ]; then
-                    echo "Skipping integration tests due to missing required API keys"
-                    exit 1
-                  else
-                    pnpm run integrationTests
+                      echo "Error: OPENAI_API_KEY is not set."
+                      exit 1
                   fi
+
+            - name: Run integration tests
+              run: pnpm run integrationTests

.github/workflows/pr.yaml

@@ -10,19 +10,21 @@ jobs:
 
         steps:
             - name: Check out the repository
-              uses: actions/checkout@v2
+              uses: actions/checkout@v3
 
             - name: Validate PR title
               id: validate
               run: |
                   PR_TITLE=$(jq -r .pull_request.title "$GITHUB_EVENT_PATH")
                   echo "PR Title: $PR_TITLE"
-                  if [[ ! "$PR_TITLE" =~ ^(feat|fix|docs|style|refactor|test|chore):\ .+ ]]; then
+                  if [[ ! "$PR_TITLE" =~ ^(feat|fix|docs|style|refactor|test|chore)(\([a-zA-Z0-9-]+\))?:\ .+ ]]; then
                     echo "PR title does not match the required pattern."
                     exit 1
                   fi
 
             - 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|fix|docs|style|refactor|test|chore: title')."
+                  gh pr comment ${{ github.event.pull_request.number }} --body "❌ PR title does not match the required pattern. Please use one of these formats:
+                  - 'type: description' (e.g., 'feat: add new feature')
+                  - 'type(scope): description' (e.g., 'chore(core): update dependencies')"

.github/workflows/release.yaml

@@ -15,11 +15,11 @@ jobs:
 
             - uses: actions/setup-node@v4
               with:
-                  node-version: 22
+                  node-version: 23.3.0
 
             - uses: pnpm/action-setup@v3
               with:
-                  version: 8
+                  version: 9.15.0
 
             - name: Configure Git
               run: |

.github/workflows/smoke-tests.yml

@@ -0,0 +1,26 @@
+name: smoke-test
+on:
+    push:
+        branches:
+            - "*"
+    pull_request:
+        branches:
+            - "*"
+
+jobs:
+    smoke-tests:
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+
+            - uses: pnpm/action-setup@v3
+              with:
+                  version: 9.4.0
+
+            - uses: actions/setup-node@v4
+              with:
+                  node-version: "23"
+                  cache: "pnpm"
+
+            - name: Run smoke tests
+              run: pnpm run smokeTests

.github/workflows/stale.yml

@@ -0,0 +1,24 @@
+name: Mark stale issues and pull requests
+
+on:
+  schedule:
+  - cron: '25 18 * * *'
+
+jobs:
+  stale:
+
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+
+    steps:
+    - uses: actions/stale@v5
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        stale-issue-message: 'This issue has been automatically marked as stale due to inactivity.'
+        stale-pr-message: 'This pull request has been automatically marked as stale due to inactivity.'
+        stale-issue-label: 'no-issue-activity'
+        stale-pr-label: 'no-pr-activity'
+        days-before-stale: 30  # Marks issues and PRs as stale after X days of inactivity
+        days-before-close: 7  # Closes issues and PRs X days after being marked as stale

.gitignore

@@ -9,6 +9,7 @@ concatenated-output.ts
 embedding-cache.json
 packages/plugin-buttplug/intiface-engine
 
+.idea
 .DS_Store
 
 dist/
@@ -44,11 +45,12 @@ packages/core/src/providers/cache
 packages/core/src/providers/cache/*
 cache/*
 packages/plugin-coinbase/src/plugins/transactions.csv
-packages/plugin-coinbase/package-lock.json
 
 tsup.config.bundled_*.mjs
 
 .turbo
 
 coverage
 .eslintcache
+
+agent/content