@dxos/plugin-crx 0.0.0

package/README.md

@@ -0,0 +1,25 @@
+# @dxos/plugin-crx
+
+Coordinates with the [`@dxos/composer-crx`](../../apps/composer-crx) browser
+extension. This plugin owns the Composer side of the page-actions bridge:
+
+- Plugins contribute page actions under `CrxCapabilities.PageAction` — a
+  serializable descriptor (label, icon, URL patterns, contexts, extractor)
+  paired with a target operation. This plugin contributes three picker
+  actions (Person, Organization, Note); plugin-bookmarks contributes
+  "Add bookmark".
+- The extension lists contributed actions via
+  `CustomEvent('composer:page-actions:list')`, caches the descriptors in its
+  registry, and invokes an action via
+  `CustomEvent('composer:page-action:invoke')`. Every request is acked with
+  stable error codes (`invalidPayload`, `unsupportedVersion`,
+  `unknownAction`, `noSpace`, `operationFailed`).
+- Picked/extracted content travels as a `PageAction.Snapshot` (source,
+  selection, hints, optional image data). The target operation receives
+  `{ snapshot, target }` — where `target` is the active space's database —
+  and creates the object there; outcomes surface as toasts.
+
+It also owns the user-facing settings surface, including the render-proxy
+settings and an extension connection test.
+
+See [PLUGIN.mdl](./PLUGIN.mdl) for the specification.

package/dist/lib/CrxCapabilities.mjs

@@ -0,0 +1,21 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import * as Capability from "@dxos/app-framework/Capability";
+import { meta } from "#meta";
+//#region src/types/CrxCapabilities.ts
+var CrxCapabilities_exports = /* @__PURE__ */ __exportAll({
+	PageAction: () => PageAction,
+	Settings: () => Settings
+});
+/**
+* Writable atom holding the plugin's Settings.
+*/
+var Settings = Capability.makeSingleton()(`${meta.profile.key}.capability.settings`);
+/**
+* Page actions contributed by plugins for the browser extension to surface.
+* Multi: each contributor provides one array (e.g. plugin-bookmarks); consumers flatten via `getAll`.
+*/
+var PageAction = Capability.make()(`${meta.profile.key}.capability.pageAction`);
+//#endregion
+export { PageAction, Settings, CrxCapabilities_exports as t };
+
+//# sourceMappingURL=CrxCapabilities.mjs.map

package/dist/lib/CrxCapabilities.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CrxCapabilities.mjs","names":[],"sources":["../../src/types/CrxCapabilities.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport type * as Atom from 'effect/unstable/reactivity/Atom';\n\nimport * as Capability from '@dxos/app-framework/Capability';\n\nimport { meta } from '#meta';\n\n/**\n * Writable atom holding the plugin's Settings.\n */\nexport const Settings = Capability.makeSingleton<Atom.Writable<import('./Settings.ts').Settings>>()(\n  `${meta.profile.key}.capability.settings`,\n);\n\n/**\n * Page actions contributed by plugins for the browser extension to surface.\n * Multi: each contributor provides one array (e.g. plugin-bookmarks); consumers flatten via `getAll`.\n */\nexport const PageAction = Capability.make<import('./PageAction.ts').PageAction[]>()(\n  `${meta.profile.key}.capability.pageAction`,\n);\n"],"mappings":";;;;;;;;;;;AAeA,IAAa,WAAW,WAAW,cAA+D,CAAC,CACjG,GAAG,KAAK,QAAQ,IAAI,qBACtB;;;;;AAMA,IAAa,aAAa,WAAW,KAA6C,CAAC,CACjF,GAAG,KAAK,QAAQ,IAAI,uBACtB"}

package/dist/lib/CrxEvents.mjs

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

package/dist/lib/CrxEvents.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CrxEvents.mjs","names":[],"sources":["../../src/types/CrxEvents.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: the plugin's start-gated modules (and cross-plugin\n * contributions consumed by this feature) activate here. Fired on demand and by the\n * host's idle trickle.\n */\nexport const Start = ActivationEvent.pluginStart(meta.profile.key);\n"],"mappings":";;;;;;;;;;AAeA,IAAa,QAAQ,gBAAgB,YAAY,KAAK,QAAQ,GAAG"}

package/dist/lib/CrxOperation.mjs

@@ -0,0 +1,50 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { Snapshot } from "./PageAction.mjs";
+import * as Operation from "@dxos/compute/Operation";
+import * as Schema from "effect/Schema";
+import { DXN, Database } from "@dxos/echo";
+//#region src/types/CrxOperation.ts
+var CrxOperation_exports = /* @__PURE__ */ __exportAll({
+	AddNoteFromSnapshot: () => AddNoteFromSnapshot,
+	AddOrganizationFromSnapshot: () => AddOrganizationFromSnapshot,
+	AddPersonFromSnapshot: () => AddPersonFromSnapshot
+});
+var input = Schema.Struct({
+	snapshot: Snapshot,
+	target: Database.Database.annotate({ description: "The database to add the object to." })
+});
+var output = Schema.Struct({ id: Schema.String });
+var AddPersonFromSnapshot = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.crx.addPersonFromSnapshot"),
+		name: "Add person",
+		description: "Create a person from a page snapshot.",
+		icon: "ph--user--regular"
+	},
+	input,
+	output
+});
+var AddOrganizationFromSnapshot = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.crx.addOrganizationFromSnapshot"),
+		name: "Add organization",
+		description: "Create an organization from a page snapshot.",
+		icon: "ph--building-office--regular"
+	},
+	input,
+	output
+});
+var AddNoteFromSnapshot = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.crx.addNoteFromSnapshot"),
+		name: "Add note",
+		description: "Create a markdown note from a page snapshot.",
+		icon: "ph--note--regular"
+	},
+	input,
+	output
+});
+//#endregion
+export { AddNoteFromSnapshot, AddOrganizationFromSnapshot, AddPersonFromSnapshot, CrxOperation_exports as t };
+
+//# sourceMappingURL=CrxOperation.mjs.map

package/dist/lib/CrxOperation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CrxOperation.mjs","names":[],"sources":["../../src/types/CrxOperation.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport * as Operation from '@dxos/compute/Operation';\nimport { Database, DXN } from '@dxos/echo';\n\nimport * as PageAction from './PageAction.ts';\n\nconst input = Schema.Struct({\n  snapshot: PageAction.Snapshot,\n  target: Database.Database.annotate({ description: 'The database to add the object to.' }),\n});\n\nconst output = Schema.Struct({\n  id: Schema.String,\n});\n\nexport const AddPersonFromSnapshot = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.crx.addPersonFromSnapshot'),\n    name: 'Add person',\n    description: 'Create a person from a page snapshot.',\n    icon: 'ph--user--regular',\n  },\n  input,\n  output,\n});\n\nexport const AddOrganizationFromSnapshot = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.crx.addOrganizationFromSnapshot'),\n    name: 'Add organization',\n    description: 'Create an organization from a page snapshot.',\n    icon: 'ph--building-office--regular',\n  },\n  input,\n  output,\n});\n\nexport const AddNoteFromSnapshot = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.crx.addNoteFromSnapshot'),\n    name: 'Add note',\n    description: 'Create a markdown note from a page snapshot.',\n    icon: 'ph--note--regular',\n  },\n  input,\n  output,\n});\n"],"mappings":";;;;;;;;;;;AAaA,IAAM,QAAQ,OAAO,OAAO;CAC1B,UAAU;CACV,QAAQ,SAAS,SAAS,SAAS,EAAE,aAAa,qCAAqC,CAAC;AAC1F,CAAC;AAED,IAAM,SAAS,OAAO,OAAO,EAC3B,IAAI,OAAO,OACb,CAAC;AAED,IAAa,wBAAwB,UAAU,KAAK;CAClD,MAAM;EACJ,KAAK,IAAI,KAAK,8CAA8C;EAC5D,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA;CACA;AACF,CAAC;AAED,IAAa,8BAA8B,UAAU,KAAK;CACxD,MAAM;EACJ,KAAK,IAAI,KAAK,oDAAoD;EAClE,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA;CACA;AACF,CAAC;AAED,IAAa,sBAAsB,UAAU,KAAK;CAChD,MAAM;EACJ,KAAK,IAAI,KAAK,4CAA4C;EAC1D,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA;CACA;AACF,CAAC"}

