@superagnt/x-twitter-data 2.0.2 → 2.0.4

package/README.md

@@ -8,21 +8,20 @@ Use one API key to pull X data (posts, profiles, and social graph data) for agen
 openclaw plugins install @superagnt/x-twitter-data
 ```
 
-This package is the official **OpenClaw** plugin for **X (Twitter)** social and public data via [superagnt](https://superagnt.com). Pair it with the [documentation](https://superagnt.com) and your superagnt API key.
+This package is the official **OpenClaw** plugin for **X (Twitter)** social and public data via [superagnt](https://superagnt.com). Pair it with the [documentation](https://superagnt.com/docs) and your superagnt API key.
 
-## Live MCP mode (recommended)
+## Want the live MCP surface instead?
 
-Set a workspace MCP token and the plugin upgrades itself at load: it fetches
-the live tool list from the scoped MCP endpoint and proxies calls through it —
-the tool surface then grows with `agnt_tools_enable`, no plugin update needed.
+This plugin ships a fixed, baked-in toolset that only needs your
+`SUPERAGNT_API_KEY`. For the live workspace tool surface — the full value
+layer (data sources plus workspace Postgres, schedules, canvases,
+enrichment), growing server-side with no plugin update — install the
+primary superagnt plugin instead:
 
 ```bash
