ci: linting, type checking and testing - fix

Co-authored-by: Marcus Schiesser <mail@marcusschiesser.de>

.changeset/floppy-carrots-fold.md

@@ -0,0 +1,9 @@
+---
+"@llamaindex/workflow": minor
+"@llamaindex/tools": minor
+"@llamaindex/core": minor
+"@llamaindex/resolution-tests": patch
+"@llamaindex/e2e": patch
+---
+
+Moving tools from zod to zod/v4; adding responseFormat to llm.exec

apps/next/CHANGELOG.md

@@ -1,5 +1,50 @@
 # @llamaindex/doc
 
+## 0.2.51
+
+### Patch Changes
+
+- Updated dependencies [4c70376]
+  - @llamaindex/openai@0.4.16
+
+## 0.2.50
+
+### Patch Changes
+
+- Updated dependencies [b6409b6]
+  - @llamaindex/openai@0.4.15
+
+## 0.2.49
+
+### Patch Changes
+
+- Updated dependencies [4b51791]
+  - @llamaindex/cloud@4.1.1
+  - llamaindex@0.11.26
+
+## 0.2.48
+
+### Patch Changes
+
+- Updated dependencies [049471b]
+- Updated dependencies [049471b]
+  - @llamaindex/cloud@4.1.0
+  - llamaindex@0.11.25
+
+## 0.2.47
+
+### Patch Changes
+
+- Updated dependencies [c3bf3c7]
+- Updated dependencies [f9f1de9]
+  - @llamaindex/cloud@4.0.28
+  - @llamaindex/core@0.6.19
+  - llamaindex@0.11.24
+  - @llamaindex/node-parser@2.0.19
+  - @llamaindex/openai@0.4.14
+  - @llamaindex/readers@3.1.18
+  - @llamaindex/workflow@1.1.20
+
 ## 0.2.46
 
 ### Patch Changes

