@dxos/plugin-graph 0.8.4-main.ead640a → 0.8.4-main.effb148878

package/LICENSE

@@ -1,8 +1,105 @@
-MIT License 
-Copyright (c) 2022 DXOS
+# Functional Source License, Version 1.1, ALv2 Future License
 
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+## Abbreviation
 
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+FSL-1.1-Apache-2.0
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+## Notice
+
+Copyright 2026 DXOS
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the Apache License, Version 2.0 that is effective on the second anniversary of
+the date we make the Software available. On or after that date, you may use the
+Software under the Apache License, Version 2.0, in which case the following
+will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

package/README.md

@@ -10,4 +10,4 @@
 
 Your ideas, issues, and code are most welcome. Please take a look at our [community code of conduct](https://github.com/dxos/dxos/blob/main/CODE_OF_CONDUCT.md), the [issue guide](https://github.com/dxos/dxos/blob/main/CONTRIBUTING.md#submitting-issues), and the [PR contribution guide](https://github.com/dxos/dxos/blob/main/CONTRIBUTING.md#submitting-prs).
 
-License: [MIT](./LICENSE) Copyright 2023 © DXOS
+License: [FSL-1.1-Apache-2.0](./LICENSE) Copyright 2023 © DXOS

package/dist/lib/neutral/GraphPlugin.mjs

@@ -0,0 +1,9 @@
+import {
+  GraphPlugin,
+  GraphPlugin_default
+} from "./chunk-S2DLYPRU.mjs";
+export {
+  GraphPlugin,
+  GraphPlugin_default as default
+};
+//# sourceMappingURL=GraphPlugin.mjs.map

package/dist/lib/neutral/GraphPlugin.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/lib/neutral/chunk-QECLJ7AR.mjs

@@ -0,0 +1,60 @@
+// src/hooks/useActionRunner.ts
+import { useCallback } from "react";
+import { useOperationInvoker, usePluginManager } from "@dxos/app-framework/ui";
+
+// src/action.ts
+import * as Effect from "effect/Effect";
+import * as Function from "effect/Function";
+import { Capability } from "@dxos/app-framework";
+import { Operation } from "@dxos/compute";
+import { runAndForwardErrors } from "@dxos/effect";
+var runAction = async (invoker, capabilityManager, action, params = {}) => runAndForwardErrors(action.data(params).pipe(Effect.provideService(Operation.Service, invoker), Effect.provideService(Capability.Service, capabilityManager), action._actionContext ? Effect.provide(action._actionContext) : Function.identity));
+
+// src/hooks/useActionRunner.ts
+var useActionRunner = () => {
+  const invoker = useOperationInvoker();
+  const pluginManager = usePluginManager();
+  return useCallback((action, params = {}) => runAction(invoker, pluginManager.capabilities, action, params), [
+    invoker,
+    pluginManager.capabilities
+  ]);
+};
+
+// src/hooks/useNode.ts
+import { useAtomValue } from "@effect-atom/atom-react";
+import * as Option from "effect/Option";
+import { useMemo } from "react";
+var useNode = (graph, id) => {
+  const atom = useMemo(() => graph.node(id ?? ""), [
+    graph,
+    id
+  ]);
+  return Option.getOrElse(useAtomValue(atom), () => void 0);
+};
+var useConnections = (graph, id, relation) => {
+  return useAtomValue(graph.connections(id ?? "", relation));
+};
+var useActions = (graph, id) => {
+  const atom = useMemo(() => graph.actions(id ?? ""), [
+    graph,
+    id
+  ]);
+  return useAtomValue(atom);
+};
+var useEdges = (graph, id) => {
+  const atom = useMemo(() => graph.edges(id ?? ""), [
+    graph,
+    id
+  ]);
+  return useAtomValue(atom);
+};
+
+export {
+  runAction,
+  useActionRunner,
+  useNode,
+  useConnections,
+  useActions,
+  useEdges
+};
+//# sourceMappingURL=chunk-QECLJ7AR.mjs.map

package/dist/lib/neutral/chunk-QECLJ7AR.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/hooks/useActionRunner.ts", "../../../src/action.ts", "../../../src/hooks/useNode.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { useCallback } from 'react';\n\nimport { useOperationInvoker, usePluginManager } from '@dxos/app-framework/ui';\nimport { type Node } from '@dxos/app-graph';\n\nimport { runAction } from '../action';\n\n/**\n * Hook that returns a function to run action Effects.\n * Provides Operation.Service, PluginContextService, and captured plugin context.\n */\nexport const useActionRunner = () => {\n  const invoker = useOperationInvoker();\n  const pluginManager = usePluginManager();\n\n  return useCallback(\n    (action: Node.Action, params: Node.InvokeProps = {}) =>\n      runAction(invoker, pluginManager.capabilities, action, params),\n    [invoker, pluginManager.capabilities],\n  );\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Function from 'effect/Function';\n\nimport { Capability, type CapabilityManager } from '@dxos/app-framework';\nimport { type Node } from '@dxos/app-graph';\nimport { Operation } from '@dxos/compute';\nimport { runAndForwardErrors } from '@dxos/effect';\n\n/**\n * Run an action with required layers: Operation.Service, Capability.Service, and captured context.\n * @param invoker The operation invoker to use for Operation.Service.\n * @param capabilityManager The capability manager for Capability.Service.\n * @param action The action to execute.\n * @param params Parameters to pass to the action.\n */\nexport const runAction = async (\n  invoker: Operation.OperationService,\n  capabilityManager: CapabilityManager.CapabilityManager,\n  action: Node.Action,\n  params: Node.InvokeProps = {},\n): Promise<void> =>\n  runAndForwardErrors(\n    action\n      .data(params)\n      .pipe(\n        Effect.provideService(Operation.Service, invoker),\n        Effect.provideService(Capability.Service, capabilityManager),\n        action._actionContext ? Effect.provide(action._actionContext) : Function.identity,\n      ),\n  );\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { useAtomValue } from '@effect-atom/atom-react';\nimport * as Option from 'effect/Option';\nimport { useMemo } from 'react';\n\nimport { type Graph, type Node } from '@dxos/app-graph';\n\n/**\n * React hook to get a node from the graph.\n *\n * @param graph Graph to find the node in.\n * @param id Id of the node to find.\n * @param timeout Optional timeout in milliseconds to wait for the node to be found.\n * @returns Node if found, undefined otherwise.\n */\n// TODO(wittjosiah): Factor out to @dxos/app-graph/react.\nexport const useNode = <T = any>(graph: Graph.ReadableGraph, id?: string): Node.Node<T> | undefined => {\n  const atom = useMemo(() => graph.node(id ?? ''), [graph, id]);\n  return Option.getOrElse(useAtomValue(atom), () => undefined);\n};\n\nexport const useConnections = (\n  graph: Graph.ReadableGraph,\n  id: string | undefined,\n  relation: Node.RelationInput,\n): Node.Node[] => {\n  return useAtomValue(graph.connections(id ?? '', relation));\n};\n\n/**\n * React hook to get actions available for a node.\n *\n * @param graph Graph containing the node.\n * @param id Id of the node.\n * @returns Actions available for the node.\n */\nexport const useActions = (graph: Graph.ReadableGraph, id?: string): Node.Node[] => {\n  const atom = useMemo(() => graph.actions(id ?? ''), [graph, id]);\n  return useAtomValue(atom);\n};\n\n/**\n * Subscribe to just the edge topology (inbound/outbound IDs) of a node without subscribing to node content.\n *\n * @param graph Graph containing the node.\n * @param id Id of the node.\n * @returns Edge topology for the node.\n */\nexport const useEdges = (graph: Graph.ReadableGraph, id?: string): Graph.Edges => {\n  const atom = useMemo(() => graph.edges(id ?? ''), [graph, id]);\n  return useAtomValue(atom);\n};\n"],
+  "mappings": ";AAIA,SAASA,mBAAmB;AAE5B,SAASC,qBAAqBC,wBAAwB;;;ACFtD,YAAYC,YAAY;AACxB,YAAYC,cAAc;AAE1B,SAASC,kBAA0C;AAEnD,SAASC,iBAAiB;AAC1B,SAASC,2BAA2B;AAS7B,IAAMC,YAAY,OACvBC,SACAC,mBACAC,QACAC,SAA2B,CAAC,MAE5BL,oBACEI,OACGE,KAAKD,MAAAA,EACLE,KACQC,sBAAeT,UAAUU,SAASP,OAAAA,GAClCM,sBAAeV,WAAWW,SAASN,iBAAAA,GAC1CC,OAAOM,iBAAwBC,eAAQP,OAAOM,cAAc,IAAaE,iBAAQ,CAAA;;;ADhBlF,IAAMC,kBAAkB,MAAA;AAC7B,QAAMC,UAAUC,oBAAAA;AAChB,QAAMC,gBAAgBC,iBAAAA;AAEtB,SAAOC,YACL,CAACC,QAAqBC,SAA2B,CAAC,MAChDC,UAAUP,SAASE,cAAcM,cAAcH,QAAQC,MAAAA,GACzD;IAACN;IAASE,cAAcM;GAAa;AAEzC;;;AEpBA,SAASC,oBAAoB;AAC7B,YAAYC,YAAY;AACxB,SAASC,eAAe;AAajB,IAAMC,UAAU,CAAUC,OAA4BC,OAAAA;AAC3D,QAAMC,OAAOJ,QAAQ,MAAME,MAAMG,KAAKF,MAAM,EAAA,GAAK;IAACD;IAAOC;GAAG;AAC5D,SAAcG,iBAAUR,aAAaM,IAAAA,GAAO,MAAMG,MAAAA;AACpD;AAEO,IAAMC,iBAAiB,CAC5BN,OACAC,IACAM,aAAAA;AAEA,SAAOX,aAAaI,MAAMQ,YAAYP,MAAM,IAAIM,QAAAA,CAAAA;AAClD;AASO,IAAME,aAAa,CAACT,OAA4BC,OAAAA;AACrD,QAAMC,OAAOJ,QAAQ,MAAME,MAAMU,QAAQT,MAAM,EAAA,GAAK;IAACD;IAAOC;GAAG;AAC/D,SAAOL,aAAaM,IAAAA;AACtB;AASO,IAAMS,WAAW,CAACX,OAA4BC,OAAAA;AACnD,QAAMC,OAAOJ,QAAQ,MAAME,MAAMY,MAAMX,MAAM,EAAA,GAAK;IAACD;IAAOC;GAAG;AAC7D,SAAOL,aAAaM,IAAAA;AACtB;",
+  "names": ["useCallback", "useOperationInvoker", "usePluginManager", "Effect", "Function", "Capability", "Operation", "runAndForwardErrors", "runAction", "invoker", "capabilityManager", "action", "params", "data", "pipe", "provideService", "Service", "_actionContext", "provide", "identity", "useActionRunner", "invoker", "useOperationInvoker", "pluginManager", "usePluginManager", "useCallback", "action", "params", "runAction", "capabilities", "useAtomValue", "Option", "useMemo", "useNode", "graph", "id", "atom", "node", "getOrElse", "undefined", "useConnections", "relation", "connections", "useActions", "actions", "useEdges", "edges"]
+}

package/dist/lib/neutral/chunk-S2DLYPRU.mjs

@@ -0,0 +1,22 @@
+// src/GraphPlugin.ts
+import { ActivationEvents, Capability, Plugin } from "@dxos/app-framework";
+import { AppActivationEvents } from "@dxos/app-toolkit";
+import { meta } from "#meta";
+var Graph = Capability.lazy("Graph", () => import("./graph-RCKCHDM6.mjs"));
+var GraphPlugin = Plugin.define(meta).pipe(Plugin.addModule({
+  activatesOn: ActivationEvents.Startup,
+  firesBeforeActivation: [
+    AppActivationEvents.SetupAppGraph
+  ],
+  firesAfterActivation: [
+    AppActivationEvents.AppGraphReady
+  ],
+  activate: Graph
+}), Plugin.make);
+var GraphPlugin_default = GraphPlugin;
+
+export {
+  GraphPlugin,
+  GraphPlugin_default
+};
+//# sourceMappingURL=chunk-S2DLYPRU.mjs.map

package/dist/lib/neutral/chunk-S2DLYPRU.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/GraphPlugin.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { ActivationEvents, Capability, Plugin } from '@dxos/app-framework';\nimport { AppActivationEvents } from '@dxos/app-toolkit';\n\nimport { meta } from '#meta';\n\nconst Graph = Capability.lazy('Graph', () => import('./graph'));\n\n/**\n * Manages the state of the graph for the application.\n * Enables other plugins to register node builders to add nodes to the graph.\n * This includes actions and annotation each other's nodes.\n */\nexport const GraphPlugin = Plugin.define(meta).pipe(\n  Plugin.addModule({\n    activatesOn: ActivationEvents.Startup,\n    firesBeforeActivation: [AppActivationEvents.SetupAppGraph],\n    firesAfterActivation: [AppActivationEvents.AppGraphReady],\n    activate: Graph,\n  }),\n  Plugin.make,\n);\n\nexport default GraphPlugin;\n"],
+  "mappings": ";AAIA,SAASA,kBAAkBC,YAAYC,cAAc;AACrD,SAASC,2BAA2B;AAEpC,SAASC,YAAY;AAErB,IAAMC,QAAQJ,WAAWK,KAAK,SAAS,MAAM,OAAO,sBAAA,CAAA;AAO7C,IAAMC,cAAcL,OAAOM,OAAOJ,IAAAA,EAAMK,KAC7CP,OAAOQ,UAAU;EACfC,aAAaX,iBAAiBY;EAC9BC,uBAAuB;IAACV,oBAAoBW;;EAC5CC,sBAAsB;IAACZ,oBAAoBa;;EAC3CC,UAAUZ;AACZ,CAAA,GACAH,OAAOgB,IAAI;AAGb,IAAA,sBAAeX;",
+  "names": ["ActivationEvents", "Capability", "Plugin", "AppActivationEvents", "meta", "Graph", "lazy", "GraphPlugin", "define", "pipe", "addModule", "activatesOn", "Startup", "firesBeforeActivation", "SetupAppGraph", "firesAfterActivation", "AppGraphReady", "activate", "make"]
+}

