@foresthubai/workflow-core 0.4.7 → 0.4.8

package/dist/deploy/requirements.d.ts

@@ -1,5 +1,5 @@
 import type { Workflow } from "../workflow";
-export type BindingKind = "hardware" | "mqtt" | "camera" | "declaredModel" | "catalogModel";
+export type BindingKind = "hardware" | "mqtt" | "camera" | "declaredModel" | "mlInference" | "catalogModel";
 export declare function workflowBindingRequirements(workflow: Workflow): Record<string, BindingKind>;
 /**
  * Model ids that Agent nodes reference but the workflow does not declare in

package/dist/deploy/requirements.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requirements.d.ts","sourceRoot":"","sources":["../../src/deploy/requirements.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAiB5C,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,eAAe,GAAG,cAAc,CAAC;AAoB5F,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAuC3F;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,EAAE,CAazE"}
+{"version":3,"file":"requirements.d.ts","sourceRoot":"","sources":["../../src/deploy/requirements.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAiB5C,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,eAAe,GAAG,aAAa,GAAG,cAAc,CAAC;AA0B5G,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAmD3F;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,EAAE,CAazE"}

package/dist/deploy/requirements.js

@@ -1,10 +1,15 @@
 // SPDX-License-Identifier: Apache-2.0
 // Copyright (c) 2026 ForestHub.
 // Drift sentinel: a new ChannelType breaks compilation here until it is
-// classified in workflowBindingRequirements' switch.
+// classified in workflowBindingRequirements' channel switch.
 function assertNeverChannel(t) {
     throw new Error(`unhandled channel type: ${String(t)}`);
 }
+// Drift sentinel: a new ModelType breaks compilation here until it is classified
+// in workflowBindingRequirements' model switch.
+function assertNeverModel(t) {
+    throw new Error(`unhandled model type: ${String(t)}`);
+}
 // workflowBindingRequirements returns the resources a deploy must bind, keyed by
 // workflow logical id — the binding surface. The TS twin of the backend's
 // deploy.WorkflowBindingRequirements: both must derive the SAME id->kind map from
@@ -42,11 +47,22 @@ export function workflowBindingRequirements(workflow) {
                 return assertNeverChannel(channel.type);
         }
     }
-    // Every declared model needs a source binding, LLM and ML alike. The surface
-    // does not distinguish the family — that split is a Stage-1 resolver concern.
-    // Mirrors the backend keying every declared model as "declaredModel".
-    for (const model of Object.values(workflow.models))
-        reqs[model.id] = "declaredModel";
+    // Every declared model needs a source binding, but of a different kind by family:
+    // an LLMModel binds a model source ("declaredModel"); an MLModel is served by an
+    // ml-inference component ("mlInference"). Mirrors the backend's workflowModelIDs
+    // split — both sides must agree on which kind each declared model gets.
+    for (const model of Object.values(workflow.models)) {
+        switch (model.type) {
+            case "LLMModel":
+                reqs[model.id] = "declaredModel";
+                break;
+            case "MLModel":
+                reqs[model.id] = "mlInference";
+                break;
+            default:
+                return assertNeverModel(model.type);
+        }
+    }
     // Catalog models: referenced by an Agent node but not declared. Keyed by model
     // id (canonical, matching the backend surface) — not collapsed to providers
     // here. getReferencedCatalogModelIds already excludes declared ids, so this

package/dist/deploy/requirements.js.map

@@ -1 +1 @@
-{"version":3,"file":"requirements.js","sourceRoot":"","sources":["../../src/deploy/requirements.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,gCAAgC;AA0BhC,wEAAwE;AACxE,qDAAqD;AACrD,SAAS,kBAAkB,CAAC,CAAQ;IAClC,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,iFAAiF;AACjF,0EAA0E;AAC1E,kFAAkF;AAClF,+EAA+E;AAC/E,iBAAiB;AACjB,EAAE;AACF,8DAA8D;AAC9D,mEAAmE;AACnE,4EAA4E;AAC5E,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,MAAM,UAAU,2BAA2B,CAAC,QAAkB;IAC5D,MAAM,IAAI,GAAgC,EAAE,CAAC;IAE7C,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvD,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,QAAQ,CAAC;YACd,KAAK,SAAS,CAAC;YACf,KAAK,KAAK,CAAC;YACX,KAAK,KAAK,CAAC;YACX,KAAK,KAAK,CAAC;YACX,KAAK,MAAM;gBACT,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC;gBAC9B,MAAM;YACR,KAAK,MAAM;gBACT,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;gBAC1B,MAAM;YACR,KAAK,QAAQ;gBACX,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC;gBAC5B,MAAM;YACR,KAAK,KAAK;gBACR,wEAAwE;gBACxE,MAAM;YACR;gBACE,OAAO,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,8EAA8E;IAC9E,sEAAsE;IACtE,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC;IAErF,+EAA+E;IAC/E,4EAA4E;IAC5E,4EAA4E;IAC5E,0CAA0C;IAC1C,KAAK,MAAM,EAAE,IAAI,4BAA4B,CAAC,QAAQ,CAAC;QAAE,IAAI,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC;IAEnF,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,QAAkB;IAC7D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAErC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;gBAAE,SAAS;YACpC,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAChC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC;AACzB,CAAC"}
+{"version":3,"file":"requirements.js","sourceRoot":"","sources":["../../src/deploy/requirements.ts"],"names":[],"mappings":"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"}

package/dist/node/AINode.d.ts

@@ -0,0 +1,31 @@
+import { NodeBase } from "./Node";
+import type { Reference, Schemas } from "../api";
+import { OutputBinding, OutputDeclaration } from "../parameter";
+import { NodeDefinition } from "./NodeDefinition";
+export type MemoryRef = Schemas["MemoryRef"];
+export interface AgentNode extends NodeBase {
+    type: "Agent";
+    arguments: {
+        name: string;
+        model: string;
+        instructions: string;
+        maxTurns: number | undefined;
+        outputDeclarations: OutputDeclaration[];
+        memoryRefs: MemoryRef[];
+        answer: OutputBinding;
+        toolDescription?: string;
+    };
+}
+export interface MLInferenceNode extends NodeBase {
+    type: "MLInference";
+    arguments: {
+        model: string;
+        input: Reference | undefined;
+        output: OutputBinding;
+    };
+}
+export type AINodeType = "Agent" | "MLInference";
+export type AINode = AgentNode | MLInferenceNode;
+export declare const AgentNodeDefinition: NodeDefinition;
+export declare const MLInferenceNodeDefinition: NodeDefinition;
+//# sourceMappingURL=AINode.d.ts.map

package/dist/node/AINode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AINode.d.ts","sourceRoot":"","sources":["../../src/node/AINode.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAE7C,MAAM,WAAW,SAAU,SAAQ,QAAQ;IACzC,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;QAC7B,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;QACxC,UAAU,EAAE,SAAS,EAAE,CAAC;QACxB,MAAM,EAAE,aAAa,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAMD,MAAM,WAAW,eAAgB,SAAQ,QAAQ;IAC/C,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;QAC7B,MAAM,EAAE,aAAa,CAAC;KACvB,CAAC;CACH;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,aAAa,CAAC;AACjD,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,eAAe,CAAC;AAIjD,eAAO,MAAM,mBAAmB,EAAE,cAyDjC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,cAqBvC,CAAC"}

package/dist/node/AINode.js

@@ -0,0 +1,85 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+import { NodeCategory } from "./constants";
+// Node Definitions
+export const AgentNodeDefinition = {
+    type: "Agent",
+    label: "LLM Agent",
+    category: NodeCategory.AI,
+    description: "AI-powered agent for intelligent processing",
+    canBranch: true, // Control output may fan out to multiple branches (tool output is always multi-target).
+    outputs: [
+        { id: "answer", label: "Answer", type: "static", dataType: "string" },
+        { id: "outputDeclarations", label: "Structured Output", type: "list" },
+    ],
+    parameters: [
+        {
+            id: "name",
+            label: "Name",
+            description: "Name of the agent",
+            optional: true,
+            type: "string",
+        },
+        {
+            id: "model",
+            label: "Model",
+            description: "AI model to use for the agent",
+            type: "modelSelect",
+            modelType: ["LLMModel"],
+            capabilities: ["chat"],
+        },
+        {
+            id: "instructions",
+            label: "Instructions",
+            description: "Instructions for the cloud agent that act as system prompt",
+            type: "string",
+            multiline: true,
+            optional: true,
+        },
+        {
+            id: "maxTurns",
+            label: "Max Turns",
+            description: "Maximum number of agent runner turns",
+            type: "int",
+            optional: true,
+        },
+        {
+            id: "memoryRefs",
+            label: "Memory Files",
+            description: "Project memory files this agent can access, with per-file read or read+write mode",
+            type: "memory-refs",
+            default: [],
+        },
+        {
+            id: "toolDescription",
+            label: "Tool Description",
+            description: "Description shown to the calling agent when this agent is wired as a tool",
+            type: "string",
+            multiline: true,
+            activationRules: [{ type: "isToolInput" }],
+        },
+    ],
+};
+export const MLInferenceNodeDefinition = {
+    type: "MLInference",
+    label: "ML Inference",
+    category: NodeCategory.AI,
+    description: "Runs a machine-learning model on an input and returns its result",
+    outputs: [{ id: "output", label: "Result", type: "static", dataType: "string" }],
+    parameters: [
+        {
+            id: "model",
+            label: "Model",
+            description: "ML model to run",
+            type: "modelSelect",
+            modelType: ["MLModel"],
+        },
+        {
+            id: "input",
+            label: "Input",
+            description: "Variable whose value is fed to the model",
+            type: "variableSelect",
+        },
+    ],
+};
+//# sourceMappingURL=AINode.js.map

package/dist/node/AINode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AINode.js","sourceRoot":"","sources":["../../src/node/AINode.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,gCAAgC;AAKhC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAmC3C,mBAAmB;AAEnB,MAAM,CAAC,MAAM,mBAAmB,GAAmB;IACjD,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,WAAW;IAClB,QAAQ,EAAE,YAAY,CAAC,EAAE;IACzB,WAAW,EAAE,6CAA6C;IAC1D,SAAS,EAAE,IAAI,EAAE,wFAAwF;IACzG,OAAO,EAAE;QACP,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE;QACrE,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,EAAE;KACvE;IACD,UAAU,EAAE;QACV;YACE,EAAE,EAAE,MAAM;YACV,KAAK,EAAE,MAAM;YACb,WAAW,EAAE,mBAAmB;YAChC,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,QAAQ;SACf;QACD;YACE,EAAE,EAAE,OAAO;YACX,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,+BAA+B;YAC5C,IAAI,EAAE,aAAa;YACnB,SAAS,EAAE,CAAC,UAAU,CAAC;YACvB,YAAY,EAAE,CAAC,MAAM,CAAC;SACvB;QACD;YACE,EAAE,EAAE,cAAc;YAClB,KAAK,EAAE,cAAc;YACrB,WAAW,EAAE,4DAA4D;YACzE,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,IAAI;SACf;QACD;YACE,EAAE,EAAE,UAAU;YACd,KAAK,EAAE,WAAW;YAClB,WAAW,EAAE,sCAAsC;YACnD,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,IAAI;SACf;QACD;YACE,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,cAAc;YACrB,WAAW,EAAE,mFAAmF;YAChG,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,EAAE;SACZ;QACD;YACE,EAAE,EAAE,iBAAiB;YACrB,KAAK,EAAE,kBAAkB;YACzB,WAAW,EAAE,2EAA2E;YACxF,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,IAAI;YACf,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;SAC3C;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAmB;IACvD,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,cAAc;IACrB,QAAQ,EAAE,YAAY,CAAC,EAAE;IACzB,WAAW,EAAE,kEAAkE;IAC/E,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAChF,UAAU,EAAE;QACV;YACE,EAAE,EAAE,OAAO;YACX,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,iBAAiB;YAC9B,IAAI,EAAE,aAAa;YACnB,SAAS,EAAE,CAAC,SAAS,CAAC;SACvB;QACD;YACE,EAAE,EAAE,OAAO;YACX,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,0CAA0C;YACvD,IAAI,EAAE,gBAAgB;SACvB;KACF;CACF,CAAC"}

package/dist/node/Node.d.ts

@@ -1,8 +1,7 @@
 import type { DataType } from "../api";
 import { InputNode, InputNodeType } from "./InputNode";
 import { OutputNode, OutputNodeType } from "./OutputNode";
-import { AgentNode, AgentNodeType } from "./AgentNode";
-import { MLInferenceNode, MLInferenceNodeType } from "./MLInferenceNode";
+import { AINode, AINodeType } from "./AINode";
 import { LogicNode, LogicNodeType } from "./LogicNode";
 import { DataNode, DataNodeType } from "./DataNode";
 import { TriggerNode, TriggerNodeType } from "./TriggerNode";
@@ -13,13 +12,13 @@ export type NodeOutput = {
     name: string;
     dataType: DataType;
 };
-export type NodeType = InputNodeType | OutputNodeType | AgentNodeType | MLInferenceNodeType | LogicNodeType | DataNodeType | TriggerNodeType | ToolNodeType | FunctionCallNodeType | MqttNodeType;
+export type NodeType = InputNodeType | OutputNodeType | AINodeType | LogicNodeType | DataNodeType | TriggerNodeType | ToolNodeType | FunctionCallNodeType | MqttNodeType;
 /**
  * NodeData represents the runtime data for a node in the workflow builder.
  * It is a union type of all specific node types, each with their own typed parameters.
  * Use this type when you need strong typing for a specific node.
  */
