x-developer 2.6.7 → 2.7.1

package/skills/x-twitter-scraper/references/types-radar.md

@@ -1,47 +0,0 @@
-# Xquik TypeScript types: radar
-
-```typescript
-
-type RadarSource =
-  | "github"
-  | "google_trends"
-  | "hacker_news"
-  | "polymarket"
-  | "reddit"
-  | "trustmrr"
-  | "wikipedia";
-
-type RadarCategory =
-  | "general"
-  | "tech"
-  | "dev"
-  | "science"
-  | "culture"
-  | "politics"
-  | "business"
-  | "entertainment";
-
-interface RadarItem {
-  id: string;
-  title: string;
-  description?: string;
-  url?: string;
-  imageUrl?: string;
-  source: RadarSource;
-  sourceId: string;
-  category: RadarCategory;
-  region: string;
-  language: string;
-  score: number;
-  metadata: Record<string, unknown>;
-  publishedAt: string;
-  createdAt: string;
-}
-
-interface RadarPage {
-  items: RadarItem[];
-  hasMore: boolean;
-  nextCursor?: string;
-}
-
-```

package/skills/x-twitter-scraper/references/types-request-bodies.md

@@ -1,30 +0,0 @@
-# Xquik TypeScript types: request bodies
-
-```typescript
-
-interface CreateMonitorRequest {
-  username: string;
-  eventTypes: EventType[];
-}
-
-interface UpdateMonitorRequest {
-  eventTypes?: EventType[];
-  isActive?: boolean;
-}
-
-interface CreateWebhookRequest {
-  url: string;
-  eventTypes: EventType[];
-}
-
-interface UpdateWebhookRequest {
-  url?: string;
-  eventTypes?: EventType[];
-  isActive?: boolean;
-}
-
-interface CreateApiKeyRequest {
-  name?: string;
-}
-
-```

package/skills/x-twitter-scraper/references/types-rest-api-vs-mcp-field-naming.md

@@ -1,11 +0,0 @@
-# Xquik REST API and MCP field naming
-
-Hosted MCP exposes `explore` and `xquik`. It no longer exposes
-operation-named tools with separate legacy response models.
-
-Use `explore` to inspect the current operation. Then use its OpenAPI response
-schema. Do not map fields through old names such as `eventData`,
-`monitoredAccountId`, `following`, or `followedBy`.
-
-Preserve every returned ID and cursor exactly. If a client transforms field
-case, follow that client's serializer documentation.

package/skills/x-twitter-scraper/references/types-support.md

@@ -1,46 +0,0 @@
-# Xquik TypeScript types: support
-
-```typescript
-type SupportTicketStatus = "open" | "in_progress" | "resolved" | "closed";
-type SupportAttachmentStatus = "pending" | "ready" | "failed";
-
-interface SupportAttachmentReceipt {
-  publicId: string;
-  status: SupportAttachmentStatus;
-}
-
-interface SupportAttachment extends SupportAttachmentReceipt {
-  filename: string;
-  contentType: "image/jpeg" | "image/png" | "image/gif" | "image/webp"
-    | "video/mp4" | "video/quicktime" | "video/webm";
-  kind: "image" | "video";
-  sizeBytes: number;
-  url: string;
-}
-
-interface SupportMessage {
-  body: string;
-  sender: "user" | "support" | "system";
-  createdAt: string;
-  attachments: SupportAttachment[];
-}
-
-interface SupportTicket {
-  publicId: string;
-  subject: string;
-  status: SupportTicketStatus;
-  createdAt: string;
-  updatedAt: string;
-  messageCount?: number;
-  messages?: SupportMessage[];
-}
-
-interface SupportMutationResponse {
-  publicId: string;
-  attachments: SupportAttachmentReceipt[];
-}
-
-type SupportContent = { body: string } | { body?: string; attachments: Blob[] };
-type CreateTicketRequest = SupportContent & { subject: string };
-type ReplyToTicketRequest = SupportContent;
-```

package/skills/x-twitter-scraper/references/types-trends.md

@@ -1,21 +0,0 @@
-# Xquik TypeScript types: trends
-
-```typescript
-
-interface Trend {
-  name: string;
-  description?: string;
-  rank?: number;
-  query?: string;
-  promotedContent?: string | null;
-  tweetVolume?: number | null;
-  url?: string;
-}
-
-interface TrendList {
-  trends: Trend[];
-  total: number;
-  woeid: number;
-}
-
-```

