@dxos/app-framework 0.8.4-main.c85a9c8dae → 0.8.4-main.d05539e30a

package/dist/lib/browser/chunk-FO3IYSLV.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/edge-registry-plugin-provider.ts"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Context } from '@dxos/context';\nimport { type EdgeHttpClient } from '@dxos/edge-client';\nimport { type PluginEntry } from '@dxos/protocols';\n\nimport * as Registry from './registry';\n\n/**\n * Maps a wire-format `PluginEntry` (from `@dxos/protocols`) to a\n * `Registry.Plugin` (the app-framework domain type).\n *\n * This is the only translation seam between the two independently-defined type\n * hierarchies — fields are mapped explicitly, with no shared type between them.\n */\nconst toRegistryPlugin = (entry: PluginEntry): Registry.Plugin => ({\n  id: entry.meta.id,\n  name: entry.meta.name,\n  description: entry.meta.description,\n  homePage: entry.meta.homePage,\n  source: entry.meta.source,\n  screenshots: entry.meta.screenshots ? [...entry.meta.screenshots] : undefined,\n  tags: entry.meta.tags ? [...entry.meta.tags] : undefined,\n  icon: entry.meta.icon,\n  iconHue: entry.meta.iconHue,\n  moduleUrl: entry.moduleUrl,\n  repo: entry.repo,\n  version: entry.releaseTag,\n});\n\n/**\n * Implements `Registry.PluginProvider` against the Edge `/registry` HTTP endpoints.\n *\n * Lives in app-framework (rather than the more obvious home of `@dxos/edge-client`)\n * because edge-client doesn't depend on app-framework; siting the implementation\n * here keeps the dependency arrow `app-framework → edge-client` and avoids a\n * cycle. The class needs only the public `EdgeHttpClient` type, so a one-way\n * type-import is enough.\n *\n * `listVersions` is currently a stub: it returns the single latest version derived\n * from the cached plugin list, so the host's version picker has something to render.\n * The wire contract for the real endpoint already exists — see\n * `GetPluginVersionsResponseBodySchema` in `@dxos/protocols/edge/registry` and\n * {@link EdgeHttpClient.getRegistryPluginVersions} — so once Edge ships\n * `GET /registry/plugins/:repo/versions`, swap this stub for a call to\n * `this._client.getRegistryPluginVersions(...)` and map each entry through a\n * `toRegistryPluginVersion` helper (mirror of {@link toRegistryPlugin}).\n */\nexport class EdgeRegistryPluginProvider implements Registry.PluginProvider {\n  // Cached on first load so getPlugin/listVersions can resolve without re-fetching.\n  #cachedPlugins: readonly Registry.Plugin[] = [];\n\n  constructor(private readonly _client: EdgeHttpClient) {}\n\n  listPlugins(): Effect.Effect<readonly Registry.Plugin[], Error> {\n    return Effect.tryPromise({\n      try: () => this._client.getRegistryPlugins(Context.default()),\n      catch: (error) => (error instanceof Error ? error : new Error(String(error))),\n    }).pipe(\n      Effect.map((body) => {\n        const plugins = body.plugins.filter((entry) => entry.health === 'ok').map(toRegistryPlugin);\n        this.#cachedPlugins = plugins;\n        return plugins;\n      }),\n    );\n  }\n\n  listVersions(repo: string): Effect.Effect<readonly Registry.PluginVersion[], Error> {\n    // Stub: return only the currently-known version until Edge implements the versions endpoint.\n    const plugin = this.#cachedPlugins.find((candidate) => candidate.repo === repo);\n    if (!plugin) {\n      return Effect.fail(new Error(`Plugin not found in catalog: ${repo}`));\n    }\n    const version: Registry.PluginVersion = { tag: plugin.version, moduleUrl: plugin.moduleUrl };\n    return Effect.succeed([version]);\n  }\n\n  getPlugin(repo: string, version?: string): Effect.Effect<Registry.Plugin, Error> {\n    const plugin = this.#cachedPlugins.find((p) => p.repo === repo);\n    if (!plugin) {\n      return Effect.fail(new Error(`Plugin not found in catalog: ${repo}`));\n    }\n    if (version && version !== plugin.version) {\n      return Effect.fail(new Error(`Version ${version} not available for ${repo}; only ${plugin.version} is cached`));\n    }\n    return Effect.succeed(plugin);\n  }\n}\n"],
+  "mappings": ";AAIA,YAAYA,YAAY;AAExB,SAASC,eAAe;AAMxB,IAAA,eAAA;IASEC,mBAAqB,CAAA,WAAA;EACrBC,IAAAA,MAAAA,KAAaC;EACbC,MAAAA,MAAUD,KAAME;EAChBC,aAAQH,MAAWG,KAAAA;EACnBC,UAAAA,MAAaJ,KAAME;UAAuBF,MAAME,KAAKE;eAAeC,MAAAA,KAAAA,cAAAA;IACpEC,GAAMN,MAAME,KAAKI;;QAA8BD,MAAAA,KAAAA,OAAAA;IAC/CE,GAAMP,MAAME,KAAKK;EACjBC,IAAAA;EACAC,MAAAA,MAAWT,KAAMS;EACjBC,SAAMV,MAAMU,KAAI;EAChBC,WAASX,MAAMY;EACjB,MAAA,MAAA;EAEA,SAAA,MAAA;;AAmBE,IAAA,6BAAA,MAAA;EACA;;mBAE6BC,CAAAA;EAA0B,YAAA,SAAA;AAEvDC,SAAAA,UAAgE;;gBAEvD;WACGC,kBAAWA;MAClBC,KACDpB,MAAAA,KAAU,QAAEqB,mBAAAA,QAAAA,QAAAA,QAAAA,EAAAA,YAAAA,YAAAA,GAAAA,cAAAA,GAAAA,GAAAA,CAAAA,CAAAA;MACV,OAAMC,CAAAA,UAAUD,iBAAaE,QAAQnB,QAAUA,IAAMoB,MAAM,OAAK,KAAS,CAACC;YACrE,WAAA,CAAA,SAAiBH;AACtB,YAAA,UAAOA,KAAAA,QAAAA,OAAAA,CAAAA,UAAAA,MAAAA,WAAAA,IAAAA,EAAAA,IAAAA,gBAAAA;AACT,WAAA,iBAAA;AAEJ,aAAA;IAEAI,CAAAA,CAAAA;;eAEQC,MAAS;UAEb,SAAO3B,KAAO4B,eAAgB,KAAA,CAAA,cAAA,UAA6B,SAAQ,IAAA;AACrE,QAAA,CAAA,QAAA;AACA,aAAwC,YAAA,IAAA,MAAA,gCAAA,IAAA,EAAA,CAAA;;UAAuBf,UAAWc;MAAiB,KAAA,OAAA;MAC3F,WAAcE,OAAQ;;WAAS,eAAA;MACjC;IAEAC,CAAAA;;YAEOH,MAAAA,SAAQ;UACX,SAAO3B,KAAO4B,eAAgB,KAAA,CAAA,MAAA,EAAA,SAAA,IAAA;AAChC,QAAA,CAAA,QAAA;AACIb,aAAWA,YAAAA,IAAYY,MAAAA,gCAAgB,IAAA,EAAA,CAAA;;AAE3C,QAAA,WAAA,YAAA,OAAA,SAAA;AACA,aAAcE,YAAQF,IAAAA,MAAAA,WAAAA,OAAAA,sBAAAA,IAAAA,UAAAA,OAAAA,OAAAA,YAAAA,CAAAA;IACxB;AACF,WAAA,eAAA,MAAA;;;",
+  "names": ["Effect", "Context", "name", "description", "entry", "homePage", "meta", "source", "screenshots", "undefined", "tags", "icon", "iconHue", "moduleUrl", "repo", "version", "releaseTag", "_client", "listPlugins", "error", "pipe", "body", "plugins", "filter", "health", "toRegistryPlugin", "listVersions", "plugin", "fail", "succeed", "getPlugin"]
+}

