Fabio
c36510c21e
Some checks failed
Linux Build / Linux cpu (push) Has been cancelled
Linux Build / Linux cpu-clang (push) Has been cancelled
Linux Build / Linux vulkan (push) Has been cancelled
mac-build / macOS CPU (push) Has been cancelled
Nix Build / Nix (cpu) (push) Has been cancelled
Nix Build / Nix (vulkan) (push) Has been cancelled
windows-build / Windows CPU (push) Has been cancelled
56 lines
2.4 KiB
C++
56 lines
2.4 KiB
C++
#pragma once
|
|
|
|
#include "engine/framework/runtime/session.h"
|
|
|
|
#include <cstddef>
|
|
#include <string_view>
|
|
|
|
namespace engine::runtime {
|
|
|
|
/// One task kind, with every name any layer accepts for it.
|
|
///
|
|
/// The canonical token is what the C ABI and the CLI take and what `to_string`
|
|
/// returns. The aliases are the spellings a model spec may use: the two
|
|
/// vocabularies differ for historical reasons (`gen` vs `music`/`sfx`/`edit`),
|
|
/// and this is the only place that difference is written down.
|
|
/// Every view here must refer to a string literal.
|
|
///
|
|
/// The C ABI hands `token.data()` straight to callers as a `const char *`, so a
|
|
/// view over anything that is not NUL-terminated and statically allocated would
|
|
/// return a pointer into a temporary or an unterminated buffer. That holds for
|
|
/// the table below; it is a constraint on anything added to it.
|
|
struct TaskVocabularyEntry {
|
|
VoiceTaskKind kind;
|
|
std::string_view token;
|
|
/// Spec-side spellings, `aliases[alias_count]` onwards unused.
|
|
std::string_view aliases[4];
|
|
std::size_t alias_count;
|
|
};
|
|
|
|
/// Every task kind this build knows, in enum order.
|
|
///
|
|
/// This is the single definition of the task vocabulary. `to_string`,
|
|
/// `parse_voice_task_kind`, the model-spec schema's allowed task set, the
|
|
/// model-spec parser and the C ABI's enumeration all read it, so they cannot
|
|
/// disagree with one another.
|
|
///
|
|
/// They used to. The schema accepted `codec`, which no parser mapped to a kind,
|
|
/// so `model_specs/miocodec.json` threw at load; the spec parser accepted
|
|
/// `audio_generation`, which the schema rejected, so a spec using it failed
|
|
/// validation instead; and `include/audiocpp.h` documented `"diarization"` and
|
|
/// `"alignment"`, which nothing accepts. Four hand-maintained lists of the same
|
|
/// fourteen things drift in four directions, and nothing was comparing them.
|
|
const TaskVocabularyEntry * task_vocabulary(std::size_t & count) noexcept;
|
|
|
|
/// The canonical token for a spec-side task name, or an empty view when the
|
|
/// name names no task kind.
|
|
///
|
|
/// `"music"` -> `"gen"`. Exposed because a caller that reads `model_specs/*.json`
|
|
/// -- a package browser, an installer, a binding building a picker before
|
|
/// anything is loaded -- needs the mapping and has no model to ask.
|
|
std::string_view task_token_for_spec_name(std::string_view spec_task) noexcept;
|
|
|
|
/// Whether a spec may declare this task name.
|
|
bool is_spec_task_name(std::string_view value) noexcept;
|
|
|
|
} // namespace engine::runtime
|