feat(new): Enhance agent sessions with the document conversion tool

.gitignore

@@ -1,3 +1,4 @@
 
 .DS_Store
-**/node_modules
+**/node_modules
+.vscode/settings.json

www/docs/agent-os/sessions.md

@@ -20,6 +20,7 @@ appended to the session.
 Sessions support lifecycle operations such as creation, update, retrieval, 
 listing, and deletion.
 
+
 ## Chat with your agent
 
 After creating an agent, you can interact with it by creating a session and sending messages:
@@ -218,6 +219,13 @@ conversations. Artifacts remain available throughout the session lifecycle,
 enabling multi-step workflows without re-uploading files.
 
 
+### Document upload and conversion
+
+You can upload PDFs, DOCX files, PowerPoints, or images to an agent session. 
+The Document Conversion Tool converts the uploaded artifact into Markdown,
+which can then be summarized, analyzed, or indexed in subsequent tool calls.
+
+
 ### Uploading files to a session
 
 To make files available to an agent, upload them to the session workspace using
@@ -298,4 +306,3 @@ After files are uploaded as artifacts, the agent can:
 
 Artifacts remain available throughout the session lifecycle, enabling multi-step
 workflows without re-uploading files.
-

www/docs/release-notes.mdx

@@ -18,6 +18,54 @@ experimenting with Retrieval Augmented Generation (RAG), or exploring our
 newest API endpoints, this page is your go-to place to see how we’re evolving 
 and how these product and documentation changes can benefit your enterprise.
 
+## Document Conversion Tool for Agents
+
+_November 16, 2025_
+
+Vectara introduces the Document Conversion Tool, a new standalone agent tool 
+that extracts content from uploaded files and converts them into clean, 
+structured Markdown format. These files include PDFs, Word documents, 
+PowerPoint presentations, and images. Converted outputs persist across a 
+session.
+
+**Why it matters:** Previously, converting uploaded files into readable text 
+required external preprocessing. This tool brings document parsing directly into 
+agent sessions, enabling agents to interpret file types and transform them 
+into context-ready text for reasoning, summarization, or indexing.
+
+**More information:**
+[Agent tools overview](/docs/agent-os/agent-tools-overview)
+[Document upload and conversion](docs/agent-os/sessions#document-upload-and-conversion)
+
+---
+
+## Artifact Storage for Agents
+
+_November 15, 2025_
+
+The Agents API now supports artifact storage, a persistent, session-scoped 
+workspace for files that enables efficient multi-step document processing 
+workflows. Artifacts provide a persistent workspace where agents and users 
+can share files throughout a conversation without bloating the agent's context. 
+When the session expires, the artifacts are cleaned up.
+
+
+**Why it matters:** Before artifact storage, file uploads caused context window 
+bloat and inefficient multi-step workflows. Artifacts solve these problems by 
+separating file storage from file references. Upload a PDF once, and reference 
+it across multiple operations like conversion, analysis, and indexing.
+
+**What's new:**
+* Session-scoped storage: Files uploaded to agent sessions are stored as artifacts 
+with unique identifiers, remaining available throughout the conversation lifecycle.
+* Lightweight references: `ArtifactReference` objects contain only metadata (artifact_id, 
+filename, mime_type, size_bytes) instead of full file contents, reducing payload sizes 
+from potentially megabytes to ~100 bytes.                                                                                  
+
+**More information:**
+[Agent tools overview](/docs/agent-os/agent-tools-overview)
+[Working with artifacts](/docs/agent-os/sessions#working-with-artifacts-in-sessions)
+
 ---
 
 ## Lambda Tools: Customize Python Functions in Agents