@dxos/plugin-assistant 0.7.5-labs.a8b535d

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

@@ -0,0 +1,160 @@
+import { ComputeGraph } from '@dxos/conductor';
+import { S, type Ref$ } from '@dxos/echo-schema';
+import { FunctionType } from '@dxos/functions';
+export declare const ApiAuthorization: S.Union<[S.Struct<{
+    type: S.Literal<["api-key"]>;
+    key: typeof S.String;
+    placement: S.Union<[S.Struct<{
+        type: S.Literal<["authorization-header"]>;
+    }>, S.Struct<{
+        type: S.Literal<["query"]>;
+        name: typeof S.String;
+    }>]>;
+}>, S.Struct<{
+    type: S.Literal<["oauth"]>;
+    clientId: typeof S.String;
+    clientSecret: typeof S.String;
+    tokenUrl: typeof S.String;
+    grantType: typeof S.String;
+}>]>;
+export type ApiAuthorization = S.Schema.Type<typeof ApiAuthorization>;
+declare const ServiceInterface: S.Union<[S.Struct<{
+    kind: S.Literal<["function"]>;
+    fn: Ref$<FunctionType>;
+}>, S.Struct<{
+    kind: S.Literal<["workflow"]>;
+    workflow: Ref$<ComputeGraph>;
+}>, S.Struct<{
+    kind: S.Literal<["api"]>;
+    /**
+     * URL to fetch the openapi schema.
+     */
+    schemaUrl: S.optional<typeof S.String>;
+    /**
+     * Inlined openapi schema.
+     */
+    schema: S.optional<typeof S.Any>;
+    /**
+     * Authorization configuration if required.
+     */
+    authorization: S.optional<S.Union<[S.Struct<{
+        type: S.Literal<["api-key"]>;
+        key: typeof S.String;
+        placement: S.Union<[S.Struct<{
+            type: S.Literal<["authorization-header"]>;
+        }>, S.Struct<{
+            type: S.Literal<["query"]>;
+            name: typeof S.String;
+        }>]>;
+    }>, S.Struct<{
+        type: S.Literal<["oauth"]>;
+        clientId: typeof S.String;
+        clientSecret: typeof S.String;
+        tokenUrl: typeof S.String;
+        grantType: typeof S.String;
+    }>]>>;
+}>]>;
+export type ServiceInterface = S.Schema.Type<typeof ServiceInterface>;
+declare const ServiceType_base: import("@dxos/echo-schema").TypedObjectPrototype<import("@dxos/echo-schema").TypedObjectFields<{
+    serviceId: typeof S.String;
+    name: S.optional<typeof S.String>;
+    description: S.optional<typeof S.String>;
+    category: S.optional<typeof S.String>;
+    enabled: S.optional<typeof S.Boolean>;
+    /**
+     * Entries exposed: functions, workflows, and APIs.
+     */
+    interfaces: S.optional<S.Array$<S.Union<[S.Struct<{
+        kind: S.Literal<["function"]>;
+        fn: Ref$<FunctionType>;
+    }>, S.Struct<{
+        kind: S.Literal<["workflow"]>;
+        workflow: Ref$<ComputeGraph>;
+    }>, S.Struct<{
+        kind: S.Literal<["api"]>;
+        /**
+         * URL to fetch the openapi schema.
+         */
+        schemaUrl: S.optional<typeof S.String>;
+        /**
+         * Inlined openapi schema.
+         */
+        schema: S.optional<typeof S.Any>;
+        /**
+         * Authorization configuration if required.
+         */
+        authorization: S.optional<S.Union<[S.Struct<{
+            type: S.Literal<["api-key"]>;
+            key: typeof S.String;
+            placement: S.Union<[S.Struct<{
+                type: S.Literal<["authorization-header"]>;
+            }>, S.Struct<{
+                type: S.Literal<["query"]>;
+                name: typeof S.String;
+            }>]>;
+        }>, S.Struct<{
+            type: S.Literal<["oauth"]>;
+            clientId: typeof S.String;
+            clientSecret: typeof S.String;
+            tokenUrl: typeof S.String;
+            grantType: typeof S.String;
+        }>]>>;
+    }>]>>>;
+}, import("@dxos/echo-schema").TypedObjectOptions>, S.Struct.Encoded<{
+    serviceId: typeof S.String;
+    name: S.optional<typeof S.String>;
+    description: S.optional<typeof S.String>;
+    category: S.optional<typeof S.String>;
+    enabled: S.optional<typeof S.Boolean>;
+    /**
+     * Entries exposed: functions, workflows, and APIs.
+     */
+    interfaces: S.optional<S.Array$<S.Union<[S.Struct<{
+        kind: S.Literal<["function"]>;
+        fn: Ref$<FunctionType>;
+    }>, S.Struct<{
+        kind: S.Literal<["workflow"]>;
+        workflow: Ref$<ComputeGraph>;
+    }>, S.Struct<{
+        kind: S.Literal<["api"]>;
+        /**
+         * URL to fetch the openapi schema.
+         */
+        schemaUrl: S.optional<typeof S.String>;
+        /**
+         * Inlined openapi schema.
+         */
+        schema: S.optional<typeof S.Any>;
+        /**
+         * Authorization configuration if required.
+         */
+        authorization: S.optional<S.Union<[S.Struct<{
+            type: S.Literal<["api-key"]>;
+            key: typeof S.String;
+            placement: S.Union<[S.Struct<{
+                type: S.Literal<["authorization-header"]>;
+            }>, S.Struct<{
+                type: S.Literal<["query"]>;
+                name: typeof S.String;
+            }>]>;
+        }>, S.Struct<{
+            type: S.Literal<["oauth"]>;
+            clientId: typeof S.String;
+            clientSecret: typeof S.String;
+            tokenUrl: typeof S.String;
+            grantType: typeof S.String;
+        }>]>>;
+    }>]>>>;
+}>>;
+export declare class ServiceType extends ServiceType_base {
+}
+export type ServiceQuery = {
+    name?: string;
+    category?: string;
+};
+export interface BaseServiceRegistry {
+    queryServices(query?: ServiceQuery): Promise<ServiceType[]>;
+}
+export declare const categoryIcons: Record<string, string>;
+export {};
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/types/service.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAO,CAAC,EAAe,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAwB/C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;IAAsD,CAAC;AACpF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC,CAAC;AA+BtE,QAAA,MAAM,gBAAgB;;QA3BK,IAAI,CAAC,YAAY,CAAC;;;cAKZ,IAAI,CAAC,YAAY,CAAC;;;IAMjD;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;;;;;;;;;;;;;;;;IAIoG,CAAC;AAC1G,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC,CAAC;;;;;;;IASpE;;OAEG;;;YAvCsB,IAAI,CAAC,YAAY,CAAC;;;kBAKZ,IAAI,CAAC,YAAY,CAAC;;;QAMjD;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;;;;;;;;;;;;;;IAcH;;OAEG;;;YAvCsB,IAAI,CAAC,YAAY,CAAC;;;kBAKZ,IAAI,CAAC,YAAY,CAAC;;;QAMjD;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;;;;;;;;;AAOL,qBAAa,WAAY,SAAQ,gBAW/B;CAAG;AAML,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,aAAa,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC7D;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAUvC,CAAC"}

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

