@usesocial/cli 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @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

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 = {
@@ -20753,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({
@@ -20781,7 +20871,7 @@ const env = createEnv({
 	}
 });
 const SERVICE_NAME = "social-cli";
-const VERSION = "0.2.2";
+const VERSION = version$1;
 const apiURL = (path) => createAbsoluteURL(env.SOCIAL_API_URL, path);
 //#endregion
 //#region src/lib/bearer.ts

package/package.json

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