@foresthubai/workflow-core 0.3.0 → 0.4.0

package/src/parameter/index.ts

@@ -1,33 +1,33 @@
-export type {
-  DataType,
-  FromArgs,
-  ParameterBase,
-  BasicParam,
-  StringParam,
-  BoolParam,
-  WeekdaysParam,
-  SelectionParam,
-  ExpressionParam,
-  VariableSelectParam,
-  ModelSelectParam,
-  ChannelSelectParam,
-  MemorySelectParam,
-  MemoryRefsParam,
-  ReferenceSelectParam,
-  Parameter,
-  ActivationRule,
-} from "./Parameter";
-export {
-  unwrapFromArgs,
-  isReferenceSelectParam,
-  isParameterActive,
-  isEmpty,
-  pruneArguments,
-  resolveExpressionType,
-  resolveCapabilities,
-  resolveChannelTypes,
-  resolveMemoryTypes,
-  resolveModelTypes,
-} from "./Parameter";
-export type { OutputBinding, OutputDeclaration, StaticOutput, OutputList, OutputParameter } from "./OutputParameter";
-export { resolveStaticOutputDataType } from "./OutputParameter";
+export type {
+  DataType,
+  FromArgs,
+  ParameterBase,
+  BasicParam,
+  StringParam,
+  BoolParam,
+  WeekdaysParam,
+  SelectionParam,
+  ExpressionParam,
+  VariableSelectParam,
+  ModelSelectParam,
+  ChannelSelectParam,
+  MemorySelectParam,
+  MemoryRefsParam,
+  ReferenceSelectParam,
+  Parameter,
+  ActivationRule,
+} from "./Parameter";
+export {
+  unwrapFromArgs,
+  isReferenceSelectParam,
+  isParameterActive,
+  isEmpty,
+  pruneArguments,
+  resolveExpressionType,
+  resolveCapabilities,
+  resolveChannelTypes,
+  resolveMemoryTypes,
+  resolveModelTypes,
+} from "./Parameter";
+export type { OutputBinding, OutputDeclaration, StaticOutput, OutputList, OutputParameter } from "./OutputParameter";
+export { resolveStaticOutputDataType } from "./OutputParameter";

package/src/variable/Variable.ts

@@ -1,10 +1,10 @@
-import type { Schemas } from "../api";
-import type { DataType } from "../api";
-
-export type ApiVariable = Schemas["Variable"]; // Differentiate from domain variable type
-
-export type NodeOutputVariable = { kind: "node"; nodeId: string; outputId: string; name: string; dataType: DataType };
-export type DeclaredVariable = { kind: "declared"; uid: string; name: string; dataType: DataType; initialValue?: unknown };
-export type FunctionArgVariable = { kind: "fnarg"; uid: string; name: string; dataType: DataType };
-
-export type Variable = NodeOutputVariable | DeclaredVariable | FunctionArgVariable;
+import type { Schemas } from "../api";
+import type { DataType } from "../api";
+
+export type ApiVariable = Schemas["Variable"]; // Differentiate from domain variable type
+
+export type NodeOutputVariable = { kind: "node"; nodeId: string; outputId: string; name: string; dataType: DataType };
+export type DeclaredVariable = { kind: "declared"; uid: string; name: string; dataType: DataType; initialValue?: unknown };
+export type FunctionArgVariable = { kind: "fnarg"; uid: string; name: string; dataType: DataType };
+
+export type Variable = NodeOutputVariable | DeclaredVariable | FunctionArgVariable;

package/src/variable/index.ts

