@indexnetwork/protocol 4.5.0-rc.322.1 → 4.5.0-rc.324.1

package/dist/shared/observability/log.js

@@ -12,19 +12,56 @@
 // ═══════════════════════════════════════════════════════════════════════════════
 function defaultCreateLogger(_context, source) {
     const prefix = `[${source}]`;
+    const emit = (sink, msg, meta) => sink(prefix, msg, ...(meta ? [sanitizeFn(meta)] : []));
     return {
-        verbose: (msg, meta) => console.debug(prefix, msg, ...(meta ? [meta] : [])),
-        debug: (msg, meta) => console.debug(prefix, msg, ...(meta ? [meta] : [])),
-        info: (msg, meta) => console.info(prefix, msg, ...(meta ? [meta] : [])),
-        warn: (msg, meta) => console.warn(prefix, msg, ...(meta ? [meta] : [])),
-        error: (msg, meta) => console.error(prefix, msg, ...(meta ? [meta] : [])),
+        // eslint-disable-next-line no-console
+        verbose: (msg, meta) => emit(console.debug, msg, meta),
+        // eslint-disable-next-line no-console
+        debug: (msg, meta) => emit(console.debug, msg, meta),
+        // eslint-disable-next-line no-console
+        info: (msg, meta) => emit(console.info, msg, meta),
+        // eslint-disable-next-line no-console
+        warn: (msg, meta) => emit(console.warn, msg, meta),
+        // eslint-disable-next-line no-console
+        error: (msg, meta) => emit(console.error, msg, meta),
     };
 }
-function defaultSanitize(value) {
+/** Truncation limits for the default (host-less) sanitizer — never dump big payloads. */
+const MAX_STRING_LENGTH = 2000;
+const MAX_ARRAY_ITEMS = 25;
+const MAX_DEPTH = 6;
+function defaultSanitize(value, depth = 0) {
+    if (value == null)
+        return value;
+    if (typeof value === 'string') {
+        return value.length > MAX_STRING_LENGTH
+            ? `${value.slice(0, MAX_STRING_LENGTH)}… [truncated ${value.length - MAX_STRING_LENGTH} chars]`
+            : value;
+    }
+    if (Array.isArray(value)) {
+        if (value.length > 0 && typeof value[0] === 'number')
+            return `[redacted: ${value.length} values]`;
+        if (depth >= MAX_DEPTH)
+            return `[truncated: array(${value.length})]`;
+        const items = value.slice(0, MAX_ARRAY_ITEMS).map((item) => defaultSanitize(item, depth + 1));
+        if (value.length > MAX_ARRAY_ITEMS)
+            items.push(`… [truncated ${value.length - MAX_ARRAY_ITEMS} more items]`);
+        return items;
+    }
+    if (value instanceof Error) {
+        return { name: value.name, message: defaultSanitize(value.message, depth + 1) };
+    }
+    if (typeof value === 'object' && value.constructor === Object) {
+        if (depth >= MAX_DEPTH)
+            return `[truncated: object(${Object.keys(value).length} keys)]`;
+        return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, defaultSanitize(v, depth + 1)]));
+    }
     return value;
 }
 let createLoggerFn = defaultCreateLogger;
 let sanitizeFn = defaultSanitize;
