@juspay/neurolink 9.23.0 → 9.25.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [9.25.0](https://github.com/juspay/neurolink/compare/v9.24.0...v9.25.0) (2026-03-15)
+
+### Features
+
+- **(observability):** add OTEL instrumentation, observability exporters, and comprehensive test suite fixes ([66c4559](https://github.com/juspay/neurolink/commit/66c45592cfcf5ae5acbec0513231f48e87044dab))
+
+## [9.24.0](https://github.com/juspay/neurolink/compare/v9.23.0...v9.24.0) (2026-03-14)
+
+### Features
+
+- **(ppt):** Implement CLI support for PPT Gen ([83e6847](https://github.com/juspay/neurolink/commit/83e684781b04562970bcd48f617d368d1c4db2ee))
+
 ## [9.23.0](https://github.com/juspay/neurolink/compare/v9.22.3...v9.23.0) (2026-03-14)
 
 ### Features

package/README.md

@@ -37,19 +37,15 @@ Extracted from production systems at Juspay and battle-tested at enterprise scal
 
 ## What's New (Q1 2026)
 
-| Feature                             | Version | Description                                                                                                                                                   | Guide                                                                 |
-| ----------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
-| **Memory**                          | v9.12.0 | Per-user condensed memory that persists across conversations. LLM-powered condensation with S3, Redis, or SQLite backends.                                    | [Memory Guide](docs/features/memory.md)                               |
-| **Context Window Management**       | v9.2.0  | 4-stage compaction pipeline with auto-detection, budget gate at 80% usage, per-provider token estimation                                                      | [Context Compaction Guide](docs/features/context-compaction.md)       |
-| **Tool Execution Control**          | v9.3.0  | `prepareStep` and `toolChoice` support for per-step tool enforcement in multi-step agentic loops. API-level control over tool calls.                          | [API Reference](docs/api/type-aliases/GenerateOptions.md#preparestep) |
-| **File Processor System**           | v9.1.0  | 17+ file type processors with ProcessorRegistry, security sanitization, SVG text injection                                                                    | [File Processors Guide](docs/features/file-processors.md)             |
-| **RAG with generate()/stream()**    | v9.2.0  | Pass `rag: { files }` to generate/stream for automatic document chunking, embedding, and AI-powered search. 10 chunking strategies, hybrid search, reranking. | [RAG Guide](docs/features/rag.md)                                     |
-| **External TracerProvider Support** | v8.43.0 | Integrate NeuroLink with existing OpenTelemetry instrumentation. Prevents duplicate registration conflicts.                                                   | [Observability Guide](docs/features/observability.md)                 |
-| **Server Adapters**                 | v8.43.0 | Multi-framework HTTP server with Hono, Express, Fastify, Koa support. Full CLI for server management with foreground/background modes.                        | [Server Adapters Guide](docs/guides/server-adapters/index.md)         |
-| **Title Generation Events**         | v8.38.0 | Emit `conversation:titleGenerated` event when conversation title is generated. Supports custom title prompts via `NEUROLINK_TITLE_PROMPT`.                    | [Conversation Memory Guide](docs/conversation-memory.md)              |
-| **Video Generation with Veo**       | v8.32.0 | Video generation using Veo 3.1 (`veo-3.1`). Realistic video generation with many parameter options                                                            | [Video Generation Guide](docs/features/video-generation.md)           |
-| **Image Generation with Gemini**    | v8.31.0 | Native image generation using Gemini 2.0 Flash Experimental (`imagen-3.0-generate-002`). High-quality image synthesis directly from Google AI.                | [Image Generation Guide](docs/image-generation-streaming.md)          |
-| **HTTP/Streamable HTTP Transport**  | v8.29.0 | Connect to remote MCP servers via HTTP with authentication headers, automatic retry with exponential backoff, and configurable rate limiting.                 | [HTTP Transport Guide](docs/mcp-http-transport.md)                    |
+| Feature                             | Version | Description                                                                                                                                                   | Guide                                                         |
+| ----------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
+| **External TracerProvider Support** | v8.43.0 | Integrate NeuroLink with existing OpenTelemetry instrumentation. Prevents duplicate registration conflicts.                                                   | [Observability Guide](docs/features/observability.md)         |
+| **Server Adapters**                 | v8.43.0 | Multi-framework HTTP server with Hono, Express, Fastify, Koa support. Full CLI for server management with foreground/background modes.                        | [Server Adapters Guide](docs/guides/server-adapters/index.md) |
+| **Title Generation Events**         | v8.38.0 | Emit `conversation:titleGenerated` event when conversation title is generated. Supports custom title prompts via `NEUROLINK_TITLE_PROMPT`.                    | [Conversation Memory Guide](docs/conversation-memory.md)      |
+| **Video Generation with Veo**       | v8.32.0 | Video generation using Veo 3.1 (`veo-3.1`). Realistic video generation with many parameter options                                                            | [Video Generation Guide](docs/features/video-generation.md)   |
+| **Image Generation with Gemini**    | v8.31.0 | Native image generation using Gemini 2.0 Flash Experimental (`imagen-3.0-generate-002`). High-quality image synthesis directly from Google AI.                | [Image Generation Guide](docs/image-generation-streaming.md)  |
+| **RAG with generate()/stream()**    | v9.2.0  | Pass `rag: { files }` to generate/stream for automatic document chunking, embedding, and AI-powered search. 10 chunking strategies, hybrid search, reranking. | [RAG Guide](docs/features/rag.md)                             |
+| **HTTP/Streamable HTTP Transport**  | v8.29.0 | Connect to remote MCP servers via HTTP with authentication headers, automatic retry with exponential backoff, and configurable rate limiting.                 | [HTTP Transport Guide](docs/mcp-http-transport.md)            |
 
 - **Memory** – Per-user condensed memory that persists across all conversations. Automatically retrieves and stores memory on each `generate()`/`stream()` call. Supports S3, Redis, and SQLite storage with LLM-powered condensation. → [Memory Guide](docs/features/memory.md)
 - **External TracerProvider Support** – Integrate NeuroLink with applications that already have OpenTelemetry instrumentation. Supports auto-detection and manual configuration. → [Observability Guide](docs/features/observability.md)
@@ -57,6 +53,7 @@ Extracted from production systems at Juspay and battle-tested at enterprise scal
 - **Title Generation Events** – Emit real-time events when conversation titles are auto-generated. Listen to `conversation:titleGenerated` for session tracking. → [Conversation Memory Guide](docs/conversation-memory.md#title-generation-events)
 - **Custom Title Prompts** – Customize conversation title generation with `NEUROLINK_TITLE_PROMPT` environment variable. Use `${userMessage}` placeholder for dynamic prompts. → [Conversation Memory Guide](docs/conversation-memory.md#customizing-the-title-prompt)
 - **Video Generation** – Transform images into 8-second videos with synchronized audio using Google Veo 3.1 via Vertex AI. Supports 720p/1080p resolutions, portrait/landscape aspect ratios. → [Video Generation Guide](docs/features/video-generation.md)
+- **PPT Generation** – Create professional PowerPoint presentations from text prompts with 35 slide types (title, content, charts, timelines, dashboards, composite layouts), 5 themes, and optional AI-generated images. Works with Vertex AI, OpenAI, Anthropic, Google AI, Azure, and Bedrock. → [PPT Generation Guide](docs/features/ppt-generation.md)
 - **Image Generation** – Generate images from text prompts using Gemini models via Vertex AI or Google AI Studio. Supports streaming mode with automatic file saving. → [Image Generation Guide](docs/image-generation-streaming.md)
 - **RAG with generate()/stream()** – Just pass `rag: { files: ["./docs/guide.md"] }` to `generate()` or `stream()`. NeuroLink auto-chunks, embeds, and creates a search tool the AI can invoke. 10 chunking strategies, hybrid search, 5 reranker types. → [RAG Guide](docs/features/rag.md)
 - **HTTP/Streamable HTTP Transport for MCP** – Connect to remote MCP servers via HTTP with authentication headers, retry logic, and rate limiting. → [HTTP Transport Guide](docs/mcp-http-transport.md)

package/dist/adapters/tts/googleTTSHandler.js

@@ -10,6 +10,8 @@ import { TextToSpeechClient } from "@google-cloud/text-to-speech";
 import { TTSError, TTS_ERROR_CODES } from "../../utils/ttsProcessor.js";
 import { ErrorCategory, ErrorSeverity } from "../../constants/enums.js";
 import { logger } from "../../utils/logger.js";
+import { SpanSerializer, SpanType, SpanStatus, } from "../../observability/index.js";
+import { getMetricsAggregator } from "../../observability/index.js";
 export class GoogleTTSHandler {
     client = null;
     voicesCache = null;
@@ -68,18 +70,26 @@ export class GoogleTTSHandler {
                 retriable: false,
             });
         }
+        const span = SpanSerializer.createSpan(SpanType.TTS, "tts.google.listVoices", {
+            "tts.operation": "listVoices",
+            "tts.provider": "google",
+        });
         try {
             // Return cached voices if available, valid, and no language filter is specified
             if (this.voicesCache &&
                 Date.now() - this.voicesCache.timestamp <
                     GoogleTTSHandler.CACHE_TTL_MS &&
                 !languageCode) {
+                const endedSpan = SpanSerializer.endSpan(span, SpanStatus.OK);
+                getMetricsAggregator().recordSpan(endedSpan);
                 return this.voicesCache.voices;
             }
             // Call Google Cloud listVoices API
             const [response] = await this.client.listVoices(languageCode ? { languageCode } : {});
             if (!response.voices || response.voices.length === 0) {
                 logger.warn("Google Cloud TTS returned no voices");
+                const endedSpan = SpanSerializer.endSpan(span, SpanStatus.OK);
+                getMetricsAggregator().recordSpan(endedSpan);
                 return [];
             }
             const voices = [];
@@ -118,9 +128,14 @@ export class GoogleTTSHandler {
             if (!languageCode) {
                 this.voicesCache = { voices, timestamp: Date.now() };
             }
+            const endedSpan = SpanSerializer.endSpan(span, SpanStatus.OK);
+            getMetricsAggregator().recordSpan(endedSpan);
             return voices;
         }
         catch (err) {
+            // Record error span
+            const endedSpan = SpanSerializer.endSpan(span, SpanStatus.ERROR, err instanceof Error ? err.message : "Unknown error");
+            getMetricsAggregator().recordSpan(endedSpan);
             // Log error but return empty array for graceful degradation
             const message = err instanceof Error ? err.message : "Unknown error";
             logger.error(`Failed to fetch Google TTS voices: ${message}`);
@@ -144,6 +159,13 @@ export class GoogleTTSHandler {
                 retriable: false,
             });
         }
+        const voiceId = options.voice ?? "en-US-Neural2-C";
+        const span = SpanSerializer.createSpan(SpanType.TTS, "tts.google.synthesize", {
+            "tts.operation": "synthesize",
+            "tts.provider": "google",
+            "tts.voice": voiceId,
+            "tts.format": options.format ?? "mp3",
+        });
         const startTime = Date.now();
         try {
             const isSSML = text.startsWith("<speak>") && text.endsWith("</speak>");
@@ -160,7 +182,6 @@ export class GoogleTTSHandler {
                     retriable: false,
                 });
             }
-            const voiceId = options.voice ?? "en-US-Neural2-C";
             const languageCode = this.extractLanguageCode(voiceId);
             const audioEncoding = this.mapFormat(options.format ?? "mp3");
             const request = {
@@ -204,6 +225,8 @@ export class GoogleTTSHandler {
                         });
                     })();
             const latency = Date.now() - startTime;
+            const endedSpan = SpanSerializer.endSpan(span, SpanStatus.OK);
+            getMetricsAggregator().recordSpan(endedSpan);
             return {
                 buffer,
                 format: options.format ?? "mp3",
@@ -216,6 +239,8 @@ export class GoogleTTSHandler {
             };
         }
         catch (err) {
+            const endedSpan = SpanSerializer.endSpan(span, SpanStatus.ERROR, err instanceof Error ? err.message : String(err));
+            getMetricsAggregator().recordSpan(endedSpan);
             if (err instanceof TTSError) {
                 throw err;
             }

package/dist/adapters/video/vertexVideoHandler.js

@@ -70,7 +70,14 @@ const DEFAULT_LOCATION = "us-central1";
  * ```
  */
 export function isVertexVideoConfigured() {
+    // Same credential detection as googleVertex.ts hasGoogleCredentials().
+    // GoogleAuth (used by getAccessToken) also supports ADC from
+    // `gcloud auth application-default login` automatically, so we only
+    // gate on the explicit env vars here — if none are set, we still
+    // allow the call through and let GoogleAuth resolve ADC at runtime.
+    // This avoids duplicating GoogleAuth's discovery logic.
     return !!(process.env.GOOGLE_APPLICATION_CREDENTIALS ||
+        process.env.GOOGLE_APPLICATION_CREDENTIALS_NEUROLINK ||
         process.env.GOOGLE_SERVICE_ACCOUNT_KEY ||
         (process.env.GOOGLE_AUTH_CLIENT_EMAIL &&
             process.env.GOOGLE_AUTH_PRIVATE_KEY));
@@ -270,21 +277,10 @@ function calculateDimensions(resolution, aspectRatio) {
  * ```
  */
 export async function generateVideoWithVertex(image, prompt, options = {}, region) {
-    // Validate configuration
-    if (!isVertexVideoConfigured()) {
-        throw new VideoError({
-            code: VIDEO_ERROR_CODES.PROVIDER_NOT_CONFIGURED,
-            message: "Vertex AI credentials not configured. Set GOOGLE_APPLICATION_CREDENTIALS environment variable",
-            category: ErrorCategory.CONFIGURATION,
-            severity: ErrorSeverity.HIGH,
-            retriable: false,
-            context: {
-                provider: "vertex",
-                feature: "video-generation",
-                suggestion: "Set GOOGLE_APPLICATION_CREDENTIALS to the path of your service account JSON file",
-            },
-        });
-    }
+    // Credential validation is deferred to getAccessToken() which uses
+    // GoogleAuth — it handles env vars, service accounts, AND ADC from
+    // `gcloud auth application-default login` automatically.
+    // Same pattern as googleVertex.ts — no synchronous pre-check needed.
     const config = await getVertexConfig();
     const project = config.project;
     const location = region || config.location;
@@ -312,7 +308,12 @@ export async function generateVideoWithVertex(image, prompt, options = {}, regio
         // Get auth token
         const accessToken = await getAccessToken();
         // Construct API request - predictLongRunning endpoint
-        const endpoint = `https://${location}-aiplatform.googleapis.com/v1/projects/${project}/locations/${location}/publishers/google/models/${VEO_MODEL}:predictLongRunning`;
+        // Global endpoint uses aiplatform.googleapis.com (no region prefix),
+        // same pattern as googleVertex.ts createVertexSettings
+        const apiHost = location === "global"
+            ? "aiplatform.googleapis.com"
+            : `${location}-aiplatform.googleapis.com`;
+        const endpoint = `https://${apiHost}/v1/projects/${project}/locations/${location}/publishers/google/models/${VEO_MODEL}:predictLongRunning`;
         // Request body structure (verified working from video.js reference)
         const requestBody = {
             instances: [
@@ -727,7 +728,12 @@ export async function generateTransitionWithVertex(firstFrame, lastFrame, prompt
  */
 async function pollOperation(modelOrEndpoint, operationName, accessToken, project, location, timeoutMs) {
     const startTime = Date.now();
-    const pollEndpoint = `https://${location}-aiplatform.googleapis.com/v1/projects/${project}/locations/${location}/publishers/google/models/${modelOrEndpoint}:fetchPredictOperation`;
+    // Global endpoint uses aiplatform.googleapis.com (no region prefix),
+    // same pattern as the predictLongRunning endpoint at line 374
+    const pollHost = location === "global"
+        ? "aiplatform.googleapis.com"
+        : `${location}-aiplatform.googleapis.com`;
+    const pollEndpoint = `https://${pollHost}/v1/projects/${project}/locations/${location}/publishers/google/models/${modelOrEndpoint}:fetchPredictOperation`;
     while (Date.now() - startTime < timeoutMs) {
         const result = await makePollRequest(pollEndpoint, operationName, accessToken);
         if (result.done) {

package/dist/cli/commands/config.d.ts

@@ -60,9 +60,9 @@ declare const ConfigSchema: z.ZodObject<{
         }, {
             model?: string | undefined;
             projectId?: string | undefined;
-            location?: string | undefined;
             credentials?: string | undefined;
             privateKey?: string | undefined;
+            location?: string | undefined;
             serviceAccountKey?: string | undefined;
             clientEmail?: string | undefined;
         }>>;
@@ -200,9 +200,9 @@ declare const ConfigSchema: z.ZodObject<{
         vertex?: {
             model?: string | undefined;
             projectId?: string | undefined;
-            location?: string | undefined;
             credentials?: string | undefined;
             privateKey?: string | undefined;
+            location?: string | undefined;
             serviceAccountKey?: string | undefined;
             clientEmail?: string | undefined;
         } | undefined;
@@ -569,9 +569,9 @@ declare const ConfigSchema: z.ZodObject<{
         vertex?: {
             model?: string | undefined;
             projectId?: string | undefined;
-            location?: string | undefined;
             credentials?: string | undefined;
             privateKey?: string | undefined;
+            location?: string | undefined;
             serviceAccountKey?: string | undefined;
             clientEmail?: string | undefined;
         } | undefined;

package/dist/cli/commands/observability.d.ts

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/**
+ * NeuroLink CLI Observability Commands
+ *
+ * Commands for monitoring and managing observability features:
+ * - status: Show telemetry status
+ * - metrics: Show metrics summary
+ * - exporters: List configured exporters
+ * - costs: Show cost breakdown
+ */
+import type { CommandModule } from "yargs";
+/**
+ * Observability command arguments
+ */
+type ObservabilityCommandArgs = {
+    format?: "text" | "json" | "table";
+    quiet?: boolean;
+};
+type StatusArgs = ObservabilityCommandArgs;
+type MetricsArgs = ObservabilityCommandArgs & {
+    detailed?: boolean;
+};
+type ExportersArgs = ObservabilityCommandArgs;
+type CostsArgs = ObservabilityCommandArgs & {
+    byModel?: boolean;
+    byProvider?: boolean;
+};
+/**
+ * Observability Command Factory
+ */
+export declare class ObservabilityCommandFactory {
+    /**
+     * Create the observability command group
+     */
+    static createObservabilityCommands(): CommandModule<object, object>;
+    /**
+     * Create the status subcommand
+     */
+    static createStatusCommand(): CommandModule<object, StatusArgs>;
+    /**
+     * Create the metrics subcommand
+     */
+    static createMetricsCommand(): CommandModule<object, MetricsArgs>;
+    /**
+     * Create the exporters subcommand
+     */
+    static createExportersCommand(): CommandModule<object, ExportersArgs>;
+    /**
+     * Create the costs subcommand
+     */
+    static createCostsCommand(): CommandModule<object, CostsArgs>;
+}
+export {};