@exellix/ai-skills 5.8.0

package/dist/client/skill-executor.d.ts

@@ -0,0 +1,35 @@
+import { AIGateway } from "@x12i/ai-gateway";
+import { type Logxer } from "@x12i/logxer";
+import { BaseClient } from "./base-client.js";
+import { RunSkillRequest, RunSkillResponse } from "../types.js";
+import type { Catalox } from "@x12i/catalox";
+/**
+ * SkillExecutor
+ *
+ * WHY: This class specializes in the core "execution" phase of a skill.
+ * **`skillKey` → Catalox only:** templates are fetched with
+ * {@link fetchSkillTemplatesFromCatalox}; the gateway never performs skill-key
+ * or content-registry resolution for this path.
+ * **Gateway (`ai-gateway`):** receives inline template **text** on `invoke` and owns Rendrix rendering
+ * plus gateway-native response parsing.
+ */
+export type SkillExecutorContentOptions = {
+    catalox: Catalox;
+    cataloxAppId?: string;
+};
+export declare class SkillExecutor extends BaseClient {
+    private readonly contentOptions;
+    constructor(gateway: AIGateway, logger: Logxer, contentOptions: SkillExecutorContentOptions);
+    /**
+     * Executes a skill by sending the input to the AI Gateway.
+     *
+     * WHY: We need a centralized way to handle skill invocation that includes
+     * logging, timing, and automatic parsing of the output.
+     *
+     * @param input The request parameters for the skill.
+     * @param onNotFound Optional callback to run diagnostics if the skill content is not found.
+     * @returns A promise resolving to the structured skill response.
+     */
+    execute<TParsed = any>(skillRequest: RunSkillRequest, onNotFound?: (skillKey: string) => Promise<void>): Promise<RunSkillResponse<TParsed>>;
+}
+//# sourceMappingURL=skill-executor.d.ts.map

package/dist/client/skill-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-executor.d.ts","sourceRoot":"","sources":["../../src/client/skill-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAoB,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAQhE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAsB7C;;;;;;;;;GASG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,qBAAa,aAAc,SAAQ,UAAU;IAIrC,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAF/B,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,MAAM,EACG,cAAc,EAAE,2BAA2B;IAOhE;;;;;;;;;OASG;IACG,OAAO,CAAC,OAAO,GAAG,GAAG,EACvB,YAAY,EAAE,eAAe,EAC7B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACjD,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;CA4UxC"}

package/dist/client/skill-executor.js

