Create cold-sloths-scream.md

- Add TypedAgentData interface for type-safe agent data management
- Implement AsyncAgentDataClient with full CRUD operations
- Add support for data extraction with retry logic
- Add filtering, sorting, and pagination support for listing
- Include comprehensive TypeScript types and documentation
- Add usage examples and README documentation

Implementation based on PR https://github.com/run-llama/llama_cloud_services/pull/782

.changeset/cold-sloths-scream.md

@@ -0,0 +1,5 @@
+---
+"@llamaindex/cloud": patch
+---
+
+feat: init agent api on cloud sdk

.changeset/funny-donuts-approve.md

@@ -0,0 +1,5 @@
+---
+"@llamaindex/cloud": patch
+---
+
+feat: init agent api on cloud sdk

.changeset/sixty-wasps-flow.md

@@ -0,0 +1,5 @@
+---
+"@llamaindex/core": patch
+---
+
+Fix createMemory factory when parsing options

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,11 @@
 # @llamaindex/doc
 
+## 0.2.34
+
+### Patch Changes
+
+- 39758ab: Add title to homepage header
+
 ## 0.2.33
 
 ### Patch Changes

apps/next/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llamaindex/doc",
-  "version": "0.2.33",
+  "version": "0.2.34",
   "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,7 +70,7 @@
     "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",
@@ -94,6 +94,6 @@
     "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/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>

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/package.json

@@ -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/package.json

@@ -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/package.json

@@ -8,9 +8,9 @@
     "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"
   },
@@ -20,6 +20,6 @@
     "@types/react-dom": "^19.0.4",
     "eslint": "9.16.0",
     "eslint-config-next": "15.1.0",
-    "typescript": "^5.7.3"
+    "typescript": "^5.8.3"
   }
 }

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

@@ -9,7 +9,7 @@
   },
   "dependencies": {
     "llamaindex": "workspace:*",
-    "next": "^15.3.0",
+    "next": "^15.3.3",
     "react": "^19.1.0",
     "react-dom": "^19.1.0"
   },
@@ -17,6 +17,6 @@
     "@types/node": "^22.9.0",
     "@types/react": "^19.0.10",
     "@types/react-dom": "^19.0.4",
-    "typescript": "^5.7.3"
+    "typescript": "^5.8.3"
   }
 }

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

@@ -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"
   },
@@ -21,6 +21,6 @@
     "@types/react-dom": "^19.0.4",
     "eslint": "9.16.0",
     "eslint-config-next": "15.1.0",
-    "typescript": "^5.7.3"
+    "typescript": "^5.8.3"
   }
 }

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

@@ -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/waku-query-engine/package.json

@@ -22,6 +22,6 @@
     "@types/react-dom": "19.0.4",
     "rollup": "4.38.0",
     "tailwindcss": "^4.1.4",
-    "typescript": "5.7.3"
+    "typescript": "5.8.3"
   }
 }

e2e/package.json

@@ -27,6 +27,6 @@
     "pg": "^8.12.0",
     "pgvector": "0.2.0",
     "tsx": "^4.19.3",
-    "zod": "^3.25.67"
+    "zod": "^3.25.76"
   }
 }

examples/package.json

@@ -60,7 +60,7 @@
     "@notionhq/client": "^2.2.15",
     "@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",
@@ -69,12 +69,12 @@
     "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"
+    "typescript": "^5.8.3"
   },
   "stackblitz": {
     "startCommand": "npm start"

examples/readers/package.json

@@ -21,13 +21,13 @@
   },
   "dependencies": {
     "@llamaindex/cloud": "workspace:* || ^2.0.24",
-    "@llamaindex/readers": "workspace:* || ^1.0.25",
     "@llamaindex/excel": "workspace:*",
+    "@llamaindex/readers": "workspace:* || ^1.0.25",
     "llamaindex": "workspace:* || ^0.8.37"
   },
   "devDependencies": {
     "@types/node": "^22.9.0",
     "tsx": "^4.19.3",
-    "typescript": "^5.7.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",
@@ -37,7 +37,7 @@
     "prettier-plugin-organize-imports": "^4.1.0",
     "prettier-plugin-tailwindcss": "^0.6.11",
     "turbo": "^2.4.4",
-    "typescript": "^5.7.3",
+    "typescript": "^5.8.3",
     "typescript-eslint": "^8.18.0",
     "vitest": "^3.1.1"
   },

