@dxos/app-framework 0.8.4-main.72ec0f3 → 0.8.4-main.74a063c4e0

package/dist/types/src/core/capability.d.ts

@@ -0,0 +1,156 @@
+import { type Atom } from '@effect-atom/atom-react';
+import * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import type * as CapabilityManager from './capability-manager';
+import type * as Plugin from './plugin';
+declare const Service_base: Context.TagClass<Service, "@dxos/app-framework/CapabilityManager", CapabilityManager.CapabilityManager>;
+/**
+ * Effect Context.Tag for accessing CapabilityManager via the Effect layer system.
+ * This allows capability modules to access the capability manager without having it passed as an argument.
+ */
+export declare class Service extends Service_base {
+}
+/**
+ * Get a single capability from the capability manager.
+ * @param interfaceDef The interface definition of the capability.
+ * @returns The capability implementation.
+ * @throws If no capability is found.
+ */
+export declare const get: <T>(interfaceDef: InterfaceDef<T>) => Effect.Effect<T, Error, Service>;
+/**
+ * Get all capabilities from the capability manager for a given interface.
+ * @param interfaceDef The interface definition of the capability.
+ * @returns An array of capability implementations.
+ */
+export declare const getAll: <T>(interfaceDef: InterfaceDef<T>) => Effect.Effect<T[], never, Service>;
+/**
+ * Wait for a capability to be available.
+ * @param interfaceDef The interface definition of the capability.
+ * @returns The capability implementation once available.
+ */
+export declare const waitFor: <T>(interfaceDef: InterfaceDef<T>) => Effect.Effect<T, Error, Service>;
+/**
+ * Get the Atom reference to capabilities for reactive access.
+ * @param interfaceDef The interface definition of the capability.
+ * @returns An Atom containing the array of capability implementations.
+ */
+export declare const atom: <T>(interfaceDef: InterfaceDef<T>) => Effect.Effect<Atom.Atom<T[]>, never, Service>;
+/**
+ * Get capabilities grouped by the module that contributed them.
+ * @param interfaceDef The interface definition of the capability.
+ * @returns An Atom containing a record from module ID to capability implementations.
+ */
+export declare const atomByModule: <T>(interfaceDef: InterfaceDef<T>) => Effect.Effect<Atom.Atom<Record<string, T[]>>, never, Service>;
+declare const InterfaceDefTypeId: unique symbol;
+/**
+ * Symbol used to tag lazy capability functions with their module ID.
+ */
+export declare const ModuleTag: unique symbol;
+/**
+ * The interface definition of a capability.
+ */
+export type InterfaceDef<T> = {
+    [InterfaceDefTypeId]: T;
+    identifier: string;
+};
+export declare namespace InterfaceDef {
+    type Implementation<I extends InterfaceDef<any>> = I extends InterfaceDef<infer T> ? T : never;
+}
+/**
+ * Helper to define the interface of a capability.
+ */
+export declare const make: <T>(identifier: string) => InterfaceDef<T>;
+/**
+ * A unique string identifier with a Typescript type associated with it.
+ * When a capability is contributed to the application an implementation of the interface is provided.
+ */
+export type Capability<T> = {
+    /**
+     * The interface definition of the capability.
+     */
+    readonly interface: InterfaceDef<T>;
+    /**
+     * The implementation of the capability.
+     */
+    readonly implementation: T;
+    /**
+     * Called when the capability is deactivated.
+     */
+    readonly deactivate?: () => Effect.Effect<void, Error>;
+};
+export type Any = Capability<any>;
+/**
+ * Union type representing all valid return types for a capability module.
+ * Supports single capabilities, arrays, and tuples of different capability types.
+ */
+export type ModuleReturn = void | Any | Any[] | readonly Any[] | [Any, ...Any[]] | readonly [Any, ...Any[]];
+/**
+ * Helper to define the implementation of a capability.
+ */
+export declare const contributes: <I extends InterfaceDef<any>>(interfaceDef: I, implementation: Capability<InterfaceDef.Implementation<I>>["implementation"], deactivate?: Capability<InterfaceDef.Implementation<I>>["deactivate"]) => Capability<I>;
+type LoadCapability<Props, Capabilities extends ModuleReturn = ModuleReturn> = () => Promise<{
+    default: (props: Props) => Effect.Effect<Capabilities, Error, Service | Plugin.Service | never>;
+}>;
+type LoadCapabilities<Props, Capabilities extends ModuleReturn = ModuleReturn> = () => Promise<{
+    default: (props: Props) => Effect.Effect<Capabilities, Error, Service | Plugin.Service | never>;
+}>;
+type NormalizeReturn<R> = R extends readonly (infer A)[] ? A[] : R extends (infer A)[] ? A[] : R extends Any ? [R] : Any[];
+export type LazyCapability<Props = void, Capabilities extends ModuleReturn = ModuleReturn, E extends Error = Error> = (props: Props) => Effect.Effect<NormalizeReturn<Capabilities>, E, Service | Plugin.Service | never>;
+/**
+ * Helper to define a lazily loaded implementation of a capability.
+ * Supports single capabilities, arrays, and tuples of different capability types.
+ * @param name The export name (e.g., 'AppGraphBuilder') - used to auto-compute module IDs.
+ * @param loader The lazy loader function.
+ * @returns A lazy capability function with ModuleTag symbol attached.
+ */
+export declare const lazy: <T = void, R extends ModuleReturn = ModuleReturn>(name: string, c: LoadCapability<T, R> | LoadCapabilities<T, R>) => LazyCapability<T, R>;
+/**
+ * Gets the module tag (export name) from a lazy capability function.
+ * @param capability The lazy capability function.
+ * @returns The module tag if present, undefined otherwise.
+ */
+export declare const getModuleTag: (capability: unknown) => string | undefined;
+/**
+ * Helper to define a capability module with explicit typing.
+ * Wraps the default export function to provide better type inference and make the pattern explicit.
+ *
+ * This helper provides explicit typing for the module activation function,
+ * making it clear that the function should:
+ * - Access CapabilityManager via the Effect layer system (Capability.get, Capability.getAll, etc.)
+ * - Return a capability, array of capabilities, or tuple of different capability types (sync or async)
+ *
+ * Supports returning multiple capabilities of different types as a tuple, which will be normalized
+ * to an array at runtime for compatibility with the plugin system.
+ *
+ * @example
+ * ```ts
+ * // Module without options - single capability
+ * export default Capability.makeModule(
+ *   Effect.fnUntraced(function* () {
+ *     const client = yield* Capability.get(ClientCapabilities.Client);
+ *     return contributes(Capabilities.SettingsStore, store);
+ *   })
+ * );
+ *
+ * // Module with multiple capabilities
+ * export default Capability.makeModule(
+ *   Effect.fnUntraced(function* () {
+ *     return [
+ *       contributes(Capabilities.SettingsStore, store),
+ *       contributes(Capabilities.Translations, translations),
+ *     ];
+ *   })
+ * );
+ *
+ * // Module with required options (context accessed via layer)
+ * export default Capability.makeModule(
+ *   Effect.fnUntraced(function* (props: { observability: boolean }) {
+ *     const invoker = yield* Capability.get(Capabilities.OperationInvoker);
+ *     return contributes(Capabilities.IntentResolver, ...);
+ *   })
+ * );
+ * ```
+ */
+export declare const makeModule: <TProps = void, TReturn extends ModuleReturn = ModuleReturn, E extends Error = Error, R extends Service | Plugin.Service | never = Service>(fn: (props: TProps) => Effect.Effect<TReturn, E, R>) => ((props: TProps) => Effect.Effect<TReturn, E, R>);
+export {};
+//# sourceMappingURL=capability.d.ts.map

