@motebit/sdk 0.7.0 → 0.8.0

package/dist/__tests__/provider-resolver.test.js

@@ -0,0 +1,353 @@
+import { describe, it, expect } from "vitest";
+import { resolveProviderSpec, normalizeLocalServerEndpoint, defaultModelForVendor, canonicalVendorBaseUrl, GOOGLE_OPENAI_COMPAT_URL, DEFAULT_MOTEBIT_CLOUD_URL, UnsupportedBackendError, DEFAULT_PROXY_MODEL, DEFAULT_ANTHROPIC_MODEL, DEFAULT_OPENAI_MODEL, DEFAULT_GOOGLE_MODEL, DEFAULT_OLLAMA_MODEL, } from "../index";
+// === Test fixtures ===
+/**
+ * A maximally permissive env: every backend supported, no URL substitution,
+ * no motebit-cloud overrides. Specific tests override individual fields to
+ * exercise the surface-specific behaviors.
+ */
+function makeEnv(overrides = {}) {
+    return {
+        cloudBaseUrl: (_protocol, canonical) => canonical,
+        defaultLocalServerUrl: "http://127.0.0.1:11434",
+        supportedBackends: new Set(["webllm", "apple-fm", "mlx", "local-server"]),
+        ...overrides,
+    };
+}
+// === defaultModelForVendor ===
+describe("defaultModelForVendor", () => {
+    it("returns the default model for each vendor", () => {
+        expect(defaultModelForVendor("anthropic")).toBe(DEFAULT_ANTHROPIC_MODEL);
+        expect(defaultModelForVendor("openai")).toBe(DEFAULT_OPENAI_MODEL);
+        expect(defaultModelForVendor("google")).toBe(DEFAULT_GOOGLE_MODEL);
+    });
+});
+// === canonicalVendorBaseUrl ===
+describe("canonicalVendorBaseUrl", () => {
+    it("returns the canonical URL for each vendor", () => {
+        expect(canonicalVendorBaseUrl("anthropic")).toBe("https://api.anthropic.com");
+        expect(canonicalVendorBaseUrl("openai")).toBe("https://api.openai.com/v1");
+        expect(canonicalVendorBaseUrl("google")).toBe(GOOGLE_OPENAI_COMPAT_URL);
+    });
+});
+// === resolveProviderSpec — motebit-cloud mode ===
+describe("resolveProviderSpec — motebit-cloud", () => {
+    it("returns a cloud spec speaking the anthropic protocol", () => {
+        const spec = resolveProviderSpec({ mode: "motebit-cloud", model: "claude-sonnet-4-6", proxyToken: "tok-xxx" }, makeEnv());
+        expect(spec.kind).toBe("cloud");
+        if (spec.kind === "cloud") {
+            expect(spec.wireProtocol).toBe("anthropic");
+            expect(spec.apiKey).toBe(""); // relay injects
+            expect(spec.model).toBe("claude-sonnet-4-6");
+            expect(spec.extraHeaders).toEqual({ "x-proxy-token": "tok-xxx" });
+        }
+    });
+    it("falls back to DEFAULT_PROXY_MODEL when no model is specified", () => {
+        const spec = resolveProviderSpec({ mode: "motebit-cloud" }, makeEnv());
+        if (spec.kind === "cloud")
+            expect(spec.model).toBe(DEFAULT_PROXY_MODEL);
+    });
+    it("uses the env's motebitCloudBaseUrl when config.baseUrl is absent", () => {
+        const spec = resolveProviderSpec({ mode: "motebit-cloud" }, makeEnv({ motebitCloudBaseUrl: "https://staging.motebit.com" }));
+        if (spec.kind === "cloud")
+            expect(spec.baseUrl).toBe("https://staging.motebit.com");
+    });
+    it("config.baseUrl takes precedence over env.motebitCloudBaseUrl", () => {
+        const spec = resolveProviderSpec({ mode: "motebit-cloud", baseUrl: "https://override.example.com" }, makeEnv({ motebitCloudBaseUrl: "https://staging.motebit.com" }));
+        if (spec.kind === "cloud")
+            expect(spec.baseUrl).toBe("https://override.example.com");
+    });
+    it("defaults baseUrl to DEFAULT_MOTEBIT_CLOUD_URL when both absent", () => {
+        const spec = resolveProviderSpec({ mode: "motebit-cloud" }, makeEnv());
+        if (spec.kind === "cloud")
+            expect(spec.baseUrl).toBe(DEFAULT_MOTEBIT_CLOUD_URL);
+    });
+    it("merges config proxyToken with env motebitCloudHeaders", () => {
+        const spec = resolveProviderSpec({ mode: "motebit-cloud", proxyToken: "tok-config" }, makeEnv({ motebitCloudHeaders: { "x-trace-id": "abc" } }));
+        if (spec.kind === "cloud") {
+            expect(spec.extraHeaders).toEqual({
+                "x-proxy-token": "tok-config",
+                "x-trace-id": "abc",
+            });
+        }
+    });
+    it("propagates env headers when no proxy token is set", () => {
+        const spec = resolveProviderSpec({ mode: "motebit-cloud" }, makeEnv({ motebitCloudHeaders: { "x-session": "s1" } }));
+        if (spec.kind === "cloud")
+            expect(spec.extraHeaders).toEqual({ "x-session": "s1" });
+    });
+    it("uses env.motebitCloudDefaultModel before falling back to DEFAULT_PROXY_MODEL", () => {
+        const spec = resolveProviderSpec({ mode: "motebit-cloud" }, makeEnv({ motebitCloudDefaultModel: "claude-haiku-4-5-20251001" }));
+        if (spec.kind === "cloud")
+            expect(spec.model).toBe("claude-haiku-4-5-20251001");
+    });
+});
+// === resolveProviderSpec — byok mode ===
+describe("resolveProviderSpec — byok anthropic", () => {
+    it("returns a cloud spec speaking the anthropic protocol", () => {
+        const spec = resolveProviderSpec({ mode: "byok", vendor: "anthropic", apiKey: "sk-ant-xxx", model: "claude-opus-4-6" }, makeEnv());
+        expect(spec.kind).toBe("cloud");
+        if (spec.kind === "cloud") {
+            expect(spec.wireProtocol).toBe("anthropic");
+            expect(spec.apiKey).toBe("sk-ant-xxx");
+            expect(spec.model).toBe("claude-opus-4-6");
+            expect(spec.baseUrl).toBe("https://api.anthropic.com");
+        }
+    });
+    it("falls back to DEFAULT_ANTHROPIC_MODEL", () => {
+        const spec = resolveProviderSpec({ mode: "byok", vendor: "anthropic", apiKey: "sk-ant-xxx" }, makeEnv());
+        if (spec.kind === "cloud")
+            expect(spec.model).toBe(DEFAULT_ANTHROPIC_MODEL);
+    });
+    it("env.cloudBaseUrl can substitute the canonical URL (browser CORS proxy)", () => {
+        const spec = resolveProviderSpec({ mode: "byok", vendor: "anthropic", apiKey: "sk-ant-xxx" }, makeEnv({
+            cloudBaseUrl: (proto, canonical) => proto === "anthropic" ? "https://proxy.example.com" : canonical,
+        }));
+        if (spec.kind === "cloud")
+            expect(spec.baseUrl).toBe("https://proxy.example.com");
+    });
+    it("user-supplied baseUrl wins over canonical", () => {
+        const spec = resolveProviderSpec({
+            mode: "byok",
+            vendor: "anthropic",
+            apiKey: "sk-ant-xxx",
+            baseUrl: "https://my-anthropic-proxy.example.com",
+        }, makeEnv());
+        if (spec.kind === "cloud") {
+            expect(spec.baseUrl).toBe("https://my-anthropic-proxy.example.com");
+        }
+    });
+});
+describe("resolveProviderSpec — byok openai", () => {
+    it("returns a cloud spec speaking the openai protocol", () => {
+        const spec = resolveProviderSpec({ mode: "byok", vendor: "openai", apiKey: "sk-xxx", model: "gpt-5.4" }, makeEnv());
+        expect(spec.kind).toBe("cloud");
+        if (spec.kind === "cloud") {
+            expect(spec.wireProtocol).toBe("openai");
+            expect(spec.apiKey).toBe("sk-xxx");
+            expect(spec.baseUrl).toBe("https://api.openai.com/v1");
+        }
+    });
+    it("falls back to DEFAULT_OPENAI_MODEL", () => {
+        const spec = resolveProviderSpec({ mode: "byok", vendor: "openai", apiKey: "sk-xxx" }, makeEnv());
+        if (spec.kind === "cloud")
+            expect(spec.model).toBe(DEFAULT_OPENAI_MODEL);
+    });
+});
+describe("resolveProviderSpec — byok google", () => {
+    it("dispatches Google as openai-compat at the Google endpoint", () => {
+        const spec = resolveProviderSpec({ mode: "byok", vendor: "google", apiKey: "AIza-xxx", model: "gemini-2.5-pro" }, makeEnv());
+        expect(spec.kind).toBe("cloud");
+        if (spec.kind === "cloud") {
+            expect(spec.wireProtocol).toBe("openai");
+            expect(spec.apiKey).toBe("AIza-xxx");
+            expect(spec.baseUrl).toBe(GOOGLE_OPENAI_COMPAT_URL);
+        }
+    });
+    it("falls back to DEFAULT_GOOGLE_MODEL", () => {
+        const spec = resolveProviderSpec({ mode: "byok", vendor: "google", apiKey: "AIza-xxx" }, makeEnv());
+        if (spec.kind === "cloud")
+            expect(spec.model).toBe(DEFAULT_GOOGLE_MODEL);
+    });
+});
+// === resolveProviderSpec — on-device mode ===
+describe("resolveProviderSpec — on-device webllm", () => {
+    it("returns a webllm spec", () => {
+        const spec = resolveProviderSpec({ mode: "on-device", backend: "webllm", model: "Phi-3.5" }, makeEnv());
+        expect(spec.kind).toBe("webllm");
+        if (spec.kind === "webllm")
+            expect(spec.model).toBe("Phi-3.5");
+    });
+    it("falls back to DEFAULT_WEBLLM_MODEL", () => {
+        const spec = resolveProviderSpec({ mode: "on-device", backend: "webllm" }, makeEnv());
+        if (spec.kind === "webllm") {
+            expect(spec.model).toMatch(/Llama|Phi/);
+        }
+    });
+    it("throws when webllm is not supported on the surface", () => {
+        expect(() => resolveProviderSpec({ mode: "on-device", backend: "webllm" }, makeEnv({ supportedBackends: new Set(["local-server"]) }))).toThrow(UnsupportedBackendError);
+    });
+});
+describe("resolveProviderSpec — on-device apple-fm", () => {
+    it("returns an apple-fm spec", () => {
+        const spec = resolveProviderSpec({ mode: "on-device", backend: "apple-fm" }, makeEnv());
+        expect(spec.kind).toBe("apple-fm");
+    });
+    it("throws when apple-fm is not supported (web/desktop/cli)", () => {
+        expect(() => resolveProviderSpec({ mode: "on-device", backend: "apple-fm" }, makeEnv({ supportedBackends: new Set(["local-server"]) }))).toThrow(UnsupportedBackendError);
+    });
+});
+describe("resolveProviderSpec — on-device mlx", () => {
+    it("returns an mlx spec", () => {
+        const spec = resolveProviderSpec({ mode: "on-device", backend: "mlx", model: "mlx-llama-3-8b" }, makeEnv());
+        expect(spec.kind).toBe("mlx");
+        if (spec.kind === "mlx")
+            expect(spec.model).toBe("mlx-llama-3-8b");
+    });
+});
+describe("resolveProviderSpec — on-device local-server (always OpenAI-compat)", () => {
+    it("dispatches Ollama as OpenAI-compat with /v1 appended", () => {
+        const spec = resolveProviderSpec({
+            mode: "on-device",
+            backend: "local-server",
+            endpoint: "http://localhost:11434",
+            model: "llama3.2",
+        }, makeEnv());
+        expect(spec.kind).toBe("cloud");
+        if (spec.kind === "cloud") {
+            expect(spec.wireProtocol).toBe("openai");
+            expect(spec.baseUrl).toBe("http://localhost:11434/v1");
+            expect(spec.model).toBe("llama3.2");
+            expect(spec.apiKey).toBe("local"); // sentinel for local servers
+        }
+    });
+    it("dispatches LM Studio (port 1234) as OpenAI-compat with /v1", () => {
+        const spec = resolveProviderSpec({
+            mode: "on-device",
+            backend: "local-server",
+            endpoint: "http://localhost:1234",
+            model: "phi-3",
+        }, makeEnv());
+        expect(spec.kind).toBe("cloud");
+        if (spec.kind === "cloud") {
+            expect(spec.wireProtocol).toBe("openai");
+            expect(spec.baseUrl).toBe("http://localhost:1234/v1");
+            expect(spec.model).toBe("phi-3");
+        }
+    });
+    it("dispatches llama.cpp (port 8080) as OpenAI-compat", () => {
+        const spec = resolveProviderSpec({ mode: "on-device", backend: "local-server", endpoint: "http://localhost:8080" }, makeEnv());
+        expect(spec.kind).toBe("cloud");
+        if (spec.kind === "cloud")
+            expect(spec.baseUrl).toBe("http://localhost:8080/v1");
+    });
+    it("dispatches Jan (port 1337) as OpenAI-compat", () => {
+        const spec = resolveProviderSpec({ mode: "on-device", backend: "local-server", endpoint: "http://localhost:1337" }, makeEnv());
+        expect(spec.kind).toBe("cloud");
+        if (spec.kind === "cloud")
+            expect(spec.baseUrl).toBe("http://localhost:1337/v1");
+    });
+    it("does not double-append /v1 when the user already includes it", () => {
+        const spec = resolveProviderSpec({ mode: "on-device", backend: "local-server", endpoint: "http://localhost:11434/v1" }, makeEnv());
+        if (spec.kind === "cloud")
+            expect(spec.baseUrl).toBe("http://localhost:11434/v1");
+    });
+    it("falls back to env.defaultLocalServerUrl when no endpoint specified", () => {
+        const spec = resolveProviderSpec({ mode: "on-device", backend: "local-server" }, makeEnv({ defaultLocalServerUrl: "http://192.168.1.50:11434" }));
+        expect(spec.kind).toBe("cloud");
+        if (spec.kind === "cloud")
+            expect(spec.baseUrl).toBe("http://192.168.1.50:11434/v1");
+    });
+    it("preserves LAN endpoints (not just localhost)", () => {
+        const spec = resolveProviderSpec({
+            mode: "on-device",
+            backend: "local-server",
+            endpoint: "http://192.168.1.42:11434",
+        }, makeEnv());
+        if (spec.kind === "cloud") {
+            expect(spec.baseUrl).toBe("http://192.168.1.42:11434/v1");
+        }
+    });
+    it("falls back to DEFAULT_OLLAMA_MODEL when no model specified", () => {
+        const spec = resolveProviderSpec({ mode: "on-device", backend: "local-server", endpoint: "http://localhost:11434" }, makeEnv());
+        if (spec.kind === "cloud")
+            expect(spec.model).toBe(DEFAULT_OLLAMA_MODEL);
+    });
+    it("env.localServerBaseUrl substitution applied before /v1 normalization", () => {
+        // Desktop dev-mode pattern: env rewrites the endpoint to a Vite proxy
+        // path. The resolver still appends /v1 to that path so the upstream
+        // proxy delivers requests to {ollama}/v1/chat/completions.
+        const spec = resolveProviderSpec({ mode: "on-device", backend: "local-server", model: "llama3.2" }, makeEnv({
+            defaultLocalServerUrl: "http://127.0.0.1:11434",
+            localServerBaseUrl: () => "/api/ollama",
+        }));
+        expect(spec.kind).toBe("cloud");
+        if (spec.kind === "cloud") {
+            expect(spec.wireProtocol).toBe("openai");
+            expect(spec.baseUrl).toBe("/api/ollama/v1");
+            expect(spec.model).toBe("llama3.2");
+        }
+    });
+});
+describe("normalizeLocalServerEndpoint", () => {
+    it("appends /v1 to a bare host", () => {
+        expect(normalizeLocalServerEndpoint("http://localhost:11434")).toBe("http://localhost:11434/v1");
+    });
+    it("strips trailing slash before appending", () => {
+        expect(normalizeLocalServerEndpoint("http://localhost:11434/")).toBe("http://localhost:11434/v1");
+    });
+    it("is idempotent — preserves existing /v1", () => {
+        expect(normalizeLocalServerEndpoint("http://localhost:11434/v1")).toBe("http://localhost:11434/v1");
+        expect(normalizeLocalServerEndpoint("http://localhost:11434/v1/")).toBe("http://localhost:11434/v1");
+    });
+    it("preserves longer /v1 paths", () => {
+        expect(normalizeLocalServerEndpoint("https://generativelanguage.googleapis.com/v1beta/openai")).toBe("https://generativelanguage.googleapis.com/v1beta/openai/v1");
+        // Note: Google's URL is special — surfaces should pass it untransformed,
+        // not through this normalizer. The normalizer is for local-server only.
+    });
+    it("works on dev proxy paths", () => {
+        expect(normalizeLocalServerEndpoint("/api/ollama")).toBe("/api/ollama/v1");
+    });
+});
+// === Realistic per-surface env scenarios (integration smoke tests) ===
+describe("resolveProviderSpec — surface scenarios", () => {
+    it("web env: anthropic byok routes through CORS proxy", () => {
+        const webEnv = {
+            cloudBaseUrl: (proto, canonical) => proto === "anthropic" ? "https://api.motebit.com" : canonical,
+            defaultLocalServerUrl: "http://127.0.0.1:11434",
+            supportedBackends: new Set(["webllm", "local-server"]),
+        };
+        const spec = resolveProviderSpec({ mode: "byok", vendor: "anthropic", apiKey: "sk-ant-xxx" }, webEnv);
+        if (spec.kind === "cloud") {
+            expect(spec.baseUrl).toBe("https://api.motebit.com");
+        }
+    });
+    it("desktop dev env: anthropic byok goes through Vite proxy path", () => {
+        const desktopDevEnv = {
+            cloudBaseUrl: (proto) => (proto === "anthropic" ? "/api/anthropic" : "/api/openai"),
+            defaultLocalServerUrl: "/api/ollama",
+            supportedBackends: new Set(["local-server"]),
+        };
+        const spec = resolveProviderSpec({ mode: "byok", vendor: "anthropic", apiKey: "sk-ant-xxx" }, desktopDevEnv);
+        if (spec.kind === "cloud")
+            expect(spec.baseUrl).toBe("/api/anthropic");
+    });
+    it("mobile env: apple-fm allowed, webllm blocked", () => {
+        const mobileEnv = {
+            cloudBaseUrl: (_, canonical) => canonical,
+            defaultLocalServerUrl: "http://127.0.0.1:11434",
+            supportedBackends: new Set(["apple-fm", "mlx", "local-server"]),
+        };
+        expect(resolveProviderSpec({ mode: "on-device", backend: "apple-fm" }, mobileEnv).kind).toBe("apple-fm");
+        expect(() => resolveProviderSpec({ mode: "on-device", backend: "webllm" }, mobileEnv)).toThrow(UnsupportedBackendError);
+    });
+    it("cli env: only local-server backend, no on-device native", () => {
+        const cliEnv = {
+            cloudBaseUrl: (_, canonical) => canonical,
+            defaultLocalServerUrl: "http://127.0.0.1:11434",
+            supportedBackends: new Set(["local-server"]),
+        };
+        expect(() => resolveProviderSpec({ mode: "on-device", backend: "apple-fm" }, cliEnv)).toThrow(UnsupportedBackendError);
+        expect(() => resolveProviderSpec({ mode: "on-device", backend: "webllm" }, cliEnv)).toThrow(UnsupportedBackendError);
+        expect(resolveProviderSpec({ mode: "on-device", backend: "local-server", endpoint: "http://localhost:11434" }, cliEnv).kind).toBe("cloud");
+    });
+});
+// === Type-level invariants (compile-time) ===
+describe("type invariants", () => {
+    it("UnifiedProviderConfig accepts every combination", () => {
+        // This is a compile-time check; the runtime body is just a sanity assertion.
+        const configs = [
+            { mode: "motebit-cloud" },
+            { mode: "motebit-cloud", model: "x", proxyToken: "y" },
+            { mode: "byok", vendor: "anthropic", apiKey: "k" },
+            { mode: "byok", vendor: "openai", apiKey: "k" },
+            { mode: "byok", vendor: "google", apiKey: "k" },
+            { mode: "on-device", backend: "webllm" },
+            { mode: "on-device", backend: "apple-fm" },
+            { mode: "on-device", backend: "mlx" },
+            { mode: "on-device", backend: "local-server" },
+        ];
+        expect(configs.length).toBe(9);
+    });
+});
+//# sourceMappingURL=provider-resolver.test.js.map

