@pipelex/sdk 0.52.0 → 0.53.0

package/dist/error-models.js

@@ -1,203 +0,0 @@
-/**
- * Error-report wire models — a failed run's stored report, and the typed members of a
- * problem document.
- *
- * **The runner owns these shapes; this SDK follows them.** A run that fails reports why as
- * the runner's `ErrorReport` (`pipelex.base_exceptions`), which the hosted platform stores
- * whole on the run row as `error` and serves through the runner's STRICT disclosure: on the
- * status read (`RunRead.error`), on the run records (`PipelineRun.error`,
- * `RunHistoryItem.error`), and inside the problem document of the results read's `409`, where
- * the client lifts it onto the failed arm of
- * `RunResultState` and onto `RunFailedError.error`. The same classification fields
- * (`error_domain`, `user_action`, …) ride a runner-rendered problem document as extension
- * members, which is why `ApiResponseError` types its members with the models declared here.
- *
- * Every field is optional and every interface keeps an index signature, for the reason
- * `TokensUsageRecord` gives: the runner adds fields without asking this SDK, and a field this
- * version does not name still reaches the caller. The enum-ish fields (`error_domain`,
- * `error_category`, `user_action.kind`) are open sets on the wire and stay `string`, never
- * frozen unions, so a value the runner adds is not an SDK break; their known values are listed
- * where they are declared.
- *
- * **A stored report is checked, not cast.** Every read that hands one back runs it through
- * `readRunErrorReport`, which keeps each named field only when it has the type declared here and
- * reads it as absent otherwise, as the Python twin does: a report written by an older runner, or
- * stored by hand, cannot hand a consumer a number where a string is typed. The client checks the
- * nested members of a problem document with the same readers, so `ApiResponseError`'s
- * `providerMetadata`, `migration`, `validationErrors` and `errors` hold to their types as a stored
- * report's do.
- *
- * **The platform serves the STRICT projection; this SDK strips nothing further.** The run row
- * keeps the runner's VERBOSE report as the operators' record, and every read that hands it to a
- * caller serves the rule the hosted runner applies to an error on `execute`: `error_type`,
- * `title`, `type_uri`, `error_domain`, `error_category`, `retryable` and `validation_errors`
- * pass through; `message` and `user_action` pass through only when `caller_facing_message` is
- * `true`, which the served report then keeps, and otherwise `message` is the placeholder
- * `An internal error occurred.` while `user_action` and the flag are absent; `provider_metadata`
- * keeps only `status_code` and `retry_after_seconds`; `model`, `provider` and `migration` are
- * absent. The reports the platform writes itself are caller-facing copy, so they keep their
- * message and their next step. A platform run locally with `ERROR_DISCLOSURE=verbose` serves the
- * report whole, which is why the types still name every member the runner writes. Deciding what
- * a person should see is each consumer's presentation; the report arrives here as served,
- * members this SDK does not name included.
- */
-// ── Checking a stored report, and a problem document's nested members ─
-//
-// The readers below that are exported serve the client's problem-document parser as well; they
-// stay internal, out of the package entry.
-/** The string fields of a report, kept when they are a string (empty included) or `null`. */
-const REPORT_STRING_FIELDS = [
-    "error_type",
-    "message",
-    "title",
-    "type_uri",
-    "error_domain",
-    "error_category",
-    "model",
-    "provider",
-];
-/** The boolean fields of a report, kept when they are a boolean or `null`. */
-const REPORT_BOOLEAN_FIELDS = ["retryable", "caller_facing_message"];
-/** The string fields of `provider_metadata`. */
-const PROVIDER_STRING_FIELDS = [
-    "provider",
-    "sdk_exception_type",
-    "message",
-    "request_id",
-    "provider_error_code",
-];
-/** The fields of `provider_metadata` the hosted store may serve as strings: a number or a string. */
-const PROVIDER_NUMERIC_FIELDS = ["status_code", "retry_after_seconds"];
-/** The string fields of an item of a platform problem document's `errors[]`. */
-const FIELD_ERROR_STRING_FIELDS = ["field", "code", "detail"];
-/** Whether a value is a plain object: an object that is neither `null` nor an array. */
-export function isPlainObject(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/**
- * Drop each of `fields` from `record` when it is present and fails `fits`. `null` always fits,
- * since every field of these shapes allows it. Internal: the run status read's degradation
- * (`readRunDegradation` in `runs.ts`) is checked with it too.
- */
-export function dropUnfit(record, fields, fits) {
-    for (const field of fields) {
-        if (!Object.hasOwn(record, field))
-            continue;
-        const value = record[field];
-        if (value !== null && !fits(value))
-            delete record[field];
-    }
-}
-const isString = (value) => typeof value === "string";
-const isBoolean = (value) => typeof value === "boolean";
-const isNumberOrString = (value) => typeof value === "number" || typeof value === "string";
-/** `user_action` is kept whole or not at all: an object whose `kind` and `detail` are strings. */
-function readUserAction(value) {
-    return typeof value.kind === "string" && typeof value.detail === "string"
-        ? { ...value }
-        : undefined;
-}
-/**
- * `provider_metadata`, its named string fields kept as strings and `status_code` and
- * `retry_after_seconds` as a number or a string; its other members are relayed as sent.
- */
-export function readProviderMetadata(value) {
-    const metadata = { ...value };
-    dropUnfit(metadata, PROVIDER_STRING_FIELDS, isString);
-    dropUnfit(metadata, PROVIDER_NUMERIC_FIELDS, isNumberOrString);
-    return metadata;
-}
-/**
- * `migration`, its `remedy` kept as a string, `would_write` and `needs_attention` as booleans, and
- * `plans` as an array keeping only its objects; its other members are relayed as sent.
- */
-export function readMigration(value) {
-    const migration = { ...value };
-    dropUnfit(migration, ["remedy"], isString);
-    dropUnfit(migration, ["would_write", "needs_attention"], isBoolean);
-    if (Object.hasOwn(migration, "plans") && migration.plans !== null) {
-        if (Array.isArray(migration.plans))
-            migration.plans = migration.plans.filter(isPlainObject);
-        else
-            delete migration.plans;
-    }
-    return migration;
-}
-/**
- * A validation item is kept when it is an object with a string `category` and `message`, its other
- * members relayed as sent. It checks a problem document's items and a stored report's only:
- * `validate()` and the crate routes hand their reports' items back unchecked.
- */
-export function isValidationItem(value) {
-    return isPlainObject(value) && isString(value.category) && isString(value.message);
-}
-/**
- * An item of a platform problem document's `errors[]`, its `field`, `code` and `detail` kept when
- * they are strings and its other members relayed as sent.
- */
-export function readFieldError(value) {
-    const item = { ...value };
-    dropUnfit(item, FIELD_ERROR_STRING_FIELDS, isString);
-    return item;
-}
-/**
- * A failed run's stored report, checked field by field — the one way every read in this SDK
- * hands a report back.
- *
- * - A value that is not a plain object reads as `null`, no report.
- * - Each string field (`error_type`, `message`, `title`, `type_uri`, `error_domain`,
- *   `error_category`, `model`, `provider`) is kept when it is a string, an empty one included, and
- *   is absent otherwise. Deciding that a blank field says nothing is presentation, left to each
- *   consumer.
- * - `retryable` and `caller_facing_message` are kept when they are booleans.
- * - `user_action` is kept whole or not at all: an object whose `kind` and `detail` are both
- *   strings, which is what `UserAction` promises. (The Python twin keeps a partial action, its
- *   stored-report action being a lenient type of its own; this is the one place the two differ.)
- * - `provider_metadata` is kept when it is an object, with each named field checked: the strings
- *   as strings, `status_code` and `retry_after_seconds` as a number or a string, since the hosted
- *   store serves its numbers as strings.
- * - `migration` is kept when it is an object: `remedy` as a string, `would_write` and
- *   `needs_attention` as booleans, and `plans` as an array keeping only its objects.
- * - `validation_errors` is kept when it is an array, keeping each item that is an object with a
- *   string `category` and a string `message`.
- * - `null` is kept wherever the type allows it, which is every named field; and members this SDK
- *   does not name, in the report and in each nested object, are relayed as sent.
- *
- * Internal: every report a consumer meets comes through one of the reads that apply it.
- */
-export function readRunErrorReport(value) {
-    if (!isPlainObject(value))
-        return null;
-    const report = { ...value };
-    dropUnfit(report, REPORT_STRING_FIELDS, isString);
-    dropUnfit(report, REPORT_BOOLEAN_FIELDS, isBoolean);
-    readNested(report, "user_action", readUserAction);
-    readNested(report, "provider_metadata", readProviderMetadata);
-    readNested(report, "migration", readMigration);
-    if (Object.hasOwn(report, "validation_errors") && report.validation_errors !== null) {
-        if (Array.isArray(report.validation_errors)) {
-            report.validation_errors = report.validation_errors.filter(isValidationItem);
-        }
-        else {
-            delete report.validation_errors;
-        }
-    }
-    return report;
-}
-/**
- * Replace the object at `field` with what `read` keeps of it, or drop the field when it is not an
- * object or `read` keeps nothing. `null` is kept.
- */
-function readNested(record, field, read) {
-    if (!Object.hasOwn(record, field))
-        return;
-    const value = record[field];
-    if (value === null)
-        return;
-    const kept = isPlainObject(value) ? read(value) : undefined;
-    if (kept === undefined)
-        delete record[field];
-    else
-        record[field] = kept;
-}
-//# sourceMappingURL=error-models.js.map

package/dist/error-models.js.map

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

package/dist/error-verdicts.d.ts

@@ -1,46 +0,0 @@
-/**
- * The verdict an `ApiResponseError` falls back to when the server sent no usable member.
- *
- * A problem document may carry `retryable` and `error_domain`, and the error reads the members
- * the server sent first (see `ApiResponseError`): the runner sends them on the problems it renders,
- * and the platform on those it renders itself once its deployment classifies them. Where one is
- * missing — a platform route that does not classify its refusals, as its Lambda-backed routes do
- * not yet, a gateway's HTML page, a bare runner's Starlette `{"detail": "Not Found"}` — that member
- * is read off this table instead, so a consumer never has to choose its own default. The one
- * exception is a `retryable` missing beside a sent `input` or `config` domain, which is not
- * retryable whatever the status. The table reads only the HTTP status, the platform's native
- * `code`, and whether the body names what it refused.
- *
- * It is also the platform's reference: the verdicts the platform sends on its own refusals are
- * decided against this table, so a refusal keeps its verdict whether the platform sent it or the
- * table supplied it. The Python twin, `pipelex-sdk`, applies the same table as its `fallback_verdict`.
- * The case file `tests/fixtures/error-verdicts.json` holds every row, and this package's suite
- * drives the table through it; the Python suite drives its own code through the copy that
- * `make shared-files` writes at the repository's root, byte for byte identical.
- */
-import type { Problem } from "mthds/protocol";
-import type { ErrorVerdict } from "./errors.js";
-/**
- * The verdict of a refused request whose problem document carried no usable member.
- *
- * - `status` is the HTTP status of the answer.
- * - `code` is the platform's native code, when the body carried one.
- * - `named` says whether the body names what it refused: a platform `code` or a runner
- *   `error_type`. It decides a `404`: a named one is a resource the caller asked for that does not
- *   exist (`input`), a bare one is a route the deployment does not serve (`config`).
- *
- * Every `4xx` the table does not list is the caller's request refused (`input`, not retryable),
- * every `5xx` it does not list is a fault in the service that may pass (`runtime`, retryable),
- * and any other status is one no refusal carries, such as the `2xx` of an answer the client could
- * not read, so nothing says a retry helps (`runtime`, not retryable).
- */
-export declare function fallbackVerdict(status: number, code: string | undefined, named: boolean): ErrorVerdict;
-/**
- * The verdict of a problem of the MTHDS standard, in this SDK's vocabulary, so that an error of
- * the standard's own client (`mthds`) reads with `errorVerdictOf` as this SDK's errors do. The
- * standard's domain and retry verdict are read by its own fallbacks (`problemDomain`,
- * `problemRetry`): a domain it does not know reads by the code's family, else as `runtime`, and
- * a retry verdict it does not know as `no`. The Python twin, `pipelex-sdk`, applies the same
- * mapping.
- */
-export declare function problemVerdict(problem: Pick<Problem, "code" | "domain" | "retry">): ErrorVerdict;

package/dist/error-verdicts.js

@@ -1,120 +0,0 @@
-/**
- * The verdict an `ApiResponseError` falls back to when the server sent no usable member.
- *
- * A problem document may carry `retryable` and `error_domain`, and the error reads the members
- * the server sent first (see `ApiResponseError`): the runner sends them on the problems it renders,
- * and the platform on those it renders itself once its deployment classifies them. Where one is
- * missing — a platform route that does not classify its refusals, as its Lambda-backed routes do
- * not yet, a gateway's HTML page, a bare runner's Starlette `{"detail": "Not Found"}` — that member
- * is read off this table instead, so a consumer never has to choose its own default. The one
- * exception is a `retryable` missing beside a sent `input` or `config` domain, which is not
- * retryable whatever the status. The table reads only the HTTP status, the platform's native
- * `code`, and whether the body names what it refused.
- *
- * It is also the platform's reference: the verdicts the platform sends on its own refusals are
- * decided against this table, so a refusal keeps its verdict whether the platform sent it or the
- * table supplied it. The Python twin, `pipelex-sdk`, applies the same table as its `fallback_verdict`.
- * The case file `tests/fixtures/error-verdicts.json` holds every row, and this package's suite
- * drives the table through it; the Python suite drives its own code through the copy that
- * `make shared-files` writes at the repository's root, byte for byte identical.
- */
-import { problemDomain, problemRetry } from "mthds/protocol";
-const INPUT = Object.freeze({ errorDomain: "input", retryable: false });
-const CONFIG = Object.freeze({ errorDomain: "config", retryable: false });
-const TRANSIENT = Object.freeze({ errorDomain: "runtime", retryable: true });
-const FAULT = Object.freeze({ errorDomain: "runtime", retryable: false });
-/** The platform code a `409` carries when the organization holds as many API keys as it may. */
-const API_KEY_LIMIT_CODE = "pipelex_api_key_limit_reached";
-/**
- * The platform code a `409` carries when an earlier request under the same `Idempotency-Key` is
- * still being handled: nothing ran for this one, and the same request under the same key is
- * answered with the earlier one's outcome once it is stored.
- */
-const IDEMPOTENCY_KEY_IN_USE_CODE = "idempotency_key_in_use";
-/**
- * The verdict of a refused request whose problem document carried no usable member.
- *
- * - `status` is the HTTP status of the answer.
- * - `code` is the platform's native code, when the body carried one.
- * - `named` says whether the body names what it refused: a platform `code` or a runner
- *   `error_type`. It decides a `404`: a named one is a resource the caller asked for that does not
- *   exist (`input`), a bare one is a route the deployment does not serve (`config`).
- *
- * Every `4xx` the table does not list is the caller's request refused (`input`, not retryable),
- * every `5xx` it does not list is a fault in the service that may pass (`runtime`, retryable),
- * and any other status is one no refusal carries, such as the `2xx` of an answer the client could
- * not read, so nothing says a retry helps (`runtime`, not retryable).
- */
-export function fallbackVerdict(status, code, named) {
-    switch (status) {
-        case 401:
-        case 402:
-        case 403:
-            // The credential, the plan or the access must change.
-            return CONFIG;
-        case 404:
-            return named ? INPUT : CONFIG;
-        case 405:
-            // The deployment does not serve this method on the route.
-            return CONFIG;
-        case 408:
-        case 429:
-            // Refused for its timing, not its content.
-            return TRANSIENT;
-        case 409:
-            // The organization holds as many API keys as it may: someone lifts it by removing a key.
-            if (code === API_KEY_LIMIT_CODE)
-                return CONFIG;
-            // An earlier request still holds the idempotency key, and releases it by finishing.
-            if (code === IDEMPOTENCY_KEY_IN_USE_CODE)
-                return TRANSIENT;
-            // Any other conflict with the stored state is the caller's.
-            return INPUT;
-        case 501:
-            // The deployment does not implement it, and asking again will not change that.
-            return CONFIG;
-    }
-    if (status >= 400 && status < 500)
-        return INPUT;
-    if (status >= 500 && status < 600)
-        return TRANSIENT;
-    return FAULT;
-}
-/**
- * Who can fix a failure the MTHDS standard's problem says must be acted on by its `domain`, in
- * this SDK's vocabulary: the caller changes the request or the method it names (`input`, `method`),
- * someone changes the environment, the credential, the plan or the deployment (`account`,
- * `operator`), or nobody beforehand (`runtime`).
- */
-const ERROR_DOMAIN_OF = Object.freeze({
-    input: "input",
-    method: "input",
-    account: "config",
-    operator: "config",
-    runtime: "runtime",
-});
-/**
- * Whether asking again can succeed, by the standard's `retry`: only `yes` is retryable, since an
- * operation whose outcome is unknown may already have taken effect, and a run that may have
- * started is never retryable.
- */
-const RETRYABLE_OF = Object.freeze({
-    yes: true,
-    no: false,
-    outcome_unknown: false,
-});
-/**
- * The verdict of a problem of the MTHDS standard, in this SDK's vocabulary, so that an error of
- * the standard's own client (`mthds`) reads with `errorVerdictOf` as this SDK's errors do. The
- * standard's domain and retry verdict are read by its own fallbacks (`problemDomain`,
- * `problemRetry`): a domain it does not know reads by the code's family, else as `runtime`, and
- * a retry verdict it does not know as `no`. The Python twin, `pipelex-sdk`, applies the same
- * mapping.
- */
-export function problemVerdict(problem) {
-    return {
-        errorDomain: ERROR_DOMAIN_OF[problemDomain(problem)],
-        retryable: RETRYABLE_OF[problemRetry(problem)],
-    };
-}
-//# sourceMappingURL=error-verdicts.js.map

package/dist/error-verdicts.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-verdicts.js","sourceRoot":"","sources":["../src/error-verdicts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAK7D,MAAM,KAAK,GAAiB,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;AACtF,MAAM,MAAM,GAAiB,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;AACxF,MAAM,SAAS,GAAiB,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3F,MAAM,KAAK,GAAiB,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;AAExF,gGAAgG;AAChG,MAAM,kBAAkB,GAAG,+BAA+B,CAAC;AAE3D;;;;GAIG;AACH,MAAM,2BAA2B,GAAG,wBAAwB,CAAC;AAE7D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,IAAwB,EACxB,KAAc;IAEd,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,GAAG,CAAC;QACT,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACN,sDAAsD;YACtD,OAAO,MAAM,CAAC;QAChB,KAAK,GAAG;YACN,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAChC,KAAK,GAAG;YACN,0DAA0D;YAC1D,OAAO,MAAM,CAAC;QAChB,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACN,2CAA2C;YAC3C,OAAO,SAAS,CAAC;QACnB,KAAK,GAAG;YACN,yFAAyF;YACzF,IAAI,IAAI,KAAK,kBAAkB;gBAAE,OAAO,MAAM,CAAC;YAC/C,oFAAoF;YACpF,IAAI,IAAI,KAAK,2BAA2B;gBAAE,OAAO,SAAS,CAAC;YAC3D,4DAA4D;YAC5D,OAAO,KAAK,CAAC;QACf,KAAK,GAAG;YACN,+EAA+E;YAC/E,OAAO,MAAM,CAAC;IAClB,CAAC;IACD,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,SAAS,CAAC;IACpD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,eAAe,GAAiD,MAAM,CAAC,MAAM,CAAC;IAClF,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,SAAS;CACnB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,YAAY,GAA4C,MAAM,CAAC,MAAM,CAAC;IAC1E,GAAG,EAAE,IAAI;IACT,EAAE,EAAE,KAAK;IACT,eAAe,EAAE,KAAK;CACvB,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,OAAmD;IAChF,OAAO;QACL,WAAW,EAAE,eAAe,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACpD,SAAS,EAAE,YAAY,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;KAC/C,CAAC;AACJ,CAAC"}

package/dist/run-may-have-started.d.ts

@@ -1,31 +0,0 @@
-/**
- * Whether a failed request that may create a run, a start or a blocking execute, may still have
- * started one whose id never reached the caller. `ApiUnreachableError` and `ApiResponseError` read
- * it when the client tells them their request may create a run, and carry the answer as
- * `runMayHaveStarted`; the Python twin, `pipelex-sdk`, reads the same failures the same way in
- * `pipelex_sdk.run_may_have_started`.
- *
- * The reading errs on the safe side. A false "may have started" costs the person a look at the run
- * history; a false "did not start" costs a second paid run. So every failure counts as one that
- * may have started a run unless it proves otherwise: a transport failure that proves nothing was
- * sent, and an answer that says the request was refused before anything ran.
- */
-/**
- * Whether an answer to a request that may create a run leaves one possibly started:
- *
- * - any `2xx`, which the client met only because it could not read it: the server accepted the
- *   request, and only its acknowledgement was lost;
- * - a `408`, which a proxy in front of the platform may answer for a request it forwarded;
- * - every `5xx` but a `501`, which says the deployment does not serve the route, and a `503`
- *   carrying the platform's code `pipeline_start_unavailable`, which says the runner was never
- *   reached: the server or a gateway failed while handling the request.
- *
- * Any other status is the request refused before anything ran.
- */
-export declare function answerMayHaveStartedRun(status: number, code: string | undefined): boolean;
-/**
- * Whether a transport failure of a request that may create a run leaves one possibly started:
- * every failure but one that proves nothing was sent. `cause` is the failure fetch threw, which
- * `ApiUnreachableError` keeps as its own `cause`.
- */
-export declare function transportMayHaveStartedRun(cause: unknown): boolean;

package/dist/run-may-have-started.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"run-may-have-started.js","sourceRoot":"","sources":["../src/run-may-have-started.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;GAIG;AACH,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AAE5D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAc,EAAE,IAAwB;IAC9E,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IACjC,IAAI,MAAM,KAAK,GAAG,IAAI,IAAI,KAAK,sBAAsB;QAAE,OAAO,KAAK,CAAC;IACpE,OAAO,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAc;IACvD,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAS,iBAAiB,CAAC,YAAqB;IAC9C,sEAAsE;IACtE,OAAO,YAAY,YAAY,KAAK,IAAI,wBAAwB,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;AACvF,CAAC;AAED,SAAS,wBAAwB,CAAC,OAAgB;IAChD,IAAI,OAAO,YAAY,cAAc,EAAE,CAAC;QACtC,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAClE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAgD,CAAC;IAC3E,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9E,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC5E,CAAC;AAED,6EAA6E;AAC7E,MAAM,sBAAsB,GAAwB,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC;AAExF;;;;;GAKG;AACH,MAAM,sBAAsB,GAAwB,IAAI,GAAG,CAAC;IAC1D,cAAc;IACd,WAAW;IACX,WAAW;IACX,yBAAyB;IACzB,+BAA+B;IAC/B,8BAA8B;IAC9B,6BAA6B;IAC7B,mGAAmG;IACnG,+FAA+F;IAC/F,4FAA4F;IAC5F,8FAA8F;IAC9F,0EAA0E;IAC1E,+CAA+C;IAC/C,2BAA2B;IAC3B,mBAAmB;IACnB,kCAAkC;IAClC,iCAAiC;IACjC,oCAAoC;IACpC,wBAAwB;IACxB,uBAAuB;IACvB,oBAAoB;IACpB,kBAAkB;IAClB,mBAAmB;IACnB,iBAAiB;IACjB,gCAAgC;IAChC,+BAA+B;IAC/B,gCAAgC;IAChC,gCAAgC;IAChC,YAAY;IACZ,6BAA6B;IAC7B,2BAA2B;IAC3B,mCAAmC;IACnC,iCAAiC;IACjC,qBAAqB;IACrB,cAAc;IACd,YAAY;IACZ,sBAAsB;IACtB,iBAAiB;IACjB,gBAAgB;IAChB,eAAe;IACf,mBAAmB;IACnB,aAAa;CACd,CAAC,CAAC"}