@invect/core 0.0.1

package/dist/services/chat/tools/node-tools.cjs

@@ -0,0 +1,323 @@
+require("../../../_virtual/_rolldown/runtime.cjs");
+let zod_v4 = require("zod/v4");
+//#region src/services/chat/tools/node-tools.ts
+/**
+* Chat Tools — Node Editing
+*
+* Granular tools for adding, removing, connecting, and configuring individual nodes.
+* These operate on the latest flow version — they read, mutate, and save a new version.
+*
+* For bulk changes (new flows from scratch), use update_flow_definition instead.
+* These are for surgical edits: "add a Slack node after the HTTP request",
+* "change the JQ query", "remove the debug node".
+*/
+/**
+* Helper: Load the latest flow version's nodes and edges.
+*/
+async function loadLatestDefinition(invect, flowId) {
+	const version = await invect.getFlowVersion(flowId, "latest");
+	if (!version) throw new Error("No flow version found — publish a version first");
+	const definition = version.invectDefinition;
+	return {
+		nodes: structuredClone(definition.nodes),
+		edges: structuredClone(definition.edges),
+		version
+	};
+}
+/**
+* Helper: Save a mutated definition as a new flow version.
+*/
+async function saveNewVersion(invect, flowId, nodes, edges) {
+	return invect.createFlowVersion(flowId, { invectDefinition: {
+		nodes,
+		edges
+	} });
+}
+/**
+* Helper: Convert a label to a snake_case reference ID.
+*/
+function labelToReferenceId(label) {
+	return label.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_|_$/g, "");
+}
+/**
+* Helper: Generate a short unique ID for nodes/edges.
+*/
+function genId() {
+	return Math.random().toString(36).slice(2, 10);
+}
+const nodeTools = [
+	{
+		id: "add_node",
+		name: "Add Node",
+		description: "Add a new node to the current flow. Optionally connect it after an existing node. The node is positioned automatically. Use search_actions or get_action_details to find valid action IDs. For bulk flow creation, prefer update_flow_definition instead.",
+		parameters: zod_v4.z.object({
+			actionId: zod_v4.z.string().describe("Action type ID (e.g. \"core.model\", \"core.javascript\", \"gmail.send_message\", \"http.request\")"),
+			label: zod_v4.z.string().describe("Human-readable node label (e.g. \"Fetch User Emails\")"),
+			params: zod_v4.z.record(zod_v4.z.string(), zod_v4.z.unknown()).optional().default({}).describe("Node configuration parameters (key-value pairs)"),
+			connectAfter: zod_v4.z.string().optional().describe("Node ID to connect after — creates an edge from that node to this new one")
+		}),
+		async execute(params, ctx) {
+			const { actionId, label, params: nodeParams, connectAfter } = params;
+			const invect = ctx.invect;
+			const flowId = ctx.chatContext.flowId;
+			if (!flowId) return {
+				success: false,
+				error: "No flow is currently open"
+			};
+			try {
+				const availableNodes = invect.getAvailableNodes();
+				if (!availableNodes.find((n) => n.type === actionId)) {
+					const searchLower = actionId.toLowerCase();
+					const similar = availableNodes.filter((n) => n.type.toLowerCase().includes(searchLower.split(".").pop() ?? "")).slice(0, 5).map((n) => n.type);
+					return {
+						success: false,
+						error: `Action "${actionId}" not found in the action registry`,
+						suggestion: similar.length > 0 ? `Did you mean one of: ${similar.join(", ")}? Use search_actions to find valid action IDs.` : "Use search_actions to find valid action IDs."
+					};
+				}
+				const { nodes, edges } = await loadLatestDefinition(invect, flowId);
+				const nodeId = `node_${genId()}`;
+				const referenceId = labelToReferenceId(label);
+				let position = {
+					x: 250,
+					y: 100
+				};
+				if (connectAfter) {
+					const upstream = nodes.find((n) => n.id === connectAfter);
+					if (upstream?.position) position = {
+						x: upstream.position.x,
+						y: upstream.position.y + 150
+					};
+				} else if (nodes.length > 0) {
+					const lastNode = nodes[nodes.length - 1];
+					if (lastNode?.position) position = {
+						x: lastNode.position.x,
+						y: lastNode.position.y + 150
+					};
+				}
+				nodes.push({
+					id: nodeId,
+					type: actionId,
+					label,
+					referenceId,
+					params: nodeParams ?? {},
+					position
+				});
+				if (connectAfter) {
+					if (!nodes.find((n) => n.id === connectAfter)) return {
+						success: false,
+						error: `Cannot connect after node "${connectAfter}" — node not found`,
+						suggestion: "Use get_current_flow_context to see available node IDs."
+					};
+					edges.push({
+						id: `edge_${genId()}`,
+						source: connectAfter,
+						target: nodeId
+					});
+				}
+				return {
+					success: true,
+					data: {
+						nodeId,
+						label,
+						actionId,
+						referenceId,
+						versionNumber: (await saveNewVersion(invect, flowId, nodes, edges)).version,
+						connected: connectAfter ? {
+							from: connectAfter,
+							to: nodeId
+						} : void 0
+					},
+					uiAction: {
+						action: "refresh_flow",
+						data: {
+							flowId,
+							selectNodeId: nodeId
+						}
+					}
+				};
+			} catch (error) {
+				return {
+					success: false,
+					error: `Failed to add node: ${error.message}`,
+					suggestion: "Use search_actions to verify the action ID is valid."
+				};
+			}
+		}
+	},
+	{
+		id: "remove_node",
+		name: "Remove Node",
+		description: "Remove a node from the current flow. Also removes all edges connected to it. Use get_current_flow_context to find node IDs.",
+		parameters: zod_v4.z.object({ nodeId: zod_v4.z.string().describe("ID of the node to remove") }),
+		async execute(params, ctx) {
+			const { nodeId } = params;
+			const invect = ctx.invect;
+			const flowId = ctx.chatContext.flowId;
+			if (!flowId) return {
+				success: false,
+				error: "No flow is currently open"
+			};
+			try {
+				const { nodes, edges } = await loadLatestDefinition(invect, flowId);
+				const nodeIndex = nodes.findIndex((n) => n.id === nodeId);
+				if (nodeIndex === -1) return {
+					success: false,
+					error: `Node "${nodeId}" not found in flow`,
+					suggestion: "Use get_current_flow_context to see available node IDs."
+				};
+				const removedNode = nodes[nodeIndex];
+				const removedLabel = removedNode.label || removedNode.id;
+				nodes.splice(nodeIndex, 1);
+				const removedEdgeCount = edges.length;
+				const filteredEdges = edges.filter((e) => e.source !== nodeId && e.target !== nodeId);
+				return {
+					success: true,
+					data: {
+						removedNodeId: nodeId,
+						removedLabel,
+						edgesRemoved: removedEdgeCount - filteredEdges.length,
+						versionNumber: (await saveNewVersion(invect, flowId, nodes, filteredEdges)).version,
+						remainingNodeCount: nodes.length
+					},
+					uiAction: {
+						action: "refresh_flow",
+						data: { flowId }
+					}
+				};
+			} catch (error) {
+				return {
+					success: false,
+					error: `Failed to remove node: ${error.message}`
+				};
+			}
+		}
+	},
+	{
+		id: "update_node_config",
+		name: "Update Node Config",
+		description: "Update the configuration parameters of an existing node. Merges the provided params into the existing config (does not replace unmentioned params). Use this for targeted changes like \"change the JQ query\" or \"update the prompt\".",
+		parameters: zod_v4.z.object({
+			nodeId: zod_v4.z.string().describe("ID of the node to update"),
+			params: zod_v4.z.record(zod_v4.z.string(), zod_v4.z.unknown()).describe("Parameters to set or update (merged with existing)"),
+			label: zod_v4.z.string().optional().describe("Optionally update the node label too")
+		}),
+		async execute(params, ctx) {
+			const { nodeId, params: newParams, label } = params;
+			const invect = ctx.invect;
+			const flowId = ctx.chatContext.flowId;
+			if (!flowId) return {
+				success: false,
+				error: "No flow is currently open"
+			};
+			try {
+				const { nodes, edges } = await loadLatestDefinition(invect, flowId);
+				const node = nodes.find((n) => n.id === nodeId);
+				if (!node) return {
+					success: false,
+					error: `Node "${nodeId}" not found in flow`,
+					suggestion: "Use get_current_flow_context to see available node IDs."
+				};
+				node.params = {
+					...node.params ?? {},
+					...newParams
+				};
+				if (label) {
+					node.label = label;
+					node.referenceId = labelToReferenceId(label);
+				}
+				const version = await saveNewVersion(invect, flowId, nodes, edges);
+				return {
+					success: true,
+					data: {
+						nodeId,
+						label: node.label,
+						updatedParams: Object.keys(newParams),
+						versionNumber: version.version
+					},
+					uiAction: {
+						action: "refresh_flow",
+						data: {
+							flowId,
+							selectNodeId: nodeId
+						}
+					}
+				};
+			} catch (error) {
+				return {
+					success: false,
+					error: `Failed to update node: ${error.message}`
+				};
+			}
+		}
+	},
+	{
+		id: "connect_nodes",
+		name: "Connect Nodes",
+		description: "Create an edge between two nodes. Data flows from source to target. Use sourceHandle/targetHandle for multi-output nodes like if-else (e.g. \"true_output\", \"false_output\").",
+		parameters: zod_v4.z.object({
+			sourceNodeId: zod_v4.z.string().describe("ID of the source node (data flows FROM here)"),
+			targetNodeId: zod_v4.z.string().describe("ID of the target node (data flows TO here)"),
+			sourceHandle: zod_v4.z.string().optional().describe("Source handle for multi-output nodes (e.g. \"true_output\", \"false_output\")"),
+			targetHandle: zod_v4.z.string().optional().describe("Target handle (rarely needed)")
+		}),
+		async execute(params, ctx) {
+			const { sourceNodeId, targetNodeId, sourceHandle, targetHandle } = params;
+			const invect = ctx.invect;
+			const flowId = ctx.chatContext.flowId;
+			if (!flowId) return {
+				success: false,
+				error: "No flow is currently open"
+			};
+			try {
+				const { nodes, edges } = await loadLatestDefinition(invect, flowId);
+				const source = nodes.find((n) => n.id === sourceNodeId);
+				const target = nodes.find((n) => n.id === targetNodeId);
+				if (!source) return {
+					success: false,
+					error: `Source node "${sourceNodeId}" not found`,
+					suggestion: "Use get_current_flow_context to see available node IDs."
+				};
+				if (!target) return {
+					success: false,
+					error: `Target node "${targetNodeId}" not found`,
+					suggestion: "Use get_current_flow_context to see available node IDs."
+				};
+				if (edges.some((e) => e.source === sourceNodeId && e.target === targetNodeId && (e.sourceHandle ?? "") === (sourceHandle ?? "") && (e.targetHandle ?? "") === (targetHandle ?? ""))) return {
+					success: true,
+					data: { message: "Edge already exists — no change needed" }
+				};
+				edges.push({
+					id: `edge_${genId()}`,
+					source: sourceNodeId,
+					target: targetNodeId,
+					...sourceHandle && { sourceHandle },
+					...targetHandle && { targetHandle }
+				});
+				const version = await saveNewVersion(invect, flowId, nodes, edges);
+				return {
+					success: true,
+					data: {
+						edgeId: edges[edges.length - 1].id,
+						from: `${source.label ?? sourceNodeId}`,
+						to: `${target.label ?? targetNodeId}`,
+						versionNumber: version.version
+					},
+					uiAction: {
+						action: "refresh_flow",
+						data: { flowId }
+					}
+				};
+			} catch (error) {
+				return {
+					success: false,
+					error: `Failed to connect nodes: ${error.message}`
+				};
+			}
+		}
+	}
+];
+//#endregion
+exports.nodeTools = nodeTools;
+
+//# sourceMappingURL=node-tools.cjs.map

