@evermore.work/server 2026.509.0-canary.0

package/dist/services/plugin-managed-routines.js

@@ -0,0 +1,416 @@
+import { and, eq } from "drizzle-orm";
+import { agents, pluginManagedResources, plugins, projects, routines, routineTriggers, } from "@evermore.work/db";
+import { ROUTINE_STATUSES } from "@evermore.work/shared";
+import { notFound, unprocessable } from "../errors.js";
+import { logActivity } from "./activity-log.js";
+import { routineService } from "./routines.js";
+const MANAGED_ROUTINE_RESOURCE_KIND = "routine";
+function buildRoutineDefaults(declaration) {
+    return {
+        routineKey: declaration.routineKey,
+        title: declaration.title,
+        description: declaration.description ?? null,
+        assigneeRef: declaration.assigneeRef ?? null,
+        projectRef: declaration.projectRef ?? null,
+        goalId: declaration.goalId ?? null,
+        status: declaration.status ?? null,
+        priority: declaration.priority ?? "medium",
+        concurrencyPolicy: declaration.concurrencyPolicy ?? "coalesce_if_active",
+        catchUpPolicy: declaration.catchUpPolicy ?? "skip_missed",
+        variables: declaration.variables ?? [],
+        triggers: declaration.triggers ?? [],
+        issueTemplate: declaration.issueTemplate ?? null,
+    };
+}
+function normalizeRef(pluginKey, ref, resourceKind) {
+    if (!ref)
+        return null;
+    if (ref.resourceKind !== resourceKind) {
+        throw unprocessable(`Managed routine ${resourceKind} ref must target ${resourceKind}`);
+    }
+    if (ref.pluginKey && ref.pluginKey !== pluginKey) {
+        throw unprocessable("Managed routine refs must target the declaring plugin");
+    }
+    return { ...ref, pluginKey };
+}
+function managedByPlugin(row) {
+    return {
+        id: row.id,
+        pluginId: row.pluginId,
+        pluginKey: row.pluginKey,
+        pluginDisplayName: row.manifestJson?.displayName ?? row.pluginKey,
+        resourceKind: "routine",
+        resourceKey: row.resourceKey,
+        defaultsJson: row.defaultsJson,
+        createdAt: row.createdAt,
+        updatedAt: row.updatedAt,
+    };
+}
+function triggerInput(trigger) {
+    if (trigger.kind === "schedule") {
+        if (!trigger.cronExpression) {
+            throw unprocessable("Managed schedule routine triggers require cronExpression");
+        }
+        return {
+            kind: "schedule",
+            label: trigger.label ?? null,
+            enabled: trigger.enabled ?? true,
+            cronExpression: trigger.cronExpression,
+            timezone: trigger.timezone ?? "UTC",
+        };
+    }
+    if (trigger.kind === "webhook") {
+        return {
+            kind: "webhook",
+            label: trigger.label ?? null,
+            enabled: trigger.enabled ?? true,
+            signingMode: (trigger.signingMode ?? "bearer"),
+            replayWindowSec: trigger.replayWindowSec ?? 300,
+        };
+    }
+    return {
+        kind: "api",
+        label: trigger.label ?? null,
+        enabled: trigger.enabled ?? true,
+    };
+}
+export function pluginManagedRoutineService(db, options) {
+    const routinesSvc = routineService(db, {
+        pluginWorkerManager: options.pluginWorkerManager,
+    });
+    function declarationFor(routineKey) {
+        const declaration = options.manifest?.routines?.find((routine) => routine.routineKey === routineKey);
+        if (!declaration) {
+            throw notFound(`Managed routine declaration not found: ${routineKey}`);
+        }
+        return declaration;
+    }
+    async function getBinding(companyId, routineKey) {
+        return db
+            .select({
+            id: pluginManagedResources.id,
+            companyId: pluginManagedResources.companyId,
+            pluginId: pluginManagedResources.pluginId,
+            pluginKey: pluginManagedResources.pluginKey,
+            resourceKind: pluginManagedResources.resourceKind,
+            resourceKey: pluginManagedResources.resourceKey,
+            resourceId: pluginManagedResources.resourceId,
+            defaultsJson: pluginManagedResources.defaultsJson,
+            manifestJson: plugins.manifestJson,
+            createdAt: pluginManagedResources.createdAt,
+            updatedAt: pluginManagedResources.updatedAt,
+        })
+            .from(pluginManagedResources)
+            .innerJoin(plugins, eq(pluginManagedResources.pluginId, plugins.id))
+            .where(and(eq(pluginManagedResources.companyId, companyId), eq(pluginManagedResources.pluginId, options.pluginId), eq(pluginManagedResources.resourceKind, MANAGED_ROUTINE_RESOURCE_KIND), eq(pluginManagedResources.resourceKey, routineKey)))
+            .then((rows) => rows[0] ?? null);
+    }
+    async function upsertBinding(companyId, declaration, routineId) {
+        const defaultsJson = buildRoutineDefaults(declaration);
+        const existing = await getBinding(companyId, declaration.routineKey);
+        if (existing) {
+            return db
+                .update(pluginManagedResources)
+                .set({
+                resourceId: routineId,
+                defaultsJson,
+                updatedAt: new Date(),
+            })
+                .where(eq(pluginManagedResources.id, existing.id))
+                .returning()
+                .then((rows) => rows[0]);
+        }
+        return db
+            .insert(pluginManagedResources)
+            .values({
+            companyId,
+            pluginId: options.pluginId,
+            pluginKey: options.pluginKey,
+            resourceKind: MANAGED_ROUTINE_RESOURCE_KIND,
+            resourceKey: declaration.routineKey,
+            resourceId: routineId,
+            defaultsJson,
+        })
+            .returning()
+            .then((rows) => rows[0]);
+    }
+    async function getRoutineWithManagedBy(companyId, declaration) {
+        const binding = await getBinding(companyId, declaration.routineKey);
+        if (!binding)
+            return null;
+        const routine = await db
+            .select()
+            .from(routines)
+            .where(and(eq(routines.companyId, companyId), eq(routines.id, binding.resourceId)))
+            .then((rows) => rows[0] ?? null);
+        if (!routine)
+            return null;
+        return {
+            ...routine,
+            managedByPlugin: managedByPlugin(binding),
+        };
+    }
+    async function resolveAgentId(companyId, declaration, overrides) {
+        if (overrides?.assigneeAgentId !== undefined) {
+            if (!overrides.assigneeAgentId)
+                return { agentId: null, missingRef: null };
+            const row = await db
+                .select({ id: agents.id })
+                .from(agents)
+                .where(and(eq(agents.companyId, companyId), eq(agents.id, overrides.assigneeAgentId)))
+                .then((rows) => rows[0] ?? null);
+            if (!row)
+                throw notFound("Assignee agent not found");
+            return { agentId: row.id, missingRef: null };
+        }
+        const ref = normalizeRef(options.pluginKey, declaration.assigneeRef, "agent");
+        if (!ref)
+            return { agentId: null, missingRef: null };
+        const binding = await db
+            .select({ resourceId: pluginManagedResources.resourceId })
+            .from(pluginManagedResources)
+            .where(and(eq(pluginManagedResources.companyId, companyId), eq(pluginManagedResources.pluginId, options.pluginId), eq(pluginManagedResources.resourceKind, "agent"), eq(pluginManagedResources.resourceKey, ref.resourceKey)))
+            .then((rows) => rows[0] ?? null);
+        if (!binding)
+            return { agentId: null, missingRef: ref };
+        const row = await db
+            .select({ id: agents.id })
+            .from(agents)
+            .where(and(eq(agents.companyId, companyId), eq(agents.id, binding.resourceId)))
+            .then((rows) => rows[0] ?? null);
+        return row ? { agentId: row.id, missingRef: null } : { agentId: null, missingRef: ref };
+    }
+    async function resolveProjectId(companyId, declaration, overrides) {
+        if (overrides?.projectId !== undefined) {
+            if (!overrides.projectId)
+                return { projectId: null, missingRef: null };
+            const row = await db
+                .select({ id: projects.id })
+                .from(projects)
+                .where(and(eq(projects.companyId, companyId), eq(projects.id, overrides.projectId)))
+                .then((rows) => rows[0] ?? null);
+            if (!row)
+                throw notFound("Project not found");
+            return { projectId: row.id, missingRef: null };
+        }
+        const ref = normalizeRef(options.pluginKey, declaration.projectRef, "project");
+        if (!ref)
+            return { projectId: null, missingRef: null };
+        const binding = await db
+            .select({ resourceId: pluginManagedResources.resourceId })
+            .from(pluginManagedResources)
+            .where(and(eq(pluginManagedResources.companyId, companyId), eq(pluginManagedResources.pluginId, options.pluginId), eq(pluginManagedResources.resourceKind, "project"), eq(pluginManagedResources.resourceKey, ref.resourceKey)))
+            .then((rows) => rows[0] ?? null);
+        if (!binding)
+            return { projectId: null, missingRef: ref };
+        const row = await db
+            .select({ id: projects.id })
+            .from(projects)
+            .where(and(eq(projects.companyId, companyId), eq(projects.id, binding.resourceId)))
+            .then((rows) => rows[0] ?? null);
+        return row ? { projectId: row.id, missingRef: null } : { projectId: null, missingRef: ref };
+    }
+    async function resolveRefs(companyId, declaration, overrides) {
+        const [agent, project] = await Promise.all([
+            resolveAgentId(companyId, declaration, overrides),
+            resolveProjectId(companyId, declaration, overrides),
+        ]);
+        const missingRefs = [];
+        if (agent.missingRef)
+            missingRefs.push(agent.missingRef);
+        if (project.missingRef)
+            missingRefs.push(project.missingRef);
+        return {
+            assigneeAgentId: agent.agentId,
+            projectId: project.projectId,
+            missingRefs,
+        };
+    }
+    function resolution(companyId, declaration, routine, status, missingRefs = []) {
+        return {
+            pluginKey: options.pluginKey,
+            resourceKind: "routine",
+            resourceKey: declaration.routineKey,
+            companyId,
+            routineId: routine?.id ?? null,
+            routine,
+            status,
+            missingRefs,
+        };
+    }
+    async function ensureDefaultTriggers(routineId, declaration) {
+        const triggers = declaration.triggers ?? [];
+        if (triggers.length === 0)
+            return;
+        const existingCount = await db
+            .select({ id: routineTriggers.id })
+            .from(routineTriggers)
+            .where(eq(routineTriggers.routineId, routineId))
+            .limit(1)
+            .then((rows) => rows.length);
+        if (existingCount > 0)
+            return;
+        for (const trigger of triggers) {
+            await routinesSvc.createTrigger(routineId, triggerInput(trigger), { agentId: null, userId: null });
+        }
+    }
+    async function createManagedRoutine(companyId, declaration, overrides) {
+        const refs = await resolveRefs(companyId, declaration, overrides);
+        if (refs.missingRefs.length > 0) {
+            return resolution(companyId, declaration, null, "missing_refs", refs.missingRefs);
+        }
+        const created = await routinesSvc.create(companyId, {
+            projectId: refs.projectId,
+            goalId: declaration.goalId ?? null,
+            title: declaration.title,
+            description: declaration.description ?? null,
+            assigneeAgentId: refs.assigneeAgentId,
+            priority: declaration.priority ?? "medium",
+            status: declaration.status ?? (refs.assigneeAgentId ? "active" : "paused"),
+            concurrencyPolicy: declaration.concurrencyPolicy ?? "coalesce_if_active",
+            catchUpPolicy: declaration.catchUpPolicy ?? "skip_missed",
+            variables: declaration.variables ?? [],
+        }, { agentId: null, userId: null });
+        await upsertBinding(companyId, declaration, created.id);
+        await ensureDefaultTriggers(created.id, declaration);
+        const routine = await getRoutineWithManagedBy(companyId, declaration);
+        await logActivity(db, {
+            companyId,
+            actorType: "plugin",
+            actorId: options.pluginId,
+            action: "plugin.managed_routine.created",
+            entityType: "routine",
+            entityId: created.id,
+            details: {
+                sourcePluginKey: options.pluginKey,
+                managedResourceKey: declaration.routineKey,
+                assigneeAgentId: refs.assigneeAgentId,
+                projectId: refs.projectId,
+            },
+        });
+        return resolution(companyId, declaration, routine, "created");
+    }
+    async function get(routineKey, companyId) {
+        const declaration = declarationFor(routineKey);
+        const routine = await getRoutineWithManagedBy(companyId, declaration);
+        return resolution(companyId, declaration, routine, routine ? "resolved" : "missing");
+    }
+    async function reconcile(routineKey, companyId, overrides) {
+        const declaration = declarationFor(routineKey);
+        const current = await get(routineKey, companyId);
+        if (current.routine) {
+            await upsertBinding(companyId, declaration, current.routine.id);
+            await ensureDefaultTriggers(current.routine.id, declaration);
+            return current;
+        }
+        return createManagedRoutine(companyId, declaration, overrides);
+    }
+    async function reset(routineKey, companyId, overrides) {
+        const declaration = declarationFor(routineKey);
+        const current = await get(routineKey, companyId);
+        if (!current.routine) {
+            return createManagedRoutine(companyId, declaration, overrides);
+        }
+        const refs = await resolveRefs(companyId, declaration, overrides);
+        if (refs.missingRefs.length > 0) {
+            return resolution(companyId, declaration, current.routine, "missing_refs", refs.missingRefs);
+        }
+        const updated = await routinesSvc.update(current.routine.id, {
+            projectId: refs.projectId,
+            goalId: declaration.goalId ?? null,
+            title: declaration.title,
+            description: declaration.description ?? null,
+            assigneeAgentId: refs.assigneeAgentId,
+            priority: declaration.priority ?? "medium",
+            status: declaration.status ?? (refs.assigneeAgentId ? "active" : "paused"),
+            concurrencyPolicy: declaration.concurrencyPolicy ?? "coalesce_if_active",
+            catchUpPolicy: declaration.catchUpPolicy ?? "skip_missed",
+            variables: declaration.variables ?? [],
+        }, { agentId: null, userId: null });
+        if (!updated)
+            throw notFound("Managed routine not found");
+        await upsertBinding(companyId, declaration, updated.id);
+        await ensureDefaultTriggers(updated.id, declaration);
+        const routine = await getRoutineWithManagedBy(companyId, declaration);
+        await logActivity(db, {
+            companyId,
+            actorType: "plugin",
+            actorId: options.pluginId,
+            action: "plugin.managed_routine.reset",
+            entityType: "routine",
+            entityId: updated.id,
+            details: {
+                sourcePluginKey: options.pluginKey,
+                managedResourceKey: declaration.routineKey,
+                assigneeAgentId: refs.assigneeAgentId,
+                projectId: refs.projectId,
+            },
+        });
+        return resolution(companyId, declaration, routine, "reset");
+    }
+    async function update(routineKey, companyId, patch) {
+        const declaration = declarationFor(routineKey);
+        const current = await get(routineKey, companyId);
+        if (!current.routine)
+            throw notFound("Managed routine not found");
+        const updatePatch = {};
+        if (patch.status !== undefined) {
+            if (!ROUTINE_STATUSES.includes(patch.status)) {
+                throw unprocessable("Invalid routine status");
+            }
+            updatePatch.status = patch.status;
+        }
+        const updated = await routinesSvc.update(current.routine.id, updatePatch, { agentId: null, userId: null });
+        if (!updated)
+            throw notFound("Managed routine not found");
+        await logActivity(db, {
+            companyId,
+            actorType: "plugin",
+            actorId: options.pluginId,
+            action: "plugin.managed_routine.updated",
+            entityType: "routine",
+            entityId: updated.id,
+            details: {
+                sourcePluginKey: options.pluginKey,
+                managedResourceKey: declaration.routineKey,
+                status: updated.status,
+            },
+        });
+        const routine = await getRoutineWithManagedBy(companyId, declaration);
+        return routine ?? updated;
+    }
+    async function run(routineKey, companyId, overrides) {
+        const declaration = declarationFor(routineKey);
+        const current = await get(routineKey, companyId);
+        if (!current.routine)
+            throw notFound("Managed routine not found");
+        const run = await routinesSvc.runRoutine(current.routine.id, {
+            source: "manual",
+            assigneeAgentId: overrides?.assigneeAgentId,
+            projectId: overrides?.projectId,
+        }, { agentId: null, userId: null });
+        await logActivity(db, {
+            companyId,
+            actorType: "plugin",
+            actorId: options.pluginId,
+            action: "plugin.managed_routine.run_triggered",
+            entityType: "routine_run",
+            entityId: run.id,
+            details: {
+                sourcePluginKey: options.pluginKey,
+                managedResourceKey: declaration.routineKey,
+                routineId: current.routine.id,
+                status: run.status,
+            },
+        });
+        return run;
+    }
+    return {
+        get,
+        reconcile,
+        reset,
+        update,
+        run,
+    };
+}
+//# sourceMappingURL=plugin-managed-routines.js.map

