@exellix/ai-skills 5.8.0

package/dist/catalox/skill-template-catalog-mutations.d.ts.map

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

package/dist/catalox/skill-template-catalog-mutations.js

@@ -0,0 +1,470 @@
+import { AI_SKILLS_CATALOG_ID, computeSkillRowStatus } from "./ai-skills-catalog.js";
+import { CataloxSkillAlreadyExistsError, CataloxSkillNotFoundError } from "./catalox-skill-errors.js";
+import { catalogItemIdFromSkillKey } from "./skill-templates.js";
+import { extractTemplateTokensFromTexts, extractTokenNamesFromStrings, normalizeForStorage, toPresentationMarkdown, } from "./skill-template-markdown.js";
+/** Stable role ids for template bodies (matches Catalox `*Text` fields). */
+export const SKILL_TEMPLATE_ROLES_ORDER = ["instructions", "prompt", "auditInstructions", "auditPrompt"];
+function isSkillTemplateRole(s) {
+    return SKILL_TEMPLATE_ROLES_ORDER.includes(s);
+}
+function appendParentSkillKeyIfPresent(data, payload) {
+    const p = asString(data.parentSkillKey);
+    if (p.length > 0) {
+        payload.parentSkillKey = p;
+    }
+}
+function asSkillCatalogStatus(v) {
+    if (v === "draft" || v === "published" || v === "planned")
+        return v;
+    return "planned";
+}
+function asString(v) {
+    return typeof v === "string" ? v : "";
+}
+/**
+ * Loads skill template bodies from Catalox and returns markdown formatted for editors / presentation.
+ * Requires Catalox read access for `appId` + catalog binding.
+ */
+export async function getSkillTemplatesForPresentation(catalox, context, skillKey, options = {}) {
+    const catalogItemId = catalogItemIdFromSkillKey(skillKey);
+    const res = await catalox.getCatalogItem(context, AI_SKILLS_CATALOG_ID, catalogItemId);
+    if (res.outcome === "not_found") {
+        throw new CataloxSkillNotFoundError(skillKey, catalogItemId);
+    }
+    if (res.outcome === "mapping_blocked") {
+        throw new Error(`[AI-SKILLS] Catalox mapping blocked for skill ${catalogItemId}`);
+    }
+    const data = (res.item.data ?? {});
+    const shortKey = asString(data.skillKey) || catalogItemId;
+    const ins = asString(data.instructionsText);
+    const pr = asString(data.promptText);
+    const out = {
+        skillKey: shortKey,
+        catalogItemId,
+        status: asSkillCatalogStatus(data.status),
+        title: asString(data.title) || shortKey,
+        description: asString(data.description),
+        isLocal: data.isLocal === true,
+        instructionsMarkdown: ins ? toPresentationMarkdown(ins) : "",
+        promptMarkdown: pr ? toPresentationMarkdown(pr) : "",
+    };
+    if (options.includeAudit === true) {
+        const ains = asString(data.auditInstructionsText);
+        const apr = asString(data.auditPromptText);
+        if (ains)
+            out.auditInstructionsMarkdown = toPresentationMarkdown(ains);
+        if (apr)
+            out.auditPromptMarkdown = toPresentationMarkdown(apr);
+    }
+    return out;
+}
+async function loadAiSkillsItemDataOrThrow(catalox, context, skillKey) {
+    const catalogItemId = catalogItemIdFromSkillKey(skillKey);
+    const res = await catalox.getCatalogItem(context, AI_SKILLS_CATALOG_ID, catalogItemId);
+    if (res.outcome === "not_found") {
+        throw new CataloxSkillNotFoundError(skillKey, catalogItemId);
+    }
+    if (res.outcome === "mapping_blocked") {
+        throw new Error(`[AI-SKILLS] Catalox mapping blocked for skill ${catalogItemId}`);
+    }
+    return (res.item.data ?? {});
+}
+/**
+ * Template bodies as `{ role, content }[]` (presentation markdown). Always four entries in stable order.
+ */
+export async function getSkillContent(catalox, context, skillKey) {
+    const data = await loadAiSkillsItemDataOrThrow(catalox, context, skillKey);
+    return SKILL_TEMPLATE_ROLES_ORDER.map((role) => {
+        const raw = role === "instructions"
+            ? asString(data.instructionsText)
+            : role === "prompt"
+                ? asString(data.promptText)
+                : role === "auditInstructions"
+                    ? asString(data.auditInstructionsText)
+                    : asString(data.auditPromptText);
+        return { role, content: raw ? toPresentationMarkdown(raw) : "" };
+    });
+}
+/**
+ * Unique `{{token}}` names across all template bodies (same presentation strings as {@link getSkillContent}).
+ */
+export async function getSkillTokens(catalox, context, skillKey) {
+    const data = await loadAiSkillsItemDataOrThrow(catalox, context, skillKey);
+    const contents = SKILL_TEMPLATE_ROLES_ORDER.map((role) => {
+        const raw = role === "instructions"
+            ? asString(data.instructionsText)
+            : role === "prompt"
+                ? asString(data.promptText)
+                : role === "auditInstructions"
+                    ? asString(data.auditInstructionsText)
+                    : asString(data.auditPromptText);
+        return raw ? toPresentationMarkdown(raw) : "";
+    });
+    return extractTokenNamesFromStrings(contents);
+}
+/**
+ * Partial template update by role. Returns structured success/failure (including Catalox/not-found errors).
+ */
+export async function modifySkillContent(catalox, context, skillKey, parts, options) {
+    try {
+        if (parts.length === 0) {
+            return {
+                success: false,
+                error: "[AI-SKILLS] modifySkillContent: parts must include at least one role.",
+            };
+        }
+        const seen = new Set();
+        const patch = {};
+        for (const p of parts) {
+            if (!isSkillTemplateRole(p.role)) {
+                return {
+                    success: false,
+                    error: `[AI-SKILLS] modifySkillContent: unknown role "${String(p.role)}".`,
+                };
+            }
+            if (seen.has(p.role)) {
+                return {
+                    success: false,
+                    error: `[AI-SKILLS] modifySkillContent: duplicate role "${p.role}".`,
+                };
+            }
+            seen.add(p.role);
+            if (p.role === "instructions") {
+                patch.instructionsMarkdown = p.content;
+            }
+            else if (p.role === "prompt") {
+                patch.promptMarkdown = p.content;
+            }
+            else if (p.role === "auditInstructions") {
+                patch.auditInstructionsMarkdown = p.content;
+            }
+            else {
+                patch.auditPromptMarkdown = p.content;
+            }
+        }
+        await updateSkillTemplatesFromPresentation(catalox, context, skillKey, patch, options);
+        return { success: true };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { success: false, error: msg };
+    }
+}
+/**
+ * Merges edited markdown into the native catalog item and upserts the full row.
+ * Requires Catalox **write** access (e.g. god-mode or app binding with write).
+ *
+ * @throws CataloxSkillNotFoundError when the item does not exist.
+ */
+export async function updateSkillTemplatesFromPresentation(catalox, context, skillKey, patch, options) {
+    const keys = Object.keys(patch).filter((k) => patch[k] !== undefined);
+    if (keys.length === 0) {
+        throw new Error("[AI-SKILLS] updateSkillTemplatesFromPresentation: patch must include at least one field.");
+    }
+    const catalogItemId = catalogItemIdFromSkillKey(skillKey);
+    const res = await catalox.getCatalogItem(context, AI_SKILLS_CATALOG_ID, catalogItemId);
+    if (res.outcome === "not_found") {
+        throw new CataloxSkillNotFoundError(skillKey, catalogItemId);
+    }
+    if (res.outcome === "mapping_blocked") {
+        throw new Error(`[AI-SKILLS] Catalox mapping blocked for skill ${catalogItemId}`);
+    }
+    const data = (res.item.data ?? {});
+    let instructionsText = asString(data.instructionsText);
+    let promptText = asString(data.promptText);
+    let auditInstructionsText = asString(data.auditInstructionsText);
+    let auditPromptText = asString(data.auditPromptText);
+    if (patch.instructionsMarkdown !== undefined) {
+        instructionsText = normalizeForStorage(patch.instructionsMarkdown);
+    }
+    if (patch.promptMarkdown !== undefined) {
+        promptText = normalizeForStorage(patch.promptMarkdown);
+    }
+    if (patch.auditInstructionsMarkdown !== undefined) {
+        auditInstructionsText = normalizeForStorage(patch.auditInstructionsMarkdown);
+    }
+    if (patch.auditPromptMarkdown !== undefined) {
+        auditPromptText = normalizeForStorage(patch.auditPromptMarkdown);
+    }
+    const prevStatus = asSkillCatalogStatus(data.status);
+    const catalogReleaseStatus = options?.catalogReleaseStatus !== undefined
+        ? options.catalogReleaseStatus
+        : prevStatus === "published"
+            ? "published"
+            : undefined;
+    const status = computeSkillRowStatus(instructionsText || undefined, promptText || undefined, catalogReleaseStatus);
+    const shortKey = asString(data.skillKey) || catalogItemId;
+    const payload = {
+        skillKey: shortKey,
+        title: asString(data.title) || shortKey,
+        description: asString(data.description),
+        isLocal: data.isLocal === true,
+        status,
+        instructionsText,
+        promptText,
+    };
+    if (auditInstructionsText.length > 0 || patch.auditInstructionsMarkdown !== undefined) {
+        payload.auditInstructionsText = auditInstructionsText;
+    }
+    if (auditPromptText.length > 0 || patch.auditPromptMarkdown !== undefined) {
+        payload.auditPromptText = auditPromptText;
+    }
+    appendParentSkillKeyIfPresent(data, payload);
+    await catalox.batchUpsertNativeCatalogItems(context, AI_SKILLS_CATALOG_ID, [payload]);
+}
+/**
+ * Creates or updates a full skill catalog row (metadata + optional template markdown).
+ * Uses read–merge–write when the item exists; otherwise writes a new row.
+ * Requires Catalox **write** access.
+ *
+ * @throws CataloxSkillAlreadyExistsError when `options.ifNotExists` is true and the item exists.
+ */
+export async function upsertSkillCatalogItem(catalox, context, input, options) {
+    const catalogItemId = catalogItemIdFromSkillKey(input.skillKey);
+    const res = await catalox.getCatalogItem(context, AI_SKILLS_CATALOG_ID, catalogItemId);
+    if (res.outcome === "mapping_blocked") {
+        throw new Error(`[AI-SKILLS] Catalox mapping blocked for skill ${catalogItemId}`);
+    }
+    if (options?.ifNotExists === true && res.outcome === "found") {
+        throw new CataloxSkillAlreadyExistsError(input.skillKey, catalogItemId);
+    }
+    let instructionsText = "";
+    let promptText = "";
+    let auditInstructionsText = "";
+    let auditPromptText = "";
+    let prevStatus = "planned";
+    if (res.outcome === "found") {
+        const data = (res.item.data ?? {});
+        prevStatus = asSkillCatalogStatus(data.status);
+        instructionsText = asString(data.instructionsText);
+        promptText = asString(data.promptText);
+        auditInstructionsText = asString(data.auditInstructionsText);
+        auditPromptText = asString(data.auditPromptText);
+    }
+    if (input.instructionsMarkdown !== undefined) {
+        instructionsText = normalizeForStorage(input.instructionsMarkdown);
+    }
+    if (input.promptMarkdown !== undefined) {
+        promptText = normalizeForStorage(input.promptMarkdown);
+    }
+    if (input.auditInstructionsMarkdown !== undefined) {
+        auditInstructionsText = normalizeForStorage(input.auditInstructionsMarkdown);
+    }
+    if (input.auditPromptMarkdown !== undefined) {
+        auditPromptText = normalizeForStorage(input.auditPromptMarkdown);
+    }
+    const shortKey = res.outcome === "found"
+        ? asString((res.item.data ?? {}).skillKey) || catalogItemId
+        : catalogItemId;
+    const catalogReleaseStatus = input.catalogReleaseStatus !== undefined
+        ? input.catalogReleaseStatus
+        : prevStatus === "published"
+            ? "published"
+            : undefined;
+    const status = computeSkillRowStatus(instructionsText || undefined, promptText || undefined, catalogReleaseStatus);
+    const payload = {
+        skillKey: shortKey,
+        title: input.title || shortKey,
+        description: input.description,
+        isLocal: input.isLocal,
+        status,
+        instructionsText,
+        promptText,
+    };
+    if (auditInstructionsText.length > 0 || input.auditInstructionsMarkdown !== undefined) {
+        payload.auditInstructionsText = auditInstructionsText;
+    }
+    if (auditPromptText.length > 0 || input.auditPromptMarkdown !== undefined) {
+        payload.auditPromptText = auditPromptText;
+    }
+    if (res.outcome === "found") {
+        appendParentSkillKeyIfPresent((res.item.data ?? {}), payload);
+    }
+    await catalox.batchUpsertNativeCatalogItems(context, AI_SKILLS_CATALOG_ID, [payload]);
+}
+/**
+ * Soft-deletes a skill: clears template bodies and audit fields and sets status to `planned`.
+ * Requires Catalox **write** access.
+ *
+ * @throws CataloxSkillNotFoundError when the item does not exist.
+ */
+export async function softDeleteSkillCatalogItem(catalox, context, skillKey) {
+    const catalogItemId = catalogItemIdFromSkillKey(skillKey);
+    const res = await catalox.getCatalogItem(context, AI_SKILLS_CATALOG_ID, catalogItemId);
+    if (res.outcome === "not_found") {
+        throw new CataloxSkillNotFoundError(skillKey, catalogItemId);
+    }
+    if (res.outcome === "mapping_blocked") {
+        throw new Error(`[AI-SKILLS] Catalox mapping blocked for skill ${catalogItemId}`);
+    }
+    const data = (res.item.data ?? {});
+    const shortKey = asString(data.skillKey) || catalogItemId;
+    const title = asString(data.title) || shortKey;
+    const description = asString(data.description);
+    const isLocal = data.isLocal === true;
+    const instructionsText = "";
+    const promptText = "";
+    const status = computeSkillRowStatus(undefined, undefined, undefined);
+    const payload = {
+        skillKey: shortKey,
+        title,
+        description,
+        isLocal,
+        status,
+        instructionsText,
+        promptText,
+        auditInstructionsText: "",
+        auditPromptText: "",
+    };
+    appendParentSkillKeyIfPresent(data, payload);
+    await catalox.batchUpsertNativeCatalogItems(context, AI_SKILLS_CATALOG_ID, [payload]);
+}
+/**
+ * Duplicates a catalog skill into a new key, marking it with `parentSkillKey`. Structured success/failure.
+ */
+export async function createSubSkill(catalox, context, input) {
+    try {
+        const sourceItemId = catalogItemIdFromSkillKey(input.sourceSkillKey);
+        const newItemId = catalogItemIdFromSkillKey(input.newSkillKey);
+        if (sourceItemId === newItemId) {
+            return {
+                success: false,
+                error: "[AI-SKILLS] createSubSkill: sourceSkillKey and newSkillKey must differ.",
+            };
+        }
+        const srcRes = await catalox.getCatalogItem(context, AI_SKILLS_CATALOG_ID, sourceItemId);
+        if (srcRes.outcome === "not_found") {
+            return {
+                success: false,
+                error: `[AI-SKILLS] createSubSkill: source skill not found (${input.sourceSkillKey}).`,
+            };
+        }
+        if (srcRes.outcome === "mapping_blocked") {
+            return {
+                success: false,
+                error: `[AI-SKILLS] Catalox mapping blocked for skill ${sourceItemId}`,
+            };
+        }
+        const tgtRes = await catalox.getCatalogItem(context, AI_SKILLS_CATALOG_ID, newItemId);
+        if (tgtRes.outcome === "mapping_blocked") {
+            return {
+                success: false,
+                error: `[AI-SKILLS] Catalox mapping blocked for skill ${newItemId}`,
+            };
+        }
+        if (tgtRes.outcome === "found") {
+            return {
+                success: false,
+                error: `[AI-SKILLS] createSubSkill: target skill already exists (${input.newSkillKey}).`,
+            };
+        }
+        const sourceData = (srcRes.item.data ?? {});
+        const parentShortKey = asString(sourceData.skillKey) || sourceItemId;
+        const ov = input.overrides ?? {};
+        let instructionsText = asString(sourceData.instructionsText);
+        let promptText = asString(sourceData.promptText);
+        let auditInstructionsText = asString(sourceData.auditInstructionsText);
+        let auditPromptText = asString(sourceData.auditPromptText);
+        if (ov.instructionsMarkdown !== undefined) {
+            instructionsText = normalizeForStorage(ov.instructionsMarkdown);
+        }
+        if (ov.promptMarkdown !== undefined) {
+            promptText = normalizeForStorage(ov.promptMarkdown);
+        }
+        if (ov.auditInstructionsMarkdown !== undefined) {
+            auditInstructionsText = normalizeForStorage(ov.auditInstructionsMarkdown);
+        }
+        if (ov.auditPromptMarkdown !== undefined) {
+            auditPromptText = normalizeForStorage(ov.auditPromptMarkdown);
+        }
+        const newShortKey = newItemId;
+        const title = ov.title !== undefined ? ov.title : asString(sourceData.title) || newShortKey;
+        const description = ov.description !== undefined ? ov.description : asString(sourceData.description);
+        const isLocal = ov.isLocal !== undefined ? ov.isLocal : sourceData.isLocal === true;
+        const prevStatus = asSkillCatalogStatus(sourceData.status);
+        const catalogReleaseStatus = ov.catalogReleaseStatus !== undefined
+            ? ov.catalogReleaseStatus
+            : prevStatus === "published"
+                ? "published"
+                : undefined;
+        const status = computeSkillRowStatus(instructionsText || undefined, promptText || undefined, catalogReleaseStatus);
+        const payload = {
+            skillKey: newShortKey,
+            parentSkillKey: parentShortKey,
+            title: title || newShortKey,
+            description,
+            isLocal,
+            status,
+            instructionsText,
+            promptText,
+        };
+        if (auditInstructionsText.length > 0 || ov.auditInstructionsMarkdown !== undefined) {
+            payload.auditInstructionsText = auditInstructionsText;
+        }
+        if (auditPromptText.length > 0 || ov.auditPromptMarkdown !== undefined) {
+            payload.auditPromptText = auditPromptText;
+        }
+        await catalox.batchUpsertNativeCatalogItems(context, AI_SKILLS_CATALOG_ID, [payload]);
+        return { success: true };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { success: false, error: msg };
+    }
+}
+/**
+ * Deletes a native catalog row only when it is a sub-skill (`parentSkillKey` set).
+ */
+export async function deleteSubSkill(catalox, context, subSkillKey) {
+    try {
+        const catalogItemId = catalogItemIdFromSkillKey(subSkillKey);
+        const res = await catalox.getCatalogItem(context, AI_SKILLS_CATALOG_ID, catalogItemId);
+        if (res.outcome === "not_found") {
+            return {
+                success: false,
+                error: `[AI-SKILLS] deleteSubSkill: skill not found (${subSkillKey}).`,
+            };
+        }
+        if (res.outcome === "mapping_blocked") {
+            return {
+                success: false,
+                error: `[AI-SKILLS] Catalox mapping blocked for skill ${catalogItemId}`,
+            };
+        }
+        const data = (res.item.data ?? {});
+        const parent = asString(data.parentSkillKey);
+        if (parent.length === 0) {
+            return {
+                success: false,
+                error: "[AI-SKILLS] deleteSubSkill: only sub-skills (rows with parentSkillKey) can be deleted.",
+            };
+        }
+        await catalox.deleteNativeCatalogItem(context, AI_SKILLS_CATALOG_ID, catalogItemId);
+        return { success: true };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { success: false, error: msg };
+    }
+}
+/**
+ * Returns unique `{{token}}` names from raw Catalox template strings (before presentation transforms).
+ */
+export async function getSkillTemplateInputs(catalox, context, skillKey) {
+    const catalogItemId = catalogItemIdFromSkillKey(skillKey);
+    const res = await catalox.getCatalogItem(context, AI_SKILLS_CATALOG_ID, catalogItemId);
+    if (res.outcome === "not_found") {
+        throw new CataloxSkillNotFoundError(skillKey, catalogItemId);
+    }
+    if (res.outcome === "mapping_blocked") {
+        throw new Error(`[AI-SKILLS] Catalox mapping blocked for skill ${catalogItemId}`);
+    }
+    const data = (res.item.data ?? {});
+    return extractTemplateTokensFromTexts({
+        instructionsText: asString(data.instructionsText) || undefined,
+        promptText: asString(data.promptText) || undefined,
+        auditInstructionsText: asString(data.auditInstructionsText) || undefined,
+        auditPromptText: asString(data.auditPromptText) || undefined,
+    });
+}
+//# sourceMappingURL=skill-template-catalog-mutations.js.map

