@hidden-leaf/x-skill 1.0.0

package/dist/clients/types.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * X API v2 types for @hidden-leaf/x-skill
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XNotFoundError = exports.XRateLimitError = exports.XAuthenticationError = exports.XApiRequestError = exports.DEFAULT_EXPANSIONS = exports.DEFAULT_USER_FIELDS = exports.DEFAULT_TWEET_FIELDS = void 0;
+// ============================================================================
+// Request Params
+// ============================================================================
+/** Standard tweet fields to request */
+exports.DEFAULT_TWEET_FIELDS = [
+    'author_id',
+    'created_at',
+    'conversation_id',
+    'entities',
+    'public_metrics',
+    'referenced_tweets',
+    'context_annotations',
+    'lang',
+    'note_tweet',
+];
+/** Standard user fields to request */
+exports.DEFAULT_USER_FIELDS = [
+    'name',
+    'username',
+    'description',
+    'profile_image_url',
+    'verified',
+    'public_metrics',
+    'created_at',
+];
+/** Standard expansions for bookmark/tweet endpoints */
+exports.DEFAULT_EXPANSIONS = [
+    'author_id',
+    'referenced_tweets.id',
+    'attachments.media_keys',
+];
+// ============================================================================
+// Errors
+// ============================================================================
+class XApiRequestError extends Error {
+    status;
+    code;
+    rateLimit;
+    constructor(message, status, code, rateLimit) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.rateLimit = rateLimit;
+        this.name = 'XApiRequestError';
+    }
+}
+exports.XApiRequestError = XApiRequestError;
+class XAuthenticationError extends XApiRequestError {
+    constructor(message = 'X API authentication failed — check your Bearer token') {
+        super(message, 401, 'AUTHENTICATION_ERROR');
+        this.name = 'XAuthenticationError';
+    }
+}
+exports.XAuthenticationError = XAuthenticationError;
+class XRateLimitError extends XApiRequestError {
+    retryAfter;
+    constructor(retryAfter, rateLimit) {
+        super(`X API rate limit exceeded — retry after ${retryAfter}s`, 429, 'RATE_LIMIT', rateLimit);
+        this.retryAfter = retryAfter;
+        this.name = 'XRateLimitError';
+    }
+}
+exports.XRateLimitError = XRateLimitError;
+class XNotFoundError extends XApiRequestError {
+    constructor(message = 'X API resource not found') {
+        super(message, 404, 'NOT_FOUND');
+        this.name = 'XNotFoundError';
+    }
+}
+exports.XNotFoundError = XNotFoundError;
+//# sourceMappingURL=types.js.map

package/dist/clients/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/clients/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA4MH,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,uCAAuC;AAC1B,QAAA,oBAAoB,GAAG;IAClC,WAAW;IACX,YAAY;IACZ,iBAAiB;IACjB,UAAU;IACV,gBAAgB;IAChB,mBAAmB;IACnB,qBAAqB;IACrB,MAAM;IACN,YAAY;CACJ,CAAC;AAEX,sCAAsC;AACzB,QAAA,mBAAmB,GAAG;IACjC,MAAM;IACN,UAAU;IACV,aAAa;IACb,mBAAmB;IACnB,UAAU;IACV,gBAAgB;IAChB,YAAY;CACJ,CAAC;AAEX,uDAAuD;AAC1C,QAAA,kBAAkB,GAAG;IAChC,WAAW;IACX,sBAAsB;IACtB,wBAAwB;CAChB,CAAC;AA2BX,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,MAAa,gBAAiB,SAAQ,KAAK;IAGvB;IACA;IACA;IAJlB,YACE,OAAe,EACC,MAAc,EACd,IAAa,EACb,SAIf;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QARC,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAS;QACb,cAAS,GAAT,SAAS,CAIxB;QAGD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAdD,4CAcC;AAED,MAAa,oBAAqB,SAAQ,gBAAgB;IACxD,YAAY,OAAO,GAAG,uDAAuD;QAC3E,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,sBAAsB,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AALD,oDAKC;AAED,MAAa,eAAgB,SAAQ,gBAAgB;IAEjC;IADlB,YACkB,UAAkB,EAClC,SAA6D;QAE7D,KAAK,CAAC,2CAA2C,UAAU,GAAG,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;QAH9E,eAAU,GAAV,UAAU,CAAQ;QAIlC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AARD,0CAQC;AAED,MAAa,cAAe,SAAQ,gBAAgB;IAClD,YAAY,OAAO,GAAG,0BAA0B;QAC9C,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AALD,wCAKC"}

