@exellix/ai-skills 6.16.0 → 7.0.1

package/dist/utils/gateway-invoke-rejection.js

@@ -1,3 +1,4 @@
+import { tryExtractFallbackAttemptsFromErrorChain } from "@x12i/ai-gateway";
 /**
  * Reads `@x12i/ai-gateway` **`GatewayInvokeRejectionMetadata`** from a thrown **`invoke()`** error
  * (`error.metadata`), walking **`cause`** a few hops (wrapped NO_PROVIDER errors preserve metadata on the wrapper).
@@ -25,4 +26,37 @@ function readRejectionMetadataFromSingleError(err) {
         return undefined;
     return m;
 }
+/**
+ * Lift gateway ≥ 10.4.4 provider failure taxonomy from a thrown invoke error
+ * (`providerSubCode`, `operatorHint`, structured `providerAttempts` / `fallbackAttempts`).
+ */
+export function providerInvokeFailureFromErrorChain(err) {
+    const rejection = gatewayInvokeRejectionFromErrorChain(err);
+    return rejection ? providerInvokeFailureFromRejection(rejection) : snapshotFromFallbackChainOnly(err);
+}
+function snapshotFromFallbackChainOnly(err) {
+    const chainFallbacks = tryExtractFallbackAttemptsFromErrorChain(err);
+    if (!chainFallbacks?.length)
+        return undefined;
+    const providerSubCode = chainFallbacks.find((a) => a.code)?.code;
+    return {
+        fallbackAttempts: chainFallbacks,
+        ...(providerSubCode ? { providerSubCode } : {}),
+    };
+}
+/** Normalize gateway rejection metadata into the ai-skills provider failure snapshot. */
+export function providerInvokeFailureFromRejection(rejection) {
+    const fallbackAttempts = rejection.fallbackAttempts;
+    const providerAttempts = rejection.providerAttempts;
+    const providerSubCode = rejection.providerSubCode ??
+        providerAttempts?.find((a) => a.code)?.code ??
+        fallbackAttempts?.find((a) => a.code)?.code;
+    return {
+        rejection,
+        ...(providerSubCode ? { providerSubCode } : {}),
+        ...(rejection.operatorHint ? { operatorHint: rejection.operatorHint } : {}),
+        ...(providerAttempts?.length ? { providerAttempts } : {}),
+        ...(fallbackAttempts?.length ? { fallbackAttempts } : {}),
+    };
+}
 //# sourceMappingURL=gateway-invoke-rejection.js.map

package/dist/utils/gateway-invoke-rejection.js.map

