@dxos/plugin-routine 0.11.1 → 0.12.0-next-2800d0376abcc62d5544afdd744b16b2b960434e

package/dist/lib/Routine.mjs

@@ -0,0 +1,34 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { meta } from "#meta";
+import { Database } from "@dxos/echo";
+import * as Schema from "effect/Schema";
+//#region src/types/Routine.ts
+var Routine_exports = /* @__PURE__ */ __exportAll({
+	AutomationAction: () => AutomationAction,
+	TriggerTemplate: () => TriggerTemplate
+});
+var TriggerTemplate = Schema.Union([Schema.Struct({
+	type: Schema.Literal("timer"),
+	cron: Schema.String
+}), Schema.Struct({
+	type: Schema.Literal("feed"),
+	feed: Schema.Any
+})]);
+var AutomationAction;
+(function(_AutomationAction) {
+	class CreateTriggerFromTemplate extends Schema.TaggedClass()(`${meta.profile.key}.action.create-trigger-from-template`, {
+		input: Schema.Struct({
+			db: Database.Database,
+			template: TriggerTemplate,
+			enabled: Schema.optional(Schema.Boolean),
+			scriptName: Schema.optional(Schema.String),
+			input: Schema.optional(Schema.Record(Schema.String, Schema.Any))
+		}),
+		output: Schema.Void
+	}) {}
+	_AutomationAction.CreateTriggerFromTemplate = CreateTriggerFromTemplate;
+})(AutomationAction || (AutomationAction = {}));
+//#endregion
+export { AutomationAction, TriggerTemplate, Routine_exports as t };
+
+//# sourceMappingURL=Routine.mjs.map

package/dist/lib/Routine.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Routine.mjs","names":[],"sources":["../../src/types/Routine.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { Database } from '@dxos/echo';\n\nimport { meta } from '#meta';\n\nexport const TriggerTemplate = Schema.Union([\n  Schema.Struct({ type: Schema.Literal('timer'), cron: Schema.String }),\n  Schema.Struct({ type: Schema.Literal('feed'), feed: Schema.Any }),\n]);\n\nexport namespace AutomationAction {\n  export class CreateTriggerFromTemplate extends Schema.TaggedClass<CreateTriggerFromTemplate>()(\n    `${meta.profile.key}.action.create-trigger-from-template`,\n    {\n      input: Schema.Struct({\n        db: Database.Database,\n        template: TriggerTemplate,\n        enabled: Schema.optional(Schema.Boolean),\n        // TODO(wittjosiah): Improve how this lookup is done.\n        scriptName: Schema.optional(Schema.String),\n        input: Schema.optional(Schema.Record(Schema.String, Schema.Any)),\n      }),\n      output: Schema.Void,\n    },\n  ) {}\n}\n"],"mappings":";;;;;;;;;AAUA,IAAa,kBAAkB,OAAO,MAAM,CAC1C,OAAO,OAAO;CAAE,MAAM,OAAO,QAAQ,OAAO;CAAG,MAAM,OAAO;AAAO,CAAC,GACpE,OAAO,OAAO;CAAE,MAAM,OAAO,QAAQ,MAAM;CAAG,MAAM,OAAO;AAAI,CAAC,CAClE,CAAC;AAEM,IAAU;CAAV,SAAA,mBAAA;CACE,MAAM,kCAAkC,OAAO,YAAuC,CAAC,CAC5F,GAAG,KAAK,QAAQ,IAAI,uCACpB;EACE,OAAO,OAAO,OAAO;GACnB,IAAI,SAAS;GACb,UAAU;GACV,SAAS,OAAO,SAAS,OAAO,OAAO;GAEvC,YAAY,OAAO,SAAS,OAAO,MAAM;GACzC,OAAO,OAAO,SAAS,OAAO,OAAO,OAAO,QAAQ,OAAO,GAAG,CAAC;EACjE,CAAC;EACD,QAAQ,OAAO;CACjB,CACF,CAAC,CAAC,CAAC;;AACL,EAAA,CAAA,qBAAA,mBAAA,CAAA,EAAA"}

package/dist/lib/RoutineCapabilities.mjs

@@ -0,0 +1,30 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import * as Capability from "@dxos/app-framework/Capability";
+//#region src/types/RoutineCapabilities.ts
+var RoutineCapabilities_exports = /* @__PURE__ */ __exportAll({
+	AgentDelegationStrategy: () => AgentDelegationStrategy,
+	BlankTemplateId: () => BlankTemplateId,
+	Template: () => Template
+});
+/**
+* Optional supervisor strategy for the agent chat service. When contributed (by a plugin that knows
+* the agent/plan model, e.g. plugin-assistant), the conversational agent delegates outstanding work
+* to sub-agents and folds their results back into the conversation. Consumed by the AgentService
+* LayerSpec; absent by default (a plain conversational agent).
+*
+* A registry rather than a singleton: the AgentService reads it with `getAll` and takes the first,
+* and a harness that needs the strategy in place before the app's own module activates has to be
+* able to contribute one without the two colliding.
+*/
+var AgentDelegationStrategy = Capability.make()("org.dxos.plugin.routine.capability.agentDelegationStrategy");
+/**
+* Id of the built-in blank template. Declared here (rather than on the template itself) so callers that
+* scaffold a routine without the picker — e.g. a project's toolbar — can name it without importing the
+* template module.
+*/
+var BlankTemplateId = "org.dxos.routine.blank";
+var Template = Capability.make()("org.dxos.plugin.routine.capability.template");
+//#endregion
+export { AgentDelegationStrategy, BlankTemplateId, Template, RoutineCapabilities_exports as t };
+
+//# sourceMappingURL=RoutineCapabilities.mjs.map

package/dist/lib/RoutineCapabilities.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoutineCapabilities.mjs","names":[],"sources":["../../src/types/RoutineCapabilities.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport type * as Effect from 'effect/Effect';\nimport type * as Schema from 'effect/Schema';\n\nimport type { DelegationStrategy } from '@dxos/agent-runtime';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as Routine from '@dxos/compute/Routine';\nimport type { Database, Obj } from '@dxos/echo';\n\n/**\n * Optional supervisor strategy for the agent chat service. When contributed (by a plugin that knows\n * the agent/plan model, e.g. plugin-assistant), the conversational agent delegates outstanding work\n * to sub-agents and folds their results back into the conversation. Consumed by the AgentService\n * LayerSpec; absent by default (a plain conversational agent).\n *\n * A registry rather than a singleton: the AgentService reads it with `getAll` and takes the first,\n * and a harness that needs the strategy in place before the app's own module activates has to be\n * able to contribute one without the two colliding.\n */\nexport const AgentDelegationStrategy = Capability.make<DelegationStrategy>()(\n  'org.dxos.plugin.routine.capability.agentDelegationStrategy',\n);\n\n/**\n * Id of the built-in blank template. Declared here (rather than on the template itself) so callers that\n * scaffold a routine without the picker — e.g. a project's toolbar — can name it without importing the\n * template module.\n */\nexport const BlankTemplateId = 'org.dxos.routine.blank';\n\n/**\n * A routine template contributed by a plugin. The create dialog lists contributed templates\n * (`Capability.getAll(RoutineCapabilities.Template)`) and runs the chosen template's `scaffold`.\n */\nexport type Template = {\n  /** Stable id (e.g. 'org.dxos.routine.blank'). */\n  id: string;\n  /** Human-readable label shown in the picker. */\n  label: string;\n  /** Optional Phosphor icon name. */\n  icon?: string;\n  /** Omit from the create picker; reachable only by id, for a template that needs a caller's `subject`. */\n  hidden?: boolean;\n  /** Values the create panel collects as a form before scaffolding; omit and it scaffolds on selection. */\n  inputSchema?: Schema.Codec<any, any>;\n  /**\n   * Build the routine as a fully-wired in-memory {@link Routine.Routine} graph — the routine plus its owned\n   * trigger and instructions, assembled by `makeRoutine`. The create flow persists it with a single\n   * `Database.add` (which cascades the owned children); scaffold must NOT call `Database.add` itself.\n   * `Database.Service` may still be used for read-only lookups (e.g. loading a feed ref). `input` carries\n   * the {@link inputSchema} values; `subject` is set only by a caller that seeds this template by id.\n   */\n  scaffold: (ctx: {\n    name?: string;\n    subject?: Obj.Unknown;\n    input?: any;\n  }) => Effect.Effect<Routine.Routine, Error, Database.Service>;\n};\n\nexport const Template = Capability.make<Template>()('org.dxos.plugin.routine.capability.template');\n"],"mappings":";;;;;;;;;;;;;;;;;;AAsBA,IAAa,0BAA0B,WAAW,KAAyB,CAAC,CAC1E,4DACF;;;;;;AAOA,IAAa,kBAAkB;AA+B/B,IAAa,WAAW,WAAW,KAAe,CAAC,CAAC,6CAA6C"}

package/dist/lib/RoutineEvents.mjs

@@ -0,0 +1,14 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { meta } from "#meta";
+import * as ActivationEvent from "@dxos/app-framework/ActivationEvent";
+//#region src/types/RoutineEvents.ts
+var RoutineEvents_exports = /* @__PURE__ */ __exportAll({ Start: () => Start });
+/**
+* The feature's start event: cross-plugin contributions consumed by this feature activate here,
+* alongside the plugin's own start-gated modules. Fired on demand and by the host's idle trickle.
+*/
+var Start = ActivationEvent.pluginStart(meta.profile.key);
+//#endregion
+export { Start, RoutineEvents_exports as t };
+
+//# sourceMappingURL=RoutineEvents.mjs.map

package/dist/lib/RoutineEvents.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoutineEvents.mjs","names":[],"sources":["../../src/types/RoutineEvents.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as ActivationEvent from '@dxos/app-framework/ActivationEvent';\n\nimport { meta } from '#meta';\n\n/**\n * The feature's start event: cross-plugin contributions consumed by this feature activate here,\n * alongside the plugin's own start-gated modules. Fired on demand and by the host's idle trickle.\n */\nexport const Start = ActivationEvent.pluginStart(meta.profile.key);\n"],"mappings":";;;;;;;;;AAcA,IAAa,QAAQ,gBAAgB,YAAY,KAAK,QAAQ,GAAG"}

package/dist/lib/RoutineOperation.mjs

@@ -0,0 +1,92 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { TriggerTemplate } from "./Routine.mjs";
+import * as Capability from "@dxos/app-framework/Capability";
+import * as Plugin from "@dxos/app-framework/Plugin";
+import * as Routine from "@dxos/compute/Routine";
+import { DXN, Database, Obj, Ref, Type } from "@dxos/echo";
+import * as Schema from "effect/Schema";
+import * as Instructions from "@dxos/compute/Instructions";
+import * as Operation from "@dxos/compute/Operation";
+import * as Trigger from "@dxos/compute/Trigger";
+import * as Chat from "@dxos/assistant-toolkit/Chat";
+import { EID as _EchoURIReference } from "@dxos/keys";
+//#region src/types/RoutineOperation.ts
+var RoutineOperation_exports = /* @__PURE__ */ __exportAll({
+	CreateRoutine: () => CreateRoutine,
+	CreateTriggerFromTemplate: () => CreateTriggerFromTemplate,
+	RunPromptInNewChat: () => RunPromptInNewChat,
+	RunRoutine: () => RunRoutine,
+	_EchoURIReference: () => _EchoURIReference
+});
+var CreateTriggerFromTemplate = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.routine.createTriggerFromTemplate"),
+		name: "Create Trigger From Template",
+		icon: "ph--lightning--regular"
+	},
+	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(Schema.String, Schema.Any))
+	}),
+	output: Schema.Void
+});
+var CreateRoutine = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.routine.createAutomation"),
+		name: "Create Routine",
+		icon: "ph--lightning--regular"
+	},
+	services: [Capability.Service, Plugin.Service],
+	input: Schema.Struct({
+		db: Database.Database,
+		templateId: Schema.String,
+		name: Schema.optional(Schema.String),
+		subject: Schema.optional(Obj.Unknown),
+		/** Values for the template's `inputSchema`. */
+		input: Schema.optional(Schema.Unknown)
+	}),
+	output: Schema.Struct({
+		id: Schema.String,
+		object: Obj.Unknown
+	})
+});
+var RunPromptInNewChat = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.routine.runPromptInNewChat"),
+		name: "Run Prompt In New Chat",
+		icon: "ph--chat-text--regular"
+	},
+	services: [Capability.Service],
+	input: Schema.Struct({
+		db: Database.Database,
+		/** Context objects to bind to the new chat. */
+		objects: Schema.optional(Schema.Array(Obj.Unknown)),
+		/** Skill keys to look up and bind to the new chat. */
+		skills: Schema.optional(Schema.Array(Schema.String)),
+		/** Raw instructions or an existing Routine object reference. */
+		instructions: Schema.Union([Schema.String, Ref.Ref(Instructions.Instructions)]),
+		/**
+		* When true, skips opening the chat: runs the Agent prompt operation against the new chat via the compute runtime (traced).
+		*/
+		background: Schema.optional(Schema.Boolean)
+	}),
+	output: Schema.Struct({ object: Type.getSchema(Chat.Chat) })
+});
+var RunRoutine = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.routine.runAutomation"),
+		name: "Run Routine",
+		icon: "ph--play--regular"
+	},
+	services: [Capability.Service, Trigger.TriggerMonitorService],
+	input: Schema.Struct({ routine: Ref.Ref(Routine.Routine) }),
+	output: Schema.Void
+});
+//#endregion
+export { CreateRoutine, CreateTriggerFromTemplate, RunPromptInNewChat, RunRoutine, _EchoURIReference, RoutineOperation_exports as t };
+
+//# sourceMappingURL=RoutineOperation.mjs.map

