@juspay/neurolink 10.8.14 → 10.8.16

package/dist/cli/factories/sagemakerCommandFactory.js

@@ -2,19 +2,10 @@ import chalk from "chalk";
 import ora from "ora";
 import inquirer from "inquirer";
 async function loadSageMakerControl() {
-    try {
-        return await import(/* @vite-ignore */ "@aws-sdk/client-sagemaker");
-    }
-    catch (err) {
-        const e = err instanceof Error ? err : null;
-        if (e?.code === "ERR_MODULE_NOT_FOUND" &&
-            e.message.includes("client-sagemaker")) {
-            throw new Error('SageMaker setup requires "@aws-sdk/client-sagemaker". Install it with:\n  pnpm add @aws-sdk/client-sagemaker', { cause: err });
-        }
-        throw err;
-    }
+    return tryImport("@aws-sdk/client-sagemaker", "SageMaker setup");
 }
 import { logger } from "../../lib/utils/logger.js";
+import { tryImport } from "../../lib/utils/tryImport.js";
 import { checkSageMakerConfiguration, getSageMakerConfig, getConfigurationSummary, clearConfigurationCache, } from "../../lib/providers/sagemaker/config.js";
 import { AmazonSageMakerProvider } from "../../lib/providers/sagemaker/index.js";
 import { runQuickDiagnostics, formatDiagnosticReport, } from "../../lib/providers/sagemaker/diagnostics.js";

package/dist/core/baseProvider.js