package/dist/catalox/skill-template-catalog-mutations.js.map

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

package/dist/catalox/skill-template-markdown.d.ts

@@ -0,0 +1,34 @@
+export type ExtractedTemplateInputs = {
+    /** All unique token names (sorted). */
+    tokens: string[];
+    /** `input` when present in templates (matches gateway `workingMemory.input`). */
+    primaryPayloadToken: string | null;
+    /** Other tokens (excluding `input`). */
+    variableTokens: string[];
+};
+/**
+ * Lossless canonical form for Catalox / Firestore before gateway invoke.
+ * Normalizes line endings, trims trailing spaces per line, collapses excessive blank lines, then applies
+ * {@link ensureGatewayTreatsAsTemplateText} so nx-content never treats the body as a registry key.
+ */
+export declare function normalizeForStorage(markdown: string): string;
+/**
+ * Markdown suitable for editors / presentation (readable spacing, headings separated).
+ * Inverse of storage normalization where possible; heading breaks are heuristic when content is dense.
+ */
+export declare function toPresentationMarkdown(stored: string): string;
+/**
+ * Collects `{{token}}` placeholders from template bodies (raw Catalox strings).
+ * Does not parse nested mustache blocks beyond skipping odd token names.
+ */
+export declare function extractTemplateTokensFromTexts(parts: {
+    instructionsText?: string;
+    promptText?: string;
+    auditInstructionsText?: string;
+    auditPromptText?: string;
+}): ExtractedTemplateInputs;
+/**
+ * Unique `{{token}}` names from arbitrary template strings (same rules as {@link extractTemplateTokensFromTexts}).
+ */
+export declare function extractTokenNamesFromStrings(contents: string[]): string[];
+//# sourceMappingURL=skill-template-markdown.d.ts.map