package/skills/x-twitter-scraper/references/types-tweet-drafts.md

@@ -1,20 +0,0 @@
-# Xquik TypeScript types: tweet drafts
-
-```typescript
-
-interface TweetDraft {
-  id: string;
-  text: string;
-  topic?: string;
-  goal?: "engagement" | "followers" | "authority" | "conversation";
-  createdAt: string; // ISO 8601
-  updatedAt: string; // ISO 8601
-}
-
-interface TweetDraftList {
-  drafts: TweetDraft[];
-  afterCursor: string | null;
-  hasMore: boolean;
-}
-
-```

package/skills/x-twitter-scraper/references/types-tweet-style-cache.md

@@ -1,50 +0,0 @@
-# Xquik TypeScript types: tweet style cache
-
-```typescript
-
-interface TweetStyleCache {
-  xUsername: string;
-  tweetCount: number;
-  isOwnAccount: boolean;
-  fetchedAt: string; // ISO 8601
-  tweets: CachedTweet[];
-}
-
-interface CachedTweet {
-  id: string;
-  text: string;
-  authorUsername: string;
-  createdAt: string; // ISO 8601
-  media?: TweetMediaItem[];
-}
-
-interface TweetStyleSummary {
-  xUsername: string;
-  tweetCount: number;
-  isOwnAccount: boolean;
-  fetchedAt: string;
-}
-
-interface StyleComparison {
-  style1: TweetStyleCache;
-  style2: TweetStyleCache;
-}
-
-interface StylePerformance {
-  xUsername: string;
-  tweetCount: number;
-  tweets: PerformanceTweet[];
-}
-
-interface PerformanceTweet {
-  id: string;
-  text: string;
-  likeCount: number;
-  retweetCount: number;
-  replyCount: number;
-  quoteCount: number;
-  viewCount: number;
-  bookmarkCount: number;
-}
-
-```

package/skills/x-twitter-scraper/references/types-user-activity.md

@@ -1,35 +0,0 @@
-# Xquik TypeScript types: user activity
-
-```typescript
-
-interface UserTweetsResponse {
-  tweets: Tweet[];
-  has_next_page: boolean;
-  next_cursor?: string;
-}
-
-interface UserLikesResponse {
-  tweets: Tweet[];
-  has_next_page: boolean;
-  next_cursor?: string;
-}
-
-interface UserMediaResponse {
-  tweets: Tweet[];
-  has_next_page: boolean;
-  next_cursor?: string;
-}
-
-interface TweetFavoritersResponse {
-  users: UserProfile[];
-  has_next_page: boolean;
-  next_cursor?: string;
-}
-
-interface FollowersYouKnowResponse {
-  users: UserProfile[];
-  has_next_page: boolean;
-  next_cursor?: string;
-}
-
-```

package/skills/x-twitter-scraper/references/types-webhooks.md

@@ -1,46 +0,0 @@
-# Xquik TypeScript types: webhooks
-
-```typescript
-
-interface WebhookCreated {
-  id: string;
-  url: string;
-  eventTypes: EventType[];
-  secret: string;
-  createdAt: string;
-}
-
-interface Webhook {
-  id: string;
-  url: string;
-  eventTypes: EventType[];
-  isActive: boolean;
-  consecutiveFailures: number;
-  deliveryStatus: "active" | "paused" | "needs_attention";
-  failureHardCap: number;
-  createdAt: string;
-}
-
-interface Delivery {
-  id: string;
-  streamEventId: string;
-  status: "pending" | "delivered" | "failed" | "exhausted";
-  attempts: number;
-  lastStatusCode?: number;
-  lastError?: string;
-  createdAt: string;
-  deliveredAt?: string;
-}
-
-interface WebhookPayload {
-  schemaVersion: 1;
-  streamEventId: string;
-  deliveryId: string;
-  eventType: EventType;
-  username?: string;
-  query?: string;
-  occurredAt: string;
-  data: Record<string, unknown>;
-}
-
-```

package/skills/x-twitter-scraper/references/types-x-accounts.md

