xtrm-tools 0.7.3 → 0.7.7

package/.xtrm/skills/default/last30days/scripts/lib/vendor/bird-search/bird-search.mjs

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+/**
+ * bird-search.mjs - Vendored Bird CLI search wrapper for /last30days.
+ * Subset of @steipete/bird v0.8.0 (MIT License, Peter Steinberger).
+ *
+ * Usage:
+ *   node bird-search.mjs <query> [--count N] [--json]
+ *   node bird-search.mjs --whoami
+ *   node bird-search.mjs --check
+ */
+
+import { resolveCredentials } from './lib/cookies.js';
+import { TwitterClientBase } from './lib/twitter-client-base.js';
+import { withSearch } from './lib/twitter-client-search.js';
+
+// Build a search-only client (no posting, bookmarks, etc.)
+const SearchClient = withSearch(TwitterClientBase);
+
+const args = process.argv.slice(2);
+
+// --check: verify that credentials can be resolved
+if (args.includes('--check')) {
+  try {
+    const { cookies, warnings } = await resolveCredentials({});
+    if (cookies.authToken && cookies.ct0) {
+      process.stdout.write(JSON.stringify({ authenticated: true, source: cookies.source }));
+      process.exit(0);
+    } else {
+      process.stdout.write(JSON.stringify({ authenticated: false, warnings }));
+      process.exit(1);
+    }
+  } catch (err) {
+    process.stdout.write(JSON.stringify({ authenticated: false, error: err.message }));
+    process.exit(1);
+  }
+}
+
+// --whoami: check auth and output source
+if (args.includes('--whoami')) {
+  try {
+    const { cookies } = await resolveCredentials({});
+    if (cookies.authToken && cookies.ct0) {
+      process.stdout.write(cookies.source || 'authenticated');
+      process.exit(0);
+    } else {
+      process.stderr.write('Not authenticated\n');
+      process.exit(1);
+    }
+  } catch (err) {
+    process.stderr.write(`Auth check failed: ${err.message}\n`);
+    process.exit(1);
+  }
+}
+
+// Parse search args
+let query = null;
+let count = 20;
+let jsonOutput = false;
+
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === '--count' && args[i + 1]) {
+    count = parseInt(args[i + 1], 10);
+    i++;
+  } else if (args[i] === '-n' && args[i + 1]) {
+    count = parseInt(args[i + 1], 10);
+    i++;
+  } else if (args[i] === '--json') {
+    jsonOutput = true;
+  } else if (!args[i].startsWith('-')) {
+    query = args[i];
+  }
+}
+
+if (!query) {
+  process.stderr.write('Usage: node bird-search.mjs <query> [--count N] [--json]\n');
+  process.exit(1);
+}
+
+try {
+  // Resolve credentials (env vars, then browser cookies)
+  const { cookies, warnings } = await resolveCredentials({});
+
+  if (!cookies.authToken || !cookies.ct0) {
+    const msg = warnings.length > 0 ? warnings.join('; ') : 'No Twitter credentials found';
+    if (jsonOutput) {
+      process.stdout.write(JSON.stringify({ error: msg, items: [] }));
+    } else {
+      process.stderr.write(`Error: ${msg}\n`);
+    }
+    process.exit(1);
+  }
+
+  // Create search client
+  const client = new SearchClient({
+    cookies: {
+      authToken: cookies.authToken,
+      ct0: cookies.ct0,
+      cookieHeader: cookies.cookieHeader,
+    },
+    timeoutMs: 30000,
+  });
+
+  // Run search
+  const result = await client.search(query, count);
+
+  if (!result.success) {
+    if (jsonOutput) {
+      process.stdout.write(JSON.stringify({ error: result.error, items: [] }));
+    } else {
+      process.stderr.write(`Search failed: ${result.error}\n`);
+    }
+    process.exit(1);
+  }
+
+  // Output results
+  const tweets = result.tweets || [];
+  if (jsonOutput) {
+    process.stdout.write(JSON.stringify(tweets));
+  } else {
+    for (const tweet of tweets) {
+      const author = tweet.author?.username || 'unknown';
+      process.stdout.write(`@${author}: ${tweet.text?.slice(0, 200)}\n\n`);
+    }
+  }
+
+  process.exit(0);
+} catch (err) {
+  if (jsonOutput) {
+    process.stdout.write(JSON.stringify({ error: err.message, items: [] }));
+  } else {
+    process.stderr.write(`Error: ${err.message}\n`);
+  }
+  process.exit(1);
+}

