@treenity/core 3.0.0 → 3.0.1

package/src/schema/generated/examples.demo.sensor.reading.json

@@ -0,0 +1,25 @@
+{
+  "$id": "examples.demo.sensor.reading",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "description": "A single sensor reading data point",
+  "properties": {
+    "ts": {
+      "type": "number",
+      "default": 0
+    },
+    "value": {
+      "type": "number",
+      "default": 0
+    },
+    "seq": {
+      "type": "number",
+      "default": 0
+    }
+  },
+  "required": [
+    "ts",
+    "value",
+    "seq"
+  ]
+}

package/src/schema/generated/flow.node.action.json

@@ -0,0 +1,61 @@
+{
+  "$id": "flow.node.action",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "Generic Treenity action bridge — execute any registered action",
+  "properties": {
+    "title": {
+      "type": "string",
+      "default": "Action"
+    },
+    "position": {
+      "type": "object",
+      "properties": {
+        "x": {
+          "type": "number"
+        },
+        "y": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "x",
+        "y"
+      ]
+    },
+    "targetPath": {
+      "type": "string",
+      "title": "Target node path in tree",
+      "default": ""
+    },
+    "targetType": {
+      "type": "string",
+      "title": "Target type (optional — for type+key resolution)",
+      "default": ""
+    },
+    "targetAction": {
+      "type": "string",
+      "title": "Action name to execute",
+      "default": ""
+    },
+    "dataTemplate": {
+      "type": "string",
+      "title": "Data template — {{varName}} interpolation, parsed as JSON",
+      "default": ""
+    },
+    "outputVar": {
+      "type": "string",
+      "title": "Variable name to store the action result",
+      "default": "actionResult"
+    }
+  },
+  "required": [
+    "title",
+    "position",
+    "targetPath",
+    "targetType",
+    "targetAction",
+    "dataTemplate",
+    "outputVar"
+  ]
+}

package/src/schema/generated/flow.node.code.json

@@ -0,0 +1,43 @@
+{
+  "$id": "flow.node.code",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "JavaScript code execution",
+  "properties": {
+    "title": {
+      "type": "string",
+      "default": "Code"
+    },
+    "position": {
+      "type": "object",
+      "properties": {
+        "x": {
+          "type": "number"
+        },
+        "y": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "x",
+        "y"
+      ]
+    },
+    "source": {
+      "type": "string",
+      "title": "JavaScript source — has access to `vars` object (all scenario variables)",
+      "default": ""
+    },
+    "outputVar": {
+      "type": "string",
+      "title": "Variable name to store the return value",
+      "default": "codeResult"
+    }
+  },
+  "required": [
+    "title",
+    "position",
+    "source",
+    "outputVar"
+  ]
+}

package/src/schema/generated/flow.node.condition.json

@@ -0,0 +1,37 @@
+{
+  "$id": "flow.node.condition",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "Conditional branching — evaluates expression, routes to different outputs",
+  "properties": {
+    "title": {
+      "type": "string",
+      "default": "Condition"
+    },
+    "position": {
+      "type": "object",
+      "properties": {
+        "x": {
+          "type": "number"
+        },
+        "y": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "x",
+        "y"
+      ]
+    },
+    "expression": {
+      "type": "string",
+      "title": "JavaScript expression evaluated against vars — truthy = 'true' port, falsy = 'false' port",
+      "default": ""
+    }
+  },
+  "required": [
+    "title",
+    "position",
+    "expression"
+  ]
+}

package/src/schema/generated/flow.node.end.json

@@ -0,0 +1,35 @@
+{
+  "$id": "flow.node.end",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "Exit point — maps variables to scenario output",
+  "properties": {
+    "title": {
+      "type": "string",
+      "default": "End"
+    },
+    "position": {
+      "type": "object",
+      "properties": {
+        "x": {
+          "type": "number"
+        },
+        "y": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "x",
+        "y"
+      ]
+    },
+    "outputMapping": {
+      "title": "Maps output field names to variable expressions"
+    }
+  },
+  "required": [
+    "title",
+    "position",
+    "outputMapping"
+  ]
+}

package/src/schema/generated/flow.node.http.json

@@ -0,0 +1,65 @@
+{
+  "$id": "flow.node.http",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "HTTP request with template interpolation",
+  "properties": {
+    "title": {
+      "type": "string",
+      "default": "HTTP"
+    },
+    "position": {
+      "type": "object",
+      "properties": {
+        "x": {
+          "type": "number"
+        },
+        "y": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "x",
+        "y"
+      ]
+    },
+    "url": {
+      "type": "string",
+      "title": "URL template — {{varName}} interpolation",
+      "default": ""
+    },
+    "method": {
+      "type": "string",
+      "enum": [
+        "GET",
+        "POST",
+        "PUT",
+        "DELETE",
+        "PATCH"
+      ],
+      "default": "GET"
+    },
+    "headers": {
+      "title": "JSON headers template"
+    },
+    "body": {
+      "type": "string",
+      "title": "Body template (for POST/PUT/PATCH)",
+      "default": ""
+    },
+    "outputVar": {
+      "type": "string",
+      "title": "Variable name to store response",
+      "default": "httpResult"
+    }
+  },
+  "required": [
+    "title",
+    "position",
+    "url",
+    "method",
+    "headers",
+    "body",
+    "outputVar"
+  ]
+}