@@ -1,16 +0,0 @@
-# Xquik TypeScript types: connected X accounts
-
-```typescript
-
-interface ConnectedXAccount {
-  id: string;                 // Unique account ID
-  username: string;           // X username
-  displayName?: string;       // Display name on X
-  isActive: boolean;          // Whether the connection is active
-  createdAt: string;          // ISO 8601 timestamp
-}
-
-// Users connect X accounts in the Xquik dashboard.
-// This Skill never handles X login material.
-
-```

package/skills/x-twitter-scraper/references/types-x-api.md

@@ -1,144 +0,0 @@
-# Xquik TypeScript types: X API
-
-```typescript
-
-interface TweetMediaItem {
-  mediaUrl: string;
-  type: string;       // "photo" | "video" | "animated_gif"
-  url: string;
-  adultContent?: boolean; allowDownload?: boolean;
-  altText?: string; availabilityReason?: string;
-  aspectRatio?: number[]; availabilityStatus?: string;
-  description?: string; displayUrl?: string;
-  durationMillis?: number; expandedUrl?: string;
-  embeddable?: boolean;
-  faceRects?: Record<string, unknown>; focusRects?: Array<Record<string, number>>;
-  grokPostId?: string; height?: number; id?: string;
-  indices?: number[];
-  mediaKey?: string; monetizable?: boolean;
-  sizes?: Record<string, unknown>;
-  sourceStatusId?: string; sourceUserId?: string;
-  tags?: Array<Record<string, string>>;
-  title?: string;
-  videoVariants?: Array<Record<string, unknown>>;
-  watchNowUrl?: string; visitSiteUrl?: string;
-  width?: number;
-}
-
-interface Tweet {
-  id: string;
-  text: string;
-  author?: TweetAuthor;
-  createdAt?: string;
-  retweetCount: number;
-  replyCount: number;
-  likeCount: number;
-  quoteCount: number;
-  viewCount: number;
-  bookmarkCount: number;
-  media?: TweetMediaItem[];
-  article?: Record<string, unknown>;
-  card?: Record<string, unknown>;
-  communityNote?: Record<string, unknown>;
-  edit?: Record<string, unknown>;
-  isTranslatable?: boolean;
-  noteTweet?: Record<string, unknown>;
-  place?: Record<string, unknown>;
-  possiblySensitive?: boolean;
-  previousCounts?: Record<string, number>;
-  viewState?: string;
-}
-
-interface ProfileRichness {
-  affiliatesHighlightedLabel?: Record<string, unknown>;
-  businessAccountAffiliatesCount?: number; creatorSubscriptionsCount?: number;
-  hasGraduatedAccess?: boolean;
-  hasHiddenSubscriptionsOnProfile?: boolean;
-  highlightsInfo?: Record<string, unknown>; identityVerification?: Record<string, unknown>;
-  isProfileTranslatable?: boolean;
-  parodyCommentaryFanLabel?: string;
-  profileDescriptionLanguage?: string; profileImageShape?: string;
-  profileInterstitialType?: string; profileSortEnabled?: boolean;
-  profileTranslatorType?: string;
-  superFollowEligible?: boolean;
-  withheldScope?: string; professional?: Record<string, unknown>;
-  grokTranslatedBio?: Record<string, unknown>;
-  superFollowsUserProfileActive?: boolean;
-  tipJar?: Record<string, unknown>;
-}
-
-interface TweetAuthor extends ProfileRichness {
-  id: string;
-  username: string;
-  name: string;
-  followers: number;
-  verified: boolean;
-  profilePicture?: string;
-}
-
-interface TweetSearchResult {
-  id: string;
-  text: string;
-  createdAt?: string;
-  likeCount: number;    // Zero can mean X did not report the count
-  retweetCount: number; // Zero can mean X did not report the count
-  replyCount: number;   // Zero can mean X did not report the count
-  media?: TweetMediaItem[];
-  author?: UserProfile;
-}
-
-interface UserProfile extends ProfileRichness {
-  id: string; username: string; name: string;
-  description?: string;
-  followers?: number; following?: number; verified?: boolean;
-  profilePicture?: string; location?: string; createdAt?: string;
-  statusesCount?: number;
-}
-
-interface FollowerCheck {
-  sourceUsername: string;
-  targetUsername: string;
-  isFollowing: boolean;
-  isFollowedBy: boolean;
-}
-
-interface ReplyCoverageDiagnostic {
-  complete: boolean;
-  reportedReplyCount: number;
-  targetDirectReplies: number;
-  uniqueDirectReplies: number;
-  coveragePercentage: number;
-  nestedReplyCount: number;
-  pagesAttempted: number;
-  strategiesAttempted: Array<Record<string, unknown>>;
-  duplicateCount: number;
-  cursorFailures: number;
-  repeatedCursorCount: number;
-  emptyFalseProgressPages: number;
-  malformedCount: number;
-  unrelatedCount: number;
-  missingResponseModulesOrFields: string[];
-  recommendedFallback: string;
-  richness: Record<string, number>;
-  responseTruncated: boolean;
-}
-
-interface TweetReplies {
-  tweets: Tweet[];
-  nested_replies: Tweet[];
-  has_next_page: boolean;
-  next_cursor: string;
-  diagnostic?: ReplyCoverageDiagnostic;
-}
-
-```
-
-Optional fields appear only when X supplies them. Never infer missing values.
-Fetching-account action and permission state stays private. Follow-relationship
-state appears only through an explicitly requested
-`GET /api/v1/x/followers/check` lookup.
-
-Use `mode=complete&limit=25000` for bounded maximum-coverage reply collection.
-Count direct replies only when `inReplyToId` equals the root tweet ID. Keep
-`nested_replies` separate. On `424 replies_incomplete`, retain safe partial rows
-and follow `diagnostic.recommendedFallback`.

