@usesocial/cli 0.10.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;
@@ -6549,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;
@@ -6745,7 +6768,7 @@ 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,
@@ -6825,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,
@@ -6853,10 +6876,11 @@ 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;
@@ -6890,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;
 		}
@@ -6913,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,
@@ -6937,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) {
@@ -6956,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,
@@ -6971,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,
@@ -6980,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({
@@ -6992,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,
@@ -7001,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,
@@ -7519,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",
@@ -10441,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,
@@ -10883,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"
@@ -10923,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",
@@ -11052,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,
@@ -11164,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,
@@ -11420,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(),
@@ -11500,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({
@@ -11549,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(),
@@ -11631,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(),
@@ -11645,6 +11828,8 @@ const schemas$1 = {
 	CompaniesCompanyOutput,
 	CompaniesJobsInput,
 	CompaniesJobsOutput,
+	PageVisitorsInput,
+	PageVisitorsOutput,
 	PostsCommentsInput,
 	PostsCommentsOutput,
 	PostsReactionsInput,
@@ -11670,6 +11855,9 @@ const schemas$1 = {
 	MessagesMessageInput,
 	MessagesMessageContractInput,
 	MessagesMessageOutput,
+	PageInviteInput,
+	PageInviteContractInput,
+	PageInviteOutput,
 	PostsPostInput,
 	PostsPostContractInput,
 	PostsPostOutput,
@@ -11679,6 +11867,9 @@ const schemas$1 = {
 	PostsReactInput,
 	PostsReactContractInput,
 	PostsReactOutput,
+	LinkedinProxyInput,
+	LinkedinProxyContractInput,
+	LinkedinProxyOutput,
 	RequestsSendInput,
 	RequestsSendContractInput: RequestsSendInput.extend({
 		body: object({
@@ -11792,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 {
@@ -11841,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}...`);
 	}
@@ -11935,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") {
@@ -11983,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");
@@ -12036,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);
@@ -13567,6 +13809,7 @@ createLinkedinCommands({
 	printResult: unconfigured$1,
 	resolveAccount: unconfigured$1,
 	resolveAccountId: unconfigured$1,
+	resolveLinkedinPage: unconfigured$1,
 	resolveOwnLinkedinAccount: unconfigured$1
 });
 //#endregion
@@ -21156,7 +21399,7 @@ function createEnv(opts) {
 }
 //#endregion
 //#region package.json
-var version$1 = "0.10.0";
+var version$1 = "0.10.1";
 //#endregion
 //#region src/lib/env.ts
 const URLWithTrailingSlash = url().transform(ensureTrailingSlash);
@@ -21570,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 () => {
@@ -21597,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
@@ -22106,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: {
@@ -22131,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
@@ -34192,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) => {
@@ -34303,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",
@@ -34321,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)