@exellix/ai-skills 6.5.0 → 6.7.0

package/dist/catalox/catalog-normalization.js

@@ -0,0 +1,281 @@
+import { DEPRECATED_FLAT_OPTIMIXER_DATA_KEYS } from "./catalog-guards.js";
+import { optimixerSpecToNestedData, parseOptimixerFromRecordData } from "./skill-optimixer-catalog.js";
+/** Fields compared when computing sub-skill overrides against a parent row. */
+export const SUB_SKILL_OVERRIDE_FIELDS = [
+    "title",
+    "description",
+    "instructionsText",
+    "promptText",
+    "auditInstructionsText",
+    "auditPromptText",
+    "optimixer",
+];
+const DEPRECATED_BASE_DATA_KEYS = [
+    "skillKey",
+    "status",
+    "isLocal",
+    "id",
+    "name",
+    "skillId",
+    "parentSkillKey",
+];
+const DEPRECATED_BASE_INDEXED_KEYS = ["skillKey", "status", "isLocal", "id", "name", "skillId"];
+const DEPRECATED_SUB_DATA_KEYS = ["subSkillKey", "parentSkillKey", "id", "name", "skillId", "status", "overrides"];
+const DEPRECATED_SUB_INDEXED_KEYS = ["id", "name", "skillId", "status"];
+function asString(v) {
+    return typeof v === "string" ? v.trim() : "";
+}
+function asSkillCatalogStatus(v) {
+    if (v === "draft" || v === "published" || v === "planned")
+        return v;
+    return "planned";
+}
+function readStatus(record) {
+    const fromMeta = asString(record.metadata?.status);
+    if (fromMeta)
+        return asSkillCatalogStatus(fromMeta);
+    return "planned";
+}
+function stableJson(value) {
+    return JSON.stringify(value, Object.keys(value).sort());
+}
+function optimixerSpecsEqual(a, b) {
+    return stableJson(a) === stableJson(b);
+}
+function hasSubSkillFieldsInBaseCatalog(record) {
+    const data = record.data ?? {};
+    const indexed = record.indexed ?? {};
+    return asString(data.parentSkillKey).length > 0 || asString(indexed.parentSkillKey).length > 0;
+}
+/** Read `indexed.skillKey`, falling back to `itemId` when list API omits indexed fields. */
+export function readIndexedSkillKey(record) {
+    const fromIndexed = asString(record.indexed?.skillKey);
+    if (fromIndexed)
+        return fromIndexed;
+    return asString(record.itemId);
+}
+/** Read `indexed.subSkillKey`, falling back to `itemId` when list API omits indexed fields. */
+export function readIndexedSubSkillKey(record) {
+    const fromIndexed = asString(record.indexed?.subSkillKey);
+    if (fromIndexed)
+        return fromIndexed;
+    return asString(record.itemId);
+}
+export function readIndexedParentSkillKey(record) {
+    return asString(record.indexed?.parentSkillKey);
+}
+function hasDeprecatedFlatOptimixer(data) {
+    return DEPRECATED_FLAT_OPTIMIXER_DATA_KEYS.some((key) => data[key] !== undefined);
+}
+function hasNestedOptimixer(data) {
+    const optimixer = data.optimixer;
+    return optimixer != null && typeof optimixer === "object" && !Array.isArray(optimixer);
+}
+/** Whether an ai-skills base row matches normalized invariants. */
+export function isNormalizedAiSkillsBaseRecord(record) {
+    if (hasSubSkillFieldsInBaseCatalog(record))
+        return false;
+    const data = record.data ?? {};
+    const indexed = record.indexed ?? {};
+    if (!asString(indexed.skillKey))
+        return false;
+    if (!asString(record.metadata?.status))
+        return false;
+    if (!hasNestedOptimixer(data))
+        return false;
+    if (DEPRECATED_BASE_DATA_KEYS.some((k) => data[k] !== undefined))
+        return false;
+    if (hasDeprecatedFlatOptimixer(data))
+        return false;
+    if (DEPRECATED_BASE_INDEXED_KEYS.some((k) => k !== "skillKey" && indexed[k] !== undefined))
+        return false;
+    if (indexed.status !== undefined || indexed.isLocal !== undefined)
+        return false;
+    return true;
+}
+/** Whether an ai-sub-skills row matches normalized invariants. */
+export function isNormalizedAiSubSkillsRecord(record) {
+    const data = record.data ?? {};
+    const indexed = record.indexed ?? {};
+    if (!asString(indexed.subSkillKey) || !asString(indexed.parentSkillKey))
+        return false;
+    if (!asString(record.metadata?.status))
+        return false;
+    if (data.overrides == null || typeof data.overrides !== "object" || Array.isArray(data.overrides))
+        return false;
+    if (DEPRECATED_SUB_DATA_KEYS.some((k) => k !== "overrides" && data[k] !== undefined))
+        return false;
+    if (DEPRECATED_SUB_INDEXED_KEYS.some((k) => indexed[k] !== undefined))
+        return false;
+    if (hasDeprecatedFlatOptimixer(data))
+        return false;
+    const overrides = data.overrides;
+    if (hasDeprecatedFlatOptimixer(overrides))
+        return false;
+    return true;
+}
+function partialBaseSkillFromRecord(record, skillKeyForErrors) {
+    const data = record.data ?? {};
+    const optimixer = parseOptimixerFromRecordData(skillKeyForErrors, data);
+    return {
+        skillKey: readIndexedSkillKey(record) || undefined,
+        status: readStatus(record),
+        title: asString(data.title),
+        description: asString(data.description),
+        instructionsText: asString(data.instructionsText) || undefined,
+        promptText: asString(data.promptText) || undefined,
+        auditInstructionsText: asString(data.auditInstructionsText) || undefined,
+        auditPromptText: asString(data.auditPromptText) || undefined,
+        optimixer,
+    };
+}
+/** Resolve a normalized ai-skills base row into runtime skill data. */
+export function resolveBaseSkillFromRecord(record, skillKeyForErrors) {
+    const partial = partialBaseSkillFromRecord(record, skillKeyForErrors);
+    const skillKey = partial.skillKey ?? readIndexedSkillKey(record);
+    if (!skillKey) {
+        throw new Error(`[AI-SKILLS] Missing indexed.skillKey on ai-skills catalog row (${skillKeyForErrors}).`);
+    }
+    return {
+        skillKey,
+        status: partial.status ?? readStatus(record),
+        title: partial.title || skillKey,
+        description: partial.description,
+        instructionsText: partial.instructionsText,
+        promptText: partial.promptText,
+        auditInstructionsText: partial.auditInstructionsText,
+        auditPromptText: partial.auditPromptText,
+        optimixer: partial.optimixer,
+    };
+}
+function parseOverridesFromData(overridesRaw, skillKeyForErrors) {
+    if (overridesRaw == null || typeof overridesRaw !== "object" || Array.isArray(overridesRaw)) {
+        return {};
+    }
+    const raw = overridesRaw;
+    const overrides = {};
+    for (const key of SUB_SKILL_OVERRIDE_FIELDS) {
+        if (key === "optimixer")
+            continue;
+        if (typeof raw[key] === "string") {
+            overrides[key] = raw[key];
+        }
+    }
+    if (raw.optimixer != null && typeof raw.optimixer === "object" && !Array.isArray(raw.optimixer)) {
+        overrides.optimixer = parseOptimixerFromRecordData(skillKeyForErrors, raw);
+    }
+    return overrides;
+}
+/** Resolve a normalized ai-sub-skills row into runtime sub-skill data. */
+export function resolveSubSkillFromRecord(record) {
+    const subSkillKey = readIndexedSubSkillKey(record);
+    const parentSkillKey = readIndexedParentSkillKey(record);
+    if (!subSkillKey) {
+        throw new Error("[AI-SKILLS] Missing indexed.subSkillKey on ai-sub-skills catalog row.");
+    }
+    if (!parentSkillKey) {
+        throw new Error(`[AI-SKILLS] Missing indexed.parentSkillKey on sub-skill "${subSkillKey}".`);
+    }
+    const overrides = parseOverridesFromData(record.data?.overrides, subSkillKey);
+    return {
+        subSkillKey,
+        parentSkillKey,
+        status: readStatus(record),
+        overrides,
+    };
+}
+export function mergeSubSkillWithParent(parent, sub) {
+    const ov = sub.overrides;
+    let optimixer = parent.optimixer;
+    if (ov.optimixer !== undefined) {
+        optimixer = ov.optimixer;
+    }
+    return {
+        skillKey: sub.subSkillKey,
+        subSkillKey: sub.subSkillKey,
+        parentSkillKey: sub.parentSkillKey,
+        status: sub.status,
+        title: ov.title !== undefined ? ov.title : parent.title,
+        description: ov.description !== undefined ? ov.description : parent.description,
+        instructionsText: ov.instructionsText !== undefined ? ov.instructionsText : parent.instructionsText,
+        promptText: ov.promptText !== undefined ? ov.promptText : parent.promptText,
+        auditInstructionsText: ov.auditInstructionsText !== undefined ? ov.auditInstructionsText : parent.auditInstructionsText,
+        auditPromptText: ov.auditPromptText !== undefined ? ov.auditPromptText : parent.auditPromptText,
+        optimixer,
+    };
+}
+/** Build overrides by diffing child runtime fields against a resolved parent row. */
+export function computeSubSkillOverrides(parent, child) {
+    const overrides = {};
+    if (child.title !== parent.title)
+        overrides.title = child.title;
+    if (child.description !== parent.description)
+        overrides.description = child.description;
+    if ((child.instructionsText ?? "") !== (parent.instructionsText ?? "")) {
+        overrides.instructionsText = child.instructionsText ?? "";
+    }
+    if ((child.promptText ?? "") !== (parent.promptText ?? "")) {
+        overrides.promptText = child.promptText ?? "";
+    }
+    if ((child.auditInstructionsText ?? "") !== (parent.auditInstructionsText ?? "")) {
+        overrides.auditInstructionsText = child.auditInstructionsText ?? "";
+    }
+    if ((child.auditPromptText ?? "") !== (parent.auditPromptText ?? "")) {
+        overrides.auditPromptText = child.auditPromptText ?? "";
+    }
+    if (!optimixerSpecsEqual(child.optimixer, parent.optimixer)) {
+        overrides.optimixer = child.optimixer;
+    }
+    return overrides;
+}
+/** Build normalized ai-skills base write payload from runtime fields. */
+export function buildAiSkillsBaseWriteRecord(input) {
+    const now = new Date().toISOString();
+    const data = {
+        title: input.title,
+        description: input.description,
+        instructionsText: input.instructionsText,
+        promptText: input.promptText,
+        optimixer: optimixerSpecToNestedData(input.optimixer),
+    };
+    if (input.auditInstructionsText !== undefined)
+        data.auditInstructionsText = input.auditInstructionsText;
+    if (input.auditPromptText !== undefined)
+        data.auditPromptText = input.auditPromptText;
+    return {
+        itemId: input.itemId,
+        catalogId: input.catalogId,
+        indexed: { skillKey: input.itemId },
+        data,
+        metadata: {
+            ...(input.existing?.metadata ?? {}),
+            status: input.status,
+            createdAt: String(input.existing?.metadata?.createdAt ?? now),
+            lastUpdate: now,
+        },
+    };
+}
+/** Build normalized ai-sub-skills write payload. */
+export function buildAiSubSkillsWriteRecord(input) {
+    const now = new Date().toISOString();
+    const overridesData = { ...input.overrides };
+    if (input.overrides.optimixer !== undefined) {
+        overridesData.optimixer = optimixerSpecToNestedData(input.overrides.optimixer);
+    }
+    return {
+        itemId: input.itemId,
+        catalogId: input.catalogId,
+        indexed: {
+            subSkillKey: input.itemId,
+            parentSkillKey: input.parentSkillKey,
+        },
+        data: { overrides: overridesData },
+        metadata: {
+            ...(input.existing?.metadata ?? {}),
+            status: input.status,
+            createdAt: String(input.existing?.metadata?.createdAt ?? now),
+            lastUpdate: now,
+        },
+    };
+}
+//# sourceMappingURL=catalog-normalization.js.map