package/dist/lib/CrxPlugin.mjs

@@ -0,0 +1,16 @@
+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/CrxPlugin.ts
+var CrxPlugin_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, CrxPlugin_exports as t };
+
+//# sourceMappingURL=CrxPlugin.mjs.map

package/dist/lib/CrxPlugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CrxPlugin.mjs","names":[],"sources":["../../src/CrxPlugin.ts"],"sourcesContent":["//\n// Copyright 2026 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/PageAction.mjs

@@ -0,0 +1,35 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { PageAction } from "@dxos/crx-protocol";
+//#region src/types/PageAction.ts
+var PageAction_exports = /* @__PURE__ */ __exportAll({
+	Context: () => Context,
+	Descriptor: () => Descriptor,
+	Envelope: () => Envelope,
+	ExtractorRef: () => ExtractorRef,
+	Hints: () => Hints,
+	INVOKE_ACK_EVENT: () => INVOKE_ACK_EVENT,
+	INVOKE_EVENT: () => INVOKE_EVENT,
+	InvokeAck: () => InvokeAck,
+	InvokeRequest: () => InvokeRequest,
+	LIST_ACK_EVENT: () => LIST_ACK_EVENT,
+	LIST_EVENT: () => LIST_EVENT,
+	ListAck: () => ListAck,
+	ListRequest: () => ListRequest,
+	PageInfo: () => PageInfo,
+	Predicate: () => Predicate,
+	READY_EVENT: () => READY_EVENT,
+	Rect: () => Rect,
+	Selection: () => Selection,
+	Snapshot: () => Snapshot,
+	Source: () => Source,
+	toDescriptor: () => toDescriptor
+});
+var { Rect, Source, Selection, Hints, Snapshot, Predicate, ExtractorRef, Context, Descriptor, PageInfo, Envelope, ListRequest, ListAck, InvokeRequest, InvokeAck, READY_EVENT, LIST_EVENT, LIST_ACK_EVENT, INVOKE_EVENT, INVOKE_ACK_EVENT } = PageAction;
+var toDescriptor = (action) => ({
+	...action,
+	operation: action.operation.meta.key.toString()
+});
+//#endregion
+export { Context, Descriptor, Envelope, ExtractorRef, Hints, INVOKE_ACK_EVENT, INVOKE_EVENT, InvokeAck, InvokeRequest, LIST_ACK_EVENT, LIST_EVENT, ListAck, ListRequest, PageInfo, Predicate, READY_EVENT, Rect, Selection, Snapshot, Source, PageAction_exports as t, toDescriptor };
+
+//# sourceMappingURL=PageAction.mjs.map

package/dist/lib/PageAction.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageAction.mjs","names":[],"sources":["../../src/types/PageAction.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport type * as Operation from '@dxos/compute/Operation';\nimport { PageAction as Protocol } from '@dxos/crx-protocol';\n\n// Re-export the serializable wire schemas from the shared protocol package.\nexport const {\n  Rect,\n  Source,\n  Selection,\n  Hints,\n  Snapshot,\n  Predicate,\n  ExtractorRef,\n  Context,\n  Descriptor,\n  PageInfo,\n  Envelope,\n  ListRequest,\n  ListAck,\n  InvokeRequest,\n  InvokeAck,\n  READY_EVENT,\n  LIST_EVENT,\n  LIST_ACK_EVENT,\n  INVOKE_EVENT,\n  INVOKE_ACK_EVENT,\n} = Protocol;\n\nexport type Source = Protocol.Source;\nexport type Selection = Protocol.Selection;\nexport type Hints = Protocol.Hints;\nexport type Snapshot = Protocol.Snapshot;\nexport type Predicate = Protocol.Predicate;\nexport type ExtractorRef = Protocol.ExtractorRef;\nexport type Context = Protocol.Context;\nexport type Descriptor = Protocol.Descriptor;\nexport type PageInfo = Protocol.PageInfo;\nexport type Envelope = Protocol.Envelope;\nexport type ListRequest = Protocol.ListRequest;\nexport type ListAck = Protocol.ListAck;\nexport type InvokeRequest = Protocol.InvokeRequest;\nexport type InvokeAck = Protocol.InvokeAck;\n\n/** A live page-action contribution: the target operation accepts `{ snapshot, target }` and returns `{ id }`. */\nexport type PageAction = Omit<Descriptor, 'operation'> & {\n  operation: Operation.Definition.Any;\n};\n\nexport const toDescriptor = (action: PageAction): Descriptor => ({\n  ...action,\n  operation: action.operation.meta.key.toString(),\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,IAAa,EACX,MACA,QACA,WACA,OACA,UACA,WACA,cACA,SACA,YACA,UACA,UACA,aACA,SACA,eACA,WACA,aACA,YACA,gBACA,cACA,qBACE;AAsBJ,IAAa,gBAAgB,YAAoC;CAC/D,GAAG;CACH,WAAW,OAAO,UAAU,KAAK,IAAI,SAAS;AAChD"}

package/dist/lib/Settings.mjs

@@ -0,0 +1,84 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import * as Schema from "effect/Schema";
+import * as Struct from "effect/Struct";
+//#region src/types/Settings.ts
+var Settings_exports = /* @__PURE__ */ __exportAll({
+	Settings: () => Settings,
+	defaults: () => defaults,
+	withDefaults: () => withDefaults
+});
+/**
+* User preferences that govern how Composer coordinates with the composer-crx
+* browser extension — both the page-actions bridge and the render-proxy. All fields
+* are optional; defaults are applied by consumers when reading the atom.
+*/
+var Settings = Schema.Struct({
+	/**
+	* Master toggle. When false, the bridge plugin ignores incoming extension actions.
+	* Defaults to `true`.
+	*/
+	enabled: Schema.optional(Schema.Boolean.annotate({
+		title: "Accept extension actions",
+		description: "When off, actions sent from the composer-crx browser extension are ignored."
+	})),
+	/**
+	* Navigate to the created object after the extension creates one. Defaults to
+	* `false` to avoid yanking focus during active work.
+	*/
+	autoOpenAfterClip: Schema.optional(Schema.Boolean.annotate({
+		title: "Open after action",
+		description: "Navigate to the created object when the extension creates one."
+	})),
+	/**
+	* Master toggle. When false, plugins fall back to the edge HTTP proxy instead of asking the
+	* extension to render pages. Defaults to `true`.
+	*/
+	renderProxyEnabled: Schema.optional(Schema.Boolean.annotate({
+		title: "Use extension to render pages",
+		description: "Let plugins render pages via the browser extension to scrape client-rendered sites."
+	})),
+	/**
+	* Maximum time (ms) to wait for a page to render before aborting. Defaults to `20000`.
+	*/
+	renderTimeout: Schema.optional(Schema.Number.annotate({
+		title: "Render timeout (ms)",
+		description: "Maximum time to wait for a page to finish rendering before giving up."
+	})),
+	/**
+	* Render pages in a focused (foreground) tab. Helps sites that defer loading when backgrounded,
+	* at the cost of stealing focus. Defaults to `false`.
+	*/
+	renderActiveTab: Schema.optional(Schema.Boolean.annotate({
+		title: "Render in focused tab",
+		description: "Render pages in a focused tab; helps sites that defer loading when backgrounded."
+	})),
+	/**
+	* Enable verbose logging and debug previews in the extension. Defaults to `false`.
+	*/
+	developerMode: Schema.optional(Schema.Boolean.annotate({
+		title: "Developer mode",
+		description: "Enable verbose logging and debug previews in the browser extension."
+	}))
+}).mapFields(Struct.map(Schema.mutableKey));
+/**
+* Default values applied when a field is absent. Kept separate from the
+* schema so `createKvsStore` can store only user-set values while consumers
+* (this plugin's components, and any downstream reader) see sensible
+* defaults.
+*/
+var defaults = {
+	enabled: true,
+	autoOpenAfterClip: false,
+	renderProxyEnabled: true,
+	renderTimeout: 2e4,
+	renderActiveTab: false,
+	developerMode: false
+};
+var withDefaults = (settings) => ({
+	...defaults,
+	...settings
+});
+//#endregion
+export { Settings, defaults, Settings_exports as t, withDefaults };
+
+//# sourceMappingURL=Settings.mjs.map

