@foresthubai/workflow-core 0.3.0

package/dist/parameter/Parameter.d.ts

@@ -0,0 +1,152 @@
+import type { Expression } from "../api";
+import type { ChannelType } from "../channel";
+import type { MemoryType } from "../memory";
+import type { ModelType, ModelCapability } from "../model";
+import type { Schemas } from "../api";
+export type DataType = Schemas["DataType"];
+/**
+ * A field that is either a static value of T, or a function that derives T
+ * from the owning node's current arguments. Scope is strictly args-only —
+ * no access to variables, IO labels, or other canvas state. For wider
+ * context, use a purpose-named accessor (e.g. resolveExpressionType).
+ */
+export type FromArgs<T> = T | ((args: Record<string, unknown>) => T);
+/** Unwrap a FromArgs value against the current node arguments. */
+export declare function unwrapFromArgs<T>(value: FromArgs<T>, args: Record<string, unknown>): T;
+export interface ParameterBase {
+    id: string;
+    label: string;
+    description: string;
+    optional?: boolean;
+    /** Parameter is only active (visible, validated, serialized) when all rules are met. */
+    activationRules?: ActivationRule[];
+}
+export interface BasicParam {
+    type: "int" | "float" | "time";
+    default?: number | string;
+}
+export interface StringParam {
+    type: "string";
+    multiline?: boolean;
+    default?: string;
+}
+export interface BoolParam {
+    type: "bool";
+    default: boolean;
+}
+export interface WeekdaysParam {
+    type: "weekdays";
+    default: string[];
+}
+export interface SelectionParam {
+    type: "selection";
+    options: Array<{
+        value: string;
+        label: string;
+    }>;
+    default?: string;
+}
+export interface ExpressionParam {
+    type: "expression";
+    /** Type can be dynamic (static value or args-only lambda). */
+    expressionType: FromArgs<DataType>;
+    /**
+     * Escape hatch for the variableSelect case: when set, points to the id of a sibling
+     * variableSelect parameter. If that parameter holds a live Reference, the expressionType
+     * is taken from the referenced variable. Falls back to `expressionType` otherwise.
+     */
+    fromReference?: string;
+    /**
+     * Required: An expression always has a value object never an unset state.
+     */
+    default: Expression;
+}
+export interface VariableSelectParam {
+    type: "variableSelect";
+    default?: never;
+}
+export interface ModelSelectParam {
+    type: "modelSelect";
+    /** Model types this slot accepts (e.g. ["LLMModel"]). Static list or args-derived lambda. */
+    modelType: FromArgs<ModelType[]>;
+    /** Optional capability filter (e.g. ["chat"]) applied to catalog and declared models alike. */
+    capabilities?: FromArgs<ModelCapability[]>;
+    default?: never;
+}
+export interface ChannelSelectParam {
+    type: "channelSelect";
+    /** Channel types this slot accepts. Static list or args-derived lambda. */
+    channelType: FromArgs<ChannelType[]>;
+    default?: never;
+}
+export interface MemorySelectParam {
+    type: "memorySelect";
+    /** Memory types this slot accepts (e.g. ["VectorDatabase"]). Static list or args-derived lambda. */
+    memoryType: FromArgs<MemoryType[]>;
+    default?: never;
+}
+/**
+ * List parameter that binds an agent node to project-declared memory files,
+ * each with an access mode (`r` = read-only, `rw` = read + write). The editor
+ * holds the array directly; the API schema (`MemoryRef[]`) round-trips 1:1.
+ *
+ * `default` is required: a list param is always a
+ * concrete array, never unset — declare `default: []` for "starts empty".
+ */
+export interface MemoryRefsParam {
+    type: "memory-refs";
+    default: Schemas["MemoryRef"][];
+}
+/** Union of all reference-select parameter variants, used for type guards. */
+export type ReferenceSelectParam = VariableSelectParam | ChannelSelectParam | MemorySelectParam | ModelSelectParam;
+export declare function isReferenceSelectParam(param: Parameter): param is ParameterBase & ReferenceSelectParam;
+export type Parameter = (ParameterBase & BasicParam) | (ParameterBase & VariableSelectParam) | (ParameterBase & StringParam) | (ParameterBase & BoolParam) | (ParameterBase & WeekdaysParam) | (ParameterBase & SelectionParam) | (ParameterBase & MemorySelectParam) | (ParameterBase & ModelSelectParam) | (ParameterBase & ExpressionParam) | (ParameterBase & ChannelSelectParam) | (ParameterBase & MemoryRefsParam);
+/** Typed union of rules that control whether a parameter is active (visible, validated, serialized). */
+export type ActivationRule = {
+    type: "parameterIn";
+    parameterId: string;
+    values: unknown[];
+} | {
+    type: "isControlFlow";
+} | {
+    type: "isToolInput";
+};
+/**
+ * Evaluate whether a parameter is active (visible, validated, serialized) given current context.
+ * All rules must be satisfied (AND logic). Undefined or empty array = always active.
+ */
+export declare function isParameterActive(param: Parameter, parameterValues: Record<string, unknown>, isToolInput: boolean): boolean;
+/**
+ * Whether a scalar argument value counts as "unset" for api purposes:
+ * `undefined`, `null`, or `""`. Deliberately NOT `false`/`0` (valid values) nor
+ * `[]` — an empty list is a real value, since list params are always
+ * materialized to a concrete array. Shared by required-param diagnostics and
+ * {@link pruneArguments} so "unset" has exactly one definition.
+ */
+export declare function isEmpty(value: unknown): boolean;
+/**
+ * Prune arguments that must not appear in the api, at the domain→api boundary.
+ * Mutates `args` in place. Two reasons an arg is dropped:
+ *   1. inactive — its parameter's activation rules aren't met for this context.
+ *   2. the parameter {@link isEmpty}.
+ */
+export declare function pruneArguments(args: Record<string, unknown>, parameters: readonly Parameter[], isToolInput?: boolean): void;
+/**
+ * Resolve an ExpressionParam's expected dataType. Handles the `fromReference` escape hatch
+ * (type taken from a live variableSelect sibling parameter) and falls back to the
+ * declared FromArgs<DataType>.
+ */
+export declare function resolveExpressionType(param: ExpressionParam, args: Record<string, unknown>, variables: Record<string, {
+    dataType: DataType;
+}>): DataType;
+/** Resolve a capability filter (ModelSelectParam) for the current node arguments. */
+export declare function resolveCapabilities(param: {
+    capabilities?: FromArgs<ModelCapability[]>;
+}, args: Record<string, unknown>): ModelCapability[] | undefined;
+/** Resolve the allowed channel types for a ChannelSelectParam. */
+export declare function resolveChannelTypes(param: ChannelSelectParam, args: Record<string, unknown>): ChannelType[];
+/** Resolve the allowed memory types for a MemorySelectParam. */
+export declare function resolveMemoryTypes(param: MemorySelectParam, args: Record<string, unknown>): MemoryType[];
+/** Resolve the allowed model types for a ModelSelectParam. */
+export declare function resolveModelTypes(param: ModelSelectParam, args: Record<string, unknown>): ModelType[];
+//# sourceMappingURL=Parameter.d.ts.map

