@dxos/plugin-github 0.7.4 → 0.14.0

package/dx.config.ts

@@ -0,0 +1,39 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { Config2 } from '@dxos/app-framework/config';
+import { trim } from '@dxos/util';
+
+export default Config2.make({
+  plugin: {
+    key: 'org.dxos.plugin.github',
+    name: 'GitHub',
+    author: 'DXOS',
+    source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-github',
+    spec: 'PLUGIN.mdl',
+    description: trim`
+      Connect GitHub to your Composer workspace so organizations, repositories,
+      issues, and pull requests stay available alongside everything else you're
+      working on.
+
+      Authenticate with a GitHub OAuth App or GitHub App and select the
+      repositories you want to track.  On each sync pass the plugin pulls
+      organizations and their members into ECHO as Organization and Person
+      objects, and mirrors every repository as a Project and every issue or
+      pull request as a Task — with open mapping to "todo" and closed mapping
+      to "done".
+
+      Edits made locally to issue title, description, or open/closed status
+      are pushed back to GitHub via a snapshot-diff reconciliation step, so
+      changes flow in both directions.  Pull request status is deliberately
+      pull-only to avoid accidental closes; repo renames are similarly guarded.
+
+      All GitHub data is stored in ECHO and replicated to other peers in the
+      space, giving the whole team a shared, local-first view of the project
+      without requiring each member to hold their own GitHub token.
+    `,
+    icon: { key: 'ph--github-logo--regular', hue: 'purple' },
+    tags: ['labs', 'connector'],
+  },
+});

package/package.json

@@ -1,76 +1,195 @@
 {
   "name": "@dxos/plugin-github",
-  "version": "0.7.4",
-  "description": "DXOS Surface plugin for integrating with GitHub",
+  "version": "0.14.0",
+  "description": "DXOS plugin that integrates GitHub as a sync source via the generic Integration mechanism.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
-  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dxos/dxos"
+  },
+  "license": "FSL-1.1-Apache-2.0",
   "author": "DXOS.org",
