@elizaos/shared 2.0.0-alpha.144

package/runtime-env.d.ts

@@ -0,0 +1,82 @@
+export declare const DEFAULT_SERVER_ONLY_PORT = 2138;
+export declare const DEFAULT_DESKTOP_API_PORT = 31337;
+export declare const DEFAULT_DESKTOP_UI_PORT = 2138;
+export type RuntimeEnvRecord = Record<string, string | undefined>;
+export interface ResolvedRuntimePorts {
+    serverOnlyPort: number;
+    desktopApiPort: number;
+    desktopUiPort: number;
+}
+export interface ResolvedApiSecurityConfig {
+    bindHost: string;
+    token: string | null;
+    disableAutoApiToken: boolean;
+    allowedOrigins: string[];
+    allowedHosts: string[];
+    allowNullOrigin: boolean;
+    isLoopbackBind: boolean;
+    isWildcardBind: boolean;
+}
+export interface ElizaRuntimeEnv {
+    apiBind: string;
+    apiToken: string | undefined;
+    allowedOrigins: string[];
+    allowedHosts: string[];
+    allowNullOrigin: boolean;
+    disableAutoApiToken: boolean;
+    desktopApiPort: number;
+    singleProcessPort: number;
+    uiPort: number;
+}
+export declare const ELIZA_RUNTIME_ENV_KEYS: {
+    readonly apiBind: readonly ["ELIZA_API_BIND"];
+    readonly apiToken: readonly ["ELIZA_API_TOKEN"];
+    readonly allowedOrigins: readonly ["ELIZA_ALLOWED_ORIGINS", "CORS_ORIGINS"];
+    readonly allowedHosts: readonly ["ELIZA_ALLOWED_HOSTS"];
+    readonly allowNullOrigin: readonly ["ELIZA_ALLOW_NULL_ORIGIN"];
+    readonly disableAutoApiToken: readonly ["ELIZA_DISABLE_AUTO_API_TOKEN"];
+    readonly desktopApiPort: readonly ["ELIZA_API_PORT", "ELIZA_PORT"];
+    readonly singleProcessPort: readonly ["ELIZA_PORT", "ELIZA_UI_PORT"];
+    readonly desktopUiPort: readonly ["ELIZA_UI_PORT"];
+};
+/** First key in `keys` with a non-empty trimmed string value. */
+export declare function firstWinningEnvString(env: RuntimeEnvRecord, keys: readonly string[]): {
+    key: string;
+    value: string;
+} | null;
+export interface PortPreferenceResolution {
+    port: number;
+    sourceLabel: string;
+    changeLabel: string;
+    winningKey: string | null;
+}
+/** Preferred desktop API port from env precedence (before loopback reallocation). */
+export declare function resolveDesktopApiPortPreference(env?: RuntimeEnvRecord): PortPreferenceResolution;
+/** Preferred dashboard UI port from ELIZA_UI_PORT (Vite dev), before reallocation. */
+export declare function resolveDesktopUiPortPreference(env?: RuntimeEnvRecord): PortPreferenceResolution;
+export declare function stripOptionalHostPort(value: string): string;
+export declare function isLoopbackBindHost(host: string): boolean;
+export declare function isWildcardBindHost(host: string): boolean;
+export declare function resolveRuntimePorts(env?: RuntimeEnvRecord): ResolvedRuntimePorts;
+export declare function resolveServerOnlyPort(env?: RuntimeEnvRecord): number;
+export declare function resolveDesktopApiPort(env?: RuntimeEnvRecord): number;
+export declare function resolveDesktopUiPort(env?: RuntimeEnvRecord): number;
+export declare function resolveSingleProcessPort(env?: RuntimeEnvRecord): number;
+export declare function resolveUiPort(env?: RuntimeEnvRecord): number;
+export declare function resolveApiSecurityConfig(env?: RuntimeEnvRecord): ResolvedApiSecurityConfig;
+export declare function resolveApiBindHost(env?: RuntimeEnvRecord): string;
+export declare function resolveApiToken(env?: RuntimeEnvRecord): string | null;
+export declare function resolveConfiguredApiToken(env?: RuntimeEnvRecord): string | undefined;
+export declare function resolveAllowedOrigins(env?: RuntimeEnvRecord): string[];
+export declare function resolveApiAllowedOrigins(env?: RuntimeEnvRecord): string[];
+export declare function resolveAllowedHosts(env?: RuntimeEnvRecord): string[];
+export declare function resolveApiAllowedHosts(env?: RuntimeEnvRecord): string[];
+export declare function isNullOriginAllowed(env?: RuntimeEnvRecord): boolean;
+export declare function resolveAllowNullOrigin(env?: RuntimeEnvRecord): boolean;
+export declare function resolveDisableAutoApiToken(env?: RuntimeEnvRecord): boolean;
+export declare function setApiToken(env: RuntimeEnvRecord, token: string): void;
+export declare function syncResolvedApiPort(env: RuntimeEnvRecord, actualPort: number, opts?: {
+    overwriteUiPort?: boolean;
+}): void;
+export declare function resolveElizaRuntimeEnv(env?: RuntimeEnvRecord): ElizaRuntimeEnv;
+//# sourceMappingURL=runtime-env.d.ts.map

