@dxos/app-framework 0.9.0 → 0.9.1-staging.ee54ba693a

package/dist/lib/node-esm/testing/index.mjs

@@ -1,30 +1,30 @@
 import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
 import {
   useApp
-} from "../chunk-FSVGKTF6.mjs";
-import "../chunk-A5CHGAZE.mjs";
+} from "../chunk-ND2HETHD.mjs";
+import "../chunk-DRT75WGD.mjs";
 import "../chunk-37Z53PXZ.mjs";
 import "../chunk-FPW45EZH.mjs";
 import {
   capabilities_exports
-} from "../chunk-NULBHQYS.mjs";
+} from "../chunk-XSZMX53L.mjs";
 import {
   activation_events_exports
-} from "../chunk-KFZEB6BV.mjs";
-import "../chunk-WK7OIQKI.mjs";
-import "../chunk-XGBUKRCK.mjs";
+} from "../chunk-TLKYZKPW.mjs";
+import "../chunk-VCPGX7WN.mjs";
+import "../chunk-FKMVORZN.mjs";
 import {
   plugin_manager_exports
-} from "../chunk-SX5NVETP.mjs";
+} from "../chunk-IL7O7IRX.mjs";
 import {
   activation_event_exports
-} from "../chunk-XOCUANHO.mjs";
+} from "../chunk-BMW6P6QA.mjs";
 import {
   plugin_exports
-} from "../chunk-XIGPWXCQ.mjs";
+} from "../chunk-4SE7SX7N.mjs";
 import {
   capability_exports
-} from "../chunk-CTKEZHKF.mjs";
+} from "../chunk-GLH4LGHZ.mjs";
 import "../chunk-HSLMI22Q.mjs";
 
 // src/testing/harness.ts
