@dxos/app-framework 0.8.4-main.f9ba587 → 0.8.4-main.fd6878d

package/dist/lib/node-esm/{chunk-VSKRV3NW.mjs → chunk-YEN7NKTF.mjs}

@@ -1,105 +1,11 @@
 import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
 
 // src/plugin-intent/intent-dispatcher.ts
-import { Effect as Effect3, Option, pipe as pipe2, Ref as Ref2 } from "effect";
+import { Effect as Effect3, Option, Ref as Ref3, pipe as pipe2 } from "effect";
 import { live as live2 } from "@dxos/live-object";
 import { log as log3 } from "@dxos/log";
 import { byPosition } from "@dxos/util";
 
-// src/plugin-intent/actions.ts
-import { Schema as Schema2 } from "effect";
-
-// src/plugin-intent/intent.ts
-import { Schema } from "effect";
-var createIntent = (schema, data = {}, params = {}) => {
-  const _ = Schema.validateSync(schema.fields.input)(data);
-  const intent = {
-    ...params,
-    _schema: schema,
-    id: schema._tag,
-    data
-  };
-  return {
-    first: intent,
-    last: intent,
-    all: [
-      intent
-    ]
-  };
-};
-var chain = (schema, data = {}, params = {}) => (intent) => {
-  const intents = "all" in intent ? intent.all : [
-    intent
-  ];
-  const first = intents[0];
-  const last = {
-    ...params,
-    _schema: schema,
-    id: schema._tag,
-    data
-  };
-  return {
-    first,
-    last,
-    all: [
-      ...intents,
-      last
-    ]
-  };
-};
-var Label = Schema.Union(Schema.String, Schema.mutable(Schema.Tuple(Schema.String, Schema.mutable(Schema.Struct({
-  ns: Schema.String,
-  count: Schema.optional(Schema.Number),
-  defaultValue: Schema.optional(Schema.String)
-})))));
-
-// src/plugin-intent/actions.ts
-var INTENT_PLUGIN = "dxos.org/plugin/intent";
-var INTENT_ACTION = `${INTENT_PLUGIN}/action`;
-(function(IntentAction2) {
-  class Track extends Schema2.TaggedClass()(`${INTENT_ACTION}/track`, {
-    input: Schema2.Struct({
-      intents: Schema2.Array(Schema2.String),
-      error: Schema2.optional(Schema2.String)
-    }),
-    output: Schema2.Void
-  }) {
-  }
-  IntentAction2.Track = Track;
-  class ShowUndo extends Schema2.TaggedClass()(`${INTENT_ACTION}/show-undo`, {
-    input: Schema2.Struct({
-      message: Label
-    }),
-    output: Schema2.Void
-  }) {
-  }
-  IntentAction2.ShowUndo = ShowUndo;
-})(IntentAction || (IntentAction = {}));
-var IntentAction;
-
-// src/plugin-intent/errors.ts
-var BaseError = class extends Error {
-  constructor(code, message, context) {
-    super(message ?? code, {
-      cause: context
-    }), this.code = code, this.context = context;
-    this.name = code;
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-};
-var NoResolversError = class extends BaseError {
-  constructor(action) {
-    super("NO_RESOLVERS", "No resolvers were found for the action", {
-      action
-    });
-  }
-};
-var CycleDetectedError = class extends BaseError {
-  constructor(context) {
-    super("CYCLE_DETECTED", "Intent execution limit exceeded. This is likely due to an infinite loop within intent resolvers.", context);
-  }
-};
-
 // src/core/capabilities.ts
 import { Rx } from "@effect-rx/rx-react";
 import { Effect } from "effect";
@@ -114,6 +20,8 @@ var defineCapability = (identifier) => {
   };
 };
 var CapabilityImpl = class {
+  moduleId;
+  implementation;
   constructor(moduleId, implementation) {
     this.moduleId = moduleId;
     this.implementation = implementation;
@@ -131,31 +39,44 @@ var lazy = (c) => async (props) => {
   return async () => getCapability(props);
 };
 var PluginContext = class {
-  constructor({ registry, activate, reset }) {
-    this._capabilityImpls = Rx.family(() => {
-      return Rx.make([]).pipe(Rx.keepAlive);
-    });
-    this._capabilities = Rx.family((id) => {
-      return Rx.make((get) => {
-        const current = get(this._capabilityImpls(id));
-        return current.map((c) => c.implementation);
-      });
+  _registry;
+  _capabilityImpls = Rx.family(() => {
+    return Rx.make([]).pipe(Rx.keepAlive);
+  });
+  _capabilities = Rx.family((id) => {
+    return Rx.make((get) => {
+      const current = get(this._capabilityImpls(id));
+      return current.map((c) => c.implementation);
     });
-    this._capability = Rx.family((id) => {
-      return Rx.make((get) => {
-        const current = get(this._capabilities(id));
-        invariant(current.length > 0, `No capability found for ${id}`, {
-          F: __dxlog_file,
-          L: 117,
-          S: this,
-          A: [
-            "current.length > 0",
-            "`No capability found for ${id}`"
-          ]
-        });
-        return current[0];
+  });
+  _capability = Rx.family((id) => {
+    return Rx.make((get) => {
+      const current = get(this._capabilities(id));
+      invariant(current.length > 0, `No capability found for ${id}`, {
+        F: __dxlog_file,
+        L: 118,
+        S: this,
+        A: [
+          "current.length > 0",
+          "`No capability found for ${id}`"
+        ]
       });
+      return current[0];
     });
+  });
+  /**
+  * Activates plugins based on the activation event.
+  * @param event The activation event.
+  * @returns Whether the activation was successful.
+  */
+  activate;
+  /**
+  * Re-activates the modules that were activated by the event.
+  * @param event The activation event.
+  * @returns Whether the reset was successful.
+  */
+  reset;
+  constructor({ registry, activate, reset }) {
     this._registry = registry;
     this.activate = activate;
     this.reset = reset;
@@ -179,7 +100,7 @@ var PluginContext = class {
       count: current.length
     }, {
       F: __dxlog_file,
-      L: 161,
+      L: 162,
       S: this,
       C: (f, a) => f(...a)
     });
@@ -200,7 +121,7 @@ var PluginContext = class {
         count: current.length
       }, {
         F: __dxlog_file,
-        L: 180,
+        L: 181,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -209,7 +130,7 @@ var PluginContext = class {
         id: interfaceDef.identifier
       }, {
         F: __dxlog_file,
-        L: 182,
+        L: 183,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -301,7 +222,7 @@ var getEvents = (events) => "type" in events ? events.events : [
 // src/core/manager.ts
 import { Registry } from "@effect-rx/rx-react";
 import { untracked } from "@preact/signals-core";
-import { Array as A, Effect as Effect2, Either, Match, pipe } from "effect";
+import { Array, Duration, Effect as Effect2, Fiber, HashSet, Match, Ref, pipe } from "effect";
 import { Event } from "@dxos/async";
 import { live } from "@dxos/live-object";
 import { log as log2 } from "@dxos/log";
@@ -310,9 +231,17 @@ var isPromise = (value) => {
   return value !== null && typeof value === "object" && "then" in value;
 };
 var PluginManager = class {
+  activation = new Event();
+  context;
+  registry;
+  // TODO(wittjosiah): Replace with Rx.
+  _state;
+  _pluginLoader;
+  _capabilities = /* @__PURE__ */ new Map();
+  _moduleMemoMap = /* @__PURE__ */ new Map();
+  _activatingEvents = Effect2.runSync(Ref.make([]));
+  _activatingModules = Effect2.runSync(Ref.make([]));
   constructor({ pluginLoader, plugins = [], core = plugins.map(({ meta }) => meta.id), enabled = [], registry }) {
-    this.activation = new Event();
-    this._capabilities = /* @__PURE__ */ new Map();
     this.registry = registry ?? Registry.make();
     this.context = new PluginContext({
       registry: this.registry,
@@ -326,8 +255,8 @@ var PluginManager = class {
       enabled,
       modules: [],
       active: [],
-      pendingReset: [],
-      eventsFired: []
+      eventsFired: [],
+      pendingReset: []
     });
     plugins.forEach((plugin) => this._addPlugin(plugin));
     core.forEach((id) => this.enable(id));
@@ -399,7 +328,7 @@ var PluginManager = class {
         id
       }, {
         F: __dxlog_file2,
-        L: 154,
+        L: 157,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -418,7 +347,7 @@ var PluginManager = class {
         id
       }, {
         F: __dxlog_file2,
-        L: 167,
+        L: 170,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -439,7 +368,7 @@ var PluginManager = class {
         ]
       }, {
         F: __dxlog_file2,
-        L: 182,
+        L: 185,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -459,7 +388,7 @@ var PluginManager = class {
         id
       }, {
         F: __dxlog_file2,
-        L: 200,
+        L: 203,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -481,7 +410,7 @@ var PluginManager = class {
         id
       }, {
         F: __dxlog_file2,
-        L: 217,
+        L: 220,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -533,7 +462,7 @@ var PluginManager = class {
         id: plugin.meta.id
       }, {
         F: __dxlog_file2,
-        L: 270,
+        L: 273,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -548,7 +477,7 @@ var PluginManager = class {
         id
       }, {
         F: __dxlog_file2,
-        L: 279,
+        L: 283,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -564,7 +493,7 @@ var PluginManager = class {
         id: module.id
       }, {
         F: __dxlog_file2,
-        L: 289,
+        L: 293,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -579,7 +508,7 @@ var PluginManager = class {
         id
       }, {
         F: __dxlog_file2,
-        L: 298,
+        L: 303,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -607,13 +536,13 @@ var PluginManager = class {
   _setPendingResetByModule(module) {
     return untracked(() => {
       const activationEvents = getEvents(module.activatesOn).map(eventKey).filter((key) => this._state.eventsFired.includes(key));
-      const pendingReset = Array.from(new Set(activationEvents)).filter((event) => !this._state.pendingReset.includes(event));
+      const pendingReset = Array.fromIterable(new Set(activationEvents)).filter((event) => !this._state.pendingReset.includes(event));
       if (pendingReset.length > 0) {
         log2("pending reset", {
           events: pendingReset
         }, {
           F: __dxlog_file2,
-          L: 336,
+          L: 341,
           S: this,
           C: (f, a) => f(...a)
         });
@@ -625,35 +554,40 @@ var PluginManager = class {
   * @internal
   */
   // TODO(wittjosiah): Improve error typing.
-  _activate(event) {
+  _activate(event, params) {
     return Effect2.gen(this, function* () {
       const key = typeof event === "string" ? event : eventKey(event);
       log2("activating", {
-        key
+        key,
+        ...params
       }, {
         F: __dxlog_file2,
-        L: 349,
+        L: 357,
         S: this,
         C: (f, a) => f(...a)
       });
+      yield* Ref.update(this._activatingEvents, (activating) => Array.append(activating, key));
       const pendingIndex = this._state.pendingReset.findIndex((event2) => event2 === key);
       if (pendingIndex !== -1) {
         this._state.pendingReset.splice(pendingIndex, 1);
       }
+      const activatingEvents = yield* this._activatingEvents;
+      const activatingModules = yield* this._activatingModules;
       const modules = this._getInactiveModulesByEvent(key).filter((module) => {
         const allOf2 = isAllOf(module.activatesOn);
         if (!allOf2) {
           return true;
         }
         const events = module.activatesOn.events.filter((event2) => eventKey(event2) !== key);
-        return events.every((event2) => this._state.eventsFired.includes(eventKey(event2)));
+        return events.every((event2) => this._state.eventsFired.includes(eventKey(event2)) || activatingEvents.includes(eventKey(event2))) && !activatingModules.includes(module.id);
       });
+      yield* Ref.update(this._activatingModules, (activating) => Array.appendAll(activating, modules.map((module) => module.id)));
       if (modules.length === 0) {
         log2("no modules to activate", {
           key
         }, {
           F: __dxlog_file2,
-          L: 365,
+          L: 388,
           S: this,
           C: (f, a) => f(...a)
         });
@@ -667,7 +601,7 @@ var PluginManager = class {
         modules: modules.map((module) => module.id)
       }, {
         F: __dxlog_file2,
-        L: 372,
+        L: 395,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -675,29 +609,36 @@ var PluginManager = class {
         event: key,
         state: "activating"
       });
-      const getCapabilities = yield* Effect2.all(modules.map(({ activate }) => Effect2.tryPromise({
-        try: async () => activate(this.context),
-        catch: (error) => error
-      })), {
+      yield* pipe(modules, Array.flatMap((module) => module.activatesBefore ?? []), HashSet.fromIterable, HashSet.toValues, Array.filter((event2) => !activatingEvents.includes(eventKey(event2))), Array.map((event2) => this._activate(event2, {
+        before: key
+      })), Effect2.allWith({
         concurrency: "unbounded"
-      });
-      const result = yield* pipe(
-        modules,
-        A.zip(getCapabilities),
-        A.map(([module, getCapabilities2]) => this._activateModule(module, getCapabilities2)),
-        // TODO(wittjosiah): This currently can't be run in parallel.
-        //   Running this with concurrency causes races with `allOf` activation events.
-        Effect2.all,
-        Effect2.either
-      );
-      if (Either.isLeft(result)) {
+      }));
+      const getCapabilities = yield* pipe(modules, Array.map((mod) => this._loadModule(mod)), Effect2.allWith({
+        concurrency: "unbounded"
+      }), Effect2.catchAll((error) => {
         this.activation.emit({
           event: key,
           state: "error",
-          error: result.left
+          error
         });
-        yield* Effect2.fail(result.left);
-      }
+        return Effect2.fail(error);
+      }));
+      yield* pipe(
+        modules,
+        Array.zip(getCapabilities),
+        Array.map(([module, capabilities]) => this._contributeCapabilities(module, capabilities)),
+        // TODO(wittjosiah): This currently can't be run in parallel.
+        //   Running this with concurrency causes races with `allOf` activation events.
+        Effect2.all
+      );
+      yield* pipe(modules, Array.flatMap((module) => module.activatesAfter ?? []), HashSet.fromIterable, HashSet.toValues, Array.filter((event2) => !activatingEvents.includes(eventKey(event2))), Array.map((event2) => this._activate(event2, {
+        after: key
+      })), Effect2.allWith({
+        concurrency: "unbounded"
+      }));
+      yield* Ref.update(this._activatingEvents, (activating) => Array.filter(activating, (event2) => event2 !== key));
+      yield* Ref.update(this._activatingModules, (activating) => Array.filter(activating, (module) => !modules.map((module2) => module2.id).includes(module)));
       if (!this._state.eventsFired.includes(key)) {
         this._state.eventsFired.push(key);
       }
@@ -709,39 +650,76 @@ var PluginManager = class {
         key
       }, {
         F: __dxlog_file2,
-        L: 406,
+        L: 451,
         S: this,
         C: (f, a) => f(...a)
       });
       return true;
     });
   }
-  _activateModule(module, getCapabilities) {
+  // Memoized with _moduleMemoMap
+  _loadModule = (mod) => Effect2.tryPromise({
+    try: async () => {
+      const entry = this._moduleMemoMap.get(mod.id);
+      if (entry) {
+        return entry;
+      }
+      const promise = (async () => {
+        const start = performance.now();
+        let failed = false;
+        try {
+          log2("loading module", {
+            module: mod.id
+          }, {
+            F: __dxlog_file2,
+            L: 470,
+            S: this,
+            C: (f, a) => f(...a)
+          });
+          let activationResult = await mod.activate(this.context);
+          if (typeof activationResult === "function") {
+            activationResult = await activationResult();
+          }
+          return Array.isArray(activationResult) ? activationResult : [
+            activationResult
+          ];
+        } catch (error) {
+          failed = true;
+          throw error;
+        } finally {
+          performance.measure("activate-module", {
+            start,
+            end: performance.now(),
+            detail: {
+              module: mod.id
+            }
+          });
+          log2("loaded module", {
+            module: mod.id,
+            elapsed: performance.now() - start,
+            failed
+          }, {
+            F: __dxlog_file2,
+            L: 488,
+            S: this,
+            C: (f, a) => f(...a)
+          });
+        }
+      })();
+      this._moduleMemoMap.set(mod.id, promise);
+      return promise;
+    },
+    catch: (error) => error
+  }).pipe(Effect2.withSpan("PluginManager._loadModule"), together(Effect2.sleep(Duration.seconds(10)).pipe(Effect2.andThen(Effect2.sync(() => log2.warn(`module is taking a long time to activate`, {
+    module: mod.id
+  }, {
+    F: __dxlog_file2,
+    L: 499,
+    S: this,
+    C: (f, a) => f(...a)
+  }))))));
+  _contributeCapabilities(module, capabilities) {
     return Effect2.gen(this, function* () {
-      yield* Effect2.all(module.activatesBefore?.map((event) => this._activate(event)) ?? [], {
-        concurrency: "unbounded"
-      });
-      log2("activating module...", {
-        module: module.id
-      }, {
-        F: __dxlog_file2,
-        L: 421,
-        S: this,
-        C: (f, a) => f(...a)
-      });
-      const maybeCapabilities = typeof getCapabilities === "function" ? getCapabilities() : getCapabilities;
-      const resolvedCapabilities = yield* Match.value(maybeCapabilities).pipe(
-        // TODO(wittjosiah): Activate with an effect?
-        // Match.when(Effect.isEffect, (effect) => effect),
-        Match.when(isPromise, (promise) => Effect2.tryPromise({
-          try: () => promise,
-          catch: (error) => error
-        })),
-        Match.orElse((program) => Effect2.succeed(program))
-      );
-      const capabilities = Match.value(resolvedCapabilities).pipe(Match.when(Array.isArray, (array) => array), Match.orElse((value) => [
-        value
-      ]));
       capabilities.forEach((capability) => {
         this.context.contributeCapability({
           module: module.id,
@@ -750,17 +728,6 @@ var PluginManager = class {
       });
       this._state.active.push(module.id);
       this._capabilities.set(module.id, capabilities);
-      log2("activated module", {
-        module: module.id
-      }, {
-        F: __dxlog_file2,
-        L: 444,
-        S: this,
-        C: (f, a) => f(...a)
-      });
-      yield* Effect2.all(module.activatesAfter?.map((event) => this._activate(event)) ?? [], {
-        concurrency: "unbounded"
-      });
     });
   }
   _deactivate(id) {
@@ -783,10 +750,11 @@ var PluginManager = class {
         id
       }, {
         F: __dxlog_file2,
-        L: 471,
+        L: 533,
         S: this,
         C: (f, a) => f(...a)
       });
+      this._moduleMemoMap.delete(id);
       const capabilities = this._capabilities.get(id);
       if (capabilities) {
         for (const capability of capabilities) {
@@ -807,7 +775,7 @@ var PluginManager = class {
         id
       }, {
         F: __dxlog_file2,
-        L: 497,
+        L: 560,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -821,7 +789,7 @@ var PluginManager = class {
         key
       }, {
         F: __dxlog_file2,
-        L: 505,
+        L: 568,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -837,9 +805,20 @@ var PluginManager = class {
     });
   }
 };
+var together = (togetherEffect) => (effect) => Effect2.gen(function* () {
+  const togetherFiber = yield* Effect2.fork(togetherEffect);
+  const result = yield* effect;
+  yield* Fiber.interrupt(togetherFiber);
+  return result;
+});
 
 // src/core/plugin.ts
 var PluginModule = class {
+  id;
+  activatesOn;
+  activatesBefore;
+  activatesAfter;
+  activate;
   constructor(options) {
     this.id = options.id;
     this.activatesOn = options.activatesOn;
@@ -850,6 +829,8 @@ var PluginModule = class {
 };
 var defineModule = (options) => new PluginModule(options);
 var Plugin = class {
+  meta;
+  modules;
   constructor(meta, modules) {
     this.meta = meta;
     this.modules = modules;
@@ -861,8 +842,8 @@ var definePlugin = (meta, modules) => {
 
 // src/common/capabilities.ts
 (function(Capabilities2) {
-  Capabilities2.PluginManager = defineCapability("dxos.org/app-framework/capability/plugin-manager");
   Capabilities2.Null = defineCapability("dxos.org/app-framework/capability/null");
+  Capabilities2.PluginManager = defineCapability("dxos.org/app-framework/capability/plugin-manager");
   Capabilities2.RxRegistry = defineCapability("dxos.org/app-framework/capability/rx-registry");
   Capabilities2.ReactContext = defineCapability("dxos.org/app-framework/capability/react-context");
   Capabilities2.ReactRoot = defineCapability("dxos.org/app-framework/capability/react-root");
@@ -878,26 +859,29 @@ var definePlugin = (meta, modules) => {
   Capabilities2.Settings = defineCapability("dxos.org/app-framework/capability/settings");
   Capabilities2.Metadata = defineCapability("dxos.org/app-framework/capability/metadata");
   Capabilities2.Tools = defineCapability("dxos.org/app-framework/capability/tools");
-  Capabilities2.ArtifactDefinition = defineCapability("dxos.org/app-framework/capability/artifact-definition");
+  Capabilities2.Toolkit = defineCapability("dxos.org/app-framework/capability/ai-toolkit");
+  Capabilities2.ToolkitHandler = defineCapability("dxos.org/app-framework/capability/ai-toolkit-handler");
+  Capabilities2.BlueprintDefinition = defineCapability("dxos.org/app-framework/capability/blueprint-definition");
+  Capabilities2.Functions = defineCapability("dxos.org/app-framework/capability/functions");
   Capabilities2.FileUploader = defineCapability("dxos.org/app-framework/capability/file-uploader");
   Capabilities2.AnchorSort = defineCapability("dxos.org/app-framework/capability/anchor-sort");
 })(Capabilities || (Capabilities = {}));
 var Capabilities;
 
 // src/common/collaboration.ts
-import { Schema as Schema3 } from "effect";
-import { Expando, Ref } from "@dxos/echo-schema";
+import { Schema } from "effect";
+import { Expando, Ref as Ref2 } from "@dxos/echo-schema";
 (function(CollaborationActions2) {
-  class InsertContent extends Schema3.TaggedClass()("assistant/intent-content", {
-    input: Schema3.Struct({
+  class InsertContent extends Schema.TaggedClass()("assistant/intent-content", {
+    input: Schema.Struct({
       target: Expando,
-      object: Ref(Expando),
-      at: Schema3.optional(Schema3.String),
-      label: Schema3.String.pipe(Schema3.optional)
+      object: Ref2(Expando),
+      at: Schema.optional(Schema.String),
+      label: Schema.String.pipe(Schema.optional)
     }).annotations({
       description: "Enables plugins to inject content blocks or references into a related entity."
     }),
-    output: Schema3.Void
+    output: Schema.Void
   }) {
   }
   CollaborationActions2.InsertContent = InsertContent;
@@ -923,7 +907,7 @@ var CollaborationActions;
 var Events;
 
 // src/common/file.ts
-import { Schema as Schema4 } from "effect";
+import { Schema as Schema2 } from "effect";
 var defaultFileTypes = {
   images: [
     "png",
@@ -943,16 +927,87 @@ var defaultFileTypes = {
     "md"
   ]
 };
-var FileInfoSchema = Schema4.Struct({
-  name: Schema4.String,
-  type: Schema4.String,
-  url: Schema4.optional(Schema4.String),
-  cid: Schema4.optional(Schema4.String)
+var FileInfoSchema = Schema2.Struct({
+  name: Schema2.String,
+  type: Schema2.String,
+  url: Schema2.optional(Schema2.String),
+  cid: Schema2.optional(Schema2.String)
 });
 
 // src/common/layout.ts
 import { Schema as Schema5 } from "effect";
 
+// src/plugin-intent/actions.ts
+import { Schema as Schema4 } from "effect";
+
+// src/plugin-intent/intent.ts
+import { Schema as Schema3 } from "effect";
+var createIntent = (schema, data = {}, params = {}) => {
+  const _ = Schema3.validateSync(schema.fields.input)(data);
+  const intent = {
+    ...params,
+    _schema: schema,
+    id: schema._tag,
+    data
+  };
+  return {
+    first: intent,
+    last: intent,
+    all: [
+      intent
+    ]
+  };
+};
+var chain = (schema, data = {}, params = {}) => (intent) => {
+  const intents = "all" in intent ? intent.all : [
+    intent
+  ];
+  const first = intents[0];
+  const last = {
+    ...params,
+    _schema: schema,
+    id: schema._tag,
+    data
+  };
+  return {
+    first,
+    last,
+    all: [
+      ...intents,
+      last
+    ]
+  };
+};
+var Label = Schema3.Union(Schema3.String, Schema3.mutable(Schema3.Tuple(Schema3.String, Schema3.mutable(Schema3.Struct({
+  ns: Schema3.String,
+  count: Schema3.optional(Schema3.Number),
+  defaultValue: Schema3.optional(Schema3.String)
+})))));
+
+// src/plugin-intent/actions.ts
+var INTENT_PLUGIN = "dxos.org/plugin/intent";
+var INTENT_ACTION = `${INTENT_PLUGIN}/action`;
+(function(IntentAction2) {
+  class Track extends Schema4.TaggedClass()(`${INTENT_ACTION}/track`, {
+    input: Schema4.Struct({
+      intents: Schema4.Array(Schema4.String),
+      error: Schema4.optional(Schema4.String)
+    }),
+    output: Schema4.Void
+  }) {
+  }
+  IntentAction2.Track = Track;
+  class ShowUndo extends Schema4.TaggedClass()(`${INTENT_ACTION}/show-undo`, {
+    input: Schema4.Struct({
+      message: Label
+    }),
+    output: Schema4.Void
+  }) {
+  }
+  IntentAction2.ShowUndo = ShowUndo;
+})(IntentAction || (IntentAction = {}));
+var IntentAction;
+
 // src/plugin-intent/IntentPlugin.ts
 var IntentPlugin = () => definePlugin({
   id: INTENT_PLUGIN,
@@ -967,7 +1022,7 @@ var IntentPlugin = () => definePlugin({
     activatesAfter: [
       Events.DispatcherReady
     ],
-    activate: lazy(() => import("./intent-dispatcher-5PRM3KGH.mjs"))
+    activate: lazy(() => import("./intent-dispatcher-YQIQ55LJ.mjs"))
   })
 ]);
 
@@ -1326,6 +1381,31 @@ var Resource = Schema6.Record({
   value: ResourceLanguage
 });
 
+// src/plugin-intent/errors.ts
+var BaseError = class extends Error {
+  code;
+  context;
+  constructor(code, message, context) {
+    super(message ?? code, {
+      cause: context
+    }), this.code = code, this.context = context;
+    this.name = code;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var NoResolversError = class extends BaseError {
+  constructor(action) {
+    super("NO_RESOLVERS", "No resolvers were found for the action", {
+      action
+    });
+  }
+};
+var CycleDetectedError = class extends BaseError {
+  constructor(context) {
+    super("CYCLE_DETECTED", "Intent execution limit exceeded. This is likely due to an infinite loop within intent resolvers.", context);
+  }
+};
+
 // src/plugin-intent/intent-dispatcher.ts
 var __dxlog_file3 = "/__w/dxos/dxos/packages/sdk/app-framework/src/plugin-intent/intent-dispatcher.ts";
 var EXECUTION_LIMIT = 100;
@@ -1333,7 +1413,7 @@ var HISTORY_LIMIT = 100;
 var createResolver = (resolver) => resolver;
 var isUndoable = (historyEntry) => historyEntry.length > 0 && historyEntry.every(({ undoable }) => !!undoable);
 var createDispatcher = (getResolvers, { executionLimit = EXECUTION_LIMIT, historyLimit = HISTORY_LIMIT } = {}) => {
-  const historyRef = Effect3.runSync(Ref2.make([]));
+  const historyRef = Effect3.runSync(Ref3.make([]));
   const handleIntent = (intent) => Effect3.gen(function* () {
     const candidates = getResolvers().filter((resolver) => resolver.intent._tag === intent.id).filter((resolver) => !resolver.filter || resolver.filter(intent.data)).toSorted(byPosition);
     if (candidates.length === 0) {
@@ -1351,7 +1431,7 @@ var createDispatcher = (getResolvers, { executionLimit = EXECUTION_LIMIT, histor
       if (depth > executionLimit) {
         yield* Effect3.fail(new CycleDetectedError());
       }
-      const resultsRef = yield* Ref2.make([]);
+      const resultsRef = yield* Ref3.make([]);
       for (const intent of intentChain.all) {
         const { data: prev } = (yield* resultsRef.get)[0] ?? {};
         const result2 = yield* handleIntent({
@@ -1361,7 +1441,7 @@ var createDispatcher = (getResolvers, { executionLimit = EXECUTION_LIMIT, histor
             ...prev
           }
         });
-        yield* Ref2.update(resultsRef, (results2) => [
+        yield* Ref3.update(resultsRef, (results2) => [
           result2,
           ...results2
         ]);
@@ -1376,7 +1456,7 @@ var createDispatcher = (getResolvers, { executionLimit = EXECUTION_LIMIT, histor
       }
       const results = yield* resultsRef.get;
       const result = results[0];
-      yield* Ref2.update(historyRef, (history) => {
+      yield* Ref3.update(historyRef, (history) => {
         const next = [
           ...history,
           results
@@ -1400,7 +1480,7 @@ var createDispatcher = (getResolvers, { executionLimit = EXECUTION_LIMIT, histor
     })).catch((error) => {
       log3.catch(error, void 0, {
         F: __dxlog_file3,
-        L: 270,
+        L: 271,
         S: void 0,
         C: (f, a) => f(...a)
       });
@@ -1432,7 +1512,7 @@ var createDispatcher = (getResolvers, { executionLimit = EXECUTION_LIMIT, histor
           last: all.at(-1),
           all
         };
-        yield* Ref2.update(historyRef, (h) => h.filter((_, index) => index !== last));
+        yield* Ref3.update(historyRef, (h) => h.filter((_, index) => index !== last));
         return yield* dispatch(intent);
       }
     });
@@ -1517,4 +1597,4 @@ export {
   ResourceLanguage,
   Resource
 };
-//# sourceMappingURL=chunk-VSKRV3NW.mjs.map
+//# sourceMappingURL=chunk-YEN7NKTF.mjs.map