@travisliu/open-dynamic-workflow 0.3.0

package/dist/workflow/json.js

@@ -0,0 +1,117 @@
+import { ErrorCode } from "../errors/codes.js";
+import { OpenDynamicWorkflowError } from "../errors/types.js";
+/**
+ * Clones a value while ensuring it is strictly JSON-compatible.
+ * Throws InvalidDslCallError (or similar) if the value contains non-JSON types or circular references.
+ */
+export function cloneJsonValue(value, label) {
+    return cloneRecursive(value, label, new Set());
+}
+/**
+ * Clones an object while ensuring it is strictly JSON-compatible.
+ */
+export function cloneJsonObject(value, label) {
+    const cloned = cloneJsonValue(value, label);
+    if (cloned === null || typeof cloned !== "object" || Array.isArray(cloned)) {
+        throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_INVALID_CALL, `${label} must be a plain object.`);
+    }
+    return cloned;
+}
+function cloneRecursive(value, label, seen) {
+    // Primitives
+    if (value === null)
+        return null;
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_INVALID_CALL, `${label} contains non-finite number: ${value}`);
+        }
+        return value;
+    }
+    // Reject explicitly unsupported types
+    if (value === undefined) {
+        throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_INVALID_CALL, `${label} cannot be undefined.`);
+    }
+    if (typeof value === "function") {
+        throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_INVALID_CALL, `${label} contains a function.`);
+    }
+    if (typeof value === "symbol") {
+        throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_INVALID_CALL, `${label} contains a symbol.`);
+    }
+    if (typeof value === "bigint") {
+        throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_INVALID_CALL, `${label} contains a bigint.`);
+    }
+    // Circular reference detection
+    if (seen.has(value)) {
+        throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_INVALID_CALL, `${label} contains a circular reference.`);
+    }
+    // Arrays
+    if (Array.isArray(value)) {
+        seen.add(value);
+        const cloned = value.map((item, index) => {
+            const result = cloneRecursive(item, `${label}[${index}]`, seen);
+            return result === undefined ? null : result;
+        });
+        seen.delete(value);
+        return cloned;
+    }
+    // Objects
+    if (typeof value === "object") {
+        // Check for "thenables" or Promises
+        if ("then" in value && typeof value.then === "function") {
+            throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_INVALID_CALL, `${label} contains a Promise or thenable.`);
+        }
+        // Check for other non-plain objects
+        const proto = Object.getPrototypeOf(value);
+        if (proto !== null && proto !== Object.prototype) {
+            // In some environments (like VM contexts), proto might be Object.prototype from a different context.
+            // We check if it's still a "plain" object by looking at the constructor name.
+            if (proto.constructor?.name === "Object") {
+                // Fall through to plain object handling
+            }
+            else {
+                // It's a class instance, Map, Set, Date, Buffer, etc.
+                if (value instanceof Date) {
+                    throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_INVALID_CALL, `${label} contains a Date.`);
+                }
+                if (value instanceof Map) {
+                    throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_INVALID_CALL, `${label} contains a Map.`);
+                }
+                if (value instanceof Set) {
+                    throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_INVALID_CALL, `${label} contains a Set.`);
+                }
+                if (value instanceof Error) {
+                    throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_INVALID_CALL, `${label} contains an Error.`);
+                }
+                if (globalThis.Buffer && value instanceof globalThis.Buffer) {
+                    throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_INVALID_CALL, `${label} contains a Buffer.`);
+                }
+                if (ArrayBuffer.isView(value)) {
+                    throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_INVALID_CALL, `${label} contains a TypedArray or DataView.`);
+                }
+                // General rejection for class instances or complex types
+                throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_INVALID_CALL, `${label} contains an unsupported object type: ${value.constructor?.name || "Unknown"}`);
+            }
+        }
+        seen.add(value);
+        const cloned = {};
+        for (const key of Object.keys(value)) {
+            const descriptor = Object.getOwnPropertyDescriptor(value, key);
+            if (descriptor?.get || descriptor?.set) {
+                throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_INVALID_CALL, `${label}.${key} contains accessors.`);
+            }
+            const val = cloneRecursive(value[key], `${label}.${key}`, seen);
+            if (val !== undefined) {
+                cloned[key] = val;
+            }
+        }
+        seen.delete(value);
+        return cloned;
+    }
+    // Fallback for anything else (shouldn't really happen with above checks)
+    throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_INVALID_CALL, `${label} contains an unsupported value: ${value}`);
+}
+//# sourceMappingURL=json.js.map