apps/next/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/doc",
-  "version": "0.2.46",
+  "version": "0.2.51",
   "private": true,
   "scripts": {
     "postinstall": "fumadocs-mdx",

apps/next/src/content/docs/llamaindex/integration/mcp-toolbox.mdx

@@ -0,0 +1,85 @@
+---
+title: MCP Toolbox For Databases
+description: MCP Toolbox for Databases is an open source MCP server for databases.
+---
+
+# MCP Toolbox for Databases
+
+[MCP Toolbox for Databases](https://github.com/googleapis/genai-toolbox) is an open source MCP server for databases. It was designed with enterprise-grade and production-quality in mind. It enables you to develop tools easier, faster, and more securely by handling the complexities such as connection pooling, authentication, and more.
+
+Toolbox Tools can be seemlessly integrated with LlamaIndex applications. For more
+information on [getting
+started](https://googleapis.github.io/genai-toolbox/getting-started/local_quickstart_js/) or
+[configuring](https://googleapis.github.io/genai-toolbox/getting-started/configure/)
+Toolbox, see the
+[documentation](https://googleapis.github.io/genai-toolbox/getting-started/introduction/).
+
+![architecture](/images/mcp_db_toolbox.png)
+
+### Configure and deploy
+
+Toolbox is an open source server that you deploy and manage yourself. For more
+instructions on deploying and configuring, see the official Toolbox
+documentation:
+
+* [Installing the Server](https://googleapis.github.io/genai-toolbox/getting-started/introduction/#installing-the-server)
+* [Configuring Toolbox](https://googleapis.github.io/genai-toolbox/getting-started/configure/)
+
+### Install client SDK
+
+LlamaIndex relies on the `@toolbox-sdk/core` node package to use Toolbox. Install the
+package before getting started:
+
+```shell
+npm install @toolbox-sdk/core
+```
+
+### Loading Toolbox Tools
+
+Once your Toolbox server is configured and up and running, you can load tools
+from your server using the SDK:
+
+```javascript
+import { gemini, GEMINI_MODEL } from "@llamaindex/google";
+import { agent } from "@llamaindex/workflow";
+import { tool } from "llamaindex";
+import { ToolboxClient } from "@toolbox-sdk/core";
+
+// Initialize LLM
+const llm = gemini({
+  model: GEMINI_MODEL.GEMINI_2_0_FLASH,
+  apiKey: process.env.GOOGLE_API_KEY,
+});
+
+// Replace with your Toolbox Server URL
+const URL = 'https://127.0.0.1:5000';
+
+const client = new ToolboxClient("http://127.0.0.1:5000");
+const toolboxTools = await client.loadToolset("my-toolset");
+
+const getTool = (toolboxTool) => tool({
+  name: toolboxTool.getName(),
+  description: toolboxTool.getDescription(),
+  parameters: toolboxTool.getParamSchema(),
+  execute: toolboxTool
+});
+const tools = toolboxTools.map(getTool);
+
+const myAgent = agent({
+  tools: tools,
+  llm,
+  memory,
+  systemPrompt: prompt,
+});
+const result = await myAgent.run(query);
+console.log(result);
+```
+
+### Advanced Toolbox Features
+
+Toolbox has a variety of features to make developing Gen AI tools for databases seamless.
+For more information, read more about the following:
+
+- [Authenticated Parameters](https://googleapis.github.io/genai-toolbox/resources/tools/#authenticated-parameters): bind tool inputs to values from OIDC tokens automatically, making it easy to run sensitive queries without potentially leaking data
+- [Authorized Invocations](https://googleapis.github.io/genai-toolbox/resources/tools/#authorized-invocations): restrict access to use a tool based on the users Auth token
+- [OpenTelemetry](https://googleapis.github.io/genai-toolbox/how-to/export_telemetry/): get metrics and tracing from Toolbox with [OpenTelemetry](https://opentelemetry.io/docs/)

apps/next/src/content/docs/llamaindex/integration/meta.json

@@ -1,5 +1,5 @@
 {
   "title": "Integration",
   "description": "See our integrations",
-  "pages": ["open-llm-metry", "lang-trace", "vercel"]
+  "pages": ["open-llm-metry", "lang-trace", "mcp-toolbox", "vercel"]
 }

apps/next/src/content/docs/llamaindex/modules/agents/tool/index.mdx

@@ -101,6 +101,9 @@ const agent = agent({
 });
 ```
 
+You can also use [MCP Toolbox for
+Databases](/docs/llamaindex/integration/mcp-toolbox) to interact with MCP tools.
+
 
 ## Function tool
 

apps/next/src/content/docs/llamaindex/tutorials/local_llm.mdx

@@ -93,4 +93,4 @@ async function main() {
 main().catch(console.error);
 ```
 
-You can see the [full example file](https://github.com/run-llama/LlamaIndexTS/blob/main/examples/vectorIndexLocal.ts).
+You can see the [full example file](https://github.com/run-llama/LlamaIndexTS/blob/main/examples/index/vectorIndexLocal.ts).

e2e/examples/cloudflare-worker-agent/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @llamaindex/cloudflare-worker-agent-test
 
+## 0.0.187
+
+### Patch Changes
+
+- llamaindex@0.11.26
+
+## 0.0.186
+
+### Patch Changes
+
+- Updated dependencies [049471b]
+  - llamaindex@0.11.25
+
+## 0.0.185
+
+### Patch Changes
+
+- llamaindex@0.11.24
+
 ## 0.0.184
 
 ### Patch Changes

e2e/examples/cloudflare-worker-agent/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/cloudflare-worker-agent-test",
-  "version": "0.0.184",
+  "version": "0.0.187",
   "type": "module",
   "private": true,
   "scripts": {

e2e/examples/llama-parse-browser/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @llamaindex/llama-parse-browser-test
 
+## 0.0.85
+
+### Patch Changes
+
+- Updated dependencies [4b51791]
+  - @llamaindex/cloud@4.1.1
+
+## 0.0.84
+
+### Patch Changes
+
+- Updated dependencies [049471b]
+  - @llamaindex/cloud@4.1.0
+
+## 0.0.83
+
+### Patch Changes
+
+- Updated dependencies [c3bf3c7]
+  - @llamaindex/cloud@4.0.28
+
 ## 0.0.82
 
 ### Patch Changes

e2e/examples/llama-parse-browser/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/llama-parse-browser-test",
   "private": true,
-  "version": "0.0.82",
+  "version": "0.0.85",
   "type": "module",
   "scripts": {
     "dev": "vite",

e2e/examples/nextjs-agent/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @llamaindex/next-agent-test
 
+## 0.1.187
+
+### Patch Changes
+
+- llamaindex@0.11.26
+
+## 0.1.186
+
+### Patch Changes
+
+- Updated dependencies [049471b]
+  - llamaindex@0.11.25
+
+## 0.1.185
+
+### Patch Changes
+
+- llamaindex@0.11.24
+
 ## 0.1.184
 
 ### Patch Changes

e2e/examples/nextjs-agent/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/next-agent-test",
-  "version": "0.1.184",
+  "version": "0.1.187",
   "private": true,
   "scripts": {
     "dev": "next dev",

e2e/examples/nextjs-edge-runtime/CHANGELOG.md

@@ -1,5 +1,24 @@
 # test-edge-runtime
 
+## 0.1.186
+
+### Patch Changes
+
+- llamaindex@0.11.26
+
+## 0.1.185
+
+### Patch Changes
+
+- Updated dependencies [049471b]
+  - llamaindex@0.11.25
+
+## 0.1.184
+
+### Patch Changes
+
+- llamaindex@0.11.24
+
 ## 0.1.183
 
 ### Patch Changes

e2e/examples/nextjs-edge-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/nextjs-edge-runtime-test",
-  "version": "0.1.183",
+  "version": "0.1.186",
   "private": true,
   "scripts": {
     "dev": "next dev",

e2e/examples/nextjs-node-runtime/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @llamaindex/next-node-runtime
 
+## 0.1.58
+
+### Patch Changes
+
+- @llamaindex/huggingface@0.1.26
+
+## 0.1.57
+
+### Patch Changes
+
+- @llamaindex/huggingface@0.1.25
+
+## 0.1.56
+
+### Patch Changes
+
+- llamaindex@0.11.26
+
+## 0.1.55
+
+### Patch Changes
+
+- Updated dependencies [049471b]
+  - llamaindex@0.11.25
+
+## 0.1.54
+
+### Patch Changes
+
+- llamaindex@0.11.24
+- @llamaindex/huggingface@0.1.24
+- @llamaindex/readers@3.1.18
+
 ## 0.1.53
 
 ### Patch Changes

e2e/examples/nextjs-node-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/next-node-runtime-test",
-  "version": "0.1.53",
+  "version": "0.1.58",
   "private": true,
   "scripts": {
     "dev": "next dev",

e2e/examples/vite-import-llamaindex/CHANGELOG.md

@@ -1,5 +1,24 @@
 # vite-import-llamaindex
 
+## 0.0.53
+
+### Patch Changes
+
+- llamaindex@0.11.26
+
+## 0.0.52
+
+### Patch Changes
+
+- Updated dependencies [049471b]
+  - llamaindex@0.11.25
+
+## 0.0.51
+
+### Patch Changes
+
+- llamaindex@0.11.24
+
 ## 0.0.50
 
 ### Patch Changes

e2e/examples/vite-import-llamaindex/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vite-import-llamaindex",
   "private": true,
-  "version": "0.0.50",
+  "version": "0.0.53",
   "type": "module",
   "scripts": {
     "build": "vite build",

e2e/examples/vite-import-llamaindex/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["./src/main.ts","./vite.config.ts"],"version":"5.7.3"}
+{"root":["./src/main.ts","./vite.config.ts"],"version":"5.8.3"}

e2e/examples/waku-query-engine/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @llamaindex/waku-query-engine-test
 
+## 0.0.187
+
+### Patch Changes
+
+- llamaindex@0.11.26
+
+## 0.0.186
+
+### Patch Changes
+
+- Updated dependencies [049471b]
+  - llamaindex@0.11.25
+
+## 0.0.185
+
+### Patch Changes
+
+- llamaindex@0.11.24
+
 ## 0.0.184
 
 ### Patch Changes

e2e/examples/waku-query-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/waku-query-engine-test",
-  "version": "0.0.184",
+  "version": "0.0.187",
   "type": "module",
   "private": true,
   "scripts": {

e2e/node/fixtures/tools.ts

@@ -1,5 +1,5 @@
 import { FunctionTool } from "llamaindex";
-import { z } from "zod";
+import * as z from "zod/v4";
 
 function sumNumbers({ a, b }: { a: number; b: number }) {
   return `${a + b}`;
@@ -13,12 +13,8 @@ export const sumNumbersTool = FunctionTool.from(sumNumbers, {
   name: "sumNumbers",
   description: "Use this function to sum two numbers",
   parameters: z.object({
-    a: z.number({
-      description: "The first number",
-    }),
-    b: z.number({
-      description: "The second number",
-    }),
+    a: z.number({}).describe("The first number"),
+    b: z.number({}).describe("The second number"),
   }),
 });
 
@@ -26,12 +22,8 @@ export const divideNumbersTool = FunctionTool.from(divideNumbers, {
   name: "divideNumbers",
   description: "Use this function to divide two numbers",
   parameters: z.object({
-    a: z.number({
-      description: "The first number",
-    }),
-    b: z.number({
-      description: "The second number",
-    }),
+    a: z.number({}).describe("The first number"),
+    b: z.number({}).describe("The second number"),
   }),
 });
 
@@ -44,9 +36,7 @@ export const getWeatherTool = FunctionTool.from(
     name: "getWeather",
     description: "Get the weather for a city",
     parameters: z.object({
-      city: z.string({
-        description: "The city to get the weather for",
-      }),
+      city: z.string({}).describe("The city to get the weather for"),
     }),
   },
 );

e2e/npm/test/workflow.e2e.ts

@@ -3,7 +3,7 @@ import { agent } from "@llamaindex/workflow";
 import { Settings, tool } from "llamaindex";
 import { ok } from "node:assert";
 import { test } from "node:test";
-import { z } from "zod";
+import * as z from "zod/v4";
 
 Settings.llm = new OpenAI({ model: "gpt-4-0613" });
 

examples/CHANGELOG.md

@@ -1,5 +1,111 @@
 # examples
 
+## 0.3.38
+
+### Patch Changes
+
+- Updated dependencies [4c70376]
+  - @llamaindex/openai@0.4.16
+  - @llamaindex/clip@0.0.72
+  - @llamaindex/deepinfra@0.0.72
+  - @llamaindex/deepseek@0.0.34
+  - @llamaindex/fireworks@0.0.32
+  - @llamaindex/groq@0.0.88
+  - @llamaindex/huggingface@0.1.26
+  - @llamaindex/jinaai@0.0.32
+  - @llamaindex/perplexity@0.0.29
+  - @llamaindex/azure@0.1.33
+  - @llamaindex/together@0.0.32
+  - @llamaindex/vllm@0.0.58
+  - @llamaindex/xai@0.0.19
+
+## 0.3.37
+
+### Patch Changes
+
+- Updated dependencies [47a6f5f]
+- Updated dependencies [b80f33e]
+- Updated dependencies [b6409b6]
+- Updated dependencies [b80f33e]
+  - @llamaindex/ollama@0.1.20
+  - @llamaindex/anthropic@0.3.22
+  - @llamaindex/openai@0.4.15
+  - @llamaindex/clip@0.0.71
+  - @llamaindex/deepinfra@0.0.71
+  - @llamaindex/deepseek@0.0.33
+  - @llamaindex/fireworks@0.0.31
+  - @llamaindex/groq@0.0.87
+  - @llamaindex/huggingface@0.1.25
+  - @llamaindex/jinaai@0.0.31
+  - @llamaindex/perplexity@0.0.28
+  - @llamaindex/azure@0.1.32
+  - @llamaindex/together@0.0.31
+  - @llamaindex/vllm@0.0.57
+  - @llamaindex/xai@0.0.18
+
+## 0.3.36
+
+### Patch Changes
+
+- Updated dependencies [4b51791]
+- Updated dependencies [971d37c]
+  - @llamaindex/cloud@4.1.1
+  - @llamaindex/deepseek@0.0.32
+  - llamaindex@0.11.26
+
+## 0.3.35
+
+### Patch Changes
+
+- Updated dependencies [c3bf3c7]
+- Updated dependencies [f9f1de9]
+  - @llamaindex/cloud@4.0.28
+  - @llamaindex/core@0.6.19
+  - llamaindex@0.11.24
+  - @llamaindex/node-parser@2.0.19
+  - @llamaindex/anthropic@0.3.21
+  - @llamaindex/assemblyai@0.1.18
+  - @llamaindex/clip@0.0.70
+  - @llamaindex/cohere@0.0.33
+  - @llamaindex/deepinfra@0.0.70
+  - @llamaindex/discord@0.1.18
+  - @llamaindex/google@0.3.18
+  - @llamaindex/huggingface@0.1.24
+  - @llamaindex/jinaai@0.0.30
+  - @llamaindex/mistral@0.1.19
+  - @llamaindex/mixedbread@0.0.33
+  - @llamaindex/notion@0.1.18
+  - @llamaindex/ollama@0.1.19
+  - @llamaindex/openai@0.4.14
+  - @llamaindex/perplexity@0.0.27
+  - @llamaindex/portkey-ai@0.0.61
+  - @llamaindex/replicate@0.0.61
+  - @llamaindex/bm25-retriever@0.0.8
+  - @llamaindex/astra@0.0.33
+  - @llamaindex/azure@0.1.31
+  - @llamaindex/chroma@0.0.33
+  - @llamaindex/elastic-search@0.1.19
+  - @llamaindex/firestore@1.0.26
+  - @llamaindex/milvus@0.1.28
+  - @llamaindex/mongodb@0.0.34
+  - @llamaindex/pinecone@0.1.19
+  - @llamaindex/postgres@0.0.62
+  - @llamaindex/qdrant@0.1.29
+  - @llamaindex/supabase@0.1.20
+  - @llamaindex/upstash@0.0.33
+  - @llamaindex/weaviate@0.0.34
+  - @llamaindex/vercel@0.1.19
+  - @llamaindex/voyage-ai@1.0.25
+  - @llamaindex/readers@3.1.18
+  - @llamaindex/tools@0.1.9
+  - @llamaindex/workflow@1.1.20
+  - @llamaindex/deepseek@0.0.31
+  - @llamaindex/fireworks@0.0.30
+  - @llamaindex/groq@0.0.86
+  - @llamaindex/together@0.0.30
+  - @llamaindex/vllm@0.0.56
+  - @llamaindex/xai@0.0.17
+
 ## 0.3.34
 
 ### Patch Changes

examples/agents/agent/blog-writer.ts

@@ -8,7 +8,7 @@ import {
 import fs from "fs";
 import { tool } from "llamaindex";
 import os from "os";
-import { z } from "zod";
+import * as z from "zod/v4";
 
 import { wiki } from "@llamaindex/tools";
 const llm = openai({
@@ -20,9 +20,7 @@ const saveFileTool = tool({
   description:
     "Save the written content into a file that can be downloaded by the user",
   parameters: z.object({
-    content: z.string({
-      description: "The content to save into a file",
-    }),
+    content: z.string().describe("The content to save into a file"),
   }),
   execute: ({ content }: { content: string }) => {
     const filePath = os.tmpdir() + "/report.md";

examples/agents/agent/large-toolcall.ts

@@ -1,7 +1,7 @@
 import { OpenAI } from "@llamaindex/openai";
 import { agent } from "@llamaindex/workflow";
 import { tool } from "llamaindex";
-import { z } from "zod";
+import * as z from "zod/v4";
 
 const csvData =
   "TITLE,RELEASE_YEAR,SCORE,NUMBER_OF_VOTES,DURATION,MAIN_GENRE,MAIN_PRODUCTION\nDavid Attenborough: A Life on Our Planet,2020,9,31180,83,documentary,GB\nInception,2010,8.8,2268288,148,scifi,GB\nForrest Gump,1994,8.8,1994599,142,drama,US\nAnbe Sivam,2003,8.7,20595,160,comedy,IN\nBo Burnham: Inside,2021,8.7,44074,87,comedy,US\nSaving Private Ryan,1998,8.6,1346020,169,drama,US\nDjango Unchained,2012,8.4,1472668,165,western,US\nDangal,2016,8.4,180247,161,action,IN\nBo Burnham: Make Happy,2016,8.4,14356,60,comedy,US\nLouis C.K.: Hilarious,2010,8.4,11973,84,comedy,US\nDave Chappelle: Sticks & Stones,2019,8.4,25687,65,comedy,US\n3 Idiots,2009,8.4,385782,170,comedy,IN\nBlack Friday,2004,8.4,20611,143,crime,IN\nSuper Deluxe,2019,8.4,13680,176,thriller,IN\nWinter on Fire: Ukraine's Fight for Freedom,2015,8.3,17710,98,documentary,UA\nOnce Upon a Time in America,1984,8.3,342335,229,drama,US\nTaxi Driver,1976,8.3,795222,113,crime,US\nLike Stars on Earth,2007,8.3,188234,165,drama,IN\nBo Burnham: What.,2013,8.3,11488,60,comedy,US\nFull Metal Jacket,1987,8.3,723306,116,drama,GB\nWarrior,2011,8.2,463276,140,drama,US\nDrishyam,2015,8.2,79075,163,thriller,IN\nQueen,2014,8.2,64805,146,drama,IN\nPaan Singh Tomar,2012,8.2,35888,135,drama,IN";
@@ -17,9 +17,7 @@ const userQuestion = "which are the best comedies after 2010?";
     description:
       "Execute python code in a Jupyter notebook cell and return any result, stdout, stderr, display_data, and error.",
     parameters: z.object({
-      code: z.string({
-        description: "The python code to execute in a single cell.",
-      }),
+      code: z.string().describe("The python code to execute in a single cell."),
     }),
     execute: ({ code }) => {
       console.log(

examples/agents/agent/multiple-agents.ts

@@ -15,7 +15,7 @@ import {
   stopAgentEvent,
 } from "@llamaindex/workflow";
 import { tool } from "llamaindex";
-import { z } from "zod";
+import * as z from "zod/v4";
 
 const llm = openai({
   model: "gpt-4o-mini",
@@ -26,9 +26,7 @@ const temperatureConverterTool = tool({
   description: "Convert a temperature from Fahrenheit to Celsius",
   name: "fahrenheitToCelsius",
   parameters: z.object({
-    temperature: z.number({
-      description: "The temperature in Fahrenheit",
-    }),
+    temperature: z.number().describe("The temperature in Fahrenheit"),
   }),
   execute: ({ temperature }) => {
     return ((temperature - 32) * 5) / 9;
@@ -39,9 +37,7 @@ const temperatureFetcherTool = tool({
   description: "Fetch the temperature (in Fahrenheit) for a city",
   name: "fetchTemperature",
   parameters: z.object({
-    city: z.string({
-      description: "The city to fetch the temperature for",
-    }),
+    city: z.string().describe("The city to fetch the temperature for"),
   }),
   execute: ({ city }) => {
     const temperature = Math.floor(Math.random() * 58) + 32;

examples/agents/agent/openai.ts

@@ -1,7 +1,7 @@
 import { openai } from "@llamaindex/openai";
 import { agent } from "@llamaindex/workflow";
 import { tool } from "llamaindex";
-import { z } from "zod";
+import * as z from "zod/v4";
 
 const sumNumbers = tool({
   name: "sumNumbers",

examples/agents/agent/with-anthropic.ts

@@ -6,7 +6,7 @@ import {
 } from "@llamaindex/workflow";
 import fs from "fs";
 import { tool } from "llamaindex";
-import { z } from "zod";
+import * as z from "zod/v4";
 
 import { anthropic } from "@llamaindex/anthropic";
 
@@ -14,9 +14,7 @@ const weatherTool = tool({
   name: "weather",
   description: "Get the weather",
   parameters: z.object({
-    location: z.string({
-      description: "The location to get the weather for",
-    }),
+    location: z.string().describe("The location to get the weather for"),
   }),
   execute: ({ location }) => {
     return `The weather in ${location} is sunny`;
@@ -27,9 +25,7 @@ const inflationTool = tool({
   name: "inflation",
   description: "Get the inflation",
   parameters: z.object({
-    location: z.string({
-      description: "The location to get the inflation for",
-    }),
+    location: z.string().describe("The location to get the inflation for"),
   }),
   execute: ({ location }) => {
     return `The inflation in ${location} is 2%`;
@@ -41,9 +37,7 @@ const saveFileTool = tool({
   description:
     "Save the written content into a file that can be downloaded by the user",
   parameters: z.object({
-    content: z.string({
-      description: "The content to save into a file",
-    }),
+    content: z.string().describe("The content to save into a file"),
   }),
   execute: ({ content }) => {
     const filePath = "./report.md";

examples/agents/tools/exec-stream.ts

@@ -1,6 +1,6 @@
 import { openai } from "@llamaindex/openai";
 import { tool } from "llamaindex";
-import z from "zod";
+import * as z from "zod/v4";
 
 import { ChatMessage } from "llamaindex";
 

examples/agents/tools/exec.ts

@@ -1,6 +1,6 @@
 import { openai } from "@llamaindex/openai";
 import { ChatMessage, tool } from "llamaindex";
-import z from "zod";
+import * as z from "zod/v4";
 
 async function main() {
   const llm = openai({ model: "gpt-4.1-mini" });

examples/agents/tools/structured-response.ts

@@ -0,0 +1,38 @@
+import { Anthropic } from "@llamaindex/anthropic";
+import { ChatMessage, ToolCall } from "llamaindex";
+import * as z from "zod/v4";
+
+const llm = new Anthropic({ model: "claude-4-0-sonnet" });
+
+const responseSchema = z.object({
+  title: z.string(),
+  author: z.string(),
+  year: z.number(),
+});
+
+async function main() {
+  const messages: ChatMessage[] = [];
+  let toolCalls: ToolCall[] = [];
+  do {
+    const result = await llm.exec({
+      messages: [
+        {
+          role: "system",
+          content: `You are a book expert. Your task is, given a user message, extract the title, author and publication year of the book and output them in JSON format.`,
+        },
+        {
+          role: "user",
+          content: `I have been reading La Divina Commedia by Dante Alighieri, published in 1321, which tells the story of a guy who goes through Hell, Purgatory and Heaven just to meet his beloved ex-girlfriend.`,
+        },
+      ],
+      responseFormat: responseSchema,
+    });
+    messages.push(...result.newMessages);
+    toolCalls = result.toolCalls;
+  } while (toolCalls.length == 0);
+
+  console.log(messages[1].content);
+  console.log(toolCalls);
+}
+
+main().catch(console.error);

examples/agents/tools/tools.ts

@@ -1,5 +1,5 @@
 import { tool } from "llamaindex";
-import { z } from "zod";
+import * as z from "zod/v4";
 
 export const getCurrentIDTool = tool({
   name: "get_user_id",

examples/deprecated/agents/large_toolcall_with_gpt4o.ts

@@ -1,6 +1,6 @@
 import { OpenAI } from "@llamaindex/openai";
 import { FunctionTool, ToolCallOptions } from "llamaindex";
-import { z } from "zod";
+import * as z from "zod/v4";
 
 (async () => {
   // The tool call will generate a partial JSON for `gpt-4-turbo`
@@ -29,9 +29,9 @@ async function callLLM(init: { model: string }) {
       description:
         "Execute python code in a Jupyter notebook cell and return any result, stdout, stderr, display_data, and error.",
       parameters: z.object({
-        code: z.string({
-          description: "The python code to execute in a single cell.",
-        }),
+        code: z
+          .string()
+          .describe("The python code to execute in a single cell."),
       }),
     },
   );

examples/deprecated/agents/retriever_openai_agent.ts

@@ -6,7 +6,7 @@ import {
   NodeWithScore,
   VectorStoreIndex,
 } from "llamaindex";
-import { z } from "zod";
+import * as z from "zod/v4";
 
 async function main() {
   // Load the documents

examples/deprecated/agents/stream_openai_agent.ts

@@ -1,6 +1,6 @@
 import { OpenAIAgent } from "@llamaindex/openai";
 import { FunctionTool } from "llamaindex";
-import { z } from "zod";
+import * as z from "zod/v4";
 
 // Define a function to sum two numbers
 function sumNumbers({ a, b }: { a: number; b: number }) {

examples/models/anthropic/agent.ts

@@ -2,7 +2,7 @@ import { anthropic } from "@llamaindex/anthropic";
 import { wiki } from "@llamaindex/tools";
 import { agent } from "@llamaindex/workflow";
 import { tool } from "llamaindex";
-import { z } from "zod";
+import * as z from "zod/v4";
 
 const workflow = agent({
   tools: [

examples/models/anthropic/opus-4.1.ts

@@ -0,0 +1,14 @@
+import { anthropic } from "@llamaindex/anthropic";
+import { agent } from "@llamaindex/workflow";
+
+(async function () {
+  const workflow = agent({
+    llm: anthropic({
+      model: "claude-4-1-opus",
+    }),
+  });
+  const result = await workflow.run(
+    "What are three compounds we should consider investigating to advance research into new antibiotics? Why should we consider them?",
+  );
+  console.log(result.data.result);
+})();

examples/models/gemini/agent.ts

@@ -1,8 +1,7 @@
 import { gemini, GEMINI_MODEL } from "@llamaindex/google";
 import { agent } from "@llamaindex/workflow";
 import { tool } from "llamaindex";
-import { z } from "zod";
-
+import * as z from "zod/v4";
 const sumNumbers = tool({
   name: "sumNumbers",
   description: "Use this function to sum two numbers",

examples/models/gemini/chat.ts

@@ -1,8 +1,7 @@
 import { gemini, GEMINI_MODEL } from "@llamaindex/google";
 import fs from "fs";
 import { tool } from "llamaindex";
-import { z } from "zod";
-
+import * as z from "zod/v4";
 (async () => {
   if (!process.env.GOOGLE_API_KEY) {
     throw new Error("Please set the GOOGLE_API_KEY environment variable.");

examples/models/gemini/live/tool-call.ts

@@ -2,15 +2,13 @@ import { gemini, GEMINI_MODEL } from "@llamaindex/google";
 import { ModalityType, tool } from "llamaindex";
 
 import { liveEvents } from "llamaindex";
-import { z } from "zod";
+import * as z from "zod/v4";
 
 const weatherTool = tool({
   name: "weather",
   description: "Get the weather",
   parameters: z.object({
-    location: z.string({
-      description: "The location to get the weather for",
-    }),
+    location: z.string().describe("The location to get the weather for"),
   }),
   execute: ({ location }) => {
     return `The weather in ${location} is rainy`;

examples/models/mistral/agent.ts

@@ -3,7 +3,7 @@ import { wiki } from "@llamaindex/tools";
 import { agent } from "@llamaindex/workflow";
 import { tool } from "llamaindex";
 
-import { z } from "zod";
+import * as z from "zod/v4";
 
 const workflow = agent({
   tools: [

examples/models/ollama/gpt-oss.ts

@@ -0,0 +1,9 @@
+import { ollama } from "@llamaindex/ollama";
+
+(async () => {
+  const llm = ollama({
+    model: "gpt-oss:20b",
+  });
+  const response = await llm.complete({ prompt: "How are you?" });
+  console.log("Response:", response.text);
+})();

examples/models/openai/responses/agent.ts

@@ -2,7 +2,7 @@ import { openaiResponses } from "@llamaindex/openai";
 import { wiki } from "@llamaindex/tools";
 import { agent } from "@llamaindex/workflow";
 import { tool } from "llamaindex";
-import { z } from "zod";
+import * as z from "zod/v4";
 
 const workflow = agent({
   tools: [

examples/models/openai/responses/tool-call.ts

@@ -1,15 +1,13 @@
 import { openaiResponses } from "@llamaindex/openai";
 import { tool } from "llamaindex";
 
-import { z } from "zod";
+import * as z from "zod/v4";
 async function main() {
   const weatherTool = tool({
     name: "weather",
     description: "Get the weather",
     parameters: z.object({
-      location: z.string({
-        description: "The location to get the weather for",
-      }),
+      location: z.string().describe("The location to get the weather for"),
     }),
     execute: ({ location }) => {
       return `The weather in ${location} is sunny`;

examples/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/examples",
-  "version": "0.3.34",
+  "version": "0.3.38",
   "private": true,
   "scripts": {
     "lint": "eslint .",
@@ -11,52 +11,52 @@
     "@azure/cosmos": "^4.1.1",
     "@azure/identity": "^4.4.1",
     "@azure/search-documents": "^12.1.0",
-    "@llamaindex/anthropic": "^0.3.20",
-    "@llamaindex/assemblyai": "^0.1.17",
-    "@llamaindex/astra": "^0.0.32",
-    "@llamaindex/azure": "^0.1.30",
-    "@llamaindex/bm25-retriever": "^0.0.7",
-    "@llamaindex/chroma": "^0.0.32",
-    "@llamaindex/clip": "^0.0.69",
-    "@llamaindex/cloud": "^4.0.27",
-    "@llamaindex/cohere": "^0.0.32",
-    "@llamaindex/core": "^0.6.18",
-    "@llamaindex/deepinfra": "^0.0.69",
-    "@llamaindex/deepseek": "^0.0.30",
-    "@llamaindex/discord": "^0.1.17",
-    "@llamaindex/elastic-search": "^0.1.18",
+    "@llamaindex/anthropic": "^0.3.22",
+    "@llamaindex/assemblyai": "^0.1.18",
+    "@llamaindex/astra": "^0.0.33",
+    "@llamaindex/azure": "^0.1.33",
+    "@llamaindex/bm25-retriever": "^0.0.8",
+    "@llamaindex/chroma": "^0.0.33",
+    "@llamaindex/clip": "^0.0.72",
+    "@llamaindex/cloud": "^4.1.1",
+    "@llamaindex/cohere": "^0.0.33",
+    "@llamaindex/core": "^0.6.19",
+    "@llamaindex/deepinfra": "^0.0.72",
+    "@llamaindex/deepseek": "^0.0.34",
+    "@llamaindex/discord": "^0.1.18",
+    "@llamaindex/elastic-search": "^0.1.19",
     "@llamaindex/env": "^0.1.30",
-    "@llamaindex/firestore": "^1.0.25",
-    "@llamaindex/fireworks": "^0.0.29",
-    "@llamaindex/google": "^0.3.17",
-    "@llamaindex/groq": "^0.0.85",
-    "@llamaindex/huggingface": "^0.1.23",
-    "@llamaindex/jinaai": "^0.0.29",
-    "@llamaindex/milvus": "^0.1.27",
-    "@llamaindex/mistral": "^0.1.18",
-    "@llamaindex/mixedbread": "^0.0.32",
-    "@llamaindex/mongodb": "^0.0.33",
-    "@llamaindex/node-parser": "^2.0.18",
-    "@llamaindex/notion": "^0.1.17",
-    "@llamaindex/ollama": "^0.1.18",
-    "@llamaindex/openai": "^0.4.13",
-    "@llamaindex/perplexity": "^0.0.26",
-    "@llamaindex/pinecone": "^0.1.18",
-    "@llamaindex/portkey-ai": "^0.0.60",
-    "@llamaindex/postgres": "^0.0.61",
-    "@llamaindex/qdrant": "^0.1.28",
-    "@llamaindex/readers": "^3.1.17",
-    "@llamaindex/replicate": "^0.0.60",
-    "@llamaindex/supabase": "^0.1.19",
-    "@llamaindex/together": "^0.0.29",
-    "@llamaindex/tools": "^0.1.8",
-    "@llamaindex/upstash": "^0.0.32",
-    "@llamaindex/vercel": "^0.1.18",
-    "@llamaindex/vllm": "^0.0.55",
-    "@llamaindex/voyage-ai": "^1.0.24",
-    "@llamaindex/weaviate": "^0.0.33",
-    "@llamaindex/workflow": "^1.1.19",
-    "@llamaindex/xai": "^0.0.16",
+    "@llamaindex/firestore": "^1.0.26",
+    "@llamaindex/fireworks": "^0.0.32",
+    "@llamaindex/google": "^0.3.18",
+    "@llamaindex/groq": "^0.0.88",
+    "@llamaindex/huggingface": "^0.1.26",
+    "@llamaindex/jinaai": "^0.0.32",
+    "@llamaindex/milvus": "^0.1.28",
+    "@llamaindex/mistral": "^0.1.19",
+    "@llamaindex/mixedbread": "^0.0.33",
+    "@llamaindex/mongodb": "^0.0.34",
+    "@llamaindex/node-parser": "^2.0.19",
+    "@llamaindex/notion": "^0.1.18",
+    "@llamaindex/ollama": "^0.1.20",
+    "@llamaindex/openai": "^0.4.16",
+    "@llamaindex/perplexity": "^0.0.29",
+    "@llamaindex/pinecone": "^0.1.19",
+    "@llamaindex/portkey-ai": "^0.0.61",
+    "@llamaindex/postgres": "^0.0.62",
+    "@llamaindex/qdrant": "^0.1.29",
+    "@llamaindex/readers": "^3.1.18",
+    "@llamaindex/replicate": "^0.0.61",
+    "@llamaindex/supabase": "^0.1.20",
+    "@llamaindex/together": "^0.0.32",
+    "@llamaindex/tools": "^0.1.9",
+    "@llamaindex/upstash": "^0.0.33",
+    "@llamaindex/vercel": "^0.1.19",
+    "@llamaindex/vllm": "^0.0.58",
+    "@llamaindex/voyage-ai": "^1.0.25",
+    "@llamaindex/weaviate": "^0.0.34",
+    "@llamaindex/workflow": "^1.1.20",
+    "@llamaindex/xai": "^0.0.19",
     "@notionhq/client": "^4.0.0",
     "@pinecone-database/pinecone": "^4.0.0",
     "@vercel/postgres": "^0.10.0",
@@ -65,7 +65,7 @@
     "commander": "^12.1.0",
     "dotenv": "^17.2.0",
     "js-tiktoken": "^1.0.14",
-    "llamaindex": "^0.11.23",
+    "llamaindex": "^0.11.26",
     "mongodb": "6.7.0",
     "postgres": "^3.4.4",
     "wikipedia": "^2.1.2",

packages/autotool/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @llamaindex/autotool
 
+## 8.0.26
+
+### Patch Changes
+
+- llamaindex@0.11.26
+
+## 8.0.25
+
+### Patch Changes
+
+- Updated dependencies [049471b]
+  - llamaindex@0.11.25
+
+## 8.0.24
+
+### Patch Changes
+
+- llamaindex@0.11.24
+
 ## 8.0.23
 
 ### Patch Changes

packages/autotool/examples/01_node/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @llamaindex/autotool-01-node-example
 
+## 0.0.134
+
+### Patch Changes
+
+- llamaindex@0.11.26
+- @llamaindex/autotool@8.0.26
+
+## 0.0.133
+
+### Patch Changes
+
+- Updated dependencies [049471b]
+  - llamaindex@0.11.25
+  - @llamaindex/autotool@8.0.25
+
+## 0.0.132
+
+### Patch Changes
+
+- llamaindex@0.11.24
+- @llamaindex/autotool@8.0.24
+
 ## 0.0.131
 
 ### Patch Changes

packages/autotool/examples/01_node/package.json

@@ -13,5 +13,5 @@
   "scripts": {
     "start": "node --import tsx --import @llamaindex/autotool/node ./src/index.ts"
   },
-  "version": "0.0.131"
+  "version": "0.0.134"
 }

packages/autotool/package.json

@@ -6,7 +6,7 @@
     "url": "git+https://github.com/run-llama/LlamaIndexTS.git",
     "directory": "packages/autotool"
   },
-  "version": "8.0.23",
+  "version": "8.0.26",
   "description": "auto transpile your JS function to LLM Agent compatible",
   "files": [
     "dist",

packages/cloud/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @llamaindex/cloud
 
+## 4.1.1
+
+### Patch Changes
+
+- 4b51791: Add deprecation to README
+
+## 4.1.0
+
+### Minor Changes
+
+- 049471b: Add deprecation warning
+
+## 4.0.28
+
+### Patch Changes
+
+- c3bf3c7: Adding support for citations to beta agent data schema
+- Updated dependencies [f9f1de9]
+  - @llamaindex/core@0.6.19
+
 ## 4.0.27
 
 ### Patch Changes

packages/cloud/README.md

@@ -1,8 +1,9 @@
 # @llamaindex/cloud
 
-> LlamaCloud is a new generation of managed parsing, ingestion, and retrieval services, designed to bring production-grade context-augmentation to your LLM and RAG applications.
-
-For more information, see the [API documentation](https://docs.cloud.llamaindex.ai/).
+> [!WARNING]  
+> This package has been deprecated since version 4.1.0.
+> Please migrate to [llama-cloud-services](https://www.npmjs.com/package/llama-cloud-services).
+> See the documentation: https://docs.cloud.llamaindex.ai
 
 ## License
 

packages/cloud/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/cloud",
-  "version": "4.0.27",
+  "version": "4.1.1",
   "type": "module",
   "license": "MIT",
   "scripts": {

packages/cloud/src/api.ts

@@ -1,3 +1,10 @@
+// Deprecation warning
+console.warn(`
+The package @llamaindex/cloud has been deprecated since version 4.1.0
+ * Please migrate to llama-cloud-services.
+ * See the documentation: https://docs.cloud.llamaindex.ai
+`);
+
 import { client } from "./client/client.gen";
 
 client.setConfig({

packages/cloud/src/beta/agent/index.ts

@@ -1,3 +1,10 @@
+// Deprecation warning
+console.warn(`
+The package @llamaindex/cloud has been deprecated since version 4.1.0
+ * Please migrate to llama-cloud-services.
+ * See the documentation: https://docs.cloud.llamaindex.ai
+`);
+
 export { AgentClient, createAgentDataClient } from "./client";
 
 export type {

packages/cloud/src/beta/agent/types.ts

@@ -28,6 +28,29 @@ export type ComparisonOperator =
  */
 export type FilterOperation = RawFilterOperation;
 
+/**
+ * Metadata for an extracted field, including confidence and citation information
+ */
+export interface ExtractedFieldMetadata {
+  /** The confidence score for the field, combined with parsing confidence if applicable */
+  confidence?: number;
+  /** The confidence score for the field based on the extracted text only */
+  extracted_confidence?: number;
+  /** The page number that the field occurred on */
+  page_number?: number;
+  /** The original text this field's value was derived from */
+  matching_text?: string;
+}
+
+/**
+ * Dictionary mapping field names to their metadata
+ * Values can be ExtractedFieldMetadata objects, nested dictionaries, or arrays
+ */
+export type ExtractedFieldMetadataDict = Record<
+  string,
+  ExtractedFieldMetadata | Record<string, unknown> | unknown[]
+>;
+
 /**
  * Base extracted data interface
  */
@@ -35,11 +58,13 @@ export interface ExtractedData<T = unknown> {
   /** The original data that was extracted from the document. For tracking changes. Should not be updated. */
   original_data: T;
   /** The latest state of the data. Will differ if data has been updated. */
-  data?: T;
+  data: T;
   /** The status of the extracted data. Prefer to use the StatusType values, but any string is allowed. */
   status: StatusType | string;
-  /** Confidence scores, if any, for each primitive field in the original_data data. */
-  confidence?: Record<string, unknown>;
+  /** The overall confidence score for the extracted data. */
+  overall_confidence?: number;
+  /** Page links, and perhaps eventually bounding boxes, for individual fields in the extracted data. */
+  field_metadata?: ExtractedFieldMetadataDict;
   /** The ID of the file that was used to extract the data. */
   file_id?: string;
   /** The name of the file that was used to extract the data. */

packages/cloud/src/parse.ts

@@ -1,3 +1,10 @@
+// Deprecation warning
+console.warn(`
+The package @llamaindex/cloud has been deprecated since version 4.1.0
+ * Please migrate to llama-cloud-services.
+ * See the documentation: https://docs.cloud.llamaindex.ai
+`);
+
 import { createClient, createConfig } from "@hey-api/client-fetch";
 import { createWorkflow, type InferWorkflowEventData } from "@llama-flow/core";
 import { createStatefulMiddleware } from "@llama-flow/core/middleware/state";

packages/community/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @llamaindex/community
 
+## 0.0.101
+
+### Patch Changes
+
+- Updated dependencies [f9f1de9]
+  - @llamaindex/core@0.6.19
+
 ## 0.0.100
 
 ### Patch Changes

packages/community/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/community",
   "description": "Community package for LlamaIndexTS",
-  "version": "0.0.100",
+  "version": "0.0.101",
   "type": "module",
   "types": "dist/type/index.d.ts",
   "main": "dist/cjs/index.js",

packages/core/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @llamaindex/core
 
+## 0.6.19
+
+### Patch Changes
+
+- f9f1de9: Use logger interface instead of directly hardcoding console.log
+
 ## 0.6.18
 
 ### Patch Changes

packages/core/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/core",
   "type": "module",
-  "version": "0.6.18",
+  "version": "0.6.19",
   "description": "LlamaIndex Core Module",
   "exports": {
     "./agent": {

packages/core/src/embeddings/base.ts

@@ -1,3 +1,4 @@
+import { consoleLogger, emptyLogger, type Logger } from "@llamaindex/env";
 import type { Tokenizers } from "@llamaindex/env/tokenizers";
 import type { MessageContentDetail } from "../llms";
 import { BaseNode, MetadataMode, TransformComponent } from "../schema";
@@ -18,6 +19,7 @@ export type EmbeddingInfo = {
 export type BaseEmbeddingOptions = {
   logProgress?: boolean;
   progressCallback?: (current: number, total: number) => void;
+  logger?: Logger;
 };
 
 export abstract class BaseEmbedding extends TransformComponent<
@@ -133,6 +135,9 @@ export async function batchEmbeddings<T>(
 
   const curBatch: T[] = [];
 
+  const logger =
+    options?.logger ?? (options?.logProgress ? consoleLogger : emptyLogger);
+
   for (let i = 0; i < queue.length; i++) {
     curBatch.push(queue[i]!);
     if (i == queue.length - 1 || curBatch.length == chunkSize) {
@@ -143,7 +148,7 @@ export async function batchEmbeddings<T>(
         options?.progressCallback?.(i + 1, queue.length);
       }
       if (options?.logProgress) {
-        console.log(`getting embedding progress: ${i + 1} / ${queue.length}`);
+        logger.log(`getting embedding progress: ${i + 1} / ${queue.length}`);
       }
 
       curBatch.length = 0;

packages/core/src/llms/base.ts

@@ -1,4 +1,6 @@
 import { emptyLogger } from "@llamaindex/env";
+import type { JSONObject } from "../global";
+import { tool } from "../tools/";
 import { extractText } from "../utils/llms";
 import { streamConverter } from "../utils/stream";
 import { callToolToMessage, getToolCallsFromResponse } from "./tool-call";
@@ -18,6 +20,7 @@ import type {
   PartialToolCall,
   ToolCallLLMMessageOptions,
 } from "./type";
+import { isZodSchema } from "./utils";
 
 export abstract class BaseLLM<
   AdditionalChatOptions extends object = object,
@@ -97,6 +100,31 @@ export abstract class BaseLLM<
     | ExecResponse<AdditionalMessageOptions>
     | ExecStreamResponse<AdditionalMessageOptions>
   > {
+    const responseFormat = params.responseFormat;
+    if (responseFormat && isZodSchema(responseFormat)) {
+      const structuredTool = tool({
+        name: "format_output",
+        description: "Respond with a JSON object",
+        parameters: responseFormat,
+        execute: (args) => {
+          const result = responseFormat.safeParse(args);
+          if (!result.success) {
+            console.error("Invalid input from LLM:", result.error);
+            return JSON.stringify({
+              error: "Invalid schema",
+              details: result.error,
+            });
+          }
+          return result.data as JSONObject;
+        },
+      });
+      if (Array.isArray(params.tools)) {
+        params.tools.push(structuredTool);
+      } else {
+        params.tools = [structuredTool];
+      }
+      params.responseFormat = undefined;
+    }
     if (params.stream) {
       return this.streamExec(params);
     }

packages/core/src/llms/utils.ts

@@ -1,3 +1,4 @@
+import * as z from "zod/v4";
 import type {
   ChatMessage,
   MessageContentImageDataDetail,
@@ -26,3 +27,15 @@ export function addContentPart<AdditionalMessageOptions extends object>(
     }
   }
 }
+
+export function isZodSchema(obj: unknown): obj is z.ZodType {
+  return (
+    obj !== null &&
+    typeof obj === "object" &&
+    "parse" in obj &&
+    typeof (obj as { parse: unknown }).parse === "function" &&
+    "safeParse" in obj &&
+    typeof (obj as { safeParse: unknown }).safeParse === "function" &&
+    "_def" in obj
+  );
+}

packages/core/src/memory/memory.ts

@@ -1,3 +1,4 @@
+import { consoleLogger, type Logger } from "@llamaindex/env";
 import { Settings } from "../global";
 import type { ChatMessage, LLM } from "../llms";
 import { extractText } from "../utils";
@@ -38,6 +39,11 @@ export type MemoryOptions<TMessageOptions extends object = object> = {
    * This default LLM can be overridden by the LLM passed in the `getLLM` method.
    */
   llm?: LLM | undefined;
+
+  /**
+   * Logger for memory operations
+   */
+  logger?: Logger;
 };
 
 export class Memory<
@@ -76,6 +82,10 @@ export class Memory<
    * The default LLM to use for memory retrieval.
    */
   private llm: LLM | undefined;
+  /**
+   * Logger for memory operations
+   */
+  private logger: Logger;
 
   constructor(
     messages: MemoryMessage<TMessageOptions>[] = [],
@@ -87,6 +97,7 @@ export class Memory<
       options.shortTermTokenLimitRatio ?? DEFAULT_SHORT_TERM_TOKEN_LIMIT_RATIO;
     this.memoryBlocks = options.memoryBlocks ?? [];
     this.memoryCursor = options.memoryCursor ?? 0;
+    this.logger = options.logger ?? consoleLogger;
     this.initLLM(options.llm);
 
     this.adapters = {
@@ -309,7 +320,7 @@ export class Memory<
           addedTokenCount += messageTokenCount;
         }
       } catch (error) {
-        console.warn(
+        this.logger.warn(
           `Failed to get content from memory block ${block.id}:`,
           error,
         );
@@ -371,7 +382,7 @@ export class Memory<
       try {
         await block.put(newMessages);
       } catch (error) {
-        console.warn(
+        this.logger.warn(
           `Failed to process messages into memory block ${block.id}:`,
           error,
         );

packages/core/src/node-parser/sentence-splitter.ts

@@ -1,3 +1,4 @@
+import { consoleLogger, type Logger } from "@llamaindex/env";
 import type { Tokenizer } from "@llamaindex/env/tokenizers";
 import { z } from "zod";
 import { Settings } from "../global";
@@ -48,9 +49,11 @@ export class SentenceSplitter extends MetadataAwareTextSplitter {
   #splitFns: Set<TextSplitterFn> = new Set();
   #subSentenceSplitFns: Set<TextSplitterFn> = new Set();
   #tokenizer: Tokenizer;
+  #logger: Logger;
 
   constructor(
-    params?: z.input<typeof sentenceSplitterSchema> & SplitterParams,
+    params?: z.input<typeof sentenceSplitterSchema> &
+      SplitterParams & { logger?: Logger },
   ) {
     super();
     if (params) {
@@ -66,6 +69,7 @@ export class SentenceSplitter extends MetadataAwareTextSplitter {
       this.extraAbbreviations,
     );
     this.#tokenizer = params?.tokenizer ?? Settings.tokenizer;
+    this.#logger = params?.logger ?? consoleLogger;
     this.#splitFns.add(splitBySep(this.paragraphSeparator));
     this.#splitFns.add(this.#chunkingTokenizerFn);
 
@@ -82,7 +86,7 @@ export class SentenceSplitter extends MetadataAwareTextSplitter {
         `Metadata length (${metadataLength}) is longer than chunk size (${this.chunkSize}). Consider increasing the chunk size or decreasing the size of your metadata to avoid this.`,
       );
     } else if (effectiveChunkSize < 50) {
-      console.log(
+      this.#logger.log(
         `Metadata length (${metadataLength}) is close to chunk size (${this.chunkSize}). Resulting chunks are less than 50 tokens. Consider increasing the chunk size or decreasing the size of your metadata to avoid this.`,
       );
     }

packages/core/src/node-parser/token-text-splitter.ts

@@ -1,3 +1,4 @@
+import { consoleLogger, type Logger } from "@llamaindex/env";
 import type { Tokenizer } from "@llamaindex/env/tokenizers";
 import { z } from "zod";
 import { DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, Settings } from "../global";
@@ -21,9 +22,11 @@ export class TokenTextSplitter extends MetadataAwareTextSplitter {
   backupSeparators: string[] = ["\n"];
   #tokenizer: Tokenizer;
   #splitFns: Array<(text: string) => string[]> = [];
+  #logger: Logger;
 
   constructor(
-    params?: SplitterParams & Partial<z.infer<typeof tokenTextSplitterSchema>>,
+    params?: SplitterParams &
+      Partial<z.infer<typeof tokenTextSplitterSchema>> & { logger?: Logger },
   ) {
     super();
 
@@ -42,6 +45,7 @@ export class TokenTextSplitter extends MetadataAwareTextSplitter {
     }
 
     this.#tokenizer = params?.tokenizer ?? Settings.tokenizer;
+    this.#logger = params?.logger ?? consoleLogger;
 
     const allSeparators = [this.separator, ...this.backupSeparators];
     this.#splitFns = allSeparators.map((sep) => splitBySep(sep));
@@ -65,7 +69,7 @@ export class TokenTextSplitter extends MetadataAwareTextSplitter {
           `Consider increasing the chunk size or decreasing the size of your metadata to avoid this.`,
       );
     } else if (effectiveChunkSize < 50) {
-      console.warn(
+      this.#logger.warn(
         `Metadata length (${metadataLength}) is close to chunk size (${this.chunkSize}). ` +
           `Resulting chunks are less than 50 tokens. Consider increasing the chunk size or decreasing the size of your metadata to avoid this.`,
       );
@@ -148,7 +152,7 @@ export class TokenTextSplitter extends MetadataAwareTextSplitter {
       const splitLength = this.tokenSize(split);
 
       if (splitLength > chunkSize) {
-        console.warn(
+        this.#logger.warn(
           `Got a split of size ${splitLength}, larger than chunk size ${chunkSize}.`,
         );
       }

packages/core/src/storage/doc-store/kv-document-store.ts

@@ -1,3 +1,4 @@
+import { consoleLogger, type Logger } from "@llamaindex/env";
 import { DEFAULT_NAMESPACE } from "../../global";
 import { BaseNode, ObjectType, type StoredValue } from "../../schema";
 import type { BaseKVStore } from "../kv-store";
@@ -16,13 +17,19 @@ export class KVDocumentStore extends BaseDocumentStore {
   private nodeCollection: string;
   private refDocCollection: string;
   private metadataCollection: string;
+  private logger: Logger;
 
-  constructor(kvstore: BaseKVStore, namespace: string = DEFAULT_NAMESPACE) {
+  constructor(
+    kvstore: BaseKVStore,
+    namespace: string = DEFAULT_NAMESPACE,
+    options?: { logger?: Logger },
+  ) {
     super();
     this.kvstore = kvstore;
     this.nodeCollection = `${namespace}/data`;
     this.refDocCollection = `${namespace}/ref_doc_info`;
     this.metadataCollection = `${namespace}/metadata`;
+    this.logger = options?.logger ?? consoleLogger;
   }
 
   async docs(): Promise<Record<string, BaseNode>> {
@@ -33,7 +40,7 @@ export class KVDocumentStore extends BaseDocumentStore {
       if (isValidDocJson(value)) {
         docs[key] = jsonToDoc(value, this.serializer);
       } else {
-        console.warn(`Invalid JSON for docId ${key}`);
+        this.logger.warn(`Invalid JSON for docId ${key}`);
       }
     }
     return docs;

packages/core/src/storage/index-store/index.ts

@@ -1,4 +1,4 @@
-import { path } from "@llamaindex/env";
+import { path, type Logger } from "@llamaindex/env";
 import { IndexStruct, jsonToIndexStruct } from "../../data-structs";
 import {
   DEFAULT_INDEX_STORE_PERSIST_FILENAME,
@@ -8,8 +8,8 @@ import {
 import {
   BaseInMemoryKVStore,
   BaseKVStore,
-  type DataType,
   SimpleKVStore,
+  type DataType,
 } from "../kv-store";
 
 export const DEFAULT_PERSIST_PATH = path.join(
@@ -84,16 +84,23 @@ export class SimpleIndexStore extends KVIndexStore {
 
   static async fromPersistDir(
     persistDir: string = DEFAULT_PERSIST_DIR,
+    options?: { logger?: Logger },
   ): Promise<SimpleIndexStore> {
     const persistPath = path.join(
       persistDir,
       DEFAULT_INDEX_STORE_PERSIST_FILENAME,
     );
-    return this.fromPersistPath(persistPath);
+    return this.fromPersistPath(persistPath, options);
   }
 
-  static async fromPersistPath(persistPath: string): Promise<SimpleIndexStore> {
-    const simpleKVStore = await SimpleKVStore.fromPersistPath(persistPath);
+  static async fromPersistPath(
+    persistPath: string,
+    options?: { logger?: Logger },
+  ): Promise<SimpleIndexStore> {
+    const simpleKVStore = await SimpleKVStore.fromPersistPath(
+      persistPath,
+      options,
+    );
     return new SimpleIndexStore(simpleKVStore);
   }
 

packages/core/src/storage/kv-store/index.ts

@@ -1,4 +1,4 @@
-import { fs, path } from "@llamaindex/env";
+import { consoleLogger, fs, path, type Logger } from "@llamaindex/env";
 
 import { DEFAULT_COLLECTION } from "../../global";
 import type { StoredValue } from "../../schema";
@@ -98,7 +98,11 @@ export class SimpleKVStore extends BaseKVStore {
     await fs.writeFile(persistPath, JSON.stringify(this.data));
   }
 
-  static async fromPersistPath(persistPath: string): Promise<SimpleKVStore> {
+  static async fromPersistPath(
+    persistPath: string,
+    options?: { logger?: Logger },
+  ): Promise<SimpleKVStore> {
+    const logger = options?.logger ?? consoleLogger;
     const dirPath = path.dirname(persistPath);
     if (!(await exists(dirPath))) {
       await fs.mkdir(dirPath, { recursive: true });
@@ -106,7 +110,7 @@ export class SimpleKVStore extends BaseKVStore {
 
     let data: DataType = {};
     if (!(await exists(persistPath))) {
-      console.info(`Starting new store from path: ${persistPath}`);
+      logger.log(`Starting new store from path: ${persistPath}`);
     } else {
       try {
         const fileData = await fs.readFile(persistPath);

packages/core/src/tools/function-tool.ts

@@ -1,6 +1,6 @@
+import { consoleLogger, type Logger } from "@llamaindex/env";
 import type { JSONSchemaType } from "ajv";
-import { z } from "zod";
-import { zodToJsonSchema } from "zod-to-json-schema";
+import * as z from "zod/v4";
 import type { JSONValue } from "../global";
 import type { BaseTool, ToolMetadata } from "../llms";
 
@@ -14,11 +14,13 @@ export class FunctionTool<
   #additionalArg: AdditionalToolArgument | undefined;
   readonly #metadata: ToolMetadata<JSONSchemaType<T>>;
   readonly #zodType: z.ZodType<T> | null = null;
+  readonly #logger: Logger;
   constructor(
     fn: (input: T, additionalArg?: AdditionalToolArgument) => R,
     metadata: ToolMetadata<JSONSchemaType<T>>,
     zodType?: z.ZodType<T>,
     additionalArg?: AdditionalToolArgument,
+    logger?: Logger,
   ) {
     this.#fn = fn;
     this.#metadata = metadata;
@@ -26,6 +28,7 @@ export class FunctionTool<
       this.#zodType = zodType;
     }
     this.#additionalArg = additionalArg;
+    this.#logger = logger ?? consoleLogger;
   }
 
   static from<T, AdditionalToolArgument extends object = object>(
@@ -90,8 +93,8 @@ export class FunctionTool<
     ) {
       const { execute, parameters, ...restConfig } = fnOrConfig;
 
-      if (parameters instanceof z.ZodSchema) {
-        const jsonSchema = zodToJsonSchema(parameters);
+      if (parameters instanceof z.ZodType) {
+        const jsonSchema = z.toJSONSchema(parameters);
         return new FunctionTool(
           execute,
           {
@@ -106,8 +109,8 @@ export class FunctionTool<
     }
 
     // Handle the original cases
-    if (schema && schema.parameters instanceof z.ZodSchema) {
-      const jsonSchema = zodToJsonSchema(schema.parameters);
+    if (schema && schema.parameters instanceof z.ZodType) {
+      const jsonSchema = z.toJSONSchema(schema.parameters);
       return new FunctionTool(
         fnOrConfig,
         {
@@ -140,7 +143,7 @@ export class FunctionTool<
       if (result.success) {
         params = result.data;
       } else {
-        console.warn(result.error.errors);
+        this.#logger.warn(result.error.errors);
       }
     }
     return this.#fn.call(null, params, this.#additionalArg);

packages/core/tests/tools.test.ts

@@ -1,6 +1,6 @@
 import { FunctionTool, tool } from "@llamaindex/core/tools";
 import { describe, expect, test, vi } from "vitest";
-import { z } from "zod";
+import * as z from "zod/v4";
 
 describe("FunctionTool", () => {
   test("type system", () => {
@@ -37,9 +37,7 @@ describe("FunctionTool", () => {
       name: "saveFile",
       description: "Save the content into a file",
       parameters: z.object({
-        content: z.string({
-          description: "The content to save into a file",
-        }),
+        content: z.string({}).describe("The content to save into a file"),
       }),
       execute: mockExecute,
     };

packages/experimental/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @llamaindex/experimental
 
+## 0.0.203
+
+### Patch Changes
+
+- llamaindex@0.11.26
+
+## 0.0.202
+
+### Patch Changes
+
+- Updated dependencies [049471b]
+  - llamaindex@0.11.25
+
+## 0.0.201
+
+### Patch Changes
+
+- llamaindex@0.11.24
+
 ## 0.0.200
 
 ### Patch Changes

packages/experimental/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/experimental",
   "description": "Experimental package for LlamaIndexTS",
-  "version": "0.0.200",
+  "version": "0.0.203",
   "type": "module",
   "types": "dist/type/index.d.ts",
   "main": "dist/cjs/index.js",

packages/llamaindex/CHANGELOG.md

@@ -1,5 +1,31 @@
 # llamaindex
 
+## 0.11.26
+
+### Patch Changes
+
+- Updated dependencies [4b51791]
+  - @llamaindex/cloud@4.1.1
+
+## 0.11.25
+
+### Patch Changes
+
+- 049471b: Moved LlamaCloudFileService, LlamaCloudIndex and LlamaCloudRetriever to llama-cloud-services
+- Updated dependencies [049471b]
+  - @llamaindex/cloud@4.1.0
+
+## 0.11.24
+
+### Patch Changes
+
+- Updated dependencies [c3bf3c7]
+- Updated dependencies [f9f1de9]
+  - @llamaindex/cloud@4.0.28
+  - @llamaindex/core@0.6.19
+  - @llamaindex/node-parser@2.0.19
+  - @llamaindex/workflow@1.1.20
+
 ## 0.11.23
 
 ### Patch Changes

packages/llamaindex/package.json

@@ -1,6 +1,6 @@
 {
   "name": "llamaindex",
-  "version": "0.11.23",
+  "version": "0.11.26",
   "license": "MIT",
   "type": "module",
   "keywords": [

packages/llamaindex/src/cloud/index.ts

@@ -1,3 +1,9 @@
+console.warn(`
+The classes LlamaCloudFileService, LlamaCloudIndex and LlamaCloudRetriever have been moved to the package llama-cloud-services.
+ * Please migrate your imports to llama-cloud-services, e.g. import { LlamaCloudIndex } from "llama-cloud-services";
+ * See the documentation: https://docs.cloud.llamaindex.ai
+`);
+
 export { LLamaCloudFileService } from "./LLamaCloudFileService.js";
 export { LlamaCloudIndex } from "./LlamaCloudIndex.js";
 export {

packages/llamaindex/src/storage/docStore/SimpleDocumentStore.ts

@@ -8,7 +8,7 @@ import {
   BaseInMemoryKVStore,
   SimpleKVStore,
 } from "@llamaindex/core/storage/kv-store";
-import { path } from "@llamaindex/env";
+import { path, type Logger } from "@llamaindex/env";
 import _ from "lodash";
 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -27,19 +27,28 @@ export class SimpleDocumentStore extends KVDocumentStore {
   static async fromPersistDir(
     persistDir: string = DEFAULT_PERSIST_DIR,
     namespace?: string,
+    options?: { logger?: Logger },
   ): Promise<SimpleDocumentStore> {
     const persistPath = path.join(
       persistDir,
       DEFAULT_DOC_STORE_PERSIST_FILENAME,
     );
-    return await SimpleDocumentStore.fromPersistPath(persistPath, namespace);
+    return await SimpleDocumentStore.fromPersistPath(
+      persistPath,
+      namespace,
+      options,
+    );
   }
 
   static async fromPersistPath(
     persistPath: string,
     namespace?: string,
+    options?: { logger?: Logger },
   ): Promise<SimpleDocumentStore> {
-    const simpleKVStore = await SimpleKVStore.fromPersistPath(persistPath);
+    const simpleKVStore = await SimpleKVStore.fromPersistPath(
+      persistPath,
+      options,
+    );
     return new SimpleDocumentStore(simpleKVStore, namespace);
   }
 

packages/llamaindex/src/vector-store/SimpleVectorStore.ts

@@ -18,7 +18,7 @@ import {
   type VectorStoreQuery,
   type VectorStoreQueryResult,
 } from "@llamaindex/core/vector-store";
-import { fs, path } from "@llamaindex/env";
+import { consoleLogger, fs, path, type Logger } from "@llamaindex/env";
 import { exists } from "../storage/FileSystem.js";
 
 const LEARNER_MODES = new Set<VectorStoreQueryMode>([
@@ -139,9 +139,14 @@ export class SimpleVectorStore extends BaseVectorStore {
   static async fromPersistDir(
     persistDir: string = DEFAULT_PERSIST_DIR,
     embedModel?: BaseEmbedding,
+    options?: { logger?: Logger },
   ): Promise<SimpleVectorStore> {
     const persistPath = path.join(persistDir, "vector_store.json");
-    return await SimpleVectorStore.fromPersistPath(persistPath, embedModel);
+    return await SimpleVectorStore.fromPersistPath(
+      persistPath,
+      embedModel,
+      options,
+    );
   }
 
   client() {
@@ -273,7 +278,9 @@ export class SimpleVectorStore extends BaseVectorStore {
   static async fromPersistPath(
     persistPath: string,
     embedModel?: BaseEmbedding,
+    options?: { logger?: Logger },
   ): Promise<SimpleVectorStore> {
+    const logger = options?.logger ?? consoleLogger;
     const dirPath = path.dirname(persistPath);
     if (!(await exists(dirPath))) {
       await fs.mkdir(dirPath, { recursive: true });
@@ -281,7 +288,7 @@ export class SimpleVectorStore extends BaseVectorStore {
 
     let dataDict: Record<string, unknown> = {};
     if (!(await exists(persistPath))) {
-      console.info(`Starting new store from path: ${persistPath}`);
+      logger.log(`Starting new store from path: ${persistPath}`);
     } else {
       try {
         const fileData = await fs.readFile(persistPath);

packages/llamaindex/tests/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @llamaindex/core-test
 
+## 0.1.17
+
+### Patch Changes
+
+- Updated dependencies [4c70376]
+  - @llamaindex/openai@0.4.16
+
+## 0.1.16
+
+### Patch Changes
+
+- Updated dependencies [b6409b6]
+  - @llamaindex/openai@0.4.15
+
+## 0.1.15
+
+### Patch Changes
+
+- @llamaindex/openai@0.4.14
+
 ## 0.1.14
 
 ### Patch Changes

packages/llamaindex/tests/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/llamaindex-test",
   "private": true,
-  "version": "0.1.14",
+  "version": "0.1.17",
   "type": "module",
   "scripts": {
     "test": "vitest run"

packages/llamaindex/tests/storage/StorageContext.test.ts

@@ -47,22 +47,31 @@ describe("StorageContext", () => {
 
   test("persists and loads", async () => {
     const doc = new Document({ text: "test document" });
-    const consoleInfoSpy = vi
-      .spyOn(console, "info")
-      .mockImplementation(() => {});
+    // Create a Logger that spies on log (info) calls
+    const spyLogger = {
+      log: vi.fn(),
+      error: vi.fn(),
+      warn: vi.fn(),
+    };
 
     // storage context from individual stores
     const storageContext = await storageContextFromDefaults({
-      docStore: await SimpleDocumentStore.fromPersistDir(testDir),
-      vectorStore: await SimpleVectorStore.fromPersistDir(testDir),
-      indexStore: await SimpleIndexStore.fromPersistDir(testDir),
+      docStore: await SimpleDocumentStore.fromPersistDir(testDir, undefined, {
+        logger: spyLogger,
+      }),
+      vectorStore: await SimpleVectorStore.fromPersistDir(testDir, undefined, {
+        logger: spyLogger,
+      }),
+      indexStore: await SimpleIndexStore.fromPersistDir(testDir, {
+        logger: spyLogger,
+      }),
     });
 
     const index = await VectorStoreIndex.fromDocuments([doc], {
       storageContext,
     });
-    expect(consoleInfoSpy).toHaveBeenCalledTimes(3);
-    expect(consoleInfoSpy).toHaveBeenCalledWith(
+    expect(spyLogger.log).toHaveBeenCalledTimes(3);
+    expect(spyLogger.log).toHaveBeenCalledWith(
       expect.stringContaining("Starting new store"),
     );
     expect(index).toBeDefined();
@@ -75,13 +84,19 @@ describe("StorageContext", () => {
     // Check that the test data files exist
     await expectTestDataFilesExist(testDir);
 
-    consoleInfoSpy.mockClear();
+    spyLogger.log.mockClear();
 
     // Now, load it again. Since data was persisted, we should not see the error.
     const newStorageContext = await storageContextFromDefaults({
-      docStore: await SimpleDocumentStore.fromPersistDir(testDir),
-      vectorStore: await SimpleVectorStore.fromPersistDir(testDir),
-      indexStore: await SimpleIndexStore.fromPersistDir(testDir),
+      docStore: await SimpleDocumentStore.fromPersistDir(testDir, undefined, {
+        logger: spyLogger,
+      }),
+      vectorStore: await SimpleVectorStore.fromPersistDir(testDir, undefined, {
+        logger: spyLogger,
+      }),
+      indexStore: await SimpleIndexStore.fromPersistDir(testDir, {
+        logger: spyLogger,
+      }),
     });
 
     const loadedIndex = await VectorStoreIndex.init({
@@ -94,9 +109,7 @@ describe("StorageContext", () => {
 
     await expectTestDataFilesExist(testDir);
 
-    expect(consoleInfoSpy).not.toHaveBeenCalled();
-
-    consoleInfoSpy.mockRestore();
+    expect(spyLogger.log).not.toHaveBeenCalled();
   });
 
   test("throws error on corrupted data", async () => {

packages/node-parser/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @llamaindex/node-parser
 
+## 2.0.19
+
+### Patch Changes
+
+- Updated dependencies [f9f1de9]
+  - @llamaindex/core@0.6.19
+
 ## 2.0.18
 
 ### Patch Changes

packages/node-parser/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/node-parser",
-  "version": "2.0.18",
+  "version": "2.0.19",
   "description": "Node parser for LlamaIndex",
   "type": "module",
   "exports": {

packages/providers/anthropic/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @llamaindex/anthropic
 
+## 0.3.22
+
+### Patch Changes
+
+- b80f33e: Fix: prompt caching (moved from beta)
+- b80f33e: Feat: add claude opus 4.1
+
+## 0.3.21
+
+### Patch Changes
+
+- Updated dependencies [f9f1de9]
+  - @llamaindex/core@0.6.19
+
 ## 0.3.20
 
 ### Patch Changes

packages/providers/anthropic/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/anthropic",
   "description": "Anthropic Adapter for LlamaIndex",
-  "version": "0.3.20",
+  "version": "0.3.22",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -28,19 +28,20 @@
   "scripts": {
     "build": "bunchee",
     "dev": "bunchee --watch",
-    "test": "vitest run"
+    "test": "vitest run",
+    "type-check": "tsc -b --diagnostics"
   },
   "devDependencies": {
-    "vitest": "^2.1.5",
     "@llamaindex/core": "workspace:*",
-    "@llamaindex/env": "workspace:*"
+    "@llamaindex/env": "workspace:*",
+    "vitest": "^2.1.5"
   },
   "peerDependencies": {
     "@llamaindex/core": "workspace:*",
     "@llamaindex/env": "workspace:*"
   },
   "dependencies": {
-    "@anthropic-ai/sdk": "0.37.0",
+    "@anthropic-ai/sdk": "0.58.0",
     "remeda": "^2.17.3"
   }
 }

packages/providers/anthropic/src/llm.ts

@@ -1,15 +1,16 @@
 import type { ClientOptions } from "@anthropic-ai/sdk";
 import { Anthropic as SDKAnthropic } from "@anthropic-ai/sdk";
 import type {
-  BetaCacheControlEphemeral,
-  BetaTextBlockParam,
-} from "@anthropic-ai/sdk/resources/beta/index";
-import type { TextBlock } from "@anthropic-ai/sdk/resources/index";
+  CacheControlEphemeral,
+  Message,
+  TextBlock,
+} from "@anthropic-ai/sdk/resources/index";
 import type {
   MessageCreateParams,
   MessageCreateParamsBase,
   MessageParam,
   Model,
+  TextBlockParam,
   ThinkingBlock,
   Tool,
   ToolUseBlock,
@@ -116,7 +117,15 @@ export const ALL_AVAILABLE_V4_MODELS = {
   "claude-4-0-sonnet": { contextWindow: 200000 },
   "claude-4-sonnet-20240514": { contextWindow: 200000 },
   "claude-4-0-opus": { contextWindow: 200000 },
+  "claude-4-1-opus": { contextWindow: 200000 },
   "claude-4-opus-20240514": { contextWindow: 200000 },
+  "claude-sonnet-4-0": { contextWindow: 200000 },
+  "claude-sonnet-4-20250514": { contextWindow: 200000 },
+  "claude-opus-4-0": { contextWindow: 200000 },
+  "claude-opus-4-20250514": { contextWindow: 200000 },
+  "claude-4-sonnet-20250514": { contextWindow: 200000 },
+  "claude-4-opus-20250514": { contextWindow: 200000 },
+  "claude-opus-4-1-20250805": { contextWindow: 200000 },
 };
 
 export const ALL_AVAILABLE_ANTHROPIC_MODELS = {
@@ -137,6 +146,7 @@ const AVAILABLE_ANTHROPIC_MODELS_WITHOUT_DATE: { [key: string]: string } = {
   "claude-3-7-sonnet": "claude-3-7-sonnet-20250219",
   "claude-4-0-sonnet": "claude-sonnet-4-20250514",
   "claude-4-0-opus": "claude-opus-4-20250514",
+  "claude-4-1-opus": "claude-opus-4-1-20250805",
 } as { [key in keyof typeof ALL_AVAILABLE_ANTHROPIC_MODELS]: string };
 
 export type AnthropicAdditionalChatOptions = Pick<
@@ -144,7 +154,7 @@ export type AnthropicAdditionalChatOptions = Pick<
   "thinking"
 >;
 export type AnthropicToolCallLLMMessageOptions = ToolCallLLMMessageOptions & {
-  cache_control?: BetaCacheControlEphemeral | null;
+  cache_control?: CacheControlEphemeral | null;
   thinking?: string | undefined;
   thinking_signature?: string | undefined;
 };
@@ -462,20 +472,20 @@ export class Anthropic extends ToolCallLLM<
     const { messages, stream, tools } = params;
 
     // Handle system messages
-    let systemPrompt: string | BetaTextBlockParam[] | null = null;
+    let systemPrompt: string | TextBlockParam[] | null = null;
     const systemMessages = messages.filter(
       (message) => message.role === "system",
     );
 
     if (systemMessages.length > 0) {
-      systemPrompt = systemMessages.map((message): BetaTextBlockParam => {
+      systemPrompt = systemMessages.map((message): TextBlockParam => {
         const textContent = extractText(message.content);
         if (message.options && "cache_control" in message.options) {
           return {
             type: "text" as const,
             text: textContent,
             cache_control: message.options
-              .cache_control as BetaCacheControlEphemeral,
+              .cache_control as CacheControlEphemeral,
           };
         }
         return {
@@ -485,17 +495,9 @@ export class Anthropic extends ToolCallLLM<
       });
     }
 
-    const beta =
-      Array.isArray(systemPrompt) &&
-      systemPrompt.some((message) => "cache_control" in message);
+    const anthropic = this.session.anthropic;
 
-    let anthropic = this.session.anthropic;
-    if (beta) {
-      // @ts-expect-error type casting
-      anthropic = anthropic.beta.promptCaching;
-    }
-
-    const apiParams: MessageCreateParams = {
+    const apiParams: MessageCreateParamsBase = {
       model: this.getModelName(this.model),
       messages: this.mergeConsecutiveMessages(
         this.formatMessages(messages.filter((m) => m.role !== "system")),
@@ -521,7 +523,7 @@ export class Anthropic extends ToolCallLLM<
       return this.streamChat(anthropic, apiParams);
     }
 
-    const response = await anthropic.messages.create(apiParams);
+    const response = (await anthropic.messages.create(apiParams)) as Message;
 
     const thinkingBlock = response.content.find(
       (content): content is ThinkingBlock => content.type === "thinking",

packages/providers/assemblyai/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @llamaindex/assemblyai
 
+## 0.1.18
+
+### Patch Changes
+
+- Updated dependencies [f9f1de9]
+  - @llamaindex/core@0.6.19
+
 ## 0.1.17
 
 ### Patch Changes

packages/providers/assemblyai/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/assemblyai",
   "description": "AssemblyAI Reader for LlamaIndex",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "type": "module",
   "types": "dist/index.d.ts",
   "main": "dist/index.cjs",

packages/providers/aws/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @llamaindex/community
 
+## 0.0.115
+
+### Patch Changes
+
+- Updated dependencies [f9f1de9]
+  - @llamaindex/core@0.6.19
+
 ## 0.0.114
 
 ### Patch Changes

packages/providers/aws/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/aws",
   "description": "AWS package for LlamaIndexTS",
-  "version": "0.0.114",
+  "version": "0.0.115",
   "type": "module",
   "types": "dist/type/index.d.ts",
   "main": "dist/cjs/index.js",

packages/providers/clip/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @llamaindex/clip
 
+## 0.0.72
+
+### Patch Changes
+
+- Updated dependencies [4c70376]
+  - @llamaindex/openai@0.4.16
+
+## 0.0.71
+
+### Patch Changes
+
+- Updated dependencies [b6409b6]
+  - @llamaindex/openai@0.4.15
+
+## 0.0.70
+
+### Patch Changes
+
+- Updated dependencies [f9f1de9]
+  - @llamaindex/core@0.6.19
+  - @llamaindex/openai@0.4.14
+
 ## 0.0.69
 
 ### Patch Changes

packages/providers/clip/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/clip",
   "description": "Clip Embedding Adapter for LlamaIndex",
-  "version": "0.0.69",
+  "version": "0.0.72",
   "type": "module",
   "types": "dist/index.d.ts",
   "main": "dist/index.cjs",

packages/providers/cohere/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @llamaindex/cohere
 
+## 0.0.33
+
+### Patch Changes
+
+- Updated dependencies [f9f1de9]
+  - @llamaindex/core@0.6.19
+
 ## 0.0.32
 
 ### Patch Changes

packages/providers/cohere/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/cohere",
   "description": "Cohere Adapter for LlamaIndex",
-  "version": "0.0.32",
+  "version": "0.0.33",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",

packages/providers/deepinfra/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @llamaindex/deepinfra
 
+## 0.0.72
+
+### Patch Changes
+
+- Updated dependencies [4c70376]
+  - @llamaindex/openai@0.4.16
+
+## 0.0.71
+
+### Patch Changes
+
+- Updated dependencies [b6409b6]
+  - @llamaindex/openai@0.4.15
+
+## 0.0.70
+
+### Patch Changes
+
+- Updated dependencies [f9f1de9]
+  - @llamaindex/core@0.6.19
+  - @llamaindex/openai@0.4.14
+
 ## 0.0.69
 
 ### Patch Changes