@@ -0,0 +1,316 @@
+import { DebugLogAbstract } from "@x12i/logxer";
+import { BaseClient } from "./base-client.js";
+import { parseFlexMd } from "../utils/flex-md-parser.js";
+import { resolveActivityIdFromGatewayMetadata } from "../utils/resolve-activity-id.js";
+import { resolveIdentityFromGatewayResponse } from "../utils/resolve-identity.js";
+import { enrichIdentityWithAiSkillsLlmSnapshot } from "../utils/enrich-activix-identity.js";
+import { resolveGatewayJobAndTaskIds } from "../utils/resolve-gateway-job-task-ids.js";
+import { validateMandatoryActivixInvokeFields } from "../utils/validate-mandatory-activix-invoke-fields.js";
+import { buildSkillGatewayInvokePayload } from "./build-gateway-invoke-request.js";
+import { runtimeObjects } from "../runtime-objects.js";
+import { defaultAiSkillsCataloxContext, fetchSkillTemplatesFromCatalox, } from "../catalox/skill-templates.js";
+import { CataloxSkillNotFoundError, CataloxSkillNotRunnableError } from "../catalox/catalox-skill-errors.js";
+import { includeRawProviderPayload, isTraceExecutionMode } from "../diagnostics/trace-mode.js";
+import { billingSnapshotFromGatewayMetadata, mapGatewayInvokeToTrace, traceToDiagnostics, } from "../diagnostics/map-gateway-trace.js";
+import { enrichParsedForOutputContract } from "../utils/normalize-output-parsed.js";
+import { patchActivixActivityAfterSkill } from "../utils/patch-activix-activity-after-skill.js";
+import { SkillExecutionTraceError } from "../skill-execution-trace-error.js";
+import { effectiveModelConfigFromGatewayMetadata, gatewayExecutionSummaryFromInvokeResponse, } from "../utils/gateway-execution-summary.js";
+import { resolveAiEngineIdForRunSkill } from "../utils/resolve-run-skill-ai-engine.js";
+export class SkillExecutor extends BaseClient {
+    contentOptions;
+    constructor(gateway, logger, contentOptions) {
+        super(gateway, logger);
+        this.contentOptions = contentOptions;
+        if (!contentOptions?.catalox) {
+            throw new Error("[AI-SKILLS] SkillExecutor requires contentOptions.catalox (Catalox is the only template source).");
+        }
+    }
+    /**
+     * Executes a skill by sending the input to the AI Gateway.
+     *
+     * WHY: We need a centralized way to handle skill invocation that includes
+     * logging, timing, and automatic parsing of the output.
+     *
+     * @param input The request parameters for the skill.
+     * @param onNotFound Optional callback to run diagnostics if the skill content is not found.
+     * @returns A promise resolving to the structured skill response.
+     */
+    async execute(skillRequest, onNotFound) {
+        const startTime = Date.now();
+        const upstreamIdentity = skillRequest.identity;
+        const { jobId, taskId, missingJobId, missingTaskId } = resolveGatewayJobAndTaskIds({
+            jobId: skillRequest.jobId,
+            taskId: skillRequest.taskId,
+            identity: upstreamIdentity,
+        });
+        if (missingJobId) {
+            this.logger.warn("[AI-SKILLS] Missing jobId for gateway.invoke (Activix): upstream must supply non-empty `jobId` on the request or `identity.jobId`. Not generating one here.", { skillKey: skillRequest.skillKey, identity: "execute entry", debugKind: DebugLogAbstract.ANOMALY });
+        }
+        if (missingTaskId) {
+            this.logger.warn("[AI-SKILLS] Missing taskId for gateway.invoke (Activix): upstream must supply non-empty `taskId` on the request or `identity.taskId`. Not generating one here.", { skillKey: skillRequest.skillKey, identity: "execute entry", debugKind: DebugLogAbstract.ANOMALY });
+        }
+        validateMandatoryActivixInvokeFields(skillRequest);
+        const aiEngineId = resolveAiEngineIdForRunSkill(skillRequest);
+        if (runtimeObjects && jobId.length > 0) {
+            runtimeObjects.lastJobId = jobId;
+        }
+        this.logger.info("[AI-SKILLS] runSkill() entry", {
+            skillKey: skillRequest.skillKey,
+            aiEngineId,
+            jobId,
+            taskId,
+            agentId: skillRequest.agentId,
+            hasKnowledge: !!skillRequest.knowledge,
+            hasJobMemory: !!skillRequest.jobMemory,
+            hasTaskMemory: !!skillRequest.taskMemory,
+            identity: "execute entry",
+            debugKind: DebugLogAbstract.INTENT,
+        });
+        const traceMode = isTraceExecutionMode(skillRequest);
+        let response;
+        let gatewayRequest;
+        let gwStart = 0;
+        let gwEnd = 0;
+        let aiRequestIdForTrace = "";
+        const traceInvokeRequest = {
+            actionType: "skill",
+            actionRef: skillRequest.skillKey,
+            aiEngineId,
+            ...(skillRequest.modelConfig !== undefined ? { modelConfig: skillRequest.modelConfig } : {}),
+            ...(skillRequest.timeoutMs !== undefined ? { timeoutMs: skillRequest.timeoutMs } : {}),
+            ...(skillRequest.smartInput !== undefined ? { smartInput: skillRequest.smartInput } : {}),
+            ...(skillRequest.smartInputRenderOptions !== undefined
+                ? { smartInputRenderOptions: skillRequest.smartInputRenderOptions }
+                : {}),
+        };
+        const traceStepId = "skills:gateway";
+        try {
+            const cxCtx = defaultAiSkillsCataloxContext({
+                appId: this.contentOptions.cataloxAppId,
+            });
+            const { instructionsPayload, promptPayload } = await fetchSkillTemplatesFromCatalox(this.contentOptions.catalox, cxCtx, skillRequest.skillKey, { audit: false });
+            this.logger.info("[AI-SKILLS] Invoking ai-gateway", {
+                jobId,
+                taskId,
+                identity: "execute invoke",
+                skillKey: skillRequest.skillKey,
+                aiEngineId,
+                debugKind: DebugLogAbstract.INTENT,
+            });
+            this.logger.info("[AI-SKILLS] gateway.invoke() with inline Catalox template text", {
+                cataloxSkillKey: skillRequest.skillKey,
+                instructionsChars: String(instructionsPayload ?? "").length,
+                promptChars: String(promptPayload ?? "").length,
+                jobId,
+                taskId,
+                identity: "execute invoke",
+                debugKind: DebugLogAbstract.INTENT,
+            });
+            gatewayRequest = buildSkillGatewayInvokePayload({
+                skillRequest,
+                jobId,
+                taskId,
+                instructionsPayload,
+                promptPayload,
+            });
+            aiRequestIdForTrace = gatewayRequest.aiRequestId;
+            gwStart = Date.now();
+            response = await this.gateway.invoke(gatewayRequest);
+            gwEnd = Date.now();
+            const isSilentEcho = response.content?.trim() === skillRequest.skillKey ||
+                response.rawText?.trim() === skillRequest.skillKey;
+            if (isSilentEcho) {
+                this.logger.warn("[AI-SKILLS] Response body equals Catalox skillKey string (unexpected echo). Check provider behavior; this SDK sends full template text, not the key, as instructions/prompt.", {
+                    cataloxSkillKey: skillRequest.skillKey,
+                    content: response.content,
+                    debugKind: DebugLogAbstract.ANOMALY,
+                });
+                if (onNotFound) {
+                    await onNotFound(skillRequest.skillKey);
+                }
+            }
+        }
+        catch (invokeError) {
+            gwEnd = Date.now();
+            const isTemplateResolution = invokeError?.name === "TemplateResolutionError" ||
+                invokeError?.code === "TEMPLATE_RESOLUTION_ERROR" ||
+                invokeError?.code === "TEMPLATE_VARIABLE_MISSING";
+            const isNotFoundError = invokeError.message?.includes("not found") ||
+                invokeError.message?.includes("content") ||
+                invokeError.message?.includes("instruction");
+            const isCataloxSkillMiss = invokeError instanceof CataloxSkillNotFoundError ||
+                invokeError instanceof CataloxSkillNotRunnableError;
+            if (onNotFound && (isNotFoundError || isCataloxSkillMiss) && !isTemplateResolution) {
+                await onNotFound(skillRequest.skillKey);
+            }
+            if (traceMode) {
+                const traceStarted = gwStart > 0 ? gwStart : startTime;
+                const trace = mapGatewayInvokeToTrace({
+                    invokeStartedAtMs: traceStarted,
+                    invokeEndedAtMs: gwEnd,
+                    gatewayResponse: response ?? null,
+                    aiRequestId: aiRequestIdForTrace || `skills:pending:${jobId}:${taskId}`,
+                    maxTokensRequested: skillRequest.modelConfig?.maxTokens,
+                    invokeRequest: traceInvokeRequest,
+                    includeRawProviderPayload: includeRawProviderPayload(skillRequest),
+                    step: { phase: "main", type: "runSkill", stepId: traceStepId },
+                    invokeError,
+                });
+                throw new SkillExecutionTraceError(invokeError?.message ?? "Skill execution failed", traceToDiagnostics(trace), { cause: invokeError });
+            }
+            throw invokeError;
+        }
+        const invokeTime = Date.now() - startTime;
+        const gatewayResponse = response;
+        const parsedFromGateway = gatewayResponse.parsedContent ||
+            gatewayResponse.parsed ||
+            gatewayResponse.content?.parsedOutput ||
+            gatewayResponse.content?.parsed;
+        const parsed = parsedFromGateway ? JSON.parse(JSON.stringify(parsedFromGateway)) : {};
+        this.logger.info("[AI-SKILLS] Gateway response received", {
+            jobId,
+            taskId,
+            latencyMs: invokeTime,
+            status: response.metadata?.status,
+            hasContent: !!response.content,
+            hasParsed: !!parsed && Object.keys(parsed).length > 0,
+            instructionVersion: response.metadata?.instructionVersion,
+            identity: "execute invoke",
+            debugKind: DebugLogAbstract.EVENT,
+        });
+        let flexMd;
+        if (gatewayResponse.flexMd) {
+            flexMd = gatewayResponse.flexMd;
+        }
+        else if (gatewayResponse.content?.flexMd) {
+            flexMd = gatewayResponse.content.flexMd;
+        }
+        else {
+            if (Object.keys(parsed).length > 0) {
+                flexMd = {
+                    frame: response.metadata?.frame || "unknown",
+                    payloads: parsed,
+                };
+            }
+            else {
+                this.logger.warn("[AI-SKILLS] Gateway did not provide parsed response, falling back to manual parsing", {
+                    jobId,
+                    taskId,
+                    debugKind: DebugLogAbstract.ANOMALY,
+                });
+                const parsedFlexMd = await parseFlexMd(response.content || response.rawText || "");
+                flexMd = parsedFlexMd;
+                if (!parsedFromGateway) {
+                    Object.assign(parsed, parsedFlexMd.payloads);
+                }
+            }
+        }
+        Object.assign(parsed, enrichParsedForOutputContract({
+            parsed,
+            flexMdPayloads: flexMd.payloads,
+            rawText: response.rawText || response.content || "",
+            outputContract: skillRequest.outputContract,
+        }));
+        this.logger.info("[AI-SKILLS] Using gateway parsed response", {
+            jobId,
+            taskId,
+            frame: flexMd.frame,
+            payloadKeys: Object.keys(flexMd.payloads),
+            parsedKeys: Object.keys(parsed),
+            identity: "execute flexmd",
+            debugKind: DebugLogAbstract.EVENT,
+        });
+        const totalTime = Date.now() - startTime;
+        this.logger.info("[AI-SKILLS] runSkill() exit", {
+            jobId,
+            taskId,
+            totalTimeMs: totalTime,
+            identity: "execute exit",
+            debugKind: DebugLogAbstract.EVENT,
+        });
+        const md = response.metadata;
+        const billing = billingSnapshotFromGatewayMetadata(md);
+        const execSummary = gatewayExecutionSummaryFromInvokeResponse(response);
+        const effectiveCfg = effectiveModelConfigFromGatewayMetadata(md);
+        const resolvedModelUsed = execSummary.modelUsed ?? billing.modelUsed;
+        if (execSummary.effectiveMaxTokens !== undefined) {
+            billing.usage.maxTokensRequested = execSummary.effectiveMaxTokens;
+        }
+        else if (skillRequest.modelConfig?.maxTokens !== undefined && billing.usage.maxTokensRequested === undefined) {
+            billing.usage.maxTokensRequested = skillRequest.modelConfig.maxTokens;
+        }
+        const returnValue = {
+            skillKey: skillRequest.skillKey,
+            rawText: response.rawText || response.content || "",
+            flexMd: {
+                frame: flexMd.frame,
+                payloads: flexMd.payloads,
+            },
+            parsed: parsed,
+            identity: undefined,
+            metadata: {
+                instructionVersion: response.metadata?.instructionVersion,
+                activityId: resolveActivityIdFromGatewayMetadata(response.metadata, { jobId }),
+                usage: billing.usage,
+                ...(billing.costUsd !== undefined ? { costUsd: billing.costUsd } : {}),
+                ...(billing.costStatus !== undefined ? { costStatus: billing.costStatus } : {}),
+                ...(resolvedModelUsed !== undefined ? { modelUsed: resolvedModelUsed } : {}),
+                ...(execSummary.provider !== undefined ? { provider: execSummary.provider } : {}),
+                ...(execSummary.effectiveMaxTokens !== undefined ? { effectiveMaxTokens: execSummary.effectiveMaxTokens } : {}),
+                ...(execSummary.region !== undefined ? { region: execSummary.region } : {}),
+                ...(skillRequest.modelConfig !== undefined ? { requestedModelConfig: skillRequest.modelConfig } : {}),
+                ...(effectiveCfg !== undefined ? { effectiveModelConfig: effectiveCfg } : {}),
+                ...(skillRequest.timeoutMs !== undefined ? { invokeExec: { timeoutMs: skillRequest.timeoutMs } } : {}),
+            },
+        };
+        const downstreamIdentity = resolveIdentityFromGatewayResponse(response);
+        if (downstreamIdentity) {
+            enrichIdentityWithAiSkillsLlmSnapshot(downstreamIdentity, {
+                usage: billing.usage,
+                ...(billing.costUsd !== undefined ? { costUsd: billing.costUsd } : {}),
+                ...(billing.costStatus !== undefined ? { costStatus: billing.costStatus } : {}),
+                ...(resolvedModelUsed !== undefined ? { modelUsed: resolvedModelUsed } : {}),
+            });
+            returnValue.identity = downstreamIdentity;
+        }
+        else {
+            delete returnValue.identity;
+        }
+        const activityId = returnValue.metadata.activityId;
+        if (activityId) {
+            await patchActivixActivityAfterSkill({
+                gateway: this.gateway,
+                logger: this.logger,
+                activityId,
+                billing: {
+                    ...billing,
+                    ...(resolvedModelUsed !== undefined ? { modelUsed: resolvedModelUsed } : {}),
+                },
+                parsed: parsed,
+                activixContext: {
+                    ...(execSummary.provider !== undefined ? { provider: execSummary.provider } : {}),
+                    ...(execSummary.region !== undefined ? { region: execSummary.region } : {}),
+                    ...(effectiveCfg !== undefined ? { effectiveModelConfig: effectiveCfg } : {}),
+                },
+            });
+        }
+        if (traceMode) {
+            const trace = mapGatewayInvokeToTrace({
+                invokeStartedAtMs: gwStart,
+                invokeEndedAtMs: gwEnd,
+                gatewayResponse: response,
+                aiRequestId: aiRequestIdForTrace,
+                maxTokensRequested: execSummary.effectiveMaxTokens ?? skillRequest.modelConfig?.maxTokens,
+                invokeRequest: traceInvokeRequest,
+                includeRawProviderPayload: includeRawProviderPayload(skillRequest),
+                step: { phase: "main", type: "runSkill", stepId: traceStepId },
+            });
+            const diag = traceToDiagnostics(trace);
+            returnValue.diagnostics = diag;
+            returnValue.debugTrace = trace;
+        }
+        return returnValue;
+    }
+}
+//# sourceMappingURL=skill-executor.js.map

