@usesocial/cli 0.4.0 → 0.6.0

package/dist/index.mjs

@@ -3,7 +3,6 @@ import { createRequire } from "node:module";
 import * as fs from "node:fs";
 import { createReadStream, mkdirSync, readFileSync, realpathSync, writeFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
-import { createInterface } from "node:readline/promises";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { parseArgs, stripVTControlCharacters, styleText } from "node:util";
@@ -12,7 +11,7 @@ import { createHash } from "node:crypto";
 import { chmod, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import { dirname as dirname$1, isAbsolute, posix, relative, sep } from "path";
 import * as b from "node:readline";
-import E, { createInterface as createInterface$1 } from "node:readline";
+import E, { createInterface } from "node:readline";
 import { AsyncLocalStorage } from "node:async_hooks";
 import V, { stdin, stdout } from "node:process";
 import { ReadStream } from "node:tty";
@@ -134,6 +133,9 @@ var CancelledError = class extends Error {
 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`);"
+}, {
+	"tag": "0001_far_beast",
+	"sql": "CREATE TABLE `li_profiles` (\n	`provider_id` text PRIMARY KEY NOT NULL,\n	`handle` text,\n	`display_name` text NOT NULL,\n	`avatar_url` text,\n	`headline` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `li_profiles_handle_idx` ON `li_profiles` (`handle`);--> statement-breakpoint\nCREATE TABLE `x_messages` (\n	`id` text PRIMARY KEY NOT NULL,\n	`created_at` integer,\n	`dm_conversation_id` text,\n	`event_type` text,\n	`sender_id` text,\n	`text` text,\n	`participant_ids` text,\n	`attachments` text,\n	`entities` text,\n	`referenced_tweets` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `x_messages_created_at_idx` ON `x_messages` (`created_at`);--> statement-breakpoint\nCREATE INDEX `x_messages_dm_conversation_id_idx` ON `x_messages` (`dm_conversation_id`);--> statement-breakpoint\nCREATE TABLE `x_profiles` (\n	`provider_id` text PRIMARY KEY NOT NULL,\n	`handle` text,\n	`display_name` text NOT NULL,\n	`avatar_url` text,\n	`headline` text,\n	`raw` text NOT NULL,\n	`synced_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `x_profiles_handle_idx` ON `x_profiles` (`handle`);"
 }];
 //#endregion
 //#region ../../packages/sync-engine/src/migrate.ts
@@ -178,9 +180,7 @@ const invokeWithParams = (fn, params) => {
 	return normalizedParams ? fn(normalizedParams) : fn();
 };
 const wrapStatement = (statement) => ({
-	run: (params) => {
-		invokeWithParams(statement.run.bind(statement), params);
-	},
+	run: (params) => invokeWithParams(statement.run.bind(statement), params),
 	get: (params) => invokeWithParams(statement.get.bind(statement), params),
 	all: (params) => invokeWithParams(statement.all.bind(statement), params)
 });
@@ -225,13 +225,17 @@ const cacheTables = new Set([
 	"x_followers",
 	"x_following",
 	"x_bookmarks",
+	"x_profiles",
+	"x_messages",
 	"li_conversations",
 	"li_messages",
 	"li_connections",
 	"li_posts",
+	"li_profiles",
 	"li_requests",
 	"sync_state"
 ]);
+const profileTables = new Set(["x_profiles", "li_profiles"]);
 const sanitizeAccountId = (accountId) => accountId.replaceAll(/[^A-Za-z0-9._-]/g, "_");
 const quoteIdentifier = (identifier) => `\`${identifier.replaceAll("`", "``")}\``;
 const resolveCachePath = (path) => path === ":memory:" ? path : resolve(path);
@@ -240,6 +244,10 @@ const numberOrNull = (value) => typeof value === "number" ? value : null;
 const assertKnownTable = (table) => {
 	if (!cacheTables.has(table)) throw new Error(`Unknown cache table: ${table}`);
 };
+const assertKnownProfileTable = (table) => {
+	assertKnownTable(table);
+	if (!profileTables.has(table)) throw new Error(`Unknown profile table: ${table}`);
+};
 const cachePath = (args) => join(homedir(), ".social", "cache", `${args.platform}-${sanitizeAccountId(args.accountId)}.db`);
 const openCacheAt = (path, opts) => {
 	const dbPath = resolveCachePath(path);
@@ -268,6 +276,46 @@ const createCache = (path, db) => ({
 			});
 		});
 	},
+	upsertProfiles: (table, rows) => {
+		if (rows.length === 0) return;
+		assertKnownProfileTable(table);
+		const rowsByProviderId = /* @__PURE__ */ new Map();
+		for (const row of rows) rowsByProviderId.set(row.providerId, row);
+		const columns = [
+			"provider_id",
+			"handle",
+			"display_name",
+			"avatar_url",
+			"headline",
+			"raw",
+			"synced_at"
+		];
+		const quotedTable = quoteIdentifier(table);
+		const nullableColumns = [
+			"handle",
+			"avatar_url",
+			"headline"
+		];
+		const lastWriteColumns = [
+			"display_name",
+			"raw",
+			"synced_at"
+		];
+		const updateAssignments = [...nullableColumns.map((column) => `${quoteIdentifier(column)}=COALESCE(excluded.${quoteIdentifier(column)}, ${quotedTable}.${quoteIdentifier(column)})`), ...lastWriteColumns.map((column) => `${quoteIdentifier(column)}=excluded.${quoteIdentifier(column)}`)].join(", ");
+		const statement = db.prepare(`INSERT INTO ${quotedTable} (${columns.map(quoteIdentifier).join(", ")}) VALUES (${columns.map((column) => `:${column}`).join(", ")}) ON CONFLICT(provider_id) DO UPDATE SET ${updateAssignments}`);
+		const syncedAt = Date.now();
+		db.transaction(() => {
+			for (const row of rowsByProviderId.values()) statement.run({
+				provider_id: row.providerId,
+				handle: row.handle,
+				display_name: row.displayName,
+				avatar_url: row.avatarURL,
+				headline: row.headline,
+				raw: JSON.stringify(row.raw),
+				synced_at: syncedAt
+			});
+		});
+	},
 	getCursor: (collection) => {
 		const row = db.prepare("SELECT cursor, last_synced, object_count FROM sync_state WHERE collection = :collection").get({ collection });
 		if (!row) return;
@@ -285,6 +333,22 @@ const createCache = (path, db) => ({
 			object_count: objectCount
 		});
 	},
