@usesocial/cli 0.2.1 → 0.2.3

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @usesocial/cli
 
+## 0.2.3
+
+### Patch Changes
+
+- [`962b0ad`](https://github.com/usesocial/monorepo/commit/962b0ad79bd764b27a24bf157115c721afb49017) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Cache more non-DM X reads, including handle lookup, engagement graphs,
+  bookmarks, likes, mentions, timeline, lists, and list members.
+
+- [`6a79019`](https://github.com/usesocial/monorepo/commit/6a79019a46e09e63148341ea8b8cf67aec1f4819) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Mark `social x profile` as a cacheable read so repeated profile fetches can be
+  served from cache for zero credits and support `-H/--header` cache controls.
+
+## 0.2.2
+
+### Patch Changes
+
+- Clean up account connect progress output so X and LinkedIn show the auth handshake spinner before opening the browser URL.
+
 ## 0.2.1
 
 ### Patch Changes

package/README.md

@@ -45,7 +45,7 @@ A few of the things the command surface supports:
 | "Surface the ten connections worth reaching out to this week." | `linkedin connections`, `x tweets` |
 | "Pull everyone who reacted to my last LinkedIn post and flag the warm leads." | `linkedin reactions`, `linkedin profile` |
 | "Read this creator's recent posts and break down what makes them land." | `linkedin posts`, `x tweets` |
-| "Find what people are saying about AI agents this week and summarize the themes." | `linkedin search posts`, `x timeline` |
+| "Find what people are saying about AI agents this week and summarize the themes." | `linkedin posts`, `x timeline` |
 | "Draft a reply to this thread and post it once I approve." | `linkedin comment`, `x post` |
 
 ## Commands
@@ -84,10 +84,10 @@ connected account.
 | `(bare)` | Show who is signed in and list connected accounts. | |
 | `login` | Device sign-in, scope selection, and billing. | |
 | `logout` | Revoke the session and clear the saved token. | |
-| `connect linkedin` | Connect a LinkedIn account through the browser. | ✎ write |
-| `connect x` | Connect an X account through OAuth. | ✎ write |
-| `reconnect linkedin <account>` | Re-auth an existing LinkedIn account. | ✎ write |
-| `reconnect x <account>` | Re-auth an existing X account. | ✎ write |
+| `connect linkedin` | Open or print a LinkedIn connection URL. | ✎ write |
+| `connect x` | Open or print an X OAuth URL. | ✎ write |
+| `reconnect linkedin <account>` | Re-auth an existing LinkedIn account by opening or printing a connection URL. | ✎ write |
+| `reconnect x <account>` | Re-auth an existing X account by opening or printing an OAuth URL. | ✎ write |
 | `disconnect linkedin <account>` | Disconnect a LinkedIn account. | ✎ write |
 | `disconnect x <account>` | Disconnect an X account. | ✎ write |
 | `usage` | Aggregate proxy usage and billing stats. | |
@@ -116,10 +116,6 @@ connected account.
 | `connections [target]` | List connections; omit the target for account-level connections. | |
 | `company <target>` | Fetch a company profile. | |
 | `jobs <target>` | List a company's job postings. | |
-| `search people <keywords>` | Search for people. | |
-| `search posts <keywords>` | Search for posts. | |
-| `search jobs <keywords>` | Search for jobs. | |
-| `search companies <keywords>` | Search for companies. | |
 | `messages` | List conversations. | |
 | `messages <target>` | Read a conversation by `chat_id:<id>`, `@handle`, `profile_id:<id>`, profile URL, or messaging-thread URL. | |
 | `message <target> <text>` | Send a message. | ✎ write |
@@ -160,9 +156,9 @@ connected account.
   then knows the commands.
 
 ```sh
-# Find hiring posts, fan out to reaction graphs, rank warm contacts.
-social linkedin search posts "AI infra hiring" --limit 25 > /tmp/hiring-posts.json
-jq -r '.items[].id' /tmp/hiring-posts.json \
+# Review recent LinkedIn posts, fan out to reaction graphs, rank warm contacts.
+social linkedin posts --limit 25 > /tmp/recent-posts.json
+jq -r '.items[].id' /tmp/recent-posts.json \
   | xargs -I{} social linkedin reactions post_id:{} \
   | jq -s '[ .[] | .items[] ]
             | group_by(.actor.id // .reactor.id // .profile_id)
@@ -247,7 +243,6 @@ Built so your accounts outlive your prototype.
 
 ```sh
 # LinkedIn
-social linkedin search people "founder ai"
 social linkedin profile
 
 # X

package/dist/index.mjs

@@ -1755,7 +1755,7 @@ var Doc = class {
 };
 //#endregion
 //#region ../../node_modules/.bun/zod@4.4.3/node_modules/zod/v4/core/versions.js
-const version$1 = {
+const version$2 = {
 	major: 4,
 	minor: 4,
 	patch: 3
@@ -1767,7 +1767,7 @@ const $ZodType = /* @__PURE__ */ $constructor("$ZodType", (inst, def) => {
 	inst ?? (inst = {});
 	inst._zod.def = def;
 	inst._zod.bag = inst._zod.bag || {};
-	inst._zod.version = version$1;
+	inst._zod.version = version$2;
 	const checks = [...inst._zod.def.checks ?? []];
 	if (inst._zod.traits.has("$ZodCheck")) checks.unshift(inst);
 	for (const ch of checks) for (const fn of ch._zod.onattach) fn(inst);
@@ -11202,223 +11202,79 @@ function renderDescription(arg, required) {
 	].filter(Boolean).join(" ");
 }
 //#endregion
-//#region ../../packages/x/src/pricing.ts
-const { costBPSForCategory } = createPricing([
+//#region ../../packages/linkedin/src/pricing.ts
+const { costBPSForCategory: costBPSForCategory$1 } = createPricing([
 	{
 		"key": "posts_read",
 		"label": "Posts: Read",
-		"description": "Charged per resource fetched.",
-		"unit": "resource",
+		"description": "Read LinkedIn posts, comments, reactions, jobs, and other post-like result sets.",
+		"unit": "per_resource",
 		"unitPriceUSD": .005,
 		"featureId": "post_read_resource"
 	},
 	{
 		"key": "user_read",
 		"label": "User: Read",
-		"description": "Charged per resource fetched.",
-		"unit": "resource",
+		"description": "Read non-owned LinkedIn profiles, companies, people search, company search, requests, and other profile-like result sets.",
+		"unit": "per_resource",
 		"unitPriceUSD": .01,
 		"featureId": "user_read_resource"
 	},
 	{
 		"key": "dm_event_read",
 		"label": "DM Event: Read",
-		"description": "Charged per resource fetched.",
-		"unit": "resource",
+		"description": "Read LinkedIn chats, chat messages, and profile-to-chat lookups.",
+		"unit": "per_resource",
 		"unitPriceUSD": .01,
 		"featureId": "dm_event_read_resource"
 	},
 	{
 		"key": "post_create",
 		"label": "Post: Create",
-		"description": "Creating posts. Charged per request.",
-		"unit": "request",
+		"description": "Create a simple LinkedIn post without a detected URL.",
+		"unit": "per_request",
 		"unitPriceUSD": .015,
 		"featureId": "content_create_request"
 	},
 	{
 		"key": "content_create",
 		"label": "Content: Create",
-		"description": "Summoned replies/quotes (replying to a post where you were mentioned). Charged per request.",
-		"unit": "request",
+		"description": "Create LinkedIn comments or other lower-cost content writes.",
+		"unit": "per_request",
 		"unitPriceUSD": .01,
 		"featureId": "content_create_request"
 	},
 	{
 		"key": "content_create_with_url",
 		"label": "Content: Create with URL",
-		"description": "Creating content with URL. Charged per request.",
-		"unit": "request",
+		"description": "Create a LinkedIn post when URL presence is unknown or detected, priced conservatively.",
+		"unit": "per_request",
 		"unitPriceUSD": .2,
 		"featureId": "content_create_with_url_request"
 	},
 	{
 		"key": "dm_interaction_create",
 		"label": "DM Interaction: Create",
-		"description": "Creating DM interactions. Charged per request.",
-		"unit": "request",
+		"description": "Send, modify, delete, or mark LinkedIn chat messages and chat state.",
+		"unit": "per_request",
 		"unitPriceUSD": .015,
 		"featureId": "dm_interaction_create_request"
 	},
 	{
 		"key": "user_interaction_create",
 		"label": "User Interaction: Create",
-		"description": "Creating user interactions. Charged per request.",
-		"unit": "request",
+		"description": "Create LinkedIn reactions, connection requests, and relation-request state changes.",
+		"unit": "per_request",
 		"unitPriceUSD": .015,
 		"featureId": "user_interaction_create_request"
 	},
-	{
-		"key": "list_read",
-		"label": "List: Read",
-		"description": "Charged per resource fetched.",
-		"unit": "resource",
-		"unitPriceUSD": .005,
-		"featureId": "list_read_resource"
-	},
-	{
-		"key": "space_read",
-		"label": "Space: Read",
-		"description": "Charged per resource fetched.",
-		"unit": "resource",
-		"unitPriceUSD": .005,
-		"featureId": "space_read_resource"
-	},
-	{
-		"key": "community_read",
-		"label": "Community: Read",
-		"description": "Charged per resource fetched.",
-		"unit": "resource",
-		"unitPriceUSD": .005,
-		"featureId": "community_read_resource"
-	},
-	{
-		"key": "note_read",
-		"label": "Note: Read",
-		"description": "Charged per resource fetched.",
-		"unit": "resource",
-		"unitPriceUSD": .005,
-		"featureId": "note_read_resource"
-	},
-	{
-		"key": "following_read",
-		"label": "Following/Followers: Read",
-		"description": "Charged per resource fetched for both following and followers.",
-		"unit": "resource",
-		"unitPriceUSD": .01,
-		"featureId": "following_followers_read_resource"
-	},
-	{
-		"key": "media_read",
-		"label": "Media: Read",
-		"description": "Charged per resource fetched.",
-		"unit": "resource",
-		"unitPriceUSD": .005,
-		"featureId": "media_read_resource"
-	},
-	{
-		"key": "analytics_read",
-		"label": "Analytics: Read",
-		"description": "Charged per resource fetched.",
-		"unit": "resource",
-		"unitPriceUSD": .005,
-		"featureId": "analytics_read_resource"
-	},
-	{
-		"key": "trend_read",
-		"label": "Trend: Read",
-		"description": "Fetching trends. Charged per resource fetched.",
-		"unit": "resource",
-		"unitPriceUSD": .01,
-		"featureId": "trend_read_resource"
-	},
 	{
 		"key": "owned_read",
 		"label": "Owned: Read",
-		"description": "Charged per resource fetched.",
-		"unit": "resource",
+		"description": "Read the connected LinkedIn account's own profile or first-party relation data.",
+		"unit": "per_resource",
 		"unitPriceUSD": .001,
 		"featureId": "owned_read_resource"
-	},
-	{
-		"key": "interaction_delete",
-		"label": "Interaction: Delete",
-		"description": "Deleting interactions. Charged per request.",
-		"unit": "request",
-		"unitPriceUSD": .01,
-		"featureId": "interaction_delete_request"
-	},
-	{
-		"key": "content_manage",
-		"label": "Content: Manage",
-		"description": "Managing content (deleting or hiding posts). Charged per request.",
-		"unit": "request",
-		"unitPriceUSD": .005,
-		"featureId": "content_manage_request"
-	},
-	{
-		"key": "list_create",
-		"label": "List: Create",
-		"description": "Creating lists. Charged per request.",
-		"unit": "request",
-		"unitPriceUSD": .01,
-		"featureId": "list_create_request"
-	},
-	{
-		"key": "list_manage",
-		"label": "List: Manage",
-		"description": "Managing lists (deleting or updating). Charged per request.",
-		"unit": "request",
-		"unitPriceUSD": .005,
-		"featureId": "list_manage_request"
-	},
-	{
-		"key": "bookmark",
-		"label": "Bookmark",
-		"description": "Creating bookmarks. Charged per request.",
-		"unit": "request",
-		"unitPriceUSD": .005,
-		"featureId": "bookmark_request"
-	},
-	{
-		"key": "media_metadata",
-		"label": "Media Metadata",
-		"description": "Creating/deleting media metadata. Charged per request.",
-		"unit": "request",
-		"unitPriceUSD": .005,
-		"featureId": "media_metadata_request"
-	},
-	{
-		"key": "privacy_update",
-		"label": "Privacy: Update",
-		"description": "Updating privacy settings. Charged per request.",
-		"unit": "request",
-		"unitPriceUSD": .01,
-		"featureId": "privacy_update_request"
-	},
-	{
-		"key": "mute_delete",
-		"label": "Mute: Delete",
-		"description": "Deleting mutes. Charged per request.",
-		"unit": "request",
-		"unitPriceUSD": .005,
-		"featureId": "mute_delete_request"
-	},
-	{
-		"key": "counts_recent",
-		"label": "Counts: Recent",
-		"description": "Fetching recent counts. Charged per request.",
-		"unit": "request",
-		"unitPriceUSD": .005,
-		"featureId": "counts_recent_request"
-	},
-	{
-		"key": "counts_all",
-		"label": "Counts: All",
-		"description": "Fetching all counts. Charged per request.",
-		"unit": "request",
-		"unitPriceUSD": .01,
-		"featureId": "counts_all_request"
 	}
 ]);
 const LINKEDIN_OPERATIONS = [
@@ -13561,7 +13417,7 @@ const defineOperationCommand$1 = (op, deps) => {
 const DM_INTERACTION_BILLING_CATEGORY = "dm_interaction_create";
 const DM_INTERACTION_ENDPOINT_BILLING = {
 	billingCategory: DM_INTERACTION_BILLING_CATEGORY,
-	costBPS: costBPSForCategory(DM_INTERACTION_BILLING_CATEGORY)
+	costBPS: costBPSForCategory$1(DM_INTERACTION_BILLING_CATEGORY)
 };
 const isRecord$5 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const groupDescriptions = {
@@ -14380,6 +14236,226 @@ createLinkedinCommands({
 	resolveAccountId: unconfigured$1,
 	resolveOwnLinkedinAccount: unconfigured$1
 });
+//#endregion
+//#region ../../packages/x/src/pricing.ts
+const { costBPSForCategory } = createPricing([
+	{
+		"key": "posts_read",
+		"label": "Posts: Read",
+		"description": "Charged per resource fetched.",
+		"unit": "resource",
+		"unitPriceUSD": .005,
+		"featureId": "post_read_resource"
+	},
+	{
+		"key": "user_read",
+		"label": "User: Read",
+		"description": "Charged per resource fetched.",
+		"unit": "resource",
+		"unitPriceUSD": .01,
+		"featureId": "user_read_resource"
+	},
+	{
+		"key": "dm_event_read",
+		"label": "DM Event: Read",
+		"description": "Charged per resource fetched.",
+		"unit": "resource",
+		"unitPriceUSD": .01,
+		"featureId": "dm_event_read_resource"
+	},
+	{
+		"key": "post_create",
+		"label": "Post: Create",
+		"description": "Creating posts. Charged per request.",
+		"unit": "request",
+		"unitPriceUSD": .015,
+		"featureId": "content_create_request"
+	},
+	{
+		"key": "content_create",
+		"label": "Content: Create",
+		"description": "Summoned replies/quotes (replying to a post where you were mentioned). Charged per request.",
+		"unit": "request",
+		"unitPriceUSD": .01,
+		"featureId": "content_create_request"
+	},
+	{
+		"key": "content_create_with_url",
+		"label": "Content: Create with URL",
+		"description": "Creating content with URL. Charged per request.",
+		"unit": "request",
+		"unitPriceUSD": .2,
+		"featureId": "content_create_with_url_request"
+	},
+	{
+		"key": "dm_interaction_create",
+		"label": "DM Interaction: Create",
+		"description": "Creating DM interactions. Charged per request.",
+		"unit": "request",
+		"unitPriceUSD": .015,
+		"featureId": "dm_interaction_create_request"
+	},
+	{
+		"key": "user_interaction_create",
+		"label": "User Interaction: Create",
+		"description": "Creating user interactions. Charged per request.",
+		"unit": "request",
+		"unitPriceUSD": .015,
+		"featureId": "user_interaction_create_request"
+	},
+	{
+		"key": "list_read",
+		"label": "List: Read",
+		"description": "Charged per resource fetched.",
+		"unit": "resource",
+		"unitPriceUSD": .005,
+		"featureId": "list_read_resource"
+	},
+	{
+		"key": "space_read",
+		"label": "Space: Read",
+		"description": "Charged per resource fetched.",
+		"unit": "resource",
+		"unitPriceUSD": .005,
+		"featureId": "space_read_resource"
+	},
+	{
+		"key": "community_read",
+		"label": "Community: Read",
+		"description": "Charged per resource fetched.",
+		"unit": "resource",
+		"unitPriceUSD": .005,
+		"featureId": "community_read_resource"
+	},
+	{
+		"key": "note_read",
+		"label": "Note: Read",
+		"description": "Charged per resource fetched.",
+		"unit": "resource",
+		"unitPriceUSD": .005,
+		"featureId": "note_read_resource"
+	},
+	{
+		"key": "following_read",
+		"label": "Following/Followers: Read",
+		"description": "Charged per resource fetched for both following and followers.",
+		"unit": "resource",
+		"unitPriceUSD": .01,
+		"featureId": "following_followers_read_resource"
+	},
+	{
+		"key": "media_read",
+		"label": "Media: Read",
+		"description": "Charged per resource fetched.",
+		"unit": "resource",
+		"unitPriceUSD": .005,
+		"featureId": "media_read_resource"
+	},
+	{
+		"key": "analytics_read",
+		"label": "Analytics: Read",
+		"description": "Charged per resource fetched.",
+		"unit": "resource",
+		"unitPriceUSD": .005,
+		"featureId": "analytics_read_resource"
+	},
+	{
+		"key": "trend_read",
+		"label": "Trend: Read",
+		"description": "Fetching trends. Charged per resource fetched.",
+		"unit": "resource",
+		"unitPriceUSD": .01,
+		"featureId": "trend_read_resource"
+	},
+	{
+		"key": "owned_read",
+		"label": "Owned: Read",
+		"description": "Charged per resource fetched.",
+		"unit": "resource",
+		"unitPriceUSD": .001,
+		"featureId": "owned_read_resource"
+	},
+	{
+		"key": "interaction_delete",
+		"label": "Interaction: Delete",
+		"description": "Deleting interactions. Charged per request.",
+		"unit": "request",
+		"unitPriceUSD": .01,
+		"featureId": "interaction_delete_request"
+	},
+	{
+		"key": "content_manage",
+		"label": "Content: Manage",
+		"description": "Managing content (deleting or hiding posts). Charged per request.",
+		"unit": "request",
+		"unitPriceUSD": .005,
+		"featureId": "content_manage_request"
+	},
+	{
+		"key": "list_create",
+		"label": "List: Create",
+		"description": "Creating lists. Charged per request.",
+		"unit": "request",
+		"unitPriceUSD": .01,
+		"featureId": "list_create_request"
+	},
+	{
+		"key": "list_manage",
+		"label": "List: Manage",
+		"description": "Managing lists (deleting or updating). Charged per request.",
+		"unit": "request",
+		"unitPriceUSD": .005,
+		"featureId": "list_manage_request"
+	},
+	{
+		"key": "bookmark",
+		"label": "Bookmark",
+		"description": "Creating bookmarks. Charged per request.",
+		"unit": "request",
+		"unitPriceUSD": .005,
+		"featureId": "bookmark_request"
+	},
+	{
+		"key": "media_metadata",
+		"label": "Media Metadata",
+		"description": "Creating/deleting media metadata. Charged per request.",
+		"unit": "request",
+		"unitPriceUSD": .005,
+		"featureId": "media_metadata_request"
+	},
+	{
+		"key": "privacy_update",
+		"label": "Privacy: Update",
+		"description": "Updating privacy settings. Charged per request.",
+		"unit": "request",
+		"unitPriceUSD": .01,
+		"featureId": "privacy_update_request"
+	},
+	{
+		"key": "mute_delete",
+		"label": "Mute: Delete",
+		"description": "Deleting mutes. Charged per request.",
+		"unit": "request",
+		"unitPriceUSD": .005,
+		"featureId": "mute_delete_request"
+	},
+	{
+		"key": "counts_recent",
+		"label": "Counts: Recent",
+		"description": "Fetching recent counts. Charged per request.",
+		"unit": "request",
+		"unitPriceUSD": .005,
+		"featureId": "counts_recent_request"
+	},
+	{
+		"key": "counts_all",
+		"label": "Counts: All",
+		"description": "Fetching all counts. Charged per request.",
+		"unit": "request",
+		"unitPriceUSD": .01,
+		"featureId": "counts_all_request"
+	}
+]);
 const X_OPERATIONS = [
 	{
 		schemaBaseName: "TweetsDelete",
@@ -16120,12 +16196,23 @@ const X_OPERATIONS = [
 //#endregion
 //#region ../../packages/x/src/cache.ts
 const xCacheableEndpointPaths = [
+	"GET /lists/:id/members",
 	"GET /tweets",
 	"GET /tweets/:id",
+	"GET /tweets/:id/liking_users",
+	"GET /tweets/:id/quote_tweets",
+	"GET /tweets/:id/retweeted_by",
 	"GET /tweets/search/recent",
+	"GET /users/:id",
+	"GET /users/:id/bookmarks",
 	"GET /users/:id/followers",
 	"GET /users/:id/following",
+	"GET /users/:id/liked_tweets",
+	"GET /users/:id/mentions",
+	"GET /users/:id/owned_lists",
+	"GET /users/:id/timelines/reverse_chronological",
 	"GET /users/:id/tweets",
+	"GET /users/by/username/:username",
 	"GET /users/me"
 ];
 const schemas = {
@@ -17919,8 +18006,9 @@ const CONNECTED_STATUS = "connected";
 const LEADING_AT_PATTERN$1 = /^@+/;
 const LINKEDIN_PROFILE_HOST_PATTERN = /(^|\.)linkedin\.com$/i;
 const isInteractiveTerminal$1 = (deps) => deps.isInteractiveTerminal?.() ?? process.stdout.isTTY === true;
-const openURL = async (deps, url) => {
-	(deps.log ?? console.error)(`Opening ${url}`);
+const openURL = async (deps, url, options = {}) => {
+	const log = deps.log ?? console.error;
+	if (options.log ?? true) log(`Opening ${url}`);
 	if (!(isInteractiveTerminal$1(deps) && deps.openURL)) return {
 		opened: false,
 		url
@@ -17998,6 +18086,10 @@ const pollForAccount$1 = async (deps, predicate, errorMessage) => {
 	}
 	throw new Error(errorMessage);
 };
+const authURLFor$1 = async (deps, operation) => ({
+	url: deps.handshakeAuthURL ? await deps.handshakeAuthURL(operation) : await operation(),
+	openingLogged: deps.handshakeAuthURL !== void 0
+});
 const accountForIdentifier = async (deps, identifier) => {
 	const target = linkedinReconnectTargetFrom(identifier);
 	const account = (await listLinkedinLifecycleAccounts(deps)).find((candidate) => accountMatchesReconnectTarget(candidate, target));
@@ -18014,10 +18106,11 @@ const connectLinkedinAccount = async (deps) => {
 	await prepareAccountConnect$1(deps);
 	const before = await listLinkedinLifecycleAccounts(deps);
 	const existingProfileIds = new Set(before.map((account) => account.profileId));
-	await openURL(deps, (await deps.client.createHostedAuthURL({
+	const authURL = await authURLFor$1(deps, async () => (await deps.client.createHostedAuthURL({
 		platform: LINKEDIN_PLATFORM,
 		mode: "create"
 	})).url);
+	await openURL(deps, authURL.url, { log: !authURL.openingLogged });
 	return {
 		platform: LINKEDIN_PLATFORM,
 		status: "connected",
@@ -18026,11 +18119,12 @@ const connectLinkedinAccount = async (deps) => {
 };
 const reconnectLinkedinAccount = async (deps, identifier) => {
 	const account = await reconnectAccountForIdentifier(deps, identifier);
-	await openURL(deps, (await deps.client.createHostedAuthURL({
+	const authURL = await authURLFor$1(deps, async () => (await deps.client.createHostedAuthURL({
 		platform: LINKEDIN_PLATFORM,
 		mode: "reconnect",
 		account: reconnectCommandTargetFor(account)
 	})).url);
+	await openURL(deps, authURL.url, { log: !authURL.openingLogged });
 	return {
 		platform: LINKEDIN_PLATFORM,
 		status: "connected",
@@ -18078,8 +18172,9 @@ const connectURLFor = async (deps, reconnectProfileId) => {
 	return url.toString();
 };
 const isInteractiveTerminal = (deps) => deps.isInteractiveTerminal?.() ?? process.stdout.isTTY === true;
-const openOrPrint = async (deps, url) => {
-	(deps.log ?? console.error)(`Opening ${url}`);
+const openOrPrint = async (deps, url, options = {}) => {
+	const log = deps.log ?? console.error;
+	if (options.log ?? true) log(`Opening ${url}`);
 	if (!(isInteractiveTerminal(deps) && deps.openBrowser)) return;
 	await deps.openBrowser(url);
 };
@@ -18097,6 +18192,10 @@ const pollForAccount = async (deps, matches) => {
 	}
 	throw new Error("x_connect_timed_out");
 };
+const authURLFor = async (deps, operation) => ({
+	url: deps.handshakeAuthURL ? await deps.handshakeAuthURL(operation) : await operation(),
+	openingLogged: deps.handshakeAuthURL !== void 0
+});
 const pollForSeat$1 = async (deps) => {
 	const sleep = deps.sleep ?? defaultSleep;
 	const now = deps.now ?? Date.now;
@@ -18143,7 +18242,8 @@ const connectXAccount = async (deps) => {
 	const before = await listXLifecycleAccounts(deps, true);
 	const connectedBefore = new Set(before.filter((account) => account.status === "connected").map(accountKey));
 	await prepareAccountConnect(deps);
-	await openOrPrint(deps, await connectURLFor(deps));
+	const authURL = await authURLFor(deps, () => connectURLFor(deps));
+	await openOrPrint(deps, authURL.url, { log: !authURL.openingLogged });
 	return {
 		platform: "x",
 		status: "connected",
@@ -18154,7 +18254,8 @@ const reconnectXAccount = async (deps, args) => {
 	assertXAccountSelector(args.account);
 	const existing = findAccount(await listXLifecycleAccounts(deps, true), args.account);
 	if (!existing) throw new Error("x_account_not_found");
-	await openOrPrint(deps, await connectURLFor(deps, existing.profileId));
+	const authURL = await authURLFor(deps, () => connectURLFor(deps, existing.profileId));
+	await openOrPrint(deps, authURL.url, { log: !authURL.openingLogged });
 	return {
 		platform: "x",
 		status: "connected",
@@ -20739,6 +20840,9 @@ const createInstance = (defaults) => {
 };
 const ky = createInstance();
 //#endregion
+//#region package.json
+var version$1 = "0.2.3";
+//#endregion
 //#region src/lib/env.ts
 const URLWithTrailingSlash = url().transform(ensureTrailingSlash);
 const env = createEnv({
@@ -20767,7 +20871,7 @@ const env = createEnv({
 	}
 });
 const SERVICE_NAME = "social-cli";
-const VERSION = "0.2.1";
+const VERSION = version$1;
 const apiURL = (path) => createAbsoluteURL(env.SOCIAL_API_URL, path);
 //#endregion
 //#region src/lib/bearer.ts
@@ -27830,12 +27934,30 @@ const lifecycleConnectContract = {
 	confirmation: false
 };
 const handleFor = (account) => account.handle.startsWith("@") ? account.handle : `@${account.handle}`;
+const authHandshakeMessage = "Handshaking auth...";
 const lifecycleDepsWithTextLogs = (deps) => ({
 	...deps,
-	log: (message) => writeText(deps, message)
+	log: (message) => writeText(deps, message),
+	handshakeAuthURL: async (operation) => {
+		if (deps.ui) {
+			const spinner = deps.ui.spinner();
+			spinner.start(authHandshakeMessage);
+			try {
+				const url = await operation();
+				spinner.stop(`Opening ${url}`);
+				return url;
+			} catch (error) {
+				spinner.error(authHandshakeMessage);
+				throw error;
+			}
+		}
+		writeText(deps, authHandshakeMessage);
+		const url = await operation();
+		writeText(deps, `Opening ${url}`);
+		return url;
+	}
 });
 const runConnectOutput = async (deps, connect) => {
-	writeText(deps, "Handshaking auth...");
 	writeText(deps, `${handleFor((await connect(lifecycleDepsWithTextLogs(deps))).account)} connected!`);
 };
 const createConnectPlatformCommand = (platform, run) => defineCommand({
@@ -28216,7 +28338,8 @@ const createCLIDeps = () => {
 				url
 			};
 		},
-		writeOutput: printData
+		writeOutput: printData,
+		ui: createUI(process.stdout.isTTY === true)
 	};
 };
 //#endregion

package/package.json

@@ -11,7 +11,7 @@
     "access": "public"
   },
   "private": false,
-  "version": "0.2.1",
+  "version": "0.2.3",
   "type": "module",
   "engines": {
     "node": ">=22.5.0"