@exellix/ai-skills 5.8.0

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

@@ -0,0 +1,202 @@
+/** Catalox `catalogId` and default `appId` for published skill discovery. */
+export const AI_SKILLS_CATALOG_ID = "ai-skills";
+export const AI_SKILLS_APP_ID = "ai-skills";
+/** Descriptor version written by {@link scripts/provision-ai-skills-catalog}. */
+export const AI_SKILLS_DESCRIPTOR_VERSION = "1";
+/**
+ * Authoritative in-repo list for Catalox provisioning and package docs.
+ * Downstream consumers should call Catalox `listCatalogItems` for the live list.
+ */
+export const AI_SKILLS_CATALOG_ITEMS = [
+    {
+        skillKey: "professional-answer",
+        title: "Professional answer",
+        description: "Structured professional answer with FlexMD payloads (shortAnswer, fullAnswer, assumptions, unknowns, evidence).",
+        isLocal: true,
+        catalogReleaseStatus: "published",
+    },
+    {
+        skillKey: "scoped-data-reader",
+        title: "Scoped data reader",
+        description: "Reads and normalizes scoped datasets for downstream reasoning and assembly.",
+        isLocal: false,
+    },
+    {
+        skillKey: "scoped-answer-writer",
+        title: "Scoped answer writer",
+        description: "Writes scoped narrative or structured answers from prepared context and constraints.",
+        isLocal: false,
+    },
+    {
+        skillKey: "scoped-answer-assembler",
+        title: "Scoped answer assembler",
+        description: "Assembles multi-part scoped answers from fragments while preserving scope boundaries.",
+        isLocal: false,
+    },
+    {
+        skillKey: "deterministic-rule",
+        title: "Deterministic rule",
+        description: "Applies explicit deterministic rules and policies over inputs without open-ended generation.",
+        isLocal: false,
+    },
+    {
+        skillKey: "professional-decision",
+        title: "Professional decision",
+        description: "Structured decision output (decision, score, rationale, risks).",
+        isLocal: true,
+        catalogReleaseStatus: "published",
+    },
+];
+export function buildAiSkillsCatalogDescriptor() {
+    return {
+        catalogId: AI_SKILLS_CATALOG_ID,
+        label: "AI Skills",
+        description: "Skill registry and template bodies for @exellix/ai-skills (Catalox native).",
+        itemLabel: "Skill",
+        sourceMode: "native",
+        status: "active",
+        visibility: "visible",
+        defaultSort: { field: "skillKey", direction: "asc" },
+        capabilities: {
+            canList: true,
+            canGet: true,
+            canCreate: true,
+            canEdit: true,
+            canDelete: true,
+            canImport: true,
+            canExport: true,
+            canValidate: true,
+            canViewReferences: true,
+        },
+        queryableFields: [
+            {
+                key: "skillKey",
+                label: "Skill key",
+                type: "string",
+                path: "skillKey",
+                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,
+            },
+            {
+                key: "isLocal",
+                label: "Local templates",
+                type: "boolean",
+                path: "isLocal",
+                indexed: true,
+                filterable: true,
+                sortable: true,
+                listVisible: true,
+                detailVisible: true,
+                required: true,
+            },
+            {
+                key: "status",
+                label: "Status",
+                type: "enum",
+                path: "status",
+                enumValues: ["planned", "draft", "published"],
+                indexed: true,
+                filterable: true,
+                sortable: true,
+                listVisible: true,
+                detailVisible: true,
+                required: true,
+            },
+            {
+                key: "parentSkillKey",
+                label: "Parent skill (sub-skill)",
+                type: "string",
+                path: "parentSkillKey",
+                indexed: false,
+                filterable: true,
+                sortable: false,
+                listVisible: true,
+                detailVisible: true,
+                required: false,
+            },
+            {
+                key: "instructionsText",
+                label: "Instructions",
+                type: "string",
+                path: "instructionsText",
+                listVisible: false,
+                detailVisible: true,
+                required: false,
+            },
+            {
+                key: "promptText",
+                label: "Prompt",
+                type: "string",
+                path: "promptText",
+                listVisible: false,
+                detailVisible: true,
+                required: false,
+            },
+            {
+                key: "auditInstructionsText",
+                label: "Audit instructions",
+                type: "string",
+                path: "auditInstructionsText",
+                listVisible: false,
+                detailVisible: true,
+                required: false,
+            },
+            {
+                key: "auditPromptText",
+                label: "Audit prompt",
+                type: "string",
+                path: "auditPromptText",
+                listVisible: false,
+                detailVisible: true,
+                required: false,
+            },
+        ],
+        identity: {
+            itemIdStrategy: "natural",
+            itemIdField: "skillKey",
+            titleField: "title",
+            statusField: "status",
+        },
+    };
+}
+/**
+ * Computes Catalox `data.status` after template bodies are merged.
+ */
+export function computeSkillRowStatus(instructionsText, promptText, catalogReleaseStatus) {
+    const ins = instructionsText?.trim() ?? "";
+    const pr = promptText?.trim() ?? "";
+    if (!ins || !pr)
+        return "planned";
+    if (catalogReleaseStatus === "published")
+        return "published";
+    return "draft";
+}
+//# sourceMappingURL=ai-skills-catalog.js.map

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

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

