@proposit/proposit-core 2.4.0 → 2.4.1

package/dist/lib/pipelines/llm-stage-helpers.js

@@ -0,0 +1,567 @@
+// The `llmStage` implementation and its supporting package-internal seam.
+//
+// `llmStage`'s body is factored into two package-internal seam functions
+// — `buildLlmRequest` (prompt-build + `TLlmRequest` assembly) and
+// `validateLlmOutcome` (parse → `Value.Check` → outcome/retry
+// classification) — so the SAME logic backs both the in-process
+// `llmStage.run` retry loop AND the launch/complete split
+// (`launchStage`/`completeStage`, in `single-stage.ts`). None of this is
+// exported from the package: there is no consumer use case, and
+// `llmStage`'s public return type stays `TStage<TOutput>` (it does NOT
+// widen). The resolved config rides an internal-symbol-keyed,
+// non-enumerable carrier on the returned stage object, recovered only by
+// the package-internal `readLlmStageConfig`.
+//
+// `stage-helpers.ts` re-exports every name this module exports (and
+// nothing else moved) so the ~20 existing direct-import call sites under
+// `src/extensions/` and the public barrel see no path change.
+import { Pointer, Value } from "typebox/value";
+import { debugMaxLengthTruncation } from "./debug-log.js";
+import { LLM_NON_RETRYABLE_ERROR, LLM_QUOTA_EXHAUSTED, LLM_RATE_LIMITED, LLM_TRANSIENT_ERROR, LLM_UNKNOWN_ERROR, OUTPUT_SCHEMA_INVALID, } from "./failure-codes.js";
+import { StageAbortedError, stashTokenUsage, DEFAULT_RETRY_POLICY, } from "./stage-helpers.js";
+const TRUNCATION_SUFFIX = "…<truncated>";
+function truncateValidationError(error, capBytes) {
+    // NOTE: `capBytes` is measured in JavaScript `string.length` —
+    // UTF-16 code units, not UTF-8 bytes. The spec (§6.3) phrases the
+    // cap as "bytes"; for ASCII-heavy validation errors the two are
+    // equal, and for non-ASCII paths a 2048 cap is roughly 2–4 KB of
+    // UTF-8 depending on character distribution. We accept this drift
+    // for V1: realistic TypeBox validation errors are short and
+    // English; a future polish pass can switch to
+    // `new TextEncoder().encode(error).length` if a real workload
+    // shows the distinction matters.
+    if (error.length <= capBytes) {
+        return error;
+    }
+    const head = Math.max(0, capBytes - TRUNCATION_SUFFIX.length);
+    return error.slice(0, head) + TRUNCATION_SUFFIX;
+}
+/**
+ * Thrown internally by `llmStage` after retry exhaustion. The
+ * executor catches it and converts it into a `ProcessingFailure`.
+ */
+export class LlmStageRetryExhaustedError extends Error {
+    reason;
+    code;
+    attempts;
+    stageId;
+    failureContext;
+    constructor(args) {
+        super(args.message);
+        this.name = "LlmStageRetryExhaustedError";
+        this.stageId = args.stageId;
+        this.reason = args.reason;
+        this.code = args.code;
+        this.attempts = args.attempts;
+        this.failureContext = args.context;
+    }
+}
+function classifyError(err) {
+    if (typeof err !== "object" || err === null) {
+        return "non_retryable";
+    }
+    const tag = err.retryReason;
+    if (tag === "transient" ||
+        tag === "rate_limit" ||
+        tag === "quota_exhausted") {
+        return tag;
+    }
+    return "non_retryable";
+}
+async function sleep(ms, signal) {
+    if (ms <= 0)
+        return;
+    if (signal.aborted)
+        return;
+    await new Promise((resolve) => {
+        const timer = setTimeout(() => {
+            signal.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            signal.removeEventListener("abort", onAbort);
+            resolve();
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+    });
+}
+function emitRetry(ctx, stageId, attempt, reason) {
+    const event = {
+        kind: "stage:retry",
+        stageId,
+        attempt,
+        reason,
+        at: now(),
+    };
+    ctx.emit(event);
+}
+function now() {
+    return typeof performance !== "undefined" && performance.now
+        ? performance.now()
+        : Date.now();
+}
+// Internal-symbol key for the config carrier. Not exported, so no consumer
+// can read or forge it; only this module's `readLlmStageConfig` recovers it.
+const LLM_STAGE_CONFIG = Symbol("propositLlmStageConfig");
+/**
+ * Recover the resolved `llmStage` config from a stage built by
+ * `llmStage`. Returns `undefined` for any stage that is not an LLM stage
+ * (a deterministic / sub-pipeline stage carries no config). Package-internal.
+ */
+export function readLlmStageConfig(stage) {
+    return stage[LLM_STAGE_CONFIG];
+}
+/**
+ * True iff `stage` is an LLM-background stage — one built by `llmStage` that
+ * carries the resolved LLM config and is therefore driven by `launchStage` /
+ * `completeStage`. False for deterministic and sub-pipeline stages (drive those
+ * with `executeStage`). Mirrors exactly the check `launchStage`/`completeStage`
+ * apply internally, so a consumer driving a pipeline out-of-process can route a
+ * stage to the right driver without catching a thrown `PipelineConfigurationError`.
+ */
+export function isLlmStage(stage) {
+    return readLlmStageConfig(stage) != null;
+}
+/**
+ * Append the retry-suffix the in-process loop adds after a failed
+ * schema-validation attempt. Shared by the loop and `launchStage` (so a
+ * re-launched attempt 2+ rebuilds the identical `userMessage`).
+ * Package-internal.
+ */
+export function applyRetrySuffix(baseUser, validationError, errorCap) {
+    const truncated = truncateValidationError(validationError, errorCap);
+    return (baseUser +
+        "\n\nYour previous response failed schema validation: " +
+        truncated +
+        ". Please retry conforming to the schema.");
+}
+// Resolved error-cap for a config's retry policy (the per-retry appended
+// validation-error byte bound), defaulted the same way the factory does.
+function resolveErrorCap(policy) {
+    return (policy.maxAppendedErrorBytes ??
+        DEFAULT_RETRY_POLICY.maxAppendedErrorBytes ??
+        2048);
+}
+/**
+ * Front half of the seam: build the per-attempt prompts + `TLlmRequest`.
+ * `userMessage` overrides the prompt's user message (the loop / launch
+ * pass the retry-suffixed message on attempt 2+); it defaults to
+ * `buildPrompt(ctx).user`. The returned `req` carries NO `onResponseCreated`
+ * — the in-process loop attaches its own emitter; the launch path uses the
+ * submit return value instead. Package-internal.
+ */
+export function buildLlmRequest(cfg, ctx, userMessage) {
+    const prompt = cfg.buildPrompt(ctx);
+    const user = userMessage ?? prompt.user;
+    const req = {
+        model: cfg.model,
+        reasoningEffort: cfg.reasoningEffort,
+        systemPrompt: prompt.system,
+        userMessage: user,
+        outputSchema: cfg.outputSchema,
+        tools: cfg.tools,
+        maxOutputTokens: cfg.maxOutputTokens,
+        signal: ctx.signal,
+    };
+    return { req, prompts: { system: prompt.system, user } };
+}
+// The genuinely-shared validation core: check a PARSED output value
+// against the stage schema and format the validation error. Used by both
+// the in-process loop (output already parsed by the provider) and
+// `validateLlmOutcome`'s completed branch (output parsed from raw text).
+// Truncate every string longer than its schema's `maxLength` to that cap,
+// mutating `value` in place. Driven off the validator's own `maxLength`
+// errors (which carry the JSON-pointer path + the limit), so it handles
+// nested objects, arrays, and discriminated unions without walking the
+// schema by hand. Re-runs because a union surfaces a failing variant's
+// inner errors only once its siblings are reconciled; truncation is
+// monotonic (strings only shrink) so the loop converges. The pass cap is a
+// backstop against a degenerate schema.
+//
+// Truncation is non-fatal (ingestion output is human-proofread before
+// publish), so it does not surface to the caller. It does emit a
+// debug-gated breadcrumb per clipped field — the only signal of whether
+// the upstream length steering (shrunk wire `maxLength` + budget hint)
+// is still letting overshoots through. `stageId` tags the breadcrumb so
+// it groups with the stage's other diagnostic lines.
+function clampMaxLengthStrings(stageId, schema, value) {
+    for (let pass = 0; pass < 16; pass++) {
+        let changed = false;
+        for (const err of Value.Errors(schema, value)) {
+            if (err.keyword !== "maxLength")
+                continue;
+            const limit = err.params.limit;
+            const current = Pointer.Get(value, err.instancePath);
+            if (typeof current === "string" && current.length > limit) {
+                debugMaxLengthTruncation({
+                    stageId,
+                    instancePath: err.instancePath,
+                    limit,
+                    originalLength: current.length,
+                });
+                Pointer.Set(value, err.instancePath, current.slice(0, limit));
+                changed = true;
+            }
+        }
+        if (!changed)
+            break;
+    }
+}
+function checkLlmOutput(cfg, output) {
+    if (Value.Check(cfg.outputSchema, output)) {
+        return { valid: true };
+    }
+    // OpenAI strict structured-output IGNORES JSON-Schema string `maxLength`,
+    // so a model can return an over-long string the schema forbids — a
+    // recoverable issue that must NOT fail the whole stage. Truncate any
+    // over-long string to its declared cap (in place) and re-check, rather
+    // than rejecting the output and halting the pipeline.
+    clampMaxLengthStrings(cfg.id, cfg.outputSchema, output);
+    if (Value.Check(cfg.outputSchema, output)) {
+        return { valid: true };
+    }
+    const errors = [...Value.Errors(cfg.outputSchema, output)];
+    const validationError = errors
+        .map((e) => `${e.instancePath}: ${e.message}`)
+        .join("; ");
+    return { valid: false, validationError };
+}
+/**
+ * Back half of the seam: turn a retrieved background response (RAW
+ * assistant text + terminal status + `incompleteReason`) into an outcome
+ * + optional typed output + a retry classification.
+ *
+ * The parse + `Value.Check` half is genuinely shared with the in-process
+ * loop (via `checkLlmOutput`). The status/reason → outcome+retry mapping
+ * is a DELIBERATE `lib/`-side MIRROR of the OpenAI provider's
+ * classification (`extensions/openai/provider.ts`): `src/lib/` may not
+ * import the extension classifier (the zero-SDK-import invariant), so the
+ * mapping is duplicated here and pinned to the provider by a contract test.
+ * Package-internal.
+ */
+export function validateLlmOutcome(cfg, rawText, status, incompleteReason) {
+    if (status === "completed") {
+        // Parse the RAW assistant text first. A parse throw mirrors the
+        // provider's `SchemaValidationLlmError` (malformed structured-output
+        // JSON), which classifies as retryable `schema_validation`.
+        let parsed;
+        try {
+            parsed = JSON.parse(rawText ?? "");
+        }
+        catch (err) {
+            const message = `Provider returned malformed JSON in structured-output text: ${err instanceof Error ? err.message : String(err)}`;
+            return {
+                outcome: "failed",
+                failure: {
+                    reason: "schema_validation",
+                    code: OUTPUT_SCHEMA_INVALID,
+                    message,
+                },
+                validationError: message,
+            };
+        }
+        const checked = checkLlmOutput(cfg, parsed);
+        if (checked.valid) {
+            return { outcome: "completed", output: parsed };
+        }
+        const validationError = checked.validationError ?? "schema validation failed";
+        return {
+            outcome: "failed",
+            failure: {
+                reason: "schema_validation",
+                code: OUTPUT_SCHEMA_INVALID,
+                message: validationError,
+            },
+            validationError,
+        };
+    }
+    if (status === "cancelled") {
+        // A cancelled background response mirrors a mid-flight abort:
+        // recorded `skipped`, NO `ProcessingFailure`, so a consumer can
+        // distinguish a cancel from a genuine error.
+        return { outcome: "skipped" };
+    }
+    if (status === "incomplete") {
+        const reason = incompleteReason ?? "unspecified";
+        if (reason === "content_filter") {
+            // Deterministic — the policy filter won't change on a re-roll;
+            // fail-fast (NO retryReason), mirroring NonRetryableLlmError.
+            return {
+                outcome: "failed",
+                failure: {
+                    reason: "transient",
+                    code: LLM_NON_RETRYABLE_ERROR,
+                    message: formatIncompleteMirror(reason),
+                },
+            };
+        }
+        // `max_output_tokens` and any other/unspecified reason → retryable
+        // transient (mirrors the provider's conservative TransientLlmError).
+        return {
+            outcome: "failed",
+            failure: {
+                reason: "transient",
+                code: LLM_TRANSIENT_ERROR,
+                message: formatIncompleteMirror(reason),
+            },
+        };
+    }
+    // status === "failed" (or any other non-terminal value reaching here):
+    // a terminal failed envelope is NonRetryableLlmError → fail-fast (NO
+    // retryReason). `transient` would be WRONG (it's in the default
+    // retryOn, so the workflow would retry a definitively-failed response).
+    return {
+        outcome: "failed",
+        failure: {
+            reason: "transient",
+            code: LLM_NON_RETRYABLE_ERROR,
+            message: `Provider returned status "${status}".`,
+        },
+    };
+}
+// `lib/`-side mirror of the provider's incomplete-reason message. Kept
+// terse + reason-naming (the provider's full guidance text lives in
+// `extensions/openai/provider.ts#formatIncompleteMessage`, which `lib/`
+// cannot import).
+function formatIncompleteMirror(reason) {
+    return `Provider returned status "incomplete" (reason: ${reason}).`;
+}
+// Whether the failure's `reason` is a RETRYABLE classification to surface
+// on `TExecuteStageResult.retryReason`. Fail-fast failures carry a
+// `non-retryable` code (LLM_NON_RETRYABLE_ERROR) and surface NO
+// retryReason; the genuinely-retryable reasons are the workflow's
+// re-launch signal. Package-internal.
+export function failureRetryReason(failure) {
+    if (failure.code === LLM_NON_RETRYABLE_ERROR)
+        return undefined;
+    return failure.reason;
+}
+// -- LLM stage --
+export function llmStage(config) {
+    const policy = {
+        ...DEFAULT_RETRY_POLICY,
+        ...config.retry,
+        retryOn: config.retry?.retryOn ?? DEFAULT_RETRY_POLICY.retryOn,
+    };
+    const errorCap = resolveErrorCap(policy);
+    const cfg = {
+        id: config.id,
+        outputSchema: config.outputSchema,
+        model: config.model,
+        reasoningEffort: config.reasoningEffort,
+        buildPrompt: config.buildPrompt,
+        tools: config.tools,
+        maxOutputTokens: config.maxOutputTokens,
+        retryPolicy: policy,
+    };
+    const stage = {
+        id: config.id,
+        dependsOn: config.dependsOn,
+        outputSchema: config.outputSchema,
+        run: async (ctx) => {
+            const prompt = config.buildPrompt(ctx);
+            let userMessage = prompt.user;
+            let attempt = 0;
+            let lastError = null;
+            while (attempt < policy.maxAttempts) {
+                attempt += 1;
+                if (ctx.signal.aborted) {
+                    // Loop-top abort: caller cancelled before (or
+                    // between) attempts. Surface as a `skipped` stage
+                    // rather than a failure.
+                    throw new StageAbortedError({ stageId: config.id });
+                }
+                // Emit the `stage:llm-response-created` event the moment
+                // the provider surfaces a response id. In background-stream
+                // mode this fires MID-FLIGHT — before `respond()` resolves
+                // — from the provider's `onResponseCreated` callback (the
+                // first `response.created` SSE event). That early emit is
+                // load-bearing: a consumer persists the id before a
+                // possible crash, so a call interrupted mid-generation can
+                // be recovered from the upstream's stored copy rather than
+                // blindly re-run. In synchronous mode the callback never
+                // fires; the id is surfaced only at completion (below). The
+                // `responseIdEmitted` flag dedupes so the event fires at
+                // most once per attempt.
+                let responseIdEmitted = false;
+                const emitResponseCreated = (responseId) => {
+                    if (responseIdEmitted)
+                        return;
+                    responseIdEmitted = true;
+                    ctx.emit({
+                        kind: "stage:llm-response-created",
+                        stageId: config.id,
+                        attempt,
+                        responseId,
+                        at: now(),
+                    });
+                };
+                // Build the request via the shared seam, then attach this
+                // attempt's mid-flight id emitter (the seam leaves
+                // `onResponseCreated` unset — the launch path uses the
+                // submit return value instead).
+                const { req } = buildLlmRequest(cfg, ctx, userMessage);
+                req.onResponseCreated = emitResponseCreated;
+                // Emit the pre-call stage-input event. Fires inside the
+                // retry loop after `attempt` is incremented and after the
+                // request is built, immediately before `respond()` — so a
+                // consumer can surface the as-sent prompts the instant the
+                // call starts, without waiting for the post-call
+                // `stage:llm-call`. On attempt 2+ `userMessage` already
+                // carries the retry-suffix appended by the prior attempt's
+                // schema-validation failure path, matching this attempt's
+                // eventual `stage:llm-call.prompts.user`.
+                ctx.emit({
+                    kind: "stage:llm-request",
+                    stageId: config.id,
+                    attempt,
+                    prompts: {
+                        system: prompt.system,
+                        user: userMessage,
+                    },
+                    at: now(),
+                });
+                try {
+                    const response = await ctx.llm.respond(req);
+                    // Completion-time fallback: if the provider surfaced an
+                    // id but did NOT fire the mid-flight callback (the
+                    // synchronous / poll paths), emit here so the event
+                    // still precedes `stage:llm-call` on this attempt.
+                    if (response.rawResponseId) {
+                        emitResponseCreated(response.rawResponseId);
+                    }
+                    // Shared validation core (same check the launch/complete
+                    // path runs via validateLlmOutcome's completed branch).
+                    const checked = checkLlmOutput(cfg, response.output);
+                    const validationPassed = checked.valid;
+                    const validationError = checked.validationError;
+                    // Emit per-attempt LLM-call event. Fires after the
+                    // call returns and after schema validation has run,
+                    // before retry/return branching. `validationError`
+                    // is `undefined` when the schema accepted the
+                    // output, a string when it rejected. `prompts.user`
+                    // is the as-sent message — on attempt 2+ this
+                    // includes any retry-suffix appended by the prior
+                    // attempt's schema-validation failure path.
+                    ctx.emit({
+                        kind: "stage:llm-call",
+                        stageId: config.id,
+                        attempt,
+                        prompts: {
+                            system: prompt.system,
+                            user: userMessage,
+                        },
+                        output: response.output,
+                        tokenUsage: response.tokenUsage,
+                        rawResponseId: response.rawResponseId,
+                        validationError,
+                        at: now(),
+                    });
+                    if (!validationPassed) {
+                        // validationError is defined here because
+                        // validationPassed is false.
+                        const validationMessage = validationError;
+                        lastError = {
+                            reason: "schema_validation",
+                            code: OUTPUT_SCHEMA_INVALID,
+                            message: validationMessage,
+                        };
+                        const retryable = policy.retryOn.includes("schema_validation");
+                        if (!retryable || attempt >= policy.maxAttempts) {
+                            break;
+                        }
+                        emitRetry(ctx, config.id, attempt, "schema_validation");
+                        userMessage = applyRetrySuffix(prompt.user, validationMessage, errorCap);
+                        await sleep(policy.backoffMs, ctx.signal);
+                        continue;
+                    }
+                    // Token usage emission is handled by the executor at
+                    // stage:end time; we return the response output and
+                    // attach the usage onto a side channel via failure-free
+                    // path.
+                    // We stash token usage on a per-stage well-known key
+                    // recognized by the executor.
+                    stashTokenUsage(ctx, config.id, response.tokenUsage);
+                    return response.output;
+                }
+                catch (err) {
+                    if (err instanceof LlmStageRetryExhaustedError &&
+                        err.stageId === config.id) {
+                        // Re-throw our own marker; the catch below shouldn't
+                        // see it. Defensive.
+                        throw err;
+                    }
+                    if (err instanceof StageAbortedError) {
+                        throw err;
+                    }
+                    // Mid-flight abort surfaces here when the provider
+                    // honored the signal and threw. Recognize it before
+                    // classifying as a generic non-retryable failure so
+                    // the executor can mark this stage `skipped`, not
+                    // `failed` with `LLM_NON_RETRYABLE_ERROR`.
+                    if (ctx.signal.aborted) {
+                        throw new StageAbortedError({ stageId: config.id });
+                    }
+                    const reason = classifyError(err);
+                    const message = err instanceof Error ? err.message : String(err);
+                    if (reason === "non_retryable") {
+                        lastError = {
+                            reason: "transient",
+                            code: LLM_NON_RETRYABLE_ERROR,
+                            message,
+                        };
+                        break;
+                    }
+                    lastError = {
+                        reason,
+                        code: reason === "quota_exhausted"
+                            ? LLM_QUOTA_EXHAUSTED
+                            : reason === "rate_limit"
+                                ? LLM_RATE_LIMITED
+                                : LLM_TRANSIENT_ERROR,
+                        message,
+                    };
+                    // Fail-fast for any reason not opted into `retryOn`.
+                    // `quota_exhausted` is absent from every default
+                    // policy, so a quota 429 breaks here on attempt 1 —
+                    // same control flow `rate_limit` already takes.
+                    if (!policy.retryOn.includes(reason)) {
+                        break;
+                    }
+                    if (attempt >= policy.maxAttempts) {
+                        break;
+                    }
+                    emitRetry(ctx, config.id, attempt, reason);
+                    await sleep(policy.backoffMs, ctx.signal);
+                }
+            }
+            const failure = lastError ?? {
+                reason: "transient",
+                code: LLM_UNKNOWN_ERROR,
+                message: "llmStage retry loop exited without error context",
+            };
+            throw new LlmStageRetryExhaustedError({
+                stageId: config.id,
+                reason: failure.reason,
+                code: failure.code,
+                attempts: attempt,
+                message: failure.message,
+                context: failure.context,
+            });
+        },
+    };
+    // Attach the resolved config on a non-enumerable, internal-symbol-keyed
+    // carrier so `launchStage`/`completeStage` (same package) can recover it
+    // via `readLlmStageConfig`. Non-enumerable + symbol-keyed keeps it off
+    // every enumeration and JSON serialization of the stage object, and out
+    // of the public `TStage` shape.
+    Object.defineProperty(stage, LLM_STAGE_CONFIG, {
+        value: cfg,
+        enumerable: false,
+        writable: false,
+        configurable: false,
+    });
+    return stage;
+}
+//# sourceMappingURL=llm-stage-helpers.js.map

package/dist/lib/pipelines/llm-stage-helpers.js.map

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

package/dist/lib/pipelines/scheduler.d.ts

@@ -0,0 +1,62 @@
+import type { TPipeline, TPipelineEvent, TPipelineResult, TProcessingFailure, TStage, TStageContext, TStageStatus } from "./types.js";
+import type { TLlmProvider, TLlmTokenUsage } from "../llm/types.js";
+export type TExecutePipelineDeps = {
+    llm: TLlmProvider;
+    generateId?: () => string;
+    signal?: AbortSignal;
+    onEvent?: (event: TPipelineEvent) => void;
+    /** Default 4. */
+    concurrencyLimit?: number;
+};
+export declare class PipelineConfigurationError extends Error {
+    readonly code: "DAG_CYCLE" | "SELF_DEP" | "UNKNOWN_DEP" | "UNKNOWN_STAGE" | "DUPLICATE_STAGE_ID" | "GET_OUTSIDE_DEPS" | "STATUS_OUTSIDE_DEPS";
+    readonly stageId?: string;
+    readonly depId?: string;
+    constructor(args: {
+        code: PipelineConfigurationError["code"];
+        message: string;
+        stageId?: string;
+        depId?: string;
+    });
+}
+export declare function now(): number;
+export declare function defaultGenerateId(): string;
+export declare function noopEmit(_event: TPipelineEvent): void;
+export type TStageRecord = {
+    outcome: TStageStatus;
+    output: unknown;
+    tokenUsage?: TLlmTokenUsage;
+};
+export type TStageRunState = {
+    /** The inter-stage record store `ctx.get` / `ctx.stageStatus` read. */
+    records: Map<string, TStageRecord>;
+    /** Aggregated structured failures the run produces. */
+    failures: TProcessingFailure[];
+    /** Cancellation signal threaded into each stage's `ctx.signal`. */
+    signal: AbortSignal;
+    /** Observability hook for `TPipelineEvent`s. */
+    emit: (event: TPipelineEvent) => void;
+    /** ID generator threaded into each stage's `ctx.generateId`. */
+    generateId: () => string;
+    /** The provider every `llmStage` calls. */
+    llm: TLlmProvider;
+    /**
+     * The parsed (Default/Convert/Clean-transformed) pipeline input that
+     * seeds every stage's `ctx.input`.
+     */
+    input: unknown;
+    /**
+     * Disposition seam for a `PipelineConfigurationError` raised by
+     * `ctx.get` / `ctx.stageStatus` on a non-dependency stage id (a
+     * caller bug). The whole-DAG scheduler captures the first one and
+     * re-throws it after emitting the bookend events; the single-stage
+     * path supplies a callback that throws immediately (it has no
+     * bookends to emit). One extracted body, two dispositions.
+     */
+    setConfigError: (error: PipelineConfigurationError) => void;
+};
+export declare function makeStageContext(state: TStageRunState, allowedDeps: Set<string>, contextLabel: string): TStageContext;
+export declare function runOneStage(stage: TStage<unknown>, ctx: TStageContext, state: TStageRunState): Promise<void>;
+export declare function runFinalize<TOutput>(pipeline: TPipeline<unknown, TOutput>, ctx: TStageContext, state: TStageRunState): TOutput | null;
+export declare function executePipeline<TInput, TOutput>(pipeline: TPipeline<TInput, TOutput>, input: TInput, deps: TExecutePipelineDeps): Promise<TPipelineResult<TOutput>>;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/lib/pipelines/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../../src/lib/pipelines/scheduler.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAER,SAAS,EACT,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,MAAM,EACN,aAAa,EACb,YAAY,EACf,MAAM,YAAY,CAAA;AAcnB,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEnE,MAAM,MAAM,oBAAoB,GAAG;IAC/B,GAAG,EAAE,YAAY,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,MAAM,CAAA;IACzB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAA;IACzC,iBAAiB;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC5B,CAAA;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IACjD,SAAgB,IAAI,EACd,WAAW,GACX,UAAU,GACV,aAAa,GACb,eAAe,GACf,oBAAoB,GACpB,kBAAkB,GAClB,qBAAqB,CAAA;IAC3B,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChC,SAAgB,KAAK,CAAC,EAAE,MAAM,CAAA;gBAElB,IAAI,EAAE;QACd,IAAI,EAAE,0BAA0B,CAAC,MAAM,CAAC,CAAA;QACxC,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,KAAK,CAAC,EAAE,MAAM,CAAA;KACjB;CAOJ;AAED,wBAAgB,GAAG,IAAI,MAAM,CAI5B;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAErD;AA+FD,MAAM,MAAM,YAAY,GAAG;IACvB,OAAO,EAAE,YAAY,CAAA;IACrB,MAAM,EAAE,OAAO,CAAA;IACf,UAAU,CAAC,EAAE,cAAc,CAAA;CAC9B,CAAA;AAYD,MAAM,MAAM,cAAc,GAAG;IACzB,uEAAuE;IACvE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAClC,uDAAuD;IACvD,QAAQ,EAAE,kBAAkB,EAAE,CAAA;IAC9B,mEAAmE;IACnE,MAAM,EAAE,WAAW,CAAA;IACnB,gDAAgD;IAChD,IAAI,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAA;IACrC,gEAAgE;IAChE,UAAU,EAAE,MAAM,MAAM,CAAA;IACxB,2CAA2C;IAC3C,GAAG,EAAE,YAAY,CAAA;IACjB;;;OAGG;IACH,KAAK,EAAE,OAAO,CAAA;IACd;;;;;;;OAOG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,CAAA;CAC9D,CAAA;AAMD,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,cAAc,EACrB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EACxB,YAAY,EAAE,MAAM,GACrB,aAAa,CA4Cf;AAQD,wBAAsB,WAAW,CAC7B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,EACtB,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CAmJf;AASD,wBAAgB,WAAW,CAAC,OAAO,EAC/B,QAAQ,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,EACrC,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,cAAc,GACtB,OAAO,GAAG,IAAI,CAyBhB;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,OAAO,EACjD,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,oBAAoB,GAC3B,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CA0RnC"}