package/.xtrm/skills/default/last30days/scripts/lib/vendor/bird-search/lib/cookies.js

@@ -0,0 +1,191 @@
+/**
+ * Browser cookie extraction for Twitter authentication.
+ * Delegates to @steipete/sweet-cookie for Safari/Chrome/Firefox reads.
+ */
+import { getCookies } from '@steipete/sweet-cookie';
+const TWITTER_COOKIE_NAMES = ['auth_token', 'ct0'];
+const TWITTER_URL = 'https://x.com/';
+const TWITTER_ORIGINS = ['https://x.com/', 'https://twitter.com/'];
+const DEFAULT_COOKIE_TIMEOUT_MS = 30_000;
+function normalizeValue(value) {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function envFlagEnabled(name) {
+    const value = normalizeValue(process.env[name]);
+    if (!value) {
+        return false;
+    }
+    return ['1', 'true', 'yes', 'on'].includes(value.toLowerCase());
+}
+function cookieHeader(authToken, ct0) {
+    return `auth_token=${authToken}; ct0=${ct0}`;
+}
+function buildEmpty() {
+    return { authToken: null, ct0: null, cookieHeader: null, source: null };
+}
+function readEnvCookie(cookies, keys, field) {
+    if (cookies[field]) {
+        return;
+    }
+    for (const key of keys) {
+        const value = normalizeValue(process.env[key]);
+        if (!value) {
+            continue;
+        }
+        cookies[field] = value;
+        if (!cookies.source) {
+            cookies.source = `env ${key}`;
+        }
+        break;
+    }
+}
+function resolveSources(cookieSource) {
+    if (Array.isArray(cookieSource)) {
+        return cookieSource;
+    }
+    if (cookieSource) {
+        return [cookieSource];
+    }
+    return ['safari', 'chrome', 'firefox'];
+}
+function labelForSource(source, profile) {
+    if (source === 'safari') {
+        return 'Safari';
+    }
+    if (source === 'chrome') {
+        return profile ? `Chrome profile "${profile}"` : 'Chrome default profile';
+    }
+    return profile ? `Firefox profile "${profile}"` : 'Firefox default profile';
+}
+function pickCookieValue(cookies, name) {
+    const matches = cookies.filter((c) => c?.name === name && typeof c.value === 'string');
+    if (matches.length === 0) {
+        return null;
+    }
+    const preferred = matches.find((c) => (c.domain ?? '').endsWith('x.com'));
+    if (preferred?.value) {
+        return preferred.value;
+    }
+    const twitter = matches.find((c) => (c.domain ?? '').endsWith('twitter.com'));
+    if (twitter?.value) {
+        return twitter.value;
+    }
+    return matches[0]?.value ?? null;
+}
+async function readTwitterCookiesFromBrowser(options) {
+    const warnings = [];
+    const out = buildEmpty();
+    const { cookies, warnings: providerWarnings } = await getCookies({
+        url: TWITTER_URL,
+        origins: TWITTER_ORIGINS,
+        names: [...TWITTER_COOKIE_NAMES],
+        browsers: [options.source],
+        mode: 'merge',
+        chromeProfile: options.chromeProfile,
+        firefoxProfile: options.firefoxProfile,
+        timeoutMs: options.cookieTimeoutMs,
+    });
+    warnings.push(...providerWarnings);
+    const authToken = pickCookieValue(cookies, 'auth_token');
+    const ct0 = pickCookieValue(cookies, 'ct0');
+    if (authToken) {
+        out.authToken = authToken;
+    }
+    if (ct0) {
+        out.ct0 = ct0;
+    }
+    if (out.authToken && out.ct0) {
+        out.cookieHeader = cookieHeader(out.authToken, out.ct0);
+        out.source = labelForSource(options.source, options.source === 'chrome' ? options.chromeProfile : options.firefoxProfile);
+        return { cookies: out, warnings };
+    }
+    if (options.source === 'safari') {
+        warnings.push('No Twitter cookies found in Safari. Make sure you are logged into x.com in Safari.');
+    }
+    else if (options.source === 'chrome') {
+        warnings.push('No Twitter cookies found in Chrome. Make sure you are logged into x.com in Chrome.');
+    }
+    else {
+        warnings.push('No Twitter cookies found in Firefox. Make sure you are logged into x.com in Firefox and the profile exists.');
+    }
+    return { cookies: out, warnings };
+}
+export async function extractCookiesFromSafari() {
+    return readTwitterCookiesFromBrowser({ source: 'safari' });
+}
+export async function extractCookiesFromChrome(profile) {
+    return readTwitterCookiesFromBrowser({ source: 'chrome', chromeProfile: profile });
+}
+export async function extractCookiesFromFirefox(profile) {
+    return readTwitterCookiesFromBrowser({ source: 'firefox', firefoxProfile: profile });
+}
+/**
+ * Resolve Twitter credentials from multiple sources.
+ * Priority: CLI args > environment variables > browsers (ordered).
+ */
+export async function resolveCredentials(options) {
+    const warnings = [];
+    const cookies = buildEmpty();
+    const disableBrowserCookies = envFlagEnabled('BIRD_DISABLE_BROWSER_COOKIES') ||
+        envFlagEnabled('LAST30DAYS_DISABLE_BROWSER_COOKIES');
+    const cookieTimeoutMs = typeof options.cookieTimeoutMs === 'number' &&
+        Number.isFinite(options.cookieTimeoutMs) &&
+        options.cookieTimeoutMs > 0
+        ? options.cookieTimeoutMs
+        : process.platform === 'darwin'
+            ? DEFAULT_COOKIE_TIMEOUT_MS
+            : undefined;
+    if (options.authToken) {
+        cookies.authToken = options.authToken;
+        cookies.source = 'CLI argument';
+    }
+    if (options.ct0) {
+        cookies.ct0 = options.ct0;
+        if (!cookies.source) {
+            cookies.source = 'CLI argument';
+        }
+    }
+    readEnvCookie(cookies, ['AUTH_TOKEN', 'TWITTER_AUTH_TOKEN'], 'authToken');
+    readEnvCookie(cookies, ['CT0', 'TWITTER_CT0'], 'ct0');
+    if (cookies.authToken && cookies.ct0) {
+        cookies.cookieHeader = cookieHeader(cookies.authToken, cookies.ct0);
+        return { cookies, warnings };
+    }
+    if (disableBrowserCookies) {
+        if (!cookies.authToken) {
+            warnings.push('Missing auth_token - provide via --auth-token, AUTH_TOKEN env var, or disable BIRD_DISABLE_BROWSER_COOKIES to allow browser cookie lookup');
+        }
+        if (!cookies.ct0) {
+            warnings.push('Missing ct0 - provide via --ct0, CT0 env var, or disable BIRD_DISABLE_BROWSER_COOKIES to allow browser cookie lookup');
+        }
+        return { cookies, warnings };
+    }
+    const sourcesToTry = resolveSources(options.cookieSource);
+    for (const source of sourcesToTry) {
+        const res = await readTwitterCookiesFromBrowser({
+            source,
+            chromeProfile: options.chromeProfile,
+            firefoxProfile: options.firefoxProfile,
+            cookieTimeoutMs,
+        });
+        warnings.push(...res.warnings);
+        if (res.cookies.authToken && res.cookies.ct0) {
+            return { cookies: res.cookies, warnings };
+        }
+    }
+    if (!cookies.authToken) {
+        warnings.push('Missing auth_token - provide via --auth-token, AUTH_TOKEN env var, or login to x.com in Safari/Chrome/Firefox');
+    }
+    if (!cookies.ct0) {
+        warnings.push('Missing ct0 - provide via --ct0, CT0 env var, or login to x.com in Safari/Chrome/Firefox');
+    }
+    if (cookies.authToken && cookies.ct0) {
+        cookies.cookieHeader = cookieHeader(cookies.authToken, cookies.ct0);
+    }
+    return { cookies, warnings };
+}
+//# sourceMappingURL=cookies.js.map

package/.xtrm/skills/default/last30days/scripts/lib/vendor/bird-search/lib/features.json

@@ -0,0 +1,17 @@
+{
+  "global": {
+    "responsive_web_grok_annotations_enabled": false,
+    "post_ctas_fetch_enabled": true,
+    "responsive_web_graphql_exclude_directive_enabled": true
+  },
+  "sets": {
+    "lists": {
+      "blue_business_profile_image_shape_enabled": true,
+      "tweetypie_unmention_optimization_enabled": true,
+      "responsive_web_text_conversations_enabled": false,
+      "interactive_text_enabled": true,
+      "vibe_api_enabled": true,
+      "responsive_web_twitter_blue_verified_badge_is_enabled": true
+    }
+  }
+}

package/.xtrm/skills/default/last30days/scripts/lib/vendor/bird-search/lib/paginate-cursor.js

@@ -0,0 +1,37 @@
+export async function paginateCursor(opts) {
+    const { maxPages, pageDelayMs = 1000 } = opts;
+    const seen = new Set();
+    const items = [];
+    let cursor = opts.cursor;
+    let pagesFetched = 0;
+    while (true) {
+        if (pagesFetched > 0 && pageDelayMs > 0) {
+            await opts.sleep(pageDelayMs);
+        }
+        const page = await opts.fetchPage(cursor);
+        if (!page.success) {
+            if (items.length > 0) {
+                return { success: false, error: page.error, items, nextCursor: cursor };
+            }
+            return page;
+        }
+        pagesFetched += 1;
+        for (const item of page.items) {
+            const key = opts.getKey(item);
+            if (seen.has(key)) {
+                continue;
+            }
+            seen.add(key);
+            items.push(item);
+        }
+        const pageCursor = page.cursor;
+        if (!pageCursor || pageCursor === cursor) {
+            return { success: true, items, nextCursor: undefined };
+        }
+        if (maxPages !== undefined && pagesFetched >= maxPages) {
+            return { success: true, items, nextCursor: pageCursor };
+        }
+        cursor = pageCursor;
+    }
+}
+//# sourceMappingURL=paginate-cursor.js.map

package/.xtrm/skills/default/last30days/scripts/lib/vendor/bird-search/lib/query-ids.json

@@ -0,0 +1,20 @@
+{
+  "CreateTweet": "nmdAQXJDxw6-0KKF2on7eA",
+  "CreateRetweet": "LFho5rIi4xcKO90p9jwG7A",
+  "CreateFriendship": "8h9JVdV8dlSyqyRDJEPCsA",
+  "DestroyFriendship": "ppXWuagMNXgvzx6WoXBW0Q",
+  "FavoriteTweet": "lI07N6Otwv1PhnEgXILM7A",
+  "DeleteBookmark": "Wlmlj2-xzyS1GN3a6cj-mQ",
+  "TweetDetail": "_NvJCnIjOW__EP5-RF197A",
+  "SearchTimeline": "6AAys3t42mosm_yTI_QENg",
+  "Bookmarks": "RV1g3b8n_SGOHwkqKYSCFw",
+  "BookmarkFolderTimeline": "KJIQpsvxrTfRIlbaRIySHQ",
+  "Following": "mWYeougg_ocJS2Vr1Vt28w",
+  "Followers": "SFYY3WsgwjlXSLlfnEUE4A",
+  "Likes": "ETJflBunfqNa1uE1mBPCaw",
+  "ExploreSidebar": "lpSN4M6qpimkF4nRFPE3nQ",
+  "ExplorePage": "kheAINB_4pzRDqkzG3K-ng",
+  "GenericTimelineById": "uGSr7alSjR9v6QJAIaqSKQ",
+  "TrendHistory": "Sj4T-jSB9pr0Mxtsc1UKZQ",
+  "AboutAccountQuery": "zs_jFPFT78rBpXv9Z3U2YQ"
+}

package/.xtrm/skills/default/last30days/scripts/lib/vendor/bird-search/lib/runtime-features.js

@@ -0,0 +1,151 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import path from 'node:path';
+// biome-ignore lint/correctness/useImportExtensions: JSON module import doesn't use .js extension.
+import defaultOverrides from './features.json' with { type: 'json' };
+const DEFAULT_CACHE_FILENAME = 'features.json';
+let cachedOverrides = null;
+function normalizeFeatureMap(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return {};
+    }
+    const result = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (typeof entry === 'boolean') {
+            result[key] = entry;
+        }
+    }
+    return result;
+}
+function normalizeOverrides(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return { global: {}, sets: {} };
+    }
+    const record = value;
+    const global = normalizeFeatureMap(record.global);
+    const sets = {};
+    const rawSets = record.sets && typeof record.sets === 'object' && !Array.isArray(record.sets)
+        ? record.sets
+        : {};
+    for (const [setName, setValue] of Object.entries(rawSets)) {
+        const normalized = normalizeFeatureMap(setValue);
+        if (Object.keys(normalized).length > 0) {
+            sets[setName] = normalized;
+        }
+    }
+    return { global, sets };
+}
+function mergeOverrides(base, next) {
+    const sets = { ...base.sets };
+    for (const [setName, overrides] of Object.entries(next.sets)) {
+        const existing = sets[setName];
+        sets[setName] = existing ? { ...existing, ...overrides } : { ...overrides };
+    }
+    return {
+        global: { ...base.global, ...next.global },
+        sets,
+    };
+}
+function toFeatureOverrides(overrides) {
+    const result = {};
+    if (Object.keys(overrides.global).length > 0) {
+        result.global = overrides.global;
+    }
+    const setEntries = Object.entries(overrides.sets).filter(([, value]) => Object.keys(value).length > 0);
+    if (setEntries.length > 0) {
+        result.sets = Object.fromEntries(setEntries);
+    }
+    return result;
+}
+function resolveFeaturesCachePath() {
+    const override = process.env.BIRD_FEATURES_CACHE ?? process.env.BIRD_FEATURES_PATH;
+    if (override && override.trim().length > 0) {
+        return path.resolve(override.trim());
+    }
+    return path.join(homedir(), '.config', 'bird', DEFAULT_CACHE_FILENAME);
+}
+function readOverridesFromFile(cachePath) {
+    if (!existsSync(cachePath)) {
+        return null;
+    }
+    try {
+        const raw = readFileSync(cachePath, 'utf8');
+        return normalizeOverrides(JSON.parse(raw));
+    }
+    catch {
+        return null;
+    }
+}
+function readOverridesFromEnv() {
+    const raw = process.env.BIRD_FEATURES_JSON;
+    if (!raw || raw.trim().length === 0) {
+        return null;
+    }
+    try {
+        return normalizeOverrides(JSON.parse(raw));
+    }
+    catch {
+        return null;
+    }
+}
+function writeOverridesToDisk(cachePath, overrides) {
+    const payload = toFeatureOverrides(overrides);
+    return mkdir(path.dirname(cachePath), { recursive: true }).then(() => writeFile(cachePath, `${JSON.stringify(payload, null, 2)}\n`, 'utf8'));
+}
+export function loadFeatureOverrides() {
+    if (cachedOverrides) {
+        return cachedOverrides;
+    }
+    const base = normalizeOverrides(defaultOverrides);
+    const fromFile = readOverridesFromFile(resolveFeaturesCachePath());
+    const fromEnv = readOverridesFromEnv();
+    let merged = base;
+    if (fromFile) {
+        merged = mergeOverrides(merged, fromFile);
+    }
+    if (fromEnv) {
+        merged = mergeOverrides(merged, fromEnv);
+    }
+    cachedOverrides = merged;
+    return merged;
+}
+export function getFeatureOverridesSnapshot() {
+    const overrides = toFeatureOverrides(loadFeatureOverrides());
+    return {
+        cachePath: resolveFeaturesCachePath(),
+        overrides,
+    };
+}
+export function applyFeatureOverrides(setName, base) {
+    const overrides = loadFeatureOverrides();
+    const globalOverrides = overrides.global;
+    const setOverrides = overrides.sets[setName];
+    if (Object.keys(globalOverrides).length === 0 && (!setOverrides || Object.keys(setOverrides).length === 0)) {
+        return base;
+    }
+    if (setOverrides) {
+        return {
+            ...base,
+            ...globalOverrides,
+            ...setOverrides,
+        };
+    }
+    return {
+        ...base,
+        ...globalOverrides,
+    };
+}
+export async function refreshFeatureOverridesCache() {
+    const cachePath = resolveFeaturesCachePath();
+    const base = normalizeOverrides(defaultOverrides);
+    const fromFile = readOverridesFromFile(cachePath);
+    const merged = mergeOverrides(base, fromFile ?? { global: {}, sets: {} });
+    await writeOverridesToDisk(cachePath, merged);
+    cachedOverrides = null;
+    return { cachePath, overrides: toFeatureOverrides(merged) };
+}
+export function clearFeatureOverridesCache() {
+    cachedOverrides = null;
+}
+//# sourceMappingURL=runtime-features.js.map