package/dist/lib/Settings.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Settings.mjs","names":[],"sources":["../../src/types/Settings.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\nimport * as Struct from 'effect/Struct';\n\n/**\n * User preferences that govern how Composer coordinates with the composer-crx\n * browser extension — both the page-actions bridge and the render-proxy. All fields\n * are optional; defaults are applied by consumers when reading the atom.\n */\nexport const Settings = Schema.Struct({\n  /**\n   * Master toggle. When false, the bridge plugin ignores incoming extension actions.\n   * Defaults to `true`.\n   */\n  enabled: Schema.optional(\n    Schema.Boolean.annotate({\n      title: 'Accept extension actions',\n      description: 'When off, actions sent from the composer-crx browser extension are ignored.',\n    }),\n  ),\n\n  /**\n   * Navigate to the created object after the extension creates one. Defaults to\n   * `false` to avoid yanking focus during active work.\n   */\n  autoOpenAfterClip: Schema.optional(\n    Schema.Boolean.annotate({\n      title: 'Open after action',\n      description: 'Navigate to the created object when the extension creates one.',\n    }),\n  ),\n\n  /**\n   * Master toggle. When false, plugins fall back to the edge HTTP proxy instead of asking the\n   * extension to render pages. Defaults to `true`.\n   */\n  renderProxyEnabled: Schema.optional(\n    Schema.Boolean.annotate({\n      title: 'Use extension to render pages',\n      description: 'Let plugins render pages via the browser extension to scrape client-rendered sites.',\n    }),\n  ),\n\n  /**\n   * Maximum time (ms) to wait for a page to render before aborting. Defaults to `20000`.\n   */\n  renderTimeout: Schema.optional(\n    Schema.Number.annotate({\n      title: 'Render timeout (ms)',\n      description: 'Maximum time to wait for a page to finish rendering before giving up.',\n    }),\n  ),\n\n  /**\n   * Render pages in a focused (foreground) tab. Helps sites that defer loading when backgrounded,\n   * at the cost of stealing focus. Defaults to `false`.\n   */\n  renderActiveTab: Schema.optional(\n    Schema.Boolean.annotate({\n      title: 'Render in focused tab',\n      description: 'Render pages in a focused tab; helps sites that defer loading when backgrounded.',\n    }),\n  ),\n\n  /**\n   * Enable verbose logging and debug previews in the extension. Defaults to `false`.\n   */\n  developerMode: Schema.optional(\n    Schema.Boolean.annotate({\n      title: 'Developer mode',\n      description: 'Enable verbose logging and debug previews in the browser extension.',\n    }),\n  ),\n}).mapFields(Struct.map(Schema.mutableKey));\n\nexport interface Settings extends Schema.Schema.Type<typeof Settings> {}\n\n/**\n * Default values applied when a field is absent. Kept separate from the\n * schema so `createKvsStore` can store only user-set values while consumers\n * (this plugin's components, and any downstream reader) see sensible\n * defaults.\n */\nexport const defaults: Required<Settings> = {\n  enabled: true,\n  autoOpenAfterClip: false,\n  renderProxyEnabled: true,\n  renderTimeout: 20_000,\n  renderActiveTab: false,\n  developerMode: false,\n};\n\nexport const withDefaults = (settings: Settings): Required<Settings> => ({\n  ...defaults,\n  ...settings,\n});\n"],"mappings":";;;;;;;;;;;;;;AAcA,IAAa,WAAW,OAAO,OAAO;;;;;CAKpC,SAAS,OAAO,SACd,OAAO,QAAQ,SAAS;EACtB,OAAO;EACP,aAAa;CACf,CAAC,CACH;;;;;CAMA,mBAAmB,OAAO,SACxB,OAAO,QAAQ,SAAS;EACtB,OAAO;EACP,aAAa;CACf,CAAC,CACH;;;;;CAMA,oBAAoB,OAAO,SACzB,OAAO,QAAQ,SAAS;EACtB,OAAO;EACP,aAAa;CACf,CAAC,CACH;;;;CAKA,eAAe,OAAO,SACpB,OAAO,OAAO,SAAS;EACrB,OAAO;EACP,aAAa;CACf,CAAC,CACH;;;;;CAMA,iBAAiB,OAAO,SACtB,OAAO,QAAQ,SAAS;EACtB,OAAO;EACP,aAAa;CACf,CAAC,CACH;;;;CAKA,eAAe,OAAO,SACpB,OAAO,QAAQ,SAAS;EACtB,OAAO;EACP,aAAa;CACf,CAAC,CACH;AACF,CAAC,CAAC,CAAC,UAAU,OAAO,IAAI,OAAO,UAAU,CAAC;;;;;;;AAU1C,IAAa,WAA+B;CAC1C,SAAS;CACT,mBAAmB;CACnB,oBAAoB;CACpB,eAAe;CACf,iBAAiB;CACjB,eAAe;AACjB;AAEA,IAAa,gBAAgB,cAA4C;CACvE,GAAG;CACH,GAAG;AACL"}

package/dist/lib/capabilities.mjs