+/** Bumped on every setLoggerFactory() call; invalidates cached logger instances. */
+let factoryGeneration = 0;
 /**
  * Override the logger factory used by all protocol-internal logging.
  * Call this at application startup to wire in your project's logger.
@@ -44,6 +81,7 @@ export function setLoggerFactory(factory, sanitize) {
     createLoggerFn = factory;
     if (sanitize)
         sanitizeFn = sanitize;
+    factoryGeneration++;
 }
 // ═══════════════════════════════════════════════════════════════════════════════
 // PUBLIC API
@@ -52,9 +90,33 @@ export function setLoggerFactory(factory, sanitize) {
 export function sanitizeForLog(value) {
     return sanitizeFn(value);
 }
+/**
+ * Late-bound logger: resolves the current factory at emit time (cached per
+ * factory generation). This makes `const logger = log.lib.from('X')` at module
+ * import time safe — loggers created BEFORE the host calls `setLoggerFactory()`
+ * still pick up the rich implementation afterwards.
+ */
+function makeLateBoundLogger(context, source) {
+    let cached;
+    let cachedGeneration = -1;
+    const resolve = () => {
+        if (!cached || cachedGeneration !== factoryGeneration) {
+            cached = createLoggerFn(context, source);
+            cachedGeneration = factoryGeneration;
+        }
+        return cached;
+    };
+    return {
+        verbose: (msg, meta) => resolve().verbose(msg, meta),
+        debug: (msg, meta) => resolve().debug(msg, meta),
+        info: (msg, meta) => resolve().info(msg, meta),
+        warn: (msg, meta) => resolve().warn(msg, meta),
+        error: (msg, meta) => resolve().error(msg, meta),
+    };
+}
 function lazyContext(context) {
     return {
-        from: (source) => createLoggerFn(context, source),
+        from: (source) => makeLateBoundLogger(context, source),
     };
 }
 /**
@@ -64,8 +126,9 @@ function lazyContext(context) {
  * logger.info('started');
  * ```
  *
- * Logger creation is deferred to call time so `setLoggerFactory()` can be
- * called at app startup and all subsequent `.from()` calls use the new factory.
+ * Loggers are late-bound: the factory is resolved at emit time, so
+ * `setLoggerFactory()` at app startup upgrades even loggers that were created
+ * at module import time.
  */
 export const log = {
     protocol: lazyContext('protocol'),

package/dist/shared/observability/log.js.map

@@ -1 +1 @@
-{"version":3,"file":"log.js","sourceRoot":"/","sources":["shared/observability/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoBH,kFAAkF;AAClF,yBAAyB;AACzB,kFAAkF;AAElF,SAAS,mBAAmB,CAAC,QAAgB,EAAE,MAAc;IAC3D,MAAM,MAAM,GAAG,IAAI,MAAM,GAAG,CAAC;IAC7B,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3E,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACvE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACvE,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,KAAK,CAAC;AACf,CAAC;AASD,IAAI,cAAc,GAAkB,mBAAmB,CAAC;AACxD,IAAI,UAAU,GAAe,eAAe,CAAC;AAE7C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAsB,EAAE,QAAqB;IAC5E,cAAc,GAAG,OAAO,CAAC;IACzB,IAAI,QAAQ;QAAE,UAAU,GAAG,QAAQ,CAAC;AACtC,CAAC;AAED,kFAAkF;AAClF,aAAa;AACb,kFAAkF;AAElF,wFAAwF;AACxF,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO;QACL,IAAI,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1D,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC;IACjC,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC;IACvB,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC;IAC3B,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC;CAC5B,CAAC","sourcesContent":["/**\n * Protocol-internal logging module.\n *\n * Self-contained — no imports from outside the protocol library.\n * Ships with a minimal console-based default. The host application can\n * call `setLoggerFactory()` at startup to wire in a richer implementation\n * (e.g. the project-wide `log` utility with ANSI colors, context filtering,\n * and embedding redaction).\n */\n\n// ═══════════════════════════════════════════════════════════════════════════════\n// TYPES\n// ═══════════════════════════════════════════════════════════════════════════════\n\ntype LogMethod = (message: string, meta?: Record<string, unknown>) => void;\n\nexport type LoggerWithSource = {\n  verbose: LogMethod;\n  debug: LogMethod;\n  info: LogMethod;\n  warn: LogMethod;\n  error: LogMethod;\n};\n\nexport type LogContext = 'protocol' | 'lib' | 'agent' | 'graph';\n\nexport type LogLevel = 'verbose' | 'debug' | 'info' | 'warn' | 'error';\n\n// ═══════════════════════════════════════════════════════════════════════════════\n// DEFAULT IMPLEMENTATION\n// ═══════════════════════════════════════════════════════════════════════════════\n\nfunction defaultCreateLogger(_context: string, source: string): LoggerWithSource {\n  const prefix = `[${source}]`;\n  return {\n    verbose: (msg, meta) => console.debug(prefix, msg, ...(meta ? [meta] : [])),\n    debug: (msg, meta) => console.debug(prefix, msg, ...(meta ? [meta] : [])),\n    info: (msg, meta) => console.info(prefix, msg, ...(meta ? [meta] : [])),\n    warn: (msg, meta) => console.warn(prefix, msg, ...(meta ? [meta] : [])),\n    error: (msg, meta) => console.error(prefix, msg, ...(meta ? [meta] : [])),\n  };\n}\n\nfunction defaultSanitize(value: unknown): unknown {\n  return value;\n}\n\n// ═══════════════════════════════════════════════════════════════════════════════\n// PLUGGABLE FACTORY\n// ═══════════════════════════════════════════════════════════════════════════════\n\ntype LoggerFactory = (context: string, source: string) => LoggerWithSource;\ntype SanitizeFn = (value: unknown) => unknown;\n\nlet createLoggerFn: LoggerFactory = defaultCreateLogger;\nlet sanitizeFn: SanitizeFn = defaultSanitize;\n\n/**\n * Override the logger factory used by all protocol-internal logging.\n * Call this at application startup to wire in your project's logger.\n *\n * @example\n * ```ts\n * import { log, sanitizeForLog } from \"./lib/log.js\";\n * import { setLoggerFactory } from \"./lib/protocol/support/log.js\";\n *\n * setLoggerFactory(\n *   (context, source) => log.withContext(context as LogContext, source),\n *   sanitizeForLog,\n * );\n * ```\n */\nexport function setLoggerFactory(factory: LoggerFactory, sanitize?: SanitizeFn) {\n  createLoggerFn = factory;\n  if (sanitize) sanitizeFn = sanitize;\n}\n\n// ═══════════════════════════════════════════════════════════════════════════════\n// PUBLIC API\n// ═══════════════════════════════════════════════════════════════════════════════\n\n/** Sanitize an object for logging (redacts embeddings when host logger is wired in). */\nexport function sanitizeForLog(value: unknown): unknown {\n  return sanitizeFn(value);\n}\n\nfunction lazyContext(context: string) {\n  return {\n    from: (source: string) => createLoggerFn(context, source),\n  };\n}\n\n/**\n * Logger with pre-bound context. Usage:\n * ```ts\n * const logger = log.protocol.from('MyComponent');\n * logger.info('started');\n * ```\n *\n * Logger creation is deferred to call time so `setLoggerFactory()` can be\n * called at app startup and all subsequent `.from()` calls use the new factory.\n */\nexport const log = {\n  protocol: lazyContext('protocol'),\n  lib: lazyContext('lib'),\n  agent: lazyContext('agent'),\n  graph: lazyContext('graph'),\n};\n"]}
+{"version":3,"file":"log.js","sourceRoot":"/","sources":["shared/observability/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoBH,kFAAkF;AAClF,yBAAyB;AACzB,kFAAkF;AAElF,SAAS,mBAAmB,CAAC,QAAgB,EAAE,MAAc;IAC3D,MAAM,MAAM,GAAG,IAAI,MAAM,GAAG,CAAC;IAC7B,MAAM,IAAI,GAAG,CAAC,IAAkC,EAAE,GAAW,EAAE,IAA8B,EAAE,EAAE,CAC/F,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzD,OAAO;QACL,sCAAsC;QACtC,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC;QACtD,sCAAsC;QACtC,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC;QACpD,sCAAsC;QACtC,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC;QAClD,sCAAsC;QACtC,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC;QAClD,sCAAsC;QACtC,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,yFAAyF;AACzF,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAC/B,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,SAAS,GAAG,CAAC,CAAC;AAEpB,SAAS,eAAe,CAAC,KAAc,EAAE,KAAK,GAAG,CAAC;IAChD,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,MAAM,GAAG,iBAAiB;YACrC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,gBAAgB,KAAK,CAAC,MAAM,GAAG,iBAAiB,SAAS;YAC/F,CAAC,CAAC,KAAK,CAAC;IACZ,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ;YAAE,OAAO,cAAc,KAAK,CAAC,MAAM,UAAU,CAAC;QAClG,IAAI,KAAK,IAAI,SAAS;YAAE,OAAO,qBAAqB,KAAK,CAAC,MAAM,IAAI,CAAC;QACrE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QAC9F,IAAI,KAAK,CAAC,MAAM,GAAG,eAAe;YAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,MAAM,GAAG,eAAe,cAAc,CAAC,CAAC;QAC7G,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;IAClF,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;QAC9D,IAAI,KAAK,IAAI,SAAS;YAAE,OAAO,sBAAsB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,SAAS,CAAC;QACxF,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CACrG,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AASD,IAAI,cAAc,GAAkB,mBAAmB,CAAC;AACxD,IAAI,UAAU,GAAe,eAAe,CAAC;AAC7C,oFAAoF;AACpF,IAAI,iBAAiB,GAAG,CAAC,CAAC;AAE1B;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAsB,EAAE,QAAqB;IAC5E,cAAc,GAAG,OAAO,CAAC;IACzB,IAAI,QAAQ;QAAE,UAAU,GAAG,QAAQ,CAAC;IACpC,iBAAiB,EAAE,CAAC;AACtB,CAAC;AAED,kFAAkF;AAClF,aAAa;AACb,kFAAkF;AAElF,wFAAwF;AACxF,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,SAAS,mBAAmB,CAAC,OAAe,EAAE,MAAc;IAC1D,IAAI,MAAoC,CAAC;IACzC,IAAI,gBAAgB,GAAG,CAAC,CAAC,CAAC;IAC1B,MAAM,OAAO,GAAG,GAAqB,EAAE;QACrC,IAAI,CAAC,MAAM,IAAI,gBAAgB,KAAK,iBAAiB,EAAE,CAAC;YACtD,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACzC,gBAAgB,GAAG,iBAAiB,CAAC;QACvC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IACF,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC;QACpD,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC;QAChD,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC;QAC9C,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC;QAC9C,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC;KACjD,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO;QACL,IAAI,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC;IACjC,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC;IACvB,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC;IAC3B,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC;CAC5B,CAAC","sourcesContent":["/**\n * Protocol-internal logging module.\n *\n * Self-contained — no imports from outside the protocol library.\n * Ships with a minimal console-based default. The host application can\n * call `setLoggerFactory()` at startup to wire in a richer implementation\n * (e.g. the project-wide `log` utility with ANSI colors, context filtering,\n * and embedding redaction).\n */\n\n// ═══════════════════════════════════════════════════════════════════════════════\n// TYPES\n// ═══════════════════════════════════════════════════════════════════════════════\n\ntype LogMethod = (message: string, meta?: Record<string, unknown>) => void;\n\nexport type LoggerWithSource = {\n  verbose: LogMethod;\n  debug: LogMethod;\n  info: LogMethod;\n  warn: LogMethod;\n  error: LogMethod;\n};\n\nexport type LogContext = 'protocol' | 'lib' | 'agent' | 'graph';\n\nexport type LogLevel = 'verbose' | 'debug' | 'info' | 'warn' | 'error';\n\n// ═══════════════════════════════════════════════════════════════════════════════\n// DEFAULT IMPLEMENTATION\n// ═══════════════════════════════════════════════════════════════════════════════\n\nfunction defaultCreateLogger(_context: string, source: string): LoggerWithSource {\n  const prefix = `[${source}]`;\n  const emit = (sink: (...args: unknown[]) => void, msg: string, meta?: Record<string, unknown>) =>\n    sink(prefix, msg, ...(meta ? [sanitizeFn(meta)] : []));\n  return {\n    // eslint-disable-next-line no-console\n    verbose: (msg, meta) => emit(console.debug, msg, meta),\n    // eslint-disable-next-line no-console\n    debug: (msg, meta) => emit(console.debug, msg, meta),\n    // eslint-disable-next-line no-console\n    info: (msg, meta) => emit(console.info, msg, meta),\n    // eslint-disable-next-line no-console\n    warn: (msg, meta) => emit(console.warn, msg, meta),\n    // eslint-disable-next-line no-console\n    error: (msg, meta) => emit(console.error, msg, meta),\n  };\n}\n\n/** Truncation limits for the default (host-less) sanitizer — never dump big payloads. */\nconst MAX_STRING_LENGTH = 2000;\nconst MAX_ARRAY_ITEMS = 25;\nconst MAX_DEPTH = 6;\n\nfunction defaultSanitize(value: unknown, depth = 0): unknown {\n  if (value == null) return value;\n  if (typeof value === 'string') {\n    return value.length > MAX_STRING_LENGTH\n      ? `${value.slice(0, MAX_STRING_LENGTH)}… [truncated ${value.length - MAX_STRING_LENGTH} chars]`\n      : value;\n  }\n  if (Array.isArray(value)) {\n    if (value.length > 0 && typeof value[0] === 'number') return `[redacted: ${value.length} values]`;\n    if (depth >= MAX_DEPTH) return `[truncated: array(${value.length})]`;\n    const items = value.slice(0, MAX_ARRAY_ITEMS).map((item) => defaultSanitize(item, depth + 1));\n    if (value.length > MAX_ARRAY_ITEMS) items.push(`… [truncated ${value.length - MAX_ARRAY_ITEMS} more items]`);\n    return items;\n  }\n  if (value instanceof Error) {\n    return { name: value.name, message: defaultSanitize(value.message, depth + 1) };\n  }\n  if (typeof value === 'object' && value.constructor === Object) {\n    if (depth >= MAX_DEPTH) return `[truncated: object(${Object.keys(value).length} keys)]`;\n    return Object.fromEntries(\n      Object.entries(value as Record<string, unknown>).map(([k, v]) => [k, defaultSanitize(v, depth + 1)])\n    );\n  }\n  return value;\n}\n\n// ═══════════════════════════════════════════════════════════════════════════════\n// PLUGGABLE FACTORY\n// ═══════════════════════════════════════════════════════════════════════════════\n\ntype LoggerFactory = (context: string, source: string) => LoggerWithSource;\ntype SanitizeFn = (value: unknown) => unknown;\n\nlet createLoggerFn: LoggerFactory = defaultCreateLogger;\nlet sanitizeFn: SanitizeFn = defaultSanitize;\n/** Bumped on every setLoggerFactory() call; invalidates cached logger instances. */\nlet factoryGeneration = 0;\n\n/**\n * Override the logger factory used by all protocol-internal logging.\n * Call this at application startup to wire in your project's logger.\n *\n * @example\n * ```ts\n * import { log, sanitizeForLog } from \"./lib/log.js\";\n * import { setLoggerFactory } from \"./lib/protocol/support/log.js\";\n *\n * setLoggerFactory(\n *   (context, source) => log.withContext(context as LogContext, source),\n *   sanitizeForLog,\n * );\n * ```\n */\nexport function setLoggerFactory(factory: LoggerFactory, sanitize?: SanitizeFn) {\n  createLoggerFn = factory;\n  if (sanitize) sanitizeFn = sanitize;\n  factoryGeneration++;\n}\n\n// ═══════════════════════════════════════════════════════════════════════════════\n// PUBLIC API\n// ═══════════════════════════════════════════════════════════════════════════════\n\n/** Sanitize an object for logging (redacts embeddings when host logger is wired in). */\nexport function sanitizeForLog(value: unknown): unknown {\n  return sanitizeFn(value);\n}\n\n/**\n * Late-bound logger: resolves the current factory at emit time (cached per\n * factory generation). This makes `const logger = log.lib.from('X')` at module\n * import time safe — loggers created BEFORE the host calls `setLoggerFactory()`\n * still pick up the rich implementation afterwards.\n */\nfunction makeLateBoundLogger(context: string, source: string): LoggerWithSource {\n  let cached: LoggerWithSource | undefined;\n  let cachedGeneration = -1;\n  const resolve = (): LoggerWithSource => {\n    if (!cached || cachedGeneration !== factoryGeneration) {\n      cached = createLoggerFn(context, source);\n      cachedGeneration = factoryGeneration;\n    }\n    return cached;\n  };\n  return {\n    verbose: (msg, meta) => resolve().verbose(msg, meta),\n    debug: (msg, meta) => resolve().debug(msg, meta),\n    info: (msg, meta) => resolve().info(msg, meta),\n    warn: (msg, meta) => resolve().warn(msg, meta),\n    error: (msg, meta) => resolve().error(msg, meta),\n  };\n}\n\nfunction lazyContext(context: string) {\n  return {\n    from: (source: string) => makeLateBoundLogger(context, source),\n  };\n}\n\n/**\n * Logger with pre-bound context. Usage:\n * ```ts\n * const logger = log.protocol.from('MyComponent');\n * logger.info('started');\n * ```\n *\n * Loggers are late-bound: the factory is resolved at emit time, so\n * `setLoggerFactory()` at app startup upgrades even loggers that were created\n * at module import time.\n */\nexport const log = {\n  protocol: lazyContext('protocol'),\n  lib: lazyContext('lib'),\n  agent: lazyContext('agent'),\n  graph: lazyContext('graph'),\n};\n"]}

package/dist/shared/observability/protocol.logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.logger.d.ts","sourceRoot":"/","sources":["shared/observability/protocol.logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAE/D;AAED,MAAM,WAAW,cAAc;IAC7B,qFAAqF;IACrF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC,CA2BZ"}
+{"version":3,"file":"protocol.logger.d.ts","sourceRoot":"/","sources":["shared/observability/protocol.logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAE/D;AAED,MAAM,WAAW,cAAc;IAC7B,qFAAqF;IACrF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC,CA6BZ"}

package/dist/shared/observability/protocol.logger.js

@@ -17,23 +17,25 @@ export async function withCallLogging(logger, callName, inputs, fn, options = {}
     const { logOutput = true, context = {} } = options;
     const start = Date.now();
     const sanitizedInputs = sanitizeForLog(inputs);
-    logger.verbose(`[Call] ${callName} start`, { inputs: sanitizedInputs, ...context });
+    logger.verbose('call start', { callName, inputs: sanitizedInputs, ...context });
     try {
         const result = await fn();
         const durationMs = Date.now() - start;
         const outMeta = {
+            callName,
             durationMs,
             ...context,
         };
         if (logOutput) {
             outMeta.output = sanitizeForLog(result);
         }
-        logger.verbose(`[Call] ${callName} end`, outMeta);
+        logger.verbose('call end', outMeta);
         return result;
     }
     catch (err) {
         const durationMs = Date.now() - start;
-        logger.error(`[Call] ${callName} failed`, {
+        logger.error('call failed', {
+            callName,
             error: err,
             durationMs,
             ...context,

package/dist/shared/observability/protocol.logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.logger.js","sourceRoot":"/","sources":["shared/observability/protocol.logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAK/C,uFAAuF;AACvF,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AASD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAwB,EACxB,QAAgB,EAChB,MAA+B,EAC/B,EAAoB,EACpB,UAA0B,EAAE;IAE5B,MAAM,EAAE,SAAS,GAAG,IAAI,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,eAAe,GAAG,cAAc,CAAC,MAAM,CAA4B,CAAC;IAC1E,MAAM,CAAC,OAAO,CAAC,UAAU,QAAQ,QAAQ,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAEpF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACtC,MAAM,OAAO,GAA4B;YACvC,UAAU;YACV,GAAG,OAAO;SACX,CAAC;QACF,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,UAAU,QAAQ,MAAM,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,UAAU,QAAQ,SAAS,EAAE;YACxC,KAAK,EAAE,GAAG;YACV,UAAU;YACV,GAAG,OAAO;SACX,CAAC,CAAC;QACH,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC","sourcesContent":["/**\n * Protocol-layer logging: call-scoped inputs, outputs, and context for debugging.\n * Use protocolLogger('ComponentName') for the logger, then wrap calls with\n * withCallLogging. All protocol code should log inputs at call start and\n * outputs (or summary) + duration at end.\n */\n\nimport { log, sanitizeForLog } from \"./log.js\";\nimport type { LoggerWithSource } from \"./log.js\";\n\nexport type { LoggerWithSource };\n\n/** Create a protocol logger for a given source (e.g. \"ChatTools\", \"DiscoverNodes\"). */\nexport function protocolLogger(source: string): LoggerWithSource {\n  return log.protocol.from(source);\n}\n\nexport interface CallLogOptions {\n  /** Log full output on success (default: true). Set false for very large payloads. */\n  logOutput?: boolean;\n  /** Extra context to include in both start and end (e.g. userId, networkId). */\n  context?: Record<string, unknown>;\n}\n\n/**\n * Wraps an async call with consistent logging: inputs at start, outputs + duration at end,\n * error + duration on failure. All payloads are sanitized (embeddings redacted).\n */\nexport async function withCallLogging<T>(\n  logger: LoggerWithSource,\n  callName: string,\n  inputs: Record<string, unknown>,\n  fn: () => Promise<T>,\n  options: CallLogOptions = {}\n): Promise<T> {\n  const { logOutput = true, context = {} } = options;\n  const start = Date.now();\n  const sanitizedInputs = sanitizeForLog(inputs) as Record<string, unknown>;\n  logger.verbose(`[Call] ${callName} start`, { inputs: sanitizedInputs, ...context });\n\n  try {\n    const result = await fn();\n    const durationMs = Date.now() - start;\n    const outMeta: Record<string, unknown> = {\n      durationMs,\n      ...context,\n    };\n    if (logOutput) {\n      outMeta.output = sanitizeForLog(result);\n    }\n    logger.verbose(`[Call] ${callName} end`, outMeta);\n    return result;\n  } catch (err) {\n    const durationMs = Date.now() - start;\n    logger.error(`[Call] ${callName} failed`, {\n      error: err,\n      durationMs,\n      ...context,\n    });\n    throw err;\n  }\n}\n"]}
+{"version":3,"file":"protocol.logger.js","sourceRoot":"/","sources":["shared/observability/protocol.logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAK/C,uFAAuF;AACvF,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AASD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAwB,EACxB,QAAgB,EAChB,MAA+B,EAC/B,EAAoB,EACpB,UAA0B,EAAE;IAE5B,MAAM,EAAE,SAAS,GAAG,IAAI,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,eAAe,GAAG,cAAc,CAAC,MAAM,CAA4B,CAAC;IAC1E,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAEhF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACtC,MAAM,OAAO,GAA4B;YACvC,QAAQ;YACR,UAAU;YACV,GAAG,OAAO;SACX,CAAC;QACF,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACpC,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE;YAC1B,QAAQ;YACR,KAAK,EAAE,GAAG;YACV,UAAU;YACV,GAAG,OAAO;SACX,CAAC,CAAC;QACH,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC","sourcesContent":["/**\n * Protocol-layer logging: call-scoped inputs, outputs, and context for debugging.\n * Use protocolLogger('ComponentName') for the logger, then wrap calls with\n * withCallLogging. All protocol code should log inputs at call start and\n * outputs (or summary) + duration at end.\n */\n\nimport { log, sanitizeForLog } from \"./log.js\";\nimport type { LoggerWithSource } from \"./log.js\";\n\nexport type { LoggerWithSource };\n\n/** Create a protocol logger for a given source (e.g. \"ChatTools\", \"DiscoverNodes\"). */\nexport function protocolLogger(source: string): LoggerWithSource {\n  return log.protocol.from(source);\n}\n\nexport interface CallLogOptions {\n  /** Log full output on success (default: true). Set false for very large payloads. */\n  logOutput?: boolean;\n  /** Extra context to include in both start and end (e.g. userId, networkId). */\n  context?: Record<string, unknown>;\n}\n\n/**\n * Wraps an async call with consistent logging: inputs at start, outputs + duration at end,\n * error + duration on failure. All payloads are sanitized (embeddings redacted).\n */\nexport async function withCallLogging<T>(\n  logger: LoggerWithSource,\n  callName: string,\n  inputs: Record<string, unknown>,\n  fn: () => Promise<T>,\n  options: CallLogOptions = {}\n): Promise<T> {\n  const { logOutput = true, context = {} } = options;\n  const start = Date.now();\n  const sanitizedInputs = sanitizeForLog(inputs) as Record<string, unknown>;\n  logger.verbose('call start', { callName, inputs: sanitizedInputs, ...context });\n\n  try {\n    const result = await fn();\n    const durationMs = Date.now() - start;\n    const outMeta: Record<string, unknown> = {\n      callName,\n      durationMs,\n      ...context,\n    };\n    if (logOutput) {\n      outMeta.output = sanitizeForLog(result);\n    }\n    logger.verbose('call end', outMeta);\n    return result;\n  } catch (err) {\n    const durationMs = Date.now() - start;\n    logger.error('call failed', {\n      callName,\n      error: err,\n      durationMs,\n      ...context,\n    });\n    throw err;\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "4.5.0-rc.322.1",
+  "version": "4.5.0-rc.324.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -22,10 +22,10 @@
     "test": "bun test",
     "test:isolated": "bun scripts/test.ts",
     "prepublishOnly": "bun run build",
-    "eval:matching": "bun --env-file=.env.test ./eval/matching/matching.eval.ts",
-    "eval:premise": "bun --env-file=.env.test ./eval/premise/premise.eval.ts",
-    "eval:profile": "bun --env-file=.env.test ./eval/profile/profile.eval.ts",
-    "eval:opportunity": "bun --env-file=.env.test ./eval/opportunity/opportunity.eval.ts"
+    "eval:matching": "bun --env-file=../../.env.test ./eval/matching/matching.eval.ts",
+    "eval:premise": "bun --env-file=../../.env.test ./eval/premise/premise.eval.ts",
+    "eval:profile": "bun --env-file=../../.env.test ./eval/profile/profile.eval.ts",
+    "eval:opportunity": "bun --env-file=../../.env.test ./eval/opportunity/opportunity.eval.ts"
   },
   "dependencies": {
     "@langchain/core": "^1.1.17",