@travisliu/open-dynamic-workflow 0.3.0

package/dist/workflow/scope.js

@@ -0,0 +1,108 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { OpenDynamicWorkflowError } from "../errors/types.js";
+import { ErrorCode } from "../errors/codes.js";
+import { getActiveWorkflowInvocation } from "./invocation-types.js";
+const scopeStorage = new AsyncLocalStorage();
+export function withDslExecutionScope(scope, fn) {
+    return scopeStorage.run(scope, fn);
+}
+export function withToolTopLevelWindow(sourcePath, fn) {
+    const parentScope = getDslExecutionScope();
+    if (!parentScope) {
+        // Should not happen during workflow execution, but if it does, 
+        // we don't have enough context to create a valid scope.
+        return fn();
+    }
+    return scopeStorage.run({
+        ...parentScope,
+        topLevelWindow: true,
+        sourcePath
+    }, fn);
+}
+export function getDslExecutionScope() {
+    return scopeStorage.getStore();
+}
+export function assertToolAllowed() {
+    const scope = getDslExecutionScope();
+    if (!scope) {
+        // If no scope is present, it's an internal error because we should always have one during workflow execution.
+        throw new OpenDynamicWorkflowError(ErrorCode.INTERNAL_ERROR, "No active DSL execution scope found.");
+    }
+    if (!scope.toolAllowed || !scope.topLevelWindow) {
+        const restriction = scope.inheritedToolRestriction || scope.location;
+        throw new OpenDynamicWorkflowError(ErrorCode.TOOL_INVALID_CONTEXT, `tool() is not allowed in ${restriction.replace(/-/g, " ")} context.`);
+    }
+    // If we are in a topLevelWindow, we must also verify we are NOT in a nested helper
+    if (scope.topLevelWindow && scope.sourcePath) {
+        const stack = new Error().stack || "";
+        const lines = stack.split("\n");
+        // Look for frames that belong to the workflow file.
+        // We expect exactly one frame (or two if executing the module top-level via VM IIFE) if it's a direct top-level call.
+        // Note: The stack starts with "Error" line, then at least one frame for assertToolAllowed, 
+        // then one or more for the DSL/executor, then the caller.
+        let workflowFrames = 0;
+        const workflowPath = scope.sourcePath;
+        for (const line of lines) {
+            // In Node.js VM, stack frames look like "at functionName (filename:line:col)"
+            // or "at filename:line:col"
+            if (line.includes(`(${workflowPath}:`) || line.includes(` ${workflowPath}:`)) {
+                workflowFrames++;
+            }
+        }
+        const hasVmContext = lines.some(line => line.includes("runInContext") || line.includes("node:vm"));
+        const maxAllowedFrames = hasVmContext ? 2 : 1;
+        if (workflowFrames > maxAllowedFrames) {
+            throw new OpenDynamicWorkflowError(ErrorCode.TOOL_INVALID_CONTEXT, "tool() is not allowed in a nested helper or callback context.");
+        }
+    }
+    return scope;
+}
+export function deriveChildWorkflowToolScope(parentScope, childInvocation) {
+    // If no parent scope, start fresh
+    if (!parentScope) {
+        return {
+            runId: childInvocation.runId,
+            workflowInvocationId: childInvocation.workflowInvocationId,
+            parentWorkflowInvocationId: childInvocation.parentWorkflowInvocationId,
+            location: "workflow-top-level",
+            toolAllowed: true,
+            topLevelWindow: false
+        };
+    }
+    // Inherit tool restriction if any
+    return {
+        runId: childInvocation.runId,
+        workflowInvocationId: childInvocation.workflowInvocationId,
+        parentWorkflowInvocationId: childInvocation.parentWorkflowInvocationId,
+        location: "workflow-top-level",
+        toolAllowed: parentScope.toolAllowed,
+        topLevelWindow: false,
+        inheritedToolRestriction: parentScope.inheritedToolRestriction || (parentScope.toolAllowed ? undefined : parentScope.location)
+    };
+}
+export function withToolForbidden(location, fn) {
+    const parentScope = getDslExecutionScope();
+    const currentInvocation = getActiveWorkflowInvocation();
+    if (!currentInvocation) {
+        // This might happen if called outside of a workflow context (e.g. shared agent execution)
+        // We still want to forbid tools.
+        return scopeStorage.run({
+            runId: "unknown",
+            workflowInvocationId: "unknown",
+            location,
+            toolAllowed: false,
+            topLevelWindow: false
+        }, fn);
+    }
+    const scope = {
+        runId: currentInvocation.runId,
+        workflowInvocationId: currentInvocation.workflowInvocationId,
+        parentWorkflowInvocationId: currentInvocation.parentWorkflowInvocationId,
+        location,
+        toolAllowed: false,
+        topLevelWindow: false,
+        inheritedToolRestriction: parentScope?.inheritedToolRestriction || (parentScope?.toolAllowed === false ? parentScope.location : undefined)
+    };
+    return scopeStorage.run(scope, fn);
+}
+//# sourceMappingURL=scope.js.map

