@exellix/ai-skills 5.8.0

package/dist/utils/enrich-activix-identity.d.ts

@@ -0,0 +1,30 @@
+import type { SkillCostStatus, SkillTraceUsage } from "../types.js";
+/**
+ * Nested key on gateway **`identity`** / forwarded {@link RunSkillResponse.identity} carrying the
+ * last skill invoke’s token usage and cost (mirrors {@link RunSkillResponse.metadata} and trace usage).
+ * Forward the whole `identity` to later `runSkill` calls so Activix-oriented pipelines retain billing context.
+ */
+export declare const AI_SKILLS_LLM_IDENTITY_KEY = "aiSkillsLlm";
+export type AiSkillsLlmIdentitySlice = {
+    usage: SkillTraceUsage;
+    costUsd?: number;
+    costStatus?: SkillCostStatus;
+    modelUsed?: string;
+};
+/**
+ * Attach LLM billing snapshot for downstream / Activix chaining. Overwrites any prior `aiSkillsLlm` on this object.
+ */
+export declare function enrichIdentityWithAiSkillsLlmSnapshot(identity: Record<string, any>, snapshot: AiSkillsLlmIdentitySlice): void;
+/**
+ * Activix identity (library boundary): `identity` here is **runtime** request data from the caller,
+ * not SDK or env config. We do not create `identity` when upstream omits it.
+ * When `identity` is present, we only add work-scope context for **this** call: set `skillId`
+ * on the envelope if it was not already supplied and the request carries a `skillId`.
+ *
+ * We do **not** mint `sessionId`, overwrite upstream ids, or add or “fix” `instance`
+ * (`instance` is optional per the identity contract; the gateway may still set it).
+ */
+export declare function enrichActivixIdentityForGateway(identity: Record<string, any>, options: {
+    skillId?: string | null;
+}): void;
+//# sourceMappingURL=enrich-activix-identity.d.ts.map

package/dist/utils/enrich-activix-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich-activix-identity.d.ts","sourceRoot":"","sources":["../../src/utils/enrich-activix-identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,gBAAgB,CAAC;AAExD,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,QAAQ,EAAE,wBAAwB,GACjC,IAAI,CAON;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACnC,IAAI,CAQN"}

package/dist/utils/enrich-activix-identity.js

@@ -0,0 +1,34 @@
+/**
+ * Nested key on gateway **`identity`** / forwarded {@link RunSkillResponse.identity} carrying the
+ * last skill invoke’s token usage and cost (mirrors {@link RunSkillResponse.metadata} and trace usage).
+ * Forward the whole `identity` to later `runSkill` calls so Activix-oriented pipelines retain billing context.
+ */
+export const AI_SKILLS_LLM_IDENTITY_KEY = "aiSkillsLlm";
+/**
+ * Attach LLM billing snapshot for downstream / Activix chaining. Overwrites any prior `aiSkillsLlm` on this object.
+ */
+export function enrichIdentityWithAiSkillsLlmSnapshot(identity, snapshot) {
+    identity[AI_SKILLS_LLM_IDENTITY_KEY] = {
+        usage: snapshot.usage,
+        ...(snapshot.costUsd !== undefined ? { costUsd: snapshot.costUsd } : {}),
+        ...(snapshot.costStatus !== undefined ? { costStatus: snapshot.costStatus } : {}),
+        ...(snapshot.modelUsed !== undefined ? { modelUsed: snapshot.modelUsed } : {}),
+    };
+}
+/**
+ * Activix identity (library boundary): `identity` here is **runtime** request data from the caller,
+ * not SDK or env config. We do not create `identity` when upstream omits it.
+ * When `identity` is present, we only add work-scope context for **this** call: set `skillId`
+ * on the envelope if it was not already supplied and the request carries a `skillId`.
+ *
+ * We do **not** mint `sessionId`, overwrite upstream ids, or add or “fix” `instance`
+ * (`instance` is optional per the identity contract; the gateway may still set it).
+ */
+export function enrichActivixIdentityForGateway(identity, options) {
+    if (options.skillId != null &&
+        String(options.skillId).trim() !== "" &&
+        identity.skillId == null) {
+        identity.skillId = options.skillId;
+    }
+}
+//# sourceMappingURL=enrich-activix-identity.js.map

