@dxos/plugin-routine 0.10.0 → 0.11.1

package/dist/lib/chunk-layer-specs.mjs

@@ -0,0 +1,179 @@
+import { Capabilities, Capability } from "@dxos/app-framework";
+import { AppCapabilities } from "@dxos/app-toolkit";
+import { LayerSpec, Operation, OperationHandlerSet, Trigger } from "@dxos/compute";
+import { Database, Registry } from "@dxos/echo";
+import * as Effect from "effect/Effect";
+import { ClientService } from "@dxos/client";
+import { invariant } from "@dxos/invariant";
+import { FeedTraceSink, ProcessManager, RemoteOperationInvoker, RemoteProcessManager, RemoteTriggerManager, TriggerDispatcher, TriggerMonitor, TriggerStateStore } from "@dxos/compute-runtime";
+import { Registry as Registry$1 } from "@effect-atom/atom";
+import * as Layer from "effect/Layer";
+import { OpaqueToolkit } from "@dxos/ai";
+import { EdgeOperationInvoker, EdgeProcessManager, EdgeTriggerManager } from "@dxos/edge-compute";
+//#region src/capabilities/layer-specs.ts
+var __dxlog_file = "/__w/dxos/dxos/packages/plugins/plugin-routine/src/capabilities/layer-specs.ts";
+/**
+* Gathers contributed {@link Capabilities.OperationHandler} sets from the
+* {@link Capability.Service} and exposes them through the
+* {@link OperationHandlerSet.OperationHandlerProvider} tag so space-affinity
+* specs (e.g. {@link OperationsToRegistrySpec}) can consume them through the
+* normal LayerStack resolution path.
+*/
+var OperationHandlerProviderSpec = LayerSpec.make({
+	affinity: "application",
+	requires: [Capability.Service],
+	provides: [OperationHandlerSet.OperationHandlerProvider]
+}, () => Layer.unwrapEffect(Effect.gen(function* () {
+	const operationHandlerSets = yield* Capability.getAll(Capabilities.OperationHandler);
+	const mergedOperationHandlers = operationHandlerSets.length === 0 ? OperationHandlerSet.empty : OperationHandlerSet.merge(...operationHandlerSets);
+	return OperationHandlerSet.provide(mergedOperationHandlers);
+})));
+var RegistrySpec = LayerSpec.make({
+	affinity: "application",
+	requires: [ClientService],
+	provides: [Registry.Service]
+}, () => Layer.unwrapEffect(Effect.gen(function* () {
+	const client = yield* ClientService;
+	return Layer.succeed(Registry.Service, client.graph.registry);
+})));
+var OpaqueToolkitSpec = LayerSpec.make({
+	affinity: "application",
+	requires: [Capability.Service],
+	provides: [OpaqueToolkit.OpaqueToolkitProvider]
+}, () => Layer.unwrapEffect(Effect.gen(function* () {
+	const capabilities = yield* Capability.Service;
+	return Layer.succeed(OpaqueToolkit.OpaqueToolkitProvider, { getToolkit: () => {
+		const toolkits = capabilities.getAll(AppCapabilities.Toolkit);
+		return OpaqueToolkit.merge(...toolkits);
+	} });
+})));
+var OperationsToRegistrySpec = LayerSpec.make({
+	affinity: "space",
+	requires: [Registry.Service, OperationHandlerSet.OperationHandlerProvider],
+	provides: [Registry.Service]
+}, () => Layer.effect(Registry.Service, Effect.gen(function* () {
+	const handlerSet = yield* OperationHandlerSet.OperationHandlerProvider;
+	const registry = yield* Registry.Service;
+	const handlers = yield* handlerSet.handlers;
+	registry.add(handlers.map(Operation.serialize));
+	return registry;
+})));
+/**
+* In-memory trigger state. Loses state across restarts but works in both
+* browser and CLI/Node contexts. Hosts that need durable storage should
+* contribute a replacement LayerSpec that provides {@link TriggerStateStore}
+* backed by a persistent `KeyValueStore` (e.g. `BrowserKeyValueStore` or
+* `BunKeyValueStore`).
+*/
+var TriggerStateStoreSpec = LayerSpec.make({
+	affinity: "application",
+	requires: [],
+	provides: [TriggerStateStore]
+}, () => TriggerStateStore.layerMemory);
+var FeedTraceSinkSpec = LayerSpec.make({
+	affinity: "space",
+	requires: [Database.Service],
+	provides: [FeedTraceSink.FeedTraceSink]
+}, () => FeedTraceSink.layerLive);
+/**
+* Space-scoped remote operation invoker (EDGE). When edge agents are enabled
+* (`runtime.client.edgeFeatures.agents`) operations are invoked without a space
+* binding (the edge routes them); otherwise they are scoped to the space. The
+* config is read inside the factory — at slice-materialisation time, once
+* `ClientService` is available — so the owning module does not need the client
+* at activation time and can activate on `SetupProcessManager`.
+*/
+var RemoteOperationInvokerSpec = LayerSpec.make({
+	affinity: "space",
+	requires: [ClientService],
+	provides: [RemoteOperationInvoker.Service]
+}, (context) => Layer.unwrapEffect(Effect.gen(function* () {
+	invariant(context.space, "space context required for RemoteOperationInvoker", {
+		"~LogMeta": "~LogMeta",
+		F: __dxlog_file,
+		L: 165,
+		S: this,
+		A: ["context.space", "'space context required for RemoteOperationInvoker'"]
+	});
+	const client = yield* ClientService;
+	const edgeAgents = client.config.get("runtime.client.edgeFeatures.agents");
+	return EdgeOperationInvoker.fromClient(client, edgeAgents ? void 0 : context.space);
+})));
+/**
+* Space-scoped remote (EDGE) trigger manager, consumed by the aggregate
+* {@link TriggerMonitor}. Uses the EDGE implementation whenever an edge service
+* is configured (a trigger is routed here by its own `remote` flag, so the
+* manager should exist wherever edge is reachable), otherwise a no-op.
+*/
+var RemoteTriggerManagerSpec = LayerSpec.make({
+	affinity: "space",
+	requires: [ClientService, Registry$1.AtomRegistry],
+	provides: [RemoteTriggerManager.Service]
+}, (context) => Layer.unwrapEffect(Effect.gen(function* () {
+	invariant(context.space, "space context required for RemoteTriggerManager", {
+		"~LogMeta": "~LogMeta",
+		F: __dxlog_file,
+		L: 188,
+		S: this,
+		A: ["context.space", "'space context required for RemoteTriggerManager'"]
+	});
+	const client = yield* ClientService;
+	return client.config.values.runtime?.services?.edge?.url ? EdgeTriggerManager.fromClient(client, context.space) : RemoteTriggerManager.layerNoop;
+})));
+/**
+* Application-scoped remote (EDGE) process manager, providing the progress meter's cancel control.
+* Uses the EDGE implementation whenever an edge service is configured — cancel is addressed by trigger
+* id + space, so it is not space-scoped — otherwise a read-only no-op. Resolved by the progress trace
+* sink to route an edge-run trigger's cancel; the aggregate {@link TriggerMonitor} view is unaffected.
+*/
+var RemoteProcessManagerSpec = LayerSpec.make({
+	affinity: "application",
+	requires: [ClientService, Registry$1.AtomRegistry],
+	provides: [RemoteProcessManager.Service]
+}, () => Layer.unwrapEffect(Effect.gen(function* () {
+	const client = yield* ClientService;
+	return client.config.values.runtime?.services?.edge?.url ? EdgeProcessManager.fromClient(client) : RemoteProcessManager.layerNoop;
+})));
+var TriggerDispatcherSpec = LayerSpec.make({
+	affinity: "space",
+	requires: [
+		Database.Service,
+		TriggerStateStore,
+		ProcessManager.ProcessManagerService,
+		Registry$1.AtomRegistry
+	],
+	provides: [TriggerDispatcher]
+}, () => TriggerDispatcher.layer({ timeControl: "natural" }));
+/**
+* Aggregate {@link Trigger.TriggerMonitorService} over the local
+* {@link TriggerDispatcher} and the remote {@link RemoteTriggerManager.Service}.
+* Provides a unified view of trigger state across local and edge environments.
+*/
+var TriggerMonitorSpec = LayerSpec.make({
+	affinity: "space",
+	requires: [
+		TriggerDispatcher,
+		Database.Service,
+		Registry$1.AtomRegistry,
+		RemoteTriggerManager.Service
+	],
+	provides: [Trigger.TriggerMonitorService]
+}, () => TriggerMonitor.layer);
+var layer_specs_default = Capability.makeModule(() => Effect.succeed([
+	Capability.contributes(Capabilities.LayerSpec, OperationHandlerProviderSpec),
+	Capability.contributes(Capabilities.LayerSpec, RegistrySpec),
+	Capability.contributes(Capabilities.LayerSpec, OpaqueToolkitSpec),
+	Capability.contributes(Capabilities.LayerSpec, OperationsToRegistrySpec),
+	Capability.contributes(Capabilities.LayerSpec, TriggerStateStoreSpec),
+	Capability.contributes(Capabilities.LayerSpec, FeedTraceSinkSpec),
+	Capability.contributes(Capabilities.LayerSpec, TriggerDispatcherSpec),
+	Capability.contributes(Capabilities.LayerSpec, RemoteTriggerManagerSpec),
+	Capability.contributes(Capabilities.LayerSpec, TriggerMonitorSpec),
+	Capability.contributes(Capabilities.LayerSpec, RemoteOperationInvokerSpec),
+	Capability.contributes(Capabilities.LayerSpec, RemoteProcessManagerSpec),
+	Capability.contributes(Capabilities.TraceSink, ({ resolver }) => FeedTraceSink.makeRoutingSink({ resolver }))
+]));
+//#endregion
+export { layer_specs_default as default };
+
+//# sourceMappingURL=chunk-layer-specs.mjs.map

