@dxos/plugin-automation 0.8.4-main.72ec0f3 → 0.8.4-main.74a063c4e0

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

@@ -2,5 +2,8 @@
 // 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,16 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { useCapability } from '@dxos/app-framework/ui';
+import { SpaceId } from '@dxos/keys';
+
+import { AutomationCapabilities } from '../types';
+
+/**
+ * Resolves the compute runtime for a space.
+ */
+export const useComputeRuntime = (id: SpaceId | undefined): AutomationCapabilities.ComputeRuntime | undefined => {
+  const computeRuntime = useCapability(AutomationCapabilities.ComputeRuntime);
+  return id !== undefined ? computeRuntime.getRuntime(id) : undefined;
+};

package/src/hooks/useComputeRuntimeCallback.ts

@@ -2,30 +2,25 @@
 // Copyright 2025 DXOS.org
 //
 
-import * as Cause from 'effect/Cause';
 import * as Effect from 'effect/Effect';
-import * as Exit from 'effect/Exit';
-import { useCallback } from 'react';
+import { type DependencyList, useCallback } from 'react';
 
-import { useCapability } from '@dxos/app-framework/react';
-import { type FunctionDefinition, FunctionInvocationService } from '@dxos/functions';
-import { InvocationTracer, TracingServiceExt } from '@dxos/functions-runtime';
-import { log } from '@dxos/log';
-import type { Space } from '@dxos/react-client/echo';
+import { type Key } from '@dxos/echo';
 