package/dist/utils/enrich-activix-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich-activix-identity.js","sourceRoot":"","sources":["../../src/utils/enrich-activix-identity.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,aAAa,CAAC;AASxD;;GAEG;AACH,MAAM,UAAU,qCAAqC,CACnD,QAA6B,EAC7B,QAAkC;IAElC,QAAQ,CAAC,0BAA0B,CAAC,GAAG;QACrC,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,GAAG,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,GAAG,CAAC,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,GAAG,CAAC,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/E,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,+BAA+B,CAC7C,QAA6B,EAC7B,OAAoC;IAEpC,IACE,OAAO,CAAC,OAAO,IAAI,IAAI;QACvB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QACrC,QAAQ,CAAC,OAAO,IAAI,IAAI,EACxB,CAAC;QACD,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACrC,CAAC;AACH,CAAC"}

package/dist/utils/exellix-skills-logxer-defaults.d.ts

@@ -0,0 +1,16 @@
+import type { LoggingConfig, RuntimeIdentity } from "@x12i/logxer";
+/**
+ * Reads `@exellix/ai-skills` semver from the package root (works from `src/` or `dist/`).
+ */
+export declare function readAiSkillsLibraryVersion(): string | undefined;
+/**
+ * Default {@link LoggingConfig} for `createLogxer` in this repo: structured {@link RuntimeIdentity}
+ * for Logxer 4.x envelopes and optional host overrides.
+ */
+export declare function buildAiSkillsLogxerLoggingConfig(opts?: {
+    /** Becomes `RuntimeIdentity.service` (typically {@link ExellixSkillsClientOptions.packageName}). */
+    service?: string;
+    /** Shallow-merged on top of library defaults. */
+    runtimeIdentity?: Partial<RuntimeIdentity>;
+}): LoggingConfig;
+//# sourceMappingURL=exellix-skills-logxer-defaults.d.ts.map

package/dist/utils/exellix-skills-logxer-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exellix-skills-logxer-defaults.d.ts","sourceRoot":"","sources":["../../src/utils/exellix-skills-logxer-defaults.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAInE;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,GAAG,SAAS,CAQ/D;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,IAAI,CAAC,EAAE;IACpD,oGAAoG;IACpG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,eAAe,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CAC9C,GAAG,aAAa,CAahB"}

package/dist/utils/exellix-skills-logxer-defaults.js