package/dist/catalox/catalog-normalization.js.map

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

package/dist/catalox/index.d.ts

@@ -1,10 +1,11 @@
 export { canonicalSkillKey, ensureGatewayTreatsAsTemplateText } from "./skill-gateway-template-utils.js";
-export { AI_SKILLS_APP_ID, AI_SKILLS_CATALOG_ID, AI_SKILLS_DESCRIPTOR_VERSION, AI_SKILLS_CATALOG_ITEMS, buildAiSkillsCatalogDescriptor, computeSkillRowStatus, type AiSkillsCatalogItemSpec, type CatalogReleaseStatus, } from "./ai-skills-catalog.js";
+export { AI_SKILLS_APP_ID, AI_SKILLS_CATALOG_ID, AI_SKILLS_DESCRIPTOR_VERSION, AI_SKILLS_CATALOG_ITEMS, buildAiSkillsCatalogDescriptor, computeSkillRowStatus, isSkillLocalForDiscovery, type AiSkillsCatalogItemSpec, type CatalogReleaseStatus, } from "./ai-skills-catalog.js";
+export { AI_SUB_SKILLS_CATALOG_ID, AI_SUB_SKILLS_DESCRIPTOR_VERSION, buildAiSubSkillsCatalogDescriptor, } from "./ai-sub-skills-catalog.js";
 export { AI_ENGINES_APP_ID, AI_ENGINES_CATALOG_ID, AI_ENGINES_DESCRIPTOR_VERSION, AI_ENGINES_CATALOG_ITEMS, AI_ENGINE_CATALOG_ITEM_IDS, DEFAULT_AI_ENGINE_CATALOG_ITEM_ID, buildAiEnginesCatalogDescriptor, type AiEngineCatalogItemId, type AiEnginesCatalogItemSpec, } from "./ai-engines-catalog.js";