package/runtime-env.d.ts.map

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

package/runtime-env.js

@@ -0,0 +1,243 @@
+import { isTruthyEnvValue } from "./env-utils.impl.js";
+const DEFAULT_API_BIND_HOST = "127.0.0.1";
+export const DEFAULT_SERVER_ONLY_PORT = 2138;
+// Dev mode splits the API from the Vite UI: API on 31337, UI on 2138.
+export const DEFAULT_DESKTOP_API_PORT = 31337;
+export const DEFAULT_DESKTOP_UI_PORT = 2138;
+const LOOPBACK_BIND_RE = /^(localhost|127(?:\.\d{1,3}){3}|::1|\[::1\]|0:0:0:0:0:0:0:1|::ffff:127(?:\.\d{1,3}){3})$/i;
+const WILDCARD_BIND_RE = /^(0\.0\.0\.0|::|0:0:0:0:0:0:0:0)$/i;
+const API_BIND_KEYS = ["ELIZA_API_BIND"];
+const API_TOKEN_KEYS = ["ELIZA_API_TOKEN"];
+const API_ALLOWED_ORIGINS_KEYS = [
+    "ELIZA_ALLOWED_ORIGINS",
+    "CORS_ORIGINS",
+];
+const API_ALLOWED_HOSTS_KEYS = ["ELIZA_ALLOWED_HOSTS"];
+const API_ALLOW_NULL_ORIGIN_KEYS = ["ELIZA_ALLOW_NULL_ORIGIN"];
+const DISABLE_AUTO_API_TOKEN_KEYS = [
+    "ELIZA_DISABLE_AUTO_API_TOKEN",
+];
+const DESKTOP_API_PORT_KEYS = [
+    "ELIZA_API_PORT",
+    "ELIZA_PORT",
+];
+const DESKTOP_UI_PORT_KEYS = ["ELIZA_UI_PORT"];
+const SINGLE_PROCESS_PORT_KEYS = ["ELIZA_PORT", "ELIZA_UI_PORT"];
+export const ELIZA_RUNTIME_ENV_KEYS = {
+    apiBind: API_BIND_KEYS,
+    apiToken: API_TOKEN_KEYS,
+    allowedOrigins: API_ALLOWED_ORIGINS_KEYS,
+    allowedHosts: API_ALLOWED_HOSTS_KEYS,
+    allowNullOrigin: API_ALLOW_NULL_ORIGIN_KEYS,
+    disableAutoApiToken: DISABLE_AUTO_API_TOKEN_KEYS,
+    desktopApiPort: DESKTOP_API_PORT_KEYS,
+    singleProcessPort: SINGLE_PROCESS_PORT_KEYS,
+    desktopUiPort: DESKTOP_UI_PORT_KEYS,
+};
+function firstNonEmpty(env, keys) {
+    for (const key of keys) {
+        const value = env[key]?.trim();
+        if (value)
+            return value;
+    }
+    return null;
+}
+/** First key in `keys` with a non-empty trimmed string value. */
+export function firstWinningEnvString(env, keys) {
+    for (const key of keys) {
+        const value = env[key]?.trim();
+        if (value)
+            return { key, value };
+    }
+    return null;
+}
+/** Preferred desktop API port from env precedence (before loopback reallocation). */
+export function resolveDesktopApiPortPreference(env = process.env) {
+    for (const key of DESKTOP_API_PORT_KEYS) {
+        const p = parsePositivePort(env[key]);
+        if (p !== null) {
+            return {
+                port: p,
+                sourceLabel: `env set — ${key}=${p}`,
+                changeLabel: `unset ${key} or set ELIZA_API_PORT / ELIZA_PORT (first wins); built-in ${DEFAULT_DESKTOP_API_PORT}`,
+                winningKey: key,
+            };
+        }
+    }
+    return {
+        port: DEFAULT_DESKTOP_API_PORT,
+        sourceLabel: `default (unset — built-in ${DEFAULT_DESKTOP_API_PORT})`,
+        changeLabel: "export ELIZA_API_PORT=<port> (or ELIZA_PORT; first non-empty wins)",
+        winningKey: null,
+    };
+}
+/** Preferred dashboard UI port from ELIZA_UI_PORT (Vite dev), before reallocation. */
+export function resolveDesktopUiPortPreference(env = process.env) {
+    for (const key of DESKTOP_UI_PORT_KEYS) {
+        const p = parsePositivePort(env[key]);
+        if (p !== null) {
+            return {
+                port: p,
+                sourceLabel: `env set — ${key}=${p}`,
+                changeLabel: `unset ${key} for built-in ${DEFAULT_DESKTOP_UI_PORT}`,
+                winningKey: key,
+            };
+        }
+    }
+    return {
+        port: DEFAULT_DESKTOP_UI_PORT,
+        sourceLabel: `default (unset — built-in ${DEFAULT_DESKTOP_UI_PORT})`,
+        changeLabel: "export ELIZA_UI_PORT=<port>",
+        winningKey: null,
+    };
+}
+function parsePositivePort(raw) {
+    if (!raw)
+        return null;
+    const parsed = Number(raw);
+    return Number.isInteger(parsed) && parsed > 0 && parsed < 65536
+        ? parsed
+        : null;
+}
+function parseCsv(env, keys) {
+    const raw = firstNonEmpty(env, keys);
+    if (!raw)
+        return [];
+    return raw
+        .split(",")
+        .map((value) => value.trim())
+        .filter(Boolean);
+}
+function parseEnabledFlag(env, keys) {
+    return isTruthyEnvValue(firstNonEmpty(env, keys) ?? undefined);
+}
+export function stripOptionalHostPort(value) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        return "";
+    const lower = trimmed.toLowerCase();
+    if (lower.startsWith("http://") || lower.startsWith("https://")) {
+        try {
+            return new URL(lower).hostname.toLowerCase();
+        }
+        catch {
+            return lower;
+        }
+    }
+    if (lower.startsWith("[")) {
+        const close = lower.indexOf("]");
+        return close > 0 ? lower.slice(1, close) : lower.slice(1);
+    }
+    if ((lower.match(/:/g) || []).length >= 2) {
+        return lower;
+    }
+    return lower.replace(/:\d+$/, "");
+}
+export function isLoopbackBindHost(host) {
+    const normalized = stripOptionalHostPort(host);
+    if (!normalized)
+        return true;
+    if (LOOPBACK_BIND_RE.test(normalized))
+        return true;
+    return normalized.startsWith("127.");
+}
+export function isWildcardBindHost(host) {
+    const normalized = stripOptionalHostPort(host);
+    return WILDCARD_BIND_RE.test(normalized);
+}
+export function resolveRuntimePorts(env = process.env) {
+    return {
+        serverOnlyPort: parsePositivePort(env.ELIZA_PORT) ??
+            parsePositivePort(env.ELIZA_UI_PORT) ??
+            DEFAULT_SERVER_ONLY_PORT,
+        desktopApiPort: parsePositivePort(env.ELIZA_API_PORT) ??
+            parsePositivePort(env.ELIZA_PORT) ??
+            DEFAULT_DESKTOP_API_PORT,
+        desktopUiPort: parsePositivePort(env.ELIZA_UI_PORT) ?? DEFAULT_DESKTOP_UI_PORT,
+    };
+}
+export function resolveServerOnlyPort(env = process.env) {
+    return resolveRuntimePorts(env).serverOnlyPort;
+}
+export function resolveDesktopApiPort(env = process.env) {
+    return resolveRuntimePorts(env).desktopApiPort;
+}
+export function resolveDesktopUiPort(env = process.env) {
+    return resolveRuntimePorts(env).desktopUiPort;
+}
+export function resolveSingleProcessPort(env = process.env) {
+    return resolveServerOnlyPort(env);
+}
+export function resolveUiPort(env = process.env) {
+    return resolveDesktopUiPort(env);
+}
+export function resolveApiSecurityConfig(env = process.env) {
+    const bindHost = firstNonEmpty(env, API_BIND_KEYS) ?? DEFAULT_API_BIND_HOST;
+    return {
+        bindHost,
+        token: firstNonEmpty(env, API_TOKEN_KEYS),
+        disableAutoApiToken: parseEnabledFlag(env, DISABLE_AUTO_API_TOKEN_KEYS),
+        allowedOrigins: parseCsv(env, API_ALLOWED_ORIGINS_KEYS),
+        allowedHosts: parseCsv(env, API_ALLOWED_HOSTS_KEYS),
+        allowNullOrigin: parseEnabledFlag(env, API_ALLOW_NULL_ORIGIN_KEYS),
+        isLoopbackBind: isLoopbackBindHost(bindHost),
+        isWildcardBind: isWildcardBindHost(bindHost),
+    };
+}
+export function resolveApiBindHost(env = process.env) {
+    return resolveApiSecurityConfig(env).bindHost;
+}
+export function resolveApiToken(env = process.env) {
+    return resolveApiSecurityConfig(env).token;
+}
+export function resolveConfiguredApiToken(env = process.env) {
+    return resolveApiToken(env) ?? undefined;
+}
+export function resolveAllowedOrigins(env = process.env) {
+    return resolveApiSecurityConfig(env).allowedOrigins;
+}
+export function resolveApiAllowedOrigins(env = process.env) {
+    return resolveAllowedOrigins(env);
+}
+export function resolveAllowedHosts(env = process.env) {
+    return resolveApiSecurityConfig(env).allowedHosts;
+}
+export function resolveApiAllowedHosts(env = process.env) {
+    return resolveAllowedHosts(env);
+}
+export function isNullOriginAllowed(env = process.env) {
+    return resolveApiSecurityConfig(env).allowNullOrigin;
+}
+export function resolveAllowNullOrigin(env = process.env) {
+    return isNullOriginAllowed(env);
+}
+export function resolveDisableAutoApiToken(env = process.env) {
+    return resolveApiSecurityConfig(env).disableAutoApiToken;
+}
+export function setApiToken(env = process.env, token) {
+    env.ELIZA_API_TOKEN = token;
+}
+export function syncResolvedApiPort(env = process.env, actualPort, opts) {
+    const normalizedPort = String(actualPort);
+    env.ELIZA_API_PORT = normalizedPort;
+    env.ELIZA_PORT = normalizedPort;
+    if (opts?.overwriteUiPort) {
+        env.ELIZA_UI_PORT = normalizedPort;
+    }
+}
+export function resolveElizaRuntimeEnv(env = process.env) {
+    const ports = resolveRuntimePorts(env);
+    const security = resolveApiSecurityConfig(env);
+    return {
+        apiBind: security.bindHost,
+        apiToken: security.token ?? undefined,
+        allowedOrigins: security.allowedOrigins,
+        allowedHosts: security.allowedHosts,
+        allowNullOrigin: security.allowNullOrigin,
+        disableAutoApiToken: security.disableAutoApiToken,
+        desktopApiPort: ports.desktopApiPort,
+        singleProcessPort: ports.serverOnlyPort,
+        uiPort: ports.desktopUiPort,
+    };
+}
+//# sourceMappingURL=runtime-env.js.map