@@ -90,7 +90,7 @@ export class BaseProvider {
         this.messageBuilder = new MessageBuilder(this.providerName, this.modelName);
         this.streamHandler = new StreamHandler(this.providerName, this.modelName);
         this.telemetryHandler = new TelemetryHandler(this.providerName, this.modelName, this.neurolink);
-        this.generationHandler = new GenerationHandler(this.providerName, this.modelName, () => this.supportsTools(), (options, type) => this.telemetryHandler.getTelemetryConfig(options, type), (toolCalls, toolResults, options, timestamp) => this.handleToolExecutionStorage(toolCalls, toolResults, options, timestamp), () => this.neurolink?.getEventEmitter());
+        this.generationHandler = new GenerationHandler(this.providerName, this.modelName, () => this.supportsTools(), (options, type) => this.telemetryHandler.getTelemetryConfig(options, type), (toolCalls, toolResults, options, timestamp) => this.handleToolExecutionStorage(toolCalls, toolResults, options, timestamp), { getEmitterFn: () => this.neurolink?.getEventEmitter() });
         this.utilities = new Utilities(this.providerName, this.modelName, this.defaultTimeout, this.middlewareOptions);
         this.toolsManager = new ToolsManager(this.providerName, this.directTools, this.neurolink, {
             isZodSchema: (schema) => this.isZodSchema(schema),
@@ -115,7 +115,7 @@ export class BaseProvider {
         this.messageBuilder = new MessageBuilder(this.providerName, this.modelName);
         this.streamHandler = new StreamHandler(this.providerName, this.modelName);
         this.telemetryHandler = new TelemetryHandler(this.providerName, this.modelName, this.neurolink);
-        this.generationHandler = new GenerationHandler(this.providerName, this.modelName, () => this.supportsTools(), (options, type) => this.telemetryHandler.getTelemetryConfig(options, type), (toolCalls, toolResults, options, timestamp) => this.handleToolExecutionStorage(toolCalls, toolResults, options, timestamp), () => this.neurolink?.getEventEmitter());
+        this.generationHandler = new GenerationHandler(this.providerName, this.modelName, () => this.supportsTools(), (options, type) => this.telemetryHandler.getTelemetryConfig(options, type), (toolCalls, toolResults, options, timestamp) => this.handleToolExecutionStorage(toolCalls, toolResults, options, timestamp), { getEmitterFn: () => this.neurolink?.getEventEmitter() });
         this.utilities = new Utilities(this.providerName, this.modelName, this.defaultTimeout, this.middlewareOptions);
     }
     /**

package/dist/core/modules/GenerationHandler.d.ts

@@ -48,12 +48,44 @@ export declare class GenerationHandler {
     private readonly supportsToolsFn;
     private readonly getTelemetryConfigFn;
     private readonly handleToolStorageFn;
-    private readonly getEmitterFn?;
+    /**
+     * The remaining, optional dependencies.
+     *
+     * Grouped rather than added as further positional parameters: the
+     * constructor is already at the six-parameter cap, and both of these are
+     * optional injection seams rather than required collaborators.
+     *
+     * `generateTextFn` exists because every other dependency of this class
+     * arrives through the constructor while `generateText` was reached by
+     * static import. `utils/generation.ts` is a bare re-export of `ai`, and an
+     * ESM re-export cannot be substituted from a test, so asserting on the
+     * arguments this class builds — the entire contract of the system-message
+     * hoisting below — had no seam to work through. Production passes neither.
+     */
+    private readonly deps;
     constructor(providerName: AIProviderName, modelName: string, supportsToolsFn: () => boolean, getTelemetryConfigFn: (options: TextGenerationOptions, type: string) => {
         isEnabled: boolean;
         functionId?: string;
         metadata?: Record<string, string | number | boolean>;
-    } | undefined, handleToolStorageFn: (toolCalls: unknown[], toolResults: unknown[], options: TextGenerationOptions, timestamp: Date) => Promise<void>, getEmitterFn?: (() => TypedEventEmitter<NeuroLinkEvents> | undefined) | undefined);
+    } | undefined, handleToolStorageFn: (toolCalls: unknown[], toolResults: unknown[], options: TextGenerationOptions, timestamp: Date) => Promise<void>, 
+    /**
+     * The remaining, optional dependencies.
+     *
+     * Grouped rather than added as further positional parameters: the
+     * constructor is already at the six-parameter cap, and both of these are
+     * optional injection seams rather than required collaborators.
+     *
+     * `generateTextFn` exists because every other dependency of this class
+     * arrives through the constructor while `generateText` was reached by
+     * static import. `utils/generation.ts` is a bare re-export of `ai`, and an
+     * ESM re-export cannot be substituted from a test, so asserting on the
+     * arguments this class builds — the entire contract of the system-message
+     * hoisting below — had no seam to work through. Production passes neither.
+     */
+    deps?: {
+        getEmitterFn?: () => TypedEventEmitter<NeuroLinkEvents> | undefined;
+        generateTextFn?: typeof generateText;
+    });
     /**
      * Helper method to call generateText with optional structured output
      * @private

package/dist/core/modules/GenerationHandler.js

@@ -159,14 +159,29 @@ export class GenerationHandler {
     supportsToolsFn;
     getTelemetryConfigFn;
     handleToolStorageFn;
-    getEmitterFn;
-    constructor(providerName, modelName, supportsToolsFn, getTelemetryConfigFn, handleToolStorageFn, getEmitterFn) {
+    deps;
+    constructor(providerName, modelName, supportsToolsFn, getTelemetryConfigFn, handleToolStorageFn, 
+    /**
+     * The remaining, optional dependencies.
+     *
+     * Grouped rather than added as further positional parameters: the
+     * constructor is already at the six-parameter cap, and both of these are
+     * optional injection seams rather than required collaborators.
+     *
+     * `generateTextFn` exists because every other dependency of this class
+     * arrives through the constructor while `generateText` was reached by
+     * static import. `utils/generation.ts` is a bare re-export of `ai`, and an
+     * ESM re-export cannot be substituted from a test, so asserting on the
+     * arguments this class builds — the entire contract of the system-message
+     * hoisting below — had no seam to work through. Production passes neither.
+     */
+    deps = {}) {
         this.providerName = providerName;
         this.modelName = modelName;
         this.supportsToolsFn = supportsToolsFn;
         this.getTelemetryConfigFn = getTelemetryConfigFn;
         this.handleToolStorageFn = handleToolStorageFn;
-        this.getEmitterFn = getEmitterFn;
+        this.deps = deps;
     }
     /**
      * Helper method to call generateText with optional structured output
@@ -265,7 +280,7 @@ export class GenerationHandler {
         const samplingParams = resolveSamplingParams(this.providerName, getModelId(model, this.modelName || ""), options.temperature !== undefined
             ? { temperature: options.temperature }
             : {}, "aiSdk.generateText");
-        const result = await generateText({
+        const result = await (this.deps.generateTextFn ?? generateText)({
             model,
             ...(system && { system }),
             messages: nonSystemMessages,
@@ -364,7 +379,7 @@ export class GenerationHandler {
                 // This surfaces AI-SDK-driven tool completions as telemetry events
                 // so that tool spans are created even when the SDK runs tools
                 // internally (gaps G5 / S2).
-                emitToolEndFromStepFinish(this.getEmitterFn?.(), toolResults);
+                emitToolEndFromStepFinish(this.deps.getEmitterFn?.(), toolResults);
                 // Handle tool execution storage
                 this.handleToolStorageFn(toolCalls, toolResults, options, new Date()).catch((error) => {
                     logger.warn("[GenerationHandler] Failed to store tool executions", {

package/dist/features/ppt/slideGenerator.js

@@ -21,26 +21,18 @@ export async function loadPptxGenJS() {
     if (_pptxGenJS) {
         return _pptxGenJS;
     }
-    try {
-        const mod = await import(/* @vite-ignore */ "pptxgenjs");
-        // ESM/CJS interop: pptxgenjs v4 may double-wrap the default export.
-        // The runtime shape is genuinely dynamic, so probe it as `unknown`.
-        const rawDefault = mod.default;
-        const Ctor = typeof rawDefault === "function"
-            ? rawDefault
-            : rawDefault.default;
-        _pptxGenJS = Ctor;
-        return _pptxGenJS;
-    }
-    catch (err) {
-        const e = err instanceof Error ? err : null;
-        if (e?.code === "ERR_MODULE_NOT_FOUND" && e.message.includes("pptxgenjs")) {
-            throw new Error('PPT generation requires the "pptxgenjs" package. Install it with:\n  pnpm add pptxgenjs', { cause: err });
-        }
-        throw err;
-    }
+    const mod = await tryImport("pptxgenjs", "PPT generation");
+    // ESM/CJS interop: pptxgenjs v4 may double-wrap the default export.
+    // The runtime shape is genuinely dynamic, so probe it as `unknown`.
+    const rawDefault = mod.default;
+    const Ctor = typeof rawDefault === "function"
+        ? rawDefault
+        : rawDefault.default;
+    _pptxGenJS = Ctor;
+    return _pptxGenJS;
 }
 import { logger } from "../../utils/logger.js";
