node-red-contrib-ai-agent 0.5.4 → 0.5.6

package/agent/ai-agent.html

@@ -18,7 +18,7 @@
     },
     inputs: 1,
     outputs: 1,
-    icon: 'agent/ai-agent-icon.svg',
+    icon: 'font-awesome/fa-user',
     label: function() {
       return this.name || 'AI Agent';
     },

package/model/ai-model.html

@@ -3,7 +3,7 @@
         category: 'AI Agent',
         inputs: 1,
         outputs: 1,
-        icon: 'model/ai-model-icon.svg',
+        icon: 'font-awesome/fa-cogs',
         paletteLabel: 'AI Model',
         label: function() {
             return this.name || 'AI Model';

package/orchestrator/orchestrator.html

@@ -13,7 +13,7 @@
         outputLabels: ["Final Result"],
         icon: "font-awesome/fa-sitemap",
         label: function () {
-            return this.name || "ai orchestrator";
+            return this.name || "AI Orchestrator";
         },
         paletteLabel: "AI Orchestrator"
     });

package/orchestrator-agent/orchestrator-agent.html

@@ -15,11 +15,11 @@
         },
         inputs: 1,
         outputs: 1,
-        icon: 'agent/ai-agent-icon.svg',
+        icon: 'font-awesome/fa-sitemap',
         label: function () {
             return this.name || 'AI Orchestrator Agent';
         },
-        paletteLabel: 'Orchestrator Agent',
+        paletteLabel: 'AI Orchestrator Agent',
         oneditprepare: function () {
         }
     });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "node-red-contrib-ai-agent",
-    "version": "0.5.4",
+    "version": "0.5.6",
     "description": "AI Agent for Node-RED",
     "repository": {
         "type": "git",
@@ -34,6 +34,7 @@
         "orchestrator/*",
         "orchestrator-agent/*",
         "tool/*",
+        "tool-approval/*",
         "tool-function/*",
         "tool-http/*"
     ],

package/tool-approval/ai-tool-approval.html

@@ -0,0 +1,59 @@
+<script type="text/javascript">
+    RED.nodes.registerType('ai-tool-approval', {
+        category: 'AI Agent',
+        color: '#FFCC00',
+        defaults: {
+            name: { value: "" },
+            toolName: { value: "human_approval", required: true },
+            description: { value: "Ask a human for approval or information.", required: true }
+        },
+        inputs: 1,
+        outputs: 2,
+        outputLabels: ["agent flow", "approval requests"],
+        icon: "font-awesome/fa-user-check",
+        label: function () {
+            return this.name || this.toolName || "Approval Tool";
+        },
+        paletteLabel: "approval tool"
+    });
+</script>
+
+<script type="text/html" data-template-name="ai-tool-approval">
+    <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-toolName"><i class="fa fa-code"></i> Tool Name</label>
+        <input type="text" id="node-input-toolName" placeholder="human_approval">
+    </div>
+    <div class="form-row">
+        <label for="node-input-description"><i class="fa fa-comment"></i> Description</label>
+        <textarea id="node-input-description" rows="3" style="width:70%;" placeholder="Request human intervention..."></textarea>
+    </div>
+    <div class="form-tips">
+        <b>Tip:</b> This node creates a tool that the AI can call to pause execution and wait for human input.
+        Link the second output to a UI or notification node, and feed the response back into the input of this node.
+    </div>
+</script>
+
+<script type="text/html" data-help-name="ai-tool-approval">
+    <p>Registers a human-in-the-loop approval tool with the AI Agent.</p>
+    
+    <h3>Configuration</h3>
+    <dl class="message-properties">
+        <dt>Tool Name <span class="property-type">string</span></dt>
+        <dd>The name the LLM will see (e.g., 'approve_purchase').</dd>
+        <dt>Description <span class="property-type">string</span></dt>
+        <dd>Guidance for the LLM on when and why to use this tool.</dd>
+    </dl>
+
+    <h3>Functionality</h3>
+    <p>When the AI calls this tool:</p>
+    <ol>
+        <li>The Agent's execution pauses.</li>
+        <li>A request message is sent out of the <b>second output</b>.</li>
+        <li>The node waits for an input message containing the human's response in <code>msg.payload</code>.</li>
+        <li>Once received, the Agent resumes with the human's input as the tool's result.</li>
+    </ol>
+</script>

