@plurnk/plurnk-service 1.8.0 → 1.9.1

package/dist/server/SkillsFunctionality.d.ts

@@ -0,0 +1,61 @@
+import { type FunctionalityCandidate, type FunctionalityDiscoverQuery, type JsonSchema, type ProblemDetails } from "@plurnk/plurnk-contracts";
+import type { Db } from "../core/Db.ts";
+import HostPaths from "../core/HostPaths.ts";
+import type { FunctionalityAdapter, FunctionalityDefinitionSource, FunctionalityFamilyHandle, FunctionalityPreparation, FunctionalityPrepared, FunctionalityServiceDefinition, WorkerCapabilityIdentity } from "./DaemonModule.ts";
+export declare const SKILLS_FAMILY = "skills";
+export declare const SKILLS_OWNER = "@plurnk/plurnk-core/skills";
+interface SkillDoc {
+    readonly name: string;
+    readonly description: string;
+    readonly body: string;
+}
+export interface RegistrySkill {
+    readonly name: string;
+    readonly id: string;
+    readonly source: string;
+    readonly installs: number | null;
+}
+export interface SkillsToolchain {
+    run(args: readonly string[], cwd: string, home: string): Promise<string>;
+    search(query: string): Promise<readonly RegistrySkill[]>;
+}
+export declare class SkillsActionError extends Error {
+    readonly problem: ProblemDetails;
+    constructor(problem: ProblemDetails, cause?: unknown);
+}
+export declare const parseSkill: (file: string, folder: string, raw: string) => SkillDoc;
+export declare const renderSkill: (doc: SkillDoc) => string;
+export declare const renderIndex: (skills: readonly SkillDoc[]) => string;
+export declare const parseListing: (output: string) => Array<{
+    name: string;
+    description: string;
+}>;
+export declare class StandardSkillsToolchain implements SkillsToolchain {
+    #private;
+    constructor(env?: NodeJS.ProcessEnv);
+    get registry(): string | null;
+    run(args: readonly string[], cwd: string, home: string): Promise<string>;
+    search(query: string): Promise<readonly RegistrySkill[]>;
+}
+export default class SkillsFunctionality implements FunctionalityAdapter {
+    #private;
+    readonly family = "skills";
+    readonly namespaceOwner = "@plurnk/plurnk-core/skills";
+    readonly summary = "Agent Skills: standard SKILL.md directories under the project and user roots, enabled per Worker.";
+    readonly definitionSchema: JsonSchema;
+    constructor({ db, hostPaths, toolchain }: {
+        readonly db: Db;
+        readonly hostPaths?: HostPaths;
+        readonly toolchain?: SkillsToolchain;
+    });
+    attach(handle: FunctionalityFamilyHandle): void;
+    refreshIfChanged(identity: WorkerCapabilityIdentity): Promise<void>;
+    available(identity: WorkerCapabilityIdentity): Promise<readonly FunctionalityServiceDefinition[]>;
+    discover(query: FunctionalityDiscoverQuery, identity: WorkerCapabilityIdentity): Promise<readonly FunctionalityCandidate[]>;
+    admit(input: unknown, identity: WorkerCapabilityIdentity): Promise<FunctionalityDefinitionSource>;
+    forget(source: FunctionalityDefinitionSource, identity: WorkerCapabilityIdentity): Promise<void>;
+    prepare(preparation: FunctionalityPreparation): Promise<FunctionalityPrepared>;
+    teardown(_snapshot: unknown, identity: WorkerCapabilityIdentity): Promise<void>;
+}
+export {};
+//# sourceMappingURL=SkillsFunctionality.d.ts.map

package/dist/server/SkillsFunctionality.d.ts.map

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

package/dist/server/SkillsFunctionality.js

