@travisliu/open-dynamic-workflow 0.3.0

package/dist/output/verbose-formatter.js

@@ -0,0 +1,137 @@
+export function indentBlock(text, spaces = 2) {
+    const indentation = " ".repeat(spaces);
+    return text
+        .split("\n")
+        .map((line) => (line.length > 0 ? indentation + line : ""))
+        .join("\n");
+}
+export function formatJson(value) {
+    if (typeof value === "string")
+        return value;
+    return JSON.stringify(value, null, 2);
+}
+function formatDuration(ms) {
+    if (typeof ms !== "number")
+        return "";
+    if (ms < 1000)
+        return `${ms}ms`;
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+export function formatVerboseCommand(payload, sequence, timestamp) {
+    const label = payload.label ?? payload.agentId;
+    const lines = [];
+    lines.push(`Agent command: ${label}`);
+    if (sequence !== undefined && timestamp !== undefined) {
+        lines.push(`  Event: #${sequence} ${timestamp}`);
+    }
+    lines.push(`  Provider: ${payload.provider}${payload.model ? `/${payload.model}` : ""}`);
+    lines.push(`  CWD: ${payload.cwd}`);
+    if (payload.command) {
+        const cmd = payload.command;
+        const fullCmd = [cmd.command, ...cmd.args].join(" ");
+        lines.push(`  Command:`);
+        lines.push(indentBlock(fullCmd, 4));
+        if (cmd.env && Object.keys(cmd.env).length > 0) {
+            lines.push(`  Command Environment:`);
+            lines.push(indentBlock(formatJson(cmd.env), 4));
+        }
+    }
+    else {
+        lines.push(`  Command: (unavailable)`);
+    }
+    if (payload.note) {
+        lines.push(`  Note: ${payload.note}`);
+    }
+    lines.push(`  Prompt:`);
+    lines.push(indentBlock(payload.prompt, 4));
+    lines.push(`  Permissions: ${payload.permissions.mode}`);
+    if (payload.metadata && Object.keys(payload.metadata).length > 0) {
+        lines.push(`  Metadata:`);
+        lines.push(indentBlock(formatJson(payload.metadata), 4));
+    }
+    if (payload.artifacts) {
+        lines.push(`  Artifacts:`);
+        lines.push(`    dir: ${payload.artifacts.dir}`);
+        lines.push(`    prompt: ${payload.artifacts.promptPath}`);
+        lines.push(`    stdout: ${payload.artifacts.stdoutPath}`);
+        lines.push(`    stderr: ${payload.artifacts.stderrPath}`);
+        if (payload.artifacts.rawResultPath)
+            lines.push(`    rawResult: ${payload.artifacts.rawResultPath}`);
+        if (payload.artifacts.normalizedResultPath)
+            lines.push(`    normalizedResult: ${payload.artifacts.normalizedResultPath}`);
+        if (payload.artifacts.schemaPath)
+            lines.push(`    schema: ${payload.artifacts.schemaPath}`);
+        if (payload.artifacts.validationErrorPath)
+            lines.push(`    validationError: ${payload.artifacts.validationErrorPath}`);
+        if (payload.artifacts.permissionsPath)
+            lines.push(`    permissions: ${payload.artifacts.permissionsPath}`);
+        if (payload.artifacts.metadataPath)
+            lines.push(`    metadata: ${payload.artifacts.metadataPath}`);
+    }
+    return lines.join("\n") + "\n";
+}
+export function formatVerboseResult(payload, sequence, timestamp) {
+    const label = payload.label ?? payload.agentId;
+    const dur = formatDuration(payload.durationMs);
+    const lines = [];
+    lines.push(`Agent result: ${label} ${payload.status} ${dur}`);
+    if (sequence !== undefined && timestamp !== undefined) {
+        lines.push(`  Event: #${sequence} ${timestamp}`);
+    }
+    lines.push(`  Exit code: ${payload.exitCode ?? "null"}`);
+    lines.push(`  stdout:`);
+    lines.push(indentBlock(payload.stdout.length > 0 ? payload.stdout : "(empty)", 4));
+    lines.push(`  stderr:`);
+    lines.push(indentBlock(payload.stderr.length > 0 ? payload.stderr : "(empty)", 4));
+    if (payload.normalized !== undefined) {
+        lines.push(`  Normalized response:`);
+        lines.push(indentBlock(formatJson(payload.normalized), 4));
+    }
+    if (payload.parseWarnings && payload.parseWarnings.length > 0) {
+        lines.push(`  Parse warnings:`);
+        for (const warning of payload.parseWarnings) {
+            lines.push(`    - ${warning}`);
+        }
+    }
+    if (payload.error) {
+        lines.push(`  Error: ${payload.error.message}`);
+        if (payload.error.stack) {
+            lines.push(indentBlock(payload.error.stack, 4));
+        }
+    }
+    lines.push(`  Permissions: ${payload.permissions.mode}`);
+    if (payload.metadata && Object.keys(payload.metadata).length > 0) {
+        lines.push(`  Metadata:`);
+        lines.push(indentBlock(formatJson(payload.metadata), 4));
+    }
+    if (payload.artifacts) {
+        lines.push(`  Artifacts:`);
+        lines.push(`    dir: ${payload.artifacts.dir}`);
+        lines.push(`    prompt: ${payload.artifacts.promptPath}`);
+        lines.push(`    stdout: ${payload.artifacts.stdoutPath}`);
+        lines.push(`    stderr: ${payload.artifacts.stderrPath}`);
+        if (payload.artifacts.rawResultPath)
+            lines.push(`    rawResult: ${payload.artifacts.rawResultPath}`);
+        if (payload.artifacts.normalizedResultPath)
+            lines.push(`    normalizedResult: ${payload.artifacts.normalizedResultPath}`);
+        if (payload.artifacts.schemaPath)
+            lines.push(`    schema: ${payload.artifacts.schemaPath}`);
+        if (payload.artifacts.validationErrorPath)
+            lines.push(`    validationError: ${payload.artifacts.validationErrorPath}`);
+        if (payload.artifacts.permissionsPath)
+            lines.push(`    permissions: ${payload.artifacts.permissionsPath}`);
+        if (payload.artifacts.metadataPath)
+            lines.push(`    metadata: ${payload.artifacts.metadataPath}`);
+    }
+    return lines.join("\n") + "\n";
+}
+export function renderVerboseEvent(envelope) {
+    if (envelope.type === "agent.verbose.command") {
+        return formatVerboseCommand(envelope.payload, envelope.sequence, envelope.timestamp);
+    }
+    if (envelope.type === "agent.verbose.result") {
+        return formatVerboseResult(envelope.payload, envelope.sequence, envelope.timestamp);
+    }
+    return undefined;
+}
+//# sourceMappingURL=verbose-formatter.js.map

package/dist/output/verbose-formatter.js.map

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

package/dist/pipeline/artifacts.d.ts

@@ -0,0 +1,6 @@
+import type { ArtifactStore, AgentArtifacts } from "../types/artifacts.js";
+import type { PipelineItemResult, PipelineStageResult } from "./types.js";
+export declare function buildAgentArtifactReferences(agentId: string): AgentArtifacts;
+export declare function writeStageArtifact(artifactStore: ArtifactStore | undefined, pipelineId: string, itemIndex: number, result: PipelineStageResult): Promise<string | undefined>;
+export declare function writeItemArtifact(artifactStore: ArtifactStore | undefined, pipelineId: string, itemIndex: number, result: PipelineItemResult): Promise<string | undefined>;
+export declare function writePipelineArtifact(artifactStore: ArtifactStore | undefined, pipelineId: string, pipelineData: unknown): Promise<string | undefined>;

package/dist/pipeline/artifacts.js

@@ -0,0 +1,44 @@
+import { createPipelineStageArtifactName } from "./id.js";
+export function buildAgentArtifactReferences(agentId) {
+    const safeId = agentId.replace(/[^a-zA-Z0-9._:-]/g, "_");
+    return {
+        dir: `agents/${safeId}`,
+        promptPath: `agents/${safeId}/prompt.txt`,
+        stdoutPath: `agents/${safeId}/stdout.log`,
+        stderrPath: `agents/${safeId}/stderr.log`,
+        schemaPath: `agents/${safeId}/schema.json`,
+        validationErrorPath: `agents/${safeId}/validation-error.json`,
+        rawResultPath: `agents/${safeId}/raw-result.json`,
+        normalizedResultPath: `agents/${safeId}/normalized-result.json`
+    };
+}
+export async function writeStageArtifact(artifactStore, pipelineId, itemIndex, result) {
+    if (!artifactStore)
+        return undefined;
+    const safeStageName = createPipelineStageArtifactName(result.stageName);
+    const relativePath = `pipelines/${pipelineId}/items/${itemIndex}/stages/${safeStageName}/stage-result.json`;
+    const childAgentArtifacts = {};
+    if (result.childAgentIds) {
+        for (const agentId of result.childAgentIds) {
+            childAgentArtifacts[agentId] = buildAgentArtifactReferences(agentId);
+        }
+    }
+    const stageArtifactData = {
+        ...result,
+        childAgentArtifacts
+    };
+    return await artifactStore.writeJson(relativePath, stageArtifactData);
+}
+export async function writeItemArtifact(artifactStore, pipelineId, itemIndex, result) {
+    if (!artifactStore)
+        return undefined;
+    const relativePath = `pipelines/${pipelineId}/items/${itemIndex}/item.json`;
+    return await artifactStore.writeJson(relativePath, result);
+}
+export async function writePipelineArtifact(artifactStore, pipelineId, pipelineData) {
+    if (!artifactStore)
+        return undefined;
+    const relativePath = `pipelines/${pipelineId}/pipeline.json`;
+    return await artifactStore.writeJson(relativePath, pipelineData);
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/pipeline/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/pipeline/artifacts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,+BAA+B,EAAE,MAAM,SAAS,CAAC;AAE1D,MAAM,UAAU,4BAA4B,CAAC,OAAe;IAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IACzD,OAAO;QACL,GAAG,EAAE,UAAU,MAAM,EAAE;QACvB,UAAU,EAAE,UAAU,MAAM,aAAa;QACzC,UAAU,EAAE,UAAU,MAAM,aAAa;QACzC,UAAU,EAAE,UAAU,MAAM,aAAa;QACzC,UAAU,EAAE,UAAU,MAAM,cAAc;QAC1C,mBAAmB,EAAE,UAAU,MAAM,wBAAwB;QAC7D,aAAa,EAAE,UAAU,MAAM,kBAAkB;QACjD,oBAAoB,EAAE,UAAU,MAAM,yBAAyB;KAChE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,aAAwC,EACxC,UAAkB,EAClB,SAAiB,EACjB,MAA2B;IAE3B,IAAI,CAAC,aAAa;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,aAAa,GAAG,+BAA+B,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACxE,MAAM,YAAY,GAAG,aAAa,UAAU,UAAU,SAAS,WAAW,aAAa,oBAAoB,CAAC;IAE5G,MAAM,mBAAmB,GAAmC,EAAE,CAAC;IAC/D,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACzB,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YAC3C,mBAAmB,CAAC,OAAO,CAAC,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED,MAAM,iBAAiB,GAAG;QACxB,GAAG,MAAM;QACT,mBAAmB;KACpB,CAAC;IAEF,OAAO,MAAM,aAAa,CAAC,SAAS,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,aAAwC,EACxC,UAAkB,EAClB,SAAiB,EACjB,MAA0B;IAE1B,IAAI,CAAC,aAAa;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,YAAY,GAAG,aAAa,UAAU,UAAU,SAAS,YAAY,CAAC;IAE5E,OAAO,MAAM,aAAa,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,aAAwC,EACxC,UAAkB,EAClB,YAAqB;IAErB,IAAI,CAAC,aAAa;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,YAAY,GAAG,aAAa,UAAU,gBAAgB,CAAC;IAE7D,OAAO,MAAM,aAAa,CAAC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;AACnE,CAAC"}

package/dist/pipeline/concurrency.d.ts

@@ -0,0 +1,11 @@
+export declare class ConcurrencyLimiter {
+    readonly limit: number;
+    private activeCount;
+    private queue;
+    constructor(limit: number);
+    run<T>(fn: () => Promise<T>): Promise<T>;
+    private acquire;
+    private release;
+}
+export declare function createLimiter(limit?: number): ConcurrencyLimiter;
+export declare function getEffectiveStageConcurrency(stageName: string, stageConcurrencyProp?: number, pipelineConcurrency?: number, stageConcurrencyOption?: number): number;

package/dist/pipeline/concurrency.js

@@ -0,0 +1,60 @@
+export class ConcurrencyLimiter {
+    limit;
+    activeCount = 0;
+    queue = [];
+    constructor(limit) {
+        this.limit = limit;
+        if (limit <= 0 && limit !== Infinity) {
+            throw new Error("Concurrency limit must be a positive integer.");
+        }
+    }
+    async run(fn) {
+        if (this.limit === Infinity) {
+            return fn();
+        }
+        await this.acquire();
+        try {
+            return await fn();
+        }
+        finally {
+            this.release();
+        }
+    }
+    acquire() {
+        if (this.activeCount < this.limit) {
+            this.activeCount++;
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            this.queue.push(resolve);
+        });
+    }
+    release() {
+        this.activeCount--;
+        const next = this.queue.shift();
+        if (next) {
+            this.activeCount++;
+            next();
+        }
+    }
+}
+export function createLimiter(limit) {
+    return new ConcurrencyLimiter(limit !== undefined && limit > 0 ? limit : Infinity);
+}
+export function getEffectiveStageConcurrency(stageName, stageConcurrencyProp, pipelineConcurrency, stageConcurrencyOption) {
+    const limits = [];
+    if (stageConcurrencyProp !== undefined && stageConcurrencyProp > 0) {
+        limits.push(stageConcurrencyProp);
+    }
+    if (pipelineConcurrency !== undefined && pipelineConcurrency > 0) {
+        limits.push(pipelineConcurrency);
+    }
+    if (stageConcurrencyOption !== undefined && stageConcurrencyOption > 0) {
+        limits.push(stageConcurrencyOption);
+    }
+    if (limits.length === 0) {
+        return Infinity;
+    }
+    return Math.min(...limits);
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/pipeline/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../src/pipeline/concurrency.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,kBAAkB;IAID;IAHpB,WAAW,GAAG,CAAC,CAAC;IAChB,KAAK,GAAmB,EAAE,CAAC;IAEnC,YAA4B,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;QACvC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,EAAoB;QAC/B,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,EAAE,EAAE,CAAC;QACd,CAAC;QACD,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAEO,OAAO;QACb,IAAI,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,OAAO;QACb,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,IAAI,EAAE,CAAC;QACT,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,IAAI,kBAAkB,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,SAAiB,EACjB,oBAA6B,EAC7B,mBAA4B,EAC5B,sBAA+B;IAE/B,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,oBAAoB,KAAK,SAAS,IAAI,oBAAoB,GAAG,CAAC,EAAE,CAAC;QACnE,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,mBAAmB,KAAK,SAAS,IAAI,mBAAmB,GAAG,CAAC,EAAE,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,sBAAsB,KAAK,SAAS,IAAI,sBAAsB,GAAG,CAAC,EAAE,CAAC;QACvE,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;AAC7B,CAAC"}

package/dist/pipeline/context.d.ts

@@ -0,0 +1,15 @@
+import type { PipelineStrategy } from "./types.js";
+export interface ActivePipelineContext {
+    pipelineId: string;
+    pipelineLabel?: string;
+    strategy: PipelineStrategy;
+    itemIndex: number;
+    stageIndex: number;
+    stageName: string;
+    childAgentIds: string[];
+    stageSignal?: AbortSignal;
+    agentCounter: number;
+}
+export declare function getActivePipelineContext(): ActivePipelineContext | undefined;
+export declare function withActivePipelineContext<T>(context: ActivePipelineContext, run: () => T): T;
+export declare function recordChildAgentId(agentId: string): void;

package/dist/pipeline/context.js

@@ -0,0 +1,17 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+const pipelineContextStorage = new AsyncLocalStorage();
+export function getActivePipelineContext() {
+    return pipelineContextStorage.getStore();
+}
+export function withActivePipelineContext(context, run) {
+    return pipelineContextStorage.run(context, run);
+}
+export function recordChildAgentId(agentId) {
+    const context = getActivePipelineContext();
+    if (context) {
+        if (!context.childAgentIds.includes(agentId)) {
+            context.childAgentIds.push(agentId);
+        }
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/pipeline/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/pipeline/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAerD,MAAM,sBAAsB,GAAG,IAAI,iBAAiB,EAAyB,CAAC;AAE9E,MAAM,UAAU,wBAAwB;IACtC,OAAO,sBAAsB,CAAC,QAAQ,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,OAA8B,EAC9B,GAAY;IAEZ,OAAO,sBAAsB,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,OAAO,GAAG,wBAAwB,EAAE,CAAC;IAC3C,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7C,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/pipeline/events.d.ts

@@ -0,0 +1,10 @@
+import type { PipelineStage, NormalizedPipelineOptions, PipelineItemResult, PipelineStageResult } from "./types.js";
+import type { PipelineStartedPayload, PipelineTerminalPayload, CompactPipelineItemResult, CompactPipelineStageResult, PipelineItemTerminalPayload, PipelineStageTerminalPayload, PipelineItemStartedPayload, PipelineStageStartedPayload } from "../output/events.js";
+export declare function compactStageResult(result: PipelineStageResult): CompactPipelineStageResult;
+export declare function compactItemResult(result: PipelineItemResult): CompactPipelineItemResult;
+export declare function buildPipelineStartedPayload(pipelineId: string, items: unknown[], stages: PipelineStage[], options: NormalizedPipelineOptions): PipelineStartedPayload;
+export declare function buildPipelineTerminalPayload(pipelineId: string, status: "succeeded" | "failed" | "cancelled", durationMs: number, results: PipelineItemResult[], artifactPath?: string): PipelineTerminalPayload;
+export declare function buildPipelineItemStartedPayload(pipelineId: string, itemIndex: number, startedAt: string): PipelineItemStartedPayload;
+export declare function buildPipelineItemTerminalPayload(pipelineId: string, result: PipelineItemResult): PipelineItemTerminalPayload;
+export declare function buildPipelineStageStartedPayload(pipelineId: string, itemIndex: number, stageName: string, stageIndex: number, startedAt: string): PipelineStageStartedPayload;
+export declare function buildPipelineStageTerminalPayload(pipelineId: string, itemIndex: number, result: PipelineStageResult): PipelineStageTerminalPayload;

package/dist/pipeline/events.js

@@ -0,0 +1,83 @@
+export function compactStageResult(result) {
+    const compact = {
+        stageName: result.stageName,
+        stageIndex: result.stageIndex,
+        status: result.status,
+        startedAt: result.startedAt,
+        finishedAt: result.finishedAt,
+        durationMs: result.durationMs,
+        childAgentIds: [...result.childAgentIds]
+    };
+    if (result.error !== undefined) {
+        compact.error = result.error;
+    }
+    return compact;
+}
+export function compactItemResult(result) {
+    const compact = {
+        itemIndex: result.itemIndex,
+        status: result.status,
+        startedAt: result.startedAt,
+        finishedAt: result.finishedAt,
+        durationMs: result.durationMs,
+        stages: result.stages.map(compactStageResult)
+    };
+    if (result.status !== "succeeded") {
+        const failRes = result;
+        if (failRes.failedStage !== undefined) {
+            compact.failedStage = failRes.failedStage;
+        }
+        if (failRes.error !== undefined) {
+            compact.error = failRes.error;
+        }
+    }
+    return compact;
+}
+export function buildPipelineStartedPayload(pipelineId, items, stages, options) {
+    return {
+        pipelineId,
+        label: options.label,
+        strategy: options.strategy,
+        itemCount: items.length,
+        stages: stages.map((s) => s.name)
+    };
+}
+export function buildPipelineTerminalPayload(pipelineId, status, durationMs, results, artifactPath) {
+    return {
+        pipelineId,
+        status,
+        durationMs,
+        results: results.map(compactItemResult),
+        artifactPath
+    };
+}
+export function buildPipelineItemStartedPayload(pipelineId, itemIndex, startedAt) {
+    return {
+        pipelineId,
+        itemIndex,
+        startedAt
+    };
+}
+export function buildPipelineItemTerminalPayload(pipelineId, result) {
+    return {
+        pipelineId,
+        ...compactItemResult(result)
+    };
+}
+export function buildPipelineStageStartedPayload(pipelineId, itemIndex, stageName, stageIndex, startedAt) {
+    return {
+        pipelineId,
+        itemIndex,
+        stageName,
+        stageIndex,
+        startedAt
+    };
+}
+export function buildPipelineStageTerminalPayload(pipelineId, itemIndex, result) {
+    return {
+        pipelineId,
+        itemIndex,
+        ...compactStageResult(result)
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/pipeline/events.js.map

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

package/dist/pipeline/id.d.ts

@@ -0,0 +1,10 @@
+export declare function createPipelineId(sequence: number): string;
+export declare function assertValidPipelineStageName(name: string): void;
+export declare function createPipelineStageArtifactName(stageName: string): string;
+export interface CreatePipelineAgentIdInput {
+    pipelineId: string;
+    itemIndex: number;
+    stageName: string;
+    suffix?: string;
+}
+export declare function createPipelineAgentId(input: CreatePipelineAgentIdInput): string;

package/dist/pipeline/id.js

@@ -0,0 +1,61 @@
+import { InvalidDslCallError } from "../workflow/errors.js";
+const STAGE_NAME_PATTERN = /^[A-Za-z0-9_.:-]+$/;
+export function createPipelineId(sequence) {
+    if (typeof sequence !== "number" || sequence < 1 || isNaN(sequence)) {
+        throw new InvalidDslCallError("Pipeline sequence must be a positive integer.");
+    }
+    return `pipeline-${sequence}`;
+}
+export function assertValidPipelineStageName(name) {
+    if (typeof name !== "string") {
+        throw new InvalidDslCallError("Stage name must be a string.");
+    }
+    const trimmed = name.trim();
+    if (trimmed === "") {
+        throw new InvalidDslCallError("Stage name cannot be empty or whitespace-only.");
+    }
+    if (name !== trimmed) {
+        throw new InvalidDslCallError("Stage name cannot have leading or trailing whitespace.");
+    }
+    if (name.length > 128) {
+        throw new InvalidDslCallError("Stage name exceeds maximum length of 128 characters.");
+    }
+    if (name === "." || name === "..") {
+        throw new InvalidDslCallError("Stage name cannot be '.' or '..'.");
+    }
+    if (name.includes("/") || name.includes("\\")) {
+        throw new InvalidDslCallError("Stage name cannot contain path separators ('/' or '\\').");
+    }
+    if (name.includes("..")) {
+        throw new InvalidDslCallError("Stage name cannot contain path traversal segments ('..').");
+    }
+    if (!STAGE_NAME_PATTERN.test(name)) {
+        throw new InvalidDslCallError(`Stage name '${name}' is invalid. Only alphanumeric characters, underscores, dots, colons, and hyphens are allowed.`);
+    }
+}
+export function createPipelineStageArtifactName(stageName) {
+    assertValidPipelineStageName(stageName);
+    return stageName;
+}
+export function createPipelineAgentId(input) {
+    if (!input.pipelineId || typeof input.pipelineId !== "string") {
+        throw new InvalidDslCallError("createPipelineAgentId: pipelineId is required and must be a string.");
+    }
+    if (typeof input.itemIndex !== "number" || input.itemIndex < 0 || isNaN(input.itemIndex)) {
+        throw new InvalidDslCallError("createPipelineAgentId: itemIndex must be a non-negative integer.");
+    }
+    assertValidPipelineStageName(input.stageName);
+    const base = `${input.pipelineId}-item-${input.itemIndex}-${input.stageName}`;
+    if (input.suffix) {
+        const trimmedSuffix = input.suffix.trim();
+        if (trimmedSuffix === "") {
+            throw new InvalidDslCallError("createPipelineAgentId: suffix cannot be empty or whitespace-only.");
+        }
+        if (!STAGE_NAME_PATTERN.test(trimmedSuffix)) {
+            throw new InvalidDslCallError(`createPipelineAgentId: suffix '${input.suffix}' contains invalid characters.`);
+        }
+        return `${base}-${trimmedSuffix}`;
+    }
+    return base;
+}
+//# sourceMappingURL=id.js.map

package/dist/pipeline/id.js.map

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

package/dist/pipeline/item-streaming.d.ts

@@ -0,0 +1,3 @@
+import type { RuntimeState } from "../workflow/types.js";
+import type { PipelineStage, PipelineItemResult, NormalizedPipelineOptions } from "./types.js";
+export declare function runItemStreaming(items: unknown[], stages: PipelineStage[], options: NormalizedPipelineOptions, pipelineId: string, runtime: RuntimeState, parentSignal: AbortSignal): Promise<PipelineItemResult[]>;

package/dist/pipeline/item-streaming.js

@@ -0,0 +1,122 @@
+import { createLimiter, getEffectiveStageConcurrency } from "./concurrency.js";
+import { runStage } from "./stage-runner.js";
+import { createLinkedAbortController } from "../orchestration/cancellation.js";
+import { getIsoTimestamp, getDurationMs, createSkippedStageResult, createItemSuccess, createItemFailure } from "./results.js";
+import { buildPipelineItemStartedPayload, buildPipelineItemTerminalPayload } from "./events.js";
+import { writeItemArtifact } from "./artifacts.js";
+async function processItem(item, itemIndex, pipelineId, stages, options, runtime, pipelineSignal, stageLimiters, triggerFailFast) {
+    const startedAt = getIsoTimestamp();
+    if (runtime.eventSink) {
+        runtime.eventSink.emit("pipeline.item.started", buildPipelineItemStartedPayload(pipelineId, itemIndex, startedAt));
+    }
+    const stagesResults = [];
+    let itemStatus = "succeeded";
+    let failedStageName;
+    let firstError;
+    let finalValue = item;
+    for (let i = 0; i < stages.length; i++) {
+        const stage = stages[i];
+        if (!stage)
+            continue;
+        if (pipelineSignal.aborted) {
+            itemStatus = "cancelled";
+            const skippedTimestamp = getIsoTimestamp();
+            for (let j = i; j < stages.length; j++) {
+                const skippedStage = stages[j];
+                if (skippedStage) {
+                    stagesResults.push(createSkippedStageResult(skippedStage.name, j, skippedTimestamp));
+                }
+            }
+            break;
+        }
+        const limiter = stageLimiters[i];
+        if (!limiter)
+            continue;
+        const stageResult = await limiter.run(async () => {
+            if (pipelineSignal.aborted) {
+                return createSkippedStageResult(stage.name, i, getIsoTimestamp());
+            }
+            return runStage({
+                stage,
+                stageIndex: i,
+                item: finalValue,
+                itemIndex,
+                pipelineId,
+                options,
+                runtime,
+                parentSignal: pipelineSignal
+            });
+        });
+        stagesResults.push(stageResult);
+        if (stageResult.status === "succeeded") {
+            finalValue = stageResult.value;
+        }
+        else {
+            itemStatus =
+                stageResult.status === "timed_out"
+                    ? "timed_out"
+                    : stageResult.status === "cancelled"
+                        ? "cancelled"
+                        : "failed";
+            failedStageName = stage.name;
+            firstError = stageResult.error;
+            const skippedTimestamp = getIsoTimestamp();
+            for (let j = i + 1; j < stages.length; j++) {
+                const skippedStage = stages[j];
+                if (skippedStage) {
+                    stagesResults.push(createSkippedStageResult(skippedStage.name, j, skippedTimestamp));
+                }
+            }
+            if (options.failFast) {
+                triggerFailFast();
+            }
+            break;
+        }
+    }
+    const finishedAt = getIsoTimestamp();
+    const durationMs = getDurationMs(startedAt, finishedAt);
+    let result;
+    if (itemStatus === "succeeded") {
+        result = createItemSuccess(itemIndex, startedAt, finishedAt, durationMs, finalValue, stagesResults);
+    }
+    else {
+        result = createItemFailure(itemIndex, itemStatus, startedAt, finishedAt, durationMs, failedStageName, firstError, stagesResults);
+    }
+    // 1. Write item artifact
+    await writeItemArtifact(runtime.artifactStore, pipelineId, itemIndex, result);
+    // 2. Emit item terminal event
+    if (runtime.eventSink) {
+        const eventType = result.status === "succeeded" ? "pipeline.item.completed" : "pipeline.item.failed";
+        const itemTerminalPayload = buildPipelineItemTerminalPayload(pipelineId, result);
+        runtime.eventSink.emit(eventType, itemTerminalPayload);
+    }
+    return result;
+}
+export async function runItemStreaming(items, stages, options, pipelineId, runtime, parentSignal) {
+    const pipelineAbortController = createLinkedAbortController(parentSignal);
+    const pipelineSignal = pipelineAbortController.signal;
+    const itemLimiter = createLimiter(options.concurrency);
+    const stageLimiters = stages.map((stage) => {
+        const limit = getEffectiveStageConcurrency(stage.name, stage.concurrency, options.concurrency, options.stageConcurrency[stage.name]);
+        return createLimiter(limit);
+    });
+    const triggerFailFast = () => {
+        pipelineAbortController.abort("fail-fast");
+    };
+    const completedResults = [];
+    const itemPromises = items.map((item, index) => {
+        return itemLimiter.run(async () => {
+            const res = await processItem(item, index, pipelineId, stages, options, runtime, pipelineSignal, stageLimiters, triggerFailFast);
+            completedResults.push(res);
+            return res;
+        });
+    });
+    await Promise.all(itemPromises);
+    if (options.preserveOrder === false) {
+        return completedResults;
+    }
+    else {
+        return [...completedResults].sort((a, b) => a.itemIndex - b.itemIndex);
+    }
+}
+//# sourceMappingURL=item-streaming.js.map

package/dist/pipeline/item-streaming.js.map

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