package/dist/parameter/Parameter.d.ts.map

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

package/dist/parameter/Parameter.js

@@ -0,0 +1,86 @@
+import { refToLookupKey } from "../variable";
+/** Unwrap a FromArgs value against the current node arguments. */
+export function unwrapFromArgs(value, args) {
+    return typeof value === "function" ? value(args) : value;
+}
+export function isReferenceSelectParam(param) {
+    return param.type === "variableSelect" || param.type === "channelSelect" || param.type === "memorySelect" || param.type === "modelSelect";
+}
+/**
+ * Evaluate whether a parameter is active (visible, validated, serialized) given current context.
+ * All rules must be satisfied (AND logic). Undefined or empty array = always active.
+ */
+export function isParameterActive(param, parameterValues, isToolInput) {
+    if (!param.activationRules?.length)
+        return true;
+    return param.activationRules.every((cond) => {
+        switch (cond.type) {
+            case "isControlFlow":
+                return !isToolInput;
+            case "isToolInput":
+                return isToolInput;
+            case "parameterIn":
+                return cond.values.includes(parameterValues[cond.parameterId]);
+        }
+    });
+}
+/**
+ * Whether a scalar argument value counts as "unset" for api purposes:
+ * `undefined`, `null`, or `""`. Deliberately NOT `false`/`0` (valid values) nor
+ * `[]` — an empty list is a real value, since list params are always
+ * materialized to a concrete array. Shared by required-param diagnostics and
+ * {@link pruneArguments} so "unset" has exactly one definition.
+ */
+export function isEmpty(value) {
+    return value === undefined || value === null || value === "";
+}
+/**
+ * Prune arguments that must not appear in the api, at the domain→api boundary.
+ * Mutates `args` in place. Two reasons an arg is dropped:
+ *   1. inactive — its parameter's activation rules aren't met for this context.
+ *   2. the parameter {@link isEmpty}.
+ */
+export function pruneArguments(args, parameters, isToolInput = false) {
+    for (const param of parameters) {
+        const inactive = !!param.activationRules?.length && !isParameterActive(param, args, isToolInput);
+        if (inactive || isEmpty(args[param.id])) {
+            delete args[param.id];
+        }
+    }
+}
+// ============================================================================
+// Parameter resolvers
+// ============================================================================
+/**
+ * Resolve an ExpressionParam's expected dataType. Handles the `fromReference` escape hatch
+ * (type taken from a live variableSelect sibling parameter) and falls back to the
+ * declared FromArgs<DataType>.
+ */
+export function resolveExpressionType(param, args, variables) {
+    if (param.fromReference) {
+        const ref = args[param.fromReference];
+        if (ref?.varId) {
+            const v = variables[refToLookupKey(ref)];
+            if (v)
+                return v.dataType;
+        }
+    }
+    return unwrapFromArgs(param.expressionType, args);
+}
+/** Resolve a capability filter (ModelSelectParam) for the current node arguments. */
+export function resolveCapabilities(param, args) {
+    return param.capabilities === undefined ? undefined : unwrapFromArgs(param.capabilities, args);
+}
+/** Resolve the allowed channel types for a ChannelSelectParam. */
+export function resolveChannelTypes(param, args) {
+    return unwrapFromArgs(param.channelType, args);
+}
+/** Resolve the allowed memory types for a MemorySelectParam. */
+export function resolveMemoryTypes(param, args) {
+    return unwrapFromArgs(param.memoryType, args);
+}
+/** Resolve the allowed model types for a ModelSelectParam. */
+export function resolveModelTypes(param, args) {
+    return unwrapFromArgs(param.modelType, args);
+}
+//# sourceMappingURL=Parameter.js.map

