@juspay/neurolink 9.14.0 → 9.15.0

package/dist/cli/factories/authCommandFactory.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Auth Command Factory for NeuroLink
+ *
+ * Creates the unified authentication command with subcommands for AI providers.
+ * Follows the MCP command pattern with subcommands: login, logout, status, refresh.
+ *
+ * Supported providers:
+ * - Anthropic (API key + OAuth for Claude subscription plans)
+ */
+import type { CommandModule } from "yargs";
+/**
+ * Auth command arguments interface
+ */
+export interface AuthCommandArgs {
+    provider?: string;
+    method?: "api-key" | "oauth" | "create-api-key";
+    format?: "text" | "json";
+    quiet?: boolean;
+    debug?: boolean;
+    nonInteractive?: boolean;
+}
+/**
+ * Auth Command Factory
+ *
+ * Creates the main auth command with subcommands:
+ * - login: Authenticate with a provider
+ * - logout: Clear stored credentials
+ * - status: Show authentication status
+ * - refresh: Manually refresh OAuth tokens
+ */
+export declare class AuthCommandFactory {
+    /**
+     * Create the main auth command with subcommands
+     */
+    static createAuthCommands(): CommandModule;
+    /**
+     * Build options for login subcommand
+     */
+    private static buildLoginOptions;
+    /**
+     * Build options for logout subcommand
+     */
+    private static buildLogoutOptions;
+    /**
+     * Build options for status subcommand
+     */
+    private static buildStatusOptions;
+    /**
+     * Build options for refresh subcommand
+     */
+    private static buildRefreshOptions;
+}

package/dist/cli/factories/authCommandFactory.js