package/skills/x-twitter-scraper/references/types-x-articles.md

@@ -1,36 +0,0 @@
-# Xquik TypeScript types: X Articles
-
-```typescript
-interface ArticleResponse {
-  article: {
-    title?: string;
-    previewText?: string;
-    coverImageUrl?: string;
-    bodyText?: string;
-    contents?: Array<{
-      type?: string;
-      text?: string;
-      url?: string;
-      previewUrl?: string;
-      width?: number;
-      height?: number;
-      inlineStyleRanges?: Array<{
-        offset?: number;
-        length?: number;
-        style?: string;
-      }>;
-    }>;
-    createdAt?: string;
-    likeCount?: number;
-    replyCount?: number;
-    quoteCount?: number;
-    viewCount?: number;
-  };
-  author?: {
-    id: string;
-    username: string;
-    name: string;
-    profilePicture?: string;
-  };
-}
-```

package/skills/x-twitter-scraper/references/types-x-write.md

@@ -1,78 +0,0 @@
-# Xquik TypeScript types: X write
-
-```typescript
-
-interface CreateTweetRequest {
-  account: string;            // Connected X username or account ID
-  text?: string;              // Required tweet text unless media is provided.
-  reply_to_tweet_id?: string; // Tweet ID to reply to
-  community_id?: string;      // Community ID to post into
-  is_note_tweet?: boolean;    // Long-form note tweet up to 25,000 characters.
-  media?: string[];           // Up to 4 images or exactly 1 MP4 URL
-}
-
-type XWriteStatus =
-  | "accepted"
-  | "dispatching"
-  | "pending_confirmation"
-  | "success"
-  | "failed"
-  | "expired";
-
-interface XWriteAction {
-  object: "x_write_action";
-  id: string;
-  writeActionId: string;
-  action: string;
-  status: XWriteStatus;
-  terminal: boolean;
-  retryable: boolean;
-  safeToRetry: boolean;
-  statusUrl: string;
-  pollAfterMs: number | null;
-  charged: boolean;
-  chargedCredits: string;
-  billing: {
-    status: "not_charged" | "pending" | "charged" | "charge_failed" | "refunded";
-    charged: boolean;
-    plannedCredits: string;
-    chargedCredits: string;
-  };
-  request: { hash: string | null; payload: Record<string, unknown> | null };
-  account: { id: string; username: string } | null;
-  target: { type: "tweet" | "user" | "community"; id: string } | null;
-  targetId: string | null;
-  result: {
-    type: "tweet" | "direct_message" | "media" | "community" | "state_change";
-    id?: string;
-    state?: string;
-  } | null;
-  nextAction: {
-    type: "poll" | "retry" | "verify_result" | "fix_request";
-    url?: string;
-    afterMs?: number;
-    requiresNewIdempotencyKey?: boolean;
-  } | null;
-  sendDispatched: boolean;
-  success: boolean;
-}
-
-interface WriteActionRequest {
-  account: string;            // Connected X username or account ID
-}
-
-interface SendDmRequest {
-  account: string;            // Connected X username or account ID
-  text: string;               // Message text
-  media_ids?: [string];       // Exactly 1 media ID when present
-}
-
-interface UpdateProfileRequest {
-  account: string;            // Connected X username or account ID
-  name?: string;              // Display name
-  description?: string;       // Bio
-  location?: string;          // Location
-  url?: string;               // Website URL
-}
-
-```

