@dxos/app-framework 0.7.5-main.9d2a38b → 0.7.5-main.b19bfc8

package/dist/types/src/react/ErrorBoundary.d.ts

@@ -24,7 +24,7 @@ export declare class ErrorBoundary extends Component<Props, State> {
         error: Error;
     };
     componentDidUpdate(prevProps: Props): void;
-    render(): string | number | boolean | Iterable<React.ReactNode> | React.JSX.Element | null | undefined;
+    render(): string | number | boolean | Iterable<React.ReactNode> | import("react/jsx-runtime").JSX.Element | null | undefined;
     private resetError;
 }
 export {};

package/dist/types/src/{plugin-intent → react}/IntentContext.d.ts

@@ -1,5 +1,5 @@
 import { type Context, type Provider } from 'react';
-import { type AnyIntentResolver, type IntentContext } from './intent-dispatcher';
+import { type AnyIntentResolver, type IntentContext } from '../plugin-intent';
 declare const IntentContext: Context<IntentContext | undefined>;
 export declare const useIntentDispatcher: () => Pick<IntentContext, "dispatch" | "dispatchPromise">;
 export declare const useIntentResolver: (module: string, resolver: AnyIntentResolver) => void;

package/dist/types/src/react/IntentContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntentContext.d.ts","sourceRoot":"","sources":["../../../../src/react/IntentContext.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,OAAO,EAA6B,KAAK,QAAQ,EAAa,MAAM,OAAO,CAAC;AAO1F,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE9E,QAAA,MAAM,aAAa,EAAE,OAAO,CAAC,aAAa,GAAG,SAAS,CAAuD,CAAC;AAE9G,eAAO,MAAM,mBAAmB,QAAO,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,iBAAiB,CAGxF,CAAC;AAEF,eAAO,MAAM,iBAAiB,WAAY,MAAM,YAAY,iBAAiB,SAW5E,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,aAAa,GAAG,SAAS,CAA0B,CAAC"}

package/dist/types/src/react/Surface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Surface.d.ts","sourceRoot":"","sources":["../../../../src/react/Surface.tsx"],"names":[],"mappings":"AAIA,OAAO,KAA8C,MAAM,OAAO,CAAC;AAOnE,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACpF,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAgB9C;;GAEG;AACH,eAAO,MAAM,kBAAkB,YAAa,cAAc,kBAAkB,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,YAI9G,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,0HA+BnB,CAAC"}
+{"version":3,"file":"Surface.d.ts","sourceRoot":"","sources":["../../../../src/react/Surface.tsx"],"names":[],"mappings":"AAIA,OAAO,KAA8C,MAAM,OAAO,CAAC;AAOnE,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACpF,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAmB9C;;GAEG;AACH,eAAO,MAAM,kBAAkB,YAAa,cAAc,kBAAkB,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,YAI9G,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,0HA6BnB,CAAC"}

package/dist/types/src/react/Surface.stories.d.ts

@@ -0,0 +1,15 @@
+import '@dxos-theme';
+import { type PluginManager } from '../core';
+declare const _default: {
+    title: string;
+    render: ({ manager }: {
+        manager: PluginManager;
+    }) => import("react/jsx-runtime").JSX.Element;
+    decorators: import("@storybook/react").Decorator[];
+    args: {
+        manager: PluginManager;
+    };
+};
+export default _default;
+export declare const Default: {};
+//# sourceMappingURL=Surface.stories.d.ts.map

package/dist/types/src/react/Surface.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Surface.stories.d.ts","sourceRoot":"","sources":["../../../../src/react/Surface.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,aAAa,CAAC;AAWrB,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;;;0BAkErB;QAAE,OAAO,EAAE,aAAa,CAAA;KAAE;;;;;;AAFlD,wBAcE;AAEF,eAAO,MAAM,OAAO,IAAK,CAAC"}

package/dist/types/src/react/common.d.ts

@@ -0,0 +1,13 @@
+export declare const useIntentDispatcher: () => import("..").IntentContext;
+export declare const useAppGraph: () => Readonly<Pick<import("@dxos/app-graph").GraphBuilder, "graph" | "explore">>;
+export declare const useLayout: () => Readonly<{
+    mode: string;
+    dialogOpen: boolean;
+    sidebarOpen: boolean;
+    complementarySidebarOpen: boolean;
+    workspace: string;
+    active: string[];
+    inactive: string[];
+    scrollIntoView: string | undefined;
+}>;
+//# sourceMappingURL=common.d.ts.map