package/dist/clients/x-client.d.ts

@@ -0,0 +1,111 @@
+/**
+ * X API v2 client with OAuth 2.0 User Context auth.
+ *
+ * Bookmarks require User Context (not App-only Bearer token).
+ * Uses pay-per-use pricing (launched Feb 2026).
+ * Deduplication: same post requested within a 24h UTC window = single charge.
+ */
+import { XAuthConfig, XClientOptions, XApiResponse, Tweet, User, BookmarkFolder, BookmarkListParams, BookmarkFolderListParams } from './types.js';
+export declare class XClient {
+    private readonly http;
+    private readonly userId;
+    private refreshToken?;
+    private readonly consumerKey?;
+    private readonly consumerSecret?;
+    private isRefreshing;
+    constructor(auth: XAuthConfig, options?: XClientOptions);
+    private canRefresh;
+    /**
+     * Exchange refresh token for a new access token.
+     * Updates .env file with new tokens so they persist across runs.
+     */
+    private refreshAccessToken;
+    /**
+     * Update .env file with new token values.
+     * Preserves all other env vars and comments.
+     */
+    private updateEnvFile;
+    /**
+     * Get all bookmarked tweets for the authenticated user.
+     * Endpoint: GET /2/users/:id/bookmarks
+     * Requires OAuth 2.0 User Context with bookmark.read scope.
+     */
+    getBookmarks(params?: BookmarkListParams): Promise<XApiResponse<Tweet[]>>;
+    /**
+     * Get all bookmarked tweets, auto-paginating through all pages.
+     * Caution: each page is a separate API call (pay-per-use charge).
+     */
+    getAllBookmarks(params?: Omit<BookmarkListParams, 'pagination_token'>): Promise<{
+        tweets: Tweet[];
+        users: Map<string, User>;
+    }>;
+    /**
+     * List bookmark folders for the authenticated user.
+     * Endpoint: GET /2/users/:id/bookmark_folders
+     */
+    getBookmarkFolders(params?: BookmarkFolderListParams): Promise<XApiResponse<BookmarkFolder[]>>;
+    /**
+     * Get all bookmark folders, auto-paginating.
+     */
+    getAllBookmarkFolders(): Promise<BookmarkFolder[]>;
+    /**
+     * Get tweet IDs from a specific bookmark folder.
+     * Endpoint: GET /2/users/:id/bookmarks/folders/:folder_id
+     * Note: This endpoint only returns tweet IDs — no text, metrics, or expansions.
+     * Use getAllBookmarks() for full tweet data, then cross-reference by ID.
+     */
+    getBookmarkFolderTweetIds(folderId: string): Promise<string[]>;
+    /**
+     * Get full bookmark data with folder membership resolved.
+     *
+     * Strategy:
+     *   1. Fetch all folders (cheap — just names/IDs)
+     *   2. Fetch tweet IDs per folder (cheap — just IDs)
+     *   3. Fetch all bookmarks with full data from main endpoint (one paginated call)
+     *   4. Cross-reference to build folder→tweet mappings
+     *
+     * This minimizes API cost while getting complete data.
+     */
+    getBookmarksWithFolders(): Promise<{
+        tweets: Tweet[];
+        users: Map<string, User>;
+        folders: BookmarkFolder[];
+        folderTweetIds: Map<string, string[]>;
+    }>;
+    /**
+     * Look up tweets by ID with full data.
+     * Endpoint: GET /2/tweets?ids=...
+     * Accepts up to 100 IDs per call.
+     */
+    getTweetsByIds(ids: string[]): Promise<{
+        tweets: Tweet[];
+        users: Map<string, User>;
+    }>;
+    /**
+     * Get the authenticated user's profile.
+     * Endpoint: GET /2/users/me
+     */
+    getMe(): Promise<XApiResponse<User>>;
+    private parseRateLimit;
+}
+/**
+ * Create an XClient from environment variables.
+ *
+ * Required env vars:
+ *   X_USER_ACCESS_TOKEN — OAuth 2.0 User Access Token (from OAuth flow)
+ *   X_USER_ID           — Authenticated user's numeric ID
+ *
+ * Auto-refresh env vars (optional but recommended):
+ *   X_REFRESH_TOKEN   — Refresh token for auto-refreshing expired access tokens
+ *   X_CONSUMER_KEY    — App consumer key (client ID)
+ *   X_CONSUMER_SECRET — App consumer secret
+ *
+ * If all three refresh vars are set, the client will automatically refresh
+ * the access token on 401 and update .env with new tokens.
+ *
+ * Optional env vars:
+ *   X_MAX_RETRIES  — Max retries on 5xx (default: 3)
+ *   X_TIMEOUT      — Request timeout in ms (default: 30000)
+ */
+export declare function createXClientFromEnv(options?: XClientOptions): XClient;
+//# sourceMappingURL=x-client.d.ts.map