+import { tryImport } from "../../utils/tryImport.js";
 import { withTimeout, ErrorFactory, NeuroLinkError, } from "../../utils/errorHandling.js";
 import { SpanSerializer, SpanType, SpanStatus, getMetricsAggregator, } from "../../observability/index.js";
 import { LAYOUT_POSITIONS, renderTitleSlide, renderSectionHeaderSlide, renderThankYouSlide, renderContentSlide, renderImageSlide, renderTwoColumnSlide, renderThreeColumnSlide, renderQuoteSlide, renderStatisticsSlide, renderChartSlide, renderTableSlide, renderTimelineSlide, renderProcessFlowSlide, renderComparisonSlide, renderFeaturesSlide, renderTeamSlide, renderConclusionSlide, renderDashboardSlide, renderMixedContentSlide, renderStatsGridSlide, renderIconGridSlide, } from "./slideRenderers.js";

package/dist/lib/core/baseProvider.js

@@ -90,7 +90,7 @@ export class BaseProvider {
         this.messageBuilder = new MessageBuilder(this.providerName, this.modelName);
         this.streamHandler = new StreamHandler(this.providerName, this.modelName);
         this.telemetryHandler = new TelemetryHandler(this.providerName, this.modelName, this.neurolink);
-        this.generationHandler = new GenerationHandler(this.providerName, this.modelName, () => this.supportsTools(), (options, type) => this.telemetryHandler.getTelemetryConfig(options, type), (toolCalls, toolResults, options, timestamp) => this.handleToolExecutionStorage(toolCalls, toolResults, options, timestamp), () => this.neurolink?.getEventEmitter());
+        this.generationHandler = new GenerationHandler(this.providerName, this.modelName, () => this.supportsTools(), (options, type) => this.telemetryHandler.getTelemetryConfig(options, type), (toolCalls, toolResults, options, timestamp) => this.handleToolExecutionStorage(toolCalls, toolResults, options, timestamp), { getEmitterFn: () => this.neurolink?.getEventEmitter() });
         this.utilities = new Utilities(this.providerName, this.modelName, this.defaultTimeout, this.middlewareOptions);
         this.toolsManager = new ToolsManager(this.providerName, this.directTools, this.neurolink, {
             isZodSchema: (schema) => this.isZodSchema(schema),
@@ -115,7 +115,7 @@ export class BaseProvider {
         this.messageBuilder = new MessageBuilder(this.providerName, this.modelName);
         this.streamHandler = new StreamHandler(this.providerName, this.modelName);
         this.telemetryHandler = new TelemetryHandler(this.providerName, this.modelName, this.neurolink);
-        this.generationHandler = new GenerationHandler(this.providerName, this.modelName, () => this.supportsTools(), (options, type) => this.telemetryHandler.getTelemetryConfig(options, type), (toolCalls, toolResults, options, timestamp) => this.handleToolExecutionStorage(toolCalls, toolResults, options, timestamp), () => this.neurolink?.getEventEmitter());
+        this.generationHandler = new GenerationHandler(this.providerName, this.modelName, () => this.supportsTools(), (options, type) => this.telemetryHandler.getTelemetryConfig(options, type), (toolCalls, toolResults, options, timestamp) => this.handleToolExecutionStorage(toolCalls, toolResults, options, timestamp), { getEmitterFn: () => this.neurolink?.getEventEmitter() });
         this.utilities = new Utilities(this.providerName, this.modelName, this.defaultTimeout, this.middlewareOptions);
     }
     /**

package/dist/lib/core/modules/GenerationHandler.d.ts

@@ -48,12 +48,44 @@ export declare class GenerationHandler {
     private readonly supportsToolsFn;
     private readonly getTelemetryConfigFn;
     private readonly handleToolStorageFn;
-    private readonly getEmitterFn?;
+    /**
+     * The remaining, optional dependencies.
+     *
+     * Grouped rather than added as further positional parameters: the
+     * constructor is already at the six-parameter cap, and both of these are
+     * optional injection seams rather than required collaborators.
+     *
+     * `generateTextFn` exists because every other dependency of this class
+     * arrives through the constructor while `generateText` was reached by
+     * static import. `utils/generation.ts` is a bare re-export of `ai`, and an
+     * ESM re-export cannot be substituted from a test, so asserting on the
+     * arguments this class builds — the entire contract of the system-message
+     * hoisting below — had no seam to work through. Production passes neither.
+     */
+    private readonly deps;
     constructor(providerName: AIProviderName, modelName: string, supportsToolsFn: () => boolean, getTelemetryConfigFn: (options: TextGenerationOptions, type: string) => {
         isEnabled: boolean;
         functionId?: string;
         metadata?: Record<string, string | number | boolean>;
-    } | undefined, handleToolStorageFn: (toolCalls: unknown[], toolResults: unknown[], options: TextGenerationOptions, timestamp: Date) => Promise<void>, getEmitterFn?: (() => TypedEventEmitter<NeuroLinkEvents> | undefined) | undefined);
+    } | undefined, handleToolStorageFn: (toolCalls: unknown[], toolResults: unknown[], options: TextGenerationOptions, timestamp: Date) => Promise<void>, 
+    /**
+     * The remaining, optional dependencies.
+     *
+     * Grouped rather than added as further positional parameters: the
+     * constructor is already at the six-parameter cap, and both of these are
+     * optional injection seams rather than required collaborators.
+     *
+     * `generateTextFn` exists because every other dependency of this class
+     * arrives through the constructor while `generateText` was reached by
+     * static import. `utils/generation.ts` is a bare re-export of `ai`, and an
+     * ESM re-export cannot be substituted from a test, so asserting on the
+     * arguments this class builds — the entire contract of the system-message
+     * hoisting below — had no seam to work through. Production passes neither.
+     */
+    deps?: {
+        getEmitterFn?: () => TypedEventEmitter<NeuroLinkEvents> | undefined;
+        generateTextFn?: typeof generateText;
+    });
     /**
      * Helper method to call generateText with optional structured output
      * @private

package/dist/lib/core/modules/GenerationHandler.js

@@ -159,14 +159,29 @@ export class GenerationHandler {
     supportsToolsFn;
     getTelemetryConfigFn;
     handleToolStorageFn;
-    getEmitterFn;
-    constructor(providerName, modelName, supportsToolsFn, getTelemetryConfigFn, handleToolStorageFn, getEmitterFn) {
+    deps;
+    constructor(providerName, modelName, supportsToolsFn, getTelemetryConfigFn, handleToolStorageFn, 
+    /**
+     * The remaining, optional dependencies.
+     *
+     * Grouped rather than added as further positional parameters: the
+     * constructor is already at the six-parameter cap, and both of these are
+     * optional injection seams rather than required collaborators.
+     *
+     * `generateTextFn` exists because every other dependency of this class
+     * arrives through the constructor while `generateText` was reached by
+     * static import. `utils/generation.ts` is a bare re-export of `ai`, and an
+     * ESM re-export cannot be substituted from a test, so asserting on the
+     * arguments this class builds — the entire contract of the system-message
+     * hoisting below — had no seam to work through. Production passes neither.
+     */
+    deps = {}) {
         this.providerName = providerName;
         this.modelName = modelName;
         this.supportsToolsFn = supportsToolsFn;
         this.getTelemetryConfigFn = getTelemetryConfigFn;
         this.handleToolStorageFn = handleToolStorageFn;
-        this.getEmitterFn = getEmitterFn;
+        this.deps = deps;
     }
     /**
      * Helper method to call generateText with optional structured output
@@ -265,7 +280,7 @@ export class GenerationHandler {
         const samplingParams = resolveSamplingParams(this.providerName, getModelId(model, this.modelName || ""), options.temperature !== undefined
             ? { temperature: options.temperature }
             : {}, "aiSdk.generateText");
-        const result = await generateText({
+        const result = await (this.deps.generateTextFn ?? generateText)({
             model,
             ...(system && { system }),
             messages: nonSystemMessages,
@@ -364,7 +379,7 @@ export class GenerationHandler {
                 // This surfaces AI-SDK-driven tool completions as telemetry events
                 // so that tool spans are created even when the SDK runs tools
                 // internally (gaps G5 / S2).
-                emitToolEndFromStepFinish(this.getEmitterFn?.(), toolResults);
+                emitToolEndFromStepFinish(this.deps.getEmitterFn?.(), toolResults);
                 // Handle tool execution storage
                 this.handleToolStorageFn(toolCalls, toolResults, options, new Date()).catch((error) => {
                     logger.warn("[GenerationHandler] Failed to store tool executions", {

package/dist/lib/features/ppt/slideGenerator.js

@@ -21,26 +21,18 @@ export async function loadPptxGenJS() {
     if (_pptxGenJS) {
         return _pptxGenJS;
     }
-    try {
-        const mod = await import(/* @vite-ignore */ "pptxgenjs");
-        // ESM/CJS interop: pptxgenjs v4 may double-wrap the default export.
-        // The runtime shape is genuinely dynamic, so probe it as `unknown`.
-        const rawDefault = mod.default;
-        const Ctor = typeof rawDefault === "function"
-            ? rawDefault
-            : rawDefault.default;
-        _pptxGenJS = Ctor;
-        return _pptxGenJS;
-    }
-    catch (err) {
-        const e = err instanceof Error ? err : null;
-        if (e?.code === "ERR_MODULE_NOT_FOUND" && e.message.includes("pptxgenjs")) {
-            throw new Error('PPT generation requires the "pptxgenjs" package. Install it with:\n  pnpm add pptxgenjs', { cause: err });
-        }
-        throw err;
-    }
+    const mod = await tryImport("pptxgenjs", "PPT generation");
+    // ESM/CJS interop: pptxgenjs v4 may double-wrap the default export.
+    // The runtime shape is genuinely dynamic, so probe it as `unknown`.
+    const rawDefault = mod.default;
+    const Ctor = typeof rawDefault === "function"
+        ? rawDefault
+        : rawDefault.default;
+    _pptxGenJS = Ctor;
+    return _pptxGenJS;
 }
 import { logger } from "../../utils/logger.js";