@@ -1 +1 @@
-{"version":3,"file":"gateway-invoke-rejection.js","sourceRoot":"","sources":["../../src/utils/gateway-invoke-rejection.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,oCAAoC,CAAC,GAAY;IAC7D,IAAI,GAAG,GAAY,GAAG,CAAC;IACvB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,oCAAoC,CAAC,GAAG,CAAC,CAAC;QACvD,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACpC,GAAG;YACC,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,IAAI,GAAG;gBACrD,CAAC,CAAE,GAA2B,CAAC,KAAK;gBACpC,CAAC,CAAC,SAAS,CAAC;IACxB,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,SAAS,oCAAoC,CAAC,GAAY;IACtD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACtD,MAAM,CAAC,GAAI,GAA6D,CAAC,QAAQ,CAAC;IAClF,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACtE,OAAO,CAAmC,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"gateway-invoke-rejection.js","sourceRoot":"","sources":["../../src/utils/gateway-invoke-rejection.ts"],"names":[],"mappings":"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"}

package/metadata/log-diagnostics.json

@@ -250,5 +250,24 @@
     "retryable": true,
     "userActionRequired": false,
     "confidence": "medium"
+  },
+  "SKILL_PROVIDER_INVOKE_FAILED": {
+    "defaultLevel": "error",
+    "title": "Gateway provider invoke failed",
+    "impact": "runSkill did not return a successful gateway response; downstream parsed output is unavailable.",
+    "possibleCauses": [
+      "Provider authentication failed for the resolved route (see providerSubCode evidence).",
+      "Provider quota or rate limit exceeded.",
+      "Model id not found on the resolved provider.",
+      "Gateway or provider network unreachable."
+    ],
+    "remediation": [
+      "Read providerSubCode and operatorHint evidence on this log entry.",
+      "Inspect trace.invokeRejection.providerAttempts when executionMode is trace.",
+      "Verify API keys for the adapter implied by the resolved model route."
+    ],
+    "retryable": true,
+    "userActionRequired": true,
+    "confidence": "high"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exellix/ai-skills",
-  "version": "6.16.0",
+  "version": "7.0.1",
   "description": "Foundational skill execution layer for exellix ecosystem using @x12i/ai-gateway with FlexMD 2.0 support and Catalox as the catalog store",
   "type": "module",
   "main": "dist/index.js",
@@ -24,7 +24,6 @@
   "files": [
     "dist",
     "metadata",
-    "templates",
     "README.md",
     "erc-manifest.json"
   ],
@@ -38,11 +37,11 @@
     "test:real": "tsx test-real.ts",
     "test:integration": "tsx test/run.ts",
     "test:unit": "tsx test/run-unit.ts",
-    "catalox:provision-ai-skills": "tsx scripts/provision-ai-skills-catalog.ts",
-    "catalox:sync-skill-templates": "tsx scripts/sync-skill-templates-to-catalox.ts",
+    "catalox:provision-ai-skills": "npm run catalox:provision-ai-skills -w @exellix/catalox-ai-skills",
+    "catalox:sync-skill-templates": "npm run catalox:sync-skill-templates -w @exellix/catalox-ai-skills",
     "catalox:provision-ai-engines": "tsx scripts/provision-ai-engines-catalog.ts",
     "catalox:restore": "npm run catalox:provision-ai-skills && npm run catalox:provision-ai-engines",
-    "catalox:verify": "tsx scripts/verify-catalox-catalogs.ts",
+    "catalox:verify": "npm run catalox:verify -w @exellix/catalox-ai-skills",
     "live:professional-answer": "tsx scripts/run-professional-answer-live.ts",
     "test:ci": "npm run build && npm run test:unit",
     "test": "npm run build && npm run test:integration",
@@ -66,10 +65,11 @@
     "@x12i/logxer": "$@x12i/logxer"
   },
   "dependencies": {
+    "@exellix/catalox-ai-skills": "^1.0.1",
     "@x12i/activix": "^9.0.0",
-    "@x12i/ai-gateway": "^10.4.3",
+    "@x12i/ai-gateway": "^10.4.4",
     "@x12i/ai-profiles": "^3.4.0",
-    "@x12i/catalox": "^5.9.8",
+    "@x12i/catalox": "^5.10.1",
     "@x12i/env": "^4.0.3",
     "@x12i/execution-memory-manager": "^1.2.0",
     "@x12i/graphenix-core": "^2.12.2",
@@ -82,7 +82,7 @@
   },
   "devDependencies": {
     "@types/node": "^20.19.27",
-    "@x12i/catalox-contracts": "^5.9.8",
+    "@x12i/catalox-contracts": "^5.10.1",
     "dotenv": "^16.6.1",
     "ts-node": "^10.9.2",
     "tsx": "^4.21.0",

package/templates/professional-answer/instructions.md

@@ -1,34 +0,0 @@
-# Professional answer
-
-You are a professional advisor. Answer the **question** supplied in `{{taskVariables.question}}` using only the facts, context, and knowledge provided in the user message.
-
-## Constraints
-
-- Address `taskVariables.question` directly. Do not substitute a different task or topic.
-- Ground every claim in the provided input, context, or knowledge. Do not invent facts.
-- State assumptions when you infer beyond the provided material.
-- List unknowns or information gaps that limit confidence.
-- Keep a professional, neutral tone suitable for {{jobVariables.audience | the intended audience}}.
-
-## Output format
-
-Respond with **only** the structure below. No preamble, no closing remarks, and no text outside these sections.
-
-Start with the FlexMD frame line, then use these headings exactly:
-
-[[frame:professional-answer]]
-
-### Short Answer
-One or two sentences that directly answer the question.
-
-### Full Answer
-A detailed explanation with reasoning. Use paragraphs or bullets as appropriate.
-
-### Assumptions
-- List each assumption on its own bullet, or write `- None` when you made no assumptions.
-
-### Unknowns
-- List each gap or missing fact on its own bullet, or write `- None` when nothing material is missing.
-
-### Evidence
-- Cite supporting facts from the provided input, context, or knowledge only. Do not rely on general world knowledge unless it appears in the provided material. Write `- None` when no supporting material was supplied.

package/templates/professional-answer/prompt.md

@@ -1,11 +0,0 @@
-Answer the question below using only the provided material.
-
-## Question
-
-{{taskVariables.question}}
-
-## Primary input
-
-{{input}}
-
-{{smartInput |}}

package/templates/professional-answer/synthesis-context/execution-memory-only/instructions.md

@@ -1,20 +0,0 @@
-# Synthesis context — execution memory only
-
-You prepare **synthesized context** for the downstream **professional-answer** MAIN skill. The MAIN skill will answer `{{taskVariables.question}}` using only material you distill here.
-
-## Role
-
-- Read the execution-memory JSON supplied in the user message.
-- Extract facts, structure, and reasoning relevant to the question.
-- Produce markdown context the MAIN skill can use as override context.
-
-## Core focus
-
-This synthesis pass targets {{core:analysis}} — structured analysis of the execution-memory payload relative to the question.
-
-## Constraints
-
-- Do not answer the question directly; prepare material for MAIN.
-- Do not invent facts absent from execution memory.
-- Prefer concise sections with headings when the payload is large.
-- Note gaps as "unknowns" when evidence is missing.

package/templates/professional-answer/synthesis-context/execution-memory-only/prompt.md

@@ -1,7 +0,0 @@
-Question for downstream MAIN: {{taskVariables.question}}
-
-Synthesize execution-memory content for {{core:analysis}}. Output markdown context only.
-
-Execution memory JSON:
-
-{{json executionMemory}}