@pikku/inspector 0.12.60 → 0.12.61

package/src/utils/workflow/graph/serialize-workflow-graph.ts

@@ -1,4 +1,4 @@
-import { isRef } from '@pikku/core/ecosystem/workflow'
+import { isRef, template } from '@pikku/core/workflow'
 import type {
   SerializedWorkflowGraph,
   SerializedGraphNode,
@@ -36,6 +36,26 @@ function serializeInputMapping(
   return result
 }
 
+/**
+ * Convert a `forEach` source — a bare node id, a ref, or a `(ref) => ref(...)`
+ * callback — to the serialized DataRef form
+ */
+function serializeForEach(
+  forEach: unknown,
+  createRef: (nodeId: string, path?: string) => { nodeId: string; path?: string }
+): DataRef | undefined {
+  if (forEach === undefined) return undefined
+  if (typeof forEach === 'string') return { $ref: forEach }
+  if (typeof forEach === 'function') {
+    return serializeForEach(
+      (forEach as (ref: unknown) => unknown)(createRef),
+      createRef
+    )
+  }
+  if (isRef(forEach)) return convertRef(forEach)
+  return undefined
+}
+
 /**
  * Convert next config from runtime format to serialized format
  * Runtime uses Record<string, string | string[]> for branching with graph.branch()
@@ -73,7 +93,9 @@ export function serializeWorkflowGraph(
       string,
       {
         func: { name?: string }
-        input?: (ref: any) => Record<string, unknown>
+        input?: (ref: any, template?: any, $item?: any) => Record<string, unknown>
+        forEach?: string | { nodeId: string; path?: string } | ((ref: any) => unknown)
+        mode?: 'parallel' | 'sequential'
         next?: string | string[] | Record<string, string | string[]>
         onError?: string | string[]
         notes?: string
@@ -96,6 +118,8 @@ export function serializeWorkflowGraph(
     path,
   })
 
+  const createItemRef = (path?: string) => createRef('$item', path)
+
   // Track which nodes have incoming edges
   const hasIncomingEdge = new Set<string>()
 
@@ -124,7 +148,7 @@ export function serializeWorkflowGraph(
     // Evaluate input callback to get the mapping
     let input: Record<string, unknown | DataRef> = {}
     if (node.input) {
-      const rawInput = node.input(createRef)
+      const rawInput = node.input(createRef, template, createItemRef)
       input = serializeInputMapping(rawInput)
     }
 
@@ -138,6 +162,13 @@ export function serializeWorkflowGraph(
       next: serializeNext(node.next),
       onError: node.onError,
     }
+    const forEach = serializeForEach(node.forEach, createRef)
+    if (forEach) {
+      funcNode.forEach = forEach
+      if (node.mode !== undefined) {
+        funcNode.mode = node.mode
+      }
+    }
     if (node.notes !== undefined) {
       funcNode.notes = node.notes
     }

package/src/utils/workflow/graph/workflow-graph.types.ts

@@ -115,8 +115,8 @@ import type {
   ContextVariable,
   WorkflowContext,
   WorkflowPlannedStep,
-} from '@pikku/core/ecosystem/workflow'
-import type { ScenarioStepPhase } from '@pikku/core/ecosystem/scenario'
+} from '@pikku/core/workflow'
+import type { ScenarioStepPhase } from '@pikku/core/scenario'
 
 export type { ContextVariable, WorkflowContext }
 
@@ -141,11 +141,21 @@ interface BaseNode {
 /**
  * Function node - calls an RPC
  */
+/** How the per-item instances of a `forEach` node run */
+export type ForEachMode = 'parallel' | 'sequential'
+
 export interface FunctionNode extends BaseNode {
   /** RPC function name */
   rpcName: string
   /** Input mapping - values can be literals or DataRefs */
   input?: Record<string, unknown | DataRef>
+  /**
+   * Run this node once per element of the referenced array. The node's own
+   * result becomes the ordered array of per-item results.
+   */
+  forEach?: DataRef
+  /** How the per-item instances run. Defaults to 'parallel'. */
+  mode?: ForEachMode
   /** Output variable name for storing result */
   outputVar?: string
   /** Hash of nodeId + RPC input/output schemas for version detection */