@lapis-notes/api 0.1.4 → 0.2.1

package/dist/plugin-manager.d.ts

@@ -7,7 +7,7 @@ import { Plugin, type PluginConstructor, type PluginManifest, type PluginSource
 import { type HostedPluginCapability } from "./plugin-capability-facade";
 import { type PluginDependencyResolver, type PluginDependencyResolverFactory } from "./plugin-dependency-resolver";
 import { type PluginAssetServer } from "./plugin-asset-server";
-import type { PluginProvenance } from "./plugin-distribution/types";
+import type { PluginProvenance, PluginHostRestrictions } from "./plugin-distribution/types";
 import { EventDispatcher } from "./events";
 import type { SyncHostCapabilities } from "./sync-host";
 export interface PluginLoader {
@@ -39,6 +39,7 @@ export interface CommunityPluginExecutionHost {
     evaluate(request: CommunityPluginEvaluationRequest): Promise<unknown>;
 }
 export interface PluginManagerOptions {
+    unavailablePlugins?: PluginHostRestrictions;
     communityPluginHost?: CommunityPluginExecutionHost;
     createCommunityPluginDependencyResolver?: PluginDependencyResolverFactory;
     pluginAssetServer?: PluginAssetServer;
@@ -164,6 +165,7 @@ export interface PluginEvents {
     "plugin-loaded": [plugin: Plugin];
     "plugin-enabled": [plugin: Plugin];
     "plugin-disabled": [plugin: Plugin];
+    "plugin-unloaded": [pluginId: string];
     "community-plugin-config-pruned": [pluginIds: string[]];
     "plugin-error": [id: string, message: string, error?: any];
 }
@@ -179,6 +181,15 @@ export declare class PluginManager extends EventDispatcher<PluginEvents> {
     get corePlugins(): Plugin[];
     get communityPlugins(): Plugin[];
     isPluginEnabled(pluginId: string): boolean;
+    /** Registered application profiles own their identities, even when disabled. */
+    isStaticPlugin(pluginId: string): boolean;
+    /** Release an external registration before the installer removes its code. */
+    unloadPlugin(pluginId: string): Promise<boolean>;
+    /** Retire a loaded module while preserving its configured startup choice. */
+    preparePluginReplacement(pluginId: string): Promise<{
+        reloadRequired: boolean;
+        rollback(): Promise<void>;
+    } | undefined>;
     get corePluginEntries(): CorePluginListEntry[];
     get communityPluginHostId(): string;
     get pluginAssetServer(): PluginAssetServer | undefined;
@@ -215,11 +226,12 @@ export declare class PluginManager extends EventDispatcher<PluginEvents> {
     private resolveExternalPluginSource;
     private readPluginListConfig;
     private readCorePluginStateConfig;
-    private savePluginListConfig;
-    private saveCorePluginStateConfig;
+    private queuePluginState;
     private saveCommunityPluginState;
     private saveCorePluginState;
-    flushPendingConfigWrites(): void;
+    flushPendingConfigWrites(): Promise<void>;
+    private readPluginState;
+    private restoreCorePluginState;
     private isCorePluginEnabled;
     private pruneMissingConfiguredCommunityPlugins;
     private enableConfiguredIndexedExtensions;
@@ -230,8 +242,11 @@ export declare class PluginManager extends EventDispatcher<PluginEvents> {
     }): Promise<Plugin | null>;
     private registerPlugin;
     private syncLegacyPluginData;
+    private syncLegacyPluginDataNow;
     enablePlugin(pluginId: string): Promise<boolean>;
+    private enablePluginNow;
     disablePlugin(pluginId: string): Promise<boolean>;
+    private disablePluginNow;
     restartPlugin(pluginId: string): Promise<boolean>;
     private capturePluginOwnedLeaves;
     private replacePluginOwnedLeaves;
@@ -295,6 +310,7 @@ export declare class PluginManager extends EventDispatcher<PluginEvents> {
     private getSelectedCodeEntry;
     private getSelectedCommunityModulePath;
     private getSelectedLapisRuntimeEntry;
+    private isTauriSession;
     private getHostIdForManifest;
     private getHostIdForIndexedExtension;
     private getSelectedRuntimeEntryForManifest;

package/dist/plugin-manager.js

@@ -10,7 +10,7 @@ import { scanBarePluginDependencySpecifiers } from "./plugin-dependency-scanner"
 import pluginHostModuleRegistry from "./generated/plugin-host-modules.schema.generated";
 import { InstalledPluginStateStore } from "./plugin-distribution/installed-plugin-state";
 import { dirname, getAdapterVaultId, joinPath, normalizePath } from "./storage";
-import { debounce } from "lodash-es";
+import { readFileState, saveFileState } from "./file-state-store";
 import { EventDispatcher } from "./events";
 function formatPluginError(error) {
     return error instanceof Error ? error.message : String(error);
@@ -396,6 +396,7 @@ export class PluginManager extends EventDispatcher {
     #defaultDisabledCorePlugins = new Set();
     #corePluginStyles = new Map();
     #corePluginDistribution = new Map();
+    #pendingReloadPlugins = new Set();
     #installedPluginProvenance = new Map();
     #installedPluginStateStore;
     #basesViewRegistrations = new Map();
@@ -412,6 +413,7 @@ export class PluginManager extends EventDispatcher {
     #deferredIndexedExtensions = new Map();
     #communityPluginHost;
     #pluginAssetServer;
+    #unavailablePlugins;
     #createSyncHostCapabilities;
     #revokeSyncHostCapabilities;
     constructor(app, pluginsPath, adapter, options = {}) {
@@ -423,6 +425,7 @@ export class PluginManager extends EventDispatcher {
         const dependencyResolver = options.createCommunityPluginDependencyResolver?.(this.dependencies) ??
             this.dependencies;
         this.#pluginAssetServer = options.pluginAssetServer;
+        this.#unavailablePlugins = { ...options.unavailablePlugins };
         this.#createSyncHostCapabilities = options.createSyncHostCapabilities;
         this.#revokeSyncHostCapabilities = options.revokeSyncHostCapabilities;
         const commonJsHost = options.communityPluginHost ??
@@ -438,7 +441,7 @@ export class PluginManager extends EventDispatcher {
             if (event.origin === "plugin-save") {
                 return;
             }
-            void this.syncLegacyPluginData(event.pluginId);
+            void this.syncLegacyPluginData(event.pluginId, event.value === undefined && event.prev !== undefined);
         });
     }
     getPluginFolder() {
@@ -453,6 +456,55 @@ export class PluginManager extends EventDispatcher {
     isPluginEnabled(pluginId) {
         return Boolean(this.plugins.get(pluginId)?.enabled);
     }
+    /** Registered application profiles own their identities, even when disabled. */
+    isStaticPlugin(pluginId) {
+        return (this.#corePluginDistribution.has(pluginId) ||
+            this.#systemExtensionManifests.has(pluginId));
+    }
+    /** Release an external registration before the installer removes its code. */
+    async unloadPlugin(pluginId) {
+        if (this.isStaticPlugin(pluginId))
+            return false;
+        const plugin = this.plugins.get(pluginId);
+        if (plugin && !(await this.disablePlugin(pluginId)))
+            return false;
+        this.disableManifestOnlyExtension(pluginId);
+        this.plugins.delete(pluginId);
+        this.#lapisExtensionIndex.delete(pluginId);
+        this.#communityPluginDiagnostics.delete(pluginId);
+        this.#communityPluginDependencyDiagnostics.delete(pluginId);
+        this.#communityPluginRuntimeExecutionDiagnostics.delete(pluginId);
+        this.#installedPluginProvenance.delete(pluginId);
+        if (plugin)
+            this.#pendingReloadPlugins.add(pluginId);
+        if (this.#configuredCommunityPlugins.delete(pluginId))
+            this.saveCommunityPluginState();
+        await this.flushPendingConfigWrites();
+        this.emit("plugin-unloaded", pluginId);
+        return true;
+    }
+    /** Retire a loaded module while preserving its configured startup choice. */
+    async preparePluginReplacement(pluginId) {
+        if (this.isStaticPlugin(pluginId))
+            throw new Error(`Plugin ${pluginId} is registered by the application`);
+        const plugin = this.plugins.get(pluginId);
+        if (!plugin)
+            return undefined;
+        const wasEnabled = plugin.enabled;
+        const wasPendingReload = this.#pendingReloadPlugins.has(pluginId);
+        if (!(await this.disablePluginNow(pluginId, false)))
+            throw new Error(`Plugin ${pluginId} could not finish replacement teardown`);
+        this.#pendingReloadPlugins.add(pluginId);
+        return {
+            reloadRequired: true,
+            rollback: async () => {
+                if (!wasPendingReload)
+                    this.#pendingReloadPlugins.delete(pluginId);
+                if (wasEnabled && !(await this.enablePlugin(pluginId)))
+                    throw new Error(`Plugin ${pluginId} could not restore its previous runtime`);
+            },
+        };
+    }
     get corePluginEntries() {
         const runtimePlugins = this.corePlugins.map((plugin) => ({
             manifest: plugin.manifest,
@@ -461,9 +513,7 @@ export class PluginManager extends EventDispatcher {
             source: plugin.source,
             provenance: plugin.provenance,
             distribution: this.#corePluginDistribution.get(plugin.manifest.id) ??
-                (plugin.source === "official"
-                    ? "first-party-external"
-                    : "bundled"),
+                (plugin.source === "official" ? "first-party-external" : "bundled"),
             errorMessage: plugin.errorMessage,
         }));
         const runtimeSystemPlugins = [...this.plugins.values()].filter((plugin) => plugin.source === "system");
@@ -575,9 +625,7 @@ export class PluginManager extends EventDispatcher {
                 }
                 const registeredPlugin = this.registerPlugin(plugin, {
                     source: "core",
-                    provenance: distribution === "first-party-external"
-                        ? "official"
-                        : "bundled",
+                    provenance: distribution === "first-party-external" ? "official" : "bundled",
                     required,
                     basePath: pluginPath,
                 });
@@ -756,6 +804,8 @@ export class PluginManager extends EventDispatcher {
             });
             await this.activateIndexedExtensionsForWorkspace();
             this.#loaded = true;
+            if (this.app.nativeTasks)
+                await this.app.nativeTasks.load();
             this.emit("plugins-loaded");
             await this.activateByEvent("onStartupFinished");
         }, {
@@ -890,14 +940,21 @@ export class PluginManager extends EventDispatcher {
     async readPluginListConfig(filename, options = {}) {
         const configPath = this.getPluginStatePath(filename);
         try {
-            const exists = await this.adapter.exists(configPath);
-            if (!exists) {
+            const data = await this.readPluginState(configPath, (text) => {
+                const value = JSON.parse(text || "[]");
+                if (!Array.isArray(value) || value.some((id) => typeof id !== "string"))
+                    throw new Error("Invalid community plugin configuration");
+                this.#configuredCommunityPlugins = new Set(value);
+            });
+            if (data === null) {
                 if (options.createIfMissing) {
-                    await this.adapter.write(configPath, "[]");
+                    if (this.app.vault.supportsConditionalTextWrites)
+                        await saveFileState(this.app, configPath, "[]");
+                    else
+                        await this.adapter.write(configPath, "[]");
                 }
                 return [];
             }
-            const data = await this.adapter.read(configPath);
             const plugins = JSON.parse(data);
             if (Array.isArray(plugins)) {
                 return plugins.map((it) => it.toString());
@@ -911,11 +968,9 @@ export class PluginManager extends EventDispatcher {
     async readCorePluginStateConfig() {
         const configPath = this.getPluginStatePath("core-plugins.json");
         try {
-            const exists = await this.adapter.exists(configPath);
-            if (!exists) {
+            const data = await this.readPluginState(configPath, (text) => this.restoreCorePluginState(text));
+            if (data === null)
                 return { disabled: [], enabled: [] };
-            }
-            const data = await this.adapter.read(configPath);
             const config = JSON.parse(data);
             if (Array.isArray(config)) {
                 return {
@@ -939,51 +994,80 @@ export class PluginManager extends EventDispatcher {
         }
         return { disabled: [], enabled: [] };
     }
-    async savePluginListConfig(filename, pluginIds) {
-        const configPath = this.getPluginStatePath(filename);
-        try {
-            const file = this.app.vault.getFileByPath(configPath);
-            const payload = JSON.stringify([...pluginIds], null, 2);
-            if (file) {
-                await this.app.vault.modify(file, payload);
-                return;
-            }
-            await this.app.vault.create(configPath, payload);
-        }
-        catch (error) {
-            this.reportPluginError(configPath, `Failed to save plugin config ${configPath}: ${formatPluginError(error)}`, error);
-        }
-    }
-    async saveCorePluginStateConfig() {
-        const configPath = this.getPluginStatePath("core-plugins.json");
+    #pendingConfigWrites = new Set();
+    queuePluginState(filename, value) {
+        const path = this.getPluginStatePath(filename);
+        const payload = JSON.stringify(value, null, 2);
+        const operation = this.app.vault.supportsConditionalTextWrites
+            ? saveFileState(this.app, path, payload)
+            : (async () => {
+                const file = this.app.vault.getFileByPath(path);
+                if (file)
+                    await this.app.vault.modify(file, payload);
+                else
+                    await this.app.vault.create(path, payload);
+            })();
+        this.#pendingConfigWrites.add(operation);
+        void operation.then(() => this.#pendingConfigWrites.delete(operation), (error) => {
+            this.#pendingConfigWrites.delete(operation);
+            this.reportPluginError(path, `Failed to save plugin config ${path}: ${formatPluginError(error)}`, error);
+        });
+        return this.app.vault.supportsConditionalTextWrites
+            ? operation
+            : operation.catch(() => undefined);
+    }
+    saveCommunityPluginState = () => {
+        this.queuePluginState("community-plugins.json", [
+            ...this.#configuredCommunityPlugins,
+        ]);
+    };
+    saveCorePluginState = () => {
+        this.queuePluginState("core-plugins.json", this.#enabledCorePlugins.size === 0
+            ? [...this.#disabledCorePlugins]
+            : {
+                disabled: [...this.#disabledCorePlugins],
+                enabled: [...this.#enabledCorePlugins],
+            });
+    };
+    async flushPendingConfigWrites() {
+        if (this.app.vault.supportsConditionalTextWrites)
+            await this.app.fileEditingSessions.settleOperations();
+        await Promise.all([...this.#pendingConfigWrites]);
+    }
+    async readPluginState(path, reset) {
+        if (this.app.vault.supportsConditionalTextWrites)
+            return readFileState(this.app, path, reset);
+        return (await this.adapter.exists(path)) ? this.adapter.read(path) : null;
+    }
+    async restoreCorePluginState(text) {
+        const value = JSON.parse(text || "[]");
+        if (!Array.isArray(value) && !isRecord(value))
+            throw new Error("Invalid core plugin configuration");
+        const disabled = Array.isArray(value) ? value : (value.disabled ?? []);
+        const enabled = Array.isArray(value) ? [] : (value.enabled ?? []);
+        if (!Array.isArray(disabled) ||
+            !Array.isArray(enabled) ||
+            [...disabled, ...enabled].some((id) => typeof id !== "string"))
+            throw new Error("Invalid core plugin configuration");
+        this.#disabledCorePlugins = new Set(disabled);
+        this.#enabledCorePlugins = new Set(enabled);
+        const loaded = this.#loaded;
+        this.#loaded = false;
         try {
-            const file = this.app.vault.getFileByPath(configPath);
-            const payload = this.#enabledCorePlugins.size === 0
-                ? JSON.stringify([...this.#disabledCorePlugins], null, 2)
-                : JSON.stringify({
-                    disabled: [...this.#disabledCorePlugins],
-                    enabled: [...this.#enabledCorePlugins],
-                }, null, 2);
-            if (file) {
-                await this.app.vault.modify(file, payload);
-                return;
+            for (const plugin of this.corePlugins) {
+                if (plugin.required)
+                    continue;
+                const success = this.isCorePluginEnabled(plugin.id)
+                    ? await this.enablePlugin(plugin.id)
+                    : await this.disablePlugin(plugin.id);
+                if (!success)
+                    throw new Error(`Could not restore plugin ${plugin.id}`);
             }
-            await this.app.vault.create(configPath, payload);
         }
-        catch (error) {
-            this.reportPluginError(configPath, `Failed to save plugin config ${configPath}: ${formatPluginError(error)}`, error);
+        finally {
+            this.#loaded = loaded;
         }
     }
-    saveCommunityPluginState = debounce(() => {
-        return void this.savePluginListConfig("community-plugins.json", this.#configuredCommunityPlugins);
-    }, 500);
-    saveCorePluginState = debounce(() => {
-        return void this.saveCorePluginStateConfig();
-    }, 500);
-    flushPendingConfigWrites() {
-        this.saveCommunityPluginState.flush();
-        this.saveCorePluginState.flush();
-    }
     isCorePluginEnabled(pluginId) {
         if (this.#disabledCorePlugins.has(pluginId)) {
             return false;
@@ -1016,7 +1100,9 @@ export class PluginManager extends EventDispatcher {
         for (const pluginId of missingPluginIds) {
             this.#configuredCommunityPlugins.delete(pluginId);
         }
-        await this.savePluginListConfig("community-plugins.json", this.#configuredCommunityPlugins);
+        await this.queuePluginState("community-plugins.json", [
+            ...this.#configuredCommunityPlugins,
+        ]);
         this.emit("community-plugin-config-pruned", missingPluginIds);
         return missingPluginIds;
     }
@@ -1072,6 +1158,15 @@ export class PluginManager extends EventDispatcher {
                 const manifestContent = await this.adapter.read(manifestPath);
                 manifest = JSON.parse(manifestContent);
                 pluginId = manifest.id || pluginId;
+                if (this.isStaticPlugin(pluginId)) {
+                    throw new Error(`Plugin id ${pluginId} is registered by the application`);
+                }
+                if (Object.hasOwn(this.#unavailablePlugins, manifest.id)) {
+                    throw new Error(`Plugin ${manifest.id} is unavailable: ${this.#unavailablePlugins[manifest.id]}`);
+                }
+                if (this.#pendingReloadPlugins.has(manifest.id)) {
+                    throw new Error(`Reload the app to load updated plugin ${manifest.id}`);
+                }
                 span.setAttribute("plugin.id", manifest.id);
                 manifest.dir ??= pluginPath;
                 const runtimeSource = options.source !== undefined
@@ -1124,6 +1219,14 @@ export class PluginManager extends EventDispatcher {
                 if (!(plugin instanceof Plugin)) {
                     throw new Error(`Plugin ${manifest.id} does not extend the Plugin base class`);
                 }
+                const installed = await this.#installedPluginStateStore.get(manifest.id);
+                if (installed?.restartRequired &&
+                    installed.installedVersion === manifest.version) {
+                    await this.#installedPluginStateStore.upsert({
+                        ...installed,
+                        restartRequired: false,
+                    });
+                }
                 return this.registerPlugin(plugin, {
                     source: runtimeSource.source,
                     provenance: runtimeSource.provenance,
@@ -1132,8 +1235,9 @@ export class PluginManager extends EventDispatcher {
             }
             catch (error) {
                 const message = `Failed to load plugin from ${pluginPath}: ${formatPluginError(error)}`;
-                this.recordCommunityPluginFailure(pluginId, manifest, message);
-                this.reportPluginError(pluginPath, message, error);
+                if (!this.isStaticPlugin(pluginId))
+                    this.recordCommunityPluginFailure(pluginId, manifest, message);
+                this.reportPluginError(pluginId, message, error);
                 return null;
             }
         }, { slowThresholdMs: 200 });
@@ -1200,7 +1304,13 @@ export class PluginManager extends EventDispatcher {
         void this.syncLegacyPluginData(plugin.manifest.id);
         return plugin;
     }
-    async syncLegacyPluginData(pluginId) {
+    syncLegacyPluginData(pluginId, removeMissing = false) {
+        const run = () => this.syncLegacyPluginDataNow(pluginId, removeMissing);
+        return this.app.vault.supportsConditionalTextWrites
+            ? this.app.fileEditingSessions.track(run)
+            : run();
+    }
+    async syncLegacyPluginDataNow(pluginId, removeMissing) {
         const plugin = this.plugins.get(pluginId);
         if (!plugin) {
             return;
@@ -1211,6 +1321,9 @@ export class PluginManager extends EventDispatcher {
         }
         try {
             if (!this.app.configuration.hasPluginData(pluginId)) {
+                // Registration is not a deletion: loadData still needs this legacy file.
+                if (!removeMissing)
+                    return;
                 const file = this.app.vault.getFileByPath(path);
                 if (file) {
                     await this.app.vault.delete(file, true);
@@ -1218,6 +1331,10 @@ export class PluginManager extends EventDispatcher {
                 return;
             }
             const payload = JSON.stringify(this.app.configuration.getPluginData(pluginId), null, 2);
+            if (this.app.vault.supportsConditionalTextWrites) {
+                await saveFileState(this.app, path, payload);
+                return;
+            }
             const file = this.app.vault.getFileByPath(path);
             if (file) {
                 await this.app.vault.modify(file, payload);
@@ -1230,7 +1347,17 @@ export class PluginManager extends EventDispatcher {
             this.reportPluginError(pluginId, `Failed to sync legacy plugin data for ${pluginId}: ${formatPluginError(error)}`, error);
         }
     }
-    async enablePlugin(pluginId) {
+    enablePlugin(pluginId) {
+        const run = () => this.enablePluginNow(pluginId);
+        return this.#loaded && this.app.vault.supportsConditionalTextWrites
+            ? this.app.fileEditingSessions.track(run)
+            : run();
+    }
+    async enablePluginNow(pluginId) {
+        if (this.#pendingReloadPlugins.has(pluginId)) {
+            this.reportPluginError(pluginId, `Reload the app to activate updated plugin ${pluginId}`);
+            return false;
+        }
         const plugin = this.plugins.get(pluginId);
         if (!plugin) {
             const indexedExtension = this.#lapisExtensionIndex.get(pluginId);
@@ -1351,7 +1478,13 @@ export class PluginManager extends EventDispatcher {
             slowThresholdMs: 300,
         });
     }
-    async disablePlugin(pluginId) {
+    disablePlugin(pluginId) {
+        const run = () => this.disablePluginNow(pluginId);
+        return this.#loaded && this.app.vault.supportsConditionalTextWrites
+            ? this.app.fileEditingSessions.track(run)
+            : run();
+    }
+    async disablePluginNow(pluginId, persist = true) {
         const plugin = this.plugins.get(pluginId);
         if (!plugin) {
             const indexedExtension = this.#lapisExtensionIndex.get(pluginId);
@@ -1361,7 +1494,7 @@ export class PluginManager extends EventDispatcher {
                     return false;
                 }
                 this.disableManifestOnlyExtension(pluginId);
-                if (this.#loaded) {
+                if (this.#loaded && persist) {
                     if (indexedExtension.source === "community" ||
                         indexedExtension.source === "official") {
                         this.#configuredCommunityPlugins.delete(pluginId);
@@ -1412,7 +1545,7 @@ export class PluginManager extends EventDispatcher {
                 this.unloadPluginCSS(pluginId);
                 this.updatePluginDiagnosticsFromPlugin(plugin);
                 this.emit("plugin-disabled", plugin);
-                if (this.#loaded) {
+                if (this.#loaded && persist) {
                     if (plugin.source === "community" || plugin.source === "official") {
                         this.#configuredCommunityPlugins.delete(pluginId);
                         this.saveCommunityPluginState();
@@ -1444,6 +1577,8 @@ export class PluginManager extends EventDispatcher {
         });
     }
     async restartPlugin(pluginId) {
+        if (this.#pendingReloadPlugins.has(pluginId))
+            return this.enablePlugin(pluginId);
         let plugin = this.plugins.get(pluginId);
         if (!plugin) {
             plugin =
@@ -1613,6 +1748,20 @@ export class PluginManager extends EventDispatcher {
             throw new Error(`Plugin ${manifest.id} can only run in the desktop app`);
         }
         if (isExternalPluginSource(source)) {
+            const services = manifest.requiredNativeServices;
+            if (services !== undefined) {
+                if (!Array.isArray(services) ||
+                    services.some((id) => typeof id !== "string" || !id.trim()))
+                    throw new Error(`Plugin ${manifest.id} declares invalid required native services`);
+                const capabilities = getNativeDesktopBridge()?.capabilities;
+                for (const id of services) {
+                    const service = capabilities?.[id];
+                    if (!service)
+                        throw new Error(`Plugin ${manifest.id} requires unsupported native service: ${id}`);
+                    if (service.status !== "available")
+                        throw new Error(`Plugin ${manifest.id} requires disabled native service: ${id}`);
+                }
+            }
             if (requiresWorkspaceTrust(manifest) &&
                 !this.app.workspaceTrust.trusted) {
                 throw new Error(trustFailureMessage(manifest));
@@ -2647,11 +2796,19 @@ export class PluginManager extends EventDispatcher {
         }
         return selected?.path ?? null;
     }
+    isTauriSession() {
+        return ((this.app.session?.runtime ?? getNativeDesktopBridge()?.runtime) ===
+            "tauri-desktop");
+    }
     getHostIdForManifest(manifest) {
+        if (this.isTauriSession())
+            return "tauri-desktop";
         return (this.#communityPluginHost.hostIdForManifest?.(manifest) ??
             this.#communityPluginHost.id);
     }
     getHostIdForIndexedExtension(indexedExtension) {
+        if (this.isTauriSession())
+            return "tauri-desktop";
         return isSidecarHost(this.#communityPluginHost.id) &&
             (indexedExtension.runtime?.desktop ||
                 indexedExtension.runtime?.trustedDesktop ||
@@ -2705,6 +2862,8 @@ export class PluginManager extends EventDispatcher {
         return this.getRequestedPluginExecutionHostForHostId(this.getHostIdForManifest(manifest));
     }
     getRequestedPluginExecutionHostForHostId(hostId) {
+        if (hostId === "tauri-desktop")
+            return "tauri-desktop";
         if (isSidecarHost(hostId)) {
             return "electron-sidecar";
         }
@@ -2802,6 +2961,9 @@ function runtimeMatchesHost(runtime, hostId) {
     if (runtime === hostId) {
         return true;
     }
+    if (hostId === "tauri-desktop") {
+        return ["renderer", "workspace", "browser", "pwa", "web"].includes(runtime);
+    }
     if (hostId === "renderer") {
         return ["renderer", "browser", "pwa", "web"].includes(runtime);
     }
@@ -2825,6 +2987,8 @@ function isSidecarHost(hostId) {
 }
 function hostPlatformMatchesDependencyPlatform(host, platform) {
     switch (host) {
+        case "tauri-desktop":
+            return platform === "web";
         case "electron-sidecar":
             return platform === "electron-sidecar";
         case "electron-renderer":

package/dist/plugin-runtime-entry.d.ts

@@ -1,6 +1,6 @@
 import type { LapisPluginModuleFormat } from "./lapis-extension";
 import type { PluginManifest } from "./plugin";
-export type PluginExecutionHostId = "workspace" | "electron-renderer" | "electron-sidecar";
+export type PluginExecutionHostId = "workspace" | "tauri-desktop" | "electron-renderer" | "electron-sidecar";
 export interface SelectedPluginRuntimeEntry {
     host: PluginExecutionHostId;
     path: string;

package/dist/plugin-runtime-entry.js

@@ -5,6 +5,22 @@ export function selectPluginRuntimeEntry(options) {
     const structuredEntry = lapis
         ? selectStructuredEntry(lapis, options.requestedHost)
         : null;
+    // Tauri executes portable browser ESM only. Never select a compatibility
+    // fallback or an Electron/native service entry, even when main.js exists.
+    if (options.requestedHost === "tauri-desktop") {
+        const entry = lapis?.runtime?.entries?.workspace;
+        if (!options.supportsEsm || entry?.format !== "esm")
+            return null;
+        return {
+            host: "tauri-desktop",
+            path: entry.path,
+            format: "esm",
+            sharedDependencies: entry.sharedDependencies ??
+                getSharedDependencyDefaults(lapis, "workspace"),
+            requiresReloadOnUpdate: entry.requiresReloadOnUpdate,
+            source: "lapis-runtime-entry",
+        };
+    }
     if (!lapis) {
         if (!options.hasMainJs) {
             return null;