@exellix/ai-skills 5.8.0

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

@@ -0,0 +1,243 @@
+import { gatewayInvokeRejectionFromErrorChain } from "../utils/gateway-invoke-rejection.js";
+import { normalizeSkillBillingFromGatewayMetadata, } from "../utils/normalize-billing-metadata.js";
+import { usageFromGatewayMetadata } from "./gateway-usage.js";
+export { usageFromGatewayMetadata } from "./gateway-usage.js";
+export const TRACE_ERROR_MESSAGE_MAX_CHARS = 4096;
+export const TRACE_RAW_PAYLOAD_MAX_CHARS = 32768;
+export function capTraceErrorMessage(message, max = TRACE_ERROR_MESSAGE_MAX_CHARS) {
+    if (message.length <= max)
+        return message;
+    return `${message.slice(0, max)}…`;
+}
+function iso(ms) {
+    return new Date(ms).toISOString();
+}
+function num(x, fallback = 0) {
+    return typeof x === "number" && !Number.isNaN(x) ? x : fallback;
+}
+/**
+ * Best-effort metadata when `gateway.invoke` rejects: some gateway errors attach partial metadata
+ * on `metadata`, `response.metadata`, or `gatewayResponse.metadata`.
+ */
+export function metadataFromInvokeError(err) {
+    if (err === null || err === undefined)
+        return {};
+    const e = err;
+    const candidates = [
+        e.metadata,
+        e.response?.metadata,
+        e.gatewayResponse?.metadata,
+        typeof e.cause === "object" && e.cause ? e.cause.metadata : undefined,
+    ];
+    for (const c of candidates) {
+        if (c && typeof c === "object" && !Array.isArray(c))
+            return c;
+    }
+    return {};
+}
+function mergeInvokeMetadata(gatewayResponse, invokeError) {
+    const fromErr = metadataFromInvokeError(invokeError);
+    const fromResp = (gatewayResponse?.metadata ?? {});
+    return { ...fromErr, ...fromResp };
+}
+/** Same token/cost/model slice as trace top-level fields, derived from gateway `metadata`. */
+export function billingSnapshotFromGatewayMetadata(metadata) {
+    const normalized = normalizeSkillBillingFromGatewayMetadata(metadata);
+    return {
+        usage: normalized.usage,
+        ...(normalized.costUsd !== undefined ? { costUsd: normalized.costUsd } : {}),
+        ...(normalized.costStatus !== undefined ? { costStatus: normalized.costStatus } : {}),
+        ...(normalized.modelUsed !== undefined ? { modelUsed: normalized.modelUsed } : {}),
+    };
+}
+function routingFromGatewayMetadata(metadata, aiRequestId) {
+    const md = metadata ?? {};
+    const retries = md.retries;
+    const retryCount = typeof retries?.count === "number"
+        ? retries.count
+        : Array.isArray(retries?.attempts)
+            ? retries.attempts.length
+            : 0;
+    const provider = typeof md.provider === "string" && md.provider.length > 0 ? md.provider : "unknown";
+    const requestIds = {
+        gatewayAiRequestId: aiRequestId,
+        ...(typeof md.routerRequestId === "string" ? { routerRequestId: md.routerRequestId } : {}),
+        ...(typeof md.providerActivityRequestId === "string"
+            ? { providerActivityRequestId: md.providerActivityRequestId }
+            : {}),
+    };
+    return {
+        provider,
+        ...(typeof md.region === "string" ? { region: md.region } : {}),
+        retryCount,
+        ...(typeof md.fallbackCount === "number" ? { fallbackCount: md.fallbackCount } : {}),
+        requestIds,
+    };
+}
+function errorEnvelope(err) {
+    if (err instanceof Error) {
+        return { name: err.name || "Error", message: capTraceErrorMessage(err.message || "") };
+    }
+    const message = capTraceErrorMessage(String(err ?? "unknown"));
+    return { name: "Error", message };
+}
+function compactInvokeRequest(ir) {
+    if (!ir)
+        return undefined;
+    if (ir.modelConfig === undefined &&
+        ir.timeoutMs === undefined &&
+        ir.actionType === undefined &&
+        ir.actionRef === undefined &&
+        ir.smartInput === undefined &&
+        ir.smartInputRenderOptions === undefined) {
+        return undefined;
+    }
+    return ir;
+}
+function rawPayloadFromMetadata(metadata, include) {
+    if (!include)
+        return undefined;
+    const pn = metadata.providerNormalization;
+    const candidate = pn?.normalizedRequest ?? pn?.normalizedMessages ?? pn?.normalizedConfig ?? metadata["ai-activities-raw-response"];
+    let s;
+    try {
+        s = typeof candidate === "string" ? candidate : JSON.stringify(candidate ?? "");
+    }
+    catch {
+        s = "[unserializable]";
+    }
+    if (s.length > TRACE_RAW_PAYLOAD_MAX_CHARS) {
+        return `${s.slice(0, TRACE_RAW_PAYLOAD_MAX_CHARS)}…`;
+    }
+    return s;
+}
+function buildRetryAttempts(baseStep, invokeStartedAtMs, invokeEndedAtMs, metadata, routing, usage, modelUsed, costUsd, costStatus, ok, invokeError) {
+    const retries = metadata.retries;
+    const attemptsIn = retries?.attempts;
+    if (!Array.isArray(attemptsIn) || attemptsIn.length === 0) {
+        return [];
+    }
+    const out = [];
+    for (let i = 0; i < attemptsIn.length; i++) {
+        const r = attemptsIn[i];
+        const ts = typeof r.timestamp === "number" ? r.timestamp : invokeStartedAtMs;
+        const delayMs = typeof r.delayMs === "number" ? r.delayMs : 0;
+        const ended = ts + delayMs;
+        out.push({
+            step: {
+                phase: baseStep.phase,
+                type: "gatewayRetry",
+                stepId: `${baseStep.stepId}:retry:${typeof r.attempt === "number" ? r.attempt : i + 1}`,
+            },
+            timing: {
+                startedAt: iso(ts),
+                endedAt: iso(ended),
+                durationMs: Math.max(0, ended - ts),
+            },
+            routing: {
+                ...routing,
+                retryCount: i,
+            },
+            usage: {
+                tokensPrompt: 0,
+                tokensCompletion: 0,
+                tokensTotal: 0,
+            },
+            modelUsed: "",
+            ok: false,
+            error: {
+                name: typeof r.errorType === "string" ? r.errorType : "RetryAttempt",
+                message: capTraceErrorMessage(typeof r.error === "string" ? r.error : JSON.stringify(r.error ?? "")),
+            },
+        });
+    }
+    out.push({
+        step: baseStep,
+        timing: {
+            startedAt: iso(invokeStartedAtMs),
+            endedAt: iso(invokeEndedAtMs),
+            durationMs: Math.max(0, invokeEndedAtMs - invokeStartedAtMs),
+        },
+        routing,
+        usage,
+        ...(costUsd !== undefined ? { costUsd } : {}),
+        ...(costStatus !== undefined ? { costStatus } : {}),
+        modelUsed,
+        ok,
+        ...(invokeError !== undefined ? { error: errorEnvelope(invokeError) } : {}),
+    });
+    return out;
+}
+/**
+ * Maps a single gateway `invoke` result (or failure) into the stable {@link SkillDiagnosticsTrace} shape.
+ */
+export function mapGatewayInvokeToTrace(args) {
+    const md = mergeInvokeMetadata(args.gatewayResponse, args.invokeError);
+    const usage = usageFromGatewayMetadata(md);
+    if (args.maxTokensRequested !== undefined) {
+        usage.maxTokensRequested = args.maxTokensRequested;
+    }
+    const routing = routingFromGatewayMetadata(md, args.aiRequestId);
+    const modelUsed = typeof md.modelUsed === "string" && md.modelUsed.trim().length > 0
+        ? md.modelUsed.trim()
+        : typeof md.model === "string"
+            ? md.model
+            : "";
+    const billing = normalizeSkillBillingFromGatewayMetadata(md, usage);
+    const costUsd = billing.costUsd;
+    const costStatus = billing.costStatus;
+    const invokeError = args.invokeError;
+    const ok = invokeError === undefined;
+    let attempts;
+    const retrySlice = buildRetryAttempts(args.step, args.invokeStartedAtMs, args.invokeEndedAtMs, md, routing, usage, modelUsed, costUsd, costStatus, ok, invokeError);
+    if (retrySlice.length > 0) {
+        attempts = retrySlice;
+    }
+    else {
+        attempts = [
+            {
+                step: args.step,
+                timing: {
+                    startedAt: iso(args.invokeStartedAtMs),
+                    endedAt: iso(args.invokeEndedAtMs),
+                    durationMs: Math.max(0, args.invokeEndedAtMs - args.invokeStartedAtMs),
+                },
+                routing,
+                usage,
+                ...(costUsd !== undefined ? { costUsd } : {}),
+                ...(costStatus !== undefined ? { costStatus } : {}),
+                modelUsed,
+                ok,
+                ...(invokeError !== undefined ? { error: errorEnvelope(invokeError) } : {}),
+            },
+        ];
+    }
+    const rawPayload = rawPayloadFromMetadata(md, args.includeRawProviderPayload === true);
+    const invokeRequest = compactInvokeRequest(args.invokeRequest);
+    const invokeRejection = !ok ? gatewayInvokeRejectionFromErrorChain(invokeError) : undefined;
+    const trace = {
+        step: args.step,
+        timing: {
+            startedAt: iso(args.invokeStartedAtMs),
+            endedAt: iso(args.invokeEndedAtMs),
+            durationMs: Math.max(0, args.invokeEndedAtMs - args.invokeStartedAtMs),
+        },
+        routing,
+        usage,
+        ...(costUsd !== undefined ? { costUsd } : {}),
+        ...(costStatus !== undefined ? { costStatus } : {}),
+        modelUsed,
+        ok,
+        ...(invokeError !== undefined ? { error: errorEnvelope(invokeError) } : {}),
+        attempts,
+        tasks: attempts,
+        ...(rawPayload !== undefined ? { rawProviderPayload: rawPayload } : {}),
+        ...(invokeRequest !== undefined ? { invokeRequest } : {}),
+        ...(invokeRejection !== undefined ? { invokeRejection } : {}),
+    };
+    return trace;
+}
+export function traceToDiagnostics(trace) {
+    return { trace };
+}
+//# sourceMappingURL=map-gateway-trace.js.map

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

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