package/dist/catalox/catalox-skill-errors.d.ts

@@ -0,0 +1,15 @@
+export declare class CataloxSkillNotFoundError extends Error {
+    readonly skillKey: string;
+    readonly itemId: string;
+    constructor(skillKey: string, itemId: string);
+}
+export declare class CataloxSkillAlreadyExistsError extends Error {
+    readonly skillKey: string;
+    readonly itemId: string;
+    constructor(skillKey: string, itemId: string);
+}
+export declare class CataloxSkillNotRunnableError extends Error {
+    readonly skillKey: string;
+    constructor(skillKey: string, message: string);
+}
+//# sourceMappingURL=catalox-skill-errors.d.ts.map

package/dist/catalox/catalox-skill-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalox-skill-errors.d.ts","sourceRoot":"","sources":["../../src/catalox/catalox-skill-errors.ts"],"names":[],"mappings":"AAAA,qBAAa,yBAA0B,SAAQ,KAAK;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACZ,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAM/C;AAED,qBAAa,8BAA+B,SAAQ,KAAK;IACrD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACZ,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAM/C;AAED,qBAAa,4BAA6B,SAAQ,KAAK;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACd,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAKhD"}

package/dist/catalox/catalox-skill-errors.js

@@ -0,0 +1,29 @@
+export class CataloxSkillNotFoundError extends Error {
+    skillKey;
+    itemId;
+    constructor(skillKey, itemId) {
+        super(`[AI-SKILLS] No Catalox catalog item for skillKey=${skillKey} (itemId=${itemId})`);
+        this.name = "CataloxSkillNotFoundError";
+        this.skillKey = skillKey;
+        this.itemId = itemId;
+    }
+}
+export class CataloxSkillAlreadyExistsError extends Error {
+    skillKey;
+    itemId;
+    constructor(skillKey, itemId) {
+        super(`[AI-SKILLS] Catalox catalog item already exists for skillKey=${skillKey} (itemId=${itemId})`);
+        this.name = "CataloxSkillAlreadyExistsError";
+        this.skillKey = skillKey;
+        this.itemId = itemId;
+    }
+}
+export class CataloxSkillNotRunnableError extends Error {
+    skillKey;
+    constructor(skillKey, message) {
+        super(`[AI-SKILLS] ${message} (skillKey=${skillKey})`);
+        this.name = "CataloxSkillNotRunnableError";
+        this.skillKey = skillKey;
+    }
+}
+//# sourceMappingURL=catalox-skill-errors.js.map