package/dist/services/chat/tools/node-tools.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-tools.cjs","names":["z"],"sources":["../../../../src/services/chat/tools/node-tools.ts"],"sourcesContent":["/**\n * Chat Tools — Node Editing\n *\n * Granular tools for adding, removing, connecting, and configuring individual nodes.\n * These operate on the latest flow version — they read, mutate, and save a new version.\n *\n * For bulk changes (new flows from scratch), use update_flow_definition instead.\n * These are for surgical edits: \"add a Slack node after the HTTP request\",\n * \"change the JQ query\", \"remove the debug node\".\n */\n\nimport { z } from 'zod/v4';\nimport type { ChatToolDefinition, ChatToolContext, ChatToolResult } from '../chat-types';\nimport type { Invect } from 'src/invect-core';\nimport type { FlowNodeDefinitions, FlowEdge } from 'src/services/flow-versions/schemas-fresh';\n\n/**\n * Helper: Load the latest flow version's nodes and edges.\n */\nasync function loadLatestDefinition(invect: Invect, flowId: string) {\n  const version = await invect.getFlowVersion(flowId, 'latest');\n  if (!version) {\n    throw new Error('No flow version found — publish a version first');\n  }\n\n  const definition = version.invectDefinition;\n  const nodes = structuredClone(definition.nodes) as FlowNodeDefinitions[];\n  const edges = structuredClone(definition.edges) as FlowEdge[];\n\n  return { nodes, edges, version };\n}\n\n/**\n * Helper: Save a mutated definition as a new flow version.\n */\nasync function saveNewVersion(\n  invect: Invect,\n  flowId: string,\n  nodes: FlowNodeDefinitions[],\n  edges: FlowEdge[],\n) {\n  return invect.createFlowVersion(flowId, {\n    invectDefinition: { nodes, edges },\n  });\n}\n\n/**\n * Helper: Convert a label to a snake_case reference ID.\n */\nfunction labelToReferenceId(label: string): string {\n  return label\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '_')\n    .replace(/^_|_$/g, '');\n}\n\n/**\n * Helper: Generate a short unique ID for nodes/edges.\n */\nfunction genId(): string {\n  return Math.random().toString(36).slice(2, 10);\n}\n\n// =====================================\n// add_node\n// =====================================\n\nexport const addNodeTool: ChatToolDefinition = {\n  id: 'add_node',\n  name: 'Add Node',\n  description:\n    'Add a new node to the current flow. Optionally connect it after an existing node. ' +\n    'The node is positioned automatically. Use search_actions or get_action_details to find valid action IDs. ' +\n    'For bulk flow creation, prefer update_flow_definition instead.',\n  parameters: z.object({\n    actionId: z\n      .string()\n      .describe(\n        'Action type ID (e.g. \"core.model\", \"core.javascript\", \"gmail.send_message\", \"http.request\")',\n      ),\n    label: z.string().describe('Human-readable node label (e.g. \"Fetch User Emails\")'),\n    params: z\n      .record(z.string(), z.unknown())\n      .optional()\n      .default({})\n      .describe('Node configuration parameters (key-value pairs)'),\n    connectAfter: z\n      .string()\n      .optional()\n      .describe('Node ID to connect after — creates an edge from that node to this new one'),\n  }),\n  async execute(params: unknown, ctx: ChatToolContext): Promise<ChatToolResult> {\n    const {\n      actionId,\n      label,\n      params: nodeParams,\n      connectAfter,\n    } = params as {\n      actionId: string;\n      label: string;\n      params: Record<string, unknown>;\n      connectAfter?: string;\n    };\n    const invect = ctx.invect as Invect;\n    const flowId = ctx.chatContext.flowId;\n\n    if (!flowId) {\n      return { success: false, error: 'No flow is currently open' };\n    }\n\n    try {\n      // Validate action ID exists in the registry\n      const availableNodes = invect.getAvailableNodes();\n      const validAction = availableNodes.find((n) => n.type === actionId);\n      if (!validAction) {\n        const searchLower = actionId.toLowerCase();\n        const similar = availableNodes\n          .filter((n) => n.type.toLowerCase().includes(searchLower.split('.').pop() ?? ''))\n          .slice(0, 5)\n          .map((n) => n.type);\n        return {\n          success: false,\n          error: `Action \"${actionId}\" not found in the action registry`,\n          suggestion:\n            similar.length > 0\n              ? `Did you mean one of: ${similar.join(', ')}? Use search_actions to find valid action IDs.`\n              : 'Use search_actions to find valid action IDs.',\n        };\n      }\n\n      const { nodes, edges } = await loadLatestDefinition(invect, flowId);\n\n      const nodeId = `node_${genId()}`;\n      const referenceId = labelToReferenceId(label);\n\n      // Compute position: below connectAfter node, or after the last node\n      let position = { x: 250, y: 100 };\n      if (connectAfter) {\n        const upstream = nodes.find((n) => n.id === connectAfter);\n        if (upstream?.position) {\n          position = { x: upstream.position.x, y: upstream.position.y + 150 };\n        }\n      } else if (nodes.length > 0) {\n        const lastNode = nodes[nodes.length - 1];\n        if (lastNode?.position) {\n          position = { x: lastNode.position.x, y: lastNode.position.y + 150 };\n        }\n      }\n\n      // Add the new node\n      nodes.push({\n        id: nodeId,\n        type: actionId,\n        label,\n        referenceId,\n        params: nodeParams ?? {},\n        position,\n      });\n\n      // Auto-connect if requested\n      if (connectAfter) {\n        const upstream = nodes.find((n) => n.id === connectAfter);\n        if (!upstream) {\n          return {\n            success: false,\n            error: `Cannot connect after node \"${connectAfter}\" — node not found`,\n            suggestion: 'Use get_current_flow_context to see available node IDs.',\n          };\n        }\n        edges.push({\n          id: `edge_${genId()}`,\n          source: connectAfter,\n          target: nodeId,\n        });\n      }\n\n      const version = await saveNewVersion(invect, flowId, nodes, edges);\n\n      return {\n        success: true,\n        data: {\n          nodeId,\n          label,\n          actionId,\n          referenceId,\n          versionNumber: version.version,\n          connected: connectAfter ? { from: connectAfter, to: nodeId } : undefined,\n        },\n        uiAction: {\n          action: 'refresh_flow',\n          data: { flowId, selectNodeId: nodeId },\n        },\n      };\n    } catch (error: unknown) {\n      return {\n        success: false,\n        error: `Failed to add node: ${(error as Error).message}`,\n        suggestion: 'Use search_actions to verify the action ID is valid.',\n      };\n    }\n  },\n};\n\n// =====================================\n// remove_node\n// =====================================\n\nexport const removeNodeTool: ChatToolDefinition = {\n  id: 'remove_node',\n  name: 'Remove Node',\n  description:\n    'Remove a node from the current flow. Also removes all edges connected to it. ' +\n    'Use get_current_flow_context to find node IDs.',\n  parameters: z.object({\n    nodeId: z.string().describe('ID of the node to remove'),\n  }),\n  async execute(params: unknown, ctx: ChatToolContext): Promise<ChatToolResult> {\n    const { nodeId } = params as { nodeId: string };\n    const invect = ctx.invect as Invect;\n    const flowId = ctx.chatContext.flowId;\n\n    if (!flowId) {\n      return { success: false, error: 'No flow is currently open' };\n    }\n\n    try {\n      const { nodes, edges } = await loadLatestDefinition(invect, flowId);\n\n      const nodeIndex = nodes.findIndex((n) => n.id === nodeId);\n      if (nodeIndex === -1) {\n        return {\n          success: false,\n          error: `Node \"${nodeId}\" not found in flow`,\n          suggestion: 'Use get_current_flow_context to see available node IDs.',\n        };\n      }\n\n      const removedNode = nodes[nodeIndex];\n      const removedLabel = removedNode.label || removedNode.id;\n\n      // Remove the node\n      nodes.splice(nodeIndex, 1);\n\n      // Remove all edges connected to this node\n      const removedEdgeCount = edges.length;\n      const filteredEdges = edges.filter((e) => e.source !== nodeId && e.target !== nodeId);\n      const edgesRemoved = removedEdgeCount - filteredEdges.length;\n\n      const version = await saveNewVersion(invect, flowId, nodes, filteredEdges);\n\n      return {\n        success: true,\n        data: {\n          removedNodeId: nodeId,\n          removedLabel,\n          edgesRemoved,\n          versionNumber: version.version,\n          remainingNodeCount: nodes.length,\n        },\n        uiAction: {\n          action: 'refresh_flow',\n          data: { flowId },\n        },\n      };\n    } catch (error: unknown) {\n      return { success: false, error: `Failed to remove node: ${(error as Error).message}` };\n    }\n  },\n};\n\n// =====================================\n// update_node_config\n// =====================================\n\nexport const updateNodeConfigTool: ChatToolDefinition = {\n  id: 'update_node_config',\n  name: 'Update Node Config',\n  description:\n    'Update the configuration parameters of an existing node. ' +\n    'Merges the provided params into the existing config (does not replace unmentioned params). ' +\n    'Use this for targeted changes like \"change the JQ query\" or \"update the prompt\".',\n  parameters: z.object({\n    nodeId: z.string().describe('ID of the node to update'),\n    params: z\n      .record(z.string(), z.unknown())\n      .describe('Parameters to set or update (merged with existing)'),\n    label: z.string().optional().describe('Optionally update the node label too'),\n  }),\n  async execute(params: unknown, ctx: ChatToolContext): Promise<ChatToolResult> {\n    const {\n      nodeId,\n      params: newParams,\n      label,\n    } = params as {\n      nodeId: string;\n      params: Record<string, unknown>;\n      label?: string;\n    };\n    const invect = ctx.invect as Invect;\n    const flowId = ctx.chatContext.flowId;\n\n    if (!flowId) {\n      return { success: false, error: 'No flow is currently open' };\n    }\n\n    try {\n      const { nodes, edges } = await loadLatestDefinition(invect, flowId);\n\n      const node = nodes.find((n) => n.id === nodeId);\n      if (!node) {\n        return {\n          success: false,\n          error: `Node \"${nodeId}\" not found in flow`,\n          suggestion: 'Use get_current_flow_context to see available node IDs.',\n        };\n      }\n\n      // Merge params\n      const existingParams = node.params ?? {};\n      node.params = { ...existingParams, ...newParams };\n\n      // Update label if provided\n      if (label) {\n        node.label = label;\n        node.referenceId = labelToReferenceId(label);\n      }\n\n      const version = await saveNewVersion(invect, flowId, nodes, edges);\n\n      return {\n        success: true,\n        data: {\n          nodeId,\n          label: node.label,\n          updatedParams: Object.keys(newParams),\n          versionNumber: version.version,\n        },\n        uiAction: {\n          action: 'refresh_flow',\n          data: { flowId, selectNodeId: nodeId },\n        },\n      };\n    } catch (error: unknown) {\n      return { success: false, error: `Failed to update node: ${(error as Error).message}` };\n    }\n  },\n};\n\n// =====================================\n// connect_nodes\n// =====================================\n\nexport const connectNodesTool: ChatToolDefinition = {\n  id: 'connect_nodes',\n  name: 'Connect Nodes',\n  description:\n    'Create an edge between two nodes. Data flows from source to target. ' +\n    'Use sourceHandle/targetHandle for multi-output nodes like if-else (e.g. \"true_output\", \"false_output\").',\n  parameters: z.object({\n    sourceNodeId: z.string().describe('ID of the source node (data flows FROM here)'),\n    targetNodeId: z.string().describe('ID of the target node (data flows TO here)'),\n    sourceHandle: z\n      .string()\n      .optional()\n      .describe('Source handle for multi-output nodes (e.g. \"true_output\", \"false_output\")'),\n    targetHandle: z.string().optional().describe('Target handle (rarely needed)'),\n  }),\n  async execute(params: unknown, ctx: ChatToolContext): Promise<ChatToolResult> {\n    const { sourceNodeId, targetNodeId, sourceHandle, targetHandle } = params as {\n      sourceNodeId: string;\n      targetNodeId: string;\n      sourceHandle?: string;\n      targetHandle?: string;\n    };\n    const invect = ctx.invect as Invect;\n    const flowId = ctx.chatContext.flowId;\n\n    if (!flowId) {\n      return { success: false, error: 'No flow is currently open' };\n    }\n\n    try {\n      const { nodes, edges } = await loadLatestDefinition(invect, flowId);\n\n      // Validate both nodes exist\n      const source = nodes.find((n) => n.id === sourceNodeId);\n      const target = nodes.find((n) => n.id === targetNodeId);\n\n      if (!source) {\n        return {\n          success: false,\n          error: `Source node \"${sourceNodeId}\" not found`,\n          suggestion: 'Use get_current_flow_context to see available node IDs.',\n        };\n      }\n      if (!target) {\n        return {\n          success: false,\n          error: `Target node \"${targetNodeId}\" not found`,\n          suggestion: 'Use get_current_flow_context to see available node IDs.',\n        };\n      }\n\n      // Check for duplicate edge\n      const exists = edges.some(\n        (e) =>\n          e.source === sourceNodeId &&\n          e.target === targetNodeId &&\n          (e.sourceHandle ?? '') === (sourceHandle ?? '') &&\n          (e.targetHandle ?? '') === (targetHandle ?? ''),\n      );\n      if (exists) {\n        return {\n          success: true,\n          data: { message: 'Edge already exists — no change needed' },\n        };\n      }\n\n      edges.push({\n        id: `edge_${genId()}`,\n        source: sourceNodeId,\n        target: targetNodeId,\n        ...(sourceHandle && { sourceHandle }),\n        ...(targetHandle && { targetHandle }),\n      });\n\n      const version = await saveNewVersion(invect, flowId, nodes, edges);\n\n      return {\n        success: true,\n        data: {\n          edgeId: edges[edges.length - 1].id,\n          from: `${source.label ?? sourceNodeId}`,\n          to: `${target.label ?? targetNodeId}`,\n          versionNumber: version.version,\n        },\n        uiAction: {\n          action: 'refresh_flow',\n          data: { flowId },\n        },\n      };\n    } catch (error: unknown) {\n      return { success: false, error: `Failed to connect nodes: ${(error as Error).message}` };\n    }\n  },\n};\n\n// =====================================\n// Export all node tools\n// =====================================\n\nexport const nodeTools: ChatToolDefinition[] = [\n  addNodeTool,\n  removeNodeTool,\n  updateNodeConfigTool,\n  connectNodesTool,\n];\n"],"mappings":"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"}

