@dxos/plugin-assistant 0.8.4-main.67995b8 → 0.8.4-main.69d29f4

package/package.json

@@ -1,30 +1,44 @@
 {
   "name": "@dxos/plugin-assistant",
-  "version": "0.8.4-main.67995b8",
+  "version": "0.8.4-main.69d29f4",
   "description": "Assistant 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": {
     ".": {
+      "source": "./src/index.ts",
       "types": "./dist/types/src/index.d.ts",
       "browser": "./dist/lib/browser/index.mjs",
-      "node": "./dist/lib/node-esm/index.mjs",
-      "source": "./src/index.ts"
+      "node": "./dist/lib/node-esm/index.mjs"
+    },
+    "./blueprints": {
+      "source": "./src/blueprints/index.ts",
+      "types": "./dist/types/src/blueprints/index.d.ts",
+      "browser": "./dist/lib/browser/blueprints/index.mjs",
+      "node": "./dist/lib/node-esm/blueprints/index.mjs",
+      "default": "./src/blueprints/index.ts"
     },
     "./types": {
+      "source": "./src/types/index.ts",
       "types": "./dist/types/src/types/index.d.ts",
       "browser": "./dist/lib/browser/types/index.mjs",
-      "node": "./dist/lib/node-esm/types/index.mjs",
-      "source": "./src/types/index.ts"
+      "node": "./dist/lib/node-esm/types/index.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
   "typesVersions": {
     "*": {
+      "blueprints": [
+        "dist/types/src/blueprints/index.d.ts"
+      ],
       "types": [
         "dist/types/src/types/index.d.ts"
       ]
@@ -36,114 +50,124 @@
     "src"
   ],
   "dependencies": {
-    "@codemirror/autocomplete": "^6.18.1",
-    "@codemirror/language": "^6.10.3",
-    "@codemirror/search": "^6.5.6",
-    "@codemirror/state": "^6.4.1",
-    "@codemirror/view": "^6.34.1",
-    "@effect/ai": "0.23.0",
-    "@lezer/highlight": "^1.2.1",
-    "@preact-signals/safe-react": "^0.9.0",
-    "@preact/signals-core": "^1.9.0",
-    "@preact/signals-react": "^3.2.0",
+    "@codemirror/autocomplete": "^6.19.0",
+    "@codemirror/lang-html": "^6.4.11",
+    "@codemirror/lang-markdown": "6.3.4",
+    "@codemirror/lang-xml": "^6.1.0",
+    "@codemirror/language": "^6.11.3",
+    "@codemirror/lint": "6.8.5",
+    "@codemirror/state": "^6.5.2",
+    "@codemirror/view": "^6.38.4",
+    "@effect-atom/atom": "^0.4.13",
+    "@effect-atom/atom-react": "^0.4.6",
+    "@effect/ai": "0.32.1",
+    "@effect/ai-anthropic": "0.22.0",
+    "@effect/ai-openai": "0.36.0",
+    "@effect/experimental": "0.57.11",
+    "@effect/platform-browser": "0.73.0",
     "@radix-ui/react-context": "1.1.1",
-    "@xiechao/codemirror-lang-handlebars": "1.0.4",
-    "effect": "3.17.0",
+    "effect": "3.19.11",
     "exa-js": "^1.5.12",
     "json5": "^2.2.3",
     "jsonpointer": "^5.0.1",
     "lodash.defaultsdeep": "^4.6.1",
     "unified": "^11.0.0",
     "use-deep-compare-effect": "^1.8.1",
-    "@dxos/ai": "0.8.4-main.67995b8",
-    "@dxos/app-framework": "0.8.4-main.67995b8",
-    "@dxos/assistant": "0.8.4-main.67995b8",
-    "@dxos/blueprints": "0.8.4-main.67995b8",
-    "@dxos/client": "0.8.4-main.67995b8",
-    "@dxos/async": "0.8.4-main.67995b8",
-    "@dxos/compute": "0.8.4-main.67995b8",
-    "@dxos/conductor": "0.8.4-main.67995b8",
-    "@dxos/config": "0.8.4-main.67995b8",
-    "@dxos/context": "0.8.4-main.67995b8",
-    "@dxos/devtools": "0.8.4-main.67995b8",
-    "@dxos/debug": "0.8.4-main.67995b8",
-    "@dxos/echo": "0.8.4-main.67995b8",
-    "@dxos/echo-db": "0.8.4-main.67995b8",
-    "@dxos/echo-protocol": "0.8.4-main.67995b8",
-    "@dxos/echo-schema": "0.8.4-main.67995b8",
-    "@dxos/edge-client": "0.8.4-main.67995b8",
-    "@dxos/effect": "0.8.4-main.67995b8",
-    "@dxos/functions": "0.8.4-main.67995b8",
-    "@dxos/graph": "0.8.4-main.67995b8",
-    "@dxos/invariant": "0.8.4-main.67995b8",
-    "@dxos/keys": "0.8.4-main.67995b8",
-    "@dxos/live-object": "0.8.4-main.67995b8",
-    "@dxos/local-storage": "0.8.4-main.67995b8",
-    "@dxos/log": "0.8.4-main.67995b8",
-    "@dxos/plugin-client": "0.8.4-main.67995b8",
-    "@dxos/plugin-deck": "0.8.4-main.67995b8",
-    "@dxos/plugin-explorer": "0.8.4-main.67995b8",
-    "@dxos/plugin-graph": "0.8.4-main.67995b8",
-    "@dxos/plugin-inbox": "0.8.4-main.67995b8",
-    "@dxos/plugin-markdown": "0.8.4-main.67995b8",
-    "@dxos/plugin-preview": "0.8.4-main.67995b8",
-    "@dxos/plugin-script": "0.8.4-main.67995b8",
-    "@dxos/plugin-sketch": "0.8.4-main.67995b8",
-    "@dxos/plugin-space": "0.8.4-main.67995b8",
-    "@dxos/plugin-stack": "0.8.4-main.67995b8",
-    "@dxos/plugin-transcription": "0.8.4-main.67995b8",
-    "@dxos/plugin-wnfs": "0.8.4-main.67995b8",
-    "@dxos/protocols": "0.8.4-main.67995b8",
-    "@dxos/react-client": "0.8.4-main.67995b8",
-    "@dxos/react-ui-attention": "0.8.4-main.67995b8",
-    "@dxos/react-ui-canvas-editor": "0.8.4-main.67995b8",
-    "@dxos/react-ui-canvas-compute": "0.8.4-main.67995b8",
-    "@dxos/react-edge-client": "0.8.4-main.67995b8",
-    "@dxos/react-ui-chat": "0.8.4-main.67995b8",
-    "@dxos/react-ui-components": "0.8.4-main.67995b8",
-    "@dxos/react-ui-editor": "0.8.4-main.67995b8",
-    "@dxos/react-ui-form": "0.8.4-main.67995b8",
-    "@dxos/react-ui-list": "0.8.4-main.67995b8",
-    "@dxos/react-ui-graph": "0.8.4-main.67995b8",
-    "@dxos/react-ui-sfx": "0.8.4-main.67995b8",
-    "@dxos/react-ui-stack": "0.8.4-main.67995b8",
-    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.67995b8",
-    "@dxos/react-ui-tag-picker": "0.8.4-main.67995b8",
-    "@dxos/util": "0.8.4-main.67995b8",
-    "@dxos/schema": "0.8.4-main.67995b8"
+    "@dxos/ai": "0.8.4-main.69d29f4",
+    "@dxos/assistant": "0.8.4-main.69d29f4",
+    "@dxos/app-framework": "0.8.4-main.69d29f4",
+    "@dxos/blueprints": "0.8.4-main.69d29f4",
+    "@dxos/assistant-toolkit": "0.8.4-main.69d29f4",
+    "@dxos/client": "0.8.4-main.69d29f4",
+    "@dxos/compute": "0.8.4-main.69d29f4",
+    "@dxos/conductor": "0.8.4-main.69d29f4",
+    "@dxos/async": "0.8.4-main.69d29f4",
+    "@dxos/config": "0.8.4-main.69d29f4",
+    "@dxos/context": "0.8.4-main.69d29f4",
+    "@dxos/devtools": "0.8.4-main.69d29f4",
+    "@dxos/echo": "0.8.4-main.69d29f4",
+    "@dxos/debug": "0.8.4-main.69d29f4",
+    "@dxos/echo-db": "0.8.4-main.69d29f4",
+    "@dxos/echo-atom": "0.8.4-main.69d29f4",
+    "@dxos/echo-protocol": "0.8.4-main.69d29f4",
+    "@dxos/echo-query": "0.8.4-main.69d29f4",
+    "@dxos/edge-client": "0.8.4-main.69d29f4",
+    "@dxos/effect": "0.8.4-main.69d29f4",
+    "@dxos/functions-runtime": "0.8.4-main.69d29f4",
+    "@dxos/functions": "0.8.4-main.69d29f4",
+    "@dxos/graph": "0.8.4-main.69d29f4",
+    "@dxos/keys": "0.8.4-main.69d29f4",
+    "@dxos/lit-ui": "0.8.4-main.69d29f4",
+    "@dxos/log": "0.8.4-main.69d29f4",
+    "@dxos/invariant": "0.8.4-main.69d29f4",
+    "@dxos/operation": "0.8.4-main.69d29f4",
+    "@dxos/plugin-automation": "0.8.4-main.69d29f4",
+    "@dxos/plugin-attention": "0.8.4-main.69d29f4",
+    "@dxos/plugin-deck": "0.8.4-main.69d29f4",
+    "@dxos/plugin-client": "0.8.4-main.69d29f4",
+    "@dxos/plugin-graph": "0.8.4-main.69d29f4",
+    "@dxos/plugin-space": "0.8.4-main.69d29f4",
+    "@dxos/plugin-map": "0.8.4-main.69d29f4",
+    "@dxos/plugin-table": "0.8.4-main.69d29f4",
+    "@dxos/protocols": "0.8.4-main.69d29f4",
+    "@dxos/plugin-transcription": "0.8.4-main.69d29f4",
+    "@dxos/react-edge-client": "0.8.4-main.69d29f4",
+    "@dxos/react-client": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-attention": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-canvas-editor": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-canvas-compute": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-chat": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-components": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-editor": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-form": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-graph": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-list": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-markdown": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-menu": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-sfx": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-searchlist": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-stack": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.69d29f4",
+    "@dxos/types": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-tabs": "0.8.4-main.69d29f4",
+    "@dxos/schema": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-mosaic": "0.8.4-main.69d29f4",
+    "@dxos/ui": "0.8.4-main.69d29f4",
+    "@dxos/ui-editor": "0.8.4-main.69d29f4",
+    "@dxos/util": "0.8.4-main.69d29f4"
   },
   "devDependencies": {
-    "@effect-rx/rx-react": "^0.38.0",
-    "@effect/platform": "0.89.0",
+    "@effect/platform": "0.93.6",
     "@types/lodash.defaultsdeep": "^4.6.6",
-    "@types/react": "~18.2.0",
-    "@types/react-dom": "~18.2.0",
-    "effect": "3.17.0",
+    "@types/react": "~19.2.7",
+    "@types/react-dom": "~19.2.3",
+    "effect": "3.19.11",
     "openapi-types": "^12.1.3",
-    "react": "~18.2.0",
-    "react-dom": "~18.2.0",
-    "vite": "5.4.7",
-    "@dxos/assistant-testing": "0.8.4-main.67995b8",
-    "@dxos/plugin-chess": "0.8.4-main.67995b8",
-    "@dxos/echo-db": "0.8.4-main.67995b8",
-    "@dxos/plugin-inbox": "0.8.4-main.67995b8",
-    "@dxos/plugin-map": "0.8.4-main.67995b8",
-    "@dxos/plugin-markdown": "0.8.4-main.67995b8",
-    "@dxos/plugin-table": "0.8.4-main.67995b8",
-    "@dxos/react-ui": "0.8.4-main.67995b8",
-    "@dxos/random": "0.8.4-main.67995b8",
-    "@dxos/react-ui-menu": "0.8.4-main.67995b8",
-    "@dxos/storybook-utils": "0.8.4-main.67995b8",
-    "@dxos/react-ui-theme": "0.8.4-main.67995b8"
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "vite": "7.1.9",
+    "@dxos/assistant-toolkit": "0.8.4-main.69d29f4",
+    "@dxos/devtools": "0.8.4-main.69d29f4",
+    "@dxos/echo-db": "0.8.4-main.69d29f4",
+    "@dxos/plugin-chess": "0.8.4-main.69d29f4",
+    "@dxos/plugin-table": "0.8.4-main.69d29f4",
+    "@dxos/plugin-map": "0.8.4-main.69d29f4",
+    "@dxos/random": "0.8.4-main.69d29f4",
+    "@dxos/plugin-testing": "0.8.4-main.69d29f4",
+    "@dxos/react-ui": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-menu": "0.8.4-main.69d29f4",
+    "@dxos/react-ui-table": "0.8.4-main.69d29f4",
+    "@dxos/storybook-utils": "0.8.4-main.69d29f4",
+    "@dxos/ui-theme": "0.8.4-main.69d29f4"
   },
   "peerDependencies": {
-    "@effect-rx/rx-react": "^0.34.1",
-    "@effect/platform": "^0.80.12",
-    "effect": "^3.13.3",
-    "react": "~18.2.0",
-    "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.8.4-main.67995b8",
-    "@dxos/react-ui-theme": "0.8.4-main.67995b8"
+    "@effect-atom/atom-react": "^0.4.6",
+    "@effect/platform": "0.93.6",
+    "effect": "3.19.11",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "@dxos/ui-theme": "0.8.4-main.69d29f4",
+    "@dxos/react-ui": "0.8.4-main.69d29f4"
   },
   "publishConfig": {
     "access": "public"

package/src/AssistantPlugin.tsx

@@ -2,123 +2,135 @@
 // Copyright 2023 DXOS.org
 //
 
-import { Layer } from 'effect';
+import * as Effect from 'effect/Effect';
 
-import { AiServiceTestingPreset } from '@dxos/ai/testing';
-import { Capabilities, Events, contributes, createIntent, defineModule, definePlugin } from '@dxos/app-framework';
-import { Blueprint } from '@dxos/blueprints';
+import { Capability, Common, Plugin } from '@dxos/app-framework';
+import { ResearchGraph } from '@dxos/assistant-toolkit';
+import { Blueprint, Prompt } from '@dxos/blueprints';
 import { Sequence } from '@dxos/conductor';
-import { Type } from '@dxos/echo';
-import { ClientCapabilities, ClientEvents } from '@dxos/plugin-client';
-import { SpaceCapabilities, SpaceEvents } from '@dxos/plugin-space';
-import { defineObjectForm } from '@dxos/plugin-space/types';
+import { Obj, Type } from '@dxos/echo';
+import { Operation } from '@dxos/operation';
+import { ClientEvents } from '@dxos/plugin-client/types';
+import { SpaceCapabilities, SpaceEvents } from '@dxos/plugin-space/types';
+import { type CreateObject } from '@dxos/plugin-space/types';
+import { HasSubject } from '@dxos/types';
 
-import { AppGraphBuilder, IntentResolver, ReactSurface, Settings } from './capabilities';
-import { AssistantCapabilities } from './capability-definitions';
+import {
+  AiService,
+  AppGraphBuilder,
+  AssistantState,
+  BlueprintDefinition,
+  EdgeModelResolver,
+  LocalModelResolver,
+  OperationResolver,
+  ReactSurface,
+  Repair,
+  Settings,
+  Toolkit,
+} from './capabilities';
 import { meta } from './meta';
 import { translations } from './translations';
-import { Assistant, ServiceType } from './types';
+import { AssistantEvents } from './types';
+import { Assistant, AssistantOperation } from './types';
 
-export const AssistantPlugin = () =>
-  definePlugin(meta, [
-    defineModule({
-      id: `${meta.id}/module/translations`,
-      activatesOn: Events.SetupTranslations,
-      activate: () => contributes(Capabilities.Translations, translations),
-    }),
-    defineModule({
-      id: `${meta.id}/module/settings`,
-      activatesOn: Events.SetupSettings,
-      activate: Settings,
-    }),
-    defineModule({
-      id: `${meta.id}/module/metadata`,
-      activatesOn: Events.SetupMetadata,
-      activate: () => [
-        contributes(Capabilities.Metadata, {
-          id: Type.getTypename(Assistant.Chat),
-          metadata: {
-            icon: 'ph--atom--regular',
-          },
-        }),
-        contributes(Capabilities.Metadata, {
-          id: Type.getTypename(Blueprint.Blueprint),
-          metadata: {
-            icon: 'ph--blueprint--regular',
-          },
-        }),
-        contributes(Capabilities.Metadata, {
-          id: Type.getTypename(Sequence),
-          metadata: {
-            icon: 'ph--circuitry--regular',
-          },
-        }),
-      ],
-    }),
-    defineModule({
-      id: `${meta.id}/module/object-form`,
-      activatesOn: ClientEvents.SetupSchema,
-      activate: () => [
-        contributes(
-          SpaceCapabilities.ObjectForm,
-          defineObjectForm({
-            objectSchema: Assistant.Chat,
-            getIntent: (_, options) => createIntent(Assistant.CreateChat, { space: options.space }),
-          }),
+export const AssistantPlugin = Plugin.define(meta).pipe(
+  Common.Plugin.addTranslationsModule({ translations }),
+  Common.Plugin.addSettingsModule({ activate: Settings }),
+  Plugin.addModule({
+    // TODO(wittjosiah): Does not integrate with settings store.
+    //   Should this be a different event?
+    //   Should settings store be renamed to be more generic?
+    activatesOn: Common.ActivationEvent.SetupSettings,
+    activate: AssistantState,
+  }),
+  Common.Plugin.addMetadataModule({
+    metadata: [
+      {
+        id: Type.getTypename(Assistant.Chat),
+        metadata: {
+          icon: 'ph--atom--regular',
+          iconHue: 'sky',
+          createObject: ((props) => Effect.sync(() => Assistant.make(props))) satisfies CreateObject,
+        },
+      },
+      {
+        id: Type.getTypename(Blueprint.Blueprint),
+        metadata: {
+          icon: 'ph--blueprint--regular',
+          iconHue: 'sky',
+          inputSchema: AssistantOperation.BlueprintForm,
+          createObject: ((props) => Effect.sync(() => Blueprint.make(props))) satisfies CreateObject,
+        },
+      },
+      {
+        id: Type.getTypename(Prompt.Prompt),
+        metadata: {
+          icon: 'ph--scroll--regular',
+          iconHue: 'sky',
+          createObject: ((props) => Effect.sync(() => Prompt.make(props))) satisfies CreateObject,
+        },
+      },
+      {
+        id: Type.getTypename(Sequence),
+        metadata: {
+          icon: 'ph--circuitry--regular',
+          iconHue: 'sky',
+          createObject: ((props) => Effect.sync(() => Obj.make(Sequence, props))) satisfies CreateObject,
+          addToCollectionOnCreate: true,
+        },
+      },
+    ],
+  }),
+  Common.Plugin.addSchemaModule({
+    schema: [
+      Assistant.Chat,
+      Assistant.CompanionTo,
+      Blueprint.Blueprint,
+      HasSubject.HasSubject,
+      Prompt.Prompt,
+      ResearchGraph,
+      Sequence,
+    ],
+  }),
+  Plugin.addModule({
+    id: 'on-space-created',
+    activatesOn: SpaceEvents.SpaceCreated,
+    activate: () =>
+      Effect.succeed(
+        Capability.contributes(SpaceCapabilities.OnCreateSpace, (params) =>
+          Operation.invoke(AssistantOperation.OnCreateSpace, params),
         ),
-        contributes(
-          SpaceCapabilities.ObjectForm,
-          defineObjectForm({
-            objectSchema: Blueprint.Blueprint,
-            formSchema: Assistant.BlueprintForm,
-            getIntent: (props) => createIntent(Assistant.CreateBlueprint, props),
-          }),
-        ),
-        contributes(
-          SpaceCapabilities.ObjectForm,
-          defineObjectForm({
-            objectSchema: Sequence,
-            getIntent: () => createIntent(Assistant.CreateSequence),
-          }),
-        ),
-      ],
-    }),
-    defineModule({
-      id: `${meta.id}/module/schema`,
-      activatesOn: ClientEvents.SetupSchema,
-      activate: () => contributes(ClientCapabilities.Schema, [ServiceType, Assistant.CompanionTo]),
-    }),
-    defineModule({
-      id: `${meta.id}/module/on-space-created`,
-      activatesOn: SpaceEvents.SpaceCreated,
-      activate: () =>
-        contributes(SpaceCapabilities.OnSpaceCreated, ({ space, rootCollection }) =>
-          createIntent(Assistant.OnSpaceCreated, { space, rootCollection }),
-        ),
-    }),
-    defineModule({
-      id: `${meta.id}/module/app-graph-builder`,
-      activatesOn: Events.SetupAppGraph,
-      activate: AppGraphBuilder,
-    }),
-    defineModule({
-      id: `${meta.id}/module/intent-resolver`,
-      activatesOn: Events.SetupIntentResolver,
-      activate: IntentResolver,
-    }),
-    defineModule({
-      id: `${meta.id}/module/react-surface`,
-      activatesOn: Events.SetupReactSurface,
-      // TODO(wittjosiah): Should occur before the chat is loaded when surfaces activation is more granular.
-      activatesBefore: [Events.SetupArtifactDefinition],
-      activate: ReactSurface,
-    }),
-    defineModule({
-      id: `${meta.id}/module/ai-service`,
-      activatesOn: Events.Startup,
-      activate: () => [
-        // TODO(dmaretskyi): Read config from settings.
-        contributes(AssistantCapabilities.AiServiceLayer, AiServiceTestingPreset('edge-remote').pipe(Layer.orDie)),
-      ],
-    }),
-  ]);
+      ),
+  }),
+  Plugin.addModule({
+    activatesOn: ClientEvents.SpacesReady,
+    activate: Repair,
+  }),
+  Common.Plugin.addAppGraphModule({ activate: AppGraphBuilder }),
+  Common.Plugin.addOperationResolverModule({ activate: OperationResolver }),
+  Common.Plugin.addSurfaceModule({
+    activate: ReactSurface,
+    activatesBefore: [Common.ActivationEvent.SetupArtifactDefinition],
+  }),
+  Plugin.addModule({
+    activatesOn: AssistantEvents.SetupAiServiceProviders,
+    activate: EdgeModelResolver,
+  }),
+  Plugin.addModule({
+    activatesOn: AssistantEvents.SetupAiServiceProviders,
+    activate: LocalModelResolver,
+  }),
+  Plugin.addModule({
+    activatesBefore: [AssistantEvents.SetupAiServiceProviders],
+    // TODO(dmaretskyi): This should activate lazily when the AI chat is used.
+    activatesOn: Common.ActivationEvent.Startup,
+    activate: AiService,
+  }),
+  Common.Plugin.addBlueprintDefinitionModule({ activate: BlueprintDefinition }),
+  Plugin.addModule({
+    // TODO(wittjosiah): Use a different event.
+    activatesOn: Common.ActivationEvent.Startup,
+    activate: Toolkit,
+  }),
+  Plugin.make,
+);

package/src/blueprints/assistant-blueprint.ts

@@ -0,0 +1,62 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { templates } from '@dxos/assistant';
+import {
+  Agent,
+  AssistantToolkit,
+  Discord,
+  DiscordBlueprint,
+  EntityExtraction,
+  Linear,
+  LinearBlueprint,
+  Research,
+  ResearchBlueprint,
+  SystemToolkit,
+  WebSearchBlueprint,
+} from '@dxos/assistant-toolkit';
+import { Blueprint } from '@dxos/blueprints';
+import { type FunctionDefinition } from '@dxos/functions';
+
+import { list, load, search } from '../functions';
+
+// TODO(burdon): Document plugin structure (blueprint, functions, toolkit.).
+// TODO(burdon): Test framework for developing functions. Error handling.
+// TODO(burdon): Function naming pattern (noun-verb); fully-qualified?
+
+export const deckTools = ['open-item'];
+
+export const functions$: FunctionDefinition[] = [list, load, search];
+export const functions = [
+  ...functions$,
+  // Factor out.
+  Research.create,
+  Research.research,
+  Agent.prompt,
+  EntityExtraction.extract,
+  Discord.fetch,
+  Linear.sync,
+];
+export const tools = [...AssistantToolkit.tools, ...SystemToolkit.tools, ...deckTools];
+
+export const Key = 'dxos.org/blueprint/assistant';
+
+export const make = (): Blueprint.Blueprint =>
+  Blueprint.make({
+    key: Key,
+    name: 'Assistant',
+    tools: Blueprint.toolDefinitions({ functions, tools }),
+    instructions: templates.system,
+  });
+
+export const blueprint = make();
+
+export const blueprints = [
+  blueprint,
+  // Factor out.
+  ResearchBlueprint,
+  WebSearchBlueprint,
+  DiscordBlueprint,
+  LinearBlueprint,
+];

package/src/blueprints/index.ts

@@ -0,0 +1,12 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { type Blueprint } from '@dxos/blueprints';
+import { type FunctionDefinition } from '@dxos/functions';
+
+import * as AssistantBlueprint from './assistant-blueprint';
+
+export { AssistantBlueprint };
+export const blueprints: Blueprint.Blueprint[] = AssistantBlueprint.blueprints;
+export const functions: FunctionDefinition[] = AssistantBlueprint.functions;

package/src/capabilities/ai-service/ai-service.ts

@@ -0,0 +1,29 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+import * as Layer from 'effect/Layer';
+
+import { AiModelResolver } from '@dxos/ai';
+import { Capability, Common } from '@dxos/app-framework';
+
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    const resolvers = yield* Capability.getAll(Common.Capability.AiModelResolver);
+
+    // TODO(dmaretskyi): Extract function to reduce them.
+    const combinedLayer = resolvers.reduce(
+      (acc, resolver) => resolver.pipe(Layer.provide(acc)),
+      AiModelResolver.AiModelResolver.fromModelMap({ name: 'Fallback' }, Effect.succeed({})), // Empty resolver as fallback.
+    );
+
+    return [
+      // TODO(dmaretskyi): Read config from settings.
+      Capability.contributes(
+        Common.Capability.AiServiceLayer,
+        AiModelResolver.AiModelResolver.buildAiService.pipe(Layer.provide(combinedLayer)),
+      ),
+    ];
+  }),
+);

package/src/capabilities/ai-service/index.ts

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