+import { tryImport } from "../../utils/tryImport.js";
 import { withTimeout, ErrorFactory, NeuroLinkError, } from "../../utils/errorHandling.js";
 import { SpanSerializer, SpanType, SpanStatus, getMetricsAggregator, } from "../../observability/index.js";
 import { NeuroLink } from "../../neurolink.js";

package/dist/lib/processors/document/ExcelProcessor.js

@@ -38,30 +38,22 @@
 import { BaseFileProcessor } from "../base/BaseFileProcessor.js";
 import { SIZE_LIMITS } from "../config/index.js";
 import { FileErrorCode } from "../errors/index.js";
+import { tryImport } from "../../utils/tryImport.js";
 let _exceljs = null;
 async function loadExcelJS() {
     if (_exceljs) {
         return _exceljs;
     }
-    try {
-        const mod = await import(/* @vite-ignore */ "exceljs");
-        // exceljs is a CommonJS module. Under Node ESM (and some bundlers) the
-        // `Workbook` constructor is exposed at runtime on the namespace's `default`
-        // export rather than on the namespace itself — so a bare
-        // `new ExcelJS.Workbook()` throws "ExcelJS.Workbook is not a constructor"
-        // (TS still types it as present via esModuleInterop, masking the bug).
-        // Normalise here so the constructor is reachable regardless of interop style.
-        const ns = mod;
-        _exceljs = (ns.Workbook ? ns : (ns.default ?? ns));
-        return _exceljs;
-    }
-    catch (err) {
-        const e = err instanceof Error ? err : null;
-        if (e?.code === "ERR_MODULE_NOT_FOUND" && e.message.includes("exceljs")) {
-            throw new Error('Excel file processing requires the "exceljs" package. Install it with:\n  pnpm add exceljs', { cause: err });
-        }
-        throw err;
-    }
+    const mod = await tryImport("exceljs", "Excel file processing");
+    // exceljs is a CommonJS module. Under Node ESM (and some bundlers) the
+    // `Workbook` constructor is exposed at runtime on the namespace's `default`
+    // export rather than on the namespace itself — so a bare
+    // `new ExcelJS.Workbook()` throws "ExcelJS.Workbook is not a constructor"
+    // (TS still types it as present via esModuleInterop, masking the bug).
+    // Normalise here so the constructor is reachable regardless of interop style.
+    const ns = mod;
+    _exceljs = (ns.Workbook ? ns : (ns.default ?? ns));
+    return _exceljs;
 }
 // Re-export for consumers who import from this module
 // Import for local use