@@ -0,0 +1,146 @@
+/**
+ * Auth Command Factory for NeuroLink
+ *
+ * Creates the unified authentication command with subcommands for AI providers.
+ * Follows the MCP command pattern with subcommands: login, logout, status, refresh.
+ *
+ * Supported providers:
+ * - Anthropic (API key + OAuth for Claude subscription plans)
+ */
+/**
+ * Supported providers for authentication
+ */
+const SUPPORTED_PROVIDERS = ["anthropic"];
+/**
+ * Auth Command Factory
+ *
+ * Creates the main auth command with subcommands:
+ * - login: Authenticate with a provider
+ * - logout: Clear stored credentials
+ * - status: Show authentication status
+ * - refresh: Manually refresh OAuth tokens
+ */
+export class AuthCommandFactory {
+    /**
+     * Create the main auth command with subcommands
+     */
+    static createAuthCommands() {
+        return {
+            command: "auth <subcommand>",
+            describe: "Manage authentication with AI providers (API key or OAuth)",
+            builder: (yargs) => {
+                return yargs
+                    .command("login <provider>", "Authenticate with an AI provider", (yargs) => this.buildLoginOptions(yargs), async (argv) => {
+                    const { handleLogin } = await import("../commands/auth.js");
+                    await handleLogin(argv);
+                })
+                    .command("logout <provider>", "Clear stored credentials for a provider", (yargs) => this.buildLogoutOptions(yargs), async (argv) => {
+                    const { handleLogout } = await import("../commands/auth.js");
+                    await handleLogout(argv);
+                })
+                    .command("status [provider]", "Show authentication status for provider(s)", (yargs) => this.buildStatusOptions(yargs), async (argv) => {
+                    const { handleStatus } = await import("../commands/auth.js");
+                    await handleStatus(argv);
+                })
+                    .command("refresh <provider>", "Manually refresh OAuth tokens for a provider", (yargs) => this.buildRefreshOptions(yargs), async (argv) => {
+                    const { handleRefresh } = await import("../commands/auth.js");
+                    await handleRefresh(argv);
+                })
+                    .option("format", {
+                    choices: ["text", "json"],
+                    default: "text",
+                    description: "Output format",
+                })
+                    .option("quiet", {
+                    type: "boolean",
+                    alias: "q",
+                    default: false,
+                    description: "Suppress non-essential output",
+                })
+                    .option("debug", {
+                    type: "boolean",
+                    default: false,
+                    description: "Enable debug output",
+                })
+                    .demandCommand(1, "Please specify an auth subcommand")
+                    .example("$0 auth login anthropic", "Authenticate with Anthropic")
+                    .example("$0 auth login anthropic --method create-api-key", "Create API key via OAuth (Claude Pro/Max - Recommended)")
+                    .example("$0 auth status", "Show authentication status for all providers")
+                    .example("$0 auth logout anthropic", "Clear Anthropic stored credentials")
+                    .example("$0 auth refresh anthropic", "Refresh Anthropic OAuth tokens")
+                    .help();
+            },
+            handler: () => {
+                // No-op handler as subcommands handle everything
+            },
+        };
+    }
+    /**
+     * Build options for login subcommand
+     */
+    static buildLoginOptions(yargs) {
+        return yargs
+            .positional("provider", {
+            type: "string",
+            description: "AI provider to authenticate with",
+            choices: SUPPORTED_PROVIDERS,
+            demandOption: true,
+        })
+            .option("method", {
+            type: "string",
+            alias: "m",
+            description: "Authentication method",
+            choices: ["api-key", "oauth", "create-api-key"],
+        })
+            .option("non-interactive", {
+            type: "boolean",
+            description: "Skip interactive prompts (requires environment variables)",
+            default: false,
+        })
+            .example("$0 auth login anthropic", "Interactive authentication (choose method)")
+            .example("$0 auth login anthropic --method api-key", "API key authentication")
+            .example("$0 auth login anthropic --method create-api-key", "Create API key via OAuth (Claude Pro/Max)")
+            .example("$0 auth login anthropic --method oauth", "Direct OAuth (experimental)");
+    }
+    /**
+     * Build options for logout subcommand
+     */
+    static buildLogoutOptions(yargs) {
+        return yargs
+            .positional("provider", {
+            type: "string",
+            description: "AI provider to log out from",
+            choices: SUPPORTED_PROVIDERS,
+            demandOption: true,
+        })
+            .example("$0 auth logout anthropic", "Clear all Anthropic credentials");
+    }
+    /**
+     * Build options for status subcommand
+     */
+    static buildStatusOptions(yargs) {
+        return yargs
+            .positional("provider", {
+            type: "string",
+            description: "AI provider to check (optional, shows all if not specified)",
+            choices: SUPPORTED_PROVIDERS,
+        })
+            .example("$0 auth status", "Show status for all configured providers")
+            .example("$0 auth status anthropic", "Show Anthropic authentication status")
+            .example("$0 auth status --format json", "Show status in JSON format");
+    }
+    /**
+     * Build options for refresh subcommand
+     */
+    static buildRefreshOptions(yargs) {
+        return yargs
+            .positional("provider", {
+            type: "string",
+            description: "AI provider to refresh tokens for",
+            choices: SUPPORTED_PROVIDERS,
+            demandOption: true,
+        })
+            .example("$0 auth refresh anthropic", "Refresh Anthropic OAuth tokens");
+    }
+}
+//# sourceMappingURL=authCommandFactory.js.map

package/dist/cli/factories/commandFactory.d.ts

