@dxos/plugin-space 0.8.4-main.72ec0f3 → 0.8.4-main.8360d9e660

package/src/helpers/query.ts

@@ -10,15 +10,15 @@ import * as Option from 'effect/Option';
 import type * as Schema from 'effect/Schema';
 import * as SchemaAST from 'effect/SchemaAST';
 
-import { DXN, Filter, Query, type QueryAST } from '@dxos/echo';
+import { DXN, Filter, Key, Query, type QueryAST, type SchemaRegistry } from '@dxos/echo';
 import {
   ReferenceAnnotationId,
   type ReferenceAnnotationValue,
   getTypeAnnotation,
   unwrapOptional,
 } from '@dxos/echo/internal';
+import { runAndForwardErrors } from '@dxos/effect';
 import { log } from '@dxos/log';
-import { type Client } from '@dxos/react-client';
 import { type Space } from '@dxos/react-client/echo';
 import { Person } from '@dxos/types';
 
@@ -35,26 +35,21 @@ export const evalQuery = (queryString: string): Query.Any => {
   }
 };
 
-export const resolveSchemaWithClientAndSpace = (client: Client, space: Space, query: QueryAST.Query) => {
+export const resolveSchemaWithRegistry = (registry: SchemaRegistry.SchemaRegistry, query: QueryAST.Query) => {
   const resolve = Effect.fn(function* (dxn: string) {
     const typename = DXN.parse(dxn).asTypeDXN()?.type;
     if (!typename) {
       return Option.none();
     }
 
-    const staticSchema = client.graph.schemaRegistry.getSchema(typename);
-    if (staticSchema) {
-      return Option.some(staticSchema);
-    }
-
-    const query = space.db.schemaRegistry.query({ typename });
+    const query = registry.query({ typename, location: ['database', 'runtime'] });
     const schemas = yield* Effect.promise(() => query.run());
-    return Array.head(schemas).pipe(Option.map((schema) => schema.snapshot));
+    return Array.head(schemas);
   });
 
   return resolveSchema(query, resolve).pipe(
     Effect.map((schema) => Option.getOrUndefined(schema)),
-    Effect.runPromise,
+    runAndForwardErrors,
   );
 };
 
@@ -142,17 +137,30 @@ const typenameFromFilter = (filter: QueryAST.Filter): Option.Option<string> =>
     Match.orElse(() => Option.none()),
   );
 