package/dist/lib/RoutineOperation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoutineOperation.mjs","names":[],"sources":["../../src/types/RoutineOperation.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as Plugin from '@dxos/app-framework/Plugin';\nimport * as Chat from '@dxos/assistant-toolkit/Chat';\nimport * as Instructions from '@dxos/compute/Instructions';\nimport * as Operation from '@dxos/compute/Operation';\nimport * as Routine from '@dxos/compute/Routine';\nimport * as Trigger from '@dxos/compute/Trigger';\nimport { Database, DXN, Obj, Ref, Type } from '@dxos/echo';\n// Value-side `EID` import keeps TS declaration emit portable — `TriggerTemplate`\n// references `EID.Schema` and the inferred `CreateTriggerFromTemplate` type\n// otherwise needs a transitive `@dxos/keys` import that's hard for d.ts emit to surface.\nimport { EID as _EchoURIReference } from '@dxos/keys';\n\nimport { TriggerTemplate } from './Routine';\nexport { _EchoURIReference };\n\nexport const CreateTriggerFromTemplate = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.routine.createTriggerFromTemplate'),\n    name: 'Create Trigger From Template',\n    icon: 'ph--lightning--regular',\n  },\n  services: [Capability.Service],\n  input: Schema.Struct({\n    db: Database.Database,\n    template: TriggerTemplate,\n    enabled: Schema.optional(Schema.Boolean),\n    scriptName: Schema.optional(Schema.String),\n    input: Schema.optional(Schema.Record(Schema.String, Schema.Any)),\n  }),\n  output: Schema.Void,\n});\n\n// The single creation entrypoint for every path (create dialog, companion, sidebar) so placement and\n// ownership are established in one place. Output mirrors `SpaceCapabilities.CreateObjectResult`.\nexport const CreateRoutine = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.routine.createAutomation'),\n    name: 'Create Routine',\n    icon: 'ph--lightning--regular',\n  },\n  services: [Capability.Service, Plugin.Service],\n  input: Schema.Struct({\n    db: Database.Database,\n    templateId: Schema.String,\n    name: Schema.optional(Schema.String),\n    subject: Schema.optional(Obj.Unknown),\n    /** Values for the template's `inputSchema`. */\n    input: Schema.optional(Schema.Unknown),\n  }),\n  output: Schema.Struct({\n    id: Schema.String,\n    object: Obj.Unknown,\n  }),\n});\n\nexport const RunPromptInNewChat = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.routine.runPromptInNewChat'),\n    name: 'Run Prompt In New Chat',\n    icon: 'ph--chat-text--regular',\n  },\n  services: [Capability.Service],\n  input: Schema.Struct({\n    db: Database.Database,\n    /** Context objects to bind to the new chat. */\n    objects: Schema.optional(Schema.Array(Obj.Unknown)),\n    /** Skill keys to look up and bind to the new chat. */\n    skills: Schema.optional(Schema.Array(Schema.String)),\n    /** Raw instructions or an existing Routine object reference. */\n    instructions: Schema.Union([Schema.String, Ref.Ref(Instructions.Instructions)]),\n    /**\n     * When true, skips opening the chat: runs the Agent prompt operation against the new chat via the compute runtime (traced).\n     */\n    background: Schema.optional(Schema.Boolean),\n  }),\n  output: Schema.Struct({\n    object: Type.getSchema(Chat.Chat),\n  }),\n});\n\n// Runs a routine's action now, routed by its first trigger — that is where both the runnable's input\n// (e.g. a sync routine's binding cursor) and the `remote` flag live. A `remote` trigger force-runs on the\n// EDGE dispatcher over HTTP, since that is the only runtime it is registered on; a local one runs\n// in-process. Without the trigger a manual run would invoke an input-taking runnable with nothing, and\n// would silently run an edge routine on the client.\nexport const RunRoutine = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.routine.runAutomation'),\n    name: 'Run Routine',\n    icon: 'ph--play--regular',\n  },\n  services: [Capability.Service, Trigger.TriggerMonitorService],\n  input: Schema.Struct({\n    routine: Ref.Ref(Routine.Routine),\n  }),\n  output: Schema.Void,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAwBA,IAAa,4BAA4B,UAAU,KAAK;CACtD,MAAM;EACJ,KAAK,IAAI,KAAK,sDAAsD;EACpE,MAAM;EACN,MAAM;CACR;CACA,UAAU,CAAC,WAAW,OAAO;CAC7B,OAAO,OAAO,OAAO;EACnB,IAAI,SAAS;EACb,UAAU;EACV,SAAS,OAAO,SAAS,OAAO,OAAO;EACvC,YAAY,OAAO,SAAS,OAAO,MAAM;EACzC,OAAO,OAAO,SAAS,OAAO,OAAO,OAAO,QAAQ,OAAO,GAAG,CAAC;CACjE,CAAC;CACD,QAAQ,OAAO;AACjB,CAAC;AAID,IAAa,gBAAgB,UAAU,KAAK;CAC1C,MAAM;EACJ,KAAK,IAAI,KAAK,6CAA6C;EAC3D,MAAM;EACN,MAAM;CACR;CACA,UAAU,CAAC,WAAW,SAAS,OAAO,OAAO;CAC7C,OAAO,OAAO,OAAO;EACnB,IAAI,SAAS;EACb,YAAY,OAAO;EACnB,MAAM,OAAO,SAAS,OAAO,MAAM;EACnC,SAAS,OAAO,SAAS,IAAI,OAAO;;EAEpC,OAAO,OAAO,SAAS,OAAO,OAAO;CACvC,CAAC;CACD,QAAQ,OAAO,OAAO;EACpB,IAAI,OAAO;EACX,QAAQ,IAAI;CACd,CAAC;AACH,CAAC;AAED,IAAa,qBAAqB,UAAU,KAAK;CAC/C,MAAM;EACJ,KAAK,IAAI,KAAK,+CAA+C;EAC7D,MAAM;EACN,MAAM;CACR;CACA,UAAU,CAAC,WAAW,OAAO;CAC7B,OAAO,OAAO,OAAO;EACnB,IAAI,SAAS;;EAEb,SAAS,OAAO,SAAS,OAAO,MAAM,IAAI,OAAO,CAAC;;EAElD,QAAQ,OAAO,SAAS,OAAO,MAAM,OAAO,MAAM,CAAC;;EAEnD,cAAc,OAAO,MAAM,CAAC,OAAO,QAAQ,IAAI,IAAI,aAAa,YAAY,CAAC,CAAC;;;;EAI9E,YAAY,OAAO,SAAS,OAAO,OAAO;CAC5C,CAAC;CACD,QAAQ,OAAO,OAAO,EACpB,QAAQ,KAAK,UAAU,KAAK,IAAI,EAClC,CAAC;AACH,CAAC;AAOD,IAAa,aAAa,UAAU,KAAK;CACvC,MAAM;EACJ,KAAK,IAAI,KAAK,0CAA0C;EACxD,MAAM;EACN,MAAM;CACR;CACA,UAAU,CAAC,WAAW,SAAS,QAAQ,qBAAqB;CAC5D,OAAO,OAAO,OAAO,EACnB,SAAS,IAAI,IAAI,QAAQ,OAAO,EAClC,CAAC;CACD,QAAQ,OAAO;AACjB,CAAC"}

package/dist/lib/RoutinePlugin.mjs

@@ -1,2 +1,16 @@
-import { t as RoutinePlugin } from "./chunk-RoutinePlugin.mjs";
-export { RoutinePlugin, RoutinePlugin as default };
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { meta as meta$1 } from "#meta";
+import * as Plugin from "@dxos/app-framework/Plugin";
+//#region src/RoutinePlugin.ts
+var RoutinePlugin_exports = /* @__PURE__ */ __exportAll({
+	make: () => make,
+	meta: () => meta
+});
+/** Plugin metadata, available without loading the plugin body. */
+var meta = meta$1;
+/** Constructs the plugin; the body loads on first enable. */
+var make = Plugin.lazy(meta, () => import("#plugin"));
+//#endregion
+export { make, meta, RoutinePlugin_exports as t };
+
+//# sourceMappingURL=RoutinePlugin.mjs.map

package/dist/lib/RoutinePlugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoutinePlugin.mjs","names":[],"sources":["../../src/RoutinePlugin.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Plugin from '@dxos/app-framework/Plugin';\n\nimport { meta as pluginMeta } from '#meta';\n\n/** Plugin metadata, available without loading the plugin body. */\nexport const meta = pluginMeta;\n\n/** Constructs the plugin; the body loads on first enable. */\nexport const make = Plugin.lazy(meta, () => import('#plugin'));\n"],"mappings":";;;;;;;;;AAWA,IAAa,OAAO;;AAGpB,IAAa,OAAO,OAAO,KAAK,YAAY,OAAO,UAAU"}

