@dxos/plugin-devtools 0.12.0-next-2800d0376abcc62d5544afdd744b16b2b960434e → 0.13.0

package/PLUGIN.mdl

@@ -4,7 +4,7 @@ name: DevtoolsPlugin
 version: 0.1.0
 ---
 
-Developer inspector plugin for `DXOS` Composer — structured devtools panels for Client/HALO/ECHO/Mesh/EDGE subsystems, an app-graph inspector, and a tools explorer. Debugging utilities (object generation, wireframe overlays, per-object inspection, stats) live in the sibling `@dxos/plugin-debug`.
+Developer inspector plugin for `DXOS` Composer — structured devtools panels for Client/HALO/ECHO/Mesh/EDGE subsystems, an app-graph inspector, and a tools explorer. The tree attaches to the hidden `root/debug` app-graph category (`AppNodeMatcher.whenDebugGroup`) and is reached only through the floating debug panel that `@dxos/plugin-debug` renders from the status bar — never the main navtree, the deck, or a URL. Debugging utilities (object generation, wireframe overlays, per-object inspection, stats) live in the sibling `@dxos/plugin-debug`.
 
 ## Extensions
 
@@ -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
 
@@ -64,17 +65,30 @@ component DebugStatus
 
 ```mdl
 component DevtoolsOverviewContainer
-  desc: Deck-companion panel that provides quick access to all devtools sections via a categorised link list.
+  desc: |
+    The "Stats" deck companion: polls the client's stats once (`useStats`) and renders `StatsPanel`
+    (`@dxos/devtools`) — a toolbar with refresh and live toggle over a scrolling stack of cards —
+    with one `AppSurface.DevtoolsOverview` surface as its children, passing
+    `DevtoolsCardData { stats, surfaceProfilerStats, onClearSurfaceProfiler }`. Every card is a
+    surface on that role ordered by `position`: memory, network, EDGE, performance, swarm
+    announcements, surfaces (profiler), database, replicator, messages, queries, sync, frame rate
+    (0–12), then plugin-debug's compartment cards (20) and other contributors (e.g.
+    plugin-calls). A card is a `StatCard` (`@dxos/devtools`): a `Card.Header` with an icon,
+    title, figure and one control, over compact `Card.Row`s whose leading gutter carries a status
+    icon and whose trailing gutter carries a control.
   layout: |
-    ┌─────────────────────────────┐
-    │  Client  ▸ Config / Storage │
-    │            Logs / Diag      │
-    │  HALO    ▸ Identity / Keys  │
-    │  ECHO    ▸ Spaces / Feeds   │
-    │            Objects / Schema │
-    │  Mesh    ▸ Signal / Swarm   │
-    │  EDGE    ▸ Dashboard / …    │
-    └─────────────────────────────┘
+    ┌───────────────────────────────┐
+    │ Stats            ↻  ▶         │
+    ├───────────────────────────────┤
+    │ ┌ ▣ Memory ──────────────────┐│
+    │ │   Used heap        42.1 MB ││
+    │ │ ⚠ Used of available    46% ││
+    │ └────────────────────────────┘│
+    │ ┌ ☁ EDGE   healthy        ⋮ ┐│
+    │ │ ✓ Websocket      connected ││
+    │ └────────────────────────────┘│
+    │ …                             │
+    └───────────────────────────────┘
 ```
 
 ```mdl
@@ -137,30 +151,30 @@ The following components are thin wrappers around `@dxos/devtools` panel compone
 
 | Component              | Devtools node              | Displays                                |
 |------------------------|----------------------------|-----------------------------------------|
-| ConfigPanel            | Client.Config              | Vault config JSON viewer                |
-| StoragePanel           | Client.Storage             | Local storage browser                   |
-| LoggingPanel           | Client.Logs                | Live log stream; download via logStore  |
-| DiagnosticsPanel       | Client.Diagnostics         | Client health / metric charts           |
-| IdentityPanel          | Halo.Identity              | Local identity key + device list        |
-| DeviceListPanel        | Halo.Devices               | All devices paired with this identity   |
-| KeyringPanel           | Halo.Keyring               | Raw keyring entries                     |
-| CredentialsPanel       | Halo.Credentials           | Credentials held in the active space    |
-| SpaceListPanel         | Echo.Spaces                | All spaces with state + select action   |
-| SpaceInfoPanel         | Echo.Space                 | Selected space feeds / pipelines        |
-| FeedsPanel             | Echo.Feeds                 | Feed entries for the active space       |
-| ObjectsPanel           | Echo.Objects               | All objects in the active space         |
-| SchemaPanel            | Echo.Schema                | Schemas registered in the active space  |
-| AutomergePanel         | Echo.Automerge             | Automerge document internals            |
-| QueuesPanel            | Echo.Queues                | Pending queue items                     |
-| MembersPanel           | Echo.Members               | Space members with last-seen            |
-| MetadataPanel          | Echo.Metadata              | Space/feed metadata blobs               |
-| SignalPanel            | Mesh.Signal                | Signal-server connection state          |
-| SwarmPanel             | Mesh.Swarm                 | Active swarm peers                      |
-| NetworkPanel           | Mesh.Network               | Full network topology for active space  |
-| EdgeDashboardPanel     | Edge.Dashboard             | EDGE node health / worker stats         |
-| WorkflowPanel          | Edge.Workflows             | Workflow definitions in active space    |
+| ConfigArticle            | Client.Config              | Vault config JSON viewer                |
+| StorageArticle           | Client.Storage             | Local storage browser                   |
+| LoggingArticle           | Client.Logs                | Live log stream; download via logStore  |
+| DiagnosticsArticle       | Client.Diagnostics         | Client health / metric charts           |
+| IdentityArticle          | Halo.Identity              | Local identity key + device list        |
+| DeviceListArticle        | Halo.Devices               | All devices paired with this identity   |
+| KeyringArticle           | Halo.Keyring               | Raw keyring entries                     |
+| CredentialsArticle       | Halo.Credentials           | Credentials held in the active space    |
+| SpaceListArticle         | Echo.Spaces                | All spaces with state + select action   |
+| SpaceInfoArticle         | Echo.Space                 | Selected space feeds / pipelines        |
+| FeedsArticle             | Echo.Feeds                 | Feed entries for the active space       |
+| ObjectsArticle           | Echo.Objects               | All objects in the active space         |
+| SchemaArticle            | Echo.Schema                | Schemas registered in the active space  |
+| AutomergeArticle         | Echo.Automerge             | Automerge document internals            |
+| QueuesArticle            | Echo.Queues                | Pending queue items                     |
+| MembersArticle           | Echo.Members               | Space members with last-seen            |
+| MetadataArticle          | Echo.Metadata              | Space/feed metadata blobs               |
+| SignalArticle            | Mesh.Signal                | Signal-server connection state          |
+| SwarmArticle             | Mesh.Swarm                 | Active swarm peers                      |
+| NetworkArticle           | Mesh.Network               | Full network topology for active space  |
+| EdgeDashboardArticle     | Edge.Dashboard             | EDGE node health / worker stats         |
+| WorkflowArticle          | Edge.Workflows             | Workflow definitions in active space    |
 | InvocationTraceContainer | Edge.Traces              | Invocation trace timeline from feed     |
-| TestingPanel           | Edge.Testing               | Integration test harness for EDGE       |
+| TestingArticle           | Edge.Testing               | Integration test harness for EDGE       |
 | ToolsExplorer          | ToolsExplorer              | MCP-backed tools explorer               |
 
 ## Operations
@@ -173,12 +187,14 @@ No first-party operations are defined by DebugPlugin. The plugin invokes `SpaceO
 feat F-1: Devtools Graph Node
 
   req F-1.1:
-    when: DebugPlugin is loaded
-    then: a "Devtools" node appears pinned at the end of each root and space in the nav graph
+    when: DevtoolsPlugin is loaded
+    then: a "DevTools" branch (`root/debug/devtools`) appears under the hidden `root/debug` category, listed in the floating debug panel's sidebar after Console and Logs
 
-  req F-1.2: The Devtools node contains sub-trees for Client, HALO, ECHO, Mesh, and EDGE categories.
-  req F-1.3: An app-graph sub-node renders DebugGraph rooted at the current space or root.
+  req F-1.2: The DevTools branch contains sub-trees for Client, HALO, ECHO, MESH, and EDGE categories, plus App Graph, SDK Explorer, and CLI pages.
+  req F-1.3: An app-graph sub-node renders DebugGraph rooted at the graph root.
   req F-1.4: A tools-explorer sub-node renders ToolsExplorer connected to the MCP introspect service.
+  req F-1.5: No devtools node declares a URL binding; selecting one renders its article in the panel and leaves `window.location` unchanged.
+  req F-1.6: A space-scoped inspector resolves the active workspace's space at render time; no space travels in node data.
 ```
 
 ```mdl
@@ -205,18 +221,18 @@ feat F-3: Space Object Explorer
 feat F-4: Devtools Overview Companion
 
   req F-4.1:
