Release 0.11.16 (#2092)

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

CONTRIBUTING.md

@@ -38,6 +38,7 @@ npm install -g pnpm
 
 ```shell
 pnpm install
+pnpm install -g tsx
 ```
 
 ### Build the packages
@@ -48,6 +49,56 @@ To build all packages, run:
 pnpm build
 ```
 
+### Start Developing
+
+You can launch the package in dev-mode by running:
+
+```shell
+pnpm dev
+```
+
+This will use turbo to run all packages in watch-mode. This means you can make changes and have them automatically built.
+
+If you want to customize what packages are built/watched, you can run turbo directly and adjust the filter:
+
+```shell
+pnpm turbo run dev --filter="./packages/core" --concurrency=100
+```
+
+In another terminal, you can write and run any script needed to quickly test your changes. For example:
+
+```typescript
+import { createMemory, staticBlock } from "@llamaindex/core/memory";
+
+// Create memory with predefined context
+const memory = createMemory({
+  memoryBlocks: [
+    staticBlock({
+      content:
+        "The user is a software engineer who loves TypeScript and LlamaIndex.",
+      messageRole: "system",
+    }),
+  ],
+});
+
+async function main() {
+  const result = await memory.getLLM();
+  console.log(result);
+}
+
+void main().catch(console.error);
+```
+
+And run it with:
+
+```shell
+pnpm exec tsx my_script.ts
+```
+
+This flow allows you to easily test your changes without having to build the entire project.
+
+Once you are happy with your changes, be sure to add tests (and confirm existing tests are passing!).
+
 ### Run tests
 
 #### Unit tests
@@ -92,7 +143,7 @@ Before sending a PR, make sure of the following:
 3. If you have a new feature, add a new example in the `examples` folder.
 4. You have a descriptive changeset for each PR:
 
-### Changesets
+### Bumping the versions of packages you've modified
 
 We use [changesets](https://github.com/changesets/changesets) for managing versions and changelogs. To create a new
 changeset, run in the root folder:
@@ -101,6 +152,8 @@ changeset, run in the root folder:
 pnpm changeset
 ```
 
+You will be prompted to choose what packages need their versions bumped, and what kind of bump (major, minor or patch) is needed. Once you carry out this operation, the bumping will be automatic after the PR is merged.
+
 ## Publishing (maintainers only)
 
 The [Release Github Action](.github/workflows/release.yml) is automatically generating and updating a

apps/next/CHANGELOG.md

@@ -1,5 +1,51 @@
 # @llamaindex/doc
 
+## 0.2.37
+
+### Patch Changes
+
+- Updated dependencies [579ca0c]
+  - @llamaindex/cloud@4.0.21
+  - llamaindex@0.11.16
+
+## 0.2.36
+
+### Patch Changes
+
+- Updated dependencies [48b0d88]
+- Updated dependencies [f185772]
+  - @llamaindex/cloud@4.0.20
+  - llamaindex@0.11.15
+
+## 0.2.35
+
+### Patch Changes
+
+- Updated dependencies [5a0ed1f]
+- Updated dependencies [5a0ed1f]
+- Updated dependencies [8eeac33]
+  - @llamaindex/cloud@4.0.19
+  - @llamaindex/core@0.6.14
+  - llamaindex@0.11.14
+  - @llamaindex/node-parser@2.0.14
+  - @llamaindex/openai@0.4.8
+  - @llamaindex/readers@3.1.13
+  - @llamaindex/workflow@1.1.14
+
+## 0.2.34
+
+### Patch Changes
+
+- 39758ab: Add title to homepage header
+
+## 0.2.33
+
+### Patch Changes
+
+- Updated dependencies [47a7555]
+  - @llamaindex/cloud@4.0.18
+  - llamaindex@0.11.13
+
 ## 0.2.32
 
 ### Patch Changes

apps/next/components.json

@@ -12,9 +12,9 @@
   },
   "aliases": {
     "components": "@/components",
-    "utils": "@/lib/utils",
+    "utils": "@/libs/utils",
     "ui": "@/components/ui",
-    "lib": "@/lib",
+    "lib": "@/libs",
     "hooks": "@/hooks"
   }
 }

apps/next/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/doc",
-  "version": "0.2.32",
+  "version": "0.2.37",
   "private": true,
   "scripts": {
     "postinstall": "fumadocs-mdx",
@@ -35,7 +35,7 @@
     "@radix-ui/react-tooltip": "^1.1.4",
     "@scalar/api-client-react": "^1.1.25",
     "@vercel/functions": "^1.5.0",
-    "ai": "^3.4.33",
+    "ai": "^4.3.17",
     "class-variance-authority": "^0.7.0",
     "clsx": "2.1.1",
     "foxact": "^0.2.41",
@@ -50,7 +50,7 @@
     "hast-util-to-jsx-runtime": "^2.3.2",
     "llamaindex": "workspace:*",
     "lucide-react": "^0.460.0",
-    "next": "^15.3.0",
+    "next": "^15.3.3",
     "next-themes": "^0.4.3",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
@@ -70,30 +70,30 @@
     "twoslash": "^0.3.1",
     "use-stick-to-bottom": "^1.0.42",
     "web-tree-sitter": "^0.24.4",
-    "zod": "^3.25.67"
+    "zod": "^3.25.76"
   },
   "devDependencies": {
     "@next/env": "^15.3.0",
     "@tailwindcss/postcss": "^4.0.9",
     "@types/mdx": "^2.0.13",
-    "@types/node": "22.9.0",
-    "@types/react": "^19.0.10",
-    "@types/react-dom": "^19.0.4",
+    "@types/node": "24.0.13",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
     "autoprefixer": "^10.4.20",
     "cross-env": "^7.0.3",
     "fast-glob": "^3.3.2",
     "gray-matter": "^4.0.3",
-    "postcss": "^8.5.3",
+    "postcss": "^8.5.6",
     "raw-loader": "^4.0.2",
     "remark": "^15.0.1",
     "remark-gfm": "^4.0.0",
     "remark-mdx": "^3.1.0",
     "remark-stringify": "^11.0.0",
-    "tailwindcss": "^4.0.9",
-    "tsx": "^4.19.3",
+    "tailwindcss": "^4.1.11",
+    "tsx": "^4.20.3",
     "typedoc": "0.28.3",
     "typedoc-plugin-markdown": "^4.6.2",
     "typedoc-plugin-merge-modules": " ^7.0.0",
-    "typescript": "^5.7.3"
+    "typescript": "^5.8.3"
   }
 }

apps/next/src/app/(home)/page.tsx

@@ -10,7 +10,7 @@ import { MagicMove } from "@/components/magic-move";
 import { NpmInstall } from "@/components/npm-install";
 import { Supports } from "@/components/supports";
 import { Button } from "@/components/ui/button";
-import { DOCUMENT_URL } from "@/lib/const";
+import { DOCUMENT_URL } from "@/libs/const";
 import { SiStackblitz } from "@icons-pack/react-simple-icons";
 import { Blocks, Bot, Footprints, Terminal } from "lucide-react";
 import Link from "next/link";

apps/next/src/app/api/search/route.ts

@@ -1,4 +1,4 @@
-import { source } from "@/lib/source";
+import { source } from "@/libs/source";
 import { structure } from "fumadocs-core/mdx-plugins";
 import { createFromSource } from "fumadocs-core/search/server";
 

apps/next/src/app/docs/[[...slug]]/page.tsx

@@ -1,6 +1,6 @@
 import * as demos from "@/components/demo/lazy";
-import { createMetadata, metadataImage } from "@/lib/metadata";
-import { openapi, source } from "@/lib/source";
+import { createMetadata, metadataImage } from "@/libs/metadata";
+import { openapi, source } from "@/libs/source";
 import * as Icons from "@icons-pack/react-simple-icons";
 import { APIPage } from "fumadocs-openapi/ui";
 import { Popup, PopupContent, PopupTrigger } from "fumadocs-twoslash/ui";

apps/next/src/app/docs/layout.tsx

@@ -1,5 +1,5 @@
 import { baseOptions } from "@/app/layout.config";
-import { source } from "@/lib/source";
+import { source } from "@/libs/source";
 import "fumadocs-twoslash/twoslash.css";
 import { DocsLayout } from "fumadocs-ui/layouts/docs";
 import type { ReactNode } from "react";

apps/next/src/app/layout.config.tsx

@@ -1,4 +1,4 @@
-import { DOCUMENT_URL } from "@/lib/const";
+import { DOCUMENT_URL } from "@/libs/const";
 import type { BaseLayoutProps } from "fumadocs-ui/layouts/shared";
 import Image from "next/image";
 

