@dxos/plugin-conductor 0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264 → 0.13.0

package/PLUGIN.mdl

@@ -15,9 +15,10 @@ Each extension is defined in the Appendix or resolved via its URI.
 |-------------|--------------------------------|
 | `type`      | `org.dxos.mdl.type@1.0`        |
 | `feat`      | `org.dxos.mdl.feat@1.0`        |
-| `test`      | `org.dxos.mdl.test@1.0`        |
+| `scenario`  | `org.dxos.mdl.scenario@1.0`    |
 | `component` | `org.dxos.mdl.component@1.0`   |
 | `op`        | `org.dxos.mdl.op@1.0`          |
+| `test`      | `org.dxos.mdl.test@1.0`        |
 
 ## Types
 
@@ -178,15 +179,6 @@ op ifElseSelect
 
 Effectful operations — mutate persistent state or call external services.
 
-```mdl
-op createComputeGraph
-  desc: Creates a new CanvasBoard with an empty ComputeGraph and adds it to the target space.
-  input:
-    target?: Space | Collection
-  output: string                     # DXN of created CanvasBoard
-  effects: [echo:write]
-```
-
 ```mdl
 op appendToQueue
   desc: Appends items to an ECHO queue or collection identified by DXN.
@@ -323,7 +315,7 @@ feat F-7: Persistence and Collaboration
 ## Acceptance
 
 ```mdl
-test T-1: Create empty graph
+scenario T-1: Create empty graph
   given: user opens the Create Object menu
   when: user selects "Compute Graph"
   then:
@@ -332,7 +324,7 @@ test T-1: Create empty graph
 ```
 
 ```mdl
-test T-2: Add constant node and read value
+scenario T-2: Add constant node and read value
   given: an empty canvas
   when: user adds a constant node, sets value "hello", connects it to a text node
   then:
@@ -341,7 +333,7 @@ test T-2: Add constant node and read value
 ```
 
 ```mdl
-test T-3: Boolean AND gate
+scenario T-3: Boolean AND gate
   given: two switch nodes with values true and false connected to an AND node
   when: graph executes
   then:
@@ -350,7 +342,7 @@ test T-3: Boolean AND gate
 ```
 
 ```mdl
-test T-4: JSONPath transform
+scenario T-4: JSONPath transform
   given: a constant node with value { "a": { "b": 42 } } connected to a json-transform node
   when: expression "$.a.b" is set on the transform node
   then:
@@ -358,7 +350,7 @@ test T-4: JSONPath transform
 ```
 
 ```mdl
-test T-5: GPT node invocation
+scenario T-5: GPT node invocation
   given: a thread node connected to a GPT node with a system prompt
   when: graph executes with AiService available
   then:
@@ -368,7 +360,7 @@ test T-5: GPT node invocation
 ```
 
 ```mdl
-test T-6: Append to queue
+scenario T-6: Append to queue
   given: a make-queue node connected to an append node; constant node provides input items
   when: graph executes
   then:
@@ -377,7 +369,7 @@ test T-6: Append to queue
 ```
 
 ```mdl
-test T-7: Collaborative edit
+scenario T-7: Collaborative edit
   given: two peers have the same CanvasBoard open
   when: peer A moves a node on the canvas
   then:
@@ -386,7 +378,7 @@ test T-7: Collaborative edit
 ```
 
 ```mdl
-test T-8: NotExecuted propagation
+scenario T-8: NotExecuted propagation
   given: an if node whose condition is false, connected to a text node on the true port
   when: graph executes
   then:
