@usesocial/cli 0.9.0 → 0.10.1

package/dist/index.mjs

@@ -334,11 +334,12 @@ const buildRuntimeArgs = (adapter, op) => {
 	};
 	for (const [name, param] of Object.entries(op.config.bodyParams ?? {})) {
 		const argName = bodyParamArgFor(adapter, name, param);
+		const valueHint = param.valueHint ?? flagName(argName);
 		args[flagName(argName)] = {
 			type: param.positional ? "positional" : "string",
 			required: param.required === true,
 			description: param.description ?? `${name} body value`,
-			valueHint: param.valueHint ?? flagName(argName)
+			valueHint: param.kind === "array" ? `${valueHint}...` : valueHint
 		};
 	}
 	if (op.config.mediaArg) args[flagName(op.config.mediaArg)] = {
@@ -363,6 +364,7 @@ const buildRuntimeArgs = (adapter, op) => {
 		type: "string",
 		description: "Account selector: @username or profile_id:<id>; overrides config default"
 	};
+	for (const [name, def] of Object.entries(adapter.extraArgsFor?.(op) ?? {})) args[name] = def;
 	if (adapter.isCacheable(op.endpoint)) args.header = {
 		type: "string",
 		alias: "H",
@@ -432,7 +434,8 @@ const buildRuntimeInput = (adapter, op, args) => {
 		input.body = args.body;
 		if (op.config.bodyTextArg) input[op.config.bodyTextArg] = args[bodyTextDisplayKeyFor(op) ?? op.config.bodyTextArg];
 		Object.entries(op.config.bodyParams ?? {}).forEach(([name, param], index) => {
-			input[name] = args[flagName(bodyParamArgFor(adapter, name, param))] ?? (Array.isArray(args._) ? args._[index] : void 0);
+			const argName = bodyParamArgFor(adapter, name, param);
+			input[name] = param.positional && param.kind === "array" && Array.isArray(args._) && args._.length > 0 ? args._ : args[flagName(argName)] ?? (Array.isArray(args._) ? args._[index] : void 0);
 		});
 		if (op.config.replyToArg) input[op.config.replyToArg] = args[op.config.replyToArg];
 	}
@@ -445,7 +448,10 @@ const checkBodyRequired = (adapter, op, args, bodyTextOptional) => {
 	const expressions = [];
 	const bodyTextArg = op.config.bodyTextArg;
 	if (bodyTextArg && op.config.bodyTextRequired !== false) expressions.push(args[bodyTextDisplayKeyFor(op) ?? bodyTextArg] === void 0);
-	for (const [name, param] of Object.entries(op.config.bodyParams ?? {})) if (param.required) expressions.push(args[flagName(bodyParamArgFor(adapter, name, param))] === void 0);
+	for (const [name, param] of Object.entries(op.config.bodyParams ?? {})) if (param.required) {
+		const positionalValuePresent = param.positional && Array.isArray(args._) && args._.length > 0;
+		expressions.push(args[flagName(bodyParamArgFor(adapter, name, param))] === void 0 && !positionalValuePresent);
+	}
 	if (expressions.length > 0 && typeof args.body !== "string" && expressions.some(Boolean)) throw bodyRequiredPreparseError(adapter, op);
 };
 const buildBody = (adapter, deps, op, input, bodyTextOptional) => {
@@ -458,7 +464,8 @@ const buildBody = (adapter, deps, op, input, bodyTextOptional) => {
 	const bodyParamValues = /* @__PURE__ */ new Map();
 	for (const [name, param] of bodyParamEntries) {
 		const value = input[name];
-		bodyParamValues.set(name, value === void 0 ? param.default : deps.parseQueryString(param.positional ? bodyParamArgFor(adapter, name, param) : `--${bodyParamArgFor(adapter, name, param)}`, value));
+		const displayName = param.positional ? bodyParamArgFor(adapter, name, param) : `--${bodyParamArgFor(adapter, name, param)}`;
+		bodyParamValues.set(name, value === void 0 ? param.default : param.kind === "array" ? deps.parseResourceIdList(displayName, Array.isArray(value) ? value : [value]) : deps.parseQueryString(displayName, value));
 	}
 	const body = { ...bodyFromJSON ?? {} };
 	for (const [name] of bodyParamEntries) {
@@ -626,6 +633,16 @@ const runRuntimeOperation = async (adapter, op, contract, deps, args, rawArgs =
 		}
 	}
 	for (const param of op.parameters.filter((candidate) => candidate.in === "path")) {
+		if (input[param.name] === void 0) {
+			const seeded = await adapter.seedPathValue?.({
+				op,
+				param,
+				args,
+				deps,
+				account
+			});
+			if (seeded !== void 0) input[param.name] = seeded;
+		}
 		const mode = ownMode$1(op, param.name);
 		const display = positionalDisplayKeyFor$1(op, param);
 		let resolution;
@@ -752,7 +769,7 @@ const defineRuntimeOperationCommand = (adapter, op, deps) => {
 	});
 };
 //#endregion
-//#region ../../packages/sync-engine/src/collections/linkedin.ts
+//#region ../../packages/sqlsync/src/collections/linkedin.ts
 const linkedinCursorPagination = {
 	style: "cursor",
 	limitParam: "limit",
@@ -1072,7 +1089,7 @@ const LINKEDIN_CACHE_METADATA = {
 	}
 };
 //#endregion
-//#region ../../packages/sync-engine/src/collections/x.ts
+//#region ../../packages/sqlsync/src/collections/x.ts
 const xPagination = {
 	style: "cursor",
 	limitParam: "max_results",
@@ -1216,6 +1233,21 @@ const X_COLLECTIONS = [
 		expectedFields: expectedTweetFields,
 		lift: liftTweet
 	},
+	{
+		key: "x_timeline",
+		table: "x_timeline_raw",
+		platform: "x",
+		requests: [{
+			path: "/users/:id/timelines/reverse_chronological",
+			bakedQuery: defaultTweetBakedQuery
+		}],
+		ownIdToken: ":id",
+		pagination: xPagination,
+		pageSize: 100,
+		sinceField: "created_at",
+		expectedFields: expectedTweetFields,
+		lift: liftTweet
+	},
 	{
 		key: "x_followers",
 		table: "x_followers_raw",
@@ -1313,7 +1345,8 @@ const X_CACHE_METADATA = {
 		"x_messages.sender_id = x_profiles.provider_id",
 		"x_messages.counterpart_id = x_profiles.provider_id",
 		"x_conversation_participants.participant_id = x_profiles.provider_id",
-		"x_followers.id = x_profiles.provider_id"
+		"x_followers.id = x_profiles.provider_id",
+		"x_timeline.author_id = x_profiles.provider_id"
 	],
 	enums: {
 		"x_followers.verified_type": [
@@ -1364,6 +1397,11 @@ const X_CACHE_METADATA = {
 			"sender_id"
 		],
 		x_profiles: ["username"],
+		x_timeline: [
+			"created_at",
+			"author_id",
+			"conversation_id"
+		],
 		x_tweets: [
 			"created_at",
 			"author_id",
@@ -1372,7 +1410,7 @@ const X_CACHE_METADATA = {
 	}
 };
 //#endregion
-//#region ../../packages/sync-engine/src/collections/index.ts
+//#region ../../packages/sqlsync/src/collections/index.ts
 const COLLECTIONS = [...X_COLLECTIONS, ...LINKEDIN_COLLECTIONS];
 const CACHE_METADATA_BY_PLATFORM = {
 	linkedin: LINKEDIN_CACHE_METADATA,
@@ -1392,7 +1430,7 @@ const resetTablesFor = (collection) => {
 };
 const resetPhysicalTablesFor = (collection) => resetTablesFor(collection).map(physicalTableFor);
 //#endregion
-//#region ../../packages/sync-engine/src/migrations.generated.ts
+//#region ../../packages/sqlsync/src/migrations.generated.ts
 const MIGRATIONS = [
 	{
 		"tag": "0000_modern_stephen_strange",
@@ -1433,10 +1471,14 @@ const MIGRATIONS = [
 	{
 		"tag": "0009_x_liked_mentions",
 		"sql": "CREATE TABLE \"x_liked_raw\" (\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  \"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_liked_created_at_idx\" ON \"x_liked_raw\" (\"created_at\");--> statement-breakpoint\nCREATE INDEX \"x_liked_author_id_created_at_idx\" ON \"x_liked_raw\" (\"author_id\",\"created_at\");--> statement-breakpoint\nCREATE INDEX \"x_liked_conversation_id_created_at_idx\" ON \"x_liked_raw\" (\"conversation_id\",\"created_at\");--> statement-breakpoint\nCREATE VIEW \"x_liked\" AS\nSELECT \"id\", \"created_at\", \"author_id\", \"conversation_id\", \"in_reply_to_user_id\", \"lang\",\n       \"reply_settings\", \"text\", \"url\", \"paid_partnership\", \"possibly_sensitive\",\n       \"like_count\", \"retweet_count\", \"reply_count\", \"quote_count\", \"bookmark_count\",\n       \"impression_count\"\nFROM \"x_liked_raw\";\n--> statement-breakpoint\nCREATE TABLE \"x_mentions_raw\" (\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  \"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_mentions_created_at_idx\" ON \"x_mentions_raw\" (\"created_at\");--> statement-breakpoint\nCREATE INDEX \"x_mentions_author_id_created_at_idx\" ON \"x_mentions_raw\" (\"author_id\",\"created_at\");--> statement-breakpoint\nCREATE INDEX \"x_mentions_conversation_id_created_at_idx\" ON \"x_mentions_raw\" (\"conversation_id\",\"created_at\");--> statement-breakpoint\nCREATE VIEW \"x_mentions\" AS\nSELECT \"id\", \"created_at\", \"author_id\", \"conversation_id\", \"in_reply_to_user_id\", \"lang\",\n       \"reply_settings\", \"text\", \"url\", \"paid_partnership\", \"possibly_sensitive\",\n       \"like_count\", \"retweet_count\", \"reply_count\", \"quote_count\", \"bookmark_count\",\n       \"impression_count\"\nFROM \"x_mentions_raw\";\n"
+	},
+	{
+		"tag": "0010_x_timeline",
+		"sql": "CREATE TABLE \"x_timeline_raw\" (\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  \"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_timeline_created_at_idx\" ON \"x_timeline_raw\" (\"created_at\");--> statement-breakpoint\nCREATE INDEX \"x_timeline_author_id_created_at_idx\" ON \"x_timeline_raw\" (\"author_id\",\"created_at\");--> statement-breakpoint\nCREATE INDEX \"x_timeline_conversation_id_created_at_idx\" ON \"x_timeline_raw\" (\"conversation_id\",\"created_at\");--> statement-breakpoint\nCREATE VIEW \"x_timeline\" AS\nSELECT \"id\", \"created_at\", \"author_id\", \"conversation_id\", \"in_reply_to_user_id\", \"lang\",\n       \"reply_settings\", \"text\", \"url\", \"paid_partnership\", \"possibly_sensitive\",\n       \"like_count\", \"retweet_count\", \"reply_count\", \"quote_count\", \"bookmark_count\",\n       \"impression_count\"\nFROM \"x_timeline_raw\";\n"
 	}
 ];
 //#endregion
-//#region ../../packages/sync-engine/src/migrate.ts
+//#region ../../packages/sqlsync/src/migrate.ts
 const readUserVersion = (db) => {
 	const version = db.prepare("PRAGMA user_version").get()?.user_version;
 	return typeof version === "number" ? version : Number(version ?? 0);
@@ -1470,7 +1512,7 @@ const assertAtLatest = (db) => {
 	if (currentVersion < MIGRATIONS.length) throw new Error(`Local SQLite cache schema is at version ${currentVersion}; expected ${MIGRATIONS.length}`);
 };
 //#endregion
-//#region ../../packages/sync-engine/src/sqlite.ts
+//#region ../../packages/sqlsync/src/sqlite.ts
 const loadModule = createRequire(import.meta.url);
 const isBunRuntime = () => typeof Bun !== "undefined";
 const normalizeValue = (value) => {
@@ -1526,7 +1568,7 @@ const openDatabase = (path, opts) => {
 	};
 };
 //#endregion
-//#region ../../packages/sync-engine/src/write-through.ts
+//#region ../../packages/sqlsync/src/write-through.ts
 const quoteIdentifier$3 = (identifier) => `\`${identifier.replaceAll("`", "``")}\``;
 const collectionForTable = (table) => table.endsWith("_raw") ? table.slice(0, -4) : table;
 const profileTables$1 = new Set(["x_profiles_raw", "li_profiles_raw"]);
@@ -1574,17 +1616,10 @@ const applyWriteThrough = (db, args) => {
 	};
 };
 //#endregion
-//#region ../../packages/sync-engine/src/cache.ts
-var NeverSyncedError = class extends Error {
-	name = "NeverSyncedError";
-	tables;
-	constructor(tables, message) {
-		super(message);
-		this.tables = tables;
-	}
-};
+//#region ../../packages/sqlsync/src/cache.ts
 const publicCacheTables = [
 	"x_tweets",
+	"x_timeline",
 	"x_followers",
 	"x_following",
 	"x_bookmarks",
@@ -1614,6 +1649,7 @@ const sanitizeAccountId = (accountId) => accountId.replaceAll(/[^A-Za-z0-9._-]/g
 const quoteIdentifier$2 = (identifier) => `\`${identifier.replaceAll("`", "``")}\``;
 const resolveCachePath = (path) => path === ":memory:" ? path : resolve(path);
 const rawTableFor = (table) => table === "sync_state" ? table : `${table}_raw`;
+const partialSyncCursorPrefix = "partial-sync-v1:";
 const collectionForReadTable = (table) => table.endsWith("_raw") ? table.slice(0, -4) : table;
 const physicalTableForCacheTable = (table) => table === "sync_state" || table.endsWith("_raw") ? table : rawTableFor(table);
 const stringOrNull = (value) => typeof value === "string" ? value : null;
@@ -1644,7 +1680,6 @@ const referencedTablesForRead = (sql, platform) => {
 	const allowedTables = platformTables[platform];
 	return knownTableTokens(sql).filter((table) => allowedTables.has(table));
 };
-const collectionShortName = (collection) => collection.replace(/^(x|li)_/, "");
 const tableFreshnessPolicies = {
 	x_conversation_participants: {
 		kind: "collection",
@@ -1656,13 +1691,11 @@ const tableFreshnessPolicies = {
 	},
 	li_conversations: {
 		kind: "collection",
-		collection: "li_conversations",
-		commandCollection: "li_messages"
+		collection: "li_conversations"
 	},
 	li_conversations_raw: {
 		kind: "collection",
-		collection: "li_conversations",
-		commandCollection: "li_messages"
+		collection: "li_conversations"
 	},
 	li_profiles: {
 		kind: "platform",
@@ -1686,44 +1719,25 @@ const freshnessPolicyForTable = (table) => tableFreshnessPolicies[table] ?? {
 	collection: collectionForReadTable(table)
 };
 const platformCollectionPrefix = (platform) => platform === "linkedin" ? "li_" : "x_";
-const syncCommandForPolicy = (platform, policy) => {
-	if (policy.kind === "platform") return `social ${policy.platform} sync`;
-	return `social ${platform} sync ${collectionShortName(policy.commandCollection ?? policy.collection)}`;
-};
-const missingNameForPolicy = (table, policy) => policy.kind === "platform" ? table : policy.collection;
-const formatList = (items) => {
-	if (items.length <= 1) return items[0] ?? "";
-	if (items.length === 2) return `${items[0]} and ${items[1]}`;
-	return `${items.slice(0, -1).join(", ")}, and ${items.at(-1)}`;
+const partialCollectionLastSynced = (db, collection, cursor) => {
+	if (typeof cursor !== "string" || !cursor.startsWith(partialSyncCursorPrefix)) return null;
+	if (!cacheTables.has(collection)) return null;
+	return numberOrNull(db.prepare(`SELECT MAX(synced_at) AS last_synced FROM ${quoteIdentifier$2(rawTableFor(collection))}`).get()?.last_synced);
 };
 const collectionLastSynced = (db, collection) => {
-	return numberOrNull(db.prepare("SELECT last_synced FROM sync_state WHERE collection = :collection").get({ collection })?.last_synced);
+	const syncState = db.prepare("SELECT cursor, last_synced FROM sync_state WHERE collection = :collection").get({ collection });
+	return numberOrNull(syncState?.last_synced) ?? partialCollectionLastSynced(db, collection, syncState?.cursor);
 };
 const platformLastSynced = (db, platform) => {
-	return numberOrNull(db.prepare("SELECT MAX(last_synced) AS last_synced FROM sync_state WHERE collection GLOB :glob").get({ glob: `${platformCollectionPrefix(platform)}*` })?.last_synced);
+	const syncState = db.prepare("SELECT MAX(last_synced) AS last_synced FROM sync_state WHERE collection GLOB :glob").get({ glob: `${platformCollectionPrefix(platform)}*` });
+	const partialRows = db.prepare("SELECT collection, cursor FROM sync_state WHERE collection GLOB :glob AND last_synced IS NULL AND cursor LIKE :partial").all({
+		glob: `${platformCollectionPrefix(platform)}*`,
+		partial: `${partialSyncCursorPrefix}%`
+	});
+	const timestamps = [numberOrNull(syncState?.last_synced), ...partialRows.map((row) => partialCollectionLastSynced(db, String(row.collection), row.cursor))].filter((value) => value !== null);
+	return timestamps.length === 0 ? null : Math.max(...timestamps);
 };
 const lastSyncedForPolicy = (db, policy) => policy.kind === "platform" ? platformLastSynced(db, policy.platform) : collectionLastSynced(db, policy.collection);
-const missingFreshnessForTables = (tables) => {
-	const missing = [];
-	const seen = /* @__PURE__ */ new Set();
-	for (const table of tables) {
-		if (table.lastSynced != null) continue;
-		const key = `${table.missingName}\0${table.command}`;
-		if (!seen.has(key)) {
-			seen.add(key);
-			missing.push({
-				name: table.missingName,
-				command: table.command
-			});
-		}
-	}
-	return missing;
-};
-const neverSyncedMessage = (missing) => {
-	const names = missing.map((item) => item.name);
-	const commands = missing.map((item) => `\`${item.command}\``);
-	return `No synced ${formatList(names)} yet — run ${formatList(commands)} first.`;
-};
 const assertKnownProfileTable = (table) => {
 	assertKnownTable(table);
 	if (!profileTables.has(physicalTableForCacheTable(table))) throw new Error(`Unknown profile table: ${table}`);
@@ -1817,7 +1831,7 @@ const createCache = (path, db) => ({
 		if (!row) return;
 		return {
 			cursor: stringOrNull(row.cursor),
-			lastSynced: numberOrNull(row.last_synced),
+			lastSynced: numberOrNull(row.last_synced) ?? partialCollectionLastSynced(db, collection, row.cursor),
 			objectCount: numberOrNull(row.object_count)
 		};
 	},
@@ -1853,22 +1867,14 @@ const createCache = (path, db) => ({
 	read: (sql, opts) => {
 		assertPlatformQuery(sql, opts.platform);
 		const tables = referencedTablesForRead(sql, opts.platform).map((name) => {
-			const policy = freshnessPolicyForTable(name);
 			return {
 				name,
-				missingName: missingNameForPolicy(name, policy),
-				command: syncCommandForPolicy(opts.platform, policy),
-				lastSynced: lastSyncedForPolicy(db, policy)
+				lastSynced: lastSyncedForPolicy(db, freshnessPolicyForTable(name))
 			};
 		});
-		const missingFreshness = missingFreshnessForTables(tables);
-		if (missingFreshness.length > 0) throw new NeverSyncedError(missingFreshness.map((item) => item.name), neverSyncedMessage(missingFreshness));
 		return {
 			rows: db.prepare(sql).all(),
-			tables: tables.map(({ name, lastSynced }) => ({
-				name,
-				lastSynced
-			}))
+			tables
 		};
 	},
 	describe: (opts) => {
@@ -1893,7 +1899,6 @@ const createCache = (path, db) => ({
 					name,
 					rows: Number(rowCount?.rows ?? 0),
 					synced_at: syncedAt,
-					query_ready: syncedAt != null,
 					columns: columnsForTable(name),
 					indexed: metadata.indexed[name] ?? []
 				};
@@ -1905,7 +1910,7 @@ const createCache = (path, db) => ({
 	}
 });
 //#endregion
-//#region ../../packages/sync-engine/src/since.ts
+//#region ../../packages/sqlsync/src/since.ts
 const isoDatePattern = /^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/;
 const isoDateTimePattern = /^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])T([01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d{1,3})?)?(?:Z|[+-]([01]\d|2[0-3]):[0-5]\d)?$/;
 const timezonePattern = /(Z|[+-]\d{2}:\d{2})$/;
@@ -6499,17 +6504,17 @@ function superRefine(fn, params) {
 	return /* @__PURE__ */ _superRefine(fn, params);
 }
 //#endregion
-//#region ../../packages/sync-engine/src/cost.ts
+//#region ../../packages/sqlsync/src/cost.ts
 const creditsFromHeader = (headers) => {
 	const rawCredits = headers?.get("social-x-credits-used");
 	const credits = rawCredits == null ? NaN : Number.parseInt(rawCredits, 10);
 	return Number.isNaN(credits) || credits < 0 ? 0 : credits;
 };
 //#endregion
-//#region ../../packages/sync-engine/src/profiles.ts
+//#region ../../packages/sqlsync/src/profiles.ts
 const profileTableFor = (platform) => platform === "x" ? "x_profiles_raw" : "li_profiles_raw";
 //#endregion
-//#region ../../packages/sync-engine/src/sync.ts
+//#region ../../packages/sqlsync/src/sync.ts
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 const pageDelayFor = (pageDelayMs, pagesCompleted) => typeof pageDelayMs === "function" ? pageDelayMs(pagesCompleted) : pageDelayMs;
 var SyncPageError = class extends Error {
@@ -6561,6 +6566,12 @@ const decodePartialSyncCursor = (value) => {
 	}
 };
 const encodePartialSyncCursor = (cursor) => `${PARTIAL_SYNC_CURSOR_PREFIX}${JSON.stringify(cursor)}`;
+const partialCursorMatchesSince = (cursor, since) => {
+	const requestedSince = since ?? null;
+	if (cursor.since === requestedSince) return true;
+	return requestedSince !== null && (cursor.since === null || cursor.since <= requestedSince);
+};
+const preservesBroaderPartialOnSince = (cursor, since, stoppedReason) => cursor !== void 0 && cursor.since !== (since ?? null) && stoppedReason === "since";
 const isRateLimitError = (error) => isRecord$9(error) && error.status === 429;
 const retryAfterSecondsFromRateLimitError = (error) => {
 	if (!(isRateLimitError(error) && isRecord$9(error))) return;
@@ -6757,11 +6768,11 @@ const walkRequest = async (args) => {
 				cursor: state.cursor ?? "",
 				checkpoint,
 				newestId: state.newestId,
-				since: args.since ?? null,
+				since: args.partialCursorSince === void 0 ? args.since ?? null : args.partialCursorSince,
 				...args.parentId === void 0 ? {} : { parentId: args.parentId }
 			}),
 			objectCount: upserted,
-			lastSynced: null
+			lastSynced: Date.now()
 		});
 		partialCursorPersisted = true;
 		return true;
@@ -6837,7 +6848,7 @@ const walkRequest = async (args) => {
 		upserted += step.rows.length;
 		ids.push(...step.ids);
 		state = step.nextState;
-		persistPartialCursor();
+		if (!(args.preservePartialCursorOnSince && step.done && step.stoppedReason === "since")) persistPartialCursor();
 		await args.onPage?.({
 			collectionKey: args.collection.key,
 			pagesCompleted: pages,
@@ -6865,15 +6876,19 @@ const singleRequestCheckpoint = (args) => ({
 	objectCount: args.result.upserted,
 	lastSynced: Date.now()
 });
-const parentIdsFromCache = (deps, collection) => {
+const parentIdsFromCache = (deps, collection, since) => {
 	const table = collection.table ?? collection.key;
 	const orderBy = collection.sinceField ? `${collection.sinceField} DESC, id` : "id";
-	return deps.cache.query(`SELECT id FROM ${table} ORDER BY ${orderBy}`).map((row) => String(row.id));
+	const sinceFilter = since != null && collection.sinceField ? ` WHERE ${collection.sinceField} >= ${since}` : "";
+	return deps.cache.query(`SELECT id FROM ${table}${sinceFilter} ORDER BY ${orderBy}`).map((row) => String(row.id));
 };
 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`);
+	if (opts.since != null && collection.requiresFullInitialSync) {
+		const storedState = deps.cache.getCursor(collection.key);
+		if (storedState?.lastSynced == null || decodePartialSyncCursor(storedState.cursor)) throw new Error(`Collection ${collection.key} requires a full initial sync before --since`);
+	}
 	const credits = { spent: 0 };
 	let pages = 0;
 	let upserted = 0;
@@ -6899,13 +6914,14 @@ const runSync = async (deps, opts) => {
 		const parentCollection = collectionByKey(collection.parentCollection);
 		if (!parentCollection) throw new Error(`Missing parent collection ${collection.parentCollection}`);
 		const storedPartialCursor = decodePartialSyncCursor(deps.cache.getCursor(collection.key)?.cursor);
-		let activePartialCursor = storedPartialCursor?.since === (opts.since ?? null) ? storedPartialCursor : void 0;
+		let activePartialCursor = storedPartialCursor && partialCursorMatchesSince(storedPartialCursor, opts.since) ? storedPartialCursor : void 0;
 		if (activePartialCursor?.phase !== "parent" && activePartialCursor?.phase !== "child") activePartialCursor = void 0;
+		const resumedPartialCursor = activePartialCursor;
 		const parentIds = [];
 		const parentPersistsCheckpoint = parentCollection.requests.length === 1;
 		let parentCheckpoint;
 		if (activePartialCursor?.phase === "child") {
-			const cachedParentIds = parentIdsFromCache(deps, parentCollection);
+			const cachedParentIds = parentIdsFromCache(deps, parentCollection, opts.since);
 			if (activePartialCursor.parentId && cachedParentIds.includes(activePartialCursor.parentId)) parentIds.push(...cachedParentIds);
 			else activePartialCursor = void 0;
 		}
@@ -6922,6 +6938,8 @@ const runSync = async (deps, opts) => {
 					collectIds: true,
 					resumeCursor: activePartialCursor?.phase === "parent" && activePartialCursor.requestIndex === requestIndex ? activePartialCursor : void 0,
 					allowPartialResume: true,
+					partialCursorSince: activePartialCursor?.since,
+					preservePartialCursorOnSince: activePartialCursor?.since !== (opts.since ?? null),
 					partialCursorCollection: collection.key,
 					partialCursorPhase: "parent",
 					credits,
@@ -6946,7 +6964,7 @@ const runSync = async (deps, opts) => {
 				lastSynced: Date.now()
 			};
 			if (parentCheckpoint) writePendingCursor(parentCheckpoint);
-			if (activePartialCursor?.phase === "parent") parentIds.splice(0, parentIds.length, ...parentIdsFromCache(deps, parentCollection));
+			if (activePartialCursor?.phase === "parent") parentIds.splice(0, parentIds.length, ...parentIdsFromCache(deps, parentCollection, opts.since));
 		}
 		let reachedResumeParent = activePartialCursor?.phase !== "child";
 		for (const parentId of parentIds) {
@@ -6965,6 +6983,8 @@ const runSync = async (deps, opts) => {
 					useCheckpoint: false,
 					resumeCursor: activePartialCursor?.phase === "child" && activePartialCursor.parentId === parentId && activePartialCursor.requestIndex === requestIndex ? activePartialCursor : void 0,
 					allowPartialResume: true,
+					partialCursorSince: activePartialCursor?.since,
+					preservePartialCursorOnSince: activePartialCursor?.since !== (opts.since ?? null),
 					partialCursorCollection: collection.key,
 					partialCursorPhase: "child",
 					parentId,
@@ -6980,7 +7000,7 @@ const runSync = async (deps, opts) => {
 				if (activePartialCursor?.phase === "child" && activePartialCursor.parentId === parentId) activePartialCursor = void 0;
 			}
 		}
-		pendingCursors.push({
+		if (!preservesBroaderPartialOnSince(resumedPartialCursor, opts.since, stoppedReason)) pendingCursors.push({
 			collection: collection.key,
 			cursor: null,
 			objectCount: upserted,
@@ -6989,7 +7009,7 @@ const runSync = async (deps, opts) => {
 	} else {
 		const useCheckpoint = collection.requests.length === 1;
 		const partialCursor = decodePartialSyncCursor(deps.cache.getCursor(collection.key)?.cursor ?? null);
-		const activePartialCursor = partialCursor && partialCursor.since === (opts.since ?? null) && partialCursor.requestIndex < collection.requests.length ? partialCursor : void 0;
+		const activePartialCursor = partialCursor && partialCursorMatchesSince(partialCursor, opts.since) && partialCursor.requestIndex < collection.requests.length ? partialCursor : void 0;
 		for (const [requestIndex, request] of collection.requests.entries()) {
 			if (activePartialCursor && requestIndex < activePartialCursor.requestIndex) continue;
 			const result = await walkRequest({
@@ -7001,6 +7021,8 @@ const runSync = async (deps, opts) => {
 				useCheckpoint,
 				resumeCursor: activePartialCursor?.requestIndex === requestIndex ? activePartialCursor : void 0,
 				allowPartialResume: true,
+				partialCursorSince: activePartialCursor?.since,
+				preservePartialCursorOnSince: activePartialCursor?.since !== (opts.since ?? null),
 				credits,
 				pageDelayState,
 				rateLimit: opts.rateLimit,
@@ -7010,12 +7032,12 @@ const runSync = async (deps, opts) => {
 				onProgress: opts.onProgress
 			});
 			addResult(result);
-			if (useCheckpoint) pendingCursors.push(singleRequestCheckpoint({
+			if (!preservesBroaderPartialOnSince(activePartialCursor, opts.since, result.stoppedReason) && useCheckpoint) pendingCursors.push(singleRequestCheckpoint({
 				collection,
 				result
 			}));
 		}
-		if (!useCheckpoint) pendingCursors.push({
+		if (!(useCheckpoint || preservesBroaderPartialOnSince(activePartialCursor, opts.since, stoppedReason))) pendingCursors.push({
 			collection: collection.key,
 			cursor: null,
 			objectCount: upserted,
@@ -7528,6 +7550,30 @@ const { costBPSForCategory: costBPSForCategory$1 } = createPricing([
 		"unitPriceUSD": .015,
 		"featureId": "user_interaction_create_request"
 	},
+	{
+		"key": "page_analytics_read",
+		"label": "Page Analytics: Read",
+		"description": "Read LinkedIn company Page analytics through the raw LinkedIn passthrough.",
+		"unit": "per_resource",
+		"unitPriceUSD": .02,
+		"featureId": "user_read_resource"
+	},
+	{
+		"key": "page_invite_create",
+		"label": "Page Invite: Create",
+		"description": "Invite LinkedIn users to follow a company Page.",
+		"unit": "per_request",
+		"unitPriceUSD": .015,
+		"featureId": "user_interaction_create_request"
+	},
+	{
+		"key": "proxy_passthrough",
+		"label": "Proxy Passthrough",
+		"description": "Forward a raw LinkedIn passthrough envelope with conservative write-tier pricing.",
+		"unit": "per_request",
+		"unitPriceUSD": .2,
+		"featureId": "content_create_with_url_request"
+	},
 	{
 		"key": "following_read",
 		"label": "Following/Followers: Read",
@@ -10450,6 +10496,54 @@ const LINKEDIN_OPERATIONS = [
 			}
 		]
 	},
+	{
+		schemaBaseName: "PageVisitors",
+		hasBody: false,
+		config: {
+			command: "visitors",
+			group: "page",
+			root: false,
+			summary: "Read company Page visitor analytics",
+			paramLabels: { companyId: "company" },
+			targetKind: "company"
+		},
+		endpoint: {
+			method: "GET",
+			path: "/page/:companyId/visitors",
+			upstreamMethod: "POST",
+			upstreamPath: "/v2/{account_id}/linkedin/",
+			capability: "read",
+			mutates: false,
+			pagination: { style: "none" },
+			costBPS: 200,
+			billingCategory: "page_analytics_read",
+			kind: "page"
+		},
+		parameters: [
+			{
+				name: "since",
+				in: "query",
+				required: false,
+				kind: "string",
+				description: "Start of the analytics window as an ISO timestamp"
+			},
+			{
+				name: "until",
+				in: "query",
+				required: false,
+				kind: "string",
+				description: "End of the analytics window as an ISO timestamp"
+			},
+			{
+				name: "companyId",
+				in: "path",
+				required: true,
+				kind: "string",
+				valueHint: "company",
+				description: "Company Page selector: company_id:ID, a company URL, or a vanity; supplied by --page or config"
+			}
+		]
+	},
 	{
 		schemaBaseName: "PostsComments",
 		hasBody: false,
@@ -10892,7 +10986,7 @@ const LINKEDIN_OPERATIONS = [
 			summary: "List a user's LinkedIn connections",
 			itemUrlTemplate: "https://www.linkedin.com/in/{id}",
 			paramLabels: { user_id: "target" },
-			positionalQueryParams: ["user_id"],
+			optionalPositionalQueryParams: ["user_id"],
 			outputGuardMessage: "Unexpected LinkedIn connections response. Expected a relations list.",
 			resolveResourceParams: ["user_id"],
 			targetKind: "profile"
@@ -10932,10 +11026,10 @@ const LINKEDIN_OPERATIONS = [
 			{
 				name: "user_id",
 				in: "query",
-				required: true,
+				required: false,
 				kind: "string",
 				valueHint: "target",
-				description: "LinkedIn profile target: @public-identifier, profile_id:<id>, a LinkedIn profile URL, or a profile URN. Required for live reads; use `social linkedin sync connections` plus `social linkedin sql` for your own graph."
+				description: "Optional profile target: @public-identifier, profile_id:<id>, a LinkedIn profile URL, or a profile URN. Omit for account-level connections"
 			},
 			{
 				name: "filter",
@@ -11061,6 +11155,44 @@ const LINKEDIN_OPERATIONS = [
 			description: "Conversation target: chat_id:<id> or a LinkedIn messaging thread URL"
 		}]
 	},
+	{
+		schemaBaseName: "PageInvite",
+		hasBody: true,
+		config: {
+			command: "invite",
+			group: "page",
+			root: false,
+			summary: "Invite users to follow a company Page",
+			bodyParams: { invitees: {
+				kind: "array",
+				positional: true,
+				required: true,
+				valueHint: "user",
+				description: "Users to invite: @username, profile_id:<id>, profile URL, or profile URN"
+			} },
+			paramLabels: { companyId: "company" },
+			targetKind: "company"
+		},
+		endpoint: {
+			method: "POST",
+			path: "/page/:companyId/invite",
+			upstreamPath: "/v2/{account_id}/linkedin/",
+			capability: "write",
+			mutates: true,
+			pagination: { style: "none" },
+			costBPS: 150,
+			billingCategory: "page_invite_create",
+			kind: "page"
+		},
+		parameters: [{
+			name: "companyId",
+			in: "path",
+			required: true,
+			kind: "string",
+			valueHint: "company",
+			description: "Company Page selector: company_id:ID, a company URL, or a vanity; supplied by --page or config"
+		}]
+	},
 	{
 		schemaBaseName: "PostsPost",
 		hasBody: true,
@@ -11173,6 +11305,29 @@ const LINKEDIN_OPERATIONS = [
 		},
 		parameters: []
 	},
+	{
+		schemaBaseName: "LinkedinProxy",
+		hasBody: true,
+		config: {
+			command: "proxy",
+			group: "linkedin",
+			root: true,
+			summary: "Forward a raw request to LinkedIn (advanced escape hatch)",
+			bodyTextArg: "body"
+		},
+		endpoint: {
+			method: "POST",
+			path: "/proxy",
+			upstreamPath: "/v2/{account_id}/linkedin/",
+			capability: "write",
+			mutates: true,
+			pagination: { style: "none" },
+			costBPS: 2e3,
+			billingCategory: "proxy_passthrough",
+			kind: "proxy"
+		},
+		parameters: []
+	},
 	{
 		schemaBaseName: "RequestsSend",
 		hasBody: true,
@@ -11429,6 +11584,12 @@ const CompaniesJobsOutput = object({
 	total_count: number().optional(),
 	next_cursor: string().optional()
 }).passthrough();
+const PageVisitorsInput = object({
+	since: string().optional(),
+	until: string().optional(),
+	companyId: string().optional()
+});
+const PageVisitorsOutput = object({}).passthrough();
 const PostsCommentsInput = object({
 	offset: union([string(), number()]).optional(),
 	limit: union([string(), number()]).optional(),
@@ -11509,7 +11670,7 @@ const UserPostsOutput = object({
 const UserConnectionsInput = object({
 	limit: union([string(), number()]).optional(),
 	cursor: string().optional(),
-	user_id: string(),
+	user_id: string().optional(),
 	filter: string().optional()
 });
 const UserConnectionsOutput = object({
@@ -11558,6 +11719,16 @@ const MessagesMessageOutput = object({
 		unknown()
 	])
 }).passthrough();
+const PageInviteInput = object({
+	companyId: string().optional(),
+	body: string().optional(),
+	invitees: union([array(string()), string()]).optional()
+});
+const PageInviteContractInput = PageInviteInput.extend({
+	body: object({ invitees: array(string()) }).passthrough().optional(),
+	invitees: union([array(string()), string()]).optional()
+});
+const PageInviteOutput = object({}).passthrough();
 const PostsPostInput = object({
 	body: string().optional(),
 	text: string().optional(),
@@ -11640,6 +11811,9 @@ const PostsReactContractInput = PostsReactInput.extend({
 	reaction_type: string().optional()
 });
 const PostsReactOutput = object({ object: _enum(["PostReactionAdded"]) }).passthrough();
+const LinkedinProxyInput = object({ body: string().optional() });
+const LinkedinProxyContractInput = LinkedinProxyInput.extend({ body: object({}).passthrough().optional() });
+const LinkedinProxyOutput = object({}).passthrough();
 const RequestsSendInput = object({
 	id: string(),
 	body: string().optional(),
@@ -11654,6 +11828,8 @@ const schemas$1 = {
 	CompaniesCompanyOutput,
 	CompaniesJobsInput,
 	CompaniesJobsOutput,
+	PageVisitorsInput,
+	PageVisitorsOutput,
 	PostsCommentsInput,
 	PostsCommentsOutput,
 	PostsReactionsInput,
@@ -11679,6 +11855,9 @@ const schemas$1 = {
 	MessagesMessageInput,
 	MessagesMessageContractInput,
 	MessagesMessageOutput,
+	PageInviteInput,
+	PageInviteContractInput,
+	PageInviteOutput,
 	PostsPostInput,
 	PostsPostContractInput,
 	PostsPostOutput,
@@ -11688,6 +11867,9 @@ const schemas$1 = {
 	PostsReactInput,
 	PostsReactContractInput,
 	PostsReactOutput,
+	LinkedinProxyInput,
+	LinkedinProxyContractInput,
+	LinkedinProxyOutput,
 	RequestsSendInput,
 	RequestsSendContractInput: RequestsSendInput.extend({
 		body: object({
@@ -11801,6 +11983,12 @@ const targetKindsFor = (op) => {
 	if (kinds === void 0) throw new Error(`Missing targetKind for ${commandPathFor(op)}.`);
 	return Array.isArray(kinds) ? kinds : [kinds];
 };
+const isSeededPageCompanyParam = (op, param) => op.config.group === "page" && param.in === "path" && param.name === "companyId";
+const pageParametersForRuntimeInput = (op) => op.config.group === "page" ? op.parameters.filter((param) => !isSeededPageCompanyParam(op, param)) : op.parameters;
+const pageSelectorForTargetResolution = (page) => {
+	if (NumericCompanyId.safeParse(page).success || !(page.startsWith("company_id:") || page.startsWith("http") || page.startsWith("urn:"))) return `company_id:${page}`;
+	return page;
+};
 const positionalDisplayKeyFor = (op, param) => op.config.paramLabels?.[param.name] ?? flagName(param.name);
 const idempotencyFor$1 = (op) => {
 	if (op.endpoint.capability === "read") return {
@@ -11850,7 +12038,7 @@ const exampleCommandFor$1 = (op, root) => {
 		op.config.command
 	];
 	for (const param of op.parameters) {
-		if (!(param.in === "path" || positionalQuery.has(param.name)) || op.config.ownAccountPathParams?.[param.name] === "optional") continue;
+		if (!(param.in === "path" || positionalQuery.has(param.name)) || op.config.ownAccountPathParams?.[param.name] === "optional" || isSeededPageCompanyParam(op, param)) continue;
 		const hint = `<${positionalDisplayKeyFor(op, param)}>`;
 		parts.push(param.in === "path" || param.kind !== "array" ? hint : `${hint}...`);
 	}
@@ -11944,10 +12132,21 @@ const linkedinRuntimeAdapter = {
 	includeIdField: true,
 	maximumItemsHintFor: maximumItemsHintFor$1,
 	queryArrayMode: (op, param) => param.kind === "array" || op.schemaBaseName === "UserProfile" && param.name === "with_sections" ? "repeat" : "set",
+	parametersForArgs: pageParametersForRuntimeInput,
+	parametersForInput: pageParametersForRuntimeInput,
 	setUnexposedFieldPresets: true,
 	signaturePartFor: signaturePartFor$1,
 	stdinBodyTextRequired: (op) => op.config.bodyTextArg !== void 0 && op.config.bodyTextRequired !== false,
 	targetKinds: targetKindsFor,
+	seedPathValue: async ({ op, param, args, deps }) => {
+		if (op.config.group !== "page" || param.name !== "companyId") return;
+		const page = typeof args.page === "string" ? args.page : void 0;
+		return pageSelectorForTargetResolution(await deps.resolveLinkedinPage({ page }));
+	},
+	extraArgsFor: (op) => op.config.group === "page" ? { page: {
+		type: "string",
+		description: "Company Page selector: company_id:<id>, a company URL, or a vanity; overrides the configured default Page"
+	} } : void 0,
 	useGETMaxUsageUnitsEstimate: true,
 	transformPathResolution: async ({ args, deps, op, param, rawArgs, resolution, resolveSelectedAccount }) => {
 		if ((op.schemaBaseName === "PostsComments" || op.schemaBaseName === "PostsReactions") && param.name === "post_id") {
@@ -11992,6 +12191,26 @@ const linkedinRuntimeAdapter = {
 				}]
 			};
 		}
+		if (op.config.group === "page" && param.name === "companyId" && !NumericCompanyId.safeParse(resolution.id).success) {
+			const companyAccount = await resolveSelectedAccount();
+			const company = await deps.api.get(`linkedin/companies/${encodeURIComponent(resolution.id)}`, { headers: {
+				...await deps.commandHeaders({
+					headers: args.header,
+					rawArgs
+				}),
+				...companyAccount.selector === void 0 ? {} : { "x-social-account-id": companyAccount.selector }
+			} }).json();
+			const companyId = NumericCompanyId.safeParse(companyProfileIdFrom(company));
+			if (!companyId.success) throw new Error(`Could not resolve LinkedIn company ID for ${resolution.id}.`);
+			return {
+				pathValue: companyId.data,
+				records: [{
+					...resolution.record,
+					id: companyId.data,
+					source: "lookup"
+				}]
+			};
+		}
 	},
 	afterQueryParams: ({ op, params, pathResolutions }) => {
 		if (op.schemaBaseName === "UserPosts" && pathResolutions.identifier?.kind === "company") params.set("is_company", "true");
@@ -12045,6 +12264,20 @@ const linkedinRuntimeAdapter = {
 			});
 			input.post_as = companyId.data;
 		}
+		if (op.schemaBaseName === "PageInvite" && input.invitees !== void 0) {
+			const invitees = Array.isArray(input.invitees) ? input.invitees : [input.invitees];
+			const profileIds = [];
+			for (const invitee of invitees) {
+				const resolution = await deps.resolveTarget("invitee", invitee, {
+					platform: "linkedin",
+					account,
+					expect: ["profile"]
+				});
+				resolved.push(resolution.record);
+				profileIds.push(resolution.id);
+			}
+			input.invitees = profileIds;
+		}
 	},
 	transformOutput: ({ body, data, op }) => {
 		const outputData = dataWithAuditableWriteTarget(op, data, body);
@@ -12514,7 +12747,7 @@ const buildSync$1 = (deps, platform) => defineCommand({
 const buildSql$1 = (deps, platform) => defineCommand({
 	meta: {
 		name: "sql",
-		description: "Query your synced local mirror with read-only SQL (free; run with no query to print tables)",
+		description: "Query your local mirror with read-only SQL (free; run with no query to print tables)",
 		capability: "read",
 		mutates: false,
 		schemaContract: {
@@ -12603,7 +12836,6 @@ const buildSql$1 = (deps, platform) => defineCommand({
 					}
 				});
 			} catch (error) {
-				if (error instanceof NeverSyncedError) throw new UsageError(incompleteSyncMessageFor(readonlyCache, error));
 				throw new UsageError(`Query failed (cache is read-only): ${error.message}`);
 			}
 		} finally {
@@ -12915,12 +13147,6 @@ const sentMessageRow = (args) => {
 		raw: JSON.stringify(raw)
 	};
 };
-const incompleteSyncMessageFor = (cache, error) => {
-	if (!error.tables.includes("li_conversations")) return error.message;
-	const rows = cache.query("SELECT count(*) AS count FROM li_conversations_raw")[0]?.count;
-	if (typeof rows !== "number" || rows <= 0) return error.message;
-	return `li_conversations has ${rows.toLocaleString("en-US")} rows from an incomplete messages sync (rate-limited before finishing) — run \`social linkedin sync messages\` to complete it before querying.`;
-};
 const buildMessageDelete = (deps) => {
 	return defineCommand({
 		meta: commandMeta$2({
@@ -13583,6 +13809,7 @@ createLinkedinCommands({
 	printResult: unconfigured$1,
 	resolveAccount: unconfigured$1,
 	resolveAccountId: unconfigured$1,
+	resolveLinkedinPage: unconfigured$1,
 	resolveOwnLinkedinAccount: unconfigured$1
 });
 //#endregion
@@ -13882,6 +14109,7 @@ const xProfileExtractors = {
 	"GET /users/:id": extractProfile,
 	"GET /users/:id/followers": extractList,
 	"GET /users/:id/following": extractList,
+	"GET /users/:id/timelines/reverse_chronological": extractIncludesUsers,
 	"GET /users/by/username/:username": extractProfile
 };
 const X_OPERATIONS = [
@@ -16636,11 +16864,10 @@ const defineOperationCommand = (op, deps) => defineRuntimeOperationCommand(xRunt
 //#endregion
 //#region ../../packages/x/src/cli/commands.ts
 const hiddenRootCommands = new Set(["search"]);
-const suppressedRootCommands = new Set(["bookmarks"]);
+const suppressedRootCommands = new Set(["bookmarks", "timeline"]);
 const rootCommandOrder = [
 	"profile",
 	"tweets",
-	"timeline",
 	"mentions",
 	"liked",
 	"followers",
@@ -16942,7 +17169,7 @@ const buildSql = (deps, platform) => {
 	return defineCommand({
 		meta: commandMeta$1({
 			name: "sql",
-			description: "Query your synced local mirror with read-only SQL (free; run with no query to print tables)",
+			description: "Query your local mirror with read-only SQL (free; run with no query to print tables)",
 			method: "GET",
 			capability: "read",
 			mutates: false,
@@ -17000,7 +17227,6 @@ const buildSql = (deps, platform) => {
 						}
 					});
 				} catch (error) {
-					if (error instanceof NeverSyncedError) throw new UsageError(error.message);
 					throw new UsageError(`Query failed (cache is read-only): ${error.message}`);
 				}
 			} finally {
@@ -21173,7 +21399,7 @@ function createEnv(opts) {
 }
 //#endregion
 //#region package.json
-var version$1 = "0.9.0";
+var version$1 = "0.10.1";
 //#endregion
 //#region src/lib/env.ts
 const URLWithTrailingSlash = url().transform(ensureTrailingSlash);
@@ -21587,8 +21813,17 @@ const authWhoamiOutput = async (client, apiURL = env.SOCIAL_API_URL) => {
 	}
 };
 const MAX_CACHE_TTL_SECONDS = 10080 * 60;
-const CLIConfig = object({ cache: object({ cacheTTLSeconds: number().int().min(0).max(MAX_CACHE_TTL_SECONDS).default(900) }).default({ cacheTTLSeconds: 900 }) });
-const defaultCLIConfig = () => ({ cache: { cacheTTLSeconds: 900 } });
+const CLIConfig = object({
+	cache: object({ cacheTTLSeconds: number().int().min(0).max(MAX_CACHE_TTL_SECONDS).default(900) }).default({ cacheTTLSeconds: 900 }),
+	defaults: object({
+		account: string().optional(),
+		linkedinPage: string().optional()
+	}).default({})
+});
+const defaultCLIConfig = () => ({
+	cache: { cacheTTLSeconds: 900 },
+	defaults: {}
+});
 const configPath = () => join(process.env.HOME ?? homedir(), ".social", "config.json");
 const parseCLIConfig = (serialized) => CLIConfig.parse(JSON.parse(serialized));
 const readCLIConfig = async () => {
@@ -21614,6 +21849,30 @@ const setCacheTTLSeconds = async (cacheTTLSeconds) => {
 	await writeCLIConfig(next);
 	return next;
 };
+const setDefaultAccount = async (selector) => {
+	const config = await readCLIConfig();
+	const next = {
+		...config,
+		defaults: {
+			...config.defaults,
+			account: selector
+		}
+	};
+	await writeCLIConfig(next);
+	return next;
+};
+const setDefaultLinkedinPage = async (companyId) => {
+	const config = await readCLIConfig();
+	const next = {
+		...config,
+		defaults: {
+			...config.defaults,
+			linkedinPage: companyId
+		}
+	};
+	await writeCLIConfig(next);
+	return next;
+};
 const cacheControlHeaderFromConfig = async () => `max-age=${(await readCLIConfig()).cache.cacheTTLSeconds}`;
 //#endregion
 //#region src/lib/output.ts
@@ -22123,24 +22382,70 @@ const commandMeta = (meta) => {
 	};
 };
 const CacheStateOutput = object({ cacheTTLSeconds: number().int().nonnegative() });
+const AccountDefaultOutput = object({ account: string().nullable() });
+const PageDefaultOutput = object({ linkedinPage: string().nullable() });
 const cacheStateFrom = (config) => ({ cacheTTLSeconds: config.cache.cacheTTLSeconds });
 const printCacheState = (config) => {
 	printData(cacheStateFrom(config));
 };
+const printDefaultAccount = (config) => {
+	printData({ account: config.defaults.account ?? null });
+};
+const printDefaultLinkedinPage = (config) => {
+	printData({ linkedinPage: config.defaults.linkedinPage ?? null });
+};
+const cacheCommand = defineCommand({
+	meta: {
+		name: "cache",
+		description: "Read or configure proxy cache defaults."
+	},
+	subCommands: { ttl: defineCommand({
+		meta: commandMeta({
+			name: "ttl",
+			description: "Read or set the default cache TTL in seconds.",
+			contract: {
+				capability: "none",
+				auth: {
+					local: true,
+					required: false
+				},
+				mutates: true,
+				outputSchema: CacheStateOutput,
+				idempotency: "idempotent",
+				responseShaping: { formats: ["json"] },
+				hazards: [{
+					code: "local_config_write",
+					message: "Writes local CLI configuration when ttl_seconds is provided."
+				}]
+			}
+		}),
+		args: { ttl_seconds: {
+			type: "positional",
+			required: false,
+			description: "Cache TTL in seconds."
+		} },
+		run: async ({ args }) => {
+			if (args.ttl_seconds === void 0) {
+				printCacheState(await readCLIConfig());
+				return;
+			}
+			printCacheState(await setCacheTTLSeconds(parseIntegerString("--ttl-seconds", args.ttl_seconds, {
+				min: 0,
+				max: MAX_CACHE_TTL_SECONDS
+			})));
+		}
+	}) }
+});
 const configCommand = defineCommand({
 	meta: {
 		name: "config",
 		description: "Read or configure local social CLI settings."
 	},
-	subCommands: { cache: defineCommand({
-		meta: {
-			name: "cache",
-			description: "Read or configure proxy cache defaults."
-		},
-		subCommands: { ttl: defineCommand({
+	subCommands: {
+		account: defineCommand({
 			meta: commandMeta({
-				name: "ttl",
-				description: "Read or set the default cache TTL in seconds.",
+				name: "account",
+				description: "Read or set the default connected account selector.",
 				contract: {
 					capability: "none",
 					auth: {
@@ -22148,32 +22453,63 @@ const configCommand = defineCommand({
 						required: false
 					},
 					mutates: true,
-					outputSchema: CacheStateOutput,
+					outputSchema: AccountDefaultOutput,
 					idempotency: "idempotent",
 					responseShaping: { formats: ["json"] },
 					hazards: [{
 						code: "local_config_write",
-						message: "Writes local CLI configuration when ttl_seconds is provided."
+						message: "Writes local CLI configuration when selector is provided."
 					}]
 				}
 			}),
-			args: { ttl_seconds: {
+			args: { selector: {
 				type: "positional",
 				required: false,
-				description: "Cache TTL in seconds."
+				description: "Default account selector."
 			} },
 			run: async ({ args }) => {
-				if (args.ttl_seconds === void 0) {
-					printCacheState(await readCLIConfig());
+				if (args.selector === void 0) {
+					printDefaultAccount(await readCLIConfig());
 					return;
 				}
-				printCacheState(await setCacheTTLSeconds(parseIntegerString("--ttl-seconds", args.ttl_seconds, {
-					min: 0,
-					max: MAX_CACHE_TTL_SECONDS
-				})));
+				printDefaultAccount(await setDefaultAccount(String(args.selector)));
 			}
-		}) }
-	}) }
+		}),
+		cache: cacheCommand,
+		page: defineCommand({
+			meta: commandMeta({
+				name: "page",
+				description: "Read or set the default LinkedIn company Page selector.",
+				contract: {
+					capability: "none",
+					auth: {
+						local: true,
+						required: false
+					},
+					mutates: true,
+					outputSchema: PageDefaultOutput,
+					idempotency: "idempotent",
+					responseShaping: { formats: ["json"] },
+					hazards: [{
+						code: "local_config_write",
+						message: "Writes local CLI configuration when company_id is provided."
+					}]
+				}
+			}),
+			args: { company_id: {
+				type: "positional",
+				required: false,
+				description: "Default LinkedIn Page selector."
+			} },
+			run: async ({ args }) => {
+				if (args.company_id === void 0) {
+					printDefaultLinkedinPage(await readCLIConfig());
+					return;
+				}
+				printDefaultLinkedinPage(await setDefaultLinkedinPage(String(args.company_id)));
+			}
+		})
+	}
 });
 //#endregion
 //#region src/billing/index.ts
@@ -34209,17 +34545,20 @@ const createCLIDeps = () => {
 		}
 	};
 	const resolveAccount = async ({ account, platform }) => {
-		if (account) resolveAccountId({ account });
+		const configDefault = (await readCLIConfig()).defaults.account;
+		const selectorToTry = account ?? configDefault;
+		if (selectorToTry) resolveAccountId({ account: selectorToTry });
 		const accounts = await client.accounts.list({
 			platform,
 			includeDisconnected: false
 		});
-		const selected = account ? accounts.find((candidate) => accountMatchesIdentifier(candidate, account)) : accounts[0];
-		if (account && !selected) throw new NotFoundError("account_not_found");
+		const matched = selectorToTry ? accounts.find((candidate) => accountMatchesIdentifier(candidate, selectorToTry)) : void 0;
+		if (account && !matched) throw new NotFoundError("account_not_found");
+		const selected = matched ?? accounts[0];
 		return {
 			platform,
-			username: selected?.username ?? (account?.startsWith("@") ? account.slice(1) : account ?? "default"),
-			selector: selected ? accountSelectorFor(selected) : account
+			username: selected?.username ?? (selectorToTry?.startsWith("@") ? selectorToTry.slice(1) : selectorToTry ?? "default"),
+			selector: selected ? accountSelectorFor(selected) : selectorToTry
 		};
 	};
 	const lookupXHandle = async (input, account) => {
@@ -34320,13 +34659,23 @@ const createCLIDeps = () => {
 		printResult: printResultWithUsage,
 		resolveAccount,
 		resolveAccountId: async (args) => resolveAccountId(args),
+		resolveLinkedinPage: async ({ page }) => {
+			const selectedPage = page ?? (await readCLIConfig()).defaults.linkedinPage;
+			if (!selectedPage) throw new UsageError("No Page selected — pass --page or run `social config page <id>`");
+			return selectedPage;
+		},
 		resolveOwnXAccount: async ({ account }) => {
+			const configDefault = (await readCLIConfig()).defaults.account;
+			const selectorToTry = account ?? configDefault;
+			if (selectorToTry) resolveAccountId({ account: selectorToTry });
 			const accounts = await client.accounts.list({
 				platform: "x",
 				includeDisconnected: false
 			});
-			const selected = account ? accounts.find((candidate) => accountMatchesIdentifier(candidate, account)) : accounts[0];
-			if (!selected) throw account ? new NotFoundError("x_account_not_found") : /* @__PURE__ */ new Error("x_account_not_connected");
+			const matched = selectorToTry ? accounts.find((candidate) => accountMatchesIdentifier(candidate, selectorToTry)) : void 0;
+			if (account && !matched) throw new NotFoundError("x_account_not_found");
+			const selected = matched ?? accounts[0];
+			if (!selected) throw new Error("x_account_not_connected");
 			return {
 				account: {
 					platform: "x",
@@ -34338,14 +34687,18 @@ const createCLIDeps = () => {
 			};
 		},
 		resolveOwnLinkedinAccount: async ({ account }) => {
-			if (account) resolveAccountId({ account });
+			const configDefault = (await readCLIConfig()).defaults.account;
+			const selectorToTry = account ?? configDefault;
+			if (selectorToTry) resolveAccountId({ account: selectorToTry });
 			const accounts = await client.accounts.list({
 				platform: "linkedin",
 				includeDisconnected: false
 			});
-			const selected = account ? accounts.find((candidate) => accountMatchesIdentifier(candidate, account)) : accounts[0];
-			if (!selected) throw account ? new NotFoundError("linkedin_account_not_found") : /* @__PURE__ */ new Error("linkedin_account_not_connected");
-			const profile = await lookupLinkedinProfile("me", account, {
+			const matched = selectorToTry ? accounts.find((candidate) => accountMatchesIdentifier(candidate, selectorToTry)) : void 0;
+			if (account && !matched) throw new NotFoundError("linkedin_account_not_found");
+			const selected = matched ?? accounts[0];
+			if (!selected) throw new Error("linkedin_account_not_connected");
+			const profile = await lookupLinkedinProfile("me", selectorToTry, {
 				platform: "linkedin",
 				username: selected.username,
 				selector: accountSelectorFor(selected)