update contributing instructions

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

apps/next/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @llamaindex/doc
 
+## 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.34",
   "private": true,
   "scripts": {
     "postinstall": "fumadocs-mdx",
@@ -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",

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-worker-agent/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @llamaindex/cloudflare-worker-agent-test
 
+## 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.174",
   "type": "module",
   "private": true,
   "scripts": {

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

@@ -1,5 +1,12 @@
 # @llamaindex/llama-parse-browser-test
 
+## 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.73",
   "type": "module",
   "scripts": {
     "dev": "vite",

e2e/examples/nextjs-agent/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @llamaindex/next-agent-test
 
+## 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.174",
   "private": true,
   "scripts": {
     "dev": "next dev",
@@ -10,7 +10,7 @@
   "dependencies": {
     "ai": "^4.0.0",
     "llamaindex": "workspace:*",
-    "next": "^15.3.0",
+    "next": "^15.3.3",
     "react": "19.0.0",
     "react-dom": "19.0.0"
   },

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

@@ -1,5 +1,11 @@
 # test-edge-runtime
 
+## 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.173",
   "private": true,
   "scripts": {
     "dev": "next dev",
@@ -9,7 +9,7 @@
   },
   "dependencies": {
     "llamaindex": "workspace:*",
-    "next": "^15.3.0",
+    "next": "^15.3.3",
     "react": "^19.1.0",
     "react-dom": "^19.1.0"
   },

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

@@ -1,5 +1,11 @@
 # @llamaindex/next-node-runtime
 
+## 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.42",
   "private": true,
   "scripts": {
     "dev": "next dev",
@@ -11,7 +11,7 @@
     "@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"
   },

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

@@ -1,5 +1,11 @@
 # vite-import-llamaindex
 
+## 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.40",
   "type": "module",
   "scripts": {
     "build": "vite build",

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,11 @@
 # @llamaindex/waku-query-engine-test
 
+## 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.174",
   "type": "module",
   "private": true,
   "scripts": {

examples/CHANGELOG.md

@@ -1,5 +1,15 @@
 # examples
 
+## 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/examples",
-  "version": "0.3.26",
+  "version": "0.3.27",
   "private": true,
   "scripts": {
     "lint": "eslint .",
@@ -18,7 +18,7 @@
     "@llamaindex/bm25-retriever": "^0.0.2",
     "@llamaindex/chroma": "^0.0.27",
     "@llamaindex/clip": "^0.0.63",
-    "@llamaindex/cloud": "^4.0.17",
+    "@llamaindex/cloud": "^4.0.18",
     "@llamaindex/cohere": "^0.0.27",
     "@llamaindex/core": "^0.6.13",
     "@llamaindex/deepinfra": "^0.0.63",
@@ -29,7 +29,7 @@
     "@llamaindex/firestore": "^1.0.20",
     "@llamaindex/fireworks": "^0.0.23",
     "@llamaindex/google": "^0.3.12",
-    "@llamaindex/groq": "^0.0.78",
+    "@llamaindex/groq": "^0.0.79",
     "@llamaindex/huggingface": "^0.1.17",
     "@llamaindex/jinaai": "^0.0.23",
     "@llamaindex/milvus": "^0.1.22",
@@ -65,7 +65,7 @@
     "commander": "^12.1.0",
     "dotenv": "^16.4.5",
     "js-tiktoken": "^1.0.14",
-    "llamaindex": "^0.11.12",
+    "llamaindex": "^0.11.13",
     "mongodb": "6.7.0",
     "postgres": "^3.4.4",
     "wikipedia": "^2.1.2",

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",

packages/autotool/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @llamaindex/autotool
 
+## 8.0.13
+
+### Patch Changes
+
+- llamaindex@0.11.13
+
 ## 8.0.12
 
 ### Patch Changes

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

@@ -1,5 +1,12 @@
 # @llamaindex/autotool-01-node-example
 
+## 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

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

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.13",
   "description": "auto transpile your JS function to LLM Agent compatible",
   "files": [
     "dist",
@@ -76,7 +76,7 @@
     "@types/json-schema": "^7.0.15",
     "@types/node": "^22.9.0",
     "llamaindex": "workspace:*",
-    "next": "^15.3.0",
+    "next": "^15.3.3",
     "rollup": "^4.28.1",
     "tsx": "^4.19.3",
     "typescript": "^5.7.3",

packages/cloud/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @llamaindex/cloud
 
+## 4.0.18
+
+### Patch Changes
+
+- 47a7555: chore: bump sdk version
+
 ## 4.0.17
 
 ### Patch Changes

packages/cloud/package.json

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

packages/cloud/src/reader.ts

@@ -171,6 +171,14 @@ 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;
 
   constructor(
     params: Partial<Omit<LlamaParseReader, "language" | "apiKey">> & {
@@ -352,6 +360,14 @@ 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,
     } satisfies {
       [Key in keyof BodyUploadFileApiParsingUploadPost]-?:
         | BodyUploadFileApiParsingUploadPost[Key]

packages/core/CHANGELOG.md

@@ -434,7 +434,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 +459,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/experimental/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @llamaindex/experimental
 
+## 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.190",
   "type": "module",
   "types": "dist/type/index.d.ts",
   "main": "dist/cjs/index.js",

packages/llamaindex/CHANGELOG.md

@@ -1,5 +1,12 @@
 # llamaindex
 
+## 0.11.13
+
+### Patch Changes
+
+- Updated dependencies [47a7555]
+  - @llamaindex/cloud@4.0.18
+
 ## 0.11.12
 
 ### Patch Changes
@@ -1470,7 +1477,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.13",
   "license": "MIT",
   "type": "module",
   "keywords": [

packages/providers/groq/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @llamaindex/groq
 
+## 0.0.79
+
+### Patch Changes
+
+- 229cdeb: feat: add toolcall support to groq models
+
 ## 0.0.78
 
 ### Patch Changes

packages/providers/groq/package.json

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

packages/providers/groq/src/llm.ts

@@ -2,6 +2,17 @@ import { getEnv } from "@llamaindex/env";
 import { OpenAI } from "@llamaindex/openai";
 import GroqSDK, { type ClientOptions } from "groq-sdk";
 
+// Models that support tool/function calling
+const TOOL_CALLING_MODELS = [
+  "gemma2-9b-it",
+  "llama-3.1-8b-instant",
+  "llama-3.3-70b-versatile",
+  "deepseek-r1-distill-llama-70b",
+  "qwen-qwq-32b",
+  "meta-llama/llama-4-scout-17b-16e-instruct",
+  "meta-llama/llama-4-maverick-17b-128e-instruct",
+] as const;
+
 export class Groq extends OpenAI {
   constructor(
     init?: Omit<Partial<OpenAI>, "session"> & {
@@ -11,7 +22,7 @@ export class Groq extends OpenAI {
     const {
       apiKey = getEnv("GROQ_API_KEY"),
       additionalSessionOptions = {},
-      model = "mixtral-8x7b-32768",
+      model = "llama-3.3-70b-versatile",
       ...rest
     } = init ?? {};
 
@@ -28,6 +39,10 @@ export class Groq extends OpenAI {
         ...init?.additionalSessionOptions,
       }) as never;
   }
+
+  get supportToolCall() {
+    return (TOOL_CALLING_MODELS as readonly string[]).includes(this.model);
+  }
 }
 
 /**

unit/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @llamaindex/unit-test
 
+## 0.1.42
+
+### Patch Changes
+
+- Updated dependencies [47a7555]
+  - @llamaindex/cloud@4.0.18
+  - llamaindex@0.11.13
+
 ## 0.1.41
 
 ### Patch Changes

unit/package.json

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