Add node server architecture with ports management and webview

Introduces a Node.js server layer for improved chat functionality:
- Add node_server.lua to manage Node runtime and server lifecycle
- Add ports.lua for dynamic port allocation to avoid conflicts
- Reorganize chat binary from chat/ to webview/ directory
- Add plugin/tabnine.lua for early port initialization
- Include bundled node installers and server dependencies
- Remove unused example files and lift imports to module top

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: amirbilu

README.md

@@ -12,9 +12,9 @@ Tabnine client for Neovim
   - [Windows](#windows)
 - [Activate (mandatory)](#activate-mandatory)
 - [Activate Tabnine Pro](#activate-tabnine-pro)
-- [Tabnine Chat](#tabnine-chat)
+- [Tabnine Agent](#tabnine-agent)
 - [Commands](#commands)
-  - [Tabnine Chat commands](#tabnine-chat-commands)
+  - [Tabnine Agent commands](#tabnine-agent-commands)
 - [`<Tab>` and `nvim-cmp`](#tab-and-nvim-cmp)
 - [lualine integration](#lualine-integration)
 - [Other statusline integrations](#other-statusline-integrations)
@@ -168,16 +168,44 @@ end, { expr = true })
 
 Sometimes Tabnine may fail to open the browser on Tabnine Hub, in this case use `:TabnineHubUrl` to get Tabnine Hub URL
 
-## Tabnine Chat
+## Tabnine Agent
 ![Tabnine Neovim chat](https://github.com/codota/tabnine-nvim/blob/master/examples/lua-chat.gif)
-Tabnine chat needs a webview to run, to use it:
-- You will need to build the chat from source, by executing: `cargo build --release` inside `chat/` directory.
-- You may be missing some dependencies to build the chat. To fix this, run the following command:
+
+Tabnine Agent requires a webview component and a Node.js server to run.
+
+### Building the Webview
+
+1. Install the required dependencies:
+```shell
+# Debian/Ubuntu
+sudo apt-get install -y libgtk-3-dev libglib2.0-dev libjavascriptcoregtk-4.1-dev libsoup-3.0-dev libwebkit2gtk-4.1-dev
+
+# Arch
+pacman -S --needed gtk3 glib2 webkit2gtk-4.1 libsoup3
+
+# macOS (dependencies included with system)
+```
+
+2. Build the webview binary (requires Rust stable):
 ```shell
-$ # Debian/Ubuntu
-$ sudo apt-get install -y libgtk-3-dev libglib2.0-dev libjavascriptcoregtk-4.1-dev libsoup-3.0-dev libwebkit2gtk-4.1-dev
-$ # Arch
-$ pacman -S --needed gtk3 glib2 webkit2gtk-4.1 libsoup3
+cd webview/
+cargo build --release
+# Or if using nightly by default:
+rustup run stable cargo build --release
+```
+
+This creates the `tabnine_webview` binary in `webview/target/release/`.
+
+### Project Structure
+
+```
+tabnine-nvim/
+├── node/
+│   ├── installer/     # Node.js runtime installer (per-platform binaries)
+│   └── server/        # Node.js proxy server for chat communication
+├── webview/           # Rust webview binary source (wry-based)
+├── binaries/          # TabNine completion engine (downloaded)
+└── lua/tabnine/       # Neovim plugin Lua code
 ```
 
 ## Commands
@@ -186,19 +214,24 @@ $ pacman -S --needed gtk3 glib2 webkit2gtk-4.1 libsoup3
 - `:TabnineDisable` - to disable Tabnine
 - `:TabnineEnable` - to enable Tabnine
 - `:TabnineToggle` - to toggle enable/disable
-- `:TabnineChat` - to launch Tabnine chat
+- `:TabnineAgent` - to launch Tabnine Agent
 - `:TabnineLoginWithAuthToken` - to log in using auth token (for headless environments, where no browser is available)
 - `:TabnineAccept` - accept apply changes
 - `:TabnineReject` - reject apply changes
 
-### Tabnine Chat commands
-- `:TabnineChat` - to open Tabnine Chat
+### Tabnine Agent commands
+- `:TabnineAgent` - to open Tabnine Agent
+- `:TabnineAgentClose` - to close Tabnine Agent
+- `:TabnineAgentClear` - to clear the current conversation
+- `:TabnineAgentNew` - to start a new conversation
 - `:TabnineFix` - to fix the function in scope
 - `:TabnineTest` - to generate tests for function in scope
 - `:TabnineExplain` - to explain the function in scope
 - `:TabnineAccept` - accept apply changes
 - `:TabnineReject` - reject apply changes
 
+> **Note:** The old `TabnineChat*` commands are deprecated and will show a warning. Please use the new `TabnineAgent*` commands instead.
+
 ## `<Tab>` and `nvim-cmp`
 
 `nvim-cmp` maps `<Tab>` to navigating through pop menu items (see [here](https://github.com/hrsh7th/nvim-cmp/blob/777450fd0ae289463a14481673e26246b5e38bf2/lua/cmp/config/mapping.lua#L86)) This conflicts with Tabnine `<Tab>` for inline completion. To get this sorted you can either:

chat/index.html

@@ -3,6 +3,8 @@
 # This script downloads the binaries for the most recent version of TabNine.
 
 $TABNINE_UPDATE_SERVICE="https://update.tabnine.com"
+$NODE_VERSION="v24.12.0"
+
 if ($args.count -gt 0) {
     $TABNINE_UPDATE_SERVICE=$args[0]
 }
@@ -14,15 +16,24 @@ else {
     $version = invoke-webrequest -uri "$TABNINE_UPDATE_SERVICE/bundles/version" -usebasicparsing
 }
 
+# Get script directory
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+
 if ([Environment]::Is64BitOperatingSystem) {
     $targets = @(
         'x86_64-pc-windows-gnu'
     )
+    if ([System.Runtime.InteropServices.RuntimeInformation]::ProcessArchitecture -eq "Arm64") {
+        $node_installer_platform = "windows-arm64"
+    } else {
+        $node_installer_platform = "windows-x64"
+    }
 }
 else {
     $targets = @(
         'i686-pc-windows-gnu'
     )
+    $node_installer_platform = "windows-x64"
 }
 
 if (test-path -path "binaries/$version") {
@@ -36,12 +47,30 @@ $targets | foreach-object {
 
     if (!(test-path -path "binaries/$version/$target")) { New-Item -Path "binaries/$version/$target" -ItemType Directory -force | out-null }
 
-    Write-Output "downloading $path"    
+    Write-Output "downloading $path"
     invoke-webrequest -uri "$TABNINE_UPDATE_SERVICE/bundles/$path/TabNine.zip" -outfile "binaries/$path/TabNine.zip"
     # Stop this iteration if the download failed
     if (!(Test-Path "binaries/$path/TabNine.zip" -PathType Leaf)) {return}
 
-    expand-archive "binaries/$path/TabNine.zip" "binaries/$path" 
+    expand-archive "binaries/$path/TabNine.zip" "binaries/$path"
 
     remove-item -path "binaries/$path/TabNine.zip"
 }
+
+# Download Node.js runtime using node-installer
+$NODE_INSTALLER = Join-Path $ScriptDir "node/installer/$node_installer_platform/tabnine-node-installer.exe"
+if (Test-Path $NODE_INSTALLER -PathType Leaf) {
+    Write-Output "Downloading Node.js runtime using node-installer..."
+    try {
+        $NODE_RUNTIME_DIR = & $NODE_INSTALLER $TABNINE_UPDATE_SERVICE $NODE_VERSION 2>$null
+        if ($NODE_RUNTIME_DIR) {
+            Write-Output "Node.js runtime installed at: $NODE_RUNTIME_DIR"
+        }
+    }
+    catch {
+        Write-Warning "Failed to download Node.js runtime. Some features may not work."
+    }
+}
+else {
+    Write-Warning "node-installer not found at $NODE_INSTALLER"
+}

dl_binaries.ps1

@@ -2,6 +2,7 @@
 set -e
 
 TABNINE_UPDATE_SERVICE=${1:-"https://update.tabnine.com"}
+NODE_VERSION="v24.12.0"
 DEPENDS='unzip curl' # list of dependencies (commands)
 HAS_ALL_DEPS=1       # 1 = present, 0 = missing
 for dep in ${DEPENDS}; do
@@ -14,22 +15,29 @@ if [ "${HAS_ALL_DEPS}" -eq 0 ]; then # missing something.
   exit 1
 fi
 
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
 # This script downloads the binaries for the most recent version of TabNine.
 # Infrastructure detection heavily inspired by https://github.com/tzachar/cmp-tabnine/blob/main/install.sh
 version=${version:-$(curl -fsSL "$TABNINE_UPDATE_SERVICE/bundles/version")}
 case $(uname -s) in
 "Darwin")
   if [ "$(uname -m)" = "arm64" ]; then
     targets="aarch64-apple-darwin"
+    node_installer_platform="macos-arm64"
   elif [ "$(uname -m)" = "x86_64" ]; then
     targets="x86_64-apple-darwin"
+    node_installer_platform="macos-x64"
   fi
   ;;
 "Linux")
   if [ "$(uname -m)" = "x86_64" ]; then
     targets="x86_64-unknown-linux-musl"
+    node_installer_platform="linux-x64"
   elif [ "$(uname -m)" = "aarch64" ]; then
     targets="aarch64-unknown-linux-musl"
+    node_installer_platform="linux-arm64"
   fi
   ;;
 esac
@@ -54,3 +62,20 @@ echo "$targets" | while read -r target; do
   rm "binaries/$path/TabNine.zip"
   chmod +x "binaries/$path/"*
 done
+
+# Download Node.js runtime using node-installer
+if [ -n "$node_installer_platform" ]; then
+  NODE_INSTALLER="$SCRIPT_DIR/node/installer/$node_installer_platform/tabnine-node-installer"
+  if [ -f "$NODE_INSTALLER" ]; then
+    echo "Downloading Node.js runtime using node-installer..."
+    chmod +x "$NODE_INSTALLER"
+    NODE_RUNTIME_DIR=$("$NODE_INSTALLER" "$TABNINE_UPDATE_SERVICE" "$NODE_VERSION" 2>/dev/null) || {
+      echo "Warning: Failed to download Node.js runtime. Some features may not work."
+    }
+    if [ -n "$NODE_RUNTIME_DIR" ]; then
+      echo "Node.js runtime installed at: $NODE_RUNTIME_DIR"
+    fi
+  else
+    echo "Warning: node-installer not found at $NODE_INSTALLER"
+  fi
+fi

dl_binaries.sh

@@ -3,8 +3,11 @@ local chat_setup = require("tabnine.chat.setup")
 local config = require("tabnine.config")
 local consts = require("tabnine.consts")
 local keymaps = require("tabnine.keymaps")
+local node_server = require("tabnine.node_server")
+local ports = require("tabnine.ports")
 local semver = require("tabnine.third_party.semver.semver")
 local status = require("tabnine.status")
+local tabnine_binary = require("tabnine.binary")
 local user_commands = require("tabnine.user_commands")
 local workspace = require("tabnine.workspace")
 
@@ -13,6 +16,20 @@ local M = {}
 function M.setup(o)
 	config.set_config(o)
 
+	-- 1. Initialize ports (allocates node_server_port and rust_server_port)
+	ports.init()
+
+	-- 2. Start TabNine binary (receives NODE_SERVER_PORT and RUST_SERVER_PORT env vars)
+	tabnine_binary:start()
+
+	-- 3. Trigger Rust HTTP server to start by sending ChatCommunicatorAddress request
+	tabnine_binary:request({
+		ChatCommunicatorAddress = { kind = "Forward" },
+	}, function()
+		-- 4. Start node server after Rust HTTP server is ready
+		node_server:ensure_running()
+	end)
+
 	local v = vim.version()
 	local cur_version = semver(v.major, v.minor, v.patch)
 	local min_version = semver(consts.min_nvim_version)