package/dist/__tests__/provider-resolver.test.js.map

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

package/dist/__tests__/voice-config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=voice-config.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voice-config.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/voice-config.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/voice-config.test.js

@@ -0,0 +1,98 @@
+import { describe, it, expect } from "vitest";
+import { DEFAULT_VOICE_CONFIG, migrateVoiceConfig } from "../voice-config.js";
+describe("migrateVoiceConfig", () => {
+    it("returns a fresh default when input is null", () => {
+        const result = migrateVoiceConfig(null);
+        expect(result).toEqual(DEFAULT_VOICE_CONFIG);
+        // fresh copy, not the frozen default reference
+        expect(result).not.toBe(DEFAULT_VOICE_CONFIG);
+    });
+    it("returns a fresh default when input is undefined", () => {
+        expect(migrateVoiceConfig(undefined)).toEqual(DEFAULT_VOICE_CONFIG);
+    });
+    it("returns a fresh default when input is a primitive", () => {
+        expect(migrateVoiceConfig("not an object")).toEqual(DEFAULT_VOICE_CONFIG);
+        expect(migrateVoiceConfig(42)).toEqual(DEFAULT_VOICE_CONFIG);
+        expect(migrateVoiceConfig(true)).toEqual(DEFAULT_VOICE_CONFIG);
+    });
+    it("normalizes the canonical shape as-is", () => {
+        const input = {
+            enabled: true,
+            autoSend: false,
+            speakResponses: true,
+            ttsVoice: "nova",
+            neuralVad: false,
+        };
+        expect(migrateVoiceConfig(input)).toEqual(input);
+    });
+    it("migrates the web legacy shape {ttsVoice, autoSend, voiceResponse}", () => {
+        const result = migrateVoiceConfig({
+            ttsVoice: "echo",
+            autoSend: false,
+            voiceResponse: false,
+        });
+        expect(result.ttsVoice).toBe("echo");
+        expect(result.autoSend).toBe(false);
+        expect(result.speakResponses).toBe(false);
+        // `enabled` and `neuralVad` absent → defaults
+        expect(result.enabled).toBe(DEFAULT_VOICE_CONFIG.enabled);
+    });
+    it("migrates the mobile legacy shape with voiceEnabled + voiceAutoSend + voiceResponseEnabled + neuralVadEnabled", () => {
+        const result = migrateVoiceConfig({
+            voiceEnabled: true,
+            voiceAutoSend: true,
+            voiceResponseEnabled: true,
+            neuralVadEnabled: false,
+            ttsVoice: "fable",
+        });
+        expect(result).toEqual({
+            enabled: true,
+            autoSend: true,
+            speakResponses: true,
+            ttsVoice: "fable",
+            neuralVad: false,
+        });
+    });
+    it("migrates the desktop legacy shape {ttsVoice, voiceAutoSend, voiceResponseEnabled}", () => {
+        const result = migrateVoiceConfig({
+            ttsVoice: "onyx",
+            voiceAutoSend: false,
+            voiceResponseEnabled: true,
+        });
+        expect(result.ttsVoice).toBe("onyx");
+        expect(result.autoSend).toBe(false);
+        expect(result.speakResponses).toBe(true);
+    });
+    it("prefers the canonical key when both canonical and legacy keys are present", () => {
+        const result = migrateVoiceConfig({
+            enabled: true,
+            voiceEnabled: false,
+            speakResponses: true,
+            voiceResponseEnabled: false,
+        });
+        expect(result.enabled).toBe(true);
+        expect(result.speakResponses).toBe(true);
+    });
+    it("falls back to default when a field has the wrong type", () => {
+        const result = migrateVoiceConfig({
+            enabled: "yes", // wrong type
+            ttsVoice: 42, // wrong type
+        });
+        expect(result.enabled).toBe(DEFAULT_VOICE_CONFIG.enabled);
+        expect(result.ttsVoice).toBe(DEFAULT_VOICE_CONFIG.ttsVoice);
+    });
+    it("leaves neuralVad undefined when not provided (opt-in)", () => {
+        const result = migrateVoiceConfig({ enabled: true });
+        expect(result.neuralVad).toBeUndefined();
+    });
+    it("ignores unknown keys", () => {
+        const result = migrateVoiceConfig({
+            enabled: true,
+            foo: "bar",
+            baz: [1, 2, 3],
+        });
+        expect(result).not.toHaveProperty("foo");
+        expect(result).not.toHaveProperty("baz");
+    });
+});
+//# sourceMappingURL=voice-config.test.js.map