package/dist/lib/capabilities.mjs

@@ -1,14 +1,55 @@
-import { Capability } from "@dxos/app-framework";
+import * as Capabilities from "@dxos/app-framework/Capabilities";
+import * as Capability from "@dxos/app-framework/Capability";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
+import { translations } from "#translations";
+import { RoutineCapabilities } from "#types";
+import * as AppCapabilities from "@dxos/app-toolkit/AppCapabilities";
+import * as ClientCapabilities from "@dxos/plugin-client/ClientCapabilities";
+import * as ClientEvents from "@dxos/plugin-client/ClientEvents";
+import * as SpaceCapability from "@dxos/plugin-space/SpaceCapability";
+import { meta } from "#meta";
+//#region PLUGIN.mdl?raw
+var PLUGIN_default = "---\nid: org.dxos.plugin.automation\nname: AutomationPlugin\nversion: 0.1.0\n---\n\nA workflow automation engine plugin for DXOS Composer that enables event-driven\npipelines connecting ECHO objects to persistent compute functions.\n\nTriggers listen for ECHO mutations, timer schedules, incoming feeds (email, webhook),\nor data subscriptions and invoke `PersistentOperation` handlers when their conditions\nfire. Each trigger carries optional structured input and is dispatched by a\nper-space `TriggerDispatcher` that runs locally in the browser, or is delegated to\nthe DXOS edge when the trigger's `remote` flag is set. A space-wide\n`triggersDisabled` flag acts as a kill-switch that stops local dispatch entirely.\n\nThe plugin integrates with the `@dxos/compute` operation registry and the\n`@dxos/functions-runtime` execution layer. Skill, operation-handler, and\ntoolkit contributions from other plugins are gathered at application scope and\nmerged before being offered to space-level operation registries, so any plugin\nthat contributes a `Capabilities.OperationHandler` automatically becomes\ninvocable from an automation trigger.\n\nUsers interact with automations through the `AutomationPanel` settings surface,\nwhich lists active triggers for a space (or for a specific ECHO object) and\nopens the `TriggerEditor` form to create, configure, and enable/disable\nindividual triggers.\n\n## Extensions\n\nThe following extension dialects are used in this document.\nEach extension is defined in the Appendix or resolved via its URI.\n\n| Term        | URI                           |\n|-------------|-------------------------------|\n| `type`      | `org.dxos.mdl.type@1.0`      |\n| `feat`      | `org.dxos.mdl.feat@1.0`      |\n| `test`      | `org.dxos.mdl.test@1.0`      |\n| `component` | `org.dxos.mdl.component@1.0` |\n| `op`        | `org.dxos.mdl.op@1.0`        |\n\n## Types\n\nExisting types used by this plugin (defined in `@dxos/compute` and `@dxos/functions-runtime`):\n\n| Type                 | Source                    | Role in AutomationPlugin                                           |\n|----------------------|---------------------------|--------------------------------------------------------------------|\n| `Trigger`            | `@dxos/compute`           | Persistent trigger configuration (spec, function ref, input, enabled) |\n| `PersistentOperation`| `@dxos/compute`           | Registered compute function callable from a trigger               |\n| `Trace.Message`      | `@dxos/compute`           | Execution trace record appended after each trigger run            |\n| `Script`             | `@dxos/compute`           | Source script that produces one or more `PersistentOperation`s    |\n| `Feed`               | `@dxos/echo`              | Feed object that a `feed`-spec trigger listens to                 |\n| `ComputeGraph`       | `@dxos/conductor`         | Visual workflow graph selectable as a trigger function            |\n\nNew types defined by this plugin:\n\n```mdl\ntype TriggerTemplate\n  desc: |\n    Lightweight description of a trigger's spec used when creating a trigger\n    from a pre-defined template (e.g. from a Skill action).\n  literals: timer | feed\n  fields:\n    type: timer | feed\n    cron?: string          # required when type === timer; cron expression\n    feed?: Feed            # required when type === feed; the feed to subscribe to\n```\n\n## Components\n\n```mdl\ncomponent AutomationPanel\n  desc: |\n    Settings surface that lists all triggers for a space (or filtered to a\n    specific ECHO object) and provides inline create / edit / delete via the\n    TriggerEditor form. Displayed inside Settings.Panel at the path\n    `<spacePath>/settings/org.dxos.plugin.automation.automations`.\n  props:\n    space: Space\n    object?: Obj.Unknown   # when set, only triggers matching this object are shown\n    initialTrigger?: Trigger  # pre-populate TriggerEditor for a new trigger\n    onDone?: () => void\n  state:\n    trigger?: Trigger      # trigger currently open in TriggerEditor (undefined = list view)\n    selected?: Trigger     # the existing trigger being edited (undefined = new)\n  slots:\n    (none)\n  actions:\n    handleAdd()            # open TriggerEditor with a blank Trigger\n    handleSelect(t: Trigger)   # open TriggerEditor for an existing trigger\n    handleDelete(t: Trigger)   # remove trigger from space.db\n    handleSave(t: Trigger)     # persist new or update selected trigger\n    handleCancel()\n    handleForceRunTrigger(t: Trigger)   # invoke timer trigger immediately\n    handleResetCursor(t: Trigger)       # clear feed cursor on a feed trigger\n  layout: |\n    ┌──────────────────────────────────┐\n    │ [list view — triggers exist]     │\n    │  ┌────────────────────────────┐  │\n    │  │ ○  fn-name     [▶] [✕]    │  │\n    │  │ ●  fn-name     [↺] [✕]    │  │\n    │  └────────────────────────────┘  │\n    │  ─────────────────────────────   │\n    │  [+ New Trigger]                 │\n    ├──────────────────────────────────┤\n    │ [editor view — trigger selected] │\n    │  Settings.Item                   │\n    │  └── TriggerEditor               │\n    └──────────────────────────────────┘\n```\n\n```mdl\ncomponent TriggerEditor\n  desc: |\n    Form-driven editor for a single Trigger. Renders a Form.Root backed by the\n    Trigger schema with custom field overrides for function/workflow selection,\n    spec kind selector, feed selector, subscription query builder, and\n    structured input editor.\n  props:\n    db: Database\n    trigger: Trigger\n    types: TypeOption[]      # available ECHO types for query builder\n    tags: Tag[]              # available tags for query builder\n    readonlySpec?: boolean   # lock spec.kind and spec.query (e.g. editing from an object context)\n    onSave: (t: Partial<Trigger>) => void\n    onCancel: () => void\n  state:\n    (managed by Form.Root)\n  slots:\n    (none)\n```\n\n```mdl\ncomponent FunctionsPanel\n  desc: |\n    Settings surface listing all PersistentOperation objects in a space.\n    Each row shows the function name, optional source script name, a\n    \"go to script\" icon button, and a delete button.\n  props:\n    space: Space\n  state:\n    functions: PersistentOperation[]\n    scripts: Script[]\n  slots:\n    (none)\n  actions:\n    handleGoToScript(fn: PersistentOperation)  # navigate to source Script\n    handleDelete(fn: PersistentOperation)      # remove function via SpaceOperation\n```\n\n```mdl\ncomponent TemplateEditor\n  desc: |\n    Markdown + Handlebars source editor backed by a Ref<Text>. Decorates\n    Handlebars tags, DXN/URL tokens, and XML nodes. Reused by Routine and\n    Skill article surfaces and by downstream plugins (plugin-script,\n    plugin-magazine) via the `@dxos/plugin-routine/components` export.\n  props:\n    id: string\n    source?: Ref<Text>\n    lineNumbers?: boolean\n```\n\n```mdl\ncomponent RoutineProperties\n  desc: Object-properties form for a Routine, rendered via ObjectProperties.\n  props:\n    routine: Routine\n```\n\n## Surfaces\n\n```mdl\nsurface skill     -> SkillArticle    # article for Skill objects\nsurface prompt        -> RoutineArticle      # article for Routine objects (template editor + run)\nsurface prompts       -> RoutineList         # space-home prompt list; dispatches RunPromptInNewChat\n```\n\n## Operations\n\n```mdl\nop CreateTriggerFromTemplate\n  desc: |\n    Creates a new Trigger from a lightweight template, optionally wiring it to\n    a named Script's PersistentOperation, and navigates to the automations\n    settings panel for the target space.\n  input:\n    db: Database\n    template: TriggerTemplate\n    enabled?: boolean        # default false\n    scriptName?: string      # if provided, looks up Script by name and wires function ref\n    input?: Record<string, any>   # optional structured input forwarded to the trigger\n  output: void\n  effects: [echo:write, layout:navigate]\n  requires: [SpaceOperation.AddObject, LayoutOperation.Open]\n  note: |\n    Resolves the named Script, finds its linked PersistentOperation, and sets\n    trigger.function = Ref.make(fn). Template type determines spec:\n      timer → Trigger.specTimer(cron)\n      feed  → Trigger.specFeed(feed)\n    Trigger is added as a hidden object so it does not appear in the main graph.\n```\n\n```mdl\nop RunPromptInNewChat\n  desc: Creates a new chat, binds context objects and skills, then runs a prompt.\n  input:\n    db: Database\n    objects?: Obj[]\n    skills?: string[]\n    prompt: string | RoutineRef\n    background?: boolean\n  output: Chat\n  effects: [echo:write, ai:infer]\n  note: |\n    Defined here so Routine UI (RoutineList, RoutineArticle) and downstream\n    plugins can dispatch it without depending on plugin-assistant. The handler\n    is contributed by plugin-assistant (chat creation + AiContext binding).\n    When background is true, the prompt runs via the compute runtime without\n    opening the chat UI. The returned Chat can be used to track progress.\n```\n\n## Features\n\n```mdl\nfeat F-1: Trigger Management\n\n  req F-1.1: User can create a Trigger in any space via AutomationPanel.\n  req F-1.2: User can edit an existing Trigger's function, spec, and input.\n  req F-1.3: User can delete a Trigger; it is removed from space.db.\n  req F-1.4: User can enable or disable a Trigger via an inline toggle.\n  req F-1.5:\n    when: object context provided to AutomationPanel\n    then: only triggers matching that object's type or query are shown\n```\n\n```mdl\nfeat F-2: Trigger Dispatch\n\n  req F-2.1:\n    when: space.properties.triggersDisabled is unset or false\n    then: TriggerDispatcher starts for that space\n\n  req F-2.2:\n    when: space.properties.triggersDisabled === true\n    then: TriggerDispatcher stops for that space\n\n  req F-2.3:\n    when: triggersDisabled changes\n    then: any in-flight dispatcher transition is cancelled before the new one starts\n\n  req F-2.3a:\n    when: trigger.remote === true\n    then: the local TriggerDispatcher skips the trigger (it runs on the edge instead)\n\n  req F-2.4:\n    when: trigger spec.kind === \"timer\" and enabled === true\n    then: TriggerDispatcher fires trigger according to cron expression\n\n  req F-2.5:\n    when: trigger spec.kind === \"feed\"\n    then: TriggerDispatcher processes new messages from the linked Feed\n\n  req F-2.6:\n    when: trigger spec.kind === \"subscription\"\n    then: TriggerDispatcher invokes trigger on matching ECHO object mutations\n```\n\n```mdl\nfeat F-3: Force Run and Cursor Reset\n\n  req F-3.1:\n    when: timer trigger is enabled and space.properties.triggersDisabled !== true\n    then: user can force-run the trigger immediately from AutomationPanel\n\n  req F-3.2:\n    when: trigger.remote !== true\n    then: force-run invokes TriggerDispatcher.invokeTrigger directly in-process\n\n  req F-3.3:\n    when: trigger.remote === true\n    then: force-run calls FunctionsServiceClient.forceRunCronTrigger via HTTP\n\n  req F-3.4:\n    when: trigger spec.kind === \"feed\" and a cursor is stored\n    then: user can reset the cursor to reprocess the feed from the beginning\n```\n\n```mdl\nfeat F-4: Operation Registry\n\n  req F-4.1:\n    when: plugin activates\n    then: all Capabilities.OperationHandler contributions are merged into a single OperationHandlerProvider\n\n  req F-4.2: OperationRegistry per space resolves operations from the merged OperationHandlerProvider.\n  req F-4.3: Skill registry is populated from AppCapabilities.SkillDefinition contributions.\n  req F-4.4: OpaqueToolkit aggregates AppCapabilities.Toolkit contributions for agent invocation.\n```\n\n```mdl\nfeat F-5: Trace Sink\n\n  req F-5.1:\n    when: a trigger executes\n    then: execution trace messages are written to the space Feed via FeedTraceSink\n\n  req F-5.2: FeedTraceSink is contributed to Capabilities.TraceSink and routed via makeRoutingSink.\n```\n\n```mdl\nfeat F-6: Create Trigger From Template\n\n  req F-6.1:\n    when: op:CreateTriggerFromTemplate is invoked\n    then: a Trigger is created and added as a hidden ECHO object in the target space\n\n  req F-6.2:\n    when: scriptName is provided\n    then: the Trigger.function is wired to the PersistentOperation linked to that Script\n\n  req F-6.3:\n    when: template.type === \"timer\"\n    then: Trigger.spec is set via Trigger.specTimer(template.cron)\n\n  req F-6.4:\n    when: template.type === \"feed\"\n    then: Trigger.spec is set via Trigger.specFeed(template.feed)\n\n  req F-6.5:\n    when: trigger is created\n    then: layout navigates to the automations settings panel for the space\n```\n\n## Acceptance\n\n```mdl\ntest T-1: Create trigger via AutomationPanel\n  given: AutomationPanel rendered for a space with no triggers\n  when: user clicks \"New Trigger\"\n  then:\n    - TriggerEditor shown with a blank Trigger\n    - selected state is undefined (new trigger mode)\n```\n\n```mdl\ntest T-2: Save new trigger\n  given: TriggerEditor open with blank Trigger\n  when: user fills in a function and spec, then saves\n  then:\n    - space.db.add called with a new Trigger\n    - list view restored\n    - onDone called\n```\n\n```mdl\ntest T-3: Edit existing trigger\n  given: AutomationPanel listing one trigger\n  when: user clicks the trigger row\n  then:\n    - TriggerEditor opens pre-populated with that trigger's values\n    - selected state holds the original trigger\n    - saving calls Obj.update on the original trigger\n```\n\n```mdl\ntest T-4: Enable/disable toggle\n  given: AutomationPanel showing trigger with enabled = false\n  when: user flips the toggle\n  then:\n    - Obj.update sets trigger.enabled = true\n    - toggle reflects new state immediately\n```\n\n```mdl\ntest T-5: Force run timer trigger (local)\n  given: timer trigger enabled, trigger.remote unset\n  when: user clicks the force-run button\n  then:\n    - TriggerDispatcher.invokeTrigger called with a TimerEvent\n    - no error surfaced to user\n```\n\n```mdl\ntest T-6: Dispatcher lifecycle on kill-switch change\n  given: space triggersDisabled unset, dispatcher running\n  when: space.properties.triggersDisabled changes to true\n  then:\n    - in-flight transition fiber interrupted\n    - TriggerDispatcher.stop() called for that space\n```\n\n```mdl\ntest T-7: CreateTriggerFromTemplate with timer\n  given: db contains Script \"daily-summary\", space triggersDisabled unset\n  when: op:CreateTriggerFromTemplate invoked with template={type:\"timer\",cron:\"0 8 * * *\"}, scriptName=\"daily-summary\"\n  then:\n    - Trigger created with spec.kind === \"timer\", spec.cron === \"0 8 * * *\"\n    - Trigger.function wired to PersistentOperation linked to \"daily-summary\" script\n    - Trigger added as hidden ECHO object\n    - layout navigates to automations settings panel\n```\n\n```mdl\ntest T-8: CreateTriggerFromTemplate with feed\n  given: db contains a Feed object \"email-feed\"\n  when: op:CreateTriggerFromTemplate invoked with template={type:\"feed\",feed:<email-feed>}\n  then:\n    - Trigger created with spec.kind === \"feed\", spec.feed === Ref to email-feed\n    - Trigger added as hidden ECHO object\n```\n\n---\n\n## Appendix: Extension Definitions\n\nExtension block types used in this document are defined below using\nthe core `ext` primitive — the only construct the base language provides.\n\n```mdl\next type\n  uri: org.dxos.mdl.type@1.0\n  desc: A named data structure with typed fields and optional literals.\n  fields:\n    desc?: Prose\n    fields?: FieldMap        # name[?]: TypeExpr  (# inline comment)\n    literals?: UnionList     # a | b | c\n    extends?: TypeRef[]\n```\n\n```mdl\next feat\n  uri: org.dxos.mdl.feat@1.0\n  desc: A named feature grouping one or more requirements.\n  fields:\n    desc?: Prose\n    req: RequirementList\n  nesting: self              # feat blocks may contain feat blocks\n```\n\n```mdl\next test\n  uri: org.dxos.mdl.test@1.0\n  desc: An acceptance scenario expressed as given / when / then steps.\n  fields:\n    given?: Step | Step[]\n    when?: Step | Step[]\n    then: Step | Step[]\n    tags?: TagList\n```\n\n```mdl\next component\n  uri: org.dxos.mdl.component@1.0\n  desc: A UI component with props, internal state, slots, actions, and events.\n  fields:\n    desc?: Prose\n    props?: FieldMap            # external inputs (immutable inside component)\n    state?: FieldMap            # internal reactive state\n    slots?: FieldMap            # named ReactNode injection points\n    actions?: ActionMap         # methods the component exposes or handles\n    emits?: EventMap            # events the component raises to its parent\n    layout?: CodeBlock          # ASCII sketch of visual structure (non-normative)\n```\n\n```mdl\next op\n  uri: org.dxos.mdl.op@1.0\n  desc: |\n    A named operation with typed inputs, outputs, and declared errors.\n    Pure ops have no effects or requires. Effectful ops declare both.\n  fields:\n    desc?: Prose\n    input?: FieldMap            # named input parameters\n    output?: TypeExpr           # return type\n    errors?: ErrorMap           # name: Prose  (when this error occurs)\n    effects?: EffectList        # echo:read | echo:write | http | fs | ...\n    requires?: ServiceList      # injected service dependencies\n    note?: Prose                # implementation guidance (non-normative)\n```\n";
+//#endregion
 //#region src/capabilities/index.ts
