@clubnet/seedclub 0.2.19 → 0.2.21

package/README.md

@@ -46,21 +46,11 @@ curl -fsSL https://raw.githubusercontent.com/seedclub/seedclub-agent/main/instal
 
 `@clubnet/seedclub` is currently a private npm package. This auth is only for installing or updating the package from npm. It is separate from `/login` and `/connect` inside the app.
 
-Fast path:
-
-```bash
-SEEDCLUB_NPM_TOKEN=YOUR_NPM_TOKEN curl -fsSL https://raw.githubusercontent.com/seedclub/seedclub-agent/main/install.sh | bash
-seedclub setup-auth
-```
-
-Manual one-time `.npmrc` setup:
-
 ```bash
-echo "@clubnet:registry=https://registry.npmjs.org/" >> ~/.npmrc
-echo "//registry.npmjs.org/:_authToken=YOUR_NPM_TOKEN" >> ~/.npmrc
+npm login
 ```
 
-Then `npm install -g @clubnet/seedclub` works.
+Then `npm install -g @clubnet/seedclub` and `seedclub update` work.
 
 ## Core workflow
 
@@ -80,7 +70,6 @@ The normal interactive flow is:
 | `/connect` | Connect your Seed Club account |
 | `/seedclub` | Main menu — connect, inspect access, and jump into CRM/meetings/media/headlines workflows |
 | `/transcripts` | Export transcript VTT files with filters (date, person, time, output dir) |
-| `seedclub setup-auth` | Configure npm auth for npmjs private package access in `~/.npmrc` |
 
 Natural-language transcript retrieval is also supported (no slash command required). Examples: `download vibhu transcripts from 11am`, `i need transcripts for all guests on 11am last week`. Seed Club will run metadata-first export confirmation and then write VTT files.
 
