@juspay/neurolink 10.12.8 → 11.0.0

package/dist/lib/providers/huggingFace/client.d.ts

@@ -14,7 +14,7 @@ import { OpenAIChatCompletionsProvider } from "../openaiChatCompletionsBase.js";
  * @see https://huggingface.co/docs/api-inference/index
  */
 export declare class HuggingFaceProvider extends OpenAIChatCompletionsProvider {
-    constructor(modelName?: string, sdk?: unknown, credentials?: NeurolinkCredentials["huggingFace"]);
+    constructor(modelName?: string, sdk?: unknown, _region?: string, credentials?: NeurolinkCredentials["huggingFace"]);
     protected getProviderName(): AIProviderName;
     protected getDefaultModel(): string;
     protected getFallbackModelName(): string;

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

@@ -20,7 +20,7 @@ const getDefaultHuggingFaceModel = () => getProviderModel("HUGGINGFACE_MODEL", "
  * @see https://huggingface.co/docs/api-inference/index
  */
 export class HuggingFaceProvider extends OpenAIChatCompletionsProvider {
-    constructor(modelName, sdk, credentials) {
+    constructor(modelName, sdk, _region, credentials) {
         const apiKey = credentials?.apiKey?.trim()
             ? credentials.apiKey.trim()
             : getHuggingFaceApiKey();

package/dist/lib/providers/huggingFace/index.d.ts

@@ -1,2 +1 @@
 export * from "./client.js";
-export * from "./utils.js";

package/dist/lib/providers/huggingFace/index.js

@@ -1,3 +1,2 @@
 export * from "./client.js";
-export * from "./utils.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/providers/jina.d.ts

@@ -56,4 +56,3 @@ export declare class JinaProvider extends BaseProvider {
         baseURL: string;
     };
 }
-export default JinaProvider;

package/dist/lib/providers/jina.js

@@ -214,5 +214,4 @@ export class JinaProvider extends BaseProvider {
         };
     }
 }
-export default JinaProvider;
 //# sourceMappingURL=jina.js.map

package/dist/lib/providers/litellm/index.d.ts

@@ -1,3 +1 @@
 export * from "./client.js";
-export * from "./constants.js";
-export * from "./utils.js";

package/dist/lib/providers/litellm/index.js

@@ -1,4 +1,2 @@
 export * from "./client.js";
-export * from "./constants.js";
-export * from "./utils.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/providers/llamaCpp.d.ts

@@ -15,6 +15,7 @@ import { OpenAIChatCompletionsProvider } from "./openaiChatCompletionsBase.js";
  */
 export declare class LlamaCppProvider extends OpenAIChatCompletionsProvider {
     constructor(modelName?: string, sdk?: unknown, _region?: string, credentials?: NeurolinkCredentials["llamacpp"]);
+    validateConfiguration(): Promise<boolean>;
     protected getProviderName(): AIProviderName;
     protected getDefaultModel(): string;
     protected getFallbackModelName(): string;

package/dist/lib/providers/llamaCpp.js

@@ -36,6 +36,9 @@ export class LlamaCppProvider extends OpenAIChatCompletionsProvider {
             baseURL: redactUrlCredentials(this.config.baseURL),
         });
     }
+    async validateConfiguration() {
+        return this.probeModelsEndpoint(this.getAuthHeaders());
+    }
     getProviderName() {
         return "llamacpp";
     }

package/dist/lib/providers/lmStudio.js

@@ -1,4 +1,3 @@
-import { createProxyFetch } from "../proxy/proxyFetch.js";
 import { InvalidModelError, NetworkError, ProviderError, } from "../types/index.js";
 import { logger } from "../utils/logger.js";
 import { redactUrlCredentials } from "../utils/logSanitize.js";
@@ -70,28 +69,9 @@ export class LMStudioProvider extends OpenAIChatCompletionsProvider {
         return new ProviderError(`LM Studio error: ${message}`, "lm-studio");
     }
     async validateConfiguration() {
-        try {
-            const url = `${this.config.baseURL.replace(/\/$/, "")}/models`;
-            const proxyFetch = createProxyFetch();
-            const r = await proxyFetch(url, {
-                headers: this.config.apiKey && this.config.apiKey !== LM_STUDIO_PLACEHOLDER_KEY
-                    ? { Authorization: `Bearer ${this.config.apiKey}` }
-                    : undefined,
-                signal: AbortSignal.timeout(5000),
-            });
-            if (!r.ok) {
-                return false;
-            }
-            // A 200 with an empty data array means LM Studio is up but no model is
-            // loaded — `resolveModelName()` will fall back to FALLBACK_MODEL and the
-            // first real request will fail. Require at least one loaded model so
-            // health checks honestly reflect whether the provider is usable.
-            const data = (await r.json().catch(() => null));
-            return Boolean(data?.data?.some((m) => typeof m?.id === "string" && m.id.trim().length > 0));
-        }
-        catch {
-            return false;
-        }
+        return this.probeModelsEndpoint(this.config.apiKey && this.config.apiKey !== LM_STUDIO_PLACEHOLDER_KEY
+            ? { Authorization: `Bearer ${this.config.apiKey}` }
+            : {});
     }
     getConfiguration() {
         return {

package/dist/lib/providers/nvidiaNim/index.d.ts

@@ -1,3 +1,2 @@
 export * from "./client.js";
 export * from "./constants.js";
-export * from "./utils.js";

package/dist/lib/providers/nvidiaNim/index.js

@@ -1,4 +1,3 @@
 export * from "./client.js";
 export * from "./constants.js";
-export * from "./utils.js";
 //# sourceMappingURL=index.js.map

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

@@ -181,29 +181,7 @@ export class OllamaProvider extends OpenAIChatCompletionsProvider {
      * back to a model that the first real request can't serve, so report unusable.
      */
     async validateConfiguration() {
-        try {
-            const url = `${stripTrailingSlash(this.config.baseURL)}/models`;
-            const proxyFetch = createProxyFetch();
-            const r = await proxyFetch(url, {
-                headers: {
-                    ...this.getAuthHeaders(),
-                    "Content-Type": "application/json",
-                },
-                signal: AbortSignal.timeout(5000),
-            });
-            if (!r.ok) {
-                return false;
-            }
-            const data = (await r.json().catch(() => null));
-            return Boolean(data?.data?.some((m) => typeof m?.id === "string" && m.id.trim().length > 0));
-        }
-        catch (error) {
-            logger.debug("Ollama validateConfiguration probe failed", {
-                baseURL: redactUrlCredentials(this.config.baseURL),
-                error: error instanceof Error ? error.message : String(error),
-            });
-            return false;
-        }
+        return this.probeModelsEndpoint(this.getAuthHeaders());
     }
     getConfiguration() {
         return {

package/dist/lib/providers/ollama/index.d.ts

@@ -1,3 +1,2 @@
 export * from "./client.js";
 export * from "./constants.js";
-export * from "./utils.js";

package/dist/lib/providers/ollama/index.js

@@ -1,4 +1,3 @@
 export * from "./client.js";
 export * from "./constants.js";
-export * from "./utils.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/providers/openAI/index.d.ts

@@ -1,3 +1 @@
 export * from "./client.js";
-export * from "./constants.js";
-export * from "./utils.js";

package/dist/lib/providers/openAI/index.js

@@ -1,4 +1,2 @@
 export * from "./client.js";
-export * from "./constants.js";
-export * from "./utils.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/providers/openRouter/utils.d.ts

@@ -1,3 +1 @@
-import type { OpenRouterConfig } from "../../types/index.js";
-export declare const getOpenRouterConfig: () => OpenRouterConfig;
 export declare const getDefaultOpenRouterModel: () => string;

package/dist/lib/providers/openRouter/utils.js

@@ -1,17 +1,5 @@
 import { OpenRouterModels } from "../../constants/enums.js";
 import { getProviderModel } from "../../utils/providerConfig.js";
-export const getOpenRouterConfig = () => {
-    const apiKey = process.env.OPENROUTER_API_KEY;
-    if (!apiKey) {
-        throw new Error("OPENROUTER_API_KEY environment variable is required. " +
-            "Get your API key at https://openrouter.ai/keys");
-    }
-    return {
-        apiKey,
-        referer: process.env.OPENROUTER_REFERER,
-        appName: process.env.OPENROUTER_APP_NAME,
-    };
-};
 export const getDefaultOpenRouterModel = () => {
     return getProviderModel("OPENROUTER_MODEL", OpenRouterModels.CLAUDE_SONNET_4_5);
 };

package/dist/lib/providers/openaiChatCompletionsBase.d.ts

@@ -166,6 +166,15 @@ export declare abstract class OpenAIChatCompletionsProvider extends BaseProvider
      * override this to probe the server's `/models` endpoint.
      */
     validateConfiguration(): Promise<boolean>;
+    /**
+     * Shared local-runtime reachability probe: GET `${baseURL}/models` with a
+     * short timeout, requiring at least one model entry with a non-empty id.
+     * Local providers (Ollama, LM Studio, llama.cpp) call this from their own
+     * validateConfiguration() override instead of relying on the base class's
+     * "apiKey is a non-empty string" default, which can't detect an
+     * unreachable local server.
+     */
+    protected probeModelsEndpoint(headers?: Record<string, string>): Promise<boolean>;
     /**
      * Snapshot of the provider's resolved configuration — part of the documented
      * public provider contract (`docs/provider-integration/00-architecture.md`).

package/dist/lib/providers/openaiChatCompletionsBase.js

@@ -26,6 +26,7 @@ import { DEFAULT_MAX_STEPS } from "../core/constants.js";
 import { streamAnalyticsCollector } from "../core/streamAnalytics.js";
 import { createProxyFetch } from "../proxy/proxyFetch.js";
 import { logger } from "../utils/logger.js";
+import { redactUrlCredentials } from "../utils/logSanitize.js";
 import { NoOutputGeneratedError } from "../utils/generationErrors.js";
 import { buildNoOutputSentinel, stampNoOutputSpan, } from "../utils/noOutputSentinel.js";
 import { composeAbortSignalsScoped, createTimeoutController, mergeAbortSignals, } from "../utils/timeout.js";
@@ -272,6 +273,38 @@ export class OpenAIChatCompletionsProvider extends BaseProvider {
         return (typeof this.config.apiKey === "string" &&
             this.config.apiKey.trim().length > 0);
     }
+    /**
+     * Shared local-runtime reachability probe: GET `${baseURL}/models` with a
+     * short timeout, requiring at least one model entry with a non-empty id.
+     * Local providers (Ollama, LM Studio, llama.cpp) call this from their own
+     * validateConfiguration() override instead of relying on the base class's
+     * "apiKey is a non-empty string" default, which can't detect an
+     * unreachable local server.
+     */
+    async probeModelsEndpoint(headers = {}) {
+        try {
+            const url = `${stripTrailingSlash(this.config.baseURL)}/models`;
+            const proxyFetch = createProxyFetch();
+            const response = await proxyFetch(url, {
+                headers: { ...headers, "Content-Type": "application/json" },
+                signal: AbortSignal.timeout(5000),
+            });
+            if (!response.ok) {
+                return false;
+            }
+            const data = (await response
+                .json()
+                .catch(() => null));
+            return Boolean(data?.data?.some((m) => typeof m?.id === "string" && m.id.trim().length > 0));
+        }
+        catch (error) {
+            logger.debug(`[${this.constructor.name}] probeModelsEndpoint failed`, {
+                baseURL: redactUrlCredentials(this.config.baseURL),
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return false;
+        }
+    }
     /**
      * Snapshot of the provider's resolved configuration — part of the documented
      * public provider contract (`docs/provider-integration/00-architecture.md`).

package/dist/lib/providers/perplexity.d.ts

@@ -6,7 +6,8 @@ import { OpenAIChatCompletionsProvider } from "./openaiChatCompletionsBase.js";
  *
  * Sonar models with built-in web grounding. OpenAI-compatible chat
  * completions at api.perplexity.ai. Best for queries that need fresh
- * web context (search-augmented answers + citations).
+ * web context (search-augmented answers). Citation data, if the API returns
+ * any, is not extracted or exposed by this provider.
  *
  * All request/stream/tool-loop orchestration lives in
  * `OpenAIChatCompletionsProvider`; this class only declares configuration

package/dist/lib/providers/perplexity.js

@@ -13,7 +13,8 @@ const getDefaultPerplexityModel = () => getProviderModel("PERPLEXITY_MODEL", Per
  *
  * Sonar models with built-in web grounding. OpenAI-compatible chat
  * completions at api.perplexity.ai. Best for queries that need fresh
- * web context (search-augmented answers + citations).
+ * web context (search-augmented answers). Citation data, if the API returns
+ * any, is not extracted or exposed by this provider.
  *
  * All request/stream/tool-loop orchestration lives in
  * `OpenAIChatCompletionsProvider`; this class only declares configuration

package/dist/lib/providers/replicate.d.ts

@@ -72,4 +72,3 @@ export declare class ReplicateProvider extends BaseProvider {
         baseURL: string | undefined;
     };
 }
-export default ReplicateProvider;

package/dist/lib/providers/replicate.js

@@ -34,6 +34,18 @@ function flattenReplicateOutput(output) {
     }
     return "";
 }
+/**
+ * Resolve Replicate credentials, aliasing the standard `apiKey`/`baseURL`
+ * field names (shared with every other provider in `NeurolinkCredentials`)
+ * against the legacy `apiToken`/`baseUrl` names. The standard name wins
+ * when both are present; used identically for instance-level and per-call
+ * credentials so aliasing never drifts between the two.
+ */
+function resolveReplicateCredentials(credentials) {
+    const apiToken = credentials?.apiKey?.trim() || credentials?.apiToken?.trim();
+    const baseUrl = credentials?.baseURL || credentials?.baseUrl;
+    return { apiToken, baseUrl };
+}
 /**
  * Replicate LLM Provider — predict-then-stream pattern.
  *
@@ -63,12 +75,12 @@ export class ReplicateProvider extends BaseProvider {
     constructor(modelName, sdk, _region, credentials) {
         const validatedNeurolink = isNeuroLink(sdk) ? sdk : undefined;
         super(modelName, "replicate", validatedNeurolink);
-        const overrideToken = credentials?.apiToken?.trim();
+        const { apiToken: overrideToken, baseUrl: overrideBaseUrl } = resolveReplicateCredentials(credentials);
         this.apiToken =
             overrideToken && overrideToken.length > 0
                 ? overrideToken
                 : validateApiKey(createReplicateConfig());
-        this.baseURL = credentials?.baseUrl;
+        this.baseURL = overrideBaseUrl;
         logger.debug("Replicate Provider initialized", {
             modelName: this.modelName,
             baseURL: this.baseURL,
@@ -109,7 +121,7 @@ export class ReplicateProvider extends BaseProvider {
         const options = typeof optionsOrPrompt === "string"
             ? { prompt: optionsOrPrompt }
             : optionsOrPrompt;
-        const { IMAGE_GENERATION_MODELS } = await import("../core/constants.js");
+        const { isImageGenerationModel } = await import("../core/constants.js");
         // Delegate special output modes to base class (which never calls getAISDKModel for these)
         if (options.output?.mode === "video" ||
             options.output?.mode === "avatar" ||
@@ -117,7 +129,7 @@ export class ReplicateProvider extends BaseProvider {
             return super.generate(options, _analysisSchema);
         }
         // Image-gen models: delegate to base which calls executeImageGeneration()
-        const isImageModel = IMAGE_GENERATION_MODELS.some((m) => this.modelName.includes(m));
+        const isImageModel = isImageGenerationModel(this.modelName);
         const requestsNonImageOutput = options.output?.format === "json" ||
             options.output?.format === "structured" ||
             options.output?.format === "text";
@@ -175,8 +187,9 @@ export class ReplicateProvider extends BaseProvider {
         const startTime = Date.now();
         // Resolve per-call credentials first, then fall back to instance-level.
         const perCallCreds = options.credentials?.replicate;
-        const effectiveToken = perCallCreds?.apiToken?.trim() || this.apiToken;
-        const effectiveBaseUrl = perCallCreds?.baseUrl || this.baseURL;
+        const resolvedPerCall = resolveReplicateCredentials(perCallCreds);
+        const effectiveToken = resolvedPerCall.apiToken || this.apiToken;
+        const effectiveBaseUrl = resolvedPerCall.baseUrl || this.baseURL;
         const auth = getReplicateAuth({
             apiToken: effectiveToken,
             baseUrl: effectiveBaseUrl,
@@ -255,8 +268,9 @@ export class ReplicateProvider extends BaseProvider {
         const startTime = Date.now();
         // Resolve per-call credentials first, then fall back to instance-level.
         const perCallCreds = options.credentials?.replicate;
-        const effectiveToken = perCallCreds?.apiToken?.trim() || this.apiToken;
-        const effectiveBaseUrl = perCallCreds?.baseUrl || this.baseURL;
+        const resolvedPerCall = resolveReplicateCredentials(perCallCreds);
+        const effectiveToken = resolvedPerCall.apiToken || this.apiToken;
+        const effectiveBaseUrl = resolvedPerCall.baseUrl || this.baseURL;
         const auth = getReplicateAuth({
             apiToken: effectiveToken,
             baseUrl: effectiveBaseUrl,
@@ -399,5 +413,4 @@ export class ReplicateProvider extends BaseProvider {
         };
     }
 }
-export default ReplicateProvider;
 //# sourceMappingURL=replicate.js.map

package/dist/lib/providers/voyage.d.ts

@@ -44,4 +44,3 @@ export declare class VoyageProvider extends BaseProvider {
         baseURL: string;
     };
 }
-export default VoyageProvider;

package/dist/lib/providers/voyage.js

@@ -173,5 +173,4 @@ export class VoyageProvider extends BaseProvider {
         };
     }
 }
-export default VoyageProvider;
 //# sourceMappingURL=voyage.js.map

package/dist/lib/types/index.d.ts

@@ -60,7 +60,6 @@ export * from "./tools.js";
 export * from "./vectorStoreChroma.js";
 export * from "./vectorStorePinecone.js";
 export * from "./voice.js";
-export * from "./universalProviderOptions.js";
 export * from "./utilities.js";
 export * from "./workflow.js";
 export * from "./ioProcessor.js";

package/dist/lib/types/index.js

@@ -61,7 +61,6 @@ export * from "./tools.js";
 export * from "./vectorStoreChroma.js";
 export * from "./vectorStorePinecone.js";
 export * from "./voice.js";
-export * from "./universalProviderOptions.js";
 export * from "./utilities.js";
 export * from "./workflow.js";
 // Processor base types are re-exported via ./processor.js

package/dist/lib/types/providers.d.ts

@@ -200,6 +200,8 @@ export type NeurolinkCredentials = {
     replicate?: {
         apiToken?: string;
         baseUrl?: string;
+        apiKey?: string;
+        baseURL?: string;
     };
     voyage?: {
         apiKey?: string;
@@ -1531,17 +1533,6 @@ export declare namespace TelemetryTypes {
         recordException(exception: unknown): void;
     };
 }
-/**
- * OpenRouter provider configuration
- */
-export type OpenRouterConfig = {
-    /** OpenRouter API key */
-    apiKey: string;
-    /** HTTP Referer header for attribution on openrouter.ai/activity */
-    referer?: string;
-    /** App name for X-Title header attribution */
-    appName?: string;
-};
 /**
  * OpenRouter model information from /api/v1/models endpoint
  */

package/dist/lib/types/utilities.d.ts

@@ -279,3 +279,32 @@ export type JsonCoercionResult = {
      */
     truncated: boolean;
 };
+/**
+ * Decision returned by `recoverScalarRoot`. Each caller applies it to its own
+ * result shape and logger prefix, preserving its existing warning behaviour:
+ *
+ *   - `empty`     — the text is a JSON-encoded empty string (an EMPTY
+ *                   completion, not a recovered scalar). Callers normalize to a
+ *                   true empty.
+ *   - `accepted`  — a scalar root the caller's schema accepts; safe to publish
+ *                   as `structuredData`.
+ *   - `rejected`  — a scalar root the caller's schema rejects (e.g. a raw
+ *                   string under an object schema — the shape a truncated
+ *                   response degrades to). Do NOT publish it.
+ *   - `nullish`   — the text is the JSON literals `null`/`undefined`; there is
+ *                   no structured value to publish.
+ *   - `not-json`  — the text is not JSON at all.
+ */
+export type ScalarRecoveryDecision = {
+    kind: "empty";
+} | {
+    kind: "accepted";
+    value: unknown;
+} | {
+    kind: "rejected";
+    value: unknown;
+} | {
+    kind: "nullish";
+} | {
+    kind: "not-json";
+};

package/dist/lib/utils/json/coerce.d.ts

@@ -1,4 +1,24 @@
-import type { JsonCoercionResult, ValidationSchema } from "../../types/index.js";
+import type { JsonCoercionResult, ScalarRecoveryDecision, ValidationSchema } from "../../types/index.js";
+/**
+ * Does `value` satisfy `schema`? A schema we cannot validate with (absent, or
+ * without a Zod-style `safeParse`) accepts everything — callers use this as a
+ * gate, not as proof, so an unknown schema must never block a value.
+ *
+ * Exists so the consumers of coerceJsonToSchema can refuse to publish a
+ * recovered value as `structuredData` when the caller's schema rejects it —
+ * e.g. a raw *string* under an object schema, which is the shape a truncated
+ * response degrades to.
+ */
+export declare function schemaAccepts(schema: ValidationSchema | undefined, value: unknown): boolean;
+/**
+ * Recover a JSON *scalar* root (string/number/boolean) from model text. The
+ * object/array case is handled by `coerceJsonToSchema`; this covers the
+ * residual scalar root after that path returns null. Encapsulates the JSON
+ * parsing, the empty-string normalization, and the `schemaAccepts` gate so the
+ * same policy cannot drift between consumers (`neurolink.recoverStructuredData`
+ * and `GenerationHandler.coerceTextMode`).
+ */
+export declare function recoverScalarRoot(text: string, schema: ValidationSchema | undefined): ScalarRecoveryDecision;
 /**
  * Try to produce canonical JSON from `text`. Returns null when no JSON object
  * could be recovered (caller should then keep the raw text).