package/runtime-env.js.map

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

package/settings-debug.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Opt-in verbose logging for settings load / change / save flows.
+ * Enable with ELIZA_SETTINGS_DEBUG=1 (and Vite: same env at build time, or VITE_ELIZA_SETTINGS_DEBUG=1).
+ */
+/**
+ * True when settings debug is enabled (Node: process.env; browser: import.meta.env from Vite define).
+ */
+export declare function isElizaSettingsDebugEnabled(options?: {
+    /** Node / Bun process.env */
+    env?: Record<string, string | undefined> | null;
+    /** Vite `import.meta.env` (pass only in browser bundles). */
+    importMetaEnv?: Record<string, unknown> | null;
+}): boolean;
+/**
+ * Deep-clone-ish snapshot safe to log (secrets masked). Not for security boundaries — debug only.
+ */
+export declare function sanitizeForSettingsDebug(value: unknown, depth?: number, seen?: WeakSet<object>): unknown;
+/** Compact cloud slice for logs (no raw secrets). */
+export declare function settingsDebugCloudSummary(cloud: Record<string, unknown> | null | undefined): Record<string, unknown>;
+//# sourceMappingURL=settings-debug.d.ts.map

package/settings-debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-debug.d.ts","sourceRoot":"","sources":["../src/settings-debug.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,CAAC,EAAE;IACpD,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;IAChD,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAChD,GAAG,OAAO,CAiBV;AAQD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,KAAK,SAAI,EACT,IAAI,GAAE,OAAO,CAAC,MAAM,CAAiB,GACpC,OAAO,CA+CT;AAED,qDAAqD;AACrD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAChD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB"}