-// TODO(wittjosiah): Currently assumes options is at the top-level of the ast.
+// TODO(wittjosiah): Currently assumes from scope is at the top-level of the ast.
 export const getQueryTarget = (query: QueryAST.Query, space?: Space) => {
   return Match.value(query).pipe(
-    Match.when({ type: 'options' }, ({ options }) => {
-      return Option.fromNullable(options.queues).pipe(
+    Match.when({ type: 'from' }, ({ from }) => {
+      if (from._tag !== 'scope') {
+        return space?.db;
+      }
+      const result = Option.fromNullable(from.scope.queues).pipe(
         Option.flatMap((queues) => Array.head(queues)),
-        Option.flatMap((queueDxn) => Option.fromNullable(DXN.tryParse(queueDxn))),
-        Option.flatMap((queueDxn) => Option.fromNullable(space?.queues.get(queueDxn))),
-        Option.getOrElse(() => space),
+        Option.flatMap((queueDxn) => Option.fromNullable(DXN.tryParse(String(queueDxn)))),
+        Option.flatMap((parsed) => {
+          const q = parsed.asQueueDXN();
+          if (!q || !Key.ObjectId.isValid(q.queueId)) return Option.none();
+          return Option.fromNullable(space?.queues.get(parsed));
+        }),
       );
+      // Skip query when a requested queue is not found (structurally invalid DXN or valid DXN
+      // referencing a queue not present in space.queues, e.g. not yet synced) to avoid 400 errors.
+      // TODO(wittjosiah): Can we handle this upstream?
+      if (from.scope.queues?.length && Option.isNone(result)) {
+        return undefined;
+      }
+      return Option.getOrElse(result, () => space?.db);
     }),
-    Match.orElse(() => space),
+    Match.orElse(() => space?.db),
   );
 };

package/src/hooks/useActiveSpace.ts

@@ -2,20 +2,23 @@
 // Copyright 2025 DXOS.org
 //
 
-import { Capabilities, type PluginContext } from '@dxos/app-framework';
-import { useLayout } from '@dxos/app-framework/react';
+import { Capabilities, type CapabilityManager } from '@dxos/app-framework';
+import { AppCapabilities, getSpaceIdFromPath } from '@dxos/app-toolkit';
+import { useLayout } from '@dxos/app-toolkit/ui';
 import { ClientCapabilities } from '@dxos/plugin-client';
-import { parseId, useSpace } from '@dxos/react-client/echo';
+import { useSpace } from '@dxos/react-client/echo';
 
-export const getActiveSpace = (context: PluginContext) => {
-  const client = context.getCapability(ClientCapabilities.Client);
-  const layout = context.getCapability(Capabilities.Layout);
-  const { spaceId } = parseId(layout.workspace);
+export const getActiveSpace = (capabilities: CapabilityManager.CapabilityManager) => {
+  const client = capabilities.get(ClientCapabilities.Client);
+  const registry = capabilities.get(Capabilities.AtomRegistry);
+  const layoutAtom = capabilities.get(AppCapabilities.Layout);
+  const layout = registry.get(layoutAtom);
+  const spaceId = getSpaceIdFromPath(layout.workspace);
   return spaceId ? client.spaces.get(spaceId) : undefined;
 };
 
 export const useActiveSpace = () => {
   const layout = useLayout();
-  const { spaceId } = parseId(layout.workspace);
+  const spaceId = getSpaceIdFromPath(layout.workspace);
   return useSpace(spaceId);
 };

package/src/hooks/useInputSurfaceLookup.tsx

@@ -2,34 +2,25 @@
 // Copyright 2025 DXOS.org
 //
 
-import type * as Schema from 'effect/Schema';
 import React, { useCallback } from 'react';
 
-import { Surface, isSurfaceAvailable, usePluginManager } from '@dxos/app-framework/react';
-import { type InputProps } from '@dxos/react-ui-form';
+import { Surface, usePluginManager } from '@dxos/app-framework/ui';
+import { type FormFieldProvider } from '@dxos/react-ui-form';
 
-// TODO(ZaymonFC): Move this if you find yourself needing it elsewhere.
 /**
  * Creates a surface input component based on plugin context.
  * @param baseData Additional data that will be merged with form data and passed to the surface.
  * This allows providing more context to the surface than what's available from the form itself.
  */
-export const useInputSurfaceLookup = (baseData?: Record<string, any>) => {
+// TODO(burdon): Factor out?
+export const useInputSurfaceLookup = (baseData?: Record<string, any>): FormFieldProvider => {
   const pluginManager = usePluginManager();
-
-  return useCallback(
-    ({ prop, schema, inputProps }: { prop: string; schema: Schema.Schema<any>; inputProps: InputProps }) => {
-      const composedData = { prop, schema, ...baseData };
-      if (
-        !isSurfaceAvailable(pluginManager.context, {
-          role: 'form-input',
-          data: composedData,
-        })
-      ) {
-        return undefined;
+  return useCallback<FormFieldProvider>(
+    ({ schema, prop, fieldProps }) => {
+      const data = { prop, schema, ...baseData };
+      if (Surface.isAvailable(pluginManager.capabilities, { role: 'form-input', data })) {
+        return <Surface.Surface role='form-input' data={data} {...fieldProps} />;
       }
-
-      return <Surface role='form-input' data={composedData} {...inputProps} />;
     },
     [pluginManager, baseData],
   );

package/src/hooks/usePath.ts

@@ -5,7 +5,7 @@
 import * as Option from 'effect/Option';
 import { useEffect, useState } from 'react';
 
-import { type ReadableGraph } from '@dxos/plugin-graph';
+import { Graph } from '@dxos/plugin-graph';
 
 /**
  * React hook to get a path from the graph.
@@ -16,9 +16,9 @@ import { type ReadableGraph } from '@dxos/plugin-graph';
  * @returns Path if found, undefined otherwise.
  */
 // TODO(wittjosiah): Factor out.
-export const usePath = (graph: ReadableGraph, id?: string, timeout?: number): Option.Option<string[]> => {
+export const usePath = (graph: Graph.ReadableGraph, id?: string, timeout?: number): Option.Option<string[]> => {
   const [pathState, setPathState] = useState<Option.Option<string[]>>(
-    id ? graph.getPath({ target: id }) : Option.none(),
+    id ? Graph.getPath(graph, { target: id }) : Option.none(),
   );
 
   useEffect(() => {
@@ -33,7 +33,7 @@ export const usePath = (graph: ReadableGraph, id?: string, timeout?: number): Op
     // Set timeout did not seem to effectively not block the UI thread.
     const frame = requestAnimationFrame(async () => {
       try {
-        const path = await graph.waitForPath({ target: id }, { timeout });
+        const path = await Graph.waitForPath(graph, { target: id }, { timeout });
         if (path) {
           setPathState(Option.some(path));
         }

package/src/hooks/useTypeOptions.ts

@@ -4,48 +4,14 @@
 
 import { useMemo } from 'react';
 
-import { useCapabilities } from '@dxos/app-framework/react';
-import { Type } from '@dxos/echo';
-import { ClientCapabilities } from '@dxos/plugin-client';
-import { useClient } from '@dxos/react-client';
 import { type Space } from '@dxos/react-client/echo';
 import { useTranslation } from '@dxos/react-ui';
-import { Collection, type TypenameAnnotation, getTypenames } from '@dxos/schema';
 
-import { SpaceCapabilities } from '../capabilities';
+import { type TypeInputOptions, getTypenames } from '../types';
 
-const OMIT = [Collection.Collection.typename, Type.getTypename(Collection.QueryCollection)];
-
-export const useTypeOptions = ({ space, annotation }: { space?: Space; annotation: TypenameAnnotation[] }) => {
+export const useTypeOptions = ({ space, annotation }: { space?: Space; annotation: TypeInputOptions }) => {
   const { t } = useTranslation();
-  const client = useClient();
-
-  const schemaWhitelists = useCapabilities(ClientCapabilities.SchemaWhiteList);
-  const whitelistedTypenames = useMemo(
-    () => new Set(schemaWhitelists.flatMap((typeArray) => typeArray.map((type) => Type.getTypename(type)))),
-    [schemaWhitelists],
-  );
-
-  const objectForms = useCapabilities(SpaceCapabilities.ObjectForm);
-  const objectFormTypenames = useMemo(
-    () =>
-      new Set(
-        objectForms
-          .map((form) => Type.getTypename(form.objectSchema))
-          // TODO(wittjosiah): Remove.
-          .filter((typename) => !OMIT.includes(typename) && !typename.endsWith('View')),
-      ),
-    [objectForms],
-  );
-
-  const typenames = getTypenames({
-    annotation,
-    whitelistedTypenames,
-    objectFormTypenames,
-    space,
-    client,
-  });
-
+  const typenames = getTypenames({ annotation, space });
   return useMemo(
     () =>
       typenames

package/src/index.ts

@@ -2,12 +2,12 @@
 // Copyright 2023 DXOS.org
 //
 
-export { SpaceCapabilities } from './capabilities';
-export { SpaceEvents } from './events';
+export { SpaceCapabilities, SpaceEvents } from './types';
 
 export * from './components';
 export * from './helpers';
 export * from './hooks';
 export * from './meta';
-export * from './SpacePlugin';
 export * from './util';
+
+export * from './SpacePlugin';

package/src/meta.ts

@@ -2,11 +2,11 @@
 // Copyright 2023 DXOS.org
 //
 
-import { type PluginMeta } from '@dxos/app-framework';
+import { type Plugin } from '@dxos/app-framework';
 import { trim } from '@dxos/util';
 
-export const meta: PluginMeta = {
-  id: 'dxos.org/plugin/space',
+export const meta: Plugin.Meta = {
+  id: 'org.dxos.plugin.space',
   name: 'Spaces',
   description: trim`
     Core workspace container system for organizing and sharing collaborative environments.

package/src/translations.ts

@@ -3,10 +3,9 @@
 //
 
 import { Type } from '@dxos/echo';
-import { StoredSchema } from '@dxos/echo/internal';
+import { Collection } from '@dxos/echo';
 import { type Resource } from '@dxos/react-ui';
-import { Collection, View } from '@dxos/schema';
-import { Event, Organization, Person, Project, Task } from '@dxos/types';
+import { Event, Message, Organization, Person, Pipeline, Task } from '@dxos/types';
 
 import { meta } from './meta';
 
@@ -20,35 +19,21 @@ export const translations = [
         'typename label_one': 'Collection',
         'typename label_other': 'Collections',
         'object name placeholder': 'New collection',
+        'add object label': 'Add collection',
         'rename object label': 'Rename collection',
         'delete object label': 'Delete collection',
+        'object deleted label': 'Collection deleted',
       },
-      [Type.getTypename(Collection.QueryCollection)]: {
-        'typename label': 'Smart Collection',
-        'typename label_zero': 'Smart Collections',
-        'typename label_one': 'Smart Collection',
-        'typename label_other': 'Smart Collections',
-        'object name placeholder': 'New smart collection',
-        'rename object label': 'Rename smart collection',
-        'delete object label': 'Delete smart collection',
-      },
-      [StoredSchema.typename]: {
-        'typename label': 'Record',
-        'typename label_zero': 'Records',
-        'typename label_one': 'Record',
-        'typename label_other': 'Records',
-        'object name placeholder': 'New record type',
-        'rename object label': 'Rename record type',
-        'delete object label': 'Delete record type',
-      },
-      [Type.getTypename(View.View)]: {
-        'typename label': 'View',
-        'typename label_zero': 'Views',
-        'typename label_one': 'View',
-        'typename label_other': 'Views',
-        'object name placeholder': 'New view',
-        'rename object label': 'Rename view',
-        'delete object label': 'Delete view',
+      [Type.getTypename(Type.PersistentType)]: {
+        'typename label': 'Type',
+        'typename label_zero': 'Types',
+        'typename label_one': 'Type',
+        'typename label_other': 'Types',
+        'object name placeholder': 'New type',
+        'add object label': 'Add type',
+        'rename object label': 'Rename type',
+        'delete object label': 'Delete type',
+        'object deleted label': 'Type deleted',
       },
       [Event.Event.typename]: {
         'typename label': 'Event',
@@ -56,6 +41,19 @@ export const translations = [
         'typename label_one': 'Event',
         'typename label_other': 'Events',
         'object name placeholder': 'New event',
+        'add object label': 'Add event',
+        'rename object label': 'Rename event',
+        'delete object label': 'Delete event',
+      },
+      [Message.Message.typename]: {
+        'typename label': 'Message',
+        'typename label_zero': 'Messages',
+        'typename label_one': 'Message',
+        'typename label_other': 'Messages',
+        'object name placeholder': 'New message',
+        'add object label': 'Add message',
+        'rename object label': 'Rename message',
+        'delete object label': 'Delete message',
       },
       [Organization.Organization.typename]: {
         'typename label': 'Organization',
@@ -63,6 +61,9 @@ export const translations = [
         'typename label_one': 'Organization',
         'typename label_other': 'Organizations',
         'object name placeholder': 'New organization',
+        'add object label': 'Add organization',
+        'rename object label': 'Rename organization',
+        'delete object label': 'Delete organization',
       },
       [Person.Person.typename]: {
         'typename label': 'Person',
@@ -70,13 +71,19 @@ export const translations = [
         'typename label_one': 'Person',
         'typename label_other': 'People',
         'object name placeholder': 'New person',
+        'add object label': 'Add person',
+        'rename object label': 'Rename person',
+        'delete object label': 'Delete person',
       },
-      [Project.Project.typename]: {
+      [Pipeline.Pipeline.typename]: {
         'typename label': 'Project',
         'typename label_zero': 'Projects',
         'typename label_one': 'Project',
         'typename label_other': 'Projects',
         'object name placeholder': 'New project',
+        'add object label': 'Add project',
+        'rename object label': 'Rename project',
+        'delete object label': 'Delete project',
       },
       [Task.Task.typename]: {
         'typename label': 'Task',
@@ -84,6 +91,9 @@ export const translations = [
         'typename label_one': 'Task',
         'typename label_other': 'Tasks',
         'object name placeholder': 'New task',
+        'add object label': 'Add task',
+        'rename object label': 'Rename task',
+        'delete object label': 'Delete task',
       },
       [meta.id]: {
         'plugin name': 'Spaces',
@@ -100,7 +110,7 @@ export const translations = [
         'rename space label': 'Rename space',
         'active space label': 'Active space:',
         'space name label': 'Space name',
-        'object name label': 'Item name',
+        'object name label': 'Object name',
         'close space label': 'Close space',
         'open space label': 'Open space',
         'export data label': 'Export data',
@@ -118,32 +128,33 @@ export const translations = [
         'spaces label': 'Spaces',
         'space settings label': 'Spaces',
         'space settings description':
-          'Each space has its own settings you can configure, where you can adjust its properties, membership, integrations, and other items specific to that space.',
+          'Each space has its own settings you can configure, where you can adjust its properties, membership, integrations, and other objects specific to that space.',
         'show hidden spaces label': 'Show archived spaces',
         'save files to directory label': 'Save files to disk',
         'select path label': 'Select path',
+        'snapshot by schema label': 'Snapshot of objects',
         'rename collection label': 'Rename collection',
-        'rename object label': 'Rename item',
-        'duplicate object label': 'Duplicate item',
-        'delete collection label': 'Delete collection',
-        'delete object label': 'Delete item',
-        'collection deleted label': 'Collection deleted',
-        'object deleted label': 'Item deleted',
-        'objects deleted label': 'Items deleted',
-        'go to object label': 'Open item',
+        'rename object label': 'Rename object',
+        'duplicate object label': 'Duplicate object',
+        'object deleted label': 'Object deleted',
+        'objects deleted label': 'Objects deleted',
+        'go to object label': 'Open object',
         'found object label': 'Ready.',
-        'found object description': 'The requested item is now available.',
+        'found object description': 'The requested object is now available.',
         'waiting for object label': 'Loading…',
-        'waiting for object description': 'The requested item is still being synchronized.',
+        'waiting for object description': 'The requested object is still being synchronized.',
         'object not found label': 'Nothing found.',
         'object not found description':
-          'The requested item has not been found yet. Ensure there are enough peers online in the space with an updated copy.',
-        'missing object message': 'Item not available.',
+          'The requested object has not been found yet. Ensure there are enough peers online in the space with an updated copy.',
+        'missing object message': 'Object not available.',
         'missing object description':
-          'The requested item has not been found yet. Ensure there are enough peers online in the space with an updated copy.',
+          'The requested object has not been found yet. Ensure there are enough peers online in the space with an updated copy.',
         'create object in space label': 'Add to space',
         'create object in collection label': 'Add to collection',
-        'create object in smart collection label': 'Add to smart collection',
+        'remove from collection label': 'Remove from collection',
+        'create object in system collection label': 'Add to system collection',
+        'new type label': 'New type',
+        'add view to schema label': 'Add view for type',
         'space members label': 'Space members',
         'active space members heading': 'Online ({{count}})',
         'inactive space members heading': 'Offline ({{count}})',
@@ -161,10 +172,10 @@ export const translations = [
         'location label': 'Located in',
         'space limit label': 'Space Limit Reached',
         'space limit description':
-          'This space has reached the maximum number of items for the beta. This limit includes deleted items currently, but those can be permanently removed with the cleanup action.',
+          'This space has reached the maximum number of objects for the beta. This limit includes deleted objects currently, but those can be permanently removed with the cleanup action.',
         'space limit close label': 'Close',
         'remove deleted objects label': 'Cleanup',
-        'remove deleted objects alt': 'Permanently remove deleted items to free up space.',
+        'remove deleted objects alt': 'Permanently remove deleted objects to free up space.',
         'copy link label': 'Copy link',
         'default on space create label': 'On space create',
         'sync status title': 'Sync status',
@@ -181,11 +192,11 @@ export const translations = [
         'remote synced label': 'Synced with peers',
         'syncing label': 'Space syncing',
         'show all label': 'Show all',
-        'no sync status label': 'No space with missing items.',
+        'no sync status label': 'No space with missing objects.',
         'create space dialog title': 'Create Space',
         'create object dialog title': 'Create {{object}}',
         'space input placeholder': 'Select space',
-        'schema input placeholder': 'Select item type',
+        'schema input placeholder': 'Select type',
         'creating object type label': 'Type',
         'creating in space label': 'Location',
         'creating in collection label': 'In Collection',
@@ -196,7 +207,7 @@ export const translations = [
         'foreign keys': 'Foreign Keys',
         'add key': 'Add Key',
         'open space settings label': 'Open settings',
-        'related objects label': 'Related Items',
+        'related objects label': 'Related Objects',
 
         'row details no selection label': 'No objects selected',
         'companion selected objects label': 'Selected',
@@ -218,10 +229,10 @@ export const translations = [
         'space settings properties label': 'General settings',
         'space properties settings verbose label': 'Manage space properties',
         'space properties settings description': 'You can configure how this space is displayed in the app here.',
-        'space settings schema label': 'Record types',
-        'schema verbose label': 'Manage record types',
-        'schema description': 'You can manage all of the record types stored within this space here.',
-        'no schemas found message': 'No record types found',
+        'space settings schema label': 'Types',
+        'schema verbose label': 'Manage types',
+        'schema description': 'You can manage all of the types stored within this space here.',
+        'no schemas found message': 'No types found',
         'display name input placeholder': 'Space name',
         'display name description': 'Name of the space as it appears in the app.',
         'icon description': 'Icon used to represent the space in the app.',
@@ -231,11 +242,17 @@ export const translations = [
         'archive space description':
           'Archiving a space will remove it from the sidebar and stop replicating updates, but will not delete the data. You can unarchive it by enabling archived spaces in the app settings.',
         'archive space label': 'Archive',
-        'backup space label': 'Backup',
+        'unarchive space label': 'Unarchive',
+
+        'space controls title': 'Space Controls',
+        'space controls description': 'Advanced controls for this space.',
+        'backup space title': 'Backup Space',
         'backup space description':
           'Download a backup of the space. Contains all data in the space in an unencrypted format.',
-        'download backup': 'Download backup',
-        'unarchive space label': 'Unarchive',
+        'download backup label': 'Download backup',
+        'repair space title': 'Repair Space',
+        'repair space description': 'Run repair operations on the space.',
+        'repair space label': 'Run repairs',
 
         'sync edge connected label': 'Edge connected',
         'sync edge disconnected label': 'Edge disconnected',
@@ -243,6 +260,12 @@ export const translations = [
         'sync latency label': 'Latency',
         'sync upload label': 'Upload',
         'sync download label': 'Download',
+
+        'types section label': 'Types',
+        'collections section label': 'Collections',
+        'type collection all label': 'All',
+
+        'search placeholder': 'Search…',
       },
     },
   },

package/src/types/capabilities.ts

@@ -0,0 +1,73 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { type Atom } from '@effect-atom/atom-react';
+import type * as Effect from 'effect/Effect';
+import * as Schema from 'effect/Schema';
+
+import { Capability } from '@dxos/app-framework';
+import { type Space } from '@dxos/client/echo';
+import { type Database } from '@dxos/echo';
+import { type Collection } from '@dxos/echo';
+import { type PublicKey } from '@dxos/keys';
+import { type Operation } from '@dxos/operation';
+import { type Label } from '@dxos/ui-types';
+import { type ComplexMap, type Position } from '@dxos/util';
+
+import { meta } from '../meta';
+
+import { type ObjectViewerProps, type SpaceSettingsProps } from './types';
+
+export namespace SpaceCapabilities {
+  export const Settings = Capability.make<Atom.Writable<SpaceSettingsProps>>(`${meta.id}.capability.settings`);
+
+  /** Schema for persisted space plugin state. */
+  export const StateSchema = Schema.mutable(
+    Schema.Struct({
+      spaceNames: Schema.Record({ key: Schema.String, value: Schema.String }),
+      enabledEdgeReplication: Schema.Boolean,
+    }),
+  );
+
+  export type SpaceState = Schema.Schema.Type<typeof StateSchema>;
+
+  /** Persisted state (stored in KVS/localStorage). */
+  export const State = Capability.make<Atom.Writable<SpaceState>>(`${meta.id}.capability.state`);
+
+  /** Ephemeral space plugin state (not persisted). */
+  export type SpaceEphemeralState = {
+    awaiting: string | undefined;
+    sdkMigrationRunning: Record<string, boolean>;
+    navigableCollections: boolean;
+    viewersByObject: Record<string, ComplexMap<PublicKey, ObjectViewerProps>>;
+    viewersByIdentity: ComplexMap<PublicKey, Set<string>>;
+  };
+
+  /** Transient/ephemeral state (not persisted). */
+  export const EphemeralState = Capability.make<Atom.Writable<SpaceEphemeralState>>(
+    `${meta.id}.capability.ephemeral-state`,
+  );
+
+  export type SettingsSection = { id: string; label: Label; position?: Position };
+  export const SettingsSection = Capability.make<SettingsSection>(`${meta.id}.capability.settings-section`);
+
+  export type OnCreateSpace = (params: {
+    space: Space;
+    isDefault: boolean;
+    rootCollection: Collection.Collection;
+  }) => Effect.Effect<void, Error, Operation.Service>;
+  export const OnCreateSpace = Capability.make<OnCreateSpace>(`${meta.id}.capability.on-space-created`);
+
+  export type OnSchemaAdded = (params: {
+    db: Database.Database;
+    schema: Schema.Schema.AnyNoContext;
+    // TODO(wittjosiah): This is leaky.
+    show?: boolean;
+  }) => Effect.Effect<void, Error, Operation.Service>;
+  export const OnSchemaAdded = Capability.make<OnSchemaAdded>(`${meta.id}.capability.on-schema-added`);
+
+  // TODO(wittjosiah): Replace with migrations, this is not a sustainable solution.
+  export type HandleRepair = (params: { space: Space; isDefault: boolean }) => Promise<void>;
+  export const Repair = Capability.make<HandleRepair>(`${meta.id}.capability.repair`);
+}

package/src/types/events.ts

@@ -0,0 +1,16 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { ActivationEvent } from '@dxos/app-framework';
+import { AppActivationEvents } from '@dxos/app-toolkit';
+
+import { meta } from '../meta';
+
+export namespace SpaceEvents {
+  export const StateReady = AppActivationEvents.createStateEvent(`${meta.id}.event.state-ready`);
+  export const SetupSettingsPanel = ActivationEvent.make(`${meta.id}.event.setup-settings-panel`);
+  export const DefaultSpaceReady = ActivationEvent.make(`${meta.id}.event.default-space-ready`);
+  export const SpaceCreated = ActivationEvent.make(`${meta.id}.event.space-created`);
+  export const SchemaAdded = ActivationEvent.make(`${meta.id}.event.schema-added`);
+}