@@ -0,0 +1,41 @@
+import * as ActivationEvents from "@dxos/app-framework/ActivationEvents";
+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 { CrxCapabilities, CrxEvents } from "#types";
+import { meta } from "#meta";
+//#region PLUGIN.mdl?raw
+var PLUGIN_default = "---\nid: org.dxos.plugin.crx\nname: CrxPlugin\nversion: 0.3.0\n---\n\nCoordinates with the `@dxos/composer-crx` browser extension. Owns the Composer\nside of the page-actions bridge: plugins contribute page actions (serializable\ndescriptor + target operation) under a plugin-scoped capability; the extension\ncaches the descriptors in its registry and invokes them over same-origin\n`window` `CustomEvent`s. This plugin answers registry-list requests, validates\ninvoke requests, resolves the active space, executes the target operation, and\nsurfaces outcomes as toasts. It also contributes three picker actions\n(Person, Organization, Note) whose operations map a page snapshot to an ECHO\nobject, and owns the user-facing settings surface — including the render-proxy\nsettings (absorbed from the retired plugin-extension) for the extension's\npage-rendering facility.\n\nThe extension owns the DOM picker, popup toolbar, extractors, and bridge\nsender; this plugin owns envelope validation, snapshot → ECHO object mapping,\nand user feedback (toast). The extension keeps a hand-validated mirror of the\nwire types at `packages/apps/composer-crx/src/page-actions/types.ts` which\nmust be updated in lockstep.\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| `scenario` | `org.dxos.mdl.scenario@1.0`    |\n| `test` | `org.dxos.mdl.test@1.0`        |\n\n## Types\n\n```mdl\ntype Settings\n  desc: |\n    User preferences for extension ↔ Composer coordination, persisted via the\n    app-framework settings store. Only user-set values are stored; defaults\n    are applied by consumers when reading the atom. All fields are optional.\n    The fields are a configuration surface; enforcement is owned by whichever\n    consumer reads the atom.\n  fields:\n    enabled?: boolean             # default: true. \"Accept extension actions\" preference.\n    autoOpenAfterClip?: boolean   # default: false. \"Open after action\" preference.\n    renderProxyEnabled?: boolean  # default: true. \"Use extension to render pages\" preference.\n    renderTimeout?: number        # default: 20000. Max ms to wait for a render.\n    renderActiveTab?: boolean     # default: false. Render in a focused tab.\n    developerMode?: boolean       # default: false. Verbose logging / previews.\n```\n\n```mdl\ntype Source\n  fields:\n    url: string\n    title: string\n    favicon?: string\n    clippedAt: string           # ISO timestamp\n```\n\n```mdl\ntype Selection\n  fields:\n    text: string                # innerText of the picked subtree\n    html?: string               # outerHTML, possibly truncated\n    htmlTruncated?: boolean\n    rect?: { x: number, y: number, width: number, height: number }\n```\n\n```mdl\ntype Hints\n  desc: |\n    Cheap signals harvested from the whole page at capture time. The mappings\n    use a subset (h1, og:title, og:description, og:image) as fallbacks; a\n    future agent stage may interpret all of them.\n  fields:\n    ogTitle?: string\n    ogDescription?: string\n    ogImage?: string\n    jsonLd?: unknown[]\n    h1?: string\n    firstImage?: string\n```\n\n```mdl\ntype Snapshot\n  desc: |\n    Generic page capture produced by the extension's `snapshot` extractor.\n    Travels as the `inputs` of an invoke request.\n  fields:\n    source: Source\n    selection?: Selection\n    hints?: Hints\n    imageData?: string          # downscaled primary-image thumbnail (data URL),\n                                # captured by the extension's background worker\n    html?: string\n    htmlTruncated?: boolean\n```\n\n```mdl\ntype PageActionDescriptor\n  desc: |\n    Serializable descriptor for a plugin-contributed page action, synced to\n    the extension's registry cache. Invocation is correlated by `id`.\n  fields:\n    id: string                  # stable plugin-scoped action id\n    label: string               # human-readable action name\n    icon: string                # phosphor icon identifier\n    urlPatterns: string[]       # match patterns the action applies to\n    predicate?: { exists: string }  # lazy DOM condition (CSS selector)\n    extractor: { name: string, params?: unknown }  # extension-bundled extractor\n    contexts: string[]          # surfaces: popup | page | selection | link | picker\n    operation: string           # operation key, display/diagnostics only\n```\n\n```mdl\ntype PageAction\n  desc: |\n    A live page-action contribution: the descriptor fields plus the actual\n    operation definition (serialized to its key string when listed). The\n    target operation must accept `{ snapshot: Snapshot, target: Database }`\n    and return `{ id: string }`.\n```\n\n```mdl\ntype ListRequest\n  desc: |\n    Sent by the extension as `composer:page-actions:list`; acked as\n    `composer:page-actions:list:ack`.\n  fields:\n    version: number             # runtime check: only 1 is supported\n    id: string                  # correlation id, echoed in the ack\n```\n\n```mdl\ntype ListAck\n  fields:\n    version: number             # always 1\n    id: string\n    ok: boolean\n    actions?: PageActionDescriptor[]  # when ok = true\n    error?: string              # stable error code when ok = false\n```\n\n```mdl\ntype InvokeRequest\n  desc: |\n    Sent by the extension as `composer:page-action:invoke`; acked as\n    `composer:page-action:invoke:ack`. Decoded in two passes: a loose\n    envelope ({ version, id? }) first, so newer versions yield\n    `unsupportedVersion` rather than the generic `invalidPayload` and\n    malformed payloads can still echo the request id.\n  fields:\n    version: number             # runtime check: only 1 is supported\n    id: string                  # correlation id, echoed in the ack\n    actionId: string            # id of the registered action to invoke\n    page: { url: string, title: string, favicon?: string }\n    inputs: unknown             # extractor output; `snapshot` yields Snapshot\n    invokedFrom: popup | contextMenu | picker\n```\n\n```mdl\ntype InvokeAck\n  fields:\n    version: number             # always 1\n    id: string\n    ok: boolean\n    objectId?: string           # ID of the created object when ok = true\n    error?: string              # stable error code when ok = false:\n                                #   invalidPayload | unsupportedVersion |\n                                #   unknownAction | noSpace | operationFailed\n```\n\n## Features\n\n```mdl\nfeat F-1: Settings Capability\n\n  req F-1.1:\n    when: plugin is activated\n    then: |\n      a single `Settings` atom is registered under a plugin-scoped capability\n      and contributed to `AppCapabilities.Settings` so the standard settings\n      UI surfaces it.\n\n  req F-1.2:\n    when: another plugin reads the capability\n    then: it receives the current Settings with defaults applied\n```\n\n```mdl\nfeat F-2: Settings Surface\n\n  req F-2.1:\n    when: the app-framework settings panel renders the CRX section\n    then: |\n      a schema-driven form is shown covering all Settings fields, wired to\n      the Settings atom and persisted on change.\n\n  req F-2.2:\n    when: the user presses the Test connection button\n    then: |\n      a ping round-trips over the page → content-script → background path and\n      reports the extension's name and version on success, or the failure\n      reason otherwise.\n```\n\n```mdl\nfeat F-2c: Settings Enforcement\n\n  req F-2c.1:\n    when: `enabled` is false and a page-action invoke arrives\n    then: |\n      no object is created; the request is still acked (so the extension does\n      not time out) with the stable error code `disabled`\n\n  req F-2c.2:\n    when: `autoOpenAfterClip` is true and a page action succeeds\n    then: the created object is opened via LayoutOperation.Open\n\n  req F-2c.3:\n    when: `autoOpenAfterClip` is false (default)\n    then: focus is not moved; only the success toast is shown\n```\n\n```mdl\nfeat F-3: Page Action Contributions\n  desc: |\n    Plugins contribute `PageAction[]` under the plugin-scoped\n    `CrxCapabilities.PageAction` capability. Other plugins contribute their\n    own actions the same way (e.g. plugin-bookmarks contributes\n    \"Add bookmark\").\n\n  req F-3.1:\n    when: plugin is activated\n    then: |\n      three picker-only actions are contributed — Person, Organization, and\n      Note — each matching `http(s)://*/*`, using the extension-bundled\n      `snapshot` extractor, and targeting the corresponding\n      AddPersonFromSnapshot / AddOrganizationFromSnapshot /\n      AddNoteFromSnapshot operation.\n\n  req F-3.2:\n    when: the extension lists actions\n    then: |\n      contributions are resolved per-request, so actions from\n      late-activating plugins are included.\n```\n\n```mdl\nfeat F-4: Registry Listing\n\n  req F-4.1:\n    when: plugin is activated\n    then: |\n      window event listeners for `composer:page-actions:list` and\n      `composer:page-action:invoke` are installed, and a\n      `composer:page-actions:ready` event is dispatched so the extension\n      relay can refresh its registry even when Composer boots after the\n      content script has already installed.\n\n  req F-4.2:\n    when: a valid list request arrives\n    then: |\n      the ack carries the currently contributed actions as serializable\n      descriptors, with `operation` serialized to the operation's key string.\n\n  req F-4.3:\n    when: a list request fails schema decoding\n    then: |\n      the ack is { ok: false, error: 'invalidPayload' } with a best-effort\n      echo of the request id so the extension can correlate the failure.\n```\n\n```mdl\nfeat F-5: Invoke Validation & Dispatch\n\n  req F-5.1:\n    when: an invoke request's envelope fails decoding\n    then: ack is { ok: false, error: 'invalidPayload' } and nothing is invoked\n\n  req F-5.2:\n    when: the envelope has a version other than 1\n    then: |\n      ack is { ok: false, error: 'unsupportedVersion' } with the request id\n      echoed when present.\n\n  req F-5.3:\n    when: the strict payload fails decoding\n    then: ack is { ok: false, error: 'invalidPayload' }\n\n  req F-5.4:\n    when: `actionId` matches no registered action\n    then: ack is { ok: false, error: 'unknownAction' }\n\n  req F-5.5:\n    when: the active space cannot be determined\n    then: nothing is invoked; ack is { ok: false, error: 'noSpace' }\n\n  req F-5.6:\n    when: the request resolves to an action and an active space\n    then: |\n      the action's operation is invoked with\n      { snapshot: inputs, target: activeSpace.db }; on success the ack is\n      { ok: true, objectId } carrying the created object's id.\n\n  req F-5.7:\n    when: the operation returns an error or throws\n    then: ack is { ok: false, error: 'operationFailed' }\n```\n\n```mdl\nfeat F-6: Snapshot → Object Mapping\n  desc: |\n    Each contributed operation maps a Snapshot to an ECHO object and adds it\n    to the target database via SpaceOperation.AddObject.\n\n  req F-6.1:\n    when: AddPersonFromSnapshot is invoked\n    then: |\n      a Person is created with best-effort fields:\n        fullName  ← hints.h1 ?? hints.ogTitle ?? firstLine(selection.text)\n        image     ← hints.ogImage\n        notes     ← selection.text (truncated to 4000 chars)\n        urls      ← [{ label: source.title || source.url, value: source.url }]\n\n  req F-6.2:\n    when: AddOrganizationFromSnapshot is invoked\n    then: |\n      an Organization is created with best-effort fields:\n        name        ← hints.ogTitle ?? hints.h1 ?? firstLine(selection.text)\n        description ← hints.ogDescription ?? selection.text (truncated)\n        image       ← hints.ogImage\n        website     ← source.url\n\n  req F-6.3:\n    when: AddNoteFromSnapshot is invoked\n    then: |\n      a Markdown document is created with a small prelude (title, source\n      link, timestamp) followed by the selection's rendered text (truncated\n      to 50000 chars). The title falls back through\n      hints.h1 ?? hints.ogTitle ?? firstLine(selection.text) ?? source.title.\n\n  req F-6.4:\n    when: there is no name/title candidate\n    then: the object is still created; empty name is acceptable\n```\n\n```mdl\nfeat F-7: User Feedback\n\n  req F-7.1:\n    when: an invoke ack is produced with ok = true\n    then: a success toast is shown\n\n  req F-7.2:\n    when: an invoke ack is produced with ok = false\n    then: an error toast is shown naming the stable error code\n```\n\n```mdl\nfeat F-8: Page Actions Registry & Invocation\n  desc: |\n    Plugins contribute page actions (serializable descriptor + target\n    operation) under a plugin-scoped capability. This plugin answers the\n    extension's registry-list requests (`composer:page-actions:list`) with\n    descriptors and executes invoke requests (`composer:page-action:invoke`)\n    by resolving the active space and invoking the target operation with\n    `{ snapshot, target }`. Every request is acked with stable error codes\n    (invalidPayload, unsupportedVersion, disabled, unknownAction, noSpace,\n    operationFailed); outcomes surface as toasts.\n```\n\n## Acceptance\n\n```mdl\nscenario T-1: Settings atom registered\n  given: plugin activated\n  then:\n    - the Settings capability is available via Capability.get\n    - the default atom value is { enabled: true, autoOpenAfterClip: false,\n      renderProxyEnabled: true, renderTimeout: 20000, renderActiveTab: false,\n      developerMode: false }\n```\n\n```mdl\nscenario T-2: Toggling enabled persists\n  given: settings surface rendered\n  when: user toggles the `enabled` switch off\n  then: subsequent reads of the atom observe enabled === false\n```\n\n```mdl\nscenario T-3: List request returns descriptors\n  given: contributed picker actions (Person, Organization, Note)\n  when: handleListEvent receives { version: 1, id: 'r1' }\n  then:\n    - ack is { ok: true, id: 'r1' }\n    - ack.actions contains one descriptor per action with `operation`\n      serialized to the operation key string\n```\n\n```mdl\nscenario T-4: Invalid list request is rejected\n  given: page-actions listeners installed\n  when: handleListEvent receives a malformed detail (missing id)\n  then: ack is { ok: false, error: 'invalidPayload' }\n```\n\n```mdl\nscenario T-5: Valid person invoke creates Person\n  given: a registered add-person action and an active space\n  when: |\n    handleInvokeEvent receives { version: 1, actionId: <add-person>,\n    inputs: snapshot } with snapshot.hints.h1 = 'Jane Doe'\n  then:\n    - a Person is created with fullName = 'Jane Doe'\n    - ack is { ok: true, objectId: <non-empty> }\n    - a success toast is shown\n```\n\n```mdl\nscenario T-6: Organization mapping falls back to og:title\n  given: a snapshot with hints.ogTitle = 'DXOS' and hints.h1 undefined\n  when: AddOrganizationFromSnapshot is invoked\n  then:\n    - Organization.name === 'DXOS'\n    - Organization.website === source.url\n```\n\n```mdl\nscenario T-7: Missing name is allowed\n  given: a snapshot with no hints and empty selection text\n  when: the add-person action is invoked\n  then:\n    - a Person is created (empty fullName)\n    - ack is { ok: true, objectId: <non-empty> }\n```\n\n```mdl\nscenario T-8: Unsupported envelope version\n  given: page-actions listeners installed\n  when: handleInvokeEvent receives { version: 2, id: 'r2', ... }\n  then:\n    - nothing is invoked\n    - ack is { ok: false, id: 'r2', error: 'unsupportedVersion' }\n```\n\n```mdl\nscenario T-9: Invalid invoke payload is rejected\n  given: page-actions listeners installed\n  when: handleInvokeEvent receives a version-1 detail missing `actionId`\n  then:\n    - nothing is invoked\n    - ack is { ok: false, error: 'invalidPayload' } with the envelope id echoed\n```\n\n```mdl\nscenario T-10: Unknown action\n  given: no action registered with id 'nope'\n  when: handleInvokeEvent receives a valid request with actionId = 'nope'\n  then: ack is { ok: false, error: 'unknownAction' }\n```\n\n```mdl\nscenario T-11: No active space\n  given: the active space cannot be resolved\n  when: a valid invoke request arrives\n  then:\n    - nothing is invoked\n    - ack is { ok: false, error: 'noSpace' }\n```\n\n```mdl\nscenario T-12: Operation failure\n  given: the target operation returns an error (or throws)\n  when: a valid invoke request arrives\n  then:\n    - ack is { ok: false, error: 'operationFailed' }\n    - an error toast is shown\n```\n\n---\n\n## QA\n\nExecutable tests. Each step carries a human instruction (`do`) and, where the step maps to an\ninvocable operation, an agent binding (`invoke`). Report failures by test and step number.\n\nNote: this document declares no `op` blocks, so the operations below are referenced by their full\nruntime key rather than `[op:...]` — see `src/types/CrxOperation.ts`.\n\n```mdl\ntest QA-1: Add a Person from a page snapshot\n  desc: |\n    The core snapshot → object mapping (F-6.1), standing in for the browser extension's picker,\n    which an agent cannot drive — the extension is a separate, unautomatable browser process. This\n    test invokes the target operation directly with a synthetic snapshot, exactly as the plugin's\n    own invoke handler does after resolving `{ snapshot, target }` (F-5.6).\n  actors: agent\n  covers: [F-3.1, F-5.6, F-6.1, T-5]\n  status: unverified\n  given:\n    - an identity exists\n    - space: a space is open\n    - plugin-crx is enabled — it is OFF by default (not in `getDefaults` and not in the dev-only\n      default set; see `packages/apps/composer-app/src/plugin-defs.tsx`)\n    - no Person named \"QA Snapshot Person\" exists — ABORT rather than reusing one this test did\n      not create\n  steps:\n    - name: Add the person from a snapshot\n      do: |\n        (Real path, not automatable here: with the extension installed, open the popup on a page\n        and choose the \"Person\" picker action, then select the page region to capture.)\n      invoke: |\n        org.dxos.operation.crx.addPersonFromSnapshot {\n          snapshot: { source: { url: \"https://example.com/qa\", title: \"QA Page\", clippedAt: \"2026-08-27T00:00:00.000Z\" },\n                      hints: { h1: \"QA Snapshot Person\" } },\n          target: $given.space.db\n        }\n      capture: created\n      expect: a Person named \"QA Snapshot Person\" now exists in the space\n      assert: return !!$created.id\n  after:\n    - name: Delete the Person\n      do: Right-click \"QA Snapshot Person\" in the navtree and choose Delete.\n      invoke: org.dxos.operation.space.removeObjects { objects: [{ \"/\": \"echo://$given.space.id/\" + $created.id }], target: $given.space }\n      expect: the row leaves the navtree\n      note: |\n        `addPersonFromSnapshot` returns a bare `id`, not a live ref, so the DXN envelope is built\n        by hand for the removal call — see Rule 4 in `op@1.1`'s parent doc about resolving by the\n        invoker path rather than guessing a shortcut.\n```\n\n```mdl\ntest QA-2: Accept-extension-actions toggle gates invocation\n  desc: |\n    The settings enforcement path (F-2c.1) — no operation exists for the settings atom itself\n    (it is a plain app-framework settings store), so this step is human-only.\n  actors: human\n  covers: [F-1.1, F-2.1, F-2c.1]\n  status: unverified\n  given:\n    - an identity exists\n    - plugin-crx is enabled — it is OFF by default (see QA-1)\n    - the Settings panel's CRX section is reachable\n  steps:\n    - name: Disable \"Accept extension actions\"\n      do: Open Settings, find the CRX section, and toggle \"Accept extension actions\" off.\n      expect: the toggle shows off and the preference persists across a reload\n      note: |\n        NO `invoke` — the Settings atom has no operation binding; per F-2c.1, an invoke request\n        that arrives while this is off is still acked (error `disabled`), which requires the\n        extension itself to exercise and cannot be driven from the debug port alone.\n  after:\n    - name: Re-enable \"Accept extension actions\"\n      do: Toggle \"Accept extension actions\" back on.\n      expect: the toggle shows on again\n```\n\n---\n\n## Appendix: Extension Definitions\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\n    literals?: UnionList\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\n```\n\n```mdl\next scenario\n  uri: org.dxos.mdl.scenario@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";
+//#endregion
+//#region src/capabilities/index.ts
+var CrxSettings = AppCapability.settings(() => import("./chunk-settings.mjs"), {
+	activatesOn: ActivationEvents.Idle,
+	provides: [CrxCapabilities.Settings]
+});
+var InstallPageActions = Capability.lazyModule("InstallPageActions", {
+	requires: [
+		Capabilities.OperationInvoker,
+		Capabilities.AtomRegistry,
+		CrxCapabilities.Settings
+	],
+	provides: [],
+	activatesOn: CrxEvents.Start
+}, () => import("./chunk-install-page-actions.mjs"));
+var OperationHandler = AppCapability.operationHandler(() => import("./chunk-operation-handler.mjs"), { activatesOn: ActivationEvents.Idle });
+var PageActionProvider = Capability.lazyModule("PageActionProvider", {
+	provides: [CrxCapabilities.PageAction],
+	activatesOn: CrxEvents.Start
+}, () => import("./chunk-page-action-provider.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"] });
+var Translations = AppCapability.translations(translations);
+//#endregion
+export { CrxSettings, InstallPageActions, OperationHandler, PageActionProvider, PluginAsset, ReactSurface, Translations };
+
+//# sourceMappingURL=capabilities.mjs.map

