@dxos/plugin-conductor 0.7.5-staging.e6154f3

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@dxos/plugin-conductor",
+  "version": "0.7.5-staging.e6154f3",
+  "description": "Composer plugin for conductor.",
+  "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": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@dxos/app-framework": "0.7.5-staging.e6154f3",
+    "@dxos/assistant": "0.7.5-staging.e6154f3",
+    "@dxos/conductor": "0.7.5-staging.e6154f3",
+    "@dxos/edge-client": "0.7.5-staging.e6154f3",
+    "@dxos/echo-schema": "0.7.5-staging.e6154f3",
+    "@dxos/functions": "0.7.5-staging.e6154f3",
+    "@dxos/live-object": "0.7.5-staging.e6154f3",
+    "@dxos/log": "0.7.5-staging.e6154f3",
+    "@dxos/plugin-client": "0.7.5-staging.e6154f3",
+    "@dxos/plugin-space": "0.7.5-staging.e6154f3",
+    "@dxos/react-ui-canvas-compute": "0.7.5-staging.e6154f3",
+    "@dxos/react-ui-canvas-editor": "0.7.5-staging.e6154f3",
+    "@dxos/react-ui-stack": "0.7.5-staging.e6154f3",
+    "@dxos/react-client": "0.7.5-staging.e6154f3"
+  },
+  "devDependencies": {
+    "@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.5-staging.e6154f3",
+    "@dxos/react-ui-theme": "0.7.5-staging.e6154f3",
+    "@dxos/storybook-utils": "0.7.5-staging.e6154f3"
+  },
+  "peerDependencies": {
+    "react": "~18.2.0",
+    "react-dom": "~18.2.0",
+    "@dxos/react-ui": "0.7.5-staging.e6154f3",
+    "@dxos/react-ui-theme": "0.7.5-staging.e6154f3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/ConductorPlugin.tsx

@@ -0,0 +1,64 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { Capabilities, contributes, createIntent, defineModule, definePlugin, Events } from '@dxos/app-framework';
+import { ComputeGraph } from '@dxos/conductor';
+import { FunctionTrigger } from '@dxos/functions/types';
+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 { IntentResolver, ReactSurface } from './capabilities';
+import { CONDUCTOR_PLUGIN, meta } from './meta';
+import translations from './translations';
+import { ConductorAction } from './types';
+
+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: {
+            placeholder: ['canvas title placeholder', { ns: CONDUCTOR_PLUGIN }],
+            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]),
+    }),
+    defineModule({
+      id: `${meta.id}/module/react-surface`,
+      activatesOn: Events.SetupReactSurface,
+      activate: ReactSurface,
+    }),
+    defineModule({
+      id: `${meta.id}/module/intent-resolver`,
+      activatesOn: Events.SetupIntentResolver,
+      activate: IntentResolver,
+    }),
+  ]);

package/src/capabilities/index.ts

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

package/src/capabilities/intent-resolver.ts

@@ -0,0 +1,27 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capabilities, contributes, createResolver } from '@dxos/app-framework';
+import { ComputeGraph } from '@dxos/conductor';
+import { create, makeRef } from '@dxos/live-object';
+import { CanvasBoardType } from '@dxos/react-ui-canvas-editor';
+
+import { ConductorAction } from '../types';
+
+export default () =>
+  contributes(
+    Capabilities.IntentResolver,
+    createResolver({
+      intent: ConductorAction.Create,
+      resolve: ({ name }) => ({
+        data: {
+          object: create(CanvasBoardType, {
+            name,
+            computeGraph: makeRef(create(ComputeGraph, { graph: { nodes: [], edges: [] } })),
+            layout: { nodes: [], edges: [] },
+          }),
+        },
+      }),
+    }),
+  );

package/src/capabilities/react-surface.tsx

@@ -0,0 +1,22 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import React from 'react';
+
+import { Capabilities, contributes, createSurface } from '@dxos/app-framework';
+import { CanvasBoardType } from '@dxos/react-ui-canvas-editor';
+
+import { CanvasContainer } from '../components';
+import { CONDUCTOR_PLUGIN } from '../meta';
+
+export default () =>
+  contributes(
+    Capabilities.ReactSurface,
+    createSurface({
+      id: CONDUCTOR_PLUGIN,
+      role: ['article', 'section'],
+      filter: (data): data is { subject: CanvasBoardType } => data.subject instanceof CanvasBoardType,
+      component: ({ data, role }) => <CanvasContainer canvas={data.subject} role={role} />,
+    }),
+  );

package/src/components/CanvasContainer.tsx