@@ -394,6 +386,67 @@ test T-8: NotExecuted propagation
     - text node renders nothing (no error thrown)
 ```
 
+## QA
+
+Executable tests. Each step carries a human instruction (`do`) and, where the step maps to an
+invocable operation, an agent binding (`invoke`). Report failures by test and step number.
+
+```mdl
+test QA-1: Build and run a small compute graph
+  desc: |
+    The core canvas round-trip — create a graph, wire a constant into a JSON transform, and read
+    the reactive result. None of the node kernels (`evalConstant`, `jsonTransform`, ...) are
+    registered operations: they run inside the graph's own reactive controller when the canvas
+    triggers evaluation, not through the operation invoker, so this test is entirely human — the
+    same gap plugin-chess documents for move-less game creation.
+  actors: human
+  covers: [F-1.1, F-1.2, F-1.3, F-2.1, F-2.2, F-3.1, F-3.2, T-1, T-2]
+  status: unverified
+  given:
+    - an identity exists
+    - space: a space is open
+    - collection: a collection in that space, to create into
+    - no CanvasBoard named "QA Graph" exists — ABORT rather than deleting one this test did not
+      create
+  steps:
+    - name: Create the graph
+      do: In the navtree, click + on a collection and choose Compute Graph. Name it "QA Graph".
+      expect: an empty CanvasBoard/ComputeGraph opens on the canvas
+      note: |
+        NO `invoke` — "Create object" for CanvasBoard constructs the object locally and only
+        calls `space.addObject` (see `create-object.ts`); there is no dedicated
+        `createComputeGraph` operation despite F-1.1's phrasing, so this step is human-only.
+    - name: Add a constant node
+      do: Drag "Constant" from the node palette onto the canvas. Set its value to 42 and
+        valueType to "number".
+      expect: a constant node appears on the canvas showing 42
+    - name: Add a JSON transform node
+      do: Drag "JSON Transform" onto the canvas. Set its expression to "$".
+      expect: a JSON transform node appears on the canvas
+    - name: Wire them together
+      do: Drag from the constant node's output port to the JSON transform node's input port.
+      expect: a ComputeEdge connects the two nodes
+    - name: Read the result
+      do: Click the JSON transform node to inspect its output, or connect a text/output node to it.
+      expect: the transform node's output shows 42 (its own re-evaluation, triggered by the
+        upstream constant, per F-3.1's topological order)
+  after:
+    - name: Delete the graph
+      do: Right-click "QA Graph" in the navtree and choose Delete.
+      invoke: |
+        org.dxos.operation.space.removeObjects {
+          objects: [(await space.db.query(dxos.Filter.type(dxos.DXN.make('org.dxos.type.canvasBoard'))).run()).objects
+            .find((o) => o.name === 'QA Graph')
+            ?? (() => { throw new Error("CanvasBoard QA Graph not found — refusing to remove an unrelated object"); })()],
+          target: $given.collection
+        }
+      expect: the row leaves the navtree and its plank closes
+      note: |
+        No captured id exists — the create step has no `invoke` (see above) — so this resolves
+        "QA Graph" by typename AND name — a name match alone would delete any object carrying it, and throws rather than removing anything when the name does not
+        match, since `given` guarantees no pre-existing board carries it.
+```
+
 ---
 
 ## Appendix: Extension Definitions
@@ -420,8 +473,8 @@ ext feat
 ```
 
 ```mdl
-ext test
-  uri: org.dxos.mdl.test@1.0
+ext scenario
+  uri: org.dxos.mdl.scenario@1.0
   desc: An acceptance scenario expressed as given / when / then steps.
   fields:
     given?: Step | Step[]

package/dist/lib/capabilities.browser.mjs

@@ -0,0 +1,20 @@
+import { t as PLUGIN_default } from "./chunk-PLUGIN.mjs";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
+import * as SpaceCapability from "@dxos/plugin-space/SpaceCapability";
+import { translations } from "#translations";
+import { meta } from "#meta";
+//#region src/capabilities/gen/browser.ts
+var CreateObject = SpaceCapability.createObject(() => import("./chunk-create-object.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.section"] });
+var Schema = AppCapability.schema(() => import("./chunk-schema.mjs"));
+var Translations = AppCapability.translations(translations);
+//#endregion
+export { CreateObject, PluginAsset, ReactSurface, Schema, Translations };
+
+//# sourceMappingURL=capabilities.browser.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.browser.mjs","names":[],"sources":["../../src/capabilities/gen/browser.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'browser' condition.\n\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as SpaceCapability from '@dxos/plugin-space/SpaceCapability';\n\nimport { meta } from '#meta';\nimport { translations } from '#translations';\n\nimport pluginSpec from '../../../PLUGIN.mdl?raw';\n\nexport const CreateObject = SpaceCapability.createObject(() => import('../create-object.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});\n\nexport const ReactSurface = AppCapability.surface(() => import('../react-surface.ts'), {\n  roles: ['org.dxos.role.article', 'org.dxos.role.section'],\n});\n\nexport const Schema = AppCapability.schema(() => import('../schema.ts'));\n\nexport const Translations = AppCapability.translations(translations);\n"],"mappings":";;;;;;AAcA,IAAa,eAAe,gBAAgB,mBAAmB,OAAO,4BAAsB;AAE5F,IAAa,cAAc,cAAc,YAAY;CACnD,UAAU,KAAK,QAAQ;CACvB,MAAM;CACN,SAAS;CACT,UAAU;AACZ,CAAC;AAED,IAAa,eAAe,cAAc,cAAc,OAAO,8BAAwB,EACrF,OAAO,CAAC,yBAAyB,uBAAuB,EAC1D,CAAC;AAED,IAAa,SAAS,cAAc,aAAa,OAAO,qBAAe;AAEvE,IAAa,eAAe,cAAc,aAAa,YAAY"}

package/dist/lib/capabilities.mjs

@@ -1,10 +1,8 @@
+import { t as PLUGIN_default } from "./chunk-PLUGIN.mjs";
 import * as AppCapability from "@dxos/app-toolkit/AppCapability";
 import * as SpaceCapability from "@dxos/plugin-space/SpaceCapability";
 import { translations } from "#translations";
 import { meta } from "#meta";
-//#region PLUGIN.mdl?raw
-var PLUGIN_default = "---\nid: org.dxos.plugin.conductor\nname: ConductorPlugin\nversion: 0.1.0\n---\n\nVisual node-based compute graph plugin for `DXOS` Composer — wire data sources, AI models, logic, and transformations into reactive pipelines that execute in the local-first runtime.\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\n```mdl\ntype ComputeValueType\n  literals: string | number | boolean | object\n```\n\n```mdl\ntype NodeType\n  literals:\n    input | output | constant | template | switch | rng |\n    audio | chat | text | json | json-transform | surface |\n    beacon | scope | reducer | thread | queue | make-queue | append |\n    and | or | not | if | if-else |\n    function | gpt | gpt-realtime |\n    database | text-to-image\n```\n\n```mdl\ntype ComputeNode\n  desc: A node in the compute graph persisted via ECHO.\n  extends: [Graph.Node]\n  fields:\n    inputSchema?: JsonSchema\n    outputSchema?: JsonSchema\n    subgraph?: Ref<ComputeGraph>       # composition: nested graph\n    function?: Ref<PersistentOperation> # composition: reusable function node\n    valueType?: ComputeValueType        # for constant/template nodes\n    value?: any                         # for constant and template nodes\n    enabled?: boolean                   # for switch nodes\n```\n\n```mdl\ntype ComputeEdge\n  desc: A directed edge connecting an output port on one node to an input port on another.\n  extends: [Graph.Edge]\n  fields:\n    input: string                      # target node input property name\n    output: string                     # source node output property name\n```\n\n```mdl\ntype ComputeGraph\n  desc: Persistent ECHO object holding the full node-edge graph plus special I/O reference nodes.\n  fields:\n    graph: Graph.Graph\n    input?: ComputeNode\n    output?: ComputeNode\n```\n\n```mdl\ntype ValueBag\n  desc: A set of named asynchronous value effects passed between nodes.\n  fields:\n    _tag: \"ValueBag\"\n    values: Record<string, ValueEffect<any>>\n```\n\n## Components\n\n```mdl\ncomponent CanvasArticle\n  desc: Full-screen canvas editor for a ComputeGraph; renders as an article or a section embed.\n  props:\n    role: \"article\" | \"section\"\n    subject: CanvasBoard\n    attendableId?: string\n  state:\n    graph: CanvasGraphModel<ComputeShape>\n    controller?: ComputeGraphController\n    registry: ShapeRegistry\n    layout?: ComputeShapeLayout\n  slots:\n    toolbar?: ReactNode             # injected by AppSurface frame\n  layout: |\n    ┌──────────────────────────────────────────────┐\n    │  [toolbar — zoom, tools, minimap]            │\n    ├──────────────────────────────────────────────┤\n    │                                              │\n    │   ┌──────┐    ┌──────┐    ┌──────┐          │\n    │   │ node │───▶│ node │───▶│ node │          │\n    │   └──────┘    └──────┘    └──────┘          │\n    │                                              │\n    │   canvas — pan / zoom / connect nodes        │\n    └──────────────────────────────────────────────┘\n```\n\n## Operations\n\nPure operations — no effects, no service dependencies.\n\n```mdl\nop evalConstant\n  desc: Returns the scalar value stored on a constant node.\n  input:\n    node: ComputeNode\n  output: Scalar\n  errors:\n    MissingValue: node has no value set\n```\n\n```mdl\nop jsonTransform\n  desc: Evaluates a JSONPath expression over an input value.\n  input:\n    input: any\n    expression: string\n  output: any\n  errors:\n    InvalidExpression: JSONPath expression could not be parsed\n```\n\n```mdl\nop boolAnd\n  desc: Logical AND of two boolean inputs.\n  input:\n    a: boolean\n    b: boolean\n  output: boolean\n```\n\n```mdl\nop boolOr\n  desc: Logical OR of two boolean inputs.\n  input:\n    a: boolean\n    b: boolean\n  output: boolean\n```\n\n```mdl\nop boolNot\n  desc: Logical NOT of a boolean input.\n  input:\n    input: boolean\n  output: boolean\n```\n\n```mdl\nop ifRoute\n  desc: Routes a value to the true or false output port based on a condition.\n  input:\n    condition: boolean\n    value: any\n  output: IfOutput                   # { true?: any; false?: any }\n```\n\n```mdl\nop ifElseSelect\n  desc: Ternary — returns trueValue or falseValue depending on condition.\n  input:\n    condition: boolean\n    true: any\n    false: any\n  output: any\n```\n\nEffectful operations — mutate persistent state or call external services.\n\n```mdl\nop createComputeGraph\n  desc: Creates a new CanvasBoard with an empty ComputeGraph and adds it to the target space.\n  input:\n    target?: Space | Collection\n  output: string                     # DXN of created CanvasBoard\n  effects: [echo:write]\n```\n\n```mdl\nop appendToQueue\n  desc: Appends items to an ECHO queue or collection identified by DXN.\n  input:\n    id: string                       # DXN — dxn:queue or dxn:echo\n    items: any[]\n  output: void\n  effects: [echo:write, feed:write]\n  errors:\n    UnsupportedDXN: DXN kind not supported\n    SpaceMismatch: ECHO DXN belongs to a different space\n```\n\n```mdl\nop createQueue\n  desc: Allocates a new append-only Feed and returns a Ref to it.\n  input:\n  output: Ref<Feed>\n  effects: [feed:write]\n```\n\n```mdl\nop invokeGpt\n  desc: Sends the current conversation thread to the configured AI model and streams the reply.\n  input:\n    thread: Ref<Thread>\n    tools?: Tool[]\n    systemPrompt?: string\n  output: Message\n  effects: [http]\n  requires: [AiService]\n  errors:\n    ModelUnavailable: AI service could not be reached\n```\n\n```mdl\nop invokeFunction\n  desc: Deserialises a PersistentOperation from ECHO and invokes it with the provided input bag.\n  input:\n    function: Ref<PersistentOperation>\n    input: any\n  output: any\n  effects: [echo:read]\n  requires: [Database.Service, OperationRegistry.Service]\n  errors:\n    FunctionNotFound: referenced operation does not exist\n    InvocationFailed: operation returned an error\n```\n\n## Features\n\n```mdl\nfeat F-1: Canvas Editor\n\n  req F-1.1: User can create a new compute graph via the \"Create object\" entry.\n  req F-1.2: Canvas renders nodes as draggable, resizable shapes on an infinite panning surface.\n  req F-1.3:\n    when: user drags from an output port to an input port\n    then: a ComputeEdge is created connecting the two ports\n  req F-1.4:\n    when: a ComputeEdge is deleted\n    then: downstream nodes stop receiving values from the disconnected output\n```\n\n```mdl\nfeat F-2: Node Palette\n\n  req F-2.1: Toolbar exposes all built-in NodeTypes; user can drag them onto the canvas.\n  req F-2.2: Constant nodes display an inline editor for their scalar value and valueType.\n  req F-2.3: Template nodes render a text input with {{variable}} interpolation.\n  req F-2.4: Function nodes allow selecting a PersistentOperation from the space.\n```\n\n```mdl\nfeat F-3: Reactive Execution\n\n  req F-3.1:\n    when: any upstream node value changes\n    then: ComputeGraphController re-evaluates dependent nodes in topological order\n\n  req F-3.2: Node execution is lazy; nodes only run when their outputs are consumed.\n\n  req F-3.3:\n    when: a node fails with ConductorError\n    then: downstream nodes receive a NotExecuted marker and do not throw\n\n  req F-3.4:\n    when: a node emits a ValueBag\n    then: individual output ports can resolve at different times (async bag semantics)\n```\n\n```mdl\nfeat F-4: AI Integration\n\n  req F-4.1: GPT node connects to AiService; configuration includes model, system prompt, and tools.\n  req F-4.2:\n    when: GPT node executes\n    then: op:invokeGpt streams the model response back to the output port\n\n  req F-4.3: Function node can reference any PersistentOperation registered in the space.\n```\n\n```mdl\nfeat F-5: Data Sources and Sinks\n\n  req F-5.1: Queue node reads messages from a Feed referenced by DXN.\n  req F-5.2: Append node writes items to a Feed or ECHO collection referenced by DXN.\n  req F-5.3: Database node exposes ECHO space contents as a query tool for AI nodes.\n  req F-5.4: Thread node surfaces a conversation thread with its message history.\n```\n\n```mdl\nfeat F-6: Logic and Control Flow\n\n  req F-6.1: If node routes a value to true or false output port based on a boolean condition.\n  req F-6.2: IfElse node selects one of two values using a ternary condition.\n  req F-6.3: Reducer node collects an array of values from multiple upstream ports.\n  req F-6.4: And / Or / Not nodes implement standard boolean combinators.\n```\n\n```mdl\nfeat F-7: Persistence and Collaboration\n\n  req F-7.1: ComputeGraph is stored as an ECHO object; graph topology is replicated to peers.\n  req F-7.2:\n    when: a peer modifies a node value or edge\n    then: all collaborators see the change reflected on the canvas in real time\n\n  req F-7.3:\n    when: a CanvasBoard is embedded as a section in another document\n    then: the graph renders in the section aspect-square container and remains interactive\n```\n\n## Acceptance\n\n```mdl\ntest T-1: Create empty graph\n  given: user opens the Create Object menu\n  when: user selects \"Compute Graph\"\n  then:\n    - a new CanvasBoard with an empty ComputeGraph is created in the space\n    - the canvas opens with no nodes\n```\n\n```mdl\ntest T-2: Add constant node and read value\n  given: an empty canvas\n  when: user adds a constant node, sets value \"hello\", connects it to a text node\n  then:\n    - text node receives \"hello\" on its input port\n    - text node renders \"hello\"\n```\n\n```mdl\ntest T-3: Boolean AND gate\n  given: two switch nodes with values true and false connected to an AND node\n  when: graph executes\n  then:\n    - AND node output is false\n    - switching both inputs to true produces output true\n```\n\n```mdl\ntest T-4: JSONPath transform\n  given: a constant node with value { \"a\": { \"b\": 42 } } connected to a json-transform node\n  when: expression \"$.a.b\" is set on the transform node\n  then:\n    - output port value is [42]\n```\n\n```mdl\ntest T-5: GPT node invocation\n  given: a thread node connected to a GPT node with a system prompt\n  when: graph executes with AiService available\n  then:\n    - GPT node output port receives a Message\n    - Message content is non-empty\n  errors: [ModelUnavailable]\n```\n\n```mdl\ntest T-6: Append to queue\n  given: a make-queue node connected to an append node; constant node provides input items\n  when: graph executes\n  then:\n    - queue contains the appended items\n    - downstream queue node reads them back\n```\n\n```mdl\ntest T-7: Collaborative edit\n  given: two peers have the same CanvasBoard open\n  when: peer A moves a node on the canvas\n  then:\n    - peer B sees the node in the new position within one replication round-trip\n    tags: [collaborative]\n```\n\n```mdl\ntest T-8: NotExecuted propagation\n  given: an if node whose condition is false, connected to a text node on the true port\n  when: graph executes\n  then:\n    - text node receives a NotExecuted marker\n    - text node renders nothing (no error thrown)\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 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\n    state?: FieldMap\n    slots?: FieldMap\n    actions?: ActionMap\n    emits?: EventMap\n    layout?: CodeBlock\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\n    output?: TypeExpr\n    errors?: ErrorMap\n    effects?: EffectList\n    requires?: ServiceList\n    note?: Prose\n```\n";
-//#endregion
 //#region src/capabilities/index.ts
 var CreateObject = SpaceCapability.createObject(() => import("./chunk-create-object.mjs"));
 var PluginAsset = AppCapability.pluginAsset({

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 * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as SpaceCapability from '@dxos/plugin-space/SpaceCapability';\n\nimport { meta } from '#meta';\nimport { translations } from '#translations';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../../PLUGIN.mdl?raw';\n\nexport const CreateObject = SpaceCapability.createObject(() => import('./create-object'));\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.section'],\n});\nexport const Schema = AppCapability.schema(() => import('./schema'));\nexport const Translations = AppCapability.translations(translations);\n"],"mappings":";;;;;;;;AAaA,IAAa,eAAe,gBAAgB,mBAAmB,OAAO,4BAAkB;AACxF,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,uBAAuB,EAC1D,CAAC;AACD,IAAa,SAAS,cAAc,aAAa,OAAO,qBAAW;AACnE,IAAa,eAAe,cAAc,aAAa,YAAY"}
+{"version":3,"file":"capabilities.mjs","names":[],"sources":["../../src/capabilities/index.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as SpaceCapability from '@dxos/plugin-space/SpaceCapability';\n\nimport { meta } from '#meta';\nimport { translations } from '#translations';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../../PLUGIN.mdl?raw';\n\nexport const CreateObject = SpaceCapability.createObject(() => import('./create-object.ts'));\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', 'org.dxos.role.section'],\n});\nexport const Schema = AppCapability.schema(() => import('./schema.ts'));\nexport const Translations = AppCapability.translations(translations);\n"],"mappings":";;;;;;AAaA,IAAa,eAAe,gBAAgB,mBAAmB,OAAO,4BAAqB;AAC3F,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,yBAAyB,uBAAuB,EAC1D,CAAC;AACD,IAAa,SAAS,cAAc,aAAa,OAAO,qBAAc;AACtE,IAAa,eAAe,cAAc,aAAa,YAAY"}

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

