@travisliu/open-dynamic-workflow 0.3.0

package/dist/types/config.js.map

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

package/dist/types/errors.d.ts

@@ -0,0 +1,21 @@
+export type OpenDynamicWorkflowErrorCode = "CLI_USAGE_ERROR" | "CONFIG_VALIDATION_ERROR" | "WORKFLOW_PARSE_ERROR" | "WORKFLOW_VALIDATION_ERROR" | "PROVIDER_UNAVAILABLE" | "PROVIDER_PROCESS_FAILED" | "PROCESS_TIMEOUT" | "SCHEMA_VALIDATION_FAILED" | "SECURITY_POLICY_VIOLATION" | "USER_CANCELLED" | "ARTIFACT_WRITE_FAILED" | "TOOL_DEFINITION_NOT_FOUND" | "TOOL_DUPLICATE_DEFINITION" | "TOOL_INVALID_DEFINITION" | "TOOL_INVALID_INPUT" | "TOOL_INVALID_OUTPUT" | "TOOL_INVALID_CONTEXT" | "TOOL_EXECUTION_FAILED" | "TOOL_CANCELLED" | "TOOL_TIMEOUT" | "TOOL_SERIALIZATION_FAILED" | "TOOL_ARTIFACT_WRITE_FAILED" | "INTERNAL_ERROR";
+export interface SerializedError {
+    name: string;
+    message: string;
+    code?: OpenDynamicWorkflowErrorCode | string;
+    stack?: string;
+    cause?: unknown;
+}
+export declare const EXIT_CODES: {
+    readonly SUCCESS: 0;
+    readonly WORKFLOW_FAILED: 1;
+    readonly CLI_USAGE_ERROR: 2;
+    readonly WORKFLOW_PARSE_OR_VALIDATION_ERROR: 3;
+    readonly PROVIDER_UNAVAILABLE: 4;
+    readonly SECURITY_POLICY_VIOLATION: 5;
+    readonly USER_CANCELLED: 6;
+    readonly TIMEOUT: 7;
+    readonly INTERNAL_ERROR: 8;
+};
+export type ExitCode = (typeof EXIT_CODES)[keyof typeof EXIT_CODES];
+export declare function exitCodeForErrorCode(code: OpenDynamicWorkflowErrorCode): ExitCode;

package/dist/types/errors.js