package/dist/lib/chunk-layer-specs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-layer-specs.mjs","names":[],"sources":["../../src/capabilities/layer-specs.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Registry as AtomRegistry } from '@effect-atom/atom';\nimport * as Effect from 'effect/Effect';\nimport * as Layer from 'effect/Layer';\n\nimport { OpaqueToolkit } from '@dxos/ai';\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport { AppCapabilities } from '@dxos/app-toolkit';\nimport { ClientService } from '@dxos/client';\nimport { LayerSpec, Operation, OperationHandlerSet, Trigger } from '@dxos/compute';\nimport {\n  FeedTraceSink,\n  ProcessManager,\n  RemoteOperationInvoker,\n  RemoteProcessManager,\n  RemoteTriggerManager,\n  TriggerDispatcher,\n  TriggerMonitor,\n  TriggerStateStore,\n} from '@dxos/compute-runtime';\nimport { Database, Registry } from '@dxos/echo';\nimport { EdgeOperationInvoker, EdgeProcessManager, EdgeTriggerManager } from '@dxos/edge-compute';\nimport { invariant } from '@dxos/invariant';\n\n//\n// Capability Module\n//\n// Contributes application- and space-affinity `Capabilities.LayerSpec` entries\n// that together replace the former monolithic `RoutineCapabilities.ComputeRuntime`.\n//\n// Specs are declared at module level; runtime state (the `Client`, contributed\n// capability lists, etc.) is resolved via Effect-level requirements rather\n// than captured from an outer scope.\n//\n\n/**\n * Gathers contributed {@link Capabilities.OperationHandler} sets from the\n * {@link Capability.Service} and exposes them through the\n * {@link OperationHandlerSet.OperationHandlerProvider} tag so space-affinity\n * specs (e.g. {@link OperationsToRegistrySpec}) can consume them through the\n * normal LayerStack resolution path.\n */\nconst OperationHandlerProviderSpec = LayerSpec.make(\n  {\n    affinity: 'application',\n    requires: [Capability.Service],\n    provides: [OperationHandlerSet.OperationHandlerProvider],\n  },\n  () =>\n    Layer.unwrapEffect(\n      Effect.gen(function* () {\n        const operationHandlerSets = yield* Capability.getAll(Capabilities.OperationHandler);\n        const mergedOperationHandlers =\n          operationHandlerSets.length === 0\n            ? OperationHandlerSet.empty\n            : OperationHandlerSet.merge(...operationHandlerSets);\n        return OperationHandlerSet.provide(mergedOperationHandlers);\n      }),\n    ),\n);\n\nconst RegistrySpec = LayerSpec.make(\n  {\n    affinity: 'application',\n    requires: [ClientService],\n    provides: [Registry.Service],\n  },\n  () =>\n    Layer.unwrapEffect(\n      Effect.gen(function* () {\n        const client = yield* ClientService;\n        return Layer.succeed(Registry.Service, client.graph.registry);\n      }),\n    ),\n);\n\nconst OpaqueToolkitSpec = LayerSpec.make(\n  {\n    affinity: 'application',\n    requires: [Capability.Service],\n    provides: [OpaqueToolkit.OpaqueToolkitProvider],\n  },\n  () =>\n    Layer.unwrapEffect(\n      Effect.gen(function* () {\n        const capabilities = yield* Capability.Service;\n        return Layer.succeed(OpaqueToolkit.OpaqueToolkitProvider, {\n          getToolkit: () => {\n            const toolkits = capabilities.getAll(AppCapabilities.Toolkit);\n            return OpaqueToolkit.merge(...toolkits);\n          },\n        });\n      }),\n    ),\n);\n\nconst OperationsToRegistrySpec = LayerSpec.make(\n  {\n    affinity: 'space',\n    requires: [Registry.Service, OperationHandlerSet.OperationHandlerProvider],\n    provides: [Registry.Service],\n  },\n  () =>\n    Layer.effect(\n      Registry.Service,\n      Effect.gen(function* () {\n        const handlerSet = yield* OperationHandlerSet.OperationHandlerProvider;\n        const registry = yield* Registry.Service;\n        const handlers = yield* handlerSet.handlers;\n        registry.add(handlers.map(Operation.serialize));\n        return registry;\n      }),\n    ),\n);\n\n/**\n * In-memory trigger state. Loses state across restarts but works in both\n * browser and CLI/Node contexts. Hosts that need durable storage should\n * contribute a replacement LayerSpec that provides {@link TriggerStateStore}\n * backed by a persistent `KeyValueStore` (e.g. `BrowserKeyValueStore` or\n * `BunKeyValueStore`).\n */\nconst TriggerStateStoreSpec = LayerSpec.make(\n  {\n    affinity: 'application',\n    requires: [],\n    provides: [TriggerStateStore],\n  },\n  () => TriggerStateStore.layerMemory,\n);\n\n//\n// Space-affinity specs.\n//\n\nconst FeedTraceSinkSpec = LayerSpec.make(\n  {\n    affinity: 'space',\n    requires: [Database.Service],\n    provides: [FeedTraceSink.FeedTraceSink],\n  },\n  () => FeedTraceSink.layerLive,\n);\n\n/**\n * Space-scoped remote operation invoker (EDGE). When edge agents are enabled\n * (`runtime.client.edgeFeatures.agents`) operations are invoked without a space\n * binding (the edge routes them); otherwise they are scoped to the space. The\n * config is read inside the factory — at slice-materialisation time, once\n * `ClientService` is available — so the owning module does not need the client\n * at activation time and can activate on `SetupProcessManager`.\n */\nconst RemoteOperationInvokerSpec = LayerSpec.make(\n  {\n    affinity: 'space',\n    requires: [ClientService],\n    provides: [RemoteOperationInvoker.Service],\n  },\n  (context) =>\n    Layer.unwrapEffect(\n      Effect.gen(function* () {\n        invariant(context.space, 'space context required for RemoteOperationInvoker');\n        const client = yield* ClientService;\n        const edgeAgents = client.config.get('runtime.client.edgeFeatures.agents');\n        return EdgeOperationInvoker.fromClient(client, edgeAgents ? undefined : context.space);\n      }),\n    ),\n);\n\n/**\n * Space-scoped remote (EDGE) trigger manager, consumed by the aggregate\n * {@link TriggerMonitor}. Uses the EDGE implementation whenever an edge service\n * is configured (a trigger is routed here by its own `remote` flag, so the\n * manager should exist wherever edge is reachable), otherwise a no-op.\n */\nconst RemoteTriggerManagerSpec = LayerSpec.make(\n  {\n    affinity: 'space',\n    requires: [ClientService, AtomRegistry.AtomRegistry],\n    provides: [RemoteTriggerManager.Service],\n  },\n  (context) =>\n    Layer.unwrapEffect(\n      Effect.gen(function* () {\n        invariant(context.space, 'space context required for RemoteTriggerManager');\n        const client = yield* ClientService;\n        const edgeUrl = client.config.values.runtime?.services?.edge?.url;\n        return edgeUrl ? EdgeTriggerManager.fromClient(client, context.space) : RemoteTriggerManager.layerNoop;\n      }),\n    ),\n);\n\n/**\n * Application-scoped remote (EDGE) process manager, providing the progress meter's cancel control.\n * Uses the EDGE implementation whenever an edge service is configured — cancel is addressed by trigger\n * id + space, so it is not space-scoped — otherwise a read-only no-op. Resolved by the progress trace\n * sink to route an edge-run trigger's cancel; the aggregate {@link TriggerMonitor} view is unaffected.\n */\nconst RemoteProcessManagerSpec = LayerSpec.make(\n  {\n    affinity: 'application',\n    requires: [ClientService, AtomRegistry.AtomRegistry],\n    provides: [RemoteProcessManager.Service],\n  },\n  () =>\n    Layer.unwrapEffect(\n      Effect.gen(function* () {\n        const client = yield* ClientService;\n        const edgeUrl = client.config.values.runtime?.services?.edge?.url;\n        return edgeUrl ? EdgeProcessManager.fromClient(client) : RemoteProcessManager.layerNoop;\n      }),\n    ),\n);\n\nconst TriggerDispatcherSpec = LayerSpec.make(\n  {\n    affinity: 'space',\n    requires: [Database.Service, TriggerStateStore, ProcessManager.ProcessManagerService, AtomRegistry.AtomRegistry],\n    provides: [TriggerDispatcher],\n  },\n  () => TriggerDispatcher.layer({ timeControl: 'natural' }),\n);\n\n/**\n * Aggregate {@link Trigger.TriggerMonitorService} over the local\n * {@link TriggerDispatcher} and the remote {@link RemoteTriggerManager.Service}.\n * Provides a unified view of trigger state across local and edge environments.\n */\nconst TriggerMonitorSpec = LayerSpec.make(\n  {\n    affinity: 'space',\n    requires: [TriggerDispatcher, Database.Service, AtomRegistry.AtomRegistry, RemoteTriggerManager.Service],\n    provides: [Trigger.TriggerMonitorService],\n  },\n  () => TriggerMonitor.layer,\n);\n\nexport default Capability.makeModule(() =>\n  Effect.succeed([\n    Capability.contributes(Capabilities.LayerSpec, OperationHandlerProviderSpec),\n    Capability.contributes(Capabilities.LayerSpec, RegistrySpec),\n    Capability.contributes(Capabilities.LayerSpec, OpaqueToolkitSpec),\n    Capability.contributes(Capabilities.LayerSpec, OperationsToRegistrySpec),\n    Capability.contributes(Capabilities.LayerSpec, TriggerStateStoreSpec),\n    Capability.contributes(Capabilities.LayerSpec, FeedTraceSinkSpec),\n    Capability.contributes(Capabilities.LayerSpec, TriggerDispatcherSpec),\n    Capability.contributes(Capabilities.LayerSpec, RemoteTriggerManagerSpec),\n    Capability.contributes(Capabilities.LayerSpec, TriggerMonitorSpec),\n    Capability.contributes(Capabilities.LayerSpec, RemoteOperationInvokerSpec),\n    Capability.contributes(Capabilities.LayerSpec, RemoteProcessManagerSpec),\n    Capability.contributes(Capabilities.TraceSink, ({ resolver }) => FeedTraceSink.makeRoutingSink({ resolver })),\n  ]),\n);\n"],"mappings":"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"}

