@motebit/sdk 0.6.11 → 0.8.0

package/dist/provider-resolver.js

@@ -0,0 +1,224 @@
+// === Provider Resolver — pure dispatch logic, shared across all surfaces ===
+//
+// The four surfaces (web, mobile, desktop, cli) used to each maintain their
+// own copy of "given a UnifiedProviderConfig, build a concrete @motebit/ai-core
+// provider instance." Four implementations of the same decision tree, with
+// only one (web) actually containing the Ollama-vs-OpenAI-compat dispatch
+// heuristic. Adding a vendor meant editing four files. Fixing a bug meant
+// fixing it four times — and historically, only the surface where the bug
+// was reported actually got the fix.
+//
+// This module extracts the decision tree as a pure function. It takes a
+// `UnifiedProviderConfig` and a surface-supplied `ResolverEnv` (which captures
+// the only legitimately-divergent concerns: platform URL routing, available
+// on-device backends, motebit-cloud session state). It returns a `ProviderSpec`
+// — a normalized data shape describing what kind of provider to instantiate
+// with what config. The surface still constructs the concrete class itself
+// (because @motebit/sdk is Layer 0 and can't import @motebit/ai-core's
+// provider classes), but the construction shrinks to a 15-line transport
+// switch with no decision logic.
+//
+// Adding a new vendor: extend ByokVendor, add a case to resolveProviderSpec.
+// Fixing a dispatch bug: fix it once here. Tested in one place.
+//
+// What stays per-surface (and rightly so):
+//   - Constructing the actual @motebit/ai-core provider classes
+//   - Async init flows (WebLLM model download, native module loading)
+//   - API key storage (keyring vs SecureStore vs env vars)
+//   - URL substitution that depends on platform (Vite proxy paths, Tauri vs dev)
+//
+// What moves here (the duplication):
+//   - The mode → vendor → transport decision tree
+//   - The Ollama-vs-OpenAI-compat endpoint heuristic
+//   - The Google "uses OpenAI-compat" fact
+//   - Default model fallback per vendor
+//   - The supported-backends gate
+import { DEFAULT_ANTHROPIC_MODEL, DEFAULT_OPENAI_MODEL, DEFAULT_GOOGLE_MODEL, DEFAULT_OLLAMA_MODEL, DEFAULT_PROXY_MODEL, } from "./models.js";
+// === Constants ===
+/**
+ * Google's OpenAI-compatible chat completions endpoint. Used when the user
+ * picks Google as a BYOK vendor — Google is dispatched as OpenAI-compat
+ * because every cloud client (web, mobile, desktop, cli) already understands
+ * the OpenAI wire protocol. Single source of truth.
+ */
+export const GOOGLE_OPENAI_COMPAT_URL = "https://generativelanguage.googleapis.com/v1beta/openai";
+/** Canonical Anthropic API base URL. */
+export const ANTHROPIC_CANONICAL_URL = "https://api.anthropic.com";
+/** Canonical OpenAI API base URL. */
+export const OPENAI_CANONICAL_URL = "https://api.openai.com/v1";
+/** Default Motebit Cloud relay URL. Surfaces may override via env. */
+export const DEFAULT_MOTEBIT_CLOUD_URL = "https://api.motebit.com";
+/** Default WebLLM model when none specified — small enough to fit on most devices. */
+export const DEFAULT_WEBLLM_MODEL = "Llama-3.2-3B-Instruct-q4f16_1-MLC";
+// === Helpers ===
+/**
+ * Normalize a local-inference server URL so that it points at the
+ * OpenAI-compatible chat completions base path. Auto-appends `/v1` if
+ * the URL doesn't already contain it. Idempotent.
+ *
+ * Every supported local server (Ollama via its OpenAI shim, LM Studio,
+ * llama.cpp, Jan, vLLM, text-generation-webui) exposes
+ * `{base}/v1/chat/completions`. Users typically type just the host
+ * (`http://localhost:11434`) — this helper completes the path so the
+ * client can call `{normalized}/chat/completions` directly.
+ *
+ * Examples:
+ *   "http://localhost:11434"      → "http://localhost:11434/v1"
+ *   "http://localhost:11434/v1"   → "http://localhost:11434/v1"
+ *   "http://localhost:1234/"      → "http://localhost:1234/v1"
+ *   "http://192.168.1.42:11434"   → "http://192.168.1.42:11434/v1"
+ *   "/api/ollama"                 → "/api/ollama/v1"  (dev proxy path)
+ */
+export function normalizeLocalServerEndpoint(url) {
+    const stripped = url.replace(/\/+$/, "");
+    // Already contains a /v1 path segment? Leave it alone.
+    if (/\/v1(\/|$)/.test(stripped))
+        return stripped;
+    return `${stripped}/v1`;
+}
+/** Default chat model for a BYOK vendor. */
+export function defaultModelForVendor(vendor) {
+    switch (vendor) {
+        case "anthropic":
+            return DEFAULT_ANTHROPIC_MODEL;
+        case "openai":
+            return DEFAULT_OPENAI_MODEL;
+        case "google":
+            return DEFAULT_GOOGLE_MODEL;
+    }
+}
+/**
+ * Canonical (vendor-published) base URL for a BYOK vendor. Surfaces that
+ * need to substitute a CORS proxy or dev-mode path receive this canonical
+ * URL via the resolver and may rewrite it.
+ */
+export function canonicalVendorBaseUrl(vendor) {
+    switch (vendor) {
+        case "anthropic":
+            return ANTHROPIC_CANONICAL_URL;
+        case "openai":
+            return OPENAI_CANONICAL_URL;
+        case "google":
+            return GOOGLE_OPENAI_COMPAT_URL;
+    }
+}
+// === Errors ===
+/**
+ * Thrown when the user picks an on-device backend that the current surface
+ * doesn't physically support (e.g., apple-fm on web). Surfaces should
+ * present a graceful error rather than letting it propagate.
+ */
+export class UnsupportedBackendError extends Error {
+    backend;
+    constructor(backend) {
+        super(`On-device backend "${backend}" is not supported on this surface`);
+        this.backend = backend;
+        this.name = "UnsupportedBackendError";
+    }
+}
+// === The resolver ===
+/**
+ * Resolve a `UnifiedProviderConfig` (the user's choice) against a surface's
+ * `ResolverEnv` (its physical capabilities) to produce a normalized
+ * `ProviderSpec` (what the surface should instantiate).
+ *
+ * Pure function. No I/O. No side effects. Tested once, used everywhere.
+ *
+ * @throws {UnsupportedBackendError} if the chosen on-device backend isn't
+ *   in `env.supportedBackends`. Surfaces should catch and present a
+ *   user-facing message.
+ */
+export function resolveProviderSpec(config, env) {
+    switch (config.mode) {
+        case "motebit-cloud": {
+            // Motebit Cloud speaks the Anthropic wire protocol via the relay.
+            // The relay injects the real key server-side, so the spec carries
+            // an empty apiKey — every cloud client knows to handle that case.
+            const baseUrl = config.baseUrl ?? env.motebitCloudBaseUrl ?? DEFAULT_MOTEBIT_CLOUD_URL;
+            const extraHeaders = config.proxyToken !== undefined
+                ? { "x-proxy-token": config.proxyToken, ...(env.motebitCloudHeaders ?? {}) }
+                : env.motebitCloudHeaders;
+            return {
+                kind: "cloud",
+                wireProtocol: "anthropic",
+                apiKey: "",
+                model: config.model ?? env.motebitCloudDefaultModel ?? DEFAULT_PROXY_MODEL,
+                baseUrl,
+                maxTokens: config.maxTokens,
+                temperature: config.temperature,
+                extraHeaders,
+            };
+        }
+        case "byok": {
+            // Google is dispatched as OpenAI-compat — its public API is OpenAI-
+            // compatible at the canonical Google URL. Anthropic and OpenAI use
+            // their own canonical wire protocols.
+            const wireProtocol = config.vendor === "anthropic" ? "anthropic" : "openai";
+            const canonical = config.baseUrl ?? canonicalVendorBaseUrl(config.vendor);
+            return {
+                kind: "cloud",
+                wireProtocol,
+                apiKey: config.apiKey,
+                model: config.model ?? defaultModelForVendor(config.vendor),
+                baseUrl: env.cloudBaseUrl(wireProtocol, canonical),
+                maxTokens: config.maxTokens,
+                temperature: config.temperature,
+            };
+        }
+        case "on-device": {
+            if (!env.supportedBackends.has(config.backend)) {
+                throw new UnsupportedBackendError(config.backend);
+            }
+            switch (config.backend) {
+                case "webllm":
+                    return {
+                        kind: "webllm",
+                        model: config.model ?? DEFAULT_WEBLLM_MODEL,
+                        maxTokens: config.maxTokens,
+                        temperature: config.temperature,
+                    };
+                case "apple-fm":
+                    return {
+                        kind: "apple-fm",
+                        model: config.model,
+                        maxTokens: config.maxTokens,
+                    };
+                case "mlx":
+                    return {
+                        kind: "mlx",
+                        model: config.model,
+                        maxTokens: config.maxTokens,
+                    };
+                case "local-server": {
+                    // Every supported local inference server (Ollama, LM Studio,
+                    // llama.cpp, Jan, vLLM, text-generation-webui, …) exposes an
+                    // OpenAI-compatible chat completions endpoint at /v1. We dispatch
+                    // them all through the OpenAI wire protocol with a single client
+                    // (`OpenAIProvider`). The previous Ollama-vs-OpenAI port heuristic
+                    // is gone — there's only one code path now.
+                    //
+                    // `normalizeLocalServerEndpoint` auto-appends `/v1` so users who
+                    // type the bare host (`http://localhost:11434`) still work. Users
+                    // who type the full path (`http://localhost:11434/v1`) are
+                    // unaffected. Surfaces may further substitute the URL via
+                    // `localServerBaseUrl` (e.g. desktop dev mode → `/api/ollama`).
+                    const logicalEndpoint = config.endpoint ?? env.defaultLocalServerUrl;
+                    const surfaceTransformed = env.localServerBaseUrl?.(logicalEndpoint) ?? logicalEndpoint;
+                    const actualEndpoint = normalizeLocalServerEndpoint(surfaceTransformed);
+                    return {
+                        kind: "cloud",
+                        wireProtocol: "openai",
+                        // Local OpenAI-compat servers don't validate the API key, but
+                        // most clients require a non-empty string. Use a sentinel.
+                        apiKey: "local",
+                        model: config.model ?? DEFAULT_OLLAMA_MODEL,
+                        baseUrl: actualEndpoint,
+                        maxTokens: config.maxTokens,
+                        temperature: config.temperature,
+                    };
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=provider-resolver.js.map

package/dist/provider-resolver.js.map

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

package/dist/risk-labels.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Canonical risk level labels for tool governance.
+ *
+ * The five risk levels are the same across every surface and every
+ * storage system — they're the axes the `PolicyGate` scores tools
+ * against, and they're what the user picks a preset threshold for.
+ * The label strings ("R0 Read", "R1 Draft", …) were drifting across
+ * four different files with four different presentation shapes
+ * (Record<number, string>, { label, cls }, { label, color, bg }).
+ * This module is the authoritative source for the semantic labels.
+ *
+ * Surfaces still own their own presentation — the CSS class in
+ * desktop's chat badge, the color swatches in the mobile approval
+ * card — but the label string comes from here.
+ *
+ * The order is the same as `PolicyGate`'s risk scoring: 0 is
+ * read-only, 4 is "touches money." A tool classified above its
+ * surface's `requireApprovalAbove` gets a modal; above `denyAbove`
+ * gets rejected.
+ */
+export declare const RISK_LABELS: Record<number, string>;
+//# sourceMappingURL=risk-labels.d.ts.map

package/dist/risk-labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk-labels.d.ts","sourceRoot":"","sources":["../src/risk-labels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAM9C,CAAC"}

package/dist/risk-labels.js

@@ -0,0 +1,28 @@
+/**
+ * Canonical risk level labels for tool governance.
+ *
+ * The five risk levels are the same across every surface and every
+ * storage system — they're the axes the `PolicyGate` scores tools
+ * against, and they're what the user picks a preset threshold for.
+ * The label strings ("R0 Read", "R1 Draft", …) were drifting across
+ * four different files with four different presentation shapes
+ * (Record<number, string>, { label, cls }, { label, color, bg }).
+ * This module is the authoritative source for the semantic labels.
+ *
+ * Surfaces still own their own presentation — the CSS class in
+ * desktop's chat badge, the color swatches in the mobile approval
+ * card — but the label string comes from here.
+ *
+ * The order is the same as `PolicyGate`'s risk scoring: 0 is
+ * read-only, 4 is "touches money." A tool classified above its
+ * surface's `requireApprovalAbove` gets a modal; above `denyAbove`
+ * gets rejected.
+ */
+export const RISK_LABELS = {
+    0: "R0 Read",
+    1: "R1 Draft",
+    2: "R2 Write",
+    3: "R3 Execute",
+    4: "R4 Money",
+};
+//# sourceMappingURL=risk-labels.js.map

package/dist/risk-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk-labels.js","sourceRoot":"","sources":["../src/risk-labels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,CAAC,MAAM,WAAW,GAA2B;IACjD,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,YAAY;IACf,CAAC,EAAE,UAAU;CACd,CAAC"}

package/dist/surface-options.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Shared option lists for surface settings UIs.
+ *
+ * These are the dropdown / radio / chip options every surface needs
+ * to render the same choices the same way: the six OpenAI TTS voices,
+ * and the three theme preferences.
+ *
+ * Previously each surface redeclared these inline. Now there's one
+ * source — a new TTS voice added here shows up in every settings tab.
+ *
+ * The shapes are intentionally presentation-neutral: a key + label
+ * pair. Each surface layers its own visual styling (chip vs radio vs
+ * dropdown) on top. The key is what gets persisted; the label is what
+ * the user sees.
+ */
+export interface TtsVoiceOption {
+    key: string;
+    label: string;
+}
+/**
+ * OpenAI TTS voices. Reference: https://platform.openai.com/docs/guides/text-to-speech/voice-options
+ *
+ * These map 1:1 onto the `VoiceConfig.ttsVoice` field. Surfaces with
+ * non-OpenAI TTS providers can supplement this list with their own
+ * voice options, but the default catalogue lives here.
+ */
+export declare const TTS_VOICE_OPTIONS: TtsVoiceOption[];
+export type ThemePreference = "light" | "dark" | "system";
+export interface ThemeOption {
+    key: ThemePreference;
+    label: string;
+}
+export declare const THEME_OPTIONS: ThemeOption[];
+//# sourceMappingURL=surface-options.d.ts.map

package/dist/surface-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-options.d.ts","sourceRoot":"","sources":["../src/surface-options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,cAAc,EAO7C,CAAC;AAIF,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,eAAe,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,EAItC,CAAC"}

package/dist/surface-options.js

@@ -0,0 +1,36 @@
+/**
+ * Shared option lists for surface settings UIs.
+ *
+ * These are the dropdown / radio / chip options every surface needs
+ * to render the same choices the same way: the six OpenAI TTS voices,
+ * and the three theme preferences.
+ *
+ * Previously each surface redeclared these inline. Now there's one
+ * source — a new TTS voice added here shows up in every settings tab.
+ *
+ * The shapes are intentionally presentation-neutral: a key + label
+ * pair. Each surface layers its own visual styling (chip vs radio vs
+ * dropdown) on top. The key is what gets persisted; the label is what
+ * the user sees.
+ */
+/**
+ * OpenAI TTS voices. Reference: https://platform.openai.com/docs/guides/text-to-speech/voice-options
+ *
+ * These map 1:1 onto the `VoiceConfig.ttsVoice` field. Surfaces with
+ * non-OpenAI TTS providers can supplement this list with their own
+ * voice options, but the default catalogue lives here.
+ */
+export const TTS_VOICE_OPTIONS = [
+    { key: "alloy", label: "Alloy" },
+    { key: "echo", label: "Echo" },
+    { key: "fable", label: "Fable" },
+    { key: "onyx", label: "Onyx" },
+    { key: "nova", label: "Nova" },
+    { key: "shimmer", label: "Shimmer" },
+];
+export const THEME_OPTIONS = [
+    { key: "light", label: "Light" },
+    { key: "dark", label: "Dark" },
+    { key: "system", label: "System" },
+];
+//# sourceMappingURL=surface-options.js.map

package/dist/surface-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-options.js","sourceRoot":"","sources":["../src/surface-options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AASH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAqB;IACjD,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IAChC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;IAC9B,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IAChC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;IAC9B,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;IAC9B,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;CACrC,CAAC;AAWF,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IAChC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;IAC9B,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;CACnC,CAAC"}

package/dist/voice-config.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Canonical voice configuration shape.
+ *
+ * Every surface (web, mobile, desktop, spatial) has historically carried its
+ * own voice config — with drifted field names (`voiceResponse` vs
+ * `voiceResponseEnabled` vs `speakResponses`, `autoSend` vs `voiceAutoSend`)
+ * and different subsets of the feature set. This module is the authoritative
+ * vocabulary. Surfaces may keep UI-internal state in their own shapes, but
+ * anything crossing the SDK boundary — sync, import/export, cross-surface
+ * helpers — speaks `VoiceConfig`.
+ *
+ * Migration helpers are provided for the legacy shapes so each surface can
+ * normalize on load without inventing its own migration one-offs.
+ */
+/**
+ * The canonical voice configuration. Narrow, descriptive, surface-agnostic.
+ *
+ * - `enabled`: master on/off for the voice pipeline (VAD + STT + TTS).
+ * - `autoSend`: after a transcription lands, auto-submit without a manual
+ *   press. Off means the user edits/approves the transcript first.
+ * - `speakResponses`: read agent replies aloud via the TTS backend.
+ * - `ttsVoice`: opaque voice identifier — the specific string space depends
+ *   on the TTS provider (OpenAI voices, platform voices, …).
+ * - `neuralVad`: opt into ML-based VAD where the platform supports it
+ *   (currently iOS via Silero). Absent/false uses the default RMS VAD.
+ */
+export interface VoiceConfig {
+    enabled: boolean;
+    autoSend: boolean;
+    speakResponses: boolean;
+    ttsVoice: string;
+    neuralVad?: boolean;
+}
+/** Default voice config — voice off, sensible behavior when it's turned on. */
+export declare const DEFAULT_VOICE_CONFIG: VoiceConfig;
+/**
+ * Normalize any of the historical surface-specific voice shapes onto the
+ * canonical `VoiceConfig`. Unknown fields are ignored. Missing fields fall
+ * back to `DEFAULT_VOICE_CONFIG`.
+ *
+ * Accepted legacy keys:
+ *   - web:     `{ttsVoice, autoSend, voiceResponse}`
+ *   - mobile:  `{voiceEnabled, voiceAutoSend, voiceResponseEnabled, neuralVadEnabled, ttsVoice}`
+ *   - desktop: `{ttsVoice, voiceAutoSend, voiceResponseEnabled}`
+ *   - spatial: `{voiceEnabled, ttsVoice}`
+ *
+ * The function is intentionally defensive — it operates on `unknown` because
+ * the typical caller is reading from `localStorage` / `AsyncStorage` / a
+ * Tauri JSON config, all of which return untyped blobs.
+ */
+export declare function migrateVoiceConfig(raw: unknown): VoiceConfig;
+//# sourceMappingURL=voice-config.d.ts.map

package/dist/voice-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-config.d.ts","sourceRoot":"","sources":["../src/voice-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,EAAE,WAMlC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,CAuB5D"}

package/dist/voice-config.js

@@ -0,0 +1,61 @@
+/**
+ * Canonical voice configuration shape.
+ *
+ * Every surface (web, mobile, desktop, spatial) has historically carried its
+ * own voice config — with drifted field names (`voiceResponse` vs
+ * `voiceResponseEnabled` vs `speakResponses`, `autoSend` vs `voiceAutoSend`)
+ * and different subsets of the feature set. This module is the authoritative
+ * vocabulary. Surfaces may keep UI-internal state in their own shapes, but
+ * anything crossing the SDK boundary — sync, import/export, cross-surface
+ * helpers — speaks `VoiceConfig`.
+ *
+ * Migration helpers are provided for the legacy shapes so each surface can
+ * normalize on load without inventing its own migration one-offs.
+ */
+/** Default voice config — voice off, sensible behavior when it's turned on. */
+export const DEFAULT_VOICE_CONFIG = {
+    enabled: false,
+    autoSend: true,
+    speakResponses: true,
+    ttsVoice: "alloy",
+    neuralVad: true,
+};
+/**
+ * Normalize any of the historical surface-specific voice shapes onto the
+ * canonical `VoiceConfig`. Unknown fields are ignored. Missing fields fall
+ * back to `DEFAULT_VOICE_CONFIG`.
+ *
+ * Accepted legacy keys:
+ *   - web:     `{ttsVoice, autoSend, voiceResponse}`
+ *   - mobile:  `{voiceEnabled, voiceAutoSend, voiceResponseEnabled, neuralVadEnabled, ttsVoice}`
+ *   - desktop: `{ttsVoice, voiceAutoSend, voiceResponseEnabled}`
+ *   - spatial: `{voiceEnabled, ttsVoice}`
+ *
+ * The function is intentionally defensive — it operates on `unknown` because
+ * the typical caller is reading from `localStorage` / `AsyncStorage` / a
+ * Tauri JSON config, all of which return untyped blobs.
+ */
+export function migrateVoiceConfig(raw) {
+    if (raw == null || typeof raw !== "object")
+        return { ...DEFAULT_VOICE_CONFIG };
+    const obj = raw;
+    const pick = (keys, isType) => {
+        for (const key of keys) {
+            const v = obj[key];
+            if (isType(v))
+                return v;
+        }
+        return undefined;
+    };
+    const isBool = (v) => typeof v === "boolean";
+    const isStr = (v) => typeof v === "string";
+    return {
+        enabled: pick(["enabled", "voiceEnabled"], isBool) ?? DEFAULT_VOICE_CONFIG.enabled,
+        autoSend: pick(["autoSend", "voiceAutoSend"], isBool) ?? DEFAULT_VOICE_CONFIG.autoSend,
+        speakResponses: pick(["speakResponses", "voiceResponse", "voiceResponseEnabled"], isBool) ??
+            DEFAULT_VOICE_CONFIG.speakResponses,
+        ttsVoice: pick(["ttsVoice"], isStr) ?? DEFAULT_VOICE_CONFIG.ttsVoice,
+        neuralVad: pick(["neuralVad", "neuralVadEnabled"], isBool),
+    };
+}
+//# sourceMappingURL=voice-config.js.map

package/dist/voice-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-config.js","sourceRoot":"","sources":["../src/voice-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAsBH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,IAAI;IACd,cAAc,EAAE,IAAI;IACpB,QAAQ,EAAE,OAAO;IACjB,SAAS,EAAE,IAAI;CAChB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAC/E,MAAM,GAAG,GAAG,GAA8B,CAAC;IAE3C,MAAM,IAAI,GAAG,CAAI,IAAc,EAAE,MAA8B,EAAiB,EAAE;QAChF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YACnB,IAAI,MAAM,CAAC,CAAC,CAAC;gBAAE,OAAO,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,CAAU,EAAgB,EAAE,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC;IACpE,MAAM,KAAK,GAAG,CAAC,CAAU,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;IAEjE,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,IAAI,oBAAoB,CAAC,OAAO;QAClF,QAAQ,EAAE,IAAI,CAAC,CAAC,UAAU,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,IAAI,oBAAoB,CAAC,QAAQ;QACtF,cAAc,EACZ,IAAI,CAAC,CAAC,gBAAgB,EAAE,eAAe,EAAE,sBAAsB,CAAC,EAAE,MAAM,CAAC;YACzE,oBAAoB,CAAC,cAAc;QACrC,QAAQ,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,IAAI,oBAAoB,CAAC,QAAQ;QACpE,SAAS,EAAE,IAAI,CAAC,CAAC,WAAW,EAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC3D,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@motebit/sdk",
-  "version": "0.6.11",
-  "description": "Core types for the motebit protocol — state vectors, identity, memory, policy, tools, and agent delegation",
+  "version": "0.8.0",
+  "description": "Motebit product development kit — shared types, config schemas, normalization, and adapters for Motebit surfaces. Re-exports @motebit/protocol.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -12,10 +12,10 @@
     }
   },
   "files": [
-    "dist/index.js",
-    "dist/index.js.map",
-    "dist/index.d.ts",
-    "dist/index.d.ts.map",
+    "dist/**/*.js",
+    "dist/**/*.js.map",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map",
     "LICENSE",
     "README.md"
   ],
@@ -45,6 +45,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "@motebit/protocol": "0.8.0"
+  },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "typescript": "^5.6.0",