@dxos/plugin-space 0.8.1-main.ae460ac → 0.8.1-staging.391c573

package/dist/types/src/components/SyncStatus/Space.d.ts

@@ -1,12 +1,13 @@
+import React from 'react';
 import { type SpaceId } from '@dxos/react-client/echo';
 import { type PeerSyncState } from './sync-state';
 export declare const SYNC_STALLED_TIMEOUT = 5000;
 export type SpaceRowContainerProps = Omit<SpaceRowProps, 'spaceName'>;
-export declare const SpaceRowContainer: ({ spaceId, state }: SpaceRowContainerProps) => import("react/jsx-runtime").JSX.Element | null;
+export declare const SpaceRowContainer: ({ spaceId, state }: SpaceRowContainerProps) => React.JSX.Element | null;
 export type SpaceRowProps = {
     spaceId: SpaceId;
     spaceName: string;
     state: PeerSyncState;
 };
-export declare const SpaceRow: ({ spaceId, spaceName, state: { localDocumentCount, remoteDocumentCount, missingOnLocal, missingOnRemote }, }: SpaceRowProps) => import("react/jsx-runtime").JSX.Element;
+export declare const SpaceRow: ({ spaceId, spaceName, state: { localDocumentCount, remoteDocumentCount, missingOnLocal, missingOnRemote }, }: SpaceRowProps) => React.JSX.Element;
 //# sourceMappingURL=Space.d.ts.map

package/dist/types/src/components/SyncStatus/Space.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Space.d.ts","sourceRoot":"","sources":["../../../../../src/components/SyncStatus/Space.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,OAAO,EAAY,MAAM,yBAAyB,CAAC;AAKjE,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAIjE,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AA+B1C,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;AAEtE,eAAO,MAAM,iBAAiB,uBAAwB,sBAAsB,mDAW3E,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,aAAa,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,QAAQ,iHAIlB,aAAa,4CA8Bf,CAAC"}
+{"version":3,"file":"Space.d.ts","sourceRoot":"","sources":["../../../../../src/components/SyncStatus/Space.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAGxE,OAAO,EAAE,KAAK,OAAO,EAAY,MAAM,yBAAyB,CAAC;AAKjE,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAIjE,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AA+B1C,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;AAEtE,eAAO,MAAM,iBAAiB,uBAAwB,sBAAsB,6BAW3E,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,aAAa,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,QAAQ,iHAIlB,aAAa,sBA8Bf,CAAC"}

package/dist/types/src/components/SyncStatus/SyncStatus.d.ts

@@ -1,14 +1,15 @@
+import React from 'react';
 import { type ThemedClassName } from '@dxos/react-ui';
 import { type PeerSyncState, type SpaceSyncStateMap } from './sync-state';
-export declare const SyncStatus: () => import("react/jsx-runtime").JSX.Element;
+export declare const SyncStatus: () => React.JSX.Element;
 export declare const SyncStatusIndicator: ({ state, saved }: {
     state: SpaceSyncStateMap;
     saved: Boolean;
-}) => import("react/jsx-runtime").JSX.Element;
+}) => React.JSX.Element;
 export type SyncStatusDetailProps = ThemedClassName<{
     state: SpaceSyncStateMap;
     summary: PeerSyncState;
     debug?: boolean;
 }>;
-export declare const SyncStatusDetail: ({ classNames, state, summary, debug }: SyncStatusDetailProps) => import("react/jsx-runtime").JSX.Element;
+export declare const SyncStatusDetail: ({ classNames, state, summary, debug }: SyncStatusDetailProps) => React.JSX.Element;
 //# sourceMappingURL=SyncStatus.d.ts.map

