@dxos/plugin-kanban 0.8.3 → 0.8.4-main.1068cf700f

package/package.json

@@ -1,28 +1,43 @@
 {
   "name": "@dxos/plugin-kanban",
-  "version": "0.8.3",
+  "version": "0.8.4-main.1068cf700f",
   "description": "Kanban DXOS Surface 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,
   "type": "module",
   "exports": {
     ".": {
-      "types": "./dist/types/src/index.d.ts",
       "browser": "./dist/lib/browser/index.mjs",
-      "node": "./dist/lib/node-esm/index.mjs"
+      "node": "./dist/lib/node-esm/index.mjs",
+      "source": "./src/index.ts",
+      "types": "./dist/types/src/index.d.ts"
+    },
+    "./blueprints": {
+      "browser": "./dist/lib/browser/blueprints/index.mjs",
+      "node": "./dist/lib/node-esm/blueprints/index.mjs",
+      "source": "./src/blueprints/index.ts",
+      "types": "./dist/types/src/blueprints/index.d.ts"
     },
     "./types": {
-      "types": "./dist/types/src/types/index.d.ts",
       "browser": "./dist/lib/browser/types/index.mjs",
-      "node": "./dist/lib/node-esm/types/index.mjs"
+      "node": "./dist/lib/node-esm/types/index.mjs",
+      "source": "./src/types/index.ts",
+      "types": "./dist/types/src/types/index.d.ts"
     }
   },
   "types": "dist/types/src/index.d.ts",
   "typesVersions": {
     "*": {
+      "blueprints": [
+        "dist/types/src/blueprints/index.d.ts"
+      ],
       "types": [
         "dist/types/src/types/index.d.ts"
       ]
@@ -33,49 +48,55 @@
     "src"
   ],
   "dependencies": {
-    "@preact-signals/safe-react": "^0.9.0",
-    "@preact/signals-core": "^1.9.0",
-    "effect": "3.14.21",
-    "@dxos/ai": "0.8.3",
-    "@dxos/app-framework": "0.8.3",
-    "@dxos/assistant": "0.8.3",
-    "@dxos/artifact": "0.8.3",
-    "@dxos/async": "0.8.3",
-    "@dxos/echo-schema": "0.8.3",
-    "@dxos/echo": "0.8.3",
-    "@dxos/effect": "0.8.3",
-    "@dxos/invariant": "0.8.3",
-    "@dxos/plugin-client": "0.8.3",
-    "@dxos/plugin-graph": "0.8.3",
-    "@dxos/plugin-search": "0.8.3",
-    "@dxos/plugin-space": "0.8.3",
-    "@dxos/random": "0.8.3",
-    "@dxos/react-client": "0.8.3",
-    "@dxos/react-ui-form": "0.8.3",
-    "@dxos/react-ui-kanban": "0.8.3",
-    "@dxos/react-ui-stack": "0.8.3",
-    "@dxos/schema": "0.8.3",
-    "@dxos/util": "0.8.3"
+    "@effect-atom/atom-react": "^0.5.0",
+    "effect": "3.19.16",
+    "@dxos/ai": "0.8.4-main.1068cf700f",
+    "@dxos/app-framework": "0.8.4-main.1068cf700f",
+    "@dxos/async": "0.8.4-main.1068cf700f",
+    "@dxos/echo": "0.8.4-main.1068cf700f",
+    "@dxos/app-toolkit": "0.8.4-main.1068cf700f",
+    "@dxos/assistant": "0.8.4-main.1068cf700f",
+    "@dxos/effect": "0.8.4-main.1068cf700f",
+    "@dxos/functions": "0.8.4-main.1068cf700f",
+    "@dxos/blueprints": "0.8.4-main.1068cf700f",
+    "@dxos/invariant": "0.8.4-main.1068cf700f",
+    "@dxos/log": "0.8.4-main.1068cf700f",
+    "@dxos/plugin-graph": "0.8.4-main.1068cf700f",
+    "@dxos/operation": "0.8.4-main.1068cf700f",
+    "@dxos/plugin-space": "0.8.4-main.1068cf700f",
+    "@dxos/plugin-client": "0.8.4-main.1068cf700f",
+    "@dxos/plugin-search": "0.8.4-main.1068cf700f",
+    "@dxos/random": "0.8.4-main.1068cf700f",
+    "@dxos/react-ui": "0.8.4-main.1068cf700f",
+    "@dxos/react-client": "0.8.4-main.1068cf700f",
+    "@dxos/react-ui-form": "0.8.4-main.1068cf700f",
+    "@dxos/react-ui-kanban": "0.8.4-main.1068cf700f",
+    "@dxos/react-ui-mosaic": "0.8.4-main.1068cf700f",
+    "@dxos/react-ui-stack": "0.8.4-main.1068cf700f",
+    "@dxos/types": "0.8.4-main.1068cf700f",
+    "@dxos/util": "0.8.4-main.1068cf700f",
+    "@dxos/schema": "0.8.4-main.1068cf700f"
   },
   "devDependencies": {
-    "@types/react": "~18.2.0",
-    "@types/react-dom": "~18.2.0",
-    "react": "~18.2.0",
-    "react-dom": "~18.2.0",
-    "vite": "5.4.7",
-    "@dxos/plugin-preview": "0.8.3",
-    "@dxos/plugin-theme": "0.8.3",
-    "@dxos/react-ui": "0.8.3",
-    "@dxos/storybook-utils": "0.8.3",
-    "@dxos/react-ui-theme": "0.8.3",
-    "@dxos/react-ui-syntax-highlighter": "0.8.3"
+    "@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-preview": "0.8.4-main.1068cf700f",
+    "@dxos/plugin-theme": "0.8.4-main.1068cf700f",
+    "@dxos/plugin-testing": "0.8.4-main.1068cf700f",
+    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.1068cf700f",
+    "@dxos/test-utils": "0.8.4-main.1068cf700f",
+    "@dxos/ui-theme": "0.8.4-main.1068cf700f",
+    "@dxos/storybook-utils": "0.8.4-main.1068cf700f"
   },
   "peerDependencies": {
-    "effect": "^3.13.3",
-    "react": "~18.2.0",
-    "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.8.3",
-    "@dxos/react-ui-theme": "0.8.3"
+    "effect": "3.19.16",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "@dxos/ui-theme": "0.8.4-main.1068cf700f",
+    "@dxos/react-ui": "0.8.4-main.1068cf700f"
   },
   "publishConfig": {
     "access": "public"

package/src/KanbanPlugin.tsx

@@ -2,61 +2,45 @@
 // Copyright 2023 DXOS.org
 //
 
-import { createIntent, defineModule, contributes, Capabilities, Events, definePlugin } from '@dxos/app-framework';
-import { ClientEvents } from '@dxos/plugin-client';
-import { SpaceCapabilities } from '@dxos/plugin-space';
-import { defineObjectForm } from '@dxos/plugin-space/types';
-import { KanbanType, translations as kanbanTranslations } from '@dxos/react-ui-kanban';
+import * as Effect from 'effect/Effect';
 
-import { ArtifactDefinition, IntentResolver, ReactSurface } from './capabilities';
+import { Plugin } from '@dxos/app-framework';
+import { AppPlugin } from '@dxos/app-toolkit';
+import { Type } from '@dxos/echo';
+import { type CreateObject } from '@dxos/plugin-space/types';
+import { translations as kanbanTranslations } from '@dxos/react-ui-kanban';
+import { Kanban } from '@dxos/react-ui-kanban/types';
+import { View } from '@dxos/schema';
+
+import { BlueprintDefinition, OperationResolver, ReactSurface } from './capabilities';
 import { meta } from './meta';
-import translations from './translations';
-import { CreateKanbanSchema, KanbanAction } from './types';
+import { translations } from './translations';
+import { CreateKanbanSchema } from './types';
 
-export const KanbanPlugin = () =>
-  definePlugin(meta, [
-    defineModule({
-      id: `${meta.id}/module/translations`,
-      activatesOn: Events.SetupTranslations,
-      activate: () => contributes(Capabilities.Translations, [...translations, ...kanbanTranslations]),
-    }),
-    defineModule({
-      id: `${meta.id}/module/metadata`,
-      activatesOn: Events.SetupMetadata,
-      activate: () =>
-        contributes(Capabilities.Metadata, {
-          id: KanbanType.typename,
-          metadata: {
-            icon: 'ph--kanban--regular',
-          },
-        }),
-    }),
-    defineModule({
-      id: `${meta.id}/module/object-form`,
-      activatesOn: ClientEvents.SetupSchema,
-      activate: () =>
-        contributes(
-          SpaceCapabilities.ObjectForm,
-          defineObjectForm({
-            objectSchema: KanbanType,
-            formSchema: CreateKanbanSchema,
-            getIntent: (props, options) => createIntent(KanbanAction.Create, { ...props, space: options.space }),
-          }),
-        ),
-    }),
-    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/artifact-definition`,
-      activatesOn: Events.SetupArtifactDefinition,
-      activate: ArtifactDefinition,
-    }),
-  ]);
+export const KanbanPlugin = Plugin.define(meta).pipe(
+  AppPlugin.addBlueprintDefinitionModule({ activate: BlueprintDefinition }),
+  AppPlugin.addMetadataModule({
+    metadata: {
+      id: Type.getTypename(Kanban.Kanban),
+      metadata: {
+        icon: 'ph--kanban--regular',
+        iconHue: 'green',
+        inputSchema: CreateKanbanSchema,
+        createObject: ((props, { db }) =>
+          Effect.promise(async () => {
+            const { view } = await View.makeFromDatabase({
+              db,
+              typename: props.typename,
+              pivotFieldName: props.initialPivotColumn,
+            });
+            return Kanban.make({ name: props.name, view });
+          })) satisfies CreateObject,
+      },
+    },
+  }),
+  AppPlugin.addOperationResolverModule({ activate: OperationResolver }),
+  AppPlugin.addSchemaModule({ schema: [Kanban.Kanban] }),
+  AppPlugin.addSurfaceModule({ activate: ReactSurface }),
+  AppPlugin.addTranslationsModule({ translations: [...translations, ...kanbanTranslations] }),
+  Plugin.make,
+);

package/src/blueprints/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+export * as KanbanBlueprint from './kanban-blueprint';

package/src/blueprints/kanban-blueprint.ts

@@ -0,0 +1,24 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Blueprint, Template } from '@dxos/blueprints';
+import { type FunctionDefinition } from '@dxos/functions';
+import { trim } from '@dxos/util';
+
+export const functions: FunctionDefinition[] = [];
+export const tools: string[] = [];
+
+export const Key = 'dxos.org/blueprint/kanban';
+
+export const make = () =>
+  Blueprint.make({
+    key: Key,
+    name: 'Kanban',
+    tools: Blueprint.toolDefinitions({ functions, tools }),
+    instructions: Template.make({
+      source: trim`
+        You can create and update kanban boards to show data in sorted columns defined by schema.
+      `,
+    }),
+  });

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

@@ -0,0 +1,150 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+// ISSUE(burdon): defineArtifact
+// @ts-nocheck
+
+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 { createArtifactElement } from '@dxos/assistant';
+import { defineArtifact } from '@dxos/blueprints';
+import { Obj, Query } 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 { Kanban, KanbanView } from '@dxos/react-ui-kanban';
+import { View } from '@dxos/schema';
+import { isNonNullable } from '@dxos/util';
+
+import { meta } from '../../meta';
+
+const QualifiedId = Schema.String.annotations({
+  description: 'The fully qualified ID of the kanban `spaceID:objectID`',
+});
+
+declare global {
+  interface ToolContextExtensions {
+    space?: Space;
+    dispatch?: PromiseIntentDispatcher;
+  }
+}
+
+export default Capability.makeModule(() =>
+  Effect.sync(() => {
+    const definition = defineArtifact({
+      id: `artifact:${meta.id}`,
+      name: meta.name,
+      instructions: `
+      - Before adding items to a kanban board, inspect the board to see its schema
+      - When adding items, you must not include the 'id' field -- it is automatically generated
+      - BEFORE adding items, always make sure the board has been shown to the user!
+    `,
+      schema: KanbanView,
+      tools: [
+        createTool(meta.id, {
+          name: 'create',
+          description: `
+            Create a new kanban board using an existing schema.
+            Use schema_create first to create a schema, or schema_list to choose an existing one.`,
+          caption: 'Creating kanban board...',
+          schema: Schema.Struct({
+            typename: Schema.String.annotations({
+              description: 'The fully qualified name of the record type to use for the kanban cards.',
+            }),
+            pivotColumn: Schema.optional(Schema.String).annotations({
+              description: 'Optional field name to use as the column pivot.',
+            }),
+          }),
+          execute: async ({ typename, pivotColumn }, { extensions }) => {
+            invariant(extensions?.space, 'No space');
+            invariant(extensions?.invoke, 'No operation invoker');
+
+            // Validate schema exists first
+            const schema = await extensions.space.db.schemaRegistry.query({ typename }).firstOrUndefined();
+            if (!schema) {
+              return ToolResult.Error(`Schema not found: ${typename}`);
+            }
+
+            const { view } = await View.makeFromDatabase({
+              db: extensions.space.db,
+              typename,
+              pivotFieldName: pivotColumn,
+            });
+            const kanban = Kanban.make({ view });
+
+            const { error } = await extensions.invoke(SpaceOperation.AddObject, {
+              target: extensions.space,
+              object: kanban,
+            });
+            if (error) {
+              return ToolResult.Error(error?.message ?? 'Failed to add kanban board to space');
+            }
+
+            return ToolResult.Success(createArtifactElement(kanban.id));
+          },
+        }),
+        createTool(meta.id, {
+          name: 'list',
+          description: 'List all kanban boards in the current space.',
+          caption: 'Listing kanban boards...',
+          schema: Schema.Struct({}),
+          execute: async (_input, { extensions }) => {
+            invariant(extensions?.space, 'No space');
+            const space = extensions.space;
+            const { objects } = await space.db.query(Filter.type(View.View)).run();
+
+            const boardInfo = await Promise.all(
+              objects.map(async (view) => {
+                const kanban = await view.presentation.load();
+                if (!Obj.instanceOf(KanbanView, kanban)) {
+                  return null;
+                }
+
+                return {
+                  id: Obj.getDXN(view).toString(),
+                  name: view.name ?? 'Unnamed Kanban',
+                  typename: view.query.typename,
+                };
+              }),
+            );
+
+            return ToolResult.Success(boardInfo.filter(isNonNullable));
+          },
+        }),
+        createTool(meta.id, {
+          name: 'inspect',
+          description: 'Get details about a specific kanban board.',
+          caption: 'Inspecting kanban board...',
+          schema: Schema.Struct({ id: QualifiedId }),
+          execute: async ({ id }, { extensions }) => {
+            invariant(extensions?.space, 'No space');
+            const space = extensions.space;
+            const view = (await space.db
+              // TODO(wittjosiah): Filter.and should aggregate type
+              .query(Query.select(Filter.and(Filter.type(View.View), Filter.id(id))))
+              .first()) as View.View;
+
+            const kanban = await view.presentation.load();
+            invariant(Obj.instanceOf(KanbanView, kanban));
+
+            const typename = view.query.typename;
+            const schema = await space.db.schemaRegistry.query({ typename }).firstOrUndefined();
+            invariant(schema);
+
+            return ToolResult.Success({
+              schema,
+              columnField: kanban.columnFieldId,
+              viewFields: view.projection.fields,
+            });
+          },
+        }),
+      ],
+    });
+
+    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 { KanbanBlueprint } 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, KanbanBlueprint.functions),
+    Capability.contributes(AppCapabilities.BlueprintDefinition, KanbanBlueprint.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,8 +2,6 @@
 // Copyright 2025 DXOS.org
 //
 
-import { lazy } from '@dxos/app-framework';
-
-export const ArtifactDefinition = lazy(() => import('./artifact-definition'));
-export const IntentResolver = lazy(() => import('./intent-resolver'));
-export const ReactSurface = lazy(() => import('./react-surface'));
+export * from './blueprint-definition';
+export * from './operation-resolver';
+export * from './react-surface';

package/src/capabilities/operation-resolver/index.ts

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

package/src/capabilities/operation-resolver/operation-resolver.ts

@@ -0,0 +1,133 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capabilities, Capability, UndoMapping } from '@dxos/app-framework';
+import { JsonSchema, Obj } from '@dxos/echo';
+import { type EchoSchema } from '@dxos/echo/internal';
+import { invariant } from '@dxos/invariant';
+import { OperationResolver } from '@dxos/operation';
+import { ProjectionModel, createEchoChangeCallback, getTypenameFromQuery } from '@dxos/schema';
+
+import { meta } from '../../meta';
+import { KanbanOperation } from '../../types';
+
+export default Capability.makeModule(() =>
+  Effect.succeed([
+    Capability.contributes(Capabilities.UndoMapping, [
+      UndoMapping.make({
+        operation: KanbanOperation.DeleteCardField,
+        inverse: KanbanOperation.RestoreCardField,
+        deriveContext: (input, output) => ({
+          view: input.view,
+          field: output.field,
+          props: output.props,
+          index: output.index,
+        }),
+        message: ['card field deleted label', { ns: meta.id }],
+      }),
+      UndoMapping.make({
+        operation: KanbanOperation.DeleteCard,
+        inverse: KanbanOperation.RestoreCard,
+        deriveContext: (_input, output) => ({
+          card: output.card,
+        }),
+        message: ['card deleted label', { ns: meta.id }],
+      }),
+    ]),
+    Capability.contributes(Capabilities.OperationResolver, [
+      OperationResolver.make({
+        operation: KanbanOperation.DeleteCardField,
+        handler: Effect.fnUntraced(function* ({ view, fieldId }) {
+          const registry = yield* Capability.get(Capabilities.AtomRegistry);
+          const db = Obj.getDatabase(view);
+          invariant(db, 'Database not found');
+          const schema = yield* Effect.promise(() =>
+            db.schemaRegistry
+              .query({
+                typename: getTypenameFromQuery(view.query.ast)!,
+                location: ['database', 'runtime'],
+              })
+              .first(),
+          );
+
+          // Create projection with change callbacks that wrap in Obj.change().
+          // Schema from registry is an EchoSchema at runtime.
+          const projection = new ProjectionModel({
+            registry,
+            view,
+            baseSchema: JsonSchema.toJsonSchema(schema),
+            change: createEchoChangeCallback(view, schema as EchoSchema),
+          });
+
+          const result = projection.deleteFieldProjection(fieldId);
+
+          // Return data needed for undo.
+          return {
+            field: result.deleted.field,
+            props: result.deleted.props,
+            index: result.index,
+          };
+        }),
+      }),
+      OperationResolver.make({
+        operation: KanbanOperation.DeleteCard,
+        handler: ({ card }) =>
+          Effect.sync(() => {
+            const db = Obj.getDatabase(card);
+            invariant(db);
+            db.remove(card);
+
+            // Return data needed for undo.
+            return { card };
+          }),
+      }),
+
+      //
+      // RestoreCardField (inverse of DeleteCardField)
+      //
+      OperationResolver.make({
+        operation: KanbanOperation.RestoreCardField,
+        handler: Effect.fnUntraced(function* ({ view, field, props, index }) {
+          const registry = yield* Capability.get(Capabilities.AtomRegistry);
+          const db = Obj.getDatabase(view);
+          invariant(db, 'Database not found');
+          const schema = yield* Effect.promise(() =>
+            db.schemaRegistry
+              .query({
+                typename: getTypenameFromQuery(view.query.ast)!,
+                location: ['database', 'runtime'],
+              })
+              .first(),
+          );
+
+          // Create projection with change callbacks that wrap in Obj.change().
+          // Schema from registry is an EchoSchema at runtime.
+          const projection = new ProjectionModel({
+            registry,
+            view,
+            baseSchema: JsonSchema.toJsonSchema(schema),
+            change: createEchoChangeCallback(view, schema as EchoSchema),
+          });
+
+          projection.setFieldProjection({ field, props }, index);
+        }),
+      }),
+
+      //
+      // RestoreCard (inverse of DeleteCard)
+      //
+      OperationResolver.make({
+        operation: KanbanOperation.RestoreCard,
+        handler: ({ card }) =>
+          Effect.sync(() => {
+            const db = Obj.getDatabase(card);
+            invariant(db);
+            db.add(card);
+          }),
+      }),
+    ]),
+  ]),
+);

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'));