@@ -0,0 +1,50 @@
+export const EXIT_CODES = {
+    SUCCESS: 0,
+    WORKFLOW_FAILED: 1,
+    CLI_USAGE_ERROR: 2,
+    WORKFLOW_PARSE_OR_VALIDATION_ERROR: 3,
+    PROVIDER_UNAVAILABLE: 4,
+    SECURITY_POLICY_VIOLATION: 5,
+    USER_CANCELLED: 6,
+    TIMEOUT: 7,
+    INTERNAL_ERROR: 8
+};
+export function exitCodeForErrorCode(code) {
+    switch (code) {
+        case "CLI_USAGE_ERROR":
+        case "CONFIG_VALIDATION_ERROR":
+            return EXIT_CODES.CLI_USAGE_ERROR;
+        case "WORKFLOW_PARSE_ERROR":
+        case "WORKFLOW_VALIDATION_ERROR":
+            return EXIT_CODES.WORKFLOW_PARSE_OR_VALIDATION_ERROR;
+        case "PROVIDER_UNAVAILABLE":
+            return EXIT_CODES.PROVIDER_UNAVAILABLE;
+        case "SECURITY_POLICY_VIOLATION":
+            return EXIT_CODES.SECURITY_POLICY_VIOLATION;
+        case "USER_CANCELLED":
+            return EXIT_CODES.USER_CANCELLED;
+        case "PROCESS_TIMEOUT":
+            return EXIT_CODES.TIMEOUT;
+        case "PROVIDER_PROCESS_FAILED":
+        case "SCHEMA_VALIDATION_FAILED":
+        case "TOOL_EXECUTION_FAILED":
+        case "TOOL_INVALID_INPUT":
+        case "TOOL_INVALID_OUTPUT":
+        case "TOOL_SERIALIZATION_FAILED":
+            return EXIT_CODES.WORKFLOW_FAILED;
+        case "TOOL_TIMEOUT":
+            return EXIT_CODES.TIMEOUT;
+        case "TOOL_CANCELLED":
+            return EXIT_CODES.USER_CANCELLED;
+        case "TOOL_DEFINITION_NOT_FOUND":
+        case "TOOL_DUPLICATE_DEFINITION":
+        case "TOOL_INVALID_DEFINITION":
+        case "TOOL_INVALID_CONTEXT":
+            return EXIT_CODES.WORKFLOW_PARSE_OR_VALIDATION_ERROR;
+        case "TOOL_ARTIFACT_WRITE_FAILED":
+        case "ARTIFACT_WRITE_FAILED":
+        case "INTERNAL_ERROR":
+            return EXIT_CODES.INTERNAL_ERROR;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAiCA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,CAAC;IACV,eAAe,EAAE,CAAC;IAClB,eAAe,EAAE,CAAC;IAClB,kCAAkC,EAAE,CAAC;IACrC,oBAAoB,EAAE,CAAC;IACvB,yBAAyB,EAAE,CAAC;IAC5B,cAAc,EAAE,CAAC;IACjB,OAAO,EAAE,CAAC;IACV,cAAc,EAAE,CAAC;CACT,CAAC;AAIX,MAAM,UAAU,oBAAoB,CAAC,IAAkC;IACrE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,iBAAiB,CAAC;QACvB,KAAK,yBAAyB;YAC5B,OAAO,UAAU,CAAC,eAAe,CAAC;QACpC,KAAK,sBAAsB,CAAC;QAC5B,KAAK,2BAA2B;YAC9B,OAAO,UAAU,CAAC,kCAAkC,CAAC;QACvD,KAAK,sBAAsB;YACzB,OAAO,UAAU,CAAC,oBAAoB,CAAC;QACzC,KAAK,2BAA2B;YAC9B,OAAO,UAAU,CAAC,yBAAyB,CAAC;QAC9C,KAAK,gBAAgB;YACnB,OAAO,UAAU,CAAC,cAAc,CAAC;QACnC,KAAK,iBAAiB;YACpB,OAAO,UAAU,CAAC,OAAO,CAAC;QAC5B,KAAK,yBAAyB,CAAC;QAC/B,KAAK,0BAA0B,CAAC;QAChC,KAAK,uBAAuB,CAAC;QAC7B,KAAK,oBAAoB,CAAC;QAC1B,KAAK,qBAAqB,CAAC;QAC3B,KAAK,2BAA2B;YAC9B,OAAO,UAAU,CAAC,eAAe,CAAC;QACpC,KAAK,cAAc;YACjB,OAAO,UAAU,CAAC,OAAO,CAAC;QAC5B,KAAK,gBAAgB;YACnB,OAAO,UAAU,CAAC,cAAc,CAAC;QACnC,KAAK,2BAA2B,CAAC;QACjC,KAAK,2BAA2B,CAAC;QACjC,KAAK,yBAAyB,CAAC;QAC/B,KAAK,sBAAsB;YACzB,OAAO,UAAU,CAAC,kCAAkC,CAAC;QACvD,KAAK,4BAA4B,CAAC;QAClC,KAAK,uBAAuB,CAAC;QAC7B,KAAK,gBAAgB;YACnB,OAAO,UAAU,CAAC,cAAc,CAAC;IACrC,CAAC;AACH,CAAC"}

package/dist/types/events.d.ts

@@ -0,0 +1,4 @@
+export * from "../output/events.js";
+import type { EventEnvelope, EventType } from "../output/events.js";
+export type WorkflowEventType = EventType;
+export type WorkflowEvent = EventEnvelope;

package/dist/types/events.js

@@ -0,0 +1,2 @@
+export * from "../output/events.js";
+//# sourceMappingURL=events.js.map

package/dist/types/events.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./agent.js";
+export * from "./artifacts.js";
+export * from "./common.js";
+export * from "./config.js";
+export * from "./errors.js";
+export * from "./events.js";
+export * from "./process.js";
+export * from "./reporter.js";
+export * from "./scheduler.js";
+export * from "./workflow.js";
+export * from "./tool.js";

package/dist/types/index.js

@@ -0,0 +1,12 @@
+export * from "./agent.js";
+export * from "./artifacts.js";
+export * from "./common.js";
+export * from "./config.js";
+export * from "./errors.js";
+export * from "./events.js";
+export * from "./process.js";
+export * from "./reporter.js";
+export * from "./scheduler.js";
+export * from "./workflow.js";
+export * from "./tool.js";
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC"}

package/dist/types/process.d.ts

@@ -0,0 +1,20 @@
+export interface ProcessRunInput {
+    command: string;
+    args: string[];
+    cwd: string;
+    stdin?: string;
+    env?: Record<string, string>;
+    timeoutMs: number;
+    signal?: AbortSignal;
+    onStdout?: (chunk: string) => void | Promise<void>;
+    onStderr?: (chunk: string) => void | Promise<void>;
+}
+export interface ProcessRunResult {
+    exitCode: number | null;
+    signal: string | null;
+    stdout: string;
+    stderr: string;
+    durationMs: number;
+    timedOut: boolean;
+    cancelled: boolean;
+}

package/dist/types/process.js

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

package/dist/types/process.js.map

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

package/dist/types/reporter.d.ts

@@ -0,0 +1 @@
+export * from "../output/reporter.js";

package/dist/types/reporter.js

@@ -0,0 +1,2 @@
+export * from "../output/reporter.js";
+//# sourceMappingURL=reporter.js.map

package/dist/types/reporter.js.map

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

package/dist/types/scheduler.d.ts

@@ -0,0 +1,30 @@
+import type { MaybePromise, ProviderName } from "./common.js";
+import type { AgentPermissions } from "./agent.js";
+export interface AbortReason {
+    type: "fail-fast" | "user" | "timeout" | "other";
+    message: string;
+    source?: string;
+    cause?: "failure" | "timeout" | "error";
+}
+export interface ScheduledTask<T> {
+    id: string;
+    label?: string | undefined;
+    provider?: ProviderName | undefined;
+    model?: string | undefined;
+    permissions?: AgentPermissions | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    run: (signal: AbortSignal) => MaybePromise<T>;
+}
+export interface ScheduleOptions {
+    provider?: ProviderName | undefined;
+    model?: string | undefined;
+    priority?: number | undefined;
+    timeoutMs?: number | undefined;
+    failFast?: boolean | undefined;
+    cwd?: string | undefined;
+}
+export interface Scheduler {
+    schedule<T>(task: ScheduledTask<T>, options?: ScheduleOptions): Promise<T>;
+    drain(): Promise<void>;
+    abort(reason?: string | AbortReason): void;
+}

package/dist/types/scheduler.js

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

package/dist/types/scheduler.js.map

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

package/dist/types/tool.d.ts

@@ -0,0 +1,129 @@
+import { SerializedError } from "./errors.js";
+export type ToolFailureMode = "throw" | "settled";
+export interface ToolCallInput {
+    definition: string;
+    args: unknown;
+    id?: string;
+    label?: string;
+    timeoutMs?: number;
+    failureMode?: ToolFailureMode;
+    metadata?: Record<string, unknown>;
+}
+export interface ToolExecutionContext {
+    runId: string;
+    toolCallId: string;
+    definitionId: string;
+    workflowInvocationId: string;
+    parentWorkflowInvocationId?: string | undefined;
+    artifactsDir: string;
+    signal: AbortSignal;
+    log(message: string, data?: unknown): void;
+}
+export interface ToolDefinition<TInput = unknown, TOutput = unknown> {
+    id: string;
+    description: string;
+    inputSchema: unknown;
+    outputSchema?: unknown;
+    defaultTimeoutMs?: number;
+    cacheable?: boolean;
+    metadata?: Record<string, unknown>;
+    run(input: TInput, context: ToolExecutionContext): Promise<TOutput> | TOutput;
+}
+export declare const TOOL_DEFINITION_MARKER: unique symbol;
+export interface BrandedToolDefinition<TInput = unknown, TOutput = unknown> extends ToolDefinition<TInput, TOutput> {
+    readonly [TOOL_DEFINITION_MARKER]: true;
+}
+export type ToolValidationResult<T = unknown> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    errors: Array<{
+        path: string;
+        keyword?: string;
+        message: string;
+    }>;
+};
+export interface RegisteredToolDefinition<TInput = unknown, TOutput = unknown> {
+    readonly definition: BrandedToolDefinition<TInput, TOutput>;
+    readonly sourcePath: string;
+    readonly validateInput: (data: unknown) => ToolValidationResult<TInput>;
+    readonly validateOutput: (data: unknown) => ToolValidationResult<TOutput>;
+}
+export interface ToolRegistry {
+    get(id: string): RegisteredToolDefinition | undefined;
+    require(id: string): RegisteredToolDefinition;
+    has(id: string): boolean;
+    list(): RegisteredToolDefinition[];
+}
+export interface ToolErrorDetails {
+    code: string;
+    message: string;
+    error?: SerializedError;
+}
+export type ToolExecutionStatus = "succeeded" | "failed" | "cancelled" | "timed_out";
+export interface ToolExecutionResult<TOutput = unknown> {
+    toolCallId: string;
+    definitionId: string;
+    status: ToolExecutionStatus;
+    ok: boolean;
+    output?: TOutput;
+    error?: ToolErrorDetails;
+    artifactPath?: string;
+    startedAt?: string | undefined;
+    finishedAt?: string | undefined;
+    queueDurationMs?: number | undefined;
+    durationMs: number;
+    workflowInvocationId: string;
+    parentWorkflowInvocationId?: string | undefined;
+    cache?: {
+        hit: boolean;
+        callId?: string | undefined;
+        previousRunId?: string | undefined;
+        previousToolCallId?: string | undefined;
+    } | undefined;
+}
+export type ToolSettledResult<TOutput = unknown> = {
+    status: "succeeded";
+    ok: true;
+    toolCallId: string;
+    definition: string;
+    value: TOutput;
+    startedAt: string;
+    finishedAt: string;
+    durationMs: number;
+    artifactPath: string;
+} | {
+    status: "failed" | "cancelled" | "timed_out";
+    ok: false;
+    toolCallId: string;
+    definition: string;
+    error: SerializedError;
+    startedAt?: string;
+    finishedAt: string;
+    durationMs: number;
+    artifactPath: string;
+};
+export interface ToolSummary {
+    toolCallId: string;
+    definition: string;
+    definitionId?: string;
+    label?: string | undefined;
+    status: ToolExecutionStatus;
+    ok: boolean;
+    workflowInvocationId: string;
+    parentWorkflowInvocationId?: string | undefined;
+    queueDurationMs?: number | undefined;
+    durationMs: number;
+    artifactPath: string;
+    cache?: {
+        hit: boolean;
+        callId?: string | undefined;
+        previousRunId?: string | undefined;
+        previousToolCallId?: string | undefined;
+    } | undefined;
+    error?: {
+        code: string;
+        message: string;
+    } | undefined;
+}

package/dist/types/tool.js

@@ -0,0 +1,2 @@
+export const TOOL_DEFINITION_MARKER = Symbol.for("open-dynamic-workflow.toolDefinition");
+//# sourceMappingURL=tool.js.map

package/dist/types/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/types/tool.ts"],"names":[],"mappings":"AAoCA,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC"}

package/dist/types/workflow.d.ts

@@ -0,0 +1,127 @@
+import type { AgentCallInput, AgentResult } from "./agent.js";
+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";
+export type { PipelineStage, PipelineOptions, PipelineResult, PipelineSummary };
+export interface WorkflowMeta {
+    name: string;
+    description: string;
+    phases?: string[];
+    version?: string;
+    tags?: string[];
+    inputSchema?: JsonObject;
+}
+export interface ParsedWorkflow {
+    meta: WorkflowMeta;
+    body: string;
+    sourcePath: string;
+    sourceText: string;
+    sourceHash: string;
+}
+export type ParallelTasks<T> = Array<() => Promise<T>> | Record<string, () => Promise<T>>;
+export type ParallelResult<TTasks> = TTasks extends Array<() => Promise<infer TValue>> ? TValue[] : TTasks extends Record<string, () => Promise<infer TValue>> ? Record<keyof TTasks, TValue> : never;
+export type WorkflowFailureMode = "throw" | "settled";
+export interface WorkflowCallInput {
+    name: string;
+    args?: JsonObject;
+    failureMode?: WorkflowFailureMode;
+    timeoutMs?: number;
+    concurrency?: number;
+    metadata?: JsonObject;
+}
+export type WorkflowThrowCallInput = Omit<WorkflowCallInput, "failureMode"> & {
+    failureMode?: "throw";
+};
+export type WorkflowSettledCallInput = Omit<WorkflowCallInput, "failureMode"> & {
+    failureMode: "settled";
+};
+export type WorkflowSettledStatus = "succeeded" | "failed" | "timed_out" | "cancelled";
+export type WorkflowSettledResult<T = unknown> = {
+    status: "succeeded";
+    workflowName: string;
+    workflowInvocationId: string;
+    output: T;
+    startedAt: string;
+    finishedAt: string;
+    durationMs: number;
+    artifactPath?: string | undefined;
+} | {
+    status: Exclude<WorkflowSettledStatus, "succeeded">;
+    workflowName: string;
+    workflowInvocationId: string;
+    output: null;
+    error: SerializedError;
+    startedAt: string;
+    finishedAt: string;
+    durationMs: number;
+    artifactPath?: string | undefined;
+};
+export interface WorkflowInvocationSummary {
+    workflowInvocationId: string;
+    parentWorkflowInvocationId?: string | undefined;
+    workflowName: string;
+    status: WorkflowSettledStatus;
+    depth: number;
+    startedAt: string;
+    finishedAt: string;
+    durationMs: number;
+    artifactPath?: string | undefined;
+    error?: SerializedError | undefined;
+}
+export interface WorkflowRuntimeContext {
+    args: JsonObject;
+    cwd: string;
+    runId: string;
+    workflowInvocationId?: string | undefined;
+    artifactsDir: string;
+    agent(input: AgentCallInput): Promise<AgentResult>;
+    parallel<TTasks extends ParallelTasks<unknown>>(tasks: TTasks): Promise<ParallelResult<TTasks>>;
+    phase(name: string): void;
+    log(message: string, data?: unknown): void;
+    pipeline<I, O>(items: I[], stages: PipelineStage<any, any>[], options?: PipelineOptions): Promise<PipelineResult<O>>;
+    tool<T = unknown>(input: ToolCallInput & {
+        failureMode?: "throw";
+    }): Promise<T>;
+    tool<T = unknown>(input: ToolCallInput & {
+        failureMode: "settled";
+    }): Promise<ToolSettledResult<T>>;
+    tool<T = unknown>(input: ToolCallInput): Promise<T | ToolSettledResult<T>>;
+    workflow<T = JsonValue>(input: WorkflowThrowCallInput): Promise<T>;
+    workflow<T = JsonValue>(input: WorkflowSettledCallInput): Promise<WorkflowSettledResult<T>>;
+    workflow<T = JsonValue>(input: WorkflowCallInput): Promise<T | WorkflowSettledResult<T>>;
+}
+export interface WorkflowIdentity {
+    name: string;
+    file: string;
+    requestedTarget: string;
+    targetKind: "workflow-name" | "workflow-file";
+}
+export interface ResolvedWorkflowIdentity {
+    name: string;
+    file: string;
+    requestedTarget: string;
+    targetKind: "workflow-name" | "workflow-file";
+    workflowFile: string;
+    workflowFileRelative: string;
+    discoverySource: string;
+}
+export interface WorkflowRunResult {
+    schemaVersion: "open-dynamic-workflow.report.v1";
+    runId: string;
+    status: WorkflowStatus;
+    meta: WorkflowMeta;
+    workflow?: WorkflowIdentity;
+    result?: unknown | undefined;
+    agents: AgentResult[];
+    pipelines?: PipelineSummary[] | undefined;
+    workflows?: WorkflowInvocationSummary[] | undefined;
+    tools?: ToolSummary[] | undefined;
+    startedAt: string;
+    finishedAt: string;
+    durationMs: number;
+    artifactsDir: string;
+    reportPath: string;
+    eventsPath: string;
+    error?: SerializedError | undefined;
+}

package/dist/types/workflow.js

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

package/dist/types/workflow.js.map

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

package/dist/workflow/discovery.d.ts

@@ -0,0 +1,15 @@
+import { type WorkflowRegistry } from "./registry.js";
+import type { SharedAgentRegistry } from "../shared-agents/registry.js";
+import type { ToolRegistry } from "../types/tool.js";
+import { walk, matchGlob, getGlobBaseDir } from "../discovery/file-patterns.js";
+export { walk, matchGlob, getGlobBaseDir };
+export interface DiscoverWorkflowRegistryInput {
+    rootWorkflowPath: string;
+    cwd: string;
+    include: string[];
+    sharedAgentRegistry?: SharedAgentRegistry;
+    candidatePaths?: string[] | undefined;
+    allowDynamicSharedAgentIds?: boolean;
+    toolRegistry?: ToolRegistry;
+}
+export declare function discoverWorkflowRegistry(input: DiscoverWorkflowRegistryInput): Promise<WorkflowRegistry>;

package/dist/workflow/discovery.js

@@ -0,0 +1,134 @@
+import { promises as fs } from "node:fs";
+import { resolve, relative, isAbsolute } from "node:path";
+import { loadWorkflow } from "./load.js";
+import { parseWorkflow } from "./parse.js";
+import { assertWorkflowValid, validateRegistryDependencies } from "./validate.js";
+import { createWorkflowRegistry } from "./registry.js";
+import { OpenDynamicWorkflowError } from "../errors/types.js";
+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 absoluteCwd = resolve(cwd);
+    const absoluteRootPath = resolve(absoluteCwd, rootWorkflowPath);
+    const canonicalCwd = await fs.realpath(absoluteCwd).catch(() => absoluteCwd);
+    const pathsToProcess = new Set();
+    pathsToProcess.add(absoluteRootPath);
+    if (candidatePaths) {
+        for (const p of candidatePaths) {
+            pathsToProcess.add(resolve(absoluteCwd, p));
+        }
+    }
+    else {
+        for (const pattern of include) {
+            // Basic support for "dir/**/*.ts" or "dir/*.ts"
+            let baseDir = getGlobBaseDir(pattern);
+            if (baseDir.startsWith("./")) {
+                baseDir = baseDir.slice(2);
+            }
+            const absoluteBaseDir = resolve(absoluteCwd, baseDir);
+            const globPattern = isAbsolute(pattern) ? relative(absoluteCwd, pattern) : pattern;
+            for await (const p of walk(absoluteBaseDir)) {
+                if (p.endsWith(".ts") || p.endsWith(".js")) {
+                    const relPath = relative(absoluteCwd, p);
+                    if (matchGlob(relPath, globPattern)) {
+                        pathsToProcess.add(p);
+                    }
+                }
+            }
+        }
+    }
+    const definitionsByName = new Map();
+    const seenCanonicalPaths = new Set();
+    const ambiguousIncludeNames = new Set();
+    for (const p of pathsToProcess) {
+        const absolutePath = resolve(absoluteCwd, p);
+        let canonicalPath;
+        try {
+            canonicalPath = await fs.realpath(absolutePath);
+        }
+        catch (err) {
+            canonicalPath = absolutePath;
+        }
+        // Safety check: ensure path is within CWD
+        const rel = relative(canonicalCwd, canonicalPath);
+        if (rel.startsWith("..") || isAbsolute(rel)) {
+            throw new OpenDynamicWorkflowError(ErrorCode.SECURITY_POLICY_VIOLATION, `Workflow file outside project root: ${canonicalPath}`);
+        }
+        if (seenCanonicalPaths.has(canonicalPath)) {
+            continue;
+        }
+        seenCanonicalPaths.add(canonicalPath);
+        let parsed;
+        try {
+            const loaded = await loadWorkflow(absolutePath, absoluteCwd);
+            parsed = parseWorkflow(loaded);
+        }
+        catch (err) {
+            // If we are scanning from 'include', we might hit files that are not workflows.
+            // We should only throw if it's the root workflow or if we were given explicit candidatePaths.
+            if (absolutePath === absoluteRootPath || candidatePaths) {
+                throw err;
+            }
+            continue;
+        }
+        // First pass validation (standalone) - only run immediately for the root workflow.
+        // Reachable child workflows will be validated during transitive validation in validateRegistryDependencies.
+        const isRoot = absolutePath === absoluteRootPath;
+        if (isRoot) {
+            assertWorkflowValid(parsed, {
+                allowImports: false,
+                sharedAgentRegistry,
+                allowDynamicSharedAgentIds: input.allowDynamicSharedAgentIds,
+                toolRegistry: input.toolRegistry
+            });
+        }
+        const def = {
+            name: parsed.meta.name,
+            description: parsed.meta.description,
+            sourcePath: parsed.sourcePath,
+            meta: parsed.meta,
+            parsedWorkflow: parsed,
+            inputSchema: parsed.meta.inputSchema
+        };
+        if (definitionsByName.has(def.name)) {
+            const existing = definitionsByName.get(def.name);
+            if (absolutePath === absoluteRootPath) {
+                // Root wins
+                definitionsByName.set(def.name, def);
+            }
+            else if (existing.sourcePath === absoluteRootPath) {
+                // Root already won
+                continue;
+            }
+            else {
+                // Unrelated duplicates. If we have candidatePaths, discovery service should have narrowed it,
+                // so finding a duplicate here is a hard error. If we are scanning include, be lenient.
+                if (candidatePaths) {
+                    throw new OpenDynamicWorkflowError(ErrorCode.WORKFLOW_DUPLICATE_DEFINITION, `Duplicate workflow name '${def.name}' found in:\n  - ${existing.sourcePath}\n  - ${absolutePath}`);
+                }
+                // Mark as ambiguous by removing it. 
+                definitionsByName.delete(def.name);
+                ambiguousIncludeNames.add(def.name);
+            }
+        }
+        else {
+            // If we are not the root, and the name is already marked ambiguous, skip it.
+            if (ambiguousIncludeNames.has(def.name) && absolutePath !== absoluteRootPath) {
+                continue;
+            }
+            definitionsByName.set(def.name, def);
+        }
+    }
+    const registry = createWorkflowRegistry(Array.from(definitionsByName.values()));
+    // Second validation pass (cross-references & dependency graph/cycles)
+    validateRegistryDependencies(registry, {
+        sharedAgentRegistry,
+        allowDynamicSharedAgentIds: input.allowDynamicSharedAgentIds,
+        toolRegistry: input.toolRegistry,
+        rootWorkflowPath: absoluteRootPath
+    });
+    return registry;
+}
+//# sourceMappingURL=discovery.js.map

package/dist/workflow/discovery.js.map

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

package/dist/workflow/dsl.d.ts

@@ -0,0 +1,13 @@
+import type { AgentCallInput, AgentResult } from "../types/agent.js";
+import type { RuntimeState } from "./types.js";
+import type { ToolCallInput } from "../types/tool.js";
+import type { PipelineStage, PipelineOptions, PipelineResult, WorkflowCallInput, WorkflowSettledResult } from "../types/workflow.js";
+export declare function createDsl(runtime: RuntimeState): {
+    phase: (name: string) => void;
+    log: (message: string, data?: unknown) => void;
+    agent: (input: AgentCallInput) => Promise<AgentResult>;
+    tool: (input: ToolCallInput) => Promise<unknown>;
+    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>>;
+};