@exellix/ai-tasks 8.2.1 → 8.2.3

package/.env.example

@@ -1,13 +1,3 @@
-# ============================================
-# LLM routing (see .docs/prefer-openrouter-routing-policy.md)
-# ============================================
-# Prefer OpenRouter when OPENROUTER_API_KEY is set (default when omitted).
-# PREFER_OPENROUTER=true
-# PREFER_OPENROUTER=false
-# Deprecated alias: USE_OPENROUTER (read only if PREFER_OPENROUTER unset)
-# OPENROUTER_API_KEY=
-# ANTHROPIC_API_KEY=
-
 # ============================================
 # nx-mongo Configuration
 # ============================================

package/.metadata/log-diagnostics.json

@@ -72,5 +72,18 @@
     "retryable": true,
     "userActionRequired": false,
     "confidence": "medium"
+  },
+  "LLM_PROVIDER_INVOCATION": {
+    "defaultLevel": "warn",
+    "title": "LLM provider invocation routing",
+    "impact": "Structured per-phase model routing and best-effort HTTP endpoint confirmation for PRE, MAIN, and POST LLM calls.",
+    "remediation": [
+      "Compare intendedBaseUrl and routing with observedProvider/httpEndpoint.",
+      "PRE/POST xynthesis uses FuncX OpenRouter when OPENROUTER_API_KEY is set; MAIN skill routing is separate via ai-skills.",
+      "Search FUNCX / ai-skills activity logs for openrouter.ai when httpConfirmed is false."
+    ],
+    "retryable": true,
+    "userActionRequired": false,
+    "confidence": "medium"
   }
 }

package/README.md

@@ -2389,52 +2389,79 @@ console.log(result.flexMd.payloads);
 
 ## Activix — task activity tracking
 
-`@xronoces/activix` is used here for multi-phase activity tracking: each `runTask()` invocation writes several phase records to MongoDB (`local`, `narrix`, `pipeline_pre`, `direct`, `audit`, `polish`, `narrix_then_direct`). All phase records share the same `correlationId`, so you can group them back into one logical task run.
+`@x12i/activix` (**8.4+**) provides multi-phase activity tracking: each `runTask()` invocation emits several phase records (`local`, `narrix`, `pipeline_pre`, `direct`, `audit`, `polish`, `narrix_then_direct`). All phase records share the same `correlationId` (runtime `taskId`), so you can group them into one logical task run.
 
-**Best practices checklist:** see [documenations/activix.md](./documenations/activix.md) (includes an operational integration checklist + deeper references under `.docs/`).
+**Operational checklist:** [documenations/activix.md](./documenations/activix.md) · **Full reference:** [docs/activix.md](./docs/activix.md)
 
-### Enable / disable
+### How wiring works (Activix 8.4+)
+
+ai-tasks **always calls Activix lifecycle APIs** on AI activity phases when Mongo is configured. **Activix decides whether rows are persisted** — do not branch in application code on a local write toggle.
 
 ```
-ACTIVIX_ENABLED=false   # set true to activate
+runTask() phase  →  startRecord / completeRecord / failRecord
+                              ↓
+              activix-collections legend state
+              track → Mongo write    |    off → same API, skip write
 ```
 