package/dist/lib/browser/{chunk-YNFPIQGB.mjs → chunk-IW44C7UL.mjs}

@@ -7,7 +7,9 @@ var capability_exports = {};
 __export(capability_exports, {
   ModuleTag: () => ModuleTag,
   Service: () => Service,
+  asLayer: () => asLayer,
   atom: () => atom,
+  atomByModule: () => atomByModule,
   contributes: () => contributes,
   get: () => get,
   getAll: () => getAll,
@@ -19,6 +21,7 @@ __export(capability_exports, {
 });
 import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
 var Service = class extends Context.Tag("@dxos/app-framework/CapabilityManager")() {
 };
 var get = (interfaceDef) => Effect.flatMap(Service, (manager) => Effect.try({
@@ -28,6 +31,8 @@ var get = (interfaceDef) => Effect.flatMap(Service, (manager) => Effect.try({
 var getAll = (interfaceDef) => Effect.map(Service, (manager) => manager.getAll(interfaceDef));
 var waitFor = (interfaceDef) => Effect.flatMap(Service, (manager) => manager.waitFor(interfaceDef));
 var atom = (interfaceDef) => Effect.map(Service, (manager) => manager.atom(interfaceDef));
+var atomByModule = (interfaceDef) => Effect.map(Service, (manager) => manager.atomByModule(interfaceDef));
+var asLayer = (interfaceDef, tag) => Layer.effect(tag, get(interfaceDef).pipe(Effect.orDie));
 var ModuleTag = /* @__PURE__ */ Symbol.for("@dxos/app-framework/ModuleTag");
 var make = (identifier) => {
   return {
@@ -43,7 +48,7 @@ var contributes = (interfaceDef, implementation, deactivate) => {
 };
 var lazy = (name, c) => {
   const lazyFn = (props) => Effect.gen(function* () {
-    const { default: getCapability } = yield* Effect.tryPromise(() => c());
+    const { default: getCapability } = yield* Effect.promise(() => c());
     const result = yield* getCapability(props);
     const normalized = result == null ? [] : Array.isArray(result) ? Array.from(result) : [
       result
@@ -65,6 +70,8 @@ export {
   getAll,
   waitFor,
   atom,
+  atomByModule,
+  asLayer,
   ModuleTag,
   make,
   contributes,
@@ -73,4 +80,4 @@ export {
   makeModule,
   capability_exports
 };
-//# sourceMappingURL=chunk-YNFPIQGB.mjs.map
+//# sourceMappingURL=chunk-IW44C7UL.mjs.map

package/dist/lib/browser/chunk-IW44C7UL.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/capability.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Atom } from '@effect-atom/atom-react';\nimport * as Context from 'effect/Context';\nimport * as Effect from 'effect/Effect';\nimport * as Layer from 'effect/Layer';\n\nimport type * as CapabilityManager from './capability-manager';\nimport type * as Plugin from './plugin';\n\n//\n// Capability Service Layer\n//\n\n/**\n * Effect Context.Tag for accessing CapabilityManager via the Effect layer system.\n * This allows capability modules to access the capability manager without having it passed as an argument.\n */\nexport class Service extends Context.Tag('@dxos/app-framework/CapabilityManager')<\n  Service,\n  CapabilityManager.CapabilityManager\n>() {}\n\n/**\n * Get a single capability from the capability manager.\n * @param interfaceDef The interface definition of the capability.\n * @returns The capability implementation.\n * @throws If no capability is found.\n */\n// TODO(wittjosiah): Add custom tagged errors (Data.TaggedError) for app-framework to enable\n//   type-safe error handling with Effect. Consider CapabilityNotFoundError, ModuleActivationError, etc.\nexport const get = <T>(interfaceDef: InterfaceDef<T>): Effect.Effect<T, Error, Service> =>\n  Effect.flatMap(Service, (manager) =>\n    Effect.try({\n      try: () => manager.get(interfaceDef),\n      catch: (error) => (error instanceof Error ? error : new Error(String(error))),\n    }),\n  );\n\n/**\n * Get all capabilities from the capability manager for a given interface.\n * @param interfaceDef The interface definition of the capability.\n * @returns An array of capability implementations.\n */\nexport const getAll = <T>(interfaceDef: InterfaceDef<T>): Effect.Effect<T[], never, Service> =>\n  Effect.map(Service, (manager) => manager.getAll(interfaceDef));\n\n/**\n * Wait for a capability to be available.\n * @param interfaceDef The interface definition of the capability.\n * @returns The capability implementation once available.\n */\nexport const waitFor = <T>(interfaceDef: InterfaceDef<T>): Effect.Effect<T, Error, Service> =>\n  Effect.flatMap(Service, (manager) => manager.waitFor(interfaceDef));\n\n/**\n * Get the Atom reference to capabilities for reactive access.\n * @param interfaceDef The interface definition of the capability.\n * @returns An Atom containing the array of capability implementations.\n */\nexport const atom = <T>(interfaceDef: InterfaceDef<T>): Effect.Effect<Atom.Atom<T[]>, never, Service> =>\n  Effect.map(Service, (manager) => manager.atom(interfaceDef));\n\n/**\n * Get capabilities grouped by the module that contributed them.\n * @param interfaceDef The interface definition of the capability.\n * @returns An Atom containing a record from module ID to capability implementations.\n */\nexport const atomByModule = <T>(\n  interfaceDef: InterfaceDef<T>,\n): Effect.Effect<Atom.Atom<Record<string, T[]>>, never, Service> =>\n  Effect.map(Service, (manager) => manager.atomByModule(interfaceDef));\n\n/**\n * Constructs a layer that will request its interface implementation from the capability manager.\n */\nexport const asLayer = <T, I>(interfaceDef: InterfaceDef<T>, tag: Context.Tag<I, T>): Layer.Layer<I, never, Service> =>\n  Layer.effect(tag, get(interfaceDef).pipe(Effect.orDie));\n\nconst InterfaceDefTypeId: unique symbol = Symbol.for('InterfaceDefTypeId');\n\n/**\n * Symbol used to tag lazy capability functions with their module ID.\n */\nexport const ModuleTag: unique symbol = Symbol.for('@dxos/app-framework/ModuleTag');\n\n/**\n * The interface definition of a capability.\n */\nexport type InterfaceDef<T> = {\n  [InterfaceDefTypeId]: T;\n  identifier: string;\n};\n\nexport namespace InterfaceDef {\n  export type Implementation<I extends InterfaceDef<any>> = I extends InterfaceDef<infer T> ? T : never;\n}\n\n/**\n * Helper to define the interface of a capability.\n */\nexport const make = <T>(identifier: string) => {\n  return { identifier } as InterfaceDef<T>;\n};\n\n/**\n * A unique string identifier with a Typescript type associated with it.\n * When a capability is contributed to the application an implementation of the interface is provided.\n */\nexport type Capability<T> = {\n  /**\n   * The interface definition of the capability.\n   */\n  readonly interface: InterfaceDef<T>;\n\n  /**\n   * The implementation of the capability.\n   */\n  readonly implementation: T;\n\n  /**\n   * Called when the capability is deactivated.\n   */\n  readonly deactivate?: () => Effect.Effect<void, Error>;\n};\n\nexport type Any = Capability<any>;\n\n/**\n * Union type representing all valid return types for a capability module.\n * Supports single capabilities, arrays, and tuples of different capability types.\n */\nexport type ModuleReturn = void | Any | Any[] | readonly Any[] | [Any, ...Any[]] | readonly [Any, ...Any[]];\n\n/**\n * Helper to define the implementation of a capability.\n */\n// TODO(dmaretskyi): Make the return type non-generic so capabilities are non-discernable.\nexport const contributes = <I extends InterfaceDef<any>>(\n  interfaceDef: I,\n  implementation: Capability<InterfaceDef.Implementation<I>>['implementation'],\n  deactivate?: Capability<InterfaceDef.Implementation<I>>['deactivate'],\n): Capability<I> => {\n  return {\n    interface: interfaceDef,\n    implementation,\n    deactivate,\n  } satisfies Capability<I>;\n};\n\ntype LoadCapability<Props, Capabilities extends ModuleReturn = ModuleReturn> = () => Promise<{\n  default: (props: Props) => Effect.Effect<Capabilities, Error, Service | Plugin.Service | never>;\n}>;\ntype LoadCapabilities<Props, Capabilities extends ModuleReturn = ModuleReturn> = () => Promise<{\n  default: (props: Props) => Effect.Effect<Capabilities, Error, Service | Plugin.Service | never>;\n}>;\n\ntype NormalizeReturn<R> = R extends readonly (infer A)[]\n  ? A[]\n  : R extends (infer A)[]\n    ? A[]\n    : R extends Any\n      ? [R]\n      : Any[];\n\nexport type LazyCapability<Props = void, Capabilities extends ModuleReturn = ModuleReturn, E extends Error = Error> = (\n  props: Props,\n) => Effect.Effect<NormalizeReturn<Capabilities>, E, Service | Plugin.Service | never>;\n\n/**\n * Helper to define a lazily loaded implementation of a capability.\n * Supports single capabilities, arrays, and tuples of different capability types.\n * @param name The export name (e.g., 'AppGraphBuilder') - used to auto-compute module IDs.\n * @param loader The lazy loader function.\n * @returns A lazy capability function with ModuleTag symbol attached.\n */\nexport const lazy = <T = void, R extends ModuleReturn = ModuleReturn>(\n  name: string,\n  c: LoadCapability<T, R> | LoadCapabilities<T, R>,\n): LazyCapability<T, R> => {\n  const lazyFn: LazyCapability<T, R> = (props: T) =>\n    Effect.gen(function* () {\n      const { default: getCapability } = yield* Effect.promise(() => c());\n      const result = yield* getCapability(props);\n      const normalized = result == null ? [] : Array.isArray(result) ? Array.from(result) : [result];\n      return normalized as NormalizeReturn<R>;\n    });\n\n  return Object.assign(lazyFn, { [ModuleTag]: name });\n};\n\n/**\n * Gets the module tag (export name) from a lazy capability function.\n * @param capability The lazy capability function.\n * @returns The module tag if present, undefined otherwise.\n */\n// TODO(wittjosiah): Stricter type for capability.\nexport const getModuleTag = (capability: unknown): string | undefined => {\n  return capability && typeof capability === 'function' && ModuleTag in capability\n    ? String(capability[ModuleTag])\n    : undefined;\n};\n\n/**\n * Helper to define a capability module with explicit typing.\n * Wraps the default export function to provide better type inference and make the pattern explicit.\n *\n * This helper provides explicit typing for the module activation function,\n * making it clear that the function should:\n * - Access CapabilityManager via the Effect layer system (Capability.get, Capability.getAll, etc.)\n * - Return a capability, array of capabilities, or tuple of different capability types (sync or async)\n *\n * Supports returning multiple capabilities of different types as a tuple, which will be normalized\n * to an array at runtime for compatibility with the plugin system.\n *\n * @example\n * ```ts\n * // Module without options - single capability\n * export default Capability.makeModule(\n *   Effect.fnUntraced(function* () {\n *     const client = yield* Capability.get(ClientCapabilities.Client);\n *     return contributes(Capabilities.SettingsStore, store);\n *   })\n * );\n *\n * // Module with multiple capabilities\n * export default Capability.makeModule(\n *   Effect.fnUntraced(function* () {\n *     return [\n *       contributes(Capabilities.SettingsStore, store),\n *       contributes(Capabilities.Translations, translations),\n *     ];\n *   })\n * );\n *\n * // Module with required options (context accessed via layer)\n * export default Capability.makeModule(\n *   Effect.fnUntraced(function* (props: { observability: boolean }) {\n *     const invoker = yield* Capability.get(Capabilities.OperationInvoker);\n *     return contributes(Capabilities.OperationHandler, ...);\n *   })\n * );\n * ```\n */\nexport const makeModule = <\n  TProps = void,\n  TReturn extends ModuleReturn = ModuleReturn,\n  E extends Error = Error,\n  R extends Service | Plugin.Service | never = Service,\n>(\n  fn: (props: TProps) => Effect.Effect<TReturn, E, R>,\n): ((props: TProps) => Effect.Effect<TReturn, E, R>) => fn;\n"],
+  "mappings": ";;;;;AAAA;;;;;;;;;;;;;;;;AAKA,YAAYA,aAAa;AACzB,YAAYC,YAAY;AACxB,YAAYC,WAAW;AAahB,IAAMC,UAAN,cAA8BC,YAAI,uCAAA,EAAA,EAAA;AAGpC;AAUE,IAAMC,MAAM,CAAIC,iBACdC,eAAQJ,SAAS,CAACK,YAChBC,WAAI;EACTA,KAAK,MAAMD,QAAQH,IAAIC,YAAAA;EACvBI,OAAO,CAACC,UAAWA,iBAAiBC,QAAQD,QAAQ,IAAIC,MAAMC,OAAOF,KAAAA,CAAAA;AACvE,CAAA,CAAA;AAQG,IAAMG,SAAS,CAAIR,iBACjBS,WAAIZ,SAAS,CAACK,YAAYA,QAAQM,OAAOR,YAAAA,CAAAA;AAO3C,IAAMU,UAAU,CAAIV,iBAClBC,eAAQJ,SAAS,CAACK,YAAYA,QAAQQ,QAAQV,YAAAA,CAAAA;AAOhD,IAAMW,OAAO,CAAIX,iBACfS,WAAIZ,SAAS,CAACK,YAAYA,QAAQS,KAAKX,YAAAA,CAAAA;AAOzC,IAAMY,eAAe,CAC1BZ,iBAEOS,WAAIZ,SAAS,CAACK,YAAYA,QAAQU,aAAaZ,YAAAA,CAAAA;AAKjD,IAAMa,UAAU,CAAOb,cAA+Bc,QACrDC,aAAOD,KAAKf,IAAIC,YAAAA,EAAcgB,KAAYC,YAAK,CAAA;AAOhD,IAAMC,YAA2BC,uBAAOC,IAAI,+BAAA;AAiB5C,IAAMC,OAAO,CAAIC,eAAAA;AACtB,SAAO;IAAEA;EAAW;AACtB;AAmCO,IAAMC,cAAc,CACzBC,cACAC,gBACAC,eAAAA;AAEA,SAAO;IACLC,WAAWH;IACXC;IACAC;EACF;AACF;AA4BO,IAAME,OAAO,CAClBC,MACAC,MAAAA;AAEA,QAAMC,SAA+B,CAACC,UAC7BC,WAAI,aAAA;AACT,UAAM,EAAEC,SAASC,cAAa,IAAK,OAAcC,eAAQ,MAAMN,EAAAA,CAAAA;AAC/D,UAAMO,SAAS,OAAOF,cAAcH,KAAAA;AACpC,UAAMM,aAAaD,UAAU,OAAO,CAAA,IAAKE,MAAMC,QAAQH,MAAAA,IAAUE,MAAME,KAAKJ,MAAAA,IAAU;MAACA;;AACvF,WAAOC;EACT,CAAA;AAEF,SAAOI,OAAOC,OAAOZ,QAAQ;IAAE,CAACb,SAAAA,GAAYW;EAAK,CAAA;AACnD;AAQO,IAAMe,eAAe,CAACC,eAAAA;AAC3B,SAAOA,cAAc,OAAOA,eAAe,cAAc3B,aAAa2B,aAClEC,OAAOD,WAAW3B,SAAAA,CAAU,IAC5B6B;AACN;AA2CO,IAAMC,aAAa,CAMxBC,OACsDA;",
+  "names": ["Context", "Effect", "Layer", "Service", "Tag", "get", "interfaceDef", "flatMap", "manager", "try", "catch", "error", "Error", "String", "getAll", "map", "waitFor", "atom", "atomByModule", "asLayer", "tag", "effect", "pipe", "orDie", "ModuleTag", "Symbol", "for", "make", "identifier", "contributes", "interfaceDef", "implementation", "deactivate", "interface", "lazy", "name", "c", "lazyFn", "props", "gen", "default", "getCapability", "promise", "result", "normalized", "Array", "isArray", "from", "Object", "assign", "getModuleTag", "capability", "String", "undefined", "makeModule", "fn"]
+}

package/dist/lib/browser/{chunk-5RJNZV7K.mjs → chunk-KFDF7KR3.mjs}

@@ -1,6 +1,6 @@
 import {
   capability_exports
-} from "./chunk-YNFPIQGB.mjs";
+} from "./chunk-IW44C7UL.mjs";
 
 // src/common/translations.ts
 import * as Schema from "effect/Schema";
@@ -12,12 +12,12 @@ var Label = Schema.Union(Schema.String, Schema.mutable(Schema.Tuple(Schema.Strin
 
 // src/common/operations.ts
 import * as Schema2 from "effect/Schema";
-import { Operation } from "@dxos/operation";
-var UNDO_NAMESPACE = "dxos.org/app-framework/undo";
+import { Operation } from "@dxos/compute";
+var UNDO_NAMESPACE = "org.dxos.app-framework.undo";
 (function(UndoOperation2) {
   UndoOperation2.ShowUndo = Operation.make({
     meta: {
-      key: `${UNDO_NAMESPACE}/operation/show-undo`,
+      key: `${UNDO_NAMESPACE}.operation.show-undo`,
       name: "Show Undo",
       description: "Show an undo toast notification."
     },
@@ -25,14 +25,12 @@ var UNDO_NAMESPACE = "dxos.org/app-framework/undo";
     services: [
       capability_exports.Service
     ],
-    schema: {
-      input: Schema2.Struct({
-        message: Schema2.optional(Label.annotations({
-          description: "The message to display in the undo toast."
-        }))
-      }),
-      output: Schema2.Void
-    }
+    input: Schema2.Struct({
+      message: Schema2.optional(Label.annotations({
+        description: "The message to display in the undo toast."
+      }))
+    }),
+    output: Schema2.Void
   });
 })(UndoOperation || (UndoOperation = {}));
 var UndoOperation;
@@ -41,4 +39,4 @@ export {
   Label,
   UndoOperation
 };
-//# sourceMappingURL=chunk-5RJNZV7K.mjs.map
+//# sourceMappingURL=chunk-KFDF7KR3.mjs.map

package/dist/lib/browser/{chunk-5RJNZV7K.mjs.map → chunk-KFDF7KR3.mjs.map}

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/common/translations.ts", "../../../src/common/operations.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\n/**\n * A Label represents translatable text - either a simple string or a tuple of [key, options].\n */\nexport const Label = Schema.Union(\n  Schema.String,\n  Schema.mutable(\n    Schema.Tuple(\n      Schema.String,\n      Schema.mutable(\n        Schema.Struct({\n          ns: Schema.String,\n          count: Schema.optional(Schema.Number),\n          defaultValue: Schema.optional(Schema.String),\n        }),\n      ),\n    ),\n  ),\n);\nexport type Label = Schema.Schema.Type<typeof Label>;\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { Operation } from '@dxos/operation';\n\nimport { Capability } from '../core';\n\nimport { Label } from './translations';\n\nconst UNDO_NAMESPACE = 'dxos.org/app-framework/undo';\n\n/**\n * Operations related to undo/history functionality.\n */\nexport namespace UndoOperation {\n  /**\n   * Show an undo toast notification.\n   * Fired by HistoryTracker when an undoable operation is tracked.\n   */\n  export const ShowUndo = Operation.make({\n    meta: {\n      key: `${UNDO_NAMESPACE}/operation/show-undo`,\n      name: 'Show Undo',\n      description: 'Show an undo toast notification.',\n    },\n    executionMode: 'sync',\n    services: [Capability.Service],\n    schema: {\n      input: Schema.Struct({\n        message: Schema.optional(Label.annotations({ description: 'The message to display in the undo toast.' })),\n      }),\n      output: Schema.Void,\n    },\n  });\n}\n"],
-  "mappings": ";;;;;AAIA,YAAYA,YAAY;AAKjB,IAAMC,QAAeC,aACnBC,eACAC,eACEC,aACEF,eACAC,eACEE,cAAO;EACZC,IAAWJ;EACXK,OAAcC,gBAAgBC,aAAM;EACpCC,cAAqBF,gBAAgBN,aAAM;AAC7C,CAAA,CAAA,CAAA,CAAA,CAAA;;;ACfR,YAAYS,aAAY;AAExB,SAASC,iBAAiB;AAM1B,IAAMC,iBAAiB;UAKNC,gBAAAA;iBAKFC,WAAWC,UAAUC,KAAK;IACrCC,MAAM;MACJC,KAAK,GAAGN,cAAAA;MACRO,MAAM;MACNC,aAAa;IACf;IACAC,eAAe;IACfC,UAAU;MAACC,mBAAWC;;IACtBC,QAAQ;MACNC,OAAcC,eAAO;QACnBC,SAAgBC,iBAASC,MAAMC,YAAY;UAAEX,aAAa;QAA4C,CAAA,CAAA;MACxG,CAAA;MACAY,QAAeC;IACjB;EACF,CAAA;AACF,GApBiBpB,kBAAAA,gBAAAA,CAAAA,EAAAA;;",
-  "names": ["Schema", "Label", "Union", "String", "mutable", "Tuple", "Struct", "ns", "count", "optional", "Number", "defaultValue", "Schema", "Operation", "UNDO_NAMESPACE", "UndoOperation", "ShowUndo", "Operation", "make", "meta", "key", "name", "description", "executionMode", "services", "Capability", "Service", "schema", "input", "Struct", "message", "optional", "Label", "annotations", "output", "Void"]
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\n/**\n * A Label represents translatable text - either a simple string or a tuple of [key, options].\n */\nexport const Label = Schema.Union(\n  Schema.String,\n  Schema.mutable(\n    Schema.Tuple(\n      Schema.String,\n      Schema.mutable(\n        Schema.Struct({\n          ns: Schema.String,\n          count: Schema.optional(Schema.Number),\n          defaultValue: Schema.optional(Schema.String),\n        }),\n      ),\n    ),\n  ),\n);\nexport type Label = Schema.Schema.Type<typeof Label>;\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { Operation } from '@dxos/compute';\n\nimport { Capability } from '../core';\nimport { Label } from './translations';\n\nconst UNDO_NAMESPACE = 'org.dxos.app-framework.undo';\n\n/**\n * Operations related to undo/history functionality.\n */\nexport namespace UndoOperation {\n  /**\n   * Show an undo toast notification.\n   * Fired by HistoryTracker when an undoable operation is tracked.\n   */\n  export const ShowUndo = Operation.make({\n    meta: {\n      key: `${UNDO_NAMESPACE}.operation.show-undo`,\n      name: 'Show Undo',\n      description: 'Show an undo toast notification.',\n    },\n    executionMode: 'sync',\n    services: [Capability.Service],\n    input: Schema.Struct({\n      message: Schema.optional(Label.annotations({ description: 'The message to display in the undo toast.' })),\n    }),\n    output: Schema.Void,\n  });\n}\n"],
+  "mappings": ";;;;;AAIA,YAAYA,YAAY;AAKjB,IAAMC,QAAeC,aACnBC,eACAC,eACEC,aACEF,eACAC,eACEE,cAAO;EACZC,IAAWJ;EACXK,OAAcC,gBAAgBC,aAAM;EACpCC,cAAqBF,gBAAgBN,aAAM;AAC7C,CAAA,CAAA,CAAA,CAAA,CAAA;;;ACfR,YAAYS,aAAY;AAExB,SAASC,iBAAiB;AAK1B,IAAMC,iBAAiB;UAKNC,gBAAAA;iBAKFC,WAAWC,UAAUC,KAAK;IACrCC,MAAM;MACJC,KAAK,GAAGN,cAAAA;MACRO,MAAM;MACNC,aAAa;IACf;IACAC,eAAe;IACfC,UAAU;MAACC,mBAAWC;;IACtBC,OAAcC,eAAO;MACnBC,SAAgBC,iBAASC,MAAMC,YAAY;QAAEV,aAAa;MAA4C,CAAA,CAAA;IACxG,CAAA;IACAW,QAAeC;EACjB,CAAA;AACF,GAlBiBnB,kBAAAA,gBAAAA,CAAAA,EAAAA;;",
+  "names": ["Schema", "Label", "Union", "String", "mutable", "Tuple", "Struct", "ns", "count", "optional", "Number", "defaultValue", "Schema", "Operation", "UNDO_NAMESPACE", "UndoOperation", "ShowUndo", "Operation", "make", "meta", "key", "name", "description", "executionMode", "services", "Capability", "Service", "input", "Struct", "message", "optional", "Label", "annotations", "output", "Void"]
 }

package/dist/lib/browser/chunk-KLHQNYJ2.mjs

@@ -0,0 +1,422 @@
+import {
+  isPlugin
+} from "./chunk-SLX73WRZ.mjs";
+import {
+  __export
+} from "./chunk-J5LGTIGS.mjs";
+
+// src/core/url-loader.ts
+var url_loader_exports = {};
+__export(url_loader_exports, {
+  RemotePluginLoadError: () => RemotePluginLoadError,
+  getInstalledVersion: () => getInstalledVersion,
+  getRemoteEntries: () => getRemoteEntries,
+  isLocalUrl: () => isLocalUrl,
+  make: () => make,
+  preload: () => preload,
+  setInstalledVersion: () => setInstalledVersion,
+  uninstall: () => uninstall
+});
+import * as Effect3 from "effect/Effect";
+import * as Option from "effect/Option";
+import { BaseError as BaseError3 } from "@dxos/errors";
+import { log } from "@dxos/log";
+
+// src/core/plugin-asset-cache.ts
+var plugin_asset_cache_exports = {};
+__export(plugin_asset_cache_exports, {
+  PluginAssetCacheError: () => PluginAssetCacheError,
+  noop: () => noop
+});
+import * as Effect from "effect/Effect";
+import { BaseError } from "@dxos/errors";
+var PluginAssetCacheError = class extends BaseError.extend("PluginAssetCacheError", "Plugin asset cache operation failed") {
+};
+var noop = () => ({
+  cache: () => Effect.void,
+  evict: () => Effect.void,
+  resolve: (_pluginId, url) => Effect.succeed(url),
+  list: () => Effect.succeed([])
+});
+
+// src/core/plugin-manifest.ts
+var plugin_manifest_exports = {};
+__export(plugin_manifest_exports, {
+  Manifest: () => Manifest,
+  PLUGIN_DEV_SERVER_PORT: () => PLUGIN_DEV_SERVER_PORT,
+  PluginManifestError: () => PluginManifestError,
+  fetchManifest: () => fetchManifest,
+  parse: () => parse
+});
+import * as FetchHttpClient from "@effect/platform/FetchHttpClient";
+import * as HttpClient from "@effect/platform/HttpClient";
+import * as HttpClientRequest from "@effect/platform/HttpClientRequest";
+import * as HttpClientResponse from "@effect/platform/HttpClientResponse";
+import * as Effect2 from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { BaseError as BaseError2 } from "@dxos/errors";
+import { PLUGIN_ENTRY_FILENAME } from "@dxos/protocols";
+var PLUGIN_DEV_SERVER_PORT = 3967;
+var PluginManifestError = class extends BaseError2.extend("PluginManifestError", "Plugin manifest is invalid") {
+};
+var Manifest = Schema.Struct({
+  id: Schema.String,
+  name: Schema.String,
+  version: Schema.String,
+  assets: Schema.Array(Schema.String),
+  devEntry: Schema.String.pipe(Schema.optional)
+});
+var resolve = (manifestUrl, manifest) => {
+  const dev = manifest.devEntry !== void 0;
+  return {
+    id: manifest.id,
+    name: manifest.name,
+    version: manifest.version,
+    entryUrl: new URL(dev ? manifest.devEntry : PLUGIN_ENTRY_FILENAME, manifestUrl).toString(),
+    assetUrls: manifest.assets.map((asset) => new URL(asset, manifestUrl).toString()),
+    dev
+  };
+};
+var parse = (manifestUrl, payload) => {
+  const manifest = Schema.decodeUnknownSync(Manifest)(payload);
+  if (manifest.devEntry === void 0 && !manifest.assets.includes(PLUGIN_ENTRY_FILENAME)) {
+    throw new Error(`Manifest at ${manifestUrl} does not list ${PLUGIN_ENTRY_FILENAME} in assets.`);
+  }
+  return resolve(manifestUrl, manifest);
+};
+var fetchManifest = (manifestUrl) => Effect2.gen(function* () {
+  const response = yield* HttpClientRequest.get(manifestUrl).pipe(HttpClient.execute, Effect2.mapError((cause) => new PluginManifestError({
+    context: {
+      manifestUrl,
+      reason: "fetch-failed"
+    },
+    cause
+  })));
+  if (response.status >= 400) {
+    return yield* Effect2.fail(new PluginManifestError({
+      context: {
+        manifestUrl,
+        reason: "http-error",
+        status: response.status
+      }
+    }));
+  }
+  const manifest = yield* HttpClientResponse.schemaBodyJson(Manifest)(response).pipe(Effect2.mapError((cause) => new PluginManifestError({
+    context: {
+      manifestUrl,
+      reason: "parse-failed"
+    },
+    cause
+  })));
+  if (manifest.devEntry === void 0 && !manifest.assets.includes(PLUGIN_ENTRY_FILENAME)) {
+    return yield* Effect2.fail(new PluginManifestError({
+      context: {
+        manifestUrl,
+        reason: "invalid"
+      },
+      cause: `assets does not include ${PLUGIN_ENTRY_FILENAME}`
+    }));
+  }
+  return resolve(manifestUrl, manifest);
+}).pipe(Effect2.scoped, Effect2.provide(FetchHttpClient.layer));
+
+// src/core/url-loader.ts
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/core/url-loader.ts";
+var DEFAULT_KEY = "org.dxos.composer.remote-plugins";
+var RemotePluginLoadError = class extends BaseError3.extend("RemotePluginLoadError", "Failed to load remote plugin") {
+};
+var defaultStorage = () => ({
+  get: (key) => localStorage.getItem(key),
+  set: (key, value) => localStorage.setItem(key, value)
+});
+var getPersistedRemotePlugins = (storage, key) => {
+  try {
+    const parsed = JSON.parse(storage.get(key) ?? "[]");
+    if (!Array.isArray(parsed)) {
+      return [];
+    }
+    return parsed.filter((entry) => typeof entry === "object" && entry !== null && typeof entry.id === "string" && typeof entry.url === "string");
+  } catch {
+    return [];
+  }
+};
+var persistRemotePlugin = (storage, key, entry) => {
+  try {
+    const entries = getPersistedRemotePlugins(storage, key).filter((existing) => existing.id !== entry.id);
+    entries.push(entry);
+    storage.set(key, JSON.stringify(entries));
+  } catch (error) {
+    log.warn("failed to persist remote plugin entry", {
+      entry,
+      error
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 40, S: void 0 });
+  }
+};
+var removePersistedRemotePlugin = (storage, key, pluginId) => {
+  try {
+    const entries = getPersistedRemotePlugins(storage, key).filter((existing) => existing.id !== pluginId);
+    storage.set(key, JSON.stringify(entries));
+  } catch (error) {
+    log.warn("failed to remove remote plugin entry", {
+      pluginId,
+      error
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 51, S: void 0 });
+  }
+};
+var isUrl = (locator) => {
+  try {
+    const url = new URL(locator);
+    return url.protocol === "http:" || url.protocol === "https:";
+  } catch {
+    return false;
+  }
+};
+var isLocalUrl = (locator) => {
+  try {
+    const hostname = new URL(locator).hostname.toLowerCase();
+    return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "::1" || hostname === "[::1]";
+  } catch {
+    return false;
+  }
+};
+var getRemoteEntries = (options = {}) => {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  return getPersistedRemotePlugins(storage, key);
+};
+var setInstalledVersion = (id, version, options = {}) => {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  const entries = getPersistedRemotePlugins(storage, key);
+  const index = entries.findIndex((entry) => entry.id === id);
+  if (index === -1) {
+    return;
+  }
+  entries[index] = {
+    ...entries[index],
+    version
+  };
+  try {
+    storage.set(key, JSON.stringify(entries));
+  } catch (error) {
+    log.warn("failed to update installed version for remote plugin", {
+      id,
+      version,
+      error
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 103, S: void 0 });
+  }
+};
+var getInstalledVersion = (id, options = {}) => {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  return getPersistedRemotePlugins(storage, key).find((entry) => entry.id === id)?.version;
+};
+var normalizePluginExport = (mod) => {
+  const exported = mod.default;
+  if (isPlugin(exported)) {
+    return exported;
+  }
+  if (typeof exported === "function") {
+    const result = exported();
+    if (isPlugin(result)) {
+      return result;
+    }
+  }
+  throw new Error("Remote module default export is not a Plugin or a zero-arg plugin factory.");
+};
+var loadStylesheets = (manifest, cache) => Effect3.gen(function* () {
+  if (typeof document === "undefined") {
+    return;
+  }
+  const cssUrls = manifest.assetUrls.filter((url) => url.endsWith(".css"));
+  for (const url of cssUrls) {
+    const resolved = yield* cache.resolve(manifest.id, url);
+    if (document.querySelector(`link[data-dxos-plugin-id="${manifest.id}"][href="${resolved}"]`)) {
+      continue;
+    }
+    const link = document.createElement("link");
+    link.rel = "stylesheet";
+    link.href = resolved;
+    link.dataset.dxosPluginId = manifest.id;
+    document.head.appendChild(link);
+  }
+});
+var loadFromManifest = (manifestUrl, cache) => Effect3.gen(function* () {
+  log.info("loading remote plugin", {
+    manifestUrl
+  }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 152, S: this });
+  const manifest = yield* fetchManifest(manifestUrl).pipe(Effect3.mapError((cause) => new RemotePluginLoadError({
+    context: {
+      locator: manifestUrl,
+      reason: "manifest-error"
+    },
+    cause
+  })));
+  const wrapCacheError = Effect3.mapError((cause) => new RemotePluginLoadError({
+    context: {
+      locator: manifestUrl,
+      reason: "cache-error"
+    },
+    cause
+  }));
+  if (!manifest.dev) {
+    const cachedUrls = manifest.assetUrls.indexOf(manifestUrl) === -1 ? [
+      manifestUrl,
+      ...manifest.assetUrls
+    ] : manifest.assetUrls;
+    yield* cache.cache(manifest.id, cachedUrls).pipe(wrapCacheError);
+  }
+  const entryUrl = manifest.dev ? manifest.entryUrl : yield* cache.resolve(manifest.id, manifest.entryUrl).pipe(wrapCacheError);
+  const mod = yield* Effect3.tryPromise({
+    try: () => import(
+      /* @vite-ignore */
+      entryUrl
+    ),
+    catch: (cause) => new RemotePluginLoadError({
+      context: {
+        locator: manifestUrl,
+        reason: "import-failed"
+      },
+      cause
+    })
+  });
+  const plugin = normalizePluginExport(mod);
+  if (!plugin.meta.id || !plugin.meta.name) {
+    return yield* Effect3.fail(new RemotePluginLoadError({
+      context: {
+        locator: manifestUrl,
+        reason: "meta-missing"
+      }
+    }));
+  }
+  if (plugin.meta.id !== manifest.id) {
+    return yield* Effect3.fail(new RemotePluginLoadError({
+      context: {
+        locator: manifestUrl,
+        reason: "meta-mismatch",
+        metaId: plugin.meta.id,
+        manifestId: manifest.id
+      }
+    }));
+  }
+  if (!manifest.dev) {
+    yield* loadStylesheets(manifest, cache).pipe(wrapCacheError);
+  }
+  return {
+    plugin,
+    manifest
+  };
+});
+var preload = (options = {}) => Effect3.gen(function* () {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  const cache = options.cache ?? noop();
+  const onPluginLoaded = options.onPluginLoaded;
+  const entries = getPersistedRemotePlugins(storage, key);
+  if (entries.length === 0) {
+    return [];
+  }
+  log.info("preloading remote plugins", {
+    count: entries.length
+  }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 240, S: this });
+  const total = entries.length;
+  let loaded = 0;
+  const results = yield* Effect3.all(entries.map((entry) => loadFromManifest(entry.url, cache).pipe(
+    Effect3.tapError((error) => Effect3.sync(() => log.warn("failed to preload remote plugin", {
+      entry,
+      error
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 245, S: this }))),
+    Effect3.option,
+    // Tick the progress hook on both success and recoverable failure so
+    // the counter monotonically reaches `total`. The host-supplied
+    // callback is best-effort: any synchronous throw flows through
+    // `Effect.try` and gets logged + ignored so a buggy hook can't
+    // derail the preload.
+    Effect3.tap(() => Effect3.sync(() => {
+      loaded += 1;
+    }).pipe(Effect3.andThen(Effect3.try(() => onPluginLoaded?.(loaded, total))), Effect3.tapError((error) => Effect3.sync(() => log.warn("onPluginLoaded threw", {
+      loaded,
+      total,
+      error
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 255, S: this }))), Effect3.ignore))
+  )), {
+    concurrency: "unbounded"
+  });
+  return results.flatMap((result) => Option.match(result, {
+    onNone: () => [],
+    onSome: ({ plugin }) => [
+      plugin
+    ]
+  }));
+});
+var make = (builtinPlugins, options = {}) => {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  const cache = options.cache ?? noop();
+  return (locator) => Effect3.gen(function* () {
+    const builtin = builtinPlugins.find((plugin2) => plugin2.meta.id === locator);
+    if (builtin) {
+      return {
+        plugin: builtin
+      };
+    }
+    if (!isUrl(locator)) {
+      return yield* Effect3.fail(new RemotePluginLoadError({
+        context: {
+          locator,
+          reason: "invalid-locator"
+        }
+      }));
+    }
+    const { plugin, manifest } = yield* loadFromManifest(locator, cache);
+    if (!manifest.dev) {
+      const duplicate = builtinPlugins.find((existing) => existing.meta.id === plugin.meta.id);
+      if (duplicate) {
+        return yield* Effect3.fail(new RemotePluginLoadError({
+          context: {
+            locator,
+            reason: "duplicate-id",
+            id: plugin.meta.id
+          }
+        }));
+      }
+      persistRemotePlugin(storage, key, {
+        id: plugin.meta.id,
+        url: locator
+      });
+    }
+    return {
+      plugin,
+      dev: manifest.dev
+    };
+  });
+};
+var uninstall = (pluginId, options = {}) => Effect3.gen(function* () {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  const cache = options.cache ?? noop();
+  removePersistedRemotePlugin(storage, key, pluginId);
+  if (typeof document !== "undefined") {
+    document.querySelectorAll(`link[data-dxos-plugin-id="${pluginId}"]`).forEach((node) => node.remove());
+  }
+  yield* cache.evict(pluginId).pipe(Effect3.tapError((error) => Effect3.sync(() => log.warn("failed to evict plugin assets", {
+    pluginId,
+    error
+  }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 337, S: this }))), Effect3.ignore);
+});
+
+export {
+  plugin_asset_cache_exports,
+  PLUGIN_DEV_SERVER_PORT,
+  plugin_manifest_exports,
+  RemotePluginLoadError,
+  isLocalUrl,
+  getRemoteEntries,
+  setInstalledVersion,
+  getInstalledVersion,
+  preload,
+  make,
+  uninstall,
+  url_loader_exports
+};
+//# sourceMappingURL=chunk-KLHQNYJ2.mjs.map