@motebit/sdk 0.6.11 → 0.8.0

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

package/dist/appearance-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appearance-config.js","sourceRoot":"","sources":["../src/appearance-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAoBH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD,WAAW,EAAE,WAAW;IACxB,SAAS,EAAE,GAAG;IACd,gBAAgB,EAAE,GAAG;IACrB,KAAK,EAAE,QAAQ;CAChB,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAY;IAClD,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,EAAE,GAAG,yBAAyB,EAAE,CAAC;IACpF,MAAM,GAAG,GAAG,GAA8B,CAAC;IAE3C,MAAM,KAAK,GAAG,CAAC,CAAU,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;IACjE,MAAM,KAAK,GAAG,CAAC,CAAU,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;IAEjE,mEAAmE;IACnE,sEAAsE;IACtE,MAAM,WAAW,GACf,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;QACtD,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5C,CAAC,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,yBAAyB,CAAC,WAAW,CAAC;IAExC,gEAAgE;IAChE,gDAAgD;IAChD,IAAI,SAA6B,CAAC;IAClC,IAAI,gBAAoC,CAAC;IACzC,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;IACpD,IAAI,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC;QAAE,gBAAgB,GAAG,GAAG,CAAC,gBAAgB,CAAC;IACzE,MAAM,aAAa,GAAG,GAAG,CAAC,iBAAsE,CAAC;IACjG,IAAI,SAAS,KAAK,SAAS,IAAI,aAAa,IAAI,IAAI,IAAI,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QACjF,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC;IAChC,CAAC;IACD,IAAI,gBAAgB,KAAK,SAAS,IAAI,aAAa,IAAI,IAAI,IAAI,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/F,gBAAgB,GAAG,aAAa,CAAC,UAAU,CAAC;IAC9C,CAAC;IAED,mEAAmE;IACnE,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC;IAC3B,MAAM,KAAK,GACT,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAE9F,OAAO;QACL,WAAW;QACX,SAAS,EAAE,SAAS,IAAI,yBAAyB,CAAC,SAAS;QAC3D,gBAAgB,EAAE,gBAAgB,IAAI,yBAAyB,CAAC,gBAAgB;QAChF,KAAK,EAAE,KAAK,IAAI,yBAAyB,CAAC,KAAK;KAChD,CAAC;AACJ,CAAC"}

package/dist/approval-presets.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared approval presets for tool governance.
+ *
+ * Canonical source — imported by all surfaces (web, desktop, mobile).
+ * Each preset defines the risk thresholds for automatic tool approval.
+ */
+export type ApprovalPreset = "cautious" | "balanced" | "autonomous";
+export interface ApprovalPresetConfig {
+    label: string;
+    description: string;
+    maxRiskLevel: number;
+    requireApprovalAbove: number;
+    denyAbove: number;
+}
+export declare const APPROVAL_PRESET_CONFIGS: Record<string, ApprovalPresetConfig>;
+//# sourceMappingURL=approval-presets.d.ts.map

package/dist/approval-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-presets.d.ts","sourceRoot":"","sources":["../src/approval-presets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;AAEpE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAsBxE,CAAC"}

package/dist/approval-presets.js

@@ -0,0 +1,30 @@
+/**
+ * Shared approval presets for tool governance.
+ *
+ * Canonical source — imported by all surfaces (web, desktop, mobile).
+ * Each preset defines the risk thresholds for automatic tool approval.
+ */
+export const APPROVAL_PRESET_CONFIGS = {
+    cautious: {
+        label: "Cautious",
+        description: "Approve everything above read-only",
+        maxRiskLevel: 3,
+        requireApprovalAbove: 0,
+        denyAbove: 3,
+    },
+    balanced: {
+        label: "Balanced",
+        description: "Auto-allow low risk, approve medium",
+        maxRiskLevel: 3,
+        requireApprovalAbove: 1,
+        denyAbove: 3,
+    },
+    autonomous: {
+        label: "Autonomous",
+        description: "Auto-allow most, deny only dangerous",
+        maxRiskLevel: 4,
+        requireApprovalAbove: 3,
+        denyAbove: 4,
+    },
+};
+//# sourceMappingURL=approval-presets.js.map

package/dist/approval-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-presets.js","sourceRoot":"","sources":["../src/approval-presets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,CAAC,MAAM,uBAAuB,GAAyC;IAC3E,QAAQ,EAAE;QACR,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,oCAAoC;QACjD,YAAY,EAAE,CAAC;QACf,oBAAoB,EAAE,CAAC;QACvB,SAAS,EAAE,CAAC;KACb;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,qCAAqC;QAClD,YAAY,EAAE,CAAC;QACf,oBAAoB,EAAE,CAAC;QACvB,SAAS,EAAE,CAAC;KACb;IACD,UAAU,EAAE;QACV,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,sCAAsC;QACnD,YAAY,EAAE,CAAC;QACf,oBAAoB,EAAE,CAAC;QACvB,SAAS,EAAE,CAAC;KACb;CACF,CAAC"}