package/dist/lib/processors/document/WordProcessor.js

@@ -34,22 +34,14 @@
 import { BaseFileProcessor } from "../base/BaseFileProcessor.js";
 import { SIZE_LIMITS } from "../config/index.js";
 import { FileErrorCode } from "../errors/index.js";
+import { tryImport } from "../../utils/tryImport.js";
 let _mammoth = null;
 async function loadMammoth() {
     if (_mammoth) {
         return _mammoth;
     }
-    try {
-        _mammoth = await import(/* @vite-ignore */ "mammoth");
-        return _mammoth;
-    }
-    catch (err) {
-        const e = err instanceof Error ? err : null;
-        if (e?.code === "ERR_MODULE_NOT_FOUND" && e.message.includes("mammoth")) {
-            throw new Error('Word document processing requires the "mammoth" package. Install it with:\n  pnpm add mammoth', { cause: err });
-        }
-        throw err;
-    }
+    _mammoth = await tryImport("mammoth", "Word document processing");
+    return _mammoth;
 }
 // Re-export for consumers who import from this module
 // Import for local use

package/dist/lib/processors/media/AudioProcessor.js

@@ -41,23 +41,14 @@ import { SIZE_LIMITS_MB } from "../config/index.js";
 import { FileErrorCode } from "../errors/index.js";
 import { withTimeout } from "../../utils/timeout.js";
 import { formatMediaDuration } from "../../utils/mediaDuration.js";
