@juspay/neurolink 9.41.0 → 9.42.1

package/docs/changelog.md

@@ -0,0 +1,252 @@
+# Changelog
+
+All notable changes to NeuroLink are documented in this changelog.
+
+For the complete and most up-to-date changelog, please visit:
+**[CHANGELOG.md](https://github.com/juspay/neurolink/blob/release/CHANGELOG.md)** in the GitHub repository.
+
+---
+
+## Latest Releases
+
+### v9.14.0 (Current Release - February 28, 2026)
+
+**Features:**
+
+- **(providers):** Add Claude Subscription Support with OAuth 2.0 PKCE authentication for Claude Pro/Max subscriptions
+
+**What's New:**
+
+- **OAuth 2.0 with PKCE authentication** for Claude Pro, Max, and Team subscription users, enabling API access without separate API keys
+- **Automatic token refresh** before every `generate()` and `stream()` call, ensuring uninterrupted sessions
+- **Model tier access enforcement** with six subscription tiers: `free`, `pro`, `max`, `max_5`, `max_20`, and `api`, restricting model access based on the user's plan
+- **New `auth` CLI command** with four subcommands: `login` (browser-based OAuth flow), `status` (display current authentication state), `refresh` (manually refresh tokens), and `logout` (revoke and clear credentials)
+- **Secure token storage** at `~/.neurolink/anthropic-credentials.json` with filesystem-level permissions
+- **Beta feature support** for `claude-code`, `interleaved-thinking`, and `fine-grained-tool-streaming` via Anthropic beta headers
+- **99 integration tests** covering authentication flows, token lifecycle, tier enforcement, and CLI command behavior
+
+---
+
+### v8.26.1 (December 31, 2025)
+
+**Bug Fixes:**
+
+- **(providers):** Resolve Gemini 3 issues, add utilities, improve tests ([270ef6f](https://github.com/juspay/neurolink/commit/270ef6f225e7861846cf359f2d81edae38592053))
+
+**What's New:**
+
+- Enhanced Gemini 3 provider stability
+- Improved test coverage for Google AI providers
+- Added new provider utility functions
+
+---
+
+### v8.26.0 (December 30, 2025)
+
+**Features:**
+
+- **(types):** Add video output types (VIDEO-GEN-001) ([1b1b5c2](https://github.com/juspay/neurolink/commit/1b1b5c23d0bdacb9d3120797b1f7984d7e0cc48c))
+
+**What's New:**
+
+- Video generation type support
+- Enhanced multimodal capabilities
+- New type definitions for video outputs
+
+---
+
+### v8.25.0 (December 30, 2025)
+
+**Features:**
+
+- **(observability):** Add support for custom metadata in Context ([b175249](https://github.com/juspay/neurolink/commit/b175249c61357b0e6d127932bd7824d0bfe6f2ed))
+
+**What's New:**
+
+- Custom metadata support for observability
+- Enhanced context tracking capabilities
+- Improved telemetry integration
+
+---
+
+## Recent Notable Releases
+
+### v8.24.0 - OpenRouter Integration
+
+- Added OpenRouter provider with 300+ model support
+- Enhanced provider ecosystem
+- Expanded model availability
+
+### v8.23.0 - CSV Enhancements
+
+- Added file extension field to CSV metadata
+- Improved CSV processing capabilities
+
+### v8.22.0 - CI/CD Improvements
+
+- Added ffmpeg installation and verification to CI/CD pipeline
+- Enhanced multimedia processing support
+
+### v8.21.0 - Office Documents
+
+- Added office document type definitions
+- Comprehensive document handling tests
+- Enhanced multimodal support
+
+### v8.20.0 - Memory Improvements
+
+- Implemented token-based summarization
+- Enhanced conversation memory management
+- Optimized context handling
+
+### v8.19.0 - TTS Integration
+
+- Integrated Text-to-Speech (TTS) into BaseProvider.generate()
+- Enhanced audio generation capabilities
+- Google TTS handler improvements
+
+---
+
+## Version Support Policy
+
+| Version | Status      | Support Level                                            | End of Life  |
+| ------- | ----------- | -------------------------------------------------------- | ------------ |
+| **8.x** | **Active**  | Full support - Security updates, bug fixes, new features | -            |
+| 7.x     | Maintenance | Security updates and critical bug fixes only             | June 1, 2026 |
+| 6.x     | End of Life | No support                                               | June 1, 2025 |
+
+**Support Levels Explained:**
+
+- **Active**: Full support including new features, enhancements, bug fixes, and security updates
+- **Maintenance**: Security patches and critical bug fixes only, no new features
+- **End of Life**: No updates or support, upgrade recommended
+
+---
+
+## Upgrade Guides
+
+Migrating between major versions? Check out our comprehensive upgrade guides:
+
+### Major Version Upgrades
+
+- **v8 to v9 Migration Guide**
+
+  > This guide is planned for a future release.
+
+- **v7 to v8 Migration Guide**
+
+  > This guide is planned for a future release.
+
+- **v6 to v7 Migration Guide**
+  > This guide is planned for a future release.
+
+### Migrating from Other SDKs
+
+Already using another AI SDK? We have migration guides:
+
+- **[From LangChain](guides/migration/from-langchain.md)**
+  - Feature comparison
+  - API mapping
+  - Tool/chain equivalents
+
+- **[From Vercel AI SDK](guides/migration/from-vercel-ai-sdk.md)**
+  - Provider migration
+  - Streaming API changes
+  - UI integration patterns
+
+---
+
+## Release Highlights by Feature Area
+
+### Providers (v8.20.0 - v9.14.0)
+
+- **v9.14.0**: Claude Subscription Support with OAuth 2.0 PKCE authentication
+- **v8.26.1**: Gemini 3 stability improvements
+- **v8.24.0**: OpenRouter provider (300+ models)
+- **v8.20.0**: Enhanced provider error handling
+
+### Multimodal (v8.19.0 - v8.26.0)
+
+- **v8.26.0**: Video output types
+- **v8.23.0**: CSV metadata enhancements
+- **v8.21.0**: Office document support
+- **v8.19.0**: TTS integration
+
+### Memory & Context (v8.20.0 - v8.25.0)
+
+- **v8.25.0**: Custom metadata in Context
+- **v8.20.0**: Token-based summarization
+
+### Developer Experience (v8.22.0 - v8.23.1)
+
+- **v8.23.1**: Blocked tool support
+- **v8.22.0**: Enhanced CI/CD pipeline
+
+---
+
+## Breaking Changes Summary
+
+### v8.x Series
+
+No major breaking changes in v8.x patch releases. All releases are backward compatible within the 8.x major version.
+
+### Future Breaking Changes
+
+Breaking changes are only introduced in major version updates (e.g., v9.0.0). We follow [Semantic Versioning](https://semver.org/):
+
+- **Major (x.0.0)**: Breaking changes
+- **Minor (8.x.0)**: New features, backward compatible
+- **Patch (8.26.x)**: Bug fixes, backward compatible
+
+---
+
+## Release Schedule
+
+NeuroLink follows a continuous release schedule:
+
+- **Patch Releases**: As needed for bug fixes and minor improvements
+- **Minor Releases**: Every 1-2 weeks for new features
+- **Major Releases**: Annually or when significant architecture changes are needed
+
+### Release Notifications
+
+Stay updated with new releases:
+
+1. **GitHub Releases**: Watch the [NeuroLink repository](https://github.com/juspay/neurolink) for release notifications
+2. **NPM**: Follow [@juspay/neurolink](https://www.npmjs.com/package/@juspay/neurolink) on npm
+3. **Changelog**: Monitor this page or the [full CHANGELOG.md](https://github.com/juspay/neurolink/blob/release/CHANGELOG.md)
+4. **GitHub Discussions**: Join discussions for release announcements
+
+---
+
+## Contribution to Changelog
+
+Found a bug or want to contribute? Here's how:
+
+1. **Report Issues**: [GitHub Issues](https://github.com/juspay/neurolink/issues)
+2. **Submit PRs**: [Contributing Guide](contributing.md)
+3. **Discuss Features**: [GitHub Discussions](https://github.com/juspay/neurolink/discussions)
+
+All contributions are automatically included in the changelog via our automated release process using semantic-release.
+
+---
+
+## Historical Releases
+
+For a complete history of all releases including detailed commit information, see:
+
+**[Complete CHANGELOG.md](https://github.com/juspay/neurolink/blob/release/CHANGELOG.md)**
+
+---
+
+## Related Documentation
+
+- **[Installation Guide](getting-started/installation.md)** - Install the latest version
+- **[Quick Start](getting-started/quick-start.md)** - Get up and running quickly
+- **[Migration Guides](guides/migration-guide.md)** - Upgrade from older versions
+- **Breaking Changes** - Detailed breaking changes documentation is planned for a future release
+
+---
+
+**Last Updated:** February 28, 2026
+**Current Version:** v9.14.0

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@juspay/neurolink",
-  "version": "9.41.0",
+  "version": "9.42.1",
+  "packageManager": "pnpm@10.15.1",
   "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",
@@ -100,6 +101,14 @@
     "docs:build": "pnpm --filter ./docs-site build",
     "docs:serve": "pnpm --filter ./docs-site serve",
     "docs:clear": "pnpm --filter ./docs-site clear",
+    "// Proxy Observability (Local OpenObserve)": "",
+    "proxy:observability:setup": "bash scripts/observability/manage-local-openobserve.sh setup",
+    "proxy:observability:up": "bash scripts/observability/manage-local-openobserve.sh up",
+    "proxy:observability:down": "bash scripts/observability/manage-local-openobserve.sh down",
+    "proxy:observability:logs": "bash scripts/observability/manage-local-openobserve.sh logs",
+    "proxy:observability:status": "bash scripts/observability/manage-local-openobserve.sh status",
+    "proxy:observability:doctor": "node scripts/observability/check-proxy-telemetry.mjs",
+    "proxy:observability:import-dashboard": "bash scripts/observability/manage-local-openobserve.sh import-dashboard",
     "// Development & Monitoring": "",
     "dev:health": "tsx tools/development/healthMonitor.ts",
     "dev:demo": "concurrently \"pnpm run dev\" \"node neurolink-demo/complete-enhanced-server.js\"",
@@ -132,9 +141,11 @@
     "!dist/**/*.test.*",
     "!dist/**/*.spec.*",
     "!dist/**/*.map",
+    "docs/assets/dashboards/*.json",
     "docs-site/mcp-server/*.js",
     "docs-site/mcp-server/*.d.ts",
     "docs-site/static/search-index.json",
+    "scripts/observability/*",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
@@ -204,10 +215,15 @@
     "@langfuse/otel": "^5.0.1",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "@openrouter/ai-sdk-provider": "^2.2.3",
+    "@opentelemetry/api-logs": "^0.214.0",
     "@opentelemetry/context-async-hooks": "^2.6.1",
     "@opentelemetry/core": "^2.6.0",
-    "@opentelemetry/exporter-trace-otlp-http": "^0.213.0",
+    "@opentelemetry/exporter-logs-otlp-http": "^0.214.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.214.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.214.0",
     "@opentelemetry/resources": "^2.6.0",
+    "@opentelemetry/sdk-logs": "^0.214.0",
+    "@opentelemetry/sdk-metrics": "^2.6.1",
     "@opentelemetry/sdk-trace-base": "^2.6.0",
     "@opentelemetry/semantic-conventions": "^1.40.0",
     "adm-zip": "^0.5.16",
@@ -418,6 +434,7 @@
       "js-yaml@>=3.0.0 <3.14.2": ">=3.14.2",
       "markdown-it@<14.1.1": ">=14.1.1",
       "ajv@>=8.0.0 <8.18.0": ">=8.18.0",
+      "@xmldom/xmldom@<0.8.12": ">=0.8.12",
       "rollup@>=4.0.0 <4.59.0": ">=4.59.0"
     }
   },

package/scripts/observability/check-proxy-telemetry.mjs

@@ -0,0 +1,235 @@
+#!/usr/bin/env node
+
+import { Buffer } from "node:buffer";
+import { promises as fs } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+const DEFAULT_OPENOBSERVE_URL = "http://localhost:5080";
+const DEFAULT_OPENOBSERVE_ORG = "default";
+const DEFAULT_OPENOBSERVE_USER = "root@example.com";
+const DEFAULT_OPENOBSERVE_PASSWORD = "Complexpass#123";
+const DEFAULT_MAX_LAG_SECONDS = 900;
+const STREAMS_TO_CHECK = [
+  {
+    type: "logs",
+    name: "neurolink_proxy",
+    label: "OpenObserve logs",
+  },
+  {
+    type: "traces",
+    name: "neurolink_proxy",
+    label: "OpenObserve traces",
+  },
+  {
+    type: "metrics",
+    name: "proxy_requests_total",
+    label: "OpenObserve proxy metrics",
+  },
+];
+
+function getAuthHeader() {
+  if (process.env.NEUROLINK_OPENOBSERVE_BASIC_AUTH) {
+    return process.env.NEUROLINK_OPENOBSERVE_BASIC_AUTH;
+  }
+
+  const user =
+    process.env.NEUROLINK_OPENOBSERVE_USER || DEFAULT_OPENOBSERVE_USER;
+  const password =
+    process.env.NEUROLINK_OPENOBSERVE_PASSWORD || DEFAULT_OPENOBSERVE_PASSWORD;
+
+  return `Basic ${Buffer.from(`${user}:${password}`).toString("base64")}`;
+}
+
+function formatDate(micros) {
+  return new Date(Math.floor(micros / 1000)).toISOString();
+}
+
+function formatAgeSeconds(seconds) {
+  if (!Number.isFinite(seconds) || seconds < 0) {
+    return "n/a";
+  }
+  if (seconds < 60) {
+    return `${Math.round(seconds)}s`;
+  }
+  const minutes = seconds / 60;
+  if (minutes < 60) {
+    return `${Math.round(minutes)}m`;
+  }
+  const hours = minutes / 60;
+  return `${hours.toFixed(1)}h`;
+}
+
+function summarizeLag(ageSeconds, thresholdSeconds) {
+  if (!Number.isFinite(ageSeconds)) {
+    return "missing";
+  }
+  return ageSeconds <= thresholdSeconds ? "fresh" : "stale";
+}
+
+async function fetchStreams(type) {
+  const url = new URL(
+    `/api/${process.env.NEUROLINK_OPENOBSERVE_ORG || DEFAULT_OPENOBSERVE_ORG}/streams?type=${type}`,
+    process.env.NEUROLINK_OPENOBSERVE_URL || DEFAULT_OPENOBSERVE_URL,
+  );
+
+  const response = await fetch(url, {
+    headers: {
+      Authorization: getAuthHeader(),
+    },
+  });
+
+  if (!response.ok) {
+    throw new Error(
+      `Failed to fetch ${type} streams: ${response.status} ${response.statusText}`,
+    );
+  }
+
+  const body = await response.json();
+  return body.list || [];
+}
+
+async function readLatestLocalSummary() {
+  const logsDir = join(homedir(), ".neurolink", "logs");
+  let entries;
+  try {
+    entries = await fs.readdir(logsDir);
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      return null; // No log directory yet — fresh setup
+    }
+    throw err;
+  }
+  const files = entries
+    .filter((name) => /^proxy-\d{4}-\d{2}-\d{2}\.jsonl$/.test(name))
+    .sort()
+    .reverse();
+
+  for (const name of files) {
+    const path = join(logsDir, name);
+    let handle;
+    try {
+      handle = await fs.open(path, "r");
+    } catch (err) {
+      if (err.code === "ENOENT") {
+        continue;
+      }
+      throw err;
+    }
+    try {
+      const stats = await handle.stat();
+      const chunkSize = Math.min(stats.size, 64 * 1024);
+      const buffer = Buffer.alloc(chunkSize);
+      await handle.read(buffer, 0, chunkSize, stats.size - chunkSize);
+      const lines = buffer
+        .toString("utf8")
+        .split("\n")
+        .map((line) => line.trim())
+        .filter(Boolean);
+      for (let i = lines.length - 1; i >= 0; i -= 1) {
+        try {
+          return JSON.parse(lines[i]);
+        } catch {
+          // ignore malformed tail line
+        }
+      }
+    } finally {
+      await handle.close();
+    }
+  }
+
+  return null;
+}
+
+async function main() {
+  const thresholdSeconds = Number(
+    process.env.NEUROLINK_PROXY_TELEMETRY_MAX_LAG_SEC ||
+      DEFAULT_MAX_LAG_SECONDS,
+  );
+  const nowMicros = Date.now() * 1000;
+
+  const groupedStreams = Object.fromEntries(
+    await Promise.all(
+      [...new Set(STREAMS_TO_CHECK.map((stream) => stream.type))].map(
+        async (type) => [type, await fetchStreams(type)],
+      ),
+    ),
+  );
+
+  const localSummary = await readLatestLocalSummary();
+  const localSummaryMicros = localSummary?.timestamp
+    ? new Date(localSummary.timestamp).getTime() * 1000
+    : null;
+
+  console.log("NeuroLink Proxy Telemetry Doctor");
+  console.log("================================");
+  console.log(
+    `OpenObserve: ${process.env.NEUROLINK_OPENOBSERVE_URL || DEFAULT_OPENOBSERVE_URL}`,
+  );
+  console.log(`Lag threshold: ${thresholdSeconds}s`);
+  console.log("");
+
+  let hasProblem = false;
+
+  for (const stream of STREAMS_TO_CHECK) {
+    const item = groupedStreams[stream.type]?.find(
+      (entry) => entry.name === stream.name,
+    );
+    const latestMicros = item?.stats?.doc_time_max ?? null;
+    const ageSeconds = latestMicros
+      ? Math.max(0, (nowMicros - latestMicros) / 1_000_000)
+      : Number.NaN;
+    const status = summarizeLag(ageSeconds, thresholdSeconds);
+    if (status !== "fresh") {
+      hasProblem = true;
+    }
+
+    console.log(`${stream.label}: ${status}`);
+    console.log(`  stream: ${stream.name}`);
+    console.log(`  latest: ${latestMicros ? formatDate(latestMicros) : "missing"}`);
+    console.log(`  age: ${formatAgeSeconds(ageSeconds)}`);
+    console.log(`  docs: ${item?.stats?.doc_num ?? 0}`);
+  }
+
+  console.log("");
+  console.log("Local proxy summary log:");
+  if (!localSummary || !localSummaryMicros) {
+    console.log("  missing");
+    hasProblem = true;
+  } else {
+    const ageSeconds = Math.max(0, (nowMicros - localSummaryMicros) / 1_000_000);
+    console.log(`  latest: ${localSummary.timestamp}`);
+    console.log(`  age: ${formatAgeSeconds(ageSeconds)}`);
+    console.log(`  requestId: ${localSummary.requestId}`);
+    console.log(`  status: ${localSummary.responseStatus}`);
+    console.log(`  accountType: ${localSummary.accountType}`);
+  }
+
+  if (localSummaryMicros) {
+    console.log("");
+    console.log("Lag vs local summary:");
+    for (const stream of STREAMS_TO_CHECK) {
+      const item = groupedStreams[stream.type]?.find(
+        (entry) => entry.name === stream.name,
+      );
+      const latestMicros = item?.stats?.doc_time_max ?? null;
+      const deltaSeconds = latestMicros
+        ? Math.abs(localSummaryMicros - latestMicros) / 1_000_000
+        : Number.NaN;
+      const status = summarizeLag(deltaSeconds, thresholdSeconds);
+      if (status !== "fresh") {
+        hasProblem = true;
+      }
+      console.log(`  ${stream.name}: ${status} (${formatAgeSeconds(deltaSeconds)})`);
+    }
+  }
+
+  if (hasProblem) {
+    process.exitCode = 1;
+  }
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exitCode = 1;
+});

package/scripts/observability/docker-compose.proxy-observability.yaml

@@ -0,0 +1,55 @@
+# Local OpenObserve stack for NeuroLink proxy observability.
+#
+# Architecture:
+#   NeuroLink proxy -> OTEL collector -> OpenObserve
+#
+# Override defaults by exporting env vars or by copying
+# scripts/observability/proxy-observability.env.example to
+# scripts/observability/proxy-observability.env and using the helper script.
+
+services:
+  otel-collector:
+    image: otel/opentelemetry-collector-contrib:latest
+    restart: unless-stopped
+    command: ["--config=/etc/otelcol/config.yaml"]
+    environment:
+      NEUROLINK_OPENOBSERVE_OTLP_ENDPOINT: ${NEUROLINK_OPENOBSERVE_OTLP_ENDPOINT:-http://openobserve:5080/api/default}
+      NEUROLINK_OPENOBSERVE_BASIC_AUTH: ${NEUROLINK_OPENOBSERVE_BASIC_AUTH:-Basic cm9vdEBleGFtcGxlLmNvbTpDb21wbGV4cGFzcyMxMjM=}
+      NEUROLINK_PROXY_STREAM_HEADER: ${NEUROLINK_PROXY_STREAM_HEADER:-neurolink-proxy}
+    volumes:
+      - ./otel-collector.proxy-observability.yaml:/etc/otelcol/config.yaml:ro
+    ports:
+      - "${NEUROLINK_OTLP_GRPC_PORT:-14317}:4317"
+      - "${NEUROLINK_OTLP_HTTP_PORT:-14318}:4318"
+      - "${NEUROLINK_OTEL_HEALTH_PORT:-14333}:13133"
+      - "${NEUROLINK_OTEL_METRICS_PORT:-18888}:8888"
+      - "${NEUROLINK_OTEL_PPROF_PORT:-11777}:1777"
+    depends_on:
+      - openobserve
+    networks:
+      - proxy-observability
+
+  openobserve:
+    image: public.ecr.aws/zinclabs/openobserve:latest
+    restart: unless-stopped
+    ports:
+      - "${NEUROLINK_OPENOBSERVE_HTTP_PORT:-5080}:5080"
+      - "${NEUROLINK_OPENOBSERVE_GRPC_PORT:-5081}:5081"
+    environment:
+      ZO_ROOT_USER_EMAIL: ${NEUROLINK_OPENOBSERVE_USER:-root@example.com}
+      ZO_ROOT_USER_PASSWORD: ${NEUROLINK_OPENOBSERVE_PASSWORD:-Complexpass#123}
+      ZO_DATA_DIR: /data
+      RUST_LOG: ${NEUROLINK_OPENOBSERVE_LOG_LEVEL:-info}
+      ZO_INGEST_ALLOWED_UPTO: ${NEUROLINK_OPENOBSERVE_INGEST_HOURS:-720}
+    volumes:
+      - openobserve-data:/data
+    networks:
+      - proxy-observability
+
+networks:
+  proxy-observability:
+    driver: bridge
+
+volumes:
+  openobserve-data:
+    name: ${NEUROLINK_OPENOBSERVE_VOLUME_NAME:-neurolink-openobserve-data}