package/dist/lib/{neutral/chunk-HLO4LYXT.mjs → chunk-meta.mjs}

@@ -1,15 +1,12 @@
-// src/meta.ts
 import { Plugin } from "@dxos/app-framework";
-
-// dx.config.ts
 import { Config2 } from "@dxos/app-framework/config";
 import { trim } from "@dxos/util";
-var dx_config_default = Config2.make({
-  plugin: {
-    key: "org.dxos.plugin.routine",
-    name: "Routine",
-    author: "DXOS",
-    description: trim`
+//#region dx.config.ts
+var dx_config_default = Config2.make({ plugin: {
+	key: "org.dxos.plugin.routine",
+	name: "Routine",
+	author: "DXOS",
+	description: trim`
       Event-driven workflow automation engine for DXOS Composer.
       A Routine pairs a trigger ("when" — a timer schedule or an incoming feed) with an action
       ("then" — a persistent compute operation and instructions), enabling automated pipelines that
@@ -17,28 +14,23 @@ var dx_config_default = Config2.make({
 
       Routines are configured in their own article and surfaced on a per-object "Routines" companion
       that lists the routines connected to each object. A per-space TriggerDispatcher manages
-      execution: running locally in the browser when computeEnvironment is "local", or delegating to
-      the DXOS edge for server-side reliability; the space settings page chooses the runtime location.
+      execution: running each trigger locally in the browser, or delegating it to the DXOS edge for
+      server-side reliability when the trigger's "remote" flag is set; the space settings page toggles
+      trigger execution for the whole space.
 
       Operation handlers and skills contributed by any plugin in the application are
       automatically merged and made available to every space's OperationRegistry, so new
       capabilities registered by other plugins become instantly invocable from routines.
     `,
-    icon: {
-      key: "ph--atom--regular"
-    },
-    source: "https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-routine",
-    spec: "PLUGIN.mdl",
-    tags: [
-      "system"
-    ]
-  }
-});
-
-// src/meta.ts
+	icon: { key: "ph--atom--regular" },
+	source: "https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-routine",
+	spec: "PLUGIN.mdl",
+	tags: ["system"]
+} });
+//#endregion
+//#region src/meta.ts
 var meta = Plugin.getMetaFromConfig(dx_config_default);
+//#endregion
+export { meta as t };
 
-export {
-  meta
-};
-//# sourceMappingURL=chunk-HLO4LYXT.mjs.map
+//# sourceMappingURL=chunk-meta.mjs.map

package/dist/lib/chunk-meta.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-meta.mjs","names":[],"sources":["../../dx.config.ts","../../src/meta.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Config2 } from '@dxos/app-framework/config';\nimport { trim } from '@dxos/util';\n\nexport default Config2.make({\n  plugin: {\n    key: 'org.dxos.plugin.routine',\n    name: 'Routine',\n    author: 'DXOS',\n    description: trim`\n      Event-driven workflow automation engine for DXOS Composer.\n      A Routine pairs a trigger (\"when\" — a timer schedule or an incoming feed) with an action\n      (\"then\" — a persistent compute operation and instructions), enabling automated pipelines that\n      react to changes in real time without manual intervention.\n\n      Routines are configured in their own article and surfaced on a per-object \"Routines\" companion\n      that lists the routines connected to each object. A per-space TriggerDispatcher manages\n      execution: running each trigger locally in the browser, or delegating it to the DXOS edge for\n      server-side reliability when the trigger's \"remote\" flag is set; the space settings page toggles\n      trigger execution for the whole space.\n\n      Operation handlers and skills contributed by any plugin in the application are\n      automatically merged and made available to every space's OperationRegistry, so new\n      capabilities registered by other plugins become instantly invocable from routines.\n    `,\n    icon: { key: 'ph--atom--regular' },\n    source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-routine',\n    spec: 'PLUGIN.mdl',\n    tags: ['system'],\n  },\n});\n","//\n// Copyright 2023 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\n\nimport config from '../dx.config';\n\nexport const meta = Plugin.getMetaFromConfig(config);\n"],"mappings":";;;;AAOA,IAAA,oBAAe,QAAQ,KAAK,EAC1B,QAAQ;CACN,KAAK;CACL,MAAM;CACN,QAAQ;CACR,aAAa,IAAI;;;;;;;;;;;;;;;;CAgBjB,MAAM,EAAE,KAAK,oBAAoB;CACjC,QAAQ;CACR,MAAM;CACN,MAAM,CAAC,QAAQ;AACjB,EACF,CAAC;;;ACzBD,IAAa,OAAO,OAAO,kBAAkB,iBAAM"}

package/dist/lib/chunk-operation-handler.mjs

@@ -0,0 +1,11 @@
+import { Capabilities, Capability } from "@dxos/app-framework";
+import * as Effect from "effect/Effect";
+import { RoutineOperationHandlerSet } from "#operations";
+//#region src/capabilities/operation-handler.ts
+var operation_handler_default = Capability.makeModule(Effect.fnUntraced(function* () {
+	return Capability.contributes(Capabilities.OperationHandler, RoutineOperationHandlerSet);
+}));
+//#endregion
+export { operation_handler_default as default };
+
+//# sourceMappingURL=chunk-operation-handler.mjs.map

package/dist/lib/chunk-operation-handler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-operation-handler.mjs","names":[],"sources":["../../src/capabilities/operation-handler.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport type { OperationHandlerSet } from '@dxos/compute';\n\nimport { RoutineOperationHandlerSet } from '#operations';\n\nexport default Capability.makeModule<OperationHandlerSet.OperationHandlerSet>(\n  Effect.fnUntraced(function* () {\n    return Capability.contributes(Capabilities.OperationHandler, RoutineOperationHandlerSet);\n  }),\n);\n"],"mappings":";;;;AAWA,IAAA,4BAAe,WAAW,WACxB,OAAO,WAAW,aAAa;CAC7B,OAAO,WAAW,YAAY,aAAa,kBAAkB,0BAA0B;AACzF,CAAC,CACH"}

package/dist/lib/chunk-paths.mjs

@@ -0,0 +1,11 @@
+import { GraphPath } from "@dxos/app-toolkit";
+import { Routine } from "@dxos/compute";
+import { meta } from "#meta";
+//#region src/paths.ts
+var { getSectionPath: getRoutinesPath } = GraphPath.createTypeSectionPaths(Routine.Routine, { groupId: GraphPath.GroupSegments.ai });
+/** Path to the routines settings section for a given space. */
+var getRoutinesSettingsPath = (spaceId) => GraphPath.getSpacePath(spaceId, "settings", `${meta.profile.key}.routines`);
+//#endregion
+export { getRoutinesSettingsPath as n, getRoutinesPath as t };
+
+//# sourceMappingURL=chunk-paths.mjs.map

package/dist/lib/chunk-paths.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-paths.mjs","names":[],"sources":["../../src/paths.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { GraphPath } from '@dxos/app-toolkit';\nimport { Routine } from '@dxos/compute';\n\nimport { meta } from '#meta';\n\nconst { getSectionPath: getRoutinesPath } = GraphPath.createTypeSectionPaths(Routine.Routine, {\n  groupId: GraphPath.GroupSegments.ai,\n});\n\n/** Path to the routines settings section for a given space. */\nexport const getRoutinesSettingsPath = (spaceId: string): string =>\n  GraphPath.getSpacePath(spaceId, 'settings', `${meta.profile.key}.routines`);\n\nexport { getRoutinesPath };\n"],"mappings":";;;;AASA,IAAM,EAAE,gBAAgB,oBAAoB,UAAU,uBAAuB,QAAQ,SAAS,EAC5F,SAAS,UAAU,cAAc,GACnC,CAAC;;AAGD,IAAa,2BAA2B,YACtC,UAAU,aAAa,SAAS,YAAY,GAAG,KAAK,QAAQ,IAAI,UAAU"}

package/dist/lib/chunk-react-surface.mjs

@@ -0,0 +1,64 @@
+import { Capabilities, Capability } from "@dxos/app-framework";
+import { Routine, Skill } from "@dxos/compute";
+import { meta } from "#meta";
+import * as Effect from "effect/Effect";
+import { Surface } from "@dxos/app-framework/ui";
+import { RoutineCard } from "#components";
+import { AppSurface } from "@dxos/app-toolkit/ui";
+import { RoutineArticle, RoutineCompanion, RoutineSettings, RoutineTraceCompanion, SkillArticle } from "#containers";
+//#region src/capabilities/react-surface.ts
+var react_surface_default = Capability.makeModule(() => Effect.succeed(Capability.contributes(Capabilities.ReactSurface, [
+	Surface.create({
+		id: "spaceSettingsAutomation",
+		filter: AppSurface.literal(AppSurface.Article, `${meta.profile.key}.space-settings-automation`),
+		component: RoutineSettings
+	}),
+	Surface.create({
+		id: "automation.article",
+		filter: AppSurface.object(AppSurface.Article, Routine.Routine),
+		component: RoutineArticle,
+		props: ({ role, data: { subject, attendableId } }) => ({
+			role,
+			subject,
+			attendableId
+		})
+	}),
+	Surface.create({
+		id: "routine.card",
+		filter: AppSurface.object(AppSurface.CardContent, Routine.Routine),
+		component: RoutineCard,
+		props: ({ data: { subject } }) => ({ subject })
+	}),
+	Surface.create({
+		id: "companion.automation",
+		filter: AppSurface.allOf(AppSurface.literal(AppSurface.Article, "automation"), AppSurface.companion(AppSurface.Article)),
+		component: RoutineCompanion,
+		props: ({ data: { attendableId, companionTo } }) => ({
+			attendableId,
+			subject: companionTo
+		})
+	}),
+	Surface.create({
+		id: "routine.runs",
+		filter: AppSurface.allOf(AppSurface.literal(AppSurface.Article, "runs"), AppSurface.companion(AppSurface.Article, Routine.Routine)),
+		component: RoutineTraceCompanion,
+		props: ({ role, data: { companionTo } }) => ({
+			role,
+			subject: companionTo
+		})
+	}),
+	Surface.create({
+		id: "skill",
+		filter: AppSurface.object(AppSurface.Article, Skill.Skill),
+		component: SkillArticle,
+		props: ({ role, data: { subject, attendableId } }) => ({
+			role,
+			subject,
+			attendableId
+		})
+	})
+])));
+//#endregion
+export { react_surface_default as default };
+
+//# sourceMappingURL=chunk-react-surface.mjs.map

package/dist/lib/chunk-react-surface.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-react-surface.mjs","names":[],"sources":["../../src/capabilities/react-surface.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport { Surface } from '@dxos/app-framework/ui';\nimport { AppSurface } from '@dxos/app-toolkit/ui';\nimport { Routine, Skill } from '@dxos/compute';\n\nimport { RoutineCard } from '#components';\nimport { RoutineArticle, RoutineCompanion, RoutineSettings, RoutineTraceCompanion, SkillArticle } from '#containers';\nimport { meta } from '#meta';\n\nexport default Capability.makeModule(() =>\n  Effect.succeed(\n    Capability.contributes(Capabilities.ReactSurface, [\n      Surface.create({\n        id: 'spaceSettingsAutomation',\n        filter: AppSurface.literal(AppSurface.Article, `${meta.profile.key}.space-settings-automation`),\n        component: RoutineSettings,\n      }),\n      Surface.create({\n        id: 'automation.article',\n        filter: AppSurface.object(AppSurface.Article, Routine.Routine),\n        component: RoutineArticle,\n        props: ({ role, data: { subject, attendableId } }) => ({ role, subject, attendableId }),\n      }),\n      Surface.create({\n        id: 'routine.card',\n        filter: AppSurface.object(AppSurface.CardContent, Routine.Routine),\n        component: RoutineCard,\n        props: ({ data: { subject } }) => ({ subject }),\n      }),\n      Surface.create({\n        id: 'companion.automation',\n        filter: AppSurface.allOf(\n          AppSurface.literal(AppSurface.Article, 'automation'),\n          AppSurface.companion(AppSurface.Article),\n        ),\n        component: RoutineCompanion,\n        props: ({ data: { attendableId, companionTo } }) => ({ attendableId, subject: companionTo }),\n      }),\n      Surface.create({\n        id: 'routine.runs',\n        filter: AppSurface.allOf(\n          AppSurface.literal(AppSurface.Article, 'runs'),\n          AppSurface.companion(AppSurface.Article, Routine.Routine),\n        ),\n        component: RoutineTraceCompanion,\n        props: ({ role, data: { companionTo } }) => ({ role, subject: companionTo }),\n      }),\n      Surface.create({\n        id: 'skill',\n        filter: AppSurface.object(AppSurface.Article, Skill.Skill),\n        component: SkillArticle,\n        props: ({ role, data: { subject, attendableId } }) => ({ role, subject, attendableId }),\n      }),\n    ]),\n  ),\n);\n"],"mappings":";;;;;;;;;AAeA,IAAA,wBAAe,WAAW,iBACxB,OAAO,QACL,WAAW,YAAY,aAAa,cAAc;CAChD,QAAQ,OAAO;EACb,IAAI;EACJ,QAAQ,WAAW,QAAQ,WAAW,SAAS,GAAG,KAAK,QAAQ,IAAI,2BAA2B;EAC9F,WAAW;CACb,CAAC;CACD,QAAQ,OAAO;EACb,IAAI;EACJ,QAAQ,WAAW,OAAO,WAAW,SAAS,QAAQ,OAAO;EAC7D,WAAW;EACX,QAAQ,EAAE,MAAM,MAAM,EAAE,SAAS,sBAAsB;GAAE;GAAM;GAAS;EAAa;CACvF,CAAC;CACD,QAAQ,OAAO;EACb,IAAI;EACJ,QAAQ,WAAW,OAAO,WAAW,aAAa,QAAQ,OAAO;EACjE,WAAW;EACX,QAAQ,EAAE,MAAM,EAAE,iBAAiB,EAAE,QAAQ;CAC/C,CAAC;CACD,QAAQ,OAAO;EACb,IAAI;EACJ,QAAQ,WAAW,MACjB,WAAW,QAAQ,WAAW,SAAS,YAAY,GACnD,WAAW,UAAU,WAAW,OAAO,CACzC;EACA,WAAW;EACX,QAAQ,EAAE,MAAM,EAAE,cAAc,qBAAqB;GAAE;GAAc,SAAS;EAAY;CAC5F,CAAC;CACD,QAAQ,OAAO;EACb,IAAI;EACJ,QAAQ,WAAW,MACjB,WAAW,QAAQ,WAAW,SAAS,MAAM,GAC7C,WAAW,UAAU,WAAW,SAAS,QAAQ,OAAO,CAC1D;EACA,WAAW;EACX,QAAQ,EAAE,MAAM,MAAM,EAAE,qBAAqB;GAAE;GAAM,SAAS;EAAY;CAC5E,CAAC;CACD,QAAQ,OAAO;EACb,IAAI;EACJ,QAAQ,WAAW,OAAO,WAAW,SAAS,MAAM,KAAK;EACzD,WAAW;EACX,QAAQ,EAAE,MAAM,MAAM,EAAE,SAAS,sBAAsB;GAAE;GAAM;GAAS;EAAa;CACvF,CAAC;AACH,CAAC,CACH,CACF"}

package/dist/lib/chunk-registry-sync.mjs

@@ -0,0 +1,104 @@
+import { Capabilities, Capability } from "@dxos/app-framework";
+import { AppCapabilities } from "@dxos/app-toolkit";
+import { Operation } from "@dxos/compute";
+import { ClientCapabilities } from "@dxos/plugin-client";
+import * as Effect from "effect/Effect";
+import { log } from "@dxos/log";
+//#region src/capabilities/registry-sync.ts
+var __dxlog_file = "/__w/dxos/dxos/packages/plugins/plugin-routine/src/capabilities/registry-sync.ts";
+/**
+* Syncs plugin capability contributions into `client.graph.registry`.
+*
+* Watches two capability atoms and imperatively adds entities to the
+* hypergraph registry when they change:
+* - {@link AppCapabilities.SkillDefinition} → instantiates each skill via `def.make()`.
+* - {@link Capabilities.OperationHandler} → serializes each handler via `Operation.serialize`.
+*
+* Skill DB copies (stored in a space when a skill is "enabled") are treated as
+* user forks and are not overwritten. The registry is always used as the source of truth
+* for skill instructions at request time — see `formatSystemPrompt` in `@dxos/assistant`.
+*
+* Note: the plugin framework does not yet expose a teardown hook for capability
+* modules (see the TODO in process-manager-capability.ts), so the subscriptions
+* are not explicitly cancelled. They are effectively scoped to the client's lifetime.
+*/
+var registry_sync_default = Capability.makeModule(Effect.fnUntraced(function* () {
+	const client = yield* Capability.get(ClientCapabilities.Client);
+	const atomRegistry = yield* Capability.get(Capabilities.AtomRegistry);
+	const capabilityManager = yield* Capability.Service;
+	const skillDefinitionsAtom = capabilityManager.atom(AppCapabilities.SkillDefinition);
+	const prevSkillKeys = /* @__PURE__ */ new Set();
+	atomRegistry.subscribe(skillDefinitionsAtom, (definitions) => {
+		const fresh = [];
+		for (const def of definitions) if (!prevSkillKeys.has(def.key)) {
+			prevSkillKeys.add(def.key);
+			fresh.push(def.make());
+		}
+		if (fresh.length > 0) client.graph.registry.add(fresh);
+	}, { immediate: true });
+	const operationHandlersAtom = capabilityManager.atom(Capabilities.OperationHandler);
+	const prevOperationKeys = /* @__PURE__ */ new Set();
+	atomRegistry.subscribe(operationHandlersAtom, async (handlerSets) => {
+		try {
+			const handlers = (await Promise.all(handlerSets.map((set) => set.getHandlers()))).flat();
+			const seenKeys = /* @__PURE__ */ new Set();
+			const batch = [];
+			for (const handler of handlers) {
+				const key = handler.meta.key;
+				if (!key) {
+					log.warn("skipping operation handler without key", void 0, {
+						"~LogMeta": "~LogMeta",
+						F: __dxlog_file,
+						L: 76,
+						S: this
+					});
+					continue;
+				}
+				if (seenKeys.has(key)) {
+					log("skipping duplicate operation", { key }, {
+						"~LogMeta": "~LogMeta",
+						F: __dxlog_file,
+						L: 80,
+						S: this
+					});
+					continue;
+				}
+				seenKeys.add(key);
+				if (prevOperationKeys.has(key)) continue;
+				if (handler.meta.skipRegistry) {
+					prevOperationKeys.add(key);
+					continue;
+				}
+				try {
+					batch.push(Operation.serialize(handler));
+				} catch {
+					log.verbose("skipping operation with unserializable schema", { key }, {
+						"~LogMeta": "~LogMeta",
+						F: __dxlog_file,
+						L: 94,
+						S: this
+					});
+					prevOperationKeys.add(key);
+				}
+			}
+			if (batch.length > 0) {
+				client.graph.registry.add(batch);
+				for (const operation of batch) {
+					const operationKey = Operation.getKey(operation);
+					if (operationKey) prevOperationKeys.add(operationKey);
+				}
+			}
+		} catch (error) {
+			log.catch(error, void 0, {
+				"~LogMeta": "~LogMeta",
+				F: __dxlog_file,
+				L: 108,
+				S: this
+			});
+		}
+	}, { immediate: true });
+}));
+//#endregion
+export { registry_sync_default as default };
+
+//# sourceMappingURL=chunk-registry-sync.mjs.map

package/dist/lib/chunk-registry-sync.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-registry-sync.mjs","names":[],"sources":["../../src/capabilities/registry-sync.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport { AppCapabilities } from '@dxos/app-toolkit';\nimport { Operation, Skill } from '@dxos/compute';\nimport { log } from '@dxos/log';\nimport { ClientCapabilities } from '@dxos/plugin-client';\n\n/**\n * Syncs plugin capability contributions into `client.graph.registry`.\n *\n * Watches two capability atoms and imperatively adds entities to the\n * hypergraph registry when they change:\n * - {@link AppCapabilities.SkillDefinition} → instantiates each skill via `def.make()`.\n * - {@link Capabilities.OperationHandler} → serializes each handler via `Operation.serialize`.\n *\n * Skill DB copies (stored in a space when a skill is \"enabled\") are treated as\n * user forks and are not overwritten. The registry is always used as the source of truth\n * for skill instructions at request time — see `formatSystemPrompt` in `@dxos/assistant`.\n *\n * Note: the plugin framework does not yet expose a teardown hook for capability\n * modules (see the TODO in process-manager-capability.ts), so the subscriptions\n * are not explicitly cancelled. They are effectively scoped to the client's lifetime.\n */\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    const client = yield* Capability.get(ClientCapabilities.Client);\n    const atomRegistry = yield* Capability.get(Capabilities.AtomRegistry);\n    const capabilityManager = yield* Capability.Service;\n\n    //\n    // Skill registration.\n    //\n\n    const skillDefinitionsAtom = capabilityManager.atom(AppCapabilities.SkillDefinition);\n    const prevSkillKeys = new Set<string>();\n\n    atomRegistry.subscribe(\n      skillDefinitionsAtom,\n      (definitions) => {\n        const fresh: Skill.Skill[] = [];\n        for (const def of definitions) {\n          if (!prevSkillKeys.has(def.key)) {\n            prevSkillKeys.add(def.key);\n            fresh.push(def.make());\n          }\n        }\n        if (fresh.length > 0) {\n          client.graph.registry.add(fresh);\n        }\n      },\n      { immediate: true },\n    );\n\n    //\n    // Operation registration.\n    //\n\n    const operationHandlersAtom = capabilityManager.atom(Capabilities.OperationHandler);\n    const prevOperationKeys = new Set<string>();\n\n    atomRegistry.subscribe(\n      operationHandlersAtom,\n      async (handlerSets) => {\n        try {\n          const handlers = (await Promise.all(handlerSets.map((set) => set.getHandlers()))).flat();\n          const seenKeys = new Set<string>();\n          const batch: Operation.PersistentOperation[] = [];\n          for (const handler of handlers) {\n            const key = handler.meta.key;\n            if (!key) {\n              log.warn('skipping operation handler without key');\n              continue;\n            }\n            if (seenKeys.has(key)) {\n              log('skipping duplicate operation', { key });\n              continue;\n            }\n            seenKeys.add(key);\n            if (prevOperationKeys.has(key)) {\n              continue;\n            }\n            if (handler.meta.skipRegistry) {\n              prevOperationKeys.add(key);\n              continue;\n            }\n            try {\n              batch.push(Operation.serialize(handler));\n            } catch {\n              log.verbose('skipping operation with unserializable schema', { key });\n              prevOperationKeys.add(key);\n            }\n          }\n          if (batch.length > 0) {\n            client.graph.registry.add(batch);\n            for (const operation of batch) {\n              const operationKey = Operation.getKey(operation);\n              if (operationKey) {\n                prevOperationKeys.add(operationKey);\n              }\n            }\n          }\n        } catch (error) {\n          log.catch(error);\n        }\n      },\n      { immediate: true },\n    );\n  }),\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA4BA,IAAA,wBAAe,WAAW,WACxB,OAAO,WAAW,aAAa;CAC7B,MAAM,SAAS,OAAO,WAAW,IAAI,mBAAmB,MAAM;CAC9D,MAAM,eAAe,OAAO,WAAW,IAAI,aAAa,YAAY;CACpE,MAAM,oBAAoB,OAAO,WAAW;CAM5C,MAAM,uBAAuB,kBAAkB,KAAK,gBAAgB,eAAe;CACnF,MAAM,gCAAgB,IAAI,IAAY;CAEtC,aAAa,UACX,uBACC,gBAAgB;EACf,MAAM,QAAuB,CAAC;EAC9B,KAAK,MAAM,OAAO,aAChB,IAAI,CAAC,cAAc,IAAI,IAAI,GAAG,GAAG;GAC/B,cAAc,IAAI,IAAI,GAAG;GACzB,MAAM,KAAK,IAAI,KAAK,CAAC;EACvB;EAEF,IAAI,MAAM,SAAS,GACjB,OAAO,MAAM,SAAS,IAAI,KAAK;CAEnC,GACA,EAAE,WAAW,KAAK,CACpB;CAMA,MAAM,wBAAwB,kBAAkB,KAAK,aAAa,gBAAgB;CAClF,MAAM,oCAAoB,IAAI,IAAY;CAE1C,aAAa,UACX,uBACA,OAAO,gBAAgB;EACrB,IAAI;GACF,MAAM,YAAY,MAAM,QAAQ,IAAI,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,CAAC,EAAA,CAAG,KAAK;GACvF,MAAM,2BAAW,IAAI,IAAY;GACjC,MAAM,QAAyC,CAAC;GAChD,KAAK,MAAM,WAAW,UAAU;IAC9B,MAAM,MAAM,QAAQ,KAAK;IACzB,IAAI,CAAC,KAAK;KACR,IAAI,KAAK,0CAAuC,KAAA,GAAA;MAAA,YAAA;MAAA,GAAA;MAAA,GAAA;MAAA,GAAA;KAAA,CAAC;KACjD;IACF;IACA,IAAI,SAAS,IAAI,GAAG,GAAG;KACrB,IAAI,gCAAgC,EAAE,IAAI,GAAA;MAAA,YAAA;MAAA,GAAA;MAAA,GAAA;MAAA,GAAA;KAAA,CAAC;KAC3C;IACF;IACA,SAAS,IAAI,GAAG;IAChB,IAAI,kBAAkB,IAAI,GAAG,GAC3B;IAEF,IAAI,QAAQ,KAAK,cAAc;KAC7B,kBAAkB,IAAI,GAAG;KACzB;IACF;IACA,IAAI;KACF,MAAM,KAAK,UAAU,UAAU,OAAO,CAAC;IACzC,QAAQ;KACN,IAAI,QAAQ,iDAAiD,EAAE,IAAI,GAAA;MAAA,YAAA;MAAA,GAAA;MAAA,GAAA;MAAA,GAAA;KAAA,CAAC;KACpE,kBAAkB,IAAI,GAAG;IAC3B;GACF;GACA,IAAI,MAAM,SAAS,GAAG;IACpB,OAAO,MAAM,SAAS,IAAI,KAAK;IAC/B,KAAK,MAAM,aAAa,OAAO;KAC7B,MAAM,eAAe,UAAU,OAAO,SAAS;KAC/C,IAAI,cACF,kBAAkB,IAAI,YAAY;IAEtC;GACF;EACF,SAAS,OAAO;GACd,IAAI,MAAM,OAAI,KAAA,GAAA;IAAA,YAAA;IAAA,GAAA;IAAA,GAAA;IAAA,GAAA;GAAA,CAAC;EACjB;CACF,GACA,EAAE,WAAW,KAAK,CACpB;AACF,CAAC,CACH"}

package/dist/lib/chunk-run-routine.mjs

@@ -0,0 +1,57 @@
+import { i as RunRoutine } from "./chunk-types.mjs";
+import { Operation, Trigger } from "@dxos/compute";
+import { Database, Obj } from "@dxos/echo";
+import { RunInstructions } from "@dxos/assistant-toolkit";
+import * as Effect from "effect/Effect";
+import { invariant } from "@dxos/invariant";
+import { createInvocationPayload } from "@dxos/compute-runtime";
+//#region src/operations/run-routine.ts
+var __dxlog_file = "/__w/dxos/dxos/packages/plugins/plugin-routine/src/operations/run-routine.ts";
+var handler = RunRoutine.pipe(Operation.withHandler(Effect.fnUntraced(function* ({ routine }) {
+	const routineObj = yield* Database.load(routine);
+	const db = Obj.getDatabase(routineObj);
+	invariant(db, "Routine is not attached to a database.", {
+		"~LogMeta": "~LogMeta",
+		F: __dxlog_file,
+		L: 23,
+		S: this,
+		A: ["db", "'Routine is not attached to a database.'"]
+	});
+	const trigger = routineObj.triggers[0] ? yield* Database.load(routineObj.triggers[0]) : void 0;
+	if (trigger?.remote === true) {
+		yield* (yield* Trigger.TriggerMonitorService).invokeTrigger({
+			trigger,
+			event: { tick: Date.now() }
+		});
+		return;
+	}
+	const spec = routineObj.spec;
+	if (spec?.kind === "instructions") {
+		yield* Operation.schedule(RunInstructions, {
+			instructions: spec.instructions,
+			input: {}
+		}, { spaceId: db.spaceId });
+		return;
+	}
+	invariant(spec?.kind === "runnable", "Routine has no action to run.", {
+		"~LogMeta": "~LogMeta",
+		F: __dxlog_file,
+		L: 50,
+		S: this,
+		A: ["spec?.kind === 'runnable'", "'Routine has no action to run.'"]
+	});
+	const operation = yield* Database.load(spec.runnable);
+	invariant(Obj.instanceOf(Operation.PersistentOperation, operation), "Routine has no action to run.", {
+		"~LogMeta": "~LogMeta",
+		F: __dxlog_file,
+		L: 52,
+		S: this,
+		A: ["Obj.instanceOf(Operation.PersistentOperation, operation)", "'Routine has no action to run.'"]
+	});
+	const input = trigger ? createInvocationPayload(trigger, { tick: Date.now() }) : void 0;
+	yield* Operation.invoke(Operation.deserialize(operation), input);
+})));
+//#endregion
+export { handler as default };
+
+//# sourceMappingURL=chunk-run-routine.mjs.map

package/dist/lib/chunk-run-routine.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-run-routine.mjs","names":[],"sources":["../../src/operations/run-routine.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { RunInstructions } from '@dxos/assistant-toolkit';\nimport { Operation, Trigger } from '@dxos/compute';\nimport { createInvocationPayload } from '@dxos/compute-runtime';\nimport { Database, Obj } from '@dxos/echo';\nimport { invariant } from '@dxos/invariant';\n\nimport { RoutineOperation } from '../types';\n\n// A routine's action is its `runnable`: either an Operation (invoked directly) or the routine's owned\n// Instructions object (run as a background process — the same path triggers use — without creating a new\n// Chat session object).\nconst handler: Operation.WithHandler<typeof RoutineOperation.RunRoutine> = RoutineOperation.RunRoutine.pipe(\n  Operation.withHandler(\n    Effect.fnUntraced(function* ({ routine }) {\n      const routineObj = yield* Database.load(routine);\n      const db = Obj.getDatabase(routineObj);\n      invariant(db, 'Routine is not attached to a database.');\n      // Triggers, not routines, carry the runnable's input binding (e.g. a sync routine's `binding`\n      // cursor) and the `remote` flag, so a manual run goes through the first trigger — the one it is\n      // also attributed to.\n      const trigger = routineObj.triggers[0] ? yield* Database.load(routineObj.triggers[0]) : undefined;\n\n      // An edge routine is registered only on the EDGE dispatcher, so running it means force-running that\n      // trigger over HTTP; invoking the runnable here would silently run it on the client instead.\n      if (trigger?.remote === true) {\n        const monitor = yield* Trigger.TriggerMonitorService;\n        yield* monitor.invokeTrigger({ trigger, event: { tick: Date.now() } });\n        return;\n      }\n\n      // The action kind is explicit in `spec`; dispatch by kind rather than dereferencing to classify.\n      const spec = routineObj.spec;\n      if (spec?.kind === 'instructions') {\n        // The instructions carry their own context objects and skills; RunInstructions binds them when it\n        // executes. No Chat session object is created — the run appears in the process monitor only.\n        yield* Operation.schedule(\n          RunInstructions,\n          { instructions: spec.instructions, input: {} },\n          { spaceId: db.spaceId },\n        );\n        return;\n      }\n\n      invariant(spec?.kind === 'runnable', 'Routine has no action to run.');\n      const operation = yield* Database.load(spec.runnable);\n      invariant(Obj.instanceOf(Operation.PersistentOperation, operation), 'Routine has no action to run.');\n      // Built by the dispatcher's own payload builder against a synthetic tick, so a manual run resolves\n      // `{{event.*}}`/`{{trigger.*}}` templates exactly as a scheduled fire would.\n      const input = trigger ? createInvocationPayload(trigger, { tick: Date.now() }) : undefined;\n      yield* Operation.invoke(Operation.deserialize(operation), input);\n    }),\n  ),\n);\n\nexport default handler;\n"],"mappings":";;;;;;;;;AAiBA,IAAM,UAAA,WAAiG,KACrG,UAAU,YACR,OAAO,WAAW,WAAW,EAAE,WAAW;CACxC,MAAM,aAAa,OAAO,SAAS,KAAK,OAAO;CAC/C,MAAM,KAAK,IAAI,YAAY,UAAU;CACrC,UAAU,IAAI,0CAAuC;EAAA,YAAA;EAAA,GAAA;EAAA,GAAA;EAAA,GAAA;EAAA,GAAA,CAAA,MAAA,0CAAA;CAAA,CAAC;CAItD,MAAM,UAAU,WAAW,SAAS,KAAK,OAAO,SAAS,KAAK,WAAW,SAAS,EAAE,IAAI,KAAA;CAIxF,IAAI,SAAS,WAAW,MAAM;EAE5B,QAAO,OADgB,QAAQ,sBAAA,CAChB,cAAc;GAAE;GAAS,OAAO,EAAE,MAAM,KAAK,IAAI,EAAE;EAAE,CAAC;EACrE;CACF;CAGA,MAAM,OAAO,WAAW;CACxB,IAAI,MAAM,SAAS,gBAAgB;EAGjC,OAAO,UAAU,SACf,iBACA;GAAE,cAAc,KAAK;GAAc,OAAO,CAAC;EAAE,GAC7C,EAAE,SAAS,GAAG,QAAQ,CACxB;EACA;CACF;CAEA,UAAU,MAAM,SAAS,YAAY,iCAA8B;EAAA,YAAA;EAAA,GAAA;EAAA,GAAA;EAAA,GAAA;EAAA,GAAA,CAAA,6BAAA,iCAAA;CAAA,CAAC;CACpE,MAAM,YAAY,OAAO,SAAS,KAAK,KAAK,QAAQ;CACpD,UAAU,IAAI,WAAW,UAAU,qBAAqB,SAAS,GAAG,iCAA8B;EAAA,YAAA;EAAA,GAAA;EAAA,GAAA;EAAA,GAAA;EAAA,GAAA,CAAA,4DAAA,iCAAA;CAAA,CAAC;CAGnG,MAAM,QAAQ,UAAU,wBAAwB,SAAS,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC,IAAI,KAAA;CACjF,OAAO,UAAU,OAAO,UAAU,YAAY,SAAS,GAAG,KAAK;AACjE,CAAC,CACH,CACF"}

package/dist/lib/chunk-templates.mjs

@@ -0,0 +1,37 @@
+import { t as makeRoutine } from "./chunk-util.mjs";
+import { Capability } from "@dxos/app-framework";
+import { AppAnnotation } from "@dxos/app-toolkit";
+import { Instructions, Skill, Trigger } from "@dxos/compute";
+import { Obj, Ref, Type } from "@dxos/echo";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { RoutineCapabilities } from "#types";
+/** Templates contributed by plugin-routine itself. */
+var defaultTemplates = [{
+	id: RoutineCapabilities.BlankTemplateId,
+	label: "Blank",
+	icon: "ph--lightning--regular",
+	scaffold: ({ name, subject }) => Effect.succeed(makeRoutine({
+		name,
+		instructions: Instructions.make({
+			skills: subject ? skillRefsForObject(subject) : [],
+			objects: subject ? [Ref.make(subject)] : void 0
+		}),
+		trigger: Trigger.make({})
+	}))
+}];
+/** Registry skill refs declared by the object type's {@link AppAnnotation.SkillsAnnotation}. */
+var skillRefsForObject = (object) => {
+	const type = Obj.getType(object);
+	if (!type) return [];
+	return Option.getOrElse(() => [])(AppAnnotation.SkillsAnnotation.get(Type.getSchema(type))).map((key) => Ref.fromURI(Skill.registryURI(key)));
+};
+//#endregion
+//#region src/capabilities/templates.ts
+var templates_default = Capability.makeModule(Effect.fnUntraced(function* () {
+	return defaultTemplates.map((template) => Capability.contributes(RoutineCapabilities.Template, template));
+}));
+//#endregion
+export { templates_default as default };
+
+//# sourceMappingURL=chunk-templates.mjs.map

package/dist/lib/chunk-templates.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-templates.mjs","names":[],"sources":["../../src/templates/index.ts","../../src/capabilities/templates.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Option from 'effect/Option';\n\nimport { AppAnnotation } from '@dxos/app-toolkit';\nimport { Instructions, Skill, Trigger } from '@dxos/compute';\nimport { Obj, Ref, Type } from '@dxos/echo';\n\nimport { RoutineCapabilities } from '#types';\n\nimport { makeRoutine } from '../util';\n\n/**\n * Blank template: an instructions-action routine draft with an empty trigger; the action kind, schedule, and\n * body are configured in the form. In an object companion the instructions are seeded with the subject (in\n * `objects`) and its type's skills so the draft starts associated with the subject; the global create dialog\n * (no subject) starts with bare instructions.\n */\nexport const blank: RoutineCapabilities.Template = {\n  id: RoutineCapabilities.BlankTemplateId,\n  label: 'Blank',\n  icon: 'ph--lightning--regular',\n  scaffold: ({ name, subject }) =>\n    Effect.succeed(\n      makeRoutine({\n        name,\n        instructions: Instructions.make({\n          skills: subject ? skillRefsForObject(subject) : [],\n          objects: subject ? [Ref.make(subject)] : undefined,\n        }),\n        trigger: Trigger.make({}),\n      }),\n    ),\n};\n\n/** Templates contributed by plugin-routine itself. */\nexport const defaultTemplates: RoutineCapabilities.Template[] = [blank];\n\n/** Registry skill refs declared by the object type's {@link AppAnnotation.SkillsAnnotation}. */\nconst skillRefsForObject = (object: Obj.Unknown): Ref.Ref<Skill.Skill>[] => {\n  const type = Obj.getType(object);\n  if (!type) {\n    return [];\n  }\n  const keys = Option.getOrElse(() => [] as string[])(AppAnnotation.SkillsAnnotation.get(Type.getSchema(type)));\n  return keys.map((key) => Ref.fromURI(Skill.registryURI(key)));\n};\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capability } from '@dxos/app-framework';\n\nimport { RoutineCapabilities } from '#types';\n\nimport { defaultTemplates } from '../templates';\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    return defaultTemplates.map((template) => Capability.contributes(RoutineCapabilities.Template, template));\n  }),\n);\n"],"mappings":";;;;;;;;;AAuCA,IAAa,mBAAmD,CAAC;CAjB/D,IAAI,oBAAoB;CACxB,OAAO;CACP,MAAM;CACN,WAAW,EAAE,MAAM,cACjB,OAAO,QACL,YAAY;EACV;EACA,cAAc,aAAa,KAAK;GAC9B,QAAQ,UAAU,mBAAmB,OAAO,IAAI,CAAC;GACjD,SAAS,UAAU,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,KAAA;EAC3C,CAAC;EACD,SAAS,QAAQ,KAAK,CAAC,CAAC;CAC1B,CAAC,CACH;AAI6D,CAAK;;AAGtE,IAAM,sBAAsB,WAAgD;CAC1E,MAAM,OAAO,IAAI,QAAQ,MAAM;CAC/B,IAAI,CAAC,MACH,OAAO,CAAC;CAGV,OADa,OAAO,gBAAgB,CAAC,CAAa,CAAC,CAAC,cAAc,iBAAiB,IAAI,KAAK,UAAU,IAAI,CAAC,CACpG,CAAA,CAAK,KAAK,QAAQ,IAAI,QAAQ,MAAM,YAAY,GAAG,CAAC,CAAC;AAC9D;;;ACrCA,IAAA,oBAAe,WAAW,WACxB,OAAO,WAAW,aAAa;CAC7B,OAAO,iBAAiB,KAAK,aAAa,WAAW,YAAY,oBAAoB,UAAU,QAAQ,CAAC;AAC1G,CAAC,CACH"}