@exellix/ai-skills 5.8.0

package/dist/client.js

@@ -0,0 +1,406 @@
+import { AIGateway } from "@x12i/ai-gateway";
+import { createLogxer, DebugLogAbstract } from "@x12i/logxer";
+import { loadDotenv } from "@x12i/env";
+import { getSkillContent as getSkillContentFromCatalox, getSkillTokens as getSkillTokensFromCatalox, modifySkillContent as modifySkillContentOnCatalox, createSubSkill as createSubSkillOnCatalox, deleteSubSkill as deleteSubSkillOnCatalox, getSkillTemplatesForPresentation, updateSkillTemplatesFromPresentation, getSkillTemplateInputs, upsertSkillCatalogItem as upsertSkillCatalogItemToCatalox, softDeleteSkillCatalogItem as softDeleteSkillCatalogItemFromCatalox, } from "./catalox/skill-template-catalog-mutations.js";
+import { defaultAiSkillsCataloxContext } from "./catalox/skill-templates.js";
+import { buildAiSkillsLogxerLoggingConfig } from "./utils/exellix-skills-logxer-defaults.js";
+import * as path from "path";
+import * as fs from "fs";
+import { SkillExecutor } from "./client/skill-executor.js";
+import { RegistryManager } from "./client/registry-manager.js";
+import { analyzeSkillRequest as analyzeSkillRequestCore } from "./analysis/analyze-skill-request.js";
+import { runtimeObjects } from "./runtime-objects.js";
+/**
+ * ExellixSkillsClient
+ *
+ * WHY: This is the main entry point for the AI Skills library. It provides
+ * a high-level API for running skills while automatically
+ * managing environment-based configuration (Env-Ready mode).
+ *
+ * DESIGN: It acts as an orchestrator, delegating specific tasks to
+ * specialized managers (Executor, Registry) to keep the code
+ * manageable and clean.
+ *
+ * **Skill keys (this package + Catalox only):** `skillKey` is normalized and
+ * matched to the native `ai-skills` catalog here. **`AIGateway` does not resolve
+ * skill keys** and is not used as a skill registry.
+ *
+ * **Gateway role:** `AIGateway` receives **literal** instruction/prompt **strings**
+ * (template text after Catalox load + `ensureGatewayTreatsAsTemplateText`) and
+ * handles **template rendering** (tokens, options you pass) and whatever
+ * **response parsing** the gateway exposes; this SDK may still merge FlexMD
+ * fallbacks when the gateway omits structured payloads.
+ *
+ * **Templates:** Instruction and prompt bodies are loaded exclusively from the
+ * Catalox native catalog `ai-skills` (see `npm run catalox:provision-ai-skills`).
+ */
+export class ExellixSkillsClient {
+    gateway;
+    logger;
+    ownsGateway;
+    testMode;
+    isShutdown = false;
+    shutdownPromise = null;
+    executor;
+    registry;
+    catalox;
+    cataloxAppId;
+    constructor(options) {
+        this.testMode = options.testMode ?? process.env.NODE_ENV === "test";
+        this.ownsGateway = !options.gateway;
+        if (!options.catalox) {
+            throw new Error("[AI-SKILLS] options.catalox is required. Skill templates are read only from the Catalox native catalog `ai-skills`.");
+        }
+        if (options.autoLoadDotenv !== false) {
+            try {
+                const parsed = loadDotenv(".env", true, false);
+                const loadedCount = Object.keys(parsed).length;
+                if (loadedCount > 0) {
+                    console.log(`[AI-SKILLS] Loaded ${loadedCount} environment variable(s) from .env file`);
+                }
+                else {
+                    console.warn("[AI-SKILLS] dotenv loaded 0 variables - .env file may be empty or missing");
+                }
+            }
+            catch (error) {
+                console.warn("[AI-SKILLS] Could not load dotenv (this is OK if you set env vars another way):", error.message);
+            }
+        }
+        this.logger = createLogxer({
+            packageName: options.packageName || "AI-SKILLS",
+            envPrefix: "AI_SKILLS",
+            debugNamespace: "ai-skills",
+        }, buildAiSkillsLogxerLoggingConfig({
+            service: options.packageName,
+            runtimeIdentity: options.logxerRuntimeIdentity,
+        }));
+        // Expose-only runtime objects: attach package-owned clients only if they already
+        // implement the official queryable contract. Never fabricate adapters here.
+        if (runtimeObjects) {
+            const maybeQueryableLogxer = this.logger;
+            if (typeof maybeQueryableLogxer?.getJobLogs === "function") {
+                runtimeObjects.logxerClient = maybeQueryableLogxer;
+            }
+        }
+        this.logger.info("[AI-SKILLS] Initializing ExellixSkillsClient...", {
+            packageName: options.packageName,
+            hasExternalGateway: !!options.gateway,
+            autoLoadDotenv: options.autoLoadDotenv !== false,
+            testMode: this.testMode,
+            debugKind: DebugLogAbstract.INTENT,
+        });
+        if (options.gateway) {
+            this.gateway = options.gateway;
+        }
+        else {
+            this.validateProviderEnv();
+            const gatewayConfig = {
+                packageName: options.packageName || "EXELLIX_SKILLS",
+                enableActivityTracking: this.testMode
+                    ? !(options.disableActivityTrackingInTests ?? true)
+                    : (options.enableActivityTracking ?? true),
+                ...(options.forceLocal !== undefined ? { forceLocal: options.forceLocal } : {}),
+                ...(options.forceCreateRootDirectory !== undefined
+                    ? { forceCreateRootDirectory: options.forceCreateRootDirectory }
+                    : {}),
+                ...(options.templateRendering !== undefined ? { templateRendering: options.templateRendering } : {}),
+            };
+            this.gateway = new AIGateway(gatewayConfig);
+        }
+        if (runtimeObjects) {
+            const gatewayRuntimeObjects = this.gateway?.runtimeObjects;
+            const gatewayActivixClient = gatewayRuntimeObjects?.activixClient;
+            const gatewayLogxerClient = gatewayRuntimeObjects?.logxerClient;
+            runtimeObjects.packagesRuntimeObjects = [
+                {
+                    name: "@x12i/ai-gateway",
+                    activixClient: typeof gatewayActivixClient?.getJobActivities === "function"
+                        ? gatewayActivixClient
+                        : undefined,
+                    logxerClient: typeof gatewayLogxerClient?.getJobLogs === "function" ? gatewayLogxerClient : undefined,
+                },
+            ];
+        }
+        this.catalox = options.catalox;
+        this.cataloxAppId = options.cataloxAppId;
+        const cataloxBundle = {
+            catalox: options.catalox,
+            cataloxAppId: options.cataloxAppId,
+        };
+        this.executor = new SkillExecutor(this.gateway, this.logger, cataloxBundle);
+        this.registry = new RegistryManager(this.gateway, this.logger, cataloxBundle);
+    }
+    cataloxContext() {
+        return defaultAiSkillsCataloxContext({ appId: this.cataloxAppId });
+    }
+    /**
+     * Skill templates as presentation markdown (Catalox read). Requires read access to the `ai-skills` catalog.
+     */
+    async getSkillTemplatesForPresentation(skillKey, opts) {
+        return getSkillTemplatesForPresentation(this.catalox, this.cataloxContext(), skillKey, opts);
+    }
+    /**
+     * Updates skill template bodies from editor markdown (lossless storage normalization + Catalox upsert).
+     * Requires write access (e.g. god-mode or app binding with write).
+     */
+    async updateSkillTemplatesFromPresentation(skillKey, patch, opts) {
+        return updateSkillTemplatesFromPresentation(this.catalox, this.cataloxContext(), skillKey, patch, opts);
+    }
+    /**
+     * Expected template tokens (`{{name}}`) from raw stored instructions/prompt/audit fields.
+     */
+    async getSkillTemplateInputs(skillKey) {
+        return getSkillTemplateInputs(this.catalox, this.cataloxContext(), skillKey);
+    }
+    /**
+     * Skill template bodies as `{ role, content }[]` (presentation markdown). Four entries in stable order.
+     */
+    async getSkillContent(skillKey) {
+        return getSkillContentFromCatalox(this.catalox, this.cataloxContext(), skillKey);
+    }
+    /**
+     * Unique `{{token}}` names across instructions, prompt, and audit bodies (presentation strings).
+     */
+    async getSkillTokens(skillKey) {
+        return getSkillTokensFromCatalox(this.catalox, this.cataloxContext(), skillKey);
+    }
+    /**
+     * Partial update of template bodies by role. Returns `{ success }` (errors are not thrown).
+     */
+    async modifySkillContent(skillKey, parts, opts) {
+        return modifySkillContentOnCatalox(this.catalox, this.cataloxContext(), skillKey, parts, opts);
+    }
+    /**
+     * Duplicate a skill under a new key with optional overrides; sets `parentSkillKey` on the new row.
+     */
+    async createSubSkill(input) {
+        return createSubSkillOnCatalox(this.catalox, this.cataloxContext(), input);
+    }
+    /**
+     * Remove a sub-skill row only when `parentSkillKey` is set (base catalog skills cannot be deleted here).
+     */
+    async deleteSubSkill(subSkillKey) {
+        return deleteSubSkillOnCatalox(this.catalox, this.cataloxContext(), subSkillKey);
+    }
+    async safeCallClose(target, name, context) {
+        if (!target || typeof target[name] !== "function")
+            return;
+        try {
+            await target[name]();
+        }
+        catch (error) {
+            this.logger.warn("[AI-SKILLS] Shutdown close hook failed", {
+                context,
+                method: name,
+                error: error?.message,
+                debugKind: DebugLogAbstract.ANOMALY,
+            });
+        }
+    }
+    validateProviderEnv() {
+        const providers = ["OPENAI_API_KEY", "GROK_API_KEY", "OPEN_ROUTER_KEY", "OPENROUTER_API_KEY"];
+        this.logger.info("[AI-SKILLS] Validating environment (provider keys)...", {
+            identity: "validateProviderEnv",
+            debugKind: DebugLogAbstract.INTENT,
+        });
+        if (!providers.some((key) => !!process.env[key])) {
+            const diagnostics = this.getEnvDiagnostics(providers);
+            const err = `[AI-SKILLS] ERC_VALIDATION_ERROR: Missing at least one provider key (OPENAI_API_KEY, GROK_API_KEY, OPEN_ROUTER_KEY, or OPENROUTER_API_KEY).\n${diagnostics}`;
+            this.logger.error(err, { debugKind: DebugLogAbstract.ANOMALY });
+            throw new Error(err);
+        }
+    }
+    getEnvDiagnostics(missingKeys) {
+        const keys = Array.isArray(missingKeys) ? missingKeys : [missingKeys];
+        const cwd = process.cwd();
+        const envPath = path.join(cwd, ".env");
+        let diagnostics = `\n[DIAGNOSTICS]\n`;
+        diagnostics += `  Current working directory: ${cwd}\n`;
+        diagnostics += `  Expected .env file path: ${envPath}\n`;
+        try {
+            if (fs.existsSync(envPath)) {
+                const stats = fs.statSync(envPath);
+                diagnostics += `  .env file exists: YES (${stats.size} bytes)\n`;
+                if (stats.size === 0) {
+                    diagnostics += `  ⚠️  WARNING: .env file is EMPTY (0 bytes)!\n`;
+                }
+                else {
+                    const content = fs.readFileSync(envPath, "utf8");
+                    const lines = content.split("\n").filter((line) => line.trim() && !line.trim().startsWith("#"));
+                    diagnostics += `  .env file contains ${lines.length} non-empty, non-comment line(s)\n`;
+                    const fileContent = fs.readFileSync(envPath, "utf8");
+                    for (const key of keys) {
+                        if (fileContent.includes(key)) {
+                            diagnostics += `  ✓ Found "${key}" in .env file\n`;
+                        }
+                        else {
+                            diagnostics += `  ✗ "${key}" NOT found in .env file\n`;
+                        }
+                    }
+                }
+            }
+            else {
+                diagnostics += `  .env file exists: NO\n`;
+            }
+        }
+        catch (error) {
+            diagnostics += `  Could not check .env file: ${error.message}\n`;
+        }
+        diagnostics += `\n[CATALOX]\n`;
+        diagnostics += `  Skill templates require Firestore + Catalox. Run: npm run catalox:provision-ai-skills\n`;
+        diagnostics += `  Set FIREBASE_PROJECT_ID and GOOGLE_SERVICE_ACCOUNT_BASE64 (or initialize Firebase yourself before createCatalox).\n`;
+        diagnostics += `\n[TROUBLESHOOTING]\n`;
+        diagnostics += `  1. Ensure .env file is in the project root directory\n`;
+        diagnostics += `  2. Check .env file format: KEY=value (no spaces around =)\n`;
+        diagnostics += `  3. If using dotenv manually, ensure dotenv.config() is called BEFORE creating ExellixSkillsClient\n`;
+        diagnostics += `  4. Set autoLoadDotenv: false if you want to control dotenv loading yourself\n`;
+        return diagnostics;
+    }
+    async runSkill(input) {
+        return this.executor.execute(input, async (key) => {
+            await this.registry.diagnose(key);
+        });
+    }
+    /**
+     * Preflight / authoring analysis for a {@link RunSkillRequest}.
+     * Simulates the gateway invoke payload and reviews it via FuncX
+     * (`ai-skills/analyze-gateway-invoke-request`). **Not chained into {@link runSkill}.**
+     */
+    async analyzeSkillRequest(input, options) {
+        return analyzeSkillRequestCore(this.catalox, input, {
+            ...options,
+            cataloxAppId: options?.cataloxAppId ?? this.cataloxAppId,
+            logger: this.logger,
+        });
+    }
+    getContentRegistry() {
+        return this.registry.getRegistry();
+    }
+    async testContentRegistryConnection() {
+        return this.registry.testConnection();
+    }
+    async diagnoseSkillContent(skillKey) {
+        return this.registry.diagnose(skillKey);
+    }
+    async listAvailableContent(options) {
+        return this.registry.listAvailable(options);
+    }
+    async listPublishedSkills(options) {
+        return this.registry.listPublishedSkills(options);
+    }
+    /**
+     * Lists every skill row in the Catalox `ai-skills` catalog (all statuses). For published-only discovery use {@link listPublishedSkills}.
+     */
+    async listCatalogSkills(options) {
+        return this.registry.listCatalogSkills(options);
+    }
+    /**
+     * Creates or updates a catalog row (metadata + optional markdown bodies). Requires Catalox write access.
+     */
+    async upsertSkillCatalogItem(input, options) {
+        return upsertSkillCatalogItemToCatalox(this.catalox, this.cataloxContext(), input, options);
+    }
+    /**
+     * Soft-deletes a skill: clears bodies and audit fields and sets `planned`. Requires Catalox write access.
+     */
+    async softDeleteSkillCatalogItem(skillKey) {
+        return softDeleteSkillCatalogItemFromCatalox(this.catalox, this.cataloxContext(), skillKey);
+    }
+    async runContentRegistryDiagnostics(verbose = false) {
+        return this.registry.runDiagnostics(verbose);
+    }
+    getGateway() {
+        return this.gateway;
+    }
+    getLogger() {
+        return this.logger;
+    }
+    getExecutor() {
+        return this.executor;
+    }
+    async shutdown() {
+        if (this.isShutdown)
+            return;
+        if (this.shutdownPromise)
+            return this.shutdownPromise;
+        this.shutdownPromise = (async () => {
+            this.logger.info("[AI-SKILLS] shutdown() started", {
+                ownsGateway: this.ownsGateway,
+                testMode: this.testMode,
+                debugKind: DebugLogAbstract.INTENT,
+            });
+            const registryHandle = this.registry?.getRegistry?.();
+            await this.safeCallClose(registryHandle, "close", "contentRegistry");
+            await this.safeCallClose(registryHandle, "disconnect", "contentRegistry");
+            await this.safeCallClose(registryHandle, "destroy", "contentRegistry");
+            await this.safeCallClose(registryHandle, "dispose", "contentRegistry");
+            await this.safeCallClose(registryHandle, "shutdown", "contentRegistry");
+            if (this.ownsGateway) {
+                await this.safeCallClose(this.gateway, "close", "gateway");
+                await this.safeCallClose(this.gateway, "disconnect", "gateway");
+                await this.safeCallClose(this.gateway, "destroy", "gateway");
+                await this.safeCallClose(this.gateway, "dispose", "gateway");
+                await this.safeCallClose(this.gateway, "shutdown", "gateway");
+                await this.safeCallClose(this.gateway?.activityManager, "close", "gateway.activityManager");
+                await this.safeCallClose(this.gateway?.activityManager, "shutdown", "gateway.activityManager");
+                await this.safeCallClose(this.gateway?.activityTracker, "close", "gateway.activityTracker");
+                await this.safeCallClose(this.gateway?.activityTracker, "shutdown", "gateway.activityTracker");
+                await this.safeCallClose(this.gateway?.logger, "close", "gateway.logger");
+                await this.safeCallClose(this.gateway?.logger, "shutdown", "gateway.logger");
+            }
+            this.isShutdown = true;
+            this.logger.info("[AI-SKILLS] shutdown() completed", { debugKind: DebugLogAbstract.EVENT });
+        })();
+        try {
+            await this.shutdownPromise;
+        }
+        finally {
+            this.shutdownPromise = null;
+        }
+    }
+    static diagnoseEnvironment() {
+        const providers = ["OPENAI_API_KEY", "GROK_API_KEY", "OPEN_ROUTER_KEY", "OPENROUTER_API_KEY"];
+        const cwd = process.cwd();
+        const envPath = path.join(cwd, ".env");
+        let diagnostics = `[AI-SKILLS] Environment Variable Diagnostics\n`;
+        diagnostics += `==========================================\n\n`;
+        diagnostics += `Current working directory: ${cwd}\n`;
+        diagnostics += `Expected .env file path: ${envPath}\n\n`;
+        try {
+            if (fs.existsSync(envPath)) {
+                const stats = fs.statSync(envPath);
+                diagnostics += `✓ .env file exists (${stats.size} bytes)\n\n`;
+            }
+            else {
+                diagnostics += `✗ .env file does NOT exist\n\n`;
+            }
+        }
+        catch (error) {
+            diagnostics += `✗ Could not check .env file: ${error.message}\n\n`;
+        }
+        diagnostics += `Provider Variables (at least one required):\n`;
+        let hasProvider = false;
+        for (const key of providers) {
+            const value = process.env[key];
+            if (value) {
+                diagnostics += `  ✓ ${key}: SET (${value.substring(0, 10)}...)\n`;
+                hasProvider = true;
+            }
+            else {
+                diagnostics += `  ✗ ${key}: NOT SET\n`;
+            }
+        }
+        if (!hasProvider) {
+            diagnostics += `  ⚠️  WARNING: No provider keys found!\n`;
+        }
+        diagnostics += `\nCatalox / Firestore (skill templates):\n`;
+        diagnostics += `  Set FIREBASE_PROJECT_ID + GOOGLE_SERVICE_ACCOUNT_BASE64 (or your own Admin credential wiring).\n`;
+        diagnostics += `  Provision catalog: npm run catalox:provision-ai-skills\n`;
+        diagnostics += `\n[TROUBLESHOOTING]\n`;
+        diagnostics += `  1. Ensure .env file is in the project root directory\n`;
+        diagnostics += `  2. Check .env file format: KEY=value (no spaces around =)\n`;
+        diagnostics += `  3. ExellixSkillsClient auto-loads .env by default (set autoLoadDotenv: false to disable)\n`;
+        return diagnostics;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/diagnostics/gateway-usage.d.ts

@@ -0,0 +1,3 @@
+import type { SkillTraceUsage } from "../types.js";
+export declare function usageFromGatewayMetadata(metadata: Record<string, any> | undefined | null): SkillTraceUsage;
+//# sourceMappingURL=gateway-usage.d.ts.map

package/dist/diagnostics/gateway-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-usage.d.ts","sourceRoot":"","sources":["../../src/diagnostics/gateway-usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAMnD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,GAAG,eAAe,CAuB1G"}

package/dist/diagnostics/gateway-usage.js

@@ -0,0 +1,26 @@
+function num(x, fallback = 0) {
+    return typeof x === "number" && !Number.isNaN(x) ? x : fallback;
+}
+export function usageFromGatewayMetadata(metadata) {
+    const md = metadata ?? {};
+    const tok = md.tokens ?? {};
+    const prompt = num(tok.prompt ?? tok.input);
+    const completion = num(tok.completion ?? tok.output);
+    const total = num(tok.total, prompt + completion);
+    const usageAny = md.usage ?? {};
+    const cachedPrompt = typeof usageAny.cachedPromptTokens === "number"
+        ? usageAny.cachedPromptTokens
+        : typeof usageAny.cached_tokens === "number"
+            ? usageAny.cached_tokens
+            : undefined;
+    const cachedTotal = typeof usageAny.cachedTotalTokens === "number" ? usageAny.cachedTotalTokens : undefined;
+    return {
+        maxTokensRequested: typeof md.maxTokensRequested === "number" ? md.maxTokensRequested : undefined,
+        tokensPrompt: prompt,
+        tokensCompletion: completion,
+        tokensTotal: total,
+        ...(cachedPrompt !== undefined ? { cachedTokensPrompt: cachedPrompt } : {}),
+        ...(cachedTotal !== undefined ? { cachedTokensTotal: cachedTotal } : {}),
+    };
+}
+//# sourceMappingURL=gateway-usage.js.map

package/dist/diagnostics/gateway-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-usage.js","sourceRoot":"","sources":["../../src/diagnostics/gateway-usage.ts"],"names":[],"mappings":"AAEA,SAAS,GAAG,CAAC,CAAU,EAAE,QAAQ,GAAG,CAAC;IACnC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAgD;IACvF,MAAM,EAAE,GAAG,QAAQ,IAAI,EAAE,CAAC;IAC1B,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;IAChC,MAAM,YAAY,GAChB,OAAO,QAAQ,CAAC,kBAAkB,KAAK,QAAQ;QAC7C,CAAC,CAAC,QAAQ,CAAC,kBAAkB;QAC7B,CAAC,CAAC,OAAO,QAAQ,CAAC,aAAa,KAAK,QAAQ;YAC1C,CAAC,CAAC,QAAQ,CAAC,aAAa;YACxB,CAAC,CAAC,SAAS,CAAC;IAClB,MAAM,WAAW,GACf,OAAO,QAAQ,CAAC,iBAAiB,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,OAAO;QACL,kBAAkB,EAAE,OAAO,EAAE,CAAC,kBAAkB,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS;QACjG,YAAY,EAAE,MAAM;QACpB,gBAAgB,EAAE,UAAU;QAC5B,WAAW,EAAE,KAAK;QAClB,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzE,CAAC;AACJ,CAAC"}

package/dist/diagnostics/map-gateway-trace.d.ts

@@ -0,0 +1,43 @@
+import type { RunSkillDiagnostics, SkillDiagnosticsInvokeRequest, SkillDiagnosticsTrace, SkillTraceUsage } from "../types.js";
+import { type SkillCostStatus } from "../utils/normalize-billing-metadata.js";
+export { usageFromGatewayMetadata } from "./gateway-usage.js";
+export declare const TRACE_ERROR_MESSAGE_MAX_CHARS = 4096;
+export declare const TRACE_RAW_PAYLOAD_MAX_CHARS = 32768;
+export declare function capTraceErrorMessage(message: string, max?: number): string;
+/**
+ * Best-effort metadata when `gateway.invoke` rejects: some gateway errors attach partial metadata
+ * on `metadata`, `response.metadata`, or `gatewayResponse.metadata`.
+ */
+export declare function metadataFromInvokeError(err: unknown): Record<string, any>;
+/** Same token/cost/model slice as trace top-level fields, derived from gateway `metadata`. */
+export declare function billingSnapshotFromGatewayMetadata(metadata: Record<string, any> | undefined | null): {
+    usage: SkillTraceUsage;
+    costUsd?: number;
+    costStatus?: SkillCostStatus;
+    modelUsed?: string;
+};
+export interface MapSkillGatewayTraceArgs {
+    invokeStartedAtMs: number;
+    invokeEndedAtMs: number;
+    /** Gateway `invoke` return value, when available. */
+    gatewayResponse?: Record<string, any> | null;
+    /** Same value sent as `aiRequestId` on the gateway request. */
+    aiRequestId: string;
+    /** Effective max tokens requested for this invoke (merged config / modelConfig). */
+    maxTokensRequested?: number;
+    /** Echo of caller invoke args (modelConfig, timeoutMs) for trace self-containment. */
+    invokeRequest?: SkillDiagnosticsInvokeRequest;
+    includeRawProviderPayload?: boolean;
+    step: {
+        phase: string;
+        type: string;
+        stepId: string;
+    };
+    invokeError?: unknown;
+}
+/**
+ * Maps a single gateway `invoke` result (or failure) into the stable {@link SkillDiagnosticsTrace} shape.
+ */
+export declare function mapGatewayInvokeToTrace(args: MapSkillGatewayTraceArgs): SkillDiagnosticsTrace;
+export declare function traceToDiagnostics(trace: SkillDiagnosticsTrace): RunSkillDiagnostics;
+//# sourceMappingURL=map-gateway-trace.d.ts.map

package/dist/diagnostics/map-gateway-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-gateway-trace.d.ts","sourceRoot":"","sources":["../../src/diagnostics/map-gateway-trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,qBAAqB,EAGrB,eAAe,EAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,wCAAwC,CAAC;AAGhD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAClD,eAAO,MAAM,2BAA2B,QAAQ,CAAC;AAEjD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAgC,GAAG,MAAM,CAGjG;AAUD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAazE;AAWD,8FAA8F;AAC9F,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,GAAG;IACpG,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAQA;AAsDD,MAAM,WAAW,wBAAwB;IACvC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAC7C,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sFAAsF;IACtF,aAAa,CAAC,EAAE,6BAA6B,CAAC;IAC9C,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA0FD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,wBAAwB,GAAG,qBAAqB,CAgF7F;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,mBAAmB,CAEpF"}