-export { listAiSkillsCatalogItems, catalogSkillKeyToRunSkillKey, type AiSkillsPublishedItem, type ListAiSkillsCatalogItemsResult, } from "./list-ai-skills-catalog.js";
-export { catalogItemIdFromSkillKey, extractRunnableTemplateBodiesFromAiSkillsCatalogData, fetchSkillTemplatesFromCatalox, defaultAiSkillsCataloxContext, type SkillCatalogStatus, type FetchSkillTemplatesMode, type AiSkillsCatalogItemDataFields, type RunnableTemplateBodiesFromCatalogData, } from "./skill-templates.js";
+export { listAiSkillsCatalogItems, listSubSkillsCatalogItems, catalogSkillKeyToRunSkillKey, type AiSkillsPublishedItem, type AiSkillsCatalogItem, type ListAiSkillsCatalogItemsResult, } from "./list-ai-skills-catalog.js";
+export { catalogItemIdFromSkillKey, fetchSkillTemplatesFromCatalox, defaultAiSkillsCataloxContext, type SkillCatalogStatus, type FetchSkillTemplatesMode, type AiSkillsCatalogItemDataFields, type RunnableTemplateBodiesFromCatalogData, } from "./skill-templates.js";
 export { CataloxSkillNotFoundError, CataloxSkillAlreadyExistsError, CataloxSkillNotRunnableError, } from "./catalox-skill-errors.js";
 export { initFirebaseAdminFromEnv, createCataloxFromEnv } from "./init-firebase-and-catalox.js";
 export { normalizeForStorage, toPresentationMarkdown, extractTemplateTokensFromTexts, extractTokenNamesFromStrings, type ExtractedTemplateInputs, } from "./skill-template-markdown.js";