package/tool-approval/ai-tool-approval.js

@@ -0,0 +1,102 @@
+module.exports = function (RED) {
+    'use strict';
+
+    function AIToolApprovalNode(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+
+        // Configuration
+        node.name = config.name || 'human_approval_tool';
+        node.toolName = config.toolName || `approve_${Date.now()}`;
+        node.description = config.description || 'Request human approval or intervention before proceeding';
+
+        // Registry for pending approvals
+        node.pendingApprovals = new Map();
+
+        // Process incoming "human" messages (approvals/denials)
+        node.on('input', function (msg, send, done) {
+            // Check if this is a response to a pending approval
+            const approvalId = msg.approvalId || 'default';
+            if (node.pendingApprovals.has(approvalId)) {
+                const resolver = node.pendingApprovals.get(approvalId);
+                node.pendingApprovals.delete(approvalId);
+
+                node.status({ fill: 'green', shape: 'dot', text: 'Approved' });
+                resolver(msg.payload);
+                if (done) done();
+                return;
+            }
+
+            // Normal operation: Register tool
+            try {
+                const newMsg = RED.util.cloneMessage(msg);
+                newMsg.aiagent = newMsg.aiagent || {};
+                newMsg.aiagent.tools = newMsg.aiagent.tools || [];
+
+                const toolDef = {
+                    type: 'function',
+                    function: {
+                        name: node.toolName,
+                        description: node.description,
+                        parameters: {
+                            type: 'object',
+                            properties: {
+                                reason: {
+                                    type: 'string',
+                                    description: 'The reason why human intervention is required'
+                                },
+                                question: {
+                                    type: 'string',
+                                    description: 'The specific question or prompt for the human'
+                                }
+                            },
+                            required: ['reason', 'question']
+                        }
+                    },
+                    execute: async (args) => {
+                        const approvalId = Date.now().toString();
+                        node.status({ fill: 'yellow', shape: 'dot', text: 'Waiting for approval...' });
+
+                        // Send request to output 2
+                        node.send([null, {
+                            payload: args,
+                            approvalId: approvalId,
+                            topic: 'approval_request'
+                        }]);
+
+                        // Return a promise that resolves when the input is received
+                        return new Promise((resolve) => {
+                            node.pendingApprovals.set(approvalId, resolve);
+
+                            // Timeout handling (optional)
+                            setTimeout(() => {
+                                if (node.pendingApprovals.has(approvalId)) {
+                                    node.pendingApprovals.delete(approvalId);
+                                    node.status({ fill: 'red', shape: 'dot', text: 'Timed out' });
+                                    resolve({ status: 'rejected', error: 'Approval timed out' });
+                                }
+                            }, 300000); // 5 minutes timeout
+                        });
+                    }
+                };
+
+                newMsg.aiagent.tools.push(toolDef);
+                node.status({ fill: 'green', shape: 'dot', text: 'Ready' });
+                send([newMsg, null]);
+                if (done) done();
+            } catch (error) {
+                node.status({ fill: 'red', shape: 'ring', text: 'Error' });
+                node.error('Error in AI Tool Approval node: ' + error.message, msg);
+                if (done) done();
+            }
+        });
+
+        node.on('close', function (done) {
+            node.status({});
+            node.pendingApprovals.clear();
+            if (done) done();
+        });
+    }
+
+    RED.nodes.registerType('ai-tool-approval', AIToolApprovalNode);
+};

package/agent/ai-agent-icon.svg

@@ -1,11 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<svg width="100" height="100" viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg">
-    <defs>
-        <linearGradient id="agentGradient" x1="0%" y1="0%" x2="100%" y2="100%">
-            <stop offset="0%" style="stop-color:#4a90e2;stop-opacity:1" />
-            <stop offset="100%" style="stop-color:#7b68ee;stop-opacity:1" />
-        </linearGradient>
-    </defs>
-    <circle cx="50" cy="50" r="45" fill="url(#agentGradient)" stroke="#3a7bc8" stroke-width="2"/>
-    <path d="M35 40 Q50 25 65 40 M35 60 Q50 75 65 60" stroke="white" stroke-width="5" stroke-linecap="round" fill="none"/>
-</svg>