package/src/schema/generated/flow.node.llm.json

@@ -0,0 +1,67 @@
+{
+  "$id": "flow.node.llm",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "LLM call — prompt template with variable interpolation",
+  "properties": {
+    "title": {
+      "type": "string",
+      "default": "LLM"
+    },
+    "position": {
+      "type": "object",
+      "properties": {
+        "x": {
+          "type": "number"
+        },
+        "y": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "x",
+        "y"
+      ]
+    },
+    "model": {
+      "type": "string",
+      "title": "LLM provider model identifier",
+      "default": ""
+    },
+    "prompt": {
+      "type": "string",
+      "title": "Prompt template — use {{varName}} for interpolation",
+      "default": ""
+    },
+    "system": {
+      "type": "string",
+      "title": "System prompt",
+      "default": ""
+    },
+    "temperature": {
+      "type": "number",
+      "title": "Sampling temperature",
+      "default": 0.7
+    },
+    "maxTokens": {
+      "type": "number",
+      "title": "Max output tokens",
+      "default": 1024
+    },
+    "outputVar": {
+      "type": "string",
+      "title": "Variable name to store the response",
+      "default": "llmResult"
+    }
+  },
+  "required": [
+    "title",
+    "position",
+    "model",
+    "prompt",
+    "system",
+    "temperature",
+    "maxTokens",
+    "outputVar"
+  ]
+}

package/src/schema/generated/flow.node.loop.json

@@ -0,0 +1,49 @@
+{
+  "$id": "flow.node.loop",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "Loop — iterates over a collection, executes downstream nodes per item",
+  "properties": {
+    "title": {
+      "type": "string",
+      "default": "Loop"
+    },
+    "position": {
+      "type": "object",
+      "properties": {
+        "x": {
+          "type": "number"
+        },
+        "y": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "x",
+        "y"
+      ]
+    },
+    "collection": {
+      "type": "string",
+      "title": "Expression that evaluates to an array (e.g. variable name or JS expression)",
+      "default": ""
+    },
+    "itemVar": {
+      "type": "string",
+      "title": "Variable name for current item",
+      "default": "item"
+    },
+    "indexVar": {
+      "type": "string",
+      "title": "Variable name for current index",
+      "default": "index"
+    }
+  },
+  "required": [
+    "title",
+    "position",
+    "collection",
+    "itemVar",
+    "indexVar"
+  ]
+}

package/src/schema/generated/flow.node.start.json

@@ -0,0 +1,39 @@
+{
+  "$id": "flow.node.start",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "Entry point — defines input variables for the scenario",
+  "properties": {
+    "title": {
+      "type": "string",
+      "default": "Start"
+    },
+    "position": {
+      "type": "object",
+      "properties": {
+        "x": {
+          "type": "number"
+        },
+        "y": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "x",
+        "y"
+      ]
+    },
+    "outputs": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "title": "Output variable names (populated from scenario input)"
+    }
+  },
+  "required": [
+    "title",
+    "position",
+    "outputs"
+  ]
+}

package/src/schema/generated/flow.scenario.json

@@ -0,0 +1,118 @@
+{
+  "$id": "flow.scenario",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "Visual workflow scenario — contains edges, variables, execution state",
+  "properties": {
+    "edges": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "source": {
+            "type": "string"
+          },
+          "target": {
+            "type": "string"
+          },
+          "sourcePort": {
+            "anyOf": [
+              {},
+              {
+                "type": "string"
+              }
+            ]
+          },
+          "targetPort": {
+            "anyOf": [
+              {},
+              {
+                "type": "string"
+              }
+            ]
+          }
+        },
+        "required": [
+          "source",
+          "target"
+        ]
+      },
+      "title": "Connections between child nodes"
+    },
+    "variables": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "string",
+              "number",
+              "boolean",
+              "object",
+              "array"
+            ]
+          },
+          "default": {}
+        },
+        "required": [
+          "name",
+          "type"
+        ]
+      },
+      "title": "Scenario-level variables with types"
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "idle",
+        "error",
+        "running",
+        "completed"
+      ],
+      "title": "Execution status",
+      "default": "idle"
+    },
+    "result": {
+      "title": "Last execution result"
+    },
+    "lastRun": {
+      "type": "number",
+      "title": "Last run timestamp",
+      "default": 0
+    },
+    "log": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "title": "Execution log (last N events)"
+    }
+  },
+  "required": [
+    "edges",
+    "variables",
+    "status",
+    "result",
+    "lastRun",
+    "log"
+  ],
+  "methods": {
+    "run": {
+      "arguments": [
+        {
+          "name": "data"
+        }
+      ],
+      "description": "Run a flow scenario — executes all nodes, writes result + log to scenario node"
+    },
+    "validate": {
+      "arguments": [],
+      "description": "Validate scenario graph — check for cycles, missing handlers, disconnected nodes"
+    }
+  }
+}