@exellix/graph-engine 7.2.13 → 7.2.15

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 7.2.14
+
+### Fixed
+
+- **`test:live` / Node ESM:** Load `@x12i/logxer` via dynamic import in `graphEngineLogxer` (avoids CJS `trails` → `require('nanoid')` `ERR_REQUIRE_ESM` on Node 22). Inline run-log diagnostic normalization in `buildRunLog` (no static logxer import).
+- **Live script:** Remove redundant direct `@x12i/logxer` import; use `GRAPH_ENGINE_LOGS_LEVEL` / `LOGXER_PACKAGE_LEVELS` env instead.
+
 ## 7.2.13
 
 ### Added

package/dist/src/runtime/buildRunLog.js

@@ -1,4 +1,3 @@
-import { normalizeLogRecord } from '@x12i/logxer';
 import { AI_TASKS_LOGXER_RUN_ID_METADATA_KEY, AI_TASKS_RUN_LOG_METADATA_KEY, DEFAULT_MAX_RUN_LOG_DATA_JSON_CHARS, DEFAULT_MAX_RUN_LOG_ENTRIES, } from '../types/runLog.js';
 function safeJsonLen(value) {
     try {
@@ -38,6 +37,22 @@ function isRunLogScope(x) {
         x === 'logxer' ||
         x === 'pipeline');
 }
+/** Read promoted diagnostic fields without importing @x12i/logxer at module load. */
+function normalizeRunLogDiagnostics(row) {
+    const data = row.data != null && typeof row.data === 'object' && !Array.isArray(row.data)
+        ? row.data
+        : undefined;
+    const codeRaw = row.code ?? data?.code;
+    const code = typeof codeRaw === 'string' && codeRaw.length > 0 ? codeRaw : undefined;
+    const diagRaw = row.diagnostics ?? data?.diagnostics;
+    const diagnostics = diagRaw != null && typeof diagRaw === 'object' && !Array.isArray(diagRaw)
+        ? diagRaw
+        : undefined;
+    return {
+        ...(code ? { code } : {}),
+        ...(diagnostics ? { diagnostics } : {}),
+    };
+}
 /** Normalize @exellix/ai-tasks epoch-ms or ISO `ts` to epoch ms for exellix-graph `RunLogEntry`. */
 export function parseRunLogEntryTs(v) {
     if (typeof v === 'number' && Number.isFinite(v))
@@ -69,9 +84,7 @@ export function normalizeExternalRunLogEntries(raw) {
             ? r.correlationIds
             : undefined;
         const data = 'data' in r ? r.data : undefined;
-        const normalized = normalizeLogRecord(r);
-        const code = typeof normalized.code === 'string' && normalized.code.length > 0 ? normalized.code : undefined;
-        const diagnostics = normalized.diagnostics;
+        const { code, diagnostics } = normalizeRunLogDiagnostics(r);
         const debugKind = typeof r.debugKind === 'string' && r.debugKind.length > 0
             ? r.debugKind
             : undefined;

package/dist/src/runtime/graphEngineLogxer.d.ts

@@ -1,35 +1,24 @@
 /**
  * Graph-engine Logxer integration (@x12i/logxer 4.5.x).
- * Structured runtime logs, correlation context, stack log-level pass-through, and queryable in-process logs.
+ * Dynamic import defers loading @x12i/logxer until this module is evaluated (type-only imports stay erased).
  */
-import { DebugLogAbstract, exceptionEvidence, fieldEvidence, runWithLogContext, patchLogContext } from '@x12i/logxer';
 import type { GetJobLogsInput, GetJobLogsResult, Logxer, LogRuntimeContext, StackLoggingOptions } from '@x12i/logxer';
 import type { LogxerQueryableClient, RuntimeObjects } from './runtimeObjects.js';
 /** Env prefix for package-level log level: `GRAPH_ENGINE_LOGS_LEVEL` (canonical). */
 export declare const GRAPH_ENGINE_LOGXER_ENV_PREFIX: "GRAPH_ENGINE";
-/**
- * Factory for a graph-engine Logxer instance.
- * Pass `logging` from host {@link StackLoggingOptions} (logxer 4.5+ stack pass-through).
- */
+/** Factory for a graph-engine Logxer instance (logxer 4.5+ stack pass-through). */
 export declare function createGraphEngineLogxer(options?: {
     logging?: StackLoggingOptions;
 }): Logxer;
 /** Default process logger (env / host registry). Lazily created without stack overrides. */
 export declare function getGraphEngineLogxer(): Logxer;
-/** Bind the logger used for the current graph run (cleared in {@link clearGraphEngineRunLogxer}). */
-export declare function bindGraphEngineRunLogxer(logxer: Logxer): void;
+export declare function bindGraphEngineRunLogxer(instance: Logxer): void;
 export declare function clearGraphEngineRunLogxer(): void;
-/** Queryable client surface for {@link RuntimeObjects.logxerClient}. */
-export declare function createGraphEngineLogxerClient(logxer?: Logxer): LogxerQueryableClient;
-/** Attach graph-level Logxer query client when hosts omit one on runtimeObjects. */
-export declare function ensureGraphEngineLogxerOnRuntimeObjects(runtimeObjects: RuntimeObjects | undefined, logxer?: Logxer): void;
-/** Run graph work with Logxer correlation ids (jobId, taskId, graphId, runId). */
+export declare function createGraphEngineLogxerClient(instance?: Logxer): LogxerQueryableClient;
+export declare function ensureGraphEngineLogxerOnRuntimeObjects(runtimeObjects: RuntimeObjects | undefined, instance?: Logxer): void;
 export declare function runGraphWithLogContext<T>(ctx: LogRuntimeContext, fn: () => T | Promise<T>): Promise<T>;
-/** Narrow node-scoped correlation inside an active graph run context. */
 export declare function patchGraphNodeLogContext(nodeId: string): void;
-/** Gated verbose/state traces (replaces DEBUG_EXECUTION_MEMORY / DEBUG_OUTPUT_MAPPING console.log). */
 export declare function traceExecutionMemory(scope: 'executeNode' | 'executeGraph', message: string, data?: Record<string, unknown>): void;
-/** Emit a catalog-backed graph error log when a node/graph failure occurs. */
 export declare function logGraphEngineErrorCode(code: string, _message: string, ctx: {
     graphId?: string;
     nodeId?: string;
@@ -38,5 +27,15 @@ export declare function logGraphEngineErrorCode(code: string, _message: string,
     error?: unknown;
     evidence?: Record<string, unknown>;
 }): void;
-export { DebugLogAbstract, fieldEvidence, exceptionEvidence, runWithLogContext, patchLogContext };
+export declare const DebugLogAbstract: {
+    readonly STATE: "STATE";
+    readonly INTENT: "INTENT";
+    readonly EVENT: "EVENT";
+    readonly TRACE: "TRACE";
+    readonly ANOMALY: "ANOMALY";
+};
+export declare const fieldEvidence: typeof import("@x12i/logxer").fieldEvidence;
+export declare const exceptionEvidence: typeof import("@x12i/logxer").exceptionEvidence;
+export declare const runWithLogContext: typeof import("@x12i/logxer").runWithLogContext;
+export declare const patchLogContext: typeof import("@x12i/logxer").patchLogContext;
 export type { GetJobLogsInput, GetJobLogsResult, LogRuntimeContext, StackLoggingOptions };

package/dist/src/runtime/graphEngineLogxer.js

@@ -1,8 +1,4 @@
-/**
- * Graph-engine Logxer integration (@x12i/logxer 4.5.x).
- * Structured runtime logs, correlation context, stack log-level pass-through, and queryable in-process logs.
- */
-import { createLogxer, DebugLogAbstract, exceptionEvidence, fieldEvidence, runWithLogContext, patchLogContext, } from '@x12i/logxer';
+const logxer = await import('@x12i/logxer');
 import { ExellixGraphErrorCode } from '../errors/exellixGraphErrorCodes.js';
 import { EXELLIX_GRAPH_RUNTIME_PACKAGE_NAME } from './runtimeObjects.js';
 /** Env prefix for package-level log level: `GRAPH_ENGINE_LOGS_LEVEL` (canonical). */
@@ -86,12 +82,9 @@ function buildGraphEngineLogxerConfig(logging) {
         ...(logging ? { stack: logging } : {}),
     };
 }
-/**
- * Factory for a graph-engine Logxer instance.
- * Pass `logging` from host {@link StackLoggingOptions} (logxer 4.5+ stack pass-through).
- */
+/** Factory for a graph-engine Logxer instance (logxer 4.5+ stack pass-through). */
 export function createGraphEngineLogxer(options) {
-    return createLogxer({
+    return logxer.createLogxer({
         packageName: EXELLIX_GRAPH_RUNTIME_PACKAGE_NAME,
         envPrefix: GRAPH_ENGINE_LOGXER_ENV_PREFIX,
         debugNamespace: 'graph-engine',
@@ -104,37 +97,31 @@ export function getGraphEngineLogxer() {
     }
     return activeRunLogxer ?? defaultLogxer;
 }
-/** Bind the logger used for the current graph run (cleared in {@link clearGraphEngineRunLogxer}). */
-export function bindGraphEngineRunLogxer(logxer) {
-    activeRunLogxer = logxer;
+export function bindGraphEngineRunLogxer(instance) {
+    activeRunLogxer = instance;
 }
 export function clearGraphEngineRunLogxer() {
     activeRunLogxer = undefined;
 }
-/** Queryable client surface for {@link RuntimeObjects.logxerClient}. */
-export function createGraphEngineLogxerClient(logxer) {
-    const target = logxer ?? getGraphEngineLogxer();
+export function createGraphEngineLogxerClient(instance) {
+    const target = instance ?? getGraphEngineLogxer();
     return {
         getJobLogs(input) {
             return target.getJobLogs(input);
         },
     };
 }
-/** Attach graph-level Logxer query client when hosts omit one on runtimeObjects. */
-export function ensureGraphEngineLogxerOnRuntimeObjects(runtimeObjects, logxer) {
+export function ensureGraphEngineLogxerOnRuntimeObjects(runtimeObjects, instance) {
     if (!runtimeObjects || runtimeObjects.logxerClient != null)
         return;
-    runtimeObjects.logxerClient = createGraphEngineLogxerClient(logxer);
+    runtimeObjects.logxerClient = createGraphEngineLogxerClient(instance);
 }
-/** Run graph work with Logxer correlation ids (jobId, taskId, graphId, runId). */
 export function runGraphWithLogContext(ctx, fn) {
-    return runWithLogContext(ctx, fn);
+    return logxer.runWithLogContext(ctx, fn);
 }
-/** Narrow node-scoped correlation inside an active graph run context. */
 export function patchGraphNodeLogContext(nodeId) {
-    patchLogContext({ nodeId });
+    logxer.patchLogContext({ nodeId });
 }
-/** Gated verbose/state traces (replaces DEBUG_EXECUTION_MEMORY / DEBUG_OUTPUT_MAPPING console.log). */
 export function traceExecutionMemory(scope, message, data) {
     if (process.env.DEBUG_EXECUTION_MEMORY !== 'true' &&
         process.env.DEBUG_OUTPUT_MAPPING !== 'true') {
@@ -143,23 +130,26 @@ export function traceExecutionMemory(scope, message, data) {
     getGraphEngineLogxer().verbose(message, {
         scope,
         ...data,
-        debugKind: DebugLogAbstract.STATE,
+        debugKind: logxer.DebugLogAbstract.STATE,
     });
 }
-/** Emit a catalog-backed graph error log when a node/graph failure occurs. */
 export function logGraphEngineErrorCode(code, _message, ctx) {
-    const logxer = getGraphEngineLogxer();
+    const instance = getGraphEngineLogxer();
     const evidence = [
-        ...(ctx.error != null ? [exceptionEvidence(ctx.error)] : []),
-        ...Object.entries(ctx.evidence ?? {}).map(([path, value]) => fieldEvidence(path, value)),
+        ...(ctx.error != null ? [logxer.exceptionEvidence(ctx.error)] : []),
+        ...Object.entries(ctx.evidence ?? {}).map(([path, value]) => logxer.fieldEvidence(path, value)),
     ];
-    logxer.errorCode(code, {
+    instance.errorCode(code, {
         graphId: ctx.graphId,
         nodeId: ctx.nodeId,
         jobId: ctx.jobId,
         taskId: ctx.taskId,
-        debugKind: DebugLogAbstract.ANOMALY,
+        debugKind: logxer.DebugLogAbstract.ANOMALY,
         ...(evidence.length ? { evidence } : {}),
     });
 }
-export { DebugLogAbstract, fieldEvidence, exceptionEvidence, runWithLogContext, patchLogContext };
+export const DebugLogAbstract = logxer.DebugLogAbstract;
+export const fieldEvidence = logxer.fieldEvidence;
+export const exceptionEvidence = logxer.exceptionEvidence;
+export const runWithLogContext = logxer.runWithLogContext;
+export const patchLogContext = logxer.patchLogContext;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exellix/graph-engine",
-  "version": "7.2.13",
+  "version": "7.2.15",
   "type": "module",
   "description": "Graph executor SDK",
   "main": "dist/src/index.js",
@@ -50,19 +50,19 @@
     "access": "public"
   },
   "dependencies": {
-    "@exellix/ai-tasks": "^8.1.12",
+    "@exellix/ai-tasks": "^8.1.15",
     "@x12i/activix": "8.3.1",
     "@x12i/ai-profiles": "1.6.0",
-    "@x12i/catalox": "5.1.1",
+    "@x12i/catalox": "5.1.2",
     "@x12i/env": "4.0.1",
     "@x12i/funcx": "4.2.2",
     "@x12i/graphenix": "2.5.0",
     "@x12i/graphenix-format": "2.0.0",
-    "@x12i/logxer": "^4.5.0",
+    "@x12i/logxer": "^4.5.1",
     "@x12i/memorix-descriptors": "1.6.0",
-    "@x12i/memorix-retrieval": "1.11.0",
+    "@x12i/memorix-retrieval": "1.11.1",
     "@x12i/memorix-writer": "1.0.0",
-    "@x12i/optimixer": "^2.4.2",
+    "@x12i/optimixer": "^2.4.4",
     "@x12i/rendrix": "4.3.0",
     "@x12i/runx": "1.3.0"
   },