package/dist/lib/capabilities.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.mjs","names":[],"sources":["../../src/capabilities/index.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as ActivationEvents from '@dxos/app-framework/ActivationEvents';\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 { meta } from '#meta';\nimport { translations } from '#translations';\nimport { CrxCapabilities, CrxEvents } from '#types';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../../PLUGIN.mdl?raw';\n\nexport const CrxSettings = AppCapability.settings(() => import('./settings.ts'), {\n  activatesOn: ActivationEvents.Idle,\n  provides: [CrxCapabilities.Settings],\n});\nexport const InstallPageActions = Capability.lazyModule(\n  'InstallPageActions',\n  {\n    requires: [Capabilities.OperationInvoker, Capabilities.AtomRegistry, CrxCapabilities.Settings],\n    provides: [],\n    activatesOn: CrxEvents.Start,\n  },\n  () => import('./install-page-actions.ts'),\n);\nexport const OperationHandler = AppCapability.operationHandler(() => import('./operation-handler.ts'), {\n  activatesOn: ActivationEvents.Idle,\n});\nexport const PageActionProvider = Capability.lazyModule(\n  'PageActionProvider',\n  { provides: [CrxCapabilities.PageAction], activatesOn: CrxEvents.Start },\n  () => import('./page-action-provider.ts'),\n);\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.ts'), {\n  roles: ['org.dxos.role.article'],\n});\nexport const Translations = AppCapability.translations(translations);\n"],"mappings":";;;;;;;;;;;AAgBA,IAAa,cAAc,cAAc,eAAe,OAAO,yBAAkB;CAC/E,aAAa,iBAAiB;CAC9B,UAAU,CAAC,gBAAgB,QAAQ;AACrC,CAAC;AACD,IAAa,qBAAqB,WAAW,WAC3C,sBACA;CACE,UAAU;EAAC,aAAa;EAAkB,aAAa;EAAc,gBAAgB;CAAQ;CAC7F,UAAU,CAAC;CACX,aAAa,UAAU;AACzB,SACM,OAAO,mCACf;AACA,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAA2B,EACrG,aAAa,iBAAiB,KAChC,CAAC;AACD,IAAa,qBAAqB,WAAW,WAC3C,sBACA;CAAE,UAAU,CAAC,gBAAgB,UAAU;CAAG,aAAa,UAAU;AAAM,SACjE,OAAO,mCACf;AACA,IAAa,cAAc,cAAc,YAAY;CACnD,UAAU,KAAK,QAAQ;CACvB,MAAM;CACN,SAAS;CACT,UAAU;AACZ,CAAC;AACD,IAAa,eAAe,cAAc,cAAc,OAAO,8BAAuB,EACpF,OAAO,CAAC,uBAAuB,EACjC,CAAC;AACD,IAAa,eAAe,cAAc,aAAa,YAAY"}