+import { tryImport } from "../../utils/tryImport.js";
 let _musicMetadata = null;
 async function loadMusicMetadata() {
     if (_musicMetadata) {
         return _musicMetadata;
     }
-    try {
-        _musicMetadata = await import(/* @vite-ignore */ "music-metadata");
-        return _musicMetadata;
-    }
-    catch (err) {
-        const e = err instanceof Error ? err : null;
-        if (e?.code === "ERR_MODULE_NOT_FOUND" &&
-            e.message.includes("music-metadata")) {
-            throw new Error('Audio processing requires the "music-metadata" package. Install it with:\n  pnpm add music-metadata', { cause: err });
-        }
-        throw err;
-    }
+    _musicMetadata = await tryImport("music-metadata", "Audio processing");
+    return _musicMetadata;
 }
 // =============================================================================
 // TYPES

package/dist/lib/processors/media/VideoProcessor.d.ts

@@ -45,6 +45,17 @@
  */
 import { BaseFileProcessor } from "../base/BaseFileProcessor.js";
 import type { FileInfo, ProcessedVideo, ProcessorFileProcessingResult, ProcessOptions } from "../../types/index.js";
+/**
+ * Narrow a loaded `fluent-ffmpeg` export to the shape this file actually uses:
+ * a callable carrying the `ffprobe` and `setFfmpegPath` statics.
+ *
+ * `tryImport` proves only that the package RESOLVES. Callers invoke the export
+ * and reach straight for its statics, so a package whose shape changed (ESM
+ * rewrite, major bump, a shim in node_modules) would otherwise surface as
+ * "Cannot read properties of undefined (reading 'ffprobe')" from inside
+ * probeVideo — blaming the call site instead of the package that is wrong.
+ */
+export declare function assertFluentFfmpegShape(mod: unknown): asserts mod is typeof import("fluent-ffmpeg");
 /**
  * Video Processor - extracts metadata, keyframes, and subtitles from video files.
  *

package/dist/lib/processors/media/VideoProcessor.js

@@ -55,39 +55,48 @@ import { SIZE_LIMITS_MB } from "../config/index.js";
 import { FileErrorCode } from "../errors/index.js";
 import { tracers, ATTR, withSpan } from "../../telemetry/index.js";
 import { logger } from "../../utils/logger.js";
+import { tryImport } from "../../utils/tryImport.js";
+/**
+ * Narrow a loaded `fluent-ffmpeg` export to the shape this file actually uses:
+ * a callable carrying the `ffprobe` and `setFfmpegPath` statics.
+ *
+ * `tryImport` proves only that the package RESOLVES. Callers invoke the export
+ * and reach straight for its statics, so a package whose shape changed (ESM
+ * rewrite, major bump, a shim in node_modules) would otherwise surface as
+ * "Cannot read properties of undefined (reading 'ffprobe')" from inside
+ * probeVideo — blaming the call site instead of the package that is wrong.
+ */
+export function assertFluentFfmpegShape(mod) {
+    // Not `Partial<typeof import("fluent-ffmpeg")>`: Partial maps over properties
+    // and drops the call signature, so `typeof x === "function"` would narrow the
+    // result to `never`. Probe the statics structurally instead.
+    const statics = mod;
+    if (typeof mod !== "function" ||
+        typeof statics.ffprobe !== "function" ||
+        typeof statics.setFfmpegPath !== "function") {
+        throw new Error(`The installed "fluent-ffmpeg" package does not export a callable with ` +
+            `ffprobe and setFfmpegPath statics (got ${typeof mod}). ` +
+            `Reinstall a compatible version:\n  pnpm add fluent-ffmpeg`);
+    }
+}
 // fluent-ffmpeg's default export is callable + has static methods — avoid caching
 // the module type (it confuses TS); Node's module cache handles dedup.
 async function loadFluentFfmpeg() {
-    try {
-        const mod = await import(/* @vite-ignore */ "fluent-ffmpeg");
-        return mod.default;
-    }
-    catch (err) {
-        const e = err instanceof Error ? err : null;
-        if (e?.code === "ERR_MODULE_NOT_FOUND" &&
-            e.message.includes("fluent-ffmpeg")) {
-            throw new Error('Video processing requires the "fluent-ffmpeg" package. Install it with:\n  pnpm add fluent-ffmpeg', { cause: err });
-        }
-        throw err;
-    }
+    // fluent-ffmpeg is CJS (`export =`), so `typeof import(...)` describes the
+    // callable itself and carries no `default`. Under Node ESM the namespace
+    // still wraps it, so ask for that shape explicitly.
+    const mod = await tryImport("fluent-ffmpeg", "Video processing");
+    const ffmpeg = mod.default;
+    assertFluentFfmpegShape(ffmpeg);
+    return ffmpeg;
 }
 let _mediabunny = null;
 async function loadMediaBunny() {
     if (_mediabunny) {
         return _mediabunny;
     }
-    try {
-        _mediabunny = await import(/* @vite-ignore */ "mediabunny");
-        return _mediabunny;
-    }
-    catch (err) {
-        const e = err instanceof Error ? err : null;
-        if (e?.code === "ERR_MODULE_NOT_FOUND" &&
-            e.message.includes("mediabunny")) {
-            throw new Error('Video processing requires the "mediabunny" package. Install it with:\n  pnpm add mediabunny', { cause: err });
-        }
-        throw err;
-    }
+    _mediabunny = await tryImport("mediabunny", "Video processing");
+    return _mediabunny;
 }
 // =============================================================================
 // FFMPEG PATH INITIALIZATION