@@ -0,0 +1,37 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { hostname } from "node:os";
+const REPO_ROOT = join(dirname(fileURLToPath(import.meta.url)), "..", "..");
+/**
+ * Reads `@exellix/ai-skills` semver from the package root (works from `src/` or `dist/`).
+ */
+export function readAiSkillsLibraryVersion() {
+    try {
+        const raw = readFileSync(join(REPO_ROOT, "package.json"), "utf8");
+        const v = JSON.parse(raw)?.version;
+        return typeof v === "string" ? v : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Default {@link LoggingConfig} for `createLogxer` in this repo: structured {@link RuntimeIdentity}
+ * for Logxer 4.x envelopes and optional host overrides.
+ */
+export function buildAiSkillsLogxerLoggingConfig(opts) {
+    const libraryVersion = readAiSkillsLibraryVersion() ?? "unknown";
+    const runtimeIdentity = {
+        service: opts?.service ?? "@exellix/ai-skills",
+        version: libraryVersion,
+        env: process.env.NODE_ENV ?? "development",
+        host: hostname(),
+        pid: process.pid,
+        libraryPackage: "@exellix/ai-skills",
+        libraryVersion,
+        ...opts?.runtimeIdentity,
+    };
+    return { runtimeIdentity };
+}
+//# sourceMappingURL=exellix-skills-logxer-defaults.js.map

package/dist/utils/exellix-skills-logxer-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exellix-skills-logxer-defaults.js","sourceRoot":"","sources":["../../src/utils/exellix-skills-logxer-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAE5E;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACtC,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;QAClE,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;QACnC,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAAC,IAKhD;IACG,MAAM,cAAc,GAAG,0BAA0B,EAAE,IAAI,SAAS,CAAC;IACjE,MAAM,eAAe,GAAoB;QACrC,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,oBAAoB;QAC9C,OAAO,EAAE,cAAc;QACvB,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa;QAC1C,IAAI,EAAE,QAAQ,EAAE;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,cAAc,EAAE,oBAAoB;QACpC,cAAc;QACd,GAAG,IAAI,EAAE,eAAe;KAC3B,CAAC;IACF,OAAO,EAAE,eAAe,EAAE,CAAC;AAC/B,CAAC"}

package/dist/utils/flex-md-parser.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Local Flex-MD parsing for `@exellix/ai-skills` when the gateway does not supply parsed payloads.
+ *
+ * **Not the same as** `@x12i/ai-gateway`’s `extractJsonFromFlexMd` (see `docs/FLEX_MD_AND_TESTING.md`).
+ *
+ * - Loads `flex-md` only via **dynamic ESM** `import('flex-md')` (no `require`).
+ * - Falls back to a small parser for `[[frame:...]]` + `@payload:name` text if the library is unavailable or yields no structure.
+ *
+ * @module
+ */
+type ParsedFlexMd = {
+    frame: string;
+    payloads: Record<string, string>;
+};
+/**
+ * Parse model output into `{ frame, payloads }`.
+ *
+ * @param text - Raw markdown / Flex-MD text from the model or gateway.
+ * @returns Frame name and string payloads (non-strings JSON-stringified).
+ */
+export declare function parseFlexMd(text: string): Promise<ParsedFlexMd>;
+export {};
+//# sourceMappingURL=flex-md-parser.d.ts.map

package/dist/utils/flex-md-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flex-md-parser.d.ts","sourceRoot":"","sources":["../../src/utils/flex-md-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,KAAK,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAiFxE;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA4BrE"}

package/dist/utils/flex-md-parser.js

@@ -0,0 +1,98 @@
+/**
+ * Local Flex-MD parsing for `@exellix/ai-skills` when the gateway does not supply parsed payloads.
+ *
+ * **Not the same as** `@x12i/ai-gateway`’s `extractJsonFromFlexMd` (see `docs/FLEX_MD_AND_TESTING.md`).
+ *
+ * - Loads `flex-md` only via **dynamic ESM** `import('flex-md')` (no `require`).
+ * - Falls back to a small parser for `[[frame:...]]` + `@payload:name` text if the library is unavailable or yields no structure.
+ *
+ * @module
+ */
+let cachedFlexMdModule = null;
+let cachedFlexMdLoadError = null;
+function normalizePayloads(candidate) {
+    if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) {
+        return {};
+    }
+    const payloads = {};
+    for (const [key, value] of Object.entries(candidate)) {
+        if (value === undefined || value === null) {
+            payloads[key] = "";
+            continue;
+        }
+        payloads[key] = typeof value === "string" ? value : JSON.stringify(value);
+    }
+    return payloads;
+}
+function fallbackMarkdownParser(text) {
+    const frameMatch = text.match(/\[\[frame:\s*([^\]]+)\]\]/);
+    const frame = frameMatch ? frameMatch[1].trim() : "unknown";
+    const payloads = {};
+    const parts = text.split(/@payload:\s*([^\n\r]+)/);
+    for (let i = 1; i < parts.length; i += 2) {
+        const name = parts[i].trim();
+        const content = parts[i + 1] ? parts[i + 1].trim() : "";
+        payloads[name] = content;
+    }
+    return { frame, payloads };
+}
+async function loadFlexMdModule() {
+    if (cachedFlexMdModule) {
+        return cachedFlexMdModule;
+    }
+    if (cachedFlexMdLoadError) {
+        throw cachedFlexMdLoadError;
+    }
+    try {
+        // Strict ESM load path for flex-md.
+        // flex-md's typings don't expose `default` on `import()`, but runtime may be CJS interop shape.
+        const importedRaw = await import("flex-md");
+        const imported = importedRaw;
+        const moduleShape = (imported.default ?? imported);
+        cachedFlexMdModule = moduleShape;
+        return moduleShape;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        cachedFlexMdLoadError = new Error([
+            "flex-md ES module compatibility issue:",
+            `ES import fails: ${message}`,
+            "flex-md must be imported as an ES module"
+        ].join("\n"));
+        throw cachedFlexMdLoadError;
+    }
+}
+/**
+ * Parse model output into `{ frame, payloads }`.
+ *
+ * @param text - Raw markdown / Flex-MD text from the model or gateway.
+ * @returns Frame name and string payloads (non-strings JSON-stringified).
+ */
+export async function parseFlexMd(text) {
+    try {
+        const flexMd = await loadFlexMdModule();
+        if (typeof flexMd.extractFromMarkdown === "function") {
+            const extracted = flexMd.extractFromMarkdown(text);
+            const parsed = extracted?.json ?? extracted?.data ?? extracted?.result ?? extracted;
+            const payloads = normalizePayloads(parsed);
+            if (Object.keys(payloads).length > 0) {
+                return {
+                    frame: typeof extracted?.frame === "string" ? extracted.frame : "unknown",
+                    payloads
+                };
+            }
+        }
+        if (typeof flexMd.markdownToJson === "function") {
+            const parsed = flexMd.markdownToJson(text);
+            const payloads = normalizePayloads(parsed);
+            if (Object.keys(payloads).length > 0) {
+                return { frame: "unknown", payloads };
+            }
+        }
+    }
+    catch {
+        // Fall back to local markdown parser when flex-md loading/parsing fails.
+    }
+    return fallbackMarkdownParser(text);
+}
+//# sourceMappingURL=flex-md-parser.js.map

