@murphai/hosted-execution 0.1.1

package/dist/observability.js

@@ -0,0 +1,212 @@
+export const HOSTED_EXECUTION_RUN_PHASES = [
+    "claimed",
+    "dispatch.running",
+    "container.starting",
+    "container.ready",
+    "runtime.starting",
+    "commit.recorded",
+    "side-effects.draining",
+    "finalize.recorded",
+    "completed",
+    "retry.scheduled",
+    "failed",
+    "poisoned",
+];
+export const HOSTED_EXECUTION_RUN_LEVELS = ["info", "warn", "error"];
+const HOSTED_EXECUTION_SAFE_ERROR_NAMES = new Set([
+    "AbortError",
+    "Error",
+    "EvalError",
+    "HostedExecutionConfigurationError",
+    "RangeError",
+    "ReferenceError",
+    "SyntaxError",
+    "TypeError",
+    "URIError",
+]);
+const HOSTED_EXECUTION_MAX_OPERATOR_MESSAGE_LENGTH = 200;
+const HOSTED_EXECUTION_SAFE_CONFIGURATION_MESSAGE_PATTERNS = [
+    /^(?:[A-Z][A-Z0-9_]{1,127}|CF_[A-Z0-9_]{1,127}|HOSTED_[A-Z0-9_]{1,127}|DEVICE_SYNC_[A-Z0-9_]{1,127})\s+(?:must be|is)\s+configured(?:\s+for [A-Za-z0-9 ._/-]+)?\.?$/u,
+    /^Native hosted execution requires a RunnerContainer binding\.$/u,
+];
+export function isHostedExecutionRunPhase(value) {
+    return typeof value === "string" && HOSTED_EXECUTION_RUN_PHASES.includes(value);
+}
+export function isHostedExecutionRunLevel(value) {
+    return typeof value === "string" && HOSTED_EXECUTION_RUN_LEVELS.includes(value);
+}
+export function normalizeHostedExecutionErrorMessage(error) {
+    if (error instanceof Error) {
+        const message = error.message.trim();
+        return message.length > 0 ? message : error.name;
+    }
+    const message = String(error).trim();
+    return message.length > 0 ? message : "Unknown hosted execution error.";
+}
+export function normalizeHostedExecutionOperatorMessage(message) {
+    const normalized = redactHostedExecutionText(message)
+        .replace(/[\r\n\t]+/gu, " ")
+        .replace(/\s+/gu, " ")
+        .trim();
+    if (normalized.length === 0) {
+        return "Hosted execution event.";
+    }
+    if (normalized.length <= HOSTED_EXECUTION_MAX_OPERATOR_MESSAGE_LENGTH) {
+        return normalized;
+    }
+    return `${normalized.slice(0, HOSTED_EXECUTION_MAX_OPERATOR_MESSAGE_LENGTH - 1).trimEnd()}…`;
+}
+export function deriveHostedExecutionErrorCode(error) {
+    const name = error instanceof Error ? error.name : "";
+    const message = normalizeHostedExecutionErrorMessage(error).toLowerCase();
+    if (name === "HostedExecutionConfigurationError"
+        || message.includes("not configured")
+        || message.includes("configuration")
+        || message.includes("missing token")
+        || message.includes("requires a runnercontainer binding")
+        || message.includes("must be configured")) {
+        return "configuration_error";
+    }
+    if (message.includes("durable commit")) {
+        return "durable_commit_error";
+    }
+    if (message.includes("durable finalize") || message.includes("finalize")) {
+        return "durable_finalize_error";
+    }
+    if (message.includes("returned http")) {
+        return "runner_http_error";
+    }
+    if (message.includes("authorization") || message.includes("unauthorized") || message.includes("forbidden")) {
+        return "authorization_error";
+    }
+    if (message.includes("invalid json")
+        || message.includes("invalid request")
+        || message.includes("request body must be a json object")
+        || message.includes("must be a json object")
+        || message.includes("malformed")) {
+        return "invalid_request";
+    }
+    if (name === "AbortError"
+        || message.includes("abort")
+        || message.includes("timed out")
+        || message.includes("timeout")) {
+        return "timeout";
+    }
+    switch (name) {
+        case "RangeError":
+            return "range_error";
+        case "ReferenceError":
+            return "reference_error";
+        case "SyntaxError":
+            return "syntax_error";
+        case "TypeError":
+            return "type_error";
+        case "URIError":
+            return "uri_error";
+        default:
+            return "runtime_error";
+    }
+}
+export function summarizeHostedExecutionError(error) {
+    const message = normalizeHostedExecutionErrorMessage(error);
+    switch (deriveHostedExecutionErrorCode(error)) {
+        case "configuration_error":
+            return readHostedExecutionSafeConfigurationMessage(message)
+                ?? "Hosted execution configuration is invalid.";
+        case "durable_commit_error":
+            return "Hosted execution failed before recording a durable commit.";
+        case "durable_finalize_error":
+            return "Hosted execution failed while finalizing a committed run.";
+        case "runner_http_error": {
+            const status = extractHostedExecutionHttpStatus(message);
+            return status
+                ? `Hosted runner container returned HTTP ${status}.`
+                : "Hosted runner container returned an HTTP error.";
+        }
+        case "authorization_error":
+            return "Hosted execution authorization failed.";
+        case "invalid_request":
+            return "Hosted execution rejected an invalid request.";
+        case "timeout":
+            return "Hosted execution timed out.";
+        default:
+            return "Hosted execution runtime failed.";
+    }
+}
+export function buildHostedExecutionStructuredLogRecord(input) {
+    const error = input.error;
+    const errorName = readHostedExecutionSafeErrorName(error);
+    return {
+        attempt: input.run?.attempt ?? null,
+        component: input.component,
+        ...(error === undefined ? {} : {
+            errorCode: deriveHostedExecutionErrorCode(error),
+            errorMessage: summarizeHostedExecutionError(error),
+            ...(errorName ? { errorName } : {}),
+        }),
+        eventId: input.dispatch?.eventId ?? input.eventId ?? null,
+        level: input.level ?? (error === undefined ? "info" : "error"),
+        message: normalizeHostedExecutionOperatorMessage(input.message),
+        phase: input.phase,
+        runId: input.run?.runId ?? null,
+        schema: "murph.hosted-execution.log.v1",
+        time: input.time ?? new Date().toISOString(),
+        userId: input.userId ?? null,
+    };
+}
+function shouldEmitHostedExecutionStructuredLogToStdIo(env = process.env) {
+    const override = env.MURPH_HOSTED_EXECUTION_STDIO_LOGS?.trim().toLowerCase();
+    if (override === "1" || override === "true" || override === "yes" || override === "on") {
+        return true;
+    }
+    if (override === "0" || override === "false" || override === "no" || override === "off") {
+        return false;
+    }
+    return env.VITEST !== "true";
+}
+export function emitHostedExecutionStructuredLog(input) {
+    const record = buildHostedExecutionStructuredLogRecord(input);
+    if (!shouldEmitHostedExecutionStructuredLogToStdIo()) {
+        return record;
+    }
+    const payload = JSON.stringify(record);
+    switch (record.level) {
+        case "error":
+            console.error(payload);
+            break;
+        case "warn":
+            console.warn(payload);
+            break;
+        default:
+            console.info(payload);
+            break;
+    }
+    return record;
+}
+function readHostedExecutionSafeErrorName(error) {
+    if (!(error instanceof Error)) {
+        return null;
+    }
+    const name = error.name.trim();
+    return HOSTED_EXECUTION_SAFE_ERROR_NAMES.has(name) ? name : null;
+}
+function extractHostedExecutionHttpStatus(message) {
+    const match = /\bhttp\s+(\d{3})\b/iu.exec(message);
+    return match?.[1] ?? null;
+}
+function readHostedExecutionSafeConfigurationMessage(message) {
+    const normalized = normalizeHostedExecutionOperatorMessage(message);
+    return HOSTED_EXECUTION_SAFE_CONFIGURATION_MESSAGE_PATTERNS.some((pattern) => pattern.test(normalized))
+        ? normalized
+        : null;
+}
+function redactHostedExecutionText(value) {
+    return value
+        .replace(/\b(authorization)\b\s*:\s*Bearer\s+[A-Za-z0-9._~+/=-]+\b/giu, (_match, key) => `${key}=Bearer [redacted]`)
+        .replace(/\bBearer\s+[A-Za-z0-9._~+/=-]+\b/giu, "Bearer [redacted]")
+        .replace(/\b([A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,})\b/gu, "[redacted-email]")
+        .replace(/\b(authorization)\b\s*[:=]\s*(?!Bearer\b)(?:"[^"]+"|'[^']+'|\S+)/giu, (_match, key) => `${key}=[redacted]`)
+        .replace(/\b((?:[A-Z][A-Z0-9_]*_)?(?:token|secret|password|passcode|api[_-]?key|cookie|set-cookie))\b\s*[:=]\s*(?:"[^"]+"|'[^']+'|\S+)/giu, "$1=[redacted]")
+        .replace(/\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\b/gu, "[redacted-token]");
+}
+//# sourceMappingURL=observability.js.map

package/dist/observability.js.map

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

package/dist/outbox-payload.d.ts

@@ -0,0 +1,21 @@
+import type { HostedExecutionDispatchRequest } from "./contracts.ts";
+import { type HostedExecutionDispatchRef, type HostedExecutionDispatchRefFallback } from "./dispatch-ref.ts";
+export declare const HOSTED_EXECUTION_OUTBOX_PAYLOAD_SCHEMA_VERSION = "murph.execution-outbox.v2";
+export type HostedExecutionOutboxPayloadStorage = "inline" | "reference";
+export interface HostedExecutionInlineOutboxPayload {
+    dispatch: HostedExecutionDispatchRequest;
+    schemaVersion: typeof HOSTED_EXECUTION_OUTBOX_PAYLOAD_SCHEMA_VERSION;
+    storage: "inline";
+}
+export interface HostedExecutionReferenceOutboxPayload {
+    dispatchRef: HostedExecutionDispatchRef;
+    schemaVersion: typeof HOSTED_EXECUTION_OUTBOX_PAYLOAD_SCHEMA_VERSION;
+    storage: "reference";
+}
+export type HostedExecutionOutboxPayload = HostedExecutionInlineOutboxPayload | HostedExecutionReferenceOutboxPayload;
+export declare function buildHostedExecutionOutboxPayload(dispatch: HostedExecutionDispatchRequest, options?: {
+    storage?: HostedExecutionOutboxPayloadStorage | "auto";
+}): HostedExecutionOutboxPayload;
+export declare function readHostedExecutionOutboxPayload(payloadJson: unknown, fallback: HostedExecutionDispatchRefFallback): HostedExecutionOutboxPayload | null;
+export declare function resolveHostedExecutionOutboxPayloadStorage(dispatch: HostedExecutionDispatchRequest, requested: HostedExecutionOutboxPayloadStorage | "auto"): HostedExecutionOutboxPayloadStorage;
+//# sourceMappingURL=outbox-payload.d.ts.map

package/dist/outbox-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox-payload.d.ts","sourceRoot":"","sources":["../src/outbox-payload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAIrE,OAAO,EAGL,KAAK,0BAA0B,EAC/B,KAAK,kCAAkC,EACxC,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,8CAA8C,8BAA8B,CAAC;AAE1F,MAAM,MAAM,mCAAmC,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEzE,MAAM,WAAW,kCAAkC;IACjD,QAAQ,EAAE,8BAA8B,CAAC;IACzC,aAAa,EAAE,OAAO,8CAA8C,CAAC;IACrE,OAAO,EAAE,QAAQ,CAAC;CACnB;AAED,MAAM,WAAW,qCAAqC;IACpD,WAAW,EAAE,0BAA0B,CAAC;IACxC,aAAa,EAAE,OAAO,8CAA8C,CAAC;IACrE,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,4BAA4B,GACpC,kCAAkC,GAClC,qCAAqC,CAAC;AAE1C,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,8BAA8B,EACxC,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,mCAAmC,GAAG,MAAM,CAAC;CACnD,GACL,4BAA4B,CAgB9B;AAED,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,OAAO,EACpB,QAAQ,EAAE,kCAAkC,GAC3C,4BAA4B,GAAG,IAAI,CA6BrC;AAED,wBAAgB,0CAA0C,CACxD,QAAQ,EAAE,8BAA8B,EACxC,SAAS,EAAE,mCAAmC,GAAG,MAAM,GACtD,mCAAmC,CAmBrC"}

package/dist/outbox-payload.js

@@ -0,0 +1,72 @@
+import { parseHostedExecutionDispatchRequest, } from "./parsers.js";
+import { buildHostedExecutionDispatchRef, readHostedExecutionDispatchRef, } from "./dispatch-ref.js";
+export const HOSTED_EXECUTION_OUTBOX_PAYLOAD_SCHEMA_VERSION = "murph.execution-outbox.v2";
+export function buildHostedExecutionOutboxPayload(dispatch, options = {}) {
+    const storage = resolveHostedExecutionOutboxPayloadStorage(dispatch, options.storage ?? "auto");
+    if (storage === "inline") {
+        return {
+            dispatch: parseHostedExecutionDispatchRequest(dispatch),
+            schemaVersion: HOSTED_EXECUTION_OUTBOX_PAYLOAD_SCHEMA_VERSION,
+            storage,
+        };
+    }
+    return {
+        dispatchRef: buildHostedExecutionDispatchRef(dispatch),
+        schemaVersion: HOSTED_EXECUTION_OUTBOX_PAYLOAD_SCHEMA_VERSION,
+        storage,
+    };
+}
+export function readHostedExecutionOutboxPayload(payloadJson, fallback) {
+    const payloadObject = toObject(payloadJson);
+    const schemaVersion = readText(payloadObject.schemaVersion);
+    if (schemaVersion === HOSTED_EXECUTION_OUTBOX_PAYLOAD_SCHEMA_VERSION) {
+        const storage = readText(payloadObject.storage);
+        if (storage === "inline") {
+            return {
+                dispatch: parseHostedExecutionDispatchRequest(payloadObject.dispatch),
+                schemaVersion: HOSTED_EXECUTION_OUTBOX_PAYLOAD_SCHEMA_VERSION,
+                storage,
+            };
+        }
+        if (storage === "reference") {
+            const dispatchRef = readHostedExecutionDispatchRef(payloadObject, fallback);
+            return dispatchRef
+                ? {
+                    dispatchRef,
+                    schemaVersion: HOSTED_EXECUTION_OUTBOX_PAYLOAD_SCHEMA_VERSION,
+                    storage,
+                }
+                : null;
+        }
+        return null;
+    }
+    return null;
+}
+export function resolveHostedExecutionOutboxPayloadStorage(dispatch, requested) {
+    if (requested !== "auto") {
+        return requested;
+    }
+    switch (dispatch.event.kind) {
+        case "linq.message.received":
+        case "telegram.message.received":
+        case "email.message.received":
+            return "reference";
+        case "member.activated":
+        case "assistant.cron.tick":
+        case "device-sync.wake":
+        case "vault.share.accepted":
+        case "gateway.message.send":
+            return "inline";
+        default:
+            throw new TypeError("Unsupported hosted execution event kind.");
+    }
+}
+function readText(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value : null;
+}
+function toObject(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+//# sourceMappingURL=outbox-payload.js.map

package/dist/outbox-payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox-payload.js","sourceRoot":"","sources":["../src/outbox-payload.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mCAAmC,GACpC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,GAG/B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,CAAC,MAAM,8CAA8C,GAAG,2BAA2B,CAAC;AAoB1F,MAAM,UAAU,iCAAiC,CAC/C,QAAwC,EACxC,UAEI,EAAE;IAEN,MAAM,OAAO,GAAG,0CAA0C,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC;IAEhG,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO;YACL,QAAQ,EAAE,mCAAmC,CAAC,QAAQ,CAAC;YACvD,aAAa,EAAE,8CAA8C;YAC7D,OAAO;SACR,CAAC;IACJ,CAAC;IAED,OAAO;QACL,WAAW,EAAE,+BAA+B,CAAC,QAAQ,CAAC;QACtD,aAAa,EAAE,8CAA8C;QAC7D,OAAO;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,WAAoB,EACpB,QAA4C;IAE5C,MAAM,aAAa,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IAE5D,IAAI,aAAa,KAAK,8CAA8C,EAAE,CAAC;QACrE,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAEhD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YACzB,OAAO;gBACL,QAAQ,EAAE,mCAAmC,CAAC,aAAa,CAAC,QAAQ,CAAC;gBACrE,aAAa,EAAE,8CAA8C;gBAC7D,OAAO;aACR,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;YAC5B,MAAM,WAAW,GAAG,8BAA8B,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;YAC5E,OAAO,WAAW;gBAChB,CAAC,CAAC;oBACE,WAAW;oBACX,aAAa,EAAE,8CAA8C;oBAC7D,OAAO;iBACR;gBACH,CAAC,CAAC,IAAI,CAAC;QACX,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,0CAA0C,CACxD,QAAwC,EACxC,SAAuD;IAEvD,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,QAAQ,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC5B,KAAK,uBAAuB,CAAC;QAC7B,KAAK,2BAA2B,CAAC;QACjC,KAAK,wBAAwB;YAC3B,OAAO,WAAW,CAAC;QACrB,KAAK,kBAAkB,CAAC;QACxB,KAAK,qBAAqB,CAAC;QAC3B,KAAK,kBAAkB,CAAC;QACxB,KAAK,sBAAsB,CAAC;QAC5B,KAAK,sBAAsB;YACzB,OAAO,QAAQ,CAAC;QAClB;YACE,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7E,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChE,CAAC,CAAC,KAAgC;QAClC,CAAC,CAAC,EAAE,CAAC;AACT,CAAC"}

package/dist/parsers.d.ts

@@ -0,0 +1,22 @@
+import type { HostedExecutionBundleRef, HostedExecutionDeviceSyncRuntimeApplyResponse, HostedExecutionDeviceSyncRuntimeSnapshotResponse, HostedExecutionDispatchResult, HostedExecutionDispatchRequest, HostedExecutionEvent, HostedExecutionRunnerRequest, HostedExecutionRunnerResult, HostedExecutionSharePackResponse, HostedExecutionShareReference, HostedExecutionUserEnvStatus, HostedExecutionUserEnvUpdate, HostedExecutionUserStatus } from "./contracts.ts";
+import { type HostedExecutionBundlePayloads, type HostedExecutionBundleRefs } from "./bundles.ts";
+import type { HostedExecutionRunContext, HostedExecutionRunStatus, HostedExecutionTimelineEntry } from "./observability.ts";
+export declare function parseHostedExecutionDispatchRequest(value: unknown): HostedExecutionDispatchRequest;
+export declare function parseHostedExecutionRunnerRequest(value: unknown): HostedExecutionRunnerRequest;
+export declare function parseHostedExecutionRunnerResult(value: unknown): HostedExecutionRunnerResult;
+export declare function parseHostedExecutionDispatchResult(value: unknown): HostedExecutionDispatchResult;
+export declare function parseHostedExecutionUserStatus(value: unknown): HostedExecutionUserStatus;
+export declare function parseHostedExecutionRunContext(value: unknown): HostedExecutionRunContext;
+export declare function parseHostedExecutionRunStatus(value: unknown): HostedExecutionRunStatus;
+export declare function parseHostedExecutionTimelineEntries(value: unknown): HostedExecutionTimelineEntry[];
+export declare function parseHostedExecutionBundlePayloads(value: unknown, label?: string): HostedExecutionBundlePayloads;
+export declare function parseHostedExecutionBundleRefsRecord(value: unknown, label?: string): HostedExecutionBundleRefs;
+export declare function parseHostedExecutionUserEnvStatus(value: unknown): HostedExecutionUserEnvStatus;
+export declare function parseHostedExecutionUserEnvUpdate(value: unknown): HostedExecutionUserEnvUpdate;
+export declare function parseHostedExecutionSharePackResponse(value: unknown): HostedExecutionSharePackResponse;
+export declare function parseHostedExecutionDeviceSyncRuntimeSnapshotResponse(value: unknown): HostedExecutionDeviceSyncRuntimeSnapshotResponse;
+export declare function parseHostedExecutionDeviceSyncRuntimeApplyResponse(value: unknown): HostedExecutionDeviceSyncRuntimeApplyResponse;
+export declare function parseHostedExecutionBundleRef(value: unknown, label?: string): HostedExecutionBundleRef | null;
+export declare function parseHostedExecutionEvent(value: unknown): HostedExecutionEvent;
+export declare function parseHostedExecutionShareReference(value: unknown): HostedExecutionShareReference;
+//# sourceMappingURL=parsers.d.ts.map

package/dist/parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../src/parsers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,wBAAwB,EAExB,6CAA6C,EAK7C,gDAAgD,EAEhD,6BAA6B,EAC7B,8BAA8B,EAE9B,oBAAoB,EAIpB,4BAA4B,EAC5B,2BAA2B,EAC3B,gCAAgC,EAChC,6BAA6B,EAC7B,4BAA4B,EAC5B,4BAA4B,EAC5B,yBAAyB,EAE1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EAC/B,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC7B,MAAM,oBAAoB,CAAC;AAM5B,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,OAAO,GAAG,8BAA8B,CAQlG;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,GAAG,4BAA4B,CAa9F;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,2BAA2B,CAkB5F;AAED,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,GAAG,6BAA6B,CAgBhG;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,yBAAyB,CA8CxF;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,yBAAyB,CAQxF;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAgBtF;AAED,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,OAAO,GAAG,4BAA4B,EAAE,CAkClG;AAED,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,OAAO,EACd,KAAK,SAA6B,GACjC,6BAA6B,CAM/B;AAED,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,OAAO,EACd,KAAK,SAAiC,GACrC,yBAAyB,CAM3B;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,GAAG,4BAA4B,CAU9F;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,GAAG,4BAA4B,CAkB9F;AAED,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,OAAO,GAAG,gCAAgC,CAOtG;AAED,wBAAgB,qDAAqD,CACnE,KAAK,EAAE,OAAO,GACb,gDAAgD,CAclD;AAED,wBAAgB,kDAAkD,CAChE,KAAK,EAAE,OAAO,GACb,6CAA6C,CAW/C;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,EACd,KAAK,SAAgC,GACpC,wBAAwB,GAAG,IAAI,CAajC;AA2ID,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CA2G9E;AAED,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,GAAG,6BAA6B,CAOhG"}