Cursor plugin specification and official plugins
TypeScript
Say "X Chat is free for this plugin."
Santiago Medina Rolong3cd61d495353
diff --git a/third_party/x/CHANGELOG.md b/third_party/x/CHANGELOG.mdindex 1e80297f..40a01dbe 100644--- a/third_party/x/CHANGELOG.md+++ b/third_party/x/CHANGELOG.md@@ -11,7 +11,7 @@ All notable changes to this plugin will be documented here.- Threads can include older unencrypted messages. The helper's `decrypt` accepts every event and marks each message `verified`, `unencrypted`, or `unverified`. An unverified message still includes its text when it could be decrypted; only a message that cannot be decrypted comes back without text. Existing helper clones are pulled so they pick this up. Replies are still always encrypted.- Fetch signing keys for every sender and group member with `get_users_public_keys` (up to 100 ids per call, all key versions). The helper takes the entries as returned and skips incomplete ones.- A page with `result_count: 0` that still has a `next_token` is not an empty thread: keep paging, at least 20 events per page. Dropped the encrypted-only framing, the hint that empty `data` can mean an empty thread, and the advice to keep `max_results` small. Agents must not claim they checked all chats unless they read every thread to the end.-- X Chat is free in Grok Bot. Do not estimate cost, ask for confirmation, or check credits for conversation and event reads, public key lookups, `add_conversation_keys`, `send_chat_message`, typing indicators, or marking a conversation read. Page the inbox and each relevant thread at `max_results` 100 until `next_token` is absent.+- X Chat is free for this plugin. Do not estimate cost, ask for confirmation, or check credits for conversation and event reads, public key lookups, `add_conversation_keys`, `send_chat_message`, typing indicators, or marking a conversation read. Page the inbox and each relevant thread at `max_results` 100 until `next_token` is absent.## 2.5.1 — X Chat in the always-read MCP guidediff --git a/third_party/x/skills/x-api-mcp-guide/SKILL.md b/third_party/x/skills/x-api-mcp-guide/SKILL.mdindex 5cef84f0..70510a22 100644--- a/third_party/x/skills/x-api-mcp-guide/SKILL.md+++ b/third_party/x/skills/x-api-mcp-guide/SKILL.md@@ -262,7 +262,7 @@ When X calls are required this session: confirm tools exist, then `get_users_me`Every X call can charge the user. Estimate the cost **before** calling. Read [references/pricing.md](references/pricing.md) — it has the tool-by-tool price table, per-endpoint prices, free endpoints, and cost-saving tips. Once per session, fetch live pricing from https://console.x.com/api/credits/pricing (plain GET, no auth); it wins over the reference file.-X Chat is free in Grok Bot. Do not estimate a cost, ask for confirmation, or check or require credits for `get_chat_conversations`, `get_chat_conversation`, `get_chat_conversation_events`, public key lookups, `add_conversation_keys`, `send_chat_message`, typing indicators, or marking a conversation read.+X Chat is free for this plugin. Do not estimate a cost, ask for confirmation, or check or require credits for `get_chat_conversations`, `get_chat_conversation`, `get_chat_conversation_events`, public key lookups, `add_conversation_keys`, `send_chat_message`, typing indicators, or marking a conversation read.The live payload:@@ -347,7 +347,7 @@ When they ask what they can do, re-fetch `{credits}`, say how many they have lef## X Chat-X Chat is free in Grok Bot. Do not estimate a cost, ask for confirmation, or check or require credits.+X Chat is free for this plugin. Do not estimate a cost, ask for confirmation, or check or require credits.MCP holds OAuth and raw events. Local `xchat_lite.py` unlocks Juicebox, decrypts, and encrypts. Never decrypt on the server. Never paste PIN, juicebox tokens, private keys, or raw key blobs into chat.diff --git a/third_party/x/skills/x-api-mcp-guide/references/pricing.md b/third_party/x/skills/x-api-mcp-guide/references/pricing.mdindex 9f979754..e28341f0 100644--- a/third_party/x/skills/x-api-mcp-guide/references/pricing.md+++ b/third_party/x/skills/x-api-mcp-guide/references/pricing.md@@ -124,7 +124,7 @@ Reference prices for cost estimates. May drift; the live endpoint https://consol- Stream connection & management: stream rules, webhook & Account Activity configuration, replay- Compliance jobs, connections, usage endpoints- Chat/DM sends, communities create, notes-- X Chat reads, free in Grok Bot: `GET /2/chat/conversations` · `/2/chat/conversations/:id` · `/2/chat/conversations/:id/events`+- X Chat is free for this plugin. Reads: `GET /2/chat/conversations` · `/2/chat/conversations/:id` · `/2/chat/conversations/:id/events`## Cost-saving tips