package/dist/__tests__/voice-config.test.js.map

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

package/dist/appearance-config.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Canonical appearance / theme configuration shape.
+ *
+ * Every surface (web, mobile, desktop, spatial) has historically carried its
+ * own appearance config — with drifted field names (`preset` vs
+ * `colorPreset`, web's `SoulColorConfig` vs mobile's flat fields vs
+ * desktop's Tauri snake_case `interior_color_preset` + `custom_soul_color`)
+ * 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 `AppearanceConfig`.
+ *
+ * Migration helpers are provided for the legacy shapes so each surface can
+ * normalize on load without inventing its own migration one-offs.
+ */
+/**
+ * The canonical appearance configuration. Narrow, descriptive, surface-agnostic.
+ *
+ * - `colorPreset`: opaque preset identifier — the specific string space depends
+ *   on the surface (`"moonlight"`, `"amber"`, `"rose"`, …) plus the special
+ *   value `"custom"` which means "render from `customHue` + `customSaturation`".
+ * - `customHue`: 0-360, only meaningful when `colorPreset === "custom"`.
+ * - `customSaturation`: 0-1, only meaningful when `colorPreset === "custom"`.
+ * - `theme`: master light/dark/system theme. Optional because some surfaces
+ *   (web, spatial) derive it from the OS without exposing a setting.
+ */
+export interface AppearanceConfig {
+    colorPreset: string;
+    customHue?: number;
+    customSaturation?: number;
+    theme?: "light" | "dark" | "system";
+}
+/** Default appearance — moonlight preset, no custom override, system theme. */
+export declare const DEFAULT_APPEARANCE_CONFIG: AppearanceConfig;
+/**
+ * Normalize any of the historical surface-specific appearance shapes onto
+ * the canonical `AppearanceConfig`. Unknown fields are ignored. Missing
+ * fields fall back to `DEFAULT_APPEARANCE_CONFIG`.
+ *
+ * Accepted legacy keys:
+ *   - web:     `{preset, customHue?, customSaturation?}` (the field is
+ *              `preset`, not `colorPreset`, in `SoulColorConfig`).
+ *   - mobile:  `{colorPreset, customHue, customSaturation, theme}` flat
+ *              on `MobileSettings`.
+ *   - desktop: `{interior_color_preset, custom_soul_color: {hue, saturation}}`
+ *              snake_case in the Tauri JSON config.
+ *   - spatial: `{colorPreset, customHue, customSaturation}` flat on
+ *              `SpatialSettings`.
+ *
+ * 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 migrateAppearanceConfig(raw: unknown): AppearanceConfig;
+//# sourceMappingURL=appearance-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"appearance-config.d.ts","sourceRoot":"","sources":["../src/appearance-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;CACrC;AAED,+EAA+E;AAC/E,eAAO,MAAM,yBAAyB,EAAE,gBAKvC,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAwCtE"}

package/dist/appearance-config.js

@@ -0,0 +1,79 @@
+/**
+ * Canonical appearance / theme configuration shape.
+ *
+ * Every surface (web, mobile, desktop, spatial) has historically carried its
+ * own appearance config — with drifted field names (`preset` vs
+ * `colorPreset`, web's `SoulColorConfig` vs mobile's flat fields vs
+ * desktop's Tauri snake_case `interior_color_preset` + `custom_soul_color`)
+ * 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 `AppearanceConfig`.
+ *
+ * Migration helpers are provided for the legacy shapes so each surface can
+ * normalize on load without inventing its own migration one-offs.
+ */
+/** Default appearance — moonlight preset, no custom override, system theme. */
+export const DEFAULT_APPEARANCE_CONFIG = {
+    colorPreset: "moonlight",
+    customHue: 220,
+    customSaturation: 0.7,
+    theme: "system",
+};
+/**
+ * Normalize any of the historical surface-specific appearance shapes onto
+ * the canonical `AppearanceConfig`. Unknown fields are ignored. Missing
+ * fields fall back to `DEFAULT_APPEARANCE_CONFIG`.
+ *
+ * Accepted legacy keys:
+ *   - web:     `{preset, customHue?, customSaturation?}` (the field is
+ *              `preset`, not `colorPreset`, in `SoulColorConfig`).
+ *   - mobile:  `{colorPreset, customHue, customSaturation, theme}` flat
+ *              on `MobileSettings`.
+ *   - desktop: `{interior_color_preset, custom_soul_color: {hue, saturation}}`
+ *              snake_case in the Tauri JSON config.
+ *   - spatial: `{colorPreset, customHue, customSaturation}` flat on
+ *              `SpatialSettings`.
+ *
+ * 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 migrateAppearanceConfig(raw) {
+    if (raw == null || typeof raw !== "object")
+        return { ...DEFAULT_APPEARANCE_CONFIG };
+    const obj = raw;
+    const isStr = (v) => typeof v === "string";
+    const isNum = (v) => typeof v === "number";
+    // Color preset: prefer canonical `colorPreset`, fall back to web's
+    // legacy `preset`, then desktop's snake_case `interior_color_preset`.
+    const colorPreset = (isStr(obj.colorPreset) ? obj.colorPreset : undefined) ??
+        (isStr(obj.preset) ? obj.preset : undefined) ??
+        (isStr(obj.interior_color_preset) ? obj.interior_color_preset : undefined) ??
+        DEFAULT_APPEARANCE_CONFIG.colorPreset;
+    // Custom hue/saturation: canonical first, then desktop's nested
+    // `custom_soul_color: {hue, saturation}` shape.
+    let customHue;
+    let customSaturation;
+    if (isNum(obj.customHue))
+        customHue = obj.customHue;
+    if (isNum(obj.customSaturation))
+        customSaturation = obj.customSaturation;
+    const desktopCustom = obj.custom_soul_color;
+    if (customHue === undefined && desktopCustom != null && isNum(desktopCustom.hue)) {
+        customHue = desktopCustom.hue;
+    }
+    if (customSaturation === undefined && desktopCustom != null && isNum(desktopCustom.saturation)) {
+        customSaturation = desktopCustom.saturation;
+    }
+    // Theme: canonical key only — no surface uses an alternative name.
+    const themeRaw = obj.theme;
+    const theme = themeRaw === "light" || themeRaw === "dark" || themeRaw === "system" ? themeRaw : undefined;
+    return {
+        colorPreset,
+        customHue: customHue ?? DEFAULT_APPEARANCE_CONFIG.customHue,
+        customSaturation: customSaturation ?? DEFAULT_APPEARANCE_CONFIG.customSaturation,
+        theme: theme ?? DEFAULT_APPEARANCE_CONFIG.theme,
+    };
+}
+//# sourceMappingURL=appearance-config.js.map