-    when: user opens the "Devtools" deck companion
-    then: DevtoolsOverviewContainer renders a categorised link list to all devtools panels
+    when: user opens the "Stats" deck companion
+    then: DevtoolsOverviewContainer renders the card stack, one card per `AppSurface.DevtoolsOverview` contribution
 
-  req F-4.2: Clicking a category link navigates the deck to the corresponding devtools article.
+  req F-4.2: Every devtools page is an article — `Panel.Root role` with an optional toolbar over its content — registered on its `Devtools.*` id from `react-surface.ts`; `@dxos/devtools` exports them as `*Article` from `containers/panels`.
 ```
 
 ```mdl
 feat F-5: Space Data Generator
 
   req F-5.1:
-    when: user navigates to the debug node under a space
-    then: SpaceGenerator is rendered as the article
+    when: user selects Debug → Generate objects in the debug panel
+    then: SpaceGenerator is rendered as the panel's article, bound to the active workspace's space
 
   req F-5.2:
     when: user triggers object generation
@@ -242,7 +258,7 @@ feat F-7: Log Capture and Download
 
   req F-7.1:
     when: logStore is provided in DebugPluginOptions
-    then: LoggingPanel can stream and display captured log entries
+    then: LoggingArticle can stream and display captured log entries
 
   req F-7.2:
     when: user clicks download in DebugSettings
@@ -262,16 +278,17 @@ feat F-8: Global Dev Utilities
 ## Acceptance
 
 ```mdl
-test T-1: Devtools node appears in nav graph
-  given: Composer loaded with DebugPlugin enabled
-  when: user opens the navigation tree
+scenario T-1: Devtools tree appears in the debug panel
+  given: Composer loaded with DevtoolsPlugin and DebugPlugin enabled
+  when: user opens the debug panel from the status bar
   then:
-    - "Devtools" node is visible pinned at the end of the root
-    - sub-nodes Client, HALO, ECHO, Mesh, EDGE are present
+    - the sidebar lists Console, Logs, DevTools, Debug
+    - expanding DevTools shows App Graph, SDK Explorer, CLI, Client, HALO, ECHO, MESH, EDGE
+    - the main navtree's SYSTEM group shows only Database
 ```
 
 ```mdl
-test T-2: Debug companion on ECHO object
+scenario T-2: Debug companion on ECHO object
   given: a Document is open in the deck
   when: user clicks the "Debug" companion tab
   then:
@@ -279,7 +296,7 @@ test T-2: Debug companion on ECHO object
 ```
 
 ```mdl
-test T-3: Wireframe overlay toggle
+scenario T-3: Wireframe overlay toggle
   given: DebugPlugin settings panel is open
   when: user enables the wireframe toggle
   then:
@@ -290,16 +307,16 @@ test T-3: Wireframe overlay toggle
 ```
 
 ```mdl
-test T-4: Space object generation
+scenario T-4: Space object generation
   given: a space with an empty collection is active
-  when: user opens the debug space node and generates 10 objects
+  when: user opens Debug → Generate objects in the debug panel and generates 10 objects
   then:
     - 10 new objects appear in the active collection
     - DebugStatus shows "running" while generation is in progress
 ```
 
 ```mdl
-test T-5: Log download
+scenario T-5: Log download
   given: logStore is configured and some log entries have been captured
   when: user clicks "Download Logs" in DebugSettings
   then:
@@ -308,6 +325,76 @@ test T-5: Log download
 
 ---
 
+## 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.
+
+plugin-devtools defines no first-party operations (see "Operations" above), so most of its
+journeys are navigation and settings toggles with no `invoke`. It is a dev-only default: on in
+`isDev` builds, off otherwise (see `packages/apps/composer-app/src/plugin-defs.tsx`).
+
+```mdl
+test QA-1: Open the Devtools node and inspect an object
+  desc: The core devtools round-trip — navigate to the Devtools tree and open the Debug companion on an object.
+  actors: both
+  covers: [F-1.1, F-1.2, F-2.1, F-2.2, T-1, T-2]
+  status: unverified
+  given:
+    - an identity exists
+    - space: a space is open
+    - plugin-devtools is enabled (dev-only default; see above)
+    - doc1: a Document already exists in the space
+  steps:
+    - name: Open the DevTools tree in the debug panel
+      do: Click the status-bar debug button (terminal icon), then expand "DevTools" in the panel's sidebar and open Client → Config.
+      expect: the sidebar shows Client, HALO, ECHO, MESH, and EDGE sub-trees and the Config JSON renders in the panel; `window.location` is unchanged
+      note: |
+        NO `invoke` — devtools nodes have no URL binding and never open in the deck, so
+        `appToolkit.open` does not reach them. Human-only step; an agent run reports it unverified.
+    - name: Open the Debug companion on an object
+      do: Click "$given.doc1" in the navtree, then select the "Debug" companion tab.
+      invoke: org.dxos.operation.appToolkit.updateCompanion { open: true, variant: "debug" }
+      expect: DebugObjectPanel renders the object's DXN, typename, and raw field map
+  after:
+    - name: Close the companion
+      do: Click the companion toggle again.
+      invoke: org.dxos.operation.appToolkit.updateCompanion { open: false }
+      expect: the companion pane closes
+```
+
+```mdl
+test QA-2: Generate synthetic objects into a collection
+  desc: |
+    The write path behind the Space Data Generator — the agent binding invokes the shared
+    space.addObject operation directly rather than driving the SpaceGenerator surface, so this
+    exercises F-5.2 (object creation) only, not F-5.1 (the surface rendering).
+  actors: agent
+  covers: [F-5.2, T-4]
+  status: unverified
+  given:
+    - an identity exists
+    - space: a space is open
+    - collection: a collection in that space, empty of synthetic objects
+    - plugin-devtools is enabled (dev-only default; see above)
+    - no Person named "QA Devtools Object" exists — ABORT rather than reusing one this test did
+      not create
+  steps:
+    - name: Generate one object
+      do: (agent-only — invokes space.addObject directly, bypassing the SpaceGenerator surface)
+      invoke: org.dxos.operation.space.addObject { object: { "@type": "org.dxos.type.person", fullName: "QA Devtools Object" }, target: $given.collection }
+      capture: created
+      expect: one new Person named "QA Devtools Object" appears in the active collection
+      assert: return !!$created.object
+  after:
+    - name: Delete the generated object
+      do: Right-click "QA Devtools Object" in the navtree and choose Delete.
+      invoke: org.dxos.operation.space.removeObjects { objects: [$created.object], target: $given.collection }
+      expect: the row leaves the navtree
+```
+
+---
+
 ## Appendix: Extension Definitions
 
 ```mdl
@@ -332,8 +419,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/Devtools.mjs

@@ -1,5 +1,6 @@
 import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
 import { meta } from "#meta";