package/dist/workflow/json.js.map

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

package/dist/workflow/load.d.ts

@@ -0,0 +1,2 @@
+import type { LoadedWorkflow } from "./types.js";
+export declare function loadWorkflow(pathInput: string, cwd: string): Promise<LoadedWorkflow>;

package/dist/workflow/load.js

@@ -0,0 +1,18 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { ErrorCode } from "../errors/codes.js";
+import { OpenDynamicWorkflowError } from "../errors/types.js";
+export async function loadWorkflow(pathInput, cwd) {
+    const sourcePath = resolve(cwd, pathInput);
+    try {
+        const sourceText = await readFile(sourcePath, "utf8");
+        return {
+            sourcePath,
+            sourceText: sourceText.replace(/\r\n/g, "\n")
+        };
+    }
+    catch (cause) {
+        throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_PARSE_ERROR, `Unable to read workflow file: ${sourcePath}`, { cause });
+    }
+}
+//# sourceMappingURL=load.js.map

package/dist/workflow/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/workflow/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAiB,EAAE,GAAW;IAC/D,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACtD,OAAO;YACL,UAAU;YACV,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;SAC9C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,wBAAwB,CAChC,SAAS,CAAC,oBAAoB,EAC9B,iCAAiC,UAAU,EAAE,EAC7C,EAAE,KAAK,EAAE,CACV,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/workflow/parse.d.ts

@@ -0,0 +1,2 @@
+import type { LoadedWorkflow, ParsedWorkflow } from "./types.js";
+export declare function parseWorkflow(loaded: LoadedWorkflow): ParsedWorkflow;

package/dist/workflow/parse.js