package/dist/catalox/skill-template-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-template-markdown.d.ts","sourceRoot":"","sources":["../../src/catalox/skill-template-markdown.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,uBAAuB,GAAG;IAClC,uCAAuC;IACvC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,iFAAiF;IACjF,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,wCAAwC;IACxC,cAAc,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC;AAmBF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM5D;AA6BD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ7D;AAaD;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,uBAAuB,CAU1B;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAMzE"}

package/dist/catalox/skill-template-markdown.js

@@ -0,0 +1,106 @@
+import { ensureGatewayTreatsAsTemplateText } from "./skill-gateway-template-utils.js";
+/** Mustache-style placeholders: `{{token}}` with conservative token names. */
+const TOKEN_PATTERN = /\{\{\s*([A-Za-z_][\w.-]*)\s*\}\}/gu;
+function normalizeLineEndings(text) {
+    return text.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+}
+/** Trims trailing spaces/tabs on each line; keeps blank lines. */
+function trimTrailingSpacesPerLine(text) {
+    return text
+        .split("\n")
+        .map((line) => line.replace(/[ \t]+$/u, ""))
+        .join("\n");
+}
+/** Collapses 3+ consecutive newlines to exactly 2. */
+function collapseExcessiveBlankLines(text) {
+    return text.replace(/\n{3,}/g, "\n\n");
+}
+/**
+ * Lossless canonical form for Catalox / Firestore before gateway invoke.
+ * Normalizes line endings, trims trailing spaces per line, collapses excessive blank lines, then applies
+ * {@link ensureGatewayTreatsAsTemplateText} so nx-content never treats the body as a registry key.
+ */
+export function normalizeForStorage(markdown) {
+    let t = normalizeLineEndings(markdown);
+    t = trimTrailingSpacesPerLine(t);
+    t = collapseExcessiveBlankLines(t);
+    t = t.trim();
+    return ensureGatewayTreatsAsTemplateText(t);
+}
+/**
+ * Reverses the trailing newline that {@link ensureGatewayTreatsAsTemplateText} may append for whitespace-free bodies.
+ */
+function stripGatewayTemplateSuffix(text) {
+    const t = normalizeLineEndings(text);
+    const trimmedEnd = t.replace(/\n+$/u, "");
+    if (trimmedEnd.length === 0)
+        return t.trim();
+    if (!/\s/u.test(trimmedEnd)) {
+        return trimmedEnd;
+    }
+    return t.trimEnd();
+}
+/**
+ * Heuristic: insert blank lines before ATX headings when the body is mostly one line or lacks spacing before `#`.
+ * Can mis-handle rare cases (e.g. `#` inside inline text).
+ */
+function beautifyHeadingBreaks(text) {
+    const t = text.trim();
+    if (t.length === 0)
+        return t;
+    const newlineCount = (t.match(/\n/g) ?? []).length;
+    if (newlineCount >= 3)
+        return text;
+    const withBreaks = t.replace(/([^\n])(#{1,6}\s)/gu, "$1\n\n$2");
+    return withBreaks === t ? text : withBreaks;
+}
+/**
+ * Markdown suitable for editors / presentation (readable spacing, headings separated).
+ * Inverse of storage normalization where possible; heading breaks are heuristic when content is dense.
+ */
+export function toPresentationMarkdown(stored) {
+    let t = stripGatewayTemplateSuffix(stored);
+    t = normalizeLineEndings(t);
+    t = trimTrailingSpacesPerLine(t);
+    t = collapseExcessiveBlankLines(t);
+    t = t.trim();
+    t = beautifyHeadingBreaks(t);
+    return t.trim();
+}
+function collectTokensFromString(s, into) {
+    if (typeof s !== "string" || s.length === 0)
+        return;
+    for (const m of s.matchAll(TOKEN_PATTERN)) {
+        const name = m[1];
+        if (name.startsWith("#") || name.startsWith("/") || name.startsWith("!") || name.startsWith("^")) {
+            continue;
+        }
+        into.add(name);
+    }
+}
+/**
+ * Collects `{{token}}` placeholders from template bodies (raw Catalox strings).
+ * Does not parse nested mustache blocks beyond skipping odd token names.
+ */
+export function extractTemplateTokensFromTexts(parts) {
+    const set = new Set();
+    collectTokensFromString(parts.instructionsText, set);
+    collectTokensFromString(parts.promptText, set);
+    collectTokensFromString(parts.auditInstructionsText, set);
+    collectTokensFromString(parts.auditPromptText, set);
+    const tokens = [...set].sort((a, b) => a.localeCompare(b));
+    const primaryPayloadToken = set.has("input") ? "input" : null;
+    const variableTokens = tokens.filter((x) => x !== "input");
+    return { tokens, primaryPayloadToken, variableTokens };
+}
+/**
+ * Unique `{{token}}` names from arbitrary template strings (same rules as {@link extractTemplateTokensFromTexts}).
+ */
+export function extractTokenNamesFromStrings(contents) {
+    const set = new Set();
+    for (const s of contents) {
+        collectTokensFromString(s, set);
+    }
+    return [...set].sort((a, b) => a.localeCompare(b));
+}
+//# sourceMappingURL=skill-template-markdown.js.map