@juspay/neurolink 12.5.0 → 12.5.1

package/dist/providers/catalog/provider-catalog.schema.json

@@ -0,0 +1,351 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$comment": "Documentation-grade mirror of src/lib/providers/catalog/schema.ts for editor red-squiggle validation. The zod schema is authoritative \u2014 keep this file in sync by hand when that one changes. This mirror cannot express the zod schema's cross-field refinements (e.g. models.default must be a key of models.catalog, wire's baseURL-XOR-baseURLTemplate rule, errorRules requiring status or pattern); those are enforced only at parse time by parseProviderCatalogJson.",
+  "title": "NeuroLink Provider Catalog",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "id",
+    "displayName",
+    "aliases",
+    "tier",
+    "wire",
+    "models",
+    "capabilities",
+    "errorRules",
+    "setup",
+    "evidence"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Editor-only pointer to this file. Accepted and ignored by the parser."
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+    },
+    "displayName": {
+      "type": "string"
+    },
+    "enumTypeName": {
+      "type": "string",
+      "pattern": "^[A-Za-z_$][A-Za-z0-9_$]*$",
+      "description": "Exported <Name>Models enum name override. Default: PascalCase(id) + \"Models\"."
+    },
+    "credentialsKey": {
+      "type": "string",
+      "description": "Overrides the derived camelCase NeurolinkCredentials key. Required where the derived name would rename a pre-existing public credential field (see together-ai -> \"together\")."
+    },
+    "aliases": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "tier": {
+      "const": 2
+    },
+    "wire": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "baseURL": {
+          "type": "string"
+        },
+        "baseURLTemplate": {
+          "type": "string"
+        },
+        "extraCredentials": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[A-Za-z_$][A-Za-z0-9_$]*$"
+          },
+          "maxItems": 1
+        },
+        "missingCredentialMessage": {
+          "type": "string"
+        },
+        "envOverrides": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "apiKey": {
+              "type": "string"
+            },
+            "baseURL": {
+              "type": "string"
+            },
+            "model": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "models": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "default",
+        "fallbacks",
+        "defaultContextWindow",
+        "defaultMaxOutputTokens",
+        "catalog"
+      ],
+      "properties": {
+        "default": {
+          "type": "string"
+        },
+        "fallbacks": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 1
+        },
+        "fallbackModelName": {
+          "type": "string",
+          "description": "Default: fallbacks[1] ?? fallbacks[0]."
+        },
+        "registryDefaultModel": {
+          "type": "string",
+          "description": "Default: models.default."
+        },
+        "defaultContextWindow": {
+          "type": "number"
+        },
+        "defaultMaxOutputTokens": {
+          "type": "number"
+        },
+        "catalog": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["vision", "status", "description"],
+            "properties": {
+              "contextWindow": {
+                "type": "number"
+              },
+              "maxOutputTokens": {
+                "type": "number"
+              },
+              "pricingPerMTok": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["input", "output"],
+                "properties": {
+                  "input": {
+                    "type": "number"
+                  },
+                  "output": {
+                    "type": "number"
+                  },
+                  "cachedInput": {
+                    "type": "number"
+                  }
+                }
+              },
+              "vision": {
+                "type": "boolean"
+              },
+              "status": {
+                "type": "string",
+                "enum": ["production", "preview", "retired"]
+              },
+              "description": {
+                "type": "string"
+              },
+              "enumMember": {
+                "type": "string",
+                "pattern": "^[A-Za-z_$][A-Za-z0-9_$]*$"
+              }
+            }
+          }
+        },
+        "topModels": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 1,
+          "description": "Ordered curated subset of catalog keys for wizard/choice surfaces. Falls back to the full catalog in file order when absent."
+        },
+        "visionModel": {
+          "type": "string",
+          "description": "The live-verified vision model capability tests should exercise. Must be a key of models.catalog whose entry has vision: true (enforced by the zod schema, not expressible here). Default: first vision:true model in file order."
+        },
+        "testModel": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The live-verified model the capability matrix drives, for providers whose default is retired upstream or gated off the testing account. May name a model outside models.catalog. Default: models.default. Never affects the runtime default."
+        }
+      }
+    },
+    "capabilities": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "text",
+        "streaming",
+        "tools",
+        "toolsWithStreaming",
+        "structuredOutput",
+        "structuredOutputWithTools",
+        "embeddings",
+        "thinking"
+      ],
+      "properties": {
+        "text": {
+          "type": "boolean"
+        },
+        "streaming": {
+          "type": "boolean"
+        },
+        "tools": {
+          "type": "boolean"
+        },
+        "toolsWithStreaming": {
+          "type": "boolean"
+        },
+        "structuredOutput": {
+          "type": "boolean"
+        },
+        "structuredOutputWithTools": {
+          "type": "boolean"
+        },
+        "embeddings": {
+          "type": "boolean"
+        },
+        "thinking": {
+          "type": "boolean"
+        }
+      }
+    },
+    "errorRules": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["class", "message"],
+        "properties": {
+          "status": {
+            "type": "number"
+          },
+          "pattern": {
+            "type": "string"
+          },
+          "class": {
+            "type": "string",
+            "enum": [
+              "authentication",
+              "rate-limit",
+              "invalid-model",
+              "network",
+              "provider"
+            ]
+          },
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "quirks": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "timeoutErrorClass": {
+          "const": "provider"
+        },
+        "registryDefaultIgnoresModelEnvVar": {
+          "type": "boolean"
+        }
+      }
+    },
+    "setup": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["url", "apiKeyFormat", "billingPolicy", "instructions"],
+      "properties": {
+        "url": {
+          "type": "string"
+        },
+        "apiKeyFormat": {
+          "type": ["string", "null"]
+        },
+        "billingPolicy": {
+          "type": "string",
+          "enum": ["free-tier", "free-with-card", "no-free-tier"]
+        },
+        "instructions": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "description": {
+          "type": "string",
+          "description": "Label shown by the setup wizard for the credential (default: \"API key\")."
+        }
+      }
+    },
+    "evidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["rosterVerified", "liveMatrix", "addedInPR"],
+      "properties": {
+        "rosterVerified": {
+          "$ref": "#/definitions/probeEvidence"
+        },
+        "authProbe": {
+          "$ref": "#/definitions/probeEvidence"
+        },
+        "billingProbe": {
+          "$ref": "#/definitions/probeEvidence"
+        },
+        "liveMatrix": {
+          "type": ["object", "null"],
+          "additionalProperties": false,
+          "required": ["date", "result"],
+          "properties": {
+            "date": {
+              "type": "string",
+              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+            },
+            "result": {
+              "type": "string"
+            }
+          }
+        },
+        "addedInPR": {
+          "type": "string"
+        }
+      }
+    }
+  },
+  "definitions": {
+    "probeEvidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["date"],
+      "properties": {
+        "date": {
+          "type": "string",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+        },
+        "status": {
+          "type": "number"
+        },
+        "code": {
+          "type": "string"
+        },
+        "method": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}

package/dist/providers/catalog/sambanova.json

@@ -0,0 +1,129 @@
+{
+    "$schema": "./provider-catalog.schema.json",
+    "id": "sambanova",
+    "displayName": "SambaNova",
+    "aliases": [],
+    "tier": 2,
+    "wire": {
+        "baseURL": "https://api.sambanova.ai/v1"
+    },
+    "models": {
+        "default": "Meta-Llama-3.3-70B-Instruct",
+        "visionModel": "gemma-4-31B-it",
+        "fallbacks": ["Meta-Llama-3.3-70B-Instruct", "gpt-oss-120b"],
+        "defaultContextWindow": 131072,
+        "defaultMaxOutputTokens": 8192,
+        "catalog": {
+            "Meta-Llama-3.3-70B-Instruct": {
+                "contextWindow": 131072,
+                "pricingPerMTok": { "input": 0.6, "output": 1.2 },
+                "vision": false,
+                "status": "production",
+                "description": "Recommended - Meta Llama 3.3 70B; production, 128K context"
+            },
+            "gpt-oss-120b": {
+                "contextWindow": 131072,
+                "pricingPerMTok": { "input": 0.22, "output": 0.59 },
+                "vision": false,
+                "status": "production",
+                "description": "OpenAI GPT-OSS 120B (open-weight)"
+            },
+            "DeepSeek-V3.1": {
+                "contextWindow": 131072,
+                "pricingPerMTok": { "input": 3, "output": 4.5 },
+                "vision": false,
+                "status": "production",
+                "description": "DeepSeek V3.1 (reasoning)"
+            },
+            "DeepSeek-V3.2": {
+                "contextWindow": 32768,
+                "pricingPerMTok": { "input": 3, "output": 4.5 },
+                "vision": false,
+                "status": "preview",
+                "description": "DeepSeek V3.2 (reasoning; vendor preview, 32K context)"
+            },
+            "MiniMax-M2.7": {
+                "contextWindow": 196608,
+                "pricingPerMTok": { "input": 0.6, "output": 2.4, "cachedInput": 0.06 },
+                "vision": false,
+                "status": "production",
+                "description": "MiniMax M2.7, 192K context"
+            },
+            "MiniMax-M3": {
+                "pricingPerMTok": { "input": 0.6, "output": 2.4 },
+                "vision": true,
+                "status": "production",
+                "description": "MiniMax M3 (vision)"
+            },
+            "gemma-4-31B-it": {
+                "contextWindow": 131072,
+                "pricingPerMTok": { "input": 0.38, "output": 1.15 },
+                "vision": true,
+                "status": "preview",
+                "description": "Google Gemma 4 31B IT (vision; vendor preview)"
+            }
+        },
+        "topModels": [
+            "Meta-Llama-3.3-70B-Instruct",
+            "gpt-oss-120b",
+            "DeepSeek-V3.1",
+            "DeepSeek-V3.2",
+            "MiniMax-M2.7",
+            "MiniMax-M3",
+            "gemma-4-31B-it"
+        ]
+    },
+    "capabilities": {
+        "text": true,
+        "streaming": true,
+        "tools": true,
+        "toolsWithStreaming": true,
+        "structuredOutput": true,
+        "structuredOutputWithTools": false,
+        "embeddings": false,
+        "thinking": false
+    },
+    "errorRules": [
+        {
+            "status": 401,
+            "pattern": "invalid_api_key|Incorrect API key|authentication_error",
+            "class": "authentication",
+            "message": "Invalid SambaNova API key. Check {apiKeyEnvVar}. Get one at https://cloud.sambanova.ai/apis"
+        },
+        {
+            "status": 402,
+            "pattern": "PAYMENT_METHOD_REQUIRED|balance_units",
+            "class": "provider",
+            "message": "SambaNova account has no credits (new accounts have no free allowance). Add a payment method and purchase credits at https://cloud.sambanova.ai/plans/billing"
+        }
+    ],
+    "setup": {
+        "url": "https://cloud.sambanova.ai/apis",
+        "apiKeyFormat": null,
+        "billingPolicy": "no-free-tier",
+        "instructions": [
+            "1. Visit: https://cloud.sambanova.ai (Google/Microsoft OAuth works)",
+            "2. Complete the profile step; note new accounts have NO free allowance — a payment method and purchased credits are required before calls succeed",
+            "3. Create an API key under API Keys",
+            "4. Set {apiKeyEnvVar} in your .env file"
+        ]
+    },
+    "evidence": {
+        "rosterVerified": {
+            "date": "2026-08-27",
+            "method": "authenticated GET /v1/models"
+        },
+        "authProbe": {
+            "date": "2026-08-27",
+            "status": 401,
+            "code": "invalid_api_key"
+        },
+        "billingProbe": {
+            "date": "2026-08-27",
+            "status": 402,
+            "code": "PAYMENT_METHOD_REQUIRED"
+        },
+        "liveMatrix": { "date": "2026-08-28", "result": "5/5" },
+        "addedInPR": "https://github.com/juspay/neurolink/pull/1586"
+    }
+}

package/dist/providers/catalog/schema.d.ts

@@ -0,0 +1,123 @@
+/**
+ * zod validator for the single-JSON provider catalog authoring format.
+ * Mirrors src/lib/types/providerCatalog.ts field-for-field with
+ * z.strictObject (unknown keys are authoring mistakes) plus the
+ * cross-field refinements the plain types cannot express. See
+ * docs/superpowers/plans/2026-08-28-provider-json-catalog-spec.md.
+ *
+ * provider-catalog.schema.json is a hand-kept JSON Schema mirror for
+ * editor validation only — this file is the authoritative validator.
+ */
+import { z } from "zod";
+import type { ProviderCatalogJson } from "../../types/index.js";
+export declare const providerCatalogJsonSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    displayName: z.ZodString;
+    enumTypeName: z.ZodOptional<z.ZodString>;
+    credentialsKey: z.ZodOptional<z.ZodString>;
+    aliases: z.ZodArray<z.ZodString>;
+    tier: z.ZodLiteral<2>;
+    wire: z.ZodObject<{
+        baseURL: z.ZodOptional<z.ZodString>;
+        baseURLTemplate: z.ZodOptional<z.ZodString>;
+        extraCredentials: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        missingCredentialMessage: z.ZodOptional<z.ZodString>;
+        envOverrides: z.ZodOptional<z.ZodObject<{
+            apiKey: z.ZodOptional<z.ZodString>;
+            baseURL: z.ZodOptional<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    models: z.ZodObject<{
+        default: z.ZodString;
+        fallbacks: z.ZodArray<z.ZodString>;
+        fallbackModelName: z.ZodOptional<z.ZodString>;
+        registryDefaultModel: z.ZodOptional<z.ZodString>;
+        defaultContextWindow: z.ZodNumber;
+        defaultMaxOutputTokens: z.ZodNumber;
+        catalog: z.ZodRecord<z.ZodString, z.ZodObject<{
+            contextWindow: z.ZodOptional<z.ZodNumber>;
+            maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+            pricingPerMTok: z.ZodOptional<z.ZodObject<{
+                input: z.ZodNumber;
+                output: z.ZodNumber;
+                cachedInput: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+            vision: z.ZodBoolean;
+            status: z.ZodEnum<{
+                production: "production";
+                preview: "preview";
+                retired: "retired";
+            }>;
+            description: z.ZodString;
+            enumMember: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        topModels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        visionModel: z.ZodOptional<z.ZodString>;
+        testModel: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    capabilities: z.ZodObject<{
+        text: z.ZodBoolean;
+        streaming: z.ZodBoolean;
+        tools: z.ZodBoolean;
+        toolsWithStreaming: z.ZodBoolean;
+        structuredOutput: z.ZodBoolean;
+        structuredOutputWithTools: z.ZodBoolean;
+        embeddings: z.ZodBoolean;
+        thinking: z.ZodBoolean;
+    }, z.core.$strict>;
+    errorRules: z.ZodArray<z.ZodObject<{
+        status: z.ZodOptional<z.ZodNumber>;
+        pattern: z.ZodOptional<z.ZodString>;
+        class: z.ZodEnum<{
+            network: "network";
+            provider: "provider";
+            authentication: "authentication";
+            "invalid-model": "invalid-model";
+            "rate-limit": "rate-limit";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strict>>;
+    quirks: z.ZodOptional<z.ZodObject<{
+        timeoutErrorClass: z.ZodOptional<z.ZodLiteral<"provider">>;
+        registryDefaultIgnoresModelEnvVar: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    setup: z.ZodObject<{
+        url: z.ZodString;
+        apiKeyFormat: z.ZodNullable<z.ZodString>;
+        billingPolicy: z.ZodEnum<{
+            "free-with-card": "free-with-card";
+            "free-tier": "free-tier";
+            "no-free-tier": "no-free-tier";
+        }>;
+        instructions: z.ZodArray<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    evidence: z.ZodObject<{
+        rosterVerified: z.ZodObject<{
+            date: z.ZodString;
+            status: z.ZodOptional<z.ZodNumber>;
+            code: z.ZodOptional<z.ZodString>;
+            method: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        authProbe: z.ZodOptional<z.ZodObject<{
+            date: z.ZodString;
+            status: z.ZodOptional<z.ZodNumber>;
+            code: z.ZodOptional<z.ZodString>;
+            method: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        billingProbe: z.ZodOptional<z.ZodObject<{
+            date: z.ZodString;
+            status: z.ZodOptional<z.ZodNumber>;
+            code: z.ZodOptional<z.ZodString>;
+            method: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        liveMatrix: z.ZodNullable<z.ZodObject<{
+            date: z.ZodString;
+            result: z.ZodString;
+        }, z.core.$strict>>;
+        addedInPR: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare function parseProviderCatalogJson(raw: unknown, sourcePath: string): ProviderCatalogJson;