package/dist/color-presets.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared color presets for the creature's interior.
+ *
+ * Canonical source — imported by all surfaces (web, desktop, mobile, spatial).
+ * The InteriorColor shape matches @motebit/render-engine but is defined inline
+ * here so the SDK stays Layer 0 with zero non-protocol deps.
+ */
+/** Interior color of the droplet creature — tint (glass absorption) + glow (emissive). */
+export interface InteriorColor {
+    tint: [number, number, number];
+    glow: [number, number, number];
+}
+export declare const COLOR_PRESETS: Record<string, InteriorColor>;
+//# sourceMappingURL=color-presets.d.ts.map

package/dist/color-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-presets.d.ts","sourceRoot":"","sources":["../src/color-presets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,0FAA0F;AAC1F,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAQvD,CAAC"}

package/dist/color-presets.js

@@ -0,0 +1,17 @@
+/**
+ * Shared color presets for the creature's interior.
+ *
+ * Canonical source — imported by all surfaces (web, desktop, mobile, spatial).
+ * The InteriorColor shape matches @motebit/render-engine but is defined inline
+ * here so the SDK stays Layer 0 with zero non-protocol deps.
+ */
+export const COLOR_PRESETS = {
+    moonlight: { tint: [0.95, 0.95, 1.0], glow: [0.8, 0.85, 1.0] },
+    amber: { tint: [1.0, 0.85, 0.6], glow: [0.9, 0.7, 0.3] },
+    rose: { tint: [1.0, 0.82, 0.88], glow: [0.9, 0.5, 0.6] },
+    violet: { tint: [0.88, 0.8, 1.0], glow: [0.6, 0.4, 0.9] },
+    cyan: { tint: [0.8, 0.95, 1.0], glow: [0.3, 0.8, 0.9] },
+    ember: { tint: [1.0, 0.75, 0.65], glow: [0.9, 0.35, 0.2] },
+    sage: { tint: [0.82, 0.95, 0.85], glow: [0.4, 0.75, 0.5] },
+};
+//# sourceMappingURL=color-presets.js.map

package/dist/color-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-presets.js","sourceRoot":"","sources":["../src/color-presets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,CAAC,MAAM,aAAa,GAAkC;IAC1D,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE;IAC9D,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;IACxD,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;IACxD,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;IACzD,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;IACvD,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE;IAC1D,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE;CAC3D,CAAC"}

