@hyperdreamer/pi-webui 1.13.0 → 1.14.0

package/dist/server/speechInput/speechInputSettingsService.js.map

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

package/dist/server/speechInput/speechInputTranscriptionRoutes.js

@@ -0,0 +1,226 @@
+import { PiWebUiConfigMutationBusyError } from "../../configMutationCoordinator.js";
+import { SPEECH_INPUT_MAX_AUDIO_BYTES, SPEECH_INPUT_MAX_TRANSCRIPT_BYTES, SPEECH_INPUT_UPLOAD_TIMEOUT_MS, parseSpeechInputAudioMimeType, } from "../../shared/speechInputAudio.js";
+import { SpeechInputProviderError, SpeechInputProviderTimeoutError, } from "./openAiCompatibleTranscriptionProvider.js";
+import { SpeechInputAudioValidationError, SpeechInputCredentialUnavailableError, } from "./speechTranscriptionService.js";
+const TRANSCRIBE_PATH = "/api/speech-input/transcribe";
+const ADMISSION_REJECTED_MESSAGE = "Speech transcription is busy. Try again.";
+const INVALID_AUDIO_MESSAGE = "Invalid speech audio.";
+const CONFIG_BUSY_MESSAGE = "PI WEBUI config is busy. Try again.";
+const CREDENTIAL_UNAVAILABLE_MESSAGE = "Speech transcription is unavailable.";
+const PROVIDER_FAILURE_MESSAGE = "Speech transcription provider request failed.";
+const PROVIDER_TIMEOUT_MESSAGE = "Speech transcription provider timed out.";
+const UNEXPECTED_FAILURE_MESSAGE = "Speech transcription failed.";
+/**
+ * Registers a gateway-only raw-audio endpoint in an encapsulated plugin. Its
+ * parsers intentionally do not escape into general API route ownership.
+ */
+export function registerSpeechInputTranscriptionRoutes(app, service, options = {}) {
+    const bodyLimit = options.bodyLimit ?? SPEECH_INPUT_MAX_AUDIO_BYTES;
+    const admission = createAdmission(options.admissionLimit ?? 2);
+    const scheduleDeadline = options.scheduleDeadline ?? defaultScheduleDeadline;
+    const active = new WeakMap();
+    const activeRequests = new Set();
+    app.register((scope, _pluginOptions, done) => {
+        registerAudioBufferParsers(scope);
+        const cleanup = (request) => {
+            const state = active.get(request);
+            if (state === undefined || state.cleaned)
+                return;
+            state.cleaned = true;
+            active.delete(request);
+            activeRequests.delete(request);
+            try {
+                state.cancelUploadDeadline();
+            }
+            catch {
+                // Cleanup has already taken ownership of this request.
+            }
+            state.rawRequest.removeListener("end", state.onEnd);
+            state.rawRequest.removeListener("aborted", state.onAborted);
+            state.reply.raw.removeListener("close", state.onClose);
+            try {
+                state.controller.abort();
+            }
+            catch {
+                // Abort is best effort after this request's terminal state is fixed.
+            }
+            state.releaseAdmission();
+        };
+        scope.addHook("onRequest", (request, reply, hookDone) => {
+            const releaseAdmission = admission.acquire();
+            if (releaseAdmission === undefined) {
+                reply.code(429).send({ error: ADMISSION_REJECTED_MESSAGE });
+                hookDone();
+                return;
+            }
+            const controller = new AbortController();
+            const scheduledDeadline = { cancel: () => undefined };
+            const state = {
+                controller,
+                releaseAdmission,
+                cancelUploadDeadline: () => undefined,
+                rawRequest: request.raw,
+                reply,
+                onEnd: () => undefined,
+                onAborted: () => undefined,
+                onClose: () => undefined,
+                cleaned: false,
+            };
+            let uploadDeadlineCancelled = false;
+            state.cancelUploadDeadline = () => {
+                if (uploadDeadlineCancelled)
+                    return;
+                uploadDeadlineCancelled = true;
+                scheduledDeadline.cancel();
+            };
+            state.onEnd = () => {
+                // This timer covers admission through body completion only. Provider
+                // work remains admitted after the upload finishes.
+                try {
+                    state.cancelUploadDeadline();
+                }
+                catch {
+                    // A callback already owns terminal cleanup.
+                }
+            };
+            state.onAborted = () => {
+                cleanup(request);
+            };
+            state.onClose = () => {
+                // ServerResponse also closes after a successful response. Only a
+                // still-writable response means the client actually disconnected.
+                if (reply.raw.writableEnded)
+                    return;
+                cleanup(request);
+            };
+            active.set(request, state);
+            activeRequests.add(request);
+            request.raw.once("end", state.onEnd);
+            request.raw.once("aborted", state.onAborted);
+            reply.raw.once("close", state.onClose);
+            scheduledDeadline.cancel = scheduleDeadline(() => {
+                if (uploadDeadlineCancelled)
+                    return;
+                cleanup(request);
+                if (!request.raw.destroyed) {
+                    try {
+                        request.raw.destroy();
+                    }
+                    catch {
+                        // A concurrently closed socket has the same terminal result.
+                    }
+                }
+            }, SPEECH_INPUT_UPLOAD_TIMEOUT_MS);
+            if (request.raw.destroyed)
+                cleanup(request);
+            hookDone();
+        });
+        scope.addHook("onError", (request, _reply, _error, hookDone) => {
+            cleanup(request);
+            hookDone();
+        });
+        scope.addHook("onResponse", (request, _reply, hookDone) => {
+            cleanup(request);
+            hookDone();
+        });
+        scope.addHook("onClose", (_instance, hookDone) => {
+            for (const request of activeRequests)
+                cleanup(request);
+            hookDone();
+        });
+        scope.post(TRANSCRIBE_PATH, { bodyLimit }, async (request, reply) => {
+            const state = active.get(request);
+            if (state === undefined || isAborted(state.controller.signal))
+                return undefined;
+            const mimeType = parseSpeechInputAudioMimeType(contentTypeHeader(request));
+            if (mimeType === undefined || !Buffer.isBuffer(request.body) || request.body.byteLength === 0) {
+                return reply.code(400).send({ error: INVALID_AUDIO_MESSAGE });
+            }
+            try {
+                const text = await service.transcribe({
+                    audio: request.body,
+                    mimeType,
+                    signal: state.controller.signal,
+                });
+                if (isAborted(state.controller.signal))
+                    return undefined;
+                if (!isValidTranscript(text))
+                    return await reply.code(500).send({ error: UNEXPECTED_FAILURE_MESSAGE });
+                return { text };
+            }
+            catch (error) {
+                if (isAborted(state.controller.signal))
+                    return undefined;
+                return await mapTranscriptionError(reply, error);
+            }
+        });
+        done();
+    });
+}
+function registerAudioBufferParsers(app) {
+    const parser = (_request, body, done) => {
+        done(null, body);
+    };
+    // Exact codecs retain Fastify's normal exact-match precedence. Base media
+    // parsers then admit header spelling variants so the strict shared parser can
+    // make the allowlist decision from the original header value.
+    app.addContentTypeParser("audio/webm;codecs=opus", { parseAs: "buffer" }, parser);
+    app.addContentTypeParser("audio/ogg;codecs=opus", { parseAs: "buffer" }, parser);
+    app.addContentTypeParser("audio/mp4;codecs=mp4a.40.2", { parseAs: "buffer" }, parser);
+    app.addContentTypeParser("audio/webm", { parseAs: "buffer" }, parser);
+    app.addContentTypeParser("audio/ogg", { parseAs: "buffer" }, parser);
+    app.addContentTypeParser("audio/mp4", { parseAs: "buffer" }, parser);
+    app.addContentTypeParser("*", { parseAs: "buffer" }, parser);
+}
+function contentTypeHeader(request) {
+    const value = request.headers["content-type"];
+    return typeof value === "string" ? value : undefined;
+}
+function isValidTranscript(value) {
+    return typeof value === "string"
+        && value.trim() !== ""
+        && Buffer.byteLength(value, "utf8") <= SPEECH_INPUT_MAX_TRANSCRIPT_BYTES;
+}
+function isAborted(signal) {
+    return signal.aborted;
+}
+function mapTranscriptionError(reply, error) {
+    if (error instanceof SpeechInputAudioValidationError) {
+        return reply.code(400).send({ error: INVALID_AUDIO_MESSAGE });
+    }
+    if (error instanceof PiWebUiConfigMutationBusyError) {
+        return reply.code(503).send({ error: CONFIG_BUSY_MESSAGE });
+    }
+    if (error instanceof SpeechInputCredentialUnavailableError) {
+        return reply.code(503).send({ error: CREDENTIAL_UNAVAILABLE_MESSAGE });
+    }
+    if (error instanceof SpeechInputProviderTimeoutError) {
+        return reply.code(504).send({ error: PROVIDER_TIMEOUT_MESSAGE });
+    }
+    if (error instanceof SpeechInputProviderError) {
+        return reply.code(502).send({ error: PROVIDER_FAILURE_MESSAGE });
+    }
+    return reply.code(500).send({ error: UNEXPECTED_FAILURE_MESSAGE });
+}
+function createAdmission(limit) {
+    let active = 0;
+    return {
+        acquire() {
+            if (active >= limit)
+                return undefined;
+            active += 1;
+            let released = false;
+            return () => {
+                if (released)
+                    return;
+                released = true;
+                active -= 1;
+            };
+        },
+    };
+}
+function defaultScheduleDeadline(callback, delayMs) {
+    const timer = setTimeout(callback, delayMs);
+    return () => { clearTimeout(timer); };
+}
+//# sourceMappingURL=speechInputTranscriptionRoutes.js.map