@@ -11,6 +11,12 @@ export declare class CLICommandFactory {
     private static processCliFiles;
     private static processCliVideoFiles;
     private static processOptions;
+    /**
+     * Validate Anthropic subscription options
+     * Ensures subscription tier is provided when using anthropic-subscription provider
+     * or when oauth auth method is selected
+     */
+    private static validateAnthropicSubscriptionOptions;
     private static handleOutput;
     /**
      * Helper method to handle TTS audio file output

package/dist/cli/factories/commandFactory.js

@@ -40,6 +40,7 @@ export class CLICommandFactory {
                 "vertex",
                 "googleVertex",
                 "anthropic",
+                "anthropic-subscription", // Anthropic with subscription tier support
                 "azure",
                 "google-ai",
                 "google-ai-studio",
@@ -50,9 +51,27 @@ export class CLICommandFactory {
                 "sagemaker",
             ],
             default: "auto",
-            description: "AI provider to use (auto-selects best available)",
+            description: "AI provider to use (auto-selects best available). Use 'anthropic-subscription' for Claude subscription plans.",
             alias: "p",
         },
+        // Anthropic subscription options
+        authMethod: {
+            type: "string",
+            choices: ["api-key", "oauth"],
+            default: "api-key",
+            description: "Authentication method for Anthropic: 'api-key' (default) or 'oauth' (for subscription plans)",
+        },
+        subscriptionTier: {
+            type: "string",
+            choices: ["free", "pro", "max", "max_5", "max_20", "api"],
+            description: "Anthropic subscription tier: free (limited), pro ($20/mo), max (highest limits), max_5/max_20 (extended), api (pay-per-use)",
+        },
+        enableBeta: {
+            type: "boolean",
+            default: false,
+            description: "Enable Anthropic beta features (experimental capabilities, computer use, etc.)",
+            alias: "beta",
+        },
         image: {
             type: "string",
             description: "Add image file for multimodal analysis (can be used multiple times)",
@@ -515,8 +534,58 @@ export class CLICommandFactory {
             thinkingLevel: argv.thinkingLevel,
             // Region option for cloud providers (Vertex AI, Bedrock, etc.)
             region: argv.region,
+            // Anthropic subscription options
+            authMethod: argv.authMethod,
+            subscriptionTier: argv.subscriptionTier,
+            enableBeta: argv.enableBeta,
         };
     }
+    /**
+     * Validate Anthropic subscription options
+     * Ensures subscription tier is provided when using anthropic-subscription provider
+     * or when oauth auth method is selected
+     */
+    static validateAnthropicSubscriptionOptions(options) {
+        const provider = options.provider;
+        const authMethod = options.authMethod;
+        let subscriptionTier = options.subscriptionTier;
+        const enableBeta = options.enableBeta;
+        // Check if using anthropic-subscription provider or oauth auth method
+        const isSubscriptionMode = provider === "anthropic-subscription" || authMethod === "oauth";
+        if (isSubscriptionMode && !subscriptionTier) {
+            logger.always(chalk.yellow("⚠️  Subscription tier not specified. Defaulting to 'api' tier."));
+            logger.always(chalk.gray("   Use --subscription-tier to specify: free, pro, max, or api"));
+            options.subscriptionTier = "api";
+            subscriptionTier = "api";
+        }
+        // Validate oauth is required for non-api subscription tiers
+        if (subscriptionTier &&
+            ["free", "pro", "max"].includes(subscriptionTier) &&
+            authMethod !== "oauth") {
+            logger.always(chalk.yellow(`⚠️  Subscription tier '${subscriptionTier}' typically uses OAuth authentication.`));
+            logger.always(chalk.gray("   Consider using --auth-method oauth for this tier."));
+        }
+        // Map anthropic-subscription to anthropic provider with subscription options
+        if (provider === "anthropic-subscription") {
+            options.provider = "anthropic";
+            options.useSubscription = true;
+        }
+        // Warn about beta features when enabled
+        if (enableBeta) {
+            logger.always(chalk.cyan("🧪 Beta features enabled for Anthropic. Experimental capabilities may be unstable."));
+        }
+        // Build Anthropic auth configuration for provider initialization
+        if (provider === "anthropic" || provider === "anthropic-subscription") {
+            const authConfig = {
+                method: (authMethod === "oauth"
+                    ? "oauth"
+                    : "api_key"),
+                subscriptionTier: subscriptionTier,
+            };
+            options.anthropicAuthConfig = authConfig;
+            options.enableBeta = enableBeta;
+        }
+    }
     // Helper method to handle output
     static handleOutput(result, options) {
         let output;
@@ -853,7 +922,9 @@ export class CLICommandFactory {
                     .example('$0 generate "Mountain landscape" --model gemini-2.5-flash-image --imageOutput ./my-images/mountain.png', "Generate image with custom path")
                     .example('$0 generate "Describe this video" --video path/to/video.mp4', "Analyze video content")
                     .example('$0 generate "Product showcase video" --image ./product.jpg --outputMode video --videoOutput ./output.mp4', "Generate video from image")
-                    .example('$0 generate "Smooth camera movement" --image ./input.jpg --provider vertex --model veo-3.1-generate-001 --outputMode video --videoResolution 720p --videoLength 6 --videoAspectRatio 16:9 --videoOutput ./output.mp4', "Video generation with full options"));
+                    .example('$0 generate "Smooth camera movement" --image ./input.jpg --provider vertex --model veo-3.1-generate-001 --outputMode video --videoResolution 720p --videoLength 6 --videoAspectRatio 16:9 --videoOutput ./output.mp4', "Video generation with full options")
+                    .example('$0 generate "Explain AI" --provider anthropic --subscription-tier pro', "Use Anthropic with Pro subscription tier")
+                    .example('$0 generate "Deep analysis" --provider anthropic-subscription --subscription-tier max --auth-method oauth', "Use Anthropic with Max subscription and OAuth"));
             },
             handler: async (argv) => await CLICommandFactory.executeGenerate(argv),
         };