-  "sideEffects": true,
+  "sideEffects": false,
+  "type": "module",
+  "imports": {
+    "#capabilities": {
+      "source": {
+        "workerd": "./src/capabilities/gen/workerd.ts",
+        "node": "./src/capabilities/gen/node.ts",
+        "tauri": "./src/capabilities/gen/tauri.ts",
+        "browser": "./src/capabilities/gen/browser.ts"
+      },
+      "types": "./dist/types/src/capabilities/index.d.ts",
+      "workerd": "./dist/lib/capabilities.workerd.mjs",
+      "node": "./dist/lib/capabilities.node.mjs",
+      "tauri": "./dist/lib/capabilities.tauri.mjs",
+      "browser": "./dist/lib/capabilities.browser.mjs"
+    },
+    "#meta": {
+      "source": "./src/meta.ts",
+      "types": "./dist/types/src/meta.d.ts",
+      "default": "./dist/lib/meta.mjs"
+    },
+    "#operations": {
+      "source": "./src/operations/index.ts",
+      "types": "./dist/types/src/operations/index.d.ts",
+      "default": "./dist/lib/operations.mjs"
+    },
+    "#plugin": {
+      "source": "./src/plugin.ts",
+      "types": "./dist/types/src/plugin.d.ts",
+      "default": "./dist/lib/plugin.mjs"
+    },
+    "#skills": {
+      "source": "./src/skills/index.ts",
+      "types": "./dist/types/src/skills/index.d.ts",
+      "default": "./dist/lib/skills.mjs"
+    },
+    "#translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "default": "./dist/lib/translations.mjs"
+    },
+    "#types": {
+      "source": "./src/types/index.ts",
+      "types": "./dist/types/src/types/index.d.ts",
+      "default": "./dist/lib/types.mjs"
+    }
+  },
   "exports": {
     ".": {
+      "source": "./src/index.ts",
       "types": "./dist/types/src/index.d.ts",
-      "browser": "./dist/lib/browser/index.mjs"
+      "import": "./dist/lib/index.mjs"
     },
-    "./meta": {
-      "types": "./dist/types/src/meta.d.ts",
-      "browser": "./dist/lib/browser/meta.mjs"
+    "./assets/PLUGIN.mdl": "./PLUGIN.mdl",
+    "./Extensions": {
+      "source": "./src/Extensions.ts",
+      "types": "./dist/types/src/Extensions.d.ts",
+      "import": "./dist/lib/ns/Extensions.mjs"
+    },
+    "./GitHubCapabilities": {
+      "source": "./src/types/GitHubCapabilities.ts",
+      "types": "./dist/types/src/types/GitHubCapabilities.d.ts",
+      "import": "./dist/lib/GitHubCapabilities.mjs"
+    },
+    "./GitHubEvents": {
+      "source": "./src/types/GitHubEvents.ts",
+      "types": "./dist/types/src/types/GitHubEvents.d.ts",
+      "import": "./dist/lib/GitHubEvents.mjs"
+    },
+    "./GitHubOperation": {
+      "source": "./src/types/GitHubOperation.ts",
+      "types": "./dist/types/src/types/GitHubOperation.d.ts",
+      "import": "./dist/lib/GitHubOperation.mjs"
+    },
+    "./GitHubPlugin": {
+      "source": "./src/GitHubPlugin.ts",
+      "types": "./dist/types/src/GitHubPlugin.d.ts",
+      "import": "./dist/lib/GitHubPlugin.mjs"
+    },
+    "./package.json": "./package.json",
+    "./testing": {
+      "source": "./src/testing/index.ts",
+      "types": "./dist/types/src/testing/index.d.ts",
+      "import": "./dist/lib/testing.mjs"
+    },
+    "./translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "import": "./dist/lib/translations.mjs"
+    },
+    "./Walkthrough": {
+      "source": "./src/types/Walkthrough.ts",
+      "types": "./dist/types/src/types/Walkthrough.d.ts",
+      "import": "./dist/lib/Walkthrough.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
   "typesVersions": {
     "*": {
-      "meta": [
-        "dist/types/src/meta.d.ts"
+      "GitHubEvents": [
+        "dist/types/src/types/GitHubEvents.d.ts"
+      ],
+      "GitHubOperation": [
+        "dist/types/src/types/GitHubOperation.d.ts"
+      ],
+      "GitHubCapabilities": [
+        "dist/types/src/types/GitHubCapabilities.d.ts"
+      ],
+      "Walkthrough": [
+        "dist/types/src/types/Walkthrough.d.ts"
       ]
     }
   },
   "files": [
     "dist",
-    "src"
+    "dx.config.ts",
+    "src",
+    "PLUGIN.mdl"
   ],
   "dependencies": {
-    "@preact/signals-core": "^1.6.0",
-    "dompurify": "^3.0.3",
-    "github-markdown-css": "^5.2.0",
-    "lodash.get": "^4.4.2",
-    "lodash.update": "^4.10.2",
-    "octokit": "^2.0.14",
-    "@dxos/app-framework": "0.7.4",
-    "@dxos/async": "0.7.4",
-    "@dxos/echo-schema": "0.7.4",
-    "@dxos/live-object": "0.7.4",
-    "@dxos/local-storage": "0.7.4",
-    "@dxos/log": "0.7.4",
-    "@dxos/plugin-client": "0.7.4",
-    "@dxos/plugin-graph": "0.7.4",
-    "@dxos/plugin-markdown": "0.7.4",
-    "@dxos/plugin-space": "0.7.4",
-    "@dxos/react-client": "0.7.4",
-    "@dxos/react-ui-editor": "0.7.4",
-    "@dxos/react-ui-form": "0.7.4",
-    "@dxos/util": "0.7.4"
+    "@codemirror/language": "^6.12.4",
+    "@codemirror/state": "^6.7.6",
+    "@codemirror/view": "^6.43.13",
+    "effect": "4.0.0",
+    "@dxos/ai": "0.14.0",
+    "@dxos/app-framework": "0.14.0",
+    "@dxos/app-graph": "0.14.0",
+    "@dxos/app-toolkit": "0.14.0",
+    "@dxos/compute": "0.14.0",
+    "@dxos/echo": "0.14.0",
+    "@dxos/echo-query": "0.14.0",
+    "@dxos/echo-react": "0.14.0",
+    "@dxos/effect": "0.14.0",
+    "@dxos/errors": "0.14.0",
+    "@dxos/graph": "0.14.0",
+    "@dxos/keys": "0.14.0",
+    "@dxos/link": "0.14.0",
+    "@dxos/lit-ui": "0.14.0",
+    "@dxos/log": "0.14.0",
+    "@dxos/plugin-connector": "0.14.0",
+    "@dxos/plugin-crx": "0.14.0",
+    "@dxos/plugin-markdown": "0.14.0",
+    "@dxos/plugin-preview": "0.14.0",
+    "@dxos/plugin-space": "0.14.0",
+    "@dxos/protocols": "0.14.0",
+    "@dxos/react-client": "0.14.0",
+    "@dxos/react-ui": "0.14.0",
+    "@dxos/react-ui-attention": "0.14.0",
+    "@dxos/react-ui-components": "0.14.0",
+    "@dxos/react-ui-editor": "0.14.0",
+    "@dxos/react-ui-form": "0.14.0",
+    "@dxos/react-ui-list": "0.14.0",
+    "@dxos/react-ui-markdown": "0.14.0",
+    "@dxos/react-ui-menu": "0.14.0",
+    "@dxos/react-ui-masonry": "0.14.0",
+    "@dxos/react-ui-query": "0.14.0",
+    "@dxos/types": "0.14.0",
+    "@dxos/ui-editor": "0.14.0",
+    "@dxos/ui-types": "0.14.0",
+    "@dxos/util": "0.14.0"
   },
   "devDependencies": {
-    "@phosphor-icons/react": "^2.1.5",
-    "@types/dompurify": "^3.0.2",
-    "@types/lodash.get": "^4.4.7",
-    "@types/lodash.update": "^4.10.7",
-    "@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/react-ui": "0.7.4",
-    "@dxos/react-ui-theme": "0.7.4",
-    "@dxos/storybook-utils": "0.7.4"
+    "@effect/atom-react": "4.0.0",
+    "@storybook/react-vite": "^10.6.0",
+    "@types/react": "~19.2.17",
+    "@types/react-dom": "~19.2.3",
+    "react": "~19.2.7",
+    "react-dom": "~19.2.7",
+    "vite": "^8.2.2",
+    "@dxos/echo-client": "0.14.0",
+    "@dxos/plugin-client": "0.14.0",
+    "@dxos/plugin-testing": "0.14.0",
+    "@dxos/random": "0.14.0",
+    "@dxos/react-ui-editor": "0.14.0"
   },
   "peerDependencies": {
-    "@phosphor-icons/react": "^2.1.5",
-    "react": "~18.2.0",
-    "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.7.4",
-    "@dxos/react-ui-theme": "0.7.4"
+    "@effect/atom-react": "4.0.0",
+    "effect": "4.0.0",
+    "react": "~19.2.7",
+    "react-dom": "~19.2.7"
   },
   "publishConfig": {
     "access": "public"

package/src/Extensions.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+// @import-as-namespace
+
+export * from './extensions/index.ts';

package/src/GitHubPlugin.ts

@@ -0,0 +1,15 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+// @import-as-namespace
+
+import * as Plugin from '@dxos/app-framework/Plugin';
+
+import { meta as pluginMeta } from '#meta';
+
+/** Plugin metadata, available without loading the plugin body. */
+export const meta = pluginMeta;
+
+/** Constructs the plugin; the body loads on first enable. */
+export const make = Plugin.lazy(meta, () => import('#plugin'));

package/src/GitHubPlugin.workerd.test.ts

@@ -0,0 +1,23 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { describe, test } from 'vitest';
+
+import { activateHeadlessPlugins } from '@dxos/app-toolkit/testing';
+import { Type } from '@dxos/echo';
+import { PullRequest } from '@dxos/types';
+
+import { GitHubOperation, Walkthrough } from '#types';
+
+import * as GitHubPlugin from './GitHubPlugin.ts';
+
+describe('GitHubPlugin in workerd', () => {
+  test('activates headless and contributes its operations and types', async ({ expect }) => {
+    const { failures, operationKeys, typenames } = await activateHeadlessPlugins([GitHubPlugin.make()]);
+    expect(failures).toEqual([]);
+    expect(operationKeys).toContain(String(GitHubOperation.ImportPullRequest.meta.key));
+    expect(typenames).toContain(Type.getTypename(PullRequest.PullRequest));
+    expect(typenames).toContain(Type.getTypename(Walkthrough.Walkthrough));
+  });
+});

package/src/approval.test.ts

@@ -0,0 +1,40 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as HttpClientError from 'effect/http/HttpClientError';
+import * as HttpClientRequest from 'effect/http/HttpClientRequest';
+import * as HttpClientResponse from 'effect/http/HttpClientResponse';
+import { describe, expect, test } from 'vitest';
+
+import { APPROVAL_MARKER, approvalCommentBody, isApprovalComment, isApprovalRefused } from './approval.ts';
+
+const statusError = (status: number) => {
+  const request = HttpClientRequest.post('https://api.github.com/repos/dxos/dxos/pulls/1/reviews');
+  return new HttpClientError.HttpClientError({
+    reason: new HttpClientError.StatusCodeError({
+      request,
+      response: HttpClientResponse.fromWeb(request, new Response(null, { status })),
+    }),
+  });
+};
+
+describe('approval fallback', () => {
+  test('the comment carries the marker, and the reviewer summary above it', () => {
+    expect(isApprovalComment(approvalCommentBody())).toBe(true);
+    expect(approvalCommentBody('Looks good.').startsWith('Looks good.')).toBe(true);
+    expect(approvalCommentBody('Looks good.').endsWith(APPROVAL_MARKER)).toBe(true);
+  });
+
+  test('an ordinary comment is not an approval', () => {
+    expect(isApprovalComment('Approved — good to land.')).toBe(false);
+  });
+
+  test('only a refusal to review falls back', () => {
+    expect(isApprovalRefused(statusError(422))).toBe(true);
+    expect(isApprovalRefused(statusError(403))).toBe(true);
+    // A rejected credential is the user's to fix and must surface as a failure.
+    expect(isApprovalRefused(statusError(401))).toBe(false);
+    expect(isApprovalRefused(new Error('offline'))).toBe(false);
+  });
+});

package/src/approval.ts

@@ -0,0 +1,39 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { GitHubApi } from './services/index.ts';
+
+/**
+ * Machine-readable marker carried by an approval posted as a comment.
+ *
+ * An HTML comment renders as nothing on GitHub, so the marker is invisible to a human reader while
+ * remaining an exact string for an agent polling the conversation — which is the point: a comment
+ * fallback has to be as detectable as the review state it stands in for.
+ */
+export const APPROVAL_MARKER = '<!-- dxos:approval state=approved -->';
+
+/** Prose shown above the marker; states why the approval is a comment rather than a review. */
+const APPROVAL_TEXT =
+  'Approved — good to land.\n\n' +
+  '_GitHub declined an approving review from this connection (a pull request cannot be approved by ' +
+  'its own author, and some tokens carry no review permission), so the approval is recorded here._';
+
+/** Body of the fallback comment: the reviewer's own summary, the standing text, and the marker. */
+export const approvalCommentBody = (body?: string): string =>
+  [body?.trim(), APPROVAL_TEXT, APPROVAL_MARKER].filter(Boolean).join('\n\n');
+
+/** Whether a comment body records an approval — the detector an agent runs over a PR's comments. */
+export const isApprovalComment = (body: string): boolean => body.includes(APPROVAL_MARKER);
+
+/**
+ * Whether an approving review failed for a reason a comment can stand in for.
+ *
+ * `422` is GitHub's answer to approving one's own pull request, `403` to a token without review
+ * permission on the repository. Anything else (a rejected credential, a deleted pull request, a
+ * network fault) is a real failure and must surface rather than turn into a comment.
+ */
+export const isApprovalRefused = (error: unknown): boolean => {
+  const status = GitHubApi.responseStatus(error);
+  return status === 403 || status === 422;
+};

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

@@ -0,0 +1,47 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import * as Capability from '@dxos/app-framework/Capability';
+import * as AppGraphBuilder from '@dxos/app-graph/AppGraphBuilder';
+import * as AppGraphNode from '@dxos/app-graph/AppGraphNode';
+import * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';
+import * as LayoutOperation from '@dxos/app-toolkit/LayoutOperation';
+import * as Operation from '@dxos/compute/Operation';
+import * as GraphNodeMatcher from '@dxos/graph/GraphNodeMatcher';
+
+import { IMPORT_PULL_REQUEST_DIALOG, meta } from '#meta';
+import { GitHubOperation } from '#types';
+
+/**
+ * Contributes "Import pull request" to the root, so the commands dialog carries it: a reviewer who
+ * has a link in hand should not have to sync a repository to read the change.
+ */
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    const extensions = yield* AppGraphBuilder.createExtension({
+      id: 'importPullRequest',
+      match: GraphNodeMatcher.whenRoot,
+      actions: () =>
+        Effect.succeed([
+          AppGraphNode.makeAction({
+            id: GitHubOperation.ImportPullRequest.meta.key,
+            data: Effect.fnUntraced(function* () {
+              yield* Operation.invoke(LayoutOperation.UpdateDialog, {
+                subject: IMPORT_PULL_REQUEST_DIALOG,
+                blockAlign: 'start',
+              });
+            }),
+            properties: {
+              label: ['import-pull-request.label', { ns: meta.profile.key }],
+              icon: 'ph--git-pull-request--regular',
+            },
+          }),
+        ]),
+    });
+
+    return Capability.contribute(AppCapabilities.AppGraphBuilder, extensions);
+  }),
+);

package/src/capabilities/connector.ts

@@ -0,0 +1,95 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+import * as Layer from 'effect/Layer';
+
+import * as Capability from '@dxos/app-framework/Capability';
+import * as Credential from '@dxos/compute/Credential';
+import { Obj } from '@dxos/echo';
+import * as ConnectorError from '@dxos/plugin-connector/ConnectorError';
+import * as ConnectorSpec from '@dxos/plugin-connector/ConnectorSpec';
+import { OAuthProvider } from '@dxos/protocols';
+
+import { GitHubOperation } from '#types';
+
+import { GITHUB_PROVIDER_ID, GITHUB_SOURCE } from '../constants.ts';
+import { GitHubApi } from '../services/index.ts';
+
+/**
+ * Service-specific token-created hook for GitHub.
+ *
+ * Calls GitHub's `/user` to populate `accessToken.account` with the
+ * authenticated user's login (falling back to email). Failures are elevated
+ * with {@link Effect.orDie}; plugin-connector logs defects from the runner
+ * and continues so a failed `/user` cannot block the Connection already
+ * created.
+ */
+const onTokenCreated: ConnectorSpec.OnTokenCreated = ({ accessToken }) =>
+  Effect.gen(function* () {
+    if (accessToken.account) {
+      return;
+    }
+    const token = yield* Credential.getApiKeyValue({ accessTokenId: accessToken.id });
+    const user = yield* GitHubApi.fetchUser().pipe(
+      Effect.provide(Layer.succeed(GitHubApi.GitHubCredentials, { token })),
+    );
+    Obj.update(accessToken, (accessToken) => {
+      accessToken.account = user.login ?? user.email;
+    });
+  }).pipe(Effect.orDie);
+
+/**
+ * GitHub `testConnection`: `GET /user` with the stored token. A rejected token
+ * (401/403 on a revoked grant) or transport failure surfaces as a user-facing
+ * error so the connection UI can offer to reauthenticate.
+ */
+const testConnection: ConnectorSpec.TestConnection = ({ accessToken }) =>
+  Effect.flatMap(Credential.getApiKeyValue({ accessTokenId: accessToken.id }), (token) =>
+    GitHubApi.fetchUser().pipe(Effect.provide(Layer.succeed(GitHubApi.GitHubCredentials, { token }))),
+  ).pipe(
+    Effect.asVoid,
+    Effect.mapError(
+      () =>
+        new ConnectorError.ConnectionTestError({
+          message: 'GitHub rejected the credential. Reauthenticate to continue syncing.',
+        }),
+    ),
+  );
+
+/**
+ * Contributes a single `ConnectorSpec.Connector` entry that wires GitHub's two operations,
+ * its target materializer, and the token-created hook to the `'github.com'`
+ * source. plugin-connector routes by `connectorId`.
+ *
+ * Sync targets are repositories, not organizations — orgs and their members
+ * are auto-pulled as a side effect of syncing any repo they own.
+ *
+ * `scopes` is intentionally empty: this is a GitHub *App* (not a classic
+ * OAuth App), so permissions are declared in the App's settings on github.com
+ * and OAuth scope strings are ignored on the user-authorization flow.
+ */
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    return Capability.contribute(ConnectorSpec.Connector, [
+      {
+        id: GITHUB_PROVIDER_ID,
+        source: GITHUB_SOURCE,
+        label: 'GitHub',
+        oauth: {
+          provider: OAuthProvider.GITHUB,
+          scopes: [],
+        },
+        sync: {
+          operation: GitHubOperation.SyncGitHubRepositories,
+          getTargets: GitHubOperation.GetGitHubRepositories,
+          materializeTarget: GitHubOperation.MaterializeGitHubTarget,
+          optionsSchema: GitHubOperation.SyncOptions,
+        },
+        onTokenCreated,
+        testConnection,
+      },
+    ]);
+  }),
+);

