@exellix/ai-tasks 8.4.0 → 8.4.2

package/dist/utils/aiProfileModelFormat.js

@@ -1,11 +1,5 @@
-import { isKnownProfileOrShortcut } from "@x12i/ai-profiles";
+import { formatProfileChoiceKey, isKnownProfileChoice, isProfileChoiceKeyFormat, } from "@x12i/ai-profiles";
 import { isConcreteModelId } from "./concreteModelId.js";
-/** Legacy graph-engine tier names → `@x12i/ai-profiles` profile keys. */
-export const LEGACY_TIER_TO_PROFILE = {
-    weak: "cheap",
-    strong: "pro",
-    default: "balanced",
-};
 function parseProfileSlotForAlias(profileSlot) {
     const trimmed = profileSlot.trim();
     const at = trimmed.indexOf("@");
@@ -13,7 +7,10 @@ function parseProfileSlotForAlias(profileSlot) {
         return { profileInput: trimmed.slice(0, at).trim() };
     return { profileInput: trimmed };
 }
-/** True when `value` is a known ai-profiles profile, shortcut, or legacy tier alias. */
+/**
+ * True when `value` is a known ai-profiles **choice key** (`profile/choice` or shortcut).
+ * Bare profile keys (e.g. `cheap`) are resolved at invoke via {@link resolveAIProfile}, not sync-guessed.
+ */
 export function isResolvableModelAlias(value) {
     const trimmed = value.trim();
     if (!trimmed)
@@ -21,15 +18,37 @@ export function isResolvableModelAlias(value) {
     if (isConcreteModelId(trimmed))
         return false;
     const { profileInput } = parseProfileSlotForAlias(trimmed);
-    const key = profileInput.toLowerCase();
-    if (key in LEGACY_TIER_TO_PROFILE)
-        return true;
-    try {
-        return isKnownProfileOrShortcut(profileInput);
+    return isKnownProfileChoice(profileInput);
+}
+/** Trim profile slot input (no legacy tier remapping). */
+export function normalizeProfileSlotInput(value) {
+    return value.trim();
+}
+/**
+ * Map wire slot → ai-profiles 2.1 `resolveAIProfile` input (`profile/choice` or shortcut).
+ * Bare profile keys (e.g. `cheap`) expand to `cheap/default`.
+ */
+export function toStrictAiProfileResolveInput(profileSlot, explicitChoice) {
+    const trimmed = profileSlot.trim();
+    if (!trimmed)
+        return trimmed;
+    if (explicitChoice?.trim()) {
+        return formatProfileChoiceKey(trimmed, explicitChoice.trim());
     }
-    catch {
-        return false;
+    const at = trimmed.indexOf("@");
+    if (at > 0) {
+        const profile = trimmed.slice(0, at).trim();
+        const choice = trimmed.slice(at + 1).trim();
+        return choice ? formatProfileChoiceKey(profile, choice) : formatProfileChoiceKey(profile, "default");
+    }
+    if (isProfileChoiceKeyFormat(trimmed) || isKnownProfileChoice(trimmed)) {
+        return trimmed;
     }
+    return formatProfileChoiceKey(trimmed, "default");
+}
+/** @deprecated Use {@link normalizeProfileSlotInput}. */
+export function normalizeXynthesisModelAlias(value) {
+    return normalizeProfileSlotInput(value);
 }
 /** Format a resolved ai-profiles choice as a concrete provider model id for ai-skills MAIN. */
 export function formatResolvedProfileModelId(provider, modelId) {
@@ -49,11 +68,4 @@ export function formatResolvedProfileModelId(provider, modelId) {
         return trimmed;
     return `${providerTrim}/${trimmed}`;
 }
-/** Map legacy tiers to ai-profiles keys without resolving to a provider model id. */
-export function normalizeXynthesisModelAlias(value) {
-    const trimmed = value.trim();
-    if (!trimmed)
-        return trimmed;
-    return LEGACY_TIER_TO_PROFILE[trimmed.toLowerCase()] ?? trimmed;
-}
 //# sourceMappingURL=aiProfileModelFormat.js.map

package/dist/utils/aiProfileModelFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"aiProfileModelFormat.js","sourceRoot":"","sources":["../../src/utils/aiProfileModelFormat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,yEAAyE;AACzE,MAAM,CAAC,MAAM,sBAAsB,GAA2B;IAC5D,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,UAAU;CACpB,CAAC;AAEF,SAAS,wBAAwB,CAAC,WAAmB;IACnD,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,EAAE,GAAG,CAAC;QAAE,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IACjE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;AACnC,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,iBAAiB,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,MAAM,EAAE,YAAY,EAAE,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IACvC,IAAI,GAAG,IAAI,sBAAsB;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,CAAC;QACH,OAAO,wBAAwB,CAAC,YAAY,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,4BAA4B,CAAC,QAAgB,EAAE,OAAe;IAC5E,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC;IAC7B,IAAI,YAAY,CAAC,WAAW,EAAE,KAAK,YAAY,EAAE,CAAC;QAChD,IAAI,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC;YAAE,OAAO,OAAO,CAAC;QACtD,OAAO,cAAc,OAAO,EAAE,CAAC;IACjC,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAC1C,MAAM,cAAc,GAAG,GAAG,YAAY,GAAG,CAAC;IAC1C,IAAI,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC;QAAE,OAAO,OAAO,CAAC;IACvD,OAAO,GAAG,YAAY,IAAI,OAAO,EAAE,CAAC;AACtC,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,4BAA4B,CAAC,KAAa;IACxD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC;IAC7B,OAAO,sBAAsB,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,OAAO,CAAC;AAClE,CAAC"}
+{"version":3,"file":"aiProfileModelFormat.js","sourceRoot":"","sources":["../../src/utils/aiProfileModelFormat.ts"],"names":[],"mappings":"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"}

package/dist/utils/concreteModelId.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"concreteModelId.d.ts","sourceRoot":"","sources":["../../src/utils/concreteModelId.ts"],"names":[],"mappings":"AAaA,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKxD"}
+{"version":3,"file":"concreteModelId.d.ts","sourceRoot":"","sources":["../../src/utils/concreteModelId.ts"],"names":[],"mappings":"AAeA,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOxD"}

package/dist/utils/concreteModelId.js

@@ -1,3 +1,4 @@
+import { isProfileChoiceKeyFormat } from "@x12i/ai-profiles";
 const KNOWN_PROVIDER_PREFIXES = [
     "openrouter/",
     "anthropic/",
@@ -15,8 +16,9 @@ export function isConcreteModelId(value) {
     const trimmed = value.trim();
     if (!trimmed)
         return false;
-    if (trimmed.includes("/"))
-        return true;
+    if (trimmed.includes("/")) {
+        return !isProfileChoiceKeyFormat(trimmed);
+    }
     return KNOWN_PROVIDER_PREFIXES.some((p) => trimmed.startsWith(p));
 }
 //# sourceMappingURL=concreteModelId.js.map

package/dist/utils/concreteModelId.js.map

@@ -1 +1 @@
-{"version":3,"file":"concreteModelId.js","sourceRoot":"","sources":["../../src/utils/concreteModelId.ts"],"names":[],"mappings":"AAAA,MAAM,uBAAuB,GAAG;IAC9B,aAAa;IACb,YAAY;IACZ,SAAS;IACT,SAAS;IACT,OAAO;IACP,aAAa;IACb,UAAU;IACV,SAAS;IACT,WAAW;IACX,OAAO;CACC,CAAC;AAEX,2FAA2F;AAC3F,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC"}
+{"version":3,"file":"concreteModelId.js","sourceRoot":"","sources":["../../src/utils/concreteModelId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,uBAAuB,GAAG;IAC9B,aAAa;IACb,YAAY;IACZ,SAAS;IACT,SAAS;IACT,OAAO;IACP,aAAa;IACb,UAAU;IACV,SAAS;IACT,WAAW;IACX,OAAO;CACC,CAAC;AAEX,2FAA2F;AAC3F,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/utils/resolveAiProfileModel.d.ts

@@ -19,7 +19,7 @@ export type ResolveModelReferenceOptions = {
 export declare function resolveModelReference(value: string | undefined, options?: ResolveModelReferenceOptions): Promise<string | undefined>;
 /**
  * Resolve a model reference for `@exellix/xynthesis` ≥4.0 (`executeXynthesisAction`):
- * keep ai-profiles aliases (legacy tiers normalized); reject concrete provider ids.
+ * keep ai-profiles aliases on the wire; reject concrete provider ids.
  */
 export declare function resolveModelReferenceForXynthesis(value: string | undefined): Promise<string | undefined>;
 //# sourceMappingURL=resolveAiProfileModel.d.ts.map

package/dist/utils/resolveAiProfileModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveAiProfileModel.d.ts","sourceRoot":"","sources":["../../src/utils/resolveAiProfileModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAUhF,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,2BAA2B,CAAC;AAEnC,+GAA+G;AAC/G,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0CAA0C;IAC1C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAoB7B;AAED;;;GAGG;AACH,wBAAsB,iCAAiC,CACrD,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAe7B"}
+{"version":3,"file":"resolveAiProfileModel.d.ts","sourceRoot":"","sources":["../../src/utils/resolveAiProfileModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAUhF,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,2BAA2B,CAAC;AAEnC,+GAA+G;AAC/G,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0CAA0C;IAC1C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAmB7B;AAED;;;GAGG;AACH,wBAAsB,iCAAiC,CACrD,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU7B"}

package/dist/utils/resolveAiProfileModel.js

@@ -19,8 +19,6 @@ export async function resolveModelReference(value, options) {
         return undefined;
     if (isConcreteModelId(trimmed))
         return trimmed;
-    if (!isResolvableModelAlias(trimmed) && !trimmed.includes("@"))
-        return trimmed;
     const { effectiveUseOpenRouter } = resolvePreferOpenRouterPolicy({
         preferOpenRouter: options?.preferOpenRouter ?? options?.useOpenRouter,
         openrouterApiKeyPresent: options?.openrouterApiKeyPresent,
@@ -36,7 +34,7 @@ export async function resolveModelReference(value, options) {
 }
 /**
  * Resolve a model reference for `@exellix/xynthesis` ≥4.0 (`executeXynthesisAction`):
- * keep ai-profiles aliases (legacy tiers normalized); reject concrete provider ids.
+ * keep ai-profiles aliases on the wire; reject concrete provider ids.
  */
 export async function resolveModelReferenceForXynthesis(value) {
     if (value === undefined)
@@ -47,9 +45,6 @@ export async function resolveModelReferenceForXynthesis(value) {
     if (isConcreteModelId(normalized)) {
         throw new Error(`@exellix/xynthesis ≥4.0 requires ai-profiles model aliases for executeXynthesisAction (got concrete id "${normalized}"). Use a profile/shortcut such as balanced, cheapest, or json.`);
     }
-    if (!isResolvableModelAlias(normalized)) {
-        throw new Error(`Unknown xynthesis model alias "${normalized}". Use an @x12i/ai-profiles profile or shortcut (e.g. balanced, cheapest, json).`);
-    }
     return normalized;
 }
 //# sourceMappingURL=resolveAiProfileModel.js.map

package/dist/utils/resolveAiProfileModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveAiProfileModel.js","sourceRoot":"","sources":["../../src/utils/resolveAiProfileModel.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,kDAAkD,CAAC;AACnG,OAAO,EAAE,6BAA6B,EAAE,MAAM,yCAAyC,CAAC;AACxF,OAAO,EAEL,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,2BAA2B,CAAC;AAEnC,+GAA+G;AAC/G,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAaD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAyB,EACzB,OAAsC;IAEtC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,IAAI,iBAAiB,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAC/C,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAE/E,MAAM,EAAE,sBAAsB,EAAE,GAAG,6BAA6B,CAAC;QAC/D,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,IAAI,OAAO,EAAE,aAAa;QACrE,uBAAuB,EAAE,OAAO,EAAE,uBAAuB;KAC1D,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,+BAA+B,CAAC,OAAO,EAAE;QAC9D,SAAS,EAAE,OAAO;QAClB,sBAAsB;QACtB,uBAAuB,EAAE,OAAO,EAAE,uBAAuB;QACzD,MAAM,EAAE,OAAO,EAAE,MAAM;QACvB,WAAW,EAAE,OAAO,EAAE,WAAW;KAClC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,KAAyB;IAEzB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,UAAU,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,IAAI,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,2GAA2G,UAAU,iEAAiE,CACvL,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,sBAAsB,CAAC,UAAU,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,kCAAkC,UAAU,kFAAkF,CAC/H,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}
+{"version":3,"file":"resolveAiProfileModel.js","sourceRoot":"","sources":["../../src/utils/resolveAiProfileModel.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,kDAAkD,CAAC;AACnG,OAAO,EAAE,6BAA6B,EAAE,MAAM,yCAAyC,CAAC;AACxF,OAAO,EAEL,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,2BAA2B,CAAC;AAEnC,+GAA+G;AAC/G,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAaD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAyB,EACzB,OAAsC;IAEtC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,IAAI,iBAAiB,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAE/C,MAAM,EAAE,sBAAsB,EAAE,GAAG,6BAA6B,CAAC;QAC/D,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,IAAI,OAAO,EAAE,aAAa;QACrE,uBAAuB,EAAE,OAAO,EAAE,uBAAuB;KAC1D,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,+BAA+B,CAAC,OAAO,EAAE;QAC9D,SAAS,EAAE,OAAO;QAClB,sBAAsB;QACtB,uBAAuB,EAAE,OAAO,EAAE,uBAAuB;QACzD,MAAM,EAAE,OAAO,EAAE,MAAM;QACvB,WAAW,EAAE,OAAO,EAAE,WAAW;KAClC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,KAAyB;IAEzB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,UAAU,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,IAAI,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,2GAA2G,UAAU,iEAAiE,CACvL,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/documenations/upstream-feature-requests/README.md

@@ -6,9 +6,11 @@ Fix reports filed for sibling packages. Hand these to the package owners; after
 
 | Package | Document | Status |
 |---------|----------|--------|
-| `@exellix/ai-skills` ≥ 5.9 | [ai-skills-orchestrator-invoke-contract-5.9.md](./ai-skills-orchestrator-invoke-contract-5.9.md) | **open** — `reasoningEffort` on request |
-| `@exellix/xynthesis` ≥ 4.2 | [xynthesis-orchestrator-invoke-contract-4.2.md](./xynthesis-orchestrator-invoke-contract-4.2.md) | **open** — `reasoningEffort`, temperature/topP audit, docs |
-| `@exellix/ai-tasks` | [ai-tasks-wrap-up-after-upstream.md](./ai-tasks-wrap-up-after-upstream.md) | **blocked** on above |
+| `@exellix/ai-skills` 6.0 | [ai-skills-orchestrator-invoke-contract-5.9.md](./ai-skills-orchestrator-invoke-contract-5.9.md) | **shipped** — `ModelConfig.reasoningEffort` |
+| `@exellix/xynthesis` 4.3 | [**xynthesis-ai-profiles-2.1-import-break.md**](./xynthesis-ai-profiles-2.1-import-break.md) | **P0 blocked** — **4.3.0** breaks `import "@exellix/xynthesis"` with ai-profiles **2.1.0**; need **≥ 4.3.1** |
+| `@exellix/xynthesis` 4.3 | [xynthesis-orchestrator-invoke-contract-4.2.md](./xynthesis-orchestrator-invoke-contract-4.2.md) | **partial** — `reasoningEffort` shipped in 4.3.0; import break tracked in CR above |
+| `@x12i/ai-profiles` 2.1 | — | **shipped** — `catalogLane` required; sync `isKnownProfileOrShortcut` removed (safer — resolve at invoke) |
+| `@exellix/ai-tasks` | [ai-tasks-wrap-up-after-upstream.md](./ai-tasks-wrap-up-after-upstream.md) | **done** in 8.4 — no legacy tiers; resolve at invoke via `resolveAIProfile` |
 
 ## Older / parallel tracks
 

package/documenations/upstream-feature-requests/ai-skills-orchestrator-invoke-contract-5.9.md

@@ -1,10 +1,10 @@
 # `@exellix/ai-skills` — orchestrator invoke contract fixes (≥ 5.9)
 
-Status: **open** — blocks clean `@exellix/ai-tasks` 8.4+ integration  
+Status: **shipped** in **6.0.0** (`ModelConfig.reasoningEffort`)  
 Owner: `@exellix/ai-skills`  
 Filed by: `@exellix/ai-tasks`  
 Consumer: `@exellix/ai-tasks` 8.4.0, graph-engine 7.x (`RunTaskRequest.modelConfig` triplet)  
-Pinned in ai-tasks today: `@exellix/ai-skills@5.9.11`
+Pinned in ai-tasks today: `@exellix/ai-skills@6.0.0`
 
 Related (older, partially superseded): [`ai-skills-llm-observability.md`](./ai-skills-llm-observability.md)
 
@@ -43,13 +43,12 @@ ai-skills **5.9.11 already enforces the right side** (`ModelConfig.maxTokens?: n
 
 ## Required fixes
 
-### 1. Accept `reasoningEffort` on `RunSkillRequest` (or explicit `ModelConfig` extension)
+### 1. Accept `reasoningEffort` on `RunSkillRequest` (or explicit `ModelConfig` extension) — **shipped in 6.0.0**
 
-#### Today
+#### Today (6.0.0)
 
-- `reasoningEffort` exists only on the **Catalox `ai-skills` catalog row** (`SkillOptimixerCatalogSpec.reasoningEffort`).
-- `RunSkillRequest` / `ModelConfig` expose `model`, `temperature`, `topP`, … but **no `reasoningEffort`**.
-- `@exellix/ai-tasks` has nothing to forward from graph-engine / `llmCall` even when the operator configures it per task.
+- **`ModelConfig.reasoningEffort`** is optional; resolution: request → Catalox catalog → `"not-applicable"`.
+- ai-tasks forwards via `buildAiSkillsModelConfigForMain` (`modelConfig` tuning passthrough + `llmCall` overlay).
 
 #### Why it hurts
 

package/documenations/upstream-feature-requests/ai-tasks-wrap-up-after-upstream.md

@@ -1,6 +1,6 @@
 # `@exellix/ai-tasks` — wrap-up after upstream invoke-contract fixes
 
-Status: **blocked** on upstream PRs until both packages ship items in:
+Status: **blocked** on **@exellix/xynthesis ≥ 4.3.1** ([xynthesis-ai-profiles-2.1-import-break.md](./xynthesis-ai-profiles-2.1-import-break.md)); invoke-contract items below are otherwise shipped in **ai-skills 6.0** / **xynthesis 4.3**:
 
 - [`ai-skills-orchestrator-invoke-contract-5.9.md`](./ai-skills-orchestrator-invoke-contract-5.9.md)
 - [`xynthesis-orchestrator-invoke-contract-4.2.md`](./xynthesis-orchestrator-invoke-contract-4.2.md)
@@ -107,8 +107,8 @@ flowchart LR
 
 Recommended sequence:
 
-1. Merge **xynthesis** + **ai-skills** contract PRs (can be parallel).
-2. Bump `package.json` minimums in ai-tasks.
+1. Merge **xynthesis** ai-profiles 2.1 import fix (**≥ 4.3.1**) + **ai-skills** contract PRs (can be parallel).
+2. Bump `package.json`: `"@exellix/xynthesis": "^4.3.1"` (minimum — **do not** ship ai-tasks 8.4.x consumer release on **4.3.0**).
 3. Execute **this wrap-up** checklist in one ai-tasks PR.
 4. Release note in **8.4.x** or **8.5.0** with graph-engine migration (drop `maxTokensCap` on task payloads if removed).
 

package/documenations/upstream-feature-requests/xynthesis-ai-profiles-2.1-import-break.md

@@ -0,0 +1,324 @@
+# `@exellix/xynthesis` — ai-profiles 2.1 import break (`isKnownProfileOrShortcut` removed)
+
+Status: **open — blocks all consumers**  
+Owner: `@exellix/xynthesis`  
+Filed by: `@exellix/ai-tasks`  
+Target release: **`@exellix/xynthesis` ≥ 4.3.1**  
+Reproduced with: `@exellix/xynthesis` **4.3.0** (broken), `@x12i/ai-profiles` **2.1.0** (required by `@x12i/ai-tools` ≥ 2.4)  
+Consumers blocked: `@exellix/ai-tasks` **8.4.x**, graph-engine import tests, any app that `import "@exellix/xynthesis"`
+
+Related: [`xynthesis-orchestrator-invoke-contract-4.2.md §0`](./xynthesis-orchestrator-invoke-contract-4.2.md) (invoke-contract track — this CR is the **P0 runtime fix**)
+
+---
+
+## Summary
+
+**`@exellix/xynthesis@4.3.0`** imports and re-exports **`isKnownProfileOrShortcut`** from **`@x12i/ai-profiles`**. That symbol was **removed from the package root in ai-profiles 2.1.0** (replaced by **`isKnownProfileChoice`** and strict **`profile/choice`** resolution).
+
+With the current Exellix stack pinned to ai-profiles **2.1.0**, **module load fails before any API call**:
+
+```text
+SyntaxError: The requested module '@x12i/ai-profiles' does not provide an export named 'isKnownProfileOrShortcut'
+```
+
+**Not an ai-profiles bug** — 2.1.0 intentionally dropped sync alias guessing.  
+**Not an ai-tasks bug** — ai-tasks already migrated to ai-profiles 2.1 APIs.  
+**Not fixable in consumers** — npm `overrides`, deep imports of `dist/isKnownProfileOrShortcut.js`, or pinning ai-profiles `<2.1` violate the no-legacy invoke contract and break `@x12i/ai-tools`.
+
+**Required:** xynthesis **4.3.1** patch — adopt ai-profiles 2.1 resolve input normalization (same pattern as ai-tasks 8.4).
+
+---
+
+## Impact
+
+| Path | Symptom |
+|------|---------|
+| `import "@exellix/xynthesis"` | **SyntaxError** at ESM link time |
+| `import "@exellix/ai-tasks"` | Same — ai-tasks depends on xynthesis |
+| graph-engine / consumer test suites | Fail at import; no `runTask()` coverage |
+| `executeXynthesisAction({ model: "cheap", … })` | Would fail at resolve **after** import fix if resolve path is not updated |
+
+---
+
+## Reproduction
+
+### Minimal (any Node 20+ project with both packages installed)
+
+```bash
+npm i @exellix/xynthesis@4.3.0 @x12i/ai-profiles@2.1.0
+node -e "import('@exellix/xynthesis').then(() => console.log('ok')).catch(e => console.error(e))"
+# SyntaxError: ... does not provide an export named 'isKnownProfileOrShortcut'
+```
+
+### From ai-tasks repo
+
+```bash
+cd ai-tasks
+npm install   # tree dedupes ai-profiles@2.1.0
+node -e "import('@exellix/xynthesis')"
+npm run test  # fails at import / dist-test compile depending on test graph
+```
+
+### Dependency tree (why ai-profiles cannot be downgraded)
+
+```text
+@exellix/ai-tasks
+├── @x12i/ai-profiles@2.1.0
+├── @exellix/xynthesis@4.3.0  → imports isKnownProfileOrShortcut ✗
+├── @exellix/ai-skills@6.0.0  → ai-profiles@2.1.0
+└── @x12i/funcx@4.3.3         → ai-profiles@2.1.0
+    └── @exellix/xynthesis (transitive)
+        └── @x12i/ai-tools@2.4.0 → requires ai-profiles 2.1 (formatProfileChoiceKey)
+```
+
+---
+
+## Root cause (xynthesis 4.3.0)
+
+### 1. Broken ESM import / re-export
+
+**File:** `src/index.ts` (compiled to `dist/index.js`)
+
+```ts
+export {
+  resolveAIProfile,
+  isKnownProfileOrShortcut,  // ← removed from ai-profiles 2.1 root
+  listAIProfiles,
+  listAIShortcuts,
+} from "@x12i/ai-profiles";
+```
+
+**File:** `src/resolveAiProfileModel.ts`
+
+```ts
+import { isKnownProfileOrShortcut, resolveAIProfile } from "@x12i/ai-profiles";
+
+export function assertKnownModelAlias(input: string): void {
+  // ...
+  if (!isKnownProfileOrShortcut(key)) {
+    throw new Error(`xynthesis: unknown model alias "${key}"…`);
+  }
+}
+```
+
+Because **`index.ts` re-exports the missing symbol**, Node fails while linking `@exellix/xynthesis` — even callers that never use `assertKnownModelAlias`.
+
+### 2. Stale resolve input shape (secondary — fails after import fix)
+
+**File:** `src/resolveAiProfileModel.ts` — `resolveXynthesisModel`
+
+```ts
+const profile = await resolveAIProfile(alias, mergedOptions);
+```
+
+ai-profiles **2.1.0** rejects bare profile keys:
+
+```text
+Unknown profile/choice key: cheap. Use "profile/choice" (e.g. "cheap/default") or a shortcut that pins both.
+```
+
+Orchestrators (graph-engine, ai-tasks) still send **`preActionModel: "cheap"`** / **`postActionModel: "cheap"`** on the wire. ai-tasks expands at invoke via `formatProfileChoiceKey(profile, "default")`; xynthesis must do the same before `resolveAIProfile`.
+
+---
+
+## Recommended fix (xynthesis ≥ 4.3.1)
+
+**No consumer workarounds.** Fix belongs entirely in `@exellix/xynthesis`.
+
+### Step 1 — Bump dependency
+
+```json
+"@x12i/ai-profiles": "^2.1.0"
+```
+
+### Step 2 — Add ai-profiles 2.1 input normalization helper
+
+Mirror **`@exellix/ai-tasks`** `src/utils/aiProfileModelFormat.ts` (`toStrictAiProfileResolveInput`). Suggested new file **`src/aiProfileResolveInput.ts`**:
+
+```ts
+import {
+  formatProfileChoiceKey,
+  isKnownProfileChoice,
+  isProfileChoiceKeyFormat,
+} from "@x12i/ai-profiles";
+
+/** Map caller alias → ai-profiles 2.1 `resolveAIProfile` input. */
+export function toStrictAiProfileResolveInput(profileSlot: string, explicitChoice?: string): string {
+  const trimmed = profileSlot.trim();
+  if (!trimmed) return trimmed;
+
+  if (explicitChoice?.trim()) {
+    return formatProfileChoiceKey(trimmed, explicitChoice.trim());
+  }
+
+  const at = trimmed.indexOf("@");
+  if (at > 0) {
+    const profile = trimmed.slice(0, at).trim();
+    const choice = trimmed.slice(at + 1).trim();
+    return choice
+      ? formatProfileChoiceKey(profile, choice)
+      : formatProfileChoiceKey(profile, "default");
+  }
+
+  if (isProfileChoiceKeyFormat(trimmed) || isKnownProfileChoice(trimmed)) {
+    return trimmed;
+  }
+
+  // Bare profile key (e.g. "cheap") → default choice ("cheap/default")
+  return formatProfileChoiceKey(trimmed, "default");
+}
+
+/** Sync bundled-registry check after normalization (shortcuts + profile/choice keys). */
+export function isKnownXynthesisModelAlias(input: string): boolean {
+  const trimmed = input.trim();
+  if (!trimmed) return false;
+  const resolveInput = toStrictAiProfileResolveInput(trimmed);
+  return isKnownProfileChoice(resolveInput);
+}
+```
+
+### Step 3 — Update `resolveAiProfileModel.ts`
+
+```ts
+import { resolveAIProfile } from "@x12i/ai-profiles";
+import {
+  isKnownXynthesisModelAlias,
+  toStrictAiProfileResolveInput,
+} from "./aiProfileResolveInput.js";
+
+export function assertKnownModelAlias(input: string): void {
+  const key = normalizeAliasInput(input);
+  if (!key) {
+    throw new Error("xynthesis: model alias must be a non-empty string");
+  }
+  if (!isKnownXynthesisModelAlias(key)) {
+    throw new Error(
+      `xynthesis: unknown model alias "${key}". Use profile/choice (e.g. cheap/default), profile@choice, or a shortcut (cheapest, default, json).`
+    );
+  }
+}
+
+export async function resolveXynthesisModel(input, options) {
+  // ... existing guards ...
+  const alias = normalizeAliasInput(input);
+  const resolveInput = toStrictAiProfileResolveInput(alias);
+  const profile = await resolveAIProfile(resolveInput, mergedOptions);
+  // ... rest unchanged ...
+}
+```
+
+### Step 4 — Fix public re-exports in `index.ts`
+
+**Remove** `isKnownProfileOrShortcut` from the ai-profiles re-export block.
+
+**Preferred replacement:**
+
+```ts
+export {
+  resolveAIProfile,
+  isKnownProfileChoice,
+  formatProfileChoiceKey,
+  listAIProfiles,
+  listAIShortcuts,
+} from "@x12i/ai-profiles";
+```
+
+**Breaking note for xynthesis CHANGELOG:** `isKnownProfileOrShortcut` re-export removed; use `isKnownProfileChoice` + `toStrictAiProfileResolveInput` (exported from xynthesis) or import directly from `@x12i/ai-profiles`.
+
+Optionally export `toStrictAiProfileResolveInput` / `isKnownXynthesisModelAlias` from the package root if downstream tools relied on xynthesis as the ai-profiles facade.
+
+### Step 5 — Tests (xynthesis)
+
+Extend **`test/resolveAiProfileModel.unit.ts`**:
+
+```ts
+import assert from "node:assert/strict";
+import { isKnownXynthesisModelAlias, toStrictAiProfileResolveInput } from "../src/aiProfileResolveInput.js";
+import { resolveXynthesisModel, assertKnownModelAlias } from "../src/resolveAiProfileModel.js";
+
+// Import smoke (add dedicated test file if needed)
+await import("../dist/index.js"); // must not throw with ai-profiles 2.1 peer
+
+assert.equal(toStrictAiProfileResolveInput("cheap"), "cheap/default");
+assert.equal(isKnownXynthesisModelAlias("cheap"), true);
+assert.equal(isKnownXynthesisModelAlias("cheapest"), true);
+assert.throws(() => assertKnownModelAlias("not-a-profile"));
+
+const resolved = await resolveXynthesisModel("cheap", {
+  source: "bundled",
+  preferOpenRouter: false,
+  openrouterApiKeyPresent: false,
+});
+assert.ok(resolved?.wireModelId.includes("/"));
+```
+
+Add **`test/aiProfiles21Import.unit.ts`**:
+
+```ts
+await import("@exellix/xynthesis"); // ESM link test
+```
+
+Run full suite with **`@x12i/ai-profiles@2.1.0`** installed (not 2.0.x).
+
+---
+
+## Explicitly rejected (no workarounds)
+
+| Approach | Why rejected |
+|----------|--------------|
+| Consumer npm `overrides` pinning ai-profiles 2.0.x | Breaks `@x12i/ai-tools` / `formatProfileChoiceKey`; violates stack alignment |
+| Deep import `@x12i/ai-profiles/dist/isKnownProfileOrShortcut.js` | Private path; not in package exports |
+| ai-profiles 2.1.1 re-export shim only | Pushes debt upstream; xynthesis still passes bare keys to `resolveAIProfile` |
+| graph-engine / ai-tasks patch | Wrong layer — xynthesis owns PRE/POST model resolve |
+
+---
+
+## After xynthesis 4.3.1 ships — ai-tasks follow-up
+
+1. `"@exellix/xynthesis": "^4.3.1"` in `@exellix/ai-tasks` `package.json`
+2. `npm install && npm run test`
+3. Patch release **8.4.x** updating README / BREAKING-CHANGES minimums
+
+See [`ai-tasks-wrap-up-after-upstream.md`](./ai-tasks-wrap-up-after-upstream.md).
+
+---
+
+## Paste-ready GitHub issue (xynthesis repo)
+
+**Title:** ai-profiles 2.1: remove `isKnownProfileOrShortcut` import; normalize profile resolve input
+
+**Labels:** `bug`, `ai-profiles`, `breaking`, `P0`
+
+**Body:**
+
+> `@exellix/xynthesis@4.3.0` fails to load with `@x12i/ai-profiles@2.1.0`:
+>
+> ```
+> SyntaxError: The requested module '@x12i/ai-profiles' does not provide an export named 'isKnownProfileOrShortcut'
+> ```
+>
+> Blocks `@exellix/ai-tasks@8.4.x` and graph-engine import tests.
+>
+> **Fix (4.3.1):**
+> 1. Remove `isKnownProfileOrShortcut` import/re-export; use ai-profiles 2.1 APIs.
+> 2. Normalize bare profile keys (`cheap` → `cheap/default`) before `resolveAIProfile` — see ai-tasks `toStrictAiProfileResolveInput`.
+> 3. Bump `@x12i/ai-profiles` peer to `^2.1.0`; add import + resolve unit tests.
+>
+> Full spec: [link to this doc in ai-tasks repo]
+
+**Acceptance criteria:**
+
+- [ ] `node -e "import('@exellix/xynthesis')"` succeeds with `@x12i/ai-profiles@2.1.0`.
+- [ ] `resolveXynthesisModel("cheap", { source: "bundled" })` returns a wire model id (no `UNKNOWN_PROFILE_CHOICE`).
+- [ ] `assertKnownModelAlias("cheap")` does not throw; `assertKnownModelAlias("not-a-profile")` throws.
+- [ ] `isKnownProfileOrShortcut` is **not** exported from `@exellix/xynthesis` root.
+- [ ] CHANGELOG entry; publish **4.3.1** (patch).
+
+---
+
+## Related
+
+- [`@exellix/ai-tasks` `src/utils/aiProfileModelFormat.ts`](../../src/utils/aiProfileModelFormat.ts) — reference implementation
+- [`.docs/ai-tasks-model-profile-aliases-7x.md`](../../.docs/ai-tasks-model-profile-aliases-7x.md) — wire shapes orchestrators send
+- [`BREAKING-CHANGES.md`](../../BREAKING-CHANGES.md) — 8.4.x blocked subsection
+- [`xynthesis-orchestrator-invoke-contract-4.2.md`](./xynthesis-orchestrator-invoke-contract-4.2.md) — invoke contract (reasoningEffort shipped; import fix is separate P0)

package/documenations/upstream-feature-requests/xynthesis-orchestrator-invoke-contract-4.2.md

@@ -1,15 +1,25 @@
 # `@exellix/xynthesis` — orchestrator invoke contract fixes (≥ 4.2)
 
-Status: **open** — blocks clean `@exellix/ai-tasks` 8.4+ integration  
+Status: **partial** — `reasoningEffort` shipped in **4.3.0**; **runtime break** with `@x12i/ai-profiles` **2.1.0** (see §0)  
 Owner: `@exellix/xynthesis`  
 Filed by: `@exellix/ai-tasks`  
 Consumer: `@exellix/ai-tasks` 8.4.0 (PRE / POST / scoping / utilities / structured synthesis)  
-Pinned in ai-tasks today: `@exellix/xynthesis@4.2.2`
+Pinned in ai-tasks today: `@exellix/xynthesis@4.3.0`
 
 Related (older, partially superseded): [`xynthesis-llm-observability.md`](./xynthesis-llm-observability.md)
 
 ---
 
+## 0. Blocker: ai-profiles 2.1 import break — **see dedicated CR**
+
+**P0 — tracked in [`xynthesis-ai-profiles-2.1-import-break.md`](./xynthesis-ai-profiles-2.1-import-break.md).**
+
+**`@exellix/xynthesis@4.3.0`** breaks `import "@exellix/xynthesis"` with **`@x12i/ai-profiles@2.1.0`** (`isKnownProfileOrShortcut` removed). Fix requires **≥ 4.3.1** with ai-profiles 2.1 resolve-input normalization — not a symbol rename only.
+
+**After publish — ai-tasks bump:** `"@exellix/xynthesis": "^4.3.1"`, test, patch release.
+
+---
+
 ## Summary
 
 Xynthesis **4.2** moved token budgeting **inside** the package (`executeXynthesisAction` → `resolveEffectiveMaxTokens` + Optimixer). That is the right design.
@@ -49,13 +59,12 @@ Remaining gaps for orchestrators (`@exellix/ai-tasks`, graph-engine):
 
 ## Required fixes
 
-### 1. Accept `reasoningEffort` on all host-facing hop APIs
+### 1. Accept `reasoningEffort` on all host-facing hop APIs — **shipped in 4.3.0**
 
-#### Today
+#### Today (4.3.0)
 
-- `reasoningEffort` exists only on **`EffectiveMaxTokensResolutionInput`** (internal to `resolveEffectiveMaxTokens`).
-- **`ExecuteXynthesisActionRequest` has no `reasoningEffort` field.**
-- `executeXynthesisAction` calls Optimixer with `reasoningEffort: input.reasoningEffort ?? "not-applicable"` — hosts cannot override per call.
+- **`ExecuteXynthesisActionRequest.reasoningEffort`** and **`RunStructuredSynthesisParams.reasoningEffort`** are present and forwarded to Optimixer.
+- ai-tasks forwards `LlmCallConfig.reasoningEffort` on POST steps and structured PRE synthesis.
 
 #### Why it hurts
 
@@ -158,6 +167,8 @@ ai-tasks will follow whichever contract is published; default integration is **n
 
 ## Verification checklist (for xynthesis PR)
 
+- [ ] Replace `isKnownProfileOrShortcut` → `isKnownProfileChoice` (index re-export + `resolveAiProfileModel` / `assertKnownModelAlias`).
+- [ ] `import "@exellix/xynthesis"` succeeds with `@x12i/ai-profiles@2.1.0` installed.
 - [ ] `ExecuteXynthesisActionRequest.reasoningEffort` (and gateway wrappers).
 - [ ] Optimixer predict receives resolved `reasoningEffort`.
 - [ ] `temperature` + `topP` integration tests on `executeXynthesisAction` + structured gateway.