package/dist/diagnostics/trace-mode.d.ts

@@ -0,0 +1,9 @@
+import type { ExecutionMode, SkillDiagnosticsInputOptions } from "../types.js";
+export interface TraceModeCarrier {
+    executionMode?: ExecutionMode;
+    diagnostics?: SkillDiagnosticsInputOptions;
+}
+/** True when structured trace payloads should be produced (extra serialization allowed). */
+export declare function isTraceExecutionMode(req: TraceModeCarrier): boolean;
+export declare function includeRawProviderPayload(req: TraceModeCarrier): boolean;
+//# sourceMappingURL=trace-mode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace-mode.d.ts","sourceRoot":"","sources":["../../src/diagnostics/trace-mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAE/E,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,WAAW,CAAC,EAAE,4BAA4B,CAAC;CAC5C;AAED,4FAA4F;AAC5F,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAEnE;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAExE"}

package/dist/diagnostics/trace-mode.js

@@ -0,0 +1,8 @@
+/** True when structured trace payloads should be produced (extra serialization allowed). */
+export function isTraceExecutionMode(req) {
+    return req.executionMode === "trace" || req.diagnostics?.includeDebugTrace === true;
+}
+export function includeRawProviderPayload(req) {
+    return isTraceExecutionMode(req) && req.diagnostics?.includeRawProviderPayload === true;
+}
+//# sourceMappingURL=trace-mode.js.map

