@juspay/neurolink 9.38.0 → 9.40.0

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

@@ -426,8 +426,37 @@ export type GenerateOptions = {
         read?: boolean;
         /** Whether to write (add/condense) the conversation into memory after completion. Defaults to true. */
         write?: boolean;
+        /**
+         * Additional users whose memory should be retrieved/stored alongside the primary user.
+         * Each entry can override the condensation prompt and maxWords for that user.
+         * Primary user is still determined by context.userId.
+         */
+        additionalUsers?: AdditionalMemoryUser[];
     };
 };
+/**
+ * Represents an additional user whose memory should be included in a generate/stream call.
+ * Allows per-user prompt overrides for different memory condensation strategies
+ * (e.g. personal preferences vs org-level policies).
+ */
+export type AdditionalMemoryUser = {
+    /** The user/owner ID to retrieve or store memory for. */
+    userId: string;
+    /**
+     * Human-readable label used in the formatted memory context.
+     * E.g. "Organization Policy", "Team Context", "User Preferences".
+     * If not provided, defaults to userId.
+     */
+    label?: string;
+    /** Whether to read this user's memory and include in context. Defaults to true. */
+    read?: boolean;
+    /** Whether to write conversation into this user's memory. Defaults to true. */
+    write?: boolean;
+    /** Custom condensation prompt for this user. Overrides the default Hippocampus prompt. */
+    prompt?: string;
+    /** Max words for this user's condensed memory. Overrides the default maxWords. */
+    maxWords?: number;
+};
 /**
  * Generate function result type - Primary output format
  * Future-ready for multi-modal outputs while maintaining text focus

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

@@ -22,7 +22,7 @@ export type { DomainConfig, DomainConfigOptions, DomainEvaluationCriteria, Domai
 export * from "./evaluation.js";
 export * from "./evaluationProviders.js";
 export * from "./fileTypes.js";
-export type { EnhancedGenerateResult, EnhancedProvider, FactoryEnhancedProvider, GenerateOptions, GenerateResult as GenerateApiResult, // Renamed to avoid conflict with cli.js GenerateResult
+export type { AdditionalMemoryUser, EnhancedGenerateResult, EnhancedProvider, FactoryEnhancedProvider, GenerateOptions, GenerateResult as GenerateApiResult, // Renamed to avoid conflict with cli.js GenerateResult
 TextGenerationOptions, TextGenerationResult, UnifiedGenerationOptions, } from "./generateTypes.js";
 export * from "./hitlTypes.js";
 export * from "./middlewareTypes.js";

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

@@ -10,6 +10,7 @@ import type { Content, ImageWithAltText } from "./content.js";
 import type { ChatMessage } from "./conversation.js";
 import type { AIModelProviderConfig } from "./providers.js";
 import type { TTSChunk, TTSOptions } from "./ttsTypes.js";
+import type { AdditionalMemoryUser } from "./generateTypes.js";
 import type { StandardRecord, ValidationSchema } from "./typeAliases.js";
 /**
  * Progress tracking and metadata for streaming operations
@@ -435,6 +436,12 @@ export type StreamOptions = {
         read?: boolean;
         /** Whether to write (add/condense) the conversation into memory after completion. Defaults to true. */
         write?: boolean;