-When `false` (the default), `runTask()` runs exactly as today with zero overhead. All activix calls are non-fatal — a MongoDB outage will never surface to the `runTask()` caller.
+| Layer | Owns |
+|---|---|
+| **ai-tasks** | Construct Activix when `MONGO_URI` or `MONGO_LOGS_URI` is set; call lifecycle APIs per phase; pass `runContext`, `outer`, domain metadata |
+| **Activix** | `recordId`, `status`, `startTime`, `endTime`, `duration`; read legend `state` and skip or perform Mongo writes |
+| **Ops** | Toggle persistence via `activix-collections` (`state: track \| off`) or `setCollectionTrackingState()` — no redeploy required |
+
+Lifecycle fields (`status`, timestamps, primary key) are **never** set by ai-tasks; Activix manages them on every write.
+
+### Enable / disable
+
+**Client construction** (whether phase APIs are called):
+
+- **On by default** when `MONGO_URI` or `MONGO_LOGS_URI` is set.
+- **Opt out entirely:** `ACTIVIX_ENABLED=false` — no Activix client, no API calls (zero overhead for local dev/CI).
+- **`ACTIVIX_ENABLED=true` is no longer required** to turn tracking on.
+
+**Mongo persistence** (whether rows reach the database):
+
+- Controlled by Activix collection legend **`state`** in `activix-collections` (default **`track`**).
+- Set **`off`** to skip writes while keeping the same API surface: `await ax.setCollectionTrackingState('task-activities', 'off')`.
+- Legend state is cached (default TTL **600 s**); override with `ACTIVIX_COLLECTION_TRACKING_STATE_TTL_SEC`.
+
+All Activix failures are **non-fatal** — a MongoDB outage never surfaces to the `runTask()` caller.
 
 ### Configuration
 
 | Variable | Default | Description |
 |---|---|---|
-| `ACTIVIX_ENABLED` | `false` | Master toggle |
-| `ACTIVIX_DB` | `MONGO_LOGS_DB` | MongoDB database for activity records |
-| `ACTIVIX_COLLECTION` | `task-activities` | Collection name |
+| `MONGO_URI` / `MONGO_LOGS_URI` | — | Required to construct Activix (first set wins) |
+| `ACTIVIX_ENABLED` | _(unset)_ | Set to `false` to opt out of client construction |
+| `ACTIVIX_COLLECTION` | `task-activities` | Dev/CI override only; package hard-codes `task-activities` in source |
 | `ACTIVIX_STALE_TTL_MS` | `300000` | TTL (ms) before a stuck `started` record is marked `timeout` |
-| `ACTIVIX_LOGS_LEVEL` | _(see below)_ | Canonical internal log threshold for injected Activix logger (`@x12i/logxer` `createLogxer`, env prefix **`ACTIVIX`**). If unset, falls back to `ACTIVIX_LOG_LEVEL`, then default `warn`. Values: `verbose` \| `debug` \| `info` \| `warn` \| `error` \| `off` / `silent` / `none`. |
-| `ACTIVIX_LOG_LEVEL` | `warn` | Legacy alias when `ACTIVIX_LOGS_LEVEL` is unset (same resolution rules as `@x12i/logxer`). |
-| `AI_TASKS_LOGS_LEVEL` | `warn` | Canonical threshold for `@exellix/ai-tasks` diagnostics (`AI_TASKS_REQUEST_WARNINGS`, execution-strategy warnings, optional `NARRIX_DEBUG` paths). Uses **`@x12i/logxer` 4.4.2** **`warnCode`** + catalog (`.metadata/log-diagnostics.json`). Legacy alias: `AI_TASKS_LOG_LEVEL`. |
+| `ACTIVIX_COLLECTION_TRACKING_STATE_TTL_SEC` | `600` | Legend `state` cache TTL (Activix 8.4+) |
+| `ACTIVIX_LOGS_LEVEL` | _(see below)_ | Injected Activix logger threshold (`@x12i/logxer`, prefix **`ACTIVIX`**). Falls back to `ACTIVIX_LOG_LEVEL`, then `warn`. Values: `verbose` \| `debug` \| `info` \| `warn` \| `error` \| `off` / `silent` / `none`. |
+| `ACTIVIX_LOG_LEVEL` | `warn` | Legacy alias when `ACTIVIX_LOGS_LEVEL` is unset |
+| `AI_TASKS_LOGS_LEVEL` | `warn` | ai-tasks diagnostics threshold (`warnCode` + `.metadata/log-diagnostics.json`). Legacy alias: `AI_TASKS_LOG_LEVEL`. |
+
+**Debug tooling (logxer 4.4.2):** **`getAiTasksJobLogs({ jobId, level, limit })`** queries in-process structured log envelopes captured during **`runTask()`**. Correlation ids are set via **`runAiTasksWithLogContext`** / **`patchRunTaskLogContext`**.
 