package/dist/lib/providers/sagemaker/client.js

@@ -6,6 +6,7 @@
  */
 import { handleSageMakerError, SageMakerError, isRetryableError, getRetryDelay, } from "./errors.js";
 import { logger } from "../../utils/logger.js";
+import { tryImport } from "../../utils/tryImport.js";
 /**
  * Lazily load `@aws-sdk/client-sagemaker-runtime`.
  *
@@ -16,17 +17,7 @@ import { logger } from "../../utils/logger.js";
  * error instead of a raw resolution failure.
  */
 async function loadSageMakerRuntime() {
-    try {
-        return await import(/* @vite-ignore */ "@aws-sdk/client-sagemaker-runtime");
-    }
-    catch (err) {
-        const e = err instanceof Error ? err : null;
-        if (e?.code === "ERR_MODULE_NOT_FOUND" &&
-            e.message.includes("client-sagemaker-runtime")) {
-            throw new Error('SageMaker inference requires "@aws-sdk/client-sagemaker-runtime". Install it with:\n  pnpm add @aws-sdk/client-sagemaker-runtime', { cause: err });
-        }
-        throw err;
-    }
+    return tryImport("@aws-sdk/client-sagemaker-runtime", "SageMaker inference");
 }
 /**
  * Enhanced SageMaker Runtime client with retry logic and error handling

package/dist/lib/server/voice/voiceWebSocketHandler.js

@@ -5,20 +5,11 @@ import { timingSafeEqualString } from "./tokenCompare.js";
 import { CartesiaStream } from "../../adapters/tts/cartesiaHandler.js";
 import { NeuroLink } from "../../neurolink.js";
 import { logger } from "../../utils/logger.js";
+import { tryImport } from "../../utils/tryImport.js";
 import { withTimeout } from "../../utils/async/withTimeout.js";
 async function loadCobra(accessKey) {
-    try {
-        const mod = (await import(/* @vite-ignore */ "@picovoice/cobra-node"));
-        return new mod.Cobra(accessKey);
-    }
-    catch (err) {
-        const e = err instanceof Error ? err : null;
-        if (e?.code === "ERR_MODULE_NOT_FOUND" &&
-            e.message.includes("cobra-node")) {
-            throw new Error('Voice activity detection requires "@picovoice/cobra-node". Install it with:\n  pnpm add @picovoice/cobra-node', { cause: err });
-        }
-        throw err;
-    }
+    const mod = await tryImport("@picovoice/cobra-node", "Voice activity detection");
+    return new mod.Cobra(accessKey);
 }
 const SONIOX_URL = process.env.SONIOX_WS_URL ?? "wss://stt-rt.soniox.com/transcribe-websocket";
 function getRequiredEnv(name) {

package/dist/lib/services/server/ai/observability/instrumentation.js

@@ -20,6 +20,7 @@ import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION, } from "@opentelemetry/semanti
 import { AsyncLocalStorage } from "async_hooks";
 import { extractMcpErrorText } from "../../../../utils/mcpErrorText.js";
 import { logger } from "../../../../utils/logger.js";