@@ -0,0 +1,449 @@
+// {§skills-functionality} — standard Agent Skills as one Worker Functionality
+// family. The filesystem under the universal roots is the only truth about
+// installation; the Worker's durable state owns enablement; the standard
+// `skills` CLI is the deterministic installer beneath `add`/`remove` and the
+// registry behind `discover`, and neither is the model's or a client's contract.
+import { execFile } from "node:child_process";
+import { createHash } from "node:crypto";
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { promisify, stripVTControlCharacters } from "node:util";
+import { parse as parseYaml } from "yaml";
+import { Problems, Validator, } from "@plurnk/plurnk-contracts";
+import HostPaths from "../core/HostPaths.js";
+const execFileP = promisify(execFile);
+export const SKILLS_FAMILY = "skills";
+export const SKILLS_OWNER = "@plurnk/plurnk-core/skills";
+const DEFINITION = { $ref: "https://schemas.plurnk.xyz/v0/SkillDefinition.json" };
+const SKILL_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
+const DEFAULT_CLI = "npx --yes skills";
+const DEFAULT_REGISTRY = "https://skills.sh";
+const REGISTRY_LIMIT = 20;
+const CLI_TIMEOUT_MS = 120_000;
+export class SkillsActionError extends Error {
+    problem;
+    constructor(problem, cause) {
+        super(problem.detail, cause === undefined ? undefined : { cause });
+        this.name = "SkillsActionError";
+        this.problem = problem;
+    }
+}
+const problem = (code, status, detail, extensions = {}) => Problems.create("skills:functionality", code, status, detail, {
+    stage: "skills-functionality",
+    retryable: status === 409 || status >= 500,
+    ...extensions,
+});
+const actionError = (code, status, detail, extensions = {}, cause) => new SkillsActionError(problem(code, status, detail, extensions), cause);
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const messageOf = (cause) => cause instanceof Error ? cause.message : String(cause);
+const isFile = (path) => stat(path).then((info) => info.isFile(), () => false);
+const exists = (path) => stat(path).then(() => true, () => false);
+// Agent Skills requires YAML frontmatter with name and description. Admission
+// consumes those two discovery keys and preserves the instruction body.
+export const parseSkill = (file, folder, raw) => {
+    const lines = raw.replace(/\r\n/gu, "\n").split("\n");
+    if (lines[0] !== "---")
+        throw new Error(`${file}: Agent Skill requires YAML frontmatter`);
+    const close = lines.indexOf("---", 1);
+    if (close === -1)
+        throw new Error(`${file}: Agent Skill frontmatter is not closed`);
+    let metadata;
+    try {
+        metadata = parseYaml(lines.slice(1, close).join("\n"), { maxAliasCount: 0, uniqueKeys: true });
+    }
+    catch (cause) {
+        throw new Error(`${file}: Agent Skill frontmatter is invalid YAML`, { cause });
+    }
+    if (!isRecord(metadata))
+        throw new Error(`${file}: Agent Skill frontmatter must be a mapping`);
+    const { name, description } = metadata;
+    if (typeof name !== "string" || name.length === 0)
+        throw new Error(`${file}: Agent Skill frontmatter requires name`);
+    if (!SKILL_NAME.test(name))
+        throw new Error(`${file}: Agent Skill name ${JSON.stringify(name)} is invalid`);
+    if (name.length > 64)
+        throw new Error(`${file}: Agent Skill name exceeds 64 characters`);
+    if (name !== folder)
+        throw new Error(`${file}: Agent Skill name ${JSON.stringify(name)} must match folder ${JSON.stringify(folder)}`);
+    if (typeof description !== "string" || description.length === 0)
+        throw new Error(`${file}: Agent Skill frontmatter requires description`);
+    if (description.length > 1024)
+        throw new Error(`${file}: Agent Skill description exceeds 1024 characters`);
+    return { name, description, body: lines.slice(close + 1).join("\n").trim() };
+};
+export const renderSkill = (doc) => [
+    `# ${doc.name}`,
+    "",
+    "## Summary",
+    "",
+    doc.description,
+    ...(doc.body.length === 0 ? [] : ["", doc.body]),
+].join("\n");
+export const renderIndex = (skills) => [
+    "# Skills",
+    "",
+    "## Summary",
+    "",
+    "Agent Skills enabled for this worker.",
+    ...skills.flatMap((skill) => ["", `- **${skill.name}** — ${skill.description}`]),
+].join("\n");
+// `skills add <source> --list` prints, after an "Available Skills" heading,
+// each skill name at one indentation and its description at a deeper one,
+// behind the CLI's box-drawing gutter. Only that structure is read.
+export const parseListing = (output) => {
+    const lines = stripVTControlCharacters(output).split(/\r?\n/u);
+    const start = lines.findIndex((line) => /Available Skills\s*$/u.test(line));
+    if (start === -1)
+        return [];
+    const skills = [];
+    for (const line of lines.slice(start + 1)) {
+        const match = /^[^\s\p{L}\p{N}]*( +)(\S.*)$/u.exec(line);
+        if (match === null)
+            continue;
+        const indent = match[1].length;
+        const text = match[2].trim();
+        if (indent === 4) {
+            if (SKILL_NAME.test(text))
+                skills.push({ name: text, description: "" });
+            continue;
+        }
+        const last = skills.at(-1);
+        if (last === undefined || indent < 6)
+            continue;
+        skills[skills.length - 1] = { name: last.name, description: last.description.length === 0 ? text : `${last.description} ${text}` };
+    }
+    return skills;
+};
+export class StandardSkillsToolchain {
+    #command;
+    #registry;
+    constructor(env = process.env) {
+        const cli = env.PLURNK_SERVICE_SKILLS_CLI?.trim();
+        this.#command = (cli === undefined || cli.length === 0 ? DEFAULT_CLI : cli).split(/\s+/u);
+        const registry = env.PLURNK_SERVICE_SKILLS_REGISTRY_URL;
+        this.#registry = registry === undefined ? DEFAULT_REGISTRY : registry.trim().length === 0 ? null : registry.trim().replace(/\/+$/u, "");
+    }
+    get registry() {
+        return this.#registry;
+    }
+    async run(args, cwd, home) {
+        const [command, ...prefix] = this.#command;
+        const { stdout, stderr } = await execFileP(command, [...prefix, ...args], {
+            cwd,
+            env: { ...process.env, HOME: home, NO_COLOR: "1", CI: "1" },
+            timeout: CLI_TIMEOUT_MS,
+            maxBuffer: 8 * 1024 * 1024,
+        });
+        return `${stdout}\n${stderr}`;
+    }
+    async search(query) {
+        if (this.#registry === null) {
+            throw actionError("registry-not-configured", 501, "Skills registry search is disabled; PLURNK_SERVICE_SKILLS_REGISTRY_URL is empty.", { query, retryable: false });
+        }
+        const url = `${this.#registry}/api/search?${new URLSearchParams({ q: query, limit: String(REGISTRY_LIMIT) })}`;
+        let response;
+        try {
+            response = await fetch(url, { signal: AbortSignal.timeout(30_000) });
+        }
+        catch (cause) {
+            throw actionError("registry-unreachable", 502, `Skills registry ${this.#registry} could not be reached.`, { query, registry: this.#registry, retryable: true }, cause);
+        }
+        if (!response.ok)
+            throw actionError("registry-rejected", 502, `Skills registry ${this.#registry} answered ${response.status}.`, { query, registry: this.#registry, status: response.status, retryable: true });
+        const body = await response.json();
+        if (!Array.isArray(body.skills))
+            throw actionError("registry-invalid", 502, `Skills registry ${this.#registry} returned no skills array.`, { query, registry: this.#registry, retryable: true });
+        return body.skills.flatMap((skill) => {
+            if (!isRecord(skill) || typeof skill.name !== "string" || typeof skill.id !== "string")
+                return [];
+            return [{
+                    name: skill.name,
+                    id: skill.id,
+                    source: typeof skill.source === "string" && skill.source.length > 0 ? skill.source : skill.id.split("/").slice(0, 2).join("/"),
+                    installs: typeof skill.installs === "number" ? skill.installs : null,
+                }];
+        });
+    }
+}
+export default class SkillsFunctionality {
+    family = SKILLS_FAMILY;
+    namespaceOwner = SKILLS_OWNER;
+    summary = "Agent Skills: standard SKILL.md directories under the project and user roots, enabled per Worker.";
+    definitionSchema = DEFINITION;
+    #db;
+    #hostPaths;
+    #toolchain;
+    #signatures = new Map();
+    #handle = null;
+    constructor({ db, hostPaths = new HostPaths(), toolchain = new StandardSkillsToolchain() }) {
+        this.#db = db;
+        this.#hostPaths = hostPaths;
+        this.#toolchain = toolchain;
+    }
+    attach(handle) {
+        this.#handle = handle;
+    }
+    async #projectRoot(workspaceId) {
+        const workspace = await this.#db.envelope_get_workspace.get({ id: workspaceId });
+        return workspace?.project_root ?? null;
+    }
+    #rootFor(scope, projectRoot) {
+        if (scope === "global")
+            return this.#hostPaths.globalSkillsDir;
+        return projectRoot === null ? null : this.#hostPaths.projectSkillsDir(projectRoot);
+    }
+    #cwdFor(scope, projectRoot) {
+        return scope === "global" || projectRoot === null ? this.#hostPaths.home : projectRoot;
+    }
+    async #installedIn(scope, dir) {
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch (cause) {
+            if (cause.code === "ENOENT")
+                return [];
+            throw new Error(`read ${scope} Agent Skills directory ${dir} failed`, { cause });
+        }
+        const installed = [];
+        for (const entry of entries.filter((candidate) => candidate.isDirectory() || candidate.isSymbolicLink())) {
+            const file = join(dir, entry.name, "SKILL.md");
+            if (await isFile(file))
+                installed.push({ name: entry.name, scope, dir: join(dir, entry.name), file });
+        }
+        return installed.toSorted((left, right) => left.name.localeCompare(right.name));
+    }
+    // The effective installed union: project shadows global by name.
+    async #scan(projectRoot) {
+        const union = new Map();
+        for (const scope of ["project", "global"]) {
+            const dir = this.#rootFor(scope, projectRoot);
+            if (dir === null)
+                continue;
+            for (const installed of await this.#installedIn(scope, dir)) {
+                if (!union.has(installed.name))
+                    union.set(installed.name, installed);
+            }
+        }
+        return union;
+    }
+    // The standard installer's lock files record each installed skill's source.
+    async #lockSources(projectRoot) {
+        const sources = new Map();
+        for (const dir of [projectRoot, this.#hostPaths.home]) {
+            if (dir === null)
+                continue;
+            let lock;
+            try {
+                lock = JSON.parse(await readFile(join(dir, "skills-lock.json"), "utf8"));
+            }
+            catch {
+                continue;
+            }
+            if (!isRecord(lock) || !isRecord(lock.skills))
+                continue;
+            for (const [name, entry] of Object.entries(lock.skills)) {
+                if (isRecord(entry) && typeof entry.source === "string" && !sources.has(name))
+                    sources.set(name, entry.source);
+            }
+        }
+        return sources;
+    }
+    async #signature(projectRoot) {
+        const hash = createHash("sha256");
+        for (const installed of (await this.#scan(projectRoot)).values()) {
+            const content = await readFile(installed.file, "utf8").catch((cause) => `!${messageOf(cause)}`);
+            hash.update(`${installed.name}${installed.scope}${content}
`);
+        }
+        return hash.digest("hex");
+    }
+    // {§skills-hotload} — filesystem installers operate out of band; before a
+    // turn assembles its packet the family republishes when the roots changed.
+    async refreshIfChanged(identity) {
+        const published = this.#signatures.get(identity.workerId);
+        if (published === undefined)
+            return;
+        const current = await this.#signature(await this.#projectRoot(identity.workspaceId));
+        if (current === published)
+            return;
+        if (this.#handle === null)
+            throw new Error("Skills Functionality is not attached to its coordinator handle.");
+        await this.#handle.refresh(identity, { gate: "none" });
+    }
+    async available(identity) {
+        const projectRoot = await this.#projectRoot(identity.workspaceId);
+        const sources = await this.#lockSources(projectRoot);
+        return [...(await this.#scan(projectRoot)).values()].map((installed) => {
+            const source = sources.get(installed.name);
+            const definition = { name: installed.name, scope: installed.scope, ...(source === undefined ? {} : { source }) };
+            return { alias: installed.name, definition, enabled: true };
+        });
+    }
+    async discover(query, identity) {
+        if (query.configuration !== undefined) {
+            throw actionError("configuration-unsupported", 400, "Agent Skills discovery takes a registry query or an explicit source; client configuration contributes nothing.", { retryable: false });
+        }
+        if (query.source !== undefined) {
+            const source = query.source;
+            const cwd = this.#cwdFor("project", await this.#projectRoot(identity.workspaceId));
+            let output;
+            try {
+                output = await this.#toolchain.run(["add", source, "--list"], cwd, this.#hostPaths.home);
+            }
+            catch (cause) {
+                throw actionError("discover-failed", 502, `Agent Skills source '${source}' could not be listed: ${messageOf(cause)}`, { source, retryable: true }, cause);
+            }
+            return parseListing(output).map((skill) => ({
+                alias: skill.name,
+                ...(skill.description.length === 0 ? {} : { summary: skill.description }),
+                definition: { name: skill.name, scope: "project", source },
+                provenance: { kind: "source", source },
+            }));
+        }
+        if (query.query === undefined)
+            return [];
+        const registry = await this.#toolchain.search(query.query);
+        return registry.flatMap((skill) => {
+            if (!SKILL_NAME.test(skill.name))
+                return [];
+            return [{
+                    alias: skill.name,
+                    ...(skill.installs === null ? {} : { summary: `${skill.installs} installs` }),
+                    definition: { name: skill.name, scope: "project", source: skill.source },
+                    provenance: { kind: "registry", source: skill.source, reference: `${DEFAULT_REGISTRY}/${skill.id}` },
+                }];
+        });
+    }
+    async admit(input, identity) {
+        const params = isRecord(input) ? input : {};
+        let definition;
+        try {
+            definition = structuredClone(Validator.assertSkillDefinition(structuredClone(params.definition)));
+        }
+        catch (cause) {
+            throw actionError("definition-invalid", 400, "The Agent Skill definition is invalid.", { retryable: false }, cause);
+        }
+        const alias = typeof params.alias === "string" ? params.alias : definition.name;
+        if (alias !== definition.name) {
+            throw actionError("alias-mismatch", 400, `Alias '${alias}' must equal the skill name '${definition.name}'.`, { alias, name: definition.name, retryable: false });
+        }
+        if (definition.source === undefined) {
+            throw actionError("source-required", 400, `Adding '${alias}' requires the standard installer source that provides it.`, { alias, retryable: false });
+        }
+        if (definition.scope === "project" && await this.#projectRoot(identity.workspaceId) === null) {
+            throw actionError("project-root-required", 400, `'${alias}' targets the project scope, but this workspace has no project root.`, { alias, recovery: "Add it with scope \"global\" or open a workspace rooted in a project.", retryable: false });
+        }
+        return { alias, definition };
+    }
+    async #install(definition, root, cwd) {
+        const args = ["add", definition.source, "--agent", "universal", "--skill", definition.name, "--yes", ...(definition.scope === "global" ? ["--global"] : [])];
+        let output;
+        try {
+            output = await this.#toolchain.run(args, cwd, this.#hostPaths.home);
+        }
+        catch (cause) {
+            throw actionError("install-failed", 502, `Agent Skill '${definition.name}' could not be installed from '${definition.source}': ${messageOf(cause)}`, { name: definition.name, source: definition.source, scope: definition.scope, retryable: true }, cause);
+        }
+        const file = join(root, definition.name, "SKILL.md");
+        if (!(await isFile(file))) {
+            throw actionError("install-failed", 502, `The installer reported '${definition.name}' from '${definition.source}' but ${file} does not exist.`, { name: definition.name, source: definition.source, scope: definition.scope, output: stripVTControlCharacters(output).trim().slice(-2000), retryable: true });
+        }
+        return { name: definition.name, scope: definition.scope, dir: join(root, definition.name), file };
+    }
+    // {§skills-remove} — the coordinator forgets the Worker's own definition;
+    // the adapter uninstalls what that definition installed at its scope.
+    async forget(source, identity) {
+        const definition = source.definition;
+        const projectRoot = await this.#projectRoot(identity.workspaceId);
+        const root = this.#rootFor(definition.scope, projectRoot);
+        if (root === null)
+            return;
+        const dir = join(root, definition.name);
+        if (!(await exists(dir)))
+            return;
+        try {
+            await this.#toolchain.run(["remove", definition.name, "--yes", ...(definition.scope === "global" ? ["--global"] : [])], this.#cwdFor(definition.scope, projectRoot), this.#hostPaths.home);
+        }
+        catch (cause) {
+            throw actionError("uninstall-failed", 502, `Agent Skill '${definition.name}' could not be removed from its ${definition.scope} root: ${messageOf(cause)}`, { name: definition.name, scope: definition.scope, retryable: true }, cause);
+        }
+        if (await exists(dir))
+            throw actionError("uninstall-failed", 502, `The installer reported removal of '${definition.name}' but ${dir} still exists.`, { name: definition.name, scope: definition.scope, retryable: true });
+    }
+    async #locate(alias, definition, installed, projectRoot) {
+        const shadowing = installed.get(alias);
+        if (shadowing === undefined || shadowing.scope === definition.scope)
+            return shadowing;
+        // The Worker's own definition names a root below the one currently
+        // shadowing that name; the definition's scope is truth.
+        const root = this.#rootFor(definition.scope, projectRoot);
+        if (root === null)
+            return undefined;
+        const file = join(root, alias, "SKILL.md");
+        return (await isFile(file)) ? { name: alias, scope: definition.scope, dir: join(root, alias), file } : undefined;
+    }
+    async prepare(preparation) {
+        const projectRoot = await this.#projectRoot(preparation.workspaceId);
+        const installed = await this.#scan(projectRoot);
+        const previous = preparation.previous;
+        const carried = new Set(previous?.unavailable ?? []);
+        const outcomes = new Map();
+        const docs = [];
+        for (const [alias, raw] of preparation.enabled) {
+            const definition = raw;
+            try {
+                let located = await this.#locate(alias, definition, installed, projectRoot);
+                if (located === undefined) {
+                    const root = this.#rootFor(definition.scope, projectRoot);
+                    if (root === null)
+                        throw actionError("project-root-required", 409, `'${alias}' targets the project scope, but this workspace has no project root.`, { name: alias, retryable: false });
+                    if (definition.source === undefined)
+                        throw actionError("skill-missing", 404, `Agent Skill '${alias}' is not installed under its ${definition.scope} root.`, { name: alias, scope: definition.scope, root, retryable: false });
+                    located = await this.#install(definition, root, this.#cwdFor(definition.scope, projectRoot));
+                }
+                let doc;
+                try {
+                    doc = parseSkill(located.file, located.name, await readFile(located.file, "utf8"));
+                }
+                catch (cause) {
+                    throw actionError("skill-invalid", 422, `Agent Skill '${alias}' is not a valid standard skill: ${messageOf(cause)}`, { name: alias, scope: located.scope, path: located.file, retryable: false }, cause);
+                }
+                docs.push(doc);
+                outcomes.set(alias, { state: "active", detail: { scope: located.scope, path: located.dir, description: doc.description } });
+            }
+            catch (cause) {
+                if (!(cause instanceof SkillsActionError))
+                    throw cause;
+                const fresh = !carried.has(alias) || preparation.force === alias;
+                if (preparation.failure === "reject" && fresh)
+                    throw cause;
+                if (fresh)
+                    console.error(`Agent Skill '${alias}' unavailable: ${cause.problem.detail}`);
+                outcomes.set(alias, { state: "unavailable", problem: structuredClone(cause.problem) });
+            }
+        }
+        docs.sort((left, right) => left.name.localeCompare(right.name));
+        const documents = [
+            { pathname: "skills/index.md", content: renderIndex(docs) },
+            ...docs.map((doc) => ({ pathname: `skills/${encodeURIComponent(doc.name)}.md`, content: renderSkill(doc) })),
+        ];
+        const signature = await this.#signature(projectRoot);
+        const snapshot = {
+            signature,
+            unavailable: [...outcomes].filter(([, outcome]) => outcome.state === "unavailable").map(([alias]) => alias),
+        };
+        const { workerId } = preparation;
+        return {
+            runtimes: [],
+            documents,
+            outcomes,
+            snapshot,
+            commit: async () => { this.#signatures.set(workerId, signature); },
+            abort: async () => { },
+        };
+    }
+    async teardown(_snapshot, identity) {
+        this.#signatures.delete(identity.workerId);
+    }
+}
+//# sourceMappingURL=SkillsFunctionality.js.map

package/dist/server/SkillsFunctionality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillsFunctionality.js","sourceRoot":"","sources":["../../src/server/SkillsFunctionality.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,2EAA2E;AAC3E,yEAAyE;AACzE,6EAA6E;AAC7E,iFAAiF;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EACH,QAAQ,EACR,SAAS,GAMZ,MAAM,0BAA0B,CAAC;AAElC,OAAO,SAAS,MAAM,sBAAsB,CAAC;AAY7C,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAEtC,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CAAC;AACtC,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AACzD,MAAM,UAAU,GAAG,EAAE,IAAI,EAAE,oDAAoD,EAAgC,CAAC;AAChH,MAAM,UAAU,GAAG,6BAA6B,CAAC;AACjD,MAAM,WAAW,GAAG,kBAAkB,CAAC;AACvC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAC7C,MAAM,cAAc,GAAG,EAAE,CAAC;AAC1B,MAAM,cAAc,GAAG,OAAO,CAAC;AAwC/B,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC/B,OAAO,CAAiB;IAEjC,YAAY,OAAuB,EAAE,KAAe;QAChD,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;CACJ;AAED,MAAM,OAAO,GAAG,CACZ,IAAY,EACZ,MAAc,EACd,MAAc,EACd,UAAU,GAAsC,EAAE,EACpC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,sBAAsB,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;IAC/E,KAAK,EAAE,sBAAsB;IAC7B,SAAS,EAAE,MAAM,KAAK,GAAG,IAAI,MAAM,IAAI,GAAG;IAC1C,GAAG,UAAU;CAChB,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,CAChB,IAAY,EACZ,MAAc,EACd,MAAc,EACd,UAAU,GAAsC,EAAE,EAClD,KAAe,EACE,EAAE,CAAC,IAAI,iBAAiB,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;AAEhG,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CAClE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEzE,MAAM,SAAS,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAErG,MAAM,MAAM,GAAG,CAAC,IAAY,EAAoB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;AACzG,MAAM,MAAM,GAAG,CAAC,IAAY,EAAoB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;AAE5F,8EAA8E;AAC9E,wEAAwE;AACxE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,MAAc,EAAE,GAAW,EAAY,EAAE;IAC9E,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,yCAAyC,CAAC,CAAC;IAC1F,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACtC,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,yCAAyC,CAAC,CAAC;IACpF,IAAI,QAAiB,CAAC;IACtB,IAAI,CAAC;QACD,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IACnG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,2CAA2C,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,6CAA6C,CAAC,CAAC;IAC/F,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC;IACvC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,yCAAyC,CAAC,CAAC;IACrH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,sBAAsB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC5G,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,0CAA0C,CAAC,CAAC;IACzF,IAAI,IAAI,KAAK,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,sBAAsB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACtI,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,gDAAgD,CAAC,CAAC;IAC1I,IAAI,WAAW,CAAC,MAAM,GAAG,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,mDAAmD,CAAC,CAAC;IAC3G,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;AACjF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAa,EAAU,EAAE,CAAC;IAClD,KAAK,GAAG,CAAC,IAAI,EAAE;IACf,EAAE;IACF,YAAY;IACZ,EAAE;IACF,GAAG,CAAC,WAAW;IACf,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;CACnD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAA2B,EAAU,EAAE,CAAC;IAChE,UAAU;IACV,EAAE;IACF,YAAY;IACZ,EAAE;IACF,uCAAuC;IACvC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,OAAO,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;CACnF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,4EAA4E;AAC5E,0EAA0E;AAC1E,oEAAoE;AACpE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAc,EAAgD,EAAE;IACzF,MAAM,KAAK,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5E,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAiD,EAAE,CAAC;IAChE,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,+BAA+B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC;QAChC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;YACf,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;YACxE,SAAS;QACb,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,GAAG,CAAC;YAAE,SAAS;QAC/C,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,EAAE,EAAE,CAAC;IACvI,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,OAAO,uBAAuB;IACvB,QAAQ,CAAoB;IAC5B,SAAS,CAAgB;IAElC,YAAY,GAAG,GAAsB,OAAO,CAAC,GAAG;QAC5C,MAAM,GAAG,GAAG,GAAG,CAAC,yBAAyB,EAAE,IAAI,EAAE,CAAC;QAClD,IAAI,CAAC,QAAQ,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1F,MAAM,QAAQ,GAAG,GAAG,CAAC,kCAAkC,CAAC;QACxD,IAAI,CAAC,SAAS,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC5I,CAAC;IAED,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAuB,EAAE,GAAW,EAAE,IAAY;QACxD,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC3C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,OAAQ,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE;YACvE,GAAG;YACH,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE;YAC3D,OAAO,EAAE,cAAc;YACvB,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;SAC7B,CAAC,CAAC;QACH,OAAO,GAAG,MAAM,KAAK,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa;QACtB,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC1B,MAAM,WAAW,CAAC,yBAAyB,EAAE,GAAG,EAAE,kFAAkF,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QACvK,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,SAAS,eAAe,IAAI,eAAe,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,EAAE,CAAC;QAC/G,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACD,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,WAAW,CAAC,sBAAsB,EAAE,GAAG,EAAE,mBAAmB,IAAI,CAAC,SAAS,wBAAwB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;QAC3K,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,MAAM,WAAW,CAAC,mBAAmB,EAAE,GAAG,EAAE,mBAAmB,IAAI,CAAC,SAAS,aAAa,QAAQ,CAAC,MAAM,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/M,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA0B,CAAC;QAC3D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,MAAM,WAAW,CAAC,kBAAkB,EAAE,GAAG,EAAE,mBAAmB,IAAI,CAAC,SAAS,4BAA4B,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjM,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAmB,EAAE;YAClD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;gBAAE,OAAO,EAAE,CAAC;YAClG,OAAO,CAAC;oBACJ,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,MAAM,EAAE,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;oBAC9H,QAAQ,EAAE,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;iBACvE,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AAED,MAAM,CAAC,OAAO,OAAO,mBAAmB;IAC3B,MAAM,GAAG,aAAa,CAAC;IACvB,cAAc,GAAG,YAAY,CAAC;IAC9B,OAAO,GAAG,mGAAmG,CAAC;IAC9G,gBAAgB,GAAe,UAAU,CAAC;IAE1C,GAAG,CAAK;IACR,UAAU,CAAY;IACtB,UAAU,CAAkB;IAC5B,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjD,OAAO,GAAqC,IAAI,CAAC;IAEjD,YAAY,EAAE,EAAE,EAAE,SAAS,GAAG,IAAI,SAAS,EAAE,EAAE,SAAS,GAAG,IAAI,uBAAuB,EAAE,EAIvF;QACG,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QACd,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAChC,CAAC;IAED,MAAM,CAAC,MAAiC;QACpC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,WAAmB;QAClC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,GAAG,CAAkC,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;QAClH,OAAO,SAAS,EAAE,YAAY,IAAI,IAAI,CAAC;IAC3C,CAAC;IAED,QAAQ,CAAC,KAAY,EAAE,WAA0B;QAC7C,IAAI,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC;QAC/D,OAAO,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,CAAC,KAAY,EAAE,WAA0B;QAC5C,OAAO,KAAK,KAAK,QAAQ,IAAI,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC;IAC3F,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAY,EAAE,GAAW;QACxC,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACD,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,EAAE,CAAC;YAClE,MAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,2BAA2B,GAAG,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACrF,CAAC;QACD,MAAM,SAAS,GAAgB,EAAE,CAAC;QAClC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,SAAS,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC;YACvG,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAC/C,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC;gBAAE,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1G,CAAC;QACD,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACpF,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,KAAK,CAAC,WAA0B;QAClC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;QAC3C,KAAK,MAAM,KAAK,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAU,EAAE,CAAC;YACjD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;YAC9C,IAAI,GAAG,KAAK,IAAI;gBAAE,SAAS;YAC3B,KAAK,MAAM,SAAS,IAAI,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;gBAC1D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC;oBAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YACzE,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,4EAA4E;IAC5E,KAAK,CAAC,YAAY,CAAC,WAA0B;QACzC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC1C,KAAK,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,IAAI,GAAG,KAAK,IAAI;gBAAE,SAAS;YAC3B,IAAI,IAAa,CAAC;YAClB,IAAI,CAAC;gBACD,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YAC7E,CAAC;YAAC,MAAM,CAAC;gBACL,SAAS;YACb,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;gBAAE,SAAS;YACxD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtD,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;oBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YACnH,CAAC;QACL,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,WAA0B;QACvC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QAClC,KAAK,MAAM,SAAS,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/D,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACzG,IAAI,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,KAAK,IAAI,OAAO,GAAG,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,0EAA0E;IAC1E,2EAA2E;IAC3E,KAAK,CAAC,gBAAgB,CAAC,QAAkC;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC1D,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO;QACpC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;QACrF,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO;QAClC,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QAC9G,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAAkC;QAC9C,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;YACnE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC3C,MAAM,UAAU,GAAoB,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YAClI,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAChE,CAAC,CAAC,CAAC;IACP,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAiC,EAAE,QAAkC;QAChF,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACpC,MAAM,WAAW,CAAC,2BAA2B,EAAE,GAAG,EAAE,gHAAgH,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAChM,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;YACnF,IAAI,MAAc,CAAC;YACnB,IAAI,CAAC;gBACD,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC7F,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,MAAM,WAAW,CAAC,iBAAiB,EAAE,GAAG,EAAE,wBAAwB,MAAM,0BAA0B,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;YAC9J,CAAC;YACD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAA0B,EAAE,CAAC,CAAC;gBAChE,KAAK,EAAE,KAAK,CAAC,IAAI;gBACjB,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;gBACzE,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAA4B;gBACpF,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE;aACzC,CAAC,CAAC,CAAC;QACR,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3D,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAA4B,EAAE;YACxD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,OAAO,EAAE,CAAC;YAC5C,OAAO,CAAC;oBACJ,KAAK,EAAE,KAAK,CAAC,IAAI;oBACjB,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,QAAQ,WAAW,EAAE,CAAC;oBAC7E,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAA4B;oBAClG,UAAU,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,gBAAgB,IAAI,KAAK,CAAC,EAAE,EAAE,EAAE;iBACvG,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAc,EAAE,QAAkC;QAC1D,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,IAAI,UAA2B,CAAC;QAChC,IAAI,CAAC;YACD,UAAU,GAAG,eAAe,CAAC,SAAS,CAAC,qBAAqB,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAoB,CAAC,CAAC,CAAC;QACzH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,WAAW,CAAC,oBAAoB,EAAE,GAAG,EAAE,wCAAwC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;QACxH,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QAChF,IAAI,KAAK,KAAK,UAAU,CAAC,IAAI,EAAE,CAAC;YAC5B,MAAM,WAAW,CAAC,gBAAgB,EAAE,GAAG,EAAE,UAAU,KAAK,gCAAgC,UAAU,CAAC,IAAI,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QACrK,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,WAAW,CAAC,iBAAiB,EAAE,GAAG,EAAE,WAAW,KAAK,4DAA4D,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QACzJ,CAAC;QACD,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC;YAC3F,MAAM,WAAW,CAAC,uBAAuB,EAAE,GAAG,EAAE,IAAI,KAAK,sEAAsE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,uEAAuE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QACrP,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,UAA2B,EAAE,IAAY,EAAE,GAAW;QACjE,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,MAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,UAAU,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9J,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YACD,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACxE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,WAAW,CAAC,gBAAgB,EAAE,GAAG,EAAE,gBAAgB,UAAU,CAAC,IAAI,kCAAkC,UAAU,CAAC,MAAM,MAAM,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;QAChQ,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACrD,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACxB,MAAM,WAAW,CAAC,gBAAgB,EAAE,GAAG,EAAE,2BAA2B,UAAU,CAAC,IAAI,WAAW,UAAU,CAAC,MAAM,SAAS,IAAI,kBAAkB,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,wBAAwB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClT,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;IACtG,CAAC;IAED,0EAA0E;IAC1E,sEAAsE;IACtE,KAAK,CAAC,MAAM,CAAC,MAAqC,EAAE,QAAkC;QAClF,MAAM,UAAU,GAAG,MAAM,CAAC,UAA6B,CAAC;QACxD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAClE,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAC1D,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC;YAAE,OAAO;QACjC,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,UAAU,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/L,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,WAAW,CAAC,kBAAkB,EAAE,GAAG,EAAE,gBAAgB,UAAU,CAAC,IAAI,mCAAmC,UAAU,CAAC,KAAK,UAAU,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;QAC3O,CAAC;QACD,IAAI,MAAM,MAAM,CAAC,GAAG,CAAC;YAAE,MAAM,WAAW,CAAC,kBAAkB,EAAE,GAAG,EAAE,sCAAsC,UAAU,CAAC,IAAI,SAAS,GAAG,gBAAgB,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9N,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,UAA2B,EAAE,SAAiC,EAAE,WAA0B;QACnH,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,KAAK,UAAU,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QACtF,mEAAmE;QACnE,wDAAwD;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAC1D,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QAC3C,OAAO,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACrH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,WAAqC;QAC/C,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QACrE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,WAAW,CAAC,QAA2B,CAAC;QACzD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAgC,CAAC;QACzD,MAAM,IAAI,GAAe,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YAC7C,MAAM,UAAU,GAAG,GAAsB,CAAC;YAC1C,IAAI,CAAC;gBACD,IAAI,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;gBAC5E,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBACxB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;oBAC1D,IAAI,IAAI,KAAK,IAAI;wBAAE,MAAM,WAAW,CAAC,uBAAuB,EAAE,GAAG,EAAE,IAAI,KAAK,sEAAsE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;oBACvL,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS;wBAAE,MAAM,WAAW,CAAC,eAAe,EAAE,GAAG,EAAE,gBAAgB,KAAK,gCAAgC,UAAU,CAAC,KAAK,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;oBAC9N,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;gBACjG,CAAC;gBACD,IAAI,GAAa,CAAC;gBAClB,IAAI,CAAC;oBACD,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;gBACvF,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACb,MAAM,WAAW,CAAC,eAAe,EAAE,GAAG,EAAE,gBAAgB,KAAK,oCAAoC,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;gBAC7M,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACf,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAChI,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,IAAI,CAAC,CAAC,KAAK,YAAY,iBAAiB,CAAC;oBAAE,MAAM,KAAK,CAAC;gBACvD,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,KAAK,KAAK,KAAK,CAAC;gBACjE,IAAI,WAAW,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK;oBAAE,MAAM,KAAK,CAAC;gBAC3D,IAAI,KAAK;oBAAE,OAAO,CAAC,KAAK,CAAC,gBAAgB,KAAK,kBAAkB,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;gBACxF,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC3F,CAAC;QACL,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAChE,MAAM,SAAS,GAAG;YACd,EAAE,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE;YAC3D,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;SAC/G,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAa;YACvB,SAAS;YACT,WAAW,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC;SAC9G,CAAC;QACF,MAAM,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC;QACjC,OAAO;YACH,QAAQ,EAAE,EAAE;YACZ,SAAS;YACT,QAAQ;YACR,QAAQ;YACR,MAAM,EAAE,KAAK,IAAI,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;YAClE,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;SACxB,CAAC;IACN,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,SAAkB,EAAE,QAAkC;QACjE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;CACJ"}

package/dist/server/WorkerCapabilities.d.ts

@@ -0,0 +1,21 @@
+export type WorkerCapabilityRelease = () => void;
+export interface WorkerCapabilityPolicy {
+    readonly warmMs: number;
+    readonly warmMax: number;
+}
+export interface WorkerCapabilityCallbacks {
+    readonly activate: (workerId: number) => Promise<void>;
+    readonly deactivate: (workerId: number) => Promise<boolean>;
+    readonly report: (workerId: number, error: unknown) => void;
+}
+export declare const workerCapabilityPolicy: (env?: NodeJS.ProcessEnv) => WorkerCapabilityPolicy;
+export default class WorkerCapabilities {
+    #private;
+    constructor(policy: WorkerCapabilityPolicy, callbacks: WorkerCapabilityCallbacks);
+    acquire(workerId: number): Promise<WorkerCapabilityRelease>;
+    retain(workerId: number): WorkerCapabilityRelease;
+    activeWorkerIds(): number[];
+    isActive(workerId: number): boolean;
+    beginStop(): void;
+}
+//# sourceMappingURL=WorkerCapabilities.d.ts.map

package/dist/server/WorkerCapabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerCapabilities.d.ts","sourceRoot":"","sources":["../../src/server/WorkerCapabilities.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG,MAAM,IAAI,CAAC;AAEjD,MAAM,WAAW,sBAAsB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,yBAAyB;IACtC,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,QAAQ,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC/D;AAwBD,eAAO,MAAM,sBAAsB,SAC1B,MAAM,CAAC,UAAU,KACvB,sBAGD,CAAC;AAKH,MAAM,CAAC,OAAO,OAAO,kBAAkB;;IASnC,YACI,MAAM,EAAE,sBAAsB,EAC9B,SAAS,EAAE,yBAAyB,EAMvC;IAEK,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA2BhE;IAED,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,uBAAuB,CAUhD;IAED,eAAe,IAAI,MAAM,EAAE,CAK1B;IAED,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAElC;IAED,SAAS,IAAI,IAAI,CAIhB;CAgIJ"}