package/dist/services/chat/tools/node-tools.js

@@ -0,0 +1,322 @@
+import { z } from "zod/v4";
+//#region src/services/chat/tools/node-tools.ts
+/**
+* Chat Tools — Node Editing
+*
+* Granular tools for adding, removing, connecting, and configuring individual nodes.
+* These operate on the latest flow version — they read, mutate, and save a new version.
+*
+* For bulk changes (new flows from scratch), use update_flow_definition instead.
+* These are for surgical edits: "add a Slack node after the HTTP request",
+* "change the JQ query", "remove the debug node".
+*/
+/**
+* Helper: Load the latest flow version's nodes and edges.
+*/
+async function loadLatestDefinition(invect, flowId) {
+	const version = await invect.getFlowVersion(flowId, "latest");
+	if (!version) throw new Error("No flow version found — publish a version first");
+	const definition = version.invectDefinition;
+	return {
+		nodes: structuredClone(definition.nodes),
+		edges: structuredClone(definition.edges),
+		version
+	};
+}
+/**
+* Helper: Save a mutated definition as a new flow version.
+*/
+async function saveNewVersion(invect, flowId, nodes, edges) {
+	return invect.createFlowVersion(flowId, { invectDefinition: {
+		nodes,
+		edges
+	} });
+}
+/**
+* Helper: Convert a label to a snake_case reference ID.
+*/
+function labelToReferenceId(label) {
+	return label.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_|_$/g, "");
+}
+/**
+* Helper: Generate a short unique ID for nodes/edges.
+*/
+function genId() {
+	return Math.random().toString(36).slice(2, 10);
+}
+const nodeTools = [
+	{
+		id: "add_node",
+		name: "Add Node",
+		description: "Add a new node to the current flow. Optionally connect it after an existing node. The node is positioned automatically. Use search_actions or get_action_details to find valid action IDs. For bulk flow creation, prefer update_flow_definition instead.",
+		parameters: z.object({
+			actionId: z.string().describe("Action type ID (e.g. \"core.model\", \"core.javascript\", \"gmail.send_message\", \"http.request\")"),
+			label: z.string().describe("Human-readable node label (e.g. \"Fetch User Emails\")"),
+			params: z.record(z.string(), z.unknown()).optional().default({}).describe("Node configuration parameters (key-value pairs)"),
+			connectAfter: z.string().optional().describe("Node ID to connect after — creates an edge from that node to this new one")
+		}),
+		async execute(params, ctx) {
+			const { actionId, label, params: nodeParams, connectAfter } = params;
+			const invect = ctx.invect;
+			const flowId = ctx.chatContext.flowId;
+			if (!flowId) return {
+				success: false,
+				error: "No flow is currently open"
+			};
+			try {
+				const availableNodes = invect.getAvailableNodes();
+				if (!availableNodes.find((n) => n.type === actionId)) {
+					const searchLower = actionId.toLowerCase();
+					const similar = availableNodes.filter((n) => n.type.toLowerCase().includes(searchLower.split(".").pop() ?? "")).slice(0, 5).map((n) => n.type);
+					return {
+						success: false,
+						error: `Action "${actionId}" not found in the action registry`,
+						suggestion: similar.length > 0 ? `Did you mean one of: ${similar.join(", ")}? Use search_actions to find valid action IDs.` : "Use search_actions to find valid action IDs."
+					};
+				}
+				const { nodes, edges } = await loadLatestDefinition(invect, flowId);
+				const nodeId = `node_${genId()}`;
+				const referenceId = labelToReferenceId(label);
+				let position = {
+					x: 250,
+					y: 100
+				};
+				if (connectAfter) {
+					const upstream = nodes.find((n) => n.id === connectAfter);
+					if (upstream?.position) position = {
+						x: upstream.position.x,
+						y: upstream.position.y + 150
+					};
+				} else if (nodes.length > 0) {
+					const lastNode = nodes[nodes.length - 1];
+					if (lastNode?.position) position = {
+						x: lastNode.position.x,
+						y: lastNode.position.y + 150
+					};
+				}
+				nodes.push({
+					id: nodeId,
+					type: actionId,
+					label,
+					referenceId,
+					params: nodeParams ?? {},
+					position
+				});
+				if (connectAfter) {
+					if (!nodes.find((n) => n.id === connectAfter)) return {
+						success: false,
+						error: `Cannot connect after node "${connectAfter}" — node not found`,
+						suggestion: "Use get_current_flow_context to see available node IDs."
+					};
+					edges.push({
+						id: `edge_${genId()}`,
+						source: connectAfter,
+						target: nodeId
+					});
+				}
+				return {
+					success: true,
+					data: {
+						nodeId,
+						label,
+						actionId,
+						referenceId,
+						versionNumber: (await saveNewVersion(invect, flowId, nodes, edges)).version,
+						connected: connectAfter ? {
+							from: connectAfter,
+							to: nodeId
+						} : void 0
+					},
+					uiAction: {
+						action: "refresh_flow",
+						data: {
+							flowId,
+							selectNodeId: nodeId
+						}
+					}
+				};
+			} catch (error) {
+				return {
+					success: false,
+					error: `Failed to add node: ${error.message}`,
+					suggestion: "Use search_actions to verify the action ID is valid."
+				};
+			}
+		}
+	},
+	{
+		id: "remove_node",
+		name: "Remove Node",
+		description: "Remove a node from the current flow. Also removes all edges connected to it. Use get_current_flow_context to find node IDs.",
+		parameters: z.object({ nodeId: z.string().describe("ID of the node to remove") }),
+		async execute(params, ctx) {
+			const { nodeId } = params;
+			const invect = ctx.invect;
+			const flowId = ctx.chatContext.flowId;
+			if (!flowId) return {
+				success: false,
+				error: "No flow is currently open"
+			};
+			try {
+				const { nodes, edges } = await loadLatestDefinition(invect, flowId);
+				const nodeIndex = nodes.findIndex((n) => n.id === nodeId);
+				if (nodeIndex === -1) return {
+					success: false,
+					error: `Node "${nodeId}" not found in flow`,
+					suggestion: "Use get_current_flow_context to see available node IDs."
+				};
+				const removedNode = nodes[nodeIndex];
+				const removedLabel = removedNode.label || removedNode.id;
+				nodes.splice(nodeIndex, 1);
+				const removedEdgeCount = edges.length;
+				const filteredEdges = edges.filter((e) => e.source !== nodeId && e.target !== nodeId);
+				return {
+					success: true,
+					data: {
+						removedNodeId: nodeId,
+						removedLabel,
+						edgesRemoved: removedEdgeCount - filteredEdges.length,
+						versionNumber: (await saveNewVersion(invect, flowId, nodes, filteredEdges)).version,
+						remainingNodeCount: nodes.length
+					},
+					uiAction: {
+						action: "refresh_flow",
+						data: { flowId }
+					}
+				};
+			} catch (error) {
+				return {
+					success: false,
+					error: `Failed to remove node: ${error.message}`
+				};
+			}
+		}
+	},
+	{
+		id: "update_node_config",
+		name: "Update Node Config",
+		description: "Update the configuration parameters of an existing node. Merges the provided params into the existing config (does not replace unmentioned params). Use this for targeted changes like \"change the JQ query\" or \"update the prompt\".",
+		parameters: z.object({
+			nodeId: z.string().describe("ID of the node to update"),
+			params: z.record(z.string(), z.unknown()).describe("Parameters to set or update (merged with existing)"),
+			label: z.string().optional().describe("Optionally update the node label too")
+		}),
+		async execute(params, ctx) {
+			const { nodeId, params: newParams, label } = params;
+			const invect = ctx.invect;
+			const flowId = ctx.chatContext.flowId;
+			if (!flowId) return {
+				success: false,
+				error: "No flow is currently open"
+			};
+			try {
+				const { nodes, edges } = await loadLatestDefinition(invect, flowId);
+				const node = nodes.find((n) => n.id === nodeId);
+				if (!node) return {
+					success: false,
+					error: `Node "${nodeId}" not found in flow`,
+					suggestion: "Use get_current_flow_context to see available node IDs."
+				};
+				node.params = {
+					...node.params ?? {},
+					...newParams
+				};
+				if (label) {
+					node.label = label;
+					node.referenceId = labelToReferenceId(label);
+				}
+				const version = await saveNewVersion(invect, flowId, nodes, edges);
+				return {
+					success: true,
+					data: {
+						nodeId,
+						label: node.label,
+						updatedParams: Object.keys(newParams),
+						versionNumber: version.version
+					},
+					uiAction: {
+						action: "refresh_flow",
+						data: {
+							flowId,
+							selectNodeId: nodeId
+						}
+					}
+				};
+			} catch (error) {
+				return {
+					success: false,
+					error: `Failed to update node: ${error.message}`
+				};
+			}
+		}
+	},
+	{
+		id: "connect_nodes",
+		name: "Connect Nodes",
+		description: "Create an edge between two nodes. Data flows from source to target. Use sourceHandle/targetHandle for multi-output nodes like if-else (e.g. \"true_output\", \"false_output\").",
+		parameters: z.object({
+			sourceNodeId: z.string().describe("ID of the source node (data flows FROM here)"),
+			targetNodeId: z.string().describe("ID of the target node (data flows TO here)"),
+			sourceHandle: z.string().optional().describe("Source handle for multi-output nodes (e.g. \"true_output\", \"false_output\")"),
+			targetHandle: z.string().optional().describe("Target handle (rarely needed)")
+		}),
+		async execute(params, ctx) {
+			const { sourceNodeId, targetNodeId, sourceHandle, targetHandle } = params;
+			const invect = ctx.invect;
+			const flowId = ctx.chatContext.flowId;
+			if (!flowId) return {
+				success: false,
+				error: "No flow is currently open"
+			};
+			try {
+				const { nodes, edges } = await loadLatestDefinition(invect, flowId);
+				const source = nodes.find((n) => n.id === sourceNodeId);
+				const target = nodes.find((n) => n.id === targetNodeId);
+				if (!source) return {
+					success: false,
+					error: `Source node "${sourceNodeId}" not found`,
+					suggestion: "Use get_current_flow_context to see available node IDs."
+				};
+				if (!target) return {
+					success: false,
+					error: `Target node "${targetNodeId}" not found`,
+					suggestion: "Use get_current_flow_context to see available node IDs."
+				};
+				if (edges.some((e) => e.source === sourceNodeId && e.target === targetNodeId && (e.sourceHandle ?? "") === (sourceHandle ?? "") && (e.targetHandle ?? "") === (targetHandle ?? ""))) return {
+					success: true,
+					data: { message: "Edge already exists — no change needed" }
+				};
+				edges.push({
+					id: `edge_${genId()}`,
+					source: sourceNodeId,
+					target: targetNodeId,
+					...sourceHandle && { sourceHandle },
+					...targetHandle && { targetHandle }
+				});
+				const version = await saveNewVersion(invect, flowId, nodes, edges);
+				return {
+					success: true,
+					data: {
+						edgeId: edges[edges.length - 1].id,
+						from: `${source.label ?? sourceNodeId}`,
+						to: `${target.label ?? targetNodeId}`,
+						versionNumber: version.version
+					},
+					uiAction: {
+						action: "refresh_flow",
+						data: { flowId }
+					}
+				};
+			} catch (error) {
+				return {
+					success: false,
+					error: `Failed to connect nodes: ${error.message}`
+				};
+			}
+		}
+	}
+];
+//#endregion
+export { nodeTools };
+
+//# sourceMappingURL=node-tools.js.map