@@ -0,0 +1,40 @@
+import { S } from '@dxos/echo-schema';
+export declare enum TemplateInputType {
+    VALUE = 0,
+    PASS_THROUGH = 1,
+    RETRIEVER = 2,
+    FUNCTION = 3,
+    QUERY = 4,
+    RESOLVER = 5,
+    CONTEXT = 6,
+    SCHEMA = 7
+}
+export declare const TemplateInputSchema: S.mutable<S.Struct<{
+    name: typeof S.String;
+    type: S.optional<S.Enums<typeof TemplateInputType>>;
+    value: S.optional<typeof S.String>;
+}>>;
+export type TemplateInput = S.Schema.Type<typeof TemplateInputSchema>;
+declare const TemplateType_base: import("@dxos/echo-schema").TypedObjectPrototype<import("@dxos/echo-schema").TypedObjectFields<{
+    name: S.optional<typeof S.String>;
+    source: typeof S.String;
+    inputs: S.optional<S.mutable<S.Array$<S.mutable<S.Struct<{
+        name: typeof S.String;
+        type: S.optional<S.Enums<typeof TemplateInputType>>;
+        value: S.optional<typeof S.String>;
+    }>>>>>;
+    command: S.optional<typeof S.String>;
+}, import("@dxos/echo-schema").TypedObjectOptions>, S.Struct.Encoded<{
+    name: S.optional<typeof S.String>;
+    source: typeof S.String;
+    inputs: S.optional<S.mutable<S.Array$<S.mutable<S.Struct<{
+        name: typeof S.String;
+        type: S.optional<S.Enums<typeof TemplateInputType>>;
+        value: S.optional<typeof S.String>;
+    }>>>>>;
+    command: S.optional<typeof S.String>;
+}>>;
+export declare class TemplateType extends TemplateType_base {
+}
+export {};
+//# sourceMappingURL=template.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../../src/types/template.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAe,MAAM,mBAAmB,CAAC;AAGnD,oBAAY,iBAAiB;IAC3B,KAAK,IAAI;IACT,YAAY,IAAI;IAChB,SAAS,IAAI;IACb,QAAQ,IAAI;IACZ,KAAK,IAAI;IACT,QAAQ,IAAI;IACZ,OAAO,IAAI;IACX,MAAM,IAAI;CACX;AAED,eAAO,MAAM,mBAAmB;;;;GAM/B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,mBAAmB,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;AAEtE,qBAAa,YAAa,SAAQ,iBAKhC;CAAG"}

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

