@dxos/plugin-conductor 0.8.4-main.a4bbb77 → 0.8.4-main.abd8ff62ef

package/package.json

@@ -1,76 +1,84 @@
 {
   "name": "@dxos/plugin-conductor",
-  "version": "0.8.4-main.a4bbb77",
+  "version": "0.8.4-main.abd8ff62ef",
   "description": "Composer plugin for conductor.",
   "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",
+  "imports": {
+    "#plugin": "./src/ConductorPlugin.tsx",
+    "#capabilities": "./src/capabilities/index.ts",
+    "#components": "./src/components/index.ts",
+    "#containers": "./src/containers/index.ts",
+    "#meta": "./src/meta.ts",
+    "#translations": "./src/translations.ts",
+    "#types": "./src/types/index.ts"
+  },
   "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"
+      "node": "./dist/lib/node-esm/index.mjs",
+      "types": "./dist/types/src/index.d.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"
+    "./translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "browser": "./dist/lib/browser/translations.mjs",
+      "node": "./dist/lib/node-esm/translations.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "types": [
-        "dist/types/src/types/index.d.ts"
-      ]
-    }
-  },
   "files": [
     "dist",
     "src"
   ],
   "dependencies": {
-    "@preact-signals/safe-react": "^0.9.0",
-    "effect": "3.18.3",
-    "@dxos/ai": "0.8.4-main.a4bbb77",
-    "@dxos/conductor": "0.8.4-main.a4bbb77",
-    "@dxos/app-framework": "0.8.4-main.a4bbb77",
-    "@dxos/debug": "0.8.4-main.a4bbb77",
-    "@dxos/echo-schema": "0.8.4-main.a4bbb77",
-    "@dxos/echo": "0.8.4-main.a4bbb77",
-    "@dxos/assistant": "0.8.4-main.a4bbb77",
-    "@dxos/edge-client": "0.8.4-main.a4bbb77",
-    "@dxos/live-object": "0.8.4-main.a4bbb77",
-    "@dxos/functions": "0.8.4-main.a4bbb77",
-    "@dxos/log": "0.8.4-main.a4bbb77",
-    "@dxos/plugin-client": "0.8.4-main.a4bbb77",
-    "@dxos/plugin-space": "0.8.4-main.a4bbb77",
-    "@dxos/react-ui-canvas-compute": "0.8.4-main.a4bbb77",
-    "@dxos/react-ui-canvas-editor": "0.8.4-main.a4bbb77",
-    "@dxos/react-ui-stack": "0.8.4-main.a4bbb77",
-    "@dxos/react-client": "0.8.4-main.a4bbb77"
+    "effect": "3.20.0",
+    "@dxos/ai": "0.8.4-main.abd8ff62ef",
+    "@dxos/assistant": "0.8.4-main.abd8ff62ef",
+    "@dxos/app-framework": "0.8.4-main.abd8ff62ef",
+    "@dxos/conductor": "0.8.4-main.abd8ff62ef",
+    "@dxos/echo": "0.8.4-main.abd8ff62ef",
+    "@dxos/compute": "0.8.4-main.abd8ff62ef",
+    "@dxos/debug": "0.8.4-main.abd8ff62ef",
+    "@dxos/log": "0.8.4-main.abd8ff62ef",
+    "@dxos/edge-client": "0.8.4-main.abd8ff62ef",
+    "@dxos/plugin-automation": "0.8.4-main.abd8ff62ef",
+    "@dxos/app-toolkit": "0.8.4-main.abd8ff62ef",
+    "@dxos/react-client": "0.8.4-main.abd8ff62ef",
+    "@dxos/plugin-client": "0.8.4-main.abd8ff62ef",
+    "@dxos/plugin-space": "0.8.4-main.abd8ff62ef",
+    "@dxos/react-ui-canvas-editor": "0.8.4-main.abd8ff62ef",
+    "@dxos/react-ui-canvas-compute": "0.8.4-main.abd8ff62ef",
+    "@dxos/react-ui-mosaic": "0.8.4-main.abd8ff62ef",
+    "@dxos/react-ui-stack": "0.8.4-main.abd8ff62ef",
+    "@dxos/util": "0.8.4-main.abd8ff62ef"
   },
   "devDependencies": {
-    "@types/react": "~19.2.0",
-    "@types/react-dom": "~19.2.0",
-    "react": "~19.2.0",
-    "react-dom": "~19.2.0",
-    "vite": "7.1.9",
-    "@dxos/react-ui": "0.8.4-main.a4bbb77",
-    "@dxos/storybook-utils": "0.8.4-main.a4bbb77",
-    "@dxos/react-ui-theme": "0.8.4-main.a4bbb77"
+    "@types/react": "~19.2.7",
+    "@types/react-dom": "~19.2.3",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "vite": "^8.0.10",
+    "@dxos/plugin-testing": "0.8.4-main.abd8ff62ef",
+    "@dxos/storybook-utils": "0.8.4-main.abd8ff62ef",
+    "@dxos/ui-theme": "0.8.4-main.abd8ff62ef",
+    "@dxos/react-ui": "0.8.4-main.abd8ff62ef"
   },
   "peerDependencies": {
-    "effect": "^3.13.3",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "@dxos/react-ui": "0.8.4-main.a4bbb77",
-    "@dxos/react-ui-theme": "0.8.4-main.a4bbb77"
+    "effect": "3.20.0",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "@dxos/react-ui": "0.8.4-main.abd8ff62ef",
+    "@dxos/ui-theme": "0.8.4-main.abd8ff62ef"
   },
   "publishConfig": {
     "access": "public"

package/src/ConductorPlugin.test.ts

@@ -0,0 +1,27 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { describe, test } from 'vitest';
+
+import { ClientPlugin } from '@dxos/plugin-client';
+import { createComposerTestApp } from '@dxos/plugin-testing/harness';
+
+import { ConductorPlugin } from '#plugin';
+
+import { meta } from './meta';
+
+const moduleId = (name: string) => `${meta.id}.module.${name}`;
+
+describe('ConductorPlugin', () => {
+  test('modules activate on the expected events', async ({ expect }) => {
+    await using harness = await createComposerTestApp({
+      plugins: [ClientPlugin({}), ConductorPlugin()],
+    });
+
+    // Modules expected to be active after a normal startup.
+    expect(harness.manager.getActive()).toEqual(
+      expect.arrayContaining([moduleId('metadata'), moduleId('schema'), moduleId('ReactSurface')]),
+    );
+  });
+});

package/src/ConductorPlugin.tsx

@@ -2,61 +2,46 @@
 // Copyright 2023 DXOS.org
 //
 
-import { Capabilities, Events, contributes, createIntent, defineModule, definePlugin } from '@dxos/app-framework';
+import * as Effect from 'effect/Effect';
+import * as Option from 'effect/Option';
+
+import { Plugin } from '@dxos/app-framework';
+import { AppPlugin } from '@dxos/app-toolkit';
+import { Operation } from '@dxos/compute';
 import { ComputeGraph } from '@dxos/conductor';
-import { FunctionTrigger } from '@dxos/functions';
-import { ClientCapabilities, ClientEvents } from '@dxos/plugin-client';
-import { SpaceCapabilities } from '@dxos/plugin-space';
-import { defineObjectForm } from '@dxos/plugin-space/types';
-import { CanvasBoardType } from '@dxos/react-ui-canvas-editor';
+import { Annotation } from '@dxos/echo';
+import { SpaceOperation } from '@dxos/plugin-space/operations';
+import { type CreateObject } from '@dxos/plugin-space/types';
+import { CanvasBoard } from '@dxos/react-ui-canvas-editor';
 
-import { IntentResolver, ReactSurface } from './capabilities';
-import { meta } from './meta';
-import { translations } from './translations';
-import { ConductorAction } from './types';
+import { ReactSurface } from '#capabilities';
+import { meta } from '#meta';
+import { translations } from '#translations';
 
-export const ConductorPlugin = definePlugin(meta, () => [
-  defineModule({
-    id: `${meta.id}/module/translations`,
-    activatesOn: Events.SetupTranslations,
-    activate: () => contributes(Capabilities.Translations, translations),
-  }),
-  defineModule({
-    id: `${meta.id}/module/metadata`,
-    activatesOn: Events.SetupMetadata,
-    activate: () =>
-      contributes(Capabilities.Metadata, {
-        id: CanvasBoardType.typename,
-        metadata: {
-          icon: 'ph--infinity--regular',
-        },
-      }),
-  }),
-  defineModule({
-    id: `${meta.id}/module/object-form`,
-    activatesOn: ClientEvents.SetupSchema,
-    activate: () =>
-      contributes(
-        SpaceCapabilities.ObjectForm,
-        defineObjectForm({
-          objectSchema: CanvasBoardType,
-          getIntent: () => createIntent(ConductorAction.Create),
-        }),
-      ),
-  }),
-  defineModule({
-    id: `${meta.id}/module/schema`,
-    activatesOn: ClientEvents.SetupSchema,
-    activate: () => contributes(ClientCapabilities.Schema, [ComputeGraph, FunctionTrigger]),
+export const ConductorPlugin = Plugin.define(meta).pipe(
+  AppPlugin.addMetadataModule({
+    metadata: {
+      id: CanvasBoard.CanvasBoard.typename,
+      metadata: {
+        icon: Annotation.IconAnnotation.get(CanvasBoard.CanvasBoard).pipe(Option.getOrThrow).icon,
+        iconHue: Annotation.IconAnnotation.get(CanvasBoard.CanvasBoard).pipe(Option.getOrThrow).hue ?? 'white',
+        createObject: ((props, options) =>
+          Effect.gen(function* () {
+            const object = CanvasBoard.make(props);
+            return yield* Operation.invoke(SpaceOperation.AddObject, {
+              object,
+              target: options.target,
+              hidden: true,
+              targetNodeId: options.targetNodeId,
+            });
+          })) satisfies CreateObject,
+      },
+    },
   }),
-  defineModule({
-    id: `${meta.id}/module/react-surface`,
-    activatesOn: Events.SetupReactSurface,
-    activate: ReactSurface,
-  }),
-  defineModule({
-    id: `${meta.id}/module/intent-resolver`,
-    activatesOn: Events.SetupIntentResolver,
-    activate: IntentResolver,
-  }),
-]);
+  AppPlugin.addSchemaModule({ schema: [CanvasBoard.CanvasBoard, ComputeGraph] }),
+  AppPlugin.addSurfaceModule({ activate: ReactSurface }),
+  AppPlugin.addTranslationsModule({ translations }),
+  Plugin.make,
+);
+
+export default ConductorPlugin;

package/src/capabilities/index.ts

@@ -2,7 +2,6 @@
 // Copyright 2025 DXOS.org
 //
 
-import { lazy } from '@dxos/app-framework';
+import { Capability } from '@dxos/app-framework';
 
-export const IntentResolver = lazy(() => import('./intent-resolver'));
-export const ReactSurface = lazy(() => import('./react-surface'));
+export const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));

package/src/capabilities/react-surface.tsx

@@ -2,22 +2,31 @@
 // Copyright 2025 DXOS.org
 //
 
+import * as Effect from 'effect/Effect';
 import React from 'react';
 
-import { Capabilities, contributes, createSurface } from '@dxos/app-framework';
-import { Obj } from '@dxos/echo';
-import { CanvasBoardType } from '@dxos/react-ui-canvas-editor';
+import { Capabilities, Capability } from '@dxos/app-framework';
+import { Surface } from '@dxos/app-framework/ui';
+import { AppSurface } from '@dxos/app-toolkit/ui';
+import { CanvasBoard } from '@dxos/react-ui-canvas-editor';
 
-import { CanvasContainer } from '../components';
-import { meta } from '../meta';
+import { CanvasContainer } from '#containers';
 
-export default () =>
-  contributes(
-    Capabilities.ReactSurface,
-    createSurface({
-      id: meta.id,
-      role: ['article', 'section'],
-      filter: (data): data is { subject: CanvasBoardType } => Obj.instanceOf(CanvasBoardType, data.subject),
-      component: ({ data, role }) => <CanvasContainer canvas={data.subject} role={role} />,
-    }),
-  );
+export default Capability.makeModule(() =>
+  Effect.succeed(
+    Capability.contributes(
+      Capabilities.ReactSurface,
+      Surface.create({
+        id: 'root',
+        // TODO(wittjosiah): Split into multiple surfaces if this filter proves too strict for non-article roles.
+        filter: AppSurface.oneOf(
+          AppSurface.object(AppSurface.Article, CanvasBoard.CanvasBoard),
+          AppSurface.object(AppSurface.Section, CanvasBoard.CanvasBoard),
+        ),
+        component: ({ data, role }) => (
+          <CanvasContainer role={role} subject={data.subject} attendableId={data.attendableId} />
+        ),
+      }),
+    ),
+  ),
+);

package/src/components/index.ts

@@ -1,7 +1,3 @@
 //
-// Copyright 2023 DXOS.org
+// Copyright 2025 DXOS.org
 //
-
-import { lazy } from 'react';
-
-export const CanvasContainer = lazy(() => import('./CanvasContainer'));

package/src/{components → containers/CanvasContainer}/CanvasContainer.tsx

@@ -2,13 +2,15 @@
 // Copyright 2024 DXOS.org
 //
 
-import React, { useEffect, useMemo, useRef } from 'react';
+import React, { Fragment, useEffect, useMemo, useRef } from 'react';
 
-import { type Config } from '@dxos/client';
+import { useCapability } from '@dxos/app-framework/ui';
+import { type AppSurface } from '@dxos/app-toolkit/ui';
 import { ComputeGraphModel } from '@dxos/conductor';
-import { DatabaseService, QueueService, ServiceContainer } from '@dxos/functions';
-import { useConfig } from '@dxos/react-client';
-import { type Space, fullyQualifiedId, getSpace } from '@dxos/react-client/echo';
+import { Obj } from '@dxos/echo';
+import { AutomationCapabilities } from '@dxos/plugin-automation/types';
+import { useObject } from '@dxos/react-client/echo';
+import { Flex, type FlexProps } from '@dxos/react-ui';
 import {
   ComputeContext,
   ComputeGraphController,
@@ -19,52 +21,24 @@ import {
   useGraphMonitor,
 } from '@dxos/react-ui-canvas-compute';
 import {
-  type CanvasBoardType,
+  type CanvasBoard,
   CanvasGraphModel,
   Editor,
   type EditorController,
   KeyboardContainer,
   ShapeRegistry,
 } from '@dxos/react-ui-canvas-editor';
-import { StackItem } from '@dxos/react-ui-stack';
 
-const createServices = (config: Config, space?: Space): ServiceContainer => {
-  return new ServiceContainer().setServices({
-    database: space == null ? undefined : DatabaseService.make(space.db),
-    queues: space == null ? undefined : QueueService.make(space.queues, undefined),
-  });
-};
-
-const useGraphController = (canvas: CanvasBoardType) => {
-  const config = useConfig();
-  const space = getSpace(canvas);
-  const controller = useMemo(() => {
-    if (!canvas.computeGraph?.target) {
-      return null;
-    }
-    const model = new ComputeGraphModel(canvas.computeGraph?.target);
-    const controller = new ComputeGraphController(createServices(config, space), model);
-    return controller;
-  }, [canvas.computeGraph?.target, space]);
-
-  useEffect(() => {
-    if (!controller) {
-      return;
-    }
+export type CanvasContainerProps = AppSurface.ObjectArticleProps<CanvasBoard.CanvasBoard>;
 
-    void controller.open();
-    return () => {
-      void controller.close();
-    };
-  }, [controller]);
-
-  return controller;
-};
-
-export const CanvasContainer = ({ canvas, role }: { canvas: CanvasBoardType; role: string }) => {
-  const id = fullyQualifiedId(canvas);
-  const graph = useMemo(() => CanvasGraphModel.create<ComputeShape>(canvas.layout), [canvas.layout]);
-  const controller = useGraphController(canvas);
+export const CanvasContainer = ({ role, subject, attendableId: _attendableId }: CanvasContainerProps) => {
+  const [canvas] = useObject(subject);
+  const id = Obj.getDXN(canvas).toString();
+  const graph = useMemo(
+    () => CanvasGraphModel.create<ComputeShape>(canvas.layout, (fn) => Obj.update(subject, fn)),
+    [subject, canvas.layout],
+  );
+  const controller = useGraphController(subject);
   const graphMonitor = useGraphMonitor(controller?.graph);
   const registry = useMemo(() => new ShapeRegistry(computeShapes), []);
   const editorRef = useRef<EditorController>(null);
@@ -80,9 +54,11 @@ export const CanvasContainer = ({ canvas, role }: { canvas: CanvasBoardType; rol
     return;
   }
 
+  const Root = role === 'section' ? Container : Fragment;
+
   return (
     <ComputeContext.Provider value={{ controller }}>
-      <StackItem.Content size={role === 'section' ? 'square' : 'intrinsic'}>
+      <Root>
         <KeyboardContainer id={id}>
           <Editor.Root
             id={id}
@@ -96,9 +72,36 @@ export const CanvasContainer = ({ canvas, role }: { canvas: CanvasBoardType; rol
             <Editor.UI showTools />
           </Editor.Root>
         </KeyboardContainer>
-      </StackItem.Content>
+      </Root>
     </ComputeContext.Provider>
   );
 };
 
-export default CanvasContainer;
+const Container = (props: FlexProps) => <Flex {...props} classNames='aspect-square' />;
+
+const useGraphController = (canvas: CanvasBoard.CanvasBoard) => {
+  const db = Obj.getDatabase(canvas);
+  const runtime = useCapability(AutomationCapabilities.ComputeRuntime);
+  const [computeGraph] = useObject(canvas.computeGraph);
+  const controller = useMemo(() => {
+    if (!canvas.computeGraph?.target || !db) {
+      return null;
+    }
+    const model = new ComputeGraphModel(canvas.computeGraph?.target);
+    const controller = new ComputeGraphController(runtime.getRuntime(db.spaceId), model);
+    return controller;
+  }, [computeGraph, db]);
+
+  useEffect(() => {
+    if (!controller) {
+      return;
+    }
+
+    void controller.open();
+    return () => {
+      void controller.close();
+    };
+  }, [controller]);
+
+  return controller;
+};

package/src/containers/CanvasContainer/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+export { CanvasContainer as default } from './CanvasContainer';

package/src/containers/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { type ComponentType, lazy } from 'react';
+
+export const CanvasContainer: ComponentType<any> = lazy(() => import('./CanvasContainer'));

package/src/index.ts

@@ -2,5 +2,10 @@
 // Copyright 2023 DXOS.org
 //
 
-export * from './ConductorPlugin';
+import { Plugin } from '@dxos/app-framework';
+
+import { meta } from './meta';
+
+export const ConductorPlugin = Plugin.lazy(meta, () => import('./ConductorPlugin'));
+
 export * from './meta';

package/src/meta.ts

@@ -2,14 +2,18 @@
 // Copyright 2023 DXOS.org
 //
 
-import { type PluginMeta } from '@dxos/app-framework';
+import { type Plugin } from '@dxos/app-framework';
+import { trim } from '@dxos/util';
 
-export const meta: PluginMeta = {
-  id: 'dxos.org/plugin/conductor',
+export const meta: Plugin.Meta = {
+  id: 'org.dxos.plugin.conductor',
   name: 'Conductor',
-  description:
-    'Conductor allows you to build a node based compute graph that can handle complex workflows inside of Composer. Leverage your collaborative data along with custom scripts to orchestrate agentic workflows that operate in the background.',
+  description: trim`
+    Visual workflow builder using node-based compute graphs to orchestrate complex AI agent pipelines.
+    Connect data sources, transformations, and AI models in a drag-and-drop interface for advanced automation.
+  `,
   icon: 'ph--infinity--regular',
+  iconHue: 'sky',
   source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-conductor',
   tags: ['labs'],
   screenshots: ['https://dxos.network/plugin-details-canvas-dark.png'],

package/src/translations.ts

@@ -3,25 +3,27 @@
 //
 
 import { type Resource } from '@dxos/react-ui';
-import { CanvasBoardType } from '@dxos/react-ui-canvas-editor';
+import { CanvasBoard } from '@dxos/react-ui-canvas-editor';
 
-import { meta } from './meta';
+import { meta } from '#meta';
 
 export const translations = [
   {
     'en-US': {
-      [CanvasBoardType.typename]: {
-        'typename label': 'Circuit',
-        'typename label_zero': 'Circuits',
-        'typename label_one': 'Circuit',
-        'typename label_other': 'Circuits',
-        'object name placeholder': 'New circuit',
-        'rename object label': 'Rename circuit',
-        'delete object label': 'Delete circuit',
+      [CanvasBoard.CanvasBoard.typename]: {
+        'typename.label': 'Circuit',
+        'typename.label_zero': 'Circuits',
+        'typename.label_one': 'Circuit',
+        'typename.label_other': 'Circuits',
+        'object-name.placeholder': 'New circuit',
+        'add-object.label': 'Add circuit',
+        'rename-object.label': 'Rename circuit',
+        'delete-object.label': 'Delete circuit',
+        'object-deleted.label': 'Circuit deleted',
       },
       [meta.id]: {
-        'plugin name': 'Conductor',
-        'content placeholder': 'Enter text...',
+        'plugin.name': 'Conductor',
+        'content.placeholder': 'Enter text...',
       },
     },
   },

package/src/types/index.ts

@@ -1,5 +1,3 @@
 //
 // Copyright 2025 DXOS.org
 //
-
-export * from './schema';