package/dist/diagnostics/trace-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-mode.js","sourceRoot":"","sources":["../../src/diagnostics/trace-mode.ts"],"names":[],"mappings":"AAOA,4FAA4F;AAC5F,MAAM,UAAU,oBAAoB,CAAC,GAAqB;IACxD,OAAO,GAAG,CAAC,aAAa,KAAK,OAAO,IAAI,GAAG,CAAC,WAAW,EAAE,iBAAiB,KAAK,IAAI,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,GAAqB;IAC7D,OAAO,oBAAoB,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE,yBAAyB,KAAK,IAAI,CAAC;AAC1F,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+export type { GatewayInvokeRejectionMetadata } from "@x12i/ai-gateway";
+export { attachGatewayInvokeRejectionMetadata, buildInvokeRejectionMetadata, pickRequestIdsFromRouterLike, tryExtractRouterLikePayloadFromErrorChain, } from "@x12i/ai-gateway";
+export { gatewayInvokeRejectionFromErrorChain } from "./utils/gateway-invoke-rejection.js";
+export { ExellixSkillsClient } from "./client.js";
+export { SkillExecutor } from "./client/skill-executor.js";
+export { BaseClient } from "./client/base-client.js";
+export { runtimeObjects } from "./runtime-objects.js";
+export { SkillExecutionTraceError } from "./skill-execution-trace-error.js";
+export { includeRawProviderPayload, isTraceExecutionMode, } from "./diagnostics/trace-mode.js";
+export { billingSnapshotFromGatewayMetadata, mapGatewayInvokeToTrace, metadataFromInvokeError, traceToDiagnostics, } from "./diagnostics/map-gateway-trace.js";
+export { enrichParsedForOutputContract, resolveOutputContractFields, parseMarkdownSectionsToFields, markdownHeadingToFieldKey, } from "./utils/normalize-output-parsed.js";
+export type { OutputContract } from "./utils/normalize-output-parsed.js";
+export { normalizeSkillBillingFromGatewayMetadata, hasMeaningfulUsage, } from "./utils/normalize-billing-metadata.js";
+export { patchActivixActivityAfterSkill } from "./utils/patch-activix-activity-after-skill.js";
+export { buildActivixBillingPatch } from "./utils/build-activix-billing-patch.js";
+export type { ActivixBillingPatch, ActivixBillingPatchContext, ActivixRecordCostStatus, } from "./utils/build-activix-billing-patch.js";
+export * from "./types.js";
+export * from "./catalox/index.js";
+export type { JobHistory, TaskHistory } from "@x12i/execution-memory-manager";
+export { AI_SKILLS_LLM_IDENTITY_KEY, enrichIdentityWithAiSkillsLlmSnapshot, } from "./utils/enrich-activix-identity.js";
+export type { AiSkillsLlmIdentitySlice } from "./utils/enrich-activix-identity.js";
+export { contextToMarkdownString } from "./parsers/context-parser.js";
+export { runSkillRequestFromFlat } from "./utils/run-skill-request.js";
+export type { RunSkillRequestFlat } from "./utils/run-skill-request.js";
+export { resolveAiEngineIdForRunSkill } from "./utils/resolve-run-skill-ai-engine.js";
+export { effectiveModelConfigFromGatewayMetadata, gatewayExecutionSummaryFromInvokeResponse, } from "./utils/gateway-execution-summary.js";
+export type { GatewayExecutionSummary } from "./utils/gateway-execution-summary.js";
+export { buildAiSkillsLogxerLoggingConfig, readAiSkillsLibraryVersion } from "./utils/exellix-skills-logxer-defaults.js";
+export { analyzeSkillRequest } from "./analysis/analyze-skill-request.js";
+export { buildSkillRequestAnalysisPacket } from "./analysis/build-skill-request-analysis-packet.js";
+export { FUNCX_ANALYZE_GATEWAY_INVOKE_REQUEST_ID, FUNCX_MIN_VERSION_FOR_ANALYZE_GATEWAY, } from "./analysis/constants.js";
+export { formatSkillRequestAnalysisMarkdown } from "./analysis/format-skill-request-analysis-markdown.js";
+export type { AnalyzeGatewayInvokeRequestPacket, AnalyzeSkillRequestOptions, AnalyzeSkillRequestResult, BuildSkillRequestAnalysisPacketResult, SkillRequestAnalysisCategory, SkillRequestAnalysisFinding, SkillRequestAnalysisReport, SkillRequestAnalysisSeverity, SkillRequestAnalysisVerdict, } from "./analysis/types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,8BAA8B,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EACH,oCAAoC,EACpC,4BAA4B,EAC5B,4BAA4B,EAC5B,yCAAyC,GAC5C,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oCAAoC,EAAE,MAAM,qCAAqC,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EACH,yBAAyB,EACzB,oBAAoB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACH,kCAAkC,EAClC,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,GACrB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACH,6BAA6B,EAC7B,2BAA2B,EAC3B,6BAA6B,EAC7B,yBAAyB,GAC5B,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EACH,wCAAwC,EACxC,kBAAkB,GACrB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,8BAA8B,EAAE,MAAM,+CAA+C,CAAC;AAC/F,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAClF,YAAY,EACR,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,GAC1B,MAAM,wCAAwC,CAAC;AAChD,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AAEnC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAG9E,OAAO,EACH,0BAA0B,EAC1B,qCAAqC,GACxC,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,EACH,uCAAuC,EACvC,yCAAyC,GAC5C,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,gCAAgC,EAAE,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AACzH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,+BAA+B,EAAE,MAAM,mDAAmD,CAAC;AACpG,OAAO,EACH,uCAAuC,EACvC,qCAAqC,GACxC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kCAAkC,EAAE,MAAM,sDAAsD,CAAC;AAC1G,YAAY,EACR,iCAAiC,EACjC,0BAA0B,EAC1B,yBAAyB,EACzB,qCAAqC,EACrC,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,GAC9B,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+export { attachGatewayInvokeRejectionMetadata, buildInvokeRejectionMetadata, pickRequestIdsFromRouterLike, tryExtractRouterLikePayloadFromErrorChain, } from "@x12i/ai-gateway";
+export { gatewayInvokeRejectionFromErrorChain } from "./utils/gateway-invoke-rejection.js";
+export { ExellixSkillsClient } from "./client.js";
+export { SkillExecutor } from "./client/skill-executor.js";
+export { BaseClient } from "./client/base-client.js";
+export { runtimeObjects } from "./runtime-objects.js";
+export { SkillExecutionTraceError } from "./skill-execution-trace-error.js";
+export { includeRawProviderPayload, isTraceExecutionMode, } from "./diagnostics/trace-mode.js";
+export { billingSnapshotFromGatewayMetadata, mapGatewayInvokeToTrace, metadataFromInvokeError, traceToDiagnostics, } from "./diagnostics/map-gateway-trace.js";
+export { enrichParsedForOutputContract, resolveOutputContractFields, parseMarkdownSectionsToFields, markdownHeadingToFieldKey, } from "./utils/normalize-output-parsed.js";
+export { normalizeSkillBillingFromGatewayMetadata, hasMeaningfulUsage, } from "./utils/normalize-billing-metadata.js";
+export { patchActivixActivityAfterSkill } from "./utils/patch-activix-activity-after-skill.js";
+export { buildActivixBillingPatch } from "./utils/build-activix-billing-patch.js";
+export * from "./types.js";
+export * from "./catalox/index.js";
+// Primitive used by @exellix/ai-tasks (and others) to coerce context values to Markdown strings.
+// string → pass-through; object → anyToMarkdownString (nx-helpers).
+export { AI_SKILLS_LLM_IDENTITY_KEY, enrichIdentityWithAiSkillsLlmSnapshot, } from "./utils/enrich-activix-identity.js";
+export { contextToMarkdownString } from "./parsers/context-parser.js";
+export { runSkillRequestFromFlat } from "./utils/run-skill-request.js";
+export { resolveAiEngineIdForRunSkill } from "./utils/resolve-run-skill-ai-engine.js";
+export { effectiveModelConfigFromGatewayMetadata, gatewayExecutionSummaryFromInvokeResponse, } from "./utils/gateway-execution-summary.js";
+export { buildAiSkillsLogxerLoggingConfig, readAiSkillsLibraryVersion } from "./utils/exellix-skills-logxer-defaults.js";
+export { analyzeSkillRequest } from "./analysis/analyze-skill-request.js";
+export { buildSkillRequestAnalysisPacket } from "./analysis/build-skill-request-analysis-packet.js";
+export { FUNCX_ANALYZE_GATEWAY_INVOKE_REQUEST_ID, FUNCX_MIN_VERSION_FOR_ANALYZE_GATEWAY, } from "./analysis/constants.js";
+export { formatSkillRequestAnalysisMarkdown } from "./analysis/format-skill-request-analysis-markdown.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACH,oCAAoC,EACpC,4BAA4B,EAC5B,4BAA4B,EAC5B,yCAAyC,GAC5C,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oCAAoC,EAAE,MAAM,qCAAqC,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EACH,yBAAyB,EACzB,oBAAoB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACH,kCAAkC,EAClC,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,GACrB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACH,6BAA6B,EAC7B,2BAA2B,EAC3B,6BAA6B,EAC7B,yBAAyB,GAC5B,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACH,wCAAwC,EACxC,kBAAkB,GACrB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,8BAA8B,EAAE,MAAM,+CAA+C,CAAC;AAC/F,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAMlF,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AAGnC,iGAAiG;AACjG,oEAAoE;AACpE,OAAO,EACH,0BAA0B,EAC1B,qCAAqC,GACxC,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,OAAO,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,EACH,uCAAuC,EACvC,yCAAyC,GAC5C,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,gCAAgC,EAAE,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AACzH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,+BAA+B,EAAE,MAAM,mDAAmD,CAAC;AACpG,OAAO,EACH,uCAAuC,EACvC,qCAAqC,GACxC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kCAAkC,EAAE,MAAM,sDAAsD,CAAC"}