package/dist/lib/neutral/chunk-Y5TMPZGE.mjs

@@ -0,0 +1,19 @@
+// src/meta.ts
+import { trim } from "@dxos/util";
+var meta = {
+  id: "org.dxos.plugin.graph",
+  name: "Graph",
+  author: "DXOS",
+  description: trim`
+    Graph database layer providing relationship modeling and queries for workspace objects.
+    Build knowledge graphs and explore complex data relationships.
+  `,
+  tags: [
+    "system"
+  ]
+};
+
+export {
+  meta
+};
+//# sourceMappingURL=chunk-Y5TMPZGE.mjs.map

package/dist/lib/neutral/chunk-Y5TMPZGE.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/meta.ts"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Plugin } from '@dxos/app-framework';\nimport { trim } from '@dxos/util';\n\nexport const meta: Plugin.Meta = {\n  id: 'org.dxos.plugin.graph',\n  name: 'Graph',\n  author: 'DXOS',\n  description: trim`\n    Graph database layer providing relationship modeling and queries for workspace objects.\n    Build knowledge graphs and explore complex data relationships.\n  `,\n  tags: ['system'],\n};\n"],
+  "mappings": ";AAKA,SAASA,YAAY;AAEd,IAAMC,OAAoB;EAC/BC,IAAI;EACJC,MAAM;EACNC,QAAQ;EACRC,aAAaL;;;;EAIbM,MAAM;IAAC;;AACT;",
+  "names": ["trim", "meta", "id", "name", "author", "description", "tags"]
+}