-**Debug tooling (logxer 4.4.2):** **`getAiTasksJobLogs({ jobId, level, limit })`** queries in-process structured log envelopes captured during **`runTask()`**. Correlation ids (`jobId`, `taskId`, `graphId`, `nodeId`) are set via **`runAiTasksWithLogContext`** / **`patchRunTaskLogContext`** (re-exported from this package).
+**Query API:** **`getTaskActivities(taskId)`** returns all phase records for one run (by `correlationId`).
 
 ### What is recorded
 
-Each record in `ACTIVIX_COLLECTION` captures:
+Each record in the `task-activities` collection captures:
 
 - `correlationId`, `phase` — join key for grouping phase records into one `runTask()` invocation
-- `runContext` (Activix 6+) — correlation envelope: `sessionId` matches `correlationId`, plus task fields that used to be duplicated as a top-level `identity` blob (`taskId`, `skillId`, etc.) now live here only
-- `outer` (Activix 6+) — required activity I/O tier (`input` / `output` / `metadata`); phase tracking uses minimal placeholders until completion metadata is merged
+- `runContext` — correlation envelope: `sessionId` matches `correlationId`; `taskId`, `skillId`, graph/node ids live here (not a top-level `identity` blob)
+- `outer` — required I/O tier (`input` / `output` / `metadata`); minimal placeholders until completion metadata is merged
 - `skillKey`, `executionType`, `jobId`, `agentId`, `graphId`, `nodeId` — from the request
 - `hasPipeline`, `hasNarrix`, `hasNarrixInput` — execution path flags
-- `status` — `started` → `completed` | `failed` | `timeout`
-- `startTime`, `endTime`, `duration` — auto-managed by activix
-- `instructionVersion`, `durationMs`, `stepCount` — from the response on success
+- `status`, `startTime`, `endTime`, `duration` — **auto-managed by Activix**
+- `instructionVersion`, `durationMs`, `stepCount` — from the response on success (phase-dependent)
 - `error` / `errorMessage`, `errorCode` — on failure
 
 ### Stale record cleanup
 
 Crashed or hung tasks leave records stuck in `started`. Call `ax.markStaleRecords()` from a periodic job (e.g. every 5 minutes) in the host process to flip them to `timeout`.
 
-**Full integration plan → [documenations/activix.md](./documenations/activix.md)**
-
 ---
 
 ## Development Notes
@@ -2544,5 +2571,5 @@ ISC
 - [documenations/synthesized-context-guide.md](./documenations/synthesized-context-guide.md) - User-facing guide for `synthesized-context` PRE-step behavior and controls
 - [documenations/task-core-and-core-aware-synthesis.md](./documenations/task-core-and-core-aware-synthesis.md) - Template core token model and structured synthesis behavior
 - [documenations/synthesis-invocation-notes.md](./documenations/synthesis-invocation-notes.md) - Notes on synthesis call behavior, cost, and operational implications
-- [documenations/activix.md](./documenations/activix.md) - Activix integration plan: task activity lifecycle tracking, record schema, env config, execution path mapping, and stale cleanup: `enableWebScope`, `narrix.webScoping` vs `@exellix/narrix-web-scoper` / `@exellix/search-adapter`, `executionMemory.webContext`, source snippets
+- [documenations/activix.md](./documenations/activix.md) - Activix integration: lifecycle tracking, collection legend `state` (Activix 8.4+), record schema, env config, execution path mapping, stale cleanup
 - [documenations/downstream-test-runtime-teardown-cleanup.md](./documenations/downstream-test-runtime-teardown-cleanup.md) - Downstream `ai-skills` lifecycle cleanup note for open handles/process-exit hygiene in tests

package/dist/activix/activixClient.d.ts