package/dist/metadata.d.ts

@@ -0,0 +1,7 @@
+import { SkillMetadata } from "./types";
+export declare const XEONOX_SKILLS_METADATA: SkillMetadata[];
+export declare const GENERIC_AUDIT_METADATA: {
+    outputType: string;
+    requiredPayloads: string[];
+};
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,eAAO,MAAM,sBAAsB,EAAE,aAAa,EAwDjD,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;CAGlC,CAAC"}

package/dist/metadata.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GENERIC_AUDIT_METADATA = exports.XEONOX_SKILLS_METADATA = void 0;
+exports.XEONOX_SKILLS_METADATA = [
+    {
+        id: "professional-answer",
+        version: "1.0.0",
+        type: "primary",
+        outputType: "professional-answer",
+        requiredVariables: [],
+        optionalVariables: [
+            "orgName",
+            "tone",
+            "audience",
+            "timeFrameType",
+            "start",
+            "end"
+        ],
+        outputSchema: {
+            type: "object",
+            properties: {
+                shortAnswer: { type: "string" },
+                fullAnswer: { type: "string" },
+                assumptions: { type: "string" },
+                unknowns: { type: "string" },
+                evidence: { type: "string" }
+            },
+            required: [
+                "shortAnswer",
+                "fullAnswer",
+                "assumptions",
+                "unknowns",
+                "evidence"
+            ]
+        }
+    },
+    {
+        id: "professional-decision",
+        version: "1.0.0",
+        type: "primary",
+        outputType: "professional-decision",
+        requiredVariables: [],
+        optionalVariables: [
+            "orgName",
+            "riskTolerance",
+            "constraints",
+            "priorities"
+        ],
+        outputSchema: {
+            type: "object",
+            properties: {
+                decision: { type: "string" },
+                score: { type: "number" },
+                rationale: { type: "string" },
+                risks: { type: "string" }
+            },
+            required: ["decision", "score", "rationale", "risks"]
+        }
+    }
+];
+exports.GENERIC_AUDIT_METADATA = {
+    outputType: "audit-result",
+    requiredPayloads: ["decision", "score", "theGood", "theBad", "takeaways"]
+};
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":";;;AAEa,QAAA,sBAAsB,GAAoB;IACnD;QACI,EAAE,EAAE,qBAAqB;QACzB,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,qBAAqB;QACjC,iBAAiB,EAAE,EAAE;QACrB,iBAAiB,EAAE;YACf,SAAS;YACT,MAAM;YACN,UAAU;YACV,eAAe;YACf,OAAO;YACP,KAAK;SACR;QACD,YAAY,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACR,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC/B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC9B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC/B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC5B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC/B;YACD,QAAQ,EAAE;gBACN,aAAa;gBACb,YAAY;gBACZ,aAAa;gBACb,UAAU;gBACV,UAAU;aACb;SACJ;KACJ;IACD;QACI,EAAE,EAAE,uBAAuB;QAC3B,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,uBAAuB;QACnC,iBAAiB,EAAE,EAAE;QACrB,iBAAiB,EAAE;YACf,SAAS;YACT,eAAe;YACf,aAAa;YACb,YAAY;SACf;QACD,YAAY,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACR,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC5B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC7B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC5B;YACD,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC;SACxD;KACJ;CACJ,CAAC;AAEW,QAAA,sBAAsB,GAAG;IAClC,UAAU,EAAE,cAAc;IAC1B,gBAAgB,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC;CAC5E,CAAC"}

