@aisa-one/cli 0.1.7 → 0.2.0

package/dist/commands/twitter.d.ts

@@ -1,14 +1,138 @@
-export declare function tweetAction(text: string, options: {
-    replyTo?: string;
+export declare function twitterUserAction(username: string, options: {
+    raw?: boolean;
+}): Promise<void>;
+export declare function twitterUserAboutAction(username: string, options: {
+    raw?: boolean;
+}): Promise<void>;
+export declare function twitterBatchUsersAction(ids: string, options: {
+    raw?: boolean;
+}): Promise<void>;
+export declare function twitterUserTweetsAction(username: string, options: {
     raw?: boolean;
+    cursor?: string;
+}): Promise<void>;
+export declare function twitterMentionsAction(username: string, options: {
+    raw?: boolean;
+    cursor?: string;
+}): Promise<void>;
+export declare function twitterFollowersAction(username: string, options: {
+    raw?: boolean;
+    cursor?: string;
+}): Promise<void>;
+export declare function twitterFollowingAction(username: string, options: {
+    raw?: boolean;
+    cursor?: string;
+}): Promise<void>;
+export declare function twitterVerifiedFollowersAction(userId: string, options: {
+    raw?: boolean;
+    cursor?: string;
+}): Promise<void>;
+export declare function twitterCheckFollowAction(source: string, target: string, options: {
+    raw?: boolean;
+}): Promise<void>;
+export declare function twitterUserSearchAction(query: string, options: {
+    raw?: boolean;
+    cursor?: string;
 }): Promise<void>;
 export declare function twitterSearchAction(query: string, options: {
     limit?: string;
+    type?: string;
     raw?: boolean;
+    cursor?: string;
 }): Promise<void>;
-export declare function twitterUserAction(username: string, options: {
+export declare function twitterDetailAction(ids: string, options: {
+    raw?: boolean;
+}): Promise<void>;
+export declare function twitterRepliesAction(tweetId: string, options: {
+    raw?: boolean;
+    cursor?: string;
+}): Promise<void>;
+export declare function twitterQuotesAction(tweetId: string, options: {
+    raw?: boolean;
+    cursor?: string;
+}): Promise<void>;
+export declare function twitterRetweetersAction(tweetId: string, options: {
+    raw?: boolean;
+    cursor?: string;
+}): Promise<void>;
+export declare function twitterThreadAction(tweetId: string, options: {
+    raw?: boolean;
+    cursor?: string;
+}): Promise<void>;
+export declare function twitterArticleAction(tweetId: string, options: {
     raw?: boolean;
 }): Promise<void>;
 export declare function twitterTrendsAction(options: {
+    woeid?: string;
+    count?: string;
+    raw?: boolean;
+}): Promise<void>;
+export declare function twitterListMembersAction(listId: string, options: {
+    raw?: boolean;
+    cursor?: string;
+}): Promise<void>;
+export declare function twitterListFollowersAction(listId: string, options: {
+    raw?: boolean;
+    cursor?: string;
+}): Promise<void>;
+export declare function twitterCommunityInfoAction(communityId: string, options: {
+    raw?: boolean;
+}): Promise<void>;
+export declare function twitterCommunityMembersAction(communityId: string, options: {
+    raw?: boolean;
+    cursor?: string;
+}): Promise<void>;
+export declare function twitterCommunityModsAction(communityId: string, options: {
+    raw?: boolean;
+    cursor?: string;
+}): Promise<void>;
+export declare function twitterCommunityTweetsAction(communityId: string, options: {
+    raw?: boolean;
+    cursor?: string;
+}): Promise<void>;
+export declare function twitterCommunitySearchAction(query: string, options: {
+    raw?: boolean;
+    cursor?: string;
+}): Promise<void>;
+export declare function twitterSpaceAction(spaceId: string, options: {
+    raw?: boolean;
+}): Promise<void>;
+export declare function twitterLoginAction(options: {
+    username?: string;
+    email?: string;
+    password?: string;
+    proxy?: string;
+    totp?: string;
+    cookies?: string;
+    raw?: boolean;
+}): Promise<void>;
+export declare function twitterLogoutAction(): void;
+export declare function tweetAction(text: string, options: {
+    replyTo?: string;
+    mediaIds?: string;
+    raw?: boolean;
+}): Promise<void>;
+export declare function twitterLikeAction(tweetId: string, options: {
+    raw?: boolean;
+}): Promise<void>;
+export declare function twitterUnlikeAction(tweetId: string, options: {
+    raw?: boolean;
+}): Promise<void>;
+export declare function twitterRetweetAction(tweetId: string, options: {
+    raw?: boolean;
+}): Promise<void>;
+export declare function twitterDeleteAction(tweetId: string, options: {
+    raw?: boolean;
+}): Promise<void>;
+export declare function twitterFollowAction(userId: string, options: {
+    raw?: boolean;
+}): Promise<void>;
+export declare function twitterUnfollowAction(userId: string, options: {
+    raw?: boolean;
+}): Promise<void>;
+export declare function twitterUploadMediaAction(filePath: string, options: {
+    raw?: boolean;
+}): Promise<void>;
+export declare function twitterDmAction(userId: string, text: string, options: {
     raw?: boolean;
 }): Promise<void>;

package/dist/commands/twitter.js

@@ -1,29 +1,34 @@
 import ora from "ora";
 import chalk from "chalk";
-import { requireApiKey } from "../config.js";
+import fetch from "node-fetch";
+import { requireApiKey, getConfig, setConfig } from "../config.js";
 import { apiRequest } from "../api.js";
-import { error, formatJson } from "../utils/display.js";
-export async function tweetAction(text, options) {
+import { APIS_BASE_URL } from "../constants.js";
+import { error, success, formatJson } from "../utils/display.js";
+function requireCookies() {
+    const cookies = getConfig("twitterCookies");
+    const proxy = getConfig("twitterProxy");
+    if (!cookies) {
+        error('No Twitter cookies configured. Run "aisa twitter login" or "aisa config set twitterCookies <value>".');
+        process.exit(1);
+    }
+    if (!proxy) {
+        error('No Twitter proxy configured. Run "aisa config set twitterProxy <value>".');
+        process.exit(1);
+    }
+    return { login_cookies: cookies, proxy };
+}
+/** Simple GET against a twitter read endpoint. */
+async function twitterGet(endpoint, query, label, options) {
     const key = requireApiKey();
-    const spinner = ora("Posting tweet...").start();
-    const body = { tweet_text: text };
-    if (options.replyTo)
-        body.reply_to_tweet_id = options.replyTo;
-    // Note: create_tweet_v2 requires login_cookies and proxy
-    // This will fail without those - provide a helpful message
-    const res = await apiRequest(key, "twitter/create_tweet_v2", {
-        method: "POST",
-        body,
+    const spinner = ora(label).start();
+    const res = await apiRequest(key, endpoint, {
+        query,
         domain: true,
     });
     if (!res.success) {
-        spinner.fail("Failed to post tweet");
-        if (res.error?.includes("login_cookies")) {
-            error("Tweet creation requires Twitter login cookies. See: https://docs.aisa.one");
-        }
-        else {
-            error(res.error || "Unknown error");
-        }
+        spinner.fail(label.replace(/\.{3}$/, " failed"));
+        error(res.error || "Unknown error");
         return;
     }
     spinner.stop();
@@ -31,22 +36,21 @@ export async function tweetAction(text, options) {
         console.log(JSON.stringify(res.data));
     }
     else {
-        console.log(chalk.green("Tweet posted!"));
         console.log(formatJson(res.data));
     }
 }
-export async function twitterSearchAction(query, options) {
+/** POST against a twitter write endpoint (auto-injects cookies/proxy). */
+async function twitterWrite(endpoint, body, label, options) {
     const key = requireApiKey();
-    const spinner = ora(`Searching tweets: "${query}"...`).start();
-    const q = { query, queryType: "Latest" };
-    if (options.limit)
-        q.cursor = "";
-    const res = await apiRequest(key, "twitter/tweet/advanced_search", {
-        query: q,
+    const auth = requireCookies();
+    const spinner = ora(label).start();
+    const res = await apiRequest(key, endpoint, {
+        method: "POST",
+        body: { ...auth, ...body },
         domain: true,
     });
     if (!res.success) {
-        spinner.fail("Twitter search failed");
+        spinner.fail(label.replace(/\.{3}$/, " failed"));
         error(res.error || "Unknown error");
         return;
     }
@@ -58,6 +62,7 @@ export async function twitterSearchAction(query, options) {
         console.log(formatJson(res.data));
     }
 }
+// ── Read: User Endpoints ─────────────────────────────────────────────────────
 export async function twitterUserAction(username, options) {
     const key = requireApiKey();
     const spinner = ora(`Fetching @${username}...`).start();
@@ -92,24 +97,279 @@ export async function twitterUserAction(username, options) {
         }
     }
 }
+export async function twitterUserAboutAction(username, options) {
+    return twitterGet("twitter/user_about", { userName: username }, `Fetching about @${username}...`, options);
+}
+export async function twitterBatchUsersAction(ids, options) {
+    return twitterGet("twitter/user/batch_info_by_ids", { userIds: ids }, "Fetching users...", options);
+}
+export async function twitterUserTweetsAction(username, options) {
+    const q = { userName: username };
+    if (options.cursor)
+        q.cursor = options.cursor;
+    return twitterGet("twitter/user/last_tweets", q, `Fetching tweets by @${username}...`, options);
+}
+export async function twitterMentionsAction(username, options) {
+    const q = { userName: username };
+    if (options.cursor)
+        q.cursor = options.cursor;
+    return twitterGet("twitter/user/mentions", q, `Fetching mentions of @${username}...`, options);
+}
+export async function twitterFollowersAction(username, options) {
+    const q = { userName: username };
+    if (options.cursor)
+        q.cursor = options.cursor;
+    return twitterGet("twitter/user/followers", q, `Fetching followers of @${username}...`, options);
+}
+export async function twitterFollowingAction(username, options) {
+    const q = { userName: username };
+    if (options.cursor)
+        q.cursor = options.cursor;
+    return twitterGet("twitter/user/followings", q, `Fetching following of @${username}...`, options);
+}
+export async function twitterVerifiedFollowersAction(userId, options) {
+    const q = { user_id: userId };
+    if (options.cursor)
+        q.cursor = options.cursor;
+    return twitterGet("twitter/user/verifiedFollowers", q, "Fetching verified followers...", options);
+}
+export async function twitterCheckFollowAction(source, target, options) {
+    return twitterGet("twitter/user/check_follow_relationship", { source_user_name: source, target_user_name: target }, `Checking follow relationship @${source} → @${target}...`, options);
+}
+export async function twitterUserSearchAction(query, options) {
+    const q = { query };
+    if (options.cursor)
+        q.cursor = options.cursor;
+    return twitterGet("twitter/user/search", q, `Searching users: "${query}"...`, options);
+}
+// ── Read: Tweet Endpoints ────────────────────────────────────────────────────
+export async function twitterSearchAction(query, options) {
+    const q = {
+        query,
+        queryType: options.type === "top" ? "Top" : "Latest",
+    };
+    if (options.cursor)
+        q.cursor = options.cursor;
+    if (options.limit)
+        q.count = options.limit;
+    return twitterGet("twitter/tweet/advanced_search", q, `Searching tweets: "${query}"...`, options);
+}
+export async function twitterDetailAction(ids, options) {
+    return twitterGet("twitter/tweets", { tweet_ids: ids }, "Fetching tweet details...", options);
+}
+export async function twitterRepliesAction(tweetId, options) {
+    const q = { tweetId };
+    if (options.cursor)
+        q.cursor = options.cursor;
+    return twitterGet("twitter/tweet/replies", q, "Fetching replies...", options);
+}
+export async function twitterQuotesAction(tweetId, options) {
+    const q = { tweetId };
+    if (options.cursor)
+        q.cursor = options.cursor;
+    return twitterGet("twitter/tweet/quotes", q, "Fetching quotes...", options);
+}
+export async function twitterRetweetersAction(tweetId, options) {
+    const q = { tweetId };
+    if (options.cursor)
+        q.cursor = options.cursor;
+    return twitterGet("twitter/tweet/retweeters", q, "Fetching retweeters...", options);
+}
+export async function twitterThreadAction(tweetId, options) {
+    const q = { tweetId };
+    if (options.cursor)
+        q.cursor = options.cursor;
+    return twitterGet("twitter/tweet/thread_context", q, "Fetching thread...", options);
+}
+export async function twitterArticleAction(tweetId, options) {
+    return twitterGet("twitter/article", { tweet_id: tweetId }, "Fetching article...", options);
+}
+// ── Read: Trends ─────────────────────────────────────────────────────────────
 export async function twitterTrendsAction(options) {
+    const q = {
+        woeid: options.woeid || "1",
+        count: options.count || "30",
+    };
+    return twitterGet("twitter/trends", q, "Fetching trends...", options);
+}
+// ── Read: Lists ──────────────────────────────────────────────────────────────
+export async function twitterListMembersAction(listId, options) {
+    const q = { list_id: listId };
+    if (options.cursor)
+        q.cursor = options.cursor;
+    return twitterGet("twitter/list/members", q, "Fetching list members...", options);
+}
+export async function twitterListFollowersAction(listId, options) {
+    const q = { list_id: listId };
+    if (options.cursor)
+        q.cursor = options.cursor;
+    return twitterGet("twitter/list/followers", q, "Fetching list followers...", options);
+}
+// ── Read: Communities ────────────────────────────────────────────────────────
+export async function twitterCommunityInfoAction(communityId, options) {
+    return twitterGet("twitter/community/info", { community_id: communityId }, "Fetching community info...", options);
+}
+export async function twitterCommunityMembersAction(communityId, options) {
+    const q = { community_id: communityId };
+    if (options.cursor)
+        q.cursor = options.cursor;
+    return twitterGet("twitter/community/members", q, "Fetching community members...", options);
+}
+export async function twitterCommunityModsAction(communityId, options) {
+    const q = { community_id: communityId };
+    if (options.cursor)
+        q.cursor = options.cursor;
+    return twitterGet("twitter/community/moderators", q, "Fetching community moderators...", options);
+}
+export async function twitterCommunityTweetsAction(communityId, options) {
+    const q = { community_id: communityId };
+    if (options.cursor)
+        q.cursor = options.cursor;
+    return twitterGet("twitter/community/tweets", q, "Fetching community tweets...", options);
+}
+export async function twitterCommunitySearchAction(query, options) {
+    const q = { query };
+    if (options.cursor)
+        q.cursor = options.cursor;
+    return twitterGet("twitter/community/get_tweets_from_all_community", q, `Searching community tweets: "${query}"...`, options);
+}
+// ── Read: Spaces ─────────────────────────────────────────────────────────────
+export async function twitterSpaceAction(spaceId, options) {
+    return twitterGet("twitter/spaces/detail", { space_id: spaceId }, "Fetching space details...", options);
+}
+// ── Write: Login / Logout ────────────────────────────────────────────────────
+export async function twitterLoginAction(options) {
+    // Direct cookie import mode
+    if (options.cookies) {
+        if (!options.proxy) {
+            error("--proxy is required when setting cookies directly.");
+            process.exit(1);
+        }
+        setConfig("twitterCookies", options.cookies);
+        setConfig("twitterProxy", options.proxy);
+        success("Twitter cookies and proxy saved.");
+        return;
+    }
+    // Login via API
+    if (!options.username || !options.password || !options.proxy) {
+        error("Required: --username, --password, --proxy (and optionally --email, --totp)");
+        process.exit(1);
+    }
     const key = requireApiKey();
-    const spinner = ora("Fetching trends...").start();
-    // woeid 1 = worldwide
-    const res = await apiRequest(key, "twitter/trends", {
-        query: { woeid: "1", count: "30" },
-        domain: true,
-    });
+    const spinner = ora("Logging in to Twitter...").start();
+    const body = {
+        user_name: options.username,
+        password: options.password,
+        proxy: options.proxy,
+    };
+    if (options.email)
+        body.email = options.email;
+    if (options.totp)
+        body.totp_secret = options.totp;
+    const res = await apiRequest(key, "twitter/user_login_v2", { method: "POST", body, domain: true });
     if (!res.success) {
-        spinner.fail("Failed to fetch trends");
+        spinner.fail("Twitter login failed");
         error(res.error || "Unknown error");
         return;
     }
     spinner.stop();
+    // Extract and store cookies
+    const data = res.data;
+    const cookies = data?.login_cookies ||
+        data?.data?.login_cookies;
+    if (cookies) {
+        setConfig("twitterCookies", cookies);
+        setConfig("twitterProxy", options.proxy);
+        success("Logged in! Cookies and proxy saved.");
+    }
+    else {
+        console.log(chalk.yellow("Login response did not contain login_cookies. Raw response:"));
+        console.log(formatJson(res.data));
+    }
     if (options.raw) {
         console.log(JSON.stringify(res.data));
     }
+}
+export function twitterLogoutAction() {
+    setConfig("twitterCookies", "");
+    setConfig("twitterProxy", "");
+    success("Twitter cookies and proxy cleared.");
+}
+// ── Write: Tweet ─────────────────────────────────────────────────────────────
+export async function tweetAction(text, options) {
+    const body = { tweet_text: text };
+    if (options.replyTo)
+        body.reply_to_tweet_id = options.replyTo;
+    if (options.mediaIds)
+        body.media_ids = options.mediaIds.split(",");
+    return twitterWrite("twitter/create_tweet_v2", body, "Posting tweet...", options);
+}
+// ── Write: Like / Unlike ─────────────────────────────────────────────────────
+export async function twitterLikeAction(tweetId, options) {
+    return twitterWrite("twitter/like_tweet_v2", { tweet_id: tweetId }, "Liking tweet...", options);
+}
+export async function twitterUnlikeAction(tweetId, options) {
+    return twitterWrite("twitter/unlike_tweet_v2", { tweet_id: tweetId }, "Unliking tweet...", options);
+}
+// ── Write: Retweet ───────────────────────────────────────────────────────────
+export async function twitterRetweetAction(tweetId, options) {
+    return twitterWrite("twitter/retweet_tweet_v2", { tweet_id: tweetId }, "Retweeting...", options);
+}
+// ── Write: Delete ────────────────────────────────────────────────────────────
+export async function twitterDeleteAction(tweetId, options) {
+    return twitterWrite("twitter/delete_tweet_v2", { tweet_id: tweetId }, "Deleting tweet...", options);
+}
+// ── Write: Follow / Unfollow ─────────────────────────────────────────────────
+export async function twitterFollowAction(userId, options) {
+    return twitterWrite("twitter/follow_user_v2", { user_id: userId }, "Following user...", options);
+}
+export async function twitterUnfollowAction(userId, options) {
+    return twitterWrite("twitter/unfollow_user_v2", { user_id: userId }, "Unfollowing user...", options);
+}
+// ── Write: Upload Media ──────────────────────────────────────────────────────
+export async function twitterUploadMediaAction(filePath, options) {
+    const key = requireApiKey();
+    const auth = requireCookies();
+    const spinner = ora("Uploading media...").start();
+    let formData;
+    try {
+        const { FormData: NFFormData, fileFromSync } = await import("node-fetch");
+        formData = new NFFormData();
+        formData.append("file", fileFromSync(filePath));
+    }
+    catch {
+        spinner.fail("Failed to read file");
+        error(`Could not read file: ${filePath}`);
+        return;
+    }
+    formData.append("login_cookies", auth.login_cookies);
+    formData.append("proxy", auth.proxy);
+    const url = `${APIS_BASE_URL}/twitter/upload_media_v2`;
+    const res = await fetch(url, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${key}`,
+            "x-aisa-source": "cli",
+        },
+        body: formData,
+    });
+    if (!res.ok) {
+        spinner.fail("Upload failed");
+        const text = await res.text();
+        error(`${res.status}: ${text}`);
+        return;
+    }
+    const data = await res.json();
+    spinner.stop();
+    if (options.raw) {
+        console.log(JSON.stringify(data));
+    }
     else {
-        console.log(formatJson(res.data));
+        success("Media uploaded!");
+        console.log(formatJson(data));
     }
 }
+// ── Write: Direct Message ────────────────────────────────────────────────────
+export async function twitterDmAction(userId, text, options) {
+    return twitterWrite("twitter/send_dm_to_user", { user_id: userId, text }, "Sending DM...", options);
+}

package/dist/config.js

@@ -7,6 +7,8 @@ const config = new Conf({
         defaultModel: { type: "string", default: "gpt-4.1" },
         baseUrl: { type: "string", default: "https://api.aisa.one/v1" },
         outputFormat: { type: "string", default: "text" },
+        twitterCookies: { type: "string", default: "" },
+        twitterProxy: { type: "string", default: "" },
     },
 });
 export function getApiKey() {

package/dist/constants.d.ts

@@ -1,4 +1,4 @@
-export declare const VERSION = "0.1.7";
+export declare const VERSION = "0.2.0";
 export declare const BASE_URL = "https://api.aisa.one";
 export declare const CLI_BASE_URL = "https://api.aisa.one/v1";
 export declare const APIS_BASE_URL = "https://api.aisa.one/apis/v1";

package/dist/constants.js

@@ -1,4 +1,4 @@
-export const VERSION = "0.1.7";
+export const VERSION = "0.2.0";
 export const BASE_URL = "https://api.aisa.one";
 export const CLI_BASE_URL = `${BASE_URL}/v1`;
 export const APIS_BASE_URL = `${BASE_URL}/apis/v1`;