@exellix/ai-skills 5.8.0

package/dist/catalox/skill-template-markdown.js.map

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

package/dist/catalox/skill-templates.d.ts

@@ -0,0 +1,72 @@
+import type { Catalox, CataloxContext } from "@x12i/catalox";
+export type SkillCatalogStatus = "planned" | "draft" | "published";
+export type FetchSkillTemplatesMode = "primary" | "audit";
+/**
+ * Catalox native **`ai-skills`** item `data` fields this package reads for execution (see
+ * `scripts/provision-ai-skills-catalog.ts` and `buildAiSkillsCatalogDescriptor` in `ai-skills-catalog.ts`).
+ *
+ * - **`skillKey`** — stored natural id slice (e.g. `professional-answer`); same value Catalox uses as item id
+ *   with `itemIdField: "skillKey"`. Callers pass `skills/<id>` to `runSkill`; use {@link catalogItemIdFromSkillKey} to match.
+ * - **`status`** — `planned` | `draft` | `published`. Invoke requires `draft` or `published` with non-empty bodies.
+ * - **`instructionsText`** / **`promptText`** — primary template bodies (Firestore strings).
+ * - **`auditInstructionsText`** / **`auditPromptText`** — optional; when auditing, used with fallback to primary.
+ * - **`parentSkillKey`** — optional; short catalog id of the skill this row was duplicated from (sub-skills only).
+ */
+export type AiSkillsCatalogItemDataFields = {
+    skillKey?: string;
+    status?: SkillCatalogStatus;
+    title?: string;
+    description?: string;
+    isLocal?: boolean;
+    instructionsText?: string;
+    promptText?: string;
+    auditInstructionsText?: string;
+    auditPromptText?: string;
+    parentSkillKey?: string;
+};
+/**
+ * Catalox natural item id: short key without `skills/` prefix.
+ */
+export declare function catalogItemIdFromSkillKey(skillKey: string): string;
+export type RunnableTemplateBodiesFromCatalogData = {
+    status: SkillCatalogStatus;
+    /** `data.skillKey` when present (short id form written by provision). */
+    recordSkillKey?: string;
+    instructionsRaw: string;
+    promptRaw: string;
+};
+/**
+ * Single extraction of runnable template strings from one Catalox **`ai-skills`** row’s `data`
+ * (same property names provision and the catalog descriptor use).
+ *
+ * @param skillKeyForErrors Canonical `skills/...` key (or equivalent) for error messages.
+ * @param itemId Natural catalog item id (short slice) for error messages.
+ */
+export declare function extractRunnableTemplateBodiesFromAiSkillsCatalogData(skillKeyForErrors: string, itemId: string, data: Record<string, unknown>, options?: {
+    audit?: boolean;
+}): RunnableTemplateBodiesFromCatalogData;
+/**
+ * Loads instruction/prompt bodies from the native `ai-skills` catalog for gateway inline invoke.
+ *
+ * This is the **only** place skill keys are interpreted for execution bodies: map
+ * `skillKey` → catalog item, read stored text, then return strings for
+ * `gateway.invoke({ instructions, prompt })`. The gateway treats them as **template
+ * text** (see {@link ensureGatewayTreatsAsTemplateText}); it does **not** resolve
+ * `skillKey` as a registry path.
+ *
+ * @throws CataloxSkillNotFoundError | CataloxSkillNotRunnableError
+ */
+export declare function fetchSkillTemplatesFromCatalox(catalox: Catalox, context: CataloxContext, skillKey: string, options?: {
+    audit?: boolean;
+}): Promise<{
+    instructionsPayload: string;
+    promptPayload: string;
+    status: SkillCatalogStatus;
+}>;
+/**
+ * Default Catalox app context for skill reads (override `appId` for multi-tenant).
+ * For one-off admin tools (create catalog, bind before bindings exist), pass **`superAdmin: true`**
+ * in overrides — see **`@x12i/catalox`** `CataloxContext` (Catalox 3.3+ / 4.x).
+ */
+export declare function defaultAiSkillsCataloxContext(overrides?: Partial<CataloxContext>): CataloxContext;
+//# sourceMappingURL=skill-templates.d.ts.map