package/dist/client/skill-executor.js.map

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

package/dist/client/task-executor.d.ts

@@ -0,0 +1,21 @@
+import { BaseClient } from "./base-client";
+import { SkillExecutor } from "./skill-executor";
+import { RunTaskRequest, RunSkillResponse } from "../types";
+/**
+ * TaskExecutor
+ *
+ * WHY: This class handles the "orchestration" of tasks which can have
+ * different execution strategies (ExecutionType). It currently supports
+ * 'direct' execution which simply delegates to the SkillExecutor.
+ */
+export declare class TaskExecutor extends BaseClient {
+    private skillExecutor;
+    constructor(gateway: any, logger: any, skillExecutor: SkillExecutor);
+    /**
+     * Executes a task based on its execution type.
+     *
+     * WHY: Centralized entry point for task-based execution.
+     */
+    execute<TParsed = any>(taskRequest: RunTaskRequest, onNotFound?: (skillKey: string) => Promise<void>): Promise<RunSkillResponse<TParsed>>;
+}
+//# sourceMappingURL=task-executor.d.ts.map

package/dist/client/task-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-executor.d.ts","sourceRoot":"","sources":["../../src/client/task-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAiB,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE3E;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,UAAU;IACxC,OAAO,CAAC,aAAa,CAAgB;gBAEzB,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,aAAa;IAKnE;;;;OAIG;IACG,OAAO,CAAC,OAAO,GAAG,GAAG,EACvB,WAAW,EAAE,cAAc,EAC3B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACjD,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;CA6BxC"}

