@juspay/neurolink 8.32.0 → 8.34.0

package/dist/types/actionTypes.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Type definitions for NeuroLink GitHub Action
+ * @module actionTypes
+ */
+import type { AIProviderName } from "../constants/enums.js";
+/**
+ * Provider API key configuration (verified providers only)
+ */
+export type ActionProviderKeys = {
+    openaiApiKey?: string;
+    anthropicApiKey?: string;
+    googleAiApiKey?: string;
+    azureOpenaiApiKey?: string;
+    azureOpenaiEndpoint?: string;
+    azureOpenaiDeployment?: string;
+    mistralApiKey?: string;
+    huggingfaceApiKey?: string;
+    openrouterApiKey?: string;
+    litellmApiKey?: string;
+    litellmBaseUrl?: string;
+    openaiCompatibleApiKey?: string;
+    openaiCompatibleBaseUrl?: string;
+};
+/**
+ * AWS credentials for Bedrock/SageMaker
+ */
+export type ActionAWSConfig = {
+    awsAccessKeyId?: string;
+    awsSecretAccessKey?: string;
+    awsRegion: string;
+    awsSessionToken?: string;
+    bedrockModelId?: string;
+    sagemakerEndpoint?: string;
+};
+/**
+ * Google Cloud configuration for Vertex AI
+ */
+export type ActionGoogleCloudConfig = {
+    googleVertexProject?: string;
+    googleVertexLocation: string;
+    googleApplicationCredentials?: string;
+};
+/**
+ * Extended thinking configuration
+ */
+export type ActionThinkingConfig = {
+    enabled: boolean;
+    level: "minimal" | "low" | "medium" | "high";
+    budget: number;
+};
+/**
+ * Multimodal input paths
+ */
+export type ActionMultimodalInputs = {
+    imagePaths?: string[];
+    pdfPaths?: string[];
+    csvPaths?: string[];
+    videoPaths?: string[];
+};
+/**
+ * Complete action inputs parsed from GitHub Action
+ */
+export type ActionInputs = {
+    prompt: string;
+    provider: AIProviderName | "auto";
+    model?: string;
+    temperature: number;
+    maxTokens: number;
+    systemPrompt?: string;
+    command: "generate" | "stream" | "batch";
+    providerKeys: ActionProviderKeys;
+    awsConfig: ActionAWSConfig;
+    googleCloudConfig: ActionGoogleCloudConfig;
+    multimodal: ActionMultimodalInputs;
+    thinking: ActionThinkingConfig;
+    enableAnalytics: boolean;
+    enableEvaluation: boolean;
+    outputFormat: "text" | "json";
+    outputFile?: string;
+    enableTools: boolean;
+    mcpConfigPath?: string;
+    postComment: boolean;
+    updateExistingComment: boolean;
+    commentTag: string;
+    githubToken?: string;
+    timeout: number;
+    debug: boolean;
+    neurolinkVersion: string;
+    workingDirectory: string;
+};
+/**
+ * Raw CLI token usage format (actual CLI output)
+ */
+export type CliTokenUsage = {
+    input: number;
+    output: number;
+    total: number;
+    cacheCreationTokens?: number;
+    cacheReadTokens?: number;
+};
+/**
+ * Raw CLI analytics format (actual CLI output)
+ */
+export type CliAnalytics = {
+    provider: string;
+    model?: string;
+    tokenUsage: CliTokenUsage;
+    requestDuration: number;
+    timestamp: string;
+    cost?: number;
+};
+/**
+ * Raw CLI evaluation format (actual CLI output, 1-10 scale)
+ */
+export type CliEvaluation = {
+    relevance: number;
+    accuracy: number;
+    completeness: number;
+    overall: number;
+    isOffTopic: boolean;
+    reasoning: string;
+};
+/**
+ * Raw CLI response format (actual output structure)
+ */
+export type CliResponse = {
+    content: string;
+    provider?: string;
+    model?: string;
+    usage?: CliTokenUsage;
+    responseTime?: number;
+    analytics?: CliAnalytics;
+    evaluation?: CliEvaluation;
+};
+/**
+ * Normalized token usage for action output
+ */
+export type ActionTokenUsage = {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+};
+/**
+ * Normalized evaluation for action output
+ */
+export type ActionEvaluation = {
+    overallScore: number;
+    relevance: number;
+    accuracy: number;
+    completeness: number;
+};
+/**
+ * CLI execution result (normalized)
+ */
+export type ActionExecutionResult = {
+    success: boolean;
+    response: string;
+    responseJson?: Record<string, unknown>;
+    provider?: string;
+    model?: string;
+    usage?: ActionTokenUsage;
+    cost?: number;
+    executionTime?: number;
+    evaluation?: ActionEvaluation;
+    error?: string;
+};
+/**
+ * GitHub comment posting result
+ */
+export type ActionCommentResult = {
+    success: boolean;
+    commentId?: number;
+    commentUrl?: string;
+    error?: string;
+};
+/**
+ * Complete action output (snake_case to match action.yml outputs)
+ */
+export type ActionOutput = {
+    response: string;
+    response_json: string;
+    provider?: string;
+    model?: string;
+    tokens_used?: string;
+    prompt_tokens?: string;
+    completion_tokens?: string;
+    cost?: string;
+    execution_time?: string;
+    evaluation_score?: string;
+    comment_id?: string;
+};
+/**
+ * Input validation result
+ */
+export type ActionInputValidation = {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+};
+/**
+ * Provider key validation mapping
+ */
+export type ProviderKeyMapping = {
+    [K in AIProviderName]?: (keyof ActionProviderKeys)[];
+};

