@juspay/neurolink 12.49.9 → 12.49.10

package/dist/providers/decide/dialects/index.d.ts

@@ -0,0 +1,2 @@
+import type { DecideDialectName, DecisionDialect } from "../../../types/index.js";
+export declare const getDecisionDialect: (name: DecideDialectName) => DecisionDialect;

package/dist/providers/decide/dialects/index.js

@@ -0,0 +1,5 @@
+import { systemOneDialect } from "./systemOne.js";
+const DIALECTS = {
+    "system-one": systemOneDialect,
+};
+export const getDecisionDialect = (name) => DIALECTS[name];

package/dist/providers/decide/dialects/systemOne.d.ts

@@ -0,0 +1,2 @@
+import type { DecisionDialect } from "../../../types/index.js";
+export declare const systemOneDialect: DecisionDialect;

package/dist/providers/decide/dialects/systemOne.js

@@ -0,0 +1,104 @@
+import { asNumber, asNumberMap, asStringMap, isRecord } from "../guards.js";
+/**
+ * Last-resort confidence, when no transport reported one.
+ *
+ * The peak probability is what a calibrated confidence approximates, but it is
+ * NOT the same number, so a threshold tuned against a vendor's calibrated
+ * figure does not transfer unexamined; an even distribution lands near 1/N
+ * rather than 0.
+ */
+function deriveConfidence(probabilities) {
+    const values = Object.values(probabilities);
+    return values.length > 0 ? Math.max(...values) : 0;
+}
+/**
+ * Validate one answer off the wire. Returns null rather than throwing so a
+ * single malformed answer degrades to "unanswered" instead of failing the
+ * whole batch — the batch may hold hundreds of usable answers.
+ */
+function parseDecisionAnswer(raw, reportedConfidence) {
+    if (!isRecord(raw)) {
+        return null;
+    }
+    switch (raw.type) {
+        // "noul" is the System One wire's own spelling; "boolean" is the neutral
+        // one (Vercel's gateway), which renames both the type and the field.
+        // Accepting both keeps one parser for every transport.
+        case "noul":
+        case "boolean": {
+            const probability = asNumber(raw.noul) ?? asNumber(raw.probability);
+            return probability === undefined
+                ? null
+                : { type: "boolean", probability };
+        }
+        case "choice": {
+            const probabilities = asNumberMap(raw.probabilities);
+            if (typeof raw.choice !== "string" || !probabilities) {
+                return null;
+            }
+            return {
+                type: "choice",
+                choice: raw.choice,
+                confidence: asNumber(raw.confidence) ??
+                    reportedConfidence ??
+                    deriveConfidence(probabilities),
+                probabilities,
+            };
+        }
+        case "score": {
+            const score = asNumber(raw.score);
+            const legend = asStringMap(raw.legend);
+            const probabilities = asNumberMap(raw.probabilities);
+            if (score === undefined || !legend || !probabilities) {
+                return null;
+            }
+            return {
+                type: "score",
+                score,
+                confidence: asNumber(raw.confidence) ??
+                    reportedConfidence ??
+                    deriveConfidence(probabilities),
+                legend,
+                probabilities,
+            };
+        }
+        default:
+            return null;
+    }
+}
+/**
+ * The System One wire calls the yes/no primitive `noul`; this codebase and
+ * every SDK exposing it call it `boolean`.
+ */
+function encodeQuestion(question) {
+    if (question.type === "boolean") {
+        return {
+            type: "noul",
+            instructions: question.instructions,
+            ...(question.criteria ? { criteria: question.criteria } : {}),
+        };
+    }
+    return question;
+}
+export const systemOneDialect = {
+    name: "system-one",
+    encodeQuestion,
+    readAnswers: (decoded, reportedConfidence) => {
+        const raw = decoded.answers;
+        if (!isRecord(raw)) {
+            return undefined;
+        }
+        const answers = {};
+        const dropped = [];
+        for (const [id, value] of Object.entries(raw)) {
+            const parsed = parseDecisionAnswer(value, reportedConfidence[id]);
+            if (parsed) {
+                answers[id] = parsed;
+            }
+            else {
+                dropped.push(id);
+            }
+        }
+        return { answers, dropped };
+    },
+};

package/dist/providers/decide/guards.d.ts

@@ -0,0 +1,4 @@
+export declare const isRecord: (v: unknown) => v is Record<string, unknown>;
+export declare const asNumber: (v: unknown) => number | undefined;
+export declare const asNumberMap: (v: unknown) => Record<string, number> | undefined;
+export declare const asStringMap: (v: unknown) => Record<string, string> | undefined;

package/dist/providers/decide/guards.js

@@ -0,0 +1,29 @@
+export const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+export const asNumber = (v) => typeof v === "number" && Number.isFinite(v) ? v : undefined;
+export const asNumberMap = (v) => {
+    if (!isRecord(v)) {
+        return undefined;
+    }
+    const out = {};
+    for (const [k, raw] of Object.entries(v)) {
+        const n = asNumber(raw);
+        if (n === undefined) {
+            return undefined;
+        }
+        out[k] = n;
+    }
+    return out;
+};
+export const asStringMap = (v) => {
+    if (!isRecord(v)) {
+        return undefined;
+    }
+    const out = {};
+    for (const [k, raw] of Object.entries(v)) {
+        if (typeof raw !== "string") {
+            return undefined;
+        }
+        out[k] = raw;
+    }
+    return out;
+};

