vidpipe 1.3.17 → 1.3.19

package/dist/index.d.ts

@@ -217,6 +217,8 @@ interface ShortClip {
     isLoopCandidate?: boolean;
     /** Path to generated thumbnail image for this short clip */
     thumbnailPath?: string;
+    /** GitHub Issue number of the matched/created idea for this clip (per-clip idea tagging) */
+    ideaIssueNumber?: number;
 }
 /** A planned medium clip segment */
 interface MediumSegment {
@@ -256,6 +258,8 @@ interface MediumClip {
     microHooks?: string[];
     /** Path to generated thumbnail image for this medium clip */
     thumbnailPath?: string;
+    /** GitHub Issue number of the matched/created idea for this clip (per-clip idea tagging) */
+    ideaIssueNumber?: number;
 }
 interface SocialPost {
     platform: Platform;
@@ -331,6 +335,7 @@ declare enum PipelineStage {
     CaptionBurn = "caption-burn",
     IntroOutro = "intro-outro",
     Summary = "summary",
+    IdeaDiscovery = "idea-discovery",
     Shorts = "shorts",
     MediumClips = "medium-clips",
     SocialMedia = "social-media",
@@ -741,6 +746,43 @@ interface InterviewErrorEvent {
  * The SDK consumer or CLI UI implements this to show the question and collect the response.
  */
 type AnswerProvider = (question: string, context: QuestionContext) => Promise<string>;
+/** A single section in a recording agenda, mapped to one idea. */
+interface AgendaSection {
+    /** Section position (1-based) */
+    order: number;
+    /** Section title for the recording outline */
+    title: string;
+    /** GitHub Issue number of the idea this section covers */
+    ideaIssueNumber: number;
+    /** Estimated recording time in minutes */
+    estimatedMinutes: number;
+    /** Talking points to cover in this section (from the idea + agent refinement) */
+    talkingPoints: string[];
+    /** Transition phrase to lead into the NEXT section (empty for last section) */
+    transition: string;
+    /** Recording notes: key phrases, visual cues, energy direction */
+    notes: string;
+}
+/** Complete result from agenda generation. */
+interface AgendaResult {
+    /** Ordered list of recording sections */
+    sections: AgendaSection[];
+    /** Opening hook/intro text for the recording */
+    intro: string;
+    /** Closing CTA/outro text */
+    outro: string;
+    /** Total estimated recording duration in minutes */
+    estimatedDuration: number;
+    /** Fully formatted markdown agenda ready to print or save */
+    markdown: string;
+    /** Generation duration in milliseconds */
+    durationMs: number;
+}
+/** Options for generating a recording agenda. */
+interface GenerateAgendaOptions {
+    /** Override the output file path for the agenda markdown */
+    outputPath?: string;
+}
 
 interface AppEnvironment {
     OPENAI_API_KEY: string;
@@ -813,6 +855,8 @@ interface TimeSlot {
 interface ClipTypeSchedule {
     slots: TimeSlot[];
     avoidDays: DayOfWeek[];
+    queueId?: string;
+    queueName?: string;
 }
 interface PlatformSchedule {
     slots: TimeSlot[];
@@ -879,6 +923,10 @@ interface ProcessOptions {
     skipVisualEnhancement?: boolean;
     /** Skip publishing generated social content */
     skipSocialPublish?: boolean;
+    /** Pipeline spec preset name or path to YAML spec file */
+    spec?: string;
+    /** ISO 8601 date for the publish-by deadline of auto-created ideas (default: 7 days from now) */
+    publishBy?: string;
     /** Callback for real-time pipeline progress events (stage starts, completions, errors) */
     onProgress?: (event: ProgressEvent) => void;
 }
@@ -947,6 +995,13 @@ interface StartInterviewOptions {
     /** Callback for real-time interview events (questions, thinking, tool calls, insights) */
     onEvent?: (event: InterviewEvent) => void;
 }
+/**
+ * Options for generating a recording agenda from multiple ideas.
+ */
+interface GenerateAgendaSDKOptions {
+    /** Override the output file path for the agenda markdown */
+    outputPath?: string;
+}
 /**
  * Main VidPipe SDK interface.
  */
@@ -957,6 +1012,8 @@ interface VidPipeSDK {
     ideate(options?: IdeateOptions): Promise<Idea[]>;
     /** Start an interactive session to develop an idea (Socratic interview, etc.) */
     startInterview(ideaNumber: number, options: StartInterviewOptions): Promise<InterviewResult>;
+    /** Generate a structured recording agenda from multiple ideas */
+    generateAgenda(ideaNumbers: number[], options?: GenerateAgendaSDKOptions): Promise<AgendaResult>;
     /** Idea management */
     ideas: {
         list(filters?: IdeaFilters): Promise<Idea[]>;
@@ -1018,4 +1075,4 @@ type ProgressListener = (event: ProgressEvent) => void;
 
 type InterviewListener = (event: InterviewEvent) => void;
 
-export { type AgentResult, type AnswerProvider, type AnswerReceivedEvent, type AspectRatio, type CaptionStyle, type Chapter, type CreateIdeaInput, type DiagnosticCheck, type DiagnosticResult, type EmotionalTrigger, type EnhancementOpportunity, type GeneratedClip, type GeneratedOverlay, type HookType, type Idea, type IdeaCommentData, type IdeaFilters, type IdeaPublishRecord, type IdeaStatus, type IdeateOptions, type InsightDiscoveredEvent, type InterviewCompleteEvent, type InterviewErrorEvent, type InterviewEvent, type InterviewInsights, type InterviewListener, type InterviewResult, type InterviewStartEvent, type MediumClip, type MediumClipType, type MediumNarrativeStructure, type MediumSegment, type OverlayPlacement, type OverlayRegion, PLATFORM_CHAR_LIMITS, type PipelineCompleteEvent, type PipelineResult, PipelineStage, type PipelineStartEvent, Platform, type ProcessOptions, type ProgressEvent, type ProgressListener, type QAPair, type QuestionAskedEvent, type QuestionContext, type RealignOptions, SUPPORTED_VIDEO_EXTENSIONS, type ScheduleSlot, type ScreenRegion, type Segment, type ShortClip, type ShortClipVariant, type ShortNarrativeStructure, type ShortSegment, type SilenceRemovalResult, type SlotOptions, type SocialPost, type StageCompleteEvent, type StageErrorEvent, type StageResult, type StageSkipEvent, type StageStartEvent, type StartInterviewOptions, type StartMode, type ThinkingEndEvent, type ThinkingStartEvent, type ToolCallEndEvent, type ToolCallStartEvent, type Transcript, type VidPipeConfig, type VidPipeSDK, type VideoFile, type VideoLayout, type VideoPlatform, type VideoSnapshot, type VideoSummary, type VisualEnhancementResult, type WebcamRegion, type Word, createVidPipe, fromLatePlatform, normalizePlatformString, toLatePlatform };
+export { type AgendaResult, type AgendaSection, type AgentResult, type AnswerProvider, type AnswerReceivedEvent, type AspectRatio, type CaptionStyle, type Chapter, type CreateIdeaInput, type DiagnosticCheck, type DiagnosticResult, type EmotionalTrigger, type EnhancementOpportunity, type GenerateAgendaOptions, type GeneratedClip, type GeneratedOverlay, type HookType, type Idea, type IdeaCommentData, type IdeaFilters, type IdeaPublishRecord, type IdeaStatus, type IdeateOptions, type InsightDiscoveredEvent, type InterviewCompleteEvent, type InterviewErrorEvent, type InterviewEvent, type InterviewInsights, type InterviewListener, type InterviewResult, type InterviewStartEvent, type MediumClip, type MediumClipType, type MediumNarrativeStructure, type MediumSegment, type OverlayPlacement, type OverlayRegion, PLATFORM_CHAR_LIMITS, type PipelineCompleteEvent, type PipelineResult, PipelineStage, type PipelineStartEvent, Platform, type ProcessOptions, type ProgressEvent, type ProgressListener, type QAPair, type QuestionAskedEvent, type QuestionContext, type RealignOptions, SUPPORTED_VIDEO_EXTENSIONS, type ScheduleSlot, type ScreenRegion, type Segment, type ShortClip, type ShortClipVariant, type ShortNarrativeStructure, type ShortSegment, type SilenceRemovalResult, type SlotOptions, type SocialPost, type StageCompleteEvent, type StageErrorEvent, type StageResult, type StageSkipEvent, type StageStartEvent, type StartInterviewOptions, type StartMode, type ThinkingEndEvent, type ThinkingStartEvent, type ToolCallEndEvent, type ToolCallStartEvent, type Transcript, type VidPipeConfig, type VidPipeSDK, type VideoFile, type VideoLayout, type VideoPlatform, type VideoSnapshot, type VideoSummary, type VisualEnhancementResult, type WebcamRegion, type Word, createVidPipe, fromLatePlatform, normalizePlatformString, toLatePlatform };