+        /**
+         * Additional users whose memory should be retrieved/stored alongside the primary user.
+         * Each entry can override the condensation prompt and maxWords for that user.
+         * Primary user is still determined by context.userId.
+         */
+        additionalUsers?: AdditionalMemoryUser[];
     };
 };
 /**

package/dist/models/anthropicModels.d.ts

@@ -20,8 +20,10 @@ export declare enum AnthropicModel {
     CLAUDE_3_5_SONNET = "claude-3-5-sonnet-20241022",
     CLAUDE_3_5_SONNET_V2 = "claude-3-5-sonnet-v2-20241022",
     CLAUDE_SONNET_4 = "claude-sonnet-4-20250514",
+    CLAUDE_SONNET_4_6 = "claude-sonnet-4-6",
     CLAUDE_3_OPUS = "claude-3-opus-20240229",
-    CLAUDE_OPUS_4 = "claude-opus-4-20250514"
+    CLAUDE_OPUS_4 = "claude-opus-4-20250514",
+    CLAUDE_OPUS_4_6 = "claude-opus-4-6"
 }
 /**
  * Model access mapping by subscription tier

package/dist/models/anthropicModels.js

@@ -27,10 +27,14 @@ export var AnthropicModel;
     AnthropicModel["CLAUDE_3_5_SONNET_V2"] = "claude-3-5-sonnet-v2-20241022";
     // Claude Sonnet 4 (Latest Sonnet)
     AnthropicModel["CLAUDE_SONNET_4"] = "claude-sonnet-4-20250514";
+    // Claude Sonnet 4.6
+    AnthropicModel["CLAUDE_SONNET_4_6"] = "claude-sonnet-4-6";
     // Claude 3 Opus (Legacy flagship)
     AnthropicModel["CLAUDE_3_OPUS"] = "claude-3-opus-20240229";
     // Claude Opus 4 (Latest flagship)
     AnthropicModel["CLAUDE_OPUS_4"] = "claude-opus-4-20250514";
+    // Claude Opus 4.6
+    AnthropicModel["CLAUDE_OPUS_4_6"] = "claude-opus-4-6";
 })(AnthropicModel || (AnthropicModel = {}));
 // ============================================================================
 // MODEL TIER ACCESS DEFINITIONS
@@ -56,6 +60,7 @@ export const MODEL_TIER_ACCESS = {
         AnthropicModel.CLAUDE_3_5_SONNET,
         AnthropicModel.CLAUDE_3_5_SONNET_V2,
         AnthropicModel.CLAUDE_SONNET_4,
+        AnthropicModel.CLAUDE_SONNET_4_6,
     ],
     // Max tier: All models including Opus
     max: ["*"], // All models
@@ -167,6 +172,32 @@ export const MODEL_METADATA = {
         family: "opus",
         description: "Latest flagship model with advanced reasoning",
     },
+    // Claude Sonnet 4.6
+    [AnthropicModel.CLAUDE_SONNET_4_6]: {
+        displayName: "Claude Sonnet 4.6",
+        contextWindow: 1000000,
+        maxOutputTokens: 64000,
+        supportsVision: true,
+        supportsExtendedThinking: true,
+        supportsToolUse: true,
+        supportsStreaming: true,
+        deprecated: false,
+        family: "sonnet",
+        description: "Claude 4.6 Sonnet with 1M context window",
+    },
+    // Claude Opus 4.6
+    [AnthropicModel.CLAUDE_OPUS_4_6]: {
+        displayName: "Claude Opus 4.6",
+        contextWindow: 1000000,
+        maxOutputTokens: 64000,
+        supportsVision: true,
+        supportsExtendedThinking: true,
+        supportsToolUse: true,
+        supportsStreaming: true,
+        deprecated: false,
+        family: "opus",
+        description: "Claude 4.6 Opus flagship with 1M context window",
+    },
 };
 // ============================================================================
 // DEFAULT MODELS BY TIER
@@ -417,11 +448,16 @@ export function getLatestModelsByFamily() {
     const familyPriority = {
         haiku: [AnthropicModel.CLAUDE_3_5_HAIKU, AnthropicModel.CLAUDE_3_HAIKU],
         sonnet: [
+            AnthropicModel.CLAUDE_SONNET_4_6,
             AnthropicModel.CLAUDE_SONNET_4,
             AnthropicModel.CLAUDE_3_5_SONNET_V2,
             AnthropicModel.CLAUDE_3_5_SONNET,
         ],
-        opus: [AnthropicModel.CLAUDE_OPUS_4, AnthropicModel.CLAUDE_3_OPUS],
+        opus: [
+            AnthropicModel.CLAUDE_OPUS_4_6,
+            AnthropicModel.CLAUDE_OPUS_4,
+            AnthropicModel.CLAUDE_3_OPUS,
+        ],
     };
     for (const family of Object.keys(familyPriority)) {
         for (const model of familyPriority[family]) {

package/dist/neurolink.d.ts

@@ -181,6 +181,10 @@ export declare class NeuroLink {
     private registerMemoryRetrievalTools;
     /** Format memory context for prompt inclusion */
     private formatMemoryContext;
