@dxos/plugin-automation 0.8.4-main.f9ba587 → 0.8.4-main.fcfe5033a5

package/src/containers/FunctionsContainer/FunctionsContainer.tsx

@@ -0,0 +1,34 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import React from 'react';
+
+import { type Space } from '@dxos/react-client/echo';
+import { useTranslation } from '@dxos/react-ui';
+import { Settings } from '@dxos/react-ui-form';
+
+import { meta } from '#meta';
+
+import { FunctionsPanel } from '../../components/FunctionsPanel';
+import { FunctionsRegistry } from '../../components/FunctionsRegistry';
+
+export const FunctionsContainer = ({ space }: { space: Space }) => {
+  const { t } = useTranslation(meta.id);
+  return (
+    <Settings.Viewport>
+      <Settings.Section
+        title={t('functions-verbose.label', { ns: meta.id })}
+        description={t('functions.description', { ns: meta.id })}
+      >
+        <FunctionsPanel space={space} />
+      </Settings.Section>
+      <Settings.Section
+        title={t('functions-registry-verbose.label', { ns: meta.id })}
+        description={t('functions-registry.description', { ns: meta.id })}
+      >
+        <FunctionsRegistry space={space} />
+      </Settings.Section>
+    </Settings.Viewport>
+  );
+};

package/src/containers/FunctionsContainer/index.ts

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

package/src/containers/TriggerSettings/TriggerSettings.tsx

@@ -0,0 +1,26 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import React from 'react';
+
+import { type Database } from '@dxos/echo';
+import { Input, useTranslation } from '@dxos/react-ui';
+import { Settings } from '@dxos/react-ui-form';
+
+import { useTriggerRuntimeControls } from '#hooks';
+import { meta } from '#meta';
+
+export const TriggersSettings = ({ db }: { db: Database.Database }) => {
+  const { state, start, stop } = useTriggerRuntimeControls(db);
+  const isRunning = state?.enabled ?? false;
+  const { t } = useTranslation(meta.id);
+
+  return (
+    <div className='grid grid-cols-1 md:grid-cols-[1fr_min-content]'>
+      <Settings.Item title={t('runtime.label')} description={t('runtime.description')}>
+        <Input.Switch classNames='justify-self-end' checked={isRunning} onCheckedChange={isRunning ? stop : start} />
+      </Settings.Item>
+    </div>
+  );
+};

package/src/containers/TriggerSettings/index.ts

@@ -0,0 +1,6 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+export { TriggersSettings } from './TriggerSettings';
+export { TriggersSettings as default } from './TriggerSettings';

package/src/containers/index.ts

@@ -0,0 +1,9 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { type ComponentType, lazy } from 'react';
+
+export const AutomationSettings: ComponentType<any> = lazy(() => import('./AutomationSettings'));
+export const FunctionsContainer: ComponentType<any> = lazy(() => import('./FunctionsContainer'));
+export const TriggerSettings: ComponentType<any> = lazy(() => import('./TriggerSettings'));

package/src/hooks/index.ts

@@ -0,0 +1,9 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+// TODO(wittjosiah): Factor out.
+export * from './useComputeRuntimeCallback';
+export * from './useTriggerRuntimeControls';
+export * from './useComputeRuntime';
+export * from './useComputeRuntimeService';

package/src/hooks/useComputeRuntime.ts

@@ -0,0 +1,21 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { useCapabilities } from '@dxos/app-framework/ui';
+import { SpaceId } from '@dxos/keys';
+
+import { AutomationCapabilities } from '../types';
+
+/**
+ * Resolves the compute runtime for a space.
+ * Returns undefined if the AutomationPlugin is not loaded or spaceId is not provided.
+ */
+export const useComputeRuntime = (id: SpaceId | undefined): AutomationCapabilities.ComputeRuntime | undefined => {
+  const [computeRuntime] = useCapabilities(AutomationCapabilities.ComputeRuntime);
+  if (!computeRuntime || id === undefined) {
+    return undefined;
+  }
+
+  return computeRuntime.getRuntime(id);
+};

package/src/hooks/useComputeRuntimeCallback.ts