package/dist/lib/neutral/graph-RCKCHDM6.mjs

@@ -0,0 +1,48 @@
+// src/graph.ts
+import * as Effect from "effect/Effect";
+import * as Record from "effect/Record";
+import { Capabilities, Capability } from "@dxos/app-framework";
+import { Graph, GraphBuilder, Node } from "@dxos/app-graph";
+import { AppCapabilities } from "@dxos/app-toolkit";
+var graph_default = Capability.makeModule(Effect.fnUntraced(function* () {
+  const registry = yield* Capability.get(Capabilities.AtomRegistry);
+  const extensionsByModuleAtom = yield* Capability.atomByModule(AppCapabilities.AppGraphBuilder);
+  const builder = GraphBuilder.from(
+    /* localStorage.getItem(KEY) ?? */
+    void 0,
+    registry
+  );
+  const unsubscribe = registry.subscribe(extensionsByModuleAtom, (extensionsByModule) => {
+    const next = [];
+    for (const [moduleId, extensions] of Object.entries(extensionsByModule)) {
+      for (const ext of GraphBuilder.flattenExtensions(extensions)) {
+        next.push({
+          ...ext,
+          id: `${moduleId}.${ext.id}`
+        });
+      }
+    }
+    const current = Record.values(registry.get(builder.extensions));
+    const removed = current.filter(({ id }) => !next.some(({ id: nextId }) => nextId === id));
+    removed.forEach((extension) => GraphBuilder.removeExtension(builder, extension.id));
+    next.forEach((extension) => GraphBuilder.addExtension(builder, extension));
+  }, {
+    immediate: true
+  });
+  void Graph.expand(builder.graph, Node.RootId, "child");
+  setupDevtools(builder.graph);
+  return Capability.contributes(AppCapabilities.AppGraph, {
+    graph: builder.graph,
+    explore: GraphBuilder.explore
+  }, () => Effect.sync(() => {
+    unsubscribe();
+  }));
+}));
+var setupDevtools = (graph) => {
+  globalThis.composer ??= {};
+  globalThis.composer.graph = graph;
+};
+export {
+  graph_default as default
+};
+//# sourceMappingURL=graph-RCKCHDM6.mjs.map

