@dxos/plugin-kanban 0.7.4 → 0.7.5-labs.401163d

package/dist/types/src/capabilities/react-surface.d.ts

@@ -0,0 +1,4 @@
+import { Capabilities } from '@dxos/app-framework';
+declare const _default: () => import("@dxos/app-framework").Capability<Capabilities.ReactSurface>;
+export default _default;
+//# sourceMappingURL=react-surface.d.ts.map

package/dist/types/src/capabilities/react-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-surface.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/react-surface.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAA8B,MAAM,qBAAqB,CAAC;;AAY/E,wBAsEK"}

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

@@ -0,0 +1,7 @@
+import React from 'react';
+import { type KanbanType } from '@dxos/react-ui-kanban';
+export declare const KanbanContainer: ({ kanban }: {
+    kanban: KanbanType;
+    role: string;
+}) => React.JSX.Element;
+//# sourceMappingURL=KanbanContainer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KanbanContainer.d.ts","sourceRoot":"","sources":["../../../../src/components/KanbanContainer.tsx"],"names":[],"mappings":"AAIA,OAAO,KAA2C,MAAM,OAAO,CAAC;AAMhE,OAAO,EAAE,KAAK,UAAU,EAA0B,MAAM,uBAAuB,CAAC;AAMhF,eAAO,MAAM,eAAe,eAAgB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,sBAmE/E,CAAC"}

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

@@ -0,0 +1,8 @@
+import React from 'react';
+import { type KanbanType } from '@dxos/react-ui-kanban';
+type KanbanViewEditorProps = {
+    kanban: KanbanType;
+};
+export declare const KanbanViewEditor: ({ kanban }: KanbanViewEditorProps) => React.JSX.Element | null;
+export {};
+//# sourceMappingURL=KanbanViewEditor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KanbanViewEditor.d.ts","sourceRoot":"","sources":["../../../../src/components/KanbanViewEditor.tsx"],"names":[],"mappings":"AAIA,OAAO,KAA+B,MAAM,OAAO,CAAC;AAOpD,OAAO,EAAE,KAAK,UAAU,EAAwB,MAAM,uBAAuB,CAAC;AAK9E,KAAK,qBAAqB,GAAG;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAEpD,eAAO,MAAM,gBAAgB,eAAgB,qBAAqB,6BAsEjE,CAAC"}

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

@@ -1,4 +1,3 @@
-export declare const KanbanMain: import("react").LazyExoticComponent<import("react").FC<{
-    kanban: import("../types").KanbanType;
-}>>;
+export * from './KanbanContainer';
+export * from './KanbanViewEditor';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/index.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,UAAU;;GAAqC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/index.ts"],"names":[],"mappings":"AAIA,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}

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

@@ -1,4 +1,3 @@
-import { KanbanPlugin } from './KanbanPlugin';
-export default KanbanPlugin;
 export * from './KanbanPlugin';
+export * from './meta';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,eAAe,YAAY,CAAC;AAE5B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC"}

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

@@ -1,11 +1,11 @@
 export declare const KANBAN_PLUGIN = "dxos.org/plugin/kanban";