package/dist/client/task-executor.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskExecutor = void 0;
+const base_client_1 = require("./base-client");
+const types_1 = require("../types");
+/**
+ * TaskExecutor
+ *
+ * WHY: This class handles the "orchestration" of tasks which can have
+ * different execution strategies (ExecutionType). It currently supports
+ * 'direct' execution which simply delegates to the SkillExecutor.
+ */
+class TaskExecutor extends base_client_1.BaseClient {
+    constructor(gateway, logger, skillExecutor) {
+        super(gateway, logger);
+        this.skillExecutor = skillExecutor;
+    }
+    /**
+     * Executes a task based on its execution type.
+     *
+     * WHY: Centralized entry point for task-based execution.
+     */
+    async execute(taskRequest, onNotFound) {
+        const { executionType, taskMemory, jobMemory, ...rest } = taskRequest;
+        this.logger.info("[AI-SKILLS] runTask() entry", {
+            skillKey: taskRequest.skillKey,
+            executionType,
+            jobId: taskRequest.jobId,
+            identity: "runTask execute"
+        });
+        switch (executionType) {
+            case types_1.ExecutionType.DIRECT:
+                this.logger.info("[AI-SKILLS] Executing direct task (pass-through to skill)", {
+                    skillKey: taskRequest.skillKey,
+                    identity: "runTask direct"
+                });
+                return this.skillExecutor.execute({
+                    ...rest,
+                    taskMemory,
+                    jobMemory
+                }, onNotFound);
+            default:
+                const errorMsg = `[AI-SKILLS] Unsupported execution type: ${executionType}`;
+                this.logger.error(errorMsg, { identity: "runTask execute" });
+                throw new Error(errorMsg);
+        }
+    }
+}
+exports.TaskExecutor = TaskExecutor;
+//# sourceMappingURL=task-executor.js.map

