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

package/dist/types/src/stories/SpaceTemplates.stories.d.ts

@@ -0,0 +1,114 @@
+import { type StoryObj } from '@storybook/react-vite';
+import React from 'react';
+/**
+ * Picking a space template and watching it land.
+ */
+declare const DefaultStory: () => React.JSX.Element;
+declare const meta: {
+    title: string;
+    render: typeof DefaultStory;
+    decorators: import("@storybook/react").Decorator[];
+    parameters: {
+        layout: string;
+        controls: {
+            disable: boolean;
+        };
+        translations: [{
+            readonly 'en-US': {
+                readonly "@dxos/react-ui-debug": {
+                    readonly 'filter.placeholder': 'Filter (e.g. space-proxy:debug)';
+                    readonly 'level.label': 'Level';
+                    readonly 'record.label': 'Record';
+                    readonly 'clear.label': 'Clear';
+                    readonly 'copy.label': 'Copy log';
+                    readonly 'copy-entry.label': 'Copy entry';
+                    readonly 'levels.label': 'Log levels';
+                    readonly 'levels.reset.label': 'Reset all levels';
+                    readonly 'levels.inherit.label': 'Inherit';
+                    readonly 'levels.empty.message': 'No log files registered yet.';
+                    readonly 'levels.filter.placeholder': 'Filter files…';
+                    readonly 'empty.message': 'No log entries.';
+                    readonly 'search.placeholder': 'Find in buffer…';
+                    readonly 'search.clear.label': 'Clear filter';
+                    readonly 'search.no-matches.message': 'No matching entries.';
+                    readonly 'level.trace': 'Trace';
+                    readonly 'level.debug': 'Debug';
+                    readonly 'level.verbose': 'Verbose';
+                    readonly 'level.info': 'Info';
+                    readonly 'level.warn': 'Warn';
+                    readonly 'level.error': 'Error';
+                };
+            };
+        }, {
+            readonly 'en-US': {
+                readonly [x: string]: {
+                    readonly 'plugin.name': 'Debug';
+                    readonly 'debug.label': 'Debug';
+                    readonly 'generate-objects.label': 'Generate Objects';
+                    readonly 'create-space-from-template.label': 'Create space from template: {{label}}';
+                    readonly 'space-objects.label': 'Database';
+                    readonly 'open-debug-panel.label': 'Show debug panel';
+                    readonly 'console.tab.label': 'Console';
+                    readonly 'logs.tab.label': 'Logs';
+                    readonly 'debug-panel.title': 'Debug';
+                    readonly 'debug-panel.empty.label': 'Select a tool';
+                    readonly 'debug-panel.tree.label': 'Debug tools';
+                    readonly 'debug-port-status.running.label': 'Agent debug port is open — show debug panel';
+                    readonly 'dock-panel.label': 'Dock panel';
+                    readonly 'float-panel.label': 'Float panel';
+                    readonly 'close-panel.label': 'Close';
+                    readonly 'console.clear.label': 'Clear log';
+                    readonly 'console.copy.label': 'Copy last result';
+                    readonly 'remove-all-objects.confirm.description': 'Remove all objects from this space? This cannot be undone.';
+                    readonly 'remove-all-objects.error.title': 'Failed to remove objects.';
+                    readonly 'remove-all-objects.toast.title': 'Space cleared';
+                    readonly 'remove-all-objects.toast.description_one': 'Removed {{count}} object.';
+                    readonly 'remove-all-objects.toast.description_other': 'Removed {{count}} objects.';
+                    readonly 'collect-garbage.confirm.description': "Permanently reclaim this space's deleted objects? This cannot be undone.";
+                    readonly 'collect-garbage.error.title': 'Garbage collection failed.';
+                    readonly 'collect-garbage.toast.title': 'Garbage collected';
+                    readonly 'collect-garbage.toast.empty.description': 'Nothing to reclaim.';
+                    readonly 'collect-garbage.toast.description_one': 'Reclaimed {{count}} document.';
+                    readonly 'collect-garbage.toast.description_other': 'Reclaimed {{count}} documents.';
+                    readonly 'settings.wireframe.label': 'Show wireframes.';
+                    readonly 'settings.wireframe.description': 'Overlay wireframe outlines on UI components for debugging layout.';
+                    readonly 'settings.trace-all.label': 'Trace all requests (100% sampling).';
+                    readonly 'settings.trace-all.description': 'Override the default 30% sampling rate to capture all traces. Requires page reload to take effect.';
+                    readonly 'settings.tracing-panel.label': 'Open tracing panel.';
+                    readonly 'settings.tracing-panel.description': 'Open the tracing dashboard to inspect captured spans.';
+                    readonly 'settings.repair.label': 'Run repair tool.';
+                    readonly 'settings.repair.description': 'Attempt to detect and fix inconsistencies in local data storage.';
+                    readonly 'settings.download-diagnostics.label': 'Download diagnostics.';
+                    readonly 'settings.download-diagnostics.description': 'Export a JSON file containing client diagnostics for troubleshooting.';
+                    readonly 'settings.download-logs.label': 'Download log buffer.';
+                    readonly 'settings.download-logs.description': 'Export the in-memory log buffer as an NDJSON file.';
+                    readonly 'settings.uploaded.message': 'Settings uploaded.';
+                    readonly 'settings.uploaded.description': 'URL copied to clipboard.';
+                    readonly 'settings.choose-storage-adaptor.label': 'Storage adaptor (worker reload required).';
+                    readonly 'settings.choose-storage-adaptor.description': 'Select the browser storage backend. Changing this requires a worker reload and may make existing data unavailable.';
+                    readonly 'settings.repair-success.message': 'Repair succeeded';
+                    readonly 'settings.repair-failed.message': 'Repair failed';
+                    readonly 'settings.storage-adaptor.idb.label': 'IndexedDB';
+                    readonly 'settings.storage-adaptor.opfs.label': 'OPFS';
+                    readonly 'settings.storage-adapter.changed-alert.message': 'Warning: Swapping the storage adapter will make your data unavailable.';
+                    readonly 'settings.data-store.label': 'Data Store';
+                    readonly 'settings.debug-port.section.label': 'Agent debug port';
+                    readonly 'settings.debug-port.section.description': 'Lets a local agent evaluate code against this page via composer-recovery.js. Off by default; stops on reload.';
+                    readonly 'settings.debug-port.label': 'Open debug port.';
+                    readonly 'settings.debug-port.description': 'Runs arbitrary code from a loopback server with full access to your data. Only enable while you are working with an agent you trust.';
+                    readonly 'settings.debug-port.running.label': 'Listening on';
+                    readonly 'settings.debug-port.session.label': 'Session id';
+                    readonly 'settings.debug-port.session.description': 'Pass to composer-recovery.js --session. A new id is issued on every restart.';
+                    readonly 'settings.debug-port.log.label': 'Debug port log';
+                };
+            };
+        }];
+    };
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+/** Empty space plus the picker — click a template to fill it. */
+export declare const Default: Story;
+export declare const Tidepool: Story;
+export declare const Northwind: Story;
+//# sourceMappingURL=SpaceTemplates.stories.d.ts.map

package/dist/types/src/stories/SpaceTemplates.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpaceTemplates.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/SpaceTemplates.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,MAAM,OAAO,CAAC;AAiB1B;;GAEG;AACH,QAAA,MAAM,YAAY,yBAYjB,CAAC;AAiBF,QAAA,MAAM,IAAI;;;;;;;YA2BM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGc,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,iEAAiE;AACjE,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC;AAEjC,eAAO,MAAM,QAAQ,EAAE,KAItB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAIvB,CAAC"}

package/dist/types/src/testing/index.d.ts

@@ -0,0 +1,3 @@
+export * from './stub-tools-plugin.tsx';
+export * from './stub-drawer-plugin.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/testing/index.ts"],"names":[],"mappings":"AAIA,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}

package/dist/types/src/testing/stub-drawer-plugin.d.ts

@@ -0,0 +1,8 @@
+import * as Plugin from '@dxos/app-framework/Plugin';
+import type * as Main from '@dxos/react-ui/Main';
+export declare const getDrawerState: () => Main.DrawerState;
+export declare const setDrawerState: (next: Main.DrawerState) => void;
+export declare const useDrawerState: () => Main.DrawerState;
+/** Stands in for the deck's layout handler, so the panel's toggle, close and float controls move the drawer. */
+export declare const StubDrawerPlugin: Plugin.PluginFactory<void>;
+//# sourceMappingURL=stub-drawer-plugin.d.ts.map

package/dist/types/src/testing/stub-drawer-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-drawer-plugin.d.ts","sourceRoot":"","sources":["../../../../src/testing/stub-drawer-plugin.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AAKrD,OAAO,KAAK,KAAK,IAAI,MAAM,qBAAqB,CAAC;AASjD,eAAO,MAAM,cAAc,QAAO,IAAI,CAAC,WAA0B,CAAC;AAElE,eAAO,MAAM,cAAc,SAAU,IAAI,CAAC,WAAW,SAGpD,CAAC;AAEF,eAAO,MAAM,cAAc,QAAO,IAAI,CAAC,WAOpC,CAAC;AAEJ,gHAAgH;AAChH,eAAO,MAAM,gBAAgB,4BAwB5B,CAAC"}

package/dist/types/src/testing/stub-tools-plugin.d.ts

@@ -0,0 +1,19 @@
+import * as Plugin from '@dxos/app-framework/Plugin';
+export declare const STUB_TOOLS_BRANCH = "tools";
+/** Node data (and article text) of the stub pages, so a play test can select one and read it back. */
+export declare const STUB_TOOL_PAGES: readonly [{
+    readonly id: 'alpha';
+    readonly data: 'stub-tool.alpha';
+    readonly label: 'Alpha tool';
+}, {
+    readonly id: 'beta';
+    readonly data: 'stub-tool.beta';
+    readonly label: 'Beta tool';
+}];
+/**
+ * Stands in for devtools in stories: a `tools` branch under the hidden debug category holding two
+ * pages whose articles are their labels, so the debug panel's tree has a branch to toggle and a
+ * page to select without the real plugin's client and space.
+ */
+export declare const StubToolsPlugin: Plugin.PluginFactory<void>;
+//# sourceMappingURL=stub-tools-plugin.d.ts.map

package/dist/types/src/testing/stub-tools-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-tools-plugin.d.ts","sourceRoot":"","sources":["../../../../src/testing/stub-tools-plugin.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AAYrD,eAAO,MAAM,iBAAiB,UAAU,CAAC;AAIzC,sGAAsG;AACtG,eAAO,MAAM,eAAe;aACxB,EAAE,EAAE,OAAO;aAAE,IAAI,EAAE,iBAAiB;aAAE,KAAK,EAAE,YAAY;;aACzD,EAAE,EAAE,MAAM;aAAE,IAAI,EAAE,gBAAgB;aAAE,KAAK,EAAE,WAAW;EAChD,CAAC;AA0DX;;;;GAIG;AACH,eAAO,MAAM,eAAe,4BAE2D,CAAC"}

package/dist/types/src/translations.d.ts

@@ -31,10 +31,20 @@ export declare const translations: [{
             readonly 'plugin.name': 'Debug';
             readonly 'debug.label': 'Debug';
             readonly 'generate-objects.label': 'Generate Objects';
+            readonly 'create-space-from-template.label': 'Create space from template: {{label}}';
             readonly 'space-objects.label': 'Database';
-            readonly 'open-debug-panel.label': 'Show Debug';
-            readonly 'logs.label': 'Logs';
-            readonly 'open-logs.label': 'Show logs';
+            readonly 'open-debug-panel.label': 'Show debug panel';
+            readonly 'console.tab.label': 'Console';
+            readonly 'logs.tab.label': 'Logs';
+            readonly 'debug-panel.title': 'Debug';
+            readonly 'debug-panel.empty.label': 'Select a tool';
+            readonly 'debug-panel.tree.label': 'Debug tools';
+            readonly 'debug-port-status.running.label': 'Agent debug port is open — show debug panel';
+            readonly 'dock-panel.label': 'Dock panel';
+            readonly 'float-panel.label': 'Float panel';
+            readonly 'close-panel.label': 'Close';
+            readonly 'console.clear.label': 'Clear log';
+            readonly 'console.copy.label': 'Copy last result';
             readonly 'remove-all-objects.confirm.description': 'Remove all objects from this space? This cannot be undone.';
             readonly 'remove-all-objects.error.title': 'Failed to remove objects.';
             readonly 'remove-all-objects.toast.title': 'Space cleared';
@@ -75,7 +85,6 @@ export declare const translations: [{
             readonly 'settings.debug-port.running.label': 'Listening on';
             readonly 'settings.debug-port.session.label': 'Session id';
             readonly 'settings.debug-port.session.description': 'Pass to composer-recovery.js --session. A new id is issued on every restart.';
-            readonly 'settings.debug-port.copy-session.label': 'Copy session id.';
             readonly 'settings.debug-port.log.label': 'Debug port log';
         };
     };

package/dist/types/src/translations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../src/translations.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAE7B,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAKnB,SAAA,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;oCACD,OAAO;oCACP,OAAO;+CACI,kBAAkB;4CACrB,UAAU;+CACP,YAAY;mCACxB,MAAM;wCACD,WAAW;+DAEY,4DAA4D;uDACpE,2BAA2B;uDAC3B,eAAe;iEACL,2BAA2B;mEACzB,4BAA4B;4DAGxE,0EAA0E;oDAC7C,4BAA4B;oDAC5B,mBAAmB;gEACP,qBAAqB;8DACvB,+BAA+B;gEAC7B,gCAAgC;iDAE/C,kBAAkB;uDACZ,mEAAmE;iDACzE,qCAAqC;uDAE/D,oGAAoG;qDACtE,qBAAqB;2DACf,uDAAuD;8CACpE,kBAAkB;oDACZ,kEAAkE;4DAC1D,uBAAuB;kEAE5D,uEAAuE;qDACzC,sBAAsB;2DAChB,oDAAoD;kDAC7D,oBAAoB;sDAChB,0BAA0B;8DAClB,2CAA2C;oEAElF,oHAAoH;wDACnF,kBAAkB;uDACnB,eAAe;2DAEX,WAAW;4DACV,MAAM;uEAE3C,wEAAwE;kDAE7C,YAAY;0DAEJ,kBAAkB;gEAErD,+GAA+G;kDACpF,kBAAkB;wDAE7C,sIAAsI;0DACnG,cAAc;0DACd,YAAY;gEAE/C,8EAA8E;+DACtC,kBAAkB;sDAC3B,gBAAgB;UAClD;;EAGwB,CAAC"}
+{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../src/translations.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAE7B,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAKnB,SAAA,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;oCACD,OAAO;oCACP,OAAO;+CACI,kBAAkB;yDACR,uCAAuC;4CACpD,UAAU;+CACP,kBAAkB;0CACvB,SAAS;uCACZ,MAAM;0CACH,OAAO;gDACD,eAAe;+CAChB,aAAa;wDACJ,6CAA6C;yCAC5D,YAAY;0CACX,aAAa;0CACb,OAAO;4CACL,WAAW;2CACZ,kBAAkB;+DAEE,4DAA4D;uDACpE,2BAA2B;uDAC3B,eAAe;iEACL,2BAA2B;mEACzB,4BAA4B;4DAGxE,0EAA0E;oDAC7C,4BAA4B;oDAC5B,mBAAmB;gEACP,qBAAqB;8DACvB,+BAA+B;gEAC7B,gCAAgC;iDAE/C,kBAAkB;uDACZ,mEAAmE;iDACzE,qCAAqC;uDAE/D,oGAAoG;qDACtE,qBAAqB;2DACf,uDAAuD;8CACpE,kBAAkB;oDACZ,kEAAkE;4DAC1D,uBAAuB;kEAE5D,uEAAuE;qDACzC,sBAAsB;2DAChB,oDAAoD;kDAC7D,oBAAoB;sDAChB,0BAA0B;8DAClB,2CAA2C;oEAElF,oHAAoH;wDACnF,kBAAkB;uDACnB,eAAe;2DAEX,WAAW;4DACV,MAAM;uEAE3C,wEAAwE;kDAE7C,YAAY;0DAEJ,kBAAkB;gEAErD,+GAA+G;kDACpF,kBAAkB;wDAE7C,sIAAsI;0DACnG,cAAc;0DACd,YAAY;gEAE/C,8EAA8E;sDAC/C,gBAAgB;UAClD;;EAG8B,CAAC"}

package/dist/types/src/types/Debug.d.ts

@@ -1,7 +1,7 @@
-import type * as Atom from 'effect/unstable/reactivity/Atom';
+import type * as Atom from 'effect/reactivity/Atom';
 import * as Capability from '@dxos/app-framework/Capability';
 import { type IdbLogStore } from '@dxos/log-store-idb';
-import * as Settings from './Settings';
+import * as Settings from './Settings.ts';
 export type DebugPluginOptions = {
     /** Shared persistent log store for capturing and downloading logs. */
     logStore?: IdbLogStore;

package/dist/types/src/types/Debug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Debug.d.ts","sourceRoot":"","sources":["../../../../src/types/Debug.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,IAAI,MAAM,iCAAiC,CAAC;AAE7D,OAAO,KAAK,UAAU,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AAEvC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,iGAAiG;IACjG,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,yBAAiB,iBAAiB,CAAC;IAC1B,MAAM,QAAQ,sGAEpB,CAAC;CACH"}
+{"version":3,"file":"Debug.d.ts","sourceRoot":"","sources":["../../../../src/types/Debug.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,IAAI,MAAM,wBAAwB,CAAC;AAEpD,OAAO,KAAK,UAAU,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAE1C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,iGAAiG;IACjG,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,yBAAiB,iBAAiB,CAAC;IAC1B,MAAM,QAAQ,sGAEpB,CAAC;CACH"}

package/dist/types/src/types/DebugNodes.d.ts

@@ -1,7 +1,19 @@
 /** Extracts the last dot-separated segment of a namespaced ID string for use as a node segment id. */
 export declare const nodeId: (fullId: string) => string;
-/** Top-level Debug node (sibling of DevTools under the SYSTEM navtree group). */
+/** Top-level Debug node, under the debug category. */
 export declare const id: string;
 /** Discriminator for the space-generator article surface (`node.data.type`). */
 export declare const SpaceType: string;
+/** Qualified id of the hidden debug category, the root of the debug panel's tree. */
+export declare const DEBUG_ROOT_ID = "root/debug";
+/** Qualified id of the Debug node, which hosts the panel's own pages. */
+export declare const DEBUG_NODE_ID: string;
+/** Node data of the Effect-CLI console page. */
+export declare const Console: string;
+/** Qualified id of the console page: what a pristine panel opens on. */
+export declare const CONSOLE_NODE_ID: string;
+/** Node data of the log viewer page. */
+export declare const Logs: string;
+/** Qualified id of the log viewer page. */
+export declare const LOGS_NODE_ID: string;
 //# sourceMappingURL=DebugNodes.d.ts.map

package/dist/types/src/types/DebugNodes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DebugNodes.d.ts","sourceRoot":"","sources":["../../../../src/types/DebugNodes.ts"],"names":[],"mappings":"AAQA,sGAAsG;AACtG,eAAO,MAAM,MAAM,WAAY,MAAM,KAAG,MAAwC,CAAC;AAIjF,iFAAiF;AACjF,eAAO,MAAM,EAAE,QAAqB,CAAC;AAErC,gFAAgF;AAChF,eAAO,MAAM,SAAS,QAAqB,CAAC"}
+{"version":3,"file":"DebugNodes.d.ts","sourceRoot":"","sources":["../../../../src/types/DebugNodes.ts"],"names":[],"mappings":"AAUA,sGAAsG;AACtG,eAAO,MAAM,MAAM,WAAY,MAAM,KAAG,MAAwC,CAAC;AAIjF,sDAAsD;AACtD,eAAO,MAAM,EAAE,QAAqB,CAAC;AAErC,gFAAgF;AAChF,eAAO,MAAM,SAAS,QAAqB,CAAC;AAE5C,qFAAqF;AACrF,eAAO,MAAM,aAAa,eAA8B,CAAC;AAEzD,yEAAyE;AACzE,eAAO,MAAM,aAAa,QAAmC,CAAC;AAE9D,gDAAgD;AAChD,eAAO,MAAM,OAAO,QAAuB,CAAC;AAE5C,wEAAwE;AACxE,eAAO,MAAM,eAAe,QAAwC,CAAC;AAErE,wCAAwC;AACxC,eAAO,MAAM,IAAI,QAAoB,CAAC;AAEtC,2CAA2C;AAC3C,eAAO,MAAM,YAAY,QAAqC,CAAC"}

package/dist/types/src/types/DebugOperation.d.ts

@@ -1,4 +1,5 @@
 import * as Capability from '@dxos/app-framework/Capability';
+import * as Plugin from '@dxos/app-framework/Plugin';
 import * as Operation from '@dxos/compute/Operation';
 /**
  * Fills the document with placeholder prose from the slash menu — the cheapest way to get a
@@ -8,4 +9,122 @@ export declare const InsertLoremIpsum: Operation.Definition<{
     readonly subject: string;
     readonly head: number;
 }, void, 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.
+ */
+export declare const OpenPage: Operation.Definition<{
+    readonly nodeId: string;
+}, void, Capability.Service>;
+/**
+ * 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.
+ */
+export declare const Snapshot: Operation.Definition<{
+    readonly since?: number | undefined;
+}, {
+    readonly layout?: {
+        readonly mode: string;
+        readonly sidebarOpen: boolean;
+        readonly complementarySidebarOpen: boolean;
+        readonly dialogOpen: boolean;
+        readonly workspace: string;
+        readonly active: readonly string[];
+        readonly inactive: readonly string[];
+        readonly scrollIntoView?: string | undefined;
+    } | undefined;
+    readonly attention: readonly string[];
+    readonly planks: readonly {
+        readonly id: string;
+        readonly label?: string | undefined;
+        readonly type?: string | undefined;
+        readonly subject?: {
+            readonly id?: string | undefined;
+            readonly dxn?: string | undefined;
+            readonly typename?: string | undefined;
+            readonly name?: string | undefined;
+            readonly text?: string | undefined;
+        } | undefined;
+        readonly actions: readonly {
+            readonly id: string;
+            readonly label?: string | undefined;
+            readonly icon?: string | undefined;
+            readonly disabled?: boolean | undefined;
+            readonly operation?: string | undefined;
+            readonly group?: boolean | undefined;
+        }[];
+        readonly comments?: readonly {
+            readonly id: string;
+            readonly anchorId: string;
+            readonly anchor?: string | undefined;
+            readonly status?: string | undefined;
+            readonly messages: readonly {
+                readonly id: string;
+                readonly sender?: string | undefined;
+                readonly text?: string | undefined;
+            }[];
+        }[] | undefined;
+    }[];
+    readonly surfaces: readonly {
+        readonly id?: string | undefined;
+        readonly role?: string | undefined;
+        readonly component?: string | undefined;
+    }[];
+    readonly spaces: readonly {
+        readonly id: string;
+        readonly name?: string | undefined;
+        readonly state: string;
+        readonly default?: boolean | undefined;
+    }[];
+    readonly toasts: readonly {
+        readonly title?: string | undefined;
+        readonly description?: string | undefined;
+        readonly actions: readonly string[];
+    }[];
+    readonly errors: readonly {
+        readonly timestamp: number;
+        readonly message?: string | undefined;
+        readonly error?: string | undefined;
+        readonly file?: string | undefined;
+    }[];
+    readonly plugins: {
+        readonly installed: number;
+        readonly enabled: number;
+        readonly active: number;
+    };
+}, Capability.Service | Plugin.Service>;
+/**
+ * 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.
+ */
+export declare const Undo: Operation.Definition<{}, {
+    readonly undone: boolean;
+}, Capability.Service>;
+/**
+ * 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.
+ */
+export declare const CreateSpaceFromTemplate: Operation.Definition<{
+    readonly id?: string | undefined;
+}, {
+    readonly applied?: {
+        readonly id: string;
+        readonly label: string;
+        readonly description?: string | undefined;
+    } | undefined;
+    readonly spaceId?: string | undefined;
+    readonly subject?: readonly string[] | undefined;
+    readonly available: readonly {
+        readonly id: string;
+        readonly label: string;
+        readonly description?: string | undefined;
+    }[];
+}, Capability.Service | Plugin.Service>;
 //# sourceMappingURL=DebugOperation.d.ts.map

package/dist/types/src/types/DebugOperation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DebugOperation.d.ts","sourceRoot":"","sources":["../../../../src/types/DebugOperation.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,UAAU,MAAM,gCAAgC,CAAC;AAC7D,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAC;AAIrD;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;4BAY3B,CAAC"}
+{"version":3,"file":"DebugOperation.d.ts","sourceRoot":"","sources":["../../../../src/types/DebugOperation.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,UAAU,MAAM,gCAAgC,CAAC;AAC7D,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAC;AAIrD;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;4BAY3B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,QAAQ;;4BAYnB,CAAC;AAyFH;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCA+Bc,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,IAAI;;sBAYf,CAAC;AAQH;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;uCA0BA,CAAC"}

package/dist/types/src/types/DebugSurface.d.ts

@@ -1,8 +1,15 @@
 import * as Role from '@dxos/app-framework/Role';
+import type * as AppSurface from '@dxos/app-toolkit/AppSurface';
 /**
  * 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.
  */
 export declare const Stats: Role.Role<Record<string, unknown>>;
+/** Article data for a page of the debug panel, whose nodes have no URL for `LayoutOperation.Open`. */
+export type PageData = AppSurface.ArticleData<unknown, {
+    onNavigate: (nodeId: string) => void;
+}>;
+/** Role token for a page of the debug panel; every node under `root/debug` registers its surface on it. */
+export declare const Page: Role.Role<PageData>;
 //# sourceMappingURL=DebugSurface.d.ts.map

package/dist/types/src/types/DebugSurface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DebugSurface.d.ts","sourceRoot":"","sources":["../../../../src/types/DebugSurface.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,IAAI,MAAM,0BAA0B,CAAC;AAIjD;;;;GAIG;AACH,eAAO,MAAM,KAAK,oCAA0E,CAAC"}
+{"version":3,"file":"DebugSurface.d.ts","sourceRoot":"","sources":["../../../../src/types/DebugSurface.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,IAAI,MAAM,0BAA0B,CAAC;AACjD,OAAO,KAAK,KAAK,UAAU,MAAM,8BAA8B,CAAC;AAIhE;;;;GAIG;AACH,eAAO,MAAM,KAAK,oCAA0E,CAAC;AAE7F,sGAAsG;AACtG,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,CAAC,CAAC;AAEjG,2GAA2G;AAC3G,eAAO,MAAM,IAAI,qBAA0D,CAAC"}

package/dist/types/src/types/index.d.ts

@@ -1,7 +1,7 @@
-export * as Debug from './Debug';
-export * as DebugEvents from './DebugEvents';
-export * as DebugNodes from './DebugNodes';
-export * as DebugOperation from './DebugOperation';
-export * as DebugSurface from './DebugSurface';
-export * as Settings from './Settings';
+export * as Debug from './Debug.ts';
+export * as DebugEvents from './DebugEvents.ts';
+export * as DebugNodes from './DebugNodes.ts';
+export * as DebugOperation from './DebugOperation.ts';
+export * as DebugSurface from './DebugSurface.ts';
+export * as Settings from './Settings.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,WAAW,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,cAAc,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,YAAY,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC"}