@@ -0,0 +1,135 @@
+import { createHash } from "node:crypto";
+import ts from "typescript";
+import { ErrorCode } from "../errors/codes.js";
+import { OpenDynamicWorkflowError } from "../errors/types.js";
+function hashSource(sourceText) {
+    return createHash("sha256").update(sourceText).digest("hex");
+}
+function parseJsonLiteral(node) {
+    if (ts.isStringLiteral(node))
+        return node.text;
+    if (ts.isNumericLiteral(node))
+        return Number(node.text);
+    if (node.kind === ts.SyntaxKind.TrueKeyword)
+        return true;
+    if (node.kind === ts.SyntaxKind.FalseKeyword)
+        return false;
+    if (node.kind === ts.SyntaxKind.NullKeyword)
+        return null;
+    if (ts.isArrayLiteralExpression(node)) {
+        return node.elements.map(element => {
+            if (ts.isSpreadElement(element)) {
+                throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_PARSE_ERROR, "Metadata inputSchema must be a static JSON object.");
+            }
+            return parseJsonLiteral(element);
+        });
+    }
+    if (ts.isObjectLiteralExpression(node)) {
+        const result = {};
+        for (const prop of node.properties) {
+            if (!ts.isPropertyAssignment(prop)) {
+                throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_PARSE_ERROR, "Metadata inputSchema must be a static JSON object.");
+            }
+            if (!ts.isIdentifier(prop.name) && !ts.isStringLiteral(prop.name)) {
+                throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_PARSE_ERROR, "Metadata inputSchema keys must be identifiers or string literals.");
+            }
+            result[prop.name.text] = parseJsonLiteral(prop.initializer);
+        }
+        return result;
+    }
+    throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_PARSE_ERROR, "Metadata inputSchema must be a static JSON object.");
+}
+export function parseWorkflow(loaded) {
+    const sourceFile = ts.createSourceFile(loaded.sourcePath, loaded.sourceText, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    if (sourceFile.statements.length === 0) {
+        throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_PARSE_ERROR, "Workflow file is empty.");
+    }
+    const statement = sourceFile.statements[0];
+    const isVariable = statement && ts.isVariableStatement(statement);
+    const modifiers = isVariable ? ts.getModifiers(statement) : undefined;
+    const hasExport = isVariable && modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword);
+    const declarations = isVariable ? statement.declarationList.declarations : [];
+    const firstDecl = declarations[0];
+    const hasMetaName = declarations.length === 1 &&
+        firstDecl &&
+        ts.isIdentifier(firstDecl.name) &&
+        firstDecl.name.text === "meta";
+    if (!isVariable || !hasExport || !hasMetaName) {
+        throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_PARSE_ERROR, "Metadata ('export const meta') must be the first top-level statement.");
+    }
+    const initializer = firstDecl?.initializer;
+    if (!initializer || !ts.isObjectLiteralExpression(initializer)) {
+        throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_PARSE_ERROR, "Metadata must be a literal object.");
+    }
+    const meta = {};
+    for (const property of initializer.properties) {
+        if (!ts.isPropertyAssignment(property)) {
+            throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_PARSE_ERROR, "Metadata properties must be standard property assignments.");
+        }
+        let keyName;
+        if (ts.isIdentifier(property.name)) {
+            keyName = property.name.text;
+        }
+        else if (ts.isStringLiteral(property.name)) {
+            keyName = property.name.text;
+        }
+        else {
+            throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_PARSE_ERROR, "Metadata keys must be identifiers or string literals.");
+        }
+        const value = property.initializer;
+        if (keyName === "phases") {
+            if (!ts.isArrayLiteralExpression(value)) {
+                throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_PARSE_ERROR, "Metadata phases must be an array literal of string literals.");
+            }
+            const phases = [];
+            for (const element of value.elements) {
+                if (!ts.isStringLiteral(element)) {
+                    throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_PARSE_ERROR, "Metadata phases must contain only string literals.");
+                }
+                phases.push(element.text);
+            }
+            meta[keyName] = phases;
+        }
+        else if (keyName === "tags") {
+            if (!ts.isArrayLiteralExpression(value)) {
+                throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_PARSE_ERROR, "Metadata tags must be an array literal of string literals.");
+            }
+            const tags = [];
+            for (const element of value.elements) {
+                if (!ts.isStringLiteral(element)) {
+                    throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_PARSE_ERROR, "Metadata tags must contain only string literals.");
+                }
+                tags.push(element.text);
+            }
+            meta[keyName] = tags;
+        }
+        else if (keyName === "name" || keyName === "description" || keyName === "version") {
+            if (!ts.isStringLiteral(value)) {
+                throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_PARSE_ERROR, `Metadata ${keyName} must be a string literal.`);
+            }
+            meta[keyName] = value.text;
+        }
+        else if (keyName === "inputSchema") {
+            meta[keyName] = parseJsonLiteral(value);
+        }
+        else {
+            throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_PARSE_ERROR, `Unexpected metadata property: ${keyName}`);
+        }
+    }
+    if (!meta.name || meta.name.trim() === "") {
+        throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_PARSE_ERROR, "Metadata name is required and cannot be empty.");
+    }
+    if (!meta.description || meta.description.trim() === "") {
+        throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_PARSE_ERROR, "Metadata description is required and cannot be empty.");
+    }
+    const body = loaded.sourceText.substring(statement.end).trim();
+    const sourceHash = hashSource(loaded.sourceText);
+    return {
+        meta: meta,
+        body,
+        sourcePath: loaded.sourcePath,
+        sourceText: loaded.sourceText,
+        sourceHash
+    };
+}
+//# sourceMappingURL=parse.js.map

