Release (#2005)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

apps/next/next.config.mjs

@@ -15,6 +15,20 @@ const config = {
     "twoslash",
     "typescript",
   ],
+  async redirects() {
+    return [
+      {
+        source: "/docs/chat-ui/:path*.mdx",
+        destination: "/docs/chat-ui/:path*",
+        permanent: true,
+      },
+      {
+        source: "/docs/llamaflow/:path*.mdx",
+        destination: "/docs/llamaflow/:path*",
+        permanent: true,
+      },
+    ];
+  },
   turbopack: {
     resolveAlias: {
       fs: { browser: "./fallback.js" },

apps/next/package.json

@@ -16,7 +16,7 @@
     "@huggingface/transformers": "^3.5.0",
     "@icons-pack/react-simple-icons": "^10.1.0",
     "@llama-flow/docs": "0.0.8",
-    "@llamaindex/chat-ui-docs": "0.0.3",
+    "@llamaindex/chat-ui-docs": "^0.0.5",
     "@llamaindex/cloud": "workspace:*",
     "@llamaindex/core": "workspace:*",
     "@llamaindex/node-parser": "workspace:*",
@@ -39,13 +39,13 @@
     "clsx": "2.1.1",
     "foxact": "^0.2.41",
     "framer-motion": "^11.11.17",
-    "fumadocs-core": "^15.2.7",
+    "fumadocs-core": "^15.5.0",
     "fumadocs-docgen": "^2.0.0",
-    "fumadocs-mdx": "^11.6.0",
-    "fumadocs-openapi": "^8.0.1",
-    "fumadocs-twoslash": "^3.1.1",
-    "fumadocs-typescript": "^4.0.2",
-    "fumadocs-ui": "^15.2.7",
+    "fumadocs-mdx": "^11.6.6",
+    "fumadocs-openapi": "^9.0.5",
+    "fumadocs-twoslash": "^3.1.3",
+    "fumadocs-typescript": "^4.0.5",
+    "fumadocs-ui": "^15.5.0",
     "hast-util-to-jsx-runtime": "^2.3.2",
     "llamaindex": "workspace:*",
     "lucide-react": "^0.460.0",

apps/next/source.config.ts

@@ -13,6 +13,11 @@ export const docs = defineDocs({
     "./src/content/docs",
     "./node_modules/@llama-flow/docs",
     "./node_modules/@llamaindex/chat-ui-docs",
+    // NOTE: When adding external docs (like chat-ui or llama-flow above),
+    // make sure to also update:
+    // 1. scripts/validate-links.mts - add to ALLOWED_LINKS array
+    // 2. next.config.mjs - add redirect for .mdx files
+    // 3. src/content/docs/meta.json - add to pages array
   ],
   docs: {
     async: true,

examples/CHANGELOG.md

@@ -1,5 +1,12 @@
 # examples
 
+## 0.3.20
+
+### Patch Changes
+
+- Updated dependencies [e7484ef]
+  - @llamaindex/weaviate@0.0.24
+
 ## 0.3.19
 
 ### Patch Changes

examples/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/examples",
-  "version": "0.3.19",
+  "version": "0.3.20",
   "private": true,
   "scripts": {
     "lint": "eslint .",
@@ -53,7 +53,7 @@
     "@llamaindex/vercel": "^0.1.9",
     "@llamaindex/vllm": "^0.0.45",
     "@llamaindex/voyage-ai": "^1.0.15",
-    "@llamaindex/weaviate": "^0.0.23",
+    "@llamaindex/weaviate": "^0.0.24",
     "@llamaindex/workflow": "^1.1.6",
     "@llamaindex/xai": "workspace:^0.0.6",
     "@notionhq/client": "^2.2.15",

packages/providers/google/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @llamaindex/google
 
+## 0.3.8
+
+### Patch Changes
+
+- 56763dc: Update to the latest Gemini 2.5 Pro Preview key
+
 ## 0.3.7
 
 ### Patch Changes

packages/providers/google/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/google",
   "description": "Google Adapter for LlamaIndex",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",

packages/providers/google/src/types.ts

@@ -75,7 +75,7 @@ export enum GEMINI_MODEL {
   GEMINI_2_0_PRO_EXPERIMENTAL = "gemini-2.0-pro-exp-02-05",
   GEMINI_2_0_FLASH_LIVE = "gemini-2.0-flash-live-001",
   GEMINI_2_5_PRO_PREVIEW = "gemini-2.5-pro-preview-03-25",
-  GEMINI_2_5_PRO_PREVIEW_LATEST = "gemini-2.5-pro-preview-05-06",
+  GEMINI_2_5_PRO_PREVIEW_LATEST = "gemini-2.5-pro-preview-06-05",
   GEMINI_2_5_FLASH_PREVIEW = "gemini-2.5-flash-preview-05-20",
 }
 

packages/providers/storage/weaviate/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @llamaindex/weaviate
 
+## 0.0.24
+
+### Patch Changes
+
+- e7484ef: Add metadata sanitization before adding node. Add error handling
+
 ## 0.0.23
 
 ### Patch Changes

packages/providers/storage/weaviate/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/weaviate",
   "description": "Weaviate Storage for LlamaIndex",
-  "version": "0.0.23",
+  "version": "0.0.24",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -35,11 +35,13 @@
   },
   "scripts": {
     "build": "bunchee",
-    "dev": "bunchee --watch"
+    "dev": "bunchee --watch",
+    "test": "vitest run"
   },
   "devDependencies": {
     "@llamaindex/core": "workspace:*",
-    "@llamaindex/env": "workspace:*"
+    "@llamaindex/env": "workspace:*",
+    "vitest": "^3.2.0"
   },
   "peerDependencies": {
     "@llamaindex/core": "workspace:*",

packages/providers/storage/weaviate/src/WeaviateVectorStore.ts

@@ -23,6 +23,7 @@ import {
 } from "@llamaindex/core/vector-store";
 import { getEnv } from "@llamaindex/env";
 import type { BaseHybridOptions } from "weaviate-client";
+import { sanitizeMetadata } from "./sanitize";
 
 const NODE_SCHEMA = [
   {
@@ -119,6 +120,7 @@ const toWeaviateFilter = (
 export class WeaviateVectorStore extends BaseVectorStore {
   public storesText: boolean = true;
   private flatMetadata: boolean = true;
+  private sanitizeMetadata: boolean = true;
 
   private weaviateClient?: WeaviateClient;
   private clusterURL!: string;
@@ -142,6 +144,7 @@ export class WeaviateVectorStore extends BaseVectorStore {
       contentKey?: string;
       metadataKey?: string;
       embeddingKey?: string;
+      sanitizeMetadata?: boolean;
     },
   ) {
     super(init);
@@ -169,6 +172,7 @@ export class WeaviateVectorStore extends BaseVectorStore {
     this.contentKey = init?.contentKey ?? "text";
     this.embeddingKey = init?.embeddingKey ?? "vectors";
     this.metadataKey = init?.metadataKey ?? "node_info";
+    this.sanitizeMetadata = init?.sanitizeMetadata ?? true;
   }
 
   public client() {
@@ -186,11 +190,14 @@ export class WeaviateVectorStore extends BaseVectorStore {
           this.contentKey,
           this.flatMetadata,
         );
+        const processedMetadata = this.sanitizeMetadata
+          ? sanitizeMetadata(metadata)
+          : metadata;
         const body = {
           [this.idKey]: node.id_,
           [this.embeddingKey]: node.getEmbedding(),
           properties: {
-            ...metadata,
+            ...processedMetadata,
             [this.contentKey]: node.getContent(MetadataMode.NONE),
             [this.metadataKey]: JSON.stringify(metadata),
             relationships: JSON.stringify({ ref_doc_id: metadata.ref_doc_id }),
@@ -200,6 +207,15 @@ export class WeaviateVectorStore extends BaseVectorStore {
       }),
     );
 
+    if (result.hasErrors) {
+      const errorMessages = Object.values(result.errors)
+        .map((error) => error.message)
+        .join("; ");
+      throw new Error(
+        `Failed to add nodes to Weaviate: ${errorMessages}. If the error is related to metadata, try calling sanitizeMetadata on your data before adding it to the vector store.`,
+      );
+    }
+
     return Object.values(result.uuids);
   }
 

packages/providers/storage/weaviate/src/index.ts

@@ -1 +1,2 @@
+export * from "./sanitize";
 export * from "./WeaviateVectorStore";

packages/providers/storage/weaviate/src/sanitize.ts

@@ -0,0 +1,44 @@
+/**
+ * Sanitize all keys in a metadata object to conform to Weaviate naming requirements
+ */
+export const sanitizeMetadata = <T extends Record<string, unknown>>(
+  metadata: T,
+): Record<string, T[keyof T]> => {
+  const sanitized: Record<string, T[keyof T]> = {};
+  for (const [key, value] of Object.entries(metadata)) {
+    const sanitizedKey = sanitizePropertyName(key);
+    if (sanitizedKey !== key) {
+      console.warn(
+        `Weaviate metadata property name "${key}" was sanitized to "${sanitizedKey}" to comply with GraphQL naming requirements.`,
+      );
+    }
+    sanitized[sanitizedKey] = value as T[keyof T];
+  }
+  return sanitized;
+}; /**
+ * Sanitize property names to conform to Weaviate's GraphQL naming requirements.
+ * Names must match the pattern [_A-Za-z][_0-9A-Za-z]*
+ */
+
+const sanitizePropertyName = (name: string): string => {
+  // Replace invalid characters with underscores
+  let sanitized = name.replace(/[^_A-Za-z0-9]/g, "_");
+
+  // Ensure it starts with a letter or underscore
+  if (!/^[_A-Za-z]/.test(sanitized)) {
+    sanitized = "_" + sanitized;
+  }
+
+  // Remove consecutive underscores
+  sanitized = sanitized.replace(/_+/g, "_");
+
+  // Remove trailing underscores
+  sanitized = sanitized.replace(/_+$/, "");
+
+  // Ensure it's not empty
+  if (!sanitized) {
+    sanitized = "_property";
+  }
+
+  return sanitized;
+};

packages/providers/storage/weaviate/tests/mocks/weaviate.mocks.ts

@@ -0,0 +1,33 @@
+import { Settings } from "@llamaindex/core/global";
+import { vi } from "vitest";
+
+// Mock embedding model
+export const mockEmbedding = {
+  getTextEmbedding: vi.fn(() => Promise.resolve([0.1, 0.2, 0.3])),
+  getTextEmbeddings: vi.fn(() => Promise.resolve([[0.1, 0.2, 0.3]])),
+};
+
+// Mock weaviate collection
+export const mockCollection = {
+  data: {
+    insertMany: vi.fn(),
+  },
+  config: {
+    get: vi.fn(() => Promise.resolve({ properties: [] })),
+  },
+};
+
+// Mock weaviate client
+export const mockClient = {
+  collections: {
+    exists: vi.fn(() => Promise.resolve(true)),
+    get: vi.fn(() => mockCollection),
+    createFromSchema: vi.fn(() => Promise.resolve(mockCollection)),
+  },
+};
+
+// Setup embedding model for tests
+export const setupMockEmbedding = () => {
+  (Settings as unknown as { embedModel: typeof mockEmbedding }).embedModel =
+    mockEmbedding;
+};

packages/providers/storage/weaviate/tests/sanitize.test.ts

@@ -0,0 +1,125 @@
+import { Document } from "@llamaindex/core/schema";
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { WeaviateVectorStore } from "../src/WeaviateVectorStore";
+import {
+  mockClient,
+  mockCollection,
+  setupMockEmbedding,
+} from "./mocks/weaviate.mocks";
+
+// Mock the weaviate-client module
+vi.mock("weaviate-client", () => {
+  return {
+    default: {
+      connectToWeaviateCloud: vi.fn(() => Promise.resolve(mockClient)),
+      ApiKey: vi.fn(),
+    },
+    connectToWeaviateCloud: vi.fn(() => Promise.resolve(mockClient)),
+    ApiKey: vi.fn(),
+  };
+});
+
+describe("sanitize", () => {
+  // Shared test data
+  const testCloudOptions = {
+    clusterURL: "https://test-cluster.weaviate.network",
+    apiKey: "test-api-key",
+  };
+
+  const testDocument = new Document({
+    text: "This is a test document for embedding.",
+    metadata: {
+      source: "whatever",
+      "hyphenated-column-name": "foobar", // Invalid GraphQL property name
+    },
+    embedding: [0.1, 0.2, 0.3],
+  });
+
+  beforeEach(() => {
+    vi.clearAllMocks();
+    // Set up embedding model for tests
+    setupMockEmbedding();
+  });
+
+  describe("metadata property name sanitization", () => {
+    it("should throw Weaviate error when sanitization is disabled and property names are invalid", async () => {
+      // Setup mock to return an error for invalid property names
+      mockCollection.data.insertMany.mockResolvedValue({
+        hasErrors: true,
+        errors: {
+          "0": {
+            message:
+              "'hyphenated-column-name' is not a valid nested property name of 'metadata'. NestedProperty names in Weaviate are restricted to valid GraphQL names, which must be \"/[_A-Za-z][_0-9A-Za-z]*/\".",
+          },
+        },
+        uuids: {},
+      });
+
+      const vectorStore = new WeaviateVectorStore({
+        cloudOptions: testCloudOptions,
+        sanitizeMetadata: false,
+      });
+
+      await expect(vectorStore.add([testDocument])).rejects.toThrow(
+        "Failed to add nodes to Weaviate",
+      );
+    });
+
+    it("should automatically sanitize invalid property names when sanitization is enabled", async () => {
+      // Setup mock to return success
+      mockCollection.data.insertMany.mockResolvedValue({
+        hasErrors: false,
+        errors: {},
+        uuids: { "0": "test-uuid-1" },
+      });
+
+      const vectorStore = new WeaviateVectorStore({
+        cloudOptions: testCloudOptions,
+        sanitizeMetadata: true,
+      });
+
+      const result = await vectorStore.add([testDocument]);
+
+      // Verify that insertMany was called with sanitized metadata
+      expect(mockCollection.data.insertMany).toHaveBeenCalledWith([
+        expect.objectContaining({
+          properties: expect.objectContaining({
+            // The hyphenated key should be sanitized to use underscores
+            hyphenated_column_name: "foobar",
+            source: "whatever",
+            text: "This is a test document for embedding.",
+          }),
+        }),
+      ]);
+
+      expect(result).toEqual(["test-uuid-1"]);
+    });
+
+    it("should sanitize property names by default when sanitizeMetadata option is not specified", async () => {
+      // Setup mock to return success
+      mockCollection.data.insertMany.mockResolvedValue({
+        hasErrors: false,
+        errors: {},
+        uuids: { "0": "test-uuid-1" },
+      });
+
+      const vectorStore = new WeaviateVectorStore({
+        cloudOptions: testCloudOptions,
+        // sanitizeMetadata not specified, should default to true
+      });
+
+      await vectorStore.add([testDocument]);
+
+      // Verify that insertMany was called with sanitized metadata (default behavior)
+      expect(mockCollection.data.insertMany).toHaveBeenCalledWith([
+        expect.objectContaining({
+          properties: expect.objectContaining({
+            hyphenated_column_name: "foobar", // sanitized
+            source: "whatever",
+            text: "This is a test document for embedding.",
+          }),
+        }),
+      ]);
+    });
+  });
+});