@dxos/plugin-devtools 0.11.1 → 0.12.0-next-bbabc02363f18d7643ea4160e3a7a7809870fd0d

package/dist/lib/{chunk-types.mjs → Devtools.mjs}

@@ -1,20 +1,10 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
 import { meta } from "#meta";
-//#region \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-//#endregion
 //#region src/types/Devtools.ts
 var Devtools_exports = /* @__PURE__ */ __exportAll({
 	Agent: () => Agent,
 	AppGraph: () => AppGraph,
+	Cli: () => Cli,
 	Client: () => Client,
 	Echo: () => Echo,
 	Edge: () => Edge,
@@ -34,6 +24,7 @@ var devtoolsId = `${meta.profile.key}.devtools`;
 var id = devtoolsId;
 var AppGraph = `${devtoolsId}.appGraph`;
 var ToolsExplorer = `${devtoolsId}.toolsExplorer`;
+var Cli = `${devtoolsId}.cli`;
 var Client;
 (function(_Client) {
 	_Client.id = `${devtoolsId}.client`;
@@ -87,6 +78,6 @@ var Edge;
 	_Edge.Testing = `${Edge.id}.testing`;
 })(Edge || (Edge = {}));
 //#endregion
-export { Devtools_exports as t };
+export { Agent, AppGraph, Cli, Client, Echo, Edge, Halo, Mesh, ToolsExplorer, id, nodeId, Devtools_exports as t };
 
-//# sourceMappingURL=chunk-types.mjs.map
+//# sourceMappingURL=Devtools.mjs.map

package/dist/lib/Devtools.mjs.map

@@ -0,0 +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,IAAA;;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;GAC1C,WAAA,SAAA,CAAA,EAAA;AAEO,IAAA;;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;GACxC,SAAA,OAAA,CAAA,EAAA;AAEO,IAAA;;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;GACrC,SAAA,OAAA,CAAA,EAAA;AAEO,IAAA;;CACQ,MAAA,KAAK,GAAG,WAAW;CACnB,MAAA,SAAS,GAAG,KAAK,GAAG;CACpB,MAAA,QAAQ,GAAG,KAAK,GAAG;CACnB,MAAA,UAAU,GAAG,KAAK,GAAG;GACpC,SAAA,OAAA,CAAA,EAAA;AAEO,IAAA;;CACQ,OAAA,KAAK,GAAG,WAAW;CACnB,OAAA,YAAY,GAAG,MAAM,GAAG;CACxB,OAAA,SAAS,GAAG,MAAM,GAAG;GACpC,UAAA,QAAA,CAAA,EAAA;AAEO,IAAA;;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;GACpC,SAAA,OAAA,CAAA,EAAA"}

package/dist/lib/DevtoolsEvents.mjs

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

package/dist/lib/DevtoolsEvents.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevtoolsEvents.mjs","names":[],"sources":["../../src/types/DevtoolsEvents.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as ActivationEvent from '@dxos/app-framework/ActivationEvent';\n\nimport { meta } from '#meta';\n\n/**\n * The feature's start event: the plugin's start-gated modules (and cross-plugin\n * contributions consumed by this feature) activate here. Fired on demand and by the\n * host's idle trickle.\n */\nexport const Start = ActivationEvent.pluginStart(meta.profile.key);\n"],"mappings":";;;;;;;;;;AAeA,IAAa,QAAQ,gBAAgB,YAAY,KAAK,QAAQ,GAAG"}

package/dist/lib/DevtoolsPlugin.mjs

@@ -1,25 +1,21 @@
-import { ActivationEvents, Capability, Plugin } from "@dxos/app-framework";
+import * as Plugin from "@dxos/app-framework/Plugin";
 import { meta } from "#meta";
 import * as Effect from "effect/Effect";
-import { AppPlugin } from "@dxos/app-toolkit";
+import * as Capability from "@dxos/app-framework/Capability";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
 import { AppGraphBuilder, ReactContext, ReactSurface } from "#capabilities";
 import { translations } from "#translations";
+//#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/DevtoolsPlugin.tsx
-var DevtoolsPlugin = Plugin.define(meta).pipe(AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }), AppPlugin.addReactContextModule({ activate: ReactContext }), Plugin.addModule({
-	id: Capability.getModuleTag(ReactSurface) ?? "surfaces",
-	activatesOn: ActivationEvents.SetupReactSurface,
-	activate: () => ReactSurface()
-}), AppPlugin.addTranslationsModule({ translations }), Plugin.addModule({
-	id: "setup-devtools",
-	activatesOn: ActivationEvents.Startup,
-	activate: () => Effect.sync(() => setupDevtools())
-}), AppPlugin.addPluginAssetModule({ asset: {
+var SetupDevtools = Capability.inlineModule("setup-devtools", { provides: [] }, () => Effect.sync(() => setupDevtools()));
+var DevtoolsPlugin = Plugin.define(meta).pipe(Plugin.addModule(AppGraphBuilder), Plugin.addModule(ReactContext), Plugin.addModule(ReactSurface), Plugin.addModule(AppCapability.translations(translations)), Plugin.addModule(SetupDevtools), Plugin.addModule(AppCapability.pluginAsset({
 	pluginId: meta.profile.key,
 	path: "PLUGIN.mdl",
-	content: "---\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",
+	content: PLUGIN_default,
 	mimeType: "application/x-mdl"
-} }), Plugin.make);
+})), Plugin.make);
 var setupDevtools = () => {
 	globalThis.composer ??= {};
 	globalThis.composer.changeStorageVersionInMetadata = async (version) => {

package/dist/lib/DevtoolsPlugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"DevtoolsPlugin.mjs","names":[],"sources":["../../src/DevtoolsPlugin.tsx"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { ActivationEvents, Capability, Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\nimport { type Client } from '@dxos/react-client';\n\nimport { AppGraphBuilder, ReactContext, ReactSurface } from '#capabilities';\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 DevtoolsPlugin = Plugin.define(meta).pipe(\n  AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),\n  AppPlugin.addReactContextModule({ activate: ReactContext }),\n  Plugin.addModule({\n    id: Capability.getModuleTag(ReactSurface) ?? 'surfaces',\n    activatesOn: ActivationEvents.SetupReactSurface,\n    activate: () => ReactSurface(),\n  }),\n  AppPlugin.addTranslationsModule({ translations }),\n  Plugin.addModule({\n    id: 'setup-devtools',\n    activatesOn: ActivationEvents.Startup,\n    activate: () => Effect.sync(() => setupDevtools()),\n  }),\n  AppPlugin.addPluginAssetModule({\n    asset: { pluginId: meta.profile.key, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },\n  }),\n  Plugin.make,\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(config.values?.runtime?.client?.storage ?? {});\n    await changeStorageVersionInMetadata(storage, version);\n    location.pathname = '/';\n  };\n};\n\nexport default DevtoolsPlugin;\n"],"mappings":";;;;;;;;AAiBA,IAAa,iBAAiB,OAAO,OAAO,IAAI,CAAC,CAAC,KAChD,UAAU,kBAAkB,EAAE,UAAU,gBAAgB,CAAC,GACzD,UAAU,sBAAsB,EAAE,UAAU,aAAa,CAAC,GAC1D,OAAO,UAAU;CACf,IAAI,WAAW,aAAa,YAAY,KAAK;CAC7C,aAAa,iBAAiB;CAC9B,gBAAgB,aAAa;AAC/B,CAAC,GACD,UAAU,sBAAsB,EAAE,aAAa,CAAC,GAChD,OAAO,UAAU;CACf,IAAI;CACJ,aAAa,iBAAiB;CAC9B,gBAAgB,OAAO,WAAW,cAAc,CAAC;AACnD,CAAC,GACD,UAAU,qBAAqB,EAC7B,OAAO;CAAE,UAAU,KAAK,QAAQ;CAAK,MAAM;CAAc,SAAS;CAAY,UAAU;AAAoB,EAC9G,CAAC,GACD,OAAO,IACT;AAEA,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,qBAAqB,OAAO,QAAQ,SAAS,QAAQ,WAAW,CAAC,CAAC;EACtF,MAAM,+BAA+B,SAAS,OAAO;EACrD,SAAS,WAAW;CACtB;AACF"}
+{"version":3,"file":"DevtoolsPlugin.mjs","names":[],"sources":["../../src/DevtoolsPlugin.tsx"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as Plugin from '@dxos/app-framework/Plugin';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport { type Client } from '@dxos/react-client';\n\nimport { AppGraphBuilder, ReactContext, ReactSurface } from '#capabilities';\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\nconst SetupDevtools = Capability.inlineModule('setup-devtools', { provides: [] }, () =>\n  Effect.sync(() => setupDevtools()),\n);\n\nexport const DevtoolsPlugin = Plugin.define(meta).pipe(\n  Plugin.addModule(AppGraphBuilder),\n  Plugin.addModule(ReactContext),\n  Plugin.addModule(ReactSurface),\n  Plugin.addModule(AppCapability.translations(translations)),\n  Plugin.addModule(SetupDevtools),\n  Plugin.addModule(\n    AppCapability.pluginAsset({\n      pluginId: meta.profile.key,\n      path: 'PLUGIN.mdl',\n      content: pluginSpec,\n      mimeType: 'application/x-mdl',\n    }),\n  ),\n  Plugin.make,\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(config.values?.runtime?.client?.storage ?? {});\n    await changeStorageVersionInMetadata(storage, version);\n    location.pathname = '/';\n  };\n};\n\nexport default DevtoolsPlugin;\n"],"mappings":";;;;;;;;;;;AAkBA,IAAM,gBAAgB,WAAW,aAAa,kBAAkB,EAAE,UAAU,CAAC,EAAE,SAC7E,OAAO,WAAW,cAAc,CAAC,CACnC;AAEA,IAAa,iBAAiB,OAAO,OAAO,IAAI,CAAC,CAAC,KAChD,OAAO,UAAU,eAAe,GAChC,OAAO,UAAU,YAAY,GAC7B,OAAO,UAAU,YAAY,GAC7B,OAAO,UAAU,cAAc,aAAa,YAAY,CAAC,GACzD,OAAO,UAAU,aAAa,GAC9B,OAAO,UACL,cAAc,YAAY;CACxB,UAAU,KAAK,QAAQ;CACvB,MAAM;CACN,SAAS;CACT,UAAU;AACZ,CAAC,CACH,GACA,OAAO,IACT;AAEA,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,qBAAqB,OAAO,QAAQ,SAAS,QAAQ,WAAW,CAAC,CAAC;EACtF,MAAM,+BAA+B,SAAS,OAAO;EACrD,SAAS,WAAW;CACtB;AACF"}

package/dist/lib/DevtoolsPlugin.node.mjs

@@ -1,9 +1,8 @@
-import { Plugin } from "@dxos/app-framework";
+import * as Plugin from "@dxos/app-framework/Plugin";
 import { meta } from "#meta";
-import { AppPlugin } from "@dxos/app-toolkit";
 import { AppGraphBuilder } from "#capabilities";
 //#region src/DevtoolsPlugin.node.ts
-var DevtoolsPlugin = Plugin.define(meta).pipe(AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }), Plugin.make);
+var DevtoolsPlugin = Plugin.define(meta).pipe(Plugin.addModule(AppGraphBuilder), Plugin.make);
 //#endregion
 export { DevtoolsPlugin, DevtoolsPlugin as default };
 

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

@@ -1 +1 @@
-{"version":3,"file":"DevtoolsPlugin.node.mjs","names":[],"sources":["../../src/DevtoolsPlugin.node.ts"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\n\nimport { AppGraphBuilder } from '#capabilities';\nimport { meta } from '#meta';\n\nexport const DevtoolsPlugin = Plugin.define(meta).pipe(\n  AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),\n  Plugin.make,\n);\n\nexport default DevtoolsPlugin;\n"],"mappings":";;;;;AAUA,IAAa,iBAAiB,OAAO,OAAO,IAAI,CAAC,CAAC,KAChD,UAAU,kBAAkB,EAAE,UAAU,gBAAgB,CAAC,GACzD,OAAO,IACT"}
+{"version":3,"file":"DevtoolsPlugin.node.mjs","names":[],"sources":["../../src/DevtoolsPlugin.node.ts"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport * as Plugin from '@dxos/app-framework/Plugin';\n\nimport { AppGraphBuilder } from '#capabilities';\nimport { meta } from '#meta';\n\nexport const DevtoolsPlugin = Plugin.define(meta).pipe(Plugin.addModule(AppGraphBuilder), Plugin.make);\n\nexport default DevtoolsPlugin;\n"],"mappings":";;;;AASA,IAAa,iBAAiB,OAAO,OAAO,IAAI,CAAC,CAAC,KAAK,OAAO,UAAU,eAAe,GAAG,OAAO,IAAI"}

package/dist/lib/DevtoolsPlugin.workerd.mjs

@@ -1,4 +1,4 @@
-import { Plugin } from "@dxos/app-framework";
+import * as Plugin from "@dxos/app-framework/Plugin";
 import { meta } from "#meta";
 //#region src/DevtoolsPlugin.workerd.ts
 var DevtoolsPlugin = Plugin.define(meta).pipe(Plugin.make);

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

@@ -1 +1 @@
-{"version":3,"file":"DevtoolsPlugin.workerd.mjs","names":[],"sources":["../../src/DevtoolsPlugin.workerd.ts"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\n\nimport { meta } from '#meta';\n\nexport const DevtoolsPlugin = Plugin.define(meta).pipe(Plugin.make);\n\nexport default DevtoolsPlugin;\n"],"mappings":";;;AAQA,IAAa,iBAAiB,OAAO,OAAO,IAAI,CAAC,CAAC,KAAK,OAAO,IAAI"}
+{"version":3,"file":"DevtoolsPlugin.workerd.mjs","names":[],"sources":["../../src/DevtoolsPlugin.workerd.ts"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport * as Plugin from '@dxos/app-framework/Plugin';\n\nimport { meta } from '#meta';\n\nexport const DevtoolsPlugin = Plugin.define(meta).pipe(Plugin.make);\n\nexport default DevtoolsPlugin;\n"],"mappings":";;;AAQA,IAAa,iBAAiB,OAAO,OAAO,IAAI,CAAC,CAAC,KAAK,OAAO,IAAI"}

package/dist/lib/capabilities.mjs

@@ -1,8 +1,9 @@
-import { Capability } from "@dxos/app-framework";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
+import * as AppCapabilities from "@dxos/app-toolkit/AppCapabilities";
 //#region src/capabilities/index.ts
-var AppGraphBuilder = Capability.lazy("AppGraphBuilder", () => import("./chunk-app-graph-builder.mjs"));
-var ReactContext = Capability.lazy("ReactContext", () => import("./chunk-react-context.mjs"));
-var ReactSurface = Capability.lazy("ReactSurface", () => import("./chunk-react-surface.mjs"));
+var AppGraphBuilder = AppCapability.appGraphBuilder(() => import("./chunk-app-graph-builder.mjs"), { requires: [AppCapabilities.AppGraph] });
+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"] });
 //#endregion
 export { AppGraphBuilder, ReactContext, ReactSurface };
 

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 { Capability } from '@dxos/app-framework';\n\nexport const AppGraphBuilder = Capability.lazy('AppGraphBuilder', () => import('./app-graph-builder'));\nexport const ReactContext = Capability.lazy('ReactContext', () => import('./react-context'));\nexport const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));\n"],"mappings":";;AAMA,IAAa,kBAAkB,WAAW,KAAK,yBAAyB,OAAO,gCAAsB;AACrG,IAAa,eAAe,WAAW,KAAK,sBAAsB,OAAO,4BAAkB;AAC3F,IAAa,eAAe,WAAW,KAAK,sBAAsB,OAAO,4BAAkB"}
+{"version":3,"file":"capabilities.mjs","names":[],"sources":["../../src/capabilities/index.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\n\nexport const AppGraphBuilder = AppCapability.appGraphBuilder(() => import('./app-graph-builder'), {\n  requires: [AppCapabilities.AppGraph],\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});\n"],"mappings":";;;AAOA,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,kCAAwB,EAChG,UAAU,CAAC,gBAAgB,QAAQ,EACrC,CAAC;AACD,IAAa,eAAe,cAAc,mBAAmB,OAAO,4BAAkB;AACtF,IAAa,eAAe,cAAc,cAAc,OAAO,8BAAoB,EACjF,OAAO,CAAC,yBAAyB,8CAA8C,EACjF,CAAC"}

package/dist/lib/chunk-CliPanel.mjs

@@ -0,0 +1,103 @@
+import * as Plugin from "@dxos/app-framework/Plugin";
+import * as Effect from "effect/Effect";
+import * as Capability from "@dxos/app-framework/Capability";
+import { useEffect, useMemo } from "react";
+import * as Capabilities from "@dxos/app-framework/Capabilities";
+import { useCapabilities, usePluginManager } from "@dxos/app-framework/ui";
+import { Placeholder } from "@dxos/devtools";
+import { jsx } from "react/jsx-runtime";
+import { useClient } from "@dxos/react-client";
+import { Panel } from "@dxos/react-ui";
+import { Terminal } from "@dxos/react-ui-terminal";
+import * as Command from "@effect/cli/Command";
+import * as Options from "@effect/cli/Options";
+import * as Layer from "effect/Layer";
+import * as ActivationEvents from "@dxos/app-framework/ActivationEvents";
+import { CommandConfig } from "@dxos/cli-util";
+import { ClientService, ConfigService } from "@dxos/client";
+import * as Operation from "@dxos/compute/Operation";
+import { EffectEx } from "@dxos/effect";
+//#region src/containers/CliPanel/useCliApp.ts
+var OPERATIONS_UNAVAILABLE = "Operations are not available in the devtools terminal.";
+/**
+* Commands that create objects invoke operations, which this surface has no runtime for. Failing
+* with a stated reason beats the bare "Service not found" a missing layer would produce.
+*/
+var operationLayer = Layer.succeed(Operation.Service, {
+	invoke: () => Effect.die(OPERATIONS_UNAVAILABLE),
+	schedule: () => Effect.die(OPERATIONS_UNAVAILABLE),
+	invokePromise: async () => ({ error: /* @__PURE__ */ new Error(OPERATIONS_UNAVAILABLE) })
+});
+/**
+* Builds the `dx` command tree and the services its handlers need.
+*
+* Mounting is the demand signal: command modules are gated on `CommandsRequested`, which nothing
+* else in the app fires, so a plugin's commands stay off the critical path until a terminal opens.
+* The capability is read through its atom, so commands appear as they activate and enabling or
+* disabling a plugin later rebuilds the tree rather than leaving the terminal on the set that
+* existed when it mounted.
+*
+* The root mirrors the binary's, minus the options that only mean something on a filesystem
+* (`--config`, `--profile`); everything else resolves the same way, including `--space-id`
+* defaulting to the first available space.
+*
+* Returns `undefined` until something contributes commands — there is no shell to offer yet.
+*/
+var useCliApp = (client) => {
+	const manager = usePluginManager();
+	const commands = useCapabilities(Capabilities.Command);
+	const contributed = useCapabilities(Capabilities.Layer);
+	useEffect(() => {
+		EffectEx.runDetached(manager.activate(ActivationEvents.CommandsRequested));
+	}, [manager]);
+	return useMemo(() => {
+		const [first, ...rest] = commands;
+		if (!first) return;
+		const command = Command.make("dx", {
+			json: Options.boolean("json", { ifPresent: true }).pipe(Options.withDescription("JSON output.")),
+			verbose: Options.boolean("verbose", { ifPresent: true }).pipe(Options.withAlias("v"), Options.withDescription("Verbose output."))
+		}).pipe(Command.withSubcommands([first, ...rest]), Command.provide(({ json, verbose }) => Layer.succeed(CommandConfig, {
+			json,
+			verbose,
+			profile: "default",
+			logLevel: "info"
+		})));
+		const hostLayer = Layer.mergeAll(ClientService.fromClient(client), ConfigService.fromConfig(client.config), Layer.succeed(Plugin.Service, manager), Layer.succeed(Capability.Service, manager.capabilities), operationLayer);
+		return {
+			command,
+			layer: Layer.orDie(Layer.mergeAll(hostLayer, ...contributed))
+		};
+	}, [
+		client,
+		manager,
+		commands,
+		contributed
+	]);
+};
+//#endregion
+//#region src/containers/CliPanel/CliPanel.tsx
+var BOLD = "\x1B[1m";
+var DIM = "\x1B[2m";
+var RESET = "\x1B[0m";
+var BANNER = `${BOLD}DXOS CLI${RESET}\n${DIM}The dx commands, running against this client. Type "help" for the list.${RESET}`;
+/**
+* Runs the `dx` CLI against the client backing this app.
+*
+* The command tree is assembled from the commands the installed plugins contribute, and it and its
+* services are built once per client, so state the handlers hold survives between commands the way
+* it does in a long-lived shell.
+*/
+var CliPanel = () => {
+	const cli = useCliApp(useClient());
+	return /* @__PURE__ */ jsx(Panel.Root, { children: /* @__PURE__ */ jsx(Panel.Content, { children: cli ? /* @__PURE__ */ jsx(Terminal, {
+		command: cli.command,
+		layer: cli.layer,
+		name: "dx",
+		banner: BANNER
+	}) : /* @__PURE__ */ jsx(Placeholder, { label: "No commands" }) }) });
+};
+CliPanel.displayName = "CliPanel";
+//#endregion
+export { CliPanel, CliPanel as default };
+
+//# sourceMappingURL=chunk-CliPanel.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-CliPanel.mjs","names":[],"sources":["../../src/containers/CliPanel/useCliApp.ts","../../src/containers/CliPanel/CliPanel.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Command from '@effect/cli/Command';\nimport * as Options from '@effect/cli/Options';\nimport * as Effect from 'effect/Effect';\nimport * as Layer from 'effect/Layer';\nimport { useEffect, useMemo } from 'react';\n\nimport * as ActivationEvents from '@dxos/app-framework/ActivationEvents';\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as Plugin from '@dxos/app-framework/Plugin';\nimport { useCapabilities, usePluginManager } from '@dxos/app-framework/ui';\nimport { CommandConfig, type CommandServices } from '@dxos/cli-util';\nimport { type Client, ClientService, ConfigService } from '@dxos/client';\nimport * as Operation from '@dxos/compute/Operation';\nimport { EffectEx } from '@dxos/effect';\n\nconst OPERATIONS_UNAVAILABLE = 'Operations are not available in the devtools terminal.';\n\n/**\n * Commands that create objects invoke operations, which this surface has no runtime for. Failing\n * with a stated reason beats the bare \"Service not found\" a missing layer would produce.\n */\nconst operationLayer = Layer.succeed(Operation.Service, {\n  invoke: () => Effect.die(OPERATIONS_UNAVAILABLE),\n  schedule: () => Effect.die(OPERATIONS_UNAVAILABLE),\n  invokePromise: async () => ({ error: new Error(OPERATIONS_UNAVAILABLE) }),\n});\n\n/**\n * Builds the `dx` command tree and the services its handlers need.\n *\n * Mounting is the demand signal: command modules are gated on `CommandsRequested`, which nothing\n * else in the app fires, so a plugin's commands stay off the critical path until a terminal opens.\n * The capability is read through its atom, so commands appear as they activate and enabling or\n * disabling a plugin later rebuilds the tree rather than leaving the terminal on the set that\n * existed when it mounted.\n *\n * The root mirrors the binary's, minus the options that only mean something on a filesystem\n * (`--config`, `--profile`); everything else resolves the same way, including `--space-id`\n * defaulting to the first available space.\n *\n * Returns `undefined` until something contributes commands — there is no shell to offer yet.\n */\nexport const useCliApp = (client: Client) => {\n  const manager = usePluginManager();\n  const commands = useCapabilities(Capabilities.Command);\n  const contributed = useCapabilities(Capabilities.Layer);\n\n  useEffect(() => {\n    EffectEx.runDetached(manager.activate(ActivationEvents.CommandsRequested));\n  }, [manager]);\n\n  return useMemo(() => {\n    // Destructured rather than passed as an array so the non-empty shape `withSubcommands` requires\n    // is carried by the type instead of asserted.\n    const [first, ...rest] = commands;\n    if (!first) {\n      return undefined;\n    }\n\n    // `provide` comes after the subcommands so the config reaches them in the type as well as at\n    // runtime; applied before, every subcommand still advertises `CommandConfig` as unmet.\n    const command = Command.make('dx', {\n      json: Options.boolean('json', { ifPresent: true }).pipe(Options.withDescription('JSON output.')),\n      verbose: Options.boolean('verbose', { ifPresent: true }).pipe(\n        Options.withAlias('v'),\n        Options.withDescription('Verbose output.'),\n      ),\n    }).pipe(\n      Command.withSubcommands([first, ...rest]),\n      Command.provide(({ json, verbose }) =>\n        Layer.succeed(CommandConfig, { json, verbose, profile: 'default', logLevel: 'info' }),\n      ),\n    );\n\n    // Annotated so a service this host owes is a build error naming it, rather than a\n    // \"Service not found\" the first time someone runs the command that needed it.\n    const hostLayer: Layer.Layer<CommandServices, never, never> = Layer.mergeAll(\n      ClientService.fromClient(client),\n      ConfigService.fromConfig(client.config),\n      Layer.succeed(Plugin.Service, manager),\n      Layer.succeed(Capability.Service, manager.capabilities),\n      operationLayer,\n    );\n\n    // Plugins carry anything further their own commands need. A contributed layer may fail to\n    // build, and the shell runs on a fiber with nowhere to report that, so it dies here instead\n    // of being smuggled into the terminal as an unhandled error channel.\n    const layer = Layer.orDie(Layer.mergeAll(hostLayer, ...contributed));\n\n    return { command, layer };\n  }, [client, manager, commands, contributed]);\n};\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport React from 'react';\n\nimport { Placeholder } from '@dxos/devtools';\nimport { useClient } from '@dxos/react-client';\nimport { Panel } from '@dxos/react-ui';\nimport { Terminal } from '@dxos/react-ui-terminal';\n\nimport { useCliApp } from './useCliApp';\n\nconst BOLD = '\\x1b[1m';\nconst DIM = '\\x1b[2m';\nconst RESET = '\\x1b[0m';\n\nconst BANNER = `${BOLD}DXOS CLI${RESET}\\n${DIM}The dx commands, running against this client. Type \"help\" for the list.${RESET}`;\n\n/**\n * Runs the `dx` CLI against the client backing this app.\n *\n * The command tree is assembled from the commands the installed plugins contribute, and it and its\n * services are built once per client, so state the handlers hold survives between commands the way\n * it does in a long-lived shell.\n */\nexport const CliPanel = () => {\n  const client = useClient();\n  const cli = useCliApp(client);\n\n  // No ScrollArea: xterm owns its own viewport and scrollback.\n  return (\n    <Panel.Root>\n      <Panel.Content>\n        {cli ? (\n          <Terminal command={cli.command} layer={cli.layer} name='dx' banner={BANNER} />\n        ) : (\n          <Placeholder label='No commands' />\n        )}\n      </Panel.Content>\n    </Panel.Root>\n  );\n};\n\nCliPanel.displayName = 'CliPanel';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,IAAM,yBAAyB;;;;;AAM/B,IAAM,iBAAiB,MAAM,QAAQ,UAAU,SAAS;CACtD,cAAc,OAAO,IAAI,sBAAsB;CAC/C,gBAAgB,OAAO,IAAI,sBAAsB;CACjD,eAAe,aAAa,EAAE,uBAAO,IAAI,MAAM,sBAAsB,EAAE;AACzE,CAAC;;;;;;;;;;;;;;;;AAiBD,IAAa,aAAa,WAAmB;CAC3C,MAAM,UAAU,iBAAiB;CACjC,MAAM,WAAW,gBAAgB,aAAa,OAAO;CACrD,MAAM,cAAc,gBAAgB,aAAa,KAAK;CAEtD,gBAAgB;EACd,SAAS,YAAY,QAAQ,SAAS,iBAAiB,iBAAiB,CAAC;CAC3E,GAAG,CAAC,OAAO,CAAC;CAEZ,OAAO,cAAc;EAGnB,MAAM,CAAC,OAAO,GAAG,QAAQ;EACzB,IAAI,CAAC,OACH;EAKF,MAAM,UAAU,QAAQ,KAAK,MAAM;GACjC,MAAM,QAAQ,QAAQ,QAAQ,EAAE,WAAW,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,gBAAgB,cAAc,CAAC;GAC/F,SAAS,QAAQ,QAAQ,WAAW,EAAE,WAAW,KAAK,CAAC,CAAC,CAAC,KACvD,QAAQ,UAAU,GAAG,GACrB,QAAQ,gBAAgB,iBAAiB,CAC3C;EACF,CAAC,CAAC,CAAC,KACD,QAAQ,gBAAgB,CAAC,OAAO,GAAG,IAAI,CAAC,GACxC,QAAQ,SAAS,EAAE,MAAM,cACvB,MAAM,QAAQ,eAAe;GAAE;GAAM;GAAS,SAAS;GAAW,UAAU;EAAO,CAAC,CACtF,CACF;EAIA,MAAM,YAAwD,MAAM,SAClE,cAAc,WAAW,MAAM,GAC/B,cAAc,WAAW,OAAO,MAAM,GACtC,MAAM,QAAQ,OAAO,SAAS,OAAO,GACrC,MAAM,QAAQ,WAAW,SAAS,QAAQ,YAAY,GACtD,cACF;EAOA,OAAO;GAAE;GAAS,OAFJ,MAAM,MAAM,MAAM,SAAS,WAAW,GAAG,WAAW,CAEhD;EAAM;CAC1B,GAAG;EAAC;EAAQ;EAAS;EAAU;CAAW,CAAC;AAC7C;;;ACnFA,IAAM,OAAO;AACb,IAAM,MAAM;AACZ,IAAM,QAAQ;AAEd,IAAM,SAAS,GAAG,KAAK,UAAU,MAAM,IAAI,IAAI,yEAAyE;;;;;;;;AASxH,IAAa,iBAAiB;CAE5B,MAAM,MAAM,UADG,UACO,CAAM;CAG5B,OACE,oBAAC,MAAM,MAAP,EAAA,UACE,oBAAC,MAAM,SAAP,EAAA,UACG,MACC,oBAAC,UAAD;EAAU,SAAS,IAAI;EAAS,OAAO,IAAI;EAAO,MAAK;EAAK,QAAQ;CAAS,CAAA,IAE7E,oBAAC,aAAD,EAAa,OAAM,cAAe,CAAA,EAEvB,CAAA,EACL,CAAA;AAEhB;AAEA,SAAS,cAAc"}

package/dist/lib/chunk-RegistryPanel.mjs

@@ -2,9 +2,9 @@ import { useCallback, useEffect, useMemo, useState } from "react";
 import { JsonView, Placeholder, Searchbar } from "@dxos/devtools";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Entity, Format, Obj, Type } from "@dxos/echo";
-import { Panel, Toolbar } from "@dxos/react-ui";
-import { Operation } from "@dxos/compute";
 import { useClient } from "@dxos/react-client";
+import { Panel, Toolbar } from "@dxos/react-ui";
+import * as Operation from "@dxos/compute/Operation";
 import { DynamicTable } from "@dxos/react-ui-table";
 import { mx } from "@dxos/ui-theme";
 //#region src/containers/RegistryPanel/RegistryPanel.tsx

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

@@ -1 +1 @@
-{"version":3,"file":"chunk-RegistryPanel.mjs","names":[],"sources":["../../src/containers/RegistryPanel/RegistryPanel.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport React, { useCallback, useEffect, useMemo, useState } from 'react';\n\nimport { Operation } from '@dxos/compute';\nimport { JsonView, Placeholder, Searchbar } from '@dxos/devtools';\nimport { Entity, Format, Obj, Type } from '@dxos/echo';\nimport { useClient } from '@dxos/react-client';\nimport { Panel, Toolbar } from '@dxos/react-ui';\nimport { DynamicTable, type TableFeatures } from '@dxos/react-ui-table';\nimport { mx } from '@dxos/ui-theme';\n\ntype RegistryRow = {\n  id: string;\n  kind: string;\n  label: string;\n  _entity: Entity.Unknown;\n};\n\nconst textFilter = (text?: string) => {\n  if (!text) {\n    return () => true;\n  }\n\n  const matcher = new RegExp(text, 'i');\n  return (entity: Entity.Unknown) => {\n    const typename = Entity.getTypename(entity) ?? '';\n    const metaKey = Obj.isObject(entity) ? (Obj.getMeta(entity).key ?? '') : '';\n    const uri = Type.isType(entity) ? (Type.getURI(entity)?.toString() ?? '') : '';\n    const operationKey =\n      Obj.isObject(entity) && Obj.instanceOf(Operation.PersistentOperation, entity)\n        ? (Operation.getKey(entity) ?? '')\n        : '';\n    const name = Obj.isObject(entity) && Obj.instanceOf(Operation.PersistentOperation, entity) ? entity.name : '';\n    return [typename, metaKey, uri, operationKey, name, getEntityId(entity)].some((value) => value.match(matcher));\n  };\n};\n\nconst getEntityId = (entity: Entity.Unknown): string => {\n  if (entity.id) {\n    return entity.id;\n  }\n  if (Type.isType(entity)) {\n    return Type.getURI(entity)?.toString() ?? Type.getTypename(entity) ?? 'unknown-type';\n  }\n  return Entity.getTypename(entity) ?? 'unknown';\n};\n\nconst getKind = (entity: Entity.Unknown): string => {\n  if (Type.isType(entity)) {\n    return 'type';\n  }\n  if (Obj.isObject(entity) && Obj.instanceOf(Operation.PersistentOperation, entity)) {\n    return 'operation';\n  }\n  return 'other';\n};\n\nconst getLabel = (entity: Entity.Unknown): string => {\n  if (Obj.isObject(entity) && Obj.instanceOf(Operation.PersistentOperation, entity)) {\n    return entity.name || Operation.getKey(entity) || getEntityId(entity);\n  }\n  if (Type.isType(entity)) {\n    return Type.getTypename(entity) ?? getEntityId(entity);\n  }\n  return getEntityId(entity);\n};\n\nconst toDetailJson = (entity: Entity.Unknown): object => {\n  if (Type.isType(entity)) {\n    return {\n      id: getEntityId(entity),\n      typename: Type.getTypename(entity),\n      uri: Type.getURI(entity)?.toString(),\n      version: Type.getVersion(entity),\n      jsonSchema: entity.jsonSchema,\n    };\n  }\n  if (Obj.isObject(entity)) {\n    return Obj.toJSON(entity);\n  }\n  return { id: getEntityId(entity), typename: Entity.getTypename(entity) };\n};\n\nexport const RegistryPanel = () => {\n  const client = useClient();\n  const [entities, setEntities] = useState<Entity.Unknown[]>([]);\n  const [filter, setFilter] = useState('');\n  const [selected, setSelected] = useState<Entity.Unknown>();\n\n  useEffect(() => {\n    const registry = client.graph.registry;\n    const refresh = () => setEntities([...registry.list()]);\n    refresh();\n    return registry.changed.on(refresh);\n  }, [client]);\n\n  const properties = useMemo(\n    () => [\n      { name: 'kind', format: Format.TypeFormat.String, size: 100 },\n      { name: 'label', format: Format.TypeFormat.String },\n      { name: 'id', format: Format.TypeFormat.String, size: 280 },\n    ],\n    [],\n  );\n\n  const rows = useMemo((): RegistryRow[] => {\n    return entities\n      .filter(textFilter(filter))\n      .map((entity) => ({\n        id: getEntityId(entity),\n        kind: getKind(entity),\n        label: getLabel(entity),\n        _entity: entity,\n      }))\n      .toSorted((left, right) => left.label.localeCompare(right.label));\n  }, [entities, filter]);\n\n  const handleRowClicked = useCallback((row: RegistryRow | undefined) => {\n    if (!row?._entity) {\n      return;\n    }\n    setSelected(row._entity);\n  }, []);\n\n  const detailJson = useMemo(() => (selected ? toDetailJson(selected) : undefined), [selected]);\n\n  const features: Partial<TableFeatures> = useMemo(() => ({ selection: { enabled: true, mode: 'single' } }), []);\n\n  return (\n    <Panel.Root>\n      <Panel.Toolbar asChild>\n        <Toolbar.Root>\n          <Searchbar placeholder='Filter...' onChange={setFilter} />\n        </Toolbar.Root>\n      </Panel.Toolbar>\n      <Panel.Content>\n        <div className={mx('h-full grid grid-cols-[2fr_1fr] overflow-hidden')}>\n          <div className={mx('flex flex-col min-h-0 overflow-hidden')}>\n            <DynamicTable properties={properties} rows={rows} features={features} onRowClick={handleRowClicked} />\n          </div>\n          <div className={mx('min-h-0 h-full overflow-auto border-s border-separator text-sm')}>\n            {detailJson ? <JsonView data={detailJson} /> : <Placeholder label='Details' />}\n          </div>\n        </div>\n      </Panel.Content>\n    </Panel.Root>\n  );\n};\n\nRegistryPanel.displayName = 'RegistryPanel';\n"],"mappings":"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"}
+{"version":3,"file":"chunk-RegistryPanel.mjs","names":[],"sources":["../../src/containers/RegistryPanel/RegistryPanel.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport React, { useCallback, useEffect, useMemo, useState } from 'react';\n\nimport * as Operation from '@dxos/compute/Operation';\nimport { JsonView, Placeholder, Searchbar } from '@dxos/devtools';\nimport { Entity, Format, Obj, Type } from '@dxos/echo';\nimport { useClient } from '@dxos/react-client';\nimport { Panel, Toolbar } from '@dxos/react-ui';\nimport { DynamicTable, type TableFeatures } from '@dxos/react-ui-table';\nimport { mx } from '@dxos/ui-theme';\n\ntype RegistryRow = {\n  id: string;\n  kind: string;\n  label: string;\n  _entity: Entity.Unknown;\n};\n\nconst textFilter = (text?: string) => {\n  if (!text) {\n    return () => true;\n  }\n\n  const matcher = new RegExp(text, 'i');\n  return (entity: Entity.Unknown) => {\n    const typename = Entity.getTypename(entity) ?? '';\n    const metaKey = Obj.isObject(entity) ? (Obj.getMeta(entity).key ?? '') : '';\n    const uri = Type.isType(entity) ? (Type.getURI(entity)?.toString() ?? '') : '';\n    const operationKey =\n      Obj.isObject(entity) && Obj.instanceOf(Operation.PersistentOperation, entity)\n        ? (Operation.getKey(entity) ?? '')\n        : '';\n    const name = Obj.isObject(entity) && Obj.instanceOf(Operation.PersistentOperation, entity) ? entity.name : '';\n    return [typename, metaKey, uri, operationKey, name, getEntityId(entity)].some((value) => value.match(matcher));\n  };\n};\n\nconst getEntityId = (entity: Entity.Unknown): string => {\n  if (entity.id) {\n    return entity.id;\n  }\n  if (Type.isType(entity)) {\n    return Type.getURI(entity)?.toString() ?? Type.getTypename(entity) ?? 'unknown-type';\n  }\n  return Entity.getTypename(entity) ?? 'unknown';\n};\n\nconst getKind = (entity: Entity.Unknown): string => {\n  if (Type.isType(entity)) {\n    return 'type';\n  }\n  if (Obj.isObject(entity) && Obj.instanceOf(Operation.PersistentOperation, entity)) {\n    return 'operation';\n  }\n  return 'other';\n};\n\nconst getLabel = (entity: Entity.Unknown): string => {\n  if (Obj.isObject(entity) && Obj.instanceOf(Operation.PersistentOperation, entity)) {\n    return entity.name || Operation.getKey(entity) || getEntityId(entity);\n  }\n  if (Type.isType(entity)) {\n    return Type.getTypename(entity) ?? getEntityId(entity);\n  }\n  return getEntityId(entity);\n};\n\nconst toDetailJson = (entity: Entity.Unknown): object => {\n  if (Type.isType(entity)) {\n    return {\n      id: getEntityId(entity),\n      typename: Type.getTypename(entity),\n      uri: Type.getURI(entity)?.toString(),\n      version: Type.getVersion(entity),\n      jsonSchema: entity.jsonSchema,\n    };\n  }\n  if (Obj.isObject(entity)) {\n    return Obj.toJSON(entity);\n  }\n  return { id: getEntityId(entity), typename: Entity.getTypename(entity) };\n};\n\nexport const RegistryPanel = () => {\n  const client = useClient();\n  const [entities, setEntities] = useState<Entity.Unknown[]>([]);\n  const [filter, setFilter] = useState('');\n  const [selected, setSelected] = useState<Entity.Unknown>();\n\n  useEffect(() => {\n    const registry = client.graph.registry;\n    const refresh = () => setEntities([...registry.list()]);\n    refresh();\n    return registry.changed.on(refresh);\n  }, [client]);\n\n  const properties = useMemo(\n    () => [\n      { name: 'kind', format: Format.TypeFormat.String, size: 100 },\n      { name: 'label', format: Format.TypeFormat.String },\n      { name: 'id', format: Format.TypeFormat.String, size: 280 },\n    ],\n    [],\n  );\n\n  const rows = useMemo((): RegistryRow[] => {\n    return entities\n      .filter(textFilter(filter))\n      .map((entity) => ({\n        id: getEntityId(entity),\n        kind: getKind(entity),\n        label: getLabel(entity),\n        _entity: entity,\n      }))\n      .toSorted((left, right) => left.label.localeCompare(right.label));\n  }, [entities, filter]);\n\n  const handleRowClicked = useCallback((row: RegistryRow | undefined) => {\n    if (!row?._entity) {\n      return;\n    }\n    setSelected(row._entity);\n  }, []);\n\n  const detailJson = useMemo(() => (selected ? toDetailJson(selected) : undefined), [selected]);\n\n  const features: Partial<TableFeatures> = useMemo(() => ({ selection: { enabled: true, mode: 'single' } }), []);\n\n  return (\n    <Panel.Root>\n      <Panel.Toolbar asChild>\n        <Toolbar.Root>\n          <Searchbar placeholder='Filter...' onChange={setFilter} />\n        </Toolbar.Root>\n      </Panel.Toolbar>\n      <Panel.Content>\n        <div className={mx('h-full grid grid-cols-[2fr_1fr] overflow-hidden')}>\n          <div className={mx('flex flex-col min-h-0 overflow-hidden')}>\n            <DynamicTable properties={properties} rows={rows} features={features} onRowClick={handleRowClicked} />\n          </div>\n          <div className={mx('min-h-0 h-full overflow-auto border-s border-separator text-sm')}>\n            {detailJson ? <JsonView data={detailJson} /> : <Placeholder label='Details' />}\n          </div>\n        </div>\n      </Panel.Content>\n    </Panel.Root>\n  );\n};\n\nRegistryPanel.displayName = 'RegistryPanel';\n"],"mappings":"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"}