package/dist/workflow/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/workflow/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,SAAS,UAAU,CAAC,UAAkB;IACpC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAmB;IAC3C,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IAC/C,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IACzD,IAAI,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IAC3D,IAAI,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IACzD,IAAI,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;YACjC,IAAI,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChC,MAAM,IAAI,wBAAwB,CAAC,SAAS,CAAC,oBAAoB,EAAE,oDAAoD,CAAC,CAAC;YAC3H,CAAC;YACD,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,wBAAwB,CAAC,SAAS,CAAC,oBAAoB,EAAE,oDAAoD,CAAC,CAAC;YAC3H,CAAC;YACD,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClE,MAAM,IAAI,wBAAwB,CAAC,SAAS,CAAC,oBAAoB,EAAE,mEAAmE,CAAC,CAAC;YAC1I,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,IAAI,wBAAwB,CAAC,SAAS,CAAC,oBAAoB,EAAE,oDAAoD,CAAC,CAAC;AAC3H,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAsB;IAClD,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CACpC,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,UAAU,EACjB,EAAE,CAAC,YAAY,CAAC,MAAM,EACtB,IAAI,EACJ,EAAE,CAAC,UAAU,CAAC,EAAE,CACjB,CAAC;IAEF,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,wBAAwB,CAChC,SAAS,CAAC,oBAAoB,EAC9B,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAE3C,MAAM,UAAU,GAAG,SAAS,IAAI,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,SAAiC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9F,MAAM,SAAS,GAAG,UAAU,IAAI,SAAS,EAAE,IAAI,CAC7C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,aAAa,CAC9C,CAAC;IACF,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAE,SAAkC,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IACxG,MAAM,SAAS,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,KAAK,CAAC;QAC3C,SAAS;QACT,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC;QAC/B,SAAS,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;IAEjC,IAAI,CAAC,UAAU,IAAI,CAAC,SAAS,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,IAAI,wBAAwB,CAChC,SAAS,CAAC,oBAAoB,EAC9B,uEAAuE,CACxE,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,SAAS,EAAE,WAAW,CAAC;IAC3C,IAAI,CAAC,WAAW,IAAI,CAAC,EAAE,CAAC,yBAAyB,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,wBAAwB,CAChC,SAAS,CAAC,oBAAoB,EAC9B,oCAAoC,CACrC,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAQ,EAAE,CAAC;IACrB,KAAK,MAAM,QAAQ,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;QAC9C,IAAI,CAAC,EAAE,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,wBAAwB,CAChC,SAAS,CAAC,oBAAoB,EAC9B,4DAA4D,CAC7D,CAAC;QACJ,CAAC;QAED,IAAI,OAAe,CAAC;QACpB,IAAI,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAC/B,CAAC;aAAM,IAAI,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,wBAAwB,CAChC,SAAS,CAAC,oBAAoB,EAC9B,uDAAuD,CACxD,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,CAAC;QACnC,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,EAAE,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxC,MAAM,IAAI,wBAAwB,CAChC,SAAS,CAAC,oBAAoB,EAC9B,8DAA8D,CAC/D,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACrC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;oBACjC,MAAM,IAAI,wBAAwB,CAChC,SAAS,CAAC,oBAAoB,EAC9B,oDAAoD,CACrD,CAAC;gBACJ,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC;QACzB,CAAC;aAAM,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YAC9B,IAAI,CAAC,EAAE,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxC,MAAM,IAAI,wBAAwB,CAChC,SAAS,CAAC,oBAAoB,EAC9B,4DAA4D,CAC7D,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAa,EAAE,CAAC;YAC1B,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACrC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;oBACjC,MAAM,IAAI,wBAAwB,CAChC,SAAS,CAAC,oBAAoB,EAC9B,kDAAkD,CACnD,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;QACvB,CAAC;aAAM,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,aAAa,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACpF,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,wBAAwB,CAChC,SAAS,CAAC,oBAAoB,EAC9B,YAAY,OAAO,4BAA4B,CAChD,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;QAC7B,CAAC;aAAM,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;YACrC,IAAI,CAAC,OAAO,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,wBAAwB,CAChC,SAAS,CAAC,oBAAoB,EAC9B,iCAAiC,OAAO,EAAE,CAC3C,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,wBAAwB,CAChC,SAAS,CAAC,oBAAoB,EAC9B,gDAAgD,CACjD,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACxD,MAAM,IAAI,wBAAwB,CAChC,SAAS,CAAC,oBAAoB,EAC9B,uDAAuD,CACxD,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/D,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAEjD,OAAO;QACL,IAAI,EAAE,IAAoB;QAC1B,IAAI;QACJ,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/workflow/registry.d.ts

@@ -0,0 +1,18 @@
+import type { ParsedWorkflow, WorkflowMeta } from "../types/workflow.js";
+export interface WorkflowDefinition {
+    name: string;
+    description: string;
+    sourcePath: string;
+    meta: WorkflowMeta;
+    parsedWorkflow: ParsedWorkflow;
+    inputSchema?: unknown;
+}
+export interface WorkflowRegistry {
+    get(name: string): WorkflowDefinition | undefined;
+    require(name: string): WorkflowDefinition;
+    list(): readonly WorkflowDefinition[];
+    names(): ReadonlySet<string>;
+    inputSchemas(): ReadonlyMap<string, unknown>;
+}
+export declare function createWorkflowRegistry(definitions: readonly WorkflowDefinition[]): WorkflowRegistry;
+export declare function createRootWorkflowRegistry(parsedWorkflow: ParsedWorkflow): WorkflowRegistry;

