@clubnet/seedclub 0.2.36 → 0.2.37

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

@@ -147,6 +147,10 @@ function inferContentType(fileName: string) {
 	return "video/mp4";
 }
 
+function isIsoDate(value: string) {
+	return /^\d{4}-\d{2}-\d{2}$/.test(value);
+}
+
 async function inferMediaOrientation(
 	filePath: string,
 	contentType: string,
@@ -180,143 +184,6 @@ async function inferMediaOrientation(
 	}
 }
 
-async function publishClipAsset(args: {
-	programSlug: string;
-	storageUrl: string;
-	associationPolicy?: "required" | "preferred" | "none" | null;
-	meetingId?: string | null;
-	guestName?: string | null;
-	primaryPartyId?: string | null;
-	partyIds?: string[] | null;
-	audioUrl?: string | null;
-	contentType?: string | null;
-	description?: string | null;
-	durationSeconds?: number | null;
-	eventDate?: string | null;
-	fileName?: string | null;
-	fileSize?: number | null;
-	keyQuestion?: string | null;
-	orientation?: string | null;
-	publicationUrls?: {
-		instagram?: string | null;
-		tiktok?: string | null;
-		x?: string | null;
-		youtube?: string | null;
-		zora?: string | null;
-	} | null;
-	thumbnailUrl?: string | null;
-	title?: string | null;
-	transcriptEdited?: string | null;
-	transcriptRaw?: string | null;
-	transcriptVtt?: string | null;
-	triggerTranscription?: boolean | null;
-	visibility?: string | null;
-	workflowStatus?: string | null;
-	publishingJob?: {
-		platform: string;
-		title?: string | null;
-		description?: string | null;
-		scheduledFor?: string | null;
-		publishedAt?: string | null;
-		status?: string | null;
-		isImmediate?: boolean;
-		tags?: string[] | null;
-		thumbnailAssetId?: string | null;
-		legacyAssetSourceId?: string | null;
-		metadataJson?: Record<string, unknown> | null;
-		destination?: {
-			accountId?: string | null;
-			username?: string | null;
-			displayName?: string | null;
-			profileImageUrl?: string | null;
-			configJson?: Record<string, unknown> | null;
-		} | null;
-	} | null;
-}) {
-	try {
-		const storageUrl = normalizeOptionalString(args.storageUrl);
-		if (!storageUrl) {
-			return {
-				error: "Provide the uploaded clip storageUrl for the final rendered clip.",
-			};
-		}
-
-		const assetResponse = await api.post<any>(`/programs/${args.programSlug}/media/assets`, {
-			asset_kind: "clip",
-			association_policy: normalizeOptionalString(args.associationPolicy),
-			audio_url: normalizeOptionalString(args.audioUrl),
-			content_type: normalizeOptionalString(args.contentType),
-			description: normalizeOptionalString(args.description),
-			duration_seconds: normalizeOptionalNumber(args.durationSeconds),
-			event_date: normalizeOptionalString(args.eventDate),
-			file_name: normalizeOptionalString(args.fileName),
-			file_size: normalizeOptionalNumber(args.fileSize),
-			guest_name: normalizeOptionalString(args.guestName),
-			key_question: normalizeOptionalString(args.keyQuestion),
-			meeting_id: normalizeOptionalString(args.meetingId),
-			orientation: normalizeOptionalString(args.orientation),
-			party_ids: Array.isArray(args.partyIds) ? args.partyIds : null,
-			primary_party_id: normalizeOptionalString(args.primaryPartyId),
-			publication_urls: args.publicationUrls ?? null,
-			storage_url: storageUrl,
-			thumbnail_url: normalizeOptionalString(args.thumbnailUrl),
-			title: normalizeOptionalString(args.title),
-			trigger_transcription: normalizeOptionalBoolean(args.triggerTranscription),
-			transcript_edited: normalizeOptionalString(args.transcriptEdited),
-			transcript_raw: normalizeOptionalString(args.transcriptRaw),
-			transcript_vtt: normalizeOptionalString(args.transcriptVtt),
-			visibility: normalizeOptionalString(args.visibility),
-			workflow_status: normalizeOptionalString(args.workflowStatus),
-		});
-
-		let publishingJob: any = null;
-		if (args.publishingJob?.platform?.trim()) {
-			const createdAssetId = assetResponse?.asset?.id;
-			publishingJob = await api.post<any>(`/programs/${args.programSlug}/publishing/jobs`, {
-				platform: args.publishingJob.platform.trim(),
-				asset_id: typeof createdAssetId === "string" ? createdAssetId : null,
-				title: normalizeOptionalString(args.publishingJob.title),
-				description: normalizeOptionalString(args.publishingJob.description),
-				scheduled_for: normalizeOptionalString(args.publishingJob.scheduledFor),
-				published_at: normalizeOptionalString(args.publishingJob.publishedAt),
-				status: normalizeOptionalString(args.publishingJob.status),
-				is_immediate: args.publishingJob.isImmediate === true,
-				tags: Array.isArray(args.publishingJob.tags)
-					? args.publishingJob.tags.filter((tag) => typeof tag === "string" && tag.trim()).map((tag) => tag.trim())
-					: [],
-				thumbnail_asset_id: normalizeOptionalString(args.publishingJob.thumbnailAssetId),
-				legacy_asset_source_id: normalizeOptionalString(args.publishingJob.legacyAssetSourceId),
-				metadata_json: args.publishingJob.metadataJson ?? {},
-				destination: args.publishingJob.destination
-					? {
-							account_id: normalizeOptionalString(args.publishingJob.destination.accountId),
-							username: normalizeOptionalString(args.publishingJob.destination.username),
-							display_name: normalizeOptionalString(args.publishingJob.destination.displayName),
-							profile_image_url: normalizeOptionalString(args.publishingJob.destination.profileImageUrl),
-							config_json: args.publishingJob.destination.configJson ?? null,
-					  }
-					: null,
-			});
-		}
-
-		return {
-			program: assetResponse?.program ?? null,
-			asset: shapeMediaAssetRow(assetResponse?.asset, false),
-			primary_party: assetResponse?.primary_party ?? null,
-			parties: Array.isArray(assetResponse?.parties) ? assetResponse.parties : [],
-			matched_funnels: Array.isArray(assetResponse?.matched_funnels) ? assetResponse.matched_funnels : [],
-			publications: Array.isArray(assetResponse?.publications) ? assetResponse.publications : [],
-			publishing_job: publishingJob?.data ?? null,
-			linkage: assetResponse?.linkage ?? null,
-			note:
-				"Created the linked media record for an already-hosted clip URL. For local files, use seedclub_upload_clip_asset so seedclub-api handles the 11am Spaces upload.",
-		};
-	} catch (error) {
-		if (error instanceof ApiError) return { error: error.message, status: error.status };
-		throw error;
-	}
-}
-
 async function uploadClipAsset(args: {
 	programSlug: string;
 	filePath: string;
@@ -384,17 +251,39 @@ async function uploadClipAsset(args: {
 
 		const resolvedFileName = normalizeOptionalString(args.fileName) ?? basename(filePath);
 		const resolvedContentType = normalizeOptionalString(args.contentType) ?? inferContentType(resolvedFileName);
+		const resolvedTitle = normalizeOptionalString(args.title);
+		const resolvedEventDate = normalizeOptionalString(args.eventDate);
+		const resolvedMeetingId = normalizeOptionalString(args.meetingId);
+		const resolvedWorkflowStatus = normalizeOptionalString(args.workflowStatus) ?? "published";
+		const missingFields = [
+			...(resolvedTitle ? [] : ["title"]),
+			...(resolvedMeetingId ? [] : ["meetingId"]),
+		];
+		if (missingFields.length) {
+			return {
+				error:
+					`Before uploading, ask the user for the missing clip metadata: ${missingFields.join(", ")}. ` +
+					"For finished clips, workflowStatus is usually published.",
+				missing_fields: missingFields,
+			};
+		}
+		const uploadTitle = resolvedTitle as string;
+		const uploadMeetingId = resolvedMeetingId as string;
+		const uploadWorkflowStatus = resolvedWorkflowStatus as string;
+		if (resolvedEventDate && !isIsoDate(resolvedEventDate)) {
+			return { error: "eventDate must use YYYY-MM-DD format.", field: "eventDate" };
+		}
 		const resolvedOrientation =
 			normalizeOptionalString(args.orientation) ??
 			(await inferMediaOrientation(filePath, resolvedContentType));
 		const presignResponse = await api.post<any>(`/programs/${args.programSlug}/media/ingests`, {
 			association_policy: normalizeOptionalString(args.associationPolicy),
 			content_type: resolvedContentType,
-			event_date: normalizeOptionalString(args.eventDate),
+			event_date: resolvedEventDate,
 			file_name: resolvedFileName,
 			guest_name: normalizeOptionalString(args.guestName),
 			kind: resolvedContentType.startsWith("audio/") ? "audio" : "clip",
-			meeting_id: normalizeOptionalString(args.meetingId),
+			meeting_id: uploadMeetingId,
 			party_ids: Array.isArray(args.partyIds) ? args.partyIds : null,
 			person_name: normalizeOptionalString(args.personName),
 			primary_party_id: normalizeOptionalString(args.primaryPartyId),
@@ -464,12 +353,12 @@ async function uploadClipAsset(args: {
 			description: normalizeOptionalString(args.description),
 			derived_from_asset_id: normalizeOptionalString(args.derivedFromAssetId),
 			duration_seconds: normalizeOptionalNumber(args.durationSeconds),
-			event_date: normalizeOptionalString(args.eventDate),
+			event_date: resolvedEventDate,
 			file_name: resolvedFileName,
 			file_size: fileStats.size,
 			guest_name: normalizeOptionalString(args.guestName),
 			key_question: normalizeOptionalString(args.keyQuestion),
-			meeting_id: normalizeOptionalString(args.meetingId),
+			meeting_id: uploadMeetingId,
 			orientation: resolvedOrientation,
 			party_ids: Array.isArray(args.partyIds) ? args.partyIds : null,
 			primary_party_id: normalizeOptionalString(args.primaryPartyId),
@@ -478,12 +367,12 @@ async function uploadClipAsset(args: {
 			source_recording_id: normalizeOptionalString(args.sourceRecordingId),
 			source_stream_id: normalizeOptionalString(args.sourceStreamId),
 			thumbnail_url: normalizeOptionalString(args.thumbnailUrl),
-			title: normalizeOptionalString(args.title),
+			title: uploadTitle,
 			transcript_edited: normalizeOptionalString(args.transcriptEdited),
 			transcript_raw: normalizeOptionalString(args.transcriptRaw),
 			transcript_vtt: normalizeOptionalString(args.transcriptVtt),
 			visibility: normalizeOptionalString(args.visibility),
-			workflow_status: normalizeOptionalString(args.workflowStatus),
+			workflow_status: uploadWorkflowStatus,
 		});
 
 		return {
@@ -696,12 +585,12 @@ export function registerMediaTools(pi: ExtensionAPI) {
 		name: "seedclub_upload_clip_asset",
 		label: "Upload Clip Asset",
 		description:
-			"Upload a locally rendered 11am clip file to DigitalOcean Spaces through seedclub-api, then create the linked media asset record and optional publishing job. Use this after ffmpeg has cut the clip and appended the current season bumper. The CLI receives only a short-lived upload URL; DigitalOcean keys stay on seedclub-api.",
+			"Upload a locally rendered 11am clip file to DigitalOcean Spaces through seedclub-api, then create the linked media asset record and optional publishing job. Use this after ffmpeg has cut the clip and appended the current season bumper. Before calling this tool, ask for or confidently infer title and meetingId; do not upload without them. eventDate is optional because seedclub-api infers it from meetingId when completing the upload; if supplied, it must be YYYY-MM-DD. workflowStatus defaults to published for finished clips unless the user chooses another status. The CLI receives only a short-lived upload URL; DigitalOcean keys stay on seedclub-api.",
 		parameters: Type.Object({
 			programSlug: Type.String({ description: "Program slug. Currently the upload backend is configured for 11am." }),
 			filePath: Type.String({ description: "Local path to the final rendered clip file after bumper append." }),
 			associationPolicy: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Optional association policy passed through to seedclub-api. Use required, preferred, or none." })),
-			meetingId: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Optional exact meeting id. If omitted, seedclub-api can resolve it from guestName and eventDate." })),
+			meetingId: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Required for upload. Exact meeting id for the source show/interview. Ask the user or resolve it from transcript/recording context before uploading." })),
 			guestName: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Optional guest name passed through to seedclub-api for meeting resolution." })),
 			primaryPartyId: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Optional primary guest party id. If omitted, seedclub-api will infer it from meetingId when possible." })),
 			partyIds: Type.Optional(Type.Union([Type.Array(Type.String()), Type.Null()], { description: "Optional additional related party ids. If omitted, seedclub-api will infer them from meetingId when possible." })),
@@ -710,7 +599,7 @@ export function registerMediaTools(pi: ExtensionAPI) {
 			description: Type.Optional(Type.Union([Type.String(), Type.Null()])),
 			derivedFromAssetId: Type.Optional(Type.Union([Type.String(), Type.Null()])),
 			durationSeconds: Type.Optional(Type.Union([Type.Number(), Type.Null()])),
-			eventDate: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Optional YYYY-MM-DD event date passed through to seedclub-api for association resolution." })),
+			eventDate: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Optional YYYY-MM-DD event date for the presigned storage path. seedclub-api infers final media event_date from meetingId on complete." })),
 			fileName: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Optional storage/display file name. Defaults to basename(filePath)." })),
 			keyQuestion: Type.Optional(Type.Union([Type.String(), Type.Null()])),
 			orientation: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Optional orientation such as vertical or horizontal. If omitted for a local upload, the tool will infer it from the media dimensions when possible." })),
@@ -730,12 +619,12 @@ export function registerMediaTools(pi: ExtensionAPI) {
 			sourceRecordingId: Type.Optional(Type.Union([Type.String(), Type.Null()])),
 			sourceStreamId: Type.Optional(Type.Union([Type.String(), Type.Null()])),
 			thumbnailUrl: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-			title: Type.Optional(Type.Union([Type.String(), Type.Null()])),
+			title: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Required for upload. Human-readable clip title. Ask the user if it cannot be confidently inferred." })),
 			transcriptEdited: Type.Optional(Type.Union([Type.String(), Type.Null()])),
 			transcriptRaw: Type.Optional(Type.Union([Type.String(), Type.Null()])),
 			transcriptVtt: Type.Optional(Type.Union([Type.String(), Type.Null()])),
 			visibility: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-			workflowStatus: Type.Optional(Type.Union([Type.String(), Type.Null()])),
+			workflowStatus: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Optional media workflow state. Defaults to published for finished clips unless the user chooses another status." })),
 			publishingJob: Type.Optional(
 				Type.Union([
 					Type.Object({
@@ -775,91 +664,6 @@ export function registerMediaTools(pi: ExtensionAPI) {
 		}),
 	});
 
-	pi.registerTool({
-		name: "seedclub_publish_clip_asset",
-		label: "Publish Clip Asset",
-		description:
-			"Create a clip media asset linked to the correct meeting and party records, then optionally create a publishing job for an already-hosted clip URL. For local ffmpeg outputs, prefer seedclub_upload_clip_asset so seedclub-api handles the DigitalOcean Spaces presigned upload.",
-		parameters: Type.Object({
-			programSlug: Type.String({ description: "Program slug" }),
-			storageUrl: Type.String({ description: "Public or internal URL for the final rendered clip file." }),
-			associationPolicy: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Optional association policy passed through to seedclub-api. Use required, preferred, or none." })),
-			meetingId: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Optional exact meeting id. If omitted, seedclub-api can resolve it from guestName and eventDate." })),
-			guestName: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Optional guest name passed through to seedclub-api for meeting resolution." })),
-			primaryPartyId: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Optional primary guest party id. If omitted, the tool will try to infer it from the meeting." })),
-			partyIds: Type.Optional(Type.Union([Type.Array(Type.String()), Type.Null()], { description: "Optional additional related party ids. primaryPartyId will be included automatically." })),
-			audioUrl: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-			contentType: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-			description: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-			durationSeconds: Type.Optional(Type.Union([Type.Number(), Type.Null()])),
-			eventDate: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Optional YYYY-MM-DD event date passed through to seedclub-api for association resolution." })),
-			fileName: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-			fileSize: Type.Optional(Type.Union([Type.Number(), Type.Null()])),
-			keyQuestion: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-			orientation: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Optional orientation such as vertical or horizontal." })),
-			publicationUrls: Type.Optional(
-				Type.Union([
-					Type.Object({
-						instagram: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-						tiktok: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-						x: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-						youtube: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-						zora: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-					}),
-					Type.Null(),
-				]),
-			),
-			thumbnailUrl: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-			title: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-			transcriptEdited: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-			transcriptRaw: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-			transcriptVtt: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-			triggerTranscription: Type.Optional(Type.Union([Type.Boolean(), Type.Null()])),
-			visibility: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-			workflowStatus: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-			publishingJob: Type.Optional(
-				Type.Union([
-					Type.Object({
-						platform: Type.String({ description: "Publishing platform slug/name for the downstream job." }),
-						title: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-						description: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-						scheduledFor: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-						publishedAt: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-						status: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-						isImmediate: Type.Optional(Type.Boolean()),
-						tags: Type.Optional(Type.Union([Type.Array(Type.String()), Type.Null()])),
-						thumbnailAssetId: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-						legacyAssetSourceId: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-						metadataJson: Type.Optional(Type.Union([Type.Record(Type.String(), Type.Unknown()), Type.Null()])),
-						destination: Type.Optional(
-							Type.Union([
-								Type.Object({
-									accountId: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-									username: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-									displayName: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-									profileImageUrl: Type.Optional(Type.Union([Type.String(), Type.Null()])),
-									configJson: Type.Optional(Type.Union([Type.Record(Type.String(), Type.Unknown()), Type.Null()])),
-								}),
-								Type.Null(),
-							]),
-						),
-					}),
-					Type.Null(),
-				]),
-			),
-		}),
-		execute: wrapExecute(publishClipAsset),
-		renderCall: makeProgressCallRenderer(getToolCallLabel("seedclub_publish_clip_asset"), (args) => args?.title || args?.guestName || args?.meetingId || args?.programSlug || undefined),
-		renderResult: makeProgressResultRenderer(getToolSuccessLabel("seedclub_publish_clip_asset"), (details) => {
-			const asset = details?.asset ?? {};
-			const assetId = typeof asset?.id === "string" ? asset.id : null;
-			const meetingId = typeof details?.linkage?.meeting_id === "string" ? details.linkage.meeting_id : null;
-			const partyId = typeof details?.linkage?.primary_party_id === "string" ? details.linkage.primary_party_id : null;
-			const pieces = [assetId, meetingId, partyId].filter(Boolean);
-			return pieces.length ? pieces.join(" · ") : undefined;
-		}),
-	});
-
 	pi.registerTool({
 		name: "seedclub_list_program_headlines",
 		label: "List Program Headlines",

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

@@ -38,7 +38,6 @@ export const TOOL_CALL_LABELS: Record<string, string> = {
 	seedclub_list_program_media_assets: "Checking media assets",
 	seedclub_get_program_media_asset: "Loading media asset details",
 	seedclub_upload_clip_asset: "Uploading clip asset",
-	seedclub_publish_clip_asset: "Publishing clip asset",
 	seedclub_list_program_headlines: "Loading program headlines",
 	seedclub_create_program_headline: "Saving headline",
 	seedclub_update_program_headline: "Updating headline",
@@ -85,7 +84,6 @@ export const TOOL_SUCCESS_LABELS: Record<string, string> = {
 	seedclub_list_program_media_assets: "Media assets checked",
 	seedclub_get_program_media_asset: "Media asset details loaded",
 	seedclub_upload_clip_asset: "Clip asset uploaded",
-	seedclub_publish_clip_asset: "Clip asset published",
 	seedclub_list_program_headlines: "Program headlines loaded",
 	seedclub_create_program_headline: "Headline saved",
 	seedclub_update_program_headline: "Headline updated",

package/package.json

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