-var AppGraphBuilder = Capability.lazy("AppGraphBuilder", () => import("./chunk-app-graph-builder.mjs"));
-var CreateObject = Capability.lazy("CreateObject", () => import("./chunk-create-object.mjs"));
-var LayerSpecs = Capability.lazy("LayerSpecs", () => import("./chunk-layer-specs.mjs"));
-var OperationHandler = Capability.lazy("OperationHandler", () => import("./chunk-operation-handler.mjs"));
-var ReactSurface = Capability.lazy("ReactSurface", () => import("./chunk-react-surface.mjs"));
-var RegistrySync = Capability.lazy("RegistrySync", () => import("./chunk-registry-sync.mjs"));
-var Templates = Capability.lazy("Templates", () => import("./chunk-templates.mjs"));
-var TriggerRuntimeController = Capability.lazy("TriggerRuntimeController", () => import("./chunk-trigger-runtime-controller.mjs"));
+var AppGraphBuilder = AppCapability.appGraphBuilder(() => import("./chunk-app-graph-builder.mjs"), { environments: ["node"] });
+var Commands = AppCapability.commands(() => import("./chunk-commands.mjs"));
+var CreateObject = SpaceCapability.createObject(() => import("./chunk-create-object.mjs"), { environments: [] });
+var LayerSpecs = AppCapability.layerSpec(() => import("./chunk-layer-specs.mjs"), {
+	name: "LayerSpecs",
+	provides: [Capabilities.TraceSink]
+});
+var OperationHandler = AppCapability.operationHandler(() => import("./chunk-operation-handler.mjs"));
+var PluginAsset = AppCapability.pluginAsset({
+	pluginId: meta.profile.key,
+	path: "PLUGIN.mdl",
+	content: PLUGIN_default,
+	mimeType: "application/x-mdl"
+});
+var ReactSurface = AppCapability.surface(() => import("./chunk-react-surface.mjs"), { roles: ["org.dxos.role.article", "org.dxos.role.cardContent"] });
+var RegistrySync = Capability.lazyModule("RegistrySync", {
+	requires: [
+		ClientCapabilities.Client,
+		Capabilities.AtomRegistry,
+		AppCapabilities.SkillDefinition,
+		Capabilities.OperationHandler
+	],
+	provides: [],
+	environments: ["node"]
+}, () => import("./chunk-registry-sync.mjs"));
+var Schema = AppCapability.schema(() => import("./chunk-schema.mjs"));
+var Templates = Capability.lazyModule("Templates", {
+	provides: [RoutineCapabilities.Template],
+	environments: ["node", "workerd"]
+}, () => import("./chunk-templates.mjs"));
+var Translations = AppCapability.translations(translations);
+var TriggerRuntimeController = Capability.lazyModule("TriggerRuntimeController", {
+	requires: [ClientCapabilities.Client, Capabilities.ProcessManagerRuntime],
+	provides: [],
+	activatesOn: ClientEvents.SpacesReady,
+	environments: ["node"]
+}, () => import("./chunk-trigger-runtime-controller.mjs"));
 //#endregion
-export { AppGraphBuilder, CreateObject, LayerSpecs, OperationHandler, ReactSurface, RegistrySync, Templates, TriggerRuntimeController };
+export { AppGraphBuilder, Commands, CreateObject, LayerSpecs, OperationHandler, PluginAsset, ReactSurface, RegistrySync, Schema, Templates, Translations, TriggerRuntimeController };
 
 //# sourceMappingURL=capabilities.mjs.map

