@exellix/ai-skills 5.8.0

package/dist/catalog/gateway-template.js

@@ -0,0 +1,15 @@
+/**
+ * nx-content / ai-gateway treat strings with **no whitespace** as registry keys.
+ * Ensure DB-sourced templates are always parsed as literal template text.
+ */
+export function ensureGatewayTreatsAsTemplateText(text) {
+    if (typeof text !== "string")
+        return text;
+    const t = text.trim();
+    if (t.length === 0)
+        return text;
+    if (/\s/.test(t))
+        return text;
+    return `${text}\n`;
+}
+//# sourceMappingURL=gateway-template.js.map

package/dist/catalog/gateway-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-template.js","sourceRoot":"","sources":["../../src/catalog/gateway-template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,iCAAiC,CAAC,IAAY;IAC1D,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACtB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,GAAG,IAAI,IAAI,CAAC;AACvB,CAAC"}

package/dist/catalog/index.d.ts

@@ -0,0 +1,3 @@
+export { canonicalSkillKey } from "./canonical-skill-key.js";
+export { ensureGatewayTreatsAsTemplateText } from "./gateway-template.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/catalog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/catalog/index.js

@@ -0,0 +1,3 @@
+export { canonicalSkillKey } from "./canonical-skill-key.js";
+export { ensureGatewayTreatsAsTemplateText } from "./gateway-template.js";
+//# sourceMappingURL=index.js.map

package/dist/catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/catalog/seed.d.ts

@@ -0,0 +1,12 @@
+import type { SkillCatalog } from "./skill-catalog.js";
+/** Canonical Mongo / xillix keys for skills that ship template seeds (subset of the Catalox catalog). */
+export declare const SEED_CANONICAL_SKILL_KEYS: `skills/${string}`[];
+export interface SeedXillixCatalogOptions {
+    /** Root folder containing `<id>.instructions.md` and `<id>.prompt.md` (default: `.metadata/skills`). */
+    templatesRoot?: string;
+}
+/**
+ * Idempotent upsert of built-in skills; loads template bodies from disk when present.
+ */
+export declare function seedXillixCatalog(catalog: SkillCatalog, options?: SeedXillixCatalogOptions): Promise<void>;
+//# sourceMappingURL=seed.d.ts.map

package/dist/catalog/seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../src/catalog/seed.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,yGAAyG;AACzG,eAAO,MAAM,yBAAyB,sBAA+D,CAAC;AAEtG,MAAM,WAAW,wBAAwB;IACrC,wGAAwG;IACxG,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAUD;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BpH"}

package/dist/catalog/seed.js

