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

package/PLUGIN.mdl

@@ -4,7 +4,7 @@ name: DebugPlugin
 version: 0.1.0
 ---
 
-Developer debugging utilities for `DXOS` Composer — synthetic-object generation, a per-object Debug companion, a space-objects browser, a wireframe overlay, and a transient-stats panel. Rendered under a Debug node in the SYSTEM navigation group, a sibling of the Devtools inspector (`org.dxos.plugin.devtools`).
+Developer debugging utilities for `DXOS` Composer — a debug panel (console, log viewer, and every developer tool as a navtree) docked as the deck's bottom drawer or floated as a window, synthetic-object generation, a per-object Debug companion, a space-objects browser, a wireframe overlay, and a transient-stats panel. The panel is a navtree over a hidden `root/debug` app-graph category that this plugin contributes; the Devtools inspector (`org.dxos.plugin.devtools`) attaches its tree there too. Nothing under `root/debug` appears in the main navtree, opens in the deck, or has a URL.
 
 ## Extensions
 
@@ -15,6 +15,7 @@ The following extension dialects are used in this document.
 | `type`      | `org.dxos.mdl.type@1.0`        |
 | `feat`      | `org.dxos.mdl.feat@1.0`        |
 | `component` | `org.dxos.mdl.component@1.0`   |
+| `test`      | `org.dxos.mdl.test@1.0`        |
 
 ## Types
 
@@ -32,11 +33,100 @@ type DebugPluginOptions
     persistStats?: boolean      # persist the stats-panel store to localStorage (default true)
 ```
 
+```mdl
+type DebugPanelMode
+  literals: docked | floating   # docked = the deck's bottom drawer (default); floating = a FloatingPanel window
+```
+
+```mdl
+type DebugPanelViewState
+  desc: Persisted (localStorage) so a debugging session survives the reloads it provokes; the floating window's open/closed state is not part of it (the drawer's is deck state).
+  fields:
+    nodeId?: string             # qualified id of the selected page (e.g. root/debug/devtools/client/config)
+    open: string[]              # path keys of the expanded branches
+    mode?: DebugPanelMode       # which host shows the panel; absent reads as docked
+    position?: Point            # where the floating panel was last dragged
+    size?: Size                 # the size the floating panel was last resized to
+```
+
+## App graph
+
+```mdl
+feat DebugCategory
+  desc: |
+    A hidden `debug` category on the app-graph root: node `root/debug`, type
+    `GraphPath.GroupTypes.debug`, `data: null`, `disposition: hidden`, not draggable or droppable.
+    `hidden` is what the main navtree already filters, so no consumer has to learn about the
+    category. Tool plugins attach with `AppNodeMatcher.whenDebugGroup`; every tool is a global node
+    (no per-space enumeration) and a space-scoped tool resolves the active workspace's space at
+    render time. Nothing under `root/debug` declares a URL binding.
+```
+
+| Node                        | Type                | Article                    |
+|-----------------------------|---------------------|----------------------------|
+| `root/debug/debug`          | `DebugNodes.id`     | branch (no article); open with the console selected on a pristine panel |
+| `root/debug/debug/console`  | `DebugNodes.Console`| Console (agent debug shell)|
+| `root/debug/debug/logs`     | `DebugNodes.Logs`   | Log viewer                 |
+| `root/debug/debug/space`    | `DebugNodes.SpaceType` | Generate objects (active space) |
+| `root/debug/devtools/...`   | contributed by `org.dxos.plugin.devtools` | Client / HALO / ECHO / MESH / EDGE inspectors, App Graph, SDK Explorer, CLI |
+
+## Components
+
+```mdl
+component DebugPanel
+  desc: |
+    The debug surface in parts (`DebugPanel.Root` / `Body` / `Sidebar` / `Main`) with two hosts
+    that share one `Root` context, so selection and open branches carry over when the panel moves:
+    `DebugPanelDrawer` renders it in the deck's bottom drawer (`AppSurface.Drawer`,
+    `org.dxos.role.drawer`) and `DebugPanelStatus` hosts it in a `FloatingPanel`. `Root` owns the
+    selection, the expanded branches and the mode (DebugPanelViewState); `Body` is the `Splitter`
+    over `Sidebar` — a `Tree` over `root/debug` via `useGraphTreeModel`
+    (`@dxos/plugin-graph/hooks`) — and `Main`, the selected node's article surface.
+    `DebugPanelHeader` is the title-bar control both hosts share: a dock/float switch
+    (`debugPanel.mode`) and, for the drawer, a close (`debugPanel.close`). Selecting a row never
+    touches the deck, attention, or the URL; the drawer is not a plank and never takes attention.
+  props:
+    contextId?: string          # view-state context; defaults to the status-rail singleton
+  state:
+    nodeId?: string             # selected page
+    open: string[]              # expanded branch path keys
+    mode: DebugPanelMode        # docked (default) or floating
+  actions:
+    select(nodeId: string)      # a leaf shows its article; a branch (data: null) toggles instead
+    setOpen(pathKey: string, isOpen: boolean)
+    setMode(mode: DebugPanelMode)  # float: close the drawer, open the window; dock: close the window, open the drawer
+  layout: |
+    ┌─ Main.Drawer (docked, default) ──────────────────────┐
+    │ Debug                                          ⇱ ×  │
+    ├─ Sidebar (Tree) ──┬─ Main (article surface) ────────┤
+    │ ▾ Debug           │                                  │
+    │   ▸ Console       │  Config JSON / log table /       │
+    │     Logs          │  generator / ...                 │
+    │     Generate obj. │                                  │
+    │ ▾ DevTools        │  (console and logs stay mounted  │
+    │   ▾ Client        │   while another page is shown)   │
+    │       Config      │                                  │
+    └───────────────────┴──────────────────────────────────┘
+    Floating: the same Sidebar/Main under a FloatingPanel title bar (⇲ dock, — minimize, ×).
+```
+
 ## Features
 
+```mdl
+feat DebugPanel
+  desc: |
+    A status-bar button shows the debug panel: docked (the default) it toggles the deck's bottom
+    drawer via `LayoutOperation.UpdateDrawer`, so the planks reflow above it, its height is dragged
+    from the top edge and persists with the deck's layout, and fullscreen hides it; floating, it
+    opens the panel as a window over the app. The title bar's dock/float control moves the panel
+    between the two with the same tool selected. The sidebar lists Debug (Console, Logs, Generate
+    objects — a pristine panel opens Debug with the console selected) and DevTools, and the
+    selection, open branches, and mode persist across reloads.
+```
+
 ```mdl
 feat GenerateObjects