package/dist/utils/flex-md-parser.js.map

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

package/dist/utils/gateway-execution-summary.d.ts

@@ -0,0 +1,18 @@
+import type { EffectiveModelConfigSlice } from "../types.js";
+/**
+ * Routing / generation facts exposed on gateway `invoke()` responses (from router metadata when forwarded).
+ */
+export type GatewayExecutionSummary = {
+    provider?: string;
+    modelUsed?: string;
+    effectiveMaxTokens?: number;
+    region?: string;
+};
+/**
+ * Reads execution summary from a gateway `invoke()` return value.
+ * Reads `@x12i/ai-gateway` ≥9.1.1 invoke **`metadata`** (routing slice always present on success when router/config supplies values). See **`docs/AI_GATEWAY_INVOKE_EXECUTION_METADATA.md`**.
+ */
+export declare function gatewayExecutionSummaryFromInvokeResponse(response: unknown): GatewayExecutionSummary;
+/** Gateway ≥9.1.1 **`metadata.effectiveModelConfig`** (allowlisted slice); falls back to **`mergedModelConfig`** when present. */
+export declare function effectiveModelConfigFromGatewayMetadata(metadata: Record<string, any> | undefined | null): EffectiveModelConfigSlice | undefined;
+//# sourceMappingURL=gateway-execution-summary.d.ts.map

package/dist/utils/gateway-execution-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-execution-summary.d.ts","sourceRoot":"","sources":["../../src/utils/gateway-execution-summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,yCAAyC,CAAC,QAAQ,EAAE,OAAO,GAAG,uBAAuB,CA+BpG;AAED,kIAAkI;AAClI,wBAAgB,uCAAuC,CACnD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,GACjD,yBAAyB,GAAG,SAAS,CAKvC"}