package/dist/types/src/components/SyncStatus/SyncStatus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SyncStatus.d.ts","sourceRoot":"","sources":["../../../../../src/components/SyncStatus/SyncStatus.tsx"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAOtD,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAgC,MAAM,cAAc,CAAC;AAGxG,eAAO,MAAM,UAAU,+CAYtB,CAAC;AAEF,eAAO,MAAM,mBAAmB,qBAAsB;IAAE,KAAK,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,4CA0CjG,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,eAAe,CAAC;IAClD,KAAK,EAAE,iBAAiB,CAAC;IACzB,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC,CAAC;AAGH,eAAO,MAAM,gBAAgB,0CAA2C,qBAAqB,4CAmC5F,CAAC"}
+{"version":3,"file":"SyncStatus.d.ts","sourceRoot":"","sources":["../../../../../src/components/SyncStatus/SyncStatus.tsx"],"names":[],"mappings":"AAIA,OAAO,KAA2C,MAAM,OAAO,CAAC;AAMhE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAOtD,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAgC,MAAM,cAAc,CAAC;AAGxG,eAAO,MAAM,UAAU,yBAYtB,CAAC;AAEF,eAAO,MAAM,mBAAmB,qBAAsB;IAAE,KAAK,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,sBA0CjG,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,eAAe,CAAC;IAClD,KAAK,EAAE,iBAAiB,CAAC;IACzB,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC,CAAC;AAGH,eAAO,MAAM,gBAAgB,0CAA2C,qBAAqB,sBAmC5F,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-space",
-  "version": "0.8.1-main.ae460ac",
+  "version": "0.8.1-staging.391c573",
   "description": "DXOS Surface plugin for DXOS ECHO Spaces",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -34,44 +34,47 @@
   ],
   "dependencies": {
     "@preact/signals-core": "^1.6.0",
-    "effect": "^3.12.3",
+    "effect": "3.13.3",
     "jszip": "^3.10.1",
     "localforage": "^1.10.0",
     "lodash.get": "^4.4.2",
     "react-drag-drop-files": "^2.3.8",
     "react-is": "~18.2.0",
-    "@dxos/app-framework": "0.8.1-main.ae460ac",
-    "@dxos/async": "0.8.1-main.ae460ac",
-    "@dxos/automerge": "0.8.1-main.ae460ac",
-    "@dxos/context": "0.8.1-main.ae460ac",
-    "@dxos/display-name": "0.8.1-main.ae460ac",
-    "@dxos/echo-schema": "0.8.1-main.ae460ac",
-    "@dxos/client": "0.8.1-main.ae460ac",
-    "@dxos/echo-signals": "0.8.1-main.ae460ac",
-    "@dxos/invariant": "0.8.1-main.ae460ac",
-    "@dxos/keys": "0.8.1-main.ae460ac",
-    "@dxos/live-object": "0.8.1-main.ae460ac",
-    "@dxos/log": "0.8.1-main.ae460ac",
-    "@dxos/local-storage": "0.8.1-main.ae460ac",
-    "@dxos/plugin-attention": "0.8.1-main.ae460ac",
-    "@dxos/plugin-deck": "0.8.1-main.ae460ac",
-    "@dxos/plugin-graph": "0.8.1-main.ae460ac",
-    "@dxos/migrations": "0.8.1-main.ae460ac",
-    "@dxos/plugin-client": "0.8.1-main.ae460ac",
-    "@dxos/plugin-observability": "0.8.1-main.ae460ac",
-    "@dxos/plugin-status-bar": "0.8.1-main.ae460ac",
-    "@dxos/protocols": "0.8.1-main.ae460ac",
-    "@dxos/react-ui-attention": "0.8.1-main.ae460ac",
-    "@dxos/react-ui-editor": "0.8.1-main.ae460ac",
-    "@dxos/react-client": "0.8.1-main.ae460ac",
-    "@dxos/react-ui-form": "0.8.1-main.ae460ac",
-    "@dxos/react-ui-pickers": "0.8.1-main.ae460ac",
-    "@dxos/react-ui-searchlist": "0.8.1-main.ae460ac",
-    "@dxos/react-ui-stack": "0.8.1-main.ae460ac",
-    "@dxos/react-ui-syntax-highlighter": "0.8.1-main.ae460ac",
-    "@dxos/react-ui-tabs": "0.8.1-main.ae460ac",
-    "@dxos/shell": "0.8.1-main.ae460ac",
-    "@dxos/util": "0.8.1-main.ae460ac"
+    "@dxos/app-framework": "0.8.1-staging.391c573",
+    "@dxos/artifact": "0.8.1-staging.391c573",
+    "@dxos/async": "0.8.1-staging.391c573",
+    "@dxos/client": "0.8.1-staging.391c573",
+    "@dxos/display-name": "0.8.1-staging.391c573",
+    "@dxos/context": "0.8.1-staging.391c573",
+    "@dxos/automerge": "0.8.1-staging.391c573",
+    "@dxos/echo-schema": "0.8.1-staging.391c573",
+    "@dxos/echo-signals": "0.8.1-staging.391c573",
+    "@dxos/invariant": "0.8.1-staging.391c573",
+    "@dxos/keys": "0.8.1-staging.391c573",
+    "@dxos/live-object": "0.8.1-staging.391c573",
+    "@dxos/log": "0.8.1-staging.391c573",
+    "@dxos/local-storage": "0.8.1-staging.391c573",
+    "@dxos/plugin-attention": "0.8.1-staging.391c573",
+    "@dxos/migrations": "0.8.1-staging.391c573",
+    "@dxos/plugin-client": "0.8.1-staging.391c573",
+    "@dxos/plugin-observability": "0.8.1-staging.391c573",
+    "@dxos/plugin-graph": "0.8.1-staging.391c573",
+    "@dxos/plugin-status-bar": "0.8.1-staging.391c573",
+    "@dxos/plugin-deck": "0.8.1-staging.391c573",
+    "@dxos/protocols": "0.8.1-staging.391c573",
+    "@dxos/react-client": "0.8.1-staging.391c573",
+    "@dxos/react-ui-attention": "0.8.1-staging.391c573",
+    "@dxos/react-ui-editor": "0.8.1-staging.391c573",
+    "@dxos/react-ui-searchlist": "0.8.1-staging.391c573",
+    "@dxos/react-ui-pickers": "0.8.1-staging.391c573",
+    "@dxos/react-ui-form": "0.8.1-staging.391c573",
+    "@dxos/react-ui-stack": "0.8.1-staging.391c573",
+    "@dxos/react-ui-syntax-highlighter": "0.8.1-staging.391c573",
+    "@dxos/react-ui-tabs": "0.8.1-staging.391c573",
+    "@dxos/schema": "0.8.1-staging.391c573",
+    "@dxos/react-ui-theme": "0.8.1-staging.391c573",
+    "@dxos/util": "0.8.1-staging.391c573",
+    "@dxos/shell": "0.8.1-staging.391c573"
   },
   "devDependencies": {
     "@babel/core": "^7.18.13",
@@ -82,17 +85,17 @@
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
     "vite": "5.4.7",
-    "@dxos/random": "0.8.1-main.ae460ac",
-    "@dxos/react-ui": "0.8.1-main.ae460ac",
-    "@dxos/react-ui-theme": "0.8.1-main.ae460ac",
-    "@dxos/storybook-utils": "0.8.1-main.ae460ac"
+    "@dxos/random": "0.8.1-staging.391c573",
+    "@dxos/storybook-utils": "0.8.1-staging.391c573",
+    "@dxos/react-ui": "0.8.1-staging.391c573",
+    "@dxos/react-ui-theme": "0.8.1-staging.391c573"
   },
   "peerDependencies": {
     "@phosphor-icons/react": "^2.1.5",
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.8.1-main.ae460ac",
-    "@dxos/react-ui-theme": "0.8.1-main.ae460ac"
+    "@dxos/react-ui": "0.8.1-staging.391c573",
+    "@dxos/react-ui-theme": "0.8.1-staging.391c573"
   },
   "publishConfig": {
     "access": "public"

package/src/SpacePlugin.tsx

@@ -28,6 +28,7 @@ import {
   ReactRoot,
   ReactSurface,
   Schema,
+  Tools,
   SpaceCapabilities,
   SpaceSettings,
   SpacesReady,
@@ -178,5 +179,10 @@ export const SpacePlugin = ({
       ),
       activate: SpacesReady,
     }),
+    defineModule({
+      id: `${meta.id}/module/tools`,
+      activatesOn: Events.SetupArtifactDefinition,
+      activate: Tools,
+    }),
   ]);
 };