package/dist/parameter/Parameter.js.map

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

package/dist/parameter/index.d.ts

@@ -0,0 +1,5 @@
+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";
+//# sourceMappingURL=index.d.ts.map

package/dist/parameter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parameter/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,UAAU,EACV,WAAW,EACX,SAAS,EACT,aAAa,EACb,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,SAAS,EACT,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,OAAO,EACP,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACrH,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/parameter/index.js

@@ -0,0 +1,3 @@
+export { unwrapFromArgs, isReferenceSelectParam, isParameterActive, isEmpty, pruneArguments, resolveExpressionType, resolveCapabilities, resolveChannelTypes, resolveMemoryTypes, resolveModelTypes, } from "./Parameter";
+export { resolveStaticOutputDataType } from "./OutputParameter";
+//# sourceMappingURL=index.js.map

package/dist/parameter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parameter/index.ts"],"names":[],"mappings":"AAmBA,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,OAAO,EACP,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/variable/Variable.d.ts

@@ -0,0 +1,25 @@
+import type { Schemas } from "../api";
+import type { DataType } from "../api";
+export type ApiVariable = Schemas["Variable"];
+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;
+//# sourceMappingURL=Variable.d.ts.map

package/dist/variable/Variable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Variable.d.ts","sourceRoot":"","sources":["../../src/variable/Variable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAEvC,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAE9C,MAAM,MAAM,kBAAkB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC;AACtH,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAC3H,MAAM,MAAM,mBAAmB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEnG,MAAM,MAAM,QAAQ,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,mBAAmB,CAAC"}

package/dist/variable/Variable.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Variable.js.map

package/dist/variable/Variable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Variable.js","sourceRoot":"","sources":["../../src/variable/Variable.ts"],"names":[],"mappings":""}

package/dist/variable/index.d.ts

@@ -0,0 +1,3 @@
+export type { ApiVariable, NodeOutputVariable, DeclaredVariable, FunctionArgVariable, Variable } from "./Variable";
+export { varKey, declaredVarKey, fnargKey, nodeOutputVarKey, refToLookupKey, ensureUid, ensureUids, paramKey, computeAvailableVariables, } from "./operations";
+//# sourceMappingURL=index.d.ts.map

package/dist/variable/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/variable/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACnH,OAAO,EACL,MAAM,EACN,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,UAAU,EACV,QAAQ,EACR,yBAAyB,GAC1B,MAAM,cAAc,CAAC"}

package/dist/variable/index.js

