@nookplot/runtime 0.5.143 → 0.5.145

package/dist/pack.js

@@ -0,0 +1,379 @@
+/**
+ * Pack — minimal declarative capability bundle for forged agents.
+ *
+ * ROADMAP_external-mcp-connectors Phase 3: the minimal pack-load slice
+ * (ROADMAP_pack-primitive inherits this schema when it lands). A pack declares:
+ *  - `preset`      — the existing Forge knowledge preset (a PresetConfig,
+ *                    embedded verbatim; loaded by PresetLoader unchanged)
+ *  - `tools`       — allowlist of catalog action types the agent may use
+ *                    (CORE_ACTIONS remain the safety floor — see signalActionMap)
+ *  - `mcpServers`  — external MCP servers to mount at load (Phase 1/2 bridge)
+ *  - `connections` — external services the pack needs, with owner scope
+ *  - `connectors`  — chat/outbound surfaces the agent uses (discord/email)
+ *
+ * Validation is hand-rolled — no schema-validation dependency exists in the
+ * runtime (mirrors the gateway's bounded-JSON-schema precedent) — and collects
+ * ALL errors in one pass. `validatePack` is pure: no DB, no network, no fs.
+ *
+ * @module pack
+ */
+import yaml from "js-yaml";
+import { ACTION_CATALOG } from "./actionCatalog.js";
+/**
+ * Connector-platform descriptor table — the ONE pack-side registration
+ * point per platform (modes encode the risk posture: chat connectors stay
+ * reactive, platform-DM outreach violates ToS; outbound BD rides the agent
+ * email bridge). Adding a platform = one entry here; the gateway connector
+ * implementation is its own work (see connectorSurfaces.ts gateway-side).
+ */
+export const CONNECTOR_PLATFORMS = {
+    discord: { modes: ["reactive"], toolCategory: null, label: "Discord", hasBindings: true },
+    telegram: { modes: ["reactive"], toolCategory: null, label: "Telegram", hasBindings: true },
+    email: {
+        modes: ["outbound"], toolCategory: "email", label: "Email", hasBindings: false,
+        readyDetail: "outbound email rides the agent inbox (send_email)",
+    },
+};
+// ── Constants ─────────────────────────────────────────────────
+/**
+ * Pack FORMAT version this loader understands. Omitted `schemaVersion`
+ * means 1. A pack declaring a NEWER schema fails closed with one
+ * actionable "upgrade the runtime" error — never key-by-key noise —
+ * because a future format may carry semantics (e.g. gating fields) an old
+ * loader cannot safely ignore. Packs are durable marketplace artifacts
+ * consumed by version-skewed self-hosted loaders; bump this (and keep
+ * gateway/src/services/packRegistryService.ts in sync) whenever the pack
+ * schema gains a field.
+ */
+export const PACK_SCHEMA_VERSION = 1;
+/**
+ * Allowed modes per connector platform — derived view of
+ * CONNECTOR_PLATFORMS, kept as a named export for existing consumers.
+ * The Record type keeps this exhaustive: a platform added to
+ * CONNECTOR_PLATFORMS without a line here is a compile error.
+ */
+export const CONNECTOR_PLATFORM_MODES = {
+    discord: CONNECTOR_PLATFORMS.discord.modes,
+    telegram: CONNECTOR_PLATFORMS.telegram.modes,
+    email: CONNECTOR_PLATFORMS.email.modes,
+};
+const NAME_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$/;
+const VERSION_RE = /^\d+\.\d+\.\d+$/;
+/** Mirrors the gateway serverName regex in routes/mcp.ts. */
+const SERVER_NAME_RE = /^[a-zA-Z0-9_-]{1,64}$/;
+/** Mirrors the gateway credentialService regex in routes/mcp.ts + actions.ts. */
+const SERVICE_RE = /^[a-zA-Z0-9_.-]{1,64}$/;
+const MAX_DESCRIPTION_LEN = 500;
+const TOP_LEVEL_KEYS = new Set([
+    "schemaVersion", "name", "version", "description", "preset", "tools", "mcpServers", "connections", "connectors",
+]);
+/** Common snake_case misspellings → the camelCase key this schema uses. */
+const KEY_ALIASES = {
+    mcp_servers: "mcpServers",
+    schema_version: "schemaVersion",
+};
+// ── Helpers ───────────────────────────────────────────────────
+function isPlainObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function isHttpUrl(v) {
+    try {
+        const u = new URL(v);
+        return u.protocol === "http:" || u.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+/** Deep copy for plain YAML/JSON data (packs never carry functions/dates). */
+function deepCopy(v) {
+    return JSON.parse(JSON.stringify(v));
+}
+// ── Validation ────────────────────────────────────────────────
+function validatePreset(preset, errors) {
+    if (!isPlainObject(preset)) {
+        errors.push("preset: must be an object");
+        return;
+    }
+    if (typeof preset.id !== "string" || preset.id.length === 0) {
+        errors.push("preset.id: required non-empty string");
+    }
+    if (preset.version !== undefined && (typeof preset.version !== "number" || !Number.isInteger(preset.version) || preset.version < 1)) {
+        errors.push("preset.version: must be a positive integer");
+    }
+    if (preset.trustLevel !== undefined && !["verified", "scanned", "raw"].includes(preset.trustLevel)) {
+        errors.push('preset.trustLevel: must be "verified" | "scanned" | "raw"');
+    }
+    if (preset.failurePolicy !== undefined && !["abort", "continue"].includes(preset.failurePolicy)) {
+        errors.push('preset.failurePolicy: must be "abort" | "continue"');
+    }
+    if (preset.maxCostNook !== undefined && (typeof preset.maxCostNook !== "number" || preset.maxCostNook < 0)) {
+        errors.push("preset.maxCostNook: must be a non-negative number");
+    }
+    if (preset.sources !== undefined) {
+        if (!Array.isArray(preset.sources)) {
+            errors.push("preset.sources: must be an array");
+        }
+        else {
+            preset.sources.forEach((src, i) => {
+                if (!isPlainObject(src)) {
+                    errors.push(`preset.sources[${i}]: must be an object`);
+                    return;
+                }
+                if (typeof src.type !== "string" || src.type.length === 0) {
+                    errors.push(`preset.sources[${i}].type: required non-empty string`);
+                }
+                if (src.label !== undefined && typeof src.label !== "string") {
+                    errors.push(`preset.sources[${i}].label: must be a string`);
+                }
+                if (src.config !== undefined && !isPlainObject(src.config)) {
+                    errors.push(`preset.sources[${i}].config: must be an object`);
+                }
+            });
+        }
+    }
+}
+/**
+ * Validate an unknown value as a Pack. Pure — collects every error rather
+ * than failing on the first. On success returns a deep copy (the caller's
+ * input is never aliased).
+ */
+export function validatePack(input) {
+    const errors = [];
+    if (!isPlainObject(input)) {
+        return { ok: false, pack: null, errors: ["pack: must be an object (YAML mapping)"] };
+    }
+    // Schema-format gate FIRST: a pack from a newer format fails closed with
+    // one actionable error, not a pile of unknown-key noise for fields this
+    // loader has never heard of.
+    if (input.schemaVersion !== undefined) {
+        if (typeof input.schemaVersion !== "number" || !Number.isInteger(input.schemaVersion) || input.schemaVersion < 1) {
+            return { ok: false, pack: null, errors: ["schemaVersion: must be a positive integer (omit for 1)"] };
+        }
+        if (input.schemaVersion > PACK_SCHEMA_VERSION) {
+            return {
+                ok: false, pack: null,
+                errors: [
+                    `schemaVersion: pack declares schema ${input.schemaVersion}, but this loader supports up to ${PACK_SCHEMA_VERSION} — upgrade @nookplot/runtime / @nookplot/cli to load it`,
+                ],
+            };
+        }
+    }
+    // Strict top-level keys — catches typos and the roadmap's snake_case notation.
+    for (const key of Object.keys(input)) {
+        if (!TOP_LEVEL_KEYS.has(key)) {
+            const alias = KEY_ALIASES[key];
+            errors.push(alias ? `${key}: unknown key — did you mean "${alias}"?` : `${key}: unknown key`);
+        }
+    }
+    if (typeof input.name !== "string" || !NAME_RE.test(input.name)) {
+        errors.push("name: required, 1-100 chars, letters/digits then letters/digits/._-");
+    }
+    if (typeof input.version !== "string" || !VERSION_RE.test(input.version)) {
+        errors.push('version: required semver string, e.g. "1.0.0"');
+    }
+    if (input.description !== undefined && (typeof input.description !== "string" || input.description.length > MAX_DESCRIPTION_LEN)) {
+        errors.push(`description: must be a string of at most ${MAX_DESCRIPTION_LEN} chars`);
+    }
+    if (input.preset !== undefined)
+        validatePreset(input.preset, errors);
+    // tools — catalog action allowlist
+    if (input.tools !== undefined) {
+        if (!Array.isArray(input.tools)) {
+            errors.push("tools: must be an array of action types");
+        }
+        else {
+            const seen = new Set();
+            input.tools.forEach((t, i) => {
+                if (typeof t !== "string") {
+                    errors.push(`tools[${i}]: must be a string`);
+                    return;
+                }
+                if (t.startsWith("mcp__") || t.startsWith("mcp:")) {
+                    errors.push(`tools[${i}]: "${t}" — external MCP tools are not allowlisted here; declare the server under mcpServers (its discovered tools surface automatically)`);
+                    return;
+                }
+                if (!(t in ACTION_CATALOG)) {
+                    errors.push(`tools[${i}]: unknown action type "${t}" (not in ACTION_CATALOG)`);
+                    return;
+                }
+                if (seen.has(t))
+                    errors.push(`tools[${i}]: duplicate action type "${t}"`);
+                seen.add(t);
+            });
+        }
+    }
+    // connections — validated before mcpServers so refs can resolve
+    const connectionServices = new Set();
+    if (input.connections !== undefined) {
+        if (!Array.isArray(input.connections)) {
+            errors.push("connections: must be an array");
+        }
+        else {
+            input.connections.forEach((c, i) => {
+                if (!isPlainObject(c)) {
+                    errors.push(`connections[${i}]: must be an object`);
+                    return;
+                }
+                if (typeof c.service !== "string" || !SERVICE_RE.test(c.service)) {
+                    errors.push(`connections[${i}].service: required, 1-64 chars of letters/digits/._-`);
+                }
+                else if (connectionServices.has(c.service)) {
+                    errors.push(`connections[${i}].service: duplicate service "${c.service}"`);
+                }
+                else {
+                    connectionServices.add(c.service);
+                }
+                if (c.owner !== "agent" && c.owner !== "workspace") {
+                    errors.push(`connections[${i}].owner: must be "agent" | "workspace"`);
+                }
+                for (const key of Object.keys(c)) {
+                    if (key !== "service" && key !== "owner")
+                        errors.push(`connections[${i}].${key}: unknown key`);
+                }
+            });
+        }
+    }
+    // mcpServers
+    const referencedConnections = new Set();
+    if (input.mcpServers !== undefined) {
+        if (!Array.isArray(input.mcpServers)) {
+            errors.push("mcpServers: must be an array");
+        }
+        else {
+            const names = new Set();
+            input.mcpServers.forEach((s, i) => {
+                if (!isPlainObject(s)) {
+                    errors.push(`mcpServers[${i}]: must be an object`);
+                    return;
+                }
+                if (typeof s.name !== "string" || !SERVER_NAME_RE.test(s.name)) {
+                    errors.push(`mcpServers[${i}].name: required, 1-64 chars of letters/digits/_-`);
+                }
+                else if (names.has(s.name)) {
+                    errors.push(`mcpServers[${i}].name: duplicate server name "${s.name}"`);
+                }
+                else {
+                    names.add(s.name);
+                }
+                if (typeof s.url !== "string" || !isHttpUrl(s.url)) {
+                    errors.push(`mcpServers[${i}].url: required http(s) URL`);
+                }
+                if (s.connection !== undefined) {
+                    if (typeof s.connection !== "string") {
+                        errors.push(`mcpServers[${i}].connection: must be a string`);
+                    }
+                    else if (!connectionServices.has(s.connection)) {
+                        errors.push(`mcpServers[${i}].connection: "${s.connection}" does not match any connections[].service`);
+                    }
+                    else {
+                        referencedConnections.add(s.connection);
+                    }
+                }
+                for (const key of Object.keys(s)) {
+                    if (key !== "name" && key !== "url" && key !== "connection")
+                        errors.push(`mcpServers[${i}].${key}: unknown key`);
+                }
+            });
+        }
+    }
+    // Dead-declaration check: every connection must authenticate something.
+    for (const service of connectionServices) {
+        if (!referencedConnections.has(service)) {
+            errors.push(`connections: service "${service}" is not referenced by any mcpServers[].connection — remove it or wire it`);
+        }
+    }
+    // connectors
+    if (input.connectors !== undefined) {
+        if (!Array.isArray(input.connectors)) {
+            errors.push("connectors: must be an array");
+        }
+        else {
+            const platforms = new Set();
+            input.connectors.forEach((c, i) => {
+                if (!isPlainObject(c)) {
+                    errors.push(`connectors[${i}]: must be an object`);
+                    return;
+                }
+                const platform = c.platform;
+                if (typeof platform !== "string" || !(platform in CONNECTOR_PLATFORMS)) {
+                    errors.push(`connectors[${i}].platform: must be one of ${Object.keys(CONNECTOR_PLATFORMS).join(" | ")}`);
+                    return;
+                }
+                if (platforms.has(platform)) {
+                    errors.push(`connectors[${i}].platform: duplicate platform "${platform}"`);
+                }
+                platforms.add(platform);
+                const allowed = CONNECTOR_PLATFORMS[platform].modes;
+                if (typeof c.mode !== "string" || !allowed.includes(c.mode)) {
+                    errors.push(`connectors[${i}].mode: "${String(c.mode)}" not allowed for ${platform} (allowed: ${allowed.join(", ")})`);
+                }
+                for (const key of Object.keys(c)) {
+                    if (key !== "platform" && key !== "mode")
+                        errors.push(`connectors[${i}].${key}: unknown key`);
+                }
+            });
+        }
+    }
+    if (errors.length > 0)
+        return { ok: false, pack: null, errors };
+    return { ok: true, pack: deepCopy(input), errors: [] };
+}
+/** Parse a YAML (or JSON) pack document and validate it. */
+export function parsePack(text) {
+    let doc;
+    try {
+        doc = yaml.load(text);
+    }
+    catch (err) {
+        return { ok: false, pack: null, errors: [`pack: YAML parse error — ${err instanceof Error ? err.message : String(err)}`] };
+    }
+    return validatePack(doc);
+}
+// ── Preset conversion (lossless round-trip) ───────────────────
+/**
+ * Convert an existing Forge preset (the `preset:` block of nookplot.yaml)
+ * into a Pack. The preset is embedded verbatim, so
+ * `packToPresetConfig(presetToPack(p))` deep-equals `p` — lossless.
+ * Throws if the result does not validate (e.g. a preset id that can't be a
+ * pack name and no explicit name was given).
+ */
+export function presetToPack(preset, meta) {
+    const candidate = {
+        name: meta?.name ?? preset.id,
+        version: meta?.version ?? `${preset.version ?? 1}.0.0`,
+        ...(meta?.description !== undefined ? { description: meta.description } : {}),
+        preset: deepCopy(preset),
+    };
+    const result = validatePack(candidate);
+    if (!result.ok || !result.pack) {
+        throw new Error(`presetToPack: converted pack is invalid — ${result.errors.join("; ")}`);
+    }
+    return result.pack;
+}
+/** Extract the embedded Forge preset from a pack (null when none declared). */
+export function packToPresetConfig(pack) {
+    return pack.preset ? deepCopy(pack.preset) : null;
+}
+// ── Action resolution (gating input) ──────────────────────────
+/**
+ * Resolve a pack's declared action set: `tools` ∪ each connector's catalog
+ * category (email → the "email" actions; discord contributes none). This is
+ * the `packActions` input to getAvailableActionsFromMap — mounted external
+ * MCP tools (`mcp__*`) are NOT included here; they merge via externalActions.
+ * Sorted for deterministic prompts/tests.
+ */
+export function resolvePackActions(pack) {
+    const actions = new Set(pack.tools ?? []);
+    for (const connector of pack.connectors ?? []) {
+        const category = CONNECTOR_PLATFORMS[connector.platform].toolCategory;
+        if (!category)
+            continue;
+        for (const [name, info] of Object.entries(ACTION_CATALOG)) {
+            if (info.category === category)
+                actions.add(name);
+        }
+    }
+    return Array.from(actions).sort();
+}
+//# sourceMappingURL=pack.js.map

package/dist/pack.js.map

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

package/dist/packLoader.d.ts

@@ -0,0 +1,109 @@
+/**
+ * PackLoader — loads a Pack at agent boot (ROADMAP_external-mcp-connectors
+ * Phase 3; the minimal pack-load slice that ROADMAP_pack-primitive inherits).
+ *
+ * On load it:
+ *  1. Parses + validates the pack (from options.pack or a pack YAML file).
+ *  2. Pre-flights every declared connection — which external services are
+ *     already connected (agent credential / OAuth / workspace connection) —
+ *     and produces actionable hints for the missing ones.
+ *  3. Mounts the declared MCP servers via the Phase-1/2 bridge
+ *     (POST /v1/agents/me/mcp/servers is an upsert, so re-loading is
+ *     idempotent). Servers whose connection is unsatisfied are skipped.
+ *  4. Reports connector binding status (Discord bindings are created in the
+ *     platform install flow — a pack declares the capability; the loader
+ *     reports bound/unbound).
+ *  5. Delegates the embedded `preset` block verbatim to PresetLoader.
+ *
+ * The loader mounts and reports; it does NOT gate. Pass the same pack to
+ * `new AutonomousAgent(runtime, { pack })` for prompt + dispatch gating.
+ *
+ * @module packLoader
+ */
+import type { NookplotRuntime } from "./index.js";
+import { type PresetLoadResult } from "./presetLoader.js";
+import { type Pack, type PackConnection, type PackConnectorMode, type PackConnectorPlatform } from "./pack.js";
+export interface PackLoaderOptions {
+    /** Pre-parsed pack — skips the file read. Caller is responsible for validation (parsePack). */
+    pack?: Pack;
+    /**
+     * Registry reference, `"name"` or `"name@1.2.3"` — fetched from the
+     * gateway pack registry via POST /v1/agents/me/pack/load (which also
+     * records it as the agent's active pack). Registry content is untrusted:
+     * it is re-validated with parsePack before use. Takes precedence over
+     * `packPath`; `pack` takes precedence over both.
+     */
+    packRef?: string;
+    /** Path to a pack YAML file (default "./pack.yaml"). */
+    packPath?: string;
+    /** Workspace that satisfies `owner: "workspace"` connections. */
+    workspaceId?: string;
+    /** Config path forwarded to PresetLoader (manifest conventions; default "./nookplot.yaml"). */
+    presetConfigPath?: string;
+}
+export interface PackConnectionStatus {
+    service: string;
+    owner: PackConnection["owner"];
+    status: "satisfied" | "missing";
+    /** How the satisfied connection authenticates at mount time. */
+    authType?: "bearer_credential" | "oauth" | "workspace";
+    /** Actionable next step when missing. */
+    hint?: string;
+}
+export interface PackMcpServerStatus {
+    name: string;
+    url: string;
+    status: "mounted" | "failed" | "skipped";
+    toolCount?: number;
+    /** Mount error (status "failed"). */
+    error?: string;
+    /** Why the mount was skipped (status "skipped"). */
+    reason?: string;
+}
+export interface PackConnectorStatus {
+    platform: PackConnectorPlatform;
+    mode: PackConnectorMode;
+    /** discord: bound/unbound (active bindings exist); email: always ready. */
+    status: "bound" | "unbound" | "ready";
+    detail?: string;
+}
+export interface PackLoadReport {
+    name: string;
+    version: string;
+    /** Where the pack came from: a pre-parsed object, a local file, or the gateway registry. */
+    source: "inline" | "file" | "registry";
+    /** Registry artifact fingerprint (sha256 of the stored YAML) — registry source only. */
+    contentHash?: string;
+    connections: PackConnectionStatus[];
+    mcpServers: PackMcpServerStatus[];
+    connectors: PackConnectorStatus[];
+    /** Present when the pack embeds a `preset` block. */
+    preset?: PresetLoadResult;
+    /** The pack's resolved action set — feed to AutonomousAgent / getAvailableActionsFromMap. */
+    actions: string[];
+    /** True when every connection is satisfied and every mount succeeded. */
+    ok: boolean;
+}
+/**
+ * Fetch a pack from the gateway registry by `"name"` or `"name@1.2.3"` via
+ * POST /v1/agents/me/pack/load — which also records it as the calling
+ * agent's active pack. Registry content is untrusted: it is re-validated
+ * with parsePack before returning; invalid content throws.
+ */
+export declare function fetchRegistryPack(runtime: NookplotRuntime, ref: string): Promise<{
+    pack: Pack;
+    contentHash?: string;
+}>;
+export declare class PackLoader {
+    private runtime;
+    private options;
+    constructor(runtime: NookplotRuntime, options?: PackLoaderOptions);
+    /** Load the pack: validate → pre-flight → mount → connector status → preset. */
+    load(): Promise<PackLoadReport>;
+    private resolvePack;
+    private checkConnections;
+    private oauthConnected;
+    private mountServers;
+    private checkConnectors;
+}
+//# sourceMappingURL=packLoader.d.ts.map

package/dist/packLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packLoader.d.ts","sourceRoot":"","sources":["../src/packLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAwF,KAAK,IAAI,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAIrM,MAAM,WAAW,iBAAiB;IAChC,+FAA+F;IAC/F,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+FAA+F;IAC/F,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,mBAAmB,GAAG,OAAO,GAAG,WAAW,CAAC;IACvD,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,IAAI,EAAE,iBAAiB,CAAC;IACxB,2EAA2E;IAC3E,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,4FAA4F;IAC5F,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACvC,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,qDAAqD;IACrD,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,6FAA6F;IAC7F,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yEAAyE;IACzE,EAAE,EAAE,OAAO,CAAC;CACb;AAID;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,eAAe,EACxB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAa/C;AAID,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,OAAO,CAAoB;gBAEvB,OAAO,EAAE,eAAe,EAAE,OAAO,GAAE,iBAAsB;IAKrE,gFAAgF;IAC1E,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC;YAgCvB,WAAW;YAmBX,gBAAgB;YAiEhB,cAAc;YAad,YAAY;YAuCZ,eAAe;CA4B9B"}