@usesocial/cli 0.2.6 → 0.3.0

package/dist/index.mjs

@@ -130,13 +130,13 @@ var CancelledError = class extends Error {
 	}
 };
 //#endregion
-//#region ../../packages/local-sqlite/src/migrations.generated.ts
+//#region ../../packages/sync-engine/src/migrations.generated.ts
 const MIGRATIONS = [{
 	"tag": "0000_modern_stephen_strange",
 	"sql": "CREATE TABLE `li_connections` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`object` text,\n	`url` text,\n	`user_id` text,\n	`user_object` text,\n	`user_type` text,\n	`user_display_name` text,\n	`user_public_identifier` text,\n	`user_profile_url` text,\n	`user_public_picture_url` text,\n	`user_description` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `li_connections_created_at_idx` ON `li_connections` (`created_at`);--> statement-breakpoint\nCREATE TABLE `li_conversations` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`last_message_timestamp` integer,\n	`muted_until` integer,\n	`creator_id` text,\n	`headline` text,\n	`image_url` text,\n	`name` text,\n	`object` text,\n	`provider` text,\n	`type` text,\n	`user_id` text,\n	`is_1to1` integer,\n	`is_archived` integer,\n	`is_channel` integer,\n	`is_group` integer,\n	`is_pinned` integer,\n	`is_readonly` integer,\n	`unread_count` integer,\n	`user_object` text,\n	`user_type` text,\n	`user_display_name` text,\n	`user_public_identifier` text,\n	`user_profile_url` text,\n	`user_public_picture_url` text,\n	`user_description` text,\n	`user_specifics_network_distance` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `li_conversations_created_at_idx` ON `li_conversations` (`created_at`);--> statement-breakpoint\nCREATE INDEX `li_conversations_last_message_timestamp_idx` ON `li_conversations` (`last_message_timestamp`);--> statement-breakpoint\nCREATE TABLE `li_messages` (\n	`id` text PRIMARY KEY NOT NULL,\n	`timestamp` integer,\n	`chat_id` text,\n	`object` text,\n	`provider` text,\n	`text` text,\n	`sender_id` text,\n	`is_deleted` integer,\n	`is_delivered` integer,\n	`is_edited` integer,\n	`is_event` integer,\n	`is_hidden` integer,\n	`is_mentionned` integer,\n	`is_pinned` integer,\n	`is_seen` integer,\n	`is_sender` integer,\n	`sender_object` text,\n	`sender_type` text,\n	`sender_display_name` text,\n	`sender_public_identifier` text,\n	`sender_profile_url` text,\n	`sender_public_picture_url` text,\n	`sender_description` text,\n	`sender_specifics_network_distance` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `li_messages_timestamp_idx` ON `li_messages` (`timestamp`);--> statement-breakpoint\nCREATE INDEX `li_messages_chat_id_idx` ON `li_messages` (`chat_id`);--> statement-breakpoint\nCREATE TABLE `li_posts` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`object` text,\n	`share_url` text,\n	`text` text,\n	`url` text,\n	`is_repost` integer,\n	`user_reacted` text,\n	`comments_counter` integer,\n	`reposts_counter` integer,\n	`analytics_impressions_counter` integer,\n	`author_id` text,\n	`author_object` text,\n	`author_type` text,\n	`author_display_name` text,\n	`author_public_identifier` text,\n	`author_profile_url` text,\n	`author_public_picture_url` text,\n	`author_description` text,\n	`author_specifics_network_distance` text,\n	`permissions_can_post_comments` integer,\n	`permissions_can_react` integer,\n	`permissions_can_share` integer,\n	`poll_id` text,\n	`poll_question` text,\n	`poll_is_open` integer,\n	`poll_total_votes_count` integer,\n	`quoted_post_id` text,\n	`quoted_post_object` text,\n	`quoted_post_created_at` integer,\n	`quoted_post_text` text,\n	`quoted_post_share_url` text,\n	`quoted_post_user_reacted` text,\n	`quoted_post_comments_counter` integer,\n	`quoted_post_reposts_counter` integer,\n	`quoted_post_permissions_can_post_comments` integer,\n	`quoted_post_permissions_can_react` integer,\n	`quoted_post_permissions_can_share` integer,\n	`quoted_post_author_id` text,\n	`quoted_post_author_object` text,\n	`quoted_post_author_type` text,\n	`quoted_post_author_display_name` text,\n	`quoted_post_author_public_identifier` text,\n	`quoted_post_author_profile_url` text,\n	`quoted_post_author_public_picture_url` text,\n	`quoted_post_author_description` text,\n	`quoted_post_author_specifics_network_distance` text,\n	`reposted_by_id` text,\n	`reposted_by_object` text,\n	`reposted_by_type` text,\n	`reposted_by_display_name` text,\n	`reposted_by_public_identifier` text,\n	`reposted_by_profile_url` text,\n	`reposted_by_public_picture_url` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `li_posts_created_at_idx` ON `li_posts` (`created_at`);--> statement-breakpoint\nCREATE TABLE `li_requests` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`object` text,\n	`type` text,\n	`user_id` text,\n	`user_object` text,\n	`user_type` text,\n	`user_display_name` text,\n	`user_public_identifier` text,\n	`user_profile_url` text,\n	`user_public_picture_url` text,\n	`user_description` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `li_requests_created_at_idx` ON `li_requests` (`created_at`);--> statement-breakpoint\nCREATE TABLE `sync_state` (\n	`collection` text PRIMARY KEY NOT NULL,\n	`cursor` text,\n	`last_synced` integer,\n	`object_count` integer\n);\n--> statement-breakpoint\nCREATE TABLE `x_bookmarks` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`author_id` text,\n	`conversation_id` text,\n	`in_reply_to_user_id` text,\n	`lang` text,\n	`reply_settings` text,\n	`text` text,\n	`url` text,\n	`paid_partnership` integer,\n	`possibly_sensitive` integer,\n	`edit_controls_editable_until` integer,\n	`edit_controls_edits_remaining` integer,\n	`edit_controls_is_edit_eligible` integer,\n	`like_count` integer,\n	`retweet_count` integer,\n	`reply_count` integer,\n	`quote_count` integer,\n	`bookmark_count` integer,\n	`impression_count` integer,\n	`article_cover_media` text,\n	`article_plain_text` text,\n	`article_preview_text` text,\n	`article_title` text,\n	`note_tweet_text` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `x_bookmarks_created_at_idx` ON `x_bookmarks` (`created_at`);--> statement-breakpoint\nCREATE TABLE `x_followers` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`username` text,\n	`name` text,\n	`description` text,\n	`location` text,\n	`url` text,\n	`is_identity_verified` integer,\n	`protected` integer,\n	`verified` integer,\n	`verified_type` text,\n	`subscription_type` text,\n	`parody` integer,\n	`most_recent_tweet_id` text,\n	`pinned_tweet_id` text,\n	`profile_banner_url` text,\n	`profile_image_url` text,\n	`affiliation_badge_url` text,\n	`affiliation_description` text,\n	`affiliation_url` text,\n	`subscription_subscribes_to_you` integer,\n	`followers_count` integer,\n	`following_count` integer,\n	`tweet_count` integer,\n	`listed_count` integer,\n	`like_count` integer,\n	`media_count` integer,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `x_followers_created_at_idx` ON `x_followers` (`created_at`);--> statement-breakpoint\nCREATE TABLE `x_following` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`username` text,\n	`name` text,\n	`description` text,\n	`location` text,\n	`url` text,\n	`is_identity_verified` integer,\n	`protected` integer,\n	`verified` integer,\n	`verified_type` text,\n	`subscription_type` text,\n	`parody` integer,\n	`most_recent_tweet_id` text,\n	`pinned_tweet_id` text,\n	`profile_banner_url` text,\n	`profile_image_url` text,\n	`affiliation_badge_url` text,\n	`affiliation_description` text,\n	`affiliation_url` text,\n	`subscription_subscribes_to_you` integer,\n	`followers_count` integer,\n	`following_count` integer,\n	`tweet_count` integer,\n	`listed_count` integer,\n	`like_count` integer,\n	`media_count` integer,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `x_following_created_at_idx` ON `x_following` (`created_at`);--> statement-breakpoint\nCREATE TABLE `x_tweets` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`author_id` text,\n	`conversation_id` text,\n	`in_reply_to_user_id` text,\n	`lang` text,\n	`reply_settings` text,\n	`text` text,\n	`url` text,\n	`paid_partnership` integer,\n	`possibly_sensitive` integer,\n	`edit_controls_editable_until` integer,\n	`edit_controls_edits_remaining` integer,\n	`edit_controls_is_edit_eligible` integer,\n	`like_count` integer,\n	`retweet_count` integer,\n	`reply_count` integer,\n	`quote_count` integer,\n	`bookmark_count` integer,\n	`impression_count` integer,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `x_tweets_created_at_idx` ON `x_tweets` (`created_at`);"
 }];
 //#endregion
