@dxos/app-framework 0.8.4-main.74a063c4e0 → 0.8.4-main.765dc60934

package/dist/types/src/core/plugin-asset-cache.d.ts

@@ -0,0 +1,71 @@
+import * as Effect from 'effect/Effect';
+import { BaseError } from '@dxos/errors';
+declare const PluginAssetCacheError_base: {
+    new (options?: import("@dxos/errors").BaseErrorOptions): {
+        cause?: unknown;
+        stack?: string;
+        name: "PluginAssetCacheError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "PluginAssetCacheError";
+    };
+    isError(error: unknown): error is Error;
+    name: "PluginAssetCacheError";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, 'cause'> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        cause?: unknown;
+        stack?: string;
+        name: "PluginAssetCacheError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "PluginAssetCacheError";
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * Tagged error for cache operations. Construction sites supply `context.operation`
+ * (one of `'cache' | 'evict' | 'resolve' | 'list'`) and `context.pluginId` so
+ * downstream handlers can route on the failed call without scanning the message.
+ */
+export declare class PluginAssetCacheError extends PluginAssetCacheError_base {
+}
+/**
+ * Per-platform offline cache for third-party plugin assets.
+ *
+ * Implementations live alongside their platform glue (composer-app's
+ * `asset-cache/{tauri,service-worker}.ts`); the no-op default is for tests
+ * and unsupported environments.
+ */
+export interface Cache {
+    /**
+     * Persist all listed URLs under the namespace of `pluginId`. Idempotent.
+     * The order of `urls` is significant — the first entry is treated as the entry module.
+     */
+    cache(pluginId: string, urls: readonly string[]): Effect.Effect<void, PluginAssetCacheError>;
+    /**
+     * Drop all assets for a plugin (uninstall).
+     */
+    evict(pluginId: string): Effect.Effect<void, PluginAssetCacheError>;
+    /**
+     * Resolves a plugin asset URL to a platform-specific cached URL when one is available.
+     * Returns the original URL when no cached copy exists or the platform serves cached
+     * responses transparently (e.g. service worker fetch interception on web).
+     */
+    resolve(pluginId: string, url: string): Effect.Effect<string, PluginAssetCacheError>;
+    /**
+     * List currently cached plugin ids (diagnostic).
+     */
+    list(): Effect.Effect<readonly string[], PluginAssetCacheError>;
+}
+/**
+ * No-op implementation. Used when no platform cache is registered (tests, unsupported environments).
+ * Plugins still load — they just have no offline guarantee.
+ */
+export declare const noop: () => Cache;
+export {};
+//# sourceMappingURL=plugin-asset-cache.d.ts.map

package/dist/types/src/core/plugin-asset-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-asset-cache.d.ts","sourceRoot":"","sources":["../../../../src/core/plugin-asset-cache.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEzC;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,0BAG1C;CAAG;AAEJ;;;;;;GAMG;AACH,MAAM,WAAW,KAAK;IACpB;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IAE7F;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IAEpE;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAErF;;OAEG;IACH,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,qBAAqB,CAAC,CAAC;CACjE;AAED;;;GAGG;AACH,eAAO,MAAM,IAAI,QAAO,KAKtB,CAAC"}

package/dist/types/src/core/plugin-manager.d.ts

@@ -1,20 +1,153 @@
 import { Atom, Registry } from '@effect-atom/atom-react';
+import * as Duration from 'effect/Duration';
 import * as Effect from 'effect/Effect';
 import * as PubSub from 'effect/PubSub';
+import { BaseError } from '@dxos/errors';
 import * as ActivationEvent from './activation-event';
 import * as CapabilityManager from './capability-manager';
 import * as Plugin from './plugin';
+import * as PluginRegistry from './registry';
+declare const PluginInitializationError_base: {
+    new (options?: import("@dxos/errors").BaseErrorOptions): {
+        cause?: unknown;
+        stack?: string;
+        name: "PluginInitializationError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "PluginInitializationError";
+    };
+    isError(error: unknown): error is Error;
+    name: "PluginInitializationError";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, 'cause'> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        cause?: unknown;
+        stack?: string;
+        name: "PluginInitializationError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "PluginInitializationError";
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * Tagged error for failures during the constructor-launched core/enabled
+ * `enable()` chain. Surfaces via {@link PluginManager.activate}'s wait on
+ * `_initialization` so a caller blocked on initialization gets a typed
+ * failure (with the original error preserved as `cause`) instead of an
+ * untyped `Error`.
+ */
+export declare class PluginInitializationError extends PluginInitializationError_base {
+}
+declare const PluginTimeoutError_base: {
+    new (options?: import("@dxos/errors").BaseErrorOptions): {
+        cause?: unknown;
+        stack?: string;
+        name: "PluginTimeoutError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "PluginTimeoutError";
+    };
+    isError(error: unknown): error is Error;
+    name: "PluginTimeoutError";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, 'cause'> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        cause?: unknown;
+        stack?: string;
+        name: "PluginTimeoutError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "PluginTimeoutError";
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * Tagged error raised when a plugin exceeds its configured load or activation
+ * timeout. The plugin manager records the failure on the `failed` atom and
+ * auto-disables the plugin so that one stuck remote does not stall app boot.
+ * `context.id` is the plugin id, `context.phase` is `'load'` or `'activation'`.
+ */
+export declare class PluginTimeoutError extends PluginTimeoutError_base {
+}
+/** Phase of the plugin lifecycle in which the failure was observed. */
+export type PluginFailurePhase = 'load' | 'activation';
+/** Why the plugin entered a failed state. */
+export type PluginFailureReason = 'timeout' | 'error';
+/**
+ * Record of a plugin that failed to load or activate. Surfaced via the
+ * {@link PluginManager.failed} atom so registry / UI consumers can flag
+ * unhealthy plugins (e.g. a remote host that has gone offline) rather than
+ * leaving the app in a half-broken state.
+ */
+export type PluginFailure = {
+    readonly id: string;
+    readonly phase: PluginFailurePhase;
+    readonly reason: PluginFailureReason;
+    readonly error: Error;
+    /** `Date.now()` when the failure was recorded. */
+    readonly timestamp: number;
+};
 /**
  * Identifier denoting a Manager.
  */
 export declare const ManagerTypeId: unique symbol;
 export type ManagerTypeId = typeof ManagerTypeId;
+/**
+ * Loader result that carries optional metadata about how the plugin was sourced.
+ *
+ * `dev: true` marks a plugin as session-only and triggers shadow-on-id-collision
+ * inside the manager: if a plugin with the same id is already registered (a
+ * builtin, or a previously-installed plugin from the registry), the dev plugin
+ * temporarily takes over that id slot. The original is restored when the dev
+ * plugin is removed (or on page reload, since dev plugins aren't persisted).
+ */
+export type LoadedPlugin = {
+    plugin: Plugin.Plugin;
+    /** True when the plugin came from a dev source. See type doc for semantics. */
+    dev?: boolean;
+};
 export type ManagerOptions = {
-    pluginLoader: (id: string) => Effect.Effect<Plugin.Plugin, Error>;
+    pluginLoader: (id: string) => Effect.Effect<LoadedPlugin, Error>;
     plugins?: Plugin.Plugin[];
     core?: string[];
     enabled?: string[];
     registry?: Registry.Registry;
+    /**
+     * Backend for the plugin registry catalog. When omitted the manager exposes a
+     * no-op `pluginRegistry` (empty list, no versions endpoint). Implementations
+     * live in app-framework alongside the interface (e.g.
+     * `EdgeRegistryPluginProvider`); the host app instantiates one and passes it in.
+     */
+    pluginRegistryProvider?: PluginRegistry.PluginProvider;
+    /**
+     * Hook called when a plugin is removed via {@link PluginManager.remove}. Used by the
+     * host app to clean up persisted state (e.g. evict offline-cached plugin assets).
+     * Failures are logged and swallowed; removal still succeeds even if the hook fails.
+     */
+    onRemove?: (id: string) => Effect.Effect<void, unknown>;
+    /**
+     * Maximum time allowed for a lazy plugin's dynamic `import()` to resolve.
+     * Plugins that exceed this are flagged on the {@link PluginManager.failed}
+     * atom and auto-disabled so a stuck remote host can't stall app boot.
+     * Defaults to 30 seconds; pass `Duration.infinity` to disable.
+     */
+    loadTimeout?: Duration.DurationInput;
+    /**
+     * Maximum time allowed for a single module's `activate()` Effect to settle.
+     * Modules that exceed this fail with {@link PluginTimeoutError}; the owning
+     * plugin is recorded on `failed` and auto-disabled. Defaults to 30 seconds;
+     * pass `Duration.infinity` to disable.
+     */
+    activationTimeout?: Duration.DurationInput;
 };
 export type ActivationMessage = {
     event: string;
@@ -31,6 +164,13 @@ export interface PluginManager {
     readonly activation: PubSub.PubSub<ActivationMessage>;
     readonly capabilities: CapabilityManager.CapabilityManager;
     readonly registry: Registry.Registry;
+    /**
+     * Cached registry catalog state plus pass-throughs for `listVersions` /
+     * `getPlugin`. Always present — the host supplies a `pluginRegistryProvider`
+     * via {@link ManagerOptions} for real backends, or it falls back to a no-op
+     * implementation that yields an empty catalog.
+     */
+    readonly pluginRegistry: PluginRegistry.Manager;
     readonly plugins: Atom.Atom<readonly Plugin.Plugin[]>;
     readonly core: Atom.Atom<readonly string[]>;
     readonly enabled: Atom.Atom<readonly string[]>;
@@ -38,6 +178,19 @@ export interface PluginManager {
     readonly active: Atom.Atom<readonly string[]>;
     readonly eventsFired: Atom.Atom<readonly string[]>;
     readonly pendingReset: Atom.Atom<readonly string[]>;
+    /**
+     * Plugins that failed to load or activate. Subscribers (e.g. the registry
+     * UI) can use this to flag unhealthy entries; a plugin id appears here at
+     * most once with its most recent failure.
+     */
+    readonly failed: Atom.Atom<readonly PluginFailure[]>;
+    /**
+     * Ids of currently-registered plugins that came from a dev source (loaded
+     * via {@link LoadedPlugin} with `dev: true`). Subscribers can use this to
+     * badge dev-overridden plugins or to derive the id of the active dev plugin
+     * for an "uninstall dev plugin" affordance.
+     */
+    readonly devPluginIds: Atom.Atom<readonly string[]>;
     getPlugins(): readonly Plugin.Plugin[];
     getCore(): readonly string[];
     getEnabled(): readonly string[];
@@ -45,10 +198,81 @@ export interface PluginManager {
     getActive(): readonly string[];
     getEventsFired(): readonly string[];
     getPendingReset(): readonly string[];
-    add(id: string): Effect.Effect<boolean, Error>;
-    enable(id: string): Effect.Effect<boolean, Error>;
-    remove(id: string): boolean;
-    disable(id: string): Effect.Effect<boolean, Error>;
+    getFailed(): readonly PluginFailure[];
+    getDevPluginIds(): readonly string[];
+    /**
+     * Clears the failure record for a plugin so it can be retried. Returns
+     * whether a failure record existed and was removed.
+     */
+    clearFailure(id: string): boolean;
+    /**
+     * Loads a plugin via the plugin loader and registers it without enabling it.
+     * Returns the loaded plugin so callers can enable it by its canonical id
+     * (which may differ from the locator used to load it, e.g. URL loaders).
+     */
+    add(id: string): Effect.Effect<Plugin.Plugin, Error>;
+    /**
+     * Enables a plugin.
+     *
+     * Default behavior auto-resolves the plugin's declared `dependsOn` closure:
+     * missing entries that exist in the plugin registry catalog are installed via
+     * {@link add}, then enabled in dependency-first order. Set `resolveDependencies`
+     * to `false` to enable only the named plugin and skip the closure walk
+     * entirely — useful when substituting an alternative plugin that satisfies
+     * the dependent's capability needs in its own way.
+     */
+    enable(id: string, opts?: {
+        resolveDependencies?: boolean;
+    }): Effect.Effect<boolean, Error>;
+    /**
+     * Removes a plugin from the manager (disables then unregisters).
+     *
+     * Honors the same cascade option as {@link disable}.
+     */
+    remove(id: string, opts?: {
+        cascade?: boolean;
+    }): Effect.Effect<boolean, Error>;
+    /**
+     * Disables a plugin.
+     *
+     * By default, cascades to currently-enabled dependents (transitively, leaves
+     * first) so disabling a depended-upon plugin never leaves its dependents
+     * stranded. Pass `cascade: false` to disable only the named plugin and leave
+     * its dependents enabled-but-broken — VS Code-style disable parity for
+     * callers that want the escape hatch (e.g. when swapping in an alternative
+     * implementation that satisfies the dependents' needs in its own way).
+     *
+     * Fails with {@link Plugin.PluginDependencyError} (`reason: 'core-dependent'`)
+     * when cascading would require disabling a core plugin; UI flows should
+     * surface their own confirmation before calling `disable` with the default.
+     */
+    disable(id: string, opts?: {
+        cascade?: boolean;
+    }): Effect.Effect<boolean, Error>;
+    /**
+     * Returns the plugin ids that the given plugin declares as dependencies.
+     *
+     * Walks `meta.dependsOn` from both registered plugins and the plugin registry
+     * catalog so callers can preview the closure for a plugin that isn't yet
+     * installed. With `transitive: true` (default), returns the full dependency
+     * closure in dependency-first order (deps before dependents). Without it,
+     * returns the direct declarations only.
+     */
+    getDependencies(id: string, opts?: {
+        transitive?: boolean;
+    }): readonly string[];
+    /**
+     * Returns the plugin ids that declare the given plugin as a dependency.
+     *
+     * Walks `meta.dependsOn` over registered plugins. With `transitive: true`
+     * (default), returns the full reverse closure. With `enabledOnly: true`,
+     * filters to currently-enabled dependents — used by UI flows to preview what
+     * a cascading disable would touch.
+     */
+    getDependents(id: string, opts?: {
+        transitive?: boolean;
+        enabledOnly?: boolean;
+    }): readonly string[];
     activate(event: ActivationEvent.ActivationEvent | string, params?: {
         before?: string;
         after?: string;
@@ -70,4 +294,5 @@ export declare const isManager: (value: unknown) => value is PluginManager;
  * Creates a new Plugin Manager instance.
  */
 export declare const make: (options: ManagerOptions) => PluginManager;
+export {};
 //# sourceMappingURL=plugin-manager.d.ts.map

package/dist/types/src/core/plugin-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-manager.d.ts","sourceRoot":"","sources":["../../../../src/core/plugin-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugin-manager.d.ts","sourceRoot":"","sources":["../../../../src/core/plugin-manager.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAIzD,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAKxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,KAAK,eAAe,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,iBAAiB,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAInC,OAAO,KAAK,cAAc,MAAM,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE7C;;;;;;GAMG;AACH,qBAAa,yBAA0B,SAAQ,8BAG9C;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEJ;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,uBAAoE;CAAG;AAE/G,uEAAuE;AACvE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,YAAY,CAAC;AAEvD,6CAA6C;AAC7C,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAQF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,OAAO,MAAkD,CAAC;AACtF,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;IACtB,+EAA+E;IAC/E,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC7B;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC;IACvD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxD;;;;;OAKG;IACH,WAAW,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC;IACrC;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,YAAY,GAAG,WAAW,GAAG,OAAO,CAAC;IAC5C,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACtD,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC,iBAAiB,CAAC;IAC3D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACrC;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC,OAAO,CAAC;IAEhD,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACtD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;IAC5D,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAC9C,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IACnD,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;IACrD;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAEpD,UAAU,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC;IACvC,OAAO,IAAI,SAAS,MAAM,EAAE,CAAC;IAC7B,UAAU,IAAI,SAAS,MAAM,EAAE,CAAC;IAChC,UAAU,IAAI,SAAS,MAAM,CAAC,YAAY,EAAE,CAAC;IAC7C,SAAS,IAAI,SAAS,MAAM,EAAE,CAAC;IAC/B,cAAc,IAAI,SAAS,MAAM,EAAE,CAAC;IACpC,eAAe,IAAI,SAAS,MAAM,EAAE,CAAC;IACrC,SAAS,IAAI,SAAS,aAAa,EAAE,CAAC;IACtC,eAAe,IAAI,SAAS,MAAM,EAAE,CAAC;IAErC;;;OAGG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAElC;;;;OAIG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAErD;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,mBAAmB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAE5F;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAEhF;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAEjF;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,MAAM,EAAE,CAAC;IAEhF;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,MAAM,EAAE,CAAC;IAErG,QAAQ,CACN,KAAK,EAAE,eAAe,CAAC,eAAe,GAAG,MAAM,EAC/C,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtD,KAAK,CAAC,KAAK,EAAE,eAAe,CAAC,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAEtF;;;;OAIG;IACH,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,UAAW,OAAO,KAAG,KAAK,IAAI,aAEnD,CAAC;AA61CF;;GAEG;AACH,eAAO,MAAM,IAAI,YAAa,cAAc,KAAG,aAAyC,CAAC"}

package/dist/types/src/core/plugin-manifest.d.ts

@@ -0,0 +1,101 @@
+import * as Effect from 'effect/Effect';
+import * as Schema from 'effect/Schema';
+import { BaseError } from '@dxos/errors';
+/**
+ * Default port the Vite plugin (`composerPlugin`) binds the dev server to.
+ *
+ * Shared single source of truth — `composerPlugin` reads it as the default
+ * port, and the host's "Load Dev Plugin" affordance pre-fills the manifest URL
+ * with `http://localhost:${PLUGIN_DEV_SERVER_PORT}/manifest.json`. Lives in
+ * app-framework rather than `@dxos/protocols` because the constant is a
+ * client-side convention (host loader + Vite plugin) rather than a wire-level
+ * protocol.
+ */
+export declare const PLUGIN_DEV_SERVER_PORT = 3967;
+declare const PluginManifestError_base: {
+    new (options?: import("@dxos/errors").BaseErrorOptions): {
+        cause?: unknown;
+        stack?: string;
+        name: "PluginManifestError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "PluginManifestError";
+    };
+    isError(error: unknown): error is Error;
+    name: "PluginManifestError";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, 'cause'> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        cause?: unknown;
+        stack?: string;
+        name: "PluginManifestError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "PluginManifestError";
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * Tagged error for manifest fetch / parse failures. Construction sites set
+ * `context.manifestUrl` and `context.reason` (one of `'fetch-failed' |
+ * 'http-error' | 'parse-failed' | 'invalid'`) so handlers can route on the
+ * specific failure mode.
+ */
+export declare class PluginManifestError extends PluginManifestError_base {
+}
+/**
+ * Schema for a third-party plugin manifest.
+ *
+ * Production manifests are published as a sibling of the plugin's entry module
+ * ({@link PLUGIN_ENTRY_FILENAME}) and advertise every file the plugin needs at
+ * runtime so the host can eagerly cache them for offline use.
+ *
+ * Dev manifests (served by `vite dev` via {@link composerPlugin}) set `devEntry`
+ * to point at the unbundled source entry. The host's loader treats the presence
+ * of `devEntry` as the dev-mode signal: it imports the entry directly from the
+ * dev server, skips eager asset caching, and skips static stylesheet injection
+ * (Vite handles CSS via runtime `<style>` injection during HMR). `assets` is not
+ * required to enumerate every file in dev mode — chunks and styles flow through
+ * the dev server on demand.
+ */
+export declare const Manifest: Schema.Struct<{
+    id: typeof Schema.String;
+    name: typeof Schema.String;
+    version: typeof Schema.String;
+    assets: Schema.Array$<typeof Schema.String>;
+    devEntry: Schema.optional<typeof Schema.String>;
+}>;
+export type Manifest = Schema.Schema.Type<typeof Manifest>;
+/**
+ * Resolved manifest with all asset paths converted to absolute URLs.
+ *
+ * `dev` reflects whether the source manifest declared a `devEntry`. Loaders branch
+ * on this to skip offline caching and stylesheet injection — both are no-ops (or
+ * actively wrong) when the plugin is being served by a Vite dev server.
+ */
+export type ResolvedManifest = {
+    id: string;
+    name: string;
+    version: string;
+    entryUrl: string;
+    assetUrls: readonly string[];
+    dev: boolean;
+};
+/**
+ * Synchronous decode + validate + resolve for an in-memory manifest payload. Used
+ * by tests and tooling that have the manifest body already loaded; the runtime
+ * path goes through {@link fetchManifest}.
+ */
+export declare const parse: (manifestUrl: string, payload: unknown) => ResolvedManifest;
+/**
+ * Fetches and parses a manifest from the given URL via Effect's HTTP client and
+ * Schema-driven JSON decoding. All failure modes surface as a single tagged
+ * {@link PluginManifestError}; callers route on `error.context.reason`.
+ */
+export declare const fetchManifest: (manifestUrl: string) => Effect.Effect<ResolvedManifest, PluginManifestError>;
+export {};
+//# sourceMappingURL=plugin-manifest.d.ts.map

package/dist/types/src/core/plugin-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-manifest.d.ts","sourceRoot":"","sources":["../../../../src/core/plugin-manifest.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE3C;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,wBAAqE;CAAG;AAEjH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ;;;;;;EAMnB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAmBF;;;;GAIG;AACH,eAAO,MAAM,KAAK,gBAAiB,MAAM,WAAW,OAAO,KAAG,gBAM7D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,gBAAiB,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,mBAAmB,CAuBxC,CAAC"}

package/dist/types/src/core/plugin-manifest.test.d.ts

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

package/dist/types/src/core/plugin-manifest.test.d.ts.map

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