package/dist/catalox/skill-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-templates.d.ts","sourceRoot":"","sources":["../../src/catalox/skill-templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAK7D,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;AAEnE,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,MAAM,MAAM,6BAA6B,GAAG;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElE;AASD,MAAM,MAAM,qCAAqC,GAAG;IAChD,MAAM,EAAE,kBAAkB,CAAC;IAC3B,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,oDAAoD,CAChE,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,qCAAqC,CA+BvC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,8BAA8B,CAChD,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,OAAO,CAAC;IAAE,mBAAmB,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,CAAC,CAiB7F;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAGjG"}

package/dist/catalox/skill-templates.js

@@ -0,0 +1,80 @@
+import { canonicalSkillKey, ensureGatewayTreatsAsTemplateText } from "./skill-gateway-template-utils.js";
+import { AI_SKILLS_APP_ID, AI_SKILLS_CATALOG_ID } from "./ai-skills-catalog.js";
+import { CataloxSkillNotFoundError, CataloxSkillNotRunnableError } from "./catalox-skill-errors.js";
+/**
+ * Catalox natural item id: short key without `skills/` prefix.
+ */
+export function catalogItemIdFromSkillKey(skillKey) {
+    return canonicalSkillKey(skillKey).replace(/^skills\//, "");
+}
+function pickText(primary, fallback) {
+    const a = typeof primary === "string" ? primary.trim() : "";
+    if (a.length > 0)
+        return a;
+    const b = typeof fallback === "string" ? fallback.trim() : "";
+    return b;
+}
+/**
+ * Single extraction of runnable template strings from one Catalox **`ai-skills`** row’s `data`
+ * (same property names provision and the catalog descriptor use).
+ *
+ * @param skillKeyForErrors Canonical `skills/...` key (or equivalent) for error messages.
+ * @param itemId Natural catalog item id (short slice) for error messages.
+ */
+export function extractRunnableTemplateBodiesFromAiSkillsCatalogData(skillKeyForErrors, itemId, data, options = {}) {
+    const status = data.status || "planned";
+    const audit = options.audit === true;
+    const insRaw = audit
+        ? pickText(data.auditInstructionsText, data.instructionsText)
+        : pickText(data.instructionsText, undefined);
+    const prRaw = audit ? pickText(data.auditPromptText, data.promptText) : pickText(data.promptText, undefined);
+    const recordSkillKey = typeof data.skillKey === "string" && data.skillKey.trim().length > 0 ? data.skillKey.trim() : undefined;
+    if (status === "planned") {
+        throw new CataloxSkillNotRunnableError(skillKeyForErrors, `Skill "${itemId}" is planned (incomplete templates). Add instructionsText/promptText in Catalox and re-provision.`);
+    }
+    if (status !== "draft" && status !== "published") {
+        throw new CataloxSkillNotRunnableError(skillKeyForErrors, `Skill "${itemId}" has invalid status: ${String(status)}`);
+    }
+    if (!insRaw || !prRaw) {
+        throw new CataloxSkillNotRunnableError(skillKeyForErrors, `Skill "${itemId}" is ${status} but instructions or prompt is empty in Catalox.`);
+    }
+    return { status, recordSkillKey, instructionsRaw: insRaw, promptRaw: prRaw };
+}
+/**
+ * Loads instruction/prompt bodies from the native `ai-skills` catalog for gateway inline invoke.
+ *
+ * This is the **only** place skill keys are interpreted for execution bodies: map
+ * `skillKey` → catalog item, read stored text, then return strings for
+ * `gateway.invoke({ instructions, prompt })`. The gateway treats them as **template
+ * text** (see {@link ensureGatewayTreatsAsTemplateText}); it does **not** resolve
+ * `skillKey` as a registry path.
+ *
+ * @throws CataloxSkillNotFoundError | CataloxSkillNotRunnableError
+ */
+export async function fetchSkillTemplatesFromCatalox(catalox, context, skillKey, options = {}) {
+    const itemId = catalogItemIdFromSkillKey(skillKey);
+    const res = await catalox.getCatalogItem(context, AI_SKILLS_CATALOG_ID, itemId);
+    if (res.outcome === "not_found") {
+        throw new CataloxSkillNotFoundError(skillKey, itemId);
+    }
+    if (res.outcome === "mapping_blocked") {
+        throw new Error(`[AI-SKILLS] Catalox mapping blocked for skill ${itemId}`);
+    }
+    const data = (res.item.data ?? {});
+    const extracted = extractRunnableTemplateBodiesFromAiSkillsCatalogData(skillKey, itemId, data, options);
+    return {
+        instructionsPayload: ensureGatewayTreatsAsTemplateText(extracted.instructionsRaw),
+        promptPayload: ensureGatewayTreatsAsTemplateText(extracted.promptRaw),
+        status: extracted.status,
+    };
+}
+/**
+ * Default Catalox app context for skill reads (override `appId` for multi-tenant).
+ * For one-off admin tools (create catalog, bind before bindings exist), pass **`superAdmin: true`**
+ * in overrides — see **`@x12i/catalox`** `CataloxContext` (Catalox 3.3+ / 4.x).
+ */
+export function defaultAiSkillsCataloxContext(overrides) {
+    const { appId, ...rest } = overrides ?? {};
+    return { appId: appId ?? AI_SKILLS_APP_ID, ...rest };
+}
+//# sourceMappingURL=skill-templates.js.map

package/dist/catalox/skill-templates.js.map

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

package/dist/client/audit-manager.d.ts

@@ -0,0 +1,27 @@
+import type { AIGateway } from "@x12i/ai-gateway";
+import { type Logxer } from "@x12i/logxer";
+import { BaseClient } from "./base-client.js";
+import { RunAuditInput, RunAuditOutput } from "../types.js";
+import type { Catalox } from "@x12i/catalox";
+export type AuditManagerContentOptions = {
+    catalox: Catalox;
+    cataloxAppId?: string;
+};
+/**
+ * AuditManager
+ *
+ * WHY: This class handles the "Verification" or "Auditing" logic.
+ * After a skill runs, we often want another LLM pass to check if the
+ * results meet certain quality or safety criteria. This manager
+ * encapsulates that specific interaction.
+ *
+ * Audit templates are loaded by **catalog skill key** via Catalox
+ * (`fetchSkillTemplatesFromCatalox`); **`AIGateway` is not used to resolve keys**.
+ */
+export declare class AuditManager extends BaseClient {
+    private readonly contentOptions;
+    constructor(gateway: AIGateway, logger: Logxer, contentOptions: AuditManagerContentOptions);
+    audit(input: RunAuditInput): Promise<RunAuditOutput>;
+    private mapAuditPayloads;
+}
+//# sourceMappingURL=audit-manager.d.ts.map

package/dist/client/audit-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-manager.d.ts","sourceRoot":"","sources":["../../src/client/audit-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAoB,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAe,MAAM,aAAa,CAAC;AASzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAO7C,MAAM,MAAM,0BAA0B,GAAG;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,qBAAa,YAAa,SAAQ,UAAU;IAIpC,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAF/B,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,MAAM,EACG,cAAc,EAAE,0BAA0B;IAQzD,KAAK,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAuQ1D,OAAO,CAAC,gBAAgB;CAW3B"}

package/dist/client/audit-manager.js

@@ -0,0 +1,260 @@
+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 { mergeNoRedundancy } from "nx-helpers";
+import { randomUUID } from "crypto";
+import { validateSessionIdAgreement } from "../utils/validate-session-id.js";
+import { enrichActivixIdentityForGateway } from "../utils/enrich-activix-identity.js";
+import { resolveGatewayJobAndTaskIds } from "../utils/resolve-gateway-job-task-ids.js";
+import { defaultAiSkillsCataloxContext, fetchSkillTemplatesFromCatalox } from "../catalox/skill-templates.js";
+import { runtimeObjects } from "../runtime-objects.js";
+import { includeRawProviderPayload, isTraceExecutionMode } from "../diagnostics/trace-mode.js";
+import { mapGatewayInvokeToTrace, traceToDiagnostics } from "../diagnostics/map-gateway-trace.js";
+import { SkillExecutionTraceError } from "../skill-execution-trace-error.js";
+/**
+ * AuditManager
+ *
+ * WHY: This class handles the "Verification" or "Auditing" logic.
+ * After a skill runs, we often want another LLM pass to check if the
+ * results meet certain quality or safety criteria. This manager
+ * encapsulates that specific interaction.
+ *
+ * Audit templates are loaded by **catalog skill key** via Catalox
+ * (`fetchSkillTemplatesFromCatalox`); **`AIGateway` is not used to resolve keys**.
+ */
+export class AuditManager extends BaseClient {
+    contentOptions;
+    constructor(gateway, logger, contentOptions) {
+        super(gateway, logger);
+        this.contentOptions = contentOptions;
+        if (!contentOptions?.catalox) {
+            throw new Error("[AI-SKILLS] AuditManager requires contentOptions.catalox.");
+        }
+    }
+    async audit(input) {
+        const startTime = Date.now();
+        const catalogSkillKeyForAuditTemplates = input.auditInstructionOverrideKey || input.targetSkillKey;
+        const { jobId, taskId, missingJobId, missingTaskId } = resolveGatewayJobAndTaskIds({
+            jobId: input.jobId,
+            taskId: input.taskId,
+            identity: input.identity,
+        });
+        if (missingJobId) {
+            this.logger.warn("[AI-SKILLS] Missing jobId for gateway.invoke (Activix audit): upstream must supply non-empty `jobId` or `identity.jobId`. Not generating one here.", { targetSkillKey: input.targetSkillKey, identity: "runAudit", debugKind: DebugLogAbstract.ANOMALY });
+        }
+        if (missingTaskId) {
+            this.logger.warn("[AI-SKILLS] Missing taskId for gateway.invoke (Activix audit): upstream must supply non-empty `taskId` or `identity.taskId`. Not generating one here.", { targetSkillKey: input.targetSkillKey, identity: "runAudit", debugKind: DebugLogAbstract.ANOMALY });
+        }
+        if (runtimeObjects && jobId.length > 0) {
+            runtimeObjects.lastJobId = jobId;
+        }
+        this.logger.info("[AI-SKILLS] runAudit() entry", {
+            targetSkillKey: input.targetSkillKey,
+            catalogSkillKeyForAuditTemplates,
+            jobId,
+            taskId,
+            agentId: input.agentId,
+            identity: "runAudit",
+            debugKind: DebugLogAbstract.INTENT,
+        });
+        const auditInputValue = `
+RESPONSE TO AUDIT:
+${input.responseFlexMd || ""}
+
+OBJECTIVE:
+${JSON.stringify(input.objective, null, 2)}
+
+CONTEXT:
+${JSON.stringify(input.context, null, 2)}
+      `;
+        const workingMemory = mergeNoRedundancy(input.knowledge || {}, mergeNoRedundancy(input.jobMemory || {}, mergeNoRedundancy(input.taskMemory || {}, {
+            ...input.variables,
+            variant: "audit",
+            input: auditInputValue,
+        })));
+        const traceMode = isTraceExecutionMode(input);
+        let gwStart = 0;
+        let gwEnd = 0;
+        let aiRequestIdForTrace = "";
+        let response;
+        let gatewayRequest;
+        try {
+            const cxCtx = defaultAiSkillsCataloxContext({ appId: this.contentOptions.cataloxAppId });
+            const { instructionsPayload, promptPayload } = await fetchSkillTemplatesFromCatalox(this.contentOptions.catalox, cxCtx, catalogSkillKeyForAuditTemplates, { audit: true });
+            gatewayRequest = {
+                aiRequestId: randomUUID(),
+                jobId,
+                taskId,
+                agentId: input.agentId || "xeonox-auditor",
+                instructions: instructionsPayload,
+                prompt: promptPayload,
+                workingMemory,
+                skillId: input.skillId,
+                masterSkillId: input.masterSkillId,
+                masterSkillActivityId: input.masterSkillActivityId,
+                graphId: input.graphId,
+                nodeId: input.nodeId,
+                coreSkillId: input.coreSkillId,
+                request: undefined,
+                mode: "sync",
+                exec: {
+                    timeoutMs: input.timeoutMs,
+                },
+            };
+            if (input.prevNodeId || input.previousNodeId) {
+                gatewayRequest.prevNodeId = input.prevNodeId || input.previousNodeId;
+            }
+            if (input.modelConfig) {
+                gatewayRequest.modelConfig = input.modelConfig;
+            }
+            if (input.templateRenderOptions) {
+                gatewayRequest.templateRenderOptions = input.templateRenderOptions;
+            }
+            if (input.templateTokens) {
+                gatewayRequest.templateTokens = input.templateTokens;
+            }
+            const upstreamIdentity = input.identity;
+            const upstreamIdentityObj = upstreamIdentity && typeof upstreamIdentity === "object" && !Array.isArray(upstreamIdentity)
+                ? { ...upstreamIdentity }
+                : {};
+            enrichActivixIdentityForGateway(upstreamIdentityObj, {
+                skillId: input.skillId,
+            });
+            /** Gateway v9+ reads `jobId` / `taskId` from `identity` only; top-level fields are legacy. */
+            gatewayRequest.identity = {
+                ...upstreamIdentityObj,
+                jobId,
+                taskId,
+            };
+            const upstreamSessionId = input.sessionId;
+            validateSessionIdAgreement(upstreamSessionId, gatewayRequest.identity.sessionId);
+            if (upstreamSessionId !== undefined &&
+                upstreamSessionId !== null &&
+                String(upstreamSessionId).trim() !== "") {
+                gatewayRequest.sessionId = String(upstreamSessionId);
+            }
+            aiRequestIdForTrace = gatewayRequest.aiRequestId;
+            gwStart = Date.now();
+            response = await this.gateway.invoke(gatewayRequest);
+            gwEnd = Date.now();
+        }
+        catch (invokeError) {
+            gwEnd = Date.now();
+            if (traceMode) {
+                const trace = mapGatewayInvokeToTrace({
+                    invokeStartedAtMs: gwStart > 0 ? gwStart : startTime,
+                    invokeEndedAtMs: gwEnd,
+                    gatewayResponse: response ?? null,
+                    aiRequestId: aiRequestIdForTrace || `skills:audit:pending:${jobId}:${taskId}`,
+                    maxTokensRequested: input.modelConfig?.maxTokens,
+                    includeRawProviderPayload: includeRawProviderPayload(input),
+                    step: { phase: "audit", type: "runAudit", stepId: "skills:audit" },
+                    invokeError,
+                });
+                throw new SkillExecutionTraceError(invokeError?.message ?? "Audit gateway invoke failed", traceToDiagnostics(trace), { cause: invokeError });
+            }
+            throw invokeError;
+        }
+        const invokeTime = Date.now() - startTime;
+        const gatewayResponse = response;
+        const parsed = gatewayResponse.parsed ||
+            gatewayResponse.content?.parsedOutput ||
+            gatewayResponse.content?.parsed ||
+            {};
+        this.logger.info("[AI-SKILLS] Audit gateway response received", {
+            jobId,
+            taskId,
+            latencyMs: invokeTime,
+            status: response.metadata?.status,
+            hasParsed: !!parsed && Object.keys(parsed).length > 0,
+            identity: "runAudit",
+            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: "audit-result",
+                    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;
+                Object.assign(parsed, parsedFlexMd.payloads);
+            }
+        }
+        const parsedResult = this.mapAuditPayloads(flexMd.payloads);
+        this.logger.info("[AI-SKILLS] Audit result mapped", {
+            jobId,
+            taskId,
+            decision: parsedResult.decision,
+            score: parsedResult.score,
+            identity: "runAudit",
+            debugKind: DebugLogAbstract.EVENT,
+        });
+        const totalTime = Date.now() - startTime;
+        this.logger.info("[AI-SKILLS] runAudit() exit", {
+            jobId,
+            taskId,
+            totalTimeMs: totalTime,
+            identity: "runAudit",
+            debugKind: DebugLogAbstract.EVENT,
+        });
+        const auditIdentity = resolveIdentityFromGatewayResponse(response);
+        const base = {
+            targetSkillKey: input.targetSkillKey,
+            auditTemplatesSourceSkillKey: catalogSkillKeyForAuditTemplates,
+            rawText: response.rawText || response.content || "",
+            flexMd: {
+                frame: "audit-result",
+                payloads: flexMd.payloads,
+            },
+            parsed: parsedResult,
+            metadata: {
+                activityId: resolveActivityIdFromGatewayMetadata(response.metadata, { jobId, fallbackSuffix: "audit" }),
+            },
+        };
+        if (auditIdentity) {
+            base.identity = auditIdentity;
+        }
+        if (traceMode) {
+            const trace = mapGatewayInvokeToTrace({
+                invokeStartedAtMs: gwStart,
+                invokeEndedAtMs: gwEnd,
+                gatewayResponse: response,
+                aiRequestId: aiRequestIdForTrace,
+                maxTokensRequested: input.modelConfig?.maxTokens,
+                includeRawProviderPayload: includeRawProviderPayload(input),
+                step: { phase: "audit", type: "runAudit", stepId: "skills:audit" },
+            });
+            const diag = traceToDiagnostics(trace);
+            base.diagnostics = diag;
+            base.debugTrace = trace;
+        }
+        return base;
+    }
+    mapAuditPayloads(payloads) {
+        return {
+            decision: (payloads.decision?.toLowerCase().includes("passed") ? "passed" : "failed"),
+            score: parseInt(payloads.score) || 0,
+            theGood: payloads.theGood || "",
+            theBad: payloads.theBad || "",
+            takeaways: payloads.takeaways || "",
+        };
+    }
+}
+//# sourceMappingURL=audit-manager.js.map

package/dist/client/audit-manager.js.map

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

package/dist/client/base-client.d.ts

@@ -0,0 +1,19 @@
+import { AIGateway } from "@x12i/ai-gateway";
+import type { Logxer } from "@x12i/logxer";
+/**
+ * BaseClient
+ *
+ * WHY: This base class provides a shared foundation for all specialized managers
+ * (Registry, Executor). It ensures they all have access to the same
+ * AIGateway and Logxer instances without duplicating initialization logic.
+ */
+export declare abstract class BaseClient {
+    protected gateway: AIGateway;
+    protected logger: Logxer;
+    /**
+     * @param gateway The shared AI Gateway instance for making LLM and Registry calls.
+     * @param logger The shared Logger instance for consistent logging across the client.
+     */
+    constructor(gateway: AIGateway, logger: Logxer);
+}
+//# sourceMappingURL=base-client.d.ts.map

package/dist/client/base-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-client.d.ts","sourceRoot":"","sources":["../../src/client/base-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;;;GAMG;AACH,8BAAsB,UAAU;IAMxB,SAAS,CAAC,OAAO,EAAE,SAAS;IAC5B,SAAS,CAAC,MAAM,EAAE,MAAM;IAN5B;;;OAGG;gBAEW,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,MAAM;CAE/B"}

package/dist/client/base-client.js

@@ -0,0 +1,20 @@
+/**
+ * BaseClient
+ *
+ * WHY: This base class provides a shared foundation for all specialized managers
+ * (Registry, Executor). It ensures they all have access to the same
+ * AIGateway and Logxer instances without duplicating initialization logic.
+ */
+export class BaseClient {
+    gateway;
+    logger;
+    /**
+     * @param gateway The shared AI Gateway instance for making LLM and Registry calls.
+     * @param logger The shared Logger instance for consistent logging across the client.
+     */
+    constructor(gateway, logger) {
+        this.gateway = gateway;
+        this.logger = logger;
+    }
+}
+//# sourceMappingURL=base-client.js.map

package/dist/client/base-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-client.js","sourceRoot":"","sources":["../../src/client/base-client.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,OAAgB,UAAU;IAMd;IACA;IANd;;;OAGG;IACH,YACc,OAAkB,EAClB,MAAc;QADd,YAAO,GAAP,OAAO,CAAW;QAClB,WAAM,GAAN,MAAM,CAAQ;IACxB,CAAC;CACR"}

package/dist/client/build-gateway-invoke-request.d.ts

@@ -0,0 +1,32 @@
+import type { ActivityIdentity, AIInvokeRequest } from "@x12i/ai-gateway";
+import type { GatewayInvokeDiagnosticsOptions, GatewayTemplateTokens, RunSkillRequest } from "../types.js";
+/**
+ * Full `invoke()` payload for this SDK: gateway `AIInvokeRequest` plus optional fields we forward
+ * that may not appear on published gateway types yet (`prevNodeId`, `templateTokens`, `exec`, …).
+ */
+export type SkillGatewayInvokePayload = AIInvokeRequest & {
+    prevNodeId?: string;
+    templateTokens?: GatewayTemplateTokens;
+    mode?: string;
+    exec?: {
+        timeoutMs?: number;
+    };
+};
+export declare function buildWorkingMemory(skillRequest: RunSkillRequest): Record<string, unknown>;
+export declare function buildInvokeIdentity(skillRequest: RunSkillRequest, jobId: string, taskId: string): ActivityIdentity & Record<string, unknown>;
+/**
+ * Resolves `@x12i/ai-gateway` `diagnostics` for this invoke.
+ * When SDK trace mode is on, merges gateway defaults unless {@link RunSkillRequest.gatewayDiagnostics} overrides.
+ */
+export declare function resolveGatewayDiagnostics(skillRequest: RunSkillRequest): GatewayInvokeDiagnosticsOptions | undefined;
+export type BuildSkillGatewayInvokeParams = {
+    skillRequest: RunSkillRequest;
+    jobId: string;
+    taskId: string;
+    instructionsPayload: string;
+    promptPayload: string;
+    /** Defaults to `randomUUID()`. */
+    aiRequestId?: string;
+};
+export declare function buildSkillGatewayInvokePayload(params: BuildSkillGatewayInvokeParams): SkillGatewayInvokePayload;
+//# sourceMappingURL=build-gateway-invoke-request.d.ts.map

package/dist/client/build-gateway-invoke-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-gateway-invoke-request.d.ts","sourceRoot":"","sources":["../../src/client/build-gateway-invoke-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAG1E,OAAO,KAAK,EAAE,+BAA+B,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAM3G;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,eAAe,GAAG;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjC,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzF;AAED,wBAAgB,mBAAmB,CAC/B,YAAY,EAAE,eAAe,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACf,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsB5C;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,eAAe,GAAG,+BAA+B,GAAG,SAAS,CAmBpH;AAED,MAAM,MAAM,6BAA6B,GAAG;IACxC,YAAY,EAAE,eAAe,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,6BAA6B,GAAG,yBAAyB,CAgF/G"}