-import { AutomationCapabilities } from '../capabilities';
+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>(
-  space: Space | undefined,
+  id: Key.SpaceId | undefined,
   fn: () => Effect.Effect<T, any, AutomationCapabilities.ComputeServices>,
-  deps?: React.DependencyList,
+  deps?: DependencyList,
 ): (() => Promise<T>) => {
-  const computeRuntime = useCapability(AutomationCapabilities.ComputeRuntime);
-  const runtime = space !== undefined ? computeRuntime.getRuntime(space.id) : undefined;
+  const runtime = useComputeRuntime(id);
 
   return useCallback(() => {
     if (!runtime) {
@@ -35,34 +30,3 @@ export const useComputeRuntimeCallback = <T>(
     return runtime.runPromise(fn());
   }, [runtime, ...(deps ?? [])]);
 };
-
-// TODO(wittjosiah): Function invoking should automatically be traced (DX-647).
-export const invokeFunctionWithTracing = <I, O>(functionDef: FunctionDefinition<I, O>, inputData: I) =>
-  Effect.gen(function* () {
-    const tracer = yield* InvocationTracer;
-    const trace = yield* tracer.traceInvocationStart({
-      target: undefined,
-      payload: {
-        data: {},
-      },
-    });
-
-    // Invoke the function.
-    const result = yield* FunctionInvocationService.invokeFunction(functionDef, inputData).pipe(
-      Effect.provide(TracingServiceExt.layerQueue(trace.invocationTraceQueue)),
-      Effect.exit,
-    );
-
-    if (Exit.isFailure(result)) {
-      const error = Cause.prettyErrors(result.cause)[0];
-      log.error(error.message, error.cause ?? error.stack);
-    }
-
-    yield* tracer.traceInvocationEnd({
-      trace,
-      // TODO(dmaretskyi): Might miss errors.
-      exception: Exit.isFailure(result) ? Cause.prettyErrors(result.cause)[0] : undefined,
-    });
-
-    return result;
-  });

package/src/hooks/useComputeRuntimeService.ts

@@ -0,0 +1,24 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Context from 'effect/Context';
+import { use } from 'react';
+import { 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;
+  }
+  return unwrapExit(use(useMemo(() => runtime.runPromiseExit(tag), [runtime, tag])));
+};

package/src/hooks/useTriggerRuntimeControls.ts

@@ -2,51 +2,65 @@
 // 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 { Filter } from '@dxos/echo';
+import { type Database, Filter } from '@dxos/echo';
 import { Trigger } from '@dxos/functions';
-import { TriggerDispatcher } from '@dxos/functions-runtime';
-import { type Space, useQuery } from '@dxos/react-client/echo';
-import { useAsyncState } from '@dxos/react-ui';
+import { TriggerDispatcher, type TriggerDispatcherState } from '@dxos/functions-runtime';
+import { useQuery } from '@dxos/react-client/echo';
 
 import { useComputeRuntimeCallback } from './useComputeRuntimeCallback';
 
 interface TriggerRuntimeControls {
   triggers: Trigger.Trigger[];
-  isRunning: boolean;
+
+  state: TriggerDispatcherState | undefined;
+
   start: () => void;
   stop: () => void;
 }
 
-export const useTriggerRuntimeControls = (space: Space | undefined): TriggerRuntimeControls => {
-  const triggers = useQuery(space, Filter.type(Trigger.Trigger));
+export const useTriggerRuntimeControls = (db: Database.Database | undefined): TriggerRuntimeControls => {
+  const triggers = useQuery(db, Filter.type(Trigger.Trigger));
 
-  const [isRunningState, setIsRunningState] = useAsyncState(
-    useComputeRuntimeCallback(space, () => TriggerDispatcher.pipe(Effect.map((t) => t.running))),
+  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(
-    space,
+    db?.spaceId,
     Effect.fnUntraced(function* () {
       const dispatcher = yield* TriggerDispatcher;
       yield* dispatcher.start();
-      setIsRunningState(true);
     }),
   );
 
   const stop = useComputeRuntimeCallback(
-    space,
+    db?.spaceId,
     Effect.fnUntraced(function* () {
       const dispatcher = yield* TriggerDispatcher;
       yield* dispatcher.stop();
-      setIsRunningState(false);
     }),
   );
 
   return {
     triggers,
-    isRunning: isRunningState ?? false,
+    state,
     start: () => void start(),
     stop: () => void stop(),
   };

package/src/index.ts

@@ -2,10 +2,5 @@
 // Copyright 2023 DXOS.org
 //
 
-export { AutomationCapabilities } from './capabilities';
-export * from './components';
-export * from './meta';
-export * from './events';
-export * from './hooks';
-
-export * from './AutomationPlugin';
+export { AutomationPlugin } from './AutomationPlugin';
+export { meta } from './meta';

package/src/meta.ts

@@ -2,11 +2,11 @@
 // 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/automation',
+export const meta: Plugin.Meta = {
+  id: 'org.dxos.plugin.automation',
   name: 'Automation',
   description: trim`
     Workflow automation engine that triggers custom actions based on object events and conditions.

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

@@ -0,0 +1,75 @@
+//
+// 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, (obj) => {
+              obj.function = Ref.make(fn);
+            });
+          }
+        }
+      }
+
+      switch (template.type) {
+        case 'timer': {
+          Obj.change(trigger, (obj) => {
+            obj.spec = { kind: 'timer', cron: template.cron };
+          });
+          break;
+        }
+        case 'queue': {
+          Obj.change(trigger, (obj) => {
+            obj.spec = {
+              kind: 'queue',
+              queue: (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

@@ -4,14 +4,15 @@
 
 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,47 +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.',
-
-        'runtime label': 'Enable Local Runtime',
-        'runtime description':
+        '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.',
-        'function copy id': 'Copy Function ID',
-        'no functions found': 'No functions found',
-        'go to function source button label': 'Show function source',
-        'delete function button label': 'Delete function',
-
-        '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',
+        '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,56 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import type * as ManagedRuntime from 'effect/ManagedRuntime';
+
+import { type AiService, type ToolExecutionService, type ToolResolverService } 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,
+  FunctionInvocationService,
+  Process,
+  QueueService,
+  TracingService,
+} from '@dxos/functions';
+import type { TriggerDispatcher, TriggerStateStore } from '@dxos/functions-runtime';
+import type { SpaceId } from '@dxos/keys';
+import type { Operation } 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
+    | TracingService // TODO(dmaretskyi): Probably should not be provided here.
+    | FunctionInvocationService // TODO(dmaretskyi): Deprecated
+    | Operation.Service
+    // TODO(dmaretskyi): Those should be provided at AI-chat call site.
+    | ToolResolverService
+    | ToolExecutionService;
+
+  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

@@ -2,4 +2,6 @@
 // Copyright 2025 DXOS.org
 //
 
+export * from './capabilities';
+export * from './events';
 export * from './schema';

package/src/types/schema.ts

@@ -4,21 +4,21 @@
 
 import * as Schema from 'effect/Schema';
 
-import { SpaceSchema } from '@dxos/react-client/echo';
+import { Database } from '@dxos/echo';
 
-import { meta } 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 {
   export class CreateTriggerFromTemplate extends Schema.TaggedClass<CreateTriggerFromTemplate>()(
-    `${meta.id}/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.

package/dist/lib/browser/AutomationPanel-7OECLR5N.mjs

@@ -1,11 +0,0 @@
-import {
-  AutomationPanel,
-  AutomationPanel_default
-} from "./chunk-QKFBHAGN.mjs";
-import "./chunk-JW7XSPYW.mjs";
-import "./chunk-LZQFZO3B.mjs";
-export {
-  AutomationPanel,
-  AutomationPanel_default as default
-};
-//# sourceMappingURL=AutomationPanel-7OECLR5N.mjs.map