@dxos/plugin-graph 0.8.4-main.bc674ce → 0.8.4-main.c351d160a8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-graph",
-  "version": "0.8.4-main.bc674ce",
+  "version": "0.8.4-main.c351d160a8",
   "description": "DXOS Surface plugin for constructing knowledge graphs",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -29,30 +29,31 @@
     "src"
   ],
   "dependencies": {
-    "@dxos/app-framework": "0.8.4-main.bc674ce",
-    "@dxos/async": "0.8.4-main.bc674ce",
-    "@dxos/effect": "0.8.4-main.bc674ce",
-    "@dxos/app-graph": "0.8.4-main.bc674ce",
-    "@dxos/operation": "0.8.4-main.bc674ce",
-    "@dxos/debug": "0.8.4-main.bc674ce",
-    "@dxos/util": "0.8.4-main.bc674ce"
+    "@dxos/app-framework": "0.8.4-main.c351d160a8",
+    "@dxos/app-graph": "0.8.4-main.c351d160a8",
+    "@dxos/debug": "0.8.4-main.c351d160a8",
+    "@dxos/app-toolkit": "0.8.4-main.c351d160a8",
+    "@dxos/effect": "0.8.4-main.c351d160a8",
+    "@dxos/operation": "0.8.4-main.c351d160a8",
+    "@dxos/async": "0.8.4-main.c351d160a8",
+    "@dxos/util": "0.8.4-main.c351d160a8"
   },
   "devDependencies": {
-    "@effect-atom/atom-react": "^0.4.6",
-    "@effect/platform": "0.93.6",
+    "@effect-atom/atom-react": "^0.5.0",
+    "@effect/platform": "0.94.4",
     "@types/react": "~19.2.7",
     "@types/react-dom": "~19.2.3",
-    "effect": "3.19.11",
+    "effect": "3.19.16",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "vite": "7.1.9",
-    "@dxos/react-client": "0.8.4-main.bc674ce",
-    "@dxos/storybook-utils": "0.8.4-main.bc674ce"
+    "vite": "^7.1.11",
+    "@dxos/react-client": "0.8.4-main.c351d160a8",
+    "@dxos/storybook-utils": "0.8.4-main.c351d160a8"
   },
   "peerDependencies": {
-    "@effect-atom/atom-react": "^0.4.6",
-    "@effect/platform": "0.93.6",
-    "effect": "3.19.11",
+    "@effect-atom/atom-react": "^0.5.0",
+    "@effect/platform": "0.94.4",
+    "effect": "3.19.16",
     "react": "~19.2.3",
     "react-dom": "~19.2.3"
   },

package/src/GraphPlugin.ts

@@ -2,7 +2,8 @@
 // Copyright 2025 DXOS.org
 //
 
-import { Capability, Common, Plugin } from '@dxos/app-framework';
+import { ActivationEvents, Capability, Plugin } from '@dxos/app-framework';
+import { AppActivationEvents } from '@dxos/app-toolkit';
 
 import { meta } from './meta';
 
