@proposit/proposit-core 2.4.0 → 2.4.1

package/dist/lib/pipelines/single-stage.js

@@ -0,0 +1,333 @@
+// Single-stage / single-finalize entry points, plus the launch/complete
+// split for LLM-background stages.
+//
+// A durable orchestrator (e.g. a server running each stage in its own
+// serverless invocation, persisting typed outputs to a database between
+// stages) needs to run ONE stage — or the finalize — given the upstream
+// stages' persisted outputs AND outcomes, without re-running the whole
+// DAG. `executeStage` and `executeFinalize` are the thin, stateless
+// (state in, state out) entry points for that: they reuse the same
+// `runOneStage` / `runFinalize` bodies the whole-DAG scheduler
+// (`scheduler.ts`) uses.
+import { Value } from "typebox/value";
+import { depId } from "./types.js";
+import { readLlmStageConfig, buildLlmRequest, applyRetrySuffix, validateLlmOutcome, failureRetryReason, } from "./stage-helpers.js";
+import { PipelineConfigurationError, makeStageContext, runOneStage, runFinalize, now, noopEmit, defaultGenerateId, } from "./scheduler.js";
+// Seed a fresh `records` map from the caller-supplied `upstream`,
+// keeping only the entries the consumer (a stage or finalize) actually
+// depends on, and dropping `output` for any non-`completed` record so a
+// caller bug can't leak a stale output into a skipped/failed dependency.
+function seedRecordsFromUpstream(upstream, depIds) {
+    const records = new Map();
+    for (const id of depIds) {
+        const supplied = upstream[id];
+        if (!supplied)
+            continue;
+        if (supplied.outcome === "completed") {
+            records.set(id, {
+                outcome: "completed",
+                output: supplied.output,
+            });
+        }
+        else {
+            records.set(id, {
+                outcome: supplied.outcome,
+                output: undefined,
+            });
+        }
+    }
+    return records;
+}
+// Shared run-state builder for the single-shot entry points. The
+// `setConfigError` disposition differs from the whole-DAG scheduler's:
+// a `ctx.get`-on-non-dep error throws straight out of the entry point
+// (there are no run-level bookends to emit first), so it is surfaced
+// directly to the caller as the caller bug it is.
+function buildSingleShotState(upstream, depIds, input, deps) {
+    return {
+        records: seedRecordsFromUpstream(upstream, depIds),
+        failures: [],
+        signal: deps.signal ?? new AbortController().signal,
+        emit: deps.onEvent ?? noopEmit,
+        generateId: deps.generateId ?? defaultGenerateId,
+        llm: deps.llm,
+        input,
+        setConfigError: (error) => {
+            throw error;
+        },
+    };
+}
+/**
+ * Run a single stage of `pipeline` against the caller-supplied upstream
+ * records, without re-running the whole DAG. The upstream map carries
+ * each dependency's `{ outcome, output? }` so `ctx.get` / `ctx.stageStatus`
+ * reproduce monolithic-run semantics exactly. `input` is validated +
+ * transformed via `Value.Parse(pipeline.inputSchema, input)` (a schema
+ * mismatch throws, same as `executePipeline`) and the PARSED value seeds
+ * `ctx.input`.
+ *
+ * Emits the per-stage events only (`stage:start`, `stage:llm-request`,
+ * `stage:llm-response-created`, `stage:llm-call`, `stage:retry`,
+ * `stage:end`) — no `pipeline:*` bookends. Throws `PipelineConfigurationError`
+ * (`UNKNOWN_STAGE`) when `stageId` is not in `pipeline.stages`, and throws a
+ * `PipelineConfigurationError` (`GET_OUTSIDE_DEPS` / `STATUS_OUTSIDE_DEPS`)
+ * out directly when the stage reads a non-dependency — both are caller
+ * bugs, surfaced rather than swallowed into the result.
+ *
+ * The caller may pass a superset of `upstream` records; `executeStage`
+ * uses the stage's own `dependsOn` to pick the relevant ones. It does NOT
+ * decide whether the stage SHOULD run given its upstream outcomes — a
+ * required-failed upstream just means `ctx.get` returns `undefined`; the
+ * skip decision belongs to the caller's scheduler.
+ */
+export async function executeStage(pipeline, stageId, upstream, input, deps) {
+    const stage = pipeline.stages.find((s) => s.id === stageId);
+    if (!stage) {
+        throw new PipelineConfigurationError({
+            code: "UNKNOWN_STAGE",
+            message: `Pipeline "${pipeline.id}" has no stage "${stageId}".`,
+            stageId,
+        });
+    }
+    // Input-validation parity with `executePipeline`: parse + seed the
+    // PARSED (Default/Convert/Clean-transformed) value into ctx.input.
+    const parsedInput = Value.Parse(pipeline.inputSchema, input);
+    const depIds = new Set(stage.dependsOn.map((d) => depId(d)));
+    const state = buildSingleShotState(upstream, depIds, parsedInput, deps);
+    const ctx = makeStageContext(state, depIds, stage.id);
+    await runOneStage(stage, ctx, state);
+    const record = state.records.get(stage.id);
+    const outcome = record?.outcome ?? "skipped";
+    const result = {
+        outcome,
+        failures: state.failures,
+    };
+    if (outcome === "completed") {
+        result.output = record?.output;
+        if (record?.tokenUsage !== undefined) {
+            result.tokenUsage = record.tokenUsage;
+        }
+    }
+    return result;
+}
+/**
+ * Run `pipeline.finalize` against the caller-supplied upstream records,
+ * without re-running the whole DAG. Symmetric with `executeStage`:
+ * `input` is parsed via `Value.Parse(pipeline.inputSchema, input)` and the
+ * PARSED value seeds the finalize `ctx.input`; the finalize `ctx` is built
+ * with `pipeline.finalize.dependsOn` as its allowed-dep set; the
+ * required-finalize-dep gate (`output` stays `null` if any required dep is
+ * not `completed`) and the `FINALIZE_UNCAUGHT_ERROR` capture match
+ * `executePipeline`.
+ *
+ * Emits NO events (finalize is not a stage — it has no `stage:*`
+ * lifecycle — and there are no `pipeline:*` bookends). `async` purely for
+ * signature symmetry with `executeStage`; `TPipelineFinalize.run` stays
+ * synchronous and the `async` wrapper just resolves its result.
+ */
+// `async` is deliberate (a Promise-returning signature symmetric with
+// `executeStage`, so callers `await` both uniformly) even though the
+// synchronous finalize body has nothing to await — the eslint
+// require-await rule does not apply here.
+// eslint-disable-next-line @typescript-eslint/require-await
+export async function executeFinalize(pipeline, upstream, input, deps) {
+    // Input-validation parity with `executePipeline` (see `executeStage`).
+    const parsedInput = Value.Parse(pipeline.inputSchema, input);
+    const depIds = new Set(pipeline.finalize.dependsOn.map((d) => depId(d)));
+    // Finalize emits no events, so swallow any caller-supplied onEvent.
+    const state = buildSingleShotState(upstream, depIds, parsedInput, {
+        ...deps,
+        onEvent: undefined,
+    });
+    const ctx = makeStageContext(state, depIds, "finalize");
+    const output = runFinalize(pipeline, ctx, state);
+    return { output, failures: state.failures };
+}
+// -- Launch / complete split for LLM-background stages -------------------
+//
+// A durable orchestrator (e.g. a server workflow) cannot block a single
+// step for an LLM call's full duration. `launchStage` submits the
+// background response and returns its `responseId` WITHOUT awaiting;
+// `completeStage` — in a later invocation, after the response completed —
+// validates the retrieved response into a `TExecuteStageResult`. Both
+// reuse the package-internal `llmStage` seam (`buildLlmRequest` /
+// `validateLlmOutcome`) so prompt assembly + output validation have a
+// single implementation shared with the in-process `llmStage` loop.
+// Resolve the LLM config carried by an `llmStage`-built stage, or throw a
+// clear error when the looked-up stage is not an LLM stage (no carrier).
+function requireLlmStage(pipeline, stageId, fnName) {
+    const stage = pipeline.stages.find((s) => s.id === stageId);
+    if (!stage) {
+        throw new PipelineConfigurationError({
+            code: "UNKNOWN_STAGE",
+            message: `Pipeline "${pipeline.id}" has no stage "${stageId}".`,
+            stageId,
+        });
+    }
+    const cfg = readLlmStageConfig(stage);
+    if (!cfg) {
+        throw new PipelineConfigurationError({
+            code: "UNKNOWN_STAGE",
+            message: `${fnName} requires an LLM stage, but stage "${stageId}" in pipeline "${pipeline.id}" is not one (it carries no LLM config). Run deterministic stages via executeStage.`,
+            stageId,
+        });
+    }
+    return { stage, cfg };
+}
+/**
+ * Launch an LLM-background stage: rehydrate `ctx` from `upstream` +
+ * parsed input, build the request via the shared seam, submit it via the
+ * injected `deps.submitBackgroundResponse`, and return
+ * `{ responseId, status }` WITHOUT awaiting completion.
+ *
+ * Emits `stage:start`, `stage:llm-request`, and `stage:llm-response-created`
+ * (from the submit's returned id) — but NO `stage:llm-call` / `stage:end`
+ * (the completion side emits those, in a later invocation). The
+ * per-stage event pair therefore spans two invocations; an `onEvent`
+ * consumer must NOT assume a balanced start↔end per call.
+ *
+ * `deps.submitBackgroundResponse` is REQUIRED; `launchStage` throws if it
+ * is absent. `stageId` must name an LLM stage (built by `llmStage`);
+ * a non-LLM stage throws. `attempt` (default 1) lets a re-launch rebuild
+ * the retry-suffixed user message for attempt 2+.
+ */
+export async function launchStage(pipeline, stageId, upstream, input, deps, attempt = 1) {
+    const submit = deps.submitBackgroundResponse;
+    if (!submit) {
+        throw new PipelineConfigurationError({
+            code: "UNKNOWN_STAGE",
+            message: `launchStage requires deps.submitBackgroundResponse (the submit-only background-response capability), but it was not supplied.`,
+            stageId,
+        });
+    }
+    const { stage, cfg } = requireLlmStage(pipeline, stageId, "launchStage");
+    // Input-validation parity: parse + seed the parsed ctx.input. The
+    // stage's `ctx` reads its own dependsOn as allowed deps.
+    const parsedInput = Value.Parse(pipeline.inputSchema, input);
+    const allowedDeps = new Set(stage.dependsOn.map((d) => depId(d)));
+    const state = buildSingleShotState(upstream, allowedDeps, parsedInput, deps);
+    const ctx = makeStageContext(state, allowedDeps, stageId);
+    // Compute the per-attempt user message. Attempt 1 is the prompt's
+    // user message; attempt 2+ appends the same retry-suffix the
+    // in-process loop adds after a schema-validation failure (the shared
+    // `applyRetrySuffix` helper). The exact prior-attempt validation
+    // error does not cross the durable suspend, so the re-launch suffix
+    // carries a generic prior-error note — the wrapper text matches the
+    // in-process loop's phrasing.
+    const baseUser = cfg.buildPrompt(ctx).user;
+    const userMessage = attempt > 1
+        ? applyRetrySuffix(baseUser, "the previous attempt's output did not conform to the schema", cfg.retryPolicy.maxAppendedErrorBytes ?? 2048)
+        : baseUser;
+    const { req } = buildLlmRequest(cfg, ctx, userMessage);
+    state.emit({ kind: "stage:start", stageId, at: now() });
+    state.emit({
+        kind: "stage:llm-request",
+        stageId,
+        attempt,
+        prompts: { system: req.systemPrompt, user: req.userMessage },
+        at: now(),
+    });
+    // The req is already TLlmRequest<unknown> (the recovered config is
+    // generic-erased at the lookup boundary); the typed output is
+    // recovered in completeStage via the stage's outputSchema.
+    const submitResult = await submit(req, {
+        apiKey: resolveApiKey(deps),
+        signal: deps.signal,
+    });
+    state.emit({
+        kind: "stage:llm-response-created",
+        stageId,
+        attempt,
+        responseId: submitResult.responseId,
+        at: now(),
+    });
+    return submitResult;
+}
+/**
+ * Complete an LLM-background stage from its retrieved response. Recovers
+ * the stage's LLM config, parses the RAW assistant text in
+ * `retrieved.output` against the stage's schema (via the shared seam),
+ * classifies a non-`completed` status per the launch/complete table, and
+ * returns the standard `TExecuteStageResult`.
+ *
+ * Emits `stage:llm-call` + `stage:end` (NO `stage:start` — that fired in
+ * the launch invocation). `tokenUsage` is taken directly from
+ * `retrieved.tokenUsage` (the per-`ctx` WeakMap cannot bridge the two
+ * invocations). On a RETRYABLE failure the result carries `retryReason`
+ * (the reason code); a fail-fast failure (`failed` envelope,
+ * `content_filter`) carries none; a `cancelled` response settles as
+ * `outcome: "skipped"` with no `ProcessingFailure`.
+ *
+ * `stageId` must name an LLM stage; a non-LLM stage throws.
+ */
+// eslint-disable-next-line @typescript-eslint/require-await
+export async function completeStage(pipeline, stageId, retrieved, deps, attempt = 1) {
+    const { cfg } = requireLlmStage(pipeline, stageId, "completeStage");
+    const emit = deps.onEvent ?? noopEmit;
+    const validated = validateLlmOutcome(cfg, retrieved.output, retrieved.status, retrieved.incompleteReason);
+    // The output shown on stage:llm-call is the parsed value when the
+    // response parsed + validated; otherwise the raw assistant text (so a
+    // consumer's bridge can persist whatever the model returned).
+    const callOutput = validated.output !== undefined ? validated.output : retrieved.output;
+    emit({
+        kind: "stage:llm-call",
+        stageId,
+        attempt,
+        prompts: { system: "", user: "" },
+        output: callOutput,
+        tokenUsage: retrieved.tokenUsage ?? { input: 0, output: 0 },
+        rawResponseId: retrieved.rawResponseId,
+        validationError: validated.validationError,
+        at: now(),
+    });
+    const failures = [];
+    let retryReason;
+    if (validated.outcome === "failed" && validated.failure) {
+        // A cancelled response settled as `skipped` above (no failure);
+        // only genuine failures push a ProcessingFailure.
+        failures.push({
+            stage: stageId,
+            code: validated.failure.code,
+            message: validated.failure.message,
+            severity: "error",
+        });
+        retryReason = failureRetryReason(validated.failure);
+    }
+    const stageEndEvent = retrieved.tokenUsage !== undefined
+        ? {
+            kind: "stage:end",
+            stageId,
+            status: validated.outcome,
+            tokenUsage: retrieved.tokenUsage,
+            at: now(),
+        }
+        : {
+            kind: "stage:end",
+            stageId,
+            status: validated.outcome,
+            at: now(),
+        };
+    emit(stageEndEvent);
+    const result = {
+        outcome: validated.outcome,
+        failures,
+    };
+    if (validated.outcome === "completed") {
+        result.output = validated.output;
+    }
+    if (retrieved.tokenUsage !== undefined) {
+        result.tokenUsage = retrieved.tokenUsage;
+    }
+    if (retryReason !== undefined) {
+        result.retryReason = retryReason;
+    }
+    return result;
+}
+// API-key resolution for the submit dep. The injected
+// `submitBackgroundResponse` is apiKey-bound by the consumer, so core
+// passes an empty key — the bound capability ignores it. (Kept as a seam
+// in case a future dep shape threads the key through deps.)
+function resolveApiKey(_deps) {
+    return "";
+}
+//# sourceMappingURL=single-stage.js.map