package/dist/client/task-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-executor.js","sourceRoot":"","sources":["../../src/client/task-executor.ts"],"names":[],"mappings":";;;AAAA,+CAA2C;AAE3C,oCAA2E;AAE3E;;;;;;GAMG;AACH,MAAa,YAAa,SAAQ,wBAAU;IAGxC,YAAY,OAAY,EAAE,MAAW,EAAE,aAA4B;QAC/D,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CACT,WAA2B,EAC3B,UAAgD;QAEhD,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,WAAW,CAAC;QAEtE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE;YAC5C,QAAQ,EAAE,WAAW,CAAC,QAAQ;YAC9B,aAAa;YACb,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,QAAQ,EAAE,iBAAiB;SAC9B,CAAC,CAAC;QAEH,QAAQ,aAAa,EAAE,CAAC;YACpB,KAAK,qBAAa,CAAC,MAAM;gBACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2DAA2D,EAAE;oBAC1E,QAAQ,EAAE,WAAW,CAAC,QAAQ;oBAC9B,QAAQ,EAAE,gBAAgB;iBAC7B,CAAC,CAAC;gBAEH,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAU;oBACvC,GAAG,IAAI;oBACP,UAAU;oBACV,SAAS;iBACZ,EAAE,UAAU,CAAC,CAAC;YAEnB;gBACI,MAAM,QAAQ,GAAG,2CAA2C,aAAa,EAAE,CAAC;gBAC5E,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CAAC;gBAC7D,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC;IACL,CAAC;CACJ;AA7CD,oCA6CC"}