+    /**
+     * Format memory context from multiple users into a labeled block.
+     */
+    private formatMultiUserMemoryContext;
     /**
      * Determine whether memory should be read (retrieved) for this call.
      * Respects both the global memory SDK config and per-call overrides.
@@ -192,13 +196,14 @@ export declare class NeuroLink {
      */
     private shouldWriteMemory;
     /**
-     * Retrieve condensed memory for a user.
+     * Retrieve condensed memory for a user (and optionally additional users).
      * Returns the input text enhanced with memory context, or unchanged if no memory.
      */
     private retrieveMemory;
     /**
      * Store a conversation turn in memory (non-blocking).
      * Calls add(userId, content) which internally condenses old + new via LLM.
+     * Supports additional users with per-user prompt and maxWords overrides.
      */
     private storeMemoryInBackground;
     /**

package/dist/neurolink.js

@@ -823,6 +823,20 @@ export class NeuroLink {
 
 ${memoryContext}
 
+Current user's request: ${currentInput}`;
+    }
+    /**
+     * Format memory context from multiple users into a labeled block.
+     */
+    formatMultiUserMemoryContext(memories, currentInput) {
+        const memoryBlocks = [];
+        for (const [label, memory] of memories) {
+            memoryBlocks.push(`[${label}]\n${memory}`);
+        }
+        return `Context from previous conversations:
+
+${memoryBlocks.join("\n\n")}
+
 Current user's request: ${currentInput}`;
     }
     /**
@@ -863,32 +877,71 @@ Current user's request: ${currentInput}`;
         return true;
     }
     /**
-     * Retrieve condensed memory for a user.
+     * Retrieve condensed memory for a user (and optionally additional users).
      * Returns the input text enhanced with memory context, or unchanged if no memory.
      */