package/dist/lib/neutral/graph-RCKCHDM6.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/graph.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Record from 'effect/Record';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport { Graph, GraphBuilder, Node } from '@dxos/app-graph';\nimport { AppCapabilities } from '@dxos/app-toolkit';\n\n// TODO(wittjosiah): Remove or restore graph caching.\n// import { meta } from './meta';\n\n// const KEY = `${meta.id}.app-graph`;\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    const registry = yield* Capability.get(Capabilities.AtomRegistry);\n    const extensionsByModuleAtom = yield* Capability.atomByModule(AppCapabilities.AppGraphBuilder);\n\n    const builder = GraphBuilder.from(/* localStorage.getItem(KEY) ?? */ undefined, registry);\n    // const interval = setInterval(() => {\n    //   localStorage.setItem(KEY, builder.graph.pickle());\n    // }, 5_000);\n\n    const unsubscribe = registry.subscribe(\n      extensionsByModuleAtom,\n      (extensionsByModule) => {\n        const next: GraphBuilder.BuilderExtension[] = [];\n        for (const [moduleId, extensions] of Object.entries(extensionsByModule)) {\n          for (const ext of GraphBuilder.flattenExtensions(extensions)) {\n            next.push({ ...ext, id: `${moduleId}.${ext.id}` });\n          }\n        }\n        const current = Record.values(registry.get(builder.extensions));\n        const removed = current.filter(({ id }) => !next.some(({ id: nextId }) => nextId === id));\n        removed.forEach((extension) => GraphBuilder.removeExtension(builder, extension.id));\n        next.forEach((extension) => GraphBuilder.addExtension(builder, extension));\n      },\n      { immediate: true },\n    );\n\n    // await builder.initialize();\n    void Graph.expand(builder.graph, Node.RootId, 'child');\n\n    setupDevtools(builder.graph);\n\n    return Capability.contributes(\n      AppCapabilities.AppGraph,\n      { graph: builder.graph, explore: GraphBuilder.explore },\n      () =>\n        Effect.sync(() => {\n          // clearInterval(interval);\n          unsubscribe();\n        }),\n    );\n  }),\n);\n\n// Expose the graph to the window for debugging.\nconst setupDevtools = (graph: Graph.ExpandableGraph) => {\n  (globalThis as any).composer ??= {};\n  (globalThis as any).composer.graph = graph;\n};\n"],
+  "mappings": ";AAIA,YAAYA,YAAY;AACxB,YAAYC,YAAY;AAExB,SAASC,cAAcC,kBAAkB;AACzC,SAASC,OAAOC,cAAcC,YAAY;AAC1C,SAASC,uBAAuB;AAOhC,IAAA,gBAAeJ,WAAWK,WACjBC,kBAAW,aAAA;AAChB,QAAMC,WAAW,OAAOP,WAAWQ,IAAIT,aAAaU,YAAY;AAChE,QAAMC,yBAAyB,OAAOV,WAAWW,aAAaP,gBAAgBQ,eAAe;AAE7F,QAAMC,UAAUX,aAAaY;;IAAwCC;IAAWR;EAAAA;AAKhF,QAAMS,cAAcT,SAASU,UAC3BP,wBACA,CAACQ,uBAAAA;AACC,UAAMC,OAAwC,CAAA;AAC9C,eAAW,CAACC,UAAUC,UAAAA,KAAeC,OAAOC,QAAQL,kBAAAA,GAAqB;AACvE,iBAAWM,OAAOtB,aAAauB,kBAAkBJ,UAAAA,GAAa;AAC5DF,aAAKO,KAAK;UAAE,GAAGF;UAAKG,IAAI,GAAGP,QAAAA,IAAYI,IAAIG,EAAE;QAAG,CAAA;MAClD;IACF;AACA,UAAMC,UAAiBC,cAAOtB,SAASC,IAAIK,QAAQQ,UAAU,CAAA;AAC7D,UAAMS,UAAUF,QAAQG,OAAO,CAAC,EAAEJ,GAAE,MAAO,CAACR,KAAKa,KAAK,CAAC,EAAEL,IAAIM,OAAM,MAAOA,WAAWN,EAAAA,CAAAA;AACrFG,YAAQI,QAAQ,CAACC,cAAcjC,aAAakC,gBAAgBvB,SAASsB,UAAUR,EAAE,CAAA;AACjFR,SAAKe,QAAQ,CAACC,cAAcjC,aAAamC,aAAaxB,SAASsB,SAAAA,CAAAA;EACjE,GACA;IAAEG,WAAW;EAAK,CAAA;AAIpB,OAAKrC,MAAMsC,OAAO1B,QAAQ2B,OAAOrC,KAAKsC,QAAQ,OAAA;AAE9CC,gBAAc7B,QAAQ2B,KAAK;AAE3B,SAAOxC,WAAW2C,YAChBvC,gBAAgBwC,UAChB;IAAEJ,OAAO3B,QAAQ2B;IAAOK,SAAS3C,aAAa2C;EAAQ,GACtD,MACSC,YAAK,MAAA;AAEV9B,gBAAAA;EACF,CAAA,CAAA;AAEN,CAAA,CAAA;AAIF,IAAM0B,gBAAgB,CAACF,UAAAA;AACpBO,aAAmBC,aAAa,CAAC;AACjCD,aAAmBC,SAASR,QAAQA;AACvC;",
+  "names": ["Effect", "Record", "Capabilities", "Capability", "Graph", "GraphBuilder", "Node", "AppCapabilities", "makeModule", "fnUntraced", "registry", "get", "AtomRegistry", "extensionsByModuleAtom", "atomByModule", "AppGraphBuilder", "builder", "from", "undefined", "unsubscribe", "subscribe", "extensionsByModule", "next", "moduleId", "extensions", "Object", "entries", "ext", "flattenExtensions", "push", "id", "current", "values", "removed", "filter", "some", "nextId", "forEach", "extension", "removeExtension", "addExtension", "immediate", "expand", "graph", "RootId", "setupDevtools", "contributes", "AppGraph", "explore", "sync", "globalThis", "composer"]
+}

