@juspay/neurolink 9.33.0 → 9.35.0

package/dist/proxy/quietDetector.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Proxy Quiet Detector
+ * Determines whether the proxy has been idle (no traffic) for a given
+ * threshold by efficiently reading only the tail of today's debug log file.
+ * Used by the auto-update system to find safe windows for restarts.
+ */
+/** Result of a traffic-quiet check. */
+export interface QuietStatus {
+    isQuiet: boolean;
+    lastActivityAt: Date | null;
+    silenceDurationMs: number;
+}
+/**
+ * Check whether proxy traffic has been quiet (no requests) for at least
+ * `quietThresholdMs` milliseconds.
+ *
+ * Reads only the tail of today's debug log file for efficiency.
+ *
+ * @param quietThresholdMs  Silence duration (ms) to consider "quiet". Default: 120 000 (2 min).
+ * @returns QuietStatus with the idle analysis.
+ */
+export declare function checkTrafficQuiet(quietThresholdMs?: number): QuietStatus;

package/dist/proxy/quietDetector.js

@@ -0,0 +1,111 @@
+/**
+ * Proxy Quiet Detector
+ * Determines whether the proxy has been idle (no traffic) for a given
+ * threshold by efficiently reading only the tail of today's debug log file.
+ * Used by the auto-update system to find safe windows for restarts.
+ */
+import { openSync, readSync, closeSync, fstatSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+/** Default quiet threshold: 2 minutes of no traffic. */
+const DEFAULT_QUIET_THRESHOLD_MS = 120_000;
+/** Maximum bytes to read from the tail of the log file. */
+const TAIL_READ_SIZE = 4096;
+/**
+ * Build the path to today's proxy debug log file.
+ * Format: ~/.neurolink/logs/proxy-debug-YYYY-MM-DD.jsonl
+ */
+function getTodayLogPath() {
+    const today = new Date().toISOString().split("T")[0];
+    return join(homedir(), ".neurolink", "logs", `proxy-debug-${today}.jsonl`);
+}
+/**
+ * Read the last complete line(s) from a file efficiently.
+ * Uses low-level fs to seek to end and read only the last TAIL_READ_SIZE bytes.
+ * Returns an array of the last non-empty lines (up to 2 for fallback).
+ */
+function readTailLines(filePath) {
+    let fd = null;
+    try {
+        fd = openSync(filePath, "r");
+        const stat = fstatSync(fd);
+        if (stat.size === 0) {
+            return [];
+        }
+        const readSize = Math.min(TAIL_READ_SIZE, stat.size);
+        const offset = stat.size - readSize;
+        const buffer = Buffer.alloc(readSize);
+        readSync(fd, buffer, 0, readSize, offset);
+        const chunk = buffer.toString("utf-8");
+        // Split into lines, filter out empty trailing entries
+        const lines = chunk.split("\n").filter((line) => line.trim().length > 0);
+        // Return last 2 lines (last + fallback)
+        return lines.slice(-2);
+    }
+    finally {
+        if (fd !== null) {
+            closeSync(fd);
+        }
+    }
+}
+/**
+ * Try to parse a JSON line and extract its ISO timestamp.
+ * Returns the timestamp as epoch ms, or null if parsing fails.
+ */
+function extractTimestamp(line) {
+    try {
+        const parsed = JSON.parse(line);
+        if (typeof parsed.timestamp === "string") {
+            const ms = Date.parse(parsed.timestamp);
+            if (!Number.isNaN(ms)) {
+                return ms;
+            }
+        }
+    }
+    catch {
+        // Malformed JSON — caller will handle fallback
+    }
+    return null;
+}
+/**
+ * Check whether proxy traffic has been quiet (no requests) for at least
+ * `quietThresholdMs` milliseconds.
+ *
+ * Reads only the tail of today's debug log file for efficiency.
+ *
+ * @param quietThresholdMs  Silence duration (ms) to consider "quiet". Default: 120 000 (2 min).
+ * @returns QuietStatus with the idle analysis.
+ */
+export function checkTrafficQuiet(quietThresholdMs = DEFAULT_QUIET_THRESHOLD_MS) {
+    const noActivityResult = {
+        isQuiet: true,
+        lastActivityAt: null,
+        silenceDurationMs: Infinity,
+    };
+    const logPath = getTodayLogPath();
+    if (!existsSync(logPath)) {
+        return noActivityResult;
+    }
+    const tailLines = readTailLines(logPath);
+    if (tailLines.length === 0) {
+        return noActivityResult;
+    }
+    // Try last line first, then fall back to the one before it
+    let timestampMs = null;
+    for (let i = tailLines.length - 1; i >= 0; i--) {
+        timestampMs = extractTimestamp(tailLines[i]);
+        if (timestampMs !== null) {
+            break;
+        }
+    }
+    if (timestampMs === null) {
+        // All tail lines are malformed — treat as quiet
+        return noActivityResult;
+    }
+    const silenceDurationMs = Date.now() - timestampMs;
+    return {
+        isQuiet: silenceDurationMs >= quietThresholdMs,
+        lastActivityAt: new Date(timestampMs),
+        silenceDurationMs,
+    };
+}

package/dist/proxy/updateChecker.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Proxy auto-update version checker.
+ *
+ * Queries the npm registry for the latest published version of
+ * `@juspay/neurolink` and compares it against the currently running version.
+ * Designed to be non-blocking and failure-tolerant — any error (network,
+ * timeout, parse) silently returns `updateAvailable: false`.
+ */
+export interface UpdateCheckResult {
+    currentVersion: string;
+    latestVersion: string;
+    updateAvailable: boolean;
+}
+/**
+ * Query npm for the latest version of `@juspay/neurolink` and compare it
+ * against {@link currentVersion}.
+ *
+ * On **any** failure the function resolves (never rejects) with
+ * `{ updateAvailable: false, latestVersion: currentVersion }`.
+ */
+export declare function checkForUpdate(currentVersion: string): Promise<UpdateCheckResult>;

package/dist/proxy/updateChecker.js

@@ -0,0 +1,97 @@
+/**
+ * Proxy auto-update version checker.
+ *
+ * Queries the npm registry for the latest published version of
+ * `@juspay/neurolink` and compares it against the currently running version.
+ * Designed to be non-blocking and failure-tolerant — any error (network,
+ * timeout, parse) silently returns `updateAvailable: false`.
+ */
+import { execFile as execFileCb } from "node:child_process";
+import { promisify } from "node:util";
+import { logger } from "../utils/logger.js";
+const execFile = promisify(execFileCb);
+/** Timeout (ms) for the `npm view` child process. */
+const NPM_VIEW_TIMEOUT_MS = 10_000;
+/**
+ * Parse a version string of the form `major.minor.patch` into numeric
+ * components. Returns `null` when the string does not match.
+ */
+function parseSemVer(version) {
+    const match = /^(\d+)\.(\d+)\.(\d+)$/.exec(version.trim());
+    if (!match) {
+        return null;
+    }
+    return {
+        major: Number(match[1]),
+        minor: Number(match[2]),
+        patch: Number(match[3]),
+    };
+}
+/**
+ * Returns `true` when `latest` is strictly greater than `current`.
+ *
+ * Both arguments must be valid semver strings; returns `false` on any
+ * parse failure so the caller never sees a spurious "update available".
+ */
+function isNewerVersion(current, latest) {
+    const cur = parseSemVer(current);
+    const lat = parseSemVer(latest);
+    if (!cur || !lat) {
+        return false;
+    }
+    if (lat.major !== cur.major) {
+        return lat.major > cur.major;
+    }
+    if (lat.minor !== cur.minor) {
+        return lat.minor > cur.minor;
+    }
+    return lat.patch > cur.patch;
+}
+// ---------------------------------------------------------------------------
+// Core check
+// ---------------------------------------------------------------------------
+/**
+ * Query npm for the latest version of `@juspay/neurolink` and compare it
+ * against {@link currentVersion}.
+ *
+ * On **any** failure the function resolves (never rejects) with
+ * `{ updateAvailable: false, latestVersion: currentVersion }`.
+ */
+export async function checkForUpdate(currentVersion) {
+    const fail = {
+        currentVersion,
+        latestVersion: currentVersion,
+        updateAvailable: false,
+    };
+    try {
+        logger.debug("[UpdateChecker] Checking for updates", { currentVersion });
+        const { stdout } = await execFile("npm", ["view", "@juspay/neurolink", "version", "--json"], { timeout: NPM_VIEW_TIMEOUT_MS });
+        // `npm view ... --json` wraps the value in double-quotes, e.g. `"9.32.0"`
+        const parsed = JSON.parse(stdout);
+        if (typeof parsed !== "string") {
+            logger.warn("[UpdateChecker] Unexpected npm output type", {
+                type: typeof parsed,
+            });
+            return fail;
+        }
+        const latestVersion = parsed.trim();
+        if (!parseSemVer(latestVersion)) {
+            logger.warn("[UpdateChecker] Failed to parse latest version", {
+                latestVersion,
+            });
+            return fail;
+        }
+        const updateAvailable = isNewerVersion(currentVersion, latestVersion);
+        logger.debug("[UpdateChecker] Version check complete", {
+            currentVersion,
+            latestVersion,
+            updateAvailable,
+        });
+        return { currentVersion, latestVersion, updateAvailable };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.warn("[UpdateChecker] Update check failed", { error: message });
+        return fail;
+    }
+}

package/dist/proxy/updateState.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Update State Persistence
+ * Manages persistent state for the proxy auto-update feature.
+ * Tracks check timestamps, suppressed versions, and update history.
+ *
+ * State file location: ~/.neurolink/update-state.json
+ * Suppressed versions expire after 24 hours.
+ */
+export interface SuppressedVersion {
+    suppressedAt: string;
+    reason: string;
+}
+export interface UpdateState {
+    lastCheckAt: string;
+    lastCheckVersion: string;
+    suppressedVersions: Record<string, SuppressedVersion>;
+    lastUpdateAt: string | null;
+    lastUpdateVersion: string | null;
+}
+/**
+ * Return an empty/initial UpdateState.
+ */
+export declare function getDefaultUpdateState(): UpdateState;
+/**
+ * Load the update state from disk.
+ * Returns null if the file does not exist.
+ * Returns the default state if the file contains corrupt JSON.
+ *
+ * @param stateFilePath - Override path for testing (default: ~/.neurolink/update-state.json)
+ */
+export declare function loadUpdateState(stateFilePath?: string): UpdateState | null;
+/**
+ * Save the update state to disk.
+ *
+ * @param state - The UpdateState to persist
+ * @param stateFilePath - Override path for testing (default: ~/.neurolink/update-state.json)
+ */
+export declare function saveUpdateState(state: UpdateState, stateFilePath?: string): void;
+/**
+ * Check whether a version is currently suppressed (i.e., suppressed AND within the 24-hour window).
+ *
+ * @param version - Semver version string to check
+ * @param stateFilePath - Override path for testing
+ */
+export declare function isVersionSuppressed(version: string, stateFilePath?: string): boolean;
+/**
+ * Add a version to the suppressed list and persist.
+ *
+ * @param version - Semver version string to suppress
+ * @param reason - Human-readable reason for suppression
+ * @param stateFilePath - Override path for testing
+ */
+export declare function suppressVersion(version: string, reason: string, stateFilePath?: string): void;
+/**
+ * Record a successful update: set lastUpdateAt and lastUpdateVersion, then persist.
+ *
+ * @param version - The version that was successfully installed
+ * @param stateFilePath - Override path for testing
+ */
+export declare function recordSuccessfulUpdate(version: string, stateFilePath?: string): void;
+/**
+ * Record an update check: set lastCheckAt and lastCheckVersion, then persist.
+ *
+ * @param latestVersion - The latest version found during the check
+ * @param stateFilePath - Override path for testing
+ */
+export declare function recordCheck(latestVersion: string, stateFilePath?: string): void;

package/dist/proxy/updateState.js

@@ -0,0 +1,152 @@
+/**
+ * Update State Persistence
+ * Manages persistent state for the proxy auto-update feature.
+ * Tracks check timestamps, suppressed versions, and update history.
+ *
+ * State file location: ~/.neurolink/update-state.json
+ * Suppressed versions expire after 24 hours.
+ */
+import fs from "fs";
+import os from "os";
+import path from "path";
+// ============================================
+// Constants
+// ============================================
+const STATE_FILENAME = "update-state.json";
+const SUPPRESSION_TTL_MS = 86_400_000; // 24 hours
+// ============================================
+// Internal Helpers
+// ============================================
+/**
+ * Resolve the path to the update state file.
+ * Accepts an override for testing; defaults to ~/.neurolink/update-state.json.
+ */
+function resolveStatePath(overridePath) {
+    if (overridePath) {
+        return overridePath;
+    }
+    return path.join(os.homedir(), ".neurolink", STATE_FILENAME);
+}
+/**
+ * Ensure the parent directory of the given file path exists.
+ */
+function ensureParentDir(filePath) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+// ============================================
+// Exported Functions
+// ============================================
+/**
+ * Return an empty/initial UpdateState.
+ */
+export function getDefaultUpdateState() {
+    return {
+        lastCheckAt: new Date(0).toISOString(),
+        lastCheckVersion: "",
+        suppressedVersions: {},
+        lastUpdateAt: null,
+        lastUpdateVersion: null,
+    };
+}
+/**
+ * Load the update state from disk.
+ * Returns null if the file does not exist.
+ * Returns the default state if the file contains corrupt JSON.
+ *
+ * @param stateFilePath - Override path for testing (default: ~/.neurolink/update-state.json)
+ */
+export function loadUpdateState(stateFilePath) {
+    const filePath = resolveStatePath(stateFilePath);
+    try {
+        if (!fs.existsSync(filePath)) {
+            return null;
+        }
+        const content = fs.readFileSync(filePath, "utf8");
+        const parsed = JSON.parse(content);
+        // Minimal shape check — reject valid JSON that isn't an UpdateState
+        if (typeof parsed !== "object" ||
+            parsed === null ||
+            typeof parsed.suppressedVersions !== "object" ||
+            typeof parsed.lastCheckAt !== "string") {
+            return getDefaultUpdateState();
+        }
+        return parsed;
+    }
+    catch {
+        // Corrupt or unreadable JSON — return default state
+        return getDefaultUpdateState();
+    }
+}
+/**
+ * Save the update state to disk.
+ *
+ * @param state - The UpdateState to persist
+ * @param stateFilePath - Override path for testing (default: ~/.neurolink/update-state.json)
+ */
+export function saveUpdateState(state, stateFilePath) {
+    const filePath = resolveStatePath(stateFilePath);
+    ensureParentDir(filePath);
+    // Atomic write: write to temp file then rename to prevent corruption on crash
+    const tmpPath = filePath + ".tmp";
+    fs.writeFileSync(tmpPath, JSON.stringify(state, null, 2));
+    fs.renameSync(tmpPath, filePath);
+}
+/**
+ * Check whether a version is currently suppressed (i.e., suppressed AND within the 24-hour window).
+ *
+ * @param version - Semver version string to check
+ * @param stateFilePath - Override path for testing
+ */
+export function isVersionSuppressed(version, stateFilePath) {
+    const state = loadUpdateState(stateFilePath);
+    if (!state) {
+        return false;
+    }
+    const entry = state.suppressedVersions[version];
+    if (!entry) {
+        return false;
+    }
+    return Date.now() - Date.parse(entry.suppressedAt) < SUPPRESSION_TTL_MS;
+}
+/**
+ * Add a version to the suppressed list and persist.
+ *
+ * @param version - Semver version string to suppress
+ * @param reason - Human-readable reason for suppression
+ * @param stateFilePath - Override path for testing
+ */
+export function suppressVersion(version, reason, stateFilePath) {
+    const state = loadUpdateState(stateFilePath) ?? getDefaultUpdateState();
+    state.suppressedVersions[version] = {
+        suppressedAt: new Date().toISOString(),
+        reason,
+    };
+    saveUpdateState(state, stateFilePath);
+}
+/**
+ * Record a successful update: set lastUpdateAt and lastUpdateVersion, then persist.
+ *
+ * @param version - The version that was successfully installed
+ * @param stateFilePath - Override path for testing
+ */
+export function recordSuccessfulUpdate(version, stateFilePath) {
+    const state = loadUpdateState(stateFilePath) ?? getDefaultUpdateState();
+    state.lastUpdateAt = new Date().toISOString();
+    state.lastUpdateVersion = version;
+    saveUpdateState(state, stateFilePath);
+}
+/**
+ * Record an update check: set lastCheckAt and lastCheckVersion, then persist.
+ *
+ * @param latestVersion - The latest version found during the check
+ * @param stateFilePath - Override path for testing
+ */
+export function recordCheck(latestVersion, stateFilePath) {
+    const state = loadUpdateState(stateFilePath) ?? getDefaultUpdateState();
+    state.lastCheckAt = new Date().toISOString();
+    state.lastCheckVersion = latestVersion;
+    saveUpdateState(state, stateFilePath);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "9.33.0",
+  "version": "9.35.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",
@@ -28,13 +28,15 @@
   "scripts": {
     "dev": "vite dev",
     "build": "vite build && pnpm run prepack",
+    "build:browser": "node scripts/build-browser.mjs",
+    "build:browser:dev": "node scripts/build-browser.mjs --dev",
     "build:cli": "echo 'Building CLI...' && svelte-kit sync && tsc --project tsconfig.cli.json",
     "build:action": "ncc build src/action/index.ts -o action-dist --source-map",
     "build:cli:link": "pnpm run build:cli && pnpm link --global",
     "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'",
-    "prepack": "svelte-kit sync && svelte-package && pnpm run build:react-hooks && pnpm run build:cli && publint",
+    "prepack": "svelte-kit sync && svelte-package && pnpm run build:react-hooks && pnpm run build:cli && pnpm run build:browser && publint",
     "build:react-hooks": "npx tsc --jsx react-jsx --module nodenext --moduleResolution nodenext --target esnext --esModuleInterop --skipLibCheck --outDir dist --declaration false src/lib/client/reactHooks.tsx",
     "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json && tsc --noEmit --strict",
     "check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
@@ -172,6 +174,11 @@
       "types": "./dist/server/index.d.ts",
       "import": "./dist/server/index.js",
       "default": "./dist/server/index.js"
+    },
+    "./browser": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/browser/neurolink.min.js",
+      "default": "./dist/browser/neurolink.min.js"
     }
   },
   "dependencies": {
@@ -309,6 +316,7 @@
     "@vitest/coverage-v8": "^4.1.0",
     "concurrently": "^9.2.1",
     "conventional-changelog-conventionalcommits": "^9.1.0",
+    "esbuild": "^0.27.4",
     "eslint": "^10.0.2",
     "husky": "^9.1.7",
     "lint-staged": "^16.3.0",