Release 0.11.28 (#2174)

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

apps/next/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @llamaindex/doc
 
+## 0.2.53
+
+### Patch Changes
+
+- Updated dependencies [1995b38]
+- Updated dependencies [001a515]
+- Updated dependencies [9d7d205]
+  - @llamaindex/workflow@1.1.22
+  - @llamaindex/openai@0.4.18
+  - llamaindex@0.11.28
+
 ## 0.2.52
 
 ### Patch Changes

apps/next/package.json

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

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

@@ -0,0 +1,47 @@
+---
+title: Custom Model Per Request 
+---
+
+There are scenarios, such as the case of a multi-tenant backend API, where it may be required to handle each request with a custom model.
+
+In such a scenario, modifying the `Settings` object directly as follows is not recommended:
+
+```typescript
+import { Settings } from 'llamaindex';
+import { OpenAIEmbedding } from '@llamaindex/embeddings-openai';
+
+Settings.embedModel = new OpenAIEmbedding({ apiKey: 'CLIENT_API_KEY' });
+Settings.llm = openai({ apiKey: key,  model: 'gpt-4o' })
+```
+
+Setting `llm` and `embedModel` directly will lead to unpredictable responses, since `Settings` is global and mutable.
+This can lead to race conditions, as each request modifies `Settings.embedModel` or `Settings.llm`.
+
+The recommended approach is to use `Settings.withEmbedModel` or `Settings.withLLM` as follows:
+
+```typescript
+const embedModel = new OpenAIEmbedding({
+  apiKey: process.env.OPENAI_API_KEY,
+});
+const llm = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
+
+const llmResponse = await Settings.withEmbedModel(embedModel, async () => {
+  return Settings.withLLM(llm, async () => {
+    const path = "node_modules/llamaindex/examples/abramov.txt";
+    const essay = await fs.readFile(path, "utf-8");
+    // Create Document object with essay
+    const document = new Document({ text: essay, id_: path });
+    // Split text and create embeddings. Store them in a VectorStoreIndex
+    const index = await VectorStoreIndex.fromDocuments([document]);
+    // Query the index
+    const queryEngine = index.asQueryEngine();
+    const { message, sourceNodes } = await queryEngine.query({
+      query: "What did the author do in college?",
+    });
+    // Return response with sources
+    return message.content;
+  });
+});
+```
+
+The full example can be found [here](https://github.com/run-llama/LlamaIndexTS/tree/main/examples/local-settings).

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

@@ -7,6 +7,7 @@
     "workflows",
     "local_llm",
     "chatbot",
-    "structured_data_extraction"
+    "structured_data_extraction",
+    "custom_model_per_request"
   ]
 }

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

@@ -1,5 +1,11 @@
 # @llamaindex/cloudflare-worker-agent-test
 
+## 0.0.189
+
+### Patch Changes
+
+- llamaindex@0.11.28
+
 ## 0.0.188
 
 ### Patch Changes

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

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

e2e/examples/nextjs-agent/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @llamaindex/next-agent-test
 
+## 0.1.189
+
+### Patch Changes
+
+- llamaindex@0.11.28
+
 ## 0.1.188
 
 ### Patch Changes

e2e/examples/nextjs-agent/package.json

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

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

@@ -1,5 +1,11 @@
 # test-edge-runtime
 
+## 0.1.188
+
+### Patch Changes
+
+- llamaindex@0.11.28
+
 ## 0.1.187
 
 ### Patch Changes

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

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

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

@@ -1,5 +1,12 @@
 # @llamaindex/next-node-runtime
 
+## 0.1.60
+
+### Patch Changes
+
+- llamaindex@0.11.28
+- @llamaindex/huggingface@0.1.28
+
 ## 0.1.59
 
 ### Patch Changes

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

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

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

@@ -1,5 +1,11 @@
 # vite-import-llamaindex
 
+## 0.0.55
+
+### Patch Changes
+
+- llamaindex@0.11.28
+
 ## 0.0.54
 
 ### Patch Changes

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

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

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

@@ -1,5 +1,11 @@
 # @llamaindex/waku-query-engine-test
 
+## 0.0.189
+
+### Patch Changes
+
+- llamaindex@0.11.28
+
 ## 0.0.188
 
 ### Patch Changes

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

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

examples/CHANGELOG.md

@@ -1,5 +1,28 @@
 # examples
 
+## 0.3.40
+
+### Patch Changes
+
+- Updated dependencies [1995b38]
+- Updated dependencies [001a515]
+- Updated dependencies [9d7d205]
+  - @llamaindex/workflow@1.1.22
+  - @llamaindex/openai@0.4.18
+  - llamaindex@0.11.28
+  - @llamaindex/clip@0.0.74
+  - @llamaindex/deepinfra@0.0.74
+  - @llamaindex/deepseek@0.0.36
+  - @llamaindex/fireworks@0.0.34
+  - @llamaindex/groq@0.0.90
+  - @llamaindex/huggingface@0.1.28
+  - @llamaindex/jinaai@0.0.34
+  - @llamaindex/perplexity@0.0.31
+  - @llamaindex/azure@0.1.35
+  - @llamaindex/together@0.0.34
+  - @llamaindex/vllm@0.0.60
+  - @llamaindex/xai@0.0.21
+
 ## 0.3.39
 
 ### Patch Changes

examples/agents/workflow/joke.ts