package/dist/lib/neutral/hooks/index.mjs

@@ -0,0 +1,15 @@
+import {
+  useActionRunner,
+  useActions,
+  useConnections,
+  useEdges,
+  useNode
+} from "../chunk-QECLJ7AR.mjs";
+export {
+  useActionRunner,
+  useActions,
+  useConnections,
+  useEdges,
+  useNode
+};
+//# sourceMappingURL=index.mjs.map

package/dist/lib/neutral/hooks/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/lib/neutral/index.mjs

@@ -0,0 +1,24 @@
+import {
+  runAction,
+  useActionRunner,
+  useActions,
+  useConnections,
+  useEdges,
+  useNode
+} from "./chunk-QECLJ7AR.mjs";
+import {
+  meta
+} from "./chunk-Y5TMPZGE.mjs";
+
+// src/index.ts
+export * from "@dxos/app-graph";
+export {
+  meta,
+  runAction,
+  useActionRunner,
+  useActions,
+  useConnections,
+  useEdges,
+  useNode
+};
+//# sourceMappingURL=index.mjs.map

package/dist/lib/neutral/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/index.ts"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nexport * from './meta';\n\nexport * from '@dxos/app-graph';\n\nexport * from './action';\n// TODO(wittjosiah): Hooks should not be exported from the plugin package at all.\n//   Either refactor callers to not need them or factor them out to a shared package.\nexport * from './hooks';\n"],
+  "mappings": ";;;;;;;;;;;;;AAMA,cAAc;",
+  "names": []
+}

package/dist/lib/neutral/meta.json

