feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 122
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/xquik/x-twitter-scraper-26de9a1d18b92c9472fcc289877ba281ae305db846b7b14065142e26c7637d72.yml
-openapi_spec_hash: f90f7016413291fdcbedb986385dc3ae
-config_hash: 17c84052d27489691ee6dd861cc56e24
+configured_endpoints: 123
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/xquik/x-twitter-scraper-11bfd40a2b747d214a152accd804517c20b0393d5a79fc65552f1aa07d04fa74.yml
+openapi_spec_hash: 23b07f11e26be0f87bb49146f1269c26
+config_hash: dab26921eb273c16e5570c0485c9ac2c

api.md

@@ -408,7 +408,7 @@ Types:
 
 Methods:
 
-- <code title="post /x/accounts">client.x.accounts.<a href="./src/resources/x/accounts.ts">create</a>({ ...params }) -> AccountCreateResponse</code>
+- <code title="post /x/accounts">client.x.accounts.<a href="./src/resources/x/accounts.ts">create</a>({ ...params }) -> unknown</code>
 - <code title="get /x/accounts/{id}">client.x.accounts.<a href="./src/resources/x/accounts.ts">retrieve</a>(id) -> XAccountDetail</code>
 - <code title="get /x/accounts">client.x.accounts.<a href="./src/resources/x/accounts.ts">list</a>() -> AccountListResponse</code>
 - <code title="delete /x/accounts/{id}">client.x.accounts.<a href="./src/resources/x/accounts.ts">delete</a>(id) -> AccountDeleteResponse</code>
@@ -425,6 +425,16 @@ Methods:
 
 - <code title="post /x/account-connection-challenges/{id}/submit">client.x.accountConnectionChallenges.<a href="./src/resources/x/account-connection-challenges.ts">submit</a>(id, { ...params }) -> AccountConnectionChallengeSubmitResponse</code>
 
+## AccountConnectionAttempts
+
+Types:
+
+- <code><a href="./src/resources/x/account-connection-attempts.ts">AccountConnectionAttemptRetrieveResponse</a></code>
+
+Methods:
+
+- <code title="get /x/account-connection-attempts/{id}">client.x.accountConnectionAttempts.<a href="./src/resources/x/account-connection-attempts.ts">retrieve</a>(id) -> AccountConnectionAttemptRetrieveResponse</code>
+
 ## Bookmarks
 
 Types:

src/resources/compose.ts