package/dist/lib/capabilities.node.mjs

@@ -0,0 +1,32 @@
+import * as ActivationEvents from "@dxos/app-framework/ActivationEvents";
+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 { CrxCapabilities, CrxEvents } from "#types";
+//#region src/capabilities/gen/node.ts
+var CrxSettings = AppCapability.settings(() => import("./chunk-settings.mjs"), {
+	activatesOn: ActivationEvents.Idle,
+	provides: [CrxCapabilities.Settings]
+});
+var InstallPageActions = Capability.lazyModule("InstallPageActions", {
+	requires: [
+		Capabilities.OperationInvoker,
+		Capabilities.AtomRegistry,
+		CrxCapabilities.Settings
+	],
+	provides: [],
+	activatesOn: CrxEvents.Start
+}, () => import("./chunk-install-page-actions.mjs"));
+var OperationHandler = AppCapability.operationHandler(() => import("./chunk-operation-handler.mjs"), { activatesOn: ActivationEvents.Idle });
+var PageActionProvider = Capability.lazyModule("PageActionProvider", {
+	provides: [CrxCapabilities.PageAction],
+	activatesOn: CrxEvents.Start
+}, () => import("./chunk-page-action-provider.mjs"));
+var Translations = AppCapability.translations(translations);
+var PluginAsset = void 0;
+var ReactSurface = void 0;
+//#endregion
+export { CrxSettings, InstallPageActions, OperationHandler, PageActionProvider, PluginAsset, ReactSurface, Translations };
+
+//# 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 ActivationEvents from '@dxos/app-framework/ActivationEvents';\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 { CrxCapabilities, CrxEvents } from '#types';\n\nexport const CrxSettings = AppCapability.settings(() => import('../settings.ts'), {\n  activatesOn: ActivationEvents.Idle,\n  provides: [CrxCapabilities.Settings],\n});\n\nexport const InstallPageActions = Capability.lazyModule(\n  'InstallPageActions',\n  {\n    requires: [Capabilities.OperationInvoker, Capabilities.AtomRegistry, CrxCapabilities.Settings],\n    provides: [],\n    activatesOn: CrxEvents.Start,\n  },\n  () => import('../install-page-actions.ts'),\n);\n\nexport const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler.ts'), {\n  activatesOn: ActivationEvents.Idle,\n});\n\nexport const PageActionProvider = Capability.lazyModule(\n  'PageActionProvider',\n  { provides: [CrxCapabilities.PageAction], activatesOn: CrxEvents.Start },\n  () => import('../page-action-provider.ts'),\n);\n\nexport const Translations = AppCapability.translations(translations);\n\nexport const PluginAsset = undefined;\nexport const ReactSurface = undefined;\n"],"mappings":";;;;;;;AAcA,IAAa,cAAc,cAAc,eAAe,OAAO,yBAAmB;CAChF,aAAa,iBAAiB;CAC9B,UAAU,CAAC,gBAAgB,QAAQ;AACrC,CAAC;AAED,IAAa,qBAAqB,WAAW,WAC3C,sBACA;CACE,UAAU;EAAC,aAAa;EAAkB,aAAa;EAAc,gBAAgB;CAAQ;CAC7F,UAAU,CAAC;CACX,aAAa,UAAU;AACzB,SACM,OAAO,mCACf;AAEA,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAA4B,EACtG,aAAa,iBAAiB,KAChC,CAAC;AAED,IAAa,qBAAqB,WAAW,WAC3C,sBACA;CAAE,UAAU,CAAC,gBAAgB,UAAU;CAAG,aAAa,UAAU;AAAM,SACjE,OAAO,mCACf;AAEA,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,cAAc,KAAA;AAC3B,IAAa,eAAe,KAAA"}