package/dist/providers/systemOneDecision.d.ts

@@ -1,15 +1,14 @@
 import type { AIProviderName } from "../constants/enums.js";
 import { BaseProvider } from "../core/baseProvider.js";
 import { ProviderError } from "../types/index.js";
-import type { DecisionError, DecisionQuestion, DecisionRequest, DecisionResult, DecisionPreparedMedia, DecisionState, LanguageModel, StreamOptions, StreamResult, ValidationSchema } from "../types/index.js";
+import type { DecisionDialect, DecisionError, DecisionQuestion, DecisionRequest, DecisionResult, DecisionPreparedMedia, DecisionState, LanguageModel, StreamOptions, StreamResult, ValidationSchema } from "../types/index.js";
 /**
  * Generous enough for a cold start (measured at 2.0–2.7s after idle on Jev)
  * while still bounded. Every internal caller is fail-open, so this only bites
  * on a genuine stall.
  */
 export declare const DEFAULT_DECISION_TIMEOUT_MS = 5000;
-export declare const isRecord: (v: unknown) => v is Record<string, unknown>;
-export declare const asNumber: (v: unknown) => number | undefined;
+export { asNumber, isRecord } from "./decide/guards.js";
 /**
  * FastAPI's request-validation envelope, `{"detail":[{loc, msg, input}]}`,
  * reduced to its field paths and messages. `input` echoes the caller's own
@@ -73,6 +72,11 @@ export declare abstract class SystemOneDecisionProvider extends BaseProvider {
      * every SDK exposing it call it `boolean`.
      */
     protected encodeQuestion(question: DecisionQuestion): Record<string, unknown>;
+    /**
+     * The wire family this provider speaks. A provider on another layout
+     * overrides it; every one so far speaks System One.
+     */
+    protected dialect(): DecisionDialect;
     /**
      * How long a rate-limited or unavailable response asks the caller to wait.
      * Undefined keeps the default backoff. A wait longer than what is left of the

package/dist/providers/systemOneDecision.js

@@ -7,6 +7,8 @@ import { prepareDecisionMedia } from "../utils/decisionMedia.js";
 import { logger } from "../utils/logger.js";
 import { redactUrlsInText } from "../utils/logSanitize.js";
 import { estimateDecisionStateTokens, resolveDecisionLimitsReading, } from "../utils/decisionLimits.js";
+import { systemOneDialect } from "./decide/dialects/systemOne.js";
+import { asNumber, isRecord } from "./decide/guards.js";
 /**
  * Generous enough for a cold start (measured at 2.0–2.7s after idle on Jev)
  * while still bounded. Every internal caller is fail-open, so this only bites
@@ -14,102 +16,7 @@ import { estimateDecisionStateTokens, resolveDecisionLimitsReading, } from "../u
  */
 export const DEFAULT_DECISION_TIMEOUT_MS = 5000;
 const DEFAULT_MAX_RETRIES = 1;