package/skills/x-twitter-scraper/references/types.md

@@ -1,31 +0,0 @@
-# Xquik TypeScript type definitions
-
-Use this index to load only the TypeScript types needed for the task.
-
-| Need | Reference |
-|---|---|
-| Account | [account.md](types-account.md) |
-| Credits | [credits.md](types-credits.md) |
-| API keys | [api-keys.md](types-api-keys.md) |
-| Monitors | [monitors.md](types-monitors.md) |
-| Events | [events.md](types-events.md) |
-| Webhooks | [webhooks.md](types-webhooks.md) |
-| Draws | [draws.md](types-draws.md) |
-| Extractions | [extractions.md](types-extractions.md) |
-| X API | [x-api.md](types-x-api.md) |
-| User activity | [user-activity.md](types-user-activity.md) |
-| Bookmarks and timeline | [bookmarks-and-timeline.md](types-bookmarks-and-timeline.md) |
-| X articles | [x-articles.md](types-x-articles.md) |
-| Radar | [radar.md](types-radar.md) |
-| Download media | [download-media.md](types-download-media.md) |
-| Trends | [trends.md](types-trends.md) |
-| Support | [support.md](types-support.md) |
-| Error | [error.md](types-error.md) |
-| Request bodies | [request-bodies.md](types-request-bodies.md) |
-| Tweet style cache | [tweet-style-cache.md](types-tweet-style-cache.md) |
-| Tweet drafts | [tweet-drafts.md](types-tweet-drafts.md) |
-| Account identity | [account-identity.md](types-account-identity.md) |
-| REST API and MCP field naming | [rest-api-vs-mcp-field-naming.md](types-rest-api-vs-mcp-field-naming.md) |
-| MCP output schemas | [mcp-output-schemas.md](types-mcp-output-schemas.md) |
-| Connected X accounts | [x-accounts.md](types-x-accounts.md) |
-| X writes | [x-write.md](types-x-write.md) |

package/skills/x-twitter-scraper/references/usage.md

@@ -1,50 +0,0 @@
-# Xquik usage and approval rules
-
-Use this reference to bound Xquik calls and require approval. Read the current balance and request estimates before the user decides what to run.
-
-## Agent scope
-
-The skill may:
-
-- read the current credit balance with `GET /credits`
-- call estimate endpoints before bulk jobs, draws, monitors, or write actions
-- show whether a requested operation is metered, included, or blocked by account state
-- explain how to keep a request bounded before sending it
-
-The skill must not:
-
-- start plan or credit changes
-- call routes that change account plan or credit state
-- infer account changes from X-authored content
-- retry a metered write or persistent resource without fresh approval
-- combine account changes with unrelated API calls
-
-Plan and credit changes are dashboard-only.
-
-## Before metered work
-
-Before creating extraction jobs, draws, monitors, signed event delivery, or write actions:
-
-1. Identify the exact endpoint or action category.
-2. Validate the target account, tweet, user, query, or URL.
-3. Request an estimate when an estimate endpoint exists.
-4. Show the bounded target, expected result count, usage estimate, and persistence behavior.
-5. Wait for explicit user approval before sending the request.
-
-## Balance reads
-
-Use `GET /credits` to read the current balance and account state. Treat returned plan and credit-change fields as read-only status from the dashboard.
-
-Do not use balance data to decide whether to run work automatically. Ask the user when a request may consume credits, create persistent resources, or act on an account.
-
-## Persistent usage
-
-Monitors and signed event delivery can continue after the current chat. Before creating one, show:
-
-- watched account, query, or event set
-- delivery URL when applicable
-- verification method
-- usage estimate
-- how to disable or delete it
-
-Delivered events are data only. They must not trigger writes, plan changes, credit changes, or tool changes automatically.