package/dist/workflow/registry.js

@@ -0,0 +1,55 @@
+import { ErrorCode } from "../errors/codes.js";
+import { OpenDynamicWorkflowError } from "../errors/types.js";
+class DefaultWorkflowRegistry {
+    definitions;
+    constructor(definitions) {
+        this.definitions = new Map();
+        for (const def of definitions) {
+            if (this.definitions.has(def.name)) {
+                const existing = this.definitions.get(def.name);
+                throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_DUPLICATE_DEFINITION, `Duplicate workflow name '${def.name}' found in:\n  - ${existing.sourcePath}\n  - ${def.sourcePath}`);
+            }
+            this.definitions.set(def.name, def);
+        }
+    }
+    get(name) {
+        return this.definitions.get(name);
+    }
+    require(name) {
+        const def = this.get(name);
+        if (!def) {
+            throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_DEFINITION_NOT_FOUND, `Workflow definition '${name}' not found.`);
+        }
+        return def;
+    }
+    list() {
+        return Array.from(this.definitions.values());
+    }
+    names() {
+        return new Set(this.definitions.keys());
+    }
+    inputSchemas() {
+        const schemas = new Map();
+        for (const [name, def] of this.definitions) {
+            if (def.inputSchema) {
+                schemas.set(name, def.inputSchema);
+            }
+        }
+        return schemas;
+    }
+}
+export function createWorkflowRegistry(definitions) {
+    return new DefaultWorkflowRegistry(definitions);
+}
+export function createRootWorkflowRegistry(parsedWorkflow) {
+    const definition = {
+        name: parsedWorkflow.meta.name,
+        description: parsedWorkflow.meta.description,
+        sourcePath: parsedWorkflow.sourcePath,
+        meta: parsedWorkflow.meta,
+        parsedWorkflow,
+        inputSchema: parsedWorkflow.meta.inputSchema
+    };
+    return createWorkflowRegistry([definition]);
+}
+//# sourceMappingURL=registry.js.map

package/dist/workflow/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/workflow/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAoB9D,MAAM,uBAAuB;IACV,WAAW,CAAkC;IAE9D,YAAY,WAA0C;QACpD,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;QAC7B,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;gBACjD,MAAM,IAAI,wBAAwB,CAChC,SAAS,CAAC,6BAA6B,EACvC,4BAA4B,GAAG,CAAC,IAAI,oBAAoB,QAAQ,CAAC,UAAU,SAAS,GAAG,CAAC,UAAU,EAAE,CACrG,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,wBAAwB,CAChC,SAAS,CAAC,6BAA6B,EACvC,wBAAwB,IAAI,cAAc,CAC3C,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK;QACH,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,YAAY;QACV,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3C,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;gBACpB,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB,CAAC,WAA0C;IAC/E,OAAO,IAAI,uBAAuB,CAAC,WAAW,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,cAA8B;IACvE,MAAM,UAAU,GAAuB;QACrC,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,IAAI;QAC9B,WAAW,EAAE,cAAc,CAAC,IAAI,CAAC,WAAW;QAC5C,UAAU,EAAE,cAAc,CAAC,UAAU;QACrC,IAAI,EAAE,cAAc,CAAC,IAAI;QACzB,cAAc;QACd,WAAW,EAAE,cAAc,CAAC,IAAI,CAAC,WAAW;KAC7C,CAAC;IACF,OAAO,sBAAsB,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/workflow/resolve-target.d.ts