@@ -0,0 +1,45 @@
+import * as fs from "fs";
+import * as path from "path";
+import { AI_SKILLS_CATALOG_ITEMS, AI_SKILLS_MONGO_SEED_KEYS } from "../catalox/ai-skills-catalog.js";
+/** Canonical Mongo / xillix keys for skills that ship template seeds (subset of the Catalox catalog). */
+export const SEED_CANONICAL_SKILL_KEYS = AI_SKILLS_MONGO_SEED_KEYS.map((k) => `skills/${k}`);
+function readOptionalUtf8(filePath) {
+    try {
+        return fs.readFileSync(filePath, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Idempotent upsert of built-in skills; loads template bodies from disk when present.
+ */
+export async function seedXillixCatalog(catalog, options = {}) {
+    const root = options.templatesRoot ?? path.join(process.cwd(), ".metadata", "skills");
+    for (const spec of AI_SKILLS_CATALOG_ITEMS) {
+        if (!spec.xillixSeed)
+            continue;
+        const skillKey = `skills/${spec.skillKey}`;
+        const xs = spec.xillixSeed;
+        const id = spec.skillKey;
+        const instructionsText = readOptionalUtf8(path.join(root, `${id}.instructions.md`));
+        const promptText = readOptionalUtf8(path.join(root, `${id}.prompt.md`));
+        await catalog.upsert({
+            skillKey,
+            displayName: spec.title,
+            description: spec.description,
+            lifecycle: "active",
+            tags: ["xeonox", "seed"],
+            deletedAt: null,
+            outputFrame: xs.outputFrame,
+            requiredVariables: xs.requiredVariables,
+            optionalVariables: xs.optionalVariables,
+            outputSchema: xs.outputSchema,
+            inputHints: { variables: { required: xs.requiredVariables, optional: xs.optionalVariables } },
+            outputHints: { frame: xs.outputFrame },
+            ...(instructionsText !== undefined ? { instructionsText } : {}),
+            ...(promptText !== undefined ? { promptText } : {}),
+        });
+    }
+}
+//# sourceMappingURL=seed.js.map

package/dist/catalog/seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.js","sourceRoot":"","sources":["../../src/catalog/seed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAGrG,yGAAyG;AACzG,MAAM,CAAC,MAAM,yBAAyB,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,EAAW,CAAC,CAAC;AAOtG,SAAS,gBAAgB,CAAC,QAAgB;IACtC,IAAI,CAAC;QACD,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAqB,EAAE,UAAoC,EAAE;IACjG,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAEtF,KAAK,MAAM,IAAI,IAAI,uBAAuB,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,SAAS;QAC/B,MAAM,QAAQ,GAAG,UAAU,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;QAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QACzB,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAC;QACpF,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC;QACxE,MAAM,OAAO,CAAC,MAAM,CAAC;YACjB,QAAQ;YACR,WAAW,EAAE,IAAI,CAAC,KAAK;YACvB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,QAAQ;YACnB,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;YACxB,SAAS,EAAE,IAAI;YACf,WAAW,EAAE,EAAE,CAAC,WAAW;YAC3B,iBAAiB,EAAE,EAAE,CAAC,iBAAiB;YACvC,iBAAiB,EAAE,EAAE,CAAC,iBAAiB;YACvC,YAAY,EAAE,EAAE,CAAC,YAAY;YAC7B,UAAU,EAAE,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,iBAAiB,EAAE,QAAQ,EAAE,EAAE,CAAC,iBAAiB,EAAE,EAAE;YAC7F,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,WAAW,EAAE;YACtC,GAAG,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD,CAAC,CAAC;IACP,CAAC;AACL,CAAC"}

package/dist/catalog/skill-catalog.d.ts

@@ -0,0 +1,28 @@
+import type { XronoxStore } from "@xronoces/xronox-store";
+import type { AiSkillCatalogDocument, SkillCatalogListOptions, SkillCatalogPatchOptions } from "./types.js";
+export declare class SkillCatalog {
+    private readonly store;
+    constructor(store: XronoxStore);
+    private col;
+    create(doc: Omit<AiSkillCatalogDocument, "catalogVersion" | "createdAt" | "updatedAt" | "deletedAt"> & {
+        deletedAt?: null;
+    }): Promise<void>;
+    get(skillKey: string, opts?: {
+        includeHidden?: boolean;
+    }): Promise<AiSkillCatalogDocument | null>;
+    patch(skillKey: string, fields: Partial<AiSkillCatalogDocument>, opts?: SkillCatalogPatchOptions): Promise<void>;
+    /** Soft-delete: sets `deletedAt` and optional lifecycle. */
+    archive(skillKey: string, opts?: SkillCatalogPatchOptions & {
+        lifecycle?: "deprecated";
+    }): Promise<void>;
+    /**
+     * Hard-remove catalog row. Only when not production and `XILLIX_ALLOW_HARD_DELETE=true`.
+     */
+    hardDelete(skillKey: string): Promise<void>;
+    list(options?: SkillCatalogListOptions): Promise<AiSkillCatalogDocument[]>;
+    /**
+     * Insert or full replace by `skillKey` (upsert). Used by seeds and migrations.
+     */
+    upsert(doc: Omit<AiSkillCatalogDocument, "catalogVersion" | "createdAt" | "updatedAt"> & Partial<Pick<AiSkillCatalogDocument, "catalogVersion" | "createdAt" | "updatedAt">>): Promise<void>;
+}
+//# sourceMappingURL=skill-catalog.d.ts.map

package/dist/catalog/skill-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-catalog.d.ts","sourceRoot":"","sources":["../../src/catalog/skill-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAsB5G,qBAAa,YAAY;IACT,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,WAAW;IAE/C,OAAO,CAAC,GAAG;IAIL,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,sBAAsB,EAAE,gBAAgB,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB3I,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IASjG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,sBAAsB,CAAC,EAAE,IAAI,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBtH,4DAA4D;IACtD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,wBAAwB,GAAG;QAAE,SAAS,CAAC,EAAE,YAAY,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAW9G;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3C,IAAI,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAiCpF;;OAEG;IACG,MAAM,CACR,GAAG,EAAE,IAAI,CAAC,sBAAsB,EAAE,gBAAgB,GAAG,WAAW,GAAG,WAAW,CAAC,GAC3E,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,gBAAgB,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC,GACxF,OAAO,CAAC,IAAI,CAAC;CAmBnB"}

package/dist/catalog/skill-catalog.js

@@ -0,0 +1,139 @@
+import { AI_SKILL_CATALOG_COLLECTION } from "./constants.js";
+import { isXillixHardDeleteAllowed } from "./env.js";
+import { SkillCatalogDuplicateKeyError, SkillCatalogNotFoundError, SkillCatalogVersionConflictError, } from "./types.js";
+function isDuplicateKeyError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg.includes("E11000") || msg.includes("11000"))
+        return true;
+    const code = err?.code;
+    return code === 11000;
+}
+function stripUndefined(o) {
+    const out = { ...o };
+    for (const k of Object.keys(out)) {
+        if (out[k] === undefined)
+            delete out[k];
+    }
+    return out;
+}
+export class SkillCatalog {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    col() {
+        return this.store.collection(AI_SKILL_CATALOG_COLLECTION);
+    }
+    async create(doc) {
+        const now = new Date().toISOString();
+        const row = {
+            ...doc,
+            catalogVersion: 1,
+            createdAt: now,
+            updatedAt: now,
+            deletedAt: doc.deletedAt ?? null,
+        };
+        try {
+            await this.col().insert(stripUndefined(row));
+        }
+        catch (err) {
+            if (isDuplicateKeyError(err)) {
+                throw new SkillCatalogDuplicateKeyError(doc.skillKey);
+            }
+            throw err;
+        }
+    }
+    async get(skillKey, opts) {
+        if (opts?.includeHidden) {
+            const r = await this.col().readMany({ skillKey }, { includeHidden: true, limit: 1 });
+            return r[0] ?? null;
+        }
+        const row = await this.col().getByKey(skillKey);
+        return row;
+    }
+    async patch(skillKey, fields, opts) {
+        const cur = await this.get(skillKey, { includeHidden: true });
+        if (!cur)
+            throw new SkillCatalogNotFoundError(skillKey);
+        if (opts?.expectedVersion !== undefined && cur.catalogVersion !== opts.expectedVersion) {
+            throw new SkillCatalogVersionConflictError(skillKey);
+        }
+        const nextVersion = (cur.catalogVersion ?? 0) + 1;
+        const { skillKey: _sk, catalogVersion: _cv, createdAt: _ca, ...rest } = fields;
+        const patch = stripUndefined({
+            ...rest,
+            catalogVersion: nextVersion,
+            updatedAt: new Date().toISOString(),
+        });
+        await this.col().patchByKey(skillKey, patch);
+    }
+    /** Soft-delete: sets `deletedAt` and optional lifecycle. */
+    async archive(skillKey, opts) {
+        await this.patch(skillKey, {
+            deletedAt: new Date().toISOString(),
+            lifecycle: opts?.lifecycle ?? "deprecated",
+        }, opts);
+    }
+    /**
+     * Hard-remove catalog row. Only when not production and `XILLIX_ALLOW_HARD_DELETE=true`.
+     */
+    async hardDelete(skillKey) {
+        if (!isXillixHardDeleteAllowed()) {
+            throw new Error("[AI-SKILLS] hardDelete is only allowed when NODE_ENV !== 'production' and XILLIX_ALLOW_HARD_DELETE=true");
+        }
+        const n = await this.col().deleteMany({ skillKey }, { includeHidden: true, clearCache: "all" });
+        if (n < 1)
+            throw new SkillCatalogNotFoundError(skillKey);
+    }
+    async list(options = {}) {
+        const scanLimit = options.scanLimit ?? 10_000;
+        const rows = await this.col().readMany({}, { includeHidden: options.includeHidden === true, limit: scanLimit, sort: { skillKey: 1 } });
+        let out = rows;
+        if (options.activeOnly) {
+            out = out.filter((r) => r.lifecycle === "active" && (r.deletedAt === null || r.deletedAt === undefined));
+        }
+        if (options.tag) {
+            out = out.filter((r) => Array.isArray(r.tags) && r.tags.includes(options.tag));
+        }
+        if (options.skillKeyPrefix) {
+            const p = options.skillKeyPrefix;
+            out = out.filter((r) => typeof r.skillKey === "string" && r.skillKey.startsWith(p));
+        }
+        if (options.updatedAfter) {
+            const after = new Date(options.updatedAfter).getTime();
+            out = out.filter((r) => {
+                const t = Date.parse(r.updatedAt);
+                return !Number.isNaN(t) && t > after;
+            });
+        }
+        const offset = options.offset ?? 0;
+        const limit = options.limit;
+        if (offset > 0 || limit !== undefined) {
+            const end = limit === undefined ? undefined : offset + limit;
+            out = out.slice(offset, end);
+        }
+        return out;
+    }
+    /**
+     * Insert or full replace by `skillKey` (upsert). Used by seeds and migrations.
+     */
+    async upsert(doc) {
+        const existing = await this.get(doc.skillKey, { includeHidden: true });
+        const now = new Date().toISOString();
+        if (!existing) {
+            const { catalogVersion: _cv, createdAt: _c, updatedAt: _u, ...forCreate } = doc;
+            await this.create(forCreate);
+            return;
+        }
+        const nextVersion = doc.catalogVersion !== undefined ? doc.catalogVersion : (existing.catalogVersion ?? 0) + 1;
+        const merged = {
+            ...existing,
+            ...doc,
+            catalogVersion: nextVersion,
+            updatedAt: doc.updatedAt ?? now,
+            createdAt: existing.createdAt,
+        };
+        await this.col().update(doc.skillKey, stripUndefined(merged));
+    }
+}
+//# sourceMappingURL=skill-catalog.js.map

package/dist/catalog/skill-catalog.js.map

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

package/dist/catalog/store-factory.d.ts

@@ -0,0 +1,18 @@
+import { XronoxStore } from "@xronoces/xronox-store";
+import { SkillCatalog } from "./skill-catalog.js";
+export interface CreateSkillCatalogStoreOptions {
+    mongoUri?: string;
+    mongoDb?: string;
+}
+export interface SkillCatalogStoreBundle {
+    store: XronoxStore;
+    catalog: SkillCatalog;
+    init: () => Promise<void>;
+    close: () => Promise<void>;
+}
+/**
+ * Creates an `XronoxStore` scoped to `XILLIX_META_DB` (or `mongoDb`) and a {@link SkillCatalog} facade.
+ * Call `init()` before CRUD; call `close()` when finished.
+ */
+export declare function createSkillCatalogStore(options?: CreateSkillCatalogStoreOptions): SkillCatalogStoreBundle;
+//# sourceMappingURL=store-factory.d.ts.map

package/dist/catalog/store-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-factory.d.ts","sourceRoot":"","sources":["../../src/catalog/store-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAIrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AASlD,MAAM,WAAW,8BAA8B;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACpC,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,8BAAmC,GAAG,uBAAuB,CAoB7G"}

package/dist/catalog/store-factory.js

@@ -0,0 +1,36 @@
+import { XronoxStore } from "@xronoces/xronox-store";
+import { AI_SKILL_CATALOG_COLLECTION } from "./constants.js";
+import { getXillixMetaDbName } from "./env.js";
+import { SkillCatalog } from "./skill-catalog.js";
+const catalogCollectionDefinition = {
+    name: AI_SKILL_CATALOG_COLLECTION,
+    primaryKey: "skillKey",
+    indexes: [{ keys: { skillKey: 1 }, options: { unique: true, name: "uniq_skillKey" } }],
+    visibility: { field: "deletedAt", mode: "hiddenIfNonNull" },
+};
+/**
+ * Creates an `XronoxStore` scoped to `XILLIX_META_DB` (or `mongoDb`) and a {@link SkillCatalog} facade.
+ * Call `init()` before CRUD; call `close()` when finished.
+ */
+export function createSkillCatalogStore(options = {}) {
+    const mongoUri = options.mongoUri ?? process.env.MONGO_URI?.trim();
+    if (!mongoUri) {
+        throw new Error("[AI-SKILLS] createSkillCatalogStore: MONGO_URI is required (or pass mongoUri).");
+    }
+    const mongoDb = options.mongoDb ?? getXillixMetaDbName();
+    const store = new XronoxStore({
+        mongoUri,
+        mongoDb,
+        collections: [catalogCollectionDefinition],
+        // Surface duplicate key and other persist errors to callers (catalog API maps E11000).
+        errorHandling: { onPersistError: "throw" },
+    });
+    const catalog = new SkillCatalog(store);
+    return {
+        store,
+        catalog,
+        init: () => store.init(),
+        close: () => store.close(),
+    };
+}
+//# sourceMappingURL=store-factory.js.map

package/dist/catalog/store-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-factory.js","sourceRoot":"","sources":["../../src/catalog/store-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,2BAA2B,GAAyB;IACtD,IAAI,EAAE,2BAA2B;IACjC,UAAU,EAAE,UAAU;IACtB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,CAAC;IACtF,UAAU,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,EAAE;CAC9D,CAAC;AAcF;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAA0C,EAAE;IAChF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;IACnE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAC;IACtG,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,mBAAmB,EAAE,CAAC;IACzD,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC;QAC1B,QAAQ;QACR,OAAO;QACP,WAAW,EAAE,CAAC,2BAA2B,CAAC;QAC1C,uFAAuF;QACvF,aAAa,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE;KAC7C,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO;QACH,KAAK;QACL,OAAO;QACP,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE;QACxB,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE;KAC7B,CAAC;AACN,CAAC"}

package/dist/catalog/types.d.ts

@@ -0,0 +1,61 @@
+export type SkillLifecycle = "active" | "deprecated";
+/**
+ * Authoritative catalog row for a remote AI task skill (`skills/...` key).
+ * Template fields back optional xillix content mode (inline gateway templates).
+ */
+export interface AiSkillCatalogDocument {
+    skillKey: string;
+    displayName?: string;
+    description?: string;
+    inputHints?: Record<string, unknown>;
+    outputHints?: Record<string, unknown>;
+    /** System / instruction template body (FlexMD + tokens). */
+    instructionsText?: string;
+    /** User prompt template body (typically contains `{{input}}`). */
+    promptText?: string;
+    lifecycle: SkillLifecycle;
+    tags?: string[];
+    /** Monotonic document version for optimistic concurrency. */
+    catalogVersion: number;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt?: string | null;
+    /** FlexMD frame name after successful run (e.g. professional-answer). */
+    outputFrame?: string;
+    /** Optional JSON-schema-shaped hint for parsed output. */
+    outputSchema?: Record<string, unknown>;
+    requiredVariables?: string[];
+    optionalVariables?: string[];
+}
+export interface SkillCatalogListOptions {
+    /** Only `lifecycle === 'active'` and not soft-deleted. */
+    activeOnly?: boolean;
+    /** Match any catalog whose `tags` contains this string. */
+    tag?: string;
+    /** `skillKey.startsWith(prefix)` */
+    skillKeyPrefix?: string;
+    /** ISO date string — keep rows with `updatedAt` strictly after this instant. */
+    updatedAfter?: string;
+    /** Include soft-deleted rows (admin). */
+    includeHidden?: boolean;
+    /** Max rows to scan from store before in-memory filtering (catalog-sized). */
+    scanLimit?: number;
+    offset?: number;
+    limit?: number;
+}
+export interface SkillCatalogPatchOptions {
+    expectedVersion?: number;
+}
+export declare class SkillCatalogDuplicateKeyError extends Error {
+    readonly code: "SKILL_CATALOG_DUPLICATE_KEY";
+    constructor(skillKey: string);
+}
+export declare class SkillCatalogVersionConflictError extends Error {
+    readonly code: "SKILL_CATALOG_VERSION_CONFLICT";
+    constructor(skillKey: string);
+}
+export declare class SkillCatalogNotFoundError extends Error {
+    readonly code: "SKILL_CATALOG_NOT_FOUND";
+    constructor(skillKey: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/catalog/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/catalog/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,YAAY,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,cAAc,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,6DAA6D;IAC7D,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACpC,0DAA0D;IAC1D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,6BAA8B,SAAQ,KAAK;IACpD,QAAQ,CAAC,IAAI,EAAG,6BAA6B,CAAU;gBAC3C,QAAQ,EAAE,MAAM;CAI/B;AAED,qBAAa,gCAAiC,SAAQ,KAAK;IACvD,QAAQ,CAAC,IAAI,EAAG,gCAAgC,CAAU;gBAC9C,QAAQ,EAAE,MAAM;CAI/B;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,EAAG,yBAAyB,CAAU;gBACvC,QAAQ,EAAE,MAAM;CAI/B"}

package/dist/catalog/types.js

@@ -0,0 +1,22 @@
+export class SkillCatalogDuplicateKeyError extends Error {
+    code = "SKILL_CATALOG_DUPLICATE_KEY";
+    constructor(skillKey) {
+        super(`Skill catalog already has an entry for skillKey: ${skillKey}`);
+        this.name = "SkillCatalogDuplicateKeyError";
+    }
+}
+export class SkillCatalogVersionConflictError extends Error {
+    code = "SKILL_CATALOG_VERSION_CONFLICT";
+    constructor(skillKey) {
+        super(`Skill catalog version conflict for skillKey: ${skillKey}`);
+        this.name = "SkillCatalogVersionConflictError";
+    }
+}
+export class SkillCatalogNotFoundError extends Error {
+    code = "SKILL_CATALOG_NOT_FOUND";
+    constructor(skillKey) {
+        super(`Skill catalog entry not found: ${skillKey}`);
+        this.name = "SkillCatalogNotFoundError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/catalog/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/catalog/types.ts"],"names":[],"mappings":"AAoDA,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IAC3C,IAAI,GAAG,6BAAsC,CAAC;IACvD,YAAY,QAAgB;QACxB,KAAK,CAAC,oDAAoD,QAAQ,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAChD,CAAC;CACJ;AAED,MAAM,OAAO,gCAAiC,SAAQ,KAAK;IAC9C,IAAI,GAAG,gCAAyC,CAAC;IAC1D,YAAY,QAAgB;QACxB,KAAK,CAAC,gDAAgD,QAAQ,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAC;IACnD,CAAC;CACJ;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACvC,IAAI,GAAG,yBAAkC,CAAC;IACnD,YAAY,QAAgB;QACxB,KAAK,CAAC,kCAAkC,QAAQ,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC5C,CAAC;CACJ"}

package/dist/catalox/ai-engines-catalog.d.ts

@@ -0,0 +1,24 @@
+import type { CatalogDescriptor } from "@x12i/catalox";
+/** Catalox native catalog id for AI execution engines routable from {@link RunSkillRequest}. */
+export declare const AI_ENGINES_CATALOG_ID: "ai-engines";
+/**
+ * Default app binding for {@link AI_ENGINES_CATALOG_ID} (same app as `ai-skills` so one provision flow can attach both).
+ */
+export declare const AI_ENGINES_APP_ID: "ai-skills";
+/** Descriptor version written by {@link scripts/provision-ai-engines-catalog}. */
+export declare const AI_ENGINES_DESCRIPTOR_VERSION: "1";
+export declare const DEFAULT_AI_ENGINE_CATALOG_ITEM_ID: "ai-gateway";
+/** Single supported runtime engine; catalog still lists it for discovery / UIs (`npm run catalox:provision-ai-engines`). */
+export declare const AI_ENGINE_CATALOG_ITEM_IDS: readonly ["ai-gateway"];
+export type AiEngineCatalogItemId = (typeof AI_ENGINE_CATALOG_ITEM_IDS)[number];
+export type AiEnginesCatalogItemSpec = {
+    engineId: AiEngineCatalogItemId;
+    title: string;
+    description: string;
+};
+/**
+ * Authoritative in-repo list for Catalox provisioning. Live discovery uses Catalox `listCatalogItems`.
+ */
+export declare const AI_ENGINES_CATALOG_ITEMS: readonly AiEnginesCatalogItemSpec[];
+export declare function buildAiEnginesCatalogDescriptor(): CatalogDescriptor;
+//# sourceMappingURL=ai-engines-catalog.d.ts.map

package/dist/catalox/ai-engines-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-engines-catalog.d.ts","sourceRoot":"","sources":["../../src/catalox/ai-engines-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAIvD,gGAAgG;AAChG,eAAO,MAAM,qBAAqB,EAAG,YAAqB,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,iBAAiB,aAAmB,CAAC;AAElD,kFAAkF;AAClF,eAAO,MAAM,6BAA6B,EAAG,GAAY,CAAC;AAE1D,eAAO,MAAM,iCAAiC,EAAG,YAAqB,CAAC;AAEvE,4HAA4H;AAC5H,eAAO,MAAM,0BAA0B,yBAA0B,CAAC;AAElE,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhF,MAAM,MAAM,wBAAwB,GAAG;IACnC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,wBAAwB,EAM9D,CAAC;AAEX,wBAAgB,+BAA+B,IAAI,iBAAiB,CAiEnE"}

package/dist/catalox/ai-engines-catalog.js

@@ -0,0 +1,89 @@
+import { AI_SKILLS_APP_ID } from "./ai-skills-catalog.js";
+/** Catalox native catalog id for AI execution engines routable from {@link RunSkillRequest}. */
+export const AI_ENGINES_CATALOG_ID = "ai-engines";
+/**
+ * Default app binding for {@link AI_ENGINES_CATALOG_ID} (same app as `ai-skills` so one provision flow can attach both).
+ */
+export const AI_ENGINES_APP_ID = AI_SKILLS_APP_ID;
+/** Descriptor version written by {@link scripts/provision-ai-engines-catalog}. */
+export const AI_ENGINES_DESCRIPTOR_VERSION = "1";
+export const DEFAULT_AI_ENGINE_CATALOG_ITEM_ID = "ai-gateway";
+/** Single supported runtime engine; catalog still lists it for discovery / UIs (`npm run catalox:provision-ai-engines`). */
+export const AI_ENGINE_CATALOG_ITEM_IDS = ["ai-gateway"];
+/**
+ * Authoritative in-repo list for Catalox provisioning. Live discovery uses Catalox `listCatalogItems`.
+ */
+export const AI_ENGINES_CATALOG_ITEMS = [
+    {
+        engineId: "ai-gateway",
+        title: "AI Gateway",
+        description: "LLM execution via @x12i/ai-gateway (inline Catalox templates on invoke).",
+    },
+];
+export function buildAiEnginesCatalogDescriptor() {
+    return {
+        catalogId: AI_ENGINES_CATALOG_ID,
+        label: "AI engines",
+        description: "Execution engines for @exellix/ai-skills (Catalox native).",
+        itemLabel: "Engine",
+        sourceMode: "native",
+        status: "active",
+        visibility: "visible",
+        defaultSort: { field: "engineId", direction: "asc" },
+        capabilities: {
+            canList: true,
+            canGet: true,
+            canCreate: true,
+            canEdit: true,
+            canDelete: true,
+            canImport: true,
+            canExport: true,
+            canValidate: true,
+            canViewReferences: true,
+        },
+        queryableFields: [
+            {
+                key: "engineId",
+                label: "Engine id",
+                type: "string",
+                path: "engineId",
+                indexed: true,
+                filterable: true,
+                sortable: true,
+                listVisible: true,
+                detailVisible: true,
+                required: true,
+            },
+            {
+                key: "title",
+                label: "Title",
+                type: "string",
+                path: "title",
+                indexed: false,
+                filterable: false,
+                sortable: true,
+                listVisible: true,
+                detailVisible: true,
+                required: true,
+            },
+            {
+                key: "description",
+                label: "Description",
+                type: "string",
+                path: "description",
+                indexed: false,
+                filterable: false,
+                sortable: false,
+                listVisible: true,
+                detailVisible: true,
+                required: true,
+            },
+        ],
+        identity: {
+            itemIdStrategy: "natural",
+            itemIdField: "engineId",
+            titleField: "title",
+        },
+    };
+}
+//# sourceMappingURL=ai-engines-catalog.js.map

package/dist/catalox/ai-engines-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-engines-catalog.js","sourceRoot":"","sources":["../../src/catalox/ai-engines-catalog.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,gGAAgG;AAChG,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAqB,CAAC;AAE3D;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAElD,kFAAkF;AAClF,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAY,CAAC;AAE1D,MAAM,CAAC,MAAM,iCAAiC,GAAG,YAAqB,CAAC;AAEvE,4HAA4H;AAC5H,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,YAAY,CAAU,CAAC;AAUlE;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAwC;IACzE;QACI,QAAQ,EAAE,YAAY;QACtB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,0EAA0E;KAC1F;CACK,CAAC;AAEX,MAAM,UAAU,+BAA+B;IAC3C,OAAO;QACH,SAAS,EAAE,qBAAqB;QAChC,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,4DAA4D;QACzE,SAAS,EAAE,QAAQ;QACnB,UAAU,EAAE,QAAQ;QACpB,MAAM,EAAE,QAAQ;QAChB,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE;QACpD,YAAY,EAAE;YACV,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,IAAI;YACf,WAAW,EAAE,IAAI;YACjB,iBAAiB,EAAE,IAAI;SAC1B;QACD,eAAe,EAAE;YACb;gBACI,GAAG,EAAE,UAAU;gBACf,KAAK,EAAE,WAAW;gBAClB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,IAAI;gBACjB,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE,IAAI;aACjB;YACD;gBACI,GAAG,EAAE,OAAO;gBACZ,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,KAAK;gBACd,UAAU,EAAE,KAAK;gBACjB,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,IAAI;gBACjB,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE,IAAI;aACjB;YACD;gBACI,GAAG,EAAE,aAAa;gBAClB,KAAK,EAAE,aAAa;gBACpB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,KAAK;gBACd,UAAU,EAAE,KAAK;gBACjB,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,IAAI;gBACjB,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE,IAAI;aACjB;SACJ;QACD,QAAQ,EAAE;YACN,cAAc,EAAE,SAAS;YACzB,WAAW,EAAE,UAAU;YACvB,UAAU,EAAE,OAAO;SACtB;KACJ,CAAC;AACN,CAAC"}

package/dist/catalox/ai-skills-catalog.d.ts

@@ -0,0 +1,32 @@
+import type { CatalogDescriptor } from "@x12i/catalox";
+/** Catalox `catalogId` and default `appId` for published skill discovery. */
+export declare const AI_SKILLS_CATALOG_ID: "ai-skills";
+export declare const AI_SKILLS_APP_ID: "ai-skills";
+/** Descriptor version written by {@link scripts/provision-ai-skills-catalog}. */
+export declare const AI_SKILLS_DESCRIPTOR_VERSION: "1";
+export type CatalogReleaseStatus = "draft" | "published";
+/**
+ * One skill row definition in-repo (provision writes native Catalox `data` + templates from disk when present).
+ */
+export type AiSkillsCatalogItemSpec = {
+    skillKey: string;
+    title: string;
+    description: string;
+    isLocal: boolean;
+    /**
+     * When both `instructionsText` and `promptText` exist after provision, this becomes Catalox `data.status`
+     * (`draft` or `published`). If omitted and bodies are complete, provision defaults to `draft`.
+     */
+    catalogReleaseStatus?: CatalogReleaseStatus;
+};
+/**
+ * Authoritative in-repo list for Catalox provisioning and package docs.
+ * Downstream consumers should call Catalox `listCatalogItems` for the live list.
+ */
+export declare const AI_SKILLS_CATALOG_ITEMS: readonly AiSkillsCatalogItemSpec[];
+export declare function buildAiSkillsCatalogDescriptor(): CatalogDescriptor;
+/**
+ * Computes Catalox `data.status` after template bodies are merged.
+ */
+export declare function computeSkillRowStatus(instructionsText: string | undefined, promptText: string | undefined, catalogReleaseStatus: CatalogReleaseStatus | undefined): "planned" | "draft" | "published";
+//# sourceMappingURL=ai-skills-catalog.d.ts.map

package/dist/catalox/ai-skills-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-skills-catalog.d.ts","sourceRoot":"","sources":["../../src/catalox/ai-skills-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,6EAA6E;AAC7E,eAAO,MAAM,oBAAoB,EAAG,WAAoB,CAAC;AACzD,eAAO,MAAM,gBAAgB,EAAG,WAAoB,CAAC;AAErD,iFAAiF;AACjF,eAAO,MAAM,4BAA4B,EAAG,GAAY,CAAC;AAEzD,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,WAAW,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC/C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,uBAAuB,EAwC5D,CAAC;AAEX,wBAAgB,8BAA8B,IAAI,iBAAiB,CA2IlE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACjC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,oBAAoB,EAAE,oBAAoB,GAAG,SAAS,GACvD,SAAS,GAAG,OAAO,GAAG,WAAW,CAMnC"}