birdclaw 0.5.1 → 0.6.0

package/src/cli.ts

@@ -17,6 +17,11 @@ import {
 	syncAuthoredTweets,
 	type AuthoredSyncMode,
 } from "#/lib/authored-live";
+import {
+	installAccountSyncLaunchAgent,
+	parseAccountSyncSteps,
+	runAccountSyncJob,
+} from "#/lib/account-sync-job";
 import {
 	exportBackup,
 	importBackup,
@@ -29,6 +34,7 @@ import {
 	installBookmarkSyncLaunchAgent,
 	runBookmarkSyncJob,
 } from "#/lib/bookmark-sync-job";
+import { runDirectMessageRequestMutationViaBird } from "#/lib/bird";
 import { importBlocklist } from "#/lib/blocklist";
 import {
 	type ActionsTransport,
@@ -36,7 +42,11 @@ import {
 	getBirdclawPaths,
 	resolveMentionsDataSource,
 } from "#/lib/config";
-import { syncDirectMessagesViaCachedBird } from "#/lib/dms-live";
+import { closeDatabase } from "#/lib/db";
+import {
+	type DirectMessagesSyncMode,
+	syncDirectMessagesViaCachedBird,
+} from "#/lib/dms-live";
 import { listInboxItems, scoreInbox } from "#/lib/inbox";
 import { backfillLinkIndex, searchLinks } from "#/lib/link-index";
 import { fetchTweetMedia, formatMediaFetchResult } from "#/lib/media-fetch";
@@ -47,6 +57,11 @@ import {
 	exportMentionsViaCachedXurl,
 	syncMentions,
 } from "#/lib/mentions-live";
+import {
+	streamPeriodDigest,
+	type PeriodDigestOptions,
+	type PeriodDigestPreset,
+} from "#/lib/period-digest";
 import {
 	getFollowGraphSummary,
 	listFollowEvents,
@@ -61,6 +76,7 @@ import { resolveProfilesForIds } from "#/lib/profile-resolver";
 import { inspectProfileReplies } from "#/lib/profile-replies";
 import { runResearchMode } from "#/lib/research";
 import {
+	applyDmRequestMutationToLocalStore,
 	createDmReply,
 	createPost,
 	createTweetReply,
@@ -154,6 +170,37 @@ function parsePositiveIntegerOption(value: string | undefined, option: string) {
 	return parsed;
 }
 
+function parseDmInboxOption(
+	value: string | undefined,
+): "all" | "accepted" | "requests" | undefined {
+	const normalized = (value ?? "all").trim().toLowerCase();
+	if (
+		normalized === "all" ||
+		normalized === "accepted" ||
+		normalized === "requests"
+	) {
+		return normalized;
+	}
+	if (normalized === "request") {
+		return "requests";
+	}
+	printError("--inbox must be all, accepted, or requests");
+	process.exitCode = 1;
+	return undefined;
+}
+
+function parseDmSyncModeOption(
+	value: string | undefined,
+): DirectMessagesSyncMode | undefined {
+	const normalized = (value ?? "bird").trim().toLowerCase();
+	if (normalized === "auto" || normalized === "bird" || normalized === "xurl") {
+		return normalized;
+	}
+	printError("--mode must be auto, bird, or xurl");
+	process.exitCode = 1;
+	return undefined;
+}
+
 function parseArchiveImportSelect(value: string | undefined) {
 	if (value === undefined) {
 		return undefined;
@@ -209,6 +256,73 @@ function resolveActionOptions(options: { transport?: string }) {
 	};
 }
 
+function parseDigestPeriod(value: string | undefined): PeriodDigestPreset {
+	const normalized = value?.trim().toLowerCase();
+	if (normalized === "yesterday") return "yesterday";
+	if (normalized === "24h" || normalized === "day") return "24h";
+	if (normalized === "week" || normalized === "7d") return "week";
+	return "today";
+}
+
+function buildDigestOptions(
+	period: string | undefined,
+	options: {
+		account?: string;
+		includeDms?: boolean;
+		model?: string;
+		refresh?: boolean;
+		since?: string;
+		until?: string;
+		maxTweets?: string;
+		maxLinks?: string;
+	},
+): PeriodDigestOptions | null {
+	const maxTweets = parseNonNegativeIntegerOption(
+		options.maxTweets,
+		"--max-tweets",
+	);
+	if (options.maxTweets !== undefined && maxTweets === undefined) {
+		return null;
+	}
+	const maxLinks = parseNonNegativeIntegerOption(
+		options.maxLinks,
+		"--max-links",
+	);
+	if (options.maxLinks !== undefined && maxLinks === undefined) {
+		return null;
+	}
+	return {
+		period: parseDigestPeriod(period),
+		since: options.since,
+		until: options.until,
+		account: options.account,
+		includeDms: Boolean(options.includeDms),
+		refresh: Boolean(options.refresh),
+		model: options.model,
+		maxTweets,
+		maxLinks,
+	};
+}
+
+function runDigestCli(options: PeriodDigestOptions) {
+	const asJson = Boolean(program.opts().json);
+	return streamPeriodDigest(options, {
+		onDelta: asJson
+			? undefined
+			: (delta) => {
+					process.stdout.write(delta);
+				},
+	}).then((result) => {
+		if (asJson) {
+			print(result, true);
+			return;
+		}
+		if (!result.markdown.endsWith("\n")) {
+			process.stdout.write("\n");
+		}
+	});
+}
+
 async function enrichDmItems(
 	query: Parameters<typeof listDmConversations>[0],
 	options: {
@@ -260,14 +374,28 @@ async function enrichDmItems(
 }
 
 async function autoUpdateBeforeRead() {
-	const result = await maybeAutoUpdateBackup();
+	let result: Awaited<ReturnType<typeof maybeAutoUpdateBackup>>;
+	try {
+		result = await maybeAutoUpdateBackup();
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		console.error(`birdclaw backup auto-sync failed: ${message}`);
+		return;
+	}
 	if (!result.ok) {
 		console.error(`birdclaw backup auto-sync failed: ${result.error}`);
 	}
 }
 
 async function autoSyncAfterWrite() {
-	const result = await maybeAutoSyncBackup();
+	let result: Awaited<ReturnType<typeof maybeAutoSyncBackup>>;
+	try {
+		result = await maybeAutoSyncBackup();
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		console.error(`birdclaw backup sync failed: ${message}`);
+		return;
+	}
 	if (!result.ok) {
 		console.error(`birdclaw backup sync failed: ${result.error}`);
 	}
@@ -416,12 +544,13 @@ searchCommand
 
 searchCommand
 	.command("dms <query>")
+	.option("--inbox <kind>", "all, accepted, or requests", "all")
 	.option("--participant <value>")
 	.option("--min-followers <n>", "Minimum sender follower count")
 	.option("--max-followers <n>", "Maximum sender follower count")
 	.option("--min-influence-score <n>", "Minimum derived influence score")
 	.option("--max-influence-score <n>", "Maximum derived influence score")
-	.option("--sort <mode>", "recent or influence", "recent")
+	.option("--sort <mode>", "recent or followers", "recent")
 	.option(
 		"--context <n>",
 		"Include N messages before and after each match",
@@ -447,6 +576,10 @@ searchCommand
 		if (context === undefined) {
 			return;
 		}
+		const inbox = parseDmInboxOption(options.inbox);
+		if (inbox === undefined) {
+			return;
+		}
 		const replyFilter = options.replied
 			? "replied"
 			: options.unreplied
@@ -454,6 +587,7 @@ searchCommand
 				: "all";
 		const dmQuery = {
 			search: query,
+			...(inbox !== "all" ? { inbox } : {}),
 			participant: options.participant,
 			minFollowers: options.minFollowers
 				? Number(options.minFollowers)
@@ -467,7 +601,10 @@ searchCommand
 			maxInfluenceScore: options.maxInfluenceScore
 				? Number(options.maxInfluenceScore)
 				: undefined,
-			sort: options.sort === "influence" ? "influence" : "recent",
+			sort:
+				options.sort === "followers" || options.sort === "influence"
+					? "followers"
+					: "recent",
 			replyFilter,
 			context,
 			limit: Number(options.limit),
@@ -720,6 +857,40 @@ program
 		);
 	});
 
+program
+	.command("today")
+	.description("Stream an AI digest of what happened today")
+	.option("--account <accountId>", "Account id")
+	.option("--include-dms", "Include private DM context")
+	.option("--model <model>", "OpenAI model id")
+	.option("--refresh", "Bypass the local digest cache")
+	.option("--max-tweets <n>", "Maximum tweet context", "300")
+	.option("--max-links <n>", "Maximum linked articles", "12")
+	.action(async (options) => {
+		await autoUpdateBeforeRead();
+		const digestOptions = buildDigestOptions("today", options);
+		if (!digestOptions) return;
+		await runDigestCli(digestOptions);
+	});
+
+program
+	.command("digest [period]")
+	.description("Stream an AI digest for today, 24h, yesterday, or week")
+	.option("--account <accountId>", "Account id")
+	.option("--include-dms", "Include private DM context")
+	.option("--since <isoDate>", "Start of explicit window")
+	.option("--until <isoDate>", "End of explicit window")
+	.option("--model <model>", "OpenAI model id")
+	.option("--refresh", "Bypass the local digest cache")
+	.option("--max-tweets <n>", "Maximum tweet context", "300")
+	.option("--max-links <n>", "Maximum linked articles", "12")
+	.action(async (period, options) => {
+		await autoUpdateBeforeRead();
+		const digestOptions = buildDigestOptions(period, options);
+		if (!digestOptions) return;
+		await runDigestCli(digestOptions);
+	});
+
 const mentionsCommand = program
 	.command("mentions")
 	.description("Export local mention tweets for scripts and agents");
@@ -1033,6 +1204,92 @@ const jobsCommand = program
 	.command("jobs")
 	.description("Run and install background Birdclaw jobs");
 
+jobsCommand
+	.command("sync-account")
+	.description("Refresh live account timelines and append a JSONL audit entry")
+	.option("--account <accountId>", "Account id")
+	.option(
+		"--steps <steps>",
+		"Comma list: timeline,mentions,mention-threads,likes,bookmarks,dms",
+	)
+	.option("--mode <mode>", "auto, xurl, or bird for likes/bookmarks", "auto")
+	.option("--limit <n>", "Per-page/result limit", "100")
+	.option("--max-pages <n>", "Stop after N pages", "3")
+	.option("--cache-ttl <seconds>", "Live-cache freshness window", "120")
+	.option("--refresh", "Bypass live-cache freshness window")
+	.option(
+		"--allow-bird-account",
+		"Assert bird cookies match --account for Bird-backed steps",
+	)
+	.option("--log <path>", "Audit JSONL path")
+	.action(async (options) => {
+		const result = await runAccountSyncJob({
+			account: options.account,
+			steps: parseAccountSyncSteps(options.steps),
+			mode: options.mode as TimelineCollectionMode,
+			limit: Number(options.limit),
+			maxPages: Number(options.maxPages),
+			refresh: Boolean(options.refresh),
+			cacheTtlMs: Number(options.cacheTtl) * 1000,
+			allowBirdAccount: Boolean(options.allowBirdAccount),
+			logPath: options.log,
+		});
+		print(result, true);
+		if (!result.ok) {
+			process.exitCode = 1;
+		}
+	});
+
+jobsCommand
+	.command("install-account-launchd")
+	.description("Install a LaunchAgent that runs account sync")
+	.option("--label <label>", "LaunchAgent label")
+	.option("--interval-seconds <seconds>", "Launch interval", "1800")
+	.option("--program <path>", "birdclaw executable or command", "birdclaw")
+	.option("--account <accountId>", "Account id")
+	.option(
+		"--steps <steps>",
+		"Comma list: timeline,mentions,mention-threads,likes,bookmarks,dms",
+	)
+	.option("--mode <mode>", "auto, xurl, or bird for likes/bookmarks", "auto")
+	.option("--limit <n>", "Per-page/result limit", "100")
+	.option("--max-pages <n>", "Stop after N pages", "3")
+	.option("--cache-ttl <seconds>", "Live-cache freshness window", "120")
+	.option("--no-refresh", "Allow live-cache reuse")
+	.option(
+		"--allow-bird-account",
+		"Assert bird cookies match --account for Bird-backed steps",
+	)
+	.option("--log <path>", "Audit JSONL path")
+	.option("--env-path <path>", "Shell env file to source before running")
+	.option("--env-file <path>", "Deprecated alias for --env-path")
+	.option("--stdout <path>", "launchd stdout path")
+	.option("--stderr <path>", "launchd stderr path")
+	.option("--launch-agents-dir <path>", "LaunchAgents directory")
+	.option("--no-load", "Write plist without loading it")
+	.action(async (options) => {
+		const result = await installAccountSyncLaunchAgent({
+			label: options.label,
+			intervalSeconds: Number(options.intervalSeconds),
+			program: options.program,
+			account: options.account,
+			steps: parseAccountSyncSteps(options.steps),
+			mode: options.mode as TimelineCollectionMode,
+			limit: Number(options.limit),
+			maxPages: Number(options.maxPages),
+			refresh: options.refresh,
+			allowBirdAccount: Boolean(options.allowBirdAccount),
+			cacheTtlSeconds: Number(options.cacheTtl),
+			logPath: options.log,
+			envFile: options.envPath ?? options.envFile,
+			stdoutPath: options.stdout,
+			stderrPath: options.stderr,
+			launchAgentsDir: options.launchAgentsDir,
+			load: options.load,
+		});
+		print(result, true);
+	});
+
 jobsCommand
 	.command("sync-bookmarks")
 	.description("Refresh live bookmarks and append a JSONL audit entry")
@@ -1074,7 +1331,8 @@ jobsCommand
 	.option("--cache-ttl <seconds>", "Live-cache freshness window", "120")
 	.option("--no-refresh", "Allow live-cache reuse")
 	.option("--log <path>", "Audit JSONL path")
-	.option("--env-file <path>", "Shell env file to source before running")
+	.option("--env-path <path>", "Shell env file to source before running")
+	.option("--env-file <path>", "Deprecated alias for --env-path")
 	.option("--stdout <path>", "launchd stdout path")
 	.option("--stderr <path>", "launchd stderr path")
 	.option("--launch-agents-dir <path>", "LaunchAgents directory")
@@ -1091,7 +1349,7 @@ jobsCommand
 			refresh: options.refresh,
 			cacheTtlSeconds: Number(options.cacheTtl),
 			logPath: options.log,
-			envFile: options.envFile,
+			envFile: options.envPath ?? options.envFile,
 			stdoutPath: options.stdout,
 			stderrPath: options.stderr,
 			launchAgentsDir: options.launchAgentsDir,
@@ -1103,14 +1361,19 @@ jobsCommand
 dmsCommand
 	.command("list")
 	.option("--account <accountId>", "Account id")
-	.option("--refresh", "Refresh live DMs through bird before listing")
+	.option("--mode <mode>", "auto, bird, or xurl", "bird")
+	.option("--refresh", "Refresh live DMs before listing")
 	.option("--cache-ttl <seconds>", "Live-cache freshness window", "120")
+	.option("--inbox <kind>", "all, accepted, or requests", "all")
+	.option("--max-pages <n>", "Additional accepted/request pages to sync", "0")
+	.option("--all-pages", "Fetch all accepted/request pages while syncing")
+	.option("--page-delay-ms <n>", "Delay between live DM page requests", "0")
 	.option("--participant <value>")
 	.option("--min-followers <n>", "Minimum sender follower count")
 	.option("--max-followers <n>", "Maximum sender follower count")
 	.option("--min-influence-score <n>", "Minimum derived influence score")
 	.option("--max-influence-score <n>", "Maximum derived influence score")
-	.option("--sort <mode>", "recent or influence", "recent")
+	.option("--sort <mode>", "recent or followers", "recent")
 	.option(
 		"--resolve-profiles",
 		"Resolve placeholder DM profiles through cache/bird/xurl",
@@ -1131,10 +1394,33 @@ dmsCommand
 			: options.unreplied
 				? "unreplied"
 				: "all";
+		const inbox = parseDmInboxOption(options.inbox);
+		const mode = parseDmSyncModeOption(options.mode);
+		const maxPages = parseNonNegativeIntegerOption(
+			options.maxPages,
+			"--max-pages",
+		);
+		const pageDelayMs = parseNonNegativeIntegerOption(
+			options.pageDelayMs,
+			"--page-delay-ms",
+		);
+		if (
+			inbox === undefined ||
+			mode === undefined ||
+			maxPages === undefined ||
+			pageDelayMs === undefined
+		) {
+			return;
+		}
 		if (options.refresh) {
 			await syncDirectMessagesViaCachedBird({
 				account: options.account,
+				mode,
 				limit: Number(options.limit),
+				...(inbox !== "all" ? { inbox } : {}),
+				...(maxPages > 0 ? { maxPages } : {}),
+				...(options.allPages ? { allPages: true } : {}),
+				...(pageDelayMs > 0 ? { pageDelayMs } : {}),
 				refresh: true,
 				cacheTtlMs: Number(options.cacheTtl) * 1000,
 			});
@@ -1145,6 +1431,7 @@ dmsCommand
 		const items = await enrichDmItems(
 			{
 				account: options.account,
+				...(inbox !== "all" ? { inbox } : {}),
 				participant: options.participant,
 				minFollowers: options.minFollowers
 					? Number(options.minFollowers)
@@ -1158,7 +1445,10 @@ dmsCommand
 				maxInfluenceScore: options.maxInfluenceScore
 					? Number(options.maxInfluenceScore)
 					: undefined,
-				sort: options.sort === "influence" ? "influence" : "recent",
+				sort:
+					options.sort === "followers" || options.sort === "influence"
+						? "followers"
+						: "recent",
 				replyFilter,
 				limit: Number(options.limit),
 			},
@@ -1175,15 +1465,43 @@ dmsCommand
 
 dmsCommand
 	.command("sync")
-	.description("Refresh live direct messages through bird into the local store")
+	.description("Refresh live direct messages into the local store")
 	.option("--account <accountId>", "Account id")
+	.option("--mode <mode>", "auto, bird, or xurl", "bird")
 	.option("--limit <n>", "Limit messages", "20")
+	.option("--inbox <kind>", "all, accepted, or requests", "all")
+	.option("--max-pages <n>", "Additional accepted/request pages to sync", "0")
+	.option("--all-pages", "Fetch all accepted/request pages")
+	.option("--page-delay-ms <n>", "Delay between live DM page requests", "0")
 	.option("--cache-ttl <seconds>", "Live-cache freshness window", "120")
 	.option("--refresh", "Bypass live-cache freshness window")
 	.action(async (options) => {
+		const inbox = parseDmInboxOption(options.inbox);
+		const mode = parseDmSyncModeOption(options.mode);
+		const maxPages = parseNonNegativeIntegerOption(
+			options.maxPages,
+			"--max-pages",
+		);
+		const pageDelayMs = parseNonNegativeIntegerOption(
+			options.pageDelayMs,
+			"--page-delay-ms",
+		);
+		if (
+			inbox === undefined ||
+			mode === undefined ||
+			maxPages === undefined ||
+			pageDelayMs === undefined
+		) {
+			return;
+		}
 		const result = await syncDirectMessagesViaCachedBird({
 			account: options.account,
+			mode,
 			limit: Number(options.limit),
+			...(inbox !== "all" ? { inbox } : {}),
+			...(maxPages > 0 ? { maxPages } : {}),
+			...(options.allPages ? { allPages: true } : {}),
+			...(pageDelayMs > 0 ? { pageDelayMs } : {}),
 			refresh: Boolean(options.refresh),
 			cacheTtlMs: Number(options.cacheTtl) * 1000,
 		});
@@ -1191,6 +1509,39 @@ dmsCommand
 		print(result, true);
 	});
 
+for (const action of ["accept", "reject", "block"] as const) {
+	const command = dmsCommand
+		.command(`${action} <conversationId>`)
+		.description(`${action} a live DM message request through bird`);
+	if (action === "block") {
+		command
+			.option("--max-pages <n>", "Additional timeline pages to search", "3")
+			.option("--all-pages", "Search all accepted/request timeline pages");
+	}
+	command.action(async (conversationId, options) => {
+		const maxPages =
+			action === "block"
+				? parseNonNegativeIntegerOption(options.maxPages, "--max-pages")
+				: undefined;
+		if (action === "block" && maxPages === undefined) {
+			return;
+		}
+		const result = await runDirectMessageRequestMutationViaBird({
+			action,
+			conversationId,
+			...(action === "block" && maxPages !== undefined ? { maxPages } : {}),
+			...(action === "block" && options.allPages ? { allPages: true } : {}),
+		});
+		if (result.success) {
+			applyDmRequestMutationToLocalStore(conversationId, action);
+		} else {
+			process.exitCode = 1;
+		}
+		await autoSyncAfterWrite();
+		print(result, true);
+	});
+}
+
 registerModerationCommands({
 	program,
 	print,
@@ -1470,9 +1821,17 @@ program
 		await autoUpdateBeforeRead();
 		const child = spawn(
 			process.execPath,
-			["node_modules/vite/bin/vite.js", "dev", "--port", "3000"],
+			[
+				"node_modules/vite/bin/vite.js",
+				"dev",
+				"--host",
+				"127.0.0.1",
+				"--port",
+				"3000",
+			],
 			{
 				cwd: packageRoot,
+				env: { ...process.env, BIRDCLAW_LOCAL_WEB: "1" },
 				stdio: "inherit",
 				detached: process.platform !== "win32",
 			},
@@ -1527,7 +1886,11 @@ program
 	});
 
 export async function runCli(argv = process.argv) {
-	await program.parseAsync(argv);
+	try {
+		await program.parseAsync(argv);
+	} finally {
+		await closeDatabase();
+	}
 }
 
 /* v8 ignore next 5 */