@juspay/neurolink 9.88.12 → 9.90.0

package/CHANGELOG.md

@@ -1,3 +1,19 @@
+## [9.90.0](https://github.com/juspay/neurolink/compare/v9.89.0...v9.90.0) (2026-07-17)
+
+### Features
+
+- **(rag):** Pinecone, pgvector, and Chroma vector-store adapters (client injection) ([615e83b](https://github.com/juspay/neurolink/commit/615e83b604665922b4081c709694a268d43a0b95))
+
+### Bug Fixes
+
+- **(deps):** move lazily-imported cloud provider SDKs to optionalDependencies ([732f8aa](https://github.com/juspay/neurolink/commit/732f8aa2ff4009b987fb97d937747a168a6ef85b))
+
+## [9.89.0](https://github.com/juspay/neurolink/compare/v9.88.12...v9.89.0) (2026-07-17)
+
+### Features
+
+- **(examples):** add degit-able starter templates — chat, mcp-client, proxy-failover ([e737e18](https://github.com/juspay/neurolink/commit/e737e18e071d8bad91736ba07ad4193fcbc9f15d))
+
 ## [9.88.12](https://github.com/juspay/neurolink/compare/v9.88.11...v9.88.12) (2026-07-16)
 
 ### Bug Fixes

package/README.md

@@ -36,7 +36,7 @@ for await (const chunk of result.stream) {
 
 Extracted from production systems at Juspay, NeuroLink provides a practical, TypeScript-first way to integrate AI into any application. Whether you're building with OpenAI, Anthropic, Google, AWS Bedrock, Azure, or any of our 30+ supported providers, NeuroLink gives you a single, consistent interface that works everywhere.
 
-**Why NeuroLink?** Switch providers with a single parameter change, leverage 64+ built-in tools and MCP servers, deploy with confidence using enterprise features like Redis memory and multi-provider failover, and optimize costs automatically with intelligent routing. Use it via our professional CLI or TypeScript SDK—whichever fits your workflow.
+**Why NeuroLink?** Switch providers with a single parameter change, leverage built-in tools plus any MCP-compliant tool server, deploy with confidence using enterprise features like Redis memory and multi-provider failover, and optimize costs automatically with intelligent routing. Use it via our professional CLI or TypeScript SDK—whichever fits your workflow.
 
 **Where we're headed:** We're building for the future of AI—edge-first execution and continuous streaming architectures that make AI practically free and universally available. **[Read our vision →](docs/about/vision.md)**
 
@@ -489,7 +489,7 @@ NeuroLink is a comprehensive AI development platform. Every feature below is shi
 | `calculateMath`      | Mathematical operations  | ✅                      | [Tool Reference](docs/sdk/custom-tools.md) |
 | `websearchGrounding` | Google Vertex web search | ⚠️ Requires credentials | [Tool Reference](docs/sdk/custom-tools.md) |
 
-**58+ External MCP Servers** supported (GitHub, PostgreSQL, Google Drive, Slack, and more):
+**External MCP servers** — connect any MCP-compliant server via `neurolink mcp add`; 11 popular servers (GitHub, PostgreSQL, Google Drive, Slack, and more) ship with ready-made configs:
 
 ```typescript
 // stdio transport - local MCP servers via command execution
@@ -993,7 +993,7 @@ Full command and API breakdown lives in [`docs/cli/commands.md`](docs/cli/comman
 
 - [Enterprise HITL Guide](docs/features/enterprise-hitl.md) - Approval workflows for high-stakes operations
 - [Interactive CLI Guide](docs/features/interactive-cli.md) - AI development environment
-- [MCP Tools Showcase](docs/features/mcp-tools-showcase.md) - 58+ external tools & 6 built-in tools
+- [MCP Tools Showcase](docs/features/mcp-tools-showcase.md) - 6 built-in tools & connecting external MCP servers
 
 **Provider Intelligence:**
 
@@ -1036,6 +1036,7 @@ Full command and API breakdown lives in [`docs/cli/commands.md`](docs/cli/comman
 
 - Real-time chat and community → [Discord](https://discord.gg/cZa8DrDhSR)
 - Bug reports and feature requests → [GitHub Issues](https://github.com/juspay/neurolink/issues)
+- New here? Start with a [good first issue](https://github.com/juspay/neurolink/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)
 - Questions and discussions → [GitHub Discussions](https://github.com/juspay/neurolink/discussions)
 - Development workflow, testing, and pull request guidelines → [`docs/development/contributing.md`](docs/development/contributing.md)
 - Documentation improvements → open a PR referencing the [documentation matrix](docs/tracking/FEATURE-DOC-MATRIX.md).

package/dist/adapters/tts/googleTTSHandler.d.ts

@@ -24,6 +24,7 @@ export declare class GoogleTTSHandler implements TTSHandler {
      * before invoking provider handlers, not inside this class.
      */
     readonly maxTextLength: number;
+    private readonly credentialsPath;
     constructor(credentialsPath?: string);
     /**
      * Validate that the provider is properly configured
@@ -31,6 +32,15 @@ export declare class GoogleTTSHandler implements TTSHandler {
      * @returns True if provider can generate TTS
      */
     isConfigured(): boolean;
+    /**
+     * Lazily construct (and cache) the Google Cloud TTS client.
+     *
+     * `@google-cloud/text-to-speech` is an optional dependency: importing it
+     * only happens here, on first actual use, so a handler instance can be
+     * constructed (e.g. during auto-registration at module load) without the
+     * package being installed.
+     */
+    private getClient;
     /**
      * Get available voices for the provider
      *

package/dist/adapters/tts/googleTTSHandler.js

@@ -1,12 +1,3 @@
-/**
- * Google Cloud Text-to-Speech Handler
- *
- * Handler for Google Cloud Text-to-Speech API integration.
- *
- * @module adapters/tts/googleTTSHandler
- * @see https://cloud.google.com/text-to-speech/docs
- */
-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";
@@ -36,11 +27,10 @@ export class GoogleTTSHandler {
      * before invoking provider handlers, not inside this class.
      */
     maxTextLength = GoogleTTSHandler.DEFAULT_MAX_TEXT_LENGTH;
+    credentialsPath;
     constructor(credentialsPath) {
-        const path = credentialsPath ?? process.env.GOOGLE_APPLICATION_CREDENTIALS;
-        if (path) {
-            this.client = new TextToSpeechClient({ keyFilename: path });
-        }
+        this.credentialsPath =
+            credentialsPath ?? process.env.GOOGLE_APPLICATION_CREDENTIALS;
     }
     /**
      * Validate that the provider is properly configured
@@ -48,7 +38,24 @@ export class GoogleTTSHandler {
      * @returns True if provider can generate TTS
      */
     isConfigured() {
-        return this.client !== null;
+        return this.credentialsPath !== undefined;
+    }
+    /**
+     * Lazily construct (and cache) the Google Cloud TTS client.
+     *
+     * `@google-cloud/text-to-speech` is an optional dependency: importing it
+     * only happens here, on first actual use, so a handler instance can be
+     * constructed (e.g. during auto-registration at module load) without the
+     * package being installed.
+     */
+    async getClient() {
+        if (!this.client) {
+            const { TextToSpeechClient } = await import("@google-cloud/text-to-speech");
+            this.client = new TextToSpeechClient({
+                keyFilename: this.credentialsPath,
+            });
+        }
+        return this.client;
     }
     /**
      * Get available voices for the provider
@@ -60,7 +67,7 @@ export class GoogleTTSHandler {
      * @returns List of available voices
      */
     async getVoices(languageCode) {
-        if (!this.client) {
+        if (!this.isConfigured()) {
             throw new TTSError({
                 code: TTS_ERROR_CODES.PROVIDER_NOT_CONFIGURED,
                 message: "Google Cloud TTS client not initialized. Set GOOGLE_APPLICATION_CREDENTIALS or pass credentials path.",
@@ -69,6 +76,7 @@ export class GoogleTTSHandler {
                 retriable: false,
             });
         }
+        const client = await this.getClient();
         const span = SpanSerializer.createSpan(SpanType.TTS, "tts.google.listVoices", {
             "tts.operation": "listVoices",
             "tts.provider": "google",
@@ -84,7 +92,7 @@ export class GoogleTTSHandler {
                 return this.voicesCache.voices;
             }
             // Call Google Cloud listVoices API
-            const [response] = await this.client.listVoices(languageCode ? { languageCode } : {});
+            const [response] = await 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);
@@ -149,7 +157,7 @@ export class GoogleTTSHandler {
      * @returns Audio buffer with metadata
      */
     async synthesize(text, options) {
-        if (!this.client) {
+        if (!this.isConfigured()) {
             throw new TTSError({
                 code: TTS_ERROR_CODES.PROVIDER_NOT_CONFIGURED,
                 message: "Google Cloud TTS client not initialized. Set GOOGLE_APPLICATION_CREDENTIALS or pass credentials path.",
@@ -158,6 +166,7 @@ export class GoogleTTSHandler {
                 retriable: false,
             });
         }
+        const client = await this.getClient();
         const voiceId = options.voice ?? "en-US-Neural2-C";
         const span = SpanSerializer.createSpan(SpanType.TTS, "tts.google.synthesize", {
             "tts.operation": "synthesize",
@@ -196,7 +205,7 @@ export class GoogleTTSHandler {
                     volumeGainDb: options.volumeGainDb ?? 0.0,
                 },
             };
-            const [response] = await this.client.synthesizeSpeech(request, {
+            const [response] = await client.synthesizeSpeech(request, {
                 timeout: GoogleTTSHandler.DEFAULT_API_TIMEOUT_MS,
             });
             const audioContent = response.audioContent;

package/dist/agent/directTools.js

@@ -3,7 +3,6 @@ import * as fs from "fs";
 import * as path from "path";
 import { execFile } from "child_process";
 import { logger } from "../utils/logger.js";
-import { VertexAI } from "@google-cloud/vertexai";
 import { CSVProcessor } from "../utils/csvProcessor.js";
 import { shouldEnableBashTool } from "../utils/toolUtils.js";
 import { tool } from "../utils/tool.js";
@@ -604,6 +603,7 @@ export const directAgentTools = {
                     };
                 }
                 const limitedResults = Math.min(Math.max(maxResults, 1), 5);
+                const { VertexAI } = await import("@google-cloud/vertexai");
                 const vertex_ai = new VertexAI({
                     project: hasProjectId,
                     location: projectLocation,