package/dist/parsers/context-parser.d.ts

@@ -0,0 +1,2 @@
+export declare const contextToMarkdownString: (context: any) => string;
+//# sourceMappingURL=context-parser.d.ts.map

package/dist/parsers/context-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/context-parser.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,uBAAuB,GAAI,SAAS,GAAG,WAEnD,CAAA"}

package/dist/parsers/context-parser.js

@@ -0,0 +1,5 @@
+import { anyToMarkdownString } from "nx-helpers";
+export const contextToMarkdownString = (context) => {
+    return typeof context === 'string' ? context : anyToMarkdownString(context);
+};
+//# sourceMappingURL=context-parser.js.map

package/dist/parsers/context-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-parser.js","sourceRoot":"","sources":["../../src/parsers/context-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,OAAY,EAAE,EAAE;IACpD,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAChF,CAAC,CAAA"}

package/dist/parsers/input-parser.d.ts

@@ -0,0 +1,2 @@
+export declare const inputToMarkdownString: (input: any) => string;
+//# sourceMappingURL=input-parser.d.ts.map

package/dist/parsers/input-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/input-parser.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,qBAAqB,GAAI,OAAO,GAAG,WAE/C,CAAA"}

package/dist/parsers/input-parser.js

@@ -0,0 +1,5 @@
+import { anyToMarkdownString } from "nx-helpers";
+export const inputToMarkdownString = (input) => {
+    return typeof input === 'string' ? input : anyToMarkdownString(input);
+};
+//# sourceMappingURL=input-parser.js.map