@@ -147,7 +136,7 @@ seedclub pins versions in `package.json`:
 
 ```json
 {
-  "version": "0.2.18",
+  "version": "0.2.19",
   "dependencies": {
     "@mariozechner/pi-coding-agent": "0.65.2"
   }

package/assets/extensions/seedclub/tools/meetings.ts

@@ -701,6 +701,231 @@ async function listShowRecordings(args: {
 	}
 }
 
+function todayUtcDate() {
+	return new Date().toISOString().slice(0, 10);
+}
+
+function normalizeDateCutoff(value?: string) {
+	if (!value || typeof value !== "string") return todayUtcDate();
+	const trimmed = value.trim();
+	if (!trimmed) return todayUtcDate();
+	if (/^\d{4}-\d{2}-\d{2}$/.test(trimmed)) return trimmed;
+	const parsed = new Date(trimmed);
+	if (!Number.isFinite(parsed.getTime())) return todayUtcDate();
+	return parsed.toISOString().slice(0, 10);
+}
+
+function normalizeGuestNeedle(value?: string | null) {
+	return typeof value === "string" ? value.trim().toLowerCase() : "";
+}
+
+function includesNeedle(haystack: unknown, needle: string) {
+	if (!needle) return false;
+	if (typeof haystack !== "string") return false;
+	return haystack.trim().toLowerCase().includes(needle);
+}
+
+function isOnOrBeforeDate(value: string | null | undefined, beforeDate: string) {
+	if (!value || typeof value !== "string") return false;
+	if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) return false;
+	return value <= beforeDate;
+}
+
+function transcriptMeetingPartyId(row: any) {
+	return (
+		row?.meeting?.primary_contact?.party?.id ??
+		row?.meeting?.primary_party?.id ??
+		row?.meeting?.primary_party_id ??
+		null
+	);
+}
+
+function transcriptMeetingGuestLabel(row: any) {
+	return (
+		row?.transcript_for ??
+		row?.meeting?.primary_contact?.party?.display_name ??
+		row?.meeting?.primary_contact?.person?.full_name ??
+		personFromMeetingTitle(row?.meeting?.title) ??
+		null
+	);
+}
+
+function sortByEventDateDesc<T>(rows: T[], eventDatePicker: (row: T) => string | null | undefined) {
+	return [...rows].sort((a, b) => {
+		const aDate = eventDatePicker(a) ?? "";
+		const bDate = eventDatePicker(b) ?? "";
+		if (aDate === bDate) return 0;
+		return aDate < bDate ? 1 : -1;
+	});
+}
+
+async function findLatestGuestTranscript(args: {
+	programSlug: string;
+	guest: string;
+	beforeDate?: string;
+	needVtt?: boolean;
+	mode?: "compact" | "detail";
+}) {
+	try {
+		const beforeDate = normalizeDateCutoff(args.beforeDate);
+		const needVtt = args.needVtt === true;
+		const mode = args.mode === "detail" ? "detail" : "compact";
+		const guestNeedle = normalizeGuestNeedle(args.guest);
+		if (!guestNeedle) {
+			return {
+				query: {
+					programSlug: args.programSlug,
+					guest: args.guest,
+					beforeDate,
+					needVtt,
+					mode,
+				},
+				found: false,
+				result: null,
+				reason: "Guest is required.",
+			};
+		}
+
+		const guestProfile = await getGuestProfile({
+			programSlug: args.programSlug,
+			search: args.guest,
+			includeCrm: false,
+		});
+		const resolvedPartyId = guestProfile?.contact?.partyId ?? null;
+		const resolvedGuestName = guestProfile?.contact?.displayName ?? args.guest;
+		const resolvedGuestEmail = guestProfile?.contact?.email ?? null;
+
+		let mediaCandidate: any = null;
+		if (resolvedPartyId) {
+			const mediaResponse = await api.get<any>(`/programs/${args.programSlug}/media/assets`, {
+				asset_kind: "full_conversation",
+				party_id: resolvedPartyId,
+			});
+			const mediaRows = Array.isArray(mediaResponse?.data) ? mediaResponse.data : [];
+			const mediaMatches = sortByEventDateDesc(mediaRows, (row: any) => row?.asset?.event_date).filter((row: any) =>
+				isOnOrBeforeDate(row?.asset?.event_date, beforeDate),
+			);
+			mediaCandidate = mediaMatches[0] ?? null;
+		}
+
+		if (mediaCandidate) {
+			const hasText = !!(mediaCandidate?.asset?.transcript_raw && String(mediaCandidate.asset.transcript_raw).trim());
+			const hasVtt = !!(mediaCandidate?.asset?.transcript_vtt && String(mediaCandidate.asset.transcript_vtt).trim());
+			const compactResult = {
+				query: {
+					programSlug: args.programSlug,
+					guest: args.guest,
+					beforeDate,
+					needVtt,
+					mode,
+				},
+				found: needVtt ? hasVtt : hasText || hasVtt,
+				result: {
+					guest: resolvedGuestName,
+					partyId: resolvedPartyId,
+					eventDate: mediaCandidate?.asset?.event_date ?? null,
+					meetingId: mediaCandidate?.asset?.meeting_id ?? null,
+					transcriptType: "full_conversation_asset",
+					hasText,
+					hasVtt,
+					exportReady: hasVtt,
+					source: "media_asset",
+				},
+				reason: needVtt && !hasVtt ? "Latest matching appearance has transcript text but no VTT file." : null,
+			};
+			if (mode === "detail") {
+				return {
+					...compactResult,
+					detail: {
+						resolvedGuestEmail,
+						mediaAssetId: mediaCandidate?.asset?.id ?? null,
+						mediaWorkflowStatus: mediaCandidate?.asset?.workflow_status ?? null,
+						mediaVisibility: mediaCandidate?.asset?.visibility ?? null,
+					},
+				};
+			}
+			return compactResult;
+		}
+
+		const transcriptResponse = await api.get<any>("/meetings/transcripts", {
+			program_slug: args.programSlug,
+			limit: MAX_TRANSCRIPT_LIMIT,
+		});
+		const transcriptRows = shapeTranscriptList(transcriptResponse, false, false)?.data ?? [];
+		const matchingTranscriptRows = sortByEventDateDesc(transcriptRows, (row: any) => row?.transcript?.event_date).filter((row: any) => {
+			const rowEventDate = row?.transcript?.event_date;
+			if (!isOnOrBeforeDate(rowEventDate, beforeDate)) return false;
+			if (resolvedPartyId && transcriptMeetingPartyId(row) === resolvedPartyId) return true;
+			return includesNeedle(transcriptMeetingGuestLabel(row), guestNeedle);
+		});
+		const transcriptCandidate = matchingTranscriptRows[0] ?? null;
+
+		if (transcriptCandidate) {
+			const hasText = transcriptCandidate?.transcript?.has_text === true;
+			const hasVtt = transcriptCandidate?.transcript?.has_vtt === true;
+			const compactResult = {
+				query: {
+					programSlug: args.programSlug,
+					guest: args.guest,
+					beforeDate,
+					needVtt,
+					mode,
+				},
+				found: needVtt ? hasVtt : hasText || hasVtt,
+				result: {
+					guest: transcriptMeetingGuestLabel(transcriptCandidate) ?? resolvedGuestName,
+					partyId: transcriptMeetingPartyId(transcriptCandidate) ?? resolvedPartyId,
+					eventDate: transcriptCandidate?.transcript?.event_date ?? null,
+					meetingId: transcriptCandidate?.transcript?.meeting_id ?? null,
+					transcriptType: transcriptCandidate?.transcript_type ?? (transcriptCandidate?.transcript?.meeting_id ? "meeting" : "conversation"),
+					hasText,
+					hasVtt,
+					exportReady: hasVtt,
+					source: "meetings_transcripts",
+				},
+				reason: needVtt && !hasVtt ? "Latest matching transcript row has text but no VTT file." : null,
+			};
+			if (mode === "detail") {
+				return {
+					...compactResult,
+					detail: {
+						resolvedGuestEmail,
+						transcriptId: transcriptCandidate?.transcript?.id ?? null,
+						transcriptStatus: transcriptCandidate?.transcript?.status ?? null,
+						scannedRows: transcriptRows.length,
+						matchedRows: matchingTranscriptRows.length,
+					},
+				};
+			}
+			return compactResult;
+		}
+
+		return {
+			query: {
+				programSlug: args.programSlug,
+				guest: args.guest,
+				beforeDate,
+				needVtt,
+				mode,
+			},
+			found: false,
+			result: null,
+			reason: "No transcript rows found for this guest before the requested date.",
+			...(mode === "detail"
+				? {
+					detail: {
+						resolvedPartyId,
+						resolvedGuestEmail,
+					},
+			  }
+				: {}),
+		};
+	} catch (error) {
+		if (error instanceof ApiError) return { error: error.message, status: error.status };
+		throw error;
+	}
+}
+
 function dateFromTimestamp(value: string | null | undefined) {
 	if (!value || typeof value !== "string") return null;
 	const match = value.match(/\d{4}-\d{2}-\d{2}/);
@@ -915,6 +1140,43 @@ export function registerMeetingTools(pi: ExtensionAPI) {
 		execute: wrapExecute(getGuestProfile),
 	});
 
+	pi.registerTool({
+		name: "seedclub_find_latest_guest_transcript",
+		label: "Find Latest Guest Transcript",
+		description:
+			"Find the latest transcript context for a guest before a cutoff date with compact output. This orchestrates guest resolution, full-conversation assets, and transcript metadata so callers avoid multi-step JSON-heavy discovery.",
+		parameters: Type.Object({
+			programSlug: Type.String({ description: "Program slug" }),
+			guest: Type.String({ description: "Guest name/email search string" }),
+			beforeDate: Type.Optional(
+				Type.String({
+					description: "Optional inclusive YYYY-MM-DD cutoff. Defaults to today.",
+				}),
+			),
+			needVtt: Type.Optional(
+				Type.Boolean({
+					description: "Set true when caller specifically needs VTT availability.",
+				}),
+			),
+			mode: Type.Optional(
+				Type.Union([Type.Literal("compact"), Type.Literal("detail")], {
+					description: "Response mode. Defaults to compact.",
+				}),
+			),
+		}),
+		execute: wrapExecute(findLatestGuestTranscript),
+		renderResult(result: any, _args: any, theme: any) {
+			if (result.isError) return new Text(theme.fg("error", result.content?.[0]?.text || "Error"), 0, 0);
+			const found = result.details?.found === true;
+			if (!found) {
+				return new Text(theme.fg("dim", result.details?.reason || "No matching transcript found"), 0, 0);
+			}
+			const row = result.details?.result ?? {};
+			const status = `${row?.eventDate ?? "unknown date"} · ${row?.guest ?? "guest"} · text:${row?.hasText ? "yes" : "no"} · vtt:${row?.hasVtt ? "yes" : "no"}`;
+			return new Text(theme.fg("muted", status), 0, 0);
+		},
+	});
+
 	pi.registerTool({
 		name: "seedclub_prepare_clip_packet",
 		label: "Prepare Clip Packet",

package/assets/extensions/seedclub-ui/welcome.ts

@@ -451,32 +451,44 @@ export default function (pi: ExtensionAPI, options?: { enableFrame?: boolean })
 		loaderTimer.unref?.();
 		tuiRef?.requestRender();
 
+		const todayPromise = fetchTodayOn11am();
 		void Promise.all([
 			getData(),
-			withTimeout(fetchTodayOn11am(), TODAY_PREFETCH_TIMEOUT_MS, null),
+			withTimeout(todayPromise, TODAY_PREFETCH_TIMEOUT_MS, null),
 		]).then(([{ weather, market }, todayOn11am]) => {
 			clearInterval(loaderTimer);
-			const theme = ctx.ui.theme;
-			const weatherLine = `  ${weather.icon} ${theme.fg("text", weather.temp)} ${theme.fg("dim", weather.condition)}  ${theme.fg("dim", "·")}  ${theme.fg("dim", weather.location)}`;
-			const marketLine = `  ${market.map((quote) => formatQuote(quote, theme)).join(`  ${theme.fg("dim", "·")}  `)}`;
-			const todayLines = renderTodayOn11amLines(todayOn11am, theme);
-			uiState.todayOn11am = todayOn11am;
+			const renderReadyHeader = (today: TodayOn11am | null) => {
+				const theme = ctx.ui.theme;
+				const weatherLine = `  ${weather.icon} ${theme.fg("text", weather.temp)} ${theme.fg("dim", weather.condition)}  ${theme.fg("dim", "·")}  ${theme.fg("dim", weather.location)}`;
+				const marketLine = `  ${market.map((quote) => formatQuote(quote, theme)).join(`  ${theme.fg("dim", "·")}  `)}`;
+				const todayLines = renderTodayOn11amLines(today, theme);
+				uiState.todayOn11am = today;
+				headerLines = [
+					"",
+					renderTitle(theme),
+					"",
+					weatherLine,
+					marketLine,
+					"",
+					...todayLines,
+					...(todayLines.length ? [""] : []),
+					...setupLines,
+					"",
+				];
+			};
 
-			headerLines = [
-				"",
-				renderTitle(theme),
-				"",
-				weatherLine,
-				marketLine,
-				"",
-				...todayLines,
-				...(todayLines.length ? [""] : []),
-				...setupLines,
-				"",
-			];
+			renderReadyHeader(todayOn11am);
 			uiState.ready = true;
 			ctx.ui.setEditorText("");
 			tuiRef?.requestRender();
+
+			if (!todayOn11am?.guests.length) {
+				void todayPromise.then((freshToday) => {
+					if (!freshToday?.guests.length) return;
+					renderReadyHeader(freshToday);
+					tuiRef?.requestRender();
+				}).catch(() => {});
+			}
 		}).catch(() => {
 			clearInterval(loaderTimer);
 			headerLines = [

package/bin/cli.js

@@ -2,120 +2,22 @@
 "use strict";
 
 const { execFileSync, spawn } = require("child_process");
-const { readFileSync, existsSync, writeFileSync, unlinkSync, mkdirSync } = require("fs");
+const { readFileSync, existsSync, writeFileSync, mkdirSync } = require("fs");
 const { join, dirname, basename } = require("path");
 const { homedir } = require("os");
-const readline = require("readline");
 
 const SC_DIR = join(homedir(), ".seedclub", "agent");
 const VERSION_FILE = join(SC_DIR, ".seedclub-version");
 const SETTINGS_FILE = join(SC_DIR, "settings.json");
 const PI_MAIN_LAUNCHER = join(__dirname, "pi-main-launcher.js");
 process.title = "seedclub";
-const SEEDCLUB_ENV_EXCLUDE = new Set(["SEEDCLUB_NPM_TOKEN", "SEEDCLUB_PI_MAIN"]);
+const SEEDCLUB_ENV_EXCLUDE = new Set(["SEEDCLUB_PI_MAIN"]);
 
 function printPrivateRegistryHint() {
 	console.error("seedclub: install/update failed.");
-	console.error("This package is private on npmjs.");
-	console.error("Configure npm auth, then retry:");
-	console.error("  seedclub setup-auth");
-	console.error("Or run with an ephemeral token:");
-	console.error("  SEEDCLUB_NPM_TOKEN=YOUR_NPM_TOKEN seedclub update");
-}
-
-function upsertLine(lines, prefix, value) {
-	const idx = lines.findIndex((line) => line.trim().startsWith(prefix));
-	if (idx >= 0) {
-		lines[idx] = value;
-	} else {
-		lines.push(value);
-	}
-}
-
-function readNpmrcLines(path) {
-	if (!existsSync(path)) return [];
-	const raw = readFileSync(path, "utf-8");
-	if (!raw.trim()) return [];
-	return raw.split(/\r?\n/).filter((line) => line.length > 0);
-}
-
-function askHidden(prompt) {
-	return new Promise((resolve, reject) => {
-		if (!process.stdin.isTTY || !process.stdout.isTTY) {
-			return reject(new Error("Interactive prompt requires a TTY"));
-		}
-		const rl = readline.createInterface({
-			input: process.stdin,
-			output: process.stdout,
-			terminal: true,
-		});
-		const onData = (char) => {
-			const ch = String(char);
-			if (ch === "\n" || ch === "\r" || ch === "\u0004") {
-				process.stdout.write("\n");
-			} else if (ch === "\u0003") {
-				process.stdout.write("^C\n");
-			} else {
-				process.stdout.write("\x1b[2K\x1b[200D" + prompt + "*".repeat(rl.line.length));
-			}
-		};
-		process.stdin.on("data", onData);
-		rl.question(prompt, (value) => {
-			process.stdin.removeListener("data", onData);
-			rl.close();
-			resolve(value.trim());
-		});
-		rl.on("SIGINT", () => {
-			process.stdin.removeListener("data", onData);
-			rl.close();
-			reject(new Error("Cancelled"));
-		});
-	});
-}
-
-async function setupAuth() {
-	const npmrcPath = join(homedir(), ".npmrc");
-	let token = process.env.SEEDCLUB_NPM_TOKEN || process.env.NPM_TOKEN || "";
-	if (!token) {
-		try {
-			token = await askHidden("npm token: ");
-		} catch (err) {
-			console.error(`seedclub: ${err.message}`);
-			process.exit(1);
-		}
-	}
-	if (!token) {
-		console.error("seedclub: no token provided.");
-		process.exit(1);
-	}
-
-	const lines = readNpmrcLines(npmrcPath);
-	upsertLine(lines, "@clubnet:registry=", "@clubnet:registry=https://registry.npmjs.org/");
-	upsertLine(lines, "//registry.npmjs.org/:_authToken=", `//registry.npmjs.org/:_authToken=${token}`);
-	writeFileSync(npmrcPath, lines.join("\n") + "\n", { mode: 0o600 });
-
-	console.log(`Wrote npm auth config to ${npmrcPath}`);
-	console.log("You can now run:");
-	console.log("  npm install -g @clubnet/seedclub");
-}
-
-function withOptionalEphemeralNpmrc(run) {
-	const token = process.env.SEEDCLUB_NPM_TOKEN || process.env.NPM_TOKEN;
-	if (!token) return run([]);
-
-	const npmrcPath = join(SC_DIR, ".npmrc.tmp");
-	try {
-		writeFileSync(
-			npmrcPath,
-			`@clubnet:registry=https://registry.npmjs.org/\n//registry.npmjs.org/:_authToken=${token}\n`,
-			{ mode: 0o600 },
-		);
-		return run(["--userconfig", npmrcPath]);
-	} finally {
-		try {
-			unlinkSync(npmrcPath);
-		} catch {}
-	}
+	console.error("If npm reports a private package or permission error, run:");
+	console.error("  npm login");
+	console.error("  seedclub update");
 }
 
 function findPackageRoot(fromFile, expectedName) {
@@ -533,19 +435,10 @@ if (cmd === "theme") {
 	process.exit(0);
 }
 
-if (cmd === "setup-auth") {
-	setupAuth().catch((err) => {
-		console.error(`seedclub: ${err instanceof Error ? err.message : String(err)}`);
-		process.exit(1);
-	});
-}
-
 if (cmd === "update") {
 	try {
-		withOptionalEphemeralNpmrc((extraArgs) => {
-			execFileSync("npm", ["install", "-g", "@clubnet/seedclub@latest", ...extraArgs], {
-				stdio: "inherit",
-			});
+		execFileSync("npm", ["install", "-g", "@clubnet/seedclub@latest"], {
+			stdio: "inherit",
 		});
 	} catch {
 		printPrivateRegistryHint();
@@ -554,8 +447,7 @@ if (cmd === "update") {
 	process.exit(0);
 }
 
-if (cmd !== "setup-auth") {
-	// ── Resolve pi binary ───────────────────────────────────────────────────
+// ── Resolve pi binary ───────────────────────────────────────────────────
 
 	let piBin;
 	let piEntry;
@@ -618,4 +510,3 @@ if (cmd !== "setup-auth") {
 				}
 			});
 		});
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubnet/seedclub",
-  "version": "0.2.19",
+  "version": "0.2.21",
   "description": "A branded command-line agent wrapper around pi, with integrated Seed Club commands, tools, and app actions",
   "license": "MIT",
   "repository": {