@@ -1,6 +1,19 @@
 import { Activix } from "@x12i/activix";
+/** Package-owned Activix collection (Activix 7+ — hard-code in source; do not override in production). */
+export declare const TASK_ACTIVITIES_COLLECTION: "task-activities";
 /** MongoDB collection name for task activity records (must match `getActivixClient` and `getTaskActivities`). */
 export declare function getActivixCollectionName(): string;
+/**
+ * Whether ai-tasks constructs an Activix client and calls lifecycle APIs on AI activity phases.
+ *
+ * **Persistence** (Mongo writes) is controlled by Activix collection legend `state` (`track` | `off`) in
+ * `activix-collections`, not by this helper. Integrators always call `startRecord` / `completeRecord` /
+ * `failRecord`; Activix decides whether rows reach Mongo.
+ *
+ * Returns `false` when Mongo is not configured, or when `ACTIVIX_ENABLED=false` (explicit opt-out).
+ */
+export declare function isActivixWired(): boolean;
+/** @deprecated Prefer {@link isActivixWired}. Kept for callers that checked the old `ACTIVIX_ENABLED=true` gate. */
 export declare function isActivixEnabled(): boolean;
 export declare function getActivixClient(): Promise<Activix | null>;
 //# sourceMappingURL=activixClient.d.ts.map