-export type NodeData = InputNode | OutputNode | AgentNode | MLInferenceNode | LogicNode | DataNode | TriggerNode | ToolNode | FunctionCallNode | MqttNode;
+export type NodeData = InputNode | OutputNode | AINode | LogicNode | DataNode | TriggerNode | ToolNode | FunctionCallNode | MqttNode;
 /**
  * Full domain node entity held on a {@link Canvas}: the {@link NodeData}
  * payload plus its canvas layout position, flattened. id/type/arguments/label

package/dist/node/Node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Node.d.ts","sourceRoot":"","sources":["../../src/node/Node.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC;AAC9D,MAAM,MAAM,QAAQ,GAChB,aAAa,GACb,cAAc,GACd,aAAa,GACb,mBAAmB,GACnB,aAAa,GACb,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,oBAAoB,GACpB,YAAY,CAAC;AAEjB;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAE1J;;;;;GAKG;AACH,MAAM,MAAM,IAAI,GAAG,QAAQ,GAAG;IAAE,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAErE;;;;;;;;;GASG;AACH,MAAM,WAAW,QAAS,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"Node.d.ts","sourceRoot":"","sources":["../../src/node/Node.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC;AAC9D,MAAM,MAAM,QAAQ,GAChB,aAAa,GACb,cAAc,GACd,UAAU,GACV,aAAa,GACb,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,oBAAoB,GACpB,YAAY,CAAC;AAEjB;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAErI;;;;;GAKG;AACH,MAAM,MAAM,IAAI,GAAG,QAAQ,GAAG;IAAE,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAErE;;;;;;;;;GASG;AACH,MAAM,WAAW,QAAS,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/node/NodeRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NodeRegistry.d.ts","sourceRoot":"","sources":["../../src/node/NodeRegistry.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;GAEG;AACH,cAAM,sBAAsB;IAC1B,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,WAAW,CAAS;IAE5B,UAAU;IAkCV,OAAO,CAAC,QAAQ;IAIhB,MAAM,IAAI,cAAc,EAAE;IAI1B,gBAAgB,IAAI,YAAY,EAAE;IAKlC,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS;IAIrD,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,cAAc,EAAE;CAGxD;AAGD,eAAO,MAAM,YAAY,wBAA+B,CAAC"}
+{"version":3,"file":"NodeRegistry.d.ts","sourceRoot":"","sources":["../../src/node/NodeRegistry.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;GAEG;AACH,cAAM,sBAAsB;IAC1B,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,WAAW,CAAS;IAE5B,UAAU;IAkCV,OAAO,CAAC,QAAQ;IAIhB,MAAM,IAAI,cAAc,EAAE;IAI1B,gBAAgB,IAAI,YAAY,EAAE;IAKlC,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS;IAIrD,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,cAAc,EAAE;CAGxD;AAGD,eAAO,MAAM,YAAY,wBAA+B,CAAC"}

package/dist/node/NodeRegistry.js

@@ -1,8 +1,7 @@
 // SPDX-License-Identifier: Apache-2.0
 // Copyright (c) 2026 ForestHub.
 import { ReadPinNodeDefinition, SerialReadNodeDefinition, RetrieverNodeDefinition, WebFetchNodeDefinition, CameraCaptureNodeDefinition } from "./InputNode";
-import { AgentNodeDefinition } from "./AgentNode";
-import { MLInferenceNodeDefinition } from "./MLInferenceNode";
+import { AgentNodeDefinition, MLInferenceNodeDefinition } from "./AINode";
 import { DelayNodeDefinition, TickerNodeDefinition, AlarmNodeDefinition, OnFunctionCallNodeDefinition, OnStartupNodeDefinition, OnPinEdgeNodeDefinition, OnSerialReceiveNodeDefinition, OnThresholdNodeDefinition, } from "./TriggerNode";
 import { WebSearchToolNodeDefinition } from "./ToolNode";
 import { SerialWriteNodeDefinition, WritePinNodeDefinition } from "./OutputNode";

package/dist/node/NodeRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"NodeRegistry.js","sourceRoot":"","sources":["../../src/node/NodeRegistry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"NodeRegistry.js","sourceRoot":"","sources":["../../src/node/NodeRegistry.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foresthubai/workflow-core",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "description": "Headless workflow types + serialization + pure validator. No React, no browser.",
   "license": "Apache-2.0",
   "repository": {

package/src/deploy/requirements.test.ts

@@ -94,9 +94,9 @@ describe("workflowBindingRequirements", () => {
     expect(workflowBindingRequirements(workflow({ channels: chs }))).toEqual({ led: "hardware" });
   });
 
-  it("maps every declared model to 'declaredModel', LLM and ML alike", () => {
+  it("splits declared models: LLMModel -> 'declaredModel', MLModel -> 'mlInference'", () => {
     const models = modelsById([llm("local-llm"), ml("yolo")]);
-    expect(workflowBindingRequirements(workflow({ models }))).toEqual({ "local-llm": "declaredModel", yolo: "declaredModel" });
+    expect(workflowBindingRequirements(workflow({ models }))).toEqual({ "local-llm": "declaredModel", yolo: "mlInference" });
   });
 
   it("maps a referenced-but-undeclared catalog model to 'catalogModel', keyed by model id", () => {
@@ -119,7 +119,7 @@ describe("workflowBindingRequirements", () => {
   it("produces the full surface for a mixed workflow", () => {
     const wf = workflow({
       channels: byId([channel("led", "GPIOOUT"), channel("telemetry", "MQTT"), channel("cam0", "CAMERA"), channel("log", "LOG")]),
-      models: modelsById([llm("local-llm")]),
+      models: modelsById([llm("local-llm"), ml("yolo")]),
       nodes: [agent("a1", "claude-sonnet")],
     });
     const expected: Record<string, BindingKind> = {
@@ -127,6 +127,7 @@ describe("workflowBindingRequirements", () => {
       telemetry: "mqtt",
       cam0: "camera",
       "local-llm": "declaredModel",
+      yolo: "mlInference",
       "claude-sonnet": "catalogModel",
     };
     expect(workflowBindingRequirements(wf)).toEqual(expected);

package/src/deploy/requirements.ts

@@ -14,23 +14,29 @@ import type { Workflow } from "../workflow";
 // CROSS-LANGUAGE SEAM: these string values MUST match the backend's
 // deploy.BindingRequirement constants (fh-backend deploy.WorkflowBindingRequirements),
 // which are themselves the ResourceBindingRequest discriminators
-// ("hardware"/"mqtt"/"declaredModel"/"catalogModel"/"rag"). A value that drifts
-// here silently disagrees with the backend about what a workflow needs bound.
+// ("hardware"/"mqtt"/"camera"/"declaredModel"/"mlInference"/"catalogModel"/"rag").
+// A value that drifts here silently disagrees with the backend about what a
+// workflow needs bound.
 //
-// Two deliberate asymmetries with the backend today, each a known catch-up:
-//  - "camera" is OSS-ahead: the backend's extractor predates the CAMERA channel
-//    and has no camera binding kind yet. OSS emits it; the backend will add it.
-//  - "rag" is absent: OSS is behind on retrieval — it does not yet extract a
-//    VectorDatabase memory resource as a requirement (the backend emits "rag").
-//    Add it when the OSS engine gains a retrieval backing.
-export type BindingKind = "hardware" | "mqtt" | "camera" | "declaredModel" | "catalogModel";
+// One deliberate asymmetry with the backend today: "rag" is absent. OSS is behind
+// on retrieval — it does not yet extract a VectorDatabase memory resource as a
+// requirement (the backend emits "rag"). A standalone engine has no retriever, so
+// such a workflow is refused at deploy; add "rag" here when the OSS engine gains a
+// retrieval backing.
+export type BindingKind = "hardware" | "mqtt" | "camera" | "declaredModel" | "mlInference" | "catalogModel";
 
 // Drift sentinel: a new ChannelType breaks compilation here until it is
-// classified in workflowBindingRequirements' switch.
+// classified in workflowBindingRequirements' channel switch.
 function assertNeverChannel(t: never): never {
   throw new Error(`unhandled channel type: ${String(t)}`);
 }
 
+// Drift sentinel: a new ModelType breaks compilation here until it is classified
+// in workflowBindingRequirements' model switch.
+function assertNeverModel(t: never): never {
+  throw new Error(`unhandled model type: ${String(t)}`);
+}
+
 // workflowBindingRequirements returns the resources a deploy must bind, keyed by
 // workflow logical id — the binding surface. The TS twin of the backend's
 // deploy.WorkflowBindingRequirements: both must derive the SAME id->kind map from
@@ -70,10 +76,22 @@ export function workflowBindingRequirements(workflow: Workflow): Record<string,
     }
   }
 
-  // Every declared model needs a source binding, LLM and ML alike. The surface
-  // does not distinguish the family — that split is a Stage-1 resolver concern.
-  // Mirrors the backend keying every declared model as "declaredModel".
-  for (const model of Object.values(workflow.models)) reqs[model.id] = "declaredModel";
+  // Every declared model needs a source binding, but of a different kind by family:
+  // an LLMModel binds a model source ("declaredModel"); an MLModel is served by an
+  // ml-inference component ("mlInference"). Mirrors the backend's workflowModelIDs
+  // split — both sides must agree on which kind each declared model gets.
+  for (const model of Object.values(workflow.models)) {
+    switch (model.type) {
+      case "LLMModel":
+        reqs[model.id] = "declaredModel";
+        break;
+      case "MLModel":
+        reqs[model.id] = "mlInference";
+        break;
+      default:
+        return assertNeverModel(model.type);
+    }
+  }
 
   // Catalog models: referenced by an Agent node but not declared. Keyed by model
   // id (canonical, matching the backend surface) — not collapsed to providers

package/src/diagnostics/diagnostics.test.ts

@@ -8,7 +8,7 @@ import type { FunctionDeclaration } from "../function";
 import { NodeCategory } from "../node";
 import { SetVariableNodeDefinition } from "../node/DataNode";
 import { RetrieverNodeDefinition } from "../node/InputNode";
-import { AgentNodeDefinition } from "../node/AgentNode";
+import { AgentNodeDefinition } from "../node/AINode";
 import { OnThresholdNodeDefinition } from "../node/TriggerNode";
 import { WebSearchToolNodeDefinition } from "../node/ToolNode";
 import {

package/src/node/{AgentNode.ts → AINode.ts}

@@ -1,85 +1,124 @@
-// SPDX-License-Identifier: Apache-2.0
-// Copyright (c) 2026 ForestHub.
-
-import { NodeBase } from "./Node";
-import { OutputBinding, OutputDeclaration } from "../parameter";
-import type { Schemas } from "../api";
-import { NodeCategory } from "./constants";
-import { NodeDefinition } from "./NodeDefinition";
-
-export type MemoryRef = Schemas["MemoryRef"];
-
-export interface AgentNode extends NodeBase {
-  type: "Agent";
-  arguments: {
-    name: string;
-    model: string;
-    instructions: string;
-    maxTurns: number | undefined;
-    outputDeclarations: OutputDeclaration[];
-    memoryRefs: MemoryRef[];
-    answer: OutputBinding;
-    toolDescription?: string;
-  };
-}
-
-export type AgentNodeType = "Agent";
-
-export const AgentNodeDefinition: NodeDefinition = {
-  type: "Agent",
-  label: "LLM Agent",
-  category: NodeCategory.AI,
-  description: "AI-powered agent for intelligent processing",
-  canBranch: true, // Control output may fan out to multiple branches (tool output is always multi-target).
-  outputs: [
-    { id: "answer", label: "Answer", type: "static", dataType: "string" },
-    { id: "outputDeclarations", label: "Structured Output", type: "list" },
-  ],
-  parameters: [
-    {
-      id: "name",
-      label: "Name",
-      description: "Name of the agent",
-      optional: true,
-      type: "string",
-    },
-    {
-      id: "model",
-      label: "Model",
-      description: "AI model to use for the agent",
-      type: "modelSelect",
-      modelType: ["LLMModel"],
-      capabilities: ["chat"],
-    },
-    {
-      id: "instructions",
-      label: "Instructions",
-      description: "Instructions for the cloud agent that act as system prompt",
-      type: "string",
-      multiline: true,
-      optional: true,
-    },
-    {
-      id: "maxTurns",
-      label: "Max Turns",
-      description: "Maximum number of agent runner turns",
-      type: "int",
-      optional: true,
-    },
-    {
-      id: "memoryRefs",
-      label: "Memory Files",
-      description: "Project memory files this agent can access, with per-file read or read+write mode",
-      type: "memory-refs",
-      default: [],
-    },
-    {
-      id: "toolDescription",
-      label: "Tool Description",
-      description: "Description shown to the calling agent when this agent is wired as a tool",
-      type: "string",
-      multiline: true,
-      activationRules: [{ type: "isToolInput" }],
-    },
-  ],
-};
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
+import { NodeBase } from "./Node";
+import type { Reference, Schemas } from "../api";
+import { OutputBinding, OutputDeclaration } from "../parameter";
+import { NodeCategory } from "./constants";
+import { NodeDefinition } from "./NodeDefinition";
+
+export type MemoryRef = Schemas["MemoryRef"];
+
+export interface AgentNode extends NodeBase {
+  type: "Agent";
+  arguments: {
+    name: string;
+    model: string;
+    instructions: string;
+    maxTurns: number | undefined;
+    outputDeclarations: OutputDeclaration[];
+    memoryRefs: MemoryRef[];
+    answer: OutputBinding;
+    toolDescription?: string;
+  };
+}
+
+// MLInference — runs a declared ML model on an input and returns its result.
+// The model is selected from the workflow's declared MLModels; the input is a
+// reference to a variable whose value is fed to the model, and the result is
+// emitted as a string.
+export interface MLInferenceNode extends NodeBase {
+  type: "MLInference";
+  arguments: {
+    model: string;
+    input: Reference | undefined;
+    output: OutputBinding;
+  };
+}
+
+export type AINodeType = "Agent" | "MLInference";
+export type AINode = AgentNode | MLInferenceNode;
+
+// Node Definitions
+
+export const AgentNodeDefinition: NodeDefinition = {
+  type: "Agent",
+  label: "LLM Agent",
+  category: NodeCategory.AI,
+  description: "AI-powered agent for intelligent processing",
+  canBranch: true, // Control output may fan out to multiple branches (tool output is always multi-target).
+  outputs: [
+    { id: "answer", label: "Answer", type: "static", dataType: "string" },
+    { id: "outputDeclarations", label: "Structured Output", type: "list" },
+  ],
+  parameters: [
+    {
+      id: "name",
+      label: "Name",
+      description: "Name of the agent",
+      optional: true,
+      type: "string",
+    },
+    {
+      id: "model",
+      label: "Model",
+      description: "AI model to use for the agent",
+      type: "modelSelect",
+      modelType: ["LLMModel"],
+      capabilities: ["chat"],
+    },
+    {
+      id: "instructions",
+      label: "Instructions",
+      description: "Instructions for the cloud agent that act as system prompt",
+      type: "string",
+      multiline: true,
+      optional: true,
+    },
+    {
+      id: "maxTurns",
+      label: "Max Turns",
+      description: "Maximum number of agent runner turns",
+      type: "int",
+      optional: true,
+    },
+    {
+      id: "memoryRefs",
+      label: "Memory Files",
+      description: "Project memory files this agent can access, with per-file read or read+write mode",
+      type: "memory-refs",
+      default: [],
+    },
+    {
+      id: "toolDescription",
+      label: "Tool Description",
+      description: "Description shown to the calling agent when this agent is wired as a tool",
+      type: "string",
+      multiline: true,
+      activationRules: [{ type: "isToolInput" }],
+    },
+  ],
+};
+
+export const MLInferenceNodeDefinition: NodeDefinition = {
+  type: "MLInference",
+  label: "ML Inference",
+  category: NodeCategory.AI,
+  description: "Runs a machine-learning model on an input and returns its result",
+  outputs: [{ id: "output", label: "Result", type: "static", dataType: "string" }],
+  parameters: [
+    {
+      id: "model",
+      label: "Model",
+      description: "ML model to run",
+      type: "modelSelect",
+      modelType: ["MLModel"],
+    },
+    {
+      id: "input",
+      label: "Input",
+      description: "Variable whose value is fed to the model",
+      type: "variableSelect",
+    },
+  ],
+};

package/src/node/Node.ts

@@ -12,8 +12,7 @@
 import type { DataType } from "../api";
 import { InputNode, InputNodeType } from "./InputNode";
 import { OutputNode, OutputNodeType } from "./OutputNode";
-import { AgentNode, AgentNodeType } from "./AgentNode";
-import { MLInferenceNode, MLInferenceNodeType } from "./MLInferenceNode";
+import { AINode, AINodeType } from "./AINode";
 import { LogicNode, LogicNodeType } from "./LogicNode";
 import { DataNode, DataNodeType } from "./DataNode";
 import { TriggerNode, TriggerNodeType } from "./TriggerNode";
@@ -25,8 +24,7 @@ export type NodeOutput = { name: string; dataType: DataType };
 export type NodeType =
   | InputNodeType
   | OutputNodeType
-  | AgentNodeType
-  | MLInferenceNodeType
+  | AINodeType
   | LogicNodeType
   | DataNodeType
   | TriggerNodeType
@@ -39,7 +37,7 @@ export type NodeType =
  * It is a union type of all specific node types, each with their own typed parameters.
  * Use this type when you need strong typing for a specific node.
  */