@@ -1 +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 AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as SpaceCapability from '@dxos/plugin-space/SpaceCapability';\n\nimport { translations } from '#translations';\n\nexport const CreateObject = SpaceCapability.createObject(() => import('../create-object'));\n\nexport const Schema = AppCapability.schema(() => import('../schema'));\n\nexport const Translations = AppCapability.translations(translations);\n\nexport const PluginAsset = undefined;\nexport const ReactSurface = undefined;\n"],"mappings":";;;;AAWA,IAAa,eAAe,gBAAgB,mBAAmB,OAAO,4BAAmB;AAEzF,IAAa,SAAS,cAAc,aAAa,OAAO,qBAAY;AAEpE,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,cAAc,KAAA;AAC3B,IAAa,eAAe,KAAA"}
+{"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 AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as SpaceCapability from '@dxos/plugin-space/SpaceCapability';\n\nimport { translations } from '#translations';\n\nexport const CreateObject = SpaceCapability.createObject(() => import('../create-object.ts'));\n\nexport const Schema = AppCapability.schema(() => import('../schema.ts'));\n\nexport const Translations = AppCapability.translations(translations);\n\nexport const PluginAsset = undefined;\nexport const ReactSurface = undefined;\n"],"mappings":";;;;AAWA,IAAa,eAAe,gBAAgB,mBAAmB,OAAO,4BAAsB;AAE5F,IAAa,SAAS,cAAc,aAAa,OAAO,qBAAe;AAEvE,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,cAAc,KAAA;AAC3B,IAAa,eAAe,KAAA"}

package/dist/lib/capabilities.tauri.mjs

@@ -0,0 +1,20 @@
+import { t as PLUGIN_default } from "./chunk-PLUGIN.mjs";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
+import * as SpaceCapability from "@dxos/plugin-space/SpaceCapability";
+import { translations } from "#translations";
+import { meta } from "#meta";
+//#region src/capabilities/gen/tauri.ts
+var CreateObject = SpaceCapability.createObject(() => import("./chunk-create-object.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.section"] });
+var Schema = AppCapability.schema(() => import("./chunk-schema.mjs"));
+var Translations = AppCapability.translations(translations);
+//#endregion
+export { CreateObject, PluginAsset, ReactSurface, Schema, Translations };
+
+//# sourceMappingURL=capabilities.tauri.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.tauri.mjs","names":[],"sources":["../../src/capabilities/gen/tauri.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'tauri' condition.\n\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as SpaceCapability from '@dxos/plugin-space/SpaceCapability';\n\nimport { meta } from '#meta';\nimport { translations } from '#translations';\n\nimport pluginSpec from '../../../PLUGIN.mdl?raw';\n\nexport const CreateObject = SpaceCapability.createObject(() => import('../create-object.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});\n\nexport const ReactSurface = AppCapability.surface(() => import('../react-surface.ts'), {\n  roles: ['org.dxos.role.article', 'org.dxos.role.section'],\n});\n\nexport const Schema = AppCapability.schema(() => import('../schema.ts'));\n\nexport const Translations = AppCapability.translations(translations);\n"],"mappings":";;;;;;AAcA,IAAa,eAAe,gBAAgB,mBAAmB,OAAO,4BAAsB;AAE5F,IAAa,cAAc,cAAc,YAAY;CACnD,UAAU,KAAK,QAAQ;CACvB,MAAM;CACN,SAAS;CACT,UAAU;AACZ,CAAC;AAED,IAAa,eAAe,cAAc,cAAc,OAAO,8BAAwB,EACrF,OAAO,CAAC,yBAAyB,uBAAuB,EAC1D,CAAC;AAED,IAAa,SAAS,cAAc,aAAa,OAAO,qBAAe;AAEvE,IAAa,eAAe,cAAc,aAAa,YAAY"}

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

@@ -1 +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 AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as SpaceCapability from '@dxos/plugin-space/SpaceCapability';\n\nimport { translations } from '#translations';\n\nexport const CreateObject = SpaceCapability.createObject(() => import('../create-object'));\n\nexport const Schema = AppCapability.schema(() => import('../schema'));\n\nexport const Translations = AppCapability.translations(translations);\n\nexport const PluginAsset = undefined;\nexport const ReactSurface = undefined;\n"],"mappings":";;;;AAWA,IAAa,eAAe,gBAAgB,mBAAmB,OAAO,4BAAmB;AAEzF,IAAa,SAAS,cAAc,aAAa,OAAO,qBAAY;AAEpE,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,cAAc,KAAA;AAC3B,IAAa,eAAe,KAAA"}
+{"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 AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as SpaceCapability from '@dxos/plugin-space/SpaceCapability';\n\nimport { translations } from '#translations';\n\nexport const CreateObject = SpaceCapability.createObject(() => import('../create-object.ts'));\n\nexport const Schema = AppCapability.schema(() => import('../schema.ts'));\n\nexport const Translations = AppCapability.translations(translations);\n\nexport const PluginAsset = undefined;\nexport const ReactSurface = undefined;\n"],"mappings":";;;;AAWA,IAAa,eAAe,gBAAgB,mBAAmB,OAAO,4BAAsB;AAE5F,IAAa,SAAS,cAAc,aAAa,OAAO,qBAAe;AAEvE,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,cAAc,KAAA;AAC3B,IAAa,eAAe,KAAA"}

package/dist/lib/chunk-CanvasArticle.mjs

@@ -1,61 +1,100 @@
-import { Fragment, useEffect, useMemo, useRef } from "react";
+import { Fragment, useCallback, useEffect, useMemo } from "react";
 import { Database, Obj } from "@dxos/echo";
 import * as Effect from "effect/Effect";
 import * as Operation from "@dxos/compute/Operation";
 import * as Capabilities from "@dxos/app-framework/Capabilities";
-import { useCapability } from "@dxos/app-framework/ui";
-import { AppSurface } from "@dxos/app-toolkit/ui";
-import { CanvasGraphModel, Editor, KeyboardContainer, ShapeRegistry } from "@dxos/react-ui-canvas-editor";
+import * as AppSurface from "@dxos/app-toolkit/AppSurface";
+import { KeyboardContainer, ShapeRegistry } from "@dxos/react-ui-canvas-editor";
 import { ComputeGraphModel } from "@dxos/conductor";
 import { AiService } from "@dxos/ai";
+import * as Hooks from "@dxos/app-framework/Hooks";
 import * as Credential from "@dxos/compute/Credential";
 import * as OperationRegistry from "@dxos/compute/OperationRegistry";
 import * as ServiceResolver from "@dxos/compute/ServiceResolver";
 import { useObject } from "@dxos/echo-react";