package/dist/types/actionTypes.js

@@ -0,0 +1,6 @@
+// src/lib/types/actionTypes.ts
+/**
+ * Type definitions for NeuroLink GitHub Action
+ * @module actionTypes
+ */
+export {};

package/dist/types/index.d.ts

@@ -31,3 +31,4 @@ export * from "./fileTypes.js";
 export * from "./content.js";
 export * from "./ttsTypes.js";
 export * from "./hitlTypes.js";
+export type { ActionInputs, ActionProviderKeys, ActionAWSConfig, ActionGoogleCloudConfig, ActionThinkingConfig, ActionMultimodalInputs, ActionExecutionResult, ActionCommentResult, ActionOutput, ActionTokenUsage, ActionEvaluation, ActionInputValidation, ProviderKeyMapping, CliResponse, CliTokenUsage, CliAnalytics, CliEvaluation, } from "./actionTypes.js";

package/dist/utils/errorHandling.d.ts

@@ -89,6 +89,14 @@ export declare class ErrorFactory {
      * Create a memory exhaustion error
      */
     static memoryExhausted(toolName: string, memoryUsageMB: number): NeuroLinkError;
+    /**
+     * Create a missing configuration error (e.g., missing API key)
+     */
+    static missingConfiguration(configName: string, context?: Record<string, unknown>): NeuroLinkError;
+    /**
+     * Create an invalid configuration error (e.g., NaN for numeric values)
+     */
+    static invalidConfiguration(configName: string, reason: string, context?: Record<string, unknown>): NeuroLinkError;
     /**
      * Create an invalid video resolution error
      */

package/dist/utils/errorHandling.js

@@ -180,6 +180,35 @@ export class ErrorFactory {
         });
     }
     // ============================================================================