@@ -1076,6 +1147,7 @@ export class CLICommandFactory {
                         "openai",
                         "openrouter",
                         "anthropic",
+                        "anthropic-subscription", // Setup Anthropic with subscription tier
                         "azure",
                         "bedrock",
                         "vertex",
@@ -1091,9 +1163,21 @@ export class CLICommandFactory {
                     .option("status", {
                     type: "boolean",
                     description: "Show provider configuration status",
+                })
+                    .option("subscription-tier", {
+                    type: "string",
+                    choices: ["free", "pro", "max", "max_5", "max_20", "api"],
+                    description: "Anthropic subscription tier for setup (free, pro, max, max_5, max_20, api)",
+                })
+                    .option("auth-method", {
+                    type: "string",
+                    choices: ["api-key", "oauth"],
+                    description: "Authentication method for Anthropic (api-key or oauth)",
                 })
                     .example("$0 setup", "Interactive setup wizard")
                     .example("$0 setup --provider openai", "Setup specific provider")
+                    .example("$0 setup --provider anthropic --subscription-tier pro", "Setup Anthropic with Pro subscription")
+                    .example("$0 setup --provider anthropic --auth-method oauth", "Setup Anthropic with OAuth authentication")
                     .example("$0 setup --list", "List all providers")
                     .example("$0 setup --status", "Check provider status"));
             },
@@ -1391,6 +1475,8 @@ export class CLICommandFactory {
             throw new Error('Input required. Use: neurolink generate "your prompt" or echo "prompt" | neurolink generate');
         }
         const options = CLICommandFactory.processOptions(argv);
+        // Validate Anthropic subscription options if using Anthropic provider
+        this.validateAnthropicSubscriptionOptions(options);
         // Determine if video generation mode is enabled
         const isVideoMode = options.outputMode === "video";
         const spinnerMessage = isVideoMode