-export const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
-export const asNumber = (v) => typeof v === "number" && Number.isFinite(v) ? v : undefined;
-const asNumberMap = (v) => {
-    if (!isRecord(v)) {
-        return undefined;
-    }
-    const out = {};
-    for (const [k, raw] of Object.entries(v)) {
-        const n = asNumber(raw);
-        if (n === undefined) {
-            return undefined;
-        }
-        out[k] = n;
-    }
-    return out;
-};
-const asStringMap = (v) => {
-    if (!isRecord(v)) {
-        return undefined;
-    }
-    const out = {};
-    for (const [k, raw] of Object.entries(v)) {
-        if (typeof raw !== "string") {
-            return undefined;
-        }
-        out[k] = raw;
-    }
-    return out;
-};
-/**
- * Last-resort confidence, when no transport reported one.
- *
- * The peak probability is what a calibrated confidence approximates, but it is
- * NOT the same number, so a threshold tuned against a vendor's calibrated
- * figure does not transfer unexamined; an even distribution lands near 1/N
- * rather than 0.
- */
-function deriveConfidence(probabilities) {
-    const values = Object.values(probabilities);
-    return values.length > 0 ? Math.max(...values) : 0;
-}
-/**
- * Validate one answer off the wire. Returns null rather than throwing so a
- * single malformed answer degrades to "unanswered" instead of failing the
- * whole batch — the batch may hold hundreds of usable answers.
- */
-function parseDecisionAnswer(raw, reportedConfidence) {
-    if (!isRecord(raw)) {
-        return null;
-    }
-    switch (raw.type) {
-        // "noul" is the System One wire's own spelling; "boolean" is the neutral
-        // one (Vercel's gateway), which renames both the type and the field.
-        // Accepting both keeps one parser for every transport.
-        case "noul":
-        case "boolean": {
-            const probability = asNumber(raw.noul) ?? asNumber(raw.probability);
-            return probability === undefined
-                ? null
-                : { type: "boolean", probability };
-        }
-        case "choice": {
-            const probabilities = asNumberMap(raw.probabilities);
-            if (typeof raw.choice !== "string" || !probabilities) {
-                return null;
-            }
-            return {
-                type: "choice",
-                choice: raw.choice,
-                confidence: asNumber(raw.confidence) ??
-                    reportedConfidence ??
-                    deriveConfidence(probabilities),
-                probabilities,
-            };
-        }
-        case "score": {
-            const score = asNumber(raw.score);
-            const legend = asStringMap(raw.legend);
-            const probabilities = asNumberMap(raw.probabilities);
-            if (score === undefined || !legend || !probabilities) {
-                return null;
-            }
-            return {
-                type: "score",
-                score,
-                confidence: asNumber(raw.confidence) ??
-                    reportedConfidence ??
-                    deriveConfidence(probabilities),
-                legend,
-                probabilities,
-            };
-        }
-        default:
-            return null;
-    }
-}
+export { asNumber, isRecord } from "./decide/guards.js";
 /**
  * FastAPI's request-validation envelope, `{"detail":[{loc, msg, input}]}`,
  * reduced to its field paths and messages. `input` echoes the caller's own
@@ -210,14 +117,14 @@ export class SystemOneDecisionProvider extends BaseProvider {
      * every SDK exposing it call it `boolean`.
      */
     encodeQuestion(question) {
-        if (question.type === "boolean") {
-            return {
-                type: "noul",
-                instructions: question.instructions,
-                ...(question.criteria ? { criteria: question.criteria } : {}),
-            };
-        }
-        return question;
+        return this.dialect().encodeQuestion(question);
+    }
+    /**
+     * The wire family this provider speaks. A provider on another layout
+     * overrides it; every one so far speaks System One.
+     */
+    dialect() {
+        return systemOneDialect;
     }
     /**
      * How long a rate-limited or unavailable response asks the caller to wait.
@@ -389,7 +296,10 @@ export class SystemOneDecisionProvider extends BaseProvider {
                     continue;
                 }
                 const decoded = this.readDecisionPayload(payload);
-                if (!isRecord(decoded) || !isRecord(decoded.answers)) {
+                const reading = isRecord(decoded)
+                    ? this.dialect().readAnswers(decoded, this.reportedConfidence(decoded))
+                    : undefined;
+                if (!isRecord(decoded) || !reading) {
                     throw this.decisionError({
                         kind: "server",
                         message: `${label} returned a response without an answers map.`,
@@ -398,19 +308,12 @@ export class SystemOneDecisionProvider extends BaseProvider {
                         retryable: false,
                     });
                 }
-                const reported = this.reportedConfidence(decoded);
-                const answers = {};
-                for (const [id, raw] of Object.entries(decoded.answers)) {
-                    const parsed = parseDecisionAnswer(raw, reported[id]);
-                    if (parsed) {
-                        answers[id] = parsed;
-                    }
-                    else {
-                        logger.warn(`${label}: dropped unparseable answer "${id}"`, {
-                            requestId,
-                        });
-                    }
+                for (const id of reading.dropped) {
+                    logger.warn(`${label}: dropped unparseable answer "${id}"`, {
+                        requestId,
+                    });
                 }
+                const answers = { ...reading.answers };
                 const usage = isRecord(decoded.usage) ? decoded.usage : {};
                 return {
                     // `resolvedModel`, not `this.modelName`: when the caller pinned a

package/dist/types/decision.d.ts

@@ -522,3 +522,20 @@ export type DecisionBooleanGate = {
     /** Minimum {@link decisionBooleanConfidence} to act at all. Default 0.4. */
     minConfidence?: number;
 };
+/** The wire family a decide provider speaks. */
+export type DecideDialectName = "system-one";
+export type DecisionAnswerReading = {
+    readonly answers: Readonly<Record<string, DecisionAnswer>>;
+    /** Ids of answers the server returned that could not be parsed. */
+    readonly dropped: readonly string[];
+};
+/**
+ * How questions are written to, and answers read from, a decide wire. One
+ * dialect serves every vendor that speaks the same layout.
+ */
+export type DecisionDialect = {
+    readonly name: DecideDialectName;
+    encodeQuestion: (question: DecisionQuestion) => Record<string, unknown>;
+    /** `undefined` means the response has no usable answers container. */
+    readAnswers: (decoded: Readonly<Record<string, unknown>>, reportedConfidence: Readonly<Record<string, number>>) => DecisionAnswerReading | undefined;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "12.49.9",
+  "version": "12.49.10",
   "packageManager": "pnpm@10.15.1",
   "description": "The pipe layer of an AI nervous system: one interface connecting provider neurons to your application, across three inference types — generate, stream and decide. `decide` returns typed, calibrated judgements from a non-generative model (~400ms, ~$0.00002/call) for routing, tool selection and context budgeting. MCP-native (4 transports), voice TTS/STT/realtime, RAG, agents, memory, compaction, 9 observability exporters. OpenAI · Anthropic · Gemini · Bedrock · Azure · Ollama · TypeSafe Jev and more.",
   "author": {