package/dist/services/plugin-managed-routines.js.map

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

package/dist/services/plugin-manifest-validator.d.ts

@@ -0,0 +1,79 @@
+import type { EvermorePluginManifestV1 } from "@evermore.work/shared";
+/**
+ * Successful parse result.
+ */
+export interface ManifestParseSuccess {
+    success: true;
+    manifest: EvermorePluginManifestV1;
+}
+/**
+ * Failed parse result. `errors` is a human-readable description of what went
+ * wrong; `details` is the raw Zod error list for programmatic inspection.
+ */
+export interface ManifestParseFailure {
+    success: false;
+    errors: string;
+    details: Array<{
+        path: (string | number)[];
+        message: string;
+    }>;
+}
+/** Union of parse outcomes. */
+export type ManifestParseResult = ManifestParseSuccess | ManifestParseFailure;
+/**
+ * Service for parsing and validating plugin manifests.
+ *
+ * @see PLUGIN_SPEC.md §10 — Plugin Manifest
+ */
+export interface PluginManifestValidator {
+    /**
+     * Try to parse `input` as a plugin manifest.
+     *
+     * Returns a {@link ManifestParseSuccess} when the input passes all
+     * validation rules, or a {@link ManifestParseFailure} with human-readable
+     * error messages when it does not.
+     *
+     * This is the "safe" variant — it never throws.
+     */
+    parse(input: unknown): ManifestParseResult;
+    /**
+     * Parse `input` as a plugin manifest, throwing a 400 HttpError on failure.
+     *
+     * Use this at install time when an invalid manifest should surface as an
+     * HTTP error to the caller.
+     *
+     * @throws {HttpError} 400 Bad Request if the manifest is invalid.
+     */
+    parseOrThrow(input: unknown): EvermorePluginManifestV1;
+    /**
+     * Return the list of plugin API versions supported by this host.
+     *
+     * Callers can use this to present the supported version range to operators
+     * or to decide whether a candidate plugin can be installed.
+     */
+    getSupportedVersions(): readonly number[];
+}
+/**
+ * Create a {@link PluginManifestValidator}.
+ *
+ * Usage:
+ * ```ts
+ * const validator = pluginManifestValidator();
+ *
+ * // Safe parse — inspect the result
+ * const result = validator.parse(rawManifest);
+ * if (!result.success) {
+ *   console.error(result.errors);
+ *   return;
+ * }
+ * const manifest = result.manifest;
+ *
+ * // Throwing parse — use at install time
+ * const manifest = validator.parseOrThrow(rawManifest);
+ *
+ * // Check supported versions
+ * const versions = validator.getSupportedVersions(); // [1]
+ * ```
+ */
+export declare function pluginManifestValidator(): PluginManifestValidator;
+//# sourceMappingURL=plugin-manifest-validator.d.ts.map