package/dist/parsers/input-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-parser.js","sourceRoot":"","sources":["../../src/parsers/input-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAU,EAAE,EAAE;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC,CAAA"}

package/dist/runtime-objects.d.ts

@@ -0,0 +1,11 @@
+import type { RuntimeObjects } from "./types.js";
+/**
+ * Debug-only runtime observability objects for this package.
+ *
+ * - Present by default (mode omitted => debug)
+ * - Undefined in prod mode (mode=prod)
+ * - Expose-only: clients are attached only if this package already owns an
+ *   official queryable client instance (no adapters)
+ */
+export declare const runtimeObjects: RuntimeObjects | undefined;
+//# sourceMappingURL=runtime-objects.d.ts.map

package/dist/runtime-objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-objects.d.ts","sourceRoot":"","sources":["../src/runtime-objects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAOjD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,cAAc,GAAG,SAQvC,CAAC"}

package/dist/runtime-objects.js

@@ -0,0 +1,21 @@
+function resolveRuntimeMode() {
+    const raw = (process.env.mode ?? "debug").toLowerCase().trim();
+    return raw === "prod" ? "prod" : "debug";
+}
+/**
+ * Debug-only runtime observability objects for this package.
+ *
+ * - Present by default (mode omitted => debug)
+ * - Undefined in prod mode (mode=prod)
+ * - Expose-only: clients are attached only if this package already owns an
+ *   official queryable client instance (no adapters)
+ */
+export const runtimeObjects = resolveRuntimeMode() === "prod"
+    ? undefined
+    : {
+        lastJobId: undefined,
+        activixClient: undefined,
+        logxerClient: undefined,
+        packagesRuntimeObjects: [],
+    };
+//# sourceMappingURL=runtime-objects.js.map

