project-graph-mcp 2.2.6 → 2.3.0

package/vendor/symbiote-node/core/Editor.js

@@ -0,0 +1,451 @@
+/**
+ * NodeEditor — central graph manager with event system
+ *
+ * Provides CRUD operations for nodes and connections with
+ * pre/post event hooks via callback-based event emitter.
+ * Replaces Rete.js Scope/Signal with simpler emit pattern.
+ *
+ * @module symbiote-node/core/Editor
+ */
+
+import { Connection } from './Connection.js';
+import { Node } from './Node.js';
+import { Socket, Input, Output, InputControl } from './Socket.js';
+import { Frame } from './Frame.js';
+
+/**
+ * @typedef {'nodecreate'|'nodecreated'|'noderemove'|'noderemoved'|
+ *           'connectioncreate'|'connectioncreated'|'connectionremove'|'connectionremoved'|
+ *           'framecreate'|'framecreated'|'frameremove'|'frameremoved'|
+ *           'clear'|'cleared'|'nodeselect'|'nodedeselect'} EditorEvent
+ */
+
+export class NodeEditor {
+  constructor() {
+    /** @type {Map<string, import('./Node.js').Node>} */
+    this.nodes = new Map();
+
+    /** @type {Map<string, Connection>} */
+    this.connections = new Map();
+
+    /** @type {Map<string, import('./Frame.js').Frame>} */
+    this.frames = new Map();
+
+    /** @type {Object<string, Set<function>>} */
+    this._listeners = {};
+  }
+
+  // --- Event System ---
+
+  /**
+   * Subscribe to editor event
+   * @param {EditorEvent} event
+   * @param {function} handler
+   * @returns {function} Unsubscribe function
+   */
+  on(event, handler) {
+    if (!this._listeners[event]) {
+      this._listeners[event] = new Set();
+    }
+    this._listeners[event].add(handler);
+    return () => this._listeners[event].delete(handler);
+  }
+
+  /**
+   * Emit event to all listeners
+   * @param {EditorEvent} event
+   * @param {*} data
+   * @returns {boolean} - false if any listener returned false (cancel)
+   */
+  emit(event, data) {
+    const handlers = this._listeners[event];
+    if (!handlers) return true;
+    for (const handler of handlers) {
+      if (handler(data) === false) return false;
+    }
+    return true;
+  }
+
+  /**
+   * Remove all event listeners (for clean teardown)
+   */
+  removeAllListeners() {
+    this._listeners = {};
+  }
+
+  // --- Node CRUD ---
+
+  /**
+   * Get node by ID
+   * @param {string} id
+   * @returns {import('./Node.js').Node|undefined}
+   */
+  getNode(id) {
+    return this.nodes.get(id);
+  }
+
+  /**
+   * Get all nodes
+   * @returns {import('./Node.js').Node[]}
+   */
+  getNodes() {
+    return [...this.nodes.values()];
+  }
+
+  /**
+   * Add node to editor
+   * @param {import('./Node.js').Node} node
+   * @returns {boolean}
+   */
+  addNode(node) {
+    if (this.nodes.has(node.id)) throw new Error('node already added');
+    if (!this.emit('nodecreate', node)) return false;
+    this.nodes.set(node.id, node);
+    this.emit('nodecreated', node);
+    return true;
+  }
+
+  /**
+   * Remove node and all its connections
+   * @param {string} id
+   * @returns {boolean}
+   */
+  removeNode(id) {
+    const node = this.nodes.get(id);
+    if (!node) throw new Error('node not found');
+    if (!this.emit('noderemove', node)) return false;
+
+    // Remove all connections to/from this node
+    for (const [connId, conn] of this.connections) {
+      if (conn.from === id || conn.to === id) {
+        this.removeConnection(connId);
+      }
+    }
+
+    this.nodes.delete(id);
+    this.emit('noderemoved', node);
+    return true;
+  }
+
+  // --- Connection CRUD ---
+
+  /**
+   * Get connection by ID
+   * @param {string} id
+   * @returns {Connection|undefined}
+   */
+  getConnection(id) {
+    return this.connections.get(id);
+  }
+
+  /**
+   * Get all connections
+   * @returns {Connection[]}
+   */
+  getConnections() {
+    return [...this.connections.values()];
+  }
+
+  /**
+   * Get connections for a specific node
+   * @param {string} nodeId
+   * @returns {Connection[]}
+   */
+  getNodeConnections(nodeId) {
+    return this.getConnections().filter(c => c.from === nodeId || c.to === nodeId);
+  }
+
+  /**
+   * Add connection
+   * @param {Connection} connection
+   * @returns {boolean}
+   */
+  addConnection(connection) {
+    if (this.connections.has(connection.id)) throw new Error('connection already added');
+    if (!this.emit('connectioncreate', connection)) return false;
+    this.connections.set(connection.id, connection);
+    this.emit('connectioncreated', connection);
+    return true;
+  }
+
+  /**
+   * Remove connection
+   * @param {string} id
+   * @returns {boolean}
+   */
+  removeConnection(id) {
+    const conn = this.connections.get(id);
+    if (!conn) return false;
+    if (!this.emit('connectionremove', conn)) return false;
+    this.connections.delete(id);
+    this.emit('connectionremoved', conn);
+    return true;
+  }
+
+  // --- Bulk Operations ---
+
+  /**
+   * Clear all nodes and connections
+   * @returns {boolean}
+   */
+  clear() {
+    if (!this.emit('clear', null)) return false;
+    for (const id of [...this.connections.keys()]) {
+      this.removeConnection(id);
+    }
+    for (const id of [...this.nodes.keys()]) {
+      this.removeNode(id);
+    }
+    this.emit('cleared', null);
+    return true;
+  }
+
+  // --- Frame CRUD ---
+
+  /**
+   * Get frame by ID
+   * @param {string} id
+   * @returns {import('./Frame.js').Frame|undefined}
+   */
+  getFrame(id) {
+    return this.frames.get(id);
+  }
+
+  /**
+   * Get all frames
+   * @returns {import('./Frame.js').Frame[]}
+   */
+  getFrames() {
+    return [...this.frames.values()];
+  }
+
+  /**
+   * Add frame
+   * @param {import('./Frame.js').Frame} frame
+   * @returns {boolean}
+   */
+  addFrame(frame) {
+    if (this.frames.has(frame.id)) throw new Error('frame already added');
+    if (!this.emit('framecreate', frame)) return false;
+    this.frames.set(frame.id, frame);
+    this.emit('framecreated', frame);
+    return true;
+  }
+
+  /**
+   * Remove frame
+   * @param {string} id
+   * @returns {boolean}
+   */
+  removeFrame(id) {
+    const frame = this.frames.get(id);
+    if (!frame) return false;
+    if (!this.emit('frameremove', frame)) return false;
+    this.frames.delete(id);
+    this.emit('frameremoved', frame);
+    return true;
+  }
+
+  // --- Serialization (agi-graph isomorphic bridge) ---
+
+  /**
+   * Serialize editor state to agi-graph workflow JSON format.
+   * Output is directly compatible with engine/Graph.fromJSON().
+   * @param {Object<string, number[]>} [positions] - Node positions {nodeId: [x, y]}
+   * @returns {object} Workflow JSON
+   */
+  toJSON(positions = {}) {
+    return {
+      version: 1,
+      nodes: this.getNodes().map((n) => {
+        const obj = {
+          id: n.id,
+          type: n.type,
+          name: n.label,
+          params: { ...n.params },
+        };
+        if (n.category && n.category !== 'default') obj.category = n.category;
+        if (n.shape && n.shape !== 'rect') obj.shape = n.shape;
+        if (n.icon) obj.icon = n.icon;
+        if (n.cacheMode && n.cacheMode !== 'auto') obj.cacheMode = n.cacheMode;
+
+        // Serialize port definitions for round-trip
+        const inputs = Object.entries(n.inputs);
+        if (inputs.length > 0) {
+          obj.inputs = inputs.map(([key, inp]) => ({
+            name: key,
+            type: inp.socket?.name || 'any',
+            label: inp.label || '',
+          }));
+        }
+        const outputs = Object.entries(n.outputs);
+        if (outputs.length > 0) {
+          obj.outputs = outputs.map(([key, out]) => ({
+            name: key,
+            type: out.socket?.name || 'any',
+            label: out.label || '',
+          }));
+        }
+        return obj;
+      }),
+      connections: this.getConnections().map((c) => ({
+        id: c.id,
+        from: c.from,
+        out: c.out,
+        to: c.to,
+        in: c.in,
+      })),
+      frames: this.getFrames().map((f) => ({
+        id: f.id,
+        label: f.label,
+        x: f.x,
+        y: f.y,
+        width: f.width,
+        height: f.height,
+        color: f.color,
+      })),
+      ui: {
+        positions: { ...positions },
+      },
+    };
+  }
+
+  /**
+   * Reconstruct editor state from agi-graph workflow JSON.
+   * Enables round-trip: Editor → toJSON → fromJSON → Editor.
+   * Also accepts output from engine/Graph.toJSON().
+   * @param {object} data - Workflow JSON
+   * @param {Object<string, number[]>} [positionsOut] - Optional object to populate with positions
+   * @returns {NodeEditor} this
+   */
+  fromJSON(data, positionsOut) {
+    // Clear existing state (bypass events for bulk load)
+    this.nodes.clear();
+    this.connections.clear();
+    this.frames.clear();
+
+    // Restore nodes
+    for (const nd of (data.nodes || [])) {
+      const node = new Node(nd.name || nd.type, {
+        id: nd.id,
+        type: nd.type,
+        category: nd.category || 'default',
+        shape: nd.shape || 'rect',
+        icon: nd.icon || '',
+      });
+      node.params = { ...nd.params };
+      if (nd.cacheMode) node.cacheMode = nd.cacheMode;
+
+      // Auto-create InputControls from params for Inspector display
+      // Merge driver defaults into params (fills missing keys from handler definitions)
+      const driverParams = nd.driver?.params;
+      if (driverParams && !nd.params) nd.params = {};
+      if (driverParams) {
+        for (const [key, def] of Object.entries(driverParams)) {
+          if (!(key in nd.params) && def.default !== undefined) {
+            nd.params[key] = def.default;
+          }
+        }
+      }
+
+      if (nd.params) {
+        for (const [key, value] of Object.entries(nd.params)) {
+          /** @type {'text'|'number'|'textarea'|'select'|'boolean'} */
+          let controlType = 'text';
+          let displayValue = value;
+          let controlOptions = [];
+
+          // Use driver metadata for richer control type detection
+          const paramMeta = driverParams?.[key];
+          if (paramMeta?.type === 'boolean' || typeof value === 'boolean') {
+            controlType = 'boolean';
+          } else if (paramMeta?.type === 'number' || typeof value === 'number') {
+            controlType = 'number';
+          } else if (typeof value === 'string' && value.includes('\n')) {
+            controlType = 'textarea';
+          } else if (typeof value === 'object') {
+            controlType = 'textarea';
+            displayValue = JSON.stringify(value, null, 2);
+          }
+
+          // Select type from driver options
+          if (paramMeta?.options) {
+            controlType = 'select';
+            controlOptions = paramMeta.options;
+          }
+
+          node.addControl(key, new InputControl(controlType, {
+            initial: displayValue,
+            label: paramMeta?.description || key,
+            options: controlOptions,
+          }));
+        }
+      }
+
+      // Restore ports from serialized definitions
+      if (nd.inputs) {
+        for (const inp of nd.inputs) {
+          node.addInput(inp.name, new Input(new Socket(inp.type || 'any'), inp.label || ''));
+        }
+      }
+      if (nd.outputs) {
+        for (const out of nd.outputs) {
+          node.addOutput(out.name, new Output(new Socket(out.type || 'any'), out.label || ''));
+        }
+      }
+
+      this.nodes.set(node.id, node);
+    }
+
+    // Restore connections
+    for (const cd of (data.connections || [])) {
+      const srcNode = this.nodes.get(cd.from);
+      const tgtNode = this.nodes.get(cd.to);
+      if (!srcNode || !tgtNode) continue;
+
+      // Ensure ports exist (auto-create if coming from engine format without port defs)
+      if (!srcNode.outputs[cd.out]) {
+        srcNode.addOutput(cd.out, new Output(new Socket('any'), cd.out));
+      }
+      if (!tgtNode.inputs[cd.in]) {
+        tgtNode.addInput(cd.in, new Input(new Socket('any'), cd.in));
+      }
+
+      const conn = new Connection(srcNode, cd.out, tgtNode, cd.in);
+      if (cd.id) conn.id = cd.id;
+      this.connections.set(conn.id, conn);
+    }
+
+    // Restore frames
+    for (const fd of (data.frames || [])) {
+      const frame = new Frame(fd.label, {
+        id: fd.id,
+        x: fd.x,
+        y: fd.y,
+        width: fd.width,
+        height: fd.height,
+        color: fd.color,
+      });
+      this.frames.set(frame.id, frame);
+    }
+
+    // Extract positions
+    if (positionsOut && data.ui?.positions) {
+      Object.assign(positionsOut, data.ui.positions);
+    }
+
+    return this;
+  }
+
+  /**
+   * Convert editor state to an engine Graph instance for server-side execution.
+   * The Graph can be passed directly to Executor.run().
+   * @param {Object<string, number[]>} [positions] - Node positions
+   * @returns {import('../engine/Graph.js').Graph}
+   */
+  async toGraph(positions = {}) {
+    const { Graph } = await import('../engine/Graph.js');
+    const json = this.toJSON(positions);
+    return new Graph(json);
+  }
+}

package/vendor/symbiote-node/core/Frame.js

@@ -0,0 +1,31 @@
+/**
+ * Frame — visual grouping rectangle for nodes
+ *
+ * Pure data class (like Node). Stores position, size, color, label.
+ * Frame does not own nodes — containment is determined by spatial overlap.
+ *
+ * @module symbiote-node/core/Frame
+ */
+
+import { uid } from './Socket.js';
+
+export class Frame {
+  /**
+   * @param {string} label - Display label
+   * @param {object} [options]
+   * @param {string} [options.color='#4a9eff'] - Border/header color
+   * @param {number} [options.x=0] - X position
+   * @param {number} [options.y=0] - Y position
+   * @param {number} [options.width=400] - Width
+   * @param {number} [options.height=300] - Height
+   */
+  constructor(label, options = {}) {
+    this.id = options.id || uid();
+    this.label = label;
+    this.color = options.color || '#4a9eff';
+    this.x = options.x || 0;
+    this.y = options.y || 0;
+    this.width = options.width || 400;
+    this.height = options.height || 300;
+  }
+}