package/dist/lib/capabilities.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.mjs","names":[],"sources":["../../src/capabilities/index.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Capability } from '@dxos/app-framework';\nimport { OperationHandlerSet } from '@dxos/compute';\n\nexport const AppGraphBuilder = Capability.lazy('AppGraphBuilder', () => import('./app-graph-builder'));\nexport const CreateObject = Capability.lazy('CreateObject', () => import('./create-object'));\nexport const LayerSpecs = Capability.lazy<void, Capability.Any[]>('LayerSpecs', () => import('./layer-specs'));\nexport const OperationHandler = Capability.lazy<OperationHandlerSet.OperationHandlerSet>(\n  'OperationHandler',\n  () => import('./operation-handler'),\n);\nexport const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));\nexport const RegistrySync = Capability.lazy('RegistrySync', () => import('./registry-sync'));\nexport const Templates = Capability.lazy('Templates', () => import('./templates'));\nexport const TriggerRuntimeController = Capability.lazy(\n  'TriggerRuntimeController',\n  () => import('./trigger-runtime-controller'),\n);\n"],"mappings":";;AAOA,IAAa,kBAAkB,WAAW,KAAK,yBAAyB,OAAO,gCAAsB;AACrG,IAAa,eAAe,WAAW,KAAK,sBAAsB,OAAO,4BAAkB;AAC3F,IAAa,aAAa,WAAW,KAA6B,oBAAoB,OAAO,0BAAgB;AAC7G,IAAa,mBAAmB,WAAW,KACzC,0BACM,OAAO,gCACf;AACA,IAAa,eAAe,WAAW,KAAK,sBAAsB,OAAO,4BAAkB;AAC3F,IAAa,eAAe,WAAW,KAAK,sBAAsB,OAAO,4BAAkB;AAC3F,IAAa,YAAY,WAAW,KAAK,mBAAmB,OAAO,wBAAc;AACjF,IAAa,2BAA2B,WAAW,KACjD,kCACM,OAAO,yCACf"}
+{"version":3,"file":"capabilities.mjs","names":[],"sources":["../../src/capabilities/index.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as ClientCapabilities from '@dxos/plugin-client/ClientCapabilities';\nimport * as ClientEvents from '@dxos/plugin-client/ClientEvents';\nimport * as SpaceCapability from '@dxos/plugin-space/SpaceCapability';\n\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { RoutineCapabilities } from '#types';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../../PLUGIN.mdl?raw';\n\nexport const AppGraphBuilder = AppCapability.appGraphBuilder(() => import('./app-graph-builder'), {\n  environments: ['node'],\n});\nexport const Commands = AppCapability.commands(() => import('./commands'));\n// The entry carries a live `customPanel` (`CreateRoutinePanel`) alongside the object factory, so the\n// module cannot be evaluated without React.\nexport const CreateObject = SpaceCapability.createObject(() => import('./create-object'), {\n  environments: [],\n});\nexport const LayerSpecs = AppCapability.layerSpec(() => import('./layer-specs'), {\n  name: 'LayerSpecs',\n  provides: [Capabilities.TraceSink],\n});\nexport const OperationHandler = AppCapability.operationHandler(() => import('./operation-handler'));\nexport const PluginAsset = AppCapability.pluginAsset({\n  pluginId: meta.profile.key,\n  path: 'PLUGIN.mdl',\n  content: pluginSpec,\n  mimeType: 'application/x-mdl',\n});\nexport const ReactSurface = AppCapability.surface(() => import('./react-surface'), {\n  roles: ['org.dxos.role.article', 'org.dxos.role.cardContent'],\n});\nexport const RegistrySync = Capability.lazyModule(\n  'RegistrySync',\n  {\n    requires: [\n      ClientCapabilities.Client,\n      Capabilities.AtomRegistry,\n      AppCapabilities.SkillDefinition,\n      Capabilities.OperationHandler,\n    ],\n    provides: [],\n    environments: ['node'],\n  },\n  () => import('./registry-sync'),\n);\nexport const Schema = AppCapability.schema(() => import('./schema'));\nexport const Templates = Capability.lazyModule(\n  'Templates',\n  { provides: [RoutineCapabilities.Template], environments: ['node', 'workerd'] },\n  () => import('./templates'),\n);\nexport const Translations = AppCapability.translations(translations);\nexport const TriggerRuntimeController = Capability.lazyModule(\n  'TriggerRuntimeController',\n  {\n    requires: [ClientCapabilities.Client, Capabilities.ProcessManagerRuntime],\n    provides: [],\n    // Runtime event: triggers only need to react to spaces once the client observes them.\n    activatesOn: ClientEvents.SpacesReady,\n    environments: ['node'],\n  },\n  () => import('./trigger-runtime-controller'),\n);\n"],"mappings":";;;;;;;;;;;;;;AAmBA,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,kCAAwB,EAChG,cAAc,CAAC,MAAM,EACvB,CAAC;AACD,IAAa,WAAW,cAAc,eAAe,OAAO,uBAAa;AAGzE,IAAa,eAAe,gBAAgB,mBAAmB,OAAO,8BAAoB,EACxF,cAAc,CAAC,EACjB,CAAC;AACD,IAAa,aAAa,cAAc,gBAAgB,OAAO,4BAAkB;CAC/E,MAAM;CACN,UAAU,CAAC,aAAa,SAAS;AACnC,CAAC;AACD,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,gCAAsB;AAClG,IAAa,cAAc,cAAc,YAAY;CACnD,UAAU,KAAK,QAAQ;CACvB,MAAM;CACN,SAAS;CACT,UAAU;AACZ,CAAC;AACD,IAAa,eAAe,cAAc,cAAc,OAAO,8BAAoB,EACjF,OAAO,CAAC,yBAAyB,2BAA2B,EAC9D,CAAC;AACD,IAAa,eAAe,WAAW,WACrC,gBACA;CACE,UAAU;EACR,mBAAmB;EACnB,aAAa;EACb,gBAAgB;EAChB,aAAa;CACf;CACA,UAAU,CAAC;CACX,cAAc,CAAC,MAAM;AACvB,SACM,OAAO,4BACf;AACA,IAAa,SAAS,cAAc,aAAa,OAAO,qBAAW;AACnE,IAAa,YAAY,WAAW,WAClC,aACA;CAAE,UAAU,CAAC,oBAAoB,QAAQ;CAAG,cAAc,CAAC,QAAQ,SAAS;AAAE,SACxE,OAAO,wBACf;AACA,IAAa,eAAe,cAAc,aAAa,YAAY;AACnE,IAAa,2BAA2B,WAAW,WACjD,4BACA;CACE,UAAU,CAAC,mBAAmB,QAAQ,aAAa,qBAAqB;CACxE,UAAU,CAAC;CAEX,aAAa,aAAa;CAC1B,cAAc,CAAC,MAAM;AACvB,SACM,OAAO,yCACf"}

package/dist/lib/capabilities.node.mjs

@@ -0,0 +1,45 @@
+import * as Capabilities from "@dxos/app-framework/Capabilities";
+import * as Capability from "@dxos/app-framework/Capability";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
+import { translations } from "#translations";
+import { RoutineCapabilities } from "#types";
+import * as AppCapabilities from "@dxos/app-toolkit/AppCapabilities";
+import * as ClientCapabilities from "@dxos/plugin-client/ClientCapabilities";
+import * as ClientEvents from "@dxos/plugin-client/ClientEvents";
+//#region src/capabilities/gen/node.ts
+var AppGraphBuilder = AppCapability.appGraphBuilder(() => import("./chunk-app-graph-builder.mjs"), { environments: ["node"] });
+var Commands = AppCapability.commands(() => import("./chunk-commands.mjs"));
+var LayerSpecs = AppCapability.layerSpec(() => import("./chunk-layer-specs.mjs"), {
+	name: "LayerSpecs",
+	provides: [Capabilities.TraceSink]
+});
+var OperationHandler = AppCapability.operationHandler(() => import("./chunk-operation-handler.mjs"));
+var RegistrySync = Capability.lazyModule("RegistrySync", {
+	requires: [
+		ClientCapabilities.Client,
+		Capabilities.AtomRegistry,
+		AppCapabilities.SkillDefinition,
+		Capabilities.OperationHandler
+	],
+	provides: [],
+	environments: ["node"]
+}, () => import("./chunk-registry-sync.mjs"));
+var Schema = AppCapability.schema(() => import("./chunk-schema.mjs"));
+var Templates = Capability.lazyModule("Templates", {
+	provides: [RoutineCapabilities.Template],
+	environments: ["node", "workerd"]
+}, () => import("./chunk-templates.mjs"));
+var Translations = AppCapability.translations(translations);
+var TriggerRuntimeController = Capability.lazyModule("TriggerRuntimeController", {
+	requires: [ClientCapabilities.Client, Capabilities.ProcessManagerRuntime],
+	provides: [],
+	activatesOn: ClientEvents.SpacesReady,
+	environments: ["node"]
+}, () => import("./chunk-trigger-runtime-controller.mjs"));
+var CreateObject = void 0;
+var PluginAsset = void 0;
+var ReactSurface = void 0;
+//#endregion
+export { AppGraphBuilder, Commands, CreateObject, LayerSpecs, OperationHandler, PluginAsset, ReactSurface, RegistrySync, Schema, Templates, Translations, TriggerRuntimeController };
+
+//# sourceMappingURL=capabilities.node.mjs.map

