@juspay/neurolink 9.55.0 → 9.55.2

package/dist/cli/commands/proxy.js

@@ -776,7 +776,7 @@ async function initializeProxyOpenTelemetry() {
         const observabilityConfig = buildObservabilityConfigFromEnv();
         const langfuseConfig = observabilityConfig?.langfuse;
         const langfuseEnabled = langfuseConfig?.enabled === true;
-        initializeOpenTelemetry({
+        await initializeOpenTelemetry({
             enabled: langfuseEnabled,
             publicKey: langfuseConfig?.publicKey || "",
             secretKey: langfuseConfig?.secretKey || "",

package/dist/lib/neurolink.js

@@ -1472,7 +1472,11 @@ Current user's request: ${currentInput}`;
                     message: "Starting Langfuse observability initialization",
                 });
                 // Initialize OpenTelemetry (sets defaults from config)
-                initializeOpenTelemetry(langfuseConfig);
+                void initializeOpenTelemetry(langfuseConfig).catch((err) => {
+                    logger.error("[NeuroLink] OpenTelemetry initialization failed", {
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
                 const healthStatus = getLangfuseHealthStatus();
                 const langfuseInitDurationNs = process.hrtime.bigint() - langfuseInitStartTime;
                 if (healthStatus.initialized &&
@@ -2234,7 +2238,11 @@ Current user's request: ${currentInput}`;
         try {
             const langfuseConfig = this.observabilityConfig?.langfuse;
             if (langfuseConfig?.enabled) {
-                initializeOpenTelemetry(langfuseConfig);
+                void initializeOpenTelemetry(langfuseConfig).catch((err) => {
+                    logger.error("[NeuroLink] OpenTelemetry initialization failed", {
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
                 logger.debug("[NeuroLink] Langfuse observability initialized via public method");
             }
             else {

package/dist/lib/services/server/ai/observability/instrumentation.d.ts

@@ -6,7 +6,6 @@
  *
  * Flow: Vercel AI SDK → OpenTelemetry Spans → LangfuseSpanProcessor → Langfuse Platform
  */
-import { LangfuseSpanProcessor } from "@langfuse/otel";
 import { trace } from "@opentelemetry/api";
 import { LoggerProvider } from "@opentelemetry/sdk-logs";
 import { type SpanProcessor } from "@opentelemetry/sdk-trace-base";
@@ -26,7 +25,7 @@ import type { LangfuseConfig, LangfuseContext } from "../../../../types/index.js
  *
  * @param config - Langfuse configuration passed from parent application
  */
-export declare function initializeOpenTelemetry(config: LangfuseConfig): void;
+export declare function initializeOpenTelemetry(config: LangfuseConfig): Promise<void>;
 /**
  * Flush all pending spans to Langfuse
  */
@@ -38,7 +37,7 @@ export declare function shutdownOpenTelemetry(): Promise<void>;
 /**
  * Get the Langfuse span processor
  */
-export declare function getLangfuseSpanProcessor(): LangfuseSpanProcessor | null;
+export declare function getLangfuseSpanProcessor(): SpanProcessor | null;
 /**
  * Get the tracer provider
  */

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

@@ -6,7 +6,6 @@
  *
  * Flow: Vercel AI SDK → OpenTelemetry Spans → LangfuseSpanProcessor → Langfuse Platform
  */
-import { LangfuseSpanProcessor } from "@langfuse/otel";
 import { metrics, SpanStatusCode, trace } from "@opentelemetry/api";
 import { W3CTraceContextPropagator } from "@opentelemetry/core";
 import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-http";
@@ -503,8 +502,19 @@ class ContextEnricher {
         return Promise.resolve();
     }
 }
-function createLangfuseProcessor(config) {
-    return new LangfuseSpanProcessor({
+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;
+    }
+    return new mod.LangfuseSpanProcessor({
         publicKey: config.publicKey,
         secretKey: config.secretKey,
         baseUrl: config.baseUrl || "https://cloud.langfuse.com",
@@ -513,7 +523,7 @@ function createLangfuseProcessor(config) {
         shouldExportSpan: () => true,
     });
 }
-function initializeExternalOpenTelemetryMode(config, resource, otlpEndpoint, serviceName, langfuseRequested, hasLangfuseCreds) {
+async function initializeExternalOpenTelemetryMode(config, resource, otlpEndpoint, serviceName, langfuseRequested, hasLangfuseCreds) {
     if (langfuseRequested && !hasLangfuseCreds) {
         if (!otlpEndpoint) {
             logger.warn(`${LOG_PREFIX} External provider mode requested Langfuse but credentials are missing, and no OTLP endpoint is configured; skipping initialization`, {
@@ -535,7 +545,7 @@ function initializeExternalOpenTelemetryMode(config, resource, otlpEndpoint, ser
         isCredentialsValid = hasLangfuseCreds;
         langfuseProcessor =
             langfuseRequested && hasLangfuseCreds
-                ? createLangfuseProcessor(config)
+                ? await createLangfuseProcessor(config)
                 : null;
         usingExternalProvider = true;
         isInitialized = true;
@@ -548,11 +558,9 @@ function initializeExternalOpenTelemetryMode(config, resource, otlpEndpoint, ser
                 // Auto-detect: skip if consumer already registered a LangfuseSpanProcessor.
                 //
                 // Detection strategy (ordered by robustness):
-                // 1. `instanceof LangfuseSpanProcessor` — reliable when both sides use
-                //    the same @langfuse/otel package instance (same module identity).
-                // 2. Duck-type check for Langfuse-specific public member
+                // 1. Duck-type check for Langfuse-specific public member
                 //    (`langfuseClient` property) — survives minification.
-                // 3. `constructor.name === "LangfuseSpanProcessor"` — last resort,
+                // 2. `constructor.name === "LangfuseSpanProcessor"` — last resort,
                 //    brittle under minification or bundler renaming.
                 //
                 // NOTE: `_registeredSpanProcessors` is an internal OpenTelemetry field.
@@ -566,10 +574,6 @@ function initializeExternalOpenTelemetryMode(config, resource, otlpEndpoint, ser
                     if (p === null || p === undefined || typeof p !== "object") {
                         return false;
                     }
-                    // Prefer instanceof — works when same @langfuse/otel package is shared
-                    if (p instanceof LangfuseSpanProcessor) {
-                        return true;
-                    }
                     // Duck-type: Langfuse processor exposes a langfuseClient property
                     if ("langfuseClient" in p) {
                         return true;
@@ -626,7 +630,7 @@ function initializeExternalOpenTelemetryMode(config, resource, otlpEndpoint, ser
         isInitialized = true;
     }
 }
-function initializeStandaloneOpenTelemetryMode(config, resource, otlpEndpoint, serviceName, langfuseRequested, hasLangfuseCreds) {
+async function initializeStandaloneOpenTelemetryMode(config, resource, otlpEndpoint, serviceName, langfuseRequested, hasLangfuseCreds) {
     if ((!langfuseRequested || !hasLangfuseCreds) && !otlpEndpoint) {
         if (langfuseRequested && !hasLangfuseCreds) {
             logger.warn(`${LOG_PREFIX} Langfuse requested but credentials are missing, and no OTLP endpoint is configured; skipping initialization`, {
@@ -652,7 +656,7 @@ function initializeStandaloneOpenTelemetryMode(config, resource, otlpEndpoint, s
         isCredentialsValid = hasLangfuseCreds;
         langfuseProcessor =
             langfuseRequested && hasLangfuseCreds
-                ? createLangfuseProcessor(config)
+                ? await createLangfuseProcessor(config)
                 : null;
         logger.debug(`${LOG_PREFIX} Standalone observability mode`, {
             langfuseEnabled: !!langfuseProcessor,
@@ -741,7 +745,7 @@ function initializeStandaloneOpenTelemetryMode(config, resource, otlpEndpoint, s
  *
  * @param config - Langfuse configuration passed from parent application
  */
-export function initializeOpenTelemetry(config) {
+export async function initializeOpenTelemetry(config) {
     // Guard against multiple initializations — but always update config
     // so that later NeuroLink instances can change traceNameFormat,
     // autoDetectOperationName, and other configuration preferences
@@ -771,10 +775,10 @@ export function initializeOpenTelemetry(config) {
     const serviceName = process.env.OTEL_SERVICE_NAME || "neurolink";
     const resource = createOtelResource(config, serviceName);
     if (shouldUseExternal) {
-        initializeExternalOpenTelemetryMode(config, resource, otlpEndpoint, serviceName, langfuseRequested, hasLangfuseCreds);
+        await initializeExternalOpenTelemetryMode(config, resource, otlpEndpoint, serviceName, langfuseRequested, hasLangfuseCreds);
         return;
     }
-    initializeStandaloneOpenTelemetryMode(config, resource, otlpEndpoint, serviceName, langfuseRequested, hasLangfuseCreds);
+    await initializeStandaloneOpenTelemetryMode(config, resource, otlpEndpoint, serviceName, langfuseRequested, hasLangfuseCreds);
 }
 /**
  * Flush all pending spans to Langfuse

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

@@ -6,10 +6,21 @@
  * - One-shot tasks → BullMQ delayed jobs
  * - Survives process restarts (Redis-persisted)
  */
-import { Queue, Worker } from "bullmq";
 import { logger } from "../../utils/logger.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;
+    }
+}
 const QUEUE_NAME = "neurolink-tasks";
 export class BullMQBackend {
     name = "bullmq";
@@ -21,9 +32,10 @@ export class BullMQBackend {
         this.config = config;
     }
     async initialize() {
+        const { Queue: BullQueue, Worker: BullWorker } = await loadBullMQ();
         const connection = this.getConnectionConfig();
-        this.queue = new Queue(QUEUE_NAME, { connection });
-        this.worker = new Worker(QUEUE_NAME, async (job) => {
+        this.queue = new BullQueue(QUEUE_NAME, { connection });
+        this.worker = new BullWorker(QUEUE_NAME, async (job) => {
             const taskId = job.data.taskId;
             const task = job.data.task;
             const executor = this.executors.get(taskId);

package/dist/neurolink.js

@@ -1472,7 +1472,11 @@ Current user's request: ${currentInput}`;
                     message: "Starting Langfuse observability initialization",
                 });
                 // Initialize OpenTelemetry (sets defaults from config)
-                initializeOpenTelemetry(langfuseConfig);
+                void initializeOpenTelemetry(langfuseConfig).catch((err) => {
+                    logger.error("[NeuroLink] OpenTelemetry initialization failed", {
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
                 const healthStatus = getLangfuseHealthStatus();
                 const langfuseInitDurationNs = process.hrtime.bigint() - langfuseInitStartTime;
                 if (healthStatus.initialized &&
@@ -2234,7 +2238,11 @@ Current user's request: ${currentInput}`;
         try {
             const langfuseConfig = this.observabilityConfig?.langfuse;
             if (langfuseConfig?.enabled) {
-                initializeOpenTelemetry(langfuseConfig);
+                void initializeOpenTelemetry(langfuseConfig).catch((err) => {
+                    logger.error("[NeuroLink] OpenTelemetry initialization failed", {
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
                 logger.debug("[NeuroLink] Langfuse observability initialized via public method");
             }
             else {

package/dist/services/server/ai/observability/instrumentation.d.ts

@@ -6,7 +6,6 @@
  *
  * Flow: Vercel AI SDK → OpenTelemetry Spans → LangfuseSpanProcessor → Langfuse Platform
  */
-import { LangfuseSpanProcessor } from "@langfuse/otel";
 import { trace } from "@opentelemetry/api";
 import { LoggerProvider } from "@opentelemetry/sdk-logs";
 import { type SpanProcessor } from "@opentelemetry/sdk-trace-base";
@@ -26,7 +25,7 @@ import type { LangfuseConfig, LangfuseContext } from "../../../../types/index.js
  *
  * @param config - Langfuse configuration passed from parent application
  */
-export declare function initializeOpenTelemetry(config: LangfuseConfig): void;
+export declare function initializeOpenTelemetry(config: LangfuseConfig): Promise<void>;
 /**
  * Flush all pending spans to Langfuse
  */
@@ -38,7 +37,7 @@ export declare function shutdownOpenTelemetry(): Promise<void>;
 /**
  * Get the Langfuse span processor
  */
-export declare function getLangfuseSpanProcessor(): LangfuseSpanProcessor | null;
+export declare function getLangfuseSpanProcessor(): SpanProcessor | null;
 /**
  * Get the tracer provider
  */

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

@@ -6,7 +6,6 @@
  *
  * Flow: Vercel AI SDK → OpenTelemetry Spans → LangfuseSpanProcessor → Langfuse Platform
  */
-import { LangfuseSpanProcessor } from "@langfuse/otel";
 import { metrics, SpanStatusCode, trace } from "@opentelemetry/api";
 import { W3CTraceContextPropagator } from "@opentelemetry/core";
 import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-http";
@@ -503,8 +502,19 @@ class ContextEnricher {
         return Promise.resolve();
     }
 }
-function createLangfuseProcessor(config) {
-    return new LangfuseSpanProcessor({
+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;
+    }
+    return new mod.LangfuseSpanProcessor({
         publicKey: config.publicKey,
         secretKey: config.secretKey,
         baseUrl: config.baseUrl || "https://cloud.langfuse.com",
@@ -513,7 +523,7 @@ function createLangfuseProcessor(config) {
         shouldExportSpan: () => true,
     });
 }
-function initializeExternalOpenTelemetryMode(config, resource, otlpEndpoint, serviceName, langfuseRequested, hasLangfuseCreds) {
+async function initializeExternalOpenTelemetryMode(config, resource, otlpEndpoint, serviceName, langfuseRequested, hasLangfuseCreds) {
     if (langfuseRequested && !hasLangfuseCreds) {
         if (!otlpEndpoint) {
             logger.warn(`${LOG_PREFIX} External provider mode requested Langfuse but credentials are missing, and no OTLP endpoint is configured; skipping initialization`, {
@@ -535,7 +545,7 @@ function initializeExternalOpenTelemetryMode(config, resource, otlpEndpoint, ser
         isCredentialsValid = hasLangfuseCreds;
         langfuseProcessor =
             langfuseRequested && hasLangfuseCreds
-                ? createLangfuseProcessor(config)
+                ? await createLangfuseProcessor(config)
                 : null;
         usingExternalProvider = true;
         isInitialized = true;
@@ -548,11 +558,9 @@ function initializeExternalOpenTelemetryMode(config, resource, otlpEndpoint, ser
                 // Auto-detect: skip if consumer already registered a LangfuseSpanProcessor.
                 //
                 // Detection strategy (ordered by robustness):
-                // 1. `instanceof LangfuseSpanProcessor` — reliable when both sides use
-                //    the same @langfuse/otel package instance (same module identity).
-                // 2. Duck-type check for Langfuse-specific public member
+                // 1. Duck-type check for Langfuse-specific public member
                 //    (`langfuseClient` property) — survives minification.
-                // 3. `constructor.name === "LangfuseSpanProcessor"` — last resort,
+                // 2. `constructor.name === "LangfuseSpanProcessor"` — last resort,
                 //    brittle under minification or bundler renaming.
                 //
                 // NOTE: `_registeredSpanProcessors` is an internal OpenTelemetry field.
@@ -566,10 +574,6 @@ function initializeExternalOpenTelemetryMode(config, resource, otlpEndpoint, ser
                     if (p === null || p === undefined || typeof p !== "object") {
                         return false;
                     }
-                    // Prefer instanceof — works when same @langfuse/otel package is shared
-                    if (p instanceof LangfuseSpanProcessor) {
-                        return true;
-                    }
                     // Duck-type: Langfuse processor exposes a langfuseClient property
                     if ("langfuseClient" in p) {
                         return true;
@@ -626,7 +630,7 @@ function initializeExternalOpenTelemetryMode(config, resource, otlpEndpoint, ser
         isInitialized = true;
     }
 }
-function initializeStandaloneOpenTelemetryMode(config, resource, otlpEndpoint, serviceName, langfuseRequested, hasLangfuseCreds) {
+async function initializeStandaloneOpenTelemetryMode(config, resource, otlpEndpoint, serviceName, langfuseRequested, hasLangfuseCreds) {
     if ((!langfuseRequested || !hasLangfuseCreds) && !otlpEndpoint) {
         if (langfuseRequested && !hasLangfuseCreds) {
             logger.warn(`${LOG_PREFIX} Langfuse requested but credentials are missing, and no OTLP endpoint is configured; skipping initialization`, {
@@ -652,7 +656,7 @@ function initializeStandaloneOpenTelemetryMode(config, resource, otlpEndpoint, s
         isCredentialsValid = hasLangfuseCreds;
         langfuseProcessor =
             langfuseRequested && hasLangfuseCreds
-                ? createLangfuseProcessor(config)
+                ? await createLangfuseProcessor(config)
                 : null;
         logger.debug(`${LOG_PREFIX} Standalone observability mode`, {
             langfuseEnabled: !!langfuseProcessor,
@@ -741,7 +745,7 @@ function initializeStandaloneOpenTelemetryMode(config, resource, otlpEndpoint, s
  *
  * @param config - Langfuse configuration passed from parent application
  */
-export function initializeOpenTelemetry(config) {
+export async function initializeOpenTelemetry(config) {
     // Guard against multiple initializations — but always update config
     // so that later NeuroLink instances can change traceNameFormat,
     // autoDetectOperationName, and other configuration preferences
@@ -771,10 +775,10 @@ export function initializeOpenTelemetry(config) {
     const serviceName = process.env.OTEL_SERVICE_NAME || "neurolink";
     const resource = createOtelResource(config, serviceName);
     if (shouldUseExternal) {
-        initializeExternalOpenTelemetryMode(config, resource, otlpEndpoint, serviceName, langfuseRequested, hasLangfuseCreds);
+        await initializeExternalOpenTelemetryMode(config, resource, otlpEndpoint, serviceName, langfuseRequested, hasLangfuseCreds);
         return;
     }
-    initializeStandaloneOpenTelemetryMode(config, resource, otlpEndpoint, serviceName, langfuseRequested, hasLangfuseCreds);
+    await initializeStandaloneOpenTelemetryMode(config, resource, otlpEndpoint, serviceName, langfuseRequested, hasLangfuseCreds);
 }
 /**
  * Flush all pending spans to Langfuse

package/dist/tasks/backends/bullmqBackend.js

@@ -6,10 +6,21 @@
  * - One-shot tasks → BullMQ delayed jobs
  * - Survives process restarts (Redis-persisted)
  */
-import { Queue, Worker } from "bullmq";
 import { logger } from "../../utils/logger.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;
+    }
+}
 const QUEUE_NAME = "neurolink-tasks";
 export class BullMQBackend {
     name = "bullmq";
@@ -21,9 +32,10 @@ export class BullMQBackend {
         this.config = config;
     }
     async initialize() {
+        const { Queue: BullQueue, Worker: BullWorker } = await loadBullMQ();
         const connection = this.getConnectionConfig();
-        this.queue = new Queue(QUEUE_NAME, { connection });
-        this.worker = new Worker(QUEUE_NAME, async (job) => {
+        this.queue = new BullQueue(QUEUE_NAME, { connection });
+        this.worker = new BullWorker(QUEUE_NAME, async (job) => {
             const taskId = job.data.taskId;
             const task = job.data.task;
             const executor = this.executors.get(taskId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "9.55.0",
+  "version": "9.55.2",
   "packageManager": "pnpm@10.15.1",
   "description": "Universal AI Development Platform with working MCP integration, multi-provider support, and professional CLI. Built-in tools operational, 58+ external MCP servers discoverable. Connect to filesystem, GitHub, database operations, and more. Build, test, and deploy AI applications with 13 providers: OpenAI, Anthropic, Google AI, AWS Bedrock, Azure, Hugging Face, Ollama, and Mistral AI.",
   "author": {
@@ -212,7 +212,6 @@
     "@google/genai": "^1.43.0",
     "@huggingface/inference": "^4.13.14",
     "@juspay/hippocampus": "^0.1.4",
-    "@langfuse/otel": "^5.0.1",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "@openrouter/ai-sdk-provider": "^2.2.3",
     "@opentelemetry/api-logs": "^0.214.0",
@@ -229,7 +228,6 @@
     "@picovoice/cobra-node": "^3.0.2",
     "adm-zip": "^0.5.16",
     "ai": "^6.0.134",
-    "bullmq": "^5.52.2",
     "chalk": "^5.6.2",
     "croner": "^9.1.0",
     "csv-parser": "^3.2.0",
@@ -249,8 +247,6 @@
     "open": "^11.0.0",
     "ora": "^9.3.0",
     "p-limit": "^7.3.0",
-    "pdf-parse": "^2.4.5",
-    "pdf-to-img": "^5.0.0",
     "pptxgenjs": "^4.0.1",
     "redis": "^5.11.0",
     "tar-stream": "^3.1.8",
@@ -275,6 +271,10 @@
     }
   },
   "optionalDependencies": {
+    "@langfuse/otel": "^5.0.1",
+    "bullmq": "^5.52.2",
+    "pdf-parse": "^2.4.5",
+    "pdf-to-img": "^5.0.0",
     "@fastify/cors": "^11.2.0",
     "@fastify/rate-limit": "^10.3.0",
     "@hono/node-server": "^1.19.9",

package/dist/lib/utils/imageCompressor.d.ts

@@ -1,25 +0,0 @@
-import type { CompressionOptions, CompressionResult, ProviderName } from "../types/index.js";
-/**
- * Provider-specific image size limits in bytes
- */
-export declare const PROVIDER_IMAGE_LIMITS: Record<ProviderName, number>;
-/**
- * Compress an image to meet provider-specific size limits
- * @param imageBuffer - Input image buffer
- * @param options - Compression options including provider name
- * @returns Compressed image buffer with metadata
- */
-export declare function compressImage(imageBuffer: Buffer, options: CompressionOptions): Promise<CompressionResult>;
-/**
- * Check if an image needs compression for a specific provider
- * @param imageBuffer - Input image buffer
- * @param provider - AI provider name
- * @returns True if compression is needed
- */
-export declare function needsCompression(imageBuffer: Buffer, provider: ProviderName): boolean;
-/**
- * Get the size limit for a specific provider
- * @param provider - AI provider name
- * @returns Size limit in bytes
- */
-export declare function getProviderSizeLimit(provider: ProviderName): number;

package/dist/lib/utils/imageCompressor.js

@@ -1,141 +0,0 @@
-import sharp from "sharp";
-import { withTimeout } from "./async/index.js";
-const SUPPORTED_FORMATS = [
-    "jpeg",
-    "png",
-    "webp",
-];
-const IMAGE_COMPRESSION_TIMEOUT_MS = 30_000;
-/**
- * Provider-specific image size limits in bytes
- */
-export const PROVIDER_IMAGE_LIMITS = {
-    openai: 20 * 1024 * 1024, // 20MB
-    "openai-compatible": 20 * 1024 * 1024, // 20MB (same as OpenAI)
-    anthropic: 5 * 1024 * 1024, // 5MB
-    "google-ai": 4 * 1024 * 1024, // 4MB
-    vertex: 4 * 1024 * 1024, // 4MB
-    bedrock: 5 * 1024 * 1024, // 5MB
-    azure: 20 * 1024 * 1024, // 20MB
-    mistral: 5 * 1024 * 1024, // 5MB
-    huggingface: 10 * 1024 * 1024, // 10MB
-    ollama: 100 * 1024 * 1024, // 100MB (local, no strict limit)
-    openrouter: 20 * 1024 * 1024, // 20MB
-    sagemaker: 5 * 1024 * 1024, // 5MB
-    litellm: 20 * 1024 * 1024, // 20MB (proxy, use OpenAI default)
-    auto: 5 * 1024 * 1024, // 5MB (conservative fallback)
-};
-/**
- * Compress an image to meet provider-specific size limits
- * @param imageBuffer - Input image buffer
- * @param options - Compression options including provider name
- * @returns Compressed image buffer with metadata
- */
-export async function compressImage(imageBuffer, options) {
-    const { provider, quality = 80, maxDimension, format } = options;
-    const sizeLimit = PROVIDER_IMAGE_LIMITS[provider];
-    const originalSize = imageBuffer.length;
-    // Get original metadata
-    const image = sharp(imageBuffer);
-    const metadata = await withTimeout(image.metadata(), IMAGE_COMPRESSION_TIMEOUT_MS, "Timed out reading image metadata");
-    if (!metadata.width || !metadata.height) {
-        throw new Error("Unable to read image dimensions");
-    }
-    // If image is already under limit and no format conversion needed, return as-is
-    if (originalSize <= sizeLimit && !format && !maxDimension) {
-        return {
-            buffer: imageBuffer,
-            originalSize,
-            compressedSize: originalSize,
-            compressionRatio: 1,
-            metadata: {
-                width: metadata.width,
-                height: metadata.height,
-                format: metadata.format ?? "unknown",
-            },
-        };
-    }
-    // Prepare compression pipeline
-    let pipeline = sharp(imageBuffer);
-    // Resize if needed
-    if (maxDimension) {
-        const needsResize = metadata.width > maxDimension || metadata.height > maxDimension;
-        if (needsResize) {
-            pipeline = pipeline.resize(maxDimension, maxDimension, {
-                fit: "inside",
-                withoutEnlargement: true,
-            });
-        }
-    }
-    // Resolve target format — validate metadata.format against supported set
-    const rawFormat = metadata.format;
-    const targetFormat = format ??
-        (SUPPORTED_FORMATS.includes(rawFormat)
-            ? rawFormat
-            : "jpeg");
-    const applyFormat = (p, q) => {
-        switch (targetFormat) {
-            case "jpeg":
-                return p.jpeg({ quality: q, mozjpeg: true });
-            case "png":
-                return p.png({ quality: q, compressionLevel: 9 });
-            case "webp":
-                return p.webp({ quality: q });
-        }
-    };
-    // Compress
-    let compressedBuffer = await withTimeout(applyFormat(pipeline, quality).toBuffer(), IMAGE_COMPRESSION_TIMEOUT_MS, "Timed out compressing image");
-    let currentQuality = quality;
-    // Iteratively reduce quality if still over limit
-    // Note: the sharp pipeline must be rebuilt on each iteration because
-    // sharp does not support modifying quality settings after creation.
-    while (compressedBuffer.length > sizeLimit && currentQuality > 10) {
-        currentQuality -= 10;
-        let p = sharp(imageBuffer);
-        if (maxDimension) {
-            p = p.resize(maxDimension, maxDimension, {
-                fit: "inside",
-                withoutEnlargement: true,
-            });
-        }
-        compressedBuffer = await withTimeout(applyFormat(p, currentQuality).toBuffer(), IMAGE_COMPRESSION_TIMEOUT_MS, "Timed out compressing image");
-    }
-    // Final check
-    if (compressedBuffer.length > sizeLimit) {
-        throw new Error(`Unable to compress image to ${sizeLimit} bytes for provider ${provider}. ` +
-            `Final size: ${compressedBuffer.length} bytes. ` +
-            `Try using a smaller image or lower maxDimension.`);
-    }
-    // Get final metadata
-    const finalMetadata = await withTimeout(sharp(compressedBuffer).metadata(), IMAGE_COMPRESSION_TIMEOUT_MS, "Timed out reading compressed image metadata");
-    return {
-        buffer: compressedBuffer,
-        originalSize,
-        compressedSize: compressedBuffer.length,
-        compressionRatio: originalSize / compressedBuffer.length,
-        metadata: {
-            width: finalMetadata.width ?? 0,
-            height: finalMetadata.height ?? 0,
-            format: targetFormat,
-        },
-    };
-}
-/**
- * Check if an image needs compression for a specific provider
- * @param imageBuffer - Input image buffer
- * @param provider - AI provider name
- * @returns True if compression is needed
- */
-export function needsCompression(imageBuffer, provider) {
-    const sizeLimit = PROVIDER_IMAGE_LIMITS[provider];
-    return imageBuffer.length > sizeLimit;
-}
-/**
- * Get the size limit for a specific provider
- * @param provider - AI provider name
- * @returns Size limit in bytes
- */
-export function getProviderSizeLimit(provider) {
-    return PROVIDER_IMAGE_LIMITS[provider];
-}
-//# sourceMappingURL=imageCompressor.js.map

package/dist/utils/imageCompressor.d.ts

@@ -1,25 +0,0 @@
-import type { CompressionOptions, CompressionResult, ProviderName } from "../types/index.js";
-/**
- * Provider-specific image size limits in bytes
- */
-export declare const PROVIDER_IMAGE_LIMITS: Record<ProviderName, number>;
-/**
- * Compress an image to meet provider-specific size limits
- * @param imageBuffer - Input image buffer
- * @param options - Compression options including provider name
- * @returns Compressed image buffer with metadata
- */
-export declare function compressImage(imageBuffer: Buffer, options: CompressionOptions): Promise<CompressionResult>;
-/**
- * Check if an image needs compression for a specific provider
- * @param imageBuffer - Input image buffer
- * @param provider - AI provider name
- * @returns True if compression is needed
- */
-export declare function needsCompression(imageBuffer: Buffer, provider: ProviderName): boolean;
-/**
- * Get the size limit for a specific provider
- * @param provider - AI provider name
- * @returns Size limit in bytes
- */
-export declare function getProviderSizeLimit(provider: ProviderName): number;