package/dist/client.d.ts

@@ -0,0 +1,116 @@
+import { AIGateway } from "@x12i/ai-gateway";
+import { type Logxer } from "@x12i/logxer";
+import { ExellixSkillsClientOptions, RunSkillRequest, RunSkillResponse } from "./types.js";
+import { type SkillContentPart, type SkillTemplatesPresentation, type SkillTemplatePresentationPatch, type UpdateSkillTemplatesFromPresentationOptions, type UpsertSkillCatalogItemInput, type UpsertSkillCatalogItemOptions, type ExtractedTemplateInputs, type ModifySkillContentResult, type CreateSubSkillInput, type CreateSubSkillResult, type DeleteSubSkillResult } from "./catalox/skill-template-catalog-mutations.js";
+import { SkillExecutor } from "./client/skill-executor.js";
+import { RegistryManager } from "./client/registry-manager.js";
+import type { AnalyzeSkillRequestOptions, AnalyzeSkillRequestResult } from "./analysis/types.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 declare class ExellixSkillsClient {
+    private gateway;
+    private logger;
+    private readonly ownsGateway;
+    private readonly testMode;
+    private isShutdown;
+    private shutdownPromise;
+    private executor;
+    private registry;
+    private readonly catalox;
+    private readonly cataloxAppId?;
+    constructor(options: ExellixSkillsClientOptions);
+    private cataloxContext;
+    /**
+     * Skill templates as presentation markdown (Catalox read). Requires read access to the `ai-skills` catalog.
+     */
+    getSkillTemplatesForPresentation(skillKey: string, opts?: {
+        includeAudit?: boolean;
+    }): Promise<SkillTemplatesPresentation>;
+    /**
+     * Updates skill template bodies from editor markdown (lossless storage normalization + Catalox upsert).
+     * Requires write access (e.g. god-mode or app binding with write).
+     */
+    updateSkillTemplatesFromPresentation(skillKey: string, patch: SkillTemplatePresentationPatch, opts?: UpdateSkillTemplatesFromPresentationOptions): Promise<void>;
+    /**
+     * Expected template tokens (`{{name}}`) from raw stored instructions/prompt/audit fields.
+     */
+    getSkillTemplateInputs(skillKey: string): Promise<ExtractedTemplateInputs>;
+    /**
+     * Skill template bodies as `{ role, content }[]` (presentation markdown). Four entries in stable order.
+     */
+    getSkillContent(skillKey: string): Promise<SkillContentPart[]>;
+    /**
+     * Unique `{{token}}` names across instructions, prompt, and audit bodies (presentation strings).
+     */
+    getSkillTokens(skillKey: string): Promise<string[]>;
+    /**
+     * Partial update of template bodies by role. Returns `{ success }` (errors are not thrown).
+     */
+    modifySkillContent(skillKey: string, parts: SkillContentPart[], opts?: UpdateSkillTemplatesFromPresentationOptions): Promise<ModifySkillContentResult>;
+    /**
+     * Duplicate a skill under a new key with optional overrides; sets `parentSkillKey` on the new row.
+     */
+    createSubSkill(input: CreateSubSkillInput): Promise<CreateSubSkillResult>;
+    /**
+     * Remove a sub-skill row only when `parentSkillKey` is set (base catalog skills cannot be deleted here).
+     */
+    deleteSubSkill(subSkillKey: string): Promise<DeleteSubSkillResult>;
+    private safeCallClose;
+    private validateProviderEnv;
+    private getEnvDiagnostics;
+    runSkill<TParsed = any>(input: RunSkillRequest): Promise<RunSkillResponse<TParsed>>;
+    /**
+     * 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}.**
+     */
+    analyzeSkillRequest(input: RunSkillRequest, options?: AnalyzeSkillRequestOptions): Promise<AnalyzeSkillRequestResult>;
+    getContentRegistry(): undefined;
+    testContentRegistryConnection(): Promise<Awaited<ReturnType<RegistryManager["testConnection"]>>>;
+    diagnoseSkillContent(skillKey: string): Promise<Awaited<ReturnType<RegistryManager["diagnose"]>>>;
+    listAvailableContent(options?: any): Promise<Awaited<ReturnType<RegistryManager["listAvailable"]>>>;
+    listPublishedSkills(options?: {
+        limit?: number;
+    }): Promise<Awaited<ReturnType<RegistryManager["listPublishedSkills"]>>>;
+    /**
+     * Lists every skill row in the Catalox `ai-skills` catalog (all statuses). For published-only discovery use {@link listPublishedSkills}.
+     */
+    listCatalogSkills(options?: Parameters<RegistryManager["listCatalogSkills"]>[0]): Promise<Awaited<ReturnType<RegistryManager["listCatalogSkills"]>>>;
+    /**
+     * Creates or updates a catalog row (metadata + optional markdown bodies). Requires Catalox write access.
+     */
+    upsertSkillCatalogItem(input: UpsertSkillCatalogItemInput, options?: UpsertSkillCatalogItemOptions): Promise<void>;
+    /**
+     * Soft-deletes a skill: clears bodies and audit fields and sets `planned`. Requires Catalox write access.
+     */
+    softDeleteSkillCatalogItem(skillKey: string): Promise<void>;
+    runContentRegistryDiagnostics(verbose?: boolean): Promise<Awaited<ReturnType<RegistryManager["runDiagnostics"]>>>;
+    getGateway(): AIGateway;
+    getLogger(): Logxer;
+    getExecutor(): SkillExecutor;
+    shutdown(): Promise<void>;
+    static diagnoseEnvironment(): string;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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