@elizaos/plugin-twitter 1.0.9 → 1.0.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/plugin-twitter",
-  "version": "1.0.9",
+  "version": "1.0.13",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -18,40 +18,28 @@
     "dist"
   ],
   "dependencies": {
-    "@elizaos/core": "^1.0.2",
-    "@roamhq/wrtc": "^0.9.0",
-    "@sinclair/typebox": "^0.34.33",
-    "glob": "11.0.2",
+    "@elizaos/core": "^1.0.13",
     "headers-polyfill": "^4.0.3",
     "json-stable-stringify": "^1.3.0",
-    "otpauth": "^9.4.0",
-    "set-cookie-parser": "^2.7.1",
-    "tough-cookie": "^5.1.2",
-    "twitter-api-v2": "^1.23.2",
-    "typescript": "^5.8.3",
-    "undici": "^7.10.0",
-    "undici-types": "^7.10.0",
-    "ws": "^8.18.2"
+    "twitter-api-v2": "^1.23.2"
   },
   "devDependencies": {
-    "@vitest/coverage-v8": "3.1.4",
-    "prettier": "3.5.3",
+    "@vitest/coverage-v8": "3.2.4",
+    "prettier": "3.6.1",
     "tsup": "8.5.0",
-    "vitest": "3.1.4"
+    "typescript": "^5.8.3",
+    "vitest": "3.2.4"
   },
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
-    "test": "vitest run",
+    "test": "tsup && elizaos test",
     "test:coverage": "vitest run --coverage",
     "lint": "prettier --write ./src",
     "clean": "rm -rf dist .turbo node_modules .turbo-tsconfig.json tsconfig.tsbuildinfo",
     "format": "prettier --write ./src",
     "format:check": "prettier --check ./src"
   },
-  "peerDependencies": {
-    "whatwg-url": "14.2.0"
-  },
   "publishConfig": {
     "access": "public"
   },
