@travisliu/open-dynamic-workflow 0.3.0

package/dist/cli/commands/list.d.ts

@@ -0,0 +1,12 @@
+import type { DiscoveryService, ListCliResourceType } from "../../discovery/types.js";
+export interface ListCommandInput {
+    resourceType?: string;
+    rawOptions: any;
+    deps?: {
+        discoveryService?: DiscoveryService;
+        stdout?: NodeJS.WritableStream;
+        stderr?: NodeJS.WritableStream;
+    };
+}
+export declare function validateListDirectoryFlags(cliResourceType: ListCliResourceType, rawOptions: any): void;
+export declare function listCommand(input: ListCommandInput): Promise<void>;

package/dist/cli/commands/list.js

@@ -0,0 +1,65 @@
+import { loadConfig } from "../../config/load.js";
+import { parseReportMode, parseListResourceType } from "../args.js";
+import { resolveDiscoveryDirectories } from "../../discovery/directories.js";
+import { createDiscoveryService } from "../../discovery/service.js";
+import { createListReporter } from "../../output/list-reporter.js";
+import { mapListExitCode } from "../../errors/list-errors.js";
+import { OpenDynamicWorkflowError } from "../../errors/types.js";
+import { ErrorCode } from "../../errors/codes.js";
+export function validateListDirectoryFlags(cliResourceType, rawOptions) {
+    const hasTypeSpecificFlags = rawOptions.workflowsDir !== undefined ||
+        rawOptions.agentsDir !== undefined ||
+        rawOptions.toolsDir !== undefined;
+    if (cliResourceType === "all") {
+        if (rawOptions.dir !== undefined) {
+            throw new OpenDynamicWorkflowError(ErrorCode.CLI_USAGE_ERROR, "Option '--dir' is ambiguous when listing all resource types. Use resource-specific flags like '--workflows-dir', '--agents-dir', or '--tools-dir' instead.");
+        }
+    }
+    else {
+        // Targeted command (workflows, agents, tools)
+        if (hasTypeSpecificFlags) {
+            throw new OpenDynamicWorkflowError(ErrorCode.CLI_USAGE_ERROR, `Resource-specific directory flags (e.g., '--workflows-dir') are invalid on targeted list commands. Use '--dir <path>' instead when running 'open-dynamic-workflow list ${cliResourceType}s'.`);
+        }
+    }
+}
+export async function listCommand(input) {
+    const rawOptions = input.rawOptions ?? {};
+    const cwd = rawOptions.cwd ?? process.cwd();
+    const cliResourceType = parseListResourceType(input.resourceType);
+    const reportMode = rawOptions.report ? parseReportMode(rawOptions.report) : undefined;
+    validateListDirectoryFlags(cliResourceType, rawOptions);
+    const config = await loadConfig({
+        cwd,
+        configPath: rawOptions.config,
+        cli: {
+            report: reportMode,
+            verbose: rawOptions.verbose,
+        },
+    });
+    const directories = resolveDiscoveryDirectories({
+        resourceType: cliResourceType,
+        rawOptions,
+        config,
+        cwd: config.cwd,
+    });
+    const resourceTypes = cliResourceType === "all" ? ["workflow", "agent", "tool"] : [cliResourceType];
+    const service = input.deps?.discoveryService ?? createDiscoveryService();
+    const result = await service.discover({
+        cwd: config.cwd,
+        resourceTypes: [...resourceTypes],
+        directories,
+        verbose: !!rawOptions.verbose,
+        strict: !!rawOptions.strict,
+    });
+    const reporter = createListReporter({
+        mode: config.reporting.mode,
+        streams: {
+            stdout: input.deps?.stdout ?? process.stdout,
+            stderr: input.deps?.stderr ?? process.stderr,
+        },
+        verbose: config.reporting.verbose,
+    });
+    reporter.render(result);
+    process.exitCode = mapListExitCode(result, { strict: !!rawOptions.strict });
+}
+//# sourceMappingURL=list.js.map

