@cpwc/node-red-contrib-ai-intent 3.1.0-alpha

package/.eslintrc

@@ -0,0 +1,49 @@
+{
+  "root": true,
+  "globals": {
+    "monaco": true,
+    "RED": true
+  },
+  "env": {
+    "browser": true,
+    "commonjs": true,
+    "es2021": true,
+    "mocha": true,
+    "jquery": true
+  },
+  "extends": [
+    "eslint:recommended",
+    "standard"
+  ],
+  "plugins": [
+    "eslint-plugin-html",
+    "no-only-tests"
+  ],
+  "parserOptions": {
+    "ecmaVersion": 12
+  },
+  "rules": {
+    // Built-in rules
+    "indent": [
+      "error",
+      2
+    ],
+    "object-shorthand": [
+      "error"
+    ],
+    "no-console": [
+      "error",
+      {
+        "allow": [
+          "debug",
+          "info",
+          "warn",
+          "error"
+        ]
+      }
+    ],
+    // plugin:no-only-tests
+    "no-only-tests/no-only-tests": "error",
+    "n/no-callback-literal": 0
+  }
+}

package/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/node-red-contrib-ai-intent.iml" filepath="$PROJECT_DIR$/.idea/node-red-contrib-ai-intent.iml" />
+    </modules>
+  </component>
+</project>

package/.idea/node-red-contrib-ai-intent.iml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="WEB_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <excludeFolder url="file://$MODULE_DIR$/.tmp" />
+      <excludeFolder url="file://$MODULE_DIR$/temp" />
+      <excludeFolder url="file://$MODULE_DIR$/tmp" />
+    </content>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Michael Montaque
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.

package/README.md