package/dist/utils/gateway-execution-summary.js

@@ -0,0 +1,42 @@
+/**
+ * Reads execution summary from a gateway `invoke()` return value.
+ * Reads `@x12i/ai-gateway` ≥9.1.1 invoke **`metadata`** (routing slice always present on success when router/config supplies values). See **`docs/AI_GATEWAY_INVOKE_EXECUTION_METADATA.md`**.
+ */
+export function gatewayExecutionSummaryFromInvokeResponse(response) {
+    const r = response;
+    if (!r || typeof r !== "object")
+        return {};
+    const md = r.metadata && typeof r.metadata === "object" && !Array.isArray(r.metadata) ? r.metadata : {};
+    const provider = typeof md.provider === "string" && md.provider.trim().length > 0
+        ? md.provider.trim()
+        : typeof r.provider === "string" && r.provider.trim().length > 0
+            ? r.provider.trim()
+            : undefined;
+    const modelUsed = (typeof md.modelUsed === "string" && md.modelUsed.trim().length > 0 ? md.modelUsed.trim() : undefined) ??
+        (typeof md.model === "string" && md.model.trim().length > 0 ? md.model.trim() : undefined) ??
+        (typeof r.model === "string" && r.model.trim().length > 0 ? r.model.trim() : undefined);
+    const effectiveMaxTokens = typeof md.maxTokensRequested === "number" && !Number.isNaN(md.maxTokensRequested)
+        ? md.maxTokensRequested
+        : undefined;
+    const region = typeof md.region === "string" && md.region.trim().length > 0 ? md.region.trim() : undefined;
+    const out = {};
+    if (provider !== undefined)
+        out.provider = provider;
+    if (modelUsed !== undefined)
+        out.modelUsed = modelUsed;
+    if (effectiveMaxTokens !== undefined)
+        out.effectiveMaxTokens = effectiveMaxTokens;
+    if (region !== undefined)
+        out.region = region;
+    return out;
+}
+/** Gateway ≥9.1.1 **`metadata.effectiveModelConfig`** (allowlisted slice); falls back to **`mergedModelConfig`** when present. */
+export function effectiveModelConfigFromGatewayMetadata(metadata) {
+    if (!metadata || typeof metadata !== "object")
+        return undefined;
+    const raw = metadata.effectiveModelConfig ?? metadata.mergedModelConfig;
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return undefined;
+    return raw;
+}
+//# sourceMappingURL=gateway-execution-summary.js.map

package/dist/utils/gateway-execution-summary.js.map

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

package/dist/utils/gateway-invoke-rejection.d.ts

@@ -0,0 +1,9 @@
+import type { GatewayInvokeRejectionMetadata } from "@x12i/ai-gateway";
+/**
+ * Reads `@x12i/ai-gateway` **`GatewayInvokeRejectionMetadata`** from a thrown **`invoke()`** error
+ * (`error.metadata`), walking **`cause`** a few hops (wrapped NO_PROVIDER errors preserve metadata on the wrapper).
+ *
+ * @see https://github.com/x12i/ai-gateway — **`docs/AI_GATEWAY_INVOKE_EXECUTION_METADATA.md`**
+ */
+export declare function gatewayInvokeRejectionFromErrorChain(err: unknown): GatewayInvokeRejectionMetadata | undefined;
+//# sourceMappingURL=gateway-invoke-rejection.d.ts.map

package/dist/utils/gateway-invoke-rejection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-invoke-rejection.d.ts","sourceRoot":"","sources":["../../src/utils/gateway-invoke-rejection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,kBAAkB,CAAC;AAEvE;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAAC,GAAG,EAAE,OAAO,GAAG,8BAA8B,GAAG,SAAS,CAW7G"}

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