package/dist/cli/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAalD,MAAM,UAAU,0BAA0B,CAAC,eAAoC,EAAE,UAAe;IAC9F,MAAM,oBAAoB,GACxB,UAAU,CAAC,YAAY,KAAK,SAAS;QACrC,UAAU,CAAC,SAAS,KAAK,SAAS;QAClC,UAAU,CAAC,QAAQ,KAAK,SAAS,CAAC;IAEpC,IAAI,eAAe,KAAK,KAAK,EAAE,CAAC;QAC9B,IAAI,UAAU,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,IAAI,wBAAwB,CAChC,SAAS,CAAC,eAAe,EACzB,4JAA4J,CAC7J,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,8CAA8C;QAC9C,IAAI,oBAAoB,EAAE,CAAC;YACzB,MAAM,IAAI,wBAAwB,CAChC,SAAS,CAAC,eAAe,EACzB,0KAA0K,eAAe,KAAK,CAC/L,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAuB;IACvD,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;IAC1C,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC5C,MAAM,eAAe,GAAG,qBAAqB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEtF,0BAA0B,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;IAExD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;QAC9B,GAAG;QACH,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,GAAG,EAAE;YACH,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE,UAAU,CAAC,OAAO;SAC5B;KACF,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,2BAA2B,CAAC;QAC9C,YAAY,EAAE,eAAe;QAC7B,UAAU;QACV,MAAM;QACN,GAAG,EAAE,MAAM,CAAC,GAAG;KAChB,CAAC,CAAC;IAEH,MAAM,aAAa,GACjB,eAAe,KAAK,KAAK,CAAC,CAAC,CAAE,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAW,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IAE3F,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,gBAAgB,IAAI,sBAAsB,EAAE,CAAC;IACzE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC;QACpC,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,aAAa,EAAE,CAAC,GAAG,aAAa,CAAC;QACjC,WAAW;QACX,OAAO,EAAE,CAAC,CAAC,UAAU,CAAC,OAAO;QAC7B,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM;KAC5B,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,kBAAkB,CAAC;QAClC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI;QAC3B,OAAO,EAAE;YACP,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,IAAI,OAAO,CAAC,MAAM;YAC5C,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,IAAI,OAAO,CAAC,MAAM;SAC7C;QACD,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO;KAClC,CAAC,CAAC;IACH,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,OAAO,CAAC,QAAQ,GAAG,eAAe,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;AAC9E,CAAC"}

package/dist/cli/commands/resume.d.ts

@@ -0,0 +1,5 @@
+export interface ResumeCommandInput {
+    runIdOrPath: string;
+    rawOptions: any;
+}
+export declare function resumeCommand(input: ResumeCommandInput): Promise<void>;

package/dist/cli/commands/resume.js