package/settings-debug.js

@@ -0,0 +1,117 @@
+/**
+ * Opt-in verbose logging for settings load / change / save flows.
+ * Enable with ELIZA_SETTINGS_DEBUG=1 (and Vite: same env at build time, or VITE_ELIZA_SETTINGS_DEBUG=1).
+ */
+import { isTruthyEnvValue } from "./env-utils.impl.js";
+/** Keys whose values are always redacted in debug dumps. */
+const SENSITIVE_KEY_RE = /(?:^|\.|_)(?:secret|password|token|apikey|api_key|privatekey|private_key|mnemonic|credential|authorization|bearer|cookie|sessionkey|session_id)(?:\.|_|$)|^apikey$|_api_key$|_key$/i;
+const MAX_DEPTH = 14;
+const MAX_ARRAY = 40;
+const MAX_STRING = 120;
+/**
+ * True when settings debug is enabled (Node: process.env; browser: import.meta.env from Vite define).
+ */
+export function isElizaSettingsDebugEnabled(options) {
+    const im = options?.importMetaEnv;
+    if (im) {
+        if (isTruthyEnvValue(String(im.ELIZA_SETTINGS_DEBUG ?? "").trim()))
+            return true;
+        if (isTruthyEnvValue(String(im.VITE_ELIZA_SETTINGS_DEBUG ?? "").trim()))
+            return true;
+    }
+    const e = options?.env;
+    if (e) {
+        if (isTruthyEnvValue(e.ELIZA_SETTINGS_DEBUG))
+            return true;
+        if (isTruthyEnvValue(e.VITE_ELIZA_SETTINGS_DEBUG))
+            return true;
+    }
+    if (typeof process !== "undefined" && process.env) {
+        if (isTruthyEnvValue(process.env.ELIZA_SETTINGS_DEBUG))
+            return true;
+        if (isTruthyEnvValue(process.env.VITE_ELIZA_SETTINGS_DEBUG))
+            return true;
+    }
+    return false;
+}
+function maskString(s) {
+    const t = s.trim();
+    if (t.length <= 8)
+        return "[redacted:short]";
+    return `${t.slice(0, 4)}…${t.slice(-2)} (${t.length} chars)`;
+}
+/**
+ * Deep-clone-ish snapshot safe to log (secrets masked). Not for security boundaries — debug only.
+ */
+export function sanitizeForSettingsDebug(value, depth = 0, seen = new WeakSet()) {
+    if (depth > MAX_DEPTH)
+        return "[max-depth]";
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value === "boolean" || typeof value === "number")
+        return value;
+    if (typeof value === "string") {
+        const t = value.trim();
+        if (t.length === 0)
+            return "";
+        if (t.toUpperCase() === "[REDACTED]")
+            return "[REDACTED]";
+        if (t.length > 48 || /^(sk-|pk_|Bearer\s)/i.test(t))
+            return maskString(t);
+        if (t.length > MAX_STRING)
+            return `${t.slice(0, MAX_STRING)}…`;
+        return t;
+    }
+    if (typeof value === "bigint")
+        return String(value);
+    if (typeof value === "function")
+        return `[fn ${value.name || "anonymous"}]`;
+    if (typeof value !== "object")
+        return String(value);
+    if (seen.has(value))
+        return "[circular]";
+    seen.add(value);
+    if (Array.isArray(value)) {
+        const out = [];
+        const cap = Math.min(value.length, MAX_ARRAY);
+        for (let i = 0; i < cap; i++) {
+            out.push(sanitizeForSettingsDebug(value[i], depth + 1, seen));
+        }
+        if (value.length > cap) {
+            out.push(`… +${value.length - cap} more`);
+        }
+        return out;
+    }
+    const o = value;
+    const out = {};
+    for (const [k, v] of Object.entries(o)) {
+        if (SENSITIVE_KEY_RE.test(k)) {
+            out[k] =
+                typeof v === "string" && v.trim()
+                    ? maskString(v)
+                    : v == null || v === ""
+                        ? v
+                        : "[redacted]";
+        }
+        else {
+            out[k] = sanitizeForSettingsDebug(v, depth + 1, seen);
+        }
+    }
+    return out;
+}
+/** Compact cloud slice for logs (no raw secrets). */
+export function settingsDebugCloudSummary(cloud) {
+    if (!cloud || typeof cloud !== "object")
+        return { cloud: null };
+    const apiKey = cloud.apiKey;
+    return {
+        enabled: cloud.enabled,
+        inferenceMode: cloud.inferenceMode,
+        services: cloud.services,
+        baseUrl: cloud.baseUrl,
+        hasApiKey: typeof apiKey === "string"
+            ? apiKey.trim().length > 0
+            : Boolean(apiKey),
+    };
+}
+//# sourceMappingURL=settings-debug.js.map