@@ -0,0 +1,32 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+import { type DependencyList, useCallback } from 'react';
+
+import { type Key } from '@dxos/echo';
+
+import { AutomationCapabilities } from '#types';
+
+import { useComputeRuntime } from './useComputeRuntime';
+
+/**
+ * Create an effectful function that has access to compute services
+ */
+// TODO(burdon): Factor out (figure out cross-plugin capabilities dependencies).
+export const useComputeRuntimeCallback = <T>(
+  id: Key.SpaceId | undefined,
+  fn: () => Effect.Effect<T, any, AutomationCapabilities.ComputeServices>,
+  deps?: DependencyList,
+): (() => Promise<T>) => {
+  const runtime = useComputeRuntime(id);
+
+  return useCallback(() => {
+    if (!runtime) {
+      throw new TypeError('Space not provided to useComputeRuntimeCallback');
+    }
+
+    return runtime.runPromise(fn());
+  }, [runtime, ...(deps ?? [])]);
+};

package/src/hooks/useComputeRuntimeService.ts

@@ -0,0 +1,25 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Context from 'effect/Context';
+import { use, useMemo } from 'react';
+
+import { unwrapExit } from '@dxos/effect';
+import { SpaceId } from '@dxos/keys';
+
+import { AutomationCapabilities } from '../types';
+import { useComputeRuntime } from './useComputeRuntime';
+
+export const useComputeRuntimeService = <T extends Context.Tag<any, any>>(
+  tag: T,
+  spaceId?: SpaceId,
+): (Context.Tag.Service<T> & AutomationCapabilities.ComputeRuntime) | undefined => {
+  const runtime = useComputeRuntime(spaceId);
+  if (!runtime) {
+    return undefined;
+  }
+
+  // TODO(burdon): This introduces a suspension point which may not terminate.
+  return unwrapExit(use(useMemo(() => runtime.runPromiseExit(tag), [runtime, tag])));
+};

package/src/hooks/useTriggerRuntimeControls.ts

@@ -0,0 +1,67 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Atom, useAtomValue } from '@effect-atom/atom-react';
+import type * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import { useEffect, useState } from 'react';
+
+import { type Database, Filter } from '@dxos/echo';
+import { Trigger } from '@dxos/functions';
+import { TriggerDispatcher, type TriggerDispatcherState } from '@dxos/functions-runtime';
+import { useQuery } from '@dxos/react-client/echo';
+
+import { useComputeRuntimeCallback } from './useComputeRuntimeCallback';
+
+interface TriggerRuntimeControls {
+  triggers: Trigger.Trigger[];
+
+  state: TriggerDispatcherState | undefined;
+
+  start: () => void;
+  stop: () => void;
+}
+
+export const useTriggerRuntimeControls = (db: Database.Database | undefined): TriggerRuntimeControls => {
+  const triggers = useQuery(db, Filter.type(Trigger.Trigger));
+
+  const [dispatcher, setDispatcher] = useState<Context.Tag.Service<TriggerDispatcher> | undefined>(undefined);
+
+  const init = useComputeRuntimeCallback(
+    db?.spaceId,
+    Effect.fnUntraced(function* () {
+      const dispatcher = yield* TriggerDispatcher;
+      setDispatcher(dispatcher);
+    }),
+  );
+
+  useEffect(() => {
+    void init();
+  }, []);
+
+  const state = useAtomValue(dispatcher?.state ?? Atom.make(undefined));
+
+  const start = useComputeRuntimeCallback(
+    db?.spaceId,
+    Effect.fnUntraced(function* () {
+      const dispatcher = yield* TriggerDispatcher;
+      yield* dispatcher.start();
+    }),
+  );
+
+  const stop = useComputeRuntimeCallback(
+    db?.spaceId,
+    Effect.fnUntraced(function* () {
+      const dispatcher = yield* TriggerDispatcher;
+      yield* dispatcher.stop();
+    }),
+  );
+
+  return {
+    triggers,
+    state,
+    start: () => void start(),
+    stop: () => void stop(),
+  };
+};

package/src/index.ts

@@ -2,7 +2,5 @@
 // Copyright 2023 DXOS.org
 //
 
-export * from './components';
-export * from './meta';
-
-export * from './AutomationPlugin';
+export { AutomationPlugin } from './AutomationPlugin';
+export { meta } from './meta';

package/src/meta.ts

@@ -2,15 +2,16 @@
 // 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 AUTOMATION_PLUGIN = 'dxos.org/plugin/automation';
