@happyvertical/smrt-ui 0.51.39 → 0.53.0

package/dist/components/forms/camera-capture-session.js

@@ -0,0 +1,130 @@
+/**
+ * Framework-free `getUserMedia()` lifecycle for `CameraCapture.svelte`.
+ *
+ * Owns exactly one acquired `MediaStream`: requesting it, classifying a
+ * rejection into one of the states the component renders, and releasing every
+ * track it acquired. It never touches a `<video>` or `<canvas>`, so permission
+ * denied, no camera, unsupported browser and stream cleanup are unit-testable
+ * against a fake `MediaDevices` with no DOM at all. The component stays thin
+ * DOM glue around it.
+ *
+ * Guards one race a naive "await getUserMedia, then store the stream" misses:
+ * the user can dismiss the permission prompt late, or the component can be
+ * disabled or unmounted, while `getUserMedia()` is still pending. Storing that
+ * late result would leave the camera light on with nothing left to stop it.
+ * `stop()` and every new `start()` bump a generation counter; `start()`
+ * compares the generation it was issued under once the promise settles and
+ * discards a stale result, stopping any tracks it just acquired.
+ *
+ * Ported from teamworks-os (`camera-capture-session.ts` and
+ * `camera-capture-logic.ts`), smrt#3290.
+ */
+/**
+ * Whether this runtime exposes `getUserMedia` at all. An unsupported browser is
+ * never reported as "no camera": those states need different recovery copy.
+ */
+export function isCameraApiSupported(nav) {
+    return typeof nav?.mediaDevices?.getUserMedia === 'function';
+}
+function readStringField(value, field) {
+    if (typeof value !== 'object' || value === null || !(field in value)) {
+        return undefined;
+    }
+    const read = value[field];
+    return typeof read === 'string' ? read : undefined;
+}
+/**
+ * Maps a `getUserMedia()` rejection to a rendered state by `DOMException.name`
+ * (the cross-browser contract), never by message text.
+ *
+ * Deliberately does not gate on `instanceof Error`: a browser `DOMException`
+ * does not inherit from `Error` in shipping engines, so that check would send
+ * every real rejection to the generic state. Node's `DOMException` happening to
+ * extend `Error` is what hides that bug in local tests.
+ */
+export function classifyGetUserMediaError(error) {
+    switch (readStringField(error, 'name')) {
+        case 'NotAllowedError':
+        case 'PermissionDeniedError':
+        case 'SecurityError':
+            return 'permission-denied';
+        case 'NotFoundError':
+        case 'DevicesNotFoundError':
+        case 'OverconstrainedError':
+            return 'no-camera';
+        default:
+            return 'error';
+    }
+}
+const UNSUPPORTED_MESSAGE = 'getUserMedia is not available in this runtime.';
+const GENERIC_ERROR_MESSAGE = 'Could not access the camera.';
+const CANCELLED_MESSAGE = 'Camera request was superseded by stop().';
+/** Create a session that owns at most one live camera stream. */
+export function createCameraSession(deps) {
+    let stream = null;
+    let generation = 0;
+    function releaseTracks(media) {
+        for (const track of media.getTracks())
+            track.stop();
+    }
+    /**
+     * Request the camera. `facingMode` is a parameter, not a construction-time
+     * dependency, so a caller re-reading a reactive prop always requests the
+     * current value. A new `start()` supersedes the held stream (released now)
+     * and any request still pending (released when it settles), so overlapping
+     * calls can never leak a stream.
+     */
+    async function start(facingMode) {
+        if (stream) {
+            releaseTracks(stream);
+            stream = null;
+        }
+        generation += 1;
+        const requestGeneration = generation;
+        const mediaDevices = deps.mediaDevices;
+        if (!mediaDevices || !isCameraApiSupported({ mediaDevices })) {
+            return { ok: false, kind: 'unsupported', message: UNSUPPORTED_MESSAGE };
+        }
+        try {
+            const media = await mediaDevices.getUserMedia({
+                video: { facingMode },
+                audio: false,
+            });
+            if (requestGeneration !== generation) {
+                releaseTracks(media);
+                return { ok: false, kind: 'cancelled', message: CANCELLED_MESSAGE };
+            }
+            stream = media;
+            return { ok: true, stream: media };
+        }
+        catch (error) {
+            if (requestGeneration !== generation) {
+                return { ok: false, kind: 'cancelled', message: CANCELLED_MESSAGE };
+            }
+            return {
+                ok: false,
+                kind: classifyGetUserMediaError(error),
+                message: readStringField(error, 'message') ?? GENERIC_ERROR_MESSAGE,
+            };
+        }
+    }
+    /**
+     * Stop every track of the held stream, forget it, and invalidate any
+     * `start()` still in flight. Idempotent: a second call (for example from a
+     * `disabled` toggle and then unmount) never stops a track twice.
+     */
+    function stop() {
+        generation += 1;
+        if (stream)
+            releaseTracks(stream);
+        stream = null;
+    }
+    return {
+        start,
+        stop,
+        /** The live stream, or `null` when none is held. */
+        get stream() {
+            return stream;
+        },
+    };
+}