-export type NodeData = InputNode | OutputNode | AgentNode | MLInferenceNode | LogicNode | DataNode | TriggerNode | ToolNode | FunctionCallNode | MqttNode;
+export type NodeData = InputNode | OutputNode | AINode | LogicNode | DataNode | TriggerNode | ToolNode | FunctionCallNode | MqttNode;
 
 /**
  * Full domain node entity held on a {@link Canvas}: the {@link NodeData}

package/src/node/NodeRegistry.ts

@@ -2,8 +2,7 @@
 // Copyright (c) 2026 ForestHub.
 
 import { ReadPinNodeDefinition, SerialReadNodeDefinition, RetrieverNodeDefinition, WebFetchNodeDefinition, CameraCaptureNodeDefinition } from "./InputNode";
-import { AgentNodeDefinition } from "./AgentNode";
-import { MLInferenceNodeDefinition } from "./MLInferenceNode";
+import { AgentNodeDefinition, MLInferenceNodeDefinition } from "./AINode";
 import {
   DelayNodeDefinition,
   TickerNodeDefinition,

package/src/node/MLInferenceNode.ts

@@ -1,46 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-// Copyright (c) 2026 ForestHub.
-
-import { NodeBase } from "./Node";
-import type { Reference } from "../api";
-import { OutputBinding } from "../parameter";
-import { NodeCategory } from "./constants";
-import { NodeDefinition } from "./NodeDefinition";
-
-// MLInference — runs a declared ML model on an input and returns its result.
-// The model is selected from the workflow's declared MLModels; the input is a
-// reference to a variable whose value is fed to the model, and the result is
-// emitted as a string.
-export interface MLInferenceNode extends NodeBase {
-  type: "MLInference";
-  arguments: {
-    model: string;
-    input: Reference | undefined;
-    output: OutputBinding;
-  };
-}
-
-export type MLInferenceNodeType = "MLInference";
-
-export const MLInferenceNodeDefinition: NodeDefinition = {
-  type: "MLInference",
-  label: "ML Inference",
-  category: NodeCategory.AI,
-  description: "Runs a machine-learning model on an input and returns its result",
-  outputs: [{ id: "output", label: "Result", type: "static", dataType: "string" }],
-  parameters: [
-    {
-      id: "model",
-      label: "Model",
-      description: "ML model to run",
-      type: "modelSelect",
-      modelType: ["MLModel"],
-    },
-    {
-      id: "input",
-      label: "Input",
-      description: "Variable whose value is fed to the model",
-      type: "variableSelect",
-    },
-  ],
-};