package/dist/types/src/react/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/react/common.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,mBAAmB,kCAAqD,CAAC;AAEtF,eAAO,MAAM,WAAW,mFAA6C,CAAC;AAEtE,eAAO,MAAM,SAAS;;;;;;;;;EAA2C,CAAC"}

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

@@ -1,5 +1,7 @@
+export * from './common';
 export * from './ErrorBoundary';
 export * from './PluginManagerProvider';
 export * from './Surface';
 export * from './useCapabilities';
+export * from './useIntentResolver';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/react/index.ts"],"names":[],"mappings":"AAIA,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/react/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/types/src/react/useCapabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCapabilities.d.ts","sourceRoot":"","sources":["../../../../src/react/useCapabilities.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,CAAC,SAAS,CAAC,oBAC9B,YAAY,CAAC,CAAC,CAAC,WACpB,CAAC,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,UAAU,IAAI,CAAC,QAQ9D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,SAAS,CAAC,oBAC5B,YAAY,CAAC,CAAC,CAAC,WACpB,CAAC,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,UAAU,IAAI,CAAC,MAK9D,CAAC"}
+{"version":3,"file":"useCapabilities.d.ts","sourceRoot":"","sources":["../../../../src/react/useCapabilities.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,CAAC,SAAS,CAAC,oBAC9B,YAAY,CAAC,CAAC,CAAC,WACpB,CAAC,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,UAAU,IAAI,CAAC,QAS9D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,SAAS,CAAC,oBAC5B,YAAY,CAAC,CAAC,CAAC,WACpB,CAAC,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,UAAU,IAAI,CAAC,MAK9D,CAAC"}

package/dist/types/src/react/useIntentResolver.d.ts

@@ -0,0 +1,3 @@
+import { type AnyIntentResolver } from '../plugin-intent';
+export declare const useIntentResolver: (module: string, resolver: AnyIntentResolver) => void;
+//# sourceMappingURL=useIntentResolver.d.ts.map

package/dist/types/src/react/useIntentResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIntentResolver.d.ts","sourceRoot":"","sources":["../../../../src/react/useIntentResolver.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,eAAO,MAAM,iBAAiB,WAAY,MAAM,YAAY,iBAAiB,SAW5E,CAAC"}

package/dist/types/src/testing/withPluginManager.d.ts

@@ -4,7 +4,7 @@ import { type AnyCapability } from '../core';
 /**
  * Wraps a story with a plugin manager.
  */
-export declare const withPluginManager: ({ capabilities, plugins, core, ...options }?: CreateAppOptions & {
+export declare const withPluginManager: (options?: CreateAppOptions & {
     capabilities?: AnyCapability[];
 }) => Decorator;
 //# sourceMappingURL=withPluginManager.d.ts.map

package/dist/types/src/testing/withPluginManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withPluginManager.d.ts","sourceRoot":"","sources":["../../../../src/testing/withPluginManager.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAKlD,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE1D,OAAO,EAAE,KAAK,aAAa,EAA0D,MAAM,SAAS,CAAC;AAErG;;GAEG;AACH,eAAO,MAAM,iBAAiB,iDAK3B,gBAAgB,GAAG;IAAE,YAAY,CAAC,EAAE,aAAa,EAAE,CAAA;CAAE,KAAQ,SAqC/D,CAAC"}
+{"version":3,"file":"withPluginManager.d.ts","sourceRoot":"","sources":["../../../../src/testing/withPluginManager.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAKlD,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE1D,OAAO,EAAE,KAAK,aAAa,EAA0D,MAAM,SAAS,CAAC;AA+BrG;;GAEG;AACH,eAAO,MAAM,iBAAiB,aAAa,gBAAgB,GAAG;IAAE,YAAY,CAAC,EAAE,aAAa,EAAE,CAAA;CAAE,KAAQ,SAqBvG,CAAC"}

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

@@ -0,0 +1,4 @@
+export * from './core';
+export * from './common';
+export * from './plugin-intent';
+//# sourceMappingURL=worker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/worker.ts"],"names":[],"mappings":"AAOA,cAAc,QAAQ,CAAC;AAEvB,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC"}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@dxos/app-framework",
-  "version": "0.7.5-main.9d2a38b",
+  "version": "0.7.5-main.b19bfc8",
   "description": "A framework for building applications from composible plugins.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
   "license": "MIT",
   "author": "DXOS.org",
   "sideEffects": true,
+  "type": "module",
   "exports": {
     ".": {
       "types": "./dist/types/src/index.d.ts",
@@ -17,6 +18,11 @@
       "types": "./dist/types/src/testing/index.d.ts",
       "browser": "./dist/lib/browser/testing/index.mjs",
       "node": "./dist/lib/node-esm/testing/index.mjs"
+    },
+    "./worker": {
+      "types": "./dist/types/src/worker.d.ts",
+      "browser": "./dist/lib/browser/worker.mjs",
+      "node": "./dist/lib/node-esm/worker.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
@@ -24,38 +30,40 @@
     "*": {
       "./testing": [
         "dist/types/src/testing/index.d.ts"
+      ],
+      "./worker": [
+        "dist/types/src/worker.d.ts"
       ]
     }
   },
   "dependencies": {
     "@effect/schema": "^0.75.5",
-    "@phosphor-icons/react": "^2.1.5",
     "@preact/signals-core": "^1.6.0",
-    "effect": "^3.12.1",
-    "zod": "^3.22.4",
-    "@dxos/async": "0.7.5-main.9d2a38b",
-    "@dxos/app-graph": "0.7.5-main.9d2a38b",
-    "@dxos/client-protocol": "0.7.5-main.9d2a38b",
-    "@dxos/context": "0.7.5-main.9d2a38b",
-    "@dxos/debug": "0.7.5-main.9d2a38b",
-    "@dxos/echo-schema": "0.7.5-main.9d2a38b",
-    "@dxos/live-object": "0.7.5-main.9d2a38b",
-    "@dxos/invariant": "0.7.5-main.9d2a38b",
-    "@dxos/local-storage": "0.7.5-main.9d2a38b",
-    "@dxos/react-hooks": "0.7.5-main.9d2a38b",
-    "@dxos/storybook-utils": "0.7.5-main.9d2a38b",
-    "@dxos/util": "0.7.5-main.9d2a38b",
-    "@dxos/log": "0.7.5-main.9d2a38b"
+    "effect": "^3.12.3",
+    "@dxos/app-graph": "0.7.5-main.b19bfc8",
+    "@dxos/artifact": "0.7.5-main.b19bfc8",
+    "@dxos/async": "0.7.5-main.b19bfc8",
+    "@dxos/debug": "0.7.5-main.b19bfc8",
+    "@dxos/client-protocol": "0.7.5-main.b19bfc8",
+    "@dxos/invariant": "0.7.5-main.b19bfc8",
+    "@dxos/live-object": "0.7.5-main.b19bfc8",
+    "@dxos/local-storage": "0.7.5-main.b19bfc8",
+    "@dxos/log": "0.7.5-main.b19bfc8",
+    "@dxos/react-hooks": "0.7.5-main.b19bfc8",
+    "@dxos/util": "0.7.5-main.b19bfc8"
   },
   "devDependencies": {
+    "@phosphor-icons/react": "^2.1.5",
     "@types/react": "~18.2.0",
     "react": "~18.2.0",
-    "@dxos/echo-signals": "0.7.5-main.9d2a38b",
-    "@dxos/react-ui": "0.7.5-main.9d2a38b",
-    "@dxos/react-ui-syntax-highlighter": "0.7.5-main.9d2a38b"
+    "@dxos/echo-schema": "0.7.5-main.b19bfc8",
+    "@dxos/echo-signals": "0.7.5-main.b19bfc8",
+    "@dxos/random": "0.7.5-main.b19bfc8",
+    "@dxos/react-ui-syntax-highlighter": "0.7.5-main.b19bfc8",
+    "@dxos/react-ui": "0.7.5-main.b19bfc8",
+    "@dxos/storybook-utils": "0.7.5-main.b19bfc8"
   },
   "peerDependencies": {
-    "@phosphor-icons/react": "^2.1.5",
     "react": "~18.2.0"
   },
   "publishConfig": {

package/project.json

@@ -12,15 +12,16 @@
       "options": {
         "entryPoints": [
           "{projectRoot}/src/index.ts",
-          "{projectRoot}/src/testing/index.ts"
+          "{projectRoot}/src/testing/index.ts",
+          "{projectRoot}/src/worker.ts"
         ]
       }
     },
     "lint": {},
+    "pack": {},
     "test": {}
   },
   "implicitDependencies": [
-    "esbuild",
-    "node-std"
+    "esbuild"
   ]
 }

package/src/App.tsx

@@ -11,7 +11,7 @@ import { create } from '@dxos/live-object';
 import { Capabilities, Events } from './common';
 import { PluginManager, type PluginManagerOptions, type Plugin } from './core';
 import { topologicalSort } from './helpers';
-import { ErrorBoundary, PluginManagerProvider } from './react';
+import { ErrorBoundary, PluginManagerProvider, useCapabilities } from './react';
 
 const ENABLED_KEY = 'dxos.org/app-framework/enabled';
 
@@ -75,7 +75,8 @@ export const createApp = ({
   const manager = pluginManager ?? new PluginManager({ pluginLoader, plugins, core, enabled });
 
   manager.activation.on(({ event, state: _state, error }) => {
-    if (event === Events.Startup.id) {
+    // Once the app is ready the first time, don't show the fallback again.
+    if (!state.ready && event === Events.Startup.id) {
       state.ready = _state === 'activated';
     }
 
@@ -96,21 +97,27 @@ export const createApp = ({
 
   setupDevtools(manager);
 
+  // TODO(wittjosiah): Factor out such that this could be called per surface role when attempting to render.
+  void manager.activate(Events.SetupReactSurface);
   void manager.activate(Events.Startup);
 
   return () => (
     <ErrorBoundary fallback={fallback}>
-      <App placeholder={placeholder} manager={manager} state={state} />
+      <PluginManagerProvider value={manager}>
+        <App placeholder={placeholder} state={state} />
+      </PluginManagerProvider>
     </ErrorBoundary>
   );
 };
 
 type AppProps = Required<Pick<CreateAppOptions, 'placeholder'>> & {
-  manager: PluginManager;
   state: { ready: boolean; error: unknown };
 };
 
-const App = ({ placeholder, manager, state }: AppProps) => {
+const App = ({ placeholder, state }: AppProps) => {
+  const reactContexts = useCapabilities(Capabilities.ReactContext);
+  const reactRoots = useCapabilities(Capabilities.ReactRoot);
+
   if (state.error) {
     // This trigger the error boundary to provide UI feedback for the startup error.
     throw state.error;
@@ -121,18 +128,13 @@ const App = ({ placeholder, manager, state }: AppProps) => {
     return <>{placeholder}</>;
   }
 
-  const reactContexts = manager.context.requestCapabilities(Capabilities.ReactContext);
-  const reactRoots = manager.context.requestCapabilities(Capabilities.ReactRoot);
-
   const ComposedContext = composeContexts(reactContexts);
   return (
-    <PluginManagerProvider value={manager}>
-      <ComposedContext>
-        {reactRoots.map(({ id, root: Component }) => (
-          <Component key={id} />
-        ))}
-      </ComposedContext>
-    </PluginManagerProvider>
+    <ComposedContext>
+      {reactRoots.map(({ id, root: Component }) => (
+        <Component key={id} />
+      ))}
+    </ComposedContext>
   );
 };
 

package/src/common/capabilities.ts

@@ -2,18 +2,16 @@
 // Copyright 2025 DXOS.org
 //
 
+import { type Schema as S } from '@effect/schema';
 import { type FC, type PropsWithChildren } from 'react';
 
 import { type GraphBuilder } from '@dxos/app-graph';
+import { type ArtifactDefinition, type Tool } from '@dxos/artifact';
 import { type Space } from '@dxos/client-protocol';
-import { type S } from '@dxos/echo-schema';
 import { type RootSettingsStore } from '@dxos/local-storage';
-import { type DeepReadonly } from '@dxos/util';
 
 import { type FileInfo } from './file';
 import { type NodeSerializer } from './graph';
-import { type Layout } from './layout';
-import { type LayoutParts } from './navigation';
 import { type SurfaceDefinition } from './surface';
 import { type Resource } from './translations';
 import { defineCapability, type PluginManager } from '../core';
@@ -40,13 +38,29 @@ export namespace Capabilities {
     'dxos.org/app-framework/capability/intent-dispatcher',
   );
 
-  export const Layout = defineCapability<Readonly<Layout>>('dxos.org/app-framework/capability/layout');
-  export const MutableLayout = defineCapability<Layout>('dxos.org/app-framework/capability/layout');
-
-  export type MutableLocation = { active: LayoutParts; closed: string[] };
-  export type Location = DeepReadonly<MutableLocation>;
-  export const Location = defineCapability<Location>('dxos.org/app-framework/capability/location');
-  export const MutableLocation = defineCapability<MutableLocation>('dxos.org/app-framework/capability/location');
+  export type Layout = Readonly<{
+    mode: string;
+    dialogOpen: boolean;
+    sidebarOpen: boolean;
+    complementarySidebarOpen: boolean;
+    /**
+     * The id of the active workspace, where a workspace is a set of active items.
+     */
+    workspace: string;
+    /**
+     * Identifiers of items which are currently active in the application.
+     */
+    active: string[];
+    /**
+     * Identifiers of items which were previously active in the application.
+     */
+    inactive: string[];
+    /**
+     * Identifier of the item which should be scrolled into view.
+     */
+    scrollIntoView: string | undefined;
+  }>;
+  export const Layout = defineCapability<Layout>('dxos.org/app-framework/capability/layout');
 
   export const Translations = defineCapability<Readonly<Resource[]>>('dxos.org/app-framework/capability/translations');
 
@@ -77,6 +91,11 @@ export namespace Capabilities {
   export type Metadata = Readonly<{ id: string; metadata: Record<string, any> }>;
   export const Metadata = defineCapability<Metadata>('dxos.org/app-framework/capability/metadata');
 
+  export const Tools = defineCapability<Tool[]>('dxos.org/app-framework/capability/tools');
+  export const ArtifactDefinition = defineCapability<ArtifactDefinition>(
+    'dxos.org/app-framework/capability/artifact-definition',
+  );
+
   export type FileUploader = (file: File, space: Space) => Promise<FileInfo | undefined>;
   export const FileUploader = defineCapability<FileUploader>('dxos.org/app-framework/capability/file-uploader');
 }

package/src/common/events.ts

@@ -15,10 +15,20 @@ export namespace Events {
   // Dependent Events
   //
 
+  /**
+   * Fired to load any newly available surfaces.
+   */
+  export const SetupReactSurface = defineEvent('dxos.org/app-framework/event/setup-react-surface');
+
+  /**
+   * Fired to load any newly available metadata.
+   */
+  export const SetupMetadata = defineEvent('dxos.org/app-framework/event/setup-metadata');
+
   /**
    * Fired before the intent dispatcher is activated.
    */
-  export const SetupIntents = defineEvent('dxos.org/app-framework/event/setup-intents');
+  export const SetupIntentResolver = defineEvent('dxos.org/app-framework/event/setup-intent-resolver');
 
   /**
    * Fired before the settings store is activated.
@@ -35,6 +45,11 @@ export namespace Events {
    */
   export const SetupTranslations = defineEvent('dxos.org/app-framework/event/setup-translations');
 
+  /**
+   * Fired to load any newly available artifacts definitions.
+   */
+  export const SetupArtifactDefinition = defineEvent('dxos.org/app-framework/event/setup-artifact-definition');
+
   //
   // Triggered Events
   //
@@ -59,5 +74,4 @@ export namespace Events {
    */
   export const createStateEvent = (specifier: string) => defineEvent('dxos.org/app-framework/event/state', specifier);
   export const LayoutReady = createStateEvent(Capabilities.Layout.identifier);
-  export const LocationReady = createStateEvent(Capabilities.Location.identifier);
 }

package/src/common/file.ts

@@ -2,7 +2,7 @@
 // Copyright 2024 DXOS.org
 //
 
-import { S } from '@dxos/echo-schema';
+import { Schema as S } from '@effect/schema';
 
 // TODO(burdon): See Accept attribute (uses MIME types).
 // E.g., 'image/*': ['.jpg', '.jpeg', '.png', '.gif'],

package/src/common/graph.ts

@@ -3,7 +3,7 @@
 //
 
 import type { Node } from '@dxos/app-graph';
-import { type MaybePromise } from '@dxos/util';
+import { type MaybePromise, type Position } from '@dxos/util';
 
 // TODO(wittjosiah): Factor out.
 export type SerializedNode = {
@@ -16,7 +16,7 @@ export type SerializedNode = {
 export type NodeSerializer<T = any> = {
   inputType: string;
   outputType: string;
-  disposition?: 'hoist' | 'fallback';
+  position?: Position;
 
   /**
    * Takes a node and serializes it into a format that can be stored.

package/src/common/index.ts

@@ -7,6 +7,5 @@ export * from './events';
 export * from './file';
 export * from './graph';
 export * from './layout';
-export * from './navigation';
 export * from './surface';
 export * from './translations';