package/dist/components/forms/control-interaction.d.ts

@@ -54,6 +54,12 @@ export interface ControlMetadata {
     options?: ControlOption[];
     unit?: string;
     capabilities?: ControlCapability[];
+    /**
+     * JSON Schema for this control's value, for composites whose value is not a
+     * plain string/number/boolean (a place picker's `{ name, latitude, … }`).
+     * Proposal adapters use it verbatim instead of deriving one from `kind`.
+     */
+    valueSchema?: Record<string, unknown>;
 }
 export interface ControlRuntimeState {
     disabled?: boolean;

package/dist/components/forms/control-interaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"control-interaction.d.ts","sourceRoot":"","sources":["../../../src/components/forms/control-interaction.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"control-interaction.d.ts","sourceRoot":"","sources":["../../../src/components/forms/control-interaction.ts"],"names":[],"mappings":"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"}

package/dist/components/forms/control-interaction.js

@@ -489,6 +489,9 @@ export function createControlInteractionRegistry(options = {}) {
                 options: registration.metadata.options?.map((option) => ({
                     ...option,
                 })),
+                ...(registration.metadata.valueSchema
+                    ? { valueSchema: cloneValue(registration.metadata.valueSchema) }
+                    : {}),
             },
             state: {
                 ...runtimeState,
@@ -755,7 +758,15 @@ export function createControlInteractionRegistry(options = {}) {
                 }
                 switch (command.action) {
                     case 'focus':
-                        await registration.focus?.();
+                        // An agent never moves the person's keyboard focus: its `focus`
+                        // shows the control instead (scroll into view and highlight).
+                        if (context.source === 'agent') {
+                            await registration.reveal?.();
+                            await registration.highlight?.();
+                        }
+                        else {
+                            await registration.focus?.();
+                        }
                         break;
                     case 'reveal':
                         await registration.reveal?.();

package/dist/components/forms/control-proposals.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Form-level proposals over a control interaction registry.
+ *
+ * Transport-neutral helpers for "propose values for this form" adapters (the
+ * rich smrt-svelte `<Form webmcp>` tool, `FormScope`, a chat or voice
+ * adapter). They read whatever the registry holds for one `formId` — every
+ * smrt-ui primitive (`Input`, `Select`, `Textarea`, `Combobox`, …) and every
+ * composite registered through `useControlRegistration` — and only ever STAGE
+ * values: a person applies them through `StagedControlReview`.
+ */
+import type { ControlCommandSource, ControlInteractionRegistry, ControlSnapshot } from './control-interaction.js';
+/** Tool-safe name (`[a-z0-9_]`) for a form's proposal tool. */
+export declare function controlProposalToolName(formId: string): string;
+/**
+ * Whether a control can take a proposal at all: never secret or sensitive,
+ * never declared unwritable, disabled, or read-only, and never a file or
+ * password (neither is representable as a proposed JSON value).
+ */
+export declare function isControlProposable(snapshot: ControlSnapshot): boolean;
+/** JSON Schema for one control's proposed value. */
+export declare function controlProposalSchema(snapshot: ControlSnapshot): Record<string, unknown>;
+export interface ControlProposalOptions {
+    /** Control ids another source already describes (skipped here). */
+    exclude?: Iterable<string>;
+}
+/**
+ * The proposable controls of one form, keyed by control id. A
+ * record-qualified control (subject) shares its controlId with its siblings;
+ * the first registered wins so the schema key stays unambiguous.
+ */
+export declare function proposableControls(registry: ControlInteractionRegistry, formId: string, options?: ControlProposalOptions): Map<string, ControlSnapshot>;
+/** `{ controlId: schema }` for every proposable control of a form. */
+export declare function controlProposalProperties(registry: ControlInteractionRegistry, formId: string, options?: ControlProposalOptions): Record<string, Record<string, unknown>>;
+/** Object schema with one optional property per proposable control. */
+export declare function controlProposalInputSchema(registry: ControlInteractionRegistry, formId: string, options?: ControlProposalOptions): Record<string, unknown>;
+export interface StageControlProposalsResult {
+    ok: boolean;
+    staged: number;
+    rejected: Array<{
+        control: string;
+        reason: string;
+    }>;
+    /** Supplied keys that are not proposable controls of this form. */
+    skipped: string[];
+}
+/**
+ * Stage each supplied value as a proposal for local human review. Unknown,
+ * secret, read-only, or disabled controls are skipped — never written — and a
+ * proposal never applies or submits anything.
+ */
+export declare function stageControlProposals(registry: ControlInteractionRegistry, formId: string, values: Record<string, unknown>, context?: {
+    source?: ControlCommandSource;
+    actorId?: string;
+}, options?: ControlProposalOptions): Promise<StageControlProposalsResult>;
+//# sourceMappingURL=control-proposals.d.ts.map

package/dist/components/forms/control-proposals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-proposals.d.ts","sourceRoot":"","sources":["../../../src/components/forms/control-proposals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAGV,oBAAoB,EACpB,0BAA0B,EAC1B,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAElC,+DAA+D;AAC/D,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAQtE;AAQD,oDAAoD;AACpD,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,eAAe,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8DzB;AAED,MAAM,WAAW,sBAAsB;IACrC,mEAAmE;IACnE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,sBAA2B,GACnC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAW9B;AAED,sEAAsE;AACtE,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,sBAA2B,GACnC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAUzC;AAED,uEAAuE;AACvE,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,sBAA2B,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,EACjE,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,2BAA2B,CAAC,CAwCtC"}

package/dist/components/forms/control-proposals.js

@@ -0,0 +1,188 @@
+/**
+ * Form-level proposals over a control interaction registry.
+ *
+ * Transport-neutral helpers for "propose values for this form" adapters (the
+ * rich smrt-svelte `<Form webmcp>` tool, `FormScope`, a chat or voice
+ * adapter). They read whatever the registry holds for one `formId` — every
+ * smrt-ui primitive (`Input`, `Select`, `Textarea`, `Combobox`, …) and every
+ * composite registered through `useControlRegistration` — and only ever STAGE
+ * values: a person applies them through `StagedControlReview`.
+ */
+/** Tool-safe name (`[a-z0-9_]`) for a form's proposal tool. */
+export function controlProposalToolName(formId) {
+    const base = formId
+        .toLowerCase()
+        .replace(/[^a-z0-9_]+/g, '_')
+        .replace(/^_+|_+$/g, '');
+    return `${base || 'form'}_stage_changes`;
+}
+/**
+ * Whether a control can take a proposal at all: never secret or sensitive,
+ * never declared unwritable, disabled, or read-only, and never a file or
+ * password (neither is representable as a proposed JSON value).
+ */
+export function isControlProposable(snapshot) {
+    const { metadata, state } = snapshot;
+    if (metadata.sensitivity === 'secret' || metadata.sensitivity === 'sensitive')
+        return false;
+    if (metadata.writable === false)
+        return false;
+    if (metadata.kind === 'file' || metadata.kind === 'password')
+        return false;
+    if (state.disabled || state.readonly)
+        return false;
+    return true;
+}
+function numericConstraint(value) {
+    if (value === undefined || value === '')
+        return undefined;
+    const number = Number(value);
+    return Number.isFinite(number) ? number : undefined;
+}
+/** JSON Schema for one control's proposed value. */
+export function controlProposalSchema(snapshot) {
+    const { metadata } = snapshot;
+    const constraints = metadata.constraints ?? {};
+    const optionValues = metadata.options?.map((option) => option.value);
+    let schema;
+    if (metadata.valueSchema) {
+        schema = { ...metadata.valueSchema };
+    }
+    else {
+        switch (metadata.kind) {
+            case 'number':
+            case 'slider': {
+                schema = { type: 'number' };
+                const minimum = numericConstraint(constraints.min);
+                const maximum = numericConstraint(constraints.max);
+                if (minimum !== undefined)
+                    schema.minimum = minimum;
+                if (maximum !== undefined)
+                    schema.maximum = maximum;
+                break;
+            }
+            case 'checkbox':
+            case 'switch':
+            case 'toggle-button':
+                schema = { type: 'boolean' };
+                break;
+            case 'multi-select':
+            case 'tags-input':
+                schema = {
+                    type: 'array',
+                    items: optionValues?.length
+                        ? { enum: optionValues }
+                        : { type: 'string' },
+                };
+                break;
+            case 'range-slider':
+                schema = {
+                    type: 'array',
+                    items: { type: 'number' },
+                    minItems: 2,
+                    maxItems: 2,
+                };
+                break;
+            case 'custom':
+                // A composite without a declared valueSchema: describe, don't guess.
+                schema = {};
+                break;
+            default:
+                schema = { type: 'string' };
+                if (typeof constraints.minLength === 'number' &&
+                    constraints.minLength > 0)
+                    schema.minLength = constraints.minLength;
+                if (typeof constraints.maxLength === 'number' &&
+                    constraints.maxLength > 0)
+                    schema.maxLength = constraints.maxLength;
+                if (optionValues?.length)
+                    schema.enum = optionValues;
+        }
+    }
+    if (metadata.label)
+        schema.title = metadata.label;
+    if (metadata.description)
+        schema.description = metadata.description;
+    return schema;
+}
+/**
+ * The proposable controls of one form, keyed by control id. A
+ * record-qualified control (subject) shares its controlId with its siblings;
+ * the first registered wins so the schema key stays unambiguous.
+ */
+export function proposableControls(registry, formId, options = {}) {
+    const excluded = new Set(options.exclude ?? []);
+    const controls = new Map();
+    for (const snapshot of registry.list(formId)) {
+        const { controlId } = snapshot.identity;
+        if (snapshot.identity.formId !== formId || excluded.has(controlId))
+            continue;
+        if (!isControlProposable(snapshot) || controls.has(controlId))
+            continue;
+        controls.set(controlId, snapshot);
+    }
+    return controls;
+}
+/** `{ controlId: schema }` for every proposable control of a form. */
+export function controlProposalProperties(registry, formId, options = {}) {
+    const properties = {};
+    for (const [controlId, snapshot] of proposableControls(registry, formId, options)) {
+        properties[controlId] = controlProposalSchema(snapshot);
+    }
+    return properties;
+}
+/** Object schema with one optional property per proposable control. */
+export function controlProposalInputSchema(registry, formId, options = {}) {
+    return {
+        type: 'object',
+        additionalProperties: false,
+        properties: controlProposalProperties(registry, formId, options),
+    };
+}
+/**
+ * Stage each supplied value as a proposal for local human review. Unknown,
+ * secret, read-only, or disabled controls are skipped — never written — and a
+ * proposal never applies or submits anything.
+ */
+export async function stageControlProposals(registry, formId, values, context = {}, options = {}) {
+    const controls = proposableControls(registry, formId, options);
+    const commands = [];
+    const skipped = [];
+    for (const [controlId, value] of Object.entries(values ?? {})) {
+        const snapshot = controls.get(controlId);
+        if (!snapshot) {
+            skipped.push(controlId);
+            continue;
+        }
+        commands.push({ action: 'stage', identity: snapshot.identity, value });
+    }
+    if (commands.length === 0) {
+        return { ok: false, staged: 0, rejected: [], skipped };
+    }
+    const commandContext = {
+        source: context.source ?? 'agent',
+        ...(context.actorId ? { actorId: context.actorId } : {}),
+    };
+    let results;
+    if (registry.executeBatch) {
+        results = (await registry.executeBatch(commands, commandContext)).results;
+    }
+    else {
+        results = [];
+        for (const command of commands) {
+            results.push(await registry.execute(command, commandContext));
+        }
+    }
+    const rejected = results
+        .filter((result) => !result.ok)
+        .map((result) => ({
+        control: result.identity.controlId,
+        reason: result.reason ?? 'rejected',
+    }));
+    return {
+        ok: rejected.length === 0,
+        staged: results.length - rejected.length,
+        rejected,
+        skipped,
+    };
+}

package/dist/components/forms/dictation-transcribe.d.ts

@@ -0,0 +1,36 @@
+export interface DictationTranscribeOptions {
+    /** The recording's MIME type, e.g. `audio/webm;codecs=opus`. */
+    mimeType: string;
+    /** BCP-47 language the person speaks, e.g. `en-US`. */
+    language: string;
+    /** How long the recording is, in milliseconds. */
+    durationMs: number;
+    /** Aborted when the person cancels or the form goes away. */
+    signal: AbortSignal;
+}
+/**
+ * Writes down a recorded message. Resolve the text (empty when nothing was
+ * said); reject to show an error. Throw a `DictationError` to pick the
+ * message (`too-long`, `not-transcribed`, `unavailable`, …).
+ */
+export type DictationTranscribe = (audio: Blob, options: DictationTranscribeOptions) => Promise<string | {
+    text: string;
+}>;
+export interface HttpTranscriberOptions {
+    /** `fetch` to use (default `globalThis.fetch`). */
+    fetch?: typeof fetch;
+    /** Extra request headers. */
+    headers?: Record<string, string>;
+}
+/**
+ * A `DictationTranscribe` that POSTs the audio to `url` as the raw request
+ * body (`Content-Type` is the recording's type) with `language` and
+ * `durationMs` in the query string, and reads `{ text }` back.
+ *
+ * Status codes become plain-words errors: 413 → `too-long`, 503 →
+ * `unavailable` (not set up), 401/403 → `forbidden`, anything else →
+ * `not-transcribed`. The server's `{ error }` text is kept as the error
+ * message for logs, not shown.
+ */
+export declare function createHttpTranscriber(url: string | URL, options?: HttpTranscriberOptions): DictationTranscribe;
+//# sourceMappingURL=dictation-transcribe.d.ts.map

package/dist/components/forms/dictation-transcribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictation-transcribe.d.ts","sourceRoot":"","sources":["../../../src/components/forms/dictation-transcribe.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,0BAA0B;IACzC,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,KAAK,EAAE,IAAI,EACX,OAAO,EAAE,0BAA0B,KAChC,OAAO,CAAC,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAExC,MAAM,WAAW,sBAAsB;IACrC,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,OAAO,GAAE,sBAA2B,GACnC,mBAAmB,CAoDrB"}

package/dist/components/forms/dictation-transcribe.js

@@ -0,0 +1,65 @@
+/**
+ * Turning a recorded message into text, for dictation's recording fallback.
+ *
+ * `Dictation` records audio when the browser cannot recognise speech itself
+ * and hands it to a `DictationTranscribe` function. The app decides where it
+ * goes: normally its own server route, which holds the speech service's key
+ * (never put a provider key in the browser). `createHttpTranscriber` is that
+ * function for a route that takes the raw audio as the request body and
+ * answers `{ text }`.
+ */
+import { DictationError } from './audio-capture.js';
+/**
+ * A `DictationTranscribe` that POSTs the audio to `url` as the raw request
+ * body (`Content-Type` is the recording's type) with `language` and
+ * `durationMs` in the query string, and reads `{ text }` back.
+ *
+ * Status codes become plain-words errors: 413 → `too-long`, 503 →
+ * `unavailable` (not set up), 401/403 → `forbidden`, anything else →
+ * `not-transcribed`. The server's `{ error }` text is kept as the error
+ * message for logs, not shown.
+ */
+export function createHttpTranscriber(url, options = {}) {
+    return async (audio, { mimeType, language, durationMs, signal }) => {
+        const doFetch = options.fetch ?? globalThis.fetch;
+        const base = typeof window !== 'undefined'
+            ? window.location.href
+            : 'http://localhost/';
+        const target = new URL(String(url), base);
+        if (language)
+            target.searchParams.set('language', language);
+        if (Number.isFinite(durationMs)) {
+            target.searchParams.set('durationMs', String(Math.round(durationMs)));
+        }
+        let response;
+        try {
+            response = await doFetch(target.toString(), {
+                method: 'POST',
+                headers: { ...options.headers, 'Content-Type': mimeType },
+                body: audio,
+                credentials: 'same-origin',
+                signal,
+            });
+        }
+        catch (error) {
+            if (error?.name === 'AbortError')
+                throw error;
+            throw new DictationError('not-transcribed', `Could not reach the speech service: ${error instanceof Error ? error.message : String(error)}`, 'network');
+        }
+        const body = (await response.json().catch(() => null));
+        if (!response.ok) {
+            const message = typeof body?.error === 'string'
+                ? body.error
+                : `Speech service answered ${response.status}`;
+            const kind = response.status === 413
+                ? 'too-long'
+                : response.status === 503
+                    ? 'unavailable'
+                    : response.status === 401 || response.status === 403
+                        ? 'forbidden'
+                        : 'not-transcribed';
+            throw new DictationError(kind, message, `http-${response.status}`);
+        }
+        return typeof body?.text === 'string' ? body.text : '';
+    };
+}