package/dist/lib/capabilities.workerd.mjs

@@ -0,0 +1,32 @@
+import * as ActivationEvents from "@dxos/app-framework/ActivationEvents";
+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 { CrxCapabilities, CrxEvents } from "#types";
+//#region src/capabilities/gen/workerd.ts
+var CrxSettings = AppCapability.settings(() => import("./chunk-settings.mjs"), {
+	activatesOn: ActivationEvents.Idle,
+	provides: [CrxCapabilities.Settings]
+});
+var InstallPageActions = Capability.lazyModule("InstallPageActions", {
+	requires: [
+		Capabilities.OperationInvoker,
+		Capabilities.AtomRegistry,
+		CrxCapabilities.Settings
+	],
+	provides: [],
+	activatesOn: CrxEvents.Start
+}, () => import("./chunk-install-page-actions.mjs"));
+var OperationHandler = AppCapability.operationHandler(() => import("./chunk-operation-handler.mjs"), { activatesOn: ActivationEvents.Idle });
+var PageActionProvider = Capability.lazyModule("PageActionProvider", {
+	provides: [CrxCapabilities.PageAction],
+	activatesOn: CrxEvents.Start
+}, () => import("./chunk-page-action-provider.mjs"));
+var Translations = AppCapability.translations(translations);
+var PluginAsset = void 0;
+var ReactSurface = void 0;
+//#endregion
+export { CrxSettings, InstallPageActions, OperationHandler, PageActionProvider, PluginAsset, ReactSurface, Translations };
+
+//# 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 ActivationEvents from '@dxos/app-framework/ActivationEvents';\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 { CrxCapabilities, CrxEvents } from '#types';\n\nexport const CrxSettings = AppCapability.settings(() => import('../settings.ts'), {\n  activatesOn: ActivationEvents.Idle,\n  provides: [CrxCapabilities.Settings],\n});\n\nexport const InstallPageActions = Capability.lazyModule(\n  'InstallPageActions',\n  {\n    requires: [Capabilities.OperationInvoker, Capabilities.AtomRegistry, CrxCapabilities.Settings],\n    provides: [],\n    activatesOn: CrxEvents.Start,\n  },\n  () => import('../install-page-actions.ts'),\n);\n\nexport const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler.ts'), {\n  activatesOn: ActivationEvents.Idle,\n});\n\nexport const PageActionProvider = Capability.lazyModule(\n  'PageActionProvider',\n  { provides: [CrxCapabilities.PageAction], activatesOn: CrxEvents.Start },\n  () => import('../page-action-provider.ts'),\n);\n\nexport const Translations = AppCapability.translations(translations);\n\nexport const PluginAsset = undefined;\nexport const ReactSurface = undefined;\n"],"mappings":";;;;;;;AAcA,IAAa,cAAc,cAAc,eAAe,OAAO,yBAAmB;CAChF,aAAa,iBAAiB;CAC9B,UAAU,CAAC,gBAAgB,QAAQ;AACrC,CAAC;AAED,IAAa,qBAAqB,WAAW,WAC3C,sBACA;CACE,UAAU;EAAC,aAAa;EAAkB,aAAa;EAAc,gBAAgB;CAAQ;CAC7F,UAAU,CAAC;CACX,aAAa,UAAU;AACzB,SACM,OAAO,mCACf;AAEA,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAA4B,EACtG,aAAa,iBAAiB,KAChC,CAAC;AAED,IAAa,qBAAqB,WAAW,WAC3C,sBACA;CAAE,UAAU,CAAC,gBAAgB,UAAU;CAAG,aAAa,UAAU;AAAM,SACjE,OAAO,mCACf;AAEA,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,cAAc,KAAA;AAC3B,IAAa,eAAe,KAAA"}