package/dist/types/src/core/capability.d.ts.map

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

package/dist/types/src/core/index.d.ts

@@ -1,5 +1,7 @@
-export * from './capabilities';
-export * from './events';
-export * from './manager';
-export * from './plugin';
+export * as ActivationEvent from './activation-event';
+export * as Capability from './capability';
+export * as CapabilityManager from './capability-manager';
+export * as Plugin from './plugin';
+export * as PluginManager from './plugin-manager';
+export * as UrlLoader from './url-loader';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/index.ts"],"names":[],"mappings":"AAIA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,eAAe,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,iBAAiB,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,aAAa,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,SAAS,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,73 @@
+import { Atom, Registry } from '@effect-atom/atom-react';
+import * as Effect from 'effect/Effect';
+import * as PubSub from 'effect/PubSub';
+import * as ActivationEvent from './activation-event';
+import * as CapabilityManager from './capability-manager';
+import * as Plugin from './plugin';
+/**
+ * Identifier denoting a Manager.
+ */
+export declare const ManagerTypeId: unique symbol;
+export type ManagerTypeId = typeof ManagerTypeId;
+export type ManagerOptions = {
+    pluginLoader: (id: string) => Effect.Effect<Plugin.Plugin, Error>;
+    plugins?: Plugin.Plugin[];
+    core?: string[];
+    enabled?: string[];
+    registry?: Registry.Registry;
+};
+export type ActivationMessage = {
+    event: string;
+    state: 'activating' | 'activated' | 'error';
+    /** Module ID when the message pertains to a specific module activation. */
+    module?: string;
+    error?: Error;
+};
+/**
+ * Interface for the Plugin Manager.
+ */
+export interface PluginManager {
+    readonly [ManagerTypeId]: ManagerTypeId;
+    readonly activation: PubSub.PubSub<ActivationMessage>;
+    readonly capabilities: CapabilityManager.CapabilityManager;
+    readonly registry: Registry.Registry;
+    readonly plugins: Atom.Atom<readonly Plugin.Plugin[]>;
+    readonly core: Atom.Atom<readonly string[]>;
+    readonly enabled: Atom.Atom<readonly string[]>;
+    readonly modules: Atom.Atom<readonly Plugin.PluginModule[]>;
+    readonly active: Atom.Atom<readonly string[]>;
+    readonly eventsFired: Atom.Atom<readonly string[]>;
+    readonly pendingReset: Atom.Atom<readonly string[]>;
+    getPlugins(): readonly Plugin.Plugin[];
+    getCore(): readonly string[];
+    getEnabled(): readonly string[];
+    getModules(): readonly Plugin.PluginModule[];
+    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>;
+    activate(event: ActivationEvent.ActivationEvent | string, params?: {
+        before?: string;
+        after?: string;
+    }): Effect.Effect<boolean, Error>;
+    deactivate(id: string): Effect.Effect<boolean, Error>;
+    reset(event: ActivationEvent.ActivationEvent | string): Effect.Effect<boolean, Error>;
+    /**
+     * Shuts down the manager by deactivating all active modules in reverse activation order,
+     * clearing all capabilities, and resetting lifecycle bookkeeping.
+     * Plugins, core, enabled, and modules remain intact so the manager can be reused.
+     */
+    shutdown(): Effect.Effect<boolean, Error>;
+}
+/**
+ * Type guard to check if a value is a PluginManager.
+ */
+export declare const isManager: (value: unknown) => value is PluginManager;
+/**
+ * Creates a new Plugin Manager instance.
+ */
+export declare const make: (options: ManagerOptions) => PluginManager;
+//# sourceMappingURL=plugin-manager.d.ts.map

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

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

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

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

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

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

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