@@ -1995,6 +2081,8 @@ export class CLICommandFactory {
     static async executeStream(argv) {
         await CLICommandFactory.handleStdinInput(argv);
         const options = CLICommandFactory.processOptions(argv);
+        // Validate Anthropic subscription options if using Anthropic provider
+        this.validateAnthropicSubscriptionOptions(options);
         if (!options.quiet) {
             logger.always(chalk.blue("🔄 Streaming..."));
         }
@@ -2025,6 +2113,8 @@ export class CLICommandFactory {
      */
     static async executeBatch(argv) {
         const options = CLICommandFactory.processOptions(argv);
+        // Validate Anthropic subscription options if using Anthropic provider
+        CLICommandFactory.validateAnthropicSubscriptionOptions(options);
         const spinner = options.quiet ? null : ora().start();
         try {
             if (!argv.file) {

package/dist/cli/parser.js

@@ -11,6 +11,7 @@ import { ServerCommandFactory } from "./commands/server.js";
 import { ServeCommandFactory } from "./commands/serve.js";
 import { ragCommand } from "./commands/rag.js";
 import { DocsCommandFactory } from "./commands/docs.js";
+import { AuthCommandFactory } from "./factories/authCommandFactory.js";
 // Enhanced CLI with Professional UX
 export function initializeCliParser() {
     return (yargs(hideBin(process.argv))
@@ -24,7 +25,13 @@ export function initializeCliParser() {
         .strictCommands()
         .demandCommand(1, "")
         .recommendCommands()
-        .epilogue("For more info: https://github.com/juspay/neurolink")
+        .epilogue("For more info: https://github.com/juspay/neurolink\n\n" +
+        "Anthropic Subscription Tiers:\n" +
+        "  free  - Limited free tier access\n" +
+        "  pro   - Professional tier ($20/mo)\n" +
+        "  max   - Maximum tier with highest limits\n" +
+        "  api   - Direct API access (pay-per-use)\n\n" +
+        "Use 'neurolink auth login anthropic' to configure authentication")
         .showHelpOnFail(true, "Specify --help for available options")
         .middleware((argv) => {
         // Handle no-color option globally
@@ -169,6 +176,8 @@ export function initializeCliParser() {
         // RAG Document Processing Commands
         .command(ragCommand)
         // Docs MCP Server Command
-        .command(DocsCommandFactory.createDocsCommand())); // Close the main return statement
+        .command(DocsCommandFactory.createDocsCommand())
+        // Auth Commands - Using AuthCommandFactory
+        .command(AuthCommandFactory.createAuthCommands())); // Close the main return statement
 }
 //# sourceMappingURL=parser.js.map

package/dist/constants/enums.d.ts

@@ -486,3 +486,23 @@ export declare enum ErrorSeverity {
     HIGH = "high",
     CRITICAL = "critical"
 }
+/**
+ * Beta features available for Anthropic API
+ *
+ * @description Beta feature flags that can be enabled for enhanced functionality:
+ * - CLAUDE_CODE: Claude Code beta features for development workflows
+ * - INTERLEAVED_THINKING: Enables interleaved thinking in responses
+ * - FINE_GRAINED_STREAMING: Fine-grained tool streaming for better UX
+ */
+export declare enum AnthropicBetaFeature {
+    CLAUDE_CODE = "claude-code-20250219",
+    INTERLEAVED_THINKING = "interleaved-thinking-2025-05-14",
+    FINE_GRAINED_STREAMING = "fine-grained-tool-streaming-2025-05-14"
+}
+/**
+ * Buffer time in milliseconds before token expiry to trigger refresh
+ *
+ * @description Tokens are refreshed 5 minutes before expiry to prevent
+ * authentication failures during ongoing operations
+ */
+export declare const TOKEN_EXPIRY_BUFFER_MS: number;

package/dist/constants/enums.js

@@ -656,3 +656,33 @@ export var ErrorSeverity;
     ErrorSeverity["HIGH"] = "high";
     ErrorSeverity["CRITICAL"] = "critical";
 })(ErrorSeverity || (ErrorSeverity = {}));
+// ============================================================================
+// CLAUDE SUBSCRIPTION ENUMS
+// ============================================================================
+// Note: ClaudeSubscriptionTier and AnthropicAuthMethod are defined as type
+// aliases in types/subscriptionTypes.ts (canonical definitions).
+// The type aliases support all 6 tier values: free, pro, max, max_5, max_20, api.
+/**
+ * Beta features available for Anthropic API
+ *
+ * @description Beta feature flags that can be enabled for enhanced functionality:
+ * - CLAUDE_CODE: Claude Code beta features for development workflows
+ * - INTERLEAVED_THINKING: Enables interleaved thinking in responses
+ * - FINE_GRAINED_STREAMING: Fine-grained tool streaming for better UX
+ */
+export var AnthropicBetaFeature;
+(function (AnthropicBetaFeature) {
+    AnthropicBetaFeature["CLAUDE_CODE"] = "claude-code-20250219";
+    AnthropicBetaFeature["INTERLEAVED_THINKING"] = "interleaved-thinking-2025-05-14";
+    AnthropicBetaFeature["FINE_GRAINED_STREAMING"] = "fine-grained-tool-streaming-2025-05-14";
+})(AnthropicBetaFeature || (AnthropicBetaFeature = {}));
+// ============================================================================
+// ANTHROPIC OAUTH CONSTANTS
+// ============================================================================
+/**
+ * Buffer time in milliseconds before token expiry to trigger refresh
+ *
+ * @description Tokens are refreshed 5 minutes before expiry to prevent
+ * authentication failures during ongoing operations
+ */
+export const TOKEN_EXPIRY_BUFFER_MS = 5 * 60 * 1000; // 5 minutes

package/dist/constants/index.d.ts

@@ -187,6 +187,8 @@ export declare const CONSTANTS_METADATA: {
     readonly VERSION: "1.0.0";
     readonly LAST_UPDATED: "2025-01-27";
     readonly TOTAL_CONSTANTS: 300;
-    readonly CATEGORIES: readonly ["timeouts", "retry", "performance", "tokens"];
+    readonly CATEGORIES: readonly ["timeouts", "retry", "performance", "tokens", "enums"];
     readonly COMPATIBILITY: "backward_compatible";
 };
+export { AIProviderName, OpenRouterModels, BedrockModels, OpenAIModels, AzureOpenAIModels, VertexModels, GoogleAIModels, AnthropicModels, MistralModels, OllamaModels, LiteLLMModels, HuggingFaceModels, SageMakerModels, APIVersions, ErrorCategory, ErrorSeverity, AnthropicBetaFeature, TOKEN_EXPIRY_BUFFER_MS, } from "./enums.js";
+export type { ClaudeSubscriptionTier, AnthropicAuthMethod, } from "../types/subscriptionTypes.js";

package/dist/constants/index.js

@@ -190,6 +190,16 @@ export const CONSTANTS_METADATA = {
     VERSION: "1.0.0",
     LAST_UPDATED: "2025-01-27",
     TOTAL_CONSTANTS: 300,
-    CATEGORIES: ["timeouts", "retry", "performance", "tokens"],
+    CATEGORIES: ["timeouts", "retry", "performance", "tokens", "enums"],
     COMPATIBILITY: "backward_compatible",
 };
+// ===== ENUMS =====
+export { 
+// Provider and Model Enums
+AIProviderName, OpenRouterModels, BedrockModels, OpenAIModels, AzureOpenAIModels, VertexModels, GoogleAIModels, AnthropicModels, MistralModels, OllamaModels, LiteLLMModels, HuggingFaceModels, SageMakerModels, APIVersions, 
+// Error Enums
+ErrorCategory, ErrorSeverity, 
+// Claude Subscription Enums
+AnthropicBetaFeature, 
+// OAuth Constants
+TOKEN_EXPIRY_BUFFER_MS, } from "./enums.js";

package/dist/index.d.ts

@@ -192,7 +192,7 @@ export declare function createBestAIProvider(requestedProvider?: string, modelNa
  * ```
  */
 export { CircuitBreakerManager, calculateExpiresAt, createMCPServer, createOAuthProviderFromConfig, DEFAULT_HTTP_RETRY_CONFIG, DEFAULT_RATE_LIMIT_CONFIG, executeMCP, FileTokenStorage, getMCPStats, getServerInfo, globalCircuitBreakerManager, globalRateLimiterManager, HTTPRateLimiter, InMemoryTokenStorage, initializeMCPEcosystem, isRetryableHTTPError, isRetryableStatusCode, isTokenExpired, listMCPs, MCPCircuitBreaker, mcpLogger, NeuroLinkOAuthProvider, RateLimiterManager, validateServerTools, validateTool as validateMCPTool, withHTTPRetry, } from "./mcp/index.js";
-export type { AuthorizationUrlResult, DiscoveredMcp, HTTPRetryConfig, MCPOAuthConfig, McpMetadata, OAuthClientInformation, OAuthTokens, RateLimitConfig, TokenExchangeRequest, TokenStorage, } from "./types/mcpTypes.js";
+export type { AuthorizationUrlResult, DiscoveredMcp, HTTPRetryConfig, MCPOAuthConfig, McpMetadata, OAuthClientInformation, OAuthTokens as McpOAuthTokens, RateLimitConfig, TokenExchangeRequest, TokenStorage, } from "./types/mcpTypes.js";
 export type { ExecutionContext, ToolExecutionResult, ToolInfo, } from "./types/tools.js";
 export type { LogLevel } from "./types/utilities.js";
 export { logger } from "./utils/logger.js";