@@ -22,7 +22,7 @@ const { withState, getContext } = createStatefulMiddleware(() => ({
 const jokeFlow = withState(createWorkflow());
 
 // Define handlers for each step
-jokeFlow.handle([startEvent], async (event) => {
+jokeFlow.handle([startEvent], async (context, event) => {
   // Prompt the LLM to write a joke
   const prompt = `Write your best joke about ${event.data}. Write the joke between <joke> and </joke> tags.`;
   const response = await llm.complete({ prompt });
@@ -34,7 +34,7 @@ jokeFlow.handle([startEvent], async (event) => {
   return jokeEvent.with({ joke: joke });
 });
 
-jokeFlow.handle([jokeEvent], async (event) => {
+jokeFlow.handle([jokeEvent], async (context, event) => {
   // Prompt the LLM to critique the joke
   const prompt = `Give a thorough critique of the following joke. If the joke needs improvement, put "IMPROVE" somewhere in the critique: ${event.data.joke}`;
   const response = await llm.complete({ prompt });
@@ -50,9 +50,9 @@ jokeFlow.handle([jokeEvent], async (event) => {
   return resultEvent.with({ joke: event.data.joke, critique: response.text });
 });
 
-jokeFlow.handle([critiqueEvent], async (event) => {
+jokeFlow.handle([critiqueEvent], async (context, event) => {
   // Keep track of the number of iterations
-  const state = getContext().state;
+  const state = context.state;
   state.numIterations++;
 
   // Write a new joke based on the previous joke and critique

examples/local-settings/local-settings.ts

@@ -0,0 +1,69 @@
+import { OpenAI, OpenAIEmbedding } from "@llamaindex/openai";
+import express, { Request, Response } from "express";
+import fs from "fs/promises";
+import { Document, Settings, VectorStoreIndex } from "llamaindex";
+
+const app = express();
+const port = 3000;
+
+app.get("/default", async (req: Request, res: Response) => {
+  const embedModel = new OpenAIEmbedding({
+    apiKey: process.env.OPENAI_API_KEY,
+  });
+  const llm = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
+
+  const llmResponse = await Settings.withEmbedModel(embedModel, async () => {
+    return Settings.withLLM(llm, async () => {
+      const path = "node_modules/llamaindex/examples/abramov.txt";
+      const essay = await fs.readFile(path, "utf-8");
+      // Create Document object with essay
+      const document = new Document({ text: essay, id_: path });
+      // Split text and create embeddings. Store them in a VectorStoreIndex
+      const index = await VectorStoreIndex.fromDocuments([document]);
+      // Query the index
+      const queryEngine = index.asQueryEngine();
+      const { message, sourceNodes } = await queryEngine.query({
+        query: "What did the author do in college?",
+      });
+      // Return response with sources
+      return message.content;
+    });
+  });
+  // res.send(message.content)
+  res.send(llmResponse);
+});
+
+app.get("/custom", async (req: Request, res: Response) => {
+  const embedModel = new OpenAIEmbedding({
+    apiKey: process.env.OPENAI_API_KEY,
+    model: "text-embedding-3-small",
+  });
+  const llm = new OpenAI({
+    apiKey: process.env.OPENAI_API_KEY,
+    model: "gpt-3.5-turbo",
+  });
+
+  const llmResponse = await Settings.withEmbedModel(embedModel, async () => {
+    return Settings.withLLM(llm, async () => {
+      const path = "node_modules/llamaindex/examples/abramov.txt";
+      const essay = await fs.readFile(path, "utf-8");
+      // Create Document object with essay
+      const document = new Document({ text: essay, id_: path });
+      // Split text and create embeddings. Store them in a VectorStoreIndex
+      const index = await VectorStoreIndex.fromDocuments([document]);
+      // Query the index
+      const queryEngine = index.asQueryEngine();
+      const { message, sourceNodes } = await queryEngine.query({
+        query: "What did the author do in college?",
+      });
+      // Return response with sources
+      return message.content;
+    });
+  });
+  // res.send(message.content)
+  res.send(llmResponse);
+});
+
+app.listen(port, () => {
+  console.log(`Example app listening on port ${port}`);
+});

examples/local-settings/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "local-settings",
+  "version": "1.0.0",
+  "main": "index.js",
+  "private": "true",
+  "scripts": {
+    "test": "echo \"No tests for example package\""
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "description": "",
+  "devDependencies": {
+    "@types/express": "^5.0.3",
+    "typescript": "^5.9.2"
+  },
+  "dependencies": {
+    "@llamaindex/openai": "^0.4.16",
+    "express": "^5.1.0",
+    "llamaindex": "^0.11.26"
+  }
+}

examples/local-settings/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "moduleResolution": "node",
+    "types": ["node", "express"]
+  },
+  "include": ["*.ts"]
+}

examples/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/examples",
-  "version": "0.3.39",
+  "version": "0.3.40",
   "private": true,
   "scripts": {
     "lint": "eslint .",
@@ -14,24 +14,24 @@
     "@llamaindex/anthropic": "^0.3.23",
     "@llamaindex/assemblyai": "^0.1.19",
     "@llamaindex/astra": "^0.0.34",
-    "@llamaindex/azure": "^0.1.34",
+    "@llamaindex/azure": "^0.1.35",
     "@llamaindex/bm25-retriever": "^0.0.9",
     "@llamaindex/chroma": "^0.0.34",
-    "@llamaindex/clip": "^0.0.73",
+    "@llamaindex/clip": "^0.0.74",
     "@llamaindex/cloud": "^4.1.2",
     "@llamaindex/cohere": "^0.0.34",
     "@llamaindex/core": "^0.6.20",
-    "@llamaindex/deepinfra": "^0.0.73",
+    "@llamaindex/deepinfra": "^0.0.74",
-    "@llamaindex/deepseek": "^0.0.35",
+    "@llamaindex/deepseek": "^0.0.36",
     "@llamaindex/discord": "^0.1.19",
     "@llamaindex/elastic-search": "^0.1.20",
     "@llamaindex/env": "^0.1.30",
     "@llamaindex/firestore": "^1.0.27",
-    "@llamaindex/fireworks": "^0.0.33",
+    "@llamaindex/fireworks": "^0.0.34",
     "@llamaindex/google": "^0.3.20",
-    "@llamaindex/groq": "^0.0.89",
+    "@llamaindex/groq": "^0.0.90",
-    "@llamaindex/huggingface": "^0.1.27",
+    "@llamaindex/huggingface": "^0.1.28",
-    "@llamaindex/jinaai": "^0.0.33",
+    "@llamaindex/jinaai": "^0.0.34",
     "@llamaindex/milvus": "^0.1.29",
     "@llamaindex/mistral": "^0.1.20",
     "@llamaindex/mixedbread": "^0.0.34",
@@ -39,8 +39,8 @@
     "@llamaindex/node-parser": "^2.0.20",
     "@llamaindex/notion": "^0.1.19",
     "@llamaindex/ollama": "^0.1.21",
-    "@llamaindex/openai": "^0.4.17",
+    "@llamaindex/openai": "^0.4.18",
-    "@llamaindex/perplexity": "^0.0.30",
+    "@llamaindex/perplexity": "^0.0.31",
     "@llamaindex/pinecone": "^0.1.20",
     "@llamaindex/portkey-ai": "^0.0.62",
     "@llamaindex/postgres": "^0.0.63",
@@ -48,15 +48,15 @@
     "@llamaindex/readers": "^3.1.19",
     "@llamaindex/replicate": "^0.0.62",
     "@llamaindex/supabase": "^0.1.21",
-    "@llamaindex/together": "^0.0.33",
+    "@llamaindex/together": "^0.0.34",
     "@llamaindex/tools": "^0.1.10",
     "@llamaindex/upstash": "^0.0.34",
     "@llamaindex/vercel": "^0.1.20",
-    "@llamaindex/vllm": "^0.0.59",
+    "@llamaindex/vllm": "^0.0.60",
     "@llamaindex/voyage-ai": "^1.0.26",
     "@llamaindex/weaviate": "^0.0.35",
-    "@llamaindex/workflow": "^1.1.21",
+    "@llamaindex/workflow": "^1.1.22",
-    "@llamaindex/xai": "^0.0.20",
+    "@llamaindex/xai": "^0.0.21",
     "@notionhq/client": "^4.0.0",
     "@pinecone-database/pinecone": "^4.0.0",
     "@vercel/postgres": "^0.10.0",
@@ -65,13 +65,14 @@
     "commander": "^12.1.0",
     "dotenv": "^17.2.0",
     "js-tiktoken": "^1.0.14",
-    "llamaindex": "^0.11.27",
+    "llamaindex": "^0.11.28",
     "mongodb": "6.7.0",
     "postgres": "^3.4.4",
     "wikipedia": "^2.1.2",
     "zod": "^3.25.76"
   },
   "devDependencies": {
+    "@types/express": "^5.0.3",
     "@types/node": "^24.0.13",
     "tsx": "^4.20.3",
     "typescript": "^5.8.3"

packages/autotool/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @llamaindex/autotool
 
+## 8.0.28
+
+### Patch Changes
+
+- llamaindex@0.11.28
+
 ## 8.0.27
 
 ### Patch Changes

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

@@ -1,5 +1,12 @@
 # @llamaindex/autotool-01-node-example
 
+## 0.0.136
+
+### Patch Changes
+
+- llamaindex@0.11.28
+- @llamaindex/autotool@8.0.28
+
 ## 0.0.135
 
 ### 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.135"
+  "version": "0.0.136"
 }

packages/autotool/package.json

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

packages/experimental/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @llamaindex/experimental
 
+## 0.0.205
+
+### Patch Changes
+
+- llamaindex@0.11.28
+
 ## 0.0.204
 
 ### Patch Changes

packages/experimental/package.json

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

packages/llamaindex/CHANGELOG.md

@@ -1,5 +1,12 @@
 # llamaindex
 
+## 0.11.28
+
+### Patch Changes
+
+- Updated dependencies [1995b38]
+  - @llamaindex/workflow@1.1.22
+
 ## 0.11.27
 
 ### Patch Changes

packages/llamaindex/package.json

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

packages/llamaindex/tests/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @llamaindex/core-test
 
+## 0.1.19
+
+### Patch Changes
+
+- Updated dependencies [001a515]
+- Updated dependencies [9d7d205]
+  - @llamaindex/openai@0.4.18
+
 ## 0.1.18
 
 ### Patch Changes

packages/llamaindex/tests/package.json

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

packages/providers/clip/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @llamaindex/clip
 
+## 0.0.74
+
+### Patch Changes
+
+- Updated dependencies [001a515]
+- Updated dependencies [9d7d205]
+  - @llamaindex/openai@0.4.18
+
 ## 0.0.73
 
 ### Patch Changes

packages/providers/clip/package.json

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

packages/providers/deepinfra/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @llamaindex/deepinfra
 
+## 0.0.74
+
+### Patch Changes
+
+- Updated dependencies [001a515]
+- Updated dependencies [9d7d205]
+  - @llamaindex/openai@0.4.18
+
 ## 0.0.73
 
 ### Patch Changes

packages/providers/deepinfra/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/deepinfra",
   "description": "Deepinfra Adapter for LlamaIndex",
-  "version": "0.0.73",
+  "version": "0.0.74",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",

packages/providers/deepseek/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @llamaindex/deepseek
 
+## 0.0.36
+
+### Patch Changes
+
+- Updated dependencies [001a515]
+- Updated dependencies [9d7d205]
+  - @llamaindex/openai@0.4.18
+
 ## 0.0.35
 
 ### Patch Changes

packages/providers/deepseek/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/deepseek",
   "description": "DeepSeek Adapter for LlamaIndex",
-  "version": "0.0.35",
+  "version": "0.0.36",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",

packages/providers/fireworks/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @llamaindex/fireworks
 
+## 0.0.34
+
+### Patch Changes
+
+- Updated dependencies [001a515]
+- Updated dependencies [9d7d205]
+  - @llamaindex/openai@0.4.18
+
 ## 0.0.33
 
 ### Patch Changes

packages/providers/fireworks/package.json

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

packages/providers/groq/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @llamaindex/groq
 
+## 0.0.90
+
+### Patch Changes
+
+- Updated dependencies [001a515]
+- Updated dependencies [9d7d205]
+  - @llamaindex/openai@0.4.18
+
 ## 0.0.89
 
 ### Patch Changes

packages/providers/groq/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/groq",
   "description": "Groq Adapter for LlamaIndex",
-  "version": "0.0.89",
+  "version": "0.0.90",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",

packages/providers/huggingface/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @llamaindex/huggingface
 
+## 0.1.28
+
+### Patch Changes
+
+- Updated dependencies [001a515]
+- Updated dependencies [9d7d205]
+  - @llamaindex/openai@0.4.18
+
 ## 0.1.27
 
 ### Patch Changes

packages/providers/huggingface/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/huggingface",
   "description": "Huggingface Adapter for LlamaIndex",
-  "version": "0.1.27",
+  "version": "0.1.28",
   "type": "module",
   "types": "dist/index.d.ts",
   "main": "dist/index.cjs",

packages/providers/jinaai/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @llamaindex/jinaai
 
+## 0.0.34
+
+### Patch Changes
+
+- Updated dependencies [001a515]
+- Updated dependencies [9d7d205]
+  - @llamaindex/openai@0.4.18
+
 ## 0.0.33
 
 ### Patch Changes

packages/providers/jinaai/package.json

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

packages/providers/openai/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @llamaindex/openai
 
+## 0.4.18
+
+### Patch Changes
+
+- 001a515: chore: add minimal reasoning effort for gpt5
+- 9d7d205: fix: fix the problem that the usage field in the streaming response was not handled correctly
+
 ## 0.4.17
 
 ### Patch Changes

packages/providers/openai/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/openai",
   "description": "OpenAI Adapter for LlamaIndex",
-  "version": "0.4.17",
+  "version": "0.4.18",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",

packages/providers/openai/src/llm.ts

@@ -40,6 +40,7 @@ import { OpenAILive } from "./live.js";
 import {
   ALL_AVAILABLE_OPENAI_MODELS,
   isFunctionCallingModel,
+  isReasoningEffortSupported,
   isReasoningModel,
   isTemperatureSupported,
   type LLMInstance,
@@ -54,7 +55,7 @@ export class OpenAI extends ToolCallLLM<OpenAIAdditionalChatOptions> {
     // string & {} is a hack to allow any string, but still give autocomplete
     | (string & {});
   temperature: number;
-  reasoningEffort?: "low" | "medium" | "high" | undefined;
+  reasoningEffort?: "low" | "medium" | "high" | "minimal" | undefined;
   topP: number;
   maxTokens?: number | undefined;
   additionalChatOptions?: OpenAIAdditionalChatOptions | undefined;
@@ -90,9 +91,11 @@ export class OpenAI extends ToolCallLLM<OpenAIAdditionalChatOptions> {
 
     this.model = init?.model ?? "gpt-4o";
     this.temperature = init?.temperature ?? 0.1;
-    this.reasoningEffort = isReasoningModel(this.model)
+    this.reasoningEffort =
-      ? init?.reasoningEffort
+      isReasoningModel(this.model) &&
-      : undefined;
+      isReasoningEffortSupported(this.model, init?.reasoningEffort)
+        ? init?.reasoningEffort
+        : undefined;
     this.topP = init?.topP ?? 1;
     this.maxTokens = init?.maxTokens ?? undefined;
 
@@ -370,25 +373,18 @@ export class OpenAI extends ToolCallLLM<OpenAIAdditionalChatOptions> {
     let currentToolCall: PartialToolCall | null = null;
     const toolCallMap = new Map<string, PartialToolCall>();
     for await (const part of stream) {
-      if (part.choices.length === 0) {
+      const choice = part.choices && part.choices[0];
+      const hasValidContent =
+        choice?.delta?.content ||
+        choice?.delta?.tool_calls ||
+        choice?.finish_reason;
+
+      if (!hasValidContent) {
         if (part.usage) {
-          yield {
+          yield { raw: part, delta: "" };
-            raw: part,
-            delta: "",
-          };
         }
         continue;
       }
-      const choice = part.choices[0]!;
-      // skip parts that don't have any content
-      if (
-        !(
-          choice.delta?.content ||
-          choice.delta?.tool_calls ||
-          choice.finish_reason
-        )
-      )
-        continue;
 
       let shouldEmitToolCall: PartialToolCall | null = null;
       if (

packages/providers/openai/src/utils.ts

@@ -187,6 +187,16 @@ export function isReasoningModel(model: ChatModel | string): boolean {
   return isO1 || isO3 || isO4 || isGPT5;
 }
 
+export function isReasoningEffortSupported(
+  model: ChatModel | string,
+  effort: string | undefined,
+): boolean {
+  const supportedReasoningEffort = ["low", "medium", "high", undefined];
+  return model.startsWith("gpt-5")
+    ? [...supportedReasoningEffort, "minimal"].includes(effort)
+    : supportedReasoningEffort.includes(effort);
+}
+
 export function isTemperatureSupported(model: ChatModel | string): boolean {
   return !model.startsWith("o3") && !model.startsWith("o4");
 }

packages/providers/openai/tests/chat.test.ts

@@ -283,4 +283,100 @@ describe("OpenAI streamChat", () => {
     expect(chunks[0].options).toEqual({});
     expect(chunks[0].delta).toBe("");
   });
+
+  it("should handle part with undefined choices", async () => {
+    // Create a mock stream that yields a part without choices
+    const mockStream = async function* () {
+      yield {
+        // No choices property defined
+        usage: {
+          prompt_tokens: 10,
+          completion_tokens: 5,
+          total_tokens: 15,
+        },
+      };
+    };
+
+    // Mock the OpenAI session and chat completions
+    const mockSession = {
+      chat: {
+        completions: {
+          create: vi.fn().mockResolvedValue(mockStream()),
+        },
+      },
+    };
+
+    const openai = new OpenAI({
+      model: "gpt-4o-mini",
+      apiKey: "test-key",
+      // @ts-expect-error: mockSession is a mock object for testing purposes
+      session: mockSession,
+    });
+
+    // @ts-expect-error accessing protected method
+    const stream = openai.streamChat({
+      messages: [{ role: "user" as const, content: "Hello" }],
+      stream: true,
+    });
+
+    const chunks: ChatResponseChunk[] = [];
+    for await (const chunk of stream) {
+      chunks.push(chunk);
+    }
+
+    expect(chunks).toHaveLength(1);
+    expect(chunks[0].delta).toBe("");
+    expect(chunks[0].raw).toHaveProperty("usage");
+  });
+
+  it("should handle part with invalid content", async () => {
+    const mockStream = async function* () {
+      yield {
+        choices: [
+          {
+            delta: {
+              role: "assistant",
+              content: "",
+            },
+          },
+        ],
+        usage: {
+          prompt_tokens: 10,
+          completion_tokens: 5,
+          total_tokens: 15,
+        },
+      };
+    };
+
+    // Mock the OpenAI session and chat completions
+    const mockSession = {
+      chat: {
+        completions: {
+          create: vi.fn().mockResolvedValue(mockStream()),
+        },
+      },
+    };
+
+    const openai = new OpenAI({
+      model: "gpt-4o-mini",
+      apiKey: "test-key",
+      // @ts-expect-error: mockSession is a mock object for testing purposes
+      session: mockSession,
+    });
+
+    // @ts-expect-error accessing protected method
+    const stream = openai.streamChat({
+      messages: [{ role: "user" as const, content: "Hello" }],
+      stream: true,
+    });
+
+    const chunks: ChatResponseChunk[] = [];
+    for await (const chunk of stream) {
+      chunks.push(chunk);
+    }
+
+    expect(chunks).toHaveLength(1);
+    expect(chunks[0].delta).toBe("");
+    expect(chunks[0].raw).toHaveProperty("usage");
+  });
 });

packages/providers/perplexity/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @llamaindex/perplexity
 
+## 0.0.31
+
+### Patch Changes
+
+- Updated dependencies [001a515]
+- Updated dependencies [9d7d205]
+  - @llamaindex/openai@0.4.18
+
 ## 0.0.30
 
 ### Patch Changes

packages/providers/perplexity/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/perplexity",
   "description": "Perplexity Adapter for LlamaIndex",
-  "version": "0.0.30",
+  "version": "0.0.31",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",

packages/providers/storage/azure/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @llamaindex/azure
 
+## 0.1.35
+
+### Patch Changes
+
+- Updated dependencies [001a515]
+- Updated dependencies [9d7d205]
+  - @llamaindex/openai@0.4.18
+
 ## 0.1.34
 
 ### Patch Changes

packages/providers/storage/azure/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/azure",
   "description": "Azure Storage for LlamaIndex",
-  "version": "0.1.34",
+  "version": "0.1.35",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",

packages/providers/together/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @llamaindex/together
 
+## 0.0.34
+
+### Patch Changes
+
+- Updated dependencies [001a515]
+- Updated dependencies [9d7d205]
+  - @llamaindex/openai@0.4.18
+
 ## 0.0.33
 
 ### Patch Changes

packages/providers/together/package.json

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

packages/providers/vllm/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @llamaindex/vllm
 
+## 0.0.60
+
+### Patch Changes
+
+- Updated dependencies [001a515]
+- Updated dependencies [9d7d205]
+  - @llamaindex/openai@0.4.18
+
 ## 0.0.59
 
 ### Patch Changes

packages/providers/vllm/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/vllm",
   "description": "vLLM Adapter for LlamaIndex",
-  "version": "0.0.59",
+  "version": "0.0.60",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",

packages/providers/xai/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @llamaindex/xai
 
+## 0.0.21
+
+### Patch Changes
+
+- Updated dependencies [001a515]
+- Updated dependencies [9d7d205]
+  - @llamaindex/openai@0.4.18
+
 ## 0.0.20
 
 ### Patch Changes

packages/providers/xai/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/xai",
   "description": "XAI Adapter for LlamaIndex",
-  "version": "0.0.20",
+  "version": "0.0.21",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",

packages/workflow/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @llamaindex/workflow
 
+## 1.1.22
+
+### Patch Changes
+
+- 1995b38: bump @llamaindex/workflow-core in workflow package
+
 ## 1.1.21
 
 ### Patch Changes

packages/workflow/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/workflow",
   "description": "Workflow API",
-  "version": "1.1.21",
+  "version": "1.1.22",
   "type": "module",
   "types": "dist/index.d.ts",
   "module": "dist/index.js",
@@ -49,6 +49,6 @@
     "zod-to-json-schema": "^3.24.6"
   },
   "dependencies": {
-    "@llamaindex/workflow-core": "^1.0.0"
+    "@llamaindex/workflow-core": "^1.3.0"
   }
 }

packages/workflow/src/agent/agent-handler.ts

@@ -1,4 +1,7 @@
-import { getContext, type WorkflowEventData } from "@llamaindex/workflow-core";
+import {
+  type WorkflowContext,
+  type WorkflowEventData,
+} from "@llamaindex/workflow-core";
 import {
   AgentWorkflow,
   startAgentEvent,
@@ -71,9 +74,10 @@ function createWorkflowForStepHandler(
 export const agentHandler = (
   params: Omit<StepHandlerParams, "workflowContext">,
 ) => {
-  return async (event: WorkflowEventData<unknown>) => {
+  return async (
-    const context = getContext();
+    context: WorkflowContext,
-
+    event: WorkflowEventData<unknown>,
+  ) => {
     const workflow = createWorkflowForStepHandler({
       ...params,
       workflowContext: context,

packages/workflow/src/agent/agent-workflow.ts

@@ -8,7 +8,6 @@ import { stringifyJSONToMessageContent } from "@llamaindex/core/utils";
 import { consoleLogger, emptyLogger, type Logger } from "@llamaindex/env";
 import {
   createWorkflow,
-  getContext,
   workflowEvent,
   type Handler,
   type Workflow,
@@ -16,7 +15,10 @@ import {
   type WorkflowEvent,
   type WorkflowEventData,
 } from "@llamaindex/workflow-core";
-import { createStatefulMiddleware } from "@llamaindex/workflow-core/middleware/state";
+import {
+  createStatefulMiddleware,
+  type StatefulContext,
+} from "@llamaindex/workflow-core/middleware/state";
 import { z } from "zod";
 import type { AgentWorkflowState, BaseWorkflowAgent } from "./base";
 import {
@@ -339,9 +341,10 @@ export class AgentWorkflow implements Workflow {
   }
 
   private handleInputStep = async (
+    context: StatefulContext<AgentWorkflowState>,
     event: WorkflowEventData<AgentInputData>,
   ) => {
-    const { state } = this.stateful.getContext();
+    const { state } = context;
     const { userInput, chatHistory } = event.data;
     const memory = state.memory;
     if (chatHistory) {
@@ -375,7 +378,10 @@ export class AgentWorkflow implements Workflow {
     });
   };
 
-  private setupAgent = async (event: WorkflowEventData<AgentInput>) => {
+  private setupAgent = async (
+    context: StatefulContext<AgentWorkflowState>,
+    event: WorkflowEventData<AgentInput>,
+  ) => {
     const currentAgentName = event.data.currentAgentName;
     const agent = this.agents.get(currentAgentName);
     if (!agent) {
@@ -396,16 +402,19 @@ export class AgentWorkflow implements Workflow {
     });
   };
 
-  private runAgentStep = async (event: WorkflowEventData<AgentSetup>) => {
+  private runAgentStep = async (
-    const { sendEvent } = this.stateful.getContext();
+    context: StatefulContext<AgentWorkflowState>,
+    event: WorkflowEventData<AgentSetup>,
+  ) => {
+    const { sendEvent } = context;
     const agent = this.agents.get(event.data.currentAgentName);
     if (!agent) {
       throw new Error("No valid agent found");
     }
 
     const output = await agent.takeStep(
-      this.stateful.getContext(),
+      context,
-      this.stateful.getContext().state,
+      context.state,
       event.data.input,
       agent.tools,
     );
@@ -421,7 +430,10 @@ export class AgentWorkflow implements Workflow {
     sendEvent(agentOutputEvent.with(output));
   };
 
-  private parseAgentOutput = async (event: WorkflowEventData<AgentStep>) => {
+  private parseAgentOutput = async (
+    context: StatefulContext<AgentWorkflowState>,
+    event: WorkflowEventData<AgentStep>,
+  ) => {
     const { agentName, response, toolCalls } = event.data;
     const agent = this.agents.get(agentName);
     if (!agent) {
@@ -442,15 +454,12 @@ export class AgentWorkflow implements Workflow {
         raw: response,
         currentAgentName: agentName,
       };
-      const content = await agent.finalize(
+      const content = await agent.finalize(context.state, agentOutput);
-        this.stateful.getContext().state,
-        agentOutput,
-      );
 
       return stopAgentEvent.with({
         message: content.response,
         result: content.response.content,
-        state: this.stateful.getContext().state,
+        state: context.state,
       });
     }
 
@@ -460,8 +469,11 @@ export class AgentWorkflow implements Workflow {
     });
   };
 
-  private executeToolCalls = async (event: WorkflowEventData<ToolCalls>) => {
+  private executeToolCalls = async (
-    const { sendEvent } = getContext();
+    context: StatefulContext<AgentWorkflowState>,
+    event: WorkflowEventData<ToolCalls>,
+  ) => {
+    const { sendEvent } = context;
     const { agentName, toolCalls } = event.data;
     const agent = this.agents.get(agentName);
     if (!agent) {
@@ -507,6 +519,7 @@ export class AgentWorkflow implements Workflow {
   };
 
   private processToolResults = async (
+    context: StatefulContext<AgentWorkflowState>,
     event: WorkflowEventData<ToolResults>,
   ) => {
     const { agentName, results } = event.data;
@@ -517,10 +530,7 @@ export class AgentWorkflow implements Workflow {
       throw new Error(`Agent ${agentName} not found`);
     }
 
-    await agent.handleToolCallResults(
+    await agent.handleToolCallResults(context.state, results);
-      this.stateful.getContext().state,
-      results,
-    );
 
     const directResult = results.find(
       (r: AgentToolCallResult) => r.returnDirect,
@@ -542,22 +552,22 @@ export class AgentWorkflow implements Workflow {
         currentAgentName: agent.name,
       };
 
-      await agent.finalize(this.stateful.getContext().state, agentOutput);
+      await agent.finalize(context.state, agentOutput);
 
       if (isHandoff) {
-        const nextAgentName = this.stateful.getContext().state.nextAgentName;
+        const nextAgentName = context.state.nextAgentName;
 
         this.logger.log(
           `[Agent ${agentName}]: Handoff to ${nextAgentName}: ${directResult.toolOutput.result}`,
         );
 
         if (nextAgentName) {
-          this.stateful.getContext().state.currentAgentName = nextAgentName;
+          context.state.currentAgentName = nextAgentName;
-          this.stateful.getContext().state.nextAgentName = null;
+          context.state.nextAgentName = null;
 
-          const messages = await this.stateful
+          const messages = await context.state.memory.getLLM(
-            .getContext()
+            this.agents.get(nextAgentName)?.llm,
-            .state.memory.getLLM(this.agents.get(nextAgentName)?.llm);
+          );
 
           this.logger.log(`[Agent ${nextAgentName}]: Starting agent`);
 
@@ -571,14 +581,14 @@ export class AgentWorkflow implements Workflow {
       return stopAgentEvent.with({
         message: responseMessage,
         result: output,
-        state: this.stateful.getContext().state,
+        state: context.state,
       });
     }
 
     // Continue with another agent step
-    const messages = await this.stateful
+    const messages = await context.state.memory.getLLM(
-      .getContext()
+      this.agents.get(agent.name)?.llm,
-      .state.memory.getLLM(this.agents.get(agent.name)?.llm);
+    );
     return agentInputEvent.with({
       input: messages,
       currentAgentName: agent.name,

packages/workflow/src/index.ts

@@ -1,5 +1,4 @@
 export * from "@llamaindex/workflow-core";
-export * from "@llamaindex/workflow-core/middleware/snapshot";
 export * from "@llamaindex/workflow-core/middleware/state";
 export * from "@llamaindex/workflow-core/stream/run";
 export { zodEvent } from "@llamaindex/workflow-core/util/zod";

pnpm-lock.yaml

@@ -624,7 +624,7 @@ importers:
         specifier: ^0.0.34
         version: link:../packages/providers/storage/astra
       '@llamaindex/azure':
-        specifier: ^0.1.34
+        specifier: ^0.1.35
         version: link:../packages/providers/storage/azure
       '@llamaindex/bm25-retriever':
         specifier: ^0.0.9
@@ -633,7 +633,7 @@ importers:
         specifier: ^0.0.34
         version: link:../packages/providers/storage/chroma
       '@llamaindex/clip':
-        specifier: ^0.0.73
+        specifier: ^0.0.74
         version: link:../packages/providers/clip
       '@llamaindex/cloud':
         specifier: ^4.1.2
@@ -645,10 +645,10 @@ importers:
         specifier: ^0.6.20
         version: link:../packages/core
       '@llamaindex/deepinfra':
-        specifier: ^0.0.73
+        specifier: ^0.0.74
         version: link:../packages/providers/deepinfra
       '@llamaindex/deepseek':
-        specifier: ^0.0.35
+        specifier: ^0.0.36
         version: link:../packages/providers/deepseek
       '@llamaindex/discord':
         specifier: ^0.1.19
@@ -663,19 +663,19 @@ importers:
         specifier: ^1.0.27
         version: link:../packages/providers/storage/firestore
       '@llamaindex/fireworks':
-        specifier: ^0.0.33
+        specifier: ^0.0.34
         version: link:../packages/providers/fireworks
       '@llamaindex/google':
         specifier: ^0.3.20
         version: link:../packages/providers/google
       '@llamaindex/groq':
-        specifier: ^0.0.89
+        specifier: ^0.0.90
         version: link:../packages/providers/groq
       '@llamaindex/huggingface':
-        specifier: ^0.1.27
+        specifier: ^0.1.28
         version: link:../packages/providers/huggingface
       '@llamaindex/jinaai':
-        specifier: ^0.0.33
+        specifier: ^0.0.34
         version: link:../packages/providers/jinaai
       '@llamaindex/milvus':
         specifier: ^0.1.29
@@ -699,10 +699,10 @@ importers:
         specifier: ^0.1.21
         version: link:../packages/providers/ollama
       '@llamaindex/openai':
-        specifier: ^0.4.17
+        specifier: ^0.4.18
         version: link:../packages/providers/openai
       '@llamaindex/perplexity':
-        specifier: ^0.0.30
+        specifier: ^0.0.31
         version: link:../packages/providers/perplexity
       '@llamaindex/pinecone':
         specifier: ^0.1.20
@@ -726,7 +726,7 @@ importers:
         specifier: ^0.1.21
         version: link:../packages/providers/storage/supabase
       '@llamaindex/together':
-        specifier: ^0.0.33
+        specifier: ^0.0.34
         version: link:../packages/providers/together
       '@llamaindex/tools':
         specifier: ^0.1.10
@@ -738,7 +738,7 @@ importers:
         specifier: ^0.1.20
         version: link:../packages/providers/vercel
       '@llamaindex/vllm':
-        specifier: ^0.0.59
+        specifier: ^0.0.60
         version: link:../packages/providers/vllm
       '@llamaindex/voyage-ai':
         specifier: ^1.0.26
@@ -747,10 +747,10 @@ importers:
         specifier: ^0.0.35
         version: link:../packages/providers/storage/weaviate
       '@llamaindex/workflow':
-        specifier: ^1.1.21
+        specifier: ^1.1.22
         version: link:../packages/workflow
       '@llamaindex/xai':
-        specifier: ^0.0.20
+        specifier: ^0.0.21
         version: link:../packages/providers/xai
       '@notionhq/client':
         specifier: 4.0.0
@@ -777,7 +777,7 @@ importers:
         specifier: ^1.0.14
         version: 1.0.19
       llamaindex:
-        specifier: ^0.11.27
+        specifier: ^0.11.28
         version: link:../packages/llamaindex
       mongodb:
         specifier: 6.7.0
@@ -792,6 +792,9 @@ importers:
         specifier: ^3.25.76
         version: 3.25.76
     devDependencies:
+      '@types/express':
+        specifier: ^5.0.3
+        version: 5.0.3
       '@types/node':
         specifier: ^24.0.13
         version: 24.0.13
@@ -802,6 +805,25 @@ importers:
         specifier: ^5.8.3
         version: 5.8.3
 
+  examples/local-settings:
+    dependencies:
+      '@llamaindex/openai':
+        specifier: ^0.4.16
+        version: link:../../packages/providers/openai
+      express:
+        specifier: ^5.1.0
+        version: 5.1.0
+      llamaindex:
+        specifier: ^0.11.26
+        version: link:../../packages/llamaindex
+    devDependencies:
+      '@types/express':
+        specifier: ^5.0.3
+        version: 5.0.3
+      typescript:
+        specifier: ^5.9.2
+        version: 5.9.2
+
   examples/models/openai/live/browser/open-ai-realtime:
     dependencies:
       react:
@@ -957,10 +979,10 @@ importers:
     devDependencies:
       '@hey-api/client-fetch':
         specifier: ^0.10.1
-        version: 0.10.1(@hey-api/openapi-ts@0.67.5(typescript@5.8.3))
+        version: 0.10.1(@hey-api/openapi-ts@0.67.5(typescript@5.9.2))
       '@hey-api/openapi-ts':
         specifier: ^0.67.5
-        version: 0.67.5(typescript@5.8.3)
+        version: 0.67.5(typescript@5.9.2)
       '@llama-flow/core':
         specifier: ^0.4.1
         version: 0.4.1(@modelcontextprotocol/sdk@1.13.0)(hono@4.7.7)(next@15.3.3(@opentelemetry/api@1.9.0)(react-dom@19.1.0(react@19.1.0))(react@19.1.0))(p-retry@6.2.1)(zod@3.25.76)
@@ -1028,7 +1050,7 @@ importers:
         version: link:..
       vitest:
         specifier: ^2.1.5
-        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(terser@5.39.0)
+        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0)
 
   packages/env:
     dependencies:
@@ -1056,7 +1078,7 @@ importers:
         version: 4.0.18
       vitest:
         specifier: ^2.1.5
-        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(terser@5.39.0)
+        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0)
 
   packages/experimental:
     dependencies:
@@ -1134,7 +1156,7 @@ importers:
         version: link:..
       vitest:
         specifier: ^2.1.5
-        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(terser@5.39.0)
+        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0)
 
   packages/node-parser:
     dependencies:
@@ -1178,7 +1200,7 @@ importers:
         version: link:../../env
       vitest:
         specifier: ^2.1.5
-        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(terser@5.39.0)
+        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0)
 
   packages/providers/assemblyai:
     dependencies:
@@ -1370,7 +1392,7 @@ importers:
         version: link:../../env
       vitest:
         specifier: ^2.1.5
-        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(terser@5.39.0)
+        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0)
 
   packages/providers/mixedbread:
     dependencies:
@@ -1542,7 +1564,7 @@ importers:
         version: 17.2.0
       vitest:
         specifier: ^2.1.5
-        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(terser@5.39.0)
+        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0)
 
   packages/providers/storage/chroma:
     dependencies:
@@ -1577,7 +1599,7 @@ importers:
         version: link:../../openai
       vitest:
         specifier: ^3.0.9
-        version: 3.1.1(@edge-runtime/vm@5.0.0)(@types/debug@4.1.12)(@types/node@24.0.13)(happy-dom@17.4.4)(jiti@2.4.2)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(terser@5.39.0)(tsx@4.20.3)(yaml@2.7.1)
+        version: 3.1.1(@edge-runtime/vm@5.0.0)(@types/debug@4.1.12)(@types/node@24.0.13)(happy-dom@17.4.4)(jiti@2.4.2)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0)(tsx@4.20.3)(yaml@2.7.1)
 
   packages/providers/storage/firestore:
     dependencies:
@@ -1612,7 +1634,7 @@ importers:
         version: link:../../openai
       vitest:
         specifier: ^2.1.5
-        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(terser@5.39.0)
+        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0)
 
   packages/providers/storage/mongodb:
     dependencies:
@@ -1631,7 +1653,7 @@ importers:
         version: 10.1.4(@aws-sdk/credential-providers@3.844.0)(socks@2.8.4)
       vitest:
         specifier: 2.1.0
-        version: 2.1.0(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(terser@5.39.0)
+        version: 2.1.0(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0)
 
   packages/providers/storage/pinecone:
     dependencies:
@@ -1678,7 +1700,7 @@ importers:
     dependencies:
       '@qdrant/js-client-rest':
         specifier: ^1.14.0
-        version: 1.14.0(typescript@5.8.3)
+        version: 1.14.0(typescript@5.9.2)
     devDependencies:
       '@llamaindex/core':
         specifier: workspace:*
@@ -1691,7 +1713,7 @@ importers:
         version: link:../../openai
       vitest:
         specifier: ^2.1.9
-        version: 2.1.9(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(terser@5.39.0)
+        version: 2.1.9(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0)
 
   packages/providers/storage/supabase:
     dependencies:
@@ -1710,7 +1732,7 @@ importers:
         version: link:../../openai
       vitest:
         specifier: 2.1.0
-        version: 2.1.0(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(terser@5.39.0)
+        version: 2.1.0(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0)
 
   packages/providers/storage/upstash:
     dependencies:
@@ -1739,7 +1761,7 @@ importers:
         version: link:../../../env
       vitest:
         specifier: ^3.2.0
-        version: 3.2.0(@edge-runtime/vm@5.0.0)(@types/debug@4.1.12)(@types/node@24.0.13)(happy-dom@17.4.4)(jiti@2.4.2)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(terser@5.39.0)(tsx@4.20.3)(yaml@2.7.1)
+        version: 3.2.0(@edge-runtime/vm@5.0.0)(@types/debug@4.1.12)(@types/node@24.0.13)(happy-dom@17.4.4)(jiti@2.4.2)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0)(tsx@4.20.3)(yaml@2.7.1)
 
   packages/providers/together:
     dependencies:
@@ -1764,7 +1786,7 @@ importers:
         version: 4.3.17(react@19.1.0)(zod@3.25.76)
       vitest:
         specifier: ^2.1.5
-        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(terser@5.39.0)
+        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0)
 
   packages/providers/vllm:
     dependencies:
@@ -1881,7 +1903,7 @@ importers:
         version: 8.17.1
       vitest:
         specifier: ^2.1.5
-        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(terser@5.39.0)
+        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0)
 
   packages/wasm-tools:
     dependencies:
@@ -1908,8 +1930,8 @@ importers:
   packages/workflow:
     dependencies:
       '@llamaindex/workflow-core':
-        specifier: ^1.0.0
+        specifier: ^1.3.0
-        version: 1.0.0(@modelcontextprotocol/sdk@1.13.0)(hono@4.7.7)(next@15.3.3(@opentelemetry/api@1.9.0)(react-dom@19.1.0(react@19.1.0))(react@19.1.0))(p-retry@6.2.1)(zod@3.25.76)
+        version: 1.3.0(@modelcontextprotocol/sdk@1.13.0)(hono@4.7.7)(next@15.3.3(@opentelemetry/api@1.9.0)(react-dom@19.1.0(react@19.1.0))(react@19.1.0))(p-retry@6.2.1)(zod@3.25.76)
       zod:
         specifier: ^3.25.67
         version: 3.25.76
@@ -1928,7 +1950,7 @@ importers:
         version: 24.0.13
       vitest:
         specifier: ^2.1.5
-        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(terser@5.39.0)
+        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0)
 
   resolution-tests:
     devDependencies:
@@ -2004,10 +2026,10 @@ importers:
         version: 19.1.6(@types/react@19.1.8)
       msw:
         specifier: ^2.6.5
-        version: 2.7.4(@types/node@24.0.13)(typescript@5.8.3)
+        version: 2.7.4(@types/node@24.0.13)(typescript@5.9.2)
       vitest:
         specifier: ^2.1.5
-        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(terser@5.39.0)
+        version: 2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0)
 
 packages:
 
@@ -4251,8 +4273,8 @@ packages:
   '@llamaindex/chat-ui-docs@0.1.0':
     resolution: {integrity: sha512-+DwnLSWDOJk2d6lGDhLYtmpeGHho4AjKE2aQMz8J0ZF29RlSqp/Z5HmhQoYIjK0neIM1S9eF7ubuM1zpVpZqrg==}
 
-  '@llamaindex/workflow-core@1.0.0':
+  '@llamaindex/workflow-core@1.3.0':
-    resolution: {integrity: sha512-pMQk89x11wvJu+uNHqB9gIZ1Ww069CikgltNcuxo4Bi1ajzrvScsu3H+3VS1XmkinKxhQjHjT+BJdObfWBfNCQ==}
+    resolution: {integrity: sha512-5HsIuDpeiXZUTsy5nJ+F7PUnStQdzEoEmc6/0IDlL4eqK3svBEitbOGlxCTPMYasoVni2XsEL1ox1QtVrtrzpw==}
     peerDependencies:
       '@modelcontextprotocol/sdk': ^1.7.0
       hono: ^4.7.4
@@ -6575,6 +6597,9 @@ packages:
   '@types/babel__traverse@7.20.7':
     resolution: {integrity: sha512-dkO5fhS7+/oos4ciWxyEyjWe48zmG6wbCheo/G2ZnHx4fs3EU6YC6UM8rk56gAjNJ9P3MTH2jo5jb92/K6wbng==}
 
+  '@types/body-parser@1.19.6':
+    resolution: {integrity: sha512-HLFeCYgz89uk22N5Qg3dvGvsv46B8GLvKKo1zKG4NybA8U2DiEO3w9lqGg29t/tfLRJpJ6iQxnVw4OnB7MoM9g==}
+
   '@types/caseless@0.12.5':
     resolution: {integrity: sha512-hWtVTC2q7hc7xZ/RLbxapMvDMgUnDvKvMOpKal4DrMyfGBUfB1oKaZlIRr6mJL+If3bAP6sV/QneGzF6tJjZDg==}
 
@@ -6587,6 +6612,9 @@ packages:
   '@types/command-line-usage@5.0.4':
     resolution: {integrity: sha512-BwR5KP3Es/CSht0xqBcUXS3qCAUVXwpRKsV2+arxeb65atasuXG9LykC9Ab10Cw3s2raH92ZqOeILaQbsB2ACg==}
 
+  '@types/connect@3.4.38':
+    resolution: {integrity: sha512-K6uROf1LD88uDQqJCktA4yzL1YYAK6NgfsI0v/mTgyPKWsX1CnJ0XPSDhViejru1GcRkLWb8RlzFYJRqGUbaug==}
+
   '@types/cookie@0.6.0':
     resolution: {integrity: sha512-4Kh9a6B2bQciAhf7FSuMRRkUWecJgJu9nPnx3yzpsfXX/c50REIqpHY4C82bXP90qrLtXtkDxTZosYO3UpOwlA==}
 
@@ -6614,6 +6642,12 @@ packages:
   '@types/estree@1.0.8':
     resolution: {integrity: sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==}
 
+  '@types/express-serve-static-core@5.0.7':
+    resolution: {integrity: sha512-R+33OsgWw7rOhD1emjU7dzCDHucJrgJXMA5PYCzJxVil0dsyx5iBEPHqpPfiKNJQb7lZ1vxwoLR4Z87bBUpeGQ==}
+
+  '@types/express@5.0.3':
+    resolution: {integrity: sha512-wGA0NX93b19/dZC1J18tKWVIYWyyF2ZjT9vin/NRu0qzzvfVzWjs04iq2rQ3H65vCTQYlRqs3YHfY7zjdV+9Kw==}
+
   '@types/hast@3.0.4':
     resolution: {integrity: sha512-WPs+bbQw5aCj+x6laNGWLH3wviHtoCv/P3+otBhbOhJgG8qtpdAMlTCxLtsTWA7LH1Oh/bFCHsBn0TPS5m30EQ==}
 
@@ -6623,6 +6657,9 @@ packages:
   '@types/http-cache-semantics@4.0.4':
     resolution: {integrity: sha512-1m0bIFVc7eJWyve9S0RnuRgcQqF/Xd5QsUZAZeQFr1Q3/p9JWoQQEqmVy+DPTNpGXwhgIetAoYF8JSc33q29QA==}
 
+  '@types/http-errors@2.0.5':
+    resolution: {integrity: sha512-r8Tayk8HJnX0FztbZN7oVqGccWgw98T/0neJphO91KkmOzug1KkofZURD4UaD5uH8AqcFLfdPErnBod0u71/qg==}
+
   '@types/json-schema@7.0.15':
     resolution: {integrity: sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==}
 
@@ -6650,6 +6687,9 @@ packages:
   '@types/mdx@2.0.13':
     resolution: {integrity: sha512-+OWZQfAYyio6YkJb3HLxDrvnx6SWWDbC0zVPfBRzUk0/nqoDyf6dNxQi3eArPe8rJ473nobTMQ/8Zk+LxJ+Yuw==}
 
+  '@types/mime@1.3.5':
+    resolution: {integrity: sha512-/pyBZWSLD2n0dcHE3hq8s8ZvcETHtEuF+3E7XVt0Ig2nvsVQXdghHVcEkIWjy9A0wKfTn97a/PSDYohKIlnP/w==}
+
   '@types/ms@2.1.0':
     resolution: {integrity: sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==}
 
@@ -6686,6 +6726,12 @@ packages:
   '@types/phoenix@1.6.6':
     resolution: {integrity: sha512-PIzZZlEppgrpoT2QgbnDU+MMzuR6BbCjllj0bM70lWoejMeNJAxCchxnv7J3XFkI8MpygtRpzXrIlmWUBclP5A==}
 
+  '@types/qs@6.14.0':
+    resolution: {integrity: sha512-eOunJqu0K1923aExK6y8p6fsihYEn/BYuQ4g0CxAAgFc4b/ZLN4CrsRZ55srTdqoiLzU2B2evC+apEIxprEzkQ==}
+
+  '@types/range-parser@1.2.7':
+    resolution: {integrity: sha512-hKormJbkJqzQGhziax5PItDUTMAM9uE2XXQmM37dyd4hVM+5aVl7oVxMVUiVQn2oCQFN/LKCZdvSM0pFRqbSmQ==}
+
   '@types/react-dom@19.1.6':
     resolution: {integrity: sha512-4hOiT/dwO8Ko0gV1m/TJZYk3y0KBnY9vzDh7W+DH17b2HFSOGgdj33dhihPeuy3l0q23+4e+hoXHV6hCC4dCXw==}
     peerDependencies:
@@ -6706,6 +6752,12 @@ packages:
   '@types/retry@0.12.2':
     resolution: {integrity: sha512-XISRgDJ2Tc5q4TRqvgJtzsRkFYNJzZrhTdtMoGVBttwzzQJkPnS3WWTFc7kuDRoPtPakl+T+OfdEUjYJj7Jbow==}
 
+  '@types/send@0.17.5':
+    resolution: {integrity: sha512-z6F2D3cOStZvuk2SaP6YrwkNO65iTZcwA2ZkSABegdkAh/lf+Aa/YQndZVfmEXT5vgAp6zv06VQ3ejSVjAny4w==}
+
+  '@types/serve-static@1.15.8':
+    resolution: {integrity: sha512-roei0UY3LhpOJvjbIP6ZZFngyLKl5dskOtDhxY5THRSpO+ZI+nzJ+m5yUMzGrp89YRa7lvknKkMYjqQFGwA7Sg==}
+
   '@types/statuses@2.0.5':
     resolution: {integrity: sha512-jmIUGWrAiwu3dZpxntxieC+1n/5c3mjrImkmOSQ2NC5uP6cYO4aAZDdSmRcI5C1oiTmqlZGHC+/NmJrKogbP5A==}
 
@@ -13253,6 +13305,11 @@ packages:
     engines: {node: '>=14.17'}
     hasBin: true
 
+  typescript@5.9.2:
+    resolution: {integrity: sha512-CWBzXQrc/qOkhidw1OzBTQuYRbfyxDXJMVJ1XNwUHGROVmuaeiEm3OslpZ1RV96d7SKKjZKrSJu3+t/xlw3R9A==}
+    engines: {node: '>=14.17'}
+    hasBin: true
+
   typical@4.0.0:
     resolution: {integrity: sha512-VAH4IvQ7BDFYglMd7BPRDfLgxZZX4O4TFcRDA6EN5X7erNJJq+McIEp8np9aVtxrCJ6qx4GTYVfOWNjcqwZgRw==}
     engines: {node: '>=8'}
@@ -16719,9 +16776,9 @@ snapshots:
       '@tanstack/vue-virtual': 3.13.6(vue@3.5.13(typescript@5.8.3))
       vue: 3.5.13(typescript@5.8.3)
 
-  '@hey-api/client-fetch@0.10.1(@hey-api/openapi-ts@0.67.5(typescript@5.8.3))':
+  '@hey-api/client-fetch@0.10.1(@hey-api/openapi-ts@0.67.5(typescript@5.9.2))':
     dependencies:
-      '@hey-api/openapi-ts': 0.67.5(typescript@5.8.3)
+      '@hey-api/openapi-ts': 0.67.5(typescript@5.9.2)
 
   '@hey-api/json-schema-ref-parser@1.0.6':
     dependencies:
@@ -16730,13 +16787,13 @@ snapshots:
       js-yaml: 4.1.0
       lodash: 4.17.21
 
-  '@hey-api/openapi-ts@0.67.5(typescript@5.8.3)':
+  '@hey-api/openapi-ts@0.67.5(typescript@5.9.2)':
     dependencies:
       '@hey-api/json-schema-ref-parser': 1.0.6
       c12: 2.0.1
       commander: 13.0.0
       handlebars: 4.7.8
-      typescript: 5.8.3
+      typescript: 5.9.2
     transitivePeerDependencies:
       - magicast
 
@@ -17154,7 +17211,7 @@ snapshots:
 
   '@llamaindex/chat-ui-docs@0.1.0': {}
 
-  '@llamaindex/workflow-core@1.0.0(@modelcontextprotocol/sdk@1.13.0)(hono@4.7.7)(next@15.3.3(@opentelemetry/api@1.9.0)(react-dom@19.1.0(react@19.1.0))(react@19.1.0))(p-retry@6.2.1)(zod@3.25.76)':
+  '@llamaindex/workflow-core@1.3.0(@modelcontextprotocol/sdk@1.13.0)(hono@4.7.7)(next@15.3.3(@opentelemetry/api@1.9.0)(react-dom@19.1.0(react@19.1.0))(react@19.1.0))(p-retry@6.2.1)(zod@3.25.76)':
     optionalDependencies:
       '@modelcontextprotocol/sdk': 1.13.0
       hono: 4.7.7
@@ -17531,11 +17588,11 @@ snapshots:
       - bare-buffer
       - supports-color
 
-  '@qdrant/js-client-rest@1.14.0(typescript@5.8.3)':
+  '@qdrant/js-client-rest@1.14.0(typescript@5.9.2)':
     dependencies:
       '@qdrant/openapi-typescript-fetch': 1.2.6
       '@sevinf/maybe': 0.5.0
-      typescript: 5.8.3
+      typescript: 5.9.2
       undici: 5.28.5
 
   '@qdrant/openapi-typescript-fetch@1.2.6': {}
@@ -19826,6 +19883,11 @@ snapshots:
     dependencies:
       '@babel/types': 7.27.6
 
+  '@types/body-parser@1.19.6':
+    dependencies:
+      '@types/connect': 3.4.38
+      '@types/node': 24.0.13
+
   '@types/caseless@0.12.5': {}
 
   '@types/chai@5.2.2':
@@ -19836,6 +19898,10 @@ snapshots:
 
   '@types/command-line-usage@5.0.4': {}
 
+  '@types/connect@3.4.38':
+    dependencies:
+      '@types/node': 24.0.13
+
   '@types/cookie@0.6.0': {}
 
   '@types/debug@4.1.12':
@@ -19864,6 +19930,19 @@ snapshots:
 
   '@types/estree@1.0.8': {}
 
+  '@types/express-serve-static-core@5.0.7':
+    dependencies:
+      '@types/node': 24.0.13
+      '@types/qs': 6.14.0
+      '@types/range-parser': 1.2.7
+      '@types/send': 0.17.5
+
+  '@types/express@5.0.3':
+    dependencies:
+      '@types/body-parser': 1.19.6
+      '@types/express-serve-static-core': 5.0.7
+      '@types/serve-static': 1.15.8
+
   '@types/hast@3.0.4':
     dependencies:
       '@types/unist': 3.0.3
@@ -19872,6 +19951,8 @@ snapshots:
 
   '@types/http-cache-semantics@4.0.4': {}
 
+  '@types/http-errors@2.0.5': {}
+
   '@types/json-schema@7.0.15': {}
 
   '@types/json5@0.0.29': {}
@@ -19894,6 +19975,8 @@ snapshots:
 
   '@types/mdx@2.0.13': {}
 
+  '@types/mime@1.3.5': {}
+
   '@types/ms@2.1.0': {}
 
   '@types/node-fetch@2.6.12':
@@ -19941,6 +20024,10 @@ snapshots:
 
   '@types/phoenix@1.6.6': {}
 
+  '@types/qs@6.14.0': {}
+
+  '@types/range-parser@1.2.7': {}
+
   '@types/react-dom@19.1.6(@types/react@19.1.8)':
     dependencies:
       '@types/react': 19.1.8
@@ -19965,6 +20052,17 @@ snapshots:
 
   '@types/retry@0.12.2': {}
 
+  '@types/send@0.17.5':
+    dependencies:
+      '@types/mime': 1.3.5
+      '@types/node': 24.0.13
+
+  '@types/serve-static@1.15.8':
+    dependencies:
+      '@types/http-errors': 2.0.5
+      '@types/node': 24.0.13
+      '@types/send': 0.17.5
+
   '@types/statuses@2.0.5': {}
 
   '@types/tough-cookie@4.0.5': {}
@@ -20060,7 +20158,7 @@ snapshots:
     dependencies:
       '@typescript-eslint/types': 8.30.1
       '@typescript-eslint/visitor-keys': 8.30.1
-      debug: 4.4.0
+      debug: 4.4.1
       fast-glob: 3.3.3
       is-glob: 4.0.3
       minimatch: 9.0.5
@@ -20253,13 +20351,13 @@ snapshots:
       chai: 5.2.0
       tinyrainbow: 2.0.0
 
-  '@vitest/mocker@2.1.0(@vitest/spy@2.1.0)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(vite@5.4.19(@types/node@24.0.13)(lightningcss@1.29.3)(terser@5.39.0))':
+  '@vitest/mocker@2.1.0(@vitest/spy@2.1.0)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(vite@5.4.19(@types/node@24.0.13)(lightningcss@1.29.3)(terser@5.39.0))':
     dependencies:
       '@vitest/spy': 2.1.0
       estree-walker: 3.0.3
       magic-string: 0.30.17
     optionalDependencies:
-      msw: 2.7.4(@types/node@24.0.13)(typescript@5.8.3)
+      msw: 2.7.4(@types/node@24.0.13)(typescript@5.9.2)
       vite: 5.4.19(@types/node@24.0.13)(lightningcss@1.29.3)(terser@5.39.0)
 
   '@vitest/mocker@2.1.5(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(vite@5.4.19(@types/node@24.0.13)(lightningcss@1.29.3)(terser@5.39.0))':
@@ -20271,13 +20369,22 @@ snapshots:
       msw: 2.7.4(@types/node@24.0.13)(typescript@5.8.3)
       vite: 5.4.19(@types/node@24.0.13)(lightningcss@1.29.3)(terser@5.39.0)
 
-  '@vitest/mocker@2.1.9(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(vite@5.4.19(@types/node@24.0.13)(lightningcss@1.29.3)(terser@5.39.0))':
+  '@vitest/mocker@2.1.5(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(vite@5.4.19(@types/node@24.0.13)(lightningcss@1.29.3)(terser@5.39.0))':
+    dependencies:
+      '@vitest/spy': 2.1.5
+      estree-walker: 3.0.3
+      magic-string: 0.30.17
+    optionalDependencies:
+      msw: 2.7.4(@types/node@24.0.13)(typescript@5.9.2)
+      vite: 5.4.19(@types/node@24.0.13)(lightningcss@1.29.3)(terser@5.39.0)
+
+  '@vitest/mocker@2.1.9(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(vite@5.4.19(@types/node@24.0.13)(lightningcss@1.29.3)(terser@5.39.0))':
     dependencies:
       '@vitest/spy': 2.1.9
       estree-walker: 3.0.3
       magic-string: 0.30.17
     optionalDependencies:
-      msw: 2.7.4(@types/node@24.0.13)(typescript@5.8.3)
+      msw: 2.7.4(@types/node@24.0.13)(typescript@5.9.2)
       vite: 5.4.19(@types/node@24.0.13)(lightningcss@1.29.3)(terser@5.39.0)
 
   '@vitest/mocker@3.1.1(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(vite@6.3.5(@types/node@24.0.13)(jiti@2.4.2)(lightningcss@1.29.3)(terser@5.39.0)(tsx@4.20.3)(yaml@2.7.1))':
@@ -20289,13 +20396,22 @@ snapshots:
       msw: 2.7.4(@types/node@24.0.13)(typescript@5.8.3)
       vite: 6.3.5(@types/node@24.0.13)(jiti@2.4.2)(lightningcss@1.29.3)(terser@5.39.0)(tsx@4.20.3)(yaml@2.7.1)
 
-  '@vitest/mocker@3.2.0(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(vite@6.3.5(@types/node@24.0.13)(jiti@2.4.2)(lightningcss@1.29.3)(terser@5.39.0)(tsx@4.20.3)(yaml@2.7.1))':
+  '@vitest/mocker@3.1.1(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(vite@6.3.5(@types/node@24.0.13)(jiti@2.4.2)(lightningcss@1.29.3)(terser@5.39.0)(tsx@4.20.3)(yaml@2.7.1))':
+    dependencies:
+      '@vitest/spy': 3.1.1
+      estree-walker: 3.0.3
+      magic-string: 0.30.17
+    optionalDependencies:
+      msw: 2.7.4(@types/node@24.0.13)(typescript@5.9.2)
+      vite: 6.3.5(@types/node@24.0.13)(jiti@2.4.2)(lightningcss@1.29.3)(terser@5.39.0)(tsx@4.20.3)(yaml@2.7.1)
+
+  '@vitest/mocker@3.2.0(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(vite@6.3.5(@types/node@24.0.13)(jiti@2.4.2)(lightningcss@1.29.3)(terser@5.39.0)(tsx@4.20.3)(yaml@2.7.1))':
     dependencies:
       '@vitest/spy': 3.2.0
       estree-walker: 3.0.3
       magic-string: 0.30.17
     optionalDependencies:
-      msw: 2.7.4(@types/node@24.0.13)(typescript@5.8.3)
+      msw: 2.7.4(@types/node@24.0.13)(typescript@5.9.2)
       vite: 6.3.5(@types/node@24.0.13)(jiti@2.4.2)(lightningcss@1.29.3)(terser@5.39.0)(tsx@4.20.3)(yaml@2.7.1)
 
   '@vitest/pretty-format@2.1.0':
@@ -25304,6 +25420,32 @@ snapshots:
       typescript: 5.8.3
     transitivePeerDependencies:
       - '@types/node'
+    optional: true
+
+  msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2):
+    dependencies:
+      '@bundled-es-modules/cookie': 2.0.1
+      '@bundled-es-modules/statuses': 1.0.1
+      '@bundled-es-modules/tough-cookie': 0.1.6
+      '@inquirer/confirm': 5.1.5(@types/node@24.0.13)
+      '@mswjs/interceptors': 0.37.6
+      '@open-draft/deferred-promise': 2.2.0
+      '@open-draft/until': 2.1.0
+      '@types/cookie': 0.6.0
+      '@types/statuses': 2.0.5
+      graphql: 16.10.0
+      headers-polyfill: 4.0.3
+      is-node-process: 1.2.0
+      outvariant: 1.4.3
+      path-to-regexp: 6.3.0
+      picocolors: 1.1.1
+      strict-event-emitter: 0.5.1
+      type-fest: 4.40.0
+      yargs: 17.7.2
+    optionalDependencies:
+      typescript: 5.9.2
+    transitivePeerDependencies:
+      - '@types/node'
 
   mustache@4.2.0: {}
 
@@ -26216,7 +26358,7 @@ snapshots:
   proxy-agent@6.4.0:
     dependencies:
       agent-base: 7.1.3
-      debug: 4.3.4
+      debug: 4.4.1
       http-proxy-agent: 7.0.2
       https-proxy-agent: 7.0.6
       lru-cache: 7.18.3
@@ -28000,6 +28142,8 @@ snapshots:
 
   typescript@5.8.3: {}
 
+  typescript@5.9.2: {}
+
   typical@4.0.0: {}
 
   typical@7.3.0: {}
@@ -28383,10 +28527,10 @@ snapshots:
       tsx: 4.20.3
       yaml: 2.7.1
 
-  vitest@2.1.0(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(terser@5.39.0):
+  vitest@2.1.0(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0):
     dependencies:
       '@vitest/expect': 2.1.0
-      '@vitest/mocker': 2.1.0(@vitest/spy@2.1.0)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(vite@5.4.19(@types/node@24.0.13)(lightningcss@1.29.3)(terser@5.39.0))
+      '@vitest/mocker': 2.1.0(@vitest/spy@2.1.0)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(vite@5.4.19(@types/node@24.0.13)(lightningcss@1.29.3)(terser@5.39.0))
       '@vitest/pretty-format': 2.1.9
       '@vitest/runner': 2.1.0
       '@vitest/snapshot': 2.1.0
@@ -28456,10 +28600,47 @@ snapshots:
       - supports-color
       - terser
 
-  vitest@2.1.9(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(terser@5.39.0):
+  vitest@2.1.5(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0):
+    dependencies:
+      '@vitest/expect': 2.1.5
+      '@vitest/mocker': 2.1.5(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(vite@5.4.19(@types/node@24.0.13)(lightningcss@1.29.3)(terser@5.39.0))
+      '@vitest/pretty-format': 2.1.9
+      '@vitest/runner': 2.1.5
+      '@vitest/snapshot': 2.1.5
+      '@vitest/spy': 2.1.5
+      '@vitest/utils': 2.1.5
+      chai: 5.2.0
+      debug: 4.4.0
+      expect-type: 1.2.0
+      magic-string: 0.30.17
+      pathe: 1.1.2
+      std-env: 3.8.1
+      tinybench: 2.9.0
+      tinyexec: 0.3.2
+      tinypool: 1.0.2
+      tinyrainbow: 1.2.0
+      vite: 5.4.19(@types/node@24.0.13)(lightningcss@1.29.3)(terser@5.39.0)
+      vite-node: 2.1.5(@types/node@24.0.13)(lightningcss@1.29.3)(terser@5.39.0)
+      why-is-node-running: 2.3.0
+    optionalDependencies:
+      '@edge-runtime/vm': 5.0.0
+      '@types/node': 24.0.13
+      happy-dom: 17.4.4
+    transitivePeerDependencies:
+      - less
+      - lightningcss
+      - msw
+      - sass
+      - sass-embedded
+      - stylus
+      - sugarss
+      - supports-color
+      - terser
+
+  vitest@2.1.9(@edge-runtime/vm@5.0.0)(@types/node@24.0.13)(happy-dom@17.4.4)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0):
     dependencies:
       '@vitest/expect': 2.1.9
-      '@vitest/mocker': 2.1.9(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(vite@5.4.19(@types/node@24.0.13)(lightningcss@1.29.3)(terser@5.39.0))
+      '@vitest/mocker': 2.1.9(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(vite@5.4.19(@types/node@24.0.13)(lightningcss@1.29.3)(terser@5.39.0))
       '@vitest/pretty-format': 2.1.9
       '@vitest/runner': 2.1.9
       '@vitest/snapshot': 2.1.9
@@ -28534,11 +28715,52 @@ snapshots:
       - tsx
       - yaml
 
-  vitest@3.2.0(@edge-runtime/vm@5.0.0)(@types/debug@4.1.12)(@types/node@24.0.13)(happy-dom@17.4.4)(jiti@2.4.2)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(terser@5.39.0)(tsx@4.20.3)(yaml@2.7.1):
+  vitest@3.1.1(@edge-runtime/vm@5.0.0)(@types/debug@4.1.12)(@types/node@24.0.13)(happy-dom@17.4.4)(jiti@2.4.2)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0)(tsx@4.20.3)(yaml@2.7.1):
+    dependencies:
+      '@vitest/expect': 3.1.1
+      '@vitest/mocker': 3.1.1(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(vite@6.3.5(@types/node@24.0.13)(jiti@2.4.2)(lightningcss@1.29.3)(terser@5.39.0)(tsx@4.20.3)(yaml@2.7.1))
+      '@vitest/pretty-format': 3.1.1
+      '@vitest/runner': 3.1.1
+      '@vitest/snapshot': 3.1.1
+      '@vitest/spy': 3.1.1
+      '@vitest/utils': 3.1.1
+      chai: 5.2.0
+      debug: 4.4.0
+      expect-type: 1.2.0
+      magic-string: 0.30.17
+      pathe: 2.0.3
+      std-env: 3.8.1
+      tinybench: 2.9.0
+      tinyexec: 0.3.2
+      tinypool: 1.0.2
+      tinyrainbow: 2.0.0
+      vite: 6.3.5(@types/node@24.0.13)(jiti@2.4.2)(lightningcss@1.29.3)(terser@5.39.0)(tsx@4.20.3)(yaml@2.7.1)
+      vite-node: 3.1.1(@types/node@24.0.13)(jiti@2.4.2)(lightningcss@1.29.3)(terser@5.39.0)(tsx@4.20.3)(yaml@2.7.1)
+      why-is-node-running: 2.3.0
+    optionalDependencies:
+      '@edge-runtime/vm': 5.0.0
+      '@types/debug': 4.1.12
+      '@types/node': 24.0.13
+      happy-dom: 17.4.4
+    transitivePeerDependencies:
+      - jiti
+      - less
+      - lightningcss
+      - msw
+      - sass
+      - sass-embedded
+      - stylus
+      - sugarss
+      - supports-color
+      - terser
+      - tsx
+      - yaml
+
+  vitest@3.2.0(@edge-runtime/vm@5.0.0)(@types/debug@4.1.12)(@types/node@24.0.13)(happy-dom@17.4.4)(jiti@2.4.2)(lightningcss@1.29.3)(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(terser@5.39.0)(tsx@4.20.3)(yaml@2.7.1):
     dependencies:
       '@types/chai': 5.2.2
       '@vitest/expect': 3.2.0
-      '@vitest/mocker': 3.2.0(msw@2.7.4(@types/node@24.0.13)(typescript@5.8.3))(vite@6.3.5(@types/node@24.0.13)(jiti@2.4.2)(lightningcss@1.29.3)(terser@5.39.0)(tsx@4.20.3)(yaml@2.7.1))
+      '@vitest/mocker': 3.2.0(msw@2.7.4(@types/node@24.0.13)(typescript@5.9.2))(vite@6.3.5(@types/node@24.0.13)(jiti@2.4.2)(lightningcss@1.29.3)(terser@5.39.0)(tsx@4.20.3)(yaml@2.7.1))
       '@vitest/pretty-format': 3.2.0
       '@vitest/runner': 3.2.0
       '@vitest/snapshot': 3.2.0

tsconfig.json

@@ -223,6 +223,9 @@
     },
     {
       "path": "./packages/community/tsconfig.json"
+    },
+    {
+      "path": "./examples/local-settings/tsconfig.json"
     }
   ]
 }

unit/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @llamaindex/unit-test
 
+## 0.1.60
+
+### Patch Changes
+
+- Updated dependencies [1995b38]
+- Updated dependencies [001a515]
+- Updated dependencies [9d7d205]
+  - @llamaindex/workflow@1.1.22
+  - @llamaindex/openai@0.4.18
+  - llamaindex@0.11.28
+
 ## 0.1.59
 
 ### Patch Changes

unit/package.json

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