package/dist/clients/x-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x-client.d.ts","sourceRoot":"","sources":["../../src/clients/x-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EACL,WAAW,EACX,cAAc,EACd,YAAY,EAKZ,KAAK,EACL,IAAI,EACJ,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EAIzB,MAAM,YAAY,CAAC;AAOpB,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAS;IACzC,OAAO,CAAC,YAAY,CAAS;gBAEjB,IAAI,EAAE,WAAW,EAAE,OAAO,GAAE,cAAmB;IAgG3D,OAAO,CAAC,UAAU;IAIlB;;;OAGG;YACW,kBAAkB;IAuChC;;;OAGG;IACH,OAAO,CAAC,aAAa;IAgCrB;;;;OAIG;IACG,YAAY,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC;IAsBnF;;;OAGG;IACG,eAAe,CAAC,MAAM,GAAE,IAAI,CAAC,kBAAkB,EAAE,kBAAkB,CAAM,GAAG,OAAO,CAAC;QACxF,MAAM,EAAE,KAAK,EAAE,CAAC;QAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;KAC1B,CAAC;IA0BF;;;OAGG;IACG,kBAAkB,CAAC,MAAM,GAAE,wBAA6B,GAAG,OAAO,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC,CAAC;IAWxG;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAmBxD;;;;;OAKG;IACG,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwBpE;;;;;;;;;;OAUG;IACG,uBAAuB,IAAI,OAAO,CAAC;QACvC,MAAM,EAAE,KAAK,EAAE,CAAC;QAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACzB,OAAO,EAAE,cAAc,EAAE,CAAC;QAC1B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;KACvC,CAAC;IAqBF;;;;OAIG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;KAAE,CAAC;IAmC3F;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAc1C,OAAO,CAAC,cAAc;CASvB;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CA6B1E"}

package/dist/clients/x-client.js