package/dist/catalox/catalox-skill-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalox-skill-errors.js","sourceRoot":"","sources":["../../src/catalox/catalox-skill-errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACvC,QAAQ,CAAS;IACjB,MAAM,CAAS;IACxB,YAAY,QAAgB,EAAE,MAAc;QACxC,KAAK,CAAC,oDAAoD,QAAQ,YAAY,MAAM,GAAG,CAAC,CAAC;QACzF,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;CACJ;AAED,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IAC5C,QAAQ,CAAS;IACjB,MAAM,CAAS;IACxB,YAAY,QAAgB,EAAE,MAAc;QACxC,KAAK,CAAC,gEAAgE,QAAQ,YAAY,MAAM,GAAG,CAAC,CAAC;QACrG,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;QAC7C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;CACJ;AAED,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IAC1C,QAAQ,CAAS;IAC1B,YAAY,QAAgB,EAAE,OAAe;QACzC,KAAK,CAAC,eAAe,OAAO,cAAc,QAAQ,GAAG,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAC3C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;CACJ"}

package/dist/catalox/index.d.ts

@@ -0,0 +1,10 @@
+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_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 { 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";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/catalox/index.js

@@ -0,0 +1,10 @@
+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_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 { 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";
+//# sourceMappingURL=index.js.map

package/dist/catalox/index.js.map

@@ -0,0 +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"}

package/dist/catalox/init-firebase-and-catalox.d.ts

@@ -0,0 +1,8 @@
+import type { Catalox } from "@x12i/catalox";
+/**
+ * Idempotent Firebase Admin initialization from env (same rules as {@link createCataloxFromEnv}).
+ */
+export declare function initFirebaseAdminFromEnv(): void;
+/** Firestore-backed Catalox client (uses `FIRESTORE_DATABASE_ID` when set). */
+export declare function createCataloxFromEnv(): Catalox;
+//# sourceMappingURL=init-firebase-and-catalox.d.ts.map

package/dist/catalox/init-firebase-and-catalox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-firebase-and-catalox.d.ts","sourceRoot":"","sources":["../../src/catalox/init-firebase-and-catalox.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAc7C;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAG/C;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,IAAI,OAAO,CAkB9C"}

package/dist/catalox/init-firebase-and-catalox.js

@@ -0,0 +1,48 @@
+/**
+ * Shared Firebase Admin + Catalox wiring for apps, demos, and tests that read the `ai-skills` catalog.
+ *
+ * Delegates credential resolution to **`@x12i/catalox/firebase`** (Catalox **v4**): precedence is
+ * **`GOOGLE_SERVICE_ACCOUNT_BASE64`**, then optional **`serviceAccountPath` supplied only in code**
+ * (there is **no** env var for a service-account file path), then Application Default Credentials.
+ *
+ * **Project id:** only **`FIREBASE_PROJECT_ID`** (e.g. in `.env`). No implicit default from
+ * **`GCLOUD_PROJECT`**, **`GOOGLE_CLOUD_PROJECT`**, or **`project_id`** inside service-account JSON —
+ * the Firebase/GCP project for Catalox must be chosen explicitly.
+ */
+import { createCataloxFromEnv as cataloxCreateCataloxFromEnv, createCataloxFromFirebaseApp, createFirebaseAdminAppFromEnv, } from "@x12i/catalox/firebase";
+import { getApps } from "firebase-admin/app";
+/** Firebase Admin default app name (see firebase-admin lifecycle). */
+const FIREBASE_DEFAULT_APP_NAME = "[DEFAULT]";
+function resolveProjectId() {
+    const pid = process.env.FIREBASE_PROJECT_ID?.trim();
+    if (pid)
+        return pid;
+    throw new Error("[AI-SKILLS] Set FIREBASE_PROJECT_ID in your environment (e.g. .env). Implicit project id from gcloud or service-account JSON is not used.");
+}
+/**
+ * Idempotent Firebase Admin initialization from env (same rules as {@link createCataloxFromEnv}).
+ */
+export function initFirebaseAdminFromEnv() {
+    if (getApps().some((a) => a.name === FIREBASE_DEFAULT_APP_NAME))
+        return;
+    createFirebaseAdminAppFromEnv({ projectId: resolveProjectId() });
+}
+/** Firestore-backed Catalox client (uses `FIRESTORE_DATABASE_ID` when set). */
+export function createCataloxFromEnv() {
+    const dbId = process.env.FIRESTORE_DATABASE_ID?.trim();
+    const databaseId = dbId || undefined;
+    const existingDefault = getApps().find((a) => a.name === FIREBASE_DEFAULT_APP_NAME);
+    if (existingDefault) {
+        const { catalox } = createCataloxFromFirebaseApp({
+            app: existingDefault,
+            databaseId,
+        });
+        return catalox;
+    }
+    const { catalox } = cataloxCreateCataloxFromEnv({
+        projectId: resolveProjectId(),
+        databaseId,
+    });
+    return catalox;
+}
+//# sourceMappingURL=init-firebase-and-catalox.js.map

package/dist/catalox/init-firebase-and-catalox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-firebase-and-catalox.js","sourceRoot":"","sources":["../../src/catalox/init-firebase-and-catalox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACH,oBAAoB,IAAI,2BAA2B,EACnD,4BAA4B,EAC5B,6BAA6B,GAChC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,sEAAsE;AACtE,MAAM,yBAAyB,GAAG,WAAW,CAAC;AAE9C,SAAS,gBAAgB;IACrB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,CAAC;IACpD,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IACpB,MAAM,IAAI,KAAK,CACX,2IAA2I,CAC9I,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACpC,IAAI,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,yBAAyB,CAAC;QAAE,OAAO;IACxE,6BAA6B,CAAC,EAAE,SAAS,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,oBAAoB;IAChC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,EAAE,CAAC;IACvD,MAAM,UAAU,GAAG,IAAI,IAAI,SAAS,CAAC;IAErC,MAAM,eAAe,GAAG,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,yBAAyB,CAAC,CAAC;IACpF,IAAI,eAAe,EAAE,CAAC;QAClB,MAAM,EAAE,OAAO,EAAE,GAAG,4BAA4B,CAAC;YAC7C,GAAG,EAAE,eAAe;YACpB,UAAU;SACb,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,GAAG,2BAA2B,CAAC;QAC5C,SAAS,EAAE,gBAAgB,EAAE;QAC7B,UAAU;KACb,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,24 @@
+import type { Catalox, CatalogQueryOptions } from "@x12i/catalox";
+export type SkillRowStatus = "planned" | "draft" | "published";
+export type AiSkillsPublishedItem = {
+    skillKey: string;
+    title: string;
+    description: string;
+    isLocal: boolean;
+    status: SkillRowStatus;
+};
+export type ListAiSkillsCatalogItemsResult = {
+    listOutcome: "ok" | "mapping_blocked";
+    items: AiSkillsPublishedItem[];
+    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 catalogSkillKeyToRunSkillKey(skillKey: string): string;
+//# sourceMappingURL=list-ai-skills-catalog.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,38 @@
+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 : "";
+    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)
+        return null;
+    return { skillKey, title, description, isLocal, status };
+}
+/**
+ * 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 items = [];
+    for (const it of res.items) {
+        const row = asItem((it.data ?? {}));
+        if (row)
+            items.push(row);
+    }
+    return {
+        listOutcome: res.listOutcome,
+        items,
+        ...(res.issues ? { issues: res.issues } : {}),
+    };
+}
+/** Maps a short Catalox `skillKey` to the canonical `skills/<id>` form used in `runSkill`. */
+export function catalogSkillKeyToRunSkillKey(skillKey) {
+    return canonicalSkillKey(skillKey);
+}
+//# sourceMappingURL=list-ai-skills-catalog.js.map

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

@@ -0,0 +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"}

package/dist/catalox/skill-gateway-template-utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Normalize caller `skillKey` to canonical form `skills/<id>` (no `.instructions` / `.prompt` suffix).
+ * Used when resolving Catalox catalog item ids and gateway invoke keys.
+ */
+export declare function canonicalSkillKey(skillKey: string): string;
+/**
+ * nx-content / ai-gateway treat strings with **no whitespace** as registry keys.
+ * Ensure Catalox-sourced template bodies are always parsed as literal template text.
+ */
+export declare function ensureGatewayTreatsAsTemplateText(text: string): string;
+//# sourceMappingURL=skill-gateway-template-utils.d.ts.map

package/dist/catalox/skill-gateway-template-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-gateway-template-utils.d.ts","sourceRoot":"","sources":["../../src/catalox/skill-gateway-template-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAS1D;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMtE"}

package/dist/catalox/skill-gateway-template-utils.js

@@ -0,0 +1,31 @@
+/**
+ * Normalize caller `skillKey` to canonical form `skills/<id>` (no `.instructions` / `.prompt` suffix).
+ * Used when resolving Catalox catalog item ids and gateway invoke keys.
+ */
+export function canonicalSkillKey(skillKey) {
+    let s = skillKey.trim().replace(/\\/g, "/");
+    if (s.startsWith("./"))
+        s = s.slice(2);
+    if (s.startsWith("/"))
+        s = s.slice(1);
+    s = s.replace(/\.(instructions|prompt)(\.md)?$/i, "");
+    if (!s.startsWith("skills/")) {
+        s = `skills/${s}`;
+    }
+    return s;
+}
+/**
+ * nx-content / ai-gateway treat strings with **no whitespace** as registry keys.
+ * Ensure Catalox-sourced template bodies 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=skill-gateway-template-utils.js.map

package/dist/catalox/skill-gateway-template-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-gateway-template-utils.js","sourceRoot":"","sources":["../../src/catalox/skill-gateway-template-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAC9C,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC5C,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,kCAAkC,EAAE,EAAE,CAAC,CAAC;IACtD,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC;IACtB,CAAC;IACD,OAAO,CAAC,CAAC;AACb,CAAC;AAED;;;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/catalox/skill-template-catalog-mutations.d.ts

@@ -0,0 +1,143 @@
+import type { Catalox, CataloxContext } from "@x12i/catalox";
+import type { CatalogReleaseStatus } from "./ai-skills-catalog.js";
+import type { SkillCatalogStatus } from "./skill-templates.js";
+import { type ExtractedTemplateInputs } from "./skill-template-markdown.js";
+export type { ExtractedTemplateInputs } from "./skill-template-markdown.js";
+export type SkillTemplatesPresentation = {
+    /** Short catalog key (e.g. `professional-answer`). */
+    skillKey: string;
+    catalogItemId: string;
+    status: SkillCatalogStatus;
+    title: string;
+    description: string;
+    isLocal: boolean;
+    /** Always strings; empty when not stored. */
+    instructionsMarkdown: string;
+    promptMarkdown: string;
+    auditInstructionsMarkdown?: string;
+    auditPromptMarkdown?: string;
+};
+export type SkillTemplatePresentationPatch = {
+    instructionsMarkdown?: string;
+    promptMarkdown?: string;
+    auditInstructionsMarkdown?: string;
+    auditPromptMarkdown?: string;
+};
+export type UpsertSkillCatalogItemInput = {
+    skillKey: string;
+    title: string;
+    description: string;
+    isLocal: boolean;
+    instructionsMarkdown?: string;
+    promptMarkdown?: string;
+    auditInstructionsMarkdown?: string;
+    auditPromptMarkdown?: string;
+    catalogReleaseStatus?: CatalogReleaseStatus;
+};
+export type UpsertSkillCatalogItemOptions = {
+    /**
+     * When true, throws {@link CataloxSkillAlreadyExistsError} if the catalog row already exists.
+     */
+    ifNotExists?: boolean;
+};
+export type UpdateSkillTemplatesFromPresentationOptions = {
+    /**
+     * When set, drives `published` vs `draft` together with body completeness (see {@link computeSkillRowStatus}).
+     * When omitted: if the item was already `published`, it stays publishable (`published`); otherwise treated as `draft` path.
+     */
+    catalogReleaseStatus?: CatalogReleaseStatus;
+};
+/** Stable role ids for template bodies (matches Catalox `*Text` fields). */
+export declare const SKILL_TEMPLATE_ROLES_ORDER: readonly ["instructions", "prompt", "auditInstructions", "auditPrompt"];
+export type SkillTemplateRole = (typeof SKILL_TEMPLATE_ROLES_ORDER)[number];
+export type SkillContentPart = {
+    role: SkillTemplateRole;
+    content: string;
+};
+export type ModifySkillContentResult = {
+    success: true;
+} | {
+    success: false;
+    error: string;
+};
+export type CreateSubSkillOverrides = {
+    title?: string;
+    description?: string;
+    isLocal?: boolean;
+    instructionsMarkdown?: string;
+    promptMarkdown?: string;
+    auditInstructionsMarkdown?: string;
+    auditPromptMarkdown?: string;
+    catalogReleaseStatus?: CatalogReleaseStatus;
+};
+export type CreateSubSkillInput = {
+    sourceSkillKey: string;
+    newSkillKey: string;
+    overrides?: CreateSubSkillOverrides;
+};
+export type CreateSubSkillResult = {
+    success: true;
+} | {
+    success: false;
+    error: string;
+};
+export type DeleteSubSkillResult = {
+    success: true;
+} | {
+    success: false;
+    error: string;
+};
+/**
+ * Loads skill template bodies from Catalox and returns markdown formatted for editors / presentation.
+ * Requires Catalox read access for `appId` + catalog binding.
+ */
+export declare function getSkillTemplatesForPresentation(catalox: Catalox, context: CataloxContext, skillKey: string, options?: {
+    includeAudit?: boolean;
+}): Promise<SkillTemplatesPresentation>;
+/**
+ * Template bodies as `{ role, content }[]` (presentation markdown). Always four entries in stable order.
+ */
+export declare function getSkillContent(catalox: Catalox, context: CataloxContext, skillKey: string): Promise<SkillContentPart[]>;
+/**
+ * Unique `{{token}}` names across all template bodies (same presentation strings as {@link getSkillContent}).
+ */
+export declare function getSkillTokens(catalox: Catalox, context: CataloxContext, skillKey: string): Promise<string[]>;
+/**
+ * Partial template update by role. Returns structured success/failure (including Catalox/not-found errors).
+ */
+export declare function modifySkillContent(catalox: Catalox, context: CataloxContext, skillKey: string, parts: SkillContentPart[], options?: UpdateSkillTemplatesFromPresentationOptions): Promise<ModifySkillContentResult>;
+/**
+ * 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 declare function updateSkillTemplatesFromPresentation(catalox: Catalox, context: CataloxContext, skillKey: string, patch: SkillTemplatePresentationPatch, options?: UpdateSkillTemplatesFromPresentationOptions): Promise<void>;
+/**
+ * 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 declare function upsertSkillCatalogItem(catalox: Catalox, context: CataloxContext, input: UpsertSkillCatalogItemInput, options?: UpsertSkillCatalogItemOptions): Promise<void>;
+/**
+ * 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 declare function softDeleteSkillCatalogItem(catalox: Catalox, context: CataloxContext, skillKey: string): Promise<void>;
+/**
+ * Duplicates a catalog skill into a new key, marking it with `parentSkillKey`. Structured success/failure.
+ */
+export declare function createSubSkill(catalox: Catalox, context: CataloxContext, input: CreateSubSkillInput): Promise<CreateSubSkillResult>;
+/**
+ * Deletes a native catalog row only when it is a sub-skill (`parentSkillKey` set).
+ */
+export declare function deleteSubSkill(catalox: Catalox, context: CataloxContext, subSkillKey: string): Promise<DeleteSubSkillResult>;
+/**
+ * Returns unique `{{token}}` names from raw Catalox template strings (before presentation transforms).
+ */
+export declare function getSkillTemplateInputs(catalox: Catalox, context: CataloxContext, skillKey: string): Promise<ExtractedTemplateInputs>;
+//# sourceMappingURL=skill-template-catalog-mutations.d.ts.map