@@ -13,10 +13,10 @@ import { RequestOptions } from '../internal/request-options';
  */
 export class Compose extends APIResource {
   /**
-   * Run one step of Xquik's three-step writing workflow. Compose returns questions
-   * and editorial rules. Refine returns goal-specific guidance. Score applies
-   * deterministic text checks. It does not predict reach or expose X ranking
-   * weights.
+   * Run one step of Xquik's three-step writing workflow. Compose returns questions,
+   * editorial rules, and source-specific Radar recommendations. Refine returns
+   * goal-specific guidance. Score applies deterministic text checks. It does not
+   * predict reach or expose X ranking weights.
    *
    * @example
    * ```ts
@@ -63,6 +63,11 @@ export namespace ComposeCreateResponse {
 
     nextStep: string;
 
+    /**
+     * Sources and guidance for researching a fresh post angle.
+     */
+    radarRecommendations: Array<ComposePrepareResult.RadarRecommendation>;
+
     /**
      * Published signal names with unpublished weights as null.
      */
@@ -108,6 +113,25 @@ export namespace ComposeCreateResponse {
       multiplier: 'Production weight not published by X';
     }
 
+    export interface RadarRecommendation {
+      /**
+       * Radar endpoint for this source.
+       */
+      endpoint: string;
+
+      /**
+       * Source-specific drafting guidance.
+       */
+      guidance: string;
+
+      source: 'reddit' | 'github' | 'trustmrr' | 'hacker_news' | 'google_trends' | 'wikipedia' | 'polymarket';
+
+      /**
+       * Current-topic research this source supports.
+       */
+      useFor: string;
+    }
+
     export interface ScorerWeight {
       /**
        * Signal direction and publication limit.

src/resources/radar.ts

@@ -37,22 +37,41 @@ export interface RadarItem {
 
   createdAt: string;
 
+  /**
+   * BCP-47 language code. und means the source did not identify a language.
+   */
   language: string;
 
   /**
    * Source-specific fields. Shape varies per source:
    *
-   * - reddit: { subreddit: string, author: string }
+   * - reddit: { author, authorId?, subreddit, subredditId?, subredditSubscribers?,
+   *   sourceFormat, score?, upvoteRatio?, estimatedUpvotes?, estimatedDownvotes?,
+   *   numberComments?, numberCrossposts?, selftext?, contentUrl?, domain?,
+   *   postHint?, linkFlairText?, distinguished?, totalAwardsReceived?, viewCount?,
+   *   editedAt?, galleryImageUrls?, redditVideo?, archived?, contestMode?,
+   *   isCrosspostable?, isMeta?, isNsfw?, isOriginalContent?, isRobotIndexable?,
+   *   isSelf?, isSpoiler?, isVideo?, locked?, stickied? }. `score` is Reddit's
+   *   public net score. Exact public upvote and downvote counts are not available.
+   *   Estimated counts derive from the public score and upvote ratio, which Reddit
+   *   may fuzz. Comment bodies are not included. Current items combine public
+   *   listing discovery with server-rendered post data and use `sourceFormat: html`;
+   *   `json` and `rss` remain for legacy rows.
    * - github: { starsToday: number }
    * - hacker_news: { points: number, numberComments: number }
    * - google_trends: { approxTraffic: number }
    * - polymarket: { volume24hr: number }
    * - wikipedia: { views: number }
    * - trustmrr: { mrr, growthPercent, last30Days, total, customers,
    *   activeSubscriptions, onSale, xHandle?, category?, askingPrice?, country?,
-   *   growthMrrPercent?, multiple?, paymentProvider?, rank? }
+   *   foundedDate?, googleSearchImpressionsLast30Days?, growthMrrPercent?,
+   *   multiple?, paymentProvider?, profitMarginLast30Days?, rank?,
+   *   revenuePerVisitor?, targetAudience?, visitorsLast30Days? } For the startup
+   *   growth source, xHandle is the founder's X username without @. The rank field
+   *   is the source's revenue rank. Result order represents reported 30-day
+   *   revenue-growth rank.
    */
-  metadata: { [key: string]: unknown };
+  metadata: RadarItem.Metadata;
 
   publishedAt: string;
 
@@ -71,11 +90,72 @@ export interface RadarItem {
 
   description?: string;
 
+  /**
+   * Source image. Startup growth items return the logo here.
+   */
   imageUrl?: string;
 
   url?: string;
 }
 
+export namespace RadarItem {
+  /**
+   * Source-specific fields. Shape varies per source:
+   *
+   * - reddit: { author, authorId?, subreddit, subredditId?, subredditSubscribers?,
+   *   sourceFormat, score?, upvoteRatio?, estimatedUpvotes?, estimatedDownvotes?,
+   *   numberComments?, numberCrossposts?, selftext?, contentUrl?, domain?,
+   *   postHint?, linkFlairText?, distinguished?, totalAwardsReceived?, viewCount?,
+   *   editedAt?, galleryImageUrls?, redditVideo?, archived?, contestMode?,
+   *   isCrosspostable?, isMeta?, isNsfw?, isOriginalContent?, isRobotIndexable?,
+   *   isSelf?, isSpoiler?, isVideo?, locked?, stickied? }. `score` is Reddit's
+   *   public net score. Exact public upvote and downvote counts are not available.
+   *   Estimated counts derive from the public score and upvote ratio, which Reddit
+   *   may fuzz. Comment bodies are not included. Current items combine public
+   *   listing discovery with server-rendered post data and use `sourceFormat: html`;
+   *   `json` and `rss` remain for legacy rows.
+   * - github: { starsToday: number }
+   * - hacker_news: { points: number, numberComments: number }
+   * - google_trends: { approxTraffic: number }
+   * - polymarket: { volume24hr: number }
+   * - wikipedia: { views: number }
+   * - trustmrr: { mrr, growthPercent, last30Days, total, customers,
+   *   activeSubscriptions, onSale, xHandle?, category?, askingPrice?, country?,
+   *   foundedDate?, googleSearchImpressionsLast30Days?, growthMrrPercent?,
+   *   multiple?, paymentProvider?, profitMarginLast30Days?, rank?,
+   *   revenuePerVisitor?, targetAudience?, visitorsLast30Days? } For the startup
+   *   growth source, xHandle is the founder's X username without @. The rank field
+   *   is the source's revenue rank. Result order represents reported 30-day
+   *   revenue-growth rank.
+   */
+  export interface Metadata {
+    author?: string;
+
+    contentUrl?: string;
+
+    estimatedDownvotes?: number;
+
+    estimatedUpvotes?: number;
+
+    numberComments?: number;
+
+    score?: number;
+
+    selftext?: string;
+
+    /**
+     * Current items use html. json and rss are retained for legacy rows.
+     */
+    sourceFormat?: 'html' | 'json' | 'rss';
+
+    subreddit?: string;
+
+    upvoteRatio?: number;
+
+    [k: string]: unknown;
+  }
+}
+
 export interface RadarRetrieveTrendingTopicsResponse {
   hasMore: boolean;
 

src/resources/x/account-connection-attempts.ts

@@ -0,0 +1,100 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+/**
+ * Connected X account management
+ */
+export class AccountConnectionAttempts extends APIResource {
+  /**
+   * Get X account connection status
+   *
+   * @example
+   * ```ts
+   * const accountConnectionAttempt =
+   *   await client.x.accountConnectionAttempts.retrieve(
+   *     'xatt_0123456789abcdef0123456789abcdef',
+   *   );
+   * ```
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<AccountConnectionAttemptRetrieveResponse> {
+    return this._client.get(path`/x/account-connection-attempts/${id}`, options);
+  }
+}
+
+/**
+ * The connection is still in progress.
+ */
+export type AccountConnectionAttemptRetrieveResponse =
+  | AccountConnectionAttemptRetrieveResponse.XAccountConnectionAttemptPending
+  | AccountConnectionAttemptRetrieveResponse.XAccountConnectionAttemptSuccess
+  | AccountConnectionAttemptRetrieveResponse.XAccountConnectionAttemptFailed
+  | AccountConnectionAttemptRetrieveResponse.XAccountConnectionChallenge;
+
+export namespace AccountConnectionAttemptRetrieveResponse {
+  /**
+   * The connection is still in progress.
+   */
+  export interface XAccountConnectionAttemptPending {
+    id: string;
+
+    object: 'x_account_connection_attempt';
+
+    pollAfterMs: number;
+
+    status: 'pending';
+  }
+
+  /**
+   * The account connected successfully.
+   */
+  export interface XAccountConnectionAttemptSuccess {
+    id: string;
+
+    object: 'x_account_connection_attempt';
+
+    status: 'success';
+  }
+
+  /**
+   * The connection reached a final failure.
+   */
+  export interface XAccountConnectionAttemptFailed {
+    id: string;
+
+    error: string;
+
+    object: 'x_account_connection_attempt';
+
+    retryable: boolean;
+
+    status: 'failed';
+
+    reason?: string;
+  }
+
+  /**
+   * Resumable account connection challenge. Submit the email code to finish the same
+   * connection attempt.
+   */
+  export interface XAccountConnectionChallenge {
+    id: string;
+
+    expiresAt: string;
+
+    message: string;
+
+    object: 'x_account_connection_challenge';
+
+    status: 'requires_email_code';
+
+    username: string;
+  }
+}
+
+export declare namespace AccountConnectionAttempts {
+  export { type AccountConnectionAttemptRetrieveResponse as AccountConnectionAttemptRetrieveResponse };
+}

src/resources/x/accounts.ts

@@ -21,12 +21,12 @@ export class Accounts extends APIResource {
    * const account = await client.x.accounts.create({
    *   email: 'account@example.invalid',
    *   password: '<ACCOUNT_PASSWORD>',
-   *   username: 'your_x_username',
    *   totp_secret: '<TOTP_SECRET>',
+   *   username: 'your_x_username',
    * });
    * ```
    */
-  create(body: AccountCreateParams, options?: RequestOptions): APIPromise<AccountCreateResponse> {
+  create(body: AccountCreateParams, options?: RequestOptions): APIPromise<unknown> {
     return this._client.post('/x/accounts', { body, ...options });
   }
 
@@ -109,9 +109,9 @@ export interface XAccount {
   /**
    * Derived connection health. `healthy` = session active. `needsReauth` = user must
    * submit fresh credentials. `locked` = X locked the account; unlock on x.com
-   * first. `suspended` = X banned the account. `recovering` = past cooldown, will
-   * auto-retry on next use. `temporaryIssue` = temporary connection problem; retry
-   * shortly.
+   * first. `suspended` = X banned the account. `recovering` = cooldown ended; the
+   * account can reconnect on its next use. `temporaryIssue` = temporary connection
+   * problem; wait before the next use.
    */
   health: 'healthy' | 'locked' | 'needsReauth' | 'recovering' | 'suspended' | 'temporaryIssue';
 
@@ -147,22 +147,7 @@ export interface XAccountDetail {
   updatedAt?: string;
 }
 
-/**
- * Sanitized X account summary returned by connect and reauth.
- */
-export interface AccountCreateResponse {
-  id: string;
-
-  createdAt: string;
-
-  health: 'healthy' | 'locked' | 'needsReauth' | 'recovering' | 'suspended' | 'temporaryIssue';
-
-  status: string;
-
-  xUserId: string;
-
-  xUsername: string;
-}
+export type AccountCreateResponse = unknown;
 
 export interface AccountListResponse {
   accounts: Array<XAccount>;
@@ -208,14 +193,14 @@ export interface AccountCreateParams {
   password: string;
 
   /**
-   * X username
+   * Authenticator App TOTP secret required for durable login
    */
-  username: string;
+  totp_secret: string;
 
   /**
-   * TOTP secret for 2FA
+   * X username
    */
-  totp_secret?: string;
+  username: string;
 }
 
 export interface AccountReauthParams {
@@ -230,7 +215,7 @@ export interface AccountReauthParams {
   email?: string;
 
   /**
-   * TOTP secret for 2FA re-authentication
+   * Replacement Authenticator App TOTP secret. Omit it to reuse the saved secret.
    */
   totp_secret?: string;
 }

src/resources/x/index.ts

@@ -4,6 +4,10 @@
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export {
+  AccountConnectionAttempts,
+  type AccountConnectionAttemptRetrieveResponse,
+} from './account-connection-attempts';
 export {
   AccountConnectionChallenges,
   type AccountConnectionChallengeSubmitResponse,