@dxos/plugin-chess 0.8.4-main.3c1ae3b → 0.8.4-main.3eb6e50203

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "@dxos/plugin-chess",
-  "version": "0.8.4-main.3c1ae3b",
+  "version": "0.8.4-main.3eb6e50203",
   "description": "Chess for new plugin",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dxos/dxos"
+  },
   "license": "MIT",
   "author": "DXOS.org",
   "sideEffects": true,
@@ -15,17 +19,23 @@
       "browser": "./dist/lib/browser/index.mjs",
       "node": "./dist/lib/node-esm/index.mjs"
     },
+    "./blueprints": {
+      "source": "./src/blueprints/index.ts",
+      "types": "./dist/types/src/blueprints/index.d.ts",
+      "browser": "./dist/lib/browser/blueprints/index.mjs",
+      "node": "./dist/lib/node-esm/blueprints/index.mjs"
+    },
+    "./cli": {
+      "source": "./src/cli/index.ts",
+      "types": "./dist/types/src/cli/index.d.ts",
+      "browser": "./dist/lib/browser/cli/index.mjs",
+      "node": "./dist/lib/node-esm/cli/index.mjs"
+    },
     "./types": {
       "source": "./src/types/index.ts",
       "types": "./dist/types/src/types/index.d.ts",
       "browser": "./dist/lib/browser/types/index.mjs",
       "node": "./dist/lib/node-esm/types/index.mjs"
-    },
-    "./functions": {
-      "source": "./src/functions/index.ts",
-      "types": "./dist/types/src/functions/index.d.ts",
-      "browser": "./dist/lib/browser/functions/index.mjs",
-      "node": "./dist/lib/node-esm/functions/index.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
@@ -41,47 +51,53 @@
     "src"
   ],
   "dependencies": {
-    "@preact-signals/safe-react": "^0.9.0",
-    "@preact/signals-core": "^1.12.1",
+    "@automerge/automerge": "3.2.3",
+    "@effect-atom/atom-react": "^0.5.0",
     "chess.js": "^1.0.0",
-    "effect": "3.18.3",
-    "@dxos/ai": "0.8.4-main.3c1ae3b",
-    "@dxos/assistant": "0.8.4-main.3c1ae3b",
-    "@dxos/blueprints": "0.8.4-main.3c1ae3b",
-    "@dxos/async": "0.8.4-main.3c1ae3b",
-    "@dxos/echo": "0.8.4-main.3c1ae3b",
-    "@dxos/app-framework": "0.8.4-main.3c1ae3b",
-    "@dxos/invariant": "0.8.4-main.3c1ae3b",
-    "@dxos/functions": "0.8.4-main.3c1ae3b",
-    "@dxos/display-name": "0.8.4-main.3c1ae3b",
-    "@dxos/live-object": "0.8.4-main.3c1ae3b",
-    "@dxos/plugin-client": "0.8.4-main.3c1ae3b",
-    "@dxos/log": "0.8.4-main.3c1ae3b",
-    "@dxos/plugin-graph": "0.8.4-main.3c1ae3b",
-    "@dxos/plugin-space": "0.8.4-main.3c1ae3b",
-    "@dxos/react-client": "0.8.4-main.3c1ae3b",
-    "@dxos/react-ui-gameboard": "0.8.4-main.3c1ae3b",
-    "@dxos/react-ui-sfx": "0.8.4-main.3c1ae3b",
-    "@dxos/react-ui-stack": "0.8.4-main.3c1ae3b",
-    "@dxos/schema": "0.8.4-main.3c1ae3b",
-    "@dxos/util": "0.8.4-main.3c1ae3b"
+    "effect": "3.19.16",
+    "@dxos/ai": "0.8.4-main.3eb6e50203",
+    "@dxos/app-framework": "0.8.4-main.3eb6e50203",
+    "@dxos/app-toolkit": "0.8.4-main.3eb6e50203",
+    "@dxos/assistant": "0.8.4-main.3eb6e50203",
+    "@dxos/async": "0.8.4-main.3eb6e50203",
+    "@dxos/blueprints": "0.8.4-main.3eb6e50203",
+    "@dxos/display-name": "0.8.4-main.3eb6e50203",
+    "@dxos/echo-db": "0.8.4-main.3eb6e50203",
+    "@dxos/echo-react": "0.8.4-main.3eb6e50203",
+    "@dxos/functions": "0.8.4-main.3eb6e50203",
+    "@dxos/echo": "0.8.4-main.3eb6e50203",
+    "@dxos/invariant": "0.8.4-main.3eb6e50203",
+    "@dxos/log": "0.8.4-main.3eb6e50203",
+    "@dxos/operation": "0.8.4-main.3eb6e50203",
+    "@dxos/plugin-client": "0.8.4-main.3eb6e50203",
+    "@dxos/plugin-graph": "0.8.4-main.3eb6e50203",
+    "@dxos/plugin-markdown": "0.8.4-main.3eb6e50203",
+    "@dxos/react-client": "0.8.4-main.3eb6e50203",
+    "@dxos/plugin-space": "0.8.4-main.3eb6e50203",
+    "@dxos/react-ui-gameboard": "0.8.4-main.3eb6e50203",
+    "@dxos/react-ui-mosaic": "0.8.4-main.3eb6e50203",
+    "@dxos/react-ui-sfx": "0.8.4-main.3eb6e50203",
+    "@dxos/react-ui-stack": "0.8.4-main.3eb6e50203",
+    "@dxos/schema": "0.8.4-main.3eb6e50203",
+    "@dxos/types": "0.8.4-main.3eb6e50203",
+    "@dxos/util": "0.8.4-main.3eb6e50203"
   },
   "devDependencies": {
-    "@types/react": "~19.2.2",
-    "@types/react-dom": "~19.2.2",
-    "react": "~19.2.0",
-    "react-dom": "~19.2.0",
+    "@types/react": "~19.2.7",
+    "@types/react-dom": "~19.2.3",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
     "vite": "7.1.9",
-    "@dxos/plugin-theme": "0.8.4-main.3c1ae3b",
-    "@dxos/react-ui": "0.8.4-main.3c1ae3b",
-    "@dxos/react-ui-theme": "0.8.4-main.3c1ae3b",
-    "@dxos/storybook-utils": "0.8.4-main.3c1ae3b"
+    "@dxos/plugin-theme": "0.8.4-main.3eb6e50203",
+    "@dxos/storybook-utils": "0.8.4-main.3eb6e50203",
+    "@dxos/ui-theme": "0.8.4-main.3eb6e50203",
+    "@dxos/react-ui": "0.8.4-main.3eb6e50203"
   },
   "peerDependencies": {
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "@dxos/react-ui": "0.8.4-main.3c1ae3b",
-    "@dxos/react-ui-theme": "0.8.4-main.3c1ae3b"
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "@dxos/react-ui": "0.8.4-main.3eb6e50203",
+    "@dxos/ui-theme": "0.8.4-main.3eb6e50203"
   },
   "publishConfig": {
     "access": "public"

package/src/ChessPlugin.tsx

@@ -2,54 +2,34 @@
 // Copyright 2023 DXOS.org
 //
 
-import { Capabilities, Events, contributes, createIntent, defineModule, definePlugin } from '@dxos/app-framework';
-import { ClientCapabilities, ClientEvents } from '@dxos/plugin-client';
-import { type CreateObjectIntent } from '@dxos/plugin-space/types';
+import * as Effect from 'effect/Effect';
 
-import { BlueprintDefinition, CHESS_BLUEPRINT_KEY, IntentResolver, ReactSurface } from './capabilities';
+import { Plugin } from '@dxos/app-framework';
+import { AppPlugin } from '@dxos/app-toolkit';
+import { type CreateObject } from '@dxos/plugin-space/types';
+
+import { ChessBlueprint } from './blueprints';
+import { BlueprintDefinition, ReactSurface } from './capabilities';
 import { meta } from './meta';
 import { translations } from './translations';
-import { Chess, ChessAction } from './types';
+import { Chess } from './types';
 
-export const ChessPlugin = definePlugin(meta, () => [
-  defineModule({
-    id: `${meta.id}/module/translations`,
-    activatesOn: Events.SetupTranslations,
-    activate: () => contributes(Capabilities.Translations, translations),
-  }),
-  defineModule({
-    id: `${meta.id}/module/metadata`,
-    activatesOn: Events.SetupMetadata,
-    activate: () =>
-      contributes(Capabilities.Metadata, {
-        id: Chess.Game.typename,
-        metadata: {
-          icon: 'ph--shield-chevron--regular',
-          iconHue: 'amber',
-          blueprints: [CHESS_BLUEPRINT_KEY],
-          createObjectIntent: (() => createIntent(ChessAction.Create)) satisfies CreateObjectIntent,
-          addToCollectionOnCreate: true,
-        },
-      }),
-  }),
-  defineModule({
-    id: `${meta.id}/module/schema`,
-    activatesOn: ClientEvents.SetupSchema,
-    activate: () => contributes(ClientCapabilities.Schema, [Chess.Game]),
-  }),
-  defineModule({
-    id: `${meta.id}/module/react-surface`,
-    activatesOn: Events.SetupReactSurface,
-    activate: ReactSurface,
-  }),
-  defineModule({
-    id: `${meta.id}/module/intent-resolver`,
-    activatesOn: Events.SetupIntentResolver,
-    activate: IntentResolver,
-  }),
-  defineModule({
-    id: `${meta.id}/module/blueprint`,
-    activatesOn: Events.SetupArtifactDefinition,
-    activate: BlueprintDefinition,
+export const ChessPlugin = Plugin.define(meta).pipe(
+  AppPlugin.addBlueprintDefinitionModule({ activate: BlueprintDefinition }),
+  AppPlugin.addMetadataModule({
+    metadata: {
+      id: Chess.Game.typename,
+      metadata: {
+        icon: 'ph--shield-chevron--regular',
+        iconHue: 'amber',
+        blueprints: [ChessBlueprint.Key],
+        createObject: ((props) => Effect.sync(() => Chess.make(props))) satisfies CreateObject,
+        addToCollectionOnCreate: true,
+      },
+    },
   }),
-]);
+  AppPlugin.addSchemaModule({ schema: [Chess.Game] }),
+  AppPlugin.addSurfaceModule({ activate: ReactSurface }),
+  AppPlugin.addTranslationsModule({ translations }),
+  Plugin.make,
+);

package/src/blueprints/chess-blueprint.ts

@@ -0,0 +1,28 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Blueprint, Template } from '@dxos/blueprints';
+import { type FunctionDefinition } from '@dxos/functions';
+import { trim } from '@dxos/util';
+
+import { create, move, play, print } from './functions';
+
+export const Key = 'dxos.org/blueprint/chess';
+
+export const functions: FunctionDefinition[] = [create, move, play, print];
+
+export const make = () =>
+  Blueprint.make({
+    key: Key,
+    name: 'Chess',
+    tools: Blueprint.toolDefinitions({ functions }),
+    instructions: Template.make({
+      source: trim`
+        You are an expert chess player.
+        To analyze a game you can access the "pgn" property by loading the context object that represents the current game.
+        You could suggest a good next move or offer to play a move.
+        Don't actually make a move unless you are asked to.
+      `,
+    }),
+  });

package/src/{functions → blueprints/functions}/create.ts

@@ -8,13 +8,18 @@ import * as Schema from 'effect/Schema';
 import { Database } from '@dxos/echo';
 import { defineFunction } from '@dxos/functions';
 
-import { Chess } from '../types';
+import { Chess } from '../../types';
 
 export default defineFunction({
   key: 'dxos.org/function/chess/create',
   name: 'Create Chess',
   description: 'Creates a new chess game.',
   inputSchema: Schema.Struct({
+    name: Schema.optional(
+      Schema.String.annotations({
+        description: 'Name of the game.',
+      }),
+    ),
     pgn: Schema.optional(
       Schema.String.annotations({
         description: 'Portable Game Notation.',
@@ -27,7 +32,7 @@ export default defineFunction({
     ),
   }),
   outputSchema: Chess.Game,
-  handler: Effect.fn(function* ({ data: { pgn, fen } }) {
-    return yield* Database.Service.add(Chess.makeGame({ pgn, fen }));
+  handler: Effect.fn(function* ({ data: { name, pgn, fen } }) {
+    return yield* Database.add(Chess.make({ name, pgn, fen }));
   }),
 });

package/src/{functions → blueprints/functions}/index.ts

@@ -5,3 +5,4 @@
 export { default as create } from './create';
 export { default as move } from './move';
 export { default as play } from './play';
+export { default as print } from './print';

package/src/{functions → blueprints/functions}/move.ts

@@ -6,18 +6,17 @@ import { Chess as ChessJS } from 'chess.js';
 import * as Effect from 'effect/Effect';
 import * as Schema from 'effect/Schema';
 
-import { ArtifactId } from '@dxos/assistant';
-import { Database } from '@dxos/echo';
+import { Database, Obj, Type } from '@dxos/echo';
 import { defineFunction } from '@dxos/functions';
 
-import { Chess } from '../types';
+import { Chess } from '../../types';
 
 export default defineFunction({
   key: 'dxos.org/function/chess/move',
   name: 'Move',
   description: 'Makes a move in the given chess game.',
   inputSchema: Schema.Struct({
-    id: ArtifactId.annotations({
+    game: Type.Ref(Chess.Game).annotations({
       description: 'The ID of the chess object.',
     }),
     move: Schema.String.annotations({
@@ -30,8 +29,8 @@ export default defineFunction({
       description: 'The PGN of the game after the move was played.',
     }),
   }),
-  handler: Effect.fn(function* ({ data: { id, move } }) {
-    const object = yield* Database.Service.resolve(ArtifactId.toDXN(id), Chess.Game);
+  handler: Effect.fn(function* ({ data: { game, move } }) {
+    const object = yield* Database.load(game);
     const chess = new ChessJS();
     if (object.pgn) {
       chess.loadPgn(object.pgn);
@@ -40,7 +39,10 @@ export default defineFunction({
     }
 
     chess.move(move, { strict: false });
-    object.pgn = chess.pgn();
-    return { pgn: object.pgn };
+    const pgn = chess.pgn();
+    Obj.change(object, (o) => {
+      o.pgn = pgn;
+    });
+    return { pgn };
   }),
 });

package/src/{functions → blueprints/functions}/play.ts

@@ -6,18 +6,17 @@ import { Chess as ChessJS } from 'chess.js';
 import * as Effect from 'effect/Effect';
 import * as Schema from 'effect/Schema';
 
-import { ArtifactId } from '@dxos/assistant';
-import { Database } from '@dxos/echo';
+import { Database, Obj, Type } from '@dxos/echo';
 import { defineFunction } from '@dxos/functions';
 
-import { Chess } from '../types';
+import { Chess } from '../../types';
 
 export default defineFunction({
   key: 'dxos.org/function/chess/play',
   name: 'Play',
   description: 'Uses the chess engine to play the next move.',
   inputSchema: Schema.Struct({
-    id: ArtifactId.annotations({
+    game: Type.Ref(Chess.Game).annotations({
       description: 'The ID of the chess object.',
     }),
     side: Schema.optional(Schema.Literal('white', 'black', 'any')).annotations({
@@ -33,8 +32,8 @@ export default defineFunction({
       description: 'The move that was played.',
     }),
   }),
-  handler: Effect.fn(function* ({ data: { id, side = 'any' } }) {
-    const object = yield* Database.Service.resolve(ArtifactId.toDXN(id), Chess.Game);
+  handler: Effect.fn(function* ({ data: { game, side = 'any' } }) {
+    const object = yield* Database.load(game);
     const chess = new ChessJS();
     if (object.pgn) {
       chess.loadPgn(object.pgn);
@@ -50,7 +49,10 @@ export default defineFunction({
     const move = moves[Math.floor(Math.random() * moves.length)];
 
     chess.move(move, { strict: false });
-    object.pgn = chess.pgn();
-    return { move, pgn: object.pgn };
+    const pgn = chess.pgn();
+    Obj.change(object, (o) => {
+      o.pgn = pgn;
+    });
+    return { move, pgn };
   }),
 });

package/src/blueprints/functions/print.ts

@@ -0,0 +1,42 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Chess as ChessJS } from 'chess.js';
+import * as Effect from 'effect/Effect';
+import * as Schema from 'effect/Schema';
+
+import { defineFunction } from '@dxos/functions';
+
+export default defineFunction({
+  key: 'dxos.org/function/chess/print',
+  name: 'Print game',
+  description: 'Prints the chess game to ASCII.',
+  inputSchema: Schema.Struct({
+    pgn: Schema.optional(
+      Schema.String.annotations({
+        description: 'Portable Game Notation.',
+      }),
+    ),
+    fen: Schema.optional(
+      Schema.String.annotations({
+        description: 'Forsyth-Edwards Notation.',
+      }),
+    ),
+  }),
+  outputSchema: Schema.Struct({
+    ascii: Schema.String,
+  }),
+  handler: Effect.fn(function* ({ data: { pgn, fen } }) {
+    try {
+      const chess = new ChessJS(fen);
+      if (pgn) {
+        chess.loadPgn(pgn);
+      }
+      return { ascii: chess.ascii() };
+    } catch {
+      // TODO(burdon): Error handling?
+      return { ascii: '' };
+    }
+  }),
+});

package/src/blueprints/index.ts

@@ -0,0 +1,6 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+export * as ChessBlueprint from './chess-blueprint';
+export * as ChessFunctions from './functions';

package/src/capabilities/artifact-definition/artifact-definition.ts

@@ -0,0 +1,135 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+// ISSUE(burdon): defineArtifact
+// @ts-nocheck
+
+import { Chess as ChessJS } from 'chess.js';
+import * as Effect from 'effect/Effect';
+import * as Schema from 'effect/Schema';
+
+import { ToolResult, createTool } from '@dxos/ai';
+import { Capabilities, Capability, type PromiseIntentDispatcher } from '@dxos/app-framework';
+import { ArtifactId, VersionPin, createArtifactElement } from '@dxos/assistant';
+import { defineArtifact } from '@dxos/blueprints';
+import { Obj } from '@dxos/echo';
+import { invariant } from '@dxos/invariant';
+import { SpaceOperation } from '@dxos/plugin-space/types';
+import { Filter, type Space } from '@dxos/react-client/echo';
+import { trim } from '@dxos/util';
+
+import { meta } from '../../meta';
+import { Chess } from '../../types';
+
+// TODO(burdon): Factor out.
+declare global {
+  interface ToolContextExtensions {
+    space?: Space;
+    dispatch?: PromiseIntentDispatcher;
+  }
+}
+
+export default Capability.makeModule(() =>
+  Effect.sync(() => {
+    const definition = defineArtifact({
+      id: `artifact:${meta.id}`,
+      name: meta.name,
+      description: 'Provides a simple chess engine.',
+      instructions: trim`
+      - If the user's message relates to a chess game, you must return the chess game inside the artifact tag as a valid FEN string with no additional text.
+      - Always inspect the chess game at the start of every prompt realting to a chess game, as it might have changed since the interaction.
+   `,
+      schema: Chess.Game,
+      tools: [
+        createTool(meta.id, {
+          name: 'create',
+          description: 'Create a new chess game. Returns the artifact definition for the game.',
+          caption: 'Creating chess game...',
+          schema: Schema.Struct({
+            pgn: Schema.String.annotations({ description: 'The state of the chess game in the PGN format.' }),
+          }),
+          execute: async ({ pgn }, { extensions }) => {
+            invariant(extensions?.space, 'No space');
+            invariant(extensions?.invoke, 'No operation invoker');
+
+            const game = Chess.make({ pgn });
+
+            const { data, error } = await extensions.invoke(SpaceOperation.AddObject, {
+              target: extensions.space,
+              object: game,
+            });
+            if (error) {
+              return ToolResult.Error(error?.message ?? 'Failed to add chess game to space');
+            }
+
+            return ToolResult.Success(createArtifactElement(game.id), [
+              VersionPin.createBlock(VersionPin.fromObject(game)),
+            ]);
+          },
+        }),
+        createTool(meta.id, {
+          name: 'list',
+          description: 'Query all active chess games.',
+          caption: 'Getting games...',
+          schema: Schema.Struct({}),
+          execute: async (_, { extensions }) => {
+            invariant(extensions?.space, 'No space');
+            const { objects: games } = await extensions.space.db.query(Filter.type(Chess.Game)).run();
+            invariant(games.length > 0, 'No chess games found');
+
+            return ToolResult.Success(games);
+          },
+        }),
+        createTool(meta.id, {
+          name: 'inspect',
+          description: 'Get the current state of the chess game.',
+          caption: 'Inspecting game...',
+          schema: Schema.Struct({ id: ArtifactId }),
+          execute: async ({ id }, { extensions }) => {
+            invariant(extensions?.space, 'No space');
+            const game = await extensions.space.db
+              .query(Filter.id(ArtifactId.toDXN(id, extensions.space.id).toString()))
+              .first();
+            invariant(Obj.instanceOf(Chess.Game, game));
+
+            return ToolResult.Success(game.pgn);
+          },
+        }),
+        createTool(meta.id, {
+          name: 'move',
+          description: 'Make a move in the chess game.',
+          caption: 'Making chess move...',
+          schema: Schema.Struct({
+            id: ArtifactId,
+            move: Schema.String.annotations({
+              description: 'The move to make in the chess game.',
+              examples: ['e4', 'Bf3'],
+            }),
+          }),
+          execute: async ({ id, move }, { extensions }) => {
+            invariant(extensions?.space, 'No space');
+            const game = await extensions.space.db
+              .query(Filter.id(ArtifactId.toDXN(id, extensions.space.id).toString()))
+              .first();
+            invariant(Obj.instanceOf(Chess.Game, game));
+
+            const chess = new ChessJS(game.pgn);
+            try {
+              chess.move(move);
+            } catch (error: any) {
+              return ToolResult.Error(error.message);
+            }
+
+            Obj.change(game, (g) => {
+              g.pgn = chess.pgn();
+            });
+            return ToolResult.Success(game.pgn);
+          },
+        }),
+      ],
+    });
+
+    return Capability.contributes(Capabilities.ArtifactDefinition, definition);
+  }),
+);

package/src/capabilities/artifact-definition/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capability } from '@dxos/app-framework';
+
+export const ArtifactDefinition = Capability.lazy('ArtifactDefinition', () => import('./artifact-definition'));

package/src/capabilities/blueprint-definition/blueprint-definition.ts

@@ -0,0 +1,24 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability } from '@dxos/app-framework';
+import { AppCapabilities } from '@dxos/app-toolkit';
+
+import { ChessBlueprint } from '../../blueprints';
+
+export type BlueprintCapabilities = [
+  Capability.Capability<typeof AppCapabilities.Functions>,
+  Capability.Capability<typeof AppCapabilities.BlueprintDefinition>,
+];
+
+const blueprintDefinition = Capability.makeModule<[], BlueprintCapabilities>(() =>
+  Effect.succeed([
+    Capability.contributes(AppCapabilities.Functions, ChessBlueprint.functions),
+    Capability.contributes(AppCapabilities.BlueprintDefinition, ChessBlueprint.make()),
+  ]),
+);
+
+export default blueprintDefinition;

package/src/capabilities/blueprint-definition/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capability } from '@dxos/app-framework';
+
+export const BlueprintDefinition = Capability.lazy('BlueprintDefinition', () => import('./blueprint-definition'));

package/src/capabilities/index.ts

@@ -2,10 +2,5 @@
 // Copyright 2025 DXOS.org
 //
 
-import { lazy } from '@dxos/app-framework';
-
-export const BlueprintDefinition = lazy(() => import('./blueprint-definition'));
-export const IntentResolver = lazy(() => import('./intent-resolver'));
-export const ReactSurface = lazy(() => import('./react-surface'));
-
 export * from './blueprint-definition';
+export * from './react-surface';

package/src/capabilities/react-surface/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capability } from '@dxos/app-framework';
+
+export const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));

package/src/capabilities/react-surface/react-surface.tsx

@@ -0,0 +1,28 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+import React from 'react';
+
+import { Capabilities, Capability } from '@dxos/app-framework';
+import { Surface } from '@dxos/app-framework/ui';
+import { Obj } from '@dxos/echo';
+
+import { ChessboardContainer } from '../../components';
+import { meta } from '../../meta';
+import { Chess } from '../../types';
+
+export default Capability.makeModule(() =>
+  Effect.succeed(
+    Capability.contributes(Capabilities.ReactSurface, [
+      Surface.create({
+        id: meta.id,
+        role: ['article', 'section', 'card--content'],
+        // TODO(burdon): Could this be standardized so that we don't require a subject property.
+        filter: (data): data is { subject: Chess.Game } => Obj.instanceOf(Chess.Game, data.subject),
+        component: ({ data, role }) => <ChessboardContainer role={role} subject={data.subject} />,
+      }),
+    ]),
+  ),
+);

package/src/cli/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+export * from './plugin';