@@ -0,0 +1,45 @@
+import type { ResolvedOpenDynamicWorkflowConfig } from "../config/types.js";
+export type WorkflowTargetKind = "workflow-name" | "workflow-file";
+export type WorkflowDiscoverySource = "list-discovery" | "file-path" | "resume-recorded-file";
+export interface WorkflowTargetMetadata {
+    name: string;
+    description: string;
+    phases?: string[] | undefined;
+    version?: string | undefined;
+    tags?: string[] | undefined;
+    inputSchema?: unknown;
+}
+export interface ResolvedWorkflowTarget {
+    requestedTarget: string;
+    targetKind: WorkflowTargetKind;
+    workflowName: string;
+    workflowFile: string;
+    workflowFileRelative: string;
+    cwd: string;
+    configPath?: string | undefined;
+    discoverySource: WorkflowDiscoverySource;
+    metadata: WorkflowTargetMetadata;
+    candidatePaths?: string[] | undefined;
+}
+export interface ResolveWorkflowTargetInput {
+    target: string;
+    cwd: string;
+    config: ResolvedOpenDynamicWorkflowConfig;
+    mode: "run" | "validate";
+    allowPathLikeFastPath?: boolean | undefined;
+}
+export interface ResolveWorkflowFileTargetInput {
+    target: string;
+    cwd: string;
+    config: ResolvedOpenDynamicWorkflowConfig;
+    fallbackFromName?: boolean | undefined;
+}
+export interface ResolveWorkflowNameTargetInput {
+    name: string;
+    cwd: string;
+    config: ResolvedOpenDynamicWorkflowConfig;
+}
+export declare function isPathLikeWorkflowTarget(target: string): boolean;
+export declare function resolveWorkflowTarget(input: ResolveWorkflowTargetInput): Promise<ResolvedWorkflowTarget>;
+export declare function resolveWorkflowFileTarget(input: ResolveWorkflowFileTargetInput): Promise<ResolvedWorkflowTarget>;
+export declare function resolveWorkflowNameTarget(input: ResolveWorkflowNameTargetInput): Promise<ResolvedWorkflowTarget | null>;

package/dist/workflow/resolve-target.js

