@motebit/sdk 0.7.0 → 0.8.0

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.7.0",
-  "description": "Motebit types — protocol (re-exported) + product (state vectors, behavior, rendering, memory graph, AI provider). Zero-dep type vocabulary for the motebit ecosystem.",
+  "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/*.js",
-    "dist/*.js.map",
-    "dist/*.d.ts",
-    "dist/*.d.ts.map",
+    "dist/**/*.js",
+    "dist/**/*.js.map",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map",
     "LICENSE",
     "README.md"
   ],
@@ -46,7 +46,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@motebit/protocol": "0.7.0"
+    "@motebit/protocol": "0.8.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",