@@ -1,16 +1,16 @@
-// Public surface of the variable module. The discriminated-union types live in
-// ./Variable; the key/lookup/uid helpers and availability computation live in
-// ./operations. This file is a barrel only. Mirrors channel/memory/model.
-
-export type { ApiVariable, NodeOutputVariable, DeclaredVariable, FunctionArgVariable, Variable } from "./Variable";
-export {
-  varKey,
-  declaredVarKey,
-  fnargKey,
-  nodeOutputVarKey,
-  refToLookupKey,
-  ensureUid,
-  ensureUids,
-  paramKey,
-  computeAvailableVariables,
-} from "./operations";
+// Public surface of the variable module. The discriminated-union types live in
+// ./Variable; the key/lookup/uid helpers and availability computation live in
+// ./operations. This file is a barrel only. Mirrors channel/memory/model.
+
+export type { ApiVariable, NodeOutputVariable, DeclaredVariable, FunctionArgVariable, Variable } from "./Variable";
+export {
+  varKey,
+  declaredVarKey,
+  fnargKey,
+  nodeOutputVarKey,
+  refToLookupKey,
+  ensureUid,
+  ensureUids,
+  paramKey,
+  computeAvailableVariables,
+} from "./operations";

package/src/variable/operations.ts

@@ -1,106 +1,106 @@
-import type { NodeOutput } from "../node";
-import type { Reference } from "../api";
-import type { ApiVariable } from "./Variable";
-import { isToolFlow, type EdgeType, type Edge } from "../edge";
-import { generateId } from "../id";
-import type { Variable } from "./Variable";
-
-// ============================================================================
-// Key Helpers
-// ============================================================================
-
-/** Compute the canonical map key for any CanvasVariable (or AvailableVariable). */
-export function varKey(v: Variable): string {
-  switch (v.kind) {
-    case "node":
-      return `${v.nodeId}:${v.outputId}`;
-    case "declared":
-      return `declared:${v.uid}`;
-    case "fnarg":
-      return `fnarg:${v.uid}`;
-  }
-}
-
-/** Key for a declared variable: `declared:<uid>` */
-export function declaredVarKey(uid: string): string {
-  return `declared:${uid}`;
-}
-
-/** Key for a function argument variable: `fnarg:<uid>` */
-export function fnargKey(uid: string): string {
-  return `fnarg:${uid}`;
-}
-
-/** Key for a node output variable: `<nodeId>:<outputId>` */
-export function nodeOutputVarKey(nodeId: string, outputId: string): string {
-  return `${nodeId}:${outputId}`;
-}
-
-// ============================================================================
-// Reference → Lookup Key
-// ============================================================================
-
-/** Convert a Reference to the canonical lookup key used in the variables record. */
-export function refToLookupKey(ref: Reference): string {
-  switch (ref.srcId) {
-    case "declared":
-      return declaredVarKey(ref.varId);
-    case "fnarg":
-      return fnargKey(ref.varId);
-    default:
-      return nodeOutputVarKey(ref.srcId, ref.varId);
-  }
-}
-
-// ============================================================================
-// Variable UID Helpers for dynamic variable definitions (e.g. Agent output definitions)
-// ============================================================================
-
-/** Create a Variable from a NodeOutput by assigning a uid. If it already has a uid, return as-is. */
-export function ensureUid(v: NodeOutput | ApiVariable): ApiVariable {
-  if ("uid" in v && v.uid) return v as ApiVariable;
-  return { uid: generateId(), name: v.name, dataType: v.dataType };
-}
-
-/** Ensure every NodeOutput/Variable in an array has a uid. */
-export function ensureUids(vars: (NodeOutput | ApiVariable)[]): ApiVariable[] {
-  return vars.map(ensureUid);
-}
-
-/** Get the binding key for a Variable — always its uid. */
-export function paramKey(p: ApiVariable): string {
-  return p.uid;
-}
-
-/**
- * Pure function that computes available variables for a canvas from its own
- * variables record + edges. Function canvases are self-contained: only their
- * own declared variables, node outputs, and function arguments are visible;
- * main-canvas state is never merged in.
- *
- * Only `type`/`target` are read, but the param takes the shared structural
- * {@link Edge} so there's one edge shape across core — workflow-builder
- * still passes its React Flow `Edge[]` without an adapter, and core stays free
- * of `@xyflow/react`.
- */
-export function computeAvailableVariables(
-  variables: Record<string, Variable>,
-  canvasEdges: readonly Edge[],
-): { list: Variable[]; lookup: Record<string, Variable> } {
-  const list: Variable[] = [];
-  const lookup: Record<string, Variable> = {};
-
-  // Node outputs routed to a tool port are scoped to the agent — exclude them.
-  const toolNodeIds = new Set<string>();
-  for (const edge of canvasEdges) {
-    if (isToolFlow(edge.type as EdgeType)) toolNodeIds.add(edge.target);
-  }
-
-  for (const [key, variable] of Object.entries(variables)) {
-    if (variable.kind === "node" && toolNodeIds.has(variable.nodeId)) continue;
-    list.push(variable);
-    lookup[key] = variable;
-  }
-
-  return { list, lookup };
-}
+import type { NodeOutput } from "../node";
+import type { Reference } from "../api";
+import type { ApiVariable } from "./Variable";
+import { isToolFlow, type EdgeType, type Edge } from "../edge";
+import { generateId } from "../id";
+import type { Variable } from "./Variable";
+
+// ============================================================================
+// Key Helpers
+// ============================================================================
+
+/** Compute the canonical map key for any CanvasVariable (or AvailableVariable). */
+export function varKey(v: Variable): string {
+  switch (v.kind) {
+    case "node":
+      return `${v.nodeId}:${v.outputId}`;
+    case "declared":
+      return `declared:${v.uid}`;
+    case "fnarg":
+      return `fnarg:${v.uid}`;
+  }
+}
+
+/** Key for a declared variable: `declared:<uid>` */
+export function declaredVarKey(uid: string): string {
+  return `declared:${uid}`;
+}
+
+/** Key for a function argument variable: `fnarg:<uid>` */
+export function fnargKey(uid: string): string {
+  return `fnarg:${uid}`;
+}
+
+/** Key for a node output variable: `<nodeId>:<outputId>` */
+export function nodeOutputVarKey(nodeId: string, outputId: string): string {
+  return `${nodeId}:${outputId}`;
+}
+
+// ============================================================================
+// Reference → Lookup Key
+// ============================================================================
+
+/** Convert a Reference to the canonical lookup key used in the variables record. */
+export function refToLookupKey(ref: Reference): string {
+  switch (ref.srcId) {
+    case "declared":
+      return declaredVarKey(ref.varId);
+    case "fnarg":
+      return fnargKey(ref.varId);
+    default:
+      return nodeOutputVarKey(ref.srcId, ref.varId);
+  }
+}
+
+// ============================================================================
+// Variable UID Helpers for dynamic variable definitions (e.g. Agent output definitions)
+// ============================================================================
+
+/** Create a Variable from a NodeOutput by assigning a uid. If it already has a uid, return as-is. */
+export function ensureUid(v: NodeOutput | ApiVariable): ApiVariable {
+  if ("uid" in v && v.uid) return v as ApiVariable;
+  return { uid: generateId(), name: v.name, dataType: v.dataType };
+}
+
+/** Ensure every NodeOutput/Variable in an array has a uid. */
+export function ensureUids(vars: (NodeOutput | ApiVariable)[]): ApiVariable[] {
+  return vars.map(ensureUid);
+}
+
+/** Get the binding key for a Variable — always its uid. */
+export function paramKey(p: ApiVariable): string {
+  return p.uid;
+}
+
+/**
+ * Pure function that computes available variables for a canvas from its own
+ * variables record + edges. Function canvases are self-contained: only their
+ * own declared variables, node outputs, and function arguments are visible;
+ * main-canvas state is never merged in.
+ *
+ * Only `type`/`target` are read, but the param takes the shared structural
+ * {@link Edge} so there's one edge shape across core — workflow-builder
+ * still passes its React Flow `Edge[]` without an adapter, and core stays free
+ * of `@xyflow/react`.
+ */
+export function computeAvailableVariables(
+  variables: Record<string, Variable>,
+  canvasEdges: readonly Edge[],
+): { list: Variable[]; lookup: Record<string, Variable> } {
+  const list: Variable[] = [];
+  const lookup: Record<string, Variable> = {};
+
+  // Node outputs routed to a tool port are scoped to the agent — exclude them.
+  const toolNodeIds = new Set<string>();
+  for (const edge of canvasEdges) {
+    if (isToolFlow(edge.type as EdgeType)) toolNodeIds.add(edge.target);
+  }
+
+  for (const [key, variable] of Object.entries(variables)) {
+    if (variable.kind === "node" && toolNodeIds.has(variable.nodeId)) continue;
+    list.push(variable);
+    lookup[key] = variable;
+  }
+
+  return { list, lookup };
+}