@@ -0,0 +1,28 @@
+/**
+ * Reads `@x12i/ai-gateway` **`GatewayInvokeRejectionMetadata`** from a thrown **`invoke()`** error
+ * (`error.metadata`), walking **`cause`** a few hops (wrapped NO_PROVIDER errors preserve metadata on the wrapper).
+ *
+ * @see https://github.com/x12i/ai-gateway — **`docs/AI_GATEWAY_INVOKE_EXECUTION_METADATA.md`**
+ */
+export function gatewayInvokeRejectionFromErrorChain(err) {
+    let cur = err;
+    for (let depth = 0; depth < 8 && cur != null; depth++) {
+        const meta = readRejectionMetadataFromSingleError(cur);
+        if (meta !== undefined)
+            return meta;
+        cur =
+            typeof cur === "object" && cur !== null && "cause" in cur
+                ? cur.cause
+                : undefined;
+    }
+    return undefined;
+}
+function readRejectionMetadataFromSingleError(err) {
+    if (!err || typeof err !== "object")
+        return undefined;
+    const m = err.metadata;
+    if (!m || typeof m !== "object" || Array.isArray(m))
+        return undefined;
+    return m;
+}
+//# sourceMappingURL=gateway-invoke-rejection.js.map

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

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

package/dist/utils/normalize-billing-metadata.d.ts

@@ -0,0 +1,17 @@
+import type { SkillCostStatus, SkillTraceUsage } from "../types.js";
+export type { SkillCostStatus };
+export interface NormalizedSkillBilling {
+    usage: SkillTraceUsage;
+    /** USD total when gateway/router supplied a numeric cost. */
+    costUsd?: number;
+    costStatus?: SkillCostStatus;
+    modelUsed?: string;
+}
+export declare function hasMeaningfulUsage(usage: SkillTraceUsage): boolean;
+/**
+ * Canonical billing slice for {@link RunSkillResponse.metadata}, traces, and Activix patches.
+ * Mirrors `@x12i/ai-gateway` invoke metadata (`costUsd` / `cost`, `costStatus: priced|unpriced`).
+ * SDK responses use `costUsd` when priced and `costStatus: "unpriced"` (or legacy `"deferred"`) when not.
+ */
+export declare function normalizeSkillBillingFromGatewayMetadata(metadata: Record<string, any> | undefined | null, usageOverride?: SkillTraceUsage): NormalizedSkillBilling;
+//# sourceMappingURL=normalize-billing-metadata.d.ts.map

package/dist/utils/normalize-billing-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-billing-metadata.d.ts","sourceRoot":"","sources":["../../src/utils/normalize-billing-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGpE,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,eAAe,CAAC;IACvB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA8BD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAMlE;AAED;;;;GAIG;AACH,wBAAgB,wCAAwC,CACtD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,EAChD,aAAa,CAAC,EAAE,eAAe,GAC9B,sBAAsB,CAyCxB"}

package/dist/utils/normalize-billing-metadata.js

