@dxos/plugin-automation 0.8.3 → 0.8.4-main.1068cf700f

package/package.json

@@ -1,28 +1,52 @@
 {
   "name": "@dxos/plugin-automation",
-  "version": "0.8.3",
+  "version": "0.8.4-main.1068cf700f",
   "description": "Prompt chain plugin",
   "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",
   "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"
     },
+    "./cli": {
+      "source": "./src/cli/index.ts",
+      "types": "./dist/types/src/cli/index.d.ts",
+      "node": "./dist/lib/node-esm/cli/index.mjs"
+    },
+    "./hooks": {
+      "source": "./src/hooks/index.ts",
+      "types": "./dist/types/src/hooks/index.d.ts",
+      "browser": "./dist/lib/browser/hooks/index.mjs",
+      "node": "./dist/lib/node-esm/hooks/index.mjs"
+    },
     "./types": {
-      "types": "./dist/types/src/types.d.ts",
-      "browser": "./dist/lib/browser/types.mjs",
-      "node": "./dist/lib/node-esm/types.mjs"
+      "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"
     }
   },
   "types": "dist/types/src/index.d.ts",
   "typesVersions": {
-    "*": {}
+    "*": {
+      "hooks": [
+        "dist/types/src/hooks/index.d.ts"
+      ],
+      "types": [
+        "dist/types/src/types/index.d.ts"
+      ]
+    }
   },
   "files": [
     "assets",
@@ -30,49 +54,65 @@
     "src"
   ],
   "dependencies": {
-    "@preact-signals/safe-react": "^0.9.0",
-    "@preact/signals-core": "^1.9.0",
-    "@dxos/app-framework": "0.8.3",
-    "@dxos/conductor": "0.8.3",
-    "@dxos/functions": "0.8.3",
-    "@dxos/echo-schema": "0.8.3",
-    "@dxos/invariant": "0.8.3",
-    "@dxos/echo": "0.8.3",
-    "@dxos/live-object": "0.8.3",
-    "@dxos/log": "0.8.3",
-    "@dxos/plugin-deck": "0.8.3",
-    "@dxos/plugin-client": "0.8.3",
-    "@dxos/plugin-graph": "0.8.3",
-    "@dxos/plugin-space": "0.8.3",
-    "@dxos/random": "0.8.3",
-    "@dxos/react-client": "0.8.3",
-    "@dxos/react-ui-form": "0.8.3",
-    "@dxos/react-ui-stack": "0.8.3",
-    "@dxos/async": "0.8.3",
-    "@dxos/util": "0.8.3",
-    "@dxos/react-ui-list": "0.8.3"
+    "@effect-atom/atom": "^0.5.1",
+    "@effect/ai": "0.33.2",
+    "@effect/cli": "0.73.2",
+    "@effect/platform-browser": "0.74.0",
+    "@effect/printer-ansi": "0.47.0",
+    "@dxos/ai": "0.8.4-main.1068cf700f",
+    "@dxos/app-framework": "0.8.4-main.1068cf700f",
+    "@dxos/assistant": "0.8.4-main.1068cf700f",
+    "@dxos/app-toolkit": "0.8.4-main.1068cf700f",
+    "@dxos/async": "0.8.4-main.1068cf700f",
+    "@dxos/cli-util": "0.8.4-main.1068cf700f",
+    "@dxos/conductor": "0.8.4-main.1068cf700f",
+    "@dxos/client": "0.8.4-main.1068cf700f",
+    "@dxos/context": "0.8.4-main.1068cf700f",
+    "@dxos/echo": "0.8.4-main.1068cf700f",
+    "@dxos/echo-atom": "0.8.4-main.1068cf700f",
+    "@dxos/effect": "0.8.4-main.1068cf700f",
+    "@dxos/functions": "0.8.4-main.1068cf700f",
+    "@dxos/functions-runtime": "0.8.4-main.1068cf700f",
+    "@dxos/invariant": "0.8.4-main.1068cf700f",
+    "@dxos/keys": "0.8.4-main.1068cf700f",
+    "@dxos/log": "0.8.4-main.1068cf700f",
+    "@dxos/operation": "0.8.4-main.1068cf700f",
+    "@dxos/plugin-graph": "0.8.4-main.1068cf700f",
+    "@dxos/plugin-deck": "0.8.4-main.1068cf700f",
+    "@dxos/plugin-space": "0.8.4-main.1068cf700f",
+    "@dxos/random": "0.8.4-main.1068cf700f",
+    "@dxos/react-client": "0.8.4-main.1068cf700f",
+    "@dxos/plugin-client": "0.8.4-main.1068cf700f",
+    "@dxos/react-ui-components": "0.8.4-main.1068cf700f",
+    "@dxos/react-ui-editor": "0.8.4-main.1068cf700f",
+    "@dxos/react-ui-form": "0.8.4-main.1068cf700f",
+    "@dxos/react-ui-list": "0.8.4-main.1068cf700f",
+    "@dxos/react-ui-stack": "0.8.4-main.1068cf700f",
+    "@dxos/schema": "0.8.4-main.1068cf700f",
+    "@dxos/types": "0.8.4-main.1068cf700f",
+    "@dxos/util": "0.8.4-main.1068cf700f"
   },
   "devDependencies": {
-    "@effect-rx/rx-react": "^0.34.1",
-    "@effect/platform": "0.80.12",
-    "@types/react": "~18.2.0",
-    "@types/react-dom": "~18.2.0",
-    "effect": "3.14.21",
-    "react": "~18.2.0",
-    "react-dom": "~18.2.0",
-    "vite": "5.4.7",
-    "@dxos/react-ui-theme": "0.8.3",
-    "@dxos/react-ui": "0.8.3",
-    "@dxos/storybook-utils": "0.8.3"
+    "@effect-atom/atom-react": "^0.5.0",
+    "@effect/platform": "0.94.4",
+    "@types/react": "~19.2.7",
+    "@types/react-dom": "~19.2.3",
+    "effect": "3.19.16",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "vite": "7.1.9",
+    "@dxos/react-ui": "0.8.4-main.1068cf700f",
+    "@dxos/storybook-utils": "0.8.4-main.1068cf700f",
+    "@dxos/ui-theme": "0.8.4-main.1068cf700f"
   },
   "peerDependencies": {
-    "@effect-rx/rx-react": "^0.34.1",
-    "@effect/platform": "0.80.12",
-    "effect": "^3.13.3",
-    "react": "~18.2.0",
-    "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.8.3",
-    "@dxos/react-ui-theme": "0.8.3"
+    "@effect-atom/atom-react": "^0.5.0",
+    "@effect/platform": "0.94.4",
+    "effect": "3.19.16",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "@dxos/ui-theme": "0.8.4-main.1068cf700f",
+    "@dxos/react-ui": "0.8.4-main.1068cf700f"
   },
   "publishConfig": {
     "access": "public"

package/src/AutomationPlugin.tsx

@@ -2,39 +2,26 @@
 // Copyright 2023 DXOS.org
 //
 
-import { Capabilities, contributes, defineModule, definePlugin, Events } from '@dxos/app-framework';
-import { FunctionType, FunctionTrigger } from '@dxos/functions';
-import { ClientCapabilities, ClientEvents } from '@dxos/plugin-client';
+import { Plugin } from '@dxos/app-framework';
+import { AppPlugin } from '@dxos/app-toolkit';
+import { Function, Trigger } from '@dxos/functions';
+import { ClientEvents } from '@dxos/plugin-client/types';
 
-import { AppGraphBuilder, IntentResolver, ReactSurface } from './capabilities';
+import { AppGraphBuilder, ComputeRuntime, OperationResolver, ReactSurface } from './capabilities';
 import { meta } from './meta';
-import translations from './translations';
+import { translations } from './translations';
+import { AutomationEvents } from './types';
 
-export const AutomationPlugin = () =>
-  definePlugin(meta, [
-    defineModule({
-      id: `${meta.id}/module/translations`,
-      activatesOn: Events.SetupTranslations,
-      activate: () => contributes(Capabilities.Translations, translations),
-    }),
-    defineModule({
-      id: `${meta.id}/module/schema`,
-      activatesOn: ClientEvents.SetupSchema,
-      activate: () => contributes(ClientCapabilities.Schema, [FunctionType, FunctionTrigger]),
-    }),
-    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/react-surface`,
-      activatesOn: Events.SetupReactSurface,
-      activate: ReactSurface,
-    }),
-  ]);
+export const AutomationPlugin = Plugin.define(meta).pipe(
+  AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),
+  AppPlugin.addOperationResolverModule({ activate: OperationResolver }),
+  AppPlugin.addSchemaModule({ schema: [Function.Function, Trigger.Trigger] }),
+  AppPlugin.addSurfaceModule({ activate: ReactSurface }),
+  AppPlugin.addTranslationsModule({ translations }),
+  Plugin.addModule({
+    activatesOn: ClientEvents.ClientReady,
+    activatesAfter: [AutomationEvents.ComputeRuntimeReady],
+    activate: ComputeRuntime,
+  }),
+  Plugin.make,
+);

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

@@ -0,0 +1,72 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability } from '@dxos/app-framework';
+import { AppCapabilities } from '@dxos/app-toolkit';
+import { Script } from '@dxos/functions';
+import { ATTENDABLE_PATH_SEPARATOR, PLANK_COMPANION_TYPE } from '@dxos/plugin-deck/types';
+import { GraphBuilder, NodeMatcher } from '@dxos/plugin-graph';
+import { meta as spaceMeta } from '@dxos/plugin-space';
+
+import { meta } from '../../meta';
+
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    const extensions = yield* Effect.all([
+      GraphBuilder.createExtension({
+        id: `${meta.id}/space-settings-automation`,
+        match: NodeMatcher.whenNodeType(`${spaceMeta.id}/settings`),
+        connector: (node) =>
+          Effect.succeed([
+            {
+              id: `automation-${node.id}`,
+              type: `${meta.id}/space-settings-automation`,
+              data: `${meta.id}/space-settings-automation`,
+              properties: {
+                label: ['automation panel label', { ns: meta.id }],
+                icon: 'ph--lightning--regular',
+              },
+            },
+          ]),
+      }),
+      GraphBuilder.createExtension({
+        id: `${meta.id}/space-settings-functions`,
+        match: NodeMatcher.whenNodeType(`${spaceMeta.id}/settings`),
+        connector: (node) =>
+          Effect.succeed([
+            {
+              id: `functions-${node.id}`,
+              type: `${meta.id}/space-settings-functions`,
+              data: `${meta.id}/space-settings-functions`,
+              properties: {
+                label: ['functions panel label', { ns: meta.id }],
+                icon: 'ph--function--regular',
+              },
+            },
+          ]),
+      }),
+      GraphBuilder.createTypeExtension({
+        id: `${meta.id}/script-companion`,
+        type: Script.Script,
+        connector: (script) =>
+          Effect.succeed([
+            {
+              id: [script.id, 'automation'].join(ATTENDABLE_PATH_SEPARATOR),
+              type: PLANK_COMPANION_TYPE,
+              data: 'automation',
+              properties: {
+                label: ['script automation label', { ns: meta.id }],
+                icon: 'ph--lightning--regular',
+                disposition: 'hidden',
+              },
+            },
+          ]),
+      }),
+    ]);
+
+    return Capability.contributes(AppCapabilities.AppGraphBuilder, extensions);
+  }),
+);

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

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capability } from '@dxos/app-framework';
+
+export const AppGraphBuilder = Capability.lazy('AppGraphBuilder', () => import('./app-graph-builder'));

package/src/capabilities/compute-runtime/compute-runtime.ts

@@ -0,0 +1,140 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as BrowserKeyValueStore from '@effect/platform-browser/BrowserKeyValueStore';
+import { Registry } from '@effect-atom/atom';
+import * as Effect from 'effect/Effect';
+import * as Layer from 'effect/Layer';
+import * as ManagedRuntime from 'effect/ManagedRuntime';
+
+import { Capabilities, Capability, type CapabilityManager } from '@dxos/app-framework';
+import { AppCapabilities } from '@dxos/app-toolkit';
+import { GenericToolkit, ToolExecutionServices } from '@dxos/assistant';
+import { SpaceProperties } from '@dxos/client/echo';
+import { Resource } from '@dxos/context';
+import { Database, Obj, Query, Ref } from '@dxos/echo';
+import { CredentialsService, QueueService } from '@dxos/functions';
+import {
+  FunctionImplementationResolver,
+  FunctionInvocationServiceLayerWithLocalLoopbackExecutor,
+  RemoteFunctionExecutionService,
+  TracingServiceExt,
+  TriggerDispatcher,
+  TriggerStateStore,
+} from '@dxos/functions-runtime';
+import { invariant } from '@dxos/invariant';
+import { type SpaceId } from '@dxos/keys';
+import { ClientCapabilities } from '@dxos/plugin-client/types';
+
+import { AutomationCapabilities } from '../../types';
+
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    const capabilities = yield* Capability.Service;
+    const provider = yield* Effect.tryPromise(() => new ComputeRuntimeProviderImpl(capabilities).open());
+    return Capability.contributes(AutomationCapabilities.ComputeRuntime, provider, () =>
+      Effect.tryPromise(() => provider.close()),
+    );
+  }),
+);
+
+/**
+ * Adapts plugin capabilities to runtime layers.
+ */
+class ComputeRuntimeProviderImpl extends Resource implements AutomationCapabilities.ComputeRuntimeProvider {
+  readonly #runtimes = new Map<SpaceId, AutomationCapabilities.ComputeRuntime>();
+  readonly #capabilities: CapabilityManager.CapabilityManager;
+
+  constructor(capabilities: CapabilityManager.CapabilityManager) {
+    super();
+    this.#capabilities = capabilities;
+  }
+
+  protected override async _open() {}
+
+  protected override async _close() {
+    await Promise.all(Array.from(this.#runtimes.values()).map((rt) => rt.dispose()));
+    this.#runtimes.clear();
+  }
+
+  getRuntime(spaceId: SpaceId): AutomationCapabilities.ComputeRuntime {
+    if (this.#runtimes.has(spaceId)) {
+      return this.#runtimes.get(spaceId)!;
+    }
+
+    const layer = Layer.unwrapEffect(
+      Effect.gen(this, function* () {
+        const client = this.#capabilities.get(ClientCapabilities.Client);
+        const aiServiceLayer =
+          this.#capabilities.get(AppCapabilities.AiServiceLayer) ?? Layer.die('AiService not found');
+        const registry = this.#capabilities.get(Capabilities.AtomRegistry);
+
+        // TODO(dmaretskyi): Make these reactive.
+        const functions = this.#capabilities.getAll(AppCapabilities.Functions).flat();
+
+        const genericToolkitProvider = Layer.succeed(GenericToolkit.Provider, {
+          getToolkit: () => {
+            const toolkits = this.#capabilities.getAll(AppCapabilities.Toolkit);
+            return GenericToolkit.merge(...toolkits);
+          },
+        });
+
+        const space = client.spaces.get(spaceId);
+        invariant(space, `Invalid space: ${spaceId}`);
+        yield* Effect.promise(() => space.waitUntilReady());
+
+        return Layer.mergeAll(TriggerDispatcher.layer({ timeControl: 'natural' })).pipe(
+          Layer.provideMerge(Layer.succeed(Registry.AtomRegistry, registry)),
+          Layer.provideMerge(
+            Layer.mergeAll(
+              TracingServiceLive,
+              TriggerStateStore.layerKv.pipe(Layer.provide(BrowserKeyValueStore.layerLocalStorage)),
+              ToolExecutionServices,
+            ),
+          ),
+          Layer.provideMerge(
+            FunctionInvocationServiceLayerWithLocalLoopbackExecutor.pipe(
+              Layer.provideMerge(genericToolkitProvider),
+              Layer.provideMerge(FunctionImplementationResolver.layerTest({ functions })),
+              Layer.provideMerge(
+                RemoteFunctionExecutionService.fromClient(
+                  client,
+                  // If agent is not enabled do not provide spaceId because space context will be unavailable on EDGE.
+                  client.config.get('runtime.client.edgeFeatures.agents') ? spaceId : undefined,
+                ),
+              ),
+              Layer.provideMerge(aiServiceLayer),
+              Layer.provideMerge(CredentialsService.layerFromDatabase()),
+              Layer.provideMerge(space ? Database.layer(space.db) : Database.notAvailable),
+              Layer.provideMerge(space ? QueueService.layer(space.queues) : QueueService.notAvailable),
+            ),
+          ),
+        );
+      }),
+    );
+
+    const runtime = ManagedRuntime.make(layer);
+    this.#runtimes.set(spaceId, runtime);
+    return runtime;
+  }
+}
+
+const TracingServiceLive = Layer.unwrapEffect(
+  Effect.gen(function* () {
+    const objects = yield* Database.runQuery(Query.type(SpaceProperties));
+    const [properties] = objects;
+    invariant(properties);
+    // TODO(burdon): Check ref target has loaded?
+    if (!properties.invocationTraceQueue || !properties.invocationTraceQueue.target) {
+      const queue = yield* QueueService.createQueue({ subspaceTag: 'trace' });
+      Obj.change(properties, (m) => {
+        m.invocationTraceQueue = Ref.fromDXN(queue.dxn);
+      });
+    }
+
+    const queue = properties.invocationTraceQueue.target;
+    invariant(queue);
+    return TracingServiceExt.layerInvocationsQueue({ invocationTraceQueue: queue });
+  }),
+);

package/src/capabilities/compute-runtime/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capability } from '@dxos/app-framework';
+
+export const ComputeRuntime = Capability.lazy('ComputeRuntime', () => import('./compute-runtime'));

package/src/capabilities/index.ts

@@ -2,8 +2,7 @@
 // Copyright 2025 DXOS.org
 //
 
-import { lazy } from '@dxos/app-framework';
-
-export const AppGraphBuilder = lazy(() => import('./app-graph-builder'));
-export const IntentResolver = lazy(() => import('./intent-resolver'));
-export const ReactSurface = lazy(() => import('./react-surface'));
+export * from './app-graph-builder';
+export * from './compute-runtime';
+export * from './operation-resolver';
+export * from './react-surface';

package/src/capabilities/operation-resolver/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capability } from '@dxos/app-framework';
+
+export const OperationResolver = Capability.lazy('OperationResolver', () => import('./operation-resolver'));

package/src/capabilities/operation-resolver/operation-resolver.ts

@@ -0,0 +1,80 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capabilities, Capability } from '@dxos/app-framework';
+import { LayoutOperation } from '@dxos/app-toolkit';
+import { Obj, Ref } from '@dxos/echo';
+import { Function, Script, Trigger } from '@dxos/functions';
+import { type DXN } from '@dxos/keys';
+import { Operation, OperationResolver } from '@dxos/operation';
+import { ATTENDABLE_PATH_SEPARATOR } from '@dxos/plugin-deck/types';
+import { SpaceOperation } from '@dxos/plugin-space/types';
+import { Filter } from '@dxos/react-client/echo';
+
+import { AutomationOperation } from '../../types';
+
+export default Capability.makeModule(
+  Effect.fnUntraced(function* () {
+    return Capability.contributes(Capabilities.OperationResolver, [
+      OperationResolver.make({
+        operation: AutomationOperation.CreateTriggerFromTemplate,
+        handler: 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(Function.Function, { source: Ref.make(script) })).run(),
+              );
+              const [fn] = functions;
+              if (fn) {
+                Obj.change(trigger, (t) => {
+                  t.function = Ref.make(fn);
+                });
+              }
+            }
+          }
+
+          switch (template.type) {
+            case 'timer': {
+              Obj.change(trigger, (t) => {
+                t.spec = { kind: 'timer', cron: template.cron };
+              });
+              break;
+            }
+            case 'queue': {
+              Obj.change(trigger, (t) => {
+                t.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: [`automation-settings${ATTENDABLE_PATH_SEPARATOR}${db.spaceId}`],
+            workspace: db.spaceId,
+          });
+        }),
+      }),
+    ]);
+  }),
+);

package/src/capabilities/react-surface/index.ts

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

package/src/capabilities/react-surface/react-surface.tsx

@@ -0,0 +1,61 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+import React from 'react';
+
+import { Capabilities, Capability } from '@dxos/app-framework';
+import { Surface } from '@dxos/app-framework/ui';
+import { useLayout } from '@dxos/app-toolkit/ui';
+import { Obj } from '@dxos/echo';
+import { getSpace, parseId, useSpace } from '@dxos/react-client/echo';
+
+import { AutomationSettings, FunctionsContainer } from '../../components';
+import { meta } from '../../meta';
+
+export default Capability.makeModule(() =>
+  Effect.succeed(
+    Capability.contributes(Capabilities.ReactSurface, [
+      Surface.create({
+        id: `${meta.id}/space-settings-functions`,
+        role: 'article',
+        filter: (data): data is { subject: string } => data.subject === `${meta.id}/space-settings-functions`,
+        component: () => {
+          const layout = useLayout();
+          const { spaceId } = parseId(layout.workspace);
+          const space = useSpace(spaceId);
+          if (!space) {
+            return null;
+          }
+
+          return <FunctionsContainer space={space} />;
+        },
+      }),
+      Surface.create({
+        id: `${meta.id}/space-settings-automation`,
+        role: 'article',
+        filter: (data): data is { subject: string } => data.subject === `${meta.id}/space-settings-automation`,
+        component: () => {
+          const layout = useLayout();
+          const { spaceId } = parseId(layout.workspace);
+          const space = useSpace(spaceId);
+          if (!space) {
+            return null;
+          }
+
+          return <AutomationSettings space={space} />;
+        },
+      }),
+      Surface.create({
+        id: `${meta.id}/companion/automation`,
+        role: 'article',
+        filter: (data): data is { companionTo: Obj.Unknown; subject: 'automation' } =>
+          Obj.isObject(data.companionTo) && data.subject === 'automation',
+        component: ({ data }) => {
+          return <AutomationSettings space={getSpace(data.companionTo)!} object={data.companionTo} />;
+        },
+      }),
+    ]),
+  ),
+);

package/src/cli/commands/index.ts

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

package/src/cli/commands/trigger/create/index.ts

@@ -0,0 +1,14 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Command from '@effect/cli/Command';
+
+import { queue } from './queue';
+import { subscription } from './subscription';
+import { timer } from './timer';
+
+export const create = Command.make('create').pipe(
+  Command.withDescription('Create a trigger.'),
+  Command.withSubcommands([subscription, timer, queue]),
+);