Repository Public License
1//2// ORIX Audio3// File: ORIXAudio/Services/ActionRunner.swift4// Description: Executes ORIX Actions workflows on one or many recordings: every step calls the same engines the rest of the app uses.5//6// Author: Simon-Pierre Boucher7// Contact: contact@spboucher.ai8//9import Foundation10import Observation11import ORIXAudioCore1213@MainActor @Observable14final class ActionRunner {15 struct StepLog: Identifiable {16 enum Outcome { case running, done, failed(String), skipped(String) }17 let id = UUID()18 var recordingTitle: String19 var step: ActionStep20 var outcome: Outcome21 }2223 private(set) var isRunning = false24 private(set) var log: [StepLog] = []25 private(set) var progress: Double = 026 private(set) var outputs: [URL] = []27 private(set) var createdRecordings: [UUID] = []28 private(set) var workflowName = ""29 private var task: Task<Void, Never>?30 weak var model: AppModel?3132 func cancel() { task?.cancel() }3334 func start(_ workflow: Workflow, on recordings: [Recording]) {35 guard !isRunning else { return }36 task = Task { await run(workflow, on: recordings) }37 }3839 func run(_ workflow: Workflow, on recordings: [Recording]) async {40 guard !isRunning, let model else { return }41 isRunning = true; log = []; outputs = []; createdRecordings = []; progress = 0; workflowName = workflow.name42 defer { isRunning = false; progress = 1 }43 let steps = workflow.steps44 let total = Double(max(1, steps.count * recordings.count))45 var completed = 0.046 for recording in recordings {47 var current = recording48 var pending: PendingEdit?49 for step in steps {50 if Task.isCancelled { return }51 log.append(StepLog(recordingTitle: recording.title, step: step, outcome: .running))52 let index = log.count - 153 do {54 if step.producesAudio {55 var edit = pending ?? PendingEdit(document: EditDocument(sourceName: current.fileName, duration: current.duration), format: nil)56 try await apply(step, to: &edit, recording: current, model: model)57 pending = edit58 } else {59 if let edit = pending { current = try await materialize(edit, from: current, model: model); pending = nil }60 try await perform(step, on: current, model: model)61 }62 log[index].outcome = .done63 } catch is CancellationError {64 log[index].outcome = .skipped(String(localized: "Cancelled")); return65 } catch let skip as Skip {66 log[index].outcome = .skipped(skip.reason)67 } catch {68 // A failed step stops this recording's chain (later steps depend on it) but not the batch.69 log[index].outcome = .failed(CoreText.describe(error))70 pending = nil71 completed += 1; progress = completed / total72 break73 }74 completed += 1; progress = completed / total75 }76 if let edit = pending, !Task.isCancelled {77 do { _ = try await materialize(edit, from: current, model: model) }78 catch { log.append(StepLog(recordingTitle: recording.title, step: .convert(format: edit.format ?? .alac), outcome: .failed(error.localizedDescription))) }79 }80 }81 }8283 private struct PendingEdit { var document: EditDocument; var format: AudioExportFormat? }84 private struct Skip: Error { var reason: String }8586 private func apply(_ step: ActionStep, to edit: inout PendingEdit, recording: Recording, model: AppModel) async throws {87 switch step {88 case .removeSilence(let minimum):89 if LibraryFiles.analysis(recording.id) == nil { try await model.processing.analyze(recording) }90 guard let report = LibraryFiles.analysis(recording.id) else { throw ExportError.missing("analysis") }91 let silences = report.time.silences.filter { $0.duration >= minimum }92 guard !silences.isEmpty else { throw Skip(reason: String(localized: "No silence longer than \(minimum.formatted()) s")) }93 edit.document.removeSilences(silences)94 case .normalize(let target):95 let document = edit.document, url = recording.audioURL96 let peak = try await Task.detached { try EditRenderer(document: document, sourceURLs: [url]).measurePeakDBFS(isCancelled: { Task.isCancelled }) }.value97 edit.document.normalize(measuredPeakDBFS: peak, targetPeakDBFS: target)98 case .enhance(let noise, let voice, let highPass):99 var effects: [AudioEffect] = []100 if noise > 0 { effects.append(.noiseReduction(strength: noise)) }101 if voice { effects.append(.voiceEnhance) } else if highPass > 0 { effects.append(.highPass(frequencyHz: highPass)) }102 edit.document.setEffects(effects)103 case .convert(let format):104 edit.format = format105 default: break106 }107 }108109 private func materialize(_ edit: PendingEdit, from recording: Recording, model: AppModel) async throws -> Recording {110 let format = edit.format ?? (recording.isLossless ? .alac : .aac)111 let document = edit.document, source = recording.audioURL, channels = recording.channels112 let created = try await model.addDerivedRecording(from: recording, titleSuffix: String(localized: "(processed)"), format: format) { url in113 try EditRenderer(document: document, sourceURLs: [source]).export(to: url, format: format, aacBitRate: 128_000 * min(2, channels), isCancelled: { Task.isCancelled })114 }115 createdRecordings.append(created.id)116 return created117 }118119 private func perform(_ step: ActionStep, on recording: Recording, model: AppModel) async throws {120 switch step {121 case .analyze:122 try await model.processing.analyze(recording)123 case .transcribe(let localeIdentifier):124 try await model.processing.transcribe(recording, locale: Locale(identifier: localeIdentifier), allowModelDownload: false)125 case .summarize:126 guard MeetingIntelligence.availability == .available else { throw Skip(reason: CoreText.explain(MeetingIntelligence.availability)) }127 try await model.processing.summarize(recording)128 case .exportTranscript(let format):129 guard let transcript = LibraryFiles.transcript(recording.id) else { throw ExportError.missing(String(localized: "transcript")) }130 outputs.append(try ExportService.transcript(transcript, title: recording.title, format: format))131 case .exportReport:132 if LibraryFiles.analysis(recording.id) == nil { try await model.processing.analyze(recording) }133 guard let report = LibraryFiles.analysis(recording.id) else { throw ExportError.missing(String(localized: "analysis")) }134 outputs.append(try ExportService.report(report, title: recording.title, format: .pdf))135 default: break136 }137 }138}139