node-red-contrib-ai-agent 0.5.16 → 0.5.17

package/orchestrator/orchestrator.html

@@ -13,8 +13,8 @@
             debug: { value: false }
         },
         inputs: 1,
-        outputs: 1,
-        outputLabels: ["Final Result"],
+        outputs: 2,
+        outputLabels: ["Success", "Failure"],
         icon: "font-awesome/fa-sitemap",
         label: function () {
             return this.name || "AI Orchestrator";
@@ -76,16 +76,20 @@
 
     <h3>Outputs</h3>
     <ol class="node-ports">
-        <li>Task Dispatch
+        <li>Success
             <dl class="message-properties">
-                <dt>msg.payload <span class="property-type">string</span></dt>
-                <dd>The instruction for the next task.</dd>
+                <dt>msg.payload <span class="property-type">string | object</span></dt>
+                <dd>The final successful result once the plan completes.</dd>
+                <dt>msg.orchestration <span class="property-type">object</span></dt>
+                <dd>Complete orchestration metadata and history.</dd>
             </dl>
         </li>
-        <li>Final Result
+        <li>Failure
             <dl class="message-properties">
+                 <dt>msg.error <span class="property-type">string</span></dt>
+                 <dd>Error message explaining why orchestration failed.</dd>
                  <dt>msg.orchestration <span class="property-type">object</span></dt>
-                 <dd>The full orchestration history and final result status.</dd>
+                 <dd>Orchestration state including failure details.</dd>
             </dl>
         </li>
     </ol>
@@ -98,5 +102,5 @@
         <li><strong>Priorities:</strong> Tasks with higher <code>priority</code> numbers are executed first.</li>
         <li><strong>Error Recovery:</strong> If a task fails, the orchestrator reflects on the error and can revise the plan to retry or try an alternative approach.</li>
     </ul>
-    <p>When the goal is achieved or max iterations are reached, the final message is sent to the second output.</p>
+    <p>The first output fires when the orchestration succeeds. All failure paths (validation errors, missing agents, iteration limits, plan errors, etc.) send a message out of the second output with <code>msg.error</code> describing the issue.</p>
 </script>

package/orchestrator/orchestrator.js

@@ -64,9 +64,11 @@ module.exports = function (RED) {
                 msg.orchestration._running = true;
                 setImmediate(() => processNextStep(RED, node, msg, send, done));
             } catch (error) {
-                node.status({ fill: 'red', shape: 'ring', text: 'error' });
                 node.error(error.message, msg);
-                if (done) done(error);
+                msg.orchestration = msg.orchestration || {};
+                msg.orchestration.status = 'failed';
+                msg.orchestration.error = error && error.message ? error.message : String(error);
+                finalizeOrchestration(node, msg, send, done, error);
             }
         });
     }
@@ -155,9 +157,25 @@ module.exports = function (RED) {
     }
 
     function finalizeOrchestration(node, msg, send, done, error) {
+        send = send || function () { node.send.apply(node, arguments) };
+        msg.orchestration = msg.orchestration || {};
         msg.orchestration._running = false;
-        node.status({ fill: msg.orchestration.status === 'completed' ? 'green' : 'red', shape: 'dot', text: msg.orchestration.status });
-        send(msg);
+
+        const isSuccess = msg.orchestration.status === 'completed';
+        if (!isSuccess) {
+            const errorMessage = msg.orchestration.error || (error && error.message) || msg.error || 'Unknown error';
+            msg.error = errorMessage;
+            msg.orchestration.error = errorMessage;
+        }
+
+        node.status({
+            fill: isSuccess ? 'green' : 'red',
+            shape: 'dot',
+            text: msg.orchestration.status || (isSuccess ? 'completed' : 'failed')
+        });
+
+        const outputs = isSuccess ? [msg, null] : [null, msg];
+        send(outputs);
         if (done) done(error);
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "node-red-contrib-ai-agent",
-    "version": "0.5.16",
+    "version": "0.5.17",
     "description": "AI Agent for Node-RED",
     "repository": {
         "type": "git",