package/dist/runtime-objects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-objects.js","sourceRoot":"","sources":["../src/runtime-objects.ts"],"names":[],"mappings":"AAEA,SAAS,kBAAkB;IACzB,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAC/D,OAAO,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;AAC3C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GACzB,kBAAkB,EAAE,KAAK,MAAM;IAC7B,CAAC,CAAC,SAAS;IACX,CAAC,CAAC;QACE,SAAS,EAAE,SAAS;QACpB,aAAa,EAAE,SAAS;QACxB,YAAY,EAAE,SAAS;QACvB,sBAAsB,EAAE,EAAE;KAC3B,CAAC"}

package/dist/skill-execution-trace-error.d.ts

@@ -0,0 +1,20 @@
+import type { GatewayInvokeRejectionMetadata } from "@x12i/ai-gateway";
+import type { RunSkillDiagnostics } from "./types.js";
+/**
+ * Thrown when trace mode is enabled and execution fails before or during gateway invoke.
+ * Examine {@link SkillExecutionTraceError.diagnostics} for `trace.ok === false`, a capped error envelope,
+ * merged gateway/error metadata when available, `trace.invokeRequest` echoing `modelConfig` / `timeoutMs`,
+ * and **`trace.invokeRejection`** when **`@x12i/ai-gateway`** attached **`GatewayInvokeRejectionMetadata`** (≥9.1.2).
+ *
+ * Non-trace **`runSkill`** rethrows the gateway error directly — read **`(error as Error & { metadata?: GatewayInvokeRejectionMetadata }).metadata`** there.
+ */
+export declare class SkillExecutionTraceError extends Error {
+    readonly diagnostics: RunSkillDiagnostics;
+    /** Convenience mirror of **`diagnostics.trace.invokeRejection`** when present. */
+    readonly invokeRejection?: GatewayInvokeRejectionMetadata;
+    constructor(message: string, diagnostics: RunSkillDiagnostics, options?: {
+        cause?: unknown;
+        invokeRejection?: GatewayInvokeRejectionMetadata;
+    });
+}
+//# sourceMappingURL=skill-execution-trace-error.d.ts.map

