@exellix/ai-skills 7.0.20 → 7.0.21

package/README.md

@@ -4,14 +4,14 @@ Foundational skill execution layer for the exellix ecosystem: templates live in
 
 🚀 **Env-Ready**: Provider keys can be loaded from `.env` automatically. **`catalox` is required** at construction time (see Quick Start).
 
-> **Catalox 6 train:** **`@exellix/xynthesis`** in this monorepo already uses **Catalox 6 / Mongo**. This package and **`@exellix/catalox-ai-skills`** still use **Firebase / Firestore** until the rollout completes. See [**`documenations/catalox-6-rollout.md`**](../documenations/catalox-6-rollout.md).
+> **Catalox 6:** Skill catalogs bootstrap via **Mongo** (`ensureCataloxFromEnv` / `createCataloxFromEnvAsync` from **`@exellix/catalox-ai-skills`**). Env: **`MONGO_URI`** or **`MONGODB_URI`**. See [**`documenations/catalox-6-rollout.md`**](../documenations/catalox-6-rollout.md).
 
 ## Documentation
 
 | Topic | Doc |
 |--------|-----|
 | Flex-MD vs gateway parsing, integration tests | **[docs/FLEX_MD_AND_TESTING.md](docs/FLEX_MD_AND_TESTING.md)** |