-export { SKILL_TEMPLATE_ROLES_ORDER, getSkillContent, getSkillTokens, modifySkillContent, createSubSkill, deleteSubSkill, getSkillTemplatesForPresentation, updateSkillTemplatesFromPresentation, getSkillTemplateInputs, upsertSkillCatalogItem, softDeleteSkillCatalogItem, type SkillTemplateRole, type SkillContentPart, type ModifySkillContentResult, type CreateSubSkillOverrides, type CreateSubSkillInput, type CreateSubSkillResult, type DeleteSubSkillResult, type SkillTemplatesPresentation, type SkillTemplatePresentationPatch, type UpdateSkillTemplatesFromPresentationOptions, type UpsertSkillCatalogItemInput, type UpsertSkillCatalogItemOptions, } from "./skill-template-catalog-mutations.js";
+export { SKILL_TEMPLATE_ROLES_ORDER, getSkillContent, getSkillTokens, modifySkillContent, createSubSkill, deleteSubSkill, getSkillTemplatesForPresentation, updateSkillTemplatesFromPresentation, getSkillTemplateInputs, upsertSkillCatalogItem, softDeleteSkillCatalogItem, updateSkillMetadata, isSubSkillCatalogItem, type SkillTemplateRole, type SkillContentPart, type ModifySkillContentResult, type CreateSubSkillOverrides, type CreateSubSkillInput, type CreateSubSkillResult, type DeleteSubSkillResult, type SkillTemplatesPresentation, type SkillTemplatePresentationPatch, type UpdateSkillTemplatesFromPresentationOptions, type UpsertSkillCatalogItemInput, type UpsertSkillCatalogItemOptions, type UpdateSkillMetadataInput, } from "./skill-template-catalog-mutations.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/catalox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iCAAiC,EAAE,MAAM,mCAAmC,CAAC;AACzG,OAAO,EACH,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,8BAA8B,EAC9B,qBAAqB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,GAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACH,iBAAiB,EACjB,qBAAqB,EACrB,6BAA6B,EAC7B,wBAAwB,EACxB,0BAA0B,EAC1B,iCAAiC,EACjC,+BAA+B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,GAChC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACH,wBAAwB,EACxB,4BAA4B,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,8BAA8B,GACtC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACH,yBAAyB,EACzB,oDAAoD,EACpD,8BAA8B,EAC9B,6BAA6B,EAC7B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,KAAK,qCAAqC,GAC7C,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACH,yBAAyB,EACzB,8BAA8B,EAC9B,4BAA4B,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAChG,OAAO,EACH,mBAAmB,EACnB,sBAAsB,EACtB,8BAA8B,EAC9B,4BAA4B,EAC5B,KAAK,uBAAuB,GAC/B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACH,0BAA0B,EAC1B,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,gCAAgC,EAChC,oCAAoC,EACpC,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,8BAA8B,EACnC,KAAK,2CAA2C,EAChD,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,GACrC,MAAM,uCAAuC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/catalox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iCAAiC,EAAE,MAAM,mCAAmC,CAAC;AACzG,OAAO,EACH,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,8BAA8B,EAC9B,qBAAqB,EACrB,wBAAwB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,GAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACH,wBAAwB,EACxB,gCAAgC,EAChC,iCAAiC,GACpC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACH,iBAAiB,EACjB,qBAAqB,EACrB,6BAA6B,EAC7B,wBAAwB,EACxB,0BAA0B,EAC1B,iCAAiC,EACjC,+BAA+B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,GAChC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACH,wBAAwB,EACxB,yBAAyB,EACzB,4BAA4B,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,8BAA8B,GACtC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACH,yBAAyB,EACzB,8BAA8B,EAC9B,6BAA6B,EAC7B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,KAAK,qCAAqC,GAC7C,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACH,yBAAyB,EACzB,8BAA8B,EAC9B,4BAA4B,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAChG,OAAO,EACH,mBAAmB,EACnB,sBAAsB,EACtB,8BAA8B,EAC9B,4BAA4B,EAC5B,KAAK,uBAAuB,GAC/B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACH,0BAA0B,EAC1B,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,gCAAgC,EAChC,oCAAoC,EACpC,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,8BAA8B,EACnC,KAAK,2CAA2C,EAChD,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,GAChC,MAAM,uCAAuC,CAAC"}

package/dist/catalox/index.js

@@ -1,10 +1,11 @@
 export { canonicalSkillKey, ensureGatewayTreatsAsTemplateText } from "./skill-gateway-template-utils.js";