@@ -37,9 +37,9 @@ import { invariant } from "@dxos/invariant";
 var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/testing/harness.ts";
 var DEFAULT_TIMEOUT_MS = 5e3;
 var createTestApp = async (opts) => {
-  const { plugins, enabled = plugins.filter(({ meta }) => !meta.tags?.includes("system")).map((plugin) => plugin.meta.id), setupEvents = [], autoStart = true, registerFrameworkCapabilities = true } = opts;
+  const { plugins, enabled = plugins.filter(({ meta }) => !meta.profile.tags?.includes("system")).map((plugin) => plugin.meta.profile.key), setupEvents = [], autoStart = true, registerFrameworkCapabilities = true } = opts;
   const pluginLoader = (id) => Effect.sync(() => {
-    const plugin = plugins.find((plugin2) => plugin2.meta.id === id);
+    const plugin = plugins.find((plugin2) => plugin2.meta.profile.key === id);
     invariant(plugin, `Plugin not found: ${id}`, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 26, S: void 0, A: ["plugin", "`Plugin not found: ${id}`"] });
     return {
       plugin
@@ -234,7 +234,7 @@ import { invariant as invariant2 } from "@dxos/invariant";
 var __dxlog_file2 = "/__w/dxos/dxos/packages/sdk/app-framework/src/testing/service.ts";
 var fromPlugins = (plugins) => Layer.effect(plugin_exports.Service, Effect3.gen(function* () {
   const pluginLoader = (id) => Effect3.sync(() => {
-    const plugin = plugins.find((plugin2) => plugin2.meta.id === id);
+    const plugin = plugins.find((plugin2) => plugin2.meta.profile.key === id);
     invariant2(plugin, `Plugin not found: ${id}`, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 16, S: this, A: ["plugin", "`Plugin not found: ${id}`"] });
     return {
       plugin
@@ -243,7 +243,7 @@ var fromPlugins = (plugins) => Layer.effect(plugin_exports.Service, Effect3.gen(
   const manager = plugin_manager_exports.make({
     pluginLoader,
     plugins,
-    enabled: plugins.map((plugin) => plugin.meta.id)
+    enabled: plugins.map((plugin) => plugin.meta.profile.key)
   });
   manager.capabilities.contribute({
     interface: capabilities_exports.PluginManager,
@@ -268,7 +268,7 @@ import { DXN } from "@dxos/keys";
 import { useAsyncEffect } from "@dxos/react-hooks";
 import { getProviderValue } from "@dxos/util";
 var setupPluginManager = ({ capabilities, plugins = [], ...options } = {}) => {
-  const enabled = plugins.filter(({ meta }) => !meta.tags?.includes("system")).map(({ meta }) => meta.id);
+  const enabled = plugins.filter(({ meta }) => !meta.profile.tags?.includes("system")).map(({ meta }) => meta.profile.key);
   const pluginManager = plugin_manager_exports.make({
     pluginLoader: () => raise(new Error("Not implemented")),
     plugins: [

package/dist/lib/node-esm/testing/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/testing/harness.ts", "../../../../src/testing/operationCapture.ts", "../../../../src/testing/service.ts", "../../../../src/testing/withPluginManager.tsx"],
-  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport { type Registry } from '@effect-atom/atom-react';\nimport * as Duration from 'effect/Duration';\nimport * as Effect from 'effect/Effect';\nimport * as PubSub from 'effect/PubSub';\nimport * as Queue from 'effect/Queue';\n\nimport { type Operation } from '@dxos/compute';\nimport { EffectEx } from '@dxos/effect';\nimport { invariant } from '@dxos/invariant';\n\nimport { ActivationEvents, Capabilities } from '../common';\nimport { ActivationEvent, type Capability, type CapabilityManager, type Plugin, PluginManager } from '../core';\n\nexport type TestAppOptions = {\n  /**\n   * Plugins to register. Plugins whose `meta.tags` includes `'system'` are treated as core\n   * (force-enabled). For test convenience, plugins without a `'system'` tag are enabled by\n   * default unless `enabled` is provided.\n   */\n  plugins: Plugin.Plugin[];\n  /** Plugin ids that are enabled by default in addition to core. Defaults to all non-system plugin ids. */\n  enabled?: string[];\n  /** Additional activation events fired alongside SetupReactSurface. */\n  setupEvents?: ActivationEvent.ActivationEvent[];\n  /**\n   * Whether to automatically fire SetupReactSurface + Startup during setup.\n   * Defaults to true.\n   */\n  autoStart?: boolean;\n  /**\n   * Whether to register the PluginManager + AtomRegistry framework capabilities.\n   * Defaults to true.\n   */\n  registerFrameworkCapabilities?: boolean;\n};\n\n/**\n * A running plugin manager plus helpers for driving it in tests.\n */\nexport interface TestHarness {\n  readonly manager: PluginManager.PluginManager;\n  readonly capabilities: CapabilityManager.CapabilityManager;\n  readonly registry: Registry.Registry;\n\n  /** Activate the given event. Equivalent to `manager.activate(event)`. */\n  fire(event: ActivationEvent.ActivationEvent | string): Promise<boolean>;\n  /** Re-activate all modules that were activated by the given event. */\n  reset(event: ActivationEvent.ActivationEvent | string): Promise<boolean>;\n\n  /** Returns the first contributed capability for the given interface. Throws if none are present. */\n  get<T>(iface: Capability.InterfaceDef<T>): T;\n  /** Returns all contributed capabilities for the given interface. */\n  getAll<T>(iface: Capability.InterfaceDef<T>): T[];\n  /** Waits until at least one capability is contributed for the given interface. */\n  waitForCapability<T>(iface: Capability.InterfaceDef<T>, opts?: { timeout?: number }): Promise<T>;\n  /** Waits until the given activation event has completed. */\n  waitForEvent(event: ActivationEvent.ActivationEvent | string, opts?: { timeout?: number }): Promise<void>;\n\n  /** Invokes an operation through the `Capabilities.OperationInvoker` capability. */\n  invoke<I, O>(op: Operation.Definition<I, O>, ...args: void extends I ? [input?: I] : [input: I]): Promise<O>;\n\n  /**\n   * Waits for `Capabilities.ProcessManagerRuntime` and runs the given effect on it.\n   * Convenience around `waitForCapability(ProcessManagerRuntime).runPromise(effect)`.\n   */\n  runPromise<A, E>(\n    effect: Effect.Effect<A, E, Capabilities.ProcessManagerRuntimeServices>,\n    options?: { readonly timeout?: number; readonly signal?: AbortSignal },\n  ): Promise<A>;\n\n  enable(id: string): Promise<boolean>;\n  disable(id: string): Promise<boolean>;\n\n  /** Shuts down the underlying plugin manager. */\n  dispose(): Promise<void>;\n\n  /** Async-disposable support so tests can use `await using harness = ...`. */\n  [Symbol.asyncDispose](): Promise<void>;\n}\n\nconst DEFAULT_TIMEOUT_MS = 5_000;\n\n/**\n * Creates a TestHarness with the same bootstrap sequence that `useApp` performs,\n * minus the React provider tree.\n *\n * For Node-only tests, this is enough to fire activation events, read\n * capabilities, and invoke operations.\n *\n * For React tests, pass the returned harness to `render` or `renderSurface`\n * from `@dxos/app-framework/testing-react`.\n */\nexport const createTestApp = async (opts: TestAppOptions): Promise<TestHarness> => {\n  const {\n    plugins,\n    enabled = plugins.filter(({ meta }) => !meta.tags?.includes('system')).map((plugin) => plugin.meta.id),\n    setupEvents = [],\n    autoStart = true,\n    registerFrameworkCapabilities = true,\n  } = opts;\n\n  const pluginLoader = (id: string) =>\n    Effect.sync(() => {\n      const plugin = plugins.find((plugin) => plugin.meta.id === id);\n      invariant(plugin, `Plugin not found: ${id}`);\n      return { plugin };\n    });\n\n  const manager = PluginManager.make({ pluginLoader, plugins, enabled });\n\n  if (registerFrameworkCapabilities) {\n    manager.capabilities.contribute({\n      interface: Capabilities.PluginManager,\n      implementation: manager,\n      module: 'org.dxos.app-framework.plugin-manager',\n    });\n    manager.capabilities.contribute({\n      interface: Capabilities.AtomRegistry,\n      implementation: manager.registry,\n      module: 'org.dxos.app-framework.atom-registry',\n    });\n  }\n\n  if (autoStart) {\n    try {\n      await EffectEx.runAndForwardErrors(\n        Effect.all([\n          ...setupEvents.map((event) => manager.activate(event)),\n          manager.activate(ActivationEvents.SetupReactSurface),\n          manager.activate(ActivationEvents.Startup),\n        ]),\n      );\n    } catch (err) {\n      await EffectEx.runAndForwardErrors(manager.shutdown()).catch(() => undefined);\n      throw err;\n    }\n  }\n\n  return new TestHarnessImpl(manager);\n};\n\nclass TestHarnessImpl implements TestHarness {\n  constructor(readonly manager: PluginManager.PluginManager) {}\n\n  get capabilities(): CapabilityManager.CapabilityManager {\n    return this.manager.capabilities;\n  }\n\n  get registry(): Registry.Registry {\n    return this.manager.registry;\n  }\n\n  fire(event: ActivationEvent.ActivationEvent | string): Promise<boolean> {\n    return EffectEx.runAndForwardErrors(this.manager.activate(event));\n  }\n\n  reset(event: ActivationEvent.ActivationEvent | string): Promise<boolean> {\n    return EffectEx.runAndForwardErrors(this.manager.reset(event));\n  }\n\n  get<T>(iface: Capability.InterfaceDef<T>): T {\n    return this.manager.capabilities.get(iface);\n  }\n\n  getAll<T>(iface: Capability.InterfaceDef<T>): T[] {\n    return this.manager.capabilities.getAll(iface);\n  }\n\n  waitForCapability<T>(iface: Capability.InterfaceDef<T>, opts?: { timeout?: number }): Promise<T> {\n    const timeout = opts?.timeout ?? DEFAULT_TIMEOUT_MS;\n    return EffectEx.runAndForwardErrors(\n      this.manager.capabilities.waitFor(iface).pipe(\n        Effect.timeoutFail({\n          duration: Duration.millis(timeout),\n          onTimeout: () => timeoutError(iface.identifier),\n        }),\n      ),\n    );\n  }\n\n  waitForEvent(event: ActivationEvent.ActivationEvent | string, opts?: { timeout?: number }): Promise<void> {\n    const key = typeof event === 'string' ? event : ActivationEvent.eventKey(event);\n    const timeout = opts?.timeout ?? DEFAULT_TIMEOUT_MS;\n\n    const program = Effect.gen(this, function* () {\n      const queue = yield* PubSub.subscribe(this.manager.activation);\n      // Re-check after subscribing to avoid a race where the event fires\n      // between the caller invoking this and the subscription being installed.\n      if (this.manager.getEventsFired().includes(key)) {\n        return;\n      }\n      while (true) {\n        const message = yield* Queue.take(queue);\n        if (message.event === key && message.state === 'activated') {\n          return;\n        }\n      }\n    }).pipe(\n      Effect.scoped,\n      Effect.timeoutFail({\n        duration: Duration.millis(timeout),\n        onTimeout: () => timeoutError(key),\n      }),\n    );\n\n    return EffectEx.runAndForwardErrors(program);\n  }\n\n  async invoke<I, O>(op: Operation.Definition<I, O>, ...args: [input?: I]): Promise<O> {\n    const invoker = await this.waitForCapability(Capabilities.OperationInvoker);\n    const result = await invoker.invokePromise(op as any, ...(args as [any]));\n    if (result.error) {\n      throw result.error;\n    }\n    return result.data as O;\n  }\n\n  async runPromise<A, E>(\n    effect: Effect.Effect<A, E, Capabilities.ProcessManagerRuntimeServices>,\n    options?: { readonly timeout?: number; readonly signal?: AbortSignal },\n  ): Promise<A> {\n    const runtime = await this.waitForCapability(Capabilities.ProcessManagerRuntime, { timeout: options?.timeout });\n    return runtime.runPromise(effect, options?.signal ? { signal: options.signal } : undefined);\n  }\n\n  enable(id: string): Promise<boolean> {\n    return EffectEx.runAndForwardErrors(this.manager.enable(id));\n  }\n\n  disable(id: string): Promise<boolean> {\n    return EffectEx.runAndForwardErrors(this.manager.disable(id));\n  }\n\n  async dispose(): Promise<void> {\n    await EffectEx.runAndForwardErrors(this.manager.shutdown());\n  }\n\n  [Symbol.asyncDispose](): Promise<void> {\n    return this.dispose();\n  }\n}\n\nconst timeoutError = (id: string) => new Error(`Timed out waiting for ${id}`);\n", "//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { type Operation } from '@dxos/compute';\n\nimport { Capabilities } from '../common';\nimport { Capability } from '../core';\n\nexport type CapturedCall<I = unknown> = {\n  /** The DXN key string of the invoked operation. */\n  operationKey: string;\n  /** The input passed to the operation. */\n  input: I;\n};\n\ntype CapabilityManagerLike = {\n  get: (cap: Capability.InterfaceDef<Capabilities.OperationInvoker>) => Capabilities.OperationInvoker;\n  getAll: (cap: Capability.InterfaceDef<Capabilities.OperationInvoker>) => Capabilities.OperationInvoker[];\n};\n\nexport type OperationCapture = {\n  /**\n   * Wraps the real OperationInvoker from the given manager. Pass to\n   * `withPluginManager({ capabilities: (m) => capture.wrap(m) })`.\n   */\n  wrap(manager: CapabilityManagerLike): Capability.Any[];\n  /** Returns all recorded calls (mocked or real) for the given operation. */\n  getCalls<I, O>(op: Operation.Definition<I, O>): CapturedCall<I>[];\n  /** Clears all recorded calls (useful between play function steps). */\n  reset(): void;\n};\n\n/**\n * Creates a capture that wraps the real `Capabilities.OperationInvoker`:\n *\n * - **Mocked operations** (declared in `mockedOperations`) are intercepted: the call is recorded\n *   and returns `{ data: undefined }` without executing. Use this for side-effecting operations\n *   you don't want to run in tests, such as `LayoutOperation.Open` (navigation).\n *\n * - **All other operations** are forwarded to the real invoker and still execute normally. The\n *   call is still recorded so you can assert it was triggered even though it ran for real.\n *\n * Pass a `spyFn` wrapper (e.g. `fn` from `storybook/test`) to get Storybook Actions panel\n * integration and vi-style matchers on the recording.\n *\n * @example\n * ```ts\n * import { fn } from 'storybook/test';\n *\n * const capture = makeOperationCapture(\n *   // These ops are mocked: captured but not executed.\n *   [AssistantOperation.RunPromptInNewChat, LayoutOperation.Open],\n *   fn,\n * );\n *\n * // Wire into withPluginManager:\n * capabilities: (manager) => capture.wrap(manager)\n *\n * // Assert in a play function:\n * const calls = capture.getCalls(AssistantOperation.RunPromptInNewChat);\n * expect(calls).toHaveLength(1);\n * expect(calls[0].input.prompt).toBe('Draft a new document');\n * ```\n *\n * @idiom org.dxos.app-framework.testing.operationCapture\n *   applies: Storybook play-function tests for components that call plugin operations\n *   instead-of: Loading every plugin whose operations the component triggers\n *   uses: {@link makeOperationCapture}, {@link withPluginManager}\n */\nexport const makeOperationCapture = (\n  mockedOperations: readonly Operation.Definition.Any[],\n  spyFn?: (impl: (...args: any[]) => any) => any,\n): OperationCapture => {\n  const calls: CapturedCall[] = [];\n\n  const mockedKeys = new Set(mockedOperations.map((op) => String(op.meta.key)));\n\n  const record = (op: Operation.Definition<any, any>, input?: unknown) => {\n    calls.push({ operationKey: String(op.meta.key), input: input ?? {} });\n  };\n\n  const recordFn = spyFn ? spyFn(record) : record;\n\n  return {\n    wrap(manager) {\n      // Use getAll to find the real invoker that was registered before our wrapper. manager.get\n      // returns the last contribution (ours, once added), but getAll returns them all in order.\n      // On first invocation (when activation is complete) we find the non-wrapper contribution.\n      let real: Capabilities.OperationInvoker | undefined;\n      const delegate = () => {\n        if (!real) {\n          const all = manager.getAll(Capabilities.OperationInvoker);\n          real = all.find((inv) => inv !== wrapped);\n        }\n        return real;\n      };\n\n      const wrapped: Capabilities.OperationInvoker = {\n        get invocations() {\n          return delegate()!.invocations;\n        },\n        get pendingFollowups() {\n          return delegate()!.pendingFollowups;\n        },\n        get awaitFollowups() {\n          return delegate()!.awaitFollowups;\n        },\n        invoke: (op: Operation.Definition<any, any>, input?: unknown, ...rest: any[]) => {\n          recordFn(op, input);\n          if (mockedKeys.has(String(op.meta.key))) {\n            return Effect.succeed(undefined as any);\n          }\n          return (delegate()!.invoke as any)(op, input, ...rest);\n        },\n        invokePromise: async (op: Operation.Definition<any, any>, input?: unknown, ...rest: any[]) => {\n          recordFn(op, input);\n          if (mockedKeys.has(String(op.meta.key))) {\n            return { data: undefined };\n          }\n          return (delegate()!.invokePromise as any)(op, input, ...rest);\n        },\n        schedule: (op: Operation.Definition<any, any>, input?: unknown, ...rest: any[]) => {\n          recordFn(op, input);\n          if (mockedKeys.has(String(op.meta.key))) {\n            return Effect.succeed(undefined);\n          }\n          return (delegate()!.schedule as any)(op, input, ...rest);\n        },\n      };\n\n      return [Capability.contributes(Capabilities.OperationInvoker, wrapped)];\n    },\n    getCalls<I, O>(op: Operation.Definition<I, O>): CapturedCall<I>[] {\n      const key = String(op.meta.key);\n      return calls.filter((c) => c.operationKey === key) as CapturedCall<I>[];\n    },\n    reset() {\n      calls.length = 0;\n    },\n  };\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Layer from 'effect/Layer';\n\nimport { invariant } from '@dxos/invariant';\n\nimport { ActivationEvents, Capabilities } from '../common';\nimport { Plugin, PluginManager } from '../core';\n\n/**\n * Creates a Plugin.Service layer from a list of plugins.\n * This is primarily used for testing.\n */\nexport const fromPlugins = (plugins: Plugin.Plugin[]) =>\n  Layer.effect(\n    Plugin.Service,\n    Effect.gen(function* () {\n      // TODO(wittjosiah): Try to dedupe logic between here, createCliApp and useApp.\n\n      const pluginLoader = (id: string) =>\n        Effect.sync(() => {\n          const plugin = plugins.find((plugin) => plugin.meta.id === id);\n          invariant(plugin, `Plugin not found: ${id}`);\n          return { plugin };\n        });\n\n      const manager = PluginManager.make({\n        pluginLoader,\n        plugins,\n        enabled: plugins.map((plugin) => plugin.meta.id),\n      });\n\n      manager.capabilities.contribute({\n        interface: Capabilities.PluginManager,\n        implementation: manager,\n        module: 'org.dxos.app-framework.plugin-manager',\n      });\n\n      manager.capabilities.contribute({\n        interface: Capabilities.AtomRegistry,\n        implementation: manager.registry,\n        module: 'org.dxos.app-framework.atom-registry',\n      });\n\n      yield* manager.activate(ActivationEvents.Startup);\n\n      return manager;\n    }),\n  );\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Decorator, type StoryContext } from '@storybook/react';\nimport * as Effect from 'effect/Effect';\nimport React, { useEffect, useState } from 'react';\n\nimport { raise } from '@dxos/debug';\nimport { EffectEx } from '@dxos/effect';\nimport { DXN } from '@dxos/keys';\nimport { useAsyncEffect } from '@dxos/react-hooks';\nimport { type MaybeProvider, getProviderValue } from '@dxos/util';\n\nimport { ActivationEvents, Capabilities } from '../common';\nimport { type ActivationEvent, Capability, type CapabilityManager, Plugin, PluginManager } from '../core';\nimport { type UseAppOptions, useApp } from '../ui';\n\n/**\n * @internal\n */\nexport const setupPluginManager = ({\n  capabilities,\n  plugins = [],\n  ...options\n}: UseAppOptions & Pick<WithPluginManagerOptions, 'capabilities'> = {}) => {\n  // Auto-enable every non-system plugin so stories don't have to spell out\n  // enablement. System-tagged plugins are force-enabled by the manager.\n  const enabled = plugins.filter(({ meta }) => !meta.tags?.includes('system')).map(({ meta }) => meta.id);\n  const pluginManager = PluginManager.make({\n    pluginLoader: () => raise(new Error('Not implemented')),\n    plugins: [StoryPlugin, ...plugins],\n    enabled,\n    ...options,\n  });\n\n  if (capabilities) {\n    getProviderValue(capabilities, pluginManager.capabilities).forEach((capability) => {\n      pluginManager.capabilities.contribute({\n        interface: capability.interface,\n        implementation: capability.implementation,\n        module: 'story',\n      });\n    });\n  }\n\n  return pluginManager;\n};\n\ntype ManagedPluginManagerState = {\n  fireEvents?: (ActivationEvent.ActivationEvent | string)[];\n  pluginManager: PluginManager.PluginManager;\n  setupEvents?: ActivationEvent.ActivationEvent[];\n  storyId: string;\n};\n\nexport type WithPluginManagerOptions = UseAppOptions & {\n  /** @deprecated */\n  capabilities?: MaybeProvider<Capability.Any[], CapabilityManager.CapabilityManager>;\n  /** @deprecated */\n  fireEvents?: (ActivationEvent.ActivationEvent | string)[];\n};\n\nexport type WithPluginManagerInitializer<Args = void> =\n  | WithPluginManagerOptions\n  | ((context: StoryContext<Args>) => WithPluginManagerOptions);\n\n/**\n * Wraps a story with a plugin manager.\n * NOTE: This builds up and tears down the plugin manager on every render.\n */\nexport const withPluginManager = <Args,>(init: WithPluginManagerInitializer<Args> = {}): Decorator => {\n  return (Story, context) => {\n    const storyId = context.id;\n    const options = typeof init === 'function' ? init(context as any) : init;\n    const [managerState, setManagerState] = useState<ManagedPluginManagerState>();\n\n    // Storybook replaces the full context object often, so key manager ownership by story id.\n    useEffect(() => {\n      const pluginManager = setupPluginManager(options);\n      const capability = Capability.contributes(Capabilities.ReactRoot, {\n        id: storyId,\n        root: () => <Story />,\n      });\n\n      pluginManager.capabilities.contribute({\n        ...capability,\n        module: 'org.dxos.app-framework.with-plugin-manager',\n      });\n\n      setManagerState({\n        pluginManager,\n        setupEvents: options.setupEvents,\n        fireEvents: options.fireEvents,\n        storyId,\n      });\n\n      return () => {\n        pluginManager.capabilities.remove(capability.interface, capability.implementation);\n        void EffectEx.runAndForwardErrors(pluginManager.shutdown());\n      };\n    }, [storyId, init]);\n\n    // Avoid mounting useApp with a stale manager from the previous story.\n    if (!managerState || managerState.storyId !== storyId) {\n      return <></>;\n    }\n\n    return <WithPluginManagerApp {...managerState} />;\n  };\n};\n\nconst WithPluginManagerApp = ({ fireEvents, pluginManager, setupEvents, storyId }: ManagedPluginManagerState) => {\n  // Fire deprecated events only after the effect-owned manager for this story exists.\n  useAsyncEffect(async () => {\n    await Promise.all(fireEvents?.map((event) => pluginManager.activate(event)) ?? []);\n  }, [fireEvents, pluginManager, storyId]);\n\n  const App = useApp({ pluginManager, setupEvents });\n  return <App />;\n};\n\nconst storyMeta = Plugin.makeMeta({\n  key: DXN.make('org.dxos.appFramework.story'),\n  name: 'Story',\n  tags: ['system'],\n});\n\n// No-op plugin to ensure there exists at least one plugin for the startup event.\n// This is necessary because `createApp` expects the startup event to complete before the app is ready.\nconst StoryPlugin = Plugin.define(storyMeta).pipe(\n  Plugin.addModule({\n    id: 'Story',\n    activatesOn: ActivationEvents.Startup,\n    activate: () => Effect.succeed([]),\n  }),\n  Plugin.make,\n)();\n"],
-  "mappings": "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",
-  "names": ["Duration", "Effect", "PubSub", "Queue", "EffectEx", "invariant", "DEFAULT_TIMEOUT_MS", "pluginLoader", "Effect", "sync", "plugin", "plugins", "meta", "id", "manager", "enabled", "registerFrameworkCapabilities", "PluginManager", "implementation", "module", "capabilities", "registry", "autoStart", "EffectEx", "activate", "SetupReactSurface", "ActivationEvents", "Startup", "err", "TestHarnessImpl", "fire", "reset", "iface", "getAll", "waitForCapability", "runAndForwardErrors", "duration", "Duration", "timeout", "onTimeout", "identifier", "waitForEvent", "opts", "program", "queue", "subscribe", "message", "timeoutError", "key", "invoke", "args", "result", "invoker", "error", "data", "runPromise", "effect", "options", "runtime", "undefined", "enable", "disable", "dispose", "Symbol", "asyncDispose", "Effect", "makeOperationCapture", "mockedOperations", "spyFn", "calls", "mockedKeys", "Set", "map", "op", "String", "meta", "key", "record", "input", "push", "operationKey", "recordFn", "wrap", "manager", "real", "delegate", "all", "getAll", "Capabilities", "OperationInvoker", "find", "inv", "wrapped", "invocations", "pendingFollowups", "awaitFollowups", "invoke", "rest", "has", "succeed", "undefined", "invokePromise", "data", "schedule", "Capability", "contributes", "getCalls", "filter", "c", "reset", "length", "Effect", "Layer", "invariant", "__dxlog_file", "pluginLoader", "id", "plugin", "manager", "plugins", "enabled", "capabilities", "contribute", "implementation", "module", "registry", "Effect", "React", "useEffect", "useState", "raise", "EffectEx", "DXN", "useAsyncEffect", "getProviderValue", "setupPluginManager", "capabilities", "plugins", "options", "enabled", "filter", "meta", "tags", "includes", "map", "id", "pluginManager", "PluginManager", "make", "pluginLoader", "raise", "Error", "StoryPlugin", "getProviderValue", "forEach", "capability", "contribute", "interface", "implementation", "module", "withPluginManager", "init", "Story", "context", "storyId", "managerState", "setManagerState", "useState", "useEffect", "Capability", "contributes", "Capabilities", "ReactRoot", "root", "setupEvents", "fireEvents", "remove", "EffectEx", "runAndForwardErrors", "shutdown", "WithPluginManagerApp", "useAsyncEffect", "Promise", "all", "event", "activate", "App", "useApp", "storyMeta", "Plugin", "makeMeta", "key", "DXN", "name", "define", "pipe", "addModule", "activatesOn", "ActivationEvents", "Startup", "succeed"]
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport { type Registry } from '@effect-atom/atom-react';\nimport * as Duration from 'effect/Duration';\nimport * as Effect from 'effect/Effect';\nimport * as PubSub from 'effect/PubSub';\nimport * as Queue from 'effect/Queue';\n\nimport { type Operation } from '@dxos/compute';\nimport { EffectEx } from '@dxos/effect';\nimport { invariant } from '@dxos/invariant';\n\nimport { ActivationEvents, Capabilities } from '../common';\nimport { ActivationEvent, type Capability, type CapabilityManager, type Plugin, PluginManager } from '../core';\n\nexport type TestAppOptions = {\n  /**\n   * Plugins to register. Plugins whose `meta.profile.tags` includes `'system'` are treated as core\n   * (force-enabled). For test convenience, plugins without a `'system'` tag are enabled by\n   * default unless `enabled` is provided.\n   */\n  plugins: Plugin.Plugin[];\n  /** Plugin ids that are enabled by default in addition to core. Defaults to all non-system plugin ids. */\n  enabled?: string[];\n  /** Additional activation events fired alongside SetupReactSurface. */\n  setupEvents?: ActivationEvent.ActivationEvent[];\n  /**\n   * Whether to automatically fire SetupReactSurface + Startup during setup.\n   * Defaults to true.\n   */\n  autoStart?: boolean;\n  /**\n   * Whether to register the PluginManager + AtomRegistry framework capabilities.\n   * Defaults to true.\n   */\n  registerFrameworkCapabilities?: boolean;\n};\n\n/**\n * A running plugin manager plus helpers for driving it in tests.\n */\nexport interface TestHarness {\n  readonly manager: PluginManager.PluginManager;\n  readonly capabilities: CapabilityManager.CapabilityManager;\n  readonly registry: Registry.Registry;\n\n  /** Activate the given event. Equivalent to `manager.activate(event)`. */\n  fire(event: ActivationEvent.ActivationEvent | string): Promise<boolean>;\n  /** Re-activate all modules that were activated by the given event. */\n  reset(event: ActivationEvent.ActivationEvent | string): Promise<boolean>;\n\n  /** Returns the first contributed capability for the given interface. Throws if none are present. */\n  get<T>(iface: Capability.InterfaceDef<T>): T;\n  /** Returns all contributed capabilities for the given interface. */\n  getAll<T>(iface: Capability.InterfaceDef<T>): T[];\n  /** Waits until at least one capability is contributed for the given interface. */\n  waitForCapability<T>(iface: Capability.InterfaceDef<T>, opts?: { timeout?: number }): Promise<T>;\n  /** Waits until the given activation event has completed. */\n  waitForEvent(event: ActivationEvent.ActivationEvent | string, opts?: { timeout?: number }): Promise<void>;\n\n  /** Invokes an operation through the `Capabilities.OperationInvoker` capability. */\n  invoke<I, O>(op: Operation.Definition<I, O>, ...args: void extends I ? [input?: I] : [input: I]): Promise<O>;\n\n  /**\n   * Waits for `Capabilities.ProcessManagerRuntime` and runs the given effect on it.\n   * Convenience around `waitForCapability(ProcessManagerRuntime).runPromise(effect)`.\n   */\n  runPromise<A, E>(\n    effect: Effect.Effect<A, E, Capabilities.ProcessManagerRuntimeServices>,\n    options?: { readonly timeout?: number; readonly signal?: AbortSignal },\n  ): Promise<A>;\n\n  enable(id: string): Promise<boolean>;\n  disable(id: string): Promise<boolean>;\n\n  /** Shuts down the underlying plugin manager. */\n  dispose(): Promise<void>;\n\n  /** Async-disposable support so tests can use `await using harness = ...`. */\n  [Symbol.asyncDispose](): Promise<void>;\n}\n\nconst DEFAULT_TIMEOUT_MS = 5_000;\n\n/**\n * Creates a TestHarness with the same bootstrap sequence that `useApp` performs,\n * minus the React provider tree.\n *\n * For Node-only tests, this is enough to fire activation events, read\n * capabilities, and invoke operations.\n *\n * For React tests, pass the returned harness to `render` or `renderSurface`\n * from `@dxos/app-framework/testing-react`.\n */\nexport const createTestApp = async (opts: TestAppOptions): Promise<TestHarness> => {\n  const {\n    plugins,\n    enabled = plugins\n      .filter(({ meta }) => !meta.profile.tags?.includes('system'))\n      .map((plugin) => plugin.meta.profile.key),\n    setupEvents = [],\n    autoStart = true,\n    registerFrameworkCapabilities = true,\n  } = opts;\n\n  const pluginLoader = (id: string) =>\n    Effect.sync(() => {\n      const plugin = plugins.find((plugin) => plugin.meta.profile.key === id);\n      invariant(plugin, `Plugin not found: ${id}`);\n      return { plugin };\n    });\n\n  const manager = PluginManager.make({ pluginLoader, plugins, enabled });\n\n  if (registerFrameworkCapabilities) {\n    manager.capabilities.contribute({\n      interface: Capabilities.PluginManager,\n      implementation: manager,\n      module: 'org.dxos.app-framework.plugin-manager',\n    });\n    manager.capabilities.contribute({\n      interface: Capabilities.AtomRegistry,\n      implementation: manager.registry,\n      module: 'org.dxos.app-framework.atom-registry',\n    });\n  }\n\n  if (autoStart) {\n    try {\n      await EffectEx.runAndForwardErrors(\n        Effect.all([\n          ...setupEvents.map((event) => manager.activate(event)),\n          manager.activate(ActivationEvents.SetupReactSurface),\n          manager.activate(ActivationEvents.Startup),\n        ]),\n      );\n    } catch (err) {\n      await EffectEx.runAndForwardErrors(manager.shutdown()).catch(() => undefined);\n      throw err;\n    }\n  }\n\n  return new TestHarnessImpl(manager);\n};\n\nclass TestHarnessImpl implements TestHarness {\n  constructor(readonly manager: PluginManager.PluginManager) {}\n\n  get capabilities(): CapabilityManager.CapabilityManager {\n    return this.manager.capabilities;\n  }\n\n  get registry(): Registry.Registry {\n    return this.manager.registry;\n  }\n\n  fire(event: ActivationEvent.ActivationEvent | string): Promise<boolean> {\n    return EffectEx.runAndForwardErrors(this.manager.activate(event));\n  }\n\n  reset(event: ActivationEvent.ActivationEvent | string): Promise<boolean> {\n    return EffectEx.runAndForwardErrors(this.manager.reset(event));\n  }\n\n  get<T>(iface: Capability.InterfaceDef<T>): T {\n    return this.manager.capabilities.get(iface);\n  }\n\n  getAll<T>(iface: Capability.InterfaceDef<T>): T[] {\n    return this.manager.capabilities.getAll(iface);\n  }\n\n  waitForCapability<T>(iface: Capability.InterfaceDef<T>, opts?: { timeout?: number }): Promise<T> {\n    const timeout = opts?.timeout ?? DEFAULT_TIMEOUT_MS;\n    return EffectEx.runAndForwardErrors(\n      this.manager.capabilities.waitFor(iface).pipe(\n        Effect.timeoutFail({\n          duration: Duration.millis(timeout),\n          onTimeout: () => timeoutError(iface.identifier),\n        }),\n      ),\n    );\n  }\n\n  waitForEvent(event: ActivationEvent.ActivationEvent | string, opts?: { timeout?: number }): Promise<void> {\n    const key = typeof event === 'string' ? event : ActivationEvent.eventKey(event);\n    const timeout = opts?.timeout ?? DEFAULT_TIMEOUT_MS;\n\n    const program = Effect.gen(this, function* () {\n      const queue = yield* PubSub.subscribe(this.manager.activation);\n      // Re-check after subscribing to avoid a race where the event fires\n      // between the caller invoking this and the subscription being installed.\n      if (this.manager.getEventsFired().includes(key)) {\n        return;\n      }\n      while (true) {\n        const message = yield* Queue.take(queue);\n        if (message.event === key && message.state === 'activated') {\n          return;\n        }\n      }\n    }).pipe(\n      Effect.scoped,\n      Effect.timeoutFail({\n        duration: Duration.millis(timeout),\n        onTimeout: () => timeoutError(key),\n      }),\n    );\n\n    return EffectEx.runAndForwardErrors(program);\n  }\n\n  async invoke<I, O>(op: Operation.Definition<I, O>, ...args: [input?: I]): Promise<O> {\n    const invoker = await this.waitForCapability(Capabilities.OperationInvoker);\n    const result = await invoker.invokePromise(op as any, ...(args as [any]));\n    if (result.error) {\n      throw result.error;\n    }\n    return result.data as O;\n  }\n\n  async runPromise<A, E>(\n    effect: Effect.Effect<A, E, Capabilities.ProcessManagerRuntimeServices>,\n    options?: { readonly timeout?: number; readonly signal?: AbortSignal },\n  ): Promise<A> {\n    const runtime = await this.waitForCapability(Capabilities.ProcessManagerRuntime, { timeout: options?.timeout });\n    return runtime.runPromise(effect, options?.signal ? { signal: options.signal } : undefined);\n  }\n\n  enable(id: string): Promise<boolean> {\n    return EffectEx.runAndForwardErrors(this.manager.enable(id));\n  }\n\n  disable(id: string): Promise<boolean> {\n    return EffectEx.runAndForwardErrors(this.manager.disable(id));\n  }\n\n  async dispose(): Promise<void> {\n    await EffectEx.runAndForwardErrors(this.manager.shutdown());\n  }\n\n  [Symbol.asyncDispose](): Promise<void> {\n    return this.dispose();\n  }\n}\n\nconst timeoutError = (id: string) => new Error(`Timed out waiting for ${id}`);\n", "//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { type Operation } from '@dxos/compute';\n\nimport { Capabilities } from '../common';\nimport { Capability } from '../core';\n\nexport type CapturedCall<I = unknown> = {\n  /** The DXN key string of the invoked operation. */\n  operationKey: string;\n  /** The input passed to the operation. */\n  input: I;\n};\n\ntype CapabilityManagerLike = {\n  get: (cap: Capability.InterfaceDef<Capabilities.OperationInvoker>) => Capabilities.OperationInvoker;\n  getAll: (cap: Capability.InterfaceDef<Capabilities.OperationInvoker>) => Capabilities.OperationInvoker[];\n};\n\nexport type OperationCapture = {\n  /**\n   * Wraps the real OperationInvoker from the given manager. Pass to\n   * `withPluginManager({ capabilities: (m) => capture.wrap(m) })`.\n   */\n  wrap(manager: CapabilityManagerLike): Capability.Any[];\n  /** Returns all recorded calls (mocked or real) for the given operation. */\n  getCalls<I, O>(op: Operation.Definition<I, O>): CapturedCall<I>[];\n  /** Clears all recorded calls (useful between play function steps). */\n  reset(): void;\n};\n\n/**\n * Creates a capture that wraps the real `Capabilities.OperationInvoker`:\n *\n * - **Mocked operations** (declared in `mockedOperations`) are intercepted: the call is recorded\n *   and returns `{ data: undefined }` without executing. Use this for side-effecting operations\n *   you don't want to run in tests, such as `LayoutOperation.Open` (navigation).\n *\n * - **All other operations** are forwarded to the real invoker and still execute normally. The\n *   call is still recorded so you can assert it was triggered even though it ran for real.\n *\n * Pass a `spyFn` wrapper (e.g. `fn` from `storybook/test`) to get Storybook Actions panel\n * integration and vi-style matchers on the recording.\n *\n * @example\n * ```ts\n * import { fn } from 'storybook/test';\n *\n * const capture = makeOperationCapture(\n *   // These ops are mocked: captured but not executed.\n *   [AssistantOperation.RunPromptInNewChat, LayoutOperation.Open],\n *   fn,\n * );\n *\n * // Wire into withPluginManager:\n * capabilities: (manager) => capture.wrap(manager)\n *\n * // Assert in a play function:\n * const calls = capture.getCalls(AssistantOperation.RunPromptInNewChat);\n * expect(calls).toHaveLength(1);\n * expect(calls[0].input.prompt).toBe('Draft a new document');\n * ```\n *\n * @idiom org.dxos.app-framework.testing.operationCapture\n *   applies: Storybook play-function tests for components that call plugin operations\n *   instead-of: Loading every plugin whose operations the component triggers\n *   uses: {@link makeOperationCapture}, {@link withPluginManager}\n */\nexport const makeOperationCapture = (\n  mockedOperations: readonly Operation.Definition.Any[],\n  spyFn?: (impl: (...args: any[]) => any) => any,\n): OperationCapture => {\n  const calls: CapturedCall[] = [];\n\n  const mockedKeys = new Set(mockedOperations.map((op) => String(op.meta.key)));\n\n  const record = (op: Operation.Definition<any, any>, input?: unknown) => {\n    calls.push({ operationKey: String(op.meta.key), input: input ?? {} });\n  };\n\n  const recordFn = spyFn ? spyFn(record) : record;\n\n  return {\n    wrap(manager) {\n      // Use getAll to find the real invoker that was registered before our wrapper. manager.get\n      // returns the last contribution (ours, once added), but getAll returns them all in order.\n      // On first invocation (when activation is complete) we find the non-wrapper contribution.\n      let real: Capabilities.OperationInvoker | undefined;\n      const delegate = () => {\n        if (!real) {\n          const all = manager.getAll(Capabilities.OperationInvoker);\n          real = all.find((inv) => inv !== wrapped);\n        }\n        return real;\n      };\n\n      const wrapped: Capabilities.OperationInvoker = {\n        get invocations() {\n          return delegate()!.invocations;\n        },\n        get pendingFollowups() {\n          return delegate()!.pendingFollowups;\n        },\n        get awaitFollowups() {\n          return delegate()!.awaitFollowups;\n        },\n        invoke: (op: Operation.Definition<any, any>, input?: unknown, ...rest: any[]) => {\n          recordFn(op, input);\n          if (mockedKeys.has(String(op.meta.key))) {\n            return Effect.succeed(undefined as any);\n          }\n          return (delegate()!.invoke as any)(op, input, ...rest);\n        },\n        invokePromise: async (op: Operation.Definition<any, any>, input?: unknown, ...rest: any[]) => {\n          recordFn(op, input);\n          if (mockedKeys.has(String(op.meta.key))) {\n            return { data: undefined };\n          }\n          return (delegate()!.invokePromise as any)(op, input, ...rest);\n        },\n        schedule: (op: Operation.Definition<any, any>, input?: unknown, ...rest: any[]) => {\n          recordFn(op, input);\n          if (mockedKeys.has(String(op.meta.key))) {\n            return Effect.succeed(undefined);\n          }\n          return (delegate()!.schedule as any)(op, input, ...rest);\n        },\n      };\n\n      return [Capability.contributes(Capabilities.OperationInvoker, wrapped)];\n    },\n    getCalls<I, O>(op: Operation.Definition<I, O>): CapturedCall<I>[] {\n      const key = String(op.meta.key);\n      return calls.filter((c) => c.operationKey === key) as CapturedCall<I>[];\n    },\n    reset() {\n      calls.length = 0;\n    },\n  };\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Layer from 'effect/Layer';\n\nimport { invariant } from '@dxos/invariant';\n\nimport { ActivationEvents, Capabilities } from '../common';\nimport { Plugin, PluginManager } from '../core';\n\n/**\n * Creates a Plugin.Service layer from a list of plugins.\n * This is primarily used for testing.\n */\nexport const fromPlugins = (plugins: Plugin.Plugin[]) =>\n  Layer.effect(\n    Plugin.Service,\n    Effect.gen(function* () {\n      // TODO(wittjosiah): Try to dedupe logic between here, createCliApp and useApp.\n\n      const pluginLoader = (id: string) =>\n        Effect.sync(() => {\n          const plugin = plugins.find((plugin) => plugin.meta.profile.key === id);\n          invariant(plugin, `Plugin not found: ${id}`);\n          return { plugin };\n        });\n\n      const manager = PluginManager.make({\n        pluginLoader,\n        plugins,\n        enabled: plugins.map((plugin) => plugin.meta.profile.key),\n      });\n\n      manager.capabilities.contribute({\n        interface: Capabilities.PluginManager,\n        implementation: manager,\n        module: 'org.dxos.app-framework.plugin-manager',\n      });\n\n      manager.capabilities.contribute({\n        interface: Capabilities.AtomRegistry,\n        implementation: manager.registry,\n        module: 'org.dxos.app-framework.atom-registry',\n      });\n\n      yield* manager.activate(ActivationEvents.Startup);\n\n      return manager;\n    }),\n  );\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Decorator, type StoryContext } from '@storybook/react';\nimport * as Effect from 'effect/Effect';\nimport React, { useEffect, useState } from 'react';\n\nimport { raise } from '@dxos/debug';\nimport { EffectEx } from '@dxos/effect';\nimport { DXN } from '@dxos/keys';\nimport { useAsyncEffect } from '@dxos/react-hooks';\nimport { type MaybeProvider, getProviderValue } from '@dxos/util';\n\nimport { ActivationEvents, Capabilities } from '../common';\nimport { type ActivationEvent, Capability, type CapabilityManager, Plugin, PluginManager } from '../core';\nimport { type UseAppOptions, useApp } from '../ui';\n\n/**\n * @internal\n */\nexport const setupPluginManager = ({\n  capabilities,\n  plugins = [],\n  ...options\n}: UseAppOptions & Pick<WithPluginManagerOptions, 'capabilities'> = {}) => {\n  // Auto-enable every non-system plugin so stories don't have to spell out\n  // enablement. System-tagged plugins are force-enabled by the manager.\n  const enabled = plugins\n    .filter(({ meta }) => !meta.profile.tags?.includes('system'))\n    .map(({ meta }) => meta.profile.key);\n  const pluginManager = PluginManager.make({\n    pluginLoader: () => raise(new Error('Not implemented')),\n    plugins: [StoryPlugin, ...plugins],\n    enabled,\n    ...options,\n  });\n\n  if (capabilities) {\n    getProviderValue(capabilities, pluginManager.capabilities).forEach((capability) => {\n      pluginManager.capabilities.contribute({\n        interface: capability.interface,\n        implementation: capability.implementation,\n        module: 'story',\n      });\n    });\n  }\n\n  return pluginManager;\n};\n\ntype ManagedPluginManagerState = {\n  fireEvents?: (ActivationEvent.ActivationEvent | string)[];\n  pluginManager: PluginManager.PluginManager;\n  setupEvents?: ActivationEvent.ActivationEvent[];\n  storyId: string;\n};\n\nexport type WithPluginManagerOptions = UseAppOptions & {\n  /** @deprecated */\n  capabilities?: MaybeProvider<Capability.Any[], CapabilityManager.CapabilityManager>;\n  /** @deprecated */\n  fireEvents?: (ActivationEvent.ActivationEvent | string)[];\n};\n\nexport type WithPluginManagerInitializer<Args = void> =\n  | WithPluginManagerOptions\n  | ((context: StoryContext<Args>) => WithPluginManagerOptions);\n\n/**\n * Wraps a story with a plugin manager.\n * NOTE: This builds up and tears down the plugin manager on every render.\n */\nexport const withPluginManager = <Args,>(init: WithPluginManagerInitializer<Args> = {}): Decorator => {\n  return (Story, context) => {\n    const storyId = context.id;\n    const options = typeof init === 'function' ? init(context as any) : init;\n    const [managerState, setManagerState] = useState<ManagedPluginManagerState>();\n\n    // Storybook replaces the full context object often, so key manager ownership by story id.\n    useEffect(() => {\n      const pluginManager = setupPluginManager(options);\n      const capability = Capability.contributes(Capabilities.ReactRoot, {\n        id: storyId,\n        root: () => <Story />,\n      });\n\n      pluginManager.capabilities.contribute({\n        ...capability,\n        module: 'org.dxos.app-framework.with-plugin-manager',\n      });\n\n      setManagerState({\n        pluginManager,\n        setupEvents: options.setupEvents,\n        fireEvents: options.fireEvents,\n        storyId,\n      });\n\n      return () => {\n        pluginManager.capabilities.remove(capability.interface, capability.implementation);\n        void EffectEx.runAndForwardErrors(pluginManager.shutdown());\n      };\n    }, [storyId, init]);\n\n    // Avoid mounting useApp with a stale manager from the previous story.\n    if (!managerState || managerState.storyId !== storyId) {\n      return <></>;\n    }\n\n    return <WithPluginManagerApp {...managerState} />;\n  };\n};\n\nconst WithPluginManagerApp = ({ fireEvents, pluginManager, setupEvents, storyId }: ManagedPluginManagerState) => {\n  // Fire deprecated events only after the effect-owned manager for this story exists.\n  useAsyncEffect(async () => {\n    await Promise.all(fireEvents?.map((event) => pluginManager.activate(event)) ?? []);\n  }, [fireEvents, pluginManager, storyId]);\n\n  const App = useApp({ pluginManager, setupEvents });\n  return <App />;\n};\n\nconst storyMeta = Plugin.makeMeta({\n  key: DXN.make('org.dxos.appFramework.story'),\n  name: 'Story',\n  tags: ['system'],\n});\n\n// No-op plugin to ensure there exists at least one plugin for the startup event.\n// This is necessary because `createApp` expects the startup event to complete before the app is ready.\nconst StoryPlugin = Plugin.define(storyMeta).pipe(\n  Plugin.addModule({\n    id: 'Story',\n    activatesOn: ActivationEvents.Startup,\n    activate: () => Effect.succeed([]),\n  }),\n  Plugin.make,\n)();\n"],
+  "mappings": "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",
+  "names": ["Duration", "Effect", "PubSub", "Queue", "EffectEx", "invariant", "DEFAULT_TIMEOUT_MS", "pluginLoader", "Effect", "sync", "plugin", "plugins", "meta", "profile", "key", "id", "manager", "enabled", "registerFrameworkCapabilities", "PluginManager", "implementation", "module", "capabilities", "registry", "autoStart", "EffectEx", "activate", "SetupReactSurface", "ActivationEvents", "Startup", "err", "TestHarnessImpl", "fire", "reset", "iface", "getAll", "waitForCapability", "runAndForwardErrors", "duration", "Duration", "timeout", "onTimeout", "identifier", "waitForEvent", "opts", "program", "queue", "subscribe", "message", "timeoutError", "invoke", "args", "result", "invoker", "error", "data", "runPromise", "effect", "options", "runtime", "undefined", "enable", "disable", "dispose", "Symbol", "asyncDispose", "Effect", "makeOperationCapture", "mockedOperations", "spyFn", "calls", "mockedKeys", "Set", "map", "op", "String", "meta", "key", "record", "input", "push", "operationKey", "recordFn", "wrap", "manager", "real", "delegate", "all", "getAll", "Capabilities", "OperationInvoker", "find", "inv", "wrapped", "invocations", "pendingFollowups", "awaitFollowups", "invoke", "rest", "has", "succeed", "undefined", "invokePromise", "data", "schedule", "Capability", "contributes", "getCalls", "filter", "c", "reset", "length", "Effect", "Layer", "invariant", "__dxlog_file", "pluginLoader", "id", "plugin", "manager", "plugins", "enabled", "capabilities", "contribute", "implementation", "module", "registry", "Effect", "React", "useEffect", "useState", "raise", "EffectEx", "DXN", "useAsyncEffect", "getProviderValue", "setupPluginManager", "capabilities", "plugins", "options", "enabled", "filter", "meta", "profile", "tags", "includes", "map", "key", "pluginManager", "PluginManager", "make", "pluginLoader", "raise", "Error", "StoryPlugin", "getProviderValue", "forEach", "capability", "contribute", "interface", "implementation", "module", "withPluginManager", "init", "Story", "context", "storyId", "id", "managerState", "setManagerState", "useState", "useEffect", "Capability", "contributes", "Capabilities", "ReactRoot", "root", "setupEvents", "fireEvents", "remove", "EffectEx", "runAndForwardErrors", "shutdown", "WithPluginManagerApp", "useAsyncEffect", "Promise", "all", "event", "activate", "App", "useApp", "storyMeta", "Plugin", "makeMeta", "DXN", "name", "define", "pipe", "addModule", "activatesOn", "ActivationEvents", "Startup", "succeed"]
 }

package/dist/lib/node-esm/testing/react.mjs

@@ -3,21 +3,21 @@ import {
   PluginManagerProvider,
   SurfaceComponent,
   topologicalSort
-} from "../chunk-A5CHGAZE.mjs";
+} from "../chunk-DRT75WGD.mjs";
 import {
   PluginManagerContext
 } from "../chunk-37Z53PXZ.mjs";
 import "../chunk-FPW45EZH.mjs";
 import {
   capabilities_exports
-} from "../chunk-NULBHQYS.mjs";
-import "../chunk-KFZEB6BV.mjs";
-import "../chunk-WK7OIQKI.mjs";
-import "../chunk-XGBUKRCK.mjs";
-import "../chunk-SX5NVETP.mjs";
-import "../chunk-XOCUANHO.mjs";
-import "../chunk-XIGPWXCQ.mjs";
-import "../chunk-CTKEZHKF.mjs";
+} from "../chunk-XSZMX53L.mjs";
+import "../chunk-TLKYZKPW.mjs";
+import "../chunk-VCPGX7WN.mjs";
+import "../chunk-FKMVORZN.mjs";
+import "../chunk-IL7O7IRX.mjs";
+import "../chunk-BMW6P6QA.mjs";
+import "../chunk-4SE7SX7N.mjs";
+import "../chunk-GLH4LGHZ.mjs";
 import "../chunk-HSLMI22Q.mjs";
 
 // src/testing/react.tsx
@@ -37,9 +37,9 @@ var render = (harness, ui, options) => {
   });
 };
 var renderSurface = (harness, props, options) => {
-  const { role, data, limit, fallback, placeholder } = props;
+  const { type, data, limit, fallback, placeholder } = props;
   return render(harness, /* @__PURE__ */ React.createElement(SurfaceComponent, {
-    role,
+    type,
     data,
     limit,
     fallback,

package/dist/lib/node-esm/testing/react.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/testing/react.tsx"],
-  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport { RegistryContext } from '@effect-atom/atom-react';\nimport { render as rtlRender, type RenderOptions, type RenderResult } from '@testing-library/react';\nimport React, { type FC, Fragment, type PropsWithChildren, type ReactNode } from 'react';\n\nimport { ContextProtocolProvider } from '@dxos/web-context-react';\n\nimport { Capabilities } from '../common';\nimport { PluginManagerContext } from '../context';\nimport { topologicalSort } from '../helpers';\nimport { PluginManagerProvider } from '../ui/components/PluginManager/PluginManagerProvider';\nimport { SurfaceComponent } from '../ui/components/Surface/SurfaceComponent';\nimport { type TestHarness } from './harness';\n\nexport type HarnessRenderOptions = Omit<RenderOptions, 'wrapper'> & {\n  /** Additional providers to wrap around the harness tree (applied innermost first). */\n  reactContexts?: FC<PropsWithChildren>[];\n};\n\n/**\n * Renders `ui` wrapped in the same provider tree as `useApp` plus every contributed\n * `Capabilities.ReactContext`.\n */\nexport const render = (harness: TestHarness, ui: ReactNode, options?: HarnessRenderOptions): RenderResult => {\n  const { reactContexts = [], ...rest } = options ?? {};\n  const Wrapper = ({ children }: PropsWithChildren) => (\n    <HarnessProviders harness={harness} extra={reactContexts}>\n      {children}\n    </HarnessProviders>\n  );\n  return rtlRender(<>{ui}</>, { ...rest, wrapper: Wrapper });\n};\n\nexport type RenderSurfaceProps = {\n  role: string;\n  data?: unknown;\n  limit?: number;\n  fallback?: FC<{ error: Error; data?: any }>;\n  placeholder?: ReactNode;\n};\n\n/**\n * Renders a `Surface` with the given role/data inside the harness provider tree.\n */\nexport const renderSurface = (\n  harness: TestHarness,\n  props: RenderSurfaceProps,\n  options?: HarnessRenderOptions,\n): RenderResult => {\n  const { role, data, limit, fallback, placeholder } = props;\n  return render(\n    harness,\n    <SurfaceComponent role={role} data={data as any} limit={limit} fallback={fallback} placeholder={placeholder} />,\n    options,\n  );\n};\n\ntype HarnessProvidersProps = PropsWithChildren<{\n  harness: TestHarness;\n  extra: FC<PropsWithChildren>[];\n}>;\n\nconst HarnessProviders = ({ harness, extra, children }: HarnessProvidersProps) => {\n  const contributed = harness.getAll(Capabilities.ReactContext);\n  const ContributedContext = composeContexts(contributed);\n  const ExtraContext = composeExtra(extra);\n  return (\n    <PluginManagerProvider value={harness.manager}>\n      <ContextProtocolProvider value={harness.manager} context={PluginManagerContext}>\n        <RegistryContext.Provider value={harness.registry}>\n          <ContributedContext>\n            <ExtraContext>{children}</ExtraContext>\n          </ContributedContext>\n        </RegistryContext.Provider>\n      </ContextProtocolProvider>\n    </PluginManagerProvider>\n  );\n};\n\nconst composeContexts = (contexts: Capabilities.ReactContext[]): FC<PropsWithChildren> => {\n  if (contexts.length === 0) {\n    return Passthrough;\n  }\n  return topologicalSort(contexts)\n    .map(({ context }) => context)\n    .reduce((Acc, Next) => ({ children }: PropsWithChildren) => (\n      <Acc>\n        <Next>{children}</Next>\n      </Acc>\n    ));\n};\n\n// Composes in innermost-first order: the first context in the array wraps\n// `children` directly; subsequent contexts wrap the accumulator.\nconst composeExtra = (contexts: FC<PropsWithChildren>[]): FC<PropsWithChildren> => {\n  if (contexts.length === 0) {\n    return Passthrough;\n  }\n  return contexts.reduce<FC<PropsWithChildren>>(\n    (Acc, Next) =>\n      ({ children }: PropsWithChildren) => (\n        <Next>\n          <Acc>{children}</Acc>\n        </Next>\n      ),\n    Passthrough,\n  );\n};\n\nconst Passthrough: FC<PropsWithChildren> = ({ children }) => <Fragment>{children}</Fragment>;\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;AAIA,SAASA,uBAAuB;AAChC,SAASC,UAAUC,iBAAwD;AAC3E,OAAOC,SAAkBC,gBAAwD;AAEjF,SAASC,+BAA+B;AAkBjC,IAAMC,SAAS,CAACC,SAAsBC,IAAeC,YAAAA;AAC1D,QAAM,EAAEC,gBAAgB,CAAA,GAAI,GAAGC,KAAAA,IAASF,WAAW,CAAC;AACpD,QAAMG,UAAU,CAAC,EAAEC,SAAQ,MACzB,sBAAA,cAACC,kBAAAA;IAAiBP;IAAkBQ,OAAOL;KACxCG,QAAAA;AAGL,SAAOG,UAAU,sBAAA,cAAA,MAAA,UAAA,MAAGR,EAAAA,GAAQ;IAAE,GAAGG;IAAMM,SAASL;EAAQ,CAAA;AAC1D;AAaO,IAAMM,gBAAgB,CAC3BX,SACAY,OACAV,YAAAA;AAEA,QAAM,EAAEW,MAAMC,MAAMC,OAAOC,UAAUC,YAAW,IAAKL;AACrD,SAAOb,OACLC,SACA,sBAAA,cAACkB,kBAAAA;IAAiBL;IAAYC;IAAmBC;IAAcC;IAAoBC;MACnFf,OAAAA;AAEJ;AAOA,IAAMK,mBAAmB,CAAC,EAAEP,SAASQ,OAAOF,SAAQ,MAAyB;AAC3E,QAAMa,cAAcnB,QAAQoB,OAAOC,qBAAaC,YAAY;AAC5D,QAAMC,qBAAqBC,gBAAgBL,WAAAA;AAC3C,QAAMM,eAAeC,aAAalB,KAAAA;AAClC,SACE,sBAAA,cAACmB,uBAAAA;IAAsBC,OAAO5B,QAAQ6B;KACpC,sBAAA,cAACC,yBAAAA;IAAwBF,OAAO5B,QAAQ6B;IAASE,SAASC;KACxD,sBAAA,cAACC,gBAAgBC,UAAQ;IAACN,OAAO5B,QAAQmC;KACvC,sBAAA,cAACZ,oBAAAA,MACC,sBAAA,cAACE,cAAAA,MAAcnB,QAAAA,CAAAA,CAAAA,CAAAA,CAAAA;AAM3B;AAEA,IAAMkB,kBAAkB,CAACY,aAAAA;AACvB,MAAIA,SAASC,WAAW,GAAG;AACzB,WAAOC;EACT;AACA,SAAOC,gBAAgBH,QAAAA,EACpBI,IAAI,CAAC,EAAET,QAAO,MAAOA,OAAAA,EACrBU,OAAO,CAACC,KAAKC,SAAS,CAAC,EAAErC,SAAQ,MAChC,sBAAA,cAACoC,KAAAA,MACC,sBAAA,cAACC,MAAAA,MAAMrC,QAAAA,CAAAA,CAAAA;AAGf;AAIA,IAAMoB,eAAe,CAACU,aAAAA;AACpB,MAAIA,SAASC,WAAW,GAAG;AACzB,WAAOC;EACT;AACA,SAAOF,SAASK,OACd,CAACC,KAAKC,SACJ,CAAC,EAAErC,SAAQ,MACT,sBAAA,cAACqC,MAAAA,MACC,sBAAA,cAACD,KAAAA,MAAKpC,QAAAA,CAAAA,GAGZgC,WAAAA;AAEJ;AAEA,IAAMA,cAAqC,CAAC,EAAEhC,SAAQ,MAAO,sBAAA,cAACsC,UAAAA,MAAUtC,QAAAA;",
-  "names": ["RegistryContext", "render", "rtlRender", "React", "Fragment", "ContextProtocolProvider", "render", "harness", "ui", "options", "reactContexts", "rest", "Wrapper", "children", "HarnessProviders", "extra", "rtlRender", "wrapper", "renderSurface", "props", "role", "data", "limit", "fallback", "placeholder", "SurfaceComponent", "contributed", "getAll", "Capabilities", "ReactContext", "ContributedContext", "composeContexts", "ExtraContext", "composeExtra", "PluginManagerProvider", "value", "manager", "ContextProtocolProvider", "context", "PluginManagerContext", "RegistryContext", "Provider", "registry", "contexts", "length", "Passthrough", "topologicalSort", "map", "reduce", "Acc", "Next", "Fragment"]
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport { RegistryContext } from '@effect-atom/atom-react';\nimport { type RenderOptions, type RenderResult, render as rtlRender } from '@testing-library/react';\nimport React, { type FC, Fragment, type PropsWithChildren, type ReactNode } from 'react';\n\nimport { ContextProtocolProvider } from '@dxos/web-context-react';\n\nimport { Capabilities } from '../common';\nimport { PluginManagerContext } from '../context';\nimport { topologicalSort } from '../helpers';\nimport { PluginManagerProvider } from '../ui/components/PluginManager/PluginManagerProvider';\nimport { SurfaceComponent } from '../ui/components/Surface/SurfaceComponent';\nimport { type RoleToken } from '../ui/components/Surface/types';\nimport { type TestHarness } from './harness';\n\nexport type HarnessRenderOptions = Omit<RenderOptions, 'wrapper'> & {\n  /** Additional providers to wrap around the harness tree (applied innermost first). */\n  reactContexts?: FC<PropsWithChildren>[];\n};\n\n/**\n * Renders `ui` wrapped in the same provider tree as `useApp` plus every contributed\n * `Capabilities.ReactContext`.\n */\nexport const render = (harness: TestHarness, ui: ReactNode, options?: HarnessRenderOptions): RenderResult => {\n  const { reactContexts = [], ...rest } = options ?? {};\n  const Wrapper = ({ children }: PropsWithChildren) => (\n    <HarnessProviders harness={harness} extra={reactContexts}>\n      {children}\n    </HarnessProviders>\n  );\n  return rtlRender(<>{ui}</>, { ...rest, wrapper: Wrapper });\n};\n\nexport type RenderSurfaceProps<TToken extends RoleToken<any>> = {\n  type: TToken;\n  data?: TToken extends RoleToken<infer D> ? D : never;\n  limit?: number;\n  fallback?: FC<{ error: Error; data?: any }>;\n  placeholder?: ReactNode;\n};\n\n/**\n * Renders a `Surface` with the given role token/data inside the harness provider tree.\n */\nexport const renderSurface = <TToken extends RoleToken<any>>(\n  harness: TestHarness,\n  props: RenderSurfaceProps<TToken>,\n  options?: HarnessRenderOptions,\n): RenderResult => {\n  const { type, data, limit, fallback, placeholder } = props;\n  return render(\n    harness,\n    <SurfaceComponent type={type} data={data as any} limit={limit} fallback={fallback} placeholder={placeholder} />,\n    options,\n  );\n};\n\ntype HarnessProvidersProps = PropsWithChildren<{\n  harness: TestHarness;\n  extra: FC<PropsWithChildren>[];\n}>;\n\nconst HarnessProviders = ({ harness, extra, children }: HarnessProvidersProps) => {\n  const contributed = harness.getAll(Capabilities.ReactContext);\n  const ContributedContext = composeContexts(contributed);\n  const ExtraContext = composeExtra(extra);\n  return (\n    <PluginManagerProvider value={harness.manager}>\n      <ContextProtocolProvider value={harness.manager} context={PluginManagerContext}>\n        <RegistryContext.Provider value={harness.registry}>\n          <ContributedContext>\n            <ExtraContext>{children}</ExtraContext>\n          </ContributedContext>\n        </RegistryContext.Provider>\n      </ContextProtocolProvider>\n    </PluginManagerProvider>\n  );\n};\n\nconst composeContexts = (contexts: Capabilities.ReactContext[]): FC<PropsWithChildren> => {\n  if (contexts.length === 0) {\n    return Passthrough;\n  }\n  return topologicalSort(contexts)\n    .map(({ context }) => context)\n    .reduce((Acc, Next) => ({ children }: PropsWithChildren) => (\n      <Acc>\n        <Next>{children}</Next>\n      </Acc>\n    ));\n};\n\n// Composes in innermost-first order: the first context in the array wraps\n// `children` directly; subsequent contexts wrap the accumulator.\nconst composeExtra = (contexts: FC<PropsWithChildren>[]): FC<PropsWithChildren> => {\n  if (contexts.length === 0) {\n    return Passthrough;\n  }\n  return contexts.reduce<FC<PropsWithChildren>>(\n    (Acc, Next) =>\n      ({ children }: PropsWithChildren) => (\n        <Next>\n          <Acc>{children}</Acc>\n        </Next>\n      ),\n    Passthrough,\n  );\n};\n\nconst Passthrough: FC<PropsWithChildren> = ({ children }) => <Fragment>{children}</Fragment>;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;AAIA,SAASA,uBAAuB;AAChC,SAAgDC,UAAUC,iBAAiB;AAC3E,OAAOC,SAAkBC,gBAAwD;AAEjF,SAASC,+BAA+B;AAmBjC,IAAMC,SAAS,CAACC,SAAsBC,IAAeC,YAAAA;AAC1D,QAAM,EAAEC,gBAAgB,CAAA,GAAI,GAAGC,KAAAA,IAASF,WAAW,CAAC;AACpD,QAAMG,UAAU,CAAC,EAAEC,SAAQ,MACzB,sBAAA,cAACC,kBAAAA;IAAiBP;IAAkBQ,OAAOL;KACxCG,QAAAA;AAGL,SAAOG,UAAU,sBAAA,cAAA,MAAA,UAAA,MAAGR,EAAAA,GAAQ;IAAE,GAAGG;IAAMM,SAASL;EAAQ,CAAA;AAC1D;AAaO,IAAMM,gBAAgB,CAC3BX,SACAY,OACAV,YAAAA;AAEA,QAAM,EAAEW,MAAMC,MAAMC,OAAOC,UAAUC,YAAW,IAAKL;AACrD,SAAOb,OACLC,SACA,sBAAA,cAACkB,kBAAAA;IAAiBL;IAAYC;IAAmBC;IAAcC;IAAoBC;MACnFf,OAAAA;AAEJ;AAOA,IAAMK,mBAAmB,CAAC,EAAEP,SAASQ,OAAOF,SAAQ,MAAyB;AAC3E,QAAMa,cAAcnB,QAAQoB,OAAOC,qBAAaC,YAAY;AAC5D,QAAMC,qBAAqBC,gBAAgBL,WAAAA;AAC3C,QAAMM,eAAeC,aAAalB,KAAAA;AAClC,SACE,sBAAA,cAACmB,uBAAAA;IAAsBC,OAAO5B,QAAQ6B;KACpC,sBAAA,cAACC,yBAAAA;IAAwBF,OAAO5B,QAAQ6B;IAASE,SAASC;KACxD,sBAAA,cAACC,gBAAgBC,UAAQ;IAACN,OAAO5B,QAAQmC;KACvC,sBAAA,cAACZ,oBAAAA,MACC,sBAAA,cAACE,cAAAA,MAAcnB,QAAAA,CAAAA,CAAAA,CAAAA,CAAAA;AAM3B;AAEA,IAAMkB,kBAAkB,CAACY,aAAAA;AACvB,MAAIA,SAASC,WAAW,GAAG;AACzB,WAAOC;EACT;AACA,SAAOC,gBAAgBH,QAAAA,EACpBI,IAAI,CAAC,EAAET,QAAO,MAAOA,OAAAA,EACrBU,OAAO,CAACC,KAAKC,SAAS,CAAC,EAAErC,SAAQ,MAChC,sBAAA,cAACoC,KAAAA,MACC,sBAAA,cAACC,MAAAA,MAAMrC,QAAAA,CAAAA,CAAAA;AAGf;AAIA,IAAMoB,eAAe,CAACU,aAAAA;AACpB,MAAIA,SAASC,WAAW,GAAG;AACzB,WAAOC;EACT;AACA,SAAOF,SAASK,OACd,CAACC,KAAKC,SACJ,CAAC,EAAErC,SAAQ,MACT,sBAAA,cAACqC,MAAAA,MACC,sBAAA,cAACD,KAAAA,MAAKpC,QAAAA,CAAAA,GAGZgC,WAAAA;AAEJ;AAEA,IAAMA,cAAqC,CAAC,EAAEhC,SAAQ,MAAO,sBAAA,cAACsC,UAAAA,MAAUtC,QAAAA;",
+  "names": ["RegistryContext", "render", "rtlRender", "React", "Fragment", "ContextProtocolProvider", "render", "harness", "ui", "options", "reactContexts", "rest", "Wrapper", "children", "HarnessProviders", "extra", "rtlRender", "wrapper", "renderSurface", "props", "type", "data", "limit", "fallback", "placeholder", "SurfaceComponent", "contributed", "getAll", "Capabilities", "ReactContext", "ContributedContext", "composeContexts", "ExtraContext", "composeExtra", "PluginManagerProvider", "value", "manager", "ContextProtocolProvider", "context", "PluginManagerContext", "RegistryContext", "Provider", "registry", "contexts", "length", "Passthrough", "topologicalSort", "map", "reduce", "Acc", "Next", "Fragment"]
 }

package/dist/lib/node-esm/ui/index.mjs

@@ -9,27 +9,31 @@ import {
   useCapability,
   useLoading,
   useOperationInvoker,
+  useOptionalAtomCapabilityState,
+  useOptionalCapabilities,
+  useOptionalCapability,
   useProcessManagerRuntime,
   useSettingsState,
   useSpaceCallback,
   useSpaceService
-} from "../chunk-FSVGKTF6.mjs";
+} from "../chunk-ND2HETHD.mjs";
 import {
   PluginManagerProvider,
   Surface,
+  useOptionalPluginManager,
   usePluginManager,
   useSurface
-} from "../chunk-A5CHGAZE.mjs";
+} from "../chunk-DRT75WGD.mjs";
 import "../chunk-37Z53PXZ.mjs";
 import "../chunk-FPW45EZH.mjs";
-import "../chunk-NULBHQYS.mjs";
-import "../chunk-KFZEB6BV.mjs";
-import "../chunk-WK7OIQKI.mjs";
-import "../chunk-XGBUKRCK.mjs";
-import "../chunk-SX5NVETP.mjs";
-import "../chunk-XOCUANHO.mjs";
-import "../chunk-XIGPWXCQ.mjs";
-import "../chunk-CTKEZHKF.mjs";
+import "../chunk-XSZMX53L.mjs";
+import "../chunk-TLKYZKPW.mjs";
+import "../chunk-VCPGX7WN.mjs";
+import "../chunk-FKMVORZN.mjs";
+import "../chunk-IL7O7IRX.mjs";
+import "../chunk-BMW6P6QA.mjs";
+import "../chunk-4SE7SX7N.mjs";
+import "../chunk-GLH4LGHZ.mjs";
 import "../chunk-HSLMI22Q.mjs";
 export {
   App,
@@ -43,6 +47,10 @@ export {
   useCapability,
   useLoading,
   useOperationInvoker,
+  useOptionalAtomCapabilityState,
+  useOptionalCapabilities,
+  useOptionalCapability,
+  useOptionalPluginManager,
   usePluginManager,
   useProcessManagerRuntime,
   useSettingsState,