Function generateTopicsFromTranscript

lib/ai-processing.ts:1169–1349

(
  transcript: TranscriptSegment[],
  options: GenerateTopicsOptions = {}
)

 * @returns Array of topics with segments and quotes
 */
export async function generateTopicsFromTranscript(
  transcript: TranscriptSegment[],
  options: GenerateTopicsOptions = {}
): Promise<{
  topics: Topic[];
  candidates?: TopicCandidate[];
  modelUsed: string;
}> {
  const {
    maxTopics = 5,
    theme,
    excludeTopicKeys,
    includeCandidatePool,
    mode = 'smart',
    provider
  } = options;

  const requestedTopics = Math.max(1, Math.min(maxTopics, 5));
  const fullText = combineTranscript(transcript);
  const excludedKeys = excludeTopicKeys ?? new Set<string>();
  const primaryProvider = getProviderKey(provider);
  const providerRetryResult = await retryProviderBackedTopicGeneration({
    primaryProvider,
    availableProviderKeys: availableProviders(),
    run: async (providerKey) =>
      generateProviderBackedTopicsFromTranscript(transcript, options, providerKey),
    isUsableResult: (result) => (result?.topicsArray.length ?? 0) > 0
  });

  let topicsArray = providerRetryResult.result?.topicsArray ?? [];
  const candidateTopics = providerRetryResult.result?.candidateTopics ?? [];
  const resolvedModel =
    providerRetryResult.result?.resolvedModel ??
    getProviderBackedTopicModel({
      provider: providerRetryResult.providerUsed,
      mode,
      transcript,
      fastModel: options.fastModel,
      proModel: options.proModel
    });

  if (topicsArray.length === 0) {
    console.warn(
      `[generateTopicsFromTranscript] Falling back to local topic generation after provider-backed attempts (${providerRetryResult.providerUsed} was the last provider tried)`
    );
    const fallbackTopics = buildFallbackTopics(
      transcript,
      requestedTopics,
      fullText,
      theme
    );
    topicsArray = fallbackTopics
      .filter((topic) => {
        if (!topic.quote?.timestamp || !topic.quote.text) return false;
        const key = `${topic.quote.timestamp}|${normalizeWhitespace(
          topic.quote.text
        )}`;
        return !excludedKeys.has(key);