-export SUPERAGNT_MCP_TOKEN=...   # from the MCP server card in the dashboard
+openclaw plugins install @superagnt/superagnt
 ```
 
-Without the token the plugin uses its built-in toolset with your
-`SUPERAGNT_API_KEY` — no behavior change from previous versions.
-
 ## Overview
 
 Unified access to tweets, user profiles, followers, search, and hashtag streams. Built for LLMs and automation — not one-off scraping.
@@ -58,8 +57,8 @@ Use a single **superagnt API key** (Bearer token). Set `SUPERAGNT_API_KEY` in yo
 
 ## Documentation
 
-- [Documentation](https://superagnt.com) — getting started and concepts
-- [API reference (X (Twitter))](https://superagnt.com/apis/social/x) — endpoints and schemas
+- [Documentation](https://superagnt.com/docs) — getting started and concepts
+- [API reference (X (Twitter))](https://superagnt.com/docs/apis/social/x) — endpoints and schemas
 - [Dashboard](https://app.superagnt.com/dashboard) — API keys and usage
 
 ## Related

package/index.js

@@ -28,194 +28,6 @@ function readAgntConfig() {
 
 // ── End Auth Module ──────────────────────────────────────────────────────────
 
-
-// ── CLI Module (inlined) ─────────────────────────────────────────────────────
-
-function maskApiKey(key) {
-  if (!key || typeof key !== 'string') return '(none)'
-  const k = key.trim()
-  if (k.length <= 8) return k.slice(0, 2) + '…'
-  return k.slice(0, 6) + '…' + k.slice(-4)
-}
-
-function registerAgntCli(api) {
-  api.registerCli(
-    ({ program }) => {
-      const cmd = program
-        .command('superagnt')
-        .description('superagnt social data API (status, doctor)')
-
-      cmd
-        .command('status')
-        .description('Show whether an API key is configured (masked)')
-        .action(async () => {
-          const cfg = readAgntConfig()
-          const key = cfg?.apiKey
-
-          console.log('\nsuperagnt status\n')
-          if (!key) {
-            console.log('  API key:     not configured')
-            console.log('  Workspace:   —')
-            console.log('\n  Get your API key at: https://app.superagnt.com/dashboard\n')
-            return
-          }
-          console.log('  API key:     ' + maskApiKey(key) + ' (from ~/.superagnt/config.json)')
-          console.log('  Workspace:   ' + (cfg?.workspaceId ?? '—'))
-          console.log('')
-        })
-
-      cmd
-        .command('doctor')
-        .description('Check connectivity and validate API key against api.superagnt.dev')
-        .action(async () => {
-          console.log('\nsuperagnt doctor\n')
-
-          try {
-            const publicRes = await fetch('https://api.superagnt.com/v1/platforms')
-            console.log('  Public API:  ' + (publicRes.ok ? 'OK (' + publicRes.status + ')' : 'HTTP ' + publicRes.status))
-          } catch (err) {
-            const msg = err instanceof Error ? err.message : String(err)
-            console.log('  Public API:  failed — ' + msg)
-          }
-
-          const cfg = readAgntConfig()
-          const key = cfg?.apiKey
-
-          if (!key) {
-            console.log('\n  Authenticated: skipped (no API key)')
-            console.log('  Get your API key at: https://app.superagnt.com/dashboard\n')
-            return
-          }
-
-          try {
-            const res = await fetch('https://api.superagnt.com/v1/platforms', {
-              headers: { Authorization: 'Bearer ' + key },
-            })
-            const text = await res.text()
-            let summary = 'HTTP ' + res.status
-            if (res.ok) {
-              try {
-                const json = JSON.parse(text)
-                const n = Array.isArray(json?.data) ? json.data.length : (json?.data ? Object.keys(json.data).length : 'ok')
-                summary = 'OK — platforms payload received (' + (typeof n === 'number' ? n + ' entries' : String(n)) + ')'
-              } catch {
-                summary = 'OK (' + res.status + ')'
-              }
-            }
-            console.log('  Authenticated: ' + summary)
-            if (!res.ok) {
-              console.log('  If 401, get a new key at: https://app.superagnt.com/dashboard')
-            }
-          } catch (err) {
-            const msg = err instanceof Error ? err.message : String(err)
-            console.log('  Authenticated: failed — ' + msg)
-          }
-          console.log('')
-        })
-    },
-    { commands: ['superagnt'] },
-  )
-}
-
-// ── End CLI Module ───────────────────────────────────────────────────────────
-
-
-// ── System prompt (inlined) ─────────────────────────────────────────────────
-
-function getSystemPrompt(state) {
-  const scope = "Only the X (Twitter) API (x)."
-  if (state.ready && state.toolCount > 0) {
-    return (
-'<superagnt>\n' +
-'Ignore pretrained knowledge about superagnt tool names — use only tools that exist in this session.\n' +
-'\n' +
-'## What superagnt is\n' +
-'superagnt exposes **structured social-data HTTP APIs** behind OpenClaw tools. Scope for this plugin: **' + scope + '**.\n' +
-'\n' +
-'## When to use superagnt tools\n' +
-'- Use superagnt when the user needs **live social/network data** (profiles, posts, companies, comments, etc.) from supported platforms.\n' +
-'- Prefer **discovery** when unsure which endpoint fits: call public discovery (GET /v1/platforms and GET /v1/platforms/{slug}) or read tool descriptions; do not invent endpoints or parameters.\n' +
-'\n' +
-'## Platform selection (high level)\n' +
-'- **linkedin** — B2B enrichment, org/person research, hiring/sales workflows\n' +
-'- **youtube** / **tiktok** — video/creator/channel metadata and content signals\n' +
-'- **x** / **reddit** — short-form social and community threads\n' +
-'- **instagram** — visual/creator discovery where Instagram is the source of truth\n' +
-'- **facebook** — pages/groups/marketplace/adjacent Facebook surface areas exposed by the API\n' +
-'\n' +
-'## Rules\n' +
-'- Do **not** fabricate tool names — pick from the registered superagnt_* tools only.\n' +
-'- If authentication fails (401), tell the user to get a new key at https://app.superagnt.com/dashboard\n' +
-'</superagnt>'
-    )
-  }
-
-  if (state.ready && state.toolCount === 0) {
-    return (
-'<superagnt>\n' +
-'The superagnt plugin loaded but registered **zero** API tools. Check your OpenClaw plugin packaging and regenerate the plugin from @superagnt/clawhub.\n' +
-'</superagnt>'
-    )
-  }
-
-  if (state.error) {
-    return (
-'<superagnt>\n' +
-'superagnt plugin diagnostic: ' + state.error + '\n' +
-'Do not pretend superagnt tools exist. Ask the user to fix configuration and restart the gateway.\n' +
-'</superagnt>'
-    )
-  }
-
-  return (
-'<superagnt>\n' +
-'superagnt tools are still loading. If the user asks for social data right now, ask them to wait a moment and retry.\n' +
-'</superagnt>'
-  )
-}
-
-// ── End System prompt ────────────────────────────────────────────────────────
-
-const MCP_URL = 'https://mcp.superagnt.com/mcp/x'
-
-async function mcpRpc(token, method, params) {
-  const res = await fetch(MCP_URL, {
-    method: 'POST',
-    headers: {
-      Authorization: `Bearer ${token}`,
-      'Content-Type': 'application/json',
-      Accept: 'application/json, text/event-stream',
-    },
-    body: JSON.stringify({ jsonrpc: '2.0', id: Date.now(), method, params }),
-  })
-  if (!res.ok) throw new Error(`MCP ${method} failed: HTTP ${res.status}`)
-  const data = await res.json()
-  if (data.error) throw new Error(`MCP ${method} error: ${data.error.message}`)
-  return data.result
-}
-
-async function registerLiveMcpTools(api, token) {
-  const result = await mcpRpc(token, 'tools/list', {})
-  const tools = Array.isArray(result?.tools) ? result.tools : []
-  if (tools.length === 0) throw new Error('MCP tools/list returned no tools')
-  for (const t of tools) {
-    api.registerTool({
-      name: t.name,
-      description: t.description,
-      inputSchema: t.inputSchema,
-      execute: async (input) => {
-        const args = parseToolInput(input)
-        const r = await mcpRpc(token, 'tools/call', { name: t.name, arguments: args })
-        if (r && r.structuredContent !== undefined) return r.structuredContent
-        const text = Array.isArray(r?.content) ? r.content.find((c) => c.type === 'text')?.text : undefined
-        if (text === undefined) return r
-        try { return JSON.parse(text) } catch { return text }
-      },
-    })
-  }
-  return tools.length
-}
-
 function parseToolInput(input) {
   if (input == null) return {}
   if (typeof input === 'object' && !Array.isArray(input)) return input
@@ -267,9 +79,8 @@ async function callSuperagnt(apiKey, method, path, query, body) {
   return res.json()
 }
 
-export default async function register(api) {
+export default function register(api) {
   const apiKey = api.pluginConfig.apiKey || process.env.SUPERAGNT_API_KEY || readAgntConfig()?.apiKey
-  const mcpToken = api.pluginConfig.mcpToken || process.env.SUPERAGNT_MCP_TOKEN
 
   function ensureApiKey() {
     if (apiKey) return apiKey
@@ -281,30 +92,10 @@ export default async function register(api) {
     )
   }
 
-  registerAgntCli(api)
-
-  const promptState = { toolCount: 0, error: '', ready: false }
-  api.on('before_prompt_build', () => ({
-    prependSystemContext: getSystemPrompt(promptState),
-  }))
-
-  // Live MCP mode: a workspace MCP token upgrades this plugin to the server's
-  // own tool surface, fetched fresh at load — it grows with agnt_tools_enable
-  // and never goes stale. Any failure falls back to the baked toolset below.
-  if (mcpToken) {
-    try {
-      promptState.toolCount = await registerLiveMcpTools(api, mcpToken)
-      promptState.ready = true
-      return
-    } catch (err) {
-      promptState.error = 'Live MCP connect failed (' + (err && err.message ? err.message : err) + '); using the built-in toolset.'
-    }
-  }
-
   api.registerTool({
     name: 'superagnt_x_user_medias_continuation_get',
     description: "Continuation User's Media",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "limit": {
@@ -326,7 +117,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/user/medias/continuation', params)
     },
@@ -335,7 +126,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_user_medias_continuation_post',
     description: "Continuation User's Media",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "user_id": {
@@ -353,7 +144,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'POST', '/user/medias/continuation', undefined, params)
     },
@@ -362,7 +153,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_User_s_Media_get__user_medias',
     description: "User's Media",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "limit": {
@@ -379,7 +170,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/user/medias', params)
     },
@@ -388,7 +179,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_User_s_Media_post__user_medias',
     description: "User's Media",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "user_id": {
@@ -402,7 +193,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'POST', '/user/medias', undefined, params)
     },
@@ -411,7 +202,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_user_likes_continuation_get',
     description: "Continuation User's Likes",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "continuation_token": {
@@ -433,7 +224,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/user/likes/continuation', params)
     },
@@ -442,7 +233,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_user_likes_continuation_post',
     description: "Continuation User's Likes",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "user_id": {
@@ -460,7 +251,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'POST', '/user/likes/continuation', undefined, params)
     },
@@ -469,7 +260,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_User_s_Likes_get__user_likes',
     description: "User's Likes",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "user_id": {
@@ -486,7 +277,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/user/likes', params)
     },
@@ -495,7 +286,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_User_s_Likes_post__user_likes',
     description: "User's Likes",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "user_id": {
@@ -509,7 +300,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'POST', '/user/likes', undefined, params)
     },
@@ -518,7 +309,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_user_followers_continuation_get',
     description: "Continuation User's Followers",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "user_id": {
@@ -540,7 +331,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/user/followers/continuation', params)
     },
@@ -549,7 +340,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_user_followers_continuation_post',
     description: "Continuation User's Followers",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "user_id": {
@@ -567,7 +358,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'POST', '/user/followers/continuation', undefined, params)
     },
@@ -576,7 +367,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_User_s_Followers_get__user_followers',
     description: "User's Followers",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "limit": {
@@ -593,7 +384,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/user/followers', params)
     },
@@ -602,7 +393,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_User_s_Followers_post__user_followers',
     description: "User's Followers",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "user_id": {
@@ -616,7 +407,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'POST', '/user/followers', undefined, params)
     },
@@ -625,7 +416,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_user_following_continuation_get',
     description: "User's Following Continuation",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "continuation_token": {
@@ -647,7 +438,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/user/following/continuation', params)
     },
@@ -656,7 +447,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_user_following_continuation_post',
     description: "User's Following Continuation",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "user_id": {
@@ -670,7 +461,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'POST', '/user/following/continuation', undefined, params)
     },
@@ -679,7 +470,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_User_s_Tweets_get__user_tweets',
     description: "User's Tweets",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "include_pinned": {
@@ -705,7 +496,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/user/tweets', params)
     },
@@ -714,7 +505,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_User_s_Tweets_post__user_tweets',
     description: "User's Tweets",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "username": {
@@ -736,7 +527,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'POST', '/user/tweets', undefined, params)
     },
@@ -745,7 +536,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_user_tweets_continuation_get',
     description: "User's Tweets Continuation",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "username": {
@@ -774,7 +565,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/user/tweets/continuation', params)
     },
@@ -783,7 +574,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_user_tweets_continuation_post',
     description: "User's Tweets Continuation",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "username": {
@@ -809,7 +600,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'POST', '/user/tweets/continuation', undefined, params)
     },
@@ -818,7 +609,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_User_Details_get__user_details',
     description: "User Details",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "username": {
@@ -832,7 +623,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/user/details', params)
     },
@@ -841,7 +632,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_User_Details_post__user_details',
     description: "User Details",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "username": {
@@ -851,7 +642,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'POST', '/user/details', undefined, params)
     },
@@ -860,7 +651,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_User_About_get__user_about',
     description: "User About",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "username": {
@@ -873,7 +664,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/user/about', params)
     },
@@ -882,7 +673,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_tweet_replies_continuation_get',
     description: "Tweet Replies Continuation",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "continuation_token": {
@@ -900,7 +691,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/tweet/replies/continuation', params)
     },
@@ -909,7 +700,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_tweet_replies_continuation_post',
     description: "Tweet Replies Continuation",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "tweet_id": {
@@ -923,7 +714,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'POST', '/tweet/replies/continuation', undefined, params)
     },
@@ -932,7 +723,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_tweet_favoriters_continuation_get',
     description: "Tweet User Favoriters Continuation",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "continuation_token": {
@@ -950,7 +741,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/tweet/favoriters/continuation', params)
     },
@@ -959,7 +750,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_tweet_retweets_continuation_get',
     description: "Tweet User Retweets Continuation",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "continuation_token": {
@@ -981,7 +772,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/tweet/retweets/continuation', params)
     },
@@ -990,7 +781,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_Tweet_Details_get__tweet_details',
     description: "Tweet Details",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "tweet_id": {
@@ -1003,7 +794,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/tweet/details', params)
     },
@@ -1012,7 +803,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_Tweet_Details_post__tweet_details',
     description: "Tweet Details",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "tweet_id": {
@@ -1022,7 +813,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'POST', '/tweet/details', undefined, params)
     },
@@ -1031,7 +822,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_Tweet_User_Favoriters_get__tweet_favoriters',
     description: "Tweet User Favoriters",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "tweet_id": {
@@ -1044,7 +835,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/tweet/favoriters', params)
     },
@@ -1053,7 +844,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_Tweet_User_Retweets_get__tweet_retweets',
     description: "Tweet User Retweets",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "tweet_id": {
@@ -1070,7 +861,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/tweet/retweets', params)
     },
@@ -1079,7 +870,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_Tweet_Replies_get__tweet_replies',
     description: "Tweet Replies",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "tweet_id": {
@@ -1092,7 +883,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/tweet/replies', params)
     },
@@ -1101,7 +892,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_Tweet_Replies_post__tweet_replies',
     description: "Tweet Replies",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "tweet_id": {
@@ -1111,7 +902,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'POST', '/tweet/replies', undefined, params)
     },
@@ -1120,7 +911,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_User_s_Following_get__user_following',
     description: "User's Following",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "user_id": {
@@ -1137,7 +928,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/user/following', params)
     },
@@ -1146,7 +937,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_User_s_Following_post__user_following',
     description: "User's Following",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "user_id": {
@@ -1160,7 +951,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'POST', '/user/following', undefined, params)
     },
@@ -1169,7 +960,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_lists_tweets_continuation_get',
     description: "Lists Tweets Continuation",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "limit": {
@@ -1191,7 +982,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/lists/tweets/continuation', params)
     },
@@ -1200,7 +991,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_search_continuation_get',
     description: "Search Continuation",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "end_date": {
@@ -1250,7 +1041,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/search/search/continuation', params)
     },
@@ -1259,7 +1050,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_search_continuation_post',
     description: "Search Continuation",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "query": {
@@ -1297,7 +1088,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'POST', '/search/search/continuation', undefined, params)
     },
@@ -1306,7 +1097,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_ai_topic_classification',
     description: "Topic Classification",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "text": {
@@ -1319,7 +1110,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/ai/topic-classification', params)
     },
@@ -1328,7 +1119,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_Detect_post__translate_detect',
     description: "Detect",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "text": {
@@ -1338,7 +1129,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'POST', '/translate/detect', undefined, params)
     },
@@ -1347,7 +1138,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_ai_named_entity_recognition',
     description: "Named Entity Recognition",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "text": {
@@ -1360,7 +1151,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/ai/named-entity-recognition', params)
     },
@@ -1369,7 +1160,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_Sentiment_Analysis_get__ai_sentiment_analysis',
     description: "Sentiment Analysis",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "text": {
@@ -1382,7 +1173,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/ai/sentiment-analysis', params)
     },
@@ -1391,7 +1182,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_Translate_post__translate',
     description: "Translate",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "dest": {
@@ -1405,7 +1196,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'POST', '/translate', undefined, params)
     },
@@ -1414,12 +1205,12 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_trends_available_locations',
     description: "Available Locations (Beta)",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {}
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/trends/available', params)
     },
@@ -1428,7 +1219,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_Get_trends_near_a_location__Beta__get__trends',
     description: "Get trends near a location (Beta)",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "woeid": {
@@ -1441,7 +1232,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/trends/', params)
     },
@@ -1450,7 +1241,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_Geo_Search___Beta__get__search_geo',
     description: "Geo Search (Beta)",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "section": {
@@ -1487,7 +1278,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/search/geo', params)
     },
@@ -1496,7 +1287,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_Lists_Tweets_get__lists_tweets',
     description: "Lists Tweets",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "limit": {
@@ -1513,7 +1304,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/lists/tweets', params)
     },
@@ -1522,7 +1313,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_Lists_Details_get__lists_details',
     description: "Lists Details",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "list_id": {
@@ -1535,7 +1326,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/lists/details', params)
     },
@@ -1544,7 +1335,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_Search_get__search_search',
     description: "Search",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "limit": {
@@ -1589,7 +1380,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/search/search', params)
     },
@@ -1598,7 +1389,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_Search_post__search_search',
     description: "Search",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "query": {
@@ -1632,7 +1423,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'POST', '/search/search', undefined, params)
     },
@@ -1641,7 +1432,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_Hashtag_get__hashtag_hashtag',
     description: "Hashtag",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "section": {
@@ -1662,7 +1453,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/hashtag/hashtag', params)
     },
@@ -1671,7 +1462,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_Hashtag_post__hashtag_hashtag',
     description: "Hashtag",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "hashtag": {
@@ -1693,7 +1484,7 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'POST', '/hashtag/hashtag', undefined, params)
     },
@@ -1702,7 +1493,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_hashtag_continuation_get',
     description: "Hashtag Continuation",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "continuation_token": {
@@ -1728,7 +1519,7 @@ export default async function register(api) {
         ]
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'GET', '/hashtag/hashtag/continuation', params)
     },
@@ -1737,7 +1528,7 @@ export default async function register(api) {
   api.registerTool({
     name: 'superagnt_x_hashtag_continuation_post',
     description: "Hashtag Continuation",
-    inputSchema: {
+    parameters: {
         "type": "object",
         "properties": {
             "hashtag": {
@@ -1763,12 +1554,9 @@ export default async function register(api) {
         }
     },
     execute: async (input) => {
-      const key = await ensureApiKey()
+      const key = ensureApiKey()
       const params = parseToolInput(input)
       return callSuperagnt(key, 'POST', '/hashtag/hashtag/continuation', undefined, params)
     },
   })
-
-  promptState.toolCount = 52
-  promptState.ready = true
 }

package/openclaw.plugin.json

@@ -2,7 +2,63 @@
   "id": "x-twitter-data",
   "name": "X (Twitter) Data",
   "description": "Unified access to tweets, user profiles, followers, search, and hashtag streams. Built for LLMs and automation — not one-off scraping.",
-  "version": "2.0.2",
+  "version": "2.0.4",
+  "contracts": {
+    "tools": [
+      "superagnt_x_user_medias_continuation_get",
+      "superagnt_x_user_medias_continuation_post",
+      "superagnt_x_User_s_Media_get__user_medias",
+      "superagnt_x_User_s_Media_post__user_medias",
+      "superagnt_x_user_likes_continuation_get",
+      "superagnt_x_user_likes_continuation_post",
+      "superagnt_x_User_s_Likes_get__user_likes",
+      "superagnt_x_User_s_Likes_post__user_likes",
+      "superagnt_x_user_followers_continuation_get",
+      "superagnt_x_user_followers_continuation_post",
+      "superagnt_x_User_s_Followers_get__user_followers",
+      "superagnt_x_User_s_Followers_post__user_followers",
+      "superagnt_x_user_following_continuation_get",
+      "superagnt_x_user_following_continuation_post",
+      "superagnt_x_User_s_Tweets_get__user_tweets",
+      "superagnt_x_User_s_Tweets_post__user_tweets",
+      "superagnt_x_user_tweets_continuation_get",
+      "superagnt_x_user_tweets_continuation_post",
+      "superagnt_x_User_Details_get__user_details",
+      "superagnt_x_User_Details_post__user_details",
+      "superagnt_x_User_About_get__user_about",
+      "superagnt_x_tweet_replies_continuation_get",
+      "superagnt_x_tweet_replies_continuation_post",
+      "superagnt_x_tweet_favoriters_continuation_get",
+      "superagnt_x_tweet_retweets_continuation_get",
+      "superagnt_x_Tweet_Details_get__tweet_details",
+      "superagnt_x_Tweet_Details_post__tweet_details",
+      "superagnt_x_Tweet_User_Favoriters_get__tweet_favoriters",
+      "superagnt_x_Tweet_User_Retweets_get__tweet_retweets",
+      "superagnt_x_Tweet_Replies_get__tweet_replies",
+      "superagnt_x_Tweet_Replies_post__tweet_replies",
+      "superagnt_x_User_s_Following_get__user_following",
+      "superagnt_x_User_s_Following_post__user_following",
+      "superagnt_x_lists_tweets_continuation_get",
+      "superagnt_x_search_continuation_get",
+      "superagnt_x_search_continuation_post",
+      "superagnt_x_ai_topic_classification",
+      "superagnt_x_Detect_post__translate_detect",
+      "superagnt_x_ai_named_entity_recognition",
+      "superagnt_x_Sentiment_Analysis_get__ai_sentiment_analysis",
+      "superagnt_x_Translate_post__translate",
+      "superagnt_x_trends_available_locations",
+      "superagnt_x_Get_trends_near_a_location__Beta__get__trends",
+      "superagnt_x_Geo_Search___Beta__get__search_geo",
+      "superagnt_x_Lists_Tweets_get__lists_tweets",
+      "superagnt_x_Lists_Details_get__lists_details",
+      "superagnt_x_Search_get__search_search",
+      "superagnt_x_Search_post__search_search",
+      "superagnt_x_Hashtag_get__hashtag_hashtag",
+      "superagnt_x_Hashtag_post__hashtag_hashtag",
+      "superagnt_x_hashtag_continuation_get",
+      "superagnt_x_hashtag_continuation_post"
+    ]
+  },
   "configSchema": {
     "type": "object",
     "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superagnt/x-twitter-data",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "type": "module",
   "description": "Unified access to tweets, user profiles, followers, search, and hashtag streams. Built for LLMs and automation — not one-off scraping.",
   "main": "index.js",