@clubnet/seedclub 0.2.20 → 0.2.22

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/editor.ts

@@ -14,12 +14,13 @@ class SurfaceEditor extends CustomEditor {
 	private readonly getPalette: () => Palette;
 	private static readonly RESET = "\x1b[0m";
 	private static readonly INSET = "";
+	private static readonly CONTENT_INSET = 2;
 	private static readonly PLACEHOLDER = "/ for menu";
 
 	constructor(tui: TUI, theme: EditorTheme, kb: KeybindingsManager, getPalette: () => Palette) {
 		super(tui, theme, kb);
 		this.getPalette = getPalette;
-		this.setPaddingX(2);
+		super.setPaddingX(SurfaceEditor.CONTENT_INSET);
 	}
 
 	render(width: number): string[] {
@@ -47,6 +48,10 @@ class SurfaceEditor extends CustomEditor {
 		super.invalidate();
 	}
 
+	override setPaddingX(_padding: number): void {
+		super.setPaddingX(SurfaceEditor.CONTENT_INSET);
+	}
+
 	override handleInput(data: string): void {
 		if (!uiState.ready) {
 			// Keep app-level interrupts available while startup UI is loading.

package/package.json

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