-  desc: Create configurable batches of synthetic ECHO objects into a space collection.
+  desc: Create configurable batches of synthetic ECHO objects into the active workspace's space, from the Debug → Generate objects page of the panel.
 ```
 
 ```mdl
@@ -56,5 +146,153 @@ feat Wireframe
 
 ```mdl
 feat StatsPanel
-  desc: A transient-stats panel rendering the shared telemetry store.
+  desc: |
+    The shared telemetry store (`AppCapabilities.StatsPanel`) as one `StatCard` per plugin
+    compartment. Rendered on the plugin's own `org.dxos.plugin.debug.surface.stats` role (with an
+    empty-state card) and contributed to `AppSurface.DevtoolsOverview` at position 20 (no card when
+    the store is empty), so it stacks under the devtools cards in the Stats companion.
+```
+
+## 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-debug is a dev-only utility plugin: it defaults on in `isDev` builds (see
+`packages/apps/composer-app/src/plugin-defs.tsx`), off otherwise.
+
+```mdl
+test QA-1: Insert Lorem ipsum from the slash menu
+  desc: The one debug feature with a real operation behind it — the MenuExtension contribution used as the worked example in plugin-markdown's QA-3.
+  actors: both
+  status: unverified
+  given:
+    - an identity exists
+    - space: a space is open and contains at least one collection
+    - plugin-debug is enabled (dev-only default; see above)
+    - attendableId: an empty document is open in the editor, its attendable id
+  steps:
+    - name: Open the command menu
+      do: With the caret on an empty line, type `/`.
+      expect: the popup lists a "Debug" group containing "Lorem ipsum", below the built-in groups
+      note: |
+        NO `invoke` — opening the popup is a real keystroke and CodeMirror does not observe
+        synthetic input events. Human-only step; an agent run reports it unverified.
+    - name: Insert a paragraph
+      do: Select "Lorem ipsum".
+      invoke: org.dxos.operation.debug.insertLoremIpsum { subject: $given.attendableId, head: 0 }
+      expect: a paragraph of placeholder prose appears at the caret
+      assert: return view.state.doc.length > 0;
+  after:
+    - name: Clear the document
+      do: Select all and delete.
+      expect: the editor is empty and the document body is an empty string
+```
+
+```mdl
+test QA-2: Generate synthetic objects into a collection
+  desc: The SpaceGenerator UI (GenerateObjects) — no operation exists behind it, so this is a human-only sanity check that the debug tooling itself works.
+  actors: human
+  covers: [GenerateObjects, SpaceObjectsBrowser]
+  status: unverified
+  given:
+    - an identity exists
+    - space: a space is open
+    - collection: a collection in that space, empty of synthetic objects
+    - plugin-debug is enabled (dev-only default; see above)
+  steps:
+    - name: Open the debug panel and generate objects
+      do: |
+        Click the status-bar debug button (terminal icon), then in the panel's sidebar open
+        Debug → Generate objects. Set the batch size (e.g. 5) and press `+` on
+        `org.dxos.type.document`.
+      expect: |
+        the type's count rises by 5, the documents appear in the space-objects browser, and the
+        main navtree's SYSTEM group still shows only Database (no DevTools or Debug node)
+      note: NO `invoke` — GenerateObjects has no operation; it is a UI-only synthetic-data generator.
+  after:
+    - name: Remove the generated objects
+      do: Select the generated documents in the space-objects browser and delete them.
+      expect: the collection returns to its prior state
+```
+
+```mdl
+test QA-3: Walk the review-queue demo space
+  desc: |
+    The demo script for the Review template (`samples/review`): seed a space holding one project whose
+    finished tasks carry merged dxos/dxos pull requests with their screenshots and demo recordings,
+    and whose tasks in review carry the PRs still open — then walk it the way a reviewer would.
+  actors: both
+  status: passing  # 2026-09-24, agent run recorded as a demo video
+  given:
+    - an identity exists
+    - defaultSpace: the default space, which is where the run returns to
+    - plugin-debug, plugin-projects, plugin-tasks, plugin-file and plugin-video are enabled (dev-only defaults)
+    - the browser can reach raw.githubusercontent.com, which serves the screenshots
+  before:
+    - name: Seed the space
+      do: Create a space from the "Composer — Review queue" template.
+      invoke: org.dxos.operation.debug.createSpaceFromTemplate { id: "org.dxos.plugin-debug.template.review" }
+      capture: seeded
+      expect: a space named "Composer — Review queue" appears in the space list
+      assert: return $snapshot.spaces.some((s) => s.id === $result.spaceId)
+      note: |
+        The template fetches four PNGs while it applies, so on a cold server the step takes up to a minute.
+        A screenshot the browser cannot reach is kept as an external blob naming its URL — this step still
+        passes, and the image step below is where that shows.
+    - name: Find the project
+      do: Open the space and expand Projects in the navtree.
+      invoke: org.dxos.operation.space.queryObjects { typename: "org.dxos.type.project" }
+      space: $seeded.spaceId
+      capture: projects
+      expect: Projects lists one project, "Composer polish"
+      assert: return $result.results.length === 1 && $result.results[0].label === 'Composer polish'
+  steps:
+    - name: Open the project's tasks
+      do: Click "Composer polish", then its Tasks tab.
+      invoke: org.dxos.operation.appToolkit.open { subject: ["root/$seeded.spaceId/ai/org.dxos.type.project/$projects.results[0].dxn.objectId"] }
+      expect: |
+        seven tasks: three done, each with a violet merged `#` pill and image or video tags; two in review,
+        each with a green open `#` pill and a video tag; one started; one to do
+      assert: |
+        const tasks = await dxos.spaces($seeded.spaceId).db.query(dxos.Filter.type(dxos.DXN.make('org.dxos.type.task'))).run();
+        const count = (status) => tasks.filter((task) => task.status === status).length;
+        const opened = $snapshot.planks.some((plank) => plank.subject?.dxn === $projects.results[0].dxn);
+        return opened && tasks.length === 7 && count('done') === 3 && count('review') === 2;
+      note: The Tasks tab is a view switch inside the plank, so the human clicks it; the agent judges from the database.
+    - name: Look at a finished task's screenshot
+      do: On "Run desktop OAuth in the system browser", click the `oauth-pending.png` tag.
+      expect: a preview card shows the screenshot of the sign-in form waiting on the provider
+      assert: |
+        const blobs = await dxos.spaces($seeded.spaceId).db.query(dxos.Filter.type(dxos.DXN.make('org.dxos.type.blob'))).run();
+        return blobs.length === 4 && blobs.every((blob) => blob.data._tag === 'inline' && blob.size > 0);
+      note: NO `invoke` — the tag is a pointer gesture on the task row, with no operation behind it.
+    - name: Review an open pull request
+      do: On "Switch identities in place instead of a reset and reload" (in review), click the `#13336` pill.
+      expect: the preview names dxos/dxos#13336, state open, by dmaretskyi
+      assert: |
+        const prs = await dxos.spaces($seeded.spaceId).db.query(dxos.Filter.type(dxos.DXN.make('org.dxos.type.pullRequest'))).run();
+        return prs.filter((pr) => pr.state === 'open').map((pr) => pr.number).sort().join() === '12952,13336';
+      note: NO `invoke` — as above.
+    - name: Watch a finished task's demo
+      do: On "Count down a toast's remaining time", click the "Toast countdown demo" tag, then Open from its ⋮ menu.
+      expect: |
+        the video opens in the project's plank (breadcrumb "Composer polish » Toast countdown demo") and plays
+        the toast counting down; the Transcript tab says transcripts are for YouTube videos only, and no error
+        toast appears
+      assert: |
+        return $snapshot.planks.some((plank) => plank.subject?.typename === 'org.dxos.type.video') &&
+          !$snapshot.toasts.some((toast) => toast.title === 'Transcription failed.') && $stepErrors.length === 0;
+      note: NO `invoke` — as above. The recording streams from its URL into the player; nothing is written.
+  after:
+    - name: Delete the space
+      do: Open the space's settings and delete the space.
+      invoke: org.dxos.operation.space.delete { space: Space($seeded.spaceId) }
+      expect: the space leaves the space list
+      assert: return !$snapshot.spaces.some((s) => s.id === $seeded.spaceId)
+    - name: Return to the default space
+      do: Pick the default space in the space list.
+      invoke: org.dxos.operation.appToolkit.switchWorkspace { subject: "root/$given.defaultSpace.id" }
+      expect: the workspace is the default space and no error is logged
+      assert: return $snapshot.layout.workspace === `root/${$given.defaultSpace.id}` && $stepErrors.length === 0
 ```

package/README.md

@@ -1,5 +1,29 @@
 # @dxos/plugin-debug
 
-Developer debugging utilities for DXOS Composer: synthetic-object generation, a per-object Debug
-companion, a space-objects browser, a wireframe overlay, and a transient-stats panel. Rendered under
-a Debug node in the SYSTEM navigation group, alongside the Devtools inspector (`@dxos/plugin-devtools`).
+Developer debugging utilities for DXOS Composer: a floating debug panel (console, log viewer, and a
+navtree over the hidden `root/debug` app-graph category), synthetic-object generation, a per-object
+Debug companion, a space-objects browser, a wireframe overlay, and a transient-stats panel. The
+Devtools inspector (`@dxos/plugin-devtools`) attaches its tree to the same panel.
+
+## Agent debug port on HTTPS origins
+
+**Settings → Debug → Agent debug port** lets a local agent evaluate code in the running app through
+`.agents/skills/composer-forensics/scripts/composer-recovery.js`, which listens on
+`https://127.0.0.1:9321`. An HTTPS page (a PR preview, `composer.space`, or local HTTPS) may only
+reach that port over HTTPS with a certificate the browser trusts, so set one up once per machine:
+
+```bash
+brew install mkcert
+```
+
+```bash
+mkcert -install
+```
+
+```bash
+mkcert -cert-file .agents/skills/composer-forensics/scripts/.recovery-tls/cert.pem -key-file .agents/skills/composer-forensics/scripts/.recovery-tls/key.pem localhost 127.0.0.1
+```
+
+Then run the script with `COMPOSER_RECOVERY_HTTPS=1`. `mkcert -install` adds a local CA to the
+system trust store, so a person runs it, not an agent. Without it the browser rejects the script's
+self-signed fallback certificate and the session never connects.