package/dist/workflow/scope.js.map

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

package/dist/workflow/types.d.ts

@@ -0,0 +1,65 @@
+import type { ParsedWorkflow, WorkflowMeta, WorkflowInvocationSummary } from "../types/workflow.js";
+import type { ArtifactStore } from "../types/artifacts.js";
+import type { ResolvedConfig, CliRunOptions } from "../types/config.js";
+import type { AgentResult } from "../types/agent.js";
+import type { Scheduler } from "../types/scheduler.js";
+import type { AgentExecutor } from "../agents/execution-types.js";
+import type { RuntimeEventSink } from "../orchestration/scheduler.js";
+import type { PipelineSummary } from "../pipeline/types.js";
+import type { RuntimeCallCache } from "../artifacts/call-cache.js";
+import type { SharedAgentRegistry } from "../shared-agents/registry.js";
+import type { WorkflowRegistry } from "./registry.js";
+import type { WorkflowInvocationManager, WorkflowInvocationContext } from "./invocation-types.js";
+import type { JsonObject } from "../types/common.js";
+import type { ToolRegistry, ToolExecutionResult } from "../types/tool.js";
+import type { ToolExecutor } from "../tools/executor-types.js";
+export type { ParsedWorkflow, WorkflowMeta };
+export interface LoadedWorkflow {
+    sourcePath: string;
+    sourceText: string;
+}
+export interface WorkflowValidationIssue {
+    code: string;
+    message: string;
+    line?: number;
+    column?: number;
+    severity?: "error" | "warning" | undefined;
+}
+export interface RuntimeState {
+    artifactStore?: ArtifactStore | undefined;
+    workflowRegistry?: WorkflowRegistry | undefined;
+    invocationManager?: WorkflowInvocationManager | undefined;
+    currentInvocation?: WorkflowInvocationContext | undefined;
+    runId: string;
+    parsedWorkflow: ParsedWorkflow;
+    config: ResolvedConfig;
+    cli: CliRunOptions;
+    args: JsonObject;
+    cwd: string;
+    artifactsDir: string;
+    currentPhase?: string | undefined;
+    startedAt: string;
+    agentResults: AgentResult[];
+    toolResults: ToolExecutionResult[];
+    scheduler: Scheduler;
+    agentExecutor: AgentExecutor;
+    eventSink: RuntimeEventSink;
+    abortController: AbortController;
+    agentCounter: number;
+    callSequence?: number | undefined;
+    callCache?: RuntimeCallCache | undefined;
+    pipelineCounter?: number | undefined;
+    pipelineSummaries?: PipelineSummary[] | undefined;
+    workflowSummaries?: WorkflowInvocationSummary[] | undefined;
+    idGenerator?: IdGenerator | undefined;
+    failFast?: boolean | undefined;
+    sharedAgentRegistry?: SharedAgentRegistry | undefined;
+    schedulerConcurrency: number;
+    toolRegistry?: ToolRegistry | undefined;
+    toolExecutor?: ToolExecutor | undefined;
+    toolCallIds?: Set<string> | undefined;
+    toolCounter?: number | undefined;
+}
+export interface IdGenerator {
+    nextId(prefix: string): string;
+}

package/dist/workflow/types.js

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

package/dist/workflow/types.js.map

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

package/dist/workflow/validate.d.ts

@@ -0,0 +1,28 @@
+import type { SharedAgentRegistry } from "../shared-agents/registry.js";
+import type { ParsedWorkflow, WorkflowValidationIssue } from "./types.js";
+import type { WorkflowRegistry } from "./registry.js";
+import type { ToolRegistry } from "../types/tool.js";
+export interface ValidateWorkflowOptions {
+    allowImports: false;
+    allowDynamicSharedAgentIds?: boolean | undefined;
+    knownSharedAgentIds?: ReadonlySet<string> | undefined;
+    sharedAgentRegistry?: SharedAgentRegistry | undefined;
+    knownWorkflowNames?: ReadonlySet<string> | undefined;
+    workflowInputSchemas?: ReadonlyMap<string, unknown> | undefined;
+    knownToolIds?: ReadonlySet<string> | undefined;
+    toolRegistry?: ToolRegistry | undefined;
+}
+export declare function validateWorkflow(workflow: ParsedWorkflow, options: ValidateWorkflowOptions): WorkflowValidationIssue[];
+export declare function assertWorkflowValid(workflow: ParsedWorkflow, options: ValidateWorkflowOptions): void;
+export interface DependencyInfo {
+    name: string;
+    line: number;
+    character: number;
+}
+export declare function extractWorkflowDependencies(parsed: ParsedWorkflow): DependencyInfo[];
+export declare function validateRegistryDependencies(registry: WorkflowRegistry, options: {
+    sharedAgentRegistry?: SharedAgentRegistry | undefined;
+    allowDynamicSharedAgentIds?: boolean | undefined;
+    toolRegistry?: ToolRegistry | undefined;
+    rootWorkflowPath?: string | undefined;
+}): void;