poly-weaver 0.2.5

package/dist/flow/dsl.d.ts

@@ -0,0 +1,65 @@
+import type { AgentStep, UserStep, LoopStep, FlowStep, FlowDefinition, StepContext } from "./types.js";
+export interface ArtifactDataPredicate {
+    readonly _kind: "artifact-data";
+    readonly artifactName: string;
+    readonly dataField: string;
+    readonly expected?: unknown;
+}
+export interface CtxFieldPredicate {
+    readonly _kind: "ctx-field";
+    readonly field: string;
+    readonly op: "==" | "!=" | "<" | ">" | "<=" | ">=";
+    readonly value: unknown;
+}
+export type FlowPredicate = ArtifactDataPredicate | CtxFieldPredicate;
+export type UntilCondition = FlowPredicate | ((ctx: StepContext) => boolean);
+export type WhenCondition = FlowPredicate | ((ctx: StepContext) => boolean);
+export interface CyclePhaseLabel {
+    readonly _kind: "cycle-phase";
+    readonly first: string;
+    readonly subsequent: string;
+}
+export type PhaseLabelSpec = string | CyclePhaseLabel | ((ctx: StepContext) => string);
+export declare function cyclePhase(first: string, subsequent: string): CyclePhaseLabel;
+export declare function artifactData(artifactName: string, field: string, expected?: unknown): ArtifactDataPredicate;
+export declare function ctxField(field: string, op: "==" | "!=" | "<" | ">" | "<=" | ">=", value: unknown): CtxFieldPredicate;
+export declare function predicateLabel(pred: FlowPredicate): string;
+/**
+ * Generic agent step builder. Role-specific helpers (plan, review, implement)
+ * are co-located with their role modules in `agents/{role}/dsl.ts`.
+ */
+export declare function agentStep(role: string, defaults: {
+    reads?: Record<string, string>;
+    writes?: Record<string, string>;
+    feedbackToTask?: boolean;
+    idPrefix?: string;
+    phaseLabel?: PhaseLabelSpec;
+}, opts: {
+    id?: string;
+    role?: string;
+    driver: string;
+    variant?: string;
+    reads?: Record<string, string>;
+    writes?: Record<string, string>;
+    feedbackToTask?: boolean;
+    when?: WhenCondition;
+    whenLabel?: string;
+    phaseLabel?: PhaseLabelSpec;
+}): AgentStep;
+/** Raw user step before predicate expansion. */
+export interface RawUserStep extends UserStep {
+    _idPrefix?: string;
+    _when?: WhenCondition;
+    _whenLabel?: string;
+    _phaseLabel?: PhaseLabelSpec;
+}
+export declare function loop(max: number, until: UntilCondition, steps: FlowStep[], opts?: {
+    onExhausted?: UserStep;
+    untilLabel?: string;
+}): LoopStep;
+/**
+ * Assign IDs and resolve predicates to opaque functions.
+ * After this call, the flow is ready for the executor.
+ */
+export declare function defineFlow(name: string, steps: FlowStep[]): FlowDefinition;
+//# sourceMappingURL=dsl.d.ts.map

package/dist/flow/dsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl.d.ts","sourceRoot":"","sources":["../../src/flow/dsl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,WAAW,EAGZ,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,IAAI,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,MAAM,aAAa,GACrB,qBAAqB,GACrB,iBAAiB,CAAC;AAEtB,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,CAAC,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC;AAC7E,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,CAAC,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC;AAI5E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,eAAe,GACf,CAAC,CAAC,GAAG,EAAE,WAAW,KAAK,MAAM,CAAC,CAAC;AAEnC,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,eAAe,CAE7E;AAID,wBAAgB,YAAY,CAC1B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,OAAO,GACjB,qBAAqB,CAEvB;AAED,wBAAgB,QAAQ,CACtB,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,IAAI,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,EACzC,KAAK,EAAE,OAAO,GACb,iBAAiB,CAEnB;AAID,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAa1D;AAqFD;;;GAGG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE;IACR,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B,EACD,IAAI,EAAE;IACJ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B,GACA,SAAS,CAkBX;AAID,gDAAgD;AAChD,MAAM,WAAW,WAAY,SAAQ,QAAQ;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,cAAc,CAAC;CAC9B;AAiBD,wBAAgB,IAAI,CAClB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,QAAQ,EAAE,EACjB,IAAI,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,QAAQ,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,QAAQ,CAYV;AAID;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,cAAc,CAI1E"}