@@ -0,0 +1,75 @@
+import { usageFromGatewayMetadata } from "../diagnostics/gateway-usage.js";
+/** SDK-facing cost statuses (gateway `priced` is represented only via {@link costUsd}). */
+const SDK_COST_STATUS_VALUES = new Set(["unpriced", "deferred"]);
+function readCostUsd(metadata) {
+    if (typeof metadata.costUsd === "number" && !Number.isNaN(metadata.costUsd)) {
+        return metadata.costUsd;
+    }
+    if (typeof metadata.cost === "number" && !Number.isNaN(metadata.cost)) {
+        return metadata.cost;
+    }
+    return undefined;
+}
+function readSdkCostStatus(metadata) {
+    const raw = metadata.costStatus;
+    if (typeof raw !== "string")
+        return undefined;
+    // Gateway ≥9.3: `priced` is carried as costUsd/cost — never surface `costStatus: "priced"` downstream.
+    if (raw === "priced")
+        return undefined;
+    if (SDK_COST_STATUS_VALUES.has(raw)) {
+        return raw;
+    }
+    return undefined;
+}
+function readGatewayUnpriced(metadata) {
+    return metadata.costStatus === "unpriced";
+}
+export function hasMeaningfulUsage(usage) {
+    return (usage.tokensTotal > 0 ||
+        usage.tokensPrompt > 0 ||
+        usage.tokensCompletion > 0);
+}
+/**
+ * Canonical billing slice for {@link RunSkillResponse.metadata}, traces, and Activix patches.
+ * Mirrors `@x12i/ai-gateway` invoke metadata (`costUsd` / `cost`, `costStatus: priced|unpriced`).
+ * SDK responses use `costUsd` when priced and `costStatus: "unpriced"` (or legacy `"deferred"`) when not.
+ */
+export function normalizeSkillBillingFromGatewayMetadata(metadata, usageOverride) {
+    const md = metadata ?? {};
+    const usage = usageOverride ?? usageFromGatewayMetadata(md);
+    const costUsd = readCostUsd(md);
+    const explicitStatus = readSdkCostStatus(md);
+    const gatewayMarkedUnpriced = readGatewayUnpriced(md);
+    const modelUsed = typeof md.modelUsed === "string" && md.modelUsed.trim().length > 0
+        ? md.modelUsed.trim()
+        : typeof md.model === "string" && md.model.trim().length > 0
+            ? md.model.trim()
+            : undefined;
+    if (costUsd !== undefined) {
+        return {
+            usage,
+            costUsd,
+            ...(modelUsed !== undefined ? { modelUsed } : {}),
+        };
+    }
+    if (explicitStatus !== undefined || gatewayMarkedUnpriced) {
+        return {
+            usage,
+            costStatus: explicitStatus ?? "unpriced",
+            ...(modelUsed !== undefined ? { modelUsed } : {}),
+        };
+    }
+    if (hasMeaningfulUsage(usage)) {
+        return {
+            usage,
+            costStatus: "unpriced",
+            ...(modelUsed !== undefined ? { modelUsed } : {}),
+        };
+    }
+    return {
+        usage,
+        ...(modelUsed !== undefined ? { modelUsed } : {}),
+    };
+}
+//# sourceMappingURL=normalize-billing-metadata.js.map

package/dist/utils/normalize-billing-metadata.js.map

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

package/dist/utils/normalize-output-parsed.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Graph / studio `outputContract` — keys expected on `output.parsed` (e.g. `shortAnswer`, `fullAnswer`).
+ */
+export type OutputContract = string[] | Record<string, unknown> | {
+    fields?: string[];
+    keys?: string[];
+    required?: string[];
+};
+/** Resolves contract field names from common graph-engine shapes. */
+export declare function resolveOutputContractFields(contract: OutputContract | undefined): string[];
+/** `### Short Answer` → `shortAnswer`. */
+export declare function markdownHeadingToFieldKey(heading: string): string;
+/** Parses `### Section` blocks from markdown into camelCase field keys. */
+export declare function parseMarkdownSectionsToFields(text: string): Record<string, string>;
+/**
+ * Fills `parsed` keys requested by `outputContract` from FlexMD payloads and markdown sections.
+ * Does not remove existing parsed keys; only adds missing satisfiable values.
+ */
+export declare function enrichParsedForOutputContract(args: {
+    parsed: Record<string, unknown>;
+    flexMdPayloads?: Record<string, string>;
+    rawText?: string;
+    outputContract?: OutputContract;
+}): Record<string, unknown>;
+//# sourceMappingURL=normalize-output-parsed.d.ts.map

package/dist/utils/normalize-output-parsed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-output-parsed.d.ts","sourceRoot":"","sources":["../../src/utils/normalize-output-parsed.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,EAAE,GACR,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB;IACE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAMN,qEAAqE;AACrE,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,EAAE,CAqB1F;AAED,0CAA0C;AAC1C,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAcjE;AAYD,2EAA2E;AAC3E,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBlF;AAQD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0C1B"}