package/dist/lib/Debug.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Debug.mjs","names":[],"sources":["../../src/types/Debug.ts"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport type * as Atom from 'effect/unstable/reactivity/Atom';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport { type IdbLogStore } from '@dxos/log-store-idb';\n\nimport { meta } from '#meta';\n\nimport * as Settings from './Settings';\n\nexport type DebugPluginOptions = {\n  /** Shared persistent log store for capturing and downloading logs. */\n  logStore?: IdbLogStore;\n  /** Persist the stats-panel store to localStorage so it survives a reload. Defaults to `true`. */\n  persistStats?: boolean;\n};\n\nexport namespace DebugCapabilities {\n  export const Settings = Capability.makeSingleton<Atom.Writable<Settings.Settings>>()(\n    `${meta.profile.key}.capability.settings`,\n  );\n}\n"],"mappings":";;;;;AAoBO,IAAU;CAAV,SAAA,oBAAA;CACQ,mBAAA,WAAW,WAAW,cAAgD,CAAC,CAClF,GAAG,KAAK,QAAQ,IAAI,qBACtB;AACF,EAAA,CAAA,sBAAA,oBAAA,CAAA,EAAA"}
+{"version":3,"file":"Debug.mjs","names":[],"sources":["../../src/types/Debug.ts"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport type * as Atom from 'effect/reactivity/Atom';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport { type IdbLogStore } from '@dxos/log-store-idb';\n\nimport { meta } from '#meta';\n\nimport * as Settings from './Settings.ts';\n\nexport type DebugPluginOptions = {\n  /** Shared persistent log store for capturing and downloading logs. */\n  logStore?: IdbLogStore;\n  /** Persist the stats-panel store to localStorage so it survives a reload. Defaults to `true`. */\n  persistStats?: boolean;\n};\n\nexport namespace DebugCapabilities {\n  export const Settings = Capability.makeSingleton<Atom.Writable<Settings.Settings>>()(\n    `${meta.profile.key}.capability.settings`,\n  );\n}\n"],"mappings":";;;;;AAoBO,IAAU;CAAV,SAAA,oBAAA;CACQ,mBAAA,WAAW,WAAW,cAAgD,CAAC,CAClF,GAAG,KAAK,QAAQ,IAAI,qBACtB;AACF,EAAA,CAAA,sBAAA,oBAAA,CAAA,EAAA"}

package/dist/lib/DebugNodes.mjs

@@ -1,7 +1,14 @@
 import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
 import { meta } from "#meta";
+import * as GraphNode from "@dxos/graph/GraphNode";
 //#region src/types/DebugNodes.ts
 var DebugNodes_exports = /* @__PURE__ */ __exportAll({
+	CONSOLE_NODE_ID: () => CONSOLE_NODE_ID,
+	Console: () => Console,
+	DEBUG_NODE_ID: () => DEBUG_NODE_ID,
+	DEBUG_ROOT_ID: () => DEBUG_ROOT_ID,
+	LOGS_NODE_ID: () => LOGS_NODE_ID,
+	Logs: () => Logs,
 	SpaceType: () => SpaceType,
 	id: () => id,
 	nodeId: () => nodeId
@@ -9,11 +16,23 @@ var DebugNodes_exports = /* @__PURE__ */ __exportAll({
 /** Extracts the last dot-separated segment of a namespaced ID string for use as a node segment id. */
 var nodeId = (fullId) => fullId.split(".").at(-1) ?? "";
 var debugId = meta.profile.key;
-/** Top-level Debug node (sibling of DevTools under the SYSTEM navtree group). */
+/** Top-level Debug node, under the debug category. */
 var id = `${debugId}.debug`;
 /** Discriminator for the space-generator article surface (`node.data.type`). */
 var SpaceType = `${debugId}.space`;
+/** Qualified id of the hidden debug category, the root of the debug panel's tree. */
+var DEBUG_ROOT_ID = `${GraphNode.RootId}/debug`;
+/** Qualified id of the Debug node, which hosts the panel's own pages. */
+var DEBUG_NODE_ID = `${DEBUG_ROOT_ID}/${nodeId(id)}`;
+/** Node data of the Effect-CLI console page. */
+var Console = `${debugId}.console`;
+/** Qualified id of the console page: what a pristine panel opens on. */
+var CONSOLE_NODE_ID = `${DEBUG_NODE_ID}/${nodeId(Console)}`;
+/** Node data of the log viewer page. */
+var Logs = `${debugId}.logs`;
+/** Qualified id of the log viewer page. */
+var LOGS_NODE_ID = `${DEBUG_NODE_ID}/${nodeId(Logs)}`;
 //#endregion
-export { SpaceType, id, nodeId, DebugNodes_exports as t };
+export { CONSOLE_NODE_ID, Console, DEBUG_NODE_ID, DEBUG_ROOT_ID, LOGS_NODE_ID, Logs, SpaceType, id, nodeId, DebugNodes_exports as t };
 
 //# sourceMappingURL=DebugNodes.mjs.map

package/dist/lib/DebugNodes.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"DebugNodes.mjs","names":[],"sources":["../../src/types/DebugNodes.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport { meta } from '#meta';\n\n/** Extracts the last dot-separated segment of a namespaced ID string for use as a node segment id. */\nexport const nodeId = (fullId: string): string => fullId.split('.').at(-1) ?? '';\n\nconst debugId = meta.profile.key;\n\n/** Top-level Debug node (sibling of DevTools under the SYSTEM navtree group). */\nexport const id = `${debugId}.debug`;\n\n/** Discriminator for the space-generator article surface (`node.data.type`). */\nexport const SpaceType = `${debugId}.space`;\n"],"mappings":";;;;;;;;;AASA,IAAa,UAAU,WAA2B,OAAO,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK;AAE9E,IAAM,UAAU,KAAK,QAAQ;;AAG7B,IAAa,KAAK,GAAG,QAAQ;;AAG7B,IAAa,YAAY,GAAG,QAAQ"}
+{"version":3,"file":"DebugNodes.mjs","names":[],"sources":["../../src/types/DebugNodes.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as GraphNode from '@dxos/graph/GraphNode';\n\nimport { meta } from '#meta';\n\n/** Extracts the last dot-separated segment of a namespaced ID string for use as a node segment id. */\nexport const nodeId = (fullId: string): string => fullId.split('.').at(-1) ?? '';\n\nconst debugId = meta.profile.key;\n\n/** Top-level Debug node, under the debug category. */\nexport const id = `${debugId}.debug`;\n\n/** Discriminator for the space-generator article surface (`node.data.type`). */\nexport const SpaceType = `${debugId}.space`;\n\n/** Qualified id of the hidden debug category, the root of the debug panel's tree. */\nexport const DEBUG_ROOT_ID = `${GraphNode.RootId}/debug`;\n\n/** Qualified id of the Debug node, which hosts the panel's own pages. */\nexport const DEBUG_NODE_ID = `${DEBUG_ROOT_ID}/${nodeId(id)}`;\n\n/** Node data of the Effect-CLI console page. */\nexport const Console = `${debugId}.console`;\n\n/** Qualified id of the console page: what a pristine panel opens on. */\nexport const CONSOLE_NODE_ID = `${DEBUG_NODE_ID}/${nodeId(Console)}`;\n\n/** Node data of the log viewer page. */\nexport const Logs = `${debugId}.logs`;\n\n/** Qualified id of the log viewer page. */\nexport const LOGS_NODE_ID = `${DEBUG_NODE_ID}/${nodeId(Logs)}`;\n"],"mappings":";;;;;;;;;;;;;;;;AAWA,IAAa,UAAU,WAA2B,OAAO,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK;AAE9E,IAAM,UAAU,KAAK,QAAQ;;AAG7B,IAAa,KAAK,GAAG,QAAQ;;AAG7B,IAAa,YAAY,GAAG,QAAQ;;AAGpC,IAAa,gBAAgB,GAAG,UAAU,OAAO;;AAGjD,IAAa,gBAAgB,GAAG,cAAc,GAAG,OAAO,EAAE;;AAG1D,IAAa,UAAU,GAAG,QAAQ;;AAGlC,IAAa,kBAAkB,GAAG,cAAc,GAAG,OAAO,OAAO;;AAGjE,IAAa,OAAO,GAAG,QAAQ;;AAG/B,IAAa,eAAe,GAAG,cAAc,GAAG,OAAO,IAAI"}

package/dist/lib/DebugOperation.mjs

@@ -1,11 +1,18 @@
 import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
 import * as Capability from "@dxos/app-framework/Capability";
+import * as Plugin from "@dxos/app-framework/Plugin";
 import { DXN } from "@dxos/echo";
 import * as Schema from "effect/Schema";
 import * as Operation from "@dxos/compute/Operation";
 import * as MarkdownOperation from "@dxos/plugin-markdown/MarkdownOperation";
 //#region src/types/DebugOperation.ts
-var DebugOperation_exports = /* @__PURE__ */ __exportAll({ InsertLoremIpsum: () => InsertLoremIpsum });
+var DebugOperation_exports = /* @__PURE__ */ __exportAll({
+	CreateSpaceFromTemplate: () => CreateSpaceFromTemplate,
+	InsertLoremIpsum: () => InsertLoremIpsum,
+	OpenPage: () => OpenPage,
+	Snapshot: () => Snapshot,
+	Undo: () => Undo
+});
 /**
 * Fills the document with placeholder prose from the slash menu — the cheapest way to get a
 * realistic amount of text in front of a layout or scrolling bug.
@@ -21,7 +28,164 @@ var InsertLoremIpsum = Operation.make({
 	output: Schema.Void,
 	services: [Capability.Service]
 });
+/**
+* Shows a page of the debug panel — a node under `root/debug`, which has no URL for
+* `LayoutOperation.Open` — opening the docked drawer when the panel is docked.
+*/
+var OpenPage = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.debug.openPage"),
+		name: "Open debug page",
+		description: "Selects a page of the debug panel by its qualified graph id and shows the panel.",
+		icon: "ph--terminal-window--regular"
+	},
+	services: [Capability.Service],
+	input: Schema.Struct({ nodeId: Schema.String.annotate({ description: "Qualified graph id of the page, under `root/debug`." }) }),
+	output: Schema.Void
+});
+var LayoutSummary = Schema.Struct({
+	mode: Schema.String,
+	sidebarOpen: Schema.Boolean,
+	complementarySidebarOpen: Schema.Boolean,
+	dialogOpen: Schema.Boolean,
+	workspace: Schema.String,
+	active: Schema.Array(Schema.String).annotate({ description: "Graph path ids of the open planks — the ids layout open/close operations accept." }),
+	inactive: Schema.Array(Schema.String),
+	scrollIntoView: Schema.optional(Schema.String)
+});
+var SubjectSummary = Schema.Struct({
+	id: Schema.optional(Schema.String),
+	dxn: Schema.optional(Schema.String),
+	typename: Schema.optional(Schema.String),
+	name: Schema.optional(Schema.String),
+	text: Schema.optional(Schema.String).annotate({ description: "The current text of a markdown document, so an edit can be judged without the editor." })
+});
+var ActionSummary = Schema.Struct({
+	id: Schema.String,
+	label: Schema.optional(Schema.String),
+	icon: Schema.optional(Schema.String),
+	disabled: Schema.optional(Schema.Boolean),
+	operation: Schema.optional(Schema.String).annotate({ description: "Operation DXN embedded in the action id — invokable via the operation invoker." }),
+	group: Schema.optional(Schema.Boolean)
+});
+var CommentMessageSummary = Schema.Struct({
+	id: Schema.String,
+	sender: Schema.optional(Schema.String),
+	text: Schema.optional(Schema.String)
+});
+var CommentThreadSummary = Schema.Struct({
+	id: Schema.String,
+	anchorId: Schema.String.annotate({ description: "Id of the `AnchoredTo` relation that ties the thread to the subject." }),
+	anchor: Schema.optional(Schema.String),
+	status: Schema.optional(Schema.String),
+	messages: Schema.Array(CommentMessageSummary)
+});
+var PlankSummary = Schema.Struct({
+	id: Schema.String,
+	label: Schema.optional(Schema.String),
+	type: Schema.optional(Schema.String),
+	subject: Schema.optional(SubjectSummary),
+	actions: Schema.Array(ActionSummary),
+	comments: Schema.optional(Schema.Array(CommentThreadSummary)).annotate({ description: "Comment threads anchored to the plank's subject, when it is a database object." })
+});
+var SurfaceSummary = Schema.Struct({
+	id: Schema.optional(Schema.String),
+	role: Schema.optional(Schema.String),
+	component: Schema.optional(Schema.String)
+});
+var SpaceSummary = Schema.Struct({
+	id: Schema.String,
+	name: Schema.optional(Schema.String),
+	state: Schema.String.annotate({ description: "The `SpaceState` name, e.g. `SPACE_READY`." }),
+	default: Schema.optional(Schema.Boolean)
+});
+var ToastSummary = Schema.Struct({
+	title: Schema.optional(Schema.String),
+	description: Schema.optional(Schema.String),
+	actions: Schema.Array(Schema.String).annotate({ description: "Labels of the toast's buttons." })
+});
+var ErrorSummary = Schema.Struct({
+	timestamp: Schema.Number,
+	message: Schema.optional(Schema.String),
+	error: Schema.optional(Schema.String),
+	file: Schema.optional(Schema.String)
+});
+/**
+* One JSON document describing the live UI state — layout, attention, open planks with their
+* subjects and reachable actions, mounted surfaces, and plugin counts — so an agent can infer what
+* the user sees and what it can do without screenshots. See app-framework/docs/INTROSPECTION.md.
+*/
+var Snapshot = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.debug.snapshot"),
+		name: "UI Snapshot",
+		description: "Returns a JSON snapshot of the live UI state: layout (mode, sidebars, open planks), attended items, each open plank with its subject object and the actions the UI offers for it (with their operation keys) and the comment threads on it, the mounted surfaces, the spaces, the visible toasts, the errors logged since `since` (a timestamp; default: the last minute), and plugin counts. Read-only.",
+		icon: "ph--camera--regular"
+	},
+	services: [Capability.Service, Plugin.Service],
+	input: Schema.Struct({ since: Schema.optional(Schema.Number).annotate({ description: "Only errors logged at or after this unix timestamp (ms) are reported." }) }),
+	output: Schema.Struct({
+		layout: Schema.optional(LayoutSummary),
+		attention: Schema.Array(Schema.String),
+		planks: Schema.Array(PlankSummary),
+		surfaces: Schema.Array(SurfaceSummary),
+		spaces: Schema.Array(SpaceSummary),
+		toasts: Schema.Array(ToastSummary),
+		errors: Schema.Array(ErrorSummary),
+		plugins: Schema.Struct({
+			installed: Schema.Number,
+			enabled: Schema.Number,
+			active: Schema.Number
+		})
+	})
+}).pipe(Operation.mutation("none"));
+/**
+* Undoes the last undoable operation — what the notification toast's **Undo** button does — so an
+* agent driving the app through operations can exercise the undo path it cannot click.
+*/
+var Undo = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.debug.revertLast"),
+		name: "Revert last operation",
+		description: "Undoes the last undoable operation, as the undo toast does. Fails when there is nothing to undo.",
+		icon: "ph--arrow-counter-clockwise--regular"
+	},
+	services: [Capability.Service],
+	input: Schema.Struct({}),
+	output: Schema.Struct({ undone: Schema.Boolean })
+});
+var SpaceTemplateSummary = Schema.Struct({
+	id: Schema.String,
+	label: Schema.String,
+	description: Schema.optional(Schema.String)
+});
+/**
+* Creates a space from one of the templates plugins contribute, so an agent driving the debug port
+* can seed a realistic space without clicking through the generator panel.
+*
+* TODO(wittjosiah): Reconcile with `SpaceOperation.Create`, which also takes a `template`. This adds
+* only the listing (call without `id`) and deleting the space when the apply fails; the rest it
+* hand-rolls because `Create` applies the template before the caller holds the space. Rollback
+* belongs in `Create` for every caller or nowhere, and the listing belongs in a read-only
+* operation rather than in a create that means something else when an argument is absent.
+*/
+var CreateSpaceFromTemplate = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.debug.createSpaceFromTemplate"),
+		name: "Create Space From Template",
+		description: "Creates a new space and fills it from a themed space template. Call without `id` to list what is available without creating anything; the listing is the only way to learn the ids.",
+		icon: "ph--dice-five--regular"
+	},
+	services: [Capability.Service, Plugin.Service],
+	input: Schema.Struct({ id: Schema.optional(Schema.String).annotate({ description: "Space template id. Omit to list the available templates without creating anything." }) }),
+	output: Schema.Struct({
+		applied: Schema.optional(SpaceTemplateSummary).annotate({ description: "The template that was written; absent when listing." }),
+		spaceId: Schema.optional(Schema.String),
+		subject: Schema.optional(Schema.Array(Schema.String)).annotate({ description: "Navigation path of the new space, for a follow-up open." }),
+		available: Schema.Array(SpaceTemplateSummary)
+	})
+}).pipe(Operation.mutation("write"));
 //#endregion