package/src/capabilities/gen/browser.ts

@@ -0,0 +1,82 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'browser' condition.
+
+import * as ActivationEvents from '@dxos/app-framework/ActivationEvents';
+import * as Capability from '@dxos/app-framework/Capability';
+import * as AppCapability from '@dxos/app-toolkit/AppCapability';
+import * as ConnectorEvents from '@dxos/plugin-connector/ConnectorEvents';
+import * as ConnectorSpec from '@dxos/plugin-connector/ConnectorSpec';
+import * as CrxCapabilities from '@dxos/plugin-crx/CrxCapabilities';
+import * as CrxEvents from '@dxos/plugin-crx/CrxEvents';
+import * as MarkdownCapabilities from '@dxos/plugin-markdown/MarkdownCapabilities';
+import * as MarkdownEvents from '@dxos/plugin-markdown/MarkdownEvents';
+import * as PreviewCapabilities from '@dxos/plugin-preview/PreviewCapabilities';
+import * as PreviewEvents from '@dxos/plugin-preview/PreviewEvents';
+
+import { meta } from '#meta';
+import { translations } from '#translations';
+
+import pluginSpec from '../../../PLUGIN.mdl?raw';
+
+export const Connector = Capability.lazyModule(
+  'GitHubConnector',
+  { provides: [ConnectorSpec.Connector], activatesOn: ConnectorEvents.Start },
+  () => import('../connector.ts'),
+);
+
+// Browser-only: the editor it decorates and the popover it answers render nowhere else.
+export const MarkdownExtension = Capability.lazyModule(
+  'MarkdownExtension',
+  {
+    provides: [MarkdownCapabilities.ExtensionProvider],
+    activatesOn: MarkdownEvents.Start,
+    environments: ['browser', 'tauri'],
+  },
+  () => import('../markdown-extension.ts'),
+);
+
+export const LinkResolver = Capability.lazyModule(
+  'LinkResolver',
+  {
+    provides: [PreviewCapabilities.LinkResolver],
+    activatesOn: PreviewEvents.Start,
+    environments: ['browser', 'tauri'],
+  },
+  () => import('../link-resolver.ts'),
+);
+
+// Narrower than the `appGraphBuilder` family default: the action opens a dialog, which means
+// nothing without an app shell.
+export const AppGraphBuilder = AppCapability.appGraphBuilder(() => import('../app-graph-builder.ts'), {
+  environments: ['browser', 'tauri'],
+});
+
+export const PageActionProvider = Capability.lazyModule(
+  'PageActionProvider',
+  { provides: [CrxCapabilities.PageAction], activatesOn: CrxEvents.Start },
+  () => import('../page-action.ts'),
+);
+
+export const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler.ts'), {
+  activatesOn: ActivationEvents.Idle,
+});
+
+export const Schema = AppCapability.schema(() => import('../schema.ts'));
+
+export const SkillDefinition = AppCapability.skillDefinition(() => import('../skill-definition.ts'));
+
+export const ReactSurface = AppCapability.surface(() => import('../react-surface.ts'), {
+  roles: ['org.dxos.role.cardContent', 'org.dxos.role.cardMenu', 'org.dxos.role.article', 'org.dxos.role.dialog'],
+});
+
+export const PluginAsset = AppCapability.pluginAsset({
+  pluginId: meta.profile.key,
+  path: 'PLUGIN.mdl',
+  content: pluginSpec,
+  mimeType: 'application/x-mdl',
+});
+
+export const Translations = AppCapability.translations(translations);