package/dist/services/plugin-manifest-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-manifest-validator.d.ts","sourceRoot":"","sources":["../../src/services/plugin-manifest-validator.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAmBtE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,EAAE,wBAAwB,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChE;AAED,+BAA+B;AAC/B,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAM9E;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAAC;IAE3C;;;;;;;OAOG;IACH,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAAC;IAEvD;;;;;OAKG;IACH,oBAAoB,IAAI,SAAS,MAAM,EAAE,CAAC;CAC3C;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,IAAI,uBAAuB,CA4CjE"}

package/dist/services/plugin-manifest-validator.js

@@ -0,0 +1,84 @@
+/**
+ * PluginManifestValidator — schema validation for plugin manifest files.
+ *
+ * Uses the shared Zod schema (`pluginManifestV1Schema`) to validate
+ * manifest payloads. Provides both a safe `parse()` variant (returns
+ * a result union) and a throwing `parseOrThrow()` for HTTP error
+ * propagation at install time.
+ *
+ * @see PLUGIN_SPEC.md §10 — Plugin Manifest
+ * @see packages/shared/src/validators/plugin.ts — Zod schema definition
+ */
+import { pluginManifestV1Schema } from "@evermore.work/shared";
+import { PLUGIN_API_VERSION } from "@evermore.work/shared";
+import { badRequest } from "../errors.js";
+// ---------------------------------------------------------------------------
+// Supported manifest API versions
+// ---------------------------------------------------------------------------
+/**
+ * The set of plugin API versions this host can accept.
+ * When a new API version is introduced, add it here. Old versions should be
+ * retained until the host drops support for them.
+ */
+const SUPPORTED_VERSIONS = [PLUGIN_API_VERSION];
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a {@link PluginManifestValidator}.
+ *
+ * Usage:
+ * ```ts
+ * const validator = pluginManifestValidator();
+ *
+ * // Safe parse — inspect the result
+ * const result = validator.parse(rawManifest);
+ * if (!result.success) {
+ *   console.error(result.errors);
+ *   return;
+ * }
+ * const manifest = result.manifest;
+ *
+ * // Throwing parse — use at install time
+ * const manifest = validator.parseOrThrow(rawManifest);
+ *
+ * // Check supported versions
+ * const versions = validator.getSupportedVersions(); // [1]
+ * ```
+ */
+export function pluginManifestValidator() {
+    return {
+        parse(input) {
+            const result = pluginManifestV1Schema.safeParse(input);
+            if (result.success) {
+                return {
+                    success: true,
+                    manifest: result.data,
+                };
+            }
+            const details = result.error.errors.map((issue) => ({
+                path: issue.path,
+                message: issue.message,
+            }));
+            const errors = details
+                .map(({ path, message }) => path.length > 0 ? `${path.join(".")}: ${message}` : message)
+                .join("; ");
+            return {
+                success: false,
+                errors,
+                details,
+            };
+        },
+        parseOrThrow(input) {
+            const result = this.parse(input);
+            if (!result.success) {
+                throw badRequest(`Invalid plugin manifest: ${result.errors}`, result.details);
+            }
+            return result.manifest;
+        },
+        getSupportedVersions() {
+            return SUPPORTED_VERSIONS;
+        },
+    };
+}
+//# sourceMappingURL=plugin-manifest-validator.js.map

package/dist/services/plugin-manifest-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-manifest-validator.js","sourceRoot":"","sources":["../../src/services/plugin-manifest-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,CAAC,kBAAkB,CAAU,CAAC;AAmEzD,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,KAAK,CAAC,KAAc;YAClB,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAEvD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,QAAQ,EAAE,MAAM,CAAC,IAAgC;iBAClD,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAClD,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC,CAAC;YAEJ,MAAM,MAAM,GAAG,OAAO;iBACnB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CACzB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAC5D;iBACA,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM;gBACN,OAAO;aACR,CAAC;QACJ,CAAC;QAED,YAAY,CAAC,KAAc;YACzB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAEjC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,UAAU,CAAC,4BAA4B,MAAM,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YAChF,CAAC;YAED,OAAO,MAAM,CAAC,QAAQ,CAAC;QACzB,CAAC;QAED,oBAAoB;YAClB,OAAO,kBAAkB,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC"}