@@ -0,0 +1,162 @@
+import { resolve, relative, isAbsolute } from "node:path";
+import { realpath } from "node:fs/promises";
+import { ErrorCode } from "../errors/codes.js";
+import { OpenDynamicWorkflowError } from "../errors/types.js";
+import { resolveDiscoveryDirectories } from "../discovery/directories.js";
+import { createDiscoveryService } from "../discovery/service.js";
+import { loadWorkflow } from "./load.js";
+import { parseWorkflow } from "./parse.js";
+export function isPathLikeWorkflowTarget(target) {
+    if (isAbsolute(target))
+        return true;
+    if (target.includes("/") || target.includes("\\"))
+        return true;
+    if (target.startsWith("./") || target.startsWith("../"))
+        return true;
+    const lower = target.toLowerCase();
+    return (lower.endsWith(".ts") ||
+        lower.endsWith(".js") ||
+        lower.endsWith(".mts") ||
+        lower.endsWith(".mjs") ||
+        lower.endsWith(".cts") ||
+        lower.endsWith(".cjs"));
+}
+export async function resolveWorkflowTarget(input) {
+    const { target, cwd, config, allowPathLikeFastPath = true } = input;
+    if (!target || target.trim() === "") {
+        throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_TARGET_NOT_FOUND, "Workflow target is required.");
+    }
+    // 1. Path-like fast-path
+    if (allowPathLikeFastPath && isPathLikeWorkflowTarget(target)) {
+        return resolveWorkflowFileTarget({ target, cwd, config });
+    }
+    // 2. Bare name lookup
+    const resolvedByName = await resolveWorkflowNameTarget({
+        name: target,
+        cwd,
+        config,
+    });
+    if (resolvedByName) {
+        return resolvedByName;
+    }
+    // 3. Fallback to file target if bare name didn't match anything
+    try {
+        return await resolveWorkflowFileTarget({
+            target,
+            cwd,
+            config,
+            fallbackFromName: true,
+        });
+    }
+    catch (err) {
+        // If fallback fails, throw a target-not-found error that suggests list
+        throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_TARGET_NOT_FOUND, `Workflow "${target}" not found by name or file path. Try "open-dynamic-workflow list workflows" to see available workflows.`, { cause: err });
+    }
+}
+export async function resolveWorkflowFileTarget(input) {
+    const { target, cwd, config, fallbackFromName = false } = input;
+    const absolutePath = resolve(cwd, target);
+    let canonicalPath;
+    try {
+        canonicalPath = await realpath(absolutePath);
+    }
+    catch (cause) {
+        throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_FILE_NOT_FOUND, `Workflow file not found: ${absolutePath}`, { cause });
+    }
+    const canonicalCwd = await realpath(resolve(cwd)).catch(() => resolve(cwd));
+    const rel = relative(canonicalCwd, canonicalPath);
+    if (rel.startsWith("..") || isAbsolute(rel)) {
+        throw new OpenDynamicWorkflowError(ErrorCode.SECURITY_POLICY_VIOLATION, `Workflow file outside project root: ${canonicalPath}`);
+    }
+    const loaded = await loadWorkflow(absolutePath, cwd);
+    const parsed = parseWorkflow(loaded);
+    return {
+        requestedTarget: target,
+        targetKind: "workflow-file",
+        workflowName: parsed.meta.name,
+        workflowFile: absolutePath,
+        workflowFileRelative: relative(cwd, absolutePath),
+        cwd,
+        configPath: config.configPath,
+        discoverySource: "file-path",
+        metadata: {
+            name: parsed.meta.name,
+            description: parsed.meta.description,
+            phases: parsed.meta.phases,
+            version: parsed.meta.version,
+            tags: parsed.meta.tags,
+            inputSchema: parsed.meta.inputSchema,
+        },
+    };
+}
+export async function resolveWorkflowNameTarget(input) {
+    const { name, cwd, config } = input;
+    const directories = resolveDiscoveryDirectories({
+        resourceType: "workflow",
+        rawOptions: {},
+        config,
+        cwd,
+    });
+    const discoveryService = createDiscoveryService();
+    const discoveryResult = await discoveryService.discover({
+        cwd,
+        resourceTypes: ["workflow"],
+        directories,
+        verbose: false,
+        strict: false,
+    });
+    if (discoveryResult.status === "failed") {
+        const allDiags = [...discoveryResult.errors, ...discoveryResult.warnings];
+        const errorDetails = allDiags.length > 0
+            ? allDiags.map((e) => `- ${e.path || "unknown"}: ${e.message}`).join("\n")
+            : "- unknown error during directory scan";
+        throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_DISCOVERY_FAILED, `Could not resolve workflow target "${name}" because workflow discovery failed.\n\nDiscovery errors:\n${errorDetails}\n\nCheck --cwd, --config, and workflow.discovery.include.`);
+    }
+    const matches = discoveryResult.resources.filter((r) => r.type === "workflow" && r.name === name);
+    if (matches.length === 0) {
+        return null;
+    }
+    if (matches.length > 1) {
+        const paths = matches.map((m) => m.path).join(", ");
+        throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_DUPLICATE_NAME, `Multiple workflows found with name "${name}": ${paths}`);
+    }
+    const match = matches[0];
+    const absolutePath = isAbsolute(match.path) ? match.path : resolve(cwd, match.path);
+    // Build candidatePaths from valid statically discovered workflows.
+    // We only include workflows with unique names to avoid registry collisions,
+    // unless it's the specific workflow we matched (which is unique anyway if we reached here).
+    const nameCounts = new Map();
+    for (const r of discoveryResult.resources) {
+        if (r.type === "workflow" && r.valid) {
+            nameCounts.set(r.name, (nameCounts.get(r.name) || 0) + 1);
+        }
+    }
+    const candidatePaths = discoveryResult.resources
+        .filter((r) => {
+        if (r.type !== "workflow" || !r.valid)
+            return false;
+        // Include it if it's the one we matched, or if its name is unique
+        return r.name === name || (nameCounts.get(r.name) || 0) === 1;
+    })
+        .map((r) => (isAbsolute(r.path) ? r.path : resolve(cwd, r.path)));
+    return {
+        requestedTarget: name,
+        targetKind: "workflow-name",
+        workflowName: match.name,
+        workflowFile: absolutePath,
+        workflowFileRelative: relative(cwd, absolutePath),
+        cwd,
+        configPath: config.configPath,
+        discoverySource: "list-discovery",
+        metadata: {
+            name: match.name,
+            description: match.description,
+            phases: match.phases,
+            version: match.version,
+            tags: match.tags,
+            inputSchema: match.inputSchema,
+        },
+        candidatePaths,
+    };
+}
+//# sourceMappingURL=resolve-target.js.map

package/dist/workflow/resolve-target.js.map

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