package/dist/server/speechInput/speechInputTranscriptionRoutes.js.map

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

package/dist/server/speechInput/speechTranscriptionService.js

@@ -0,0 +1,116 @@
+import { effectiveSpeechInputSettings, speechInputCloudLanguage } from "../../shared/speechInput.js";
+import { SPEECH_INPUT_MAX_AUDIO_BYTES, parseSpeechInputAudioMimeType, } from "../../shared/speechInputAudio.js";
+import { resolvePiCompatibleCredentialSource } from "./piCompatibleCredentialResolver.js";
+import { OpenAiCompatibleTranscriptionProvider, SpeechInputTranscriptionAbortedError, } from "./openAiCompatibleTranscriptionProvider.js";
+/** A malformed direct service call; routes validate this before service work. */
+export class SpeechInputAudioValidationError extends Error {
+    constructor() {
+        super("Speech audio is invalid.");
+        this.code = "SPEECH_INPUT_AUDIO_VALIDATION";
+        this.name = "SpeechInputAudioValidationError";
+    }
+}
+/** A missing, unresolved, empty, or failed credential source. */
+export class SpeechInputCredentialUnavailableError extends Error {
+    constructor() {
+        super("Speech transcription is unavailable.");
+        this.code = "SPEECH_INPUT_CREDENTIAL_UNAVAILABLE";
+        this.name = "SpeechInputCredentialUnavailableError";
+    }
+}
+export class SpeechTranscriptionService {
+    constructor(dependencies) {
+        this.dependencies = dependencies;
+        this.provider = dependencies.provider ?? new OpenAiCompatibleTranscriptionProvider();
+        this.resolveCredential = dependencies.resolveCredential ?? resolvePiCompatibleCredentialSource;
+    }
+    async transcribe(request) {
+        throwIfAborted(request.signal);
+        // `read` opens and closes its own coordinator transaction before resolving.
+        // Copy every persisted value needed below before any potentially slow work.
+        const snapshot = await raceWithAbort(this.dependencies.coordinator.read(), request.signal);
+        const rawSource = snapshot.loaded.config.speechInput?.cloud?.apiKey;
+        const effective = effectiveSpeechInputSettings(snapshot.loaded.config.speechInput);
+        const captured = {
+            source: rawSource,
+            baseUrl: effective.cloud.baseUrl,
+            model: effective.cloud.model,
+            language: speechInputCloudLanguage(effective.language),
+        };
+        validateAudio(request);
+        if (captured.source === undefined || captured.source.trim() === "") {
+            throw new SpeechInputCredentialUnavailableError();
+        }
+        let apiKey;
+        try {
+            apiKey = await raceWithAbort(this.resolveCredential(captured.source, {
+                ...(this.dependencies.env === undefined ? {} : { env: this.dependencies.env }),
+                signal: request.signal,
+            }), request.signal);
+        }
+        catch (error) {
+            if (error instanceof SpeechInputTranscriptionAbortedError)
+                throw error;
+            if (request.signal.aborted)
+                throw new SpeechInputTranscriptionAbortedError();
+            throw new SpeechInputCredentialUnavailableError();
+        }
+        if (apiKey.trim() === "")
+            throw new SpeechInputCredentialUnavailableError();
+        throwIfAborted(request.signal);
+        const providerRequest = {
+            audio: request.audio,
+            mimeType: request.mimeType,
+            baseUrl: captured.baseUrl,
+            model: captured.model,
+            apiKey,
+            ...(captured.language === undefined ? {} : { language: captured.language }),
+            signal: request.signal,
+        };
+        return await raceWithAbort(this.provider.transcribe(providerRequest), request.signal);
+    }
+}
+export function createSpeechTranscriptionService(dependencies) {
+    return new SpeechTranscriptionService(dependencies);
+}
+function validateAudio(request) {
+    if (!Buffer.isBuffer(request.audio)
+        || request.audio.byteLength === 0
+        || request.audio.byteLength > SPEECH_INPUT_MAX_AUDIO_BYTES
+        || parseSpeechInputAudioMimeType(request.mimeType) !== request.mimeType) {
+        throw new SpeechInputAudioValidationError();
+    }
+}
+function throwIfAborted(signal) {
+    if (signal.aborted)
+        throw new SpeechInputTranscriptionAbortedError();
+}
+function raceWithAbort(promise, signal) {
+    if (signal.aborted)
+        return Promise.reject(new SpeechInputTranscriptionAbortedError());
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const settle = (callback, value) => {
+            if (settled)
+                return;
+            settled = true;
+            signal.removeEventListener("abort", onAbort);
+            callback(value);
+        };
+        const fail = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            signal.removeEventListener("abort", onAbort);
+            reject(error instanceof Error ? error : new Error("Speech transcription failed."));
+        };
+        const onAbort = () => {
+            fail(new SpeechInputTranscriptionAbortedError());
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+        Promise.resolve(promise).then((value) => { settle(resolve, value); }, (error) => { fail(error); });
+        if (signal.aborted)
+            onAbort();
+    });
+}
+//# sourceMappingURL=speechTranscriptionService.js.map