@@ -0,0 +1,5 @@
+// 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 { varKey, declaredVarKey, fnargKey, nodeOutputVarKey, refToLookupKey, ensureUid, ensureUids, paramKey, computeAvailableVariables, } from "./operations";
+//# sourceMappingURL=index.js.map

package/dist/variable/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/variable/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,8EAA8E;AAC9E,0EAA0E;AAG1E,OAAO,EACL,MAAM,EACN,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,UAAU,EACV,QAAQ,EACR,yBAAyB,GAC1B,MAAM,cAAc,CAAC"}

package/dist/variable/operations.d.ts

@@ -0,0 +1,37 @@
+import type { NodeOutput } from "../node";
+import type { Reference } from "../api";
+import type { ApiVariable } from "./Variable";
+import { type Edge } from "../edge";
+import type { Variable } from "./Variable";
+/** Compute the canonical map key for any CanvasVariable (or AvailableVariable). */
+export declare function varKey(v: Variable): string;
+/** Key for a declared variable: `declared:<uid>` */
+export declare function declaredVarKey(uid: string): string;
+/** Key for a function argument variable: `fnarg:<uid>` */
+export declare function fnargKey(uid: string): string;
+/** Key for a node output variable: `<nodeId>:<outputId>` */
+export declare function nodeOutputVarKey(nodeId: string, outputId: string): string;
+/** Convert a Reference to the canonical lookup key used in the variables record. */
+export declare function refToLookupKey(ref: Reference): string;
+/** Create a Variable from a NodeOutput by assigning a uid. If it already has a uid, return as-is. */
+export declare function ensureUid(v: NodeOutput | ApiVariable): ApiVariable;
+/** Ensure every NodeOutput/Variable in an array has a uid. */
+export declare function ensureUids(vars: (NodeOutput | ApiVariable)[]): ApiVariable[];
+/** Get the binding key for a Variable — always its uid. */
+export declare function paramKey(p: ApiVariable): string;
+/**
+ * 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 declare function computeAvailableVariables(variables: Record<string, Variable>, canvasEdges: readonly Edge[]): {
+    list: Variable[];
+    lookup: Record<string, Variable>;
+};
+//# sourceMappingURL=operations.d.ts.map

package/dist/variable/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/variable/operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAA6B,KAAK,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAM3C,mFAAmF;AACnF,wBAAgB,MAAM,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAS1C;AAED,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzE;AAMD,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CASrD;AAMD,qGAAqG;AACrG,wBAAgB,SAAS,CAAC,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,WAAW,CAGlE;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,IAAI,EAAE,CAAC,UAAU,GAAG,WAAW,CAAC,EAAE,GAAG,WAAW,EAAE,CAE5E;AAED,2DAA2D;AAC3D,wBAAgB,QAAQ,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAE/C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EACnC,WAAW,EAAE,SAAS,IAAI,EAAE,GAC3B;IAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;CAAE,CAiBxD"}

package/dist/variable/operations.js

@@ -0,0 +1,88 @@
+import { isToolFlow } from "../edge";
+import { generateId } from "../id";
+// ============================================================================
+// Key Helpers
+// ============================================================================
+/** Compute the canonical map key for any CanvasVariable (or AvailableVariable). */
+export function varKey(v) {
+    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) {
+    return `declared:${uid}`;
+}
+/** Key for a function argument variable: `fnarg:<uid>` */
+export function fnargKey(uid) {
+    return `fnarg:${uid}`;
+}
+/** Key for a node output variable: `<nodeId>:<outputId>` */
+export function nodeOutputVarKey(nodeId, outputId) {
+    return `${nodeId}:${outputId}`;
+}
+// ============================================================================
+// Reference → Lookup Key
+// ============================================================================
+/** Convert a Reference to the canonical lookup key used in the variables record. */
+export function refToLookupKey(ref) {
+    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) {
+    if ("uid" in v && v.uid)
+        return v;
+    return { uid: generateId(), name: v.name, dataType: v.dataType };
+}
+/** Ensure every NodeOutput/Variable in an array has a uid. */
+export function ensureUids(vars) {
+    return vars.map(ensureUid);
+}
+/** Get the binding key for a Variable — always its uid. */
+export function paramKey(p) {
+    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, canvasEdges) {
+    const list = [];
+    const lookup = {};
+    // Node outputs routed to a tool port are scoped to the agent — exclude them.
+    const toolNodeIds = new Set();
+    for (const edge of canvasEdges) {
+        if (isToolFlow(edge.type))
+            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 };
+}
+//# sourceMappingURL=operations.js.map