@@ -0,0 +1,37 @@
+import { S } from '@dxos/echo-schema';
+import { AIChatType } from './chat';
+import { TemplateType } from './template';
+export declare namespace AssistantAction {
+    const CreateChat_base: S.TaggedClass<CreateChat, "dxos.org/plugin/assistant/action/create-chat", {
+        readonly _tag: S.tag<"dxos.org/plugin/assistant/action/create-chat">;
+    } & {
+        input: S.Struct<{
+            spaceId: S.optional<typeof S.String>;
+            name: S.optional<typeof S.String>;
+        }>;
+        output: S.Struct<{
+            object: typeof AIChatType;
+        }>;
+    }>;
+    export class CreateChat extends CreateChat_base {
+    }
+    const CreateTemplate_base: S.TaggedClass<CreateTemplate, "dxos.org/plugin/assistant/action/create-template", {
+        readonly _tag: S.tag<"dxos.org/plugin/assistant/action/create-template">;
+    } & {
+        input: S.Struct<{
+            name: S.optional<typeof S.String>;
+        }>;
+        output: S.Struct<{
+            object: typeof TemplateType;
+        }>;
+    }>;
+    export class CreateTemplate extends CreateTemplate_base {
+    }
+    export {};
+}
+export declare const AssistantSettingsSchema: S.mutable<S.Struct<{
+    llmModel: S.optional<typeof S.String>;
+    customPrompts: S.optional<typeof S.Boolean>;
+}>>;
+export type AssistantSettingsProps = S.Schema.Type<typeof AssistantSettingsSchema>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/types/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,yBAAiB,eAAe,CAAC;;;;;;;;;;;;IAG/B,MAAM,OAAO,UAAW,SAAQ,eAQ9B;KAAG;;;;;;;;;;;IAEL,MAAM,OAAO,cAAe,SAAQ,mBAOlC;KAAG;;CACN;AAED,eAAO,MAAM,uBAAuB;;;GAKnC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/types/tsconfig.tsbuildinfo

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

package/package.json