@@ -0,0 +1,233 @@
+# AI Intent Version 3
+
+This is a collection of nodes to help enhance existing automations to be utilized by chatbots and take advantage of LLM's like GPT. There are 4 Nodes in this collection:
+
+> Note: This uses GPT's Chat Completion API which is now considered Legacy. If it becomes deprecated. I will do my best to update this to leverage something equivalent.
+### Breaking Changes
+
+#### v1 - v2
+There were changes under the hood how Intents are saved. This may cause some of your **Register Intent** and **Call Intent**
+nodes to become invalid. Usually opening and closing the configuration of the nodes and redeploying should work. 
+If this doesn't work, you may need to redo the nodes from the palette. 
+
+#### v2 - v3
+A lot of the nodes are being deprecated. The **User node**, **System Node**, **Response Node**, **Tool Node**, **Response Node**
+**ChatGPT Node**, **Gemini Node**, **LocalAI Node**. Instead, use the **LLM Chat node**. This node replaces all of those nodes.
+You can now write Function tools in the Register intent node which gives greater versatility.
+> **PLEASE MIGRATE YOUR AUTOMATIONS TO USE THE LLM CHAT NODE.**
+---
+
+## LLM Chat Node
+
+The **LLM Chat** node enables users to interact with a Large Language Model (LLM) and receive responses. It supports system and user messages, conversation tracking, and additional configuration options.
+> Watch tutorial: https://youtu.be/2Efb1X6F5UY
+---
+
+## **Important**
+To use this node, you need to configure the connection details. Consult the documentation for your chosen LLM platform (e.g., OpenAI, Ollama, Gemini) for specific instructions.
+
+---
+
+## **Inputs**
+
+### **1. Main Input (`msg.payload`)**
+The primary input for the LLM. It must include a `user` message and may optionally contain a `system` message.
+
+#### **Example:**
+```javascript
+msg.payload = {
+    system: "You are a helpful assistant.",
+    user: "What is the capital of Alaska?"
+};
+```
+- **`system`** (optional): Provides instructions to guide the model’s behavior.
+- **`user`** (required): Contains the user's query or command.
+
+---
+
+### **2. Additional Options (`msg.payload.options`)**
+Allows users to send extra parameters to customize LLM responses.
+
+#### **Example:**
+```javascript
+msg.payload = {
+    user: "What is the capital of Alaska? Respond using JSON.",
+    options: {
+        format: "json" // Example for Ollama
+    }
+};
+```
+
+The available options depend on the LLM platform and may include parameters such as:
+- **`temperature`**: Controls randomness.
+- **`max_tokens`**: Limits response length.
+- **`format`**: Defines response structure (e.g., JSON).
+
+Refer to the LLM's documentation for more details.
+
+---
+
+### **3. Clear Chat History (`msg.clearChatHistory`)**
+- **Type**: `boolean` (optional)
+- **Behavior**: If set to `true`, the conversation history will be cleared for the specified **Conversation Id**.
+
+#### **Example:**
+```javascript
+msg.clearChatHistory = true;
+```
+
+---
+
+## **Node Configuration**
+
+### **1. Conversation Id**
+- **Type**: `string`
+- **Description**: This value is used as a key to store and track conversation history. If multiple nodes share the same Conversation Id, they will share the same conversation context.
+- **If omitted**: Each call to the LLM will be independent, without historical context.
+
+---
+
+### **2. Tool Choice**
+Defines whether the LLM should use function calling.
+
+#### **Options:**
+- **`None`**: Disables tools; the LLM won’t use functions.
+- **`Automatic`**: Allows the LLM to decide when to use selected tools.
+- **`Required`**: Forces the LLM to use at least one selected tool.
+
+> **Note:** For Ollama, not all models support function calling.
+
+---
+
+### **3. Tools**
+- **Type**: `string`
+- **Description**: This field is populated by **Register Intent** nodes. It allows selecting one or more functions that the LLM can use.
+- **Behavior**: The LLM will consider calling the selected functions based on the **Tool Choice** setting.
+
+---
+
+## **System and User Messages**
+Messages must be passed in the `msg.payload` object:
+```javascript
+msg.payload = {
+    system: "You are a helpful assistant.",
+    user: "What is the capital of Alaska?"
+};
+```
+
+The **system message** is optional but helps set the LLM’s behavior. The **user message** is required for every interaction.
+
+To include additional response options:
+```javascript
+msg.payload = {
+    user: "What is the capital of Alaska? Respond using JSON.",
+    options: {
+        format: "json" // Example for Ollama
+    }
+};
+```
+
+---
+
+## **Summary**
+- Use `msg.payload` with `user` (required) and `system` (optional) messages.
+- Customize responses with `msg.payload.options`.
+- Set `msg.clearChatHistory = true` to reset conversation history.
+- Configure **Conversation Id** to maintain or separate conversation history.
+- Choose **Tool Choice** and **Tools** to enable function calling when supported.
+
+For more details, refer to the documentation of your selected LLM platform.
+
+
+
+---
+## Register Intent Node
+
+### Purpose
+The **Register Intent Node** allows users to define custom actions (intents) that can be triggered by the **Call Intent Node** or AI assistants like OpenAI.
+> Watch Tutorial: https://youtu.be/FvP04OToeLQ
+
+### Configuration
+- **Name (string):** A unique identifier for the intent (alphanumeric, underscores, hyphens, max 64 characters).
+- **Description (string):** A clear explanation of the intent’s purpose. If using AI assistants, this helps them understand when to trigger the intent.
+- **Advanced Mode (boolean):** Enables structured AI interactions using a JSON-based schema.
+- **Tool Schema (JSON, required if Advanced Mode is enabled):** Defines the expected parameters for AI-generated inputs.
+
+### Usage
+Place this node at the beginning of a flow to register an intent. Other flows or AI models can then call this intent dynamically. For AI integrations, ensure the description field is precise to improve intent recognition.
+
+### Example JSON Schema for OpenAI
+```json
+{
+    "type": "object",
+    "properties": {
+        "eventName": {
+            "type": "string",
+            "description": "Unique event identifier."
+        },
+        "eventTime": {
+            "type": "string",
+            "format": "date-time",
+            "description": "ISO8601 formatted event time."
+        },
+        "eventPayload": {
+            "type": "string",
+            "description": "Command for smart home actions."
+        }
+    },
+    "required": ["eventName", "eventTime"],
+    "additionalProperties": false
+}
+```
+
+### AI Platform Considerations
+Different AI platforms may have unique function calling mechanisms. Refer to the official documentation for specifics:
+- [OpenAI Function Calling](https://platform.openai.com/docs/guides/function-calling)
+- [Google Gemini API](https://ai.google.dev/gemini-api/docs/function-calling)
+- [Ollama Tool Support](https://ollama.com/blog/tool-support)
+
+---
+## Call Intent Node
+
+### Purpose
+The **Call Intent Node** is used to trigger an intent that has been previously registered using the **Register Intent Node**.
+
+### Configuration
+- **Name (string):** A label for the node.
+- **Registered Node Name (string):** Select from a dropdown list of available registered intents or pass the intent dynamically via `msg.payload.nodeName`.
+
+### Usage
+This node acts as a trigger for registered intents. It can:
+- Directly call an intent similar to a link node.
+- Be placed after an **LLM Chat Node**, allowing AI to determine which intent to execute dynamically.
+- Trigger multiple intents if the payload contains an array of intent names.
+
+#### Example Payload for Multiple Calls
+```json
+{
+    "payload": [
+        {"nodeName": "turn_on_lights"},
+        {"nodeName": "set_thermostat"}
+    ]
+}
+```
+
+---
+## LLM Chat Node
+
+### Purpose
+The **LLM Chat Node** integrates with various AI models to process and respond to natural language input dynamically.
+
+### Usage
+Place this node in a flow where dynamic AI-driven responses are required. It can:
+- Answer user queries.
+- Process input and pass structured responses to downstream nodes.
+- Work in conjunction with **Register Intent** and **Call Intent Nodes** to enable complex AI-driven automations.
+
+### Example Use Case
+A user asks: *"What’s the weather today?"*
+1. **LLM Chat Node** processes the request.
+2. If the AI determines a weather function is needed, it triggers a **Call Intent Node**.
+3. The **Call Intent Node** invokes a flow that retrieves weather data and returns a response.
+
+---

package/call-intent/icons/promotion-icon.svg

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg width="100%" height="100%" viewBox="0 0 513 512" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;">
+    <use xlink:href="#_Image1" x="70.593" y="80.545" width="370.865px" height="350.938px" transform="matrix(0.999637,0,0,0.999824,0,0)"/>
+    <defs>
+        <image id="_Image1" width="371px" height="351px" xlink:href="data:image/png;base64,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"/>
+    </defs>
+</svg>

package/call-intent/index.html

@@ -0,0 +1,114 @@
+<script type="text/javascript">
+    const DYNAMIC_OPTION = {value:"", label:"Use payload.nodeName"}   
+    
+
+    const getIntentOptions = (intents = []) => {
+        const options = intents
+            .filter(option => {
+                return option.type === "Register Intent" && !option.excludeFromOpenAi
+            }).map(intent => {
+                return { value: intent.id, label: intent.name}
+            })
+
+        options.push(DYNAMIC_OPTION)
+
+        return options
+    }
+    $.getJSON('registered-intents', function (data = RED.settings.callIntentRegistry) {
+        window.__intentOptions = getIntentOptions(data)
+        
+        initialize()
+    });
+
+
+    const initialize = () => {
+        RED.nodes.registerType("Call Intent", {
+            category: 'AI Intent',
+            color: '#1abc9c',
+            icon: "promotion-icon.svg",
+            defaults: {
+                name: { value: "" },
+                registeredNodeId: {
+                    value: getIntentOptions(RED.settings.callIntentRegistry),
+                    validate: (value) => {
+                        return window.__intentOptions.some(option => {
+                            return option.value === value
+                        })
+                    }
+                },
+            },
+            inputs: 1,
+            outputs: 0,
+
+            label: function () {
+                return this.name || "Call Intent";
+            },
+
+            oneditprepare: function () {
+                $("#node-input-message").typedInput({
+                    type: "str",
+                    types: ["str", "num", "bool", "json"],
+                    typeField: "#node-input-message-type"
+                })
+
+                 $.getJSON('registered-intents', function (data = RED.settings.callIntentRegistry) {
+                    window.__intentOptions = getIntentOptions(data)
+
+                    $("#node-input-registeredNodeId").typedInput({
+                         types: [
+                             {
+                                 value: "",
+                                 options: window.__intentOptions
+                             }
+                         ]
+                     })
+                });
+
+               
+            }
+
+        });
+    }
+    
+
+
+</script>
+
+<script type="text/html" data-template-name="Call Intent">
+    <div style="display: flex; justify-content: center; margin-bottom: 25px;">
+        <a href="https://youtu.be/FvP04OToeLQ" target="_blank" referrerpolicy="no-referrer" style="color: #f53b57"><i
+                class="fa fa-youtube"></i><span style="padding-left: 10px;">Watch
+                Call Intent Node Tutorial</span></a>
+    </div>
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-input-name" placeholder="Name">
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-registeredNodeId"><i class="fa fa-tag"></i> Registered Node Name</label>
+        <input type="text" id="node-input-registeredNodeId" placeholder="Name of registered node">
+    </div>
+
+</script>
+
+<script type="text/html" data-help-name="Call Intent">
+    <p>Triggers the Register Intent node that has the corresponding id.</p>
+    
+    <h3>Inputs</h3>
+    <dl class="message-properties">
+        <dt>Registered Node Name
+            <span class="property-type">string</span>
+        </dt>
+        <dd>Name of the registed intent node you want to trigger. For convenience you can choose the name from the 
+            the dropdown however, you can choose payload.nodeName to allow the node to read the
+            intent name from the msg object - <code>msg.payload.nodeName</code>. This function can also fire multiple times 
+            if the payload is an array of the objects with nodeName <code>msg.payload = [{nodeName: "fake_name"}]</code>.
+        </dd>
+    </dl>
+
+    <h3>Details</h3>
+    <p>This node can be used as a standalone way to trigger custom intents (this will act very similar to the link in/out nodes)
+        or this node can be used immediately after the <code>OpenAI Response</code> node. If used after the aforementioned node
+        OpenAI can dynamically trigger any registered intents.</p>
+</script>

package/call-intent/index.js

@@ -0,0 +1,110 @@
+const PubSub = require("pubsub-js");
+const { end, ContextDatabase } = require("../globalUtils");
+const { TYPES} = require("../constants");
+
+/**
+ * Searches context for an object whose `name` or `id` property matches the given name parameter
+ * and returns the matching object.
+ * @param {string} name
+ * @param {Record<string, object>} context
+ * @returns
+ */
+const getMatchingIntentFromContext = (nameOrID = "", context) => {
+  return Object.values(context).find((intent) => {
+    return (
+      (intent.name === nameOrID || intent.id === nameOrID) &&
+      intent.type === TYPES.RegisterIntent
+    );
+  });
+};
+
+/**
+ * Fires the callback with either an error string or with the node matching the `nameOrId` value
+ * from the context.
+ * @param {string} nameOrId
+ * @param {object} context
+ * @param {function} callback
+ */
+const getNode = (nameOrId, context, callback) => {
+  const node = getMatchingIntentFromContext(nameOrId, context);
+  if (!nameOrId) {
+    callback("payload is missing nodeName property");
+  } else if (!node) {
+    callback(`There is no registered intent with name or id of "${nameOrId}"`);
+  } else {
+    callback(null, node);
+  }
+};
+
+const normalizeNames = (intents = []) => {
+  return intents.map((intent) => {
+    if (!intent.name && intent.type === TYPES.OpenAITool) {
+      const tool = JSON.parse(intent.tool);
+      return { ...intent, name: tool.function.name };
+    }
+    return intent;
+  });
+};
+
+module.exports = function (RED) {
+  const nodeDB = new ContextDatabase(RED);
+
+  function CallIntentHandlerNode(config) {
+    RED.nodes.createNode(this, config);
+    const node = this;
+
+    this.on("input", function (msg, send, done = () => {}) {
+      const nodeStore = nodeDB.getNodeStore();
+      const { registeredNodeId = "" } = config;
+
+      send =
+        send ||
+        function () {
+          node.send.apply(node, arguments);
+        };
+
+      if (Array.isArray(msg.payload)) {
+        msg.payload.forEach((payload, index) => {
+          const { nodeName } = payload;
+          const body = {...msg, index}
+          getNode(nodeName, nodeStore, (err, registeredNode) => {
+            if (err) {
+              node.warn(err);
+            } else {
+              PubSub.publishSync(registeredNode.id, body);
+              send(body);
+            }
+          });
+        });
+      }
+      else {
+        const nameOrId = msg.payload?.nodeName || registeredNodeId;
+
+        getNode(nameOrId, nodeStore, (err, registeredNode) => {
+          if (err) {
+            node.warn(err);
+          } else {
+            PubSub.publishSync(registeredNode.id, msg);
+            send(msg);
+          }
+        });
+      }
+      end(done);
+    });
+  }
+
+  RED.httpAdmin.get("/registered-intents", function (req, res) {
+    const nodeStore = nodeDB.getNodeStore();
+    const intents = normalizeNames(Object.values(nodeStore))
+    res.json(intents);
+  });
+
+  RED.nodes.registerType(TYPES.CallIntent, CallIntentHandlerNode, {
+    settings: {
+      callIntentRegistry: {
+        value: [],
+        exportable: true,
+      },
+    },
+  });
+};

package/constants.js

@@ -0,0 +1,31 @@
+module.exports = {
+  OPEN_AI_KEY: "openaiAPIKey",
+  GEMINI_AI_KEY: "geminiaiAPIKey",
+  LOCAL_STORAGE_PATH: "localStoragePath",
+  INTENT_STORE: "intent_store",
+  ACTIVE_CONVERSATION: "active_conversation_context",
+  CONVERSATION_CONTEXT: "conversation_context",
+  TYPES: {
+    RegisterIntent: "Register Intent",
+    CallIntent: "Call Intent",
+    OpenAIChat: "OpenAI Chat",
+    LLMChat: "LLM Chat",
+    LocalAIChat: "LocalAI Chat",
+    GeminiaiChat: "GeminiAI Chat",
+    OpenAITool: "OpenAI Tool",
+    OpenAIUser: "OpenAI User",
+    OpenAISystem: "OpenAI System",
+    OpenAIResponse: "OpenAI Response",
+  },
+  ROLES: {
+    User: "user",
+    System: "system",
+    Assistant: "assistant",
+  },
+  TOOL_CHOICE: {
+    Any: "any",
+    None: "none",
+    Auto: "auto",
+    Required: "required"
+  },
+};

package/database.js

@@ -0,0 +1,9 @@
+if (typeof localStorage === "undefined" || localStorage === null) {
+  var LocalStorage = require("node-localstorage").LocalStorage;
+}
+
+const getStorageAtLocation = (location = "./localstore") => {
+  return new LocalStorage(location);
+}
+
+module.exports = { getStorageAtLocation };