-| Catalox integration & env notes | **[docs/CATALOX_PEER_GUIDE.md](docs/CATALOX_PEER_GUIDE.md)** · [Environment (Firebase & Catalox v4)](#environment-firebase--catalox-v4) |
+| Catalox integration & env notes | **[docs/CATALOX_PEER_GUIDE.md](docs/CATALOX_PEER_GUIDE.md)** · [Environment (Mongo & Catalox 6)](#environment-mongo--catalox-6) |
 | Activix integration best practices | **[.docs/activix-integration-best-practices-checklist.md](.docs/activix-integration-best-practices-checklist.md)** |
 | Per-package log level (`AI_SKILLS_LOGS_LEVEL`) | **[Logging](#logging-aiskills--x12ilogxer)** below · [Logxer integration checklist](docs/LOGXER_INTEGRATION_CHECKLIST.md) · [@x12i/logxer on npm](https://www.npmjs.com/package/@x12i/logxer) |
 | Gateway templates (v4), `invoke()` vs `invokeChat()`, `templateRendering` | **[docs/GATEWAY_TEMPLATE_PROTOCOL_V4.md](docs/GATEWAY_TEMPLATE_PROTOCOL_V4.md)** |
@@ -47,7 +47,7 @@ Foundational skill execution layer for the exellix ecosystem: templates live in
 npm install @exellix/ai-skills
 ```
 
-This package depends on **`@x12i/ai-gateway`**, **`@x12i/catalox`**, **`@x12i/logxer`**, **`@x12i/env`**, **`@x12i/rendrix`**, and **`firebase-admin`** (for Firestore-backed Catalox). **`@x12i/catalox` ≥ 4.0** expects **Node 20+**. Align **`firebase-admin`** / **`@x12i/catalox`** versions with your app if you share a Firebase app instance.
+This package depends on **`@x12i/ai-gateway`**, **`@x12i/catalox`**, **`@x12i/logxer`**, **`@x12i/env`**, **`@x12i/rendrix`**, and **`@exellix/catalox-ai-skills`** (Mongo Catalox bootstrap). **`@x12i/catalox` ≥ 6.0** expects **Node 20+**.
 
 **`@x12i/ai-gateway` ≥ 11.0.0** (openrouter-runtime **1.0.4**, `@x12i/ai-tools` **3.3.5**) (see `package.json`) with **`@x12i/activix` ^9.0** and **`@x12i/ai-profiles` ^3.4** is required: every invoke needs an explicit wire **`model`** and **`maxTokens`** (this package supplies **`maxTokens`** via **`@x12i/optimixer`** before `gateway.invoke()`). Invoke **`metadata`** includes routing fields (≥9.1.1), rejection **`metadata`** on failures (≥9.1.2), normalized billing (**`costUsd`**, **`cost`**, **`costStatus: priced | unpriced`**, optional **`costBreakdown`**) on success (≥9.3; ai-tools catalog pricing in gateway ≥10.1), and optional **OpenRouter server-tool metadata** (≥10.4.1). **This package does not use `@x12i/ai-tools` directly** — cost is resolved by the gateway. See **`docs/UPGRADING_AI_GATEWAY_10.md`** and **`docs/AI_GATEWAY_INVOKE_EXECUTION_METADATA.md`**. Every **`runSkill`** call must include **`agentId`**, **`jobTypeId`**, and **`taskTypeId`** (Activix linkage — no package defaults).
 
@@ -57,17 +57,14 @@ Custom admin flows that call Catalox with **`createCatalog`**, **`bindCatalogToA
 
 **Publishing:** the npm tarball is limited to **`dist/`**, **`README.md`**, and **`erc-manifest.json`** via the **`files`** field in **`package.json`** (avoids shipping tests, logs, or local scratch files).
 
-## Environment variables (Firebase & Catalox v4)
+## Environment variables (Mongo & Catalox 6)
 
-**`createCataloxFromEnv()`** in this package delegates credential resolution to **`@x12i/catalox/firebase`** (same precedence as upstream Catalox **v4**).
+**`createCataloxFromEnvAsync()`** / **`ensureCataloxFromEnv()`** from **`@exellix/catalox-ai-skills`** delegate to **`@x12i/catalox/mongo`**.
 
 | Variable | Notes |
 |----------|--------|
-| **`FIREBASE_PROJECT_ID`** | **Required** for this package’s **`createCataloxFromEnv()`** wiring: set it in `.env` or the process environment. Project id is **not** inferred from **`GCLOUD_PROJECT`**, **`GOOGLE_CLOUD_PROJECT`**, or service-account JSON. |
-| **`GOOGLE_SERVICE_ACCOUNT_BASE64`** | Recommended for CI and scripts: standard Google **service account JSON**, base64-encoded, passed to Admin **`cert(...)`**. |
-| **`FIRESTORE_DATABASE_ID`** | Optional named Firestore database id; omit for the default database. |
-
-**Not supported in Catalox v4:** an environment variable (or secret-token **`_path`** field) that points at a **service-account JSON file on disk**. Use **`GOOGLE_SERVICE_ACCOUNT_BASE64`**, Application Default Credentials (workload identity, **`GOOGLE_APPLICATION_CREDENTIALS`**, etc.), or load a key file **in your application** and pass **`cert(...)`** / Catalox’s **`serviceAccountPath`** bootstrap **option** (caller-supplied string only).
+| **`MONGO_URI`** or **`MONGODB_URI`** | **Required** — Mongo connection string for Catalox catalogs |
+| **`MONGO_DB_NAME`** / **`MONGODB_DB`** | Optional database name (default `catalox`) |
 
 Provider keys for the default gateway (**`OPENAI_API_KEY`**, **`GROK_API_KEY`**, **`OPEN_ROUTER_KEY`** / **`OPENROUTER_API_KEY`**) are unchanged — see **Troubleshooting** below.
 
@@ -76,7 +73,7 @@ Provider keys for the default gateway (**`OPENAI_API_KEY`**, **`GROK_API_KEY`**,
 ### 0) Prerequisites
 
 1. **Node.js 20+** — matches **`@x12i/catalox`** engine requirements.
-2. **Firebase / Firestore** — set **`FIREBASE_PROJECT_ID`** (see [above](#environment-firebase--catalox-v4)) and **`GOOGLE_SERVICE_ACCOUNT_BASE64`**. **`createCataloxFromEnv()`** uses **`@x12i/catalox/firebase`** under the hood. You can instead construct **`Catalox`** with **`createCatalox`** from **`@x12i/catalox`** / **`@x12i/catalox/embedder`** and your own **`Firestore`** instance.
+2. **Mongo Catalox** — set **`MONGO_URI`** or **`MONGODB_URI`** (see [above](#environment-mongo--catalox-6)). Use **`await createCataloxFromEnvAsync()`** or pass your own **`Catalox`** from **`createCataloxFromMongoEnv`**.
 3. **Provision the catalog** (creates/updates Catalox app bindings, descriptors, and skill rows):
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exellix/ai-skills",
-  "version": "7.0.20",
+  "version": "7.0.21",
   "description": "Foundational skill execution layer for exellix ecosystem using @x12i/ai-gateway with FlexMD 2.0 support and Catalox as the catalog store",
   "type": "module",
   "main": "dist/index.js",
@@ -61,9 +61,9 @@
   },
   "dependencies": {
     "@exellix/catalox-ai-skills": "^1.0.7",
-    "@x12i/activix": "^9.0.5",
-    "@x12i/ai-gateway": "^11.1.3",
-    "@x12i/ai-profiles": "^4.3.0",
+    "@x12i/activix": "^9.0.6",
+    "@x12i/ai-gateway": "^11.1.4",
+    "@x12i/ai-profiles": "^4.4.0",
     "@x12i/catalox": "^6.0.0",
     "@x12i/env": "^4.0.3",
     "@x12i/execution-memory-manager": "^1.2.0",