@exellix/ai-tasks 8.2.9 → 8.4.1

package/CHANGELOG.md

@@ -6,6 +6,32 @@ The published **npm version** always matches **`version`** in [`package.json`](p
 
 ## [Unreleased]
 
+### Changed (breaking)
+
+- **`RunTaskRequest.modelConfig` is required** on every `runTask()` call (all three slots). No env-based or hardcoded model defaults (`SYNTHESIS_MODEL`, `AUDIT_MODEL`, `POST_STEP_MODEL`, `"balanced"`, etc.) for model selection.
+
+### Fixed
+
+- **PRE/MAIN model routing:** Root `RunTaskRequest.llmCall` is **MAIN-only** — no longer copied into PRE synthesis compile. When `llmCall.model` duplicates `preActionModel` while `skillModel` differs (graph-engine PRE leakage), MAIN uses `skillModel`. Validation warning `MODEL_CONFIG_LLM_CALL_PRE_MAIN_COLLISION`.
+
+## [8.4.0] - 2026-06-01
+
+### Changed (breaking)
+
+- **`RunTaskRequest.modelConfig`:** **3-slot triplet only** — `preActionModel`, `skillModel`, `postActionModel`. **`xynthesisModel` removed** (validation rejects with `NON_CANONICAL_MODEL_CONFIG`). PRE uses `preActionModel`; POST uses `postActionModel`.
+- **`@x12i/ai-profiles` ^2.0.0:** Required `catalogLane` on profile resolution; ai-tasks defaults `"text"` ( `"image"` for `vision` ). Registry source defaults to `auto`.
+- **`@exellix/xynthesis` ^4.2.1:** Minimum for ai-profiles v2 alignment.
+
+### Added
+
+- **`defaultAiTasksResolveAiProfileOptions`**, slot helpers `resolvePreActionModel` / `resolvePostActionModel`, builder `withPreActionModel` / `withPostActionModel`.
+
+### Removed
+
+- Exports **`resolveXynthesisModelForPre`**, **`getXynthesisModelFromSlots`**, builder **`withXynthesisModel`**.
+
+## [Unreleased — prior notes]
+
 ### Changed
 
 - **`@x12i/ai-profiles` ≥1.8.0:** Direct dependency bumped from **^1.7.2**; **`npm` override** pins transitive `@x12i/ai-profiles` to this package's direct version (required fix in **1.8.0** for profile alias resolution). Live coverage: `npm run test:live` → `test/e2e/ai-profiles-live.test.ts` (registry `auto` + real xynthesis alias call).

package/README.md

@@ -4,6 +4,18 @@ Private Git/npm package for executing **tasks** using the Woreces execution stac
 
 **Breaking — `executionStrategies` (required):** Every `runTask` request must include **`executionStrategies`**: an array of FuncX MAIN wrappers or **`[]`** for plain gateway MAIN. The old **`executionStrategyKey`** field is removed. See [BREAKING-CHANGES.md](BREAKING-CHANGES.md) and [RUNTASK_REQUEST.md](RUNTASK_REQUEST.md). Supported MAIN execution is exactly: **direct** via **`executionStrategies: []`**, **planner** before MAIN, **optimizer** after MAIN, or planner + optimizer together. Default FuncX function ids (generic envelope via **`run()`**, **`@x12i/funcx` ≥ 4.2.0** recommended): **`execution/plan`**, **`execution/evaluate-result`** (overridable via each row’s `args.functionId` when the alternate implementation uses the **same** envelope). Planner/optimizer responses are normalized with **`getRunJsonResult`** from `@x12i/funcx/functions` (also re-exported from this package as **`unwrapFuncxRunValue`** → **`getRunJsonResult`**).
 
+**Breaking — 8.4+ LLM invoke contract (no legacy):** Every `runTask` requires **`modelConfig.preActionModel`**, **`modelConfig.skillModel`**, and **`modelConfig.postActionModel`**. Do **not** send `xynthesisModel`, root `modelConfig.model`, `maxTokens`, `maxTokensCap`, or graph-era tier names (`weak` / `strong`). Token budgets are owned by **Optimixer** in `@exellix/ai-skills` (MAIN) and `@exellix/xynthesis` (PRE/POST). Send **`outputExpectation`** (xynthesis) and optional **`reasoningEffort`**, **`temperature`**, **`topP`**. See [How completion budgets work](#how-completion-budgets-work-84) and [Model profile aliases](#model-profile-aliases-x12iai-profiles).
+
+### Stack alignment (8.4+)
+
+| Package | Role in `runTask` | Minimum |
+|---------|-------------------|---------|
+| `@x12i/ai-profiles` | Profile/shortcut → wire model (`catalogLane` required on resolve) | **2.1.0** |
+| `@exellix/xynthesis` | PRE synthesis, POST audit/polish, scoping, utilities (`executeXynthesisAction`) | **4.3.0** |
+| `@exellix/ai-skills` | MAIN `runSkill` (Optimixer caps, `ModelConfig.reasoningEffort`) | **6.0.0** |
+
+Use explicit **ai-profiles** profile keys (`cheap`, `pro`, `cyber`, …) or **shortcuts** (`cheapest`, `default`, …) or **`profile/choice`** keys — not removed sync helpers or legacy tier aliases.
+
 **FuncX catalog / hosting:** Those function ids must exist in your FuncX content resolver for live **`run()`** calls — see [`documenations/funcx-catalog-hosting-checklist.md`](documenations/funcx-catalog-hosting-checklist.md).
 
 **Execution pipeline (optional):** You can use `executionPipeline` (array of pre/main/post steps) instead of a single `executionType`. PRE steps include `synthesized-context`; POST steps include `audit` (quality-gate loop) and `polish` (refinement checklist). See [BREAKING-CHANGES.md](BREAKING-CHANGES.md) for migration. When `executionPipeline` is omitted, existing `executionType` behavior is unchanged.
@@ -313,10 +325,11 @@ const res = await tasks.runTask({
   // optional
   variables: { orgName: "Acme" },
   modelConfig: {
-    xynthesisModel: "openai/gpt-5-nano",
+    preActionModel: "cheap",
+    postActionModel: "cheap",
     skillModel: "openai/gpt-5",
     temperature: 0.7,
-    maxTokens: 2000
+    topP: 0.9,
   },
   jobId: "job-1",
   agentId: "agent-1",
@@ -446,7 +459,7 @@ const expected = await analyzeExpectedRunTaskInput({
 });
 ```
 
-Each issue has **`code`**, **`severity`** (`error` \| `warning`), **`message`**, and optional **`path`** (e.g. `smartInput.paths[0].path`, `llmCall.maxTokensCap`). See [`.docs/flow-io/`](.docs/flow-io/flow-README.md) for flow-level wiring.
+Each issue has **`code`**, **`severity`** (`error` \| `warning`), **`message`**, and optional **`path`** (e.g. `smartInput.paths[0].path`, `modelConfig.preActionModel`). See [`.docs/flow-io/`](.docs/flow-io/flow-README.md) for flow-level wiring.
 
 ### Skill request analysis (`@exellix/ai-skills` 5.6+)
 
@@ -454,7 +467,7 @@ Each issue has **`code`**, **`severity`** (`error` \| `warning`), **`message`**,
 
 | Export | Purpose |
 |--------|---------|
-| **`analyzeSkillRequest`**, **`buildSkillRequestAnalysisPacket`**, **`formatSkillRequestAnalysisMarkdown`** | Deterministic preflight for a flat **`RunSkillRequest`** (templates, smart input, output contract, gateway packet preview). |
+| **`ExellixSkillsClient.analyzeSkillRequest`**, **`buildSkillRequestAnalysisPacket`**, **`formatSkillRequestAnalysisMarkdown`** | Deterministic preflight for a flat **`RunSkillRequest`** (templates, smart input, output contract, gateway packet preview). |
 | **`analyzeRunTaskRequest(catalox, request, options?)`** | Same analysis on **`pickRunSkillRequestFields(request)`**, plus optional merge of **`validateRunTaskConfig`** findings (`includeAiTasksConfigValidation`, default `true`). |
 | **`extractTokenNamesFromStrings`**, **`getSkillTokens`**, **`getSkillContent`**, **`modifySkillContent`**, **`createSubSkill`**, **`deleteSubSkill`**, **`SKILL_TEMPLATE_ROLES_ORDER`** | Template catalog introspection and edits (Catalox). |
 | **`runSkillRequestFromFlat`**, **`resolveAiEngineIdForRunSkill`**, **`SkillExecutionTraceError`**, trace helpers | Flat skill execution and trace utilities. |
@@ -1052,28 +1065,20 @@ Use **`RunTaskResponseWithSteps<TParsed>`** when you expect steps; it extends `R
 
 ---
 
-## How max tokens are resolved (automation + caller controls)
-
-`@exellix/xynthesis` 3.1+ ships `resolveMaxTokens` — a deterministic function that picks the right `maxTokens` for any LLM call from `(inputText, outputExpectation, modelId, callerMaxTokens?, structuredOutput?)`. `@exellix/ai-tasks` invokes it on **every** xynthesis-backed call (PRE synthesis, AI scoping, POST audit, POST polish, structured-repair fallback) so callers don't have to pick a number.
-
-**The pipeline is:**
+## How completion budgets work (8.4+)
 
-1. **Estimate input tokens** from `inputText` (system + user + extra material) using `xynthesis.estimateTokens`.
-2. **Resolve the effective `OutputExpectation`** = caller's `llmCall.outputExpectation` → per-action default (`xynthesis.resolveOutputExpectation('synthesis' | 'audit' | 'fix' | 'pick-best' | 'craft-final')`) → stage-local default (e.g. AI scoping uses `{ size: { mode: "absolute", minWords: 5, maxWords: 200 }, density: "concise" }`) → xynthesis package fallback.
-3. **Compute estimated output tokens** from the expectation (absolute words → tokens; relative → ratio × input tokens), multiplied by `headroomMultiplier(density)` and (if `structuredOutput`) the structured-output factor.
-4. **Cap at the model's `maxOutputTokens`** from `getModelCapabilities(modelId)` (unknown models fall back to `{ contextWindow: 128_000, maxOutputTokens: 4_096, completionTokenCost: "medium" }`).
-5. **Honor the caller's `maxTokensCap`** as a HARD CEILING — the auto-sizer can pick a smaller number, but never larger.
-6. The `resolveMaxTokens` result (`{ maxTokens, reason: "computed" | "caller-override" | "model-ceiling" | "fallback", diagnostics: { … } }`) is forwarded to xynthesis as `tokenResolutionMetadata` and surfaced in trace mode as `LlmCallObservation.request.tokenResolution`.
+Orchestrators send **model** + **sampling** + **`reasoningEffort`** + (for xynthesis) **`outputExpectation`**. They do **not** send completion token counts.
 
-**To adjust per-call dynamically** (without losing the automation):
+| Phase | Package | Caller sends | Package owns |
+|-------|---------|--------------|--------------|
+| **MAIN** | `@exellix/ai-skills` ≥6 | `modelConfig` → `{ model, temperature, topP, reasoningEffort, … }` | Optimixer + Catalox skill catalog (`maxTokens` on `ModelConfig` is rejected) |
+| **PRE / POST / scoping / utility** | `@exellix/xynthesis` ≥4.3 | `outputExpectation` (required on every hop), optional `reasoningEffort`, `temperature`, `topP` | `resolveEffectiveMaxTokens` inside `executeXynthesisAction` |
 
-- Set `llmCall.outputExpectation` to bias the auto-sizer toward smaller / larger / denser output.
-- Set `llmCall.maxTokensCap` to bound the upper limit (e.g. for cost ceilings).
-- Leave both unset to get the per-stage / per-action default.
+**Xynthesis `outputExpectation`** is sizing/density **intent** for Optimixer — not a literal token count. ai-tasks resolves a per-stage default when the caller omits it (`resolveOutputExpectation` / `resolveLlmOutputExpectationForXynthesis`).
 
-The legacy `llmCall.maxTokens` field is still accepted as an alias for `maxTokensCap`. The legacy `modelConfig.maxTokens` (forwarded as-is to ai-skills for the MAIN skill call) continues to work.
+**Rejected on the wire (validation):** `modelConfig.maxTokens`, `llmCall.maxTokens`, `llmCall.maxTokensCap`, deprecated `xynthesisModel`, root `modelConfig.model`.
 
-> **Note:** the MAIN skill call goes through `@exellix/ai-skills` `runSkill`, which today uses your `modelConfig.maxTokens` directly (no auto-sizer). Setting `RunTaskRequest.llmCall.maxTokensCap` on the main skill is overlaid onto `modelConfig.maxTokens` before the call. ai-skills auto-sizing is tracked as an upstream feature request in [`documenations/upstream-feature-requests/ai-skills-llm-observability.md`](documenations/upstream-feature-requests/ai-skills-llm-observability.md).
+**Trace:** use `usage.maxTokensRequested` / `invokeSummary` diagnostics after invoke — not pre-set caps on the request.
 
 ---
 
@@ -1083,14 +1088,16 @@ The legacy `llmCall.maxTokens` field is still accepted as an alias for `maxToken
 
 | Path | Slot / field | Resolved before |
 |------|----------------|-----------------|
-| **Xynthesis** (PRE synthesis, POST audit/polish, AI scoping, utilities) | `xynthesisModel`, `SynthesisConfig.llmCall.model`, `AuditConfig.llmCall.*`, `PolishConfig.llmCall`, `RunUtilityRequest.exec.model`, env fallbacks (`SYNTHESIS_MODEL`, `AUDIT_MODEL`, …) | `executeXynthesisAction` / `runPostStepLlmCall` |
+| **Xynthesis** (PRE synthesis, POST audit/polish, AI scoping, utilities) | `preActionModel`, `postActionModel`, step `llmCall.model`, `RunUtilityRequest.exec.model` | `executeXynthesisAction` / `runPostStepLlmCall` |
 | **ai-skills MAIN** | `skillModel`, `RunTaskRequest.llmCall.model` | `runSkill` (via `DirectExecutionStrategy`) |
 
-**Accepted alias shapes:**
+**Accepted alias shapes** (`@x12i/ai-profiles` v2.1+):
 
-- **ai-profiles profiles:** `cheap`, `fast`, `balanced`, `deep`, `pro`, `json`, `agentic`, `research`
-- **ai-profiles shortcuts:** `cheapest`, `default`, `best`, `standard`, `thinking`, `schema`, `agent`, `web-research`, … (see `@x12i/ai-profiles` README)
-- **Legacy graph tiers:** `weak` → `cheap`, `strong` → `pro`, `default` → `balanced`
+- **Profile keys:** `cheap`, `fast`, `balanced`, `deep`, `pro`, `json`, `agentic`, `research`, `cyber`, …
+- **Shortcuts:** `cheapest`, `default`, `best`, `standard`, `thinking`, `schema`, …
+- **Explicit choice:** `cheap/default`, `pro@default`, …
+
+**Not accepted:** legacy graph tiers (`weak`, `strong`), deprecated `xynthesisModel`, or sync-only alias guessing removed in ai-profiles 2.1. Unknown keys fail at **`resolveAIProfile`** with a clear error.
 
 **Example (aliases on the request — resolved inside `runTask`):**
 
@@ -1103,20 +1110,21 @@ await runTask({
   executionStrategies: [],
   input: { topic: "Q1 risks" },
   modelConfig: {
-    xynthesisModel: "cheap",   // PRE synthesis → e.g. google/gemini-2.5-flash-lite
-    skillModel: "balanced",    // MAIN skill    → e.g. openai/gpt-5.4
+    preActionModel: "cheap",   // PRE synthesis
+    postActionModel: "cheap",  // POST audit/polish
+    skillModel: "balanced",    // MAIN skill
   },
 });
 ```
 
-Concrete ids (`openrouter/...`, `anthropic/claude-sonnet-4`, `openai/gpt-5`, …) pass through unchanged on **`skillModel`** / MAIN `llmCall.model`. **`xynthesisModel`** and xynthesis **`llmCall.model`** must stay **ai-profiles aliases** under `@exellix/xynthesis` ≥4 (concrete ids are rejected).
+Concrete ids (`openrouter/...`, `anthropic/claude-sonnet-4`, `openai/gpt-5`, …) pass through unchanged on **`skillModel`** / MAIN `llmCall.model`. **`preActionModel`** / **`postActionModel`** and xynthesis **`llmCall.model`** must stay **ai-profiles aliases** under `@exellix/xynthesis` ≥4 (concrete ids are rejected).
 
 **Client impact:**
 
 - **No change** if you already send concrete provider model ids.
 - **New:** you may send ai-profiles aliases on `modelConfig`, `llmCall.model`, and pipeline step configs — graph-engine no longer has to pre-resolve every alias before `runTask` (hosts that already resolve can keep doing so; double resolution is a no-op for concrete ids).
 - **Validation:** alias tokens on `modelConfig` slots are accepted; unknown aliases fail at resolution with a clear error.
-- **Optional helpers** (for hosts/tests): `resolveModelReference`, `resolveRunTaskModelReferences`, `isResolvableModelAlias`.
+- **Helpers:** `resolveModelReference`, `resolveRunTaskModelReferences`, `isResolvableModelAlias` (true only for **`profile/choice`** keys and **shortcuts** — bare profile keys are resolved at invoke, not sync-listed).
 
 Resolution uses the ai-profiles registry (`auto`: remote refresh with bundled fallback). See [`.docs/ai-tasks-model-profile-aliases-7x.md`](.docs/ai-tasks-model-profile-aliases-7x.md).
 
@@ -1124,18 +1132,17 @@ Resolution uses the ai-profiles registry (`auto`: remote refresh with bundled fa
 
 ## LLM call configuration (`LlmCallConfig`)
 
-`LlmCallConfig` is the per-stage override knob set. On MAIN it composes with `RunTaskRequest.modelConfig` slots (`skillModel` / `xynthesisModel`) — when both are set, `llmCall.*` wins.
+`LlmCallConfig` is the per-stage override knob set. On MAIN it composes with `RunTaskRequest.modelConfig` slots (`preActionModel`, `skillModel`, `postActionModel`) — when both are set, `llmCall.*` wins.
 
 ```typescript
 type LlmCallConfig = {
-  model?: string;             // provider/model id or @x12i/ai-profiles alias (resolved at call time)
-  maxTokensCap?: number;      // HARD CEILING for resolveMaxTokens (does NOT disable automation)
-  maxTokens?: number;         // alias for maxTokensCap (backward compat)
+  model?: string;                        // provider/model id or ai-profiles alias (resolved at call time)
   temperature?: number;
   topP?: number;
-  maxOutputLength?: number;   // post-call character truncation
+  reasoningEffort?: OptimixerReasoningEffort; // overrides Catalox default when set
+  maxOutputLength?: number;              // post-call character truncation
   timeoutMs?: number;
-  outputExpectation?: OutputExpectation; // drives resolveMaxTokens auto-sizing
+  outputExpectation?: OutputExpectation; // xynthesis Optimixer intent (not a token count)
 };
 ```
 
@@ -1150,7 +1157,7 @@ type LlmCallConfig = {
 | POST audit (evaluator) | `AuditConfig.llmCall` or `AuditConfig.audit.llmCall` |
 | POST audit (synthesis-merge) | `AuditConfig.audit.synthesis.llmCall` |
 | POST polish | `PolishConfig.llmCall` |
-| Utility (xynthesis-finalize) | `RunUtilityRequest.exec.{model, maxTokensCap, temperature, topP, outputExpectation, ...}` |
+| Utility (xynthesis-finalize) | `RunUtilityRequest.exec.{model, temperature, topP, reasoningEffort, outputExpectation, ...}` |
 
 **Builder helpers (`TaskRequestBuilder`):**
 
@@ -1168,7 +1175,6 @@ type LlmCallConfig = {
 |---------------------|--------|
 | `AUDIT_MODEL`, `POLISH_MODEL`, `SYNTHESIS_MODEL`, `AI_SCOPING_MODEL` | Model override for that stage |
 | `AUDIT_TIMEOUT_MS`, `POLISH_TIMEOUT_MS`, `SYNTHESIS_TIMEOUT_MS`, `AI_SCOPING_TIMEOUT_MS` | Per-call timeout override |
-| `AUDIT_MAX_TOKENS_CAP`, `POLISH_MAX_TOKENS_CAP`, `SYNTHESIS_MAX_TOKENS_CAP` | Hard ceiling override |
 | `AUDIT_TEMPERATURE`, `POLISH_TEMPERATURE`, `SYNTHESIS_TEMPERATURE` | Temperature override |
 | `AUDIT_TOP_P`, `POLISH_TOP_P`, `SYNTHESIS_TOP_P` | Top-P override |
 | `AUDIT_MAX_OUTPUT_LENGTH`, `POLISH_MAX_OUTPUT_LENGTH`, `SYNTHESIS_MAX_OUTPUT_LENGTH` | Post-call char truncation override |
@@ -1207,7 +1213,7 @@ When `RunTaskRequest.executionMode === "trace"` (or `RunUtilityRequest.exec.exec
 type LlmCallObservation =
   | {
       source: "xynthesis"; stage: LlmCallStage; stepId?: string;
-      request: LlmCallRequestSnapshot; // includes resolved tokenResolution from resolveMaxTokens
+      request: LlmCallRequestSnapshot;
       summary?: InvokeAttemptSummary;  // from executeXynthesisAction on success / typed errors on failure
       debugTrace?: XynthesisDebugTrace; // present when executionMode: "trace" was forwarded
       durationMs: number; ok: boolean; error?: { name: string; message: string };
@@ -1247,7 +1253,6 @@ import {
   type LlmCallConfig,
   type InvokeAttemptSummary,
   type RunSkillDiagnostics,
-  resolveMaxTokens,
   resolveOutputExpectation,
   ACTION_OUTPUT_DEFAULTS,
   getModelCapabilities,
@@ -1261,17 +1266,26 @@ import { runTask, type LlmCallConfig } from "@exellix/ai-tasks";
 
 const llmCall: LlmCallConfig = {
   model: "gpt-5-mini",
-  maxTokensCap: 4096,                                   // hard ceiling
   outputExpectation: { size: { kind: "absolute", maxWords: 600 }, density: "default" },
   temperature: 0.4,
+  reasoningEffort: "medium",
 };
 
 const result = await runTask({
   skillKey: "tasks/security-risk-summary",
+  agentId: "agent-1",
+  jobTypeId: "security-job",
+  taskTypeId: "security-task",
+  executionStrategies: [],
+  modelConfig: {
+    preActionModel: "cheap",
+    postActionModel: "cheap",
+    skillModel: "balanced",
+  },
   input: { assetId: "a-123" },
   executionMode: "trace",
   llmCall,
-  aiScopingOptions: { llmCall: { model: "gpt-5-nano", maxTokensCap: 512 } },
+  aiScopingOptions: { llmCall: { model: "cheap", outputExpectation: { size: { kind: "absolute", maxWords: 200 }, density: "concise" } } },
   // executionPipeline: [{ phase: "pre", type: "synthesized-context", config: { llmCall } }, { phase: "main", type: "direct" }],
 });
 
@@ -1862,7 +1876,7 @@ Builder class for constructing task requests with a fluent API.
 - `withGraphId(graphId: string): this` - Set graph identifier
 - `withNodeId(nodeId: string): this` - Set node identifier
 - `withPrevNodeId(prevNodeId: string): this` - Set previous node identifier
-- `withModelConfig(modelConfig: ModelConfig): this` - Set model configuration (model, temperature, maxTokens, etc.)
+- `withModelConfig(modelConfig: RunTaskModelConfig): this` - Set the required 3-slot model triplet + tuning
 - `withTemplateRenderOptions(templateRenderOptions: TemplateRenderOptions): this` - Per-task gateway / parser template overrides (v4)
 - `withTemplateTokens(templateTokens: GatewayTemplateTokens): this` - Per-task `templateTokens` overlay
 - `withTimeout(timeoutMs: number): this` - Set timeout
@@ -1884,9 +1898,10 @@ const request = new TaskRequestBuilder()
   .withAiSkillsCorrelation("my-agent", "my-job-type", "my-task-type")
   .withExecutionStrategies([]) // [] = plain MAIN; omit only if you rely on build() defaulting strategies to []
   .withModelConfig({
-    model: "gpt-5",
+    preActionModel: "cheap",
+    postActionModel: "cheap",
+    skillModel: "gpt-5",
     temperature: 0.7,
-    maxTokens: 2000
   })
   .withJobMemory(jobMemory)
   .withTaskMemory(taskMemory)
@@ -1945,7 +1960,7 @@ interface RunTaskRequest {
   jobMemory?: JobHistory;               // History of previous task results
   taskMemory?: TaskHistory;              // History of skills executed
   executionMemory?: ExecutionHistory;    // History of execution context (execution-level memory)
-  modelConfig?: ModelConfig;            // Model configuration (model, temperature, maxTokens, etc.)
+  modelConfig: RunTaskModelConfig;      // Required 3-slot triplet + optional tuning
   jobId?: string;
 
   // Graph execution context (optional)
@@ -2104,35 +2119,34 @@ Exported type for **`RunTaskRequest.narrix`**. Includes **`datasetId`**, optiona
 import type { NarrixPreProcessorConfig } from "@exellix/ai-tasks";
 ```
 
-### `ModelConfig`
+### `RunTaskModelConfig`
 
-Model configuration for per-request model selection and generation parameters:
+Required on every `runTask()` — three slots plus optional tuning (no `maxTokens`, no legacy `model` / `xynthesisModel`):
 
 ```typescript
-import type { ModelConfig } from "@exellix/ai-tasks";
-
-interface ModelConfig {
-  model?: string;              // Model identifier (e.g., "gpt-5")
-  modelId?: string;            // Provider-specific model ID
-  provider?: string;           // Provider name (e.g., "openai", "anthropic")
-  temperature?: number;        // 0.0 to 2.0 - Controls randomness
-  maxTokens?: number;          // Maximum tokens to generate
-  topP?: number;               // 0.0 to 1.0 - Nucleus sampling
-  frequencyPenalty?: number;   // -2.0 to 2.0
-  presencePenalty?: number;    // -2.0 to 2.0
-  stop?: string[];            // Stop sequences
-  [key: string]: any;         // Additional provider-specific parameters
+import type { RunTaskModelConfig } from "@exellix/ai-tasks";
+
+interface RunTaskModelConfig {
+  preActionModel: string;   // ai-profiles alias (xynthesis PRE)
+  skillModel: string;       // alias or concrete id (ai-skills MAIN)
+  postActionModel: string;  // ai-profiles alias (xynthesis POST)
+  temperature?: number;
+  topP?: number;
+  reasoningEffort?: OptimixerReasoningEffort;
+  frequencyPenalty?: number;
+  presencePenalty?: number;
 }
 ```
 
-**Example (concrete ids or aliases):**
+**Example:**
 ```typescript
-const modelConfig = {
-  xynthesisModel: "cheap",      // or "openai/gpt-5-nano"
-  skillModel: "balanced",       // or "openai/gpt-5"
+const modelConfig: RunTaskModelConfig = {
+  preActionModel: "cheap",
+  postActionModel: "cheap",
+  skillModel: "cyber",
   temperature: 0.7,
-  maxTokens: 2000,
-  topP: 0.9
+  topP: 0.9,
+  reasoningEffort: "medium",
 };
 
 const result = await runTask({
@@ -2143,7 +2157,7 @@ const result = await runTask({
 });
 ```
 
-**Note:** Root `RunTaskRequest.modelConfig` uses canonical slots (`RunTaskModelConfig`: `xynthesisModel` + `skillModel`). Profile aliases are resolved via `@x12i/ai-profiles` at `runTask` entry and on each xynthesis / ai-skills call boundary. See [Model profile aliases](#model-profile-aliases-x12iai-profiles) and [`.docs/ai-tasks-model-profile-aliases-7x.md`](.docs/ai-tasks-model-profile-aliases-7x.md).
+**Note:** Root `RunTaskRequest.modelConfig` uses canonical slots (`RunTaskModelConfig`: `preActionModel`, `skillModel`, `postActionModel`). Profile aliases are resolved via `@x12i/ai-profiles` v2 at `runTask` entry and on each xynthesis / ai-skills call boundary. See [Model profile aliases](#model-profile-aliases-x12iai-profiles) and [`.docs/ai-tasks-model-profile-aliases-7x.md`](.docs/ai-tasks-model-profile-aliases-7x.md).
 
 ### `JobHistory`, `TaskHistory`, and `ExecutionHistory`
 
@@ -2265,7 +2279,8 @@ const result = await tasks.runTask({
   input: { assetId: "a-123" },
   variables: { orgName: "MyOrganization" },
   modelConfig: {
-    xynthesisModel: "openai/gpt-5-nano",
+    preActionModel: "balanced",
+    postActionModel: "balanced",
     skillModel: "openai/gpt-5",
     temperature: 0.7
   }
@@ -2330,11 +2345,12 @@ const result = await tasks.runTask({
   executionType: ExecutionType.DIRECT,
   input: { data: "analyze this" },
   modelConfig: {
-    model: "gpt-5",
+    preActionModel: "cheap",
+    postActionModel: "cheap",
+    skillModel: "gpt-5",
     temperature: 0.7,
-    maxTokens: 2000,
-    topP: 0.9
-  }
+    topP: 0.9,
+  },
 });
 
 // Or using the builder
@@ -2346,9 +2362,10 @@ const request = new TaskRequestBuilder()
   .withAiSkillsCorrelation("agent-1", "analysis-job", "analysis-task")
   .withExecutionStrategies([])
   .withModelConfig({
-    model: "gpt-5",
+    preActionModel: "cheap",
+    postActionModel: "cheap",
+    skillModel: "gpt-5",
     temperature: 0.5,
-    maxTokens: 4000
   })
   .build();
 

package/RUNTASK_REQUEST.md

@@ -95,8 +95,8 @@ Properties are classified for **default MAIN path** unless noted. Inherited **`R
 | `inputs` | Optional plural task payload (`string` or object). Dual-root parity with `input`; smart-input **`inputs.*`** resolves here (not `executionMemory.inputs`). |
 | `variables` | Job/graph template bucket; forwarded as-is on MAIN (see [Canonical input bucket](#canonical-input-bucket)). |
 | `jobMemory`, `taskMemory` | Enriched and forwarded; see executor payload. |
-| `modelConfig` | **Canonical slots:** `xynthesisModel` + `skillModel`. **Aliases accepted on wire** (ai-profiles names + legacy tiers); resolved inside `runTask()` via [`resolveRunTaskModelReferences`](src/utils/resolveRunTaskModelReferences.ts). **`skillModel`** → concrete id for ai-skills MAIN; **`xynthesisModel`** → **alias only** for xynthesis PRE/POST (concrete ids rejected under `@exellix/xynthesis` ≥4). Legacy `model` rejected. |
-| `llmCall` | Per-stage override; on MAIN, `llmCall.model` wins over `skillModel`. Stripped before `runSkill` (merged into ai-skills `modelConfig` only at execution boundary). |
+| `modelConfig` | **Canonical slots:** `preActionModel` + `skillModel` + `postActionModel`. **Aliases accepted on wire** (ai-profiles names + legacy tiers); resolved inside `runTask()` via [`resolveRunTaskModelReferences`](src/utils/resolveRunTaskModelReferences.ts). **`skillModel`** → concrete id for ai-skills MAIN; **`preActionModel`** / **`postActionModel`** → **alias only** for xynthesis PRE/POST (concrete ids rejected under `@exellix/xynthesis` ≥4). Legacy `model` and **`xynthesisModel`** rejected. |
+| `llmCall` | **MAIN override only** at root (`llmCall.model` wins over `skillModel` unless it duplicates `preActionModel` while `skillModel` differs — see collision guard). Not copied into PRE synthesis compile; use `preActionModel` or `executionPipeline[pre].config.llmCall` for PRE. Merged into ai-skills `modelConfig` at MAIN execution boundary. |
 | `timeoutMs` | Forwarded when set (also overlaid from `llmCall.timeoutMs`). |
 | `coreSkillId` | Maps to `skillId` on `RunSkillRequest` for gateway. |
 | `graphId`, `nodeId`, `prevNodeId`, `masterSkillId`, `masterSkillActivityId` | Graph / activity telemetry (read in task-sdk & tracing). |
@@ -249,7 +249,7 @@ Legacy path alias: **`variables.*`** ≡ **`jobVariables.*`** (prefer **`jobVari
 | `taskTypeId` | **`taskTypeId`** |
 | `executionStrategies` | **`executionStrategies`** (required; use **`[]`** for plain MAIN) |
 | `executionStrategyCatalogItems` | **`executionStrategyCatalogItems`** |
-| `modelConfig` (+ `runtime.nodes[id].modelConfig`) | **`modelConfig`** — `{ xynthesisModel, skillModel }` with **ai-profiles aliases on wire** (resolved in ai-tasks at `runTask` entry; graph-engine pre-resolution optional). See [`.docs/ai-tasks-model-profile-aliases-7x.md`](.docs/ai-tasks-model-profile-aliases-7x.md) |
+| `modelConfig` (+ `runtime.nodes[id].modelConfig`) | **`modelConfig`** — `{ preActionModel, skillModel, postActionModel }` with **ai-profiles aliases on wire** (resolved in ai-tasks at `runTask` entry; graph-engine pre-resolution optional). See [`.docs/ai-tasks-model-profile-aliases-7x.md`](.docs/ai-tasks-model-profile-aliases-7x.md) |
 | `llmCall`, `timeoutMs` | same |
 | `narrix`, `narrixMode`, `narrixInput` | **`narrix`**, **`narrixMode`**, **`narrixInput`**, **`narrixScope`** |
 | `inputStrategyKey` | **`inputStrategyKey`** |

package/dist/aiSkillsUpstreamExports.d.ts

@@ -4,7 +4,7 @@
  *
  * Gateway key helpers remain on {@link ./skillCatalogExports.js}.
  */
-export { AI_SKILLS_APP_ID, AI_SKILLS_CATALOG_ID, AI_SKILLS_DESCRIPTOR_VERSION, AI_SKILLS_CATALOG_ITEMS, AI_SKILLS_LLM_IDENTITY_KEY, buildAiSkillsCatalogDescriptor, computeSkillRowStatus, listAiSkillsCatalogItems, catalogSkillKeyToRunSkillKey, catalogItemIdFromSkillKey, fetchSkillTemplatesFromCatalox, extractRunnableTemplateBodiesFromAiSkillsCatalogData, defaultAiSkillsCataloxContext, CataloxSkillNotFoundError, CataloxSkillAlreadyExistsError, CataloxSkillNotRunnableError, initFirebaseAdminFromEnv, createCataloxFromEnv, enrichIdentityWithAiSkillsLlmSnapshot, normalizeForStorage, toPresentationMarkdown, extractTemplateTokensFromTexts, extractTokenNamesFromStrings, getSkillTemplatesForPresentation, updateSkillTemplatesFromPresentation, getSkillTemplateInputs, getSkillTokens, getSkillContent, modifySkillContent, createSubSkill, deleteSubSkill, SKILL_TEMPLATE_ROLES_ORDER, upsertSkillCatalogItem, softDeleteSkillCatalogItem, analyzeSkillRequest, buildSkillRequestAnalysisPacket, formatSkillRequestAnalysisMarkdown, FUNCX_ANALYZE_GATEWAY_INVOKE_REQUEST_ID, FUNCX_MIN_VERSION_FOR_ANALYZE_GATEWAY, runSkillRequestFromFlat, resolveAiEngineIdForRunSkill, SkillExecutionTraceError, includeRawProviderPayload, isTraceExecutionMode, } from "@exellix/ai-skills";
+export { AI_SKILLS_APP_ID, AI_SKILLS_CATALOG_ID, AI_SKILLS_DESCRIPTOR_VERSION, AI_SKILLS_CATALOG_ITEMS, AI_SKILLS_LLM_IDENTITY_KEY, buildAiSkillsCatalogDescriptor, computeSkillRowStatus, listAiSkillsCatalogItems, catalogSkillKeyToRunSkillKey, catalogItemIdFromSkillKey, fetchSkillTemplatesFromCatalox, extractRunnableTemplateBodiesFromAiSkillsCatalogData, defaultAiSkillsCataloxContext, CataloxSkillNotFoundError, CataloxSkillAlreadyExistsError, CataloxSkillNotRunnableError, initFirebaseAdminFromEnv, createCataloxFromEnv, enrichIdentityWithAiSkillsLlmSnapshot, normalizeForStorage, toPresentationMarkdown, extractTemplateTokensFromTexts, extractTokenNamesFromStrings, getSkillTemplatesForPresentation, updateSkillTemplatesFromPresentation, getSkillTemplateInputs, getSkillTokens, getSkillContent, modifySkillContent, createSubSkill, deleteSubSkill, SKILL_TEMPLATE_ROLES_ORDER, upsertSkillCatalogItem, softDeleteSkillCatalogItem, buildSkillRequestAnalysisPacket, formatSkillRequestAnalysisMarkdown, FUNCX_ANALYZE_GATEWAY_INVOKE_REQUEST_ID, FUNCX_MIN_VERSION_FOR_ANALYZE_GATEWAY, runSkillRequestFromFlat, resolveAiEngineIdForRunSkill, SkillExecutionTraceError, includeRawProviderPayload, isTraceExecutionMode, } from "@exellix/ai-skills";
 export type { AiSkillsCatalogItemSpec, AiSkillsLlmIdentitySlice, CatalogReleaseStatus, AiSkillsPublishedItem, ListAiSkillsCatalogItemsResult, SkillCatalogStatus, FetchSkillTemplatesMode, ExtractedTemplateInputs, RunnableTemplateBodiesFromCatalogData, SkillTemplatesPresentation, SkillTemplatePresentationPatch, UpdateSkillTemplatesFromPresentationOptions, UpsertSkillCatalogItemInput, UpsertSkillCatalogItemOptions, SkillTemplateRole, SkillContentPart, ModifySkillContentResult, CreateSubSkillOverrides, CreateSubSkillInput, CreateSubSkillResult, DeleteSubSkillResult, AnalyzeSkillRequestOptions, AnalyzeSkillRequestResult, BuildSkillRequestAnalysisPacketResult, SkillRequestAnalysisCategory, SkillRequestAnalysisFinding, SkillRequestAnalysisReport, SkillRequestAnalysisSeverity, SkillRequestAnalysisVerdict, AnalyzeGatewayInvokeRequestPacket, RunSkillRequestFlat, GatewayExecutionSummary, OutputContract, } from "@exellix/ai-skills";
 /** Lower-level execution entrypoints from `@exellix/ai-skills` (same package as {@link ExellixSkillsClient}). */
 export { SkillExecutor, BaseClient } from "@exellix/ai-skills";

package/dist/aiSkillsUpstreamExports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aiSkillsUpstreamExports.d.ts","sourceRoot":"","sources":["../src/aiSkillsUpstreamExports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,0BAA0B,EAC1B,8BAA8B,EAC9B,qBAAqB,EACrB,wBAAwB,EACxB,4BAA4B,EAC5B,yBAAyB,EACzB,8BAA8B,EAC9B,oDAAoD,EACpD,6BAA6B,EAC7B,yBAAyB,EACzB,8BAA8B,EAC9B,4BAA4B,EAC5B,wBAAwB,EACxB,oBAAoB,EACpB,qCAAqC,EACrC,mBAAmB,EACnB,sBAAsB,EACtB,8BAA8B,EAC9B,4BAA4B,EAC5B,gCAAgC,EAChC,oCAAoC,EACpC,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,EACnB,+BAA+B,EAC/B,kCAAkC,EAClC,uCAAuC,EACvC,qCAAqC,EACrC,uBAAuB,EACvB,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,8BAA8B,EAC9B,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,qCAAqC,EACrC,0BAA0B,EAC1B,8BAA8B,EAC9B,2CAA2C,EAC3C,2BAA2B,EAC3B,6BAA6B,EAC7B,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,qCAAqC,EACrC,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,EAC3B,iCAAiC,EACjC,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,iHAAiH;AACjH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE/D,oDAAoD;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"aiSkillsUpstreamExports.d.ts","sourceRoot":"","sources":["../src/aiSkillsUpstreamExports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,0BAA0B,EAC1B,8BAA8B,EAC9B,qBAAqB,EACrB,wBAAwB,EACxB,4BAA4B,EAC5B,yBAAyB,EACzB,8BAA8B,EAC9B,oDAAoD,EACpD,6BAA6B,EAC7B,yBAAyB,EACzB,8BAA8B,EAC9B,4BAA4B,EAC5B,wBAAwB,EACxB,oBAAoB,EACpB,qCAAqC,EACrC,mBAAmB,EACnB,sBAAsB,EACtB,8BAA8B,EAC9B,4BAA4B,EAC5B,gCAAgC,EAChC,oCAAoC,EACpC,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,+BAA+B,EAC/B,kCAAkC,EAClC,uCAAuC,EACvC,qCAAqC,EACrC,uBAAuB,EACvB,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,8BAA8B,EAC9B,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,qCAAqC,EACrC,0BAA0B,EAC1B,8BAA8B,EAC9B,2CAA2C,EAC3C,2BAA2B,EAC3B,6BAA6B,EAC7B,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,qCAAqC,EACrC,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,EAC3B,iCAAiC,EACjC,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,iHAAiH;AACjH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE/D,oDAAoD;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/aiSkillsUpstreamExports.js

@@ -4,7 +4,7 @@
  *
  * Gateway key helpers remain on {@link ./skillCatalogExports.js}.
  */
-export { AI_SKILLS_APP_ID, AI_SKILLS_CATALOG_ID, AI_SKILLS_DESCRIPTOR_VERSION, AI_SKILLS_CATALOG_ITEMS, AI_SKILLS_LLM_IDENTITY_KEY, buildAiSkillsCatalogDescriptor, computeSkillRowStatus, listAiSkillsCatalogItems, catalogSkillKeyToRunSkillKey, catalogItemIdFromSkillKey, fetchSkillTemplatesFromCatalox, extractRunnableTemplateBodiesFromAiSkillsCatalogData, defaultAiSkillsCataloxContext, CataloxSkillNotFoundError, CataloxSkillAlreadyExistsError, CataloxSkillNotRunnableError, initFirebaseAdminFromEnv, createCataloxFromEnv, enrichIdentityWithAiSkillsLlmSnapshot, normalizeForStorage, toPresentationMarkdown, extractTemplateTokensFromTexts, extractTokenNamesFromStrings, getSkillTemplatesForPresentation, updateSkillTemplatesFromPresentation, getSkillTemplateInputs, getSkillTokens, getSkillContent, modifySkillContent, createSubSkill, deleteSubSkill, SKILL_TEMPLATE_ROLES_ORDER, upsertSkillCatalogItem, softDeleteSkillCatalogItem, analyzeSkillRequest, buildSkillRequestAnalysisPacket, formatSkillRequestAnalysisMarkdown, FUNCX_ANALYZE_GATEWAY_INVOKE_REQUEST_ID, FUNCX_MIN_VERSION_FOR_ANALYZE_GATEWAY, runSkillRequestFromFlat, resolveAiEngineIdForRunSkill, SkillExecutionTraceError, includeRawProviderPayload, isTraceExecutionMode, } from "@exellix/ai-skills";
+export { AI_SKILLS_APP_ID, AI_SKILLS_CATALOG_ID, AI_SKILLS_DESCRIPTOR_VERSION, AI_SKILLS_CATALOG_ITEMS, AI_SKILLS_LLM_IDENTITY_KEY, buildAiSkillsCatalogDescriptor, computeSkillRowStatus, listAiSkillsCatalogItems, catalogSkillKeyToRunSkillKey, catalogItemIdFromSkillKey, fetchSkillTemplatesFromCatalox, extractRunnableTemplateBodiesFromAiSkillsCatalogData, defaultAiSkillsCataloxContext, CataloxSkillNotFoundError, CataloxSkillAlreadyExistsError, CataloxSkillNotRunnableError, initFirebaseAdminFromEnv, createCataloxFromEnv, enrichIdentityWithAiSkillsLlmSnapshot, normalizeForStorage, toPresentationMarkdown, extractTemplateTokensFromTexts, extractTokenNamesFromStrings, getSkillTemplatesForPresentation, updateSkillTemplatesFromPresentation, getSkillTemplateInputs, getSkillTokens, getSkillContent, modifySkillContent, createSubSkill, deleteSubSkill, SKILL_TEMPLATE_ROLES_ORDER, upsertSkillCatalogItem, softDeleteSkillCatalogItem, buildSkillRequestAnalysisPacket, formatSkillRequestAnalysisMarkdown, FUNCX_ANALYZE_GATEWAY_INVOKE_REQUEST_ID, FUNCX_MIN_VERSION_FOR_ANALYZE_GATEWAY, runSkillRequestFromFlat, resolveAiEngineIdForRunSkill, SkillExecutionTraceError, includeRawProviderPayload, isTraceExecutionMode, } from "@exellix/ai-skills";
 /** Lower-level execution entrypoints from `@exellix/ai-skills` (same package as {@link ExellixSkillsClient}). */
 export { SkillExecutor, BaseClient } from "@exellix/ai-skills";
 /** Markdown helper for gateway context payloads. */

package/dist/aiSkillsUpstreamExports.js.map

@@ -1 +1 @@
-{"version":3,"file":"aiSkillsUpstreamExports.js","sourceRoot":"","sources":["../src/aiSkillsUpstreamExports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,0BAA0B,EAC1B,8BAA8B,EAC9B,qBAAqB,EACrB,wBAAwB,EACxB,4BAA4B,EAC5B,yBAAyB,EACzB,8BAA8B,EAC9B,oDAAoD,EACpD,6BAA6B,EAC7B,yBAAyB,EACzB,8BAA8B,EAC9B,4BAA4B,EAC5B,wBAAwB,EACxB,oBAAoB,EACpB,qCAAqC,EACrC,mBAAmB,EACnB,sBAAsB,EACtB,8BAA8B,EAC9B,4BAA4B,EAC5B,gCAAgC,EAChC,oCAAoC,EACpC,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,EACnB,+BAA+B,EAC/B,kCAAkC,EAClC,uCAAuC,EACvC,qCAAqC,EACrC,uBAAuB,EACvB,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAsC5B,iHAAiH;AACjH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE/D,oDAAoD;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"aiSkillsUpstreamExports.js","sourceRoot":"","sources":["../src/aiSkillsUpstreamExports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,0BAA0B,EAC1B,8BAA8B,EAC9B,qBAAqB,EACrB,wBAAwB,EACxB,4BAA4B,EAC5B,yBAAyB,EACzB,8BAA8B,EAC9B,oDAAoD,EACpD,6BAA6B,EAC7B,yBAAyB,EACzB,8BAA8B,EAC9B,4BAA4B,EAC5B,wBAAwB,EACxB,oBAAoB,EACpB,qCAAqC,EACrC,mBAAmB,EACnB,sBAAsB,EACtB,8BAA8B,EAC9B,4BAA4B,EAC5B,gCAAgC,EAChC,oCAAoC,EACpC,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,+BAA+B,EAC/B,kCAAkC,EAClC,uCAAuC,EACvC,qCAAqC,EACrC,uBAAuB,EACvB,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAsC5B,iHAAiH;AACjH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE/D,oDAAoD;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/analysis/analyzeRunTaskRequest.d.ts

@@ -19,8 +19,8 @@ export type AnalyzeRunTaskRequestResult = AnalyzeSkillRequestResult & {
     };
 };
 /**
- * Preflight analysis for a {@link RunTaskRequest}: forwards to `@exellix/ai-skills`
- * {@link analyzeSkillRequest} on the {@link pickRunSkillRequestFields} slice and optionally
+ * Preflight analysis for a {@link RunTaskRequest}: forwards to
+ * {@link ExellixSkillsClient.analyzeSkillRequest} on the {@link pickRunSkillRequestFields} slice and optionally
  * merges ai-tasks {@link validateRunTaskConfig} findings.
  *
  * Does **not** invoke `runTask`, xynthesis, or the gateway skill executor.

package/dist/analysis/analyzeRunTaskRequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyzeRunTaskRequest.d.ts","sourceRoot":"","sources":["../../src/analysis/analyzeRunTaskRequest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAE/B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE,MAAM,MAAM,4BAA4B,GAAG,0BAA0B,GAAG;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,yBAAyB,GAAG;IACpE,kGAAkG;IAClG,uBAAuB,CAAC,EAAE;QACxB,EAAE,EAAE,OAAO,CAAC;QACZ,MAAM,EAAE,sBAAsB,EAAE,CAAC;KAClC,CAAC;CACH,CAAC;AAgCF;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,2BAA2B,CAAC,CAoDtC"}
+{"version":3,"file":"analyzeRunTaskRequest.d.ts","sourceRoot":"","sources":["../../src/analysis/analyzeRunTaskRequest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAE/B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE,MAAM,MAAM,4BAA4B,GAAG,0BAA0B,GAAG;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,yBAAyB,GAAG;IACpE,kGAAkG;IAClG,uBAAuB,CAAC,EAAE;QACxB,EAAE,EAAE,OAAO,CAAC;QACZ,MAAM,EAAE,sBAAsB,EAAE,CAAC;KAClC,CAAC;CACH,CAAC;AAgCF;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,2BAA2B,CAAC,CA0DtC"}

package/dist/analysis/analyzeRunTaskRequest.js

@@ -1,4 +1,4 @@
-import { analyzeSkillRequest, } from "@exellix/ai-skills";
+import { ExellixSkillsClient, } from "@exellix/ai-skills";
 import { pickRunSkillRequestFields } from "../utils/bridgeRunSkillGatewayMemory.js";
 import { validateRunTaskConfig } from "../validation/validateRunTaskConfig.js";
 function categoryForAiTasksIssue(issue) {
@@ -33,8 +33,8 @@ function mergeVerdict(a, b) {
     return "ok";
 }
 /**
- * Preflight analysis for a {@link RunTaskRequest}: forwards to `@exellix/ai-skills`
- * {@link analyzeSkillRequest} on the {@link pickRunSkillRequestFields} slice and optionally
+ * Preflight analysis for a {@link RunTaskRequest}: forwards to
+ * {@link ExellixSkillsClient.analyzeSkillRequest} on the {@link pickRunSkillRequestFields} slice and optionally
  * merges ai-tasks {@link validateRunTaskConfig} findings.
  *
  * Does **not** invoke `runTask`, xynthesis, or the gateway skill executor.
@@ -48,7 +48,14 @@ export async function analyzeRunTaskRequest(catalox, request, options) {
         aiTasksConfigValidation = { ok: v.ok, issues: v.issues };
         extraFindings.push(...v.issues.map(aiTasksIssueToFinding));
     }
-    const skillResult = await analyzeSkillRequest(catalox, skillRequest, options);
+    const skillsClient = new ExellixSkillsClient({ catalox, autoLoadDotenv: false });
+    let skillResult;
+    try {
+        skillResult = await skillsClient.analyzeSkillRequest(skillRequest, options);
+    }
+    finally {
+        await skillsClient.shutdown().catch(() => undefined);
+    }
     if (extraFindings.length === 0) {
         return { ...skillResult, aiTasksConfigValidation };
     }

package/dist/analysis/analyzeRunTaskRequest.js.map

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

package/dist/builders/task-request-builder.d.ts

@@ -193,18 +193,19 @@ export declare class TaskRequestBuilder {
      */
     withPrevNodeId(prevNodeId: string): this;
     /**
-     * Set canonical model slots for this task (graph-engine 7.x resolved pair).
+     * Set canonical model slots for this task (graph-engine 7.x+ triplet).
      *
-     * @param modelConfig `{ xynthesisModel, skillModel }` plus optional tuning fields.
+     * @param modelConfig `{ preActionModel, skillModel, postActionModel }` plus optional tuning fields.
      * @throws if legacy `model` is present on the config object.
      */
     withModelConfig(modelConfig: RunTaskModelConfig): this;
     /**
-     * Set MAIN skill model (concrete id or alias). xynthesisModel defaults to `balanced` for PRE/xynthesis paths.
+     * Set all three model slots (all required — no built-in defaults).
      */
-    withModel(skillModel: string, xynthesisModel?: string): this;
+    withModel(skillModel: string, preActionModel: string, postActionModel: string): this;
     withSkillModel(skillModel: string): this;
-    withXynthesisModel(xynthesisModel: string): this;
+    withPreActionModel(preActionModel: string): this;
+    withPostActionModel(postActionModel: string): this;
     /**
      * Set the **main-skill** LLM call configuration (`RunTaskRequest.llmCall`).
      *
@@ -212,14 +213,10 @@ export declare class TaskRequestBuilder {
      * (PRE synthesis, AI scoping, MAIN skill, POST audit/polish, utilities). It supports:
      *
      * - `model`         — provider/model id (overrides `modelConfig.skillModel` for MAIN).
-     * - `maxTokensCap`  — **hard ceiling** for completion tokens; passed to `xynthesis.resolveMaxTokens`
-     *                     so the dynamic budget never exceeds this value. Use this instead of a bare
-     *                     `maxTokens` when you want to keep auto-sizing on but bound it.
-     * - `maxTokens`     — alias for `maxTokensCap` (kept for ergonomic parity with `ModelConfig`).
+     * - `reasoningEffort` — Optimixer reasoning depth (ai-skills / xynthesis).
      * - `temperature`   — sampling temperature.
      * - `topP`          — nucleus-sampling cutoff.
-     * - `outputExpectation` — caller-supplied size/density hint forwarded to `resolveMaxTokens`
-     *                         (overrides per-action `ACTION_OUTPUT_DEFAULTS` from xynthesis routing JSON).
+     * - `outputExpectation` — output size/density intent for Optimixer (xynthesis-backed calls).
      * - `maxOutputLength` — character cap applied after the LLM returns (post-truncation, not a token cap).
      * - `timeoutMs`     — per-call timeout for the underlying invoke.
      *
@@ -229,7 +226,7 @@ export declare class TaskRequestBuilder {
      * ```typescript
      * builder.withLlmCall({
      *   model: "gpt-5-mini",
-     *   maxTokensCap: 4096,
+     *   reasoningEffort: "medium",
      *   temperature: 0.4,
      *   outputExpectation: { size: { kind: "absolute", maxWords: 600 }, density: "default" },
      * })

package/dist/builders/task-request-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-request-builder.d.ts","sourceRoot":"","sources":["../../src/builders/task-request-builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"task-request-builder.d.ts","sourceRoot":"","sources":["../../src/builders/task-request-builder.ts"],"names":[],"mappings":"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"}