+	reset: ({ tables, collections }) => {
+		for (const table of tables) assertKnownTable(table);
+		const results = [];
+		db.transaction(() => {
+			for (const table of tables) {
+				const result = db.prepare(`DELETE FROM ${quoteIdentifier(table)}`).run();
+				results.push({
+					table,
+					rowsDeleted: result?.changes ?? 0
+				});
+			}
+			const deleteState = db.prepare("DELETE FROM sync_state WHERE collection = :collection");
+			for (const collection of collections) deleteState.run({ collection });
+		});
+		return results;
+	},
 	query: (sql) => db.prepare(sql).all(),
 	describe: () => {
 		return {
@@ -535,6 +599,7 @@ const LINKEDIN_COLLECTIONS = [
 		key: "li_connections",
 		platform: "linkedin",
 		requests: [{ path: "/users/connections" }],
+		requiresFullInitialSync: true,
 		pagination: linkedinCursorPagination,
 		pageSize: 100,
 		estCostBPS: 10,
@@ -580,6 +645,9 @@ const xPagination = {
 	cursorPath: "meta.next_token",
 	itemsPath: "data"
 };
+const defaultDMEventFields = "attachments,created_at,dm_conversation_id,entities,event_type,id,participant_ids,referenced_tweets,sender_id,text";
+const defaultDMExpansions = "attachments.media_keys,participant_ids,referenced_tweets.id,sender_id";
+const defaultDMUserFields = "affiliation,connection_status,created_at,description,entities,id,location,most_recent_tweet_id,name,pinned_tweet_id,profile_banner_url,profile_image_url,protected,public_metrics,receives_your_dm,subscription_type,url,username,verified,verified_type,withheld";
 const asRecord = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
 const read = (value) => value === null || value === void 0 ? null : value;
 const isoToEpochMs = (value) => {
@@ -592,6 +660,7 @@ const toBool = (value) => {
 	if (typeof value !== "boolean") return null;
 	return value ? 1 : 0;
 };
+const stringifyJSON$1 = (value) => value === null || value === void 0 ? null : JSON.stringify(value);
 const liftTweetColumns = (item) => {
 	const editControls = asRecord(item.edit_controls);
 	const publicMetrics = asRecord(item.public_metrics);
@@ -635,6 +704,19 @@ const liftBookmark = (item) => {
 		raw: JSON.stringify(item)
 	};
 };
+const liftDMEvent = (item) => ({
+	id: read(item.id),
+	created_at: isoToEpochMs(item.created_at),
+	dm_conversation_id: read(item.dm_conversation_id),
+	event_type: read(item.event_type),
+	sender_id: read(item.sender_id),
+	text: read(item.text),
+	participant_ids: stringifyJSON$1(item.participant_ids),
+	attachments: stringifyJSON$1(item.attachments),
+	entities: stringifyJSON$1(item.entities),
+	referenced_tweets: stringifyJSON$1(item.referenced_tweets),
+	raw: JSON.stringify(item)
+});
 const liftXUser = (item) => {
 	const affiliation = asRecord(item.affiliation);
 	const publicMetrics = asRecord(item.public_metrics);
@@ -690,6 +772,7 @@ const COLLECTIONS = [...[
 		platform: "x",
 		requests: [{ path: "/users/:id/followers" }],
 		ownIdToken: ":id",
+		requiresFullInitialSync: true,
 		pagination: xPagination,
 		pageSize: 1e3,
 		estCostBPS: 10,
@@ -701,6 +784,7 @@ const COLLECTIONS = [...[
 		platform: "x",
 		requests: [{ path: "/users/:id/following" }],
 		ownIdToken: ":id",
+		requiresFullInitialSync: true,
 		pagination: xPagination,
 		pageSize: 1e3,
 		estCostBPS: 10,
@@ -717,10 +801,37 @@ const COLLECTIONS = [...[
 		estCostBPS: 10,
 		estUnitsPerPage: 100,
 		lift: liftBookmark
+	},
+	{
+		key: "x_messages",
+		platform: "x",
+		requests: [{
+			path: "/dm_events",
+			bakedQuery: {
+				"dm_event.fields": defaultDMEventFields,
+				expansions: defaultDMExpansions,
+				"user.fields": defaultDMUserFields
+			}
+		}],
+		pagination: xPagination,
+		pageSize: 100,
+		estCostBPS: 100,
+		estUnitsPerPage: 100,
+		sinceField: "created_at",
+		lift: liftDMEvent
 	}
 ], ...LINKEDIN_COLLECTIONS];
 const collectionByKey = (key) => COLLECTIONS.find((collection) => collection.key === key);
 const collectionsFor = (platform) => COLLECTIONS.filter((collection) => collection.platform === platform);
+const syncableCollectionsFor = (platform) => {
+	const parentKeys = new Set(COLLECTIONS.map((collection) => collection.parentCollection).filter(Boolean));
+	return collectionsFor(platform).filter((collection) => !parentKeys.has(collection.key));
+};
+const resetTablesFor = (collection) => {
+	if (!collection.parentCollection) return [collection];
+	const parent = collectionByKey(collection.parentCollection);
+	return parent ? [collection, parent] : [collection];
+};
 //#endregion
 //#region ../../node_modules/.bun/zod@4.4.3/node_modules/zod/v4/core/core.js
 var _a$2;
@@ -6973,6 +7084,14 @@ function object(shape, params) {
 		...normalizeParams(params)
 	});
 }
+function looseObject(shape, params) {
+	return new ZodObject({
+		type: "object",
+		shape,
+		catchall: unknown(),
+		...normalizeParams(params)
+	});
+}
 const ZodUnion = /* @__PURE__ */ $constructor("ZodUnion", (inst, def) => {
 	$ZodUnion.init(inst, def);
 	ZodType.init(inst, def);
@@ -9755,6 +9874,35 @@ pgTable("cli_session_grants", {
 	capabilities: text$1("capabilities").array().notNull(),
 	createdAt: timestamptz("created_at").notNull().defaultNow()
 }, (table) => [index$1("cli_session_grants_user_idx").on(table.userId, table.createdAt.desc()), check("cli_session_grants_scope_alias_check", sql`${table.scopeAlias} in ('read', 'read,write')`)]);
+pgTable("wrapped_runs", {
+	id: text$1("id").primaryKey().$defaultFn(() => crypto.randomUUID()),
+	userId: text$1("user_id").notNull().references(() => user.id, { onDelete: "cascade" }),
+	connectedAccountId: text$1("connected_account_id").references(() => connectedAccounts.id, { onDelete: "set null" }),
+	platform: text$1("platform", { enum: ["x"] }).notNull().default("x"),
+	handle: text$1("handle").notNull(),
+	platformProfileId: text$1("platform_profile_id"),
+	status: text$1("status", { enum: [
+		"pending",
+		"running",
+		"done",
+		"failed"
+	] }).notNull().default("pending"),
+	depthPct: integer$1("depth_pct").notNull().default(100),
+	followerCount: integer$1("follower_count").notNull().default(0),
+	quotedCredits: integer$1("quoted_credits").notNull().default(0),
+	billedCredits: integer$1("billed_credits").notNull().default(0),
+	snapshot: jsonb("snapshot").$type(),
+	shareSlug: text$1("share_slug").notNull(),
+	error: text$1("error"),
+	createdAt: timestamptz("created_at").notNull().defaultNow(),
+	updatedAt: timestamptz("updated_at").notNull().defaultNow()
+}, (table) => [
+	uniqueIndex("wrapped_runs_share_slug_key").on(table.shareSlug),
+	index$1("wrapped_runs_user_created_idx").on(table.userId, table.createdAt.desc()),
+	index$1("wrapped_runs_handle_done_idx").on(table.handle, table.createdAt.desc()).where(sql`${table.status} = 'done'`),
+	check("wrapped_runs_platform_check", sql`${table.platform} in ('x')`),
+	check("wrapped_runs_status_check", sql`${table.status} in ('pending', 'running', 'done', 'failed')`)
+]);
 //#endregion
 //#region ../../packages/billing/src/pricing.ts
 const createPricing = (resources) => {
@@ -9771,7 +9919,6 @@ const createPricing = (resources) => {
 //#endregion
 //#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));
 const creditsFromHeader = (headers) => {
 	const rawCredits = headers?.get("social-x-credits-used");
@@ -9804,176 +9951,580 @@ const createSpendTracker = (limitCredits) => {
 	};
 };
 //#endregion
-//#region ../../node_modules/.bun/drizzle-orm@0.43.1+ae5d55cf414a93be/node_modules/drizzle-orm/sqlite-core/foreign-keys.js
-var ForeignKeyBuilder = class {
-	static [entityKind] = "SQLiteForeignKeyBuilder";
-	/** @internal */
-	reference;
-	/** @internal */
-	_onUpdate;
-	/** @internal */
-	_onDelete;
-	constructor(config, actions) {
-		this.reference = () => {
-			const { name, columns, foreignColumns } = config();
-			return {
-				name,
-				columns,
-				foreignTable: foreignColumns[0].table,
-				foreignColumns
-			};
+//#region ../../packages/sync-engine/src/gate.ts
+const AUTO_CAP_CREDITS = 5e3;
+const planSync = (args) => {
+	const cap = args.autoCapCredits ?? 5e3;
+	const firstSync = args.firstSync ?? false;
+	if (args.creditsArg != null) return {
+		mode: "run",
+		billingLimitCredits: args.creditsArg,
+		capAndGo: false
+	};
+	if (!firstSync) return {
+		mode: "run",
+		billingLimitCredits: cap,
+		capAndGo: true
+	};
+	if (args.count != null) {
+		const estCredits = estimateSync({
+			estCostBPS: args.collection.estCostBPS,
+			estUnitsPerPage: args.collection.estUnitsPerPage,
+			pageSize: args.collection.pageSize,
+			totalCount: args.count,
+			limitCredits: cap
+		}).estCredits ?? 0;
+		return {
+			mode: "quote",
+			estCredits,
+			quoteLine: `Run with --credits ${Math.ceil(estCredits * 1.05)} to sync fully.`
 		};
-		if (actions) {
-			this._onUpdate = actions.onUpdate;
-			this._onDelete = actions.onDelete;
-		}
-	}
-	onUpdate(action) {
-		this._onUpdate = action;
-		return this;
-	}
-	onDelete(action) {
-		this._onDelete = action;
-		return this;
-	}
-	/** @internal */
-	build(table) {
-		return new ForeignKey(table, this);
-	}
-};
-var ForeignKey = class {
-	constructor(table, builder) {
-		this.table = table;
-		this.reference = builder.reference;
-		this.onUpdate = builder._onUpdate;
-		this.onDelete = builder._onDelete;
-	}
-	static [entityKind] = "SQLiteForeignKey";
-	reference;
-	onUpdate;
-	onDelete;
-	getName() {
-		const { name, columns, foreignColumns } = this.reference();
-		const columnNames = columns.map((column) => column.name);
-		const foreignColumnNames = foreignColumns.map((column) => column.name);
-		const chunks = [
-			this.table[TableName],
-			...columnNames,
-			foreignColumns[0].table[TableName],
-			...foreignColumnNames
-		];
-		return name ?? `${chunks.join("_")}_fk`;
 	}
+	return {
+		mode: "reject",
+		message: "Cannot estimate the full first sync cost safely. Provide --credits only after the user approves a safety cap."
+	};
 };
 //#endregion
-//#region ../../node_modules/.bun/drizzle-orm@0.43.1+ae5d55cf414a93be/node_modules/drizzle-orm/sqlite-core/unique-constraint.js
-function uniqueKeyName(table, columns) {
-	return `${table[TableName]}_${columns.join("_")}_unique`;
-}
-//#endregion
-//#region ../../node_modules/.bun/drizzle-orm@0.43.1+ae5d55cf414a93be/node_modules/drizzle-orm/sqlite-core/columns/common.js
-var SQLiteColumnBuilder = class extends ColumnBuilder {
-	static [entityKind] = "SQLiteColumnBuilder";
-	foreignKeyConfigs = [];
-	references(ref, actions = {}) {
-		this.foreignKeyConfigs.push({
-			ref,
-			actions
-		});
-		return this;
-	}
-	unique(name) {
-		this.config.isUnique = true;
-		this.config.uniqueName = name;
-		return this;
-	}
-	generatedAlwaysAs(as, config) {
-		this.config.generated = {
-			as,
-			type: "always",
-			mode: config?.mode ?? "virtual"
-		};
-		return this;
-	}
-	/** @internal */
-	buildForeignKeys(column, table) {
-		return this.foreignKeyConfigs.map(({ ref, actions }) => {
-			return ((ref2, actions2) => {
-				const builder = new ForeignKeyBuilder(() => {
-					const foreignColumn = ref2();
-					return {
-						columns: [column],
-						foreignColumns: [foreignColumn]
-					};
-				});
-				if (actions2.onUpdate) builder.onUpdate(actions2.onUpdate);
-				if (actions2.onDelete) builder.onDelete(actions2.onDelete);
-				return builder.build(table);
-			})(ref, actions);
-		});
+//#region ../../packages/sync-engine/src/profiles.ts
+const profileTableFor = (platform) => platform === "x" ? "x_profiles" : "li_profiles";
+const itemsSchema = array(record(string(), unknown()));
+const cursorSchema = union([string(), _null()]);
+const totalCountSchema = number().int().nonnegative();
+const isRecord$6 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const getByPath = (obj, path) => {
+	if (path === void 0) return;
+	let current = obj;
+	for (const segment of path.split(".")) {
+		if (!(isRecord$6(current) && segment in current)) return;
+		current = current[segment];
 	}
+	return current;
 };
-var SQLiteColumn = class extends Column {
-	constructor(table, config) {
-		if (!config.uniqueName) config.uniqueName = uniqueKeyName(table, [config.name]);
-		super(table, config);
-		this.table = table;
-	}
-	static [entityKind] = "SQLiteColumn";
+const validateEnvelope = (json, collection, onProgress) => {
+	const { pagination } = collection;
+	const itemsPath = pagination.style === "none" ? void 0 : pagination.itemsPath;
+	const cursorPath = pagination.style === "none" ? void 0 : pagination.cursorPath;
+	const totalCountPath = pagination.style === "none" ? void 0 : pagination.totalCountPath;
+	const itemsResult = itemsSchema.safeParse(getByPath(json, itemsPath));
+	const rawCursor = getByPath(json, cursorPath);
+	const rawTotalCount = getByPath(json, totalCountPath);
+	const cursorValue = rawCursor === void 0 || rawCursor === "" ? null : rawCursor;
+	const cursorResult = cursorSchema.safeParse(cursorValue);
+	const totalCountResult = totalCountSchema.safeParse(rawTotalCount);
+	if (!itemsResult.success) onProgress?.(`Warning: ${collection.key} returned invalid items at ${itemsPath ?? "<root>"}; treating page as empty.`);
+	return {
+		items: itemsResult.success ? itemsResult.data : [],
+		cursor: cursorResult.success ? cursorResult.data : null,
+		totalCount: totalCountResult.success ? totalCountResult.data : null
+	};
 };
-//#endregion
-//#region ../../node_modules/.bun/drizzle-orm@0.43.1+ae5d55cf414a93be/node_modules/drizzle-orm/sqlite-core/columns/blob.js
-var SQLiteBigIntBuilder = class extends SQLiteColumnBuilder {
-	static [entityKind] = "SQLiteBigIntBuilder";
-	constructor(name) {
-		super(name, "bigint", "SQLiteBigInt");
-	}
-	/** @internal */
-	build(table) {
-		return new SQLiteBigInt(table, this.config);
-	}
+const substitutePath = (path, args) => {
+	let resolved = path;
+	if (args.ownIdToken) resolved = resolved.replaceAll(args.ownIdToken, args.ownId);
+	if (args.parentIdToken && args.chatId !== void 0) resolved = resolved.replaceAll(args.parentIdToken, args.chatId);
+	return resolved;
 };
-var SQLiteBigInt = class extends SQLiteColumn {
-	static [entityKind] = "SQLiteBigInt";
-	getSQLType() {
-		return "blob";
-	}
-	mapFromDriverValue(value) {
-		if (Buffer.isBuffer(value)) return BigInt(value.toString());
-		if (value instanceof ArrayBuffer) {
-			const decoder = new TextDecoder();
-			return BigInt(decoder.decode(value));
-		}
-		return BigInt(String.fromCodePoint(...value));
-	}
-	mapToDriverValue(value) {
-		return Buffer.from(value.toString());
-	}
+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}` : "";
 };
-var SQLiteBlobJsonBuilder = class extends SQLiteColumnBuilder {
-	static [entityKind] = "SQLiteBlobJsonBuilder";
-	constructor(name) {
-		super(name, "json", "SQLiteBlobJson");
-	}
-	/** @internal */
-	build(table) {
-		return new SQLiteBlobJson(table, this.config);
-	}
+const parentColumnFor = (token) => token?.replace(/^:/, "");
+const applyBakedQueryOverlay = (row, bakedQuery) => {
+	for (const [key, value] of Object.entries(bakedQuery ?? {})) if (Object.hasOwn(row, key)) row[key] = value;
 };
-var SQLiteBlobJson = class extends SQLiteColumn {
-	static [entityKind] = "SQLiteBlobJson";
-	getSQLType() {
-		return "blob";
-	}
-	mapFromDriverValue(value) {
-		if (Buffer.isBuffer(value)) return JSON.parse(value.toString());
-		if (value instanceof ArrayBuffer) {
-			const decoder = new TextDecoder();
-			return JSON.parse(decoder.decode(value));
-		}
-		return JSON.parse(String.fromCodePoint(...value));
-	}
-	mapToDriverValue(value) {
+const applyParentOverlay = (row, parentIdToken, parentId) => {
+	const parentColumn = parentColumnFor(parentIdToken);
+	if (parentColumn && parentId !== void 0) row[parentColumn] = parentId;
+};
+const liftedTimestamp = (collection, item) => {
+	if (!collection.sinceField) return null;
+	const value = collection.lift(item)[collection.sinceField];
+	return typeof value === "number" ? value : null;
+};
+const stepPage = (state, page, opts) => {
+	const newestId = state.firstPage && page.items[0] ? String(page.items[0].id) : state.newestId;
+	const rows = [];
+	const ids = [];
+	for (const item of page.items) {
+		const id = String(item.id);
+		if (state.checkpoint !== null && id === state.checkpoint) return {
+			rows,
+			ids,
+			nextState: {
+				...state,
+				newestId,
+				firstPage: false
+			},
+			stoppedReason: "checkpoint",
+			done: true
+		};
+		if (opts.since != null && opts.collection.sinceField) {
+			const timestamp = liftedTimestamp(opts.collection, item);
+			if (timestamp != null && timestamp < opts.since) return {
+				rows,
+				ids,
+				nextState: {
+					...state,
+					newestId,
+					firstPage: false
+				},
+				stoppedReason: "since",
+				done: true
+			};
+		}
+		const row = opts.collection.lift(item);
+		applyBakedQueryOverlay(row, opts.request.bakedQuery);
+		applyParentOverlay(row, opts.parentIdToken, opts.parentId);
+		rows.push(row);
+		if (opts.collectIds) ids.push(id);
+	}
+	if (opts.collection.pagination.style === "offset") {
+		const nextOffset = state.offset + opts.collection.pageSize;
+		const done = page.items.length === 0 || page.totalCount != null && nextOffset >= page.totalCount || page.totalCount == null && page.items.length < opts.collection.pageSize;
+		return {
+			rows,
+			ids,
+			nextState: {
+				...state,
+				offset: done ? state.offset : nextOffset,
+				newestId,
+				firstPage: false
+			},
+			stoppedReason: "complete",
+			done
+		};
+	}
+	const nextCursor = page.cursor;
+	return {
+		rows,
+		ids,
+		nextState: {
+			...state,
+			cursor: nextCursor || null,
+			newestId,
+			firstPage: false
+		},
+		stoppedReason: "complete",
+		done: !nextCursor
+	};
+};
+const estimateFor = (collection, limitCredits, totalCount) => ({
+	collectionKey: collection.key,
+	limitCredits,
+	...estimateSync({
+		estCostBPS: collection.estCostBPS,
+		estUnitsPerPage: collection.estUnitsPerPage,
+		pageSize: collection.pageSize,
+		totalCount,
+		limitCredits
+	})
+});
+const mergeStoppedReason = (current, next) => {
+	if (current === "credit-limit" || next === "credit-limit") return "credit-limit";
+	if (current === "since" || next === "since") return "since";
+	if (current === "checkpoint" || next === "checkpoint") return "checkpoint";
+	return "complete";
+};
+const refinedEstimateMessage = (collection, limitCredits, totalCount) => {
+	const estimate = estimateFor(collection, limitCredits, totalCount);
+	return `${collection.key}: refined estimate ${estimate.estPages ?? 0} page(s), ${estimate.estCredits ?? 0} credits within ${estimate.limitCredits} credit limit.`;
+};
+const walkRequest = async (args) => {
+	const checkpoint = args.useCheckpoint ? args.deps.cache.getCursor(args.collection.key)?.cursor ?? null : null;
+	const ids = [];
+	let state = {
+		checkpoint,
+		cursor: null,
+		offset: 0,
+		newestId: null,
+		firstPage: true
+	};
+	let lastPageCredits = null;
+	let pages = 0;
+	let upserted = 0;
+	let stoppedReason = "complete";
+	while (true) {
+		const predictedNext = state.firstPage ? estimatePageCredits(args.collection.estCostBPS, args.collection.estUnitsPerPage) : lastPageCredits ?? estimatePageCredits(args.collection.estCostBPS, args.collection.estUnitsPerPage);
+		if (args.tracker.wouldExceed(predictedNext)) {
+			stoppedReason = "credit-limit";
+			break;
+		}
+		const path = `${args.deps.platform}` + substitutePath(args.request.path, {
+			ownId: args.deps.ownId,
+			ownIdToken: args.collection.ownIdToken,
+			chatId: args.parentId,
+			parentIdToken: args.parentIdToken
+		}) + buildQuery(args.collection.pagination, args.collection.pageSize, state.cursor, state.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);
+		lastPageCredits = credits;
+		pages++;
+		const json = await response.json();
+		const page = validateEnvelope(json, args.collection, args.onProgress);
+		const extractor = args.deps.profileExtractors?.[`GET ${args.request.path}`];
+		if (extractor) {
+			const profiles = extractor(json);
+			if (profiles.length > 0) args.deps.cache.upsertProfiles(profileTableFor(args.deps.platform), profiles);
+		}
+		if (state.firstPage && page.totalCount != null) args.onProgress?.(refinedEstimateMessage(args.collection, args.billingLimitCredits, page.totalCount));
+		const step = stepPage(state, page, {
+			collection: args.collection,
+			request: args.request,
+			since: args.since,
+			collectIds: args.collectIds,
+			parentId: args.parentId,
+			parentIdToken: args.parentIdToken
+		});
+		args.deps.cache.upsert(args.collection.key, step.rows);
+		upserted += step.rows.length;
+		ids.push(...step.ids);
+		state = step.nextState;
+		await args.onPage?.({
+			collectionKey: args.collection.key,
+			pagesCompleted: pages,
+			objectsUpserted: upserted,
+			creditsSpent: args.tracker.spent()
+		});
+		if (args.expectedTotalCount != null && upserted >= args.expectedTotalCount) {
+			stoppedReason = "complete";
+			break;
+		}
+		if (step.done) {
+			stoppedReason = step.stoppedReason;
+			break;
+		}
+	}
+	return {
+		ids,
+		newestId: state.newestId,
+		pages,
+		upserted,
+		checkpoint,
+		stoppedReason
+	};
+};
+const singleRequestCheckpoint = (args) => ({
+	collection: args.collection.key,
+	cursor: args.result.newestId ?? args.result.checkpoint,
+	objectCount: args.result.upserted,
+	lastSynced: Date.now()
+});
+const runSync = async (deps, opts) => {
+	const { collection } = opts;
+	if (opts.since != null && collection.sinceField === void 0) throw new Error(`Collection ${collection.key} does not support --since`);
+	if (opts.since != null && collection.requiresFullInitialSync && deps.cache.getCursor(collection.key)?.lastSynced == null) throw new Error(`Collection ${collection.key} requires a full initial sync before --since`);
+	const estimate = estimateFor(collection, opts.billingLimitCredits, opts.expectedTotalCount);
+	if (opts.onEstimate && !await opts.onEstimate(estimate)) return {
+		collection: collection.key,
+		objectsUpserted: 0,
+		pages: 0,
+		creditsSpent: 0,
+		stoppedReason: "aborted",
+		partial: false
+	};
+	const tracker = createSpendTracker(opts.billingLimitCredits);
+	let pages = 0;
+	let upserted = 0;
+	let stoppedReason = "complete";
+	let sawCreditLimit = false;
+	const pendingCursors = [];
+	const addResult = (result) => {
+		pages += result.pages;
+		upserted += result.upserted;
+		stoppedReason = mergeStoppedReason(stoppedReason, result.stoppedReason);
+		sawCreditLimit = sawCreditLimit || result.stoppedReason === "credit-limit";
+	};
+	if (collection.parentCollection) {
+		const parentCollection = collectionByKey(collection.parentCollection);
+		if (!parentCollection) throw new Error(`Missing parent collection ${collection.parentCollection}`);
+		const parentIds = [];
+		const parentPersistsCheckpoint = parentCollection.requests.length === 1;
+		for (const request of parentCollection.requests) {
+			const result = await walkRequest({
+				deps,
+				collection: parentCollection,
+				request,
+				tracker,
+				billingLimitCredits: opts.billingLimitCredits,
+				since: opts.since,
+				useCheckpoint: false,
+				collectIds: true,
+				onPage: opts.onPage,
+				onProgress: opts.onProgress
+			});
+			addResult(result);
+			parentIds.push(...result.ids);
+			if (parentPersistsCheckpoint) pendingCursors.push(singleRequestCheckpoint({
+				collection: parentCollection,
+				result
+			}));
+			if (result.stoppedReason === "credit-limit") break;
+		}
+		if (!parentPersistsCheckpoint) pendingCursors.push({
+			collection: parentCollection.key,
+			cursor: null,
+			objectCount: upserted,
+			lastSynced: Date.now()
+		});
+		if (!sawCreditLimit) for (const parentId of parentIds) {
+			for (const request of collection.requests) {
+				const result = await walkRequest({
+					deps,
+					collection,
+					request,
+					tracker,
+					billingLimitCredits: opts.billingLimitCredits,
+					since: opts.since,
+					useCheckpoint: false,
+					parentId,
+					parentIdToken: collection.parentIdToken,
+					onPage: opts.onPage,
+					onProgress: opts.onProgress
+				});
+				addResult(result);
+				if (result.stoppedReason === "credit-limit") break;
+			}
+			if (sawCreditLimit) break;
+		}
+		pendingCursors.push({
+			collection: collection.key,
+			cursor: null,
+			objectCount: upserted,
+			lastSynced: Date.now()
+		});
+	} else {
+		const useCheckpoint = collection.requests.length === 1;
+		for (const request of collection.requests) {
+			const result = await walkRequest({
+				deps,
+				collection,
+				request,
+				tracker,
+				billingLimitCredits: opts.billingLimitCredits,
+				since: opts.since,
+				expectedTotalCount: opts.expectedTotalCount,
+				useCheckpoint,
+				onPage: opts.onPage,
+				onProgress: opts.onProgress
+			});
+			addResult(result);
+			if (useCheckpoint) pendingCursors.push(singleRequestCheckpoint({
+				collection,
+				result
+			}));
+			if (result.stoppedReason === "credit-limit") break;
+		}
+		if (!useCheckpoint) pendingCursors.push({
+			collection: collection.key,
+			cursor: null,
+			objectCount: upserted,
+			lastSynced: Date.now()
+		});
+	}
+	const creditsSpent = tracker.spent();
+	if (!sawCreditLimit) for (const pending of pendingCursors) deps.cache.setCursor(pending.collection, pending.cursor, pending.objectCount, pending.lastSynced);
+	return {
+		collection: collection.key,
+		objectsUpserted: upserted,
+		pages,
+		creditsSpent,
+		stoppedReason,
+		partial: sawCreditLimit
+	};
+};
+const ensureFreshCache = async (deps, opts) => {
+	const now = opts.now ?? Date.now();
+	const cursor = deps.cache.getCursor(opts.collection.key);
+	if (cursor?.lastSynced == null) return { status: "never-synced" };
+	const ttl = (opts.ttlSeconds ?? 900) * 1e3;
+	if (now - cursor.lastSynced <= ttl) return { status: "fresh" };
+	return {
+		status: "refreshed",
+		summary: await runSync(deps, {
+			collection: opts.collection,
+			billingLimitCredits: AUTO_CAP_CREDITS,
+			onEstimate: () => true
+		})
+	};
+};
+//#endregion
+//#region ../../node_modules/.bun/drizzle-orm@0.43.1+ae5d55cf414a93be/node_modules/drizzle-orm/sqlite-core/foreign-keys.js
+var ForeignKeyBuilder = class {
+	static [entityKind] = "SQLiteForeignKeyBuilder";
+	/** @internal */
+	reference;
+	/** @internal */
+	_onUpdate;
+	/** @internal */
+	_onDelete;
+	constructor(config, actions) {
+		this.reference = () => {
+			const { name, columns, foreignColumns } = config();
+			return {
+				name,
+				columns,
+				foreignTable: foreignColumns[0].table,
+				foreignColumns
+			};
+		};
+		if (actions) {
+			this._onUpdate = actions.onUpdate;
+			this._onDelete = actions.onDelete;
+		}
+	}
+	onUpdate(action) {
+		this._onUpdate = action;
+		return this;
+	}
+	onDelete(action) {
+		this._onDelete = action;
+		return this;
+	}
+	/** @internal */
+	build(table) {
+		return new ForeignKey(table, this);
+	}
+};
+var ForeignKey = class {
+	constructor(table, builder) {
+		this.table = table;
+		this.reference = builder.reference;
+		this.onUpdate = builder._onUpdate;
+		this.onDelete = builder._onDelete;
+	}
+	static [entityKind] = "SQLiteForeignKey";
+	reference;
+	onUpdate;
+	onDelete;
+	getName() {
+		const { name, columns, foreignColumns } = this.reference();
+		const columnNames = columns.map((column) => column.name);
+		const foreignColumnNames = foreignColumns.map((column) => column.name);
+		const chunks = [
+			this.table[TableName],
+			...columnNames,
+			foreignColumns[0].table[TableName],
+			...foreignColumnNames
+		];
+		return name ?? `${chunks.join("_")}_fk`;
+	}
+};
+//#endregion
+//#region ../../node_modules/.bun/drizzle-orm@0.43.1+ae5d55cf414a93be/node_modules/drizzle-orm/sqlite-core/unique-constraint.js
+function uniqueKeyName(table, columns) {
+	return `${table[TableName]}_${columns.join("_")}_unique`;
+}
+//#endregion
+//#region ../../node_modules/.bun/drizzle-orm@0.43.1+ae5d55cf414a93be/node_modules/drizzle-orm/sqlite-core/columns/common.js
+var SQLiteColumnBuilder = class extends ColumnBuilder {
+	static [entityKind] = "SQLiteColumnBuilder";
+	foreignKeyConfigs = [];
+	references(ref, actions = {}) {
+		this.foreignKeyConfigs.push({
+			ref,
+			actions
+		});
+		return this;
+	}
+	unique(name) {
+		this.config.isUnique = true;
+		this.config.uniqueName = name;
+		return this;
+	}
+	generatedAlwaysAs(as, config) {
+		this.config.generated = {
+			as,
+			type: "always",
+			mode: config?.mode ?? "virtual"
+		};
+		return this;
+	}
+	/** @internal */
+	buildForeignKeys(column, table) {
+		return this.foreignKeyConfigs.map(({ ref, actions }) => {
+			return ((ref2, actions2) => {
+				const builder = new ForeignKeyBuilder(() => {
+					const foreignColumn = ref2();
+					return {
+						columns: [column],
+						foreignColumns: [foreignColumn]
+					};
+				});
+				if (actions2.onUpdate) builder.onUpdate(actions2.onUpdate);
+				if (actions2.onDelete) builder.onDelete(actions2.onDelete);
+				return builder.build(table);
+			})(ref, actions);
+		});
+	}
+};
+var SQLiteColumn = class extends Column {
+	constructor(table, config) {
+		if (!config.uniqueName) config.uniqueName = uniqueKeyName(table, [config.name]);
+		super(table, config);
+		this.table = table;
+	}
+	static [entityKind] = "SQLiteColumn";
+};
+//#endregion
+//#region ../../node_modules/.bun/drizzle-orm@0.43.1+ae5d55cf414a93be/node_modules/drizzle-orm/sqlite-core/columns/blob.js
+var SQLiteBigIntBuilder = class extends SQLiteColumnBuilder {
+	static [entityKind] = "SQLiteBigIntBuilder";
+	constructor(name) {
+		super(name, "bigint", "SQLiteBigInt");
+	}
+	/** @internal */
+	build(table) {
+		return new SQLiteBigInt(table, this.config);
+	}
+};
+var SQLiteBigInt = class extends SQLiteColumn {
+	static [entityKind] = "SQLiteBigInt";
+	getSQLType() {
+		return "blob";
+	}
+	mapFromDriverValue(value) {
+		if (Buffer.isBuffer(value)) return BigInt(value.toString());
+		if (value instanceof ArrayBuffer) {
+			const decoder = new TextDecoder();
+			return BigInt(decoder.decode(value));
+		}
+		return BigInt(String.fromCodePoint(...value));
+	}
+	mapToDriverValue(value) {
+		return Buffer.from(value.toString());
+	}
+};
+var SQLiteBlobJsonBuilder = class extends SQLiteColumnBuilder {
+	static [entityKind] = "SQLiteBlobJsonBuilder";
+	constructor(name) {
+		super(name, "json", "SQLiteBlobJson");
+	}
+	/** @internal */
+	build(table) {
+		return new SQLiteBlobJson(table, this.config);
+	}
+};
+var SQLiteBlobJson = class extends SQLiteColumn {
+	static [entityKind] = "SQLiteBlobJson";
+	getSQLType() {
+		return "blob";
+	}
+	mapFromDriverValue(value) {
+		if (Buffer.isBuffer(value)) return JSON.parse(value.toString());
+		if (value instanceof ArrayBuffer) {
+			const decoder = new TextDecoder();
+			return JSON.parse(decoder.decode(value));
+		}
+		return JSON.parse(String.fromCodePoint(...value));
+	}
+	mapToDriverValue(value) {
 		return Buffer.from(JSON.stringify(value));
 	}
 };
@@ -10425,6 +10976,28 @@ sqliteTable("x_bookmarks", {
 	noteTweetText: text("note_tweet_text"),
 	...rawColumns()
 }, (table) => [index("x_bookmarks_created_at_idx").on(table.createdAt)]);
+const profileColumns = () => ({
+	providerId: text("provider_id").primaryKey(),
+	handle: text("handle"),
+	displayName: text("display_name").notNull(),
+	avatarURL: text("avatar_url"),
+	headline: text("headline"),
+	...rawColumns()
+});
+sqliteTable("x_profiles", profileColumns(), (table) => [index("x_profiles_handle_idx").on(table.handle)]);
+sqliteTable("x_messages", {
+	id: idColumn(),
+	createdAt: integer("created_at"),
+	dmConversationId: text("dm_conversation_id"),
+	eventType: text("event_type"),
+	senderId: text("sender_id"),
+	text: text("text"),
+	participantIds: text("participant_ids"),
+	attachments: text("attachments"),
+	entities: text("entities"),
+	referencedTweets: text("referenced_tweets"),
+	...rawColumns()
+}, (table) => [index("x_messages_created_at_idx").on(table.createdAt), index("x_messages_dm_conversation_id_idx").on(table.dmConversationId)]);
 const xUserColumns = () => ({
 	id: idColumn(),
 	createdAt: integer("created_at"),
@@ -10472,6 +11045,7 @@ sqliteTable("li_connections", {
 	userDescription: text("user_description"),
 	...rawColumns()
 }, (table) => [index("li_connections_created_at_idx").on(table.createdAt)]);
+sqliteTable("li_profiles", profileColumns(), (table) => [index("li_profiles_handle_idx").on(table.handle)]);
 sqliteTable("li_conversations", {
 	id: idColumn(),
 	createdAt: integer("created_at"),
@@ -10583,359 +11157,46 @@ sqliteTable("li_posts", {
 	repostedByDisplayName: text("reposted_by_display_name"),
 	repostedByPublicIdentifier: text("reposted_by_public_identifier"),
 	repostedByProfileURL: text("reposted_by_profile_url"),
-	repostedByPublicPictureURL: text("reposted_by_public_picture_url"),
-	...rawColumns()
-}, (table) => [index("li_posts_created_at_idx").on(table.createdAt)]);
-sqliteTable("li_requests", {
-	id: idColumn(),
-	createdAt: integer("created_at"),
-	object: text("object"),
-	type: text("type"),
-	userId: text("user_id"),
-	userObject: text("user_object"),
-	userType: text("user_type"),
-	userDisplayName: text("user_display_name"),
-	userPublicIdentifier: text("user_public_identifier"),
-	userProfileURL: text("user_profile_url"),
-	userPublicPictureURL: text("user_public_picture_url"),
-	userDescription: text("user_description"),
-	...rawColumns()
-}, (table) => [index("li_requests_created_at_idx").on(table.createdAt)]);
-sqliteTable("sync_state", {
-	collection: text("collection").primaryKey(),
-	cursor: text("cursor"),
-	lastSynced: integer("last_synced"),
-	objectCount: integer("object_count")
-});
-//#endregion
-//#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 = {
-	hours: 36e5,
-	days: 864e5,
-	weeks: 6048e5
-};
-const parseSince = (input, now = Date.now()) => {
-	const value = input.trim();
-	const duration = durationPattern.exec(value);
-	if (duration != null) return now - Number.parseInt(duration[1] ?? "", 10) * unitMs[duration[2]];
-	const parsed = isoPattern.test(value) ? Date.parse(value) : NaN;
-	if (Number.isNaN(parsed)) throw new Error("Invalid --since value. Use an ISO 8601 date/datetime like 2026-06-01 or 2026-06-01T00:00:00Z, or a compact duration like 2:days, 3:weeks, or 5:hours.");
-	return parsed;
-};
-const itemsSchema = array(record(string(), unknown()));
-const cursorSchema = union([string(), _null()]);
-const totalCountSchema = number().int().nonnegative();
-const isRecord$6 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
-const getByPath = (obj, path) => {
-	if (path === void 0) return;
-	let current = obj;
-	for (const segment of path.split(".")) {
-		if (!(isRecord$6(current) && segment in current)) return;
-		current = current[segment];
-	}
-	return current;
-};
-const validateEnvelope = (json, collection, onProgress) => {
-	const { pagination } = collection;
-	const itemsPath = pagination.style === "none" ? void 0 : pagination.itemsPath;
-	const cursorPath = pagination.style === "none" ? void 0 : pagination.cursorPath;
-	const totalCountPath = pagination.style === "none" ? void 0 : pagination.totalCountPath;
-	const itemsResult = itemsSchema.safeParse(getByPath(json, itemsPath));
-	const rawCursor = getByPath(json, cursorPath);
-	const rawTotalCount = getByPath(json, totalCountPath);
-	const cursorValue = rawCursor === void 0 || rawCursor === "" ? null : rawCursor;
-	const cursorResult = cursorSchema.safeParse(cursorValue);
-	const totalCountResult = totalCountSchema.safeParse(rawTotalCount);
-	if (!itemsResult.success) onProgress?.(`Warning: ${collection.key} returned invalid items at ${itemsPath ?? "<root>"}; treating page as empty.`);
-	return {
-		items: itemsResult.success ? itemsResult.data : [],
-		cursor: cursorResult.success ? cursorResult.data : null,
-		totalCount: totalCountResult.success ? totalCountResult.data : null
-	};
-};
-const substitutePath = (path, args) => {
-	let resolved = path;
-	if (args.ownIdToken) resolved = resolved.replaceAll(args.ownIdToken, args.ownId);
-	if (args.parentIdToken && args.chatId !== void 0) resolved = resolved.replaceAll(args.parentIdToken, args.chatId);
-	return resolved;
-};
-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}` : "";
-};
-const parentColumnFor = (token) => token?.replace(/^:/, "");
-const applyBakedQueryOverlay = (row, bakedQuery) => {
-	for (const [key, value] of Object.entries(bakedQuery ?? {})) if (Object.hasOwn(row, key)) row[key] = value;
-};
-const applyParentOverlay = (row, parentIdToken, parentId) => {
-	const parentColumn = parentColumnFor(parentIdToken);
-	if (parentColumn && parentId !== void 0) row[parentColumn] = parentId;
-};
-const liftedTimestamp = (collection, item) => {
-	if (!collection.sinceField) return null;
-	const value = collection.lift(item)[collection.sinceField];
-	return typeof value === "number" ? value : null;
-};
-const stepPage = (state, page, opts) => {
-	const newestId = state.firstPage && page.items[0] ? String(page.items[0].id) : state.newestId;
-	const rows = [];
-	const ids = [];
-	for (const item of page.items) {
-		const id = String(item.id);
-		if (state.checkpoint !== null && id === state.checkpoint) return {
-			rows,
-			ids,
-			nextState: {
-				...state,
-				newestId,
-				firstPage: false
-			},
-			stoppedReason: "checkpoint",
-			done: true
-		};
-		if (opts.since != null && opts.collection.sinceField) {
-			const timestamp = liftedTimestamp(opts.collection, item);
-			if (timestamp != null && timestamp < opts.since) return {
-				rows,
-				ids,
-				nextState: {
-					...state,
-					newestId,
-					firstPage: false
-				},
-				stoppedReason: "since",
-				done: true
-			};
-		}
-		const row = opts.collection.lift(item);
-		applyBakedQueryOverlay(row, opts.request.bakedQuery);
-		applyParentOverlay(row, opts.parentIdToken, opts.parentId);
-		rows.push(row);
-		if (opts.collectIds) ids.push(id);
-	}
-	if (opts.collection.pagination.style === "offset") {
-		const nextOffset = state.offset + opts.collection.pageSize;
-		const done = page.items.length === 0 || page.totalCount != null && nextOffset >= page.totalCount || page.totalCount == null && page.items.length < opts.collection.pageSize;
-		return {
-			rows,
-			ids,
-			nextState: {
-				...state,
-				offset: done ? state.offset : nextOffset,
-				newestId,
-				firstPage: false
-			},
-			stoppedReason: "complete",
-			done
-		};
-	}
-	const nextCursor = page.cursor;
-	return {
-		rows,
-		ids,
-		nextState: {
-			...state,
-			cursor: nextCursor || null,
-			newestId,
-			firstPage: false
-		},
-		stoppedReason: "complete",
-		done: !nextCursor
-	};
-};
-const estimateFor = (collection, limitCredits, totalCount) => ({
-	collectionKey: collection.key,
-	...estimateSync({
-		estCostBPS: collection.estCostBPS,
-		estUnitsPerPage: collection.estUnitsPerPage,
-		pageSize: collection.pageSize,
-		totalCount,
-		limitCredits
-	})
+	repostedByPublicPictureURL: text("reposted_by_public_picture_url"),
+	...rawColumns()
+}, (table) => [index("li_posts_created_at_idx").on(table.createdAt)]);
+sqliteTable("li_requests", {
+	id: idColumn(),
+	createdAt: integer("created_at"),
+	object: text("object"),
+	type: text("type"),
+	userId: text("user_id"),
+	userObject: text("user_object"),
+	userType: text("user_type"),
+	userDisplayName: text("user_display_name"),
+	userPublicIdentifier: text("user_public_identifier"),
+	userProfileURL: text("user_profile_url"),
+	userPublicPictureURL: text("user_public_picture_url"),
+	userDescription: text("user_description"),
+	...rawColumns()
+}, (table) => [index("li_requests_created_at_idx").on(table.createdAt)]);
+sqliteTable("sync_state", {
+	collection: text("collection").primaryKey(),
+	cursor: text("cursor"),
+	lastSynced: integer("last_synced"),
+	objectCount: integer("object_count")
 });
-const mergeStoppedReason = (current, next) => {
-	if (current === "billing-limit" || next === "billing-limit") return "billing-limit";
-	if (current === "since" || next === "since") return "since";
-	if (current === "checkpoint" || next === "checkpoint") return "checkpoint";
-	return "complete";
-};
-const refinedEstimateMessage = (collection, limitCredits, totalCount) => {
-	const estimate = estimateFor(collection, limitCredits, totalCount);
-	return `${collection.key}: refined estimate ${estimate.estPages ?? 0} page(s), ${estimate.estCredits ?? 0} credits ($${(estimate.estUSD ?? 0).toFixed(2)}) within $${estimate.limitUSD.toFixed(2)} limit.`;
-};
-const walkRequest = async (args) => {
-	const checkpoint = args.useCheckpoint ? args.deps.cache.getCursor(args.collection.key)?.cursor ?? null : null;
-	const ids = [];
-	let state = {
-		checkpoint,
-		cursor: null,
-		offset: 0,
-		newestId: null,
-		firstPage: true
-	};
-	let lastPageCredits = null;
-	let pages = 0;
-	let upserted = 0;
-	let stoppedReason = "complete";
-	while (true) {
-		const predictedNext = state.firstPage ? estimatePageCredits(args.collection.estCostBPS, args.collection.estUnitsPerPage) : lastPageCredits ?? estimatePageCredits(args.collection.estCostBPS, args.collection.estUnitsPerPage);
-		if (args.tracker.wouldExceed(predictedNext)) {
-			stoppedReason = "billing-limit";
-			break;
-		}
-		const path = `${args.deps.platform}` + substitutePath(args.request.path, {
-			ownId: args.deps.ownId,
-			ownIdToken: args.collection.ownIdToken,
-			chatId: args.parentId,
-			parentIdToken: args.parentIdToken
-		}) + buildQuery(args.collection.pagination, args.collection.pageSize, state.cursor, state.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);
-		lastPageCredits = credits;
-		pages++;
-		const page = validateEnvelope(await response.json(), args.collection, args.onProgress);
-		if (state.firstPage && page.totalCount != null) args.onProgress?.(refinedEstimateMessage(args.collection, args.billingLimitCredits, page.totalCount));
-		const step = stepPage(state, page, {
-			collection: args.collection,
-			request: args.request,
-			since: args.since,
-			collectIds: args.collectIds,
-			parentId: args.parentId,
-			parentIdToken: args.parentIdToken
-		});
-		args.deps.cache.upsert(args.collection.key, step.rows);
-		upserted += step.rows.length;
-		ids.push(...step.ids);
-		state = step.nextState;
-		if (step.done) {
-			stoppedReason = step.stoppedReason;
-			break;
-		}
-	}
-	return {
-		ids,
-		newestId: state.newestId,
-		pages,
-		upserted,
-		checkpoint,
-		stoppedReason
-	};
-};
-const persistSingleRequestCheckpoint = (args) => {
-	args.cache.setCursor(args.collection.key, args.result.newestId ?? args.result.checkpoint, args.result.upserted, Date.now());
+//#endregion
+//#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 = {
+	hours: 36e5,
+	days: 864e5,
+	weeks: 6048e5
 };
-const runSync = async (deps, opts) => {
-	const { collection } = opts;
-	if (opts.since != null && collection.sinceField === void 0) throw new Error(`Collection ${collection.key} does not support --since`);
-	const estimate = estimateFor(collection, opts.billingLimitCredits);
-	if (opts.onEstimate && !await opts.onEstimate(estimate)) return {
-		collection: collection.key,
-		objectsUpserted: 0,
-		pages: 0,
-		creditsSpent: 0,
-		usdSpent: 0,
-		stoppedReason: "aborted",
-		partial: false
-	};
-	const tracker = createSpendTracker(opts.billingLimitCredits);
-	let pages = 0;
-	let upserted = 0;
-	let stoppedReason = "complete";
-	let sawBillingLimit = false;
-	const addResult = (result) => {
-		pages += result.pages;
-		upserted += result.upserted;
-		stoppedReason = mergeStoppedReason(stoppedReason, result.stoppedReason);
-		sawBillingLimit = sawBillingLimit || result.stoppedReason === "billing-limit";
-	};
-	if (collection.parentCollection) {
-		const parentCollection = collectionByKey(collection.parentCollection);
-		if (!parentCollection) throw new Error(`Missing parent collection ${collection.parentCollection}`);
-		const parentIds = [];
-		const parentPersistsCheckpoint = parentCollection.requests.length === 1;
-		for (const request of parentCollection.requests) {
-			const result = await walkRequest({
-				deps,
-				collection: parentCollection,
-				request,
-				tracker,
-				billingLimitCredits: opts.billingLimitCredits,
-				since: opts.since,
-				useCheckpoint: false,
-				collectIds: true,
-				onProgress: opts.onProgress
-			});
-			addResult(result);
-			parentIds.push(...result.ids);
-			if (parentPersistsCheckpoint) persistSingleRequestCheckpoint({
-				cache: deps.cache,
-				collection: parentCollection,
-				result
-			});
-			if (result.stoppedReason === "billing-limit") break;
-		}
-		if (!parentPersistsCheckpoint) deps.cache.setCursor(parentCollection.key, null, upserted, Date.now());
-		if (!sawBillingLimit) for (const parentId of parentIds) {
-			for (const request of collection.requests) {
-				const result = await walkRequest({
-					deps,
-					collection,
-					request,
-					tracker,
-					billingLimitCredits: opts.billingLimitCredits,
-					since: opts.since,
-					useCheckpoint: false,
-					parentId,
-					parentIdToken: collection.parentIdToken,
-					onProgress: opts.onProgress
-				});
-				addResult(result);
-				if (result.stoppedReason === "billing-limit") break;
-			}
-			if (sawBillingLimit) break;
-		}
-		deps.cache.setCursor(collection.key, null, upserted, Date.now());
-	} else {
-		const useCheckpoint = collection.requests.length === 1;
-		for (const request of collection.requests) {
-			const result = await walkRequest({
-				deps,
-				collection,
-				request,
-				tracker,
-				billingLimitCredits: opts.billingLimitCredits,
-				since: opts.since,
-				useCheckpoint,
-				onProgress: opts.onProgress
-			});
-			addResult(result);
-			if (useCheckpoint) persistSingleRequestCheckpoint({
-				cache: deps.cache,
-				collection,
-				result
-			});
-			if (result.stoppedReason === "billing-limit") break;
-		}
-		if (!useCheckpoint) deps.cache.setCursor(collection.key, null, upserted, Date.now());
-	}
-	const creditsSpent = tracker.spent();
-	return {
-		collection: collection.key,
-		objectsUpserted: upserted,
-		pages,
-		creditsSpent,
-		usdSpent: creditsToUSD(creditsSpent),
-		stoppedReason,
-		partial: sawBillingLimit
-	};
+const parseSince = (input, now = Date.now()) => {
+	const value = input.trim();
+	const duration = durationPattern.exec(value);
+	if (duration != null) return now - Number.parseInt(duration[1] ?? "", 10) * unitMs[duration[2]];
+	const parsed = isoPattern.test(value) ? Date.parse(value) : NaN;
+	if (Number.isNaN(parsed)) throw new Error("Invalid --since value. Use an ISO 8601 date/datetime like 2026-06-01 or 2026-06-01T00:00:00Z, or a compact duration like 2:days, 3:weeks, or 5:hours.");
+	return parsed;
 };
 //#endregion
 //#region ../../node_modules/.bun/citty@0.2.2/node_modules/citty/dist/_chunks/libs/scule.mjs
@@ -11436,6 +11697,238 @@ const { costBPSForCategory: costBPSForCategory$1 } = createPricing([
 		"featureId": "owned_read_resource"
 	}
 ]);
+//#endregion
+//#region ../../packages/lib/src/routes.ts
+const colonParamSegmentPattern = /^:(?<name>[A-Za-z0-9_]+)$/;
+const braceParamSegmentPattern = /^\{(?<name>[A-Za-z0-9_]+)\}$/;
+const splitPathSegments = (path) => path.split("/").filter(Boolean);
+const classifyPathSegment = (segment) => {
+	if (segment === "*") return {
+		kind: "wildcard",
+		segment
+	};
+	const colonParam = segment.match(colonParamSegmentPattern)?.groups?.name;
+	if (colonParam) return {
+		kind: "param",
+		name: colonParam,
+		segment,
+		syntax: "colon"
+	};
+	const braceParam = segment.match(braceParamSegmentPattern)?.groups?.name;
+	if (braceParam) return {
+		kind: "param",
+		name: braceParam,
+		segment,
+		syntax: "brace"
+	};
+	return {
+		kind: "literal",
+		segment
+	};
+};
+const pathTemplateValueFrom = (values, name) => {
+	const map = values;
+	return typeof map.get === "function" ? map.get(name) : values[name];
+};
+const safePathSegment = (value) => {
+	const segment = String(value);
+	try {
+		return encodeURIComponent(decodeURIComponent(segment));
+	} catch {
+		return encodeURIComponent(segment);
+	}
+};
+const defaultMissingParamMessage = (name) => `Missing path parameter: ${name}`;
+const resolvePathTemplateWith = (template, valueFrom, options = {}) => {
+	const missingParamMessage = options.missingParamMessage ?? defaultMissingParamMessage;
+	const resolvedPath = splitPathSegments(template).map((segment) => {
+		const classified = classifyPathSegment(segment);
+		if (classified.kind !== "param") return segment;
+		const value = valueFrom(classified.name);
+		if (value === void 0) throw new Error(missingParamMessage(classified.name));
+		return safePathSegment(value);
+	}).join("/");
+	if (!resolvedPath) return template.startsWith("/") ? "/" : "";
+	return `${template.startsWith("/") ? "/" : ""}${resolvedPath}`;
+};
+const resolvePathTemplate = (template, values, options) => resolvePathTemplateWith(template, (name) => pathTemplateValueFrom(values, name), options);
+//#endregion
+//#region ../../packages/api/src/proxy/types.ts
+const Capability$1 = _enum(["read", "write"]);
+const EndpointPagination = object({
+	style: _enum([
+		"none",
+		"cursor",
+		"offset"
+	]),
+	limitParam: string().optional(),
+	cursorParam: string().optional(),
+	offsetParam: string().optional(),
+	cursorPath: string().optional(),
+	previousCursorPath: string().optional(),
+	resultCountPath: string().optional(),
+	totalCountPath: string().optional(),
+	itemsPath: string().optional(),
+	pagingPath: string().optional()
+});
+object({
+	method: _enum([
+		"GET",
+		"POST",
+		"PATCH",
+		"DELETE",
+		"PUT"
+	]),
+	path: string(),
+	upstreamMethod: _enum([
+		"GET",
+		"POST",
+		"PATCH",
+		"DELETE",
+		"PUT"
+	]).optional(),
+	upstreamPath: string().optional(),
+	capability: Capability$1,
+	mutates: boolean$1().optional(),
+	pagination: EndpointPagination.optional(),
+	costBPS: number().int().nonnegative(),
+	billingCategory: string(),
+	billingOwnedCategory: string().optional(),
+	billingURLCategory: string().optional(),
+	maxUsageUnits: number().int().positive().optional(),
+	kind: string().optional()
+});
+//#endregion
+//#region ../../packages/lib/src/url.ts
+const stripTrailingSlashes = (value) => value.replace(/\/+$/, "");
+const stripLeadingSlashes = (value) => value.replace(/^\/+/, "");
+const ensureTrailingSlash = (value) => value.endsWith("/") ? value : `${value}/`;
+const absoluteURLPathPattern = /^[a-z][a-z0-9+.-]*:/i;
+const protocolRelativeURLPathPattern = /^\/\//;
+const createURL = (baseURL, path) => {
+	const trimmedPath = path.trimStart();
+	if (absoluteURLPathPattern.test(trimmedPath) || protocolRelativeURLPathPattern.test(trimmedPath)) throw new Error("createURL: path must be relative, not absolute or protocol-relative");
+	return new URL(stripLeadingSlashes(path), ensureTrailingSlash(stripTrailingSlashes(baseURL.toString())));
+};
+const createAbsoluteURL = (baseURL, path) => createURL(baseURL, path).toString();
+//#endregion
+//#region ../../packages/linkedin/src/profiles.ts
+const displayNameFrom = (firstName, lastName, handle) => [firstName, lastName].filter(Boolean).join(" ").trim() || handle || "";
+const rowFrom$1 = (fields) => {
+	const providerId = fields.providerId?.trim();
+	if (!providerId) return null;
+	const handle = fields.handle?.trim() || null;
+	const displayName = fields.displayName?.trim() || displayNameFrom(fields.firstName, fields.lastName, handle ?? void 0);
+	if (!displayName) return null;
+	return {
+		providerId,
+		handle,
+		displayName,
+		avatarURL: fields.avatarURL?.trim() || null,
+		headline: fields.headline?.trim() || null,
+		raw: fields.raw
+	};
+};
+const trimmed = (value) => value?.trim() || void 0;
+const LinkedinUserSpecifics = looseObject({
+	member_id: string().optional(),
+	description: string().nullish(),
+	headline: string().nullish(),
+	occupation: string().nullish()
+});
+const LinkedinUser = looseObject({
+	id: string().optional(),
+	public_identifier: string().optional(),
+	display_name: string().optional(),
+	first_name: string().optional(),
+	last_name: string().optional(),
+	public_picture_url: string().nullish(),
+	description: string().nullish(),
+	headline: string().nullish(),
+	specifics: LinkedinUserSpecifics.nullish()
+});
+const providerIdFromUser = (user) => trimmed(user.id) ?? trimmed(user.specifics?.member_id);
+const headlineFromUser = (user) => trimmed(user.description) ?? trimmed(user.headline) ?? trimmed(user.specifics?.description) ?? trimmed(user.specifics?.headline) ?? trimmed(user.specifics?.occupation) ?? null;
+const rowFromUser = ({ user, providerId, raw }) => rowFrom$1({
+	providerId: providerId ?? providerIdFromUser(user),
+	displayName: user.display_name,
+	firstName: user.first_name,
+	lastName: user.last_name,
+	handle: user.public_identifier,
+	avatarURL: user.public_picture_url,
+	headline: headlineFromUser(user),
+	raw
+});
+const ProfileBody = LinkedinUser;
+const extractProfile$1 = (body) => {
+	const parsed = ProfileBody.safeParse(body);
+	if (!parsed.success) return [];
+	const row = rowFrom$1({
+		providerId: providerIdFromUser(parsed.data),
+		displayName: parsed.data.display_name,
+		firstName: parsed.data.first_name,
+		lastName: parsed.data.last_name,
+		handle: parsed.data.public_identifier,
+		avatarURL: parsed.data.public_picture_url,
+		headline: headlineFromUser(parsed.data),
+		raw: parsed.data
+	});
+	return row ? [row] : [];
+};
+const RelationsBody = looseObject({ data: array(looseObject({
+	id: string().optional(),
+	object: string().optional(),
+	specifics: LinkedinUserSpecifics.nullish(),
+	user: LinkedinUser.nullish()
+})) });
+const extractConnections = (body) => {
+	const parsed = RelationsBody.safeParse(body);
+	if (!parsed.success) return [];
+	return parsed.data.data.flatMap((item) => {
+		const user = item.user ?? (item.object === "UserRelation" ? null : item);
+		if (!user) {
+			const row = rowFrom$1({
+				providerId: trimmed(item.specifics?.member_id),
+				raw: item
+			});
+			return row ? [row] : [];
+		}
+		const row = rowFromUser({
+			user,
+			providerId: providerIdFromUser(user) ?? trimmed(item.specifics?.member_id) ?? (item.object === "UserRelation" ? void 0 : trimmed(item.id)),
+			raw: item
+		});
+		return row ? [row] : [];
+	});
+};
+const GroupParticipant = looseObject({
+	object: string().optional(),
+	is_self: boolean$1().optional(),
+	is_admin: boolean$1().optional(),
+	user: LinkedinUser
+});
+looseObject({ data: array(looseObject({
+	id: string().optional(),
+	name: string().optional(),
+	headline: string().nullish(),
+	image_url: string().nullish(),
+	user_id: string().nullish(),
+	is_group: boolean$1().optional(),
+	is_1to1: boolean$1().optional(),
+	type: string().optional(),
+	participants_count: number().optional(),
+	user: LinkedinUser.nullish(),
+	participants: array(GroupParticipant).nullish()
+})) });
+looseObject({
+	data: array(GroupParticipant),
+	next_cursor: string().nullish()
+});
+const linkedinProfileExtractors = {
+	"GET /users/me": extractProfile$1,
+	"GET /users/:identifier": extractProfile$1,
+	"GET /users/connections": extractConnections
+};
 const LINKEDIN_OPERATIONS = [
 	{
 		schemaBaseName: "MessagesList",
@@ -12130,8 +12623,8 @@ const LINKEDIN_OPERATIONS = [
 				totalCountPath: "total_count",
 				itemsPath: "data"
 			},
-			costBPS: 100,
-			billingCategory: "following_read",
+			costBPS: 10,
+			billingCategory: "owned_read",
 			kind: "users"
 		},
 		parameters: [
@@ -12533,61 +13026,6 @@ function kebabCase(str) {
 //#region ../../packages/codegen/src/naming.ts
 const flagName = (name) => kebabCase(name.replace(/[._]/g, "-"));
 //#endregion
-//#region ../../packages/lib/src/routes.ts
-const colonParamSegmentPattern = /^:(?<name>[A-Za-z0-9_]+)$/;
-const braceParamSegmentPattern = /^\{(?<name>[A-Za-z0-9_]+)\}$/;
-const splitPathSegments = (path) => path.split("/").filter(Boolean);
-const classifyPathSegment = (segment) => {
-	if (segment === "*") return {
-		kind: "wildcard",
-		segment
-	};
-	const colonParam = segment.match(colonParamSegmentPattern)?.groups?.name;
-	if (colonParam) return {
-		kind: "param",
-		name: colonParam,
-		segment,
-		syntax: "colon"
-	};
-	const braceParam = segment.match(braceParamSegmentPattern)?.groups?.name;
-	if (braceParam) return {
-		kind: "param",
-		name: braceParam,
-		segment,
-		syntax: "brace"
-	};
-	return {
-		kind: "literal",
-		segment
-	};
-};
-const pathTemplateValueFrom = (values, name) => {
-	const map = values;
-	return typeof map.get === "function" ? map.get(name) : values[name];
-};
-const safePathSegment = (value) => {
-	const segment = String(value);
-	try {
-		return encodeURIComponent(decodeURIComponent(segment));
-	} catch {
-		return encodeURIComponent(segment);
-	}
-};
-const defaultMissingParamMessage = (name) => `Missing path parameter: ${name}`;
-const resolvePathTemplateWith = (template, valueFrom, options = {}) => {
-	const missingParamMessage = options.missingParamMessage ?? defaultMissingParamMessage;
-	const resolvedPath = splitPathSegments(template).map((segment) => {
-		const classified = classifyPathSegment(segment);
-		if (classified.kind !== "param") return segment;
-		const value = valueFrom(classified.name);
-		if (value === void 0) throw new Error(missingParamMessage(classified.name));
-		return safePathSegment(value);
-	}).join("/");
-	if (!resolvedPath) return template.startsWith("/") ? "/" : "";
-	return `${template.startsWith("/") ? "/" : ""}${resolvedPath}`;
-};
-const resolvePathTemplate = (template, values, options) => resolvePathTemplateWith(template, (name) => pathTemplateValueFrom(values, name), options);
-//#endregion
 //#region ../../packages/linkedin/src/cache.ts
 const linkedinCacheableEndpointPaths = [
 	"GET /companies/:identifier",
@@ -13575,28 +14013,102 @@ const commandOrder = {
 };
 const hiddenGroups = new Set(["search"]);
 const pascalCase = (value) => value.split(/[^A-Za-z0-9]+/).filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
-const confirmTTY$1 = async (message) => {
-	const readline = createInterface({
-		input: process.stdin,
-		output: process.stdout
-	});
-	try {
-		const answer = await readline.question(`${message} [y/N] `);
-		return /^(y|yes)$/i.test(answer.trim());
-	} finally {
-		readline.close();
-	}
-};
 const requireAccountSelector$1 = (selector) => {
 	if (selector === void 0) throw new UsageError("Selected LinkedIn account is missing an account selector.");
 	return selector;
 };
+const numberFromPath = (value, path) => {
+	let current = value;
+	for (const segment of path.split(".")) {
+		if (!isRecord$5(current)) return null;
+		current = current[segment];
+	}
+	return typeof current === "number" && Number.isFinite(current) ? current : null;
+};
+const linkedInCountFields = { li_connections: [
+	"specifics.relations_count",
+	"specifics.connections_count",
+	"relations_count",
+	"connections_count",
+	"connection_count"
+] };
+const ownProfileCount = async (args) => {
+	const fields = linkedInCountFields[args.collectionKey];
+	if (fields === void 0) return null;
+	const body = await (await args.deps.api.get(`linkedin/users/${encodeURIComponent(args.ownId)}`, { headers: args.accountHeaders })).json();
+	for (const field of fields) {
+		const count = numberFromPath(body, field);
+		if (count != null) return count;
+	}
+	return null;
+};
+const syncQuoteLine$1 = (estCredits, quoteLine) => `Estimated ~${Math.ceil(estCredits)} credits.\n${quoteLine}\n`;
+const autoCapPartialLine$1 = () => `Hit the ${AUTO_CAP_CREDITS} credit auto-cap (partial). Re-run with --credits <N> to continue.\n`;
+const syncProgressMessage = (progress) => `${progress.collectionKey}: ${progress.pagesCompleted} page(s), ${progress.objectsUpserted} object(s), ${progress.creditsSpent} credits.`;
+const syncCompleteMessage = (summary) => `Synced ${summary.collection}: ${summary.pages} page(s), ${summary.objectsUpserted} object(s), ${summary.creditsSpent} credits.`;
+const createSyncProgressReporter = (deps, collectionKey) => {
+	if ((deps.isInteractiveTerminal?.() ?? process.stdout.isTTY === true) && deps.ui) {
+		const spinner = deps.ui.spinner();
+		spinner.start(`Syncing ${collectionKey}...`);
+		return {
+			error: () => spinner.error(`Sync failed for ${collectionKey}.`),
+			onPage: (progress) => spinner.message(syncProgressMessage(progress)),
+			stop: (summary) => spinner.stop(syncCompleteMessage(summary))
+		};
+	}
+	return {
+		error: () => void 0,
+		onPage: (progress) => process.stderr.write(`${syncProgressMessage(progress)}\n`),
+		stop: () => void 0
+	};
+};
 const buildSync$1 = (deps, platform) => defineCommand({
-	meta: {
+	meta: commandMeta$2({
 		name: "sync",
 		description: "Sync a collection into the local cache (spends credits)",
-		hidden: true
-	},
+		method: "GET",
+		capability: "read",
+		mutates: true,
+		schemaContract: {
+			auth: {
+				required: true,
+				provider: "linkedin",
+				scopes: ["read"]
+			},
+			capability: "read",
+			confirmation: {
+				required: true,
+				reason: "Sync can spend usage credits and writes local cache state."
+			},
+			idempotency: {
+				safe: false,
+				retry: "never",
+				reason: "Repeated syncs can spend additional usage credits and update local rows."
+			},
+			method: "GET",
+			mutates: true,
+			outputSchema: unknown(),
+			pagination: { style: "none" },
+			responseShaping: {
+				supported: true,
+				formats: ["json"],
+				projection: true
+			},
+			examples: [{ command: "social linkedin sync connections --credits 1000" }],
+			cost: {
+				metered: true,
+				unit: "usage_credit",
+				notes: ["Upstream reads during sync are metered."]
+			},
+			hazards: [{
+				code: "local_cache_write",
+				message: "Writes synced LinkedIn rows and cursor state to the local cache."
+			}, {
+				code: "usage_credit_spend",
+				message: "May spend usage credits while reading upstream LinkedIn data."
+			}]
+		}
+	}),
 	args: {
 		collection: {
 			type: "positional",
@@ -13607,15 +14119,13 @@ const buildSync$1 = (deps, platform) => defineCommand({
 			type: "string",
 			description: "ISO date/datetime or compact duration like 2:days|3:weeks|5:hours"
 		},
-		"billing-limit": {
+		credits: {
 			type: "string",
-			default: "10",
-			description: "Hard cap on spend in USD (default 10)"
+			description: "Consent and hard cap in credits"
 		},
-		yes: {
+		reset: {
 			type: "boolean",
-			default: false,
-			description: "Skip the TTY confirmation"
+			description: "Delete local rows and sync state for the selected collection"
 		},
 		account: {
 			type: "string",
@@ -13623,7 +14133,7 @@ const buildSync$1 = (deps, platform) => defineCommand({
 		}
 	},
 	run: async ({ args }) => {
-		const collections = collectionsFor(platform);
+		const collections = syncableCollectionsFor(platform);
 		const shortName = (collection) => collection.key.replace(/^(x|li)_/, "");
 		const account = typeof args.account === "string" ? args.account : void 0;
 		const res = await deps.resolveOwnLinkedinAccount({ account });
@@ -13631,6 +14141,7 @@ const buildSync$1 = (deps, platform) => defineCommand({
 		const accountSelector = requireAccountSelector$1(res.account.selector);
 		const accountHeaders = { "x-social-account-id": accountSelector };
 		if (!args.collection) {
+			if (args.reset === true) throw new UsageError("--reset requires a collection");
 			const cache = openCache({
 				platform,
 				accountId: accountSelector
@@ -13651,43 +14162,102 @@ const buildSync$1 = (deps, platform) => defineCommand({
 		}
 		const collection = collections.find((candidate) => shortName(candidate) === args.collection || candidate.key === args.collection);
 		if (!collection) throw new UsageError(`Unknown collection "${args.collection}". Available: ${collections.map(shortName).join(", ")}`);
+		if (args.reset === true) {
+			if (args.credits != null) throw new UsageError("--reset cannot be combined with --credits");
+			if (args.since != null) throw new UsageError("--reset cannot be combined with --since");
+			const cache = openCache({
+				platform,
+				accountId: accountSelector
+			});
+			const resetCollections = resetTablesFor(collection);
+			try {
+				deps.printData({
+					collection: collection.key,
+					reset: true,
+					tables: cache.reset({
+						tables: resetCollections.map((resetCollection) => resetCollection.key),
+						collections: resetCollections.map((resetCollection) => resetCollection.key)
+					})
+				});
+			} finally {
+				cache.close();
+			}
+			return;
+		}
 		let since;
 		if (args.since != null) {
 			if (!collection.sinceField) throw new UsageError(`${shortName(collection)} does not support --since`);
+			if (collection.requiresFullInitialSync) {
+				const cache = openCache({
+					platform,
+					accountId: accountSelector
+				});
+				try {
+					if (cache.getCursor(collection.key)?.lastSynced == null) throw new UsageError(`${shortName(collection)} requires a full initial sync before --since`);
+				} finally {
+					cache.close();
+				}
+			}
 			since = parseSince(String(args.since));
 		}
-		const limitUSD = Number(args["billing-limit"] ?? "10");
-		if (!Number.isFinite(limitUSD) || limitUSD <= 0) throw new UsageError("--billing-limit must be a positive number of USD");
-		const billingLimitCredits = usdToCredits(limitUSD);
+		const creditsArg = args.credits != null && args.credits !== "" ? Number(args.credits) : null;
+		if (creditsArg != null && (!Number.isFinite(creditsArg) || creditsArg < 0)) throw new UsageError("--credits must be a non-negative number of credits");
 		const cache = openCache({
 			platform,
 			accountId: accountSelector
 		});
-		const onEstimate = async (estimate) => {
-			const line = estimate.unknown ? `Estimated ~${estimate.perPageCredits} credits/page ($${estimate.perPageUSD.toFixed(2)}); total unknown, bounded by $${estimate.limitUSD.toFixed(2)}.` : `Estimated ~${estimate.estCredits} credits ($${(estimate.estUSD ?? 0).toFixed(2)}) across ${estimate.estPages} page(s); limit $${estimate.limitUSD.toFixed(2)}.`;
-			if (process.stdin.isTTY && !args.yes) {
-				process.stderr.write(`${line}\n`);
-				return await confirmTTY$1("Proceed with sync?");
-			}
+		const firstSync = cache.getCursor(collection.key)?.lastSynced == null;
+		const count = firstSync ? await ownProfileCount({
+			deps,
+			collectionKey: collection.key,
+			ownId,
+			accountHeaders
+		}) : null;
+		const plan = planSync({
+			collection,
+			creditsArg,
+			count,
+			firstSync
+		});
+		if (plan.mode === "quote") {
+			cache.close();
+			process.stderr.write(syncQuoteLine$1(plan.estCredits, plan.quoteLine));
+			return;
+		}
+		if (plan.mode === "reject") {
+			cache.close();
+			throw new UsageError(`${shortName(collection)}: ${plan.message}`);
+		}
+		const onEstimate = (estimate) => {
+			const line = estimate.unknown ? `Estimated ~${estimate.perPageCredits} credits/page; total unknown, bounded by ${estimate.limitCredits} credits.` : `Estimated ~${estimate.estCredits} credits across ${estimate.estPages} page(s); limit ${estimate.limitCredits} credits.`;
 			process.stderr.write(`${line}\n`);
 			return true;
 		};
 		const onProgress = (message) => process.stderr.write(`${message}\n`);
+		const progress = createSyncProgressReporter(deps, collection.key);
 		try {
 			const summary = await runSync({
 				api: deps.api,
 				cache,
 				platform,
 				ownId,
-				accountHeaders
+				accountHeaders,
+				profileExtractors: linkedinProfileExtractors
 			}, {
 				collection,
 				since,
-				billingLimitCredits,
+				expectedTotalCount: firstSync ? count : null,
+				billingLimitCredits: plan.billingLimitCredits,
 				onEstimate,
+				onPage: progress.onPage,
 				onProgress
 			});
+			progress.stop(summary);
+			if (plan.capAndGo && summary.stoppedReason === "credit-limit") process.stderr.write(autoCapPartialLine$1());
 			deps.printData(summary);
+		} catch (error) {
+			progress.error();
+			throw error;
 		} finally {
 			cache.close();
 		}
@@ -14132,51 +14702,103 @@ const buildMessage$1 = (deps, sendCommand) => {
 		}
 	});
 };
-const pickedArgs = (args, names) => {
-	const picked = { _: [] };
-	for (const name of names) if (args[name] !== void 0) picked[name] = args[name];
-	return picked;
-};
 const rejectMessagesArgs = (commandName, args, allowed) => rejectUnsupportedArgs(commandName, args, ["target", ...allowed]);
-const chatIdsFromUserChatLookup = (data) => {
-	const rows = isRecord$5(data) && Array.isArray(data.data) ? data.data : [];
-	return [...new Set(rows.map((row) => isRecord$5(row) && typeof row.chat_id === "string" ? row.chat_id : void 0).filter((chatId) => Boolean(chatId)))];
+const cacheReadArgNames = ["account", "limit"];
+const mustCollection = (key) => {
+	const collection = collectionByKey(key);
+	if (collection === void 0) throw new Error(`Missing sync collection: ${key}`);
+	return collection;
+};
+const sqlString = (value) => `'${value.replaceAll("'", "''")}'`;
+const limitClause = (deps, value) => value === void 0 ? "" : ` LIMIT ${deps.parseIntegerString("--limit", value, { min: 1 })}`;
+const cacheReadSchemaContract = (command) => {
+	const { inputSchema: _inputSchema, ...schemaContract } = command.meta.schemaContract;
+	const cost = isRecord$5(schemaContract.cost) ? {
+		...schemaContract.cost,
+		cacheable: true,
+		cacheHitCost: 0
+	} : schemaContract.cost;
+	return {
+		...schemaContract,
+		pagination: { style: "none" },
+		cost
+	};
+};
+const chatIdFromCachedMessageTarget = (deps, target) => {
+	if (target.startsWith("chat_id:")) return deps.parseResourceId("target", target.slice(8));
+	try {
+		const [, section, subsection, sectionId] = new URL(target).pathname.split("/");
+		if (section === "messaging" && subsection === "thread" && sectionId) return deps.parseResourceId("target", decodeURIComponent(sectionId));
+	} catch {}
+	throw new UsageError("Cached message reads accept chat_id:<id> or a LinkedIn messaging thread URL.");
 };
-const resolveProfileChatId = async ({ account, deps, commandHeaderInput, rawArgs, profileId, target }) => {
-	const selectedAccount = await deps.resolveAccount({
+const withFreshLinkedinCache = async (deps, args, collectionKey, syncName, read, refreshEveryCall = false) => {
+	const account = typeof args.account === "string" ? args.account : void 0;
+	const res = await deps.resolveOwnLinkedinAccount({ account });
+	const ownId = res.providerId;
+	const accountSelector = requireAccountSelector$1(res.account.selector);
+	const accountHeaders = { "x-social-account-id": accountSelector };
+	const cache = openCache({
 		platform: "linkedin",
-		account
+		accountId: accountSelector
 	});
-	const headers = {
-		...await deps.commandHeaders({
-			headers: commandHeaderInput,
-			rawArgs
-		}),
-		...selectedAccount.selector === void 0 ? {} : { "x-social-account-id": selectedAccount.selector }
-	};
-	const chatIds = chatIdsFromUserChatLookup(await (await deps.api.get("linkedin/users/".concat(encodeURIComponent(profileId), "/chat"), { headers })).json());
-	if (chatIds.length === 0) throw new UsageError(`No existing LinkedIn chat found for ${target}.`);
-	if (chatIds.length > 1) throw new UsageError(`LinkedIn profile target ${target} resolved to multiple chats. Use an explicit chat_id:<id>.`);
-	return chatIds[0];
+	try {
+		const collection = mustCollection(collectionKey);
+		if ((await ensureFreshCache({
+			api: deps.api,
+			cache,
+			platform: "linkedin",
+			ownId,
+			accountHeaders,
+			profileExtractors: linkedinProfileExtractors
+		}, {
+			collection,
+			ttlSeconds: refreshEveryCall ? 0 : void 0
+		})).status === "never-synced") throw new UsageError(`No synced ${syncName} yet. Run \`linkedin sync ${syncName}\` first.`);
+		read(cache);
+	} finally {
+		cache.close();
+	}
 };
-const buildMessages$1 = (deps, listCommand, readCommand) => {
+const readConnections = (deps, args) => withFreshLinkedinCache(deps, args, "li_connections", "connections", (cache) => {
+	deps.printData(cache.query(`SELECT c.*, p.handle AS user_handle, p.display_name AS user_name, p.avatar_url AS user_avatar_url, p.headline AS user_headline FROM li_connections c LEFT JOIN li_profiles p ON c.user_id = p.provider_id ORDER BY c.synced_at DESC${limitClause(deps, args.limit)}`));
+});
+const readRequests = (deps, args, requestType) => withFreshLinkedinCache(deps, args, "li_requests", "requests", (cache) => {
+	deps.printData(cache.query(`SELECT r.*, p.handle AS user_handle, p.display_name AS user_name, p.avatar_url AS user_avatar_url, p.headline AS user_headline FROM li_requests r LEFT JOIN li_profiles p ON r.user_id = p.provider_id WHERE r.type = ${sqlString(requestType)} ORDER BY r.synced_at DESC${limitClause(deps, args.limit)}`));
+}, true);
+const readPosts = (deps, args) => withFreshLinkedinCache(deps, args, "li_posts", "posts", (cache) => {
+	deps.printData(cache.query(`SELECT * FROM li_posts ORDER BY created_at DESC${limitClause(deps, args.limit)}`));
+}, true);
+const buildPosts = (deps, liveCommand) => defineCommand({
+	meta: commandMeta$2({
+		name: "posts",
+		description: "List cached own LinkedIn posts or live target posts [read] | usage: `social linkedin posts [target] --limit N`",
+		method: "GET",
+		capability: "read",
+		mutates: false,
+		schemaContract: liveCommand.meta.schemaContract
+	}),
+	args: liveCommand.args,
+	run: async ({ args, rawArgs }) => {
+		const parsedArgs = args;
+		const target = typeof args.target === "string" ? args.target : Array.isArray(args._) && typeof args._[0] === "string" ? args._[0] : void 0;
+		if (target === void 0) {
+			rejectUnsupportedArgs("linkedin posts", parsedArgs, cacheReadArgNames);
+			await readPosts(deps, parsedArgs);
+			return;
+		}
+		await liveCommand.run?.({
+			rawArgs,
+			args: {
+				...parsedArgs,
+				target
+			},
+			cmd: liveCommand
+		});
+	}
+});
+const buildMessages$1 = (deps, listCommand) => {
 	const markCommand = buildMark(deps);
-	const listArgNames = [
-		"account",
-		"cursor",
-		"before",
-		"after",
-		"limit",
-		"header"
-	];
-	const readArgNames = [
-		"account",
-		"cursor",
-		"before",
-		"after",
-		"limit",
-		"header"
-	];
 	const markArgNames = ["account"];
 	return defineCommand({
 		meta: commandMeta$2({
@@ -14185,43 +14807,26 @@ const buildMessages$1 = (deps, listCommand, readCommand) => {
 			method: "GET",
 			capability: "read",
 			mutates: false,
-			schemaContract: listCommand.meta.schemaContract,
+			schemaContract: cacheReadSchemaContract(listCommand),
 			schemaSubCommands: { mark: markCommand }
 		}),
 		args: {
 			target: {
 				type: "positional",
 				required: false,
-				description: "LinkedIn conversation or profile target: chat_id:<id>, @handle, profile_id:<id>, a profile URL, or a messaging thread URL",
+				description: "LinkedIn conversation target: chat_id:<id> or a messaging thread URL",
 				valueHint: "target"
 			},
 			account: {
 				type: "string",
 				description: "Account selector: @handle or profile_id:<id>; overrides config default"
 			},
-			cursor: {
-				type: "string",
-				description: "Pagination cursor"
-			},
-			before: {
-				type: "string",
-				description: "Only conversations or messages before this ISO timestamp"
-			},
-			after: {
-				type: "string",
-				description: "Only conversations or messages after this ISO timestamp"
-			},
 			limit: {
 				type: "string",
-				description: "Rows to return; max 20 when listing conversations"
-			},
-			header: {
-				type: "string",
-				alias: "H",
-				description: "Request header for the UseSocial proxy, as Name: value"
+				description: "Rows to return"
 			}
 		},
-		run: async ({ args, rawArgs }) => {
+		run: async ({ args }) => {
 			const parsedArgs = args;
 			const positionals = Array.isArray(args._) ? args._.map(String) : [];
 			if (positionals[1] === "mark") {
@@ -14239,51 +14844,65 @@ const buildMessages$1 = (deps, listCommand, readCommand) => {
 				return;
 			}
 			const target = typeof args.target === "string" ? args.target : Array.isArray(args._) && typeof args._[0] === "string" ? args._[0] : void 0;
-			if (target === void 0) {
-				rejectMessagesArgs("linkedin messages", parsedArgs, listArgNames);
-				await listCommand.run?.({
-					rawArgs,
-					args: pickedArgs(parsedArgs, listArgNames),
-					cmd: listCommand
-				});
-				return;
-			}
-			rejectMessagesArgs("linkedin messages", parsedArgs, readArgNames);
-			const account = typeof args.account === "string" ? args.account : void 0;
-			const classified = await deps.classifyMessageTarget("target", target, {
-				platform: "linkedin",
-				account
-			});
-			if (classified.kind === "person") {
-				const chatId = await resolveProfileChatId({
-					account,
-					deps,
-					commandHeaderInput: args.header,
-					rawArgs,
-					profileId: classified.id,
-					target
-				});
-				await readCommand.run?.({
-					rawArgs,
-					args: {
-						...pickedArgs(parsedArgs, readArgNames),
-						target: `chat_id:${chatId}`
-					},
-					cmd: readCommand
-				});
-				return;
-			}
-			await readCommand.run?.({
-				rawArgs,
-				args: {
-					...pickedArgs(parsedArgs, readArgNames),
-					target
-				},
-				cmd: readCommand
-			});
+			rejectMessagesArgs("linkedin messages", parsedArgs, cacheReadArgNames);
+			const chatId = target === void 0 ? void 0 : chatIdFromCachedMessageTarget(deps, target);
+			await withFreshLinkedinCache(deps, parsedArgs, "li_messages", "messages", (cache) => {
+				const where = chatId === void 0 ? "" : ` WHERE m.chat_id = ${sqlString(chatId)}`;
+				deps.printData(cache.query(`SELECT m.*, p.handle AS sender_handle, p.display_name AS sender_name, p.avatar_url AS sender_avatar_url, p.headline AS sender_headline FROM li_messages m LEFT JOIN li_profiles p ON m.sender_id = p.provider_id${where} ORDER BY m.timestamp DESC${limitClause(deps, args.limit)}`));
+			}, true);
 		}
 	});
 };
+const buildConnections = (deps, baseCommand) => defineCommand({
+	meta: commandMeta$2({
+		name: "connections",
+		description: "List cached LinkedIn connections [read] | usage: `social linkedin connections --limit N`",
+		method: "GET",
+		capability: "read",
+		mutates: false,
+		schemaContract: cacheReadSchemaContract(baseCommand)
+	}),
+	args: {
+		account: {
+			type: "string",
+			description: "Account selector: @handle or profile_id:<id>; overrides config default"
+		},
+		limit: {
+			type: "string",
+			description: "Rows to return"
+		}
+	},
+	run: async ({ args }) => {
+		const parsedArgs = args;
+		rejectUnsupportedArgs("linkedin connections", parsedArgs, cacheReadArgNames);
+		await readConnections(deps, parsedArgs);
+	}
+});
+const buildRequestsRead = (deps, baseCommand, requestType) => defineCommand({
+	meta: commandMeta$2({
+		name: requestType,
+		description: `List cached ${requestType} LinkedIn connection requests [read] | usage: \`social linkedin requests ${requestType} --limit N\``,
+		method: "GET",
+		capability: "read",
+		mutates: false,
+		schemaContract: cacheReadSchemaContract(baseCommand)
+	}),
+	args: {
+		account: {
+			type: "string",
+			description: "Account selector: @handle or profile_id:<id>; overrides config default"
+		},
+		limit: {
+			type: "string",
+			description: "Rows to return"
+		}
+	},
+	run: async ({ args }) => {
+		const parsedArgs = args;
+		rejectUnsupportedArgs(`linkedin requests ${requestType}`, parsedArgs, cacheReadArgNames);
+		await readRequests(deps, parsedArgs, requestType);
+	}
+});
 const createLinkedinCommands = (deps) => {
 	const built = LINKEDIN_OPERATIONS.map((op) => ({
 		op,
@@ -14317,7 +14936,13 @@ const createLinkedinCommands = (deps) => {
 		subCommands[entry.op.config.command] = entry.command;
 	}
 	subCommands.message = buildMessage$1(deps, find("MessagesMessage"));
-	subCommands.messages = buildMessages$1(deps, find("MessagesList"), find("MessagesRead"));
+	subCommands.messages = buildMessages$1(deps, find("MessagesList"));
+	subCommands.connections = buildConnections(deps, find("UserConnections"));
+	subCommands.posts = buildPosts(deps, find("UserPosts"));
+	const requestsCommands = subCommands.requests?.subCommands;
+	if (requestsCommands === void 0) throw new Error("Missing LinkedIn requests command group");
+	requestsCommands.received = buildRequestsRead(deps, find("RequestsReceived"), "received");
+	requestsCommands.sent = buildRequestsRead(deps, find("RequestsSent"), "sent");
 	subCommands.sync = buildSync$1(deps, "linkedin");
 	subCommands.sql = buildSql$1(deps, "linkedin");
 	return defineCommand({
@@ -14579,6 +15204,70 @@ const { costBPSForCategory } = createPricing([
 		"featureId": "counts_all_request"
 	}
 ]);
+//#endregion
+//#region ../../packages/x/src/profiles.ts
+const XUser = looseObject({
+	id: string(),
+	username: string().optional(),
+	name: string().optional(),
+	profile_image_url: string().nullish(),
+	description: string().nullish()
+});
+const rowFrom = (user) => {
+	const providerId = user.id.trim();
+	if (!providerId) return null;
+	const handle = user.username?.trim() || null;
+	const displayName = user.name?.trim() || handle || "";
+	if (!displayName) return null;
+	return {
+		providerId,
+		handle,
+		displayName,
+		avatarURL: user.profile_image_url?.trim() || null,
+		headline: user.description?.trim() || null,
+		raw: user
+	};
+};
+const SingleBody = looseObject({ data: XUser });
+const extractProfile = (body) => {
+	const parsed = SingleBody.safeParse(body);
+	if (!parsed.success) return [];
+	const row = rowFrom(parsed.data.data);
+	return row ? [row] : [];
+};
+const ListBody = looseObject({ data: array(unknown()) });
+const extractList = (body) => {
+	const parsed = ListBody.safeParse(body);
+	if (!parsed.success) return [];
+	return parsed.data.data.flatMap((item) => {
+		const user = XUser.safeParse(item);
+		if (!user.success) return [];
+		const row = rowFrom(user.data);
+		return row ? [row] : [];
+	});
+};
+const IncludesUsersBody = looseObject({ includes: looseObject({ users: array(unknown()).optional() }).optional() });
+const extractIncludesUsers = (body) => {
+	const parsed = IncludesUsersBody.safeParse(body);
+	if (!parsed.success) return [];
+	return (parsed.data.includes?.users ?? []).flatMap((item) => {
+		const user = XUser.safeParse(item);
+		if (!user.success) return [];
+		const row = rowFrom(user.data);
+		return row ? [row] : [];
+	});
+};
+const xProfileExtractors = {
+	"GET /dm_conversations/:id/dm_events": extractIncludesUsers,
+	"GET /dm_events": extractIncludesUsers,
+	"GET /lists/:id/members": extractList,
+	"GET /tweets/:id/liking_users": extractList,
+	"GET /tweets/:id/retweeted_by": extractList,
+	"GET /users/:id": extractProfile,
+	"GET /users/:id/followers": extractList,
+	"GET /users/:id/following": extractList,
+	"GET /users/by/username/:username": extractProfile
+};
 const X_OPERATIONS = [
 	{
 		schemaBaseName: "TweetsDelete",
@@ -17314,14 +18003,14 @@ const buildArgs = (op) => {
 	};
 	return args;
 };
-const camelCaseArg = (name) => name.replace(/[-_.]+([A-Za-z0-9])/g, (_match, next) => next.toUpperCase());
-const snakeCaseArg = (name) => name.replace(/[-.]+/g, "_");
-const argAliases = (name) => {
+const camelCaseArg$1 = (name) => name.replace(/[-_.]+([A-Za-z0-9])/g, (_match, next) => next.toUpperCase());
+const snakeCaseArg$1 = (name) => name.replace(/[-.]+/g, "_");
+const argAliases$1 = (name) => {
 	const aliases = new Set([
 		name,
-		camelCaseArg(name),
+		camelCaseArg$1(name),
 		flagName(name),
-		snakeCaseArg(name)
+		snakeCaseArg$1(name)
 	]);
 	if (name.startsWith("no-")) aliases.add(name.slice(3));
 	if (name === "header") aliases.add("H");
@@ -17329,7 +18018,7 @@ const argAliases = (name) => {
 };
 const knownArgNamesFor = (op) => {
 	const names = new Set(["_"]);
-	for (const name of Object.keys(buildArgs(op))) for (const alias of argAliases(name)) names.add(alias);
+	for (const name of Object.keys(buildArgs(op))) for (const alias of argAliases$1(name)) names.add(alias);
 	return names;
 };
 const unsupportedFlagError = (name, value) => {
@@ -17340,7 +18029,7 @@ const unsupportedFlagError = (name, value) => {
 		message: `${flag} is not supported by this command.`
 	}]);
 };
-const rejectUnknownArgs = (op, args) => {
+const rejectUnknownArgs$1 = (op, args) => {
 	const known = knownArgNamesFor(op);
 	for (const [name, value] of Object.entries(args)) if (!known.has(name)) throw unsupportedFlagError(name, value);
 };
@@ -17369,6 +18058,7 @@ const parseQueryValue = (deps, param, value, displayName) => {
 	}));
 	return deps.parseQueryString(displayName, value);
 };
+const mergePresetQueryValue = (preset, value) => Array.from(new Set(`${preset},${value}`.split(",").map((part) => part.trim()).filter(Boolean))).join(",");
 const setQueryParams = (deps, op, input, params) => {
 	const positionalQuery = new Set(op.config.positionalQueryParams ?? []);
 	for (const param of op.parameters.filter((p) => p.in === "query")) {
@@ -17384,8 +18074,10 @@ const setQueryParams = (deps, op, input, params) => {
 		}
 		const displayName = positionalQuery.has(param.name) ? flagName(param.name) : `--${cliFlagNameFor(param.name)}`;
 		const preset = op.config.fieldPresets?.[param.name];
-		if (value !== void 0) params.set(param.name, parseQueryValue(deps, param, value, displayName));
-		else if (preset !== void 0) params.set(param.name, deps.parseQueryString(displayName, preset));
+		if (value !== void 0) {
+			const parsedValue = parseQueryValue(deps, param, value, displayName);
+			params.set(param.name, preset === void 0 ? parsedValue : mergePresetQueryValue(deps.parseQueryString(displayName, preset), parsedValue));
+		} else if (preset !== void 0) params.set(param.name, deps.parseQueryString(displayName, preset));
 	}
 };
 const needsOwnAccount = (op) => op.parameters.some((p) => p.in === "path" && ownMode(op, p.name) !== void 0);
@@ -17456,7 +18148,7 @@ const resolveBodyTextFromStdin = async (op, deps, args, commandLabel) => {
 	else if (required) throw noBodyTextError$1(commandLabel);
 };
 const runOperation = async (op, contract, deps, args, rawArgs = []) => {
-	rejectUnknownArgs(op, args);
+	rejectUnknownArgs$1(op, args);
 	await resolveBodyTextFromStdin(op, deps, args, [
 		"social",
 		"x",
@@ -17591,28 +18283,69 @@ const defineOperationCommand = (op, deps) => {
 //#region ../../packages/x/src/cli/commands.ts
 const hiddenRootCommands = new Set(["search"]);
 const isObjectRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const confirmTTY = async (message) => {
-	const readline = createInterface({
-		input: process.stdin,
-		output: process.stdout
-	});
-	try {
-		const answer = await readline.question(`${message} [y/N] `);
-		return /^(y|yes)$/i.test(answer.trim());
-	} finally {
-		readline.close();
-	}
-};
 const requireAccountSelector = (selector) => {
 	if (selector === void 0) throw new UsageError("Selected X account is missing an account selector.");
 	return selector;
 };
+const xSyncCountFields = {
+	x_followers: "followers_count",
+	x_following: "following_count",
+	x_tweets: "tweet_count"
+};
+const ownMetricCount = async (args) => {
+	const field = xSyncCountFields[args.collectionKey];
+	if (field === void 0) return null;
+	const params = new URLSearchParams({ "user.fields": "public_metrics" });
+	const body = await (await args.deps.api.get(`x/users/${encodeURIComponent(args.ownId)}?${params.toString()}`, { headers: args.accountHeaders })).json();
+	const data = isObjectRecord(body) ? body.data : void 0;
+	const publicMetrics = isObjectRecord(data) ? data.public_metrics : void 0;
+	const count = isObjectRecord(publicMetrics) ? publicMetrics[field] : void 0;
+	return typeof count === "number" && Number.isFinite(count) ? count : null;
+};
+const syncQuoteLine = (estCredits, quoteLine) => `Estimated ~${Math.ceil(estCredits)} credits.\n${quoteLine}\n`;
+const autoCapPartialLine = () => `Hit the ${AUTO_CAP_CREDITS} credit auto-cap (partial). Re-run with --credits <N> to continue.\n`;
 const buildSync = (deps, platform) => defineCommand({
-	meta: {
+	meta: commandMeta$1({
 		name: "sync",
 		description: "Sync a collection into the local cache (spends credits)",
-		hidden: true
-	},
+		method: "GET",
+		capability: "read",
+		mutates: true,
+		contract: {
+			auth: {
+				required: true,
+				scopes: ["read"]
+			},
+			capability: "read",
+			confirmation: {
+				required: true,
+				recommended: true,
+				description: "Sync can spend usage credits and writes local cache state."
+			},
+			idempotency: {
+				kind: "non-idempotent",
+				description: "Repeated syncs can spend additional usage credits and update local rows."
+			},
+			method: "GET",
+			mutates: true,
+			outputSchema: unknown(),
+			pagination: { style: "none" },
+			responseShaping: { supported: false },
+			examples: [{ command: "social x sync followers --credits 1000" }],
+			cost: {
+				metered: true,
+				unit: "usage_credit",
+				notes: ["Upstream reads during sync are metered."]
+			},
+			hazards: [{
+				code: "local_cache_write",
+				message: "Writes synced X rows and cursor state to the local cache."
+			}, {
+				code: "usage_credit_spend",
+				message: "May spend usage credits while reading upstream X data."
+			}]
+		}
+	}),
 	args: {
 		collection: {
 			type: "positional",
@@ -17623,15 +18356,13 @@ const buildSync = (deps, platform) => defineCommand({
 			type: "string",
 			description: "ISO date/datetime or compact duration like 2:days|3:weeks|5:hours"
 		},
-		"billing-limit": {
+		credits: {
 			type: "string",
-			default: "10",
-			description: "Hard cap on spend in USD (default 10)"
+			description: "Consent and hard cap in credits"
 		},
-		yes: {
+		reset: {
 			type: "boolean",
-			default: false,
-			description: "Skip the TTY confirmation"
+			description: "Delete local rows and sync state for the selected collection"
 		},
 		account: {
 			type: "string",
@@ -17639,7 +18370,7 @@ const buildSync = (deps, platform) => defineCommand({
 		}
 	},
 	run: async ({ args }) => {
-		const collections = collectionsFor(platform);
+		const collections = syncableCollectionsFor(platform);
 		const shortName = (collection) => collection.key.replace(/^(x|li)_/, "");
 		const account = typeof args.account === "string" ? args.account : void 0;
 		const res = await deps.resolveOwnXAccount({ account });
@@ -17647,6 +18378,7 @@ const buildSync = (deps, platform) => defineCommand({
 		const accountSelector = requireAccountSelector(res.account.selector);
 		const accountHeaders = { "x-social-account-id": accountSelector };
 		if (!args.collection) {
+			if (args.reset === true) throw new UsageError("--reset requires a collection");
 			const cache = openCache({
 				platform,
 				accountId: accountSelector
@@ -17667,24 +18399,63 @@ const buildSync = (deps, platform) => defineCommand({
 		}
 		const collection = collections.find((candidate) => shortName(candidate) === args.collection || candidate.key === args.collection);
 		if (!collection) throw new UsageError(`Unknown collection "${args.collection}". Available: ${collections.map(shortName).join(", ")}`);
+		if (args.reset === true) {
+			if (args.credits != null) throw new UsageError("--reset cannot be combined with --credits");
+			if (args.since != null) throw new UsageError("--reset cannot be combined with --since");
+			const cache = openCache({
+				platform,
+				accountId: accountSelector
+			});
+			const resetCollections = resetTablesFor(collection);
+			try {
+				deps.printData({
+					collection: collection.key,
+					reset: true,
+					tables: cache.reset({
+						tables: resetCollections.map((resetCollection) => resetCollection.key),
+						collections: resetCollections.map((resetCollection) => resetCollection.key)
+					})
+				});
+			} finally {
+				cache.close();
+			}
+			return;
+		}
 		let since;
 		if (args.since != null) {
 			if (!collection.sinceField) throw new UsageError(`${shortName(collection)} does not support --since`);
 			since = parseSince(String(args.since));
 		}
-		const limitUSD = Number(args["billing-limit"] ?? "10");
-		if (!Number.isFinite(limitUSD) || limitUSD <= 0) throw new UsageError("--billing-limit must be a positive number of USD");
-		const billingLimitCredits = usdToCredits(limitUSD);
+		const creditsArg = args.credits != null && args.credits !== "" ? Number(args.credits) : null;
+		if (creditsArg != null && (!Number.isFinite(creditsArg) || creditsArg < 0)) throw new UsageError("--credits must be a non-negative number of credits");
 		const cache = openCache({
 			platform,
 			accountId: accountSelector
 		});
-		const onEstimate = async (estimate) => {
-			const line = estimate.unknown ? `Estimated ~${estimate.perPageCredits} credits/page ($${estimate.perPageUSD.toFixed(2)}); total unknown, bounded by $${estimate.limitUSD.toFixed(2)}.` : `Estimated ~${estimate.estCredits} credits ($${(estimate.estUSD ?? 0).toFixed(2)}) across ${estimate.estPages} page(s); limit $${estimate.limitUSD.toFixed(2)}.`;
-			if (process.stdin.isTTY && !args.yes) {
-				process.stderr.write(`${line}\n`);
-				return await confirmTTY("Proceed with sync?");
-			}
+		const firstSync = cache.getCursor(collection.key)?.lastSynced == null;
+		const count = firstSync ? await ownMetricCount({
+			deps,
+			collectionKey: collection.key,
+			ownId,
+			accountHeaders
+		}) : null;
+		const plan = planSync({
+			collection,
+			creditsArg,
+			count,
+			firstSync
+		});
+		if (plan.mode === "quote") {
+			cache.close();
+			process.stderr.write(syncQuoteLine(plan.estCredits, plan.quoteLine));
+			return;
+		}
+		if (plan.mode === "reject") {
+			cache.close();
+			throw new UsageError(`${shortName(collection)}: ${plan.message}`);
+		}
+		const onEstimate = (estimate) => {
+			const line = estimate.unknown ? `Estimated ~${estimate.perPageCredits} credits/page; total unknown, bounded by ${estimate.limitCredits} credits.` : `Estimated ~${estimate.estCredits} credits across ${estimate.estPages} page(s); limit ${estimate.limitCredits} credits.`;
 			process.stderr.write(`${line}\n`);
 			return true;
 		};
@@ -17695,14 +18466,17 @@ const buildSync = (deps, platform) => defineCommand({
 				cache,
 				platform,
 				ownId,
-				accountHeaders
+				accountHeaders,
+				profileExtractors: xProfileExtractors
 			}, {
 				collection,
 				since,
-				billingLimitCredits,
+				expectedTotalCount: firstSync ? count : null,
+				billingLimitCredits: plan.billingLimitCredits,
 				onEstimate,
 				onProgress
 			});
+			if (plan.capAndGo && summary.stoppedReason === "credit-limit") process.stderr.write(autoCapPartialLine());
 			deps.printData(summary);
 		} finally {
 			cache.close();
@@ -17753,92 +18527,6 @@ const buildSql = (deps, platform) => defineCommand({
 		}
 	}
 });
-const defaultDMEventFields = [
-	"attachments",
-	"created_at",
-	"dm_conversation_id",
-	"entities",
-	"event_type",
-	"id",
-	"participant_ids",
-	"referenced_tweets",
-	"sender_id",
-	"text"
-].join(",");
-const defaultDMExpansions = [
-	"attachments.media_keys",
-	"participant_ids",
-	"referenced_tweets.id",
-	"sender_id"
-].join(",");
-const defaultDMUserFields = [
-	"affiliation",
-	"connection_status",
-	"created_at",
-	"description",
-	"entities",
-	"id",
-	"location",
-	"most_recent_tweet_id",
-	"name",
-	"pinned_tweet_id",
-	"profile_banner_url",
-	"profile_image_url",
-	"protected",
-	"public_metrics",
-	"receives_your_dm",
-	"subscription_type",
-	"url",
-	"username",
-	"verified",
-	"verified_type",
-	"withheld"
-].join(",");
-const defaultDMTweetFields = [
-	"article",
-	"attachments",
-	"author_id",
-	"card_uri",
-	"community_id",
-	"context_annotations",
-	"conversation_id",
-	"created_at",
-	"display_text_range",
-	"edit_controls",
-	"edit_history_tweet_ids",
-	"entities",
-	"geo",
-	"id",
-	"in_reply_to_user_id",
-	"lang",
-	"matched_media_notes",
-	"media_metadata",
-	"note_request_suggestions",
-	"note_tweet",
-	"paid_partnership",
-	"possibly_sensitive",
-	"public_metrics",
-	"referenced_tweets",
-	"reply_settings",
-	"scopes",
-	"source",
-	"suggested_source_links",
-	"suggested_source_links_with_counts",
-	"text",
-	"withheld"
-].join(",");
-const defaultDMMediaFields = [
-	"alt_text",
-	"duration_ms",
-	"height",
-	"media_key",
-	"preview_image_url",
-	"public_metrics",
-	"type",
-	"url",
-	"variants",
-	"width"
-].join(",");
 const messagesOp = {
 	schemaBaseName: "Messages",
 	hasBody: false,
@@ -17888,114 +18576,197 @@ const messageOp = {
 	},
 	parameters: []
 };
-const buildMessages = (deps) => {
-	const contract = contractFor$1(messagesOp, "messages", "");
+const operationForCommand = (command) => {
+	const op = X_OPERATIONS.find((candidate) => candidate.config.command === command);
+	if (op === void 0) throw new Error(`x_cli_operation_missing:${command}`);
+	return op;
+};
+const cacheReadArgs = () => ({
+	limit: {
+		type: "string",
+		description: "Rows to return"
+	},
+	account: {
+		type: "string",
+		description: "Account selector: @handle or profile_id:<id>; overrides config default"
+	}
+});
+const cacheReadContract = (op, commandName) => {
+	const { inputSchema: _inputSchema, ...contract } = contractFor$1(op, commandName, "");
+	return {
+		...contract,
+		pagination: { style: "none" }
+	};
+};
+const camelCaseArg = (name) => name.replace(/[-_.]+([A-Za-z0-9])/g, (_match, next) => next.toUpperCase());
+const snakeCaseArg = (name) => name.replace(/[-.]+/g, "_");
+const flagNameForArg = (name) => name.replace(/[_.]+/g, "-");
+const argAliases = (name) => {
+	const aliases = new Set([
+		name,
+		camelCaseArg(name),
+		flagNameForArg(name),
+		snakeCaseArg(name)
+	]);
+	if (name.startsWith("no-")) aliases.add(name.slice(3));
+	if (name === "header") aliases.add("H");
+	return aliases;
+};
+const rejectUnknownArgs = (args, argsDef) => {
+	const known = new Set(["_"]);
+	for (const name of Object.keys(argsDef)) for (const alias of argAliases(name)) known.add(alias);
+	for (const [name, value] of Object.entries(args)) {
+		if (value === void 0 || known.has(name)) continue;
+		const flag = value === false ? `--no-${flagNameForArg(name)}` : `--${flagNameForArg(name)}`;
+		throw new ZodError([{
+			code: "custom",
+			path: [name],
+			message: `${flag} is not supported by this command.`
+		}]);
+	}
+};
+const collectionForCacheRead = (key) => {
+	const collection = collectionByKey(key);
+	if (collection === void 0) throw new Error(`x_cache_collection_missing:${key}`);
+	return collection;
+};
+const parseOptionalLimit = (deps, value, max) => value === void 0 ? void 0 : deps.parseIntegerString("--limit", value, {
+	min: 1,
+	max
+});
+const appendLimit = (sql, limit) => limit === void 0 ? sql : `${sql} LIMIT ${limit}`;
+const withSender = (rows) => rows.map((row) => {
+	const { sender_handle: senderHandle, sender_name: senderName, sender_avatar_url: senderAvatarURL, sender_headline: senderHeadline, ...message } = row;
+	if (![
+		senderHandle,
+		senderName,
+		senderAvatarURL,
+		senderHeadline
+	].some((value) => value !== null && value !== void 0)) return message;
+	return {
+		...message,
+		sender: {
+			...typeof message.sender_id === "string" ? { id: message.sender_id } : {},
+			handle: senderHandle,
+			name: senderName,
+			avatar_url: senderAvatarURL,
+			headline: senderHeadline
+		}
+	};
+});
+const buildCacheRead = (deps, config) => {
+	const contract = cacheReadContract(config.operation, config.name);
 	return defineCommand({
 		meta: commandMeta$1({
-			name: "messages",
-			description: "List or read DM conversations [read] | usage: `social x messages [target] --limit N`",
+			name: config.name,
+			description: config.description,
 			method: "GET",
 			capability: "read",
 			mutates: false,
 			contract
 		}),
-		args: {
-			target: {
-				type: "positional",
-				required: false,
-				description: "Target conversation or participant: chat URL, chat_id:<id>, @handle, profile URL, or profile_id:<id>",
-				valueHint: "target"
-			},
-			limit: {
-				type: "string",
-				description: "Rows to return (1-100)"
-			},
-			cursor: {
-				type: "string",
-				description: "Cursor from a previous response"
-			},
-			"event-types": {
-				type: "string",
-				description: "Comma-separated event types to include"
-			},
-			"dm-event-fields": {
-				type: "string",
-				description: "DM event fields to request"
-			},
-			expansions: {
-				type: "string",
-				description: "DM event expansions to request"
-			},
-			"user-fields": {
-				type: "string",
-				description: "User fields to request"
-			},
-			"tweet-fields": {
-				type: "string",
-				description: "Tweet fields to request"
-			},
-			"media-fields": {
-				type: "string",
-				description: "Media fields to request"
-			},
-			account: {
-				type: "string",
-				description: "Account selector: @handle or profile_id:<id>; overrides config default"
-			}
-		},
+		args: cacheReadArgs(),
 		run: async ({ args }) => {
-			const positional = Array.isArray(args._) ? args._ : [];
-			const targetInput = args.target ?? (positional.length > 0 ? positional[0] : void 0);
-			const resolved = [];
-			const params = new URLSearchParams();
-			if (args.limit !== void 0) params.set("max_results", String(deps.parseIntegerString("--limit", args.limit, {
-				min: 1,
-				max: 100
-			})));
-			if (args.cursor !== void 0) params.set("pagination_token", deps.parseQueryString("--cursor", args.cursor));
-			if (args["event-types"] !== void 0) params.set("event_types", deps.parseQueryString("--event-types", args["event-types"]));
-			params.set("dm_event.fields", deps.parseQueryString("--dm-event-fields", args["dm-event-fields"] ?? defaultDMEventFields));
-			params.set("expansions", deps.parseQueryString("--expansions", args.expansions ?? defaultDMExpansions));
-			params.set("user.fields", deps.parseQueryString("--user-fields", args["user-fields"] ?? defaultDMUserFields));
-			params.set("tweet.fields", deps.parseQueryString("--tweet-fields", args["tweet-fields"] ?? defaultDMTweetFields));
-			params.set("media.fields", deps.parseQueryString("--media-fields", args["media-fields"] ?? defaultDMMediaFields));
-			const query = params.toString();
 			const account = typeof args.account === "string" ? args.account : void 0;
-			const selectedAccount = await deps.resolveAccount({
+			const res = await deps.resolveOwnXAccount({ account });
+			const ownId = res.xUserId;
+			const accountSelector = requireAccountSelector(res.account.selector);
+			const accountHeaders = { "x-social-account-id": accountSelector };
+			const cache = openCache({
 				platform: "x",
-				account
+				accountId: accountSelector
 			});
-			const accountIdHeader = selectedAccount.selector;
-			const headers = { ...accountIdHeader === void 0 ? {} : { "x-social-account-id": accountIdHeader } };
-			const targetResolved = targetInput === void 0 ? void 0 : await deps.classifyMessageTarget("target", targetInput, {
+			const collection = collectionForCacheRead(config.collectionKey);
+			const syncDeps = {
+				api: deps.api,
+				cache,
 				platform: "x",
-				account
-			});
-			if (targetResolved) resolved.push(targetResolved.record);
-			const targetPath = targetResolved === void 0 ? "x/dm_events" : targetResolved.kind === "thread" ? "x/dm_conversations/".concat(encodeURIComponent(targetResolved.id), "/dm_events") : "x/dm_conversations/with/".concat(encodeURIComponent(targetResolved.id), "/dm_events");
-			const requestPath = query ? targetPath.concat("?", query) : targetPath;
-			const response = await deps.api.get(requestPath, { headers });
-			const data = await response.json();
-			if (isObjectRecord(data) && Array.isArray(data.data)) {
-				const users = isObjectRecord(data.includes) ? data.includes.users : void 0;
-				const usersById = /* @__PURE__ */ new Map();
-				if (Array.isArray(users)) {
-					for (const user of users) if (isObjectRecord(user) && typeof user.id === "string") usersById.set(user.id, user);
-				}
-				if (usersById.size > 0) {
-					for (const event of data.data) if (isObjectRecord(event) && typeof event.sender_id === "string") {
-						const sender = usersById.get(event.sender_id);
-						if (sender !== void 0) event.sender = sender;
-					}
-				}
+				ownId,
+				accountHeaders,
+				profileExtractors: xProfileExtractors
+			};
+			try {
+				if ((await ensureFreshCache(syncDeps, {
+					collection,
+					ttlSeconds: config.refreshEveryCall === true ? 0 : void 0
+				})).status === "never-synced") throw new UsageError(`No synced ${config.name} yet. Run \`x sync ${config.name}\` first.`);
+				const limit = parseOptionalLimit(deps, args.limit, config.limitMax);
+				const rows = cache.query(appendLimit(config.sql, limit));
+				deps.printData(config.mapRows?.(rows) ?? rows);
+			} finally {
+				cache.close();
 			}
-			await deps.printResult({
-				account: selectedAccount,
-				contract,
-				data,
-				resolved,
-				responseHeaders: response.headers
-			});
+		}
+	});
+};
+const buildMessages = (deps) => {
+	return buildCacheRead(deps, {
+		name: "messages",
+		description: "List synced X DM messages [read] | usage: `social x messages --limit N`",
+		collectionKey: "x_messages",
+		limitMax: 100,
+		operation: messagesOp,
+		refreshEveryCall: true,
+		sql: "SELECT m.*, p.handle AS sender_handle, p.display_name AS sender_name, p.avatar_url AS sender_avatar_url, p.headline AS sender_headline FROM x_messages m LEFT JOIN x_profiles p ON m.sender_id = p.provider_id ORDER BY m.created_at DESC",
+		mapRows: withSender
+	});
+};
+const buildFollowers = (deps) => buildCacheRead(deps, {
+	name: "followers",
+	description: "List synced X followers [read] | usage: `social x followers --limit N`",
+	collectionKey: "x_followers",
+	limitMax: 1e3,
+	operation: operationForCommand("followers"),
+	sql: "SELECT * FROM x_followers ORDER BY synced_at DESC"
+});
+const buildFollowing = (deps) => buildCacheRead(deps, {
+	name: "following",
+	description: "List synced X following [read] | usage: `social x following --limit N`",
+	collectionKey: "x_following",
+	limitMax: 1e3,
+	operation: operationForCommand("following"),
+	sql: "SELECT * FROM x_following ORDER BY synced_at DESC"
+});
+const buildBookmarks = (deps) => buildCacheRead(deps, {
+	name: "bookmarks",
+	description: "List synced X bookmarks [read] | usage: `social x bookmarks --limit N`",
+	collectionKey: "x_bookmarks",
+	limitMax: 100,
+	operation: operationForCommand("bookmarks"),
+	refreshEveryCall: true,
+	sql: "SELECT * FROM x_bookmarks ORDER BY created_at DESC"
+});
+const hasTargetArg = (args) => {
+	const positional = Array.isArray(args._) ? args._ : [];
+	return args.target !== void 0 || positional.length > 0;
+};
+const buildTweets = (deps) => {
+	const operation = operationForCommand("tweets");
+	const liveTweets = defineOperationCommand(operation, deps);
+	const cacheTweets = buildCacheRead(deps, {
+		name: "tweets",
+		description: "List synced X tweets [read] | usage: `social x tweets --limit N`",
+		collectionKey: "x_tweets",
+		limitMax: 100,
+		operation,
+		refreshEveryCall: true,
+		sql: "SELECT * FROM x_tweets ORDER BY created_at DESC"
+	});
+	const args = {
+		...liveTweets.args ?? {},
+		...cacheReadArgs()
+	};
+	return defineCommand({
+		meta: liveTweets.meta,
+		args,
+		run: async (ctx) => {
+			const runArgs = ctx.args;
+			if (hasTargetArg(runArgs)) {
+				await liveTweets.run?.(ctx);
+				return;
+			}
+			rejectUnknownArgs(runArgs, args);
+			await cacheTweets.run?.(ctx);
 		}
 	});
 };
@@ -18189,6 +18960,10 @@ const buildReplies = (deps) => {
 };
 const createXCommands = (deps) => {
 	const messages = buildMessages(deps);
+	const followers = buildFollowers(deps);
+	const following = buildFollowing(deps);
+	const bookmarks = buildBookmarks(deps);
+	const tweets = buildTweets(deps);
 	const message = buildMessage(deps);
 	const replies = buildReplies(deps);
 	const sync = buildSync(deps, "x");
@@ -18200,30 +18975,50 @@ const createXCommands = (deps) => {
 		index
 	})).filter((entry) => !hiddenRootCommands.has(entry.name));
 	entries.push({
+		name: "followers",
+		command: followers,
+		rank: 0,
+		index: X_OPERATIONS.length
+	}, {
+		name: "following",
+		command: following,
+		rank: 0,
+		index: X_OPERATIONS.length + 1
+	}, {
 		name: "messages",
 		command: messages,
 		rank: 0,
-		index: X_OPERATIONS.length
+		index: X_OPERATIONS.length + 2
+	}, {
+		name: "bookmarks",
+		command: bookmarks,
+		rank: 0,
+		index: X_OPERATIONS.length + 3
+	}, {
+		name: "tweets",
+		command: tweets,
+		rank: 0,
+		index: X_OPERATIONS.length + 4
 	}, {
 		name: "message",
 		command: message,
 		rank: 1,
-		index: X_OPERATIONS.length + 1
+		index: X_OPERATIONS.length + 5
 	}, {
 		name: "replies",
 		command: replies,
 		rank: 0,
-		index: X_OPERATIONS.length + 2
+		index: X_OPERATIONS.length + 6
 	}, {
 		name: "sync",
 		command: sync,
 		rank: 0,
-		index: X_OPERATIONS.length + 3
+		index: X_OPERATIONS.length + 7
 	}, {
 		name: "sql",
 		command: sql,
 		rank: 0,
-		index: X_OPERATIONS.length + 4
+		index: X_OPERATIONS.length + 8
 	});
 	entries.sort((left, right) => left.rank - right.rank || left.index - right.index);
 	return defineCommand({
@@ -18412,19 +19207,6 @@ const disconnectLinkedinAccount = async (deps, identifier) => {
 	};
 };
 //#endregion
-//#region ../../packages/lib/src/url.ts
-const stripTrailingSlashes = (value) => value.replace(/\/+$/, "");
-const stripLeadingSlashes = (value) => value.replace(/^\/+/, "");
-const ensureTrailingSlash = (value) => value.endsWith("/") ? value : `${value}/`;
-const absoluteURLPathPattern = /^[a-z][a-z0-9+.-]*:/i;
-const protocolRelativeURLPathPattern = /^\/\//;
-const createURL = (baseURL, path) => {
-	const trimmedPath = path.trimStart();
-	if (absoluteURLPathPattern.test(trimmedPath) || protocolRelativeURLPathPattern.test(trimmedPath)) throw new Error("createURL: path must be relative, not absolute or protocol-relative");
-	return new URL(stripLeadingSlashes(path), ensureTrailingSlash(stripTrailingSlashes(baseURL.toString())));
-};
-const createAbsoluteURL = (baseURL, path) => createURL(baseURL, path).toString();
-//#endregion
 //#region ../../packages/x/src/cli/lifecycle.ts
 const CONNECT_TIMEOUT_MS = 300 * 1e3;
 const SEAT_POLL_TIMEOUT_MS$1 = 600 * 1e3;
@@ -21110,7 +21892,7 @@ const createInstance = (defaults) => {
 const ky = createInstance();
 //#endregion
 //#region package.json
-var version$1 = "0.4.0";
+var version$1 = "0.6.0";
 //#endregion
 //#region src/lib/env.ts
 const URLWithTrailingSlash = url().transform(ensureTrailingSlash);
@@ -21237,6 +22019,8 @@ const clearCredentials = async (apiURL = activeAPIURL()) => {
 };
 //#endregion
 //#region src/lib/api.ts
+const LINKEDIN_RATE_LIMIT_RETRY_LIMIT = 25;
+const LINKEDIN_RATE_LIMIT_MAX_FALLBACK_SECONDS = 60;
 var CLIAPIError = class extends Error {
 	status;
 	body;
@@ -21254,14 +22038,45 @@ const readBearerToken = async () => {
 	if (!credentials?.accessToken) throw new AuthError("Not logged in. Run `social account login` first.");
 	return credentials.accessToken;
 };
-const api = ky.create({
+const linkedInRateLimitFallbackDelaySeconds = (retryCount) => Math.min(2 ** Math.max(0, retryCount - 1), LINKEDIN_RATE_LIMIT_MAX_FALLBACK_SECONDS);
+const linkedInRateLimitRetryDelaySeconds = (retryCount, retryAfterSeconds) => retryAfterSeconds ?? linkedInRateLimitFallbackDelaySeconds(retryCount);
+const isLinkedInProxyRequest = (request) => new URL(request.url).pathname.includes("/linkedin/");
+const shouldRetryLinkedInRateLimit = (args) => args.error instanceof HTTPError && args.error.response.status === 429 && isLinkedInProxyRequest(args.error.request) && args.retryCount <= LINKEDIN_RATE_LIMIT_RETRY_LIMIT;
+const writeRateLimitRetryNotice = (args) => {
+	process.stderr.write(`LinkedIn rate limited; waiting ${args.delaySeconds}s before retry ${args.retryCount}/${LINKEDIN_RATE_LIMIT_RETRY_LIMIT}.\n`);
+};
+const createAPI = (opts = {}) => ky.create({
 	prefix: env.SOCIAL_API_URL,
+	fetch: opts.fetch,
 	timeout: false,
-	retry: 0,
+	retry: {
+		limit: LINKEDIN_RATE_LIMIT_RETRY_LIMIT,
+		methods: [
+			"get",
+			"post",
+			"patch",
+			"put",
+			"delete"
+		],
+		statusCodes: [429],
+		afterStatusCodes: [429],
+		delay: (retryCount) => linkedInRateLimitFallbackDelaySeconds(retryCount) * 1e3,
+		shouldRetry: ({ error, retryCount }) => {
+			if (!shouldRetryLinkedInRateLimit({
+				error,
+				retryCount
+			})) return false;
+			const retryAfterSeconds = error instanceof HTTPError ? retryAfterSecondsFrom(error.response.headers.get("retry-after")) : void 0;
+			(opts.onRateLimitRetry ?? writeRateLimitRetryNotice)({
+				delaySeconds: linkedInRateLimitRetryDelaySeconds(retryCount, retryAfterSeconds),
+				retryCount
+			});
+		}
+	},
 	hooks: {
 		beforeRequest: [async ({ request, options }) => {
 			if (typeof options.body === "string" && !request.headers.has("content-type")) request.headers.set("content-type", "application/json");
-			request.headers.set("authorization", `Bearer ${await readBearerToken()}`);
+			request.headers.set("authorization", `Bearer ${await (opts.readBearerToken ?? readBearerToken)()}`);
 			request.headers.set("x-social-surface", "cli");
 		}],
 		beforeError: [({ error }) => {
@@ -21271,6 +22086,7 @@ const api = ky.create({
 		}]
 	}
 });
+const api = createAPI();
 const authAPI = ky.create({
 	prefix: apiURL("auth"),
 	timeout: false,
@@ -21628,7 +22444,7 @@ const totalCountFrom = (contract, data) => {
 	if (!isRecord$3(pagination)) return;
 	return numberAtPath(data, pagination.totalCountPath);
 };
-const resultEnvelope = ({ account, contract, data, resolved = [], responseHeaders }) => {
+const resultEnvelope = ({ account, contract, data, resolved = [], responseHeaders, usage }) => {
 	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;
@@ -21645,7 +22461,8 @@ const resultEnvelope = ({ account, contract, data, resolved = [], responseHeader
 			cost: costFromContract(contract, itemCount, cache.hit, responseHeaders),
 			cache,
 			...cursor === void 0 ? {} : { cursor },
-			...totalCount === void 0 ? {} : { totalCount }
+			...totalCount === void 0 ? {} : { totalCount },
+			...usage === void 0 ? {} : { usage }
 		}
 	};
 };
@@ -22038,6 +22855,97 @@ const configCommand = defineCommand({
 	}) }
 });
 //#endregion
+//#region src/billing/index.ts
+const readAuthContract$1 = {
+	required: true,
+	scope: "read"
+};
+const BillingOutput = object({
+	seats: object({
+		total: number().int().nonnegative(),
+		used: number().int().nonnegative(),
+		available: number().int().nonnegative()
+	}),
+	subscription: object({
+		active: boolean$1(),
+		quantity: number().int().nonnegative(),
+		currentPeriodEnd: string().nullable()
+	}).nullable(),
+	usage: object({
+		calls: object({ total: number().int().nonnegative() }),
+		credits: object({
+			included: number().nonnegative(),
+			used: number().nonnegative()
+		})
+	})
+});
+const BillingPortalOutput = object({
+	url: string(),
+	opened: boolean$1()
+});
+const writeOutput$2 = async (deps, value) => {
+	if (deps.writeOutput) {
+		await deps.writeOutput(value);
+		return;
+	}
+	printData(value);
+};
+const clientFrom = (deps) => deps.client ?? createORPCAPIClient();
+const createBillingCommand = (deps = {}) => {
+	const portal = defineCommand({
+		meta: commandMeta({
+			name: "portal",
+			description: "Open the hosted billing portal.",
+			capability: "read",
+			contract: {
+				capability: "read",
+				auth: readAuthContract$1,
+				mutates: false,
+				outputSchema: BillingPortalOutput,
+				confirmation: {
+					required: true,
+					reason: "Opens a hosted billing portal where payment methods, seats, plan, and cancellation can be managed."
+				},
+				hazards: [{
+					code: "billing_portal_handoff",
+					message: "Hosted billing portal handoff; billing changes happen outside the CLI after the URL opens."
+				}]
+			}
+		}),
+		run: async () => {
+			const { url } = await clientFrom(deps).billing.portalURL();
+			const result = deps.isInteractiveTerminal?.() === true && deps.openURL !== void 0 ? await deps.openURL?.(url) : void 0;
+			await writeOutput$2(deps, {
+				url: result?.url ?? url,
+				opened: result?.opened === true
+			});
+		}
+	});
+	return defineCommand({
+		meta: commandMeta({
+			name: "billing",
+			description: "Show billing status and manage the hosted billing portal.",
+			capability: "read",
+			contract: {
+				capability: "read",
+				auth: readAuthContract$1,
+				mutates: false,
+				outputSchema: BillingOutput
+			}
+		}),
+		subCommands: { portal },
+		run: async () => {
+			const client = clientFrom(deps);
+			const [status, usage] = await Promise.all([client.billing.status(), client.usage.summary({})]);
+			await writeOutput$2(deps, {
+				seats: status.seats,
+				subscription: status.subscription,
+				usage
+			});
+		}
+	});
+};
+//#endregion
 //#region ../../node_modules/.bun/posthog-node@5.35.6+63120419cc93e79b/node_modules/posthog-node/dist/extensions/error-tracking/modifiers/module.node.mjs
 function createModulerModifier() {
 	const getModuleFromFileName = createGetModuleFromFilename();
@@ -23937,7 +24845,7 @@ async function addSourceContext(frames) {
 function getContextLinesFromFile(path, ranges, output) {
 	return new Promise((resolve) => {
 		const stream = createReadStream(path);
-		const lineReaded = createInterface$1({ input: stream });
+		const lineReaded = createInterface({ input: stream });
 		function destroyStreamAndResolve() {
 			stream.destroy();
 			resolve();
@@ -28138,13 +29046,8 @@ const UsageLogsOutput = object({
 const UsageSummaryOutput = object({
 	calls: object({ total: number().int().nonnegative() }),
 	credits: object({
-		available: number().nonnegative(),
-		used: number().nonnegative(),
-		additional: number().nonnegative()
-	}),
-	billing: object({
-		seats: number().nonnegative(),
-		usage: number().nonnegative()
+		included: number().nonnegative(),
+		used: number().nonnegative()
 	})
 });
 const createUsageLogsCommand = (deps = {}) => defineCommand({
@@ -28469,6 +29372,7 @@ const createAccountCommand = (deps) => {
 				})
 			}
 		}),
+		billing: createBillingCommand(deps),
 		usage: createUsageCommand(deps),
 		logs: createUsageLogsCommand(deps),
 		config: configCommand
@@ -28636,6 +29540,17 @@ const commandHeadersFrom = (defaults, args = {}) => {
 };
 const createCLIDeps = () => {
 	const client = createORPCAPIClient();
+	const printResultWithUsage = async (args) => {
+		try {
+			const usage = await client.usage.summary({});
+			printResult({
+				...args,
+				usage
+			});
+		} catch {
+			printResult(args);
+		}
+	};
 	const resolveAccount = async ({ account, platform }) => {
 		if (account) resolveAccountId({ account });
 		const accounts = await client.accounts.list({
@@ -28700,11 +29615,7 @@ const createCLIDeps = () => {
 			},
 			billing: {
 				status: async () => {
-					const status = await client.billing.status();
-					return {
-						canConnect: status.canConnect,
-						seats: status.seats
-					};
+					return await client.billing.status();
 				},
 				prepareAccountConnect: async () => {
 					const status = await client.billing.prepareAccountConnect();
@@ -28714,7 +29625,8 @@ const createCLIDeps = () => {
 						requiredAction: status.requiredAction,
 						seats: status.seats
 					};
-				}
+				},
+				portalURL: client.billing.portalURL
 			},
 			usage: {
 				summary: client.usage.summary,
@@ -28747,7 +29659,7 @@ const createCLIDeps = () => {
 		}),
 		commandHeaders: async (args) => commandHeadersFrom({ "Cache-Control": await cacheControlHeaderFromConfig() }, args),
 		printData,
-		printResult,
+		printResult: printResultWithUsage,
 		resolveAccount,
 		resolveAccountId: async (args) => resolveAccountId(args),
 		resolveOwnXAccount: async ({ account }) => {