package/src/capabilities/index.ts

@@ -11,6 +11,7 @@ export const IntentResolver = lazy(() => import('./intent-resolver'));
 export const ReactRoot = lazy(() => import('./react-root'));
 export const ReactSurface = lazy(() => import('./react-surface'));
 export const Schema = lazy(() => import('./schema'));
+export const Tools = lazy(() => import('./schema-tools'));
 export const SpaceSettings = lazy(() => import('./settings'));
 export const SpaceState = lazy(() => import('./state'));
 export const SpacesReady = lazy(() => import('./spaces-ready'));

package/src/capabilities/schema-tool.test.ts

@@ -0,0 +1,45 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { describe, it, expect } from 'vitest';
+
+import { S } from '@dxos/echo-schema';
+
+import { TypeNameSchema } from './schema-tools';
+
+describe('TypeNameSchema format', () => {
+  const valid = [
+    'example.com/usCities',
+    'dxos.org/Contact',
+    'dxos.org/Table',
+    'dxos.org/Table/Contact',
+    'dxos.org/PluginName/TypeName',
+    // Case variations
+    'DXOS.org/Table',
+    'dxos.ORG/table',
+  ];
+
+  const invalid = [
+    'http://dxos.org/Table', // No protocol allowed
+    'dxos.org/', // Must have type path
+    // TODO(dmaretskyi): Decide if we want to ban numbers.
+    // 'dxos.org/1Type', // Path segments must start with letter
+    'dxos.org/Type!', // Invalid character
+    '.org/Type', // Must have domain
+  ];
+
+  const validate = S.validateSync(TypeNameSchema);
+
+  valid.forEach((typename) => {
+    it(`should accept valid typename: ${typename}`, () => {
+      expect(() => validate(typename)).not.toThrow();
+    });
+  });
+
+  invalid.forEach((typename) => {
+    it(`should reject invalid typename: ${typename}`, () => {
+      expect(() => validate(typename)).toThrow();
+    });
+  });
+});