apps/next/src/app/layout.tsx

@@ -32,6 +32,9 @@ export default function Layout({ children }: { children: ReactNode }) {
           sizes="16x16"
           href="/favicon-16x16.png"
         />
+        <title>
+          LlamaIndex.TS - Build LLM-powered document agents and workflows
+        </title>
       </head>
       <body className="flex min-h-screen flex-col">
         <TooltipProvider>

apps/next/src/app/og/[...slug]/route.tsx

@@ -1,5 +1,5 @@
 import { generateOGImage } from "@/app/og/[...slug]/og";
-import { metadataImage } from "@/lib/metadata";
+import { metadataImage } from "@/libs/metadata";
 import { type ImageResponse } from "next/og";
 import { readFileSync } from "node:fs";
 

apps/next/src/components/contribution.tsx

@@ -1,6 +1,6 @@
 import ContributorCounter from "@/components/contributor-count";
 import { buttonVariants } from "@/components/ui/button";
-import { cn } from "@/lib/utils";
+import { cn } from "@/libs/utils";
 import { Heart } from "lucide-react";
 import { ReactElement } from "react";
 

apps/next/src/components/contributor-count.tsx

@@ -1,5 +1,5 @@
-import { fetchContributors } from "@/lib/get-contributors";
-import { cn } from "@/lib/utils";
+import { fetchContributors } from "@/libs/get-contributors";
+import { cn } from "@/libs/utils";
 import Image from "next/image";
 import type { HTMLAttributes, ReactElement } from "react";
 

apps/next/src/components/create-app-animation.tsx

@@ -1,5 +1,5 @@
 "use client";
-import { cn } from "@/lib/utils";
+import { cn } from "@/libs/utils";
 import { TerminalIcon } from "lucide-react";
 import {
   Fragment,

apps/next/src/components/feature.tsx

@@ -1,4 +1,4 @@
-import { cn } from "@/lib/utils";
+import { cn } from "@/libs/utils";
 import { LucideIcon } from "lucide-react";
 import { HTMLAttributes, ReactElement, ReactNode } from "react";
 

apps/next/src/components/magic-move.tsx

@@ -1,6 +1,6 @@
 "use client";
 import { Button } from "@/components/ui/button";
-import { cn } from "@/lib/utils";
+import { cn } from "@/libs/utils";
 import { CodeBlock } from "fumadocs-ui/components/codeblock";
 import { RotateCcw } from "lucide-react";
 import { useTheme } from "next-themes";

apps/next/src/components/message.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { cn } from "@/lib/utils";
+import { cn } from "@/libs/utils";
 import Image from "next/image";
 import { ReactNode } from "react";
 import { IconAI, IconUser } from "./ui/icons";

apps/next/src/components/reactbits/rotating-text.tsx

@@ -1,4 +1,4 @@
-import { cn } from "@/lib/utils";
+import { cn } from "@/libs/utils";
 import {
   AnimatePresence,
   motion,

apps/next/src/components/ui/alert.tsx

@@ -1,7 +1,7 @@
 import { cva, type VariantProps } from "class-variance-authority";
 import * as React from "react";
 
-import { cn } from "@/lib/utils";
+import { cn } from "@/libs/utils";
 
 const alertVariants = cva(
   "relative w-full rounded-lg border px-4 py-3 text-sm [&>svg+div]:translate-y-[-3px] [&>svg]:absolute [&>svg]:left-4 [&>svg]:top-4 [&>svg]:text-foreground [&>svg~*]:pl-7",

apps/next/src/components/ui/badge.tsx

@@ -1,7 +1,7 @@
 import { cva, type VariantProps } from "class-variance-authority";
 import * as React from "react";
 
-import { cn } from "@/lib/utils";
+import { cn } from "@/libs/utils";
 
 const badgeVariants = cva(
   "inline-flex items-center rounded-md border px-2.5 py-0.5 text-xs font-semibold transition-colors focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2",

apps/next/src/components/ui/button.tsx

@@ -2,7 +2,7 @@ import { Slot } from "@radix-ui/react-slot";
 import { cva, type VariantProps } from "class-variance-authority";
 import * as React from "react";
 
-import { cn } from "@/lib/utils";
+import { cn } from "@/libs/utils";
 
 const buttonVariants = cva(
   "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0",

apps/next/src/components/ui/dialog.tsx

@@ -4,7 +4,7 @@ import * as DialogPrimitive from "@radix-ui/react-dialog";
 import { Cross2Icon } from "@radix-ui/react-icons";
 import * as React from "react";
 
-import { cn } from "@/lib/utils";
+import { cn } from "@/libs/utils";
 
 const Dialog = DialogPrimitive.Root;
 

apps/next/src/components/ui/icons.tsx

@@ -1,4 +1,4 @@
-import { cn } from "@/lib/utils";
+import { cn } from "@/libs/utils";
 
 export function IconAI({ className, ...props }: React.ComponentProps<"svg">) {
   return (

apps/next/src/components/ui/infinite-slider.tsx

@@ -1,5 +1,5 @@
 "use client";
-import { cn } from "@/lib/utils";
+import { cn } from "@/libs/utils";
 import { animate, motion, useMotionValue } from "framer-motion";
 import { useEffect, useState } from "react";
 import useMeasure from "react-use-measure";

apps/next/src/components/ui/input.tsx

@@ -1,6 +1,6 @@
 import * as React from "react";
 
-import { cn } from "@/lib/utils";
+import { cn } from "@/libs/utils";
 
 export type InputProps = React.InputHTMLAttributes<HTMLInputElement>;
 

apps/next/src/components/ui/label.tsx

@@ -4,7 +4,7 @@ import * as LabelPrimitive from "@radix-ui/react-label";
 import { cva, type VariantProps } from "class-variance-authority";
 import * as React from "react";
 
-import { cn } from "@/lib/utils";
+import { cn } from "@/libs/utils";
 
 const labelVariants = cva(
   "text-sm font-medium leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-70",

apps/next/src/components/ui/skeleton.tsx

@@ -1,4 +1,4 @@
-import { cn } from "@/lib/utils";
+import { cn } from "@/libs/utils";
 
 function Skeleton({
   className,

apps/next/src/components/ui/slider.tsx

@@ -3,7 +3,7 @@
 import * as SliderPrimitive from "@radix-ui/react-slider";
 import * as React from "react";
 
-import { cn } from "@/lib/utils";
+import { cn } from "@/libs/utils";
 
 const Slider = React.forwardRef<
   React.ElementRef<typeof SliderPrimitive.Root>,

apps/next/src/components/ui/textarea.tsx

@@ -1,6 +1,6 @@
 import * as React from "react";
 
-import { cn } from "@/lib/utils";
+import { cn } from "@/libs/utils";
 
 export type TextareaProps = React.TextareaHTMLAttributes<HTMLTextAreaElement>;
 

apps/next/src/components/ui/tooltip.tsx

@@ -3,7 +3,7 @@
 import * as TooltipPrimitive from "@radix-ui/react-tooltip";
 import * as React from "react";
 
-import { cn } from "@/lib/utils";
+import { cn } from "@/libs/utils";
 
 const TooltipProvider = TooltipPrimitive.Provider;
 

apps/next/src/lib/metadata.ts

@@ -1,30 +0,0 @@
-import { createMetadataImage } from 'fumadocs-core/server';
-import { source } from '@/lib/source';
-import { Metadata } from 'next';
-
-export const metadataImage = createMetadataImage({
-	source,
-	imageRoute: 'og',
-});
-
-export function createMetadata(override: Metadata): Metadata {
-	return {
-		...override,
-		openGraph: {
-			title: override.title ?? undefined,
-			description: override.description ?? undefined,
-			url: 'https://ts.llamaindex.ai/',
-			images: '/og.png',
-			siteName: 'LlamaIndex.TS',
-			...override.openGraph,
-		},
-		twitter: {
-			card: 'summary_large_image',
-			creator: '@llama_index',
-			title: override.title ?? undefined,
-			description: override.description ?? undefined,
-			images: '/og.png',
-			...override.twitter,
-		},
-	};
-}

apps/next/src/lib/utils.ts

@@ -1,6 +0,0 @@
-import { clsx, type ClassValue } from "clsx"
-import { twMerge } from "tailwind-merge"
-
-export function cn(...inputs: ClassValue[]) {
-  return twMerge(clsx(inputs))
-}

apps/next/src/libs/const.ts

@@ -1,2 +1,2 @@
 // when we are ready, change to /docs/llamaindex
-export const DOCUMENT_URL = '/docs/llamaindex'
+export const DOCUMENT_URL = "/docs/llamaindex";

apps/next/src/libs/get-contributors.ts

@@ -10,7 +10,7 @@ export async function fetchContributors(
 ): Promise<Contributor[]> {
   const headers = new Headers();
   if (process.env.GITHUB_TOKEN)
-    headers.set('Authorization', `Bearer ${process.env.GITHUB_TOKEN}`);
+    headers.set("Authorization", `Bearer ${process.env.GITHUB_TOKEN}`);
 
   const response = await fetch(
     `https://api.github.com/repos/${repoOwner}/${repoName}/contributors?per_page=50`,
@@ -26,6 +26,6 @@ export async function fetchContributors(
 
   const contributors = (await response.json()) as Contributor[];
   return contributors
-    .filter((contributor) => !contributor.login.endsWith('[bot]'))
+    .filter((contributor) => !contributor.login.endsWith("[bot]"))
     .sort((a, b) => b.contributions - a.contributions);
 }

apps/next/src/libs/metadata.ts

@@ -0,0 +1,30 @@
+import { source } from "@/libs/source";
+import { createMetadataImage } from "fumadocs-core/server";
+import { Metadata } from "next";
+
+export const metadataImage = createMetadataImage({
+  source,
+  imageRoute: "og",
+});
+
+export function createMetadata(override: Metadata): Metadata {
+  return {
+    ...override,
+    openGraph: {
+      title: override.title ?? undefined,
+      description: override.description ?? undefined,
+      url: "https://ts.llamaindex.ai/",
+      images: "/og.png",
+      siteName: "LlamaIndex.TS",
+      ...override.openGraph,
+    },
+    twitter: {
+      card: "summary_large_image",
+      creator: "@llama_index",
+      title: override.title ?? undefined,
+      description: override.description ?? undefined,
+      images: "/og.png",
+      ...override.twitter,
+    },
+  };
+}

apps/next/src/libs/source.ts

@@ -1,9 +1,9 @@
-import { docs } from '@/.source';
-import { loader } from 'fumadocs-core/source';
+import { docs } from "@/.source";
+import { loader } from "fumadocs-core/source";
 import { createOpenAPI } from "fumadocs-openapi/server";
 
 export const source = loader({
-  baseUrl: '/docs',
+  baseUrl: "/docs",
   source: docs.toFumadocsSource(),
 });
 

apps/next/src/libs/utils.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}

e2e/examples/cloudflare-hono/package.json

@@ -11,7 +11,7 @@
   },
   "devDependencies": {
     "@cloudflare/workers-types": "^4.20241112.0",
-    "typescript": "^5.7.3",
+    "typescript": "^5.8.3",
     "wrangler": "^3.89.0"
   },
   "dependencies": {

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

@@ -1,5 +1,29 @@
 # @llamaindex/cloudflare-worker-agent-test
 
+## 0.0.177
+
+### Patch Changes
+
+- llamaindex@0.11.16
+
+## 0.0.176
+
+### Patch Changes
+
+- llamaindex@0.11.15
+
+## 0.0.175
+
+### Patch Changes
+
+- llamaindex@0.11.14
+
+## 0.0.174
+
+### Patch Changes
+
+- llamaindex@0.11.13
+
 ## 0.0.173
 
 ### Patch Changes

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

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/cloudflare-worker-agent-test",
-  "version": "0.0.173",
+  "version": "0.0.177",
   "type": "module",
   "private": true,
   "scripts": {
@@ -16,7 +16,7 @@
     "@cloudflare/workers-types": "^4.20241112.0",
     "@vitest/runner": "2.1.5",
     "@vitest/snapshot": "2.1.5",
-    "typescript": "^5.7.3",
+    "typescript": "^5.8.3",
     "vitest": "2.1.5",
     "wrangler": "^3.87.0"
   },

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

@@ -1,5 +1,35 @@
 # @llamaindex/llama-parse-browser-test
 
+## 0.0.76
+
+### Patch Changes
+
+- Updated dependencies [579ca0c]
+  - @llamaindex/cloud@4.0.21
+
+## 0.0.75
+
+### Patch Changes
+
+- Updated dependencies [48b0d88]
+- Updated dependencies [f185772]
+  - @llamaindex/cloud@4.0.20
+
+## 0.0.74
+
+### Patch Changes
+
+- Updated dependencies [5a0ed1f]
+- Updated dependencies [5a0ed1f]
+  - @llamaindex/cloud@4.0.19
+
+## 0.0.73
+
+### Patch Changes
+
+- Updated dependencies [47a7555]
+  - @llamaindex/cloud@4.0.18
+
 ## 0.0.72
 
 ### Patch Changes

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

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/llama-parse-browser-test",
   "private": true,
-  "version": "0.0.72",
+  "version": "0.0.76",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -9,7 +9,7 @@
     "preview": "vite preview"
   },
   "devDependencies": {
-    "typescript": "^5.7.3",
+    "typescript": "^5.8.3",
     "vite": "^6.3.3",
     "vite-plugin-wasm": "^3.4.1"
   },

e2e/examples/nextjs-agent/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @llamaindex/next-agent-test
 
+## 0.1.177
+
+### Patch Changes
+
+- llamaindex@0.11.16
+
+## 0.1.176
+
+### Patch Changes
+
+- llamaindex@0.11.15
+
+## 0.1.175
+
+### Patch Changes
+
+- llamaindex@0.11.14
+
+## 0.1.174
+
+### Patch Changes
+
+- llamaindex@0.11.13
+
 ## 0.1.173
 
 ### Patch Changes

e2e/examples/nextjs-agent/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/next-agent-test",
-  "version": "0.1.173",
+  "version": "0.1.177",
   "private": true,
   "scripts": {
     "dev": "next dev",
@@ -8,18 +8,18 @@
     "start": "next start"
   },
   "dependencies": {
-    "ai": "^4.0.0",
+    "ai": "^4.3.17",
     "llamaindex": "workspace:*",
-    "next": "^15.3.0",
+    "next": "^15.3.3",
     "react": "19.0.0",
     "react-dom": "19.0.0"
   },
   "devDependencies": {
-    "@types/node": "^22.9.0",
-    "@types/react": "^19.0.10",
-    "@types/react-dom": "^19.0.4",
-    "eslint": "9.16.0",
-    "eslint-config-next": "15.1.0",
-    "typescript": "^5.7.3"
+    "@types/node": "^24.0.13",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
+    "eslint": "9.30.1",
+    "eslint-config-next": "15.3.5",
+    "typescript": "^5.8.3"
   }
 }

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

@@ -1,5 +1,29 @@
 # test-edge-runtime
 
+## 0.1.176
+
+### Patch Changes
+
+- llamaindex@0.11.16
+
+## 0.1.175
+
+### Patch Changes
+
+- llamaindex@0.11.15
+
+## 0.1.174
+
+### Patch Changes
+
+- llamaindex@0.11.14
+
+## 0.1.173
+
+### Patch Changes
+
+- llamaindex@0.11.13
+
 ## 0.1.172
 
 ### Patch Changes

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

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/nextjs-edge-runtime-test",
-  "version": "0.1.172",
+  "version": "0.1.176",
   "private": true,
   "scripts": {
     "dev": "next dev",
@@ -9,14 +9,14 @@
   },
   "dependencies": {
     "llamaindex": "workspace:*",
-    "next": "^15.3.0",
+    "next": "^15.3.3",
     "react": "^19.1.0",
     "react-dom": "^19.1.0"
   },
   "devDependencies": {
-    "@types/node": "^22.9.0",
-    "@types/react": "^19.0.10",
-    "@types/react-dom": "^19.0.4",
-    "typescript": "^5.7.3"
+    "@types/node": "^24.0.13",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
+    "typescript": "^5.8.3"
   }
 }

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

@@ -1,5 +1,31 @@
 # @llamaindex/next-node-runtime
 
+## 0.1.45
+
+### Patch Changes
+
+- llamaindex@0.11.16
+
+## 0.1.44
+
+### Patch Changes
+
+- llamaindex@0.11.15
+
+## 0.1.43
+
+### Patch Changes
+
+- llamaindex@0.11.14
+- @llamaindex/huggingface@0.1.18
+- @llamaindex/readers@3.1.13
+
+## 0.1.42
+
+### Patch Changes
+
+- llamaindex@0.11.13
+
 ## 0.1.41
 
 ### Patch Changes

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

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/next-node-runtime-test",
-  "version": "0.1.41",
+  "version": "0.1.45",
   "private": true,
   "scripts": {
     "dev": "next dev",
@@ -11,16 +11,16 @@
     "@llamaindex/huggingface": "workspace:*",
     "@llamaindex/readers": "workspace:*",
     "llamaindex": "workspace:*",
-    "next": "^15.3.0",
+    "next": "^15.3.3",
     "react": "19.0.0",
     "react-dom": "19.0.0"
   },
   "devDependencies": {
-    "@types/node": "^22.9.0",
-    "@types/react": "^19.0.10",
-    "@types/react-dom": "^19.0.4",
-    "eslint": "9.16.0",
-    "eslint-config-next": "15.1.0",
-    "typescript": "^5.7.3"
+    "@types/node": "^24.0.13",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
+    "eslint": "9.30.1",
+    "eslint-config-next": "15.3.5",
+    "typescript": "^5.8.3"
   }
 }

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

@@ -1,5 +1,29 @@
 # vite-import-llamaindex
 
+## 0.0.43
+
+### Patch Changes
+
+- llamaindex@0.11.16
+
+## 0.0.42
+
+### Patch Changes
+
+- llamaindex@0.11.15
+
+## 0.0.41
+
+### Patch Changes
+
+- llamaindex@0.11.14
+
+## 0.0.40
+
+### Patch Changes
+
+- llamaindex@0.11.13
+
 ## 0.0.39
 
 ### Patch Changes

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

@@ -1,7 +1,7 @@
 {
   "name": "vite-import-llamaindex",
   "private": true,
-  "version": "0.0.39",
+  "version": "0.0.43",
   "type": "module",
   "scripts": {
     "build": "vite build",
@@ -15,7 +15,7 @@
   "devDependencies": {
     "@size-limit/preset-big-lib": "^11.1.6",
     "size-limit": "^11.1.6",
-    "typescript": "^5.7.3",
+    "typescript": "^5.8.3",
     "vite": "^6.3.3"
   },
   "dependencies": {

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

@@ -1,9 +1 @@
-{
-  "root": [
-    "./src/main.ts",
-    "./vite.config.ts",
-    "./tsconfig.json"
-  ],
-  "errors": true,
-  "version": "5.7.3"
-}
+{"root":["./src/main.ts","./vite.config.ts"],"version":"5.7.3"}

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

@@ -1,5 +1,29 @@
 # @llamaindex/waku-query-engine-test
 
+## 0.0.177
+
+### Patch Changes
+
+- llamaindex@0.11.16
+
+## 0.0.176
+
+### Patch Changes
+
+- llamaindex@0.11.15
+
+## 0.0.175
+
+### Patch Changes
+
+- llamaindex@0.11.14
+
+## 0.0.174
+
+### Patch Changes
+
+- llamaindex@0.11.13
+
 ## 0.0.173
 
 ### Patch Changes

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

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/waku-query-engine-test",
-  "version": "0.0.173",
+  "version": "0.0.177",
   "type": "module",
   "private": true,
   "scripts": {
@@ -18,10 +18,10 @@
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.1.4",
-    "@types/react": "19.0.10",
-    "@types/react-dom": "19.0.4",
+    "@types/react": "19.1.8",
+    "@types/react-dom": "19.1.6",
     "rollup": "4.38.0",
-    "tailwindcss": "^4.1.4",
-    "typescript": "5.7.3"
+    "tailwindcss": "^4.1.11",
+    "typescript": "5.8.3"
   }
 }

e2e/package.json

@@ -19,14 +19,14 @@
     "@llamaindex/openai": "workspace:*",
     "@llamaindex/pinecone": "workspace:*",
     "@llamaindex/postgres": "workspace:*",
-    "@types/node": "^22.9.0",
+    "@types/node": "^24.0.13",
     "@types/pg": "^8.11.8",
     "consola": "^3.2.3",
-    "dotenv": "^16.4.5",
+    "dotenv": "^17.2.0",
     "llamaindex": "workspace:*",
     "pg": "^8.12.0",
     "pgvector": "0.2.0",
-    "tsx": "^4.19.3",
-    "zod": "^3.25.67"
+    "tsx": "^4.20.3",
+    "zod": "^3.25.76"
   }
 }

examples/CHANGELOG.md

@@ -1,5 +1,78 @@
 # examples
 
+## 0.3.29
+
+### Patch Changes
+
+- Updated dependencies [af3f866]
+  - @llamaindex/deepseek@0.0.25
+
+## 0.3.28
+
+### Patch Changes
+
+- 36773a8: Fixed start script, reverted some changes to imports
+- 891562d: Fix xai dependency in the examples
+- Updated dependencies [5a0ed1f]
+- Updated dependencies [5a0ed1f]
+- Updated dependencies [8eeac33]
+  - @llamaindex/cloud@4.0.19
+  - @llamaindex/core@0.6.14
+  - llamaindex@0.11.14
+  - @llamaindex/node-parser@2.0.14
+  - @llamaindex/anthropic@0.3.16
+  - @llamaindex/assemblyai@0.1.13
+  - @llamaindex/clip@0.0.64
+  - @llamaindex/cohere@0.0.28
+  - @llamaindex/deepinfra@0.0.64
+  - @llamaindex/discord@0.1.13
+  - @llamaindex/google@0.3.13
+  - @llamaindex/huggingface@0.1.18
+  - @llamaindex/jinaai@0.0.24
+  - @llamaindex/mistral@0.1.14
+  - @llamaindex/mixedbread@0.0.28
+  - @llamaindex/notion@0.1.13
+  - @llamaindex/ollama@0.1.14
+  - @llamaindex/openai@0.4.8
+  - @llamaindex/perplexity@0.0.21
+  - @llamaindex/portkey-ai@0.0.56
+  - @llamaindex/replicate@0.0.56
+  - @llamaindex/bm25-retriever@0.0.3
+  - @llamaindex/astra@0.0.28
+  - @llamaindex/azure@0.1.25
+  - @llamaindex/chroma@0.0.28
+  - @llamaindex/elastic-search@0.1.14
+  - @llamaindex/firestore@1.0.21
+  - @llamaindex/milvus@0.1.23
+  - @llamaindex/mongodb@0.0.29
+  - @llamaindex/pinecone@0.1.14
+  - @llamaindex/postgres@0.0.57
+  - @llamaindex/qdrant@0.1.24
+  - @llamaindex/supabase@0.1.14
+  - @llamaindex/upstash@0.0.28
+  - @llamaindex/weaviate@0.0.29
+  - @llamaindex/vercel@0.1.14
+  - @llamaindex/voyage-ai@1.0.20
+  - @llamaindex/readers@3.1.13
+  - @llamaindex/tools@0.1.4
+  - @llamaindex/workflow@1.1.14
+  - @llamaindex/deepseek@0.0.24
+  - @llamaindex/fireworks@0.0.24
+  - @llamaindex/groq@0.0.80
+  - @llamaindex/together@0.0.24
+  - @llamaindex/vllm@0.0.50
+  - @llamaindex/xai@0.0.11
+
+## 0.3.27
+
+### Patch Changes
+
+- Updated dependencies [229cdeb]
+- Updated dependencies [47a7555]
+  - @llamaindex/groq@0.0.79
+  - @llamaindex/cloud@4.0.18
+  - llamaindex@0.11.13
+
 ## 0.3.26
 
 ### Patch Changes

examples/README.md

@@ -1,9 +1,10 @@
 # LlamaIndexTS Examples
 
-Before running any of the code examples,
-make sure you have basic knowledge of the [LlamaIndexTS](https://ts.llamaindex.ai/).
+This package contains several examples of how to use LlamaIndexTS.
 
-## Usage
+Most examples will use OpenAI by default, so be sure to set your API key.
+
+## Running Examples
 
 ```shell
 # export your API key
@@ -12,8 +13,31 @@ export OPENAI_API_KEY="sk-..."
 npx tsx ./rag/chatEngine.ts
 ```
 
-## Build your own RAG app
+## Recommended Starter Examples
 
-```shell
-npx create llama
-```
+Agents:
+
+- [Basic OpenAI Agent with Tools](./agents/agent/openai.ts)
+- [Agent with MCP Tools](./agents/agent/mcp-tools.ts)
+- [Customizing Memory](./agents/memory/agent-memory.ts)
+
+Workflows:
+
+- [Workflow basics](./agents/workflow/joke.ts)
+- [Find more workflow examples in the `workflows-ts` repo!](https://github.com/run-llama/workflows-ts)
+
+Indexing, Retrieval, and Querying:
+
+- [Basic Vector Indexing + Query Engine](./index/vectorIndex.ts)
+- [Agent + Query Engine Tool](./agents/agent/query-tool.ts)
+
+Multimodal:
+
+- [Multimodal RAG](./multimodal/rag.ts)
+- [Multimodal Chat](./multimodal/context.ts)
+
+Some more general folders that might be useful to explore:
+
+- [storage](./storage/): Examples with various vector stores
+- [readers](./readers/): Examples of how to use the various readers
+- [models](./models/): Examples of how to use the various LLMs and embedding models from many providers

examples/models/openai/live/browser/open-ai-realtime/package.json

@@ -15,15 +15,15 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.25.0",
-    "@types/react": "^19.1.2",
-    "@types/react-dom": "^19.1.2",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
     "@vitejs/plugin-react": "^4.5.2",
-    "eslint": "^9.25.0",
+    "eslint": "^9.30.1",
     "eslint-plugin-react-hooks": "^5.2.0",
     "eslint-plugin-react-refresh": "^0.4.19",
     "globals": "^16.0.0",
     "typescript": "~5.8.3",
-    "typescript-eslint": "^8.30.1",
+    "typescript-eslint": "^8.36.0",
     "vite": "^6.3.5"
   }
 }

examples/package.json

@@ -1,80 +1,80 @@
 {
   "name": "@llamaindex/examples",
-  "version": "0.3.26",
+  "version": "0.3.29",
   "private": true,
   "scripts": {
     "lint": "eslint .",
-    "start": "tsx ./starter.ts"
+    "start": "echo 'To get started, run `npx tsx <path to example>`'"
   },
   "dependencies": {
     "@ai-sdk/openai": "^1.0.5",
     "@azure/cosmos": "^4.1.1",
     "@azure/identity": "^4.4.1",
     "@azure/search-documents": "^12.1.0",
-    "@llamaindex/anthropic": "^0.3.15",
-    "@llamaindex/assemblyai": "^0.1.12",
-    "@llamaindex/astra": "^0.0.27",
-    "@llamaindex/azure": "^0.1.24",
-    "@llamaindex/bm25-retriever": "^0.0.2",
-    "@llamaindex/chroma": "^0.0.27",
-    "@llamaindex/clip": "^0.0.63",
-    "@llamaindex/cloud": "^4.0.17",
-    "@llamaindex/cohere": "^0.0.27",
-    "@llamaindex/core": "^0.6.13",
-    "@llamaindex/deepinfra": "^0.0.63",
-    "@llamaindex/deepseek": "^0.0.23",
-    "@llamaindex/discord": "^0.1.12",
-    "@llamaindex/elastic-search": "^0.1.13",
+    "@llamaindex/anthropic": "^0.3.16",
+    "@llamaindex/assemblyai": "^0.1.13",
+    "@llamaindex/astra": "^0.0.28",
+    "@llamaindex/azure": "^0.1.25",
+    "@llamaindex/bm25-retriever": "^0.0.3",
+    "@llamaindex/chroma": "^0.0.28",
+    "@llamaindex/clip": "^0.0.64",
+    "@llamaindex/cloud": "^4.0.19",
+    "@llamaindex/cohere": "^0.0.28",
+    "@llamaindex/core": "^0.6.14",
+    "@llamaindex/deepinfra": "^0.0.64",
+    "@llamaindex/deepseek": "^0.0.25",
+    "@llamaindex/discord": "^0.1.13",
+    "@llamaindex/elastic-search": "^0.1.14",
     "@llamaindex/env": "^0.1.30",
-    "@llamaindex/firestore": "^1.0.20",
-    "@llamaindex/fireworks": "^0.0.23",
-    "@llamaindex/google": "^0.3.12",
-    "@llamaindex/groq": "^0.0.78",
-    "@llamaindex/huggingface": "^0.1.17",
-    "@llamaindex/jinaai": "^0.0.23",
-    "@llamaindex/milvus": "^0.1.22",
-    "@llamaindex/mistral": "^0.1.13",
-    "@llamaindex/mixedbread": "^0.0.27",
-    "@llamaindex/mongodb": "^0.0.28",
-    "@llamaindex/node-parser": "^2.0.13",
-    "@llamaindex/notion": "^0.1.12",
-    "@llamaindex/ollama": "^0.1.13",
-    "@llamaindex/openai": "^0.4.7",
-    "@llamaindex/perplexity": "^0.0.20",
-    "@llamaindex/pinecone": "^0.1.13",
-    "@llamaindex/portkey-ai": "^0.0.55",
-    "@llamaindex/postgres": "^0.0.56",
-    "@llamaindex/qdrant": "^0.1.23",
-    "@llamaindex/readers": "^3.1.12",
-    "@llamaindex/replicate": "^0.0.55",
-    "@llamaindex/supabase": "^0.1.13",
-    "@llamaindex/together": "^0.0.23",
-    "@llamaindex/tools": "^0.1.3",
-    "@llamaindex/upstash": "^0.0.27",
-    "@llamaindex/vercel": "^0.1.13",
-    "@llamaindex/vllm": "^0.0.49",
-    "@llamaindex/voyage-ai": "^1.0.19",
-    "@llamaindex/weaviate": "^0.0.28",
-    "@llamaindex/workflow": "^1.1.13",
-    "@llamaindex/xai": "workspace:^0.0.10",
-    "@notionhq/client": "^2.2.15",
+    "@llamaindex/firestore": "^1.0.21",
+    "@llamaindex/fireworks": "^0.0.24",
+    "@llamaindex/google": "^0.3.13",
+    "@llamaindex/groq": "^0.0.80",
+    "@llamaindex/huggingface": "^0.1.18",
+    "@llamaindex/jinaai": "^0.0.24",
+    "@llamaindex/milvus": "^0.1.23",
+    "@llamaindex/mistral": "^0.1.14",
+    "@llamaindex/mixedbread": "^0.0.28",
+    "@llamaindex/mongodb": "^0.0.29",
+    "@llamaindex/node-parser": "^2.0.14",
+    "@llamaindex/notion": "^0.1.13",
+    "@llamaindex/ollama": "^0.1.14",
+    "@llamaindex/openai": "^0.4.8",
+    "@llamaindex/perplexity": "^0.0.21",
+    "@llamaindex/pinecone": "^0.1.14",
+    "@llamaindex/portkey-ai": "^0.0.56",
+    "@llamaindex/postgres": "^0.0.57",
+    "@llamaindex/qdrant": "^0.1.24",
+    "@llamaindex/readers": "^3.1.13",
+    "@llamaindex/replicate": "^0.0.56",
+    "@llamaindex/supabase": "^0.1.14",
+    "@llamaindex/together": "^0.0.24",
+    "@llamaindex/tools": "^0.1.4",
+    "@llamaindex/upstash": "^0.0.28",
+    "@llamaindex/vercel": "^0.1.14",
+    "@llamaindex/vllm": "^0.0.50",
+    "@llamaindex/voyage-ai": "^1.0.20",
+    "@llamaindex/weaviate": "^0.0.29",
+    "@llamaindex/workflow": "^1.1.14",
+    "@llamaindex/xai": "^0.0.11",
+    "@notionhq/client": "^4.0.0",
     "@pinecone-database/pinecone": "^4.0.0",
     "@vercel/postgres": "^0.10.0",
-    "ai": "^4.0.0",
+    "ai": "^4.3.17",
     "ajv": "^8.17.1",
     "commander": "^12.1.0",
-    "dotenv": "^16.4.5",
+    "dotenv": "^17.2.0",
     "js-tiktoken": "^1.0.14",
-    "llamaindex": "^0.11.12",
+    "llamaindex": "^0.11.14",
     "mongodb": "6.7.0",
     "postgres": "^3.4.4",
     "wikipedia": "^2.1.2",
-    "zod": "^3.25.67"
+    "zod": "^3.25.76"
   },
   "devDependencies": {
-    "@types/node": "^22.9.0",
-    "tsx": "^4.19.3",
-    "typescript": "^5.7.3"
+    "@types/node": "^24.0.13",
+    "tsx": "^4.20.3",
+    "typescript": "^5.8.3"
   },
   "stackblitz": {
     "startCommand": "npm start"

examples/pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+packages:
+  - "**"

examples/readers/package.json

@@ -21,13 +21,14 @@
   },
   "dependencies": {
     "@llamaindex/cloud": "workspace:* || ^2.0.24",
-    "@llamaindex/readers": "workspace:* || ^1.0.25",
     "@llamaindex/excel": "workspace:*",
+    "@llamaindex/readers": "workspace:* || ^1.0.25",
+    "@notionhq/client": "^4.0.0",
     "llamaindex": "workspace:* || ^0.8.37"
   },
   "devDependencies": {
-    "@types/node": "^22.9.0",
-    "tsx": "^4.19.3",
-    "typescript": "^5.7.3"
+    "@types/node": "^24.0.13",
+    "tsx": "^4.20.3",
+    "typescript": "^5.8.3"
   }
 }

package.json

@@ -4,7 +4,7 @@
   "scripts": {
     "clean": "find . -type d \\( -name .turbo -o -name node_modules -o -name dist -o -name .next -o -name lib \\) -exec rm -rf {} +",
     "build": "turbo run build --filter=\"./packages/*\" --filter=\"./packages/providers/**\"",
-    "dev": "turbo run dev --filter=\"./packages/*\" --filter=\"./packages/providers/**\"",
+    "dev": "turbo run dev --filter=\"./packages/*\" --filter=\"./packages/providers/**\" --concurrency=100",
     "format": "prettier --ignore-unknown --cache --check .",
     "format:write": "prettier --ignore-unknown --write .",
     "lint": "turbo run lint",
@@ -17,18 +17,19 @@
     "release-snapshot": "pnpm run build && changeset publish --tag snapshot",
     "new-version": "changeset version && pnpm format:write && pnpm run build",
     "new-snapshot": "pnpm run build && changeset version --snapshot",
-    "lint-staged": "lint-staged"
+    "lint-staged": "lint-staged",
+    "preinstall": "npx only-allow pnpm"
   },
   "devDependencies": {
     "@changesets/cli": "^2.27.5",
     "@eslint/js": "^9.25.0",
     "bunchee": "6.4.0",
-    "eslint": "9.22.0",
-    "eslint-config-next": "^15.1.0",
-    "eslint-config-prettier": "^9.1.0",
-    "eslint-config-turbo": "^2.3.3",
-    "eslint-plugin-react": "7.37.2",
-    "eslint-plugin-turbo": "^2.5.0",
+    "eslint": "9.30.1",
+    "eslint-config-next": "^15.3.5",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-config-turbo": "^2.5.4",
+    "eslint-plugin-react": "7.37.5",
+    "eslint-plugin-turbo": "^2.5.4",
     "globals": "^15.12.0",
     "husky": "^9.1.7",
     "lint-staged": "^15.2.11",
@@ -37,8 +38,8 @@
     "prettier-plugin-organize-imports": "^4.1.0",
     "prettier-plugin-tailwindcss": "^0.6.11",
     "turbo": "^2.4.4",
-    "typescript": "^5.7.3",
-    "typescript-eslint": "^8.18.0",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.36.0",
     "vitest": "^3.1.1"
   },
   "packageManager": "pnpm@10.8.1",

packages/autotool/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @llamaindex/autotool
 
+## 8.0.16
+
+### Patch Changes
+
+- llamaindex@0.11.16
+
+## 8.0.15
+
+### Patch Changes
+
+- llamaindex@0.11.15
+
+## 8.0.14
+
+### Patch Changes
+
+- llamaindex@0.11.14
+
+## 8.0.13
+
+### Patch Changes
+
+- llamaindex@0.11.13
+
 ## 8.0.12
 
 ### Patch Changes

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

@@ -1,5 +1,33 @@
 # @llamaindex/autotool-01-node-example
 
+## 0.0.124
+
+### Patch Changes
+
+- llamaindex@0.11.16
+- @llamaindex/autotool@8.0.16
+
+## 0.0.123
+
+### Patch Changes
+
+- llamaindex@0.11.15
+- @llamaindex/autotool@8.0.15
+
+## 0.0.122
+
+### Patch Changes
+
+- llamaindex@0.11.14
+- @llamaindex/autotool@8.0.14
+
+## 0.0.121
+
+### Patch Changes
+
+- llamaindex@0.11.13
+- @llamaindex/autotool@8.0.13
+
 ## 0.0.120
 
 ### Patch Changes

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

@@ -8,10 +8,10 @@
     "openai": "^4.73.1"
   },
   "devDependencies": {
-    "tsx": "^4.19.3"
+    "tsx": "^4.20.3"
   },
   "scripts": {
     "start": "node --import tsx --import @llamaindex/autotool/node ./src/index.ts"
   },
-  "version": "0.0.120"
+  "version": "0.0.124"
 }

packages/autotool/package.json

@@ -6,7 +6,7 @@
     "url": "git+https://github.com/run-llama/LlamaIndexTS.git",
     "directory": "packages/autotool"
   },
-  "version": "8.0.12",
+  "version": "8.0.16",
   "description": "auto transpile your JS function to LLM Agent compatible",
   "files": [
     "dist",
@@ -74,12 +74,12 @@
   "devDependencies": {
     "@swc/types": "^0.1.12",
     "@types/json-schema": "^7.0.15",
-    "@types/node": "^22.9.0",
+    "@types/node": "^24.0.13",
     "llamaindex": "workspace:*",
-    "next": "^15.3.0",
+    "next": "^15.3.3",
     "rollup": "^4.28.1",
-    "tsx": "^4.19.3",
-    "typescript": "^5.7.3",
+    "tsx": "^4.20.3",
+    "typescript": "^5.8.3",
     "vitest": "^2.1.5",
     "webpack": "^5.97.1"
   }

packages/cloud/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @llamaindex/cloud
 
+## 4.0.21
+
+### Patch Changes
+
+- 579ca0c: chore: bump sdk version
+
+## 4.0.20
+
+### Patch Changes
+
+- 48b0d88: fix: exports in `api` submodule
+- f185772: fix(cloud): missing file
+
+## 4.0.19
+
+### Patch Changes
+
+- 5a0ed1f: feat: init agent api on cloud sdk
+- 5a0ed1f: feat: init agent api on cloud sdk
+- Updated dependencies [8eeac33]
+  - @llamaindex/core@0.6.14
+
+## 4.0.18
+
+### Patch Changes
+
+- 47a7555: chore: bump sdk version
+
 ## 4.0.17
 
 ### Patch Changes

packages/cloud/agent/package.json

@@ -0,0 +1,8 @@
+{
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": "./dist/index.js",
+  "private": true
+}

packages/cloud/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/cloud",
-  "version": "4.0.17",
+  "version": "4.0.21",
   "type": "module",
   "license": "MIT",
   "scripts": {
@@ -11,10 +11,23 @@
   "files": [
     "openapi.json",
     "./api",
-    "./reader"
+    "./reader",
+    "./parse",
+    "./agent"
   ],
   "exports": {
     "./openapi.json": "./openapi.json",
+    "./agent": {
+      "require": {
+        "types": "./agent/dist/index.d.cts",
+        "default": "./agent/dist/index.cjs"
+      },
+      "import": {
+        "types": "./agent/dist/index.d.ts",
+        "default": "./agent/dist/index.js"
+      },
+      "default": "./agent/dist/index.js"
+    },
     "./api": {
       "require": {
         "types": "./api/dist/index.d.cts",
@@ -79,6 +92,6 @@
   },
   "dependencies": {
     "p-retry": "^6.2.1",
-    "zod": "^3.25.67"
+    "zod": "^3.25.76"
   }
 }

packages/cloud/src/agent/client.ts

@@ -0,0 +1,136 @@
+import { createClient, createConfig } from "@hey-api/client-fetch";
+import { getEnv } from "@llamaindex/env";
+import {
+  createAgentDataApiV1BetaAgentDataPost,
+  deleteAgentDataApiV1BetaAgentDataItemIdDelete,
+  getAgentDataApiV1BetaAgentDataItemIdGet,
+  searchAgentDataApiV1BetaAgentDataSearchPost,
+  updateAgentDataApiV1BetaAgentDataItemIdPut,
+  type AgentData,
+  type PaginatedResponseAgentData,
+  type SearchRequest,
+} from "../client";
+
+type AgentClientOptions = {
+  apiKey?: string;
+  baseUrl?: string;
+  collection: string;
+  agentUrlId: string;
+};
+
+/**
+ * Async client for agent data operations
+ */
+export class AgentClient {
+  private client: ReturnType<typeof createClient>;
+  private baseUrl: string;
+  private headers: Record<string, string>;
+  private collection: string;
+  private agentUrlId: string;
+
+  constructor(options: AgentClientOptions) {
+    this.collection = options.collection;
+    this.agentUrlId = options.agentUrlId;
+    const apiKey = options?.apiKey || getEnv("LLAMA_CLOUD_API_KEY");
+    this.baseUrl = options?.baseUrl || "https://api.cloud.llamaindex.ai/";
+
+    this.headers = {
+      "X-SDK-Name": "llamaindex-ts",
+      ...(apiKey && { Authorization: `Bearer ${apiKey}` }),
+    };
+
+    this.client = createClient(
+      createConfig({
+        baseUrl: this.baseUrl,
+        headers: this.headers,
+      }),
+    );
+  }
+
+  /**
+   * Create new agent data
+   */
+  async createItem<T>(data: T): Promise<AgentData> {
+    const response = await createAgentDataApiV1BetaAgentDataPost({
+      throwOnError: true,
+      body: {
+        collection: this.collection,
+        agent_slug: this.agentUrlId,
+        data: data as Record<string, unknown>,
+      },
+      client: this.client,
+    });
+
+    return response.data;
+  }
+
+  /**
+   * Get agent data by ID
+   */
+  async getItem(id: string): Promise<AgentData | null> {
+    try {
+      const response = await getAgentDataApiV1BetaAgentDataItemIdGet({
+        throwOnError: true,
+        path: { item_id: id },
+        client: this.client,
+      });
+
+      return response.data;
+    } catch (error) {
+      if (
+        error instanceof Error &&
+        "response" in error &&
+        (error as { response?: { status?: number } }).response?.status === 404
+      ) {
+        return null;
+      }
+      throw error;
+    }
+  }
+
+  /**
+   * Update agent data
+   */
+  async updateItem<T>(id: string, data: T): Promise<AgentData> {
+    const response = await updateAgentDataApiV1BetaAgentDataItemIdPut({
+      throwOnError: true,
+      path: { item_id: id },
+      body: {
+        data: data as Record<string, unknown>,
+      },
+      client: this.client,
+    });
+
+    return response.data;
+  }
+
+  /**
+   * Delete agent data
+   */
+  async delete(id: string): Promise<void> {
+    await deleteAgentDataApiV1BetaAgentDataItemIdDelete({
+      throwOnError: true,
+      path: { item_id: id },
+      client: this.client,
+    });
+  }
+
+  /**
+   * List agent data
+   */
+  async list(options: SearchRequest): Promise<PaginatedResponseAgentData> {
+    const response = await searchAgentDataApiV1BetaAgentDataSearchPost({
+      throwOnError: true,
+      body: {
+        ...options,
+      },
+      client: this.client,
+    });
+
+    return response.data;
+  }
+}
+
+export function createAgentClient(options: AgentClientOptions): AgentClient {
+  return new AgentClient(options);
+}

packages/cloud/src/agent/index.ts

@@ -0,0 +1 @@
+export { AgentClient, createAgentClient } from "./client";

packages/cloud/src/reader.ts

@@ -171,6 +171,15 @@ export class LlamaParseReader extends FileReader {
   replace_failed_page_with_error_message_suffix?: string | undefined;
   save_images?: boolean | undefined;
   preset?: string | undefined;
+  high_res_ocr?: boolean | undefined;
+  outlined_table_extraction?: boolean | undefined;
+  hide_headers?: boolean | undefined;
+  hide_footers?: boolean | undefined;
+  page_header_prefix?: string | undefined;
+  page_header_suffix?: string | undefined;
+  page_footer_prefix?: string | undefined;
+  page_footer_suffix?: string | undefined;
+  merge_tables_across_pages_in_markdown?: boolean | undefined;
 
   constructor(
     params: Partial<Omit<LlamaParseReader, "language" | "apiKey">> & {
@@ -352,6 +361,16 @@ export class LlamaParseReader extends FileReader {
         this.replace_failed_page_with_error_message_suffix,
       save_images: this.save_images,
       preset: this.preset,
+      high_res_ocr: this.high_res_ocr,
+      outlined_table_extraction: this.outlined_table_extraction,
+      hide_headers: this.hide_headers,
+      hide_footers: this.hide_footers,
+      page_header_prefix: this.page_header_prefix,
+      page_header_suffix: this.page_header_suffix,
+      page_footer_prefix: this.page_footer_prefix,
+      page_footer_suffix: this.page_footer_suffix,
+      merge_tables_across_pages_in_markdown:
+        this.merge_tables_across_pages_in_markdown,
     } satisfies {
       [Key in keyof BodyUploadFileApiParsingUploadPost]-?:
         | BodyUploadFileApiParsingUploadPost[Key]

packages/core/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @llamaindex/core
 
+## 0.6.14
+
+### Patch Changes
+
+- 8eeac33: Fix createMemory factory when parsing options
+
 ## 0.6.13
 
 ### Patch Changes
@@ -434,7 +440,6 @@
 ### Patch Changes
 
 - 8b7fdba: refactor: move chat engine & retriever into core.
-
   - `chatHistory` in BaseChatEngine now returns `ChatMessage[] | Promise<ChatMessage[]>`, instead of `BaseMemory`
   - update `retrieve-end` type
 
@@ -460,7 +465,6 @@
 ### Patch Changes
 
 - 2cd1383: refactor: align `response-synthesizers` & `chat-engine` module
-
   - builtin event system
   - correct class extends
   - aligin APIs, naming with llama-index python

packages/core/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/core",
   "type": "module",
-  "version": "0.6.13",
+  "version": "0.6.14",
   "description": "LlamaIndex Core Module",
   "exports": {
     "./agent": {
@@ -310,9 +310,9 @@
   },
   "dependencies": {
     "@llamaindex/env": "workspace:*",
-    "@types/node": "^22.9.0",
+    "@types/node": "^24.0.13",
     "magic-bytes.js": "^1.10.0",
-    "zod": "^3.25.67",
+    "zod": "^3.25.76",
     "zod-to-json-schema": "^3.24.6"
   }
 }

packages/core/src/memory/factories.ts

@@ -79,7 +79,18 @@ export function createMemory<TMessageOptions extends object = object>(
       }
     }
   }
-  return new Memory<Record<string, never>, TMessageOptions>(messages, options);
+
+  // Determine the correct options to pass to Memory
+  const resolvedOptions: MemoryOptions<TMessageOptions> = Array.isArray(
+    messagesOrOptions,
+  )
+    ? options
+    : (messagesOrOptions as MemoryOptions<TMessageOptions>);
+
+  return new Memory<Record<string, never>, TMessageOptions>(
+    messages,
+    resolvedOptions,
+  );
 }
 
 /**

packages/core/tests/memory/memory.test.ts

@@ -1,6 +1,6 @@
 import { Settings } from "@llamaindex/core/global";
 import type { ChatMessage, LLM } from "@llamaindex/core/llms";
-import { createMemory, Memory } from "@llamaindex/core/memory";
+import { createMemory, Memory, staticBlock } from "@llamaindex/core/memory";
 import { MockLLM } from "@llamaindex/core/utils";
 import type { Tokenizer } from "@llamaindex/env/tokenizers";
 import {
@@ -392,4 +392,47 @@ describe("Memory", () => {
       expect(messages[0]?.role).toBe("user"); // data role should be mapped to user
     });
   });
+
+  describe("memoryBlocks initialization", () => {
+    test("should include static block content in getLLM result", async () => {
+      const STATIC_CONTENT = "You are speaking with a helpful assistant.";
+      const block = staticBlock({
+        content: STATIC_CONTENT,
+        messageRole: "system",
+      });
+
+      const memoryWithBlock = createMemory({ memoryBlocks: [block] });
+
+      // Fetch messages via getLLM – static block (priority 0) should always be present
+      const messages = await memoryWithBlock.getLLM();
+
+      // There should be exactly one message (the static block) when no other messages are added
+      expect(messages).toHaveLength(1);
+      expect(messages[0]?.content).toBe(STATIC_CONTENT);
+      expect(messages[0]?.role).toBe("system");
+    });
+
+    test("should retain static block alongside dynamic messages", async () => {
+      const STATIC_CONTENT = "Always respond in pirate speak.";
+      const block = staticBlock({
+        content: STATIC_CONTENT,
+        messageRole: "system",
+      });
+
+      const memoryWithBlock = createMemory({ memoryBlocks: [block] });
+
+      // Add a regular user message
+      await memoryWithBlock.add({ role: "user", content: "Hello there!" });
+
+      const messages = await memoryWithBlock.getLLM();
+
+      // Static block + user message
+      expect(messages).toHaveLength(2);
+
+      const contents = messages.map((m) => m.content);
+      expect(contents).toEqual(
+        expect.arrayContaining([STATIC_CONTENT, "Hello there!"]),
+      );
+    });
+  });
 });

packages/env/package.json

@@ -117,14 +117,14 @@
   },
   "devDependencies": {
     "@huggingface/transformers": "^3.5.0",
-    "@types/node": "^22.9.0",
+    "@types/node": "^24.0.13",
     "@types/readable-stream": "^4.0.15",
     "vitest": "^2.1.5"
   },
   "dependencies": {
-    "pathe": "^1.1.2",
     "@aws-crypto/sha256-js": "^5.2.0",
-    "js-tiktoken": "^1.0.12"
+    "js-tiktoken": "^1.0.12",
+    "pathe": "^1.1.2"
   },
   "peerDependencies": {
     "@huggingface/transformers": "^3.5.0",

packages/experimental/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @llamaindex/experimental
 
+## 0.0.193
+
+### Patch Changes
+
+- llamaindex@0.11.16
+
+## 0.0.192
+
+### Patch Changes
+
+- llamaindex@0.11.15
+
+## 0.0.191
+
+### Patch Changes
+
+- llamaindex@0.11.14
+
+## 0.0.190
+
+### Patch Changes
+
+- llamaindex@0.11.13
+
 ## 0.0.189
 
 ### Patch Changes

packages/experimental/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/experimental",
   "description": "Experimental package for LlamaIndexTS",
-  "version": "0.0.189",
+  "version": "0.0.193",
   "type": "module",
   "types": "dist/type/index.d.ts",
   "main": "dist/cjs/index.js",
@@ -62,7 +62,7 @@
   },
   "dependencies": {
     "@types/lodash": "^4.17.7",
-    "@types/node": "^22.9.0",
+    "@types/node": "^24.0.13",
     "jsonpath": "^1.1.1",
     "llamaindex": "workspace:*",
     "lodash": "^4.17.21"

packages/llamaindex/CHANGELOG.md

@@ -1,5 +1,39 @@
 # llamaindex
 
+## 0.11.16
+
+### Patch Changes
+
+- Updated dependencies [579ca0c]
+  - @llamaindex/cloud@4.0.21
+
+## 0.11.15
+
+### Patch Changes
+
+- Updated dependencies [48b0d88]
+- Updated dependencies [f185772]
+  - @llamaindex/cloud@4.0.20
+
+## 0.11.14
+
+### Patch Changes
+
+- Updated dependencies [5a0ed1f]
+- Updated dependencies [5a0ed1f]
+- Updated dependencies [8eeac33]
+  - @llamaindex/cloud@4.0.19
+  - @llamaindex/core@0.6.14
+  - @llamaindex/node-parser@2.0.14
+  - @llamaindex/workflow@1.1.14
+
+## 0.11.13
+
+### Patch Changes
+
+- Updated dependencies [47a7555]
+  - @llamaindex/cloud@4.0.18
+
 ## 0.11.12
 
 ### Patch Changes
@@ -1470,7 +1504,6 @@
 ### Patch Changes
 
 - e9714db: feat: update `PGVectorStore`
-
   - move constructor parameter `config.user` | `config.database` | `config.password` | `config.connectionString` into `config.clientConfig`
   - if you pass `pg.Client` or `pg.Pool` instance to `PGVectorStore`, move it to `config.client`, setting `config.shouldConnect` to false if it's already connected
   - default value of `PGVectorStore.collection` is now `"data"` instead of `""` (empty string)

packages/llamaindex/package.json

@@ -1,6 +1,6 @@
 {
   "name": "llamaindex",
-  "version": "0.11.12",
+  "version": "0.11.16",
   "license": "MIT",
   "type": "module",
   "keywords": [
@@ -26,13 +26,13 @@
     "@llamaindex/node-parser": "workspace:*",
     "@llamaindex/workflow": "workspace:*",
     "@types/lodash": "^4.17.7",
-    "@types/node": "^22.9.0",
+    "@types/node": "^24.0.13",
     "lodash": "^4.17.21",
     "magic-bytes.js": "^1.10.0"
   },
   "devDependencies": {
-    "ajv": "^8.17.1",
-    "@types/node": "^22.9.0"
+    "@types/node": "^22.9.0",
+    "ajv": "^8.17.1"
   },
   "engines": {
     "node": ">=18.0.0"

packages/llamaindex/tests/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @llamaindex/core-test
 
+## 0.1.9
+
+### Patch Changes
+
+- @llamaindex/openai@0.4.8
+
 ## 0.1.8
 
 ### Patch Changes

packages/llamaindex/tests/package.json

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

packages/node-parser/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @llamaindex/node-parser
 
+## 2.0.14
+
+### Patch Changes
+
+- Updated dependencies [8eeac33]
+  - @llamaindex/core@0.6.14
+
 ## 2.0.13
 
 ### Patch Changes

packages/node-parser/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/node-parser",
-  "version": "2.0.13",
+  "version": "2.0.14",
   "description": "Node parser for LlamaIndex",
   "type": "module",
   "exports": {
@@ -42,7 +42,7 @@
     "@llamaindex/core": "workspace:*",
     "@llamaindex/env": "workspace:*",
     "@types/html-to-text": "^9.0.4",
-    "@types/node": "^22.9.0",
+    "@types/node": "^24.0.13",
     "tree-sitter": "^0.22.1",
     "web-tree-sitter": "^0.24.4"
   },

packages/providers/anthropic/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @llamaindex/anthropic
 
+## 0.3.16
+
+### Patch Changes
+
+- Updated dependencies [8eeac33]
+  - @llamaindex/core@0.6.14
+
 ## 0.3.15
 
 ### Patch Changes

packages/providers/anthropic/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/anthropic",
   "description": "Anthropic Adapter for LlamaIndex",
-  "version": "0.3.15",
+  "version": "0.3.16",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",

packages/providers/assemblyai/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @llamaindex/assemblyai
 
+## 0.1.13
+
+### Patch Changes
+
+- Updated dependencies [8eeac33]
+  - @llamaindex/core@0.6.14
+
 ## 0.1.12
 
 ### Patch Changes

packages/providers/assemblyai/package.json

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

packages/providers/aws/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @llamaindex/community
 
+## 0.0.109
+
+### Patch Changes
+
+- Updated dependencies [8eeac33]
+  - @llamaindex/core@0.6.14
+
 ## 0.0.108
 
 ### Patch Changes

packages/providers/aws/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@llamaindex/aws",
   "description": "AWS package for LlamaIndexTS",
-  "version": "0.0.108",
+  "version": "0.0.109",
   "type": "module",
   "types": "dist/type/index.d.ts",
   "main": "dist/cjs/index.js",
@@ -44,7 +44,7 @@
   "devDependencies": {
     "@llamaindex/core": "workspace:*",
     "@llamaindex/env": "workspace:*",
-    "@types/node": "^22.9.0"
+    "@types/node": "^24.0.13"
   },
   "dependencies": {
     "@aws-sdk/client-bedrock-agent-runtime": "^3.706.0",

packages/providers/clip/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @llamaindex/clip
 
+## 0.0.64
+
+### Patch Changes
+
+- Updated dependencies [8eeac33]
+  - @llamaindex/core@0.6.14
+  - @llamaindex/openai@0.4.8
+
 ## 0.0.63
 
 ### Patch Changes

packages/providers/clip/package.json

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

packages/providers/cohere/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @llamaindex/cohere
 
+## 0.0.28
+
+### Patch Changes
+
+- Updated dependencies [8eeac33]
+  - @llamaindex/core@0.6.14
+
 ## 0.0.27
 
 ### Patch Changes

packages/providers/cohere/package.json

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

packages/providers/deepinfra/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @llamaindex/deepinfra
 
+## 0.0.64
+
+### Patch Changes
+
+- Updated dependencies [8eeac33]
+  - @llamaindex/core@0.6.14
+  - @llamaindex/openai@0.4.8
+
 ## 0.0.63
 
 ### Patch Changes

packages/providers/deepinfra/package.json

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

packages/providers/deepseek/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @llamaindex/deepseek
 
+## 0.0.25
+
+### Patch Changes
+
+- af3f866: feat: add supportToolCall getter to DeepSeekLLM class
+
+## 0.0.24
+
+### Patch Changes
+
+- @llamaindex/openai@0.4.8
+
 ## 0.0.23
 
 ### Patch Changes

packages/providers/deepseek/package.json

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

packages/providers/deepseek/src/llm.ts

@@ -34,6 +34,10 @@ export class DeepSeekLLM extends OpenAI {
       ...rest,
     });
   }
+
+  get supportToolCall() {
+    return true;
+  }
 }
 
 /**