packages/autotool/package.json

@@ -76,10 +76,10 @@
     "@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",
+    "typescript": "^5.8.3",
     "vitest": "^2.1.5",
     "webpack": "^5.97.1"
   }

packages/cloud/package.json

@@ -15,6 +15,17 @@
   ],
   "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 +90,6 @@
   },
   "dependencies": {
     "p-retry": "^6.2.1",
-    "zod": "^3.25.67"
+    "zod": "^3.25.76"
   }
 }

packages/cloud/src/agent/client.ts

@@ -0,0 +1,291 @@
+import { createClient, createConfig } from "@hey-api/client-fetch";
+import { getEnv } from "@llamaindex/env";
+import pRetry from "p-retry";
+import {
+  createAgentDataApiV1BetaAgentDataPost,
+  deleteAgentDataApiV1BetaAgentDataItemIdDelete,
+  getAgentDataApiV1BetaAgentDataItemIdGet,
+  searchAgentDataApiV1BetaAgentDataSearchPost,
+  updateAgentDataApiV1BetaAgentDataItemIdPut,
+  type AgentData,
+} from "../client";
+import type {
+  CreateAgentDataOptions,
+  ExtractedData,
+  ExtractOptions,
+  ListAgentDataOptions,
+  TypedAgentData,
+  TypedAgentDataItems,
+  UpdateAgentDataOptions,
+} from "./types";
+
+/**
+ * Async client for agent data operations
+ */
+export class AgentClient {
+  private client: ReturnType<typeof createClient>;
+  private baseUrl: string;
+  private headers: Record<string, string>;
+
+  constructor(options?: { apiKey?: string; baseUrl?: string }) {
+    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 create<T = unknown>(
+    options: CreateAgentDataOptions<T>,
+  ): Promise<TypedAgentData<T>> {
+    const response = await createAgentDataApiV1BetaAgentDataPost({
+      throwOnError: true,
+      body: {
+        agent_slug: options.agentSlug,
+        ...(options.collection !== undefined && {
+          collection: options.collection,
+        }),
+        data: options.data as Record<string, unknown>,
+      },
+      client: this.client,
+    });
+
+    return this.transformResponse(response.data);
+  }
+
+  /**
+   * Get agent data by ID
+   */
+  async get<T = unknown>(id: string): Promise<TypedAgentData<T> | null> {
+    try {
+      const response = await getAgentDataApiV1BetaAgentDataItemIdGet({
+        throwOnError: true,
+        path: { item_id: id },
+        client: this.client,
+      });
+
+      return this.transformResponse(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 update<T = unknown>(
+    id: string,
+    options: UpdateAgentDataOptions<T>,
+  ): Promise<TypedAgentData<T>> {
+    const response = await updateAgentDataApiV1BetaAgentDataItemIdPut({
+      throwOnError: true,
+      path: { item_id: id },
+      body: {
+        data: options.data as Record<string, unknown>,
+      },
+      client: this.client,
+    });
+
+    return this.transformResponse(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<T = unknown>(
+    options: ListAgentDataOptions,
+  ): Promise<TypedAgentDataItems<T>> {
+    const response = await searchAgentDataApiV1BetaAgentDataSearchPost({
+      throwOnError: true,
+      body: {
+        agent_slug: options.agentSlug,
+        ...(options.collection !== undefined && {
+          collection: options.collection,
+        }),
+        ...(options.filter !== undefined && { filter: options.filter }),
+        ...(options.orderBy !== undefined && { order_by: options.orderBy }),
+        ...(options.pageSize !== undefined && { page_size: options.pageSize }),
+        ...(options.pageToken !== undefined && {
+          page_token: options.pageToken,
+        }),
+        ...(options.offset !== undefined && { offset: options.offset }),
+      },
+      client: this.client,
+    });
+
+    const result: TypedAgentDataItems<T> = {
+      items: response.data.items.map((item: AgentData) =>
+        this.transformResponse(item),
+      ),
+    };
+
+    if (
+      response.data.total_size !== null &&
+      response.data.total_size !== undefined
+    ) {
+      result.totalSize = response.data.total_size;
+    }
+
+    if (
+      response.data.next_page_token !== null &&
+      response.data.next_page_token !== undefined
+    ) {
+      result.nextPageToken = response.data.next_page_token;
+    }
+
+    return result;
+  }
+
+  /**
+   * Extract data from agent with retry logic
+   */
+  async extract<T = unknown>(
+    agentId: string,
+    input: unknown,
+    options?: ExtractOptions,
+  ): Promise<ExtractedData<T>> {
+    const extractOptions = {
+      retries: options?.retryCount || 3,
+      onFailedAttempt: (error: {
+        attemptNumber: number;
+        retriesLeft: number;
+      }) => {
+        console.log(
+          `Extraction attempt ${error.attemptNumber} failed. ${error.retriesLeft} retries left.`,
+        );
+      },
+      minTimeout: options?.retryDelay || 1000,
+      maxTimeout: options?.timeout || 30000,
+    };
+
+    return pRetry(async () => {
+      // Note: The extract endpoint might not be in the generated client yet
+      // Using the native fetch API for this endpoint
+      const response = await fetch(
+        `${this.baseUrl}/api/v1/beta/agent-data/${agentId}/extract`,
+        {
+          method: "POST",
+          body: JSON.stringify({ input }),
+          headers: {
+            "Content-Type": "application/json",
+            ...this.headers,
+          },
+        },
+      );
+
+      if (!response.ok) {
+        throw new Error(`Failed to extract data: ${response.statusText}`);
+      }
+
+      const extractedData = (await response.json()) as ExtractedData<T>;
+
+      // If status is still pending or in progress, poll for completion
+      if (
+        extractedData.status === "pending" ||
+        extractedData.status === "in_progress"
+      ) {
+        return this.pollExtraction<T>(extractedData.id, options);
+      }
+
+      return extractedData;
+    }, extractOptions);
+  }
+
+  /**
+   * Poll for extraction completion
+   */
+  private async pollExtraction<T = unknown>(
+    extractionId: string,
+    options?: ExtractOptions,
+  ): Promise<ExtractedData<T>> {
+    const pollInterval = 2000; // 2 seconds
+    const maxAttempts = Math.floor((options?.timeout || 30000) / pollInterval);
+
+    for (let i = 0; i < maxAttempts; i++) {
+      await new Promise((resolve) => setTimeout(resolve, pollInterval));
+
+      const response = await fetch(
+        `${this.baseUrl}/api/v1/extractions/${extractionId}`,
+        {
+          headers: this.headers,
+        },
+      );
+
+      if (!response.ok) {
+        throw new Error(
+          `Failed to get extraction status: ${response.statusText}`,
+        );
+      }
+
+      const extractedData = (await response.json()) as ExtractedData<T>;
+
+      if (
+        extractedData.status === "completed" ||
+        extractedData.status === "failed"
+      ) {
+        return extractedData;
+      }
+    }
+
+    throw new Error("Extraction timeout exceeded");
+  }
+
+  /**
+   * Transform API response to typed data
+   */
+  private transformResponse<T = unknown>(data: AgentData): TypedAgentData<T> {
+    const result: TypedAgentData<T> = {
+      id: data.id!,
+      agentSlug: data.agent_slug,
+      data: data.data as T,
+      createdAt: new Date(data.created_at!),
+      updatedAt: new Date(data.updated_at!),
+    };
+
+    if (data.collection !== undefined) {
+      result.collection = data.collection;
+    }
+
+    return result;
+  }
+}
+
+/**
+ * Create a new AsyncAgentDataClient instance
+ */
+export function createAgentDataClient(options?: {
+  apiKey?: string;
+  baseUrl?: string;
+}): AgentClient {
+  return new AgentClient(options);
+}

packages/cloud/src/agent/index.ts

@@ -0,0 +1,18 @@
+export { AgentClient, createAgentDataClient } from "./client";
+
+export type {
+  AgentDataT,
+  CreateAgentDataOptions,
+  ExtractOptions,
+  ExtractedData,
+  ExtractedT,
+  FilterOperation,
+  ListAgentDataOptions,
+  SortOptions,
+  StatusType,
+  TypedAgentData,
+  TypedAgentDataItems,
+  UpdateAgentDataOptions,
+} from "./types";
+
+export { StatusType as StatusTypeEnum } from "./types";

packages/cloud/src/agent/types.ts

@@ -0,0 +1,98 @@
+/**
+ * Status types for agent data processing
+ */
+export enum StatusType {
+  PENDING = "pending",
+  IN_PROGRESS = "in_progress",
+  COMPLETED = "completed",
+  FAILED = "failed",
+}
+
+/**
+ * Filter operation for searching/filtering agent data
+ */
+export interface FilterOperation {
+  [key: string]: unknown;
+}
+
+/**
+ * Base extracted data interface
+ */
+export interface ExtractedData<T = unknown> {
+  id: string;
+  status: StatusType;
+  data?: T;
+  error?: string;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+/**
+ * TypedAgentData interface for typed agent data
+ */
+export interface TypedAgentData<T = unknown> {
+  id: string;
+  agentSlug: string;
+  collection?: string;
+  data: T;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+/**
+ * Collection of typed agent data items
+ */
+export interface TypedAgentDataItems<T = unknown> {
+  items: TypedAgentData<T>[];
+  totalSize?: number;
+  nextPageToken?: string;
+}
+
+/**
+ * Options for creating agent data
+ */
+export interface CreateAgentDataOptions<T = unknown> {
+  agentSlug: string;
+  collection?: string;
+  data: T;
+}
+
+/**
+ * Options for updating agent data
+ */
+export interface UpdateAgentDataOptions<T = unknown> {
+  data: T;
+}
+
+/**
+ * Sort options for listing
+ */
+export interface SortOptions {
+  field: string;
+  order: "asc" | "desc";
+}
+
+/**
+ * Options for listing agent data
+ */
+export interface ListAgentDataOptions {
+  agentSlug: string;
+  collection?: string;
+  filter?: Record<string, FilterOperation>;
+  orderBy?: string;
+  pageSize?: number;
+  pageToken?: string;
+  offset?: number;
+}
+
+/**
+ * Options for extraction
+ */
+export interface ExtractOptions {
+  timeout?: number;
+  retryCount?: number;
+  retryDelay?: number;
+}
+
+export type ExtractedT<T> = T;
+export type AgentDataT<T> = T;

packages/cloud/src/api.ts

@@ -7,5 +7,21 @@ client.setConfig({
   },
 });
 
+export {
+  AgentClient,
+  createAgentDataClient,
+  StatusTypeEnum,
+  type AgentDataT,
+  type CreateAgentDataOptions,
+  type ExtractedData,
+  type ExtractedT,
+  type ExtractOptions,
+  type ListAgentDataOptions,
+  type SortOptions,
+  type StatusType,
+  type TypedAgentData,
+  type TypedAgentDataItems,
+  type UpdateAgentDataOptions,
+} from "./agent";
 export * from "./client";
 export { client };

packages/core/package.json

@@ -312,7 +312,7 @@
     "@llamaindex/env": "workspace:*",
     "@types/node": "^22.9.0",
     "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/providers/openai/package.json

@@ -33,7 +33,7 @@
   "devDependencies": {
     "@llamaindex/core": "workspace:*",
     "@llamaindex/env": "workspace:*",
-    "zod": "^3.25.67"
+    "zod": "^3.25.76"
   },
   "peerDependencies": {
     "@llamaindex/core": "workspace:*",

packages/providers/vercel/package.json

@@ -39,11 +39,12 @@
     "test": "vitest run"
   },
   "devDependencies": {
-    "vitest": "^2.1.5",
-    "@llamaindex/core": "workspace:*"
+    "@llamaindex/core": "workspace:*",
+    "ai": "^4.3.17",
+    "vitest": "^2.1.5"
   },
   "dependencies": {
-    "zod": "^3.25.67"
+    "zod": "^3.25.76"
   },
   "peerDependencies": {
     "@llamaindex/core": "workspace:*",

packages/providers/vercel/src/tool.ts

@@ -1,7 +1,7 @@
 import { Settings } from "@llamaindex/core/global";
 import type { BaseQueryEngine } from "@llamaindex/core/query-engine";
 import { EngineResponse } from "@llamaindex/core/schema";
-import { type CoreTool, type LanguageModelV1, tool } from "ai";
+import { type LanguageModelV1, type Tool, tool } from "ai";
 import { z } from "zod";
 import { VercelLLM } from "./llm";
 
@@ -23,9 +23,9 @@ export function llamaindex({
   options?: {
     fields?: ResponseField[];
   };
-}): CoreTool {
+}): Tool {
   const llm = new VercelLLM({ model });
-  return Settings.withLLM<CoreTool>(llm, () => {
+  return Settings.withLLM<Tool>(llm, () => {
     const queryEngine = index.asQueryEngine();
     return tool({
       description: description ?? "Get information about your documents.",

packages/tools/package.json

@@ -32,13 +32,13 @@
     "test:watch": "vitest watch"
   },
   "devDependencies": {
+    "@llamaindex/core": "workspace:*",
+    "@llamaindex/env": "workspace:*",
     "@modelcontextprotocol/server-filesystem": "^2025.7.1",
     "@types/node": "^22.9.0",
     "@types/papaparse": "^5.3.15",
-    "vitest": "^2.1.5",
-    "@llamaindex/core": "workspace:*",
-    "@llamaindex/env": "workspace:*",
-    "ajv": "^8.12.0"
+    "ajv": "^8.12.0",
+    "vitest": "^2.1.5"
   },
   "peerDependencies": {
     "@llamaindex/core": "workspace:*",
@@ -54,6 +54,6 @@
     "marked": "^14.1.2",
     "papaparse": "^5.4.1",
     "wikipedia": "^2.1.2",
-    "zod": "^3.25.67"
+    "zod": "^3.25.76"
   }
 }

packages/wasm-tools/package.json

@@ -11,7 +11,7 @@
     "@swc/cli": "^0.5.0",
     "@swc/core": "^1.9.2",
     "assemblyscript": "^0.27.31",
-    "typescript": "^5.7.3"
+    "typescript": "^5.8.3"
   },
   "engines": {
     "node": ">=20.0.0"

resolution-tests/package.json

@@ -16,10 +16,10 @@
     "test:node": "pnpm run build:node && node --test dist/node/index.e2e.js"
   },
   "devDependencies": {
+    "@llamaindex/openai": "workspace:*",
+    "@llamaindex/workflow": "workspace:*",
     "@types/node": "^22.9.0",
     "llamaindex": "workspace:*",
-    "@llamaindex/workflow": "workspace:*",
-    "@llamaindex/openai": "workspace:*",
-    "zod": "^3.25.67"
+    "zod": "^3.25.76"
   }
 }

unit/package.json

@@ -27,6 +27,6 @@
     "tree-sitter": "^0.22.1",
     "tree-sitter-javascript": "^0.23.1",
     "tree-sitter-typescript": "^0.23.2",
-    "zod": "^3.25.67"
+    "zod": "^3.25.76"
   }
 }