@@ -1,7 +1,50 @@
-import { type MaybePromise } from '@dxos/util';
-import { type AnyCapability, type PluginContext } from './capabilities';
-import { type ActivationEvent, type ActivationEvents } from './events';
-interface PluginModuleInterface {
+import * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import * as Pipeable from 'effect/Pipeable';
+import type * as ActivationEvent from './activation-event';
+import * as Capability from './capability';
+import type * as PluginManager from './plugin-manager';
+declare const Service_base: Context.TagClass<Service, "@dxos/app-framework/PluginManager", PluginManager.PluginManager>;
+/**
+ * Effect Context.Tag for accessing PluginManager via the Effect layer system.
+ * This allows lifecycle operations to access the plugin manager without having it passed as an argument.
+ */
+export declare class Service extends Service_base {
+}
+/**
+ * Activates plugins based on the activation event.
+ * Accesses the PluginManager via the Effect layer system.
+ * @param event The activation event.
+ * @returns Whether the activation was successful.
+ */
+export declare const activate: (event: ActivationEvent.ActivationEvent) => Effect.Effect<boolean, Error, Service>;
+/**
+ * Re-activates the modules that were activated by the event.
+ * Accesses the PluginManager via the Effect layer system.
+ * @param event The activation event.
+ * @returns Whether the reset was successful.
+ */
+export declare const reset: (event: ActivationEvent.ActivationEvent) => Effect.Effect<boolean, Error, Service>;
+/**
+ * Shuts down the plugin manager, deactivating all active modules and clearing lifecycle state.
+ * Accesses the PluginManager via the Effect layer system.
+ */
+export declare const shutdown: () => Effect.Effect<boolean, Error, Service>;
+/**
+ * Identifier denoting a PluginModule.
+ */
+export declare const PluginModuleTypeId: unique symbol;
+export type PluginModuleTypeId = typeof PluginModuleTypeId;
+/**
+ * Type guard to check if a value is a PluginModule.
+ */
+export declare const isPluginModule: (value: unknown) => value is PluginModule;
+/**
+ * A unit of containment of modular functionality that can be provided to an application.
+ * Activation of a module is async allowing for code to split and loaded lazily.
+ */
+export interface PluginModule {
+    readonly [PluginModuleTypeId]: PluginModuleTypeId;
     /**
      * Unique id of the module.
      */
@@ -9,47 +52,36 @@ interface PluginModuleInterface {
     /**
      * Events for which the module will be activated.
      */
-    activatesOn: ActivationEvents;
+    activatesOn: ActivationEvent.Events;
     /**
      * Events which the plugin depends on being activated.
      * Plugin is marked as needing reset a plugin activated by a dependent event is removed.
      * Events are automatically activated before activation of the plugin.
      */
-    activatesBefore?: ActivationEvent[];
+    activatesBefore?: ActivationEvent.ActivationEvent[];
     /**
      * Events which this plugin triggers upon activation.
      */
-    activatesAfter?: ActivationEvent[];
+    activatesAfter?: ActivationEvent.ActivationEvent[];
     /**
      * Called when the module is activated.
-     * @param context The plugin context.
+     * CapabilityManager is accessed via the Effect layer system (Capability.Service).
+     * PluginManager is accessed via Plugin.Service.
+     * @param props Optional props passed to the module.
      * @returns The capabilities of the module.
      */
-    activate: (context: PluginContext) => MaybePromise<AnyCapability | AnyCapability[]> | Promise<() => Promise<AnyCapability | AnyCapability[]>>;
-}
-/**
- * A unit of containment of modular functionality that can be provided to an application.
- * Activation of a module is async allowing for code to split and loaded lazily.
- */
-export declare class PluginModule implements PluginModuleInterface {
-    readonly id: PluginModuleInterface['id'];
-    readonly activatesOn: PluginModuleInterface['activatesOn'];
-    readonly activatesBefore?: PluginModuleInterface['activatesBefore'];
-    readonly activatesAfter?: PluginModuleInterface['activatesAfter'];
-    readonly activate: PluginModuleInterface['activate'];
-    constructor(options: PluginModuleInterface);
+    activate: (props?: any) => Effect.Effect<Capability.ModuleReturn, Error, Capability.Service | Service | never>;
 }
-/**
- * Helper to define a module.
- */
-export declare const defineModule: (options: PluginModuleInterface) => PluginModule;
-export type PluginMeta = {
+export type PluginModuleOptions = Omit<PluginModule, 'id' | typeof PluginModuleTypeId> & {
+    id?: string;
+};
+export type Meta = {
     /**
      * Globally unique ID.
      *
      * Expected to be in the form of a valid URL.
      *
-     * @example dxos.org/plugin/example
+     * @example org.dxos.plugin.example
      */
     id: string;
     /**
@@ -85,21 +117,52 @@ export type PluginMeta = {
      */
     iconHue?: string;
 };
+/**
+ * Identifier denoting a Plugin.
+ */
+export declare const PluginTypeId: unique symbol;
+export type PluginTypeId = typeof PluginTypeId;
+/**
+ * Type guard to check if a value is a Plugin.
+ */
+export declare const isPlugin: (value: unknown) => value is Plugin;
 /**
  * A collection of modules that are be enabled/disabled as a unit.
  * Plugins provide things such as components, state, actions, etc. to the application.
  */
-export declare class Plugin {
-    readonly meta: PluginMeta;
-    readonly modules: PluginModule[];
-    constructor(meta: PluginMeta, modules: PluginModule[]);
+export interface Plugin {
+    readonly [PluginTypeId]: PluginTypeId;
+    readonly meta: Readonly<Meta>;
+    readonly modules: ReadonlyArray<PluginModule>;
+}
+/**
+ * Builder interface for creating plugins incrementally.
+ */
+export interface PluginBuilder<T = void> extends Pipeable.Pipeable {
+    readonly meta: Meta;
+    readonly modules: ReadonlyArray<PluginModuleOptions | ((options: T) => PluginModuleOptions)>;
+    addModule(moduleOptions: PluginModuleOptions | ((options: T) => PluginModuleOptions)): PluginBuilder<T>;
 }
-export type PluginFactory<T = void> = ((args: T) => Plugin) & {
-    meta: PluginMeta;
+/**
+ * Creates a new PluginBuilder to start building a plugin.
+ */
+export declare const define: <T = void>(meta: Meta) => PluginBuilder<T>;
+/**
+ * Adds a module to a plugin builder.
+ * Supports both pipeline and direct call styles.
+ * Modules can be either PluginModuleOptions or functions that receive options.
+ */
+export declare function addModule<T>(moduleOptions: PluginModuleOptions | ((options: T) => PluginModuleOptions)): (builder: PluginBuilder<T>) => PluginBuilder<T>;
+export declare function addModule<T>(builder: PluginBuilder<T>, moduleOptions: PluginModuleOptions | ((options: T) => PluginModuleOptions)): PluginBuilder<T>;
+export type PluginFactory<T = void> = ((options: T) => Plugin) & {
+    meta: Meta;
 };
 /**
- * Helper to define a plugin.
+ * Creates a Plugin from a builder.
+ * Supports both pipeline and direct call styles.
+ * Always returns a factory function (options: T) => Plugin.
+ * When T is void, the function takes no arguments: () => Plugin.
  */
-export declare const definePlugin: <T = void>(meta: PluginMeta, provider: (args: T) => PluginModule[]) => PluginFactory<T>;
+export declare function make<T>(builder: PluginBuilder<T>): PluginFactory<T>;
 export {};
 //# sourceMappingURL=plugin.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/core/plugin.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEvE,UAAU,qBAAqB;IAC7B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,WAAW,EAAE,gBAAgB,CAAC;IAE9B;;;;OAIG;IACH,eAAe,CAAC,EAAE,eAAe,EAAE,CAAC;IAEpC;;OAEG;IACH,cAAc,CAAC,EAAE,eAAe,EAAE,CAAC;IAEnC;;;;OAIG;IACH,QAAQ,EAAE,CACR,OAAO,EAAE,aAAa,KACnB,YAAY,CAAC,aAAa,GAAG,aAAa,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,aAAa,GAAG,aAAa,EAAE,CAAC,CAAC,CAAC;CAC9G;AAED;;;GAGG;AAEH,qBAAa,YAAa,YAAW,qBAAqB;IACxD,QAAQ,CAAC,EAAE,EAAE,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC,aAAa,CAAC,CAAC;IAC3D,QAAQ,CAAC,eAAe,CAAC,EAAE,qBAAqB,CAAC,iBAAiB,CAAC,CAAC;IACpE,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC,gBAAgB,CAAC,CAAC;IAClE,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAC;gBAEzC,OAAO,EAAE,qBAAqB;CAO3C;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,qBAAqB,iBAA8B,CAAC;AAE1F,MAAM,MAAM,UAAU,GAAG;IACvB;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AAEH,qBAAa,MAAM;IAEf,QAAQ,CAAC,IAAI,EAAE,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE;gBADvB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,YAAY,EAAE;CAEnC;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,GAAG,IAAI,EAAE,MAAM,UAAU,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,YAAY,EAAE,KAAG,aAAa,CAAC,CAAC,CAM/G,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/core/plugin.ts"],"names":[],"mappings":"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"}

package/dist/types/src/core/url-loader.d.ts

@@ -0,0 +1,25 @@
+import * as Effect from 'effect/Effect';
+import * as Plugin from './plugin';
+/**
+ * Abstraction over key-value storage (defaults to localStorage).
+ */
+export type Storage = {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+};
+/**
+ * Options for configuring the URL loader.
+ */
+export type Options = {
+    storage?: Storage;
+    key?: string;
+};
+/**
+ * Preloads previously persisted remote plugins from storage.
+ */
+export declare const preload: (options?: Options) => Promise<Plugin.Plugin[]>;
+/**
+ * Creates a plugin loader that resolves built-in plugins by ID or loads remote plugins from URLs.
+ */
+export declare const make: (builtinPlugins: Plugin.Plugin[], options?: Options) => (locator: string) => Effect.Effect<Plugin.Plugin, Error>;
+//# sourceMappingURL=url-loader.d.ts.map

package/dist/types/src/core/url-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-loader.d.ts","sourceRoot":"","sources":["../../../../src/core/url-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAInC;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAChC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAmEF;;GAEG;AACH,eAAO,MAAM,OAAO,GAAU,UAAS,OAAY,KAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAoB5E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,IAAI,GAAI,gBAAgB,MAAM,CAAC,MAAM,EAAE,EAAE,UAAS,OAAY,MAIjE,SAAS,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAsB7D,CAAC"}

package/dist/types/src/core/url-loader.test.d.ts

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

package/dist/types/src/core/url-loader.test.d.ts.map

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

package/dist/types/src/index.d.ts

@@ -1,5 +1,6 @@
 export * from './common';
+export * from './context';
 export * from './core';
-export * from './plugin-intent';
-export * from './plugin-settings';
+export * from './plugin-operation';
+export * from './plugin-runtime';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/types/src/plugin-operation/OperationPlugin.d.ts

@@ -0,0 +1,3 @@
+import { Plugin } from '../core';
+export declare const OperationPlugin: Plugin.PluginFactory<void>;
+//# sourceMappingURL=OperationPlugin.d.ts.map

package/dist/types/src/plugin-operation/OperationPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationPlugin.d.ts","sourceRoot":"","sources":["../../../../src/plugin-operation/OperationPlugin.ts"],"names":[],"mappings":"AAKA,OAAO,EAAc,MAAM,EAAE,MAAM,SAAS,CAAC;AAM7C,eAAO,MAAM,eAAe,4BAY3B,CAAC"}

package/dist/types/src/plugin-operation/history/capability.d.ts

@@ -0,0 +1,7 @@
+import * as Effect from 'effect/Effect';
+import { Capability } from '../../core';
+import * as HistoryTracker from './history-tracker';
+import * as UndoRegistry from './undo-registry';
+declare const _default: (props: void) => Effect.Effect<[Capability.Capability<Capability.InterfaceDef<UndoRegistry.UndoRegistry>>, Capability.Capability<Capability.InterfaceDef<HistoryTracker.HistoryTracker>>], Error, Capability.Service>;
+export default _default;
+//# sourceMappingURL=capability.d.ts.map

package/dist/types/src/plugin-operation/history/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../../../../src/plugin-operation/history/capability.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAKxC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,cAAc,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,YAAY,MAAM,iBAAiB,CAAC;;AAMhD,wBAkBE"}

package/dist/types/src/plugin-operation/history/errors.d.ts

@@ -0,0 +1,32 @@
+import { BaseError } from '@dxos/errors';
+declare const EmptyHistoryError_base: {
+    new (options?: import("@dxos/errors").BaseErrorOptions): {
+        name: "EmptyHistoryError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "EmptyHistoryError";
+        stack?: string;
+        cause?: unknown;
+    };
+    name: "EmptyHistoryError";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, "cause"> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        name: "EmptyHistoryError";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "EmptyHistoryError";
+        stack?: string;
+        cause?: unknown;
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    isError(error: unknown): error is Error;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+export declare class EmptyHistoryError extends EmptyHistoryError_base {
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/src/plugin-operation/history/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../../src/plugin-operation/history/errors.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;;;;;;;;;;;;;qBAG23B,CAAC;;;;;;;;;;;;;;;AADr6B,qBAAa,iBAAkB,SAAQ,sBAAuE;CAAG"}

package/dist/types/src/plugin-operation/history/history-tracker.d.ts

@@ -0,0 +1,18 @@
+import * as Effect from 'effect/Effect';
+import { type OperationInvoker } from '@dxos/operation';
+import type { UndoRegistry } from './undo-registry';
+/**
+ * HistoryTracker interface - tracks operation history and provides undo.
+ */
+export interface HistoryTracker {
+    undo: () => Effect.Effect<void, Error>;
+    undoPromise: () => Promise<{
+        error?: Error;
+    }>;
+    canUndo: () => boolean;
+}
+/**
+ * Creates a HistoryTracker that subscribes to invocation events and provides undo.
+ */
+export declare const make: (invoker: OperationInvoker.OperationInvokerInternal, undoRegistry: UndoRegistry) => HistoryTracker;
+//# sourceMappingURL=history-tracker.d.ts.map

package/dist/types/src/plugin-operation/history/history-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-tracker.d.ts","sourceRoot":"","sources":["../../../../../src/plugin-operation/history/history-tracker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAKxC,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAMxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAQpD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvC,WAAW,EAAE,MAAM,OAAO,CAAC;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;IAC9C,OAAO,EAAE,MAAM,OAAO,CAAC;CACxB;AAMD;;GAEG;AACH,eAAO,MAAM,IAAI,GACf,SAAS,gBAAgB,CAAC,wBAAwB,EAClD,cAAc,YAAY,KACzB,cAqFF,CAAC"}

package/dist/types/src/plugin-operation/history/history-tracker.test.d.ts

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

package/dist/types/src/plugin-operation/history/history-tracker.test.d.ts.map

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

package/dist/types/src/plugin-operation/history/index.d.ts

@@ -0,0 +1,6 @@
+export * from './errors';
+export * from './types';
+export * as UndoMapping from './undo-mapping';
+export * as UndoRegistry from './undo-registry';
+export * as HistoryTracker from './history-tracker';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/plugin-operation/history/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/plugin-operation/history/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,OAAO,KAAK,WAAW,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,YAAY,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,cAAc,MAAM,mBAAmB,CAAC"}