-declare const _default: {
+export declare const meta: {
     id: string;
     name: string;
     description: string;
     icon: string;
     source: string;
     tags: string[];
+    screenshots: string[];
 };
-export default _default;
 //# sourceMappingURL=meta.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/meta.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,aAAa,2BAA2B,CAAC;;;;;;;;;AAEtD,wBAOuB"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/meta.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,aAAa,2BAA2B,CAAC;AAEtD,eAAO,MAAM,IAAI;;;;;;;;CASK,CAAC"}

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

@@ -1,5 +1,38 @@
 declare const _default: {
     'en-US': {
+        [x: string]: {
+            'typename label': string;
+            'plugin name'?: undefined;
+            'kanban title label'?: undefined;
+            'kanban title placeholder'?: undefined;
+            'column title label'?: undefined;
+            'column title placeholder'?: undefined;
+            'item title label'?: undefined;
+            'item title placeholder'?: undefined;
+            'add column label'?: undefined;
+            'add item label'?: undefined;
+            'delete column label'?: undefined;
+            'delete item label'?: undefined;
+            'create kanban label'?: undefined;
+            'card field deleted label'?: undefined;
+            'card deleted label'?: undefined;
+        } | {
+            'plugin name': string;
+            'kanban title label': string;
+            'kanban title placeholder': string;
+            'column title label': string;
+            'column title placeholder': string;
+            'item title label': string;
+            'item title placeholder': string;
+            'add column label': string;
+            'add item label': string;
+            'delete column label': string;
+            'delete item label': string;
+            'create kanban label': string;
+            'card field deleted label': string;
+            'card deleted label': string;
+            'typename label'?: undefined;
+        };
         "dxos.org/plugin/kanban": {
             'plugin name': string;
             'kanban title label': string;
@@ -13,6 +46,8 @@ declare const _default: {
             'delete column label': string;
             'delete item label': string;
             'create kanban label': string;
+            'card field deleted label': string;
+            'card deleted label': string;
         };
     };
 }[];

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

@@ -1 +1 @@
-{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../src/translations.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAMA,wBAmBE"}
+{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../src/translations.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,wBAwBE"}

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

@@ -0,0 +1,83 @@
+import { S } from '@dxos/echo-schema';
+import { type Space } from '@dxos/react-client/echo';
+import { KanbanType } from '@dxos/react-ui-kanban';
+/**
+ * Kanban data model.
+ * A Kanban board is a collection of columns, each of which contains a collection of items.
+ * The layout of columns and items is controlled by models.
+ * The underlying data model may be represented by direct object relationships
+ * (e.g., a column object containing an array of ordered items) or projections constructed
+ * by the model (e.g., a query of items based on metadata within a column object).
+ */
+export declare const InitialSchemaAnnotationId: unique symbol;
+export declare const InitialPivotColumnAnnotationId: unique symbol;
+export declare const CreateKanbanSchema: S.Struct<{
+    name: S.optional<typeof S.String>;
+    initialSchema: S.optional<S.SchemaClass<string, string, never>>;
+    initialPivotColumn: S.optional<S.SchemaClass<string, string, never>>;
+}>;
+export type CreateKanbanType = S.Schema.Type<typeof CreateKanbanSchema>;
+export declare namespace KanbanAction {
+    const Create_base: S.TaggedClass<Create, "dxos.org/plugin/kanban/action/create", {
+        readonly _tag: S.tag<"dxos.org/plugin/kanban/action/create">;
+    } & {
+        input: S.extend<S.Struct<{
+            space: S.Schema<Space, Space, never>;
+        }>, S.Struct<{
+            name: S.optional<typeof S.String>;
+            initialSchema: S.optional<S.SchemaClass<string, string, never>>;
+            initialPivotColumn: S.optional<S.SchemaClass<string, string, never>>;
+        }>>;
+        output: S.Struct<{
+            object: typeof KanbanType;
+        }>;
+    }>;
+    export class Create extends Create_base {
+    }
+    const DeleteCardField_base: S.TaggedClass<DeleteCardField, "dxos.org/plugin/kanban/action/delete-card-field", {
+        readonly _tag: S.tag<"dxos.org/plugin/kanban/action/delete-card-field">;
+    } & {
+        input: S.Struct<{
+            kanban: typeof KanbanType;
+            fieldId: typeof S.String;
+            deletionData: S.optional<S.Struct<{
+                field: S.mutable<S.Struct<{
+                    id: typeof S.String;
+                    path: S.Schema<import("@dxos/echo-schema").JsonPath, import("@dxos/echo-schema").JsonPath, never>;
+                    visible: S.optional<typeof S.Boolean>;
+                    size: S.optional<typeof S.Number>;
+                    referencePath: S.optional<S.Schema<import("@dxos/echo-schema").JsonPath, import("@dxos/echo-schema").JsonPath, never>>;
+                }>>;
+                props: typeof S.Any;
+                index: typeof S.Number;
+            }>>;
+        }>;
+        output: typeof S.Void;
+    }>;
+    export class DeleteCardField extends DeleteCardField_base {
+    }
+    const DeleteCard_base: S.TaggedClass<DeleteCard, "dxos.org/plugin/kanban/action/delete-card", {
+        readonly _tag: S.tag<"dxos.org/plugin/kanban/action/delete-card">;
+    } & {
+        input: S.Struct<{
+            card: typeof S.Any;
+        }>;
+        output: typeof S.Void;
+    }>;
+    export class DeleteCard extends DeleteCard_base {
+    }
+    export {};
+}
+export interface KanbanModel {
+    root: KanbanType;
+}
+export type Location = {
+    idx?: number;
+};
+export declare const isKanban: (object: unknown) => object is KanbanType;
+export declare const createKanban: (props: {
+    space: Space;
+    initialSchema?: string;
+    initialPivotColumn?: string;
+}) => Promise<KanbanType>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AACtC,OAAO,EAAE,KAAK,KAAK,EAAe,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAMnD;;;;;;;GAOG;AAEH,eAAO,MAAM,yBAAyB,eAA6D,CAAC;AACpG,eAAO,MAAM,8BAA8B,eAAkE,CAAC;AAE9G,eAAO,MAAM,kBAAkB;;;;EAc7B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAExE,yBAAiB,YAAY,CAAC;;;;;;;;;;;;;;;IAG5B,MAAM,OAAO,MAAO,SAAQ,WAK1B;KAAG;;;;;;;;;+BA3CL,EAAG,MAAM;0BAAW,EAAI,MAAK;6BACxB,EAAE,QAAQ,QAAO,EAAI,OAAM;0BAEjC,EAAG,QAAQ,QAAO,EAAI,MAAK;mCAGxB,EAAG,QAAQ,CAAC,EAAE,MAChB;;;;;;;;IAsCA,MAAM,OAAO,eAAgB,SAAQ,oBAgBnC;KAAG;;;;;;;;;IAEL,MAAM,OAAO,UAAW,SAAQ,eAK9B;KAAG;;CACN;AAUD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,eAAO,MAAM,QAAQ,WAAY,OAAO,KAAG,MAAM,IAAI,UAA4D,CAAC;AAElH,eAAO,MAAM,YAAY,UAAiB;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,wBAG9G,CAAC"}

package/dist/types/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"version":"5.7.3"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-kanban",
-  "version": "0.7.4",
+  "version": "0.7.5-labs.401163d",
   "description": "Kanban DXOS Surface plugin",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -13,11 +13,6 @@
       "browser": "./dist/lib/browser/index.mjs",
       "node": "./dist/lib/node-esm/index.mjs"
     },
-    "./meta": {
-      "types": "./dist/types/src/meta.d.ts",
-      "browser": "./dist/lib/browser/meta.mjs",
-      "node": "./dist/lib/node-esm/meta.mjs"
-    },
     "./types": {
       "types": "./dist/types/src/types/index.d.ts",
       "browser": "./dist/lib/browser/types/index.mjs",
@@ -27,9 +22,6 @@
   "types": "dist/types/src/index.d.ts",
   "typesVersions": {
     "*": {
-      "meta": [
-        "dist/types/src/meta.d.ts"
-      ],
       "types": [
         "dist/types/src/types/index.d.ts"
       ]
@@ -40,41 +32,43 @@
     "src"
   ],
   "dependencies": {
-    "@dnd-kit/core": "^6.0.5",
-    "@dnd-kit/modifiers": "^6.0.0",
-    "@dnd-kit/sortable": "^7.0.1",
-    "@dnd-kit/utilities": "^3.2.0",
     "@effect/schema": "^0.75.5",
     "@preact/signals-core": "^1.6.0",
-    "@dxos/app-framework": "0.7.4",
-    "@dxos/async": "0.7.4",
-    "@dxos/echo-schema": "0.7.4",
-    "@dxos/plugin-client": "0.7.4",
-    "@dxos/plugin-graph": "0.7.4",
-    "@dxos/live-object": "0.7.4",
-    "@dxos/plugin-space": "0.7.4",
-    "@dxos/react-client": "0.7.4",
-    "@dxos/react-ui-editor": "0.7.4",
-    "@dxos/util": "0.7.4"
+    "@dxos/app-framework": "0.7.5-labs.401163d",
+    "@dxos/assistant": "0.7.5-labs.401163d",
+    "@dxos/artifact": "0.7.5-labs.401163d",
+    "@dxos/async": "0.7.5-labs.401163d",
+    "@dxos/effect": "0.7.5-labs.401163d",
+    "@dxos/invariant": "0.7.5-labs.401163d",
+    "@dxos/plugin-client": "0.7.5-labs.401163d",
+    "@dxos/echo-schema": "0.7.5-labs.401163d",
+    "@dxos/plugin-graph": "0.7.5-labs.401163d",
+    "@dxos/plugin-space": "0.7.5-labs.401163d",
+    "@dxos/plugin-search": "0.7.5-labs.401163d",
+    "@dxos/react-ui-form": "0.7.5-labs.401163d",
+    "@dxos/react-client": "0.7.5-labs.401163d",
+    "@dxos/random": "0.7.5-labs.401163d",
+    "@dxos/react-ui-kanban": "0.7.5-labs.401163d",
+    "@dxos/schema": "0.7.5-labs.401163d",
+    "@dxos/util": "0.7.5-labs.401163d",
+    "@dxos/react-ui-stack": "0.7.5-labs.401163d"
   },
   "devDependencies": {
-    "@phosphor-icons/react": "^2.1.5",
     "@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/random": "0.7.4",
-    "@dxos/react-ui": "0.7.4",
-    "@dxos/react-ui-theme": "0.7.4",
-    "@dxos/storybook-utils": "0.7.4"
+    "@dxos/react-ui-theme": "0.7.5-labs.401163d",
+    "@dxos/react-ui": "0.7.5-labs.401163d",
+    "@dxos/storybook-utils": "0.7.5-labs.401163d"
   },
   "peerDependencies": {
-    "@phosphor-icons/react": "^2.1.5",
+    "effect": "^3.12.3",
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.7.4",
-    "@dxos/react-ui-theme": "0.7.4"
+    "@dxos/react-ui": "0.7.5-labs.401163d",
+    "@dxos/react-ui-theme": "0.7.5-labs.401163d"
   },
   "publishConfig": {
     "access": "public"

package/src/KanbanPlugin.tsx

@@ -2,110 +2,56 @@
 // Copyright 2023 DXOS.org
 //
 
-import React from 'react';
+import { createIntent, defineModule, contributes, Capabilities, Events, definePlugin } from '@dxos/app-framework';
+import { ClientCapabilities, ClientEvents } from '@dxos/plugin-client';
+import { type Space } from '@dxos/react-client/echo';
+import { KanbanType, translations as kanbanTranslations } from '@dxos/react-ui-kanban';
 
-import { resolvePlugin, type PluginDefinition, parseIntentPlugin, NavigationAction } from '@dxos/app-framework';
-import { create } from '@dxos/live-object';
-import { parseClientPlugin } from '@dxos/plugin-client';
-import { type ActionGroup, createExtension, isActionGroup } from '@dxos/plugin-graph';
-import { SpaceAction } from '@dxos/plugin-space';
-import { loadObjectReferences } from '@dxos/react-client/echo';
-
-import { KanbanMain } from './components';
-import meta, { KANBAN_PLUGIN } from './meta';
+import { Artifact, IntentResolver, ReactSurface } from './capabilities';
+import { KANBAN_PLUGIN, meta } from './meta';
 import translations from './translations';
-import { KanbanColumnType, KanbanItemType, KanbanType } from './types';
-import { KanbanAction, type KanbanPluginProvides } from './types';
+import { CreateKanbanSchema, type CreateKanbanType, KanbanAction } from './types';
 
-export const KanbanPlugin = (): PluginDefinition<KanbanPluginProvides> => {
-  return {
-    meta,
-    provides: {
-      metadata: {
-        records: {
-          [KanbanType.typename]: {
-            createObject: KanbanAction.CREATE,
+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: {
+            creationSchema: CreateKanbanSchema,
+            createObject: (props: CreateKanbanType, options: { space: Space }) =>
+              createIntent(KanbanAction.Create, { ...props, space: options.space }),
             placeholder: ['kanban title placeholder', { ns: KANBAN_PLUGIN }],
             icon: 'ph--kanban--regular',
-            // TODO(wittjosiah): Move out of metadata.
-            loadReferences: (kanban: KanbanType) => loadObjectReferences(kanban, (kanban) => kanban.columns),
-          },
-          [KanbanColumnType.typename]: {
-            // TODO(wittjosiah): Move out of metadata.
-            loadReferences: (column: KanbanColumnType) => loadObjectReferences(column, (column) => column.items),
-          },
-          [KanbanItemType.typename]: {
-            // TODO(wittjosiah): Move out of metadata.
-            loadReferences: (item: KanbanItemType) => [], // loadObjectReferences(item, (item) => item.object),
           },
-        },
-      },
-      echo: {
-        schema: [KanbanType],
-        system: [KanbanColumnType, KanbanItemType],
-      },
-      translations,
-      graph: {
-        builder: (plugins) => {
-          const client = resolvePlugin(plugins, parseClientPlugin)?.provides.client;
-          const dispatch = resolvePlugin(plugins, parseIntentPlugin)?.provides.intent.dispatch;
-          if (!client || !dispatch) {
-            return [];
-          }
-
-          return createExtension({
-            id: KanbanAction.CREATE,
-            filter: (node): node is ActionGroup => isActionGroup(node) && node.id.startsWith(SpaceAction.ADD_OBJECT),
-            actions: ({ node }) => {
-              const id = node.id.split('/').at(-1);
-              const [spaceId, objectId] = id?.split(':') ?? [];
-              const space = client.spaces.get().find((space) => space.id === spaceId);
-              const object = objectId && space?.db.getObjectById(objectId);
-              const target = objectId ? object : space;
-              if (!target) {
-                return;
-              }
-
-              return [
-                {
-                  id: `${KANBAN_PLUGIN}/create/${node.id}`,
-                  data: async () => {
-                    await dispatch([
-                      { plugin: KANBAN_PLUGIN, action: KanbanAction.CREATE },
-                      { action: SpaceAction.ADD_OBJECT, data: { target } },
-                      { action: NavigationAction.OPEN },
-                    ]);
-                  },
-                  properties: {
-                    label: ['create kanban label', { ns: KANBAN_PLUGIN }],
-                    icon: 'ph--kanban--regular',
-                    testId: 'kanbanPlugin.createObject',
-                  },
-                },
-              ];
-            },
-          });
-        },
-      },
-      surface: {
-        component: ({ data, role }) => {
-          switch (role) {
-            case 'main':
-              return data.active instanceof KanbanType ? <KanbanMain kanban={data.active} /> : null;
-            default:
-              return null;
-          }
-        },
-      },
-      intent: {
-        resolver: (intent) => {
-          switch (intent.action) {
-            case KanbanAction.CREATE: {
-              return { data: create(KanbanType, { columns: [] }) };
-            }
-          }
-        },
-      },
-    },
-  };
-};
+        }),
+    }),
+    defineModule({
+      id: `${meta.id}/module/schema`,
+      activatesOn: ClientEvents.SetupSchema,
+      activate: () => contributes(ClientCapabilities.Schema, [KanbanType]),
+    }),
+    defineModule({
+      id: `${meta.id}/module/react-surface`,
+      activatesOn: Events.SetupSurfaces,
+      activate: ReactSurface,
+    }),
+    defineModule({
+      id: `${meta.id}/module/intent-resolver`,
+      activatesOn: Events.SetupIntents,
+      activate: IntentResolver,
+    }),
+    defineModule({
+      id: `${meta.id}/module/artifact`,
+      activatesOn: Events.Startup,
+      activate: Artifact,
+    }),
+  ]);

package/src/capabilities/artifact.ts

@@ -0,0 +1,131 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { pipe } from 'effect';
+
+import { Capabilities, chain, contributes, createIntent, type PromiseIntentDispatcher } from '@dxos/app-framework';
+import { defineArtifact, defineTool, ToolResult } from '@dxos/artifact';
+import { createArtifactElement } from '@dxos/assistant';
+import { isInstanceOf, S } from '@dxos/echo-schema';
+import { invariant } from '@dxos/invariant';
+import { SpaceAction } from '@dxos/plugin-space/types';
+import { Filter, fullyQualifiedId, type Space } from '@dxos/react-client/echo';
+import { KanbanType } from '@dxos/react-ui-kanban';
+
+import { KanbanAction } from '../types';
+
+const QualifiedId = S.String.annotations({
+  description: 'The fully qualified ID of the kanban `spaceID:objectID`',
+});
+
+declare global {
+  interface ToolContextExtensions {
+    space?: Space;
+    dispatch?: PromiseIntentDispatcher;
+  }
+}
+
+export default () => {
+  const definition = defineArtifact({
+    id: 'plugin-kanban',
+    instructions: `
+        When working with kanban boards here are some additional 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: KanbanType,
+    tools: [
+      defineTool({
+        name: 'kanban_new',
+        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.`,
+        schema: S.Struct({
+          typename: S.String.annotations({
+            description: 'The fully qualified typename of the schema to use for the kanban cards.',
+          }),
+          pivotColumn: S.optional(S.String).annotations({
+            description: 'Optional field name to use as the column pivot.',
+          }),
+        }),
+        execute: async ({ typename, pivotColumn }, { extensions }) => {
+          invariant(extensions?.space, 'No space');
+          invariant(extensions?.dispatch, 'No intent dispatcher');
+
+          // Validate schema exists first
+          const schema = await extensions.space.db.schemaRegistry.query({ typename }).firstOrUndefined();
+          if (!schema) {
+            return ToolResult.Error(`Schema not found: ${typename}`);
+          }
+
+          const intent = pipe(
+            createIntent(KanbanAction.Create, {
+              space: extensions.space,
+              initialSchema: typename,
+              initialPivotColumn: pivotColumn,
+            }),
+            chain(SpaceAction.AddObject, { target: extensions.space }),
+          );
+
+          const { data, error } = await extensions.dispatch(intent);
+          if (!data || error) {
+            return ToolResult.Error(error?.message ?? 'Failed to create kanban board');
+          }
+
+          return ToolResult.Success(createArtifactElement(data.id));
+        },
+      }),
+      defineTool({
+        name: 'kanban_list',
+        description: 'List all kanban boards in the current space.',
+        schema: S.Struct({}),
+        execute: async (_input, { extensions }) => {
+          invariant(extensions?.space, 'No space');
+          const space = extensions.space;
+          const { objects: boards } = await space.db.query(Filter.schema(KanbanType)).run();
+
+          const boardInfo = await Promise.all(
+            boards.map(async (board: KanbanType) => {
+              const view = await board.cardView?.load();
+              return {
+                id: fullyQualifiedId(board),
+                typename: view?.query.type,
+              };
+            }),
+          );
+
+          return ToolResult.Success(boardInfo);
+        },
+      }),
+      defineTool({
+        name: 'kanban_inspect',
+        description: 'Get details about a specific kanban board.',
+        schema: S.Struct({ id: QualifiedId }),
+        execute: async ({ id }, { extensions }) => {
+          invariant(extensions?.space, 'No space');
+          const space = extensions.space;
+          const { objects: boards } = await space.db.query(Filter.schema(KanbanType)).run();
+          const board = boards.find((board: KanbanType) => fullyQualifiedId(board) === id);
+          invariant(isInstanceOf(KanbanType, board));
+
+          const view = await board.cardView?.load();
+          invariant(view);
+
+          const typename = view.query.type;
+          const schema = await space.db.schemaRegistry.query({ typename }).firstOrUndefined();
+          invariant(schema);
+
+          return ToolResult.Success({
+            schema,
+            columnField: board.columnFieldId,
+            viewFields: view.fields,
+          });
+        },
+      }),
+    ],
+  });
+
+  return contributes(Capabilities.ArtifactDefinition, definition);
+};

package/src/capabilities/index.ts

@@ -0,0 +1,9 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { lazy } from '@dxos/app-framework';
+
+export const Artifact = lazy(() => import('./artifact'));
+export const IntentResolver = lazy(() => import('./intent-resolver'));
+export const ReactSurface = lazy(() => import('./react-surface'));