package/dist/flow/dsl.js

@@ -0,0 +1,210 @@
+export function cyclePhase(first, subsequent) {
+    return { _kind: "cycle-phase", first, subsequent };
+}
+// ─── Predicate DSL helpers ───────────────────────────────────────────
+export function artifactData(artifactName, field, expected) {
+    return { _kind: "artifact-data", artifactName, dataField: field, expected };
+}
+export function ctxField(field, op, value) {
+    return { _kind: "ctx-field", field, op, value };
+}
+// ─── Predicate labelling ─────────────────────────────────────────────
+export function predicateLabel(pred) {
+    switch (pred._kind) {
+        case "artifact-data": {
+            const suffix = pred.expected !== undefined && pred.expected !== true
+                ? `=${String(pred.expected)}` : "";
+            return `${pred.artifactName}.${pred.dataField}${suffix}`;
+        }
+        case "ctx-field": {
+            const opMap = { "==": "=", "!=": "≠", "<": "<", ">": ">", "<=": "≤", ">=": "≥" };
+            return `iter${opMap[pred.op]}${pred.value}`;
+        }
+    }
+}
+// ─── Predicate resolution (build time) ───────────────────────────────
+const KNOWN_CTX_FIELDS = new Set(["iteration"]);
+function validateCtxField(field) {
+    if (!KNOWN_CTX_FIELDS.has(field)) {
+        throw new Error(`Unknown context field "${field}". Available fields: ${[...KNOWN_CTX_FIELDS].join(", ")}`);
+    }
+}
+function resolveCtxField(ctx, field, loopId) {
+    switch (field) {
+        case "iteration":
+            return ctx.loopCycle.get(loopId);
+    }
+}
+function compareValues(actual, op, expected) {
+    switch (op) {
+        case "==": return actual === expected;
+        case "!=": return actual !== expected;
+        case "<": return actual < expected;
+        case ">": return actual > expected;
+        case "<=": return actual <= expected;
+        case ">=": return actual >= expected;
+        default: return false;
+    }
+}
+function resolvePredicate(condition, containingLoopId) {
+    if (typeof condition === "function")
+        return condition;
+    switch (condition._kind) {
+        case "artifact-data": {
+            const { artifactName, dataField, expected = true } = condition;
+            return (ctx) => (ctx.artifacts.getData(artifactName))?.[dataField] === expected;
+        }
+        case "ctx-field": {
+            validateCtxField(condition.field);
+            const { field, op, value } = condition;
+            return (ctx) => {
+                const actual = resolveCtxField(ctx, field, containingLoopId);
+                return compareValues(actual, op, value);
+            };
+        }
+    }
+}
+// ─── ID tracking ─────────────────────────────────────────────────────
+class IdTracker {
+    counts = new Map();
+    next(prefix) {
+        const count = (this.counts.get(prefix) ?? 0) + 1;
+        this.counts.set(prefix, count);
+        return count === 1 ? prefix : `${prefix}-${count}`;
+    }
+    /** Always includes the number suffix (e.g. "loop-1", "loop-2"). */
+    nextNumbered(prefix) {
+        const count = (this.counts.get(prefix) ?? 0) + 1;
+        this.counts.set(prefix, count);
+        return `${prefix}-${count}`;
+    }
+}
+/**
+ * Generic agent step builder. Role-specific helpers (plan, review, implement)
+ * are co-located with their role modules in `agents/{role}/dsl.ts`.
+ */
+export function agentStep(role, defaults, opts) {
+    const phaseLabel = opts.phaseLabel ?? defaults.phaseLabel;
+    const raw = {
+        type: "agent",
+        id: opts.id ?? "",
+        role: opts.role ?? role,
+        variant: opts.variant,
+        driver: opts.driver,
+        reads: opts.reads ?? defaults.reads ?? {},
+        writes: opts.writes ?? defaults.writes ?? {},
+        feedbackToTask: opts.feedbackToTask ?? defaults.feedbackToTask ?? false,
+        phaseLabel: typeof phaseLabel === "string" ? phaseLabel : "",
+        _idPrefix: defaults.idPrefix ?? role,
+        _when: opts.when,
+        _whenLabel: opts.whenLabel,
+        _phaseLabel: phaseLabel,
+    };
+    return raw;
+}
+export function loop(max, until, steps, opts) {
+    const raw = {
+        type: "loop",
+        id: "",
+        maxIterations: max,
+        _until: until,
+        _untilLabel: opts?.untilLabel,
+        until: undefined,
+        steps,
+        onExhausted: opts?.onExhausted,
+    };
+    return raw;
+}
+// ─── defineFlow() ────────────────────────────────────────────────────
+/**
+ * Assign IDs and resolve predicates to opaque functions.
+ * After this call, the flow is ready for the executor.
+ */
+export function defineFlow(name, steps) {
+    const tracker = new IdTracker();
+    resolveSteps(steps, tracker, undefined);
+    return { name, steps };
+}
+/** Resolve an executable (agent or user) step: auto-ID, empty-writes, when predicate. */
+function resolveExecutableStep(step, tracker, containingLoopId) {
+    if (step.type === "agent") {
+        if (!step.id) {
+            const raw = step;
+            step.id = tracker.next(raw._idPrefix ?? step.role);
+            delete raw._idPrefix;
+        }
+    }
+    else {
+        const raw = step;
+        if (!raw.id)
+            raw.id = tracker.next(raw._idPrefix ?? `user-${raw.role}`);
+        delete raw._idPrefix;
+    }
+    // Resolve _when predicate (both agent and user steps can have _when)
+    const raw = step;
+    if (raw._when != null && containingLoopId) {
+        // Auto-populate whenLabel from structured predicate (not lambdas)
+        if (typeof raw._when !== "function") {
+            step.whenLabel = raw._whenLabel ?? predicateLabel(raw._when);
+        }
+        else if (raw._whenLabel) {
+            step.whenLabel = raw._whenLabel;
+        }
+        step.when = resolvePredicate(raw._when, containingLoopId);
+    }
+    delete raw._when;
+    delete raw._whenLabel;
+    // Resolve _phaseLabel
+    const rawLabel = raw._phaseLabel;
+    if (rawLabel != null) {
+        if (typeof rawLabel === "string" || typeof rawLabel === "function") {
+            step.phaseLabel = rawLabel;
+        }
+        else {
+            // CyclePhaseLabel — bind to containing loop
+            if (!containingLoopId) {
+                throw new Error(`cyclePhase() used outside a loop on step "${step.id}"`);
+            }
+            const loopId = containingLoopId;
+            const { first, subsequent } = rawLabel;
+            const fn = (ctx) => (ctx.loopCycle.get(loopId) ?? 1) > 1 ? subsequent : first;
+            fn._displayHint = first;
+            step.phaseLabel = fn;
+        }
+        delete raw._phaseLabel;
+    }
+}
+function resolveSteps(steps, tracker, containingLoopId) {
+    for (const step of steps) {
+        switch (step.type) {
+            case "agent":
+            case "user": {
+                resolveExecutableStep(step, tracker, containingLoopId);
+                break;
+            }
+            case "loop": {
+                const raw = step;
+                if (!raw.id)
+                    raw.id = tracker.nextNumbered("loop");
+                // Auto-populate untilLabel from structured predicate (not lambdas)
+                if (typeof raw._until !== "function") {
+                    raw.untilLabel = raw._untilLabel ?? predicateLabel(raw._until);
+                }
+                else if (raw._untilLabel) {
+                    raw.untilLabel = raw._untilLabel;
+                }
+                raw.until = resolvePredicate(raw._until, raw.id);
+                delete raw._until;
+                delete raw._untilLabel;
+                // Resolve child steps with this loop as container
+                resolveSteps(raw.steps, tracker, raw.id);
+                // Resolve onExhausted if present
+                if (raw.onExhausted) {
+                    resolveExecutableStep(raw.onExhausted, tracker, raw.id);
+                }
+                break;
+            }
+        }
+    }
+}
+//# sourceMappingURL=dsl.js.map