package/dist/lib/pipelines/single-stage.js.map

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

package/dist/lib/pipelines/stage-helpers.d.ts

@@ -1,6 +1,7 @@
 import type { TSchema } from "typebox";
 import type { TDepSpec, TPipeline, TStage, TStageContext } from "./types.js";
-import type { TLlmRequest, TReasoningEffort, TResponseStatus, TToolSpec } from "../llm/types.js";
+export { readLlmStageConfig, isLlmStage, applyRetrySuffix, buildLlmRequest, validateLlmOutcome, failureRetryReason, llmStage, LlmStageRetryExhaustedError, } from "./llm-stage-helpers.js";
+export type { TLlmStageConfig } from "./llm-stage-helpers.js";
 export declare function deterministicStage<TOutput>(config: {
     id: string;
     dependsOn: readonly TDepSpec[];
@@ -32,6 +33,8 @@ export declare class StageAbortedError extends Error {
         message?: string;
     });
 }
+export declare function stashTokenUsage(ctx: TStageContext, stageId: string, usage: import("../llm/types.js").TLlmTokenUsage): void;
+export declare function readStashedTokenUsage(ctx: TStageContext, stageId: string): import("../llm/types.js").TLlmTokenUsage | undefined;
 /**
  * Thrown by `subPipelineStage`'s wrapper when the nested pipeline
  * returns `output: null` (any required dep of its finalize was
@@ -52,128 +55,6 @@ export declare class SubPipelineFailedError extends Error {
         context?: Record<string, unknown>;
     });
 }
-/**
- * Thrown internally by `llmStage` after retry exhaustion. The
- * executor catches it and converts it into a `ProcessingFailure`.
- */
-export declare class LlmStageRetryExhaustedError extends Error {
-    readonly reason: TRetryReason;
-    readonly code: string;
-    readonly attempts: number;
-    readonly stageId: string;
-    readonly failureContext: Record<string, unknown> | undefined;
-    constructor(args: {
-        stageId: string;
-        reason: TRetryReason;
-        code: string;
-        attempts: number;
-        message: string;
-        context?: Record<string, unknown>;
-    });
-}
-/**
- * The resolved `llmStage` config the seam functions operate on (defaults
- * merged into `retryPolicy`). Package-internal — not exported.
- */
-export type TLlmStageConfig<TOutput> = {
-    id: string;
-    outputSchema: TSchema;
-    model: string;
-    reasoningEffort?: TReasoningEffort;
-    buildPrompt: (ctx: TStageContext) => {
-        system: string;
-        user: string;
-    };
-    tools?: readonly TToolSpec[];
-    maxOutputTokens?: number;
-    /** The resolved retry policy (factory defaults already merged). */
-    retryPolicy: TRetryPolicy;
-    /**
-     * Phantom field carrying the stage's structured-output type `TOutput`
-     * through the seam (so `buildLlmRequest` / `validateLlmOutcome` recover
-     * it). Always `undefined` at runtime.
-     */
-    _outputTypeMarker?: TOutput;
-};
-/**
- * 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 declare function readLlmStageConfig<TOutput>(stage: TStage<TOutput>): TLlmStageConfig<TOutput> | undefined;
-/**
- * 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 declare function isLlmStage<TOutput>(stage: TStage<TOutput>): boolean;
-/**
- * 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 declare function applyRetrySuffix(baseUser: string, validationError: string, errorCap: number): string;
-/**
- * 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 declare function buildLlmRequest<TOutput>(cfg: TLlmStageConfig<TOutput>, ctx: TStageContext, userMessage?: string): {
-    req: TLlmRequest<TOutput>;
-    prompts: {
-        system: string;
-        user: string;
-    };
-};
-/**
- * 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 declare function validateLlmOutcome<TOutput>(cfg: TLlmStageConfig<TOutput>, rawText: string | undefined, status: TResponseStatus, incompleteReason: string | undefined): {
-    outcome: "completed" | "failed" | "skipped";
-    output?: TOutput;
-    failure?: {
-        reason: TRetryReason;
-        code: string;
-        message: string;
-    };
-    validationError?: string;
-};
-export declare function failureRetryReason(failure: {
-    reason: TRetryReason;
-    code: string;
-}): TRetryReason | undefined;
-export declare function llmStage<TOutput>(config: {
-    id: string;
-    dependsOn: readonly TDepSpec[];
-    outputSchema: TSchema;
-    model: string;
-    reasoningEffort?: TReasoningEffort;
-    buildPrompt: (ctx: TStageContext) => {
-        system: string;
-        user: string;
-    };
-    tools?: readonly TToolSpec[];
-    retry?: Partial<TRetryPolicy>;
-    maxOutputTokens?: number;
-}): TStage<TOutput>;
-export declare function readStashedTokenUsage(ctx: TStageContext, stageId: string): import("../llm/types.js").TLlmTokenUsage | undefined;
 export declare function subPipelineStage<TOutput>(config: {
     id: string;
     dependsOn: readonly TDepSpec[];

package/dist/lib/pipelines/stage-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stage-helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/pipelines/stage-helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stage-helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/pipelines/stage-helpers.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EACR,QAAQ,EACR,SAAS,EAET,MAAM,EACN,aAAa,EAChB,MAAM,YAAY,CAAA;AAGnB,OAAO,EACH,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,QAAQ,EACR,2BAA2B,GAC9B,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAI7D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE;IAChD,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAA;IAC9B,YAAY,EAAE,OAAO,CAAA;IACrB,EAAE,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;CACzD,GAAG,MAAM,CAAC,OAAO,CAAC,CAOlB;AAID,MAAM,MAAM,YAAY,GAClB,mBAAmB,GACnB,WAAW,GACX,YAAY,GACZ,iBAAiB,CAAA;AAEvB,MAAM,MAAM,YAAY,GAAG;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,SAAS,YAAY,EAAE,CAAA;IAChC,iEAAiE;IACjE,qBAAqB,CAAC,EAAE,MAAM,CAAA;CACjC,CAAA;AAED,eAAO,MAAM,oBAAoB,EAAE,YAKlC,CAAA;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IACxC,SAAgB,OAAO,EAAE,MAAM,CAAA;gBAEnB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;CAK1D;AAkBD,wBAAgB,eAAe,CAC3B,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,iBAAiB,EAAE,cAAc,GAChD,IAAI,CAON;AAED,wBAAgB,qBAAqB,CACjC,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,MAAM,GAChB,OAAO,iBAAiB,EAAE,cAAc,GAAG,SAAS,CAEtD;AAED;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC7C,SAAgB,OAAO,EAAE,MAAM,CAAA;IAC/B,SAAgB,IAAI,EAAE,MAAM,CAAA;IAC5B,SAAgB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;gBAEvD,IAAI,EAAE;QACd,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACpC;CAOJ;AAID,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE;IAC9C,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAA;IAC9B,QAAQ,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;CACxC,GAAG,MAAM,CAAC,OAAO,CAAC,CA0ClB"}