package/dist/variable/operations.js.map

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

package/dist/workflow/Workflow.d.ts

@@ -0,0 +1,38 @@
+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 declare const MAIN_CANVAS_ID: "main";
+/**
+ * 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>;
+}
+//# sourceMappingURL=Workflow.d.ts.map

package/dist/workflow/Workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Workflow.d.ts","sourceRoot":"","sources":["../../src/workflow/Workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAG,MAAe,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC/C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACrC"}

package/dist/workflow/Workflow.js

@@ -0,0 +1,8 @@
+/**
+ * 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";
+//# sourceMappingURL=Workflow.js.map

package/dist/workflow/Workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Workflow.js","sourceRoot":"","sources":["../../src/workflow/Workflow.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAe,CAAC"}

package/dist/workflow/index.d.ts

@@ -0,0 +1,4 @@
+export type { ApiWorkflow, Workflow, Canvas } from "./Workflow";
+export { MAIN_CANVAS_ID } from "./Workflow";
+export { serialize, deserialize, computeVariablesFromNodes } from "./serialization";
+//# sourceMappingURL=index.d.ts.map

package/dist/workflow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/workflow/index.js

@@ -0,0 +1,3 @@
+export { MAIN_CANVAS_ID } from "./Workflow";
+export { serialize, deserialize, computeVariablesFromNodes } from "./serialization";
+//# sourceMappingURL=index.js.map

package/dist/workflow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/workflow/serialization.d.ts

@@ -0,0 +1,43 @@
+import type { Schemas } from "../api";
+import type { NodeData } from "../node";
+import type { Variable, NodeOutputVariable } from "../variable";
+import { type Workflow } from "./Workflow";
+/**
+ * Serialize domain → api Workflow. Multi-canvas
+ * mapping: the `main` canvas's nodes/edges/declaredVariables land at the
+ * root of `Workflow`; every other canvas becomes a `Function` entry in
+ * `Workflow.functions[]`, carrying its own functionInfo + outputAssignments.
+ */
+export declare function serialize(state: Workflow): Schemas["Workflow"];
+/**
+ * Deserialize api → domain Workflow. Variable
+ * records are reconstructed per canvas (declared from the api; fnarg
+ * from `functionInfo.arguments`; node-output via {@link computeVariablesFromNodes})
+ * since the api intentionally carries only `declaredVariables` to avoid
+ * redundancy.
+ *
+ * Each node is a flat {@link Node} (domain `NodeData` + `position`);
+ * its `type` is the domain node type (e.g. "Agent"). Workflow-builder projects
+ * that into a React Flow display type during store hydration — editor-only.
+ */
+export declare function deserialize(workflow: Schemas["Workflow"]): Workflow;
+/**
+ * Derive node-output variables (`{kind: "node", nodeId, outputId, ...}`)
+ * from an array of node instances. Calls {@link getNodeOutput} to inspect
+ * each node's declared outputs.
+ *
+ * Ported from workflow-builder's canvasStore to take NodeData[] directly
+ * (NodeData carries id at the top level — no React Flow wrapper needed).
+ */
+export declare function computeVariablesFromNodes(nodes: NodeData[]): Record<string, NodeOutputVariable>;
+/**
+ * Merge the three variable sources into a single per-canvas record:
+ *   declared (from api)
+ * + fnarg    (derived from the function's `arguments` — empty for the main canvas)
+ * + nodeOutput (derived from nodes via {@link computeVariablesFromNodes})
+ *
+ * Disjoint key namespaces (`declared:`, `fnarg:`, `<nodeId>:<outputId>`) so
+ * merge order is irrelevant.
+ */
+export declare function buildCanvasVariables(nodes: NodeData[], fnArgs: readonly Schemas["Variable"][], declaredVariables: readonly Schemas["Variable"][]): Record<string, Variable>;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/workflow/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../src/workflow/serialization.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAYxC,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,EAAkB,KAAK,QAAQ,EAAe,MAAM,YAAY,CAAC;AAKxE;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAwC9D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,QAAQ,CAqEnE;AAMD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAc/F;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,QAAQ,EAAE,EACjB,MAAM,EAAE,SAAS,OAAO,CAAC,UAAU,CAAC,EAAE,EACtC,iBAAiB,EAAE,SAAS,OAAO,CAAC,UAAU,CAAC,EAAE,GAChD,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAoB1B"}