tjbot-ce 3.0.1

package/dist/config/config-types.generated.d.ts

@@ -0,0 +1,495 @@
+/**
+ * Verbosity level for TJBot logging.
+ */
+export type LogLevel = ("error" | "warning" | "warn" | "info" | "verbose" | "debug" | "silly");
+/**
+ * Speech-to-text backend implementation.
+ */
+export type STTBackendType = ("none" | "local" | "ibm-watson-stt" | "google-cloud-stt" | "azure-stt");
+/**
+ * Vision backend implementation.
+ */
+export type SeeBackendType = ("none" | "local" | "google-cloud-vision" | "azure-vision");
+/**
+ * Text-to-speech backend implementation.
+ */
+export type TTSBackendType = ("none" | "local" | "ibm-watson-tts" | "google-cloud-tts" | "azure-tts");
+/**
+ * Kind of model entry being registered.
+ */
+export type ModelEntryType = ("stt" | "tts" | "vad" | "vision.object-recognition" | "vision.classification" | "vision.face-detection" | "vision.image-description");
+/**
+ * Settings for custom, on-device ML models.
+ */
+export type ModelsConfig = ModelEntry[];
+/**
+ * Canonical schema for TJBot runtime configuration.
+ */
+export interface TJBotConfigSchema {
+    log?: LogConfig;
+    hardware?: HardwareConfig;
+    listen?: ListenConfig;
+    see?: SeeConfig;
+    shine?: ShineConfig;
+    speak?: SpeakConfig;
+    wave?: WaveConfig;
+    models?: ModelsConfig;
+    /**
+     * Free-form recipe-level configuration merged after TJBot defaults and user config.
+     */
+    recipe?: {
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
+/**
+ * Console logging configuration.
+ */
+export interface LogConfig {
+    level?: LogLevel;
+    [k: string]: unknown;
+}
+/**
+ * Hardware physically attached to the Raspberry Pi.
+ */
+export interface HardwareConfig {
+    /**
+     * Set to true when a speaker is connected and should be initialized.
+     */
+    speaker?: boolean;
+    /**
+     * Set to true when a microphone is connected and should be initialized.
+     */
+    microphone?: boolean;
+    /**
+     * Set to true when TJBot should initialize an LED output.
+     */
+    led?: boolean;
+    /**
+     * Set to true when TJBot should initialize the arm servo.
+     */
+    servo?: boolean;
+    /**
+     * Set to true when a camera is attached and vision features should initialize.
+     */
+    camera?: boolean;
+    [k: string]: unknown;
+}
+/**
+ * Settings for audio capture and speech recognition.
+ */
+export interface ListenConfig {
+    /**
+     * ALSA capture device name. Empty uses the system default device.
+     */
+    device?: string;
+    /**
+     * Capture sample rate in hertz.
+     */
+    microphoneRate?: number;
+    /**
+     * Number of microphone input channels.
+     */
+    microphoneChannels?: number;
+    backend?: STTBackendConfig;
+    [k: string]: unknown;
+}
+/**
+ * Speech-to-text backend selection and backend-specific settings.
+ */
+export interface STTBackendConfig {
+    type: STTBackendType;
+    local?: STTBackendLocalConfig;
+    "ibm-watson-stt"?: STTBackendIBMWatsonConfig;
+    "google-cloud-stt"?: STTBackendGoogleCloudConfig;
+    "azure-stt"?: STTBackendAzureConfig;
+}
+/**
+ * Local speech-to-text backend configuration.
+ */
+export interface STTBackendLocalConfig {
+    /**
+     * Registry key of the local speech model.
+     */
+    model?: string;
+    vad?: VADConfig;
+    [k: string]: unknown;
+}
+/**
+ * Voice activity detection settings for local speech recognition.
+ */
+export interface VADConfig {
+    /**
+     * Enables the VAD model before local transcription.
+     */
+    enabled?: boolean;
+    /**
+     * Registry key of the VAD model to load.
+     */
+    model?: string;
+    [k: string]: unknown;
+}
+/**
+ * IBM Watson speech-to-text backend configuration.
+ */
+export interface STTBackendIBMWatsonConfig {
+    /**
+     * IBM Watson STT model identifier.
+     */
+    model?: string;
+    /**
+     * Seconds of silence before Watson closes the stream. Use -1 to disable.
+     */
+    inactivityTimeout?: number;
+    /**
+     * Background audio suppression factor.
+     */
+    backgroundAudioSuppression?: number;
+    /**
+     * Whether partial transcriptions should be emitted.
+     */
+    interimResults?: boolean;
+    /**
+     * Path to the IBM credentials file.
+     */
+    credentialsPath?: string;
+    [k: string]: unknown;
+}
+/**
+ * Google Cloud speech-to-text backend configuration.
+ */
+export interface STTBackendGoogleCloudConfig {
+    /**
+     * Path to the Google Cloud credentials file.
+     */
+    credentialsPath?: string;
+    /**
+     * Google Cloud STT model identifier.
+     */
+    model?: string;
+    /**
+     * BCP-47 language code for transcription.
+     */
+    languageCode?: string;
+    /**
+     * Google Cloud region to target.
+     */
+    region?: string;
+    /**
+     * Enables automatic punctuation in transcripts.
+     */
+    enableAutomaticPunctuation?: boolean;
+    /**
+     * Masks profane words in transcripts.
+     */
+    profanityFilter?: boolean;
+    /**
+     * Whether partial transcriptions should be emitted.
+     */
+    interimResults?: boolean;
+    [k: string]: unknown;
+}
+/**
+ * Azure speech-to-text backend configuration.
+ */
+export interface STTBackendAzureConfig {
+    /**
+     * Azure speech recognition language. Empty uses the service default.
+     */
+    language?: string;
+    /**
+     * Path to the Azure credentials file.
+     */
+    credentialsPath?: string;
+    /**
+     * Whether partial transcriptions should be emitted.
+     */
+    interimResults?: boolean;
+    [k: string]: unknown;
+}
+/**
+ * Settings for the camera and computer vision.
+ */
+export interface SeeConfig {
+    /**
+     * Requested capture resolution as [width, height].
+     *
+    
+     */
+    cameraResolution?: [number, number];
+    /**
+     * Flips captured frames vertically.
+     */
+    verticalFlip?: boolean;
+    /**
+     * Flips captured frames horizontally.
+     */
+    horizontalFlip?: boolean;
+    /**
+     * Camera capture timeout in milliseconds.
+     */
+    captureTimeout?: number;
+    /**
+     * Enables zero-shutter-lag capture when supported.
+     */
+    zeroShutterLag?: boolean;
+    backend?: SeeBackendConfig;
+    [k: string]: unknown;
+}
+/**
+ * Vision backend selection and backend-specific settings.
+ */
+export interface SeeBackendConfig {
+    type: SeeBackendType;
+    local?: SeeBackendLocalConfig;
+    "google-cloud-vision"?: SeeBackendGoogleCloudConfig;
+    "azure-vision"?: SeeBackendAzureConfig;
+}
+/**
+ * Local ONNX-based vision backend configuration.
+ */
+export interface SeeBackendLocalConfig {
+    /**
+     * Registry key of the local object detection model.
+     */
+    objectDetectionModel?: string;
+    /**
+     * Registry key of the local image classification model.
+     */
+    imageClassificationModel?: string;
+    /**
+     * Registry key of the local face detection model.
+     */
+    faceDetectionModel?: string;
+    /**
+     * Minimum confidence for object detection results.
+     */
+    objectDetectionConfidence?: number;
+    /**
+     * Minimum confidence for image classification results.
+     */
+    imageClassificationConfidence?: number;
+    /**
+     * Minimum confidence for face detection results.
+     */
+    faceDetectionConfidence?: number;
+    [k: string]: unknown;
+}
+/**
+ * Google Cloud Vision backend configuration.
+ */
+export interface SeeBackendGoogleCloudConfig {
+    /**
+     * Path to the Google Cloud credentials file.
+     */
+    credentialsPath?: string;
+    /**
+     * Minimum confidence for object localization results.
+     */
+    objectDetectionConfidence?: number;
+    /**
+     * Minimum confidence for label detection results.
+     */
+    imageClassificationConfidence?: number;
+    /**
+     * Minimum confidence for face detection results.
+     */
+    faceDetectionConfidence?: number;
+    [k: string]: unknown;
+}
+/**
+ * Azure Vision backend configuration.
+ */
+export interface SeeBackendAzureConfig {
+    /**
+     * Path to the Azure credentials file.
+     */
+    credentialsPath?: string;
+    /**
+     * Minimum confidence for object detection results.
+     */
+    objectDetectionConfidence?: number;
+    /**
+     * Minimum confidence for image classification results.
+     */
+    imageClassificationConfidence?: number;
+    [k: string]: unknown;
+}
+/**
+ * Settings for LED hardware.
+ */
+export interface ShineConfig {
+    /**
+     * Enables NeoPixel / WS281x LED support.
+     */
+    hasNeopixelLED?: boolean;
+    /**
+     * Enables common-anode RGB LED support.
+     */
+    hasCommonAnodeLED?: boolean;
+    neopixel?: LEDNeopixelConfig;
+    commonanode?: LEDCommonAnodeConfig;
+    [k: string]: unknown;
+}
+/**
+ * WS281x / NeoPixel LED configuration.
+ */
+export interface LEDNeopixelConfig {
+    /**
+     * GPIO pin number used for the LED data signal.
+     */
+    gpioPin?: number;
+    /**
+     * SPI interface path used when driving LEDs over SPI.
+     */
+    spiInterface?: string;
+    /**
+     * Whether the LED expects GRB byte ordering.
+     */
+    useGRBFormat?: boolean;
+    [k: string]: unknown;
+}
+/**
+ * Common-anode RGB LED configuration.
+ */
+export interface LEDCommonAnodeConfig {
+    /**
+     * GPIO pin for the red channel.
+     */
+    redPin?: number;
+    /**
+     * GPIO pin for the green channel.
+     */
+    greenPin?: number;
+    /**
+     * GPIO pin for the blue channel.
+     */
+    bluePin?: number;
+    [k: string]: unknown;
+}
+/**
+ * Settings for audio playback and text-to-speech.
+ */
+export interface SpeakConfig {
+    /**
+     * ALSA playback device name. Empty uses the system default device.
+     */
+    device?: string;
+    backend?: TTSBackendConfig;
+    [k: string]: unknown;
+}
+/**
+ * Text-to-speech backend selection and backend-specific settings.
+ */
+export interface TTSBackendConfig {
+    type: TTSBackendType;
+    local?: TTSBackendLocalConfig;
+    "ibm-watson-tts"?: TTSBackendIBMWatsonConfig;
+    "google-cloud-tts"?: TTSBackendGoogleCloudConfig;
+    "azure-tts"?: TTSBackendAzureConfig;
+}
+/**
+ * Local text-to-speech backend configuration.
+ */
+export interface TTSBackendLocalConfig {
+    /**
+     * Registry key of the local voice model.
+     */
+    model?: string;
+    [k: string]: unknown;
+}
+/**
+ * IBM Watson text-to-speech backend configuration.
+ */
+export interface TTSBackendIBMWatsonConfig {
+    /**
+     * Path to the IBM credentials file.
+     */
+    credentialsPath?: string;
+    /**
+     * IBM Watson voice identifier.
+     */
+    voice?: string;
+    [k: string]: unknown;
+}
+/**
+ * Google Cloud text-to-speech backend configuration.
+ */
+export interface TTSBackendGoogleCloudConfig {
+    /**
+     * Path to the Google Cloud credentials file.
+     */
+    credentialsPath?: string;
+    /**
+     * BCP-47 language code for synthesis.
+     */
+    languageCode?: string;
+    /**
+     * Google Cloud voice identifier.
+     */
+    voice?: string;
+    [k: string]: unknown;
+}
+/**
+ * Azure text-to-speech backend configuration.
+ */
+export interface TTSBackendAzureConfig {
+    /**
+     * Path to the Azure credentials file.
+     */
+    credentialsPath?: string;
+    /**
+     * Azure voice identifier.
+     */
+    voice?: string;
+    [k: string]: unknown;
+}
+/**
+ * Settings for servo hardware.
+ */
+export interface WaveConfig {
+    /**
+     * GPIO pin number connected to the servo PWM input.
+     */
+    servoPin?: number;
+    [k: string]: unknown;
+}
+/**
+ * Custom model registry entry.
+ */
+export interface ModelEntry {
+    type: ModelEntryType;
+    /**
+     * Unique key used to reference the model in config.
+     */
+    key: string;
+    /**
+     * Human-readable model name.
+     */
+    label: string;
+    /**
+     * URL or file URI where the model archive can be retrieved.
+     */
+    url: string;
+    /**
+     * Folder name to use after extracting the model.
+     */
+    folder?: string;
+    /**
+     * Model subtype used by the vision runtime.
+     */
+    kind?: string;
+    /**
+     * Optional tensor input shape for ONNX vision models.
+     */
+    inputShape?: number[];
+    /**
+     * URL or file URI for a companion labels file.
+     */
+    labelUrl?: string;
+    /**
+     * Files that must exist after the model is installed.
+     */
+    required?: string[];
+}
+//# sourceMappingURL=config-types.generated.d.ts.map

package/dist/config/config-types.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-types.generated.d.ts","sourceRoot":"","sources":["../../src/config/config-types.generated.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC,CAAA;AAC9F;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,GAAG,OAAO,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,WAAW,CAAC,CAAA;AACrG;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,GAAG,OAAO,GAAG,qBAAqB,GAAG,cAAc,CAAC,CAAA;AACxF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,GAAG,OAAO,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,WAAW,CAAC,CAAA;AACrG;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,2BAA2B,GAAG,uBAAuB,GAAG,uBAAuB,GAAG,0BAA0B,CAAC,CAAA;AACnK;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,EAAE,CAAA;AAEvC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAClC,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB;;OAEG;IACH,MAAM,CAAC,EAAE;QACT,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KACnB,CAAA;IACD,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,SAAS;IAC1B,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC/B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAA;IACb;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IACjC,IAAI,EAAE,cAAc,CAAA;IACpB,KAAK,CAAC,EAAE,qBAAqB,CAAA;IAC7B,gBAAgB,CAAC,EAAE,yBAAyB,CAAA;IAC5C,kBAAkB,CAAC,EAAE,2BAA2B,CAAA;IAChD,WAAW,CAAC,EAAE,qBAAqB,CAAA;CAClC;AACD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACtC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,SAAS;IAC1B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IAC1C;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B;;OAEG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAA;IACnC;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC5C;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAA;IACpC;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACtC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,SAAS;IAC1B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IACjC,IAAI,EAAE,cAAc,CAAA;IACpB,KAAK,CAAC,EAAE,qBAAqB,CAAA;IAC7B,qBAAqB,CAAC,EAAE,2BAA2B,CAAA;IACnD,cAAc,CAAC,EAAE,qBAAqB,CAAA;CACrC;AACD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACtC;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B;;OAEG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B;;OAEG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAA;IAClC;;OAEG;IACH,6BAA6B,CAAC,EAAE,MAAM,CAAA;IACtC;;OAEG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC5C;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;OAEG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAA;IAClC;;OAEG;IACH,6BAA6B,CAAC,EAAE,MAAM,CAAA;IACtC;;OAEG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACtC;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;OAEG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAA;IAClC;;OAEG;IACH,6BAA6B,CAAC,EAAE,MAAM,CAAA;IACtC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC5B;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,WAAW,CAAC,EAAE,oBAAoB,CAAA;IAClC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAClC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACrC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC5B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IACjC,IAAI,EAAE,cAAc,CAAA;IACpB,KAAK,CAAC,EAAE,qBAAqB,CAAA;IAC7B,gBAAgB,CAAC,EAAE,yBAAyB,CAAA;IAC5C,kBAAkB,CAAC,EAAE,2BAA2B,CAAA;IAChD,WAAW,CAAC,EAAE,qBAAqB,CAAA;CAClC;AACD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACtC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IAC1C;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC5C;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACtC;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,UAAU;IAC3B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACnB;AACD;;GAEG;AACH,MAAM,WAAW,UAAU;IAC3B,IAAI,EAAE,cAAc,CAAA;IACpB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAA;IACX;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,GAAG,EAAE,MAAM,CAAA;IACX;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB"}

package/dist/config/config-types.generated.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config-types.generated.js.map

package/dist/config/config-types.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-types.generated.js","sourceRoot":"","sources":["../../src/config/config-types.generated.ts"],"names":[],"mappings":""}

package/dist/config/config-types.js

@@ -0,0 +1,175 @@
+/**
+ * Copyright 2025 IBM Corp. All Rights Reserved.
+ * Copyright 2026-present TJBot Contributors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import fs from 'fs';
+import { createRequire } from 'module';
+import yaml from 'js-yaml';
+export const STT_BACKEND_TYPES = Object.freeze([
+    'none',
+    'local',
+    'ibm-watson-stt',
+    'google-cloud-stt',
+    'azure-stt',
+]);
+export const TTS_BACKEND_TYPES = Object.freeze([
+    'none',
+    'local',
+    'ibm-watson-tts',
+    'google-cloud-tts',
+    'azure-tts',
+]);
+export const SEE_BACKEND_TYPES = Object.freeze([
+    'none',
+    'local',
+    'google-cloud-vision',
+    'azure-vision',
+]);
+function loadConfigSchema() {
+    const schemaUrl = new URL('./vendor/tjbot-config.schema.yaml', import.meta.url);
+    const schemaSource = fs.readFileSync(schemaUrl, 'utf8');
+    const loadedSchema = yaml.load(schemaSource);
+    if (!loadedSchema || typeof loadedSchema !== 'object' || Array.isArray(loadedSchema)) {
+        throw new Error('TJBot config schema is invalid or empty');
+    }
+    return loadedSchema;
+}
+const configSchema = loadConfigSchema();
+const require = createRequire(import.meta.url);
+const Ajv = require('ajv').default;
+const addFormats = require('ajv-formats').default;
+const ajv = new Ajv({
+    allErrors: true,
+    allowUnionTypes: true,
+    strict: false,
+});
+addFormats(ajv);
+const compiledTJBotConfigValidator = ajv.compile(configSchema);
+function formatValidationErrors(errors) {
+    return ajv.errorsText(errors, { separator: '; ' });
+}
+function createEnumParser(values, label) {
+    return {
+        parse(value) {
+            const result = this.safeParse(value);
+            if (!result.success) {
+                throw result.error;
+            }
+            return result.data;
+        },
+        safeParse(value) {
+            if (typeof value === 'string' && values.includes(value)) {
+                return { success: true, data: value };
+            }
+            return {
+                success: false,
+                error: new Error(`Invalid ${label}. Expected one of: ${values.join(', ')}`),
+            };
+        },
+    };
+}
+function createValidatorParser(validate, label) {
+    return {
+        parse(value) {
+            const result = this.safeParse(value);
+            if (!result.success) {
+                throw result.error;
+            }
+            return result.data;
+        },
+        safeParse(value) {
+            if (validate(value)) {
+                return { success: true, data: value };
+            }
+            return {
+                success: false,
+                error: new Error(`Invalid ${label}: ${formatValidationErrors(validate.errors)}`),
+            };
+        },
+    };
+}
+export function getConfigSchema() {
+    return configSchema;
+}
+export function isSTTBackendType(value) {
+    return typeof value === 'string' && STT_BACKEND_TYPES.includes(value);
+}
+export function isTTSBackendType(value) {
+    return typeof value === 'string' && TTS_BACKEND_TYPES.includes(value);
+}
+export function isSeeBackendType(value) {
+    return typeof value === 'string' && SEE_BACKEND_TYPES.includes(value);
+}
+export const sttBackendTypeSchema = createEnumParser(STT_BACKEND_TYPES, 'STT backend type');
+export const ttsBackendTypeSchema = createEnumParser(TTS_BACKEND_TYPES, 'TTS backend type');
+export const seeBackendTypeSchema = createEnumParser(SEE_BACKEND_TYPES, 'vision backend type');
+export const tjbotConfigSchema = createValidatorParser(compiledTJBotConfigValidator, 'TJBot configuration');
+export const validateTJBotConfig = compiledTJBotConfigValidator;
+export function getSTTBackendConfig(backendConfig, backendType) {
+    if (!backendConfig) {
+        return {};
+    }
+    switch (backendType) {
+        case 'none':
+            return {};
+        case 'local':
+            return (backendConfig.local ?? {});
+        case 'ibm-watson-stt':
+            return (backendConfig['ibm-watson-stt'] ?? {});
+        case 'google-cloud-stt':
+            return (backendConfig['google-cloud-stt'] ?? {});
+        case 'azure-stt':
+            return (backendConfig['azure-stt'] ?? {});
+        default:
+            return {};
+    }
+}
+export function getTTSBackendConfig(backendConfig, backendType) {
+    if (!backendConfig) {
+        return {};
+    }
+    switch (backendType) {
+        case 'none':
+            return {};
+        case 'local':
+            return (backendConfig.local ?? {});
+        case 'ibm-watson-tts':
+            return (backendConfig['ibm-watson-tts'] ?? {});
+        case 'google-cloud-tts':
+            return (backendConfig['google-cloud-tts'] ?? {});
+        case 'azure-tts':
+            return (backendConfig['azure-tts'] ?? {});
+        default:
+            return {};
+    }
+}
+export function getSeeBackendConfig(backendConfig, backendType) {
+    if (!backendConfig) {
+        return {};
+    }
+    switch (backendType) {
+        case 'none':
+            return {};
+        case 'local':
+            return (backendConfig.local ?? {});
+        case 'google-cloud-vision':
+            return (backendConfig['google-cloud-vision'] ?? {});
+        case 'azure-vision':
+            return (backendConfig['azure-vision'] ?? {});
+        default:
+            return {};
+    }
+}
+//# sourceMappingURL=config-types.js.map

package/dist/config/config-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-types.js","sourceRoot":"","sources":["../../src/config/config-types.ts"],"names":[],"mappings":"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"}