@juspay/neurolink 12.56.0 → 12.57.0

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

@@ -13,7 +13,7 @@ import type { ProviderConfigOptions, SetupArgs } from "../../types/index.js";
  * perplexity, sambanova, together-ai, xai — mistral is the 9th catalog
  * provider but keeps its own handleMistralSetup() flow above, so it's
  * excluded here), spread directly from the catalog JSON via
- * buildCatalogConfigOptions(); decide-kind catalog entries (laya, xor) are
+ * buildCatalogConfigOptions(); decide-kind catalog entries (laya, xor, subq) are
  * spread the same way from getDecideCatalogEntries(). The hand rows listed
  * first reuse the existing createXConfig() factories in providerConfig.ts; the
  * remaining 5 (ollama, litellm, sagemaker, lm-studio, llamacpp) don't have a

package/dist/cli/commands/setup.js

@@ -150,7 +150,7 @@ const PROVIDERS = [
  * perplexity, sambanova, together-ai, xai — mistral is the 9th catalog
  * provider but keeps its own handleMistralSetup() flow above, so it's
  * excluded here), spread directly from the catalog JSON via
- * buildCatalogConfigOptions(); decide-kind catalog entries (laya, xor) are
+ * buildCatalogConfigOptions(); decide-kind catalog entries (laya, xor, subq) are
  * spread the same way from getDecideCatalogEntries(). The hand rows listed
  * first reuse the existing createXConfig() factories in providerConfig.ts; the
  * remaining 5 (ollama, litellm, sagemaker, lm-studio, llamacpp) don't have a

package/dist/cli/factories/commandFactory.js

@@ -649,7 +649,7 @@ export class CLICommandFactory {
         },
         classifierStrategy: {
             type: "string",
-            description: "Classifier strategy: 'auto' (default — 'jev' when a decision provider is configured, such as TYPESAFE_API_KEY, LAYA_API_KEY with LAYA_BASE_URL, XOR_API_KEY with XOR_BASE_URL, PERPLEXITY_API_KEY, or CLOUDFLARE_API_KEY with CLOUDFLARE_ACCOUNT_ID, else 'heuristic'), 'heuristic' (no LLM), 'llm' (a cheap model picks per prompt), or 'jev' (a System One decision model — TypeSafe Jev, Laya, XOR, Perplexity or Cloudflare Clef — with calibrated confidence).",
+            description: "Classifier strategy: 'auto' (default — 'jev' when a decision provider is configured, such as TYPESAFE_API_KEY, LAYA_API_KEY with LAYA_BASE_URL, XOR_API_KEY with XOR_BASE_URL, SUBQ_API_KEY, PERPLEXITY_API_KEY, or CLOUDFLARE_API_KEY with CLOUDFLARE_ACCOUNT_ID, else 'heuristic'), 'heuristic' (no LLM), 'llm' (a cheap model picks per prompt), or 'jev' (a System One decision model — TypeSafe Jev, Laya, XOR, SubQ, Perplexity or Cloudflare Clef — with calibrated confidence).",
             choices: ["auto", "heuristic", "llm", "jev"],
             alias: "classifier-strategy",
         },

package/dist/constants/enums.d.ts

@@ -89,6 +89,7 @@ export declare enum AIProviderName {
     STACKIT = "stackit",
     STEPFUN = "stepfun",
     SUBCONSCIOUS = "subconscious",
+    SUBQ = "subq",
     SYNTHETIC = "synthetic",
     TELNYX = "telnyx",
     THINKING_MACHINES = "thinking-machines",
@@ -1611,6 +1612,9 @@ export declare enum SubconsciousModels {
     SUBCONSCIOUS_DEEPSEEK_V4_1_FLASH_MARATHON = "subconscious/deepseek-v4.1-flash-marathon",
     SUBCONSCIOUS_TIM_QWEN3_6_27B = "subconscious/tim-qwen3.6-27b"
 }
+export declare enum SubqModels {
+    SUBQ_SNAP_PREVIEW = "subq-snap-preview"
+}
 export declare enum SyntheticModels {
     SYN_LARGE_TEXT = "syn:large:text",
     SYN_SMALL_TEXT = "syn:small:text",

package/dist/constants/enums.js

@@ -94,6 +94,7 @@ export var AIProviderName;
     AIProviderName["STACKIT"] = "stackit";
     AIProviderName["STEPFUN"] = "stepfun";
     AIProviderName["SUBCONSCIOUS"] = "subconscious";
+    AIProviderName["SUBQ"] = "subq";
     AIProviderName["SYNTHETIC"] = "synthetic";
     AIProviderName["TELNYX"] = "telnyx";
     AIProviderName["THINKING_MACHINES"] = "thinking-machines";
@@ -1920,6 +1921,10 @@ export var SubconsciousModels;
     SubconsciousModels["SUBCONSCIOUS_DEEPSEEK_V4_1_FLASH_MARATHON"] = "subconscious/deepseek-v4.1-flash-marathon";
     SubconsciousModels["SUBCONSCIOUS_TIM_QWEN3_6_27B"] = "subconscious/tim-qwen3.6-27b";
 })(SubconsciousModels || (SubconsciousModels = {}));