+    // CONFIGURATION ERRORS
+    // ============================================================================
+    /**
+     * Create a missing configuration error (e.g., missing API key)
+     */
+    static missingConfiguration(configName, context) {
+        return new NeuroLinkError({
+            code: ERROR_CODES.MISSING_CONFIGURATION,
+            message: `Missing required configuration: ${configName}`,
+            category: ErrorCategory.VALIDATION,
+            severity: ErrorSeverity.HIGH,
+            retriable: false,
+            context: context || {},
+        });
+    }
+    /**
+     * Create an invalid configuration error (e.g., NaN for numeric values)
+     */
+    static invalidConfiguration(configName, reason, context) {
+        return new NeuroLinkError({
+            code: ERROR_CODES.INVALID_CONFIGURATION,
+            message: `Invalid configuration for '${configName}': ${reason}`,
+            category: ErrorCategory.VALIDATION,
+            severity: ErrorSeverity.HIGH,
+            retriable: false,
+            context: context || {},
+        });
+    }
+    // ============================================================================
     // VIDEO VALIDATION ERRORS
     // ============================================================================
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "8.32.0",
+  "version": "8.34.0",
   "description": "Universal AI Development Platform with working MCP integration, multi-provider support, and professional CLI. Built-in tools operational, 58+ external MCP servers discoverable. Connect to filesystem, GitHub, database operations, and more. Build, test, and deploy AI applications with 13 providers: OpenAI, Anthropic, Google AI, AWS Bedrock, Azure, Hugging Face, Ollama, and Mistral AI.",
   "author": {
     "name": "Juspay Technologies",
@@ -29,6 +29,7 @@
     "dev": "vite dev",
     "build": "vite build && pnpm run prepack",
     "build:cli": "echo 'Building CLI...' && svelte-kit sync && tsc --project tsconfig.cli.json && pnpm link --global",
+    "build:action": "ncc build src/action/index.ts -o action-dist --source-map",
     "cli": "node dist/cli/index.js",
     "preview": "vite preview",
     "prepare": "git rev-parse --git-dir > /dev/null 2>&1 && husky install || echo 'Skipping husky in non-git environment'",
@@ -78,8 +79,9 @@
     "content:cleanup": "node tools/converted-scripts/cleanupHashNamedVideos.js",
     "content:all": "pnpm run content:videos",
     "// Documentation Automation": "",
+    "docs:api": "typedoc",
     "docs:sync": "bash scripts/sync-readme.sh",
-    "docs:build": "bash scripts/sync-readme.sh && mkdocs build --strict --clean",
+    "docs:build": "pnpm run docs:api && bash scripts/sync-readme.sh && mkdocs build --strict --clean",
     "docs:serve": "bash scripts/sync-readme.sh && mkdocs serve",
     "docs:gh-deploy": "bash scripts/sync-readme.sh && mkdocs gh-deploy --force",
     "docs:validate": "node tools/content/documentationSync.js --validate",
@@ -186,8 +188,8 @@
     "csv-parser": "^3.2.0",
     "dotenv": "^16.6.1",
     "exceljs": "^4.4.0",
-    "inquirer": "^9.3.7",
     "google-auth-library": "^9.1.0",
+    "inquirer": "^9.3.7",
     "json-schema-to-zod": "^2.6.1",
     "mammoth": "^1.11.0",
     "mathjs": "^14.7.0",
@@ -211,6 +213,9 @@
     "canvas": "^3.2.0"
   },
   "devDependencies": {
+    "@actions/core": "^2.0.2",
+    "@actions/exec": "^2.0.0",
+    "@actions/github": "^7.0.0",
     "@biomejs/biome": "^2.2.4",
     "@changesets/changelog-github": "^0.5.1",
     "@changesets/cli": "^2.29.7",
@@ -237,6 +242,7 @@
     "@types/yargs": "^17.0.33",
     "@typescript-eslint/eslint-plugin": "^8.43.0",
     "@typescript-eslint/parser": "^8.43.0",
+    "@vercel/ncc": "^0.38.4",
     "@vitest/coverage-v8": "^2.1.9",
     "conventional-changelog-conventionalcommits": "^9.1.0",
     "cors": "^2.8.5",
@@ -253,6 +259,8 @@
     "svelte": "^5.0.0",
     "svelte-check": "^4.0.0",
     "tslib": "^2.4.1",
+    "typedoc": "^0.28.15",
+    "typedoc-plugin-markdown": "^4.9.0",
     "typescript": "^5.0.0",
     "vite": "^6.4.1",
     "vitest": "^2.0.0",