-export { InsertLoremIpsum, DebugOperation_exports as t };
+export { CreateSpaceFromTemplate, InsertLoremIpsum, OpenPage, Snapshot, Undo, DebugOperation_exports as t };
 
 //# sourceMappingURL=DebugOperation.mjs.map

package/dist/lib/DebugOperation.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"DebugOperation.mjs","names":[],"sources":["../../src/types/DebugOperation.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as Operation from '@dxos/compute/Operation';\nimport { DXN } from '@dxos/echo';\nimport * as MarkdownOperation from '@dxos/plugin-markdown/MarkdownOperation';\n\n/**\n * Fills the document with placeholder prose from the slash menu — the cheapest way to get a\n * realistic amount of text in front of a layout or scrolling bug.\n */\nexport const InsertLoremIpsum = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.debug.insertLoremIpsum'),\n    name: 'Lorem ipsum',\n    description: 'Inserts a paragraph of placeholder text at the cursor.',\n    icon: 'ph--text-align-left--regular',\n  },\n  input: MarkdownOperation.EditorCommandInput,\n  output: Schema.Void,\n  // The handler resolves the live EditorView from a capability, which is the only route from the\n  // operation layer to the editor.\n  services: [Capability.Service],\n});\n"],"mappings":";;;;;;;;;;;;AAiBA,IAAa,mBAAmB,UAAU,KAAK;CAC7C,MAAM;EACJ,KAAK,IAAI,KAAK,2CAA2C;EACzD,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA,OAAO,kBAAkB;CACzB,QAAQ,OAAO;CAGf,UAAU,CAAC,WAAW,OAAO;AAC/B,CAAC"}
+{"version":3,"file":"DebugOperation.mjs","names":[],"sources":["../../src/types/DebugOperation.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as Plugin from '@dxos/app-framework/Plugin';\nimport * as Operation from '@dxos/compute/Operation';\nimport { DXN } from '@dxos/echo';\nimport * as MarkdownOperation from '@dxos/plugin-markdown/MarkdownOperation';\n\n/**\n * Fills the document with placeholder prose from the slash menu — the cheapest way to get a\n * realistic amount of text in front of a layout or scrolling bug.\n */\nexport const InsertLoremIpsum = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.debug.insertLoremIpsum'),\n    name: 'Lorem ipsum',\n    description: 'Inserts a paragraph of placeholder text at the cursor.',\n    icon: 'ph--text-align-left--regular',\n  },\n  input: MarkdownOperation.EditorCommandInput,\n  output: Schema.Void,\n  // The handler resolves the live EditorView from a capability, which is the only route from the\n  // operation layer to the editor.\n  services: [Capability.Service],\n});\n\n/**\n * Shows a page of the debug panel — a node under `root/debug`, which has no URL for\n * `LayoutOperation.Open` — opening the docked drawer when the panel is docked.\n */\nexport const OpenPage = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.debug.openPage'),\n    name: 'Open debug page',\n    description: 'Selects a page of the debug panel by its qualified graph id and shows the panel.',\n    icon: 'ph--terminal-window--regular',\n  },\n  services: [Capability.Service],\n  input: Schema.Struct({\n    nodeId: Schema.String.annotate({ description: 'Qualified graph id of the page, under `root/debug`.' }),\n  }),\n  output: Schema.Void,\n});\n\nconst LayoutSummary = Schema.Struct({\n  mode: Schema.String,\n  sidebarOpen: Schema.Boolean,\n  complementarySidebarOpen: Schema.Boolean,\n  dialogOpen: Schema.Boolean,\n  workspace: Schema.String,\n  active: Schema.Array(Schema.String).annotate({\n    description: 'Graph path ids of the open planks — the ids layout open/close operations accept.',\n  }),\n  inactive: Schema.Array(Schema.String),\n  scrollIntoView: Schema.optional(Schema.String),\n});\n\nconst SubjectSummary = Schema.Struct({\n  id: Schema.optional(Schema.String),\n  dxn: Schema.optional(Schema.String),\n  typename: Schema.optional(Schema.String),\n  name: Schema.optional(Schema.String),\n  text: Schema.optional(Schema.String).annotate({\n    description: 'The current text of a markdown document, so an edit can be judged without the editor.',\n  }),\n});\n\nconst ActionSummary = Schema.Struct({\n  id: Schema.String,\n  label: Schema.optional(Schema.String),\n  icon: Schema.optional(Schema.String),\n  disabled: Schema.optional(Schema.Boolean),\n  operation: Schema.optional(Schema.String).annotate({\n    description: 'Operation DXN embedded in the action id — invokable via the operation invoker.',\n  }),\n  group: Schema.optional(Schema.Boolean),\n});\n\nconst CommentMessageSummary = Schema.Struct({\n  id: Schema.String,\n  sender: Schema.optional(Schema.String),\n  text: Schema.optional(Schema.String),\n});\n\nconst CommentThreadSummary = Schema.Struct({\n  id: Schema.String,\n  anchorId: Schema.String.annotate({\n    description: 'Id of the `AnchoredTo` relation that ties the thread to the subject.',\n  }),\n  anchor: Schema.optional(Schema.String),\n  status: Schema.optional(Schema.String),\n  messages: Schema.Array(CommentMessageSummary),\n});\n\nconst PlankSummary = Schema.Struct({\n  id: Schema.String,\n  label: Schema.optional(Schema.String),\n  type: Schema.optional(Schema.String),\n  subject: Schema.optional(SubjectSummary),\n  actions: Schema.Array(ActionSummary),\n  comments: Schema.optional(Schema.Array(CommentThreadSummary)).annotate({\n    description: \"Comment threads anchored to the plank's subject, when it is a database object.\",\n  }),\n});\n\nconst SurfaceSummary = Schema.Struct({\n  id: Schema.optional(Schema.String),\n  role: Schema.optional(Schema.String),\n  component: Schema.optional(Schema.String),\n});\n\nconst SpaceSummary = Schema.Struct({\n  id: Schema.String,\n  name: Schema.optional(Schema.String),\n  state: Schema.String.annotate({ description: 'The `SpaceState` name, e.g. `SPACE_READY`.' }),\n  default: Schema.optional(Schema.Boolean),\n});\n\nconst ToastSummary = Schema.Struct({\n  title: Schema.optional(Schema.String),\n  description: Schema.optional(Schema.String),\n  actions: Schema.Array(Schema.String).annotate({ description: \"Labels of the toast's buttons.\" }),\n});\n\nconst ErrorSummary = Schema.Struct({\n  timestamp: Schema.Number,\n  message: Schema.optional(Schema.String),\n  error: Schema.optional(Schema.String),\n  file: Schema.optional(Schema.String),\n});\n\n/**\n * One JSON document describing the live UI state — layout, attention, open planks with their\n * subjects and reachable actions, mounted surfaces, and plugin counts — so an agent can infer what\n * the user sees and what it can do without screenshots. See app-framework/docs/INTROSPECTION.md.\n */\nexport const Snapshot = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.debug.snapshot'),\n    name: 'UI Snapshot',\n    description:\n      'Returns a JSON snapshot of the live UI state: layout (mode, sidebars, open planks), attended ' +\n      'items, each open plank with its subject object and the actions the UI offers for it (with ' +\n      'their operation keys) and the comment threads on it, the mounted surfaces, the spaces, the visible toasts, the errors ' +\n      'logged since `since` (a timestamp; default: the last minute), and plugin counts. Read-only.',\n    icon: 'ph--camera--regular',\n  },\n  services: [Capability.Service, Plugin.Service],\n  input: Schema.Struct({\n    since: Schema.optional(Schema.Number).annotate({\n      description: 'Only errors logged at or after this unix timestamp (ms) are reported.',\n    }),\n  }),\n  output: Schema.Struct({\n    layout: Schema.optional(LayoutSummary),\n    attention: Schema.Array(Schema.String),\n    planks: Schema.Array(PlankSummary),\n    surfaces: Schema.Array(SurfaceSummary),\n    spaces: Schema.Array(SpaceSummary),\n    toasts: Schema.Array(ToastSummary),\n    errors: Schema.Array(ErrorSummary),\n    plugins: Schema.Struct({\n      installed: Schema.Number,\n      enabled: Schema.Number,\n      active: Schema.Number,\n    }),\n  }),\n}).pipe(Operation.mutation('none'));\n\n/**\n * Undoes the last undoable operation — what the notification toast's **Undo** button does — so an\n * agent driving the app through operations can exercise the undo path it cannot click.\n */\nexport const Undo = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.debug.revertLast'),\n    name: 'Revert last operation',\n    description: 'Undoes the last undoable operation, as the undo toast does. Fails when there is nothing to undo.',\n    icon: 'ph--arrow-counter-clockwise--regular',\n  },\n  services: [Capability.Service],\n  input: Schema.Struct({}),\n  output: Schema.Struct({\n    undone: Schema.Boolean,\n  }),\n});\n\nconst SpaceTemplateSummary = Schema.Struct({\n  id: Schema.String,\n  label: Schema.String,\n  description: Schema.optional(Schema.String),\n});\n\n/**\n * Creates a space from one of the templates plugins contribute, so an agent driving the debug port\n * can seed a realistic space without clicking through the generator panel.\n *\n * TODO(wittjosiah): Reconcile with `SpaceOperation.Create`, which also takes a `template`. This adds\n * only the listing (call without `id`) and deleting the space when the apply fails; the rest it\n * hand-rolls because `Create` applies the template before the caller holds the space. Rollback\n * belongs in `Create` for every caller or nowhere, and the listing belongs in a read-only\n * operation rather than in a create that means something else when an argument is absent.\n */\nexport const CreateSpaceFromTemplate = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.debug.createSpaceFromTemplate'),\n    name: 'Create Space From Template',\n    description:\n      'Creates a new space and fills it from a themed space template. Call without `id` to list ' +\n      'what is available without creating anything; the listing is the only way to learn the ids.',\n    icon: 'ph--dice-five--regular',\n  },\n  // The contributing modules are demand-gated, so the handler fires the activation event itself.\n  services: [Capability.Service, Plugin.Service],\n  input: Schema.Struct({\n    id: Schema.optional(Schema.String).annotate({\n      description: 'Space template id. Omit to list the available templates without creating anything.',\n    }),\n  }),\n  output: Schema.Struct({\n    applied: Schema.optional(SpaceTemplateSummary).annotate({\n      description: 'The template that was written; absent when listing.',\n    }),\n    spaceId: Schema.optional(Schema.String),\n    subject: Schema.optional(Schema.Array(Schema.String)).annotate({\n      description: 'Navigation path of the new space, for a follow-up open.',\n    }),\n    available: Schema.Array(SpaceTemplateSummary),\n  }),\n}).pipe(Operation.mutation('write'));\n"],"mappings":"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"}