package/settings-debug.js.map

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

package/spoken-text.d.ts

@@ -0,0 +1,2 @@
+export declare function sanitizeSpeechText(input: string): string;
+//# sourceMappingURL=spoken-text.d.ts.map

package/spoken-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spoken-text.d.ts","sourceRoot":"","sources":["../src/spoken-text.ts"],"names":[],"mappings":"AA2DA,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKxD"}

package/spoken-text.js

@@ -0,0 +1,57 @@
+function collapseWhitespace(input) {
+    return input.replace(/\s+/g, " ").trim();
+}
+function stripUrls(input) {
+    return input.replace(/\bhttps?:\/\/\S+/gi, " ");
+}
+function stripThinkingAndMarkup(input) {
+    let text = input;
+    text = text.replace(/<think\b[^>]*>[\s\S]*?<\/think>/gi, " ");
+    text = text.replace(/<(analysis|reasoning|scratchpad|tool_calls?|tools?)\b[^>]*>[\s\S]*?<\/\1>/gi, " ");
+    text = text.replace(/```[\s\S]*?```/g, " ");
+    text = text.replace(/`([^`]+)`/g, "$1");
+    text = text.replace(/\[([^\]]+)\]\([^)]+\)/g, "$1");
+    text = text.replace(/<[^>\n]+>/g, " ");
+    text = stripUrls(text);
+    return text;
+}
+const NON_SPEECH_SEGMENT_PATTERNS = [
+    /\*{1,2}[^*\n]+\*{1,2}/g,
+    /\([^()]*\)/g,
+    /\[[^[\]]*\]/g,
+    /\{[^{}]*\}/g,
+];
+function stripNonSpeechDirections(input) {
+    let text = input;
+    while (true) {
+        const previous = text;
+        for (const pattern of NON_SPEECH_SEGMENT_PATTERNS) {
+            text = text.replace(pattern, " ");
+        }
+        if (text === previous) {
+            break;
+        }
+    }
+    return text.replace(/[*()[\]{}]+/g, " ");
+}
+function sanitizeSpeechPunctuation(input) {
+    let text = input;
+    text = text.replace(/[•·■▪◦]/g, " ");
+    text = text.replace(/[“”]/g, '"');
+    text = text.replace(/[‘’]/g, "'");
+    text = text.replace(/[…]/g, "...");
+    text = text.replace(/[–—]/g, ", ");
+    text = text.replace(/\s*([,;:，；：])\s*/g, "$1 ");
+    text = text.replace(/\s*([.!?。！？])\s*/g, "$1 ");
+    text = text.replace(/[^\p{L}\p{N}\s.,!?'"%/$:+-，。！？；：]/gu, " ");
+    text = text.replace(/([,.!?，。！？])\1+/g, "$1");
+    text = text.replace(/^[,;:.!?，。！？；：]+/g, " ");
+    return text;
+}
+export function sanitizeSpeechText(input) {
+    const normalized = input.normalize("NFKC");
+    const stripped = stripThinkingAndMarkup(normalized);
+    const withoutDirections = stripNonSpeechDirections(stripped);
+    return collapseWhitespace(sanitizeSpeechPunctuation(withoutDirections));
+}
+//# sourceMappingURL=spoken-text.js.map

package/spoken-text.js.map

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

package/themes/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Theme system — public API.
+ */
+export type { ThemeColorSet, ThemeDefinition, ThemeFonts, ThemeValidationError, } from "../contracts/theme";
+export { DEFAULT_THEME_ID, THEME_CSS_VAR_MAP, THEME_CSS_VAR_NAMES, THEME_FONT_CSS_VARS, THEME_FONT_LINK_ID, validateThemeDefinition, } from "../contracts/theme";
+export { BSC_GOLD_THEME, BUILTIN_THEMES, COMIC_POP_THEME, HACKER_TERMINAL_THEME, NEON_CYBER_THEME, RETRO_90S_THEME, } from "./presets";
+//# sourceMappingURL=index.d.ts.map

package/themes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/themes/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,aAAa,EACb,eAAe,EACf,UAAU,EACV,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,GAChB,MAAM,WAAW,CAAC"}

package/themes/index.js

@@ -0,0 +1,6 @@
+/**
+ * Theme system — public API.
+ */
+export { DEFAULT_THEME_ID, THEME_CSS_VAR_MAP, THEME_CSS_VAR_NAMES, THEME_FONT_CSS_VARS, THEME_FONT_LINK_ID, validateThemeDefinition, } from "../contracts/theme";
+export { BSC_GOLD_THEME, BUILTIN_THEMES, COMIC_POP_THEME, HACKER_TERMINAL_THEME, NEON_CYBER_THEME, RETRO_90S_THEME, } from "./presets";
+//# sourceMappingURL=index.js.map

package/themes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/themes/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,GAChB,MAAM,WAAW,CAAC"}

package/themes/presets.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Built-in theme presets.
+ *
+ * Each preset provides full light and dark color sets extracted from
+ * (or inspired by) the base.css defaults. The BSC Gold theme is the
+ * canonical default — its values match base.css exactly.
+ */
+import type { ThemeDefinition } from "../contracts/theme";
+export declare const BSC_GOLD_THEME: ThemeDefinition;
+export declare const NEON_CYBER_THEME: ThemeDefinition;
+export declare const RETRO_90S_THEME: ThemeDefinition;
+export declare const COMIC_POP_THEME: ThemeDefinition;
+export declare const HACKER_TERMINAL_THEME: ThemeDefinition;
+export declare const BUILTIN_THEMES: ThemeDefinition[];
+//# sourceMappingURL=presets.d.ts.map

package/themes/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/themes/presets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI1D,eAAO,MAAM,cAAc,EAAE,eAuJ5B,CAAC;AAIF,eAAO,MAAM,gBAAgB,EAAE,eAqJ9B,CAAC;AAIF,eAAO,MAAM,eAAe,EAAE,eA0J7B,CAAC;AAIF,eAAO,MAAM,eAAe,EAAE,eA4J7B,CAAC;AAIF,eAAO,MAAM,qBAAqB,EAAE,eA8JnC,CAAC;AAIF,eAAO,MAAM,cAAc,EAAE,eAAe,EAM3C,CAAC"}