-    async retrieveMemory(inputText, userId) {
+    async retrieveMemory(inputText, userId, additionalUsers) {
         const client = this.ensureMemoryReady();
         if (!client) {
             return inputText;
         }
-        const memory = await client.get(userId);
-        if (!memory) {
+        // Collect all user IDs to read (primary + additional users with read !== false)
+        const readableAdditional = (additionalUsers || []).filter((u) => u.read !== false);
+        if (readableAdditional.length === 0) {
+            // Single user — use original fast path
+            const memory = await client.get(userId);
+            if (!memory) {
+                return inputText;
+            }
+            return this.formatMemoryContext(memory, inputText);
+        }
+        // Multi-user: fetch all memories in parallel
+        // Build entries with labels for formatting
+        const entries = [
+            { id: userId, label: "User" },
+            ...readableAdditional.map((u) => ({
+                id: u.userId,
+                label: u.label || u.userId,
+            })),
+        ];
+        const results = await Promise.all(entries.map(async (entry) => {
+            const memory = await client.get(entry.id);
+            return { ...entry, memory };
+        }));
+        const memories = new Map();
+        for (const { label, memory } of results) {
+            if (memory) {
+                memories.set(label, memory);
+            }
+        }
+        if (memories.size === 0) {
             return inputText;
         }
-        return this.formatMemoryContext(memory, inputText);
+        return this.formatMultiUserMemoryContext(memories, inputText);
     }
     /**
      * Store a conversation turn in memory (non-blocking).
      * Calls add(userId, content) which internally condenses old + new via LLM.
+     * Supports additional users with per-user prompt and maxWords overrides.
      */
-    storeMemoryInBackground(originalPrompt, responseContent, userId) {
+    storeMemoryInBackground(originalPrompt, responseContent, userId, additionalUsers) {
         setImmediate(async () => {
             try {
                 const client = this.ensureMemoryReady();
-                if (client) {
-                    const content = `User: ${originalPrompt}\nAssistant: ${responseContent}`;
-                    await client.add(userId, content);
+                if (!client) {
+                    return;
                 }
+                const content = `User: ${originalPrompt}\nAssistant: ${responseContent}`;
+                // Collect all users to write: primary + additional users with write !== false
+                const writeOps = [client.add(userId, content)];
+                const writableAdditional = (additionalUsers || []).filter((u) => u.write !== false);
+                for (const user of writableAdditional) {
+                    const addOptions = user.prompt || user.maxWords
+                        ? { prompt: user.prompt, maxWords: user.maxWords }
+                        : undefined;
+                    writeOps.push(client.add(user.userId, content, addOptions));
+                }
+                await Promise.all(writeOps);
             }
             catch (error) {
                 logger.warn("Memory storage failed:", error);
@@ -2428,6 +2481,17 @@ Current user's request: ${currentInput}`;
                                 });
                             }
                         }
+                        // Memory retrieval for generate path
+                        if (this.shouldReadMemory(options.memory, options.context?.userId) &&
+                            options.context?.userId) {
+                            try {
+                                options.input.text = await this.retrieveMemory(options.input.text, options.context.userId, options.memory?.additionalUsers);
+                                logger.debug("Memory retrieval successful (generate)");
+                            }
+                            catch (error) {
+                                logger.warn("Memory retrieval failed (generate):", error);
+                            }
+                        }
                         // 🔧 CRITICAL FIX: Convert to TextGenerationOptions while preserving the input object for multimodal support
                         const baseOptions = {
                             prompt: options.input.text,
@@ -2613,7 +2677,7 @@ Current user's request: ${currentInput}`;
         // Memory storage
         if (this.shouldWriteMemory(options.memory, options.context?.userId, generateResult.content) &&
             options.context?.userId) {
-            this.storeMemoryInBackground(originalPrompt ?? "", generateResult.content.trim(), options.context.userId);
+            this.storeMemoryInBackground(originalPrompt ?? "", generateResult.content.trim(), options.context.userId, options.memory?.additionalUsers);
         }
     }
     /**
@@ -4411,7 +4475,7 @@ Current user's request: ${currentInput}`;
         if (this.shouldReadMemory(options.memory, options.context?.userId) &&
             options.context?.userId) {
             try {
-                options.input.text = await this.retrieveMemory(options.input.text, options.context.userId);
+                options.input.text = await this.retrieveMemory(options.input.text, options.context.userId, options.memory?.additionalUsers);
                 logger.debug("Memory retrieval successful");
             }
             catch (error) {
@@ -4724,7 +4788,7 @@ Current user's request: ${currentInput}`;
             }
         }
         if (this.shouldWriteMemory(enhancedOptions.memory, enhancedOptions.context?.userId, accumulatedContent)) {
-            this.storeMemoryInBackground(originalPrompt ?? "", accumulatedContent.trim(), enhancedOptions.context?.userId);
+            this.storeMemoryInBackground(originalPrompt ?? "", accumulatedContent.trim(), enhancedOptions.context?.userId, enhancedOptions.memory?.additionalUsers);
         }
     }
     /**

package/dist/providers/anthropic.js

@@ -140,7 +140,24 @@ const detectSubscriptionTier = (oauthToken) => {
  * OAuth takes precedence over API key if both are available.
  */
 const detectAuthMethod = (oauthToken) => {
-    // OAuth takes precedence if available
+    // Explicit env var takes highest precedence — allows forcing api_key mode
+    // even when OAuth credentials exist (e.g., when using a proxy that handles auth)
+    const explicit = process.env.ANTHROPIC_AUTH_METHOD?.toLowerCase();
+    if (explicit === "api_key" || explicit === "apikey") {
+        logger.debug("[detectAuthMethod] Forced to api_key by ANTHROPIC_AUTH_METHOD env var");
+        return "api_key";
+    }
+    if (explicit === "oauth") {
+        if (oauthToken) {
+            logger.debug("[detectAuthMethod] Forced to oauth by ANTHROPIC_AUTH_METHOD env var");
+            return "oauth";
+        }
+        logger.warn("[detectAuthMethod] ANTHROPIC_AUTH_METHOD=oauth but no OAuth token found; falling through to auto-detection");
+    }
+    else if (explicit) {
+        logger.warn("[detectAuthMethod] Unrecognized ANTHROPIC_AUTH_METHOD value; falling through to auto-detection", { value: explicit });
+    }
+    // Auto-detect: OAuth takes precedence if available
     const method = oauthToken ? "oauth" : "api_key";
     logger.debug("[detectAuthMethod] Auth method resolved", {
         method,
@@ -200,11 +217,22 @@ export class AnthropicProvider extends BaseProvider {
     constructor(modelName, sdk, config) {
         // Pre-compute effective model with tier validation before calling super
         const oauthToken = config?.oauthToken ?? getOAuthToken();
-        const subscriptionTier = config?.subscriptionTier ?? detectSubscriptionTier(oauthToken);
+        // Resolve auth method FIRST so that tier detection uses the chosen method.
+        // If ANTHROPIC_AUTH_METHOD=api_key wins over an existing OAuth token, the
+        // tier must reflect api_key mode (full model access) rather than the OAuth
+        // token's subscription level.
+        const authMethod = config?.authMethod ?? detectAuthMethod(oauthToken);
+        const subscriptionTier = config?.subscriptionTier ??
+            (authMethod === "oauth" ? detectSubscriptionTier(oauthToken) : "api");
         const targetModel = modelName || getDefaultAnthropicModel();
-        // Determine effective model based on tier access
+        // Determine effective model based on tier access.
+        // Skip tier validation when a proxy is in use (ANTHROPIC_BASE_URL is set)
+        // — the proxy handles model access and auth, so the SDK should pass
+        // the requested model through without downgrading.
         let effectiveModel = targetModel;
-        if (subscriptionTier !== "api" &&
+        const usingProxy = !!process.env.ANTHROPIC_BASE_URL;
+        if (!usingProxy &&
+            subscriptionTier !== "api" &&
             !isModelAvailableForTier(targetModel, subscriptionTier)) {
             effectiveModel = getRecommendedModelForTier(subscriptionTier);
             logger.warn("Model not available for subscription tier, using recommended model", {
@@ -219,8 +247,8 @@ export class AnthropicProvider extends BaseProvider {
         // Store computed values
         this.oauthToken = oauthToken;
         this.subscriptionTier = subscriptionTier;
-        // Determine auth method - config takes precedence, then auto-detect
-        this.authMethod = config?.authMethod ?? detectAuthMethod(this.oauthToken);
+        // Use the auth method already resolved above (before tier computation)
+        this.authMethod = authMethod;
         // Build headers based on auth method and subscription tier
         const headers = this.getAuthHeaders();
         // Create Anthropic instance based on auth method
@@ -348,6 +376,10 @@ export class AnthropicProvider extends BaseProvider {
      * ```
      */
     validateModelAccess(model) {
+        // Proxy mode: bypass tier validation entirely — the proxy handles model access
+        if (process.env.ANTHROPIC_BASE_URL) {
+            return true;
+        }
         // API tier has access to all models
         if (this.subscriptionTier === "api") {
             return true;