@@ -0,0 +1,121 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import React, { useEffect, useMemo, useRef } from 'react';
+
+import { AIServiceClientImpl } from '@dxos/assistant';
+import { type Config } from '@dxos/client';
+import { ComputeGraphModel, EdgeGpt } from '@dxos/conductor';
+import { createStubEdgeIdentity, EdgeClient, EdgeHttpClient } from '@dxos/edge-client';
+import { useConfig } from '@dxos/react-client';
+import { fullyQualifiedId, getSpace, type Space } from '@dxos/react-client/echo';
+import {
+  ComputeContext,
+  ComputeGraphController,
+  type ComputeShape,
+  ComputeShapeLayout,
+  computeShapes,
+  type Services,
+  useGraphMonitor,
+} from '@dxos/react-ui-canvas-compute';
+import {
+  type CanvasBoardType,
+  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): Partial<Services> => {
+  return {
+    spaceService:
+      space == null
+        ? undefined
+        : {
+            spaceId: space.id,
+            db: space.db,
+          },
+    gpt:
+      config.values.runtime?.services?.ai?.server == null
+        ? undefined
+        : new EdgeGpt(new AIServiceClientImpl({ endpoint: config.values.runtime?.services?.ai?.server })),
+    edgeClient:
+      config.values.runtime?.services?.edge?.url == null
+        ? undefined
+        : new EdgeClient(createStubEdgeIdentity(), { socketEndpoint: config.values.runtime?.services?.edge?.url }),
+    edgeHttpClient:
+      config.values.runtime?.services?.edge?.url == null
+        ? undefined
+        : new EdgeHttpClient(config.values.runtime?.services?.edge?.url),
+  };
+};
+
+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(model);
+    controller.setServices(createServices(config, space));
+    return controller;
+  }, [canvas.computeGraph?.target, space]);
+
+  useEffect(() => {
+    if (!controller) {
+      return;
+    }
+    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);
+  const graphMonitor = useGraphMonitor(controller?.graph);
+  const registry = useMemo(() => new ShapeRegistry(computeShapes), []);
+  const editorRef = useRef<EditorController>(null);
+
+  // Layout.
+  const layout = useMemo(
+    () => (controller && registry ? new ComputeShapeLayout(controller, registry) : undefined),
+    [controller, registry],
+  );
+
+  if (!controller) {
+    return;
+  }
+
+  return (
+    <ComputeContext.Provider value={{ controller }}>
+      <StackItem.Content toolbar={false} size={role === 'section' ? 'square' : 'intrinsic'}>
+        <KeyboardContainer id={id}>
+          <Editor.Root
+            id={id}
+            ref={editorRef}
+            graph={graph}
+            graphMonitor={graphMonitor as any}
+            registry={registry}
+            layout={layout}
+          >
+            <Editor.Canvas />
+            <Editor.UI showTools />
+          </Editor.Root>
+        </KeyboardContainer>
+      </StackItem.Content>
+    </ComputeContext.Provider>
+  );
+};
+
+export default CanvasContainer;

package/src/components/index.ts

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

package/src/index.ts

@@ -0,0 +1,6 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+export * from './ConductorPlugin';
+export * from './meta';

package/src/meta.ts

@@ -0,0 +1,18 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { type PluginMeta } from '@dxos/app-framework';
+
+export const CONDUCTOR_PLUGIN = 'dxos.org/plugin/conductor';
+
+export const meta = {
+  id: CONDUCTOR_PLUGIN,
+  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.',
+  icon: 'ph--infinity--regular',
+  source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/experimental/plugin-conductor',
+  tags: ['experimental'],
+  screenshots: ['https://dxos.network/plugin-details-canvas-dark.png'],
+} satisfies PluginMeta;

package/src/sanity.test.ts

@@ -0,0 +1,11 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { expect, test } from 'vitest';
+
+// TODO(dmaretskyi): For some reason vitest hangs if there are no test files in a package.
+
+test('sanity', () => {
+  expect(true).toBe(true);
+});

package/src/translations.ts

@@ -0,0 +1,23 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { CanvasBoardType } from '@dxos/react-ui-canvas-editor';
+
+import { CONDUCTOR_PLUGIN } from './meta';
+
+export default [
+  {
+    'en-US': {
+      [CanvasBoardType.typename]: {
+        'typename label': 'Circuit',
+      },
+      [CONDUCTOR_PLUGIN]: {
+        'plugin name': 'Conductor',
+        'canvas title placeholder': 'New circuit',
+        'create canvas label': 'Create circuit',
+        'content placeholder': 'Enter text...',
+      },
+    },
+  },
+];

package/src/types.ts

@@ -0,0 +1,21 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { S } from '@dxos/echo-schema';
+import { CanvasBoardType } from '@dxos/react-ui-canvas-editor';
+
+import { CONDUCTOR_PLUGIN } from './meta';
+
+export namespace ConductorAction {
+  const CONDUCTOR_ACTION = `${CONDUCTOR_PLUGIN}/action`;
+
+  export class Create extends S.TaggedClass<Create>()(`${CONDUCTOR_ACTION}/create`, {
+    input: S.Struct({
+      name: S.optional(S.String),
+    }),
+    output: S.Struct({
+      object: CanvasBoardType,
+    }),
+  }) {}
+}