@desktalk/core 0.1.0-alpha.1

package/dist/services/miniapp-registry.js

@@ -0,0 +1,144 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join, normalize } from 'node:path';
+import { resolveMiniAppPaths } from './workspace.js';
+import { getStoredPreference } from './preferences.js';
+import { processManager } from './backend-process-manager.js';
+import { buildMiniAppIconUrl } from './miniapp-icon.js';
+function resolveMetadataIconPath(packageRoot, iconFile) {
+    const normalized = normalize(iconFile);
+    const relative = normalized.replace(/\\/g, '/');
+    if (relative === '..' || relative.startsWith('../')) {
+        return undefined;
+    }
+    const resolved = join(packageRoot, normalized);
+    return existsSync(resolved) ? resolved : undefined;
+}
+function readMiniAppMetadata(packageRoot) {
+    const metadataPath = join(packageRoot, 'dist', 'meta.json');
+    if (!existsSync(metadataPath)) {
+        return {};
+    }
+    try {
+        return JSON.parse(readFileSync(metadataPath, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Registry that manages MiniApp discovery, activation, and deactivation.
+ *
+ * Activation now spawns an isolated child process per MiniApp via the
+ * BackendProcessManager. The main process never runs backend code directly.
+ */
+class MiniAppRegistry {
+    entries = new Map();
+    normalizeLaunchArgs(launchArgs) {
+        return Array.isArray(launchArgs) ? launchArgs : [];
+    }
+    /**
+     * Register a MiniApp module (built-in or third-party).
+     */
+    register(manifest, packageRoot, backendPath) {
+        if (this.entries.has(manifest.id)) {
+            throw new Error(`MiniApp already registered: ${manifest.id}`);
+        }
+        const metadata = readMiniAppMetadata(packageRoot);
+        const iconFilePath = typeof metadata.iconFile === 'string'
+            ? resolveMetadataIconPath(packageRoot, metadata.iconFile)
+            : undefined;
+        this.entries.set(manifest.id, {
+            manifest: {
+                ...manifest,
+                ...(iconFilePath ? { iconPng: buildMiniAppIconUrl(manifest.id) } : {}),
+            },
+            packageRoot,
+            backendPath,
+            iconFilePath,
+        });
+    }
+    /**
+     * Activate a MiniApp for a specific user — spawns an isolated child process.
+     * The process is keyed by `miniAppId:username` so each user gets their own
+     * backend instance with isolated data paths.
+     */
+    async activate(id, username, options) {
+        const entry = this.entries.get(id);
+        if (!entry) {
+            throw new Error(`MiniApp not found: ${id}`);
+        }
+        const processKey = `${id}:${username}`;
+        if (processManager.isRunning(processKey)) {
+            return;
+        }
+        const paths = resolveMiniAppPaths(id, username);
+        const locale = String(getStoredPreference('general.language') ?? 'en');
+        await processManager.spawn(processKey, entry.backendPath, entry.packageRoot, paths, locale, id, this.normalizeLaunchArgs(options?.launchArgs));
+    }
+    /**
+     * Deactivate a MiniApp for a specific user — stops its child process.
+     */
+    async deactivate(id, username) {
+        const processKey = `${id}:${username}`;
+        await processManager.kill(processKey);
+    }
+    /**
+     * Check if a MiniApp is activated for a specific user.
+     */
+    isActivated(id, username) {
+        const processKey = `${id}:${username}`;
+        return processManager.isRunning(processKey);
+    }
+    /**
+     * Get all registered manifests (for the Dock).
+     */
+    getManifests() {
+        return Array.from(this.entries.values()).map((e) => e.manifest);
+    }
+    /**
+     * Get a specific entry.
+     */
+    getEntry(id) {
+        return this.entries.get(id);
+    }
+    /**
+     * Get all registered IDs.
+     */
+    getIds() {
+        return Array.from(this.entries.keys());
+    }
+}
+/**
+ * Singleton registry instance.
+ */
+export const registry = new MiniAppRegistry();
+/**
+ * Register built-in MiniApps from their backend entries.
+ */
+export async function registerBuiltinMiniApps(logger) {
+    // Built-in MiniApps are imported dynamically from their backend sub-path.
+    // During development, these resolve via pnpm workspace links.
+    const builtins = [
+        '@desktalk/miniapp-note/backend',
+        '@desktalk/miniapp-file-explorer/backend',
+        '@desktalk/miniapp-preference/backend',
+        '@desktalk/miniapp-preview/backend',
+        '@desktalk/miniapp-player/backend',
+        '@desktalk/miniapp-terminal/backend',
+        '@desktalk/miniapp-text-edit/backend',
+    ];
+    for (const specifier of builtins) {
+        try {
+            const mod = (await import(specifier));
+            const backendFile = fileURLToPath(import.meta.resolve(specifier));
+            const packageRoot = join(dirname(backendFile), '..');
+            registry.register(mod.manifest, packageRoot, specifier);
+        }
+        catch (err) {
+            // Built-in MiniApp not available yet — skip during early development
+            logger?.warn({ specifier, err: err.message }, 'could not load built-in MiniApp');
+        }
+    }
+}
+//# sourceMappingURL=miniapp-registry.js.map

package/dist/services/miniapp-registry.js.map

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

package/dist/services/onboarding-config.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Writes AI and Voice provider settings chosen during onboarding into the
+ * preference storage file so they are immediately available to the core's
+ * preference reader and the Preference MiniApp.
+ *
+ * The file format matches what `ctx.storage.set('config', ...)` produces in
+ * the Preference MiniApp backend — a JSON object with a top-level `config`
+ * key containing the flat key-value map.
+ */
+export interface AiOnboardingConfig {
+    defaultProvider: string;
+    providers: Array<{
+        provider: string;
+        apiKey?: string;
+        model?: string;
+        baseUrl?: string;
+    }>;
+}
+export interface VoiceOnboardingConfig {
+    defaultProvider: string;
+    providers: Array<{
+        provider: string;
+        apiKey?: string;
+        model?: string;
+        baseUrl?: string;
+        azureDeployment?: string;
+        azureApiVersion?: string;
+    }>;
+}
+/**
+ * Persist provider settings from onboarding into the user's preference.json.
+ *
+ * This is called immediately after `ensureUserHome()` so the `.storage`
+ * directory already exists.
+ */
+export declare function saveOnboardingConfig(username: string, aiConfig?: AiOnboardingConfig, voiceConfig?: VoiceOnboardingConfig): void;
+//# sourceMappingURL=onboarding-config.d.ts.map

package/dist/services/onboarding-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-config.d.ts","sourceRoot":"","sources":["../../src/services/onboarding-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,KAAK,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,KAAK,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC,CAAC;CACJ;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,kBAAkB,EAC7B,WAAW,CAAC,EAAE,qBAAqB,GAClC,IAAI,CA8DN"}

package/dist/services/onboarding-config.js

@@ -0,0 +1,76 @@
+/**
+ * Writes AI and Voice provider settings chosen during onboarding into the
+ * preference storage file so they are immediately available to the core's
+ * preference reader and the Preference MiniApp.
+ *
+ * The file format matches what `ctx.storage.set('config', ...)` produces in
+ * the Preference MiniApp backend — a JSON object with a top-level `config`
+ * key containing the flat key-value map.
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getUserHomeDir } from './workspace.js';
+/**
+ * Persist provider settings from onboarding into the user's preference.json.
+ *
+ * This is called immediately after `ensureUserHome()` so the `.storage`
+ * directory already exists.
+ */
+export function saveOnboardingConfig(username, aiConfig, voiceConfig) {
+    if (!aiConfig && !voiceConfig)
+        return;
+    const storagePath = join(getUserHomeDir(username), '.storage', 'preference.json');
+    // Read existing store (may already contain defaults from a migration)
+    let store = {};
+    if (existsSync(storagePath)) {
+        try {
+            store = JSON.parse(readFileSync(storagePath, 'utf-8'));
+        }
+        catch {
+            // Corrupt or empty file — start fresh
+        }
+    }
+    const config = store.config ?? {};
+    if (aiConfig) {
+        const enabledProviders = aiConfig.providers.map((provider) => provider.provider).join(',');
+        config['ai.enabledProviders'] = enabledProviders;
+        config['ai.defaultProvider'] = aiConfig.defaultProvider;
+        for (const provider of aiConfig.providers) {
+            if (provider.apiKey) {
+                config[`ai.providers.${provider.provider}.apiKey`] = provider.apiKey;
+            }
+            if (provider.model) {
+                config[`ai.providers.${provider.provider}.model`] = provider.model;
+            }
+            if (provider.baseUrl) {
+                config[`ai.providers.${provider.provider}.baseUrl`] = provider.baseUrl;
+            }
+        }
+    }
+    if (voiceConfig) {
+        config['voice.enabledProviders'] = voiceConfig.providers
+            .map((provider) => provider.provider)
+            .join(',');
+        config['voice.defaultProvider'] = voiceConfig.defaultProvider;
+        for (const provider of voiceConfig.providers) {
+            if (provider.apiKey) {
+                config[`voice.providers.${provider.provider}.apiKey`] = provider.apiKey;
+            }
+            if (provider.model) {
+                config[`voice.providers.${provider.provider}.model`] = provider.model;
+            }
+            if (provider.baseUrl) {
+                config[`voice.providers.${provider.provider}.baseUrl`] = provider.baseUrl;
+            }
+            if (provider.azureDeployment) {
+                config[`voice.providers.${provider.provider}.azureDeployment`] = provider.azureDeployment;
+            }
+            if (provider.azureApiVersion) {
+                config[`voice.providers.${provider.provider}.azureApiVersion`] = provider.azureApiVersion;
+            }
+        }
+    }
+    store.config = config;
+    writeFileSync(storagePath, JSON.stringify(store, null, 2), 'utf-8');
+}
+//# sourceMappingURL=onboarding-config.js.map

package/dist/services/onboarding-config.js.map

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

package/dist/services/preferences.d.ts

@@ -0,0 +1,10 @@
+type PreferenceValue = string | number | boolean;
+/**
+ * Set the active user for preference reads.
+ * Called when a WebSocket user authenticates.
+ */
+export declare function setPreferenceUser(username: string): void;
+export declare function getStoredPreference(key: string): PreferenceValue | undefined;
+export declare function getStoredPreferenceForUser(username: string, key: string): PreferenceValue | undefined;
+export {};
+//# sourceMappingURL=preferences.d.ts.map

package/dist/services/preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../src/services/preferences.ts"],"names":[],"mappings":"AAIA,KAAK,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AASjD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAExD;AAkCD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE5E;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,GACV,eAAe,GAAG,SAAS,CAE7B"}

package/dist/services/preferences.js

@@ -0,0 +1,48 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getWorkspacePaths, getUserHomeDir } from './workspace.js';
+/** The username whose preferences should be read. Defaults to 'admin'. */
+let currentPreferenceUser = 'admin';
+/**
+ * Set the active user for preference reads.
+ * Called when a WebSocket user authenticates.
+ */
+export function setPreferenceUser(username) {
+    currentPreferenceUser = username;
+}
+function readPreferenceStoreForUser(username) {
+    const workspace = getWorkspacePaths();
+    // Try the per-user path first
+    const userPath = join(getUserHomeDir(username), '.storage', 'preference.json');
+    if (existsSync(userPath)) {
+        try {
+            const parsed = JSON.parse(readFileSync(userPath, 'utf-8'));
+            return parsed.config ?? {};
+        }
+        catch {
+            // Fall through to legacy path
+        }
+    }
+    // Fallback to legacy global path (pre-migration)
+    const legacyPath = join(workspace.data, 'storage', 'preference.json');
+    if (!existsSync(legacyPath)) {
+        return {};
+    }
+    try {
+        const parsed = JSON.parse(readFileSync(legacyPath, 'utf-8'));
+        return parsed.config ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+function readPreferenceStore() {
+    return readPreferenceStoreForUser(currentPreferenceUser);
+}
+export function getStoredPreference(key) {
+    return readPreferenceStore()[key];
+}
+export function getStoredPreferenceForUser(username, key) {
+    return readPreferenceStoreForUser(username)[key];
+}
+//# sourceMappingURL=preferences.js.map

package/dist/services/preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.js","sourceRoot":"","sources":["../../src/services/preferences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQhE,0EAA0E;AAC1E,IAAI,qBAAqB,GAAG,OAAO,CAAC;AAEpC;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,qBAAqB,GAAG,QAAQ,CAAC;AACnC,CAAC;AAED,SAAS,0BAA0B,CAAC,QAAgB;IAClD,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;IAEtC,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC;IAC/E,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAwB,CAAC;YAClF,OAAO,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC;IACtE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAwB,CAAC;QACpF,OAAO,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB;IAC1B,OAAO,0BAA0B,CAAC,qBAAqB,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,OAAO,mBAAmB,EAAE,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,QAAgB,EAChB,GAAW;IAEX,OAAO,0BAA0B,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;AACnD,CAAC"}

package/dist/services/proxy-dispatcher.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Global proxy dispatcher for Node.js fetch().
+ *
+ * When HTTP_PROXY / HTTPS_PROXY (or their lowercase variants) are set in the
+ * environment, this module installs an undici `EnvHttpProxyAgent` as the
+ * global dispatcher so that **every** `fetch()` call in the process
+ * automatically routes through the configured proxy.
+ *
+ * `EnvHttpProxyAgent` honours the standard env vars:
+ *   HTTP_PROXY / http_proxy
+ *   HTTPS_PROXY / https_proxy
+ *   NO_PROXY / no_proxy
+ *
+ * Call `initGlobalProxyDispatcher()` once, early in the process lifecycle
+ * (before any outbound HTTP traffic), e.g. in the CLI start command.
+ */
+export declare function initGlobalProxyDispatcher(): void;
+//# sourceMappingURL=proxy-dispatcher.d.ts.map

package/dist/services/proxy-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-dispatcher.d.ts","sourceRoot":"","sources":["../../src/services/proxy-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,wBAAgB,yBAAyB,IAAI,IAAI,CAehD"}

package/dist/services/proxy-dispatcher.js

@@ -0,0 +1,33 @@
+/**
+ * Global proxy dispatcher for Node.js fetch().
+ *
+ * When HTTP_PROXY / HTTPS_PROXY (or their lowercase variants) are set in the
+ * environment, this module installs an undici `EnvHttpProxyAgent` as the
+ * global dispatcher so that **every** `fetch()` call in the process
+ * automatically routes through the configured proxy.
+ *
+ * `EnvHttpProxyAgent` honours the standard env vars:
+ *   HTTP_PROXY / http_proxy
+ *   HTTPS_PROXY / https_proxy
+ *   NO_PROXY / no_proxy
+ *
+ * Call `initGlobalProxyDispatcher()` once, early in the process lifecycle
+ * (before any outbound HTTP traffic), e.g. in the CLI start command.
+ */
+import { EnvHttpProxyAgent, setGlobalDispatcher } from 'undici';
+let initialized = false;
+export function initGlobalProxyDispatcher() {
+    if (initialized)
+        return;
+    initialized = true;
+    const proxyUrl = process.env.HTTPS_PROXY ??
+        process.env.https_proxy ??
+        process.env.HTTP_PROXY ??
+        process.env.http_proxy;
+    if (!proxyUrl)
+        return;
+    // EnvHttpProxyAgent reads HTTP(S)_PROXY and NO_PROXY from process.env
+    // internally, so we don't need to pass the URL explicitly.
+    setGlobalDispatcher(new EnvHttpProxyAgent());
+}
+//# sourceMappingURL=proxy-dispatcher.js.map

package/dist/services/proxy-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-dispatcher.js","sourceRoot":"","sources":["../../src/services/proxy-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAEhE,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB,MAAM,UAAU,yBAAyB;IACvC,IAAI,WAAW;QAAE,OAAO;IACxB,WAAW,GAAG,IAAI,CAAC;IAEnB,MAAM,QAAQ,GACZ,OAAO,CAAC,GAAG,CAAC,WAAW;QACvB,OAAO,CAAC,GAAG,CAAC,WAAW;QACvB,OAAO,CAAC,GAAG,CAAC,UAAU;QACtB,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IAEzB,IAAI,CAAC,QAAQ;QAAE,OAAO;IAEtB,sEAAsE;IACtE,2DAA2D;IAC3D,mBAAmB,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/dist/services/storage.d.ts

@@ -0,0 +1,7 @@
+import type { StorageHook } from '@desktalk/sdk';
+/**
+ * Creates a scoped key-value storage hook for a MiniApp.
+ * Data is persisted as a JSON file at the given path.
+ */
+export declare function createStorageHook(storagePath: string): StorageHook;
+//# sourceMappingURL=storage.d.ts.map

package/dist/services/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/services/storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAyDlE"}

package/dist/services/storage.js

@@ -0,0 +1,55 @@
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+/**
+ * Creates a scoped key-value storage hook for a MiniApp.
+ * Data is persisted as a JSON file at the given path.
+ */
+export function createStorageHook(storagePath) {
+    function readStore() {
+        if (!existsSync(storagePath)) {
+            return {};
+        }
+        try {
+            const raw = readFileSync(storagePath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return {};
+        }
+    }
+    function writeStore(store) {
+        writeFileSync(storagePath, JSON.stringify(store, null, 2), 'utf-8');
+    }
+    return {
+        async get(key) {
+            const store = readStore();
+            return store[key];
+        },
+        async set(key, value) {
+            const store = readStore();
+            store[key] = value;
+            writeStore(store);
+        },
+        async delete(key) {
+            const store = readStore();
+            delete store[key];
+            writeStore(store);
+        },
+        async list() {
+            const store = readStore();
+            return Object.keys(store);
+        },
+        async query(options) {
+            const store = readStore();
+            let entries = Object.entries(store);
+            if (options.prefix) {
+                entries = entries.filter(([key]) => key.startsWith(options.prefix));
+            }
+            let values = entries.map(([, value]) => value);
+            if (options.filter) {
+                values = values.filter(options.filter);
+            }
+            return values;
+        },
+    };
+}
+//# sourceMappingURL=storage.js.map

package/dist/services/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/services/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGlE;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,SAAS,SAAS;QAChB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,SAAS,UAAU,CAAC,KAA8B;QAChD,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED,OAAO;QACL,KAAK,CAAC,GAAG,CAAI,GAAW;YACtB,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC,GAAG,CAAkB,CAAC;QACrC,CAAC;QAED,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,KAAQ;YAChC,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;YAC1B,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACnB,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,GAAW;YACtB,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;YAClB,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;QAED,KAAK,CAAC,IAAI;YACR,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;YAC1B,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QAED,KAAK,CAAC,KAAK,CAAI,OAAwD;YACrE,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;YAC1B,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAEpC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,MAAO,CAAC,CAAC,CAAC;YACvE,CAAC;YAED,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAU,CAAC,CAAC;YAEpD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACzC,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/services/theme-css.d.ts

@@ -0,0 +1,21 @@
+export type ThemeMode = 'light' | 'dark';
+export interface ThemePreferences {
+    accentColor: string;
+    theme: ThemeMode;
+}
+export declare const DEFAULT_THEME_PREFERENCES: ThemePreferences;
+/**
+ * Generate the full `:root { --dt-* }` CSS text for the given theme preferences.
+ *
+ * This is the single source of truth for the DeskTalk color system.
+ */
+export declare function generateThemeCSS(preferences: ThemePreferences): string;
+/**
+ * Base stylesheet for AI-generated HTML.
+ *
+ * Provides sensible defaults for body, headings, tables, cards, buttons, and
+ * code blocks — all using semantic `--dt-*` tokens. This ensures generated HTML
+ * looks native to DeskTalk without the AI needing to emit its own reset/base styles.
+ */
+export declare const HTML_BASE_STYLESHEET: string;
+//# sourceMappingURL=theme-css.d.ts.map

package/dist/services/theme-css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-css.d.ts","sourceRoot":"","sources":["../../src/services/theme-css.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzC,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,CAAC;CAClB;AA6BD,eAAO,MAAM,yBAAyB,EAAE,gBAGvC,CAAC;AA0CF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,gBAAgB,GAAG,MAAM,CA4EtE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,QA4EzB,CAAC"}