+import * as GraphPath from "@dxos/app-toolkit/GraphPath";
 //#region src/types/Devtools.ts
 var Devtools_exports = /* @__PURE__ */ __exportAll({
 	Agent: () => Agent,
@@ -11,6 +12,7 @@ var Devtools_exports = /* @__PURE__ */ __exportAll({
 	Halo: () => Halo,
 	Mesh: () => Mesh,
 	ToolsExplorer: () => ToolsExplorer,
+	getNodePath: () => getNodePath,
 	id: () => id,
 	nodeId: () => nodeId
 });
@@ -21,6 +23,11 @@ var Devtools_exports = /* @__PURE__ */ __exportAll({
 */
 var nodeId = (fullId) => fullId.split(".").at(-1) ?? "";
 var devtoolsId = `${meta.profile.key}.devtools`;
+/**
+* Qualified graph id of a devtools node: the tree under the debug category nests one node per dotted
+* segment of the namespaced ID below the plugin key.
+*/
+var getNodePath = (fullId) => GraphPath.getSpacePath(GraphPath.GroupSegments.debug, ...fullId.slice(meta.profile.key.length + 1).split("."));
 var id = devtoolsId;
 var AppGraph = `${devtoolsId}.appGraph`;
 var ToolsExplorer = `${devtoolsId}.toolsExplorer`;
@@ -49,6 +56,7 @@ var Echo;
 	_Echo.Space = `${Echo.id}.space`;
 	_Echo.Feeds = `${Echo.id}.feeds`;
 	_Echo.Objects = `${Echo.id}.objects`;
+	_Echo.Queries = `${Echo.id}.queries`;
 	_Echo.Schema = `${Echo.id}.schema`;
 	_Echo.Registry = `${Echo.id}.registry`;
 	_Echo.Automerge = `${Echo.id}.automerge`;
@@ -78,6 +86,6 @@ var Edge;
 	_Edge.Testing = `${Edge.id}.testing`;
 })(Edge || (Edge = {}));
 //#endregion
-export { Agent, AppGraph, Cli, Client, Echo, Edge, Halo, Mesh, ToolsExplorer, id, nodeId, Devtools_exports as t };
+export { Agent, AppGraph, Cli, Client, Echo, Edge, Halo, Mesh, ToolsExplorer, getNodePath, id, nodeId, Devtools_exports as t };
 
 //# sourceMappingURL=Devtools.mjs.map

package/dist/lib/Devtools.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Devtools.mjs","names":[],"sources":["../../src/types/Devtools.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport { meta } from '#meta';\n\n/**\n * Extracts the last dot-separated segment of a Devtools namespaced ID string.\n * Use this as the node segment `id` when building app-graph nodes whose `data`\n * value is one of the other constants in this namespace.\n */\nexport const nodeId = (fullId: string): string => fullId.split('.').at(-1) ?? '';\n\nconst devtoolsId = `${meta.profile.key}.devtools`;\n\nexport const id = devtoolsId;\nexport const AppGraph = `${devtoolsId}.appGraph`;\nexport const ToolsExplorer = `${devtoolsId}.toolsExplorer`;\nexport const Cli = `${devtoolsId}.cli`;\n\nexport namespace Client {\n  export const id = `${devtoolsId}.client`;\n  export const Config = `${Client.id}.config`;\n  export const Storage = `${Client.id}.storage`;\n  export const Sqlite = `${Client.id}.sqlite`;\n  export const Logs = `${Client.id}.logs`;\n  export const Diagnostics = `${Client.id}.diagnostics`;\n}\n\nexport namespace Halo {\n  export const id = `${devtoolsId}.halo`;\n  export const Identity = `${Halo.id}.identity`;\n  export const Devices = `${Halo.id}.devices`;\n  export const Keyring = `${Halo.id}.keyring`;\n  export const Credentials = `${Halo.id}.credentials`;\n}\n\nexport namespace Echo {\n  export const id = `${devtoolsId}.echo`;\n  export const Spaces = `${Echo.id}.spaces`;\n  export const Space = `${Echo.id}.space`;\n  export const Feeds = `${Echo.id}.feeds`;\n  export const Objects = `${Echo.id}.objects`;\n  export const Schema = `${Echo.id}.schema`;\n  export const Registry = `${Echo.id}.registry`;\n  export const Automerge = `${Echo.id}.automerge`;\n  export const Queues = `${Echo.id}.queues`;\n  export const Members = `${Echo.id}.members`;\n  export const Metadata = `${Echo.id}.metadata`;\n}\n\nexport namespace Mesh {\n  export const id = `${devtoolsId}.mesh`;\n  export const Signal = `${Mesh.id}.signal`;\n  export const Swarm = `${Mesh.id}.swarm`;\n  export const Network = `${Mesh.id}.network`;\n}\n\nexport namespace Agent {\n  export const id = `${devtoolsId}.agent`;\n  export const Dashboard = `${Agent.id}.dashboard`;\n  export const Search = `${Agent.id}.search`;\n}\n\nexport namespace Edge {\n  export const id = `${devtoolsId}.edge`;\n  export const Dashboard = `${Edge.id}.dashboard`;\n  export const Workflows = `${Edge.id}.workflows`;\n  export const Traces = `${Edge.id}.traces`;\n  export const Testing = `${Edge.id}.testing`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAaA,IAAa,UAAU,WAA2B,OAAO,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK;AAE9E,IAAM,aAAa,GAAG,KAAK,QAAQ,IAAI;AAEvC,IAAa,KAAK;AAClB,IAAa,WAAW,GAAG,WAAW;AACtC,IAAa,gBAAgB,GAAG,WAAW;AAC3C,IAAa,MAAM,GAAG,WAAW;AAE1B,IAAU;CAAV,SAAA,SAAA;CACQ,QAAA,KAAK,GAAG,WAAW;CACnB,QAAA,SAAS,GAAG,OAAO,GAAG;CACtB,QAAA,UAAU,GAAG,OAAO,GAAG;CACvB,QAAA,SAAS,GAAG,OAAO,GAAG;CACtB,QAAA,OAAO,GAAG,OAAO,GAAG;CACpB,QAAA,cAAc,GAAG,OAAO,GAAG;AAC1C,EAAA,CAAA,WAAA,SAAA,CAAA,EAAA;AAEO,IAAU;CAAV,SAAA,OAAA;CACQ,MAAA,KAAK,GAAG,WAAW;CACnB,MAAA,WAAW,GAAG,KAAK,GAAG;CACtB,MAAA,UAAU,GAAG,KAAK,GAAG;CACrB,MAAA,UAAU,GAAG,KAAK,GAAG;CACrB,MAAA,cAAc,GAAG,KAAK,GAAG;AACxC,EAAA,CAAA,SAAA,OAAA,CAAA,EAAA;AAEO,IAAU;CAAV,SAAA,OAAA;CACQ,MAAA,KAAK,GAAG,WAAW;CACnB,MAAA,SAAS,GAAG,KAAK,GAAG;CACpB,MAAA,QAAQ,GAAG,KAAK,GAAG;CACnB,MAAA,QAAQ,GAAG,KAAK,GAAG;CACnB,MAAA,UAAU,GAAG,KAAK,GAAG;CACrB,MAAA,SAAS,GAAG,KAAK,GAAG;CACpB,MAAA,WAAW,GAAG,KAAK,GAAG;CACtB,MAAA,YAAY,GAAG,KAAK,GAAG;CACvB,MAAA,SAAS,GAAG,KAAK,GAAG;CACpB,MAAA,UAAU,GAAG,KAAK,GAAG;CACrB,MAAA,WAAW,GAAG,KAAK,GAAG;AACrC,EAAA,CAAA,SAAA,OAAA,CAAA,EAAA;AAEO,IAAU;CAAV,SAAA,OAAA;CACQ,MAAA,KAAK,GAAG,WAAW;CACnB,MAAA,SAAS,GAAG,KAAK,GAAG;CACpB,MAAA,QAAQ,GAAG,KAAK,GAAG;CACnB,MAAA,UAAU,GAAG,KAAK,GAAG;AACpC,EAAA,CAAA,SAAA,OAAA,CAAA,EAAA;AAEO,IAAU;CAAV,SAAA,QAAA;CACQ,OAAA,KAAK,GAAG,WAAW;CACnB,OAAA,YAAY,GAAG,MAAM,GAAG;CACxB,OAAA,SAAS,GAAG,MAAM,GAAG;AACpC,EAAA,CAAA,UAAA,QAAA,CAAA,EAAA;AAEO,IAAU;CAAV,SAAA,OAAA;CACQ,MAAA,KAAK,GAAG,WAAW;CACnB,MAAA,YAAY,GAAG,KAAK,GAAG;CACvB,MAAA,YAAY,GAAG,KAAK,GAAG;CACvB,MAAA,SAAS,GAAG,KAAK,GAAG;CACpB,MAAA,UAAU,GAAG,KAAK,GAAG;AACpC,EAAA,CAAA,SAAA,OAAA,CAAA,EAAA"}
+{"version":3,"file":"Devtools.mjs","names":[],"sources":["../../src/types/Devtools.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as GraphPath from '@dxos/app-toolkit/GraphPath';\n\nimport { meta } from '#meta';\n\n/**\n * Extracts the last dot-separated segment of a Devtools namespaced ID string.\n * Use this as the node segment `id` when building app-graph nodes whose `data`\n * value is one of the other constants in this namespace.\n */\nexport const nodeId = (fullId: string): string => fullId.split('.').at(-1) ?? '';\n\nconst devtoolsId = `${meta.profile.key}.devtools`;\n\n/**\n * Qualified graph id of a devtools node: the tree under the debug category nests one node per dotted\n * segment of the namespaced ID below the plugin key.\n */\nexport const getNodePath = (fullId: string): string =>\n  GraphPath.getSpacePath(GraphPath.GroupSegments.debug, ...fullId.slice(meta.profile.key.length + 1).split('.'));\n\nexport const id = devtoolsId;\nexport const AppGraph = `${devtoolsId}.appGraph`;\nexport const ToolsExplorer = `${devtoolsId}.toolsExplorer`;\nexport const Cli = `${devtoolsId}.cli`;\n\nexport namespace Client {\n  export const id = `${devtoolsId}.client`;\n  export const Config = `${Client.id}.config`;\n  export const Storage = `${Client.id}.storage`;\n  export const Sqlite = `${Client.id}.sqlite`;\n  export const Logs = `${Client.id}.logs`;\n  export const Diagnostics = `${Client.id}.diagnostics`;\n}\n\nexport namespace Halo {\n  export const id = `${devtoolsId}.halo`;\n  export const Identity = `${Halo.id}.identity`;\n  export const Devices = `${Halo.id}.devices`;\n  export const Keyring = `${Halo.id}.keyring`;\n  export const Credentials = `${Halo.id}.credentials`;\n}\n\nexport namespace Echo {\n  export const id = `${devtoolsId}.echo`;\n  export const Spaces = `${Echo.id}.spaces`;\n  export const Space = `${Echo.id}.space`;\n  export const Feeds = `${Echo.id}.feeds`;\n  export const Objects = `${Echo.id}.objects`;\n  export const Queries = `${Echo.id}.queries`;\n  export const Schema = `${Echo.id}.schema`;\n  export const Registry = `${Echo.id}.registry`;\n  export const Automerge = `${Echo.id}.automerge`;\n  export const Queues = `${Echo.id}.queues`;\n  export const Members = `${Echo.id}.members`;\n  export const Metadata = `${Echo.id}.metadata`;\n}\n\nexport namespace Mesh {\n  export const id = `${devtoolsId}.mesh`;\n  export const Signal = `${Mesh.id}.signal`;\n  export const Swarm = `${Mesh.id}.swarm`;\n  export const Network = `${Mesh.id}.network`;\n}\n\nexport namespace Agent {\n  export const id = `${devtoolsId}.agent`;\n  export const Dashboard = `${Agent.id}.dashboard`;\n  export const Search = `${Agent.id}.search`;\n}\n\nexport namespace Edge {\n  export const id = `${devtoolsId}.edge`;\n  export const Dashboard = `${Edge.id}.dashboard`;\n  export const Workflows = `${Edge.id}.workflows`;\n  export const Traces = `${Edge.id}.traces`;\n  export const Testing = `${Edge.id}.testing`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAeA,IAAa,UAAU,WAA2B,OAAO,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK;AAE9E,IAAM,aAAa,GAAG,KAAK,QAAQ,IAAI;;;;;AAMvC,IAAa,eAAe,WAC1B,UAAU,aAAa,UAAU,cAAc,OAAO,GAAG,OAAO,MAAM,KAAK,QAAQ,IAAI,SAAS,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC;AAE/G,IAAa,KAAK;AAClB,IAAa,WAAW,GAAG,WAAW;AACtC,IAAa,gBAAgB,GAAG,WAAW;AAC3C,IAAa,MAAM,GAAG,WAAW;AAE1B,IAAU;CAAV,SAAA,SAAA;CACQ,QAAA,KAAK,GAAG,WAAW;CACnB,QAAA,SAAS,GAAG,OAAO,GAAG;CACtB,QAAA,UAAU,GAAG,OAAO,GAAG;CACvB,QAAA,SAAS,GAAG,OAAO,GAAG;CACtB,QAAA,OAAO,GAAG,OAAO,GAAG;CACpB,QAAA,cAAc,GAAG,OAAO,GAAG;AAC1C,EAAA,CAAA,WAAA,SAAA,CAAA,EAAA;AAEO,IAAU;CAAV,SAAA,OAAA;CACQ,MAAA,KAAK,GAAG,WAAW;CACnB,MAAA,WAAW,GAAG,KAAK,GAAG;CACtB,MAAA,UAAU,GAAG,KAAK,GAAG;CACrB,MAAA,UAAU,GAAG,KAAK,GAAG;CACrB,MAAA,cAAc,GAAG,KAAK,GAAG;AACxC,EAAA,CAAA,SAAA,OAAA,CAAA,EAAA;AAEO,IAAU;CAAV,SAAA,OAAA;CACQ,MAAA,KAAK,GAAG,WAAW;CACnB,MAAA,SAAS,GAAG,KAAK,GAAG;CACpB,MAAA,QAAQ,GAAG,KAAK,GAAG;CACnB,MAAA,QAAQ,GAAG,KAAK,GAAG;CACnB,MAAA,UAAU,GAAG,KAAK,GAAG;CACrB,MAAA,UAAU,GAAG,KAAK,GAAG;CACrB,MAAA,SAAS,GAAG,KAAK,GAAG;CACpB,MAAA,WAAW,GAAG,KAAK,GAAG;CACtB,MAAA,YAAY,GAAG,KAAK,GAAG;CACvB,MAAA,SAAS,GAAG,KAAK,GAAG;CACpB,MAAA,UAAU,GAAG,KAAK,GAAG;CACrB,MAAA,WAAW,GAAG,KAAK,GAAG;AACrC,EAAA,CAAA,SAAA,OAAA,CAAA,EAAA;AAEO,IAAU;CAAV,SAAA,OAAA;CACQ,MAAA,KAAK,GAAG,WAAW;CACnB,MAAA,SAAS,GAAG,KAAK,GAAG;CACpB,MAAA,QAAQ,GAAG,KAAK,GAAG;CACnB,MAAA,UAAU,GAAG,KAAK,GAAG;AACpC,EAAA,CAAA,SAAA,OAAA,CAAA,EAAA;AAEO,IAAU;CAAV,SAAA,QAAA;CACQ,OAAA,KAAK,GAAG,WAAW;CACnB,OAAA,YAAY,GAAG,MAAM,GAAG;CACxB,OAAA,SAAS,GAAG,MAAM,GAAG;AACpC,EAAA,CAAA,UAAA,QAAA,CAAA,EAAA;AAEO,IAAU;CAAV,SAAA,OAAA;CACQ,MAAA,KAAK,GAAG,WAAW;CACnB,MAAA,YAAY,GAAG,KAAK,GAAG;CACvB,MAAA,YAAY,GAAG,KAAK,GAAG;CACvB,MAAA,SAAS,GAAG,KAAK,GAAG;CACpB,MAAA,UAAU,GAAG,KAAK,GAAG;AACpC,EAAA,CAAA,SAAA,OAAA,CAAA,EAAA"}

package/dist/lib/capabilities.browser.mjs

@@ -0,0 +1,45 @@
+import { t as PLUGIN_default } from "./chunk-PLUGIN.mjs";
+import { create } from "@bufbuild/protobuf";
+import * as Effect from "effect/Effect";
+import * as Capability from "@dxos/app-framework/Capability";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
+import { Runtime_Client_StorageSchema } from "@dxos/protocols/buf/dxos/config_pb";
+import { translations } from "#translations";
+import * as AppCapabilities from "@dxos/app-toolkit/AppCapabilities";
+import { meta } from "#meta";
+//#region src/capabilities/gen/browser.ts
+var setupDevtools = () => {
+	globalThis.composer ??= {};
+	globalThis.composer.changeStorageVersionInMetadata = async (version) => {
+		const { changeStorageVersionInMetadata } = await import("@dxos/client-services/testing");
+		const { Storage } = await import("@dxos/client-services");
+		const client = window.dxos.client;
+		const config = client.config;
+		await client.destroy();
+		const { storage } = Storage.createStorageObjects(config.values?.runtime?.client?.storage ?? create(Runtime_Client_StorageSchema, {}));
+		await changeStorageVersionInMetadata(storage, version);
+		location.pathname = "/";
+	};
+};
+var AppGraphBuilder = AppCapability.appGraphBuilder(() => import("./chunk-app-graph-builder.mjs"), {
+	requires: [AppCapabilities.AppGraph],
+	environments: [
+		"browser",
+		"node",
+		"tauri"
+	]
+});
+var ReactContext = AppCapability.reactContext(() => import("./chunk-react-context.mjs"));
+var ReactSurface = AppCapability.surface(() => import("./chunk-react-surface.mjs"), { roles: ["org.dxos.plugin.debug.surface.page", "org.dxos.role.deckCompanion.devtoolsOverview"] });
+var SetupDevtools = Capability.inlineModule("setup-devtools", { provides: [] }, () => Effect.sync(() => setupDevtools()));
+var Translations = AppCapability.translations(translations);
+var PluginAsset = AppCapability.pluginAsset({
+	pluginId: meta.profile.key,
+	path: "PLUGIN.mdl",
+	content: PLUGIN_default,
+	mimeType: "application/x-mdl"
+});
+//#endregion
+export { AppGraphBuilder, PluginAsset, ReactContext, ReactSurface, SetupDevtools, 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 { create } from '@bufbuild/protobuf';\nimport * as Effect from 'effect/Effect';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport { Runtime_Client_StorageSchema } from '@dxos/protocols/buf/dxos/config_pb';\nimport { type Client } from '@dxos/react-client';\n\nimport { meta } from '#meta';\nimport { translations } from '#translations';\n\nimport pluginSpec from '../../../PLUGIN.mdl?raw';\n\nconst setupDevtools = () => {\n  (globalThis as any).composer ??= {};\n\n  // Used to test how composer handles breaking protocol changes.\n  (globalThis as any).composer.changeStorageVersionInMetadata = async (version: number) => {\n    const { changeStorageVersionInMetadata } = await import('@dxos/client-services/testing');\n    const { Storage } = await import('@dxos/client-services');\n    const client: Client = (window as any).dxos.client;\n    const config = client.config;\n    await client.destroy();\n    const { storage } = Storage.createStorageObjects(\n      config.values?.runtime?.client?.storage ?? create(Runtime_Client_StorageSchema, {}),\n    );\n    await changeStorageVersionInMetadata(storage, version);\n    location.pathname = '/';\n  };\n};\n\nexport const AppGraphBuilder = AppCapability.appGraphBuilder(() => import('../app-graph-builder.ts'), {\n  requires: [AppCapabilities.AppGraph],\n  environments: ['browser', 'node', 'tauri'],\n});\n\nexport const ReactContext = AppCapability.reactContext(() => import('../react-context.tsx'));\n\nexport const ReactSurface = AppCapability.surface(() => import('../react-surface.ts'), {\n  roles: ['org.dxos.plugin.debug.surface.page', 'org.dxos.role.deckCompanion.devtoolsOverview'],\n});\n\nexport const SetupDevtools = Capability.inlineModule('setup-devtools', { provides: [] }, () =>\n  Effect.sync(() => setupDevtools()),\n);\n\nexport const Translations = AppCapability.translations(translations);\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"],"mappings":";;;;;;;;;;AAoBA,IAAM,sBAAsB;CAC1B,WAAoB,aAAa,CAAC;CAGlC,WAAoB,SAAS,iCAAiC,OAAO,YAAoB;EACvF,MAAM,EAAE,mCAAmC,MAAM,OAAO;EACxD,MAAM,EAAE,YAAY,MAAM,OAAO;EACjC,MAAM,SAAkB,OAAe,KAAK;EAC5C,MAAM,SAAS,OAAO;EACtB,MAAM,OAAO,QAAQ;EACrB,MAAM,EAAE,YAAY,QAAQ,qBAC1B,OAAO,QAAQ,SAAS,QAAQ,WAAW,OAAO,8BAA8B,CAAC,CAAC,CACpF;EACA,MAAM,+BAA+B,SAAS,OAAO;EACrD,SAAS,WAAW;CACtB;AACF;AAEA,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,kCAA4B;CACpG,UAAU,CAAC,gBAAgB,QAAQ;CACnC,cAAc;EAAC;EAAW;EAAQ;CAAO;AAC3C,CAAC;AAED,IAAa,eAAe,cAAc,mBAAmB,OAAO,4BAAuB;AAE3F,IAAa,eAAe,cAAc,cAAc,OAAO,8BAAwB,EACrF,OAAO,CAAC,sCAAsC,8CAA8C,EAC9F,CAAC;AAED,IAAa,gBAAgB,WAAW,aAAa,kBAAkB,EAAE,UAAU,CAAC,EAAE,SACpF,OAAO,WAAW,cAAc,CAAC,CACnC;AAEA,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,cAAc,cAAc,YAAY;CACnD,UAAU,KAAK,QAAQ;CACvB,MAAM;CACN,SAAS;CACT,UAAU;AACZ,CAAC"}

package/dist/lib/capabilities.mjs

@@ -1,3 +1,4 @@
+import { t as PLUGIN_default } from "./chunk-PLUGIN.mjs";
 import { create } from "@bufbuild/protobuf";
 import * as Effect from "effect/Effect";
 import * as Capability from "@dxos/app-framework/Capability";
@@ -6,16 +7,17 @@ import { Runtime_Client_StorageSchema } from "@dxos/protocols/buf/dxos/config_pb
 import { translations } from "#translations";
 import * as AppCapabilities from "@dxos/app-toolkit/AppCapabilities";
 import { meta } from "#meta";
-//#region PLUGIN.mdl?raw
-var PLUGIN_default = "---\nid: org.dxos.plugin.devtools\nname: DevtoolsPlugin\nversion: 0.1.0\n---\n\nDeveloper inspector plugin for `DXOS` Composer — structured devtools panels for Client/HALO/ECHO/Mesh/EDGE subsystems, an app-graph inspector, and a tools explorer. Debugging utilities (object generation, wireframe overlays, per-object inspection, stats) live in the sibling `@dxos/plugin-debug`.\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 Settings\n  fields:\n    wireframe?: boolean         # overlay every article/section surface with a labelled border\n    traceAll?: boolean          # enable verbose operation tracing across all plugins\n```\n\n```mdl\ntype DebugPluginOptions\n  fields:\n    logStore?: IdbLogStore      # shared persistent log store for capturing and downloading logs\n```\n\n```mdl\ntype DebugContextType\n  fields:\n    running: boolean\n    start(cb: TimerCallback, options: TimerOptions): void\n    stop(): void\n```\n\n## Components\n\n```mdl\ncomponent DebugSettings\n  desc: Settings panel rendered in the plugin-settings article slot; controls wireframe and traceAll toggles and exposes log download.\n  props:\n    settings: Settings\n    logStore?: IdbLogStore\n  actions:\n    updateSettings(patch: Partial<Settings>)\n    downloadLogs()\n```\n\n```mdl\ncomponent DebugStatus\n  desc: Status-indicator surface shown in the main toolbar; reflects the generator timer running state.\n  state:\n    running: boolean\n```\n\n```mdl\ncomponent DevtoolsOverviewContainer\n  desc: Deck-companion panel that provides quick access to all devtools sections via a categorised link list.\n  layout: |\n    ┌─────────────────────────────┐\n    │  Client  ▸ Config / Storage │\n    │            Logs / Diag      │\n    │  HALO    ▸ Identity / Keys  │\n    │  ECHO    ▸ Spaces / Feeds   │\n    │            Objects / Schema │\n    │  Mesh    ▸ Signal / Swarm   │\n    │  EDGE    ▸ Dashboard / …    │\n    └─────────────────────────────┘\n```\n\n```mdl\ncomponent DebugObjectPanel\n  desc: Companion panel for any ECHO object that shows raw field values, type info, and DXN.\n  props:\n    companionTo: string         # DXN of the object being inspected\n```\n\n```mdl\ncomponent DebugSpaceObjectsPanel\n  desc: Deck-companion panel listing all objects in the active space with their type, ID, and field count.\n  props:\n    space: Space\n```\n\n```mdl\ncomponent DebugGraph\n  desc: Visual representation of the Composer app-graph as a collapsible JSON tree.\n  props:\n    graph: Graph.Graph\n    root: string                # node ID used as the traversal root\n```\n\n```mdl\ncomponent SpaceGenerator\n  desc: Article view for generating synthetic ECHO objects into a space; controls count, type mix, and relation density.\n  props:\n    space: Space\n  actions:\n    generateObjects(count: number, types: string[])\n    clear()\n  emits:\n    onCreateObjects(objects: Obj.Unknown[])\n```\n\n```mdl\ncomponent Wireframe\n  desc: Transparent overlay that wraps any article or section surface and renders a labelled border for layout debugging.\n  props:\n    label: string               # \"role:name\" descriptor shown in the corner badge\n    object: Obj.Unknown\n    classNames?: string\n```\n\n```mdl\ncomponent SchemaTable\n  desc: Tabular display of all registered ECHO schemas with typename, fields, and version.\n```\n\n```mdl\ncomponent GithubPanel\n  desc: Developer panel linking to open GitHub issues and CI run status for the current build.\n```\n```\n\n## Components (Devtools Panels)\n\nThe following components are thin wrappers around `@dxos/devtools` panel components, each bound to a specific `Devtools.*` node:\n\n| Component              | Devtools node              | Displays                                |\n|------------------------|----------------------------|-----------------------------------------|\n| ConfigPanel            | Client.Config              | Vault config JSON viewer                |\n| StoragePanel           | Client.Storage             | Local storage browser                   |\n| LoggingPanel           | Client.Logs                | Live log stream; download via logStore  |\n| DiagnosticsPanel       | Client.Diagnostics         | Client health / metric charts           |\n| IdentityPanel          | Halo.Identity              | Local identity key + device list        |\n| DeviceListPanel        | Halo.Devices               | All devices paired with this identity   |\n| KeyringPanel           | Halo.Keyring               | Raw keyring entries                     |\n| CredentialsPanel       | Halo.Credentials           | Credentials held in the active space    |\n| SpaceListPanel         | Echo.Spaces                | All spaces with state + select action   |\n| SpaceInfoPanel         | Echo.Space                 | Selected space feeds / pipelines        |\n| FeedsPanel             | Echo.Feeds                 | Feed entries for the active space       |\n| ObjectsPanel           | Echo.Objects               | All objects in the active space         |\n| SchemaPanel            | Echo.Schema                | Schemas registered in the active space  |\n| AutomergePanel         | Echo.Automerge             | Automerge document internals            |\n| QueuesPanel            | Echo.Queues                | Pending queue items                     |\n| MembersPanel           | Echo.Members               | Space members with last-seen            |\n| MetadataPanel          | Echo.Metadata              | Space/feed metadata blobs               |\n| SignalPanel            | Mesh.Signal                | Signal-server connection state          |\n| SwarmPanel             | Mesh.Swarm                 | Active swarm peers                      |\n| NetworkPanel           | Mesh.Network               | Full network topology for active space  |\n| EdgeDashboardPanel     | Edge.Dashboard             | EDGE node health / worker stats         |\n| WorkflowPanel          | Edge.Workflows             | Workflow definitions in active space    |\n| InvocationTraceContainer | Edge.Traces              | Invocation trace timeline from feed     |\n| TestingPanel           | Edge.Testing               | Integration test harness for EDGE       |\n| ToolsExplorer          | ToolsExplorer              | MCP-backed tools explorer               |\n\n## Operations\n\nNo first-party operations are defined by DebugPlugin. The plugin invokes `SpaceOperation.AddObject`, `SpaceOperation.Migrate`, `LayoutOperation.Open`, and `ScriptOperation.CreateScript` from other plugins via `useOperationInvoker` inside its surfaces.\n\n## Features\n\n```mdl\nfeat F-1: Devtools Graph Node\n\n  req F-1.1:\n    when: DebugPlugin is loaded\n    then: a \"Devtools\" node appears pinned at the end of each root and space in the nav graph\n\n  req F-1.2: The Devtools node contains sub-trees for Client, HALO, ECHO, Mesh, and EDGE categories.\n  req F-1.3: An app-graph sub-node renders DebugGraph rooted at the current space or root.\n  req F-1.4: A tools-explorer sub-node renders ToolsExplorer connected to the MCP introspect service.\n```\n\n```mdl\nfeat F-2: Object Debug Companion\n\n  req F-2.1:\n    when: any ECHO object is open in the deck\n    then: a \"Debug\" companion tab is injected at the last position\n\n  req F-2.2: DebugObjectPanel shows raw object fields, DXN, and typename for the companion target.\n```\n\n```mdl\nfeat F-3: Space Object Explorer\n\n  req F-3.1:\n    when: user opens the \"Space Objects\" deck companion\n    then: DebugSpaceObjectsPanel lists all ECHO objects in the active space\n\n  req F-3.2: List updates reactively as objects are added or removed.\n```\n\n```mdl\nfeat F-4: Devtools Overview Companion\n\n  req F-4.1:\n    when: user opens the \"Devtools\" deck companion\n    then: DevtoolsOverviewContainer renders a categorised link list to all devtools panels\n\n  req F-4.2: Clicking a category link navigates the deck to the corresponding devtools article.\n```\n\n```mdl\nfeat F-5: Space Data Generator\n\n  req F-5.1:\n    when: user navigates to the debug node under a space\n    then: SpaceGenerator is rendered as the article\n\n  req F-5.2:\n    when: user triggers object generation\n    then: synthetic ECHO objects are created via op:SpaceOperation.AddObject in the active collection\n\n  req F-5.3: DebugStatus indicator in the toolbar shows a running state while generation is active.\n```\n\n```mdl\nfeat F-6: Wireframe Overlay\n\n  req F-6.1:\n    when: settings.wireframe is true\n    then: Wireframe wraps every article and section surface with a labelled border\n\n  req F-6.2:\n    when: settings.wireframe is false or unset\n    then: no overlay is injected; the Wireframe surface filter returns false immediately\n```\n\n```mdl\nfeat F-7: Log Capture and Download\n\n  req F-7.1:\n    when: logStore is provided in DebugPluginOptions\n    then: LoggingPanel can stream and display captured log entries\n\n  req F-7.2:\n    when: user clicks download in DebugSettings\n    then: captured logs are serialised and offered as a file download via the file uploader capability\n```\n\n```mdl\nfeat F-8: Global Dev Utilities\n\n  req F-8.1:\n    when: DebugPlugin activates\n    then: globalThis.composer.changeStorageVersionInMetadata is registered for manual storage-migration testing\n\n  req F-8.2: The function destroys the client, rewrites the storage version metadata, and reloads the page.\n```\n\n## Acceptance\n\n```mdl\ntest T-1: Devtools node appears in nav graph\n  given: Composer loaded with DebugPlugin enabled\n  when: user opens the navigation tree\n  then:\n    - \"Devtools\" node is visible pinned at the end of the root\n    - sub-nodes Client, HALO, ECHO, Mesh, EDGE are present\n```\n\n```mdl\ntest T-2: Debug companion on ECHO object\n  given: a Document is open in the deck\n  when: user clicks the \"Debug\" companion tab\n  then:\n    - DebugObjectPanel renders with the object's DXN and field map\n```\n\n```mdl\ntest T-3: Wireframe overlay toggle\n  given: DebugPlugin settings panel is open\n  when: user enables the wireframe toggle\n  then:\n    - every article and section surface shows a labelled border\n  when: user disables the wireframe toggle\n  then:\n    - borders are removed immediately\n```\n\n```mdl\ntest T-4: Space object generation\n  given: a space with an empty collection is active\n  when: user opens the debug space node and generates 10 objects\n  then:\n    - 10 new objects appear in the active collection\n    - DebugStatus shows \"running\" while generation is in progress\n```\n\n```mdl\ntest T-5: Log download\n  given: logStore is configured and some log entries have been captured\n  when: user clicks \"Download Logs\" in DebugSettings\n  then:\n    - a file download is triggered containing the serialised log entries\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 AppGraphBuilder = AppCapability.appGraphBuilder(() => import("./chunk-app-graph-builder.mjs"), {
 	requires: [AppCapabilities.AppGraph],
-	environments: ["node"]
+	environments: [
+		"browser",
+		"node",
+		"tauri"
+	]
 });
 var ReactContext = AppCapability.reactContext(() => import("./chunk-react-context.mjs"));
-var ReactSurface = AppCapability.surface(() => import("./chunk-react-surface.mjs"), { roles: ["org.dxos.role.article", "org.dxos.role.deckCompanion.devtoolsOverview"] });
+var ReactSurface = AppCapability.surface(() => import("./chunk-react-surface.mjs"), { roles: ["org.dxos.plugin.debug.surface.page", "org.dxos.role.deckCompanion.devtoolsOverview"] });
 var SetupDevtools = Capability.inlineModule("setup-devtools", { provides: [] }, () => Effect.sync(() => setupDevtools()));
 var Translations = AppCapability.translations(translations);
 var PluginAsset = AppCapability.pluginAsset({
@@ -28,11 +30,11 @@ var setupDevtools = () => {
 	globalThis.composer ??= {};
 	globalThis.composer.changeStorageVersionInMetadata = async (version) => {
 		const { changeStorageVersionInMetadata } = await import("@dxos/client-services/testing");
-		const { createStorageObjects } = await import("@dxos/client-services");
+		const { Storage } = await import("@dxos/client-services");
 		const client = window.dxos.client;
 		const config = client.config;
 		await client.destroy();
-		const { storage } = createStorageObjects(config.values?.runtime?.client?.storage ?? create(Runtime_Client_StorageSchema, {}));
+		const { storage } = Storage.createStorageObjects(config.values?.runtime?.client?.storage ?? create(Runtime_Client_StorageSchema, {}));
 		await changeStorageVersionInMetadata(storage, version);
 		location.pathname = "/";
 	};

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 { create } from '@bufbuild/protobuf';\nimport * as Effect from 'effect/Effect';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport { Runtime_Client_StorageSchema } from '@dxos/protocols/buf/dxos/config_pb';\nimport { type Client } from '@dxos/react-client';\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 AppGraphBuilder = AppCapability.appGraphBuilder(() => import('./app-graph-builder'), {\n  requires: [AppCapabilities.AppGraph],\n  environments: ['node'],\n});\nexport const ReactContext = AppCapability.reactContext(() => import('./react-context'));\nexport const ReactSurface = AppCapability.surface(() => import('./react-surface'), {\n  roles: ['org.dxos.role.article', 'org.dxos.role.deckCompanion.devtoolsOverview'],\n});\nexport const SetupDevtools = Capability.inlineModule('setup-devtools', { provides: [] }, () =>\n  Effect.sync(() => setupDevtools()),\n);\nexport const Translations = AppCapability.translations(translations);\nexport const PluginAsset = AppCapability.pluginAsset({\n  pluginId: meta.profile.key,\n  path: 'PLUGIN.mdl',\n  content: pluginSpec,\n  mimeType: 'application/x-mdl',\n});\n\nconst setupDevtools = () => {\n  (globalThis as any).composer ??= {};\n\n  // Used to test how composer handles breaking protocol changes.\n  (globalThis as any).composer.changeStorageVersionInMetadata = async (version: number) => {\n    const { changeStorageVersionInMetadata } = await import('@dxos/client-services/testing');\n    const { createStorageObjects } = await import('@dxos/client-services');\n    const client: Client = (window as any).dxos.client;\n    const config = client.config;\n    await client.destroy();\n    const { storage } = createStorageObjects(\n      config.values?.runtime?.client?.storage ?? create(Runtime_Client_StorageSchema, {}),\n    );\n    await changeStorageVersionInMetadata(storage, version);\n    location.pathname = '/';\n  };\n};\n"],"mappings":";;;;;;;;;;;;AAmBA,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,kCAAwB;CAChG,UAAU,CAAC,gBAAgB,QAAQ;CACnC,cAAc,CAAC,MAAM;AACvB,CAAC;AACD,IAAa,eAAe,cAAc,mBAAmB,OAAO,4BAAkB;AACtF,IAAa,eAAe,cAAc,cAAc,OAAO,8BAAoB,EACjF,OAAO,CAAC,yBAAyB,8CAA8C,EACjF,CAAC;AACD,IAAa,gBAAgB,WAAW,aAAa,kBAAkB,EAAE,UAAU,CAAC,EAAE,SACpF,OAAO,WAAW,cAAc,CAAC,CACnC;AACA,IAAa,eAAe,cAAc,aAAa,YAAY;AACnE,IAAa,cAAc,cAAc,YAAY;CACnD,UAAU,KAAK,QAAQ;CACvB,MAAM;CACN,SAAS;CACT,UAAU;AACZ,CAAC;AAED,IAAM,sBAAsB;CAC1B,WAAoB,aAAa,CAAC;CAGlC,WAAoB,SAAS,iCAAiC,OAAO,YAAoB;EACvF,MAAM,EAAE,mCAAmC,MAAM,OAAO;EACxD,MAAM,EAAE,yBAAyB,MAAM,OAAO;EAC9C,MAAM,SAAkB,OAAe,KAAK;EAC5C,MAAM,SAAS,OAAO;EACtB,MAAM,OAAO,QAAQ;EACrB,MAAM,EAAE,YAAY,qBAClB,OAAO,QAAQ,SAAS,QAAQ,WAAW,OAAO,8BAA8B,CAAC,CAAC,CACpF;EACA,MAAM,+BAA+B,SAAS,OAAO;EACrD,SAAS,WAAW;CACtB;AACF"}
+{"version":3,"file":"capabilities.mjs","names":[],"sources":["../../src/capabilities/index.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport { create } from '@bufbuild/protobuf';\nimport * as Effect from 'effect/Effect';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport { Runtime_Client_StorageSchema } from '@dxos/protocols/buf/dxos/config_pb';\nimport { type Client } from '@dxos/react-client';\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 AppGraphBuilder = AppCapability.appGraphBuilder(() => import('./app-graph-builder.ts'), {\n  requires: [AppCapabilities.AppGraph],\n  environments: ['browser', 'node', 'tauri'],\n});\nexport const ReactContext = AppCapability.reactContext(() => import('./react-context.tsx'));\nexport const ReactSurface = AppCapability.surface(() => import('./react-surface.ts'), {\n  roles: ['org.dxos.plugin.debug.surface.page', 'org.dxos.role.deckCompanion.devtoolsOverview'],\n});\nexport const SetupDevtools = Capability.inlineModule('setup-devtools', { provides: [] }, () =>\n  Effect.sync(() => setupDevtools()),\n);\nexport const Translations = AppCapability.translations(translations);\nexport const PluginAsset = AppCapability.pluginAsset({\n  pluginId: meta.profile.key,\n  path: 'PLUGIN.mdl',\n  content: pluginSpec,\n  mimeType: 'application/x-mdl',\n});\n\nconst setupDevtools = () => {\n  (globalThis as any).composer ??= {};\n\n  // Used to test how composer handles breaking protocol changes.\n  (globalThis as any).composer.changeStorageVersionInMetadata = async (version: number) => {\n    const { changeStorageVersionInMetadata } = await import('@dxos/client-services/testing');\n    const { Storage } = await import('@dxos/client-services');\n    const client: Client = (window as any).dxos.client;\n    const config = client.config;\n    await client.destroy();\n    const { storage } = Storage.createStorageObjects(\n      config.values?.runtime?.client?.storage ?? create(Runtime_Client_StorageSchema, {}),\n    );\n    await changeStorageVersionInMetadata(storage, version);\n    location.pathname = '/';\n  };\n};\n"],"mappings":";;;;;;;;;;AAmBA,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,kCAA2B;CACnG,UAAU,CAAC,gBAAgB,QAAQ;CACnC,cAAc;EAAC;EAAW;EAAQ;CAAO;AAC3C,CAAC;AACD,IAAa,eAAe,cAAc,mBAAmB,OAAO,4BAAsB;AAC1F,IAAa,eAAe,cAAc,cAAc,OAAO,8BAAuB,EACpF,OAAO,CAAC,sCAAsC,8CAA8C,EAC9F,CAAC;AACD,IAAa,gBAAgB,WAAW,aAAa,kBAAkB,EAAE,UAAU,CAAC,EAAE,SACpF,OAAO,WAAW,cAAc,CAAC,CACnC;AACA,IAAa,eAAe,cAAc,aAAa,YAAY;AACnE,IAAa,cAAc,cAAc,YAAY;CACnD,UAAU,KAAK,QAAQ;CACvB,MAAM;CACN,SAAS;CACT,UAAU;AACZ,CAAC;AAED,IAAM,sBAAsB;CAC1B,WAAoB,aAAa,CAAC;CAGlC,WAAoB,SAAS,iCAAiC,OAAO,YAAoB;EACvF,MAAM,EAAE,mCAAmC,MAAM,OAAO;EACxD,MAAM,EAAE,YAAY,MAAM,OAAO;EACjC,MAAM,SAAkB,OAAe,KAAK;EAC5C,MAAM,SAAS,OAAO;EACtB,MAAM,OAAO,QAAQ;EACrB,MAAM,EAAE,YAAY,QAAQ,qBAC1B,OAAO,QAAQ,SAAS,QAAQ,WAAW,OAAO,8BAA8B,CAAC,CAAC,CACpF;EACA,MAAM,+BAA+B,SAAS,OAAO;EACrD,SAAS,WAAW;CACtB;AACF"}

package/dist/lib/capabilities.node.mjs

@@ -10,18 +10,22 @@ var setupDevtools = () => {
 	globalThis.composer ??= {};
 	globalThis.composer.changeStorageVersionInMetadata = async (version) => {
 		const { changeStorageVersionInMetadata } = await import("@dxos/client-services/testing");
-		const { createStorageObjects } = await import("@dxos/client-services");
+		const { Storage } = await import("@dxos/client-services");
 		const client = window.dxos.client;
 		const config = client.config;
 		await client.destroy();
-		const { storage } = createStorageObjects(config.values?.runtime?.client?.storage ?? create(Runtime_Client_StorageSchema, {}));
+		const { storage } = Storage.createStorageObjects(config.values?.runtime?.client?.storage ?? create(Runtime_Client_StorageSchema, {}));
 		await changeStorageVersionInMetadata(storage, version);
 		location.pathname = "/";
 	};
 };
 var AppGraphBuilder = AppCapability.appGraphBuilder(() => import("./chunk-app-graph-builder.mjs"), {
 	requires: [AppCapabilities.AppGraph],
-	environments: ["node"]
+	environments: [
+		"browser",
+		"node",
+		"tauri"
+	]
 });
 var SetupDevtools = Capability.inlineModule("setup-devtools", { provides: [] }, () => Effect.sync(() => setupDevtools()));
 var Translations = AppCapability.translations(translations);

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 { create } from '@bufbuild/protobuf';\nimport * as Effect from 'effect/Effect';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport { Runtime_Client_StorageSchema } from '@dxos/protocols/buf/dxos/config_pb';\nimport { type Client } from '@dxos/react-client';\n\nimport { translations } from '#translations';\n\nconst setupDevtools = () => {\n  (globalThis as any).composer ??= {};\n\n  // Used to test how composer handles breaking protocol changes.\n  (globalThis as any).composer.changeStorageVersionInMetadata = async (version: number) => {\n    const { changeStorageVersionInMetadata } = await import('@dxos/client-services/testing');\n    const { createStorageObjects } = await import('@dxos/client-services');\n    const client: Client = (window as any).dxos.client;\n    const config = client.config;\n    await client.destroy();\n    const { storage } = createStorageObjects(\n      config.values?.runtime?.client?.storage ?? create(Runtime_Client_StorageSchema, {}),\n    );\n    await changeStorageVersionInMetadata(storage, version);\n    location.pathname = '/';\n  };\n};\n\nexport const AppGraphBuilder = AppCapability.appGraphBuilder(() => import('../app-graph-builder'), {\n  requires: [AppCapabilities.AppGraph],\n  environments: ['node'],\n});\n\nexport const SetupDevtools = Capability.inlineModule('setup-devtools', { provides: [] }, () =>\n  Effect.sync(() => setupDevtools()),\n);\n\nexport const Translations = AppCapability.translations(translations);\n\nexport const PluginAsset = undefined;\nexport const ReactContext = undefined;\nexport const ReactSurface = undefined;\n"],"mappings":";;;;;;;;AAiBA,IAAM,sBAAsB;CAC1B,WAAoB,aAAa,CAAC;CAGlC,WAAoB,SAAS,iCAAiC,OAAO,YAAoB;EACvF,MAAM,EAAE,mCAAmC,MAAM,OAAO;EACxD,MAAM,EAAE,yBAAyB,MAAM,OAAO;EAC9C,MAAM,SAAkB,OAAe,KAAK;EAC5C,MAAM,SAAS,OAAO;EACtB,MAAM,OAAO,QAAQ;EACrB,MAAM,EAAE,YAAY,qBAClB,OAAO,QAAQ,SAAS,QAAQ,WAAW,OAAO,8BAA8B,CAAC,CAAC,CACpF;EACA,MAAM,+BAA+B,SAAS,OAAO;EACrD,SAAS,WAAW;CACtB;AACF;AAEA,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,kCAAyB;CACjG,UAAU,CAAC,gBAAgB,QAAQ;CACnC,cAAc,CAAC,MAAM;AACvB,CAAC;AAED,IAAa,gBAAgB,WAAW,aAAa,kBAAkB,EAAE,UAAU,CAAC,EAAE,SACpF,OAAO,WAAW,cAAc,CAAC,CACnC;AAEA,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,cAAc,KAAA;AAC3B,IAAa,eAAe,KAAA;AAC5B,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 { create } from '@bufbuild/protobuf';\nimport * as Effect from 'effect/Effect';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport { Runtime_Client_StorageSchema } from '@dxos/protocols/buf/dxos/config_pb';\nimport { type Client } from '@dxos/react-client';\n\nimport { translations } from '#translations';\n\nconst setupDevtools = () => {\n  (globalThis as any).composer ??= {};\n\n  // Used to test how composer handles breaking protocol changes.\n  (globalThis as any).composer.changeStorageVersionInMetadata = async (version: number) => {\n    const { changeStorageVersionInMetadata } = await import('@dxos/client-services/testing');\n    const { Storage } = await import('@dxos/client-services');\n    const client: Client = (window as any).dxos.client;\n    const config = client.config;\n    await client.destroy();\n    const { storage } = Storage.createStorageObjects(\n      config.values?.runtime?.client?.storage ?? create(Runtime_Client_StorageSchema, {}),\n    );\n    await changeStorageVersionInMetadata(storage, version);\n    location.pathname = '/';\n  };\n};\n\nexport const AppGraphBuilder = AppCapability.appGraphBuilder(() => import('../app-graph-builder.ts'), {\n  requires: [AppCapabilities.AppGraph],\n  environments: ['browser', 'node', 'tauri'],\n});\n\nexport const SetupDevtools = Capability.inlineModule('setup-devtools', { provides: [] }, () =>\n  Effect.sync(() => setupDevtools()),\n);\n\nexport const Translations = AppCapability.translations(translations);\n\nexport const PluginAsset = undefined;\nexport const ReactContext = undefined;\nexport const ReactSurface = undefined;\n"],"mappings":";;;;;;;;AAiBA,IAAM,sBAAsB;CAC1B,WAAoB,aAAa,CAAC;CAGlC,WAAoB,SAAS,iCAAiC,OAAO,YAAoB;EACvF,MAAM,EAAE,mCAAmC,MAAM,OAAO;EACxD,MAAM,EAAE,YAAY,MAAM,OAAO;EACjC,MAAM,SAAkB,OAAe,KAAK;EAC5C,MAAM,SAAS,OAAO;EACtB,MAAM,OAAO,QAAQ;EACrB,MAAM,EAAE,YAAY,QAAQ,qBAC1B,OAAO,QAAQ,SAAS,QAAQ,WAAW,OAAO,8BAA8B,CAAC,CAAC,CACpF;EACA,MAAM,+BAA+B,SAAS,OAAO;EACrD,SAAS,WAAW;CACtB;AACF;AAEA,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,kCAA4B;CACpG,UAAU,CAAC,gBAAgB,QAAQ;CACnC,cAAc;EAAC;EAAW;EAAQ;CAAO;AAC3C,CAAC;AAED,IAAa,gBAAgB,WAAW,aAAa,kBAAkB,EAAE,UAAU,CAAC,EAAE,SACpF,OAAO,WAAW,cAAc,CAAC,CACnC;AAEA,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,cAAc,KAAA;AAC3B,IAAa,eAAe,KAAA;AAC5B,IAAa,eAAe,KAAA"}

package/dist/lib/capabilities.tauri.mjs

@@ -0,0 +1,45 @@
+import { t as PLUGIN_default } from "./chunk-PLUGIN.mjs";
+import { create } from "@bufbuild/protobuf";
+import * as Effect from "effect/Effect";
+import * as Capability from "@dxos/app-framework/Capability";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
+import { Runtime_Client_StorageSchema } from "@dxos/protocols/buf/dxos/config_pb";
+import { translations } from "#translations";
+import * as AppCapabilities from "@dxos/app-toolkit/AppCapabilities";
+import { meta } from "#meta";
+//#region src/capabilities/gen/tauri.ts
+var setupDevtools = () => {
+	globalThis.composer ??= {};
+	globalThis.composer.changeStorageVersionInMetadata = async (version) => {
+		const { changeStorageVersionInMetadata } = await import("@dxos/client-services/testing");
+		const { Storage } = await import("@dxos/client-services");
+		const client = window.dxos.client;
+		const config = client.config;
+		await client.destroy();
+		const { storage } = Storage.createStorageObjects(config.values?.runtime?.client?.storage ?? create(Runtime_Client_StorageSchema, {}));
+		await changeStorageVersionInMetadata(storage, version);
+		location.pathname = "/";
+	};
+};
+var AppGraphBuilder = AppCapability.appGraphBuilder(() => import("./chunk-app-graph-builder.mjs"), {
+	requires: [AppCapabilities.AppGraph],
+	environments: [
+		"browser",
+		"node",
+		"tauri"
+	]
+});
+var ReactContext = AppCapability.reactContext(() => import("./chunk-react-context.mjs"));
+var ReactSurface = AppCapability.surface(() => import("./chunk-react-surface.mjs"), { roles: ["org.dxos.plugin.debug.surface.page", "org.dxos.role.deckCompanion.devtoolsOverview"] });
+var SetupDevtools = Capability.inlineModule("setup-devtools", { provides: [] }, () => Effect.sync(() => setupDevtools()));
+var Translations = AppCapability.translations(translations);
+var PluginAsset = AppCapability.pluginAsset({
+	pluginId: meta.profile.key,
+	path: "PLUGIN.mdl",
+	content: PLUGIN_default,
+	mimeType: "application/x-mdl"
+});
+//#endregion
+export { AppGraphBuilder, PluginAsset, ReactContext, ReactSurface, SetupDevtools, 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 { create } from '@bufbuild/protobuf';\nimport * as Effect from 'effect/Effect';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport { Runtime_Client_StorageSchema } from '@dxos/protocols/buf/dxos/config_pb';\nimport { type Client } from '@dxos/react-client';\n\nimport { meta } from '#meta';\nimport { translations } from '#translations';\n\nimport pluginSpec from '../../../PLUGIN.mdl?raw';\n\nconst setupDevtools = () => {\n  (globalThis as any).composer ??= {};\n\n  // Used to test how composer handles breaking protocol changes.\n  (globalThis as any).composer.changeStorageVersionInMetadata = async (version: number) => {\n    const { changeStorageVersionInMetadata } = await import('@dxos/client-services/testing');\n    const { Storage } = await import('@dxos/client-services');\n    const client: Client = (window as any).dxos.client;\n    const config = client.config;\n    await client.destroy();\n    const { storage } = Storage.createStorageObjects(\n      config.values?.runtime?.client?.storage ?? create(Runtime_Client_StorageSchema, {}),\n    );\n    await changeStorageVersionInMetadata(storage, version);\n    location.pathname = '/';\n  };\n};\n\nexport const AppGraphBuilder = AppCapability.appGraphBuilder(() => import('../app-graph-builder.ts'), {\n  requires: [AppCapabilities.AppGraph],\n  environments: ['browser', 'node', 'tauri'],\n});\n\nexport const ReactContext = AppCapability.reactContext(() => import('../react-context.tsx'));\n\nexport const ReactSurface = AppCapability.surface(() => import('../react-surface.ts'), {\n  roles: ['org.dxos.plugin.debug.surface.page', 'org.dxos.role.deckCompanion.devtoolsOverview'],\n});\n\nexport const SetupDevtools = Capability.inlineModule('setup-devtools', { provides: [] }, () =>\n  Effect.sync(() => setupDevtools()),\n);\n\nexport const Translations = AppCapability.translations(translations);\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"],"mappings":";;;;;;;;;;AAoBA,IAAM,sBAAsB;CAC1B,WAAoB,aAAa,CAAC;CAGlC,WAAoB,SAAS,iCAAiC,OAAO,YAAoB;EACvF,MAAM,EAAE,mCAAmC,MAAM,OAAO;EACxD,MAAM,EAAE,YAAY,MAAM,OAAO;EACjC,MAAM,SAAkB,OAAe,KAAK;EAC5C,MAAM,SAAS,OAAO;EACtB,MAAM,OAAO,QAAQ;EACrB,MAAM,EAAE,YAAY,QAAQ,qBAC1B,OAAO,QAAQ,SAAS,QAAQ,WAAW,OAAO,8BAA8B,CAAC,CAAC,CACpF;EACA,MAAM,+BAA+B,SAAS,OAAO;EACrD,SAAS,WAAW;CACtB;AACF;AAEA,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,kCAA4B;CACpG,UAAU,CAAC,gBAAgB,QAAQ;CACnC,cAAc;EAAC;EAAW;EAAQ;CAAO;AAC3C,CAAC;AAED,IAAa,eAAe,cAAc,mBAAmB,OAAO,4BAAuB;AAE3F,IAAa,eAAe,cAAc,cAAc,OAAO,8BAAwB,EACrF,OAAO,CAAC,sCAAsC,8CAA8C,EAC9F,CAAC;AAED,IAAa,gBAAgB,WAAW,aAAa,kBAAkB,EAAE,UAAU,CAAC,EAAE,SACpF,OAAO,WAAW,cAAc,CAAC,CACnC;AAEA,IAAa,eAAe,cAAc,aAAa,YAAY;AAEnE,IAAa,cAAc,cAAc,YAAY;CACnD,UAAU,KAAK,QAAQ;CACvB,MAAM;CACN,SAAS;CACT,UAAU;AACZ,CAAC"}