package/dist/skill-execution-trace-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-execution-trace-error.d.ts","sourceRoot":"","sources":["../src/skill-execution-trace-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;;;GAOG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAC1C,kFAAkF;IAClF,QAAQ,CAAC,eAAe,CAAC,EAAE,8BAA8B,CAAC;gBAGxD,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,mBAAmB,EAChC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,eAAe,CAAC,EAAE,8BAA8B,CAAA;KAAE;CAQlF"}

package/dist/skill-execution-trace-error.js

@@ -0,0 +1,21 @@
+/**
+ * Thrown when trace mode is enabled and execution fails before or during gateway invoke.
+ * Examine {@link SkillExecutionTraceError.diagnostics} for `trace.ok === false`, a capped error envelope,
+ * merged gateway/error metadata when available, `trace.invokeRequest` echoing `modelConfig` / `timeoutMs`,
+ * and **`trace.invokeRejection`** when **`@x12i/ai-gateway`** attached **`GatewayInvokeRejectionMetadata`** (≥9.1.2).
+ *
+ * Non-trace **`runSkill`** rethrows the gateway error directly — read **`(error as Error & { metadata?: GatewayInvokeRejectionMetadata }).metadata`** there.
+ */
+export class SkillExecutionTraceError extends Error {
+    diagnostics;
+    /** Convenience mirror of **`diagnostics.trace.invokeRejection`** when present. */
+    invokeRejection;
+    constructor(message, diagnostics, options) {
+        super(message, options?.cause !== undefined ? { cause: options.cause } : undefined);
+        this.name = "SkillExecutionTraceError";
+        this.diagnostics = diagnostics;
+        this.invokeRejection = options?.invokeRejection ?? diagnostics.trace.invokeRejection;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+//# sourceMappingURL=skill-execution-trace-error.js.map

package/dist/skill-execution-trace-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-execution-trace-error.js","sourceRoot":"","sources":["../src/skill-execution-trace-error.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACxC,WAAW,CAAsB;IAC1C,kFAAkF;IACzE,eAAe,CAAkC;IAE1D,YACE,OAAe,EACf,WAAgC,EAChC,OAA+E;QAE/E,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACpF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,eAAe,GAAG,OAAO,EAAE,eAAe,IAAI,WAAW,CAAC,KAAK,CAAC,eAAe,CAAC;QACrF,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF"}