package/dist/flow/dsl.js.map

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

package/dist/flow/executor.d.ts

@@ -0,0 +1,22 @@
+import type { StatusBar } from "../status-bar.js";
+import { type FlowDefinition, type StepContext, type RoleHandlerMap } from "./types.js";
+export declare class FlowExecutor {
+    private flow;
+    private handlers;
+    private statusBar?;
+    private loopStack;
+    constructor(flow: FlowDefinition, handlers: RoleHandlerMap, statusBar?: StatusBar | undefined);
+    execute(ctx: StepContext): Promise<void>;
+    private executeSteps;
+    private executeStep;
+    private executeLoop;
+    private executeLoopBody;
+    /**
+     * Incorporate feedback from steps with feedbackToTask: true.
+     * Reads artifact.text verbatim, writes to feedback.md, appends to task.
+     */
+    private incorporateFeedback;
+    private getCurrentIteration;
+    private getCurrentMaxIterations;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/flow/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/flow/executor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAKL,KAAK,cAAc,EAGnB,KAAK,WAAW,EAEhB,KAAK,cAAc,EAGpB,MAAM,YAAY,CAAC;AAEpB,qBAAa,YAAY;IAIrB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,SAAS,CAAC;IALpB,OAAO,CAAC,SAAS,CAAkB;gBAGzB,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,cAAc,EACxB,SAAS,CAAC,EAAE,SAAS,YAAA;IAGzB,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;YAIhC,YAAY;YAsBZ,WAAW;YAuDX,WAAW;YAYX,eAAe;IAqD7B;;;OAGG;YACW,mBAAmB;IA8CjC,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,uBAAuB;CAQhC"}

package/dist/flow/executor.js

@@ -0,0 +1,185 @@
+import { join } from "node:path";
+import { writeFile } from "node:fs/promises";
+import { appendClarifications } from "../prompts.js";
+import { runPhaseWithRetries, logPhase } from "../orchestrator.js";
+import { builtinStrategies } from "../providers/registry.js";
+import { TASK, handlerKey, } from "./types.js";
+export class FlowExecutor {
+    flow;
+    handlers;
+    statusBar;
+    loopStack = [];
+    constructor(flow, handlers, statusBar) {
+        this.flow = flow;
+        this.handlers = handlers;
+        this.statusBar = statusBar;
+    }
+    async execute(ctx) {
+        await this.executeSteps(ctx, this.flow.steps);
+    }
+    async executeSteps(ctx, steps) {
+        for (const step of steps) {
+            let signal;
+            switch (step.type) {
+                case "agent":
+                case "user":
+                    signal = await this.executeStep(step, ctx);
+                    break;
+                case "loop":
+                    signal = await this.executeLoop(step, ctx);
+                    break;
+            }
+            if (signal.kind !== "continue")
+                return signal;
+        }
+        return { kind: "continue" };
+    }
+    async executeStep(step, ctx) {
+        // Evaluate `when` predicate — skip if false
+        if (step.when && !step.when(ctx)) {
+            return { kind: "continue" };
+        }
+        const key = handlerKey(step);
+        const handler = this.handlers.get(key);
+        if (!handler) {
+            throw new Error(`No handler registered for role "${key}"`);
+        }
+        ctx.totalIterations++;
+        const phase = typeof step.phaseLabel === "function"
+            ? step.phaseLabel(ctx)
+            : step.phaseLabel;
+        const agent = step.type === "agent"
+            ? builtinStrategies().get(step.driver)?.displayName
+            : undefined;
+        this.statusBar?.update({
+            phase,
+            ...(agent != null && { agent }),
+            iteration: this.getCurrentIteration(ctx),
+            maxIterations: this.getCurrentMaxIterations(),
+        });
+        const signal = await handler.execute(step, ctx, (name, fn) => runPhaseWithRetries(name, fn));
+        ctx.previousStepRole = step.role;
+        if (step.type === "agent") {
+            const meta = {
+                role: step.role,
+                driver: step.driver,
+                variant: step.variant,
+                displayName: builtinStrategies().get(step.driver)?.displayName ?? step.driver,
+            };
+            for (const storeKey of Object.values(step.writes)) {
+                const existing = ctx.artifacts.get(storeKey);
+                if (existing) {
+                    ctx.artifacts.set(storeKey, {
+                        ...existing,
+                        meta: { ...existing.meta, producer: meta },
+                    });
+                }
+            }
+        }
+        return signal;
+    }
+    async executeLoop(loop, ctx) {
+        this.loopStack.push(loop);
+        try {
+            return await this.executeLoopBody(loop, ctx);
+        }
+        finally {
+            this.loopStack.pop();
+        }
+    }
+    async executeLoopBody(loop, ctx) {
+        let totalAttempts = 0;
+        while (true) { // outer: re-entered on exhaustion-restart
+            let cycleIter = 0;
+            for (let attempt = 1; attempt <= loop.maxIterations; attempt++) {
+                totalAttempts++;
+                cycleIter++;
+                ctx.loopIterations.set(loop.id, totalAttempts);
+                ctx.loopCycle.set(loop.id, cycleIter);
+                const signal = await this.executeSteps(ctx, loop.steps);
+                if (signal.kind === "abort")
+                    return signal;
+                if (signal.kind === "break-loop")
+                    return { kind: "continue" };
+                if (signal.kind === "restart-loop") {
+                    await this.incorporateFeedback(loop, ctx);
+                    cycleIter = 0; // reset cycle counter
+                    continue; // inner for-loop
+                }
+                // Normal completion of one pass — check until predicate
+                if (loop.until(ctx)) {
+                    return { kind: "continue" };
+                }
+                // Not done yet — incorporate feedback and loop
+                if (attempt < loop.maxIterations) {
+                    await this.incorporateFeedback(loop, ctx);
+                }
+            }
+            // Loop exhausted
+            if (loop.onExhausted) {
+                logPhase("Max iterations reached", "Prompting user for feedback");
+                const signal = await this.executeStep(loop.onExhausted, ctx);
+                if (signal.kind === "restart-loop") {
+                    await this.incorporateFeedback(loop, ctx);
+                    continue; // outer while(true) — NOT recursion
+                }
+                if (signal.kind !== "continue")
+                    return signal;
+            }
+            return { kind: "continue" };
+        }
+    }
+    /**
+     * Incorporate feedback from steps with feedbackToTask: true.
+     * Reads artifact.text verbatim, writes to feedback.md, appends to task.
+     */
+    async incorporateFeedback(loop, ctx) {
+        const feedbackFile = join(ctx.sessionDir, "feedback.md");
+        for (const step of loop.steps) {
+            if (step.type === "loop" || !step.feedbackToTask)
+                continue;
+            const artifactNames = Object.values(step.writes);
+            for (const name of artifactNames) {
+                const artifact = ctx.artifacts.get(name);
+                if (!artifact?.text)
+                    continue;
+                // Write feedback.md with artifact text verbatim
+                await writeFile(feedbackFile, artifact.text, "utf-8");
+                // Set artifact.file so handlers can read the feedback path
+                artifact.file = feedbackFile;
+                // Append to task artifact
+                const taskArtifact = ctx.artifacts.get(TASK);
+                if (taskArtifact?.text) {
+                    const appended = appendClarifications(taskArtifact.text, [{ type: "comment", text: artifact.text }], ctx.nextClarificationNumber);
+                    ctx.artifacts.set(TASK, {
+                        ...taskArtifact,
+                        text: appended.content,
+                    });
+                    ctx.nextClarificationNumber = appended.nextNumber;
+                    if (taskArtifact.file) {
+                        await writeFile(taskArtifact.file, appended.content, "utf-8");
+                    }
+                }
+                // Clear text to prevent re-appending
+                artifact.text = undefined;
+            }
+        }
+    }
+    getCurrentIteration(ctx) {
+        for (let i = this.loopStack.length - 1; i >= 0; i--) {
+            if (this.loopStack[i].maxIterations !== Infinity) {
+                return ctx.loopCycle.get(this.loopStack[i].id);
+            }
+        }
+        return undefined;
+    }
+    getCurrentMaxIterations() {
+        for (let i = this.loopStack.length - 1; i >= 0; i--) {
+            if (this.loopStack[i].maxIterations !== Infinity) {
+                return this.loopStack[i].maxIterations;
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/flow/executor.js.map

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

package/dist/flow/index.d.ts

@@ -0,0 +1,16 @@
+export { TASK, handlerKey } from "./types.js";
+export type { Artifact, ArtifactStore, BuiltinRole, DriverName, FlowStep, BaseStep, AgentStep, UserStep, LoopStep, FlowDefinition, StepContext, StepSignal, RetryFn, RoleHandler, RoleHandlerMap, FlowParam, DriverFlowParam, NumberFlowParam, BooleanFlowParam, FlowParamValue, FlowParamValues, FlowTemplate, PhaseLabelFn, } from "./types.js";
+export { MapArtifactStore } from "./artifacts.js";
+export { defineFlow, agentStep, loop, artifactData, ctxField, cyclePhase, } from "./dsl.js";
+export type { FlowPredicate, PhaseLabelSpec, CyclePhaseLabel } from "./dsl.js";
+export { user } from "../user/dsl.js";
+export { FlowExecutor } from "./executor.js";
+export { buildDefaultFlow, defaultFlowTemplate, defaultParams } from "./built-in/default.js";
+export { buildWhySoSeriousFlow, whySoSeriousFlowTemplate } from "./built-in/why-so-serious.js";
+export { loadAllFlows, loadCustomFlows, loadBuiltinFlows, validateTemplate } from "./custom/index.js";
+export type { LoadResult, LoadError } from "./custom/index.js";
+export { resolveFlowParams, toKebabCase, extractFlowParamConfig } from "./params.js";
+export { inspectFlow } from "./inspect.js";
+export type { FlowInsight, LoopInsight } from "./inspect.js";
+export { renderFlowDiagram, diagramHeight, computeMinWidth, renderDetailedFlowDiagram, detailedDiagramHeight, computeDetailedMinWidth } from "./diagram.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/flow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/flow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EACV,QAAQ,EACR,aAAa,EACb,WAAW,EACX,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,WAAW,EACX,UAAU,EACV,OAAO,EACP,WAAW,EACX,cAAc,EACd,SAAS,EACT,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EACL,UAAU,EAAE,SAAS,EAAE,IAAI,EAC3B,YAAY,EAAE,QAAQ,EAAE,UAAU,GACnC,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC/E,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC7F,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAC/F,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACtG,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC"}

package/dist/flow/index.js

@@ -0,0 +1,12 @@
+export { TASK, handlerKey } from "./types.js";
+export { MapArtifactStore } from "./artifacts.js";
+export { defineFlow, agentStep, loop, artifactData, ctxField, cyclePhase, } from "./dsl.js";
+export { user } from "../user/dsl.js";
+export { FlowExecutor } from "./executor.js";
+export { buildDefaultFlow, defaultFlowTemplate, defaultParams } from "./built-in/default.js";
+export { buildWhySoSeriousFlow, whySoSeriousFlowTemplate } from "./built-in/why-so-serious.js";
+export { loadAllFlows, loadCustomFlows, loadBuiltinFlows, validateTemplate } from "./custom/index.js";
+export { resolveFlowParams, toKebabCase, extractFlowParamConfig } from "./params.js";
+export { inspectFlow } from "./inspect.js";
+export { renderFlowDiagram, diagramHeight, computeMinWidth, renderDetailedFlowDiagram, detailedDiagramHeight, computeDetailedMinWidth } from "./diagram.js";
+//# sourceMappingURL=index.js.map

package/dist/flow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/flow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA0B9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EACL,UAAU,EAAE,SAAS,EAAE,IAAI,EAC3B,YAAY,EAAE,QAAQ,EAAE,UAAU,GACnC,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC7F,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAC/F,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEtG,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC"}

package/dist/flow/inspect.d.ts

@@ -0,0 +1,21 @@
+import type { FlowDefinition } from "./types.js";
+export interface LoopInsight {
+    id: string;
+    /** Write keys from direct agent-step children only (excludes nested loops).
+     *  Maps write-key → artifact name. Last-writer-wins among direct children. */
+    ownWrites: Record<string, string>;
+    /** Nesting depth: 0 = top-level, 1 = nested inside one loop, etc. */
+    depth: number;
+}
+export interface FlowInsight {
+    /** All loops discovered at any depth, in document order. */
+    loops: LoopInsight[];
+}
+/**
+ * Inspect a flow definition to extract semantic information
+ * about loops and their write keys, without executing the flow.
+ */
+export declare function inspectFlow(flow: FlowDefinition): FlowInsight;
+/** Check if any step in the flow reads the TASK artifact. */
+export declare function flowReadsTask(flow: FlowDefinition): boolean;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/flow/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/flow/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,YAAY,CAAC;AAGrE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX;kFAC8E;IAC9E,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AA4BD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,cAAc,GAAG,WAAW,CAI7D;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAE3D"}

package/dist/flow/inspect.js

@@ -0,0 +1,54 @@
+import { TASK } from "./types.js";
+/** Collect write keys from direct non-loop children only (not nested loops). */
+function collectOwnWrites(steps) {
+    const writes = {};
+    for (const step of steps) {
+        if (step.type !== "loop") {
+            for (const [key, artifactName] of Object.entries(step.writes)) {
+                writes[key] = artifactName;
+            }
+        }
+        // Deliberately skip nested loops — their writes belong to their own LoopInsight
+    }
+    return writes;
+}
+/** Discover all loops at any nesting depth in document order. */
+function findAllLoops(steps, depth = 0) {
+    const loops = [];
+    for (const step of steps) {
+        if (step.type === "loop") {
+            loops.push({ id: step.id, ownWrites: collectOwnWrites(step.steps), depth });
+            loops.push(...findAllLoops(step.steps, depth + 1));
+        }
+    }
+    return loops;
+}
+/**
+ * Inspect a flow definition to extract semantic information
+ * about loops and their write keys, without executing the flow.
+ */
+export function inspectFlow(flow) {
+    return {
+        loops: findAllLoops(flow.steps),
+    };
+}
+/** Check if any step in the flow reads the TASK artifact. */
+export function flowReadsTask(flow) {
+    return stepsReadArtifact(flow.steps, TASK);
+}
+function stepsReadArtifact(steps, artifactName) {
+    for (const step of steps) {
+        if (step.type === "loop") {
+            if (stepsReadArtifact(step.steps, artifactName))
+                return true;
+            if (step.onExhausted && Object.values(step.onExhausted.reads).includes(artifactName))
+                return true;
+        }
+        else {
+            if (Object.values(step.reads).includes(artifactName))
+                return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=inspect.js.map

package/dist/flow/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../src/flow/inspect.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAgBlC,gFAAgF;AAChF,SAAS,gBAAgB,CAAC,KAAiB;IACzC,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,KAAK,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9D,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;YAC7B,CAAC;QACH,CAAC;QACD,gFAAgF;IAClF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,iEAAiE;AACjE,SAAS,YAAY,CAAC,KAAiB,EAAE,KAAK,GAAG,CAAC;IAChD,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5E,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAoB;IAC9C,OAAO;QACL,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,aAAa,CAAC,IAAoB;IAChD,OAAO,iBAAiB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAiB,EAAE,YAAoB;IAChE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC7D,IAAI,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAAE,OAAO,IAAI,CAAC;QACpG,CAAC;aAAM,CAAC;YACN,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAAE,OAAO,IAAI,CAAC;QACpE,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}