+export var SubqModels;
+(function (SubqModels) {
+    SubqModels["SUBQ_SNAP_PREVIEW"] = "subq-snap-preview";
+})(SubqModels || (SubqModels = {}));
 export var SyntheticModels;
 (function (SyntheticModels) {
     SyntheticModels["SYN_LARGE_TEXT"] = "syn:large:text";

package/dist/factories/providerDescriptors.js

@@ -468,22 +468,27 @@ const HAND_DESCRIPTORS = [
         setupUrl: "https://console.typesafe.ai/keys",
     },
     // Decision precedence is decideOrder, not position: typesafe 1, laya 2 and
-    // xor 3 (from catalog/laya.json and catalog/xor.json), perplexity-decider 4,
-    // cloudflare-clef 5.
+    // xor 3 (from catalog/laya.json and catalog/xor.json), subq 4 (from
+    // catalog/subq.json), perplexity-decider 5, cloudflare-clef 6.
     // resolveDefaultDecisionProvider() returns the first configured
     // DECISION_PROVIDERS entry in that order, so a host configured for several
     // keeps Jev for every built-in consumer and reaches the others only by
     // naming them. Renumbering silently changes which model routes, compacts
     // and plans for every such host.
+    // perplexity-decider and cloudflare-clef come last because each shares its
+    // environment key with a text provider: a key set only for that text provider
+    // must not displace a decision provider a host set up on purpose. subq is
+    // ahead of them only because SUBQ_API_KEY belongs to no other provider.
     {
         name: AIProviderName.PERPLEXITY_DECIDER,
         aliases: [],
         credentialsKey: "perplexityDecider",
         envVars: {
             // The same key the `perplexity` text provider reads, so an ambient
-            // PERPLEXITY_API_KEY configures this provider too. Its decideOrder (4)
-            // sits after XOR's (3), which is what keeps that from displacing any other
-            // decision provider a host has configured.
+            // PERPLEXITY_API_KEY configures this provider too. Its decideOrder (5)
+            // sits after XOR's (3) and SubQ's (4), which have keys of their own, which
+            // is what keeps that from displacing any other decision provider a host
+            // has configured.
             apiKey: "PERPLEXITY_API_KEY",
             // Optional: the API is hosted at a public endpoint, so a key alone is
             // enough and there is no extraRequired.
@@ -495,7 +500,7 @@ const HAND_DESCRIPTORS = [
         // declaration that keeps it out of every generation code path, and out of
         // the way of the `perplexity` text provider.
         inferenceKinds: ["decide"],
-        decideOrder: 4,
+        decideOrder: 5,
         toolSupport: "none",
         localRuntime: false,
         healthCheck: "env-only",
@@ -563,7 +568,7 @@ const HAND_DESCRIPTORS = [
         // declaration that keeps it out of every generation code path, and out of
         // the way of the `cloudflare` text provider.
         inferenceKinds: ["decide"],
-        decideOrder: 5,
+        decideOrder: 6,
         toolSupport: "none",
         localRuntime: false,
         healthCheck: "env-only",

package/dist/neurolink.d.ts

@@ -1,10 +1,3 @@
-/**
- * NeuroLink - Unified AI Interface with Real MCP Tool Integration
- *
- * REDESIGNED FALLBACK CHAIN - NO CIRCULAR DEPENDENCIES
- * Enhanced AI provider system with natural MCP tool access.
- * Uses real MCP infrastructure for tool discovery and execution.
- */
 import type { DecisionCallerOptions, DecisionLimitsQuery, DecisionLimitsReading, DecisionOptions, DecisionResult, AgentDefinition, AgentNetworkConfig, AgentRunOptions, AgentRunOutcome, AgentToolRegistrationOptions, IsolatedAgentDefinition, NetworkExecutionInput, NetworkExecutionOptions, NetworkExecutionResult, NetworkStreamChunk, WorkerInstanceOptions } from "./types/index.js";
 import type { CompactionConfig, CompactionResult, ArtifactStore, SpanData, ObservabilityConfig, MetricsSummary, MCPToolAnnotations, TraceView, AuthenticatedContext, AuthProvider, JsonObject, NeuroLinkEvents, TypedEventEmitter, MCPEnhancementsConfig, NeuroLinkAuthConfig, NeurolinkConstructorConfig, ChatMessage, ConversationSeedMessage, ConversationSeedOptions, RecordConversationTurnOptions, RecordConversationTurnResult, ExternalMCPOperationResult, ExternalMCPServerInstance, ExternalMCPServerHealth, ExternalMCPToolInfo, GenerateOptions, GenerateResult, ProviderStatus, TextGenerationOptions, TextGenerationResult, MCPExecutableTool, MCPServerInfo, MCPStatus, StreamOptions, StreamResult, ToolExecutionContext, ToolExecutionSummary, ToolInfo, ToolRegistrationOptions, BatchOperationResult, StreamGenerationEndContext, ToolRoutingServerDescriptor, ToolDedupConfig, ToolConfig, KnowledgeEngineStatus, ChecklistState, ArtifactPageRequest, BankArtifactOptions, BankedArtifactRef, DelegateCollectRequest, DelegateCollectResult, DelegateHandle, DelegateRegistrationOptions, DelegateSpawnOptions, BackgroundCommandHandle, BackgroundCommandOptions, BackgroundCommandOutputPage, BackgroundCommandPageRequest, BackgroundCommandPolicy, BackgroundCommandStatus, GitToolResult, GitToolsetOptions } from "./types/index.js";
 import { ConversationMemoryManager } from "./core/conversationMemoryManager.js";
@@ -612,6 +605,12 @@ export declare class NeuroLink {
      * @returns Modified options with orchestrated provider marked in context, or empty object if validation fails
      */
     private applyStreamOrchestration;
+    /**
+     * Read a nonempty orchestration preference only when provider is absent/auto.
+     * An explicit provider always takes precedence over incoming or generated
+     * context; empty, non-string and auto preferences are ignored.
+     */
+    private getOrchestratedPreferredProvider;
     /**
      * MAIN ENTRY POINT: Enhanced generate method with new function signature
      * Replaces both generateText and legacy methods
@@ -937,6 +936,7 @@ export declare class NeuroLink {
      *
      * The router is skipped when:
      *   - no `requestRouter` is configured on this instance, or
+     *   - a valid orchestration preference already owns the provider/model pair, or
      *   - the caller explicitly set both `options.provider` AND `options.model`
      *     (we only skip the router if BOTH are set; a caller setting only one
      *     still lets the router fill in the other field).
@@ -1118,6 +1118,8 @@ export declare class NeuroLink {
     private generateWithMCPProvider;
     /**
      * Direct provider generation (no MCP, no recursion)
+     * An explicit provider precedes orchestration context; otherwise a valid
+     * orchestration preference is tried before the existing provider fallback list.
      */
     private directProviderGeneration;
     /**
@@ -1324,7 +1326,9 @@ export declare class NeuroLink {
      */
     private emitStreamStartEvents;
     /**
-     * Create MCP stream
+     * Create the provider-backed MCP stream with the existing tool lifecycle.
+     * An explicit provider precedes a valid orchestration context preference;
+     * absent either, getBestProvider retains its normal automatic selection.
      */
     private createMCPStream;
     /**

package/dist/neurolink.js

@@ -1,3 +1,4 @@
+import { beginOllamaDiagnostic, captureOllamaDiagnosticContext, completeOllamaDiagnostic, getOllamaDiagnosticErrorMessage, } from "./utils/ollamaDiagnostics.js";
 /**
  * NeuroLink - Unified AI Interface with Real MCP Tool Integration
  *
@@ -203,13 +204,6 @@ const isNonRetryableForPool = sharedIsNonRetryableForPool;
  */
 const MEMORY_WRITE_TIMEOUT_MS = 30_000;
 /** Native tags share the health check's endpoint precedence and origin. */
-function getOllamaTagsUrl() {
-    const baseUrl = process.env.OLLAMA_BASE_URL ||
-        process.env.OLLAMA_API_BASE ||
-        "http://localhost:11434";
-    // Native /api/tags is at the origin even if the compatible base ends /v1.
-    return new URL("/api/tags", baseUrl).toString();
-}
 /**
  * NeuroLink - Universal AI Development Platform
  *
@@ -2737,8 +2731,17 @@ Current user's request: ${currentInput}`;
             }
             // For Ollama, check if service is running and model is available
             if (route.provider === "ollama") {
+                let ollamaAttempt;
+                let ollamaOutcome = "not-run";
                 try {
-                    const response = await fetch(getOllamaTagsUrl(), {
+                    const ollamaContext = captureOllamaDiagnosticContext();
+                    const gate = beginOllamaDiagnostic(ollamaContext);
+                    if (gate.kind === "suppressed") {
+                        return {};
+                    }
+                    ollamaAttempt = gate;
+                    ollamaOutcome = "transport-failure";
+                    const response = await fetch(ollamaContext.url, {
                         method: "GET",
                         signal: AbortSignal.timeout(2000),
                     });
@@ -2752,6 +2755,7 @@ Current user's request: ${currentInput}`;
                         });
                         return {}; // Return empty object to preserve existing fallback behavior
                     }
+                    ollamaOutcome = "protocol-failure";
                     const responseData = await response.json();
                     const models = responseData?.models;
                     // Runtime-safe guard: ensure models is an array with valid objects
@@ -2762,6 +2766,7 @@ Current user's request: ${currentInput}`;
                         });
                         return {}; // Return empty object for fallback behavior
                     }
+                    ollamaOutcome = "success";
                     // Filter and validate models before comparison
                     const validModels = models.filter((m) => m && typeof m === "object" && typeof m.name === "string");
                     const targetModel = route.model;
@@ -2807,12 +2812,17 @@ Current user's request: ${currentInput}`;
                         routedProvider: route.provider,
                         routedModel: route.model,
                         reason: error instanceof Error
-                            ? error.message
+                            ? getOllamaDiagnosticErrorMessage(error)
                             : "Ollama service check failed",
                         orchestrationTime: `${Date.now() - startTime}ms`,
                     });
                     return {}; // Return empty object to preserve existing fallback behavior
                 }
+                finally {
+                    if (ollamaAttempt) {
+                        completeOllamaDiagnostic(ollamaAttempt, ollamaOutcome);
+                    }
+                }
             }
             logger.debug("Orchestration route determined", {
                 taskType: classification.type,
@@ -2875,8 +2885,17 @@ Current user's request: ${currentInput}`;
             }
             // For Ollama, check if service is running and model is available
             if (route.provider === "ollama") {
+                let ollamaAttempt;
+                let ollamaOutcome = "not-run";
                 try {
-                    const response = await fetch(getOllamaTagsUrl(), {
+                    const ollamaContext = captureOllamaDiagnosticContext();
+                    const gate = beginOllamaDiagnostic(ollamaContext);
+                    if (gate.kind === "suppressed") {
+                        return {};
+                    }
+                    ollamaAttempt = gate;
+                    ollamaOutcome = "transport-failure";
+                    const response = await fetch(ollamaContext.url, {
                         method: "GET",
                         signal: AbortSignal.timeout(2000),
                     });
@@ -2890,6 +2909,7 @@ Current user's request: ${currentInput}`;
                         });
                         return {}; // Return empty object to preserve existing fallback behavior
                     }
+                    ollamaOutcome = "protocol-failure";
                     const responseData = await response.json();
                     const models = responseData?.models;
                     // Runtime-safe guard: ensure models is an array with valid objects
@@ -2900,6 +2920,7 @@ Current user's request: ${currentInput}`;
                         });
                         return {}; // Return empty object for fallback behavior
                     }
+                    ollamaOutcome = "success";
                     // Filter and validate models before comparison
                     const validModels = models.filter((m) => m && typeof m === "object" && typeof m.name === "string");
                     const targetModel = route.model;
@@ -2945,12 +2966,17 @@ Current user's request: ${currentInput}`;
                         routedProvider: route.provider,
                         routedModel: route.model,
                         reason: error instanceof Error
-                            ? error.message
+                            ? getOllamaDiagnosticErrorMessage(error)
                             : "Ollama service check failed",
                         orchestrationTime: `${Date.now() - startTime}ms`,
                     });
                     return {}; // Return empty object to preserve existing fallback behavior
                 }
+                finally {
+                    if (ollamaAttempt) {
+                        completeOllamaDiagnostic(ollamaAttempt, ollamaOutcome);
+                    }
+                }
             }
             logger.debug("Stream orchestration route determined", {
                 taskType: classification.type,
@@ -2978,6 +3004,22 @@ Current user's request: ${currentInput}`;
             throw error;
         }
     }
+    /**
+     * Read a nonempty orchestration preference only when provider is absent/auto.
+     * An explicit provider always takes precedence over incoming or generated
+     * context; empty, non-string and auto preferences are ignored.
+     */
+    getOrchestratedPreferredProvider(options) {
+        if (options.provider && options.provider !== "auto") {
+            return undefined;
+        }
+        const preferred = options.context?.__orchestratedPreferredProvider;
+        return typeof preferred === "string" &&
+            preferred.length > 0 &&
+            preferred !== "auto"
+            ? preferred
+            : undefined;
+    }
     /**
      * MAIN ENTRY POINT: Enhanced generate method with new function signature
      * Replaces both generateText and legacy methods
@@ -4339,6 +4381,7 @@ Current user's request: ${currentInput}`;
      *
      * The router is skipped when:
      *   - no `requestRouter` is configured on this instance, or
+     *   - a valid orchestration preference already owns the provider/model pair, or
      *   - the caller explicitly set both `options.provider` AND `options.model`
      *     (we only skip the router if BOTH are set; a caller setting only one
      *     still lets the router fill in the other field).
@@ -4358,8 +4401,11 @@ Current user's request: ${currentInput}`;
         }
         // Stand down if the classifier router already selected a provider/model on
         // this turn — one explicit precedence order: classifierRouter wins.
-        if (options.context
-            ?.__classifierRouted) {
+        if (options.context?.__classifierRouted) {
+            return;
+        }
+        // Keep an orchestration-selected model with the provider that owns it.
+        if (this.getOrchestratedPreferredProvider(options)) {
             return;
         }
         // Skip if the caller explicitly set both provider AND model — they know
@@ -6577,6 +6623,8 @@ Current user's request: ${currentInput}`;
     }
     /**
      * Direct provider generation (no MCP, no recursion)
+     * An explicit provider precedes orchestration context; otherwise a valid
+     * orchestration preference is tried before the existing provider fallback list.
      */
     async directProviderGeneration(options) {
         const startTime = Date.now();
@@ -6593,13 +6641,8 @@ Current user's request: ${currentInput}`;
             "ollama",
         ];
         const requestedProvider = options.provider === "auto" ? undefined : options.provider;
-        // Check for orchestrated preferred provider in context
-        const preferredOrchestrated = options.context &&
-            typeof options.context === "object" &&
-            "__orchestratedPreferredProvider" in options.context
-            ? options.context
-                .__orchestratedPreferredProvider
-            : undefined;
+        // Read the shared preference while keeping an explicit provider first.
+        const preferredOrchestrated = this.getOrchestratedPreferredProvider(options);
         // Build provider list with orchestrated preference first, then fallback to full list
         const tryProviders = preferredOrchestrated
             ? [
@@ -9425,11 +9468,16 @@ Current user's request: ${currentInput}`;
         this.emitter.emit("message", `Starting ${options.provider || "auto"} stream...`);
     }
     /**
-     * Create MCP stream
+     * Create the provider-backed MCP stream with the existing tool lifecycle.
+     * An explicit provider precedes a valid orchestration context preference;
+     * absent either, getBestProvider retains its normal automatic selection.
      */
     async createMCPStream(options) {
-        // Simplified placeholder - in the actual implementation this would contain the complex MCP stream logic
-        const providerName = await getBestProvider(options.provider);
+        // Consume the validated orchestration choice after an explicit provider.
+        const requestedProvider = options.provider && options.provider !== "auto"
+            ? options.provider
+            : this.getOrchestratedPreferredProvider(options);
+        const providerName = await getBestProvider(requestedProvider);
         const provider = await AIProviderFactory.createProvider(providerName, options.model, !options.disableTools, // Pass disableTools as inverse of enableMCP
         this, // Pass SDK instance
         options.region, // Pass region parameter
@@ -11900,14 +11948,24 @@ Current user's request: ${currentInput}`;
                 }
                 // Special handling for Ollama
                 if (providerName === "ollama") {
+                    let ollamaAttempt;
+                    let ollamaOutcome = "not-run";
                     try {
-                        const response = await fetch(getOllamaTagsUrl(), {
+                        const ollamaContext = captureOllamaDiagnosticContext();
+                        const gate = beginOllamaDiagnostic(ollamaContext);
+                        if (gate.kind === "suppressed") {
+                            throw new Error(gate.reason);
+                        }
+                        ollamaAttempt = gate;
+                        ollamaOutcome = "transport-failure";
+                        const response = await fetch(ollamaContext.url, {
                             method: "GET",
                             signal: AbortSignal.timeout(PROVIDER_TIMEOUTS.AUTH_MS),
                         });
                         if (!response.ok) {
                             throw new Error("Ollama service not responding");
                         }
+                        ollamaOutcome = "protocol-failure";
                         const responseData = await response.json();
                         const models = responseData?.models;
                         // Runtime-safe guard: ensure models is an array with valid objects
@@ -11918,6 +11976,7 @@ Current user's request: ${currentInput}`;
                             });
                             throw new Error("Invalid models format from Ollama API");
                         }
+                        ollamaOutcome = "success";
                         // Filter and validate models before comparison
                         const validModels = models.filter((m) => m && typeof m === "object" && typeof m.name === "string");
                         if (validModels.length > 0) {
@@ -11948,11 +12007,16 @@ Current user's request: ${currentInput}`;
                             configured: false,
                             authenticated: false,
                             error: error instanceof Error
-                                ? error.message
+                                ? getOllamaDiagnosticErrorMessage(error)
                                 : "Ollama service not running",
                             responseTime: Date.now() - startTime,
                         };
                     }
+                    finally {
+                        if (ollamaAttempt) {
+                            completeOllamaDiagnostic(ollamaAttempt, ollamaOutcome);
+                        }
+                    }
                 }
                 // Test other providers with actual generation call. The losing
                 // side of the race is aborted in `finally` below — previously the

package/dist/providers/catalog/index.generated.d.ts

@@ -2,4 +2,4 @@ import type { DecideCatalogJson, ProviderCatalogJson } from "../../types/index.j
 export declare const CATALOG_JSON_ENTRIES: ProviderCatalogJson[];
 export declare const CATALOG_PROVIDER_IDS: readonly ["a2agent", "abliteration", "above-dev", "ai21", "aiand", "aihubmix", "aionlabs", "ambient", "api-route", "arcee", "atlas-cloud", "avian-io", "baidu-qianfan", "baseten", "bee-heossi", "byteplus-modelark", "bytez", "cerebras", "charm-hyper", "chutes", "cloudflare", "crusoe", "dashscope", "deepinfra", "deepseek", "empiriolabs", "featherless-ai", "fireworks", "friendli", "gmicloud", "gradientai", "groq", "hetzner-inference", "huggingface", "inception-labs", "inceptron", "inco", "inference-net", "io-intelligence", "koscompute", "lemonfox-ai", "lilac", "llmtech", "longcat", "mancer", "meta-model-api", "minimax", "mistral", "moark", "modelscope", "moonshot-ai", "morph", "naver-clova-studio", "nebius", "neuralwatt", "novita", "ovhcloud", "parasail", "pareto-inference", "perplexity", "poolside", "prime-intellect", "reka", "runinfra", "sakana-ai", "sambanova", "sarvam", "scaleway", "siliconflow", "stackit", "stepfun", "subconscious", "synthetic", "telnyx", "thinking-machines", "tinfoil", "together-ai", "umans-ai", "upstage", "venice-ai", "vispark", "vultr-inference", "wafer", "wandb-inference", "xai", "xiaomi-mimo", "z-ai"];
 export declare const DECIDE_CATALOG_JSON_ENTRIES: DecideCatalogJson[];
-export declare const DECIDE_CATALOG_PROVIDER_IDS: readonly ["laya", "xor"];
+export declare const DECIDE_CATALOG_PROVIDER_IDS: readonly ["laya", "subq", "xor"];

package/dist/providers/catalog/index.generated.js

@@ -73,6 +73,7 @@ import siliconflowJson from "./siliconflow.json" with { type: "json" };
 import stackitJson from "./stackit.json" with { type: "json" };
 import stepfunJson from "./stepfun.json" with { type: "json" };
 import subconsciousJson from "./subconscious.json" with { type: "json" };
+import subqJson from "./subq.json" with { type: "json" };
 import syntheticJson from "./synthetic.json" with { type: "json" };
 import telnyxJson from "./telnyx.json" with { type: "json" };
 import thinkingMachinesJson from "./thinking-machines.json" with { type: "json" };
@@ -277,6 +278,7 @@ export const CATALOG_PROVIDER_IDS = [
 ];
 export const DECIDE_CATALOG_JSON_ENTRIES = [
     layaJson,
+    subqJson,
     xorJson,
 ].map(asDecideEntry);
-export const DECIDE_CATALOG_PROVIDER_IDS = ["laya", "xor"];
+export const DECIDE_CATALOG_PROVIDER_IDS = ["laya", "subq", "xor"];

package/dist/providers/catalog/subq.json

@@ -0,0 +1,59 @@
+{
+    "$schema": "./provider-catalog.schema.json",
+    "id": "subq",
+    "displayName": "SubQ",
+    "aliases": ["subquadratic", "subq-snap"],
+    "inferenceKinds": ["decide"],
+    "wire": { "baseURL": "https://api.subq.ai" },
+    "models": {
+        "default": "subq-snap-preview",
+        "topModels": ["subq-snap-preview"],
+        "catalog": {
+            "subq-snap-preview": {
+                "contextWindow": 393216,
+                "maxOutputTokens": 1,
+                "vision": false,
+                "status": "preview",
+                "description": "Recommended - SubQ Snap Preview, decision model for boolean, choice and score questions"
+            }
+        }
+    },
+    "decisionLimits": { "maxStateTokens": 376000, "advisory": true },
+    "decide": {
+        "dialect": "system-one",
+        "order": 4,
+        "baseURLNormalize": ["strip-trailing-slash"],
+        "endpoint": "{baseURL}/v1/systemone",
+        "model": { "placement": "body" },
+        "errors": {
+            "rules": [
+                { "status": 401, "kind": "authentication" },
+                { "status": [402, 403, 422], "kind": "invalid_request" },
+                { "status": 429, "kind": "rate_limit" },
+                { "status": 503, "kind": "overloaded" },
+                { "statusMin": 500, "kind": "server" }
+            ],
+            "default": "invalid_request",
+            "bodyShapes": [{ "path": "detail.message" }, { "path": "detail" }]
+        }
+    },
+    "setup": {
+        "url": "https://console.subq.ai",
+        "apiKeyFormat": null,
+        "billingPolicy": "no-free-tier",
+        "description": "API key from the SubQ console",
+        "instructions": [
+            "1. Sign up at https://console.subq.ai and create an API key (the console shows it once)",
+            "2. Set {apiKeyEnvVar} in your .env file",
+            "3. A request made with no credits left returns HTTP 402"
+        ]
+    },
+    "evidence": {
+        "rosterVerified": {
+            "date": "2026-10-13",
+            "method": "Checked by the marketing session, not in this change: GET https://api.subq.ai/v1/models without a key listed subq-snap-preview, and docs.subq.ai/using-the-api/models was read the same day. No request was made to SubQ in this change"
+        },
+        "liveMatrix": null,
+        "addedInPR": "https://github.com/juspay/neurolink/pull/1986"
+    }
+}

package/dist/types/index.d.ts

@@ -103,3 +103,4 @@ export * from "./dispatch.js";
 export * from "./proxyRestart.js";
 export * from "./proxyBudget.js";
 export * from "./decision.js";
+export * from "./ollamaDiagnostics.js";

package/dist/types/index.js

@@ -119,3 +119,4 @@ export * from "./proxyRestart.js";
 export * from "./proxyBudget.js";
 // `decide` inference-type contracts (TypeSafe Jev is the first provider)
 export * from "./decision.js";
+export * from "./ollamaDiagnostics.js";

package/dist/types/ollamaDiagnostics.d.ts

@@ -0,0 +1,31 @@
+/** Native Ollama diagnostic identity, outcome and captured policy state. */
+export type OllamaDiagnosticContext = Readonly<{
+    /** Private resolved URL: never include it, its key, or credentials in logs. */
+    url: string;
+    key: string;
+    model: string;
+}>;
+export type OllamaDiagnosticSnapshot = Readonly<{
+    count: number;
+    lastFailureAt: number | undefined;
+    revision: number;
+    generation: number;
+}>;
+export type OllamaDiagnosticState = {
+    count: number;
+    lastFailureAt: number | undefined;
+    revision: number;
+    generation: number;
+};
+export type OllamaDiagnosticPermit = Readonly<{
+    kind: "allowed";
+    context: OllamaDiagnosticContext;
+    generation: number;
+}>;
+export type OllamaDiagnosticGate = OllamaDiagnosticPermit | Readonly<{
+    kind: "suppressed";
+    count: number;
+    reason: string;
+    generation: number;
+}>;
+export type OllamaDiagnosticOutcome = "success" | "transport-failure" | "protocol-failure" | "not-run";

package/dist/types/ollamaDiagnostics.js

@@ -0,0 +1 @@
+export {};

package/dist/types/providerCatalog.generated.d.ts

@@ -1,2 +1,2 @@
-export type CatalogProviderName = "a2agent" | "abliteration" | "above-dev" | "ai21" | "aiand" | "aihubmix" | "aionlabs" | "ambient" | "api-route" | "arcee" | "atlas-cloud" | "avian-io" | "baidu-qianfan" | "baseten" | "bee-heossi" | "byteplus-modelark" | "bytez" | "cerebras" | "charm-hyper" | "chutes" | "cloudflare" | "crusoe" | "dashscope" | "deepinfra" | "deepseek" | "empiriolabs" | "featherless-ai" | "fireworks" | "friendli" | "gmicloud" | "gradientai" | "groq" | "hetzner-inference" | "huggingface" | "inception-labs" | "inceptron" | "inco" | "inference-net" | "io-intelligence" | "koscompute" | "laya" | "lemonfox-ai" | "lilac" | "llmtech" | "longcat" | "mancer" | "meta-model-api" | "minimax" | "mistral" | "moark" | "modelscope" | "moonshot-ai" | "morph" | "naver-clova-studio" | "nebius" | "neuralwatt" | "novita" | "ovhcloud" | "parasail" | "pareto-inference" | "perplexity" | "poolside" | "prime-intellect" | "reka" | "runinfra" | "sakana-ai" | "sambanova" | "sarvam" | "scaleway" | "siliconflow" | "stackit" | "stepfun" | "subconscious" | "synthetic" | "telnyx" | "thinking-machines" | "tinfoil" | "together-ai" | "umans-ai" | "upstage" | "venice-ai" | "vispark" | "vultr-inference" | "wafer" | "wandb-inference" | "xai" | "xiaomi-mimo" | "xor" | "z-ai";
-export type CatalogCredentialKey = "a2agent" | "abliteration" | "aboveDev" | "ai21" | "aiand" | "aihubmix" | "aionlabs" | "ambient" | "apiRoute" | "arcee" | "atlasCloud" | "avianIo" | "baiduQianfan" | "baseten" | "beeHeossi" | "byteplusModelark" | "bytez" | "cerebras" | "charmHyper" | "chutes" | "cloudflare" | "crusoe" | "dashscope" | "deepinfra" | "deepseek" | "empiriolabs" | "featherlessAi" | "fireworks" | "friendli" | "gmicloud" | "gradientai" | "groq" | "hetznerInference" | "huggingFace" | "inceptionLabs" | "inceptron" | "inco" | "inferenceNet" | "ioIntelligence" | "koscompute" | "laya" | "lemonfoxAi" | "lilac" | "llmtech" | "longcat" | "mancer" | "metaModelApi" | "minimax" | "mistral" | "moark" | "modelscope" | "moonshotAi" | "morph" | "naverClovaStudio" | "nebius" | "neuralwatt" | "novita" | "ovhcloud" | "parasail" | "paretoInference" | "perplexity" | "poolside" | "primeIntellect" | "reka" | "runinfra" | "sakanaAi" | "sambanova" | "sarvam" | "scaleway" | "siliconflow" | "stackit" | "stepfun" | "subconscious" | "synthetic" | "telnyx" | "thinkingMachines" | "tinfoil" | "together" | "umansAi" | "upstage" | "veniceAi" | "vispark" | "vultrInference" | "wafer" | "wandbInference" | "xai" | "xiaomiMimo" | "xor" | "zAi";
+export type CatalogProviderName = "a2agent" | "abliteration" | "above-dev" | "ai21" | "aiand" | "aihubmix" | "aionlabs" | "ambient" | "api-route" | "arcee" | "atlas-cloud" | "avian-io" | "baidu-qianfan" | "baseten" | "bee-heossi" | "byteplus-modelark" | "bytez" | "cerebras" | "charm-hyper" | "chutes" | "cloudflare" | "crusoe" | "dashscope" | "deepinfra" | "deepseek" | "empiriolabs" | "featherless-ai" | "fireworks" | "friendli" | "gmicloud" | "gradientai" | "groq" | "hetzner-inference" | "huggingface" | "inception-labs" | "inceptron" | "inco" | "inference-net" | "io-intelligence" | "koscompute" | "laya" | "lemonfox-ai" | "lilac" | "llmtech" | "longcat" | "mancer" | "meta-model-api" | "minimax" | "mistral" | "moark" | "modelscope" | "moonshot-ai" | "morph" | "naver-clova-studio" | "nebius" | "neuralwatt" | "novita" | "ovhcloud" | "parasail" | "pareto-inference" | "perplexity" | "poolside" | "prime-intellect" | "reka" | "runinfra" | "sakana-ai" | "sambanova" | "sarvam" | "scaleway" | "siliconflow" | "stackit" | "stepfun" | "subconscious" | "subq" | "synthetic" | "telnyx" | "thinking-machines" | "tinfoil" | "together-ai" | "umans-ai" | "upstage" | "venice-ai" | "vispark" | "vultr-inference" | "wafer" | "wandb-inference" | "xai" | "xiaomi-mimo" | "xor" | "z-ai";
+export type CatalogCredentialKey = "a2agent" | "abliteration" | "aboveDev" | "ai21" | "aiand" | "aihubmix" | "aionlabs" | "ambient" | "apiRoute" | "arcee" | "atlasCloud" | "avianIo" | "baiduQianfan" | "baseten" | "beeHeossi" | "byteplusModelark" | "bytez" | "cerebras" | "charmHyper" | "chutes" | "cloudflare" | "crusoe" | "dashscope" | "deepinfra" | "deepseek" | "empiriolabs" | "featherlessAi" | "fireworks" | "friendli" | "gmicloud" | "gradientai" | "groq" | "hetznerInference" | "huggingFace" | "inceptionLabs" | "inceptron" | "inco" | "inferenceNet" | "ioIntelligence" | "koscompute" | "laya" | "lemonfoxAi" | "lilac" | "llmtech" | "longcat" | "mancer" | "metaModelApi" | "minimax" | "mistral" | "moark" | "modelscope" | "moonshotAi" | "morph" | "naverClovaStudio" | "nebius" | "neuralwatt" | "novita" | "ovhcloud" | "parasail" | "paretoInference" | "perplexity" | "poolside" | "primeIntellect" | "reka" | "runinfra" | "sakanaAi" | "sambanova" | "sarvam" | "scaleway" | "siliconflow" | "stackit" | "stepfun" | "subconscious" | "subq" | "synthetic" | "telnyx" | "thinkingMachines" | "tinfoil" | "together" | "umansAi" | "upstage" | "veniceAi" | "vispark" | "vultrInference" | "wafer" | "wandbInference" | "xai" | "xiaomiMimo" | "xor" | "zAi";

package/dist/types/providers.d.ts

@@ -485,6 +485,10 @@ export type NeurolinkCredentials = {
         apiKey?: string;
         baseURL?: string;
     };
+    subq?: {
+        apiKey?: string;
+        baseURL?: string;
+    };
     synthetic?: {
         apiKey?: string;
         baseURL?: string;