-
-export const meta: PluginMeta = {
-  id: AUTOMATION_PLUGIN,
+export const meta: Plugin.Meta = {
+  id: 'org.dxos.plugin.automation',
   name: 'Automation',
-  description:
-    'The Automation tab allows you to trigger pre-defined workflows related to the element you are interacting with inside of Composer.',
-  icon: 'ph--robot--regular',
+  description: trim`
+    Workflow automation engine that triggers custom actions based on object events and conditions.
+    Create automated pipelines that respond to changes and streamline repetitive tasks.
+  `,
+  icon: 'ph--atom--regular',
   source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-automation',
 };

package/src/operations/create-trigger-from-template.ts

@@ -0,0 +1,72 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { LayoutOperation, getSpacePath } from '@dxos/app-toolkit';
+import { Obj, Ref } from '@dxos/echo';
+import { Script, Trigger } from '@dxos/functions';
+import { type DXN } from '@dxos/keys';
+import { Operation } from '@dxos/operation';
+import { SpaceOperation } from '@dxos/plugin-space/operations';
+import { Filter } from '@dxos/react-client/echo';
+
+import { meta } from '#meta';
+
+import { CreateTriggerFromTemplate } from './definitions';
+
+const handler: Operation.WithHandler<typeof CreateTriggerFromTemplate> = CreateTriggerFromTemplate.pipe(
+  Operation.withHandler(
+    Effect.fnUntraced(function* ({ db, template, enabled = false, scriptName, input }) {
+      const trigger = Trigger.make({ enabled, input });
+
+      // TODO(wittjosiah): Factor out function lookup by script name?
+      if (scriptName) {
+        const scripts = yield* Effect.promise(() => db.query(Filter.type(Script.Script, { name: scriptName })).run());
+        const [script] = scripts;
+        if (script) {
+          const functions = yield* Effect.promise(() =>
+            db.query(Filter.type(Operation.PersistentOperation, { source: Ref.make(script) })).run(),
+          );
+          const [fn] = functions;
+          if (fn) {
+            Obj.change(trigger, (trigger) => {
+              trigger.function = Ref.make(fn);
+            });
+          }
+        }
+      }
+
+      switch (template.type) {
+        case 'timer': {
+          Obj.change(trigger, (trigger) => {
+            trigger.spec = Trigger.specTimer(template.cron);
+          });
+          break;
+        }
+        case 'queue': {
+          Obj.change(trigger, (trigger) => {
+            trigger.spec = Trigger.specQueue((template.queueDXN as DXN).toString());
+          });
+          break;
+        }
+        default: {
+          break;
+        }
+      }
+
+      yield* Operation.invoke(SpaceOperation.AddObject, {
+        object: trigger,
+        target: db,
+        hidden: true,
+      });
+      yield* Operation.invoke(LayoutOperation.Open, {
+        subject: [`${getSpacePath(db.spaceId)}/settings/${meta.id}.automations`],
+        workspace: getSpacePath(db.spaceId),
+      });
+    }),
+  ),
+);
+
+export default handler;

package/src/operations/definitions.ts

@@ -0,0 +1,28 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Schema from 'effect/Schema';
+
+import { Capability } from '@dxos/app-framework';
+import { Database } from '@dxos/echo';
+import { Operation } from '@dxos/operation';
+
+import { meta } from '#meta';
+
+import { TriggerTemplate } from '../types';
+
+const AUTOMATION_OPERATION = `${meta.id}.operation`;
+
+export const CreateTriggerFromTemplate = Operation.make({
+  meta: { key: `${AUTOMATION_OPERATION}.create-trigger-from-template`, name: 'Create Trigger From Template' },
+  services: [Capability.Service],
+  input: Schema.Struct({
+    db: Database.Database,
+    template: TriggerTemplate,
+    enabled: Schema.optional(Schema.Boolean),
+    scriptName: Schema.optional(Schema.String),
+    input: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.Any })),
+  }),
+  output: Schema.Void,
+});

package/src/operations/index.ts

@@ -0,0 +1,9 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { OperationHandlerSet } from '@dxos/operation';
+
+export * as AutomationOperation from './definitions';
+
+export const AutomationOperationHandlerSet = OperationHandlerSet.lazy(() => import('./create-trigger-from-template'));

