@superagnt/x-twitter-data 2.0.2

package/index.js

@@ -0,0 +1,1774 @@
+/**
+ * X (Twitter) Data — OpenClaw plugin
+ * Auto-generated by @superagnt/clawhub. Do not edit by hand.
+ */
+
+import { homedir as _homedir } from 'node:os'
+import { join as _join } from 'node:path'
+import { existsSync as _existsSync, readFileSync as _readFileSync } from 'node:fs'
+
+const BASE_URL = 'https://api.superagnt.com/v1/data/x'
+
+
+// ── Auth Module (inlined) ────────────────────────────────────────────────────
+
+function getConfigPath() {
+  return _join(_homedir(), '.superagnt', 'config.json')
+}
+
+function readAgntConfig() {
+  const configFile = getConfigPath()
+  if (!_existsSync(configFile)) return null
+  try {
+    return JSON.parse(_readFileSync(configFile, 'utf-8'))
+  } catch {
+    return null
+  }
+}
+
+// ── 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
+  if (typeof input === 'string') {
+    const trimmed = input.trim()
+    if (trimmed.startsWith('{')) {
+      try { const parsed = JSON.parse(trimmed); if (typeof parsed === 'object' && parsed && !Array.isArray(parsed)) return parsed } catch {}
+    }
+    throw new Error('Invalid tool input: expected a JSON object with named parameters, got string: ' + trimmed.slice(0, 80))
+  }
+  throw new Error('Invalid tool input: expected a JSON object, got ' + typeof input)
+}
+
+function substitutePathParams(path, source) {
+  if (!source || typeof source !== 'object' || Array.isArray(source)) {
+    return { path, consumed: new Set() }
+  }
+  const consumed = new Set()
+  const next = path.replace(/\{([^/{}]+)\}/g, (_, name) => {
+    const v = source[name]
+    if (v === undefined || v === null || v === '') return `{${name}}`
+    consumed.add(name)
+    return encodeURIComponent(String(v))
+  })
+  return { path: next, consumed }
+}
+
+async function callSuperagnt(apiKey, method, path, query, body) {
+  const params = (query && typeof query === 'object' && !Array.isArray(query)) ? query : body
+  const { path: resolvedPath, consumed } = substitutePathParams(path, params)
+  const url = new URL(`${BASE_URL}${resolvedPath}`)
+  if (query && typeof query === 'object' && !Array.isArray(query)) {
+    for (const [k, v] of Object.entries(query)) {
+      if (consumed.has(k)) continue
+      if (v !== undefined && v !== '') url.searchParams.set(k, String(v))
+    }
+  }
+  const filteredBody = body && typeof body === 'object' && !Array.isArray(body)
+    ? Object.fromEntries(Object.entries(body).filter(([k]) => !consumed.has(k)))
+    : body
+  const res = await fetch(url.toString(), {
+    method,
+    headers: { Authorization: `Bearer ${apiKey}`, 'Content-Type': 'application/json' },
+    body: filteredBody ? JSON.stringify(filteredBody) : undefined,
+  })
+  if (res.status === 401) {
+    return { error: 'Invalid or expired API key. Get a new key at https://app.superagnt.com/dashboard' }
+  }
+  return res.json()
+}
+
+export default async 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
+    throw new Error(
+      '[x-twitter-data] No API key configured. ' +
+      'Get your key at https://app.superagnt.com/dashboard and either:\n' +
+      '  1. Export it as SUPERAGNT_API_KEY, or\n' +
+      '  2. Add apiKey to your plugin config'
+    )
+  }
+
+  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: {
+        "type": "object",
+        "properties": {
+            "limit": {
+                "type": "number",
+                "description": "limit"
+            },
+            "continuation_token": {
+                "type": "string",
+                "description": "continuation_token"
+            },
+            "user_id": {
+                "type": "string",
+                "description": "user_id"
+            }
+        },
+        "required": [
+            "continuation_token",
+            "user_id"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/user/medias/continuation', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_user_medias_continuation_post',
+    description: "Continuation User's Media",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "user_id": {
+                "type": "integer",
+                "description": "user_id"
+            },
+            "continuation_token": {
+                "type": "string",
+                "description": "continuation_token"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/user/medias/continuation', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_User_s_Media_get__user_medias',
+    description: "User's Media",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "limit": {
+                "type": "number",
+                "description": "limit"
+            },
+            "user_id": {
+                "type": "string",
+                "description": "user_id"
+            }
+        },
+        "required": [
+            "user_id"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/user/medias', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_User_s_Media_post__user_medias',
+    description: "User's Media",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "user_id": {
+                "type": "integer",
+                "description": "user_id"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/user/medias', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_user_likes_continuation_get',
+    description: "Continuation User's Likes",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "continuation_token": {
+                "type": "string",
+                "description": "continuation_token"
+            },
+            "limit": {
+                "type": "number",
+                "description": "limit"
+            },
+            "user_id": {
+                "type": "string",
+                "description": "user_id"
+            }
+        },
+        "required": [
+            "continuation_token",
+            "user_id"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/user/likes/continuation', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_user_likes_continuation_post',
+    description: "Continuation User's Likes",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "user_id": {
+                "type": "integer",
+                "description": "user_id"
+            },
+            "continuation_token": {
+                "type": "string",
+                "description": "continuation_token"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/user/likes/continuation', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_User_s_Likes_get__user_likes',
+    description: "User's Likes",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "user_id": {
+                "type": "string",
+                "description": "user_id"
+            },
+            "limit": {
+                "type": "number",
+                "description": "limit"
+            }
+        },
+        "required": [
+            "user_id"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/user/likes', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_User_s_Likes_post__user_likes',
+    description: "User's Likes",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "user_id": {
+                "type": "integer",
+                "description": "user_id"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/user/likes', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_user_followers_continuation_get',
+    description: "Continuation User's Followers",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "user_id": {
+                "type": "string",
+                "description": "user_id"
+            },
+            "continuation_token": {
+                "type": "string",
+                "description": "continuation_token"
+            },
+            "limit": {
+                "type": "number",
+                "description": "limit"
+            }
+        },
+        "required": [
+            "user_id",
+            "continuation_token"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/user/followers/continuation', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_user_followers_continuation_post',
+    description: "Continuation User's Followers",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "user_id": {
+                "type": "integer",
+                "description": "user_id"
+            },
+            "continuation_token": {
+                "type": "string",
+                "description": "continuation_token"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/user/followers/continuation', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_User_s_Followers_get__user_followers',
+    description: "User's Followers",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "limit": {
+                "type": "number",
+                "description": "limit"
+            },
+            "user_id": {
+                "type": "string",
+                "description": "user_id"
+            }
+        },
+        "required": [
+            "user_id"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/user/followers', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_User_s_Followers_post__user_followers',
+    description: "User's Followers",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "user_id": {
+                "type": "integer",
+                "description": "user_id"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/user/followers', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_user_following_continuation_get',
+    description: "User's Following Continuation",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "continuation_token": {
+                "type": "string",
+                "description": "continuation_token"
+            },
+            "limit": {
+                "type": "number",
+                "description": "limit"
+            },
+            "user_id": {
+                "type": "string",
+                "description": "user_id"
+            }
+        },
+        "required": [
+            "continuation_token",
+            "user_id"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/user/following/continuation', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_user_following_continuation_post',
+    description: "User's Following Continuation",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "user_id": {
+                "type": "integer",
+                "description": "user_id"
+            },
+            "continuation_token": {
+                "type": "string",
+                "description": "continuation_token"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/user/following/continuation', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_User_s_Tweets_get__user_tweets',
+    description: "User's Tweets",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "include_pinned": {
+                "type": "boolean",
+                "description": "include_pinned"
+            },
+            "limit": {
+                "type": "number",
+                "description": "limit"
+            },
+            "user_id": {
+                "type": "string",
+                "description": "user_id"
+            },
+            "include_replies": {
+                "type": "boolean",
+                "description": "include_replies"
+            },
+            "username": {
+                "type": "string",
+                "description": "username"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/user/tweets', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_User_s_Tweets_post__user_tweets',
+    description: "User's Tweets",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "username": {
+                "type": "string",
+                "description": "username"
+            },
+            "user_id": {
+                "type": "string",
+                "description": "user_id"
+            },
+            "include_replies": {
+                "type": "boolean",
+                "description": "include_replies"
+            },
+            "include_pinned": {
+                "type": "boolean",
+                "description": "include_pinned"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/user/tweets', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_user_tweets_continuation_get',
+    description: "User's Tweets Continuation",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "username": {
+                "type": "string",
+                "description": "username"
+            },
+            "limit": {
+                "type": "number",
+                "description": "limit"
+            },
+            "include_replies": {
+                "type": "boolean",
+                "description": "include_replies"
+            },
+            "continuation_token": {
+                "type": "string",
+                "description": "continuation_token"
+            },
+            "user_id": {
+                "type": "string",
+                "description": "user_id"
+            }
+        },
+        "required": [
+            "continuation_token"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/user/tweets/continuation', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_user_tweets_continuation_post',
+    description: "User's Tweets Continuation",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "username": {
+                "type": "string",
+                "description": "username"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            },
+            "continuation_token": {
+                "type": "string",
+                "description": "continuation_token"
+            },
+            "user_id": {
+                "type": "string",
+                "description": "user_id"
+            },
+            "include_replies": {
+                "type": "boolean",
+                "description": "include_replies"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/user/tweets/continuation', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_User_Details_get__user_details',
+    description: "User Details",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "username": {
+                "type": "string",
+                "description": "username"
+            },
+            "user_id": {
+                "type": "string",
+                "description": "user_id"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/user/details', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_User_Details_post__user_details',
+    description: "User Details",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "username": {
+                "type": "string",
+                "description": "username"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/user/details', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_User_About_get__user_about',
+    description: "User About",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "username": {
+                "type": "string",
+                "description": "username"
+            }
+        },
+        "required": [
+            "username"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/user/about', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_tweet_replies_continuation_get',
+    description: "Tweet Replies Continuation",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "continuation_token": {
+                "type": "string",
+                "description": "continuation_token"
+            },
+            "tweet_id": {
+                "type": "string",
+                "description": "tweet_id"
+            }
+        },
+        "required": [
+            "continuation_token",
+            "tweet_id"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/tweet/replies/continuation', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_tweet_replies_continuation_post',
+    description: "Tweet Replies Continuation",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "tweet_id": {
+                "type": "string",
+                "description": "tweet_id"
+            },
+            "continuation_token": {
+                "type": "string",
+                "description": "continuation_token"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/tweet/replies/continuation', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_tweet_favoriters_continuation_get',
+    description: "Tweet User Favoriters Continuation",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "continuation_token": {
+                "type": "string",
+                "description": "continuation_token"
+            },
+            "tweet_id": {
+                "type": "string",
+                "description": "tweet_id"
+            }
+        },
+        "required": [
+            "continuation_token",
+            "tweet_id"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/tweet/favoriters/continuation', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_tweet_retweets_continuation_get',
+    description: "Tweet User Retweets Continuation",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "continuation_token": {
+                "type": "string",
+                "description": "continuation_token"
+            },
+            "tweet_id": {
+                "type": "string",
+                "description": "tweet_id"
+            },
+            "limit": {
+                "type": "string",
+                "description": "limit"
+            }
+        },
+        "required": [
+            "continuation_token",
+            "tweet_id"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/tweet/retweets/continuation', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_Tweet_Details_get__tweet_details',
+    description: "Tweet Details",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "tweet_id": {
+                "type": "string",
+                "description": "tweet_id"
+            }
+        },
+        "required": [
+            "tweet_id"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/tweet/details', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_Tweet_Details_post__tweet_details',
+    description: "Tweet Details",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "tweet_id": {
+                "type": "string",
+                "description": "tweet_id"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/tweet/details', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_Tweet_User_Favoriters_get__tweet_favoriters',
+    description: "Tweet User Favoriters",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "tweet_id": {
+                "type": "string",
+                "description": "tweet_id"
+            }
+        },
+        "required": [
+            "tweet_id"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/tweet/favoriters', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_Tweet_User_Retweets_get__tweet_retweets',
+    description: "Tweet User Retweets",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "tweet_id": {
+                "type": "string",
+                "description": "tweet_id"
+            },
+            "limit": {
+                "type": "string",
+                "description": "limit"
+            }
+        },
+        "required": [
+            "tweet_id"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/tweet/retweets', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_Tweet_Replies_get__tweet_replies',
+    description: "Tweet Replies",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "tweet_id": {
+                "type": "string",
+                "description": "tweet_id"
+            }
+        },
+        "required": [
+            "tweet_id"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/tweet/replies', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_Tweet_Replies_post__tweet_replies',
+    description: "Tweet Replies",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "tweet_id": {
+                "type": "string",
+                "description": "tweet_id"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/tweet/replies', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_User_s_Following_get__user_following',
+    description: "User's Following",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "user_id": {
+                "type": "string",
+                "description": "user_id"
+            },
+            "limit": {
+                "type": "number",
+                "description": "limit"
+            }
+        },
+        "required": [
+            "user_id"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/user/following', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_User_s_Following_post__user_following',
+    description: "User's Following",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "user_id": {
+                "type": "integer",
+                "description": "user_id"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/user/following', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_lists_tweets_continuation_get',
+    description: "Lists Tweets Continuation",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "limit": {
+                "type": "number",
+                "description": "limit"
+            },
+            "list_id": {
+                "type": "string",
+                "description": "list_id"
+            },
+            "continuation_token": {
+                "type": "string",
+                "description": "continuation_token"
+            }
+        },
+        "required": [
+            "list_id",
+            "continuation_token"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/lists/tweets/continuation', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_search_continuation_get',
+    description: "Search Continuation",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "end_date": {
+                "type": "string",
+                "description": "end_date"
+            },
+            "min_likes": {
+                "type": "number",
+                "description": "min_likes"
+            },
+            "start_date": {
+                "type": "string",
+                "description": "YYYY-MM-DD"
+            },
+            "min_replies": {
+                "type": "number",
+                "description": "min_replies"
+            },
+            "continuation_token": {
+                "type": "string",
+                "description": "continuation_token"
+            },
+            "language": {
+                "type": "string",
+                "description": "language"
+            },
+            "limit": {
+                "type": "number",
+                "description": "limit"
+            },
+            "query": {
+                "type": "string",
+                "description": "query"
+            },
+            "min_retweets": {
+                "type": "number",
+                "description": "min_retweets"
+            },
+            "section": {
+                "type": "string",
+                "description": "section"
+            }
+        },
+        "required": [
+            "continuation_token",
+            "query"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/search/search/continuation', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_search_continuation_post',
+    description: "Search Continuation",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "query": {
+                "type": "string",
+                "description": "query"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            },
+            "section": {
+                "type": "string",
+                "description": "section"
+            },
+            "language": {
+                "type": "string",
+                "description": "language"
+            },
+            "min_likes": {
+                "type": "integer",
+                "description": "min_likes"
+            },
+            "min_retweets": {
+                "type": "integer",
+                "description": "min_retweets"
+            },
+            "start_date": {
+                "type": "string",
+                "description": "start_date"
+            },
+            "continuation_token": {
+                "type": "string",
+                "description": "continuation_token"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/search/search/continuation', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_ai_topic_classification',
+    description: "Topic Classification",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "text": {
+                "type": "string",
+                "description": "text"
+            }
+        },
+        "required": [
+            "text"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/ai/topic-classification', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_Detect_post__translate_detect',
+    description: "Detect",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "text": {
+                "type": "string",
+                "description": "text"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/translate/detect', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_ai_named_entity_recognition',
+    description: "Named Entity Recognition",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "text": {
+                "type": "string",
+                "description": "text"
+            }
+        },
+        "required": [
+            "text"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/ai/named-entity-recognition', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_Sentiment_Analysis_get__ai_sentiment_analysis',
+    description: "Sentiment Analysis",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "text": {
+                "type": "string",
+                "description": "text"
+            }
+        },
+        "required": [
+            "text"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/ai/sentiment-analysis', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_Translate_post__translate',
+    description: "Translate",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "dest": {
+                "type": "string",
+                "description": "dest"
+            },
+            "text": {
+                "type": "string",
+                "description": "text"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/translate', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_trends_available_locations',
+    description: "Available Locations (Beta)",
+    inputSchema: {
+        "type": "object",
+        "properties": {}
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/trends/available', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_Get_trends_near_a_location__Beta__get__trends',
+    description: "Get trends near a location (Beta)",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "woeid": {
+                "type": "string",
+                "description": "woeid"
+            }
+        },
+        "required": [
+            "woeid"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/trends/', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_Geo_Search___Beta__get__search_geo',
+    description: "Geo Search (Beta)",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "section": {
+                "type": "string",
+                "description": "section"
+            },
+            "language": {
+                "type": "string",
+                "description": "language"
+            },
+            "limit": {
+                "type": "string",
+                "description": "limit"
+            },
+            "query": {
+                "type": "string",
+                "description": "query"
+            },
+            "range": {
+                "type": "string",
+                "description": "range"
+            },
+            "longitude": {
+                "type": "string",
+                "description": "longitude"
+            },
+            "latitude": {
+                "type": "string",
+                "description": "latitude"
+            }
+        },
+        "required": [
+            "query"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/search/geo', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_Lists_Tweets_get__lists_tweets',
+    description: "Lists Tweets",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "limit": {
+                "type": "number",
+                "description": "limit"
+            },
+            "list_id": {
+                "type": "string",
+                "description": "list_id"
+            }
+        },
+        "required": [
+            "list_id"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/lists/tweets', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_Lists_Details_get__lists_details',
+    description: "Lists Details",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "list_id": {
+                "type": "string",
+                "description": "list_id"
+            }
+        },
+        "required": [
+            "list_id"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/lists/details', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_Search_get__search_search',
+    description: "Search",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "limit": {
+                "type": "number",
+                "description": "limit"
+            },
+            "language": {
+                "type": "string",
+                "description": "language"
+            },
+            "start_date": {
+                "type": "string",
+                "description": "YYYY-MM-DD"
+            },
+            "min_likes": {
+                "type": "number",
+                "description": "min_likes"
+            },
+            "min_retweets": {
+                "type": "number",
+                "description": "min_retweets"
+            },
+            "query": {
+                "type": "string",
+                "description": "query"
+            },
+            "end_date": {
+                "type": "string",
+                "description": "end_date"
+            },
+            "min_replies": {
+                "type": "number",
+                "description": "min_replies"
+            },
+            "section": {
+                "type": "string",
+                "description": "section"
+            }
+        },
+        "required": [
+            "query"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/search/search', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_Search_post__search_search',
+    description: "Search",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "query": {
+                "type": "string",
+                "description": "query"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            },
+            "section": {
+                "type": "string",
+                "description": "section"
+            },
+            "language": {
+                "type": "string",
+                "description": "language"
+            },
+            "min_likes": {
+                "type": "integer",
+                "description": "min_likes"
+            },
+            "min_retweets": {
+                "type": "integer",
+                "description": "min_retweets"
+            },
+            "start_date": {
+                "type": "string",
+                "description": "start_date"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/search/search', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_Hashtag_get__hashtag_hashtag',
+    description: "Hashtag",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "section": {
+                "type": "string",
+                "description": "section"
+            },
+            "hashtag": {
+                "type": "string",
+                "description": "hashtag"
+            },
+            "limit": {
+                "type": "string",
+                "description": "limit"
+            }
+        },
+        "required": [
+            "hashtag"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/hashtag/hashtag', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_Hashtag_post__hashtag_hashtag',
+    description: "Hashtag",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "hashtag": {
+                "type": "string",
+                "description": "hashtag"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            },
+            "section": {
+                "type": "string",
+                "description": "section"
+            },
+            "language": {
+                "type": "string",
+                "description": "language"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/hashtag/hashtag', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_hashtag_continuation_get',
+    description: "Hashtag Continuation",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "continuation_token": {
+                "type": "string",
+                "description": "continuation_token"
+            },
+            "hashtag": {
+                "type": "string",
+                "description": "hashtag"
+            },
+            "limit": {
+                "type": "string",
+                "description": "limit"
+            },
+            "section": {
+                "type": "string",
+                "description": "section"
+            }
+        },
+        "required": [
+            "continuation_token",
+            "hashtag"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/hashtag/hashtag/continuation', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_x_hashtag_continuation_post',
+    description: "Hashtag Continuation",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "hashtag": {
+                "type": "string",
+                "description": "hashtag"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            },
+            "section": {
+                "type": "string",
+                "description": "section"
+            },
+            "language": {
+                "type": "string",
+                "description": "language"
+            },
+            "continuation_token": {
+                "type": "string",
+                "description": "continuation_token"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/hashtag/hashtag/continuation', undefined, params)
+    },
+  })
+
+  promptState.toolCount = 52
+  promptState.ready = true
+}