package/dist/lib/DebugPlugin.mjs.map

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

package/dist/lib/DebugSurface.mjs

@@ -2,14 +2,19 @@ import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
 import { meta } from "#meta";
 import * as Role from "@dxos/app-framework/Role";
 //#region src/types/DebugSurface.ts
-var DebugSurface_exports = /* @__PURE__ */ __exportAll({ Stats: () => Stats });
+var DebugSurface_exports = /* @__PURE__ */ __exportAll({
+	Page: () => Page,
+	Stats: () => Stats
+});
 /**
 * Role token for the transient-stats panel — renders the {@link AppCapabilities.StatsPanel} store
 * (arbitrary reactive telemetry keyed by owner id). A layout targets this role (role-only dispatch);
 * the surface reads the store directly, so it needs no subject.
 */
 var Stats = Role.make(`${meta.profile.key}.surface.stats`);
+/** Role token for a page of the debug panel; every node under `root/debug` registers its surface on it. */
+var Page = Role.make(`${meta.profile.key}.surface.page`);
 //#endregion
-export { Stats, DebugSurface_exports as t };
+export { Page, Stats, DebugSurface_exports as t };
 
 //# sourceMappingURL=DebugSurface.mjs.map

package/dist/lib/DebugSurface.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"DebugSurface.mjs","names":[],"sources":["../../src/types/DebugSurface.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Role from '@dxos/app-framework/Role';\n\nimport { meta } from '#meta';\n\n/**\n * Role token for the transient-stats panel — renders the {@link AppCapabilities.StatsPanel} store\n * (arbitrary reactive telemetry keyed by owner id). A layout targets this role (role-only dispatch);\n * the surface reads the store directly, so it needs no subject.\n */\nexport const Stats = Role.make<Record<string, unknown>>(`${meta.profile.key}.surface.stats`);\n"],"mappings":";;;;;;;;;;AAeA,IAAa,QAAQ,KAAK,KAA8B,GAAG,KAAK,QAAQ,IAAI,eAAe"}
+{"version":3,"file":"DebugSurface.mjs","names":[],"sources":["../../src/types/DebugSurface.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Role from '@dxos/app-framework/Role';\nimport type * as AppSurface from '@dxos/app-toolkit/AppSurface';\n\nimport { meta } from '#meta';\n\n/**\n * Role token for the transient-stats panel — renders the {@link AppCapabilities.StatsPanel} store\n * (arbitrary reactive telemetry keyed by owner id). A layout targets this role (role-only dispatch);\n * the surface reads the store directly, so it needs no subject.\n */\nexport const Stats = Role.make<Record<string, unknown>>(`${meta.profile.key}.surface.stats`);\n\n/** Article data for a page of the debug panel, whose nodes have no URL for `LayoutOperation.Open`. */\nexport type PageData = AppSurface.ArticleData<unknown, { onNavigate: (nodeId: string) => void }>;\n\n/** Role token for a page of the debug panel; every node under `root/debug` registers its surface on it. */\nexport const Page = Role.make<PageData>(`${meta.profile.key}.surface.page`);\n"],"mappings":";;;;;;;;;;;;;AAgBA,IAAa,QAAQ,KAAK,KAA8B,GAAG,KAAK,QAAQ,IAAI,eAAe;;AAM3F,IAAa,OAAO,KAAK,KAAe,GAAG,KAAK,QAAQ,IAAI,cAAc"}

package/dist/lib/IncidentSpace.mjs

@@ -0,0 +1,2 @@
+import { n as make, r as makeTemplate } from "./chunk-IncidentSpace.mjs";
+export { make, makeTemplate };

package/dist/lib/PipelineSpace.mjs

@@ -0,0 +1,2 @@
+import { n as make, r as makeTemplate } from "./chunk-PipelineSpace.mjs";
+export { make, makeTemplate };

package/dist/lib/ReviewSpace.mjs

@@ -0,0 +1,2 @@
+import { i as makeTemplate, n as TEMPLATE_ID, r as make } from "./chunk-ReviewSpace.mjs";
+export { TEMPLATE_ID, make, makeTemplate };

package/dist/lib/StockfishSpace.mjs

@@ -0,0 +1,2 @@
+import { n as make, r as makeTemplate } from "./chunk-StockfishSpace.mjs";
+export { make, makeTemplate };