Jake
6bc8acccce
Introduces the architectural spine for the Wyrdnote engine layer per the spec at outputs/wyrdnote/2026-05-10-engine-architecture-spec.md in the CORBEL-Main workspace, Codex-reviewed 2026/05/10. Clean-room derivative of VoiceInk's TranscriptionService / TranscriptionServiceRegistry / TranscriptionPipeline shape. Built from the architectural pattern only; no GPL-3.0 code, comments, or identifiers lifted. Wyrdnote names, control flow, and trait signatures are original. What this lands: crates/cloud-providers/src/provider.rs (new, 184 lines) TranscriptionProvider async trait. Object-safe via async_trait so Arc<dyn TranscriptionProvider> is the canonical shape. Lives in cloud-providers (not transcription) per D7 so an OEM licensee implementing the trait depends only on this crate plus magnotia-core (no transcription internals leaked through the trait surface). Surrounding types: ProviderId (lower-kebab-case), ProviderKind, NetworkRequirement, CostClass, ProviderCapabilities, EngineProfile, ProviderTranscript. Compile-time object-safety witness in tests. crates/cloud-providers/Cargo.toml (modified) Adds async-trait + serde dependencies. crates/cloud-providers/src/lib.rs (modified) Re-exports the provider surface. crates/transcription/src/registry.rs (new, 183 lines) EngineRegistry: catalogue of providers keyed by ProviderId. Push-style registration, default-provider id captured at construction. Read-only after boot. Full unit-test coverage: empty default, register/get round-trip, default-resolves-after-registration, re-register replaces, ids enumeration. crates/transcription/src/orchestrator.rs (new, 286 lines) LocalProviderAdapter wraps Arc<LocalEngine>, presents async TranscriptionProvider upward via tokio::task::spawn_blocking. Per D7 the adapter lives in the orchestrator, NOT as impl TranscriptionProvider for LocalEngine — this keeps the dependency edge one-directional and avoids leaking async-runtime requirements onto the synchronous Transcriber trait. Orchestrator: single transcribe() entry point; resolves a provider from the registry, derives TranscriptionOptions from the EngineProfile, dispatches. Returns a clear error when an unregistered provider is named. Unit tests use a mock CannedProvider to validate dispatch, error handling, and option routing without booting a real model. crates/transcription/Cargo.toml (modified) Depends on magnotia-cloud-providers + async-trait. Dev-dep tokio gains macros + rt-multi-thread features for #[tokio::test]. crates/transcription/src/lib.rs (modified) Exports Orchestrator, EngineRegistry, LocalProviderAdapter, and re-exports the provider trait surface so downstream crates depend only on magnotia-transcription for both local engines and the trait. KNOWN-ISSUES.md (modified) Adds KI-06: existing dictation, live, and meeting commands still call LocalEngine::transcribe_sync directly via pick_engine. The orchestrator path is dormant until a Phase A.1 follow-up commit migrates the call sites. Cloud providers (Phase G) cannot be exercised end-to-end until the rewire lands. Phasing rationale: this commit lands the abstractions cleanly with full test coverage; the rewire is a separate diff so the chunking + post-processing logic in transcribe_file moves without inflating this commit beyond review fidelity. Test results: 9 new tests pass (orchestrator: dispatches, errors-on- unregistered, routes-initial-prompt, object-safe; registry: empty-default, round-trip, default-resolves, re-register, ids-list). Pre-existing 59 transcription tests + 5 cloud-providers tests still green. cargo check --workspace clean. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
69 lines
2.7 KiB
TOML
69 lines
2.7 KiB
TOML
[package]
|
|
name = "magnotia-transcription"
|
|
version = "0.1.0"
|
|
edition = "2021"
|
|
description = "Speech-to-text engine wrappers, model management, and inference concurrency for Magnotia"
|
|
build = "build.rs"
|
|
|
|
[features]
|
|
# Whisper backend (direct whisper-rs). Default on — gating it exists so
|
|
# a future Windows non-AVX2 build, or a cloud-only ASR configuration,
|
|
# can drop whisper-rs-sys entirely per brief item #13. Disabling this
|
|
# feature also drops the WhisperRsBackend module and the load_whisper
|
|
# entry point.
|
|
#
|
|
# `whisper-vulkan` is a separate feature so a non-Vulkan target (Android
|
|
# without GPU drivers, a CPU-only Windows build) can pull in whisper-rs
|
|
# but skip the Vulkan backend. Build CPU-only with:
|
|
# cargo build -p magnotia-transcription --no-default-features --features whisper
|
|
default = ["whisper", "whisper-vulkan"]
|
|
whisper = ["dep:whisper-rs"]
|
|
whisper-vulkan = ["whisper-rs?/vulkan"]
|
|
|
|
[dependencies]
|
|
magnotia-core = { path = "../core" }
|
|
|
|
# TranscriptionProvider async trait + EngineProfile + ProviderId. The
|
|
# trait lives in cloud-providers so an OEM licensee can implement it
|
|
# without depending on transcription internals.
|
|
magnotia-cloud-providers = { path = "../cloud-providers" }
|
|
|
|
# Async-trait for the LocalProviderAdapter impl.
|
|
async-trait = "0.1"
|
|
|
|
# Parakeet via ONNX. Whisper is handled directly via whisper-rs below.
|
|
transcribe-rs = { version = "0.3", default-features = false, features = ["onnx"] }
|
|
|
|
# Async runtime for spawn_blocking
|
|
tokio = { version = "1", features = ["rt", "sync"] }
|
|
|
|
# Model downloads
|
|
reqwest = { version = "0.12", default-features = false, features = ["rustls-tls", "stream"] }
|
|
futures-util = "0.3"
|
|
|
|
# Download integrity verification
|
|
sha2 = "0.10"
|
|
|
|
# Gated behind the `whisper` feature (see [features] above). Vulkan is
|
|
# additive via the `whisper-vulkan` feature so non-GPU targets can drop it.
|
|
whisper-rs = { version = "0.16", default-features = false, optional = true }
|
|
|
|
# Typed error enum used by WhisperRsBackend + elsewhere. Kept
|
|
# unconditional because it is a derive-macro crate with negligible
|
|
# build cost.
|
|
thiserror = "2"
|
|
|
|
# Structured logging at backend boundaries (observability for initial_prompt flow).
|
|
tracing = "0.1"
|
|
|
|
[dev-dependencies]
|
|
# TcpListener fixture for the download resume tests (mirrors magnotia-llm).
|
|
# `macros` and `rt-multi-thread` enable #[tokio::test] and the multi-threaded
|
|
# scheduler used by the orchestrator tests.
|
|
tokio = { version = "1", features = ["rt", "rt-multi-thread", "sync", "net", "io-util", "macros"] }
|
|
tempfile = "3"
|
|
# Test-only — used by tests/thread_sweep.rs to label physical vs logical
|
|
# core counts in the scaling table. Production code uses the
|
|
# `magnotia_core::constants::inference_thread_count` helper instead.
|
|
num_cpus = "1"
|