@@ -15,9 +16,9 @@ const Graph = Capability.lazy('Graph', () => import('./graph'));
  */
 export const GraphPlugin = Plugin.define(meta).pipe(
   Plugin.addModule({
-    activatesOn: Common.ActivationEvent.Startup,
-    activatesBefore: [Common.ActivationEvent.SetupAppGraph, Common.ActivationEvent.SetupMetadata],
-    activatesAfter: [Common.ActivationEvent.AppGraphReady],
+    activatesOn: ActivationEvents.Startup,
+    activatesBefore: [AppActivationEvents.SetupAppGraph, AppActivationEvents.SetupMetadata],
+    activatesAfter: [AppActivationEvents.AppGraphReady],
     activate: Graph,
   }),
   Plugin.make,

package/src/graph.ts

@@ -5,18 +5,19 @@
 import * as Effect from 'effect/Effect';
 import * as Record from 'effect/Record';
 
-import { Capability, Common } from '@dxos/app-framework';
+import { Capabilities, Capability } from '@dxos/app-framework';
 import { Graph, GraphBuilder, Node } from '@dxos/app-graph';
+import { AppCapabilities } from '@dxos/app-toolkit';
 
 // TODO(wittjosiah): Remove or restore graph caching.
 // import { meta } from './meta';
 
-// const KEY = `${meta.id}/app-graph`;
+// const KEY = `${meta.id}.app-graph`;
 
 export default Capability.makeModule(
   Effect.fnUntraced(function* () {
-    const registry = yield* Capability.get(Common.Capability.AtomRegistry);
-    const extensionsAtom = yield* Capability.atom(Common.Capability.AppGraphBuilder);
+    const registry = yield* Capability.get(Capabilities.AtomRegistry);
+    const extensionsAtom = yield* Capability.atom(AppCapabilities.AppGraphBuilder);
 
     const builder = GraphBuilder.from(/* localStorage.getItem(KEY) ?? */ undefined, registry);
     // const interval = setInterval(() => {
@@ -36,12 +37,12 @@ export default Capability.makeModule(
     );
 
     // await builder.initialize();
-    void Graph.expand(builder.graph, Node.RootId);
+    void Graph.expand(builder.graph, Node.RootId, 'child');
 
     setupDevtools(builder.graph);
 
     return Capability.contributes(
-      Common.Capability.AppGraph,
+      AppCapabilities.AppGraph,
       { graph: builder.graph, explore: GraphBuilder.explore },
       () =>
         Effect.sync(() => {

package/src/hooks/useActionRunner.ts

@@ -4,7 +4,7 @@
 
 import { useCallback } from 'react';
 
-import { useOperationInvoker, usePluginManager } from '@dxos/app-framework/react';
+import { useOperationInvoker, usePluginManager } from '@dxos/app-framework/ui';
 import { type Node } from '@dxos/app-graph';
 
 import { runAction } from '../action';

package/src/hooks/useNode.ts

@@ -4,6 +4,7 @@
 
 import { useAtomValue } from '@effect-atom/atom-react';
 import * as Option from 'effect/Option';
+import { useMemo } from 'react';
 
 import { type Graph, type Node } from '@dxos/app-graph';
 
@@ -17,13 +18,38 @@ import { type Graph, type Node } from '@dxos/app-graph';
  */
 // TODO(wittjosiah): Factor out to @dxos/app-graph/react.
 export const useNode = <T = any>(graph: Graph.ReadableGraph, id?: string): Node.Node<T> | undefined => {
-  return Option.getOrElse(useAtomValue(graph.node(id ?? '')), () => undefined);
+  const atom = useMemo(() => graph.node(id ?? ''), [graph, id]);
+  return Option.getOrElse(useAtomValue(atom), () => undefined);
 };
 
-export const useConnections = (graph: Graph.ReadableGraph, id?: string, relation?: Node.Relation): Node.Node[] => {
+export const useConnections = (
+  graph: Graph.ReadableGraph,
+  id: string | undefined,
+  relation: Node.RelationInput,
+): Node.Node[] => {
   return useAtomValue(graph.connections(id ?? '', relation));
 };
 
+/**
+ * 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 const useActions = (graph: Graph.ReadableGraph, id?: string): Node.Node[] => {
-  return useAtomValue(graph.actions(id ?? ''));
+  const atom = useMemo(() => graph.actions(id ?? ''), [graph, id]);
+  return useAtomValue(atom);
+};
+
+/**
+ * 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 const useEdges = (graph: Graph.ReadableGraph, id?: string): Graph.Edges => {
+  const atom = useMemo(() => graph.edges(id ?? ''), [graph, id]);
+  return useAtomValue(atom);
 };

package/src/meta.ts

@@ -6,7 +6,7 @@ import { type Plugin } from '@dxos/app-framework';
 import { trim } from '@dxos/util';
 
 export const meta: Plugin.Meta = {
-  id: 'dxos.org/plugin/graph',
+  id: 'org.dxos.plugin.graph',
   name: 'Graph',
   description: trim`
     Graph database layer providing relationship modeling and queries for workspace objects.

package/dist/lib/browser/graph-PXKA3JXN.mjs.map

@@ -1,7 +0,0 @@
-{
-  "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 { Capability, Common } from '@dxos/app-framework';\nimport { Graph, GraphBuilder, Node } from '@dxos/app-graph';\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(Common.Capability.AtomRegistry);\n    const extensionsAtom = yield* Capability.atom(Common.Capability.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      extensionsAtom,\n      (extensions) => {\n        const next = GraphBuilder.flattenExtensions(extensions);\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);\n\n    setupDevtools(builder.graph);\n\n    return Capability.contributes(\n      Common.Capability.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,YAAYC,cAAc;AACnC,SAASC,OAAOC,cAAcC,YAAY;AAO1C,IAAA,gBAAeC,WAAWC,WACjBC,kBAAW,aAAA;AAChB,QAAMC,WAAW,OAAOH,WAAWI,IAAIC,OAAOL,WAAWM,YAAY;AACrE,QAAMC,iBAAiB,OAAOP,WAAWQ,KAAKH,OAAOL,WAAWS,eAAe;AAE/E,QAAMC,UAAUC,aAAaC;;IAAwCC;IAAWV;EAAAA;AAKhF,QAAMW,cAAcX,SAASY,UAC3BR,gBACA,CAACS,eAAAA;AACC,UAAMC,OAAON,aAAaO,kBAAkBF,UAAAA;AAC5C,UAAMG,UAAiBC,cAAOjB,SAASC,IAAIM,QAAQM,UAAU,CAAA;AAC7D,UAAMK,UAAUF,QAAQG,OAAO,CAAC,EAAEC,GAAE,MAAO,CAACN,KAAKO,KAAK,CAAC,EAAED,IAAIE,OAAM,MAAOA,WAAWF,EAAAA,CAAAA;AACrFF,YAAQK,QAAQ,CAACC,cAAchB,aAAaiB,gBAAgBlB,SAASiB,UAAUJ,EAAE,CAAA;AACjFN,SAAKS,QAAQ,CAACC,cAAchB,aAAakB,aAAanB,SAASiB,SAAAA,CAAAA;EACjE,GACA;IAAEG,WAAW;EAAK,CAAA;AAIpB,OAAKC,MAAMC,OAAOtB,QAAQuB,OAAOC,KAAKC,MAAM;AAE5CC,gBAAc1B,QAAQuB,KAAK;AAE3B,SAAOjC,WAAWqC,YAChBhC,OAAOL,WAAWsC,UAClB;IAAEL,OAAOvB,QAAQuB;IAAOM,SAAS5B,aAAa4B;EAAQ,GACtD,MACSC,YAAK,MAAA;AAEV1B,gBAAAA;EACF,CAAA,CAAA;AAEN,CAAA,CAAA;AAIF,IAAMsB,gBAAgB,CAACH,UAAAA;AACpBQ,aAAmBC,aAAa,CAAC;AACjCD,aAAmBC,SAAST,QAAQA;AACvC;",
-  "names": ["Effect", "Record", "Capability", "Common", "Graph", "GraphBuilder", "Node", "Capability", "makeModule", "fnUntraced", "registry", "get", "Common", "AtomRegistry", "extensionsAtom", "atom", "AppGraphBuilder", "builder", "GraphBuilder", "from", "undefined", "unsubscribe", "subscribe", "extensions", "next", "flattenExtensions", "current", "values", "removed", "filter", "id", "some", "nextId", "forEach", "extension", "removeExtension", "addExtension", "immediate", "Graph", "expand", "graph", "Node", "RootId", "setupDevtools", "contributes", "AppGraph", "explore", "sync", "globalThis", "composer"]
-}

package/dist/lib/node-esm/graph-CR2XR64B.mjs.map

@@ -1,7 +0,0 @@
-{
-  "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 { Capability, Common } from '@dxos/app-framework';\nimport { Graph, GraphBuilder, Node } from '@dxos/app-graph';\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(Common.Capability.AtomRegistry);\n    const extensionsAtom = yield* Capability.atom(Common.Capability.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      extensionsAtom,\n      (extensions) => {\n        const next = GraphBuilder.flattenExtensions(extensions);\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);\n\n    setupDevtools(builder.graph);\n\n    return Capability.contributes(\n      Common.Capability.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,YAAYC,cAAc;AACnC,SAASC,OAAOC,cAAcC,YAAY;AAO1C,IAAA,gBAAeC,WAAWC,WACjBC,kBAAW,aAAA;AAChB,QAAMC,WAAW,OAAOH,WAAWI,IAAIC,OAAOL,WAAWM,YAAY;AACrE,QAAMC,iBAAiB,OAAOP,WAAWQ,KAAKH,OAAOL,WAAWS,eAAe;AAE/E,QAAMC,UAAUC,aAAaC;;IAAwCC;IAAWV;EAAAA;AAKhF,QAAMW,cAAcX,SAASY,UAC3BR,gBACA,CAACS,eAAAA;AACC,UAAMC,OAAON,aAAaO,kBAAkBF,UAAAA;AAC5C,UAAMG,UAAiBC,cAAOjB,SAASC,IAAIM,QAAQM,UAAU,CAAA;AAC7D,UAAMK,UAAUF,QAAQG,OAAO,CAAC,EAAEC,GAAE,MAAO,CAACN,KAAKO,KAAK,CAAC,EAAED,IAAIE,OAAM,MAAOA,WAAWF,EAAAA,CAAAA;AACrFF,YAAQK,QAAQ,CAACC,cAAchB,aAAaiB,gBAAgBlB,SAASiB,UAAUJ,EAAE,CAAA;AACjFN,SAAKS,QAAQ,CAACC,cAAchB,aAAakB,aAAanB,SAASiB,SAAAA,CAAAA;EACjE,GACA;IAAEG,WAAW;EAAK,CAAA;AAIpB,OAAKC,MAAMC,OAAOtB,QAAQuB,OAAOC,KAAKC,MAAM;AAE5CC,gBAAc1B,QAAQuB,KAAK;AAE3B,SAAOjC,WAAWqC,YAChBhC,OAAOL,WAAWsC,UAClB;IAAEL,OAAOvB,QAAQuB;IAAOM,SAAS5B,aAAa4B;EAAQ,GACtD,MACSC,YAAK,MAAA;AAEV1B,gBAAAA;EACF,CAAA,CAAA;AAEN,CAAA,CAAA;AAIF,IAAMsB,gBAAgB,CAACH,UAAAA;AACpBQ,aAAmBC,aAAa,CAAC;AACjCD,aAAmBC,SAAST,QAAQA;AACvC;",
-  "names": ["Effect", "Record", "Capability", "Common", "Graph", "GraphBuilder", "Node", "Capability", "makeModule", "fnUntraced", "registry", "get", "Common", "AtomRegistry", "extensionsAtom", "atom", "AppGraphBuilder", "builder", "GraphBuilder", "from", "undefined", "unsubscribe", "subscribe", "extensions", "next", "flattenExtensions", "current", "values", "removed", "filter", "id", "some", "nextId", "forEach", "extension", "removeExtension", "addExtension", "immediate", "Graph", "expand", "graph", "Node", "RootId", "setupDevtools", "contributes", "AppGraph", "explore", "sync", "globalThis", "composer"]
-}