package/dist/credential-types-doc.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @fileoverview Credential-shaped type family (documentation module).
+ *
+ * The monorepo has four "Credential/Verifier"-shaped types that are easy to
+ * confuse at a glance but are deliberately distinct. They are complementary,
+ * not duplicates. Each addresses a different side of the trust boundary.
+ *
+ * Naming convention:
+ *   - `Source`   → supplies a credential (outbound)
+ *   - `Verifier` → checks something (identity of a remote, or validity of a token)
+ *   - `Adapter`  → persistent storage
+ *
+ * ──────────────────────────────────────────────────────────────────────────
+ * 1. CredentialSource  (OUTBOUND — supply)
+ *    Location: `@motebit/mcp-client`
+ *    Shape:    `getCredential(CredentialRequest) → string | null`
+ *    Role:     Per-call credential supplier used when WE call a third-party
+ *              MCP server. Resolved per HTTP request via custom `fetch`
+ *              injection so per-tool, per-scope credentials are possible.
+ *    Known implementations:
+ *      - StaticCredentialSource   (wraps a static bearer token)
+ *      - KeyringCredentialSource  (reads from OS keyring per call)
+ *      - VaultCredentialSource    (reads from an external vault per call)
+ *      - OAuthCredentialSource    (OAuth 2.0 lifecycle with refresh-ahead)
+ *
+ * ──────────────────────────────────────────────────────────────────────────
+ * 2. ServerVerifier  (OUTBOUND — check remote identity)
+ *    Location: `@motebit/mcp-client`
+ *    Shape:    `verify(config, tools) → VerificationResult`
+ *    Role:     Verifies the identity / integrity of a third-party MCP server
+ *              we are connecting TO. Runs automatically during `connect()`
+ *              after tool discovery. Fail-closed.
+ *    Known implementations:
+ *      - ManifestPinningVerifier   (fail-closed on manifest change)
+ *      - AdvisoryManifestVerifier  (accepts, revokes trust on change)
+ *      - TlsCertificateVerifier    (pins TLS cert SHA-256 fingerprint)
+ *      - CompositeServerVerifier   (chains multiple verifiers)
+ *
+ * ──────────────────────────────────────────────────────────────────────────
+ * 3. InboundCredentialVerifier  (INBOUND — check presented token)
+ *    Location: `@motebit/mcp-server`
+ *    Shape:    `verify(token: string) → Promise<boolean>`
+ *    Role:     Checks inbound non-motebit bearer tokens when WE ARE the MCP
+ *              server and a third party is calling us. Motebit-to-motebit
+ *              signed-token auth is a separate, untouched path.
+ *    Known implementations:
+ *      - StaticTokenVerifier  (constant-string comparison)
+ *
+ *    (Previously named `CredentialVerifier` — renamed to make the direction
+ *    explicit and avoid collision with the two outbound types above.)
+ *
+ * ──────────────────────────────────────────────────────────────────────────
+ * 4. CredentialStoreAdapter  (STORAGE — persist)
+ *    Location: `@motebit/protocol`
+ *    Role:     Persistent credential storage. The "where credentials live
+ *              at rest" boundary — separate from how they are supplied on
+ *              the wire (CredentialSource) or how tokens are checked at
+ *              either end (ServerVerifier / InboundCredentialVerifier).
+ *
+ * ──────────────────────────────────────────────────────────────────────────
+ * Quick mental model:
+ *
+ *                 WE CALL OUT                WE ARE CALLED
+ *                 ───────────                ─────────────
+ *   Supply        CredentialSource           —
+ *   Check peer    ServerVerifier             InboundCredentialVerifier
+ *   Store         CredentialStoreAdapter     CredentialStoreAdapter
+ *
+ * If you find yourself reaching for "CredentialVerifier" without a direction
+ * qualifier, stop and pick the specific type above.
+ */
+export {};
+//# sourceMappingURL=credential-types-doc.d.ts.map

package/dist/credential-types-doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-types-doc.d.ts","sourceRoot":"","sources":["../src/credential-types-doc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AACH,OAAO,EAAE,CAAC"}

package/dist/credential-types-doc.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=credential-types-doc.js.map

package/dist/credential-types-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-types-doc.js","sourceRoot":"","sources":["../src/credential-types-doc.ts"],"names":[],"mappings":""}

package/dist/governance-config.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared governance configuration schema.
+ *
+ * Canonical source — imported by surfaces that persist governance settings.
+ * Platform-specific persistence (localStorage, Tauri, AsyncStorage) stays in each app.
+ */
+import type { ApprovalPreset } from "./approval-presets.js";
+export interface GovernanceConfig {
+    approvalPreset: ApprovalPreset;
+    persistenceThreshold: number;
+    rejectSecrets: boolean;
+    /** Max tool calls in a single agentic turn. */
+    maxCallsPerTurn: number;
+    /** Max memories the MemoryGovernor will persist in a single turn. */
+    maxMemoriesPerTurn: number;
+}
+/** Default governance config — matches `DEFAULT_MEMORY_GOVERNANCE` in policy. */
+export declare const DEFAULT_GOVERNANCE_CONFIG: GovernanceConfig;
+//# sourceMappingURL=governance-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"governance-config.d.ts","sourceRoot":"","sources":["../src/governance-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,iFAAiF;AACjF,eAAO,MAAM,yBAAyB,EAAE,gBAMvC,CAAC"}

package/dist/governance-config.js

@@ -0,0 +1,15 @@
+/**
+ * Shared governance configuration schema.
+ *
+ * Canonical source — imported by surfaces that persist governance settings.
+ * Platform-specific persistence (localStorage, Tauri, AsyncStorage) stays in each app.
+ */
+/** Default governance config — matches `DEFAULT_MEMORY_GOVERNANCE` in policy. */
+export const DEFAULT_GOVERNANCE_CONFIG = {
+    approvalPreset: "balanced",
+    persistenceThreshold: 0.5,
+    rejectSecrets: true,
+    maxCallsPerTurn: 10,
+    maxMemoriesPerTurn: 5,
+};
+//# sourceMappingURL=governance-config.js.map

package/dist/governance-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance-config.js","sourceRoot":"","sources":["../src/governance-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,iFAAiF;AACjF,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD,cAAc,EAAE,UAAU;IAC1B,oBAAoB,EAAE,GAAG;IACzB,aAAa,EAAE,IAAI;IACnB,eAAe,EAAE,EAAE;IACnB,kBAAkB,EAAE,CAAC;CACtB,CAAC"}