package/src/workflow/Workflow.ts

@@ -1,41 +1,41 @@
-import type { Channel } from "../channel";
-import type { Memory } from "../memory";
-import type { Model } from "../model";
-import type { Node } from "../node";
-import type { FunctionDeclaration } from "../function";
-import type { Edge } from "../edge";
-import type { Variable } from "../variable";
-import type { Schemas } from "../api";
-
-export type ApiWorkflow = Schemas["Workflow"];
-
-/**
- * The id of the project's main canvas. All other canvas ids identify function
- * definitions. Lives here next to {@link Workflow} (which keys canvases
- * by this value) so the headless validator can reason about canvas scope
- * without depending on a UI store.
- */
-export const MAIN_CANVAS_ID = "main" as const;
-
-/**
- * In-memory domain state for a workflow, which the headless validator consumes.
- * NOT a persistence format, NOT the format the editor uses internally (Zustand stores).
- * This format is used as intermediary when importing/exporting to api format and to run validation
- */
-export interface Workflow {
-  canvases: Record<string, Canvas>;
-  functions: Record<string, FunctionDeclaration>;
-  channels: Record<string, Channel>;
-  memory: Record<string, Memory>;
-  models: Record<string, Model>;
-}
-
-/**
- * One canvas's worth of in-memory domain state — the body of either the main canvas
- * or a function.
- */
-export interface Canvas {
-  nodes: Node[];
-  edges: Edge[];
-  variables: Record<string, Variable>;
-}
+import type { Channel } from "../channel";
+import type { Memory } from "../memory";
+import type { Model } from "../model";
+import type { Node } from "../node";
+import type { FunctionDeclaration } from "../function";
+import type { Edge } from "../edge";
+import type { Variable } from "../variable";
+import type { Schemas } from "../api";
+
+export type ApiWorkflow = Schemas["Workflow"];
+
+/**
+ * The id of the project's main canvas. All other canvas ids identify function
+ * definitions. Lives here next to {@link Workflow} (which keys canvases
+ * by this value) so the headless validator can reason about canvas scope
+ * without depending on a UI store.
+ */
+export const MAIN_CANVAS_ID = "main" as const;
+
+/**
+ * In-memory domain state for a workflow, which the headless validator consumes.
+ * NOT a persistence format, NOT the format the editor uses internally (Zustand stores).
+ * This format is used as intermediary when importing/exporting to api format and to run validation
+ */
+export interface Workflow {
+  canvases: Record<string, Canvas>;
+  functions: Record<string, FunctionDeclaration>;
+  channels: Record<string, Channel>;
+  memory: Record<string, Memory>;
+  models: Record<string, Model>;
+}
+
+/**
+ * One canvas's worth of in-memory domain state — the body of either the main canvas
+ * or a function.
+ */
+export interface Canvas {
+  nodes: Node[];
+  edges: Edge[];
+  variables: Record<string, Variable>;
+}

package/src/workflow/index.ts

@@ -1,3 +1,3 @@
-export type { ApiWorkflow, Workflow, Canvas } from "./Workflow";
-export { MAIN_CANVAS_ID } from "./Workflow";
-export { serialize, deserialize, computeVariablesFromNodes } from "./serialization";
+export type { ApiWorkflow, Workflow, Canvas } from "./Workflow";
+export { MAIN_CANVAS_ID } from "./Workflow";
+export { serialize, deserialize, computeVariablesFromNodes } from "./serialization";