@clubnet/seedclub 0.2.25 → 0.2.27

package/assets/extensions/seedclub/tool-utils.ts

@@ -83,6 +83,30 @@ function getDebugText(result: any, expanded: boolean): string | null {
 	return blocks.join("\n\n");
 }
 
+function getCachedDebugText(state: any, result: any, expanded: boolean): string | null {
+	const debugMode = isUiDebugEnabled() || expanded;
+	if (!debugMode) {
+		state.__debugText = null;
+		state.__debugMode = false;
+		state.__debugDetailsRef = undefined;
+		state.__debugContentRef = undefined;
+		return null;
+	}
+
+	const detailsRef = result?.details;
+	const contentRef = result?.content?.[0]?.text;
+	const modeChanged = state.__debugMode !== debugMode;
+	const changed =
+		modeChanged || state.__debugDetailsRef !== detailsRef || state.__debugContentRef !== contentRef;
+	if (changed) {
+		state.__debugText = getDebugText(result, expanded);
+		state.__debugMode = debugMode;
+		state.__debugDetailsRef = detailsRef;
+		state.__debugContentRef = contentRef;
+	}
+	return state.__debugText ?? null;
+}
+
 export function makeProgressCallRenderer(
 	label: string,
 	detail?: (args: any) => string | undefined,
@@ -146,14 +170,14 @@ export function makeProgressResultRenderer(
 		if (result?.isError) {
 			const line = firstTextLine(result?.content) ?? "Request failed";
 			let text = `${theme.fg("error", "✕")} ${theme.fg("error", line)}`;
-			const debugText = getDebugText(result, options?.expanded === true);
+			const debugText = getCachedDebugText(state, result, options?.expanded === true);
 			if (debugText) text += `\n${theme.fg("dim", debugText)}`;
 			return new Text(text, 0, 0);
 		}
 		const detailText = summary?.(result?.details, context?.args) ?? summarizeDetails(result?.details);
 		let text = `${theme.fg("success", "✓")} ${theme.fg("muted", successLabel)}`;
 		if (detailText) text += theme.fg("dim", ` · ${detailText}`);
-		const debugText = getDebugText(result, options?.expanded === true);
+		const debugText = getCachedDebugText(state, result, options?.expanded === true);
 		if (debugText) text += `\n${theme.fg("dim", debugText)}`;
 		return new Text(text, 0, 0);
 	};

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

@@ -11,6 +11,9 @@ const DEFAULT_SHOW_RECORDINGS_LIMIT = 10;
 const MAX_SHOW_RECORDINGS_LIMIT = 25;
 const DEFAULT_TRANSCRIPT_LIMIT = 5;
 const MAX_TRANSCRIPT_LIMIT = 20;
+const DEFAULT_PEOPLE_SEARCH_LIMIT = 5;
+const MAX_PEOPLE_SEARCH_LIMIT = 10;
+const DEFAULT_BOOKING_DURATION_MINUTES = 20;
 const TRANSCRIPT_TEXT_PREVIEW_CHARS = 1800;
 const TRANSCRIPT_VTT_PREVIEW_CHARS = 1000;
 
@@ -53,6 +56,103 @@ function truncateText(value: string | null | undefined, maxChars: number) {
 	return `${value.slice(0, maxChars)}\n...[truncated ${value.length - maxChars} chars]`;
 }
 
+function resolveBookingEndsAt(
+	startsAt: string,
+	endsAt: string | null | undefined,
+	durationMinutes: number | null | undefined,
+) {
+	if (typeof endsAt === "string" && endsAt.trim()) {
+		return endsAt;
+	}
+
+	const startDate = new Date(startsAt);
+	if (Number.isNaN(startDate.getTime())) {
+		return endsAt ?? undefined;
+	}
+
+	const normalizedDuration =
+		typeof durationMinutes === "number" && Number.isFinite(durationMinutes) && durationMinutes > 0
+			? Math.round(durationMinutes)
+			: DEFAULT_BOOKING_DURATION_MINUTES;
+
+	return new Date(startDate.getTime() + normalizedDuration * 60 * 1000).toISOString();
+}
+
+function localMinutesToUTC(date: Date, minutes: number, timeZone: string) {
+	const year = date.getFullYear();
+	const month = date.getMonth();
+	const day = date.getDate();
+	const hours = Math.floor(minutes / 60);
+	const mins = minutes % 60;
+
+	const formatter = new Intl.DateTimeFormat("en-US", {
+		timeZone,
+		year: "numeric",
+		month: "2-digit",
+		day: "2-digit",
+		hour: "2-digit",
+		minute: "2-digit",
+		second: "2-digit",
+		hour12: false,
+	});
+
+	const referenceUtc = new Date(Date.UTC(year, month, day, 12, 0, 0));
+	const parts = formatter.formatToParts(referenceUtc);
+	const tzYear = Number.parseInt(parts.find((part) => part.type === "year")?.value ?? "", 10);
+	const tzMonth = Number.parseInt(parts.find((part) => part.type === "month")?.value ?? "", 10) - 1;
+	const tzDay = Number.parseInt(parts.find((part) => part.type === "day")?.value ?? "", 10);
+	const tzHour = Number.parseInt(parts.find((part) => part.type === "hour")?.value ?? "", 10);
+	const tzMinute = Number.parseInt(parts.find((part) => part.type === "minute")?.value ?? "", 10);
+	const tzSecond = Number.parseInt(parts.find((part) => part.type === "second")?.value ?? "", 10);
+
+	const tzMillis = Date.UTC(tzYear, tzMonth, tzDay, tzHour, tzMinute, tzSecond);
+	const offset = referenceUtc.getTime() - tzMillis;
+	const desiredUtc = Date.UTC(year, month, day, hours, mins, 0);
+	return new Date(desiredUtc + offset);
+}
+
+function getDateDayOfWeek(date: Date, timeZone: string) {
+	const weekday = new Intl.DateTimeFormat("en-US", {
+		timeZone,
+		weekday: "short",
+	})
+		.formatToParts(date)
+		.find((part) => part.type === "weekday")?.value;
+
+	switch (weekday) {
+		case "Sun":
+			return 0;
+		case "Mon":
+			return 1;
+		case "Tue":
+			return 2;
+		case "Wed":
+			return 3;
+		case "Thu":
+			return 4;
+		case "Fri":
+			return 5;
+		case "Sat":
+			return 6;
+		default:
+			return date.getDay();
+	}
+}
+
+function formatSlotRange(startMinutes: number, endMinutes: number, timeZone: string) {
+	const formatter = new Intl.DateTimeFormat("en-US", {
+		timeZone,
+		hour: "numeric",
+		minute: "2-digit",
+		hour12: true,
+		timeZoneName: "short",
+	});
+	const anchor = new Date(Date.UTC(2026, 0, 5, 12, 0, 0));
+	const start = localMinutesToUTC(anchor, startMinutes, timeZone);
+	const end = localMinutesToUTC(anchor, endMinutes, timeZone);
+	return `${formatter.format(start)} - ${formatter.format(end)}`;
+}
+
 function shapeTranscriptSource(source: any, includeFullText: boolean, includePreview = true) {
 	if (!source) {
 		return null;
@@ -1024,6 +1124,147 @@ async function getMeeting(args: { meetingId: string }) {
 	}
 }
 
+async function searchPeopleForBooking(args: {
+	query: string;
+	limit?: number;
+}) {
+	try {
+		const limit = normalizeLimit(args.limit, {
+			fallback: DEFAULT_PEOPLE_SEARCH_LIMIT,
+			max: MAX_PEOPLE_SEARCH_LIMIT,
+		});
+		const response = await api.get<any>("/core/parties", {
+			party_type: "person",
+			search: args.query,
+			limit,
+		});
+
+		return {
+			data: Array.isArray(response?.data)
+				? response.data.map((item: any) => ({
+						partyId: item?.party?.id ?? item?.party?.party_id ?? item?.person?.id ?? null,
+						displayName:
+							item?.person?.full_name ??
+							item?.party?.display_name ??
+							item?.organization?.name ??
+							null,
+						email: item?.person?.email ?? null,
+						avatarUrl: item?.person?.avatar_url ?? null,
+						twitterUsername: item?.person?.twitter_username ?? null,
+						organizationName:
+							item?.primary_org_role?.organization_name ??
+							item?.organization?.name ??
+							null,
+				  }))
+				: [],
+			pagination: response?.pagination ?? null,
+		};
+	} catch (error) {
+		if (error instanceof ApiError) return { error: error.message, status: error.status };
+		throw error;
+	}
+}
+
+async function listMeetingAvailabilitySlots(args: {
+	date: string;
+	programSlug?: string;
+	timeZone?: string;
+}) {
+	try {
+		const requestedDate = new Date(args.date);
+		if (Number.isNaN(requestedDate.getTime())) {
+			return { error: "date must be a valid ISO date or timestamp.", status: 400 };
+		}
+
+		const requestedTimeZone =
+			typeof args.timeZone === "string" && args.timeZone.trim()
+				? args.timeZone.trim()
+				: "America/New_York";
+		const dayOfWeek = getDateDayOfWeek(requestedDate, requestedTimeZone);
+		const response = await api.get<any>("/meetings/availability", {
+			program_slug: args.programSlug,
+			day_of_week: dayOfWeek,
+		});
+
+		const slots = Array.isArray(response?.data)
+			? response.data.map((window: any) => {
+					const slotTimeZone =
+						typeof window?.timezone === "string" && window.timezone.trim()
+							? window.timezone.trim()
+							: requestedTimeZone;
+					const startsAt = localMinutesToUTC(requestedDate, Number(window?.start_minutes ?? 0), slotTimeZone);
+					const endsAt = localMinutesToUTC(requestedDate, Number(window?.end_minutes ?? 0), slotTimeZone);
+
+					return {
+						id: window?.id ?? null,
+						label: formatSlotRange(
+							Number(window?.start_minutes ?? 0),
+							Number(window?.end_minutes ?? 0),
+							slotTimeZone,
+						),
+						timeZone: slotTimeZone,
+						startMinutes: window?.start_minutes ?? null,
+						endMinutes: window?.end_minutes ?? null,
+						startsAt: startsAt.toISOString(),
+						endsAt: endsAt.toISOString(),
+						displayRange: formatSlotRange(
+							Number(window?.start_minutes ?? 0),
+							Number(window?.end_minutes ?? 0),
+							slotTimeZone,
+						),
+					};
+			  })
+			: [];
+
+		return {
+			date: args.date,
+			dayOfWeek,
+			slots,
+		};
+	} catch (error) {
+		if (error instanceof ApiError) return { error: error.message, status: error.status };
+		throw error;
+	}
+}
+
+async function bookMeetingFull(args: {
+	startsAt: string;
+	endsAt?: string | null;
+	durationMinutes?: number | null;
+	guestName: string;
+	guestEmail: string;
+	timeZone?: string;
+	title?: string | null;
+	description?: string | null;
+	partyId?: string | null;
+	guestTwitterHandle?: string | null;
+	profileImageUrl?: string | null;
+	programSlug?: string;
+}) {
+	try {
+		const resolvedEndsAt = resolveBookingEndsAt(args.startsAt, args.endsAt, args.durationMinutes);
+		return await api.post<any>("/meetings/book-full", {
+			program_slug: args.programSlug,
+			starts_at: args.startsAt,
+			ends_at: resolvedEndsAt,
+			duration_minutes: args.durationMinutes,
+			time_zone: args.timeZone,
+			title: args.title,
+			description: args.description,
+			guest: {
+				party_id: args.partyId,
+				full_name: args.guestName,
+				email: args.guestEmail,
+				twitter_handle: args.guestTwitterHandle,
+				profile_image_url: args.profileImageUrl,
+			},
+		});
+	} catch (error) {
+		if (error instanceof ApiError) return { error: error.message, status: error.status };
+		throw error;
+	}
+}
+
 async function updateMeeting(args: {
 	meetingId: string;
 	startsAt?: string | null;
@@ -1061,6 +1302,35 @@ async function assignMeeting(args: {
 }
 
 export function registerMeetingTools(pi: ExtensionAPI) {
+	pi.registerTool({
+		name: "seedclub_search_people",
+		label: "Search People",
+		description:
+			"Search people in Seed Club before booking a meeting. Use this first to find an existing guest and get a partyId. If multiple plausible matches appear, ask the user to choose before booking.",
+		parameters: Type.Object({
+			query: Type.String({ description: "Guest name, email, or search text" }),
+			limit: Type.Optional(
+				Type.Number({ description: "Maximum matches to return (defaults to 5, max 10)." }),
+			),
+		}),
+		execute: wrapExecute(searchPeopleForBooking),
+	});
+
+	pi.registerTool({
+		name: "seedclub_list_meeting_availability",
+		label: "List Availability Slots",
+		description:
+			"List the configured availability slots for a specific date. Use this before booking and choose one of the returned slot startsAt/endsAt pairs instead of inventing a meeting length or time.",
+		parameters: Type.Object({
+			date: Type.String({
+				description: "Target date as YYYY-MM-DD or ISO timestamp. The tool returns valid startsAt/endsAt pairs for that day.",
+			}),
+			programSlug: Type.Optional(Type.String({ description: "Program slug. Defaults to 11am on the server." })),
+			timeZone: Type.Optional(Type.String({ description: "Optional timezone used to interpret the requested date. Defaults to America/New_York." })),
+		}),
+		execute: wrapExecute(listMeetingAvailabilitySlots),
+	});
+
 	pi.registerTool({
 		name: "seedclub_list_meetings",
 		label: "List Meetings",
@@ -1358,6 +1628,36 @@ export function registerMeetingTools(pi: ExtensionAPI) {
 		renderResult: makeProgressResultRenderer(getToolSuccessLabel("seedclub_get_meeting"), (details) => details?.meeting?.id || undefined),
 	});
 
+	pi.registerTool({
+		name: "seedclub_book_meeting_full",
+		label: "Book Meeting",
+		description:
+			"Book one guest meeting end-to-end: create the meeting, create the studio link, and create the Google Calendar invite. Always fetch availability first with seedclub_list_meeting_availability and use one of the returned startsAt/endsAt pairs. Only use this after you know guestName, guestEmail, and startsAt. Prefer passing endsAt when using an availability slot. If they only give a slot or duration, pass durationMinutes instead; if neither is available, this tool defaults to a 20-minute meeting, but the backend will still reject times that do not exactly match a configured slot. Search for an existing guest first and pass partyId when you have a confident match; otherwise proceed without partyId and the backend will find or create a contact using guestEmail before booking.",
+		parameters: Type.Object({
+			startsAt: Type.String({ description: "Meeting start time as an ISO timestamp" }),
+			endsAt: Type.Optional(
+				Type.Union([Type.String(), Type.Null()], {
+					description: "Optional meeting end time as an ISO timestamp. If omitted, durationMinutes or the default 20-minute duration is used.",
+				}),
+			),
+			durationMinutes: Type.Optional(
+				Type.Union([Type.Number(), Type.Null()], {
+					description: "Optional meeting length in minutes. Use this when the user gives a duration or a 20-minute slot instead of an explicit end time.",
+				}),
+			),
+			guestName: Type.String({ description: "Guest full name" }),
+			guestEmail: Type.String({ description: "Guest email address" }),
+			timeZone: Type.Optional(Type.String({ description: "IANA timezone like America/New_York" })),
+			title: Type.Optional(Type.Union([Type.String(), Type.Null()])),
+			description: Type.Optional(Type.Union([Type.String(), Type.Null()])),
+			partyId: Type.Optional(Type.Union([Type.String(), Type.Null()])),
+			guestTwitterHandle: Type.Optional(Type.Union([Type.String(), Type.Null()])),
+			profileImageUrl: Type.Optional(Type.Union([Type.String(), Type.Null()])),
+			programSlug: Type.Optional(Type.String({ description: "Program slug. Defaults to 11am on the server." })),
+		}),
+		execute: wrapExecute(bookMeetingFull),
+	});
+
 	pi.registerTool({
 		name: "seedclub_update_meeting",
 		label: "Update Meeting",

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

@@ -92,14 +92,12 @@ let lastCtx: ExtensionContext | undefined;
 						state.contextDisplay = live.contextDisplay;
 						state.costLine = live.costLine;
 					}
-					const seedStatus = footerData.getExtensionStatuses().get("seed") ?? "";
-					const viewStatus = footerData.getExtensionStatuses().get("seed-view") ?? "";
-					state.userLine = [seedStatus, viewStatus].filter(Boolean).join("  •  ");
+					state.userLine = footerData.getExtensionStatuses().get("seed") ?? "";
 					const topRight = theme.fg("dim", `${state.costLine} • ${state.contextDisplay}`);
 					const top = theme.fg("dim", truncateToWidth(state.modelLine, usableWidth));
 					const topAligned = joinLeftRight(top, topRight, usableWidth);
 					if (!state.userLine) return [`${INSET}${topAligned}`];
-					const bottomLeft = theme.fg("text", state.userLine);
+					const bottomLeft = theme.fg("dim", state.userLine);
 					const bottom = joinLeftRight(
 						bottomLeft,
 						"",

package/assets/extensions/seedclub-ui/tool-progress.ts

@@ -4,31 +4,6 @@ import { getToolCallLabel } from "../seedclub/ui-copy.js";
 export default function toolProgressExtension(pi: ExtensionAPI) {
 	let activeTools = 0;
 
-	const applyViewStatus = (ctx: { hasUI: boolean; ui: { getToolsExpanded: () => boolean; setStatus: (key: string, text: string | undefined) => void } }) => {
-		if (!ctx.hasUI) return;
-		const mode = ctx.ui.getToolsExpanded() ? "advanced" : "standard";
-		ctx.ui.setStatus("seed-view", `view: ${mode}`);
-	};
-
-	pi.registerShortcut("alt+o", {
-		description: "Toggle advanced tool detail view",
-		handler: (ctx) => {
-			if (!ctx.hasUI) return;
-			const next = !ctx.ui.getToolsExpanded();
-			ctx.ui.setToolsExpanded(next);
-			applyViewStatus(ctx);
-			ctx.ui.notify(next ? "Advanced tool view: on" : "Advanced tool view: off", "info");
-		},
-	});
-
-	pi.on("session_start", (_event, ctx) => {
-		applyViewStatus(ctx);
-	});
-
-	pi.on("session_switch", (_event, ctx) => {
-		applyViewStatus(ctx);
-	});
-
 	pi.on("tool_execution_start", (event, ctx) => {
 		if (!ctx.hasUI) return;
 		activeTools += 1;

package/package.json

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