@@ -0,0 +1,421 @@
+"use strict";
+/**
+ * X API v2 client with OAuth 2.0 User Context auth.
+ *
+ * Bookmarks require User Context (not App-only Bearer token).
+ * Uses pay-per-use pricing (launched Feb 2026).
+ * Deduplication: same post requested within a 24h UTC window = single charge.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XClient = void 0;
+exports.createXClientFromEnv = createXClientFromEnv;
+const axios_1 = __importDefault(require("axios"));
+const axios_retry_1 = __importDefault(require("axios-retry"));
+const dotenv = __importStar(require("dotenv"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const types_js_1 = require("./types.js");
+dotenv.config();
+const X_API_BASE = 'https://api.x.com/2';
+const TOKEN_URL = 'https://api.x.com/2/oauth2/token';
+class XClient {
+    http;
+    userId;
+    refreshToken;
+    consumerKey;
+    consumerSecret;
+    isRefreshing = false;
+    constructor(auth, options = {}) {
+        const { maxRetries = 3, retryDelay = 1000, timeout = 30000 } = options;
+        this.userId = auth.userId;
+        this.refreshToken = auth.refreshToken;
+        this.consumerKey = auth.consumerKey;
+        this.consumerSecret = auth.consumerSecret;
+        this.http = axios_1.default.create({
+            baseURL: X_API_BASE,
+            timeout,
+            headers: {
+                Authorization: `Bearer ${auth.userAccessToken}`,
+                'Content-Type': 'application/json',
+            },
+        });
+        (0, axios_retry_1.default)(this.http, {
+            retries: maxRetries,
+            retryDelay: (retryCount) => retryCount * retryDelay,
+            retryCondition: (error) => {
+                const status = error.response?.status;
+                // Retry on 5xx and network errors, not on 4xx
+                return !status || status >= 500;
+            },
+        });
+        // Response interceptor: auto-refresh on 401, normalize other errors
+        this.http.interceptors.response.use((response) => response, async (error) => {
+            if (!error.response) {
+                throw new types_js_1.XApiRequestError(`Network error: ${error.message}`, 0, 'NETWORK_ERROR');
+            }
+            const { status, headers } = error.response;
+            const rateLimit = this.parseRateLimit(headers);
+            const originalRequest = error.config;
+            // Auto-refresh on 401 or 403 if we have a refresh token
+            // X returns 403 (not 401) for expired/invalid OAuth user tokens
+            if ((status === 401 || status === 403) && this.canRefresh() && !originalRequest._retried) {
+                originalRequest._retried = true;
+                try {
+                    const newToken = await this.refreshAccessToken();
+                    // Update default header for future requests
+                    this.http.defaults.headers.common['Authorization'] = `Bearer ${newToken}`;
+                    // Update this request's header and retry
+                    originalRequest.headers['Authorization'] = `Bearer ${newToken}`;
+                    return this.http(originalRequest);
+                }
+                catch (refreshError) {
+                    throw new types_js_1.XAuthenticationError('Token refresh failed — run `npx tsx scripts/oauth-flow.ts` to re-authenticate');
+                }
+            }
+            switch (status) {
+                case 401:
+                    throw new types_js_1.XAuthenticationError();
+                case 403:
+                    throw new types_js_1.XApiRequestError('X API forbidden — endpoint may require elevated access or OAuth 2.0 User Context', 403, 'FORBIDDEN', rateLimit);
+                case 404:
+                    throw new types_js_1.XNotFoundError();
+                case 429: {
+                    const resetHeader = headers?.['x-rate-limit-reset'];
+                    const resetEpoch = resetHeader ? Number(resetHeader) : 0;
+                    const retryAfter = Math.max(1, resetEpoch - Math.floor(Date.now() / 1000));
+                    throw new types_js_1.XRateLimitError(retryAfter, rateLimit);
+                }
+                default:
+                    throw new types_js_1.XApiRequestError(`X API error ${status}: ${JSON.stringify(error.response.data)}`, status, undefined, rateLimit);
+            }
+        });
+    }
+    // ==========================================================================
+    // Token Refresh
+    // ==========================================================================
+    canRefresh() {
+        return !this.isRefreshing && !!this.refreshToken && !!this.consumerKey && !!this.consumerSecret;
+    }
+    /**
+     * Exchange refresh token for a new access token.
+     * Updates .env file with new tokens so they persist across runs.
+     */
+    async refreshAccessToken() {
+        this.isRefreshing = true;
+        try {
+            const basicAuth = Buffer.from(`${this.consumerKey}:${this.consumerSecret}`).toString('base64');
+            const params = new URLSearchParams({
+                grant_type: 'refresh_token',
+                refresh_token: this.refreshToken,
+                client_id: this.consumerKey,
+            });
+            const response = await axios_1.default.post(TOKEN_URL, params.toString(), {
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                    Authorization: `Basic ${basicAuth}`,
+                },
+            });
+            const { access_token, refresh_token: newRefreshToken } = response.data;
+            // Update .env file so new tokens persist
+            this.updateEnvFile(access_token, newRefreshToken);
+            // Update in-memory env vars
+            process.env.X_USER_ACCESS_TOKEN = access_token;
+            if (newRefreshToken) {
+                process.env.X_REFRESH_TOKEN = newRefreshToken;
+                // X uses rotating refresh tokens — the old one is now invalid
+                this.refreshToken = newRefreshToken;
+            }
+            console.info('[@hidden-leaf/x-skill] Access token refreshed successfully');
+            return access_token;
+        }
+        finally {
+            this.isRefreshing = false;
+        }
+    }
+    /**
+     * Update .env file with new token values.
+     * Preserves all other env vars and comments.
+     */
+    updateEnvFile(accessToken, refreshToken) {
+        const envPath = path.resolve(process.cwd(), '.env');
+        try {
+            if (!fs.existsSync(envPath))
+                return;
+            let content = fs.readFileSync(envPath, 'utf8');
+            // Replace access token
+            content = content.replace(/^X_USER_ACCESS_TOKEN=.*/m, `X_USER_ACCESS_TOKEN=${accessToken}`);
+            // Replace refresh token if we got a new one (rotating tokens)
+            if (refreshToken) {
+                content = content.replace(/^X_REFRESH_TOKEN=.*/m, `X_REFRESH_TOKEN=${refreshToken}`);
+            }
+            fs.writeFileSync(envPath, content, 'utf8');
+        }
+        catch {
+            // Non-fatal — tokens still work in memory for this session
+        }
+    }
+    // ==========================================================================
+    // Bookmarks
+    // ==========================================================================
+    /**
+     * Get all bookmarked tweets for the authenticated user.
+     * Endpoint: GET /2/users/:id/bookmarks
+     * Requires OAuth 2.0 User Context with bookmark.read scope.
+     */
+    async getBookmarks(params = {}) {
+        const { max_results = 100, pagination_token, tweet_fields = [...types_js_1.DEFAULT_TWEET_FIELDS], user_fields = [...types_js_1.DEFAULT_USER_FIELDS], expansions = [...types_js_1.DEFAULT_EXPANSIONS], } = params;
+        const response = await this.http.get(`/users/${this.userId}/bookmarks`, {
+            params: {
+                max_results,
+                pagination_token,
+                'tweet.fields': tweet_fields.join(','),
+                'user.fields': user_fields.join(','),
+                expansions: expansions.join(','),
+            },
+        });
+        return response.data;
+    }
+    /**
+     * Get all bookmarked tweets, auto-paginating through all pages.
+     * Caution: each page is a separate API call (pay-per-use charge).
+     */
+    async getAllBookmarks(params = {}) {
+        const tweets = [];
+        const users = new Map();
+        let nextToken;
+        do {
+            const response = await this.getBookmarks({
+                ...params,
+                pagination_token: nextToken,
+            });
+            if (response.data) {
+                tweets.push(...response.data);
+            }
+            if (response.includes?.users) {
+                for (const user of response.includes.users) {
+                    users.set(user.id, user);
+                }
+            }
+            nextToken = response.meta?.next_token;
+        } while (nextToken);
+        return { tweets, users };
+    }
+    /**
+     * List bookmark folders for the authenticated user.
+     * Endpoint: GET /2/users/:id/bookmark_folders
+     */
+    async getBookmarkFolders(params = {}) {
+        const response = await this.http.get(`/users/${this.userId}/bookmarks/folders`, {
+            params: {
+                max_results: params.max_results,
+                pagination_token: params.pagination_token,
+            },
+        });
+        return response.data;
+    }
+    /**
+     * Get all bookmark folders, auto-paginating.
+     */
+    async getAllBookmarkFolders() {
+        const folders = [];
+        let nextToken;
+        do {
+            const response = await this.getBookmarkFolders({
+                pagination_token: nextToken,
+            });
+            if (response.data) {
+                folders.push(...response.data);
+            }
+            nextToken = response.meta?.next_token;
+        } while (nextToken);
+        return folders;
+    }
+    /**
+     * Get tweet IDs from a specific bookmark folder.
+     * Endpoint: GET /2/users/:id/bookmarks/folders/:folder_id
+     * Note: This endpoint only returns tweet IDs — no text, metrics, or expansions.
+     * Use getAllBookmarks() for full tweet data, then cross-reference by ID.
+     */
+    async getBookmarkFolderTweetIds(folderId) {
+        const ids = [];
+        let nextToken;
+        do {
+            const response = await this.http.get(`/users/${this.userId}/bookmarks/folders/${folderId}`, {
+                params: {
+                    ...(nextToken ? { pagination_token: nextToken } : {}),
+                },
+            });
+            const data = response.data;
+            if (data.data) {
+                ids.push(...data.data.map((t) => t.id));
+            }
+            nextToken = data.meta?.next_token;
+        } while (nextToken);
+        return ids;
+    }
+    /**
+     * Get full bookmark data with folder membership resolved.
+     *
+     * Strategy:
+     *   1. Fetch all folders (cheap — just names/IDs)
+     *   2. Fetch tweet IDs per folder (cheap — just IDs)
+     *   3. Fetch all bookmarks with full data from main endpoint (one paginated call)
+     *   4. Cross-reference to build folder→tweet mappings
+     *
+     * This minimizes API cost while getting complete data.
+     */
+    async getBookmarksWithFolders() {
+        // Step 1: Get folders
+        const folders = await this.getAllBookmarkFolders();
+        // Step 2: Get tweet IDs per folder
+        const folderTweetIds = new Map();
+        for (const folder of folders) {
+            const ids = await this.getBookmarkFolderTweetIds(folder.id);
+            folderTweetIds.set(folder.id, ids);
+        }
+        // Step 3: Get all bookmarks with full data
+        const { tweets, users } = await this.getAllBookmarks();
+        return { tweets, users, folders, folderTweetIds };
+    }
+    // ==========================================================================
+    // Tweet Lookup (hydration)
+    // ==========================================================================
+    /**
+     * Look up tweets by ID with full data.
+     * Endpoint: GET /2/tweets?ids=...
+     * Accepts up to 100 IDs per call.
+     */
+    async getTweetsByIds(ids) {
+        const tweets = [];
+        const users = new Map();
+        // Batch in chunks of 100
+        for (let i = 0; i < ids.length; i += 100) {
+            const batch = ids.slice(i, i + 100);
+            const response = await this.http.get('/tweets', {
+                params: {
+                    ids: batch.join(','),
+                    'tweet.fields': [...types_js_1.DEFAULT_TWEET_FIELDS].join(','),
+                    'user.fields': [...types_js_1.DEFAULT_USER_FIELDS].join(','),
+                    expansions: [...types_js_1.DEFAULT_EXPANSIONS].join(','),
+                },
+            });
+            const data = response.data;
+            if (data.data) {
+                tweets.push(...data.data);
+            }
+            if (data.includes?.users) {
+                for (const user of data.includes.users) {
+                    users.set(user.id, user);
+                }
+            }
+        }
+        return { tweets, users };
+    }
+    // ==========================================================================
+    // User Lookup
+    // ==========================================================================
+    /**
+     * Get the authenticated user's profile.
+     * Endpoint: GET /2/users/me
+     */
+    async getMe() {
+        const response = await this.http.get('/users/me', {
+            params: {
+                'user.fields': [...types_js_1.DEFAULT_USER_FIELDS].join(','),
+            },
+        });
+        return response.data;
+    }
+    // ==========================================================================
+    // Utilities
+    // ==========================================================================
+    parseRateLimit(headers) {
+        const limit = Number(headers['x-rate-limit-limit']);
+        const remaining = Number(headers['x-rate-limit-remaining']);
+        const reset = new Date(Number(headers['x-rate-limit-reset']) * 1000);
+        if (isNaN(limit))
+            return undefined;
+        return { limit, remaining, reset };
+    }
+}
+exports.XClient = XClient;
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Create an XClient from environment variables.
+ *
+ * Required env vars:
+ *   X_USER_ACCESS_TOKEN — OAuth 2.0 User Access Token (from OAuth flow)
+ *   X_USER_ID           — Authenticated user's numeric ID
+ *
+ * Auto-refresh env vars (optional but recommended):
+ *   X_REFRESH_TOKEN   — Refresh token for auto-refreshing expired access tokens
+ *   X_CONSUMER_KEY    — App consumer key (client ID)
+ *   X_CONSUMER_SECRET — App consumer secret
+ *
+ * If all three refresh vars are set, the client will automatically refresh
+ * the access token on 401 and update .env with new tokens.
+ *
+ * Optional env vars:
+ *   X_MAX_RETRIES  — Max retries on 5xx (default: 3)
+ *   X_TIMEOUT      — Request timeout in ms (default: 30000)
+ */
+function createXClientFromEnv(options = {}) {
+    const userAccessToken = process.env.X_USER_ACCESS_TOKEN;
+    const userId = process.env.X_USER_ID;
+    if (!userAccessToken) {
+        throw new types_js_1.XAuthenticationError('X_USER_ACCESS_TOKEN not set — run `npx tsx scripts/oauth-flow.ts` to generate one');
+    }
+    if (!userId) {
+        throw new types_js_1.XAuthenticationError('X_USER_ID not set — run `npx tsx scripts/oauth-flow.ts` to get your user ID');
+    }
+    return new XClient({
+        userAccessToken,
+        userId,
+        refreshToken: process.env.X_REFRESH_TOKEN,
+        consumerKey: process.env.X_CONSUMER_KEY,
+        consumerSecret: process.env.X_CONSUMER_SECRET,
+    }, {
+        maxRetries: Number(process.env.X_MAX_RETRIES) || options.maxRetries,
+        timeout: Number(process.env.X_TIMEOUT) || options.timeout,
+        ...options,
+    });
+}
+//# sourceMappingURL=x-client.js.map

