@getpaseo/server 0.1.2 → 0.1.4

package/dist/server/server/speech/speech-config-resolver.js

@@ -8,15 +8,34 @@ const OptionalSpeechProviderSchema = z
     .toLowerCase()
     .pipe(SpeechProviderIdSchema)
     .optional();
+const OptionalBooleanFlagSchema = z
+    .union([z.boolean(), z.string().trim().toLowerCase()])
+    .optional()
+    .transform((value) => {
+    if (typeof value === "boolean") {
+        return value;
+    }
+    if (value === undefined) {
+        return undefined;
+    }
+    if (["1", "true", "yes", "y", "on"].includes(value)) {
+        return true;
+    }
+    if (["0", "false", "no", "n", "off"].includes(value)) {
+        return false;
+    }
+    return undefined;
+});
 const RequestedSpeechProvidersSchema = z.object({
     dictationStt: OptionalSpeechProviderSchema.default("local"),
     voiceStt: OptionalSpeechProviderSchema.default("local"),
     voiceTts: OptionalSpeechProviderSchema.default("local"),
 });
 function resolveRequestedSpeechProviders(params) {
-    const resolveFeatureProvider = (configuredValue, parsedValue) => ({
+    const resolveFeatureProvider = (configuredValue, parsedValue, enabled) => ({
         provider: parsedValue,
         explicit: configuredValue !== undefined,
+        enabled,
     });
     const dictationSttProviderFromConfig = params.env.PASEO_DICTATION_STT_PROVIDER ??
         params.persisted.features?.dictation?.stt?.provider;
@@ -24,15 +43,17 @@ function resolveRequestedSpeechProviders(params) {
         params.persisted.features?.voiceMode?.stt?.provider;
     const voiceTtsProviderFromConfig = params.env.PASEO_VOICE_TTS_PROVIDER ??
         params.persisted.features?.voiceMode?.tts?.provider;
+    const dictationEnabled = OptionalBooleanFlagSchema.parse(params.env.PASEO_DICTATION_ENABLED ?? params.persisted.features?.dictation?.enabled) ?? true;
+    const voiceModeEnabled = OptionalBooleanFlagSchema.parse(params.env.PASEO_VOICE_MODE_ENABLED ?? params.persisted.features?.voiceMode?.enabled) ?? true;
     const parsed = RequestedSpeechProvidersSchema.parse({
         dictationStt: dictationSttProviderFromConfig ?? "local",
         voiceStt: voiceSttProviderFromConfig ?? "local",
         voiceTts: voiceTtsProviderFromConfig ?? "local",
     });
     return {
-        dictationStt: resolveFeatureProvider(dictationSttProviderFromConfig, parsed.dictationStt),
-        voiceStt: resolveFeatureProvider(voiceSttProviderFromConfig, parsed.voiceStt),
-        voiceTts: resolveFeatureProvider(voiceTtsProviderFromConfig, parsed.voiceTts),
+        dictationStt: resolveFeatureProvider(dictationSttProviderFromConfig, parsed.dictationStt, dictationEnabled),
+        voiceStt: resolveFeatureProvider(voiceSttProviderFromConfig, parsed.voiceStt, voiceModeEnabled),
+        voiceTts: resolveFeatureProvider(voiceTtsProviderFromConfig, parsed.voiceTts, voiceModeEnabled),
     };
 }
 export function resolveSpeechConfig(params) {

package/dist/server/server/speech/speech-config-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"speech-config-resolver.js","sourceRoot":"","sources":["../../../../src/server/speech/speech-config-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EACL,sBAAsB,GAGvB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,4BAA4B,GAAG,CAAC;KACnC,MAAM,EAAE;KACR,IAAI,EAAE;KACN,WAAW,EAAE;KACb,IAAI,CAAC,sBAAsB,CAAC;KAC5B,QAAQ,EAAE,CAAC;AAEd,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,YAAY,EAAE,4BAA4B,CAAC,OAAO,CAAC,OAAO,CAAC;IAC3D,QAAQ,EAAE,4BAA4B,CAAC,OAAO,CAAC,OAAO,CAAC;IACvD,QAAQ,EAAE,4BAA4B,CAAC,OAAO,CAAC,OAAO,CAAC;CACxD,CAAC,CAAC;AAEH,SAAS,+BAA+B,CAAC,MAGxC;IACC,MAAM,sBAAsB,GAAG,CAC7B,eAAmC,EACnC,WAAmD,EAC1B,EAAE,CAAC,CAAC;QAC7B,QAAQ,EAAE,WAAW;QACrB,QAAQ,EAAE,eAAe,KAAK,SAAS;KACxC,CAAC,CAAC;IAEH,MAAM,8BAA8B,GAClC,MAAM,CAAC,GAAG,CAAC,4BAA4B;QACvC,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,CAAC;IACtD,MAAM,0BAA0B,GAC9B,MAAM,CAAC,GAAG,CAAC,wBAAwB;QACnC,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,CAAC;IACtD,MAAM,0BAA0B,GAC9B,MAAM,CAAC,GAAG,CAAC,wBAAwB;QACnC,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,CAAC;IAEtD,MAAM,MAAM,GAAG,8BAA8B,CAAC,KAAK,CAAC;QAClD,YAAY,EAAE,8BAA8B,IAAI,OAAO;QACvD,QAAQ,EAAE,0BAA0B,IAAI,OAAO;QAC/C,QAAQ,EAAE,0BAA0B,IAAI,OAAO;KAChD,CAAC,CAAC;IAEH,OAAO;QACL,YAAY,EAAE,sBAAsB,CAClC,8BAA8B,EAC9B,MAAM,CAAC,YAAY,CACpB;QACD,QAAQ,EAAE,sBAAsB,CAC9B,0BAA0B,EAC1B,MAAM,CAAC,QAAQ,CAChB;QACD,QAAQ,EAAE,sBAAsB,CAC9B,0BAA0B,EAC1B,MAAM,CAAC,QAAQ,CAChB;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAInC;IAIC,MAAM,SAAS,GAAG,+BAA+B,CAAC;QAChD,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,wBAAwB,CAAC;QACrC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS;KACV,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,yBAAyB,CAAC;QACvC,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS;KACV,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,MAAM,EAAE;YACN,SAAS;YACT,GAAG,CAAC,KAAK,CAAC,KAAK;gBACb,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;gBACxB,CAAC,CAAC,EAAE,CAAC;SACR;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"speech-config-resolver.js","sourceRoot":"","sources":["../../../../src/server/speech/speech-config-resolver.ts"],"names":[],"mappings":"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"}

package/dist/server/server/speech/speech-runtime.d.ts

@@ -2,10 +2,33 @@ import type { Logger } from "pino";
 import type { PaseoOpenAIConfig, PaseoSpeechConfig } from "../bootstrap.js";
 import type { LocalSpeechModelId } from "./providers/local/config.js";
 import type { SpeechToTextProvider, TextToSpeechProvider } from "./speech-provider.js";
+export type SpeechReadinessReasonCode = "ready" | "disabled" | "model_download_in_progress" | "models_missing" | "model_download_failed" | "stt_unavailable" | "tts_unavailable";
+export type SpeechReadinessState = {
+    enabled: boolean;
+    available: boolean;
+    reasonCode: SpeechReadinessReasonCode;
+    message: string;
+    retryable: boolean;
+    missingModelIds: LocalSpeechModelId[];
+};
+export type SpeechReadinessSnapshot = {
+    generatedAt: string;
+    requiredLocalModelIds: LocalSpeechModelId[];
+    missingLocalModelIds: LocalSpeechModelId[];
+    download: {
+        inProgress: boolean;
+        error: string | null;
+    };
+    realtimeVoice: SpeechReadinessState;
+    dictation: SpeechReadinessState;
+    voiceFeature: SpeechReadinessState;
+};
 export type InitializedSpeechRuntime = {
-    sttService: SpeechToTextProvider | null;
-    ttsService: TextToSpeechProvider | null;
-    dictationSttService: SpeechToTextProvider | null;
+    resolveVoiceStt: () => SpeechToTextProvider | null;
+    resolveVoiceTts: () => TextToSpeechProvider | null;
+    resolveDictationStt: () => SpeechToTextProvider | null;
+    getSpeechReadiness: () => SpeechReadinessSnapshot;
+    subscribeSpeechReadiness: (listener: (snapshot: SpeechReadinessSnapshot) => void) => () => void;
     cleanup: () => void;
     localModelConfig: {
         modelsDir: string;

package/dist/server/server/speech/speech-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"speech-runtime.d.ts","sourceRoot":"","sources":["../../../../src/server/speech/speech-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAK5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAMtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAkBvF,MAAM,MAAM,wBAAwB,GAAG;IACrC,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACxC,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACxC,mBAAmB,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACjD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,gBAAgB,EAAE;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,kBAAkB,EAAE,CAAC;KACvC,GAAG,IAAI,CAAC;CACV,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA8HpC"}
+{"version":3,"file":"speech-runtime.d.ts","sourceRoot":"","sources":["../../../../src/server/speech/speech-runtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAYtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAKvF,MAAM,MAAM,yBAAyB,GACjC,OAAO,GACP,UAAU,GACV,4BAA4B,GAC5B,gBAAgB,GAChB,uBAAuB,GACvB,iBAAiB,GACjB,iBAAiB,CAAC;AAEtB,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,yBAAyB,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,kBAAkB,EAAE,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,kBAAkB,EAAE,CAAC;IAC5C,oBAAoB,EAAE,kBAAkB,EAAE,CAAC;IAC3C,QAAQ,EAAE;QACR,UAAU,EAAE,OAAO,CAAC;QACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACtB,CAAC;IACF,aAAa,EAAE,oBAAoB,CAAC;IACpC,SAAS,EAAE,oBAAoB,CAAC;IAChC,YAAY,EAAE,oBAAoB,CAAC;CACpC,CAAC;AA8PF,MAAM,MAAM,wBAAwB,GAAG;IACrC,eAAe,EAAE,MAAM,oBAAoB,GAAG,IAAI,CAAC;IACnD,eAAe,EAAE,MAAM,oBAAoB,GAAG,IAAI,CAAC;IACnD,mBAAmB,EAAE,MAAM,oBAAoB,GAAG,IAAI,CAAC;IACvD,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;IAClD,wBAAwB,EAAE,CACxB,QAAQ,EAAE,CAAC,QAAQ,EAAE,uBAAuB,KAAK,IAAI,KAClD,MAAM,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,gBAAgB,EAAE;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,kBAAkB,EAAE,CAAC;KACvC,GAAG,IAAI,CAAC;CACV,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA+UpC"}