package/src/capabilities/schema-tools.ts

@@ -0,0 +1,124 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { DescriptionAnnotationId, ExamplesAnnotationId, TitleAnnotationId } from 'effect/SchemaAST';
+
+import { Capabilities, contributes, type PromiseIntentDispatcher } from '@dxos/app-framework';
+import { defineTool, ToolResult } from '@dxos/artifact';
+import { type Space } from '@dxos/client/echo';
+import { FormatEnum, FormatEnums, S, SelectOptionSchema, GeoPoint, toJsonSchema } from '@dxos/echo-schema';
+import { invariant } from '@dxos/invariant';
+import { hues } from '@dxos/react-ui-theme';
+import { echoSchemaFromPropertyDefinitions } from '@dxos/schema';
+
+// TODO(burdon): Factor out.
+declare global {
+  interface ToolContextExtensions {
+    space?: Space;
+    dispatch?: PromiseIntentDispatcher;
+  }
+}
+
+// TODO(ZaymonFC): Move this somewhere common.
+export const TypeNameSchema = S.String.pipe(
+  S.pattern(/^\w+\.\w{2,}\/[\w/]+$/i),
+  S.annotations({
+    [TitleAnnotationId]: 'TypeName',
+    [DescriptionAnnotationId]:
+      'Domain-style type name path. Dashes are not allowed. Use camel case for the final component of the type name.',
+    [ExamplesAnnotationId]: ['example.com/type/Document', 'example.com/type/FlightList'],
+  }),
+);
+
+const formatDescription = `The format of the property. Additional information:
+  ${FormatEnum.GeoPoint}: ${JSON.stringify(toJsonSchema(GeoPoint))}
+  This tuple is GeoJSON. You must specify \`${FormatEnum.GeoPoint}\` as [Longitude, Latitude]`;
+
+// TODO(ZaymonFC): All properties are default optional, but maybe we should allow for required properties.
+const PropertyDefinitionSchema = S.Struct({
+  name: S.String.annotations({ [DescriptionAnnotationId]: 'The name of the property.' }),
+  format: S.Union(...FormatEnums.map((format) => S.Literal(format))).annotations({
+    [DescriptionAnnotationId]: formatDescription,
+  }),
+  config: S.optional(
+    S.Struct({
+      options: S.optional(
+        S.Array(SelectOptionSchema)
+          .annotations({
+            description: `Options for SingleSelect/MultiSelect formats. Available colors: ${hues.join(', ')}`,
+          })
+          .pipe(S.mutable),
+      ),
+    }),
+  ),
+}).pipe(S.mutable);
+
+const SYSTEM_NAMESPACE = 'dxos.org/echo/schema';
+
+export default () =>
+  contributes(Capabilities.Tools, [
+    defineTool(SYSTEM_NAMESPACE, {
+      name: 'list',
+      description: 'List registered schemas in the space.',
+      caption: 'Listing registered schemas...',
+      schema: S.Struct({}),
+      execute: async (_input, { extensions }) => {
+        invariant(extensions?.space, 'No space.');
+        const space = extensions.space;
+
+        const schemas = await space.db.schemaRegistry.query({}).run();
+        return ToolResult.Success(
+          schemas.map((schema) => ({
+            typename: schema.typename,
+            version: schema.version,
+          })),
+        );
+      },
+    }),
+    defineTool(SYSTEM_NAMESPACE, {
+      name: 'get',
+      description: 'Get a specific schema by its typename.',
+      caption: 'Getting schema...',
+      schema: S.Struct({
+        typename: S.String.annotations({
+          description: 'The fully qualified typename of the schema.',
+        }),
+      }),
+      execute: async ({ typename }, { extensions }) => {
+        invariant(extensions?.space, 'No space.');
+        const space = extensions.space;
+
+        const schema = await space.db.schemaRegistry.query({ typename }).firstOrUndefined();
+        if (!schema) {
+          return ToolResult.Error(`Schema not found: ${typename}`);
+        }
+
+        return ToolResult.Success(schema);
+      },
+    }),
+    defineTool(SYSTEM_NAMESPACE, {
+      name: 'create',
+      description: 'Create a new schema with the provided definition.',
+      caption: 'Creating schema...',
+      schema: S.Struct({
+        typename: TypeNameSchema.annotations({
+          description:
+            'The fully qualified schema typename. Must start with a domain, and then one or more path components (e.g., "example.com/type/TypeName").',
+        }),
+        properties: S.Array(PropertyDefinitionSchema).pipe(
+          S.annotations({ description: 'Array of property definitions for the schema.' }),
+          S.mutable,
+        ),
+      }),
+      execute: async ({ typename, properties }, { extensions }) => {
+        invariant(extensions?.space, 'No space.');
+        const space = extensions.space;
+
+        const schema = echoSchemaFromPropertyDefinitions(typename, properties);
+        const [registeredSchema] = await space.db.schemaRegistry.register([schema]);
+
+        return ToolResult.Success(registeredSchema);
+      },
+    }),
+  ]);