package/dist/lib/capabilities.node.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.node.mjs","names":[],"sources":["../../src/capabilities/gen/node.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'node' condition.\n\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as ClientCapabilities from '@dxos/plugin-client/ClientCapabilities';\nimport * as ClientEvents from '@dxos/plugin-client/ClientEvents';\n\nimport { translations } from '#translations';\nimport { RoutineCapabilities } from '#types';\n\nexport const AppGraphBuilder = AppCapability.appGraphBuilder(() => import('../app-graph-builder'), {\n  environments: ['node'],\n});\n\nexport const Commands = AppCapability.commands(() => import('../commands'));\n\nexport const LayerSpecs = AppCapability.layerSpec(() => import('../layer-specs'), {\n  name: 'LayerSpecs',\n  provides: [Capabilities.TraceSink],\n});\n\nexport const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler'));\n\nexport const RegistrySync = Capability.lazyModule(\n  'RegistrySync',\n  {\n    requires: [\n      ClientCapabilities.Client,\n      Capabilities.AtomRegistry,\n      AppCapabilities.SkillDefinition,\n      Capabilities.OperationHandler,\n    ],\n    provides: [],\n    environments: ['node'],\n  },\n  () => import('../registry-sync'),\n);\n\nexport const Schema = AppCapability.schema(() => import('../schema'));\n\nexport const Templates = Capability.lazyModule(\n  'Templates',\n  { provides: [RoutineCapabilities.Template], environments: ['node', 'workerd'] },\n  () => import('../templates'),\n);\n\nexport const Translations = AppCapability.translations(translations);\n\nexport const TriggerRuntimeController = Capability.lazyModule(\n  'TriggerRuntimeController',\n  {\n    requires: [ClientCapabilities.Client, Capabilities.ProcessManagerRuntime],\n    provides: [],\n    // Runtime event: triggers only need to react to spaces once the client observes them.\n    activatesOn: ClientEvents.SpacesReady,\n    environments: ['node'],\n  },\n  () => import('../trigger-runtime-controller'),\n);\n\nexport const CreateObject = undefined;\nexport const PluginAsset = undefined;\nexport const ReactSurface = undefined;\n"],"mappings":";;;;;;;;;AAgBA,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,kCAAyB,EACjG,cAAc,CAAC,MAAM,EACvB,CAAC;AAED,IAAa,WAAW,cAAc,eAAe,OAAO,uBAAc;AAE1E,IAAa,aAAa,cAAc,gBAAgB,OAAO,4BAAmB;CAChF,MAAM;CACN,UAAU,CAAC,aAAa,SAAS;AACnC,CAAC;AAED,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,gCAAuB;AAEnG,IAAa,eAAe,WAAW,WACrC,gBACA;CACE,UAAU;EACR,mBAAmB;EACnB,aAAa;EACb,gBAAgB;EAChB,aAAa;CACf;CACA,UAAU,CAAC;CACX,cAAc,CAAC,MAAM;AACvB,SACM,OAAO,4BACf;AAEA,IAAa,SAAS,cAAc,aAAa,OAAO,qBAAY;AAEpE,IAAa,YAAY,WAAW,WAClC,aACA;CAAE,UAAU,CAAC,oBAAoB,QAAQ;CAAG,cAAc,CAAC,QAAQ,SAAS;AAAE,SACxE,OAAO,wBACf;AAEA,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,2BAA2B,WAAW,WACjD,4BACA;CACE,UAAU,CAAC,mBAAmB,QAAQ,aAAa,qBAAqB;CACxE,UAAU,CAAC;CAEX,aAAa,aAAa;CAC1B,cAAc,CAAC,MAAM;AACvB,SACM,OAAO,yCACf;AAEA,IAAa,eAAe,KAAA;AAC5B,IAAa,cAAc,KAAA;AAC3B,IAAa,eAAe,KAAA"}

package/dist/lib/capabilities.workerd.mjs

@@ -0,0 +1,28 @@
+import * as Capabilities from "@dxos/app-framework/Capabilities";
+import * as Capability from "@dxos/app-framework/Capability";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
+import { translations } from "#translations";
+import { RoutineCapabilities } from "#types";
+//#region src/capabilities/gen/workerd.ts
+var Commands = AppCapability.commands(() => import("./chunk-commands.mjs"));
+var LayerSpecs = AppCapability.layerSpec(() => import("./chunk-layer-specs.mjs"), {
+	name: "LayerSpecs",
+	provides: [Capabilities.TraceSink]
+});
+var OperationHandler = AppCapability.operationHandler(() => import("./chunk-operation-handler.mjs"));
+var Schema = AppCapability.schema(() => import("./chunk-schema.mjs"));
+var Templates = Capability.lazyModule("Templates", {
+	provides: [RoutineCapabilities.Template],
+	environments: ["node", "workerd"]
+}, () => import("./chunk-templates.mjs"));
+var Translations = AppCapability.translations(translations);
+var AppGraphBuilder = void 0;
+var CreateObject = void 0;
+var PluginAsset = void 0;
+var ReactSurface = void 0;
+var RegistrySync = void 0;
+var TriggerRuntimeController = void 0;
+//#endregion
+export { AppGraphBuilder, Commands, CreateObject, LayerSpecs, OperationHandler, PluginAsset, ReactSurface, RegistrySync, Schema, Templates, Translations, TriggerRuntimeController };
+
+//# sourceMappingURL=capabilities.workerd.mjs.map

package/dist/lib/capabilities.workerd.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.workerd.mjs","names":[],"sources":["../../src/capabilities/gen/workerd.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'workerd' condition.\n\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\n\nimport { translations } from '#translations';\nimport { RoutineCapabilities } from '#types';\n\nexport const Commands = AppCapability.commands(() => import('../commands'));\n\nexport const LayerSpecs = AppCapability.layerSpec(() => import('../layer-specs'), {\n  name: 'LayerSpecs',\n  provides: [Capabilities.TraceSink],\n});\n\nexport const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler'));\n\nexport const Schema = AppCapability.schema(() => import('../schema'));\n\nexport const Templates = Capability.lazyModule(\n  'Templates',\n  { provides: [RoutineCapabilities.Template], environments: ['node', 'workerd'] },\n  () => import('../templates'),\n);\n\nexport const Translations = AppCapability.translations(translations);\n\nexport const AppGraphBuilder = undefined;\nexport const CreateObject = undefined;\nexport const PluginAsset = undefined;\nexport const ReactSurface = undefined;\nexport const RegistrySync = undefined;\nexport const TriggerRuntimeController = undefined;\n"],"mappings":";;;;;;AAaA,IAAa,WAAW,cAAc,eAAe,OAAO,uBAAc;AAE1E,IAAa,aAAa,cAAc,gBAAgB,OAAO,4BAAmB;CAChF,MAAM;CACN,UAAU,CAAC,aAAa,SAAS;AACnC,CAAC;AAED,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,gCAAuB;AAEnG,IAAa,SAAS,cAAc,aAAa,OAAO,qBAAY;AAEpE,IAAa,YAAY,WAAW,WAClC,aACA;CAAE,UAAU,CAAC,oBAAoB,QAAQ;CAAG,cAAc,CAAC,QAAQ,SAAS;AAAE,SACxE,OAAO,wBACf;AAEA,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,kBAAkB,KAAA;AAC/B,IAAa,eAAe,KAAA;AAC5B,IAAa,cAAc,KAAA;AAC3B,IAAa,eAAe,KAAA;AAC5B,IAAa,eAAe,KAAA;AAC5B,IAAa,2BAA2B,KAAA"}

package/dist/lib/chunk-RoutineArticle.mjs

@@ -1,13 +1,14 @@
+import { RoutineOperation } from "#types";
 import { meta } from "#meta";
 import { Obj, Ref } from "@dxos/echo";
 import { useCallback, useContext, useMemo } from "react";
 import { useObject } from "@dxos/echo-react";
 import { Panel } from "@dxos/react-ui";
-import { jsx, jsxs } from "react/jsx-runtime";
 import { useOperationInvoker } from "@dxos/app-framework/ui";
-import { RoutineOperation } from "#types";
-import { Atom, RegistryContext } from "@effect-atom/atom-react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import * as Atom from "effect/unstable/reactivity/Atom";
 import { RoutineForm } from "#components";