+import { tryImport } from "../../../../utils/tryImport.js";
 import { LANGFUSE_ATTR } from "../../../../telemetry/attributes.js";
 const LOG_PREFIX = "[OpenTelemetry]";
 function createOtelResource(config, serviceName) {
@@ -568,17 +569,7 @@ class ContextEnricher {
     }
 }
 async function createLangfuseProcessor(config) {
-    let mod;
-    try {
-        mod = await import(/* @vite-ignore */ "@langfuse/otel");
-    }
-    catch (err) {
-        const e = err instanceof Error ? err : null;
-        if (e?.code === "ERR_MODULE_NOT_FOUND" && e.message.includes("langfuse")) {
-            throw new Error('Langfuse observability requires "@langfuse/otel". Install it with:\n  pnpm add @langfuse/otel', { cause: err });
-        }
-        throw err;
-    }
+    const mod = await tryImport("@langfuse/otel", "Langfuse observability");
     return new mod.LangfuseSpanProcessor({
         publicKey: config.publicKey,
         secretKey: config.secretKey,

package/dist/lib/tasks/backends/bullmqBackend.js

@@ -7,19 +7,11 @@
  * - Survives process restarts (Redis-persisted)
  */
 import { logger } from "../../utils/logger.js";
+import { tryImport } from "../../utils/tryImport.js";
 import { TaskError } from "../errors.js";
 import { TASK_DEFAULTS, } from "../../types/index.js";
 async function loadBullMQ() {
-    try {
-        return await import(/* @vite-ignore */ "bullmq");
-    }
-    catch (err) {
-        const e = err instanceof Error ? err : null;
-        if (e?.code === "ERR_MODULE_NOT_FOUND" && e.message.includes("bullmq")) {
-            throw new Error('BullMQ task backend requires the "bullmq" package. Install it with:\n  pnpm add bullmq', { cause: err });
-        }
-        throw err;
-    }
+    return tryImport("bullmq", "BullMQ task backend");
 }
 const QUEUE_NAME = "neurolink-tasks";
 export class BullMQBackend {