package/dist/server/speechInput/speechTranscriptionService.js.map

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

package/dist/shared/apiTypes.d.ts

@@ -202,6 +202,58 @@ export interface PiWebUiTtsConfig {
     voice?: string;
     rate?: number;
 }
+export type SpeechInputProviderPreference = "auto" | "browser" | "cloud";
+export interface PiWebUiSpeechInputCloudConfig {
+    /** HTTPS OpenAI-compatible transcription base URL. */
+    baseUrl?: string;
+    /** Transcription model name. */
+    model?: string;
+    /** Pi-compatible literal, environment template, or command credential source. */
+    apiKey?: string;
+}
+export interface PiWebUiSpeechInputConfig {
+    /** Default: "auto". */
+    provider?: SpeechInputProviderPreference;
+    /** Omitted means Auto. Stored as a canonical BCP 47 tag. */
+    language?: string;
+    cloud?: PiWebUiSpeechInputCloudConfig;
+}
+export interface SpeechInputCredentialStatus {
+    configured: boolean;
+    source?: "literal" | "environment" | "command";
+    resolution: "missing" | "resolved" | "unresolved" | "unchecked";
+}
+export interface SpeechInputSettings {
+    provider: SpeechInputProviderPreference;
+    language?: string;
+    cloud: {
+        baseUrl: string;
+        model: string;
+    };
+}
+export interface SpeechInputSettingsResponse {
+    contractVersion: 1;
+    /** Canonical lowercase UUID; opaque to clients. */
+    revision: string;
+    settings: SpeechInputSettings;
+    credential: SpeechInputCredentialStatus;
+}
+export type SpeechInputCredentialMutation = {
+    action: "preserve";
+} | {
+    action: "replace";
+    value: string;
+} | {
+    action: "clear";
+};
+export interface SpeechInputSettingsUpdate {
+    expectedRevision: string;
+    settings: SpeechInputSettings;
+    credential: SpeechInputCredentialMutation;
+}
+export interface SpeechInputTranscribeResponse {
+    text: string;
+}
 export interface HostSpeechVoice {
     name: string;
     language: string;
@@ -255,6 +307,8 @@ export interface PiWebUiConfigValues {
     agent?: PiWebUiAgentConfig;
     /** Host speech configuration for manual text-to-speech playback. */
     tts?: PiWebUiTtsConfig;
+    /** Gateway speech-input settings; the credential source is write-only at the browser boundary. */
+    speechInput?: PiWebUiSpeechInputConfig;
 }
 export type PiWebUiPluginScope = "bundled" | "local" | "user" | "project";
 export interface PiWebUiPluginInfo {

package/dist/shared/apiTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"apiTypes.js","sourceRoot":"","sources":["../../src/shared/apiTypes.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,sBAAsB,EAAE,yBAAyB;IACjD,qBAAqB,EAAE,wBAAwB;IAC/C,eAAe,EAAE,kBAAkB;IACnC,cAAc,EAAE,iBAAiB;IACjC,kBAAkB,EAAE,qBAAqB;IACzC,sBAAsB,EAAE,yBAAyB;IACjD,oBAAoB,EAAE,uBAAuB;IAC7C,sBAAsB,EAAE,yBAAyB;IACjD,qBAAqB,EAAE,wBAAwB;IAC/C,cAAc,EAAE,iBAAiB;IACjC,iBAAiB,EAAE,oBAAoB;IACvC,wBAAwB,EAAE,2BAA2B;IACrD,gBAAgB,EAAE,mBAAmB;IACrC,uBAAuB,EAAE,0BAA0B;IACnD,kBAAkB,EAAE,uBAAuB;IAC3C,iBAAiB,EAAE,qBAAqB;IACxC,oBAAoB,EAAE,wBAAwB;IAC9C,mBAAmB,EAAE,sBAAsB;IAC3C,2BAA2B,EAAE,8BAA8B;IAC3D,mCAAmC,EAAE,sCAAsC;IAC3E,eAAe,EAAE,kBAAkB;IACnC,sBAAsB,EAAE,yBAAyB;CACzC,CAAC;AAsDX,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC;AAQvG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,aAAa,EAAE,SAAS,CAAU,CAAC;AA4cvE,gEAAgE;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAwEvC,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAC3C,MAAM,CAAC,MAAM,qCAAqC,GAAG,GAAG,CAAC;AACzD,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,GAAG,IAAI,CAAC;AACxD,MAAM,CAAC,MAAM,sCAAsC,GAAG,EAAE,GAAG,IAAI,CAAC;AAkBhE,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAC1C,MAAM,CAAC,MAAM,oCAAoC,GAAG,GAAG,CAAC;AACxD,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,GAAG,IAAI,CAAC;AACvD,MAAM,CAAC,MAAM,oCAAoC,GAAG,GAAG,CAAC;AACxD,MAAM,CAAC,MAAM,sCAAsC,GAAG,EAAE,CAAC;AAqCzD,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAC9C,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,GAAG,IAAI,CAAC;AAiwB3D,MAAM,CAAC,MAAM,2CAA2C,GAAG,MAAM,CAAC"}
+{"version":3,"file":"apiTypes.js","sourceRoot":"","sources":["../../src/shared/apiTypes.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,sBAAsB,EAAE,yBAAyB;IACjD,qBAAqB,EAAE,wBAAwB;IAC/C,eAAe,EAAE,kBAAkB;IACnC,cAAc,EAAE,iBAAiB;IACjC,kBAAkB,EAAE,qBAAqB;IACzC,sBAAsB,EAAE,yBAAyB;IACjD,oBAAoB,EAAE,uBAAuB;IAC7C,sBAAsB,EAAE,yBAAyB;IACjD,qBAAqB,EAAE,wBAAwB;IAC/C,cAAc,EAAE,iBAAiB;IACjC,iBAAiB,EAAE,oBAAoB;IACvC,wBAAwB,EAAE,2BAA2B;IACrD,gBAAgB,EAAE,mBAAmB;IACrC,uBAAuB,EAAE,0BAA0B;IACnD,kBAAkB,EAAE,uBAAuB;IAC3C,iBAAiB,EAAE,qBAAqB;IACxC,oBAAoB,EAAE,wBAAwB;IAC9C,mBAAmB,EAAE,sBAAsB;IAC3C,2BAA2B,EAAE,8BAA8B;IAC3D,mCAAmC,EAAE,sCAAsC;IAC3E,eAAe,EAAE,kBAAkB;IACnC,sBAAsB,EAAE,yBAAyB;CACzC,CAAC;AAsDX,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC;AAQvG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,aAAa,EAAE,SAAS,CAAU,CAAC;AAogBvE,gEAAgE;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAwEvC,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAC3C,MAAM,CAAC,MAAM,qCAAqC,GAAG,GAAG,CAAC;AACzD,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,GAAG,IAAI,CAAC;AACxD,MAAM,CAAC,MAAM,sCAAsC,GAAG,EAAE,GAAG,IAAI,CAAC;AAkBhE,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAC1C,MAAM,CAAC,MAAM,oCAAoC,GAAG,GAAG,CAAC;AACxD,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,GAAG,IAAI,CAAC;AACvD,MAAM,CAAC,MAAM,oCAAoC,GAAG,GAAG,CAAC;AACxD,MAAM,CAAC,MAAM,sCAAsC,GAAG,EAAE,CAAC;AAqCzD,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAC9C,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,GAAG,IAAI,CAAC;AAiwB3D,MAAM,CAAC,MAAM,2CAA2C,GAAG,MAAM,CAAC"}

package/dist/shared/speechInput.js

@@ -0,0 +1,75 @@
+export const SPEECH_INPUT_DEFAULT_BASE_URL = "https://api.openai.com/v1";
+export const SPEECH_INPUT_DEFAULT_MODEL = "gpt-4o-mini-transcribe";
+const CANONICAL_LOWERCASE_UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/u;
+/**
+ * Canonical lowercase v4 UUID spelling, as produced by the config mutation
+ * coordinator's default revision source. Opaque to clients; used to enforce
+ * the wire spelling at both the server and browser parser edges.
+ */
+export function isCanonicalLowercaseUuid(value) {
+    return CANONICAL_LOWERCASE_UUID_PATTERN.test(value);
+}
+/**
+ * Syntactic-only BCP 47 canonicalization. Returns undefined for malformed
+ * tags; "auto" is not a valid BCP 47 tag, so omission remains the only Auto
+ * wire representation.
+ */
+export function canonicalBcp47LanguageTag(value) {
+    try {
+        const canonical = Intl.getCanonicalLocales(value);
+        return canonical.length === 1 ? canonical[0] : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Effective nonsecret speech settings with the persisted defaults applied. */
+export function effectiveSpeechInputSettings(config) {
+    return {
+        provider: config?.provider ?? "auto",
+        ...(config?.language === undefined ? {} : { language: config.language }),
+        cloud: {
+            baseUrl: config?.cloud?.baseUrl ?? SPEECH_INPUT_DEFAULT_BASE_URL,
+            model: config?.cloud?.model ?? SPEECH_INPUT_DEFAULT_MODEL,
+        },
+    };
+}
+/** Canonical primary language subtag for the cloud `language` field; Auto stays omitted. */
+export function speechInputCloudLanguage(language) {
+    if (language === undefined)
+        return undefined;
+    try {
+        return new Intl.Locale(language).language;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Reparses an already validated HTTPS base URL, canonicalizes URL syntax
+ * (host case, default port, trailing path slashes), and appends exactly one
+ * `/audio/transcriptions` segment while preserving non-root base paths.
+ * Shared by the preserved-credential endpoint comparison and the cloud
+ * provider so both always agree on the effective endpoint.
+ */
+export function speechInputTranscriptionEndpoint(baseUrl) {
+    let url;
+    try {
+        url = new URL(baseUrl);
+    }
+    catch {
+        throw new Error("Speech input cloud base URL must be a valid HTTPS URL");
+    }
+    if (url.protocol !== "https:")
+        throw new Error("Speech input cloud base URL must use HTTPS");
+    if (url.username !== "" || url.password !== "")
+        throw new Error("Speech input cloud base URL must not contain credentials");
+    if (url.search !== "")
+        throw new Error("Speech input cloud base URL must not contain a query string");
+    if (url.hash !== "")
+        throw new Error("Speech input cloud base URL must not contain a fragment");
+    const path = url.pathname.replace(/\/+$/u, "");
+    url.pathname = `${path}/audio/transcriptions`;
+    return url.href;
+}
+//# sourceMappingURL=speechInput.js.map

package/dist/shared/speechInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speechInput.js","sourceRoot":"","sources":["../../src/shared/speechInput.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,6BAA6B,GAAG,2BAA2B,CAAC;AACzE,MAAM,CAAC,MAAM,0BAA0B,GAAG,wBAAwB,CAAC;AAEnE,MAAM,gCAAgC,GAAG,wEAAwE,CAAC;AAElH;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,OAAO,gCAAgC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAClD,OAAO,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,4BAA4B,CAAC,MAA4C;IACvF,OAAO;QACL,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,MAAM;QACpC,GAAG,CAAC,MAAM,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxE,KAAK,EAAE;YACL,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,IAAI,6BAA6B;YAChE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,IAAI,0BAA0B;SAC1D;KACF,CAAC;AACJ,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,wBAAwB,CAAC,QAA4B;IACnE,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,IAAI,CAAC;QACH,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAAC,OAAe;IAC9D,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAC7F,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC5H,IAAI,GAAG,CAAC,MAAM,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACtG,IAAI,GAAG,CAAC,IAAI,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAChG,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC/C,GAAG,CAAC,QAAQ,GAAG,GAAG,IAAI,uBAAuB,CAAC;IAC9C,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC"}

package/dist/shared/speechInputAudio.js

@@ -0,0 +1,42 @@
+export const SPEECH_INPUT_MAX_AUDIO_BYTES = 20 * 1024 * 1024;
+export const SPEECH_INPUT_MAX_TRANSCRIPT_BYTES = 1024 * 1024;
+export const SPEECH_INPUT_PROVIDER_TIMEOUT_MS = 120_000;
+export const SPEECH_INPUT_UPLOAD_TIMEOUT_MS = 130_000;
+const MIME_TYPE_PATTERN = /^\s*([!#$%&'*+.^_`|~0-9A-Za-z-]+)\/([!#$%&'*+.^_`|~0-9A-Za-z-]+)(?:\s*;\s*([!#$%&'*+.^_`|~0-9A-Za-z-]+)\s*=\s*([!#$%&'*+.^_`|~0-9A-Za-z.-]+))?\s*$/u;
+/**
+ * Strictly recognizes the recorder formats PI WEBUI can forward without
+ * changing the encoded container. Header field names and token values are
+ * case-insensitive here because browsers vary their Content-Type spelling.
+ */
+export function parseSpeechInputAudioMimeType(value) {
+    if (value === undefined)
+        return undefined;
+    const match = MIME_TYPE_PATTERN.exec(value);
+    if (match === null)
+        return undefined;
+    const type = match[1]?.toLowerCase();
+    const subtype = match[2]?.toLowerCase();
+    const parameter = match[3]?.toLowerCase();
+    const parameterValue = match[4]?.toLowerCase();
+    const mediaType = type === undefined || subtype === undefined ? undefined : `${type}/${subtype}`;
+    if (mediaType === "audio/webm" && parameter === "codecs" && parameterValue === "opus") {
+        return "audio/webm;codecs=opus";
+    }
+    if (mediaType === "audio/ogg" && parameter === "codecs" && parameterValue === "opus") {
+        return "audio/ogg;codecs=opus";
+    }
+    if (mediaType === "audio/mp4" && parameter === "codecs" && parameterValue === "mp4a.40.2") {
+        return "audio/mp4;codecs=mp4a.40.2";
+    }
+    if (mediaType === "audio/mp4" && parameter === undefined)
+        return "audio/mp4";
+    return undefined;
+}
+export function speechInputAudioFilename(value) {
+    if (value === "audio/webm;codecs=opus")
+        return "speech.webm";
+    if (value === "audio/ogg;codecs=opus")
+        return "speech.ogg";
+    return "speech.m4a";
+}
+//# sourceMappingURL=speechInputAudio.js.map

package/dist/shared/speechInputAudio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speechInputAudio.js","sourceRoot":"","sources":["../../src/shared/speechInputAudio.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAC7D,MAAM,CAAC,MAAM,iCAAiC,GAAG,IAAI,GAAG,IAAI,CAAC;AAC7D,MAAM,CAAC,MAAM,gCAAgC,GAAG,OAAO,CAAC;AACxD,MAAM,CAAC,MAAM,8BAA8B,GAAG,OAAO,CAAC;AAQtD,MAAM,iBAAiB,GAAG,qJAAqJ,CAAC;AAEhL;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAAC,KAAyB;IACrE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;IACxC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1C,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC;IAEjG,IAAI,SAAS,KAAK,YAAY,IAAI,SAAS,KAAK,QAAQ,IAAI,cAAc,KAAK,MAAM,EAAE,CAAC;QACtF,OAAO,wBAAwB,CAAC;IAClC,CAAC;IACD,IAAI,SAAS,KAAK,WAAW,IAAI,SAAS,KAAK,QAAQ,IAAI,cAAc,KAAK,MAAM,EAAE,CAAC;QACrF,OAAO,uBAAuB,CAAC;IACjC,CAAC;IACD,IAAI,SAAS,KAAK,WAAW,IAAI,SAAS,KAAK,QAAQ,IAAI,cAAc,KAAK,WAAW,EAAE,CAAC;QAC1F,OAAO,4BAA4B,CAAC;IACtC,CAAC;IACD,IAAI,SAAS,KAAK,WAAW,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAC7E,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAA+B;IACtE,IAAI,KAAK,KAAK,wBAAwB;QAAE,OAAO,aAAa,CAAC;IAC7D,IAAI,KAAK,KAAK,uBAAuB;QAAE,OAAO,YAAY,CAAC;IAC3D,OAAO,YAAY,CAAC;AACtB,CAAC"}