-//#region ../../packages/local-sqlite/src/migrate.ts
+//#region ../../packages/sync-engine/src/migrate.ts
 const readUserVersion = (db) => {
 	const version = db.prepare("PRAGMA user_version").get()?.user_version;
 	return typeof version === "number" ? version : Number(version ?? 0);
@@ -161,7 +161,7 @@ const assertAtLatest = (db) => {
 	if (currentVersion < MIGRATIONS.length) throw new Error(`Local SQLite cache schema is at version ${currentVersion}; expected ${MIGRATIONS.length}`);
 };
 //#endregion
-//#region ../../packages/local-sqlite/src/sqlite.ts
+//#region ../../packages/sync-engine/src/sqlite.ts
 const loadModule = createRequire(import.meta.url);
 const isBunRuntime = () => typeof Bun !== "undefined";
 const normalizeValue = (value) => {
@@ -219,7 +219,7 @@ const openDatabase = (path, opts) => {
 	};
 };
 //#endregion
-//#region ../../packages/local-sqlite/src/cache.ts
+//#region ../../packages/sync-engine/src/cache.ts
 const cacheTables = new Set([
 	"x_tweets",
 	"x_followers",
@@ -307,8 +307,8 @@ const createCache = (path, db) => ({
 	}
 });
 //#endregion
-//#region ../../packages/local-sqlite/src/collections/linkedin.ts
-const linkedinPagination = {
+//#region ../../packages/sync-engine/src/collections/linkedin.ts
+const linkedinCursorPagination = {
 	style: "cursor",
 	limitParam: "limit",
 	cursorParam: "cursor",
@@ -316,6 +316,13 @@ const linkedinPagination = {
 	totalCountPath: "total_count",
 	itemsPath: "data"
 };
+const linkedinOffsetPagination = {
+	style: "offset",
+	limitParam: "limit",
+	offsetParam: "offset",
+	totalCountPath: "total_count",
+	itemsPath: "data"
+};
 const asRecord$1 = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
 const read$1 = (value) => value === null || value === void 0 ? null : value;
 const readReaction = (value) => typeof value === "string" ? value : null;
@@ -504,7 +511,7 @@ const LINKEDIN_COLLECTIONS = [
 		key: "li_conversations",
 		platform: "linkedin",
 		requests: [{ path: "/chats" }],
-		pagination: linkedinPagination,
+		pagination: linkedinCursorPagination,
 		pageSize: 20,
 		estCostBPS: 100,
 		estUnitsPerPage: 10,
@@ -517,7 +524,7 @@ const LINKEDIN_COLLECTIONS = [
 		requests: [{ path: "/chats/:chat_id/messages" }],
 		parentCollection: "li_conversations",
 		parentIdToken: ":chat_id",
-		pagination: linkedinPagination,
+		pagination: linkedinCursorPagination,
 		pageSize: 250,
 		estCostBPS: 100,
 		estUnitsPerPage: 5,
@@ -528,7 +535,7 @@ const LINKEDIN_COLLECTIONS = [
 		key: "li_connections",
 		platform: "linkedin",
 		requests: [{ path: "/users/connections" }],
-		pagination: linkedinPagination,
+		pagination: linkedinCursorPagination,
 		pageSize: 100,
 		estCostBPS: 10,
 		estUnitsPerPage: 100,
@@ -540,7 +547,7 @@ const LINKEDIN_COLLECTIONS = [
 		platform: "linkedin",
 		requests: [{ path: "/users/:identifier/posts" }],
 		ownIdToken: ":identifier",
-		pagination: linkedinPagination,
+		pagination: linkedinCursorPagination,
 		pageSize: 50,
 		estCostBPS: 50,
 		estUnitsPerPage: 50,
@@ -557,7 +564,7 @@ const LINKEDIN_COLLECTIONS = [
 			path: "/users/me/relation-requests/sent",
 			bakedQuery: { type: "sent" }
 		}],
-		pagination: linkedinPagination,
+		pagination: linkedinOffsetPagination,
 		pageSize: 100,
 		estCostBPS: 100,
 		estUnitsPerPage: 100,
@@ -565,7 +572,7 @@ const LINKEDIN_COLLECTIONS = [
 	}
 ];
 //#endregion
-//#region ../../packages/local-sqlite/src/collections/x.ts
+//#region ../../packages/sync-engine/src/collections/x.ts
 const xPagination = {
 	style: "cursor",
 	limitParam: "max_results",
@@ -664,7 +671,7 @@ const liftXUser = (item) => {
 	};
 };
 //#endregion
-//#region ../../packages/local-sqlite/src/collections/index.ts
+//#region ../../packages/sync-engine/src/collections/index.ts
 const COLLECTIONS = [...[
 	{
 		key: "x_tweets",
@@ -9753,7 +9760,7 @@ const createPricing = (resources) => {
 	};
 };
 //#endregion
-//#region ../../packages/local-sqlite/src/cost.ts
+//#region ../../packages/sync-engine/src/cost.ts
 const creditsToUSD = (credits) => credits / 1e3;
 const usdToCredits = (usd) => Math.round(usd * 1e3);
 const estimatePageCredits = (estCostBPS, estUnitsPerPage) => creditsForBPS(billedBPSFor(estCostBPS * estUnitsPerPage));
@@ -10352,7 +10359,7 @@ function index(name) {
 	return new IndexBuilderOn(name, false);
 }
 //#endregion
-//#region ../../packages/local-sqlite/src/schema.ts
+//#region ../../packages/sync-engine/src/schema.ts
 const idColumn = () => text("id").primaryKey();
 const rawColumns = () => ({
 	raw: text("raw").notNull(),
@@ -10592,7 +10599,7 @@ sqliteTable("sync_state", {
 	objectCount: integer("object_count")
 });
 //#endregion
-//#region ../../packages/local-sqlite/src/since.ts
+//#region ../../packages/sync-engine/src/since.ts
 const durationPattern = /^(\d+):(hours|days|weeks)$/;
 const isoPattern = /^\d{4}-\d{2}-\d{2}(?:T\d{2}:\d{2}:\d{2}Z)?$/;
 const unitMs = {
@@ -10645,10 +10652,11 @@ const substitutePath = (path, args) => {
 	if (args.parentIdToken && args.chatId !== void 0) resolved = resolved.replaceAll(args.parentIdToken, args.chatId);
 	return resolved;
 };
-const buildQuery = (pagination, pageSize, cursor, bakedQuery) => {
+const buildQuery = (pagination, pageSize, cursor, offset, bakedQuery) => {
 	const params = new URLSearchParams();
 	if (pagination.style !== "none" && pagination.limitParam) params.set(pagination.limitParam, String(pageSize));
 	if (pagination.style !== "none" && cursor && pagination.cursorParam) params.set(pagination.cursorParam, cursor);
+	if (pagination.style === "offset" && pagination.offsetParam) params.set(pagination.offsetParam, String(offset));
 	for (const [key, value] of Object.entries(bakedQuery ?? {})) params.set(key, value);
 	const query = params.toString();
 	return query ? `?${query}` : "";
@@ -10690,6 +10698,7 @@ const walkRequest = async (args) => {
 	const checkpoint = args.useCheckpoint ? args.deps.cache.getCursor(args.collection.key)?.cursor ?? null : null;
 	const ids = [];
 	let cursor = null;
+	let offset = 0;
 	let newestId = null;
 	let lastPageCredits = null;
 	let pages = 0;
@@ -10707,7 +10716,7 @@ const walkRequest = async (args) => {
 			ownIdToken: args.collection.ownIdToken,
 			chatId: args.parentId,
 			parentIdToken: args.parentIdToken
-		}) + buildQuery(args.collection.pagination, args.collection.pageSize, cursor, args.request.bakedQuery);
+		}) + buildQuery(args.collection.pagination, args.collection.pageSize, cursor, offset, args.request.bakedQuery);
 		const response = await args.deps.api.get(path, { headers: args.deps.accountHeaders });
 		const credits = creditsFromHeader(response.headers);
 		args.tracker.add(credits);
@@ -10744,6 +10753,15 @@ const walkRequest = async (args) => {
 		args.deps.cache.upsert(args.collection.key, rows);
 		upserted += rows.length;
 		if (hitStop) break;
+		if (args.collection.pagination.style === "offset") {
+			const nextOffset = offset + args.collection.pageSize;
+			if (page.items.length === 0 || page.totalCount != null && nextOffset >= page.totalCount || page.totalCount == null && page.items.length < args.collection.pageSize) {
+				stoppedReason = "complete";
+				break;
+			}
+			offset = nextOffset;
+			continue;
+		}
 		cursor = page.cursor;
 		if (!cursor) {
 			stoppedReason = "complete";
@@ -11442,7 +11460,6 @@ const LINKEDIN_OPERATIONS = [
 				style: "cursor",
 				limitParam: "limit",
 				cursorParam: "cursor",
-				offsetParam: "offset",
 				cursorPath: "next_cursor",
 				totalCountPath: "total_count",
 				itemsPath: "data"
@@ -11557,10 +11574,9 @@ const LINKEDIN_OPERATIONS = [
 			capability: "read",
 			mutates: false,
 			pagination: {
-				style: "cursor",
+				style: "offset",
 				limitParam: "limit",
 				offsetParam: "offset",
-				cursorPath: "next_cursor",
 				totalCountPath: "total_count",
 				itemsPath: "data"
 			},
@@ -11612,11 +11628,9 @@ const LINKEDIN_OPERATIONS = [
 			capability: "read",
 			mutates: false,
 			pagination: {
-				style: "cursor",
+				style: "offset",
 				limitParam: "limit",
-				cursorParam: "cursor",
 				offsetParam: "offset",
-				cursorPath: "next_cursor",
 				totalCountPath: "total_count",
 				itemsPath: "data"
 			},
@@ -11630,7 +11644,7 @@ const LINKEDIN_OPERATIONS = [
 				in: "query",
 				required: false,
 				kind: "integer",
-				description: "An offset used for pagination, if supported by the provider, else use cursor."
+				description: "Pagination offset"
 			},
 			{
 				name: "limit",
@@ -11639,13 +11653,6 @@ const LINKEDIN_OPERATIONS = [
 				kind: "integer",
 				description: "Rows to return (1-100)"
 			},
-			{
-				name: "cursor",
-				in: "query",
-				required: false,
-				kind: "string",
-				description: "Pagination cursor"
-			},
 			{
 				name: "sort_by",
 				in: "query",
@@ -11683,11 +11690,9 @@ const LINKEDIN_OPERATIONS = [
 			capability: "read",
 			mutates: false,
 			pagination: {
-				style: "cursor",
+				style: "offset",
 				limitParam: "limit",
-				cursorParam: "cursor",
 				offsetParam: "offset",
-				cursorPath: "next_cursor",
 				totalCountPath: "total_count",
 				itemsPath: "data"
 			},
@@ -11701,7 +11706,7 @@ const LINKEDIN_OPERATIONS = [
 				in: "query",
 				required: false,
 				kind: "integer",
-				description: "An offset used for pagination, if supported by the provider, else use cursor."
+				description: "Pagination offset"
 			},
 			{
 				name: "limit",
@@ -11710,13 +11715,6 @@ const LINKEDIN_OPERATIONS = [
 				kind: "integer",
 				description: "Rows to return (1-100)"
 			},
-			{
-				name: "cursor",
-				in: "query",
-				required: false,
-				kind: "string",
-				description: "Pagination cursor"
-			},
 			{
 				name: "post_id",
 				in: "path",
@@ -11746,10 +11744,9 @@ const LINKEDIN_OPERATIONS = [
 			capability: "read",
 			mutates: false,
 			pagination: {
-				style: "cursor",
+				style: "offset",
 				limitParam: "limit",
 				offsetParam: "offset",
-				cursorPath: "next_cursor",
 				totalCountPath: "total_count",
 				itemsPath: "data"
 			},
@@ -11800,10 +11797,9 @@ const LINKEDIN_OPERATIONS = [
 			capability: "read",
 			mutates: false,
 			pagination: {
-				style: "cursor",
+				style: "offset",
 				limitParam: "limit",
 				offsetParam: "offset",
-				cursorPath: "next_cursor",
 				totalCountPath: "total_count",
 				itemsPath: "data"
 			},
@@ -11854,10 +11850,9 @@ const LINKEDIN_OPERATIONS = [
 			capability: "read",
 			mutates: false,
 			pagination: {
-				style: "cursor",
+				style: "offset",
 				limitParam: "limit",
 				offsetParam: "offset",
-				cursorPath: "next_cursor",
 				totalCountPath: "total_count",
 				itemsPath: "data"
 			},
@@ -11908,10 +11903,9 @@ const LINKEDIN_OPERATIONS = [
 			capability: "read",
 			mutates: false,
 			pagination: {
-				style: "cursor",
+				style: "offset",
 				limitParam: "limit",
 				offsetParam: "offset",
-				cursorPath: "next_cursor",
 				totalCountPath: "total_count",
 				itemsPath: "data"
 			},
@@ -12013,11 +12007,9 @@ const LINKEDIN_OPERATIONS = [
 			capability: "read",
 			mutates: false,
 			pagination: {
-				style: "cursor",
+				style: "offset",
 				limitParam: "limit",
-				cursorParam: "cursor",
 				offsetParam: "offset",
-				cursorPath: "next_cursor",
 				totalCountPath: "total_count",
 				itemsPath: "data"
 			},
@@ -12031,7 +12023,7 @@ const LINKEDIN_OPERATIONS = [
 				in: "query",
 				required: false,
 				kind: "integer",
-				description: "An offset used for pagination, if supported by the provider, else use cursor."
+				description: "Pagination offset"
 			},
 			{
 				name: "limit",
@@ -12040,13 +12032,6 @@ const LINKEDIN_OPERATIONS = [
 				kind: "integer",
 				description: "The limit of items to be returned."
 			},
-			{
-				name: "cursor",
-				in: "query",
-				required: false,
-				kind: "string",
-				description: "A cursor used for pagination. If supported by the provider, use next_cursor given by the previous page of the list, else use offset."
-			},
 			{
 				name: "identifier",
 				in: "path",
@@ -12079,11 +12064,9 @@ const LINKEDIN_OPERATIONS = [
 			capability: "read",
 			mutates: false,
 			pagination: {
-				style: "cursor",
+				style: "offset",
 				limitParam: "limit",
-				cursorParam: "cursor",
 				offsetParam: "offset",
-				cursorPath: "next_cursor",
 				totalCountPath: "total_count",
 				itemsPath: "data"
 			},
@@ -12097,7 +12080,7 @@ const LINKEDIN_OPERATIONS = [
 				in: "query",
 				required: false,
 				kind: "integer",
-				description: "An offset used for pagination, if supported by the provider, else use cursor."
+				description: "Pagination offset"
 			},
 			{
 				name: "limit",
@@ -12106,13 +12089,6 @@ const LINKEDIN_OPERATIONS = [
 				kind: "integer",
 				description: "Rows to return (1-1000)"
 			},
-			{
-				name: "cursor",
-				in: "query",
-				required: false,
-				kind: "string",
-				description: "Pagination cursor"
-			},
 			{
 				name: "user_id",
 				in: "query",
@@ -12147,11 +12123,9 @@ const LINKEDIN_OPERATIONS = [
 			capability: "read",
 			mutates: false,
 			pagination: {
-				style: "cursor",
+				style: "offset",
 				limitParam: "limit",
-				cursorParam: "cursor",
 				offsetParam: "offset",
-				cursorPath: "next_cursor",
 				totalCountPath: "total_count",
 				itemsPath: "data"
 			},
@@ -12159,29 +12133,19 @@ const LINKEDIN_OPERATIONS = [
 			billingCategory: "user_read",
 			kind: "users"
 		},
-		parameters: [
-			{
-				name: "offset",
-				in: "query",
-				required: false,
-				kind: "integer",
-				description: "Pagination offset"
-			},
-			{
-				name: "limit",
-				in: "query",
-				required: false,
-				kind: "integer",
-				description: "Rows to return (1-100)"
-			},
-			{
-				name: "cursor",
-				in: "query",
-				required: false,
-				kind: "string",
-				description: "Pagination cursor"
-			}
-		]
+		parameters: [{
+			name: "offset",
+			in: "query",
+			required: false,
+			kind: "integer",
+			description: "Pagination offset"
+		}, {
+			name: "limit",
+			in: "query",
+			required: false,
+			kind: "integer",
+			description: "Rows to return (1-100)"
+		}]
 	},
 	{
 		schemaBaseName: "RequestsSent",
@@ -12200,11 +12164,9 @@ const LINKEDIN_OPERATIONS = [
 			capability: "read",
 			mutates: false,
 			pagination: {
-				style: "cursor",
+				style: "offset",
 				limitParam: "limit",
-				cursorParam: "cursor",
 				offsetParam: "offset",
-				cursorPath: "next_cursor",
 				totalCountPath: "total_count",
 				itemsPath: "data"
 			},
@@ -12212,29 +12174,19 @@ const LINKEDIN_OPERATIONS = [
 			billingCategory: "user_read",
 			kind: "users"
 		},
-		parameters: [
-			{
-				name: "offset",
-				in: "query",
-				required: false,
-				kind: "integer",
-				description: "Pagination offset"
-			},
-			{
-				name: "limit",
-				in: "query",
-				required: false,
-				kind: "integer",
-				description: "Rows to return (1-100)"
-			},
-			{
-				name: "cursor",
-				in: "query",
-				required: false,
-				kind: "string",
-				description: "Pagination cursor"
-			}
-		]
+		parameters: [{
+			name: "offset",
+			in: "query",
+			required: false,
+			kind: "integer",
+			description: "Pagination offset"
+		}, {
+			name: "limit",
+			in: "query",
+			required: false,
+			kind: "integer",
+			description: "Rows to return (1-100)"
+		}]
 	},
 	{
 		schemaBaseName: "MessagesMessage",
@@ -12640,7 +12592,6 @@ const CompaniesJobsOutput = object({
 const PostsCommentsInput = object({
 	offset: union([string(), number()]).optional(),
 	limit: union([string(), number()]).optional(),
-	cursor: string().optional(),
 	sort_by: _enum(["MOST_RECENT", "MOST_RELEVANT"]).optional(),
 	post_id: string()
 });
@@ -12652,7 +12603,6 @@ const PostsCommentsOutput = object({
 const PostsReactionsInput = object({
 	offset: union([string(), number()]).optional(),
 	limit: union([string(), number()]).optional(),
-	cursor: string().optional(),
 	post_id: string()
 });
 const PostsReactionsOutput = object({
@@ -12709,7 +12659,6 @@ const UserProfileOutput = record(string(), unknown());
 const UserPostsInput = object({
 	offset: union([string(), number()]).optional(),
 	limit: union([string(), number()]).optional(),
-	cursor: string().optional(),
 	identifier: string().optional()
 });
 const UserPostsOutput = object({
@@ -12720,7 +12669,6 @@ const UserPostsOutput = object({
 const UserConnectionsInput = object({
 	offset: union([string(), number()]).optional(),
 	limit: union([string(), number()]).optional(),
-	cursor: string().optional(),
 	user_id: string().optional(),
 	filter: string().optional()
 });
@@ -12731,8 +12679,7 @@ const UserConnectionsOutput = object({
 }).passthrough();
 const RequestsReceivedInput = object({
 	offset: union([string(), number()]).optional(),
-	limit: union([string(), number()]).optional(),
-	cursor: string().optional()
+	limit: union([string(), number()]).optional()
 });
 const RequestsReceivedOutput = object({
 	data: array(record(string(), unknown())),
@@ -12741,8 +12688,7 @@ const RequestsReceivedOutput = object({
 }).passthrough();
 const RequestsSentInput = object({
 	offset: union([string(), number()]).optional(),
-	limit: union([string(), number()]).optional(),
-	cursor: string().optional()
+	limit: union([string(), number()]).optional()
 });
 const RequestsSentOutput = object({
 	data: array(record(string(), unknown())),
@@ -13015,6 +12961,8 @@ const targetKindsFor = (op) => {
 };
 const positionalDisplayKeyFor$1 = (op, param) => op.config.paramLabels?.[param.name] ?? flagName(param.name);
 const bodyTextDisplayKeyFor$1 = (op) => op.config.bodyTextArg === void 0 ? void 0 : op.config.paramLabels?.[op.config.bodyTextArg] ?? op.config.bodyTextArg;
+const hasStdinBodyText$1 = (op) => op.config.bodyTextArg !== void 0;
+const stdinBodyTextRequired$1 = (op) => hasStdinBodyText$1(op) && op.config.bodyTextRequired !== false;
 const idempotencyFor$1 = (op) => {
 	if (op.endpoint.capability === "read") return {
 		safe: true,
@@ -13105,6 +13053,7 @@ const exampleCommandFor$1 = (op, commandName, root) => {
 		const hint = `<${positionalDisplayKeyFor$1(op, param)}>`;
 		parts.push(param.in === "path" || param.kind !== "array" ? hint : `${hint}...`);
 	}
+	if (hasStdinBodyText$1(op)) return `echo "..." | ${parts.join(" ")}`;
 	if (op.hasBody) parts.push("--body", "'{...}'");
 	return parts.join(" ");
 };
@@ -13119,16 +13068,19 @@ const signaturePartFor$1 = (op, name, arg) => {
 		return arg.required === true ? `<${valueHint}>` : `[${valueHint}]`;
 	}
 	if (name === "limit") return "--limit N";
-	if (name === "body" && op.config.bodyTextArg === void 0) return "--body JSON";
+	if (name === "body" && !hasStdinBodyText$1(op)) return "--body JSON";
 };
+const stdinSignaturePart$1 = (op) => hasStdinBodyText$1(op) ? "< body-text" : void 0;
 const usageFor$1 = (op, commandName, root) => {
-	const signature = Object.entries(buildArgs$1(op)).map(([name, arg]) => {
+	const signatureParts = Object.entries(buildArgs$1(op)).map(([name, arg]) => {
 		const part = signaturePartFor$1(op, name, arg);
 		return part === void 0 ? void 0 : {
 			positional: isObjectRecord$2(arg) && arg.type === "positional",
 			part
 		};
-	}).filter((entry) => entry !== void 0).sort((left, right) => Number(right.positional) - Number(left.positional)).map((entry) => entry.part).join(" ");
+	}).filter((entry) => entry !== void 0).sort((left, right) => Number(right.positional) - Number(left.positional)).map((entry) => entry.part);
+	const stdinPart = stdinSignaturePart$1(op);
+	const signature = [...signatureParts, ...stdinPart ? [stdinPart] : []].join(" ");
 	return [
 		"social",
 		"linkedin",
@@ -13138,7 +13090,15 @@ const usageFor$1 = (op, commandName, root) => {
 	].filter(Boolean).join(" ");
 };
 const helpDescriptionFor$1 = (op, commandName, root) => {
-	return `${`${op.config.summary} [${operationModeFor$1(op)}]`} | usage: \`${usageFor$1(op, commandName, root)}\``;
+	const description = `${op.config.summary} [${operationModeFor$1(op)}]`;
+	const usage = `usage: \`${usageFor$1(op, commandName, root)}\``;
+	const label = [
+		"social",
+		"linkedin",
+		...root ? [] : [op.config.group],
+		commandName
+	].join(" ");
+	return `${description} | ${usage}${hasStdinBodyText$1(op) ? ` | body text is read from stdin: \`echo "..." | ${label}\` (or pass --body)` : ""}`;
 };
 const commandPathFor = (op) => `linkedin ${op.config.root ? op.config.command : `${op.config.group} ${op.config.command}`}`;
 const contractInputSchemaName = (op) => op.hasBody ? `${op.schemaBaseName}ContractInput` : `${op.schemaBaseName}Input`;
@@ -13196,15 +13156,6 @@ const buildArgs$1 = (op) => {
 		type: "string",
 		description: "JSON request body"
 	};
-	if (op.config.bodyTextArg) {
-		const displayKey = bodyTextDisplayKeyFor$1(op) ?? op.config.bodyTextArg;
-		args[displayKey] = {
-			type: "positional",
-			required: false,
-			description: "Body value.",
-			valueHint: displayKey
-		};
-	}
 	for (const [name, param] of Object.entries(op.config.bodyParams ?? {})) {
 		const argName = bodyParamArg(name, param);
 		args[flagName(argName)] = {
@@ -13294,7 +13245,7 @@ const buildBody = (deps, op, input) => {
 	const bodyParamEntries = Object.entries(op.config.bodyParams ?? {});
 	if (!bodyTextArg && bodyParamEntries.length === 0) return input.body === void 0 ? void 0 : deps.parseJSONObject("--body", input.body);
 	const bodyFromJSON = input.body === void 0 ? void 0 : deps.parseJSONObject("--body", input.body);
-	const bodyText = bodyTextArg && input[bodyTextArg] !== void 0 ? deps.parseQueryString(`<${bodyTextDisplayKeyFor$1(op) ?? bodyTextArg}>`, input[bodyTextArg]) : void 0;
+	const bodyText = bodyTextArg && input[bodyTextArg] !== void 0 ? deps.parseBodyText(`<${bodyTextDisplayKeyFor$1(op) ?? bodyTextArg}>`, input[bodyTextArg]) : void 0;
 	const bodyParamValues = /* @__PURE__ */ new Map();
 	for (const [name, param] of bodyParamEntries) {
 		const value = input[name];
@@ -13329,8 +13280,29 @@ const dataWithAuditableWriteTarget = (op, data, body) => {
 		post_id: postId
 	};
 };
+const trimTrailingNewline$1 = (value) => value.endsWith("\r\n") ? value.slice(0, -2) : value.endsWith("\n") ? value.slice(0, -1) : value;
+const noBodyTextError$1 = (commandLabel) => new UsageError(`No body text. Pipe it via stdin: \`echo "..." | ${commandLabel}\` (or pass --body '<json>').`);
+const resolveBodyTextFromStdin$1 = async (op, deps, args, commandLabel) => {
+	if (!hasStdinBodyText$1(op)) return;
+	const bodyTextArg = bodyTextDisplayKeyFor$1(op) ?? op.config.bodyTextArg;
+	if (bodyTextArg === void 0) return;
+	const required = stdinBodyTextRequired$1(op) && typeof args.body !== "string";
+	if (process.stdin.isTTY) {
+		if (required) throw noBodyTextError$1(commandLabel);
+		return;
+	}
+	const piped = trimTrailingNewline$1(await deps.readStdin());
+	if (piped.length > 0) args[bodyTextArg] = piped;
+	else if (required) throw noBodyTextError$1(commandLabel);
+};
 const runOperation$1 = async (op, contract, deps, args, rawArgs = []) => {
 	rejectUnsupportedArgs(commandPathFor(op), args, Object.keys(buildArgs$1(op)));
+	await resolveBodyTextFromStdin$1(op, deps, args, [
+		"social",
+		"linkedin",
+		...op.config.root ? [] : [op.config.group],
+		op.config.command
+	].join(" "));
 	checkBodyRequired(op, args);
 	const account = typeof args.account === "string" ? args.account : void 0;
 	const input = buildInput$1(op, args);
@@ -13487,7 +13459,8 @@ const defineOperationCommand$1 = (op, deps) => {
 			method: op.endpoint.method,
 			capability: op.endpoint.capability,
 			mutates: op.endpoint.mutates,
-			schemaContract: contract
+			schemaContract: contract,
+			...hasStdinBodyText$1(op) ? { stdin: true } : {}
 		}),
 		args: buildArgs$1(op),
 		run: async ({ args, rawArgs }) => runOperation$1(op, contract, deps, args, rawArgs)
@@ -13718,7 +13691,7 @@ const buildMark = (deps) => {
 					reason: "Setting a LinkedIn chat read status is safe to retry."
 				},
 				confirmation: { required: false },
-				pagination: null,
+				pagination: { style: "none" },
 				responseShaping: {
 					supported: true,
 					formats: ["json"],
@@ -13839,7 +13812,7 @@ const buildMessageDelete = (deps) => {
 					required: true,
 					reason: "Deletes a LinkedIn message immediately."
 				},
-				pagination: null,
+				pagination: { style: "none" },
 				responseShaping: {
 					supported: true,
 					formats: ["json"],
@@ -13909,7 +13882,7 @@ const buildMessageEdit = (deps) => {
 	return defineCommand({
 		meta: commandMeta$2({
 			name: "edit",
-			description: "Edit one of your LinkedIn messages [write] | usage: `social linkedin message <target> edit message_id:<id> <text>`",
+			description: "Edit one of your LinkedIn messages [write] | usage: `social linkedin message <target> edit message_id:<id> < body-text` | new text is read from stdin: `echo \"...\" | social linkedin message <target> edit message_id:<id>`",
 			method: "POST",
 			capability: "write",
 			mutates: true,
@@ -13929,19 +13902,20 @@ const buildMessageEdit = (deps) => {
 					reason: "Re-applying the same LinkedIn message edit is safe."
 				},
 				confirmation: { required: false },
-				pagination: null,
+				pagination: { style: "none" },
 				responseShaping: {
 					supported: true,
 					formats: ["json"],
 					projection: true
 				},
 				cost: writeCost(creditsForCostBPS$1(DM_INTERACTION_ENDPOINT_BILLING.costBPS)),
-				examples: [{ command: "linkedin message <target> edit message_id:<id> \"fixed text\"" }],
+				examples: [{ command: "echo \"fixed text\" | linkedin message <target> edit message_id:<id>" }],
 				hazards: [{
 					code: "remote_write",
 					message: "Edits a LinkedIn message immediately."
 				}]
-			}
+			},
+			stdin: true
 		}),
 		args: {
 			target: {
@@ -13956,12 +13930,6 @@ const buildMessageEdit = (deps) => {
 				description: "Message to edit, as message_id:<id> (from `messages <target>`)",
 				valueHint: "message_id:<id>"
 			},
-			text: {
-				type: "positional",
-				required: true,
-				description: "New message text",
-				valueHint: "text"
-			},
 			account: {
 				type: "string",
 				description: "Account selector: @handle or profile_id:<id>; overrides config default"
@@ -13971,9 +13939,12 @@ const buildMessageEdit = (deps) => {
 			const positionals = Array.isArray(args._) ? args._ : [];
 			const account = typeof args.account === "string" ? args.account : void 0;
 			const message_id = messageIdFrom(deps, args.message_id ?? positionals[1]);
-			const textInput = args.text ?? positionals[2];
-			const text = textInput === void 0 ? void 0 : deps.parseQueryString("<text>", textInput);
-			if (text === void 0) throw new UsageError("Pass the new message <text>.");
+			let textInput;
+			if (process.stdin.isTTY) throw noBodyTextError$1("social linkedin message <target> edit message_id:<id>");
+			const piped = trimTrailingNewline$1(await deps.readStdin());
+			if (piped.length > 0) textInput = piped;
+			const text = textInput === void 0 ? void 0 : deps.parseBodyText("<text>", textInput);
+			if (text === void 0) throw noBodyTextError$1("social linkedin message <target> edit message_id:<id>");
 			const resolved = [];
 			const chatIdResolved = await deps.resolveTarget("target", args.target ?? positionals[0], {
 				platform: "linkedin",
@@ -14010,11 +13981,16 @@ const buildMessage$1 = (deps, sendCommand) => {
 	return defineCommand({
 		meta: commandMeta$2({
 			name: "message",
-			description: "Send a LinkedIn message to a person or conversation [write] | usage: `social linkedin message <target> [text]`",
+			description: "Send a LinkedIn message to a person or conversation [write] | usage: `social linkedin message <target> < body-text` | body text is read from stdin: `echo \"...\" | social linkedin message <target>` (or pass --body)",
 			method: "POST",
 			capability: "write",
 			mutates: true,
-			schemaContract
+			schemaContract,
+			stdin: true,
+			schemaSubCommands: {
+				delete: deleteCommand,
+				edit: editCommand
+			}
 		}),
 		args: {
 			target: {
@@ -14023,11 +13999,9 @@ const buildMessage$1 = (deps, sendCommand) => {
 				description: "LinkedIn person or conversation target: @handle, profile URL, profile_id:<id>, chat_id:<id>, or a messaging thread URL",
 				valueHint: "target"
 			},
-			text: {
-				type: "positional",
-				required: true,
-				description: "Message text",
-				valueHint: "text"
+			body: {
+				type: "string",
+				description: "JSON request body"
 			},
 			account: {
 				type: "string",
@@ -14044,18 +14018,25 @@ const buildMessage$1 = (deps, sendCommand) => {
 						_: [],
 						account: args.account,
 						target: positionals[0],
-						message_id: positionals[2],
-						...positionals[1] === "edit" ? { text: positionals[3] } : {}
+						message_id: positionals[2]
 					},
 					cmd: verbCommand
 				});
 				return;
 			}
 			const target = args.target ?? (Array.isArray(args._) && args._.length > 0 ? args._[0] : void 0);
-			const textInput = args.text ?? (Array.isArray(args._) && args._.length > 1 ? args._[1] : void 0);
+			const hasBody = typeof args.body === "string";
+			let textInput;
+			if (process.stdin.isTTY) {
+				if (!hasBody) throw noBodyTextError$1("social linkedin message <target>");
+			} else {
+				const piped = trimTrailingNewline$1(await deps.readStdin());
+				if (piped.length > 0) textInput = piped;
+				else if (!hasBody) throw noBodyTextError$1("social linkedin message <target>");
+			}
 			if (target === void 0) throw new UsageError("Pass a conversation or person target.");
 			const bodyFromJSON = typeof args.body === "string" ? deps.parseJSONObject("--body", args.body) : void 0;
-			const text = textInput === void 0 ? void 0 : deps.parseQueryString("<text>", textInput);
+			const text = textInput === void 0 ? void 0 : deps.parseBodyText("<text>", textInput);
 			const body = text === void 0 ? bodyFromJSON : {
 				...bodyFromJSON ?? {},
 				text
@@ -14147,7 +14128,8 @@ const buildMessages$1 = (deps, listCommand, readCommand) => {
 			method: "GET",
 			capability: "read",
 			mutates: false,
-			schemaContract: listCommand.meta.schemaContract
+			schemaContract: listCommand.meta.schemaContract,
+			schemaSubCommands: { mark: markCommand }
 		}),
 		args: {
 			target: {
@@ -14302,6 +14284,8 @@ createLinkedinCommands({
 	},
 	parseResourceId: unconfigured$1,
 	parseQueryString: unconfigured$1,
+	parseBodyText: unconfigured$1,
+	readStdin: unconfigured$1,
 	parseIntegerString: unconfigured$1,
 	parseEnumString: unconfigured$1,
 	parseBooleanString: unconfigured$1,
@@ -17017,6 +17001,9 @@ const isRequired = (op, param, positional) => {
 };
 const positionalDisplayKeyFor = (op, param) => op.config.paramLabels?.[param.name] ?? flagName(param.name);
 const bodyTextDisplayKeyFor = (op) => op.config.bodyTextArg === void 0 ? void 0 : op.config.paramLabels?.[op.config.bodyTextArg] ?? op.config.bodyTextArg;
+const resolvesTargetArg = (op) => op.config.bodyTextArg !== void 0 && (op.config.resolveResourceParams ?? []).includes(op.config.bodyTextArg);
+const hasStdinBodyText = (op) => op.config.bodyTextArg !== void 0 && !resolvesTargetArg(op);
+const stdinBodyTextRequired = (op) => hasStdinBodyText(op) && op.config.bodyTextRequired !== false;
 const kindsOf = (targetKind, fallback) => {
 	const kind = targetKind ?? fallback;
 	if (kind === void 0) throw new Error("target_kind_missing");
@@ -17151,6 +17138,7 @@ const exampleCommandFor = (op, commandName, group) => {
 		}
 	}
 	if (op.parameters.some((p) => p.name === "max_results")) parts.push("--limit", "10");
+	if (hasStdinBodyText(op)) return `echo "Hello from social" | ${parts.join(" ")}`;
 	if (op.hasBody) parts.push("--body", JSON.stringify(exampleBodyFor(op)));
 	return parts.join(" ");
 };
@@ -17165,16 +17153,19 @@ const signaturePartFor = (op, name, arg) => {
 		return arg.required === true ? `<${valueHint}>` : `[${valueHint}]`;
 	}
 	if (name === "limit") return "--limit N";
-	if (name === "body" && op.config.bodyTextArg === void 0) return "--body JSON";
+	if (name === "body" && !hasStdinBodyText(op)) return "--body JSON";
 };
+const stdinSignaturePart = (op) => hasStdinBodyText(op) ? "< body-text" : void 0;
 const usageFor = (op, commandName, group) => {
-	const signature = Object.entries(buildArgs(op)).map(([name, arg]) => {
+	const signatureParts = Object.entries(buildArgs(op)).map(([name, arg]) => {
 		const part = signaturePartFor(op, name, arg);
 		return part === void 0 ? void 0 : {
 			positional: isObjectRecord$1(arg) && arg.type === "positional",
 			part
 		};
-	}).filter((entry) => entry !== void 0).sort((left, right) => Number(right.positional) - Number(left.positional)).map((entry) => entry.part).join(" ");
+	}).filter((entry) => entry !== void 0).sort((left, right) => Number(right.positional) - Number(left.positional)).map((entry) => entry.part);
+	const stdinPart = stdinSignaturePart(op);
+	const signature = [...signatureParts, ...stdinPart ? [stdinPart] : []].join(" ");
 	return [
 		"social",
 		"x",
@@ -17183,7 +17174,15 @@ const usageFor = (op, commandName, group) => {
 	].filter(Boolean).join(" ");
 };
 const helpDescriptionFor = (op, commandName, group) => {
-	return `${`${op.config.summary} [${operationModeFor(op)}]`} | usage: \`${usageFor(op, commandName, group)}\``;
+	const description = `${op.config.summary} [${operationModeFor(op)}]`;
+	const usage = `usage: \`${usageFor(op, commandName, group)}\``;
+	const label = [
+		"social",
+		"x",
+		group,
+		commandName
+	].filter(Boolean).join(" ");
+	return `${description} | ${usage}${hasStdinBodyText(op) ? ` | body text is read from stdin: \`echo "..." | ${label}\` (or pass --body)` : ""}`;
 };
 const contractFor$1 = (op, commandName, group) => {
 	const mutates = op.endpoint.mutates;
@@ -17233,12 +17232,12 @@ const buildArgs = (op) => {
 		type: "string",
 		description: "JSON request body"
 	};
-	if (op.config.bodyTextArg) {
+	if (op.config.bodyTextArg && resolvesTargetArg(op)) {
 		const displayKey = bodyTextDisplayKeyFor(op) ?? op.config.bodyTextArg;
 		args[displayKey] = {
 			type: "positional",
 			required: false,
-			description: (op.config.resolveResourceParams ?? []).includes(op.config.bodyTextArg) ? targetDescriptionFor(op.config.targetKind) : "Body value.",
+			description: targetDescriptionFor(op.config.targetKind),
 			valueHint: displayKey
 		};
 	}
@@ -17374,8 +17373,29 @@ const withEchoedTargetId = (op, data, body) => {
 		}
 	};
 };
+const trimTrailingNewline = (value) => value.endsWith("\r\n") ? value.slice(0, -2) : value.endsWith("\n") ? value.slice(0, -1) : value;
+const noBodyTextError = (commandLabel) => new UsageError(`No body text. Pipe it via stdin: \`echo "..." | ${commandLabel}\` (or pass --body '<json>').`);
+const resolveBodyTextFromStdin = async (op, deps, args, commandLabel) => {
+	if (!hasStdinBodyText(op)) return;
+	const bodyTextArg = bodyTextDisplayKeyFor(op) ?? op.config.bodyTextArg;
+	if (bodyTextArg === void 0) return;
+	const required = stdinBodyTextRequired(op) && args.body === void 0;
+	if (process.stdin.isTTY) {
+		if (required) throw noBodyTextError(commandLabel);
+		return;
+	}
+	const piped = trimTrailingNewline(await deps.readStdin());
+	if (piped.length > 0) args[bodyTextArg] = piped;
+	else if (required) throw noBodyTextError(commandLabel);
+};
 const runOperation = async (op, contract, deps, args, rawArgs = []) => {
 	rejectUnknownArgs(op, args);
+	await resolveBodyTextFromStdin(op, deps, args, [
+		"social",
+		"x",
+		op.config.root ? "" : op.config.group,
+		op.config.command
+	].filter(Boolean).join(" "));
 	const account = typeof args.account === "string" ? args.account : void 0;
 	let ownAccount;
 	const resolveOwnAccount = async () => {
@@ -17458,12 +17478,12 @@ const runOperation = async (op, contract, deps, args, rawArgs = []) => {
 		const textArg = op.config.bodyTextArg;
 		if (textArg) {
 			const displayTextArg = bodyTextDisplayKeyFor(op) ?? textArg;
-			const bodyText = input[textArg] === void 0 ? void 0 : deps.parseQueryString(`<${displayTextArg}>`, input[textArg]);
+			const bodyText = input[textArg] === void 0 ? void 0 : deps.parseBodyText(`<${displayTextArg}>`, input[textArg]);
 			body = bodyText === void 0 ? bodyFromJSON : {
 				...bodyFromJSON ?? {},
 				[textArg]: bodyText
 			};
-			if (body === void 0 && op.config.bodyTextRequired === true) throw new UsageError(`Pass <${displayTextArg}> or --body.`);
+			if (body === void 0 && resolvesTargetArg(op) && op.config.bodyTextRequired === true) throw new UsageError(`Pass <${displayTextArg}> or --body.`);
 		} else body = bodyFromJSON;
 		body = await applyCreatePostReply(deps, op, input, body, resolved, account);
 	}
@@ -17493,7 +17513,8 @@ const defineOperationCommand = (op, deps) => {
 			method: op.endpoint.method,
 			capability: op.endpoint.capability,
 			mutates: op.endpoint.mutates,
-			contract
+			contract,
+			...hasStdinBodyText(op) ? { stdin: true } : {}
 		}),
 		args: buildArgs(op),
 		run: async ({ args, rawArgs }) => runOperation(op, contract, deps, args, rawArgs)
@@ -17916,11 +17937,12 @@ const buildMessage = (deps) => {
 	return defineCommand({
 		meta: commandMeta$1({
 			name: "message",
-			description: "Send a DM to a participant or conversation [write] | usage: `social x message <recipients> [text]`",
+			description: "Send a DM to a participant or conversation [write] | usage: `social x message <recipients> < body-text` | body text is read from stdin: `echo \"...\" | social x message <recipients>` (or pass --body)",
 			method: "POST",
 			capability: "write",
 			mutates: true,
-			contract
+			contract,
+			stdin: true
 		}),
 		args: {
 			recipients: {
@@ -17929,12 +17951,6 @@ const buildMessage = (deps) => {
 				description: "Recipient(s): chat URL, chat_id:<id>, @handle, profile URL, or profile_id:<id>; comma-separate profiles for a group",
 				valueHint: "recipients"
 			},
-			text: {
-				type: "positional",
-				required: false,
-				description: "Message text",
-				valueHint: "text"
-			},
 			body: {
 				type: "string",
 				description: "JSON request body"
@@ -17946,12 +17962,20 @@ const buildMessage = (deps) => {
 		},
 		run: async ({ args }) => {
 			const recipientsInput = args.recipients ?? args.target ?? (Array.isArray(args._) && args._.length > 0 ? args._[0] : void 0);
-			const textInput = args.text ?? (Array.isArray(args._) && args._.length > 1 ? args._[1] : void 0);
+			const hasBody = typeof args.body === "string";
+			let textInput;
+			if (process.stdin.isTTY) {
+				if (!hasBody) throw noBodyTextError("social x message <recipients>");
+			} else {
+				const piped = trimTrailingNewline(await deps.readStdin());
+				if (piped.length > 0) textInput = piped;
+				else if (!hasBody) throw noBodyTextError("social x message <recipients>");
+			}
 			if (recipientsInput === void 0) throw new UsageError("Pass a conversation or user target.");
 			const recipients = String(recipientsInput).split(",").map((recipient) => recipient.trim()).filter((recipient) => recipient.length > 0);
 			if (recipients.length === 0) throw new UsageError("Pass at least one recipient.");
 			const bodyFromJSON = typeof args.body === "string" ? deps.parseJSONObject("--body", args.body) : void 0;
-			const text = textInput === void 0 ? void 0 : deps.parseQueryString("--text", textInput);
+			const text = textInput === void 0 ? void 0 : deps.parseBodyText("--text", textInput);
 			const body = text === void 0 ? bodyFromJSON : {
 				...bodyFromJSON ?? {},
 				text
@@ -18008,9 +18032,110 @@ const buildMessage = (deps) => {
 		}
 	});
 };
+const searchOp = (() => {
+	const op = X_OPERATIONS.find((candidate) => candidate.config.command === "search");
+	if (op === void 0) throw new Error("x_cli_search_operation_missing");
+	return op;
+})();
+const repliesOp = {
+	schemaBaseName: searchOp.schemaBaseName,
+	hasBody: false,
+	config: {
+		command: "replies",
+		group: "tweets",
+		root: true,
+		summary: "List replies to a post",
+		itemUrlTemplate: "https://x.com/i/web/status/{id}",
+		fieldPresets: searchOp.config.fieldPresets
+	},
+	endpoint: searchOp.endpoint,
+	parameters: []
+};
+const conversationIdPrefix = "conversation_id:";
+const buildReplies = (deps) => {
+	const contract = contractFor$1(repliesOp, "replies", "");
+	const presets = repliesOp.config.fieldPresets ?? {};
+	return defineCommand({
+		meta: commandMeta$1({
+			name: "replies",
+			description: "List replies to a post [read] | usage: `social x replies <post-or-conversation> --limit N` | accepts conversation_id:<id>, post_id:<id>, or a post URL",
+			method: "GET",
+			capability: "read",
+			mutates: false,
+			contract
+		}),
+		args: {
+			target: {
+				type: "positional",
+				required: true,
+				description: "Post or conversation: conversation_id:<id>, post_id:<id>, or a post URL",
+				valueHint: "target"
+			},
+			limit: {
+				type: "string",
+				description: "Rows to return (10-100)"
+			},
+			cursor: {
+				type: "string",
+				description: "Cursor from a previous response"
+			},
+			account: {
+				type: "string",
+				description: "Account selector: @handle or profile_id:<id>; overrides config default"
+			}
+		},
+		run: async ({ args }) => {
+			const positional = Array.isArray(args._) ? args._ : [];
+			const targetInput = args.target ?? (positional.length > 0 ? positional[0] : void 0);
+			if (targetInput === void 0) throw new UsageError("Pass a post or conversation target.");
+			const target = String(targetInput).trim();
+			const account = typeof args.account === "string" ? args.account : void 0;
+			const selectedAccount = await deps.resolveAccount({
+				platform: "x",
+				account
+			});
+			const accountIdHeader = selectedAccount.selector;
+			const headers = { ...accountIdHeader === void 0 ? {} : { "x-social-account-id": accountIdHeader } };
+			const resolved = [];
+			let conversationId;
+			if (target.startsWith(conversationIdPrefix)) conversationId = deps.parseResourceId("conversation_id", target.slice(16));
+			else {
+				const resolution = await deps.resolveTarget("target", target, {
+					platform: "x",
+					expect: ["post"],
+					account
+				});
+				resolved.push(resolution.record);
+				const lookupData = await (await deps.api.get(`x/tweets/${encodeURIComponent(resolution.id)}?tweet.fields=conversation_id`, { headers })).json();
+				const post = isObjectRecord(lookupData) ? lookupData.data : void 0;
+				const candidate = isObjectRecord(post) ? post.conversation_id : void 0;
+				if (typeof candidate !== "string" || candidate.length === 0) throw new UsageError(`Could not read conversation_id for ${target} (the post may be deleted or protected).`);
+				conversationId = candidate;
+			}
+			const params = new URLSearchParams();
+			params.set("query", `${conversationIdPrefix}${conversationId} is:reply`);
+			if (args.limit !== void 0) params.set("max_results", String(deps.parseIntegerString("--limit", args.limit, {
+				min: 10,
+				max: 100
+			})));
+			if (args.cursor !== void 0) params.set("next_token", deps.parseQueryString("--cursor", args.cursor));
+			for (const [field, value] of Object.entries(presets)) params.set(field, deps.parseQueryString(`--${field}`, value));
+			const response = await deps.api.get(`x/tweets/search/recent?${params.toString()}`, { headers });
+			const data = await response.json();
+			await deps.printResult({
+				account: selectedAccount,
+				contract,
+				data,
+				resolved,
+				responseHeaders: response.headers
+			});
+		}
+	});
+};
 const createXCommands = (deps) => {
 	const messages = buildMessages(deps);
 	const message = buildMessage(deps);
+	const replies = buildReplies(deps);
 	const sync = buildSync(deps, "x");
 	const sql = buildSql(deps, "x");
 	const entries = X_OPERATIONS.map((op, index) => ({
@@ -18029,16 +18154,21 @@ const createXCommands = (deps) => {
 		command: message,
 		rank: 1,
 		index: X_OPERATIONS.length + 1
+	}, {
+		name: "replies",
+		command: replies,
+		rank: 0,
+		index: X_OPERATIONS.length + 2
 	}, {
 		name: "sync",
 		command: sync,
 		rank: 0,
-		index: X_OPERATIONS.length + 2
+		index: X_OPERATIONS.length + 3
 	}, {
 		name: "sql",
 		command: sql,
 		rank: 0,
-		index: X_OPERATIONS.length + 3
+		index: X_OPERATIONS.length + 4
 	});
 	entries.sort((left, right) => left.rank - right.rank || left.index - right.index);
 	return defineCommand({
@@ -18062,6 +18192,8 @@ createXCommands({
 	},
 	parseResourceId: unconfigured,
 	parseQueryString: unconfigured,
+	parseBodyText: unconfigured,
+	readStdin: unconfigured,
 	parseIntegerString: unconfigured,
 	parseEnumString: unconfigured,
 	parseBooleanString: unconfigured,
@@ -20922,7 +21054,7 @@ const createInstance = (defaults) => {
 const ky = createInstance();
 //#endregion
 //#region package.json
-var version$1 = "0.2.6";
+var version$1 = "0.3.0";
 //#endregion
 //#region src/lib/env.ts
 const URLWithTrailingSlash = url().transform(ensureTrailingSlash);
@@ -21312,6 +21444,12 @@ let outputWriters = {
 	stdout: writeStdout,
 	stderr: (value) => process.stderr.write(`${value}\n`)
 };
+const readStdin = async () => {
+	process.stdin.setEncoding("utf8");
+	let input = "";
+	for await (const chunk of process.stdin) input += chunk;
+	return input;
+};
 const printLine = (value) => {
 	outputWriters.stdout(value);
 };
@@ -21331,6 +21469,10 @@ const stringAtPath = (value, path) => {
 	const found = valueAtPath(value, path);
 	return typeof found === "string" && found.length > 0 ? found : void 0;
 };
+const numberAtPath = (value, path) => {
+	const found = valueAtPath(value, path);
+	return typeof found === "number" && Number.isFinite(found) ? found : void 0;
+};
 const idForRecord = (record) => {
 	for (const key of [
 		"id",
@@ -21424,11 +21566,18 @@ const nextCursorFrom = (contract, data) => {
 	const response = pagination.response;
 	return stringAtPath(data, isRecord$3(response) ? response.nextCursorPath : null) ?? stringAtPath(data, pagination.cursorPath);
 };
+const totalCountFrom = (contract, data) => {
+	if (!isRecord$3(contract)) return;
+	const pagination = contract.pagination;
+	if (!isRecord$3(pagination)) return;
+	return numberAtPath(data, pagination.totalCountPath);
+};
 const resultEnvelope = ({ account, contract, data, resolved = [], responseHeaders }) => {
 	const payload = outputPayloadFor(data, itemURLTemplateFrom(contract), idFieldFrom(contract));
 	const cache = cacheFromHeaders(responseHeaders);
 	const itemCount = "items" in payload && Array.isArray(payload.items) ? payload.items.length : 1;
 	const cursor = nextCursorFrom(contract, data);
+	const totalCount = totalCountFrom(contract, data);
 	return {
 		account: {
 			platform: account.platform,
@@ -21439,7 +21588,8 @@ const resultEnvelope = ({ account, contract, data, resolved = [], responseHeader
 			resolved,
 			cost: costFromContract(contract, itemCount, cache.hit, responseHeaders),
 			cache,
-			...cursor === void 0 ? {} : { cursor }
+			...cursor === void 0 ? {} : { cursor },
+			...totalCount === void 0 ? {} : { totalCount }
 		}
 	};
 };
@@ -21486,16 +21636,21 @@ const BOOLEAN_STRINGS = [
 	"off"
 ];
 const hasControlCharacter = (value) => [...value].some((character) => character.charCodeAt(0) < 32);
+const hasDisallowedControlCharacter = (value) => [...value].some((character) => {
+	const code = character.charCodeAt(0);
+	return code < 32 && code !== 9 && code !== 10 && code !== 13;
+});
 const validationError = (path, message) => new ZodError([{
 	code: "custom",
 	path,
 	message
 }]);
 const rejectControlCharacters = (name) => string().refine((value) => !hasControlCharacter(value), { message: `${name} must not contain control characters.` });
+const BodyText = (name) => string().refine((value) => !hasDisallowedControlCharacter(value), { message: `${name} must not contain control characters.` });
 const ResourceId = (name) => rejectControlCharacters(name).min(1, `${name} is required`).refine((value) => !UNSAFE_RESOURCE_CHARACTER_PATTERN.test(value), { message: `${name} must be a plain resource ID, not a URL, path, query string, or encoded value.` });
 const QueryString = (name) => rejectControlCharacters(name).check(/* @__PURE__ */ _minLength(1, `${name} must not be empty.`));
 const rejectControlCharactersInJSON = (name, value, path = []) => {
-	if (typeof value === "string" && hasControlCharacter(value)) throw validationError(path.length > 0 ? path : ["value"], `${name} must not contain control characters.`);
+	if (typeof value === "string" && hasDisallowedControlCharacter(value)) throw validationError(path.length > 0 ? path : ["value"], `${name} must not contain control characters.`);
 	if (Array.isArray(value)) {
 		for (const [index, item] of value.entries()) rejectControlCharactersInJSON(name, item, [...path, String(index)]);
 		return;
@@ -21509,6 +21664,7 @@ const parseWithSchema = (value, schema) => {
 };
 const parseResourceId = (name, value) => parseWithSchema(value, ResourceId(name));
 const parseQueryString = (name, value) => parseWithSchema(value, QueryString(name));
+const parseBodyText = (name, value) => parseWithSchema(value, BodyText(name));
 const parseResourceIdList = (name, values) => {
 	const parsed = array(ResourceId(name)).min(1, `${name} requires at least one ID.`).safeParse(values.map((value) => String(value)));
 	if (parsed.success) return parsed.data;
@@ -28350,6 +28506,8 @@ const createCLIDeps = () => {
 		api,
 		parseResourceId,
 		parseQueryString,
+		parseBodyText,
+		readStdin,
 		parseIntegerString,
 		parseEnumString,
 		parseBooleanString,
@@ -28465,7 +28623,12 @@ const pathPartsFrom = (...values) => {
 const commandName = (command, fallback) => typeof command.meta?.name === "string" ? command.meta.name : fallback;
 const commandDescription = (command) => typeof command.meta?.description === "string" ? command.meta.description : "";
 const isHiddenCommand = (command) => command.meta?.hidden === true;
+const inputSourceFor = (command) => command.meta?.stdin === true ? { inputSource: "stdin" } : {};
 const isRecord = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value));
+const childCommandsFor = (command) => ({
+	...command.subCommands ?? {},
+	...isRecord(command.meta?.schemaSubCommands) ? command.meta.schemaSubCommands : {}
+});
 const firstDefined = (...values) => values.find((value) => value !== void 0);
 const JSONMetadata = lazy(() => union([
 	_null(),
@@ -28624,7 +28787,8 @@ const compactSchemaForCommand = (command, path) => {
 		description: commandDescription(command),
 		...method ? { method } : {},
 		capability: capability ?? "unknown",
-		mutates: mutates ?? false
+		mutates: mutates ?? false,
+		...inputSourceFor(command)
 	};
 };
 const schemaForCommand = (command, path) => {
@@ -28644,6 +28808,7 @@ const schemaForCommand = (command, path) => {
 		name: path.join(".") || commandName(command, "social"),
 		description: commandDescription(command),
 		...method ? { method } : {},
+		...inputSourceFor(command),
 		args: metadataValueFor(contract.args, `${label}.args`) ?? positionalArgs,
 		flags: metadataValueFor(contract.flags, `${label}.flags`) ?? flags,
 		params: metadataValueFor(contract.params, `${label}.params`) ?? args,
@@ -28663,25 +28828,26 @@ const schemaForCommand = (command, path) => {
 	};
 };
 const treeForCommand = (command, path = []) => {
-	const subCommands = command.subCommands ?? {};
+	const subCommands = childCommandsFor(command);
 	return {
 		...compactSchemaForCommand(command, path),
 		subCommands: Object.fromEntries(Object.entries(subCommands).filter(([, subCommand]) => !isHiddenCommand(subCommand)).map(([name, subCommand]) => [name, treeForCommand(subCommand, [...path, commandName(subCommand, name)])]))
 	};
 };
 const leafSchemasForCommand = (command, path = []) => {
-	const subCommands = command.subCommands ?? {};
-	const entries = Object.entries(subCommands).filter(([, subCommand]) => !isHiddenCommand(subCommand));
+	const subCommands = childCommandsFor(command);
+	const allEntries = Object.entries(subCommands);
+	const entries = allEntries.filter(([, subCommand]) => !isHiddenCommand(subCommand));
 	const runnable = typeof command.run === "function";
-	return [...path.length > 0 && (runnable || entries.length === 0) ? [[path.join(" "), schemaForCommand(command, path)]] : [], ...entries.flatMap(([name, subCommand]) => leafSchemasForCommand(subCommand, [...path, commandName(subCommand, name)]))];
+	return [...path.length > 0 && (runnable || allEntries.length === 0) ? [[path.join(" "), schemaForCommand(command, path)]] : [], ...entries.flatMap(([name, subCommand]) => leafSchemasForCommand(subCommand, [...path, commandName(subCommand, name)]))];
 };
 const commandAtPath = (command, path) => {
 	let current = command;
 	const parts = path[0] === commandName(command, "social") ? path.slice(1) : path;
 	const resolved = [];
 	for (const part of parts) {
-		const next = current.subCommands?.[part];
-		if (!next || isHiddenCommand(next)) throw new Error(`Unknown command path: ${path.join(".")}`);
+		const next = childCommandsFor(current)[part];
+		if (!next) throw new Error(`Unknown command path: ${path.join(".")}`);
 		current = next;
 		resolved.push(commandName(current, part));
 	}