-export { AI_SKILLS_APP_ID, AI_SKILLS_CATALOG_ID, AI_SKILLS_DESCRIPTOR_VERSION, AI_SKILLS_CATALOG_ITEMS, buildAiSkillsCatalogDescriptor, computeSkillRowStatus, } from "./ai-skills-catalog.js";
+export { AI_SKILLS_APP_ID, AI_SKILLS_CATALOG_ID, AI_SKILLS_DESCRIPTOR_VERSION, AI_SKILLS_CATALOG_ITEMS, buildAiSkillsCatalogDescriptor, computeSkillRowStatus, isSkillLocalForDiscovery, } from "./ai-skills-catalog.js";
+export { AI_SUB_SKILLS_CATALOG_ID, AI_SUB_SKILLS_DESCRIPTOR_VERSION, buildAiSubSkillsCatalogDescriptor, } from "./ai-sub-skills-catalog.js";
 export { AI_ENGINES_APP_ID, AI_ENGINES_CATALOG_ID, AI_ENGINES_DESCRIPTOR_VERSION, AI_ENGINES_CATALOG_ITEMS, AI_ENGINE_CATALOG_ITEM_IDS, DEFAULT_AI_ENGINE_CATALOG_ITEM_ID, buildAiEnginesCatalogDescriptor, } from "./ai-engines-catalog.js";
-export { listAiSkillsCatalogItems, catalogSkillKeyToRunSkillKey, } from "./list-ai-skills-catalog.js";
-export { catalogItemIdFromSkillKey, extractRunnableTemplateBodiesFromAiSkillsCatalogData, fetchSkillTemplatesFromCatalox, defaultAiSkillsCataloxContext, } from "./skill-templates.js";
+export { listAiSkillsCatalogItems, listSubSkillsCatalogItems, catalogSkillKeyToRunSkillKey, } from "./list-ai-skills-catalog.js";
+export { catalogItemIdFromSkillKey, fetchSkillTemplatesFromCatalox, defaultAiSkillsCataloxContext, } from "./skill-templates.js";
 export { CataloxSkillNotFoundError, CataloxSkillAlreadyExistsError, CataloxSkillNotRunnableError, } from "./catalox-skill-errors.js";
 export { initFirebaseAdminFromEnv, createCataloxFromEnv } from "./init-firebase-and-catalox.js";
 export { normalizeForStorage, toPresentationMarkdown, extractTemplateTokensFromTexts, extractTokenNamesFromStrings, } from "./skill-template-markdown.js";
-export { SKILL_TEMPLATE_ROLES_ORDER, getSkillContent, getSkillTokens, modifySkillContent, createSubSkill, deleteSubSkill, getSkillTemplatesForPresentation, updateSkillTemplatesFromPresentation, getSkillTemplateInputs, upsertSkillCatalogItem, softDeleteSkillCatalogItem, } from "./skill-template-catalog-mutations.js";
+export { SKILL_TEMPLATE_ROLES_ORDER, getSkillContent, getSkillTokens, modifySkillContent, createSubSkill, deleteSubSkill, getSkillTemplatesForPresentation, updateSkillTemplatesFromPresentation, getSkillTemplateInputs, upsertSkillCatalogItem, softDeleteSkillCatalogItem, updateSkillMetadata, isSubSkillCatalogItem, } from "./skill-template-catalog-mutations.js";
 //# sourceMappingURL=index.js.map

package/dist/catalox/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/catalox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iCAAiC,EAAE,MAAM,mCAAmC,CAAC;AACzG,OAAO,EACH,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,8BAA8B,EAC9B,qBAAqB,GAGxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACH,iBAAiB,EACjB,qBAAqB,EACrB,6BAA6B,EAC7B,wBAAwB,EACxB,0BAA0B,EAC1B,iCAAiC,EACjC,+BAA+B,GAGlC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACH,wBAAwB,EACxB,4BAA4B,GAG/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACH,yBAAyB,EACzB,oDAAoD,EACpD,8BAA8B,EAC9B,6BAA6B,GAKhC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACH,yBAAyB,EACzB,8BAA8B,EAC9B,4BAA4B,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAChG,OAAO,EACH,mBAAmB,EACnB,sBAAsB,EACtB,8BAA8B,EAC9B,4BAA4B,GAE/B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACH,0BAA0B,EAC1B,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,gCAAgC,EAChC,oCAAoC,EACpC,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,GAa7B,MAAM,uCAAuC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/catalox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iCAAiC,EAAE,MAAM,mCAAmC,CAAC;AACzG,OAAO,EACH,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,8BAA8B,EAC9B,qBAAqB,EACrB,wBAAwB,GAG3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACH,wBAAwB,EACxB,gCAAgC,EAChC,iCAAiC,GACpC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACH,iBAAiB,EACjB,qBAAqB,EACrB,6BAA6B,EAC7B,wBAAwB,EACxB,0BAA0B,EAC1B,iCAAiC,EACjC,+BAA+B,GAGlC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACH,wBAAwB,EACxB,yBAAyB,EACzB,4BAA4B,GAI/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACH,yBAAyB,EACzB,8BAA8B,EAC9B,6BAA6B,GAKhC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACH,yBAAyB,EACzB,8BAA8B,EAC9B,4BAA4B,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAChG,OAAO,EACH,mBAAmB,EACnB,sBAAsB,EACtB,8BAA8B,EAC9B,4BAA4B,GAE/B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACH,0BAA0B,EAC1B,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,gCAAgC,EAChC,oCAAoC,EACpC,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,EACnB,qBAAqB,GAcxB,MAAM,uCAAuC,CAAC"}

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