@@ -63,204 +51,196 @@
   "agentConfig": {
     "pluginType": "elizaos:plugin:1.0.0",
     "pluginParameters": {
-      "TWITTER_SPACES_ENABLE": {
-        "type": "boolean",
-        "description": "Flag indicating whether the agent is allowed to join Twitter Spaces.",
-        "required": false,
-        "sensitive": false
-      },
-      "MAX_RETRIES": {
-        "type": "number",
-        "description": "Maximum number of times the system will attempt to log in to Twitter before giving up",
-        "required": false,
-        "default": 3,
-        "sensitive": false
-      },
-      "TWITTER_USERNAME": {
+      "TWITTER_API_KEY": {
         "type": "string",
-        "description": "Twitter account username used for authentication",
+        "description": "Twitter API v2 key for authentication.",
         "required": true,
-        "sensitive": false
+        "sensitive": true
       },
-      "TWITTER_PASSWORD": {
+      "TWITTER_API_SECRET_KEY": {
         "type": "string",
-        "description": "Twitter account password used for authentication",
+        "description": "Twitter API v2 secret key paired with the API key for authentication.",
         "required": true,
         "sensitive": true
       },
-      "TWITTER_EMAIL": {
+      "TWITTER_ACCESS_TOKEN": {
         "type": "string",
-        "description": "Email address associated with the Twitter account; used during login/verification",
+        "description": "OAuth access token for Twitter API v2 requests.",
         "required": true,
-        "sensitive": false
-      },
-      "TWITTER_2FA_SECRET": {
-        "type": "string",
-        "description": "Time-based one-time password (2FA) secret used for two-factor authentication during login",
-        "required": false,
         "sensitive": true
       },
-      "TWITTER_COOKIES_AUTH_TOKEN": {
+      "TWITTER_ACCESS_TOKEN_SECRET": {
         "type": "string",
-        "description": "Pre-existing Twitter auth_token cookie value used to bypass manual login",
-        "required": false,
+        "description": "OAuth access token secret used with the access token for authentication.",
+        "required": true,
         "sensitive": true
       },
-      "TWITTER_COOKIES_CT0": {
+      "TWITTER_TARGET_USERS": {
         "type": "string",
-        "description": "Pre-existing Twitter ct0 (CSRF) cookie value used to bypass manual login",
+        "description": "Comma-separated list of Twitter usernames the bot should interact with. Use '*' for all users.",
         "required": false,
-        "sensitive": true
+        "default": "",
+        "sensitive": false
       },
-      "TWITTER_COOKIES_GUEST_ID": {
-        "type": "string",
-        "description": "Pre-existing Twitter guest_id cookie value used to bypass manual login",
+      "TWITTER_RETRY_LIMIT": {
+        "type": "number",
+        "description": "Maximum number of retry attempts when a Twitter operation fails.",
         "required": false,
-        "sensitive": true
+        "default": 5,
+        "sensitive": false
       },
-      "TWITTER_API_KEY": {
-        "type": "string",
-        "description": "Twitter API key used to authenticate with the Twitter API during tests.",
+      "TWITTER_POLL_INTERVAL": {
+        "type": "number",
+        "description": "Timeline polling interval in seconds.",
         "required": false,
-        "sensitive": true
+        "default": 120,
+        "sensitive": false
       },
-      "TWITTER_API_SECRET_KEY": {
-        "type": "string",
-        "description": "Twitter API secret key paired with the API key for authentication.",
+      "TWITTER_SEARCH_ENABLE": {
+        "type": "boolean",
+        "description": "Enable timeline monitoring and interaction processing.",
         "required": false,
-        "sensitive": true
+        "default": true,
+        "sensitive": false
       },
-      "TWITTER_ACCESS_TOKEN": {
-        "type": "string",
-        "description": "OAuth access token used for Twitter API requests in the tests.",
+      "TWITTER_DRY_RUN": {
+        "type": "boolean",
+        "description": "When true, all Twitter actions are simulated and nothing is actually posted.",
         "required": false,
-        "sensitive": true
+        "default": false,
+        "sensitive": false
       },
-      "TWITTER_ACCESS_TOKEN_SECRET": {
-        "type": "string",
-        "description": "OAuth access token secret used with the access token for authentication.",
+      "TWITTER_POST_ENABLE": {
+        "type": "boolean",
+        "description": "Enable autonomous tweet posting.",
         "required": false,
-        "sensitive": true
-      },
-      "OPENAI_API_KEY": {
-        "type": "string",
-        "description": "OpenAI API key supplied to the SttTtsPlugin for GPT/STT/TTS functionality.",
-        "required": true,
-        "sensitive": true
+        "default": false,
+        "sensitive": false
       },
-      "ELEVENLABS_API_KEY": {
-        "type": "string",
-        "description": "ElevenLabs API key for TTS provided to the SttTtsPlugin. Used if ELEVENLABS_XI_API_KEY is not set.",
+      "TWITTER_POST_INTERVAL_MIN": {
+        "type": "number",
+        "description": "Minimum interval in minutes between automatically generated posts.",
         "required": false,
-        "sensitive": true
+        "default": 90,
+        "sensitive": false
       },
-      "ELEVENLABS_XI_API_KEY": {
-        "type": "string",
-        "description": "Alternative ElevenLabs (Xi) API key for TTS; used as a fallback if ELEVENLABS_API_KEY is not provided.",
+      "TWITTER_POST_INTERVAL_MAX": {
+        "type": "number",
+        "description": "Maximum interval in minutes between automatically generated posts.",
         "required": false,
-        "sensitive": true
+        "default": 180,
+        "sensitive": false
       },
-      "PROXY_URL": {
-        "type": "string",
-        "description": "URL of the proxy server (may include credentials) through which HTTP requests are routed.",
+      "TWITTER_POST_IMMEDIATELY": {
+        "type": "boolean",
+        "description": "Skip intervals and post immediately after generation.",
         "required": false,
-        "sensitive": true
+        "default": false,
+        "sensitive": false
       },
-      "TWITTER_COOKIES": {
-        "type": "string",
-        "description": "Serialized Twitter session cookies; referenced for cookie-based authentication.",
+      "TWITTER_POST_INTERVAL_VARIANCE": {
+        "type": "number",
+        "description": "Random variance factor (0.0-1.0) applied to posting intervals for natural behavior.",
         "required": false,
-        "sensitive": true
+        "default": 0.2,
+        "sensitive": false
       },
-      "TWITTER_DRY_RUN": {
-        "type": "boolean",
-        "description": "When true, all Twitter actions are simulated and nothing is actually posted.",
+      "TWITTER_INTERACTION_INTERVAL_MIN": {
+        "type": "number",
+        "description": "Minimum interval in minutes between interactions.",
         "required": false,
+        "default": 15,
         "sensitive": false
       },
-      "TWITTER_RETRY_LIMIT": {
+      "TWITTER_INTERACTION_INTERVAL_MAX": {
         "type": "number",
-        "description": "Maximum number of retry attempts when a Twitter action fails.",
+        "description": "Maximum interval in minutes between interactions.",
         "required": false,
-        "default": 5,
+        "default": 30,
         "sensitive": false
       },
-      "TWITTER_POLL_INTERVAL": {
+      "TWITTER_INTERACTION_INTERVAL_VARIANCE": {
         "type": "number",
-        "description": "Polling interval in seconds between checks for new Twitter events.",
+        "description": "Random variance factor (0.0-1.0) applied to interaction intervals for natural behavior.",
         "required": false,
-        "default": 120,
+        "default": 0.3,
         "sensitive": false
       },
-      "TWITTER_TARGET_USERS": {
+      "TWITTER_TIMELINE_ALGORITHM": {
         "type": "string",
-        "description": "Comma-separated list of Twitter usernames the bot should interact with. Supports '*' wildcard.",
+        "description": "Timeline processing algorithm: 'weighted' (default) or 'latest'.",
         "required": false,
+        "default": "weighted",
         "sensitive": false
       },
-      "TWITTER_ENABLE_POST_GENERATION": {
-        "type": "boolean",
-        "description": "Toggle to enable or disable automatic tweet/post generation.",
+      "TWITTER_TIMELINE_USER_BASED_WEIGHT": {
+        "type": "number",
+        "description": "Weight for user-based scoring in weighted timeline algorithm.",
         "required": false,
-        "default": true,
+        "default": 3,
         "sensitive": false
       },
-      "TWITTER_POST_INTERVAL_MIN": {
+      "TWITTER_TIMELINE_TIME_BASED_WEIGHT": {
         "type": "number",
-        "description": "Minimum interval in minutes between automatically generated posts.",
+        "description": "Weight for time-based scoring in weighted timeline algorithm.",
         "required": false,
-        "default": 90,
+        "default": 2,
         "sensitive": false
       },
-      "TWITTER_POST_INTERVAL_MAX": {
+      "TWITTER_TIMELINE_RELEVANCE_WEIGHT": {
         "type": "number",
-        "description": "Maximum interval in minutes between automatically generated posts.",
+        "description": "Weight for relevance-based scoring in weighted timeline algorithm.",
         "required": false,
-        "default": 180,
+        "default": 5,
         "sensitive": false
       },
-      "TWITTER_POST_IMMEDIATELY": {
-        "type": "boolean",
-        "description": "If true, posts are published immediately after generation, bypassing interval checks.",
+      "TWITTER_MAX_TWEET_LENGTH": {
+        "type": "number",
+        "description": "Maximum tweet length (supports long-form tweets up to 4000 characters).",
         "required": false,
+        "default": 4000,
         "sensitive": false
       },
-      "TWITTER_INTERACTION_ENABLE": {
-        "type": "boolean",
-        "description": "Controls whether mention and interaction handling is enabled. Defaults to true when not explicitly set to false.",
+      "TWITTER_MAX_INTERACTIONS_PER_RUN": {
+        "type": "number",
+        "description": "Maximum number of interactions processed per cycle.",
         "required": false,
-        "default": true,
+        "default": 10,
         "sensitive": false
       },
-      "TWITTER_TIMELINE_ENABLE": {
+      "TWITTER_DM_ONLY": {
         "type": "boolean",
-        "description": "Enables fetching and caching of the Twitter timeline.",
+        "description": "Only process direct messages, ignore public interactions.",
         "required": false,
+        "default": false,
         "sensitive": false
       },
-      "TWITTER_API_SECRET": {
-        "type": "string",
-        "description": "Twitter API secret credential (referenced in comments for future API-based auth).",
-        "required": false,
-        "sensitive": true
-      },
       "TWITTER_ENABLE_ACTION_PROCESSING": {
         "type": "boolean",
-        "description": "Flag to enable or disable processing of Twitter actions",
+        "description": "Enable timeline action processing and automated responses.",
         "required": false,
+        "default": false,
         "sensitive": false
       },
-      "TWITTER_TIMELINE_MODE": {
-        "type": "string",
-        "description": "Specifies which Twitter timeline to monitor: 'foryou' (home) or 'following'.",
+      "TWITTER_ACTION_INTERVAL": {
+        "type": "number",
+        "description": "Interval in minutes between timeline action processing cycles.",
         "required": false,
+        "default": 240,
         "sensitive": false
       },
-      "TWITTER_TIMELINE_POLL_INTERVAL": {
-        "type": "number",
-        "description": "Polling interval (in seconds) between timeline checks.",
+      "TWITTER_AUTO_RESPOND_MENTIONS": {
+        "type": "boolean",
+        "description": "Automatically respond to mentions.",
         "required": false,
-        "default": 120,
+        "default": true,
+        "sensitive": false
+      },
+      "TWITTER_AUTO_RESPOND_REPLIES": {
+        "type": "boolean",
+        "description": "Automatically respond to replies.",
+        "required": false,
+        "default": true,
         "sensitive": false
       }
     }

package/dist/chunk-PZ5AY32C.js

@@ -1,10 +0,0 @@
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
-export {
-  __export
-};
-//# sourceMappingURL=chunk-PZ5AY32C.js.map

package/dist/chunk-PZ5AY32C.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/node-L7ZVN5QV.js

@@ -1,40 +0,0 @@
-import "./chunk-PZ5AY32C.js";
-
-// src/client/platform/node/randomize-ciphers.ts
-import { randomBytes } from "crypto";
-import tls from "tls";
-var ORIGINAL_CIPHERS = tls.DEFAULT_CIPHERS;
-var TOP_N_SHUFFLE = 8;
-var shuffleArray = (array) => {
-  for (let i = array.length - 1; i > 0; i--) {
-    const j = randomBytes(4).readUint32LE() % array.length;
-    [array[i], array[j]] = [array[j], array[i]];
-  }
-  return array;
-};
-var randomizeCiphers = () => {
-  do {
-    const cipherList = ORIGINAL_CIPHERS.split(":");
-    const shuffled = shuffleArray(cipherList.slice(0, TOP_N_SHUFFLE));
-    const retained = cipherList.slice(TOP_N_SHUFFLE);
-    tls.DEFAULT_CIPHERS = [...shuffled, ...retained].join(":");
-  } while (tls.DEFAULT_CIPHERS === ORIGINAL_CIPHERS);
-};
-
-// src/client/platform/node/index.ts
-var NodePlatform = class {
-  /**
-   * Asynchronously randomizes ciphers.
-   *
-   * @returns {Promise<void>} A promise that resolves once the ciphers are randomized.
-   */
-  randomizeCiphers() {
-    randomizeCiphers();
-    return Promise.resolve();
-  }
-};
-var platform = new NodePlatform();
-export {
-  platform
-};
-//# sourceMappingURL=node-L7ZVN5QV.js.map

package/dist/node-L7ZVN5QV.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/client/platform/node/randomize-ciphers.ts","../src/client/platform/node/index.ts"],"sourcesContent":["import { randomBytes } from 'node:crypto';\nimport tls from 'node:tls';\n\nconst ORIGINAL_CIPHERS = tls.DEFAULT_CIPHERS;\n\n// How many ciphers from the top of the list to shuffle.\n// The remaining ciphers are left in the original order.\nconst TOP_N_SHUFFLE = 8;\n\n// Modified variation of https://stackoverflow.com/a/12646864\nconst shuffleArray = (array: unknown[]) => {\n  for (let i = array.length - 1; i > 0; i--) {\n    const j = randomBytes(4).readUint32LE() % array.length;\n    [array[i], array[j]] = [array[j], array[i]];\n  }\n\n  return array;\n};\n\n// https://github.com/imputnet/cobalt/pull/574\nexport const randomizeCiphers = () => {\n  do {\n    const cipherList = ORIGINAL_CIPHERS.split(':');\n    const shuffled = shuffleArray(cipherList.slice(0, TOP_N_SHUFFLE));\n    const retained = cipherList.slice(TOP_N_SHUFFLE);\n\n    tls.DEFAULT_CIPHERS = [...shuffled, ...retained].join(':');\n  } while (tls.DEFAULT_CIPHERS === ORIGINAL_CIPHERS);\n};\n","import type { PlatformExtensions } from '../platform-interface';\nimport { randomizeCiphers } from './randomize-ciphers';\n\n/**\n * Asynchronously randomizes the order of ciphers used by the Node.js platform.\n * @returns {Promise<void>} A Promise that resolves once the ciphers have been randomized.\n */\nclass NodePlatform implements PlatformExtensions {\n  /**\n   * Asynchronously randomizes ciphers.\n   *\n   * @returns {Promise<void>} A promise that resolves once the ciphers are randomized.\n   */\n  randomizeCiphers(): Promise<void> {\n    randomizeCiphers();\n    return Promise.resolve();\n  }\n}\n\nexport const platform = new NodePlatform();\n"],"mappings":";;;AAAA,SAAS,mBAAmB;AAC5B,OAAO,SAAS;AAEhB,IAAM,mBAAmB,IAAI;AAI7B,IAAM,gBAAgB;AAGtB,IAAM,eAAe,CAAC,UAAqB;AACzC,WAAS,IAAI,MAAM,SAAS,GAAG,IAAI,GAAG,KAAK;AACzC,UAAM,IAAI,YAAY,CAAC,EAAE,aAAa,IAAI,MAAM;AAChD,KAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC;AAAA,EAC5C;AAEA,SAAO;AACT;AAGO,IAAM,mBAAmB,MAAM;AACpC,KAAG;AACD,UAAM,aAAa,iBAAiB,MAAM,GAAG;AAC7C,UAAM,WAAW,aAAa,WAAW,MAAM,GAAG,aAAa,CAAC;AAChE,UAAM,WAAW,WAAW,MAAM,aAAa;AAE/C,QAAI,kBAAkB,CAAC,GAAG,UAAU,GAAG,QAAQ,EAAE,KAAK,GAAG;AAAA,EAC3D,SAAS,IAAI,oBAAoB;AACnC;;;ACrBA,IAAM,eAAN,MAAiD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAM/C,mBAAkC;AAChC,qBAAiB;AACjB,WAAO,QAAQ,QAAQ;AAAA,EACzB;AACF;AAEO,IAAM,WAAW,IAAI,aAAa;","names":[]}