package/dist/activix/activixClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activixClient.d.ts","sourceRoot":"","sources":["../../src/activix/activixClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAOxC,iHAAiH;AACjH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAwEhE"}
+{"version":3,"file":"activixClient.d.ts","sourceRoot":"","sources":["../../src/activix/activixClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAOxC,0GAA0G;AAC1G,eAAO,MAAM,0BAA0B,EAAG,iBAA0B,CAAC;AAErE,iHAAiH;AACjH,wBAAgB,wBAAwB,IAAI,MAAM,CAGjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAGxC;AAED,oHAAoH;AACpH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CA4EhE"}

package/dist/activix/activixClient.js

@@ -2,15 +2,33 @@ import { Activix } from "@x12i/activix";
 import { getActivixLogxer, toActivixLogger } from "../logxer/packageLogxers.js";
 let _client = null;
 let _initPromise = null;
+/** Package-owned Activix collection (Activix 7+ — hard-code in source; do not override in production). */
+export const TASK_ACTIVITIES_COLLECTION = "task-activities";
 /** MongoDB collection name for task activity records (must match `getActivixClient` and `getTaskActivities`). */
 export function getActivixCollectionName() {
-    return process.env.ACTIVIX_COLLECTION ?? "task-activities";
+    const fromEnv = process.env.ACTIVIX_COLLECTION?.trim();
+    return fromEnv || TASK_ACTIVITIES_COLLECTION;
 }
+/**
+ * Whether ai-tasks constructs an Activix client and calls lifecycle APIs on AI activity phases.
+ *
+ * **Persistence** (Mongo writes) is controlled by Activix collection legend `state` (`track` | `off`) in
+ * `activix-collections`, not by this helper. Integrators always call `startRecord` / `completeRecord` /
+ * `failRecord`; Activix decides whether rows reach Mongo.
+ *
+ * Returns `false` when Mongo is not configured, or when `ACTIVIX_ENABLED=false` (explicit opt-out).
+ */
+export function isActivixWired() {
+    if (process.env.ACTIVIX_ENABLED === "false")
+        return false;
+    return !!(process.env.MONGO_URI?.trim() || process.env.MONGO_LOGS_URI?.trim());
+}
+/** @deprecated Prefer {@link isActivixWired}. Kept for callers that checked the old `ACTIVIX_ENABLED=true` gate. */
 export function isActivixEnabled() {
-    return process.env.ACTIVIX_ENABLED === "true";
+    return isActivixWired();
 }
 export async function getActivixClient() {
-    if (!isActivixEnabled())
+    if (!isActivixWired())
         return null;
     if (_client) {
         if (!_initPromise)
@@ -63,6 +81,10 @@ export async function getActivixClient() {
         collections: [collectionConfig],
         defaultCollection: collectionName,
         staleRecordTTL,
+        diagnostics: {
+            owner: "@exellix/ai-tasks",
+            component: "task-activities",
+        },
         logger: toActivixLogger(getActivixLogxer()),
     });
     _client = ax;

package/dist/activix/activixClient.js.map

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

package/dist/activix/getTaskActivities.d.ts

@@ -3,7 +3,7 @@ export type TaskActivityRecord = Record<string, unknown>;
  * Retrieve Activix phase records for a single logical task run.
  *
  * Notes:
- * - Requires `ACTIVIX_ENABLED=true` and Mongo configured (same as tracking).
+ * - Requires Mongo configured (`MONGO_URI` or `MONGO_LOGS_URI`) and Activix not opted out (`ACTIVIX_ENABLED=false`).
  * - `taskId` is the runtime task identifier and also the Activix `correlationId`.
  */
 export declare function getTaskActivities(taskId: string): Promise<TaskActivityRecord[]>;

package/dist/activix/getTaskActivities.js

@@ -3,7 +3,7 @@ import { getActivixClient, getActivixCollectionName } from "./activixClient.js";
  * Retrieve Activix phase records for a single logical task run.
  *
  * Notes:
- * - Requires `ACTIVIX_ENABLED=true` and Mongo configured (same as tracking).
+ * - Requires Mongo configured (`MONGO_URI` or `MONGO_LOGS_URI`) and Activix not opted out (`ACTIVIX_ENABLED=false`).
  * - `taskId` is the runtime task identifier and also the Activix `correlationId`.
  */
 export async function getTaskActivities(taskId) {

package/dist/activix/phaseTracking.js

@@ -6,7 +6,7 @@ export function createPhaseMeta(args) {
 async function safeStartPhase(ax, meta) {
     try {
         const r = await ax.startRecord(meta);
-        return r.recordId;
+        return r.activityId ?? r.recordId ?? null;
     }
     catch {
         return null;

package/dist/activix/phaseTracking.js.map

@@ -1 +1 @@
-{"version":3,"file":"phaseTracking.js","sourceRoot":"","sources":["../../src/activix/phaseTracking.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"phaseTracking.js","sourceRoot":"","sources":["../../src/activix/phaseTracking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAYjD,MAAM,UAAU,eAAe,CAAC,IAI/B;IACC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IAC/C,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,EAAW,EACX,IAA6B;IAE7B,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,EAAW,EACX,QAAgB,EAChB,OAA4C;IAE5C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,EAAW,EACX,QAAgB,EAChB,KAAc,EACd,OAA4C;IAE5C,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACpE,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAI,IAQxC;IACC,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC;IACpD,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa;QAAE,OAAO,EAAE,EAAE,CAAC;IAEvC,6GAA6G;IAC7G,uGAAuG;IACvG,MAAM,EACJ,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,cAAc,EAC1B,QAAQ,EAAE,gBAAgB,EAC1B,GAAG,QAAQ,EACZ,GAAG,CAAC,IAAI,IAAI,EAAE,CAId,CAAC;IACF,MAAM,KAAK,GACT,SAAS,KAAK,SAAS;QACvB,SAAS,KAAK,IAAI;QAClB,OAAO,SAAS,KAAK,QAAQ;QAC7B,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QACzB,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC;QACtD,CAAC,CAAE,SAAqC;QACxC,CAAC,CAAC,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IACvC,MAAM,UAAU,GAA4B;QAC1C,GAAG,CAAC,OAAO,gBAAgB,KAAK,QAAQ,IAAI,gBAAgB,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC;YACvG,CAAC,CAAC,EAAE,GAAI,gBAA4C,EAAE;YACtD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC;YACjG,CAAC,CAAC,EAAE,GAAI,cAA0C,EAAE;YACpD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,IAAI,aAAa,EAAE,CAAC;QAClB,UAAU,CAAC,SAAS,GAAG,aAAa,CAAC;IACvC,CAAC;IACD,MAAM,UAAU,GAA4B;QAC1C,GAAG,QAAQ;QACX,aAAa;QACb,KAAK;QACL,UAAU;QACV,KAAK;KACN,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAEtD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,8DAA8D;QAC9D,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,MAAM,iBAAiB,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QACvE,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG;YACnB,YAAY,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YACpE,SAAS,EAAG,KAAa,EAAE,IAAI;YAC/B,SAAS,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YAC1D,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SACxC,CAAC;QACF,MAAM,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;QACvD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/core/task-sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-sdk.d.ts","sourceRoot":"","sources":["../../src/core/task-sdk.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAazD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAuB,MAAM,mBAAmB,CAAC;AA0BzF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AA0OxD,KAAK,iBAAiB,GAAG,mBAAmB,CAAC;AA0S7C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,+FAA+F;IAC/F,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B,CAAC;AAEF,qBAAa,gBAAgB;IAIzB,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,iBAAiB;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ3B,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC;gBAGjC,YAAY,EAAE,iBAAiB,EACjC,QAAQ,EAAE;QACzB,OAAO,CAAC,OAAO,GAAG,GAAG,EACnB,KAAK,EAAE,GAAG,EACV,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACzC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;KACtC,EACD,OAAO,CAAC,EAAE,uBAAuB;IAQ7B,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAqkDtF;;OAEG;YACW,6BAA6B;IAmhB3C;;;;;OAKG;YACW,cAAc;CAuR7B"}
+{"version":3,"file":"task-sdk.d.ts","sourceRoot":"","sources":["../../src/core/task-sdk.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAazD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAuB,MAAM,mBAAmB,CAAC;AA2BzF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AA0OxD,KAAK,iBAAiB,GAAG,mBAAmB,CAAC;AA0S7C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,+FAA+F;IAC/F,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B,CAAC;AAEF,qBAAa,gBAAgB;IAIzB,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,iBAAiB;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ3B,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC;gBAGjC,YAAY,EAAE,iBAAiB,EACjC,QAAQ,EAAE;QACzB,OAAO,CAAC,OAAO,GAAG,GAAG,EACnB,KAAK,EAAE,GAAG,EACV,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACzC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;KACtC,EACD,OAAO,CAAC,EAAE,uBAAuB;IAQ7B,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IA4kDtF;;OAEG;YACW,6BAA6B;IAmhB3C;;;;;OAKG;YACW,cAAc;CAuR7B"}

package/dist/core/task-sdk.js

@@ -7,6 +7,7 @@ import { resolveSafeExecutionStrategyCatalogDefaultFunctionId } from "../executi
 import { SYNTHESIZED_CONTEXT } from "../types/index.js";
 import { runAuditPostStep } from "../post-steps/audit/runAudit.js";
 import { buildRunTaskResultMetaFromModelId } from "../invocation/buildRunTaskResultMeta.js";
+import { logRunTaskInvocationPlan } from "../observability/logLlmProviderInvocation.js";
 import { runPolishPostStep } from "../post-steps/polish/runPolish.js";
 import { getLocalTask } from "../localTasks/registry.js";
 import { registerBuiltInLocalTasks } from "../localTasks/index.js";
@@ -476,6 +477,12 @@ export class WorexClientTasks {
                     graphId: input.graphId,
                     nodeId: input.nodeId,
                 });
+                await logRunTaskInvocationPlan({
+                    modelConfig: input.modelConfig,
+                    skillKey: input.skillKey,
+                }).catch(() => {
+                    /* plan logging is best-effort diagnostics */
+                });
                 const coreSkillId = input.coreSkillId;
                 const upstreamIdentity = isRecord(input.identity) ? input.identity : undefined;
                 const executingSkillId = coreSkillId ?? input.skillKey;