@exellix/ai-tasks 8.2.1 → 8.2.3

package/documenations/activix.md

@@ -1,10 +1,10 @@
 # Activix Integration
 
-This packaged doc summarizes task-activity tracking via `@xronoces/activix`.
+This packaged doc summarizes task-activity tracking via `@x12i/activix`.
 
 ## Activix Integration Best Practices Checklist
 
-Use this as the operational checklist for integrating `@xronoces/activix` correctly and consistently.
+Use this as the operational checklist for integrating `@x12i/activix` correctly and consistently.
 
 ### 1) Ownership and boundaries
 
@@ -86,6 +86,17 @@ const { activityId } = await ax.startRecord({
   - `createdAt`, `updatedAt`
   - `error` (except via `failRecord`)
 
+### 6b) Collection tracking state (Activix 8.4+) — always call, let Activix persist
+
+- **Always call** Activix lifecycle APIs on every AI activity phase (`startRecord`, `completeRecord`, `failRecord`, …).
+- **Do not** branch in ai-tasks (or other integrators) on whether to write to Mongo.
+- Activix reads the **`activix-collections`** legend row for your collection and its **`state`**:
+  - **`track`** (default) — rows are persisted
+  - **`off`** — same API and return shapes; Mongo writes are skipped
+- Toggle persistence at runtime: `setCollectionTrackingState('task-activities', 'off' | 'track')`.
+- ai-tasks constructs Activix when **`MONGO_URI`** or **`MONGO_LOGS_URI`** is set; set **`ACTIVIX_ENABLED=false`** only to skip client construction entirely (dev/CI zero-overhead escape hatch).
+- Package collection name is **`task-activities`** (hard-coded in `src/activix/activixClient.ts`).
+
 ### 7) Validate shape and observability expectations
 
 - `outer` is required and must contain:
@@ -155,7 +166,8 @@ All records for a run share a correlation id for grouping.
 
 ## Enablement
 
-- Controlled by `ACTIVIX_ENABLED` (default off in README guidance).
+- **Client wiring:** Activix is constructed when `MONGO_URI` or `MONGO_LOGS_URI` is set. Set `ACTIVIX_ENABLED=false` to opt out (no client, no lifecycle API calls).
+- **Mongo persistence:** Controlled by Activix collection legend **`state`** (`track` | `off`) in `activix-collections`, not by a required `ACTIVIX_ENABLED=true` flag. ai-tasks always calls lifecycle APIs when wired; Activix decides whether rows reach Mongo.
 - Activix failures are treated as non-fatal to task execution.
 
 ## Typical metadata

package/documenations/xynthesis-activix-telemetry.md

@@ -25,4 +25,4 @@ In **`exellix/xynthesis`** (`src/activix.ts`, `getActivix`), pass **`diagnostics
 ## Related
 
 - Gateway-side Activix (**`@x12i/ai-gateway`**) is separate from xynthesis’ singleton.
-- ai-tasks **`ACTIVIX_ENABLED`** / **`src/activix/activixClient.ts`** is separate from xynthesis telemetry.
+- ai-tasks Activix wiring: **`src/activix/activixClient.ts`** — constructs when Mongo is configured; persistence toggled via **`activix-collections`** legend `state` (Activix 8.4+), not `ACTIVIX_ENABLED=true`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exellix/ai-tasks",
-  "version": "8.2.1",
+  "version": "8.2.3",
   "description": "Task orchestration for the Exellix stack: runTask() with local handlers or LLM-backed execution, task-scoped memory/context enrichment, and executor dispatch via @exellix/ai-skills. ERC-compliant.",
   "type": "module",
   "main": "dist/index.js",
@@ -22,11 +22,12 @@
     "dev": "ts-node src/index.ts",
     "prepublishOnly": "npm run build && node scripts/ensure-nx-content-md-variants.mjs",
     "deps:latest": "npx npm-check-updates -u && npm install",
-    "test": "node scripts/ensure-xynthesis-dist.mjs && node scripts/clean-dist-test.mjs && tsc -p tsconfig.test.json && node scripts/copy-test-fixtures.mjs && node --test --test-force-exit --test-concurrency=1 dist-test/test/narrix/*.js dist-test/test/narrix-then-execute/*.js dist-test/test/aiScoping/*.js dist-test/test/intermediateSteps/*.js dist-test/test/post-steps/*.js dist-test/test/planWebScopeQuestions/*.js dist-test/test/synthesis/*.js dist-test/test/utils/*.js dist-test/test/errors/*.js dist-test/test/validation/*.js dist-test/test/compile/*.js dist-test/test/task-strategies/*.js dist-test/test/observability/*.js dist-test/test/run-task/*.js dist-test/test/internal/*.js dist-test/test/execution-strategies/*.js dist-test/test/invocation/*.js",
+    "test": "node scripts/ensure-xynthesis-dist.mjs && node scripts/clean-dist-test.mjs && tsc -p tsconfig.test.json && node scripts/copy-test-fixtures.mjs && node --test --test-force-exit --test-concurrency=1 dist-test/test/narrix/*.js dist-test/test/narrix-then-execute/*.js dist-test/test/aiScoping/*.js dist-test/test/intermediateSteps/*.js dist-test/test/post-steps/*.js dist-test/test/planWebScopeQuestions/*.js dist-test/test/synthesis/*.js dist-test/test/utils/*.js dist-test/test/errors/*.js dist-test/test/validation/*.js dist-test/test/compile/*.js dist-test/test/task-strategies/*.js dist-test/test/observability/*.js dist-test/test/run-task/*.js dist-test/test/internal/*.js dist-test/test/execution-strategies/*.js dist-test/test/invocation/*.js dist-test/test/e2e/*.js",
     "test:with-narrix-ingest": "node scripts/run-npm-test-with-narrix-ingest.mjs",
     "test:e2e:intermediateSteps": "node scripts/run-with-env.mjs RUN_INTERMEDIATE_STEPS_E2E=1 npm run test",
     "test:e2e:synthesis": "node scripts/run-synthesis-e2e.mjs",
     "test:e2e:webScope": "node scripts/run-web-scope-e2e.mjs",
+    "test:live": "node scripts/run-live-ai-e2e.mjs",
     "test:narrix:live": "node scripts/check-narrix-archive.mjs && node scripts/run-npm-test-with-narrix-ingest.mjs",
     "local:narrix:subnets": "node dist/localTasks/narrixSubnetPlayground.js",
     "local:narrix:assets": "node dist/localTasks/narrixAssetPlayground.js",
@@ -64,7 +65,7 @@
     "@x12i/logxer": "$@x12i/logxer"
   },
   "dependencies": {
-    "@exellix/ai-skills": "^5.9.0",
+    "@exellix/ai-skills": "^5.9.4",
     "@exellix/memorix-narrix-adapter": "^2.0.0",
     "@exellix/narrix-adapter-chat": "^2.0.0",
     "@exellix/narrix-adapter-docs": "^2.0.0",
@@ -76,13 +77,13 @@
     "@exellix/narrix-ingest": "^2.0.0",
     "@exellix/narrix-runner": "^2.0.0",
     "@exellix/narrix-web-scoper": "^2.0.0",
-    "@exellix/xynthesis": "^4.0.16",
-    "@x12i/activix": "^8.3.1",
-    "@x12i/ai-profiles": "^1.7.0",
+    "@exellix/xynthesis": "^4.1.5",
+    "@x12i/activix": "^8.4.1",
+    "@x12i/ai-profiles": "^1.7.2",
     "@x12i/catalox": "^5.1.3",
     "@x12i/env": "^4.0.1",
     "@x12i/execution-memory-manager": "^1.2.0",
-    "@x12i/funcx": "^4.2.4",
+    "@x12i/funcx": "^4.2.8",
     "@x12i/logxer": "^4.6.0",
     "@x12i/rendrix": "^4.3.0",
     "@x12i/search-adapter": "^1.5.1",