-import { Flex } from "@dxos/react-ui";
-import { ComputeContext, ComputeGraphController, ComputeShapeLayout, computeShapes, useComputeGraphController, useGraphMonitor } from "@dxos/react-ui-canvas-compute";
+import { Bullets, ComputeContext, ComputeGraphController, boardSceneId, computeNodeRegistry, computeShapes, createComputeProjection, createEchoStore } from "@dxos/react-ui-canvas-compute";
+import { SceneView, createSceneViewAtoms, useRegistry, useSceneProjection } from "@dxos/react-ui-canvas/scene";
+import * as Layout from "@dxos/react-ui/Layout";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/containers/CanvasArticle/CanvasArticle.tsx
+/**
+* The board on the scene engine (MIGRATION.md M4): `SceneView` over an ECHO store of the board's own
+* layout, with the compute projection keeping the compute graph in step. The editor's own canvas,
+* graph model and monitor are gone — the store is the persistence and the projection is the mirror.
+*/
 var CanvasArticle = ({ role, subject, attendableId: _attendableId }) => {
-	const [canvas] = useObject(subject);
-	const id = Obj.getURI(canvas);
-	const graph = useMemo(() => CanvasGraphModel.create(canvas.layout, (fn) => Obj.update(subject, fn)), [subject, canvas.layout]);
-	useEffect(() => Obj.subscribe(subject, () => graph.sync()), [subject, graph]);
 	const controller = useGraphController(subject);
-	const graphMonitor = useGraphMonitor(controller?.graph);
-	const registry = useMemo(() => new ShapeRegistry(computeShapes), []);
-	const editorRef = useRef(null);
-	useComputeGraphController({
-		controller,
-		graph,
-		editorRef
+	if (!controller) return null;
+	return /* @__PURE__ */ jsx(CanvasScene, {
+		role,
+		subject,
+		controller
 	});
-	const layout = useMemo(() => controller && registry ? new ComputeShapeLayout(controller, registry) : void 0, [controller, registry]);
-	if (!controller) return;
+};
+CanvasArticle.displayName = "CanvasArticle";
+var CanvasScene = ({ role, subject, controller }) => {
+	const id = Obj.getURI(subject);
+	const registry = useRegistry();
+	const shapeRegistry = useMemo(() => new ShapeRegistry(computeShapes), []);
+	const store = useMemo(() => createEchoStore(subject), [subject]);
+	const sceneId = useMemo(() => boardSceneId(subject), [subject]);
+	const atoms = useMemo(() => createSceneViewAtoms(sceneId), [sceneId]);
+	const createProjection = useCallback((options) => createComputeProjection({
+		...options,
+		controller
+	}), [controller]);
+	const projection = useSceneProjection({
+		store,
+		atoms,
+		createProjection
+	});
+	const resize = useCallback((nodeId, delta) => {
+		const node = registry.get(projection.scene).nodes[nodeId];
+		if (node) projection.apply({
+			kind: "update",
+			id: nodeId,
+			values: { size: {
+				width: node.size.width,
+				height: node.size.height + delta
+			} }
+		});
+	}, [registry, projection]);
 	const Root = role === AppSurface.Section.role ? Container : Fragment;
 	return /* @__PURE__ */ jsx(ComputeContext.Provider, {
-		value: { controller },
+		value: {
+			controller,
+			registry: shapeRegistry,
+			resize
+		},
 		children: /* @__PURE__ */ jsx(Root, { children: /* @__PURE__ */ jsx(KeyboardContainer, {
 			id,
-			children: /* @__PURE__ */ jsxs(Editor.Root, {
-				id,
-				ref: editorRef,
-				graph,
-				graphMonitor,
-				registry,
-				layout,
-				children: [/* @__PURE__ */ jsx(Editor.Canvas, {}), /* @__PURE__ */ jsx(Editor.UI, { showTools: true })]
+			children: /* @__PURE__ */ jsxs(SceneView.Root, {
+				store,
+				root: sceneId,
+				atoms,
+				nodes: computeNodeRegistry,
+				projection,
+				children: [
+					/* @__PURE__ */ jsx(SceneView.Canvas, { overlay: /* @__PURE__ */ jsx(Bullets, {
+						controller,
+						projection
+					}) }),
+					/* @__PURE__ */ jsx(SceneView.Navigation, {}),
+					/* @__PURE__ */ jsx(SceneView.Actions, {}),
+					/* @__PURE__ */ jsx(SceneView.Debug, {}),
+					/* @__PURE__ */ jsx(SceneView.Palette, {})
+				]
 			})
 		}) })
 	});
 };
-var Container = (props) => /* @__PURE__ */ jsx(Flex, {
+var Container = (props) => /* @__PURE__ */ jsx(Layout.Flex, {
 	...props,
-	classNames: "aspect-square"
+	classNames: "aspect-square w-full max-h-full min-h-0"
 });
 var useGraphController = (canvas) => {
 	const db = Obj.getDatabase(canvas);
-	const processManagerRuntime = useCapability(Capabilities.ProcessManagerRuntime);
+	const processManagerRuntime = Hooks.useCapability(Capabilities.ProcessManagerRuntime);
 	const [computeGraph] = useObject(canvas.computeGraph);
 	const controller = useMemo(() => {
 		if (!canvas.computeGraph?.target || !db) return null;
@@ -82,7 +121,6 @@ var useGraphController = (canvas) => {
 	}, [canvas.computeGraph?.target, controller]);
 	return controller;
 };
-CanvasArticle.displayName = "CanvasArticle";
 //#endregion
 export { CanvasArticle as default };
 

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

@@ -1 +1 @@
-{"version":3,"file":"chunk-CanvasArticle.mjs","names":[],"sources":["../../src/containers/CanvasArticle/CanvasArticle.tsx"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport type * as Exit from 'effect/Exit';\nimport React, { Fragment, useEffect, useMemo, useRef } from 'react';\n\nimport { AiService } from '@dxos/ai';\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport { useCapability } from '@dxos/app-framework/ui';\nimport { AppSurface } from '@dxos/app-toolkit/ui';\nimport * as Credential from '@dxos/compute/Credential';\nimport * as Operation from '@dxos/compute/Operation';\nimport * as OperationRegistry from '@dxos/compute/OperationRegistry';\nimport * as ServiceResolver from '@dxos/compute/ServiceResolver';\nimport { ComputeGraphModel } from '@dxos/conductor';\nimport { Database, Obj } from '@dxos/echo';\nimport { useObject } from '@dxos/echo-react';\nimport { Flex, type FlexProps } from '@dxos/react-ui';\nimport {\n  ComputeContext,\n  ComputeGraphController,\n  type ComputeShape,\n  ComputeShapeLayout,\n  computeShapes,\n  useComputeGraphController,\n  useGraphMonitor,\n} from '@dxos/react-ui-canvas-compute';\nimport {\n  type CanvasBoard,\n  CanvasGraphModel,\n  Editor,\n  type EditorController,\n  KeyboardContainer,\n  ShapeRegistry,\n} from '@dxos/react-ui-canvas-editor';\n\nexport type CanvasArticleProps = AppSurface.ObjectArticleProps<CanvasBoard.CanvasBoard>;\n\nexport const CanvasArticle = ({ role, subject, attendableId: _attendableId }: CanvasArticleProps) => {\n  const [canvas] = useObject(subject);\n  const id = Obj.getURI(canvas);\n  const graph = useMemo(\n    () => CanvasGraphModel.create<ComputeShape>(canvas.layout, (fn) => Obj.update(subject, fn)),\n    [subject, canvas.layout],\n  );\n  // Structural edits from other peers (or undo) land in the object, not through the model.\n  useEffect(() => Obj.subscribe(subject, () => graph.sync()), [subject, graph]);\n  const controller = useGraphController(subject);\n  const graphMonitor = useGraphMonitor(controller?.graph);\n  const registry = useMemo(() => new ShapeRegistry(computeShapes), []);\n  const editorRef = useRef<EditorController>(null);\n  useComputeGraphController({ controller, graph, editorRef });\n\n  // Layout.\n  const layout = useMemo(\n    () => (controller && registry ? new ComputeShapeLayout(controller, registry) : undefined),\n    [controller, registry],\n  );\n\n  if (!controller) {\n    return;\n  }\n\n  const Root = role === AppSurface.Section.role ? Container : Fragment;\n\n  return (\n    <ComputeContext.Provider value={{ controller }}>\n      <Root>\n        <KeyboardContainer id={id}>\n          <Editor.Root\n            id={id}\n            ref={editorRef}\n            graph={graph}\n            graphMonitor={graphMonitor as any}\n            registry={registry}\n            layout={layout}\n          >\n            <Editor.Canvas />\n            <Editor.UI showTools />\n          </Editor.Root>\n        </KeyboardContainer>\n      </Root>\n    </ComputeContext.Provider>\n  );\n};\n\nconst Container = (props: FlexProps) => <Flex {...props} classNames='aspect-square' />;\n\nconst useGraphController = (canvas: CanvasBoard.CanvasBoard) => {\n  const db = Obj.getDatabase(canvas);\n  const processManagerRuntime = useCapability(Capabilities.ProcessManagerRuntime);\n  const [computeGraph] = useObject(canvas.computeGraph);\n  const controller = useMemo(() => {\n    if (!canvas.computeGraph?.target || !db) {\n      return null;\n    }\n    const spaceId = db.spaceId;\n    const model = new ComputeGraphModel(canvas.computeGraph?.target);\n    const spaceLayer = ServiceResolver.provide(\n      { space: spaceId },\n      AiService.AiService,\n      Database.Service,\n      Credential.CredentialsService,\n      Operation.Service,\n      OperationRegistry.Service,\n    );\n    const computeGraphRuntime = {\n      runPromiseExit: <A, E>(effect: Effect.Effect<A, E, any>): Promise<Exit.Exit<A, E>> =>\n        processManagerRuntime.runPromiseExit(effect.pipe(Effect.provide(spaceLayer)) as any) as Promise<\n          Exit.Exit<A, E>\n        >,\n    };\n    const controller = new ComputeGraphController(computeGraphRuntime, model);\n    return controller;\n  }, [computeGraph, db, processManagerRuntime]);\n\n  useEffect(() => {\n    if (!controller) {\n      return;\n    }\n\n    void controller.open();\n    return () => {\n      void controller.close();\n    };\n  }, [controller]);\n\n  // Structural edits from other peers (or undo) land in the object, not through the model.\n  useEffect(() => {\n    const root = canvas.computeGraph?.target;\n    if (!root || !controller) {\n      return;\n    }\n\n    return Obj.subscribe(root, () => controller.graph.sync());\n  }, [canvas.computeGraph?.target, controller]);\n\n  return controller;\n};\n\nCanvasArticle.displayName = 'CanvasArticle';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAwCA,IAAa,iBAAiB,EAAE,MAAM,SAAS,cAAc,oBAAwC;CACnG,MAAM,CAAC,UAAU,UAAU,OAAO;CAClC,MAAM,KAAK,IAAI,OAAO,MAAM;CAC5B,MAAM,QAAQ,cACN,iBAAiB,OAAqB,OAAO,SAAS,OAAO,IAAI,OAAO,SAAS,EAAE,CAAC,GAC1F,CAAC,SAAS,OAAO,MAAM,CACzB;CAEA,gBAAgB,IAAI,UAAU,eAAe,MAAM,KAAK,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC;CAC5E,MAAM,aAAa,mBAAmB,OAAO;CAC7C,MAAM,eAAe,gBAAgB,YAAY,KAAK;CACtD,MAAM,WAAW,cAAc,IAAI,cAAc,aAAa,GAAG,CAAC,CAAC;CACnE,MAAM,YAAY,OAAyB,IAAI;CAC/C,0BAA0B;EAAE;EAAY;EAAO;CAAU,CAAC;CAG1D,MAAM,SAAS,cACN,cAAc,WAAW,IAAI,mBAAmB,YAAY,QAAQ,IAAI,KAAA,GAC/E,CAAC,YAAY,QAAQ,CACvB;CAEA,IAAI,CAAC,YACH;CAGF,MAAM,OAAO,SAAS,WAAW,QAAQ,OAAO,YAAY;CAE5D,OACE,oBAAC,eAAe,UAAhB;EAAyB,OAAO,EAAE,WAAW;EAC3C,UAAA,oBAAC,MAAD,EAAA,UACE,oBAAC,mBAAD;GAAuB;GACrB,UAAA,qBAAC,OAAO,MAAR;IACM;IACJ,KAAK;IACE;IACO;IACJ;IACF;IANV,UAAA,CAQE,oBAAC,OAAO,QAAR,CAAgB,CAAA,GAChB,oBAAC,OAAO,IAAR,EAAW,WAAA,KAAW,CAAA,CACX;;EACI,CAAA,EACf,CAAA;CACiB,CAAA;AAE7B;AAEA,IAAM,aAAa,UAAqB,oBAAC,MAAD;CAAM,GAAI;CAAO,YAAW;AAAiB,CAAA;AAErF,IAAM,sBAAsB,WAAoC;CAC9D,MAAM,KAAK,IAAI,YAAY,MAAM;CACjC,MAAM,wBAAwB,cAAc,aAAa,qBAAqB;CAC9E,MAAM,CAAC,gBAAgB,UAAU,OAAO,YAAY;CACpD,MAAM,aAAa,cAAc;EAC/B,IAAI,CAAC,OAAO,cAAc,UAAU,CAAC,IACnC,OAAO;EAET,MAAM,UAAU,GAAG;EACnB,MAAM,QAAQ,IAAI,kBAAkB,OAAO,cAAc,MAAM;EAC/D,MAAM,aAAa,gBAAgB,QACjC,EAAE,OAAO,QAAQ,GACjB,UAAU,WACV,SAAS,SACT,WAAW,oBACX,UAAU,SACV,kBAAkB,OACpB;EAQA,OAAO,IADgB,uBAAuB,EAL5C,iBAAuB,WACrB,sBAAsB,eAAe,OAAO,KAAK,OAAO,QAAQ,UAAU,CAAC,CAAQ,EAIzC,GAAqB,KAC5D;CACT,GAAG;EAAC;EAAc;EAAI;CAAqB,CAAC;CAE5C,gBAAgB;EACd,IAAI,CAAC,YACH;EAGF,WAAgB,KAAK;EACrB,aAAa;GACX,WAAgB,MAAM;EACxB;CACF,GAAG,CAAC,UAAU,CAAC;CAGf,gBAAgB;EACd,MAAM,OAAO,OAAO,cAAc;EAClC,IAAI,CAAC,QAAQ,CAAC,YACZ;EAGF,OAAO,IAAI,UAAU,YAAY,WAAW,MAAM,KAAK,CAAC;CAC1D,GAAG,CAAC,OAAO,cAAc,QAAQ,UAAU,CAAC;CAE5C,OAAO;AACT;AAEA,cAAc,cAAc"}
+{"version":3,"file":"chunk-CanvasArticle.mjs","names":[],"sources":["../../src/containers/CanvasArticle/CanvasArticle.tsx"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport type * as Exit from 'effect/Exit';\nimport React, { Fragment, useCallback, useEffect, useMemo } from 'react';\n\nimport { AiService } from '@dxos/ai';\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Hooks from '@dxos/app-framework/Hooks';\nimport * as AppSurface from '@dxos/app-toolkit/AppSurface';\nimport * as Credential from '@dxos/compute/Credential';\nimport * as Operation from '@dxos/compute/Operation';\nimport * as OperationRegistry from '@dxos/compute/OperationRegistry';\nimport * as ServiceResolver from '@dxos/compute/ServiceResolver';\nimport { ComputeGraphModel } from '@dxos/conductor';\nimport { Database, Obj } from '@dxos/echo';\nimport { useObject } from '@dxos/echo-react';\nimport {\n  Bullets,\n  ComputeContext,\n  ComputeGraphController,\n  boardSceneId,\n  computeNodeRegistry,\n  computeShapes,\n  createComputeProjection,\n  createEchoStore,\n} from '@dxos/react-ui-canvas-compute';\nimport { type CanvasBoard, KeyboardContainer, ShapeRegistry } from '@dxos/react-ui-canvas-editor';\nimport {\n  type FreehandProjectionOptions,\n  SceneView,\n  createSceneViewAtoms,\n  useRegistry,\n  useSceneProjection,\n} from '@dxos/react-ui-canvas/scene';\nimport * as Layout from '@dxos/react-ui/Layout';\n\nexport type CanvasArticleProps = AppSurface.ObjectArticleProps<CanvasBoard.CanvasBoard>;\n\n/**\n * The board on the scene engine (MIGRATION.md M4): `SceneView` over an ECHO store of the board's own\n * layout, with the compute projection keeping the compute graph in step. The editor's own canvas,\n * graph model and monitor are gone — the store is the persistence and the projection is the mirror.\n */\nexport const CanvasArticle = ({ role, subject, attendableId: _attendableId }: CanvasArticleProps) => {\n  const controller = useGraphController(subject);\n  if (!controller) {\n    return null;\n  }\n\n  // The scene is everything below: a board without its compute graph has no projection to render through.\n  return <CanvasScene role={role} subject={subject} controller={controller} />;\n};\n\nCanvasArticle.displayName = 'CanvasArticle';\n\ntype CanvasSceneProps = Pick<CanvasArticleProps, 'role' | 'subject'> & { controller: ComputeGraphController };\n\nconst CanvasScene = ({ role, subject, controller }: CanvasSceneProps) => {\n  const id = Obj.getURI(subject);\n  const registry = useRegistry();\n  const shapeRegistry = useMemo(() => new ShapeRegistry(computeShapes), []);\n  const store = useMemo(() => createEchoStore(subject), [subject]);\n  const sceneId = useMemo(() => boardSceneId(subject), [subject]);\n  const atoms = useMemo(() => createSceneViewAtoms(sceneId), [sceneId]);\n  const createProjection = useCallback(\n    (options: FreehandProjectionOptions) => createComputeProjection({ ...options, controller }),\n    [controller],\n  );\n  const projection = useSceneProjection({ store, atoms, createProjection });\n\n  // A function body opening grows its node through the model, so its links re-route with it.\n  const resize = useCallback(\n    (nodeId: string, delta: number) => {\n      const node = registry.get(projection.scene).nodes[nodeId];\n      if (node) {\n        projection.apply({\n          kind: 'update',\n          id: nodeId,\n          values: { size: { width: node.size.width, height: node.size.height + delta } },\n        });\n      }\n    },\n    [registry, projection],\n  );\n\n  const Root = role === AppSurface.Section.role ? Container : Fragment;\n\n  return (\n    <ComputeContext.Provider value={{ controller, registry: shapeRegistry, resize }}>\n      <Root>\n        <KeyboardContainer id={id}>\n          <SceneView.Root\n            store={store}\n            root={sceneId}\n            atoms={atoms}\n            nodes={computeNodeRegistry}\n            projection={projection}\n          >\n            <SceneView.Canvas overlay={<Bullets controller={controller} projection={projection} />} />\n            <SceneView.Navigation />\n            <SceneView.Actions />\n            <SceneView.Debug />\n            <SceneView.Palette />\n          </SceneView.Root>\n        </KeyboardContainer>\n      </Root>\n    </ComputeContext.Provider>\n  );\n};\n\nconst Container = (props: Layout.FlexProps) => (\n  <Layout.Flex {...props} classNames='aspect-square w-full max-h-full min-h-0' />\n);\n\nconst useGraphController = (canvas: CanvasBoard.CanvasBoard) => {\n  const db = Obj.getDatabase(canvas);\n  const processManagerRuntime = Hooks.useCapability(Capabilities.ProcessManagerRuntime);\n  const [computeGraph] = useObject(canvas.computeGraph);\n  const controller = useMemo(() => {\n    if (!canvas.computeGraph?.target || !db) {\n      return null;\n    }\n    const spaceId = db.spaceId;\n    const model = new ComputeGraphModel(canvas.computeGraph?.target);\n    const spaceLayer = ServiceResolver.provide(\n      { space: spaceId },\n      AiService.AiService,\n      Database.Service,\n      Credential.CredentialsService,\n      Operation.Service,\n      OperationRegistry.Service,\n    );\n    const computeGraphRuntime = {\n      runPromiseExit: <A, E>(effect: Effect.Effect<A, E, any>): Promise<Exit.Exit<A, E>> =>\n        processManagerRuntime.runPromiseExit(effect.pipe(Effect.provide(spaceLayer)) as any) as Promise<\n          Exit.Exit<A, E>\n        >,\n    };\n    const controller = new ComputeGraphController(computeGraphRuntime, model);\n    return controller;\n  }, [computeGraph, db, processManagerRuntime]);\n\n  useEffect(() => {\n    if (!controller) {\n      return;\n    }\n\n    void controller.open();\n    return () => {\n      void controller.close();\n    };\n  }, [controller]);\n\n  // Structural edits from other peers (or undo) land in the object, not through the model.\n  useEffect(() => {\n    const root = canvas.computeGraph?.target;\n    if (!root || !controller) {\n      return;\n    }\n\n    return Obj.subscribe(root, () => controller.graph.sync());\n  }, [canvas.computeGraph?.target, controller]);\n\n  return controller;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA8CA,IAAa,iBAAiB,EAAE,MAAM,SAAS,cAAc,oBAAwC;CACnG,MAAM,aAAa,mBAAmB,OAAO;CAC7C,IAAI,CAAC,YACH,OAAO;CAIT,OAAO,oBAAC,aAAD;EAAmB;EAAe;EAAqB;CAAa,CAAA;AAC7E;AAEA,cAAc,cAAc;AAI5B,IAAM,eAAe,EAAE,MAAM,SAAS,iBAAmC;CACvE,MAAM,KAAK,IAAI,OAAO,OAAO;CAC7B,MAAM,WAAW,YAAY;CAC7B,MAAM,gBAAgB,cAAc,IAAI,cAAc,aAAa,GAAG,CAAC,CAAC;CACxE,MAAM,QAAQ,cAAc,gBAAgB,OAAO,GAAG,CAAC,OAAO,CAAC;CAC/D,MAAM,UAAU,cAAc,aAAa,OAAO,GAAG,CAAC,OAAO,CAAC;CAC9D,MAAM,QAAQ,cAAc,qBAAqB,OAAO,GAAG,CAAC,OAAO,CAAC;CACpE,MAAM,mBAAmB,aACtB,YAAuC,wBAAwB;EAAE,GAAG;EAAS;CAAW,CAAC,GAC1F,CAAC,UAAU,CACb;CACA,MAAM,aAAa,mBAAmB;EAAE;EAAO;EAAO;CAAiB,CAAC;CAGxE,MAAM,SAAS,aACZ,QAAgB,UAAkB;EACjC,MAAM,OAAO,SAAS,IAAI,WAAW,KAAK,CAAC,CAAC,MAAM;EAClD,IAAI,MACF,WAAW,MAAM;GACf,MAAM;GACN,IAAI;GACJ,QAAQ,EAAE,MAAM;IAAE,OAAO,KAAK,KAAK;IAAO,QAAQ,KAAK,KAAK,SAAS;GAAM,EAAE;EAC/E,CAAC;CAEL,GACA,CAAC,UAAU,UAAU,CACvB;CAEA,MAAM,OAAO,SAAS,WAAW,QAAQ,OAAO,YAAY;CAE5D,OACE,oBAAC,eAAe,UAAhB;EAAyB,OAAO;GAAE;GAAY,UAAU;GAAe;EAAO;EAC5E,UAAA,oBAAC,MAAD,EAAA,UACE,oBAAC,mBAAD;GAAuB;GACrB,UAAA,qBAAC,UAAU,MAAX;IACS;IACP,MAAM;IACC;IACP,OAAO;IACK;IALd,UAAA;KAOE,oBAAC,UAAU,QAAX,EAAkB,SAAS,oBAAC,SAAD;MAAqB;MAAwB;KAAa,CAAA,EAAI,CAAA;KACzF,oBAAC,UAAU,YAAX,CAAuB,CAAA;KACvB,oBAAC,UAAU,SAAX,CAAoB,CAAA;KACpB,oBAAC,UAAU,OAAX,CAAkB,CAAA;KAClB,oBAAC,UAAU,SAAX,CAAoB,CAAA;IACN;;EACC,CAAA,EACf,CAAA;CACiB,CAAA;AAE7B;AAEA,IAAM,aAAa,UACjB,oBAAC,OAAO,MAAR;CAAa,GAAI;CAAO,YAAW;AAA2C,CAAA;AAGhF,IAAM,sBAAsB,WAAoC;CAC9D,MAAM,KAAK,IAAI,YAAY,MAAM;CACjC,MAAM,wBAAwB,MAAM,cAAc,aAAa,qBAAqB;CACpF,MAAM,CAAC,gBAAgB,UAAU,OAAO,YAAY;CACpD,MAAM,aAAa,cAAc;EAC/B,IAAI,CAAC,OAAO,cAAc,UAAU,CAAC,IACnC,OAAO;EAET,MAAM,UAAU,GAAG;EACnB,MAAM,QAAQ,IAAI,kBAAkB,OAAO,cAAc,MAAM;EAC/D,MAAM,aAAa,gBAAgB,QACjC,EAAE,OAAO,QAAQ,GACjB,UAAU,WACV,SAAS,SACT,WAAW,oBACX,UAAU,SACV,kBAAkB,OACpB;EAQA,OAAO,IADgB,uBAAuB,EAL5C,iBAAuB,WACrB,sBAAsB,eAAe,OAAO,KAAK,OAAO,QAAQ,UAAU,CAAC,CAAQ,EAIzC,GAAqB,KAC5D;CACT,GAAG;EAAC;EAAc;EAAI;CAAqB,CAAC;CAE5C,gBAAgB;EACd,IAAI,CAAC,YACH;EAGF,WAAgB,KAAK;EACrB,aAAa;GACX,WAAgB,MAAM;EACxB;CACF,GAAG,CAAC,UAAU,CAAC;CAGf,gBAAgB;EACd,MAAM,OAAO,OAAO,cAAc;EAClC,IAAI,CAAC,QAAQ,CAAC,YACZ;EAGF,OAAO,IAAI,UAAU,YAAY,WAAW,MAAM,KAAK,CAAC;CAC1D,GAAG,CAAC,OAAO,cAAc,QAAQ,UAAU,CAAC;CAE5C,OAAO;AACT"}

package/dist/lib/chunk-PLUGIN.mjs

@@ -0,0 +1,6 @@
+//#region PLUGIN.mdl?raw
+var PLUGIN_default = "---\nid: org.dxos.plugin.conductor\nname: ConductorPlugin\nversion: 0.1.0\n---\n\nVisual node-based compute graph plugin for `DXOS` Composer — wire data sources, AI models, logic, and transformations into reactive pipelines that execute in the local-first runtime.\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| `component` | `org.dxos.mdl.component@1.0`   |\n| `op`        | `org.dxos.mdl.op@1.0`          |\n| `test`      | `org.dxos.mdl.test@1.0`        |\n\n## Types\n\n```mdl\ntype ComputeValueType\n  literals: string | number | boolean | object\n```\n\n```mdl\ntype NodeType\n  literals:\n    input | output | constant | template | switch | rng |\n    audio | chat | text | json | json-transform | surface |\n    beacon | scope | reducer | thread | queue | make-queue | append |\n    and | or | not | if | if-else |\n    function | gpt | gpt-realtime |\n    database | text-to-image\n```\n\n```mdl\ntype ComputeNode\n  desc: A node in the compute graph persisted via ECHO.\n  extends: [Graph.Node]\n  fields:\n    inputSchema?: JsonSchema\n    outputSchema?: JsonSchema\n    subgraph?: Ref<ComputeGraph>       # composition: nested graph\n    function?: Ref<PersistentOperation> # composition: reusable function node\n    valueType?: ComputeValueType        # for constant/template nodes\n    value?: any                         # for constant and template nodes\n    enabled?: boolean                   # for switch nodes\n```\n\n```mdl\ntype ComputeEdge\n  desc: A directed edge connecting an output port on one node to an input port on another.\n  extends: [Graph.Edge]\n  fields:\n    input: string                      # target node input property name\n    output: string                     # source node output property name\n```\n\n```mdl\ntype ComputeGraph\n  desc: Persistent ECHO object holding the full node-edge graph plus special I/O reference nodes.\n  fields:\n    graph: Graph.Graph\n    input?: ComputeNode\n    output?: ComputeNode\n```\n\n```mdl\ntype ValueBag\n  desc: A set of named asynchronous value effects passed between nodes.\n  fields:\n    _tag: \"ValueBag\"\n    values: Record<string, ValueEffect<any>>\n```\n\n## Components\n\n```mdl\ncomponent CanvasArticle\n  desc: Full-screen canvas editor for a ComputeGraph; renders as an article or a section embed.\n  props:\n    role: \"article\" | \"section\"\n    subject: CanvasBoard\n    attendableId?: string\n  state:\n    graph: CanvasGraphModel<ComputeShape>\n    controller?: ComputeGraphController\n    registry: ShapeRegistry\n    layout?: ComputeShapeLayout\n  slots:\n    toolbar?: ReactNode             # injected by AppSurface frame\n  layout: |\n    ┌──────────────────────────────────────────────┐\n    │  [toolbar — zoom, tools, minimap]            │\n    ├──────────────────────────────────────────────┤\n    │                                              │\n    │   ┌──────┐    ┌──────┐    ┌──────┐          │\n    │   │ node │───▶│ node │───▶│ node │          │\n    │   └──────┘    └──────┘    └──────┘          │\n    │                                              │\n    │   canvas — pan / zoom / connect nodes        │\n    └──────────────────────────────────────────────┘\n```\n\n## Operations\n\nPure operations — no effects, no service dependencies.\n\n```mdl\nop evalConstant\n  desc: Returns the scalar value stored on a constant node.\n  input:\n    node: ComputeNode\n  output: Scalar\n  errors:\n    MissingValue: node has no value set\n```\n\n```mdl\nop jsonTransform\n  desc: Evaluates a JSONPath expression over an input value.\n  input:\n    input: any\n    expression: string\n  output: any\n  errors:\n    InvalidExpression: JSONPath expression could not be parsed\n```\n\n```mdl\nop boolAnd\n  desc: Logical AND of two boolean inputs.\n  input:\n    a: boolean\n    b: boolean\n  output: boolean\n```\n\n```mdl\nop boolOr\n  desc: Logical OR of two boolean inputs.\n  input:\n    a: boolean\n    b: boolean\n  output: boolean\n```\n\n```mdl\nop boolNot\n  desc: Logical NOT of a boolean input.\n  input:\n    input: boolean\n  output: boolean\n```\n\n```mdl\nop ifRoute\n  desc: Routes a value to the true or false output port based on a condition.\n  input:\n    condition: boolean\n    value: any\n  output: IfOutput                   # { true?: any; false?: any }\n```\n\n```mdl\nop ifElseSelect\n  desc: Ternary — returns trueValue or falseValue depending on condition.\n  input:\n    condition: boolean\n    true: any\n    false: any\n  output: any\n```\n\nEffectful operations — mutate persistent state or call external services.\n\n```mdl\nop appendToQueue\n  desc: Appends items to an ECHO queue or collection identified by DXN.\n  input:\n    id: string                       # DXN — dxn:queue or dxn:echo\n    items: any[]\n  output: void\n  effects: [echo:write, feed:write]\n  errors:\n    UnsupportedDXN: DXN kind not supported\n    SpaceMismatch: ECHO DXN belongs to a different space\n```\n\n```mdl\nop createQueue\n  desc: Allocates a new append-only Feed and returns a Ref to it.\n  input:\n  output: Ref<Feed>\n  effects: [feed:write]\n```\n\n```mdl\nop invokeGpt\n  desc: Sends the current conversation thread to the configured AI model and streams the reply.\n  input:\n    thread: Ref<Thread>\n    tools?: Tool[]\n    systemPrompt?: string\n  output: Message\n  effects: [http]\n  requires: [AiService]\n  errors:\n    ModelUnavailable: AI service could not be reached\n```\n\n```mdl\nop invokeFunction\n  desc: Deserialises a PersistentOperation from ECHO and invokes it with the provided input bag.\n  input:\n    function: Ref<PersistentOperation>\n    input: any\n  output: any\n  effects: [echo:read]\n  requires: [Database.Service, OperationRegistry.Service]\n  errors:\n    FunctionNotFound: referenced operation does not exist\n    InvocationFailed: operation returned an error\n```\n\n## Features\n\n```mdl\nfeat F-1: Canvas Editor\n\n  req F-1.1: User can create a new compute graph via the \"Create object\" entry.\n  req F-1.2: Canvas renders nodes as draggable, resizable shapes on an infinite panning surface.\n  req F-1.3:\n    when: user drags from an output port to an input port\n    then: a ComputeEdge is created connecting the two ports\n  req F-1.4:\n    when: a ComputeEdge is deleted\n    then: downstream nodes stop receiving values from the disconnected output\n```\n\n```mdl\nfeat F-2: Node Palette\n\n  req F-2.1: Toolbar exposes all built-in NodeTypes; user can drag them onto the canvas.\n  req F-2.2: Constant nodes display an inline editor for their scalar value and valueType.\n  req F-2.3: Template nodes render a text input with {{variable}} interpolation.\n  req F-2.4: Function nodes allow selecting a PersistentOperation from the space.\n```\n\n```mdl\nfeat F-3: Reactive Execution\n\n  req F-3.1:\n    when: any upstream node value changes\n    then: ComputeGraphController re-evaluates dependent nodes in topological order\n\n  req F-3.2: Node execution is lazy; nodes only run when their outputs are consumed.\n\n  req F-3.3:\n    when: a node fails with ConductorError\n    then: downstream nodes receive a NotExecuted marker and do not throw\n\n  req F-3.4:\n    when: a node emits a ValueBag\n    then: individual output ports can resolve at different times (async bag semantics)\n```\n\n```mdl\nfeat F-4: AI Integration\n\n  req F-4.1: GPT node connects to AiService; configuration includes model, system prompt, and tools.\n  req F-4.2:\n    when: GPT node executes\n    then: op:invokeGpt streams the model response back to the output port\n\n  req F-4.3: Function node can reference any PersistentOperation registered in the space.\n```\n\n```mdl\nfeat F-5: Data Sources and Sinks\n\n  req F-5.1: Queue node reads messages from a Feed referenced by DXN.\n  req F-5.2: Append node writes items to a Feed or ECHO collection referenced by DXN.\n  req F-5.3: Database node exposes ECHO space contents as a query tool for AI nodes.\n  req F-5.4: Thread node surfaces a conversation thread with its message history.\n```\n\n```mdl\nfeat F-6: Logic and Control Flow\n\n  req F-6.1: If node routes a value to true or false output port based on a boolean condition.\n  req F-6.2: IfElse node selects one of two values using a ternary condition.\n  req F-6.3: Reducer node collects an array of values from multiple upstream ports.\n  req F-6.4: And / Or / Not nodes implement standard boolean combinators.\n```\n\n```mdl\nfeat F-7: Persistence and Collaboration\n\n  req F-7.1: ComputeGraph is stored as an ECHO object; graph topology is replicated to peers.\n  req F-7.2:\n    when: a peer modifies a node value or edge\n    then: all collaborators see the change reflected on the canvas in real time\n\n  req F-7.3:\n    when: a CanvasBoard is embedded as a section in another document\n    then: the graph renders in the section aspect-square container and remains interactive\n```\n\n## Acceptance\n\n```mdl\nscenario T-1: Create empty graph\n  given: user opens the Create Object menu\n  when: user selects \"Compute Graph\"\n  then:\n    - a new CanvasBoard with an empty ComputeGraph is created in the space\n    - the canvas opens with no nodes\n```\n\n```mdl\nscenario T-2: Add constant node and read value\n  given: an empty canvas\n  when: user adds a constant node, sets value \"hello\", connects it to a text node\n  then:\n    - text node receives \"hello\" on its input port\n    - text node renders \"hello\"\n```\n\n```mdl\nscenario T-3: Boolean AND gate\n  given: two switch nodes with values true and false connected to an AND node\n  when: graph executes\n  then:\n    - AND node output is false\n    - switching both inputs to true produces output true\n```\n\n```mdl\nscenario T-4: JSONPath transform\n  given: a constant node with value { \"a\": { \"b\": 42 } } connected to a json-transform node\n  when: expression \"$.a.b\" is set on the transform node\n  then:\n    - output port value is [42]\n```\n\n```mdl\nscenario T-5: GPT node invocation\n  given: a thread node connected to a GPT node with a system prompt\n  when: graph executes with AiService available\n  then:\n    - GPT node output port receives a Message\n    - Message content is non-empty\n  errors: [ModelUnavailable]\n```\n\n```mdl\nscenario T-6: Append to queue\n  given: a make-queue node connected to an append node; constant node provides input items\n  when: graph executes\n  then:\n    - queue contains the appended items\n    - downstream queue node reads them back\n```\n\n```mdl\nscenario T-7: Collaborative edit\n  given: two peers have the same CanvasBoard open\n  when: peer A moves a node on the canvas\n  then:\n    - peer B sees the node in the new position within one replication round-trip\n    tags: [collaborative]\n```\n\n```mdl\nscenario T-8: NotExecuted propagation\n  given: an if node whose condition is false, connected to a text node on the true port\n  when: graph executes\n  then:\n    - text node receives a NotExecuted marker\n    - text node renders nothing (no error thrown)\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\n```mdl\ntest QA-1: Build and run a small compute graph\n  desc: |\n    The core canvas round-trip — create a graph, wire a constant into a JSON transform, and read\n    the reactive result. None of the node kernels (`evalConstant`, `jsonTransform`, ...) are\n    registered operations: they run inside the graph's own reactive controller when the canvas\n    triggers evaluation, not through the operation invoker, so this test is entirely human — the\n    same gap plugin-chess documents for move-less game creation.\n  actors: human\n  covers: [F-1.1, F-1.2, F-1.3, F-2.1, F-2.2, F-3.1, F-3.2, T-1, T-2]\n  status: unverified\n  given:\n    - an identity exists\n    - space: a space is open\n    - collection: a collection in that space, to create into\n    - no CanvasBoard named \"QA Graph\" exists — ABORT rather than deleting one this test did not\n      create\n  steps:\n    - name: Create the graph\n      do: In the navtree, click + on a collection and choose Compute Graph. Name it \"QA Graph\".\n      expect: an empty CanvasBoard/ComputeGraph opens on the canvas\n      note: |\n        NO `invoke` — \"Create object\" for CanvasBoard constructs the object locally and only\n        calls `space.addObject` (see `create-object.ts`); there is no dedicated\n        `createComputeGraph` operation despite F-1.1's phrasing, so this step is human-only.\n    - name: Add a constant node\n      do: Drag \"Constant\" from the node palette onto the canvas. Set its value to 42 and\n        valueType to \"number\".\n      expect: a constant node appears on the canvas showing 42\n    - name: Add a JSON transform node\n      do: Drag \"JSON Transform\" onto the canvas. Set its expression to \"$\".\n      expect: a JSON transform node appears on the canvas\n    - name: Wire them together\n      do: Drag from the constant node's output port to the JSON transform node's input port.\n      expect: a ComputeEdge connects the two nodes\n    - name: Read the result\n      do: Click the JSON transform node to inspect its output, or connect a text/output node to it.\n      expect: the transform node's output shows 42 (its own re-evaluation, triggered by the\n        upstream constant, per F-3.1's topological order)\n  after:\n    - name: Delete the graph\n      do: Right-click \"QA Graph\" in the navtree and choose Delete.\n      invoke: |\n        org.dxos.operation.space.removeObjects {\n          objects: [(await space.db.query(dxos.Filter.type(dxos.DXN.make('org.dxos.type.canvasBoard'))).run()).objects\n            .find((o) => o.name === 'QA Graph')\n            ?? (() => { throw new Error(\"CanvasBoard QA Graph not found — refusing to remove an unrelated object\"); })()],\n          target: $given.collection\n        }\n      expect: the row leaves the navtree and its plank closes\n      note: |\n        No captured id exists — the create step has no `invoke` (see above) — so this resolves\n        \"QA Graph\" by typename AND name — a name match alone would delete any object carrying it, and throws rather than removing anything when the name does not\n        match, since `given` guarantees no pre-existing board carries it.\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\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\n    state?: FieldMap\n    slots?: FieldMap\n    actions?: ActionMap\n    emits?: EventMap\n    layout?: CodeBlock\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\n    output?: TypeExpr\n    errors?: ErrorMap\n    effects?: EffectList\n    requires?: ServiceList\n    note?: Prose\n```\n";
+//#endregion
+export { PLUGIN_default as t };
+
+//# sourceMappingURL=chunk-PLUGIN.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-PLUGIN.mjs","names":[],"sources":[],"mappings":""}

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

@@ -1,8 +1,8 @@
 import * as Effect from "effect/Effect";
 import * as Capability from "@dxos/app-framework/Capability";
 import * as Capabilities from "@dxos/app-framework/Capabilities";
-import { Surface } from "@dxos/app-framework/ui";
-import { AppSurface } from "@dxos/app-toolkit/ui";
+import * as Surface from "@dxos/app-framework/Surface";
+import * as AppSurface from "@dxos/app-toolkit/AppSurface";
 import { CanvasBoard } from "@dxos/react-ui-canvas-editor";
 import { CanvasArticle } from "#containers";
 //#region src/capabilities/react-surface.ts

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

@@ -1 +1 @@
-{"version":3,"file":"chunk-react-surface.mjs","names":[],"sources":["../../src/capabilities/react-surface.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport { Surface } from '@dxos/app-framework/ui';\nimport { AppSurface } from '@dxos/app-toolkit/ui';\nimport { CanvasBoard } from '@dxos/react-ui-canvas-editor';\n\nimport { CanvasArticle } from '#containers';\n\nexport default Capability.makeModule(() =>\n  Effect.succeed(\n    Capability.contribute(\n      Capabilities.ReactSurface,\n      Surface.create({\n        id: 'root',\n        // TODO(wittjosiah): Split into multiple surfaces if this filter proves too strict for non-article roles.\n        filter: AppSurface.oneOf(\n          AppSurface.object(AppSurface.Article, CanvasBoard.CanvasBoard),\n          AppSurface.object(AppSurface.Section, CanvasBoard.CanvasBoard),\n        ),\n        component: CanvasArticle,\n        props: ({ role, data: { subject, attendableId } }) => ({ role, subject, attendableId }),\n      }),\n    ),\n  ),\n);\n"],"mappings":";;;;;;;;AAcA,IAAA,wBAAe,WAAW,iBACxB,OAAO,QACL,WAAW,WACT,aAAa,cACb,QAAQ,OAAO;CACb,IAAI;CAEJ,QAAQ,WAAW,MACjB,WAAW,OAAO,WAAW,SAAS,YAAY,WAAW,GAC7D,WAAW,OAAO,WAAW,SAAS,YAAY,WAAW,CAC/D;CACA,WAAW;CACX,QAAQ,EAAE,MAAM,MAAM,EAAE,SAAS,sBAAsB;EAAE;EAAM;EAAS;CAAa;AACvF,CAAC,CACH,CACF,CACF"}
+{"version":3,"file":"chunk-react-surface.mjs","names":[],"sources":["../../src/capabilities/react-surface.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as Surface from '@dxos/app-framework/Surface';\nimport * as AppSurface from '@dxos/app-toolkit/AppSurface';\nimport { CanvasBoard } from '@dxos/react-ui-canvas-editor';\n\nimport { CanvasArticle } from '#containers';\n\nexport default Capability.makeModule(() =>\n  Effect.succeed(\n    Capability.contribute(\n      Capabilities.ReactSurface,\n      Surface.create({\n        id: 'root',\n        // TODO(wittjosiah): Split into multiple surfaces if this filter proves too strict for non-article roles.\n        filter: AppSurface.oneOf(\n          AppSurface.object(AppSurface.Article, CanvasBoard.CanvasBoard),\n          AppSurface.object(AppSurface.Section, CanvasBoard.CanvasBoard),\n        ),\n        component: CanvasArticle,\n        props: ({ role, data: { subject, attendableId } }) => ({ role, subject, attendableId }),\n      }),\n    ),\n  ),\n);\n"],"mappings":";;;;;;;;AAcA,IAAA,wBAAe,WAAW,iBACxB,OAAO,QACL,WAAW,WACT,aAAa,cACb,QAAQ,OAAO;CACb,IAAI;CAEJ,QAAQ,WAAW,MACjB,WAAW,OAAO,WAAW,SAAS,YAAY,WAAW,GAC7D,WAAW,OAAO,WAAW,SAAS,YAAY,WAAW,CAC/D;CACA,WAAW;CACX,QAAQ,EAAE,MAAM,MAAM,EAAE,SAAS,sBAAsB;EAAE;EAAM;EAAS;CAAa;AACvF,CAAC,CACH,CACF,CACF"}

package/dist/lib/containers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"containers.mjs","names":[],"sources":["../../src/containers/index.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport { type ComponentType, lazy } from 'react';\n\nexport const CanvasArticle: ComponentType<any> = lazy(() => import('./CanvasArticle'));\n"],"mappings":";;AAMA,IAAa,gBAAoC,WAAW,OAAO,4BAAkB"}
+{"version":3,"file":"containers.mjs","names":[],"sources":["../../src/containers/index.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport { type ComponentType, lazy } from 'react';\n\nexport const CanvasArticle: ComponentType<any> = lazy(() => import('./CanvasArticle/index.ts'));\n"],"mappings":";;AAMA,IAAa,gBAAoC,WAAW,OAAO,4BAA2B"}

package/dist/lib/index.mjs

@@ -1,4 +1,3 @@
 import { t as ConductorPlugin_exports } from "./ConductorPlugin.mjs";
 import { t as ConductorEvents_exports } from "./ConductorEvents.mjs";
-export * from "#meta";
 export { ConductorEvents_exports as ConductorEvents, ConductorPlugin_exports as ConductorPlugin };

package/dist/lib/meta.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"meta.mjs","names":[],"sources":["../../dx.config.ts","../../src/meta.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Config2 } from '@dxos/app-framework/config';\nimport { trim } from '@dxos/util';\n\nexport default Config2.make({\n  plugin: {\n    key: 'org.dxos.plugin.conductor',\n    name: 'Conductor',\n    author: 'DXOS',\n    description: trim`\n      Conductor is a visual node-based compute graph plugin for DXOS Composer.\n      It lets you compose reactive data pipelines by connecting typed input and output ports on a\n      drag-and-drop infinite canvas — no code required for common automation patterns.\n\n      Each node in the graph is a first-class ECHO object, so the full pipeline topology is\n      replicated to every collaborator in real time via the local-first runtime.\n      Built-in node types cover constants, templates, boolean logic, control flow, JSON transforms,\n      ECHO database access, append-only queues, and conversation threads.\n\n      AI orchestration is a first-class concern: the GPT node connects to plugin-assistant's AiService\n      and supports tool calling, streaming replies, and configurable system prompts.\n      Function nodes can invoke any Skill operation registered in the space, making it straightforward\n      to compose multi-step agent workflows visually and share them across teams.\n    `,\n    icon: { key: 'ph--infinity--regular', hue: 'sky' },\n    source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-conductor',\n    spec: 'PLUGIN.mdl',\n    tags: ['labs'],\n    screenshots: [{ dark: 'https://media.dxos.network/plugin-details-canvas-dark.png' }],\n  },\n});\n","//\n// Copyright 2023 DXOS.org\n//\n\nimport * as Plugin from '@dxos/app-framework/Plugin';\n\nimport config from '../dx.config';\n\nexport const meta = Plugin.getMetaFromConfig(config);\n"],"mappings":";;;;AAOA,IAAA,oBAAe,QAAQ,KAAK,EAC1B,QAAQ;CACN,KAAK;CACL,MAAM;CACN,QAAQ;CACR,aAAa,IAAI;;;;;;;;;;;;;;;CAejB,MAAM;EAAE,KAAK;EAAyB,KAAK;CAAM;CACjD,QAAQ;CACR,MAAM;CACN,MAAM,CAAC,MAAM;CACb,aAAa,CAAC,EAAE,MAAM,4DAA4D,CAAC;AACrF,EACF,CAAC;;;ACzBD,IAAa,OAAO,OAAO,kBAAkB,iBAAM"}
+{"version":3,"file":"meta.mjs","names":[],"sources":["../../dx.config.ts","../../src/meta.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Config2 } from '@dxos/app-framework/config';\nimport { trim } from '@dxos/util';\n\nexport default Config2.make({\n  plugin: {\n    key: 'org.dxos.plugin.conductor',\n    name: 'Conductor',\n    author: 'DXOS',\n    description: trim`\n      Conductor is a visual node-based compute graph plugin for DXOS Composer.\n      It lets you compose reactive data pipelines by connecting typed input and output ports on a\n      drag-and-drop infinite canvas — no code required for common automation patterns.\n\n      Each node in the graph is a first-class ECHO object, so the full pipeline topology is\n      replicated to every collaborator in real time via the local-first runtime.\n      Built-in node types cover constants, templates, boolean logic, control flow, JSON transforms,\n      ECHO database access, append-only queues, and conversation threads.\n\n      AI orchestration is a first-class concern: the GPT node connects to plugin-assistant's AiService\n      and supports tool calling, streaming replies, and configurable system prompts.\n      Function nodes can invoke any Skill operation registered in the space, making it straightforward\n      to compose multi-step agent workflows visually and share them across teams.\n    `,\n    icon: { key: 'ph--infinity--regular', hue: 'sky' },\n    source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-conductor',\n    spec: 'PLUGIN.mdl',\n    tags: ['labs'],\n    screenshots: [{ dark: 'https://media.dxos.network/plugin-details-canvas-dark.png' }],\n  },\n});\n","//\n// Copyright 2023 DXOS.org\n//\n\nimport * as Plugin from '@dxos/app-framework/Plugin';\n\nimport config from '../dx.config.ts';\n\nexport const meta = Plugin.getMetaFromConfig(config);\n"],"mappings":";;;;AAOA,IAAA,oBAAe,QAAQ,KAAK,EAC1B,QAAQ;CACN,KAAK;CACL,MAAM;CACN,QAAQ;CACR,aAAa,IAAI;;;;;;;;;;;;;;;CAejB,MAAM;EAAE,KAAK;EAAyB,KAAK;CAAM;CACjD,QAAQ;CACR,MAAM;CACN,MAAM,CAAC,MAAM;CACb,aAAa,CAAC,EAAE,MAAM,4DAA4D,CAAC;AACrF,EACF,CAAC;;;ACzBD,IAAa,OAAO,OAAO,kBAAkB,iBAAM"}

package/dist/lib/translations.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"translations.mjs","names":[],"sources":["../../src/translations.ts"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport { Type } from '@dxos/echo';\nimport { type Resource } from '@dxos/react-ui';\nimport { CanvasBoard } from '@dxos/react-ui-canvas-editor/types';\n\nimport { meta } from '#meta';\n\nexport const translations = [\n  {\n    'en-US': {\n      [Type.getTypename(CanvasBoard.CanvasBoard)]: {\n        'typename.label': 'Circuit',\n        'typename.label_zero': 'Circuits',\n        'typename.label_one': 'Circuit',\n        'typename.label_other': 'Circuits',\n        'object-name.placeholder': 'New circuit',\n        'add-object.label': 'Add circuit',\n        'rename-object.label': 'Rename circuit',\n        'delete-object.label': 'Delete circuit',\n        'object-deleted.label': 'Circuit deleted',\n      },\n      [meta.profile.key]: {\n        'plugin.name': 'Conductor',\n        'content.placeholder': 'Enter text...',\n      },\n    },\n  },\n] as const satisfies Resource[];\n"],"mappings":";;;;AAUA,IAAa,eAAe,CAC1B,EACE,SAAS;EACN,KAAK,YAAY,YAAY,WAAW,IAAI;EAC3C,kBAAkB;EAClB,uBAAuB;EACvB,sBAAsB;EACtB,wBAAwB;EACxB,2BAA2B;EAC3B,oBAAoB;EACpB,uBAAuB;EACvB,uBAAuB;EACvB,wBAAwB;CAC1B;EACC,KAAK,QAAQ,MAAM;EAClB,eAAe;EACf,uBAAuB;CACzB;AACF,EACF,CACF"}
+{"version":3,"file":"translations.mjs","names":[],"sources":["../../src/translations.ts"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport { Type } from '@dxos/echo';\nimport { CanvasBoard } from '@dxos/react-ui-canvas-editor/types';\nimport type * as Theme from '@dxos/react-ui/Theme';\n\nimport { meta } from '#meta';\n\nexport const translations = [\n  {\n    'en-US': {\n      [Type.getTypename(CanvasBoard.CanvasBoard)]: {\n        'typename.label': 'Circuit',\n        'typename.label_zero': 'Circuits',\n        'typename.label_one': 'Circuit',\n        'typename.label_other': 'Circuits',\n        'object-name.placeholder': 'New circuit',\n        'add-object.label': 'Add circuit',\n        'rename-object.label': 'Rename circuit',\n        'delete-object.label': 'Delete circuit',\n        'object-deleted.label': 'Circuit deleted',\n      },\n      [meta.profile.key]: {\n        'plugin.name': 'Conductor',\n        'content.placeholder': 'Enter text...',\n      },\n    },\n  },\n] as const satisfies Theme.Resource[];\n"],"mappings":";;;;AAUA,IAAa,eAAe,CAC1B,EACE,SAAS;EACN,KAAK,YAAY,YAAY,WAAW,IAAI;EAC3C,kBAAkB;EAClB,uBAAuB;EACvB,sBAAsB;EACtB,wBAAwB;EACxB,2BAA2B;EAC3B,oBAAoB;EACpB,uBAAuB;EACvB,uBAAuB;EACvB,wBAAwB;CAC1B;EACC,KAAK,QAAQ,MAAM;EAClB,eAAe;EACf,uBAAuB;CACzB;AACF,EACF,CACF"}

package/dist/types/src/capabilities/gen/browser.d.ts

@@ -0,0 +1,6 @@
+export declare const CreateObject: import("@dxos/app-framework/Capability").Module<void>;
+export declare const PluginAsset: import("@dxos/app-framework/Capability").Module<void>;
+export declare const ReactSurface: import("@dxos/app-framework/Capability").Module<void>;
+export declare const Schema: import("@dxos/app-framework/Capability").Module<void>;
+export declare const Translations: import("@dxos/app-framework/Capability").Module<void>;
+//# sourceMappingURL=browser.d.ts.map

package/dist/types/src/capabilities/gen/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/gen/browser.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,YAAY,uDAAoE,CAAC;AAE9F,eAAO,MAAM,WAAW,uDAKtB,CAAC;AAEH,eAAO,MAAM,YAAY,uDAEvB,CAAC;AAEH,eAAO,MAAM,MAAM,uDAAqD,CAAC;AAEzE,eAAO,MAAM,YAAY,uDAA2C,CAAC"}

package/dist/types/src/capabilities/gen/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/gen/node.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,YAAY,uDAAiE,CAAC;AAE3F,eAAO,MAAM,MAAM,uDAAkD,CAAC;AAEtE,eAAO,MAAM,YAAY,uDAA2C,CAAC;AAErE,eAAO,MAAM,WAAW,WAAY,CAAC;AACrC,eAAO,MAAM,YAAY,WAAY,CAAC"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/gen/node.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,YAAY,uDAAoE,CAAC;AAE9F,eAAO,MAAM,MAAM,uDAAqD,CAAC;AAEzE,eAAO,MAAM,YAAY,uDAA2C,CAAC;AAErE,eAAO,MAAM,WAAW,WAAY,CAAC;AACrC,eAAO,MAAM,YAAY,WAAY,CAAC"}