@travisliu/open-dynamic-workflow 0.3.1 → 0.3.5

package/dist/types/config.d.ts

@@ -77,6 +77,7 @@ export interface WorkflowDiscoveryConfig {
 export interface WorkflowConfig {
     discovery: WorkflowDiscoveryConfig;
     maxDepth: number;
+    maxLoopRounds: number;
 }
 export interface OrchestrationConfig {
     concurrency?: number;

package/dist/types/workflow.d.ts

@@ -3,6 +3,7 @@ import type { JsonObject, JsonValue, WorkflowStatus } from "./common.js";
 import type { SerializedError } from "./errors.js";
 import type { PipelineStage, PipelineOptions, PipelineResult, PipelineSummary } from "../pipeline/types.js";
 import type { ToolSummary, ToolCallInput, ToolSettledResult } from "./tool.js";
+import type { LoopInput, LoopSettledResult, LoopSummary } from "../loop/types.js";
 export type { PipelineStage, PipelineOptions, PipelineResult, PipelineSummary };
 export interface WorkflowMeta {
     name: string;
@@ -90,6 +91,17 @@ export interface WorkflowRuntimeContext {
     workflow<T = JsonValue>(input: WorkflowThrowCallInput): Promise<T>;
     workflow<T = JsonValue>(input: WorkflowSettledCallInput): Promise<WorkflowSettledResult<T>>;
     workflow<T = JsonValue>(input: WorkflowCallInput): Promise<T | WorkflowSettledResult<T>>;
+    loop<TState>(input: LoopInput<TState> & {
+        options: {
+            failureMode?: "throw";
+        };
+    }): Promise<TState>;
+    loop<TState>(input: LoopInput<TState> & {
+        options: {
+            failureMode: "settled";
+        };
+    }): Promise<LoopSettledResult<TState>>;
+    loop<TState>(input: LoopInput<TState>): Promise<TState | LoopSettledResult<TState>>;
 }
 export interface WorkflowIdentity {
     name: string;
@@ -117,6 +129,7 @@ export interface WorkflowRunResult {
     pipelines?: PipelineSummary[] | undefined;
     workflows?: WorkflowInvocationSummary[] | undefined;
     tools?: ToolSummary[] | undefined;
+    loops?: LoopSummary[] | undefined;
     startedAt: string;
     finishedAt: string;
     durationMs: number;

package/dist/workflow/discovery.d.ts

@@ -11,5 +11,6 @@ export interface DiscoverWorkflowRegistryInput {
     candidatePaths?: string[] | undefined;
     allowDynamicSharedAgentIds?: boolean;
     toolRegistry?: ToolRegistry;
+    maxLoopRounds?: number;
 }
 export declare function discoverWorkflowRegistry(input: DiscoverWorkflowRegistryInput): Promise<WorkflowRegistry>;

package/dist/workflow/discovery.js

@@ -9,7 +9,7 @@ import { ErrorCode } from "../errors/codes.js";
 import { walk, matchGlob, getGlobBaseDir } from "../discovery/file-patterns.js";
 export { walk, matchGlob, getGlobBaseDir };
 export async function discoverWorkflowRegistry(input) {
-    const { rootWorkflowPath, cwd, include, sharedAgentRegistry, candidatePaths } = input;
+    const { rootWorkflowPath, cwd, include, sharedAgentRegistry, candidatePaths, maxLoopRounds } = input;
     const absoluteCwd = resolve(cwd);
     const absoluteRootPath = resolve(absoluteCwd, rootWorkflowPath);
     const canonicalCwd = await fs.realpath(absoluteCwd).catch(() => absoluteCwd);
@@ -48,7 +48,7 @@ export async function discoverWorkflowRegistry(input) {
         try {
             canonicalPath = await fs.realpath(absolutePath);
         }
-        catch (err) {
+        catch {
             canonicalPath = absolutePath;
         }
         // Safety check: ensure path is within CWD
@@ -81,7 +81,8 @@ export async function discoverWorkflowRegistry(input) {
                 allowImports: false,
                 sharedAgentRegistry,
                 allowDynamicSharedAgentIds: input.allowDynamicSharedAgentIds,
-                toolRegistry: input.toolRegistry
+                toolRegistry: input.toolRegistry,
+                maxLoopRounds
             });
         }
         const def = {
@@ -127,7 +128,8 @@ export async function discoverWorkflowRegistry(input) {
         sharedAgentRegistry,
         allowDynamicSharedAgentIds: input.allowDynamicSharedAgentIds,
         toolRegistry: input.toolRegistry,
-        rootWorkflowPath: absoluteRootPath
+        rootWorkflowPath: absoluteRootPath,
+        maxLoopRounds
     });
     return registry;
 }

package/dist/workflow/discovery.js.map

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

package/dist/workflow/dsl.d.ts

@@ -10,4 +10,5 @@ export declare function createDsl(runtime: RuntimeState): {
     parallel: <T>(tasks: Record<string, () => Promise<T>> | Array<() => Promise<T>>) => Promise<Record<string, T> | T[]>;
     pipeline: <I, O>(items: I[], stages: PipelineStage<any, any>[], options?: PipelineOptions) => Promise<PipelineResult<O>>;
     workflow: <T>(input: WorkflowCallInput) => Promise<T | WorkflowSettledResult<T>>;
+    loop: (input: any) => Promise<unknown>;
 };

package/dist/workflow/dsl.js

@@ -12,6 +12,9 @@ import { serializeError } from "../errors/serialize.js";
 import { cloneJsonValue } from "./json.js";
 import { getActiveWorkflowInvocation } from "./invocation-types.js";
 import { assertToolAllowed, withToolForbidden } from "./scope.js";
+import { runLoop } from "../loop/run.js";
+import { getActiveLoopContext, recordLoopChildAgentId } from "../loop/context.js";
+import { createLoopAgentId, normalizeLoopLabel } from "../loop/id.js";
 function normalizeToolCallInput(input, runtime) {
     if (!input || typeof input !== "object" || Array.isArray(input)) {
         throw new InvalidDslCallError("tool() requires an input object.");
@@ -166,6 +169,13 @@ export function createDsl(runtime) {
                 normalizedId = runtime.idGenerator ? runtime.idGenerator.nextId("agent") : `agent-${++runtime.agentCounter}`;
             }
         }
+        const activeLoop = getActiveLoopContext();
+        if (activeLoop) {
+            const activeInvocation = getActiveWorkflowInvocation();
+            const isChildWorkflow = !!(activeInvocation && activeLoop.workflowInvocationId && activeInvocation.workflowInvocationId !== activeLoop.workflowInvocationId);
+            normalizedId = resolveLoopAgentId(normalizedId, input, activeLoop, isChildWorkflow, runtime);
+            recordLoopChildAgentId(normalizedId);
+        }
         if (activePipeline) {
             recordChildAgentId(normalizedId);
         }
@@ -180,7 +190,7 @@ export function createDsl(runtime) {
         });
         const sequence = (runtime.callSequence ?? 0) + 1;
         runtime.callSequence = sequence;
-        const callId = resolveCallId(input);
+        const callId = resolveCallId(input, normalizedId);
         const fingerprint = computeAgentFingerprint({
             call: input,
             provider: normalizedProvider,
@@ -208,7 +218,8 @@ export function createDsl(runtime) {
                 model: resolved.model,
                 permissions: resolvedPermissions
             });
-            runtime.agentResults.push(cachedResult);
+            const artifactResult = cachedResult.__artifactResult || cachedResult;
+            runtime.agentResults.push(artifactResult);
             runtime.eventSink?.emit("agent.cache_hit", {
                 agentId: normalizedId,
                 label: input.label,
@@ -218,7 +229,7 @@ export function createDsl(runtime) {
                 callId,
                 previousRunId: runtime.callCache.previousRunId,
                 previousAgentId: cachedEntry.agentId,
-                artifacts: cachedResult.artifacts
+                artifacts: artifactResult.artifacts
             });
             await recordAgentCall({
                 store: runtime.artifactStore,
@@ -226,7 +237,7 @@ export function createDsl(runtime) {
                 sequence,
                 callId,
                 fingerprint,
-                result: cachedResult
+                result: artifactResult
             });
             return cachedResult;
         }
@@ -244,10 +255,16 @@ export function createDsl(runtime) {
                 let finalSignal = schedulerSignal;
                 let onAbort;
                 const invocationSignal = activeInvocation?.signal;
-                if ((activePipeline && activePipeline.stageSignal) || invocationSignal) {
+                const activeLoop = getActiveLoopContext();
+                const loopSignal = activeLoop?.signal;
+                if ((activePipeline && activePipeline.stageSignal) || invocationSignal || loopSignal) {
                     const combinedController = new AbortController();
                     onAbort = () => {
-                        combinedController.abort(schedulerSignal.reason || activePipeline?.stageSignal?.reason || invocationSignal?.reason || "Aborted");
+                        combinedController.abort(schedulerSignal.reason ||
+                            activePipeline?.stageSignal?.reason ||
+                            invocationSignal?.reason ||
+                            loopSignal?.reason ||
+                            "Aborted");
                     };
                     if (schedulerSignal.aborted) {
                         combinedController.abort(schedulerSignal.reason);
@@ -258,12 +275,20 @@ export function createDsl(runtime) {
                     else if (invocationSignal?.aborted) {
                         combinedController.abort(invocationSignal.reason);
                     }
+                    else if (loopSignal?.aborted) {
+                        combinedController.abort(loopSignal.reason);
+                    }
                     else {
                         schedulerSignal.addEventListener("abort", onAbort);
                         if (activePipeline?.stageSignal) {
                             activePipeline.stageSignal.addEventListener("abort", onAbort);
                         }
-                        invocationSignal?.addEventListener("abort", onAbort);
+                        if (invocationSignal) {
+                            invocationSignal.addEventListener("abort", onAbort);
+                        }
+                        if (loopSignal) {
+                            loopSignal.addEventListener("abort", onAbort);
+                        }
                     }
                     finalSignal = combinedController.signal;
                 }
@@ -299,6 +324,7 @@ export function createDsl(runtime) {
                             activePipeline.stageSignal.removeEventListener("abort", onAbort);
                         }
                         invocationSignal?.removeEventListener("abort", onAbort);
+                        loopSignal?.removeEventListener("abort", onAbort);
                     }
                 }
             }
@@ -342,6 +368,10 @@ export function createDsl(runtime) {
         if (!input || typeof input !== "object") {
             throw new InvalidDslCallError("agent() requires an input object.");
         }
+        const activeLoop = getActiveLoopContext();
+        if (activeLoop?.signal.aborted) {
+            throw activeLoop.signal.reason;
+        }
         if ("definition" in input && input.definition !== undefined) {
             if (!runtime.sharedAgentRegistry) {
                 throw new OpenDynamicWorkflowError(ErrorCode.SHARED_AGENT_NOT_FOUND, "Shared agent registry is not available.");
@@ -434,8 +464,93 @@ export function createDsl(runtime) {
         }
         return runDirectAgent(input);
     };
+    const workflowFunction = async (input) => {
+        const activeInvocation = getActiveWorkflowInvocation();
+        if (!activeInvocation) {
+            throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_FAILED, "workflow() can only be called from within a workflow invocation.");
+        }
+        if (!runtime.invocationManager) {
+            throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_FAILED, "Workflow invocation manager is not available.");
+        }
+        const activeLoop = getActiveLoopContext();
+        if (activeLoop?.signal.aborted) {
+            throw activeLoop.signal.reason;
+        }
+        let effectiveParent = activeInvocation;
+        let onAbort;
+        if (activeLoop?.signal) {
+            const combinedController = new AbortController();
+            onAbort = () => {
+                combinedController.abort(activeLoop.signal.reason || activeInvocation.signal.reason || "Aborted");
+            };
+            if (activeLoop.signal.aborted) {
+                combinedController.abort(activeLoop.signal.reason);
+            }
+            else if (activeInvocation.signal.aborted) {
+                combinedController.abort(activeInvocation.signal.reason);
+            }
+            else {
+                activeLoop.signal.addEventListener("abort", onAbort);
+                activeInvocation.signal.addEventListener("abort", onAbort);
+            }
+            effectiveParent = {
+                ...activeInvocation,
+                signal: combinedController.signal,
+                abortController: combinedController,
+            };
+        }
+        try {
+            const result = await runtime.invocationManager.invokeChild(effectiveParent, input);
+            return result;
+        }
+        finally {
+            if (onAbort) {
+                activeLoop?.signal.removeEventListener("abort", onAbort);
+                activeInvocation.signal.removeEventListener("abort", onAbort);
+            }
+        }
+    };
+    const parallelFunction = async (tasks) => {
+        if (!tasks || typeof tasks !== "object") {
+            throw new InvalidDslCallError("parallel() requires an array or an object of task thunks.");
+        }
+        const activeLoop = getActiveLoopContext();
+        if (activeLoop?.signal.aborted) {
+            throw activeLoop.signal.reason;
+        }
+        if (Array.isArray(tasks)) {
+            const promises = tasks.map((task, idx) => {
+                if (typeof task !== "function") {
+                    throw new InvalidDslCallError(`parallel() task at index ${idx} must be a function.`);
+                }
+                return withToolForbidden("parallel-task", () => task());
+            });
+            return Promise.all(promises);
+        }
+        else {
+            const keys = Object.keys(tasks);
+            const promises = keys.map((key) => {
+                const task = tasks[key];
+                if (typeof task !== "function") {
+                    throw new InvalidDslCallError(`parallel() task '${key}' must be a function.`);
+                }
+                return withToolForbidden("parallel-task", () => task());
+            });
+            const results = await Promise.all(promises);
+            const resultObj = {};
+            for (let i = 0; i < keys.length; i++) {
+                const key = keys[i];
+                resultObj[key] = results[i];
+            }
+            return resultObj;
+        }
+    };
     const runTool = async (input) => {
         const scope = assertToolAllowed();
+        const activeLoop = getActiveLoopContext();
+        if (activeLoop?.signal.aborted) {
+            throw activeLoop.signal.reason;
+        }
         const normalizedInput = normalizeToolCallInput(input, runtime);
         if (!runtime.toolRegistry || !runtime.toolExecutor) {
             throw new OpenDynamicWorkflowError(ErrorCode.TOOL_INVALID_CONTEXT, "tool() is not configured for this run.");
@@ -451,113 +566,139 @@ export function createDsl(runtime) {
             toolCallId = nextToolCallId(runtime, normalizedInput.definition);
         }
         runtime.toolCallIds?.add(toolCallId);
-        const failureMode = normalizedInput.failureMode || "throw";
         const activeInvocation = getActiveWorkflowInvocation();
-        const preparedCall = {
-            toolCallId,
-            definition,
-            args: cloneJsonValue(normalizedInput.args, "tool args"),
-            label: normalizedInput.label,
-            failureMode,
-            timeoutMs: normalizedInput.timeoutMs || definition.definition.defaultTimeoutMs,
-            deadline: activeInvocation?.deadlineAt,
-            metadata: normalizedInput.metadata ? cloneJsonValue(normalizedInput.metadata, "tool metadata") : undefined,
-            workflowInvocationId: scope.workflowInvocationId,
-            parentWorkflowInvocationId: scope.parentWorkflowInvocationId,
-            queuedAt: new Date().toISOString(),
-            artifactPath: `tools/${toolCallId}/output.json`,
-            invocationSignal: activeInvocation?.signal || runtime.abortController.signal
-        };
-        const isCacheable = !!definition.definition.cacheable;
-        let sequence;
-        let fingerprint;
-        let callId;
-        if (isCacheable) {
-            sequence = (runtime.callSequence ?? 0) + 1;
-            runtime.callSequence = sequence;
-            callId = normalizedInput.id ?? normalizedInput.label;
-            fingerprint = computeToolFingerprint({
-                definitionId: definition.definition.id,
-                args: preparedCall.args,
-                timeoutMs: preparedCall.timeoutMs,
-                metadata: preparedCall.metadata,
-                sourcePath: definition.sourcePath,
-                definitionVersion: definition.definition.metadata?.version
-            });
-            const cachedEntry = findPrefixCacheHit({
-                cache: runtime.callCache,
-                kind: "tool",
-                sequence,
-                callId,
-                fingerprint
-            });
-            if (cachedEntry && runtime.artifactStore && runtime.callCache?.previousRunRoot) {
-                const cachedResult = await materializeCachedToolResult({
-                    store: runtime.artifactStore,
-                    previousRunRoot: runtime.callCache.previousRunRoot,
-                    previousRunId: runtime.callCache.previousRunId,
-                    entry: cachedEntry,
-                    currentToolCallId: toolCallId,
+        const failureMode = normalizedInput.failureMode || "throw";
+        let invocationSignal = activeInvocation?.signal || runtime.abortController.signal;
+        let onAbort;
+        if (activeLoop?.signal) {
+            const combinedController = new AbortController();
+            onAbort = () => combinedController.abort(activeLoop.signal.reason || invocationSignal.reason);
+            if (activeLoop.signal.aborted) {
+                combinedController.abort(activeLoop.signal.reason);
+            }
+            else if (invocationSignal.aborted) {
+                combinedController.abort(invocationSignal.reason);
+            }
+            else {
+                activeLoop.signal.addEventListener("abort", onAbort);
+                invocationSignal.addEventListener("abort", onAbort);
+            }
+            invocationSignal = combinedController.signal;
+        }
+        try {
+            const preparedCall = {
+                toolCallId,
+                definition,
+                args: cloneJsonValue(normalizedInput.args, "tool args"),
+                label: normalizedInput.label,
+                failureMode,
+                timeoutMs: normalizedInput.timeoutMs || definition.definition.defaultTimeoutMs,
+                deadline: activeInvocation?.deadlineAt,
+                metadata: normalizedInput.metadata ? cloneJsonValue(normalizedInput.metadata, "tool metadata") : undefined,
+                workflowInvocationId: scope.workflowInvocationId,
+                parentWorkflowInvocationId: scope.parentWorkflowInvocationId,
+                queuedAt: new Date().toISOString(),
+                artifactPath: `tools/${toolCallId}/output.json`,
+                invocationSignal
+            };
+            const isCacheable = !!definition.definition.cacheable;
+            let sequence;
+            let fingerprint;
+            let callId;
+            if (isCacheable) {
+                sequence = (runtime.callSequence ?? 0) + 1;
+                runtime.callSequence = sequence;
+                callId = normalizedInput.id ?? normalizedInput.label;
+                fingerprint = computeToolFingerprint({
                     definitionId: definition.definition.id,
-                    failureMode,
-                    label: normalizedInput.label,
-                    workflowInvocationId: scope.workflowInvocationId,
-                    parentWorkflowInvocationId: scope.parentWorkflowInvocationId
+                    args: preparedCall.args,
+                    timeoutMs: preparedCall.timeoutMs,
+                    metadata: preparedCall.metadata,
+                    sourcePath: definition.sourcePath,
+                    definitionVersion: definition.definition.metadata?.version
                 });
-                runtime.eventSink?.emit("tool.cache_hit", {
-                    toolCallId,
-                    definition: definition.definition.id,
-                    label: normalizedInput.label,
+                const cachedEntry = findPrefixCacheHit({
+                    cache: runtime.callCache,
+                    kind: "tool",
                     sequence,
                     callId,
-                    previousRunId: runtime.callCache.previousRunId,
-                    previousToolCallId: cachedEntry.toolCallId,
-                    artifactPath: cachedResult.artifactPath
+                    fingerprint
                 });
+                if (cachedEntry && runtime.artifactStore && runtime.callCache?.previousRunRoot) {
+                    const cachedResult = await materializeCachedToolResult({
+                        store: runtime.artifactStore,
+                        previousRunRoot: runtime.callCache.previousRunRoot,
+                        previousRunId: runtime.callCache.previousRunId,
+                        entry: cachedEntry,
+                        currentToolCallId: toolCallId,
+                        definitionId: definition.definition.id,
+                        failureMode,
+                        label: normalizedInput.label,
+                        workflowInvocationId: scope.workflowInvocationId,
+                        parentWorkflowInvocationId: scope.parentWorkflowInvocationId
+                    });
+                    runtime.eventSink?.emit("tool.cache_hit", {
+                        toolCallId,
+                        definition: definition.definition.id,
+                        label: normalizedInput.label,
+                        sequence,
+                        callId,
+                        previousRunId: runtime.callCache.previousRunId,
+                        previousToolCallId: cachedEntry.toolCallId,
+                        artifactPath: cachedResult.artifactPath
+                    });
+                    await recordToolCall({
+                        store: runtime.artifactStore,
+                        cache: runtime.callCache,
+                        sequence,
+                        callId,
+                        fingerprint,
+                        result: cachedResult
+                    });
+                    const toolResult = returnToolResult(cachedResult, failureMode);
+                    runtime.toolResults.push(cachedResult);
+                    if (runtime.toolExecutor) {
+                        runtime.toolExecutor.addSummary({
+                            toolCallId: cachedResult.toolCallId,
+                            definition: cachedResult.definitionId,
+                            status: cachedResult.status,
+                            ok: cachedResult.ok,
+                            workflowInvocationId: cachedResult.workflowInvocationId,
+                            parentWorkflowInvocationId: cachedResult.parentWorkflowInvocationId,
+                            durationMs: cachedResult.durationMs,
+                            artifactPath: cachedResult.artifactPath,
+                            cache: cachedResult.cache
+                        });
+                    }
+                    return toolResult;
+                }
+            }
+            else {
+                if (runtime.callCache) {
+                    runtime.callCache.prefixCacheUsable = false;
+                }
+            }
+            const result = await runtime.toolExecutor.execute(preparedCall);
+            if (isCacheable && sequence !== undefined && fingerprint !== undefined) {
                 await recordToolCall({
                     store: runtime.artifactStore,
                     cache: runtime.callCache,
                     sequence,
                     callId,
                     fingerprint,
-                    result: cachedResult
+                    result
                 });
-                const toolResult = returnToolResult(cachedResult, failureMode);
-                runtime.toolResults.push(cachedResult);
-                if (runtime.toolExecutor) {
-                    runtime.toolExecutor.addSummary({
-                        toolCallId: cachedResult.toolCallId,
-                        definition: cachedResult.definitionId,
-                        status: cachedResult.status,
-                        ok: cachedResult.ok,
-                        workflowInvocationId: cachedResult.workflowInvocationId,
-                        parentWorkflowInvocationId: cachedResult.parentWorkflowInvocationId,
-                        durationMs: cachedResult.durationMs,
-                        artifactPath: cachedResult.artifactPath,
-                        cache: cachedResult.cache
-                    });
-                }
-                return toolResult;
             }
+            runtime.toolResults.push(result);
+            return returnToolResult(result, failureMode);
         }
-        else {
-            if (runtime.callCache) {
-                runtime.callCache.prefixCacheUsable = false;
+        finally {
+            if (onAbort) {
+                activeLoop?.signal.removeEventListener("abort", onAbort);
+                const originalInvocationSignal = activeInvocation?.signal || runtime.abortController.signal;
+                originalInvocationSignal.removeEventListener("abort", onAbort);
             }
         }
-        const result = await runtime.toolExecutor.execute(preparedCall);
-        if (isCacheable && sequence !== undefined && fingerprint !== undefined) {
-            await recordToolCall({
-                store: runtime.artifactStore,
-                cache: runtime.callCache,
-                sequence,
-                callId,
-                fingerprint,
-                result
-            });
-        }
-        runtime.toolResults.push(result);
-        return returnToolResult(result, failureMode);
     };
     function returnToolResult(result, failureMode) {
         if (failureMode === "throw") {
@@ -626,37 +767,7 @@ export function createDsl(runtime) {
         log: logWorkflow,
         agent: runAgentCall,
         tool: runTool,
-        parallel: async (tasks) => {
-            if (!tasks || typeof tasks !== "object") {
-                throw new InvalidDslCallError("parallel() requires an array or an object of task thunks.");
-            }
-            if (Array.isArray(tasks)) {
-                const promises = tasks.map((task, idx) => {
-                    if (typeof task !== "function") {
-                        throw new InvalidDslCallError(`parallel() task at index ${idx} must be a function.`);
-                    }
-                    return withToolForbidden("parallel-task", () => task());
-                });
-                return Promise.all(promises);
-            }
-            else {
-                const keys = Object.keys(tasks);
-                const promises = keys.map((key) => {
-                    const task = tasks[key];
-                    if (typeof task !== "function") {
-                        throw new InvalidDslCallError(`parallel() task '${key}' must be a function.`);
-                    }
-                    return withToolForbidden("parallel-task", () => task());
-                });
-                const results = await Promise.all(promises);
-                const resultObj = {};
-                for (let i = 0; i < keys.length; i++) {
-                    const key = keys[i];
-                    resultObj[key] = results[i];
-                }
-                return resultObj;
-            }
-        },
+        parallel: parallelFunction,
         pipeline: async (items, stages, options) => {
             const activeInvocation = getActiveWorkflowInvocation();
             return runPipeline({
@@ -667,17 +778,50 @@ export function createDsl(runtime) {
                 signal: activeInvocation?.signal || runtime.abortController.signal
             });
         },
-        workflow: async (input) => {
+        workflow: workflowFunction,
+        loop: async (input) => {
             const activeInvocation = getActiveWorkflowInvocation();
-            if (!activeInvocation) {
-                throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_FAILED, "workflow() can only be called from within a workflow invocation.");
-            }
-            if (!runtime.invocationManager) {
-                throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_FAILED, "Workflow invocation manager is not available.");
-            }
-            const result = await runtime.invocationManager.invokeChild(activeInvocation, input);
-            return result;
+            return runLoop({
+                loopInput: input,
+                runtime,
+                signal: activeInvocation?.signal || runtime.abortController.signal,
+                dsl: {
+                    agent: runAgentCall,
+                    workflow: workflowFunction,
+                    log: logWorkflow
+                }
+            });
         }
     };
 }
+function isSafeAgentId(id) {
+    if (!id)
+        return false;
+    const trimmed = id.trim();
+    const pattern = /^[A-Za-z0-9_.:-]+$/;
+    return (trimmed !== "" &&
+        trimmed !== "." &&
+        trimmed !== ".." &&
+        !trimmed.includes("/") &&
+        !trimmed.includes("\\") &&
+        !trimmed.includes("..") &&
+        pattern.test(trimmed));
+}
+function resolveLoopAgentId(currentId, input, activeLoop, isChildWorkflow, runtime) {
+    const normalizedLabel = normalizeLoopLabel(activeLoop.label);
+    const loopPrefix = `${normalizedLabel}:round-${activeLoop.roundNumber}`;
+    if (currentId === loopPrefix || currentId.startsWith(loopPrefix + ":")) {
+        return currentId;
+    }
+    let suffix;
+    if (isChildWorkflow && input.id) {
+        suffix = input.id;
+    }
+    else if (!input.id) {
+        suffix = isSafeAgentId(input.label) ? input.label.trim() : `agent-${++runtime.agentCounter}`;
+    }
+    return suffix !== undefined
+        ? createLoopAgentId({ label: activeLoop.label, roundNumber: activeLoop.roundNumber, suffix })
+        : currentId;
+}
 //# sourceMappingURL=dsl.js.map