package/dist/lib/chunk-add-note-from-snapshot.mjs

@@ -0,0 +1,15 @@
+import { t as toNote } from "./chunk-mapping.mjs";
+import { CrxOperation } from "#types";
+import * as Operation from "@dxos/compute/Operation";
+import * as Effect from "effect/Effect";
+import * as SpaceOperation from "@dxos/plugin-space/SpaceOperation";
+//#region src/operations/add-note-from-snapshot.ts
+var handler = CrxOperation.AddNoteFromSnapshot.pipe(Operation.withHandler(Effect.fn(function* ({ snapshot, target }) {
+	const note = toNote(snapshot);
+	const { id } = yield* Operation.invoke(SpaceOperation.AddObject, { object: note }, { spaceId: target.spaceId });
+	return { id };
+})));
+//#endregion
+export { handler as default };
+
+//# sourceMappingURL=chunk-add-note-from-snapshot.mjs.map

package/dist/lib/chunk-add-note-from-snapshot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-add-note-from-snapshot.mjs","names":[],"sources":["../../src/operations/add-note-from-snapshot.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport * as Operation from '@dxos/compute/Operation';\nimport * as SpaceOperation from '@dxos/plugin-space/SpaceOperation';\n\nimport { CrxOperation } from '#types';\n\nimport { toNote } from '../mapping.ts';\n\nconst handler: Operation.WithHandler<typeof CrxOperation.AddNoteFromSnapshot> = CrxOperation.AddNoteFromSnapshot.pipe(\n  Operation.withHandler(\n    Effect.fn(function* ({ snapshot, target }) {\n      const note = toNote(snapshot);\n      const { id } = yield* Operation.invoke(SpaceOperation.AddObject, { object: note }, { spaceId: target.spaceId });\n      return { id };\n    }),\n  ),\n);\n\nexport default handler;\n"],"mappings":";;;;;;AAaA,IAAM,UAA0E,aAAa,oBAAoB,KAC/G,UAAU,YACR,OAAO,GAAG,WAAW,EAAE,UAAU,UAAU;CACzC,MAAM,OAAO,OAAO,QAAQ;CAC5B,MAAM,EAAE,OAAO,OAAO,UAAU,OAAO,eAAe,WAAW,EAAE,QAAQ,KAAK,GAAG,EAAE,SAAS,OAAO,QAAQ,CAAC;CAC9G,OAAO,EAAE,GAAG;AACd,CAAC,CACH,CACF"}

package/dist/lib/chunk-add-organization-from-snapshot.mjs

@@ -0,0 +1,15 @@
+import { n as toOrganization } from "./chunk-mapping.mjs";
+import { CrxOperation } from "#types";
+import * as Operation from "@dxos/compute/Operation";
+import * as Effect from "effect/Effect";
+import * as SpaceOperation from "@dxos/plugin-space/SpaceOperation";
+//#region src/operations/add-organization-from-snapshot.ts
+var handler = CrxOperation.AddOrganizationFromSnapshot.pipe(Operation.withHandler(Effect.fn(function* ({ snapshot, target }) {
+	const organization = toOrganization(snapshot);
+	const { id } = yield* Operation.invoke(SpaceOperation.AddObject, { object: organization }, { spaceId: target.spaceId });
+	return { id };
+})));
+//#endregion
+export { handler as default };
+
+//# sourceMappingURL=chunk-add-organization-from-snapshot.mjs.map

package/dist/lib/chunk-add-organization-from-snapshot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-add-organization-from-snapshot.mjs","names":[],"sources":["../../src/operations/add-organization-from-snapshot.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport * as Operation from '@dxos/compute/Operation';\nimport * as SpaceOperation from '@dxos/plugin-space/SpaceOperation';\n\nimport { CrxOperation } from '#types';\n\nimport { toOrganization } from '../mapping.ts';\n\nconst handler: Operation.WithHandler<typeof CrxOperation.AddOrganizationFromSnapshot> =\n  CrxOperation.AddOrganizationFromSnapshot.pipe(\n    Operation.withHandler(\n      Effect.fn(function* ({ snapshot, target }) {\n        const organization = toOrganization(snapshot);\n        const { id } = yield* Operation.invoke(\n          SpaceOperation.AddObject,\n          { object: organization },\n          { spaceId: target.spaceId },\n        );\n        return { id };\n      }),\n    ),\n  );\n\nexport default handler;\n"],"mappings":";;;;;;AAaA,IAAM,UACJ,aAAa,4BAA4B,KACvC,UAAU,YACR,OAAO,GAAG,WAAW,EAAE,UAAU,UAAU;CACzC,MAAM,eAAe,eAAe,QAAQ;CAC5C,MAAM,EAAE,OAAO,OAAO,UAAU,OAC9B,eAAe,WACf,EAAE,QAAQ,aAAa,GACvB,EAAE,SAAS,OAAO,QAAQ,CAC5B;CACA,OAAO,EAAE,GAAG;AACd,CAAC,CACH,CACF"}

package/dist/lib/chunk-add-person-from-snapshot.mjs

@@ -0,0 +1,15 @@
+import { r as toPerson } from "./chunk-mapping.mjs";
+import { CrxOperation } from "#types";
+import * as Operation from "@dxos/compute/Operation";
+import * as Effect from "effect/Effect";
+import * as SpaceOperation from "@dxos/plugin-space/SpaceOperation";
+//#region src/operations/add-person-from-snapshot.ts
+var handler = CrxOperation.AddPersonFromSnapshot.pipe(Operation.withHandler(Effect.fn(function* ({ snapshot, target }) {
+	const person = toPerson(snapshot);
+	const { id } = yield* Operation.invoke(SpaceOperation.AddObject, { object: person }, { spaceId: target.spaceId });
+	return { id };
+})));
+//#endregion
+export { handler as default };
+
+//# sourceMappingURL=chunk-add-person-from-snapshot.mjs.map

package/dist/lib/chunk-add-person-from-snapshot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-add-person-from-snapshot.mjs","names":[],"sources":["../../src/operations/add-person-from-snapshot.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport * as Operation from '@dxos/compute/Operation';\nimport * as SpaceOperation from '@dxos/plugin-space/SpaceOperation';\n\nimport { CrxOperation } from '#types';\n\nimport { toPerson } from '../mapping.ts';\n\nconst handler: Operation.WithHandler<typeof CrxOperation.AddPersonFromSnapshot> =\n  CrxOperation.AddPersonFromSnapshot.pipe(\n    Operation.withHandler(\n      Effect.fn(function* ({ snapshot, target }) {\n        const person = toPerson(snapshot);\n        const { id } = yield* Operation.invoke(\n          SpaceOperation.AddObject,\n          { object: person },\n          { spaceId: target.spaceId },\n        );\n        return { id };\n      }),\n    ),\n  );\n\nexport default handler;\n"],"mappings":";;;;;;AAaA,IAAM,UACJ,aAAa,sBAAsB,KACjC,UAAU,YACR,OAAO,GAAG,WAAW,EAAE,UAAU,UAAU;CACzC,MAAM,SAAS,SAAS,QAAQ;CAChC,MAAM,EAAE,OAAO,OAAO,UAAU,OAC9B,eAAe,WACf,EAAE,QAAQ,OAAO,GACjB,EAAE,SAAS,OAAO,QAAQ,CAC5B;CACA,OAAO,EAAE,GAAG;AACd,CAAC,CACH,CACF"}