@@ -0,0 +1 @@
+{"inputs":{"src/meta.ts":{"bytes":1462,"imports":[{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"src/action.ts":{"bytes":3592,"imports":[{"path":"effect/Effect","kind":"import-statement","external":true},{"path":"effect/Function","kind":"import-statement","external":true},{"path":"@dxos/app-framework","kind":"import-statement","external":true},{"path":"@dxos/compute","kind":"import-statement","external":true},{"path":"@dxos/effect","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useActionRunner.ts":{"bytes":2430,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/app-framework/ui","kind":"import-statement","external":true},{"path":"src/action.ts","kind":"import-statement","original":"../action"}],"format":"esm"},"src/hooks/useNode.ts":{"bytes":5318,"imports":[{"path":"@effect-atom/atom-react","kind":"import-statement","external":true},{"path":"effect/Option","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/index.ts":{"bytes":482,"imports":[{"path":"src/hooks/useActionRunner.ts","kind":"import-statement","original":"./useActionRunner"},{"path":"src/hooks/useNode.ts","kind":"import-statement","original":"./useNode"}],"format":"esm"},"src/index.ts":{"bytes":1068,"imports":[{"path":"src/meta.ts","kind":"import-statement","original":"./meta"},{"path":"@dxos/app-graph","kind":"import-statement","external":true},{"path":"src/action.ts","kind":"import-statement","original":"./action"},{"path":"src/hooks/index.ts","kind":"import-statement","original":"./hooks"}],"format":"esm"},"src/graph.ts":{"bytes":8304,"imports":[{"path":"effect/Effect","kind":"import-statement","external":true},{"path":"effect/Record","kind":"import-statement","external":true},{"path":"@dxos/app-framework","kind":"import-statement","external":true},{"path":"@dxos/app-graph","kind":"import-statement","external":true},{"path":"@dxos/app-toolkit","kind":"import-statement","external":true}],"format":"esm"},"src/GraphPlugin.ts":{"bytes":2966,"imports":[{"path":"@dxos/app-framework","kind":"import-statement","external":true},{"path":"@dxos/app-toolkit","kind":"import-statement","external":true},{"path":"#meta","kind":"import-statement","external":true},{"path":"src/graph.ts","kind":"dynamic-import","original":"./graph"}],"format":"esm"},"src/plugin.ts":{"bytes":850,"imports":[{"path":"@dxos/app-framework","kind":"import-statement","external":true},{"path":"src/meta.ts","kind":"import-statement","original":"./meta"},{"path":"#plugin","kind":"dynamic-import","external":true}],"format":"esm"},"src/testing.ts":{"bytes":653,"imports":[{"path":"src/GraphPlugin.ts","kind":"import-statement","original":"./GraphPlugin"}],"format":"esm"}},"outputs":{"dist/lib/neutral/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":465},"dist/lib/neutral/index.mjs":{"imports":[{"path":"dist/lib/neutral/chunk-QECLJ7AR.mjs","kind":"import-statement"},{"path":"dist/lib/neutral/chunk-Y5TMPZGE.mjs","kind":"import-statement"},{"path":"@dxos/app-graph","kind":"import-statement","external":true}],"exports":["meta","runAction","useActionRunner","useActions","useConnections","useEdges","useNode"],"entryPoint":"src/index.ts","inputs":{"src/index.ts":{"bytesInOutput":33}},"bytes":364},"dist/lib/neutral/GraphPlugin.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":93},"dist/lib/neutral/GraphPlugin.mjs":{"imports":[{"path":"dist/lib/neutral/chunk-S2DLYPRU.mjs","kind":"import-statement"}],"exports":["GraphPlugin","default"],"entryPoint":"src/GraphPlugin.ts","inputs":{},"bytes":178},"dist/lib/neutral/hooks/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":93},"dist/lib/neutral/hooks/index.mjs":{"imports":[{"path":"dist/lib/neutral/chunk-QECLJ7AR.mjs","kind":"import-statement"}],"exports":["useActionRunner","useActions","useConnections","useEdges","useNode"],"entryPoint":"src/hooks/index.ts","inputs":{},"bytes":234},"dist/lib/neutral/chunk-QECLJ7AR.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":5757},"dist/lib/neutral/chunk-QECLJ7AR.mjs":{"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/app-framework/ui","kind":"import-statement","external":true},{"path":"effect/Effect","kind":"import-statement","external":true},{"path":"effect/Function","kind":"import-statement","external":true},{"path":"@dxos/app-framework","kind":"import-statement","external":true},{"path":"@dxos/compute","kind":"import-statement","external":true},{"path":"@dxos/effect","kind":"import-statement","external":true},{"path":"@effect-atom/atom-react","kind":"import-statement","external":true},{"path":"effect/Option","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true}],"exports":["runAction","useActionRunner","useActions","useConnections","useEdges","useNode"],"inputs":{"src/hooks/useActionRunner.ts":{"bytesInOutput":397},"src/action.ts":{"bytesInOutput":549},"src/hooks/index.ts":{"bytesInOutput":0},"src/hooks/useNode.ts":{"bytesInOutput":703}},"bytes":1900},"dist/lib/neutral/meta.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":93},"dist/lib/neutral/meta.mjs":{"imports":[{"path":"dist/lib/neutral/chunk-Y5TMPZGE.mjs","kind":"import-statement"}],"exports":["meta"],"entryPoint":"src/meta.ts","inputs":{},"bytes":100},"dist/lib/neutral/plugin.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":437},"dist/lib/neutral/plugin.mjs":{"imports":[{"path":"dist/lib/neutral/chunk-Y5TMPZGE.mjs","kind":"import-statement"},{"path":"@dxos/app-framework","kind":"import-statement","external":true},{"path":"#plugin","kind":"dynamic-import","external":true}],"exports":["GraphPlugin"],"entryPoint":"src/plugin.ts","inputs":{"src/plugin.ts":{"bytesInOutput":108}},"bytes":235},"dist/lib/neutral/chunk-Y5TMPZGE.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":730},"dist/lib/neutral/chunk-Y5TMPZGE.mjs":{"imports":[{"path":"@dxos/util","kind":"import-statement","external":true}],"exports":["meta"],"inputs":{"src/meta.ts":{"bytesInOutput":329}},"bytes":408},"dist/lib/neutral/testing.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":93},"dist/lib/neutral/testing.mjs":{"imports":[{"path":"dist/lib/neutral/chunk-S2DLYPRU.mjs","kind":"import-statement"}],"exports":["GraphPlugin"],"entryPoint":"src/testing.ts","inputs":{"src/testing.ts":{"bytesInOutput":0}},"bytes":117},"dist/lib/neutral/chunk-S2DLYPRU.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":1518},"dist/lib/neutral/chunk-S2DLYPRU.mjs":{"imports":[{"path":"@dxos/app-framework","kind":"import-statement","external":true},{"path":"@dxos/app-toolkit","kind":"import-statement","external":true},{"path":"#meta","kind":"import-statement","external":true},{"path":"dist/lib/neutral/graph-RCKCHDM6.mjs","kind":"dynamic-import"}],"exports":["GraphPlugin","GraphPlugin_default"],"inputs":{"src/GraphPlugin.ts":{"bytesInOutput":556}},"bytes":672},"dist/lib/neutral/graph-RCKCHDM6.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":4327},"dist/lib/neutral/graph-RCKCHDM6.mjs":{"imports":[{"path":"effect/Effect","kind":"import-statement","external":true},{"path":"effect/Record","kind":"import-statement","external":true},{"path":"@dxos/app-framework","kind":"import-statement","external":true},{"path":"@dxos/app-graph","kind":"import-statement","external":true},{"path":"@dxos/app-toolkit","kind":"import-statement","external":true}],"exports":["default"],"entryPoint":"src/graph.ts","inputs":{"src/graph.ts":{"bytesInOutput":1712}},"bytes":1811}}}

package/dist/lib/neutral/meta.mjs

@@ -0,0 +1,7 @@
+import {
+  meta
+} from "./chunk-Y5TMPZGE.mjs";
+export {
+  meta
+};
+//# sourceMappingURL=meta.mjs.map

package/dist/lib/neutral/meta.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/lib/neutral/plugin.mjs

@@ -0,0 +1,11 @@
+import {
+  meta
+} from "./chunk-Y5TMPZGE.mjs";
+
+// src/plugin.ts
+import { Plugin } from "@dxos/app-framework";
+var GraphPlugin = Plugin.lazy(meta, () => import("#plugin"));
+export {
+  GraphPlugin
+};
+//# sourceMappingURL=plugin.mjs.map

package/dist/lib/neutral/plugin.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/plugin.ts"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\n\nimport { meta } from './meta';\n\nexport const GraphPlugin = Plugin.lazy(meta, () => import('#plugin'));\n"],
+  "mappings": ";;;;;AAIA,SAASA,cAAc;AAIhB,IAAMC,cAAcC,OAAOC,KAAKC,MAAM,MAAM,OAAO,SAAA,CAAA;",
+  "names": ["Plugin", "GraphPlugin", "Plugin", "lazy", "meta"]
+}

package/dist/lib/neutral/testing.mjs

@@ -0,0 +1,7 @@
+import {
+  GraphPlugin
+} from "./chunk-S2DLYPRU.mjs";
+export {
+  GraphPlugin
+};
+//# sourceMappingURL=testing.mjs.map

package/dist/lib/neutral/testing.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

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

@@ -1,7 +1,9 @@
+import { Plugin } from '@dxos/app-framework';
 /**
  * Manages the state of the graph for the application.
  * Enables other plugins to register node builders to add nodes to the graph.
  * This includes actions and annotation each other's nodes.
  */
-export declare const GraphPlugin: import("@dxos/app-framework").PluginFactory<void>;
+export declare const GraphPlugin: Plugin.PluginFactory<void>;
+export default GraphPlugin;
 //# sourceMappingURL=GraphPlugin.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"GraphPlugin.d.ts","sourceRoot":"","sources":["../../../src/GraphPlugin.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,eAAO,MAAM,WAAW,mDAQtB,CAAC"}
+{"version":3,"file":"GraphPlugin.d.ts","sourceRoot":"","sources":["../../../src/GraphPlugin.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgC,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAO3E;;;;GAIG;AACH,eAAO,MAAM,WAAW,4BAQvB,CAAC;eAEa,WAAW"}

package/dist/types/src/GraphPlugin.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=GraphPlugin.test.d.ts.map

package/dist/types/src/GraphPlugin.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphPlugin.test.d.ts","sourceRoot":"","sources":["../../../src/GraphPlugin.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,12 @@
+import { type CapabilityManager } from '@dxos/app-framework';
+import { type Node } from '@dxos/app-graph';
+import { Operation } from '@dxos/compute';
+/**
+ * Run an action with required layers: Operation.Service, Capability.Service, and captured context.
+ * @param invoker The operation invoker to use for Operation.Service.
+ * @param capabilityManager The capability manager for Capability.Service.
+ * @param action The action to execute.
+ * @param params Parameters to pass to the action.
+ */
+export declare const runAction: (invoker: Operation.OperationService, capabilityManager: CapabilityManager.CapabilityManager, action: Node.Action, params?: Node.InvokeProps) => Promise<void>;
+//# sourceMappingURL=action.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/action.ts"],"names":[],"mappings":"AAOA,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG1C;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,YACX,SAAS,CAAC,gBAAgB,qBAChB,iBAAiB,CAAC,iBAAiB,UAC9C,IAAI,CAAC,MAAM,WACX,IAAI,CAAC,WAAW,KACvB,OAAO,CAAC,IAAI,CASZ,CAAC"}

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

@@ -1,5 +1,9 @@
-import { type PluginContext } from '@dxos/app-framework';
-import { GraphBuilder } from '@dxos/app-graph';
-declare const _default: (context: PluginContext) => Promise<import("@dxos/app-framework").Capability<import("@dxos/app-framework").InterfaceDef<Readonly<Pick<GraphBuilder, "graph" | "explore">>>>>;
+import * as Effect from 'effect/Effect';
+import { Capability } from '@dxos/app-framework';
+import { Graph, GraphBuilder } from '@dxos/app-graph';
+declare const _default: (props: void) => Effect.Effect<Capability.Capability<Capability.InterfaceDef<Readonly<{
+    graph: Graph.ExpandableGraph;
+    explore: typeof GraphBuilder.explore;
+}>>>, Error, Capability.Service>;
 export default _default;
 //# sourceMappingURL=graph.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/graph.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,KAAK,aAAa,EAAe,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAwB,YAAY,EAA8B,MAAM,iBAAiB,CAAC;yBAO3E,SAAS,aAAa;AAA5C,wBA4BE"}
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/graph.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAgB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,YAAY,EAAQ,MAAM,iBAAiB,CAAC"}

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

@@ -1,2 +1,3 @@
+export * from './useActionRunner';
 export * from './useNode';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":"AAIA,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC"}

package/dist/types/src/hooks/useActionRunner.d.ts

@@ -0,0 +1,7 @@
+import { type Node } from '@dxos/app-graph';
+/**
+ * Hook that returns a function to run action Effects.
+ * Provides Operation.Service, PluginContextService, and captured plugin context.
+ */
+export declare const useActionRunner: () => (action: Node.Action, params?: Node.InvokeProps) => Promise<void>;
+//# sourceMappingURL=useActionRunner.d.ts.map

package/dist/types/src/hooks/useActionRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActionRunner.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useActionRunner.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAI5C;;;GAGG;AACH,eAAO,MAAM,eAAe,iBAKf,IAAI,CAAC,MAAM,WAAU,IAAI,CAAC,WAAW,kBAIjD,CAAC"}

package/dist/types/src/hooks/useNode.d.ts

@@ -1,4 +1,4 @@
-import { type Node, type ReadableGraph, type Relation } from '@dxos/app-graph';
+import { type Graph, type Node } from '@dxos/app-graph';
 /**
  * React hook to get a node from the graph.
  *
@@ -7,7 +7,22 @@ import { type Node, type ReadableGraph, type Relation } from '@dxos/app-graph';
  * @param timeout Optional timeout in milliseconds to wait for the node to be found.
  * @returns Node if found, undefined otherwise.
  */
-export declare const useNode: <T = any>(graph: ReadableGraph, id?: string) => Node<T> | undefined;
-export declare const useConnections: (graph: ReadableGraph, id?: string, relation?: Relation) => Node[];
-export declare const useActions: (graph: ReadableGraph, id?: string) => Node[];
+export declare const useNode: <T = any>(graph: Graph.ReadableGraph, id?: string) => Node.Node<T> | undefined;
+export declare const useConnections: (graph: Graph.ReadableGraph, id: string | undefined, relation: Node.RelationInput) => Node.Node[];
+/**
+ * React hook to get actions available for a node.
+ *
+ * @param graph Graph containing the node.
+ * @param id Id of the node.
+ * @returns Actions available for the node.
+ */
+export declare const useActions: (graph: Graph.ReadableGraph, id?: string) => Node.Node[];
+/**
+ * Subscribe to just the edge topology (inbound/outbound IDs) of a node without subscribing to node content.
+ *
+ * @param graph Graph containing the node.
+ * @param id Id of the node.
+ * @returns Edge topology for the node.
+ */
+export declare const useEdges: (graph: Graph.ReadableGraph, id?: string) => Graph.Edges;
 //# sourceMappingURL=useNode.d.ts.map

package/dist/types/src/hooks/useNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useNode.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useNode.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE/E;;;;;;;GAOG;AAEH,eAAO,MAAM,OAAO,GAAI,CAAC,GAAG,GAAG,EAAE,OAAO,aAAa,EAAE,KAAK,MAAM,KAAG,IAAI,CAAC,CAAC,CAAC,GAAG,SAE9E,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,OAAO,aAAa,EAAE,KAAK,MAAM,EAAE,WAAW,QAAQ,KAAG,IAAI,EAE3F,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,OAAO,aAAa,EAAE,KAAK,MAAM,KAAG,IAAI,EAElE,CAAC"}
+{"version":3,"file":"useNode.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useNode.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAExD;;;;;;;GAOG;AAEH,eAAO,MAAM,OAAO,GAAI,CAAC,GAAG,GAAG,SAAS,KAAK,CAAC,aAAa,OAAO,MAAM,KAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,SAGzF,CAAC;AAEF,eAAO,MAAM,cAAc,UAClB,KAAK,CAAC,aAAa,MACtB,MAAM,GAAG,SAAS,YACZ,IAAI,CAAC,aAAa,KAC3B,IAAI,CAAC,IAAI,EAEX,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,UAAW,KAAK,CAAC,aAAa,OAAO,MAAM,KAAG,IAAI,CAAC,IAAI,EAG7E,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,UAAW,KAAK,CAAC,aAAa,OAAO,MAAM,KAAG,KAAK,CAAC,KAGxE,CAAC"}