+import { RegistryContext } from "@effect/atom-react/RegistryContext";
 import { Menu, MenuBuilder, useMenuBuilder } from "@dxos/react-ui-menu";
 //#region src/containers/RoutineArticle/RoutineArticle.tsx
 /**
@@ -51,7 +52,10 @@ var RoutineArticle = ({ role, attendableId, subject }) => {
 		attendableId,
 		children: /* @__PURE__ */ jsxs(Panel.Root, {
 			role,
-			children: [/* @__PURE__ */ jsx(Panel.Toolbar, { children: /* @__PURE__ */ jsx(Menu.Toolbar, { classNames: "dx-document" }) }), /* @__PURE__ */ jsx(Panel.Content, {
+			children: [/* @__PURE__ */ jsx(Panel.Toolbar, { children: /* @__PURE__ */ jsx(Menu.Toolbar, {
+				classNames: "dx-document",
+				children: /* @__PURE__ */ jsx(Menu.Items, {})
+			}) }), /* @__PURE__ */ jsx(Panel.Content, {
 				asChild: true,
 				children: /* @__PURE__ */ jsx(RoutineForm, {
 					db,

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

@@ -1 +1 @@
-{"version":3,"file":"chunk-RoutineArticle.mjs","names":[],"sources":["../../src/containers/RoutineArticle/RoutineArticle.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Atom, RegistryContext } from '@effect-atom/atom-react';\nimport React, { useCallback, useContext, useMemo } from 'react';\n\nimport { useOperationInvoker } from '@dxos/app-framework/ui';\nimport { type AppSurface } from '@dxos/app-toolkit/ui';\nimport { Routine } from '@dxos/compute';\nimport { Obj, Ref } from '@dxos/echo';\nimport { useObject } from '@dxos/echo-react';\nimport { Panel } from '@dxos/react-ui';\nimport { Menu, MenuBuilder, useMenuBuilder } from '@dxos/react-ui-menu';\n\nimport { RoutineForm } from '#components';\nimport { meta } from '#meta';\nimport { RoutineOperation } from '#types';\n\nexport type RoutineArticleProps = AppSurface.ObjectArticleProps<Routine.Routine>;\n\n/**\n * Article surface for a {@link Routine}. The form edits the live routine in place; each trigger's on/off state\n * is toggled inline in the trigger editor. The toolbar exposes Run.\n *\n * TODO(wittjosiah): Disable editing while the routine is running (you shouldn't mutate running code). This was\n * previously wired as \"read-only when enabled\" via a routine-level toggle, but that is not how we want to\n * achieve it — reintroduce a run-state-based lock instead.\n */\nexport const RoutineArticle = ({ role, attendableId, subject }: RoutineArticleProps) => {\n  const { invokePromise } = useOperationInvoker();\n  const registry = useContext(RegistryContext);\n  // Subscribe so the run affordance tracks the routine's action (`spec`).\n  const [routine] = useObject(subject);\n  const db = Obj.getDatabase(subject);\n\n  const runningAtom = useMemo(() => Atom.make(false), []);\n\n  // Require both a spec and at least one trigger: manual runs are attributed to the first trigger\n  // so they appear in history, and without a trigger the run would be invisible there.\n  const canRun = useMemo(() => Boolean(routine.spec) && routine.triggers.length > 0, [routine.spec, routine.triggers]);\n\n  const handleRun = useCallback(() => {\n    if (!invokePromise || !db) {\n      return;\n    }\n\n    // Thread the routine's first trigger as trace attribution so the run appears in history.\n    // Manual runs bypass the trigger dispatcher (which normally stamps meta.trigger), so we\n    // do it here — history filters on trigger entity id, and without this the run is invisible.\n    const triggerRef = routine.triggers[0];\n    registry.set(runningAtom, true);\n    void invokePromise(\n      RoutineOperation.RunRoutine,\n      { routine: Ref.make(subject) },\n      {\n        spaceId: db.spaceId,\n        notify: { error: ['run-error.message', { ns: meta.profile.key }] },\n        ...(triggerRef ? { tracing: { trigger: triggerRef } } : {}),\n      },\n    ).finally(() => registry.set(runningAtom, false));\n  }, [invokePromise, db, subject, routine, registry, runningAtom]);\n\n  const menuActions = useArticleMenuActions({ canRun, runningAtom, handleRun });\n\n  if (!db) {\n    return null;\n  }\n\n  return (\n    <Menu.Root {...menuActions} attendableId={attendableId}>\n      <Panel.Root role={role}>\n        <Panel.Toolbar>\n          <Menu.Toolbar classNames='dx-document' />\n        </Panel.Toolbar>\n        <Panel.Content asChild>\n          <RoutineForm db={db} routine={subject} />\n        </Panel.Content>\n      </Panel.Root>\n    </Menu.Root>\n  );\n};\n\n//\n// Hooks\n//\n\ntype ArticleMenuActionsOptions = {\n  canRun: boolean;\n  runningAtom: Atom.Writable<boolean>;\n  handleRun: () => void;\n};\n\nconst useArticleMenuActions = ({ canRun, runningAtom, handleRun }: ArticleMenuActionsOptions) =>\n  useMenuBuilder(\n    (get) =>\n      MenuBuilder.make()\n        .action(\n          'run',\n          {\n            label: ['run.label', { ns: meta.profile.key }],\n            icon: 'ph--play--regular',\n            disabled: get(runningAtom) || !canRun,\n            disposition: 'toolbar',\n            testId: 'routine.toolbar.run',\n          },\n          () => handleRun(),\n        )\n        .build(),\n    [canRun, handleRun, runningAtom],\n  );\n\nRoutineArticle.displayName = 'RoutineArticle';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA6BA,IAAa,kBAAkB,EAAE,MAAM,cAAc,cAAmC;CACtF,MAAM,EAAE,kBAAkB,oBAAoB;CAC9C,MAAM,WAAW,WAAW,eAAe;CAE3C,MAAM,CAAC,WAAW,UAAU,OAAO;CACnC,MAAM,KAAK,IAAI,YAAY,OAAO;CAElC,MAAM,cAAc,cAAc,KAAK,KAAK,KAAK,GAAG,CAAC,CAAC;CA2BtD,MAAM,cAAc,sBAAsB;EAAE,QAvB7B,cAAc,QAAQ,QAAQ,IAAI,KAAK,QAAQ,SAAS,SAAS,GAAG,CAAC,QAAQ,MAAM,QAAQ,QAAQ,CAuBtE;EAAQ;EAAa,WArB/C,kBAAkB;GAClC,IAAI,CAAC,iBAAiB,CAAC,IACrB;GAMF,MAAM,aAAa,QAAQ,SAAS;GACpC,SAAS,IAAI,aAAa,IAAI;GAC9B,cACE,iBAAiB,YACjB,EAAE,SAAS,IAAI,KAAK,OAAO,EAAE,GAC7B;IACE,SAAS,GAAG;IACZ,QAAQ,EAAE,OAAO,CAAC,qBAAqB,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC,EAAE;IACjE,GAAI,aAAa,EAAE,SAAS,EAAE,SAAS,WAAW,EAAE,IAAI,CAAC;GAC3D,CACF,CAAC,CAAC,cAAc,SAAS,IAAI,aAAa,KAAK,CAAC;EAClD,GAAG;GAAC;GAAe;GAAI;GAAS;GAAS;GAAU;EAAW,CAEG;CAAU,CAAC;CAE5E,IAAI,CAAC,IACH,OAAO;CAGT,OACE,oBAAC,KAAK,MAAN;EAAW,GAAI;EAA2B;YACxC,qBAAC,MAAM,MAAP;GAAkB;aAAlB,CACE,oBAAC,MAAM,SAAP,EAAA,UACE,oBAAC,KAAK,SAAN,EAAc,YAAW,cAAe,CAAA,EAC3B,CAAA,GACf,oBAAC,MAAM,SAAP;IAAe,SAAA;cACb,oBAAC,aAAD;KAAiB;KAAI,SAAS;IAAU,CAAA;GAC3B,CAAA,CACL;;CACH,CAAA;AAEf;AAYA,IAAM,yBAAyB,EAAE,QAAQ,aAAa,gBACpD,gBACG,QACC,YAAY,KAAK,CAAA,CACd,OACC,OACA;CACE,OAAO,CAAC,aAAa,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC;CAC7C,MAAM;CACN,UAAU,IAAI,WAAW,KAAK,CAAC;CAC/B,aAAa;CACb,QAAQ;AACV,SACM,UAAU,CAClB,CAAA,CACC,MAAM,GACX;CAAC;CAAQ;CAAW;AAAW,CACjC;AAEF,eAAe,cAAc"}
+{"version":3,"file":"chunk-RoutineArticle.mjs","names":[],"sources":["../../src/containers/RoutineArticle/RoutineArticle.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { RegistryContext } from '@effect/atom-react/RegistryContext';\nimport * as Atom from 'effect/unstable/reactivity/Atom';\nimport React, { useCallback, useContext, useMemo } from 'react';\n\nimport { useOperationInvoker } from '@dxos/app-framework/ui';\nimport { type AppSurface } from '@dxos/app-toolkit/ui';\nimport * as Routine from '@dxos/compute/Routine';\nimport { Obj, Ref } from '@dxos/echo';\nimport { useObject } from '@dxos/echo-react';\nimport { Panel } from '@dxos/react-ui';\nimport { Menu, MenuBuilder, useMenuBuilder } from '@dxos/react-ui-menu';\n\nimport { RoutineForm } from '#components';\nimport { meta } from '#meta';\nimport { RoutineOperation } from '#types';\n\nexport type RoutineArticleProps = AppSurface.ObjectArticleProps<Routine.Routine>;\n\n/**\n * Article surface for a {@link Routine}. The form edits the live routine in place; each trigger's on/off state\n * is toggled inline in the trigger editor. The toolbar exposes Run.\n *\n * TODO(wittjosiah): Disable editing while the routine is running (you shouldn't mutate running code). This was\n * previously wired as \"read-only when enabled\" via a routine-level toggle, but that is not how we want to\n * achieve it — reintroduce a run-state-based lock instead.\n */\nexport const RoutineArticle = ({ role, attendableId, subject }: RoutineArticleProps) => {\n  const { invokePromise } = useOperationInvoker();\n  const registry = useContext(RegistryContext);\n  // Subscribe so the run affordance tracks the routine's action (`spec`).\n  const [routine] = useObject(subject);\n  const db = Obj.getDatabase(subject);\n\n  const runningAtom = useMemo(() => Atom.make(false), []);\n\n  // Require both a spec and at least one trigger: manual runs are attributed to the first trigger\n  // so they appear in history, and without a trigger the run would be invisible there.\n  const canRun = useMemo(() => Boolean(routine.spec) && routine.triggers.length > 0, [routine.spec, routine.triggers]);\n\n  const handleRun = useCallback(() => {\n    if (!invokePromise || !db) {\n      return;\n    }\n\n    // Thread the routine's first trigger as trace attribution so the run appears in history.\n    // Manual runs bypass the trigger dispatcher (which normally stamps meta.trigger), so we\n    // do it here — history filters on trigger entity id, and without this the run is invisible.\n    const triggerRef = routine.triggers[0];\n    registry.set(runningAtom, true);\n    void invokePromise(\n      RoutineOperation.RunRoutine,\n      { routine: Ref.make(subject) },\n      {\n        spaceId: db.spaceId,\n        notify: { error: ['run-error.message', { ns: meta.profile.key }] },\n        ...(triggerRef ? { tracing: { trigger: triggerRef } } : {}),\n      },\n    ).finally(() => registry.set(runningAtom, false));\n  }, [invokePromise, db, subject, routine, registry, runningAtom]);\n\n  const menuActions = useArticleMenuActions({ canRun, runningAtom, handleRun });\n\n  if (!db) {\n    return null;\n  }\n\n  return (\n    <Menu.Root {...menuActions} attendableId={attendableId}>\n      <Panel.Root role={role}>\n        <Panel.Toolbar>\n          <Menu.Toolbar classNames='dx-document'>\n            <Menu.Items />\n          </Menu.Toolbar>\n        </Panel.Toolbar>\n        <Panel.Content asChild>\n          <RoutineForm db={db} routine={subject} />\n        </Panel.Content>\n      </Panel.Root>\n    </Menu.Root>\n  );\n};\n\n//\n// Hooks\n//\n\ntype ArticleMenuActionsOptions = {\n  canRun: boolean;\n  runningAtom: Atom.Writable<boolean>;\n  handleRun: () => void;\n};\n\nconst useArticleMenuActions = ({ canRun, runningAtom, handleRun }: ArticleMenuActionsOptions) =>\n  useMenuBuilder(\n    (get) =>\n      MenuBuilder.make()\n        .action(\n          'run',\n          {\n            label: ['run.label', { ns: meta.profile.key }],\n            icon: 'ph--play--regular',\n            disabled: get(runningAtom) || !canRun,\n            disposition: 'toolbar',\n            testId: 'routine.toolbar.run',\n          },\n          () => handleRun(),\n        )\n        .build(),\n    [canRun, handleRun, runningAtom],\n  );\n\nRoutineArticle.displayName = 'RoutineArticle';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA8BA,IAAa,kBAAkB,EAAE,MAAM,cAAc,cAAmC;CACtF,MAAM,EAAE,kBAAkB,oBAAoB;CAC9C,MAAM,WAAW,WAAW,eAAe;CAE3C,MAAM,CAAC,WAAW,UAAU,OAAO;CACnC,MAAM,KAAK,IAAI,YAAY,OAAO;CAElC,MAAM,cAAc,cAAc,KAAK,KAAK,KAAK,GAAG,CAAC,CAAC;CA2BtD,MAAM,cAAc,sBAAsB;EAAE,QAvB7B,cAAc,QAAQ,QAAQ,IAAI,KAAK,QAAQ,SAAS,SAAS,GAAG,CAAC,QAAQ,MAAM,QAAQ,QAAQ,CAuBtE;EAAQ;EAAa,WArB/C,kBAAkB;GAClC,IAAI,CAAC,iBAAiB,CAAC,IACrB;GAMF,MAAM,aAAa,QAAQ,SAAS;GACpC,SAAS,IAAI,aAAa,IAAI;GAC9B,cACE,iBAAiB,YACjB,EAAE,SAAS,IAAI,KAAK,OAAO,EAAE,GAC7B;IACE,SAAS,GAAG;IACZ,QAAQ,EAAE,OAAO,CAAC,qBAAqB,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC,EAAE;IACjE,GAAI,aAAa,EAAE,SAAS,EAAE,SAAS,WAAW,EAAE,IAAI,CAAC;GAC3D,CACF,CAAC,CAAC,cAAc,SAAS,IAAI,aAAa,KAAK,CAAC;EAClD,GAAG;GAAC;GAAe;GAAI;GAAS;GAAS;GAAU;EAAW,CAEG;CAAU,CAAC;CAE5E,IAAI,CAAC,IACH,OAAO;CAGT,OACE,oBAAC,KAAK,MAAN;EAAW,GAAI;EAA2B;EACxC,UAAA,qBAAC,MAAM,MAAP;GAAkB;GAAlB,UAAA,CACE,oBAAC,MAAM,SAAP,EAAA,UACE,oBAAC,KAAK,SAAN;IAAc,YAAW;IACvB,UAAA,oBAAC,KAAK,OAAN,CAAa,CAAA;GACD,CAAA,EACD,CAAA,GACf,oBAAC,MAAM,SAAP;IAAe,SAAA;IACb,UAAA,oBAAC,aAAD;KAAiB;KAAI,SAAS;IAAU,CAAA;GAC3B,CAAA,CACL;;CACH,CAAA;AAEf;AAYA,IAAM,yBAAyB,EAAE,QAAQ,aAAa,gBACpD,gBACG,QACC,YAAY,KAAK,CAAA,CACd,OACC,OACA;CACE,OAAO,CAAC,aAAa,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC;CAC7C,MAAM;CACN,UAAU,IAAI,WAAW,KAAK,CAAC;CAC/B,aAAa;CACb,QAAQ;AACV,SACM,UAAU,CAClB,CAAA,CACC,MAAM,GACX;CAAC;CAAQ;CAAW;AAAW,CACjC;AAEF,eAAe,cAAc"}

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

@@ -1 +1 @@
-{"version":3,"file":"chunk-RoutineSettings.mjs","names":[],"sources":["../../src/containers/RoutineSettings/RoutineSettings.tsx"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport React from 'react';\n\nimport { useActiveSpace } from '@dxos/app-toolkit/ui';\nimport { useObject } from '@dxos/echo-react';\nimport { Input, useTranslation } from '@dxos/react-ui';\nimport { Form } from '@dxos/react-ui-form';\n\nimport { meta } from '#meta';\n\n/**\n * Space-level routine settings. Individual routines are now first-class objects (configured in their\n * article + per-object companion), so this page exposes the space-wide kill-switch for trigger\n * execution. Per-trigger local/edge routing is set on each trigger via its `remote` flag.\n *\n * The page is reached from space settings, so the space comes from context rather than surface data.\n */\nexport const RoutineSettings = () => {\n  const { t } = useTranslation(meta.profile.key);\n  const space = useActiveSpace();\n  const [properties, changeProperties] = useObject(space?.properties);\n  const enabled = !(properties?.triggersDisabled ?? false);\n\n  const handleToggle = (value: boolean) => {\n    changeProperties((current) => {\n      current.triggersDisabled = !value;\n    });\n  };\n\n  if (!space) {\n    return null;\n  }\n\n  return (\n    <Form.Root variant='settings'>\n      <Form.Viewport scroll>\n        <Form.Content>\n          <Form.Section title={t('routine-verbose.label')} description={t('routine.description')}>\n            <Form.Row label={t('runtime.label')} description={t('runtime.description')}>\n              <Input.Root>\n                <Input.Switch checked={enabled} onCheckedChange={handleToggle} />\n              </Input.Root>\n            </Form.Row>\n          </Form.Section>\n        </Form.Content>\n      </Form.Viewport>\n    </Form.Root>\n  );\n};\n\nRoutineSettings.displayName = 'RoutineSettings';\n"],"mappings":";;;;;;;;;;;;;;;AAoBA,IAAa,wBAAwB;CACnC,MAAM,EAAE,MAAM,eAAe,KAAK,QAAQ,GAAG;CAC7C,MAAM,QAAQ,eAAe;CAC7B,MAAM,CAAC,YAAY,oBAAoB,UAAU,OAAO,UAAU;CAClE,MAAM,UAAU,EAAE,YAAY,oBAAoB;CAElD,MAAM,gBAAgB,UAAmB;EACvC,kBAAkB,YAAY;GAC5B,QAAQ,mBAAmB,CAAC;EAC9B,CAAC;CACH;CAEA,IAAI,CAAC,OACH,OAAO;CAGT,OACE,oBAAC,KAAK,MAAN;EAAW,SAAQ;YACjB,oBAAC,KAAK,UAAN;GAAe,QAAA;aACb,oBAAC,KAAK,SAAN,EAAA,UACE,oBAAC,KAAK,SAAN;IAAc,OAAO,EAAE,uBAAuB;IAAG,aAAa,EAAE,qBAAqB;cACnF,oBAAC,KAAK,KAAN;KAAU,OAAO,EAAE,eAAe;KAAG,aAAa,EAAE,qBAAqB;eACvE,oBAAC,MAAM,MAAP,EAAA,UACE,oBAAC,MAAM,QAAP;MAAc,SAAS;MAAS,iBAAiB;KAAe,CAAA,EACtD,CAAA;IACJ,CAAA;GACE,CAAA,EACF,CAAA;EACD,CAAA;CACN,CAAA;AAEf;AAEA,gBAAgB,cAAc"}
+{"version":3,"file":"chunk-RoutineSettings.mjs","names":[],"sources":["../../src/containers/RoutineSettings/RoutineSettings.tsx"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport React from 'react';\n\nimport { useActiveSpace } from '@dxos/app-toolkit/ui';\nimport { useObject } from '@dxos/echo-react';\nimport { Input, useTranslation } from '@dxos/react-ui';\nimport { Form } from '@dxos/react-ui-form';\n\nimport { meta } from '#meta';\n\n/**\n * Space-level routine settings. Individual routines are now first-class objects (configured in their\n * article + per-object companion), so this page exposes the space-wide kill-switch for trigger\n * execution. Per-trigger local/edge routing is set on each trigger via its `remote` flag.\n *\n * The page is reached from space settings, so the space comes from context rather than surface data.\n */\nexport const RoutineSettings = () => {\n  const { t } = useTranslation(meta.profile.key);\n  const space = useActiveSpace();\n  const [properties, changeProperties] = useObject(space?.properties);\n  const enabled = !(properties?.triggersDisabled ?? false);\n\n  const handleToggle = (value: boolean) => {\n    changeProperties((current) => {\n      current.triggersDisabled = !value;\n    });\n  };\n\n  if (!space) {\n    return null;\n  }\n\n  return (\n    <Form.Root variant='settings'>\n      <Form.Viewport scroll>\n        <Form.Content>\n          <Form.Section title={t('routine-verbose.label')} description={t('routine.description')}>\n            <Form.Row label={t('runtime.label')} description={t('runtime.description')}>\n              <Input.Root>\n                <Input.Switch checked={enabled} onCheckedChange={handleToggle} />\n              </Input.Root>\n            </Form.Row>\n          </Form.Section>\n        </Form.Content>\n      </Form.Viewport>\n    </Form.Root>\n  );\n};\n\nRoutineSettings.displayName = 'RoutineSettings';\n"],"mappings":";;;;;;;;;;;;;;;AAoBA,IAAa,wBAAwB;CACnC,MAAM,EAAE,MAAM,eAAe,KAAK,QAAQ,GAAG;CAC7C,MAAM,QAAQ,eAAe;CAC7B,MAAM,CAAC,YAAY,oBAAoB,UAAU,OAAO,UAAU;CAClE,MAAM,UAAU,EAAE,YAAY,oBAAoB;CAElD,MAAM,gBAAgB,UAAmB;EACvC,kBAAkB,YAAY;GAC5B,QAAQ,mBAAmB,CAAC;EAC9B,CAAC;CACH;CAEA,IAAI,CAAC,OACH,OAAO;CAGT,OACE,oBAAC,KAAK,MAAN;EAAW,SAAQ;EACjB,UAAA,oBAAC,KAAK,UAAN;GAAe,QAAA;GACb,UAAA,oBAAC,KAAK,SAAN,EAAA,UACE,oBAAC,KAAK,SAAN;IAAc,OAAO,EAAE,uBAAuB;IAAG,aAAa,EAAE,qBAAqB;IACnF,UAAA,oBAAC,KAAK,KAAN;KAAU,OAAO,EAAE,eAAe;KAAG,aAAa,EAAE,qBAAqB;KACvE,UAAA,oBAAC,MAAM,MAAP,EAAA,UACE,oBAAC,MAAM,QAAP;MAAc,SAAS;MAAS,iBAAiB;KAAe,CAAA,EACtD,CAAA;IACJ,CAAA;GACE,CAAA,EACF,CAAA;EACD,CAAA;CACN,CAAA;AAEf;AAEA,gBAAgB,cAAc"}

package/dist/lib/chunk-RoutineTraceCompanion.mjs

@@ -1,14 +1,15 @@
-import { Trace } from "@dxos/compute";
 import { meta } from "#meta";
 import { Filter, Obj, Query } from "@dxos/echo";
-import { EID } from "@dxos/keys";
 import { useMemo } from "react";
 import { useQuery } from "@dxos/echo-react";
-import { Icon, Panel, ScrollArea, Toolbar, useTranslation } from "@dxos/react-ui";
+import { Flex, Icon, Panel, ScrollArea, Toolbar, useTranslation } from "@dxos/react-ui";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Accordion, Empty, Listbox } from "@dxos/react-ui-list";
 import { FeedTraceSink } from "@dxos/compute-runtime";
+import { EID } from "@dxos/keys";
+import * as Trace from "@dxos/compute/Trace";
 import { JsonHighlighter } from "@dxos/react-ui-syntax-highlighter";
+import { RUN_AGAIN_ERROR_CODE, RUN_AGAIN_MESSAGE } from "@dxos/compute";
 //#region src/containers/RoutineTraceCompanion/runs.ts
 /**
 * Groups trace messages into per-run summaries.
@@ -58,13 +59,18 @@ var groupIntoRuns = (messages, triggerEntityIds) => {
 		allEvents.sort((left, right) => left.timestamp - right.timestamp);
 		const startedAt = allEvents[0]?.timestamp ?? 0;
 		const duration = (allEvents.at(-1)?.timestamp ?? startedAt) - startedAt;
+		const isRunAgain = (data) => data.errorCode === RUN_AGAIN_ERROR_CODE || data.errorCode === void 0 && data.error === RUN_AGAIN_MESSAGE;
 		let status = "pending";
 		for (const evt of allEvents) if (Trace.isOfType(Trace.OperationEnd, evt)) {
 			if (evt.data.outcome === "failure") {
+				if (isRunAgain(evt.data)) {
+					status = "incomplete";
+					continue;
+				}
 				status = "failure";
 				break;
 			}
-			status = "success";
+			if (status !== "incomplete") status = "success";
 		}
 		const conversation = msgs.find((msg) => msg.meta.conversation)?.meta.conversation;
 		const events = allEvents.map((evt) => ({
@@ -115,11 +121,13 @@ var useRoutineRuns = (db, routine) => {
 var STATUS_ICONS = {
 	success: "ph--check-circle--regular",
 	failure: "ph--x-circle--regular",
+	incomplete: "ph--arrows-clockwise--regular",
 	pending: "ph--clock--regular"
 };
 var STATUS_CLASSES = {
 	success: "text-success-text",
 	failure: "text-error-text",
+	incomplete: "text-warning-text",
 	pending: "text-description"
 };
 /** Companion panel showing the execution trace (runs) of a Routine. */
@@ -138,8 +146,8 @@ var RoutineTraceCompanion = ({ role, subject }) => {
 				children: /* @__PURE__ */ jsx(ScrollArea.Viewport, { children: runs.length === 0 ? /* @__PURE__ */ jsx(Empty, { label: t("history.empty.message") }) : /* @__PURE__ */ jsx(Accordion.Root, {
 					items: runs,
 					getId: getRunId,
-					children: ({ items }) => /* @__PURE__ */ jsx("div", {
-						className: "flex flex-col",
+					children: ({ items }) => /* @__PURE__ */ jsx(Flex, {
+						column: true,
 						children: items.map((run) => /* @__PURE__ */ jsxs(Accordion.Item, {
 							item: run,
 							classNames: "border-b border-subdued-separator",