package/src/testing/test-functions.ts

@@ -2,16 +2,17 @@
 // Copyright 2024 DXOS.org
 //
 
-import { Schema } from 'effect';
+import * as Schema from 'effect/Schema';
 
-import { ContactType } from '@dxos/client/testing';
-import { Type } from '@dxos/echo';
+import { TestSchema } from '@dxos/client/testing';
+import { JsonSchema, Ref } from '@dxos/echo';
 
 export const functions = [
   {
+    key: 'example.com/function/chess',
     name: 'example.com/function/chess',
     version: '0.1.0',
-    inputSchema: Type.toJsonSchema(
+    inputSchema: JsonSchema.toJsonSchema(
       Schema.Struct({
         level: Schema.Number.annotations({
           title: 'Level',
@@ -20,10 +21,11 @@ export const functions = [
     ),
   },
   {
+    key: 'example.com/function/forex',
     name: 'example.com/function/forex',
     version: '0.1.0',
     binding: 'FOREX',
-    inputSchema: Type.toJsonSchema(
+    inputSchema: JsonSchema.toJsonSchema(
       Schema.Struct({
         from: Schema.String.annotations({ title: 'Currency from' }),
         to: Schema.String.annotations({ title: 'Currency to' }),
@@ -31,11 +33,12 @@ export const functions = [
     ),
   },
   {
+    key: 'example.com/function/ping-contact',
     name: 'example.com/function/ping-contact',
     version: '0.0.1',
-    inputSchema: Type.toJsonSchema(
+    inputSchema: JsonSchema.toJsonSchema(
       Schema.Struct({
-        contact: Type.Ref(ContactType).annotations({ title: 'Contact' }),
+        contact: Ref.Ref(TestSchema.ContactType).annotations({ title: 'Contact' }),
       }),
     ),
   },

package/src/translations.ts

@@ -4,40 +4,48 @@
 
 import { type Resource } from '@dxos/react-ui';
 
-import { meta } from './meta';
+import { meta } from '#meta';
 
 export const translations = [
   {
     'en-US': {
       [meta.id]: {
-        'plugin name': 'Automation',
-        'automation panel label': 'Automations',
-        'script automation label': 'Automation',
-        'automation verbose label': 'Manage automations',
-        'automation description': 'You can manage all the triggers which automate your space here.',
-
-        'functions panel label': 'Functions',
-        'functions verbose label': 'Manage deployed functions',
-        'functions description': 'You can manage all the functions deployed from your space on EDGE here.',
-        'function copy id': 'Copy Function ID',
-        'no functions found': 'No functions found',
-        'go to function source button label': 'Show function source',
-
-        'trigger editor title': 'Configure Trigger',
-        'new trigger label': 'Add Trigger',
-        'trigger type timer': 'Timer',
-        'trigger type webhook': 'Webhook',
-        'trigger type websocket': 'Websocket',
-        'trigger type subscription': 'Subscription',
-        'trigger type email': 'Email',
-        'trigger type queue': 'Queue',
-
-        'trigger copy url': 'Copy URL',
-        'trigger copy email': 'Copy Email',
-
-        'trigger payload add': 'Add',
-        'trigger payload remove': 'Remove',
-        'trigger payload prop name placeholder': 'New payload property name',
+        'plugin.name': 'Automation',
+        'automation-panel.label': 'Automations',
+        'script-automation.label': 'Automation',
+        'automation-verbose.label': 'Manage automations',
+        'automation.description': 'You can manage all the triggers which automate your space here.',
+
+        'runtime.label': 'Enable Local Runtime',
+        'runtime.description':
+          'This will start a trigger dispatcher locally for this space to run triggers on your device while Composer is running.',
+
+        'functions-panel.label': 'Functions',
+        'functions-verbose.label': 'Manage deployed functions',
+        'functions-registry-verbose.label': 'Functions registry',
+        'functions-registry.description': 'Import functions from the registry',
+        'functions.description': 'You can manage all the functions deployed from your space on EDGE here.',
+        'show-source-button.label': 'Show source',
+        'delete-function-button.label': 'Delete function',
+
+        'function-parameters.label': 'Function parameters',
+
+        'trigger-editor.title': 'Configure Trigger',
+        'trigger-editor.description':
+          'Triggers are used to run functions at specific times or when specific events occur.',
+        'new-trigger.label': 'Add Trigger',
+
+        'trigger-type.timer.label': 'Timer',
+        'trigger-type.webhook.label': 'Webhook',
+        'trigger-type.websocket.label': 'Websocket',
+        'trigger-type.subscription.label': 'Subscription',
+        'trigger-type.email.label': 'Email',
+        'trigger-type.queue.label': 'Feed',
+
+        'trigger-payload-prop-name.placeholder': 'New payload property name',
+        'import-function-button.label': 'Loading...',
+        'loading-functions.message': 'Loading functions...',
+        'update-function-button.label': 'Update',
       },
     },
   },

package/src/types/capabilities.ts

@@ -0,0 +1,47 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import type * as ManagedRuntime from 'effect/ManagedRuntime';
+
+import { type AiService, type OpaqueToolkit } from '@dxos/ai';
+import { Capability } from '@dxos/app-framework';
+import { AgentService } from '@dxos/assistant';
+import type { Blueprint } from '@dxos/blueprints';
+import { type Database, type Feed } from '@dxos/echo';
+import type { CredentialsService, Process, QueueService } from '@dxos/functions';
+import type { TriggerDispatcher, TriggerStateStore } from '@dxos/functions-runtime';
+import type { SpaceId } from '@dxos/keys';
+import type { Operation, OperationRegistry } from '@dxos/operation';
+
+import { meta } from '#meta';
+
+export namespace AutomationCapabilities {
+  /**
+   * Service stack for executing agents, functions, and triggers.
+   */
+  export type ComputeServices =
+    | TriggerDispatcher
+    | TriggerStateStore
+    | AiService.AiService
+    | Database.Service
+    | Feed.FeedService
+    | QueueService
+    | CredentialsService
+    | Blueprint.RegistryService
+    | AgentService.AgentService
+    | Process.ProcessMonitorService
+    | Operation.Service
+    | OperationRegistry.Service
+    | OpaqueToolkit.OpaqueToolkitProvider;
+
+  export type ComputeRuntime = ManagedRuntime.ManagedRuntime<AutomationCapabilities.ComputeServices, never>;
+  export interface ComputeRuntimeProvider {
+    getRuntime(spaceId: SpaceId): ComputeRuntime;
+  }
+
+  /**
+   * Runtime for executing agents, functions, and triggers.
+   */
+  export const ComputeRuntime = Capability.make<ComputeRuntimeProvider>(`${meta.id}.capability.compute-runtime`);
+}

package/src/types/events.ts

@@ -0,0 +1,11 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { ActivationEvent } from '@dxos/app-framework';
+
+import { meta } from '#meta';
+
+export namespace AutomationEvents {
+  export const ComputeRuntimeReady = ActivationEvent.make(`${meta.id}.event.compute-runtime-ready`);
+}

package/src/types/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+export * from './capabilities';
+export * from './events';
+export * from './schema';

package/src/{types.ts → types/schema.ts}

@@ -2,25 +2,23 @@
 // Copyright 2025 DXOS.org
 //
 
-import { Schema } from 'effect';
+import * as Schema from 'effect/Schema';
 
-import { SpaceSchema } from '@dxos/react-client/echo';
+import { Database } from '@dxos/echo';
 
-import { AUTOMATION_PLUGIN } from './meta';
+import { meta } from '#meta';
 
-const TriggerTemplate = Schema.Union(
+export const TriggerTemplate = Schema.Union(
   Schema.Struct({ type: Schema.Literal('timer'), cron: Schema.String }),
   Schema.Struct({ type: Schema.Literal('queue'), queueDXN: Schema.Any }),
 );
 
 export namespace AutomationAction {
-  const AUTOMATION_ACTION = `${AUTOMATION_PLUGIN}/action`;
-
   export class CreateTriggerFromTemplate extends Schema.TaggedClass<CreateTriggerFromTemplate>()(
-    `${AUTOMATION_ACTION}/create-trigger-from-template`,
+    `${meta.id}.action.create-trigger-from-template`,
     {
       input: Schema.Struct({
-        space: SpaceSchema,
+        db: Database.Database,
         template: TriggerTemplate,
         enabled: Schema.optional(Schema.Boolean),
         // TODO(wittjosiah): Improve how this lookup is done.