@dxos/plugin-markdown 0.7.5-main.499c70c → 0.7.5-main.5ae2ba8

package/package.json

@@ -1,23 +1,19 @@
 {
   "name": "@dxos/plugin-markdown",
-  "version": "0.7.5-main.499c70c",
+  "version": "0.7.5-main.5ae2ba8",
   "description": "DXOS Surface plugin for interacting with Markdown",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
   "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"
     },
-    "./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 +23,6 @@
   "types": "dist/types/src/index.d.ts",
   "typesVersions": {
     "*": {
-      "meta": [
-        "dist/types/src/meta.d.ts"
-      ],
       "types": [
         "dist/types/src/types/index.d.ts"
       ]
@@ -44,29 +37,31 @@
     "@codemirror/view": "^6.34.1",
     "@effect/schema": "^0.75.5",
     "@preact/signals-core": "^1.6.0",
-    "effect": "^3.9.2",
-    "@dxos/app-framework": "0.7.5-main.499c70c",
-    "@dxos/echo-schema": "0.7.5-main.499c70c",
-    "@dxos/invariant": "0.7.5-main.499c70c",
-    "@dxos/async": "0.7.5-main.499c70c",
-    "@dxos/keys": "0.7.5-main.499c70c",
-    "@dxos/log": "0.7.5-main.499c70c",
-    "@dxos/plugin-attention": "0.7.5-main.499c70c",
-    "@dxos/live-object": "0.7.5-main.499c70c",
-    "@dxos/local-storage": "0.7.5-main.499c70c",
-    "@dxos/plugin-client": "0.7.5-main.499c70c",
-    "@dxos/plugin-graph": "0.7.5-main.499c70c",
-    "@dxos/plugin-theme": "0.7.5-main.499c70c",
-    "@dxos/react-client": "0.7.5-main.499c70c",
-    "@dxos/react-ui-attention": "0.7.5-main.499c70c",
-    "@dxos/plugin-space": "0.7.5-main.499c70c",
-    "@dxos/react-ui-card": "0.7.5-main.499c70c",
-    "@dxos/react-hooks": "0.7.5-main.499c70c",
-    "@dxos/react-ui-editor": "0.7.5-main.499c70c",
-    "@dxos/react-ui-form": "0.7.5-main.499c70c",
-    "@dxos/react-ui-mosaic": "0.7.5-main.499c70c",
-    "@dxos/react-ui-stack": "0.7.5-main.499c70c",
-    "@dxos/util": "0.7.5-main.499c70c"
+    "effect": "^3.12.3",
+    "react-dropzone": "^14.2.3",
+    "@dxos/app-framework": "0.7.5-main.5ae2ba8",
+    "@dxos/artifact": "0.7.5-main.5ae2ba8",
+    "@dxos/echo-schema": "0.7.5-main.5ae2ba8",
+    "@dxos/async": "0.7.5-main.5ae2ba8",
+    "@dxos/keys": "0.7.5-main.5ae2ba8",
+    "@dxos/live-object": "0.7.5-main.5ae2ba8",
+    "@dxos/invariant": "0.7.5-main.5ae2ba8",
+    "@dxos/local-storage": "0.7.5-main.5ae2ba8",
+    "@dxos/log": "0.7.5-main.5ae2ba8",
+    "@dxos/plugin-client": "0.7.5-main.5ae2ba8",
+    "@dxos/plugin-attention": "0.7.5-main.5ae2ba8",
+    "@dxos/plugin-graph": "0.7.5-main.5ae2ba8",
+    "@dxos/plugin-theme": "0.7.5-main.5ae2ba8",
+    "@dxos/plugin-space": "0.7.5-main.5ae2ba8",
+    "@dxos/react-hooks": "0.7.5-main.5ae2ba8",
+    "@dxos/react-client": "0.7.5-main.5ae2ba8",
+    "@dxos/react-ui-card": "0.7.5-main.5ae2ba8",
+    "@dxos/react-ui-attention": "0.7.5-main.5ae2ba8",
+    "@dxos/react-ui-editor": "0.7.5-main.5ae2ba8",
+    "@dxos/react-ui-form": "0.7.5-main.5ae2ba8",
+    "@dxos/schema": "0.7.5-main.5ae2ba8",
+    "@dxos/react-ui-stack": "0.7.5-main.5ae2ba8",
+    "@dxos/util": "0.7.5-main.5ae2ba8"
   },
   "devDependencies": {
     "@phosphor-icons/react": "^2.1.5",
@@ -75,17 +70,18 @@
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
     "vite": "5.4.7",
-    "@dxos/react-ui": "0.7.5-main.499c70c",
-    "@dxos/random": "0.7.5-main.499c70c",
-    "@dxos/react-ui-theme": "0.7.5-main.499c70c",
-    "@dxos/storybook-utils": "0.7.5-main.499c70c"
+    "@dxos/debug": "0.7.5-main.5ae2ba8",
+    "@dxos/react-ui": "0.7.5-main.5ae2ba8",
+    "@dxos/storybook-utils": "0.7.5-main.5ae2ba8",
+    "@dxos/random": "0.7.5-main.5ae2ba8",
+    "@dxos/react-ui-theme": "0.7.5-main.5ae2ba8"
   },
   "peerDependencies": {
     "@phosphor-icons/react": "^2.1.5",
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.7.5-main.499c70c",
-    "@dxos/react-ui-theme": "0.7.5-main.499c70c"
+    "@dxos/react-ui": "0.7.5-main.5ae2ba8",
+    "@dxos/react-ui-theme": "0.7.5-main.5ae2ba8"
   },
   "publishConfig": {
     "access": "public"

package/src/MarkdownPlugin.tsx

@@ -1,86 +1,58 @@
 //
-// Copyright 2023 DXOS.org
+// Copyright 2025 DXOS.org
 //
 
-import { pipe } from 'effect';
-import React from 'react';
+import { Capabilities, contributes, createIntent, defineModule, definePlugin, Events } from '@dxos/app-framework';
+import { type BaseObject } from '@dxos/echo-schema';
+import { RefArray } from '@dxos/live-object';
+import { ClientCapabilities, ClientEvents } from '@dxos/plugin-client';
+import { SpaceCapabilities, ThreadEvents } from '@dxos/plugin-space';
+import { defineObjectForm } from '@dxos/plugin-space/types';
+import { translations as editorTranslations } from '@dxos/react-ui-editor';
+import { TextType } from '@dxos/schema';
 
 import {
-  parseIntentPlugin,
-  resolvePlugin,
-  type PluginDefinition,
-  createSurface,
-  createResolver,
-  createIntent,
-  chain,
-} from '@dxos/app-framework';
-import type { BaseObject } from '@dxos/echo-schema';
-import { create, makeRef, RefArray } from '@dxos/live-object';
-import { LocalStorageStore } from '@dxos/local-storage';
-import { SpaceAction } from '@dxos/plugin-space';
-import { CollectionType } from '@dxos/plugin-space/types';
-import { createDocAccessor, fullyQualifiedId, getRangeFromCursor, isSpace } from '@dxos/react-client/echo';
-import {
-  type EditorInputMode,
-  type EditorViewMode,
-  translations as editorTranslations,
-  createEditorStateStore,
-} from '@dxos/react-ui-editor';
-
-import { MarkdownContainer, MarkdownSettings } from './components';
-import meta, { MARKDOWN_PLUGIN } from './meta';
+  MarkdownState,
+  MarkdownSettings,
+  ReactSurface,
+  IntentResolver,
+  AppGraphSerializer,
+  Thread,
+  ArtifactDefinition,
+} from './capabilities';
+import { MarkdownEvents } from './events';
+import { MARKDOWN_PLUGIN, meta } from './meta';
 import translations from './translations';
-import { DocumentType, isEditorModel, TextType } from './types';
-import {
-  type MarkdownPluginProvides,
-  type MarkdownSettingsProps,
-  MarkdownAction,
-  type MarkdownPluginState,
-} from './types';
-import { markdownExtensionPlugins, serializer } from './util';
-
-export const MarkdownPlugin = (): PluginDefinition<MarkdownPluginProvides> => {
-  const settings = new LocalStorageStore<MarkdownSettingsProps>(MARKDOWN_PLUGIN, {
-    defaultViewMode: 'preview',
-    toolbar: true,
-    numberedHeadings: true,
-    folding: true,
-    experimental: false,
-  });
-
-  const editorStateStore = createEditorStateStore(`${MARKDOWN_PLUGIN}/editor`);
-
-  const state = new LocalStorageStore<MarkdownPluginState>(MARKDOWN_PLUGIN, { extensionProviders: [], viewMode: {} });
-
-  const getViewMode = (id: string) => (id && state.values.viewMode[id]) || settings.values.defaultViewMode;
-  const setViewMode = (id: string, viewMode: EditorViewMode) => (state.values.viewMode[id] = viewMode);
-
-  return {
-    meta,
-    ready: async ({ plugins }) => {
-      settings
-        .prop({ key: 'defaultViewMode', type: LocalStorageStore.enum<EditorViewMode>() })
-        .prop({ key: 'editorInputMode', type: LocalStorageStore.enum<EditorInputMode>({ allowUndefined: true }) })
-        .prop({ key: 'toolbar', type: LocalStorageStore.bool({ allowUndefined: true }) })
-        .prop({ key: 'experimental', type: LocalStorageStore.bool({ allowUndefined: true }) })
-        .prop({ key: 'debug', type: LocalStorageStore.bool({ allowUndefined: true }) })
-        .prop({ key: 'typewriter', type: LocalStorageStore.string({ allowUndefined: true }) })
-        .prop({ key: 'numberedHeadings', type: LocalStorageStore.bool({ allowUndefined: true }) })
-        .prop({ key: 'folding', type: LocalStorageStore.bool({ allowUndefined: true }) });
-
-      state.prop({ key: 'viewMode', type: LocalStorageStore.json<{ [key: string]: EditorViewMode }>() });
-
-      markdownExtensionPlugins(plugins).forEach((plugin) => {
-        const { extensions } = plugin.provides.markdown;
-        state.values.extensionProviders?.push(extensions);
-      });
-    },
-    provides: {
-      settings: settings.values,
-      metadata: {
-        records: {
-          [DocumentType.typename]: {
-            createObject: (props: { name?: string }) => createIntent(MarkdownAction.Create, props),
+import { DocumentType, MarkdownAction } from './types';
+import { serializer } from './util';
+
+export const MarkdownPlugin = () =>
+  definePlugin(meta, [
+    defineModule({
+      id: `${meta.id}/module/translations`,
+      activatesOn: Events.SetupTranslations,
+      activate: () => contributes(Capabilities.Translations, [...translations, ...editorTranslations]),
+    }),
+    defineModule({
+      id: `${meta.id}/module/settings`,
+      activatesOn: Events.SetupSettings,
+      activate: MarkdownSettings,
+    }),
+    defineModule({
+      id: `${meta.id}/module/state`,
+      // TODO(wittjosiah): Does not integrate with settings store.
+      //   Should this be a different event?
+      //   Should settings store be renamed to be more generic?
+      activatesOn: Events.SetupSettings,
+      activate: MarkdownState,
+    }),
+    defineModule({
+      id: `${meta.id}/module/metadata`,
+      activatesOn: Events.SetupMetadata,
+      activate: () =>
+        contributes(Capabilities.Metadata, {
+          id: DocumentType.typename,
+          metadata: {
             label: (object: any) => (object instanceof DocumentType ? object.name || object.fallbackName : undefined),
             placeholder: ['document title placeholder', { ns: MARKDOWN_PLUGIN }],
             icon: 'ph--text-aa--regular',
@@ -92,142 +64,50 @@ export const MarkdownPlugin = (): PluginDefinition<MarkdownPluginProvides> => {
               await RefArray.loadAll<BaseObject>([doc.content, ...doc.threads]),
             serializer,
           },
-        },
-      },
-      translations: [...translations, ...editorTranslations],
-      echo: {
-        schema: [DocumentType],
-        system: [TextType],
-      },
-      graph: {
-        serializer: (plugins) => {
-          const dispatch = resolvePlugin(plugins, parseIntentPlugin)?.provides.intent.dispatchPromise;
-          if (!dispatch) {
-            return [];
-          }
-
-          return [
-            {
-              inputType: DocumentType.typename,
-              outputType: 'text/markdown',
-              // Reconcile with metadata serializers.
-              serialize: async (node) => {
-                const doc = node.data;
-                const content = await doc.content.load();
-                return {
-                  name:
-                    doc.name ||
-                    doc.fallbackName ||
-                    translations[0]['en-US'][MARKDOWN_PLUGIN]['document title placeholder'],
-                  data: content.content,
-                  type: 'text/markdown',
-                };
-              },
-              deserialize: async (data, ancestors) => {
-                const space = ancestors.find(isSpace);
-                const target =
-                  ancestors.findLast((ancestor) => ancestor instanceof CollectionType) ??
-                  space?.properties[CollectionType.typename]?.target;
-                if (!space || !target) {
-                  return;
-                }
-
-                const result = await dispatch(
-                  pipe(
-                    createIntent(MarkdownAction.Create, { name: data.name, content: data.data }),
-                    chain(SpaceAction.AddObject, { target }),
-                  ),
-                );
-
-                return result.data?.object;
-              },
-            },
-          ];
-        },
-      },
-      thread: {
-        predicate: (obj) => obj instanceof DocumentType,
-        createSort: (doc: DocumentType) => {
-          const accessor = doc.content.target ? createDocAccessor(doc.content.target, ['content']) : undefined;
-          if (!accessor) {
-            return (_) => 0;
-          }
-
-          const getStartPosition = (cursor: string | undefined) => {
-            const range = cursor ? getRangeFromCursor(accessor, cursor) : undefined;
-            return range?.start ?? Number.MAX_SAFE_INTEGER;
-          };
-
-          return (anchorA: string | undefined, anchorB: string | undefined): number => {
-            if (anchorA === undefined || anchorB === undefined) {
-              return 0;
-            }
-            const posA = getStartPosition(anchorA);
-            const posB = getStartPosition(anchorB);
-            return posA - posB;
-          };
-        },
-      },
-      surface: {
-        definitions: () => [
-          createSurface({
-            id: `${MARKDOWN_PLUGIN}/document`,
-            role: ['article', 'section'],
-            filter: (data): data is { subject: DocumentType } => data.subject instanceof DocumentType,
-            component: ({ data, role }) => (
-              <MarkdownContainer
-                id={fullyQualifiedId(data.subject)}
-                object={data.subject}
-                role={role}
-                settings={settings.values}
-                extensionProviders={state.values.extensionProviders}
-                viewMode={getViewMode(fullyQualifiedId(data.subject))}
-                editorStateStore={editorStateStore}
-                onViewModeChange={setViewMode}
-              />
-            ),
-          }),
-          createSurface({
-            id: `${MARKDOWN_PLUGIN}/editor`,
-            role: ['article', 'section'],
-            filter: (data): data is { subject: { id: string; text: string } } => isEditorModel(data.subject),
-            component: ({ data, role }) => (
-              <MarkdownContainer
-                id={data.subject.id}
-                object={data.subject}
-                role={role}
-                settings={settings.values}
-                extensionProviders={state.values.extensionProviders}
-                viewMode={getViewMode(data.subject.id)}
-                editorStateStore={editorStateStore}
-                onViewModeChange={setViewMode}
-              />
-            ),
-          }),
-          createSurface({
-            id: `${MARKDOWN_PLUGIN}/settings`,
-            role: 'settings',
-            filter: (data): data is any => data.subject === MARKDOWN_PLUGIN,
-            component: () => <MarkdownSettings settings={settings.values} />,
-          }),
-        ],
-      },
-      intent: {
-        resolvers: () => [
-          createResolver(MarkdownAction.Create, ({ name, content }) => {
-            const doc = create(DocumentType, {
-              name,
-              content: makeRef(create(TextType, { content: content ?? '' })),
-              threads: [],
-            });
-
-            return { data: { object: doc } };
-          }),
-          createResolver(MarkdownAction.SetViewMode, ({ id, viewMode }) => {
-            state.values.viewMode[id] = viewMode;
+        }),
+    }),
+    defineModule({
+      id: `${meta.id}/module/object-form`,
+      activatesOn: ClientEvents.SetupSchema,
+      activate: () =>
+        contributes(
+          SpaceCapabilities.ObjectForm,
+          defineObjectForm({
+            objectSchema: DocumentType,
+            getIntent: () => createIntent(MarkdownAction.Create),
           }),
-        ],
-      },
-    },
-  };
-};
+        ),
+    }),
+    defineModule({
+      id: `${meta.id}/module/schema`,
+      activatesOn: ClientEvents.SetupSchema,
+      activate: () => contributes(ClientCapabilities.Schema, [TextType]),
+    }),
+    defineModule({
+      id: `${meta.id}/module/react-surface`,
+      activatesOn: Events.SetupReactSurface,
+      // TODO(wittjosiah): Should occur before the editor is loaded when surfaces activation is more granular.
+      activatesBefore: [MarkdownEvents.SetupExtensions],
+      activate: ReactSurface,
+    }),
+    defineModule({
+      id: `${meta.id}/module/intent-resolver`,
+      activatesOn: Events.SetupIntentResolver,
+      activate: IntentResolver,
+    }),
+    defineModule({
+      id: `${meta.id}/module/app-graph-serializer`,
+      activatesOn: Events.AppGraphReady,
+      activate: AppGraphSerializer,
+    }),
+    defineModule({
+      id: `${meta.id}/module/thread`,
+      activatesOn: ThreadEvents.SetupThread,
+      activate: Thread,
+    }),
+    defineModule({
+      id: `${meta.id}/module/artifact-definition`,
+      activatesOn: Events.SetupArtifactDefinition,
+      activate: ArtifactDefinition,
+    }),
+  ]);

package/src/capabilities/app-graph-serializer.ts

@@ -0,0 +1,50 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { pipe } from 'effect';
+
+import { contributes, Capabilities, type PluginsContext, chain, createIntent } from '@dxos/app-framework';
+import { SpaceAction, CollectionType } from '@dxos/plugin-space/types';
+import { isSpace } from '@dxos/react-client/echo';
+
+import { MARKDOWN_PLUGIN } from '../meta';
+import translations from '../translations';
+import { MarkdownAction, DocumentType } from '../types';
+
+export default (context: PluginsContext) =>
+  contributes(Capabilities.AppGraphSerializer, [
+    {
+      inputType: DocumentType.typename,
+      outputType: 'text/markdown',
+      // Reconcile with metadata serializers.
+      serialize: async (node) => {
+        const doc = node.data;
+        const content = await doc.content.load();
+        return {
+          name: doc.name || doc.fallbackName || translations[0]['en-US'][MARKDOWN_PLUGIN]['document title placeholder'],
+          data: content.content,
+          type: 'text/markdown',
+        };
+      },
+      deserialize: async (data, ancestors) => {
+        const space = ancestors.find(isSpace);
+        const target =
+          ancestors.findLast((ancestor) => ancestor instanceof CollectionType) ??
+          space?.properties[CollectionType.typename]?.target;
+        if (!space || !target) {
+          return;
+        }
+
+        const { dispatchPromise: dispatch } = context.requestCapability(Capabilities.IntentDispatcher);
+        const result = await dispatch(
+          pipe(
+            createIntent(MarkdownAction.Create, { name: data.name, content: data.data }),
+            chain(SpaceAction.AddObject, { target }),
+          ),
+        );
+
+        return result.data?.object;
+      },
+    },
+  ]);

package/src/capabilities/artifact-definition.ts

@@ -0,0 +1,85 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capabilities, contributes, type PromiseIntentDispatcher } from '@dxos/app-framework';
+import { defineArtifact, defineTool, ToolResult } from '@dxos/artifact';
+import { isInstanceOf, S } from '@dxos/echo-schema';
+import { invariant } from '@dxos/invariant';
+import { fullyQualifiedId, Filter, type Space } from '@dxos/react-client/echo';
+
+import { meta } from '../meta';
+import { DocumentType } from '../types';
+
+// TODO(burdon): Factor out.
+declare global {
+  interface ToolContextExtensions {
+    space?: Space;
+    dispatch?: PromiseIntentDispatcher;
+  }
+}
+
+export default () => {
+  const definition = defineArtifact({
+    id: meta.id,
+    name: meta.name,
+    instructions: `
+      - The markdown plugin allows you to work with text documents in the current space.
+      - Use these tools to interact with documents, including listing available documents and retrieving their content.
+      - Documents are stored in Markdown format.
+    `,
+    schema: DocumentType,
+    tools: [
+      defineTool(meta.id, {
+        name: 'list',
+        description: 'List all markdown documents in the current space.',
+        caption: 'Listing markdown documents...',
+        schema: S.Struct({}),
+        execute: async (_input, { extensions }) => {
+          invariant(extensions?.space, 'No space');
+          const space = extensions.space;
+          const { objects: documents } = await space.db.query(Filter.schema(DocumentType)).run();
+          const documentInfo = documents.map((doc) => {
+            invariant(isInstanceOf(DocumentType, doc));
+            return {
+              id: fullyQualifiedId(doc),
+              name: doc.name || doc.fallbackName || 'Unnamed Document',
+              // TODO(ZaymonFC): Include updatedAt?
+            };
+          });
+
+          return ToolResult.Success(documentInfo);
+        },
+      }),
+      defineTool(meta.id, {
+        name: 'inspect',
+        description: 'Read the content of a markdown document.',
+        caption: 'Inspecting markdown document...',
+        schema: S.Struct({
+          id: S.String.annotations({
+            description: 'The fully qualified ID of the document `spaceID:objectID`',
+          }),
+        }),
+        execute: async ({ id }, { extensions }) => {
+          invariant(extensions?.space, 'No space');
+          const space = extensions.space;
+          const { objects: documents } = await space.db.query(Filter.schema(DocumentType)).run();
+          const document = documents.find((doc) => fullyQualifiedId(doc) === id);
+          if (!document) {
+            return ToolResult.Error(`Document not found: ${id}`);
+          }
+
+          invariant(isInstanceOf(DocumentType, document));
+          const { content } = await document.content?.load();
+          return ToolResult.Success({
+            id: fullyQualifiedId(document),
+            name: document.name || document.fallbackName || 'Unnamed Document',
+            content,
+          });
+        },
+      }),
+    ],
+  });
+
+  return contributes(Capabilities.ArtifactDefinition, definition);
+};

package/src/capabilities/capabilities.ts

@@ -0,0 +1,20 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { defineCapability } from '@dxos/app-framework';
+import { type EditorViewMode, type EditorStateStore } from '@dxos/react-ui-editor';
+
+import { MARKDOWN_PLUGIN } from '../meta';
+import { type MarkdownExtensionProvider, type MarkdownPluginState } from '../types';
+
+export namespace MarkdownCapabilities {
+  export const State = defineCapability<{
+    state: MarkdownPluginState;
+    editorState: EditorStateStore;
+    getViewMode: (id: string) => EditorViewMode;
+    setViewMode: (id: string, viewMode: EditorViewMode) => void;
+  }>(`${MARKDOWN_PLUGIN}/capability/state`);
+
+  export const Extensions = defineCapability<MarkdownExtensionProvider[]>(`${MARKDOWN_PLUGIN}/capability/extensions`);
+}

package/src/capabilities/index.ts

@@ -0,0 +1,15 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { lazy } from '@dxos/app-framework';
+
+export const AppGraphSerializer = lazy(() => import('./app-graph-serializer'));
+export const ArtifactDefinition = lazy(() => import('./artifact-definition'));
+export const IntentResolver = lazy(() => import('./intent-resolver'));
+export const ReactSurface = lazy(() => import('./react-surface'));
+export const MarkdownSettings = lazy(() => import('./settings'));
+export const MarkdownState = lazy(() => import('./state'));
+export const Thread = lazy(() => import('./thread'));
+
+export * from './capabilities';

package/src/capabilities/intent-resolver.ts

@@ -0,0 +1,33 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capabilities, contributes, createResolver, type PluginsContext } from '@dxos/app-framework';
+import { makeRef, create } from '@dxos/live-object';
+import { TextType } from '@dxos/schema';
+
+import { MarkdownCapabilities } from './capabilities';
+import { DocumentType, MarkdownAction } from '../types';
+
+export default (context: PluginsContext) =>
+  contributes(Capabilities.IntentResolver, [
+    createResolver({
+      intent: MarkdownAction.Create,
+      resolve: ({ name, content }) => {
+        const doc = create(DocumentType, {
+          name,
+          content: makeRef(create(TextType, { content: content ?? '' })),
+          threads: [],
+        });
+
+        return { data: { object: doc } };
+      },
+    }),
+    createResolver({
+      intent: MarkdownAction.SetViewMode,
+      resolve: ({ id, viewMode }) => {
+        const { state } = context.requestCapability(MarkdownCapabilities.State);
+        state.viewMode[id] = viewMode;
+      },
+    }),
+  ]);