@@ -1,4 +1,5 @@
 import type { Catalox, CatalogQueryOptions } from "@x12i/catalox";
+import { AI_SKILLS_IS_LOCAL_BY_KEY } from "./ai-skills-catalog.js";
 export type SkillRowStatus = "planned" | "draft" | "published";
 export type AiSkillsPublishedItem = {
     skillKey: string;
@@ -7,18 +8,23 @@ export type AiSkillsPublishedItem = {
     isLocal: boolean;
     status: SkillRowStatus;
 };
+export type AiSkillsCatalogItem = AiSkillsPublishedItem & {
+    catalogItemId: string;
+    isSubSkill: boolean;
+    parentSkillKey?: string;
+};
 export type ListAiSkillsCatalogItemsResult = {
     listOutcome: "ok" | "mapping_blocked";
-    items: AiSkillsPublishedItem[];
+    items: AiSkillsCatalogItem[];
     issues?: unknown[];
 };
-/**
- * Lists skills from the Catalox native catalog {@link AI_SKILLS_CATALOG_ID}
- * for {@link AI_SKILLS_APP_ID} (override `appId` when your binding uses another tenant id).
- */
 export declare function listAiSkillsCatalogItems(catalox: Catalox, options?: CatalogQueryOptions & {
     appId?: string;
 }): Promise<ListAiSkillsCatalogItemsResult>;
-/** Maps a short Catalox `skillKey` to the canonical `skills/<id>` form used in `runSkill`. */
+export declare function listSubSkillsCatalogItems(catalox: Catalox, parentSkillKey: string, options?: CatalogQueryOptions & {
+    appId?: string;
+}): Promise<ListAiSkillsCatalogItemsResult>;
 export declare function catalogSkillKeyToRunSkillKey(skillKey: string): string;
+/** @internal re-export for registry category hints */
+export { AI_SKILLS_IS_LOCAL_BY_KEY };
 //# sourceMappingURL=list-ai-skills-catalog.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"list-ai-skills-catalog.d.ts","sourceRoot":"","sources":["../../src/catalox/list-ai-skills-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAIlE,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;AAE/D,MAAM,MAAM,qBAAqB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IACzC,WAAW,EAAE,IAAI,GAAG,iBAAiB,CAAC;IACtC,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB,CAAC;AAcF;;;GAGG;AACH,wBAAsB,wBAAwB,CAC1C,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,mBAAmB,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,OAAO,CAAC,8BAA8B,CAAC,CAczC;AAED,8FAA8F;AAC9F,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErE"}
+{"version":3,"file":"list-ai-skills-catalog.d.ts","sourceRoot":"","sources":["../../src/catalox/list-ai-skills-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAsB,MAAM,eAAe,CAAC;AAEtF,OAAO,EAAE,yBAAyB,EAA4B,MAAM,wBAAwB,CAAC;AAM7F,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;AAE/D,MAAM,MAAM,qBAAqB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,GAAG;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IACzC,WAAW,EAAE,IAAI,GAAG,iBAAiB,CAAC;IACtC,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB,CAAC;AAoDF,wBAAsB,wBAAwB,CAC1C,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,mBAAmB,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,OAAO,CAAC,8BAA8B,CAAC,CAyBzC;AAED,wBAAsB,yBAAyB,CAC3C,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,mBAAmB,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,OAAO,CAAC,8BAA8B,CAAC,CAKzC;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,sDAAsD;AACtD,OAAO,EAAE,yBAAyB,EAAE,CAAC"}

package/dist/catalox/list-ai-skills-catalog.js

@@ -1,38 +1,91 @@
+import { readIndexedParentSkillKey, readIndexedSkillKey } from "./catalog-normalization.js";
+import { AI_SKILLS_IS_LOCAL_BY_KEY, isSkillLocalForDiscovery } from "./ai-skills-catalog.js";
 import { canonicalSkillKey } from "./skill-gateway-template-utils.js";
 import { AI_SKILLS_APP_ID, AI_SKILLS_CATALOG_ID } from "./ai-skills-catalog.js";
-function asItem(data) {
-    const skillKey = typeof data.skillKey === "string" ? data.skillKey : "";
+import { AI_SUB_SKILLS_CATALOG_ID } from "./ai-sub-skills-catalog.js";
+import { catalogItemIdFromSkillKey, nativeRecordFromUnifiedItem } from "./skill-templates.js";
+function readStatusFromItem(item) {
+    const metaStatus = item.metadata?.status;
+    if (metaStatus === "draft" || metaStatus === "published" || metaStatus === "planned") {
+        return metaStatus;
+    }
+    return "planned";
+}
+function asItemFromUnified(item, catalogId) {
+    const record = nativeRecordFromUnifiedItem(item, catalogId);
+    const isSubSkill = catalogId === AI_SUB_SKILLS_CATALOG_ID;
+    const indexed = record.indexed ?? {};
+    const skillKey = isSubSkill
+        ? String(("subSkillKey" in indexed ? indexed.subSkillKey : undefined) ?? item.itemId)
+        : readIndexedSkillKey(record) || String(item.itemId);
+    const catalogItemId = String(item.itemId);
+    const data = record.data;
     const title = typeof data.title === "string" ? data.title : "";
     const description = typeof data.description === "string" ? data.description : "";
-    const isLocal = data.isLocal === true;
-    const statusRaw = data.status;
-    const status = statusRaw === "draft" || statusRaw === "published" || statusRaw === "planned" ? statusRaw : "planned";
-    if (!skillKey || !title)
+    const overrides = data.overrides;
+    const ovTitle = overrides != null && typeof overrides === "object" && !Array.isArray(overrides)
+        ? typeof overrides.title === "string"
+            ? String(overrides.title)
+            : ""
+        : "";
+    const ovDescription = overrides != null && typeof overrides === "object" && !Array.isArray(overrides)
+        ? typeof overrides.description === "string"
+            ? String(overrides.description)
+            : ""
+        : "";
+    const resolvedTitle = title || ovTitle || skillKey;
+    const resolvedDescription = description || ovDescription;
+    const status = readStatusFromItem(item);
+    const isLocal = isSkillLocalForDiscovery(skillKey);
+    const parentSkillKey = isSubSkill ? readIndexedParentSkillKey(record) || undefined : undefined;
+    if (!skillKey || !resolvedTitle)
         return null;
-    return { skillKey, title, description, isLocal, status };
+    return {
+        skillKey,
+        catalogItemId,
+        title: resolvedTitle,
+        description: resolvedDescription,
+        isLocal,
+        status,
+        isSubSkill,
+        ...(parentSkillKey ? { parentSkillKey } : {}),
+    };
 }
-/**
- * Lists skills from the Catalox native catalog {@link AI_SKILLS_CATALOG_ID}
- * for {@link AI_SKILLS_APP_ID} (override `appId` when your binding uses another tenant id).
- */
 export async function listAiSkillsCatalogItems(catalox, options) {
     const { appId, ...query } = options ?? {};
     const ctx = { appId: appId ?? AI_SKILLS_APP_ID };
-    const res = await catalox.listCatalogItems(ctx, AI_SKILLS_CATALOG_ID, query);
+    const baseRes = await catalox.listCatalogItems(ctx, AI_SKILLS_CATALOG_ID, query);
+    const subRes = await catalox.listCatalogItems(ctx, AI_SUB_SKILLS_CATALOG_ID, query);
     const items = [];
-    for (const it of res.items) {
-        const row = asItem((it.data ?? {}));
-        if (row)
-            items.push(row);
+    if (baseRes.listOutcome === "ok") {
+        for (const it of baseRes.items) {
+            const row = asItemFromUnified(it, AI_SKILLS_CATALOG_ID);
+            if (row)
+                items.push(row);
+        }
+    }
+    if (subRes.listOutcome === "ok") {
+        for (const it of subRes.items) {
+            const row = asItemFromUnified(it, AI_SUB_SKILLS_CATALOG_ID);
+            if (row)
+                items.push(row);
+        }
     }
     return {
-        listOutcome: res.listOutcome,
+        listOutcome: baseRes.listOutcome === "ok" ? "ok" : baseRes.listOutcome,
         items,
-        ...(res.issues ? { issues: res.issues } : {}),
+        ...(baseRes.issues ? { issues: baseRes.issues } : {}),
     };
 }
-/** Maps a short Catalox `skillKey` to the canonical `skills/<id>` form used in `runSkill`. */
+export async function listSubSkillsCatalogItems(catalox, parentSkillKey, options) {
+    const parentItemId = catalogItemIdFromSkillKey(parentSkillKey);
+    const res = await listAiSkillsCatalogItems(catalox, options);
+    const items = res.items.filter((it) => it.isSubSkill && it.parentSkillKey === parentItemId);
+    return { ...res, items };
+}
 export function catalogSkillKeyToRunSkillKey(skillKey) {
     return canonicalSkillKey(skillKey);
 }
+/** @internal re-export for registry category hints */
+export { AI_SKILLS_IS_LOCAL_BY_KEY };
 //# sourceMappingURL=list-ai-skills-catalog.js.map

package/dist/catalox/list-ai-skills-catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-ai-skills-catalog.js","sourceRoot":"","sources":["../../src/catalox/list-ai-skills-catalog.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAkBhF,SAAS,MAAM,CAAC,IAA6B;IACzC,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,MAAM,WAAW,GAAG,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC;IAC9B,MAAM,MAAM,GACR,SAAS,KAAK,OAAO,IAAI,SAAS,KAAK,WAAW,IAAI,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1G,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC1C,OAAgB,EAChB,OAAkD;IAElD,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAC1C,MAAM,GAAG,GAAG,EAAE,KAAK,EAAE,KAAK,IAAI,gBAAgB,EAAE,CAAC;IACjD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,GAAG,EAAE,oBAAoB,EAAE,KAAK,CAAC,CAAC;IAC7E,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC,CAAC;QAC/D,IAAI,GAAG;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO;QACH,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,KAAK;QACL,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC;AACN,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,4BAA4B,CAAC,QAAgB;IACzD,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"list-ai-skills-catalog.js","sourceRoot":"","sources":["../../src/catalox/list-ai-skills-catalog.ts"],"names":[],"mappings":"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"}

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

@@ -8,25 +8,26 @@ export type SkillOptimixerCatalogSpec = {
     outputMode?: OptimixerOutputMode;
     schemaComplexity?: OptimixerSchemaComplexity;
 };
-export type SkillOptimixerCatalogDataFields = {
-    optimixerReasoningEffort?: string;
-    optimixerOutputIntentMode?: string;
-    optimixerExpectedVisibleTokens?: number;
-    optimixerOutputToInputRatio?: number;
-    optimixerAcceptableRisk?: string;
-    optimixerTaskType?: string;
-    optimixerOutputMode?: string;
-    optimixerSchemaComplexity?: string;
+/** Nested Optimixer object stored under `data.optimixer` (normalized catalog shape). */
+export type SkillOptimixerNestedData = {
+    reasoningEffort: string;
+    outputIntent: {
+        mode: string;
+        expectedVisibleTokens: number;
+        outputToInputRatio?: number;
+    };
+    acceptableRisk?: string;
+    taskType?: string;
+    outputMode?: string;
+    schemaComplexity?: string;
 };
-/** Flattens {@link SkillOptimixerCatalogSpec} into Catalox `data` fields for provision/upsert. */
-export declare function skillOptimixerCatalogSpecToDataFields(spec: SkillOptimixerCatalogSpec): SkillOptimixerCatalogDataFields;
+/** Converts {@link SkillOptimixerCatalogSpec} to nested `data.optimixer` for normalized catalog rows. */
+export declare function optimixerSpecToNestedData(spec: SkillOptimixerCatalogSpec): SkillOptimixerNestedData;
 /**
- * Parses mandatory Optimixer catalog fields from one `ai-skills` row.
+ * Parses Optimixer from normalized `data.optimixer` (or nested override objects).
  * @throws Error when required fields are missing or invalid.
  */
-export declare function parseSkillOptimixerCatalogFromData(skillKeyForErrors: string, data: Record<string, unknown>): SkillOptimixerCatalogSpec;
+export declare function parseOptimixerFromRecordData(skillKeyForErrors: string, data: Record<string, unknown>): SkillOptimixerCatalogSpec;
 /** Default Optimixer row used by unit-test Catalox stubs when not overridden. */
 export declare function defaultSkillOptimixerCatalogSpecForTests(): SkillOptimixerCatalogSpec;
-/** Copies Optimixer flat fields from an existing Catalox row (sub-skill duplicate, upsert merge). */
-export declare function copySkillOptimixerCatalogDataFields(from: Record<string, unknown>, to: Record<string, unknown>): void;
 //# sourceMappingURL=skill-optimixer-catalog.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"skill-optimixer-catalog.d.ts","sourceRoot":"","sources":["../../src/catalox/skill-optimixer-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,EACpB,MAAM,iBAAiB,CAAC;AAEzB,oFAAoF;AACpF,MAAM,MAAM,yBAAyB,GAAG;IACpC,eAAe,EAAE,wBAAwB,CAAC;IAC1C,YAAY,EAAE,qBAAqB,CAAC;IACpC,cAAc,CAAC,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC1C,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACxC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACtC,CAAC;AAkBF,kGAAkG;AAClG,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,yBAAyB,GAAG,+BAA+B,CActH;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,CAC9C,iBAAiB,EAAE,MAAM,EACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,yBAAyB,CAkD3B;AAED,iFAAiF;AACjF,wBAAgB,wCAAwC,IAAI,yBAAyB,CAQpF;AAaD,qGAAqG;AACrG,wBAAgB,mCAAmC,CAC/C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,IAAI,CAMN"}
+{"version":3,"file":"skill-optimixer-catalog.d.ts","sourceRoot":"","sources":["../../src/catalox/skill-optimixer-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,EACpB,MAAM,iBAAiB,CAAC;AAEzB,oFAAoF;AACpF,MAAM,MAAM,yBAAyB,GAAG;IACpC,eAAe,EAAE,wBAAwB,CAAC;IAC1C,YAAY,EAAE,qBAAqB,CAAC;IACpC,cAAc,CAAC,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;CAChD,CAAC;AAEF,wFAAwF;AACxF,MAAM,MAAM,wBAAwB,GAAG;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,qBAAqB,EAAE,MAAM,CAAC;QAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AA8DF,yGAAyG;AACzG,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,yBAAyB,GAAG,wBAAwB,CAgBnG;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CACxC,iBAAiB,EAAE,MAAM,EACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,yBAAyB,CAS3B;AAED,iFAAiF;AACjF,wBAAgB,wCAAwC,IAAI,yBAAyB,CAQpF"}