package/dist/clients/x-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x-client.js","sourceRoot":"","sources":["../../src/clients/x-client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @hidden-leaf/x-skill
+ *
+ * X (Twitter) bookmark intelligence skill for Claude Code.
+ * Turns curated X bookmarks into structured research briefs.
+ *
+ * v1: Bookmark intelligence (list, fetch, brief)
+ * v2: Search, threads, profile (planned)
+ * v3: Publish, schedule, reply (planned)
+ */
+export { XClient, createXClientFromEnv } from './clients/x-client.js';
+export type { XAuthConfig, XApiResponse, XPaginationMeta, XApiError, XClientOptions, Tweet, TweetPublicMetrics, TweetEntities, TweetUrl, TweetMention, TweetHashtag, TweetAnnotation, ReferencedTweet, TweetAttachments, ContextAnnotation, NoteTweet, User, UserPublicMetrics, Media, XIncludes, BookmarkFolder, BookmarkListParams, BookmarkFolderListParams, BookmarkFolderTweetsParams, } from './clients/types.js';
+export { XApiRequestError, XAuthenticationError, XRateLimitError, XNotFoundError, DEFAULT_TWEET_FIELDS, DEFAULT_USER_FIELDS, DEFAULT_EXPANSIONS, } from './clients/types.js';
+export { BookmarksSkill, createBookmarksSkillFromEnv } from './skills/bookmarks/index.js';
+export { buildBriefPrompt, generateBrief } from './skills/bookmarks/synthesize.js';
+export { BookmarkStore, createStoreFromEnv } from './cache/store.js';
+export type { EnrichedBookmark, BookmarkFolderContents, BriefOptions, ResearchBrief, BookmarkListOutput, BookmarkFetchOutput, BookmarkBriefOutput, SyncResult, } from './skills/bookmarks/types.js';
+export { createLogger } from './utils/logger.js';
+export declare const VERSION = "1.0.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAMtE,YAAY,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,SAAS,EACT,cAAc,EACd,KAAK,EACL,kBAAkB,EAClB,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,IAAI,EACJ,iBAAiB,EACjB,KAAK,EACL,SAAS,EACT,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAMnF,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAMrE,YAAY,EACV,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,GACX,MAAM,6BAA6B,CAAC;AAMrC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMjD,eAAO,MAAM,OAAO,UAAU,CAAC"}