@@ -0,0 +1,120 @@
+{
+  "name": "@dxos/plugin-assistant",
+  "version": "0.7.5-labs.a8b535d",
+  "description": "Assistant plugin",
+  "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"
+    },
+    "./types": {
+      "types": "./dist/types/src/types/index.d.ts",
+      "browser": "./dist/lib/browser/types/index.mjs",
+      "node": "./dist/lib/node-esm/types/index.mjs"
+    }
+  },
+  "types": "dist/types/src/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "types": [
+        "dist/types/src/types/index.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "assets",
+    "dist",
+    "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/schema": "^0.75.5",
+    "@lezer/highlight": "^1.2.1",
+    "@preact/signals-core": "^1.6.0",
+    "@xiechao/codemirror-lang-handlebars": "1.0.4",
+    "jsonpointer": "^5.0.1",
+    "lodash.get": "^4.4.2",
+    "unified": "^11.0.0",
+    "@dxos/app-framework": "0.7.5-labs.a8b535d",
+    "@dxos/artifact": "0.7.5-labs.a8b535d",
+    "@dxos/assistant": "0.7.5-labs.a8b535d",
+    "@dxos/async": "0.7.5-labs.a8b535d",
+    "@dxos/client": "0.7.5-labs.a8b535d",
+    "@dxos/compute": "0.7.5-labs.a8b535d",
+    "@dxos/context": "0.7.5-labs.a8b535d",
+    "@dxos/conductor": "0.7.5-labs.a8b535d",
+    "@dxos/echo-schema": "0.7.5-labs.a8b535d",
+    "@dxos/echo-db": "0.7.5-labs.a8b535d",
+    "@dxos/edge-client": "0.7.5-labs.a8b535d",
+    "@dxos/functions": "0.7.5-labs.a8b535d",
+    "@dxos/keys": "0.7.5-labs.a8b535d",
+    "@dxos/invariant": "0.7.5-labs.a8b535d",
+    "@dxos/local-storage": "0.7.5-labs.a8b535d",
+    "@dxos/live-object": "0.7.5-labs.a8b535d",
+    "@dxos/plugin-client": "0.7.5-labs.a8b535d",
+    "@dxos/log": "0.7.5-labs.a8b535d",
+    "@dxos/plugin-deck": "0.7.5-labs.a8b535d",
+    "@dxos/plugin-graph": "0.7.5-labs.a8b535d",
+    "@dxos/plugin-inbox": "0.7.5-labs.a8b535d",
+    "@dxos/plugin-markdown": "0.7.5-labs.a8b535d",
+    "@dxos/plugin-script": "0.7.5-labs.a8b535d",
+    "@dxos/plugin-sketch": "0.7.5-labs.a8b535d",
+    "@dxos/plugin-stack": "0.7.5-labs.a8b535d",
+    "@dxos/plugin-space": "0.7.5-labs.a8b535d",
+    "@dxos/plugin-wnfs": "0.7.5-labs.a8b535d",
+    "@dxos/plugin-transcription": "0.7.5-labs.a8b535d",
+    "@dxos/react-client": "0.7.5-labs.a8b535d",
+    "@dxos/react-edge-client": "0.7.5-labs.a8b535d",
+    "@dxos/react-ui-canvas-compute": "0.7.5-labs.a8b535d",
+    "@dxos/react-ui-components": "0.7.5-labs.a8b535d",
+    "@dxos/react-ui-dnd": "0.7.5-labs.a8b535d",
+    "@dxos/react-ui-canvas-editor": "0.7.5-labs.a8b535d",
+    "@dxos/react-ui-editor": "0.7.5-labs.a8b535d",
+    "@dxos/react-ui-form": "0.7.5-labs.a8b535d",
+    "@dxos/react-ui-list": "0.7.5-labs.a8b535d",
+    "@dxos/react-ui-sfx": "0.7.5-labs.a8b535d",
+    "@dxos/react-ui-stack": "0.7.5-labs.a8b535d",
+    "@dxos/react-ui-syntax-highlighter": "0.7.5-labs.a8b535d",
+    "@dxos/schema": "0.7.5-labs.a8b535d",
+    "@dxos/util": "0.7.5-labs.a8b535d"
+  },
+  "devDependencies": {
+    "@types/lodash.get": "^4.4.7",
+    "@types/react": "~18.2.0",
+    "@types/react-dom": "~18.2.0",
+    "openapi-types": "^12.1.3",
+    "react": "~18.2.0",
+    "react-dom": "~18.2.0",
+    "vite": "5.4.7",
+    "@dxos/echo-db": "0.7.5-labs.a8b535d",
+    "@dxos/artifact-testing": "0.7.5-labs.a8b535d",
+    "@dxos/plugin-chess": "0.7.5-labs.a8b535d",
+    "@dxos/plugin-inbox": "0.7.5-labs.a8b535d",
+    "@dxos/plugin-map": "0.7.5-labs.a8b535d",
+    "@dxos/plugin-table": "0.7.5-labs.a8b535d",
+    "@dxos/random": "0.7.5-labs.a8b535d",
+    "@dxos/react-ui-theme": "0.7.5-labs.a8b535d",
+    "@dxos/react-ui": "0.7.5-labs.a8b535d",
+    "@dxos/storybook-utils": "0.7.5-labs.a8b535d"
+  },
+  "peerDependencies": {
+    "react": "~18.2.0",
+    "react-dom": "~18.2.0",
+    "@dxos/react-ui": "0.7.5-labs.a8b535d",
+    "@dxos/react-ui-theme": "0.7.5-labs.a8b535d"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/AssistantPlugin.tsx

@@ -0,0 +1,105 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { Capabilities, contributes, createIntent, defineModule, definePlugin, Events } from '@dxos/app-framework';
+import { ClientCapabilities, ClientEvents } from '@dxos/plugin-client';
+import { DeckCapabilities, DeckEvents } from '@dxos/plugin-deck';
+import { SpaceCapabilities } from '@dxos/plugin-space';
+import { defineObjectForm } from '@dxos/plugin-space/types';
+
+import { AiClient, AppGraphBuilder, IntentResolver, ReactSurface, AssistantSettings } from './capabilities';
+import { ASSISTANT_PLUGIN, meta } from './meta';
+import translations from './translations';
+import { AssistantAction, AIChatType, ServiceType, TemplateType } 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: AssistantSettings,
+    }),
+    defineModule({
+      id: `${meta.id}/module/metadata`,
+      activatesOn: Events.SetupMetadata,
+      activate: () => [
+        contributes(Capabilities.Metadata, {
+          id: TemplateType.typename,
+          metadata: {
+            placeholder: ['template title placeholder', { ns: ASSISTANT_PLUGIN }],
+            icon: 'ph--code-block--regular',
+          },
+        }),
+        contributes(Capabilities.Metadata, {
+          id: AIChatType.typename,
+          metadata: {
+            placeholder: ['chat title placeholder', { ns: ASSISTANT_PLUGIN }],
+            icon: 'ph--atom--regular',
+          },
+        }),
+      ],
+    }),
+    defineModule({
+      id: `${meta.id}/module/object-form`,
+      activatesOn: ClientEvents.SetupSchema,
+      activate: () => [
+        contributes(
+          SpaceCapabilities.ObjectForm,
+          defineObjectForm({
+            objectSchema: AIChatType,
+            getIntent: (_, options) => createIntent(AssistantAction.CreateChat, { spaceId: options.space.id }),
+          }),
+        ),
+        contributes(
+          SpaceCapabilities.ObjectForm,
+          defineObjectForm({
+            objectSchema: TemplateType,
+            getIntent: () => createIntent(AssistantAction.CreateTemplate),
+          }),
+        ),
+      ],
+    }),
+    defineModule({
+      id: `${meta.id}/module/schema`,
+      activatesOn: ClientEvents.SetupSchema,
+      activate: () => contributes(ClientCapabilities.Schema, [ServiceType, TemplateType]),
+    }),
+    defineModule({
+      id: `${meta.id}/module/complementary-panels`,
+      activatesOn: DeckEvents.SetupComplementaryPanels,
+      activate: () =>
+        contributes(DeckCapabilities.ComplementaryPanel, {
+          id: 'service-registry',
+          label: ['service registry label', { ns: ASSISTANT_PLUGIN }],
+          icon: 'ph--plugs--regular',
+        }),
+    }),
+    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/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/ai-client`,
+      activatesOn: ClientEvents.ClientReady,
+      activate: AiClient,
+    }),
+  ]);

package/src/capabilities/ai-client.ts

@@ -0,0 +1,19 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { contributes, type PluginsContext } from '@dxos/app-framework';
+import { AIServiceClientImpl } from '@dxos/assistant';
+import { ClientCapabilities } from '@dxos/plugin-client';
+
+import { AssistantCapabilities } from './capabilities';
+
+// TODO(wittjosiah): Factor out.
+const DEFAULT_AI_SERVICE_URL = 'http://localhost:8788';
+
+export default (context: PluginsContext) => {
+  const client = context.requestCapability(ClientCapabilities.Client);
+  const endpoint = client.config.values.runtime?.services?.ai?.server ?? DEFAULT_AI_SERVICE_URL;
+  const aiClient = new AIServiceClientImpl({ endpoint });
+  return contributes(AssistantCapabilities.AiClient, aiClient);
+};

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

@@ -0,0 +1,100 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import {
+  Capabilities,
+  contributes,
+  createIntent,
+  LayoutAction,
+  type PromiseIntentDispatcher,
+  type PluginsContext,
+} from '@dxos/app-framework';
+import { invariant } from '@dxos/invariant';
+import { log } from '@dxos/log';
+import { ClientCapabilities } from '@dxos/plugin-client';
+import { createExtension, type Node, ROOT_ID } from '@dxos/plugin-graph';
+import { SpaceAction } from '@dxos/plugin-space/types';
+import { type Space, Filter, getSpace } from '@dxos/react-client/echo';
+
+import { ASSISTANT_DIALOG, ASSISTANT_PLUGIN } from '../meta';
+import { AIChatType, AssistantAction } from '../types';
+
+export default (context: PluginsContext) =>
+  contributes(Capabilities.AppGraphBuilder, [
+    createExtension({
+      id: `${ASSISTANT_PLUGIN}/assistant`,
+      filter: (node): node is Node<null> => node.id === ROOT_ID,
+      actions: () => [
+        {
+          id: `${LayoutAction.UpdateDialog._tag}/assistant/open`,
+          data: async () => {
+            const { dispatchPromise: dispatch } = context.requestCapability(Capabilities.IntentDispatcher);
+            const client = context.requestCapability(ClientCapabilities.Client);
+            const layout = context.requestCapability(Capabilities.Layout);
+            const { graph } = context.requestCapability(Capabilities.AppGraph);
+
+            // TODO(burdon): Get space from workspace.
+            // TODO(burdon): If need to create chat, then add to dispatch stack below.
+            let chat: AIChatType | undefined;
+            if (layout.active.length > 0) {
+              const node = graph.findNode(layout.active[0]);
+              if (node) {
+                const space = getSpace(node.data);
+                if (space) {
+                  chat = await getOrCreateChat(dispatch, space);
+                }
+              }
+            } else {
+              const space = client.spaces.default;
+              chat = await getOrCreateChat(dispatch, space);
+            }
+
+            if (!chat) {
+              log.warn('no chat found');
+              return;
+            }
+
+            await dispatch(
+              createIntent(LayoutAction.UpdateDialog, {
+                part: 'dialog',
+                subject: ASSISTANT_DIALOG,
+                options: {
+                  state: true,
+                  blockAlign: 'end',
+                  props: {
+                    chat,
+                  },
+                },
+              }),
+            );
+          },
+          properties: {
+            label: ['open assistant label', { ns: ASSISTANT_PLUGIN }],
+            icon: 'ph--chat-centered-text--regular',
+            disposition: 'pin-end',
+            position: 'hoist',
+            keyBinding: {
+              macos: 'shift+meta+k',
+              windows: 'shift+ctrl+k',
+            },
+          },
+        },
+      ],
+    }),
+  ]);
+
+// TODO(burdon): Factor out.
+const getOrCreateChat = async (dispatch: PromiseIntentDispatcher, space: Space): Promise<AIChatType | undefined> => {
+  const { objects } = await space.db.query(Filter.schema(AIChatType)).run();
+  // console.log('objects', JSON.stringify(objects, null, 2));
+  if (objects.length > 0) {
+    // TODO(burdon): Is this the most recent?
+    return objects[objects.length - 1];
+  }
+
+  const { data } = await dispatch(createIntent(AssistantAction.CreateChat, { spaceId: space.id }));
+  invariant(data?.object instanceof AIChatType);
+  await dispatch(createIntent(SpaceAction.AddObject, { target: space, object: data.object }));
+  return data.object;
+};

package/src/capabilities/capabilities.ts

@@ -0,0 +1,12 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { defineCapability } from '@dxos/app-framework';
+import { type AIServiceClientImpl } from '@dxos/assistant';
+
+import { ASSISTANT_PLUGIN } from '../meta';
+
+export namespace AssistantCapabilities {
+  export const AiClient = defineCapability<AIServiceClientImpl>(`${ASSISTANT_PLUGIN}/capability/ai-client`);
+}

package/src/capabilities/index.ts

@@ -0,0 +1,13 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { lazy } from '@dxos/app-framework';
+
+export const AiClient = lazy(() => import('./ai-client'));
+export const AppGraphBuilder = lazy(() => import('./app-graph-builder'));
+export const IntentResolver = lazy(() => import('./intent-resolver'));
+export const ReactSurface = lazy(() => import('./react-surface'));
+export const AssistantSettings = lazy(() => import('./settings'));
+
+export * from './capabilities';

package/src/capabilities/intent-resolver.ts

@@ -0,0 +1,38 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capabilities, contributes, createResolver } from '@dxos/app-framework';
+import { ObjectId } from '@dxos/echo-schema';
+import { DXN, QueueSubspaceTags } from '@dxos/keys';
+import { create, refFromDXN } from '@dxos/live-object';
+
+import { AssistantAction, AIChatType, TemplateType } from '../types';
+
+export default () => [
+  contributes(
+    Capabilities.IntentResolver,
+    createResolver({
+      intent: AssistantAction.CreateChat,
+      resolve: ({ spaceId, name }) => ({
+        data: {
+          object: create(AIChatType, {
+            name,
+            queue: refFromDXN(new DXN(DXN.kind.QUEUE, [QueueSubspaceTags.DATA, spaceId, ObjectId.random()])),
+          }),
+        },
+      }),
+    }),
+  ),
+  contributes(
+    Capabilities.IntentResolver,
+    createResolver({
+      intent: AssistantAction.CreateTemplate,
+      resolve: ({ name }) => ({
+        data: {
+          object: create(TemplateType, { name, source: '{{! Template }}' }),
+        },
+      }),
+    }),
+  ),
+];