@@ -0,0 +1,81 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { ErrorCode } from "../../errors/codes.js";
+import { OpenDynamicWorkflowError } from "../../errors/types.js";
+import { defaultRunsDir } from "../../artifacts/run-store.js";
+import { parseReportMode } from "../args.js";
+import { resolveUserPath } from "../paths.js";
+import { runCommand } from "./run.js";
+import { loadWorkflow } from "../../workflow/load.js";
+import { parseWorkflow } from "../../workflow/parse.js";
+export async function resumeCommand(input) {
+    const rawOptions = input.rawOptions || {};
+    const cwd = rawOptions.cwd ?? process.cwd();
+    const previousRunRoot = resolveRunRoot(input.runIdOrPath, rawOptions.out, cwd);
+    const runInputPath = path.join(previousRunRoot, "run-input.json");
+    let runInput;
+    try {
+        runInput = JSON.parse(await fs.readFile(runInputPath, "utf8"));
+    }
+    catch (err) {
+        throw new OpenDynamicWorkflowError(ErrorCode.CLI_USAGE_ERROR, `Cannot resume '${input.runIdOrPath}' because run-input.json is missing or unreadable. Use 'open-dynamic-workflow run <workflow> --resume <run-id>' for older runs.`, { cause: err });
+    }
+    if (runInput.schemaVersion !== "open-dynamic-workflow.run-input.v1" || typeof runInput.workflowFile !== "string") {
+        throw new OpenDynamicWorkflowError(ErrorCode.CLI_USAGE_ERROR, `Cannot resume '${input.runIdOrPath}' because run-input.json is invalid.`);
+    }
+    // Identity validation
+    if (runInput.workflowName) {
+        try {
+            const loaded = await loadWorkflow(runInput.workflowFile, runInput.cwd || cwd);
+            const parsed = parseWorkflow(loaded);
+            if (parsed.meta.name !== runInput.workflowName) {
+                throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_RESUME_TARGET_CHANGED, `The recorded workflow file exists, but its meta.name changed from "${runInput.workflowName}" to "${parsed.meta.name}".`);
+            }
+        }
+        catch (err) {
+            if (err instanceof OpenDynamicWorkflowError && err.code === ErrorCode.WORKFLOW_RESUME_TARGET_CHANGED) {
+                throw err;
+            }
+            // If file is missing or unparseable, let runCommand handle it or re-throw as validation error.
+            if (err instanceof OpenDynamicWorkflowError)
+                throw err;
+            throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_VALIDATION_ERROR, `Failed to validate workflow identity during resume: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    const storedOptions = runInput.rawOptions && typeof runInput.rawOptions === "object" ? runInput.rawOptions : {};
+    // Resolve noCache: command line overrides stored options
+    let noCache = storedOptions.noCache;
+    if (rawOptions.cache === false || rawOptions.noCache === true) {
+        noCache = true;
+    }
+    else if (rawOptions.cache === true) {
+        noCache = false;
+    }
+    const resumeOptions = {
+        ...storedOptions,
+        resume: previousRunRoot,
+        cwd: runInput.cwd ?? storedOptions.cwd ?? cwd,
+        out: rawOptions.out ? resolveUserPath(rawOptions.out, cwd) : storedOptions.out,
+        noCache,
+        report: rawOptions.report !== undefined ? parseReportMode(rawOptions.report) : storedOptions.report,
+        // Preserve target metadata for runCommand to use in artifacts
+        originalRequestedTarget: runInput.requestedTarget,
+        originalTargetKind: runInput.targetKind,
+        originalWorkflowName: runInput.workflowName
+    };
+    await runCommand({
+        workflowFile: runInput.workflowFile,
+        rawOptions: resumeOptions
+    });
+}
+function resolveRunRoot(runIdOrPath, outDir, cwd) {
+    if (!runIdOrPath || typeof runIdOrPath !== "string" || runIdOrPath.trim() === "") {
+        throw new OpenDynamicWorkflowError(ErrorCode.CLI_USAGE_ERROR, "resume requires a run id or run directory path.");
+    }
+    if (path.isAbsolute(runIdOrPath)) {
+        return runIdOrPath;
+    }
+    const root = outDir ? resolveUserPath(outDir, cwd) : defaultRunsDir(cwd);
+    return path.resolve(root, runIdOrPath);
+}
+//# sourceMappingURL=resume.js.map

package/dist/cli/commands/resume.js.map

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

package/dist/cli/commands/run.d.ts

@@ -0,0 +1,18 @@
+import { type RuntimeRunner } from "../../runtime/public.js";
+export interface RunCommandDeps {
+    runtimeRunner: RuntimeRunner;
+    stdout?: NodeJS.WritableStream;
+    stderr?: NodeJS.WritableStream;
+}
+export interface RunCommandInput {
+    workflowFile: string;
+    rawOptions: any;
+    deps?: Partial<RunCommandDeps>;
+}
+export interface RunWorkflowServiceInput {
+    workflowFile: string;
+    rawOptions?: any;
+    deps?: Partial<RunCommandDeps>;
+}
+export declare function runWorkflowService(input: RunWorkflowServiceInput): Promise<void>;
+export declare function runCommand(input: RunCommandInput): Promise<void>;

package/dist/cli/commands/run.js

@@ -0,0 +1,318 @@
+import { ErrorCode } from "../../errors/codes.js";
+import { OpenDynamicWorkflowError } from "../../errors/types.js";
+import { loadConfig } from "../../config/load.js";
+import { discoverWorkflowRegistry } from "../../workflow/discovery.js";
+import { resolveWorkflowTarget } from "../../workflow/resolve-target.js";
+import { parseKeyValueArgs, parsePositiveInteger, parseReportMode } from "../args.js";
+import { printDryRunSummary } from "../print.js";
+import { DefaultRuntimeRunner } from "../../runtime/public.js";
+import { FileSystemArtifactStore } from "../../artifacts/run-store.js";
+import { DefaultAgentExecutor } from "../../agents/execute-agent.js";
+import { createReporter } from "../../output/reporter.js";
+import { EventBus } from "../../orchestration/event-bus.js";
+import { loadSharedAgentRegistry } from "../../shared-agents/load.js";
+import { loadToolRegistry } from "../../tools/load.js";
+import { DefaultToolExecutor } from "../../tools/executor.js";
+import * as path from "node:path";
+export async function runWorkflowService(input) {
+    const rawOptions = input.rawOptions || {};
+    const cwd = rawOptions.cwd ?? process.cwd();
+    // Parse option arguments cleanly
+    const parsedArgs = parseKeyValueArgs(rawOptions.arg || []);
+    const concurrency = rawOptions.concurrency !== undefined
+        ? parsePositiveInteger(rawOptions.concurrency, "--concurrency")
+        : undefined;
+    const timeoutMs = rawOptions.timeoutMs !== undefined
+        ? parsePositiveInteger(rawOptions.timeoutMs, "--timeout-ms")
+        : undefined;
+    const reportMode = rawOptions.report !== undefined
+        ? parseReportMode(rawOptions.report)
+        : undefined;
+    const noCache = rawOptions.cache === false || rawOptions.noCache === true;
+    if (rawOptions.resume !== undefined && (typeof rawOptions.resume !== "string" || rawOptions.resume.trim() === "")) {
+        throw new OpenDynamicWorkflowError(ErrorCode.CLI_USAGE_ERROR, "CLI option '--resume' value must be a non-empty string.");
+    }
+    if (rawOptions.model !== undefined && (typeof rawOptions.model !== "string" || rawOptions.model.trim() === "")) {
+        throw new OpenDynamicWorkflowError(ErrorCode.CLI_USAGE_ERROR, "CLI option '--model' value must be a non-empty string.");
+    }
+    const cliOverrides = {};
+    if (rawOptions.provider !== undefined)
+        cliOverrides.provider = rawOptions.provider;
+    if (rawOptions.model !== undefined)
+        cliOverrides.model = rawOptions.model;
+    if (concurrency !== undefined)
+        cliOverrides.concurrency = concurrency;
+    if (timeoutMs !== undefined)
+        cliOverrides.timeoutMs = timeoutMs;
+    if (reportMode !== undefined)
+        cliOverrides.report = reportMode;
+    if (rawOptions.verbose !== undefined)
+        cliOverrides.verbose = !!rawOptions.verbose;
+    // Load config
+    const config = await loadConfig({
+        cwd,
+        configPath: rawOptions.config,
+        outDir: rawOptions.out,
+        cli: cliOverrides
+    });
+    // Resolve workflow target
+    const resolved = await resolveWorkflowTarget({
+        target: input.workflowFile,
+        cwd: config.cwd,
+        config,
+        mode: "run"
+    });
+    // During resume, preserve original target metadata if provided
+    if (rawOptions.originalRequestedTarget) {
+        resolved.requestedTarget = rawOptions.originalRequestedTarget;
+    }
+    if (rawOptions.originalTargetKind) {
+        resolved.targetKind = rawOptions.originalTargetKind;
+    }
+    if (rawOptions.originalWorkflowName) {
+        resolved.workflowName = rawOptions.originalWorkflowName;
+    }
+    // Load shared agent registry
+    const sharedAgentRegistry = await loadSharedAgentRegistry({
+        cwd: config.cwd,
+        dir: config.sharedAgents?.dir,
+        maxDefinitions: config.sharedAgents?.maxDefinitions,
+        strictPromptTemplateVariables: config.sharedAgents?.strictPromptTemplateVariables
+    });
+    // Load tool registry
+    const toolRegistry = await loadToolRegistry({
+        cwd: config.cwd,
+        dir: config.tools?.dir,
+        maxDefinitions: config.tools?.maxDefinitions ?? 100
+    });
+    // Discover and validate workflow registry
+    const workflowRegistry = await discoverWorkflowRegistry({
+        rootWorkflowPath: resolved.workflowFile,
+        cwd: config.cwd,
+        include: config.workflow.discovery.include,
+        candidatePaths: resolved.candidatePaths,
+        sharedAgentRegistry,
+        toolRegistry,
+        allowDynamicSharedAgentIds: config.sharedAgents?.allowDynamicIds
+    });
+    // Retrieve root workflow
+    const absoluteRootPath = path.resolve(config.cwd, resolved.workflowFile);
+    const rootDefinition = workflowRegistry.list().find(d => d.sourcePath === absoluteRootPath);
+    if (!rootDefinition) {
+        throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_DEFINITION_NOT_FOUND, `Root workflow definition not found in discovery: ${absoluteRootPath}`);
+    }
+    const parsed = rootDefinition.parsedWorkflow;
+    // Dry run check
+    if (rawOptions.dryRun) {
+        printDryRunSummary({
+            workflowFile: resolved.workflowFileRelative,
+            workflowName: resolved.workflowName,
+            description: parsed.meta.description,
+            phases: parsed.meta.phases || [],
+            provider: config.defaultProvider,
+            defaultModel: config.defaultModel,
+            providers: config.providers,
+            concurrency: config.concurrency,
+            timeoutMs: config.timeoutMs,
+            reportMode: config.reporting.mode,
+            outDir: config.outDir,
+            verbose: config.reporting.verbose
+        });
+        return;
+    }
+    const runIdGenerated = crypto.randomUUID();
+    const runOutDir = path.join(config.outDir, runIdGenerated);
+    const artifactStore = new FileSystemArtifactStore({ rootDir: config.outDir });
+    // Initialize abort controller early for tools and agents
+    const abortController = new AbortController();
+    const sigIntHandler = () => {
+        abortController.abort("SIGINT received");
+    };
+    process.on("SIGINT", sigIntHandler);
+    const workflowIdentity = {
+        name: rawOptions.originalWorkflowName || resolved.workflowName,
+        file: resolved.workflowFileRelative,
+        requestedTarget: rawOptions.originalRequestedTarget || resolved.requestedTarget,
+        targetKind: rawOptions.originalTargetKind || resolved.targetKind
+    };
+    const runtimeWorkflowIdentity = {
+        name: workflowIdentity.name,
+        file: workflowIdentity.file,
+        requestedTarget: workflowIdentity.requestedTarget,
+        targetKind: workflowIdentity.targetKind,
+        workflowFile: resolved.workflowFile,
+        workflowFileRelative: resolved.workflowFileRelative,
+        discoverySource: resolved.discoverySource
+    };
+    // Initialize artifact store before running so it's ready regardless of which runner is used.
+    await artifactStore.createRun({
+        runId: runIdGenerated,
+        outDir: runOutDir,
+        workflowPath: resolved.workflowFile,
+        workflowSource: rootDefinition.parsedWorkflow.sourceText || "",
+        workflowHash: parsed.sourceHash,
+        workflow: workflowIdentity,
+        resolvedConfig: config,
+        openDynamicWorkflowVersion: parsed.meta.version || "0.0.0",
+        cwd,
+        configPath: rawOptions.config
+    });
+    await artifactStore.writeJson("run-input.json", {
+        schemaVersion: "open-dynamic-workflow.run-input.v1",
+        runId: runIdGenerated,
+        workflowFile: resolved.workflowFile,
+        requestedTarget: resolved.requestedTarget,
+        targetKind: resolved.targetKind,
+        workflowName: resolved.workflowName,
+        cwd: config.cwd,
+        outDir: config.outDir,
+        configPath: config.configPath,
+        rawOptions: {
+            provider: rawOptions.provider,
+            model: rawOptions.model,
+            arg: rawOptions.arg || [],
+            config: config.configPath,
+            cwd: config.cwd,
+            out: config.outDir,
+            report: rawOptions.report,
+            concurrency: rawOptions.concurrency,
+            timeoutMs: rawOptions.timeoutMs,
+            resume: rawOptions.resume,
+            noCache: noCache,
+            failFast: !!rawOptions.failFast,
+            verbose: !!rawOptions.verbose
+        }
+    });
+    const reporter = createReporter({
+        mode: config.reporting.mode,
+        verbose: config.reporting.verbose,
+        streams: {
+            stdout: input.deps?.stdout ?? process.stdout,
+            stderr: input.deps?.stderr ?? process.stderr
+        }
+    });
+    const eventBus = new EventBus({
+        runId: runIdGenerated,
+        artifactStore,
+        subscribers: [
+            {
+                handle(event) {
+                    reporter.handle(event);
+                }
+            }
+        ]
+    });
+    // Note: workflow.resolved is now emitted inside the runtime runner execution boundary.
+    const agentExecutor = new DefaultAgentExecutor({
+        config: config,
+        artifactStore,
+        eventBus
+    });
+    // Collect secrets for tool redaction
+    const secretPatterns = config.security?.redactEnv ?? [];
+    const secretValues = [];
+    for (const [key, value] of Object.entries(process.env)) {
+        if (value && typeof value === "string") {
+            const { shouldRedactEnvName } = await import("../../security/env.js");
+            if (shouldRedactEnvName(key, secretPatterns)) {
+                secretValues.push(value);
+            }
+        }
+    }
+    const toolExecutor = new DefaultToolExecutor({
+        concurrency: config.tools?.concurrency ?? 1,
+        eventSink: eventBus,
+        artifactStore,
+        runArtifacts: artifactStore.getRunArtifacts(),
+        runId: runIdGenerated,
+        cwd: config.cwd,
+        rootSignal: abortController.signal,
+        redactedSecrets: secretValues
+    });
+    reporter.start({
+        runId: runIdGenerated,
+        meta: parsed.meta,
+        workflow: workflowIdentity,
+        artifactsDir: runOutDir
+    });
+    const defaultRunner = new DefaultRuntimeRunner();
+    const runner = input.deps?.runtimeRunner ?? defaultRunner;
+    try {
+        const result = await runner.run({
+            parsedWorkflow: parsed,
+            workflowRegistry,
+            workflowIdentity: runtimeWorkflowIdentity,
+            config: config,
+            cli: {
+                workflowFile: rootDefinition.sourcePath,
+                provider: rawOptions.provider,
+                model: rawOptions.model,
+                args: parsedArgs,
+                cwd: config.cwd,
+                outDir: runOutDir,
+                report: config.reporting.mode,
+                concurrency: config.concurrency,
+                timeoutMs: config.timeoutMs,
+                resume: rawOptions.resume,
+                noCache,
+                dryRun: false,
+                failFast: !!rawOptions.failFast,
+                verbose: config.reporting.verbose
+            },
+            signal: abortController.signal,
+            sharedAgentRegistry,
+            toolRegistry
+        }, (() => {
+            let pipelineCounter = 0;
+            return {
+                agentExecutor,
+                eventSink: eventBus,
+                artifactStore,
+                toolExecutor,
+                idGenerator: {
+                    nextId: (prefix) => {
+                        if (prefix === "run")
+                            return runIdGenerated;
+                        if (prefix === "pipeline") {
+                            pipelineCounter += 1;
+                            return `pipeline-${pipelineCounter}`;
+                        }
+                        return crypto.randomUUID();
+                    }
+                }
+            };
+        })());
+        await eventBus.drain();
+        // Attach workflow identity to result
+        result.workflow = workflowIdentity;
+        if (artifactStore.isRunCreated()) {
+            await artifactStore.writeFinalReport(result);
+        }
+        await reporter.finish(result);
+        if (result.status === "failed") {
+            const agents = result.agents || [];
+            const hasTimeout = agents.some((a) => a.status === "timed_out");
+            let errorCode = hasTimeout ? ErrorCode.PROCESS_TIMEOUT : ErrorCode.PROVIDER_PROCESS_FAILED;
+            // Preserve specific error code if present
+            if (result.error && typeof result.error === "object" && result.error.code) {
+                if (Object.values(ErrorCode).includes(result.error.code)) {
+                    errorCode = result.error.code;
+                }
+            }
+            const errMessage = typeof result.error === "string"
+                ? result.error
+                : result.error?.message || "Workflow run failed";
+            throw new OpenDynamicWorkflowError(errorCode, errMessage, { cause: result.error });
+        }
+        else if (result.status === "cancelled") {
+            throw new OpenDynamicWorkflowError(ErrorCode.USER_CANCELLED, "Workflow run was cancelled");
+        }
+    }
+    finally {
+        process.off("SIGINT", sigIntHandler);
+    }
+}
+export async function runCommand(input) {
+    await runWorkflowService(input);
+}
+//# sourceMappingURL=run.js.map

package/dist/cli/commands/run.js.map

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

package/dist/cli/commands/validate.d.ts

@@ -0,0 +1,14 @@
+export interface ValidateCommandInput {
+    workflowFile: string;
+    rawOptions: any;
+}
+export interface ValidateWorkflowServiceInput {
+    workflowFile: string;
+    rawOptions?: any;
+}
+export interface ValidateWorkflowServiceResult {
+    workflowName: string;
+    workflowFileRelative: string;
+}
+export declare function validateWorkflowService(input: ValidateWorkflowServiceInput): Promise<ValidateWorkflowServiceResult>;
+export declare function validateCommand(input: ValidateCommandInput): Promise<void>;

package/dist/cli/commands/validate.js

@@ -0,0 +1,66 @@
+import { ErrorCode } from "../../errors/codes.js";
+import { OpenDynamicWorkflowError } from "../../errors/types.js";
+import { loadConfig } from "../../config/load.js";
+import { discoverWorkflowRegistry } from "../../workflow/discovery.js";
+import { resolveWorkflowTarget } from "../../workflow/resolve-target.js";
+import { loadSharedAgentRegistry } from "../../shared-agents/load.js";
+import { loadToolRegistry } from "../../tools/load.js";
+import { printValidationSuccess } from "../print.js";
+import * as path from "node:path";
+export async function validateWorkflowService(input) {
+    const rawOptions = input.rawOptions || {};
+    const cwd = rawOptions.cwd ?? process.cwd();
+    // Load config (resolves paths, merges defaults, etc.)
+    const config = await loadConfig({
+        cwd,
+        configPath: rawOptions.config,
+        cli: {
+            verbose: rawOptions.verbose
+        }
+    });
+    // Resolve workflow target
+    const resolved = await resolveWorkflowTarget({
+        target: input.workflowFile,
+        cwd: config.cwd,
+        config,
+        mode: "validate"
+    });
+    // Load shared agent registry
+    const sharedAgentRegistry = await loadSharedAgentRegistry({
+        cwd: config.cwd,
+        dir: config.sharedAgents?.dir,
+        maxDefinitions: config.sharedAgents?.maxDefinitions,
+        strictPromptTemplateVariables: config.sharedAgents?.strictPromptTemplateVariables
+    });
+    // Load tool registry
+    const toolRegistry = await loadToolRegistry({
+        cwd: config.cwd,
+        dir: config.tools?.dir,
+        maxDefinitions: config.tools?.maxDefinitions ?? 100
+    });
+    // Discover and validate workflow registry (this performs full validation)
+    const workflowRegistry = await discoverWorkflowRegistry({
+        rootWorkflowPath: resolved.workflowFile,
+        cwd: config.cwd,
+        include: config.workflow.discovery.include,
+        candidatePaths: resolved.candidatePaths,
+        sharedAgentRegistry,
+        toolRegistry,
+        allowDynamicSharedAgentIds: config.sharedAgents?.allowDynamicIds
+    });
+    // Find root workflow in registry by path
+    const absoluteRootPath = path.resolve(config.cwd, resolved.workflowFile);
+    const rootDefinition = workflowRegistry.list().find(d => d.sourcePath === absoluteRootPath);
+    if (!rootDefinition) {
+        throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_DEFINITION_NOT_FOUND, `Root workflow definition not found in discovery: ${absoluteRootPath}`);
+    }
+    return {
+        workflowName: rootDefinition.name,
+        workflowFileRelative: resolved.workflowFileRelative
+    };
+}
+export async function validateCommand(input) {
+    const result = await validateWorkflowService(input);
+    printValidationSuccess(result.workflowName, result.workflowFileRelative);
+}
+//# sourceMappingURL=validate.js.map

package/dist/cli/commands/validate.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare function main(argv: string[]): Promise<void>;