diff --git a/.branchlet.json b/.branchlet.json
new file mode 100644
index 0000000000..cc13ff9f74
--- /dev/null
+++ b/.branchlet.json
@@ -0,0 +1,37 @@
+{
+  "worktreeCopyPatterns": [
+    ".env*",
+    ".vscode/**",
+    ".auth/**",
+    ".claude/**",
+    "autogpt_platform/.env*",
+    "autogpt_platform/backend/.env*",
+    "autogpt_platform/frontend/.env*",
+    "autogpt_platform/frontend/.auth/**",
+    "autogpt_platform/db/docker/.env*"
+  ],
+  "worktreeCopyIgnores": [
+    "**/node_modules/**",
+    "**/dist/**",
+    "**/.git/**",
+    "**/Thumbs.db",
+    "**/.DS_Store",
+    "**/.next/**",
+    "**/__pycache__/**",
+    "**/.ruff_cache/**",
+    "**/.pytest_cache/**",
+    "**/*.pyc",
+    "**/playwright-report/**",
+    "**/logs/**",
+    "**/site/**"
+  ],
+  "worktreePathTemplate": "$BASE_PATH.worktree",
+  "postCreateCmd": [
+    "cd autogpt_platform/autogpt_libs && poetry install",
+    "cd autogpt_platform/backend && poetry install && poetry run prisma generate",
+    "cd autogpt_platform/frontend && pnpm install",
+    "cd docs && pip install -r requirements.txt"
+  ],
+  "terminalCommand": "code .",
+  "deleteBranchWithWorktree": false
+}
diff --git a/.claude/skills/vercel-react-best-practices/AGENTS.md b/.claude/skills/vercel-react-best-practices/AGENTS.md
new file mode 100644
index 0000000000..280a6ae68d
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/AGENTS.md
@@ -0,0 +1,2249 @@
+# React Best Practices
+
+**Version 1.0.0**  
+Vercel Engineering  
+January 2026
+
+> **Note:**  
+> This document is mainly for agents and LLMs to follow when maintaining,  
+> generating, or refactoring React and Next.js codebases at Vercel. Humans  
+> may also find it useful, but guidance here is optimized for automation  
+> and consistency by AI-assisted workflows.
+
+---
+
+## Abstract
+
+Comprehensive performance optimization guide for React and Next.js applications, designed for AI agents and LLMs. Contains 40+ rules across 8 categories, prioritized by impact from critical (eliminating waterfalls, reducing bundle size) to incremental (advanced patterns). Each rule includes detailed explanations, real-world examples comparing incorrect vs. correct implementations, and specific impact metrics to guide automated refactoring and code generation.
+
+---
+
+## Table of Contents
+
+1. [Eliminating Waterfalls](#1-eliminating-waterfalls) — **CRITICAL**
+   - 1.1 [Defer Await Until Needed](#11-defer-await-until-needed)
+   - 1.2 [Dependency-Based Parallelization](#12-dependency-based-parallelization)
+   - 1.3 [Prevent Waterfall Chains in API Routes](#13-prevent-waterfall-chains-in-api-routes)
+   - 1.4 [Promise.all() for Independent Operations](#14-promiseall-for-independent-operations)
+   - 1.5 [Strategic Suspense Boundaries](#15-strategic-suspense-boundaries)
+2. [Bundle Size Optimization](#2-bundle-size-optimization) — **CRITICAL**
+   - 2.1 [Avoid Barrel File Imports](#21-avoid-barrel-file-imports)
+   - 2.2 [Conditional Module Loading](#22-conditional-module-loading)
+   - 2.3 [Defer Non-Critical Third-Party Libraries](#23-defer-non-critical-third-party-libraries)
+   - 2.4 [Dynamic Imports for Heavy Components](#24-dynamic-imports-for-heavy-components)
+   - 2.5 [Preload Based on User Intent](#25-preload-based-on-user-intent)
+3. [Server-Side Performance](#3-server-side-performance) — **HIGH**
+   - 3.1 [Cross-Request LRU Caching](#31-cross-request-lru-caching)
+   - 3.2 [Minimize Serialization at RSC Boundaries](#32-minimize-serialization-at-rsc-boundaries)
+   - 3.3 [Parallel Data Fetching with Component Composition](#33-parallel-data-fetching-with-component-composition)
+   - 3.4 [Per-Request Deduplication with React.cache()](#34-per-request-deduplication-with-reactcache)
+   - 3.5 [Use after() for Non-Blocking Operations](#35-use-after-for-non-blocking-operations)
+4. [Client-Side Data Fetching](#4-client-side-data-fetching) — **MEDIUM-HIGH**
+   - 4.1 [Deduplicate Global Event Listeners](#41-deduplicate-global-event-listeners)
+   - 4.2 [Use SWR for Automatic Deduplication](#42-use-swr-for-automatic-deduplication)
+5. [Re-render Optimization](#5-re-render-optimization) — **MEDIUM**
+   - 5.1 [Defer State Reads to Usage Point](#51-defer-state-reads-to-usage-point)
+   - 5.2 [Extract to Memoized Components](#52-extract-to-memoized-components)
+   - 5.3 [Narrow Effect Dependencies](#53-narrow-effect-dependencies)
+   - 5.4 [Subscribe to Derived State](#54-subscribe-to-derived-state)
+   - 5.5 [Use Functional setState Updates](#55-use-functional-setstate-updates)
+   - 5.6 [Use Lazy State Initialization](#56-use-lazy-state-initialization)
+   - 5.7 [Use Transitions for Non-Urgent Updates](#57-use-transitions-for-non-urgent-updates)
+6. [Rendering Performance](#6-rendering-performance) — **MEDIUM**
+   - 6.1 [Animate SVG Wrapper Instead of SVG Element](#61-animate-svg-wrapper-instead-of-svg-element)
+   - 6.2 [CSS content-visibility for Long Lists](#62-css-content-visibility-for-long-lists)
+   - 6.3 [Hoist Static JSX Elements](#63-hoist-static-jsx-elements)
+   - 6.4 [Optimize SVG Precision](#64-optimize-svg-precision)
+   - 6.5 [Prevent Hydration Mismatch Without Flickering](#65-prevent-hydration-mismatch-without-flickering)
+   - 6.6 [Use Activity Component for Show/Hide](#66-use-activity-component-for-showhide)
+   - 6.7 [Use Explicit Conditional Rendering](#67-use-explicit-conditional-rendering)
+7. [JavaScript Performance](#7-javascript-performance) — **LOW-MEDIUM**
+   - 7.1 [Batch DOM CSS Changes](#71-batch-dom-css-changes)
+   - 7.2 [Build Index Maps for Repeated Lookups](#72-build-index-maps-for-repeated-lookups)
+   - 7.3 [Cache Property Access in Loops](#73-cache-property-access-in-loops)
+   - 7.4 [Cache Repeated Function Calls](#74-cache-repeated-function-calls)
+   - 7.5 [Cache Storage API Calls](#75-cache-storage-api-calls)
+   - 7.6 [Combine Multiple Array Iterations](#76-combine-multiple-array-iterations)
+   - 7.7 [Early Length Check for Array Comparisons](#77-early-length-check-for-array-comparisons)
+   - 7.8 [Early Return from Functions](#78-early-return-from-functions)
+   - 7.9 [Hoist RegExp Creation](#79-hoist-regexp-creation)
+   - 7.10 [Use Loop for Min/Max Instead of Sort](#710-use-loop-for-minmax-instead-of-sort)
+   - 7.11 [Use Set/Map for O(1) Lookups](#711-use-setmap-for-o1-lookups)
+   - 7.12 [Use toSorted() Instead of sort() for Immutability](#712-use-tosorted-instead-of-sort-for-immutability)
+8. [Advanced Patterns](#8-advanced-patterns) — **LOW**
+   - 8.1 [Store Event Handlers in Refs](#81-store-event-handlers-in-refs)
+   - 8.2 [useLatest for Stable Callback Refs](#82-uselatest-for-stable-callback-refs)
+
+---
+
+## 1. Eliminating Waterfalls
+
+**Impact: CRITICAL**
+
+Waterfalls are the #1 performance killer. Each sequential await adds full network latency. Eliminating them yields the largest gains.
+
+### 1.1 Defer Await Until Needed
+
+**Impact: HIGH (avoids blocking unused code paths)**
+
+Move `await` operations into the branches where they're actually used to avoid blocking code paths that don't need them.
+
+**Incorrect: blocks both branches**
+
+```typescript
+async function handleRequest(userId: string, skipProcessing: boolean) {
+  const userData = await fetchUserData(userId)
+  
+  if (skipProcessing) {
+    // Returns immediately but still waited for userData
+    return { skipped: true }
+  }
+  
+  // Only this branch uses userData
+  return processUserData(userData)
+}
+```
+
+**Correct: only blocks when needed**
+
+```typescript
+async function handleRequest(userId: string, skipProcessing: boolean) {
+  if (skipProcessing) {
+    // Returns immediately without waiting
+    return { skipped: true }
+  }
+  
+  // Fetch only when needed
+  const userData = await fetchUserData(userId)
+  return processUserData(userData)
+}
+```
+
+**Another example: early return optimization**
+
+```typescript
+// Incorrect: always fetches permissions
+async function updateResource(resourceId: string, userId: string) {
+  const permissions = await fetchPermissions(userId)
+  const resource = await getResource(resourceId)
+  
+  if (!resource) {
+    return { error: 'Not found' }
+  }
+  
+  if (!permissions.canEdit) {
+    return { error: 'Forbidden' }
+  }
+  
+  return await updateResourceData(resource, permissions)
+}
+
+// Correct: fetches only when needed
+async function updateResource(resourceId: string, userId: string) {
+  const resource = await getResource(resourceId)
+  
+  if (!resource) {
+    return { error: 'Not found' }
+  }
+  
+  const permissions = await fetchPermissions(userId)
+  
+  if (!permissions.canEdit) {
+    return { error: 'Forbidden' }
+  }
+  
+  return await updateResourceData(resource, permissions)
+}
+```
+
+This optimization is especially valuable when the skipped branch is frequently taken, or when the deferred operation is expensive.
+
+### 1.2 Dependency-Based Parallelization
+
+**Impact: CRITICAL (2-10× improvement)**
+
+For operations with partial dependencies, use `better-all` to maximize parallelism. It automatically starts each task at the earliest possible moment.
+
+**Incorrect: profile waits for config unnecessarily**
+
+```typescript
+const [user, config] = await Promise.all([
+  fetchUser(),
+  fetchConfig()
+])
+const profile = await fetchProfile(user.id)
+```
+
+**Correct: config and profile run in parallel**
+
+```typescript
+import { all } from 'better-all'
+
+const { user, config, profile } = await all({
+  async user() { return fetchUser() },
+  async config() { return fetchConfig() },
+  async profile() {
+    return fetchProfile((await this.$.user).id)
+  }
+})
+```
+
+Reference: [https://github.com/shuding/better-all](https://github.com/shuding/better-all)
+
+### 1.3 Prevent Waterfall Chains in API Routes
+
+**Impact: CRITICAL (2-10× improvement)**
+
+In API routes and Server Actions, start independent operations immediately, even if you don't await them yet.
+
+**Incorrect: config waits for auth, data waits for both**
+
+```typescript
+export async function GET(request: Request) {
+  const session = await auth()
+  const config = await fetchConfig()
+  const data = await fetchData(session.user.id)
+  return Response.json({ data, config })
+}
+```
+
+**Correct: auth and config start immediately**
+
+```typescript
+export async function GET(request: Request) {
+  const sessionPromise = auth()
+  const configPromise = fetchConfig()
+  const session = await sessionPromise
+  const [config, data] = await Promise.all([
+    configPromise,
+    fetchData(session.user.id)
+  ])
+  return Response.json({ data, config })
+}
+```
+
+For operations with more complex dependency chains, use `better-all` to automatically maximize parallelism (see Dependency-Based Parallelization).
+
+### 1.4 Promise.all() for Independent Operations
+
+**Impact: CRITICAL (2-10× improvement)**
+
+When async operations have no interdependencies, execute them concurrently using `Promise.all()`.
+
+**Incorrect: sequential execution, 3 round trips**
+
+```typescript
+const user = await fetchUser()
+const posts = await fetchPosts()
+const comments = await fetchComments()
+```
+
+**Correct: parallel execution, 1 round trip**
+
+```typescript
+const [user, posts, comments] = await Promise.all([
+  fetchUser(),
+  fetchPosts(),
+  fetchComments()
+])
+```
+
+### 1.5 Strategic Suspense Boundaries
+
+**Impact: HIGH (faster initial paint)**
+
+Instead of awaiting data in async components before returning JSX, use Suspense boundaries to show the wrapper UI faster while data loads.
+
+**Incorrect: wrapper blocked by data fetching**
+
+```tsx
+async function Page() {
+  const data = await fetchData() // Blocks entire page
+  
+  return (
+    <div>
+      <div>Sidebar</div>
+      <div>Header</div>
+      <div>
+        <DataDisplay data={data} />
+      </div>
+      <div>Footer</div>
+    </div>
+  )
+}
+```
+
+The entire layout waits for data even though only the middle section needs it.
+
+**Correct: wrapper shows immediately, data streams in**
+
+```tsx
+function Page() {
+  return (
+    <div>
+      <div>Sidebar</div>
+      <div>Header</div>
+      <div>
+        <Suspense fallback={<Skeleton />}>
+          <DataDisplay />
+        </Suspense>
+      </div>
+      <div>Footer</div>
+    </div>
+  )
+}
+
+async function DataDisplay() {
+  const data = await fetchData() // Only blocks this component
+  return <div>{data.content}</div>
+}
+```
+
+Sidebar, Header, and Footer render immediately. Only DataDisplay waits for data.
+
+**Alternative: share promise across components**
+
+```tsx
+function Page() {
+  // Start fetch immediately, but don't await
+  const dataPromise = fetchData()
+  
+  return (
+    <div>
+      <div>Sidebar</div>
+      <div>Header</div>
+      <Suspense fallback={<Skeleton />}>
+        <DataDisplay dataPromise={dataPromise} />
+        <DataSummary dataPromise={dataPromise} />
+      </Suspense>
+      <div>Footer</div>
+    </div>
+  )
+}
+
+function DataDisplay({ dataPromise }: { dataPromise: Promise<Data> }) {
+  const data = use(dataPromise) // Unwraps the promise
+  return <div>{data.content}</div>
+}
+
+function DataSummary({ dataPromise }: { dataPromise: Promise<Data> }) {
+  const data = use(dataPromise) // Reuses the same promise
+  return <div>{data.summary}</div>
+}
+```
+
+Both components share the same promise, so only one fetch occurs. Layout renders immediately while both components wait together.
+
+**When NOT to use this pattern:**
+
+- Critical data needed for layout decisions (affects positioning)
+
+- SEO-critical content above the fold
+
+- Small, fast queries where suspense overhead isn't worth it
+
+- When you want to avoid layout shift (loading → content jump)
+
+**Trade-off:** Faster initial paint vs potential layout shift. Choose based on your UX priorities.
+
+---
+
+## 2. Bundle Size Optimization
+
+**Impact: CRITICAL**
+
+Reducing initial bundle size improves Time to Interactive and Largest Contentful Paint.
+
+### 2.1 Avoid Barrel File Imports
+
+**Impact: CRITICAL (200-800ms import cost, slow builds)**
+
+Import directly from source files instead of barrel files to avoid loading thousands of unused modules. **Barrel files** are entry points that re-export multiple modules (e.g., `index.js` that does `export * from './module'`).
+
+Popular icon and component libraries can have **up to 10,000 re-exports** in their entry file. For many React packages, **it takes 200-800ms just to import them**, affecting both development speed and production cold starts.
+
+**Why tree-shaking doesn't help:** When a library is marked as external (not bundled), the bundler can't optimize it. If you bundle it to enable tree-shaking, builds become substantially slower analyzing the entire module graph.
+
+**Incorrect: imports entire library**
+
+```tsx
+import { Check, X, Menu } from 'lucide-react'
+// Loads 1,583 modules, takes ~2.8s extra in dev
+// Runtime cost: 200-800ms on every cold start
+
+import { Button, TextField } from '@mui/material'
+// Loads 2,225 modules, takes ~4.2s extra in dev
+```
+
+**Correct: imports only what you need**
+
+```tsx
+import Check from 'lucide-react/dist/esm/icons/check'
+import X from 'lucide-react/dist/esm/icons/x'
+import Menu from 'lucide-react/dist/esm/icons/menu'
+// Loads only 3 modules (~2KB vs ~1MB)
+
+import Button from '@mui/material/Button'
+import TextField from '@mui/material/TextField'
+// Loads only what you use
+```
+
+**Alternative: Next.js 13.5+**
+
+```js
+// next.config.js - use optimizePackageImports
+module.exports = {
+  experimental: {
+    optimizePackageImports: ['lucide-react', '@mui/material']
+  }
+}
+
+// Then you can keep the ergonomic barrel imports:
+import { Check, X, Menu } from 'lucide-react'
+// Automatically transformed to direct imports at build time
+```
+
+Direct imports provide 15-70% faster dev boot, 28% faster builds, 40% faster cold starts, and significantly faster HMR.
+
+Libraries commonly affected: `lucide-react`, `@mui/material`, `@mui/icons-material`, `@tabler/icons-react`, `react-icons`, `@headlessui/react`, `@radix-ui/react-*`, `lodash`, `ramda`, `date-fns`, `rxjs`, `react-use`.
+
+Reference: [https://vercel.com/blog/how-we-optimized-package-imports-in-next-js](https://vercel.com/blog/how-we-optimized-package-imports-in-next-js)
+
+### 2.2 Conditional Module Loading
+
+**Impact: HIGH (loads large data only when needed)**
+
+Load large data or modules only when a feature is activated.
+
+**Example: lazy-load animation frames**
+
+```tsx
+function AnimationPlayer({ enabled }: { enabled: boolean }) {
+  const [frames, setFrames] = useState<Frame[] | null>(null)
+
+  useEffect(() => {
+    if (enabled && !frames && typeof window !== 'undefined') {
+      import('./animation-frames.js')
+        .then(mod => setFrames(mod.frames))
+        .catch(() => setEnabled(false))
+    }
+  }, [enabled, frames])
+
+  if (!frames) return <Skeleton />
+  return <Canvas frames={frames} />
+}
+```
+
+The `typeof window !== 'undefined'` check prevents bundling this module for SSR, optimizing server bundle size and build speed.
+
+### 2.3 Defer Non-Critical Third-Party Libraries
+
+**Impact: MEDIUM (loads after hydration)**
+
+Analytics, logging, and error tracking don't block user interaction. Load them after hydration.
+
+**Incorrect: blocks initial bundle**
+
+```tsx
+import { Analytics } from '@vercel/analytics/react'
+
+export default function RootLayout({ children }) {
+  return (
+    <html>
+      <body>
+        {children}
+        <Analytics />
+      </body>
+    </html>
+  )
+}
+```
+
+**Correct: loads after hydration**
+
+```tsx
+import dynamic from 'next/dynamic'
+
+const Analytics = dynamic(
+  () => import('@vercel/analytics/react').then(m => m.Analytics),
+  { ssr: false }
+)
+
+export default function RootLayout({ children }) {
+  return (
+    <html>
+      <body>
+        {children}
+        <Analytics />
+      </body>
+    </html>
+  )
+}
+```
+
+### 2.4 Dynamic Imports for Heavy Components
+
+**Impact: CRITICAL (directly affects TTI and LCP)**
+
+Use `next/dynamic` to lazy-load large components not needed on initial render.
+
+**Incorrect: Monaco bundles with main chunk ~300KB**
+
+```tsx
+import { MonacoEditor } from './monaco-editor'
+
+function CodePanel({ code }: { code: string }) {
+  return <MonacoEditor value={code} />
+}
+```
+
+**Correct: Monaco loads on demand**
+
+```tsx
+import dynamic from 'next/dynamic'
+
+const MonacoEditor = dynamic(
+  () => import('./monaco-editor').then(m => m.MonacoEditor),
+  { ssr: false }
+)
+
+function CodePanel({ code }: { code: string }) {
+  return <MonacoEditor value={code} />
+}
+```
+
+### 2.5 Preload Based on User Intent
+
+**Impact: MEDIUM (reduces perceived latency)**
+
+Preload heavy bundles before they're needed to reduce perceived latency.
+
+**Example: preload on hover/focus**
+
+```tsx
+function EditorButton({ onClick }: { onClick: () => void }) {
+  const preload = () => {
+    if (typeof window !== 'undefined') {
+      void import('./monaco-editor')
+    }
+  }
+
+  return (
+    <button
+      onMouseEnter={preload}
+      onFocus={preload}
+      onClick={onClick}
+    >
+      Open Editor
+    </button>
+  )
+}
+```
+
+**Example: preload when feature flag is enabled**
+
+```tsx
+function FlagsProvider({ children, flags }: Props) {
+  useEffect(() => {
+    if (flags.editorEnabled && typeof window !== 'undefined') {
+      void import('./monaco-editor').then(mod => mod.init())
+    }
+  }, [flags.editorEnabled])
+
+  return <FlagsContext.Provider value={flags}>
+    {children}
+  </FlagsContext.Provider>
+}
+```
+
+The `typeof window !== 'undefined'` check prevents bundling preloaded modules for SSR, optimizing server bundle size and build speed.
+
+---
+
+## 3. Server-Side Performance
+
+**Impact: HIGH**
+
+Optimizing server-side rendering and data fetching eliminates server-side waterfalls and reduces response times.
+
+### 3.1 Cross-Request LRU Caching
+
+**Impact: HIGH (caches across requests)**
+
+`React.cache()` only works within one request. For data shared across sequential requests (user clicks button A then button B), use an LRU cache.
+
+**Implementation:**
+
+```typescript
+import { LRUCache } from 'lru-cache'
+
+const cache = new LRUCache<string, any>({
+  max: 1000,
+  ttl: 5 * 60 * 1000  // 5 minutes
+})
+
+export async function getUser(id: string) {
+  const cached = cache.get(id)
+  if (cached) return cached
+
+  const user = await db.user.findUnique({ where: { id } })
+  cache.set(id, user)
+  return user
+}
+
+// Request 1: DB query, result cached
+// Request 2: cache hit, no DB query
+```
+
+Use when sequential user actions hit multiple endpoints needing the same data within seconds.
+
+**With Vercel's [Fluid Compute](https://vercel.com/docs/fluid-compute):** LRU caching is especially effective because multiple concurrent requests can share the same function instance and cache. This means the cache persists across requests without needing external storage like Redis.
+
+**In traditional serverless:** Each invocation runs in isolation, so consider Redis for cross-process caching.
+
+Reference: [https://github.com/isaacs/node-lru-cache](https://github.com/isaacs/node-lru-cache)
+
+### 3.2 Minimize Serialization at RSC Boundaries
+
+**Impact: HIGH (reduces data transfer size)**
+
+The React Server/Client boundary serializes all object properties into strings and embeds them in the HTML response and subsequent RSC requests. This serialized data directly impacts page weight and load time, so **size matters a lot**. Only pass fields that the client actually uses.
+
+**Incorrect: serializes all 50 fields**
+
+```tsx
+async function Page() {
+  const user = await fetchUser()  // 50 fields
+  return <Profile user={user} />
+}
+
+'use client'
+function Profile({ user }: { user: User }) {
+  return <div>{user.name}</div>  // uses 1 field
+}
+```
+
+**Correct: serializes only 1 field**
+
+```tsx
+async function Page() {
+  const user = await fetchUser()
+  return <Profile name={user.name} />
+}
+
+'use client'
+function Profile({ name }: { name: string }) {
+  return <div>{name}</div>
+}
+```
+
+### 3.3 Parallel Data Fetching with Component Composition
+
+**Impact: CRITICAL (eliminates server-side waterfalls)**
+
+React Server Components execute sequentially within a tree. Restructure with composition to parallelize data fetching.
+
+**Incorrect: Sidebar waits for Page's fetch to complete**
+
+```tsx
+export default async function Page() {
+  const header = await fetchHeader()
+  return (
+    <div>
+      <div>{header}</div>
+      <Sidebar />
+    </div>
+  )
+}
+
+async function Sidebar() {
+  const items = await fetchSidebarItems()
+  return <nav>{items.map(renderItem)}</nav>
+}
+```
+
+**Correct: both fetch simultaneously**
+
+```tsx
+async function Header() {
+  const data = await fetchHeader()
+  return <div>{data}</div>
+}
+
+async function Sidebar() {
+  const items = await fetchSidebarItems()
+  return <nav>{items.map(renderItem)}</nav>
+}
+
+export default function Page() {
+  return (
+    <div>
+      <Header />
+      <Sidebar />
+    </div>
+  )
+}
+```
+
+**Alternative with children prop:**
+
+```tsx
+async function Layout({ children }: { children: ReactNode }) {
+  const header = await fetchHeader()
+  return (
+    <div>
+      <div>{header}</div>
+      {children}
+    </div>
+  )
+}
+
+async function Sidebar() {
+  const items = await fetchSidebarItems()
+  return <nav>{items.map(renderItem)}</nav>
+}
+
+export default function Page() {
+  return (
+    <Layout>
+      <Sidebar />
+    </Layout>
+  )
+}
+```
+
+### 3.4 Per-Request Deduplication with React.cache()
+
+**Impact: MEDIUM (deduplicates within request)**
+
+Use `React.cache()` for server-side request deduplication. Authentication and database queries benefit most.
+
+**Usage:**
+
+```typescript
+import { cache } from 'react'
+
+export const getCurrentUser = cache(async () => {
+  const session = await auth()
+  if (!session?.user?.id) return null
+  return await db.user.findUnique({
+    where: { id: session.user.id }
+  })
+})
+```
+
+Within a single request, multiple calls to `getCurrentUser()` execute the query only once.
+
+### 3.5 Use after() for Non-Blocking Operations
+
+**Impact: MEDIUM (faster response times)**
+
+Use Next.js's `after()` to schedule work that should execute after a response is sent. This prevents logging, analytics, and other side effects from blocking the response.
+
+**Incorrect: blocks response**
+
+```tsx
+import { logUserAction } from '@/app/utils'
+
+export async function POST(request: Request) {
+  // Perform mutation
+  await updateDatabase(request)
+  
+  // Logging blocks the response
+  const userAgent = request.headers.get('user-agent') || 'unknown'
+  await logUserAction({ userAgent })
+  
+  return new Response(JSON.stringify({ status: 'success' }), {
+    status: 200,
+    headers: { 'Content-Type': 'application/json' }
+  })
+}
+```
+
+**Correct: non-blocking**
+
+```tsx
+import { after } from 'next/server'
+import { headers, cookies } from 'next/headers'
+import { logUserAction } from '@/app/utils'
+
+export async function POST(request: Request) {
+  // Perform mutation
+  await updateDatabase(request)
+  
+  // Log after response is sent
+  after(async () => {
+    const userAgent = (await headers()).get('user-agent') || 'unknown'
+    const sessionCookie = (await cookies()).get('session-id')?.value || 'anonymous'
+    
+    logUserAction({ sessionCookie, userAgent })
+  })
+  
+  return new Response(JSON.stringify({ status: 'success' }), {
+    status: 200,
+    headers: { 'Content-Type': 'application/json' }
+  })
+}
+```
+
+The response is sent immediately while logging happens in the background.
+
+**Common use cases:**
+
+- Analytics tracking
+
+- Audit logging
+
+- Sending notifications
+
+- Cache invalidation
+
+- Cleanup tasks
+
+**Important notes:**
+
+- `after()` runs even if the response fails or redirects
+
+- Works in Server Actions, Route Handlers, and Server Components
+
+Reference: [https://nextjs.org/docs/app/api-reference/functions/after](https://nextjs.org/docs/app/api-reference/functions/after)
+
+---
+
+## 4. Client-Side Data Fetching
+
+**Impact: MEDIUM-HIGH**
+
+Automatic deduplication and efficient data fetching patterns reduce redundant network requests.
+
+### 4.1 Deduplicate Global Event Listeners
+
+**Impact: LOW (single listener for N components)**
+
+Use `useSWRSubscription()` to share global event listeners across component instances.
+
+**Incorrect: N instances = N listeners**
+
+```tsx
+function useKeyboardShortcut(key: string, callback: () => void) {
+  useEffect(() => {
+    const handler = (e: KeyboardEvent) => {
+      if (e.metaKey && e.key === key) {
+        callback()
+      }
+    }
+    window.addEventListener('keydown', handler)
+    return () => window.removeEventListener('keydown', handler)
+  }, [key, callback])
+}
+```
+
+When using the `useKeyboardShortcut` hook multiple times, each instance will register a new listener.
+
+**Correct: N instances = 1 listener**
+
+```tsx
+import useSWRSubscription from 'swr/subscription'
+
+// Module-level Map to track callbacks per key
+const keyCallbacks = new Map<string, Set<() => void>>()
+
+function useKeyboardShortcut(key: string, callback: () => void) {
+  // Register this callback in the Map
+  useEffect(() => {
+    if (!keyCallbacks.has(key)) {
+      keyCallbacks.set(key, new Set())
+    }
+    keyCallbacks.get(key)!.add(callback)
+
+    return () => {
+      const set = keyCallbacks.get(key)
+      if (set) {
+        set.delete(callback)
+        if (set.size === 0) {
+          keyCallbacks.delete(key)
+        }
+      }
+    }
+  }, [key, callback])
+
+  useSWRSubscription('global-keydown', () => {
+    const handler = (e: KeyboardEvent) => {
+      if (e.metaKey && keyCallbacks.has(e.key)) {
+        keyCallbacks.get(e.key)!.forEach(cb => cb())
+      }
+    }
+    window.addEventListener('keydown', handler)
+    return () => window.removeEventListener('keydown', handler)
+  })
+}
+
+function Profile() {
+  // Multiple shortcuts will share the same listener
+  useKeyboardShortcut('p', () => { /* ... */ }) 
+  useKeyboardShortcut('k', () => { /* ... */ })
+  // ...
+}
+```
+
+### 4.2 Use SWR for Automatic Deduplication
+
+**Impact: MEDIUM-HIGH (automatic deduplication)**
+
+SWR enables request deduplication, caching, and revalidation across component instances.
+
+**Incorrect: no deduplication, each instance fetches**
+
+```tsx
+function UserList() {
+  const [users, setUsers] = useState([])
+  useEffect(() => {
+    fetch('/api/users')
+      .then(r => r.json())
+      .then(setUsers)
+  }, [])
+}
+```
+
+**Correct: multiple instances share one request**
+
+```tsx
+import useSWR from 'swr'
+
+function UserList() {
+  const { data: users } = useSWR('/api/users', fetcher)
+}
+```
+
+**For immutable data:**
+
+```tsx
+import { useImmutableSWR } from '@/lib/swr'
+
+function StaticContent() {
+  const { data } = useImmutableSWR('/api/config', fetcher)
+}
+```
+
+**For mutations:**
+
+```tsx
+import { useSWRMutation } from 'swr/mutation'
+
+function UpdateButton() {
+  const { trigger } = useSWRMutation('/api/user', updateUser)
+  return <button onClick={() => trigger()}>Update</button>
+}
+```
+
+Reference: [https://swr.vercel.app](https://swr.vercel.app)
+
+---
+
+## 5. Re-render Optimization
+
+**Impact: MEDIUM**
+
+Reducing unnecessary re-renders minimizes wasted computation and improves UI responsiveness.
+
+### 5.1 Defer State Reads to Usage Point
+
+**Impact: MEDIUM (avoids unnecessary subscriptions)**
+
+Don't subscribe to dynamic state (searchParams, localStorage) if you only read it inside callbacks.
+
+**Incorrect: subscribes to all searchParams changes**
+
+```tsx
+function ShareButton({ chatId }: { chatId: string }) {
+  const searchParams = useSearchParams()
+
+  const handleShare = () => {
+    const ref = searchParams.get('ref')
+    shareChat(chatId, { ref })
+  }
+
+  return <button onClick={handleShare}>Share</button>
+}
+```
+
+**Correct: reads on demand, no subscription**
+
+```tsx
+function ShareButton({ chatId }: { chatId: string }) {
+  const handleShare = () => {
+    const params = new URLSearchParams(window.location.search)
+    const ref = params.get('ref')
+    shareChat(chatId, { ref })
+  }
+
+  return <button onClick={handleShare}>Share</button>
+}
+```
+
+### 5.2 Extract to Memoized Components
+
+**Impact: MEDIUM (enables early returns)**
+
+Extract expensive work into memoized components to enable early returns before computation.
+
+**Incorrect: computes avatar even when loading**
+
+```tsx
+function Profile({ user, loading }: Props) {
+  const avatar = useMemo(() => {
+    const id = computeAvatarId(user)
+    return <Avatar id={id} />
+  }, [user])
+
+  if (loading) return <Skeleton />
+  return <div>{avatar}</div>
+}
+```
+
+**Correct: skips computation when loading**
+
+```tsx
+const UserAvatar = memo(function UserAvatar({ user }: { user: User }) {
+  const id = useMemo(() => computeAvatarId(user), [user])
+  return <Avatar id={id} />
+})
+
+function Profile({ user, loading }: Props) {
+  if (loading) return <Skeleton />
+  return (
+    <div>
+      <UserAvatar user={user} />
+    </div>
+  )
+}
+```
+
+**Note:** If your project has [React Compiler](https://react.dev/learn/react-compiler) enabled, manual memoization with `memo()` and `useMemo()` is not necessary. The compiler automatically optimizes re-renders.
+
+### 5.3 Narrow Effect Dependencies
+
+**Impact: LOW (minimizes effect re-runs)**
+
+Specify primitive dependencies instead of objects to minimize effect re-runs.
+
+**Incorrect: re-runs on any user field change**
+
+```tsx
+useEffect(() => {
+  console.log(user.id)
+}, [user])
+```
+
+**Correct: re-runs only when id changes**
+
+```tsx
+useEffect(() => {
+  console.log(user.id)
+}, [user.id])
+```
+
+**For derived state, compute outside effect:**
+
+```tsx
+// Incorrect: runs on width=767, 766, 765...
+useEffect(() => {
+  if (width < 768) {
+    enableMobileMode()
+  }
+}, [width])
+
+// Correct: runs only on boolean transition
+const isMobile = width < 768
+useEffect(() => {
+  if (isMobile) {
+    enableMobileMode()
+  }
+}, [isMobile])
+```
+
+### 5.4 Subscribe to Derived State
+
+**Impact: MEDIUM (reduces re-render frequency)**
+
+Subscribe to derived boolean state instead of continuous values to reduce re-render frequency.
+
+**Incorrect: re-renders on every pixel change**
+
+```tsx
+function Sidebar() {
+  const width = useWindowWidth()  // updates continuously
+  const isMobile = width < 768
+  return <nav className={isMobile ? 'mobile' : 'desktop'}>
+}
+```
+
+**Correct: re-renders only when boolean changes**
+
+```tsx
+function Sidebar() {
+  const isMobile = useMediaQuery('(max-width: 767px)')
+  return <nav className={isMobile ? 'mobile' : 'desktop'}>
+}
+```
+
+### 5.5 Use Functional setState Updates
+
+**Impact: MEDIUM (prevents stale closures and unnecessary callback recreations)**
+
+When updating state based on the current state value, use the functional update form of setState instead of directly referencing the state variable. This prevents stale closures, eliminates unnecessary dependencies, and creates stable callback references.
+
+**Incorrect: requires state as dependency**
+
+```tsx
+function TodoList() {
+  const [items, setItems] = useState(initialItems)
+  
+  // Callback must depend on items, recreated on every items change
+  const addItems = useCallback((newItems: Item[]) => {
+    setItems([...items, ...newItems])
+  }, [items])  // ❌ items dependency causes recreations
+  
+  // Risk of stale closure if dependency is forgotten
+  const removeItem = useCallback((id: string) => {
+    setItems(items.filter(item => item.id !== id))
+  }, [])  // ❌ Missing items dependency - will use stale items!
+  
+  return <ItemsEditor items={items} onAdd={addItems} onRemove={removeItem} />
+}
+```
+
+The first callback is recreated every time `items` changes, which can cause child components to re-render unnecessarily. The second callback has a stale closure bug—it will always reference the initial `items` value.
+
+**Correct: stable callbacks, no stale closures**
+
+```tsx
+function TodoList() {
+  const [items, setItems] = useState(initialItems)
+  
+  // Stable callback, never recreated
+  const addItems = useCallback((newItems: Item[]) => {
+    setItems(curr => [...curr, ...newItems])
+  }, [])  // ✅ No dependencies needed
+  
+  // Always uses latest state, no stale closure risk
+  const removeItem = useCallback((id: string) => {
+    setItems(curr => curr.filter(item => item.id !== id))
+  }, [])  // ✅ Safe and stable
+  
+  return <ItemsEditor items={items} onAdd={addItems} onRemove={removeItem} />
+}
+```
+
+**Benefits:**
+
+1. **Stable callback references** - Callbacks don't need to be recreated when state changes
+
+2. **No stale closures** - Always operates on the latest state value
+
+3. **Fewer dependencies** - Simplifies dependency arrays and reduces memory leaks
+
+4. **Prevents bugs** - Eliminates the most common source of React closure bugs
+
+**When to use functional updates:**
+
+- Any setState that depends on the current state value
+
+- Inside useCallback/useMemo when state is needed
+
+- Event handlers that reference state
+
+- Async operations that update state
+
+**When direct updates are fine:**
+
+- Setting state to a static value: `setCount(0)`
+
+- Setting state from props/arguments only: `setName(newName)`
+
+- State doesn't depend on previous value
+
+**Note:** If your project has [React Compiler](https://react.dev/learn/react-compiler) enabled, the compiler can automatically optimize some cases, but functional updates are still recommended for correctness and to prevent stale closure bugs.
+
+### 5.6 Use Lazy State Initialization
+
+**Impact: MEDIUM (wasted computation on every render)**
+
+Pass a function to `useState` for expensive initial values. Without the function form, the initializer runs on every render even though the value is only used once.
+
+**Incorrect: runs on every render**
+
+```tsx
+function FilteredList({ items }: { items: Item[] }) {
+  // buildSearchIndex() runs on EVERY render, even after initialization
+  const [searchIndex, setSearchIndex] = useState(buildSearchIndex(items))
+  const [query, setQuery] = useState('')
+  
+  // When query changes, buildSearchIndex runs again unnecessarily
+  return <SearchResults index={searchIndex} query={query} />
+}
+
+function UserProfile() {
+  // JSON.parse runs on every render
+  const [settings, setSettings] = useState(
+    JSON.parse(localStorage.getItem('settings') || '{}')
+  )
+  
+  return <SettingsForm settings={settings} onChange={setSettings} />
+}
+```
+
+**Correct: runs only once**
+
+```tsx
+function FilteredList({ items }: { items: Item[] }) {
+  // buildSearchIndex() runs ONLY on initial render
+  const [searchIndex, setSearchIndex] = useState(() => buildSearchIndex(items))
+  const [query, setQuery] = useState('')
+  
+  return <SearchResults index={searchIndex} query={query} />
+}
+
+function UserProfile() {
+  // JSON.parse runs only on initial render
+  const [settings, setSettings] = useState(() => {
+    const stored = localStorage.getItem('settings')
+    return stored ? JSON.parse(stored) : {}
+  })
+  
+  return <SettingsForm settings={settings} onChange={setSettings} />
+}
+```
+
+Use lazy initialization when computing initial values from localStorage/sessionStorage, building data structures (indexes, maps), reading from the DOM, or performing heavy transformations.
+
+For simple primitives (`useState(0)`), direct references (`useState(props.value)`), or cheap literals (`useState({})`), the function form is unnecessary.
+
+### 5.7 Use Transitions for Non-Urgent Updates
+
+**Impact: MEDIUM (maintains UI responsiveness)**
+
+Mark frequent, non-urgent state updates as transitions to maintain UI responsiveness.
+
+**Incorrect: blocks UI on every scroll**
+
+```tsx
+function ScrollTracker() {
+  const [scrollY, setScrollY] = useState(0)
+  useEffect(() => {
+    const handler = () => setScrollY(window.scrollY)
+    window.addEventListener('scroll', handler, { passive: true })
+    return () => window.removeEventListener('scroll', handler)
+  }, [])
+}
+```
+
+**Correct: non-blocking updates**
+
+```tsx
+import { startTransition } from 'react'
+
+function ScrollTracker() {
+  const [scrollY, setScrollY] = useState(0)
+  useEffect(() => {
+    const handler = () => {
+      startTransition(() => setScrollY(window.scrollY))
+    }
+    window.addEventListener('scroll', handler, { passive: true })
+    return () => window.removeEventListener('scroll', handler)
+  }, [])
+}
+```
+
+---
+
+## 6. Rendering Performance
+
+**Impact: MEDIUM**
+
+Optimizing the rendering process reduces the work the browser needs to do.
+
+### 6.1 Animate SVG Wrapper Instead of SVG Element
+
+**Impact: LOW (enables hardware acceleration)**
+
+Many browsers don't have hardware acceleration for CSS3 animations on SVG elements. Wrap SVG in a `<div>` and animate the wrapper instead.
+
+**Incorrect: animating SVG directly - no hardware acceleration**
+
+```tsx
+function LoadingSpinner() {
+  return (
+    <svg 
+      className="animate-spin"
+      width="24" 
+      height="24" 
+      viewBox="0 0 24 24"
+    >
+      <circle cx="12" cy="12" r="10" stroke="currentColor" />
+    </svg>
+  )
+}
+```
+
+**Correct: animating wrapper div - hardware accelerated**
+
+```tsx
+function LoadingSpinner() {
+  return (
+    <div className="animate-spin">
+      <svg 
+        width="24" 
+        height="24" 
+        viewBox="0 0 24 24"
+      >
+        <circle cx="12" cy="12" r="10" stroke="currentColor" />
+      </svg>
+    </div>
+  )
+}
+```
+
+This applies to all CSS transforms and transitions (`transform`, `opacity`, `translate`, `scale`, `rotate`). The wrapper div allows browsers to use GPU acceleration for smoother animations.
+
+### 6.2 CSS content-visibility for Long Lists
+
+**Impact: HIGH (faster initial render)**
+
+Apply `content-visibility: auto` to defer off-screen rendering.
+
+**CSS:**
+
+```css
+.message-item {
+  content-visibility: auto;
+  contain-intrinsic-size: 0 80px;
+}
+```
+
+**Example:**
+
+```tsx
+function MessageList({ messages }: { messages: Message[] }) {
+  return (
+    <div className="overflow-y-auto h-screen">
+      {messages.map(msg => (
+        <div key={msg.id} className="message-item">
+          <Avatar user={msg.author} />
+          <div>{msg.content}</div>
+        </div>
+      ))}
+    </div>
+  )
+}
+```
+
+For 1000 messages, browser skips layout/paint for ~990 off-screen items (10× faster initial render).
+
+### 6.3 Hoist Static JSX Elements
+
+**Impact: LOW (avoids re-creation)**
+
+Extract static JSX outside components to avoid re-creation.
+
+**Incorrect: recreates element every render**
+
+```tsx
+function LoadingSkeleton() {
+  return <div className="animate-pulse h-20 bg-gray-200" />
+}
+
+function Container() {
+  return (
+    <div>
+      {loading && <LoadingSkeleton />}
+    </div>
+  )
+}
+```
+
+**Correct: reuses same element**
+
+```tsx
+const loadingSkeleton = (
+  <div className="animate-pulse h-20 bg-gray-200" />
+)
+
+function Container() {
+  return (
+    <div>
+      {loading && loadingSkeleton}
+    </div>
+  )
+}
+```
+
+This is especially helpful for large and static SVG nodes, which can be expensive to recreate on every render.
+
+**Note:** If your project has [React Compiler](https://react.dev/learn/react-compiler) enabled, the compiler automatically hoists static JSX elements and optimizes component re-renders, making manual hoisting unnecessary.
+
+### 6.4 Optimize SVG Precision
+
+**Impact: LOW (reduces file size)**
+
+Reduce SVG coordinate precision to decrease file size. The optimal precision depends on the viewBox size, but in general reducing precision should be considered.
+
+**Incorrect: excessive precision**
+
+```svg
+<path d="M 10.293847 20.847362 L 30.938472 40.192837" />
+```
+
+**Correct: 1 decimal place**
+
+```svg
+<path d="M 10.3 20.8 L 30.9 40.2" />
+```
+
+**Automate with SVGO:**
+
+```bash
+npx svgo --precision=1 --multipass icon.svg
+```
+
+### 6.5 Prevent Hydration Mismatch Without Flickering
+
+**Impact: MEDIUM (avoids visual flicker and hydration errors)**
+
+When rendering content that depends on client-side storage (localStorage, cookies), avoid both SSR breakage and post-hydration flickering by injecting a synchronous script that updates the DOM before React hydrates.
+
+**Incorrect: breaks SSR**
+
+```tsx
+function ThemeWrapper({ children }: { children: ReactNode }) {
+  // localStorage is not available on server - throws error
+  const theme = localStorage.getItem('theme') || 'light'
+  
+  return (
+    <div className={theme}>
+      {children}
+    </div>
+  )
+}
+```
+
+Server-side rendering will fail because `localStorage` is undefined.
+
+**Incorrect: visual flickering**
+
+```tsx
+function ThemeWrapper({ children }: { children: ReactNode }) {
+  const [theme, setTheme] = useState('light')
+  
+  useEffect(() => {
+    // Runs after hydration - causes visible flash
+    const stored = localStorage.getItem('theme')
+    if (stored) {
+      setTheme(stored)
+    }
+  }, [])
+  
+  return (
+    <div className={theme}>
+      {children}
+    </div>
+  )
+}
+```
+
+Component first renders with default value (`light`), then updates after hydration, causing a visible flash of incorrect content.
+
+**Correct: no flicker, no hydration mismatch**
+
+```tsx
+function ThemeWrapper({ children }: { children: ReactNode }) {
+  return (
+    <>
+      <div id="theme-wrapper">
+        {children}
+      </div>
+      <script
+        dangerouslySetInnerHTML={{
+          __html: `
+            (function() {
+              try {
+                var theme = localStorage.getItem('theme') || 'light';
+                var el = document.getElementById('theme-wrapper');
+                if (el) el.className = theme;
+              } catch (e) {}
+            })();
+          `,
+        }}
+      />
+    </>
+  )
+}
+```
+
+The inline script executes synchronously before showing the element, ensuring the DOM already has the correct value. No flickering, no hydration mismatch.
+
+This pattern is especially useful for theme toggles, user preferences, authentication states, and any client-only data that should render immediately without flashing default values.
+
+### 6.6 Use Activity Component for Show/Hide
+
+**Impact: MEDIUM (preserves state/DOM)**
+
+Use React's `<Activity>` to preserve state/DOM for expensive components that frequently toggle visibility.
+
+**Usage:**
+
+```tsx
+import { Activity } from 'react'
+
+function Dropdown({ isOpen }: Props) {
+  return (
+    <Activity mode={isOpen ? 'visible' : 'hidden'}>
+      <ExpensiveMenu />
+    </Activity>
+  )
+}
+```
+
+Avoids expensive re-renders and state loss.
+
+### 6.7 Use Explicit Conditional Rendering
+
+**Impact: LOW (prevents rendering 0 or NaN)**
+
+Use explicit ternary operators (`? :`) instead of `&&` for conditional rendering when the condition can be `0`, `NaN`, or other falsy values that render.
+
+**Incorrect: renders "0" when count is 0**
+
+```tsx
+function Badge({ count }: { count: number }) {
+  return (
+    <div>
+      {count && <span className="badge">{count}</span>}
+    </div>
+  )
+}
+
+// When count = 0, renders: <div>0</div>
+// When count = 5, renders: <div><span class="badge">5</span></div>
+```
+
+**Correct: renders nothing when count is 0**
+
+```tsx
+function Badge({ count }: { count: number }) {
+  return (
+    <div>
+      {count > 0 ? <span className="badge">{count}</span> : null}
+    </div>
+  )
+}
+
+// When count = 0, renders: <div></div>
+// When count = 5, renders: <div><span class="badge">5</span></div>
+```
+
+---
+
+## 7. JavaScript Performance
+
+**Impact: LOW-MEDIUM**
+
+Micro-optimizations for hot paths can add up to meaningful improvements.
+
+### 7.1 Batch DOM CSS Changes
+
+**Impact: MEDIUM (reduces reflows/repaints)**
+
+Avoid changing styles one property at a time. Group multiple CSS changes together via classes or `cssText` to minimize browser reflows.
+
+**Incorrect: multiple reflows**
+
+```typescript
+function updateElementStyles(element: HTMLElement) {
+  // Each line triggers a reflow
+  element.style.width = '100px'
+  element.style.height = '200px'
+  element.style.backgroundColor = 'blue'
+  element.style.border = '1px solid black'
+}
+```
+
+**Correct: add class - single reflow**
+
+```typescript
+// CSS file
+.highlighted-box {
+  width: 100px;
+  height: 200px;
+  background-color: blue;
+  border: 1px solid black;
+}
+
+// JavaScript
+function updateElementStyles(element: HTMLElement) {
+  element.classList.add('highlighted-box')
+}
+```
+
+**Correct: change cssText - single reflow**
+
+```typescript
+function updateElementStyles(element: HTMLElement) {
+  element.style.cssText = `
+    width: 100px;
+    height: 200px;
+    background-color: blue;
+    border: 1px solid black;
+  `
+}
+```
+
+**React example:**
+
+```tsx
+// Incorrect: changing styles one by one
+function Box({ isHighlighted }: { isHighlighted: boolean }) {
+  const ref = useRef<HTMLDivElement>(null)
+  
+  useEffect(() => {
+    if (ref.current && isHighlighted) {
+      ref.current.style.width = '100px'
+      ref.current.style.height = '200px'
+      ref.current.style.backgroundColor = 'blue'
+    }
+  }, [isHighlighted])
+  
+  return <div ref={ref}>Content</div>
+}
+
+// Correct: toggle class
+function Box({ isHighlighted }: { isHighlighted: boolean }) {
+  return (
+    <div className={isHighlighted ? 'highlighted-box' : ''}>
+      Content
+    </div>
+  )
+}
+```
+
+Prefer CSS classes over inline styles when possible. Classes are cached by the browser and provide better separation of concerns.
+
+### 7.2 Build Index Maps for Repeated Lookups
+
+**Impact: LOW-MEDIUM (1M ops to 2K ops)**
+
+Multiple `.find()` calls by the same key should use a Map.
+
+**Incorrect (O(n) per lookup):**
+
+```typescript
+function processOrders(orders: Order[], users: User[]) {
+  return orders.map(order => ({
+    ...order,
+    user: users.find(u => u.id === order.userId)
+  }))
+}
+```
+
+**Correct (O(1) per lookup):**
+
+```typescript
+function processOrders(orders: Order[], users: User[]) {
+  const userById = new Map(users.map(u => [u.id, u]))
+
+  return orders.map(order => ({
+    ...order,
+    user: userById.get(order.userId)
+  }))
+}
+```
+
+Build map once (O(n)), then all lookups are O(1).
+
+For 1000 orders × 1000 users: 1M ops → 2K ops.
+
+### 7.3 Cache Property Access in Loops
+
+**Impact: LOW-MEDIUM (reduces lookups)**
+
+Cache object property lookups in hot paths.
+
+**Incorrect: 3 lookups × N iterations**
+
+```typescript
+for (let i = 0; i < arr.length; i++) {
+  process(obj.config.settings.value)
+}
+```
+
+**Correct: 1 lookup total**
+
+```typescript
+const value = obj.config.settings.value
+const len = arr.length
+for (let i = 0; i < len; i++) {
+  process(value)
+}
+```
+
+### 7.4 Cache Repeated Function Calls
+
+**Impact: MEDIUM (avoid redundant computation)**
+
+Use a module-level Map to cache function results when the same function is called repeatedly with the same inputs during render.
+
+**Incorrect: redundant computation**
+
+```typescript
+function ProjectList({ projects }: { projects: Project[] }) {
+  return (
+    <div>
+      {projects.map(project => {
+        // slugify() called 100+ times for same project names
+        const slug = slugify(project.name)
+        
+        return <ProjectCard key={project.id} slug={slug} />
+      })}
+    </div>
+  )
+}
+```
+
+**Correct: cached results**
+
+```typescript
+// Module-level cache
+const slugifyCache = new Map<string, string>()
+
+function cachedSlugify(text: string): string {
+  if (slugifyCache.has(text)) {
+    return slugifyCache.get(text)!
+  }
+  const result = slugify(text)
+  slugifyCache.set(text, result)
+  return result
+}
+
+function ProjectList({ projects }: { projects: Project[] }) {
+  return (
+    <div>
+      {projects.map(project => {
+        // Computed only once per unique project name
+        const slug = cachedSlugify(project.name)
+        
+        return <ProjectCard key={project.id} slug={slug} />
+      })}
+    </div>
+  )
+}
+```
+
+**Simpler pattern for single-value functions:**
+
+```typescript
+let isLoggedInCache: boolean | null = null
+
+function isLoggedIn(): boolean {
+  if (isLoggedInCache !== null) {
+    return isLoggedInCache
+  }
+  
+  isLoggedInCache = document.cookie.includes('auth=')
+  return isLoggedInCache
+}
+
+// Clear cache when auth changes
+function onAuthChange() {
+  isLoggedInCache = null
+}
+```
+
+Use a Map (not a hook) so it works everywhere: utilities, event handlers, not just React components.
+
+Reference: [https://vercel.com/blog/how-we-made-the-vercel-dashboard-twice-as-fast](https://vercel.com/blog/how-we-made-the-vercel-dashboard-twice-as-fast)
+
+### 7.5 Cache Storage API Calls
+
+**Impact: LOW-MEDIUM (reduces expensive I/O)**
+
+`localStorage`, `sessionStorage`, and `document.cookie` are synchronous and expensive. Cache reads in memory.
+
+**Incorrect: reads storage on every call**
+
+```typescript
+function getTheme() {
+  return localStorage.getItem('theme') ?? 'light'
+}
+// Called 10 times = 10 storage reads
+```
+
+**Correct: Map cache**
+
+```typescript
+const storageCache = new Map<string, string | null>()
+
+function getLocalStorage(key: string) {
+  if (!storageCache.has(key)) {
+    storageCache.set(key, localStorage.getItem(key))
+  }
+  return storageCache.get(key)
+}
+
+function setLocalStorage(key: string, value: string) {
+  localStorage.setItem(key, value)
+  storageCache.set(key, value)  // keep cache in sync
+}
+```
+
+Use a Map (not a hook) so it works everywhere: utilities, event handlers, not just React components.
+
+**Cookie caching:**
+
+```typescript
+let cookieCache: Record<string, string> | null = null
+
+function getCookie(name: string) {
+  if (!cookieCache) {
+    cookieCache = Object.fromEntries(
+      document.cookie.split('; ').map(c => c.split('='))
+    )
+  }
+  return cookieCache[name]
+}
+```
+
+**Important: invalidate on external changes**
+
+```typescript
+window.addEventListener('storage', (e) => {
+  if (e.key) storageCache.delete(e.key)
+})
+
+document.addEventListener('visibilitychange', () => {
+  if (document.visibilityState === 'visible') {
+    storageCache.clear()
+  }
+})
+```
+
+If storage can change externally (another tab, server-set cookies), invalidate cache:
+
+### 7.6 Combine Multiple Array Iterations
+
+**Impact: LOW-MEDIUM (reduces iterations)**
+
+Multiple `.filter()` or `.map()` calls iterate the array multiple times. Combine into one loop.
+
+**Incorrect: 3 iterations**
+
+```typescript
+const admins = users.filter(u => u.isAdmin)
+const testers = users.filter(u => u.isTester)
+const inactive = users.filter(u => !u.isActive)
+```
+
+**Correct: 1 iteration**
+
+```typescript
+const admins: User[] = []
+const testers: User[] = []
+const inactive: User[] = []
+
+for (const user of users) {
+  if (user.isAdmin) admins.push(user)
+  if (user.isTester) testers.push(user)
+  if (!user.isActive) inactive.push(user)
+}
+```
+
+### 7.7 Early Length Check for Array Comparisons
+
+**Impact: MEDIUM-HIGH (avoids expensive operations when lengths differ)**
+
+When comparing arrays with expensive operations (sorting, deep equality, serialization), check lengths first. If lengths differ, the arrays cannot be equal.
+
+In real-world applications, this optimization is especially valuable when the comparison runs in hot paths (event handlers, render loops).
+
+**Incorrect: always runs expensive comparison**
+
+```typescript
+function hasChanges(current: string[], original: string[]) {
+  // Always sorts and joins, even when lengths differ
+  return current.sort().join() !== original.sort().join()
+}
+```
+
+Two O(n log n) sorts run even when `current.length` is 5 and `original.length` is 100. There is also overhead of joining the arrays and comparing the strings.
+
+**Correct (O(1) length check first):**
+
+```typescript
+function hasChanges(current: string[], original: string[]) {
+  // Early return if lengths differ
+  if (current.length !== original.length) {
+    return true
+  }
+  // Only sort/join when lengths match
+  const currentSorted = current.toSorted()
+  const originalSorted = original.toSorted()
+  for (let i = 0; i < currentSorted.length; i++) {
+    if (currentSorted[i] !== originalSorted[i]) {
+      return true
+    }
+  }
+  return false
+}
+```
+
+This new approach is more efficient because:
+
+- It avoids the overhead of sorting and joining the arrays when lengths differ
+
+- It avoids consuming memory for the joined strings (especially important for large arrays)
+
+- It avoids mutating the original arrays
+
+- It returns early when a difference is found
+
+### 7.8 Early Return from Functions
+
+**Impact: LOW-MEDIUM (avoids unnecessary computation)**
+
+Return early when result is determined to skip unnecessary processing.
+
+**Incorrect: processes all items even after finding answer**
+
+```typescript
+function validateUsers(users: User[]) {
+  let hasError = false
+  let errorMessage = ''
+  
+  for (const user of users) {
+    if (!user.email) {
+      hasError = true
+      errorMessage = 'Email required'
+    }
+    if (!user.name) {
+      hasError = true
+      errorMessage = 'Name required'
+    }
+    // Continues checking all users even after error found
+  }
+  
+  return hasError ? { valid: false, error: errorMessage } : { valid: true }
+}
+```
+
+**Correct: returns immediately on first error**
+
+```typescript
+function validateUsers(users: User[]) {
+  for (const user of users) {
+    if (!user.email) {
+      return { valid: false, error: 'Email required' }
+    }
+    if (!user.name) {
+      return { valid: false, error: 'Name required' }
+    }
+  }
+
+  return { valid: true }
+}
+```
+
+### 7.9 Hoist RegExp Creation
+
+**Impact: LOW-MEDIUM (avoids recreation)**
+
+Don't create RegExp inside render. Hoist to module scope or memoize with `useMemo()`.
+
+**Incorrect: new RegExp every render**
+
+```tsx
+function Highlighter({ text, query }: Props) {
+  const regex = new RegExp(`(${query})`, 'gi')
+  const parts = text.split(regex)
+  return <>{parts.map((part, i) => ...)}</>
+}
+```
+
+**Correct: memoize or hoist**
+
+```tsx
+const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/
+
+function Highlighter({ text, query }: Props) {
+  const regex = useMemo(
+    () => new RegExp(`(${escapeRegex(query)})`, 'gi'),
+    [query]
+  )
+  const parts = text.split(regex)
+  return <>{parts.map((part, i) => ...)}</>
+}
+```
+
+**Warning: global regex has mutable state**
+
+```typescript
+const regex = /foo/g
+regex.test('foo')  // true, lastIndex = 3
+regex.test('foo')  // false, lastIndex = 0
+```
+
+Global regex (`/g`) has mutable `lastIndex` state:
+
+### 7.10 Use Loop for Min/Max Instead of Sort
+
+**Impact: LOW (O(n) instead of O(n log n))**
+
+Finding the smallest or largest element only requires a single pass through the array. Sorting is wasteful and slower.
+
+**Incorrect (O(n log n) - sort to find latest):**
+
+```typescript
+interface Project {
+  id: string
+  name: string
+  updatedAt: number
+}
+
+function getLatestProject(projects: Project[]) {
+  const sorted = [...projects].sort((a, b) => b.updatedAt - a.updatedAt)
+  return sorted[0]
+}
+```
+
+Sorts the entire array just to find the maximum value.
+
+**Incorrect (O(n log n) - sort for oldest and newest):**
+
+```typescript
+function getOldestAndNewest(projects: Project[]) {
+  const sorted = [...projects].sort((a, b) => a.updatedAt - b.updatedAt)
+  return { oldest: sorted[0], newest: sorted[sorted.length - 1] }
+}
+```
+
+Still sorts unnecessarily when only min/max are needed.
+
+**Correct (O(n) - single loop):**
+
+```typescript
+function getLatestProject(projects: Project[]) {
+  if (projects.length === 0) return null
+  
+  let latest = projects[0]
+  
+  for (let i = 1; i < projects.length; i++) {
+    if (projects[i].updatedAt > latest.updatedAt) {
+      latest = projects[i]
+    }
+  }
+  
+  return latest
+}
+
+function getOldestAndNewest(projects: Project[]) {
+  if (projects.length === 0) return { oldest: null, newest: null }
+  
+  let oldest = projects[0]
+  let newest = projects[0]
+  
+  for (let i = 1; i < projects.length; i++) {
+    if (projects[i].updatedAt < oldest.updatedAt) oldest = projects[i]
+    if (projects[i].updatedAt > newest.updatedAt) newest = projects[i]
+  }
+  
+  return { oldest, newest }
+}
+```
+
+Single pass through the array, no copying, no sorting.
+
+**Alternative: Math.min/Math.max for small arrays**
+
+```typescript
+const numbers = [5, 2, 8, 1, 9]
+const min = Math.min(...numbers)
+const max = Math.max(...numbers)
+```
+
+This works for small arrays but can be slower for very large arrays due to spread operator limitations. Use the loop approach for reliability.
+
+### 7.11 Use Set/Map for O(1) Lookups
+
+**Impact: LOW-MEDIUM (O(n) to O(1))**
+
+Convert arrays to Set/Map for repeated membership checks.
+
+**Incorrect (O(n) per check):**
+
+```typescript
+const allowedIds = ['a', 'b', 'c', ...]
+items.filter(item => allowedIds.includes(item.id))
+```
+
+**Correct (O(1) per check):**
+
+```typescript
+const allowedIds = new Set(['a', 'b', 'c', ...])
+items.filter(item => allowedIds.has(item.id))
+```
+
+### 7.12 Use toSorted() Instead of sort() for Immutability
+
+**Impact: MEDIUM-HIGH (prevents mutation bugs in React state)**
+
+`.sort()` mutates the array in place, which can cause bugs with React state and props. Use `.toSorted()` to create a new sorted array without mutation.
+
+**Incorrect: mutates original array**
+
+```typescript
+function UserList({ users }: { users: User[] }) {
+  // Mutates the users prop array!
+  const sorted = useMemo(
+    () => users.sort((a, b) => a.name.localeCompare(b.name)),
+    [users]
+  )
+  return <div>{sorted.map(renderUser)}</div>
+}
+```
+
+**Correct: creates new array**
+
+```typescript
+function UserList({ users }: { users: User[] }) {
+  // Creates new sorted array, original unchanged
+  const sorted = useMemo(
+    () => users.toSorted((a, b) => a.name.localeCompare(b.name)),
+    [users]
+  )
+  return <div>{sorted.map(renderUser)}</div>
+}
+```
+
+**Why this matters in React:**
+
+1. Props/state mutations break React's immutability model - React expects props and state to be treated as read-only
+
+2. Causes stale closure bugs - Mutating arrays inside closures (callbacks, effects) can lead to unexpected behavior
+
+**Browser support: fallback for older browsers**
+
+```typescript
+// Fallback for older browsers
+const sorted = [...items].sort((a, b) => a.value - b.value)
+```
+
+`.toSorted()` is available in all modern browsers (Chrome 110+, Safari 16+, Firefox 115+, Node.js 20+). For older environments, use spread operator:
+
+**Other immutable array methods:**
+
+- `.toSorted()` - immutable sort
+
+- `.toReversed()` - immutable reverse
+
+- `.toSpliced()` - immutable splice
+
+- `.with()` - immutable element replacement
+
+---
+
+## 8. Advanced Patterns
+
+**Impact: LOW**
+
+Advanced patterns for specific cases that require careful implementation.
+
+### 8.1 Store Event Handlers in Refs
+
+**Impact: LOW (stable subscriptions)**
+
+Store callbacks in refs when used in effects that shouldn't re-subscribe on callback changes.
+
+**Incorrect: re-subscribes on every render**
+
+```tsx
+function useWindowEvent(event: string, handler: () => void) {
+  useEffect(() => {
+    window.addEventListener(event, handler)
+    return () => window.removeEventListener(event, handler)
+  }, [event, handler])
+}
+```
+
+**Correct: stable subscription**
+
+```tsx
+import { useEffectEvent } from 'react'
+
+function useWindowEvent(event: string, handler: () => void) {
+  const onEvent = useEffectEvent(handler)
+
+  useEffect(() => {
+    window.addEventListener(event, onEvent)
+    return () => window.removeEventListener(event, onEvent)
+  }, [event])
+}
+```
+
+**Alternative: use `useEffectEvent` if you're on latest React:**
+
+`useEffectEvent` provides a cleaner API for the same pattern: it creates a stable function reference that always calls the latest version of the handler.
+
+### 8.2 useLatest for Stable Callback Refs
+
+**Impact: LOW (prevents effect re-runs)**
+
+Access latest values in callbacks without adding them to dependency arrays. Prevents effect re-runs while avoiding stale closures.
+
+**Implementation:**
+
+```typescript
+function useLatest<T>(value: T) {
+  const ref = useRef(value)
+  useEffect(() => {
+    ref.current = value
+  }, [value])
+  return ref
+}
+```
+
+**Incorrect: effect re-runs on every callback change**
+
+```tsx
+function SearchInput({ onSearch }: { onSearch: (q: string) => void }) {
+  const [query, setQuery] = useState('')
+
+  useEffect(() => {
+    const timeout = setTimeout(() => onSearch(query), 300)
+    return () => clearTimeout(timeout)
+  }, [query, onSearch])
+}
+```
+
+**Correct: stable effect, fresh callback**
+
+```tsx
+function SearchInput({ onSearch }: { onSearch: (q: string) => void }) {
+  const [query, setQuery] = useState('')
+  const onSearchRef = useLatest(onSearch)
+
+  useEffect(() => {
+    const timeout = setTimeout(() => onSearchRef.current(query), 300)
+    return () => clearTimeout(timeout)
+  }, [query])
+}
+```
+
+---
+
+## References
+
+1. [https://react.dev](https://react.dev)
+2. [https://nextjs.org](https://nextjs.org)
+3. [https://swr.vercel.app](https://swr.vercel.app)
+4. [https://github.com/shuding/better-all](https://github.com/shuding/better-all)
+5. [https://github.com/isaacs/node-lru-cache](https://github.com/isaacs/node-lru-cache)
+6. [https://vercel.com/blog/how-we-optimized-package-imports-in-next-js](https://vercel.com/blog/how-we-optimized-package-imports-in-next-js)
+7. [https://vercel.com/blog/how-we-made-the-vercel-dashboard-twice-as-fast](https://vercel.com/blog/how-we-made-the-vercel-dashboard-twice-as-fast)
diff --git a/.claude/skills/vercel-react-best-practices/SKILL.md b/.claude/skills/vercel-react-best-practices/SKILL.md
new file mode 100644
index 0000000000..b064716f60
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/SKILL.md
@@ -0,0 +1,125 @@
+---
+name: vercel-react-best-practices
+description: React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.
+license: MIT
+metadata:
+  author: vercel
+  version: "1.0.0"
+---
+
+# Vercel React Best Practices
+
+Comprehensive performance optimization guide for React and Next.js applications, maintained by Vercel. Contains 45 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.
+
+## When to Apply
+
+Reference these guidelines when:
+- Writing new React components or Next.js pages
+- Implementing data fetching (client or server-side)
+- Reviewing code for performance issues
+- Refactoring existing React/Next.js code
+- Optimizing bundle size or load times
+
+## Rule Categories by Priority
+
+| Priority | Category | Impact | Prefix |
+|----------|----------|--------|--------|
+| 1 | Eliminating Waterfalls | CRITICAL | `async-` |
+| 2 | Bundle Size Optimization | CRITICAL | `bundle-` |
+| 3 | Server-Side Performance | HIGH | `server-` |
+| 4 | Client-Side Data Fetching | MEDIUM-HIGH | `client-` |
+| 5 | Re-render Optimization | MEDIUM | `rerender-` |
+| 6 | Rendering Performance | MEDIUM | `rendering-` |
+| 7 | JavaScript Performance | LOW-MEDIUM | `js-` |
+| 8 | Advanced Patterns | LOW | `advanced-` |
+
+## Quick Reference
+
+### 1. Eliminating Waterfalls (CRITICAL)
+
+- `async-defer-await` - Move await into branches where actually used
+- `async-parallel` - Use Promise.all() for independent operations
+- `async-dependencies` - Use better-all for partial dependencies
+- `async-api-routes` - Start promises early, await late in API routes
+- `async-suspense-boundaries` - Use Suspense to stream content
+
+### 2. Bundle Size Optimization (CRITICAL)
+
+- `bundle-barrel-imports` - Import directly, avoid barrel files
+- `bundle-dynamic-imports` - Use next/dynamic for heavy components
+- `bundle-defer-third-party` - Load analytics/logging after hydration
+- `bundle-conditional` - Load modules only when feature is activated
+- `bundle-preload` - Preload on hover/focus for perceived speed
+
+### 3. Server-Side Performance (HIGH)
+
+- `server-cache-react` - Use React.cache() for per-request deduplication
+- `server-cache-lru` - Use LRU cache for cross-request caching
+- `server-serialization` - Minimize data passed to client components
+- `server-parallel-fetching` - Restructure components to parallelize fetches
+- `server-after-nonblocking` - Use after() for non-blocking operations
+
+### 4. Client-Side Data Fetching (MEDIUM-HIGH)
+
+- `client-swr-dedup` - Use SWR for automatic request deduplication
+- `client-event-listeners` - Deduplicate global event listeners
+
+### 5. Re-render Optimization (MEDIUM)
+
+- `rerender-defer-reads` - Don't subscribe to state only used in callbacks
+- `rerender-memo` - Extract expensive work into memoized components
+- `rerender-dependencies` - Use primitive dependencies in effects
+- `rerender-derived-state` - Subscribe to derived booleans, not raw values
+- `rerender-functional-setstate` - Use functional setState for stable callbacks
+- `rerender-lazy-state-init` - Pass function to useState for expensive values
+- `rerender-transitions` - Use startTransition for non-urgent updates
+
+### 6. Rendering Performance (MEDIUM)
+
+- `rendering-animate-svg-wrapper` - Animate div wrapper, not SVG element
+- `rendering-content-visibility` - Use content-visibility for long lists
+- `rendering-hoist-jsx` - Extract static JSX outside components
+- `rendering-svg-precision` - Reduce SVG coordinate precision
+- `rendering-hydration-no-flicker` - Use inline script for client-only data
+- `rendering-activity` - Use Activity component for show/hide
+- `rendering-conditional-render` - Use ternary, not && for conditionals
+
+### 7. JavaScript Performance (LOW-MEDIUM)
+
+- `js-batch-dom-css` - Group CSS changes via classes or cssText
+- `js-index-maps` - Build Map for repeated lookups
+- `js-cache-property-access` - Cache object properties in loops
+- `js-cache-function-results` - Cache function results in module-level Map
+- `js-cache-storage` - Cache localStorage/sessionStorage reads
+- `js-combine-iterations` - Combine multiple filter/map into one loop
+- `js-length-check-first` - Check array length before expensive comparison
+- `js-early-exit` - Return early from functions
+- `js-hoist-regexp` - Hoist RegExp creation outside loops
+- `js-min-max-loop` - Use loop for min/max instead of sort
+- `js-set-map-lookups` - Use Set/Map for O(1) lookups
+- `js-tosorted-immutable` - Use toSorted() for immutability
+
+### 8. Advanced Patterns (LOW)
+
+- `advanced-event-handler-refs` - Store event handlers in refs
+- `advanced-use-latest` - useLatest for stable callback refs
+
+## How to Use
+
+Read individual rule files for detailed explanations and code examples:
+
+```
+rules/async-parallel.md
+rules/bundle-barrel-imports.md
+rules/_sections.md
+```
+
+Each rule file contains:
+- Brief explanation of why it matters
+- Incorrect code example with explanation
+- Correct code example with explanation
+- Additional context and references
+
+## Full Compiled Document
+
+For the complete guide with all rules expanded: `AGENTS.md`
diff --git a/.claude/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md b/.claude/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md
new file mode 100644
index 0000000000..3a45152057
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md
@@ -0,0 +1,55 @@
+---
+title: Store Event Handlers in Refs
+impact: LOW
+impactDescription: stable subscriptions
+tags: advanced, hooks, refs, event-handlers, optimization
+---
+
+## Store Event Handlers in Refs
+
+Store callbacks in refs when used in effects that shouldn't re-subscribe on callback changes.
+
+**Incorrect (re-subscribes on every render):**
+
+```tsx
+function useWindowEvent(event: string, handler: () => void) {
+  useEffect(() => {
+    window.addEventListener(event, handler)
+    return () => window.removeEventListener(event, handler)
+  }, [event, handler])
+}
+```
+
+**Correct (stable subscription):**
+
+```tsx
+function useWindowEvent(event: string, handler: () => void) {
+  const handlerRef = useRef(handler)
+  useEffect(() => {
+    handlerRef.current = handler
+  }, [handler])
+
+  useEffect(() => {
+    const listener = () => handlerRef.current()
+    window.addEventListener(event, listener)
+    return () => window.removeEventListener(event, listener)
+  }, [event])
+}
+```
+
+**Alternative: use `useEffectEvent` if you're on latest React:**
+
+```tsx
+import { useEffectEvent } from 'react'
+
+function useWindowEvent(event: string, handler: () => void) {
+  const onEvent = useEffectEvent(handler)
+
+  useEffect(() => {
+    window.addEventListener(event, onEvent)
+    return () => window.removeEventListener(event, onEvent)
+  }, [event])
+}
+```
+
+`useEffectEvent` provides a cleaner API for the same pattern: it creates a stable function reference that always calls the latest version of the handler.
diff --git a/.claude/skills/vercel-react-best-practices/rules/advanced-use-latest.md b/.claude/skills/vercel-react-best-practices/rules/advanced-use-latest.md
new file mode 100644
index 0000000000..3facdf2cca
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/advanced-use-latest.md
@@ -0,0 +1,49 @@
+---
+title: useLatest for Stable Callback Refs
+impact: LOW
+impactDescription: prevents effect re-runs
+tags: advanced, hooks, useLatest, refs, optimization
+---
+
+## useLatest for Stable Callback Refs
+
+Access latest values in callbacks without adding them to dependency arrays. Prevents effect re-runs while avoiding stale closures.
+
+**Implementation:**
+
+```typescript
+function useLatest<T>(value: T) {
+  const ref = useRef(value)
+  useEffect(() => {
+    ref.current = value
+  }, [value])
+  return ref
+}
+```
+
+**Incorrect (effect re-runs on every callback change):**
+
+```tsx
+function SearchInput({ onSearch }: { onSearch: (q: string) => void }) {
+  const [query, setQuery] = useState('')
+
+  useEffect(() => {
+    const timeout = setTimeout(() => onSearch(query), 300)
+    return () => clearTimeout(timeout)
+  }, [query, onSearch])
+}
+```
+
+**Correct (stable effect, fresh callback):**
+
+```tsx
+function SearchInput({ onSearch }: { onSearch: (q: string) => void }) {
+  const [query, setQuery] = useState('')
+  const onSearchRef = useLatest(onSearch)
+
+  useEffect(() => {
+    const timeout = setTimeout(() => onSearchRef.current(query), 300)
+    return () => clearTimeout(timeout)
+  }, [query])
+}
+```
diff --git a/.claude/skills/vercel-react-best-practices/rules/async-api-routes.md b/.claude/skills/vercel-react-best-practices/rules/async-api-routes.md
new file mode 100644
index 0000000000..6feda1ef0a
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/async-api-routes.md
@@ -0,0 +1,38 @@
+---
+title: Prevent Waterfall Chains in API Routes
+impact: CRITICAL
+impactDescription: 2-10× improvement
+tags: api-routes, server-actions, waterfalls, parallelization
+---
+
+## Prevent Waterfall Chains in API Routes
+
+In API routes and Server Actions, start independent operations immediately, even if you don't await them yet.
+
+**Incorrect (config waits for auth, data waits for both):**
+
+```typescript
+export async function GET(request: Request) {
+  const session = await auth()
+  const config = await fetchConfig()
+  const data = await fetchData(session.user.id)
+  return Response.json({ data, config })
+}
+```
+
+**Correct (auth and config start immediately):**
+
+```typescript
+export async function GET(request: Request) {
+  const sessionPromise = auth()
+  const configPromise = fetchConfig()
+  const session = await sessionPromise
+  const [config, data] = await Promise.all([
+    configPromise,
+    fetchData(session.user.id)
+  ])
+  return Response.json({ data, config })
+}
+```
+
+For operations with more complex dependency chains, use `better-all` to automatically maximize parallelism (see Dependency-Based Parallelization).
diff --git a/.claude/skills/vercel-react-best-practices/rules/async-defer-await.md b/.claude/skills/vercel-react-best-practices/rules/async-defer-await.md
new file mode 100644
index 0000000000..ea7082a362
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/async-defer-await.md
@@ -0,0 +1,80 @@
+---
+title: Defer Await Until Needed
+impact: HIGH
+impactDescription: avoids blocking unused code paths
+tags: async, await, conditional, optimization
+---
+
+## Defer Await Until Needed
+
+Move `await` operations into the branches where they're actually used to avoid blocking code paths that don't need them.
+
+**Incorrect (blocks both branches):**
+
+```typescript
+async function handleRequest(userId: string, skipProcessing: boolean) {
+  const userData = await fetchUserData(userId)
+  
+  if (skipProcessing) {
+    // Returns immediately but still waited for userData
+    return { skipped: true }
+  }
+  
+  // Only this branch uses userData
+  return processUserData(userData)
+}
+```
+
+**Correct (only blocks when needed):**
+
+```typescript
+async function handleRequest(userId: string, skipProcessing: boolean) {
+  if (skipProcessing) {
+    // Returns immediately without waiting
+    return { skipped: true }
+  }
+  
+  // Fetch only when needed
+  const userData = await fetchUserData(userId)
+  return processUserData(userData)
+}
+```
+
+**Another example (early return optimization):**
+
+```typescript
+// Incorrect: always fetches permissions
+async function updateResource(resourceId: string, userId: string) {
+  const permissions = await fetchPermissions(userId)
+  const resource = await getResource(resourceId)
+  
+  if (!resource) {
+    return { error: 'Not found' }
+  }
+  
+  if (!permissions.canEdit) {
+    return { error: 'Forbidden' }
+  }
+  
+  return await updateResourceData(resource, permissions)
+}
+
+// Correct: fetches only when needed
+async function updateResource(resourceId: string, userId: string) {
+  const resource = await getResource(resourceId)
+  
+  if (!resource) {
+    return { error: 'Not found' }
+  }
+  
+  const permissions = await fetchPermissions(userId)
+  
+  if (!permissions.canEdit) {
+    return { error: 'Forbidden' }
+  }
+  
+  return await updateResourceData(resource, permissions)
+}
+```
+
+This optimization is especially valuable when the skipped branch is frequently taken, or when the deferred operation is expensive.
diff --git a/.claude/skills/vercel-react-best-practices/rules/async-dependencies.md b/.claude/skills/vercel-react-best-practices/rules/async-dependencies.md
new file mode 100644
index 0000000000..fb90d861ac
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/async-dependencies.md
@@ -0,0 +1,36 @@
+---
+title: Dependency-Based Parallelization
+impact: CRITICAL
+impactDescription: 2-10× improvement
+tags: async, parallelization, dependencies, better-all
+---
+
+## Dependency-Based Parallelization
+
+For operations with partial dependencies, use `better-all` to maximize parallelism. It automatically starts each task at the earliest possible moment.
+
+**Incorrect (profile waits for config unnecessarily):**
+
+```typescript
+const [user, config] = await Promise.all([
+  fetchUser(),
+  fetchConfig()
+])
+const profile = await fetchProfile(user.id)
+```
+
+**Correct (config and profile run in parallel):**
+
+```typescript
+import { all } from 'better-all'
+
+const { user, config, profile } = await all({
+  async user() { return fetchUser() },
+  async config() { return fetchConfig() },
+  async profile() {
+    return fetchProfile((await this.$.user).id)
+  }
+})
+```
+
+Reference: [https://github.com/shuding/better-all](https://github.com/shuding/better-all)
diff --git a/.claude/skills/vercel-react-best-practices/rules/async-parallel.md b/.claude/skills/vercel-react-best-practices/rules/async-parallel.md
new file mode 100644
index 0000000000..64133f6c31
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/async-parallel.md
@@ -0,0 +1,28 @@
+---
+title: Promise.all() for Independent Operations
+impact: CRITICAL
+impactDescription: 2-10× improvement
+tags: async, parallelization, promises, waterfalls
+---
+
+## Promise.all() for Independent Operations
+
+When async operations have no interdependencies, execute them concurrently using `Promise.all()`.
+
+**Incorrect (sequential execution, 3 round trips):**
+
+```typescript
+const user = await fetchUser()
+const posts = await fetchPosts()
+const comments = await fetchComments()
+```
+
+**Correct (parallel execution, 1 round trip):**
+
+```typescript
+const [user, posts, comments] = await Promise.all([
+  fetchUser(),
+  fetchPosts(),
+  fetchComments()
+])
+```
diff --git a/.claude/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md b/.claude/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md
new file mode 100644
index 0000000000..1fbc05b04e
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md
@@ -0,0 +1,99 @@
+---
+title: Strategic Suspense Boundaries
+impact: HIGH
+impactDescription: faster initial paint
+tags: async, suspense, streaming, layout-shift
+---
+
+## Strategic Suspense Boundaries
+
+Instead of awaiting data in async components before returning JSX, use Suspense boundaries to show the wrapper UI faster while data loads.
+
+**Incorrect (wrapper blocked by data fetching):**
+
+```tsx
+async function Page() {
+  const data = await fetchData() // Blocks entire page
+  
+  return (
+    <div>
+      <div>Sidebar</div>
+      <div>Header</div>
+      <div>
+        <DataDisplay data={data} />
+      </div>
+      <div>Footer</div>
+    </div>
+  )
+}
+```
+
+The entire layout waits for data even though only the middle section needs it.
+
+**Correct (wrapper shows immediately, data streams in):**
+
+```tsx
+function Page() {
+  return (
+    <div>
+      <div>Sidebar</div>
+      <div>Header</div>
+      <div>
+        <Suspense fallback={<Skeleton />}>
+          <DataDisplay />
+        </Suspense>
+      </div>
+      <div>Footer</div>
+    </div>
+  )
+}
+
+async function DataDisplay() {
+  const data = await fetchData() // Only blocks this component
+  return <div>{data.content}</div>
+}
+```
+
+Sidebar, Header, and Footer render immediately. Only DataDisplay waits for data.
+
+**Alternative (share promise across components):**
+
+```tsx
+function Page() {
+  // Start fetch immediately, but don't await
+  const dataPromise = fetchData()
+  
+  return (
+    <div>
+      <div>Sidebar</div>
+      <div>Header</div>
+      <Suspense fallback={<Skeleton />}>
+        <DataDisplay dataPromise={dataPromise} />
+        <DataSummary dataPromise={dataPromise} />
+      </Suspense>
+      <div>Footer</div>
+    </div>
+  )
+}
+
+function DataDisplay({ dataPromise }: { dataPromise: Promise<Data> }) {
+  const data = use(dataPromise) // Unwraps the promise
+  return <div>{data.content}</div>
+}
+
+function DataSummary({ dataPromise }: { dataPromise: Promise<Data> }) {
+  const data = use(dataPromise) // Reuses the same promise
+  return <div>{data.summary}</div>
+}
+```
+
+Both components share the same promise, so only one fetch occurs. Layout renders immediately while both components wait together.
+
+**When NOT to use this pattern:**
+
+- Critical data needed for layout decisions (affects positioning)
+- SEO-critical content above the fold
+- Small, fast queries where suspense overhead isn't worth it
+- When you want to avoid layout shift (loading → content jump)
+
+**Trade-off:** Faster initial paint vs potential layout shift. Choose based on your UX priorities.
diff --git a/.claude/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md b/.claude/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md
new file mode 100644
index 0000000000..ee48f3273c
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md
@@ -0,0 +1,59 @@
+---
+title: Avoid Barrel File Imports
+impact: CRITICAL
+impactDescription: 200-800ms import cost, slow builds
+tags: bundle, imports, tree-shaking, barrel-files, performance
+---
+
+## Avoid Barrel File Imports
+
+Import directly from source files instead of barrel files to avoid loading thousands of unused modules. **Barrel files** are entry points that re-export multiple modules (e.g., `index.js` that does `export * from './module'`).
+
+Popular icon and component libraries can have **up to 10,000 re-exports** in their entry file. For many React packages, **it takes 200-800ms just to import them**, affecting both development speed and production cold starts.
+
+**Why tree-shaking doesn't help:** When a library is marked as external (not bundled), the bundler can't optimize it. If you bundle it to enable tree-shaking, builds become substantially slower analyzing the entire module graph.
+
+**Incorrect (imports entire library):**
+
+```tsx
+import { Check, X, Menu } from 'lucide-react'
+// Loads 1,583 modules, takes ~2.8s extra in dev
+// Runtime cost: 200-800ms on every cold start
+
+import { Button, TextField } from '@mui/material'
+// Loads 2,225 modules, takes ~4.2s extra in dev
+```
+
+**Correct (imports only what you need):**
+
+```tsx
+import Check from 'lucide-react/dist/esm/icons/check'
+import X from 'lucide-react/dist/esm/icons/x'
+import Menu from 'lucide-react/dist/esm/icons/menu'
+// Loads only 3 modules (~2KB vs ~1MB)
+
+import Button from '@mui/material/Button'
+import TextField from '@mui/material/TextField'
+// Loads only what you use
+```
+
+**Alternative (Next.js 13.5+):**
+
+```js
+// next.config.js - use optimizePackageImports
+module.exports = {
+  experimental: {
+    optimizePackageImports: ['lucide-react', '@mui/material']
+  }
+}
+
+// Then you can keep the ergonomic barrel imports:
+import { Check, X, Menu } from 'lucide-react'
+// Automatically transformed to direct imports at build time
+```
+
+Direct imports provide 15-70% faster dev boot, 28% faster builds, 40% faster cold starts, and significantly faster HMR.
+
+Libraries commonly affected: `lucide-react`, `@mui/material`, `@mui/icons-material`, `@tabler/icons-react`, `react-icons`, `@headlessui/react`, `@radix-ui/react-*`, `lodash`, `ramda`, `date-fns`, `rxjs`, `react-use`.
+
+Reference: [How we optimized package imports in Next.js](https://vercel.com/blog/how-we-optimized-package-imports-in-next-js)
diff --git a/.claude/skills/vercel-react-best-practices/rules/bundle-conditional.md b/.claude/skills/vercel-react-best-practices/rules/bundle-conditional.md
new file mode 100644
index 0000000000..40bd6f9826
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/bundle-conditional.md
@@ -0,0 +1,31 @@
+---
+title: Conditional Module Loading
+impact: HIGH
+impactDescription: loads large data only when needed
+tags: bundle, conditional-loading, lazy-loading
+---
+
+## Conditional Module Loading
+
+Load large data or modules only when a feature is activated.
+
+**Example (lazy-load animation frames):**
+
+```tsx
+function AnimationPlayer({ enabled }: { enabled: boolean }) {
+  const [frames, setFrames] = useState<Frame[] | null>(null)
+
+  useEffect(() => {
+    if (enabled && !frames && typeof window !== 'undefined') {
+      import('./animation-frames.js')
+        .then(mod => setFrames(mod.frames))
+        .catch(() => setEnabled(false))
+    }
+  }, [enabled, frames])
+
+  if (!frames) return <Skeleton />
+  return <Canvas frames={frames} />
+}
+```
+
+The `typeof window !== 'undefined'` check prevents bundling this module for SSR, optimizing server bundle size and build speed.
diff --git a/.claude/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md b/.claude/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md
new file mode 100644
index 0000000000..db041d1510
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md
@@ -0,0 +1,49 @@
+---
+title: Defer Non-Critical Third-Party Libraries
+impact: MEDIUM
+impactDescription: loads after hydration
+tags: bundle, third-party, analytics, defer
+---
+
+## Defer Non-Critical Third-Party Libraries
+
+Analytics, logging, and error tracking don't block user interaction. Load them after hydration.
+
+**Incorrect (blocks initial bundle):**
+
+```tsx
+import { Analytics } from '@vercel/analytics/react'
+
+export default function RootLayout({ children }) {
+  return (
+    <html>
+      <body>
+        {children}
+        <Analytics />
+      </body>
+    </html>
+  )
+}
+```
+
+**Correct (loads after hydration):**
+
+```tsx
+import dynamic from 'next/dynamic'
+
+const Analytics = dynamic(
+  () => import('@vercel/analytics/react').then(m => m.Analytics),
+  { ssr: false }
+)
+
+export default function RootLayout({ children }) {
+  return (
+    <html>
+      <body>
+        {children}
+        <Analytics />
+      </body>
+    </html>
+  )
+}
+```
diff --git a/.claude/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md b/.claude/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md
new file mode 100644
index 0000000000..60b62695e7
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md
@@ -0,0 +1,35 @@
+---
+title: Dynamic Imports for Heavy Components
+impact: CRITICAL
+impactDescription: directly affects TTI and LCP
+tags: bundle, dynamic-import, code-splitting, next-dynamic
+---
+
+## Dynamic Imports for Heavy Components
+
+Use `next/dynamic` to lazy-load large components not needed on initial render.
+
+**Incorrect (Monaco bundles with main chunk ~300KB):**
+
+```tsx
+import { MonacoEditor } from './monaco-editor'
+
+function CodePanel({ code }: { code: string }) {
+  return <MonacoEditor value={code} />
+}
+```
+
+**Correct (Monaco loads on demand):**
+
+```tsx
+import dynamic from 'next/dynamic'
+
+const MonacoEditor = dynamic(
+  () => import('./monaco-editor').then(m => m.MonacoEditor),
+  { ssr: false }
+)
+
+function CodePanel({ code }: { code: string }) {
+  return <MonacoEditor value={code} />
+}
+```
diff --git a/.claude/skills/vercel-react-best-practices/rules/bundle-preload.md b/.claude/skills/vercel-react-best-practices/rules/bundle-preload.md
new file mode 100644
index 0000000000..7000504065
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/bundle-preload.md
@@ -0,0 +1,50 @@
+---
+title: Preload Based on User Intent
+impact: MEDIUM
+impactDescription: reduces perceived latency
+tags: bundle, preload, user-intent, hover
+---
+
+## Preload Based on User Intent
+
+Preload heavy bundles before they're needed to reduce perceived latency.
+
+**Example (preload on hover/focus):**
+
+```tsx
+function EditorButton({ onClick }: { onClick: () => void }) {
+  const preload = () => {
+    if (typeof window !== 'undefined') {
+      void import('./monaco-editor')
+    }
+  }
+
+  return (
+    <button
+      onMouseEnter={preload}
+      onFocus={preload}
+      onClick={onClick}
+    >
+      Open Editor
+    </button>
+  )
+}
+```
+
+**Example (preload when feature flag is enabled):**
+
+```tsx
+function FlagsProvider({ children, flags }: Props) {
+  useEffect(() => {
+    if (flags.editorEnabled && typeof window !== 'undefined') {
+      void import('./monaco-editor').then(mod => mod.init())
+    }
+  }, [flags.editorEnabled])
+
+  return <FlagsContext.Provider value={flags}>
+    {children}
+  </FlagsContext.Provider>
+}
+```
+
+The `typeof window !== 'undefined'` check prevents bundling preloaded modules for SSR, optimizing server bundle size and build speed.
diff --git a/.claude/skills/vercel-react-best-practices/rules/client-event-listeners.md b/.claude/skills/vercel-react-best-practices/rules/client-event-listeners.md
new file mode 100644
index 0000000000..aad4ae9160
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/client-event-listeners.md
@@ -0,0 +1,74 @@
+---
+title: Deduplicate Global Event Listeners
+impact: LOW
+impactDescription: single listener for N components
+tags: client, swr, event-listeners, subscription
+---
+
+## Deduplicate Global Event Listeners
+
+Use `useSWRSubscription()` to share global event listeners across component instances.
+
+**Incorrect (N instances = N listeners):**
+
+```tsx
+function useKeyboardShortcut(key: string, callback: () => void) {
+  useEffect(() => {
+    const handler = (e: KeyboardEvent) => {
+      if (e.metaKey && e.key === key) {
+        callback()
+      }
+    }
+    window.addEventListener('keydown', handler)
+    return () => window.removeEventListener('keydown', handler)
+  }, [key, callback])
+}
+```
+
+When using the `useKeyboardShortcut` hook multiple times, each instance will register a new listener.
+
+**Correct (N instances = 1 listener):**
+
+```tsx
+import useSWRSubscription from 'swr/subscription'
+
+// Module-level Map to track callbacks per key
+const keyCallbacks = new Map<string, Set<() => void>>()
+
+function useKeyboardShortcut(key: string, callback: () => void) {
+  // Register this callback in the Map
+  useEffect(() => {
+    if (!keyCallbacks.has(key)) {
+      keyCallbacks.set(key, new Set())
+    }
+    keyCallbacks.get(key)!.add(callback)
+
+    return () => {
+      const set = keyCallbacks.get(key)
+      if (set) {
+        set.delete(callback)
+        if (set.size === 0) {
+          keyCallbacks.delete(key)
+        }
+      }
+    }
+  }, [key, callback])
+
+  useSWRSubscription('global-keydown', () => {
+    const handler = (e: KeyboardEvent) => {
+      if (e.metaKey && keyCallbacks.has(e.key)) {
+        keyCallbacks.get(e.key)!.forEach(cb => cb())
+      }
+    }
+    window.addEventListener('keydown', handler)
+    return () => window.removeEventListener('keydown', handler)
+  })
+}
+
+function Profile() {
+  // Multiple shortcuts will share the same listener
+  useKeyboardShortcut('p', () => { /* ... */ }) 
+  useKeyboardShortcut('k', () => { /* ... */ })
+  // ...
+}
+```
diff --git a/.claude/skills/vercel-react-best-practices/rules/client-swr-dedup.md b/.claude/skills/vercel-react-best-practices/rules/client-swr-dedup.md
new file mode 100644
index 0000000000..2a430f27fd
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/client-swr-dedup.md
@@ -0,0 +1,56 @@
+---
+title: Use SWR for Automatic Deduplication
+impact: MEDIUM-HIGH
+impactDescription: automatic deduplication
+tags: client, swr, deduplication, data-fetching
+---
+
+## Use SWR for Automatic Deduplication
+
+SWR enables request deduplication, caching, and revalidation across component instances.
+
+**Incorrect (no deduplication, each instance fetches):**
+
+```tsx
+function UserList() {
+  const [users, setUsers] = useState([])
+  useEffect(() => {
+    fetch('/api/users')
+      .then(r => r.json())
+      .then(setUsers)
+  }, [])
+}
+```
+
+**Correct (multiple instances share one request):**
+
+```tsx
+import useSWR from 'swr'
+
+function UserList() {
+  const { data: users } = useSWR('/api/users', fetcher)
+}
+```
+
+**For immutable data:**
+
+```tsx
+import { useImmutableSWR } from '@/lib/swr'
+
+function StaticContent() {
+  const { data } = useImmutableSWR('/api/config', fetcher)
+}
+```
+
+**For mutations:**
+
+```tsx
+import { useSWRMutation } from 'swr/mutation'
+
+function UpdateButton() {
+  const { trigger } = useSWRMutation('/api/user', updateUser)
+  return <button onClick={() => trigger()}>Update</button>
+}
+```
+
+Reference: [https://swr.vercel.app](https://swr.vercel.app)
diff --git a/.claude/skills/vercel-react-best-practices/rules/js-batch-dom-css.md b/.claude/skills/vercel-react-best-practices/rules/js-batch-dom-css.md
new file mode 100644
index 0000000000..92a3b639b9
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/js-batch-dom-css.md
@@ -0,0 +1,82 @@
+---
+title: Batch DOM CSS Changes
+impact: MEDIUM
+impactDescription: reduces reflows/repaints
+tags: javascript, dom, css, performance, reflow
+---
+
+## Batch DOM CSS Changes
+
+Avoid changing styles one property at a time. Group multiple CSS changes together via classes or `cssText` to minimize browser reflows.
+
+**Incorrect (multiple reflows):**
+
+```typescript
+function updateElementStyles(element: HTMLElement) {
+  // Each line triggers a reflow
+  element.style.width = '100px'
+  element.style.height = '200px'
+  element.style.backgroundColor = 'blue'
+  element.style.border = '1px solid black'
+}
+```
+
+**Correct (add class - single reflow):**
+
+```typescript
+// CSS file
+.highlighted-box {
+  width: 100px;
+  height: 200px;
+  background-color: blue;
+  border: 1px solid black;
+}
+
+// JavaScript
+function updateElementStyles(element: HTMLElement) {
+  element.classList.add('highlighted-box')
+}
+```
+
+**Correct (change cssText - single reflow):**
+
+```typescript
+function updateElementStyles(element: HTMLElement) {
+  element.style.cssText = `
+    width: 100px;
+    height: 200px;
+    background-color: blue;
+    border: 1px solid black;
+  `
+}
+```
+
+**React example:**
+
+```tsx
+// Incorrect: changing styles one by one
+function Box({ isHighlighted }: { isHighlighted: boolean }) {
+  const ref = useRef<HTMLDivElement>(null)
+  
+  useEffect(() => {
+    if (ref.current && isHighlighted) {
+      ref.current.style.width = '100px'
+      ref.current.style.height = '200px'
+      ref.current.style.backgroundColor = 'blue'
+    }
+  }, [isHighlighted])
+  
+  return <div ref={ref}>Content</div>
+}
+
+// Correct: toggle class
+function Box({ isHighlighted }: { isHighlighted: boolean }) {
+  return (
+    <div className={isHighlighted ? 'highlighted-box' : ''}>
+      Content
+    </div>
+  )
+}
+```
+
+Prefer CSS classes over inline styles when possible. Classes are cached by the browser and provide better separation of concerns.
diff --git a/.claude/skills/vercel-react-best-practices/rules/js-cache-function-results.md b/.claude/skills/vercel-react-best-practices/rules/js-cache-function-results.md
new file mode 100644
index 0000000000..180f8ac8ff
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/js-cache-function-results.md
@@ -0,0 +1,80 @@
+---
+title: Cache Repeated Function Calls
+impact: MEDIUM
+impactDescription: avoid redundant computation
+tags: javascript, cache, memoization, performance
+---
+
+## Cache Repeated Function Calls
+
+Use a module-level Map to cache function results when the same function is called repeatedly with the same inputs during render.
+
+**Incorrect (redundant computation):**
+
+```typescript
+function ProjectList({ projects }: { projects: Project[] }) {
+  return (
+    <div>
+      {projects.map(project => {
+        // slugify() called 100+ times for same project names
+        const slug = slugify(project.name)
+        
+        return <ProjectCard key={project.id} slug={slug} />
+      })}
+    </div>
+  )
+}
+```
+
+**Correct (cached results):**
+
+```typescript
+// Module-level cache
+const slugifyCache = new Map<string, string>()
+
+function cachedSlugify(text: string): string {
+  if (slugifyCache.has(text)) {
+    return slugifyCache.get(text)!
+  }
+  const result = slugify(text)
+  slugifyCache.set(text, result)
+  return result
+}
+
+function ProjectList({ projects }: { projects: Project[] }) {
+  return (
+    <div>
+      {projects.map(project => {
+        // Computed only once per unique project name
+        const slug = cachedSlugify(project.name)
+        
+        return <ProjectCard key={project.id} slug={slug} />
+      })}
+    </div>
+  )
+}
+```
+
+**Simpler pattern for single-value functions:**
+
+```typescript
+let isLoggedInCache: boolean | null = null
+
+function isLoggedIn(): boolean {
+  if (isLoggedInCache !== null) {
+    return isLoggedInCache
+  }
+  
+  isLoggedInCache = document.cookie.includes('auth=')
+  return isLoggedInCache
+}
+
+// Clear cache when auth changes
+function onAuthChange() {
+  isLoggedInCache = null
+}
+```
+
+Use a Map (not a hook) so it works everywhere: utilities, event handlers, not just React components.
+
+Reference: [How we made the Vercel Dashboard twice as fast](https://vercel.com/blog/how-we-made-the-vercel-dashboard-twice-as-fast)
diff --git a/.claude/skills/vercel-react-best-practices/rules/js-cache-property-access.md b/.claude/skills/vercel-react-best-practices/rules/js-cache-property-access.md
new file mode 100644
index 0000000000..39eec9061b
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/js-cache-property-access.md
@@ -0,0 +1,28 @@
+---
+title: Cache Property Access in Loops
+impact: LOW-MEDIUM
+impactDescription: reduces lookups
+tags: javascript, loops, optimization, caching
+---
+
+## Cache Property Access in Loops
+
+Cache object property lookups in hot paths.
+
+**Incorrect (3 lookups × N iterations):**
+
+```typescript
+for (let i = 0; i < arr.length; i++) {
+  process(obj.config.settings.value)
+}
+```
+
+**Correct (1 lookup total):**
+
+```typescript
+const value = obj.config.settings.value
+const len = arr.length
+for (let i = 0; i < len; i++) {
+  process(value)
+}
+```
diff --git a/.claude/skills/vercel-react-best-practices/rules/js-cache-storage.md b/.claude/skills/vercel-react-best-practices/rules/js-cache-storage.md
new file mode 100644
index 0000000000..aa4a30c081
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/js-cache-storage.md
@@ -0,0 +1,70 @@
+---
+title: Cache Storage API Calls
+impact: LOW-MEDIUM
+impactDescription: reduces expensive I/O
+tags: javascript, localStorage, storage, caching, performance
+---
+
+## Cache Storage API Calls
+
+`localStorage`, `sessionStorage`, and `document.cookie` are synchronous and expensive. Cache reads in memory.
+
+**Incorrect (reads storage on every call):**
+
+```typescript
+function getTheme() {
+  return localStorage.getItem('theme') ?? 'light'
+}
+// Called 10 times = 10 storage reads
+```
+
+**Correct (Map cache):**
+
+```typescript
+const storageCache = new Map<string, string | null>()
+
+function getLocalStorage(key: string) {
+  if (!storageCache.has(key)) {
+    storageCache.set(key, localStorage.getItem(key))
+  }
+  return storageCache.get(key)
+}
+
+function setLocalStorage(key: string, value: string) {
+  localStorage.setItem(key, value)
+  storageCache.set(key, value)  // keep cache in sync
+}
+```
+
+Use a Map (not a hook) so it works everywhere: utilities, event handlers, not just React components.
+
+**Cookie caching:**
+
+```typescript
+let cookieCache: Record<string, string> | null = null
+
+function getCookie(name: string) {
+  if (!cookieCache) {
+    cookieCache = Object.fromEntries(
+      document.cookie.split('; ').map(c => c.split('='))
+    )
+  }
+  return cookieCache[name]
+}
+```
+
+**Important (invalidate on external changes):**
+
+If storage can change externally (another tab, server-set cookies), invalidate cache:
+
+```typescript
+window.addEventListener('storage', (e) => {
+  if (e.key) storageCache.delete(e.key)
+})
+
+document.addEventListener('visibilitychange', () => {
+  if (document.visibilityState === 'visible') {
+    storageCache.clear()
+  }
+})
+```
diff --git a/.claude/skills/vercel-react-best-practices/rules/js-combine-iterations.md b/.claude/skills/vercel-react-best-practices/rules/js-combine-iterations.md
new file mode 100644
index 0000000000..044d017ec3
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/js-combine-iterations.md
@@ -0,0 +1,32 @@
+---
+title: Combine Multiple Array Iterations
+impact: LOW-MEDIUM
+impactDescription: reduces iterations
+tags: javascript, arrays, loops, performance
+---
+
+## Combine Multiple Array Iterations
+
+Multiple `.filter()` or `.map()` calls iterate the array multiple times. Combine into one loop.
+
+**Incorrect (3 iterations):**
+
+```typescript
+const admins = users.filter(u => u.isAdmin)
+const testers = users.filter(u => u.isTester)
+const inactive = users.filter(u => !u.isActive)
+```
+
+**Correct (1 iteration):**
+
+```typescript
+const admins: User[] = []
+const testers: User[] = []
+const inactive: User[] = []
+
+for (const user of users) {
+  if (user.isAdmin) admins.push(user)
+  if (user.isTester) testers.push(user)
+  if (!user.isActive) inactive.push(user)
+}
+```
diff --git a/.claude/skills/vercel-react-best-practices/rules/js-early-exit.md b/.claude/skills/vercel-react-best-practices/rules/js-early-exit.md
new file mode 100644
index 0000000000..f46cb89c6c
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/js-early-exit.md
@@ -0,0 +1,50 @@
+---
+title: Early Return from Functions
+impact: LOW-MEDIUM
+impactDescription: avoids unnecessary computation
+tags: javascript, functions, optimization, early-return
+---
+
+## Early Return from Functions
+
+Return early when result is determined to skip unnecessary processing.
+
+**Incorrect (processes all items even after finding answer):**
+
+```typescript
+function validateUsers(users: User[]) {
+  let hasError = false
+  let errorMessage = ''
+  
+  for (const user of users) {
+    if (!user.email) {
+      hasError = true
+      errorMessage = 'Email required'
+    }
+    if (!user.name) {
+      hasError = true
+      errorMessage = 'Name required'
+    }
+    // Continues checking all users even after error found
+  }
+  
+  return hasError ? { valid: false, error: errorMessage } : { valid: true }
+}
+```
+
+**Correct (returns immediately on first error):**
+
+```typescript
+function validateUsers(users: User[]) {
+  for (const user of users) {
+    if (!user.email) {
+      return { valid: false, error: 'Email required' }
+    }
+    if (!user.name) {
+      return { valid: false, error: 'Name required' }
+    }
+  }
+
+  return { valid: true }
+}
+```
diff --git a/.claude/skills/vercel-react-best-practices/rules/js-hoist-regexp.md b/.claude/skills/vercel-react-best-practices/rules/js-hoist-regexp.md
new file mode 100644
index 0000000000..dae3fefdc0
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/js-hoist-regexp.md
@@ -0,0 +1,45 @@
+---
+title: Hoist RegExp Creation
+impact: LOW-MEDIUM
+impactDescription: avoids recreation
+tags: javascript, regexp, optimization, memoization
+---
+
+## Hoist RegExp Creation
+
+Don't create RegExp inside render. Hoist to module scope or memoize with `useMemo()`.
+
+**Incorrect (new RegExp every render):**
+
+```tsx
+function Highlighter({ text, query }: Props) {
+  const regex = new RegExp(`(${query})`, 'gi')
+  const parts = text.split(regex)
+  return <>{parts.map((part, i) => ...)}</>
+}
+```
+
+**Correct (memoize or hoist):**
+
+```tsx
+const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/
+
+function Highlighter({ text, query }: Props) {
+  const regex = useMemo(
+    () => new RegExp(`(${escapeRegex(query)})`, 'gi'),
+    [query]
+  )
+  const parts = text.split(regex)
+  return <>{parts.map((part, i) => ...)}</>
+}
+```
+
+**Warning (global regex has mutable state):**
+
+Global regex (`/g`) has mutable `lastIndex` state:
+
+```typescript
+const regex = /foo/g
+regex.test('foo')  // true, lastIndex = 3
+regex.test('foo')  // false, lastIndex = 0
+```
diff --git a/.claude/skills/vercel-react-best-practices/rules/js-index-maps.md b/.claude/skills/vercel-react-best-practices/rules/js-index-maps.md
new file mode 100644
index 0000000000..9d357a00b1
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/js-index-maps.md
@@ -0,0 +1,37 @@
+---
+title: Build Index Maps for Repeated Lookups
+impact: LOW-MEDIUM
+impactDescription: 1M ops to 2K ops
+tags: javascript, map, indexing, optimization, performance
+---
+
+## Build Index Maps for Repeated Lookups
+
+Multiple `.find()` calls by the same key should use a Map.
+
+**Incorrect (O(n) per lookup):**
+
+```typescript
+function processOrders(orders: Order[], users: User[]) {
+  return orders.map(order => ({
+    ...order,
+    user: users.find(u => u.id === order.userId)
+  }))
+}
+```
+
+**Correct (O(1) per lookup):**
+
+```typescript
+function processOrders(orders: Order[], users: User[]) {
+  const userById = new Map(users.map(u => [u.id, u]))
+
+  return orders.map(order => ({
+    ...order,
+    user: userById.get(order.userId)
+  }))
+}
+```
+
+Build map once (O(n)), then all lookups are O(1).
+For 1000 orders × 1000 users: 1M ops → 2K ops.
diff --git a/.claude/skills/vercel-react-best-practices/rules/js-length-check-first.md b/.claude/skills/vercel-react-best-practices/rules/js-length-check-first.md
new file mode 100644
index 0000000000..6c38625f98
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/js-length-check-first.md
@@ -0,0 +1,49 @@
+---
+title: Early Length Check for Array Comparisons
+impact: MEDIUM-HIGH
+impactDescription: avoids expensive operations when lengths differ
+tags: javascript, arrays, performance, optimization, comparison
+---
+
+## Early Length Check for Array Comparisons
+
+When comparing arrays with expensive operations (sorting, deep equality, serialization), check lengths first. If lengths differ, the arrays cannot be equal.
+
+In real-world applications, this optimization is especially valuable when the comparison runs in hot paths (event handlers, render loops).
+
+**Incorrect (always runs expensive comparison):**
+
+```typescript
+function hasChanges(current: string[], original: string[]) {
+  // Always sorts and joins, even when lengths differ
+  return current.sort().join() !== original.sort().join()
+}
+```
+
+Two O(n log n) sorts run even when `current.length` is 5 and `original.length` is 100. There is also overhead of joining the arrays and comparing the strings.
+
+**Correct (O(1) length check first):**
+
+```typescript
+function hasChanges(current: string[], original: string[]) {
+  // Early return if lengths differ
+  if (current.length !== original.length) {
+    return true
+  }
+  // Only sort/join when lengths match
+  const currentSorted = current.toSorted()
+  const originalSorted = original.toSorted()
+  for (let i = 0; i < currentSorted.length; i++) {
+    if (currentSorted[i] !== originalSorted[i]) {
+      return true
+    }
+  }
+  return false
+}
+```
+
+This new approach is more efficient because:
+- It avoids the overhead of sorting and joining the arrays when lengths differ
+- It avoids consuming memory for the joined strings (especially important for large arrays)
+- It avoids mutating the original arrays
+- It returns early when a difference is found
diff --git a/.claude/skills/vercel-react-best-practices/rules/js-min-max-loop.md b/.claude/skills/vercel-react-best-practices/rules/js-min-max-loop.md
new file mode 100644
index 0000000000..02caec56a5
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/js-min-max-loop.md
@@ -0,0 +1,82 @@
+---
+title: Use Loop for Min/Max Instead of Sort
+impact: LOW
+impactDescription: O(n) instead of O(n log n)
+tags: javascript, arrays, performance, sorting, algorithms
+---
+
+## Use Loop for Min/Max Instead of Sort
+
+Finding the smallest or largest element only requires a single pass through the array. Sorting is wasteful and slower.
+
+**Incorrect (O(n log n) - sort to find latest):**
+
+```typescript
+interface Project {
+  id: string
+  name: string
+  updatedAt: number
+}
+
+function getLatestProject(projects: Project[]) {
+  const sorted = [...projects].sort((a, b) => b.updatedAt - a.updatedAt)
+  return sorted[0]
+}
+```
+
+Sorts the entire array just to find the maximum value.
+
+**Incorrect (O(n log n) - sort for oldest and newest):**
+
+```typescript
+function getOldestAndNewest(projects: Project[]) {
+  const sorted = [...projects].sort((a, b) => a.updatedAt - b.updatedAt)
+  return { oldest: sorted[0], newest: sorted[sorted.length - 1] }
+}
+```
+
+Still sorts unnecessarily when only min/max are needed.
+
+**Correct (O(n) - single loop):**
+
+```typescript
+function getLatestProject(projects: Project[]) {
+  if (projects.length === 0) return null
+  
+  let latest = projects[0]
+  
+  for (let i = 1; i < projects.length; i++) {
+    if (projects[i].updatedAt > latest.updatedAt) {
+      latest = projects[i]
+    }
+  }
+  
+  return latest
+}
+
+function getOldestAndNewest(projects: Project[]) {
+  if (projects.length === 0) return { oldest: null, newest: null }
+  
+  let oldest = projects[0]
+  let newest = projects[0]
+  
+  for (let i = 1; i < projects.length; i++) {
+    if (projects[i].updatedAt < oldest.updatedAt) oldest = projects[i]
+    if (projects[i].updatedAt > newest.updatedAt) newest = projects[i]
+  }
+  
+  return { oldest, newest }
+}
+```
+
+Single pass through the array, no copying, no sorting.
+
+**Alternative (Math.min/Math.max for small arrays):**
+
+```typescript
+const numbers = [5, 2, 8, 1, 9]
+const min = Math.min(...numbers)
+const max = Math.max(...numbers)
+```
+
+This works for small arrays but can be slower for very large arrays due to spread operator limitations. Use the loop approach for reliability.
diff --git a/.claude/skills/vercel-react-best-practices/rules/js-set-map-lookups.md b/.claude/skills/vercel-react-best-practices/rules/js-set-map-lookups.md
new file mode 100644
index 0000000000..680a4892ee
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/js-set-map-lookups.md
@@ -0,0 +1,24 @@
+---
+title: Use Set/Map for O(1) Lookups
+impact: LOW-MEDIUM
+impactDescription: O(n) to O(1)
+tags: javascript, set, map, data-structures, performance
+---
+
+## Use Set/Map for O(1) Lookups
+
+Convert arrays to Set/Map for repeated membership checks.
+
+**Incorrect (O(n) per check):**
+
+```typescript
+const allowedIds = ['a', 'b', 'c', ...]
+items.filter(item => allowedIds.includes(item.id))
+```
+
+**Correct (O(1) per check):**
+
+```typescript
+const allowedIds = new Set(['a', 'b', 'c', ...])
+items.filter(item => allowedIds.has(item.id))
+```
diff --git a/.claude/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md b/.claude/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md
new file mode 100644
index 0000000000..eae8b3f8ae
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md
@@ -0,0 +1,57 @@
+---
+title: Use toSorted() Instead of sort() for Immutability
+impact: MEDIUM-HIGH
+impactDescription: prevents mutation bugs in React state
+tags: javascript, arrays, immutability, react, state, mutation
+---
+
+## Use toSorted() Instead of sort() for Immutability
+
+`.sort()` mutates the array in place, which can cause bugs with React state and props. Use `.toSorted()` to create a new sorted array without mutation.
+
+**Incorrect (mutates original array):**
+
+```typescript
+function UserList({ users }: { users: User[] }) {
+  // Mutates the users prop array!
+  const sorted = useMemo(
+    () => users.sort((a, b) => a.name.localeCompare(b.name)),
+    [users]
+  )
+  return <div>{sorted.map(renderUser)}</div>
+}
+```
+
+**Correct (creates new array):**
+
+```typescript
+function UserList({ users }: { users: User[] }) {
+  // Creates new sorted array, original unchanged
+  const sorted = useMemo(
+    () => users.toSorted((a, b) => a.name.localeCompare(b.name)),
+    [users]
+  )
+  return <div>{sorted.map(renderUser)}</div>
+}
+```
+
+**Why this matters in React:**
+
+1. Props/state mutations break React's immutability model - React expects props and state to be treated as read-only
+2. Causes stale closure bugs - Mutating arrays inside closures (callbacks, effects) can lead to unexpected behavior
+
+**Browser support (fallback for older browsers):**
+
+`.toSorted()` is available in all modern browsers (Chrome 110+, Safari 16+, Firefox 115+, Node.js 20+). For older environments, use spread operator:
+
+```typescript
+// Fallback for older browsers
+const sorted = [...items].sort((a, b) => a.value - b.value)
+```
+
+**Other immutable array methods:**
+
+- `.toSorted()` - immutable sort
+- `.toReversed()` - immutable reverse
+- `.toSpliced()` - immutable splice
+- `.with()` - immutable element replacement
diff --git a/.claude/skills/vercel-react-best-practices/rules/rendering-activity.md b/.claude/skills/vercel-react-best-practices/rules/rendering-activity.md
new file mode 100644
index 0000000000..c957a490b7
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/rendering-activity.md
@@ -0,0 +1,26 @@
+---
+title: Use Activity Component for Show/Hide
+impact: MEDIUM
+impactDescription: preserves state/DOM
+tags: rendering, activity, visibility, state-preservation
+---
+
+## Use Activity Component for Show/Hide
+
+Use React's `<Activity>` to preserve state/DOM for expensive components that frequently toggle visibility.
+
+**Usage:**
+
+```tsx
+import { Activity } from 'react'
+
+function Dropdown({ isOpen }: Props) {
+  return (
+    <Activity mode={isOpen ? 'visible' : 'hidden'}>
+      <ExpensiveMenu />
+    </Activity>
+  )
+}
+```
+
+Avoids expensive re-renders and state loss.
diff --git a/.claude/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md b/.claude/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md
new file mode 100644
index 0000000000..646744cbe5
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md
@@ -0,0 +1,47 @@
+---
+title: Animate SVG Wrapper Instead of SVG Element
+impact: LOW
+impactDescription: enables hardware acceleration
+tags: rendering, svg, css, animation, performance
+---
+
+## Animate SVG Wrapper Instead of SVG Element
+
+Many browsers don't have hardware acceleration for CSS3 animations on SVG elements. Wrap SVG in a `<div>` and animate the wrapper instead.
+
+**Incorrect (animating SVG directly - no hardware acceleration):**
+
+```tsx
+function LoadingSpinner() {
+  return (
+    <svg 
+      className="animate-spin"
+      width="24" 
+      height="24" 
+      viewBox="0 0 24 24"
+    >
+      <circle cx="12" cy="12" r="10" stroke="currentColor" />
+    </svg>
+  )
+}
+```
+
+**Correct (animating wrapper div - hardware accelerated):**
+
+```tsx
+function LoadingSpinner() {
+  return (
+    <div className="animate-spin">
+      <svg 
+        width="24" 
+        height="24" 
+        viewBox="0 0 24 24"
+      >
+        <circle cx="12" cy="12" r="10" stroke="currentColor" />
+      </svg>
+    </div>
+  )
+}
+```
+
+This applies to all CSS transforms and transitions (`transform`, `opacity`, `translate`, `scale`, `rotate`). The wrapper div allows browsers to use GPU acceleration for smoother animations.
diff --git a/.claude/skills/vercel-react-best-practices/rules/rendering-conditional-render.md b/.claude/skills/vercel-react-best-practices/rules/rendering-conditional-render.md
new file mode 100644
index 0000000000..7e866f5852
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/rendering-conditional-render.md
@@ -0,0 +1,40 @@
+---
+title: Use Explicit Conditional Rendering
+impact: LOW
+impactDescription: prevents rendering 0 or NaN
+tags: rendering, conditional, jsx, falsy-values
+---
+
+## Use Explicit Conditional Rendering
+
+Use explicit ternary operators (`? :`) instead of `&&` for conditional rendering when the condition can be `0`, `NaN`, or other falsy values that render.
+
+**Incorrect (renders "0" when count is 0):**
+
+```tsx
+function Badge({ count }: { count: number }) {
+  return (
+    <div>
+      {count && <span className="badge">{count}</span>}
+    </div>
+  )
+}
+
+// When count = 0, renders: <div>0</div>
+// When count = 5, renders: <div><span class="badge">5</span></div>
+```
+
+**Correct (renders nothing when count is 0):**
+
+```tsx
+function Badge({ count }: { count: number }) {
+  return (
+    <div>
+      {count > 0 ? <span className="badge">{count}</span> : null}
+    </div>
+  )
+}
+
+// When count = 0, renders: <div></div>
+// When count = 5, renders: <div><span class="badge">5</span></div>
+```
diff --git a/.claude/skills/vercel-react-best-practices/rules/rendering-content-visibility.md b/.claude/skills/vercel-react-best-practices/rules/rendering-content-visibility.md
new file mode 100644
index 0000000000..aa6656362b
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/rendering-content-visibility.md
@@ -0,0 +1,38 @@
+---
+title: CSS content-visibility for Long Lists
+impact: HIGH
+impactDescription: faster initial render
+tags: rendering, css, content-visibility, long-lists
+---
+
+## CSS content-visibility for Long Lists
+
+Apply `content-visibility: auto` to defer off-screen rendering.
+
+**CSS:**
+
+```css
+.message-item {
+  content-visibility: auto;
+  contain-intrinsic-size: 0 80px;
+}
+```
+
+**Example:**
+
+```tsx
+function MessageList({ messages }: { messages: Message[] }) {
+  return (
+    <div className="overflow-y-auto h-screen">
+      {messages.map(msg => (
+        <div key={msg.id} className="message-item">
+          <Avatar user={msg.author} />
+          <div>{msg.content}</div>
+        </div>
+      ))}
+    </div>
+  )
+}
+```
+
+For 1000 messages, browser skips layout/paint for ~990 off-screen items (10× faster initial render).
diff --git a/.claude/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md b/.claude/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md
new file mode 100644
index 0000000000..32d2f3fcea
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md
@@ -0,0 +1,46 @@
+---
+title: Hoist Static JSX Elements
+impact: LOW
+impactDescription: avoids re-creation
+tags: rendering, jsx, static, optimization
+---
+
+## Hoist Static JSX Elements
+
+Extract static JSX outside components to avoid re-creation.
+
+**Incorrect (recreates element every render):**
+
+```tsx
+function LoadingSkeleton() {
+  return <div className="animate-pulse h-20 bg-gray-200" />
+}
+
+function Container() {
+  return (
+    <div>
+      {loading && <LoadingSkeleton />}
+    </div>
+  )
+}
+```
+
+**Correct (reuses same element):**
+
+```tsx
+const loadingSkeleton = (
+  <div className="animate-pulse h-20 bg-gray-200" />
+)
+
+function Container() {
+  return (
+    <div>
+      {loading && loadingSkeleton}
+    </div>
+  )
+}
+```
+
+This is especially helpful for large and static SVG nodes, which can be expensive to recreate on every render.
+
+**Note:** If your project has [React Compiler](https://react.dev/learn/react-compiler) enabled, the compiler automatically hoists static JSX elements and optimizes component re-renders, making manual hoisting unnecessary.
diff --git a/.claude/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md b/.claude/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md
new file mode 100644
index 0000000000..5cf0e79b69
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md
@@ -0,0 +1,82 @@
+---
+title: Prevent Hydration Mismatch Without Flickering
+impact: MEDIUM
+impactDescription: avoids visual flicker and hydration errors
+tags: rendering, ssr, hydration, localStorage, flicker
+---
+
+## Prevent Hydration Mismatch Without Flickering
+
+When rendering content that depends on client-side storage (localStorage, cookies), avoid both SSR breakage and post-hydration flickering by injecting a synchronous script that updates the DOM before React hydrates.
+
+**Incorrect (breaks SSR):**
+
+```tsx
+function ThemeWrapper({ children }: { children: ReactNode }) {
+  // localStorage is not available on server - throws error
+  const theme = localStorage.getItem('theme') || 'light'
+  
+  return (
+    <div className={theme}>
+      {children}
+    </div>
+  )
+}
+```
+
+Server-side rendering will fail because `localStorage` is undefined.
+
+**Incorrect (visual flickering):**
+
+```tsx
+function ThemeWrapper({ children }: { children: ReactNode }) {
+  const [theme, setTheme] = useState('light')
+  
+  useEffect(() => {
+    // Runs after hydration - causes visible flash
+    const stored = localStorage.getItem('theme')
+    if (stored) {
+      setTheme(stored)
+    }
+  }, [])
+  
+  return (
+    <div className={theme}>
+      {children}
+    </div>
+  )
+}
+```
+
+Component first renders with default value (`light`), then updates after hydration, causing a visible flash of incorrect content.
+
+**Correct (no flicker, no hydration mismatch):**
+
+```tsx
+function ThemeWrapper({ children }: { children: ReactNode }) {
+  return (
+    <>
+      <div id="theme-wrapper">
+        {children}
+      </div>
+      <script
+        dangerouslySetInnerHTML={{
+          __html: `
+            (function() {
+              try {
+                var theme = localStorage.getItem('theme') || 'light';
+                var el = document.getElementById('theme-wrapper');
+                if (el) el.className = theme;
+              } catch (e) {}
+            })();
+          `,
+        }}
+      />
+    </>
+  )
+}
+```
+
+The inline script executes synchronously before showing the element, ensuring the DOM already has the correct value. No flickering, no hydration mismatch.
+
+This pattern is especially useful for theme toggles, user preferences, authentication states, and any client-only data that should render immediately without flashing default values.
diff --git a/.claude/skills/vercel-react-best-practices/rules/rendering-svg-precision.md b/.claude/skills/vercel-react-best-practices/rules/rendering-svg-precision.md
new file mode 100644
index 0000000000..6d77128603
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/rendering-svg-precision.md
@@ -0,0 +1,28 @@
+---
+title: Optimize SVG Precision
+impact: LOW
+impactDescription: reduces file size
+tags: rendering, svg, optimization, svgo
+---
+
+## Optimize SVG Precision
+
+Reduce SVG coordinate precision to decrease file size. The optimal precision depends on the viewBox size, but in general reducing precision should be considered.
+
+**Incorrect (excessive precision):**
+
+```svg
+<path d="M 10.293847 20.847362 L 30.938472 40.192837" />
+```
+
+**Correct (1 decimal place):**
+
+```svg
+<path d="M 10.3 20.8 L 30.9 40.2" />
+```
+
+**Automate with SVGO:**
+
+```bash
+npx svgo --precision=1 --multipass icon.svg
+```
diff --git a/.claude/skills/vercel-react-best-practices/rules/rerender-defer-reads.md b/.claude/skills/vercel-react-best-practices/rules/rerender-defer-reads.md
new file mode 100644
index 0000000000..e867c95f02
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/rerender-defer-reads.md
@@ -0,0 +1,39 @@
+---
+title: Defer State Reads to Usage Point
+impact: MEDIUM
+impactDescription: avoids unnecessary subscriptions
+tags: rerender, searchParams, localStorage, optimization
+---
+
+## Defer State Reads to Usage Point
+
+Don't subscribe to dynamic state (searchParams, localStorage) if you only read it inside callbacks.
+
+**Incorrect (subscribes to all searchParams changes):**
+
+```tsx
+function ShareButton({ chatId }: { chatId: string }) {
+  const searchParams = useSearchParams()
+
+  const handleShare = () => {
+    const ref = searchParams.get('ref')
+    shareChat(chatId, { ref })
+  }
+
+  return <button onClick={handleShare}>Share</button>
+}
+```
+
+**Correct (reads on demand, no subscription):**
+
+```tsx
+function ShareButton({ chatId }: { chatId: string }) {
+  const handleShare = () => {
+    const params = new URLSearchParams(window.location.search)
+    const ref = params.get('ref')
+    shareChat(chatId, { ref })
+  }
+
+  return <button onClick={handleShare}>Share</button>
+}
+```
diff --git a/.claude/skills/vercel-react-best-practices/rules/rerender-dependencies.md b/.claude/skills/vercel-react-best-practices/rules/rerender-dependencies.md
new file mode 100644
index 0000000000..47a4d92685
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/rerender-dependencies.md
@@ -0,0 +1,45 @@
+---
+title: Narrow Effect Dependencies
+impact: LOW
+impactDescription: minimizes effect re-runs
+tags: rerender, useEffect, dependencies, optimization
+---
+
+## Narrow Effect Dependencies
+
+Specify primitive dependencies instead of objects to minimize effect re-runs.
+
+**Incorrect (re-runs on any user field change):**
+
+```tsx
+useEffect(() => {
+  console.log(user.id)
+}, [user])
+```
+
+**Correct (re-runs only when id changes):**
+
+```tsx
+useEffect(() => {
+  console.log(user.id)
+}, [user.id])
+```
+
+**For derived state, compute outside effect:**
+
+```tsx
+// Incorrect: runs on width=767, 766, 765...
+useEffect(() => {
+  if (width < 768) {
+    enableMobileMode()
+  }
+}, [width])
+
+// Correct: runs only on boolean transition
+const isMobile = width < 768
+useEffect(() => {
+  if (isMobile) {
+    enableMobileMode()
+  }
+}, [isMobile])
+```
diff --git a/.claude/skills/vercel-react-best-practices/rules/rerender-derived-state.md b/.claude/skills/vercel-react-best-practices/rules/rerender-derived-state.md
new file mode 100644
index 0000000000..a15177caad
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/rerender-derived-state.md
@@ -0,0 +1,29 @@
+---
+title: Subscribe to Derived State
+impact: MEDIUM
+impactDescription: reduces re-render frequency
+tags: rerender, derived-state, media-query, optimization
+---
+
+## Subscribe to Derived State
+
+Subscribe to derived boolean state instead of continuous values to reduce re-render frequency.
+
+**Incorrect (re-renders on every pixel change):**
+
+```tsx
+function Sidebar() {
+  const width = useWindowWidth()  // updates continuously
+  const isMobile = width < 768
+  return <nav className={isMobile ? 'mobile' : 'desktop'}>
+}
+```
+
+**Correct (re-renders only when boolean changes):**
+
+```tsx
+function Sidebar() {
+  const isMobile = useMediaQuery('(max-width: 767px)')
+  return <nav className={isMobile ? 'mobile' : 'desktop'}>
+}
+```
diff --git a/.claude/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md b/.claude/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md
new file mode 100644
index 0000000000..b004ef45e3
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md
@@ -0,0 +1,74 @@
+---
+title: Use Functional setState Updates
+impact: MEDIUM
+impactDescription: prevents stale closures and unnecessary callback recreations
+tags: react, hooks, useState, useCallback, callbacks, closures
+---
+
+## Use Functional setState Updates
+
+When updating state based on the current state value, use the functional update form of setState instead of directly referencing the state variable. This prevents stale closures, eliminates unnecessary dependencies, and creates stable callback references.
+
+**Incorrect (requires state as dependency):**
+
+```tsx
+function TodoList() {
+  const [items, setItems] = useState(initialItems)
+  
+  // Callback must depend on items, recreated on every items change
+  const addItems = useCallback((newItems: Item[]) => {
+    setItems([...items, ...newItems])
+  }, [items])  // ❌ items dependency causes recreations
+  
+  // Risk of stale closure if dependency is forgotten
+  const removeItem = useCallback((id: string) => {
+    setItems(items.filter(item => item.id !== id))
+  }, [])  // ❌ Missing items dependency - will use stale items!
+  
+  return <ItemsEditor items={items} onAdd={addItems} onRemove={removeItem} />
+}
+```
+
+The first callback is recreated every time `items` changes, which can cause child components to re-render unnecessarily. The second callback has a stale closure bug—it will always reference the initial `items` value.
+
+**Correct (stable callbacks, no stale closures):**
+
+```tsx
+function TodoList() {
+  const [items, setItems] = useState(initialItems)
+  
+  // Stable callback, never recreated
+  const addItems = useCallback((newItems: Item[]) => {
+    setItems(curr => [...curr, ...newItems])
+  }, [])  // ✅ No dependencies needed
+  
+  // Always uses latest state, no stale closure risk
+  const removeItem = useCallback((id: string) => {
+    setItems(curr => curr.filter(item => item.id !== id))
+  }, [])  // ✅ Safe and stable
+  
+  return <ItemsEditor items={items} onAdd={addItems} onRemove={removeItem} />
+}
+```
+
+**Benefits:**
+
+1. **Stable callback references** - Callbacks don't need to be recreated when state changes
+2. **No stale closures** - Always operates on the latest state value
+3. **Fewer dependencies** - Simplifies dependency arrays and reduces memory leaks
+4. **Prevents bugs** - Eliminates the most common source of React closure bugs
+
+**When to use functional updates:**
+
+- Any setState that depends on the current state value
+- Inside useCallback/useMemo when state is needed
+- Event handlers that reference state
+- Async operations that update state
+
+**When direct updates are fine:**
+
+- Setting state to a static value: `setCount(0)`
+- Setting state from props/arguments only: `setName(newName)`
+- State doesn't depend on previous value
+
+**Note:** If your project has [React Compiler](https://react.dev/learn/react-compiler) enabled, the compiler can automatically optimize some cases, but functional updates are still recommended for correctness and to prevent stale closure bugs.
diff --git a/.claude/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md b/.claude/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md
new file mode 100644
index 0000000000..4ecb350fba
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md
@@ -0,0 +1,58 @@
+---
+title: Use Lazy State Initialization
+impact: MEDIUM
+impactDescription: wasted computation on every render
+tags: react, hooks, useState, performance, initialization
+---
+
+## Use Lazy State Initialization
+
+Pass a function to `useState` for expensive initial values. Without the function form, the initializer runs on every render even though the value is only used once.
+
+**Incorrect (runs on every render):**
+
+```tsx
+function FilteredList({ items }: { items: Item[] }) {
+  // buildSearchIndex() runs on EVERY render, even after initialization
+  const [searchIndex, setSearchIndex] = useState(buildSearchIndex(items))
+  const [query, setQuery] = useState('')
+  
+  // When query changes, buildSearchIndex runs again unnecessarily
+  return <SearchResults index={searchIndex} query={query} />
+}
+
+function UserProfile() {
+  // JSON.parse runs on every render
+  const [settings, setSettings] = useState(
+    JSON.parse(localStorage.getItem('settings') || '{}')
+  )
+  
+  return <SettingsForm settings={settings} onChange={setSettings} />
+}
+```
+
+**Correct (runs only once):**
+
+```tsx
+function FilteredList({ items }: { items: Item[] }) {
+  // buildSearchIndex() runs ONLY on initial render
+  const [searchIndex, setSearchIndex] = useState(() => buildSearchIndex(items))
+  const [query, setQuery] = useState('')
+  
+  return <SearchResults index={searchIndex} query={query} />
+}
+
+function UserProfile() {
+  // JSON.parse runs only on initial render
+  const [settings, setSettings] = useState(() => {
+    const stored = localStorage.getItem('settings')
+    return stored ? JSON.parse(stored) : {}
+  })
+  
+  return <SettingsForm settings={settings} onChange={setSettings} />
+}
+```
+
+Use lazy initialization when computing initial values from localStorage/sessionStorage, building data structures (indexes, maps), reading from the DOM, or performing heavy transformations.
+
+For simple primitives (`useState(0)`), direct references (`useState(props.value)`), or cheap literals (`useState({})`), the function form is unnecessary.
diff --git a/.claude/skills/vercel-react-best-practices/rules/rerender-memo.md b/.claude/skills/vercel-react-best-practices/rules/rerender-memo.md
new file mode 100644
index 0000000000..f8982ab612
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/rerender-memo.md
@@ -0,0 +1,44 @@
+---
+title: Extract to Memoized Components
+impact: MEDIUM
+impactDescription: enables early returns
+tags: rerender, memo, useMemo, optimization
+---
+
+## Extract to Memoized Components
+
+Extract expensive work into memoized components to enable early returns before computation.
+
+**Incorrect (computes avatar even when loading):**
+
+```tsx
+function Profile({ user, loading }: Props) {
+  const avatar = useMemo(() => {
+    const id = computeAvatarId(user)
+    return <Avatar id={id} />
+  }, [user])
+
+  if (loading) return <Skeleton />
+  return <div>{avatar}</div>
+}
+```
+
+**Correct (skips computation when loading):**
+
+```tsx
+const UserAvatar = memo(function UserAvatar({ user }: { user: User }) {
+  const id = useMemo(() => computeAvatarId(user), [user])
+  return <Avatar id={id} />
+})
+
+function Profile({ user, loading }: Props) {
+  if (loading) return <Skeleton />
+  return (
+    <div>
+      <UserAvatar user={user} />
+    </div>
+  )
+}
+```
+
+**Note:** If your project has [React Compiler](https://react.dev/learn/react-compiler) enabled, manual memoization with `memo()` and `useMemo()` is not necessary. The compiler automatically optimizes re-renders.
diff --git a/.claude/skills/vercel-react-best-practices/rules/rerender-transitions.md b/.claude/skills/vercel-react-best-practices/rules/rerender-transitions.md
new file mode 100644
index 0000000000..d99f43f764
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/rerender-transitions.md
@@ -0,0 +1,40 @@
+---
+title: Use Transitions for Non-Urgent Updates
+impact: MEDIUM
+impactDescription: maintains UI responsiveness
+tags: rerender, transitions, startTransition, performance
+---
+
+## Use Transitions for Non-Urgent Updates
+
+Mark frequent, non-urgent state updates as transitions to maintain UI responsiveness.
+
+**Incorrect (blocks UI on every scroll):**
+
+```tsx
+function ScrollTracker() {
+  const [scrollY, setScrollY] = useState(0)
+  useEffect(() => {
+    const handler = () => setScrollY(window.scrollY)
+    window.addEventListener('scroll', handler, { passive: true })
+    return () => window.removeEventListener('scroll', handler)
+  }, [])
+}
+```
+
+**Correct (non-blocking updates):**
+
+```tsx
+import { startTransition } from 'react'
+
+function ScrollTracker() {
+  const [scrollY, setScrollY] = useState(0)
+  useEffect(() => {
+    const handler = () => {
+      startTransition(() => setScrollY(window.scrollY))
+    }
+    window.addEventListener('scroll', handler, { passive: true })
+    return () => window.removeEventListener('scroll', handler)
+  }, [])
+}
+```
diff --git a/.claude/skills/vercel-react-best-practices/rules/server-after-nonblocking.md b/.claude/skills/vercel-react-best-practices/rules/server-after-nonblocking.md
new file mode 100644
index 0000000000..e8f5b260f5
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/server-after-nonblocking.md
@@ -0,0 +1,73 @@
+---
+title: Use after() for Non-Blocking Operations
+impact: MEDIUM
+impactDescription: faster response times
+tags: server, async, logging, analytics, side-effects
+---
+
+## Use after() for Non-Blocking Operations
+
+Use Next.js's `after()` to schedule work that should execute after a response is sent. This prevents logging, analytics, and other side effects from blocking the response.
+
+**Incorrect (blocks response):**
+
+```tsx
+import { logUserAction } from '@/app/utils'
+
+export async function POST(request: Request) {
+  // Perform mutation
+  await updateDatabase(request)
+  
+  // Logging blocks the response
+  const userAgent = request.headers.get('user-agent') || 'unknown'
+  await logUserAction({ userAgent })
+  
+  return new Response(JSON.stringify({ status: 'success' }), {
+    status: 200,
+    headers: { 'Content-Type': 'application/json' }
+  })
+}
+```
+
+**Correct (non-blocking):**
+
+```tsx
+import { after } from 'next/server'
+import { headers, cookies } from 'next/headers'
+import { logUserAction } from '@/app/utils'
+
+export async function POST(request: Request) {
+  // Perform mutation
+  await updateDatabase(request)
+  
+  // Log after response is sent
+  after(async () => {
+    const userAgent = (await headers()).get('user-agent') || 'unknown'
+    const sessionCookie = (await cookies()).get('session-id')?.value || 'anonymous'
+    
+    logUserAction({ sessionCookie, userAgent })
+  })
+  
+  return new Response(JSON.stringify({ status: 'success' }), {
+    status: 200,
+    headers: { 'Content-Type': 'application/json' }
+  })
+}
+```
+
+The response is sent immediately while logging happens in the background.
+
+**Common use cases:**
+
+- Analytics tracking
+- Audit logging
+- Sending notifications
+- Cache invalidation
+- Cleanup tasks
+
+**Important notes:**
+
+- `after()` runs even if the response fails or redirects
+- Works in Server Actions, Route Handlers, and Server Components
+
+Reference: [https://nextjs.org/docs/app/api-reference/functions/after](https://nextjs.org/docs/app/api-reference/functions/after)
diff --git a/.claude/skills/vercel-react-best-practices/rules/server-cache-lru.md b/.claude/skills/vercel-react-best-practices/rules/server-cache-lru.md
new file mode 100644
index 0000000000..ef6938aa53
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/server-cache-lru.md
@@ -0,0 +1,41 @@
+---
+title: Cross-Request LRU Caching
+impact: HIGH
+impactDescription: caches across requests
+tags: server, cache, lru, cross-request
+---
+
+## Cross-Request LRU Caching
+
+`React.cache()` only works within one request. For data shared across sequential requests (user clicks button A then button B), use an LRU cache.
+
+**Implementation:**
+
+```typescript
+import { LRUCache } from 'lru-cache'
+
+const cache = new LRUCache<string, any>({
+  max: 1000,
+  ttl: 5 * 60 * 1000  // 5 minutes
+})
+
+export async function getUser(id: string) {
+  const cached = cache.get(id)
+  if (cached) return cached
+
+  const user = await db.user.findUnique({ where: { id } })
+  cache.set(id, user)
+  return user
+}
+
+// Request 1: DB query, result cached
+// Request 2: cache hit, no DB query
+```
+
+Use when sequential user actions hit multiple endpoints needing the same data within seconds.
+
+**With Vercel's [Fluid Compute](https://vercel.com/docs/fluid-compute):** LRU caching is especially effective because multiple concurrent requests can share the same function instance and cache. This means the cache persists across requests without needing external storage like Redis.
+
+**In traditional serverless:** Each invocation runs in isolation, so consider Redis for cross-process caching.
+
+Reference: [https://github.com/isaacs/node-lru-cache](https://github.com/isaacs/node-lru-cache)
diff --git a/.claude/skills/vercel-react-best-practices/rules/server-cache-react.md b/.claude/skills/vercel-react-best-practices/rules/server-cache-react.md
new file mode 100644
index 0000000000..fa49e0e87a
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/server-cache-react.md
@@ -0,0 +1,26 @@
+---
+title: Per-Request Deduplication with React.cache()
+impact: MEDIUM
+impactDescription: deduplicates within request
+tags: server, cache, react-cache, deduplication
+---
+
+## Per-Request Deduplication with React.cache()
+
+Use `React.cache()` for server-side request deduplication. Authentication and database queries benefit most.
+
+**Usage:**
+
+```typescript
+import { cache } from 'react'
+
+export const getCurrentUser = cache(async () => {
+  const session = await auth()
+  if (!session?.user?.id) return null
+  return await db.user.findUnique({
+    where: { id: session.user.id }
+  })
+})
+```
+
+Within a single request, multiple calls to `getCurrentUser()` execute the query only once.
diff --git a/.claude/skills/vercel-react-best-practices/rules/server-parallel-fetching.md b/.claude/skills/vercel-react-best-practices/rules/server-parallel-fetching.md
new file mode 100644
index 0000000000..5261f08408
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/server-parallel-fetching.md
@@ -0,0 +1,79 @@
+---
+title: Parallel Data Fetching with Component Composition
+impact: CRITICAL
+impactDescription: eliminates server-side waterfalls
+tags: server, rsc, parallel-fetching, composition
+---
+
+## Parallel Data Fetching with Component Composition
+
+React Server Components execute sequentially within a tree. Restructure with composition to parallelize data fetching.
+
+**Incorrect (Sidebar waits for Page's fetch to complete):**
+
+```tsx
+export default async function Page() {
+  const header = await fetchHeader()
+  return (
+    <div>
+      <div>{header}</div>
+      <Sidebar />
+    </div>
+  )
+}
+
+async function Sidebar() {
+  const items = await fetchSidebarItems()
+  return <nav>{items.map(renderItem)}</nav>
+}
+```
+
+**Correct (both fetch simultaneously):**
+
+```tsx
+async function Header() {
+  const data = await fetchHeader()
+  return <div>{data}</div>
+}
+
+async function Sidebar() {
+  const items = await fetchSidebarItems()
+  return <nav>{items.map(renderItem)}</nav>
+}
+
+export default function Page() {
+  return (
+    <div>
+      <Header />
+      <Sidebar />
+    </div>
+  )
+}
+```
+
+**Alternative with children prop:**
+
+```tsx
+async function Layout({ children }: { children: ReactNode }) {
+  const header = await fetchHeader()
+  return (
+    <div>
+      <div>{header}</div>
+      {children}
+    </div>
+  )
+}
+
+async function Sidebar() {
+  const items = await fetchSidebarItems()
+  return <nav>{items.map(renderItem)}</nav>
+}
+
+export default function Page() {
+  return (
+    <Layout>
+      <Sidebar />
+    </Layout>
+  )
+}
+```
diff --git a/.claude/skills/vercel-react-best-practices/rules/server-serialization.md b/.claude/skills/vercel-react-best-practices/rules/server-serialization.md
new file mode 100644
index 0000000000..39c5c4164c
--- /dev/null
+++ b/.claude/skills/vercel-react-best-practices/rules/server-serialization.md
@@ -0,0 +1,38 @@
+---
+title: Minimize Serialization at RSC Boundaries
+impact: HIGH
+impactDescription: reduces data transfer size
+tags: server, rsc, serialization, props
+---
+
+## Minimize Serialization at RSC Boundaries
+
+The React Server/Client boundary serializes all object properties into strings and embeds them in the HTML response and subsequent RSC requests. This serialized data directly impacts page weight and load time, so **size matters a lot**. Only pass fields that the client actually uses.
+
+**Incorrect (serializes all 50 fields):**
+
+```tsx
+async function Page() {
+  const user = await fetchUser()  // 50 fields
+  return <Profile user={user} />
+}
+
+'use client'
+function Profile({ user }: { user: User }) {
+  return <div>{user.name}</div>  // uses 1 field
+}
+```
+
+**Correct (serializes only 1 field):**
+
+```tsx
+async function Page() {
+  const user = await fetchUser()
+  return <Profile name={user.name} />
+}
+
+'use client'
+function Profile({ name }: { name: string }) {
+  return <div>{name}</div>
+}
+```
diff --git a/.dockerignore b/.dockerignore
index 94bf1742f1..9b744e7f9b 100644
--- a/.dockerignore
+++ b/.dockerignore
@@ -1,6 +1,9 @@
 # Ignore everything by default, selectively add things to context
 *
 
+# Documentation (for embeddings/search)
+!docs/
+
 # Platform - Libs
 !autogpt_platform/autogpt_libs/autogpt_libs/
 !autogpt_platform/autogpt_libs/pyproject.toml
@@ -16,6 +19,7 @@
 !autogpt_platform/backend/poetry.lock
 !autogpt_platform/backend/README.md
 !autogpt_platform/backend/.env
+!autogpt_platform/backend/gen_prisma_types_stub.py
 
 # Platform - Market
 !autogpt_platform/market/market/
diff --git a/.github/workflows/claude-ci-failure-auto-fix.yml b/.github/workflows/claude-ci-failure-auto-fix.yml
index b20f6cd2b3..e39c6676ce 100644
--- a/.github/workflows/claude-ci-failure-auto-fix.yml
+++ b/.github/workflows/claude-ci-failure-auto-fix.yml
@@ -93,5 +93,5 @@ jobs:
 
             Error logs:
             ${{ toJSON(fromJSON(steps.failure_details.outputs.result).errorLogs) }}
-          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
           claude_args: "--allowedTools 'Edit,MultiEdit,Write,Read,Glob,Grep,LS,Bash(git:*),Bash(bun:*),Bash(npm:*),Bash(npx:*),Bash(gh:*)'"
diff --git a/.github/workflows/claude-dependabot.yml b/.github/workflows/claude-dependabot.yml
index 20b6f1d28e..ff6935dc2d 100644
--- a/.github/workflows/claude-dependabot.yml
+++ b/.github/workflows/claude-dependabot.yml
@@ -7,7 +7,7 @@
 # - Provide actionable recommendations for the development team
 #
 # Triggered on: Dependabot PRs (opened, synchronize)
-# Requirements: ANTHROPIC_API_KEY secret must be configured
+# Requirements: CLAUDE_CODE_OAUTH_TOKEN secret must be configured
 
 name: Claude Dependabot PR Review
 
@@ -74,7 +74,7 @@ jobs:
 
       - name: Generate Prisma Client
         working-directory: autogpt_platform/backend
-        run: poetry run prisma generate
+        run: poetry run prisma generate && poetry run gen-prisma-stub
 
       # Frontend Node.js/pnpm setup (mirrors platform-frontend-ci.yml)
       - name: Set up Node.js
@@ -308,7 +308,7 @@ jobs:
         id: claude_review
         uses: anthropics/claude-code-action@v1
         with:
-          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
           claude_args: |
             --allowedTools "Bash(npm:*),Bash(pnpm:*),Bash(poetry:*),Bash(git:*),Edit,Replace,NotebookEditCell,mcp__github_inline_comment__create_inline_comment,Bash(gh pr comment:*), Bash(gh pr diff:*), Bash(gh pr view:*)"
           prompt: |
diff --git a/.github/workflows/claude.yml b/.github/workflows/claude.yml
index 3f5e8c22ec..8c45f930dc 100644
--- a/.github/workflows/claude.yml
+++ b/.github/workflows/claude.yml
@@ -90,7 +90,7 @@ jobs:
 
       - name: Generate Prisma Client
         working-directory: autogpt_platform/backend
-        run: poetry run prisma generate
+        run: poetry run prisma generate && poetry run gen-prisma-stub
 
       # Frontend Node.js/pnpm setup (mirrors platform-frontend-ci.yml)
       - name: Set up Node.js
@@ -323,7 +323,7 @@ jobs:
         id: claude
         uses: anthropics/claude-code-action@v1
         with:
-          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
           claude_args: |
             --allowedTools "Bash(npm:*),Bash(pnpm:*),Bash(poetry:*),Bash(git:*),Edit,Replace,NotebookEditCell,mcp__github_inline_comment__create_inline_comment,Bash(gh pr comment:*), Bash(gh pr diff:*), Bash(gh pr view:*), Bash(gh pr edit:*)"
             --model opus
diff --git a/.github/workflows/copilot-setup-steps.yml b/.github/workflows/copilot-setup-steps.yml
index 13ef01cc44..aac8befee0 100644
--- a/.github/workflows/copilot-setup-steps.yml
+++ b/.github/workflows/copilot-setup-steps.yml
@@ -72,7 +72,7 @@ jobs:
 
       - name: Generate Prisma Client
         working-directory: autogpt_platform/backend
-        run: poetry run prisma generate
+        run: poetry run prisma generate && poetry run gen-prisma-stub
 
       # Frontend Node.js/pnpm setup (mirrors platform-frontend-ci.yml)
       - name: Set up Node.js
@@ -108,6 +108,16 @@ jobs:
       #   run: pnpm playwright install --with-deps chromium
 
       # Docker setup for development environment
+      - name: Free up disk space
+        run: |
+          # Remove large unused tools to free disk space for Docker builds
+          sudo rm -rf /usr/share/dotnet
+          sudo rm -rf /usr/local/lib/android
+          sudo rm -rf /opt/ghc
+          sudo rm -rf /opt/hostedtoolcache/CodeQL
+          sudo docker system prune -af
+          df -h
+
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
 
diff --git a/.github/workflows/docs-block-sync.yml b/.github/workflows/docs-block-sync.yml
new file mode 100644
index 0000000000..b1fc986ea7
--- /dev/null
+++ b/.github/workflows/docs-block-sync.yml
@@ -0,0 +1,78 @@
+name: Block Documentation Sync Check
+
+on:
+  push:
+    branches: [master, dev]
+    paths:
+      - "autogpt_platform/backend/backend/blocks/**"
+      - "docs/integrations/**"
+      - "autogpt_platform/backend/scripts/generate_block_docs.py"
+      - ".github/workflows/docs-block-sync.yml"
+  pull_request:
+    branches: [master, dev]
+    paths:
+      - "autogpt_platform/backend/backend/blocks/**"
+      - "docs/integrations/**"
+      - "autogpt_platform/backend/scripts/generate_block_docs.py"
+      - ".github/workflows/docs-block-sync.yml"
+
+jobs:
+  check-docs-sync:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Set up Python dependency cache
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pypoetry
+          key: poetry-${{ runner.os }}-${{ hashFiles('autogpt_platform/backend/poetry.lock') }}
+          restore-keys: |
+            poetry-${{ runner.os }}-
+
+      - name: Install Poetry
+        run: |
+          cd autogpt_platform/backend
+          HEAD_POETRY_VERSION=$(python3 ../../.github/workflows/scripts/get_package_version_from_lockfile.py poetry)
+          echo "Found Poetry version ${HEAD_POETRY_VERSION} in backend/poetry.lock"
+          curl -sSL https://install.python-poetry.org | POETRY_VERSION=$HEAD_POETRY_VERSION python3 -
+          echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+      - name: Install dependencies
+        working-directory: autogpt_platform/backend
+        run: |
+          poetry install --only main
+          poetry run prisma generate
+
+      - name: Check block documentation is in sync
+        working-directory: autogpt_platform/backend
+        run: |
+          echo "Checking if block documentation is in sync with code..."
+          poetry run python scripts/generate_block_docs.py --check
+
+      - name: Show diff if out of sync
+        if: failure()
+        working-directory: autogpt_platform/backend
+        run: |
+          echo "::error::Block documentation is out of sync with code!"
+          echo ""
+          echo "To fix this, run the following command locally:"
+          echo "  cd autogpt_platform/backend && poetry run python scripts/generate_block_docs.py"
+          echo ""
+          echo "Then commit the updated documentation files."
+          echo ""
+          echo "Regenerating docs to show diff..."
+          poetry run python scripts/generate_block_docs.py
+          echo ""
+          echo "Changes detected:"
+          git diff ../../docs/integrations/ || true
diff --git a/.github/workflows/docs-claude-review.yml b/.github/workflows/docs-claude-review.yml
new file mode 100644
index 0000000000..511c2efcd5
--- /dev/null
+++ b/.github/workflows/docs-claude-review.yml
@@ -0,0 +1,95 @@
+name: Claude Block Docs Review
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+    paths:
+      - "docs/integrations/**"
+      - "autogpt_platform/backend/backend/blocks/**"
+
+jobs:
+  claude-review:
+    # Only run for PRs from members/collaborators
+    if: |
+      github.event.pull_request.author_association == 'OWNER' ||
+      github.event.pull_request.author_association == 'MEMBER' ||
+      github.event.pull_request.author_association == 'COLLABORATOR'
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      contents: read
+      pull-requests: write
+      id-token: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Set up Python dependency cache
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pypoetry
+          key: poetry-${{ runner.os }}-${{ hashFiles('autogpt_platform/backend/poetry.lock') }}
+          restore-keys: |
+            poetry-${{ runner.os }}-
+
+      - name: Install Poetry
+        run: |
+          cd autogpt_platform/backend
+          HEAD_POETRY_VERSION=$(python3 ../../.github/workflows/scripts/get_package_version_from_lockfile.py poetry)
+          curl -sSL https://install.python-poetry.org | POETRY_VERSION=$HEAD_POETRY_VERSION python3 -
+          echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+      - name: Install dependencies
+        working-directory: autogpt_platform/backend
+        run: |
+          poetry install --only main
+          poetry run prisma generate
+
+      - name: Run Claude Code Review
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          claude_args: |
+            --allowedTools "Read,Glob,Grep,Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*)"
+          prompt: |
+            You are reviewing a PR that modifies block documentation or block code for AutoGPT.
+
+            ## Your Task
+            Review the changes in this PR and provide constructive feedback. Focus on:
+
+            1. **Documentation Accuracy**: For any block code changes, verify that:
+               - Input/output tables in docs match the actual block schemas
+               - Description text accurately reflects what the block does
+               - Any new blocks have corresponding documentation
+
+            2. **Manual Content Quality**: Check manual sections (marked with `<!-- MANUAL: -->` markers):
+               - "How it works" sections should have clear technical explanations
+               - "Possible use case" sections should have practical, real-world examples
+               - Content should be helpful for users trying to understand the blocks
+
+            3. **Template Compliance**: Ensure docs follow the standard template:
+               - What it is (brief intro)
+               - What it does (description)
+               - How it works (technical explanation)
+               - Inputs table
+               - Outputs table
+               - Possible use case
+
+            4. **Cross-references**: Check that links and anchors are correct
+
+            ## Review Process
+            1. First, get the PR diff to see what changed: `gh pr diff ${{ github.event.pull_request.number }}`
+            2. Read any modified block files to understand the implementation
+            3. Read corresponding documentation files to verify accuracy
+            4. Provide your feedback as a PR comment
+
+            Be constructive and specific. If everything looks good, say so!
+            If there are issues, explain what's wrong and suggest how to fix it.
diff --git a/.github/workflows/docs-enhance.yml b/.github/workflows/docs-enhance.yml
new file mode 100644
index 0000000000..db750e78ae
--- /dev/null
+++ b/.github/workflows/docs-enhance.yml
@@ -0,0 +1,194 @@
+name: Enhance Block Documentation
+
+on:
+  workflow_dispatch:
+    inputs:
+      block_pattern:
+        description: 'Block file pattern to enhance (e.g., "google/*.md" or "*" for all blocks)'
+        required: true
+        default: '*'
+        type: string
+      dry_run:
+        description: 'Dry run mode - show proposed changes without committing'
+        type: boolean
+        default: true
+      max_blocks:
+        description: 'Maximum number of blocks to process (0 for unlimited)'
+        type: number
+        default: 10
+
+jobs:
+  enhance-docs:
+    runs-on: ubuntu-latest
+    timeout-minutes: 45
+    permissions:
+      contents: write
+      pull-requests: write
+      id-token: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Set up Python dependency cache
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pypoetry
+          key: poetry-${{ runner.os }}-${{ hashFiles('autogpt_platform/backend/poetry.lock') }}
+          restore-keys: |
+            poetry-${{ runner.os }}-
+
+      - name: Install Poetry
+        run: |
+          cd autogpt_platform/backend
+          HEAD_POETRY_VERSION=$(python3 ../../.github/workflows/scripts/get_package_version_from_lockfile.py poetry)
+          curl -sSL https://install.python-poetry.org | POETRY_VERSION=$HEAD_POETRY_VERSION python3 -
+          echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+      - name: Install dependencies
+        working-directory: autogpt_platform/backend
+        run: |
+          poetry install --only main
+          poetry run prisma generate
+
+      - name: Run Claude Enhancement
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          claude_args: |
+            --allowedTools "Read,Edit,Glob,Grep,Write,Bash(git:*),Bash(gh:*),Bash(find:*),Bash(ls:*)"
+          prompt: |
+            You are enhancing block documentation for AutoGPT. Your task is to improve the MANUAL sections
+            of block documentation files by reading the actual block implementations and writing helpful content.
+
+            ## Configuration
+            - Block pattern: ${{ inputs.block_pattern }}
+            - Dry run: ${{ inputs.dry_run }}
+            - Max blocks to process: ${{ inputs.max_blocks }}
+
+            ## Your Task
+
+            1. **Find Documentation Files**
+               Find block documentation files matching the pattern in `docs/integrations/`
+               Pattern: ${{ inputs.block_pattern }}
+
+               Use: `find docs/integrations -name "*.md" -type f`
+
+            2. **For Each Documentation File** (up to ${{ inputs.max_blocks }} files):
+
+               a. Read the documentation file
+
+               b. Identify which block(s) it documents (look for the block class name)
+
+               c. Find and read the corresponding block implementation in `autogpt_platform/backend/backend/blocks/`
+
+               d. Improve the MANUAL sections:
+
+                  **"How it works" section** (within `<!-- MANUAL: how_it_works -->` markers):
+                  - Explain the technical flow of the block
+                  - Describe what APIs or services it connects to
+                  - Note any important configuration or prerequisites
+                  - Keep it concise but informative (2-4 paragraphs)
+
+                  **"Possible use case" section** (within `<!-- MANUAL: use_case -->` markers):
+                  - Provide 2-3 practical, real-world examples
+                  - Make them specific and actionable
+                  - Show how this block could be used in an automation workflow
+
+            3. **Important Rules**
+               - ONLY modify content within `<!-- MANUAL: -->` and `<!-- END MANUAL -->` markers
+               - Do NOT modify auto-generated sections (inputs/outputs tables, descriptions)
+               - Keep content accurate based on the actual block implementation
+               - Write for users who may not be technical experts
+
+            4. **Output**
+               ${{ inputs.dry_run == true && 'DRY RUN MODE: Show proposed changes for each file but do NOT actually edit the files. Describe what you would change.' || 'LIVE MODE: Actually edit the files to improve the documentation.' }}
+
+            ## Example Improvements
+
+            **Before (How it works):**
+            ```
+            _Add technical explanation here._
+            ```
+
+            **After (How it works):**
+            ```
+            This block connects to the GitHub API to retrieve issue information. When executed,
+            it authenticates using your GitHub credentials and fetches issue details including
+            title, body, labels, and assignees.
+
+            The block requires a valid GitHub OAuth connection with repository access permissions.
+            It supports both public and private repositories you have access to.
+            ```
+
+            **Before (Possible use case):**
+            ```
+            _Add practical use case examples here._
+            ```
+
+            **After (Possible use case):**
+            ```
+            **Customer Support Automation**: Monitor a GitHub repository for new issues with
+            the "bug" label, then automatically create a ticket in your support system and
+            notify the on-call engineer via Slack.
+
+            **Release Notes Generation**: When a new release is published, gather all closed
+            issues since the last release and generate a summary for your changelog.
+            ```
+
+            Begin by finding and listing the documentation files to process.
+
+      - name: Create PR with enhanced documentation
+        if: ${{ inputs.dry_run == false }}
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          # Check if there are changes
+          if git diff --quiet docs/integrations/; then
+            echo "No changes to commit"
+            exit 0
+          fi
+
+          # Configure git
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+          # Create branch and commit
+          BRANCH_NAME="docs/enhance-blocks-$(date +%Y%m%d-%H%M%S)"
+          git checkout -b "$BRANCH_NAME"
+          git add docs/integrations/
+          git commit -m "docs: enhance block documentation with LLM-generated content
+
+          Pattern: ${{ inputs.block_pattern }}
+          Max blocks: ${{ inputs.max_blocks }}
+
+          🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+          Co-Authored-By: Claude <noreply@anthropic.com>"
+
+          # Push and create PR
+          git push -u origin "$BRANCH_NAME"
+          gh pr create \
+            --title "docs: LLM-enhanced block documentation" \
+            --body "## Summary
+          This PR contains LLM-enhanced documentation for block files matching pattern: \`${{ inputs.block_pattern }}\`
+
+          The following manual sections were improved:
+          - **How it works**: Technical explanations based on block implementations
+          - **Possible use case**: Practical, real-world examples
+
+          ## Review Checklist
+          - [ ] Content is accurate based on block implementations
+          - [ ] Examples are practical and helpful
+          - [ ] No auto-generated sections were modified
+
+          ---
+          🤖 Generated with [Claude Code](https://claude.com/claude-code)" \
+            --base dev
diff --git a/.github/workflows/platform-backend-ci.yml b/.github/workflows/platform-backend-ci.yml
index f962382fa5..f66cce8a37 100644
--- a/.github/workflows/platform-backend-ci.yml
+++ b/.github/workflows/platform-backend-ci.yml
@@ -134,7 +134,7 @@ jobs:
         run: poetry install
 
       - name: Generate Prisma Client
-        run: poetry run prisma generate
+        run: poetry run prisma generate && poetry run gen-prisma-stub
 
       - id: supabase
         name: Start Supabase
@@ -176,7 +176,7 @@ jobs:
           }
 
       - name: Run Database Migrations
-        run: poetry run prisma migrate dev --name updates
+        run: poetry run prisma migrate deploy
         env:
           DATABASE_URL: ${{ steps.supabase.outputs.DB_URL }}
           DIRECT_URL: ${{ steps.supabase.outputs.DB_URL }}
diff --git a/.github/workflows/platform-frontend-ci.yml b/.github/workflows/platform-frontend-ci.yml
index 2154fe1385..fb7a55055e 100644
--- a/.github/workflows/platform-frontend-ci.yml
+++ b/.github/workflows/platform-frontend-ci.yml
@@ -11,6 +11,7 @@ on:
       - ".github/workflows/platform-frontend-ci.yml"
       - "autogpt_platform/frontend/**"
   merge_group:
+  workflow_dispatch:
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.event_name == 'merge_group' && format('merge-queue-{0}', github.ref) || format('{0}-{1}', github.ref, github.event.pull_request.number || github.sha) }}
@@ -151,6 +152,14 @@ jobs:
         run: |
           cp ../.env.default ../.env
 
+      - name: Copy backend .env and set OpenAI API key
+        run: |
+          cp ../backend/.env.default ../backend/.env
+          echo "OPENAI_INTERNAL_API_KEY=${{ secrets.OPENAI_API_KEY }}" >> ../backend/.env
+        env:
+          # Used by E2E test data script to generate embeddings for approved store agents
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
 
@@ -226,13 +235,25 @@ jobs:
 
       - name: Run Playwright tests
         run: pnpm test:no-build
+        continue-on-error: false
 
-      - name: Upload Playwright artifacts
-        if: failure()
+      - name: Upload Playwright report
+        if: always()
         uses: actions/upload-artifact@v4
         with:
           name: playwright-report
           path: playwright-report
+          if-no-files-found: ignore
+          retention-days: 3
+
+      - name: Upload Playwright test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-test-results
+          path: test-results
+          if-no-files-found: ignore
+          retention-days: 3
 
       - name: Print Final Docker Compose logs
         if: always()
diff --git a/autogpt_platform/Makefile b/autogpt_platform/Makefile
index d99fee49d7..d53be570bc 100644
--- a/autogpt_platform/Makefile
+++ b/autogpt_platform/Makefile
@@ -6,12 +6,14 @@ start-core:
 
 # Stop core services
 stop-core:
-	docker compose stop deps
+	docker compose stop 
 
 reset-db:
+	docker compose stop db
 	rm -rf db/docker/volumes/db/data
 	cd backend && poetry run prisma migrate deploy
 	cd backend && poetry run prisma generate
+	cd backend && poetry run gen-prisma-stub
 	
 # View logs for core services
 logs-core:
@@ -33,6 +35,7 @@ init-env:
 migrate:
 	cd backend && poetry run prisma migrate deploy
 	cd backend && poetry run prisma generate
+	cd backend && poetry run gen-prisma-stub
 
 run-backend:
 	cd backend && poetry run app
@@ -58,4 +61,4 @@ help:
 	@echo "  run-backend - Run the backend FastAPI server"
 	@echo "  run-frontend - Run the frontend Next.js development server"
 	@echo "  test-data - Run the test data creator"
-	@echo "  load-store-agents - Load store agents from agents/ folder into test database"
\ No newline at end of file
+	@echo "  load-store-agents - Load store agents from agents/ folder into test database"
diff --git a/autogpt_platform/backend/.env.default b/autogpt_platform/backend/.env.default
index a0004633ca..49689d7ad6 100644
--- a/autogpt_platform/backend/.env.default
+++ b/autogpt_platform/backend/.env.default
@@ -58,6 +58,13 @@ V0_API_KEY=
 OPEN_ROUTER_API_KEY=
 NVIDIA_API_KEY=
 
+# Langfuse Prompt Management
+# Used for managing the CoPilot system prompt externally
+# Get credentials from https://cloud.langfuse.com or your self-hosted instance
+LANGFUSE_PUBLIC_KEY=
+LANGFUSE_SECRET_KEY=
+LANGFUSE_HOST=https://cloud.langfuse.com
+
 # OAuth Credentials
 # For the OAuth callback URL, use <your_frontend_url>/auth/integrations/oauth_callback,
 # e.g. http://localhost:3000/auth/integrations/oauth_callback
diff --git a/autogpt_platform/backend/.gitignore b/autogpt_platform/backend/.gitignore
index 95b59cf676..9224c07d9e 100644
--- a/autogpt_platform/backend/.gitignore
+++ b/autogpt_platform/backend/.gitignore
@@ -18,3 +18,4 @@ load-tests/results/
 load-tests/*.json
 load-tests/*.log
 load-tests/node_modules/*
+migrations/*/rollback*.sql
diff --git a/autogpt_platform/backend/Dockerfile b/autogpt_platform/backend/Dockerfile
index 7f51bad3a1..103226d079 100644
--- a/autogpt_platform/backend/Dockerfile
+++ b/autogpt_platform/backend/Dockerfile
@@ -48,7 +48,8 @@ RUN poetry install --no-ansi --no-root
 # Generate Prisma client
 COPY autogpt_platform/backend/schema.prisma ./
 COPY autogpt_platform/backend/backend/data/partial_types.py ./backend/data/partial_types.py
-RUN poetry run prisma generate
+COPY autogpt_platform/backend/gen_prisma_types_stub.py ./
+RUN poetry run prisma generate && poetry run gen-prisma-stub
 
 FROM debian:13-slim AS server_dependencies
 
@@ -99,6 +100,7 @@ COPY autogpt_platform/backend/migrations /app/autogpt_platform/backend/migration
 FROM server_dependencies AS server
 
 COPY autogpt_platform/backend /app/autogpt_platform/backend
+COPY docs /app/docs
 RUN poetry install --no-ansi --only-root
 
 ENV PORT=8000
diff --git a/autogpt_platform/backend/backend/api/external/v1/tools.py b/autogpt_platform/backend/backend/api/external/v1/tools.py
index 9e362fb32c..07734dd0c9 100644
--- a/autogpt_platform/backend/backend/api/external/v1/tools.py
+++ b/autogpt_platform/backend/backend/api/external/v1/tools.py
@@ -70,7 +70,7 @@ class RunAgentRequest(BaseModel):
     )
 
 
-def _create_ephemeral_session(user_id: str | None) -> ChatSession:
+def _create_ephemeral_session(user_id: str) -> ChatSession:
     """Create an ephemeral session for stateless API requests."""
     return ChatSession.new(user_id)
 
diff --git a/autogpt_platform/backend/backend/api/features/admin/execution_analytics_routes.py b/autogpt_platform/backend/backend/api/features/admin/execution_analytics_routes.py
index 00f0bda884..45912dae67 100644
--- a/autogpt_platform/backend/backend/api/features/admin/execution_analytics_routes.py
+++ b/autogpt_platform/backend/backend/api/features/admin/execution_analytics_routes.py
@@ -28,6 +28,7 @@ from backend.executor.manager import get_db_async_client
 from backend.util.settings import Settings
 
 logger = logging.getLogger(__name__)
+settings = Settings()
 
 
 class ExecutionAnalyticsRequest(BaseModel):
@@ -63,6 +64,8 @@ class ExecutionAnalyticsResult(BaseModel):
     score: Optional[float]
     status: str  # "success", "failed", "skipped"
     error_message: Optional[str] = None
+    started_at: Optional[datetime] = None
+    ended_at: Optional[datetime] = None
 
 
 class ExecutionAnalyticsResponse(BaseModel):
@@ -224,11 +227,6 @@ async def generate_execution_analytics(
     )
 
     try:
-        # Validate model configuration
-        settings = Settings()
-        if not settings.secrets.openai_internal_api_key:
-            raise HTTPException(status_code=500, detail="OpenAI API key not configured")
-
         # Get database client
         db_client = get_db_async_client()
 
@@ -320,6 +318,8 @@ async def generate_execution_analytics(
                     ),
                     status="skipped",
                     error_message=None,  # Not an error - just already processed
+                    started_at=execution.started_at,
+                    ended_at=execution.ended_at,
                 )
             )
 
@@ -349,6 +349,9 @@ async def _process_batch(
 ) -> list[ExecutionAnalyticsResult]:
     """Process a batch of executions concurrently."""
 
+    if not settings.secrets.openai_internal_api_key:
+        raise HTTPException(status_code=500, detail="OpenAI API key not configured")
+
     async def process_single_execution(execution) -> ExecutionAnalyticsResult:
         try:
             # Generate activity status and score using the specified model
@@ -387,6 +390,8 @@ async def _process_batch(
                     score=None,
                     status="skipped",
                     error_message="Activity generation returned None",
+                    started_at=execution.started_at,
+                    ended_at=execution.ended_at,
                 )
 
             # Update the execution stats
@@ -416,6 +421,8 @@ async def _process_batch(
                 summary_text=activity_response["activity_status"],
                 score=activity_response["correctness_score"],
                 status="success",
+                started_at=execution.started_at,
+                ended_at=execution.ended_at,
             )
 
         except Exception as e:
@@ -429,6 +436,8 @@ async def _process_batch(
                 score=None,
                 status="failed",
                 error_message=str(e),
+                started_at=execution.started_at,
+                ended_at=execution.ended_at,
             )
 
     # Process all executions in the batch concurrently
diff --git a/autogpt_platform/backend/backend/api/features/chat/config.py b/autogpt_platform/backend/backend/api/features/chat/config.py
index 5b8f16298e..95aef7f2ed 100644
--- a/autogpt_platform/backend/backend/api/features/chat/config.py
+++ b/autogpt_platform/backend/backend/api/features/chat/config.py
@@ -1,7 +1,6 @@
 """Configuration management for chat system."""
 
 import os
-from pathlib import Path
 
 from pydantic import Field, field_validator
 from pydantic_settings import BaseSettings
@@ -12,7 +11,11 @@ class ChatConfig(BaseSettings):
 
     # OpenAI API Configuration
     model: str = Field(
-        default="qwen/qwen3-235b-a22b-2507", description="Default model to use"
+        default="anthropic/claude-opus-4.5", description="Default model to use"
+    )
+    title_model: str = Field(
+        default="openai/gpt-4o-mini",
+        description="Model to use for generating session titles (should be fast/cheap)",
     )
     api_key: str | None = Field(default=None, description="OpenAI API key")
     base_url: str | None = Field(
@@ -23,12 +26,6 @@ class ChatConfig(BaseSettings):
     # Session TTL Configuration - 12 hours
     session_ttl: int = Field(default=43200, description="Session TTL in seconds")
 
-    # System Prompt Configuration
-    system_prompt_path: str = Field(
-        default="prompts/chat_system.md",
-        description="Path to system prompt file relative to chat module",
-    )
-
     # Streaming Configuration
     max_context_messages: int = Field(
         default=50, ge=1, le=200, description="Maximum context messages"
@@ -41,6 +38,13 @@ class ChatConfig(BaseSettings):
         default=3, description="Maximum number of agent schedules"
     )
 
+    # Langfuse Prompt Management Configuration
+    # Note: Langfuse credentials are in Settings().secrets (settings.py)
+    langfuse_prompt_name: str = Field(
+        default="CoPilot Prompt",
+        description="Name of the prompt in Langfuse to fetch",
+    )
+
     @field_validator("api_key", mode="before")
     @classmethod
     def get_api_key(cls, v):
@@ -72,43 +76,11 @@ class ChatConfig(BaseSettings):
                 v = "https://openrouter.ai/api/v1"
         return v
 
-    def get_system_prompt(self, **template_vars) -> str:
-        """Load and render the system prompt from file.
-
-        Args:
-            **template_vars: Variables to substitute in the template
-
-        Returns:
-            Rendered system prompt string
-
-        """
-        # Get the path relative to this module
-        module_dir = Path(__file__).parent
-        prompt_path = module_dir / self.system_prompt_path
-
-        # Check for .j2 extension first (Jinja2 template)
-        j2_path = Path(str(prompt_path) + ".j2")
-        if j2_path.exists():
-            try:
-                from jinja2 import Template
-
-                template = Template(j2_path.read_text())
-                return template.render(**template_vars)
-            except ImportError:
-                # Jinja2 not installed, fall back to reading as plain text
-                return j2_path.read_text()
-
-        # Check for markdown file
-        if prompt_path.exists():
-            content = prompt_path.read_text()
-
-            # Simple variable substitution if Jinja2 is not available
-            for key, value in template_vars.items():
-                placeholder = f"{{{key}}}"
-                content = content.replace(placeholder, str(value))
-
-            return content
-        raise FileNotFoundError(f"System prompt file not found: {prompt_path}")
+    # Prompt paths for different contexts
+    PROMPT_PATHS: dict[str, str] = {
+        "default": "prompts/chat_system.md",
+        "onboarding": "prompts/onboarding_system.md",
+    }
 
     class Config:
         """Pydantic config."""
diff --git a/autogpt_platform/backend/backend/api/features/chat/db.py b/autogpt_platform/backend/backend/api/features/chat/db.py
new file mode 100644
index 0000000000..05a3553cc8
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/chat/db.py
@@ -0,0 +1,249 @@
+"""Database operations for chat sessions."""
+
+import asyncio
+import logging
+from datetime import UTC, datetime
+from typing import Any, cast
+
+from prisma.models import ChatMessage as PrismaChatMessage
+from prisma.models import ChatSession as PrismaChatSession
+from prisma.types import (
+    ChatMessageCreateInput,
+    ChatSessionCreateInput,
+    ChatSessionUpdateInput,
+    ChatSessionWhereInput,
+)
+
+from backend.data.db import transaction
+from backend.util.json import SafeJson
+
+logger = logging.getLogger(__name__)
+
+
+async def get_chat_session(session_id: str) -> PrismaChatSession | None:
+    """Get a chat session by ID from the database."""
+    session = await PrismaChatSession.prisma().find_unique(
+        where={"id": session_id},
+        include={"Messages": True},
+    )
+    if session and session.Messages:
+        # Sort messages by sequence in Python - Prisma Python client doesn't support
+        # order_by in include clauses (unlike Prisma JS), so we sort after fetching
+        session.Messages.sort(key=lambda m: m.sequence)
+    return session
+
+
+async def create_chat_session(
+    session_id: str,
+    user_id: str,
+) -> PrismaChatSession:
+    """Create a new chat session in the database."""
+    data = ChatSessionCreateInput(
+        id=session_id,
+        userId=user_id,
+        credentials=SafeJson({}),
+        successfulAgentRuns=SafeJson({}),
+        successfulAgentSchedules=SafeJson({}),
+    )
+    return await PrismaChatSession.prisma().create(
+        data=data,
+        include={"Messages": True},
+    )
+
+
+async def update_chat_session(
+    session_id: str,
+    credentials: dict[str, Any] | None = None,
+    successful_agent_runs: dict[str, Any] | None = None,
+    successful_agent_schedules: dict[str, Any] | None = None,
+    total_prompt_tokens: int | None = None,
+    total_completion_tokens: int | None = None,
+    title: str | None = None,
+) -> PrismaChatSession | None:
+    """Update a chat session's metadata."""
+    data: ChatSessionUpdateInput = {"updatedAt": datetime.now(UTC)}
+
+    if credentials is not None:
+        data["credentials"] = SafeJson(credentials)
+    if successful_agent_runs is not None:
+        data["successfulAgentRuns"] = SafeJson(successful_agent_runs)
+    if successful_agent_schedules is not None:
+        data["successfulAgentSchedules"] = SafeJson(successful_agent_schedules)
+    if total_prompt_tokens is not None:
+        data["totalPromptTokens"] = total_prompt_tokens
+    if total_completion_tokens is not None:
+        data["totalCompletionTokens"] = total_completion_tokens
+    if title is not None:
+        data["title"] = title
+
+    session = await PrismaChatSession.prisma().update(
+        where={"id": session_id},
+        data=data,
+        include={"Messages": True},
+    )
+    if session and session.Messages:
+        # Sort in Python - Prisma Python doesn't support order_by in include clauses
+        session.Messages.sort(key=lambda m: m.sequence)
+    return session
+
+
+async def add_chat_message(
+    session_id: str,
+    role: str,
+    sequence: int,
+    content: str | None = None,
+    name: str | None = None,
+    tool_call_id: str | None = None,
+    refusal: str | None = None,
+    tool_calls: list[dict[str, Any]] | None = None,
+    function_call: dict[str, Any] | None = None,
+) -> PrismaChatMessage:
+    """Add a message to a chat session."""
+    # Build input dict dynamically rather than using ChatMessageCreateInput directly
+    # because Prisma's TypedDict validation rejects optional fields set to None.
+    # We only include fields that have values, then cast at the end.
+    data: dict[str, Any] = {
+        "Session": {"connect": {"id": session_id}},
+        "role": role,
+        "sequence": sequence,
+    }
+
+    # Add optional string fields
+    if content is not None:
+        data["content"] = content
+    if name is not None:
+        data["name"] = name
+    if tool_call_id is not None:
+        data["toolCallId"] = tool_call_id
+    if refusal is not None:
+        data["refusal"] = refusal
+
+    # Add optional JSON fields only when they have values
+    if tool_calls is not None:
+        data["toolCalls"] = SafeJson(tool_calls)
+    if function_call is not None:
+        data["functionCall"] = SafeJson(function_call)
+
+    # Run message create and session timestamp update in parallel for lower latency
+    _, message = await asyncio.gather(
+        PrismaChatSession.prisma().update(
+            where={"id": session_id},
+            data={"updatedAt": datetime.now(UTC)},
+        ),
+        PrismaChatMessage.prisma().create(data=cast(ChatMessageCreateInput, data)),
+    )
+    return message
+
+
+async def add_chat_messages_batch(
+    session_id: str,
+    messages: list[dict[str, Any]],
+    start_sequence: int,
+) -> list[PrismaChatMessage]:
+    """Add multiple messages to a chat session in a batch.
+
+    Uses a transaction for atomicity - if any message creation fails,
+    the entire batch is rolled back.
+    """
+    if not messages:
+        return []
+
+    created_messages = []
+
+    async with transaction() as tx:
+        for i, msg in enumerate(messages):
+            # Build input dict dynamically rather than using ChatMessageCreateInput
+            # directly because Prisma's TypedDict validation rejects optional fields
+            # set to None. We only include fields that have values, then cast.
+            data: dict[str, Any] = {
+                "Session": {"connect": {"id": session_id}},
+                "role": msg["role"],
+                "sequence": start_sequence + i,
+            }
+
+            # Add optional string fields
+            if msg.get("content") is not None:
+                data["content"] = msg["content"]
+            if msg.get("name") is not None:
+                data["name"] = msg["name"]
+            if msg.get("tool_call_id") is not None:
+                data["toolCallId"] = msg["tool_call_id"]
+            if msg.get("refusal") is not None:
+                data["refusal"] = msg["refusal"]
+
+            # Add optional JSON fields only when they have values
+            if msg.get("tool_calls") is not None:
+                data["toolCalls"] = SafeJson(msg["tool_calls"])
+            if msg.get("function_call") is not None:
+                data["functionCall"] = SafeJson(msg["function_call"])
+
+            created = await PrismaChatMessage.prisma(tx).create(
+                data=cast(ChatMessageCreateInput, data)
+            )
+            created_messages.append(created)
+
+        # Update session's updatedAt timestamp within the same transaction.
+        # Note: Token usage (total_prompt_tokens, total_completion_tokens) is updated
+        # separately via update_chat_session() after streaming completes.
+        await PrismaChatSession.prisma(tx).update(
+            where={"id": session_id},
+            data={"updatedAt": datetime.now(UTC)},
+        )
+
+    return created_messages
+
+
+async def get_user_chat_sessions(
+    user_id: str,
+    limit: int = 50,
+    offset: int = 0,
+) -> list[PrismaChatSession]:
+    """Get chat sessions for a user, ordered by most recent."""
+    return await PrismaChatSession.prisma().find_many(
+        where={"userId": user_id},
+        order={"updatedAt": "desc"},
+        take=limit,
+        skip=offset,
+    )
+
+
+async def get_user_session_count(user_id: str) -> int:
+    """Get the total number of chat sessions for a user."""
+    return await PrismaChatSession.prisma().count(where={"userId": user_id})
+
+
+async def delete_chat_session(session_id: str, user_id: str | None = None) -> bool:
+    """Delete a chat session and all its messages.
+
+    Args:
+        session_id: The session ID to delete.
+        user_id: If provided, validates that the session belongs to this user
+            before deletion. This prevents unauthorized deletion of other
+            users' sessions.
+
+    Returns:
+        True if deleted successfully, False otherwise.
+    """
+    try:
+        # Build typed where clause with optional user_id validation
+        where_clause: ChatSessionWhereInput = {"id": session_id}
+        if user_id is not None:
+            where_clause["userId"] = user_id
+
+        result = await PrismaChatSession.prisma().delete_many(where=where_clause)
+        if result == 0:
+            logger.warning(
+                f"No session deleted for {session_id} "
+                f"(user_id validation: {user_id is not None})"
+            )
+            return False
+        return True
+    except Exception as e:
+        logger.error(f"Failed to delete chat session {session_id}: {e}")
+        return False
+
+
+async def get_chat_session_message_count(session_id: str) -> int:
+    """Get the number of messages in a chat session."""
+    count = await PrismaChatMessage.prisma().count(where={"sessionId": session_id})
+    return count
diff --git a/autogpt_platform/backend/backend/api/features/chat/model.py b/autogpt_platform/backend/backend/api/features/chat/model.py
index b8aea5a334..ec4cf1fc8b 100644
--- a/autogpt_platform/backend/backend/api/features/chat/model.py
+++ b/autogpt_platform/backend/backend/api/features/chat/model.py
@@ -1,6 +1,9 @@
+import asyncio
 import logging
 import uuid
 from datetime import UTC, datetime
+from typing import Any
+from weakref import WeakValueDictionary
 
 from openai.types.chat import (
     ChatCompletionAssistantMessageParam,
@@ -16,17 +19,63 @@ from openai.types.chat.chat_completion_message_tool_call_param import (
     ChatCompletionMessageToolCallParam,
     Function,
 )
+from prisma.models import ChatMessage as PrismaChatMessage
+from prisma.models import ChatSession as PrismaChatSession
 from pydantic import BaseModel
 
 from backend.data.redis_client import get_redis_async
-from backend.util.exceptions import RedisError
+from backend.util import json
+from backend.util.exceptions import DatabaseError, RedisError
 
+from . import db as chat_db
 from .config import ChatConfig
 
 logger = logging.getLogger(__name__)
 config = ChatConfig()
 
 
+def _parse_json_field(value: str | dict | list | None, default: Any = None) -> Any:
+    """Parse a JSON field that may be stored as string or already parsed."""
+    if value is None:
+        return default
+    if isinstance(value, str):
+        return json.loads(value)
+    return value
+
+
+# Redis cache key prefix for chat sessions
+CHAT_SESSION_CACHE_PREFIX = "chat:session:"
+
+
+def _get_session_cache_key(session_id: str) -> str:
+    """Get the Redis cache key for a chat session."""
+    return f"{CHAT_SESSION_CACHE_PREFIX}{session_id}"
+
+
+# Session-level locks to prevent race conditions during concurrent upserts.
+# Uses WeakValueDictionary to automatically garbage collect locks when no longer referenced,
+# preventing unbounded memory growth while maintaining lock semantics for active sessions.
+# Invalidation: Locks are auto-removed by GC when no coroutine holds a reference (after
+# async with lock: completes). Explicit cleanup also occurs in delete_chat_session().
+_session_locks: WeakValueDictionary[str, asyncio.Lock] = WeakValueDictionary()
+_session_locks_mutex = asyncio.Lock()
+
+
+async def _get_session_lock(session_id: str) -> asyncio.Lock:
+    """Get or create a lock for a specific session to prevent concurrent upserts.
+
+    Uses WeakValueDictionary for automatic cleanup: locks are garbage collected
+    when no coroutine holds a reference to them, preventing memory leaks from
+    unbounded growth of session locks.
+    """
+    async with _session_locks_mutex:
+        lock = _session_locks.get(session_id)
+        if lock is None:
+            lock = asyncio.Lock()
+            _session_locks[session_id] = lock
+        return lock
+
+
 class ChatMessage(BaseModel):
     role: str
     content: str | None = None
@@ -45,7 +94,8 @@ class Usage(BaseModel):
 
 class ChatSession(BaseModel):
     session_id: str
-    user_id: str | None
+    user_id: str
+    title: str | None = None
     messages: list[ChatMessage]
     usage: list[Usage]
     credentials: dict[str, dict] = {}  # Map of provider -> credential metadata
@@ -55,10 +105,11 @@ class ChatSession(BaseModel):
     successful_agent_schedules: dict[str, int] = {}
 
     @staticmethod
-    def new(user_id: str | None) -> "ChatSession":
+    def new(user_id: str) -> "ChatSession":
         return ChatSession(
             session_id=str(uuid.uuid4()),
             user_id=user_id,
+            title=None,
             messages=[],
             usage=[],
             credentials={},
@@ -66,6 +117,61 @@ class ChatSession(BaseModel):
             updated_at=datetime.now(UTC),
         )
 
+    @staticmethod
+    def from_db(
+        prisma_session: PrismaChatSession,
+        prisma_messages: list[PrismaChatMessage] | None = None,
+    ) -> "ChatSession":
+        """Convert Prisma models to Pydantic ChatSession."""
+        messages = []
+        if prisma_messages:
+            for msg in prisma_messages:
+                messages.append(
+                    ChatMessage(
+                        role=msg.role,
+                        content=msg.content,
+                        name=msg.name,
+                        tool_call_id=msg.toolCallId,
+                        refusal=msg.refusal,
+                        tool_calls=_parse_json_field(msg.toolCalls),
+                        function_call=_parse_json_field(msg.functionCall),
+                    )
+                )
+
+        # Parse JSON fields from Prisma
+        credentials = _parse_json_field(prisma_session.credentials, default={})
+        successful_agent_runs = _parse_json_field(
+            prisma_session.successfulAgentRuns, default={}
+        )
+        successful_agent_schedules = _parse_json_field(
+            prisma_session.successfulAgentSchedules, default={}
+        )
+
+        # Calculate usage from token counts
+        usage = []
+        if prisma_session.totalPromptTokens or prisma_session.totalCompletionTokens:
+            usage.append(
+                Usage(
+                    prompt_tokens=prisma_session.totalPromptTokens or 0,
+                    completion_tokens=prisma_session.totalCompletionTokens or 0,
+                    total_tokens=(prisma_session.totalPromptTokens or 0)
+                    + (prisma_session.totalCompletionTokens or 0),
+                )
+            )
+
+        return ChatSession(
+            session_id=prisma_session.id,
+            user_id=prisma_session.userId,
+            title=prisma_session.title,
+            messages=messages,
+            usage=usage,
+            credentials=credentials,
+            started_at=prisma_session.createdAt,
+            updated_at=prisma_session.updatedAt,
+            successful_agent_runs=successful_agent_runs,
+            successful_agent_schedules=successful_agent_schedules,
+        )
+
     def to_openai_messages(self) -> list[ChatCompletionMessageParam]:
         messages = []
         for message in self.messages:
@@ -155,50 +261,337 @@ class ChatSession(BaseModel):
         return messages
 
 
-async def get_chat_session(
-    session_id: str,
-    user_id: str | None,
-) -> ChatSession | None:
-    """Get a chat session by ID."""
-    redis_key = f"chat:session:{session_id}"
+async def _get_session_from_cache(session_id: str) -> ChatSession | None:
+    """Get a chat session from Redis cache."""
+    redis_key = _get_session_cache_key(session_id)
     async_redis = await get_redis_async()
-
     raw_session: bytes | None = await async_redis.get(redis_key)
 
     if raw_session is None:
-        logger.warning(f"Session {session_id} not found in Redis")
         return None
 
     try:
         session = ChatSession.model_validate_json(raw_session)
+        logger.info(
+            f"Loading session {session_id} from cache: "
+            f"message_count={len(session.messages)}, "
+            f"roles={[m.role for m in session.messages]}"
+        )
+        return session
     except Exception as e:
         logger.error(f"Failed to deserialize session {session_id}: {e}", exc_info=True)
         raise RedisError(f"Corrupted session data for {session_id}") from e
 
-    if session.user_id is not None and session.user_id != user_id:
+
+async def _cache_session(session: ChatSession) -> None:
+    """Cache a chat session in Redis."""
+    redis_key = _get_session_cache_key(session.session_id)
+    async_redis = await get_redis_async()
+    await async_redis.setex(redis_key, config.session_ttl, session.model_dump_json())
+
+
+async def _get_session_from_db(session_id: str) -> ChatSession | None:
+    """Get a chat session from the database."""
+    prisma_session = await chat_db.get_chat_session(session_id)
+    if not prisma_session:
+        return None
+
+    messages = prisma_session.Messages
+    logger.info(
+        f"Loading session {session_id} from DB: "
+        f"has_messages={messages is not None}, "
+        f"message_count={len(messages) if messages else 0}, "
+        f"roles={[m.role for m in messages] if messages else []}"
+    )
+
+    return ChatSession.from_db(prisma_session, messages)
+
+
+async def _save_session_to_db(
+    session: ChatSession, existing_message_count: int
+) -> None:
+    """Save or update a chat session in the database."""
+    # Check if session exists in DB
+    existing = await chat_db.get_chat_session(session.session_id)
+
+    if not existing:
+        # Create new session
+        await chat_db.create_chat_session(
+            session_id=session.session_id,
+            user_id=session.user_id,
+        )
+        existing_message_count = 0
+
+    # Calculate total tokens from usage
+    total_prompt = sum(u.prompt_tokens for u in session.usage)
+    total_completion = sum(u.completion_tokens for u in session.usage)
+
+    # Update session metadata
+    await chat_db.update_chat_session(
+        session_id=session.session_id,
+        credentials=session.credentials,
+        successful_agent_runs=session.successful_agent_runs,
+        successful_agent_schedules=session.successful_agent_schedules,
+        total_prompt_tokens=total_prompt,
+        total_completion_tokens=total_completion,
+    )
+
+    # Add new messages (only those after existing count)
+    new_messages = session.messages[existing_message_count:]
+    if new_messages:
+        messages_data = []
+        for msg in new_messages:
+            messages_data.append(
+                {
+                    "role": msg.role,
+                    "content": msg.content,
+                    "name": msg.name,
+                    "tool_call_id": msg.tool_call_id,
+                    "refusal": msg.refusal,
+                    "tool_calls": msg.tool_calls,
+                    "function_call": msg.function_call,
+                }
+            )
+        logger.info(
+            f"Saving {len(new_messages)} new messages to DB for session {session.session_id}: "
+            f"roles={[m['role'] for m in messages_data]}, "
+            f"start_sequence={existing_message_count}"
+        )
+        await chat_db.add_chat_messages_batch(
+            session_id=session.session_id,
+            messages=messages_data,
+            start_sequence=existing_message_count,
+        )
+
+
+async def get_chat_session(
+    session_id: str,
+    user_id: str | None = None,
+) -> ChatSession | None:
+    """Get a chat session by ID.
+
+    Checks Redis cache first, falls back to database if not found.
+    Caches database results back to Redis.
+
+    Args:
+        session_id: The session ID to fetch.
+        user_id: If provided, validates that the session belongs to this user.
+            If None, ownership is not validated (admin/system access).
+    """
+    # Try cache first
+    try:
+        session = await _get_session_from_cache(session_id)
+        if session:
+            # Verify user ownership if user_id was provided for validation
+            if user_id is not None and session.user_id != user_id:
+                logger.warning(
+                    f"Session {session_id} user id mismatch: {session.user_id} != {user_id}"
+                )
+                return None
+            return session
+    except RedisError:
+        logger.warning(f"Cache error for session {session_id}, trying database")
+    except Exception as e:
+        logger.warning(f"Unexpected cache error for session {session_id}: {e}")
+
+    # Fall back to database
+    logger.info(f"Session {session_id} not in cache, checking database")
+    session = await _get_session_from_db(session_id)
+
+    if session is None:
+        logger.warning(f"Session {session_id} not found in cache or database")
+        return None
+
+    # Verify user ownership if user_id was provided for validation
+    if user_id is not None and session.user_id != user_id:
         logger.warning(
             f"Session {session_id} user id mismatch: {session.user_id} != {user_id}"
         )
         return None
 
+    # Cache the session from DB
+    try:
+        await _cache_session(session)
+        logger.info(f"Cached session {session_id} from database")
+    except Exception as e:
+        logger.warning(f"Failed to cache session {session_id}: {e}")
+
     return session
 
 
 async def upsert_chat_session(
     session: ChatSession,
 ) -> ChatSession:
-    """Update a chat session with the given messages."""
+    """Update a chat session in both cache and database.
 
-    redis_key = f"chat:session:{session.session_id}"
+    Uses session-level locking to prevent race conditions when concurrent
+    operations (e.g., background title update and main stream handler)
+    attempt to upsert the same session simultaneously.
 
-    async_redis = await get_redis_async()
-    resp = await async_redis.setex(
-        redis_key, config.session_ttl, session.model_dump_json()
-    )
+    Raises:
+        DatabaseError: If the database write fails. The cache is still updated
+            as a best-effort optimization, but the error is propagated to ensure
+            callers are aware of the persistence failure.
+        RedisError: If the cache write fails (after successful DB write).
+    """
+    # Acquire session-specific lock to prevent concurrent upserts
+    lock = await _get_session_lock(session.session_id)
 
-    if not resp:
-        raise RedisError(
-            f"Failed to persist chat session {session.session_id} to Redis: {resp}"
+    async with lock:
+        # Get existing message count from DB for incremental saves
+        existing_message_count = await chat_db.get_chat_session_message_count(
+            session.session_id
         )
 
+        db_error: Exception | None = None
+
+        # Save to database (primary storage)
+        try:
+            await _save_session_to_db(session, existing_message_count)
+        except Exception as e:
+            logger.error(
+                f"Failed to save session {session.session_id} to database: {e}"
+            )
+            db_error = e
+
+        # Save to cache (best-effort, even if DB failed)
+        try:
+            await _cache_session(session)
+        except Exception as e:
+            # If DB succeeded but cache failed, raise cache error
+            if db_error is None:
+                raise RedisError(
+                    f"Failed to persist chat session {session.session_id} to Redis: {e}"
+                ) from e
+            # If both failed, log cache error but raise DB error (more critical)
+            logger.warning(
+                f"Cache write also failed for session {session.session_id}: {e}"
+            )
+
+        # Propagate DB error after attempting cache (prevents data loss)
+        if db_error is not None:
+            raise DatabaseError(
+                f"Failed to persist chat session {session.session_id} to database"
+            ) from db_error
+
+        return session
+
+
+async def create_chat_session(user_id: str) -> ChatSession:
+    """Create a new chat session and persist it.
+
+    Raises:
+        DatabaseError: If the database write fails. We fail fast to ensure
+            callers never receive a non-persisted session that only exists
+            in cache (which would be lost when the cache expires).
+    """
+    session = ChatSession.new(user_id)
+
+    # Create in database first - fail fast if this fails
+    try:
+        await chat_db.create_chat_session(
+            session_id=session.session_id,
+            user_id=user_id,
+        )
+    except Exception as e:
+        logger.error(f"Failed to create session {session.session_id} in database: {e}")
+        raise DatabaseError(
+            f"Failed to create chat session {session.session_id} in database"
+        ) from e
+
+    # Cache the session (best-effort optimization, DB is source of truth)
+    try:
+        await _cache_session(session)
+    except Exception as e:
+        logger.warning(f"Failed to cache new session {session.session_id}: {e}")
+
     return session
+
+
+async def get_user_sessions(
+    user_id: str,
+    limit: int = 50,
+    offset: int = 0,
+) -> tuple[list[ChatSession], int]:
+    """Get chat sessions for a user from the database with total count.
+
+    Returns:
+        A tuple of (sessions, total_count) where total_count is the overall
+        number of sessions for the user (not just the current page).
+    """
+    prisma_sessions = await chat_db.get_user_chat_sessions(user_id, limit, offset)
+    total_count = await chat_db.get_user_session_count(user_id)
+
+    sessions = []
+    for prisma_session in prisma_sessions:
+        # Convert without messages for listing (lighter weight)
+        sessions.append(ChatSession.from_db(prisma_session, None))
+
+    return sessions, total_count
+
+
+async def delete_chat_session(session_id: str, user_id: str | None = None) -> bool:
+    """Delete a chat session from both cache and database.
+
+    Args:
+        session_id: The session ID to delete.
+        user_id: If provided, validates that the session belongs to this user
+            before deletion. This prevents unauthorized deletion.
+
+    Returns:
+        True if deleted successfully, False otherwise.
+    """
+    # Delete from database first (with optional user_id validation)
+    # This confirms ownership before invalidating cache
+    deleted = await chat_db.delete_chat_session(session_id, user_id)
+
+    if not deleted:
+        return False
+
+    # Only invalidate cache and clean up lock after DB confirms deletion
+    try:
+        redis_key = _get_session_cache_key(session_id)
+        async_redis = await get_redis_async()
+        await async_redis.delete(redis_key)
+    except Exception as e:
+        logger.warning(f"Failed to delete session {session_id} from cache: {e}")
+
+    # Clean up session lock (belt-and-suspenders with WeakValueDictionary)
+    async with _session_locks_mutex:
+        _session_locks.pop(session_id, None)
+
+    return True
+
+
+async def update_session_title(session_id: str, title: str) -> bool:
+    """Update only the title of a chat session.
+
+    This is a lightweight operation that doesn't touch messages, avoiding
+    race conditions with concurrent message updates. Use this for background
+    title generation instead of upsert_chat_session.
+
+    Args:
+        session_id: The session ID to update.
+        title: The new title to set.
+
+    Returns:
+        True if updated successfully, False otherwise.
+    """
+    try:
+        result = await chat_db.update_chat_session(session_id=session_id, title=title)
+        if result is None:
+            logger.warning(f"Session {session_id} not found for title update")
+            return False
+
+        # Invalidate cache so next fetch gets updated title
+        try:
+            redis_key = _get_session_cache_key(session_id)
+            async_redis = await get_redis_async()
+            await async_redis.delete(redis_key)
+        except Exception as e:
+            logger.warning(f"Failed to invalidate cache for session {session_id}: {e}")
+
+        return True
+    except Exception as e:
+        logger.error(f"Failed to update title for session {session_id}: {e}")
+        return False
diff --git a/autogpt_platform/backend/backend/api/features/chat/model_test.py b/autogpt_platform/backend/backend/api/features/chat/model_test.py
index b7f4c8a493..c230b00f9c 100644
--- a/autogpt_platform/backend/backend/api/features/chat/model_test.py
+++ b/autogpt_platform/backend/backend/api/features/chat/model_test.py
@@ -43,9 +43,9 @@ async def test_chatsession_serialization_deserialization():
 
 
 @pytest.mark.asyncio(loop_scope="session")
-async def test_chatsession_redis_storage():
+async def test_chatsession_redis_storage(setup_test_user, test_user_id):
 
-    s = ChatSession.new(user_id=None)
+    s = ChatSession.new(user_id=test_user_id)
     s.messages = messages
 
     s = await upsert_chat_session(s)
@@ -59,12 +59,61 @@ async def test_chatsession_redis_storage():
 
 
 @pytest.mark.asyncio(loop_scope="session")
-async def test_chatsession_redis_storage_user_id_mismatch():
+async def test_chatsession_redis_storage_user_id_mismatch(
+    setup_test_user, test_user_id
+):
 
-    s = ChatSession.new(user_id="abc123")
+    s = ChatSession.new(user_id=test_user_id)
     s.messages = messages
     s = await upsert_chat_session(s)
 
-    s2 = await get_chat_session(s.session_id, None)
+    s2 = await get_chat_session(s.session_id, "different_user_id")
 
     assert s2 is None
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_chatsession_db_storage(setup_test_user, test_user_id):
+    """Test that messages are correctly saved to and loaded from DB (not cache)."""
+    from backend.data.redis_client import get_redis_async
+
+    # Create session with messages including assistant message
+    s = ChatSession.new(user_id=test_user_id)
+    s.messages = messages  # Contains user, assistant, and tool messages
+    assert s.session_id is not None, "Session id is not set"
+    # Upsert to save to both cache and DB
+    s = await upsert_chat_session(s)
+
+    # Clear the Redis cache to force DB load
+    redis_key = f"chat:session:{s.session_id}"
+    async_redis = await get_redis_async()
+    await async_redis.delete(redis_key)
+
+    # Load from DB (cache was cleared)
+    s2 = await get_chat_session(
+        session_id=s.session_id,
+        user_id=s.user_id,
+    )
+
+    assert s2 is not None, "Session not found after loading from DB"
+    assert len(s2.messages) == len(
+        s.messages
+    ), f"Message count mismatch: expected {len(s.messages)}, got {len(s2.messages)}"
+
+    # Verify all roles are present
+    roles = [m.role for m in s2.messages]
+    assert "user" in roles, f"User message missing. Roles found: {roles}"
+    assert "assistant" in roles, f"Assistant message missing. Roles found: {roles}"
+    assert "tool" in roles, f"Tool message missing. Roles found: {roles}"
+
+    # Verify message content
+    for orig, loaded in zip(s.messages, s2.messages):
+        assert orig.role == loaded.role, f"Role mismatch: {orig.role} != {loaded.role}"
+        assert (
+            orig.content == loaded.content
+        ), f"Content mismatch for {orig.role}: {orig.content} != {loaded.content}"
+        if orig.tool_calls:
+            assert (
+                loaded.tool_calls is not None
+            ), f"Tool calls missing for {orig.role} message"
+            assert len(orig.tool_calls) == len(loaded.tool_calls)
diff --git a/autogpt_platform/backend/backend/api/features/chat/prompts/chat_system.md b/autogpt_platform/backend/backend/api/features/chat/prompts/chat_system.md
deleted file mode 100644
index a660ca805e..0000000000
--- a/autogpt_platform/backend/backend/api/features/chat/prompts/chat_system.md
+++ /dev/null
@@ -1,104 +0,0 @@
-You are Otto, an AI Co-Pilot and Forward Deployed Engineer for AutoGPT, an AI Business Automation tool. Your mission is to help users quickly find and set up AutoGPT agents to solve their business problems.
-
-Here are the functions available to you:
-
-<functions>
-1. **find_agent** - Search for agents that solve the user's problem
-2. **run_agent** - Run or schedule an agent (automatically handles setup)
-</functions>
-
-## HOW run_agent WORKS
-
-The `run_agent` tool automatically handles the entire setup flow:
-
-1. **First call** (no inputs) → Returns available inputs so user can decide what values to use
-2. **Credentials check** → If missing, UI automatically prompts user to add them (you don't need to mention this)
-3. **Execution** → Runs when you provide `inputs` OR set `use_defaults=true`
-
-Parameters:
-- `username_agent_slug` (required): Agent identifier like "creator/agent-name"
-- `inputs`: Object with input values for the agent
-- `use_defaults`: Set to `true` to run with default values (only after user confirms)
-- `schedule_name` + `cron`: For scheduled execution
-
-## WORKFLOW
-
-1. **find_agent** - Search for agents that solve the user's problem
-2. **run_agent** (first call, no inputs) - Get available inputs for the agent
-3. **Ask user** what values they want to use OR if they want to use defaults
-4. **run_agent** (second call) - Either with `inputs={...}` or `use_defaults=true`
-
-## YOUR APPROACH
-
-**Step 1: Understand the Problem**
-- Ask maximum 1-2 targeted questions
-- Focus on: What business problem are they solving?
-- Move quickly to searching for solutions
-
-**Step 2: Find Agents**
-- Use `find_agent` immediately with relevant keywords
-- Suggest the best option from search results
-- Explain briefly how it solves their problem
-
-**Step 3: Get Agent Inputs**
-- Call `run_agent(username_agent_slug="creator/agent-name")` without inputs
-- This returns the available inputs (required and optional)
-- Present these to the user and ask what values they want
-
-**Step 4: Run with User's Choice**
-- If user provides values: `run_agent(username_agent_slug="...", inputs={...})`
-- If user says "use defaults": `run_agent(username_agent_slug="...", use_defaults=true)`
-- On success, share the agent link with the user
-
-**For Scheduled Execution:**
-- Add `schedule_name` and `cron` parameters
-- Example: `run_agent(username_agent_slug="...", inputs={...}, schedule_name="Daily Report", cron="0 9 * * *")`
-
-## FUNCTION CALL FORMAT
-
-To call a function, use this exact format:
-`<function_call>function_name(parameter="value")</function_call>`
-
-Examples:
-- `<function_call>find_agent(query="social media automation")</function_call>`
-- `<function_call>run_agent(username_agent_slug="creator/agent-name")</function_call>` (get inputs)
-- `<function_call>run_agent(username_agent_slug="creator/agent-name", inputs={"topic": "AI news"})</function_call>`
-- `<function_call>run_agent(username_agent_slug="creator/agent-name", use_defaults=true)</function_call>`
-
-## KEY RULES
-
-**What You DON'T Do:**
-- Don't help with login (frontend handles this)
-- Don't mention or explain credentials to the user (frontend handles this automatically)
-- Don't run agents without first showing available inputs to the user
-- Don't use `use_defaults=true` without user explicitly confirming
-- Don't write responses longer than 3 sentences
-
-**What You DO:**
-- Always call run_agent first without inputs to see what's available
-- Ask user what values they want OR if they want to use defaults
-- Keep all responses to maximum 3 sentences
-- Include the agent link in your response after successful execution
-
-**Error Handling:**
-- Authentication needed → "Please sign in via the interface"
-- Credentials missing → The UI handles this automatically. Focus on asking the user about input values instead.
-
-## RESPONSE STRUCTURE
-
-Before responding, wrap your analysis in <thinking> tags to systematically plan your approach:
-- Extract the key business problem or request from the user's message
-- Determine what function call (if any) you need to make next
-- Plan your response to stay under the 3-sentence maximum
-
-Example interaction:
-```
-User: "Run the AI news agent for me"
-Otto: <function_call>run_agent(username_agent_slug="autogpt/ai-news")</function_call>
-[Tool returns: Agent accepts inputs - Required: topic. Optional: num_articles (default: 5)]
-Otto: The AI News agent needs a topic. What topic would you like news about, or should I use the defaults?
-User: "Use defaults"
-Otto: <function_call>run_agent(username_agent_slug="autogpt/ai-news", use_defaults=true)</function_call>
-```
-
-KEEP ANSWERS TO 3 SENTENCES
diff --git a/autogpt_platform/backend/backend/api/features/chat/response_model.py b/autogpt_platform/backend/backend/api/features/chat/response_model.py
index 2d38820bd5..49a9b38e8f 100644
--- a/autogpt_platform/backend/backend/api/features/chat/response_model.py
+++ b/autogpt_platform/backend/backend/api/features/chat/response_model.py
@@ -1,3 +1,10 @@
+"""
+Response models for Vercel AI SDK UI Stream Protocol.
+
+This module implements the AI SDK UI Stream Protocol (v1) for streaming chat responses.
+See: https://ai-sdk.dev/docs/ai-sdk-ui/stream-protocol
+"""
+
 from enum import Enum
 from typing import Any
 
@@ -5,97 +12,133 @@ from pydantic import BaseModel, Field
 
 
 class ResponseType(str, Enum):
-    """Types of streaming responses."""
+    """Types of streaming responses following AI SDK protocol."""
 
-    TEXT_CHUNK = "text_chunk"
-    TEXT_ENDED = "text_ended"
-    TOOL_CALL = "tool_call"
-    TOOL_CALL_START = "tool_call_start"
-    TOOL_RESPONSE = "tool_response"
+    # Message lifecycle
+    START = "start"
+    FINISH = "finish"
+
+    # Text streaming
+    TEXT_START = "text-start"
+    TEXT_DELTA = "text-delta"
+    TEXT_END = "text-end"
+
+    # Tool interaction
+    TOOL_INPUT_START = "tool-input-start"
+    TOOL_INPUT_AVAILABLE = "tool-input-available"
+    TOOL_OUTPUT_AVAILABLE = "tool-output-available"
+
+    # Other
     ERROR = "error"
     USAGE = "usage"
-    STREAM_END = "stream_end"
 
 
 class StreamBaseResponse(BaseModel):
     """Base response model for all streaming responses."""
 
     type: ResponseType
-    timestamp: str | None = None
 
     def to_sse(self) -> str:
         """Convert to SSE format."""
         return f"data: {self.model_dump_json()}\n\n"
 
 
-class StreamTextChunk(StreamBaseResponse):
-    """Streaming text content from the assistant."""
-
-    type: ResponseType = ResponseType.TEXT_CHUNK
-    content: str = Field(..., description="Text content chunk")
+# ========== Message Lifecycle ==========
 
 
-class StreamToolCallStart(StreamBaseResponse):
+class StreamStart(StreamBaseResponse):
+    """Start of a new message."""
+
+    type: ResponseType = ResponseType.START
+    messageId: str = Field(..., description="Unique message ID")
+
+
+class StreamFinish(StreamBaseResponse):
+    """End of message/stream."""
+
+    type: ResponseType = ResponseType.FINISH
+
+
+# ========== Text Streaming ==========
+
+
+class StreamTextStart(StreamBaseResponse):
+    """Start of a text block."""
+
+    type: ResponseType = ResponseType.TEXT_START
+    id: str = Field(..., description="Text block ID")
+
+
+class StreamTextDelta(StreamBaseResponse):
+    """Streaming text content delta."""
+
+    type: ResponseType = ResponseType.TEXT_DELTA
+    id: str = Field(..., description="Text block ID")
+    delta: str = Field(..., description="Text content delta")
+
+
+class StreamTextEnd(StreamBaseResponse):
+    """End of a text block."""
+
+    type: ResponseType = ResponseType.TEXT_END
+    id: str = Field(..., description="Text block ID")
+
+
+# ========== Tool Interaction ==========
+
+
+class StreamToolInputStart(StreamBaseResponse):
     """Tool call started notification."""
 
-    type: ResponseType = ResponseType.TOOL_CALL_START
-    tool_name: str = Field(..., description="Name of the tool that was executed")
-    tool_id: str = Field(..., description="Unique tool call ID")
+    type: ResponseType = ResponseType.TOOL_INPUT_START
+    toolCallId: str = Field(..., description="Unique tool call ID")
+    toolName: str = Field(..., description="Name of the tool being called")
 
 
-class StreamToolCall(StreamBaseResponse):
-    """Tool invocation notification."""
+class StreamToolInputAvailable(StreamBaseResponse):
+    """Tool input is ready for execution."""
 
-    type: ResponseType = ResponseType.TOOL_CALL
-    tool_id: str = Field(..., description="Unique tool call ID")
-    tool_name: str = Field(..., description="Name of the tool being called")
-    arguments: dict[str, Any] = Field(
-        default_factory=dict, description="Tool arguments"
+    type: ResponseType = ResponseType.TOOL_INPUT_AVAILABLE
+    toolCallId: str = Field(..., description="Unique tool call ID")
+    toolName: str = Field(..., description="Name of the tool being called")
+    input: dict[str, Any] = Field(
+        default_factory=dict, description="Tool input arguments"
     )
 
 
-class StreamToolExecutionResult(StreamBaseResponse):
+class StreamToolOutputAvailable(StreamBaseResponse):
     """Tool execution result."""
 
-    type: ResponseType = ResponseType.TOOL_RESPONSE
-    tool_id: str = Field(..., description="Tool call ID this responds to")
-    tool_name: str = Field(..., description="Name of the tool that was executed")
-    result: str | dict[str, Any] = Field(..., description="Tool execution result")
+    type: ResponseType = ResponseType.TOOL_OUTPUT_AVAILABLE
+    toolCallId: str = Field(..., description="Tool call ID this responds to")
+    output: str | dict[str, Any] = Field(..., description="Tool execution output")
+    # Additional fields for internal use (not part of AI SDK spec but useful)
+    toolName: str | None = Field(
+        default=None, description="Name of the tool that was executed"
+    )
     success: bool = Field(
         default=True, description="Whether the tool execution succeeded"
     )
 
 
+# ========== Other ==========
+
+
 class StreamUsage(StreamBaseResponse):
     """Token usage statistics."""
 
     type: ResponseType = ResponseType.USAGE
-    prompt_tokens: int
-    completion_tokens: int
-    total_tokens: int
+    promptTokens: int = Field(..., description="Number of prompt tokens")
+    completionTokens: int = Field(..., description="Number of completion tokens")
+    totalTokens: int = Field(..., description="Total number of tokens")
 
 
 class StreamError(StreamBaseResponse):
     """Error response."""
 
     type: ResponseType = ResponseType.ERROR
-    message: str = Field(..., description="Error message")
+    errorText: str = Field(..., description="Error message text")
     code: str | None = Field(default=None, description="Error code")
     details: dict[str, Any] | None = Field(
         default=None, description="Additional error details"
     )
-
-
-class StreamTextEnded(StreamBaseResponse):
-    """Text streaming completed marker."""
-
-    type: ResponseType = ResponseType.TEXT_ENDED
-
-
-class StreamEnd(StreamBaseResponse):
-    """End of stream marker."""
-
-    type: ResponseType = ResponseType.STREAM_END
-    summary: dict[str, Any] | None = Field(
-        default=None, description="Stream summary statistics"
-    )
diff --git a/autogpt_platform/backend/backend/api/features/chat/routes.py b/autogpt_platform/backend/backend/api/features/chat/routes.py
index 667335d048..58b017ad5e 100644
--- a/autogpt_platform/backend/backend/api/features/chat/routes.py
+++ b/autogpt_platform/backend/backend/api/features/chat/routes.py
@@ -13,12 +13,25 @@ from backend.util.exceptions import NotFoundError
 
 from . import service as chat_service
 from .config import ChatConfig
+from .model import ChatSession, create_chat_session, get_chat_session, get_user_sessions
 
 config = ChatConfig()
 
 
 logger = logging.getLogger(__name__)
 
+
+async def _validate_and_get_session(
+    session_id: str,
+    user_id: str | None,
+) -> ChatSession:
+    """Validate session exists and belongs to user."""
+    session = await get_chat_session(session_id, user_id)
+    if not session:
+        raise NotFoundError(f"Session {session_id} not found.")
+    return session
+
+
 router = APIRouter(
     tags=["chat"],
 )
@@ -26,6 +39,14 @@ router = APIRouter(
 # ========== Request/Response Models ==========
 
 
+class StreamChatRequest(BaseModel):
+    """Request model for streaming chat with optional context."""
+
+    message: str
+    is_user_message: bool = True
+    context: dict[str, str] | None = None  # {url: str, content: str}
+
+
 class CreateSessionResponse(BaseModel):
     """Response model containing information on a newly created chat session."""
 
@@ -44,22 +65,77 @@ class SessionDetailResponse(BaseModel):
     messages: list[dict]
 
 
+class SessionSummaryResponse(BaseModel):
+    """Response model for a session summary (without messages)."""
+
+    id: str
+    created_at: str
+    updated_at: str
+    title: str | None = None
+
+
+class ListSessionsResponse(BaseModel):
+    """Response model for listing chat sessions."""
+
+    sessions: list[SessionSummaryResponse]
+    total: int
+
+
 # ========== Routes ==========
 
 
+@router.get(
+    "/sessions",
+    dependencies=[Security(auth.requires_user)],
+)
+async def list_sessions(
+    user_id: Annotated[str, Security(auth.get_user_id)],
+    limit: int = Query(default=50, ge=1, le=100),
+    offset: int = Query(default=0, ge=0),
+) -> ListSessionsResponse:
+    """
+    List chat sessions for the authenticated user.
+
+    Returns a paginated list of chat sessions belonging to the current user,
+    ordered by most recently updated.
+
+    Args:
+        user_id: The authenticated user's ID.
+        limit: Maximum number of sessions to return (1-100).
+        offset: Number of sessions to skip for pagination.
+
+    Returns:
+        ListSessionsResponse: List of session summaries and total count.
+    """
+    sessions, total_count = await get_user_sessions(user_id, limit, offset)
+
+    return ListSessionsResponse(
+        sessions=[
+            SessionSummaryResponse(
+                id=session.session_id,
+                created_at=session.started_at.isoformat(),
+                updated_at=session.updated_at.isoformat(),
+                title=session.title,
+            )
+            for session in sessions
+        ],
+        total=total_count,
+    )
+
+
 @router.post(
     "/sessions",
 )
 async def create_session(
-    user_id: Annotated[str | None, Depends(auth.get_user_id)],
+    user_id: Annotated[str, Depends(auth.get_user_id)],
 ) -> CreateSessionResponse:
     """
     Create a new chat session.
 
-    Initiates a new chat session for either an authenticated or anonymous user.
+    Initiates a new chat session for the authenticated user.
 
     Args:
-        user_id: The optional authenticated user ID parsed from the JWT. If missing, creates an anonymous session.
+        user_id: The authenticated user ID parsed from the JWT (required).
 
     Returns:
         CreateSessionResponse: Details of the created session.
@@ -67,15 +143,15 @@ async def create_session(
     """
     logger.info(
         f"Creating session with user_id: "
-        f"...{user_id[-8:] if user_id and len(user_id) > 8 else '<redacted>'}"
+        f"...{user_id[-8:] if len(user_id) > 8 else '<redacted>'}"
     )
 
-    session = await chat_service.create_chat_session(user_id)
+    session = await create_chat_session(user_id)
 
     return CreateSessionResponse(
         id=session.session_id,
         created_at=session.started_at.isoformat(),
-        user_id=session.user_id or None,
+        user_id=session.user_id,
     )
 
 
@@ -99,29 +175,88 @@ async def get_session(
         SessionDetailResponse: Details for the requested session; raises NotFoundError if not found.
 
     """
-    session = await chat_service.get_session(session_id, user_id)
+    session = await get_chat_session(session_id, user_id)
     if not session:
         raise NotFoundError(f"Session {session_id} not found")
+
+    messages = [message.model_dump() for message in session.messages]
+    logger.info(
+        f"Returning session {session_id}: "
+        f"message_count={len(messages)}, "
+        f"roles={[m.get('role') for m in messages]}"
+    )
+
     return SessionDetailResponse(
         id=session.session_id,
         created_at=session.started_at.isoformat(),
         updated_at=session.updated_at.isoformat(),
         user_id=session.user_id or None,
-        messages=[message.model_dump() for message in session.messages],
+        messages=messages,
+    )
+
+
+@router.post(
+    "/sessions/{session_id}/stream",
+)
+async def stream_chat_post(
+    session_id: str,
+    request: StreamChatRequest,
+    user_id: str | None = Depends(auth.get_user_id),
+):
+    """
+    Stream chat responses for a session (POST with context support).
+
+    Streams the AI/completion responses in real time over Server-Sent Events (SSE), including:
+      - Text fragments as they are generated
+      - Tool call UI elements (if invoked)
+      - Tool execution results
+
+    Args:
+        session_id: The chat session identifier to associate with the streamed messages.
+        request: Request body containing message, is_user_message, and optional context.
+        user_id: Optional authenticated user ID.
+    Returns:
+        StreamingResponse: SSE-formatted response chunks.
+
+    """
+    session = await _validate_and_get_session(session_id, user_id)
+
+    async def event_generator() -> AsyncGenerator[str, None]:
+        async for chunk in chat_service.stream_chat_completion(
+            session_id,
+            request.message,
+            is_user_message=request.is_user_message,
+            user_id=user_id,
+            session=session,  # Pass pre-fetched session to avoid double-fetch
+            context=request.context,
+        ):
+            yield chunk.to_sse()
+        # AI SDK protocol termination
+        yield "data: [DONE]\n\n"
+
+    return StreamingResponse(
+        event_generator(),
+        media_type="text/event-stream",
+        headers={
+            "Cache-Control": "no-cache",
+            "Connection": "keep-alive",
+            "X-Accel-Buffering": "no",  # Disable nginx buffering
+            "x-vercel-ai-ui-message-stream": "v1",  # AI SDK protocol header
+        },
     )
 
 
 @router.get(
     "/sessions/{session_id}/stream",
 )
-async def stream_chat(
+async def stream_chat_get(
     session_id: str,
     message: Annotated[str, Query(min_length=1, max_length=10000)],
     user_id: str | None = Depends(auth.get_user_id),
     is_user_message: bool = Query(default=True),
 ):
     """
-    Stream chat responses for a session.
+    Stream chat responses for a session (GET - legacy endpoint).
 
     Streams the AI/completion responses in real time over Server-Sent Events (SSE), including:
       - Text fragments as they are generated
@@ -137,14 +272,7 @@ async def stream_chat(
         StreamingResponse: SSE-formatted response chunks.
 
     """
-    # Validate session exists before starting the stream
-    # This prevents errors after the response has already started
-    session = await chat_service.get_session(session_id, user_id)
-
-    if not session:
-        raise NotFoundError(f"Session {session_id} not found. ")
-    if session.user_id is None and user_id is not None:
-        session = await chat_service.assign_user_to_session(session_id, user_id)
+    session = await _validate_and_get_session(session_id, user_id)
 
     async def event_generator() -> AsyncGenerator[str, None]:
         async for chunk in chat_service.stream_chat_completion(
@@ -155,6 +283,8 @@ async def stream_chat(
             session=session,  # Pass pre-fetched session to avoid double-fetch
         ):
             yield chunk.to_sse()
+        # AI SDK protocol termination
+        yield "data: [DONE]\n\n"
 
     return StreamingResponse(
         event_generator(),
@@ -163,6 +293,7 @@ async def stream_chat(
             "Cache-Control": "no-cache",
             "Connection": "keep-alive",
             "X-Accel-Buffering": "no",  # Disable nginx buffering
+            "x-vercel-ai-ui-message-stream": "v1",  # AI SDK protocol header
         },
     )
 
@@ -201,16 +332,28 @@ async def health_check() -> dict:
     """
     Health check endpoint for the chat service.
 
-    Performs a full cycle test of session creation, assignment, and retrieval. Should always return healthy
+    Performs a full cycle test of session creation and retrieval. Should always return healthy
     if the service and data layer are operational.
 
     Returns:
         dict: A status dictionary indicating health, service name, and API version.
 
     """
-    session = await chat_service.create_chat_session(None)
-    await chat_service.assign_user_to_session(session.session_id, "test_user")
-    await chat_service.get_session(session.session_id, "test_user")
+    from backend.data.user import get_or_create_user
+
+    # Ensure health check user exists (required for FK constraint)
+    health_check_user_id = "health-check-user"
+    await get_or_create_user(
+        {
+            "sub": health_check_user_id,
+            "email": "health-check@system.local",
+            "user_metadata": {"name": "Health Check User"},
+        }
+    )
+
+    # Create and retrieve session to verify full data layer
+    session = await create_chat_session(health_check_user_id)
+    await get_chat_session(session.session_id, health_check_user_id)
 
     return {
         "status": "healthy",
diff --git a/autogpt_platform/backend/backend/api/features/chat/service.py b/autogpt_platform/backend/backend/api/features/chat/service.py
index 2d96d4abcd..93634c47e3 100644
--- a/autogpt_platform/backend/backend/api/features/chat/service.py
+++ b/autogpt_platform/backend/backend/api/features/chat/service.py
@@ -1,13 +1,20 @@
+import asyncio
 import logging
 from collections.abc import AsyncGenerator
-from datetime import UTC, datetime
 from typing import Any
 
 import orjson
-from openai import AsyncOpenAI
+from langfuse import get_client, propagate_attributes
+from langfuse.openai import openai  # type: ignore
+from openai import APIConnectionError, APIError, APIStatusError, RateLimitError
 from openai.types.chat import ChatCompletionChunk, ChatCompletionToolParam
 
+from backend.data.understanding import (
+    format_understanding_for_prompt,
+    get_business_understanding,
+)
 from backend.util.exceptions import NotFoundError
+from backend.util.settings import Settings
 
 from .config import ChatConfig
 from .model import (
@@ -15,17 +22,20 @@ from .model import (
     ChatSession,
     Usage,
     get_chat_session,
+    update_session_title,
     upsert_chat_session,
 )
 from .response_model import (
     StreamBaseResponse,
-    StreamEnd,
     StreamError,
-    StreamTextChunk,
-    StreamTextEnded,
-    StreamToolCall,
-    StreamToolCallStart,
-    StreamToolExecutionResult,
+    StreamFinish,
+    StreamStart,
+    StreamTextDelta,
+    StreamTextEnd,
+    StreamTextStart,
+    StreamToolInputAvailable,
+    StreamToolInputStart,
+    StreamToolOutputAvailable,
     StreamUsage,
 )
 from .tools import execute_tool, tools
@@ -33,28 +43,94 @@ from .tools import execute_tool, tools
 logger = logging.getLogger(__name__)
 
 config = ChatConfig()
-client = AsyncOpenAI(api_key=config.api_key, base_url=config.base_url)
+settings = Settings()
+client = openai.AsyncOpenAI(api_key=config.api_key, base_url=config.base_url)
 
 
-async def create_chat_session(
-    user_id: str | None = None,
-) -> ChatSession:
-    """
-    Create a new chat session and persist it to the database.
-    """
-    session = ChatSession.new(user_id)
-    # Persist the session immediately so it can be used for streaming
-    return await upsert_chat_session(session)
+langfuse = get_client()
 
 
-async def get_session(
-    session_id: str,
-    user_id: str | None = None,
-) -> ChatSession | None:
+class LangfuseNotConfiguredError(Exception):
+    """Raised when Langfuse is required but not configured."""
+
+    pass
+
+
+def _is_langfuse_configured() -> bool:
+    """Check if Langfuse credentials are configured."""
+    return bool(
+        settings.secrets.langfuse_public_key and settings.secrets.langfuse_secret_key
+    )
+
+
+async def _build_system_prompt(user_id: str | None) -> tuple[str, Any]:
+    """Build the full system prompt including business understanding if available.
+
+    Args:
+        user_id: The user ID for fetching business understanding
+                     If "default" and this is the user's first session, will use "onboarding" instead.
+
+    Returns:
+        Tuple of (compiled prompt string, Langfuse prompt object for tracing)
     """
-    Get a chat session by ID.
+
+    # cache_ttl_seconds=0 disables SDK caching to always get the latest prompt
+    prompt = langfuse.get_prompt(config.langfuse_prompt_name, cache_ttl_seconds=0)
+
+    # If user is authenticated, try to fetch their business understanding
+    understanding = None
+    if user_id:
+        try:
+            understanding = await get_business_understanding(user_id)
+        except Exception as e:
+            logger.warning(f"Failed to fetch business understanding: {e}")
+            understanding = None
+    if understanding:
+        context = format_understanding_for_prompt(understanding)
+    else:
+        context = "This is the first time you are meeting the user. Greet them and introduce them to the platform"
+
+    compiled = prompt.compile(users_information=context)
+    return compiled, understanding
+
+
+async def _generate_session_title(message: str) -> str | None:
+    """Generate a concise title for a chat session based on the first message.
+
+    Args:
+        message: The first user message in the session
+
+    Returns:
+        A short title (3-6 words) or None if generation fails
     """
-    return await get_chat_session(session_id, user_id)
+    try:
+        response = await client.chat.completions.create(
+            model=config.title_model,
+            messages=[
+                {
+                    "role": "system",
+                    "content": (
+                        "Generate a very short title (3-6 words) for a chat conversation "
+                        "based on the user's first message. The title should capture the "
+                        "main topic or intent. Return ONLY the title, no quotes or punctuation."
+                    ),
+                },
+                {"role": "user", "content": message[:500]},  # Limit input length
+            ],
+            max_tokens=20,
+        )
+        title = response.choices[0].message.content
+        if title:
+            # Clean up the title
+            title = title.strip().strip("\"'")
+            # Limit length
+            if len(title) > 50:
+                title = title[:47] + "..."
+            return title
+        return None
+    except Exception as e:
+        logger.warning(f"Failed to generate session title: {e}")
+        return None
 
 
 async def assign_user_to_session(
@@ -74,10 +150,12 @@ async def assign_user_to_session(
 async def stream_chat_completion(
     session_id: str,
     message: str | None = None,
+    tool_call_response: str | None = None,
     is_user_message: bool = True,
     user_id: str | None = None,
     retry_count: int = 0,
     session: ChatSession | None = None,
+    context: dict[str, str] | None = None,  # {url: str, content: str}
 ) -> AsyncGenerator[StreamBaseResponse, None]:
     """Main entry point for streaming chat completions with database handling.
 
@@ -102,6 +180,16 @@ async def stream_chat_completion(
         f"Streaming chat completion for session {session_id} for message {message} and user id {user_id}. Message is user message: {is_user_message}"
     )
 
+    # Check if Langfuse is configured - required for chat functionality
+    if not _is_langfuse_configured():
+        logger.error("Chat request failed: Langfuse is not configured")
+        yield StreamError(
+            errorText="Chat service is not available. Langfuse must be configured "
+            "with LANGFUSE_PUBLIC_KEY and LANGFUSE_SECRET_KEY environment variables."
+        )
+        yield StreamFinish()
+        return
+
     # Only fetch from Redis if session not provided (initial call)
     if session is None:
         session = await get_chat_session(session_id, user_id)
@@ -121,9 +209,18 @@ async def stream_chat_completion(
         )
 
     if message:
+        # Build message content with context if provided
+        message_content = message
+        if context and context.get("url") and context.get("content"):
+            context_text = f"Page URL: {context['url']}\n\nPage Content:\n{context['content']}\n\n---\n\nUser Message: {message}"
+            message_content = context_text
+            logger.info(
+                f"Including page context: URL={context['url']}, content_length={len(context['content'])}"
+            )
+
         session.messages.append(
             ChatMessage(
-                role="user" if is_user_message else "assistant", content=message
+                role="user" if is_user_message else "assistant", content=message_content
             )
         )
         logger.info(
@@ -131,9 +228,6 @@ async def stream_chat_completion(
             f"new message_count={len(session.messages)}"
         )
 
-    if len(session.messages) > config.max_context_messages:
-        raise ValueError(f"Max messages exceeded: {config.max_context_messages}")
-
     logger.info(
         f"Upserting session: {session.session_id} with user id {session.user_id}, "
         f"message_count={len(session.messages)}"
@@ -141,206 +235,332 @@ async def stream_chat_completion(
     session = await upsert_chat_session(session)
     assert session, "Session not found"
 
-    assistant_response = ChatMessage(
-        role="assistant",
-        content="",
-    )
+    # Generate title for new sessions on first user message (non-blocking)
+    # Check: is_user_message, no title yet, and this is the first user message
+    if is_user_message and message and not session.title:
+        user_messages = [m for m in session.messages if m.role == "user"]
+        if len(user_messages) == 1:
+            # First user message - generate title in background
+            import asyncio
 
-    has_yielded_end = False
-    has_yielded_error = False
-    has_done_tool_call = False
-    has_received_text = False
-    text_streaming_ended = False
-    tool_response_messages: list[ChatMessage] = []
-    accumulated_tool_calls: list[dict[str, Any]] = []
-    should_retry = False
+            # Capture only the values we need (not the session object) to avoid
+            # stale data issues when the main flow modifies the session
+            captured_session_id = session_id
+            captured_message = message
 
-    try:
-        async for chunk in _stream_chat_chunks(
-            session=session,
-            tools=tools,
+            async def _update_title():
+                try:
+                    title = await _generate_session_title(captured_message)
+                    if title:
+                        # Use dedicated title update function that doesn't
+                        # touch messages, avoiding race conditions
+                        await update_session_title(captured_session_id, title)
+                        logger.info(
+                            f"Generated title for session {captured_session_id}: {title}"
+                        )
+                except Exception as e:
+                    logger.warning(f"Failed to update session title: {e}")
+
+            # Fire and forget - don't block the chat response
+            asyncio.create_task(_update_title())
+
+    # Build system prompt with business understanding
+    system_prompt, understanding = await _build_system_prompt(user_id)
+
+    # Create Langfuse trace for this LLM call (each call gets its own trace, grouped by session_id)
+    # Using v3 SDK: start_observation creates a root span, update_trace sets trace-level attributes
+    input = message
+    if not message and tool_call_response:
+        input = tool_call_response
+
+    langfuse = get_client()
+    with langfuse.start_as_current_observation(
+        as_type="span",
+        name="user-copilot-request",
+        input=input,
+    ) as span:
+        with propagate_attributes(
+            session_id=session_id,
+            user_id=user_id,
+            tags=["copilot"],
+            metadata={
+                "users_information": format_understanding_for_prompt(understanding)[
+                    :200
+                ]  # langfuse only accepts upto to 200 chars
+            },
         ):
 
-            if isinstance(chunk, StreamTextChunk):
-                content = chunk.content or ""
-                assert assistant_response.content is not None
-                assistant_response.content += content
-                has_received_text = True
-                yield chunk
-            elif isinstance(chunk, StreamToolCallStart):
-                # Emit text_ended before first tool call, but only if we've received text
-                if has_received_text and not text_streaming_ended:
-                    yield StreamTextEnded()
-                    text_streaming_ended = True
-                yield chunk
-            elif isinstance(chunk, StreamToolCall):
-                # Accumulate tool calls in OpenAI format
-                accumulated_tool_calls.append(
-                    {
-                        "id": chunk.tool_id,
-                        "type": "function",
-                        "function": {
-                            "name": chunk.tool_name,
-                            "arguments": orjson.dumps(chunk.arguments).decode("utf-8"),
-                        },
-                    }
-                )
-            elif isinstance(chunk, StreamToolExecutionResult):
-                result_content = (
-                    chunk.result
-                    if isinstance(chunk.result, str)
-                    else orjson.dumps(chunk.result).decode("utf-8")
-                )
-                tool_response_messages.append(
-                    ChatMessage(
-                        role="tool",
-                        content=result_content,
-                        tool_call_id=chunk.tool_id,
-                    )
-                )
-                has_done_tool_call = True
-                # Track if any tool execution failed
-                if not chunk.success:
-                    logger.warning(
-                        f"Tool {chunk.tool_name} (ID: {chunk.tool_id}) execution failed"
-                    )
-                yield chunk
-            elif isinstance(chunk, StreamEnd):
-                if not has_done_tool_call:
-                    has_yielded_end = True
-                    yield chunk
-            elif isinstance(chunk, StreamError):
-                has_yielded_error = True
-            elif isinstance(chunk, StreamUsage):
-                session.usage.append(
-                    Usage(
-                        prompt_tokens=chunk.prompt_tokens,
-                        completion_tokens=chunk.completion_tokens,
-                        total_tokens=chunk.total_tokens,
-                    )
-                )
-            else:
-                logger.error(f"Unknown chunk type: {type(chunk)}", exc_info=True)
-    except Exception as e:
-        logger.error(f"Error during stream: {e!s}", exc_info=True)
-
-        # Check if this is a retryable error (JSON parsing, incomplete tool calls, etc.)
-        is_retryable = isinstance(e, (orjson.JSONDecodeError, KeyError, TypeError))
-
-        if is_retryable and retry_count < config.max_retries:
-            logger.info(
-                f"Retryable error encountered. Attempt {retry_count + 1}/{config.max_retries}"
+            # Initialize variables that will be used in finally block (must be defined before try)
+            assistant_response = ChatMessage(
+                role="assistant",
+                content="",
             )
-            should_retry = True
-        else:
-            # Non-retryable error or max retries exceeded
-            # Save any partial progress before reporting error
+            accumulated_tool_calls: list[dict[str, Any]] = []
+
+            # Wrap main logic in try/finally to ensure Langfuse observations are always ended
+            has_yielded_end = False
+            has_yielded_error = False
+            has_done_tool_call = False
+            has_received_text = False
+            text_streaming_ended = False
+            tool_response_messages: list[ChatMessage] = []
+            should_retry = False
+
+            # Generate unique IDs for AI SDK protocol
+            import uuid as uuid_module
+
+            message_id = str(uuid_module.uuid4())
+            text_block_id = str(uuid_module.uuid4())
+
+            # Yield message start
+            yield StreamStart(messageId=message_id)
+
+            try:
+                async for chunk in _stream_chat_chunks(
+                    session=session,
+                    tools=tools,
+                    system_prompt=system_prompt,
+                    text_block_id=text_block_id,
+                ):
+
+                    if isinstance(chunk, StreamTextStart):
+                        # Emit text-start before first text delta
+                        if not has_received_text:
+                            yield chunk
+                    elif isinstance(chunk, StreamTextDelta):
+                        delta = chunk.delta or ""
+                        assert assistant_response.content is not None
+                        assistant_response.content += delta
+                        has_received_text = True
+                        yield chunk
+                    elif isinstance(chunk, StreamTextEnd):
+                        # Emit text-end after text completes
+                        if has_received_text and not text_streaming_ended:
+                            text_streaming_ended = True
+                            if assistant_response.content:
+                                logger.warn(
+                                    f"StreamTextEnd: Attempting to set output {assistant_response.content}"
+                                )
+                                span.update_trace(output=assistant_response.content)
+                                span.update(output=assistant_response.content)
+                            yield chunk
+                    elif isinstance(chunk, StreamToolInputStart):
+                        # Emit text-end before first tool call, but only if we've received text
+                        if has_received_text and not text_streaming_ended:
+                            yield StreamTextEnd(id=text_block_id)
+                            text_streaming_ended = True
+                        yield chunk
+                    elif isinstance(chunk, StreamToolInputAvailable):
+                        # Accumulate tool calls in OpenAI format
+                        accumulated_tool_calls.append(
+                            {
+                                "id": chunk.toolCallId,
+                                "type": "function",
+                                "function": {
+                                    "name": chunk.toolName,
+                                    "arguments": orjson.dumps(chunk.input).decode(
+                                        "utf-8"
+                                    ),
+                                },
+                            }
+                        )
+                    elif isinstance(chunk, StreamToolOutputAvailable):
+                        result_content = (
+                            chunk.output
+                            if isinstance(chunk.output, str)
+                            else orjson.dumps(chunk.output).decode("utf-8")
+                        )
+                        tool_response_messages.append(
+                            ChatMessage(
+                                role="tool",
+                                content=result_content,
+                                tool_call_id=chunk.toolCallId,
+                            )
+                        )
+                        has_done_tool_call = True
+                        # Track if any tool execution failed
+                        if not chunk.success:
+                            logger.warning(
+                                f"Tool {chunk.toolName} (ID: {chunk.toolCallId}) execution failed"
+                            )
+                        yield chunk
+                    elif isinstance(chunk, StreamFinish):
+                        if not has_done_tool_call:
+                            # Emit text-end before finish if we received text but haven't closed it
+                            if has_received_text and not text_streaming_ended:
+                                yield StreamTextEnd(id=text_block_id)
+                                text_streaming_ended = True
+                            has_yielded_end = True
+                            yield chunk
+                    elif isinstance(chunk, StreamError):
+                        has_yielded_error = True
+                    elif isinstance(chunk, StreamUsage):
+                        session.usage.append(
+                            Usage(
+                                prompt_tokens=chunk.promptTokens,
+                                completion_tokens=chunk.completionTokens,
+                                total_tokens=chunk.totalTokens,
+                            )
+                        )
+                    else:
+                        logger.error(
+                            f"Unknown chunk type: {type(chunk)}", exc_info=True
+                        )
+                if assistant_response.content:
+                    langfuse.update_current_trace(output=assistant_response.content)
+                    langfuse.update_current_span(output=assistant_response.content)
+                elif tool_response_messages:
+                    langfuse.update_current_trace(output=str(tool_response_messages))
+                    langfuse.update_current_span(output=str(tool_response_messages))
+
+            except Exception as e:
+                logger.error(f"Error during stream: {e!s}", exc_info=True)
+
+                # Check if this is a retryable error (JSON parsing, incomplete tool calls, etc.)
+                is_retryable = isinstance(
+                    e, (orjson.JSONDecodeError, KeyError, TypeError)
+                )
+
+                if is_retryable and retry_count < config.max_retries:
+                    logger.info(
+                        f"Retryable error encountered. Attempt {retry_count + 1}/{config.max_retries}"
+                    )
+                    should_retry = True
+                else:
+                    # Non-retryable error or max retries exceeded
+                    # Save any partial progress before reporting error
+                    messages_to_save: list[ChatMessage] = []
+
+                    # Add assistant message if it has content or tool calls
+                    if accumulated_tool_calls:
+                        assistant_response.tool_calls = accumulated_tool_calls
+                    if assistant_response.content or assistant_response.tool_calls:
+                        messages_to_save.append(assistant_response)
+
+                    # Add tool response messages after assistant message
+                    messages_to_save.extend(tool_response_messages)
+
+                    session.messages.extend(messages_to_save)
+                    await upsert_chat_session(session)
+
+                    if not has_yielded_error:
+                        error_message = str(e)
+                        if not is_retryable:
+                            error_message = f"Non-retryable error: {error_message}"
+                        elif retry_count >= config.max_retries:
+                            error_message = f"Max retries ({config.max_retries}) exceeded: {error_message}"
+
+                        error_response = StreamError(errorText=error_message)
+                        yield error_response
+                    if not has_yielded_end:
+                        yield StreamFinish()
+                    return
+
+            # Handle retry outside of exception handler to avoid nesting
+            if should_retry and retry_count < config.max_retries:
+                logger.info(
+                    f"Retrying stream_chat_completion for session {session_id}, attempt {retry_count + 1}"
+                )
+                async for chunk in stream_chat_completion(
+                    session_id=session.session_id,
+                    user_id=user_id,
+                    retry_count=retry_count + 1,
+                    session=session,
+                    context=context,
+                ):
+                    yield chunk
+                return  # Exit after retry to avoid double-saving in finally block
+
+            # Normal completion path - save session and handle tool call continuation
+            logger.info(
+                f"Normal completion path: session={session.session_id}, "
+                f"current message_count={len(session.messages)}"
+            )
+
+            # Build the messages list in the correct order
             messages_to_save: list[ChatMessage] = []
 
-            # Add assistant message if it has content or tool calls
+            # Add assistant message with tool_calls if any
             if accumulated_tool_calls:
                 assistant_response.tool_calls = accumulated_tool_calls
+                logger.info(
+                    f"Added {len(accumulated_tool_calls)} tool calls to assistant message"
+                )
             if assistant_response.content or assistant_response.tool_calls:
                 messages_to_save.append(assistant_response)
+                logger.info(
+                    f"Saving assistant message with content_len={len(assistant_response.content or '')}, tool_calls={len(assistant_response.tool_calls or [])}"
+                )
 
             # Add tool response messages after assistant message
             messages_to_save.extend(tool_response_messages)
+            logger.info(
+                f"Saving {len(tool_response_messages)} tool response messages, "
+                f"total_to_save={len(messages_to_save)}"
+            )
 
             session.messages.extend(messages_to_save)
+            logger.info(
+                f"Extended session messages, new message_count={len(session.messages)}"
+            )
             await upsert_chat_session(session)
 
-            if not has_yielded_error:
-                error_message = str(e)
-                if not is_retryable:
-                    error_message = f"Non-retryable error: {error_message}"
-                elif retry_count >= config.max_retries:
-                    error_message = (
-                        f"Max retries ({config.max_retries}) exceeded: {error_message}"
-                    )
-
-                error_response = StreamError(
-                    message=error_message,
-                    timestamp=datetime.now(UTC).isoformat(),
+            # If we did a tool call, stream the chat completion again to get the next response
+            if has_done_tool_call:
+                logger.info(
+                    "Tool call executed, streaming chat completion again to get assistant response"
                 )
-                yield error_response
-            if not has_yielded_end:
-                yield StreamEnd(
-                    timestamp=datetime.now(UTC).isoformat(),
-                )
-            return
+                async for chunk in stream_chat_completion(
+                    session_id=session.session_id,
+                    user_id=user_id,
+                    session=session,  # Pass session object to avoid Redis refetch
+                    context=context,
+                    tool_call_response=str(tool_response_messages),
+                ):
+                    yield chunk
 
-    # Handle retry outside of exception handler to avoid nesting
-    if should_retry and retry_count < config.max_retries:
-        logger.info(
-            f"Retrying stream_chat_completion for session {session_id}, attempt {retry_count + 1}"
-        )
-        async for chunk in stream_chat_completion(
-            session_id=session.session_id,
-            user_id=user_id,
-            retry_count=retry_count + 1,
-            session=session,
-        ):
-            yield chunk
-        return  # Exit after retry to avoid double-saving in finally block
 
-    # Normal completion path - save session and handle tool call continuation
-    logger.info(
-        f"Normal completion path: session={session.session_id}, "
-        f"current message_count={len(session.messages)}"
-    )
+# Retry configuration for OpenAI API calls
+MAX_RETRIES = 3
+BASE_DELAY_SECONDS = 1.0
+MAX_DELAY_SECONDS = 30.0
 
-    # Build the messages list in the correct order
-    messages_to_save: list[ChatMessage] = []
 
-    # Add assistant message with tool_calls if any
-    if accumulated_tool_calls:
-        assistant_response.tool_calls = accumulated_tool_calls
-        logger.info(
-            f"Added {len(accumulated_tool_calls)} tool calls to assistant message"
-        )
-    if assistant_response.content or assistant_response.tool_calls:
-        messages_to_save.append(assistant_response)
-        logger.info(
-            f"Saving assistant message with content_len={len(assistant_response.content or '')}, tool_calls={len(assistant_response.tool_calls or [])}"
-        )
-
-    # Add tool response messages after assistant message
-    messages_to_save.extend(tool_response_messages)
-    logger.info(
-        f"Saving {len(tool_response_messages)} tool response messages, "
-        f"total_to_save={len(messages_to_save)}"
-    )
-
-    session.messages.extend(messages_to_save)
-    logger.info(f"Extended session messages, new message_count={len(session.messages)}")
-    await upsert_chat_session(session)
-
-    # If we did a tool call, stream the chat completion again to get the next response
-    if has_done_tool_call:
-        logger.info(
-            "Tool call executed, streaming chat completion again to get assistant response"
-        )
-        async for chunk in stream_chat_completion(
-            session_id=session.session_id,
-            user_id=user_id,
-            session=session,  # Pass session object to avoid Redis refetch
-        ):
-            yield chunk
+def _is_retryable_error(error: Exception) -> bool:
+    """Determine if an error is retryable."""
+    if isinstance(error, RateLimitError):
+        return True
+    if isinstance(error, APIConnectionError):
+        return True
+    if isinstance(error, APIStatusError):
+        # APIStatusError has a response with status_code
+        # Retry on 5xx status codes (server errors)
+        if error.response.status_code >= 500:
+            return True
+    if isinstance(error, APIError):
+        # Retry on overloaded errors or 500 errors (may not have status code)
+        error_message = str(error).lower()
+        if "overloaded" in error_message or "internal server error" in error_message:
+            return True
+    return False
 
 
 async def _stream_chat_chunks(
     session: ChatSession,
     tools: list[ChatCompletionToolParam],
+    system_prompt: str | None = None,
+    text_block_id: str | None = None,
 ) -> AsyncGenerator[StreamBaseResponse, None]:
     """
     Pure streaming function for OpenAI chat completions with tool calling.
 
     This function is database-agnostic and focuses only on streaming logic.
+    Implements exponential backoff retry for transient API errors.
 
     Args:
-        messages: Conversation context as ChatCompletionMessageParam list
-        session_id: Session ID
-        user_id: User ID for tool execution
+        session: Chat session with conversation history
+        tools: Available tools for the model
+        system_prompt: System prompt to prepend to messages
 
     Yields:
         SSE formatted JSON response objects
@@ -350,140 +570,186 @@ async def _stream_chat_chunks(
 
     logger.info("Starting pure chat stream")
 
+    # Build messages with system prompt prepended
+    messages = session.to_openai_messages()
+    if system_prompt:
+        from openai.types.chat import ChatCompletionSystemMessageParam
+
+        system_message = ChatCompletionSystemMessageParam(
+            role="system",
+            content=system_prompt,
+        )
+        messages = [system_message] + messages
+
     # Loop to handle tool calls and continue conversation
     while True:
-        try:
-            logger.info("Creating OpenAI chat completion stream...")
+        retry_count = 0
+        last_error: Exception | None = None
 
-            # Create the stream with proper types
-            stream = await client.chat.completions.create(
-                model=model,
-                messages=session.to_openai_messages(),
-                tools=tools,
-                tool_choice="auto",
-                stream=True,
-            )
+        while retry_count <= MAX_RETRIES:
+            try:
+                logger.info(
+                    f"Creating OpenAI chat completion stream..."
+                    f"{f' (retry {retry_count}/{MAX_RETRIES})' if retry_count > 0 else ''}"
+                )
 
-            # Variables to accumulate tool calls
-            tool_calls: list[dict[str, Any]] = []
-            active_tool_call_idx: int | None = None
-            finish_reason: str | None = None
-            # Track which tool call indices have had their start event emitted
-            emitted_start_for_idx: set[int] = set()
+                # Create the stream with proper types
+                stream = await client.chat.completions.create(
+                    model=model,
+                    messages=messages,
+                    tools=tools,
+                    tool_choice="auto",
+                    stream=True,
+                    stream_options={"include_usage": True},
+                )
 
-            # Process the stream
-            chunk: ChatCompletionChunk
-            async for chunk in stream:
-                if chunk.usage:
-                    yield StreamUsage(
-                        prompt_tokens=chunk.usage.prompt_tokens,
-                        completion_tokens=chunk.usage.completion_tokens,
-                        total_tokens=chunk.usage.total_tokens,
-                    )
+                # Variables to accumulate tool calls
+                tool_calls: list[dict[str, Any]] = []
+                active_tool_call_idx: int | None = None
+                finish_reason: str | None = None
+                # Track which tool call indices have had their start event emitted
+                emitted_start_for_idx: set[int] = set()
 
-                if chunk.choices:
-                    choice = chunk.choices[0]
-                    delta = choice.delta
+                # Track if we've started the text block
+                text_started = False
 
-                    # Capture finish reason
-                    if choice.finish_reason:
-                        finish_reason = choice.finish_reason
-                        logger.info(f"Finish reason: {finish_reason}")
-
-                    # Handle content streaming
-                    if delta.content:
-                        # Stream the text chunk
-                        text_response = StreamTextChunk(
-                            content=delta.content,
-                            timestamp=datetime.now(UTC).isoformat(),
+                # Process the stream
+                chunk: ChatCompletionChunk
+                async for chunk in stream:
+                    if chunk.usage:
+                        yield StreamUsage(
+                            promptTokens=chunk.usage.prompt_tokens,
+                            completionTokens=chunk.usage.completion_tokens,
+                            totalTokens=chunk.usage.total_tokens,
                         )
-                        yield text_response
 
-                    # Handle tool calls
-                    if delta.tool_calls:
-                        for tc_chunk in delta.tool_calls:
-                            idx = tc_chunk.index
+                    if chunk.choices:
+                        choice = chunk.choices[0]
+                        delta = choice.delta
 
-                            # Update active tool call index if needed
-                            if (
-                                active_tool_call_idx is None
-                                or active_tool_call_idx != idx
-                            ):
-                                active_tool_call_idx = idx
+                        # Capture finish reason
+                        if choice.finish_reason:
+                            finish_reason = choice.finish_reason
+                            logger.info(f"Finish reason: {finish_reason}")
 
-                            # Ensure we have a tool call object at this index
-                            while len(tool_calls) <= idx:
-                                tool_calls.append(
-                                    {
-                                        "id": "",
-                                        "type": "function",
-                                        "function": {
-                                            "name": "",
-                                            "arguments": "",
+                        # Handle content streaming
+                        if delta.content:
+                            # Emit text-start on first text content
+                            if not text_started and text_block_id:
+                                yield StreamTextStart(id=text_block_id)
+                                text_started = True
+                            # Stream the text delta
+                            text_response = StreamTextDelta(
+                                id=text_block_id or "",
+                                delta=delta.content,
+                            )
+                            yield text_response
+
+                        # Handle tool calls
+                        if delta.tool_calls:
+                            for tc_chunk in delta.tool_calls:
+                                idx = tc_chunk.index
+
+                                # Update active tool call index if needed
+                                if (
+                                    active_tool_call_idx is None
+                                    or active_tool_call_idx != idx
+                                ):
+                                    active_tool_call_idx = idx
+
+                                # Ensure we have a tool call object at this index
+                                while len(tool_calls) <= idx:
+                                    tool_calls.append(
+                                        {
+                                            "id": "",
+                                            "type": "function",
+                                            "function": {
+                                                "name": "",
+                                                "arguments": "",
+                                            },
                                         },
-                                    },
-                                )
+                                    )
 
-                            # Accumulate the tool call data
-                            if tc_chunk.id:
-                                tool_calls[idx]["id"] = tc_chunk.id
-                            if tc_chunk.function:
-                                if tc_chunk.function.name:
-                                    tool_calls[idx]["function"][
-                                        "name"
-                                    ] = tc_chunk.function.name
-                                if tc_chunk.function.arguments:
-                                    tool_calls[idx]["function"][
-                                        "arguments"
-                                    ] += tc_chunk.function.arguments
+                                # Accumulate the tool call data
+                                if tc_chunk.id:
+                                    tool_calls[idx]["id"] = tc_chunk.id
+                                if tc_chunk.function:
+                                    if tc_chunk.function.name:
+                                        tool_calls[idx]["function"][
+                                            "name"
+                                        ] = tc_chunk.function.name
+                                    if tc_chunk.function.arguments:
+                                        tool_calls[idx]["function"][
+                                            "arguments"
+                                        ] += tc_chunk.function.arguments
 
-                            # Emit StreamToolCallStart only after we have the tool call ID
-                            if (
-                                idx not in emitted_start_for_idx
-                                and tool_calls[idx]["id"]
-                                and tool_calls[idx]["function"]["name"]
-                            ):
-                                yield StreamToolCallStart(
-                                    tool_id=tool_calls[idx]["id"],
-                                    tool_name=tool_calls[idx]["function"]["name"],
-                                    timestamp=datetime.now(UTC).isoformat(),
-                                )
-                                emitted_start_for_idx.add(idx)
-            logger.info(f"Stream complete. Finish reason: {finish_reason}")
+                                # Emit StreamToolInputStart only after we have the tool call ID
+                                if (
+                                    idx not in emitted_start_for_idx
+                                    and tool_calls[idx]["id"]
+                                    and tool_calls[idx]["function"]["name"]
+                                ):
+                                    yield StreamToolInputStart(
+                                        toolCallId=tool_calls[idx]["id"],
+                                        toolName=tool_calls[idx]["function"]["name"],
+                                    )
+                                    emitted_start_for_idx.add(idx)
+                logger.info(f"Stream complete. Finish reason: {finish_reason}")
 
-            # Yield all accumulated tool calls after the stream is complete
-            # This ensures all tool call arguments have been fully received
-            for idx, tool_call in enumerate(tool_calls):
-                try:
-                    async for tc in _yield_tool_call(tool_calls, idx, session):
-                        yield tc
-                except (orjson.JSONDecodeError, KeyError, TypeError) as e:
+                # Yield all accumulated tool calls after the stream is complete
+                # This ensures all tool call arguments have been fully received
+                for idx, tool_call in enumerate(tool_calls):
+                    try:
+                        async for tc in _yield_tool_call(tool_calls, idx, session):
+                            yield tc
+                    except (orjson.JSONDecodeError, KeyError, TypeError) as e:
+                        logger.error(
+                            f"Failed to parse tool call {idx}: {e}",
+                            exc_info=True,
+                            extra={"tool_call": tool_call},
+                        )
+                        yield StreamError(
+                            errorText=f"Invalid tool call arguments for tool {tool_call.get('function', {}).get('name', 'unknown')}: {e}",
+                        )
+                        # Re-raise to trigger retry logic in the parent function
+                        raise
+
+                yield StreamFinish()
+                return
+            except Exception as e:
+                last_error = e
+                if _is_retryable_error(e) and retry_count < MAX_RETRIES:
+                    retry_count += 1
+                    # Calculate delay with exponential backoff
+                    delay = min(
+                        BASE_DELAY_SECONDS * (2 ** (retry_count - 1)),
+                        MAX_DELAY_SECONDS,
+                    )
+                    logger.warning(
+                        f"Retryable error in stream: {e!s}. "
+                        f"Retrying in {delay:.1f}s (attempt {retry_count}/{MAX_RETRIES})"
+                    )
+                    await asyncio.sleep(delay)
+                    continue  # Retry the stream
+                else:
+                    # Non-retryable error or max retries exceeded
                     logger.error(
-                        f"Failed to parse tool call {idx}: {e}",
+                        f"Error in stream (not retrying): {e!s}",
                         exc_info=True,
-                        extra={"tool_call": tool_call},
                     )
-                    yield StreamError(
-                        message=f"Invalid tool call arguments for tool {tool_call.get('function', {}).get('name', 'unknown')}: {e}",
-                        timestamp=datetime.now(UTC).isoformat(),
-                    )
-                    # Re-raise to trigger retry logic in the parent function
-                    raise
+                    error_response = StreamError(errorText=str(e))
+                    yield error_response
+                    yield StreamFinish()
+                    return
 
-            yield StreamEnd(
-                timestamp=datetime.now(UTC).isoformat(),
-            )
-            return
-        except Exception as e:
-            logger.error(f"Error in stream: {e!s}", exc_info=True)
-            error_response = StreamError(
-                message=str(e),
-                timestamp=datetime.now(UTC).isoformat(),
-            )
-            yield error_response
-            yield StreamEnd(
-                timestamp=datetime.now(UTC).isoformat(),
+        # If we exit the retry loop without returning, it means we exhausted retries
+        if last_error:
+            logger.error(
+                f"Max retries ({MAX_RETRIES}) exceeded. Last error: {last_error!s}",
+                exc_info=True,
             )
+            yield StreamError(errorText=f"Max retries exceeded: {last_error!s}")
+            yield StreamFinish()
             return
 
 
@@ -500,39 +766,29 @@ async def _yield_tool_call(
         KeyError: If expected tool call fields are missing
         TypeError: If tool call structure is invalid
     """
+    tool_name = tool_calls[yield_idx]["function"]["name"]
+    tool_call_id = tool_calls[yield_idx]["id"]
     logger.info(f"Yielding tool call: {tool_calls[yield_idx]}")
 
-    # Parse tool call arguments - exceptions will propagate to caller
-    arguments = orjson.loads(tool_calls[yield_idx]["function"]["arguments"])
+    # Parse tool call arguments - handle empty arguments gracefully
+    raw_arguments = tool_calls[yield_idx]["function"]["arguments"]
+    if raw_arguments:
+        arguments = orjson.loads(raw_arguments)
+    else:
+        arguments = {}
 
-    yield StreamToolCall(
-        tool_id=tool_calls[yield_idx]["id"],
-        tool_name=tool_calls[yield_idx]["function"]["name"],
-        arguments=arguments,
-        timestamp=datetime.now(UTC).isoformat(),
+    yield StreamToolInputAvailable(
+        toolCallId=tool_call_id,
+        toolName=tool_name,
+        input=arguments,
     )
 
-    tool_execution_response: StreamToolExecutionResult = await execute_tool(
-        tool_name=tool_calls[yield_idx]["function"]["name"],
+    tool_execution_response: StreamToolOutputAvailable = await execute_tool(
+        tool_name=tool_name,
         parameters=arguments,
-        tool_call_id=tool_calls[yield_idx]["id"],
+        tool_call_id=tool_call_id,
         user_id=session.user_id,
         session=session,
     )
-    logger.info(f"Yielding Tool execution response: {tool_execution_response}")
+
     yield tool_execution_response
-
-
-if __name__ == "__main__":
-    import asyncio
-
-    async def main():
-        session = await create_chat_session()
-        async for chunk in stream_chat_completion(
-            session.session_id,
-            "Please find me an agent that can help me with my business. Call the tool twice once with the query 'money printing agent' and once with the query 'money generating agent'",
-            user_id=session.user_id,
-        ):
-            print(chunk)
-
-    asyncio.run(main())
diff --git a/autogpt_platform/backend/backend/api/features/chat/service_test.py b/autogpt_platform/backend/backend/api/features/chat/service_test.py
index d1af22a71a..70f27af14f 100644
--- a/autogpt_platform/backend/backend/api/features/chat/service_test.py
+++ b/autogpt_platform/backend/backend/api/features/chat/service_test.py
@@ -4,18 +4,19 @@ from os import getenv
 import pytest
 
 from . import service as chat_service
+from .model import create_chat_session, get_chat_session, upsert_chat_session
 from .response_model import (
-    StreamEnd,
     StreamError,
-    StreamTextChunk,
-    StreamToolExecutionResult,
+    StreamFinish,
+    StreamTextDelta,
+    StreamToolOutputAvailable,
 )
 
 logger = logging.getLogger(__name__)
 
 
 @pytest.mark.asyncio(loop_scope="session")
-async def test_stream_chat_completion():
+async def test_stream_chat_completion(setup_test_user, test_user_id):
     """
     Test the stream_chat_completion function.
     """
@@ -23,7 +24,7 @@ async def test_stream_chat_completion():
     if not api_key:
         return pytest.skip("OPEN_ROUTER_API_KEY is not set, skipping test")
 
-    session = await chat_service.create_chat_session()
+    session = await create_chat_session(test_user_id)
 
     has_errors = False
     has_ended = False
@@ -34,9 +35,9 @@ async def test_stream_chat_completion():
         logger.info(chunk)
         if isinstance(chunk, StreamError):
             has_errors = True
-        if isinstance(chunk, StreamTextChunk):
-            assistant_message += chunk.content
-        if isinstance(chunk, StreamEnd):
+        if isinstance(chunk, StreamTextDelta):
+            assistant_message += chunk.delta
+        if isinstance(chunk, StreamFinish):
             has_ended = True
 
     assert has_ended, "Chat completion did not end"
@@ -45,7 +46,7 @@ async def test_stream_chat_completion():
 
 
 @pytest.mark.asyncio(loop_scope="session")
-async def test_stream_chat_completion_with_tool_calls():
+async def test_stream_chat_completion_with_tool_calls(setup_test_user, test_user_id):
     """
     Test the stream_chat_completion function.
     """
@@ -53,8 +54,8 @@ async def test_stream_chat_completion_with_tool_calls():
     if not api_key:
         return pytest.skip("OPEN_ROUTER_API_KEY is not set, skipping test")
 
-    session = await chat_service.create_chat_session()
-    session = await chat_service.upsert_chat_session(session)
+    session = await create_chat_session(test_user_id)
+    session = await upsert_chat_session(session)
 
     has_errors = False
     has_ended = False
@@ -68,14 +69,14 @@ async def test_stream_chat_completion_with_tool_calls():
         if isinstance(chunk, StreamError):
             has_errors = True
 
-        if isinstance(chunk, StreamEnd):
+        if isinstance(chunk, StreamFinish):
             has_ended = True
-        if isinstance(chunk, StreamToolExecutionResult):
+        if isinstance(chunk, StreamToolOutputAvailable):
             had_tool_calls = True
 
     assert has_ended, "Chat completion did not end"
     assert not has_errors, "Error occurred while streaming chat completion"
     assert had_tool_calls, "Tool calls did not occur"
-    session = await chat_service.get_session(session.session_id)
+    session = await get_chat_session(session.session_id)
     assert session, "Session not found"
     assert session.usage, "Usage is empty"
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/__init__.py b/autogpt_platform/backend/backend/api/features/chat/tools/__init__.py
index 5b9b8649a8..82ce5cfd6f 100644
--- a/autogpt_platform/backend/backend/api/features/chat/tools/__init__.py
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/__init__.py
@@ -4,21 +4,44 @@ from openai.types.chat import ChatCompletionToolParam
 
 from backend.api.features.chat.model import ChatSession
 
+from .add_understanding import AddUnderstandingTool
+from .agent_output import AgentOutputTool
 from .base import BaseTool
+from .create_agent import CreateAgentTool
+from .edit_agent import EditAgentTool
 from .find_agent import FindAgentTool
+from .find_block import FindBlockTool
+from .find_library_agent import FindLibraryAgentTool
+from .get_doc_page import GetDocPageTool
 from .run_agent import RunAgentTool
+from .run_block import RunBlockTool
+from .search_docs import SearchDocsTool
 
 if TYPE_CHECKING:
-    from backend.api.features.chat.response_model import StreamToolExecutionResult
+    from backend.api.features.chat.response_model import StreamToolOutputAvailable
 
-# Initialize tool instances
-find_agent_tool = FindAgentTool()
-run_agent_tool = RunAgentTool()
+# Single source of truth for all tools
+TOOL_REGISTRY: dict[str, BaseTool] = {
+    "add_understanding": AddUnderstandingTool(),
+    "create_agent": CreateAgentTool(),
+    "edit_agent": EditAgentTool(),
+    "find_agent": FindAgentTool(),
+    "find_block": FindBlockTool(),
+    "find_library_agent": FindLibraryAgentTool(),
+    "run_agent": RunAgentTool(),
+    "run_block": RunBlockTool(),
+    "view_agent_output": AgentOutputTool(),
+    "search_docs": SearchDocsTool(),
+    "get_doc_page": GetDocPageTool(),
+}
 
-# Export tools as OpenAI format
+# Export individual tool instances for backwards compatibility
+find_agent_tool = TOOL_REGISTRY["find_agent"]
+run_agent_tool = TOOL_REGISTRY["run_agent"]
+
+# Generated from registry for OpenAI API
 tools: list[ChatCompletionToolParam] = [
-    find_agent_tool.as_openai_tool(),
-    run_agent_tool.as_openai_tool(),
+    tool.as_openai_tool() for tool in TOOL_REGISTRY.values()
 ]
 
 
@@ -28,14 +51,9 @@ async def execute_tool(
     user_id: str | None,
     session: ChatSession,
     tool_call_id: str,
-) -> "StreamToolExecutionResult":
-
-    tool_map: dict[str, BaseTool] = {
-        "find_agent": find_agent_tool,
-        "run_agent": run_agent_tool,
-    }
-    if tool_name not in tool_map:
+) -> "StreamToolOutputAvailable":
+    """Execute a tool by name."""
+    tool = TOOL_REGISTRY.get(tool_name)
+    if not tool:
         raise ValueError(f"Tool {tool_name} not found")
-    return await tool_map[tool_name].execute(
-        user_id, session, tool_call_id, **parameters
-    )
+    return await tool.execute(user_id, session, tool_call_id, **parameters)
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/_test_data.py b/autogpt_platform/backend/backend/api/features/chat/tools/_test_data.py
index f75b7bb0d0..a8f208ebb0 100644
--- a/autogpt_platform/backend/backend/api/features/chat/tools/_test_data.py
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/_test_data.py
@@ -3,6 +3,7 @@ from datetime import UTC, datetime
 from os import getenv
 
 import pytest
+from prisma.types import ProfileCreateInput
 from pydantic import SecretStr
 
 from backend.api.features.chat.model import ChatSession
@@ -17,7 +18,7 @@ from backend.data.user import get_or_create_user
 from backend.integrations.credentials_store import IntegrationCredentialsStore
 
 
-def make_session(user_id: str | None = None):
+def make_session(user_id: str):
     return ChatSession(
         session_id=str(uuid.uuid4()),
         user_id=user_id,
@@ -49,13 +50,13 @@ async def setup_test_data():
     # 1b. Create a profile with username for the user (required for store agent lookup)
     username = user.email.split("@")[0]
     await prisma.profile.create(
-        data={
-            "userId": user.id,
-            "username": username,
-            "name": f"Test User {username}",
-            "description": "Test user profile",
-            "links": [],  # Required field - empty array for test profiles
-        }
+        data=ProfileCreateInput(
+            userId=user.id,
+            username=username,
+            name=f"Test User {username}",
+            description="Test user profile",
+            links=[],  # Required field - empty array for test profiles
+        )
     )
 
     # 2. Create a test graph with agent input -> agent output
@@ -172,13 +173,13 @@ async def setup_llm_test_data():
     # 1b. Create a profile with username for the user (required for store agent lookup)
     username = user.email.split("@")[0]
     await prisma.profile.create(
-        data={
-            "userId": user.id,
-            "username": username,
-            "name": f"Test User {username}",
-            "description": "Test user profile for LLM tests",
-            "links": [],  # Required field - empty array for test profiles
-        }
+        data=ProfileCreateInput(
+            userId=user.id,
+            username=username,
+            name=f"Test User {username}",
+            description="Test user profile for LLM tests",
+            links=[],  # Required field - empty array for test profiles
+        )
     )
 
     # 2. Create test OpenAI credentials for the user
@@ -332,13 +333,13 @@ async def setup_firecrawl_test_data():
     # 1b. Create a profile with username for the user (required for store agent lookup)
     username = user.email.split("@")[0]
     await prisma.profile.create(
-        data={
-            "userId": user.id,
-            "username": username,
-            "name": f"Test User {username}",
-            "description": "Test user profile for Firecrawl tests",
-            "links": [],  # Required field - empty array for test profiles
-        }
+        data=ProfileCreateInput(
+            userId=user.id,
+            username=username,
+            name=f"Test User {username}",
+            description="Test user profile for Firecrawl tests",
+            links=[],  # Required field - empty array for test profiles
+        )
     )
 
     # NOTE: We deliberately do NOT create Firecrawl credentials for this user
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/add_understanding.py b/autogpt_platform/backend/backend/api/features/chat/tools/add_understanding.py
new file mode 100644
index 0000000000..bd93f0e2a6
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/add_understanding.py
@@ -0,0 +1,122 @@
+"""Tool for capturing user business understanding incrementally."""
+
+import logging
+from typing import Any
+
+from langfuse import observe
+
+from backend.api.features.chat.model import ChatSession
+from backend.data.understanding import (
+    BusinessUnderstandingInput,
+    upsert_business_understanding,
+)
+
+from .base import BaseTool
+from .models import ErrorResponse, ToolResponseBase, UnderstandingUpdatedResponse
+
+logger = logging.getLogger(__name__)
+
+
+class AddUnderstandingTool(BaseTool):
+    """Tool for capturing user's business understanding incrementally."""
+
+    @property
+    def name(self) -> str:
+        return "add_understanding"
+
+    @property
+    def description(self) -> str:
+        return """Capture and store information about the user's business context,
+workflows, pain points, and automation goals. Call this tool whenever the user
+shares information about their business. Each call incrementally adds to the
+existing understanding - you don't need to provide all fields at once.
+
+Use this to build a comprehensive profile that helps recommend better agents
+and automations for the user's specific needs."""
+
+    @property
+    def parameters(self) -> dict[str, Any]:
+        # Auto-generate from Pydantic model schema
+        schema = BusinessUnderstandingInput.model_json_schema()
+        properties = {}
+        for field_name, field_schema in schema.get("properties", {}).items():
+            prop: dict[str, Any] = {"description": field_schema.get("description", "")}
+            # Handle anyOf for Optional types
+            if "anyOf" in field_schema:
+                for option in field_schema["anyOf"]:
+                    if option.get("type") != "null":
+                        prop["type"] = option.get("type", "string")
+                        if "items" in option:
+                            prop["items"] = option["items"]
+                        break
+            else:
+                prop["type"] = field_schema.get("type", "string")
+                if "items" in field_schema:
+                    prop["items"] = field_schema["items"]
+            properties[field_name] = prop
+        return {"type": "object", "properties": properties, "required": []}
+
+    @property
+    def requires_auth(self) -> bool:
+        """Requires authentication to store user-specific data."""
+        return True
+
+    @observe(as_type="tool", name="add_understanding")
+    async def _execute(
+        self,
+        user_id: str | None,
+        session: ChatSession,
+        **kwargs,
+    ) -> ToolResponseBase:
+        """
+        Capture and store business understanding incrementally.
+
+        Each call merges new data with existing understanding:
+        - String fields are overwritten if provided
+        - List fields are appended (with deduplication)
+        """
+        session_id = session.session_id
+
+        if not user_id:
+            return ErrorResponse(
+                message="Authentication required to save business understanding.",
+                session_id=session_id,
+            )
+
+        # Check if any data was provided
+        if not any(v is not None for v in kwargs.values()):
+            return ErrorResponse(
+                message="Please provide at least one field to update.",
+                session_id=session_id,
+            )
+
+        # Build input model from kwargs (only include fields defined in the model)
+        valid_fields = set(BusinessUnderstandingInput.model_fields.keys())
+        input_data = BusinessUnderstandingInput(
+            **{k: v for k, v in kwargs.items() if k in valid_fields}
+        )
+
+        # Track which fields were updated
+        updated_fields = [
+            k for k, v in kwargs.items() if k in valid_fields and v is not None
+        ]
+
+        # Upsert with merge
+        understanding = await upsert_business_understanding(user_id, input_data)
+
+        # Build current understanding summary (filter out empty values)
+        current_understanding = {
+            k: v
+            for k, v in understanding.model_dump(
+                exclude={"id", "user_id", "created_at", "updated_at"}
+            ).items()
+            if v is not None and v != [] and v != ""
+        }
+
+        return UnderstandingUpdatedResponse(
+            message=f"Updated understanding with: {', '.join(updated_fields)}. "
+            "I now have a better picture of your business context.",
+            session_id=session_id,
+            updated_fields=updated_fields,
+            current_understanding=current_understanding,
+        )
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/__init__.py b/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/__init__.py
new file mode 100644
index 0000000000..d4df2564a8
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/__init__.py
@@ -0,0 +1,29 @@
+"""Agent generator package - Creates agents from natural language."""
+
+from .core import (
+    apply_agent_patch,
+    decompose_goal,
+    generate_agent,
+    generate_agent_patch,
+    get_agent_as_json,
+    save_agent_to_library,
+)
+from .fixer import apply_all_fixes
+from .utils import get_blocks_info
+from .validator import validate_agent
+
+__all__ = [
+    # Core functions
+    "decompose_goal",
+    "generate_agent",
+    "generate_agent_patch",
+    "apply_agent_patch",
+    "save_agent_to_library",
+    "get_agent_as_json",
+    # Fixer
+    "apply_all_fixes",
+    # Validator
+    "validate_agent",
+    # Utils
+    "get_blocks_info",
+]
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/client.py b/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/client.py
new file mode 100644
index 0000000000..4450fa9d75
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/client.py
@@ -0,0 +1,25 @@
+"""OpenRouter client configuration for agent generation."""
+
+import os
+
+from openai import AsyncOpenAI
+
+# Configuration - use OPEN_ROUTER_API_KEY for consistency with chat/config.py
+OPENROUTER_API_KEY = os.getenv("OPEN_ROUTER_API_KEY")
+AGENT_GENERATOR_MODEL = os.getenv("AGENT_GENERATOR_MODEL", "anthropic/claude-opus-4.5")
+
+# OpenRouter client (OpenAI-compatible API)
+_client: AsyncOpenAI | None = None
+
+
+def get_client() -> AsyncOpenAI:
+    """Get or create the OpenRouter client."""
+    global _client
+    if _client is None:
+        if not OPENROUTER_API_KEY:
+            raise ValueError("OPENROUTER_API_KEY environment variable is required")
+        _client = AsyncOpenAI(
+            base_url="https://openrouter.ai/api/v1",
+            api_key=OPENROUTER_API_KEY,
+        )
+    return _client
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/core.py b/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/core.py
new file mode 100644
index 0000000000..aa3cc1555d
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/core.py
@@ -0,0 +1,390 @@
+"""Core agent generation functions."""
+
+import copy
+import json
+import logging
+import uuid
+from typing import Any
+
+from backend.api.features.library import db as library_db
+from backend.data.graph import Graph, Link, Node, create_graph
+
+from .client import AGENT_GENERATOR_MODEL, get_client
+from .prompts import DECOMPOSITION_PROMPT, GENERATION_PROMPT, PATCH_PROMPT
+from .utils import get_block_summaries, parse_json_from_llm
+
+logger = logging.getLogger(__name__)
+
+
+async def decompose_goal(description: str, context: str = "") -> dict[str, Any] | None:
+    """Break down a goal into steps or return clarifying questions.
+
+    Args:
+        description: Natural language goal description
+        context: Additional context (e.g., answers to previous questions)
+
+    Returns:
+        Dict with either:
+        - {"type": "clarifying_questions", "questions": [...]}
+        - {"type": "instructions", "steps": [...]}
+        Or None on error
+    """
+    client = get_client()
+    prompt = DECOMPOSITION_PROMPT.format(block_summaries=get_block_summaries())
+
+    full_description = description
+    if context:
+        full_description = f"{description}\n\nAdditional context:\n{context}"
+
+    try:
+        response = await client.chat.completions.create(
+            model=AGENT_GENERATOR_MODEL,
+            messages=[
+                {"role": "system", "content": prompt},
+                {"role": "user", "content": full_description},
+            ],
+            temperature=0,
+        )
+
+        content = response.choices[0].message.content
+        if content is None:
+            logger.error("LLM returned empty content for decomposition")
+            return None
+
+        result = parse_json_from_llm(content)
+
+        if result is None:
+            logger.error(f"Failed to parse decomposition response: {content[:200]}")
+            return None
+
+        return result
+
+    except Exception as e:
+        logger.error(f"Error decomposing goal: {e}")
+        return None
+
+
+async def generate_agent(instructions: dict[str, Any]) -> dict[str, Any] | None:
+    """Generate agent JSON from instructions.
+
+    Args:
+        instructions: Structured instructions from decompose_goal
+
+    Returns:
+        Agent JSON dict or None on error
+    """
+    client = get_client()
+    prompt = GENERATION_PROMPT.format(block_summaries=get_block_summaries())
+
+    try:
+        response = await client.chat.completions.create(
+            model=AGENT_GENERATOR_MODEL,
+            messages=[
+                {"role": "system", "content": prompt},
+                {"role": "user", "content": json.dumps(instructions, indent=2)},
+            ],
+            temperature=0,
+        )
+
+        content = response.choices[0].message.content
+        if content is None:
+            logger.error("LLM returned empty content for agent generation")
+            return None
+
+        result = parse_json_from_llm(content)
+
+        if result is None:
+            logger.error(f"Failed to parse agent JSON: {content[:200]}")
+            return None
+
+        # Ensure required fields
+        if "id" not in result:
+            result["id"] = str(uuid.uuid4())
+        if "version" not in result:
+            result["version"] = 1
+        if "is_active" not in result:
+            result["is_active"] = True
+
+        return result
+
+    except Exception as e:
+        logger.error(f"Error generating agent: {e}")
+        return None
+
+
+def json_to_graph(agent_json: dict[str, Any]) -> Graph:
+    """Convert agent JSON dict to Graph model.
+
+    Args:
+        agent_json: Agent JSON with nodes and links
+
+    Returns:
+        Graph ready for saving
+    """
+    nodes = []
+    for n in agent_json.get("nodes", []):
+        node = Node(
+            id=n.get("id", str(uuid.uuid4())),
+            block_id=n["block_id"],
+            input_default=n.get("input_default", {}),
+            metadata=n.get("metadata", {}),
+        )
+        nodes.append(node)
+
+    links = []
+    for link_data in agent_json.get("links", []):
+        link = Link(
+            id=link_data.get("id", str(uuid.uuid4())),
+            source_id=link_data["source_id"],
+            sink_id=link_data["sink_id"],
+            source_name=link_data["source_name"],
+            sink_name=link_data["sink_name"],
+            is_static=link_data.get("is_static", False),
+        )
+        links.append(link)
+
+    return Graph(
+        id=agent_json.get("id", str(uuid.uuid4())),
+        version=agent_json.get("version", 1),
+        is_active=agent_json.get("is_active", True),
+        name=agent_json.get("name", "Generated Agent"),
+        description=agent_json.get("description", ""),
+        nodes=nodes,
+        links=links,
+    )
+
+
+def _reassign_node_ids(graph: Graph) -> None:
+    """Reassign all node and link IDs to new UUIDs.
+
+    This is needed when creating a new version to avoid unique constraint violations.
+    """
+    # Create mapping from old node IDs to new UUIDs
+    id_map = {node.id: str(uuid.uuid4()) for node in graph.nodes}
+
+    # Reassign node IDs
+    for node in graph.nodes:
+        node.id = id_map[node.id]
+
+    # Update link references to use new node IDs
+    for link in graph.links:
+        link.id = str(uuid.uuid4())  # Also give links new IDs
+        if link.source_id in id_map:
+            link.source_id = id_map[link.source_id]
+        if link.sink_id in id_map:
+            link.sink_id = id_map[link.sink_id]
+
+
+async def save_agent_to_library(
+    agent_json: dict[str, Any], user_id: str, is_update: bool = False
+) -> tuple[Graph, Any]:
+    """Save agent to database and user's library.
+
+    Args:
+        agent_json: Agent JSON dict
+        user_id: User ID
+        is_update: Whether this is an update to an existing agent
+
+    Returns:
+        Tuple of (created Graph, LibraryAgent)
+    """
+    from backend.data.graph import get_graph_all_versions
+
+    graph = json_to_graph(agent_json)
+
+    if is_update:
+        # For updates, keep the same graph ID but increment version
+        # and reassign node/link IDs to avoid conflicts
+        if graph.id:
+            existing_versions = await get_graph_all_versions(graph.id, user_id)
+            if existing_versions:
+                latest_version = max(v.version for v in existing_versions)
+                graph.version = latest_version + 1
+                # Reassign node IDs (but keep graph ID the same)
+                _reassign_node_ids(graph)
+                logger.info(f"Updating agent {graph.id} to version {graph.version}")
+    else:
+        # For new agents, always generate a fresh UUID to avoid collisions
+        graph.id = str(uuid.uuid4())
+        graph.version = 1
+        # Reassign all node IDs as well
+        _reassign_node_ids(graph)
+        logger.info(f"Creating new agent with ID {graph.id}")
+
+    # Save to database
+    created_graph = await create_graph(graph, user_id)
+
+    # Add to user's library (or update existing library agent)
+    library_agents = await library_db.create_library_agent(
+        graph=created_graph,
+        user_id=user_id,
+        create_library_agents_for_sub_graphs=False,
+    )
+
+    return created_graph, library_agents[0]
+
+
+async def get_agent_as_json(
+    graph_id: str, user_id: str | None
+) -> dict[str, Any] | None:
+    """Fetch an agent and convert to JSON format for editing.
+
+    Args:
+        graph_id: Graph ID or library agent ID
+        user_id: User ID
+
+    Returns:
+        Agent as JSON dict or None if not found
+    """
+    from backend.data.graph import get_graph
+
+    # Try to get the graph (version=None gets the active version)
+    graph = await get_graph(graph_id, version=None, user_id=user_id)
+    if not graph:
+        return None
+
+    # Convert to JSON format
+    nodes = []
+    for node in graph.nodes:
+        nodes.append(
+            {
+                "id": node.id,
+                "block_id": node.block_id,
+                "input_default": node.input_default,
+                "metadata": node.metadata,
+            }
+        )
+
+    links = []
+    for node in graph.nodes:
+        for link in node.output_links:
+            links.append(
+                {
+                    "id": link.id,
+                    "source_id": link.source_id,
+                    "sink_id": link.sink_id,
+                    "source_name": link.source_name,
+                    "sink_name": link.sink_name,
+                    "is_static": link.is_static,
+                }
+            )
+
+    return {
+        "id": graph.id,
+        "name": graph.name,
+        "description": graph.description,
+        "version": graph.version,
+        "is_active": graph.is_active,
+        "nodes": nodes,
+        "links": links,
+    }
+
+
+async def generate_agent_patch(
+    update_request: str, current_agent: dict[str, Any]
+) -> dict[str, Any] | None:
+    """Generate a patch to update an existing agent.
+
+    Args:
+        update_request: Natural language description of changes
+        current_agent: Current agent JSON
+
+    Returns:
+        Patch dict or clarifying questions, or None on error
+    """
+    client = get_client()
+    prompt = PATCH_PROMPT.format(
+        current_agent=json.dumps(current_agent, indent=2),
+        block_summaries=get_block_summaries(),
+    )
+
+    try:
+        response = await client.chat.completions.create(
+            model=AGENT_GENERATOR_MODEL,
+            messages=[
+                {"role": "system", "content": prompt},
+                {"role": "user", "content": update_request},
+            ],
+            temperature=0,
+        )
+
+        content = response.choices[0].message.content
+        if content is None:
+            logger.error("LLM returned empty content for patch generation")
+            return None
+
+        return parse_json_from_llm(content)
+
+    except Exception as e:
+        logger.error(f"Error generating patch: {e}")
+        return None
+
+
+def apply_agent_patch(
+    current_agent: dict[str, Any], patch: dict[str, Any]
+) -> dict[str, Any]:
+    """Apply a patch to an existing agent.
+
+    Args:
+        current_agent: Current agent JSON
+        patch: Patch dict with operations
+
+    Returns:
+        Updated agent JSON
+    """
+    agent = copy.deepcopy(current_agent)
+    patches = patch.get("patches", [])
+
+    for p in patches:
+        patch_type = p.get("type")
+
+        if patch_type == "modify":
+            node_id = p.get("node_id")
+            changes = p.get("changes", {})
+
+            for node in agent.get("nodes", []):
+                if node["id"] == node_id:
+                    _deep_update(node, changes)
+                    logger.debug(f"Modified node {node_id}")
+                    break
+
+        elif patch_type == "add":
+            new_nodes = p.get("new_nodes", [])
+            new_links = p.get("new_links", [])
+
+            agent["nodes"] = agent.get("nodes", []) + new_nodes
+            agent["links"] = agent.get("links", []) + new_links
+            logger.debug(f"Added {len(new_nodes)} nodes, {len(new_links)} links")
+
+        elif patch_type == "remove":
+            node_ids_to_remove = set(p.get("node_ids", []))
+            link_ids_to_remove = set(p.get("link_ids", []))
+
+            # Remove nodes
+            agent["nodes"] = [
+                n for n in agent.get("nodes", []) if n["id"] not in node_ids_to_remove
+            ]
+
+            # Remove links (both explicit and those referencing removed nodes)
+            agent["links"] = [
+                link
+                for link in agent.get("links", [])
+                if link["id"] not in link_ids_to_remove
+                and link["source_id"] not in node_ids_to_remove
+                and link["sink_id"] not in node_ids_to_remove
+            ]
+
+            logger.debug(
+                f"Removed {len(node_ids_to_remove)} nodes, {len(link_ids_to_remove)} links"
+            )
+
+    return agent
+
+
+def _deep_update(target: dict, source: dict) -> None:
+    """Recursively update a dict with another dict."""
+    for key, value in source.items():
+        if key in target and isinstance(target[key], dict) and isinstance(value, dict):
+            _deep_update(target[key], value)
+        else:
+            target[key] = value
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/fixer.py b/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/fixer.py
new file mode 100644
index 0000000000..1e25e0cbed
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/fixer.py
@@ -0,0 +1,606 @@
+"""Agent fixer - Fixes common LLM generation errors."""
+
+import logging
+import re
+import uuid
+from typing import Any
+
+from .utils import (
+    ADDTODICTIONARY_BLOCK_ID,
+    ADDTOLIST_BLOCK_ID,
+    CODE_EXECUTION_BLOCK_ID,
+    CONDITION_BLOCK_ID,
+    CREATEDICT_BLOCK_ID,
+    CREATELIST_BLOCK_ID,
+    DATA_SAMPLING_BLOCK_ID,
+    DOUBLE_CURLY_BRACES_BLOCK_IDS,
+    GET_CURRENT_DATE_BLOCK_ID,
+    STORE_VALUE_BLOCK_ID,
+    UNIVERSAL_TYPE_CONVERTER_BLOCK_ID,
+    get_blocks_info,
+    is_valid_uuid,
+)
+
+logger = logging.getLogger(__name__)
+
+
+def fix_agent_ids(agent: dict[str, Any]) -> dict[str, Any]:
+    """Fix invalid UUIDs in agent and link IDs."""
+    # Fix agent ID
+    if not is_valid_uuid(agent.get("id", "")):
+        agent["id"] = str(uuid.uuid4())
+        logger.debug(f"Fixed agent ID: {agent['id']}")
+
+    # Fix node IDs
+    id_mapping = {}  # Old ID -> New ID
+    for node in agent.get("nodes", []):
+        if not is_valid_uuid(node.get("id", "")):
+            old_id = node.get("id", "")
+            new_id = str(uuid.uuid4())
+            id_mapping[old_id] = new_id
+            node["id"] = new_id
+            logger.debug(f"Fixed node ID: {old_id} -> {new_id}")
+
+    # Fix link IDs and update references
+    for link in agent.get("links", []):
+        if not is_valid_uuid(link.get("id", "")):
+            link["id"] = str(uuid.uuid4())
+            logger.debug(f"Fixed link ID: {link['id']}")
+
+        # Update source/sink IDs if they were remapped
+        if link.get("source_id") in id_mapping:
+            link["source_id"] = id_mapping[link["source_id"]]
+        if link.get("sink_id") in id_mapping:
+            link["sink_id"] = id_mapping[link["sink_id"]]
+
+    return agent
+
+
+def fix_double_curly_braces(agent: dict[str, Any]) -> dict[str, Any]:
+    """Fix single curly braces to double in template blocks."""
+    for node in agent.get("nodes", []):
+        if node.get("block_id") not in DOUBLE_CURLY_BRACES_BLOCK_IDS:
+            continue
+
+        input_data = node.get("input_default", {})
+        for key in ("prompt", "format"):
+            if key in input_data and isinstance(input_data[key], str):
+                original = input_data[key]
+                # Fix simple variable references: {var} -> {{var}}
+                fixed = re.sub(
+                    r"(?<!\{)\{([a-zA-Z_][a-zA-Z0-9_]*)\}(?!\})",
+                    r"{{\1}}",
+                    original,
+                )
+                if fixed != original:
+                    input_data[key] = fixed
+                    logger.debug(f"Fixed curly braces in {key}")
+
+    return agent
+
+
+def fix_storevalue_before_condition(agent: dict[str, Any]) -> dict[str, Any]:
+    """Add StoreValueBlock before ConditionBlock if needed for value2."""
+    nodes = agent.get("nodes", [])
+    links = agent.get("links", [])
+
+    # Find all ConditionBlock nodes
+    condition_node_ids = {
+        node["id"] for node in nodes if node.get("block_id") == CONDITION_BLOCK_ID
+    }
+
+    if not condition_node_ids:
+        return agent
+
+    new_nodes = []
+    new_links = []
+    processed_conditions = set()
+
+    for link in links:
+        sink_id = link.get("sink_id")
+        sink_name = link.get("sink_name")
+
+        # Check if this link goes to a ConditionBlock's value2
+        if sink_id in condition_node_ids and sink_name == "value2":
+            source_node = next(
+                (n for n in nodes if n["id"] == link.get("source_id")), None
+            )
+
+            # Skip if source is already a StoreValueBlock
+            if source_node and source_node.get("block_id") == STORE_VALUE_BLOCK_ID:
+                continue
+
+            # Skip if we already processed this condition
+            if sink_id in processed_conditions:
+                continue
+
+            processed_conditions.add(sink_id)
+
+            # Create StoreValueBlock
+            store_node_id = str(uuid.uuid4())
+            store_node = {
+                "id": store_node_id,
+                "block_id": STORE_VALUE_BLOCK_ID,
+                "input_default": {"data": None},
+                "metadata": {"position": {"x": 0, "y": -100}},
+            }
+            new_nodes.append(store_node)
+
+            # Create link: original source -> StoreValueBlock
+            new_links.append(
+                {
+                    "id": str(uuid.uuid4()),
+                    "source_id": link["source_id"],
+                    "source_name": link["source_name"],
+                    "sink_id": store_node_id,
+                    "sink_name": "input",
+                    "is_static": False,
+                }
+            )
+
+            # Update original link: StoreValueBlock -> ConditionBlock
+            link["source_id"] = store_node_id
+            link["source_name"] = "output"
+
+            logger.debug(f"Added StoreValueBlock before ConditionBlock {sink_id}")
+
+    if new_nodes:
+        agent["nodes"] = nodes + new_nodes
+
+    return agent
+
+
+def fix_addtolist_blocks(agent: dict[str, Any]) -> dict[str, Any]:
+    """Fix AddToList blocks by adding prerequisite empty AddToList block.
+
+    When an AddToList block is found:
+    1. Checks if there's a CreateListBlock before it
+    2. Removes CreateListBlock if linked directly to AddToList
+    3. Adds an empty AddToList block before the original
+    4. Ensures the original has a self-referencing link
+    """
+    nodes = agent.get("nodes", [])
+    links = agent.get("links", [])
+    new_nodes = []
+    original_addtolist_ids = set()
+    nodes_to_remove = set()
+    links_to_remove = []
+
+    # First pass: identify CreateListBlock nodes to remove
+    for link in links:
+        source_node = next(
+            (n for n in nodes if n.get("id") == link.get("source_id")), None
+        )
+        sink_node = next((n for n in nodes if n.get("id") == link.get("sink_id")), None)
+
+        if (
+            source_node
+            and sink_node
+            and source_node.get("block_id") == CREATELIST_BLOCK_ID
+            and sink_node.get("block_id") == ADDTOLIST_BLOCK_ID
+        ):
+            nodes_to_remove.add(source_node.get("id"))
+            links_to_remove.append(link)
+            logger.debug(f"Removing CreateListBlock {source_node.get('id')}")
+
+    # Second pass: process AddToList blocks
+    filtered_nodes = []
+    for node in nodes:
+        if node.get("id") in nodes_to_remove:
+            continue
+
+        if node.get("block_id") == ADDTOLIST_BLOCK_ID:
+            original_addtolist_ids.add(node.get("id"))
+            node_id = node.get("id")
+            pos = node.get("metadata", {}).get("position", {"x": 0, "y": 0})
+
+            # Check if already has prerequisite
+            has_prereq = any(
+                link.get("sink_id") == node_id
+                and link.get("sink_name") == "list"
+                and link.get("source_name") == "updated_list"
+                for link in links
+            )
+
+            if not has_prereq:
+                # Remove links to "list" input (except self-reference)
+                for link in links:
+                    if (
+                        link.get("sink_id") == node_id
+                        and link.get("sink_name") == "list"
+                        and link.get("source_id") != node_id
+                        and link not in links_to_remove
+                    ):
+                        links_to_remove.append(link)
+
+                # Create prerequisite AddToList block
+                prereq_id = str(uuid.uuid4())
+                prereq_node = {
+                    "id": prereq_id,
+                    "block_id": ADDTOLIST_BLOCK_ID,
+                    "input_default": {"list": [], "entry": None, "entries": []},
+                    "metadata": {
+                        "position": {"x": pos.get("x", 0) - 800, "y": pos.get("y", 0)}
+                    },
+                }
+                new_nodes.append(prereq_node)
+
+                # Link prerequisite to original
+                links.append(
+                    {
+                        "id": str(uuid.uuid4()),
+                        "source_id": prereq_id,
+                        "source_name": "updated_list",
+                        "sink_id": node_id,
+                        "sink_name": "list",
+                        "is_static": False,
+                    }
+                )
+                logger.debug(f"Added prerequisite AddToList block for {node_id}")
+
+        filtered_nodes.append(node)
+
+    # Remove marked links
+    filtered_links = [link for link in links if link not in links_to_remove]
+
+    # Add self-referencing links for original AddToList blocks
+    for node in filtered_nodes + new_nodes:
+        if (
+            node.get("block_id") == ADDTOLIST_BLOCK_ID
+            and node.get("id") in original_addtolist_ids
+        ):
+            node_id = node.get("id")
+            has_self_ref = any(
+                link["source_id"] == node_id
+                and link["sink_id"] == node_id
+                and link["source_name"] == "updated_list"
+                and link["sink_name"] == "list"
+                for link in filtered_links
+            )
+            if not has_self_ref:
+                filtered_links.append(
+                    {
+                        "id": str(uuid.uuid4()),
+                        "source_id": node_id,
+                        "source_name": "updated_list",
+                        "sink_id": node_id,
+                        "sink_name": "list",
+                        "is_static": False,
+                    }
+                )
+                logger.debug(f"Added self-reference for AddToList {node_id}")
+
+    agent["nodes"] = filtered_nodes + new_nodes
+    agent["links"] = filtered_links
+    return agent
+
+
+def fix_addtodictionary_blocks(agent: dict[str, Any]) -> dict[str, Any]:
+    """Fix AddToDictionary blocks by removing empty CreateDictionary nodes."""
+    nodes = agent.get("nodes", [])
+    links = agent.get("links", [])
+    nodes_to_remove = set()
+    links_to_remove = []
+
+    for link in links:
+        source_node = next(
+            (n for n in nodes if n.get("id") == link.get("source_id")), None
+        )
+        sink_node = next((n for n in nodes if n.get("id") == link.get("sink_id")), None)
+
+        if (
+            source_node
+            and sink_node
+            and source_node.get("block_id") == CREATEDICT_BLOCK_ID
+            and sink_node.get("block_id") == ADDTODICTIONARY_BLOCK_ID
+        ):
+            nodes_to_remove.add(source_node.get("id"))
+            links_to_remove.append(link)
+            logger.debug(f"Removing CreateDictionary {source_node.get('id')}")
+
+    agent["nodes"] = [n for n in nodes if n.get("id") not in nodes_to_remove]
+    agent["links"] = [link for link in links if link not in links_to_remove]
+    return agent
+
+
+def fix_code_execution_output(agent: dict[str, Any]) -> dict[str, Any]:
+    """Fix CodeExecutionBlock output: change 'response' to 'stdout_logs'."""
+    nodes = agent.get("nodes", [])
+    links = agent.get("links", [])
+
+    for link in links:
+        source_node = next(
+            (n for n in nodes if n.get("id") == link.get("source_id")), None
+        )
+        if (
+            source_node
+            and source_node.get("block_id") == CODE_EXECUTION_BLOCK_ID
+            and link.get("source_name") == "response"
+        ):
+            link["source_name"] = "stdout_logs"
+            logger.debug("Fixed CodeExecutionBlock output: response -> stdout_logs")
+
+    return agent
+
+
+def fix_data_sampling_sample_size(agent: dict[str, Any]) -> dict[str, Any]:
+    """Fix DataSamplingBlock by setting sample_size to 1 as default."""
+    nodes = agent.get("nodes", [])
+    links = agent.get("links", [])
+    links_to_remove = []
+
+    for node in nodes:
+        if node.get("block_id") == DATA_SAMPLING_BLOCK_ID:
+            node_id = node.get("id")
+            input_default = node.get("input_default", {})
+
+            # Remove links to sample_size
+            for link in links:
+                if (
+                    link.get("sink_id") == node_id
+                    and link.get("sink_name") == "sample_size"
+                ):
+                    links_to_remove.append(link)
+
+            # Set default
+            input_default["sample_size"] = 1
+            node["input_default"] = input_default
+            logger.debug(f"Fixed DataSamplingBlock {node_id} sample_size to 1")
+
+    if links_to_remove:
+        agent["links"] = [link for link in links if link not in links_to_remove]
+
+    return agent
+
+
+def fix_node_x_coordinates(agent: dict[str, Any]) -> dict[str, Any]:
+    """Fix node x-coordinates to ensure 800+ unit spacing between linked nodes."""
+    nodes = agent.get("nodes", [])
+    links = agent.get("links", [])
+    node_lookup = {n.get("id"): n for n in nodes}
+
+    for link in links:
+        source_id = link.get("source_id")
+        sink_id = link.get("sink_id")
+
+        source_node = node_lookup.get(source_id)
+        sink_node = node_lookup.get(sink_id)
+
+        if not source_node or not sink_node:
+            continue
+
+        source_pos = source_node.get("metadata", {}).get("position", {})
+        sink_pos = sink_node.get("metadata", {}).get("position", {})
+
+        source_x = source_pos.get("x", 0)
+        sink_x = sink_pos.get("x", 0)
+
+        if abs(sink_x - source_x) < 800:
+            new_x = source_x + 800
+            if "metadata" not in sink_node:
+                sink_node["metadata"] = {}
+            if "position" not in sink_node["metadata"]:
+                sink_node["metadata"]["position"] = {}
+            sink_node["metadata"]["position"]["x"] = new_x
+            logger.debug(f"Fixed node {sink_id} x: {sink_x} -> {new_x}")
+
+    return agent
+
+
+def fix_getcurrentdate_offset(agent: dict[str, Any]) -> dict[str, Any]:
+    """Fix GetCurrentDateBlock offset to ensure it's positive."""
+    for node in agent.get("nodes", []):
+        if node.get("block_id") == GET_CURRENT_DATE_BLOCK_ID:
+            input_default = node.get("input_default", {})
+            if "offset" in input_default:
+                offset = input_default["offset"]
+                if isinstance(offset, (int, float)) and offset < 0:
+                    input_default["offset"] = abs(offset)
+                    logger.debug(f"Fixed offset: {offset} -> {abs(offset)}")
+
+    return agent
+
+
+def fix_ai_model_parameter(
+    agent: dict[str, Any],
+    blocks_info: list[dict[str, Any]],
+    default_model: str = "gpt-4o",
+) -> dict[str, Any]:
+    """Add default model parameter to AI blocks if missing."""
+    block_map = {b.get("id"): b for b in blocks_info}
+
+    for node in agent.get("nodes", []):
+        block_id = node.get("block_id")
+        block = block_map.get(block_id)
+
+        if not block:
+            continue
+
+        # Check if block has AI category
+        categories = block.get("categories", [])
+        is_ai_block = any(
+            cat.get("category") == "AI" for cat in categories if isinstance(cat, dict)
+        )
+
+        if is_ai_block:
+            input_default = node.get("input_default", {})
+            if "model" not in input_default:
+                input_default["model"] = default_model
+                node["input_default"] = input_default
+                logger.debug(
+                    f"Added model '{default_model}' to AI block {node.get('id')}"
+                )
+
+    return agent
+
+
+def fix_link_static_properties(
+    agent: dict[str, Any], blocks_info: list[dict[str, Any]]
+) -> dict[str, Any]:
+    """Fix is_static property based on source block's staticOutput."""
+    block_map = {b.get("id"): b for b in blocks_info}
+    node_lookup = {n.get("id"): n for n in agent.get("nodes", [])}
+
+    for link in agent.get("links", []):
+        source_node = node_lookup.get(link.get("source_id"))
+        if not source_node:
+            continue
+
+        source_block = block_map.get(source_node.get("block_id"))
+        if not source_block:
+            continue
+
+        static_output = source_block.get("staticOutput", False)
+        if link.get("is_static") != static_output:
+            link["is_static"] = static_output
+            logger.debug(f"Fixed link {link.get('id')} is_static to {static_output}")
+
+    return agent
+
+
+def fix_data_type_mismatch(
+    agent: dict[str, Any], blocks_info: list[dict[str, Any]]
+) -> dict[str, Any]:
+    """Fix data type mismatches by inserting UniversalTypeConverterBlock."""
+    nodes = agent.get("nodes", [])
+    links = agent.get("links", [])
+    block_map = {b.get("id"): b for b in blocks_info}
+    node_lookup = {n.get("id"): n for n in nodes}
+
+    def get_property_type(schema: dict, name: str) -> str | None:
+        if "_#_" in name:
+            parent, child = name.split("_#_", 1)
+            parent_schema = schema.get(parent, {})
+            if "properties" in parent_schema:
+                return parent_schema["properties"].get(child, {}).get("type")
+            return None
+        return schema.get(name, {}).get("type")
+
+    def are_types_compatible(src: str, sink: str) -> bool:
+        if {src, sink} <= {"integer", "number"}:
+            return True
+        return src == sink
+
+    type_mapping = {
+        "string": "string",
+        "text": "string",
+        "integer": "number",
+        "number": "number",
+        "float": "number",
+        "boolean": "boolean",
+        "bool": "boolean",
+        "array": "list",
+        "list": "list",
+        "object": "dictionary",
+        "dict": "dictionary",
+        "dictionary": "dictionary",
+    }
+
+    new_links = []
+    nodes_to_add = []
+
+    for link in links:
+        source_node = node_lookup.get(link.get("source_id"))
+        sink_node = node_lookup.get(link.get("sink_id"))
+
+        if not source_node or not sink_node:
+            new_links.append(link)
+            continue
+
+        source_block = block_map.get(source_node.get("block_id"))
+        sink_block = block_map.get(sink_node.get("block_id"))
+
+        if not source_block or not sink_block:
+            new_links.append(link)
+            continue
+
+        source_outputs = source_block.get("outputSchema", {}).get("properties", {})
+        sink_inputs = sink_block.get("inputSchema", {}).get("properties", {})
+
+        source_type = get_property_type(source_outputs, link.get("source_name", ""))
+        sink_type = get_property_type(sink_inputs, link.get("sink_name", ""))
+
+        if (
+            source_type
+            and sink_type
+            and not are_types_compatible(source_type, sink_type)
+        ):
+            # Insert type converter
+            converter_id = str(uuid.uuid4())
+            target_type = type_mapping.get(sink_type, sink_type)
+
+            converter_node = {
+                "id": converter_id,
+                "block_id": UNIVERSAL_TYPE_CONVERTER_BLOCK_ID,
+                "input_default": {"type": target_type},
+                "metadata": {"position": {"x": 0, "y": 100}},
+            }
+            nodes_to_add.append(converter_node)
+
+            # source -> converter
+            new_links.append(
+                {
+                    "id": str(uuid.uuid4()),
+                    "source_id": link["source_id"],
+                    "source_name": link["source_name"],
+                    "sink_id": converter_id,
+                    "sink_name": "value",
+                    "is_static": False,
+                }
+            )
+
+            # converter -> sink
+            new_links.append(
+                {
+                    "id": str(uuid.uuid4()),
+                    "source_id": converter_id,
+                    "source_name": "value",
+                    "sink_id": link["sink_id"],
+                    "sink_name": link["sink_name"],
+                    "is_static": False,
+                }
+            )
+
+            logger.debug(f"Inserted type converter: {source_type} -> {target_type}")
+        else:
+            new_links.append(link)
+
+    if nodes_to_add:
+        agent["nodes"] = nodes + nodes_to_add
+        agent["links"] = new_links
+
+    return agent
+
+
+def apply_all_fixes(
+    agent: dict[str, Any], blocks_info: list[dict[str, Any]] | None = None
+) -> dict[str, Any]:
+    """Apply all fixes to an agent JSON.
+
+    Args:
+        agent: Agent JSON dict
+        blocks_info: Optional list of block info dicts for advanced fixes
+
+    Returns:
+        Fixed agent JSON
+    """
+    # Basic fixes (no block info needed)
+    agent = fix_agent_ids(agent)
+    agent = fix_double_curly_braces(agent)
+    agent = fix_storevalue_before_condition(agent)
+    agent = fix_addtolist_blocks(agent)
+    agent = fix_addtodictionary_blocks(agent)
+    agent = fix_code_execution_output(agent)
+    agent = fix_data_sampling_sample_size(agent)
+    agent = fix_node_x_coordinates(agent)
+    agent = fix_getcurrentdate_offset(agent)
+
+    # Advanced fixes (require block info)
+    if blocks_info is None:
+        blocks_info = get_blocks_info()
+
+    agent = fix_ai_model_parameter(agent, blocks_info)
+    agent = fix_link_static_properties(agent, blocks_info)
+    agent = fix_data_type_mismatch(agent, blocks_info)
+
+    return agent
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/prompts.py b/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/prompts.py
new file mode 100644
index 0000000000..228bba8c8a
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/prompts.py
@@ -0,0 +1,225 @@
+"""Prompt templates for agent generation."""
+
+DECOMPOSITION_PROMPT = """
+You are an expert AutoGPT Workflow Decomposer. Your task is to analyze a user's high-level goal and break it down into a clear, step-by-step plan using the available blocks.
+
+Each step should represent a distinct, automatable action suitable for execution by an AI automation system.
+
+---
+
+FIRST: Analyze the user's goal and determine:
+1) Design-time configuration (fixed settings that won't change per run)
+2) Runtime inputs (values the agent's end-user will provide each time it runs)
+
+For anything that can vary per run (email addresses, names, dates, search terms, etc.):
+- DO NOT ask for the actual value
+- Instead, define it as an Agent Input with a clear name, type, and description
+
+Only ask clarifying questions about design-time config that affects how you build the workflow:
+- Which external service to use (e.g., "Gmail vs Outlook", "Notion vs Google Docs")
+- Required formats or structures (e.g., "CSV, JSON, or PDF output?")
+- Business rules that must be hard-coded
+
+IMPORTANT CLARIFICATIONS POLICY:
+- Ask no more than five essential questions
+- Do not ask for concrete values that can be provided at runtime as Agent Inputs
+- Do not ask for API keys or credentials; the platform handles those directly
+- If there is enough information to infer reasonable defaults, prefer to propose defaults
+
+---
+
+GUIDELINES:
+1. List each step as a numbered item
+2. Describe the action clearly and specify inputs/outputs
+3. Ensure steps are in logical, sequential order
+4. Mention block names naturally (e.g., "Use GetWeatherByLocationBlock to...")
+5. Help the user reach their goal efficiently
+
+---
+
+RULES:
+1. OUTPUT FORMAT: Only output either clarifying questions OR step-by-step instructions, not both
+2. USE ONLY THE BLOCKS PROVIDED
+3. ALL required_input fields must be provided
+4. Data types of linked properties must match
+5. Write expert-level prompts for AI-related blocks
+
+---
+
+CRITICAL BLOCK RESTRICTIONS:
+1. AddToListBlock: Outputs updated list EVERY addition, not after all additions
+2. SendEmailBlock: Draft the email for user review; set SMTP config based on email type
+3. ConditionBlock: value2 is reference, value1 is contrast
+4. CodeExecutionBlock: DO NOT USE - use AI blocks instead
+5. ReadCsvBlock: Only use the 'rows' output, not 'row'
+
+---
+
+OUTPUT FORMAT:
+
+If more information is needed:
+```json
+{{
+  "type": "clarifying_questions",
+  "questions": [
+    {{
+      "question": "Which email provider should be used? (Gmail, Outlook, custom SMTP)",
+      "keyword": "email_provider",
+      "example": "Gmail"
+    }}
+  ]
+}}
+```
+
+If ready to proceed:
+```json
+{{
+  "type": "instructions",
+  "steps": [
+    {{
+      "step_number": 1,
+      "block_name": "AgentShortTextInputBlock",
+      "description": "Get the URL of the content to analyze.",
+      "inputs": [{{"name": "name", "value": "URL"}}],
+      "outputs": [{{"name": "result", "description": "The URL entered by user"}}]
+    }}
+  ]
+}}
+```
+
+---
+
+AVAILABLE BLOCKS:
+{block_summaries}
+"""
+
+GENERATION_PROMPT = """
+You are an expert AI workflow builder. Generate a valid agent JSON from the given instructions.
+
+---
+
+NODES:
+Each node must include:
+- `id`: Unique UUID v4 (e.g. `a8f5b1e2-c3d4-4e5f-8a9b-0c1d2e3f4a5b`)
+- `block_id`: The block identifier (must match an Allowed Block)
+- `input_default`: Dict of inputs (can be empty if no static inputs needed)
+- `metadata`: Must contain:
+  - `position`: {{"x": number, "y": number}} - adjacent nodes should differ by 800+ in X
+  - `customized_name`: Clear name describing this block's purpose in the workflow
+
+---
+
+LINKS:
+Each link connects a source node's output to a sink node's input:
+- `id`: MUST be UUID v4 (NOT "link-1", "link-2", etc.)
+- `source_id`: ID of the source node
+- `source_name`: Output field name from the source block
+- `sink_id`: ID of the sink node
+- `sink_name`: Input field name on the sink block
+- `is_static`: true only if source block has static_output: true
+
+CRITICAL: All IDs must be valid UUID v4 format!
+
+---
+
+AGENT (GRAPH):
+Wrap nodes and links in:
+- `id`: UUID of the agent
+- `name`: Short, generic name (avoid specific company names, URLs)
+- `description`: Short, generic description
+- `nodes`: List of all nodes
+- `links`: List of all links
+- `version`: 1
+- `is_active`: true
+
+---
+
+TIPS:
+- All required_input fields must be provided via input_default or a valid link
+- Ensure consistent source_id and sink_id references
+- Avoid dangling links
+- Input/output pins must match block schemas
+- Do not invent unknown block_ids
+
+---
+
+ALLOWED BLOCKS:
+{block_summaries}
+
+---
+
+Generate the complete agent JSON. Output ONLY valid JSON, no explanation.
+"""
+
+PATCH_PROMPT = """
+You are an expert at modifying AutoGPT agent workflows. Given the current agent and a modification request, generate a JSON patch to update the agent.
+
+CURRENT AGENT:
+{current_agent}
+
+AVAILABLE BLOCKS:
+{block_summaries}
+
+---
+
+PATCH FORMAT:
+Return a JSON object with the following structure:
+
+```json
+{{
+  "type": "patch",
+  "intent": "Brief description of what the patch does",
+  "patches": [
+    {{
+      "type": "modify",
+      "node_id": "uuid-of-node-to-modify",
+      "changes": {{
+        "input_default": {{"field": "new_value"}},
+        "metadata": {{"customized_name": "New Name"}}
+      }}
+    }},
+    {{
+      "type": "add",
+      "new_nodes": [
+        {{
+          "id": "new-uuid",
+          "block_id": "block-uuid",
+          "input_default": {{}},
+          "metadata": {{"position": {{"x": 0, "y": 0}}, "customized_name": "Name"}}
+        }}
+      ],
+      "new_links": [
+        {{
+          "id": "link-uuid",
+          "source_id": "source-node-id",
+          "source_name": "output_field",
+          "sink_id": "sink-node-id",
+          "sink_name": "input_field"
+        }}
+      ]
+    }},
+    {{
+      "type": "remove",
+      "node_ids": ["uuid-of-node-to-remove"],
+      "link_ids": ["uuid-of-link-to-remove"]
+    }}
+  ]
+}}
+```
+
+If you need more information, return:
+```json
+{{
+  "type": "clarifying_questions",
+  "questions": [
+    {{
+      "question": "What specific change do you want?",
+      "keyword": "change_type",
+      "example": "Add error handling"
+    }}
+  ]
+}}
+```
+
+Generate the minimal patch needed. Output ONLY valid JSON.
+"""
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/utils.py b/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/utils.py
new file mode 100644
index 0000000000..9c3c866c7f
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/utils.py
@@ -0,0 +1,213 @@
+"""Utilities for agent generation."""
+
+import json
+import re
+from typing import Any
+
+from backend.data.block import get_blocks
+
+# UUID validation regex
+UUID_REGEX = re.compile(
+    r"^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$"
+)
+
+# Block IDs for various fixes
+STORE_VALUE_BLOCK_ID = "1ff065e9-88e8-4358-9d82-8dc91f622ba9"
+CONDITION_BLOCK_ID = "715696a0-e1da-45c8-b209-c2fa9c3b0be6"
+ADDTOLIST_BLOCK_ID = "aeb08fc1-2fc1-4141-bc8e-f758f183a822"
+ADDTODICTIONARY_BLOCK_ID = "31d1064e-7446-4693-a7d4-65e5ca1180d1"
+CREATELIST_BLOCK_ID = "a912d5c7-6e00-4542-b2a9-8034136930e4"
+CREATEDICT_BLOCK_ID = "b924ddf4-de4f-4b56-9a85-358930dcbc91"
+CODE_EXECUTION_BLOCK_ID = "0b02b072-abe7-11ef-8372-fb5d162dd712"
+DATA_SAMPLING_BLOCK_ID = "4a448883-71fa-49cf-91cf-70d793bd7d87"
+UNIVERSAL_TYPE_CONVERTER_BLOCK_ID = "95d1b990-ce13-4d88-9737-ba5c2070c97b"
+GET_CURRENT_DATE_BLOCK_ID = "b29c1b50-5d0e-4d9f-8f9d-1b0e6fcbf0b1"
+
+DOUBLE_CURLY_BRACES_BLOCK_IDS = [
+    "44f6c8ad-d75c-4ae1-8209-aad1c0326928",  # FillTextTemplateBlock
+    "6ab085e2-20b3-4055-bc3e-08036e01eca6",
+    "90f8c45e-e983-4644-aa0b-b4ebe2f531bc",
+    "363ae599-353e-4804-937e-b2ee3cef3da4",  # AgentOutputBlock
+    "3b191d9f-356f-482d-8238-ba04b6d18381",
+    "db7d8f02-2f44-4c55-ab7a-eae0941f0c30",
+    "3a7c4b8d-6e2f-4a5d-b9c1-f8d23c5a9b0e",
+    "ed1ae7a0-b770-4089-b520-1f0005fad19a",
+    "a892b8d9-3e4e-4e9c-9c1e-75f8efcf1bfa",
+    "b29c1b50-5d0e-4d9f-8f9d-1b0e6fcbf0b1",
+    "716a67b3-6760-42e7-86dc-18645c6e00fc",
+    "530cf046-2ce0-4854-ae2c-659db17c7a46",
+    "ed55ac19-356e-4243-a6cb-bc599e9b716f",
+    "1f292d4a-41a4-4977-9684-7c8d560b9f91",  # LLM blocks
+    "32a87eab-381e-4dd4-bdb8-4c47151be35a",
+]
+
+
+def is_valid_uuid(value: str) -> bool:
+    """Check if a string is a valid UUID v4."""
+    return isinstance(value, str) and UUID_REGEX.match(value) is not None
+
+
+def _compact_schema(schema: dict) -> dict[str, str]:
+    """Extract compact type info from a JSON schema properties dict.
+
+    Returns a dict of {field_name: type_string} for essential info only.
+    """
+    props = schema.get("properties", {})
+    result = {}
+
+    for name, prop in props.items():
+        # Skip internal/complex fields
+        if name.startswith("_"):
+            continue
+
+        # Get type string
+        type_str = prop.get("type", "any")
+
+        # Handle anyOf/oneOf (optional types)
+        if "anyOf" in prop:
+            types = [t.get("type", "?") for t in prop["anyOf"] if t.get("type")]
+            type_str = "|".join(types) if types else "any"
+        elif "allOf" in prop:
+            type_str = "object"
+
+        # Add array item type if present
+        if type_str == "array" and "items" in prop:
+            items = prop["items"]
+            if isinstance(items, dict):
+                item_type = items.get("type", "any")
+                type_str = f"array[{item_type}]"
+
+        result[name] = type_str
+
+    return result
+
+
+def get_block_summaries(include_schemas: bool = True) -> str:
+    """Generate compact block summaries for prompts.
+
+    Args:
+        include_schemas: Whether to include input/output type info
+
+    Returns:
+        Formatted string of block summaries (compact format)
+    """
+    blocks = get_blocks()
+    summaries = []
+
+    for block_id, block_cls in blocks.items():
+        block = block_cls()
+        name = block.name
+        desc = getattr(block, "description", "") or ""
+
+        # Truncate description
+        if len(desc) > 150:
+            desc = desc[:147] + "..."
+
+        if not include_schemas:
+            summaries.append(f"- {name} (id: {block_id}): {desc}")
+        else:
+            # Compact format with type info only
+            inputs = {}
+            outputs = {}
+            required = []
+
+            if hasattr(block, "input_schema"):
+                try:
+                    schema = block.input_schema.jsonschema()
+                    inputs = _compact_schema(schema)
+                    required = schema.get("required", [])
+                except Exception:
+                    pass
+
+            if hasattr(block, "output_schema"):
+                try:
+                    schema = block.output_schema.jsonschema()
+                    outputs = _compact_schema(schema)
+                except Exception:
+                    pass
+
+            # Build compact line format
+            # Format: NAME (id): desc | in: {field:type, ...} [required] | out: {field:type}
+            in_str = ", ".join(f"{k}:{v}" for k, v in inputs.items())
+            out_str = ", ".join(f"{k}:{v}" for k, v in outputs.items())
+            req_str = f" req=[{','.join(required)}]" if required else ""
+
+            static = " [static]" if getattr(block, "static_output", False) else ""
+
+            line = f"- {name} (id: {block_id}): {desc}"
+            if in_str:
+                line += f"\n  in: {{{in_str}}}{req_str}"
+            if out_str:
+                line += f"\n  out: {{{out_str}}}{static}"
+
+            summaries.append(line)
+
+    return "\n".join(summaries)
+
+
+def get_blocks_info() -> list[dict[str, Any]]:
+    """Get block information with schemas for validation and fixing."""
+    blocks = get_blocks()
+    blocks_info = []
+    for block_id, block_cls in blocks.items():
+        block = block_cls()
+        blocks_info.append(
+            {
+                "id": block_id,
+                "name": block.name,
+                "description": getattr(block, "description", ""),
+                "categories": getattr(block, "categories", []),
+                "staticOutput": getattr(block, "static_output", False),
+                "inputSchema": (
+                    block.input_schema.jsonschema()
+                    if hasattr(block, "input_schema")
+                    else {}
+                ),
+                "outputSchema": (
+                    block.output_schema.jsonschema()
+                    if hasattr(block, "output_schema")
+                    else {}
+                ),
+            }
+        )
+    return blocks_info
+
+
+def parse_json_from_llm(text: str) -> dict[str, Any] | None:
+    """Extract JSON from LLM response (handles markdown code blocks)."""
+    if not text:
+        return None
+
+    # Try fenced code block
+    match = re.search(r"```(?:json)?\s*([\s\S]*?)```", text, re.IGNORECASE)
+    if match:
+        try:
+            return json.loads(match.group(1).strip())
+        except json.JSONDecodeError:
+            pass
+
+    # Try raw text
+    try:
+        return json.loads(text.strip())
+    except json.JSONDecodeError:
+        pass
+
+    # Try finding {...} span
+    start = text.find("{")
+    end = text.rfind("}")
+    if start != -1 and end > start:
+        try:
+            return json.loads(text[start : end + 1])
+        except json.JSONDecodeError:
+            pass
+
+    # Try finding [...] span
+    start = text.find("[")
+    end = text.rfind("]")
+    if start != -1 and end > start:
+        try:
+            return json.loads(text[start : end + 1])
+        except json.JSONDecodeError:
+            pass
+
+    return None
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/validator.py b/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/validator.py
new file mode 100644
index 0000000000..c913e92bfd
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/agent_generator/validator.py
@@ -0,0 +1,279 @@
+"""Agent validator - Validates agent structure and connections."""
+
+import logging
+import re
+from typing import Any
+
+from .utils import get_blocks_info
+
+logger = logging.getLogger(__name__)
+
+
+class AgentValidator:
+    """Validator for AutoGPT agents with detailed error reporting."""
+
+    def __init__(self):
+        self.errors: list[str] = []
+
+    def add_error(self, error: str) -> None:
+        """Add an error message."""
+        self.errors.append(error)
+
+    def validate_block_existence(
+        self, agent: dict[str, Any], blocks_info: list[dict[str, Any]]
+    ) -> bool:
+        """Validate all block IDs exist in the blocks library."""
+        valid = True
+        valid_block_ids = {b.get("id") for b in blocks_info if b.get("id")}
+
+        for node in agent.get("nodes", []):
+            block_id = node.get("block_id")
+            node_id = node.get("id")
+
+            if not block_id:
+                self.add_error(f"Node '{node_id}' is missing 'block_id' field.")
+                valid = False
+                continue
+
+            if block_id not in valid_block_ids:
+                self.add_error(
+                    f"Node '{node_id}' references block_id '{block_id}' which does not exist."
+                )
+                valid = False
+
+        return valid
+
+    def validate_link_node_references(self, agent: dict[str, Any]) -> bool:
+        """Validate all node IDs referenced in links exist."""
+        valid = True
+        valid_node_ids = {n.get("id") for n in agent.get("nodes", []) if n.get("id")}
+
+        for link in agent.get("links", []):
+            link_id = link.get("id", "Unknown")
+            source_id = link.get("source_id")
+            sink_id = link.get("sink_id")
+
+            if not source_id:
+                self.add_error(f"Link '{link_id}' is missing 'source_id'.")
+                valid = False
+            elif source_id not in valid_node_ids:
+                self.add_error(
+                    f"Link '{link_id}' references non-existent source_id '{source_id}'."
+                )
+                valid = False
+
+            if not sink_id:
+                self.add_error(f"Link '{link_id}' is missing 'sink_id'.")
+                valid = False
+            elif sink_id not in valid_node_ids:
+                self.add_error(
+                    f"Link '{link_id}' references non-existent sink_id '{sink_id}'."
+                )
+                valid = False
+
+        return valid
+
+    def validate_required_inputs(
+        self, agent: dict[str, Any], blocks_info: list[dict[str, Any]]
+    ) -> bool:
+        """Validate required inputs are provided."""
+        valid = True
+        block_map = {b.get("id"): b for b in blocks_info}
+
+        for node in agent.get("nodes", []):
+            block_id = node.get("block_id")
+            block = block_map.get(block_id)
+
+            if not block:
+                continue
+
+            required_inputs = block.get("inputSchema", {}).get("required", [])
+            input_defaults = node.get("input_default", {})
+            node_id = node.get("id")
+
+            # Get linked inputs
+            linked_inputs = {
+                link["sink_name"]
+                for link in agent.get("links", [])
+                if link.get("sink_id") == node_id
+            }
+
+            for req_input in required_inputs:
+                if (
+                    req_input not in input_defaults
+                    and req_input not in linked_inputs
+                    and req_input != "credentials"
+                ):
+                    block_name = block.get("name", "Unknown Block")
+                    self.add_error(
+                        f"Node '{node_id}' ({block_name}) is missing required input '{req_input}'."
+                    )
+                    valid = False
+
+        return valid
+
+    def validate_data_type_compatibility(
+        self, agent: dict[str, Any], blocks_info: list[dict[str, Any]]
+    ) -> bool:
+        """Validate linked data types are compatible."""
+        valid = True
+        block_map = {b.get("id"): b for b in blocks_info}
+        node_lookup = {n.get("id"): n for n in agent.get("nodes", [])}
+
+        def get_type(schema: dict, name: str) -> str | None:
+            if "_#_" in name:
+                parent, child = name.split("_#_", 1)
+                parent_schema = schema.get(parent, {})
+                if "properties" in parent_schema:
+                    return parent_schema["properties"].get(child, {}).get("type")
+                return None
+            return schema.get(name, {}).get("type")
+
+        def are_compatible(src: str, sink: str) -> bool:
+            if {src, sink} <= {"integer", "number"}:
+                return True
+            return src == sink
+
+        for link in agent.get("links", []):
+            source_node = node_lookup.get(link.get("source_id"))
+            sink_node = node_lookup.get(link.get("sink_id"))
+
+            if not source_node or not sink_node:
+                continue
+
+            source_block = block_map.get(source_node.get("block_id"))
+            sink_block = block_map.get(sink_node.get("block_id"))
+
+            if not source_block or not sink_block:
+                continue
+
+            source_outputs = source_block.get("outputSchema", {}).get("properties", {})
+            sink_inputs = sink_block.get("inputSchema", {}).get("properties", {})
+
+            source_type = get_type(source_outputs, link.get("source_name", ""))
+            sink_type = get_type(sink_inputs, link.get("sink_name", ""))
+
+            if source_type and sink_type and not are_compatible(source_type, sink_type):
+                self.add_error(
+                    f"Type mismatch: {source_block.get('name')} output '{link['source_name']}' "
+                    f"({source_type}) -> {sink_block.get('name')} input '{link['sink_name']}' ({sink_type})."
+                )
+                valid = False
+
+        return valid
+
+    def validate_nested_sink_links(
+        self, agent: dict[str, Any], blocks_info: list[dict[str, Any]]
+    ) -> bool:
+        """Validate nested sink links (with _#_ notation)."""
+        valid = True
+        block_map = {b.get("id"): b for b in blocks_info}
+        node_lookup = {n.get("id"): n for n in agent.get("nodes", [])}
+
+        for link in agent.get("links", []):
+            sink_name = link.get("sink_name", "")
+
+            if "_#_" in sink_name:
+                parent, child = sink_name.split("_#_", 1)
+
+                sink_node = node_lookup.get(link.get("sink_id"))
+                if not sink_node:
+                    continue
+
+                block = block_map.get(sink_node.get("block_id"))
+                if not block:
+                    continue
+
+                input_props = block.get("inputSchema", {}).get("properties", {})
+                parent_schema = input_props.get(parent)
+
+                if not parent_schema:
+                    self.add_error(
+                        f"Invalid nested link '{sink_name}': parent '{parent}' not found."
+                    )
+                    valid = False
+                    continue
+
+                if not parent_schema.get("additionalProperties"):
+                    if not (
+                        isinstance(parent_schema, dict)
+                        and "properties" in parent_schema
+                        and child in parent_schema.get("properties", {})
+                    ):
+                        self.add_error(
+                            f"Invalid nested link '{sink_name}': child '{child}' not found in '{parent}'."
+                        )
+                        valid = False
+
+        return valid
+
+    def validate_prompt_spaces(self, agent: dict[str, Any]) -> bool:
+        """Validate prompts don't have spaces in template variables."""
+        valid = True
+
+        for node in agent.get("nodes", []):
+            input_default = node.get("input_default", {})
+            prompt = input_default.get("prompt", "")
+
+            if not isinstance(prompt, str):
+                continue
+
+            # Find {{...}} with spaces
+            matches = re.finditer(r"\{\{([^}]+)\}\}", prompt)
+            for match in matches:
+                content = match.group(1)
+                if " " in content:
+                    self.add_error(
+                        f"Node '{node.get('id')}' has spaces in template variable: "
+                        f"'{{{{{content}}}}}' should be '{{{{{content.replace(' ', '_')}}}}}'."
+                    )
+                    valid = False
+
+        return valid
+
+    def validate(
+        self, agent: dict[str, Any], blocks_info: list[dict[str, Any]] | None = None
+    ) -> tuple[bool, str | None]:
+        """Run all validations.
+
+        Returns:
+            Tuple of (is_valid, error_message)
+        """
+        self.errors = []
+
+        if blocks_info is None:
+            blocks_info = get_blocks_info()
+
+        checks = [
+            self.validate_block_existence(agent, blocks_info),
+            self.validate_link_node_references(agent),
+            self.validate_required_inputs(agent, blocks_info),
+            self.validate_data_type_compatibility(agent, blocks_info),
+            self.validate_nested_sink_links(agent, blocks_info),
+            self.validate_prompt_spaces(agent),
+        ]
+
+        all_passed = all(checks)
+
+        if all_passed:
+            logger.info("Agent validation successful")
+            return True, None
+
+        error_message = "Agent validation failed:\n"
+        for i, error in enumerate(self.errors, 1):
+            error_message += f"{i}. {error}\n"
+
+        logger.warning(f"Agent validation failed with {len(self.errors)} errors")
+        return False, error_message
+
+
+def validate_agent(
+    agent: dict[str, Any], blocks_info: list[dict[str, Any]] | None = None
+) -> tuple[bool, str | None]:
+    """Convenience function to validate an agent.
+
+    Returns:
+        Tuple of (is_valid, error_message)
+    """
+    validator = AgentValidator()
+    return validator.validate(agent, blocks_info)
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/agent_output.py b/autogpt_platform/backend/backend/api/features/chat/tools/agent_output.py
new file mode 100644
index 0000000000..00c6d8499b
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/agent_output.py
@@ -0,0 +1,448 @@
+"""Tool for retrieving agent execution outputs from user's library."""
+
+import logging
+import re
+from datetime import datetime, timedelta, timezone
+from typing import Any
+
+from langfuse import observe
+from pydantic import BaseModel, field_validator
+
+from backend.api.features.chat.model import ChatSession
+from backend.api.features.library import db as library_db
+from backend.api.features.library.model import LibraryAgent
+from backend.data import execution as execution_db
+from backend.data.execution import ExecutionStatus, GraphExecution, GraphExecutionMeta
+
+from .base import BaseTool
+from .models import (
+    AgentOutputResponse,
+    ErrorResponse,
+    ExecutionOutputInfo,
+    NoResultsResponse,
+    ToolResponseBase,
+)
+from .utils import fetch_graph_from_store_slug
+
+logger = logging.getLogger(__name__)
+
+
+class AgentOutputInput(BaseModel):
+    """Input parameters for the agent_output tool."""
+
+    agent_name: str = ""
+    library_agent_id: str = ""
+    store_slug: str = ""
+    execution_id: str = ""
+    run_time: str = "latest"
+
+    @field_validator(
+        "agent_name",
+        "library_agent_id",
+        "store_slug",
+        "execution_id",
+        "run_time",
+        mode="before",
+    )
+    @classmethod
+    def strip_strings(cls, v: Any) -> Any:
+        """Strip whitespace from string fields."""
+        return v.strip() if isinstance(v, str) else v
+
+
+def parse_time_expression(
+    time_expr: str | None,
+) -> tuple[datetime | None, datetime | None]:
+    """
+    Parse time expression into datetime range (start, end).
+
+    Supports: "latest", "yesterday", "today", "last week", "last 7 days",
+    "last month", "last 30 days", ISO date "YYYY-MM-DD", ISO datetime.
+    """
+    if not time_expr or time_expr.lower() == "latest":
+        return None, None
+
+    now = datetime.now(timezone.utc)
+    today_start = now.replace(hour=0, minute=0, second=0, microsecond=0)
+    expr = time_expr.lower().strip()
+
+    # Relative time expressions lookup
+    relative_times: dict[str, tuple[datetime, datetime]] = {
+        "yesterday": (today_start - timedelta(days=1), today_start),
+        "today": (today_start, now),
+        "last week": (now - timedelta(days=7), now),
+        "last 7 days": (now - timedelta(days=7), now),
+        "last month": (now - timedelta(days=30), now),
+        "last 30 days": (now - timedelta(days=30), now),
+    }
+    if expr in relative_times:
+        return relative_times[expr]
+
+    # Try ISO date format (YYYY-MM-DD)
+    date_match = re.match(r"^(\d{4})-(\d{2})-(\d{2})$", expr)
+    if date_match:
+        try:
+            year, month, day = map(int, date_match.groups())
+            start = datetime(year, month, day, 0, 0, 0, tzinfo=timezone.utc)
+            return start, start + timedelta(days=1)
+        except ValueError:
+            # Invalid date components (e.g., month=13, day=32)
+            pass
+
+    # Try ISO datetime
+    try:
+        parsed = datetime.fromisoformat(expr.replace("Z", "+00:00"))
+        if parsed.tzinfo is None:
+            parsed = parsed.replace(tzinfo=timezone.utc)
+        return parsed - timedelta(hours=1), parsed + timedelta(hours=1)
+    except ValueError:
+        return None, None
+
+
+class AgentOutputTool(BaseTool):
+    """Tool for retrieving execution outputs from user's library agents."""
+
+    @property
+    def name(self) -> str:
+        return "view_agent_output"
+
+    @property
+    def description(self) -> str:
+        return """Retrieve execution outputs from agents in the user's library.
+
+        Identify the agent using one of:
+        - agent_name: Fuzzy search in user's library
+        - library_agent_id: Exact library agent ID
+        - store_slug: Marketplace format 'username/agent-name'
+
+        Select which run to retrieve using:
+        - execution_id: Specific execution ID
+        - run_time: 'latest' (default), 'yesterday', 'last week', or ISO date 'YYYY-MM-DD'
+        """
+
+    @property
+    def parameters(self) -> dict[str, Any]:
+        return {
+            "type": "object",
+            "properties": {
+                "agent_name": {
+                    "type": "string",
+                    "description": "Agent name to search for in user's library (fuzzy match)",
+                },
+                "library_agent_id": {
+                    "type": "string",
+                    "description": "Exact library agent ID",
+                },
+                "store_slug": {
+                    "type": "string",
+                    "description": "Marketplace identifier: 'username/agent-slug'",
+                },
+                "execution_id": {
+                    "type": "string",
+                    "description": "Specific execution ID to retrieve",
+                },
+                "run_time": {
+                    "type": "string",
+                    "description": (
+                        "Time filter: 'latest', 'yesterday', 'last week', or 'YYYY-MM-DD'"
+                    ),
+                },
+            },
+            "required": [],
+        }
+
+    @property
+    def requires_auth(self) -> bool:
+        return True
+
+    async def _resolve_agent(
+        self,
+        user_id: str,
+        agent_name: str | None,
+        library_agent_id: str | None,
+        store_slug: str | None,
+    ) -> tuple[LibraryAgent | None, str | None]:
+        """
+        Resolve agent from provided identifiers.
+        Returns (library_agent, error_message).
+        """
+        # Priority 1: Exact library agent ID
+        if library_agent_id:
+            try:
+                agent = await library_db.get_library_agent(library_agent_id, user_id)
+                return agent, None
+            except Exception as e:
+                logger.warning(f"Failed to get library agent by ID: {e}")
+                return None, f"Library agent '{library_agent_id}' not found"
+
+        # Priority 2: Store slug (username/agent-name)
+        if store_slug and "/" in store_slug:
+            username, agent_slug = store_slug.split("/", 1)
+            graph, _ = await fetch_graph_from_store_slug(username, agent_slug)
+            if not graph:
+                return None, f"Agent '{store_slug}' not found in marketplace"
+
+            # Find in user's library by graph_id
+            agent = await library_db.get_library_agent_by_graph_id(user_id, graph.id)
+            if not agent:
+                return (
+                    None,
+                    f"Agent '{store_slug}' is not in your library. "
+                    "Add it first to see outputs.",
+                )
+            return agent, None
+
+        # Priority 3: Fuzzy name search in library
+        if agent_name:
+            try:
+                response = await library_db.list_library_agents(
+                    user_id=user_id,
+                    search_term=agent_name,
+                    page_size=5,
+                )
+                if not response.agents:
+                    return (
+                        None,
+                        f"No agents matching '{agent_name}' found in your library",
+                    )
+
+                # Return best match (first result from search)
+                return response.agents[0], None
+            except Exception as e:
+                logger.error(f"Error searching library agents: {e}")
+                return None, f"Error searching for agent: {e}"
+
+        return (
+            None,
+            "Please specify an agent name, library_agent_id, or store_slug",
+        )
+
+    async def _get_execution(
+        self,
+        user_id: str,
+        graph_id: str,
+        execution_id: str | None,
+        time_start: datetime | None,
+        time_end: datetime | None,
+    ) -> tuple[GraphExecution | None, list[GraphExecutionMeta], str | None]:
+        """
+        Fetch execution(s) based on filters.
+        Returns (single_execution, available_executions_meta, error_message).
+        """
+        # If specific execution_id provided, fetch it directly
+        if execution_id:
+            execution = await execution_db.get_graph_execution(
+                user_id=user_id,
+                execution_id=execution_id,
+                include_node_executions=False,
+            )
+            if not execution:
+                return None, [], f"Execution '{execution_id}' not found"
+            return execution, [], None
+
+        # Get completed executions with time filters
+        executions = await execution_db.get_graph_executions(
+            graph_id=graph_id,
+            user_id=user_id,
+            statuses=[ExecutionStatus.COMPLETED],
+            created_time_gte=time_start,
+            created_time_lte=time_end,
+            limit=10,
+        )
+
+        if not executions:
+            return None, [], None  # No error, just no executions
+
+        # If only one execution, fetch full details
+        if len(executions) == 1:
+            full_execution = await execution_db.get_graph_execution(
+                user_id=user_id,
+                execution_id=executions[0].id,
+                include_node_executions=False,
+            )
+            return full_execution, [], None
+
+        # Multiple executions - return latest with full details, plus list of available
+        full_execution = await execution_db.get_graph_execution(
+            user_id=user_id,
+            execution_id=executions[0].id,
+            include_node_executions=False,
+        )
+        return full_execution, executions, None
+
+    def _build_response(
+        self,
+        agent: LibraryAgent,
+        execution: GraphExecution | None,
+        available_executions: list[GraphExecutionMeta],
+        session_id: str | None,
+    ) -> AgentOutputResponse:
+        """Build the response based on execution data."""
+        library_agent_link = f"/library/agents/{agent.id}"
+
+        if not execution:
+            return AgentOutputResponse(
+                message=f"No completed executions found for agent '{agent.name}'",
+                session_id=session_id,
+                agent_name=agent.name,
+                agent_id=agent.graph_id,
+                library_agent_id=agent.id,
+                library_agent_link=library_agent_link,
+                total_executions=0,
+            )
+
+        execution_info = ExecutionOutputInfo(
+            execution_id=execution.id,
+            status=execution.status.value,
+            started_at=execution.started_at,
+            ended_at=execution.ended_at,
+            outputs=dict(execution.outputs),
+            inputs_summary=execution.inputs if execution.inputs else None,
+        )
+
+        available_list = None
+        if len(available_executions) > 1:
+            available_list = [
+                {
+                    "id": e.id,
+                    "status": e.status.value,
+                    "started_at": e.started_at.isoformat() if e.started_at else None,
+                }
+                for e in available_executions[:5]
+            ]
+
+        message = f"Found execution outputs for agent '{agent.name}'"
+        if len(available_executions) > 1:
+            message += (
+                f". Showing latest of {len(available_executions)} matching executions."
+            )
+
+        return AgentOutputResponse(
+            message=message,
+            session_id=session_id,
+            agent_name=agent.name,
+            agent_id=agent.graph_id,
+            library_agent_id=agent.id,
+            library_agent_link=library_agent_link,
+            execution=execution_info,
+            available_executions=available_list,
+            total_executions=len(available_executions) if available_executions else 1,
+        )
+
+    @observe(as_type="tool", name="view_agent_output")
+    async def _execute(
+        self,
+        user_id: str | None,
+        session: ChatSession,
+        **kwargs,
+    ) -> ToolResponseBase:
+        """Execute the agent_output tool."""
+        session_id = session.session_id
+
+        # Parse and validate input
+        try:
+            input_data = AgentOutputInput(**kwargs)
+        except Exception as e:
+            logger.error(f"Invalid input: {e}")
+            return ErrorResponse(
+                message="Invalid input parameters",
+                error=str(e),
+                session_id=session_id,
+            )
+
+        # Ensure user_id is present (should be guaranteed by requires_auth)
+        if not user_id:
+            return ErrorResponse(
+                message="User authentication required",
+                session_id=session_id,
+            )
+
+        # Check if at least one identifier is provided
+        if not any(
+            [
+                input_data.agent_name,
+                input_data.library_agent_id,
+                input_data.store_slug,
+                input_data.execution_id,
+            ]
+        ):
+            return ErrorResponse(
+                message=(
+                    "Please specify at least one of: agent_name, "
+                    "library_agent_id, store_slug, or execution_id"
+                ),
+                session_id=session_id,
+            )
+
+        # If only execution_id provided, we need to find the agent differently
+        if (
+            input_data.execution_id
+            and not input_data.agent_name
+            and not input_data.library_agent_id
+            and not input_data.store_slug
+        ):
+            # Fetch execution directly to get graph_id
+            execution = await execution_db.get_graph_execution(
+                user_id=user_id,
+                execution_id=input_data.execution_id,
+                include_node_executions=False,
+            )
+            if not execution:
+                return ErrorResponse(
+                    message=f"Execution '{input_data.execution_id}' not found",
+                    session_id=session_id,
+                )
+
+            # Find library agent by graph_id
+            agent = await library_db.get_library_agent_by_graph_id(
+                user_id, execution.graph_id
+            )
+            if not agent:
+                return NoResultsResponse(
+                    message=(
+                        f"Execution found but agent not in your library. "
+                        f"Graph ID: {execution.graph_id}"
+                    ),
+                    session_id=session_id,
+                    suggestions=["Add the agent to your library to see more details"],
+                )
+
+            return self._build_response(agent, execution, [], session_id)
+
+        # Resolve agent from identifiers
+        agent, error = await self._resolve_agent(
+            user_id=user_id,
+            agent_name=input_data.agent_name or None,
+            library_agent_id=input_data.library_agent_id or None,
+            store_slug=input_data.store_slug or None,
+        )
+
+        if error or not agent:
+            return NoResultsResponse(
+                message=error or "Agent not found",
+                session_id=session_id,
+                suggestions=[
+                    "Check the agent name or ID",
+                    "Make sure the agent is in your library",
+                ],
+            )
+
+        # Parse time expression
+        time_start, time_end = parse_time_expression(input_data.run_time)
+
+        # Fetch execution(s)
+        execution, available_executions, exec_error = await self._get_execution(
+            user_id=user_id,
+            graph_id=agent.graph_id,
+            execution_id=input_data.execution_id or None,
+            time_start=time_start,
+            time_end=time_end,
+        )
+
+        if exec_error:
+            return ErrorResponse(
+                message=exec_error,
+                session_id=session_id,
+            )
+
+        return self._build_response(agent, execution, available_executions, session_id)
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/agent_search.py b/autogpt_platform/backend/backend/api/features/chat/tools/agent_search.py
new file mode 100644
index 0000000000..5fa74ba04e
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/agent_search.py
@@ -0,0 +1,151 @@
+"""Shared agent search functionality for find_agent and find_library_agent tools."""
+
+import logging
+from typing import Literal
+
+from backend.api.features.library import db as library_db
+from backend.api.features.store import db as store_db
+from backend.util.exceptions import DatabaseError, NotFoundError
+
+from .models import (
+    AgentInfo,
+    AgentsFoundResponse,
+    ErrorResponse,
+    NoResultsResponse,
+    ToolResponseBase,
+)
+
+logger = logging.getLogger(__name__)
+
+SearchSource = Literal["marketplace", "library"]
+
+
+async def search_agents(
+    query: str,
+    source: SearchSource,
+    session_id: str | None,
+    user_id: str | None = None,
+) -> ToolResponseBase:
+    """
+    Search for agents in marketplace or user library.
+
+    Args:
+        query: Search query string
+        source: "marketplace" or "library"
+        session_id: Chat session ID
+        user_id: User ID (required for library search)
+
+    Returns:
+        AgentsFoundResponse, NoResultsResponse, or ErrorResponse
+    """
+    if not query:
+        return ErrorResponse(
+            message="Please provide a search query", session_id=session_id
+        )
+
+    if source == "library" and not user_id:
+        return ErrorResponse(
+            message="User authentication required to search library",
+            session_id=session_id,
+        )
+
+    agents: list[AgentInfo] = []
+    try:
+        if source == "marketplace":
+            logger.info(f"Searching marketplace for: {query}")
+            results = await store_db.get_store_agents(search_query=query, page_size=5)
+            for agent in results.agents:
+                agents.append(
+                    AgentInfo(
+                        id=f"{agent.creator}/{agent.slug}",
+                        name=agent.agent_name,
+                        description=agent.description or "",
+                        source="marketplace",
+                        in_library=False,
+                        creator=agent.creator,
+                        category="general",
+                        rating=agent.rating,
+                        runs=agent.runs,
+                        is_featured=False,
+                    )
+                )
+        else:  # library
+            logger.info(f"Searching user library for: {query}")
+            results = await library_db.list_library_agents(
+                user_id=user_id,  # type: ignore[arg-type]
+                search_term=query,
+                page_size=10,
+            )
+            for agent in results.agents:
+                agents.append(
+                    AgentInfo(
+                        id=agent.id,
+                        name=agent.name,
+                        description=agent.description or "",
+                        source="library",
+                        in_library=True,
+                        creator=agent.creator_name,
+                        status=agent.status.value,
+                        can_access_graph=agent.can_access_graph,
+                        has_external_trigger=agent.has_external_trigger,
+                        new_output=agent.new_output,
+                        graph_id=agent.graph_id,
+                    )
+                )
+        logger.info(f"Found {len(agents)} agents in {source}")
+    except NotFoundError:
+        pass
+    except DatabaseError as e:
+        logger.error(f"Error searching {source}: {e}", exc_info=True)
+        return ErrorResponse(
+            message=f"Failed to search {source}. Please try again.",
+            error=str(e),
+            session_id=session_id,
+        )
+
+    if not agents:
+        suggestions = (
+            [
+                "Try more general terms",
+                "Browse categories in the marketplace",
+                "Check spelling",
+            ]
+            if source == "marketplace"
+            else [
+                "Try different keywords",
+                "Use find_agent to search the marketplace",
+                "Check your library at /library",
+            ]
+        )
+        no_results_msg = (
+            f"No agents found matching '{query}'. Try different keywords or browse the marketplace."
+            if source == "marketplace"
+            else f"No agents matching '{query}' found in your library."
+        )
+        return NoResultsResponse(
+            message=no_results_msg, session_id=session_id, suggestions=suggestions
+        )
+
+    title = f"Found {len(agents)} agent{'s' if len(agents) != 1 else ''} "
+    title += (
+        f"for '{query}'"
+        if source == "marketplace"
+        else f"in your library for '{query}'"
+    )
+
+    message = (
+        "Now you have found some options for the user to choose from. "
+        "You can add a link to a recommended agent at: /marketplace/agent/agent_id "
+        "Please ask the user if they would like to use any of these agents."
+        if source == "marketplace"
+        else "Found agents in the user's library. You can provide a link to view an agent at: "
+        "/library/agents/{agent_id}. Use agent_output to get execution results, or run_agent to execute."
+    )
+
+    return AgentsFoundResponse(
+        message=message,
+        title=title,
+        agents=agents,
+        count=len(agents),
+        session_id=session_id,
+    )
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/base.py b/autogpt_platform/backend/backend/api/features/chat/tools/base.py
index b4c9d8d731..1dc40c18c7 100644
--- a/autogpt_platform/backend/backend/api/features/chat/tools/base.py
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/base.py
@@ -6,7 +6,7 @@ from typing import Any
 from openai.types.chat import ChatCompletionToolParam
 
 from backend.api.features.chat.model import ChatSession
-from backend.api.features.chat.response_model import StreamToolExecutionResult
+from backend.api.features.chat.response_model import StreamToolOutputAvailable
 
 from .models import ErrorResponse, NeedLoginResponse, ToolResponseBase
 
@@ -53,7 +53,7 @@ class BaseTool:
         session: ChatSession,
         tool_call_id: str,
         **kwargs,
-    ) -> StreamToolExecutionResult:
+    ) -> StreamToolOutputAvailable:
         """Execute the tool with authentication check.
 
         Args:
@@ -69,10 +69,10 @@ class BaseTool:
             logger.error(
                 f"Attempted tool call for {self.name} but user not authenticated"
             )
-            return StreamToolExecutionResult(
-                tool_id=tool_call_id,
-                tool_name=self.name,
-                result=NeedLoginResponse(
+            return StreamToolOutputAvailable(
+                toolCallId=tool_call_id,
+                toolName=self.name,
+                output=NeedLoginResponse(
                     message=f"Please sign in to use {self.name}",
                     session_id=session.session_id,
                 ).model_dump_json(),
@@ -81,17 +81,17 @@ class BaseTool:
 
         try:
             result = await self._execute(user_id, session, **kwargs)
-            return StreamToolExecutionResult(
-                tool_id=tool_call_id,
-                tool_name=self.name,
-                result=result.model_dump_json(),
+            return StreamToolOutputAvailable(
+                toolCallId=tool_call_id,
+                toolName=self.name,
+                output=result.model_dump_json(),
             )
         except Exception as e:
             logger.error(f"Error in {self.name}: {e}", exc_info=True)
-            return StreamToolExecutionResult(
-                tool_id=tool_call_id,
-                tool_name=self.name,
-                result=ErrorResponse(
+            return StreamToolOutputAvailable(
+                toolCallId=tool_call_id,
+                toolName=self.name,
+                output=ErrorResponse(
                     message=f"An error occurred while executing {self.name}",
                     error=str(e),
                     session_id=session.session_id,
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/create_agent.py b/autogpt_platform/backend/backend/api/features/chat/tools/create_agent.py
new file mode 100644
index 0000000000..26c980c6c5
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/create_agent.py
@@ -0,0 +1,282 @@
+"""CreateAgentTool - Creates agents from natural language descriptions."""
+
+import logging
+from typing import Any
+
+from langfuse import observe
+
+from backend.api.features.chat.model import ChatSession
+
+from .agent_generator import (
+    apply_all_fixes,
+    decompose_goal,
+    generate_agent,
+    get_blocks_info,
+    save_agent_to_library,
+    validate_agent,
+)
+from .base import BaseTool
+from .models import (
+    AgentPreviewResponse,
+    AgentSavedResponse,
+    ClarificationNeededResponse,
+    ClarifyingQuestion,
+    ErrorResponse,
+    ToolResponseBase,
+)
+
+logger = logging.getLogger(__name__)
+
+# Maximum retries for agent generation with validation feedback
+MAX_GENERATION_RETRIES = 2
+
+
+class CreateAgentTool(BaseTool):
+    """Tool for creating agents from natural language descriptions."""
+
+    @property
+    def name(self) -> str:
+        return "create_agent"
+
+    @property
+    def description(self) -> str:
+        return (
+            "Create a new agent workflow from a natural language description. "
+            "First generates a preview, then saves to library if save=true."
+        )
+
+    @property
+    def requires_auth(self) -> bool:
+        return True
+
+    @property
+    def parameters(self) -> dict[str, Any]:
+        return {
+            "type": "object",
+            "properties": {
+                "description": {
+                    "type": "string",
+                    "description": (
+                        "Natural language description of what the agent should do. "
+                        "Be specific about inputs, outputs, and the workflow steps."
+                    ),
+                },
+                "context": {
+                    "type": "string",
+                    "description": (
+                        "Additional context or answers to previous clarifying questions. "
+                        "Include any preferences or constraints mentioned by the user."
+                    ),
+                },
+                "save": {
+                    "type": "boolean",
+                    "description": (
+                        "Whether to save the agent to the user's library. "
+                        "Default is true. Set to false for preview only."
+                    ),
+                    "default": True,
+                },
+            },
+            "required": ["description"],
+        }
+
+    @observe(as_type="tool", name="create_agent")
+    async def _execute(
+        self,
+        user_id: str | None,
+        session: ChatSession,
+        **kwargs,
+    ) -> ToolResponseBase:
+        """Execute the create_agent tool.
+
+        Flow:
+        1. Decompose the description into steps (may return clarifying questions)
+        2. Generate agent JSON from the steps
+        3. Apply fixes to correct common LLM errors
+        4. Preview or save based on the save parameter
+        """
+        description = kwargs.get("description", "").strip()
+        context = kwargs.get("context", "")
+        save = kwargs.get("save", True)
+        session_id = session.session_id if session else None
+
+        if not description:
+            return ErrorResponse(
+                message="Please provide a description of what the agent should do.",
+                error="Missing description parameter",
+                session_id=session_id,
+            )
+
+        # Step 1: Decompose goal into steps
+        try:
+            decomposition_result = await decompose_goal(description, context)
+        except ValueError as e:
+            # Handle missing API key or configuration errors
+            return ErrorResponse(
+                message=f"Agent generation is not configured: {str(e)}",
+                error="configuration_error",
+                session_id=session_id,
+            )
+
+        if decomposition_result is None:
+            return ErrorResponse(
+                message="Failed to analyze the goal. Please try rephrasing.",
+                error="Decomposition failed",
+                session_id=session_id,
+            )
+
+        # Check if LLM returned clarifying questions
+        if decomposition_result.get("type") == "clarifying_questions":
+            questions = decomposition_result.get("questions", [])
+            return ClarificationNeededResponse(
+                message=(
+                    "I need some more information to create this agent. "
+                    "Please answer the following questions:"
+                ),
+                questions=[
+                    ClarifyingQuestion(
+                        question=q.get("question", ""),
+                        keyword=q.get("keyword", ""),
+                        example=q.get("example"),
+                    )
+                    for q in questions
+                ],
+                session_id=session_id,
+            )
+
+        # Check for unachievable/vague goals
+        if decomposition_result.get("type") == "unachievable_goal":
+            suggested = decomposition_result.get("suggested_goal", "")
+            reason = decomposition_result.get("reason", "")
+            return ErrorResponse(
+                message=(
+                    f"This goal cannot be accomplished with the available blocks. "
+                    f"{reason} "
+                    f"Suggestion: {suggested}"
+                ),
+                error="unachievable_goal",
+                details={"suggested_goal": suggested, "reason": reason},
+                session_id=session_id,
+            )
+
+        if decomposition_result.get("type") == "vague_goal":
+            suggested = decomposition_result.get("suggested_goal", "")
+            return ErrorResponse(
+                message=(
+                    f"The goal is too vague to create a specific workflow. "
+                    f"Suggestion: {suggested}"
+                ),
+                error="vague_goal",
+                details={"suggested_goal": suggested},
+                session_id=session_id,
+            )
+
+        # Step 2: Generate agent JSON with retry on validation failure
+        blocks_info = get_blocks_info()
+        agent_json = None
+        validation_errors = None
+
+        for attempt in range(MAX_GENERATION_RETRIES + 1):
+            # Generate agent (include validation errors from previous attempt)
+            if attempt == 0:
+                agent_json = await generate_agent(decomposition_result)
+            else:
+                # Retry with validation error feedback
+                logger.info(
+                    f"Retry {attempt}/{MAX_GENERATION_RETRIES} with validation feedback"
+                )
+                retry_instructions = {
+                    **decomposition_result,
+                    "previous_errors": validation_errors,
+                    "retry_instructions": (
+                        "The previous generation had validation errors. "
+                        "Please fix these issues in the new generation:\n"
+                        f"{validation_errors}"
+                    ),
+                }
+                agent_json = await generate_agent(retry_instructions)
+
+            if agent_json is None:
+                if attempt == MAX_GENERATION_RETRIES:
+                    return ErrorResponse(
+                        message="Failed to generate the agent. Please try again.",
+                        error="Generation failed",
+                        session_id=session_id,
+                    )
+                continue
+
+            # Step 3: Apply fixes to correct common errors
+            agent_json = apply_all_fixes(agent_json, blocks_info)
+
+            # Step 4: Validate the agent
+            is_valid, validation_errors = validate_agent(agent_json, blocks_info)
+
+            if is_valid:
+                logger.info(f"Agent generated successfully on attempt {attempt + 1}")
+                break
+
+            logger.warning(
+                f"Validation failed on attempt {attempt + 1}: {validation_errors}"
+            )
+
+            if attempt == MAX_GENERATION_RETRIES:
+                # Return error with validation details
+                return ErrorResponse(
+                    message=(
+                        f"Generated agent has validation errors after {MAX_GENERATION_RETRIES + 1} attempts. "
+                        f"Please try rephrasing your request or simplify the workflow."
+                    ),
+                    error="validation_failed",
+                    details={"validation_errors": validation_errors},
+                    session_id=session_id,
+                )
+
+        agent_name = agent_json.get("name", "Generated Agent")
+        agent_description = agent_json.get("description", "")
+        node_count = len(agent_json.get("nodes", []))
+        link_count = len(agent_json.get("links", []))
+
+        # Step 4: Preview or save
+        if not save:
+            return AgentPreviewResponse(
+                message=(
+                    f"I've generated an agent called '{agent_name}' with {node_count} blocks. "
+                    f"Review it and call create_agent with save=true to save it to your library."
+                ),
+                agent_json=agent_json,
+                agent_name=agent_name,
+                description=agent_description,
+                node_count=node_count,
+                link_count=link_count,
+                session_id=session_id,
+            )
+
+        # Save to library
+        if not user_id:
+            return ErrorResponse(
+                message="You must be logged in to save agents.",
+                error="auth_required",
+                session_id=session_id,
+            )
+
+        try:
+            created_graph, library_agent = await save_agent_to_library(
+                agent_json, user_id
+            )
+
+            return AgentSavedResponse(
+                message=f"Agent '{created_graph.name}' has been saved to your library!",
+                agent_id=created_graph.id,
+                agent_name=created_graph.name,
+                library_agent_id=library_agent.id,
+                library_agent_link=f"/library/{library_agent.id}",
+                agent_page_link=f"/build?flowID={created_graph.id}",
+                session_id=session_id,
+            )
+        except Exception as e:
+            return ErrorResponse(
+                message=f"Failed to save the agent: {str(e)}",
+                error="save_failed",
+                details={"exception": str(e)},
+                session_id=session_id,
+            )
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/edit_agent.py b/autogpt_platform/backend/backend/api/features/chat/tools/edit_agent.py
new file mode 100644
index 0000000000..a50a89c5c7
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/edit_agent.py
@@ -0,0 +1,297 @@
+"""EditAgentTool - Edits existing agents using natural language."""
+
+import logging
+from typing import Any
+
+from langfuse import observe
+
+from backend.api.features.chat.model import ChatSession
+
+from .agent_generator import (
+    apply_agent_patch,
+    apply_all_fixes,
+    generate_agent_patch,
+    get_agent_as_json,
+    get_blocks_info,
+    save_agent_to_library,
+    validate_agent,
+)
+from .base import BaseTool
+from .models import (
+    AgentPreviewResponse,
+    AgentSavedResponse,
+    ClarificationNeededResponse,
+    ClarifyingQuestion,
+    ErrorResponse,
+    ToolResponseBase,
+)
+
+logger = logging.getLogger(__name__)
+
+# Maximum retries for patch generation with validation feedback
+MAX_GENERATION_RETRIES = 2
+
+
+class EditAgentTool(BaseTool):
+    """Tool for editing existing agents using natural language."""
+
+    @property
+    def name(self) -> str:
+        return "edit_agent"
+
+    @property
+    def description(self) -> str:
+        return (
+            "Edit an existing agent from the user's library using natural language. "
+            "Generates a patch to update the agent while preserving unchanged parts."
+        )
+
+    @property
+    def requires_auth(self) -> bool:
+        return True
+
+    @property
+    def parameters(self) -> dict[str, Any]:
+        return {
+            "type": "object",
+            "properties": {
+                "agent_id": {
+                    "type": "string",
+                    "description": (
+                        "The ID of the agent to edit. "
+                        "Can be a graph ID or library agent ID."
+                    ),
+                },
+                "changes": {
+                    "type": "string",
+                    "description": (
+                        "Natural language description of what changes to make. "
+                        "Be specific about what to add, remove, or modify."
+                    ),
+                },
+                "context": {
+                    "type": "string",
+                    "description": (
+                        "Additional context or answers to previous clarifying questions."
+                    ),
+                },
+                "save": {
+                    "type": "boolean",
+                    "description": (
+                        "Whether to save the changes. "
+                        "Default is true. Set to false for preview only."
+                    ),
+                    "default": True,
+                },
+            },
+            "required": ["agent_id", "changes"],
+        }
+
+    @observe(as_type="tool", name="edit_agent")
+    async def _execute(
+        self,
+        user_id: str | None,
+        session: ChatSession,
+        **kwargs,
+    ) -> ToolResponseBase:
+        """Execute the edit_agent tool.
+
+        Flow:
+        1. Fetch the current agent
+        2. Generate a patch based on the requested changes
+        3. Apply the patch to create an updated agent
+        4. Preview or save based on the save parameter
+        """
+        agent_id = kwargs.get("agent_id", "").strip()
+        changes = kwargs.get("changes", "").strip()
+        context = kwargs.get("context", "")
+        save = kwargs.get("save", True)
+        session_id = session.session_id if session else None
+
+        if not agent_id:
+            return ErrorResponse(
+                message="Please provide the agent ID to edit.",
+                error="Missing agent_id parameter",
+                session_id=session_id,
+            )
+
+        if not changes:
+            return ErrorResponse(
+                message="Please describe what changes you want to make.",
+                error="Missing changes parameter",
+                session_id=session_id,
+            )
+
+        # Step 1: Fetch current agent
+        current_agent = await get_agent_as_json(agent_id, user_id)
+
+        if current_agent is None:
+            return ErrorResponse(
+                message=f"Could not find agent with ID '{agent_id}' in your library.",
+                error="agent_not_found",
+                session_id=session_id,
+            )
+
+        # Build the update request with context
+        update_request = changes
+        if context:
+            update_request = f"{changes}\n\nAdditional context:\n{context}"
+
+        # Step 2: Generate patch with retry on validation failure
+        blocks_info = get_blocks_info()
+        updated_agent = None
+        validation_errors = None
+        intent = "Applied requested changes"
+
+        for attempt in range(MAX_GENERATION_RETRIES + 1):
+            # Generate patch (include validation errors from previous attempt)
+            try:
+                if attempt == 0:
+                    patch_result = await generate_agent_patch(
+                        update_request, current_agent
+                    )
+                else:
+                    # Retry with validation error feedback
+                    logger.info(
+                        f"Retry {attempt}/{MAX_GENERATION_RETRIES} with validation feedback"
+                    )
+                    retry_request = (
+                        f"{update_request}\n\n"
+                        f"IMPORTANT: The previous edit had validation errors. "
+                        f"Please fix these issues:\n{validation_errors}"
+                    )
+                    patch_result = await generate_agent_patch(
+                        retry_request, current_agent
+                    )
+            except ValueError as e:
+                # Handle missing API key or configuration errors
+                return ErrorResponse(
+                    message=f"Agent generation is not configured: {str(e)}",
+                    error="configuration_error",
+                    session_id=session_id,
+                )
+
+            if patch_result is None:
+                if attempt == MAX_GENERATION_RETRIES:
+                    return ErrorResponse(
+                        message="Failed to generate changes. Please try rephrasing.",
+                        error="Patch generation failed",
+                        session_id=session_id,
+                    )
+                continue
+
+            # Check if LLM returned clarifying questions
+            if patch_result.get("type") == "clarifying_questions":
+                questions = patch_result.get("questions", [])
+                return ClarificationNeededResponse(
+                    message=(
+                        "I need some more information about the changes. "
+                        "Please answer the following questions:"
+                    ),
+                    questions=[
+                        ClarifyingQuestion(
+                            question=q.get("question", ""),
+                            keyword=q.get("keyword", ""),
+                            example=q.get("example"),
+                        )
+                        for q in questions
+                    ],
+                    session_id=session_id,
+                )
+
+            # Step 3: Apply patch and fixes
+            try:
+                updated_agent = apply_agent_patch(current_agent, patch_result)
+                updated_agent = apply_all_fixes(updated_agent, blocks_info)
+            except Exception as e:
+                if attempt == MAX_GENERATION_RETRIES:
+                    return ErrorResponse(
+                        message=f"Failed to apply changes: {str(e)}",
+                        error="patch_apply_failed",
+                        details={"exception": str(e)},
+                        session_id=session_id,
+                    )
+                validation_errors = str(e)
+                continue
+
+            # Step 4: Validate the updated agent
+            is_valid, validation_errors = validate_agent(updated_agent, blocks_info)
+
+            if is_valid:
+                logger.info(f"Agent edited successfully on attempt {attempt + 1}")
+                intent = patch_result.get("intent", "Applied requested changes")
+                break
+
+            logger.warning(
+                f"Validation failed on attempt {attempt + 1}: {validation_errors}"
+            )
+
+            if attempt == MAX_GENERATION_RETRIES:
+                # Return error with validation details
+                return ErrorResponse(
+                    message=(
+                        f"Updated agent has validation errors after "
+                        f"{MAX_GENERATION_RETRIES + 1} attempts. "
+                        f"Please try rephrasing your request or simplify the changes."
+                    ),
+                    error="validation_failed",
+                    details={"validation_errors": validation_errors},
+                    session_id=session_id,
+                )
+
+        # At this point, updated_agent is guaranteed to be set (we return on all failure paths)
+        assert updated_agent is not None
+
+        agent_name = updated_agent.get("name", "Updated Agent")
+        agent_description = updated_agent.get("description", "")
+        node_count = len(updated_agent.get("nodes", []))
+        link_count = len(updated_agent.get("links", []))
+
+        # Step 5: Preview or save
+        if not save:
+            return AgentPreviewResponse(
+                message=(
+                    f"I've updated the agent. Changes: {intent}. "
+                    f"The agent now has {node_count} blocks. "
+                    f"Review it and call edit_agent with save=true to save the changes."
+                ),
+                agent_json=updated_agent,
+                agent_name=agent_name,
+                description=agent_description,
+                node_count=node_count,
+                link_count=link_count,
+                session_id=session_id,
+            )
+
+        # Save to library (creates a new version)
+        if not user_id:
+            return ErrorResponse(
+                message="You must be logged in to save agents.",
+                error="auth_required",
+                session_id=session_id,
+            )
+
+        try:
+            created_graph, library_agent = await save_agent_to_library(
+                updated_agent, user_id, is_update=True
+            )
+
+            return AgentSavedResponse(
+                message=(
+                    f"Updated agent '{created_graph.name}' has been saved to your library! "
+                    f"Changes: {intent}"
+                ),
+                agent_id=created_graph.id,
+                agent_name=created_graph.name,
+                library_agent_id=library_agent.id,
+                library_agent_link=f"/library/{library_agent.id}",
+                agent_page_link=f"/build?flowID={created_graph.id}",
+                session_id=session_id,
+            )
+        except Exception as e:
+            return ErrorResponse(
+                message=f"Failed to save the updated agent: {str(e)}",
+                error="save_failed",
+                details={"exception": str(e)},
+                session_id=session_id,
+            )
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/find_agent.py b/autogpt_platform/backend/backend/api/features/chat/tools/find_agent.py
index 3ad071f412..f231ef4484 100644
--- a/autogpt_platform/backend/backend/api/features/chat/tools/find_agent.py
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/find_agent.py
@@ -1,26 +1,18 @@
-"""Tool for discovering agents from marketplace and user library."""
+"""Tool for discovering agents from marketplace."""
 
-import logging
 from typing import Any
 
+from langfuse import observe
+
 from backend.api.features.chat.model import ChatSession
-from backend.api.features.store import db as store_db
-from backend.util.exceptions import DatabaseError, NotFoundError
 
+from .agent_search import search_agents
 from .base import BaseTool
-from .models import (
-    AgentCarouselResponse,
-    AgentInfo,
-    ErrorResponse,
-    NoResultsResponse,
-    ToolResponseBase,
-)
-
-logger = logging.getLogger(__name__)
+from .models import ToolResponseBase
 
 
 class FindAgentTool(BaseTool):
-    """Tool for discovering agents based on user needs."""
+    """Tool for discovering agents from the marketplace."""
 
     @property
     def name(self) -> str:
@@ -45,85 +37,13 @@ class FindAgentTool(BaseTool):
             "required": ["query"],
         }
 
+    @observe(as_type="tool", name="find_agent")
     async def _execute(
-        self,
-        user_id: str | None,
-        session: ChatSession,
-        **kwargs,
+        self, user_id: str | None, session: ChatSession, **kwargs
     ) -> ToolResponseBase:
-        """Search for agents in the marketplace.
-
-        Args:
-            user_id: User ID (may be anonymous)
-            session_id: Chat session ID
-            query: Search query
-
-        Returns:
-            AgentCarouselResponse: List of agents found in the marketplace
-            NoResultsResponse: No agents found in the marketplace
-            ErrorResponse: Error message
-        """
-        query = kwargs.get("query", "").strip()
-        session_id = session.session_id
-        if not query:
-            return ErrorResponse(
-                message="Please provide a search query",
-                session_id=session_id,
-            )
-        agents = []
-        try:
-            logger.info(f"Searching marketplace for: {query}")
-            store_results = await store_db.get_store_agents(
-                search_query=query,
-                page_size=5,
-            )
-
-            logger.info(f"Find agents tool found {len(store_results.agents)} agents")
-            for agent in store_results.agents:
-                agent_id = f"{agent.creator}/{agent.slug}"
-                logger.info(f"Building agent ID = {agent_id}")
-                agents.append(
-                    AgentInfo(
-                        id=agent_id,
-                        name=agent.agent_name,
-                        description=agent.description or "",
-                        source="marketplace",
-                        in_library=False,
-                        creator=agent.creator,
-                        category="general",
-                        rating=agent.rating,
-                        runs=agent.runs,
-                        is_featured=False,
-                    ),
-                )
-        except NotFoundError:
-            pass
-        except DatabaseError as e:
-            logger.error(f"Error searching agents: {e}", exc_info=True)
-            return ErrorResponse(
-                message="Failed to search for agents. Please try again.",
-                error=str(e),
-                session_id=session_id,
-            )
-        if not agents:
-            return NoResultsResponse(
-                message=f"No agents found matching '{query}'. Try different keywords or browse the marketplace. If you have 3 consecutive find_agent tool calls results and found no agents. Please stop trying and ask the user if there is anything else you can help with.",
-                session_id=session_id,
-                suggestions=[
-                    "Try more general terms",
-                    "Browse categories in the marketplace",
-                    "Check spelling",
-                ],
-            )
-
-        # Return formatted carousel
-        title = (
-            f"Found {len(agents)} agent{'s' if len(agents) != 1 else ''} for '{query}'"
-        )
-        return AgentCarouselResponse(
-            message="Now you have found some options for the user to choose from. You can add a link to a recommended agent at: /marketplace/agent/agent_id Please ask the user if they would like to use any of these agents. If they do, please call the get_agent_details tool for this agent.",
-            title=title,
-            agents=agents,
-            count=len(agents),
-            session_id=session_id,
+        return await search_agents(
+            query=kwargs.get("query", "").strip(),
+            source="marketplace",
+            session_id=session.session_id,
+            user_id=user_id,
         )
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/find_block.py b/autogpt_platform/backend/backend/api/features/chat/tools/find_block.py
new file mode 100644
index 0000000000..fc20fdfc4a
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/find_block.py
@@ -0,0 +1,194 @@
+import logging
+from typing import Any
+
+from langfuse import observe
+from prisma.enums import ContentType
+
+from backend.api.features.chat.model import ChatSession
+from backend.api.features.chat.tools.base import BaseTool, ToolResponseBase
+from backend.api.features.chat.tools.models import (
+    BlockInfoSummary,
+    BlockInputFieldInfo,
+    BlockListResponse,
+    ErrorResponse,
+    NoResultsResponse,
+)
+from backend.api.features.store.hybrid_search import unified_hybrid_search
+from backend.data.block import get_block
+
+logger = logging.getLogger(__name__)
+
+
+class FindBlockTool(BaseTool):
+    """Tool for searching available blocks."""
+
+    @property
+    def name(self) -> str:
+        return "find_block"
+
+    @property
+    def description(self) -> str:
+        return (
+            "Search for available blocks by name or description. "
+            "Blocks are reusable components that perform specific tasks like "
+            "sending emails, making API calls, processing text, etc. "
+            "IMPORTANT: Use this tool FIRST to get the block's 'id' before calling run_block. "
+            "The response includes each block's id, required_inputs, and input_schema."
+        )
+
+    @property
+    def parameters(self) -> dict[str, Any]:
+        return {
+            "type": "object",
+            "properties": {
+                "query": {
+                    "type": "string",
+                    "description": (
+                        "Search query to find blocks by name or description. "
+                        "Use keywords like 'email', 'http', 'text', 'ai', etc."
+                    ),
+                },
+            },
+            "required": ["query"],
+        }
+
+    @property
+    def requires_auth(self) -> bool:
+        return True
+
+    @observe(as_type="tool", name="find_block")
+    async def _execute(
+        self,
+        user_id: str | None,
+        session: ChatSession,
+        **kwargs,
+    ) -> ToolResponseBase:
+        """Search for blocks matching the query.
+
+        Args:
+            user_id: User ID (required)
+            session: Chat session
+            query: Search query
+
+        Returns:
+            BlockListResponse: List of matching blocks
+            NoResultsResponse: No blocks found
+            ErrorResponse: Error message
+        """
+        query = kwargs.get("query", "").strip()
+        session_id = session.session_id
+
+        if not query:
+            return ErrorResponse(
+                message="Please provide a search query",
+                session_id=session_id,
+            )
+
+        try:
+            # Search for blocks using hybrid search
+            results, total = await unified_hybrid_search(
+                query=query,
+                content_types=[ContentType.BLOCK],
+                page=1,
+                page_size=10,
+            )
+
+            if not results:
+                return NoResultsResponse(
+                    message=f"No blocks found for '{query}'",
+                    suggestions=[
+                        "Try broader keywords like 'email', 'http', 'text', 'ai'",
+                        "Check spelling of technical terms",
+                    ],
+                    session_id=session_id,
+                )
+
+            # Enrich results with full block information
+            blocks: list[BlockInfoSummary] = []
+            for result in results:
+                block_id = result["content_id"]
+                block = get_block(block_id)
+
+                if block:
+                    # Get input/output schemas
+                    input_schema = {}
+                    output_schema = {}
+                    try:
+                        input_schema = block.input_schema.jsonschema()
+                    except Exception:
+                        pass
+                    try:
+                        output_schema = block.output_schema.jsonschema()
+                    except Exception:
+                        pass
+
+                    # Get categories from block instance
+                    categories = []
+                    if hasattr(block, "categories") and block.categories:
+                        categories = [cat.value for cat in block.categories]
+
+                    # Extract required inputs for easier use
+                    required_inputs: list[BlockInputFieldInfo] = []
+                    if input_schema:
+                        properties = input_schema.get("properties", {})
+                        required_fields = set(input_schema.get("required", []))
+                        # Get credential field names to exclude from required inputs
+                        credentials_fields = set(
+                            block.input_schema.get_credentials_fields().keys()
+                        )
+
+                        for field_name, field_schema in properties.items():
+                            # Skip credential fields - they're handled separately
+                            if field_name in credentials_fields:
+                                continue
+
+                            required_inputs.append(
+                                BlockInputFieldInfo(
+                                    name=field_name,
+                                    type=field_schema.get("type", "string"),
+                                    description=field_schema.get("description", ""),
+                                    required=field_name in required_fields,
+                                    default=field_schema.get("default"),
+                                )
+                            )
+
+                    blocks.append(
+                        BlockInfoSummary(
+                            id=block_id,
+                            name=block.name,
+                            description=block.description or "",
+                            categories=categories,
+                            input_schema=input_schema,
+                            output_schema=output_schema,
+                            required_inputs=required_inputs,
+                        )
+                    )
+
+            if not blocks:
+                return NoResultsResponse(
+                    message=f"No blocks found for '{query}'",
+                    suggestions=[
+                        "Try broader keywords like 'email', 'http', 'text', 'ai'",
+                    ],
+                    session_id=session_id,
+                )
+
+            return BlockListResponse(
+                message=(
+                    f"Found {len(blocks)} block(s) matching '{query}'. "
+                    "To execute a block, use run_block with the block's 'id' field "
+                    "and provide 'input_data' matching the block's input_schema."
+                ),
+                blocks=blocks,
+                count=len(blocks),
+                query=query,
+                session_id=session_id,
+            )
+
+        except Exception as e:
+            logger.error(f"Error searching blocks: {e}", exc_info=True)
+            return ErrorResponse(
+                message="Failed to search blocks",
+                error=str(e),
+                session_id=session_id,
+            )
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/find_library_agent.py b/autogpt_platform/backend/backend/api/features/chat/tools/find_library_agent.py
new file mode 100644
index 0000000000..d9b5edfa9b
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/find_library_agent.py
@@ -0,0 +1,55 @@
+"""Tool for searching agents in the user's library."""
+
+from typing import Any
+
+from langfuse import observe
+
+from backend.api.features.chat.model import ChatSession
+
+from .agent_search import search_agents
+from .base import BaseTool
+from .models import ToolResponseBase
+
+
+class FindLibraryAgentTool(BaseTool):
+    """Tool for searching agents in the user's library."""
+
+    @property
+    def name(self) -> str:
+        return "find_library_agent"
+
+    @property
+    def description(self) -> str:
+        return (
+            "Search for agents in the user's library. Use this to find agents "
+            "the user has already added to their library, including agents they "
+            "created or added from the marketplace."
+        )
+
+    @property
+    def parameters(self) -> dict[str, Any]:
+        return {
+            "type": "object",
+            "properties": {
+                "query": {
+                    "type": "string",
+                    "description": "Search query to find agents by name or description.",
+                },
+            },
+            "required": ["query"],
+        }
+
+    @property
+    def requires_auth(self) -> bool:
+        return True
+
+    @observe(as_type="tool", name="find_library_agent")
+    async def _execute(
+        self, user_id: str | None, session: ChatSession, **kwargs
+    ) -> ToolResponseBase:
+        return await search_agents(
+            query=kwargs.get("query", "").strip(),
+            source="library",
+            session_id=session.session_id,
+            user_id=user_id,
+        )
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/get_doc_page.py b/autogpt_platform/backend/backend/api/features/chat/tools/get_doc_page.py
new file mode 100644
index 0000000000..b2fdcccfcd
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/get_doc_page.py
@@ -0,0 +1,151 @@
+"""GetDocPageTool - Fetch full content of a documentation page."""
+
+import logging
+from pathlib import Path
+from typing import Any
+
+from langfuse import observe
+
+from backend.api.features.chat.model import ChatSession
+from backend.api.features.chat.tools.base import BaseTool
+from backend.api.features.chat.tools.models import (
+    DocPageResponse,
+    ErrorResponse,
+    ToolResponseBase,
+)
+
+logger = logging.getLogger(__name__)
+
+# Base URL for documentation (can be configured)
+DOCS_BASE_URL = "https://docs.agpt.co"
+
+
+class GetDocPageTool(BaseTool):
+    """Tool for fetching full content of a documentation page."""
+
+    @property
+    def name(self) -> str:
+        return "get_doc_page"
+
+    @property
+    def description(self) -> str:
+        return (
+            "Get the full content of a documentation page by its path. "
+            "Use this after search_docs to read the complete content of a relevant page."
+        )
+
+    @property
+    def parameters(self) -> dict[str, Any]:
+        return {
+            "type": "object",
+            "properties": {
+                "path": {
+                    "type": "string",
+                    "description": (
+                        "The path to the documentation file, as returned by search_docs. "
+                        "Example: 'platform/block-sdk-guide.md'"
+                    ),
+                },
+            },
+            "required": ["path"],
+        }
+
+    @property
+    def requires_auth(self) -> bool:
+        return False  # Documentation is public
+
+    def _get_docs_root(self) -> Path:
+        """Get the documentation root directory."""
+        this_file = Path(__file__)
+        project_root = this_file.parent.parent.parent.parent.parent.parent.parent.parent
+        return project_root / "docs"
+
+    def _extract_title(self, content: str, fallback: str) -> str:
+        """Extract title from markdown content."""
+        lines = content.split("\n")
+        for line in lines:
+            if line.startswith("# "):
+                return line[2:].strip()
+        return fallback
+
+    def _make_doc_url(self, path: str) -> str:
+        """Create a URL for a documentation page."""
+        url_path = path.rsplit(".", 1)[0] if "." in path else path
+        return f"{DOCS_BASE_URL}/{url_path}"
+
+    @observe(as_type="tool", name="get_doc_page")
+    async def _execute(
+        self,
+        user_id: str | None,
+        session: ChatSession,
+        **kwargs,
+    ) -> ToolResponseBase:
+        """Fetch full content of a documentation page.
+
+        Args:
+            user_id: User ID (not required for docs)
+            session: Chat session
+            path: Path to the documentation file
+
+        Returns:
+            DocPageResponse: Full document content
+            ErrorResponse: Error message
+        """
+        path = kwargs.get("path", "").strip()
+        session_id = session.session_id if session else None
+
+        if not path:
+            return ErrorResponse(
+                message="Please provide a documentation path.",
+                error="Missing path parameter",
+                session_id=session_id,
+            )
+
+        # Sanitize path to prevent directory traversal
+        if ".." in path or path.startswith("/"):
+            return ErrorResponse(
+                message="Invalid documentation path.",
+                error="invalid_path",
+                session_id=session_id,
+            )
+
+        docs_root = self._get_docs_root()
+        full_path = docs_root / path
+
+        if not full_path.exists():
+            return ErrorResponse(
+                message=f"Documentation page not found: {path}",
+                error="not_found",
+                session_id=session_id,
+            )
+
+        # Ensure the path is within docs root
+        try:
+            full_path.resolve().relative_to(docs_root.resolve())
+        except ValueError:
+            return ErrorResponse(
+                message="Invalid documentation path.",
+                error="invalid_path",
+                session_id=session_id,
+            )
+
+        try:
+            content = full_path.read_text(encoding="utf-8")
+            title = self._extract_title(content, path)
+
+            return DocPageResponse(
+                message=f"Retrieved documentation page: {title}",
+                title=title,
+                path=path,
+                content=content,
+                doc_url=self._make_doc_url(path),
+                session_id=session_id,
+            )
+
+        except Exception as e:
+            logger.error(f"Failed to read documentation page {path}: {e}")
+            return ErrorResponse(
+                message=f"Failed to read documentation page: {str(e)}",
+                error="read_failed",
+                session_id=session_id,
+            )
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/models.py b/autogpt_platform/backend/backend/api/features/chat/tools/models.py
index a3fbbe025c..1736ddb9a8 100644
--- a/autogpt_platform/backend/backend/api/features/chat/tools/models.py
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/models.py
@@ -1,5 +1,6 @@
 """Pydantic models for tool responses."""
 
+from datetime import datetime
 from enum import Enum
 from typing import Any
 
@@ -11,14 +12,22 @@ from backend.data.model import CredentialsMetaInput
 class ResponseType(str, Enum):
     """Types of tool responses."""
 
-    AGENT_CAROUSEL = "agent_carousel"
+    AGENTS_FOUND = "agents_found"
     AGENT_DETAILS = "agent_details"
     SETUP_REQUIREMENTS = "setup_requirements"
     EXECUTION_STARTED = "execution_started"
     NEED_LOGIN = "need_login"
     ERROR = "error"
     NO_RESULTS = "no_results"
-    SUCCESS = "success"
+    AGENT_OUTPUT = "agent_output"
+    UNDERSTANDING_UPDATED = "understanding_updated"
+    AGENT_PREVIEW = "agent_preview"
+    AGENT_SAVED = "agent_saved"
+    CLARIFICATION_NEEDED = "clarification_needed"
+    BLOCK_LIST = "block_list"
+    BLOCK_OUTPUT = "block_output"
+    DOC_SEARCH_RESULTS = "doc_search_results"
+    DOC_PAGE = "doc_page"
 
 
 # Base response model
@@ -51,14 +60,14 @@ class AgentInfo(BaseModel):
     graph_id: str | None = None
 
 
-class AgentCarouselResponse(ToolResponseBase):
+class AgentsFoundResponse(ToolResponseBase):
     """Response for find_agent tool."""
 
-    type: ResponseType = ResponseType.AGENT_CAROUSEL
+    type: ResponseType = ResponseType.AGENTS_FOUND
     title: str = "Available Agents"
     agents: list[AgentInfo]
     count: int
-    name: str = "agent_carousel"
+    name: str = "agents_found"
 
 
 class NoResultsResponse(ToolResponseBase):
@@ -173,3 +182,155 @@ class ErrorResponse(ToolResponseBase):
     type: ResponseType = ResponseType.ERROR
     error: str | None = None
     details: dict[str, Any] | None = None
+
+
+# Agent output models
+class ExecutionOutputInfo(BaseModel):
+    """Summary of a single execution's outputs."""
+
+    execution_id: str
+    status: str
+    started_at: datetime | None = None
+    ended_at: datetime | None = None
+    outputs: dict[str, list[Any]]
+    inputs_summary: dict[str, Any] | None = None
+
+
+class AgentOutputResponse(ToolResponseBase):
+    """Response for agent_output tool."""
+
+    type: ResponseType = ResponseType.AGENT_OUTPUT
+    agent_name: str
+    agent_id: str
+    library_agent_id: str | None = None
+    library_agent_link: str | None = None
+    execution: ExecutionOutputInfo | None = None
+    available_executions: list[dict[str, Any]] | None = None
+    total_executions: int = 0
+
+
+# Business understanding models
+class UnderstandingUpdatedResponse(ToolResponseBase):
+    """Response for add_understanding tool."""
+
+    type: ResponseType = ResponseType.UNDERSTANDING_UPDATED
+    updated_fields: list[str] = Field(default_factory=list)
+    current_understanding: dict[str, Any] = Field(default_factory=dict)
+
+
+# Agent generation models
+class ClarifyingQuestion(BaseModel):
+    """A question that needs user clarification."""
+
+    question: str
+    keyword: str
+    example: str | None = None
+
+
+class AgentPreviewResponse(ToolResponseBase):
+    """Response for previewing a generated agent before saving."""
+
+    type: ResponseType = ResponseType.AGENT_PREVIEW
+    agent_json: dict[str, Any]
+    agent_name: str
+    description: str
+    node_count: int
+    link_count: int = 0
+
+
+class AgentSavedResponse(ToolResponseBase):
+    """Response when an agent is saved to the library."""
+
+    type: ResponseType = ResponseType.AGENT_SAVED
+    agent_id: str
+    agent_name: str
+    library_agent_id: str
+    library_agent_link: str
+    agent_page_link: str  # Link to the agent builder/editor page
+
+
+class ClarificationNeededResponse(ToolResponseBase):
+    """Response when the LLM needs more information from the user."""
+
+    type: ResponseType = ResponseType.CLARIFICATION_NEEDED
+    questions: list[ClarifyingQuestion] = Field(default_factory=list)
+
+
+# Documentation search models
+class DocSearchResult(BaseModel):
+    """A single documentation search result."""
+
+    title: str
+    path: str
+    section: str
+    snippet: str  # Short excerpt for UI display
+    score: float
+    doc_url: str | None = None
+
+
+class DocSearchResultsResponse(ToolResponseBase):
+    """Response for search_docs tool."""
+
+    type: ResponseType = ResponseType.DOC_SEARCH_RESULTS
+    results: list[DocSearchResult]
+    count: int
+    query: str
+
+
+class DocPageResponse(ToolResponseBase):
+    """Response for get_doc_page tool."""
+
+    type: ResponseType = ResponseType.DOC_PAGE
+    title: str
+    path: str
+    content: str  # Full document content
+    doc_url: str | None = None
+
+
+# Block models
+class BlockInputFieldInfo(BaseModel):
+    """Information about a block input field."""
+
+    name: str
+    type: str
+    description: str = ""
+    required: bool = False
+    default: Any | None = None
+
+
+class BlockInfoSummary(BaseModel):
+    """Summary of a block for search results."""
+
+    id: str
+    name: str
+    description: str
+    categories: list[str]
+    input_schema: dict[str, Any]
+    output_schema: dict[str, Any]
+    required_inputs: list[BlockInputFieldInfo] = Field(
+        default_factory=list,
+        description="List of required input fields for this block",
+    )
+
+
+class BlockListResponse(ToolResponseBase):
+    """Response for find_block tool."""
+
+    type: ResponseType = ResponseType.BLOCK_LIST
+    blocks: list[BlockInfoSummary]
+    count: int
+    query: str
+    usage_hint: str = Field(
+        default="To execute a block, call run_block with block_id set to the block's "
+        "'id' field and input_data containing the required fields from input_schema."
+    )
+
+
+class BlockOutputResponse(ToolResponseBase):
+    """Response for run_block tool."""
+
+    type: ResponseType = ResponseType.BLOCK_OUTPUT
+    block_id: str
+    block_name: str
+    outputs: dict[str, list[Any]]
+    success: bool = True
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/run_agent.py b/autogpt_platform/backend/backend/api/features/chat/tools/run_agent.py
index 931e075021..4d93a3af30 100644
--- a/autogpt_platform/backend/backend/api/features/chat/tools/run_agent.py
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/run_agent.py
@@ -3,10 +3,12 @@
 import logging
 from typing import Any
 
+from langfuse import observe
 from pydantic import BaseModel, Field, field_validator
 
 from backend.api.features.chat.config import ChatConfig
 from backend.api.features.chat.model import ChatSession
+from backend.api.features.library import db as library_db
 from backend.data.graph import GraphModel
 from backend.data.model import CredentialsMetaInput
 from backend.data.user import get_user_by_id
@@ -57,6 +59,7 @@ class RunAgentInput(BaseModel):
     """Input parameters for the run_agent tool."""
 
     username_agent_slug: str = ""
+    library_agent_id: str = ""
     inputs: dict[str, Any] = Field(default_factory=dict)
     use_defaults: bool = False
     schedule_name: str = ""
@@ -64,7 +67,12 @@ class RunAgentInput(BaseModel):
     timezone: str = "UTC"
 
     @field_validator(
-        "username_agent_slug", "schedule_name", "cron", "timezone", mode="before"
+        "username_agent_slug",
+        "library_agent_id",
+        "schedule_name",
+        "cron",
+        "timezone",
+        mode="before",
     )
     @classmethod
     def strip_strings(cls, v: Any) -> Any:
@@ -90,7 +98,7 @@ class RunAgentTool(BaseTool):
 
     @property
     def description(self) -> str:
-        return """Run or schedule an agent from the marketplace.
+        return """Run or schedule an agent from the marketplace or user's library.
 
         The tool automatically handles the setup flow:
         - Returns missing inputs if required fields are not provided
@@ -98,6 +106,10 @@ class RunAgentTool(BaseTool):
         - Executes immediately if all requirements are met
         - Schedules execution if cron expression is provided
 
+        Identify the agent using either:
+        - username_agent_slug: Marketplace format 'username/agent-name'
+        - library_agent_id: ID of an agent in the user's library
+
         For scheduled execution, provide: schedule_name, cron, and optionally timezone."""
 
     @property
@@ -109,6 +121,10 @@ class RunAgentTool(BaseTool):
                     "type": "string",
                     "description": "Agent identifier in format 'username/agent-name'",
                 },
+                "library_agent_id": {
+                    "type": "string",
+                    "description": "Library agent ID from user's library",
+                },
                 "inputs": {
                     "type": "object",
                     "description": "Input values for the agent",
@@ -131,7 +147,7 @@ class RunAgentTool(BaseTool):
                     "description": "IANA timezone for schedule (default: UTC)",
                 },
             },
-            "required": ["username_agent_slug"],
+            "required": [],
         }
 
     @property
@@ -139,6 +155,7 @@ class RunAgentTool(BaseTool):
         """All operations require authentication."""
         return True
 
+    @observe(as_type="tool", name="run_agent")
     async def _execute(
         self,
         user_id: str | None,
@@ -149,10 +166,16 @@ class RunAgentTool(BaseTool):
         params = RunAgentInput(**kwargs)
         session_id = session.session_id
 
-        # Validate agent slug format
-        if not params.username_agent_slug or "/" not in params.username_agent_slug:
+        # Validate at least one identifier is provided
+        has_slug = params.username_agent_slug and "/" in params.username_agent_slug
+        has_library_id = bool(params.library_agent_id)
+
+        if not has_slug and not has_library_id:
             return ErrorResponse(
-                message="Please provide an agent slug in format 'username/agent-name'",
+                message=(
+                    "Please provide either a username_agent_slug "
+                    "(format 'username/agent-name') or a library_agent_id"
+                ),
                 session_id=session_id,
             )
 
@@ -167,13 +190,41 @@ class RunAgentTool(BaseTool):
         is_schedule = bool(params.schedule_name or params.cron)
 
         try:
-            # Step 1: Fetch agent details (always happens first)
-            username, agent_name = params.username_agent_slug.split("/", 1)
-            graph, store_agent = await fetch_graph_from_store_slug(username, agent_name)
+            # Step 1: Fetch agent details
+            graph: GraphModel | None = None
+            library_agent = None
+
+            # Priority: library_agent_id if provided
+            if has_library_id:
+                library_agent = await library_db.get_library_agent(
+                    params.library_agent_id, user_id
+                )
+                if not library_agent:
+                    return ErrorResponse(
+                        message=f"Library agent '{params.library_agent_id}' not found",
+                        session_id=session_id,
+                    )
+                # Get the graph from the library agent
+                from backend.data.graph import get_graph
+
+                graph = await get_graph(
+                    library_agent.graph_id,
+                    library_agent.graph_version,
+                    user_id=user_id,
+                )
+            else:
+                # Fetch from marketplace slug
+                username, agent_name = params.username_agent_slug.split("/", 1)
+                graph, _ = await fetch_graph_from_store_slug(username, agent_name)
 
             if not graph:
+                identifier = (
+                    params.library_agent_id
+                    if has_library_id
+                    else params.username_agent_slug
+                )
                 return ErrorResponse(
-                    message=f"Agent '{params.username_agent_slug}' not found in marketplace",
+                    message=f"Agent '{identifier}' not found",
                     session_id=session_id,
                 )
 
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/run_agent_test.py b/autogpt_platform/backend/backend/api/features/chat/tools/run_agent_test.py
index ebad1a0050..9e10304429 100644
--- a/autogpt_platform/backend/backend/api/features/chat/tools/run_agent_test.py
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/run_agent_test.py
@@ -1,4 +1,5 @@
 import uuid
+from unittest.mock import AsyncMock, patch
 
 import orjson
 import pytest
@@ -17,6 +18,17 @@ setup_test_data = setup_test_data
 setup_firecrawl_test_data = setup_firecrawl_test_data
 
 
+@pytest.fixture(scope="session", autouse=True)
+def mock_embedding_functions():
+    """Mock embedding functions for all tests to avoid database/API dependencies."""
+    with patch(
+        "backend.api.features.store.db.ensure_embedding",
+        new_callable=AsyncMock,
+        return_value=True,
+    ):
+        yield
+
+
 @pytest.mark.asyncio(scope="session")
 async def test_run_agent(setup_test_data):
     """Test that the run_agent tool successfully executes an approved agent"""
@@ -46,11 +58,11 @@ async def test_run_agent(setup_test_data):
 
     # Verify the response
     assert response is not None
-    assert hasattr(response, "result")
+    assert hasattr(response, "output")
     # Parse the result JSON to verify the execution started
 
-    assert isinstance(response.result, str)
-    result_data = orjson.loads(response.result)
+    assert isinstance(response.output, str)
+    result_data = orjson.loads(response.output)
     assert "execution_id" in result_data
     assert "graph_id" in result_data
     assert result_data["graph_id"] == graph.id
@@ -86,11 +98,11 @@ async def test_run_agent_missing_inputs(setup_test_data):
 
     # Verify that we get an error response
     assert response is not None
-    assert hasattr(response, "result")
+    assert hasattr(response, "output")
     # The tool should return an ErrorResponse when setup info indicates not ready
 
-    assert isinstance(response.result, str)
-    result_data = orjson.loads(response.result)
+    assert isinstance(response.output, str)
+    result_data = orjson.loads(response.output)
     assert "message" in result_data
 
 
@@ -118,10 +130,10 @@ async def test_run_agent_invalid_agent_id(setup_test_data):
 
     # Verify that we get an error response
     assert response is not None
-    assert hasattr(response, "result")
+    assert hasattr(response, "output")
 
-    assert isinstance(response.result, str)
-    result_data = orjson.loads(response.result)
+    assert isinstance(response.output, str)
+    result_data = orjson.loads(response.output)
     assert "message" in result_data
     # Should get an error about failed setup or not found
     assert any(
@@ -158,12 +170,12 @@ async def test_run_agent_with_llm_credentials(setup_llm_test_data):
 
     # Verify the response
     assert response is not None
-    assert hasattr(response, "result")
+    assert hasattr(response, "output")
 
     # Parse the result JSON to verify the execution started
 
-    assert isinstance(response.result, str)
-    result_data = orjson.loads(response.result)
+    assert isinstance(response.output, str)
+    result_data = orjson.loads(response.output)
 
     # Should successfully start execution since credentials are available
     assert "execution_id" in result_data
@@ -195,9 +207,9 @@ async def test_run_agent_shows_available_inputs_when_none_provided(setup_test_da
     )
 
     assert response is not None
-    assert hasattr(response, "result")
-    assert isinstance(response.result, str)
-    result_data = orjson.loads(response.result)
+    assert hasattr(response, "output")
+    assert isinstance(response.output, str)
+    result_data = orjson.loads(response.output)
 
     # Should return agent_details type showing available inputs
     assert result_data.get("type") == "agent_details"
@@ -230,9 +242,9 @@ async def test_run_agent_with_use_defaults(setup_test_data):
     )
 
     assert response is not None
-    assert hasattr(response, "result")
-    assert isinstance(response.result, str)
-    result_data = orjson.loads(response.result)
+    assert hasattr(response, "output")
+    assert isinstance(response.output, str)
+    result_data = orjson.loads(response.output)
 
     # Should execute successfully
     assert "execution_id" in result_data
@@ -260,9 +272,9 @@ async def test_run_agent_missing_credentials(setup_firecrawl_test_data):
     )
 
     assert response is not None
-    assert hasattr(response, "result")
-    assert isinstance(response.result, str)
-    result_data = orjson.loads(response.result)
+    assert hasattr(response, "output")
+    assert isinstance(response.output, str)
+    result_data = orjson.loads(response.output)
 
     # Should return setup_requirements type with missing credentials
     assert result_data.get("type") == "setup_requirements"
@@ -292,9 +304,9 @@ async def test_run_agent_invalid_slug_format(setup_test_data):
     )
 
     assert response is not None
-    assert hasattr(response, "result")
-    assert isinstance(response.result, str)
-    result_data = orjson.loads(response.result)
+    assert hasattr(response, "output")
+    assert isinstance(response.output, str)
+    result_data = orjson.loads(response.output)
 
     # Should return error
     assert result_data.get("type") == "error"
@@ -305,9 +317,10 @@ async def test_run_agent_invalid_slug_format(setup_test_data):
 async def test_run_agent_unauthenticated():
     """Test that run_agent returns need_login for unauthenticated users."""
     tool = RunAgentTool()
-    session = make_session(user_id=None)
+    # Session has a user_id (session owner), but we test tool execution without user_id
+    session = make_session(user_id="test-session-owner")
 
-    # Execute without user_id
+    # Execute without user_id to test unauthenticated behavior
     response = await tool.execute(
         user_id=None,
         session_id=str(uuid.uuid4()),
@@ -318,9 +331,9 @@ async def test_run_agent_unauthenticated():
     )
 
     assert response is not None
-    assert hasattr(response, "result")
-    assert isinstance(response.result, str)
-    result_data = orjson.loads(response.result)
+    assert hasattr(response, "output")
+    assert isinstance(response.output, str)
+    result_data = orjson.loads(response.output)
 
     # Base tool returns need_login type for unauthenticated users
     assert result_data.get("type") == "need_login"
@@ -350,9 +363,9 @@ async def test_run_agent_schedule_without_cron(setup_test_data):
     )
 
     assert response is not None
-    assert hasattr(response, "result")
-    assert isinstance(response.result, str)
-    result_data = orjson.loads(response.result)
+    assert hasattr(response, "output")
+    assert isinstance(response.output, str)
+    result_data = orjson.loads(response.output)
 
     # Should return error about missing cron
     assert result_data.get("type") == "error"
@@ -382,9 +395,9 @@ async def test_run_agent_schedule_without_name(setup_test_data):
     )
 
     assert response is not None
-    assert hasattr(response, "result")
-    assert isinstance(response.result, str)
-    result_data = orjson.loads(response.result)
+    assert hasattr(response, "output")
+    assert isinstance(response.output, str)
+    result_data = orjson.loads(response.output)
 
     # Should return error about missing schedule_name
     assert result_data.get("type") == "error"
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/run_block.py b/autogpt_platform/backend/backend/api/features/chat/tools/run_block.py
new file mode 100644
index 0000000000..02f493df71
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/run_block.py
@@ -0,0 +1,300 @@
+"""Tool for executing blocks directly."""
+
+import logging
+from collections import defaultdict
+from typing import Any
+
+from langfuse import observe
+
+from backend.api.features.chat.model import ChatSession
+from backend.data.block import get_block
+from backend.data.execution import ExecutionContext
+from backend.data.model import CredentialsMetaInput
+from backend.integrations.creds_manager import IntegrationCredentialsManager
+from backend.util.exceptions import BlockError
+
+from .base import BaseTool
+from .models import (
+    BlockOutputResponse,
+    ErrorResponse,
+    SetupInfo,
+    SetupRequirementsResponse,
+    ToolResponseBase,
+    UserReadiness,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class RunBlockTool(BaseTool):
+    """Tool for executing a block and returning its outputs."""
+
+    @property
+    def name(self) -> str:
+        return "run_block"
+
+    @property
+    def description(self) -> str:
+        return (
+            "Execute a specific block with the provided input data. "
+            "IMPORTANT: You MUST call find_block first to get the block's 'id' - "
+            "do NOT guess or make up block IDs. "
+            "Use the 'id' from find_block results and provide input_data "
+            "matching the block's required_inputs."
+        )
+
+    @property
+    def parameters(self) -> dict[str, Any]:
+        return {
+            "type": "object",
+            "properties": {
+                "block_id": {
+                    "type": "string",
+                    "description": (
+                        "The block's 'id' field from find_block results. "
+                        "NEVER guess this - always get it from find_block first."
+                    ),
+                },
+                "input_data": {
+                    "type": "object",
+                    "description": (
+                        "Input values for the block. Use the 'required_inputs' field "
+                        "from find_block to see what fields are needed."
+                    ),
+                },
+            },
+            "required": ["block_id", "input_data"],
+        }
+
+    @property
+    def requires_auth(self) -> bool:
+        return True
+
+    async def _check_block_credentials(
+        self,
+        user_id: str,
+        block: Any,
+    ) -> tuple[dict[str, CredentialsMetaInput], list[CredentialsMetaInput]]:
+        """
+        Check if user has required credentials for a block.
+
+        Returns:
+            tuple[matched_credentials, missing_credentials]
+        """
+        matched_credentials: dict[str, CredentialsMetaInput] = {}
+        missing_credentials: list[CredentialsMetaInput] = []
+
+        # Get credential field info from block's input schema
+        credentials_fields_info = block.input_schema.get_credentials_fields_info()
+
+        if not credentials_fields_info:
+            return matched_credentials, missing_credentials
+
+        # Get user's available credentials
+        creds_manager = IntegrationCredentialsManager()
+        available_creds = await creds_manager.store.get_all_creds(user_id)
+
+        for field_name, field_info in credentials_fields_info.items():
+            # field_info.provider is a frozenset of acceptable providers
+            # field_info.supported_types is a frozenset of acceptable types
+            matching_cred = next(
+                (
+                    cred
+                    for cred in available_creds
+                    if cred.provider in field_info.provider
+                    and cred.type in field_info.supported_types
+                ),
+                None,
+            )
+
+            if matching_cred:
+                matched_credentials[field_name] = CredentialsMetaInput(
+                    id=matching_cred.id,
+                    provider=matching_cred.provider,  # type: ignore
+                    type=matching_cred.type,
+                    title=matching_cred.title,
+                )
+            else:
+                # Create a placeholder for the missing credential
+                provider = next(iter(field_info.provider), "unknown")
+                cred_type = next(iter(field_info.supported_types), "api_key")
+                missing_credentials.append(
+                    CredentialsMetaInput(
+                        id=field_name,
+                        provider=provider,  # type: ignore
+                        type=cred_type,  # type: ignore
+                        title=field_name.replace("_", " ").title(),
+                    )
+                )
+
+        return matched_credentials, missing_credentials
+
+    @observe(as_type="tool", name="run_block")
+    async def _execute(
+        self,
+        user_id: str | None,
+        session: ChatSession,
+        **kwargs,
+    ) -> ToolResponseBase:
+        """Execute a block with the given input data.
+
+        Args:
+            user_id: User ID (required)
+            session: Chat session
+            block_id: Block UUID to execute
+            input_data: Input values for the block
+
+        Returns:
+            BlockOutputResponse: Block execution outputs
+            SetupRequirementsResponse: Missing credentials
+            ErrorResponse: Error message
+        """
+        block_id = kwargs.get("block_id", "").strip()
+        input_data = kwargs.get("input_data", {})
+        session_id = session.session_id
+
+        if not block_id:
+            return ErrorResponse(
+                message="Please provide a block_id",
+                session_id=session_id,
+            )
+
+        if not isinstance(input_data, dict):
+            return ErrorResponse(
+                message="input_data must be an object",
+                session_id=session_id,
+            )
+
+        if not user_id:
+            return ErrorResponse(
+                message="Authentication required",
+                session_id=session_id,
+            )
+
+        # Get the block
+        block = get_block(block_id)
+        if not block:
+            return ErrorResponse(
+                message=f"Block '{block_id}' not found",
+                session_id=session_id,
+            )
+
+        logger.info(f"Executing block {block.name} ({block_id}) for user {user_id}")
+
+        # Check credentials
+        creds_manager = IntegrationCredentialsManager()
+        matched_credentials, missing_credentials = await self._check_block_credentials(
+            user_id, block
+        )
+
+        if missing_credentials:
+            # Return setup requirements response with missing credentials
+            missing_creds_dict = {c.id: c.model_dump() for c in missing_credentials}
+
+            return SetupRequirementsResponse(
+                message=(
+                    f"Block '{block.name}' requires credentials that are not configured. "
+                    "Please set up the required credentials before running this block."
+                ),
+                session_id=session_id,
+                setup_info=SetupInfo(
+                    agent_id=block_id,
+                    agent_name=block.name,
+                    user_readiness=UserReadiness(
+                        has_all_credentials=False,
+                        missing_credentials=missing_creds_dict,
+                        ready_to_run=False,
+                    ),
+                    requirements={
+                        "credentials": [c.model_dump() for c in missing_credentials],
+                        "inputs": self._get_inputs_list(block),
+                        "execution_modes": ["immediate"],
+                    },
+                ),
+                graph_id=None,
+                graph_version=None,
+            )
+
+        try:
+            # Fetch actual credentials and prepare kwargs for block execution
+            # Create execution context with defaults (blocks may require it)
+            exec_kwargs: dict[str, Any] = {
+                "user_id": user_id,
+                "execution_context": ExecutionContext(),
+            }
+
+            for field_name, cred_meta in matched_credentials.items():
+                # Inject metadata into input_data (for validation)
+                if field_name not in input_data:
+                    input_data[field_name] = cred_meta.model_dump()
+
+                # Fetch actual credentials and pass as kwargs (for execution)
+                actual_credentials = await creds_manager.get(
+                    user_id, cred_meta.id, lock=False
+                )
+                if actual_credentials:
+                    exec_kwargs[field_name] = actual_credentials
+                else:
+                    return ErrorResponse(
+                        message=f"Failed to retrieve credentials for {field_name}",
+                        session_id=session_id,
+                    )
+
+            # Execute the block and collect outputs
+            outputs: dict[str, list[Any]] = defaultdict(list)
+            async for output_name, output_data in block.execute(
+                input_data,
+                **exec_kwargs,
+            ):
+                outputs[output_name].append(output_data)
+
+            return BlockOutputResponse(
+                message=f"Block '{block.name}' executed successfully",
+                block_id=block_id,
+                block_name=block.name,
+                outputs=dict(outputs),
+                success=True,
+                session_id=session_id,
+            )
+
+        except BlockError as e:
+            logger.warning(f"Block execution failed: {e}")
+            return ErrorResponse(
+                message=f"Block execution failed: {e}",
+                error=str(e),
+                session_id=session_id,
+            )
+        except Exception as e:
+            logger.error(f"Unexpected error executing block: {e}", exc_info=True)
+            return ErrorResponse(
+                message=f"Failed to execute block: {str(e)}",
+                error=str(e),
+                session_id=session_id,
+            )
+
+    def _get_inputs_list(self, block: Any) -> list[dict[str, Any]]:
+        """Extract non-credential inputs from block schema."""
+        inputs_list = []
+        schema = block.input_schema.jsonschema()
+        properties = schema.get("properties", {})
+        required_fields = set(schema.get("required", []))
+
+        # Get credential field names to exclude
+        credentials_fields = set(block.input_schema.get_credentials_fields().keys())
+
+        for field_name, field_schema in properties.items():
+            # Skip credential fields
+            if field_name in credentials_fields:
+                continue
+
+            inputs_list.append(
+                {
+                    "name": field_name,
+                    "title": field_schema.get("title", field_name),
+                    "type": field_schema.get("type", "string"),
+                    "description": field_schema.get("description", ""),
+                    "required": field_name in required_fields,
+                }
+            )
+
+        return inputs_list
diff --git a/autogpt_platform/backend/backend/api/features/chat/tools/search_docs.py b/autogpt_platform/backend/backend/api/features/chat/tools/search_docs.py
new file mode 100644
index 0000000000..4903230b40
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/chat/tools/search_docs.py
@@ -0,0 +1,210 @@
+"""SearchDocsTool - Search documentation using hybrid search."""
+
+import logging
+from typing import Any
+
+from langfuse import observe
+from prisma.enums import ContentType
+
+from backend.api.features.chat.model import ChatSession
+from backend.api.features.chat.tools.base import BaseTool
+from backend.api.features.chat.tools.models import (
+    DocSearchResult,
+    DocSearchResultsResponse,
+    ErrorResponse,
+    NoResultsResponse,
+    ToolResponseBase,
+)
+from backend.api.features.store.hybrid_search import unified_hybrid_search
+
+logger = logging.getLogger(__name__)
+
+# Base URL for documentation (can be configured)
+DOCS_BASE_URL = "https://docs.agpt.co"
+
+# Maximum number of results to return
+MAX_RESULTS = 5
+
+# Snippet length for preview
+SNIPPET_LENGTH = 200
+
+
+class SearchDocsTool(BaseTool):
+    """Tool for searching AutoGPT platform documentation."""
+
+    @property
+    def name(self) -> str:
+        return "search_docs"
+
+    @property
+    def description(self) -> str:
+        return (
+            "Search the AutoGPT platform documentation for information about "
+            "how to use the platform, build agents, configure blocks, and more. "
+            "Returns relevant documentation sections. Use get_doc_page to read full content."
+        )
+
+    @property
+    def parameters(self) -> dict[str, Any]:
+        return {
+            "type": "object",
+            "properties": {
+                "query": {
+                    "type": "string",
+                    "description": (
+                        "Search query to find relevant documentation. "
+                        "Use natural language to describe what you're looking for."
+                    ),
+                },
+            },
+            "required": ["query"],
+        }
+
+    @property
+    def requires_auth(self) -> bool:
+        return False  # Documentation is public
+
+    def _create_snippet(self, content: str, max_length: int = SNIPPET_LENGTH) -> str:
+        """Create a short snippet from content for preview."""
+        # Remove markdown formatting for cleaner snippet
+        clean_content = content.replace("#", "").replace("*", "").replace("`", "")
+        # Remove extra whitespace
+        clean_content = " ".join(clean_content.split())
+
+        if len(clean_content) <= max_length:
+            return clean_content
+
+        # Truncate at word boundary
+        truncated = clean_content[:max_length]
+        last_space = truncated.rfind(" ")
+        if last_space > max_length // 2:
+            truncated = truncated[:last_space]
+
+        return truncated + "..."
+
+    def _make_doc_url(self, path: str) -> str:
+        """Create a URL for a documentation page."""
+        # Remove file extension for URL
+        url_path = path.rsplit(".", 1)[0] if "." in path else path
+        return f"{DOCS_BASE_URL}/{url_path}"
+
+    @observe(as_type="tool", name="search_docs")
+    async def _execute(
+        self,
+        user_id: str | None,
+        session: ChatSession,
+        **kwargs,
+    ) -> ToolResponseBase:
+        """Search documentation and return relevant sections.
+
+        Args:
+            user_id: User ID (not required for docs)
+            session: Chat session
+            query: Search query
+
+        Returns:
+            DocSearchResultsResponse: List of matching documentation sections
+            NoResultsResponse: No results found
+            ErrorResponse: Error message
+        """
+        query = kwargs.get("query", "").strip()
+        session_id = session.session_id if session else None
+
+        if not query:
+            return ErrorResponse(
+                message="Please provide a search query.",
+                error="Missing query parameter",
+                session_id=session_id,
+            )
+
+        try:
+            # Search using hybrid search for DOCUMENTATION content type only
+            results, total = await unified_hybrid_search(
+                query=query,
+                content_types=[ContentType.DOCUMENTATION],
+                page=1,
+                page_size=MAX_RESULTS * 2,  # Fetch extra for deduplication
+                min_score=0.1,  # Lower threshold for docs
+            )
+
+            if not results:
+                return NoResultsResponse(
+                    message=f"No documentation found for '{query}'.",
+                    suggestions=[
+                        "Try different keywords",
+                        "Use more general terms",
+                        "Check for typos in your query",
+                    ],
+                    session_id=session_id,
+                )
+
+            # Deduplicate by document path (keep highest scoring section per doc)
+            seen_docs: dict[str, dict[str, Any]] = {}
+            for result in results:
+                metadata = result.get("metadata", {})
+                doc_path = metadata.get("path", "")
+
+                if not doc_path:
+                    continue
+
+                # Keep the highest scoring result for each document
+                if doc_path not in seen_docs:
+                    seen_docs[doc_path] = result
+                elif result.get("combined_score", 0) > seen_docs[doc_path].get(
+                    "combined_score", 0
+                ):
+                    seen_docs[doc_path] = result
+
+            # Sort by score and take top MAX_RESULTS
+            deduplicated = sorted(
+                seen_docs.values(),
+                key=lambda x: x.get("combined_score", 0),
+                reverse=True,
+            )[:MAX_RESULTS]
+
+            if not deduplicated:
+                return NoResultsResponse(
+                    message=f"No documentation found for '{query}'.",
+                    suggestions=[
+                        "Try different keywords",
+                        "Use more general terms",
+                    ],
+                    session_id=session_id,
+                )
+
+            # Build response
+            doc_results: list[DocSearchResult] = []
+            for result in deduplicated:
+                metadata = result.get("metadata", {})
+                doc_path = metadata.get("path", "")
+                doc_title = metadata.get("doc_title", "")
+                section_title = metadata.get("section_title", "")
+                searchable_text = result.get("searchable_text", "")
+                score = result.get("combined_score", 0)
+
+                doc_results.append(
+                    DocSearchResult(
+                        title=doc_title or section_title or doc_path,
+                        path=doc_path,
+                        section=section_title,
+                        snippet=self._create_snippet(searchable_text),
+                        score=round(score, 3),
+                        doc_url=self._make_doc_url(doc_path),
+                    )
+                )
+
+            return DocSearchResultsResponse(
+                message=f"Found {len(doc_results)} relevant documentation sections.",
+                results=doc_results,
+                count=len(doc_results),
+                query=query,
+                session_id=session_id,
+            )
+
+        except Exception as e:
+            logger.error(f"Documentation search failed: {e}")
+            return ErrorResponse(
+                message=f"Failed to search documentation: {str(e)}",
+                error="search_failed",
+                session_id=session_id,
+            )
diff --git a/autogpt_platform/backend/backend/api/features/integrations/router.py b/autogpt_platform/backend/backend/api/features/integrations/router.py
index f5dd8c092b..00500dc8a8 100644
--- a/autogpt_platform/backend/backend/api/features/integrations/router.py
+++ b/autogpt_platform/backend/backend/api/features/integrations/router.py
@@ -35,11 +35,7 @@ from backend.data.model import (
     OAuth2Credentials,
     UserIntegrations,
 )
-from backend.data.onboarding import (
-    OnboardingStep,
-    complete_onboarding_step,
-    increment_runs,
-)
+from backend.data.onboarding import OnboardingStep, complete_onboarding_step
 from backend.data.user import get_user_integrations
 from backend.executor.utils import add_graph_execution
 from backend.integrations.ayrshare import AyrshareClient, SocialPlatform
@@ -175,6 +171,7 @@ async def callback(
         f"Successfully processed OAuth callback for user {user_id} "
         f"and provider {provider.value}"
     )
+
     return CredentialsMetaResponse(
         id=credentials.id,
         provider=credentials.provider,
@@ -193,6 +190,7 @@ async def list_credentials(
     user_id: Annotated[str, Security(get_user_id)],
 ) -> list[CredentialsMetaResponse]:
     credentials = await creds_manager.store.get_all_creds(user_id)
+
     return [
         CredentialsMetaResponse(
             id=cred.id,
@@ -215,6 +213,7 @@ async def list_credentials_by_provider(
     user_id: Annotated[str, Security(get_user_id)],
 ) -> list[CredentialsMetaResponse]:
     credentials = await creds_manager.store.get_creds_by_provider(user_id, provider)
+
     return [
         CredentialsMetaResponse(
             id=cred.id,
@@ -378,7 +377,6 @@ async def webhook_ingress_generic(
         return
 
     await complete_onboarding_step(user_id, OnboardingStep.TRIGGER_WEBHOOK)
-    await increment_runs(user_id)
 
     # Execute all triggers concurrently for better performance
     tasks = []
@@ -831,6 +829,18 @@ async def list_providers() -> List[str]:
     return all_providers
 
 
+@router.get("/providers/system", response_model=List[str])
+async def list_system_providers() -> List[str]:
+    """
+    Get a list of providers that have platform credits (system credentials) available.
+
+    These providers can be used without the user providing their own API keys.
+    """
+    from backend.integrations.credentials_store import SYSTEM_PROVIDERS
+
+    return list(SYSTEM_PROVIDERS)
+
+
 @router.get("/providers/names", response_model=ProviderNamesResponse)
 async def get_provider_names() -> ProviderNamesResponse:
     """
diff --git a/autogpt_platform/backend/backend/api/features/library/db.py b/autogpt_platform/backend/backend/api/features/library/db.py
index 69ed0d2730..1c17e7b36c 100644
--- a/autogpt_platform/backend/backend/api/features/library/db.py
+++ b/autogpt_platform/backend/backend/api/features/library/db.py
@@ -489,7 +489,7 @@ async def update_agent_version_in_library(
     agent_graph_version: int,
 ) -> library_model.LibraryAgent:
     """
-    Updates the agent version in the library if useGraphIsActiveVersion is True.
+    Updates the agent version in the library for any agent owned by the user.
 
     Args:
         user_id: Owner of the LibraryAgent.
@@ -498,20 +498,31 @@ async def update_agent_version_in_library(
 
     Raises:
         DatabaseError: If there's an error with the update.
+        NotFoundError: If no library agent is found for this user and agent.
     """
     logger.debug(
         f"Updating agent version in library for user #{user_id}, "
         f"agent #{agent_graph_id} v{agent_graph_version}"
     )
-    try:
-        library_agent = await prisma.models.LibraryAgent.prisma().find_first_or_raise(
+    async with transaction() as tx:
+        library_agent = await prisma.models.LibraryAgent.prisma(tx).find_first_or_raise(
             where={
                 "userId": user_id,
                 "agentGraphId": agent_graph_id,
-                "useGraphIsActiveVersion": True,
             },
         )
-        lib = await prisma.models.LibraryAgent.prisma().update(
+
+        # Delete any conflicting LibraryAgent for the target version
+        await prisma.models.LibraryAgent.prisma(tx).delete_many(
+            where={
+                "userId": user_id,
+                "agentGraphId": agent_graph_id,
+                "agentGraphVersion": agent_graph_version,
+                "id": {"not": library_agent.id},
+            }
+        )
+
+        lib = await prisma.models.LibraryAgent.prisma(tx).update(
             where={"id": library_agent.id},
             data={
                 "AgentGraph": {
@@ -525,13 +536,13 @@ async def update_agent_version_in_library(
             },
             include={"AgentGraph": True},
         )
-        if lib is None:
-            raise NotFoundError(f"Library agent {library_agent.id} not found")
 
-        return library_model.LibraryAgent.from_db(lib)
-    except prisma.errors.PrismaError as e:
-        logger.error(f"Database error updating agent version in library: {e}")
-        raise DatabaseError("Failed to update agent version in library") from e
+    if lib is None:
+        raise NotFoundError(
+            f"Failed to update library agent for {agent_graph_id} v{agent_graph_version}"
+        )
+
+    return library_model.LibraryAgent.from_db(lib)
 
 
 async def update_library_agent(
@@ -825,6 +836,7 @@ async def add_store_agent_to_library(
                     }
                 },
                 "isCreatedByUser": False,
+                "useGraphIsActiveVersion": False,
                 "settings": SafeJson(
                     _initialize_graph_settings(graph_model).model_dump()
                 ),
diff --git a/autogpt_platform/backend/backend/api/features/library/model.py b/autogpt_platform/backend/backend/api/features/library/model.py
index c20f82afae..56fad7bfd3 100644
--- a/autogpt_platform/backend/backend/api/features/library/model.py
+++ b/autogpt_platform/backend/backend/api/features/library/model.py
@@ -48,6 +48,7 @@ class LibraryAgent(pydantic.BaseModel):
     id: str
     graph_id: str
     graph_version: int
+    owner_user_id: str  # ID of user who owns/created this agent graph
 
     image_url: str | None
 
@@ -163,6 +164,7 @@ class LibraryAgent(pydantic.BaseModel):
             id=agent.id,
             graph_id=agent.agentGraphId,
             graph_version=agent.agentGraphVersion,
+            owner_user_id=agent.userId,
             image_url=agent.imageUrl,
             creator_name=creator_name,
             creator_image_url=creator_image_url,
diff --git a/autogpt_platform/backend/backend/api/features/library/routes/presets.py b/autogpt_platform/backend/backend/api/features/library/routes/presets.py
index cd4c04e0f2..98f2cb5f15 100644
--- a/autogpt_platform/backend/backend/api/features/library/routes/presets.py
+++ b/autogpt_platform/backend/backend/api/features/library/routes/presets.py
@@ -8,7 +8,6 @@ from backend.data.execution import GraphExecutionMeta
 from backend.data.graph import get_graph
 from backend.data.integrations import get_webhook
 from backend.data.model import CredentialsMetaInput
-from backend.data.onboarding import increment_runs
 from backend.executor.utils import add_graph_execution, make_node_credentials_input_map
 from backend.integrations.creds_manager import IntegrationCredentialsManager
 from backend.integrations.webhooks import get_webhook_manager
@@ -403,8 +402,6 @@ async def execute_preset(
     merged_node_input = preset.inputs | inputs
     merged_credential_inputs = preset.credentials | credential_inputs
 
-    await increment_runs(user_id)
-
     return await add_graph_execution(
         user_id=user_id,
         graph_id=preset.graph_id,
diff --git a/autogpt_platform/backend/backend/api/features/library/routes_test.py b/autogpt_platform/backend/backend/api/features/library/routes_test.py
index ad28b5b6bd..0f05240a7f 100644
--- a/autogpt_platform/backend/backend/api/features/library/routes_test.py
+++ b/autogpt_platform/backend/backend/api/features/library/routes_test.py
@@ -42,6 +42,7 @@ async def test_get_library_agents_success(
                 id="test-agent-1",
                 graph_id="test-agent-1",
                 graph_version=1,
+                owner_user_id=test_user_id,
                 name="Test Agent 1",
                 description="Test Description 1",
                 image_url=None,
@@ -64,6 +65,7 @@ async def test_get_library_agents_success(
                 id="test-agent-2",
                 graph_id="test-agent-2",
                 graph_version=1,
+                owner_user_id=test_user_id,
                 name="Test Agent 2",
                 description="Test Description 2",
                 image_url=None,
@@ -138,6 +140,7 @@ async def test_get_favorite_library_agents_success(
                 id="test-agent-1",
                 graph_id="test-agent-1",
                 graph_version=1,
+                owner_user_id=test_user_id,
                 name="Favorite Agent 1",
                 description="Test Favorite Description 1",
                 image_url=None,
@@ -205,6 +208,7 @@ def test_add_agent_to_library_success(
         id="test-library-agent-id",
         graph_id="test-agent-1",
         graph_version=1,
+        owner_user_id=test_user_id,
         name="Test Agent 1",
         description="Test Description 1",
         image_url=None,
diff --git a/autogpt_platform/backend/backend/api/features/store/content_handlers.py b/autogpt_platform/backend/backend/api/features/store/content_handlers.py
new file mode 100644
index 0000000000..1560db421c
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/store/content_handlers.py
@@ -0,0 +1,610 @@
+"""
+Content Type Handlers for Unified Embeddings
+
+Pluggable system for different content sources (store agents, blocks, docs).
+Each handler knows how to fetch and process its content type for embedding.
+"""
+
+import logging
+from abc import ABC, abstractmethod
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any
+
+from prisma.enums import ContentType
+
+from backend.data.db import query_raw_with_schema
+
+logger = logging.getLogger(__name__)
+
+
+@dataclass
+class ContentItem:
+    """Represents a piece of content to be embedded."""
+
+    content_id: str  # Unique identifier (DB ID or file path)
+    content_type: ContentType
+    searchable_text: str  # Combined text for embedding
+    metadata: dict[str, Any]  # Content-specific metadata
+    user_id: str | None = None  # For user-scoped content
+
+
+class ContentHandler(ABC):
+    """Base handler for fetching and processing content for embeddings."""
+
+    @property
+    @abstractmethod
+    def content_type(self) -> ContentType:
+        """The ContentType this handler manages."""
+        pass
+
+    @abstractmethod
+    async def get_missing_items(self, batch_size: int) -> list[ContentItem]:
+        """
+        Fetch items that don't have embeddings yet.
+
+        Args:
+            batch_size: Maximum number of items to return
+
+        Returns:
+            List of ContentItem objects ready for embedding
+        """
+        pass
+
+    @abstractmethod
+    async def get_stats(self) -> dict[str, int]:
+        """
+        Get statistics about embedding coverage.
+
+        Returns:
+            Dict with keys: total, with_embeddings, without_embeddings
+        """
+        pass
+
+
+class StoreAgentHandler(ContentHandler):
+    """Handler for marketplace store agent listings."""
+
+    @property
+    def content_type(self) -> ContentType:
+        return ContentType.STORE_AGENT
+
+    async def get_missing_items(self, batch_size: int) -> list[ContentItem]:
+        """Fetch approved store listings without embeddings."""
+        from backend.api.features.store.embeddings import build_searchable_text
+
+        missing = await query_raw_with_schema(
+            """
+            SELECT
+                slv.id,
+                slv.name,
+                slv.description,
+                slv."subHeading",
+                slv.categories
+            FROM {schema_prefix}"StoreListingVersion" slv
+            LEFT JOIN {schema_prefix}"UnifiedContentEmbedding" uce
+                ON slv.id = uce."contentId" AND uce."contentType" = 'STORE_AGENT'::{schema_prefix}"ContentType"
+            WHERE slv."submissionStatus" = 'APPROVED'
+            AND slv."isDeleted" = false
+            AND uce."contentId" IS NULL
+            LIMIT $1
+            """,
+            batch_size,
+        )
+
+        return [
+            ContentItem(
+                content_id=row["id"],
+                content_type=ContentType.STORE_AGENT,
+                searchable_text=build_searchable_text(
+                    name=row["name"],
+                    description=row["description"],
+                    sub_heading=row["subHeading"],
+                    categories=row["categories"] or [],
+                ),
+                metadata={
+                    "name": row["name"],
+                    "categories": row["categories"] or [],
+                },
+                user_id=None,  # Store agents are public
+            )
+            for row in missing
+        ]
+
+    async def get_stats(self) -> dict[str, int]:
+        """Get statistics about store agent embedding coverage."""
+        # Count approved versions
+        approved_result = await query_raw_with_schema(
+            """
+            SELECT COUNT(*) as count
+            FROM {schema_prefix}"StoreListingVersion"
+            WHERE "submissionStatus" = 'APPROVED'
+            AND "isDeleted" = false
+            """
+        )
+        total_approved = approved_result[0]["count"] if approved_result else 0
+
+        # Count versions with embeddings
+        embedded_result = await query_raw_with_schema(
+            """
+            SELECT COUNT(*) as count
+            FROM {schema_prefix}"StoreListingVersion" slv
+            JOIN {schema_prefix}"UnifiedContentEmbedding" uce ON slv.id = uce."contentId" AND uce."contentType" = 'STORE_AGENT'::{schema_prefix}"ContentType"
+            WHERE slv."submissionStatus" = 'APPROVED'
+            AND slv."isDeleted" = false
+            """
+        )
+        with_embeddings = embedded_result[0]["count"] if embedded_result else 0
+
+        return {
+            "total": total_approved,
+            "with_embeddings": with_embeddings,
+            "without_embeddings": total_approved - with_embeddings,
+        }
+
+
+class BlockHandler(ContentHandler):
+    """Handler for block definitions (Python classes)."""
+
+    @property
+    def content_type(self) -> ContentType:
+        return ContentType.BLOCK
+
+    async def get_missing_items(self, batch_size: int) -> list[ContentItem]:
+        """Fetch blocks without embeddings."""
+        from backend.data.block import get_blocks
+
+        # Get all available blocks
+        all_blocks = get_blocks()
+
+        # Check which ones have embeddings
+        if not all_blocks:
+            return []
+
+        block_ids = list(all_blocks.keys())
+
+        # Query for existing embeddings
+        placeholders = ",".join([f"${i+1}" for i in range(len(block_ids))])
+        existing_result = await query_raw_with_schema(
+            f"""
+            SELECT "contentId"
+            FROM {{schema_prefix}}"UnifiedContentEmbedding"
+            WHERE "contentType" = 'BLOCK'::{{schema_prefix}}"ContentType"
+            AND "contentId" = ANY(ARRAY[{placeholders}])
+            """,
+            *block_ids,
+        )
+
+        existing_ids = {row["contentId"] for row in existing_result}
+        missing_blocks = [
+            (block_id, block_cls)
+            for block_id, block_cls in all_blocks.items()
+            if block_id not in existing_ids
+        ]
+
+        # Convert to ContentItem
+        items = []
+        for block_id, block_cls in missing_blocks[:batch_size]:
+            try:
+                block_instance = block_cls()
+
+                # Build searchable text from block metadata
+                parts = []
+                if hasattr(block_instance, "name") and block_instance.name:
+                    parts.append(block_instance.name)
+                if (
+                    hasattr(block_instance, "description")
+                    and block_instance.description
+                ):
+                    parts.append(block_instance.description)
+                if hasattr(block_instance, "categories") and block_instance.categories:
+                    # Convert BlockCategory enum to strings
+                    parts.append(
+                        " ".join(str(cat.value) for cat in block_instance.categories)
+                    )
+
+                # Add input/output schema info
+                if hasattr(block_instance, "input_schema"):
+                    schema = block_instance.input_schema
+                    if hasattr(schema, "model_json_schema"):
+                        schema_dict = schema.model_json_schema()
+                        if "properties" in schema_dict:
+                            for prop_name, prop_info in schema_dict[
+                                "properties"
+                            ].items():
+                                if "description" in prop_info:
+                                    parts.append(
+                                        f"{prop_name}: {prop_info['description']}"
+                                    )
+
+                searchable_text = " ".join(parts)
+
+                # Convert categories set of enums to list of strings for JSON serialization
+                categories = getattr(block_instance, "categories", set())
+                categories_list = (
+                    [cat.value for cat in categories] if categories else []
+                )
+
+                items.append(
+                    ContentItem(
+                        content_id=block_id,
+                        content_type=ContentType.BLOCK,
+                        searchable_text=searchable_text,
+                        metadata={
+                            "name": getattr(block_instance, "name", ""),
+                            "categories": categories_list,
+                        },
+                        user_id=None,  # Blocks are public
+                    )
+                )
+            except Exception as e:
+                logger.warning(f"Failed to process block {block_id}: {e}")
+                continue
+
+        return items
+
+    async def get_stats(self) -> dict[str, int]:
+        """Get statistics about block embedding coverage."""
+        from backend.data.block import get_blocks
+
+        all_blocks = get_blocks()
+        total_blocks = len(all_blocks)
+
+        if total_blocks == 0:
+            return {"total": 0, "with_embeddings": 0, "without_embeddings": 0}
+
+        block_ids = list(all_blocks.keys())
+        placeholders = ",".join([f"${i+1}" for i in range(len(block_ids))])
+
+        embedded_result = await query_raw_with_schema(
+            f"""
+            SELECT COUNT(*) as count
+            FROM {{schema_prefix}}"UnifiedContentEmbedding"
+            WHERE "contentType" = 'BLOCK'::{{schema_prefix}}"ContentType"
+            AND "contentId" = ANY(ARRAY[{placeholders}])
+            """,
+            *block_ids,
+        )
+
+        with_embeddings = embedded_result[0]["count"] if embedded_result else 0
+
+        return {
+            "total": total_blocks,
+            "with_embeddings": with_embeddings,
+            "without_embeddings": total_blocks - with_embeddings,
+        }
+
+
+@dataclass
+class MarkdownSection:
+    """Represents a section of a markdown document."""
+
+    title: str  # Section heading text
+    content: str  # Section content (including the heading line)
+    level: int  # Heading level (1 for #, 2 for ##, etc.)
+    index: int  # Section index within the document
+
+
+class DocumentationHandler(ContentHandler):
+    """Handler for documentation files (.md/.mdx).
+
+    Chunks documents by markdown headings to create multiple embeddings per file.
+    Each section (## heading) becomes a separate embedding for better retrieval.
+    """
+
+    @property
+    def content_type(self) -> ContentType:
+        return ContentType.DOCUMENTATION
+
+    def _get_docs_root(self) -> Path:
+        """Get the documentation root directory."""
+        # content_handlers.py is at: backend/backend/api/features/store/content_handlers.py
+        # Need to go up to project root then into docs/
+        # In container: /app/autogpt_platform/backend/backend/api/features/store -> /app/docs
+        # In development: /repo/autogpt_platform/backend/backend/api/features/store -> /repo/docs
+        this_file = Path(
+            __file__
+        )  # .../backend/backend/api/features/store/content_handlers.py
+        project_root = (
+            this_file.parent.parent.parent.parent.parent.parent.parent
+        )  # -> /app or /repo
+        docs_root = project_root / "docs"
+        return docs_root
+
+    def _extract_doc_title(self, file_path: Path) -> str:
+        """Extract the document title from a markdown file."""
+        try:
+            content = file_path.read_text(encoding="utf-8")
+            lines = content.split("\n")
+
+            # Try to extract title from first # heading
+            for line in lines:
+                if line.startswith("# "):
+                    return line[2:].strip()
+
+            # If no title found, use filename
+            return file_path.stem.replace("-", " ").replace("_", " ").title()
+        except Exception as e:
+            logger.warning(f"Failed to read title from {file_path}: {e}")
+            return file_path.stem.replace("-", " ").replace("_", " ").title()
+
+    def _chunk_markdown_by_headings(
+        self, file_path: Path, min_heading_level: int = 2
+    ) -> list[MarkdownSection]:
+        """
+        Split a markdown file into sections based on headings.
+
+        Args:
+            file_path: Path to the markdown file
+            min_heading_level: Minimum heading level to split on (default: 2 for ##)
+
+        Returns:
+            List of MarkdownSection objects, one per section.
+            If no headings found, returns a single section with all content.
+        """
+        try:
+            content = file_path.read_text(encoding="utf-8")
+        except Exception as e:
+            logger.warning(f"Failed to read {file_path}: {e}")
+            return []
+
+        lines = content.split("\n")
+        sections: list[MarkdownSection] = []
+        current_section_lines: list[str] = []
+        current_title = ""
+        current_level = 0
+        section_index = 0
+        doc_title = ""
+
+        for line in lines:
+            # Check if line is a heading
+            if line.startswith("#"):
+                # Count heading level
+                level = 0
+                for char in line:
+                    if char == "#":
+                        level += 1
+                    else:
+                        break
+
+                heading_text = line[level:].strip()
+
+                # Track document title (level 1 heading)
+                if level == 1 and not doc_title:
+                    doc_title = heading_text
+                    # Don't create a section for just the title - add it to first section
+                    current_section_lines.append(line)
+                    continue
+
+                # Check if this heading should start a new section
+                if level >= min_heading_level:
+                    # Save previous section if it has content
+                    if current_section_lines:
+                        section_content = "\n".join(current_section_lines).strip()
+                        if section_content:
+                            # Use doc title for first section if no specific title
+                            title = current_title if current_title else doc_title
+                            if not title:
+                                title = file_path.stem.replace("-", " ").replace(
+                                    "_", " "
+                                )
+                            sections.append(
+                                MarkdownSection(
+                                    title=title,
+                                    content=section_content,
+                                    level=current_level if current_level else 1,
+                                    index=section_index,
+                                )
+                            )
+                            section_index += 1
+
+                    # Start new section
+                    current_section_lines = [line]
+                    current_title = heading_text
+                    current_level = level
+                else:
+                    # Lower level heading (e.g., # when splitting on ##)
+                    current_section_lines.append(line)
+            else:
+                current_section_lines.append(line)
+
+        # Don't forget the last section
+        if current_section_lines:
+            section_content = "\n".join(current_section_lines).strip()
+            if section_content:
+                title = current_title if current_title else doc_title
+                if not title:
+                    title = file_path.stem.replace("-", " ").replace("_", " ")
+                sections.append(
+                    MarkdownSection(
+                        title=title,
+                        content=section_content,
+                        level=current_level if current_level else 1,
+                        index=section_index,
+                    )
+                )
+
+        # If no sections were created (no headings found), create one section with all content
+        if not sections and content.strip():
+            title = (
+                doc_title
+                if doc_title
+                else file_path.stem.replace("-", " ").replace("_", " ")
+            )
+            sections.append(
+                MarkdownSection(
+                    title=title,
+                    content=content.strip(),
+                    level=1,
+                    index=0,
+                )
+            )
+
+        return sections
+
+    def _make_section_content_id(self, doc_path: str, section_index: int) -> str:
+        """Create a unique content ID for a document section.
+
+        Format: doc_path::section_index
+        Example: 'platform/getting-started.md::0'
+        """
+        return f"{doc_path}::{section_index}"
+
+    def _parse_section_content_id(self, content_id: str) -> tuple[str, int]:
+        """Parse a section content ID back into doc_path and section_index.
+
+        Returns: (doc_path, section_index)
+        """
+        if "::" in content_id:
+            parts = content_id.rsplit("::", 1)
+            return parts[0], int(parts[1])
+        # Legacy format (whole document)
+        return content_id, 0
+
+    async def get_missing_items(self, batch_size: int) -> list[ContentItem]:
+        """Fetch documentation sections without embeddings.
+
+        Chunks each document by markdown headings and creates embeddings for each section.
+        Content IDs use the format: 'path/to/doc.md::section_index'
+        """
+        docs_root = self._get_docs_root()
+
+        if not docs_root.exists():
+            logger.warning(f"Documentation root not found: {docs_root}")
+            return []
+
+        # Find all .md and .mdx files
+        all_docs = list(docs_root.rglob("*.md")) + list(docs_root.rglob("*.mdx"))
+
+        if not all_docs:
+            return []
+
+        # Build list of all sections from all documents
+        all_sections: list[tuple[str, Path, MarkdownSection]] = []
+        for doc_file in all_docs:
+            doc_path = str(doc_file.relative_to(docs_root))
+            sections = self._chunk_markdown_by_headings(doc_file)
+            for section in sections:
+                all_sections.append((doc_path, doc_file, section))
+
+        if not all_sections:
+            return []
+
+        # Generate content IDs for all sections
+        section_content_ids = [
+            self._make_section_content_id(doc_path, section.index)
+            for doc_path, _, section in all_sections
+        ]
+
+        # Check which ones have embeddings
+        placeholders = ",".join([f"${i+1}" for i in range(len(section_content_ids))])
+        existing_result = await query_raw_with_schema(
+            f"""
+            SELECT "contentId"
+            FROM {{schema_prefix}}"UnifiedContentEmbedding"
+            WHERE "contentType" = 'DOCUMENTATION'::{{schema_prefix}}"ContentType"
+            AND "contentId" = ANY(ARRAY[{placeholders}])
+            """,
+            *section_content_ids,
+        )
+
+        existing_ids = {row["contentId"] for row in existing_result}
+
+        # Filter to missing sections
+        missing_sections = [
+            (doc_path, doc_file, section, content_id)
+            for (doc_path, doc_file, section), content_id in zip(
+                all_sections, section_content_ids
+            )
+            if content_id not in existing_ids
+        ]
+
+        # Convert to ContentItem (up to batch_size)
+        items = []
+        for doc_path, doc_file, section, content_id in missing_sections[:batch_size]:
+            try:
+                # Get document title for context
+                doc_title = self._extract_doc_title(doc_file)
+
+                # Build searchable text with context
+                # Include doc title and section title for better search relevance
+                searchable_text = f"{doc_title} - {section.title}\n\n{section.content}"
+
+                items.append(
+                    ContentItem(
+                        content_id=content_id,
+                        content_type=ContentType.DOCUMENTATION,
+                        searchable_text=searchable_text,
+                        metadata={
+                            "doc_title": doc_title,
+                            "section_title": section.title,
+                            "section_index": section.index,
+                            "heading_level": section.level,
+                            "path": doc_path,
+                        },
+                        user_id=None,  # Documentation is public
+                    )
+                )
+            except Exception as e:
+                logger.warning(f"Failed to process section {content_id}: {e}")
+                continue
+
+        return items
+
+    def _get_all_section_content_ids(self, docs_root: Path) -> set[str]:
+        """Get all current section content IDs from the docs directory.
+
+        Used for stats and cleanup to know what sections should exist.
+        """
+        all_docs = list(docs_root.rglob("*.md")) + list(docs_root.rglob("*.mdx"))
+        content_ids = set()
+
+        for doc_file in all_docs:
+            doc_path = str(doc_file.relative_to(docs_root))
+            sections = self._chunk_markdown_by_headings(doc_file)
+            for section in sections:
+                content_ids.add(self._make_section_content_id(doc_path, section.index))
+
+        return content_ids
+
+    async def get_stats(self) -> dict[str, int]:
+        """Get statistics about documentation embedding coverage.
+
+        Counts sections (not documents) since each section gets its own embedding.
+        """
+        docs_root = self._get_docs_root()
+
+        if not docs_root.exists():
+            return {"total": 0, "with_embeddings": 0, "without_embeddings": 0}
+
+        # Get all section content IDs
+        all_section_ids = self._get_all_section_content_ids(docs_root)
+        total_sections = len(all_section_ids)
+
+        if total_sections == 0:
+            return {"total": 0, "with_embeddings": 0, "without_embeddings": 0}
+
+        # Count embeddings in database for DOCUMENTATION type
+        embedded_result = await query_raw_with_schema(
+            """
+            SELECT COUNT(*) as count
+            FROM {schema_prefix}"UnifiedContentEmbedding"
+            WHERE "contentType" = 'DOCUMENTATION'::{schema_prefix}"ContentType"
+            """
+        )
+
+        with_embeddings = embedded_result[0]["count"] if embedded_result else 0
+
+        return {
+            "total": total_sections,
+            "with_embeddings": with_embeddings,
+            "without_embeddings": total_sections - with_embeddings,
+        }
+
+
+# Content handler registry
+CONTENT_HANDLERS: dict[ContentType, ContentHandler] = {
+    ContentType.STORE_AGENT: StoreAgentHandler(),
+    ContentType.BLOCK: BlockHandler(),
+    ContentType.DOCUMENTATION: DocumentationHandler(),
+}
diff --git a/autogpt_platform/backend/backend/api/features/store/content_handlers_integration_test.py b/autogpt_platform/backend/backend/api/features/store/content_handlers_integration_test.py
new file mode 100644
index 0000000000..b53a9e80b0
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/store/content_handlers_integration_test.py
@@ -0,0 +1,215 @@
+"""
+Integration tests for content handlers using real DB.
+
+Run with: poetry run pytest backend/api/features/store/content_handlers_integration_test.py -xvs
+
+These tests use the real database but mock OpenAI calls.
+"""
+
+from unittest.mock import patch
+
+import pytest
+
+from backend.api.features.store.content_handlers import (
+    CONTENT_HANDLERS,
+    BlockHandler,
+    DocumentationHandler,
+    StoreAgentHandler,
+)
+from backend.api.features.store.embeddings import (
+    EMBEDDING_DIM,
+    backfill_all_content_types,
+    ensure_content_embedding,
+    get_embedding_stats,
+)
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_store_agent_handler_real_db():
+    """Test StoreAgentHandler with real database queries."""
+    handler = StoreAgentHandler()
+
+    # Get stats from real DB
+    stats = await handler.get_stats()
+
+    # Stats should have correct structure
+    assert "total" in stats
+    assert "with_embeddings" in stats
+    assert "without_embeddings" in stats
+    assert stats["total"] >= 0
+    assert stats["with_embeddings"] >= 0
+    assert stats["without_embeddings"] >= 0
+
+    # Get missing items (max 1 to keep test fast)
+    items = await handler.get_missing_items(batch_size=1)
+
+    # Items should be list (may be empty if all have embeddings)
+    assert isinstance(items, list)
+
+    if items:
+        item = items[0]
+        assert item.content_id is not None
+        assert item.content_type.value == "STORE_AGENT"
+        assert item.searchable_text != ""
+        assert item.user_id is None
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_block_handler_real_db():
+    """Test BlockHandler with real database queries."""
+    handler = BlockHandler()
+
+    # Get stats from real DB
+    stats = await handler.get_stats()
+
+    # Stats should have correct structure
+    assert "total" in stats
+    assert "with_embeddings" in stats
+    assert "without_embeddings" in stats
+    assert stats["total"] >= 0  # Should have at least some blocks
+    assert stats["with_embeddings"] >= 0
+    assert stats["without_embeddings"] >= 0
+
+    # Get missing items (max 1 to keep test fast)
+    items = await handler.get_missing_items(batch_size=1)
+
+    # Items should be list
+    assert isinstance(items, list)
+
+    if items:
+        item = items[0]
+        assert item.content_id is not None  # Should be block UUID
+        assert item.content_type.value == "BLOCK"
+        assert item.searchable_text != ""
+        assert item.user_id is None
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_documentation_handler_real_fs():
+    """Test DocumentationHandler with real filesystem."""
+    handler = DocumentationHandler()
+
+    # Get stats from real filesystem
+    stats = await handler.get_stats()
+
+    # Stats should have correct structure
+    assert "total" in stats
+    assert "with_embeddings" in stats
+    assert "without_embeddings" in stats
+    assert stats["total"] >= 0
+    assert stats["with_embeddings"] >= 0
+    assert stats["without_embeddings"] >= 0
+
+    # Get missing items (max 1 to keep test fast)
+    items = await handler.get_missing_items(batch_size=1)
+
+    # Items should be list
+    assert isinstance(items, list)
+
+    if items:
+        item = items[0]
+        assert item.content_id is not None  # Should be relative path
+        assert item.content_type.value == "DOCUMENTATION"
+        assert item.searchable_text != ""
+        assert item.user_id is None
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_get_embedding_stats_all_types():
+    """Test get_embedding_stats aggregates all content types."""
+    stats = await get_embedding_stats()
+
+    # Should have structure with by_type and totals
+    assert "by_type" in stats
+    assert "totals" in stats
+
+    # Check each content type is present
+    by_type = stats["by_type"]
+    assert "STORE_AGENT" in by_type
+    assert "BLOCK" in by_type
+    assert "DOCUMENTATION" in by_type
+
+    # Check totals are aggregated
+    totals = stats["totals"]
+    assert totals["total"] >= 0
+    assert totals["with_embeddings"] >= 0
+    assert totals["without_embeddings"] >= 0
+    assert "coverage_percent" in totals
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@patch("backend.api.features.store.embeddings.generate_embedding")
+async def test_ensure_content_embedding_blocks(mock_generate):
+    """Test creating embeddings for blocks (mocked OpenAI)."""
+    # Mock OpenAI to return fake embedding
+    mock_generate.return_value = [0.1] * EMBEDDING_DIM
+
+    # Get one block without embedding
+    handler = BlockHandler()
+    items = await handler.get_missing_items(batch_size=1)
+
+    if not items:
+        pytest.skip("No blocks without embeddings")
+
+    item = items[0]
+
+    # Try to create embedding (OpenAI mocked)
+    result = await ensure_content_embedding(
+        content_type=item.content_type,
+        content_id=item.content_id,
+        searchable_text=item.searchable_text,
+        metadata=item.metadata,
+        user_id=item.user_id,
+    )
+
+    # Should succeed with mocked OpenAI
+    assert result is True
+    mock_generate.assert_called_once()
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@patch("backend.api.features.store.embeddings.generate_embedding")
+async def test_backfill_all_content_types_dry_run(mock_generate):
+    """Test backfill_all_content_types processes all handlers in order."""
+    # Mock OpenAI to return fake embedding
+    mock_generate.return_value = [0.1] * EMBEDDING_DIM
+
+    # Run backfill with batch_size=1 to process max 1 per type
+    result = await backfill_all_content_types(batch_size=1)
+
+    # Should have results for all content types
+    assert "by_type" in result
+    assert "totals" in result
+
+    by_type = result["by_type"]
+    assert "BLOCK" in by_type
+    assert "STORE_AGENT" in by_type
+    assert "DOCUMENTATION" in by_type
+
+    # Each type should have correct structure
+    for content_type, type_result in by_type.items():
+        assert "processed" in type_result
+        assert "success" in type_result
+        assert "failed" in type_result
+
+    # Totals should aggregate
+    totals = result["totals"]
+    assert totals["processed"] >= 0
+    assert totals["success"] >= 0
+    assert totals["failed"] >= 0
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_content_handler_registry():
+    """Test all handlers are registered in correct order."""
+    from prisma.enums import ContentType
+
+    # All three types should be registered
+    assert ContentType.STORE_AGENT in CONTENT_HANDLERS
+    assert ContentType.BLOCK in CONTENT_HANDLERS
+    assert ContentType.DOCUMENTATION in CONTENT_HANDLERS
+
+    # Check handler types
+    assert isinstance(CONTENT_HANDLERS[ContentType.STORE_AGENT], StoreAgentHandler)
+    assert isinstance(CONTENT_HANDLERS[ContentType.BLOCK], BlockHandler)
+    assert isinstance(CONTENT_HANDLERS[ContentType.DOCUMENTATION], DocumentationHandler)
diff --git a/autogpt_platform/backend/backend/api/features/store/content_handlers_test.py b/autogpt_platform/backend/backend/api/features/store/content_handlers_test.py
new file mode 100644
index 0000000000..28bc88e270
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/store/content_handlers_test.py
@@ -0,0 +1,381 @@
+"""
+E2E tests for content handlers (blocks, store agents, documentation).
+
+Tests the full flow: discovering content → generating embeddings → storing.
+"""
+
+from pathlib import Path
+from unittest.mock import MagicMock, patch
+
+import pytest
+from prisma.enums import ContentType
+
+from backend.api.features.store.content_handlers import (
+    CONTENT_HANDLERS,
+    BlockHandler,
+    DocumentationHandler,
+    StoreAgentHandler,
+)
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_store_agent_handler_get_missing_items(mocker):
+    """Test StoreAgentHandler fetches approved agents without embeddings."""
+    handler = StoreAgentHandler()
+
+    # Mock database query
+    mock_missing = [
+        {
+            "id": "agent-1",
+            "name": "Test Agent",
+            "description": "A test agent",
+            "subHeading": "Test heading",
+            "categories": ["AI", "Testing"],
+        }
+    ]
+
+    with patch(
+        "backend.api.features.store.content_handlers.query_raw_with_schema",
+        return_value=mock_missing,
+    ):
+        items = await handler.get_missing_items(batch_size=10)
+
+        assert len(items) == 1
+        assert items[0].content_id == "agent-1"
+        assert items[0].content_type == ContentType.STORE_AGENT
+        assert "Test Agent" in items[0].searchable_text
+        assert "A test agent" in items[0].searchable_text
+        assert items[0].metadata["name"] == "Test Agent"
+        assert items[0].user_id is None
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_store_agent_handler_get_stats(mocker):
+    """Test StoreAgentHandler returns correct stats."""
+    handler = StoreAgentHandler()
+
+    # Mock approved count query
+    mock_approved = [{"count": 50}]
+    # Mock embedded count query
+    mock_embedded = [{"count": 30}]
+
+    with patch(
+        "backend.api.features.store.content_handlers.query_raw_with_schema",
+        side_effect=[mock_approved, mock_embedded],
+    ):
+        stats = await handler.get_stats()
+
+        assert stats["total"] == 50
+        assert stats["with_embeddings"] == 30
+        assert stats["without_embeddings"] == 20
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_block_handler_get_missing_items(mocker):
+    """Test BlockHandler discovers blocks without embeddings."""
+    handler = BlockHandler()
+
+    # Mock get_blocks to return test blocks
+    mock_block_class = MagicMock()
+    mock_block_instance = MagicMock()
+    mock_block_instance.name = "Calculator Block"
+    mock_block_instance.description = "Performs calculations"
+    mock_block_instance.categories = [MagicMock(value="MATH")]
+    mock_block_instance.input_schema.model_json_schema.return_value = {
+        "properties": {"expression": {"description": "Math expression to evaluate"}}
+    }
+    mock_block_class.return_value = mock_block_instance
+
+    mock_blocks = {"block-uuid-1": mock_block_class}
+
+    # Mock existing embeddings query (no embeddings exist)
+    mock_existing = []
+
+    with patch(
+        "backend.data.block.get_blocks",
+        return_value=mock_blocks,
+    ):
+        with patch(
+            "backend.api.features.store.content_handlers.query_raw_with_schema",
+            return_value=mock_existing,
+        ):
+            items = await handler.get_missing_items(batch_size=10)
+
+            assert len(items) == 1
+            assert items[0].content_id == "block-uuid-1"
+            assert items[0].content_type == ContentType.BLOCK
+            assert "Calculator Block" in items[0].searchable_text
+            assert "Performs calculations" in items[0].searchable_text
+            assert "MATH" in items[0].searchable_text
+            assert "expression: Math expression" in items[0].searchable_text
+            assert items[0].user_id is None
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_block_handler_get_stats(mocker):
+    """Test BlockHandler returns correct stats."""
+    handler = BlockHandler()
+
+    # Mock get_blocks
+    mock_blocks = {
+        "block-1": MagicMock(),
+        "block-2": MagicMock(),
+        "block-3": MagicMock(),
+    }
+
+    # Mock embedded count query (2 blocks have embeddings)
+    mock_embedded = [{"count": 2}]
+
+    with patch(
+        "backend.data.block.get_blocks",
+        return_value=mock_blocks,
+    ):
+        with patch(
+            "backend.api.features.store.content_handlers.query_raw_with_schema",
+            return_value=mock_embedded,
+        ):
+            stats = await handler.get_stats()
+
+            assert stats["total"] == 3
+            assert stats["with_embeddings"] == 2
+            assert stats["without_embeddings"] == 1
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_documentation_handler_get_missing_items(tmp_path, mocker):
+    """Test DocumentationHandler discovers docs without embeddings."""
+    handler = DocumentationHandler()
+
+    # Create temporary docs directory with test files
+    docs_root = tmp_path / "docs"
+    docs_root.mkdir()
+
+    (docs_root / "guide.md").write_text("# Getting Started\n\nThis is a guide.")
+    (docs_root / "api.mdx").write_text("# API Reference\n\nAPI documentation.")
+
+    # Mock _get_docs_root to return temp dir
+    with patch.object(handler, "_get_docs_root", return_value=docs_root):
+        # Mock existing embeddings query (no embeddings exist)
+        with patch(
+            "backend.api.features.store.content_handlers.query_raw_with_schema",
+            return_value=[],
+        ):
+            items = await handler.get_missing_items(batch_size=10)
+
+            assert len(items) == 2
+
+            # Check guide.md (content_id format: doc_path::section_index)
+            guide_item = next(
+                (item for item in items if item.content_id == "guide.md::0"), None
+            )
+            assert guide_item is not None
+            assert guide_item.content_type == ContentType.DOCUMENTATION
+            assert "Getting Started" in guide_item.searchable_text
+            assert "This is a guide" in guide_item.searchable_text
+            assert guide_item.metadata["doc_title"] == "Getting Started"
+            assert guide_item.user_id is None
+
+            # Check api.mdx (content_id format: doc_path::section_index)
+            api_item = next(
+                (item for item in items if item.content_id == "api.mdx::0"), None
+            )
+            assert api_item is not None
+            assert "API Reference" in api_item.searchable_text
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_documentation_handler_get_stats(tmp_path, mocker):
+    """Test DocumentationHandler returns correct stats."""
+    handler = DocumentationHandler()
+
+    # Create temporary docs directory
+    docs_root = tmp_path / "docs"
+    docs_root.mkdir()
+    (docs_root / "doc1.md").write_text("# Doc 1")
+    (docs_root / "doc2.md").write_text("# Doc 2")
+    (docs_root / "doc3.mdx").write_text("# Doc 3")
+
+    # Mock embedded count query (1 doc has embedding)
+    mock_embedded = [{"count": 1}]
+
+    with patch.object(handler, "_get_docs_root", return_value=docs_root):
+        with patch(
+            "backend.api.features.store.content_handlers.query_raw_with_schema",
+            return_value=mock_embedded,
+        ):
+            stats = await handler.get_stats()
+
+            assert stats["total"] == 3
+            assert stats["with_embeddings"] == 1
+            assert stats["without_embeddings"] == 2
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_documentation_handler_title_extraction(tmp_path):
+    """Test DocumentationHandler extracts title from markdown heading."""
+    handler = DocumentationHandler()
+
+    # Test with heading
+    doc_with_heading = tmp_path / "with_heading.md"
+    doc_with_heading.write_text("# My Title\n\nContent here")
+    title = handler._extract_doc_title(doc_with_heading)
+    assert title == "My Title"
+
+    # Test without heading
+    doc_without_heading = tmp_path / "no-heading.md"
+    doc_without_heading.write_text("Just content, no heading")
+    title = handler._extract_doc_title(doc_without_heading)
+    assert title == "No Heading"  # Uses filename
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_documentation_handler_markdown_chunking(tmp_path):
+    """Test DocumentationHandler chunks markdown by headings."""
+    handler = DocumentationHandler()
+
+    # Test document with multiple sections
+    doc_with_sections = tmp_path / "sections.md"
+    doc_with_sections.write_text(
+        "# Document Title\n\n"
+        "Intro paragraph.\n\n"
+        "## Section One\n\n"
+        "Content for section one.\n\n"
+        "## Section Two\n\n"
+        "Content for section two.\n"
+    )
+    sections = handler._chunk_markdown_by_headings(doc_with_sections)
+
+    # Should have 3 sections: intro (with doc title), section one, section two
+    assert len(sections) == 3
+    assert sections[0].title == "Document Title"
+    assert sections[0].index == 0
+    assert "Intro paragraph" in sections[0].content
+
+    assert sections[1].title == "Section One"
+    assert sections[1].index == 1
+    assert "Content for section one" in sections[1].content
+
+    assert sections[2].title == "Section Two"
+    assert sections[2].index == 2
+    assert "Content for section two" in sections[2].content
+
+    # Test document without headings
+    doc_no_sections = tmp_path / "no-sections.md"
+    doc_no_sections.write_text("Just plain content without any headings.")
+    sections = handler._chunk_markdown_by_headings(doc_no_sections)
+    assert len(sections) == 1
+    assert sections[0].index == 0
+    assert "Just plain content" in sections[0].content
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_documentation_handler_section_content_ids():
+    """Test DocumentationHandler creates and parses section content IDs."""
+    handler = DocumentationHandler()
+
+    # Test making content ID
+    content_id = handler._make_section_content_id("docs/guide.md", 2)
+    assert content_id == "docs/guide.md::2"
+
+    # Test parsing content ID
+    doc_path, section_index = handler._parse_section_content_id("docs/guide.md::2")
+    assert doc_path == "docs/guide.md"
+    assert section_index == 2
+
+    # Test parsing legacy format (no section index)
+    doc_path, section_index = handler._parse_section_content_id("docs/old-format.md")
+    assert doc_path == "docs/old-format.md"
+    assert section_index == 0
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_content_handlers_registry():
+    """Test all content types are registered."""
+    assert ContentType.STORE_AGENT in CONTENT_HANDLERS
+    assert ContentType.BLOCK in CONTENT_HANDLERS
+    assert ContentType.DOCUMENTATION in CONTENT_HANDLERS
+
+    assert isinstance(CONTENT_HANDLERS[ContentType.STORE_AGENT], StoreAgentHandler)
+    assert isinstance(CONTENT_HANDLERS[ContentType.BLOCK], BlockHandler)
+    assert isinstance(CONTENT_HANDLERS[ContentType.DOCUMENTATION], DocumentationHandler)
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_block_handler_handles_missing_attributes():
+    """Test BlockHandler gracefully handles blocks with missing attributes."""
+    handler = BlockHandler()
+
+    # Mock block with minimal attributes
+    mock_block_class = MagicMock()
+    mock_block_instance = MagicMock()
+    mock_block_instance.name = "Minimal Block"
+    # No description, categories, or schema
+    del mock_block_instance.description
+    del mock_block_instance.categories
+    del mock_block_instance.input_schema
+    mock_block_class.return_value = mock_block_instance
+
+    mock_blocks = {"block-minimal": mock_block_class}
+
+    with patch(
+        "backend.data.block.get_blocks",
+        return_value=mock_blocks,
+    ):
+        with patch(
+            "backend.api.features.store.content_handlers.query_raw_with_schema",
+            return_value=[],
+        ):
+            items = await handler.get_missing_items(batch_size=10)
+
+            assert len(items) == 1
+            assert items[0].searchable_text == "Minimal Block"
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_block_handler_skips_failed_blocks():
+    """Test BlockHandler skips blocks that fail to instantiate."""
+    handler = BlockHandler()
+
+    # Mock one good block and one bad block
+    good_block = MagicMock()
+    good_instance = MagicMock()
+    good_instance.name = "Good Block"
+    good_instance.description = "Works fine"
+    good_instance.categories = []
+    good_block.return_value = good_instance
+
+    bad_block = MagicMock()
+    bad_block.side_effect = Exception("Instantiation failed")
+
+    mock_blocks = {"good-block": good_block, "bad-block": bad_block}
+
+    with patch(
+        "backend.data.block.get_blocks",
+        return_value=mock_blocks,
+    ):
+        with patch(
+            "backend.api.features.store.content_handlers.query_raw_with_schema",
+            return_value=[],
+        ):
+            items = await handler.get_missing_items(batch_size=10)
+
+            # Should only get the good block
+            assert len(items) == 1
+            assert items[0].content_id == "good-block"
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_documentation_handler_missing_docs_directory():
+    """Test DocumentationHandler handles missing docs directory gracefully."""
+    handler = DocumentationHandler()
+
+    # Mock _get_docs_root to return non-existent path
+    fake_path = Path("/nonexistent/docs")
+    with patch.object(handler, "_get_docs_root", return_value=fake_path):
+        items = await handler.get_missing_items(batch_size=10)
+        assert items == []
+
+        stats = await handler.get_stats()
+        assert stats["total"] == 0
+        assert stats["with_embeddings"] == 0
+        assert stats["without_embeddings"] == 0
diff --git a/autogpt_platform/backend/backend/api/features/store/db.py b/autogpt_platform/backend/backend/api/features/store/db.py
index 8e5a39df89..e6aa3853f6 100644
--- a/autogpt_platform/backend/backend/api/features/store/db.py
+++ b/autogpt_platform/backend/backend/api/features/store/db.py
@@ -1,8 +1,7 @@
 import asyncio
 import logging
-import typing
 from datetime import datetime, timezone
-from typing import Literal
+from typing import Any, Literal
 
 import fastapi
 import prisma.enums
@@ -10,7 +9,7 @@ import prisma.errors
 import prisma.models
 import prisma.types
 
-from backend.data.db import query_raw_with_schema, transaction
+from backend.data.db import transaction
 from backend.data.graph import (
     GraphMeta,
     GraphModel,
@@ -30,6 +29,8 @@ from backend.util.settings import Settings
 
 from . import exceptions as store_exceptions
 from . import model as store_model
+from .embeddings import ensure_embedding
+from .hybrid_search import hybrid_search
 
 logger = logging.getLogger(__name__)
 settings = Settings()
@@ -50,128 +51,77 @@ async def get_store_agents(
     page_size: int = 20,
 ) -> store_model.StoreAgentsResponse:
     """
-    Get PUBLIC store agents from the StoreAgent view
+    Get PUBLIC store agents from the StoreAgent view.
+
+    Search behavior:
+    - With search_query: Uses hybrid search (semantic + lexical)
+    - Fallback: If embeddings unavailable, gracefully degrades to lexical-only
+    - Rationale: User-facing endpoint prioritizes availability over accuracy
+
+    Note: Admin operations (approval) use fail-fast to prevent inconsistent state.
     """
     logger.debug(
         f"Getting store agents. featured={featured}, creators={creators}, sorted_by={sorted_by}, search={search_query}, category={category}, page={page}"
     )
 
+    search_used_hybrid = False
+    store_agents: list[store_model.StoreAgent] = []
+    agents: list[dict[str, Any]] = []
+    total = 0
+    total_pages = 0
+
     try:
-        # If search_query is provided, use full-text search
+        # If search_query is provided, use hybrid search (embeddings + tsvector)
         if search_query:
-            offset = (page - 1) * page_size
+            # Try hybrid search combining semantic and lexical signals
+            # Falls back to lexical-only if OpenAI unavailable (user-facing, high SLA)
+            try:
+                agents, total = await hybrid_search(
+                    query=search_query,
+                    featured=featured,
+                    creators=creators,
+                    category=category,
+                    sorted_by="relevance",  # Use hybrid scoring for relevance
+                    page=page,
+                    page_size=page_size,
+                )
+                search_used_hybrid = True
+            except Exception as e:
+                # Log error but fall back to lexical search for better UX
+                logger.error(
+                    f"Hybrid search failed (likely OpenAI unavailable), "
+                    f"falling back to lexical search: {e}"
+                )
+                # search_used_hybrid remains False, will use fallback path below
 
-            # Whitelist allowed order_by columns
-            ALLOWED_ORDER_BY = {
-                "rating": "rating DESC, rank DESC",
-                "runs": "runs DESC, rank DESC",
-                "name": "agent_name ASC, rank ASC",
-                "updated_at": "updated_at DESC, rank DESC",
-            }
+            # Convert hybrid search results (dict format) if hybrid succeeded
+            if search_used_hybrid:
+                total_pages = (total + page_size - 1) // page_size
+                store_agents: list[store_model.StoreAgent] = []
+                for agent in agents:
+                    try:
+                        store_agent = store_model.StoreAgent(
+                            slug=agent["slug"],
+                            agent_name=agent["agent_name"],
+                            agent_image=(
+                                agent["agent_image"][0] if agent["agent_image"] else ""
+                            ),
+                            creator=agent["creator_username"] or "Needs Profile",
+                            creator_avatar=agent["creator_avatar"] or "",
+                            sub_heading=agent["sub_heading"],
+                            description=agent["description"],
+                            runs=agent["runs"],
+                            rating=agent["rating"],
+                        )
+                        store_agents.append(store_agent)
+                    except Exception as e:
+                        logger.error(
+                            f"Error parsing Store agent from hybrid search results: {e}"
+                        )
+                        continue
 
-            # Validate and get order clause
-            if sorted_by and sorted_by in ALLOWED_ORDER_BY:
-                order_by_clause = ALLOWED_ORDER_BY[sorted_by]
-            else:
-                order_by_clause = "updated_at DESC, rank DESC"
-
-            # Build WHERE conditions and parameters list
-            where_parts: list[str] = []
-            params: list[typing.Any] = [search_query]  # $1 - search term
-            param_index = 2  # Start at $2 for next parameter
-
-            # Always filter for available agents
-            where_parts.append("is_available = true")
-
-            if featured:
-                where_parts.append("featured = true")
-
-            if creators and creators:
-                # Use ANY with array parameter
-                where_parts.append(f"creator_username = ANY(${param_index})")
-                params.append(creators)
-                param_index += 1
-
-            if category and category:
-                where_parts.append(f"${param_index} = ANY(categories)")
-                params.append(category)
-                param_index += 1
-
-            sql_where_clause: str = " AND ".join(where_parts) if where_parts else "1=1"
-
-            # Add pagination params
-            params.extend([page_size, offset])
-            limit_param = f"${param_index}"
-            offset_param = f"${param_index + 1}"
-
-            # Execute full-text search query with parameterized values
-            sql_query = f"""
-                SELECT
-                    slug,
-                    agent_name,
-                    agent_image,
-                    creator_username,
-                    creator_avatar,
-                    sub_heading,
-                    description,
-                    runs,
-                    rating,
-                    categories,
-                    featured,
-                    is_available,
-                    updated_at,
-                    ts_rank_cd(search, query) AS rank
-                FROM {{schema_prefix}}"StoreAgent",
-                    plainto_tsquery('english', $1) AS query
-                WHERE {sql_where_clause}
-                    AND search @@ query
-                ORDER BY {order_by_clause}
-                LIMIT {limit_param} OFFSET {offset_param}
-            """
-
-            # Count query for pagination - only uses search term parameter
-            count_query = f"""
-                SELECT COUNT(*) as count
-                FROM {{schema_prefix}}"StoreAgent",
-                    plainto_tsquery('english', $1) AS query
-                WHERE {sql_where_clause}
-                    AND search @@ query
-            """
-
-            # Execute both queries with parameters
-            agents = await query_raw_with_schema(sql_query, *params)
-
-            # For count, use params without pagination (last 2 params)
-            count_params = params[:-2]
-            count_result = await query_raw_with_schema(count_query, *count_params)
-
-            total = count_result[0]["count"] if count_result else 0
-            total_pages = (total + page_size - 1) // page_size
-
-            # Convert raw results to StoreAgent models
-            store_agents: list[store_model.StoreAgent] = []
-            for agent in agents:
-                try:
-                    store_agent = store_model.StoreAgent(
-                        slug=agent["slug"],
-                        agent_name=agent["agent_name"],
-                        agent_image=(
-                            agent["agent_image"][0] if agent["agent_image"] else ""
-                        ),
-                        creator=agent["creator_username"] or "Needs Profile",
-                        creator_avatar=agent["creator_avatar"] or "",
-                        sub_heading=agent["sub_heading"],
-                        description=agent["description"],
-                        runs=agent["runs"],
-                        rating=agent["rating"],
-                    )
-                    store_agents.append(store_agent)
-                except Exception as e:
-                    logger.error(f"Error parsing Store agent from search results: {e}")
-                    continue
-
-        else:
-            # Non-search query path (original logic)
+        if not search_used_hybrid:
+            # Fallback path - use basic search or no search
             where_clause: prisma.types.StoreAgentWhereInput = {"is_available": True}
             if featured:
                 where_clause["featured"] = featured
@@ -180,6 +130,14 @@ async def get_store_agents(
             if category:
                 where_clause["categories"] = {"has": category}
 
+            # Add basic text search if search_query provided but hybrid failed
+            if search_query:
+                where_clause["OR"] = [
+                    {"agent_name": {"contains": search_query, "mode": "insensitive"}},
+                    {"sub_heading": {"contains": search_query, "mode": "insensitive"}},
+                    {"description": {"contains": search_query, "mode": "insensitive"}},
+                ]
+
             order_by = []
             if sorted_by == "rating":
                 order_by.append({"rating": "desc"})
@@ -188,7 +146,7 @@ async def get_store_agents(
             elif sorted_by == "name":
                 order_by.append({"agent_name": "asc"})
 
-            agents = await prisma.models.StoreAgent.prisma().find_many(
+            db_agents = await prisma.models.StoreAgent.prisma().find_many(
                 where=where_clause,
                 order=order_by,
                 skip=(page - 1) * page_size,
@@ -199,7 +157,7 @@ async def get_store_agents(
             total_pages = (total + page_size - 1) // page_size
 
             store_agents: list[store_model.StoreAgent] = []
-            for agent in agents:
+            for agent in db_agents:
                 try:
                     # Create the StoreAgent object safely
                     store_agent = store_model.StoreAgent(
@@ -614,6 +572,7 @@ async def get_store_submissions(
         submission_models = []
         for sub in submissions:
             submission_model = store_model.StoreSubmission(
+                listing_id=sub.listing_id,
                 agent_id=sub.agent_id,
                 agent_version=sub.agent_version,
                 name=sub.name,
@@ -667,35 +626,48 @@ async def delete_store_submission(
     submission_id: str,
 ) -> bool:
     """
-    Delete a store listing submission as the submitting user.
+    Delete a store submission version as the submitting user.
 
     Args:
         user_id: ID of the authenticated user
-        submission_id: ID of the submission to be deleted
+        submission_id: StoreListingVersion ID to delete
 
     Returns:
-        bool: True if the submission was successfully deleted, False otherwise
+        bool: True if successfully deleted
     """
-    logger.debug(f"Deleting store submission {submission_id} for user {user_id}")
-
     try:
-        # Verify the submission belongs to this user
-        submission = await prisma.models.StoreListing.prisma().find_first(
-            where={"agentGraphId": submission_id, "owningUserId": user_id}
+        # Find the submission version with ownership check
+        version = await prisma.models.StoreListingVersion.prisma().find_first(
+            where={"id": submission_id}, include={"StoreListing": True}
         )
 
-        if not submission:
-            logger.warning(f"Submission not found for user {user_id}: {submission_id}")
-            raise store_exceptions.SubmissionNotFoundError(
-                f"Submission not found for this user. User ID: {user_id}, Submission ID: {submission_id}"
+        if (
+            not version
+            or not version.StoreListing
+            or version.StoreListing.owningUserId != user_id
+        ):
+            raise store_exceptions.SubmissionNotFoundError("Submission not found")
+
+        # Prevent deletion of approved submissions
+        if version.submissionStatus == prisma.enums.SubmissionStatus.APPROVED:
+            raise store_exceptions.InvalidOperationError(
+                "Cannot delete approved submissions"
             )
 
-        # Delete the submission
-        await prisma.models.StoreListing.prisma().delete(where={"id": submission.id})
-
-        logger.debug(
-            f"Successfully deleted submission {submission_id} for user {user_id}"
+        # Delete the version
+        await prisma.models.StoreListingVersion.prisma().delete(
+            where={"id": version.id}
         )
+
+        # Clean up empty listing if this was the last version
+        remaining = await prisma.models.StoreListingVersion.prisma().count(
+            where={"storeListingId": version.storeListingId}
+        )
+        if remaining == 0:
+            await prisma.models.StoreListing.prisma().delete(
+                where={"id": version.storeListingId}
+            )
+
         return True
 
     except Exception as e:
@@ -759,9 +731,15 @@ async def create_store_submission(
             logger.warning(
                 f"Agent not found for user {user_id}: {agent_id} v{agent_version}"
             )
-            raise store_exceptions.AgentNotFoundError(
-                f"Agent not found for this user. User ID: {user_id}, Agent ID: {agent_id}, Version: {agent_version}"
-            )
+            # Provide more user-friendly error message when agent_id is empty
+            if not agent_id or agent_id.strip() == "":
+                raise store_exceptions.AgentNotFoundError(
+                    "No agent selected. Please select an agent before submitting to the store."
+                )
+            else:
+                raise store_exceptions.AgentNotFoundError(
+                    f"Agent not found for this user. User ID: {user_id}, Agent ID: {agent_id}, Version: {agent_version}"
+                )
 
         # Check if listing already exists for this agent
         existing_listing = await prisma.models.StoreListing.prisma().find_first(
@@ -833,6 +811,7 @@ async def create_store_submission(
         logger.debug(f"Created store listing for agent {agent_id}")
         # Return submission details
         return store_model.StoreSubmission(
+            listing_id=listing.id,
             agent_id=agent_id,
             agent_version=agent_version,
             name=name,
@@ -944,81 +923,56 @@ async def edit_store_submission(
         # Currently we are not allowing user to update the agent associated with a submission
         # If we allow it in future, then we need a check here to verify the agent belongs to this user.
 
-        # Check if we can edit this submission
-        if current_version.submissionStatus == prisma.enums.SubmissionStatus.REJECTED:
+        # Only allow editing of PENDING submissions
+        if current_version.submissionStatus != prisma.enums.SubmissionStatus.PENDING:
             raise store_exceptions.InvalidOperationError(
-                "Cannot edit a rejected submission"
-            )
-
-        # For APPROVED submissions, we need to create a new version
-        if current_version.submissionStatus == prisma.enums.SubmissionStatus.APPROVED:
-            # Create a new version for the existing listing
-            return await create_store_version(
-                user_id=user_id,
-                agent_id=current_version.agentGraphId,
-                agent_version=current_version.agentGraphVersion,
-                store_listing_id=current_version.storeListingId,
-                name=name,
-                video_url=video_url,
-                agent_output_demo_url=agent_output_demo_url,
-                image_urls=image_urls,
-                description=description,
-                sub_heading=sub_heading,
-                categories=categories,
-                changes_summary=changes_summary,
-                recommended_schedule_cron=recommended_schedule_cron,
-                instructions=instructions,
+                f"Cannot edit a {current_version.submissionStatus.value.lower()} submission. Only pending submissions can be edited."
             )
 
         # For PENDING submissions, we can update the existing version
-        elif current_version.submissionStatus == prisma.enums.SubmissionStatus.PENDING:
-            # Update the existing version
-            updated_version = await prisma.models.StoreListingVersion.prisma().update(
-                where={"id": store_listing_version_id},
-                data=prisma.types.StoreListingVersionUpdateInput(
-                    name=name,
-                    videoUrl=video_url,
-                    agentOutputDemoUrl=agent_output_demo_url,
-                    imageUrls=image_urls,
-                    description=description,
-                    categories=categories,
-                    subHeading=sub_heading,
-                    changesSummary=changes_summary,
-                    recommendedScheduleCron=recommended_schedule_cron,
-                    instructions=instructions,
-                ),
-            )
-
-            logger.debug(
-                f"Updated existing version {store_listing_version_id} for agent {current_version.agentGraphId}"
-            )
-
-            if not updated_version:
-                raise DatabaseError("Failed to update store listing version")
-            return store_model.StoreSubmission(
-                agent_id=current_version.agentGraphId,
-                agent_version=current_version.agentGraphVersion,
+        # Update the existing version
+        updated_version = await prisma.models.StoreListingVersion.prisma().update(
+            where={"id": store_listing_version_id},
+            data=prisma.types.StoreListingVersionUpdateInput(
                 name=name,
-                sub_heading=sub_heading,
-                slug=current_version.StoreListing.slug,
+                videoUrl=video_url,
+                agentOutputDemoUrl=agent_output_demo_url,
+                imageUrls=image_urls,
                 description=description,
-                instructions=instructions,
-                image_urls=image_urls,
-                date_submitted=updated_version.submittedAt or updated_version.createdAt,
-                status=updated_version.submissionStatus,
-                runs=0,
-                rating=0.0,
-                store_listing_version_id=updated_version.id,
-                changes_summary=changes_summary,
-                video_url=video_url,
                 categories=categories,
-                version=updated_version.version,
-            )
+                subHeading=sub_heading,
+                changesSummary=changes_summary,
+                recommendedScheduleCron=recommended_schedule_cron,
+                instructions=instructions,
+            ),
+        )
 
-        else:
-            raise store_exceptions.InvalidOperationError(
-                f"Cannot edit submission with status: {current_version.submissionStatus}"
-            )
+        logger.debug(
+            f"Updated existing version {store_listing_version_id} for agent {current_version.agentGraphId}"
+        )
+
+        if not updated_version:
+            raise DatabaseError("Failed to update store listing version")
+        return store_model.StoreSubmission(
+            listing_id=current_version.StoreListing.id,
+            agent_id=current_version.agentGraphId,
+            agent_version=current_version.agentGraphVersion,
+            name=name,
+            sub_heading=sub_heading,
+            slug=current_version.StoreListing.slug,
+            description=description,
+            instructions=instructions,
+            image_urls=image_urls,
+            date_submitted=updated_version.submittedAt or updated_version.createdAt,
+            status=updated_version.submissionStatus,
+            runs=0,
+            rating=0.0,
+            store_listing_version_id=updated_version.id,
+            changes_summary=changes_summary,
+            video_url=video_url,
+            categories=categories,
+            version=updated_version.version,
+        )
 
     except (
         store_exceptions.SubmissionNotFoundError,
@@ -1097,38 +1051,78 @@ async def create_store_version(
                 f"Agent not found for this user. User ID: {user_id}, Agent ID: {agent_id}, Version: {agent_version}"
             )
 
-        # Get the latest version number
-        latest_version = listing.Versions[0] if listing.Versions else None
-
-        next_version = (latest_version.version + 1) if latest_version else 1
-
-        # Create a new version for the existing listing
-        new_version = await prisma.models.StoreListingVersion.prisma().create(
-            data=prisma.types.StoreListingVersionCreateInput(
-                version=next_version,
-                agentGraphId=agent_id,
-                agentGraphVersion=agent_version,
-                name=name,
-                videoUrl=video_url,
-                agentOutputDemoUrl=agent_output_demo_url,
-                imageUrls=image_urls,
-                description=description,
-                instructions=instructions,
-                categories=categories,
-                subHeading=sub_heading,
-                submissionStatus=prisma.enums.SubmissionStatus.PENDING,
-                submittedAt=datetime.now(),
-                changesSummary=changes_summary,
-                recommendedScheduleCron=recommended_schedule_cron,
-                storeListingId=store_listing_id,
+        # Check if there's already a PENDING submission for this agent (any version)
+        existing_pending_submission = (
+            await prisma.models.StoreListingVersion.prisma().find_first(
+                where=prisma.types.StoreListingVersionWhereInput(
+                    storeListingId=store_listing_id,
+                    agentGraphId=agent_id,
+                    submissionStatus=prisma.enums.SubmissionStatus.PENDING,
+                    isDeleted=False,
+                )
             )
         )
 
+        # Handle existing pending submission and create new one atomically
+        async with transaction() as tx:
+            # Get the latest version number first
+            latest_listing = await prisma.models.StoreListing.prisma(tx).find_first(
+                where=prisma.types.StoreListingWhereInput(
+                    id=store_listing_id, owningUserId=user_id
+                ),
+                include={"Versions": {"order_by": {"version": "desc"}, "take": 1}},
+            )
+
+            if not latest_listing:
+                raise store_exceptions.ListingNotFoundError(
+                    f"Store listing not found. User ID: {user_id}, Listing ID: {store_listing_id}"
+                )
+
+            latest_version = (
+                latest_listing.Versions[0] if latest_listing.Versions else None
+            )
+            next_version = (latest_version.version + 1) if latest_version else 1
+
+            # If there's an existing pending submission, delete it atomically before creating new one
+            if existing_pending_submission:
+                logger.info(
+                    f"Found existing PENDING submission for agent {agent_id} (was v{existing_pending_submission.agentGraphVersion}, now v{agent_version}), replacing existing submission instead of creating duplicate"
+                )
+                await prisma.models.StoreListingVersion.prisma(tx).delete(
+                    where={"id": existing_pending_submission.id}
+                )
+                logger.debug(
+                    f"Deleted existing pending submission {existing_pending_submission.id}"
+                )
+
+            # Create a new version for the existing listing
+            new_version = await prisma.models.StoreListingVersion.prisma(tx).create(
+                data=prisma.types.StoreListingVersionCreateInput(
+                    version=next_version,
+                    agentGraphId=agent_id,
+                    agentGraphVersion=agent_version,
+                    name=name,
+                    videoUrl=video_url,
+                    agentOutputDemoUrl=agent_output_demo_url,
+                    imageUrls=image_urls,
+                    description=description,
+                    instructions=instructions,
+                    categories=categories,
+                    subHeading=sub_heading,
+                    submissionStatus=prisma.enums.SubmissionStatus.PENDING,
+                    submittedAt=datetime.now(),
+                    changesSummary=changes_summary,
+                    recommendedScheduleCron=recommended_schedule_cron,
+                    storeListingId=store_listing_id,
+                )
+            )
+
         logger.debug(
             f"Created new version for listing {store_listing_id} of agent {agent_id}"
         )
         # Return submission details
         return store_model.StoreSubmission(
+            listing_id=listing.id,
             agent_id=agent_id,
             agent_version=agent_version,
             name=name,
@@ -1541,7 +1535,7 @@ async def review_store_submission(
                 )
 
                 # Update the AgentGraph with store listing data
-                await prisma.models.AgentGraph.prisma().update(
+                await prisma.models.AgentGraph.prisma(tx).update(
                     where={
                         "graphVersionId": {
                             "id": store_listing_version.agentGraphId,
@@ -1556,6 +1550,23 @@ async def review_store_submission(
                     },
                 )
 
+                # Generate embedding for approved listing (blocking - admin operation)
+                # Inside transaction: if embedding fails, entire transaction rolls back
+                embedding_success = await ensure_embedding(
+                    version_id=store_listing_version_id,
+                    name=store_listing_version.name,
+                    description=store_listing_version.description,
+                    sub_heading=store_listing_version.subHeading,
+                    categories=store_listing_version.categories or [],
+                    tx=tx,
+                )
+                if not embedding_success:
+                    raise ValueError(
+                        f"Failed to generate embedding for listing {store_listing_version_id}. "
+                        "This is likely due to OpenAI API being unavailable. "
+                        "Please try again later or contact support if the issue persists."
+                    )
+
                 await prisma.models.StoreListing.prisma(tx).update(
                     where={"id": store_listing_version.StoreListing.id},
                     data={
@@ -1708,15 +1719,12 @@ async def review_store_submission(
 
         # Convert to Pydantic model for consistency
         return store_model.StoreSubmission(
+            listing_id=(submission.StoreListing.id if submission.StoreListing else ""),
             agent_id=submission.agentGraphId,
             agent_version=submission.agentGraphVersion,
             name=submission.name,
             sub_heading=submission.subHeading,
-            slug=(
-                submission.StoreListing.slug
-                if hasattr(submission, "storeListing") and submission.StoreListing
-                else ""
-            ),
+            slug=(submission.StoreListing.slug if submission.StoreListing else ""),
             description=submission.description,
             instructions=submission.instructions,
             image_urls=submission.imageUrls or [],
@@ -1818,9 +1826,7 @@ async def get_admin_listings_with_versions(
         where = prisma.types.StoreListingWhereInput(**where_dict)
         include = prisma.types.StoreListingInclude(
             Versions=prisma.types.FindManyStoreListingVersionArgsFromStoreListing(
-                order_by=prisma.types._StoreListingVersion_version_OrderByInput(
-                    version="desc"
-                )
+                order_by={"version": "desc"}
             ),
             OwningUser=True,
         )
@@ -1845,6 +1851,7 @@ async def get_admin_listings_with_versions(
             # If we have versions, turn them into StoreSubmission models
             for version in listing.Versions or []:
                 version_model = store_model.StoreSubmission(
+                    listing_id=listing.id,
                     agent_id=version.agentGraphId,
                     agent_version=version.agentGraphVersion,
                     name=version.name,
diff --git a/autogpt_platform/backend/backend/api/features/store/embeddings.py b/autogpt_platform/backend/backend/api/features/store/embeddings.py
new file mode 100644
index 0000000000..a421d8cd93
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/store/embeddings.py
@@ -0,0 +1,962 @@
+"""
+Unified Content Embeddings Service
+
+Handles generation and storage of OpenAI embeddings for all content types
+(store listings, blocks, documentation, library agents) to enable semantic/hybrid search.
+"""
+
+import asyncio
+import logging
+import time
+from typing import Any
+
+import prisma
+from prisma.enums import ContentType
+from tiktoken import encoding_for_model
+
+from backend.api.features.store.content_handlers import CONTENT_HANDLERS
+from backend.data.db import execute_raw_with_schema, query_raw_with_schema
+from backend.util.clients import get_openai_client
+from backend.util.json import dumps
+
+logger = logging.getLogger(__name__)
+
+
+# OpenAI embedding model configuration
+EMBEDDING_MODEL = "text-embedding-3-small"
+# Embedding dimension for the model above
+# text-embedding-3-small: 1536, text-embedding-3-large: 3072
+EMBEDDING_DIM = 1536
+# OpenAI embedding token limit (8,191 with 1 token buffer for safety)
+EMBEDDING_MAX_TOKENS = 8191
+
+
+def build_searchable_text(
+    name: str,
+    description: str,
+    sub_heading: str,
+    categories: list[str],
+) -> str:
+    """
+    Build searchable text from listing version fields.
+
+    Combines relevant fields into a single string for embedding.
+    """
+    parts = []
+
+    # Name is important - include it
+    if name:
+        parts.append(name)
+
+    # Sub-heading provides context
+    if sub_heading:
+        parts.append(sub_heading)
+
+    # Description is the main content
+    if description:
+        parts.append(description)
+
+    # Categories help with semantic matching
+    if categories:
+        parts.append(" ".join(categories))
+
+    return " ".join(parts)
+
+
+async def generate_embedding(text: str) -> list[float] | None:
+    """
+    Generate embedding for text using OpenAI API.
+
+    Returns None if embedding generation fails.
+    Fail-fast: no retries to maintain consistency with approval flow.
+    """
+    try:
+        client = get_openai_client()
+        if not client:
+            logger.error("openai_internal_api_key not set, cannot generate embedding")
+            return None
+
+        # Truncate text to token limit using tiktoken
+        # Character-based truncation is insufficient because token ratios vary by content type
+        enc = encoding_for_model(EMBEDDING_MODEL)
+        tokens = enc.encode(text)
+        if len(tokens) > EMBEDDING_MAX_TOKENS:
+            tokens = tokens[:EMBEDDING_MAX_TOKENS]
+            truncated_text = enc.decode(tokens)
+            logger.info(
+                f"Truncated text from {len(enc.encode(text))} to {len(tokens)} tokens"
+            )
+        else:
+            truncated_text = text
+
+        start_time = time.time()
+        response = await client.embeddings.create(
+            model=EMBEDDING_MODEL,
+            input=truncated_text,
+        )
+        latency_ms = (time.time() - start_time) * 1000
+
+        embedding = response.data[0].embedding
+        logger.info(
+            f"Generated embedding: {len(embedding)} dims, "
+            f"{len(tokens)} tokens, {latency_ms:.0f}ms"
+        )
+        return embedding
+
+    except Exception as e:
+        logger.error(f"Failed to generate embedding: {e}")
+        return None
+
+
+async def store_embedding(
+    version_id: str,
+    embedding: list[float],
+    tx: prisma.Prisma | None = None,
+) -> bool:
+    """
+    Store embedding in the database.
+
+    BACKWARD COMPATIBILITY: Maintained for existing store listing usage.
+    DEPRECATED: Use ensure_embedding() instead (includes searchable_text).
+    """
+    return await store_content_embedding(
+        content_type=ContentType.STORE_AGENT,
+        content_id=version_id,
+        embedding=embedding,
+        searchable_text="",  # Empty for backward compat; ensure_embedding() populates this
+        metadata=None,
+        user_id=None,  # Store agents are public
+        tx=tx,
+    )
+
+
+async def store_content_embedding(
+    content_type: ContentType,
+    content_id: str,
+    embedding: list[float],
+    searchable_text: str,
+    metadata: dict | None = None,
+    user_id: str | None = None,
+    tx: prisma.Prisma | None = None,
+) -> bool:
+    """
+    Store embedding in the unified content embeddings table.
+
+    New function for unified content embedding storage.
+    Uses raw SQL since Prisma doesn't natively support pgvector.
+    """
+    try:
+        client = tx if tx else prisma.get_client()
+
+        # Convert embedding to PostgreSQL vector format
+        embedding_str = embedding_to_vector_string(embedding)
+        metadata_json = dumps(metadata or {})
+
+        # Upsert the embedding
+        # WHERE clause in DO UPDATE prevents PostgreSQL 15 bug with NULLS NOT DISTINCT
+        await execute_raw_with_schema(
+            """
+            INSERT INTO {schema_prefix}"UnifiedContentEmbedding" (
+                "id", "contentType", "contentId", "userId", "embedding", "searchableText", "metadata", "createdAt", "updatedAt"
+            )
+            VALUES (gen_random_uuid()::text, $1::{schema_prefix}"ContentType", $2, $3, $4::vector, $5, $6::jsonb, NOW(), NOW())
+            ON CONFLICT ("contentType", "contentId", "userId")
+            DO UPDATE SET
+                "embedding" = $4::vector,
+                "searchableText" = $5,
+                "metadata" = $6::jsonb,
+                "updatedAt" = NOW()
+            WHERE {schema_prefix}"UnifiedContentEmbedding"."contentType" = $1::{schema_prefix}"ContentType"
+                AND {schema_prefix}"UnifiedContentEmbedding"."contentId" = $2
+                AND ({schema_prefix}"UnifiedContentEmbedding"."userId" = $3 OR ($3 IS NULL AND {schema_prefix}"UnifiedContentEmbedding"."userId" IS NULL))
+            """,
+            content_type,
+            content_id,
+            user_id,
+            embedding_str,
+            searchable_text,
+            metadata_json,
+            client=client,
+            set_public_search_path=True,
+        )
+
+        logger.info(f"Stored embedding for {content_type}:{content_id}")
+        return True
+
+    except Exception as e:
+        logger.error(f"Failed to store embedding for {content_type}:{content_id}: {e}")
+        return False
+
+
+async def get_embedding(version_id: str) -> dict[str, Any] | None:
+    """
+    Retrieve embedding record for a listing version.
+
+    BACKWARD COMPATIBILITY: Maintained for existing store listing usage.
+    Returns dict with storeListingVersionId, embedding, timestamps or None if not found.
+    """
+    result = await get_content_embedding(
+        ContentType.STORE_AGENT, version_id, user_id=None
+    )
+    if result:
+        # Transform to old format for backward compatibility
+        return {
+            "storeListingVersionId": result["contentId"],
+            "embedding": result["embedding"],
+            "createdAt": result["createdAt"],
+            "updatedAt": result["updatedAt"],
+        }
+    return None
+
+
+async def get_content_embedding(
+    content_type: ContentType, content_id: str, user_id: str | None = None
+) -> dict[str, Any] | None:
+    """
+    Retrieve embedding record for any content type.
+
+    New function for unified content embedding retrieval.
+    Returns dict with contentType, contentId, embedding, timestamps or None if not found.
+    """
+    try:
+        result = await query_raw_with_schema(
+            """
+            SELECT
+                "contentType",
+                "contentId",
+                "userId",
+                "embedding"::text as "embedding",
+                "searchableText",
+                "metadata",
+                "createdAt",
+                "updatedAt"
+            FROM {schema_prefix}"UnifiedContentEmbedding"
+            WHERE "contentType" = $1::{schema_prefix}"ContentType" AND "contentId" = $2 AND ("userId" = $3 OR ($3 IS NULL AND "userId" IS NULL))
+            """,
+            content_type,
+            content_id,
+            user_id,
+            set_public_search_path=True,
+        )
+
+        if result and len(result) > 0:
+            return result[0]
+        return None
+
+    except Exception as e:
+        logger.error(f"Failed to get embedding for {content_type}:{content_id}: {e}")
+        return None
+
+
+async def ensure_embedding(
+    version_id: str,
+    name: str,
+    description: str,
+    sub_heading: str,
+    categories: list[str],
+    force: bool = False,
+    tx: prisma.Prisma | None = None,
+) -> bool:
+    """
+    Ensure an embedding exists for the listing version.
+
+    Creates embedding if missing. Use force=True to regenerate.
+    Backward-compatible wrapper for store listings.
+
+    Args:
+        version_id: The StoreListingVersion ID
+        name: Agent name
+        description: Agent description
+        sub_heading: Agent sub-heading
+        categories: Agent categories
+        force: Force regeneration even if embedding exists
+        tx: Optional transaction client
+
+    Returns:
+        True if embedding exists/was created, False on failure
+    """
+    try:
+        # Check if embedding already exists
+        if not force:
+            existing = await get_embedding(version_id)
+            if existing and existing.get("embedding"):
+                logger.debug(f"Embedding for version {version_id} already exists")
+                return True
+
+        # Build searchable text for embedding
+        searchable_text = build_searchable_text(
+            name, description, sub_heading, categories
+        )
+
+        # Generate new embedding
+        embedding = await generate_embedding(searchable_text)
+        if embedding is None:
+            logger.warning(f"Could not generate embedding for version {version_id}")
+            return False
+
+        # Store the embedding with metadata using new function
+        metadata = {
+            "name": name,
+            "subHeading": sub_heading,
+            "categories": categories,
+        }
+        return await store_content_embedding(
+            content_type=ContentType.STORE_AGENT,
+            content_id=version_id,
+            embedding=embedding,
+            searchable_text=searchable_text,
+            metadata=metadata,
+            user_id=None,  # Store agents are public
+            tx=tx,
+        )
+
+    except Exception as e:
+        logger.error(f"Failed to ensure embedding for version {version_id}: {e}")
+        return False
+
+
+async def delete_embedding(version_id: str) -> bool:
+    """
+    Delete embedding for a listing version.
+
+    BACKWARD COMPATIBILITY: Maintained for existing store listing usage.
+    Note: This is usually handled automatically by CASCADE delete,
+    but provided for manual cleanup if needed.
+    """
+    return await delete_content_embedding(ContentType.STORE_AGENT, version_id)
+
+
+async def delete_content_embedding(
+    content_type: ContentType, content_id: str, user_id: str | None = None
+) -> bool:
+    """
+    Delete embedding for any content type.
+
+    New function for unified content embedding deletion.
+    Note: This is usually handled automatically by CASCADE delete,
+    but provided for manual cleanup if needed.
+
+    Args:
+        content_type: The type of content (STORE_AGENT, LIBRARY_AGENT, etc.)
+        content_id: The unique identifier for the content
+        user_id: Optional user ID. For public content (STORE_AGENT, BLOCK), pass None.
+                 For user-scoped content (LIBRARY_AGENT), pass the user's ID to avoid
+                 deleting embeddings belonging to other users.
+
+    Returns:
+        True if deletion succeeded, False otherwise
+    """
+    try:
+        client = prisma.get_client()
+
+        await execute_raw_with_schema(
+            """
+            DELETE FROM {schema_prefix}"UnifiedContentEmbedding"
+            WHERE "contentType" = $1::{schema_prefix}"ContentType"
+              AND "contentId" = $2
+              AND ("userId" = $3 OR ($3 IS NULL AND "userId" IS NULL))
+            """,
+            content_type,
+            content_id,
+            user_id,
+            client=client,
+        )
+
+        user_str = f" (user: {user_id})" if user_id else ""
+        logger.info(f"Deleted embedding for {content_type}:{content_id}{user_str}")
+        return True
+
+    except Exception as e:
+        logger.error(f"Failed to delete embedding for {content_type}:{content_id}: {e}")
+        return False
+
+
+async def get_embedding_stats() -> dict[str, Any]:
+    """
+    Get statistics about embedding coverage for all content types.
+
+    Returns stats per content type and overall totals.
+    """
+    try:
+        stats_by_type = {}
+        total_items = 0
+        total_with_embeddings = 0
+        total_without_embeddings = 0
+
+        # Aggregate stats from all handlers
+        for content_type, handler in CONTENT_HANDLERS.items():
+            try:
+                stats = await handler.get_stats()
+                stats_by_type[content_type.value] = {
+                    "total": stats["total"],
+                    "with_embeddings": stats["with_embeddings"],
+                    "without_embeddings": stats["without_embeddings"],
+                    "coverage_percent": (
+                        round(stats["with_embeddings"] / stats["total"] * 100, 1)
+                        if stats["total"] > 0
+                        else 0
+                    ),
+                }
+
+                total_items += stats["total"]
+                total_with_embeddings += stats["with_embeddings"]
+                total_without_embeddings += stats["without_embeddings"]
+
+            except Exception as e:
+                logger.error(f"Failed to get stats for {content_type.value}: {e}")
+                stats_by_type[content_type.value] = {
+                    "total": 0,
+                    "with_embeddings": 0,
+                    "without_embeddings": 0,
+                    "coverage_percent": 0,
+                    "error": str(e),
+                }
+
+        return {
+            "by_type": stats_by_type,
+            "totals": {
+                "total": total_items,
+                "with_embeddings": total_with_embeddings,
+                "without_embeddings": total_without_embeddings,
+                "coverage_percent": (
+                    round(total_with_embeddings / total_items * 100, 1)
+                    if total_items > 0
+                    else 0
+                ),
+            },
+        }
+
+    except Exception as e:
+        logger.error(f"Failed to get embedding stats: {e}")
+        return {
+            "by_type": {},
+            "totals": {
+                "total": 0,
+                "with_embeddings": 0,
+                "without_embeddings": 0,
+                "coverage_percent": 0,
+            },
+            "error": str(e),
+        }
+
+
+async def backfill_missing_embeddings(batch_size: int = 10) -> dict[str, Any]:
+    """
+    Generate embeddings for approved listings that don't have them.
+
+    BACKWARD COMPATIBILITY: Maintained for existing usage.
+    This now delegates to backfill_all_content_types() to process all content types.
+
+    Args:
+        batch_size: Number of embeddings to generate per content type
+
+    Returns:
+        Dict with success/failure counts aggregated across all content types
+    """
+    # Delegate to the new generic backfill system
+    result = await backfill_all_content_types(batch_size)
+
+    # Return in the old format for backward compatibility
+    return result["totals"]
+
+
+async def backfill_all_content_types(batch_size: int = 10) -> dict[str, Any]:
+    """
+    Generate embeddings for all content types using registered handlers.
+
+    Processes content types in order: BLOCK → STORE_AGENT → DOCUMENTATION.
+    This ensures foundational content (blocks) are searchable first.
+
+    Args:
+        batch_size: Number of embeddings to generate per content type
+
+    Returns:
+        Dict with stats per content type and overall totals
+    """
+    results_by_type = {}
+    total_processed = 0
+    total_success = 0
+    total_failed = 0
+
+    # Process content types in explicit order
+    processing_order = [
+        ContentType.BLOCK,
+        ContentType.STORE_AGENT,
+        ContentType.DOCUMENTATION,
+    ]
+
+    for content_type in processing_order:
+        handler = CONTENT_HANDLERS.get(content_type)
+        if not handler:
+            logger.warning(f"No handler registered for {content_type.value}")
+            continue
+        try:
+            logger.info(f"Processing {content_type.value} content type...")
+
+            # Get missing items from handler
+            missing_items = await handler.get_missing_items(batch_size)
+
+            if not missing_items:
+                results_by_type[content_type.value] = {
+                    "processed": 0,
+                    "success": 0,
+                    "failed": 0,
+                    "message": "No missing embeddings",
+                }
+                continue
+
+            # Process embeddings concurrently for better performance
+            embedding_tasks = [
+                ensure_content_embedding(
+                    content_type=item.content_type,
+                    content_id=item.content_id,
+                    searchable_text=item.searchable_text,
+                    metadata=item.metadata,
+                    user_id=item.user_id,
+                )
+                for item in missing_items
+            ]
+
+            results = await asyncio.gather(*embedding_tasks, return_exceptions=True)
+
+            success = sum(1 for result in results if result is True)
+            failed = len(results) - success
+
+            results_by_type[content_type.value] = {
+                "processed": len(missing_items),
+                "success": success,
+                "failed": failed,
+                "message": f"Backfilled {success} embeddings, {failed} failed",
+            }
+
+            total_processed += len(missing_items)
+            total_success += success
+            total_failed += failed
+
+            logger.info(
+                f"{content_type.value}: processed {len(missing_items)}, "
+                f"success {success}, failed {failed}"
+            )
+
+        except Exception as e:
+            logger.error(f"Failed to process {content_type.value}: {e}")
+            results_by_type[content_type.value] = {
+                "processed": 0,
+                "success": 0,
+                "failed": 0,
+                "error": str(e),
+            }
+
+    return {
+        "by_type": results_by_type,
+        "totals": {
+            "processed": total_processed,
+            "success": total_success,
+            "failed": total_failed,
+            "message": f"Overall: {total_success} succeeded, {total_failed} failed",
+        },
+    }
+
+
+async def embed_query(query: str) -> list[float] | None:
+    """
+    Generate embedding for a search query.
+
+    Same as generate_embedding but with clearer intent.
+    """
+    return await generate_embedding(query)
+
+
+def embedding_to_vector_string(embedding: list[float]) -> str:
+    """Convert embedding list to PostgreSQL vector string format."""
+    return "[" + ",".join(str(x) for x in embedding) + "]"
+
+
+async def ensure_content_embedding(
+    content_type: ContentType,
+    content_id: str,
+    searchable_text: str,
+    metadata: dict | None = None,
+    user_id: str | None = None,
+    force: bool = False,
+    tx: prisma.Prisma | None = None,
+) -> bool:
+    """
+    Ensure an embedding exists for any content type.
+
+    Generic function for creating embeddings for store agents, blocks, docs, etc.
+
+    Args:
+        content_type: ContentType enum value (STORE_AGENT, BLOCK, etc.)
+        content_id: Unique identifier for the content
+        searchable_text: Combined text for embedding generation
+        metadata: Optional metadata to store with embedding
+        force: Force regeneration even if embedding exists
+        tx: Optional transaction client
+
+    Returns:
+        True if embedding exists/was created, False on failure
+    """
+    try:
+        # Check if embedding already exists
+        if not force:
+            existing = await get_content_embedding(content_type, content_id, user_id)
+            if existing and existing.get("embedding"):
+                logger.debug(
+                    f"Embedding for {content_type}:{content_id} already exists"
+                )
+                return True
+
+        # Generate new embedding
+        embedding = await generate_embedding(searchable_text)
+        if embedding is None:
+            logger.warning(
+                f"Could not generate embedding for {content_type}:{content_id}"
+            )
+            return False
+
+        # Store the embedding
+        return await store_content_embedding(
+            content_type=content_type,
+            content_id=content_id,
+            embedding=embedding,
+            searchable_text=searchable_text,
+            metadata=metadata or {},
+            user_id=user_id,
+            tx=tx,
+        )
+
+    except Exception as e:
+        logger.error(f"Failed to ensure embedding for {content_type}:{content_id}: {e}")
+        return False
+
+
+async def cleanup_orphaned_embeddings() -> dict[str, Any]:
+    """
+    Clean up embeddings for content that no longer exists or is no longer valid.
+
+    Compares current content with embeddings in database and removes orphaned records:
+    - STORE_AGENT: Removes embeddings for rejected/deleted store listings
+    - BLOCK: Removes embeddings for blocks no longer registered
+    - DOCUMENTATION: Removes embeddings for deleted doc files
+
+    Returns:
+        Dict with cleanup statistics per content type
+    """
+    results_by_type = {}
+    total_deleted = 0
+
+    # Cleanup orphaned embeddings for all content types
+    cleanup_types = [
+        ContentType.STORE_AGENT,
+        ContentType.BLOCK,
+        ContentType.DOCUMENTATION,
+    ]
+
+    for content_type in cleanup_types:
+        try:
+            handler = CONTENT_HANDLERS.get(content_type)
+            if not handler:
+                logger.warning(f"No handler registered for {content_type}")
+                results_by_type[content_type.value] = {
+                    "deleted": 0,
+                    "error": "No handler registered",
+                }
+                continue
+
+            # Get all current content IDs from handler
+            if content_type == ContentType.STORE_AGENT:
+                # Get IDs of approved store listing versions from non-deleted listings
+                valid_agents = await query_raw_with_schema(
+                    """
+                    SELECT slv.id
+                    FROM {schema_prefix}"StoreListingVersion" slv
+                    JOIN {schema_prefix}"StoreListing" sl ON slv."storeListingId" = sl.id
+                    WHERE slv."submissionStatus" = 'APPROVED'
+                      AND slv."isDeleted" = false
+                      AND sl."isDeleted" = false
+                    """,
+                )
+                current_ids = {row["id"] for row in valid_agents}
+            elif content_type == ContentType.BLOCK:
+                from backend.data.block import get_blocks
+
+                current_ids = set(get_blocks().keys())
+            elif content_type == ContentType.DOCUMENTATION:
+                # Use DocumentationHandler to get section-based content IDs
+                from backend.api.features.store.content_handlers import (
+                    DocumentationHandler,
+                )
+
+                doc_handler = CONTENT_HANDLERS.get(ContentType.DOCUMENTATION)
+                if isinstance(doc_handler, DocumentationHandler):
+                    docs_root = doc_handler._get_docs_root()
+                    if docs_root.exists():
+                        current_ids = doc_handler._get_all_section_content_ids(
+                            docs_root
+                        )
+                    else:
+                        current_ids = set()
+                else:
+                    current_ids = set()
+            else:
+                # Skip unknown content types to avoid accidental deletion
+                logger.warning(
+                    f"Skipping cleanup for unknown content type: {content_type}"
+                )
+                results_by_type[content_type.value] = {
+                    "deleted": 0,
+                    "error": "Unknown content type - skipped for safety",
+                }
+                continue
+
+            # Get all embedding IDs from database
+            db_embeddings = await query_raw_with_schema(
+                """
+                SELECT "contentId"
+                FROM {schema_prefix}"UnifiedContentEmbedding"
+                WHERE "contentType" = $1::{schema_prefix}"ContentType"
+                """,
+                content_type,
+            )
+
+            db_ids = {row["contentId"] for row in db_embeddings}
+
+            # Find orphaned embeddings (in DB but not in current content)
+            orphaned_ids = db_ids - current_ids
+
+            if not orphaned_ids:
+                logger.info(f"{content_type.value}: No orphaned embeddings found")
+                results_by_type[content_type.value] = {
+                    "deleted": 0,
+                    "message": "No orphaned embeddings",
+                }
+                continue
+
+            # Delete orphaned embeddings in batch for better performance
+            orphaned_list = list(orphaned_ids)
+            try:
+                await execute_raw_with_schema(
+                    """
+                    DELETE FROM {schema_prefix}"UnifiedContentEmbedding"
+                    WHERE "contentType" = $1::{schema_prefix}"ContentType"
+                      AND "contentId" = ANY($2::text[])
+                    """,
+                    content_type,
+                    orphaned_list,
+                )
+                deleted = len(orphaned_list)
+            except Exception as e:
+                logger.error(f"Failed to batch delete orphaned embeddings: {e}")
+                deleted = 0
+
+            logger.info(
+                f"{content_type.value}: Deleted {deleted}/{len(orphaned_ids)} orphaned embeddings"
+            )
+            results_by_type[content_type.value] = {
+                "deleted": deleted,
+                "orphaned": len(orphaned_ids),
+                "message": f"Deleted {deleted} orphaned embeddings",
+            }
+
+            total_deleted += deleted
+
+        except Exception as e:
+            logger.error(f"Failed to cleanup {content_type.value}: {e}")
+            results_by_type[content_type.value] = {
+                "deleted": 0,
+                "error": str(e),
+            }
+
+    return {
+        "by_type": results_by_type,
+        "totals": {
+            "deleted": total_deleted,
+            "message": f"Deleted {total_deleted} orphaned embeddings",
+        },
+    }
+
+
+async def semantic_search(
+    query: str,
+    content_types: list[ContentType] | None = None,
+    user_id: str | None = None,
+    limit: int = 20,
+    min_similarity: float = 0.5,
+) -> list[dict[str, Any]]:
+    """
+    Semantic search across content types using embeddings.
+
+    Performs vector similarity search on UnifiedContentEmbedding table.
+    Used directly for blocks/docs/library agents, or as the semantic component
+    within hybrid_search for store agents.
+
+    If embedding generation fails, falls back to lexical search on searchableText.
+
+    Args:
+        query: Search query string
+        content_types: List of ContentType to search. Defaults to [BLOCK, STORE_AGENT, DOCUMENTATION]
+        user_id: Optional user ID for searching private content (library agents)
+        limit: Maximum number of results to return (default: 20)
+        min_similarity: Minimum cosine similarity threshold (0-1, default: 0.5)
+
+    Returns:
+        List of search results with the following structure:
+        [
+            {
+                "content_id": str,
+                "content_type": str,  # "BLOCK", "STORE_AGENT", "DOCUMENTATION", or "LIBRARY_AGENT"
+                "searchable_text": str,
+                "metadata": dict,
+                "similarity": float,  # Cosine similarity score (0-1)
+            },
+            ...
+        ]
+
+    Examples:
+        # Search blocks only
+        results = await semantic_search("calculate", content_types=[ContentType.BLOCK])
+
+        # Search blocks and documentation
+        results = await semantic_search(
+            "how to use API",
+            content_types=[ContentType.BLOCK, ContentType.DOCUMENTATION]
+        )
+
+        # Search all public content (default)
+        results = await semantic_search("AI agent")
+
+        # Search user's library agents
+        results = await semantic_search(
+            "my custom agent",
+            content_types=[ContentType.LIBRARY_AGENT],
+            user_id="user123"
+        )
+    """
+    # Default to searching all public content types
+    if content_types is None:
+        content_types = [
+            ContentType.BLOCK,
+            ContentType.STORE_AGENT,
+            ContentType.DOCUMENTATION,
+        ]
+
+    # Validate inputs
+    if not content_types:
+        return []  # Empty content_types would cause invalid SQL (IN ())
+
+    query = query.strip()
+    if not query:
+        return []
+
+    if limit < 1:
+        limit = 1
+    if limit > 100:
+        limit = 100
+
+    # Generate query embedding
+    query_embedding = await embed_query(query)
+
+    if query_embedding is not None:
+        # Semantic search with embeddings
+        embedding_str = embedding_to_vector_string(query_embedding)
+
+        # Build params in order: limit, then user_id (if provided), then content types
+        params: list[Any] = [limit]
+        user_filter = ""
+        if user_id is not None:
+            user_filter = 'AND "userId" = ${}'.format(len(params) + 1)
+            params.append(user_id)
+
+        # Add content type parameters and build placeholders dynamically
+        content_type_start_idx = len(params) + 1
+        content_type_placeholders = ", ".join(
+            f'${content_type_start_idx + i}::{{{{schema_prefix}}}}"ContentType"'
+            for i in range(len(content_types))
+        )
+        params.extend([ct.value for ct in content_types])
+
+        sql = f"""
+            SELECT
+                "contentId" as content_id,
+                "contentType" as content_type,
+                "searchableText" as searchable_text,
+                metadata,
+                1 - (embedding <=> '{embedding_str}'::vector) as similarity
+            FROM {{{{schema_prefix}}}}"UnifiedContentEmbedding"
+            WHERE "contentType" IN ({content_type_placeholders})
+            {user_filter}
+            AND 1 - (embedding <=> '{embedding_str}'::vector) >= ${len(params) + 1}
+            ORDER BY similarity DESC
+            LIMIT $1
+        """
+        params.append(min_similarity)
+
+        try:
+            results = await query_raw_with_schema(
+                sql, *params, set_public_search_path=True
+            )
+            return [
+                {
+                    "content_id": row["content_id"],
+                    "content_type": row["content_type"],
+                    "searchable_text": row["searchable_text"],
+                    "metadata": row["metadata"],
+                    "similarity": float(row["similarity"]),
+                }
+                for row in results
+            ]
+        except Exception as e:
+            logger.error(f"Semantic search failed: {e}")
+            # Fall through to lexical search below
+
+    # Fallback to lexical search if embeddings unavailable
+    logger.warning("Falling back to lexical search (embeddings unavailable)")
+
+    params_lexical: list[Any] = [limit]
+    user_filter = ""
+    if user_id is not None:
+        user_filter = 'AND "userId" = ${}'.format(len(params_lexical) + 1)
+        params_lexical.append(user_id)
+
+    # Add content type parameters and build placeholders dynamically
+    content_type_start_idx = len(params_lexical) + 1
+    content_type_placeholders_lexical = ", ".join(
+        f'${content_type_start_idx + i}::{{{{schema_prefix}}}}"ContentType"'
+        for i in range(len(content_types))
+    )
+    params_lexical.extend([ct.value for ct in content_types])
+
+    sql_lexical = f"""
+        SELECT
+            "contentId" as content_id,
+            "contentType" as content_type,
+            "searchableText" as searchable_text,
+            metadata,
+            0.0 as similarity
+        FROM {{{{schema_prefix}}}}"UnifiedContentEmbedding"
+        WHERE "contentType" IN ({content_type_placeholders_lexical})
+        {user_filter}
+        AND "searchableText" ILIKE ${len(params_lexical) + 1}
+        ORDER BY "updatedAt" DESC
+        LIMIT $1
+    """
+    params_lexical.append(f"%{query}%")
+
+    try:
+        results = await query_raw_with_schema(
+            sql_lexical, *params_lexical, set_public_search_path=True
+        )
+        return [
+            {
+                "content_id": row["content_id"],
+                "content_type": row["content_type"],
+                "searchable_text": row["searchable_text"],
+                "metadata": row["metadata"],
+                "similarity": 0.0,  # Lexical search doesn't provide similarity
+            }
+            for row in results
+        ]
+    except Exception as e:
+        logger.error(f"Lexical search failed: {e}")
+        return []
diff --git a/autogpt_platform/backend/backend/api/features/store/embeddings_e2e_test.py b/autogpt_platform/backend/backend/api/features/store/embeddings_e2e_test.py
new file mode 100644
index 0000000000..bae5b97cd6
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/store/embeddings_e2e_test.py
@@ -0,0 +1,666 @@
+"""
+End-to-end database tests for embeddings and hybrid search.
+
+These tests hit the actual database to verify SQL queries work correctly.
+Tests cover:
+1. Embedding storage (store_content_embedding)
+2. Embedding retrieval (get_content_embedding)
+3. Embedding deletion (delete_content_embedding)
+4. Unified hybrid search across content types
+5. Store agent hybrid search
+"""
+
+import uuid
+from typing import AsyncGenerator
+
+import pytest
+from prisma.enums import ContentType
+
+from backend.api.features.store import embeddings
+from backend.api.features.store.embeddings import EMBEDDING_DIM
+from backend.api.features.store.hybrid_search import (
+    hybrid_search,
+    unified_hybrid_search,
+)
+
+# ============================================================================
+# Test Fixtures
+# ============================================================================
+
+
+@pytest.fixture
+def test_content_id() -> str:
+    """Generate unique content ID for test isolation."""
+    return f"test-content-{uuid.uuid4()}"
+
+
+@pytest.fixture
+def test_user_id() -> str:
+    """Generate unique user ID for test isolation."""
+    return f"test-user-{uuid.uuid4()}"
+
+
+@pytest.fixture
+def mock_embedding() -> list[float]:
+    """Generate a mock embedding vector."""
+    # Create a normalized embedding vector
+    import math
+
+    raw = [float(i % 10) / 10.0 for i in range(EMBEDDING_DIM)]
+    # Normalize to unit length (required for cosine similarity)
+    magnitude = math.sqrt(sum(x * x for x in raw))
+    return [x / magnitude for x in raw]
+
+
+@pytest.fixture
+def similar_embedding() -> list[float]:
+    """Generate an embedding similar to mock_embedding."""
+    import math
+
+    # Similar but slightly different values
+    raw = [float(i % 10) / 10.0 + 0.01 for i in range(EMBEDDING_DIM)]
+    magnitude = math.sqrt(sum(x * x for x in raw))
+    return [x / magnitude for x in raw]
+
+
+@pytest.fixture
+def different_embedding() -> list[float]:
+    """Generate an embedding very different from mock_embedding."""
+    import math
+
+    # Reversed pattern to be maximally different
+    raw = [float((EMBEDDING_DIM - i) % 10) / 10.0 for i in range(EMBEDDING_DIM)]
+    magnitude = math.sqrt(sum(x * x for x in raw))
+    return [x / magnitude for x in raw]
+
+
+@pytest.fixture
+async def cleanup_embeddings(
+    server,
+) -> AsyncGenerator[list[tuple[ContentType, str, str | None]], None]:
+    """
+    Fixture that tracks created embeddings and cleans them up after tests.
+
+    Yields a list to which tests can append (content_type, content_id, user_id) tuples.
+    """
+    created_embeddings: list[tuple[ContentType, str, str | None]] = []
+    yield created_embeddings
+
+    # Cleanup all created embeddings
+    for content_type, content_id, user_id in created_embeddings:
+        try:
+            await embeddings.delete_content_embedding(content_type, content_id, user_id)
+        except Exception:
+            pass  # Ignore cleanup errors
+
+
+# ============================================================================
+# store_content_embedding Tests
+# ============================================================================
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_store_content_embedding_store_agent(
+    server,
+    test_content_id: str,
+    mock_embedding: list[float],
+    cleanup_embeddings: list,
+):
+    """Test storing embedding for STORE_AGENT content type."""
+    # Track for cleanup
+    cleanup_embeddings.append((ContentType.STORE_AGENT, test_content_id, None))
+
+    result = await embeddings.store_content_embedding(
+        content_type=ContentType.STORE_AGENT,
+        content_id=test_content_id,
+        embedding=mock_embedding,
+        searchable_text="AI assistant for productivity tasks",
+        metadata={"name": "Test Agent", "categories": ["productivity"]},
+        user_id=None,  # Store agents are public
+    )
+
+    assert result is True
+
+    # Verify it was stored
+    stored = await embeddings.get_content_embedding(
+        ContentType.STORE_AGENT, test_content_id, user_id=None
+    )
+    assert stored is not None
+    assert stored["contentId"] == test_content_id
+    assert stored["contentType"] == "STORE_AGENT"
+    assert stored["searchableText"] == "AI assistant for productivity tasks"
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_store_content_embedding_block(
+    server,
+    test_content_id: str,
+    mock_embedding: list[float],
+    cleanup_embeddings: list,
+):
+    """Test storing embedding for BLOCK content type."""
+    cleanup_embeddings.append((ContentType.BLOCK, test_content_id, None))
+
+    result = await embeddings.store_content_embedding(
+        content_type=ContentType.BLOCK,
+        content_id=test_content_id,
+        embedding=mock_embedding,
+        searchable_text="HTTP request block for API calls",
+        metadata={"name": "HTTP Request Block"},
+        user_id=None,  # Blocks are public
+    )
+
+    assert result is True
+
+    stored = await embeddings.get_content_embedding(
+        ContentType.BLOCK, test_content_id, user_id=None
+    )
+    assert stored is not None
+    assert stored["contentType"] == "BLOCK"
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_store_content_embedding_documentation(
+    server,
+    test_content_id: str,
+    mock_embedding: list[float],
+    cleanup_embeddings: list,
+):
+    """Test storing embedding for DOCUMENTATION content type."""
+    cleanup_embeddings.append((ContentType.DOCUMENTATION, test_content_id, None))
+
+    result = await embeddings.store_content_embedding(
+        content_type=ContentType.DOCUMENTATION,
+        content_id=test_content_id,
+        embedding=mock_embedding,
+        searchable_text="Getting started guide for AutoGPT platform",
+        metadata={"title": "Getting Started", "url": "/docs/getting-started"},
+        user_id=None,  # Docs are public
+    )
+
+    assert result is True
+
+    stored = await embeddings.get_content_embedding(
+        ContentType.DOCUMENTATION, test_content_id, user_id=None
+    )
+    assert stored is not None
+    assert stored["contentType"] == "DOCUMENTATION"
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_store_content_embedding_upsert(
+    server,
+    test_content_id: str,
+    mock_embedding: list[float],
+    cleanup_embeddings: list,
+):
+    """Test that storing embedding twice updates instead of duplicates."""
+    cleanup_embeddings.append((ContentType.BLOCK, test_content_id, None))
+
+    # Store first time
+    result1 = await embeddings.store_content_embedding(
+        content_type=ContentType.BLOCK,
+        content_id=test_content_id,
+        embedding=mock_embedding,
+        searchable_text="Original text",
+        metadata={"version": 1},
+        user_id=None,
+    )
+    assert result1 is True
+
+    # Store again with different text (upsert)
+    result2 = await embeddings.store_content_embedding(
+        content_type=ContentType.BLOCK,
+        content_id=test_content_id,
+        embedding=mock_embedding,
+        searchable_text="Updated text",
+        metadata={"version": 2},
+        user_id=None,
+    )
+    assert result2 is True
+
+    # Verify only one record with updated text
+    stored = await embeddings.get_content_embedding(
+        ContentType.BLOCK, test_content_id, user_id=None
+    )
+    assert stored is not None
+    assert stored["searchableText"] == "Updated text"
+
+
+# ============================================================================
+# get_content_embedding Tests
+# ============================================================================
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_get_content_embedding_not_found(server):
+    """Test retrieving non-existent embedding returns None."""
+    result = await embeddings.get_content_embedding(
+        ContentType.STORE_AGENT, "non-existent-id", user_id=None
+    )
+    assert result is None
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_get_content_embedding_with_metadata(
+    server,
+    test_content_id: str,
+    mock_embedding: list[float],
+    cleanup_embeddings: list,
+):
+    """Test that metadata is correctly stored and retrieved."""
+    cleanup_embeddings.append((ContentType.STORE_AGENT, test_content_id, None))
+
+    metadata = {
+        "name": "Test Agent",
+        "subHeading": "A test agent",
+        "categories": ["ai", "productivity"],
+        "customField": 123,
+    }
+
+    await embeddings.store_content_embedding(
+        content_type=ContentType.STORE_AGENT,
+        content_id=test_content_id,
+        embedding=mock_embedding,
+        searchable_text="test",
+        metadata=metadata,
+        user_id=None,
+    )
+
+    stored = await embeddings.get_content_embedding(
+        ContentType.STORE_AGENT, test_content_id, user_id=None
+    )
+
+    assert stored is not None
+    assert stored["metadata"]["name"] == "Test Agent"
+    assert stored["metadata"]["categories"] == ["ai", "productivity"]
+    assert stored["metadata"]["customField"] == 123
+
+
+# ============================================================================
+# delete_content_embedding Tests
+# ============================================================================
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_delete_content_embedding(
+    server,
+    test_content_id: str,
+    mock_embedding: list[float],
+):
+    """Test deleting embedding removes it from database."""
+    # Store embedding
+    await embeddings.store_content_embedding(
+        content_type=ContentType.BLOCK,
+        content_id=test_content_id,
+        embedding=mock_embedding,
+        searchable_text="To be deleted",
+        metadata=None,
+        user_id=None,
+    )
+
+    # Verify it exists
+    stored = await embeddings.get_content_embedding(
+        ContentType.BLOCK, test_content_id, user_id=None
+    )
+    assert stored is not None
+
+    # Delete it
+    result = await embeddings.delete_content_embedding(
+        ContentType.BLOCK, test_content_id, user_id=None
+    )
+    assert result is True
+
+    # Verify it's gone
+    stored = await embeddings.get_content_embedding(
+        ContentType.BLOCK, test_content_id, user_id=None
+    )
+    assert stored is None
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_delete_content_embedding_not_found(server):
+    """Test deleting non-existent embedding doesn't error."""
+    result = await embeddings.delete_content_embedding(
+        ContentType.BLOCK, "non-existent-id", user_id=None
+    )
+    # Should succeed even if nothing to delete
+    assert result is True
+
+
+# ============================================================================
+# unified_hybrid_search Tests
+# ============================================================================
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_unified_hybrid_search_finds_matching_content(
+    server,
+    mock_embedding: list[float],
+    cleanup_embeddings: list,
+):
+    """Test unified search finds content matching the query."""
+    # Create unique content IDs
+    agent_id = f"test-agent-{uuid.uuid4()}"
+    block_id = f"test-block-{uuid.uuid4()}"
+    doc_id = f"test-doc-{uuid.uuid4()}"
+
+    cleanup_embeddings.append((ContentType.STORE_AGENT, agent_id, None))
+    cleanup_embeddings.append((ContentType.BLOCK, block_id, None))
+    cleanup_embeddings.append((ContentType.DOCUMENTATION, doc_id, None))
+
+    # Store embeddings for different content types
+    await embeddings.store_content_embedding(
+        content_type=ContentType.STORE_AGENT,
+        content_id=agent_id,
+        embedding=mock_embedding,
+        searchable_text="AI writing assistant for blog posts",
+        metadata={"name": "Writing Assistant"},
+        user_id=None,
+    )
+
+    await embeddings.store_content_embedding(
+        content_type=ContentType.BLOCK,
+        content_id=block_id,
+        embedding=mock_embedding,
+        searchable_text="Text generation block for creative writing",
+        metadata={"name": "Text Generator"},
+        user_id=None,
+    )
+
+    await embeddings.store_content_embedding(
+        content_type=ContentType.DOCUMENTATION,
+        content_id=doc_id,
+        embedding=mock_embedding,
+        searchable_text="How to use writing blocks in AutoGPT",
+        metadata={"title": "Writing Guide"},
+        user_id=None,
+    )
+
+    # Search for "writing" - should find all three
+    results, total = await unified_hybrid_search(
+        query="writing",
+        page=1,
+        page_size=20,
+    )
+
+    # Should find at least our test content (may find others too)
+    content_ids = [r["content_id"] for r in results]
+    assert agent_id in content_ids or total >= 1  # Lexical search should find it
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_unified_hybrid_search_filter_by_content_type(
+    server,
+    mock_embedding: list[float],
+    cleanup_embeddings: list,
+):
+    """Test unified search can filter by content type."""
+    agent_id = f"test-agent-{uuid.uuid4()}"
+    block_id = f"test-block-{uuid.uuid4()}"
+
+    cleanup_embeddings.append((ContentType.STORE_AGENT, agent_id, None))
+    cleanup_embeddings.append((ContentType.BLOCK, block_id, None))
+
+    # Store both types with same searchable text
+    await embeddings.store_content_embedding(
+        content_type=ContentType.STORE_AGENT,
+        content_id=agent_id,
+        embedding=mock_embedding,
+        searchable_text="unique_search_term_xyz123",
+        metadata={},
+        user_id=None,
+    )
+
+    await embeddings.store_content_embedding(
+        content_type=ContentType.BLOCK,
+        content_id=block_id,
+        embedding=mock_embedding,
+        searchable_text="unique_search_term_xyz123",
+        metadata={},
+        user_id=None,
+    )
+
+    # Search only for BLOCK type
+    results, total = await unified_hybrid_search(
+        query="unique_search_term_xyz123",
+        content_types=[ContentType.BLOCK],
+        page=1,
+        page_size=20,
+    )
+
+    # All results should be BLOCK type
+    for r in results:
+        assert r["content_type"] == "BLOCK"
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_unified_hybrid_search_empty_query(server):
+    """Test unified search with empty query returns empty results."""
+    results, total = await unified_hybrid_search(
+        query="",
+        page=1,
+        page_size=20,
+    )
+
+    assert results == []
+    assert total == 0
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_unified_hybrid_search_pagination(
+    server,
+    mock_embedding: list[float],
+    cleanup_embeddings: list,
+):
+    """Test unified search pagination works correctly."""
+    # Create multiple items
+    content_ids = []
+    for i in range(5):
+        content_id = f"test-pagination-{uuid.uuid4()}"
+        content_ids.append(content_id)
+        cleanup_embeddings.append((ContentType.BLOCK, content_id, None))
+
+        await embeddings.store_content_embedding(
+            content_type=ContentType.BLOCK,
+            content_id=content_id,
+            embedding=mock_embedding,
+            searchable_text=f"pagination test item number {i}",
+            metadata={"index": i},
+            user_id=None,
+        )
+
+    # Get first page
+    page1_results, total1 = await unified_hybrid_search(
+        query="pagination test",
+        content_types=[ContentType.BLOCK],
+        page=1,
+        page_size=2,
+    )
+
+    # Get second page
+    page2_results, total2 = await unified_hybrid_search(
+        query="pagination test",
+        content_types=[ContentType.BLOCK],
+        page=2,
+        page_size=2,
+    )
+
+    # Total should be consistent
+    assert total1 == total2
+
+    # Pages should have different content (if we have enough results)
+    if len(page1_results) > 0 and len(page2_results) > 0:
+        page1_ids = {r["content_id"] for r in page1_results}
+        page2_ids = {r["content_id"] for r in page2_results}
+        # No overlap between pages
+        assert page1_ids.isdisjoint(page2_ids)
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_unified_hybrid_search_min_score_filtering(
+    server,
+    mock_embedding: list[float],
+    cleanup_embeddings: list,
+):
+    """Test unified search respects min_score threshold."""
+    content_id = f"test-minscore-{uuid.uuid4()}"
+    cleanup_embeddings.append((ContentType.BLOCK, content_id, None))
+
+    await embeddings.store_content_embedding(
+        content_type=ContentType.BLOCK,
+        content_id=content_id,
+        embedding=mock_embedding,
+        searchable_text="completely unrelated content about bananas",
+        metadata={},
+        user_id=None,
+    )
+
+    # Search with very high min_score - should filter out low relevance
+    results_high, _ = await unified_hybrid_search(
+        query="quantum computing algorithms",
+        content_types=[ContentType.BLOCK],
+        min_score=0.9,  # Very high threshold
+        page=1,
+        page_size=20,
+    )
+
+    # Search with low min_score
+    results_low, _ = await unified_hybrid_search(
+        query="quantum computing algorithms",
+        content_types=[ContentType.BLOCK],
+        min_score=0.01,  # Very low threshold
+        page=1,
+        page_size=20,
+    )
+
+    # High threshold should have fewer or equal results
+    assert len(results_high) <= len(results_low)
+
+
+# ============================================================================
+# hybrid_search (Store Agents) Tests
+# ============================================================================
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_hybrid_search_store_agents_sql_valid(server):
+    """Test that hybrid_search SQL executes without errors."""
+    # This test verifies the SQL is syntactically correct
+    # even if no results are found
+    results, total = await hybrid_search(
+        query="test agent",
+        page=1,
+        page_size=20,
+    )
+
+    # Should not raise - verifies SQL is valid
+    assert isinstance(results, list)
+    assert isinstance(total, int)
+    assert total >= 0
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_hybrid_search_with_filters(server):
+    """Test hybrid_search with various filter options."""
+    # Test with all filter types
+    results, total = await hybrid_search(
+        query="productivity",
+        featured=True,
+        creators=["test-creator"],
+        category="productivity",
+        page=1,
+        page_size=10,
+    )
+
+    # Should not raise - verifies filter SQL is valid
+    assert isinstance(results, list)
+    assert isinstance(total, int)
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_hybrid_search_pagination(server):
+    """Test hybrid_search pagination."""
+    # Page 1
+    results1, total1 = await hybrid_search(
+        query="agent",
+        page=1,
+        page_size=5,
+    )
+
+    # Page 2
+    results2, total2 = await hybrid_search(
+        query="agent",
+        page=2,
+        page_size=5,
+    )
+
+    # Verify SQL executes without error
+    assert isinstance(results1, list)
+    assert isinstance(results2, list)
+    assert isinstance(total1, int)
+    assert isinstance(total2, int)
+
+    # If page 1 has results, total should be > 0
+    # Note: total from page 2 may be 0 if no results on that page (COUNT(*) OVER limitation)
+    if results1:
+        assert total1 > 0
+
+
+# ============================================================================
+# SQL Validity Tests (verify queries don't break)
+# ============================================================================
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_all_content_types_searchable(server):
+    """Test that all content types can be searched without SQL errors."""
+    for content_type in [
+        ContentType.STORE_AGENT,
+        ContentType.BLOCK,
+        ContentType.DOCUMENTATION,
+    ]:
+        results, total = await unified_hybrid_search(
+            query="test",
+            content_types=[content_type],
+            page=1,
+            page_size=10,
+        )
+
+        # Should not raise
+        assert isinstance(results, list)
+        assert isinstance(total, int)
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_multiple_content_types_searchable(server):
+    """Test searching multiple content types at once."""
+    results, total = await unified_hybrid_search(
+        query="test",
+        content_types=[ContentType.BLOCK, ContentType.DOCUMENTATION],
+        page=1,
+        page_size=20,
+    )
+
+    # Should not raise
+    assert isinstance(results, list)
+    assert isinstance(total, int)
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_search_all_content_types_default(server):
+    """Test searching all content types (default behavior)."""
+    results, total = await unified_hybrid_search(
+        query="test",
+        content_types=None,  # Should search all
+        page=1,
+        page_size=20,
+    )
+
+    # Should not raise
+    assert isinstance(results, list)
+    assert isinstance(total, int)
+
+
+if __name__ == "__main__":
+    pytest.main([__file__, "-v", "-s"])
diff --git a/autogpt_platform/backend/backend/api/features/store/embeddings_schema_test.py b/autogpt_platform/backend/backend/api/features/store/embeddings_schema_test.py
new file mode 100644
index 0000000000..7ba200fda0
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/store/embeddings_schema_test.py
@@ -0,0 +1,315 @@
+"""
+Integration tests for embeddings with schema handling.
+
+These tests verify that embeddings operations work correctly across different database schemas.
+"""
+
+from unittest.mock import AsyncMock, MagicMock, patch
+
+import pytest
+from prisma.enums import ContentType
+
+from backend.api.features.store import embeddings
+from backend.api.features.store.embeddings import EMBEDDING_DIM
+
+# Schema prefix tests removed - functionality moved to db.raw_with_schema() helper
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_store_content_embedding_with_schema():
+    """Test storing embeddings with proper schema handling."""
+    with patch("backend.data.db.get_database_schema") as mock_schema:
+        mock_schema.return_value = "platform"
+
+        with patch("prisma.get_client") as mock_get_client:
+            mock_client = AsyncMock()
+            mock_get_client.return_value = mock_client
+
+            result = await embeddings.store_content_embedding(
+                content_type=ContentType.STORE_AGENT,
+                content_id="test-id",
+                embedding=[0.1] * EMBEDDING_DIM,
+                searchable_text="test text",
+                metadata={"test": "data"},
+                user_id=None,
+            )
+
+            # Verify the query was called
+            assert mock_client.execute_raw.called
+
+            # Get the SQL query that was executed
+            call_args = mock_client.execute_raw.call_args
+            sql_query = call_args[0][0]
+
+            # Verify schema prefix is in the query
+            assert '"platform"."UnifiedContentEmbedding"' in sql_query
+
+            # Verify result
+            assert result is True
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_get_content_embedding_with_schema():
+    """Test retrieving embeddings with proper schema handling."""
+    with patch("backend.data.db.get_database_schema") as mock_schema:
+        mock_schema.return_value = "platform"
+
+        with patch("prisma.get_client") as mock_get_client:
+            mock_client = AsyncMock()
+            mock_client.query_raw.return_value = [
+                {
+                    "contentType": "STORE_AGENT",
+                    "contentId": "test-id",
+                    "userId": None,
+                    "embedding": "[0.1, 0.2]",
+                    "searchableText": "test",
+                    "metadata": {},
+                    "createdAt": "2024-01-01",
+                    "updatedAt": "2024-01-01",
+                }
+            ]
+            mock_get_client.return_value = mock_client
+
+            result = await embeddings.get_content_embedding(
+                ContentType.STORE_AGENT,
+                "test-id",
+                user_id=None,
+            )
+
+            # Verify the query was called
+            assert mock_client.query_raw.called
+
+            # Get the SQL query that was executed
+            call_args = mock_client.query_raw.call_args
+            sql_query = call_args[0][0]
+
+            # Verify schema prefix is in the query
+            assert '"platform"."UnifiedContentEmbedding"' in sql_query
+
+            # Verify result
+            assert result is not None
+            assert result["contentId"] == "test-id"
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_delete_content_embedding_with_schema():
+    """Test deleting embeddings with proper schema handling."""
+    with patch("backend.data.db.get_database_schema") as mock_schema:
+        mock_schema.return_value = "platform"
+
+        with patch("prisma.get_client") as mock_get_client:
+            mock_client = AsyncMock()
+            mock_get_client.return_value = mock_client
+
+            result = await embeddings.delete_content_embedding(
+                ContentType.STORE_AGENT,
+                "test-id",
+            )
+
+            # Verify the query was called
+            assert mock_client.execute_raw.called
+
+            # Get the SQL query that was executed
+            call_args = mock_client.execute_raw.call_args
+            sql_query = call_args[0][0]
+
+            # Verify schema prefix is in the query
+            assert '"platform"."UnifiedContentEmbedding"' in sql_query
+
+            # Verify result
+            assert result is True
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_get_embedding_stats_with_schema():
+    """Test embedding statistics with proper schema handling via content handlers."""
+    # Mock handler to return stats
+    mock_handler = MagicMock()
+    mock_handler.get_stats = AsyncMock(
+        return_value={
+            "total": 100,
+            "with_embeddings": 80,
+            "without_embeddings": 20,
+        }
+    )
+
+    with patch(
+        "backend.api.features.store.embeddings.CONTENT_HANDLERS",
+        {ContentType.STORE_AGENT: mock_handler},
+    ):
+        result = await embeddings.get_embedding_stats()
+
+        # Verify handler was called
+        mock_handler.get_stats.assert_called_once()
+
+        # Verify new result structure
+        assert "by_type" in result
+        assert "totals" in result
+        assert result["totals"]["total"] == 100
+        assert result["totals"]["with_embeddings"] == 80
+        assert result["totals"]["without_embeddings"] == 20
+        assert result["totals"]["coverage_percent"] == 80.0
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_backfill_missing_embeddings_with_schema():
+    """Test backfilling embeddings via content handlers."""
+    from backend.api.features.store.content_handlers import ContentItem
+
+    # Create mock content item
+    mock_item = ContentItem(
+        content_id="version-1",
+        content_type=ContentType.STORE_AGENT,
+        searchable_text="Test Agent Test description",
+        metadata={"name": "Test Agent"},
+    )
+
+    # Mock handler
+    mock_handler = MagicMock()
+    mock_handler.get_missing_items = AsyncMock(return_value=[mock_item])
+
+    with patch(
+        "backend.api.features.store.embeddings.CONTENT_HANDLERS",
+        {ContentType.STORE_AGENT: mock_handler},
+    ):
+        with patch(
+            "backend.api.features.store.embeddings.generate_embedding",
+            return_value=[0.1] * EMBEDDING_DIM,
+        ):
+            with patch(
+                "backend.api.features.store.embeddings.store_content_embedding",
+                return_value=True,
+            ):
+                result = await embeddings.backfill_missing_embeddings(batch_size=10)
+
+                # Verify handler was called
+                mock_handler.get_missing_items.assert_called_once_with(10)
+
+                # Verify results
+                assert result["processed"] == 1
+                assert result["success"] == 1
+                assert result["failed"] == 0
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_ensure_content_embedding_with_schema():
+    """Test ensuring embeddings exist with proper schema handling."""
+    with patch("backend.data.db.get_database_schema") as mock_schema:
+        mock_schema.return_value = "platform"
+
+        with patch(
+            "backend.api.features.store.embeddings.get_content_embedding"
+        ) as mock_get:
+            # Simulate no existing embedding
+            mock_get.return_value = None
+
+            with patch(
+                "backend.api.features.store.embeddings.generate_embedding"
+            ) as mock_generate:
+                mock_generate.return_value = [0.1] * EMBEDDING_DIM
+
+                with patch(
+                    "backend.api.features.store.embeddings.store_content_embedding"
+                ) as mock_store:
+                    mock_store.return_value = True
+
+                    result = await embeddings.ensure_content_embedding(
+                        content_type=ContentType.STORE_AGENT,
+                        content_id="test-id",
+                        searchable_text="test text",
+                        metadata={"test": "data"},
+                        user_id=None,
+                        force=False,
+                    )
+
+                    # Verify the flow
+                    assert mock_get.called
+                    assert mock_generate.called
+                    assert mock_store.called
+                    assert result is True
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_backward_compatibility_store_embedding():
+    """Test backward compatibility wrapper for store_embedding."""
+    with patch(
+        "backend.api.features.store.embeddings.store_content_embedding"
+    ) as mock_store:
+        mock_store.return_value = True
+
+        result = await embeddings.store_embedding(
+            version_id="test-version-id",
+            embedding=[0.1] * EMBEDDING_DIM,
+            tx=None,
+        )
+
+        # Verify it calls the new function with correct parameters
+        assert mock_store.called
+        call_args = mock_store.call_args
+
+        assert call_args[1]["content_type"] == ContentType.STORE_AGENT
+        assert call_args[1]["content_id"] == "test-version-id"
+        assert call_args[1]["user_id"] is None
+        assert result is True
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_backward_compatibility_get_embedding():
+    """Test backward compatibility wrapper for get_embedding."""
+    with patch(
+        "backend.api.features.store.embeddings.get_content_embedding"
+    ) as mock_get:
+        mock_get.return_value = {
+            "contentType": "STORE_AGENT",
+            "contentId": "test-version-id",
+            "embedding": "[0.1, 0.2]",
+            "createdAt": "2024-01-01",
+            "updatedAt": "2024-01-01",
+        }
+
+        result = await embeddings.get_embedding("test-version-id")
+
+        # Verify it calls the new function
+        assert mock_get.called
+
+        # Verify it transforms to old format
+        assert result is not None
+        assert result["storeListingVersionId"] == "test-version-id"
+        assert "embedding" in result
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_schema_handling_error_cases():
+    """Test error handling in schema-aware operations."""
+    with patch("backend.data.db.get_database_schema") as mock_schema:
+        mock_schema.return_value = "platform"
+
+        with patch("prisma.get_client") as mock_get_client:
+            mock_client = AsyncMock()
+            mock_client.execute_raw.side_effect = Exception("Database error")
+            mock_get_client.return_value = mock_client
+
+            result = await embeddings.store_content_embedding(
+                content_type=ContentType.STORE_AGENT,
+                content_id="test-id",
+                embedding=[0.1] * EMBEDDING_DIM,
+                searchable_text="test",
+                metadata=None,
+                user_id=None,
+            )
+
+            # Should return False on error, not raise
+            assert result is False
+
+
+if __name__ == "__main__":
+    pytest.main([__file__, "-v", "-s"])
diff --git a/autogpt_platform/backend/backend/api/features/store/embeddings_test.py b/autogpt_platform/backend/backend/api/features/store/embeddings_test.py
new file mode 100644
index 0000000000..a17e393472
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/store/embeddings_test.py
@@ -0,0 +1,407 @@
+from unittest.mock import AsyncMock, MagicMock, patch
+
+import prisma
+import pytest
+from prisma import Prisma
+from prisma.enums import ContentType
+
+from backend.api.features.store import embeddings
+
+
+@pytest.fixture(autouse=True)
+async def setup_prisma():
+    """Setup Prisma client for tests."""
+    try:
+        Prisma()
+    except prisma.errors.ClientAlreadyRegisteredError:
+        pass
+    yield
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_build_searchable_text():
+    """Test searchable text building from listing fields."""
+    result = embeddings.build_searchable_text(
+        name="AI Assistant",
+        description="A helpful AI assistant for productivity",
+        sub_heading="Boost your productivity",
+        categories=["AI", "Productivity"],
+    )
+
+    expected = "AI Assistant Boost your productivity A helpful AI assistant for productivity AI Productivity"
+    assert result == expected
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_build_searchable_text_empty_fields():
+    """Test searchable text building with empty fields."""
+    result = embeddings.build_searchable_text(
+        name="", description="Test description", sub_heading="", categories=[]
+    )
+
+    assert result == "Test description"
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_generate_embedding_success():
+    """Test successful embedding generation."""
+    # Mock OpenAI response
+    mock_client = MagicMock()
+    mock_response = MagicMock()
+    mock_response.data = [MagicMock()]
+    mock_response.data[0].embedding = [0.1, 0.2, 0.3] * 512  # 1536 dimensions
+
+    # Use AsyncMock for async embeddings.create method
+    mock_client.embeddings.create = AsyncMock(return_value=mock_response)
+
+    # Patch at the point of use in embeddings.py
+    with patch(
+        "backend.api.features.store.embeddings.get_openai_client"
+    ) as mock_get_client:
+        mock_get_client.return_value = mock_client
+
+        result = await embeddings.generate_embedding("test text")
+
+        assert result is not None
+        assert len(result) == embeddings.EMBEDDING_DIM
+        assert result[0] == 0.1
+
+        mock_client.embeddings.create.assert_called_once_with(
+            model="text-embedding-3-small", input="test text"
+        )
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_generate_embedding_no_api_key():
+    """Test embedding generation without API key."""
+    # Patch at the point of use in embeddings.py
+    with patch(
+        "backend.api.features.store.embeddings.get_openai_client"
+    ) as mock_get_client:
+        mock_get_client.return_value = None
+
+        result = await embeddings.generate_embedding("test text")
+
+        assert result is None
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_generate_embedding_api_error():
+    """Test embedding generation with API error."""
+    mock_client = MagicMock()
+    mock_client.embeddings.create = AsyncMock(side_effect=Exception("API Error"))
+
+    # Patch at the point of use in embeddings.py
+    with patch(
+        "backend.api.features.store.embeddings.get_openai_client"
+    ) as mock_get_client:
+        mock_get_client.return_value = mock_client
+
+        result = await embeddings.generate_embedding("test text")
+
+        assert result is None
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_generate_embedding_text_truncation():
+    """Test that long text is properly truncated using tiktoken."""
+    from tiktoken import encoding_for_model
+
+    mock_client = MagicMock()
+    mock_response = MagicMock()
+    mock_response.data = [MagicMock()]
+    mock_response.data[0].embedding = [0.1] * embeddings.EMBEDDING_DIM
+
+    # Use AsyncMock for async embeddings.create method
+    mock_client.embeddings.create = AsyncMock(return_value=mock_response)
+
+    # Patch at the point of use in embeddings.py
+    with patch(
+        "backend.api.features.store.embeddings.get_openai_client"
+    ) as mock_get_client:
+        mock_get_client.return_value = mock_client
+
+        # Create text that will exceed 8191 tokens
+        # Use varied characters to ensure token-heavy text: each word is ~1 token
+        words = [f"word{i}" for i in range(10000)]
+        long_text = " ".join(words)  # ~10000 tokens
+
+        await embeddings.generate_embedding(long_text)
+
+        # Verify text was truncated to 8191 tokens
+        call_args = mock_client.embeddings.create.call_args
+        truncated_text = call_args.kwargs["input"]
+
+        # Count actual tokens in truncated text
+        enc = encoding_for_model("text-embedding-3-small")
+        actual_tokens = len(enc.encode(truncated_text))
+
+        # Should be at or just under 8191 tokens
+        assert actual_tokens <= 8191
+        # Should be close to the limit (not over-truncated)
+        assert actual_tokens >= 8100
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_store_embedding_success(mocker):
+    """Test successful embedding storage."""
+    mock_client = mocker.AsyncMock()
+    mock_client.execute_raw = mocker.AsyncMock()
+
+    embedding = [0.1, 0.2, 0.3]
+
+    result = await embeddings.store_embedding(
+        version_id="test-version-id", embedding=embedding, tx=mock_client
+    )
+
+    assert result is True
+    # execute_raw is called twice: once for SET search_path, once for INSERT
+    assert mock_client.execute_raw.call_count == 2
+
+    # First call: SET search_path
+    first_call_args = mock_client.execute_raw.call_args_list[0][0]
+    assert "SET search_path" in first_call_args[0]
+
+    # Second call: INSERT query with the actual data
+    second_call_args = mock_client.execute_raw.call_args_list[1][0]
+    assert "test-version-id" in second_call_args
+    assert "[0.1,0.2,0.3]" in second_call_args
+    assert None in second_call_args  # userId should be None for store agents
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_store_embedding_database_error(mocker):
+    """Test embedding storage with database error."""
+    mock_client = mocker.AsyncMock()
+    mock_client.execute_raw.side_effect = Exception("Database error")
+
+    embedding = [0.1, 0.2, 0.3]
+
+    result = await embeddings.store_embedding(
+        version_id="test-version-id", embedding=embedding, tx=mock_client
+    )
+
+    assert result is False
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_get_embedding_success():
+    """Test successful embedding retrieval."""
+    mock_result = [
+        {
+            "contentType": "STORE_AGENT",
+            "contentId": "test-version-id",
+            "userId": None,
+            "embedding": "[0.1,0.2,0.3]",
+            "searchableText": "Test text",
+            "metadata": {},
+            "createdAt": "2024-01-01T00:00:00Z",
+            "updatedAt": "2024-01-01T00:00:00Z",
+        }
+    ]
+
+    with patch(
+        "backend.api.features.store.embeddings.query_raw_with_schema",
+        return_value=mock_result,
+    ):
+        result = await embeddings.get_embedding("test-version-id")
+
+        assert result is not None
+        assert result["storeListingVersionId"] == "test-version-id"
+        assert result["embedding"] == "[0.1,0.2,0.3]"
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_get_embedding_not_found():
+    """Test embedding retrieval when not found."""
+    with patch(
+        "backend.api.features.store.embeddings.query_raw_with_schema",
+        return_value=[],
+    ):
+        result = await embeddings.get_embedding("test-version-id")
+
+        assert result is None
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@patch("backend.api.features.store.embeddings.generate_embedding")
+@patch("backend.api.features.store.embeddings.store_embedding")
+@patch("backend.api.features.store.embeddings.get_embedding")
+async def test_ensure_embedding_already_exists(mock_get, mock_store, mock_generate):
+    """Test ensure_embedding when embedding already exists."""
+    mock_get.return_value = {"embedding": "[0.1,0.2,0.3]"}
+
+    result = await embeddings.ensure_embedding(
+        version_id="test-id",
+        name="Test",
+        description="Test description",
+        sub_heading="Test heading",
+        categories=["test"],
+    )
+
+    assert result is True
+    mock_generate.assert_not_called()
+    mock_store.assert_not_called()
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@patch("backend.api.features.store.embeddings.generate_embedding")
+@patch("backend.api.features.store.embeddings.store_content_embedding")
+@patch("backend.api.features.store.embeddings.get_embedding")
+async def test_ensure_embedding_create_new(mock_get, mock_store, mock_generate):
+    """Test ensure_embedding creating new embedding."""
+    mock_get.return_value = None
+    mock_generate.return_value = [0.1, 0.2, 0.3]
+    mock_store.return_value = True
+
+    result = await embeddings.ensure_embedding(
+        version_id="test-id",
+        name="Test",
+        description="Test description",
+        sub_heading="Test heading",
+        categories=["test"],
+    )
+
+    assert result is True
+    mock_generate.assert_called_once_with("Test Test heading Test description test")
+    mock_store.assert_called_once_with(
+        content_type=ContentType.STORE_AGENT,
+        content_id="test-id",
+        embedding=[0.1, 0.2, 0.3],
+        searchable_text="Test Test heading Test description test",
+        metadata={"name": "Test", "subHeading": "Test heading", "categories": ["test"]},
+        user_id=None,
+        tx=None,
+    )
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@patch("backend.api.features.store.embeddings.generate_embedding")
+@patch("backend.api.features.store.embeddings.get_embedding")
+async def test_ensure_embedding_generation_fails(mock_get, mock_generate):
+    """Test ensure_embedding when generation fails."""
+    mock_get.return_value = None
+    mock_generate.return_value = None
+
+    result = await embeddings.ensure_embedding(
+        version_id="test-id",
+        name="Test",
+        description="Test description",
+        sub_heading="Test heading",
+        categories=["test"],
+    )
+
+    assert result is False
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_get_embedding_stats():
+    """Test embedding statistics retrieval."""
+    # Mock handler stats for each content type
+    mock_handler = MagicMock()
+    mock_handler.get_stats = AsyncMock(
+        return_value={
+            "total": 100,
+            "with_embeddings": 75,
+            "without_embeddings": 25,
+        }
+    )
+
+    # Patch the CONTENT_HANDLERS where it's used (in embeddings module)
+    with patch(
+        "backend.api.features.store.embeddings.CONTENT_HANDLERS",
+        {ContentType.STORE_AGENT: mock_handler},
+    ):
+        result = await embeddings.get_embedding_stats()
+
+        assert "by_type" in result
+        assert "totals" in result
+        assert result["totals"]["total"] == 100
+        assert result["totals"]["with_embeddings"] == 75
+        assert result["totals"]["without_embeddings"] == 25
+        assert result["totals"]["coverage_percent"] == 75.0
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@patch("backend.api.features.store.embeddings.store_content_embedding")
+async def test_backfill_missing_embeddings_success(mock_store):
+    """Test backfill with successful embedding generation."""
+    # Mock ContentItem from handlers
+    from backend.api.features.store.content_handlers import ContentItem
+
+    mock_items = [
+        ContentItem(
+            content_id="version-1",
+            content_type=ContentType.STORE_AGENT,
+            searchable_text="Agent 1 Description 1",
+            metadata={"name": "Agent 1"},
+        ),
+        ContentItem(
+            content_id="version-2",
+            content_type=ContentType.STORE_AGENT,
+            searchable_text="Agent 2 Description 2",
+            metadata={"name": "Agent 2"},
+        ),
+    ]
+
+    # Mock handler to return missing items
+    mock_handler = MagicMock()
+    mock_handler.get_missing_items = AsyncMock(return_value=mock_items)
+
+    # Mock store_content_embedding to succeed for first, fail for second
+    mock_store.side_effect = [True, False]
+
+    with patch(
+        "backend.api.features.store.embeddings.CONTENT_HANDLERS",
+        {ContentType.STORE_AGENT: mock_handler},
+    ):
+        with patch(
+            "backend.api.features.store.embeddings.generate_embedding",
+            return_value=[0.1] * embeddings.EMBEDDING_DIM,
+        ):
+            result = await embeddings.backfill_missing_embeddings(batch_size=5)
+
+            assert result["processed"] == 2
+            assert result["success"] == 1
+            assert result["failed"] == 1
+            assert mock_store.call_count == 2
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_backfill_missing_embeddings_no_missing():
+    """Test backfill when no embeddings are missing."""
+    # Mock handler to return no missing items
+    mock_handler = MagicMock()
+    mock_handler.get_missing_items = AsyncMock(return_value=[])
+
+    with patch(
+        "backend.api.features.store.embeddings.CONTENT_HANDLERS",
+        {ContentType.STORE_AGENT: mock_handler},
+    ):
+        result = await embeddings.backfill_missing_embeddings(batch_size=5)
+
+        assert result["processed"] == 0
+        assert result["success"] == 0
+        assert result["failed"] == 0
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_embedding_to_vector_string():
+    """Test embedding to PostgreSQL vector string conversion."""
+    embedding = [0.1, 0.2, 0.3, -0.4]
+    result = embeddings.embedding_to_vector_string(embedding)
+    assert result == "[0.1,0.2,0.3,-0.4]"
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_embed_query():
+    """Test embed_query function (alias for generate_embedding)."""
+    with patch(
+        "backend.api.features.store.embeddings.generate_embedding"
+    ) as mock_generate:
+        mock_generate.return_value = [0.1, 0.2, 0.3]
+
+        result = await embeddings.embed_query("test query")
+
+        assert result == [0.1, 0.2, 0.3]
+        mock_generate.assert_called_once_with("test query")
diff --git a/autogpt_platform/backend/backend/api/features/store/hybrid_search.py b/autogpt_platform/backend/backend/api/features/store/hybrid_search.py
new file mode 100644
index 0000000000..f9c831f93b
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/store/hybrid_search.py
@@ -0,0 +1,727 @@
+"""
+Unified Hybrid Search
+
+Combines semantic (embedding) search with lexical (tsvector) search
+for improved relevance across all content types (agents, blocks, docs).
+Includes BM25 reranking for improved lexical relevance.
+"""
+
+import logging
+import re
+from dataclasses import dataclass
+from typing import Any, Literal
+
+from prisma.enums import ContentType
+from rank_bm25 import BM25Okapi
+
+from backend.api.features.store.embeddings import (
+    EMBEDDING_DIM,
+    embed_query,
+    embedding_to_vector_string,
+)
+from backend.data.db import query_raw_with_schema
+
+logger = logging.getLogger(__name__)
+
+
+# ============================================================================
+# BM25 Reranking
+# ============================================================================
+
+
+def tokenize(text: str) -> list[str]:
+    """Simple tokenizer for BM25 - lowercase and split on non-alphanumeric."""
+    if not text:
+        return []
+    # Lowercase and split on non-alphanumeric characters
+    tokens = re.findall(r"\b\w+\b", text.lower())
+    return tokens
+
+
+def bm25_rerank(
+    query: str,
+    results: list[dict[str, Any]],
+    text_field: str = "searchable_text",
+    bm25_weight: float = 0.3,
+    original_score_field: str = "combined_score",
+) -> list[dict[str, Any]]:
+    """
+    Rerank search results using BM25.
+
+    Combines the original combined_score with BM25 score for improved
+    lexical relevance, especially for exact term matches.
+
+    Args:
+        query: The search query
+        results: List of result dicts with text_field and original_score_field
+        text_field: Field name containing the text to score
+        bm25_weight: Weight for BM25 score (0-1). Original score gets (1 - bm25_weight)
+        original_score_field: Field name containing the original score
+
+    Returns:
+        Results list sorted by combined score (BM25 + original)
+    """
+    if not results or not query:
+        return results
+
+    # Extract texts and tokenize
+    corpus = [tokenize(r.get(text_field, "") or "") for r in results]
+
+    # Handle edge case where all documents are empty
+    if all(len(doc) == 0 for doc in corpus):
+        return results
+
+    # Build BM25 index
+    bm25 = BM25Okapi(corpus)
+
+    # Score query against corpus
+    query_tokens = tokenize(query)
+    if not query_tokens:
+        return results
+
+    bm25_scores = bm25.get_scores(query_tokens)
+
+    # Normalize BM25 scores to 0-1 range
+    max_bm25 = max(bm25_scores) if max(bm25_scores) > 0 else 1.0
+    normalized_bm25 = [s / max_bm25 for s in bm25_scores]
+
+    # Combine scores
+    original_weight = 1.0 - bm25_weight
+    for i, result in enumerate(results):
+        original_score = result.get(original_score_field, 0) or 0
+        result["bm25_score"] = normalized_bm25[i]
+        final_score = (
+            original_weight * original_score + bm25_weight * normalized_bm25[i]
+        )
+        result["final_score"] = final_score
+        result["relevance"] = final_score
+
+    # Sort by relevance descending
+    results.sort(key=lambda x: x.get("relevance", 0), reverse=True)
+
+    return results
+
+
+@dataclass
+class UnifiedSearchWeights:
+    """Weights for unified search (no popularity signal)."""
+
+    semantic: float = 0.40  # Embedding cosine similarity
+    lexical: float = 0.40  # tsvector ts_rank_cd score
+    category: float = 0.10  # Category match boost (for types that have categories)
+    recency: float = 0.10  # Newer content ranked higher
+
+    def __post_init__(self):
+        """Validate weights are non-negative and sum to approximately 1.0."""
+        total = self.semantic + self.lexical + self.category + self.recency
+
+        if any(
+            w < 0 for w in [self.semantic, self.lexical, self.category, self.recency]
+        ):
+            raise ValueError("All weights must be non-negative")
+
+        if not (0.99 <= total <= 1.01):
+            raise ValueError(f"Weights must sum to ~1.0, got {total:.3f}")
+
+
+# Default weights for unified search
+DEFAULT_UNIFIED_WEIGHTS = UnifiedSearchWeights()
+
+# Minimum relevance score thresholds
+DEFAULT_MIN_SCORE = 0.15  # For unified search (more permissive)
+DEFAULT_STORE_AGENT_MIN_SCORE = 0.20  # For store agent search (original threshold)
+
+
+async def unified_hybrid_search(
+    query: str,
+    content_types: list[ContentType] | None = None,
+    category: str | None = None,
+    page: int = 1,
+    page_size: int = 20,
+    weights: UnifiedSearchWeights | None = None,
+    min_score: float | None = None,
+    user_id: str | None = None,
+) -> tuple[list[dict[str, Any]], int]:
+    """
+    Unified hybrid search across all content types.
+
+    Searches UnifiedContentEmbedding using both semantic (vector) and lexical (tsvector) signals.
+
+    Args:
+        query: Search query string
+        content_types: List of content types to search. Defaults to all public types.
+        category: Filter by category (for content types that support it)
+        page: Page number (1-indexed)
+        page_size: Results per page
+        weights: Custom weights for search signals
+        min_score: Minimum relevance score threshold (0-1)
+        user_id: User ID for searching private content (library agents)
+
+    Returns:
+        Tuple of (results list, total count)
+    """
+    # Validate inputs
+    query = query.strip()
+    if not query:
+        return [], 0
+
+    if page < 1:
+        page = 1
+    if page_size < 1:
+        page_size = 1
+    if page_size > 100:
+        page_size = 100
+
+    if content_types is None:
+        content_types = [
+            ContentType.STORE_AGENT,
+            ContentType.BLOCK,
+            ContentType.DOCUMENTATION,
+        ]
+
+    if weights is None:
+        weights = DEFAULT_UNIFIED_WEIGHTS
+    if min_score is None:
+        min_score = DEFAULT_MIN_SCORE
+
+    offset = (page - 1) * page_size
+
+    # Generate query embedding
+    query_embedding = await embed_query(query)
+
+    # Graceful degradation if embedding unavailable
+    if query_embedding is None or not query_embedding:
+        logger.warning(
+            "Failed to generate query embedding - falling back to lexical-only search. "
+            "Check that openai_internal_api_key is configured and OpenAI API is accessible."
+        )
+        query_embedding = [0.0] * EMBEDDING_DIM
+        # Redistribute semantic weight to lexical
+        total_non_semantic = weights.lexical + weights.category + weights.recency
+        if total_non_semantic > 0:
+            factor = 1.0 / total_non_semantic
+            weights = UnifiedSearchWeights(
+                semantic=0.0,
+                lexical=weights.lexical * factor,
+                category=weights.category * factor,
+                recency=weights.recency * factor,
+            )
+        else:
+            weights = UnifiedSearchWeights(
+                semantic=0.0, lexical=1.0, category=0.0, recency=0.0
+            )
+
+    # Build parameters
+    params: list[Any] = []
+    param_idx = 1
+
+    # Query for lexical search
+    params.append(query)
+    query_param = f"${param_idx}"
+    param_idx += 1
+
+    # Query lowercase for category matching
+    params.append(query.lower())
+    query_lower_param = f"${param_idx}"
+    param_idx += 1
+
+    # Embedding
+    embedding_str = embedding_to_vector_string(query_embedding)
+    params.append(embedding_str)
+    embedding_param = f"${param_idx}"
+    param_idx += 1
+
+    # Content types
+    content_type_values = [ct.value for ct in content_types]
+    params.append(content_type_values)
+    content_types_param = f"${param_idx}"
+    param_idx += 1
+
+    # User ID filter (for private content)
+    user_filter = ""
+    if user_id is not None:
+        params.append(user_id)
+        user_filter = f'AND (uce."userId" = ${param_idx} OR uce."userId" IS NULL)'
+        param_idx += 1
+    else:
+        user_filter = 'AND uce."userId" IS NULL'
+
+    # Weights
+    params.append(weights.semantic)
+    w_semantic = f"${param_idx}"
+    param_idx += 1
+
+    params.append(weights.lexical)
+    w_lexical = f"${param_idx}"
+    param_idx += 1
+
+    params.append(weights.category)
+    w_category = f"${param_idx}"
+    param_idx += 1
+
+    params.append(weights.recency)
+    w_recency = f"${param_idx}"
+    param_idx += 1
+
+    # Min score
+    params.append(min_score)
+    min_score_param = f"${param_idx}"
+    param_idx += 1
+
+    # Pagination
+    params.append(page_size)
+    limit_param = f"${param_idx}"
+    param_idx += 1
+
+    params.append(offset)
+    offset_param = f"${param_idx}"
+    param_idx += 1
+
+    # Unified search query on UnifiedContentEmbedding
+    sql_query = f"""
+        WITH candidates AS (
+            -- Lexical matches (uses GIN index on search column)
+            SELECT uce.id, uce."contentType", uce."contentId"
+            FROM {{schema_prefix}}"UnifiedContentEmbedding" uce
+            WHERE uce."contentType" = ANY({content_types_param}::{{schema_prefix}}"ContentType"[])
+            {user_filter}
+            AND uce.search @@ plainto_tsquery('english', {query_param})
+
+            UNION
+
+            -- Semantic matches (uses HNSW index on embedding)
+            (
+                SELECT uce.id, uce."contentType", uce."contentId"
+                FROM {{schema_prefix}}"UnifiedContentEmbedding" uce
+                WHERE uce."contentType" = ANY({content_types_param}::{{schema_prefix}}"ContentType"[])
+                {user_filter}
+                ORDER BY uce.embedding <=> {embedding_param}::vector
+                LIMIT 200
+            )
+        ),
+        search_scores AS (
+            SELECT
+                uce."contentType" as content_type,
+                uce."contentId" as content_id,
+                uce."searchableText" as searchable_text,
+                uce.metadata,
+                uce."updatedAt" as updated_at,
+                -- Semantic score: cosine similarity (1 - distance)
+                COALESCE(1 - (uce.embedding <=> {embedding_param}::vector), 0) as semantic_score,
+                -- Lexical score: ts_rank_cd
+                COALESCE(ts_rank_cd(uce.search, plainto_tsquery('english', {query_param})), 0) as lexical_raw,
+                -- Category match from metadata
+                CASE
+                    WHEN uce.metadata ? 'categories' AND EXISTS (
+                        SELECT 1 FROM jsonb_array_elements_text(uce.metadata->'categories') cat
+                        WHERE LOWER(cat) LIKE '%' || {query_lower_param} || '%'
+                    )
+                    THEN 1.0
+                    ELSE 0.0
+                END as category_score,
+                -- Recency score: linear decay over 90 days
+                GREATEST(0, 1 - EXTRACT(EPOCH FROM (NOW() - uce."updatedAt")) / (90 * 24 * 3600)) as recency_score
+            FROM candidates c
+            INNER JOIN {{schema_prefix}}"UnifiedContentEmbedding" uce ON c.id = uce.id
+        ),
+        max_lexical AS (
+            SELECT GREATEST(MAX(lexical_raw), 0.001) as max_val FROM search_scores
+        ),
+        normalized AS (
+            SELECT
+                ss.*,
+                ss.lexical_raw / ml.max_val as lexical_score
+            FROM search_scores ss
+            CROSS JOIN max_lexical ml
+        ),
+        scored AS (
+            SELECT
+                content_type,
+                content_id,
+                searchable_text,
+                metadata,
+                updated_at,
+                semantic_score,
+                lexical_score,
+                category_score,
+                recency_score,
+                (
+                    {w_semantic} * semantic_score +
+                    {w_lexical} * lexical_score +
+                    {w_category} * category_score +
+                    {w_recency} * recency_score
+                ) as combined_score
+            FROM normalized
+        ),
+        filtered AS (
+            SELECT *, COUNT(*) OVER () as total_count
+            FROM scored
+            WHERE combined_score >= {min_score_param}
+        )
+        SELECT * FROM filtered
+        ORDER BY combined_score DESC
+        LIMIT {limit_param} OFFSET {offset_param}
+    """
+
+    results = await query_raw_with_schema(
+        sql_query, *params, set_public_search_path=True
+    )
+
+    total = results[0]["total_count"] if results else 0
+    # Apply BM25 reranking
+    if results:
+        results = bm25_rerank(
+            query=query,
+            results=results,
+            text_field="searchable_text",
+            bm25_weight=0.3,
+            original_score_field="combined_score",
+        )
+
+    # Clean up results
+    for result in results:
+        result.pop("total_count", None)
+
+    logger.info(f"Unified hybrid search: {len(results)} results, {total} total")
+
+    return results, total
+
+
+# ============================================================================
+# Store Agent specific search (with full metadata)
+# ============================================================================
+
+
+@dataclass
+class StoreAgentSearchWeights:
+    """Weights for store agent search including popularity."""
+
+    semantic: float = 0.30
+    lexical: float = 0.30
+    category: float = 0.20
+    recency: float = 0.10
+    popularity: float = 0.10
+
+    def __post_init__(self):
+        total = (
+            self.semantic
+            + self.lexical
+            + self.category
+            + self.recency
+            + self.popularity
+        )
+        if any(
+            w < 0
+            for w in [
+                self.semantic,
+                self.lexical,
+                self.category,
+                self.recency,
+                self.popularity,
+            ]
+        ):
+            raise ValueError("All weights must be non-negative")
+        if not (0.99 <= total <= 1.01):
+            raise ValueError(f"Weights must sum to ~1.0, got {total:.3f}")
+
+
+DEFAULT_STORE_AGENT_WEIGHTS = StoreAgentSearchWeights()
+
+
+async def hybrid_search(
+    query: str,
+    featured: bool = False,
+    creators: list[str] | None = None,
+    category: str | None = None,
+    sorted_by: (
+        Literal["relevance", "rating", "runs", "name", "updated_at"] | None
+    ) = None,
+    page: int = 1,
+    page_size: int = 20,
+    weights: StoreAgentSearchWeights | None = None,
+    min_score: float | None = None,
+) -> tuple[list[dict[str, Any]], int]:
+    """
+    Hybrid search for store agents with full metadata.
+
+    Uses UnifiedContentEmbedding for search, joins to StoreAgent for metadata.
+    """
+    query = query.strip()
+    if not query:
+        return [], 0
+
+    if page < 1:
+        page = 1
+    if page_size < 1:
+        page_size = 1
+    if page_size > 100:
+        page_size = 100
+
+    if weights is None:
+        weights = DEFAULT_STORE_AGENT_WEIGHTS
+    if min_score is None:
+        min_score = (
+            DEFAULT_STORE_AGENT_MIN_SCORE  # Use original threshold for store agents
+        )
+
+    offset = (page - 1) * page_size
+
+    # Generate query embedding
+    query_embedding = await embed_query(query)
+
+    # Graceful degradation
+    if query_embedding is None or not query_embedding:
+        logger.warning(
+            "Failed to generate query embedding - falling back to lexical-only search."
+        )
+        query_embedding = [0.0] * EMBEDDING_DIM
+        total_non_semantic = (
+            weights.lexical + weights.category + weights.recency + weights.popularity
+        )
+        if total_non_semantic > 0:
+            factor = 1.0 / total_non_semantic
+            weights = StoreAgentSearchWeights(
+                semantic=0.0,
+                lexical=weights.lexical * factor,
+                category=weights.category * factor,
+                recency=weights.recency * factor,
+                popularity=weights.popularity * factor,
+            )
+        else:
+            weights = StoreAgentSearchWeights(
+                semantic=0.0, lexical=1.0, category=0.0, recency=0.0, popularity=0.0
+            )
+
+    # Build parameters
+    params: list[Any] = []
+    param_idx = 1
+
+    params.append(query)
+    query_param = f"${param_idx}"
+    param_idx += 1
+
+    params.append(query.lower())
+    query_lower_param = f"${param_idx}"
+    param_idx += 1
+
+    embedding_str = embedding_to_vector_string(query_embedding)
+    params.append(embedding_str)
+    embedding_param = f"${param_idx}"
+    param_idx += 1
+
+    # Build WHERE clause for StoreAgent filters
+    where_parts = ["sa.is_available = true"]
+
+    if featured:
+        where_parts.append("sa.featured = true")
+
+    if creators:
+        params.append(creators)
+        where_parts.append(f"sa.creator_username = ANY(${param_idx})")
+        param_idx += 1
+
+    if category:
+        params.append(category)
+        where_parts.append(f"${param_idx} = ANY(sa.categories)")
+        param_idx += 1
+
+    where_clause = " AND ".join(where_parts)
+
+    # Weights
+    params.append(weights.semantic)
+    w_semantic = f"${param_idx}"
+    param_idx += 1
+
+    params.append(weights.lexical)
+    w_lexical = f"${param_idx}"
+    param_idx += 1
+
+    params.append(weights.category)
+    w_category = f"${param_idx}"
+    param_idx += 1
+
+    params.append(weights.recency)
+    w_recency = f"${param_idx}"
+    param_idx += 1
+
+    params.append(weights.popularity)
+    w_popularity = f"${param_idx}"
+    param_idx += 1
+
+    params.append(min_score)
+    min_score_param = f"${param_idx}"
+    param_idx += 1
+
+    params.append(page_size)
+    limit_param = f"${param_idx}"
+    param_idx += 1
+
+    params.append(offset)
+    offset_param = f"${param_idx}"
+    param_idx += 1
+
+    # Query using UnifiedContentEmbedding for search, StoreAgent for metadata
+    sql_query = f"""
+        WITH candidates AS (
+            -- Lexical matches via UnifiedContentEmbedding.search
+            SELECT uce."contentId" as "storeListingVersionId"
+            FROM {{schema_prefix}}"UnifiedContentEmbedding" uce
+            INNER JOIN {{schema_prefix}}"StoreAgent" sa
+                ON uce."contentId" = sa."storeListingVersionId"
+            WHERE uce."contentType" = 'STORE_AGENT'::{{schema_prefix}}"ContentType"
+            AND uce."userId" IS NULL
+            AND uce.search @@ plainto_tsquery('english', {query_param})
+            AND {where_clause}
+
+            UNION
+
+            -- Semantic matches via UnifiedContentEmbedding.embedding
+            SELECT uce."contentId" as "storeListingVersionId"
+            FROM (
+                SELECT uce."contentId", uce.embedding
+                FROM {{schema_prefix}}"UnifiedContentEmbedding" uce
+                INNER JOIN {{schema_prefix}}"StoreAgent" sa
+                    ON uce."contentId" = sa."storeListingVersionId"
+                WHERE uce."contentType" = 'STORE_AGENT'::{{schema_prefix}}"ContentType"
+                AND uce."userId" IS NULL
+                AND {where_clause}
+                ORDER BY uce.embedding <=> {embedding_param}::vector
+                LIMIT 200
+            ) uce
+        ),
+        search_scores AS (
+            SELECT
+                sa.slug,
+                sa.agent_name,
+                sa.agent_image,
+                sa.creator_username,
+                sa.creator_avatar,
+                sa.sub_heading,
+                sa.description,
+                sa.runs,
+                sa.rating,
+                sa.categories,
+                sa.featured,
+                sa.is_available,
+                sa.updated_at,
+                -- Searchable text for BM25 reranking
+                COALESCE(sa.agent_name, '') || ' ' || COALESCE(sa.sub_heading, '') || ' ' || COALESCE(sa.description, '') as searchable_text,
+                -- Semantic score
+                COALESCE(1 - (uce.embedding <=> {embedding_param}::vector), 0) as semantic_score,
+                -- Lexical score (raw, will normalize)
+                COALESCE(ts_rank_cd(uce.search, plainto_tsquery('english', {query_param})), 0) as lexical_raw,
+                -- Category match
+                CASE
+                    WHEN EXISTS (
+                        SELECT 1 FROM unnest(sa.categories) cat
+                        WHERE LOWER(cat) LIKE '%' || {query_lower_param} || '%'
+                    )
+                    THEN 1.0
+                    ELSE 0.0
+                END as category_score,
+                -- Recency
+                GREATEST(0, 1 - EXTRACT(EPOCH FROM (NOW() - sa.updated_at)) / (90 * 24 * 3600)) as recency_score,
+                -- Popularity (raw)
+                sa.runs as popularity_raw
+            FROM candidates c
+            INNER JOIN {{schema_prefix}}"StoreAgent" sa
+                ON c."storeListingVersionId" = sa."storeListingVersionId"
+            INNER JOIN {{schema_prefix}}"UnifiedContentEmbedding" uce
+                ON sa."storeListingVersionId" = uce."contentId"
+                AND uce."contentType" = 'STORE_AGENT'::{{schema_prefix}}"ContentType"
+        ),
+        max_vals AS (
+            SELECT
+                GREATEST(MAX(lexical_raw), 0.001) as max_lexical,
+                GREATEST(MAX(popularity_raw), 1) as max_popularity
+            FROM search_scores
+        ),
+        normalized AS (
+            SELECT
+                ss.*,
+                ss.lexical_raw / mv.max_lexical as lexical_score,
+                CASE
+                    WHEN ss.popularity_raw > 0
+                    THEN LN(1 + ss.popularity_raw) / LN(1 + mv.max_popularity)
+                    ELSE 0
+                END as popularity_score
+            FROM search_scores ss
+            CROSS JOIN max_vals mv
+        ),
+        scored AS (
+            SELECT
+                slug,
+                agent_name,
+                agent_image,
+                creator_username,
+                creator_avatar,
+                sub_heading,
+                description,
+                runs,
+                rating,
+                categories,
+                featured,
+                is_available,
+                updated_at,
+                searchable_text,
+                semantic_score,
+                lexical_score,
+                category_score,
+                recency_score,
+                popularity_score,
+                (
+                    {w_semantic} * semantic_score +
+                    {w_lexical} * lexical_score +
+                    {w_category} * category_score +
+                    {w_recency} * recency_score +
+                    {w_popularity} * popularity_score
+                ) as combined_score
+            FROM normalized
+        ),
+        filtered AS (
+            SELECT *, COUNT(*) OVER () as total_count
+            FROM scored
+            WHERE combined_score >= {min_score_param}
+        )
+        SELECT * FROM filtered
+        ORDER BY combined_score DESC
+        LIMIT {limit_param} OFFSET {offset_param}
+    """
+
+    results = await query_raw_with_schema(
+        sql_query, *params, set_public_search_path=True
+    )
+
+    total = results[0]["total_count"] if results else 0
+
+    # Apply BM25 reranking
+    if results:
+        results = bm25_rerank(
+            query=query,
+            results=results,
+            text_field="searchable_text",
+            bm25_weight=0.3,
+            original_score_field="combined_score",
+        )
+
+    for result in results:
+        result.pop("total_count", None)
+        result.pop("searchable_text", None)
+
+    logger.info(f"Hybrid search (store agents): {len(results)} results, {total} total")
+
+    return results, total
+
+
+async def hybrid_search_simple(
+    query: str,
+    page: int = 1,
+    page_size: int = 20,
+) -> tuple[list[dict[str, Any]], int]:
+    """Simplified hybrid search for store agents."""
+    return await hybrid_search(query=query, page=page, page_size=page_size)
+
+
+# Backward compatibility alias - HybridSearchWeights maps to StoreAgentSearchWeights
+# for existing code that expects the popularity parameter
+HybridSearchWeights = StoreAgentSearchWeights
diff --git a/autogpt_platform/backend/backend/api/features/store/hybrid_search_test.py b/autogpt_platform/backend/backend/api/features/store/hybrid_search_test.py
new file mode 100644
index 0000000000..7f942927a5
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/store/hybrid_search_test.py
@@ -0,0 +1,726 @@
+"""
+Integration tests for hybrid search with schema handling.
+
+These tests verify that hybrid search works correctly across different database schemas.
+"""
+
+from unittest.mock import patch
+
+import pytest
+from prisma.enums import ContentType
+
+from backend.api.features.store import embeddings
+from backend.api.features.store.hybrid_search import (
+    HybridSearchWeights,
+    UnifiedSearchWeights,
+    hybrid_search,
+    unified_hybrid_search,
+)
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_hybrid_search_with_schema_handling():
+    """Test that hybrid search correctly handles database schema prefixes."""
+    # Test with a mock query to ensure schema handling works
+    query = "test agent"
+
+    with patch(
+        "backend.api.features.store.hybrid_search.query_raw_with_schema"
+    ) as mock_query:
+        # Mock the query result
+        mock_query.return_value = [
+            {
+                "slug": "test/agent",
+                "agent_name": "Test Agent",
+                "agent_image": "test.png",
+                "creator_username": "test",
+                "creator_avatar": "avatar.png",
+                "sub_heading": "Test sub-heading",
+                "description": "Test description",
+                "runs": 10,
+                "rating": 4.5,
+                "categories": ["test"],
+                "featured": False,
+                "is_available": True,
+                "updated_at": "2024-01-01T00:00:00Z",
+                "combined_score": 0.8,
+                "semantic_score": 0.7,
+                "lexical_score": 0.6,
+                "category_score": 0.5,
+                "recency_score": 0.4,
+                "total_count": 1,
+            }
+        ]
+
+        with patch(
+            "backend.api.features.store.hybrid_search.embed_query"
+        ) as mock_embed:
+            mock_embed.return_value = [0.1] * embeddings.EMBEDDING_DIM  # Mock embedding
+
+            results, total = await hybrid_search(
+                query=query,
+                page=1,
+                page_size=20,
+            )
+
+            # Verify the query was called
+            assert mock_query.called
+            # Verify the SQL template uses schema_prefix placeholder
+            call_args = mock_query.call_args
+            sql_template = call_args[0][0]
+            assert "{schema_prefix}" in sql_template
+
+            # Verify results
+            assert len(results) == 1
+            assert total == 1
+            assert results[0]["slug"] == "test/agent"
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_hybrid_search_with_public_schema():
+    """Test hybrid search when using public schema (no prefix needed)."""
+    with patch("backend.data.db.get_database_schema") as mock_schema:
+        mock_schema.return_value = "public"
+
+        with patch(
+            "backend.api.features.store.hybrid_search.query_raw_with_schema"
+        ) as mock_query:
+            mock_query.return_value = []
+
+            with patch(
+                "backend.api.features.store.hybrid_search.embed_query"
+            ) as mock_embed:
+                mock_embed.return_value = [0.1] * embeddings.EMBEDDING_DIM
+
+                results, total = await hybrid_search(
+                    query="test",
+                    page=1,
+                    page_size=20,
+                )
+
+                # Verify the mock was set up correctly
+                assert mock_schema.return_value == "public"
+
+                # Results should work even with empty results
+                assert results == []
+                assert total == 0
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_hybrid_search_with_custom_schema():
+    """Test hybrid search when using custom schema (e.g., 'platform')."""
+    with patch("backend.data.db.get_database_schema") as mock_schema:
+        mock_schema.return_value = "platform"
+
+        with patch(
+            "backend.api.features.store.hybrid_search.query_raw_with_schema"
+        ) as mock_query:
+            mock_query.return_value = []
+
+            with patch(
+                "backend.api.features.store.hybrid_search.embed_query"
+            ) as mock_embed:
+                mock_embed.return_value = [0.1] * embeddings.EMBEDDING_DIM
+
+                results, total = await hybrid_search(
+                    query="test",
+                    page=1,
+                    page_size=20,
+                )
+
+                # Verify the mock was set up correctly
+                assert mock_schema.return_value == "platform"
+
+                assert results == []
+                assert total == 0
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_hybrid_search_without_embeddings():
+    """Test hybrid search gracefully degrades when embeddings are unavailable."""
+    # Mock database to return some results
+    mock_results = [
+        {
+            "slug": "test-agent",
+            "agent_name": "Test Agent",
+            "agent_image": "test.png",
+            "creator_username": "creator",
+            "creator_avatar": "avatar.png",
+            "sub_heading": "Test heading",
+            "description": "Test description",
+            "runs": 100,
+            "rating": 4.5,
+            "categories": ["AI"],
+            "featured": False,
+            "is_available": True,
+            "updated_at": "2025-01-01T00:00:00Z",
+            "semantic_score": 0.0,  # Zero because no embedding
+            "lexical_score": 0.5,
+            "category_score": 0.0,
+            "recency_score": 0.1,
+            "popularity_score": 0.2,
+            "combined_score": 0.3,
+            "total_count": 1,
+        }
+    ]
+
+    with patch("backend.api.features.store.hybrid_search.embed_query") as mock_embed:
+        with patch(
+            "backend.api.features.store.hybrid_search.query_raw_with_schema"
+        ) as mock_query:
+            # Simulate embedding failure
+            mock_embed.return_value = None
+            mock_query.return_value = mock_results
+
+            # Should NOT raise - graceful degradation
+            results, total = await hybrid_search(
+                query="test",
+                page=1,
+                page_size=20,
+            )
+
+            # Verify it returns results even without embeddings
+            assert len(results) == 1
+            assert results[0]["slug"] == "test-agent"
+            assert total == 1
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_hybrid_search_with_filters():
+    """Test hybrid search with various filters."""
+    with patch(
+        "backend.api.features.store.hybrid_search.query_raw_with_schema"
+    ) as mock_query:
+        mock_query.return_value = []
+
+        with patch(
+            "backend.api.features.store.hybrid_search.embed_query"
+        ) as mock_embed:
+            mock_embed.return_value = [0.1] * embeddings.EMBEDDING_DIM
+
+            # Test with featured filter
+            results, total = await hybrid_search(
+                query="test",
+                featured=True,
+                creators=["user1", "user2"],
+                category="productivity",
+                page=1,
+                page_size=10,
+            )
+
+            # Verify filters were applied in the query
+            call_args = mock_query.call_args
+            params = call_args[0][1:]  # Skip SQL template
+
+            # Should have query, query_lower, creators array, category
+            assert len(params) >= 4
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_hybrid_search_weights():
+    """Test hybrid search with custom weights."""
+    custom_weights = HybridSearchWeights(
+        semantic=0.5,
+        lexical=0.3,
+        category=0.1,
+        recency=0.1,
+        popularity=0.0,
+    )
+
+    with patch(
+        "backend.api.features.store.hybrid_search.query_raw_with_schema"
+    ) as mock_query:
+        mock_query.return_value = []
+
+        with patch(
+            "backend.api.features.store.hybrid_search.embed_query"
+        ) as mock_embed:
+            mock_embed.return_value = [0.1] * embeddings.EMBEDDING_DIM
+
+            results, total = await hybrid_search(
+                query="test",
+                weights=custom_weights,
+                page=1,
+                page_size=20,
+            )
+
+            # Verify custom weights were used in the query
+            call_args = mock_query.call_args
+            sql_template = call_args[0][0]
+            params = call_args[0][1:]  # Get all parameters passed
+
+            # Check that SQL uses parameterized weights (not f-string interpolation)
+            assert "$" in sql_template  # Verify parameterization is used
+
+            # Check that custom weights are in the params
+            assert 0.5 in params  # semantic weight
+            assert 0.3 in params  # lexical weight
+            assert 0.1 in params  # category and recency weights
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_hybrid_search_min_score_filtering():
+    """Test hybrid search minimum score threshold."""
+    with patch(
+        "backend.api.features.store.hybrid_search.query_raw_with_schema"
+    ) as mock_query:
+        # Return results with varying scores
+        mock_query.return_value = [
+            {
+                "slug": "high-score/agent",
+                "agent_name": "High Score Agent",
+                "combined_score": 0.8,
+                "total_count": 1,
+                # ... other fields
+            }
+        ]
+
+        with patch(
+            "backend.api.features.store.hybrid_search.embed_query"
+        ) as mock_embed:
+            mock_embed.return_value = [0.1] * embeddings.EMBEDDING_DIM
+
+            # Test with custom min_score
+            results, total = await hybrid_search(
+                query="test",
+                min_score=0.5,  # High threshold
+                page=1,
+                page_size=20,
+            )
+
+            # Verify min_score was applied in query
+            call_args = mock_query.call_args
+            sql_template = call_args[0][0]
+            params = call_args[0][1:]  # Get all parameters
+
+            # Check that SQL uses parameterized min_score
+            assert "combined_score >=" in sql_template
+            assert "$" in sql_template  # Verify parameterization
+
+            # Check that custom min_score is in the params
+            assert 0.5 in params
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_hybrid_search_pagination():
+    """Test hybrid search pagination.
+
+    Pagination happens in SQL (LIMIT/OFFSET), then BM25 reranking is applied
+    to the paginated results.
+    """
+    # Create mock results that SQL would return for a page
+    mock_results = [
+        {
+            "slug": f"agent-{i}",
+            "agent_name": f"Agent {i}",
+            "agent_image": "test.png",
+            "creator_username": "test",
+            "creator_avatar": "avatar.png",
+            "sub_heading": "Test",
+            "description": "Test description",
+            "runs": 100 - i,
+            "rating": 4.5,
+            "categories": ["test"],
+            "featured": False,
+            "is_available": True,
+            "updated_at": "2024-01-01T00:00:00Z",
+            "searchable_text": f"Agent {i} test description",
+            "combined_score": 0.9 - (i * 0.01),
+            "semantic_score": 0.7,
+            "lexical_score": 0.6,
+            "category_score": 0.5,
+            "recency_score": 0.4,
+            "popularity_score": 0.3,
+            "total_count": 25,
+        }
+        for i in range(10)  # SQL returns page_size results
+    ]
+
+    with patch(
+        "backend.api.features.store.hybrid_search.query_raw_with_schema"
+    ) as mock_query:
+        mock_query.return_value = mock_results
+
+        with patch(
+            "backend.api.features.store.hybrid_search.embed_query"
+        ) as mock_embed:
+            mock_embed.return_value = [0.1] * embeddings.EMBEDDING_DIM
+
+            # Test page 2 with page_size 10
+            results, total = await hybrid_search(
+                query="test",
+                page=2,
+                page_size=10,
+            )
+
+            # Verify results returned
+            assert len(results) == 10
+            assert total == 25  # Total from SQL COUNT(*) OVER()
+
+            # Verify the SQL query uses page_size and offset
+            call_args = mock_query.call_args
+            params = call_args[0]
+            # Last two params are page_size and offset
+            page_size_param = params[-2]
+            offset_param = params[-1]
+            assert page_size_param == 10
+            assert offset_param == 10  # (page 2 - 1) * 10
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_hybrid_search_error_handling():
+    """Test hybrid search error handling."""
+    with patch(
+        "backend.api.features.store.hybrid_search.query_raw_with_schema"
+    ) as mock_query:
+        # Simulate database error
+        mock_query.side_effect = Exception("Database connection error")
+
+        with patch(
+            "backend.api.features.store.hybrid_search.embed_query"
+        ) as mock_embed:
+            mock_embed.return_value = [0.1] * embeddings.EMBEDDING_DIM
+
+            # Should raise exception
+            with pytest.raises(Exception) as exc_info:
+                await hybrid_search(
+                    query="test",
+                    page=1,
+                    page_size=20,
+                )
+
+            assert "Database connection error" in str(exc_info.value)
+
+
+# =============================================================================
+# Unified Hybrid Search Tests
+# =============================================================================
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_unified_hybrid_search_basic():
+    """Test basic unified hybrid search across all content types."""
+    mock_results = [
+        {
+            "content_type": "STORE_AGENT",
+            "content_id": "agent-1",
+            "searchable_text": "Test Agent Description",
+            "metadata": {"name": "Test Agent"},
+            "updated_at": "2025-01-01T00:00:00Z",
+            "semantic_score": 0.7,
+            "lexical_score": 0.8,
+            "category_score": 0.5,
+            "recency_score": 0.3,
+            "combined_score": 0.6,
+            "total_count": 2,
+        },
+        {
+            "content_type": "BLOCK",
+            "content_id": "block-1",
+            "searchable_text": "Test Block Description",
+            "metadata": {"name": "Test Block"},
+            "updated_at": "2025-01-01T00:00:00Z",
+            "semantic_score": 0.6,
+            "lexical_score": 0.7,
+            "category_score": 0.4,
+            "recency_score": 0.2,
+            "combined_score": 0.5,
+            "total_count": 2,
+        },
+    ]
+
+    with patch(
+        "backend.api.features.store.hybrid_search.query_raw_with_schema"
+    ) as mock_query:
+        with patch(
+            "backend.api.features.store.hybrid_search.embed_query"
+        ) as mock_embed:
+            mock_query.return_value = mock_results
+            mock_embed.return_value = [0.1] * embeddings.EMBEDDING_DIM
+
+            results, total = await unified_hybrid_search(
+                query="test",
+                page=1,
+                page_size=20,
+            )
+
+            assert len(results) == 2
+            assert total == 2
+            assert results[0]["content_type"] == "STORE_AGENT"
+            assert results[1]["content_type"] == "BLOCK"
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_unified_hybrid_search_filter_by_content_type():
+    """Test unified search filtering by specific content types."""
+    mock_results = [
+        {
+            "content_type": "BLOCK",
+            "content_id": "block-1",
+            "searchable_text": "Test Block",
+            "metadata": {},
+            "updated_at": "2025-01-01T00:00:00Z",
+            "semantic_score": 0.7,
+            "lexical_score": 0.8,
+            "category_score": 0.0,
+            "recency_score": 0.3,
+            "combined_score": 0.5,
+            "total_count": 1,
+        },
+    ]
+
+    with patch(
+        "backend.api.features.store.hybrid_search.query_raw_with_schema"
+    ) as mock_query:
+        with patch(
+            "backend.api.features.store.hybrid_search.embed_query"
+        ) as mock_embed:
+            mock_query.return_value = mock_results
+            mock_embed.return_value = [0.1] * embeddings.EMBEDDING_DIM
+
+            results, total = await unified_hybrid_search(
+                query="test",
+                content_types=[ContentType.BLOCK],
+                page=1,
+                page_size=20,
+            )
+
+            # Verify content_types parameter was passed correctly
+            call_args = mock_query.call_args
+            params = call_args[0][1:]
+            # The content types should be in the params as a list
+            assert ["BLOCK"] in params
+
+            assert len(results) == 1
+            assert total == 1
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_unified_hybrid_search_with_user_id():
+    """Test unified search with user_id for private content."""
+    mock_results = [
+        {
+            "content_type": "STORE_AGENT",
+            "content_id": "agent-1",
+            "searchable_text": "My Private Agent",
+            "metadata": {},
+            "updated_at": "2025-01-01T00:00:00Z",
+            "semantic_score": 0.7,
+            "lexical_score": 0.8,
+            "category_score": 0.0,
+            "recency_score": 0.3,
+            "combined_score": 0.6,
+            "total_count": 1,
+        },
+    ]
+
+    with patch(
+        "backend.api.features.store.hybrid_search.query_raw_with_schema"
+    ) as mock_query:
+        with patch(
+            "backend.api.features.store.hybrid_search.embed_query"
+        ) as mock_embed:
+            mock_query.return_value = mock_results
+            mock_embed.return_value = [0.1] * embeddings.EMBEDDING_DIM
+
+            results, total = await unified_hybrid_search(
+                query="test",
+                user_id="user-123",
+                page=1,
+                page_size=20,
+            )
+
+            # Verify SQL contains user_id filter
+            call_args = mock_query.call_args
+            sql_template = call_args[0][0]
+            params = call_args[0][1:]
+
+            assert 'uce."userId"' in sql_template
+            assert "user-123" in params
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_unified_hybrid_search_custom_weights():
+    """Test unified search with custom weights."""
+    custom_weights = UnifiedSearchWeights(
+        semantic=0.6,
+        lexical=0.2,
+        category=0.1,
+        recency=0.1,
+    )
+
+    with patch(
+        "backend.api.features.store.hybrid_search.query_raw_with_schema"
+    ) as mock_query:
+        with patch(
+            "backend.api.features.store.hybrid_search.embed_query"
+        ) as mock_embed:
+            mock_query.return_value = []
+            mock_embed.return_value = [0.1] * embeddings.EMBEDDING_DIM
+
+            results, total = await unified_hybrid_search(
+                query="test",
+                weights=custom_weights,
+                page=1,
+                page_size=20,
+            )
+
+            # Verify custom weights are in parameters
+            call_args = mock_query.call_args
+            params = call_args[0][1:]
+
+            assert 0.6 in params  # semantic weight
+            assert 0.2 in params  # lexical weight
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_unified_hybrid_search_graceful_degradation():
+    """Test unified search gracefully degrades when embeddings unavailable."""
+    mock_results = [
+        {
+            "content_type": "DOCUMENTATION",
+            "content_id": "doc-1",
+            "searchable_text": "API Documentation",
+            "metadata": {},
+            "updated_at": "2025-01-01T00:00:00Z",
+            "semantic_score": 0.0,  # Zero because no embedding
+            "lexical_score": 0.8,
+            "category_score": 0.0,
+            "recency_score": 0.2,
+            "combined_score": 0.5,
+            "total_count": 1,
+        },
+    ]
+
+    with patch(
+        "backend.api.features.store.hybrid_search.query_raw_with_schema"
+    ) as mock_query:
+        with patch(
+            "backend.api.features.store.hybrid_search.embed_query"
+        ) as mock_embed:
+            mock_query.return_value = mock_results
+            mock_embed.return_value = None  # Embedding failure
+
+            # Should NOT raise - graceful degradation
+            results, total = await unified_hybrid_search(
+                query="test",
+                page=1,
+                page_size=20,
+            )
+
+            assert len(results) == 1
+            assert total == 1
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_unified_hybrid_search_empty_query():
+    """Test unified search with empty query returns empty results."""
+    results, total = await unified_hybrid_search(
+        query="",
+        page=1,
+        page_size=20,
+    )
+
+    assert results == []
+    assert total == 0
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_unified_hybrid_search_pagination():
+    """Test unified search pagination with BM25 reranking.
+
+    Pagination happens in SQL (LIMIT/OFFSET), then BM25 reranking is applied
+    to the paginated results.
+    """
+    # Create mock results that SQL would return for a page
+    mock_results = [
+        {
+            "content_type": "STORE_AGENT",
+            "content_id": f"agent-{i}",
+            "searchable_text": f"Agent {i} description",
+            "metadata": {"name": f"Agent {i}"},
+            "updated_at": "2025-01-01T00:00:00Z",
+            "semantic_score": 0.7,
+            "lexical_score": 0.8 - (i * 0.01),
+            "category_score": 0.5,
+            "recency_score": 0.3,
+            "combined_score": 0.6 - (i * 0.01),
+            "total_count": 50,
+        }
+        for i in range(15)  # SQL returns page_size results
+    ]
+
+    with patch(
+        "backend.api.features.store.hybrid_search.query_raw_with_schema"
+    ) as mock_query:
+        with patch(
+            "backend.api.features.store.hybrid_search.embed_query"
+        ) as mock_embed:
+            mock_query.return_value = mock_results
+            mock_embed.return_value = [0.1] * embeddings.EMBEDDING_DIM
+
+            results, total = await unified_hybrid_search(
+                query="test",
+                page=3,
+                page_size=15,
+            )
+
+            # Verify results returned
+            assert len(results) == 15
+            assert total == 50  # Total from SQL COUNT(*) OVER()
+
+            # Verify the SQL query uses page_size and offset
+            call_args = mock_query.call_args
+            params = call_args[0]
+            # Last two params are page_size and offset
+            page_size_param = params[-2]
+            offset_param = params[-1]
+            assert page_size_param == 15
+            assert offset_param == 30  # (page 3 - 1) * 15
+
+
+@pytest.mark.asyncio(loop_scope="session")
+@pytest.mark.integration
+async def test_unified_hybrid_search_schema_prefix():
+    """Test unified search uses schema_prefix placeholder."""
+    with patch(
+        "backend.api.features.store.hybrid_search.query_raw_with_schema"
+    ) as mock_query:
+        with patch(
+            "backend.api.features.store.hybrid_search.embed_query"
+        ) as mock_embed:
+            mock_query.return_value = []
+            mock_embed.return_value = [0.1] * embeddings.EMBEDDING_DIM
+
+            await unified_hybrid_search(
+                query="test",
+                page=1,
+                page_size=20,
+            )
+
+            call_args = mock_query.call_args
+            sql_template = call_args[0][0]
+
+            # Verify schema_prefix placeholder is used for table references
+            assert "{schema_prefix}" in sql_template
+            assert '"UnifiedContentEmbedding"' in sql_template
+
+
+if __name__ == "__main__":
+    pytest.main([__file__, "-v", "-s"])
diff --git a/autogpt_platform/backend/backend/api/features/store/model.py b/autogpt_platform/backend/backend/api/features/store/model.py
index 972898b296..a3310b96fc 100644
--- a/autogpt_platform/backend/backend/api/features/store/model.py
+++ b/autogpt_platform/backend/backend/api/features/store/model.py
@@ -110,6 +110,7 @@ class Profile(pydantic.BaseModel):
 
 
 class StoreSubmission(pydantic.BaseModel):
+    listing_id: str
     agent_id: str
     agent_version: int
     name: str
@@ -164,8 +165,12 @@ class StoreListingsWithVersionsResponse(pydantic.BaseModel):
 
 
 class StoreSubmissionRequest(pydantic.BaseModel):
-    agent_id: str
-    agent_version: int
+    agent_id: str = pydantic.Field(
+        ..., min_length=1, description="Agent ID cannot be empty"
+    )
+    agent_version: int = pydantic.Field(
+        ..., gt=0, description="Agent version must be greater than 0"
+    )
     slug: str
     name: str
     sub_heading: str
@@ -216,3 +221,23 @@ class ReviewSubmissionRequest(pydantic.BaseModel):
     is_approved: bool
     comments: str  # External comments visible to creator
     internal_comments: str | None = None  # Private admin notes
+
+
+class UnifiedSearchResult(pydantic.BaseModel):
+    """A single result from unified hybrid search across all content types."""
+
+    content_type: str  # STORE_AGENT, BLOCK, DOCUMENTATION
+    content_id: str
+    searchable_text: str
+    metadata: dict | None = None
+    updated_at: datetime.datetime | None = None
+    combined_score: float | None = None
+    semantic_score: float | None = None
+    lexical_score: float | None = None
+
+
+class UnifiedSearchResponse(pydantic.BaseModel):
+    """Response model for unified search across all content types."""
+
+    results: list[UnifiedSearchResult]
+    pagination: Pagination
diff --git a/autogpt_platform/backend/backend/api/features/store/model_test.py b/autogpt_platform/backend/backend/api/features/store/model_test.py
index a37966601b..fd09a0cf77 100644
--- a/autogpt_platform/backend/backend/api/features/store/model_test.py
+++ b/autogpt_platform/backend/backend/api/features/store/model_test.py
@@ -138,6 +138,7 @@ def test_creator_details():
 
 def test_store_submission():
     submission = store_model.StoreSubmission(
+        listing_id="listing123",
         agent_id="agent123",
         agent_version=1,
         sub_heading="Test subheading",
@@ -159,6 +160,7 @@ def test_store_submissions_response():
     response = store_model.StoreSubmissionsResponse(
         submissions=[
             store_model.StoreSubmission(
+                listing_id="listing123",
                 agent_id="agent123",
                 agent_version=1,
                 sub_heading="Test subheading",
diff --git a/autogpt_platform/backend/backend/api/features/store/routes.py b/autogpt_platform/backend/backend/api/features/store/routes.py
index 7816b25d5a..2f3c7bfb04 100644
--- a/autogpt_platform/backend/backend/api/features/store/routes.py
+++ b/autogpt_platform/backend/backend/api/features/store/routes.py
@@ -7,12 +7,15 @@ from typing import Literal
 import autogpt_libs.auth
 import fastapi
 import fastapi.responses
+import prisma.enums
 
 import backend.data.graph
 import backend.util.json
+from backend.util.models import Pagination
 
 from . import cache as store_cache
 from . import db as store_db
+from . import hybrid_search as store_hybrid_search
 from . import image_gen as store_image_gen
 from . import media as store_media
 from . import model as store_model
@@ -146,6 +149,102 @@ async def get_agents(
     return agents
 
 
+##############################################
+############### Search Endpoints #############
+##############################################
+
+
+@router.get(
+    "/search",
+    summary="Unified search across all content types",
+    tags=["store", "public"],
+    response_model=store_model.UnifiedSearchResponse,
+)
+async def unified_search(
+    query: str,
+    content_types: list[str] | None = fastapi.Query(
+        default=None,
+        description="Content types to search: STORE_AGENT, BLOCK, DOCUMENTATION. If not specified, searches all.",
+    ),
+    page: int = 1,
+    page_size: int = 20,
+    user_id: str | None = fastapi.Security(
+        autogpt_libs.auth.get_optional_user_id, use_cache=False
+    ),
+):
+    """
+    Search across all content types (store agents, blocks, documentation) using hybrid search.
+
+    Combines semantic (embedding-based) and lexical (text-based) search for best results.
+
+    Args:
+        query: The search query string
+        content_types: Optional list of content types to filter by (STORE_AGENT, BLOCK, DOCUMENTATION)
+        page: Page number for pagination (default 1)
+        page_size: Number of results per page (default 20)
+        user_id: Optional authenticated user ID (for user-scoped content in future)
+
+    Returns:
+        UnifiedSearchResponse: Paginated list of search results with relevance scores
+    """
+    if page < 1:
+        raise fastapi.HTTPException(
+            status_code=422, detail="Page must be greater than 0"
+        )
+
+    if page_size < 1:
+        raise fastapi.HTTPException(
+            status_code=422, detail="Page size must be greater than 0"
+        )
+
+    # Convert string content types to enum
+    content_type_enums: list[prisma.enums.ContentType] | None = None
+    if content_types:
+        try:
+            content_type_enums = [prisma.enums.ContentType(ct) for ct in content_types]
+        except ValueError as e:
+            raise fastapi.HTTPException(
+                status_code=422,
+                detail=f"Invalid content type. Valid values: STORE_AGENT, BLOCK, DOCUMENTATION. Error: {e}",
+            )
+
+    # Perform unified hybrid search
+    results, total = await store_hybrid_search.unified_hybrid_search(
+        query=query,
+        content_types=content_type_enums,
+        user_id=user_id,
+        page=page,
+        page_size=page_size,
+    )
+
+    # Convert results to response model
+    search_results = [
+        store_model.UnifiedSearchResult(
+            content_type=r["content_type"],
+            content_id=r["content_id"],
+            searchable_text=r.get("searchable_text", ""),
+            metadata=r.get("metadata"),
+            updated_at=r.get("updated_at"),
+            combined_score=r.get("combined_score"),
+            semantic_score=r.get("semantic_score"),
+            lexical_score=r.get("lexical_score"),
+        )
+        for r in results
+    ]
+
+    total_pages = (total + page_size - 1) // page_size if total > 0 else 0
+
+    return store_model.UnifiedSearchResponse(
+        results=search_results,
+        pagination=Pagination(
+            total_items=total,
+            total_pages=total_pages,
+            current_page=page,
+            page_size=page_size,
+        ),
+    )
+
+
 @router.get(
     "/agents/{username}/{agent_name}",
     summary="Get specific agent",
diff --git a/autogpt_platform/backend/backend/api/features/store/routes_test.py b/autogpt_platform/backend/backend/api/features/store/routes_test.py
index 7fdc0b9ebb..36431c20ec 100644
--- a/autogpt_platform/backend/backend/api/features/store/routes_test.py
+++ b/autogpt_platform/backend/backend/api/features/store/routes_test.py
@@ -521,6 +521,7 @@ def test_get_submissions_success(
     mocked_value = store_model.StoreSubmissionsResponse(
         submissions=[
             store_model.StoreSubmission(
+                listing_id="test-listing-id",
                 name="Test Agent",
                 description="Test agent description",
                 image_urls=["test.jpg"],
diff --git a/autogpt_platform/backend/backend/api/features/store/semantic_search_test.py b/autogpt_platform/backend/backend/api/features/store/semantic_search_test.py
new file mode 100644
index 0000000000..b52f924ee8
--- /dev/null
+++ b/autogpt_platform/backend/backend/api/features/store/semantic_search_test.py
@@ -0,0 +1,272 @@
+"""Tests for the semantic_search function."""
+
+import pytest
+from prisma.enums import ContentType
+
+from backend.api.features.store.embeddings import EMBEDDING_DIM, semantic_search
+
+
+@pytest.mark.asyncio
+async def test_search_blocks_only(mocker):
+    """Test searching only BLOCK content type."""
+    # Mock embed_query to return a test embedding
+    mock_embedding = [0.1] * EMBEDDING_DIM
+    mocker.patch(
+        "backend.api.features.store.embeddings.embed_query",
+        return_value=mock_embedding,
+    )
+
+    # Mock query_raw_with_schema to return test results
+    mock_results = [
+        {
+            "content_id": "block-123",
+            "content_type": "BLOCK",
+            "searchable_text": "Calculator Block - Performs arithmetic operations",
+            "metadata": {"name": "Calculator", "categories": ["Math"]},
+            "similarity": 0.85,
+        }
+    ]
+    mocker.patch(
+        "backend.api.features.store.embeddings.query_raw_with_schema",
+        return_value=mock_results,
+    )
+
+    results = await semantic_search(
+        query="calculate numbers",
+        content_types=[ContentType.BLOCK],
+    )
+
+    assert len(results) == 1
+    assert results[0]["content_type"] == "BLOCK"
+    assert results[0]["content_id"] == "block-123"
+    assert results[0]["similarity"] == 0.85
+
+
+@pytest.mark.asyncio
+async def test_search_multiple_content_types(mocker):
+    """Test searching multiple content types simultaneously."""
+    mock_embedding = [0.1] * EMBEDDING_DIM
+    mocker.patch(
+        "backend.api.features.store.embeddings.embed_query",
+        return_value=mock_embedding,
+    )
+
+    mock_results = [
+        {
+            "content_id": "block-123",
+            "content_type": "BLOCK",
+            "searchable_text": "Calculator Block",
+            "metadata": {},
+            "similarity": 0.85,
+        },
+        {
+            "content_id": "doc-456",
+            "content_type": "DOCUMENTATION",
+            "searchable_text": "How to use Calculator",
+            "metadata": {},
+            "similarity": 0.75,
+        },
+    ]
+    mocker.patch(
+        "backend.api.features.store.embeddings.query_raw_with_schema",
+        return_value=mock_results,
+    )
+
+    results = await semantic_search(
+        query="calculator",
+        content_types=[ContentType.BLOCK, ContentType.DOCUMENTATION],
+    )
+
+    assert len(results) == 2
+    assert results[0]["content_type"] == "BLOCK"
+    assert results[1]["content_type"] == "DOCUMENTATION"
+
+
+@pytest.mark.asyncio
+async def test_search_with_min_similarity_threshold(mocker):
+    """Test that results below min_similarity are filtered out."""
+    mock_embedding = [0.1] * EMBEDDING_DIM
+    mocker.patch(
+        "backend.api.features.store.embeddings.embed_query",
+        return_value=mock_embedding,
+    )
+
+    # Only return results above 0.7 similarity
+    mock_results = [
+        {
+            "content_id": "block-123",
+            "content_type": "BLOCK",
+            "searchable_text": "Calculator Block",
+            "metadata": {},
+            "similarity": 0.85,
+        }
+    ]
+    mocker.patch(
+        "backend.api.features.store.embeddings.query_raw_with_schema",
+        return_value=mock_results,
+    )
+
+    results = await semantic_search(
+        query="calculate",
+        content_types=[ContentType.BLOCK],
+        min_similarity=0.7,
+    )
+
+    assert len(results) == 1
+    assert results[0]["similarity"] >= 0.7
+
+
+@pytest.mark.asyncio
+async def test_search_fallback_to_lexical(mocker):
+    """Test fallback to lexical search when embeddings fail."""
+    # Mock embed_query to return None (embeddings unavailable)
+    mocker.patch(
+        "backend.api.features.store.embeddings.embed_query",
+        return_value=None,
+    )
+
+    mock_lexical_results = [
+        {
+            "content_id": "block-123",
+            "content_type": "BLOCK",
+            "searchable_text": "Calculator Block performs calculations",
+            "metadata": {},
+            "similarity": 0.0,
+        }
+    ]
+    mocker.patch(
+        "backend.api.features.store.embeddings.query_raw_with_schema",
+        return_value=mock_lexical_results,
+    )
+
+    results = await semantic_search(
+        query="calculator",
+        content_types=[ContentType.BLOCK],
+    )
+
+    assert len(results) == 1
+    assert results[0]["similarity"] == 0.0  # Lexical search returns 0 similarity
+
+
+@pytest.mark.asyncio
+async def test_search_empty_query():
+    """Test that empty query returns no results."""
+    results = await semantic_search(query="")
+    assert results == []
+
+    results = await semantic_search(query="   ")
+    assert results == []
+
+
+@pytest.mark.asyncio
+async def test_search_with_user_id_filter(mocker):
+    """Test searching with user_id filter for private content."""
+    mock_embedding = [0.1] * EMBEDDING_DIM
+    mocker.patch(
+        "backend.api.features.store.embeddings.embed_query",
+        return_value=mock_embedding,
+    )
+
+    mock_results = [
+        {
+            "content_id": "agent-789",
+            "content_type": "LIBRARY_AGENT",
+            "searchable_text": "My Custom Agent",
+            "metadata": {},
+            "similarity": 0.9,
+        }
+    ]
+    mocker.patch(
+        "backend.api.features.store.embeddings.query_raw_with_schema",
+        return_value=mock_results,
+    )
+
+    results = await semantic_search(
+        query="custom agent",
+        content_types=[ContentType.LIBRARY_AGENT],
+        user_id="user-123",
+    )
+
+    assert len(results) == 1
+    assert results[0]["content_type"] == "LIBRARY_AGENT"
+
+
+@pytest.mark.asyncio
+async def test_search_limit_parameter(mocker):
+    """Test that limit parameter correctly limits results."""
+    mock_embedding = [0.1] * EMBEDDING_DIM
+    mocker.patch(
+        "backend.api.features.store.embeddings.embed_query",
+        return_value=mock_embedding,
+    )
+
+    # Return 5 results
+    mock_results = [
+        {
+            "content_id": f"block-{i}",
+            "content_type": "BLOCK",
+            "searchable_text": f"Block {i}",
+            "metadata": {},
+            "similarity": 0.8,
+        }
+        for i in range(5)
+    ]
+    mocker.patch(
+        "backend.api.features.store.embeddings.query_raw_with_schema",
+        return_value=mock_results,
+    )
+
+    results = await semantic_search(
+        query="block",
+        content_types=[ContentType.BLOCK],
+        limit=5,
+    )
+
+    assert len(results) == 5
+
+
+@pytest.mark.asyncio
+async def test_search_default_content_types(mocker):
+    """Test that default content_types includes BLOCK, STORE_AGENT, and DOCUMENTATION."""
+    mock_embedding = [0.1] * EMBEDDING_DIM
+    mocker.patch(
+        "backend.api.features.store.embeddings.embed_query",
+        return_value=mock_embedding,
+    )
+
+    mock_query_raw = mocker.patch(
+        "backend.api.features.store.embeddings.query_raw_with_schema",
+        return_value=[],
+    )
+
+    await semantic_search(query="test")
+
+    # Check that the SQL query includes all three default content types
+    call_args = mock_query_raw.call_args
+    assert "BLOCK" in str(call_args)
+    assert "STORE_AGENT" in str(call_args)
+    assert "DOCUMENTATION" in str(call_args)
+
+
+@pytest.mark.asyncio
+async def test_search_handles_database_error(mocker):
+    """Test that database errors are handled gracefully."""
+    mock_embedding = [0.1] * EMBEDDING_DIM
+    mocker.patch(
+        "backend.api.features.store.embeddings.embed_query",
+        return_value=mock_embedding,
+    )
+
+    # Simulate database error
+    mocker.patch(
+        "backend.api.features.store.embeddings.query_raw_with_schema",
+        side_effect=Exception("Database connection failed"),
+    )
+
+    results = await semantic_search(
+        query="test",
+        content_types=[ContentType.BLOCK],
+    )
+
+    # Should return empty list on error
+    assert results == []
diff --git a/autogpt_platform/backend/backend/api/features/v1.py b/autogpt_platform/backend/backend/api/features/v1.py
index 9b05b4755f..661e8ff7f2 100644
--- a/autogpt_platform/backend/backend/api/features/v1.py
+++ b/autogpt_platform/backend/backend/api/features/v1.py
@@ -64,7 +64,6 @@ from backend.data.onboarding import (
     complete_re_run_agent,
     get_recommended_agents,
     get_user_onboarding,
-    increment_runs,
     onboarding_enabled,
     reset_user_onboarding,
     update_user_onboarding,
@@ -975,7 +974,6 @@ async def execute_graph(
         # Record successful graph execution
         record_graph_execution(graph_id=graph_id, status="success", user_id=user_id)
         record_graph_operation(operation="execute", status="success")
-        await increment_runs(user_id)
         await complete_re_run_agent(user_id, graph_id)
         if source == "library":
             await complete_onboarding_step(
diff --git a/autogpt_platform/backend/backend/api/rest_api.py b/autogpt_platform/backend/backend/api/rest_api.py
index 147f62e781..e9556e992f 100644
--- a/autogpt_platform/backend/backend/api/rest_api.py
+++ b/autogpt_platform/backend/backend/api/rest_api.py
@@ -39,7 +39,7 @@ import backend.data.user
 import backend.integrations.webhooks.utils
 import backend.util.service
 import backend.util.settings
-from backend.blocks.llm import LlmModel
+from backend.blocks.llm import DEFAULT_LLM_MODEL
 from backend.data.model import Credentials
 from backend.integrations.providers import ProviderName
 from backend.monitoring.instrumentation import instrument_fastapi
@@ -113,7 +113,7 @@ async def lifespan_context(app: fastapi.FastAPI):
 
     await backend.data.user.migrate_and_encrypt_user_integrations()
     await backend.data.graph.fix_llm_provider_credentials()
-    await backend.data.graph.migrate_llm_models(LlmModel.GPT4O)
+    await backend.data.graph.migrate_llm_models(DEFAULT_LLM_MODEL)
     await backend.integrations.webhooks.utils.migrate_legacy_triggered_graphs()
 
     with launch_darkly_context():
diff --git a/autogpt_platform/backend/backend/blocks/ai_condition.py b/autogpt_platform/backend/backend/blocks/ai_condition.py
index de43c29a90..2a5cdcdeec 100644
--- a/autogpt_platform/backend/backend/blocks/ai_condition.py
+++ b/autogpt_platform/backend/backend/blocks/ai_condition.py
@@ -1,6 +1,7 @@
 from typing import Any
 
 from backend.blocks.llm import (
+    DEFAULT_LLM_MODEL,
     TEST_CREDENTIALS,
     TEST_CREDENTIALS_INPUT,
     AIBlockBase,
@@ -49,7 +50,7 @@ class AIConditionBlock(AIBlockBase):
         )
         model: LlmModel = SchemaField(
             title="LLM Model",
-            default=LlmModel.GPT4O,
+            default=DEFAULT_LLM_MODEL,
             description="The language model to use for evaluating the condition.",
             advanced=False,
         )
@@ -81,7 +82,7 @@ class AIConditionBlock(AIBlockBase):
                 "condition": "the input is an email address",
                 "yes_value": "Valid email",
                 "no_value": "Not an email",
-                "model": LlmModel.GPT4O,
+                "model": DEFAULT_LLM_MODEL,
                 "credentials": TEST_CREDENTIALS_INPUT,
             },
             test_credentials=TEST_CREDENTIALS,
diff --git a/autogpt_platform/backend/backend/blocks/ai_shortform_video_block.py b/autogpt_platform/backend/backend/blocks/ai_shortform_video_block.py
index 7242ff8304..a9e96890d3 100644
--- a/autogpt_platform/backend/backend/blocks/ai_shortform_video_block.py
+++ b/autogpt_platform/backend/backend/blocks/ai_shortform_video_block.py
@@ -174,7 +174,7 @@ class AIShortformVideoCreatorBlock(Block):
         )
         frame_rate: int = SchemaField(description="Frame rate of the video", default=60)
         generation_preset: GenerationPreset = SchemaField(
-            description="Generation preset for visual style - only effects AI generated visuals",
+            description="Generation preset for visual style - only affects AI-generated visuals",
             default=GenerationPreset.LEONARDO,
             placeholder=GenerationPreset.LEONARDO,
         )
diff --git a/autogpt_platform/backend/backend/blocks/airtable/_webhook.py b/autogpt_platform/backend/backend/blocks/airtable/_webhook.py
index 58e6f95d0c..452630953e 100644
--- a/autogpt_platform/backend/backend/blocks/airtable/_webhook.py
+++ b/autogpt_platform/backend/backend/blocks/airtable/_webhook.py
@@ -6,6 +6,9 @@ import hashlib
 import hmac
 import logging
 from enum import Enum
+from typing import cast
+
+from prisma.types import Serializable
 
 from backend.sdk import (
     BaseWebhooksManager,
@@ -84,7 +87,9 @@ class AirtableWebhookManager(BaseWebhooksManager):
         # update webhook config
         await update_webhook(
             webhook.id,
-            config={"base_id": base_id, "cursor": response.cursor},
+            config=cast(
+                dict[str, Serializable], {"base_id": base_id, "cursor": response.cursor}
+            ),
         )
 
         event_type = "notification"
diff --git a/autogpt_platform/backend/backend/blocks/apollo/models.py b/autogpt_platform/backend/backend/blocks/apollo/models.py
index 4dde8f29b1..9a710151b4 100644
--- a/autogpt_platform/backend/backend/blocks/apollo/models.py
+++ b/autogpt_platform/backend/backend/blocks/apollo/models.py
@@ -381,7 +381,7 @@ Each range you add needs to be a string, with the upper and lower numbers of the
     organization_locations: Optional[list[str]] = SchemaField(
         description="""The location of the company headquarters. You can search across cities, US states, and countries.
 
-If a company has several office locations, results are still based on the headquarters location. For example, if you search chicago but a company's HQ location is in boston, any Boston-based companies will not appearch in your search results, even if they match other parameters.
+If a company has several office locations, results are still based on the headquarters location. For example, if you search chicago but a company's HQ location is in boston, any Boston-based companies will not appear in your search results, even if they match other parameters.
 
 To exclude companies based on location, use the organization_not_locations parameter.
 """,
diff --git a/autogpt_platform/backend/backend/blocks/apollo/organization.py b/autogpt_platform/backend/backend/blocks/apollo/organization.py
index b6f8a7e06a..93acbff0b8 100644
--- a/autogpt_platform/backend/backend/blocks/apollo/organization.py
+++ b/autogpt_platform/backend/backend/blocks/apollo/organization.py
@@ -34,7 +34,7 @@ Each range you add needs to be a string, with the upper and lower numbers of the
         organization_locations: list[str] = SchemaField(
             description="""The location of the company headquarters. You can search across cities, US states, and countries.
 
-If a company has several office locations, results are still based on the headquarters location. For example, if you search chicago but a company's HQ location is in boston, any Boston-based companies will not appearch in your search results, even if they match other parameters.
+If a company has several office locations, results are still based on the headquarters location. For example, if you search chicago but a company's HQ location is in boston, any Boston-based companies will not appear in your search results, even if they match other parameters.
 
 To exclude companies based on location, use the organization_not_locations parameter.
 """,
diff --git a/autogpt_platform/backend/backend/blocks/basic.py b/autogpt_platform/backend/backend/blocks/basic.py
index a5f558f5c5..4d452f3b34 100644
--- a/autogpt_platform/backend/backend/blocks/basic.py
+++ b/autogpt_platform/backend/backend/blocks/basic.py
@@ -81,7 +81,7 @@ class StoreValueBlock(Block):
     def __init__(self):
         super().__init__(
             id="1ff065e9-88e8-4358-9d82-8dc91f622ba9",
-            description="This block forwards an input value as output, allowing reuse without change.",
+            description="A basic block that stores and forwards a value throughout workflows, allowing it to be reused without changes across multiple blocks.",
             categories={BlockCategory.BASIC},
             input_schema=StoreValueBlock.Input,
             output_schema=StoreValueBlock.Output,
@@ -111,7 +111,7 @@ class PrintToConsoleBlock(Block):
     def __init__(self):
         super().__init__(
             id="f3b1c1b2-4c4f-4f0d-8d2f-4c4f0d8d2f4c",
-            description="Print the given text to the console, this is used for a debugging purpose.",
+            description="A debugging block that outputs text to the console for monitoring and troubleshooting workflow execution.",
             categories={BlockCategory.BASIC},
             input_schema=PrintToConsoleBlock.Input,
             output_schema=PrintToConsoleBlock.Output,
@@ -137,7 +137,7 @@ class NoteBlock(Block):
     def __init__(self):
         super().__init__(
             id="cc10ff7b-7753-4ff2-9af6-9399b1a7eddc",
-            description="This block is used to display a sticky note with the given text.",
+            description="A visual annotation block that displays a sticky note in the workflow editor for documentation and organization purposes.",
             categories={BlockCategory.BASIC},
             input_schema=NoteBlock.Input,
             output_schema=NoteBlock.Output,
diff --git a/autogpt_platform/backend/backend/blocks/data_manipulation.py b/autogpt_platform/backend/backend/blocks/data_manipulation.py
index 94921e26c0..5864a517ed 100644
--- a/autogpt_platform/backend/backend/blocks/data_manipulation.py
+++ b/autogpt_platform/backend/backend/blocks/data_manipulation.py
@@ -159,7 +159,7 @@ class FindInDictionaryBlock(Block):
     def __init__(self):
         super().__init__(
             id="0e50422c-6dee-4145-83d6-3a5a392f65de",
-            description="Lookup the given key in the input dictionary/object/list and return the value.",
+            description="A block that looks up a value in a dictionary, list, or object by key or index and returns the corresponding value.",
             input_schema=FindInDictionaryBlock.Input,
             output_schema=FindInDictionaryBlock.Output,
             test_input=[
diff --git a/autogpt_platform/backend/backend/blocks/dataforseo/related_keywords.py b/autogpt_platform/backend/backend/blocks/dataforseo/related_keywords.py
index 7a7fbdd11a..0757cb6507 100644
--- a/autogpt_platform/backend/backend/blocks/dataforseo/related_keywords.py
+++ b/autogpt_platform/backend/backend/blocks/dataforseo/related_keywords.py
@@ -182,13 +182,10 @@ class DataForSeoRelatedKeywordsBlock(Block):
             if results and len(results) > 0:
                 # results is a list, get the first element
                 first_result = results[0] if isinstance(results, list) else results
-                items = (
-                    first_result.get("items", [])
-                    if isinstance(first_result, dict)
-                    else []
-                )
-                # Ensure items is never None
-                if items is None:
+                # Handle missing key, null value, or valid list value
+                if isinstance(first_result, dict):
+                    items = first_result.get("items") or []
+                else:
                     items = []
                 for item in items:
                     # Extract keyword_data from the item
diff --git a/autogpt_platform/backend/backend/blocks/github/issues.py b/autogpt_platform/backend/backend/blocks/github/issues.py
index b8187ac1f5..22b4149663 100644
--- a/autogpt_platform/backend/backend/blocks/github/issues.py
+++ b/autogpt_platform/backend/backend/blocks/github/issues.py
@@ -51,7 +51,7 @@ class GithubCommentBlock(Block):
     def __init__(self):
         super().__init__(
             id="a8db4d8d-db1c-4a25-a1b0-416a8c33602b",
-            description="This block posts a comment on a specified GitHub issue or pull request.",
+            description="A block that posts comments on GitHub issues or pull requests using the GitHub API.",
             categories={BlockCategory.DEVELOPER_TOOLS},
             input_schema=GithubCommentBlock.Input,
             output_schema=GithubCommentBlock.Output,
@@ -151,7 +151,7 @@ class GithubUpdateCommentBlock(Block):
     def __init__(self):
         super().__init__(
             id="b3f4d747-10e3-4e69-8c51-f2be1d99c9a7",
-            description="This block updates a comment on a specified GitHub issue or pull request.",
+            description="A block that updates an existing comment on a GitHub issue or pull request.",
             categories={BlockCategory.DEVELOPER_TOOLS},
             input_schema=GithubUpdateCommentBlock.Input,
             output_schema=GithubUpdateCommentBlock.Output,
@@ -249,7 +249,7 @@ class GithubListCommentsBlock(Block):
     def __init__(self):
         super().__init__(
             id="c4b5fb63-0005-4a11-b35a-0c2467bd6b59",
-            description="This block lists all comments for a specified GitHub issue or pull request.",
+            description="A block that retrieves all comments from a GitHub issue or pull request, including comment metadata and content.",
             categories={BlockCategory.DEVELOPER_TOOLS},
             input_schema=GithubListCommentsBlock.Input,
             output_schema=GithubListCommentsBlock.Output,
@@ -363,7 +363,7 @@ class GithubMakeIssueBlock(Block):
     def __init__(self):
         super().__init__(
             id="691dad47-f494-44c3-a1e8-05b7990f2dab",
-            description="This block creates a new issue on a specified GitHub repository.",
+            description="A block that creates new issues on GitHub repositories with a title and body content.",
             categories={BlockCategory.DEVELOPER_TOOLS},
             input_schema=GithubMakeIssueBlock.Input,
             output_schema=GithubMakeIssueBlock.Output,
@@ -433,7 +433,7 @@ class GithubReadIssueBlock(Block):
     def __init__(self):
         super().__init__(
             id="6443c75d-032a-4772-9c08-230c707c8acc",
-            description="This block reads the body, title, and user of a specified GitHub issue.",
+            description="A block that retrieves information about a specific GitHub issue, including its title, body content, and creator.",
             categories={BlockCategory.DEVELOPER_TOOLS},
             input_schema=GithubReadIssueBlock.Input,
             output_schema=GithubReadIssueBlock.Output,
@@ -510,7 +510,7 @@ class GithubListIssuesBlock(Block):
     def __init__(self):
         super().__init__(
             id="c215bfd7-0e57-4573-8f8c-f7d4963dcd74",
-            description="This block lists all issues for a specified GitHub repository.",
+            description="A block that retrieves a list of issues from a GitHub repository with their titles and URLs.",
             categories={BlockCategory.DEVELOPER_TOOLS},
             input_schema=GithubListIssuesBlock.Input,
             output_schema=GithubListIssuesBlock.Output,
@@ -597,7 +597,7 @@ class GithubAddLabelBlock(Block):
     def __init__(self):
         super().__init__(
             id="98bd6b77-9506-43d5-b669-6b9733c4b1f1",
-            description="This block adds a label to a specified GitHub issue or pull request.",
+            description="A block that adds a label to a GitHub issue or pull request for categorization and organization.",
             categories={BlockCategory.DEVELOPER_TOOLS},
             input_schema=GithubAddLabelBlock.Input,
             output_schema=GithubAddLabelBlock.Output,
@@ -657,7 +657,7 @@ class GithubRemoveLabelBlock(Block):
     def __init__(self):
         super().__init__(
             id="78f050c5-3e3a-48c0-9e5b-ef1ceca5589c",
-            description="This block removes a label from a specified GitHub issue or pull request.",
+            description="A block that removes a label from a GitHub issue or pull request.",
             categories={BlockCategory.DEVELOPER_TOOLS},
             input_schema=GithubRemoveLabelBlock.Input,
             output_schema=GithubRemoveLabelBlock.Output,
@@ -720,7 +720,7 @@ class GithubAssignIssueBlock(Block):
     def __init__(self):
         super().__init__(
             id="90507c72-b0ff-413a-886a-23bbbd66f542",
-            description="This block assigns a user to a specified GitHub issue.",
+            description="A block that assigns a GitHub user to an issue for task ownership and tracking.",
             categories={BlockCategory.DEVELOPER_TOOLS},
             input_schema=GithubAssignIssueBlock.Input,
             output_schema=GithubAssignIssueBlock.Output,
@@ -786,7 +786,7 @@ class GithubUnassignIssueBlock(Block):
     def __init__(self):
         super().__init__(
             id="d154002a-38f4-46c2-962d-2488f2b05ece",
-            description="This block unassigns a user from a specified GitHub issue.",
+            description="A block that removes a user's assignment from a GitHub issue.",
             categories={BlockCategory.DEVELOPER_TOOLS},
             input_schema=GithubUnassignIssueBlock.Input,
             output_schema=GithubUnassignIssueBlock.Output,
diff --git a/autogpt_platform/backend/backend/blocks/google/docs.py b/autogpt_platform/backend/backend/blocks/google/docs.py
new file mode 100644
index 0000000000..7840cbae73
--- /dev/null
+++ b/autogpt_platform/backend/backend/blocks/google/docs.py
@@ -0,0 +1,2896 @@
+import asyncio
+import re
+from enum import Enum
+from typing import Any
+
+from google.oauth2.credentials import Credentials
+from googleapiclient.discovery import build
+from gravitas_md2gdocs import to_requests
+
+from backend.blocks.google._drive import GoogleDriveFile, GoogleDriveFileField
+from backend.data.block import (
+    Block,
+    BlockCategory,
+    BlockOutput,
+    BlockSchemaInput,
+    BlockSchemaOutput,
+)
+from backend.data.model import SchemaField
+from backend.util.settings import Settings
+
+from ._auth import (
+    GOOGLE_OAUTH_IS_CONFIGURED,
+    TEST_CREDENTIALS,
+    TEST_CREDENTIALS_INPUT,
+    GoogleCredentials,
+    GoogleCredentialsField,
+    GoogleCredentialsInput,
+)
+
+settings = Settings()
+GOOGLE_DOCS_DISABLED = not GOOGLE_OAUTH_IS_CONFIGURED
+
+
+# ============ Enums ============
+
+
+class PublicAccessRole(str, Enum):
+    READER = "reader"
+    COMMENTER = "commenter"
+
+
+class ShareRole(str, Enum):
+    READER = "reader"
+    WRITER = "writer"
+    COMMENTER = "commenter"
+
+
+# ============ Helper Functions ============
+
+
+def _build_docs_service(credentials: GoogleCredentials):
+    """Build Google Docs API service."""
+    creds = Credentials(
+        token=(
+            credentials.access_token.get_secret_value()
+            if credentials.access_token
+            else None
+        ),
+        refresh_token=(
+            credentials.refresh_token.get_secret_value()
+            if credentials.refresh_token
+            else None
+        ),
+        token_uri="https://oauth2.googleapis.com/token",
+        client_id=settings.secrets.google_client_id,
+        client_secret=settings.secrets.google_client_secret,
+        scopes=credentials.scopes,
+    )
+    return build("docs", "v1", credentials=creds, cache_discovery=False)
+
+
+def _build_drive_service(credentials: GoogleCredentials):
+    """Build Google Drive API service for file operations."""
+    creds = Credentials(
+        token=(
+            credentials.access_token.get_secret_value()
+            if credentials.access_token
+            else None
+        ),
+        refresh_token=(
+            credentials.refresh_token.get_secret_value()
+            if credentials.refresh_token
+            else None
+        ),
+        token_uri="https://oauth2.googleapis.com/token",
+        client_id=settings.secrets.google_client_id,
+        client_secret=settings.secrets.google_client_secret,
+        scopes=credentials.scopes,
+    )
+    return build("drive", "v3", credentials=creds, cache_discovery=False)
+
+
+def _validate_document_file(file: GoogleDriveFile) -> str | None:
+    """Validate that a file is a Google Doc."""
+    if not file.id:
+        return "No document ID provided"
+    if file.mime_type and file.mime_type != "application/vnd.google-apps.document":
+        return f"File is not a Google Doc (type: {file.mime_type})"
+    return None
+
+
+def _parse_hex_color_to_rgb_floats(value: str) -> tuple[float, float, float] | None:
+    """
+    Parse a CSS-like hex color string into normalized RGB floats.
+
+    Supports:
+    - #RGB / RGB (shorthand)
+    - #RRGGBB / RRGGBB
+
+    Returns None for malformed inputs.
+    """
+    if not value:
+        return None
+
+    raw = value.strip()
+    if raw.startswith("#"):
+        raw = raw[1:]
+
+    if not re.fullmatch(r"[0-9a-fA-F]{3}([0-9a-fA-F]{3})?", raw):
+        return None
+
+    if len(raw) == 3:
+        raw = "".join(ch * 2 for ch in raw)
+
+    r = int(raw[0:2], 16) / 255.0
+    g = int(raw[2:4], 16) / 255.0
+    b = int(raw[4:6], 16) / 255.0
+    return (r, g, b)
+
+
+def _get_document_end_index(service, document_id: str) -> int:
+    """Get the index at the end of the document body."""
+    doc = service.documents().get(documentId=document_id).execute()
+    body = doc.get("body", {})
+    content = body.get("content", [])
+    if content:
+        last_element = content[-1]
+        return last_element.get("endIndex", 1) - 1
+    return 1
+
+
+def _extract_text_from_content(content: list[dict]) -> str:
+    """Extract plain text from document content structure."""
+    text_parts = []
+    for element in content:
+        if "paragraph" in element:
+            for elem in element["paragraph"].get("elements", []):
+                if "textRun" in elem:
+                    text_parts.append(elem["textRun"].get("content", ""))
+        elif "table" in element:
+            for row in element["table"].get("tableRows", []):
+                for cell in row.get("tableCells", []):
+                    cell_content = cell.get("content", [])
+                    text_parts.append(_extract_text_from_content(cell_content))
+    return "".join(text_parts)
+
+
+# ============ Document Output Helper ============
+
+
+def _make_document_output(file: GoogleDriveFile) -> GoogleDriveFile:
+    """Create standardized document output for chaining."""
+    return GoogleDriveFile(
+        id=file.id,
+        name=file.name,
+        mimeType="application/vnd.google-apps.document",
+        url=f"https://docs.google.com/document/d/{file.id}/edit",
+        iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+        isFolder=False,
+        _credentials_id=file.credentials_id,
+    )
+
+
+# ============ Blocks ============
+
+
+class GoogleDocsReadBlock(Block):
+    """Read content from a Google Doc."""
+
+    class Input(BlockSchemaInput):
+        document: GoogleDriveFile = GoogleDriveFileField(
+            title="Document",
+            description="Select a Google Doc to read",
+            allowed_views=["DOCUMENTS"],
+        )
+
+    class Output(BlockSchemaOutput):
+        text: str = SchemaField(description="Plain text content of the document")
+        title: str = SchemaField(description="Document title")
+        document: GoogleDriveFile = SchemaField(description="The document for chaining")
+        error: str = SchemaField(description="Error message if read failed")
+
+    def __init__(self):
+        super().__init__(
+            id="420a2b3c-5db2-4bda-82bc-a68a862a3d55",
+            description="Read text content from a Google Doc",
+            categories={BlockCategory.DATA},
+            input_schema=GoogleDocsReadBlock.Input,
+            output_schema=GoogleDocsReadBlock.Output,
+            disabled=GOOGLE_DOCS_DISABLED,
+            test_input={
+                "document": {
+                    "id": "1abc123def456",
+                    "name": "Test Document",
+                    "mimeType": "application/vnd.google-apps.document",
+                },
+            },
+            test_credentials=TEST_CREDENTIALS,
+            test_output=[
+                ("text", "Hello World\nThis is a test document.\n"),
+                ("title", "Test Document"),
+                (
+                    "document",
+                    GoogleDriveFile(
+                        id="1abc123def456",
+                        name="Test Document",
+                        mimeType="application/vnd.google-apps.document",
+                        url="https://docs.google.com/document/d/1abc123def456/edit",
+                        iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+                        isFolder=False,
+                        _credentials_id=None,
+                    ),
+                ),
+            ],
+            test_mock={
+                "_read_document": lambda *args, **kwargs: {
+                    "text": "Hello World\nThis is a test document.\n",
+                    "title": "Test Document",
+                },
+            },
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: GoogleCredentials, **kwargs
+    ) -> BlockOutput:
+        if not input_data.document:
+            yield "error", "No document selected"
+            return
+
+        validation_error = _validate_document_file(input_data.document)
+        if validation_error:
+            yield "error", validation_error
+            return
+
+        try:
+            service = _build_docs_service(credentials)
+            result = await asyncio.to_thread(
+                self._read_document,
+                service,
+                input_data.document.id,
+            )
+            yield "text", result["text"]
+            yield "title", result["title"]
+            yield "document", _make_document_output(input_data.document)
+        except Exception as e:
+            yield "error", f"Failed to read document: {str(e)}"
+
+    def _read_document(self, service, document_id: str) -> dict:
+        doc = service.documents().get(documentId=document_id).execute()
+        title = doc.get("title", "")
+        body = doc.get("body", {})
+        content = body.get("content", [])
+        text = _extract_text_from_content(content)
+        return {"text": text, "title": title}
+
+
+class GoogleDocsCreateBlock(Block):
+    """Create a new Google Doc."""
+
+    class Input(BlockSchemaInput):
+        credentials: GoogleCredentialsInput = GoogleCredentialsField(
+            ["https://www.googleapis.com/auth/drive.file"]
+        )
+        title: str = SchemaField(description="Title for the new document")
+        initial_content: str = SchemaField(
+            default="",
+            description="Optional initial text content",
+        )
+
+    class Output(BlockSchemaOutput):
+        document: GoogleDriveFile = SchemaField(description="The created document")
+        document_id: str = SchemaField(description="ID of the created document")
+        document_url: str = SchemaField(description="URL to open the document")
+        error: str = SchemaField(description="Error message if creation failed")
+
+    def __init__(self):
+        super().__init__(
+            id="d430d941-cf81-4f84-8b19-2e3f670b2fca",
+            description="Create a new Google Doc",
+            categories={BlockCategory.DATA},
+            input_schema=GoogleDocsCreateBlock.Input,
+            output_schema=GoogleDocsCreateBlock.Output,
+            disabled=GOOGLE_DOCS_DISABLED,
+            test_input={
+                "credentials": TEST_CREDENTIALS_INPUT,
+                "title": "My New Document",
+                "initial_content": "Hello, this is the initial content.",
+            },
+            test_credentials=TEST_CREDENTIALS,
+            test_output=[
+                (
+                    "document",
+                    GoogleDriveFile(
+                        id="new_doc_123",
+                        name="My New Document",
+                        mimeType="application/vnd.google-apps.document",
+                        url="https://docs.google.com/document/d/new_doc_123/edit",
+                        iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+                        isFolder=False,
+                        _credentials_id=TEST_CREDENTIALS_INPUT["id"],
+                    ),
+                ),
+                ("document_id", "new_doc_123"),
+                ("document_url", "https://docs.google.com/document/d/new_doc_123/edit"),
+            ],
+            test_mock={
+                "_create_document": lambda *args, **kwargs: {
+                    "document_id": "new_doc_123",
+                    "document_url": "https://docs.google.com/document/d/new_doc_123/edit",
+                    "title": "My New Document",
+                },
+            },
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: GoogleCredentials, **kwargs
+    ) -> BlockOutput:
+        if not input_data.title:
+            yield "error", "Document title is required"
+            return
+
+        try:
+            drive_service = _build_drive_service(credentials)
+            docs_service = _build_docs_service(credentials)
+            result = await asyncio.to_thread(
+                self._create_document,
+                drive_service,
+                docs_service,
+                input_data.title,
+                input_data.initial_content,
+            )
+            doc_id = result["document_id"]
+            doc_url = result["document_url"]
+            yield "document", GoogleDriveFile(
+                id=doc_id,
+                name=input_data.title,
+                mimeType="application/vnd.google-apps.document",
+                url=doc_url,
+                iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+                isFolder=False,
+                _credentials_id=input_data.credentials.id,
+            )
+            yield "document_id", doc_id
+            yield "document_url", doc_url
+        except Exception as e:
+            yield "error", f"Failed to create document: {str(e)}"
+
+    def _create_document(
+        self, drive_service, docs_service, title: str, initial_content: str
+    ) -> dict:
+        # Create the document
+        file_metadata = {
+            "name": title,
+            "mimeType": "application/vnd.google-apps.document",
+        }
+        result = drive_service.files().create(body=file_metadata).execute()
+        document_id = result.get("id")
+        document_url = f"https://docs.google.com/document/d/{document_id}/edit"
+
+        # Add initial content if provided
+        if initial_content:
+            requests = [
+                {
+                    "insertText": {
+                        "location": {"index": 1},
+                        "text": initial_content,
+                    }
+                }
+            ]
+            docs_service.documents().batchUpdate(
+                documentId=document_id, body={"requests": requests}
+            ).execute()
+
+        return {
+            "document_id": document_id,
+            "document_url": document_url,
+            "title": title,
+        }
+
+
+class GoogleDocsAppendPlainTextBlock(Block):
+    """Append plain text to the end of a Google Doc (no formatting)."""
+
+    class Input(BlockSchemaInput):
+        document: GoogleDriveFile = GoogleDriveFileField(
+            title="Document",
+            description="Select a Google Doc to append to",
+            allowed_views=["DOCUMENTS"],
+        )
+        text: str = SchemaField(
+            description="Plain text to append (no formatting applied)"
+        )
+        add_newline: bool = SchemaField(
+            default=True,
+            description="Add a newline before the appended text",
+        )
+
+    class Output(BlockSchemaOutput):
+        result: dict = SchemaField(description="Result of the append operation")
+        document: GoogleDriveFile = SchemaField(description="The document for chaining")
+        error: str = SchemaField(description="Error message if append failed")
+
+    def __init__(self):
+        super().__init__(
+            id="ddc29d9f-78dc-4682-8787-c8a76f00cf38",
+            description="Append plain text to the end of a Google Doc (no formatting applied)",
+            categories={BlockCategory.DATA},
+            input_schema=GoogleDocsAppendPlainTextBlock.Input,
+            output_schema=GoogleDocsAppendPlainTextBlock.Output,
+            disabled=GOOGLE_DOCS_DISABLED,
+            test_input={
+                "document": {
+                    "id": "1abc123def456",
+                    "name": "Test Document",
+                    "mimeType": "application/vnd.google-apps.document",
+                },
+                "text": "This is appended text.",
+            },
+            test_credentials=TEST_CREDENTIALS,
+            test_output=[
+                ("result", {"success": True, "characters_added": 23}),
+                (
+                    "document",
+                    GoogleDriveFile(
+                        id="1abc123def456",
+                        name="Test Document",
+                        mimeType="application/vnd.google-apps.document",
+                        url="https://docs.google.com/document/d/1abc123def456/edit",
+                        iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+                        isFolder=False,
+                        _credentials_id=None,
+                    ),
+                ),
+            ],
+            test_mock={
+                "_append_text": lambda *args, **kwargs: {
+                    "success": True,
+                    "characters_added": 23,
+                },
+            },
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: GoogleCredentials, **kwargs
+    ) -> BlockOutput:
+        if not input_data.document:
+            yield "error", "No document selected"
+            return
+
+        validation_error = _validate_document_file(input_data.document)
+        if validation_error:
+            yield "error", validation_error
+            return
+
+        try:
+            service = _build_docs_service(credentials)
+            result = await asyncio.to_thread(
+                self._append_text,
+                service,
+                input_data.document.id,
+                input_data.text,
+                input_data.add_newline,
+            )
+            yield "result", result
+            yield "document", _make_document_output(input_data.document)
+        except Exception as e:
+            yield "error", f"Failed to append text: {str(e)}"
+
+    def _append_text(
+        self, service, document_id: str, text: str, add_newline: bool
+    ) -> dict:
+        end_index = _get_document_end_index(service, document_id)
+        text_to_insert = ("\n" if add_newline else "") + text
+
+        requests = [
+            {
+                "insertText": {
+                    "location": {"index": end_index},
+                    "text": text_to_insert,
+                }
+            }
+        ]
+
+        service.documents().batchUpdate(
+            documentId=document_id, body={"requests": requests}
+        ).execute()
+
+        return {"success": True, "characters_added": len(text_to_insert)}
+
+
+class GoogleDocsInsertPlainTextBlock(Block):
+    """Insert plain text at a specific position in a Google Doc (no formatting)."""
+
+    class Input(BlockSchemaInput):
+        document: GoogleDriveFile = GoogleDriveFileField(
+            title="Document",
+            description="Select a Google Doc to insert into",
+            allowed_views=["DOCUMENTS"],
+        )
+        text: str = SchemaField(
+            description="Plain text to insert (no formatting applied)"
+        )
+        index: int = SchemaField(
+            default=1,
+            description="Position index to insert at (1 = start of document)",
+        )
+
+    class Output(BlockSchemaOutput):
+        result: dict = SchemaField(description="Result of the insert operation")
+        document: GoogleDriveFile = SchemaField(description="The document for chaining")
+        error: str = SchemaField(description="Error message if insert failed")
+
+    def __init__(self):
+        super().__init__(
+            id="0443fdbc-ebb0-49a4-a3ea-6ace9c14da22",
+            description="Insert plain text at a specific position in a Google Doc (no formatting applied)",
+            categories={BlockCategory.DATA},
+            input_schema=GoogleDocsInsertPlainTextBlock.Input,
+            output_schema=GoogleDocsInsertPlainTextBlock.Output,
+            disabled=GOOGLE_DOCS_DISABLED,
+            test_input={
+                "document": {
+                    "id": "1abc123def456",
+                    "name": "Test Document",
+                    "mimeType": "application/vnd.google-apps.document",
+                },
+                "text": "Inserted text here. ",
+                "index": 1,
+            },
+            test_credentials=TEST_CREDENTIALS,
+            test_output=[
+                ("result", {"success": True, "characters_inserted": 20}),
+                (
+                    "document",
+                    GoogleDriveFile(
+                        id="1abc123def456",
+                        name="Test Document",
+                        mimeType="application/vnd.google-apps.document",
+                        url="https://docs.google.com/document/d/1abc123def456/edit",
+                        iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+                        isFolder=False,
+                        _credentials_id=None,
+                    ),
+                ),
+            ],
+            test_mock={
+                "_insert_text": lambda *args, **kwargs: {
+                    "success": True,
+                    "characters_inserted": 20,
+                },
+            },
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: GoogleCredentials, **kwargs
+    ) -> BlockOutput:
+        if not input_data.document:
+            yield "error", "No document selected"
+            return
+
+        validation_error = _validate_document_file(input_data.document)
+        if validation_error:
+            yield "error", validation_error
+            return
+
+        try:
+            service = _build_docs_service(credentials)
+            result = await asyncio.to_thread(
+                self._insert_text,
+                service,
+                input_data.document.id,
+                input_data.text,
+                input_data.index,
+            )
+            yield "result", result
+            yield "document", _make_document_output(input_data.document)
+        except Exception as e:
+            yield "error", f"Failed to insert text: {str(e)}"
+
+    def _insert_text(self, service, document_id: str, text: str, index: int) -> dict:
+        requests = [
+            {
+                "insertText": {
+                    "location": {"index": max(1, index)},
+                    "text": text,
+                }
+            }
+        ]
+
+        service.documents().batchUpdate(
+            documentId=document_id, body={"requests": requests}
+        ).execute()
+
+        return {"success": True, "characters_inserted": len(text)}
+
+
+class GoogleDocsFindReplacePlainTextBlock(Block):
+    """Find and replace plain text in a Google Doc (no formatting applied to replacement)."""
+
+    class Input(BlockSchemaInput):
+        document: GoogleDriveFile = GoogleDriveFileField(
+            title="Document",
+            description="Select a Google Doc",
+            allowed_views=["DOCUMENTS"],
+        )
+        find_text: str = SchemaField(description="Plain text to find")
+        replace_text: str = SchemaField(
+            description="Plain text to replace with (no formatting applied)"
+        )
+        match_case: bool = SchemaField(
+            default=False,
+            description="Match case when finding text",
+        )
+
+    class Output(BlockSchemaOutput):
+        result: dict = SchemaField(description="Result with replacement count")
+        document: GoogleDriveFile = SchemaField(description="The document for chaining")
+        error: str = SchemaField(description="Error message if operation failed")
+
+    def __init__(self):
+        super().__init__(
+            id="e5046ee2-b094-418e-a25e-c0f90c91721c",
+            description="Find and replace plain text in a Google Doc (no formatting applied to replacement)",
+            categories={BlockCategory.DATA},
+            input_schema=GoogleDocsFindReplacePlainTextBlock.Input,
+            output_schema=GoogleDocsFindReplacePlainTextBlock.Output,
+            disabled=GOOGLE_DOCS_DISABLED,
+            test_input={
+                "document": {
+                    "id": "1abc123def456",
+                    "name": "Test Document",
+                    "mimeType": "application/vnd.google-apps.document",
+                },
+                "find_text": "old text",
+                "replace_text": "new text",
+            },
+            test_credentials=TEST_CREDENTIALS,
+            test_output=[
+                ("result", {"success": True, "replacements_made": 3}),
+                (
+                    "document",
+                    GoogleDriveFile(
+                        id="1abc123def456",
+                        name="Test Document",
+                        mimeType="application/vnd.google-apps.document",
+                        url="https://docs.google.com/document/d/1abc123def456/edit",
+                        iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+                        isFolder=False,
+                        _credentials_id=None,
+                    ),
+                ),
+            ],
+            test_mock={
+                "_find_replace": lambda *args, **kwargs: {
+                    "success": True,
+                    "replacements_made": 3,
+                },
+            },
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: GoogleCredentials, **kwargs
+    ) -> BlockOutput:
+        if not input_data.document:
+            yield "error", "No document selected"
+            return
+
+        validation_error = _validate_document_file(input_data.document)
+        if validation_error:
+            yield "error", validation_error
+            return
+
+        try:
+            service = _build_docs_service(credentials)
+            result = await asyncio.to_thread(
+                self._find_replace,
+                service,
+                input_data.document.id,
+                input_data.find_text,
+                input_data.replace_text,
+                input_data.match_case,
+            )
+            yield "result", result
+            yield "document", _make_document_output(input_data.document)
+        except Exception as e:
+            yield "error", f"Failed to find/replace: {str(e)}"
+
+    def _find_replace(
+        self,
+        service,
+        document_id: str,
+        find_text: str,
+        replace_text: str,
+        match_case: bool,
+    ) -> dict:
+        requests = [
+            {
+                "replaceAllText": {
+                    "containsText": {
+                        "text": find_text,
+                        "matchCase": match_case,
+                    },
+                    "replaceText": replace_text,
+                }
+            }
+        ]
+
+        response = (
+            service.documents()
+            .batchUpdate(documentId=document_id, body={"requests": requests})
+            .execute()
+        )
+
+        # Get replacement count from response
+        replies = response.get("replies", [])
+        replacements = 0
+        if replies and "replaceAllText" in replies[0]:
+            replacements = replies[0]["replaceAllText"].get("occurrencesChanged", 0)
+
+        return {"success": True, "replacements_made": replacements}
+
+
+class GoogleDocsGetMetadataBlock(Block):
+    """Get metadata about a Google Doc."""
+
+    class Input(BlockSchemaInput):
+        document: GoogleDriveFile = GoogleDriveFileField(
+            title="Document",
+            description="Select a Google Doc",
+            allowed_views=["DOCUMENTS"],
+        )
+
+    class Output(BlockSchemaOutput):
+        title: str = SchemaField(description="Document title")
+        document_id: str = SchemaField(description="Document ID")
+        revision_id: str = SchemaField(description="Current revision ID")
+        document_url: str = SchemaField(description="URL to open the document")
+        document: GoogleDriveFile = SchemaField(description="The document for chaining")
+        error: str = SchemaField(description="Error message if operation failed")
+
+    def __init__(self):
+        super().__init__(
+            id="100bc806-acbf-4dc5-a3a2-998026b96516",
+            description="Get metadata about a Google Doc",
+            categories={BlockCategory.DATA},
+            input_schema=GoogleDocsGetMetadataBlock.Input,
+            output_schema=GoogleDocsGetMetadataBlock.Output,
+            disabled=GOOGLE_DOCS_DISABLED,
+            test_input={
+                "document": {
+                    "id": "1abc123def456",
+                    "name": "Test Document",
+                    "mimeType": "application/vnd.google-apps.document",
+                },
+            },
+            test_credentials=TEST_CREDENTIALS,
+            test_output=[
+                ("title", "Test Document"),
+                ("document_id", "1abc123def456"),
+                ("revision_id", "rev_123"),
+                (
+                    "document_url",
+                    "https://docs.google.com/document/d/1abc123def456/edit",
+                ),
+                (
+                    "document",
+                    GoogleDriveFile(
+                        id="1abc123def456",
+                        name="Test Document",
+                        mimeType="application/vnd.google-apps.document",
+                        url="https://docs.google.com/document/d/1abc123def456/edit",
+                        iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+                        isFolder=False,
+                        _credentials_id=None,
+                    ),
+                ),
+            ],
+            test_mock={
+                "_get_metadata": lambda *args, **kwargs: {
+                    "title": "Test Document",
+                    "revision_id": "rev_123",
+                },
+            },
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: GoogleCredentials, **kwargs
+    ) -> BlockOutput:
+        if not input_data.document:
+            yield "error", "No document selected"
+            return
+
+        validation_error = _validate_document_file(input_data.document)
+        if validation_error:
+            yield "error", validation_error
+            return
+
+        try:
+            service = _build_docs_service(credentials)
+            result = await asyncio.to_thread(
+                self._get_metadata,
+                service,
+                input_data.document.id,
+            )
+            yield "title", result["title"]
+            yield "document_id", input_data.document.id
+            yield "revision_id", result["revision_id"]
+            yield "document_url", f"https://docs.google.com/document/d/{input_data.document.id}/edit"
+            yield "document", _make_document_output(input_data.document)
+        except Exception as e:
+            yield "error", f"Failed to get metadata: {str(e)}"
+
+    def _get_metadata(self, service, document_id: str) -> dict:
+        doc = service.documents().get(documentId=document_id).execute()
+        return {
+            "title": doc.get("title", ""),
+            "revision_id": doc.get("revisionId", ""),
+        }
+
+
+class GoogleDocsInsertTableBlock(Block):
+    """Insert a table into a Google Doc, optionally with content."""
+
+    class Input(BlockSchemaInput):
+        document: GoogleDriveFile = GoogleDriveFileField(
+            title="Document",
+            description="Select a Google Doc",
+            allowed_views=["DOCUMENTS"],
+        )
+        rows: int = SchemaField(
+            default=3,
+            description="Number of rows (ignored if content provided)",
+        )
+        columns: int = SchemaField(
+            default=3,
+            description="Number of columns (ignored if content provided)",
+        )
+        content: list[list[str]] = SchemaField(
+            default=[],
+            description="Optional 2D array of cell content, e.g. [['Header1', 'Header2'], ['Row1Col1', 'Row1Col2']]. If provided, rows/columns are derived from this.",
+        )
+        index: int = SchemaField(
+            default=0,
+            description="Position to insert table (0 = end of document)",
+        )
+        format_as_markdown: bool = SchemaField(
+            default=False,
+            description="Format cell content as Markdown (headers, bold, links, etc.)",
+        )
+
+    class Output(BlockSchemaOutput):
+        result: dict = SchemaField(description="Result of table insertion")
+        document: GoogleDriveFile = SchemaField(description="The document for chaining")
+        error: str = SchemaField(description="Error message if operation failed")
+
+    def __init__(self):
+        super().__init__(
+            id="e104b3ab-dfef-45f9-9702-14e950988f53",
+            description="Insert a table into a Google Doc, optionally with content and Markdown formatting",
+            categories={BlockCategory.DATA},
+            input_schema=GoogleDocsInsertTableBlock.Input,
+            output_schema=GoogleDocsInsertTableBlock.Output,
+            disabled=GOOGLE_DOCS_DISABLED,
+            test_input={
+                "document": {
+                    "id": "1abc123def456",
+                    "name": "Test Document",
+                    "mimeType": "application/vnd.google-apps.document",
+                },
+                "content": [["Header1", "Header2"], ["Row1Col1", "Row1Col2"]],
+            },
+            test_credentials=TEST_CREDENTIALS,
+            test_output=[
+                (
+                    "result",
+                    {
+                        "success": True,
+                        "rows": 2,
+                        "columns": 2,
+                        "cells_populated": 4,
+                        "cells_found": 4,
+                    },
+                ),
+                (
+                    "document",
+                    GoogleDriveFile(
+                        id="1abc123def456",
+                        name="Test Document",
+                        mimeType="application/vnd.google-apps.document",
+                        url="https://docs.google.com/document/d/1abc123def456/edit",
+                        iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+                        isFolder=False,
+                        _credentials_id=None,
+                    ),
+                ),
+            ],
+            test_mock={
+                "_insert_table": lambda *args, **kwargs: {
+                    "success": True,
+                    "rows": 2,
+                    "columns": 2,
+                    "cells_populated": 4,
+                    "cells_found": 4,
+                },
+            },
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: GoogleCredentials, **kwargs
+    ) -> BlockOutput:
+        if not input_data.document:
+            yield "error", "No document selected"
+            return
+
+        validation_error = _validate_document_file(input_data.document)
+        if validation_error:
+            yield "error", validation_error
+            return
+
+        # Determine rows/columns from content if provided
+        content = input_data.content
+
+        # Check if content is valid:
+        # 1. Has at least one row with at least one cell (even if empty string)
+        # 2. Has at least one non-empty cell value
+        has_valid_structure = bool(content and any(len(row) > 0 for row in content))
+        has_content = has_valid_structure and any(
+            cell for row in content for cell in row
+        )
+
+        if has_content:
+            # Use content dimensions - filter out empty rows for row count,
+            # use max column count across all rows
+            rows = len(content)
+            columns = max(len(row) for row in content)
+        else:
+            # No valid content - use explicit rows/columns, clear content
+            rows = input_data.rows
+            columns = input_data.columns
+            content = []  # Clear so we skip population step
+
+        try:
+            service = _build_docs_service(credentials)
+            result = await asyncio.to_thread(
+                self._insert_table,
+                service,
+                input_data.document.id,
+                rows,
+                columns,
+                input_data.index,
+                content,
+                input_data.format_as_markdown,
+            )
+            yield "result", result
+            yield "document", _make_document_output(input_data.document)
+        except Exception as e:
+            yield "error", f"Failed to insert table: {str(e)}"
+
+    def _insert_table(
+        self,
+        service,
+        document_id: str,
+        rows: int,
+        columns: int,
+        index: int,
+        content: list[list[str]],
+        format_as_markdown: bool,
+    ) -> dict:
+        # If index is 0, insert at end of document
+        if index == 0:
+            index = _get_document_end_index(service, document_id)
+
+        # Insert the empty table structure
+        requests = [
+            {
+                "insertTable": {
+                    "rows": rows,
+                    "columns": columns,
+                    "location": {"index": index},
+                }
+            }
+        ]
+
+        service.documents().batchUpdate(
+            documentId=document_id, body={"requests": requests}
+        ).execute()
+
+        # If no content provided, we're done
+        if not content:
+            return {"success": True, "rows": rows, "columns": columns}
+
+        # Fetch the document to find cell indexes
+        doc = service.documents().get(documentId=document_id).execute()
+        body_content = doc.get("body", {}).get("content", [])
+
+        # Find all tables and pick the one we just inserted
+        # (the one with highest startIndex that's >= our insert point, or the last one if inserted at end)
+        tables_found = []
+        for element in body_content:
+            if "table" in element:
+                tables_found.append(element)
+
+        if not tables_found:
+            return {
+                "success": True,
+                "rows": rows,
+                "columns": columns,
+                "warning": "Table created but could not find it to populate",
+            }
+
+        # If we inserted at end (index was high), take the last table
+        # Otherwise, take the first table at or after our insert index
+        table_element = None
+        # Heuristic: rows * columns * 2 estimates the minimum index space a table
+        # occupies (each cell has at least a start index and structural overhead).
+        # This helps determine if our insert point was near the document end.
+        estimated_table_size = rows * columns * 2
+        if (
+            index
+            >= _get_document_end_index(service, document_id) - estimated_table_size
+        ):
+            # Likely inserted at end - use last table
+            table_element = tables_found[-1]
+        else:
+            for tbl in tables_found:
+                if tbl.get("startIndex", 0) >= index:
+                    table_element = tbl
+                    break
+            if not table_element:
+                table_element = tables_found[-1]
+
+        # Extract cell start indexes from the table structure
+        # Structure: table -> tableRows -> tableCells -> content[0] -> startIndex
+        cell_positions: list[tuple[int, int, int]] = []  # (row, col, start_index)
+        table_data = table_element.get("table", {})
+        table_rows_list = table_data.get("tableRows", [])
+
+        for row_idx, table_row in enumerate(table_rows_list):
+            cells = table_row.get("tableCells", [])
+            for col_idx, cell in enumerate(cells):
+                cell_content = cell.get("content", [])
+                if cell_content:
+                    # Get the start index of the first element in the cell
+                    first_element = cell_content[0]
+                    cell_start = first_element.get("startIndex")
+                    if cell_start is not None:
+                        cell_positions.append((row_idx, col_idx, cell_start))
+
+        if not cell_positions:
+            return {
+                "success": True,
+                "rows": rows,
+                "columns": columns,
+                "warning": f"Table created but could not extract cell positions. Table has {len(table_rows_list)} rows.",
+            }
+
+        # Sort by index descending so we can insert in reverse order
+        # (inserting later content first preserves earlier indexes)
+        cell_positions.sort(key=lambda x: x[2], reverse=True)
+
+        cells_populated = 0
+
+        if format_as_markdown:
+            # Markdown formatting: process each cell individually since
+            # gravitas-md2gdocs requests may have complex interdependencies
+            for row_idx, col_idx, cell_start in cell_positions:
+                if row_idx < len(content) and col_idx < len(content[row_idx]):
+                    cell_text = content[row_idx][col_idx]
+                    if not cell_text:
+                        continue
+                    md_requests = to_requests(cell_text, start_index=cell_start)
+                    if md_requests:
+                        service.documents().batchUpdate(
+                            documentId=document_id, body={"requests": md_requests}
+                        ).execute()
+                        cells_populated += 1
+        else:
+            # Plain text: batch all insertions into a single API call
+            # Cells are sorted by index descending, so earlier requests
+            # don't affect indices of later ones
+            all_text_requests = []
+            for row_idx, col_idx, cell_start in cell_positions:
+                if row_idx < len(content) and col_idx < len(content[row_idx]):
+                    cell_text = content[row_idx][col_idx]
+                    if not cell_text:
+                        continue
+                    all_text_requests.append(
+                        {
+                            "insertText": {
+                                "location": {"index": cell_start},
+                                "text": cell_text,
+                            }
+                        }
+                    )
+                    cells_populated += 1
+
+            if all_text_requests:
+                service.documents().batchUpdate(
+                    documentId=document_id, body={"requests": all_text_requests}
+                ).execute()
+
+        return {
+            "success": True,
+            "rows": rows,
+            "columns": columns,
+            "cells_populated": cells_populated,
+            "cells_found": len(cell_positions),
+        }
+
+
+class GoogleDocsInsertPageBreakBlock(Block):
+    """Insert a page break into a Google Doc."""
+
+    class Input(BlockSchemaInput):
+        document: GoogleDriveFile = GoogleDriveFileField(
+            title="Document",
+            description="Select a Google Doc",
+            allowed_views=["DOCUMENTS"],
+        )
+        index: int = SchemaField(
+            default=0,
+            description="Position to insert page break (0 = end of document)",
+        )
+
+    class Output(BlockSchemaOutput):
+        result: dict = SchemaField(description="Result of page break insertion")
+        document: GoogleDriveFile = SchemaField(description="The document for chaining")
+        error: str = SchemaField(description="Error message if operation failed")
+
+    def __init__(self):
+        super().__init__(
+            id="f199e674-803b-4ee8-8bbf-172e6512190b",
+            description="Insert a page break into a Google Doc",
+            categories={BlockCategory.DATA},
+            input_schema=GoogleDocsInsertPageBreakBlock.Input,
+            output_schema=GoogleDocsInsertPageBreakBlock.Output,
+            disabled=GOOGLE_DOCS_DISABLED,
+            test_input={
+                "document": {
+                    "id": "1abc123def456",
+                    "name": "Test Document",
+                    "mimeType": "application/vnd.google-apps.document",
+                },
+            },
+            test_credentials=TEST_CREDENTIALS,
+            test_output=[
+                ("result", {"success": True}),
+                (
+                    "document",
+                    GoogleDriveFile(
+                        id="1abc123def456",
+                        name="Test Document",
+                        mimeType="application/vnd.google-apps.document",
+                        url="https://docs.google.com/document/d/1abc123def456/edit",
+                        iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+                        isFolder=False,
+                        _credentials_id=None,
+                    ),
+                ),
+            ],
+            test_mock={
+                "_insert_page_break": lambda *args, **kwargs: {"success": True},
+            },
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: GoogleCredentials, **kwargs
+    ) -> BlockOutput:
+        if not input_data.document:
+            yield "error", "No document selected"
+            return
+
+        validation_error = _validate_document_file(input_data.document)
+        if validation_error:
+            yield "error", validation_error
+            return
+
+        try:
+            service = _build_docs_service(credentials)
+            result = await asyncio.to_thread(
+                self._insert_page_break,
+                service,
+                input_data.document.id,
+                input_data.index,
+            )
+            yield "result", result
+            yield "document", _make_document_output(input_data.document)
+        except Exception as e:
+            yield "error", f"Failed to insert page break: {str(e)}"
+
+    def _insert_page_break(self, service, document_id: str, index: int) -> dict:
+        if index == 0:
+            index = _get_document_end_index(service, document_id)
+
+        requests = [
+            {
+                "insertPageBreak": {
+                    "location": {"index": index},
+                }
+            }
+        ]
+
+        service.documents().batchUpdate(
+            documentId=document_id, body={"requests": requests}
+        ).execute()
+
+        return {"success": True}
+
+
+class GoogleDocsDeleteContentBlock(Block):
+    """Delete a range of content from a Google Doc."""
+
+    class Input(BlockSchemaInput):
+        document: GoogleDriveFile = GoogleDriveFileField(
+            title="Document",
+            description="Select a Google Doc",
+            allowed_views=["DOCUMENTS"],
+        )
+        start_index: int = SchemaField(
+            description="Start index of content to delete (must be >= 1, as index 0 is a section break)",
+            ge=1,
+        )
+        end_index: int = SchemaField(description="End index of content to delete")
+
+    class Output(BlockSchemaOutput):
+        result: dict = SchemaField(description="Result of delete operation")
+        document: GoogleDriveFile = SchemaField(description="The document for chaining")
+        error: str = SchemaField(description="Error message if operation failed")
+
+    def __init__(self):
+        super().__init__(
+            id="5f9f9fa4-9071-4028-97c2-9d15fb422dc5",
+            description="Delete a range of content from a Google Doc",
+            categories={BlockCategory.DATA},
+            input_schema=GoogleDocsDeleteContentBlock.Input,
+            output_schema=GoogleDocsDeleteContentBlock.Output,
+            disabled=GOOGLE_DOCS_DISABLED,
+            test_input={
+                "document": {
+                    "id": "1abc123def456",
+                    "name": "Test Document",
+                    "mimeType": "application/vnd.google-apps.document",
+                },
+                "start_index": 10,
+                "end_index": 50,
+            },
+            test_credentials=TEST_CREDENTIALS,
+            test_output=[
+                ("result", {"success": True, "characters_deleted": 40}),
+                (
+                    "document",
+                    GoogleDriveFile(
+                        id="1abc123def456",
+                        name="Test Document",
+                        mimeType="application/vnd.google-apps.document",
+                        url="https://docs.google.com/document/d/1abc123def456/edit",
+                        iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+                        isFolder=False,
+                        _credentials_id=None,
+                    ),
+                ),
+            ],
+            test_mock={
+                "_delete_content": lambda *args, **kwargs: {
+                    "success": True,
+                    "characters_deleted": 40,
+                },
+            },
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: GoogleCredentials, **kwargs
+    ) -> BlockOutput:
+        if not input_data.document:
+            yield "error", "No document selected"
+            return
+
+        validation_error = _validate_document_file(input_data.document)
+        if validation_error:
+            yield "error", validation_error
+            return
+
+        if input_data.start_index >= input_data.end_index:
+            yield "error", "Start index must be less than end index"
+            return
+
+        try:
+            service = _build_docs_service(credentials)
+            result = await asyncio.to_thread(
+                self._delete_content,
+                service,
+                input_data.document.id,
+                input_data.start_index,
+                input_data.end_index,
+            )
+            yield "result", result
+            yield "document", _make_document_output(input_data.document)
+        except Exception as e:
+            yield "error", f"Failed to delete content: {str(e)}"
+
+    def _delete_content(
+        self, service, document_id: str, start_index: int, end_index: int
+    ) -> dict:
+        requests = [
+            {
+                "deleteContentRange": {
+                    "range": {
+                        "startIndex": start_index,
+                        "endIndex": end_index,
+                    }
+                }
+            }
+        ]
+
+        service.documents().batchUpdate(
+            documentId=document_id, body={"requests": requests}
+        ).execute()
+
+        return {"success": True, "characters_deleted": end_index - start_index}
+
+
+class ExportFormat(str, Enum):
+    PDF = "application/pdf"
+    DOCX = "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
+    ODT = "application/vnd.oasis.opendocument.text"
+    TXT = "text/plain"
+    HTML = "text/html"
+    EPUB = "application/epub+zip"
+    RTF = "application/rtf"
+
+
+class GoogleDocsExportBlock(Block):
+    """Export a Google Doc to various formats."""
+
+    class Input(BlockSchemaInput):
+        document: GoogleDriveFile = GoogleDriveFileField(
+            title="Document",
+            description="Select a Google Doc to export",
+            allowed_views=["DOCUMENTS"],
+        )
+        format: ExportFormat = SchemaField(
+            default=ExportFormat.PDF,
+            description="Export format",
+        )
+
+    class Output(BlockSchemaOutput):
+        content: str = SchemaField(
+            description="Exported content (base64 encoded for binary formats)"
+        )
+        mime_type: str = SchemaField(description="MIME type of exported content")
+        document: GoogleDriveFile = SchemaField(description="The document for chaining")
+        error: str = SchemaField(description="Error message if export failed")
+
+    def __init__(self):
+        super().__init__(
+            id="e32d5642-7b51-458c-bd83-75ff96fec299",
+            description="Export a Google Doc to PDF, Word, text, or other formats",
+            categories={BlockCategory.DATA},
+            input_schema=GoogleDocsExportBlock.Input,
+            output_schema=GoogleDocsExportBlock.Output,
+            disabled=GOOGLE_DOCS_DISABLED,
+            test_input={
+                "document": {
+                    "id": "1abc123def456",
+                    "name": "Test Document",
+                    "mimeType": "application/vnd.google-apps.document",
+                },
+                "format": ExportFormat.TXT,
+            },
+            test_credentials=TEST_CREDENTIALS,
+            test_output=[
+                ("content", "This is the document content as plain text."),
+                ("mime_type", "text/plain"),
+                (
+                    "document",
+                    GoogleDriveFile(
+                        id="1abc123def456",
+                        name="Test Document",
+                        mimeType="application/vnd.google-apps.document",
+                        url="https://docs.google.com/document/d/1abc123def456/edit",
+                        iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+                        isFolder=False,
+                        _credentials_id=None,
+                    ),
+                ),
+            ],
+            test_mock={
+                "_export_document": lambda *args, **kwargs: {
+                    "content": "This is the document content as plain text.",
+                    "mime_type": "text/plain",
+                },
+            },
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: GoogleCredentials, **kwargs
+    ) -> BlockOutput:
+        if not input_data.document:
+            yield "error", "No document selected"
+            return
+
+        validation_error = _validate_document_file(input_data.document)
+        if validation_error:
+            yield "error", validation_error
+            return
+
+        try:
+            drive_service = _build_drive_service(credentials)
+            result = await asyncio.to_thread(
+                self._export_document,
+                drive_service,
+                input_data.document.id,
+                input_data.format.value,
+            )
+            yield "content", result["content"]
+            yield "mime_type", result["mime_type"]
+            yield "document", _make_document_output(input_data.document)
+        except Exception as e:
+            yield "error", f"Failed to export document: {str(e)}"
+
+    def _export_document(self, service, document_id: str, mime_type: str) -> dict:
+        import base64
+
+        response = (
+            service.files().export(fileId=document_id, mimeType=mime_type).execute()
+        )
+
+        # For text formats, return as string; for binary, base64 encode
+        if mime_type in ["text/plain", "text/html"]:
+            content = (
+                response.decode("utf-8") if isinstance(response, bytes) else response
+            )
+        else:
+            content = base64.b64encode(response).decode("utf-8")
+
+        return {"content": content, "mime_type": mime_type}
+
+
+class GoogleDocsFormatTextBlock(Block):
+    """Apply formatting to text in a Google Doc."""
+
+    class Input(BlockSchemaInput):
+        document: GoogleDriveFile = GoogleDriveFileField(
+            title="Document",
+            description="Select a Google Doc",
+            allowed_views=["DOCUMENTS"],
+        )
+        start_index: int = SchemaField(
+            description="Start index of text to format (must be >= 1, as index 0 is a section break)",
+            ge=1,
+        )
+        end_index: int = SchemaField(description="End index of text to format")
+        bold: bool = SchemaField(
+            default=False,
+            description="Make text bold",
+        )
+        italic: bool = SchemaField(
+            default=False,
+            description="Make text italic",
+        )
+        underline: bool = SchemaField(
+            default=False,
+            description="Underline text",
+        )
+        font_size: int = SchemaField(
+            default=0,
+            description="Font size in points (0 = no change)",
+        )
+        foreground_color: str = SchemaField(
+            default="",
+            description="Text color as hex (e.g., #FF0000 for red)",
+        )
+
+    class Output(BlockSchemaOutput):
+        result: dict = SchemaField(description="Result of format operation")
+        document: GoogleDriveFile = SchemaField(description="The document for chaining")
+        error: str = SchemaField(description="Error message if operation failed")
+
+    def __init__(self):
+        super().__init__(
+            id="04c38a7e-7ee5-4e1a-86c1-9727123577bc",
+            description="Apply formatting (bold, italic, color, etc.) to text in a Google Doc",
+            categories={BlockCategory.DATA},
+            input_schema=GoogleDocsFormatTextBlock.Input,
+            output_schema=GoogleDocsFormatTextBlock.Output,
+            disabled=GOOGLE_DOCS_DISABLED,
+            test_input={
+                "document": {
+                    "id": "1abc123def456",
+                    "name": "Test Document",
+                    "mimeType": "application/vnd.google-apps.document",
+                },
+                "start_index": 2,
+                "end_index": 10,
+                "bold": True,
+            },
+            test_credentials=TEST_CREDENTIALS,
+            test_output=[
+                ("result", {"success": True}),
+                (
+                    "document",
+                    GoogleDriveFile(
+                        id="1abc123def456",
+                        name="Test Document",
+                        mimeType="application/vnd.google-apps.document",
+                        url="https://docs.google.com/document/d/1abc123def456/edit",
+                        iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+                        isFolder=False,
+                        _credentials_id=None,
+                    ),
+                ),
+            ],
+            test_mock={
+                "_format_text": lambda *args, **kwargs: {"success": True},
+            },
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: GoogleCredentials, **kwargs
+    ) -> BlockOutput:
+        if not input_data.document:
+            yield "error", "No document selected"
+            return
+
+        validation_error = _validate_document_file(input_data.document)
+        if validation_error:
+            yield "error", validation_error
+            return
+
+        if input_data.start_index >= input_data.end_index:
+            yield "error", "Start index must be less than end index"
+            return
+
+        try:
+            service = _build_docs_service(credentials)
+            result = await asyncio.to_thread(
+                self._format_text,
+                service,
+                input_data.document.id,
+                input_data.start_index,
+                input_data.end_index,
+                input_data.bold,
+                input_data.italic,
+                input_data.underline,
+                input_data.font_size,
+                input_data.foreground_color,
+            )
+            yield "result", result
+            yield "document", _make_document_output(input_data.document)
+        except Exception as e:
+            yield "error", f"Failed to format text: {str(e)}"
+
+    def _format_text(
+        self,
+        service,
+        document_id: str,
+        start_index: int,
+        end_index: int,
+        bold: bool,
+        italic: bool,
+        underline: bool,
+        font_size: int,
+        foreground_color: str,
+    ) -> dict:
+        text_style: dict[str, Any] = {}
+        fields = []
+
+        if bold:
+            text_style["bold"] = True
+            fields.append("bold")
+        if italic:
+            text_style["italic"] = True
+            fields.append("italic")
+        if underline:
+            text_style["underline"] = True
+            fields.append("underline")
+        if font_size > 0:
+            text_style["fontSize"] = {"magnitude": font_size, "unit": "PT"}
+            fields.append("fontSize")
+        if foreground_color:
+            rgb = _parse_hex_color_to_rgb_floats(foreground_color)
+            if rgb is None:
+                if not fields:
+                    return {
+                        "success": False,
+                        "message": (
+                            f"Invalid foreground_color: {foreground_color!r}. "
+                            "Expected hex like #RGB or #RRGGBB."
+                        ),
+                    }
+                # Ignore invalid color, but still apply other formatting.
+                # This avoids failing the whole operation due to a single bad value.
+                warning = (
+                    f"Ignored invalid foreground_color: {foreground_color!r}. "
+                    "Expected hex like #RGB or #RRGGBB."
+                )
+            else:
+                r, g, b = rgb
+                text_style["foregroundColor"] = {
+                    "color": {"rgbColor": {"red": r, "green": g, "blue": b}}
+                }
+                fields.append("foregroundColor")
+                warning = None
+        else:
+            warning = None
+
+        if not fields:
+            return {"success": True, "message": "No formatting options specified"}
+
+        requests = [
+            {
+                "updateTextStyle": {
+                    "range": {"startIndex": start_index, "endIndex": end_index},
+                    "textStyle": text_style,
+                    "fields": ",".join(fields),
+                }
+            }
+        ]
+
+        service.documents().batchUpdate(
+            documentId=document_id, body={"requests": requests}
+        ).execute()
+
+        if warning:
+            return {"success": True, "warning": warning}
+        return {"success": True}
+
+
+class GoogleDocsShareBlock(Block):
+    """Share a Google Doc with specific users."""
+
+    class Input(BlockSchemaInput):
+        document: GoogleDriveFile = GoogleDriveFileField(
+            title="Document",
+            description="Select a Google Doc to share",
+            allowed_views=["DOCUMENTS"],
+        )
+        email: str = SchemaField(
+            default="",
+            description="Email address to share with. Leave empty for link sharing.",
+        )
+        role: ShareRole = SchemaField(
+            default=ShareRole.READER,
+            description="Permission role for the user",
+        )
+        send_notification: bool = SchemaField(
+            default=True,
+            description="Send notification email to the user",
+        )
+        message: str = SchemaField(
+            default="",
+            description="Optional message to include in notification email",
+        )
+
+    class Output(BlockSchemaOutput):
+        result: dict = SchemaField(description="Result of the share operation")
+        share_link: str = SchemaField(description="Link to the document")
+        document: GoogleDriveFile = SchemaField(description="The document for chaining")
+        error: str = SchemaField(description="Error message if share failed")
+
+    def __init__(self):
+        super().__init__(
+            id="4e7ec771-4cc8-4eb7-ae3d-46377ecdb5d2",
+            description="Share a Google Doc with specific users",
+            categories={BlockCategory.DATA},
+            input_schema=GoogleDocsShareBlock.Input,
+            output_schema=GoogleDocsShareBlock.Output,
+            disabled=GOOGLE_DOCS_DISABLED,
+            test_input={
+                "document": {
+                    "id": "1abc123def456",
+                    "name": "Test Document",
+                    "mimeType": "application/vnd.google-apps.document",
+                },
+                "email": "test@example.com",
+                "role": "reader",
+            },
+            test_credentials=TEST_CREDENTIALS,
+            test_output=[
+                ("result", {"success": True}),
+                ("share_link", "https://docs.google.com/document/d/1abc123def456/edit"),
+                (
+                    "document",
+                    GoogleDriveFile(
+                        id="1abc123def456",
+                        name="Test Document",
+                        mimeType="application/vnd.google-apps.document",
+                        url="https://docs.google.com/document/d/1abc123def456/edit",
+                        iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+                        isFolder=False,
+                        _credentials_id=None,
+                    ),
+                ),
+            ],
+            test_mock={
+                "_share_document": lambda *args, **kwargs: {
+                    "success": True,
+                    "share_link": "https://docs.google.com/document/d/1abc123def456/edit",
+                },
+            },
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: GoogleCredentials, **kwargs
+    ) -> BlockOutput:
+        if not input_data.document:
+            yield "error", "No document selected"
+            return
+
+        validation_error = _validate_document_file(input_data.document)
+        if validation_error:
+            yield "error", validation_error
+            return
+
+        try:
+            service = _build_drive_service(credentials)
+            result = await asyncio.to_thread(
+                self._share_document,
+                service,
+                input_data.document.id,
+                input_data.email,
+                input_data.role,
+                input_data.send_notification,
+                input_data.message,
+            )
+            yield "result", {"success": True}
+            yield "share_link", result["share_link"]
+            yield "document", _make_document_output(input_data.document)
+        except Exception as e:
+            yield "error", f"Failed to share document: {str(e)}"
+
+    def _share_document(
+        self,
+        service,
+        document_id: str,
+        email: str,
+        role: ShareRole,
+        send_notification: bool,
+        message: str,
+    ) -> dict:
+        share_link = f"https://docs.google.com/document/d/{document_id}/edit"
+
+        if email:
+            # Share with specific user
+            permission = {"type": "user", "role": role.value, "emailAddress": email}
+
+            kwargs: dict[str, Any] = {
+                "fileId": document_id,
+                "body": permission,
+                "sendNotificationEmail": send_notification,
+            }
+            if message:
+                kwargs["emailMessage"] = message
+
+            service.permissions().create(**kwargs).execute()
+        else:
+            # Create "anyone with the link" permission for link sharing
+            permission = {"type": "anyone", "role": role.value}
+            service.permissions().create(
+                fileId=document_id,
+                body=permission,
+            ).execute()
+
+        return {"success": True, "share_link": share_link}
+
+
+class GoogleDocsSetPublicAccessBlock(Block):
+    """Make a Google Doc publicly accessible or private."""
+
+    class Input(BlockSchemaInput):
+        document: GoogleDriveFile = GoogleDriveFileField(
+            title="Document",
+            description="Select a Google Doc",
+            allowed_views=["DOCUMENTS"],
+        )
+        public: bool = SchemaField(
+            default=True,
+            description="True to make public, False to make private",
+        )
+        role: PublicAccessRole = SchemaField(
+            default=PublicAccessRole.READER,
+            description="Permission role for public access",
+        )
+
+    class Output(BlockSchemaOutput):
+        result: dict = SchemaField(description="Result of the operation")
+        share_link: str = SchemaField(description="Link to the document")
+        document: GoogleDriveFile = SchemaField(description="The document for chaining")
+        error: str = SchemaField(description="Error message if operation failed")
+
+    def __init__(self):
+        super().__init__(
+            id="d104f6e1-80af-4fe9-b5a1-3cab20081b6c",
+            description="Make a Google Doc public or private",
+            categories={BlockCategory.DATA},
+            input_schema=GoogleDocsSetPublicAccessBlock.Input,
+            output_schema=GoogleDocsSetPublicAccessBlock.Output,
+            disabled=GOOGLE_DOCS_DISABLED,
+            test_input={
+                "document": {
+                    "id": "1abc123def456",
+                    "name": "Test Document",
+                    "mimeType": "application/vnd.google-apps.document",
+                },
+                "public": True,
+            },
+            test_credentials=TEST_CREDENTIALS,
+            test_output=[
+                ("result", {"success": True, "is_public": True}),
+                (
+                    "share_link",
+                    "https://docs.google.com/document/d/1abc123def456/edit?usp=sharing",
+                ),
+                (
+                    "document",
+                    GoogleDriveFile(
+                        id="1abc123def456",
+                        name="Test Document",
+                        mimeType="application/vnd.google-apps.document",
+                        url="https://docs.google.com/document/d/1abc123def456/edit",
+                        iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+                        isFolder=False,
+                        _credentials_id=None,
+                    ),
+                ),
+            ],
+            test_mock={
+                "_set_public_access": lambda *args, **kwargs: {
+                    "success": True,
+                    "is_public": True,
+                    "share_link": "https://docs.google.com/document/d/1abc123def456/edit?usp=sharing",
+                },
+            },
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: GoogleCredentials, **kwargs
+    ) -> BlockOutput:
+        if not input_data.document:
+            yield "error", "No document selected"
+            return
+
+        validation_error = _validate_document_file(input_data.document)
+        if validation_error:
+            yield "error", validation_error
+            return
+
+        try:
+            service = _build_drive_service(credentials)
+            result = await asyncio.to_thread(
+                self._set_public_access,
+                service,
+                input_data.document.id,
+                input_data.public,
+                input_data.role,
+            )
+            yield "result", {"success": True, "is_public": result["is_public"]}
+            yield "share_link", result["share_link"]
+            yield "document", _make_document_output(input_data.document)
+        except Exception as e:
+            yield "error", f"Failed to set public access: {str(e)}"
+
+    def _set_public_access(
+        self, service, document_id: str, public: bool, role: PublicAccessRole
+    ) -> dict:
+        share_link = f"https://docs.google.com/document/d/{document_id}/edit"
+
+        if public:
+            permission = {"type": "anyone", "role": role.value}
+            service.permissions().create(fileId=document_id, body=permission).execute()
+            share_link += "?usp=sharing"
+        else:
+            permissions = service.permissions().list(fileId=document_id).execute()
+            for perm in permissions.get("permissions", []):
+                if perm.get("type") == "anyone":
+                    service.permissions().delete(
+                        fileId=document_id, permissionId=perm["id"]
+                    ).execute()
+
+        return {"success": True, "is_public": public, "share_link": share_link}
+
+
+# ============ Markdown Blocks ============
+
+
+class GoogleDocsAppendMarkdownBlock(Block):
+    """Append Markdown content to the end of a Google Doc.
+
+    Converts Markdown to Google Docs formatting, supporting:
+    - Headers (H1-H6)
+    - Bold, italic, strikethrough
+    - Inline code and code blocks
+    - Links
+    - Bulleted and numbered lists
+    - Blockquotes
+
+    Perfect for AI agents that generate Markdown output.
+    """
+
+    class Input(BlockSchemaInput):
+        document: GoogleDriveFile = GoogleDriveFileField(
+            title="Document",
+            description="Select a Google Doc to append to",
+            allowed_views=["DOCUMENTS"],
+        )
+        markdown: str = SchemaField(
+            description="Markdown content to append to the document"
+        )
+        add_newline: bool = SchemaField(
+            default=True,
+            description="Add a newline before the appended content",
+        )
+
+    class Output(BlockSchemaOutput):
+        result: dict = SchemaField(description="Result of the append operation")
+        document: GoogleDriveFile = SchemaField(description="The document for chaining")
+        error: str = SchemaField(description="Error message if operation failed")
+
+    def __init__(self):
+        super().__init__(
+            id="60854b69-ecbd-4188-bd89-f7966a4d3b38",
+            description="Append Markdown content to the end of a Google Doc with full formatting - ideal for LLM/AI output",
+            categories={BlockCategory.DATA},
+            input_schema=GoogleDocsAppendMarkdownBlock.Input,
+            output_schema=GoogleDocsAppendMarkdownBlock.Output,
+            disabled=GOOGLE_DOCS_DISABLED,
+            test_input={
+                "document": {
+                    "id": "1abc123def456",
+                    "name": "Test Document",
+                    "mimeType": "application/vnd.google-apps.document",
+                },
+                "markdown": "# Hello World\n\nThis is **bold** and *italic* text.\n\n- Item 1\n- Item 2",
+            },
+            test_credentials=TEST_CREDENTIALS,
+            test_output=[
+                ("result", {"success": True, "requests_count": 5}),
+                (
+                    "document",
+                    GoogleDriveFile(
+                        id="1abc123def456",
+                        name="Test Document",
+                        mimeType="application/vnd.google-apps.document",
+                        url="https://docs.google.com/document/d/1abc123def456/edit",
+                        iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+                        isFolder=False,
+                        _credentials_id=None,
+                    ),
+                ),
+            ],
+            test_mock={
+                "_append_markdown": lambda *args, **kwargs: {
+                    "success": True,
+                    "requests_count": 5,
+                },
+            },
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: GoogleCredentials, **kwargs
+    ) -> BlockOutput:
+        if not input_data.document:
+            yield "error", "No document selected"
+            return
+
+        validation_error = _validate_document_file(input_data.document)
+        if validation_error:
+            yield "error", validation_error
+            return
+
+        if not input_data.markdown:
+            yield "error", "No markdown content provided"
+            return
+
+        try:
+            service = _build_docs_service(credentials)
+            result = await asyncio.to_thread(
+                self._append_markdown,
+                service,
+                input_data.document.id,
+                input_data.markdown,
+                input_data.add_newline,
+            )
+            yield "result", result
+            yield "document", _make_document_output(input_data.document)
+        except Exception as e:
+            yield "error", f"Failed to append markdown: {str(e)}"
+
+    def _append_markdown(
+        self,
+        service,
+        document_id: str,
+        markdown: str,
+        add_newline: bool,
+    ) -> dict:
+        end_index = _get_document_end_index(service, document_id)
+
+        # Optionally add a newline before the content
+        if add_newline and end_index > 1:
+            newline_requests = [
+                {"insertText": {"location": {"index": end_index}, "text": "\n"}}
+            ]
+            service.documents().batchUpdate(
+                documentId=document_id, body={"requests": newline_requests}
+            ).execute()
+            end_index += 1
+
+        # Convert markdown to Google Docs requests
+        requests = to_requests(markdown, start_index=end_index)
+
+        if requests:
+            service.documents().batchUpdate(
+                documentId=document_id, body={"requests": requests}
+            ).execute()
+
+        return {"success": True, "requests_count": len(requests)}
+
+
+class GoogleDocsReplaceAllWithMarkdownBlock(Block):
+    """Replace entire Google Doc content with Markdown.
+
+    Clears the document and inserts formatted Markdown content.
+    Supports headers, bold, italic, lists, links, code blocks, etc.
+    """
+
+    class Input(BlockSchemaInput):
+        document: GoogleDriveFile = GoogleDriveFileField(
+            title="Document",
+            description="Select a Google Doc to replace content in",
+            allowed_views=["DOCUMENTS"],
+        )
+        markdown: str = SchemaField(
+            description="Markdown content to replace the document with"
+        )
+
+    class Output(BlockSchemaOutput):
+        result: dict = SchemaField(description="Result of the replace operation")
+        document: GoogleDriveFile = SchemaField(description="The document for chaining")
+        error: str = SchemaField(description="Error message if operation failed")
+
+    def __init__(self):
+        super().__init__(
+            id="b6cfb2de-5f0b-437c-b29d-45aebbda9c00",
+            description="Replace entire Google Doc content with formatted Markdown - ideal for LLM/AI output",
+            categories={BlockCategory.DATA},
+            input_schema=GoogleDocsReplaceAllWithMarkdownBlock.Input,
+            output_schema=GoogleDocsReplaceAllWithMarkdownBlock.Output,
+            disabled=GOOGLE_DOCS_DISABLED,
+            test_input={
+                "document": {
+                    "id": "1abc123def456",
+                    "name": "Test Document",
+                    "mimeType": "application/vnd.google-apps.document",
+                },
+                "markdown": "# New Document\n\nThis replaces everything.",
+            },
+            test_credentials=TEST_CREDENTIALS,
+            test_output=[
+                ("result", {"success": True, "requests_count": 3}),
+                (
+                    "document",
+                    GoogleDriveFile(
+                        id="1abc123def456",
+                        name="Test Document",
+                        mimeType="application/vnd.google-apps.document",
+                        url="https://docs.google.com/document/d/1abc123def456/edit",
+                        iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+                        isFolder=False,
+                        _credentials_id=None,
+                    ),
+                ),
+            ],
+            test_mock={
+                "_replace_all_with_markdown": lambda *args, **kwargs: {
+                    "success": True,
+                    "requests_count": 3,
+                },
+            },
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: GoogleCredentials, **kwargs
+    ) -> BlockOutput:
+        if not input_data.document:
+            yield "error", "No document selected"
+            return
+
+        validation_error = _validate_document_file(input_data.document)
+        if validation_error:
+            yield "error", validation_error
+            return
+
+        if not input_data.markdown:
+            yield "error", "No markdown content provided"
+            return
+
+        try:
+            service = _build_docs_service(credentials)
+            result = await asyncio.to_thread(
+                self._replace_all_with_markdown,
+                service,
+                input_data.document.id,
+                input_data.markdown,
+            )
+            yield "result", result
+            yield "document", _make_document_output(input_data.document)
+        except Exception as e:
+            yield "error", f"Failed to replace document with markdown: {str(e)}"
+
+    def _replace_all_with_markdown(
+        self,
+        service,
+        document_id: str,
+        markdown: str,
+    ) -> dict:
+        # Delete all existing content
+        doc_end = _get_document_end_index(service, document_id)
+        if doc_end > 1:
+            delete_requests = [
+                {
+                    "deleteContentRange": {
+                        "range": {"startIndex": 1, "endIndex": doc_end}
+                    }
+                }
+            ]
+            service.documents().batchUpdate(
+                documentId=document_id, body={"requests": delete_requests}
+            ).execute()
+
+        # Insert markdown at beginning
+        requests = to_requests(markdown, start_index=1)
+
+        if requests:
+            service.documents().batchUpdate(
+                documentId=document_id, body={"requests": requests}
+            ).execute()
+
+        return {"success": True, "requests_count": len(requests)}
+
+
+class GoogleDocsInsertMarkdownAtBlock(Block):
+    """Insert Markdown content at a specific position in a Google Doc.
+
+    Converts Markdown to Google Docs formatting and inserts at the specified index.
+    """
+
+    class Input(BlockSchemaInput):
+        document: GoogleDriveFile = GoogleDriveFileField(
+            title="Document",
+            description="Select a Google Doc to insert into",
+            allowed_views=["DOCUMENTS"],
+        )
+        markdown: str = SchemaField(description="Markdown content to insert")
+        index: int = SchemaField(
+            default=1,
+            description="Position index to insert at (1 = start of document)",
+            ge=1,
+        )
+
+    class Output(BlockSchemaOutput):
+        result: dict = SchemaField(description="Result of the insert operation")
+        document: GoogleDriveFile = SchemaField(description="The document for chaining")
+        error: str = SchemaField(description="Error message if operation failed")
+
+    def __init__(self):
+        super().__init__(
+            id="76e94b04-e02f-4981-8cb8-47ece1be18b4",
+            description="Insert formatted Markdown at a specific position in a Google Doc - ideal for LLM/AI output",
+            categories={BlockCategory.DATA},
+            input_schema=GoogleDocsInsertMarkdownAtBlock.Input,
+            output_schema=GoogleDocsInsertMarkdownAtBlock.Output,
+            disabled=GOOGLE_DOCS_DISABLED,
+            test_input={
+                "document": {
+                    "id": "1abc123def456",
+                    "name": "Test Document",
+                    "mimeType": "application/vnd.google-apps.document",
+                },
+                "markdown": "## Inserted Section\n\nThis was inserted.",
+                "index": 1,
+            },
+            test_credentials=TEST_CREDENTIALS,
+            test_output=[
+                ("result", {"success": True, "requests_count": 3}),
+                (
+                    "document",
+                    GoogleDriveFile(
+                        id="1abc123def456",
+                        name="Test Document",
+                        mimeType="application/vnd.google-apps.document",
+                        url="https://docs.google.com/document/d/1abc123def456/edit",
+                        iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+                        isFolder=False,
+                        _credentials_id=None,
+                    ),
+                ),
+            ],
+            test_mock={
+                "_insert_markdown_at": lambda *args, **kwargs: {
+                    "success": True,
+                    "requests_count": 3,
+                },
+            },
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: GoogleCredentials, **kwargs
+    ) -> BlockOutput:
+        if not input_data.document:
+            yield "error", "No document selected"
+            return
+
+        validation_error = _validate_document_file(input_data.document)
+        if validation_error:
+            yield "error", validation_error
+            return
+
+        if not input_data.markdown:
+            yield "error", "No markdown content provided"
+            return
+
+        try:
+            service = _build_docs_service(credentials)
+            result = await asyncio.to_thread(
+                self._insert_markdown_at,
+                service,
+                input_data.document.id,
+                input_data.markdown,
+                input_data.index,
+            )
+            yield "result", result
+            yield "document", _make_document_output(input_data.document)
+        except Exception as e:
+            yield "error", f"Failed to insert markdown: {str(e)}"
+
+    def _insert_markdown_at(
+        self,
+        service,
+        document_id: str,
+        markdown: str,
+        index: int,
+    ) -> dict:
+        requests = to_requests(markdown, start_index=index)
+
+        if requests:
+            service.documents().batchUpdate(
+                documentId=document_id, body={"requests": requests}
+            ).execute()
+
+        return {"success": True, "requests_count": len(requests)}
+
+
+class GoogleDocsReplaceRangeWithMarkdownBlock(Block):
+    """Replace a specific range (by index) in a Google Doc with Markdown.
+
+    Deletes content between start and end indices, then inserts formatted Markdown.
+    """
+
+    class Input(BlockSchemaInput):
+        document: GoogleDriveFile = GoogleDriveFileField(
+            title="Document",
+            description="Select a Google Doc",
+            allowed_views=["DOCUMENTS"],
+        )
+        markdown: str = SchemaField(
+            description="Markdown content to insert in place of the range"
+        )
+        start_index: int = SchemaField(
+            description="Start index of the range to replace (must be >= 1)",
+            ge=1,
+        )
+        end_index: int = SchemaField(
+            description="End index of the range to replace",
+        )
+
+    class Output(BlockSchemaOutput):
+        result: dict = SchemaField(description="Result of the replace operation")
+        document: GoogleDriveFile = SchemaField(description="The document for chaining")
+        error: str = SchemaField(description="Error message if operation failed")
+
+    def __init__(self):
+        super().__init__(
+            id="9e43a905-a918-4da0-8874-dfddd3c46953",
+            description="Replace a specific index range in a Google Doc with formatted Markdown - ideal for LLM/AI output",
+            categories={BlockCategory.DATA},
+            input_schema=GoogleDocsReplaceRangeWithMarkdownBlock.Input,
+            output_schema=GoogleDocsReplaceRangeWithMarkdownBlock.Output,
+            disabled=GOOGLE_DOCS_DISABLED,
+            test_input={
+                "document": {
+                    "id": "1abc123def456",
+                    "name": "Test Document",
+                    "mimeType": "application/vnd.google-apps.document",
+                },
+                "markdown": "**Replaced content**",
+                "start_index": 10,
+                "end_index": 50,
+            },
+            test_credentials=TEST_CREDENTIALS,
+            test_output=[
+                (
+                    "result",
+                    {"success": True, "requests_count": 2, "characters_deleted": 40},
+                ),
+                (
+                    "document",
+                    GoogleDriveFile(
+                        id="1abc123def456",
+                        name="Test Document",
+                        mimeType="application/vnd.google-apps.document",
+                        url="https://docs.google.com/document/d/1abc123def456/edit",
+                        iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+                        isFolder=False,
+                        _credentials_id=None,
+                    ),
+                ),
+            ],
+            test_mock={
+                "_replace_range_with_markdown": lambda *args, **kwargs: {
+                    "success": True,
+                    "requests_count": 2,
+                    "characters_deleted": 40,
+                },
+            },
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: GoogleCredentials, **kwargs
+    ) -> BlockOutput:
+        if not input_data.document:
+            yield "error", "No document selected"
+            return
+
+        validation_error = _validate_document_file(input_data.document)
+        if validation_error:
+            yield "error", validation_error
+            return
+
+        if not input_data.markdown:
+            yield "error", "No markdown content provided"
+            return
+
+        if input_data.start_index >= input_data.end_index:
+            yield "error", "Start index must be less than end index"
+            return
+
+        try:
+            service = _build_docs_service(credentials)
+            result = await asyncio.to_thread(
+                self._replace_range_with_markdown,
+                service,
+                input_data.document.id,
+                input_data.markdown,
+                input_data.start_index,
+                input_data.end_index,
+            )
+            yield "result", result
+            yield "document", _make_document_output(input_data.document)
+        except Exception as e:
+            yield "error", f"Failed to replace range with markdown: {str(e)}"
+
+    def _replace_range_with_markdown(
+        self,
+        service,
+        document_id: str,
+        markdown: str,
+        start_index: int,
+        end_index: int,
+    ) -> dict:
+        # Delete the range first
+        delete_requests = [
+            {
+                "deleteContentRange": {
+                    "range": {"startIndex": start_index, "endIndex": end_index}
+                }
+            }
+        ]
+        service.documents().batchUpdate(
+            documentId=document_id, body={"requests": delete_requests}
+        ).execute()
+
+        # Insert markdown at the start of the deleted range
+        requests = to_requests(markdown, start_index=start_index)
+
+        if requests:
+            service.documents().batchUpdate(
+                documentId=document_id, body={"requests": requests}
+            ).execute()
+
+        return {
+            "success": True,
+            "requests_count": len(requests),
+            "characters_deleted": end_index - start_index,
+        }
+
+
+class GoogleDocsReplaceContentWithMarkdownBlock(Block):
+    """Find text in a Google Doc and replace it with formatted Markdown.
+
+    Perfect for template workflows - use placeholders like {{INTRO}} or {{SUMMARY}}
+    and replace them with formatted Markdown content.
+    """
+
+    class Input(BlockSchemaInput):
+        document: GoogleDriveFile = GoogleDriveFileField(
+            title="Document",
+            description="Select a Google Doc",
+            allowed_views=["DOCUMENTS"],
+        )
+        find_text: str = SchemaField(
+            description="Text to find and replace (e.g., '{{PLACEHOLDER}}' or any text)"
+        )
+        markdown: str = SchemaField(
+            description="Markdown content to replace the found text with"
+        )
+        match_case: bool = SchemaField(
+            default=False,
+            description="Match case when finding text",
+        )
+
+    class Output(BlockSchemaOutput):
+        result: dict = SchemaField(description="Result with replacement count")
+        document: GoogleDriveFile = SchemaField(description="The document for chaining")
+        error: str = SchemaField(description="Error message if operation failed")
+
+    def __init__(self):
+        super().__init__(
+            id="2cc58467-90a9-4ef8-a7a7-700784f93b76",
+            description="Find text and replace it with formatted Markdown - ideal for LLM/AI output and templates",
+            categories={BlockCategory.DATA},
+            input_schema=GoogleDocsReplaceContentWithMarkdownBlock.Input,
+            output_schema=GoogleDocsReplaceContentWithMarkdownBlock.Output,
+            disabled=GOOGLE_DOCS_DISABLED,
+            test_input={
+                "document": {
+                    "id": "1abc123def456",
+                    "name": "Test Document",
+                    "mimeType": "application/vnd.google-apps.document",
+                },
+                "find_text": "{{PLACEHOLDER}}",
+                "markdown": "# Replaced Header\n\nThis is the **replacement** content.",
+            },
+            test_credentials=TEST_CREDENTIALS,
+            test_output=[
+                (
+                    "result",
+                    {"success": True, "replacements_made": 1, "requests_count": 4},
+                ),
+                (
+                    "document",
+                    GoogleDriveFile(
+                        id="1abc123def456",
+                        name="Test Document",
+                        mimeType="application/vnd.google-apps.document",
+                        url="https://docs.google.com/document/d/1abc123def456/edit",
+                        iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+                        isFolder=False,
+                        _credentials_id=None,
+                    ),
+                ),
+            ],
+            test_mock={
+                "_replace_content_with_markdown": lambda *args, **kwargs: {
+                    "success": True,
+                    "replacements_made": 1,
+                    "requests_count": 4,
+                },
+            },
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: GoogleCredentials, **kwargs
+    ) -> BlockOutput:
+        if not input_data.document:
+            yield "error", "No document selected"
+            return
+
+        validation_error = _validate_document_file(input_data.document)
+        if validation_error:
+            yield "error", validation_error
+            return
+
+        if not input_data.find_text:
+            yield "error", "No find text provided"
+            return
+
+        if not input_data.markdown:
+            yield "error", "No markdown content provided"
+            return
+
+        try:
+            service = _build_docs_service(credentials)
+            result = await asyncio.to_thread(
+                self._replace_content_with_markdown,
+                service,
+                input_data.document.id,
+                input_data.find_text,
+                input_data.markdown,
+                input_data.match_case,
+            )
+            yield "result", result
+            yield "document", _make_document_output(input_data.document)
+        except Exception as e:
+            yield "error", f"Failed to replace content with markdown: {str(e)}"
+
+    def _find_text_positions(
+        self, service, document_id: str, find_text: str, match_case: bool
+    ) -> list[tuple[int, int]]:
+        """Find all positions of the search text using actual document indices.
+
+        Iterates through document content and uses the real startIndex/endIndex
+        from text runs, rather than trying to map plain text offsets to indices.
+        """
+        doc = service.documents().get(documentId=document_id).execute()
+        body = doc.get("body", {})
+        content = body.get("content", [])
+
+        positions = []
+        search_text = find_text if match_case else find_text.lower()
+
+        def search_in_content(elements: list[dict]) -> None:
+            """Recursively search through content elements."""
+            for element in elements:
+                if "paragraph" in element:
+                    for text_elem in element["paragraph"].get("elements", []):
+                        if "textRun" in text_elem:
+                            text_run = text_elem["textRun"]
+                            text_content = text_run.get("content", "")
+                            start_index = text_elem.get("startIndex", 0)
+
+                            # Search within this text run
+                            text_to_search = (
+                                text_content if match_case else text_content.lower()
+                            )
+                            offset = 0
+                            while True:
+                                pos = text_to_search.find(search_text, offset)
+                                if pos == -1:
+                                    break
+                                # Calculate actual document indices
+                                doc_start = start_index + pos
+                                doc_end = doc_start + len(find_text)
+                                positions.append((doc_start, doc_end))
+                                offset = pos + 1
+
+                elif "table" in element:
+                    # Search within table cells
+                    for row in element["table"].get("tableRows", []):
+                        for cell in row.get("tableCells", []):
+                            search_in_content(cell.get("content", []))
+
+        search_in_content(content)
+        return positions
+
+    def _replace_content_with_markdown(
+        self,
+        service,
+        document_id: str,
+        find_text: str,
+        markdown: str,
+        match_case: bool,
+    ) -> dict:
+        # Find all positions of the text
+        positions = self._find_text_positions(
+            service, document_id, find_text, match_case
+        )
+
+        if not positions:
+            return {"success": True, "replacements_made": 0, "requests_count": 0}
+
+        total_requests = 0
+        replacements_made = 0
+
+        # Process in reverse order to maintain correct indices
+        for start_index, end_index in reversed(positions):
+            # Build combined request: delete first, then insert markdown
+            # Combining into single batchUpdate reduces API calls by half
+            combined_requests = [
+                {
+                    "deleteContentRange": {
+                        "range": {"startIndex": start_index, "endIndex": end_index}
+                    }
+                }
+            ]
+
+            # Get markdown insert requests
+            md_requests = to_requests(markdown, start_index=start_index)
+            if md_requests:
+                combined_requests.extend(md_requests)
+
+            # Execute delete + insert in single API call
+            service.documents().batchUpdate(
+                documentId=document_id, body={"requests": combined_requests}
+            ).execute()
+
+            total_requests += len(combined_requests)
+            replacements_made += 1
+
+        return {
+            "success": True,
+            "replacements_made": replacements_made,
+            "requests_count": total_requests,
+        }
+
+
+class GoogleDocsGetStructureBlock(Block):
+    """Get document structure with index positions for precise editing operations.
+
+    Returns content segments with their start/end indexes, making it easy to
+    target specific parts of the document for insertion, deletion, or formatting.
+    """
+
+    class Input(BlockSchemaInput):
+        document: GoogleDriveFile = GoogleDriveFileField(
+            title="Document",
+            description="Select a Google Doc to analyze",
+            allowed_views=["DOCUMENTS"],
+        )
+        detailed: bool = SchemaField(
+            default=False,
+            description="Return full hierarchical structure instead of flat segments",
+        )
+
+    class Output(BlockSchemaOutput):
+        segments: list[dict] = SchemaField(
+            description="Flat list of content segments with indexes (when detailed=False)"
+        )
+        structure: dict = SchemaField(
+            description="Full hierarchical document structure (when detailed=True)"
+        )
+        document: GoogleDriveFile = SchemaField(description="The document for chaining")
+        error: str = SchemaField(description="Error message if operation failed")
+
+    def __init__(self):
+        super().__init__(
+            id="e0561cc1-2154-4abf-bd06-79509348a18e",
+            description="Get document structure with index positions for precise editing operations",
+            categories={BlockCategory.DATA},
+            input_schema=GoogleDocsGetStructureBlock.Input,
+            output_schema=GoogleDocsGetStructureBlock.Output,
+            disabled=GOOGLE_DOCS_DISABLED,
+            test_input={
+                "document": {
+                    "id": "1abc123def456",
+                    "name": "Test Document",
+                    "mimeType": "application/vnd.google-apps.document",
+                },
+                "detailed": False,
+            },
+            test_credentials=TEST_CREDENTIALS,
+            test_output=[
+                (
+                    "segments",
+                    [
+                        {
+                            "type": "paragraph",
+                            "text": "Hello World",
+                            "start_index": 1,
+                            "end_index": 12,
+                        },
+                        {
+                            "type": "paragraph",
+                            "text": "Second paragraph",
+                            "start_index": 13,
+                            "end_index": 29,
+                        },
+                    ],
+                ),
+                ("structure", {}),
+                (
+                    "document",
+                    GoogleDriveFile(
+                        id="1abc123def456",
+                        name="Test Document",
+                        mimeType="application/vnd.google-apps.document",
+                        url="https://docs.google.com/document/d/1abc123def456/edit",
+                        iconUrl="https://www.gstatic.com/images/branding/product/1x/docs_48dp.png",
+                        isFolder=False,
+                        _credentials_id=None,
+                    ),
+                ),
+            ],
+            test_mock={
+                "_get_structure": lambda *args, **kwargs: {
+                    "segments": [
+                        {
+                            "type": "paragraph",
+                            "text": "Hello World",
+                            "start_index": 1,
+                            "end_index": 12,
+                        },
+                        {
+                            "type": "paragraph",
+                            "text": "Second paragraph",
+                            "start_index": 13,
+                            "end_index": 29,
+                        },
+                    ],
+                    "structure": {},
+                },
+            },
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: GoogleCredentials, **kwargs
+    ) -> BlockOutput:
+        if not input_data.document:
+            yield "error", "No document selected"
+            return
+
+        validation_error = _validate_document_file(input_data.document)
+        if validation_error:
+            yield "error", validation_error
+            return
+
+        try:
+            service = _build_docs_service(credentials)
+            result = await asyncio.to_thread(
+                self._get_structure,
+                service,
+                input_data.document.id,
+                input_data.detailed,
+            )
+            yield "segments", result["segments"]
+            yield "structure", result["structure"]
+            yield "document", _make_document_output(input_data.document)
+        except Exception as e:
+            yield "error", f"Failed to get document structure: {str(e)}"
+
+    def _extract_paragraph_text(self, paragraph: dict) -> str:
+        """Extract plain text from a paragraph element."""
+        text_parts = []
+        for elem in paragraph.get("elements", []):
+            if "textRun" in elem:
+                text_parts.append(elem["textRun"].get("content", ""))
+        return "".join(text_parts).rstrip("\n")
+
+    def _get_paragraph_style(self, paragraph: dict) -> dict:
+        """Get paragraph style information."""
+        style = paragraph.get("paragraphStyle", {})
+        named_style = style.get("namedStyleType", "NORMAL_TEXT")
+
+        # Map named styles to heading levels
+        heading_map = {
+            "HEADING_1": 1,
+            "HEADING_2": 2,
+            "HEADING_3": 3,
+            "HEADING_4": 4,
+            "HEADING_5": 5,
+            "HEADING_6": 6,
+        }
+
+        if named_style in heading_map:
+            return {"heading_level": heading_map[named_style]}
+        return {}
+
+    def _process_table_detailed(self, table_element: dict) -> dict:
+        """Process table for detailed hierarchical output."""
+        table = table_element.get("table", {})
+        table_rows = table.get("tableRows", [])
+
+        rows_data = []
+        for table_row in table_rows:
+            cells_data = []
+            for cell in table_row.get("tableCells", []):
+                cell_content = cell.get("content", [])
+                cell_text = ""
+                cell_start = None
+                cell_end = None
+
+                for content_elem in cell_content:
+                    if "paragraph" in content_elem:
+                        cell_text += self._extract_paragraph_text(
+                            content_elem["paragraph"]
+                        )
+                        if cell_start is None:
+                            cell_start = content_elem.get("startIndex")
+                        cell_end = content_elem.get("endIndex")
+
+                cells_data.append(
+                    {
+                        "text": cell_text,
+                        "start_index": cell_start,
+                        "end_index": cell_end,
+                    }
+                )
+            rows_data.append({"cells": cells_data})
+
+        return {
+            "type": "table",
+            "start_index": table_element.get("startIndex"),
+            "end_index": table_element.get("endIndex"),
+            "rows": rows_data,
+            "row_count": len(table_rows),
+            "column_count": table.get("columns", 0),
+        }
+
+    def _get_structure(self, service, document_id: str, detailed: bool) -> dict:
+        doc = service.documents().get(documentId=document_id).execute()
+        body = doc.get("body", {})
+        content = body.get("content", [])
+
+        segments: list[dict] = []
+        structure_body: list[dict] = []
+
+        for element in content:
+            start_index = element.get("startIndex")
+            end_index = element.get("endIndex")
+
+            if "paragraph" in element:
+                paragraph = element["paragraph"]
+                text = self._extract_paragraph_text(paragraph)
+                style_info = self._get_paragraph_style(paragraph)
+
+                # Determine segment type
+                if style_info.get("heading_level"):
+                    seg_type = "heading"
+                    segment = {
+                        "type": seg_type,
+                        "level": style_info["heading_level"],
+                        "text": text,
+                        "start_index": start_index,
+                        "end_index": end_index,
+                    }
+                else:
+                    seg_type = "paragraph"
+                    segment = {
+                        "type": seg_type,
+                        "text": text,
+                        "start_index": start_index,
+                        "end_index": end_index,
+                    }
+
+                # Skip empty paragraphs (just newlines)
+                if text.strip():
+                    segments.append(segment)
+
+                if detailed:
+                    detailed_seg = segment.copy()
+                    detailed_seg["style"] = paragraph.get("paragraphStyle", {})
+                    structure_body.append(detailed_seg)
+
+            elif "table" in element:
+                table = element.get("table", {})
+                table_rows = table.get("tableRows", [])
+
+                segment = {
+                    "type": "table",
+                    "rows": len(table_rows),
+                    "columns": table.get("columns", 0),
+                    "start_index": start_index,
+                    "end_index": end_index,
+                }
+                segments.append(segment)
+
+                if detailed:
+                    structure_body.append(self._process_table_detailed(element))
+
+            elif "sectionBreak" in element:
+                # Skip section breaks in simple mode, include in detailed
+                if detailed:
+                    structure_body.append(
+                        {
+                            "type": "section_break",
+                            "start_index": start_index,
+                            "end_index": end_index,
+                        }
+                    )
+
+            elif "tableOfContents" in element:
+                segment = {
+                    "type": "table_of_contents",
+                    "start_index": start_index,
+                    "end_index": end_index,
+                }
+                segments.append(segment)
+
+                if detailed:
+                    structure_body.append(segment)
+
+        result = {
+            "segments": segments,
+            "structure": {"body": structure_body} if detailed else {},
+        }
+
+        return result
diff --git a/autogpt_platform/backend/backend/blocks/google/gmail.py b/autogpt_platform/backend/backend/blocks/google/gmail.py
index bded362314..d1b3ecd4bf 100644
--- a/autogpt_platform/backend/backend/blocks/google/gmail.py
+++ b/autogpt_platform/backend/backend/blocks/google/gmail.py
@@ -353,7 +353,7 @@ class GmailReadBlock(GmailBase):
     def __init__(self):
         super().__init__(
             id="25310c70-b89b-43ba-b25c-4dfa7e2a481c",
-            description="This block reads emails from Gmail.",
+            description="A block that retrieves and reads emails from a Gmail account based on search criteria, returning detailed message information including subject, sender, body, and attachments.",
             categories={BlockCategory.COMMUNICATION},
             disabled=not GOOGLE_OAUTH_IS_CONFIGURED,
             input_schema=GmailReadBlock.Input,
@@ -743,7 +743,7 @@ class GmailListLabelsBlock(GmailBase):
     def __init__(self):
         super().__init__(
             id="3e1c2c1c-c689-4520-b956-1f3bf4e02bb7",
-            description="This block lists all labels in Gmail.",
+            description="A block that retrieves all labels (categories) from a Gmail account for organizing and categorizing emails.",
             categories={BlockCategory.COMMUNICATION},
             input_schema=GmailListLabelsBlock.Input,
             output_schema=GmailListLabelsBlock.Output,
@@ -807,7 +807,7 @@ class GmailAddLabelBlock(GmailBase):
     def __init__(self):
         super().__init__(
             id="f884b2fb-04f4-4265-9658-14f433926ac9",
-            description="This block adds a label to a Gmail message.",
+            description="A block that adds a label to a specific email message in Gmail, creating the label if it doesn't exist.",
             categories={BlockCategory.COMMUNICATION},
             input_schema=GmailAddLabelBlock.Input,
             output_schema=GmailAddLabelBlock.Output,
@@ -893,7 +893,7 @@ class GmailRemoveLabelBlock(GmailBase):
     def __init__(self):
         super().__init__(
             id="0afc0526-aba1-4b2b-888e-a22b7c3f359d",
-            description="This block removes a label from a Gmail message.",
+            description="A block that removes a label from a specific email message in a Gmail account.",
             categories={BlockCategory.COMMUNICATION},
             input_schema=GmailRemoveLabelBlock.Input,
             output_schema=GmailRemoveLabelBlock.Output,
@@ -961,7 +961,7 @@ class GmailGetThreadBlock(GmailBase):
     def __init__(self):
         super().__init__(
             id="21a79166-9df7-4b5f-9f36-96f639d86112",
-            description="Get a full Gmail thread by ID",
+            description="A block that retrieves an entire Gmail thread (email conversation) by ID, returning all messages with decoded bodies for reading complete conversations.",
             categories={BlockCategory.COMMUNICATION},
             input_schema=GmailGetThreadBlock.Input,
             output_schema=GmailGetThreadBlock.Output,
diff --git a/autogpt_platform/backend/backend/blocks/google/sheets.py b/autogpt_platform/backend/backend/blocks/google/sheets.py
index 7b9ba2161e..da541d3bf5 100644
--- a/autogpt_platform/backend/backend/blocks/google/sheets.py
+++ b/autogpt_platform/backend/backend/blocks/google/sheets.py
@@ -282,7 +282,7 @@ class GoogleSheetsReadBlock(Block):
     def __init__(self):
         super().__init__(
             id="5724e902-3635-47e9-a108-aaa0263a4988",
-            description="This block reads data from a Google Sheets spreadsheet.",
+            description="A block that reads data from a Google Sheets spreadsheet using A1 notation range selection.",
             categories={BlockCategory.DATA},
             input_schema=GoogleSheetsReadBlock.Input,
             output_schema=GoogleSheetsReadBlock.Output,
@@ -409,7 +409,7 @@ class GoogleSheetsWriteBlock(Block):
     def __init__(self):
         super().__init__(
             id="d9291e87-301d-47a8-91fe-907fb55460e5",
-            description="This block writes data to a Google Sheets spreadsheet.",
+            description="A block that writes data to a Google Sheets spreadsheet at a specified A1 notation range.",
             categories={BlockCategory.DATA},
             input_schema=GoogleSheetsWriteBlock.Input,
             output_schema=GoogleSheetsWriteBlock.Output,
diff --git a/autogpt_platform/backend/backend/blocks/helpers/review.py b/autogpt_platform/backend/backend/blocks/helpers/review.py
new file mode 100644
index 0000000000..f35397e6aa
--- /dev/null
+++ b/autogpt_platform/backend/backend/blocks/helpers/review.py
@@ -0,0 +1,184 @@
+"""
+Shared helpers for Human-In-The-Loop (HITL) review functionality.
+Used by both the dedicated HumanInTheLoopBlock and blocks that require human review.
+"""
+
+import logging
+from typing import Any, Optional
+
+from prisma.enums import ReviewStatus
+from pydantic import BaseModel
+
+from backend.data.execution import ExecutionContext, ExecutionStatus
+from backend.data.human_review import ReviewResult
+from backend.executor.manager import async_update_node_execution_status
+from backend.util.clients import get_database_manager_async_client
+
+logger = logging.getLogger(__name__)
+
+
+class ReviewDecision(BaseModel):
+    """Result of a review decision."""
+
+    should_proceed: bool
+    message: str
+    review_result: ReviewResult
+
+
+class HITLReviewHelper:
+    """Helper class for Human-In-The-Loop review operations."""
+
+    @staticmethod
+    async def get_or_create_human_review(**kwargs) -> Optional[ReviewResult]:
+        """Create or retrieve a human review from the database."""
+        return await get_database_manager_async_client().get_or_create_human_review(
+            **kwargs
+        )
+
+    @staticmethod
+    async def update_node_execution_status(**kwargs) -> None:
+        """Update the execution status of a node."""
+        await async_update_node_execution_status(
+            db_client=get_database_manager_async_client(), **kwargs
+        )
+
+    @staticmethod
+    async def update_review_processed_status(
+        node_exec_id: str, processed: bool
+    ) -> None:
+        """Update the processed status of a review."""
+        return await get_database_manager_async_client().update_review_processed_status(
+            node_exec_id, processed
+        )
+
+    @staticmethod
+    async def _handle_review_request(
+        input_data: Any,
+        user_id: str,
+        node_exec_id: str,
+        graph_exec_id: str,
+        graph_id: str,
+        graph_version: int,
+        execution_context: ExecutionContext,
+        block_name: str = "Block",
+        editable: bool = False,
+    ) -> Optional[ReviewResult]:
+        """
+        Handle a review request for a block that requires human review.
+
+        Args:
+            input_data: The input data to be reviewed
+            user_id: ID of the user requesting the review
+            node_exec_id: ID of the node execution
+            graph_exec_id: ID of the graph execution
+            graph_id: ID of the graph
+            graph_version: Version of the graph
+            execution_context: Current execution context
+            block_name: Name of the block requesting review
+            editable: Whether the reviewer can edit the data
+
+        Returns:
+            ReviewResult if review is complete, None if waiting for human input
+
+        Raises:
+            Exception: If review creation or status update fails
+        """
+        # Skip review if safe mode is disabled - return auto-approved result
+        if not execution_context.safe_mode:
+            logger.info(
+                f"Block {block_name} skipping review for node {node_exec_id} - safe mode disabled"
+            )
+            return ReviewResult(
+                data=input_data,
+                status=ReviewStatus.APPROVED,
+                message="Auto-approved (safe mode disabled)",
+                processed=True,
+                node_exec_id=node_exec_id,
+            )
+
+        result = await HITLReviewHelper.get_or_create_human_review(
+            user_id=user_id,
+            node_exec_id=node_exec_id,
+            graph_exec_id=graph_exec_id,
+            graph_id=graph_id,
+            graph_version=graph_version,
+            input_data=input_data,
+            message=f"Review required for {block_name} execution",
+            editable=editable,
+        )
+
+        if result is None:
+            logger.info(
+                f"Block {block_name} pausing execution for node {node_exec_id} - awaiting human review"
+            )
+            await HITLReviewHelper.update_node_execution_status(
+                exec_id=node_exec_id,
+                status=ExecutionStatus.REVIEW,
+            )
+            return None  # Signal that execution should pause
+
+        # Mark review as processed if not already done
+        if not result.processed:
+            await HITLReviewHelper.update_review_processed_status(
+                node_exec_id=node_exec_id, processed=True
+            )
+
+        return result
+
+    @staticmethod
+    async def handle_review_decision(
+        input_data: Any,
+        user_id: str,
+        node_exec_id: str,
+        graph_exec_id: str,
+        graph_id: str,
+        graph_version: int,
+        execution_context: ExecutionContext,
+        block_name: str = "Block",
+        editable: bool = False,
+    ) -> Optional[ReviewDecision]:
+        """
+        Handle a review request and return the decision in a single call.
+
+        Args:
+            input_data: The input data to be reviewed
+            user_id: ID of the user requesting the review
+            node_exec_id: ID of the node execution
+            graph_exec_id: ID of the graph execution
+            graph_id: ID of the graph
+            graph_version: Version of the graph
+            execution_context: Current execution context
+            block_name: Name of the block requesting review
+            editable: Whether the reviewer can edit the data
+
+        Returns:
+            ReviewDecision if review is complete (approved/rejected),
+            None if execution should pause (awaiting review)
+        """
+        review_result = await HITLReviewHelper._handle_review_request(
+            input_data=input_data,
+            user_id=user_id,
+            node_exec_id=node_exec_id,
+            graph_exec_id=graph_exec_id,
+            graph_id=graph_id,
+            graph_version=graph_version,
+            execution_context=execution_context,
+            block_name=block_name,
+            editable=editable,
+        )
+
+        if review_result is None:
+            # Still awaiting review - return None to pause execution
+            return None
+
+        # Review is complete, determine outcome
+        should_proceed = review_result.status == ReviewStatus.APPROVED
+        message = review_result.message or (
+            "Execution approved by reviewer"
+            if should_proceed
+            else "Execution rejected by reviewer"
+        )
+
+        return ReviewDecision(
+            should_proceed=should_proceed, message=message, review_result=review_result
+        )
diff --git a/autogpt_platform/backend/backend/blocks/human_in_the_loop.py b/autogpt_platform/backend/backend/blocks/human_in_the_loop.py
index 13c9fb31db..1e338816c8 100644
--- a/autogpt_platform/backend/backend/blocks/human_in_the_loop.py
+++ b/autogpt_platform/backend/backend/blocks/human_in_the_loop.py
@@ -3,6 +3,7 @@ from typing import Any
 
 from prisma.enums import ReviewStatus
 
+from backend.blocks.helpers.review import HITLReviewHelper
 from backend.data.block import (
     Block,
     BlockCategory,
@@ -11,11 +12,9 @@ from backend.data.block import (
     BlockSchemaOutput,
     BlockType,
 )
-from backend.data.execution import ExecutionContext, ExecutionStatus
+from backend.data.execution import ExecutionContext
 from backend.data.human_review import ReviewResult
 from backend.data.model import SchemaField
-from backend.executor.manager import async_update_node_execution_status
-from backend.util.clients import get_database_manager_async_client
 
 logger = logging.getLogger(__name__)
 
@@ -72,32 +71,26 @@ class HumanInTheLoopBlock(Block):
                 ("approved_data", {"name": "John Doe", "age": 30}),
             ],
             test_mock={
-                "get_or_create_human_review": lambda *_args, **_kwargs: ReviewResult(
-                    data={"name": "John Doe", "age": 30},
-                    status=ReviewStatus.APPROVED,
-                    message="",
-                    processed=False,
-                    node_exec_id="test-node-exec-id",
-                ),
-                "update_node_execution_status": lambda *_args, **_kwargs: None,
-                "update_review_processed_status": lambda *_args, **_kwargs: None,
+                "handle_review_decision": lambda **kwargs: type(
+                    "ReviewDecision",
+                    (),
+                    {
+                        "should_proceed": True,
+                        "message": "Test approval message",
+                        "review_result": ReviewResult(
+                            data={"name": "John Doe", "age": 30},
+                            status=ReviewStatus.APPROVED,
+                            message="",
+                            processed=False,
+                            node_exec_id="test-node-exec-id",
+                        ),
+                    },
+                )(),
             },
         )
 
-    async def get_or_create_human_review(self, **kwargs):
-        return await get_database_manager_async_client().get_or_create_human_review(
-            **kwargs
-        )
-
-    async def update_node_execution_status(self, **kwargs):
-        return await async_update_node_execution_status(
-            db_client=get_database_manager_async_client(), **kwargs
-        )
-
-    async def update_review_processed_status(self, node_exec_id: str, processed: bool):
-        return await get_database_manager_async_client().update_review_processed_status(
-            node_exec_id, processed
-        )
+    async def handle_review_decision(self, **kwargs):
+        return await HITLReviewHelper.handle_review_decision(**kwargs)
 
     async def run(
         self,
@@ -109,7 +102,7 @@ class HumanInTheLoopBlock(Block):
         graph_id: str,
         graph_version: int,
         execution_context: ExecutionContext,
-        **kwargs,
+        **_kwargs,
     ) -> BlockOutput:
         if not execution_context.safe_mode:
             logger.info(
@@ -119,48 +112,28 @@ class HumanInTheLoopBlock(Block):
             yield "review_message", "Auto-approved (safe mode disabled)"
             return
 
-        try:
-            result = await self.get_or_create_human_review(
-                user_id=user_id,
-                node_exec_id=node_exec_id,
-                graph_exec_id=graph_exec_id,
-                graph_id=graph_id,
-                graph_version=graph_version,
-                input_data=input_data.data,
-                message=input_data.name,
-                editable=input_data.editable,
-            )
-        except Exception as e:
-            logger.error(f"Error in HITL block for node {node_exec_id}: {str(e)}")
-            raise
+        decision = await self.handle_review_decision(
+            input_data=input_data.data,
+            user_id=user_id,
+            node_exec_id=node_exec_id,
+            graph_exec_id=graph_exec_id,
+            graph_id=graph_id,
+            graph_version=graph_version,
+            execution_context=execution_context,
+            block_name=self.name,
+            editable=input_data.editable,
+        )
 
-        if result is None:
-            logger.info(
-                f"HITL block pausing execution for node {node_exec_id} - awaiting human review"
-            )
-            try:
-                await self.update_node_execution_status(
-                    exec_id=node_exec_id,
-                    status=ExecutionStatus.REVIEW,
-                )
-                return
-            except Exception as e:
-                logger.error(
-                    f"Failed to update node status for HITL block {node_exec_id}: {str(e)}"
-                )
-                raise
+        if decision is None:
+            return
 
-        if not result.processed:
-            await self.update_review_processed_status(
-                node_exec_id=node_exec_id, processed=True
-            )
+        status = decision.review_result.status
+        if status == ReviewStatus.APPROVED:
+            yield "approved_data", decision.review_result.data
+        elif status == ReviewStatus.REJECTED:
+            yield "rejected_data", decision.review_result.data
+        else:
+            raise RuntimeError(f"Unexpected review status: {status}")
 
-            if result.status == ReviewStatus.APPROVED:
-                yield "approved_data", result.data
-                if result.message:
-                    yield "review_message", result.message
-
-            elif result.status == ReviewStatus.REJECTED:
-                yield "rejected_data", result.data
-                if result.message:
-                    yield "review_message", result.message
+        if decision.message:
+            yield "review_message", decision.message
diff --git a/autogpt_platform/backend/backend/blocks/io.py b/autogpt_platform/backend/backend/blocks/io.py
index 07f09eb349..6f8e62e339 100644
--- a/autogpt_platform/backend/backend/blocks/io.py
+++ b/autogpt_platform/backend/backend/blocks/io.py
@@ -76,7 +76,7 @@ class AgentInputBlock(Block):
         super().__init__(
             **{
                 "id": "c0a8e994-ebf1-4a9c-a4d8-89d09c86741b",
-                "description": "Base block for user inputs.",
+                "description": "A block that accepts and processes user input values within a workflow, supporting various input types and validation.",
                 "input_schema": AgentInputBlock.Input,
                 "output_schema": AgentInputBlock.Output,
                 "test_input": [
@@ -168,7 +168,7 @@ class AgentOutputBlock(Block):
     def __init__(self):
         super().__init__(
             id="363ae599-353e-4804-937e-b2ee3cef3da4",
-            description="Stores the output of the graph for users to see.",
+            description="A block that records and formats workflow results for display to users, with optional Jinja2 template formatting support.",
             input_schema=AgentOutputBlock.Input,
             output_schema=AgentOutputBlock.Output,
             test_input=[
diff --git a/autogpt_platform/backend/backend/blocks/llm.py b/autogpt_platform/backend/backend/blocks/llm.py
index 447c28783f..85e8fc36df 100644
--- a/autogpt_platform/backend/backend/blocks/llm.py
+++ b/autogpt_platform/backend/backend/blocks/llm.py
@@ -92,8 +92,9 @@ class LlmModel(str, Enum, metaclass=LlmModelMeta):
     O1 = "o1"
     O1_MINI = "o1-mini"
     # GPT-5 models
-    GPT5 = "gpt-5-2025-08-07"
+    GPT5_2 = "gpt-5.2-2025-12-11"
     GPT5_1 = "gpt-5.1-2025-11-13"
+    GPT5 = "gpt-5-2025-08-07"
     GPT5_MINI = "gpt-5-mini-2025-08-07"
     GPT5_NANO = "gpt-5-nano-2025-08-07"
     GPT5_CHAT = "gpt-5-chat-latest"
@@ -194,8 +195,9 @@ MODEL_METADATA = {
     LlmModel.O1: ModelMetadata("openai", 200000, 100000),  # o1-2024-12-17
     LlmModel.O1_MINI: ModelMetadata("openai", 128000, 65536),  # o1-mini-2024-09-12
     # GPT-5 models
-    LlmModel.GPT5: ModelMetadata("openai", 400000, 128000),
+    LlmModel.GPT5_2: ModelMetadata("openai", 400000, 128000),
     LlmModel.GPT5_1: ModelMetadata("openai", 400000, 128000),
+    LlmModel.GPT5: ModelMetadata("openai", 400000, 128000),
     LlmModel.GPT5_MINI: ModelMetadata("openai", 400000, 128000),
     LlmModel.GPT5_NANO: ModelMetadata("openai", 400000, 128000),
     LlmModel.GPT5_CHAT: ModelMetadata("openai", 400000, 16384),
@@ -303,6 +305,8 @@ MODEL_METADATA = {
     LlmModel.V0_1_0_MD: ModelMetadata("v0", 128000, 64000),
 }
 
+DEFAULT_LLM_MODEL = LlmModel.GPT5_2
+
 for model in LlmModel:
     if model not in MODEL_METADATA:
         raise ValueError(f"Missing MODEL_METADATA metadata for model: {model}")
@@ -790,7 +794,7 @@ class AIStructuredResponseGeneratorBlock(AIBlockBase):
         )
         model: LlmModel = SchemaField(
             title="LLM Model",
-            default=LlmModel.GPT4O,
+            default=DEFAULT_LLM_MODEL,
             description="The language model to use for answering the prompt.",
             advanced=False,
         )
@@ -850,12 +854,12 @@ class AIStructuredResponseGeneratorBlock(AIBlockBase):
     def __init__(self):
         super().__init__(
             id="ed55ac19-356e-4243-a6cb-bc599e9b716f",
-            description="Call a Large Language Model (LLM) to generate formatted object based on the given prompt.",
+            description="A block that generates structured JSON responses using a Large Language Model (LLM), with schema validation and format enforcement.",
             categories={BlockCategory.AI},
             input_schema=AIStructuredResponseGeneratorBlock.Input,
             output_schema=AIStructuredResponseGeneratorBlock.Output,
             test_input={
-                "model": LlmModel.GPT4O,
+                "model": DEFAULT_LLM_MODEL,
                 "credentials": TEST_CREDENTIALS_INPUT,
                 "expected_format": {
                     "key1": "value1",
@@ -1221,7 +1225,7 @@ class AITextGeneratorBlock(AIBlockBase):
         )
         model: LlmModel = SchemaField(
             title="LLM Model",
-            default=LlmModel.GPT4O,
+            default=DEFAULT_LLM_MODEL,
             description="The language model to use for answering the prompt.",
             advanced=False,
         )
@@ -1261,7 +1265,7 @@ class AITextGeneratorBlock(AIBlockBase):
     def __init__(self):
         super().__init__(
             id="1f292d4a-41a4-4977-9684-7c8d560b9f91",
-            description="Call a Large Language Model (LLM) to generate a string based on the given prompt.",
+            description="A block that produces text responses using a Large Language Model (LLM) based on customizable prompts and system instructions.",
             categories={BlockCategory.AI},
             input_schema=AITextGeneratorBlock.Input,
             output_schema=AITextGeneratorBlock.Output,
@@ -1317,7 +1321,7 @@ class AITextSummarizerBlock(AIBlockBase):
         )
         model: LlmModel = SchemaField(
             title="LLM Model",
-            default=LlmModel.GPT4O,
+            default=DEFAULT_LLM_MODEL,
             description="The language model to use for summarizing the text.",
         )
         focus: str = SchemaField(
@@ -1357,7 +1361,7 @@ class AITextSummarizerBlock(AIBlockBase):
     def __init__(self):
         super().__init__(
             id="a0a69be1-4528-491c-a85a-a4ab6873e3f0",
-            description="Utilize a Large Language Model (LLM) to summarize a long text.",
+            description="A block that summarizes long texts using a Large Language Model (LLM), with configurable focus topics and summary styles.",
             categories={BlockCategory.AI, BlockCategory.TEXT},
             input_schema=AITextSummarizerBlock.Input,
             output_schema=AITextSummarizerBlock.Output,
@@ -1534,7 +1538,7 @@ class AIConversationBlock(AIBlockBase):
         )
         model: LlmModel = SchemaField(
             title="LLM Model",
-            default=LlmModel.GPT4O,
+            default=DEFAULT_LLM_MODEL,
             description="The language model to use for the conversation.",
         )
         credentials: AICredentials = AICredentialsField()
@@ -1558,7 +1562,7 @@ class AIConversationBlock(AIBlockBase):
     def __init__(self):
         super().__init__(
             id="32a87eab-381e-4dd4-bdb8-4c47151be35a",
-            description="Advanced LLM call that takes a list of messages and sends them to the language model.",
+            description="A block that facilitates multi-turn conversations with a Large Language Model (LLM), maintaining context across message exchanges.",
             categories={BlockCategory.AI},
             input_schema=AIConversationBlock.Input,
             output_schema=AIConversationBlock.Output,
@@ -1572,7 +1576,7 @@ class AIConversationBlock(AIBlockBase):
                     },
                     {"role": "user", "content": "Where was it played?"},
                 ],
-                "model": LlmModel.GPT4O,
+                "model": DEFAULT_LLM_MODEL,
                 "credentials": TEST_CREDENTIALS_INPUT,
             },
             test_credentials=TEST_CREDENTIALS,
@@ -1635,7 +1639,7 @@ class AIListGeneratorBlock(AIBlockBase):
         )
         model: LlmModel = SchemaField(
             title="LLM Model",
-            default=LlmModel.GPT4O,
+            default=DEFAULT_LLM_MODEL,
             description="The language model to use for generating the list.",
             advanced=True,
         )
@@ -1678,7 +1682,7 @@ class AIListGeneratorBlock(AIBlockBase):
     def __init__(self):
         super().__init__(
             id="9c0b0450-d199-458b-a731-072189dd6593",
-            description="Generate a list of values based on the given prompt using a Large Language Model (LLM).",
+            description="A block that creates lists of items based on prompts using a Large Language Model (LLM), with optional source data for context.",
             categories={BlockCategory.AI, BlockCategory.TEXT},
             input_schema=AIListGeneratorBlock.Input,
             output_schema=AIListGeneratorBlock.Output,
@@ -1692,7 +1696,7 @@ class AIListGeneratorBlock(AIBlockBase):
                     "drawing explorers to uncover its mysteries. Each planet showcases the limitless possibilities of "
                     "fictional worlds."
                 ),
-                "model": LlmModel.GPT4O,
+                "model": DEFAULT_LLM_MODEL,
                 "credentials": TEST_CREDENTIALS_INPUT,
                 "max_retries": 3,
                 "force_json_output": False,
diff --git a/autogpt_platform/backend/backend/blocks/medium.py b/autogpt_platform/backend/backend/blocks/medium.py
index 713a8274f9..d54062d3ab 100644
--- a/autogpt_platform/backend/backend/blocks/medium.py
+++ b/autogpt_platform/backend/backend/blocks/medium.py
@@ -46,7 +46,7 @@ class PublishToMediumBlock(Block):
     class Input(BlockSchemaInput):
         author_id: BlockSecret = SecretField(
             key="medium_author_id",
-            description="""The Medium AuthorID of the user. You can get this by calling the /me endpoint of the Medium API.\n\ncurl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" https://api.medium.com/v1/me" the response will contain the authorId field.""",
+            description="""The Medium AuthorID of the user. You can get this by calling the /me endpoint of the Medium API.\n\ncurl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" https://api.medium.com/v1/me\n\nThe response will contain the authorId field.""",
             placeholder="Enter the author's Medium AuthorID",
         )
         title: str = SchemaField(
diff --git a/autogpt_platform/backend/backend/blocks/reddit.py b/autogpt_platform/backend/backend/blocks/reddit.py
index 231e7affef..1109d568db 100644
--- a/autogpt_platform/backend/backend/blocks/reddit.py
+++ b/autogpt_platform/backend/backend/blocks/reddit.py
@@ -3,6 +3,7 @@ from datetime import datetime, timezone
 from typing import Iterator, Literal
 
 import praw
+from praw.models import Comment, MoreComments, Submission
 from pydantic import BaseModel, SecretStr
 
 from backend.data.block import (
@@ -15,33 +16,51 @@ from backend.data.block import (
 from backend.data.model import (
     CredentialsField,
     CredentialsMetaInput,
+    OAuth2Credentials,
     SchemaField,
-    UserPasswordCredentials,
 )
 from backend.integrations.providers import ProviderName
 from backend.util.mock import MockObject
 from backend.util.settings import Settings
 
-RedditCredentials = UserPasswordCredentials
+# Type aliases for Reddit API options
+UserPostSort = Literal["new", "hot", "top", "controversial"]
+SearchSort = Literal["relevance", "hot", "top", "new", "comments"]
+TimeFilter = Literal["all", "day", "hour", "month", "week", "year"]
+CommentSort = Literal["best", "top", "new", "controversial", "old", "qa"]
+InboxType = Literal["all", "unread", "messages", "mentions", "comment_replies"]
+
+RedditCredentials = OAuth2Credentials
 RedditCredentialsInput = CredentialsMetaInput[
     Literal[ProviderName.REDDIT],
-    Literal["user_password"],
+    Literal["oauth2"],
 ]
 
 
 def RedditCredentialsField() -> RedditCredentialsInput:
     """Creates a Reddit credentials input on a block."""
     return CredentialsField(
-        description="The Reddit integration requires a username and password.",
+        description="Connect your Reddit account to access Reddit features.",
     )
 
 
-TEST_CREDENTIALS = UserPasswordCredentials(
+TEST_CREDENTIALS = OAuth2Credentials(
     id="01234567-89ab-cdef-0123-456789abcdef",
     provider="reddit",
-    username=SecretStr("mock-reddit-username"),
-    password=SecretStr("mock-reddit-password"),
+    access_token=SecretStr("mock-reddit-access-token"),
+    refresh_token=SecretStr("mock-reddit-refresh-token"),
+    access_token_expires_at=9999999999,
+    scopes=[
+        "identity",
+        "read",
+        "submit",
+        "edit",
+        "history",
+        "privatemessages",
+        "flair",
+    ],
     title="Mock Reddit credentials",
+    username="mock-reddit-username",
 )
 
 TEST_CREDENTIALS_INPUT = {
@@ -53,27 +72,29 @@ TEST_CREDENTIALS_INPUT = {
 
 
 class RedditPost(BaseModel):
-    id: str
+    post_id: str
     subreddit: str
     title: str
     body: str
 
 
-class RedditComment(BaseModel):
-    post_id: str
-    comment: str
-
-
 settings = Settings()
 logger = logging.getLogger(__name__)
 
 
 def get_praw(creds: RedditCredentials) -> praw.Reddit:
+    """
+    Create a PRAW Reddit client using OAuth2 credentials.
+
+    Uses the refresh_token for authentication, which allows the client
+    to automatically refresh the access token when needed.
+    """
     client = praw.Reddit(
         client_id=settings.secrets.reddit_client_id,
         client_secret=settings.secrets.reddit_client_secret,
-        username=creds.username.get_secret_value(),
-        password=creds.password.get_secret_value(),
+        refresh_token=(
+            creds.refresh_token.get_secret_value() if creds.refresh_token else None
+        ),
         user_agent=settings.config.reddit_user_agent,
     )
     me = client.user.me()
@@ -83,11 +104,36 @@ def get_praw(creds: RedditCredentials) -> praw.Reddit:
     return client
 
 
+def strip_reddit_prefix(id_str: str) -> str:
+    """
+    Strip Reddit type prefix (t1_, t3_, etc.) from an ID if present.
+
+    Reddit uses type prefixes like t1_ for comments, t3_ for posts, etc.
+    This helper normalizes IDs by removing these prefixes when present,
+    allowing blocks to accept both 'abc123' and 't3_abc123' formats.
+
+    Args:
+        id_str: The ID string that may have a Reddit type prefix.
+
+    Returns:
+        The ID without the type prefix.
+    """
+    if (
+        len(id_str) > 3
+        and id_str[0] == "t"
+        and id_str[1].isdigit()
+        and id_str[2] == "_"
+    ):
+        return id_str[3:]
+    return id_str
+
+
 class GetRedditPostsBlock(Block):
     class Input(BlockSchemaInput):
         subreddit: str = SchemaField(
             description="Subreddit name, excluding the /r/ prefix",
             default="writingprompts",
+            advanced=False,
         )
         credentials: RedditCredentialsInput = RedditCredentialsField()
         last_minutes: int | None = SchemaField(
@@ -128,26 +174,32 @@ class GetRedditPostsBlock(Block):
                 (
                     "post",
                     RedditPost(
-                        id="id1", subreddit="subreddit", title="title1", body="body1"
+                        post_id="id1",
+                        subreddit="subreddit",
+                        title="title1",
+                        body="body1",
                     ),
                 ),
                 (
                     "post",
                     RedditPost(
-                        id="id2", subreddit="subreddit", title="title2", body="body2"
+                        post_id="id2",
+                        subreddit="subreddit",
+                        title="title2",
+                        body="body2",
                     ),
                 ),
                 (
                     "posts",
                     [
                         RedditPost(
-                            id="id1",
+                            post_id="id1",
                             subreddit="subreddit",
                             title="title1",
                             body="body1",
                         ),
                         RedditPost(
-                            id="id2",
+                            post_id="id2",
                             subreddit="subreddit",
                             title="title2",
                             body="body2",
@@ -184,13 +236,14 @@ class GetRedditPostsBlock(Block):
                 )
                 time_difference = current_time - post_datetime
                 if time_difference.total_seconds() / 60 > input_data.last_minutes:
-                    continue
+                    # Posts are ordered newest-first, so all subsequent posts will also be older
+                    break
 
             if input_data.last_post and post.id == input_data.last_post:
                 break
 
             reddit_post = RedditPost(
-                id=post.id,
+                post_id=post.id,
                 subreddit=input_data.subreddit,
                 title=post.title,
                 body=post.selftext,
@@ -204,10 +257,18 @@ class GetRedditPostsBlock(Block):
 class PostRedditCommentBlock(Block):
     class Input(BlockSchemaInput):
         credentials: RedditCredentialsInput = RedditCredentialsField()
-        data: RedditComment = SchemaField(description="Reddit comment")
+        post_id: str = SchemaField(
+            description="The ID of the post to comment on",
+        )
+        comment: str = SchemaField(
+            description="The content of the comment to post",
+        )
 
     class Output(BlockSchemaOutput):
         comment_id: str = SchemaField(description="Posted comment ID")
+        post_id: str = SchemaField(
+            description="The post ID (pass-through for chaining)"
+        )
 
     def __init__(self):
         super().__init__(
@@ -223,17 +284,24 @@ class PostRedditCommentBlock(Block):
             test_credentials=TEST_CREDENTIALS,
             test_input={
                 "credentials": TEST_CREDENTIALS_INPUT,
-                "data": {"post_id": "id", "comment": "comment"},
+                "post_id": "test_post_id",
+                "comment": "comment",
+            },
+            test_output=[
+                ("comment_id", "dummy_comment_id"),
+                ("post_id", "test_post_id"),
+            ],
+            test_mock={
+                "reply_post": lambda creds, post_id, comment: "dummy_comment_id"
             },
-            test_output=[("comment_id", "dummy_comment_id")],
-            test_mock={"reply_post": lambda creds, comment: "dummy_comment_id"},
         )
 
     @staticmethod
-    def reply_post(creds: RedditCredentials, comment: RedditComment) -> str:
+    def reply_post(creds: RedditCredentials, post_id: str, comment: str) -> str:
         client = get_praw(creds)
-        submission = client.submission(id=comment.post_id)
-        new_comment = submission.reply(comment.comment)
+        post_id = strip_reddit_prefix(post_id)
+        submission = client.submission(id=post_id)
+        new_comment = submission.reply(comment)
         if not new_comment:
             raise ValueError("Failed to post comment.")
         return new_comment.id
@@ -241,4 +309,2230 @@ class PostRedditCommentBlock(Block):
     async def run(
         self, input_data: Input, *, credentials: RedditCredentials, **kwargs
     ) -> BlockOutput:
-        yield "comment_id", self.reply_post(credentials, input_data.data)
+        yield "comment_id", self.reply_post(
+            credentials,
+            post_id=input_data.post_id,
+            comment=input_data.comment,
+        )
+        yield "post_id", input_data.post_id
+
+
+class CreateRedditPostBlock(Block):
+    class Input(BlockSchemaInput):
+        credentials: RedditCredentialsInput = RedditCredentialsField()
+        subreddit: str = SchemaField(
+            description="Subreddit to post to, excluding the /r/ prefix",
+        )
+        title: str = SchemaField(
+            description="Title of the post",
+        )
+        content: str = SchemaField(
+            description="Body text of the post (for text posts)",
+            default="",
+        )
+        url: str | None = SchemaField(
+            description="URL to submit (for link posts). If provided, content is ignored.",
+            default=None,
+        )
+        flair_id: str | None = SchemaField(
+            description="Flair template ID to apply to the post (from GetSubredditFlairsBlock)",
+            default=None,
+        )
+        flair_text: str | None = SchemaField(
+            description="Custom flair text (only used if the flair template allows editing)",
+            default=None,
+        )
+
+    class Output(BlockSchemaOutput):
+        post_id: str = SchemaField(description="ID of the created post")
+        post_url: str = SchemaField(description="URL of the created post")
+        subreddit: str = SchemaField(
+            description="The subreddit name (pass-through for chaining)"
+        )
+
+    def __init__(self):
+        super().__init__(
+            id="f3a2b1c0-8d7e-4f6a-9b5c-1234567890ab",
+            description="Create a new post on a subreddit. Can create text posts or link posts.",
+            categories={BlockCategory.SOCIAL},
+            input_schema=CreateRedditPostBlock.Input,
+            output_schema=CreateRedditPostBlock.Output,
+            disabled=(
+                not settings.secrets.reddit_client_id
+                or not settings.secrets.reddit_client_secret
+            ),
+            test_credentials=TEST_CREDENTIALS,
+            test_input={
+                "credentials": TEST_CREDENTIALS_INPUT,
+                "subreddit": "test",
+                "title": "Test Post",
+                "content": "This is a test post body.",
+            },
+            test_output=[
+                ("post_id", "abc123"),
+                ("post_url", "https://reddit.com/r/test/comments/abc123/test_post/"),
+                ("subreddit", "test"),
+            ],
+            test_mock={
+                "create_post": lambda creds, subreddit, title, content, url, flair_id, flair_text: (
+                    "abc123",
+                    "https://reddit.com/r/test/comments/abc123/test_post/",
+                )
+            },
+        )
+
+    @staticmethod
+    def create_post(
+        creds: RedditCredentials,
+        subreddit: str,
+        title: str,
+        content: str = "",
+        url: str | None = None,
+        flair_id: str | None = None,
+        flair_text: str | None = None,
+    ) -> tuple[str, str]:
+        """
+        Create a new post on a subreddit.
+
+        Args:
+            creds: Reddit OAuth2 credentials
+            subreddit: Subreddit name (without /r/ prefix)
+            title: Post title
+            content: Post body text (for text posts)
+            url: URL to submit (for link posts, overrides content)
+            flair_id: Optional flair template ID to apply
+            flair_text: Optional custom flair text (for editable flairs)
+
+        Returns:
+            Tuple of (post_id, post_url)
+        """
+        client = get_praw(creds)
+        sub = client.subreddit(subreddit)
+
+        if url:
+            submission = sub.submit(
+                title=title, url=url, flair_id=flair_id, flair_text=flair_text
+            )
+        else:
+            submission = sub.submit(
+                title=title, selftext=content, flair_id=flair_id, flair_text=flair_text
+            )
+
+        return submission.id, f"https://reddit.com{submission.permalink}"
+
+    async def run(
+        self, input_data: Input, *, credentials: RedditCredentials, **kwargs
+    ) -> BlockOutput:
+        post_id, post_url = self.create_post(
+            credentials,
+            input_data.subreddit,
+            input_data.title,
+            input_data.content,
+            input_data.url,
+            input_data.flair_id,
+            input_data.flair_text,
+        )
+        yield "post_id", post_id
+        yield "post_url", post_url
+        yield "subreddit", input_data.subreddit
+
+
+class RedditPostDetails(BaseModel):
+    """Detailed information about a Reddit post."""
+
+    id: str
+    subreddit: str
+    title: str
+    body: str
+    author: str
+    score: int
+    upvote_ratio: float
+    num_comments: int
+    created_utc: float
+    url: str
+    permalink: str
+    is_self: bool
+    over_18: bool
+
+
+class GetRedditPostBlock(Block):
+    """Get detailed information about a specific Reddit post."""
+
+    class Input(BlockSchemaInput):
+        credentials: RedditCredentialsInput = RedditCredentialsField()
+        post_id: str = SchemaField(
+            description="The ID of the post to fetch (e.g., 'abc123' or full ID 't3_abc123')",
+        )
+
+    class Output(BlockSchemaOutput):
+        post: RedditPostDetails = SchemaField(description="Detailed post information")
+        error: str = SchemaField(
+            description="Error message if the post couldn't be fetched"
+        )
+
+    def __init__(self):
+        super().__init__(
+            id="36e6a259-168c-4032-83ec-b2935d0e4584",
+            description="Get detailed information about a specific Reddit post by its ID.",
+            categories={BlockCategory.SOCIAL},
+            input_schema=GetRedditPostBlock.Input,
+            output_schema=GetRedditPostBlock.Output,
+            disabled=(
+                not settings.secrets.reddit_client_id
+                or not settings.secrets.reddit_client_secret
+            ),
+            test_credentials=TEST_CREDENTIALS,
+            test_input={
+                "credentials": TEST_CREDENTIALS_INPUT,
+                "post_id": "abc123",
+            },
+            test_output=[
+                (
+                    "post",
+                    RedditPostDetails(
+                        id="abc123",
+                        subreddit="test",
+                        title="Test Post",
+                        body="Test body",
+                        author="testuser",
+                        score=100,
+                        upvote_ratio=0.95,
+                        num_comments=10,
+                        created_utc=1234567890.0,
+                        url="https://reddit.com/r/test/comments/abc123/test_post/",
+                        permalink="/r/test/comments/abc123/test_post/",
+                        is_self=True,
+                        over_18=False,
+                    ),
+                ),
+            ],
+            test_mock={
+                "get_post": lambda creds, post_id: RedditPostDetails(
+                    id="abc123",
+                    subreddit="test",
+                    title="Test Post",
+                    body="Test body",
+                    author="testuser",
+                    score=100,
+                    upvote_ratio=0.95,
+                    num_comments=10,
+                    created_utc=1234567890.0,
+                    url="https://reddit.com/r/test/comments/abc123/test_post/",
+                    permalink="/r/test/comments/abc123/test_post/",
+                    is_self=True,
+                    over_18=False,
+                )
+            },
+        )
+
+    @staticmethod
+    def get_post(creds: RedditCredentials, post_id: str) -> RedditPostDetails:
+        client = get_praw(creds)
+        post_id = strip_reddit_prefix(post_id)
+        submission = client.submission(id=post_id)
+
+        return RedditPostDetails(
+            id=submission.id,
+            subreddit=submission.subreddit.display_name,
+            title=submission.title,
+            body=submission.selftext,
+            author=str(submission.author) if submission.author else "[deleted]",
+            score=submission.score,
+            upvote_ratio=submission.upvote_ratio,
+            num_comments=submission.num_comments,
+            created_utc=submission.created_utc,
+            url=submission.url,
+            permalink=submission.permalink,
+            is_self=submission.is_self,
+            over_18=submission.over_18,
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: RedditCredentials, **kwargs
+    ) -> BlockOutput:
+        try:
+            post = self.get_post(credentials, input_data.post_id)
+            yield "post", post
+        except Exception as e:
+            yield "error", str(e)
+
+
+class GetUserPostsBlock(Block):
+    """Get posts by a specific Reddit user."""
+
+    class Input(BlockSchemaInput):
+        credentials: RedditCredentialsInput = RedditCredentialsField()
+        username: str = SchemaField(
+            description="Reddit username to fetch posts from (without /u/ prefix)",
+        )
+        post_limit: int = SchemaField(
+            description="Maximum number of posts to fetch",
+            default=10,
+        )
+        sort: UserPostSort = SchemaField(
+            description="Sort order for user posts",
+            default="new",
+        )
+
+    class Output(BlockSchemaOutput):
+        post: RedditPost = SchemaField(description="A post by the user")
+        posts: list[RedditPost] = SchemaField(description="All posts by the user")
+        error: str = SchemaField(
+            description="Error message if posts couldn't be fetched"
+        )
+
+    def __init__(self):
+        super().__init__(
+            id="6fbe6329-d13e-4d2e-bd4d-b4d921b56161",
+            description="Fetch posts by a specific Reddit user.",
+            categories={BlockCategory.SOCIAL},
+            input_schema=GetUserPostsBlock.Input,
+            output_schema=GetUserPostsBlock.Output,
+            disabled=(
+                not settings.secrets.reddit_client_id
+                or not settings.secrets.reddit_client_secret
+            ),
+            test_credentials=TEST_CREDENTIALS,
+            test_input={
+                "credentials": TEST_CREDENTIALS_INPUT,
+                "username": "testuser",
+                "post_limit": 2,
+            },
+            test_output=[
+                (
+                    "post",
+                    RedditPost(
+                        post_id="id1", subreddit="sub1", title="title1", body="body1"
+                    ),
+                ),
+                (
+                    "post",
+                    RedditPost(
+                        post_id="id2", subreddit="sub2", title="title2", body="body2"
+                    ),
+                ),
+                (
+                    "posts",
+                    [
+                        RedditPost(
+                            post_id="id1",
+                            subreddit="sub1",
+                            title="title1",
+                            body="body1",
+                        ),
+                        RedditPost(
+                            post_id="id2",
+                            subreddit="sub2",
+                            title="title2",
+                            body="body2",
+                        ),
+                    ],
+                ),
+            ],
+            test_mock={
+                "get_user_posts": lambda creds, username, limit, sort: [
+                    MockObject(
+                        id="id1",
+                        subreddit=MockObject(display_name="sub1"),
+                        title="title1",
+                        selftext="body1",
+                    ),
+                    MockObject(
+                        id="id2",
+                        subreddit=MockObject(display_name="sub2"),
+                        title="title2",
+                        selftext="body2",
+                    ),
+                ]
+            },
+        )
+
+    @staticmethod
+    def get_user_posts(
+        creds: RedditCredentials, username: str, limit: int, sort: UserPostSort
+    ) -> list[Submission]:
+        client = get_praw(creds)
+        redditor = client.redditor(username)
+
+        if sort == "new":
+            submissions = redditor.submissions.new(limit=limit)
+        elif sort == "hot":
+            submissions = redditor.submissions.hot(limit=limit)
+        elif sort == "top":
+            submissions = redditor.submissions.top(limit=limit)
+        elif sort == "controversial":
+            submissions = redditor.submissions.controversial(limit=limit)
+        else:
+            submissions = redditor.submissions.new(limit=limit)
+
+        return list(submissions)
+
+    async def run(
+        self, input_data: Input, *, credentials: RedditCredentials, **kwargs
+    ) -> BlockOutput:
+        try:
+            submissions = self.get_user_posts(
+                credentials,
+                input_data.username,
+                input_data.post_limit,
+                input_data.sort,
+            )
+            all_posts = []
+            for submission in submissions:
+                post = RedditPost(
+                    post_id=submission.id,
+                    subreddit=submission.subreddit.display_name,
+                    title=submission.title,
+                    body=submission.selftext,
+                )
+                all_posts.append(post)
+                yield "post", post
+            yield "posts", all_posts
+        except Exception as e:
+            yield "error", str(e)
+
+
+class RedditGetMyPostsBlock(Block):
+    """Get posts by the authenticated Reddit user."""
+
+    class Input(BlockSchemaInput):
+        credentials: RedditCredentialsInput = RedditCredentialsField()
+        post_limit: int = SchemaField(
+            description="Maximum number of posts to fetch",
+            default=10,
+        )
+        sort: UserPostSort = SchemaField(
+            description="Sort order for posts",
+            default="new",
+        )
+
+    class Output(BlockSchemaOutput):
+        post: RedditPost = SchemaField(description="A post by you")
+        posts: list[RedditPost] = SchemaField(description="All your posts")
+        error: str = SchemaField(
+            description="Error message if posts couldn't be fetched"
+        )
+
+    def __init__(self):
+        super().__init__(
+            id="4ab3381b-0c07-4201-89b3-fa2ec264f154",
+            description="Fetch posts created by the authenticated Reddit user (you).",
+            categories={BlockCategory.SOCIAL},
+            input_schema=RedditGetMyPostsBlock.Input,
+            output_schema=RedditGetMyPostsBlock.Output,
+            disabled=(
+                not settings.secrets.reddit_client_id
+                or not settings.secrets.reddit_client_secret
+            ),
+            test_credentials=TEST_CREDENTIALS,
+            test_input={
+                "credentials": TEST_CREDENTIALS_INPUT,
+                "post_limit": 2,
+            },
+            test_output=[
+                (
+                    "post",
+                    RedditPost(
+                        post_id="id1", subreddit="sub1", title="title1", body="body1"
+                    ),
+                ),
+                (
+                    "post",
+                    RedditPost(
+                        post_id="id2", subreddit="sub2", title="title2", body="body2"
+                    ),
+                ),
+                (
+                    "posts",
+                    [
+                        RedditPost(
+                            post_id="id1",
+                            subreddit="sub1",
+                            title="title1",
+                            body="body1",
+                        ),
+                        RedditPost(
+                            post_id="id2",
+                            subreddit="sub2",
+                            title="title2",
+                            body="body2",
+                        ),
+                    ],
+                ),
+            ],
+            test_mock={
+                "get_my_posts": lambda creds, limit, sort: [
+                    MockObject(
+                        id="id1",
+                        subreddit=MockObject(display_name="sub1"),
+                        title="title1",
+                        selftext="body1",
+                    ),
+                    MockObject(
+                        id="id2",
+                        subreddit=MockObject(display_name="sub2"),
+                        title="title2",
+                        selftext="body2",
+                    ),
+                ]
+            },
+        )
+
+    @staticmethod
+    def get_my_posts(
+        creds: RedditCredentials, limit: int, sort: UserPostSort
+    ) -> list[Submission]:
+        client = get_praw(creds)
+        me = client.user.me()
+        if not me:
+            raise ValueError("Could not get authenticated user.")
+
+        if sort == "new":
+            submissions = me.submissions.new(limit=limit)
+        elif sort == "hot":
+            submissions = me.submissions.hot(limit=limit)
+        elif sort == "top":
+            submissions = me.submissions.top(limit=limit)
+        elif sort == "controversial":
+            submissions = me.submissions.controversial(limit=limit)
+        else:
+            submissions = me.submissions.new(limit=limit)
+
+        return list(submissions)
+
+    async def run(
+        self, input_data: Input, *, credentials: RedditCredentials, **kwargs
+    ) -> BlockOutput:
+        try:
+            submissions = self.get_my_posts(
+                credentials,
+                input_data.post_limit,
+                input_data.sort,
+            )
+            all_posts = []
+            for submission in submissions:
+                post = RedditPost(
+                    post_id=submission.id,
+                    subreddit=submission.subreddit.display_name,
+                    title=submission.title,
+                    body=submission.selftext,
+                )
+                all_posts.append(post)
+                yield "post", post
+            yield "posts", all_posts
+        except Exception as e:
+            yield "error", str(e)
+
+
+class RedditSearchResult(BaseModel):
+    """A search result from Reddit."""
+
+    id: str
+    subreddit: str
+    title: str
+    body: str
+    author: str
+    score: int
+    num_comments: int
+    created_utc: float
+    permalink: str
+
+
+class SearchRedditBlock(Block):
+    """Search Reddit for posts matching a query."""
+
+    class Input(BlockSchemaInput):
+        credentials: RedditCredentialsInput = RedditCredentialsField()
+        query: str = SchemaField(
+            description="Search query string",
+        )
+        subreddit: str | None = SchemaField(
+            description="Limit search to a specific subreddit (without /r/ prefix)",
+            default=None,
+        )
+        sort: SearchSort = SchemaField(
+            description="Sort order for search results",
+            default="relevance",
+        )
+        time_filter: TimeFilter = SchemaField(
+            description="Time filter for search results",
+            default="all",
+        )
+        limit: int = SchemaField(
+            description="Maximum number of results to return",
+            default=10,
+        )
+
+    class Output(BlockSchemaOutput):
+        result: RedditSearchResult = SchemaField(description="A search result")
+        results: list[RedditSearchResult] = SchemaField(
+            description="All search results"
+        )
+        error: str = SchemaField(description="Error message if search failed")
+
+    def __init__(self):
+        super().__init__(
+            id="4a0c975e-807b-4d5e-83c9-1619864a4b1a",
+            description="Search Reddit for posts matching a query. Can search all of Reddit or a specific subreddit.",
+            categories={BlockCategory.SOCIAL},
+            input_schema=SearchRedditBlock.Input,
+            output_schema=SearchRedditBlock.Output,
+            disabled=(
+                not settings.secrets.reddit_client_id
+                or not settings.secrets.reddit_client_secret
+            ),
+            test_credentials=TEST_CREDENTIALS,
+            test_input={
+                "credentials": TEST_CREDENTIALS_INPUT,
+                "query": "test query",
+                "limit": 2,
+            },
+            test_output=[
+                (
+                    "result",
+                    RedditSearchResult(
+                        id="id1",
+                        subreddit="sub1",
+                        title="title1",
+                        body="body1",
+                        author="author1",
+                        score=100,
+                        num_comments=10,
+                        created_utc=1234567890.0,
+                        permalink="/r/sub1/comments/id1/title1/",
+                    ),
+                ),
+                (
+                    "result",
+                    RedditSearchResult(
+                        id="id2",
+                        subreddit="sub2",
+                        title="title2",
+                        body="body2",
+                        author="author2",
+                        score=50,
+                        num_comments=5,
+                        created_utc=1234567891.0,
+                        permalink="/r/sub2/comments/id2/title2/",
+                    ),
+                ),
+                (
+                    "results",
+                    [
+                        RedditSearchResult(
+                            id="id1",
+                            subreddit="sub1",
+                            title="title1",
+                            body="body1",
+                            author="author1",
+                            score=100,
+                            num_comments=10,
+                            created_utc=1234567890.0,
+                            permalink="/r/sub1/comments/id1/title1/",
+                        ),
+                        RedditSearchResult(
+                            id="id2",
+                            subreddit="sub2",
+                            title="title2",
+                            body="body2",
+                            author="author2",
+                            score=50,
+                            num_comments=5,
+                            created_utc=1234567891.0,
+                            permalink="/r/sub2/comments/id2/title2/",
+                        ),
+                    ],
+                ),
+            ],
+            test_mock={
+                "search_reddit": lambda creds, query, subreddit, sort, time_filter, limit: [
+                    MockObject(
+                        id="id1",
+                        subreddit=MockObject(display_name="sub1"),
+                        title="title1",
+                        selftext="body1",
+                        author="author1",
+                        score=100,
+                        num_comments=10,
+                        created_utc=1234567890.0,
+                        permalink="/r/sub1/comments/id1/title1/",
+                    ),
+                    MockObject(
+                        id="id2",
+                        subreddit=MockObject(display_name="sub2"),
+                        title="title2",
+                        selftext="body2",
+                        author="author2",
+                        score=50,
+                        num_comments=5,
+                        created_utc=1234567891.0,
+                        permalink="/r/sub2/comments/id2/title2/",
+                    ),
+                ]
+            },
+        )
+
+    @staticmethod
+    def search_reddit(
+        creds: RedditCredentials,
+        query: str,
+        subreddit: str | None,
+        sort: SearchSort,
+        time_filter: TimeFilter,
+        limit: int,
+    ) -> list[Submission]:
+        client = get_praw(creds)
+
+        if subreddit:
+            sub = client.subreddit(subreddit)
+            results = sub.search(query, sort=sort, time_filter=time_filter, limit=limit)
+        else:
+            results = client.subreddit("all").search(
+                query, sort=sort, time_filter=time_filter, limit=limit
+            )
+
+        return list(results)
+
+    async def run(
+        self, input_data: Input, *, credentials: RedditCredentials, **kwargs
+    ) -> BlockOutput:
+        try:
+            submissions = self.search_reddit(
+                credentials,
+                input_data.query,
+                input_data.subreddit,
+                input_data.sort,
+                input_data.time_filter,
+                input_data.limit,
+            )
+            all_results = []
+            for submission in submissions:
+                result = RedditSearchResult(
+                    id=submission.id,
+                    subreddit=submission.subreddit.display_name,
+                    title=submission.title,
+                    body=submission.selftext,
+                    author=str(submission.author) if submission.author else "[deleted]",
+                    score=submission.score,
+                    num_comments=submission.num_comments,
+                    created_utc=submission.created_utc,
+                    permalink=submission.permalink,
+                )
+                all_results.append(result)
+                yield "result", result
+            yield "results", all_results
+        except Exception as e:
+            yield "error", str(e)
+
+
+class EditRedditPostBlock(Block):
+    """Edit an existing Reddit post that you own."""
+
+    class Input(BlockSchemaInput):
+        credentials: RedditCredentialsInput = RedditCredentialsField()
+        post_id: str = SchemaField(
+            description="The ID of the post to edit (must be your own post)",
+        )
+        new_content: str = SchemaField(
+            description="The new body text for the post",
+        )
+
+    class Output(BlockSchemaOutput):
+        success: bool = SchemaField(description="Whether the edit was successful")
+        post_id: str = SchemaField(
+            description="The post ID (pass-through for chaining)"
+        )
+        post_url: str = SchemaField(description="URL of the edited post")
+        error: str = SchemaField(description="Error message if the edit failed")
+
+    def __init__(self):
+        super().__init__(
+            id="cdb9df0f-8b1d-433e-873a-ededc1b6479d",
+            description="Edit the body text of an existing Reddit post that you own. Only works for self/text posts.",
+            categories={BlockCategory.SOCIAL},
+            input_schema=EditRedditPostBlock.Input,
+            output_schema=EditRedditPostBlock.Output,
+            disabled=(
+                not settings.secrets.reddit_client_id
+                or not settings.secrets.reddit_client_secret
+            ),
+            test_credentials=TEST_CREDENTIALS,
+            test_input={
+                "credentials": TEST_CREDENTIALS_INPUT,
+                "post_id": "abc123",
+                "new_content": "Updated post content",
+            },
+            test_output=[
+                ("success", True),
+                ("post_id", "abc123"),
+                ("post_url", "https://reddit.com/r/test/comments/abc123/test_post/"),
+            ],
+            test_mock={
+                "edit_post": lambda creds, post_id, new_content: (
+                    True,
+                    "https://reddit.com/r/test/comments/abc123/test_post/",
+                )
+            },
+        )
+
+    @staticmethod
+    def edit_post(
+        creds: RedditCredentials, post_id: str, new_content: str
+    ) -> tuple[bool, str]:
+        client = get_praw(creds)
+        post_id = strip_reddit_prefix(post_id)
+        submission = client.submission(id=post_id)
+        submission.edit(new_content)
+        return True, f"https://reddit.com{submission.permalink}"
+
+    async def run(
+        self, input_data: Input, *, credentials: RedditCredentials, **kwargs
+    ) -> BlockOutput:
+        try:
+            success, post_url = self.edit_post(
+                credentials, input_data.post_id, input_data.new_content
+            )
+            yield "success", success
+            yield "post_id", input_data.post_id
+            yield "post_url", post_url
+        except Exception as e:
+            error_msg = str(e)
+            if "403" in error_msg:
+                error_msg = (
+                    "Permission denied (403): You can only edit your own posts. "
+                    "Make sure the post belongs to the authenticated Reddit account."
+                )
+            yield "error", error_msg
+
+
+class SubredditInfo(BaseModel):
+    """Information about a subreddit."""
+
+    name: str
+    display_name: str
+    title: str
+    description: str
+    public_description: str
+    subscribers: int
+    created_utc: float
+    over_18: bool
+    url: str
+
+
+class GetSubredditInfoBlock(Block):
+    """Get information about a subreddit."""
+
+    class Input(BlockSchemaInput):
+        credentials: RedditCredentialsInput = RedditCredentialsField()
+        subreddit: str = SchemaField(
+            description="Subreddit name (without /r/ prefix)",
+        )
+
+    class Output(BlockSchemaOutput):
+        info: SubredditInfo = SchemaField(description="Subreddit information")
+        subreddit: str = SchemaField(
+            description="The subreddit name (pass-through for chaining)"
+        )
+        error: str = SchemaField(
+            description="Error message if the subreddit couldn't be fetched"
+        )
+
+    def __init__(self):
+        super().__init__(
+            id="5a2d1f0c-01fb-43ea-bad7-2260d269c930",
+            description="Get information about a subreddit including subscriber count, description, and rules.",
+            categories={BlockCategory.SOCIAL},
+            input_schema=GetSubredditInfoBlock.Input,
+            output_schema=GetSubredditInfoBlock.Output,
+            disabled=(
+                not settings.secrets.reddit_client_id
+                or not settings.secrets.reddit_client_secret
+            ),
+            test_credentials=TEST_CREDENTIALS,
+            test_input={
+                "credentials": TEST_CREDENTIALS_INPUT,
+                "subreddit": "python",
+            },
+            test_output=[
+                (
+                    "info",
+                    SubredditInfo(
+                        name="t5_2qh0y",
+                        display_name="python",
+                        title="Python",
+                        description="News about the Python programming language",
+                        public_description="News about Python",
+                        subscribers=1000000,
+                        created_utc=1234567890.0,
+                        over_18=False,
+                        url="/r/python/",
+                    ),
+                ),
+                ("subreddit", "python"),
+            ],
+            test_mock={
+                "get_subreddit_info": lambda creds, subreddit: SubredditInfo(
+                    name="t5_2qh0y",
+                    display_name="python",
+                    title="Python",
+                    description="News about the Python programming language",
+                    public_description="News about Python",
+                    subscribers=1000000,
+                    created_utc=1234567890.0,
+                    over_18=False,
+                    url="/r/python/",
+                )
+            },
+        )
+
+    @staticmethod
+    def get_subreddit_info(creds: RedditCredentials, subreddit: str) -> SubredditInfo:
+        client = get_praw(creds)
+        sub = client.subreddit(subreddit)
+
+        return SubredditInfo(
+            name=sub.name,
+            display_name=sub.display_name,
+            title=sub.title,
+            description=sub.description,
+            public_description=sub.public_description,
+            subscribers=sub.subscribers,
+            created_utc=sub.created_utc,
+            over_18=sub.over18,
+            url=sub.url,
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: RedditCredentials, **kwargs
+    ) -> BlockOutput:
+        try:
+            info = self.get_subreddit_info(credentials, input_data.subreddit)
+            yield "info", info
+            yield "subreddit", input_data.subreddit
+        except Exception as e:
+            yield "error", str(e)
+
+
+class RedditComment(BaseModel):
+    """A Reddit comment."""
+
+    comment_id: str
+    post_id: str
+    parent_comment_id: str | None
+    author: str
+    body: str
+    score: int
+    created_utc: float
+    edited: bool
+    is_submitter: bool
+    permalink: str
+    depth: int
+
+
+class GetRedditPostCommentsBlock(Block):
+    """Get comments on a Reddit post."""
+
+    class Input(BlockSchemaInput):
+        credentials: RedditCredentialsInput = RedditCredentialsField()
+        post_id: str = SchemaField(
+            description="The ID of the post to get comments from",
+        )
+        limit: int = SchemaField(
+            description="Maximum number of top-level comments to fetch (max 100)",
+            default=25,
+        )
+        sort: CommentSort = SchemaField(
+            description="Sort order for comments",
+            default="best",
+        )
+
+    class Output(BlockSchemaOutput):
+        comment: RedditComment = SchemaField(description="A comment on the post")
+        comments: list[RedditComment] = SchemaField(description="All fetched comments")
+        post_id: str = SchemaField(
+            description="The post ID (pass-through for chaining)"
+        )
+        error: str = SchemaField(
+            description="Error message if comments couldn't be fetched"
+        )
+
+    def __init__(self):
+        super().__init__(
+            id="98422b2c-c3b0-4d70-871f-56bd966f46da",
+            description="Get top-level comments on a Reddit post.",
+            categories={BlockCategory.SOCIAL},
+            input_schema=GetRedditPostCommentsBlock.Input,
+            output_schema=GetRedditPostCommentsBlock.Output,
+            disabled=(
+                not settings.secrets.reddit_client_id
+                or not settings.secrets.reddit_client_secret
+            ),
+            test_credentials=TEST_CREDENTIALS,
+            test_input={
+                "credentials": TEST_CREDENTIALS_INPUT,
+                "post_id": "abc123",
+                "limit": 2,
+            },
+            test_output=[
+                (
+                    "comment",
+                    RedditComment(
+                        comment_id="comment1",
+                        post_id="abc123",
+                        parent_comment_id=None,
+                        author="user1",
+                        body="Comment body 1",
+                        score=10,
+                        created_utc=1234567890.0,
+                        edited=False,
+                        is_submitter=False,
+                        permalink="/r/test/comments/abc123/test/comment1/",
+                        depth=0,
+                    ),
+                ),
+                (
+                    "comment",
+                    RedditComment(
+                        comment_id="comment2",
+                        post_id="abc123",
+                        parent_comment_id=None,
+                        author="user2",
+                        body="Comment body 2",
+                        score=5,
+                        created_utc=1234567891.0,
+                        edited=False,
+                        is_submitter=True,
+                        permalink="/r/test/comments/abc123/test/comment2/",
+                        depth=0,
+                    ),
+                ),
+                (
+                    "comments",
+                    [
+                        RedditComment(
+                            comment_id="comment1",
+                            post_id="abc123",
+                            parent_comment_id=None,
+                            author="user1",
+                            body="Comment body 1",
+                            score=10,
+                            created_utc=1234567890.0,
+                            edited=False,
+                            is_submitter=False,
+                            permalink="/r/test/comments/abc123/test/comment1/",
+                            depth=0,
+                        ),
+                        RedditComment(
+                            comment_id="comment2",
+                            post_id="abc123",
+                            parent_comment_id=None,
+                            author="user2",
+                            body="Comment body 2",
+                            score=5,
+                            created_utc=1234567891.0,
+                            edited=False,
+                            is_submitter=True,
+                            permalink="/r/test/comments/abc123/test/comment2/",
+                            depth=0,
+                        ),
+                    ],
+                ),
+                ("post_id", "abc123"),
+            ],
+            test_mock={
+                "get_comments": lambda creds, post_id, limit, sort: [
+                    MockObject(
+                        id="comment1",
+                        link_id="t3_abc123",
+                        parent_id="t3_abc123",
+                        author="user1",
+                        body="Comment body 1",
+                        score=10,
+                        created_utc=1234567890.0,
+                        edited=False,
+                        is_submitter=False,
+                        permalink="/r/test/comments/abc123/test/comment1/",
+                        depth=0,
+                    ),
+                    MockObject(
+                        id="comment2",
+                        link_id="t3_abc123",
+                        parent_id="t3_abc123",
+                        author="user2",
+                        body="Comment body 2",
+                        score=5,
+                        created_utc=1234567891.0,
+                        edited=False,
+                        is_submitter=True,
+                        permalink="/r/test/comments/abc123/test/comment2/",
+                        depth=0,
+                    ),
+                ]
+            },
+        )
+
+    @staticmethod
+    def get_comments(
+        creds: RedditCredentials, post_id: str, limit: int, sort: CommentSort
+    ) -> list[Comment]:
+        client = get_praw(creds)
+        post_id = strip_reddit_prefix(post_id)
+        submission = client.submission(id=post_id)
+        submission.comment_sort = sort
+        # Replace MoreComments with actual comments up to limit
+        submission.comments.replace_more(limit=0)
+        # Return only top-level comments (depth=0), limited
+        # CommentForest supports indexing, so use slicing directly
+        max_comments = min(limit, 100)
+        return [
+            submission.comments[i]
+            for i in range(min(len(submission.comments), max_comments))
+        ]
+
+    async def run(
+        self, input_data: Input, *, credentials: RedditCredentials, **kwargs
+    ) -> BlockOutput:
+        try:
+            comments = self.get_comments(
+                credentials,
+                input_data.post_id,
+                input_data.limit,
+                input_data.sort,
+            )
+            all_comments = []
+            for comment in comments:
+                # Extract post_id from link_id (format: t3_xxxxx)
+                comment_post_id = strip_reddit_prefix(comment.link_id)
+
+                # parent_comment_id is None for top-level comments (parent is a post: t3_)
+                # For replies, extract the comment ID from t1_xxxxx
+                parent_comment_id = None
+                if comment.parent_id.startswith("t1_"):
+                    parent_comment_id = strip_reddit_prefix(comment.parent_id)
+
+                comment_data = RedditComment(
+                    comment_id=comment.id,
+                    post_id=comment_post_id,
+                    parent_comment_id=parent_comment_id,
+                    author=str(comment.author) if comment.author else "[deleted]",
+                    body=comment.body,
+                    score=comment.score,
+                    created_utc=comment.created_utc,
+                    edited=bool(comment.edited),
+                    is_submitter=comment.is_submitter,
+                    permalink=comment.permalink,
+                    depth=comment.depth,
+                )
+                all_comments.append(comment_data)
+                yield "comment", comment_data
+            yield "comments", all_comments
+            yield "post_id", input_data.post_id
+        except Exception as e:
+            yield "error", str(e)
+
+
+class GetRedditCommentRepliesBlock(Block):
+    """Get replies to a specific Reddit comment."""
+
+    class Input(BlockSchemaInput):
+        credentials: RedditCredentialsInput = RedditCredentialsField()
+        comment_id: str = SchemaField(
+            description="The ID of the comment to get replies from",
+        )
+        post_id: str = SchemaField(
+            description="The ID of the post containing the comment",
+        )
+        limit: int = SchemaField(
+            description="Maximum number of replies to fetch (max 50)",
+            default=10,
+        )
+
+    class Output(BlockSchemaOutput):
+        reply: RedditComment = SchemaField(description="A reply to the comment")
+        replies: list[RedditComment] = SchemaField(description="All replies")
+        comment_id: str = SchemaField(
+            description="The parent comment ID (pass-through for chaining)"
+        )
+        post_id: str = SchemaField(
+            description="The post ID (pass-through for chaining)"
+        )
+        error: str = SchemaField(
+            description="Error message if replies couldn't be fetched"
+        )
+
+    def __init__(self):
+        super().__init__(
+            id="7fa83965-7289-432f-98a9-1575f5bcc8f1",
+            description="Get replies to a specific Reddit comment.",
+            categories={BlockCategory.SOCIAL},
+            input_schema=GetRedditCommentRepliesBlock.Input,
+            output_schema=GetRedditCommentRepliesBlock.Output,
+            disabled=(
+                not settings.secrets.reddit_client_id
+                or not settings.secrets.reddit_client_secret
+            ),
+            test_credentials=TEST_CREDENTIALS,
+            test_input={
+                "credentials": TEST_CREDENTIALS_INPUT,
+                "comment_id": "comment1",
+                "post_id": "abc123",
+                "limit": 2,
+            },
+            test_output=[
+                (
+                    "reply",
+                    RedditComment(
+                        comment_id="reply1",
+                        post_id="abc123",
+                        parent_comment_id="comment1",
+                        author="replier1",
+                        body="Reply body 1",
+                        score=3,
+                        created_utc=1234567892.0,
+                        edited=False,
+                        is_submitter=False,
+                        permalink="/r/test/comments/abc123/test/reply1/",
+                        depth=1,
+                    ),
+                ),
+                (
+                    "replies",
+                    [
+                        RedditComment(
+                            comment_id="reply1",
+                            post_id="abc123",
+                            parent_comment_id="comment1",
+                            author="replier1",
+                            body="Reply body 1",
+                            score=3,
+                            created_utc=1234567892.0,
+                            edited=False,
+                            is_submitter=False,
+                            permalink="/r/test/comments/abc123/test/reply1/",
+                            depth=1,
+                        ),
+                    ],
+                ),
+                ("comment_id", "comment1"),
+                ("post_id", "abc123"),
+            ],
+            test_mock={
+                "get_replies": lambda creds, comment_id, post_id, limit: [
+                    MockObject(
+                        id="reply1",
+                        link_id="t3_abc123",
+                        parent_id="t1_comment1",
+                        author="replier1",
+                        body="Reply body 1",
+                        score=3,
+                        created_utc=1234567892.0,
+                        edited=False,
+                        is_submitter=False,
+                        permalink="/r/test/comments/abc123/test/reply1/",
+                        depth=1,
+                    ),
+                ]
+            },
+        )
+
+    @staticmethod
+    def get_replies(
+        creds: RedditCredentials, comment_id: str, post_id: str, limit: int
+    ) -> list[Comment]:
+        client = get_praw(creds)
+        post_id = strip_reddit_prefix(post_id)
+        comment_id = strip_reddit_prefix(comment_id)
+
+        # Get the submission and find the comment
+        submission = client.submission(id=post_id)
+        submission.comments.replace_more(limit=0)
+
+        # Find the target comment - filter out MoreComments which don't have .id
+        comment = None
+        for c in submission.comments.list():
+            if isinstance(c, MoreComments):
+                continue
+            if c.id == comment_id:
+                comment = c
+                break
+
+        if not comment:
+            return []
+
+        # Get direct replies - filter out MoreComments objects
+        replies = []
+        # CommentForest supports indexing
+        for i in range(len(comment.replies)):
+            reply = comment.replies[i]
+            if isinstance(reply, MoreComments):
+                continue
+            replies.append(reply)
+            if len(replies) >= min(limit, 50):
+                break
+
+        return replies
+
+    async def run(
+        self, input_data: Input, *, credentials: RedditCredentials, **kwargs
+    ) -> BlockOutput:
+        try:
+            replies = self.get_replies(
+                credentials,
+                input_data.comment_id,
+                input_data.post_id,
+                input_data.limit,
+            )
+            all_replies = []
+            for reply in replies:
+                reply_post_id = strip_reddit_prefix(reply.link_id)
+
+                # parent_comment_id is the parent comment (always present for replies)
+                parent_comment_id = None
+                if reply.parent_id.startswith("t1_"):
+                    parent_comment_id = strip_reddit_prefix(reply.parent_id)
+
+                reply_data = RedditComment(
+                    comment_id=reply.id,
+                    post_id=reply_post_id,
+                    parent_comment_id=parent_comment_id,
+                    author=str(reply.author) if reply.author else "[deleted]",
+                    body=reply.body,
+                    score=reply.score,
+                    created_utc=reply.created_utc,
+                    edited=bool(reply.edited),
+                    is_submitter=reply.is_submitter,
+                    permalink=reply.permalink,
+                    depth=reply.depth,
+                )
+                all_replies.append(reply_data)
+                yield "reply", reply_data
+            yield "replies", all_replies
+            yield "comment_id", input_data.comment_id
+            yield "post_id", input_data.post_id
+        except Exception as e:
+            yield "error", str(e)
+
+
+class GetRedditCommentBlock(Block):
+    """Get details about a specific Reddit comment."""
+
+    class Input(BlockSchemaInput):
+        credentials: RedditCredentialsInput = RedditCredentialsField()
+        comment_id: str = SchemaField(
+            description="The ID of the comment to fetch",
+        )
+
+    class Output(BlockSchemaOutput):
+        comment: RedditComment = SchemaField(description="The comment details")
+        error: str = SchemaField(
+            description="Error message if comment couldn't be fetched"
+        )
+
+    def __init__(self):
+        super().__init__(
+            id="72cb311a-5998-4e0a-9bc4-f1b67a97284e",
+            description="Get details about a specific Reddit comment by its ID.",
+            categories={BlockCategory.SOCIAL},
+            input_schema=GetRedditCommentBlock.Input,
+            output_schema=GetRedditCommentBlock.Output,
+            disabled=(
+                not settings.secrets.reddit_client_id
+                or not settings.secrets.reddit_client_secret
+            ),
+            test_credentials=TEST_CREDENTIALS,
+            test_input={
+                "credentials": TEST_CREDENTIALS_INPUT,
+                "comment_id": "comment1",
+            },
+            test_output=[
+                (
+                    "comment",
+                    RedditComment(
+                        comment_id="comment1",
+                        post_id="abc123",
+                        parent_comment_id=None,
+                        author="user1",
+                        body="Comment body",
+                        score=10,
+                        created_utc=1234567890.0,
+                        edited=False,
+                        is_submitter=False,
+                        permalink="/r/test/comments/abc123/test/comment1/",
+                        depth=0,
+                    ),
+                ),
+            ],
+            test_mock={
+                "get_comment": lambda creds, comment_id: MockObject(
+                    id="comment1",
+                    link_id="t3_abc123",
+                    parent_id="t3_abc123",
+                    author="user1",
+                    body="Comment body",
+                    score=10,
+                    created_utc=1234567890.0,
+                    edited=False,
+                    is_submitter=False,
+                    permalink="/r/test/comments/abc123/test/comment1/",
+                    depth=0,
+                )
+            },
+        )
+
+    @staticmethod
+    def get_comment(creds: RedditCredentials, comment_id: str):
+        client = get_praw(creds)
+        comment_id = strip_reddit_prefix(comment_id)
+        return client.comment(id=comment_id)
+
+    async def run(
+        self, input_data: Input, *, credentials: RedditCredentials, **kwargs
+    ) -> BlockOutput:
+        try:
+            comment = self.get_comment(credentials, input_data.comment_id)
+
+            post_id = strip_reddit_prefix(comment.link_id)
+
+            # parent_comment_id is None for top-level comments (parent is a post: t3_)
+            parent_comment_id = None
+            if comment.parent_id.startswith("t1_"):
+                parent_comment_id = strip_reddit_prefix(comment.parent_id)
+
+            comment_data = RedditComment(
+                comment_id=comment.id,
+                post_id=post_id,
+                parent_comment_id=parent_comment_id,
+                author=str(comment.author) if comment.author else "[deleted]",
+                body=comment.body,
+                score=comment.score,
+                created_utc=comment.created_utc,
+                edited=bool(comment.edited),
+                is_submitter=comment.is_submitter,
+                permalink=comment.permalink,
+                # depth is only available when comments are fetched as part of a tree,
+                # not when fetched directly by ID
+                depth=getattr(comment, "depth", 0),
+            )
+            yield "comment", comment_data
+        except Exception as e:
+            yield "error", str(e)
+
+
+class ReplyToRedditCommentBlock(Block):
+    """Reply to a specific Reddit comment."""
+
+    class Input(BlockSchemaInput):
+        credentials: RedditCredentialsInput = RedditCredentialsField()
+        comment_id: str = SchemaField(
+            description="The ID of the comment to reply to",
+        )
+        reply_text: str = SchemaField(
+            description="The text content of the reply",
+        )
+
+    class Output(BlockSchemaOutput):
+        comment_id: str = SchemaField(description="ID of the newly created reply")
+        parent_comment_id: str = SchemaField(
+            description="The parent comment ID (pass-through for chaining)"
+        )
+        error: str = SchemaField(description="Error message if reply failed")
+
+    def __init__(self):
+        super().__init__(
+            id="7635b059-3a9f-4f7d-b499-1b56c4f76f4f",
+            description="Reply to a specific Reddit comment. Useful for threaded conversations.",
+            categories={BlockCategory.SOCIAL},
+            input_schema=ReplyToRedditCommentBlock.Input,
+            output_schema=ReplyToRedditCommentBlock.Output,
+            disabled=(
+                not settings.secrets.reddit_client_id
+                or not settings.secrets.reddit_client_secret
+            ),
+            test_credentials=TEST_CREDENTIALS,
+            test_input={
+                "credentials": TEST_CREDENTIALS_INPUT,
+                "comment_id": "parent_comment",
+                "reply_text": "This is a reply",
+            },
+            test_output=[
+                ("comment_id", "new_reply_id"),
+                ("parent_comment_id", "parent_comment"),
+            ],
+            test_mock={
+                "reply_to_comment": lambda creds, comment_id, reply_text: "new_reply_id"
+            },
+        )
+
+    @staticmethod
+    def reply_to_comment(
+        creds: RedditCredentials, comment_id: str, reply_text: str
+    ) -> str:
+        client = get_praw(creds)
+        comment_id = strip_reddit_prefix(comment_id)
+        comment = client.comment(id=comment_id)
+        reply = comment.reply(reply_text)
+        if not reply:
+            raise ValueError("Failed to post reply.")
+        return reply.id
+
+    async def run(
+        self, input_data: Input, *, credentials: RedditCredentials, **kwargs
+    ) -> BlockOutput:
+        try:
+            new_comment_id = self.reply_to_comment(
+                credentials, input_data.comment_id, input_data.reply_text
+            )
+            yield "comment_id", new_comment_id
+            yield "parent_comment_id", input_data.comment_id
+        except Exception as e:
+            yield "error", str(e)
+
+
+class RedditUserProfileSubreddit(BaseModel):
+    """Information about a user's profile subreddit."""
+
+    name: str
+    title: str
+    public_description: str
+    subscribers: int
+    over_18: bool
+
+
+class RedditUserInfo(BaseModel):
+    """Information about a Reddit user."""
+
+    username: str
+    user_id: str
+    comment_karma: int
+    link_karma: int
+    total_karma: int
+    created_utc: float
+    is_gold: bool
+    is_mod: bool
+    has_verified_email: bool
+    moderated_subreddits: list[str]
+    profile_subreddit: RedditUserProfileSubreddit | None
+
+
+class GetRedditUserInfoBlock(Block):
+    """Get information about a Reddit user."""
+
+    class Input(BlockSchemaInput):
+        credentials: RedditCredentialsInput = RedditCredentialsField()
+        username: str = SchemaField(
+            description="The Reddit username to look up (without /u/ prefix)",
+        )
+
+    class Output(BlockSchemaOutput):
+        user: RedditUserInfo = SchemaField(description="User information")
+        username: str = SchemaField(
+            description="The username (pass-through for chaining)"
+        )
+        error: str = SchemaField(description="Error message if user lookup failed")
+
+    def __init__(self):
+        super().__init__(
+            id="1b4c6bd1-4f28-4bad-9ae9-e7034a0f61ff",
+            description="Get information about a Reddit user including karma, account age, and verification status.",
+            categories={BlockCategory.SOCIAL},
+            input_schema=GetRedditUserInfoBlock.Input,
+            output_schema=GetRedditUserInfoBlock.Output,
+            disabled=(
+                not settings.secrets.reddit_client_id
+                or not settings.secrets.reddit_client_secret
+            ),
+            test_credentials=TEST_CREDENTIALS,
+            test_input={
+                "credentials": TEST_CREDENTIALS_INPUT,
+                "username": "testuser",
+            },
+            test_output=[
+                (
+                    "user",
+                    RedditUserInfo(
+                        username="testuser",
+                        user_id="abc123",
+                        comment_karma=1000,
+                        link_karma=500,
+                        total_karma=1500,
+                        created_utc=1234567890.0,
+                        is_gold=False,
+                        is_mod=True,
+                        has_verified_email=True,
+                        moderated_subreddits=["python", "learnpython"],
+                        profile_subreddit=RedditUserProfileSubreddit(
+                            name="u_testuser",
+                            title="testuser's profile",
+                            public_description="A test user",
+                            subscribers=100,
+                            over_18=False,
+                        ),
+                    ),
+                ),
+                ("username", "testuser"),
+            ],
+            test_mock={
+                "get_user_info": lambda creds, username: MockObject(
+                    name="testuser",
+                    id="abc123",
+                    comment_karma=1000,
+                    link_karma=500,
+                    total_karma=1500,
+                    created_utc=1234567890.0,
+                    is_gold=False,
+                    is_mod=True,
+                    has_verified_email=True,
+                    subreddit=MockObject(
+                        display_name="u_testuser",
+                        title="testuser's profile",
+                        public_description="A test user",
+                        subscribers=100,
+                        over18=False,
+                    ),
+                ),
+                "get_moderated_subreddits": lambda creds, username: [
+                    MockObject(display_name="python"),
+                    MockObject(display_name="learnpython"),
+                ],
+            },
+        )
+
+    @staticmethod
+    def get_user_info(creds: RedditCredentials, username: str):
+        client = get_praw(creds)
+        if username.startswith("u/"):
+            username = username[2:]
+        return client.redditor(username)
+
+    @staticmethod
+    def get_moderated_subreddits(creds: RedditCredentials, username: str) -> list:
+        client = get_praw(creds)
+        if username.startswith("u/"):
+            username = username[2:]
+        redditor = client.redditor(username)
+        return list(redditor.moderated())
+
+    async def run(
+        self, input_data: Input, *, credentials: RedditCredentials, **kwargs
+    ) -> BlockOutput:
+        try:
+            redditor = self.get_user_info(credentials, input_data.username)
+            moderated = self.get_moderated_subreddits(credentials, input_data.username)
+
+            # Extract moderated subreddit names
+            moderated_subreddits = [sub.display_name for sub in moderated]
+
+            # Get profile subreddit info if available
+            profile_subreddit = None
+            if hasattr(redditor, "subreddit") and redditor.subreddit:
+                try:
+                    profile_subreddit = RedditUserProfileSubreddit(
+                        name=redditor.subreddit.display_name,
+                        title=redditor.subreddit.title or "",
+                        public_description=redditor.subreddit.public_description or "",
+                        subscribers=redditor.subreddit.subscribers or 0,
+                        over_18=(
+                            redditor.subreddit.over18
+                            if hasattr(redditor.subreddit, "over18")
+                            else False
+                        ),
+                    )
+                except Exception:
+                    # Profile subreddit may not be accessible
+                    pass
+
+            user_info = RedditUserInfo(
+                username=redditor.name,
+                user_id=redditor.id,
+                comment_karma=redditor.comment_karma,
+                link_karma=redditor.link_karma,
+                total_karma=redditor.total_karma,
+                created_utc=redditor.created_utc,
+                is_gold=redditor.is_gold,
+                is_mod=redditor.is_mod,
+                has_verified_email=redditor.has_verified_email,
+                moderated_subreddits=moderated_subreddits,
+                profile_subreddit=profile_subreddit,
+            )
+            yield "user", user_info
+            yield "username", input_data.username
+        except Exception as e:
+            yield "error", str(e)
+
+
+class SendRedditMessageBlock(Block):
+    """Send a private message to a Reddit user."""
+
+    class Input(BlockSchemaInput):
+        credentials: RedditCredentialsInput = RedditCredentialsField()
+        username: str = SchemaField(
+            description="The Reddit username to send a message to (without /u/ prefix)",
+        )
+        subject: str = SchemaField(
+            description="The subject line of the message",
+        )
+        message: str = SchemaField(
+            description="The body content of the message",
+        )
+
+    class Output(BlockSchemaOutput):
+        success: bool = SchemaField(description="Whether the message was sent")
+        username: str = SchemaField(
+            description="The username (pass-through for chaining)"
+        )
+        error: str = SchemaField(description="Error message if sending failed")
+
+    def __init__(self):
+        super().__init__(
+            id="7921101a-0537-4259-82ea-bc186ca6b1b6",
+            description="Send a private message (DM) to a Reddit user.",
+            categories={BlockCategory.SOCIAL},
+            input_schema=SendRedditMessageBlock.Input,
+            output_schema=SendRedditMessageBlock.Output,
+            disabled=(
+                not settings.secrets.reddit_client_id
+                or not settings.secrets.reddit_client_secret
+            ),
+            test_credentials=TEST_CREDENTIALS,
+            test_input={
+                "credentials": TEST_CREDENTIALS_INPUT,
+                "username": "testuser",
+                "subject": "Hello",
+                "message": "This is a test message",
+            },
+            test_output=[
+                ("success", True),
+                ("username", "testuser"),
+            ],
+            test_mock={"send_message": lambda creds, username, subject, message: True},
+        )
+
+    @staticmethod
+    def send_message(
+        creds: RedditCredentials, username: str, subject: str, message: str
+    ) -> bool:
+        client = get_praw(creds)
+        if username.startswith("u/"):
+            username = username[2:]
+        redditor = client.redditor(username)
+        redditor.message(subject=subject, message=message)
+        return True
+
+    async def run(
+        self, input_data: Input, *, credentials: RedditCredentials, **kwargs
+    ) -> BlockOutput:
+        try:
+            success = self.send_message(
+                credentials,
+                input_data.username,
+                input_data.subject,
+                input_data.message,
+            )
+            yield "success", success
+            yield "username", input_data.username
+        except Exception as e:
+            yield "error", str(e)
+
+
+class RedditInboxItem(BaseModel):
+    """A Reddit inbox item (message, comment reply, or mention)."""
+
+    item_id: str
+    item_type: str  # "message", "comment_reply", "mention"
+    subject: str
+    body: str
+    author: str
+    created_utc: float
+    is_read: bool
+    context: str | None  # permalink for comments, None for messages
+
+
+class GetRedditInboxBlock(Block):
+    """Get messages and notifications from Reddit inbox."""
+
+    class Input(BlockSchemaInput):
+        credentials: RedditCredentialsInput = RedditCredentialsField()
+        inbox_type: InboxType = SchemaField(
+            description="Type of inbox items to fetch",
+            default="unread",
+        )
+        limit: int = SchemaField(
+            description="Maximum number of items to fetch",
+            default=25,
+        )
+        mark_read: bool = SchemaField(
+            description="Whether to mark fetched items as read",
+            default=False,
+        )
+
+    class Output(BlockSchemaOutput):
+        item: RedditInboxItem = SchemaField(description="An inbox item")
+        items: list[RedditInboxItem] = SchemaField(description="All fetched items")
+        error: str = SchemaField(description="Error message if fetch failed")
+
+    def __init__(self):
+        super().__init__(
+            id="5a91bb34-7ffe-4b9e-957b-9d4f8fe8dbc9",
+            description="Get messages, mentions, and comment replies from your Reddit inbox.",
+            categories={BlockCategory.SOCIAL},
+            input_schema=GetRedditInboxBlock.Input,
+            output_schema=GetRedditInboxBlock.Output,
+            disabled=(
+                not settings.secrets.reddit_client_id
+                or not settings.secrets.reddit_client_secret
+            ),
+            test_credentials=TEST_CREDENTIALS,
+            test_input={
+                "credentials": TEST_CREDENTIALS_INPUT,
+                "inbox_type": "unread",
+                "limit": 10,
+            },
+            test_output=[
+                (
+                    "item",
+                    RedditInboxItem(
+                        item_id="msg123",
+                        item_type="message",
+                        subject="Hello",
+                        body="Test message body",
+                        author="sender_user",
+                        created_utc=1234567890.0,
+                        is_read=False,
+                        context=None,
+                    ),
+                ),
+                (
+                    "items",
+                    [
+                        RedditInboxItem(
+                            item_id="msg123",
+                            item_type="message",
+                            subject="Hello",
+                            body="Test message body",
+                            author="sender_user",
+                            created_utc=1234567890.0,
+                            is_read=False,
+                            context=None,
+                        ),
+                    ],
+                ),
+            ],
+            test_mock={
+                "get_inbox": lambda creds, inbox_type, limit: [
+                    MockObject(
+                        id="msg123",
+                        subject="Hello",
+                        body="Test message body",
+                        author="sender_user",
+                        created_utc=1234567890.0,
+                        new=True,
+                        context=None,
+                        was_comment=False,
+                    ),
+                ]
+            },
+        )
+
+    @staticmethod
+    def get_inbox(creds: RedditCredentials, inbox_type: InboxType, limit: int) -> list:
+        client = get_praw(creds)
+        inbox = client.inbox
+
+        if inbox_type == "all":
+            items = inbox.all(limit=limit)
+        elif inbox_type == "unread":
+            items = inbox.unread(limit=limit)
+        elif inbox_type == "messages":
+            items = inbox.messages(limit=limit)
+        elif inbox_type == "mentions":
+            items = inbox.mentions(limit=limit)
+        elif inbox_type == "comment_replies":
+            items = inbox.comment_replies(limit=limit)
+        else:
+            items = inbox.unread(limit=limit)
+
+        return list(items)
+
+    async def run(
+        self, input_data: Input, *, credentials: RedditCredentials, **kwargs
+    ) -> BlockOutput:
+        try:
+            raw_items = self.get_inbox(
+                credentials, input_data.inbox_type, input_data.limit
+            )
+            all_items = []
+
+            for item in raw_items:
+                # Determine item type
+                if hasattr(item, "was_comment") and item.was_comment:
+                    if hasattr(item, "subject") and "mention" in item.subject.lower():
+                        item_type = "mention"
+                    else:
+                        item_type = "comment_reply"
+                else:
+                    item_type = "message"
+
+                inbox_item = RedditInboxItem(
+                    item_id=item.id,
+                    item_type=item_type,
+                    subject=item.subject if hasattr(item, "subject") else "",
+                    body=item.body,
+                    author=str(item.author) if item.author else "[deleted]",
+                    created_utc=item.created_utc,
+                    is_read=not item.new,
+                    context=item.context if hasattr(item, "context") else None,
+                )
+                all_items.append(inbox_item)
+                yield "item", inbox_item
+
+            # Mark as read if requested
+            if input_data.mark_read and raw_items:
+                client = get_praw(credentials)
+                client.inbox.mark_read(raw_items)
+
+            yield "items", all_items
+        except Exception as e:
+            yield "error", str(e)
+
+
+class DeleteRedditPostBlock(Block):
+    """Delete a Reddit post that you own."""
+
+    class Input(BlockSchemaInput):
+        credentials: RedditCredentialsInput = RedditCredentialsField()
+        post_id: str = SchemaField(
+            description="The ID of the post to delete (must be your own post)",
+        )
+
+    class Output(BlockSchemaOutput):
+        success: bool = SchemaField(description="Whether the deletion was successful")
+        post_id: str = SchemaField(
+            description="The post ID (pass-through for chaining)"
+        )
+        error: str = SchemaField(description="Error message if deletion failed")
+
+    def __init__(self):
+        super().__init__(
+            id="72e4730a-d66d-4785-8e54-5ab3af450c81",
+            description="Delete a Reddit post that you own.",
+            categories={BlockCategory.SOCIAL},
+            input_schema=DeleteRedditPostBlock.Input,
+            output_schema=DeleteRedditPostBlock.Output,
+            disabled=(
+                not settings.secrets.reddit_client_id
+                or not settings.secrets.reddit_client_secret
+            ),
+            test_credentials=TEST_CREDENTIALS,
+            test_input={
+                "credentials": TEST_CREDENTIALS_INPUT,
+                "post_id": "abc123",
+            },
+            test_output=[
+                ("success", True),
+                ("post_id", "abc123"),
+            ],
+            test_mock={"delete_post": lambda creds, post_id: True},
+        )
+
+    @staticmethod
+    def delete_post(creds: RedditCredentials, post_id: str) -> bool:
+        client = get_praw(creds)
+        post_id = strip_reddit_prefix(post_id)
+        submission = client.submission(id=post_id)
+        submission.delete()
+        return True
+
+    async def run(
+        self, input_data: Input, *, credentials: RedditCredentials, **kwargs
+    ) -> BlockOutput:
+        try:
+            success = self.delete_post(credentials, input_data.post_id)
+            yield "success", success
+            yield "post_id", input_data.post_id
+        except Exception as e:
+            yield "error", str(e)
+
+
+class DeleteRedditCommentBlock(Block):
+    """Delete a Reddit comment that you own."""
+
+    class Input(BlockSchemaInput):
+        credentials: RedditCredentialsInput = RedditCredentialsField()
+        comment_id: str = SchemaField(
+            description="The ID of the comment to delete (must be your own comment)",
+        )
+
+    class Output(BlockSchemaOutput):
+        success: bool = SchemaField(description="Whether the deletion was successful")
+        comment_id: str = SchemaField(
+            description="The comment ID (pass-through for chaining)"
+        )
+        error: str = SchemaField(description="Error message if deletion failed")
+
+    def __init__(self):
+        super().__init__(
+            id="2650584d-434f-46db-81ef-26c8d8d41f81",
+            description="Delete a Reddit comment that you own.",
+            categories={BlockCategory.SOCIAL},
+            input_schema=DeleteRedditCommentBlock.Input,
+            output_schema=DeleteRedditCommentBlock.Output,
+            disabled=(
+                not settings.secrets.reddit_client_id
+                or not settings.secrets.reddit_client_secret
+            ),
+            test_credentials=TEST_CREDENTIALS,
+            test_input={
+                "credentials": TEST_CREDENTIALS_INPUT,
+                "comment_id": "xyz789",
+            },
+            test_output=[
+                ("success", True),
+                ("comment_id", "xyz789"),
+            ],
+            test_mock={"delete_comment": lambda creds, comment_id: True},
+        )
+
+    @staticmethod
+    def delete_comment(creds: RedditCredentials, comment_id: str) -> bool:
+        client = get_praw(creds)
+        comment_id = strip_reddit_prefix(comment_id)
+        comment = client.comment(id=comment_id)
+        comment.delete()
+        return True
+
+    async def run(
+        self, input_data: Input, *, credentials: RedditCredentials, **kwargs
+    ) -> BlockOutput:
+        try:
+            success = self.delete_comment(credentials, input_data.comment_id)
+            yield "success", success
+            yield "comment_id", input_data.comment_id
+        except Exception as e:
+            yield "error", str(e)
+
+
+class SubredditFlair(BaseModel):
+    """A subreddit link flair template."""
+
+    flair_id: str
+    text: str
+    text_editable: bool
+    css_class: str = ""  # The CSS class for styling (from flair_css_class)
+
+
+class GetSubredditFlairsBlock(Block):
+    """Get available link flairs for a subreddit."""
+
+    class Input(BlockSchemaInput):
+        credentials: RedditCredentialsInput = RedditCredentialsField()
+        subreddit: str = SchemaField(
+            description="Subreddit name (without /r/ prefix)",
+        )
+
+    class Output(BlockSchemaOutput):
+        flair: SubredditFlair = SchemaField(description="A flair option")
+        flairs: list[SubredditFlair] = SchemaField(description="All available flairs")
+        subreddit: str = SchemaField(
+            description="The subreddit name (pass-through for chaining)"
+        )
+        error: str = SchemaField(description="Error message if fetch failed")
+
+    def __init__(self):
+        super().__init__(
+            id="ada08f34-a7a9-44aa-869f-0638fa4e0a84",
+            description="Get available link flair options for a subreddit.",
+            categories={BlockCategory.SOCIAL},
+            input_schema=GetSubredditFlairsBlock.Input,
+            output_schema=GetSubredditFlairsBlock.Output,
+            disabled=(
+                not settings.secrets.reddit_client_id
+                or not settings.secrets.reddit_client_secret
+            ),
+            test_credentials=TEST_CREDENTIALS,
+            test_input={
+                "credentials": TEST_CREDENTIALS_INPUT,
+                "subreddit": "test",
+            },
+            test_output=[
+                (
+                    "flair",
+                    SubredditFlair(
+                        flair_id="abc123",
+                        text="Discussion",
+                        text_editable=False,
+                        css_class="discussion",
+                    ),
+                ),
+                (
+                    "flairs",
+                    [
+                        SubredditFlair(
+                            flair_id="abc123",
+                            text="Discussion",
+                            text_editable=False,
+                            css_class="discussion",
+                        ),
+                    ],
+                ),
+                ("subreddit", "test"),
+            ],
+            test_mock={
+                "get_flairs": lambda creds, subreddit: [
+                    {
+                        "flair_template_id": "abc123",
+                        "flair_text": "Discussion",
+                        "flair_text_editable": False,
+                        "flair_css_class": "discussion",
+                    },
+                ]
+            },
+        )
+
+    @staticmethod
+    def get_flairs(creds: RedditCredentials, subreddit: str) -> list:
+        client = get_praw(creds)
+        # Use /r/{subreddit}/api/flairselector endpoint directly with is_newlink=True
+        # This returns link flairs available for new submissions without requiring mod access
+        # The link_templates API is moderator-only, so we use flairselector instead
+        # Path must include the subreddit prefix per Reddit API docs
+        response = client.post(
+            f"r/{subreddit}/api/flairselector",
+            data={"is_newlink": "true"},
+        )
+        # Response contains 'choices' list with available flairs
+        choices = response.get("choices", [])
+        return choices
+
+    async def run(
+        self, input_data: Input, *, credentials: RedditCredentials, **kwargs
+    ) -> BlockOutput:
+        try:
+            raw_flairs = self.get_flairs(credentials, input_data.subreddit)
+            all_flairs = []
+
+            for flair in raw_flairs:
+                # /api/flairselector returns flairs with flair_template_id, flair_text, etc.
+                flair_data = SubredditFlair(
+                    flair_id=flair.get("flair_template_id", ""),
+                    text=flair.get("flair_text", ""),
+                    text_editable=flair.get("flair_text_editable", False),
+                    css_class=flair.get("flair_css_class", ""),
+                )
+                all_flairs.append(flair_data)
+                yield "flair", flair_data
+
+            yield "flairs", all_flairs
+            yield "subreddit", input_data.subreddit
+        except Exception as e:
+            yield "error", str(e)
+
+
+class SubredditRule(BaseModel):
+    """A subreddit rule."""
+
+    short_name: str
+    description: str
+    kind: str  # "all", "link", "comment"
+    violation_reason: str
+    priority: int
+
+
+class GetSubredditRulesBlock(Block):
+    """Get the rules for a subreddit."""
+
+    class Input(BlockSchemaInput):
+        credentials: RedditCredentialsInput = RedditCredentialsField()
+        subreddit: str = SchemaField(
+            description="Subreddit name (without /r/ prefix)",
+        )
+
+    class Output(BlockSchemaOutput):
+        rule: SubredditRule = SchemaField(description="A subreddit rule")
+        rules: list[SubredditRule] = SchemaField(description="All subreddit rules")
+        subreddit: str = SchemaField(
+            description="The subreddit name (pass-through for chaining)"
+        )
+        error: str = SchemaField(description="Error message if fetch failed")
+
+    def __init__(self):
+        super().__init__(
+            id="222aa36c-fa70-4879-8e8a-37d100175f5c",
+            description="Get the rules for a subreddit to ensure compliance before posting.",
+            categories={BlockCategory.SOCIAL},
+            input_schema=GetSubredditRulesBlock.Input,
+            output_schema=GetSubredditRulesBlock.Output,
+            disabled=(
+                not settings.secrets.reddit_client_id
+                or not settings.secrets.reddit_client_secret
+            ),
+            test_credentials=TEST_CREDENTIALS,
+            test_input={
+                "credentials": TEST_CREDENTIALS_INPUT,
+                "subreddit": "test",
+            },
+            test_output=[
+                (
+                    "rule",
+                    SubredditRule(
+                        short_name="No spam",
+                        description="Do not post spam or self-promotional content.",
+                        kind="all",
+                        violation_reason="Spam",
+                        priority=0,
+                    ),
+                ),
+                (
+                    "rules",
+                    [
+                        SubredditRule(
+                            short_name="No spam",
+                            description="Do not post spam or self-promotional content.",
+                            kind="all",
+                            violation_reason="Spam",
+                            priority=0,
+                        ),
+                    ],
+                ),
+                ("subreddit", "test"),
+            ],
+            test_mock={
+                "get_rules": lambda creds, subreddit: [
+                    MockObject(
+                        short_name="No spam",
+                        description="Do not post spam or self-promotional content.",
+                        kind="all",
+                        violation_reason="Spam",
+                        priority=0,
+                    ),
+                ]
+            },
+        )
+
+    @staticmethod
+    def get_rules(creds: RedditCredentials, subreddit: str) -> list:
+        client = get_praw(creds)
+        sub = client.subreddit(subreddit)
+        return list(sub.rules)
+
+    async def run(
+        self, input_data: Input, *, credentials: RedditCredentials, **kwargs
+    ) -> BlockOutput:
+        try:
+            raw_rules = self.get_rules(credentials, input_data.subreddit)
+            all_rules = []
+
+            for idx, rule in enumerate(raw_rules):
+                rule_data = SubredditRule(
+                    short_name=rule.short_name,
+                    description=rule.description or "",
+                    kind=rule.kind,
+                    violation_reason=rule.violation_reason or rule.short_name,
+                    priority=idx,
+                )
+                all_rules.append(rule_data)
+                yield "rule", rule_data
+
+            yield "rules", all_rules
+            yield "subreddit", input_data.subreddit
+        except Exception as e:
+            yield "error", str(e)
diff --git a/autogpt_platform/backend/backend/blocks/search.py b/autogpt_platform/backend/backend/blocks/search.py
index 2d10dffab6..09e16034a3 100644
--- a/autogpt_platform/backend/backend/blocks/search.py
+++ b/autogpt_platform/backend/backend/blocks/search.py
@@ -18,6 +18,7 @@ from backend.data.model import (
     SchemaField,
 )
 from backend.integrations.providers import ProviderName
+from backend.util.request import DEFAULT_USER_AGENT
 
 
 class GetWikipediaSummaryBlock(Block, GetRequest):
@@ -39,17 +40,27 @@ class GetWikipediaSummaryBlock(Block, GetRequest):
             output_schema=GetWikipediaSummaryBlock.Output,
             test_input={"topic": "Artificial Intelligence"},
             test_output=("summary", "summary content"),
-            test_mock={"get_request": lambda url, json: {"extract": "summary content"}},
+            test_mock={
+                "get_request": lambda url, headers, json: {"extract": "summary content"}
+            },
         )
 
     async def run(self, input_data: Input, **kwargs) -> BlockOutput:
         topic = input_data.topic
-        url = f"https://en.wikipedia.org/api/rest_v1/page/summary/{topic}"
+        # URL-encode the topic to handle spaces and special characters
+        encoded_topic = quote(topic, safe="")
+        url = f"https://en.wikipedia.org/api/rest_v1/page/summary/{encoded_topic}"
+
+        # Set headers per Wikimedia robot policy (https://w.wiki/4wJS)
+        # - User-Agent: Required, must identify the bot
+        # - Accept-Encoding: gzip recommended to reduce bandwidth
+        headers = {
+            "User-Agent": DEFAULT_USER_AGENT,
+            "Accept-Encoding": "gzip, deflate",
+        }
 
-        # Note: User-Agent is now automatically set by the request library
-        # to comply with Wikimedia's robot policy (https://w.wiki/4wJS)
         try:
-            response = await self.get_request(url, json=True)
+            response = await self.get_request(url, headers=headers, json=True)
             if "extract" not in response:
                 raise ValueError(f"Unable to parse Wikipedia response: {response}")
             yield "summary", response["extract"]
diff --git a/autogpt_platform/backend/backend/blocks/smart_decision_maker.py b/autogpt_platform/backend/backend/blocks/smart_decision_maker.py
index e2e5cfa3e4..ff6042eaab 100644
--- a/autogpt_platform/backend/backend/blocks/smart_decision_maker.py
+++ b/autogpt_platform/backend/backend/blocks/smart_decision_maker.py
@@ -226,7 +226,7 @@ class SmartDecisionMakerBlock(Block):
         )
         model: llm.LlmModel = SchemaField(
             title="LLM Model",
-            default=llm.LlmModel.GPT4O,
+            default=llm.DEFAULT_LLM_MODEL,
             description="The language model to use for answering the prompt.",
             advanced=False,
         )
@@ -391,8 +391,12 @@ class SmartDecisionMakerBlock(Block):
         """
         block = sink_node.block
 
+        # Use custom name from node metadata if set, otherwise fall back to block.name
+        custom_name = sink_node.metadata.get("customized_name")
+        tool_name = custom_name if custom_name else block.name
+
         tool_function: dict[str, Any] = {
-            "name": SmartDecisionMakerBlock.cleanup(block.name),
+            "name": SmartDecisionMakerBlock.cleanup(tool_name),
             "description": block.description,
         }
         sink_block_input_schema = block.input_schema
@@ -489,14 +493,24 @@ class SmartDecisionMakerBlock(Block):
                 f"Sink graph metadata not found: {graph_id} {graph_version}"
             )
 
+        # Use custom name from node metadata if set, otherwise fall back to graph name
+        custom_name = sink_node.metadata.get("customized_name")
+        tool_name = custom_name if custom_name else sink_graph_meta.name
+
         tool_function: dict[str, Any] = {
-            "name": SmartDecisionMakerBlock.cleanup(sink_graph_meta.name),
+            "name": SmartDecisionMakerBlock.cleanup(tool_name),
             "description": sink_graph_meta.description,
         }
 
         properties = {}
+        field_mapping = {}
 
         for link in links:
+            field_name = link.sink_name
+
+            clean_field_name = SmartDecisionMakerBlock.cleanup(field_name)
+            field_mapping[clean_field_name] = field_name
+
             sink_block_input_schema = sink_node.input_default["input_schema"]
             sink_block_properties = sink_block_input_schema.get("properties", {}).get(
                 link.sink_name, {}
@@ -506,7 +520,7 @@ class SmartDecisionMakerBlock(Block):
                 if "description" in sink_block_properties
                 else f"The {link.sink_name} of the tool"
             )
-            properties[link.sink_name] = {
+            properties[clean_field_name] = {
                 "type": "string",
                 "description": description,
                 "default": json.dumps(sink_block_properties.get("default", None)),
@@ -519,7 +533,7 @@ class SmartDecisionMakerBlock(Block):
             "strict": True,
         }
 
-        # Store node info for later use in output processing
+        tool_function["_field_mapping"] = field_mapping
         tool_function["_sink_node_id"] = sink_node.id
 
         return {"type": "function", "function": tool_function}
@@ -975,10 +989,28 @@ class SmartDecisionMakerBlock(Block):
         graph_version: int,
         execution_context: ExecutionContext,
         execution_processor: "ExecutionProcessor",
+        nodes_to_skip: set[str] | None = None,
         **kwargs,
     ) -> BlockOutput:
 
         tool_functions = await self._create_tool_node_signatures(node_id)
+        original_tool_count = len(tool_functions)
+
+        # Filter out tools for nodes that should be skipped (e.g., missing optional credentials)
+        if nodes_to_skip:
+            tool_functions = [
+                tf
+                for tf in tool_functions
+                if tf.get("function", {}).get("_sink_node_id") not in nodes_to_skip
+            ]
+
+            # Only raise error if we had tools but they were all filtered out
+            if original_tool_count > 0 and not tool_functions:
+                raise ValueError(
+                    "No available tools to execute - all downstream nodes are unavailable "
+                    "(possibly due to missing optional credentials)"
+                )
+
         yield "tool_functions", json.dumps(tool_functions)
 
         conversation_history = input_data.conversation_history or []
@@ -1129,8 +1161,9 @@ class SmartDecisionMakerBlock(Block):
                 original_field_name = field_mapping.get(clean_arg_name, clean_arg_name)
                 arg_value = tool_args.get(clean_arg_name)
 
-                sanitized_arg_name = self.cleanup(original_field_name)
-                emit_key = f"tools_^_{sink_node_id}_~_{sanitized_arg_name}"
+                # Use original_field_name directly (not sanitized) to match link sink_name
+                # The field_mapping already translates from LLM's cleaned names to original names
+                emit_key = f"tools_^_{sink_node_id}_~_{original_field_name}"
 
                 logger.debug(
                     "[SmartDecisionMakerBlock|geid:%s|neid:%s] emit %s",
diff --git a/autogpt_platform/backend/backend/blocks/talking_head.py b/autogpt_platform/backend/backend/blocks/talking_head.py
index b33561d7aa..7a466bec7e 100644
--- a/autogpt_platform/backend/backend/blocks/talking_head.py
+++ b/autogpt_platform/backend/backend/blocks/talking_head.py
@@ -50,7 +50,7 @@ class CreateTalkingAvatarVideoBlock(Block):
             description="The voice provider to use", default="microsoft"
         )
         voice_id: str = SchemaField(
-            description="The voice ID to use, get list of voices [here](https://docs.agpt.co/server/d_id)",
+            description="The voice ID to use, see [available voice IDs](https://agpt.co/docs/platform/using-ai-services/d_id)",
             default="en-US-JennyNeural",
         )
         presenter_id: str = SchemaField(
diff --git a/autogpt_platform/backend/backend/blocks/test/test_blocks_dos_vulnerability.py b/autogpt_platform/backend/backend/blocks/test/test_blocks_dos_vulnerability.py
index 87bf102099..389bb5c636 100644
--- a/autogpt_platform/backend/backend/blocks/test/test_blocks_dos_vulnerability.py
+++ b/autogpt_platform/backend/backend/blocks/test/test_blocks_dos_vulnerability.py
@@ -196,6 +196,15 @@ class TestXMLParserBlockSecurity:
             async for _ in block.run(XMLParserBlock.Input(input_xml=large_xml)):
                 pass
 
+    async def test_rejects_text_outside_root(self):
+        """Ensure parser surfaces readable errors for invalid root text."""
+        block = XMLParserBlock()
+        invalid_xml = "<root><child>value</child></root> trailing"
+
+        with pytest.raises(ValueError, match="text outside the root element"):
+            async for _ in block.run(XMLParserBlock.Input(input_xml=invalid_xml)):
+                pass
+
 
 class TestStoreMediaFileSecurity:
     """Test file storage security limits."""
diff --git a/autogpt_platform/backend/backend/blocks/test/test_llm.py b/autogpt_platform/backend/backend/blocks/test/test_llm.py
index 090587767a..ea8760d313 100644
--- a/autogpt_platform/backend/backend/blocks/test/test_llm.py
+++ b/autogpt_platform/backend/backend/blocks/test/test_llm.py
@@ -28,7 +28,7 @@ class TestLLMStatsTracking:
 
             response = await llm.llm_call(
                 credentials=llm.TEST_CREDENTIALS,
-                llm_model=llm.LlmModel.GPT4O,
+                llm_model=llm.DEFAULT_LLM_MODEL,
                 prompt=[{"role": "user", "content": "Hello"}],
                 max_tokens=100,
             )
@@ -65,7 +65,7 @@ class TestLLMStatsTracking:
         input_data = llm.AIStructuredResponseGeneratorBlock.Input(
             prompt="Test prompt",
             expected_format={"key1": "desc1", "key2": "desc2"},
-            model=llm.LlmModel.GPT4O,
+            model=llm.DEFAULT_LLM_MODEL,
             credentials=llm.TEST_CREDENTIALS_INPUT,  # type: ignore  # type: ignore
         )
 
@@ -109,7 +109,7 @@ class TestLLMStatsTracking:
         # Run the block
         input_data = llm.AITextGeneratorBlock.Input(
             prompt="Generate text",
-            model=llm.LlmModel.GPT4O,
+            model=llm.DEFAULT_LLM_MODEL,
             credentials=llm.TEST_CREDENTIALS_INPUT,  # type: ignore
         )
 
@@ -170,7 +170,7 @@ class TestLLMStatsTracking:
         input_data = llm.AIStructuredResponseGeneratorBlock.Input(
             prompt="Test prompt",
             expected_format={"key1": "desc1", "key2": "desc2"},
-            model=llm.LlmModel.GPT4O,
+            model=llm.DEFAULT_LLM_MODEL,
             credentials=llm.TEST_CREDENTIALS_INPUT,  # type: ignore
             retry=2,
         )
@@ -228,7 +228,7 @@ class TestLLMStatsTracking:
 
         input_data = llm.AITextSummarizerBlock.Input(
             text=long_text,
-            model=llm.LlmModel.GPT4O,
+            model=llm.DEFAULT_LLM_MODEL,
             credentials=llm.TEST_CREDENTIALS_INPUT,  # type: ignore
             max_tokens=100,  # Small chunks
             chunk_overlap=10,
@@ -299,7 +299,7 @@ class TestLLMStatsTracking:
             # Test with very short text (should only need 1 chunk + 1 final summary)
             input_data = llm.AITextSummarizerBlock.Input(
                 text="This is a short text.",
-                model=llm.LlmModel.GPT4O,
+                model=llm.DEFAULT_LLM_MODEL,
                 credentials=llm.TEST_CREDENTIALS_INPUT,  # type: ignore
                 max_tokens=1000,  # Large enough to avoid chunking
             )
@@ -346,7 +346,7 @@ class TestLLMStatsTracking:
                 {"role": "assistant", "content": "Hi there!"},
                 {"role": "user", "content": "How are you?"},
             ],
-            model=llm.LlmModel.GPT4O,
+            model=llm.DEFAULT_LLM_MODEL,
             credentials=llm.TEST_CREDENTIALS_INPUT,  # type: ignore
         )
 
@@ -387,7 +387,7 @@ class TestLLMStatsTracking:
         # Run the block
         input_data = llm.AIListGeneratorBlock.Input(
             focus="test items",
-            model=llm.LlmModel.GPT4O,
+            model=llm.DEFAULT_LLM_MODEL,
             credentials=llm.TEST_CREDENTIALS_INPUT,  # type: ignore
             max_retries=3,
         )
@@ -469,7 +469,7 @@ class TestLLMStatsTracking:
         input_data = llm.AIStructuredResponseGeneratorBlock.Input(
             prompt="Test",
             expected_format={"result": "desc"},
-            model=llm.LlmModel.GPT4O,
+            model=llm.DEFAULT_LLM_MODEL,
             credentials=llm.TEST_CREDENTIALS_INPUT,  # type: ignore
         )
 
@@ -513,7 +513,7 @@ class TestAITextSummarizerValidation:
         # Create input data
         input_data = llm.AITextSummarizerBlock.Input(
             text="Some text to summarize",
-            model=llm.LlmModel.GPT4O,
+            model=llm.DEFAULT_LLM_MODEL,
             credentials=llm.TEST_CREDENTIALS_INPUT,  # type: ignore
             style=llm.SummaryStyle.BULLET_POINTS,
         )
@@ -558,7 +558,7 @@ class TestAITextSummarizerValidation:
         # Create input data
         input_data = llm.AITextSummarizerBlock.Input(
             text="Some text to summarize",
-            model=llm.LlmModel.GPT4O,
+            model=llm.DEFAULT_LLM_MODEL,
             credentials=llm.TEST_CREDENTIALS_INPUT,  # type: ignore
             style=llm.SummaryStyle.BULLET_POINTS,
             max_tokens=1000,
@@ -593,7 +593,7 @@ class TestAITextSummarizerValidation:
         # Create input data
         input_data = llm.AITextSummarizerBlock.Input(
             text="Some text to summarize",
-            model=llm.LlmModel.GPT4O,
+            model=llm.DEFAULT_LLM_MODEL,
             credentials=llm.TEST_CREDENTIALS_INPUT,  # type: ignore
         )
 
@@ -623,7 +623,7 @@ class TestAITextSummarizerValidation:
         # Create input data
         input_data = llm.AITextSummarizerBlock.Input(
             text="Some text to summarize",
-            model=llm.LlmModel.GPT4O,
+            model=llm.DEFAULT_LLM_MODEL,
             credentials=llm.TEST_CREDENTIALS_INPUT,  # type: ignore
             max_tokens=1000,
         )
@@ -654,7 +654,7 @@ class TestAITextSummarizerValidation:
         # Create input data
         input_data = llm.AITextSummarizerBlock.Input(
             text="Some text to summarize",
-            model=llm.LlmModel.GPT4O,
+            model=llm.DEFAULT_LLM_MODEL,
             credentials=llm.TEST_CREDENTIALS_INPUT,  # type: ignore
         )
 
diff --git a/autogpt_platform/backend/backend/blocks/test/test_smart_decision_maker.py b/autogpt_platform/backend/backend/blocks/test/test_smart_decision_maker.py
index deff4278f9..8266d433ad 100644
--- a/autogpt_platform/backend/backend/blocks/test/test_smart_decision_maker.py
+++ b/autogpt_platform/backend/backend/blocks/test/test_smart_decision_maker.py
@@ -233,7 +233,7 @@ async def test_smart_decision_maker_tracks_llm_stats():
         # Create test input
         input_data = SmartDecisionMakerBlock.Input(
             prompt="Should I continue with this task?",
-            model=llm_module.LlmModel.GPT4O,
+            model=llm_module.DEFAULT_LLM_MODEL,
             credentials=llm_module.TEST_CREDENTIALS_INPUT,  # type: ignore
             agent_mode_max_iterations=0,
         )
@@ -335,7 +335,7 @@ async def test_smart_decision_maker_parameter_validation():
 
         input_data = SmartDecisionMakerBlock.Input(
             prompt="Search for keywords",
-            model=llm_module.LlmModel.GPT4O,
+            model=llm_module.DEFAULT_LLM_MODEL,
             credentials=llm_module.TEST_CREDENTIALS_INPUT,  # type: ignore
             retry=2,  # Set retry to 2 for testing
             agent_mode_max_iterations=0,
@@ -402,7 +402,7 @@ async def test_smart_decision_maker_parameter_validation():
 
         input_data = SmartDecisionMakerBlock.Input(
             prompt="Search for keywords",
-            model=llm_module.LlmModel.GPT4O,
+            model=llm_module.DEFAULT_LLM_MODEL,
             credentials=llm_module.TEST_CREDENTIALS_INPUT,  # type: ignore
             agent_mode_max_iterations=0,
         )
@@ -462,7 +462,7 @@ async def test_smart_decision_maker_parameter_validation():
 
         input_data = SmartDecisionMakerBlock.Input(
             prompt="Search for keywords",
-            model=llm_module.LlmModel.GPT4O,
+            model=llm_module.DEFAULT_LLM_MODEL,
             credentials=llm_module.TEST_CREDENTIALS_INPUT,  # type: ignore
             agent_mode_max_iterations=0,
         )
@@ -526,7 +526,7 @@ async def test_smart_decision_maker_parameter_validation():
 
         input_data = SmartDecisionMakerBlock.Input(
             prompt="Search for keywords",
-            model=llm_module.LlmModel.GPT4O,
+            model=llm_module.DEFAULT_LLM_MODEL,
             credentials=llm_module.TEST_CREDENTIALS_INPUT,  # type: ignore
             agent_mode_max_iterations=0,
         )
@@ -648,7 +648,7 @@ async def test_smart_decision_maker_raw_response_conversion():
 
         input_data = SmartDecisionMakerBlock.Input(
             prompt="Test prompt",
-            model=llm_module.LlmModel.GPT4O,
+            model=llm_module.DEFAULT_LLM_MODEL,
             credentials=llm_module.TEST_CREDENTIALS_INPUT,  # type: ignore
             retry=2,
             agent_mode_max_iterations=0,
@@ -722,7 +722,7 @@ async def test_smart_decision_maker_raw_response_conversion():
     ):
         input_data = SmartDecisionMakerBlock.Input(
             prompt="Simple prompt",
-            model=llm_module.LlmModel.GPT4O,
+            model=llm_module.DEFAULT_LLM_MODEL,
             credentials=llm_module.TEST_CREDENTIALS_INPUT,  # type: ignore
             agent_mode_max_iterations=0,
         )
@@ -778,7 +778,7 @@ async def test_smart_decision_maker_raw_response_conversion():
     ):
         input_data = SmartDecisionMakerBlock.Input(
             prompt="Another test",
-            model=llm_module.LlmModel.GPT4O,
+            model=llm_module.DEFAULT_LLM_MODEL,
             credentials=llm_module.TEST_CREDENTIALS_INPUT,  # type: ignore
             agent_mode_max_iterations=0,
         )
@@ -931,7 +931,7 @@ async def test_smart_decision_maker_agent_mode():
         # Test agent mode with max_iterations = 3
         input_data = SmartDecisionMakerBlock.Input(
             prompt="Complete this task using tools",
-            model=llm_module.LlmModel.GPT4O,
+            model=llm_module.DEFAULT_LLM_MODEL,
             credentials=llm_module.TEST_CREDENTIALS_INPUT,  # type: ignore
             agent_mode_max_iterations=3,  # Enable agent mode with 3 max iterations
         )
@@ -1020,7 +1020,7 @@ async def test_smart_decision_maker_traditional_mode_default():
         # Test default behavior (traditional mode)
         input_data = SmartDecisionMakerBlock.Input(
             prompt="Test prompt",
-            model=llm_module.LlmModel.GPT4O,
+            model=llm_module.DEFAULT_LLM_MODEL,
             credentials=llm_module.TEST_CREDENTIALS_INPUT,  # type: ignore
             agent_mode_max_iterations=0,  # Traditional mode
         )
@@ -1057,3 +1057,153 @@ async def test_smart_decision_maker_traditional_mode_default():
         )  # Should yield individual tool parameters
         assert "tools_^_test-sink-node-id_~_max_keyword_difficulty" in outputs
         assert "conversations" in outputs
+
+
+@pytest.mark.asyncio
+async def test_smart_decision_maker_uses_customized_name_for_blocks():
+    """Test that SmartDecisionMakerBlock uses customized_name from node metadata for tool names."""
+    from unittest.mock import MagicMock
+
+    from backend.blocks.basic import StoreValueBlock
+    from backend.blocks.smart_decision_maker import SmartDecisionMakerBlock
+    from backend.data.graph import Link, Node
+
+    # Create a mock node with customized_name in metadata
+    mock_node = MagicMock(spec=Node)
+    mock_node.id = "test-node-id"
+    mock_node.block_id = StoreValueBlock().id
+    mock_node.metadata = {"customized_name": "My Custom Tool Name"}
+    mock_node.block = StoreValueBlock()
+
+    # Create a mock link
+    mock_link = MagicMock(spec=Link)
+    mock_link.sink_name = "input"
+
+    # Call the function directly
+    result = await SmartDecisionMakerBlock._create_block_function_signature(
+        mock_node, [mock_link]
+    )
+
+    # Verify the tool name uses the customized name (cleaned up)
+    assert result["type"] == "function"
+    assert result["function"]["name"] == "my_custom_tool_name"  # Cleaned version
+    assert result["function"]["_sink_node_id"] == "test-node-id"
+
+
+@pytest.mark.asyncio
+async def test_smart_decision_maker_falls_back_to_block_name():
+    """Test that SmartDecisionMakerBlock falls back to block.name when no customized_name."""
+    from unittest.mock import MagicMock
+
+    from backend.blocks.basic import StoreValueBlock
+    from backend.blocks.smart_decision_maker import SmartDecisionMakerBlock
+    from backend.data.graph import Link, Node
+
+    # Create a mock node without customized_name
+    mock_node = MagicMock(spec=Node)
+    mock_node.id = "test-node-id"
+    mock_node.block_id = StoreValueBlock().id
+    mock_node.metadata = {}  # No customized_name
+    mock_node.block = StoreValueBlock()
+
+    # Create a mock link
+    mock_link = MagicMock(spec=Link)
+    mock_link.sink_name = "input"
+
+    # Call the function directly
+    result = await SmartDecisionMakerBlock._create_block_function_signature(
+        mock_node, [mock_link]
+    )
+
+    # Verify the tool name uses the block's default name
+    assert result["type"] == "function"
+    assert result["function"]["name"] == "storevalueblock"  # Default block name cleaned
+    assert result["function"]["_sink_node_id"] == "test-node-id"
+
+
+@pytest.mark.asyncio
+async def test_smart_decision_maker_uses_customized_name_for_agents():
+    """Test that SmartDecisionMakerBlock uses customized_name from metadata for agent nodes."""
+    from unittest.mock import AsyncMock, MagicMock, patch
+
+    from backend.blocks.smart_decision_maker import SmartDecisionMakerBlock
+    from backend.data.graph import Link, Node
+
+    # Create a mock node with customized_name in metadata
+    mock_node = MagicMock(spec=Node)
+    mock_node.id = "test-agent-node-id"
+    mock_node.metadata = {"customized_name": "My Custom Agent"}
+    mock_node.input_default = {
+        "graph_id": "test-graph-id",
+        "graph_version": 1,
+        "input_schema": {"properties": {"test_input": {"description": "Test input"}}},
+    }
+
+    # Create a mock link
+    mock_link = MagicMock(spec=Link)
+    mock_link.sink_name = "test_input"
+
+    # Mock the database client
+    mock_graph_meta = MagicMock()
+    mock_graph_meta.name = "Original Agent Name"
+    mock_graph_meta.description = "Agent description"
+
+    mock_db_client = AsyncMock()
+    mock_db_client.get_graph_metadata.return_value = mock_graph_meta
+
+    with patch(
+        "backend.blocks.smart_decision_maker.get_database_manager_async_client",
+        return_value=mock_db_client,
+    ):
+        result = await SmartDecisionMakerBlock._create_agent_function_signature(
+            mock_node, [mock_link]
+        )
+
+    # Verify the tool name uses the customized name (cleaned up)
+    assert result["type"] == "function"
+    assert result["function"]["name"] == "my_custom_agent"  # Cleaned version
+    assert result["function"]["_sink_node_id"] == "test-agent-node-id"
+
+
+@pytest.mark.asyncio
+async def test_smart_decision_maker_agent_falls_back_to_graph_name():
+    """Test that agent node falls back to graph name when no customized_name."""
+    from unittest.mock import AsyncMock, MagicMock, patch
+
+    from backend.blocks.smart_decision_maker import SmartDecisionMakerBlock
+    from backend.data.graph import Link, Node
+
+    # Create a mock node without customized_name
+    mock_node = MagicMock(spec=Node)
+    mock_node.id = "test-agent-node-id"
+    mock_node.metadata = {}  # No customized_name
+    mock_node.input_default = {
+        "graph_id": "test-graph-id",
+        "graph_version": 1,
+        "input_schema": {"properties": {"test_input": {"description": "Test input"}}},
+    }
+
+    # Create a mock link
+    mock_link = MagicMock(spec=Link)
+    mock_link.sink_name = "test_input"
+
+    # Mock the database client
+    mock_graph_meta = MagicMock()
+    mock_graph_meta.name = "Original Agent Name"
+    mock_graph_meta.description = "Agent description"
+
+    mock_db_client = AsyncMock()
+    mock_db_client.get_graph_metadata.return_value = mock_graph_meta
+
+    with patch(
+        "backend.blocks.smart_decision_maker.get_database_manager_async_client",
+        return_value=mock_db_client,
+    ):
+        result = await SmartDecisionMakerBlock._create_agent_function_signature(
+            mock_node, [mock_link]
+        )
+
+    # Verify the tool name uses the graph's default name
+    assert result["type"] == "function"
+    assert result["function"]["name"] == "original_agent_name"  # Graph name cleaned
+    assert result["function"]["_sink_node_id"] == "test-agent-node-id"
diff --git a/autogpt_platform/backend/backend/blocks/test/test_smart_decision_maker_dict.py b/autogpt_platform/backend/backend/blocks/test/test_smart_decision_maker_dict.py
index 839bdc5e15..2087c0b7d6 100644
--- a/autogpt_platform/backend/backend/blocks/test/test_smart_decision_maker_dict.py
+++ b/autogpt_platform/backend/backend/blocks/test/test_smart_decision_maker_dict.py
@@ -15,6 +15,7 @@ async def test_smart_decision_maker_handles_dynamic_dict_fields():
     mock_node.block = CreateDictionaryBlock()
     mock_node.block_id = CreateDictionaryBlock().id
     mock_node.input_default = {}
+    mock_node.metadata = {}
 
     # Create mock links with dynamic dictionary fields
     mock_links = [
@@ -77,6 +78,7 @@ async def test_smart_decision_maker_handles_dynamic_list_fields():
     mock_node.block = AddToListBlock()
     mock_node.block_id = AddToListBlock().id
     mock_node.input_default = {}
+    mock_node.metadata = {}
 
     # Create mock links with dynamic list fields
     mock_links = [
diff --git a/autogpt_platform/backend/backend/blocks/test/test_smart_decision_maker_dynamic_fields.py b/autogpt_platform/backend/backend/blocks/test/test_smart_decision_maker_dynamic_fields.py
index d6a0c0fe39..af89a83f86 100644
--- a/autogpt_platform/backend/backend/blocks/test/test_smart_decision_maker_dynamic_fields.py
+++ b/autogpt_platform/backend/backend/blocks/test/test_smart_decision_maker_dynamic_fields.py
@@ -44,6 +44,7 @@ async def test_create_block_function_signature_with_dict_fields():
     mock_node.block = CreateDictionaryBlock()
     mock_node.block_id = CreateDictionaryBlock().id
     mock_node.input_default = {}
+    mock_node.metadata = {}
 
     # Create mock links with dynamic dictionary fields (source sanitized, sink original)
     mock_links = [
@@ -106,6 +107,7 @@ async def test_create_block_function_signature_with_list_fields():
     mock_node.block = AddToListBlock()
     mock_node.block_id = AddToListBlock().id
     mock_node.input_default = {}
+    mock_node.metadata = {}
 
     # Create mock links with dynamic list fields
     mock_links = [
@@ -159,6 +161,7 @@ async def test_create_block_function_signature_with_object_fields():
     mock_node.block = MatchTextPatternBlock()
     mock_node.block_id = MatchTextPatternBlock().id
     mock_node.input_default = {}
+    mock_node.metadata = {}
 
     # Create mock links with dynamic object fields
     mock_links = [
@@ -208,11 +211,13 @@ async def test_create_tool_node_signatures():
         mock_dict_node.block = CreateDictionaryBlock()
         mock_dict_node.block_id = CreateDictionaryBlock().id
         mock_dict_node.input_default = {}
+        mock_dict_node.metadata = {}
 
         mock_list_node = Mock()
         mock_list_node.block = AddToListBlock()
         mock_list_node.block_id = AddToListBlock().id
         mock_list_node.input_default = {}
+        mock_list_node.metadata = {}
 
         # Mock links with dynamic fields
         dict_link1 = Mock(
@@ -373,7 +378,7 @@ async def test_output_yielding_with_dynamic_fields():
             input_data = block.input_schema(
                 prompt="Create a user dictionary",
                 credentials=llm.TEST_CREDENTIALS_INPUT,
-                model=llm.LlmModel.GPT4O,
+                model=llm.DEFAULT_LLM_MODEL,
                 agent_mode_max_iterations=0,  # Use traditional mode to test output yielding
             )
 
@@ -423,6 +428,7 @@ async def test_mixed_regular_and_dynamic_fields():
     mock_node.block.name = "TestBlock"
     mock_node.block.description = "A test block"
     mock_node.block.input_schema = Mock()
+    mock_node.metadata = {}
 
     # Mock the get_field_schema to return a proper schema for regular fields
     def get_field_schema(field_name):
@@ -594,7 +600,7 @@ async def test_validation_errors_dont_pollute_conversation():
                 input_data = block.input_schema(
                     prompt="Test prompt",
                     credentials=llm.TEST_CREDENTIALS_INPUT,
-                    model=llm.LlmModel.GPT4O,
+                    model=llm.DEFAULT_LLM_MODEL,
                     retry=3,  # Allow retries
                     agent_mode_max_iterations=1,
                 )
diff --git a/autogpt_platform/backend/backend/blocks/wordpress/__init__.py b/autogpt_platform/backend/backend/blocks/wordpress/__init__.py
index c7b1e26eea..3eae4a1063 100644
--- a/autogpt_platform/backend/backend/blocks/wordpress/__init__.py
+++ b/autogpt_platform/backend/backend/blocks/wordpress/__init__.py
@@ -1,3 +1,3 @@
-from .blog import WordPressCreatePostBlock
+from .blog import WordPressCreatePostBlock, WordPressGetAllPostsBlock
 
-__all__ = ["WordPressCreatePostBlock"]
+__all__ = ["WordPressCreatePostBlock", "WordPressGetAllPostsBlock"]
diff --git a/autogpt_platform/backend/backend/blocks/wordpress/_api.py b/autogpt_platform/backend/backend/blocks/wordpress/_api.py
index 78f535947b..d21dc3e05d 100644
--- a/autogpt_platform/backend/backend/blocks/wordpress/_api.py
+++ b/autogpt_platform/backend/backend/blocks/wordpress/_api.py
@@ -161,7 +161,7 @@ async def oauth_exchange_code_for_tokens(
         grant_type="authorization_code",
     ).model_dump(exclude_none=True)
 
-    response = await Requests().post(
+    response = await Requests(raise_for_status=False).post(
         f"{WORDPRESS_BASE_URL}oauth2/token",
         headers=headers,
         data=data,
@@ -205,7 +205,7 @@ async def oauth_refresh_tokens(
         grant_type="refresh_token",
     ).model_dump(exclude_none=True)
 
-    response = await Requests().post(
+    response = await Requests(raise_for_status=False).post(
         f"{WORDPRESS_BASE_URL}oauth2/token",
         headers=headers,
         data=data,
@@ -252,7 +252,7 @@ async def validate_token(
         "token": token,
     }
 
-    response = await Requests().get(
+    response = await Requests(raise_for_status=False).get(
         f"{WORDPRESS_BASE_URL}oauth2/token-info",
         params=params,
     )
@@ -296,7 +296,7 @@ async def make_api_request(
 
     url = f"{WORDPRESS_BASE_URL.rstrip('/')}{endpoint}"
 
-    request_method = getattr(Requests(), method.lower())
+    request_method = getattr(Requests(raise_for_status=False), method.lower())
     response = await request_method(
         url,
         headers=headers,
@@ -476,6 +476,7 @@ async def create_post(
         data["tags"] = ",".join(str(t) for t in data["tags"])
 
     # Make the API request
+    site = normalize_site(site)
     endpoint = f"/rest/v1.1/sites/{site}/posts/new"
 
     headers = {
@@ -483,7 +484,7 @@ async def create_post(
         "Content-Type": "application/x-www-form-urlencoded",
     }
 
-    response = await Requests().post(
+    response = await Requests(raise_for_status=False).post(
         f"{WORDPRESS_BASE_URL.rstrip('/')}{endpoint}",
         headers=headers,
         data=data,
@@ -499,3 +500,132 @@ async def create_post(
     )
     error_message = error_data.get("message", response.text)
     raise ValueError(f"Failed to create post: {response.status} - {error_message}")
+
+
+class Post(BaseModel):
+    """Response model for individual posts in a posts list response.
+
+    This is a simplified version compared to PostResponse, as the list endpoint
+    returns less detailed information than the create/get single post endpoints.
+    """
+
+    ID: int
+    site_ID: int
+    author: PostAuthor
+    date: datetime
+    modified: datetime
+    title: str
+    URL: str
+    short_URL: str
+    content: str | None = None
+    excerpt: str | None = None
+    slug: str
+    guid: str
+    status: str
+    sticky: bool
+    password: str | None = ""
+    parent: Union[Dict[str, Any], bool, None] = None
+    type: str
+    discussion: Dict[str, Union[str, bool, int]] | None = None
+    likes_enabled: bool | None = None
+    sharing_enabled: bool | None = None
+    like_count: int | None = None
+    i_like: bool | None = None
+    is_reblogged: bool | None = None
+    is_following: bool | None = None
+    global_ID: str | None = None
+    featured_image: str | None = None
+    post_thumbnail: Dict[str, Any] | None = None
+    format: str | None = None
+    geo: Union[Dict[str, Any], bool, None] = None
+    menu_order: int | None = None
+    page_template: str | None = None
+    publicize_URLs: List[str] | None = None
+    terms: Dict[str, Dict[str, Any]] | None = None
+    tags: Dict[str, Dict[str, Any]] | None = None
+    categories: Dict[str, Dict[str, Any]] | None = None
+    attachments: Dict[str, Dict[str, Any]] | None = None
+    attachment_count: int | None = None
+    metadata: List[Dict[str, Any]] | None = None
+    meta: Dict[str, Any] | None = None
+    capabilities: Dict[str, bool] | None = None
+    revisions: List[int] | None = None
+    other_URLs: Dict[str, Any] | None = None
+
+
+class PostsResponse(BaseModel):
+    """Response model for WordPress posts list."""
+
+    found: int
+    posts: List[Post]
+    meta: Dict[str, Any]
+
+
+def normalize_site(site: str) -> str:
+    """
+    Normalize a site identifier by stripping protocol and trailing slashes.
+
+    Args:
+        site: Site URL, domain, or ID (e.g., "https://myblog.wordpress.com/", "myblog.wordpress.com", "123456789")
+
+    Returns:
+        Normalized site identifier (domain or ID only)
+    """
+    site = site.strip()
+    if site.startswith("https://"):
+        site = site[8:]
+    elif site.startswith("http://"):
+        site = site[7:]
+    return site.rstrip("/")
+
+
+async def get_posts(
+    credentials: Credentials,
+    site: str,
+    status: PostStatus | None = None,
+    number: int = 100,
+    offset: int = 0,
+) -> PostsResponse:
+    """
+    Get posts from a WordPress site.
+
+    Args:
+        credentials: OAuth credentials
+        site: Site ID or domain (e.g., "myblog.wordpress.com" or "123456789")
+        status: Filter by post status using PostStatus enum, or None for all
+        number: Number of posts to retrieve (max 100)
+        offset: Number of posts to skip (for pagination)
+
+    Returns:
+        PostsResponse with the list of posts
+    """
+    site = normalize_site(site)
+    endpoint = f"/rest/v1.1/sites/{site}/posts"
+
+    headers = {
+        "Authorization": credentials.auth_header(),
+    }
+
+    params: Dict[str, Any] = {
+        "number": max(1, min(number, 100)),  # 1–100 posts per request
+        "offset": offset,
+    }
+
+    if status:
+        params["status"] = status.value
+    response = await Requests(raise_for_status=False).get(
+        f"{WORDPRESS_BASE_URL.rstrip('/')}{endpoint}",
+        headers=headers,
+        params=params,
+    )
+
+    if response.ok:
+        return PostsResponse.model_validate(response.json())
+
+    error_data = (
+        response.json()
+        if response.headers.get("content-type", "").startswith("application/json")
+        else {}
+    )
+    error_message = error_data.get("message", response.text)
+    raise ValueError(f"Failed to get posts: {response.status} - {error_message}")
diff --git a/autogpt_platform/backend/backend/blocks/wordpress/blog.py b/autogpt_platform/backend/backend/blocks/wordpress/blog.py
index c0ad5eca54..22b691480b 100644
--- a/autogpt_platform/backend/backend/blocks/wordpress/blog.py
+++ b/autogpt_platform/backend/backend/blocks/wordpress/blog.py
@@ -9,7 +9,15 @@ from backend.sdk import (
     SchemaField,
 )
 
-from ._api import CreatePostRequest, PostResponse, PostStatus, create_post
+from ._api import (
+    CreatePostRequest,
+    Post,
+    PostResponse,
+    PostsResponse,
+    PostStatus,
+    create_post,
+    get_posts,
+)
 from ._config import wordpress
 
 
@@ -49,8 +57,15 @@ class WordPressCreatePostBlock(Block):
         media_urls: list[str] = SchemaField(
             description="URLs of images to sideload and attach to the post", default=[]
         )
+        publish_as_draft: bool = SchemaField(
+            description="If True, publishes the post as a draft. If False, publishes it publicly.",
+            default=False,
+        )
 
     class Output(BlockSchemaOutput):
+        site: str = SchemaField(
+            description="The site ID or domain (pass-through for chaining with other blocks)"
+        )
         post_id: int = SchemaField(description="The ID of the created post")
         post_url: str = SchemaField(description="The full URL of the created post")
         short_url: str = SchemaField(description="The shortened wp.me URL")
@@ -78,7 +93,9 @@ class WordPressCreatePostBlock(Block):
             tags=input_data.tags,
             featured_image=input_data.featured_image,
             media_urls=input_data.media_urls,
-            status=PostStatus.PUBLISH,
+            status=(
+                PostStatus.DRAFT if input_data.publish_as_draft else PostStatus.PUBLISH
+            ),
         )
 
         post_response: PostResponse = await create_post(
@@ -87,7 +104,69 @@ class WordPressCreatePostBlock(Block):
             post_data=post_request,
         )
 
+        yield "site", input_data.site
         yield "post_id", post_response.ID
         yield "post_url", post_response.URL
         yield "short_url", post_response.short_URL
         yield "post_data", post_response.model_dump()
+
+
+class WordPressGetAllPostsBlock(Block):
+    """
+    Fetches all posts from a WordPress.com site or Jetpack-enabled site.
+    Supports filtering by status and pagination.
+    """
+
+    class Input(BlockSchemaInput):
+        credentials: CredentialsMetaInput = wordpress.credentials_field()
+        site: str = SchemaField(
+            description="Site ID or domain (e.g., 'myblog.wordpress.com' or '123456789')"
+        )
+        status: PostStatus | None = SchemaField(
+            description="Filter by post status, or None for all",
+            default=None,
+        )
+        number: int = SchemaField(
+            description="Number of posts to retrieve (max 100 per request)", default=20
+        )
+        offset: int = SchemaField(
+            description="Number of posts to skip (for pagination)", default=0
+        )
+
+    class Output(BlockSchemaOutput):
+        site: str = SchemaField(
+            description="The site ID or domain (pass-through for chaining with other blocks)"
+        )
+        found: int = SchemaField(description="Total number of posts found")
+        posts: list[Post] = SchemaField(
+            description="List of post objects with their details"
+        )
+        post: Post = SchemaField(
+            description="Individual post object (yielded for each post)"
+        )
+
+    def __init__(self):
+        super().__init__(
+            id="97728fa7-7f6f-4789-ba0c-f2c114119536",
+            description="Fetch all posts from WordPress.com or Jetpack sites",
+            categories={BlockCategory.SOCIAL},
+            input_schema=self.Input,
+            output_schema=self.Output,
+        )
+
+    async def run(
+        self, input_data: Input, *, credentials: Credentials, **kwargs
+    ) -> BlockOutput:
+        posts_response: PostsResponse = await get_posts(
+            credentials=credentials,
+            site=input_data.site,
+            status=input_data.status,
+            number=input_data.number,
+            offset=input_data.offset,
+        )
+
+        yield "site", input_data.site
+        yield "found", posts_response.found
+        yield "posts", posts_response.posts
+        for post in posts_response.posts:
+            yield "post", post
diff --git a/autogpt_platform/backend/backend/blocks/xml_parser.py b/autogpt_platform/backend/backend/blocks/xml_parser.py
index bf35733c15..223f8ea367 100644
--- a/autogpt_platform/backend/backend/blocks/xml_parser.py
+++ b/autogpt_platform/backend/backend/blocks/xml_parser.py
@@ -1,5 +1,5 @@
 from gravitasml.parser import Parser
-from gravitasml.token import tokenize
+from gravitasml.token import Token, tokenize
 
 from backend.data.block import Block, BlockOutput, BlockSchemaInput, BlockSchemaOutput
 from backend.data.model import SchemaField
@@ -25,6 +25,38 @@ class XMLParserBlock(Block):
             ],
         )
 
+    @staticmethod
+    def _validate_tokens(tokens: list[Token]) -> None:
+        """Ensure the XML has a single root element and no stray text."""
+        if not tokens:
+            raise ValueError("XML input is empty.")
+
+        depth = 0
+        root_seen = False
+
+        for token in tokens:
+            if token.type == "TAG_OPEN":
+                if depth == 0 and root_seen:
+                    raise ValueError("XML must have a single root element.")
+                depth += 1
+                if depth == 1:
+                    root_seen = True
+            elif token.type == "TAG_CLOSE":
+                depth -= 1
+                if depth < 0:
+                    raise SyntaxError("Unexpected closing tag in XML input.")
+            elif token.type in {"TEXT", "ESCAPE"}:
+                if depth == 0 and token.value:
+                    raise ValueError(
+                        "XML contains text outside the root element; "
+                        "wrap content in a single root tag."
+                    )
+
+        if depth != 0:
+            raise SyntaxError("Unclosed tag detected in XML input.")
+        if not root_seen:
+            raise ValueError("XML must include a root element.")
+
     async def run(self, input_data: Input, **kwargs) -> BlockOutput:
         # Security fix: Add size limits to prevent XML bomb attacks
         MAX_XML_SIZE = 10 * 1024 * 1024  # 10MB limit for XML input
@@ -35,7 +67,9 @@ class XMLParserBlock(Block):
             )
 
         try:
-            tokens = tokenize(input_data.input_xml)
+            tokens = list(tokenize(input_data.input_xml))
+            self._validate_tokens(tokens)
+
             parser = Parser(tokens)
             parsed_result = parser.parse()
             yield "parsed_xml", parsed_result
diff --git a/autogpt_platform/backend/backend/blocks/youtube.py b/autogpt_platform/backend/backend/blocks/youtube.py
index 322cac35a8..e79be3e99b 100644
--- a/autogpt_platform/backend/backend/blocks/youtube.py
+++ b/autogpt_platform/backend/backend/blocks/youtube.py
@@ -111,6 +111,8 @@ class TranscribeYoutubeVideoBlock(Block):
                 return parsed_url.path.split("/")[2]
             if parsed_url.path[:3] == "/v/":
                 return parsed_url.path.split("/")[2]
+            if parsed_url.path.startswith("/shorts/"):
+                return parsed_url.path.split("/")[2]
         raise ValueError(f"Invalid YouTube URL: {url}")
 
     def get_transcript(
diff --git a/autogpt_platform/backend/backend/data/analytics.py b/autogpt_platform/backend/backend/data/analytics.py
index 7419539026..2e148cd10f 100644
--- a/autogpt_platform/backend/backend/data/analytics.py
+++ b/autogpt_platform/backend/backend/data/analytics.py
@@ -104,7 +104,7 @@ async def get_accuracy_trends_and_alerts(
             AND e."executionStatus" IN ('COMPLETED', 'FAILED', 'TERMINATED')
             {user_filter}
         GROUP BY DATE(e."createdAt")
-        HAVING COUNT(*) >= 3  -- Need at least 3 executions per day
+        HAVING COUNT(*) >= 1  -- Include all days with at least 1 execution
     ),
     trends AS (
         SELECT 
diff --git a/autogpt_platform/backend/backend/data/block.py b/autogpt_platform/backend/backend/data/block.py
index 727688dcf0..bfd4a35ec2 100644
--- a/autogpt_platform/backend/backend/data/block.py
+++ b/autogpt_platform/backend/backend/data/block.py
@@ -50,6 +50,8 @@ from .model import (
 logger = logging.getLogger(__name__)
 
 if TYPE_CHECKING:
+    from backend.data.execution import ExecutionContext
+
     from .graph import Link
 
 app_config = Config()
@@ -472,6 +474,7 @@ class Block(ABC, Generic[BlockSchemaInputType, BlockSchemaOutputType]):
         self.block_type = block_type
         self.webhook_config = webhook_config
         self.execution_stats: NodeExecutionStats = NodeExecutionStats()
+        self.requires_human_review: bool = False
 
         if self.webhook_config:
             if isinstance(self.webhook_config, BlockWebhookConfig):
@@ -614,7 +617,88 @@ class Block(ABC, Generic[BlockSchemaInputType, BlockSchemaOutputType]):
                     block_id=self.id,
                 ) from ex
 
+    async def is_block_exec_need_review(
+        self,
+        input_data: BlockInput,
+        *,
+        user_id: str,
+        node_exec_id: str,
+        graph_exec_id: str,
+        graph_id: str,
+        graph_version: int,
+        execution_context: "ExecutionContext",
+        **kwargs,
+    ) -> tuple[bool, BlockInput]:
+        """
+        Check if this block execution needs human review and handle the review process.
+
+        Returns:
+            Tuple of (should_pause, input_data_to_use)
+            - should_pause: True if execution should be paused for review
+            - input_data_to_use: The input data to use (may be modified by reviewer)
+        """
+        # Skip review if not required or safe mode is disabled
+        if not self.requires_human_review or not execution_context.safe_mode:
+            return False, input_data
+
+        from backend.blocks.helpers.review import HITLReviewHelper
+
+        # Handle the review request and get decision
+        decision = await HITLReviewHelper.handle_review_decision(
+            input_data=input_data,
+            user_id=user_id,
+            node_exec_id=node_exec_id,
+            graph_exec_id=graph_exec_id,
+            graph_id=graph_id,
+            graph_version=graph_version,
+            execution_context=execution_context,
+            block_name=self.name,
+            editable=True,
+        )
+
+        if decision is None:
+            # We're awaiting review - pause execution
+            return True, input_data
+
+        if not decision.should_proceed:
+            # Review was rejected, raise an error to stop execution
+            raise BlockExecutionError(
+                message=f"Block execution rejected by reviewer: {decision.message}",
+                block_name=self.name,
+                block_id=self.id,
+            )
+
+        # Review was approved - use the potentially modified data
+        # ReviewResult.data must be a dict for block inputs
+        reviewed_data = decision.review_result.data
+        if not isinstance(reviewed_data, dict):
+            raise BlockExecutionError(
+                message=f"Review data must be a dict for block input, got {type(reviewed_data).__name__}",
+                block_name=self.name,
+                block_id=self.id,
+            )
+        return False, reviewed_data
+
     async def _execute(self, input_data: BlockInput, **kwargs) -> BlockOutput:
+        # Check for review requirement only if running within a graph execution context
+        # Direct block execution (e.g., from chat) skips the review process
+        has_graph_context = all(
+            key in kwargs
+            for key in (
+                "node_exec_id",
+                "graph_exec_id",
+                "graph_id",
+                "execution_context",
+            )
+        )
+        if has_graph_context:
+            should_pause, input_data = await self.is_block_exec_need_review(
+                input_data, **kwargs
+            )
+            if should_pause:
+                return
+
+        # Validate the input data (original or reviewer-modified) once
         if error := self.input_schema.validate_data(input_data):
             raise BlockInputError(
                 message=f"Unable to execute block with invalid input data: {error}",
@@ -622,6 +706,7 @@ class Block(ABC, Generic[BlockSchemaInputType, BlockSchemaOutputType]):
                 block_id=self.id,
             )
 
+        # Use the validated input data
         async for output_name, output_data in self.run(
             self.input_schema(**{k: v for k, v in input_data.items() if v is not None}),
             **kwargs,
diff --git a/autogpt_platform/backend/backend/data/block_cost_config.py b/autogpt_platform/backend/backend/data/block_cost_config.py
index 6bb32d3a47..7f8ee97d52 100644
--- a/autogpt_platform/backend/backend/data/block_cost_config.py
+++ b/autogpt_platform/backend/backend/data/block_cost_config.py
@@ -59,12 +59,13 @@ from backend.integrations.credentials_store import (
 
 MODEL_COST: dict[LlmModel, int] = {
     LlmModel.O3: 4,
-    LlmModel.O3_MINI: 2,  # $1.10 / $4.40
-    LlmModel.O1: 16,  # $15 / $60
+    LlmModel.O3_MINI: 2,
+    LlmModel.O1: 16,
     LlmModel.O1_MINI: 4,
     # GPT-5 models
-    LlmModel.GPT5: 2,
+    LlmModel.GPT5_2: 6,
     LlmModel.GPT5_1: 5,
+    LlmModel.GPT5: 2,
     LlmModel.GPT5_MINI: 1,
     LlmModel.GPT5_NANO: 1,
     LlmModel.GPT5_CHAT: 5,
@@ -87,7 +88,7 @@ MODEL_COST: dict[LlmModel, int] = {
     LlmModel.AIML_API_LLAMA3_3_70B: 1,
     LlmModel.AIML_API_META_LLAMA_3_1_70B: 1,
     LlmModel.AIML_API_LLAMA_3_2_3B: 1,
-    LlmModel.LLAMA3_3_70B: 1,  # $0.59 / $0.79
+    LlmModel.LLAMA3_3_70B: 1,
     LlmModel.LLAMA3_1_8B: 1,
     LlmModel.OLLAMA_LLAMA3_3: 1,
     LlmModel.OLLAMA_LLAMA3_2: 1,
diff --git a/autogpt_platform/backend/backend/data/credit.py b/autogpt_platform/backend/backend/data/credit.py
index 95f0b158e1..f3c5365446 100644
--- a/autogpt_platform/backend/backend/data/credit.py
+++ b/autogpt_platform/backend/backend/data/credit.py
@@ -341,6 +341,19 @@ class UserCreditBase(ABC):
 
         if result:
             # UserBalance is already updated by the CTE
+
+            # Clear insufficient funds notification flags when credits are added
+            # so user can receive alerts again if they run out in the future.
+            if transaction.amount > 0 and transaction.type in [
+                CreditTransactionType.GRANT,
+                CreditTransactionType.TOP_UP,
+            ]:
+                from backend.executor.manager import (
+                    clear_insufficient_funds_notifications,
+                )
+
+                await clear_insufficient_funds_notifications(user_id)
+
             return result[0]["balance"]
 
     async def _add_transaction(
@@ -530,6 +543,22 @@ class UserCreditBase(ABC):
         if result:
             new_balance, tx_key = result[0]["balance"], result[0]["transactionKey"]
             # UserBalance is already updated by the CTE
+
+            # Clear insufficient funds notification flags when credits are added
+            # so user can receive alerts again if they run out in the future.
+            if (
+                amount > 0
+                and is_active
+                and transaction_type
+                in [CreditTransactionType.GRANT, CreditTransactionType.TOP_UP]
+            ):
+                # Lazy import to avoid circular dependency with executor.manager
+                from backend.executor.manager import (
+                    clear_insufficient_funds_notifications,
+                )
+
+                await clear_insufficient_funds_notifications(user_id)
+
             return new_balance, tx_key
 
         # If no result, either user doesn't exist or insufficient balance
diff --git a/autogpt_platform/backend/backend/data/db.py b/autogpt_platform/backend/backend/data/db.py
index 31a27e9163..ab39881ed5 100644
--- a/autogpt_platform/backend/backend/data/db.py
+++ b/autogpt_platform/backend/backend/data/db.py
@@ -38,6 +38,20 @@ POOL_TIMEOUT = os.getenv("DB_POOL_TIMEOUT")
 if POOL_TIMEOUT:
     DATABASE_URL = add_param(DATABASE_URL, "pool_timeout", POOL_TIMEOUT)
 
+# Add public schema to search_path for pgvector type access
+# The vector extension is in public schema, but search_path is determined by schema parameter
+# Extract the schema from DATABASE_URL or default to 'public' (matching get_database_schema())
+parsed_url = urlparse(DATABASE_URL)
+url_params = dict(parse_qsl(parsed_url.query))
+db_schema = url_params.get("schema", "public")
+# Build search_path, avoiding duplicates if db_schema is already 'public'
+search_path_schemas = list(
+    dict.fromkeys([db_schema, "public"])
+)  # Preserves order, removes duplicates
+search_path = ",".join(search_path_schemas)
+# This allows using ::vector without schema qualification
+DATABASE_URL = add_param(DATABASE_URL, "options", f"-c search_path={search_path}")
+
 HTTP_TIMEOUT = int(POOL_TIMEOUT) if POOL_TIMEOUT else None
 
 prisma = Prisma(
@@ -108,21 +122,102 @@ def get_database_schema() -> str:
     return query_params.get("schema", "public")
 
 
-async def query_raw_with_schema(query_template: str, *args) -> list[dict]:
-    """Execute raw SQL query with proper schema handling."""
+async def _raw_with_schema(
+    query_template: str,
+    *args,
+    execute: bool = False,
+    client: Prisma | None = None,
+    set_public_search_path: bool = False,
+) -> list[dict] | int:
+    """Internal: Execute raw SQL with proper schema handling.
+
+    Use query_raw_with_schema() or execute_raw_with_schema() instead.
+
+    Args:
+        query_template: SQL query with {schema_prefix} placeholder
+        *args: Query parameters
+        execute: If False, executes SELECT query. If True, executes INSERT/UPDATE/DELETE.
+        client: Optional Prisma client for transactions (only used when execute=True).
+        set_public_search_path: If True, sets search_path to include public schema.
+                                Needed for pgvector types and other public schema objects.
+
+    Returns:
+        - list[dict] if execute=False (query results)
+        - int if execute=True (number of affected rows)
+    """
     schema = get_database_schema()
     schema_prefix = f'"{schema}".' if schema != "public" else ""
     formatted_query = query_template.format(schema_prefix=schema_prefix)
 
     import prisma as prisma_module
 
-    result = await prisma_module.get_client().query_raw(
-        formatted_query, *args  # type: ignore
-    )
+    db_client = client if client else prisma_module.get_client()
+
+    # Set search_path to include public schema if requested
+    # Prisma doesn't support the 'options' connection parameter, so we set it per-session
+    # This is idempotent and safe to call multiple times
+    if set_public_search_path:
+        await db_client.execute_raw(f"SET search_path = {schema}, public")  # type: ignore
+
+    if execute:
+        result = await db_client.execute_raw(formatted_query, *args)  # type: ignore
+    else:
+        result = await db_client.query_raw(formatted_query, *args)  # type: ignore
 
     return result
 
 
+async def query_raw_with_schema(
+    query_template: str, *args, set_public_search_path: bool = False
+) -> list[dict]:
+    """Execute raw SQL SELECT query with proper schema handling.
+
+    Args:
+        query_template: SQL query with {schema_prefix} placeholder
+        *args: Query parameters
+        set_public_search_path: If True, sets search_path to include public schema.
+                                Needed for pgvector types and other public schema objects.
+
+    Returns:
+        List of result rows as dictionaries
+
+    Example:
+        results = await query_raw_with_schema(
+            'SELECT * FROM {schema_prefix}"User" WHERE id = $1',
+            user_id
+        )
+    """
+    return await _raw_with_schema(query_template, *args, execute=False, set_public_search_path=set_public_search_path)  # type: ignore
+
+
+async def execute_raw_with_schema(
+    query_template: str,
+    *args,
+    client: Prisma | None = None,
+    set_public_search_path: bool = False,
+) -> int:
+    """Execute raw SQL command (INSERT/UPDATE/DELETE) with proper schema handling.
+
+    Args:
+        query_template: SQL query with {schema_prefix} placeholder
+        *args: Query parameters
+        client: Optional Prisma client for transactions
+        set_public_search_path: If True, sets search_path to include public schema.
+                                Needed for pgvector types and other public schema objects.
+
+    Returns:
+        Number of affected rows
+
+    Example:
+        await execute_raw_with_schema(
+            'INSERT INTO {schema_prefix}"User" (id, name) VALUES ($1, $2)',
+            user_id, name,
+            client=tx  # Optional transaction client
+        )
+    """
+    return await _raw_with_schema(query_template, *args, execute=True, client=client, set_public_search_path=set_public_search_path)  # type: ignore
+
+
 class BaseDbModel(BaseModel):
     id: str = Field(default_factory=lambda: str(uuid4()))
 
diff --git a/autogpt_platform/backend/backend/data/execution.py b/autogpt_platform/backend/backend/data/execution.py
index 020a5a1906..a6797032fd 100644
--- a/autogpt_platform/backend/backend/data/execution.py
+++ b/autogpt_platform/backend/backend/data/execution.py
@@ -153,8 +153,14 @@ class GraphExecutionMeta(BaseDbModel):
     nodes_input_masks: Optional[dict[str, BlockInput]]
     preset_id: Optional[str]
     status: ExecutionStatus
-    started_at: datetime
-    ended_at: datetime
+    started_at: Optional[datetime] = Field(
+        None,
+        description="When execution started running. Null if not yet started (QUEUED).",
+    )
+    ended_at: Optional[datetime] = Field(
+        None,
+        description="When execution finished. Null if not yet completed (QUEUED, RUNNING, INCOMPLETE, REVIEW).",
+    )
     is_shared: bool = False
     share_token: Optional[str] = None
 
@@ -229,10 +235,8 @@ class GraphExecutionMeta(BaseDbModel):
 
     @staticmethod
     def from_db(_graph_exec: AgentGraphExecution):
-        now = datetime.now(timezone.utc)
-        # TODO: make started_at and ended_at optional
-        start_time = _graph_exec.startedAt or _graph_exec.createdAt
-        end_time = _graph_exec.updatedAt or now
+        start_time = _graph_exec.startedAt
+        end_time = _graph_exec.endedAt
 
         try:
             stats = GraphExecutionStats.model_validate(_graph_exec.stats)
@@ -383,6 +387,7 @@ class GraphExecutionWithNodes(GraphExecution):
         self,
         execution_context: ExecutionContext,
         compiled_nodes_input_masks: Optional[NodesInputMasks] = None,
+        nodes_to_skip: Optional[set[str]] = None,
     ):
         return GraphExecutionEntry(
             user_id=self.user_id,
@@ -390,6 +395,7 @@ class GraphExecutionWithNodes(GraphExecution):
             graph_version=self.graph_version or 0,
             graph_exec_id=self.id,
             nodes_input_masks=compiled_nodes_input_masks,
+            nodes_to_skip=nodes_to_skip or set(),
             execution_context=execution_context,
         )
 
@@ -900,6 +906,14 @@ async def update_graph_execution_stats(
 
     if status:
         update_data["executionStatus"] = status
+        # Set endedAt when execution reaches a terminal status
+        terminal_statuses = [
+            ExecutionStatus.COMPLETED,
+            ExecutionStatus.FAILED,
+            ExecutionStatus.TERMINATED,
+        ]
+        if status in terminal_statuses:
+            update_data["endedAt"] = datetime.now(tz=timezone.utc)
 
     where_clause: AgentGraphExecutionWhereInput = {"id": graph_exec_id}
 
@@ -1145,6 +1159,8 @@ class GraphExecutionEntry(BaseModel):
     graph_id: str
     graph_version: int
     nodes_input_masks: Optional[NodesInputMasks] = None
+    nodes_to_skip: set[str] = Field(default_factory=set)
+    """Node IDs that should be skipped due to optional credentials not being configured."""
     execution_context: ExecutionContext = Field(default_factory=ExecutionContext)
 
 
diff --git a/autogpt_platform/backend/backend/data/graph.py b/autogpt_platform/backend/backend/data/graph.py
index 0757a86f4a..e9be80892c 100644
--- a/autogpt_platform/backend/backend/data/graph.py
+++ b/autogpt_platform/backend/backend/data/graph.py
@@ -94,6 +94,15 @@ class Node(BaseDbModel):
     input_links: list[Link] = []
     output_links: list[Link] = []
 
+    @property
+    def credentials_optional(self) -> bool:
+        """
+        Whether credentials are optional for this node.
+        When True and credentials are not configured, the node will be skipped
+        during execution rather than causing a validation error.
+        """
+        return self.metadata.get("credentials_optional", False)
+
     @property
     def block(self) -> AnyBlockSchema | "_UnknownBlockBase":
         """Get the block for this node. Returns UnknownBlock if block is deleted/missing."""
@@ -235,7 +244,10 @@ class BaseGraph(BaseDbModel):
         return any(
             node.block_id
             for node in self.nodes
-            if node.block.block_type == BlockType.HUMAN_IN_THE_LOOP
+            if (
+                node.block.block_type == BlockType.HUMAN_IN_THE_LOOP
+                or node.block.requires_human_review
+            )
         )
 
     @property
@@ -326,7 +338,35 @@ class Graph(BaseGraph):
     @computed_field
     @property
     def credentials_input_schema(self) -> dict[str, Any]:
-        return self._credentials_input_schema.jsonschema()
+        schema = self._credentials_input_schema.jsonschema()
+
+        # Determine which credential fields are required based on credentials_optional metadata
+        graph_credentials_inputs = self.aggregate_credentials_inputs()
+        required_fields = []
+
+        # Build a map of node_id -> node for quick lookup
+        all_nodes = {node.id: node for node in self.nodes}
+        for sub_graph in self.sub_graphs:
+            for node in sub_graph.nodes:
+                all_nodes[node.id] = node
+
+        for field_key, (
+            _field_info,
+            node_field_pairs,
+        ) in graph_credentials_inputs.items():
+            # A field is required if ANY node using it has credentials_optional=False
+            is_required = False
+            for node_id, _field_name in node_field_pairs:
+                node = all_nodes.get(node_id)
+                if node and not node.credentials_optional:
+                    is_required = True
+                    break
+
+            if is_required:
+                required_fields.append(field_key)
+
+        schema["required"] = required_fields
+        return schema
 
     @property
     def _credentials_input_schema(self) -> type[BlockSchema]:
diff --git a/autogpt_platform/backend/backend/data/graph_test.py b/autogpt_platform/backend/backend/data/graph_test.py
index 044d75e0ca..8b7eadb887 100644
--- a/autogpt_platform/backend/backend/data/graph_test.py
+++ b/autogpt_platform/backend/backend/data/graph_test.py
@@ -1,5 +1,6 @@
 import json
 from typing import Any
+from unittest.mock import AsyncMock, patch
 from uuid import UUID
 
 import fastapi.exceptions
@@ -18,6 +19,17 @@ from backend.usecases.sample import create_test_user
 from backend.util.test import SpinTestServer
 
 
+@pytest.fixture(scope="session", autouse=True)
+def mock_embedding_functions():
+    """Mock embedding functions for all tests to avoid database/API dependencies."""
+    with patch(
+        "backend.api.features.store.db.ensure_embedding",
+        new_callable=AsyncMock,
+        return_value=True,
+    ):
+        yield
+
+
 @pytest.mark.asyncio(loop_scope="session")
 async def test_graph_creation(server: SpinTestServer, snapshot: Snapshot):
     """
@@ -396,3 +408,58 @@ async def test_access_store_listing_graph(server: SpinTestServer):
         created_graph.id, created_graph.version, "3e53486c-cf57-477e-ba2a-cb02dc828e1b"
     )
     assert got_graph is not None
+
+
+# ============================================================================
+# Tests for Optional Credentials Feature
+# ============================================================================
+
+
+def test_node_credentials_optional_default():
+    """Test that credentials_optional defaults to False when not set in metadata."""
+    node = Node(
+        id="test_node",
+        block_id=StoreValueBlock().id,
+        input_default={},
+        metadata={},
+    )
+    assert node.credentials_optional is False
+
+
+def test_node_credentials_optional_true():
+    """Test that credentials_optional returns True when explicitly set."""
+    node = Node(
+        id="test_node",
+        block_id=StoreValueBlock().id,
+        input_default={},
+        metadata={"credentials_optional": True},
+    )
+    assert node.credentials_optional is True
+
+
+def test_node_credentials_optional_false():
+    """Test that credentials_optional returns False when explicitly set to False."""
+    node = Node(
+        id="test_node",
+        block_id=StoreValueBlock().id,
+        input_default={},
+        metadata={"credentials_optional": False},
+    )
+    assert node.credentials_optional is False
+
+
+def test_node_credentials_optional_with_other_metadata():
+    """Test that credentials_optional works correctly with other metadata present."""
+    node = Node(
+        id="test_node",
+        block_id=StoreValueBlock().id,
+        input_default={},
+        metadata={
+            "position": {"x": 100, "y": 200},
+            "customized_name": "My Custom Node",
+            "credentials_optional": True,
+        },
+    )
+    assert node.credentials_optional is True
+    assert node.metadata["position"] == {"x": 100, "y": 200}
+    assert node.metadata["customized_name"] == "My Custom Node"
diff --git a/autogpt_platform/backend/backend/data/onboarding.py b/autogpt_platform/backend/backend/data/onboarding.py
index cc63b89afd..6a842d1022 100644
--- a/autogpt_platform/backend/backend/data/onboarding.py
+++ b/autogpt_platform/backend/backend/data/onboarding.py
@@ -334,7 +334,7 @@ async def _get_user_timezone(user_id: str) -> str:
     return get_user_timezone_or_utc(user.timezone if user else None)
 
 
-async def increment_runs(user_id: str):
+async def increment_onboarding_runs(user_id: str):
     """
     Increment a user's run counters and trigger any onboarding milestones.
     """
diff --git a/autogpt_platform/backend/backend/data/understanding.py b/autogpt_platform/backend/backend/data/understanding.py
new file mode 100644
index 0000000000..c604e046b6
--- /dev/null
+++ b/autogpt_platform/backend/backend/data/understanding.py
@@ -0,0 +1,406 @@
+"""Data models and access layer for user business understanding."""
+
+import logging
+from datetime import datetime
+from typing import Any, Optional, cast
+
+import pydantic
+from prisma.models import CoPilotUnderstanding
+
+from backend.data.redis_client import get_redis_async
+from backend.util.json import SafeJson
+
+logger = logging.getLogger(__name__)
+
+# Cache configuration
+CACHE_KEY_PREFIX = "understanding"
+CACHE_TTL_SECONDS = 48 * 60 * 60  # 48 hours
+
+
+def _cache_key(user_id: str) -> str:
+    """Generate cache key for user business understanding."""
+    return f"{CACHE_KEY_PREFIX}:{user_id}"
+
+
+def _json_to_list(value: Any) -> list[str]:
+    """Convert Json field to list[str], handling None."""
+    if value is None:
+        return []
+    if isinstance(value, list):
+        return cast(list[str], value)
+    return []
+
+
+class BusinessUnderstandingInput(pydantic.BaseModel):
+    """Input model for updating business understanding - all fields optional for incremental updates."""
+
+    # User info
+    user_name: Optional[str] = pydantic.Field(None, description="The user's name")
+    job_title: Optional[str] = pydantic.Field(None, description="The user's job title")
+
+    # Business basics
+    business_name: Optional[str] = pydantic.Field(
+        None, description="Name of the user's business"
+    )
+    industry: Optional[str] = pydantic.Field(None, description="Industry or sector")
+    business_size: Optional[str] = pydantic.Field(
+        None, description="Company size (e.g., '1-10', '11-50')"
+    )
+    user_role: Optional[str] = pydantic.Field(
+        None,
+        description="User's role in the organization (e.g., 'decision maker', 'implementer')",
+    )
+
+    # Processes & activities
+    key_workflows: Optional[list[str]] = pydantic.Field(
+        None, description="Key business workflows"
+    )
+    daily_activities: Optional[list[str]] = pydantic.Field(
+        None, description="Daily activities performed"
+    )
+
+    # Pain points & goals
+    pain_points: Optional[list[str]] = pydantic.Field(
+        None, description="Current pain points"
+    )
+    bottlenecks: Optional[list[str]] = pydantic.Field(
+        None, description="Process bottlenecks"
+    )
+    manual_tasks: Optional[list[str]] = pydantic.Field(
+        None, description="Manual/repetitive tasks"
+    )
+    automation_goals: Optional[list[str]] = pydantic.Field(
+        None, description="Desired automation goals"
+    )
+
+    # Current tools
+    current_software: Optional[list[str]] = pydantic.Field(
+        None, description="Software/tools currently used"
+    )
+    existing_automation: Optional[list[str]] = pydantic.Field(
+        None, description="Existing automations"
+    )
+
+    # Additional context
+    additional_notes: Optional[str] = pydantic.Field(
+        None, description="Any additional context"
+    )
+
+
+class BusinessUnderstanding(pydantic.BaseModel):
+    """Full business understanding model returned from database."""
+
+    id: str
+    user_id: str
+    created_at: datetime
+    updated_at: datetime
+
+    # User info
+    user_name: Optional[str] = None
+    job_title: Optional[str] = None
+
+    # Business basics
+    business_name: Optional[str] = None
+    industry: Optional[str] = None
+    business_size: Optional[str] = None
+    user_role: Optional[str] = None
+
+    # Processes & activities
+    key_workflows: list[str] = pydantic.Field(default_factory=list)
+    daily_activities: list[str] = pydantic.Field(default_factory=list)
+
+    # Pain points & goals
+    pain_points: list[str] = pydantic.Field(default_factory=list)
+    bottlenecks: list[str] = pydantic.Field(default_factory=list)
+    manual_tasks: list[str] = pydantic.Field(default_factory=list)
+    automation_goals: list[str] = pydantic.Field(default_factory=list)
+
+    # Current tools
+    current_software: list[str] = pydantic.Field(default_factory=list)
+    existing_automation: list[str] = pydantic.Field(default_factory=list)
+
+    # Additional context
+    additional_notes: Optional[str] = None
+
+    @classmethod
+    def from_db(cls, db_record: CoPilotUnderstanding) -> "BusinessUnderstanding":
+        """Convert database record to Pydantic model."""
+        data = db_record.data if isinstance(db_record.data, dict) else {}
+        business = (
+            data.get("business", {}) if isinstance(data.get("business"), dict) else {}
+        )
+        return cls(
+            id=db_record.id,
+            user_id=db_record.userId,
+            created_at=db_record.createdAt,
+            updated_at=db_record.updatedAt,
+            user_name=data.get("name"),
+            job_title=business.get("job_title"),
+            business_name=business.get("business_name"),
+            industry=business.get("industry"),
+            business_size=business.get("business_size"),
+            user_role=business.get("user_role"),
+            key_workflows=_json_to_list(business.get("key_workflows")),
+            daily_activities=_json_to_list(business.get("daily_activities")),
+            pain_points=_json_to_list(business.get("pain_points")),
+            bottlenecks=_json_to_list(business.get("bottlenecks")),
+            manual_tasks=_json_to_list(business.get("manual_tasks")),
+            automation_goals=_json_to_list(business.get("automation_goals")),
+            current_software=_json_to_list(business.get("current_software")),
+            existing_automation=_json_to_list(business.get("existing_automation")),
+            additional_notes=business.get("additional_notes"),
+        )
+
+
+def _merge_lists(existing: list | None, new: list | None) -> list | None:
+    """Merge two lists, removing duplicates while preserving order."""
+    if new is None:
+        return existing
+    if existing is None:
+        return new
+    # Preserve order, add new items that don't exist
+    merged = list(existing)
+    for item in new:
+        if item not in merged:
+            merged.append(item)
+    return merged
+
+
+async def _get_from_cache(user_id: str) -> Optional[BusinessUnderstanding]:
+    """Get business understanding from Redis cache."""
+    try:
+        redis = await get_redis_async()
+        cached_data = await redis.get(_cache_key(user_id))
+        if cached_data:
+            return BusinessUnderstanding.model_validate_json(cached_data)
+    except Exception as e:
+        logger.warning(f"Failed to get understanding from cache: {e}")
+    return None
+
+
+async def _set_cache(user_id: str, understanding: BusinessUnderstanding) -> None:
+    """Set business understanding in Redis cache with TTL."""
+    try:
+        redis = await get_redis_async()
+        await redis.setex(
+            _cache_key(user_id),
+            CACHE_TTL_SECONDS,
+            understanding.model_dump_json(),
+        )
+    except Exception as e:
+        logger.warning(f"Failed to set understanding in cache: {e}")
+
+
+async def _delete_cache(user_id: str) -> None:
+    """Delete business understanding from Redis cache."""
+    try:
+        redis = await get_redis_async()
+        await redis.delete(_cache_key(user_id))
+    except Exception as e:
+        logger.warning(f"Failed to delete understanding from cache: {e}")
+
+
+async def get_business_understanding(
+    user_id: str,
+) -> Optional[BusinessUnderstanding]:
+    """Get the business understanding for a user.
+
+    Checks cache first, falls back to database if not cached.
+    Results are cached for 48 hours.
+    """
+    # Try cache first
+    cached = await _get_from_cache(user_id)
+    if cached:
+        logger.debug(f"Business understanding cache hit for user {user_id}")
+        return cached
+
+    # Cache miss - load from database
+    logger.debug(f"Business understanding cache miss for user {user_id}")
+    record = await CoPilotUnderstanding.prisma().find_unique(where={"userId": user_id})
+    if record is None:
+        return None
+
+    understanding = BusinessUnderstanding.from_db(record)
+
+    # Store in cache for next time
+    await _set_cache(user_id, understanding)
+
+    return understanding
+
+
+async def upsert_business_understanding(
+    user_id: str,
+    input_data: BusinessUnderstandingInput,
+) -> BusinessUnderstanding:
+    """
+    Create or update business understanding with incremental merge strategy.
+
+    - String fields: new value overwrites if provided (not None)
+    - List fields: new items are appended to existing (deduplicated)
+
+    Data is stored as: {name: ..., business: {version: 1, ...}}
+    """
+    # Get existing record for merge
+    existing = await CoPilotUnderstanding.prisma().find_unique(
+        where={"userId": user_id}
+    )
+
+    # Get existing data structure or start fresh
+    existing_data: dict[str, Any] = {}
+    if existing and isinstance(existing.data, dict):
+        existing_data = dict(existing.data)
+
+    existing_business: dict[str, Any] = {}
+    if isinstance(existing_data.get("business"), dict):
+        existing_business = dict(existing_data["business"])
+
+    # Business fields (stored inside business object)
+    business_string_fields = [
+        "job_title",
+        "business_name",
+        "industry",
+        "business_size",
+        "user_role",
+        "additional_notes",
+    ]
+    business_list_fields = [
+        "key_workflows",
+        "daily_activities",
+        "pain_points",
+        "bottlenecks",
+        "manual_tasks",
+        "automation_goals",
+        "current_software",
+        "existing_automation",
+    ]
+
+    # Handle top-level name field
+    if input_data.user_name is not None:
+        existing_data["name"] = input_data.user_name
+
+    # Business string fields - overwrite if provided
+    for field in business_string_fields:
+        value = getattr(input_data, field)
+        if value is not None:
+            existing_business[field] = value
+
+    # Business list fields - merge with existing
+    for field in business_list_fields:
+        value = getattr(input_data, field)
+        if value is not None:
+            existing_list = _json_to_list(existing_business.get(field))
+            merged = _merge_lists(existing_list, value)
+            existing_business[field] = merged
+
+    # Set version and nest business data
+    existing_business["version"] = 1
+    existing_data["business"] = existing_business
+
+    # Upsert with the merged data
+    record = await CoPilotUnderstanding.prisma().upsert(
+        where={"userId": user_id},
+        data={
+            "create": {"userId": user_id, "data": SafeJson(existing_data)},
+            "update": {"data": SafeJson(existing_data)},
+        },
+    )
+
+    understanding = BusinessUnderstanding.from_db(record)
+
+    # Update cache with new understanding
+    await _set_cache(user_id, understanding)
+
+    return understanding
+
+
+async def clear_business_understanding(user_id: str) -> bool:
+    """Clear/delete business understanding for a user from both DB and cache."""
+    # Delete from cache first
+    await _delete_cache(user_id)
+
+    try:
+        await CoPilotUnderstanding.prisma().delete(where={"userId": user_id})
+        return True
+    except Exception:
+        # Record might not exist
+        return False
+
+
+def format_understanding_for_prompt(understanding: BusinessUnderstanding) -> str:
+    """Format business understanding as text for system prompt injection."""
+    if not understanding:
+        return ""
+    sections = []
+
+    # User info section
+    user_info = []
+    if understanding.user_name:
+        user_info.append(f"Name: {understanding.user_name}")
+    if understanding.job_title:
+        user_info.append(f"Job Title: {understanding.job_title}")
+    if user_info:
+        sections.append("## User\n" + "\n".join(user_info))
+
+    # Business section
+    business_info = []
+    if understanding.business_name:
+        business_info.append(f"Company: {understanding.business_name}")
+    if understanding.industry:
+        business_info.append(f"Industry: {understanding.industry}")
+    if understanding.business_size:
+        business_info.append(f"Size: {understanding.business_size}")
+    if understanding.user_role:
+        business_info.append(f"Role Context: {understanding.user_role}")
+    if business_info:
+        sections.append("## Business\n" + "\n".join(business_info))
+
+    # Processes section
+    processes = []
+    if understanding.key_workflows:
+        processes.append(f"Key Workflows: {', '.join(understanding.key_workflows)}")
+    if understanding.daily_activities:
+        processes.append(
+            f"Daily Activities: {', '.join(understanding.daily_activities)}"
+        )
+    if processes:
+        sections.append("## Processes\n" + "\n".join(processes))
+
+    # Pain points section
+    pain_points = []
+    if understanding.pain_points:
+        pain_points.append(f"Pain Points: {', '.join(understanding.pain_points)}")
+    if understanding.bottlenecks:
+        pain_points.append(f"Bottlenecks: {', '.join(understanding.bottlenecks)}")
+    if understanding.manual_tasks:
+        pain_points.append(f"Manual Tasks: {', '.join(understanding.manual_tasks)}")
+    if pain_points:
+        sections.append("## Pain Points\n" + "\n".join(pain_points))
+
+    # Goals section
+    if understanding.automation_goals:
+        sections.append(
+            "## Automation Goals\n"
+            + "\n".join(f"- {goal}" for goal in understanding.automation_goals)
+        )
+
+    # Current tools section
+    tools_info = []
+    if understanding.current_software:
+        tools_info.append(
+            f"Current Software: {', '.join(understanding.current_software)}"
+        )
+    if understanding.existing_automation:
+        tools_info.append(
+            f"Existing Automation: {', '.join(understanding.existing_automation)}"
+        )
+    if tools_info:
+        sections.append("## Current Tools\n" + "\n".join(tools_info))
+
+    # Additional notes
+    if understanding.additional_notes:
+        sections.append(f"## Additional Context\n{understanding.additional_notes}")
+
+    if not sections:
+        return ""
+
+    return "# User Business Context\n\n" + "\n\n".join(sections)
diff --git a/autogpt_platform/backend/backend/executor/database.py b/autogpt_platform/backend/backend/executor/database.py
index af68bf526d..ac381bbd67 100644
--- a/autogpt_platform/backend/backend/executor/database.py
+++ b/autogpt_platform/backend/backend/executor/database.py
@@ -7,6 +7,11 @@ from backend.api.features.library.db import (
     list_library_agents,
 )
 from backend.api.features.store.db import get_store_agent_details, get_store_agents
+from backend.api.features.store.embeddings import (
+    backfill_missing_embeddings,
+    cleanup_orphaned_embeddings,
+    get_embedding_stats,
+)
 from backend.data import db
 from backend.data.analytics import (
     get_accuracy_trends_and_alerts,
@@ -20,6 +25,7 @@ from backend.data.execution import (
     get_execution_kv_data,
     get_execution_outputs_by_node_exec_id,
     get_frequently_executed_graphs,
+    get_graph_execution,
     get_graph_execution_meta,
     get_graph_executions,
     get_graph_executions_count,
@@ -57,6 +63,7 @@ from backend.data.notifications import (
     get_user_notification_oldest_message_in_batch,
     remove_notifications_from_batch,
 )
+from backend.data.onboarding import increment_onboarding_runs
 from backend.data.user import (
     get_active_user_ids_in_timerange,
     get_user_by_id,
@@ -140,6 +147,7 @@ class DatabaseManager(AppService):
     get_child_graph_executions = _(get_child_graph_executions)
     get_graph_executions = _(get_graph_executions)
     get_graph_executions_count = _(get_graph_executions_count)
+    get_graph_execution = _(get_graph_execution)
     get_graph_execution_meta = _(get_graph_execution_meta)
     create_graph_execution = _(create_graph_execution)
     get_node_execution = _(get_node_execution)
@@ -204,10 +212,18 @@ class DatabaseManager(AppService):
     add_store_agent_to_library = _(add_store_agent_to_library)
     validate_graph_execution_permissions = _(validate_graph_execution_permissions)
 
+    # Onboarding
+    increment_onboarding_runs = _(increment_onboarding_runs)
+
     # Store
     get_store_agents = _(get_store_agents)
     get_store_agent_details = _(get_store_agent_details)
 
+    # Store Embeddings
+    get_embedding_stats = _(get_embedding_stats)
+    backfill_missing_embeddings = _(backfill_missing_embeddings)
+    cleanup_orphaned_embeddings = _(cleanup_orphaned_embeddings)
+
     # Summary data - async
     get_user_execution_summary_data = _(get_user_execution_summary_data)
 
@@ -259,6 +275,11 @@ class DatabaseManagerClient(AppServiceClient):
     get_store_agents = _(d.get_store_agents)
     get_store_agent_details = _(d.get_store_agent_details)
 
+    # Store Embeddings
+    get_embedding_stats = _(d.get_embedding_stats)
+    backfill_missing_embeddings = _(d.backfill_missing_embeddings)
+    cleanup_orphaned_embeddings = _(d.cleanup_orphaned_embeddings)
+
 
 class DatabaseManagerAsyncClient(AppServiceClient):
     d = DatabaseManager
@@ -274,6 +295,7 @@ class DatabaseManagerAsyncClient(AppServiceClient):
     get_graph = d.get_graph
     get_graph_metadata = d.get_graph_metadata
     get_graph_settings = d.get_graph_settings
+    get_graph_execution = d.get_graph_execution
     get_graph_execution_meta = d.get_graph_execution_meta
     get_node = d.get_node
     get_node_execution = d.get_node_execution
@@ -318,6 +340,9 @@ class DatabaseManagerAsyncClient(AppServiceClient):
     add_store_agent_to_library = d.add_store_agent_to_library
     validate_graph_execution_permissions = d.validate_graph_execution_permissions
 
+    # Onboarding
+    increment_onboarding_runs = d.increment_onboarding_runs
+
     # Store
     get_store_agents = d.get_store_agents
     get_store_agent_details = d.get_store_agent_details
diff --git a/autogpt_platform/backend/backend/executor/manager.py b/autogpt_platform/backend/backend/executor/manager.py
index 161e68b0d6..39d4f984eb 100644
--- a/autogpt_platform/backend/backend/executor/manager.py
+++ b/autogpt_platform/backend/backend/executor/manager.py
@@ -114,6 +114,40 @@ utilization_gauge = Gauge(
     "Ratio of active graph runs to max graph workers",
 )
 
+# Redis key prefix for tracking insufficient funds Discord notifications.
+# We only send one notification per user per agent until they top up credits.
+INSUFFICIENT_FUNDS_NOTIFIED_PREFIX = "insufficient_funds_discord_notified"
+# TTL for the notification flag (30 days) - acts as a fallback cleanup
+INSUFFICIENT_FUNDS_NOTIFIED_TTL_SECONDS = 30 * 24 * 60 * 60
+
+
+async def clear_insufficient_funds_notifications(user_id: str) -> int:
+    """
+    Clear all insufficient funds notification flags for a user.
+
+    This should be called when a user tops up their credits, allowing
+    Discord notifications to be sent again if they run out of funds.
+
+    Args:
+        user_id: The user ID to clear notifications for.
+
+    Returns:
+        The number of keys that were deleted.
+    """
+    try:
+        redis_client = await redis.get_redis_async()
+        pattern = f"{INSUFFICIENT_FUNDS_NOTIFIED_PREFIX}:{user_id}:*"
+        keys = [key async for key in redis_client.scan_iter(match=pattern)]
+        if keys:
+            return await redis_client.delete(*keys)
+        return 0
+    except Exception as e:
+        logger.warning(
+            f"Failed to clear insufficient funds notification flags for user "
+            f"{user_id}: {e}"
+        )
+        return 0
+
 
 # Thread-local storage for ExecutionProcessor instances
 _tls = threading.local()
@@ -144,6 +178,7 @@ async def execute_node(
     execution_processor: "ExecutionProcessor",
     execution_stats: NodeExecutionStats | None = None,
     nodes_input_masks: Optional[NodesInputMasks] = None,
+    nodes_to_skip: Optional[set[str]] = None,
 ) -> BlockOutput:
     """
     Execute a node in the graph. This will trigger a block execution on a node,
@@ -211,6 +246,7 @@ async def execute_node(
         "user_id": user_id,
         "execution_context": execution_context,
         "execution_processor": execution_processor,
+        "nodes_to_skip": nodes_to_skip or set(),
     }
 
     # Last-minute fetch credentials + acquire a system-wide read-write lock to prevent
@@ -508,6 +544,7 @@ class ExecutionProcessor:
         node_exec_progress: NodeExecutionProgress,
         nodes_input_masks: Optional[NodesInputMasks],
         graph_stats_pair: tuple[GraphExecutionStats, threading.Lock],
+        nodes_to_skip: Optional[set[str]] = None,
     ) -> NodeExecutionStats:
         log_metadata = LogMetadata(
             logger=_logger,
@@ -530,6 +567,7 @@ class ExecutionProcessor:
             db_client=db_client,
             log_metadata=log_metadata,
             nodes_input_masks=nodes_input_masks,
+            nodes_to_skip=nodes_to_skip,
         )
         if isinstance(status, BaseException):
             raise status
@@ -575,6 +613,7 @@ class ExecutionProcessor:
         db_client: "DatabaseManagerAsyncClient",
         log_metadata: LogMetadata,
         nodes_input_masks: Optional[NodesInputMasks] = None,
+        nodes_to_skip: Optional[set[str]] = None,
     ) -> ExecutionStatus:
         status = ExecutionStatus.RUNNING
 
@@ -611,6 +650,7 @@ class ExecutionProcessor:
                 execution_processor=self,
                 execution_stats=stats,
                 nodes_input_masks=nodes_input_masks,
+                nodes_to_skip=nodes_to_skip,
             ):
                 await persist_output(output_name, output_data)
 
@@ -922,6 +962,21 @@ class ExecutionProcessor:
 
                 queued_node_exec = execution_queue.get()
 
+                # Check if this node should be skipped due to optional credentials
+                if queued_node_exec.node_id in graph_exec.nodes_to_skip:
+                    log_metadata.info(
+                        f"Skipping node execution {queued_node_exec.node_exec_id} "
+                        f"for node {queued_node_exec.node_id} - optional credentials not configured"
+                    )
+                    # Mark the node as completed without executing
+                    # No outputs will be produced, so downstream nodes won't trigger
+                    update_node_execution_status(
+                        db_client=db_client,
+                        exec_id=queued_node_exec.node_exec_id,
+                        status=ExecutionStatus.COMPLETED,
+                    )
+                    continue
+
                 log_metadata.debug(
                     f"Dispatching node execution {queued_node_exec.node_exec_id} "
                     f"for node {queued_node_exec.node_id}",
@@ -982,6 +1037,7 @@ class ExecutionProcessor:
                             execution_stats,
                             execution_stats_lock,
                         ),
+                        nodes_to_skip=graph_exec.nodes_to_skip,
                     ),
                     self.node_execution_loop,
                 )
@@ -1261,12 +1317,40 @@ class ExecutionProcessor:
         graph_id: str,
         e: InsufficientBalanceError,
     ):
+        # Check if we've already sent a notification for this user+agent combo.
+        # We only send one notification per user per agent until they top up credits.
+        redis_key = f"{INSUFFICIENT_FUNDS_NOTIFIED_PREFIX}:{user_id}:{graph_id}"
+        try:
+            redis_client = redis.get_redis()
+            # SET NX returns True only if the key was newly set (didn't exist)
+            is_new_notification = redis_client.set(
+                redis_key,
+                "1",
+                nx=True,
+                ex=INSUFFICIENT_FUNDS_NOTIFIED_TTL_SECONDS,
+            )
+            if not is_new_notification:
+                # Already notified for this user+agent, skip all notifications
+                logger.debug(
+                    f"Skipping duplicate insufficient funds notification for "
+                    f"user={user_id}, graph={graph_id}"
+                )
+                return
+        except Exception as redis_error:
+            # If Redis fails, log and continue to send the notification
+            # (better to occasionally duplicate than to never notify)
+            logger.warning(
+                f"Failed to check/set insufficient funds notification flag in Redis: "
+                f"{redis_error}"
+            )
+
         shortfall = abs(e.amount) - e.balance
         metadata = db_client.get_graph_metadata(graph_id)
         base_url = (
             settings.config.frontend_base_url or settings.config.platform_base_url
         )
 
+        # Queue user email notification
         queue_notification(
             NotificationEventModel(
                 user_id=user_id,
@@ -1280,6 +1364,7 @@ class ExecutionProcessor:
             )
         )
 
+        # Send Discord system alert
         try:
             user_email = db_client.get_user_email_by_id(user_id)
 
diff --git a/autogpt_platform/backend/backend/executor/manager_insufficient_funds_test.py b/autogpt_platform/backend/backend/executor/manager_insufficient_funds_test.py
new file mode 100644
index 0000000000..276c9f4f7a
--- /dev/null
+++ b/autogpt_platform/backend/backend/executor/manager_insufficient_funds_test.py
@@ -0,0 +1,560 @@
+from unittest.mock import AsyncMock, MagicMock, patch
+
+import pytest
+from prisma.enums import NotificationType
+
+from backend.data.notifications import ZeroBalanceData
+from backend.executor.manager import (
+    INSUFFICIENT_FUNDS_NOTIFIED_PREFIX,
+    ExecutionProcessor,
+    clear_insufficient_funds_notifications,
+)
+from backend.util.exceptions import InsufficientBalanceError
+from backend.util.test import SpinTestServer
+
+
+async def async_iter(items):
+    """Helper to create an async iterator from a list."""
+    for item in items:
+        yield item
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_handle_insufficient_funds_sends_discord_alert_first_time(
+    server: SpinTestServer,
+):
+    """Test that the first insufficient funds notification sends a Discord alert."""
+
+    execution_processor = ExecutionProcessor()
+    user_id = "test-user-123"
+    graph_id = "test-graph-456"
+    error = InsufficientBalanceError(
+        message="Insufficient balance",
+        user_id=user_id,
+        balance=72,  # $0.72
+        amount=-714,  # Attempting to spend $7.14
+    )
+
+    with patch(
+        "backend.executor.manager.queue_notification"
+    ) as mock_queue_notif, patch(
+        "backend.executor.manager.get_notification_manager_client"
+    ) as mock_get_client, patch(
+        "backend.executor.manager.settings"
+    ) as mock_settings, patch(
+        "backend.executor.manager.redis"
+    ) as mock_redis_module:
+
+        # Setup mocks
+        mock_client = MagicMock()
+        mock_get_client.return_value = mock_client
+        mock_settings.config.frontend_base_url = "https://test.com"
+
+        # Mock Redis to simulate first-time notification (set returns True)
+        mock_redis_client = MagicMock()
+        mock_redis_module.get_redis.return_value = mock_redis_client
+        mock_redis_client.set.return_value = True  # Key was newly set
+
+        # Create mock database client
+        mock_db_client = MagicMock()
+        mock_graph_metadata = MagicMock()
+        mock_graph_metadata.name = "Test Agent"
+        mock_db_client.get_graph_metadata.return_value = mock_graph_metadata
+        mock_db_client.get_user_email_by_id.return_value = "test@example.com"
+
+        # Test the insufficient funds handler
+        execution_processor._handle_insufficient_funds_notif(
+            db_client=mock_db_client,
+            user_id=user_id,
+            graph_id=graph_id,
+            e=error,
+        )
+
+        # Verify notification was queued
+        mock_queue_notif.assert_called_once()
+        notification_call = mock_queue_notif.call_args[0][0]
+        assert notification_call.type == NotificationType.ZERO_BALANCE
+        assert notification_call.user_id == user_id
+        assert isinstance(notification_call.data, ZeroBalanceData)
+        assert notification_call.data.current_balance == 72
+
+        # Verify Redis was checked with correct key pattern
+        expected_key = f"{INSUFFICIENT_FUNDS_NOTIFIED_PREFIX}:{user_id}:{graph_id}"
+        mock_redis_client.set.assert_called_once()
+        call_args = mock_redis_client.set.call_args
+        assert call_args[0][0] == expected_key
+        assert call_args[1]["nx"] is True
+
+        # Verify Discord alert was sent
+        mock_client.discord_system_alert.assert_called_once()
+        discord_message = mock_client.discord_system_alert.call_args[0][0]
+        assert "Insufficient Funds Alert" in discord_message
+        assert "test@example.com" in discord_message
+        assert "Test Agent" in discord_message
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_handle_insufficient_funds_skips_duplicate_notifications(
+    server: SpinTestServer,
+):
+    """Test that duplicate insufficient funds notifications skip both email and Discord."""
+
+    execution_processor = ExecutionProcessor()
+    user_id = "test-user-123"
+    graph_id = "test-graph-456"
+    error = InsufficientBalanceError(
+        message="Insufficient balance",
+        user_id=user_id,
+        balance=72,
+        amount=-714,
+    )
+
+    with patch(
+        "backend.executor.manager.queue_notification"
+    ) as mock_queue_notif, patch(
+        "backend.executor.manager.get_notification_manager_client"
+    ) as mock_get_client, patch(
+        "backend.executor.manager.settings"
+    ) as mock_settings, patch(
+        "backend.executor.manager.redis"
+    ) as mock_redis_module:
+
+        # Setup mocks
+        mock_client = MagicMock()
+        mock_get_client.return_value = mock_client
+        mock_settings.config.frontend_base_url = "https://test.com"
+
+        # Mock Redis to simulate duplicate notification (set returns False/None)
+        mock_redis_client = MagicMock()
+        mock_redis_module.get_redis.return_value = mock_redis_client
+        mock_redis_client.set.return_value = None  # Key already existed
+
+        # Create mock database client
+        mock_db_client = MagicMock()
+        mock_db_client.get_graph_metadata.return_value = MagicMock(name="Test Agent")
+
+        # Test the insufficient funds handler
+        execution_processor._handle_insufficient_funds_notif(
+            db_client=mock_db_client,
+            user_id=user_id,
+            graph_id=graph_id,
+            e=error,
+        )
+
+        # Verify email notification was NOT queued (deduplication worked)
+        mock_queue_notif.assert_not_called()
+
+        # Verify Discord alert was NOT sent (deduplication worked)
+        mock_client.discord_system_alert.assert_not_called()
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_handle_insufficient_funds_different_agents_get_separate_alerts(
+    server: SpinTestServer,
+):
+    """Test that different agents for the same user get separate Discord alerts."""
+
+    execution_processor = ExecutionProcessor()
+    user_id = "test-user-123"
+    graph_id_1 = "test-graph-111"
+    graph_id_2 = "test-graph-222"
+
+    error = InsufficientBalanceError(
+        message="Insufficient balance",
+        user_id=user_id,
+        balance=72,
+        amount=-714,
+    )
+
+    with patch("backend.executor.manager.queue_notification"), patch(
+        "backend.executor.manager.get_notification_manager_client"
+    ) as mock_get_client, patch(
+        "backend.executor.manager.settings"
+    ) as mock_settings, patch(
+        "backend.executor.manager.redis"
+    ) as mock_redis_module:
+
+        mock_client = MagicMock()
+        mock_get_client.return_value = mock_client
+        mock_settings.config.frontend_base_url = "https://test.com"
+
+        mock_redis_client = MagicMock()
+        mock_redis_module.get_redis.return_value = mock_redis_client
+        # Both calls return True (first time for each agent)
+        mock_redis_client.set.return_value = True
+
+        mock_db_client = MagicMock()
+        mock_graph_metadata = MagicMock()
+        mock_graph_metadata.name = "Test Agent"
+        mock_db_client.get_graph_metadata.return_value = mock_graph_metadata
+        mock_db_client.get_user_email_by_id.return_value = "test@example.com"
+
+        # First agent notification
+        execution_processor._handle_insufficient_funds_notif(
+            db_client=mock_db_client,
+            user_id=user_id,
+            graph_id=graph_id_1,
+            e=error,
+        )
+
+        # Second agent notification
+        execution_processor._handle_insufficient_funds_notif(
+            db_client=mock_db_client,
+            user_id=user_id,
+            graph_id=graph_id_2,
+            e=error,
+        )
+
+        # Verify Discord alerts were sent for both agents
+        assert mock_client.discord_system_alert.call_count == 2
+
+        # Verify Redis was called with different keys
+        assert mock_redis_client.set.call_count == 2
+        calls = mock_redis_client.set.call_args_list
+        assert (
+            calls[0][0][0]
+            == f"{INSUFFICIENT_FUNDS_NOTIFIED_PREFIX}:{user_id}:{graph_id_1}"
+        )
+        assert (
+            calls[1][0][0]
+            == f"{INSUFFICIENT_FUNDS_NOTIFIED_PREFIX}:{user_id}:{graph_id_2}"
+        )
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_clear_insufficient_funds_notifications(server: SpinTestServer):
+    """Test that clearing notifications removes all keys for a user."""
+
+    user_id = "test-user-123"
+
+    with patch("backend.executor.manager.redis") as mock_redis_module:
+
+        mock_redis_client = MagicMock()
+        # get_redis_async is an async function, so we need AsyncMock for it
+        mock_redis_module.get_redis_async = AsyncMock(return_value=mock_redis_client)
+
+        # Mock scan_iter to return some keys as an async iterator
+        mock_keys = [
+            f"{INSUFFICIENT_FUNDS_NOTIFIED_PREFIX}:{user_id}:graph-1",
+            f"{INSUFFICIENT_FUNDS_NOTIFIED_PREFIX}:{user_id}:graph-2",
+            f"{INSUFFICIENT_FUNDS_NOTIFIED_PREFIX}:{user_id}:graph-3",
+        ]
+        mock_redis_client.scan_iter.return_value = async_iter(mock_keys)
+        # delete is awaited, so use AsyncMock
+        mock_redis_client.delete = AsyncMock(return_value=3)
+
+        # Clear notifications
+        result = await clear_insufficient_funds_notifications(user_id)
+
+        # Verify correct pattern was used
+        expected_pattern = f"{INSUFFICIENT_FUNDS_NOTIFIED_PREFIX}:{user_id}:*"
+        mock_redis_client.scan_iter.assert_called_once_with(match=expected_pattern)
+
+        # Verify delete was called with all keys
+        mock_redis_client.delete.assert_called_once_with(*mock_keys)
+
+        # Verify return value
+        assert result == 3
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_clear_insufficient_funds_notifications_no_keys(server: SpinTestServer):
+    """Test clearing notifications when there are no keys to clear."""
+
+    user_id = "test-user-no-notifications"
+
+    with patch("backend.executor.manager.redis") as mock_redis_module:
+
+        mock_redis_client = MagicMock()
+        # get_redis_async is an async function, so we need AsyncMock for it
+        mock_redis_module.get_redis_async = AsyncMock(return_value=mock_redis_client)
+
+        # Mock scan_iter to return no keys as an async iterator
+        mock_redis_client.scan_iter.return_value = async_iter([])
+
+        # Clear notifications
+        result = await clear_insufficient_funds_notifications(user_id)
+
+        # Verify delete was not called
+        mock_redis_client.delete.assert_not_called()
+
+        # Verify return value
+        assert result == 0
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_clear_insufficient_funds_notifications_handles_redis_error(
+    server: SpinTestServer,
+):
+    """Test that clearing notifications handles Redis errors gracefully."""
+
+    user_id = "test-user-redis-error"
+
+    with patch("backend.executor.manager.redis") as mock_redis_module:
+
+        # Mock get_redis_async to raise an error
+        mock_redis_module.get_redis_async = AsyncMock(
+            side_effect=Exception("Redis connection failed")
+        )
+
+        # Clear notifications should not raise, just return 0
+        result = await clear_insufficient_funds_notifications(user_id)
+
+        # Verify it returned 0 (graceful failure)
+        assert result == 0
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_handle_insufficient_funds_continues_on_redis_error(
+    server: SpinTestServer,
+):
+    """Test that both email and Discord notifications are still sent when Redis fails."""
+
+    execution_processor = ExecutionProcessor()
+    user_id = "test-user-123"
+    graph_id = "test-graph-456"
+    error = InsufficientBalanceError(
+        message="Insufficient balance",
+        user_id=user_id,
+        balance=72,
+        amount=-714,
+    )
+
+    with patch(
+        "backend.executor.manager.queue_notification"
+    ) as mock_queue_notif, patch(
+        "backend.executor.manager.get_notification_manager_client"
+    ) as mock_get_client, patch(
+        "backend.executor.manager.settings"
+    ) as mock_settings, patch(
+        "backend.executor.manager.redis"
+    ) as mock_redis_module:
+
+        mock_client = MagicMock()
+        mock_get_client.return_value = mock_client
+        mock_settings.config.frontend_base_url = "https://test.com"
+
+        # Mock Redis to raise an error
+        mock_redis_client = MagicMock()
+        mock_redis_module.get_redis.return_value = mock_redis_client
+        mock_redis_client.set.side_effect = Exception("Redis connection error")
+
+        mock_db_client = MagicMock()
+        mock_graph_metadata = MagicMock()
+        mock_graph_metadata.name = "Test Agent"
+        mock_db_client.get_graph_metadata.return_value = mock_graph_metadata
+        mock_db_client.get_user_email_by_id.return_value = "test@example.com"
+
+        # Test the insufficient funds handler
+        execution_processor._handle_insufficient_funds_notif(
+            db_client=mock_db_client,
+            user_id=user_id,
+            graph_id=graph_id,
+            e=error,
+        )
+
+        # Verify email notification was still queued despite Redis error
+        mock_queue_notif.assert_called_once()
+
+        # Verify Discord alert was still sent despite Redis error
+        mock_client.discord_system_alert.assert_called_once()
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_add_transaction_clears_notifications_on_grant(server: SpinTestServer):
+    """Test that _add_transaction clears notification flags when adding GRANT credits."""
+    from prisma.enums import CreditTransactionType
+
+    from backend.data.credit import UserCredit
+
+    user_id = "test-user-grant-clear"
+
+    with patch("backend.data.credit.query_raw_with_schema") as mock_query, patch(
+        "backend.executor.manager.redis"
+    ) as mock_redis_module:
+
+        # Mock the query to return a successful transaction
+        mock_query.return_value = [{"balance": 1000, "transactionKey": "test-tx-key"}]
+
+        # Mock async Redis for notification clearing
+        mock_redis_client = MagicMock()
+        mock_redis_module.get_redis_async = AsyncMock(return_value=mock_redis_client)
+        mock_redis_client.scan_iter.return_value = async_iter(
+            [f"{INSUFFICIENT_FUNDS_NOTIFIED_PREFIX}:{user_id}:graph-1"]
+        )
+        mock_redis_client.delete = AsyncMock(return_value=1)
+
+        # Create a concrete instance
+        credit_model = UserCredit()
+
+        # Call _add_transaction with GRANT type (should clear notifications)
+        await credit_model._add_transaction(
+            user_id=user_id,
+            amount=500,  # Positive amount
+            transaction_type=CreditTransactionType.GRANT,
+            is_active=True,  # Active transaction
+        )
+
+        # Verify notification clearing was called
+        mock_redis_module.get_redis_async.assert_called_once()
+        mock_redis_client.scan_iter.assert_called_once_with(
+            match=f"{INSUFFICIENT_FUNDS_NOTIFIED_PREFIX}:{user_id}:*"
+        )
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_add_transaction_clears_notifications_on_top_up(server: SpinTestServer):
+    """Test that _add_transaction clears notification flags when adding TOP_UP credits."""
+    from prisma.enums import CreditTransactionType
+
+    from backend.data.credit import UserCredit
+
+    user_id = "test-user-topup-clear"
+
+    with patch("backend.data.credit.query_raw_with_schema") as mock_query, patch(
+        "backend.executor.manager.redis"
+    ) as mock_redis_module:
+
+        # Mock the query to return a successful transaction
+        mock_query.return_value = [{"balance": 2000, "transactionKey": "test-tx-key-2"}]
+
+        # Mock async Redis for notification clearing
+        mock_redis_client = MagicMock()
+        mock_redis_module.get_redis_async = AsyncMock(return_value=mock_redis_client)
+        mock_redis_client.scan_iter.return_value = async_iter([])
+        mock_redis_client.delete = AsyncMock(return_value=0)
+
+        credit_model = UserCredit()
+
+        # Call _add_transaction with TOP_UP type (should clear notifications)
+        await credit_model._add_transaction(
+            user_id=user_id,
+            amount=1000,  # Positive amount
+            transaction_type=CreditTransactionType.TOP_UP,
+            is_active=True,
+        )
+
+        # Verify notification clearing was attempted
+        mock_redis_module.get_redis_async.assert_called_once()
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_add_transaction_skips_clearing_for_inactive_transaction(
+    server: SpinTestServer,
+):
+    """Test that _add_transaction does NOT clear notifications for inactive transactions."""
+    from prisma.enums import CreditTransactionType
+
+    from backend.data.credit import UserCredit
+
+    user_id = "test-user-inactive"
+
+    with patch("backend.data.credit.query_raw_with_schema") as mock_query, patch(
+        "backend.executor.manager.redis"
+    ) as mock_redis_module:
+
+        # Mock the query to return a successful transaction
+        mock_query.return_value = [{"balance": 500, "transactionKey": "test-tx-key-3"}]
+
+        # Mock async Redis
+        mock_redis_client = MagicMock()
+        mock_redis_module.get_redis_async = AsyncMock(return_value=mock_redis_client)
+
+        credit_model = UserCredit()
+
+        # Call _add_transaction with is_active=False (should NOT clear notifications)
+        await credit_model._add_transaction(
+            user_id=user_id,
+            amount=500,
+            transaction_type=CreditTransactionType.TOP_UP,
+            is_active=False,  # Inactive - pending Stripe payment
+        )
+
+        # Verify notification clearing was NOT called
+        mock_redis_module.get_redis_async.assert_not_called()
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_add_transaction_skips_clearing_for_usage_transaction(
+    server: SpinTestServer,
+):
+    """Test that _add_transaction does NOT clear notifications for USAGE transactions."""
+    from prisma.enums import CreditTransactionType
+
+    from backend.data.credit import UserCredit
+
+    user_id = "test-user-usage"
+
+    with patch("backend.data.credit.query_raw_with_schema") as mock_query, patch(
+        "backend.executor.manager.redis"
+    ) as mock_redis_module:
+
+        # Mock the query to return a successful transaction
+        mock_query.return_value = [{"balance": 400, "transactionKey": "test-tx-key-4"}]
+
+        # Mock async Redis
+        mock_redis_client = MagicMock()
+        mock_redis_module.get_redis_async = AsyncMock(return_value=mock_redis_client)
+
+        credit_model = UserCredit()
+
+        # Call _add_transaction with USAGE type (spending, should NOT clear)
+        await credit_model._add_transaction(
+            user_id=user_id,
+            amount=-100,  # Negative - spending credits
+            transaction_type=CreditTransactionType.USAGE,
+            is_active=True,
+        )
+
+        # Verify notification clearing was NOT called
+        mock_redis_module.get_redis_async.assert_not_called()
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_enable_transaction_clears_notifications(server: SpinTestServer):
+    """Test that _enable_transaction clears notification flags when enabling a TOP_UP."""
+    from prisma.enums import CreditTransactionType
+
+    from backend.data.credit import UserCredit
+
+    user_id = "test-user-enable"
+
+    with patch("backend.data.credit.CreditTransaction") as mock_credit_tx, patch(
+        "backend.data.credit.query_raw_with_schema"
+    ) as mock_query, patch("backend.executor.manager.redis") as mock_redis_module:
+
+        # Mock finding the pending transaction
+        mock_transaction = MagicMock()
+        mock_transaction.amount = 1000
+        mock_transaction.type = CreditTransactionType.TOP_UP
+        mock_credit_tx.prisma.return_value.find_first = AsyncMock(
+            return_value=mock_transaction
+        )
+
+        # Mock the query to return updated balance
+        mock_query.return_value = [{"balance": 1500}]
+
+        # Mock async Redis for notification clearing
+        mock_redis_client = MagicMock()
+        mock_redis_module.get_redis_async = AsyncMock(return_value=mock_redis_client)
+        mock_redis_client.scan_iter.return_value = async_iter(
+            [f"{INSUFFICIENT_FUNDS_NOTIFIED_PREFIX}:{user_id}:graph-1"]
+        )
+        mock_redis_client.delete = AsyncMock(return_value=1)
+
+        credit_model = UserCredit()
+
+        # Call _enable_transaction (simulates Stripe checkout completion)
+        from backend.util.json import SafeJson
+
+        await credit_model._enable_transaction(
+            transaction_key="cs_test_123",
+            user_id=user_id,
+            metadata=SafeJson({"payment": "completed"}),
+        )
+
+        # Verify notification clearing was called
+        mock_redis_module.get_redis_async.assert_called_once()
+        mock_redis_client.scan_iter.assert_called_once_with(
+            match=f"{INSUFFICIENT_FUNDS_NOTIFIED_PREFIX}:{user_id}:*"
+        )
diff --git a/autogpt_platform/backend/backend/executor/manager_test.py b/autogpt_platform/backend/backend/executor/manager_test.py
index bdfdb5d724..69deba4b00 100644
--- a/autogpt_platform/backend/backend/executor/manager_test.py
+++ b/autogpt_platform/backend/backend/executor/manager_test.py
@@ -1,4 +1,5 @@
 import logging
+from unittest.mock import AsyncMock, patch
 
 import fastapi.responses
 import pytest
@@ -19,6 +20,17 @@ from backend.util.test import SpinTestServer, wait_execution
 logger = logging.getLogger(__name__)
 
 
+@pytest.fixture(scope="session", autouse=True)
+def mock_embedding_functions():
+    """Mock embedding functions for all tests to avoid database/API dependencies."""
+    with patch(
+        "backend.api.features.store.db.ensure_embedding",
+        new_callable=AsyncMock,
+        return_value=True,
+    ):
+        yield
+
+
 async def create_graph(s: SpinTestServer, g: graph.Graph, u: User) -> graph.Graph:
     logger.info(f"Creating graph for user {u.id}")
     return await s.agent_server.test_create_graph(CreateGraph(graph=g), u.id)
diff --git a/autogpt_platform/backend/backend/executor/scheduler.py b/autogpt_platform/backend/backend/executor/scheduler.py
index 06c50bf82e..c2aa81b10a 100644
--- a/autogpt_platform/backend/backend/executor/scheduler.py
+++ b/autogpt_platform/backend/backend/executor/scheduler.py
@@ -2,6 +2,7 @@ import asyncio
 import logging
 import os
 import threading
+import time
 import uuid
 from enum import Enum
 from typing import Optional
@@ -27,7 +28,7 @@ from backend.data.auth.oauth import cleanup_expired_oauth_tokens
 from backend.data.block import BlockInput
 from backend.data.execution import GraphExecutionWithNodes
 from backend.data.model import CredentialsMetaInput
-from backend.data.onboarding import increment_runs
+from backend.data.onboarding import increment_onboarding_runs
 from backend.executor import utils as execution_utils
 from backend.monitoring import (
     NotificationJobArgs,
@@ -37,7 +38,7 @@ from backend.monitoring import (
     report_execution_accuracy_alerts,
     report_late_executions,
 )
-from backend.util.clients import get_scheduler_client
+from backend.util.clients import get_database_manager_client, get_scheduler_client
 from backend.util.cloud_storage import cleanup_expired_files_async
 from backend.util.exceptions import (
     GraphNotFoundError,
@@ -156,7 +157,7 @@ async def _execute_graph(**kwargs):
             inputs=args.input_data,
             graph_credentials_inputs=args.input_credentials,
         )
-        await increment_runs(args.user_id)
+        await increment_onboarding_runs(args.user_id)
         elapsed = asyncio.get_event_loop().time() - start_time
         logger.info(
             f"Graph execution started with ID {graph_exec.id} for graph {args.graph_id} "
@@ -254,6 +255,114 @@ def execution_accuracy_alerts():
     return report_execution_accuracy_alerts()
 
 
+def ensure_embeddings_coverage():
+    """
+    Ensure all content types (store agents, blocks, docs) have embeddings for search.
+
+    Processes ALL missing embeddings in batches of 10 per content type until 100% coverage.
+    Missing embeddings = content invisible in hybrid search.
+
+    Schedule: Runs every 6 hours (balanced between coverage and API costs).
+    - Catches new content added between scheduled runs
+    - Batch size 10 per content type: gradual processing to avoid rate limits
+    - Manual trigger available via execute_ensure_embeddings_coverage endpoint
+    """
+    db_client = get_database_manager_client()
+    stats = db_client.get_embedding_stats()
+
+    # Check for error from get_embedding_stats() first
+    if "error" in stats:
+        logger.error(
+            f"Failed to get embedding stats: {stats['error']} - skipping backfill"
+        )
+        return {
+            "backfill": {"processed": 0, "success": 0, "failed": 0},
+            "cleanup": {"deleted": 0},
+            "error": stats["error"],
+        }
+
+    # Extract totals from new stats structure
+    totals = stats.get("totals", {})
+    without_embeddings = totals.get("without_embeddings", 0)
+    coverage_percent = totals.get("coverage_percent", 0)
+
+    total_processed = 0
+    total_success = 0
+    total_failed = 0
+
+    if without_embeddings == 0:
+        logger.info("All content has embeddings, skipping backfill")
+    else:
+        # Log per-content-type stats for visibility
+        by_type = stats.get("by_type", {})
+        for content_type, type_stats in by_type.items():
+            if type_stats.get("without_embeddings", 0) > 0:
+                logger.info(
+                    f"{content_type}: {type_stats['without_embeddings']} items without embeddings "
+                    f"({type_stats['coverage_percent']}% coverage)"
+                )
+
+        logger.info(
+            f"Total: {without_embeddings} items without embeddings "
+            f"({coverage_percent}% coverage) - processing all"
+        )
+
+        # Process in batches until no more missing embeddings
+        while True:
+            result = db_client.backfill_missing_embeddings(batch_size=10)
+
+            total_processed += result["processed"]
+            total_success += result["success"]
+            total_failed += result["failed"]
+
+            if result["processed"] == 0:
+                # No more missing embeddings
+                break
+
+            if result["success"] == 0 and result["processed"] > 0:
+                # All attempts in this batch failed - stop to avoid infinite loop
+                logger.error(
+                    f"All {result['processed']} embedding attempts failed - stopping backfill"
+                )
+                break
+
+            # Small delay between batches to avoid rate limits
+            time.sleep(1)
+
+        logger.info(
+            f"Embedding backfill completed: {total_success}/{total_processed} succeeded, "
+            f"{total_failed} failed"
+        )
+
+    # Clean up orphaned embeddings for blocks and docs
+    logger.info("Running cleanup for orphaned embeddings (blocks/docs)...")
+    cleanup_result = db_client.cleanup_orphaned_embeddings()
+    cleanup_totals = cleanup_result.get("totals", {})
+    cleanup_deleted = cleanup_totals.get("deleted", 0)
+
+    if cleanup_deleted > 0:
+        logger.info(f"Cleanup completed: deleted {cleanup_deleted} orphaned embeddings")
+        by_type = cleanup_result.get("by_type", {})
+        for content_type, type_result in by_type.items():
+            if type_result.get("deleted", 0) > 0:
+                logger.info(
+                    f"{content_type}: deleted {type_result['deleted']} orphaned embeddings"
+                )
+    else:
+        logger.info("Cleanup completed: no orphaned embeddings found")
+
+    return {
+        "backfill": {
+            "processed": total_processed,
+            "success": total_success,
+            "failed": total_failed,
+        },
+        "cleanup": {
+            "deleted": cleanup_deleted,
+        },
+    }
+
+
 # Monitoring functions are now imported from monitoring module
 
 
@@ -475,11 +584,36 @@ class Scheduler(AppService):
                 jobstore=Jobstores.EXECUTION.value,
             )
 
+            # Embedding Coverage - Every 6 hours
+            # Ensures all approved agents have embeddings for hybrid search
+            # Critical: missing embeddings = agents invisible in search
+            self.scheduler.add_job(
+                ensure_embeddings_coverage,
+                id="ensure_embeddings_coverage",
+                trigger="interval",
+                hours=6,
+                replace_existing=True,
+                max_instances=1,  # Prevent overlapping runs
+                jobstore=Jobstores.EXECUTION.value,
+            )
+
         self.scheduler.add_listener(job_listener, EVENT_JOB_EXECUTED | EVENT_JOB_ERROR)
         self.scheduler.add_listener(job_missed_listener, EVENT_JOB_MISSED)
         self.scheduler.add_listener(job_max_instances_listener, EVENT_JOB_MAX_INSTANCES)
         self.scheduler.start()
 
+        # Run embedding backfill immediately on startup
+        # This ensures blocks/docs are searchable right away, not after 6 hours
+        # Safe to run on multiple pods - uses upserts and checks for existing embeddings
+        if self.register_system_tasks:
+            logger.info("Running embedding backfill on startup...")
+            try:
+                result = ensure_embeddings_coverage()
+                logger.info(f"Startup embedding backfill complete: {result}")
+            except Exception as e:
+                logger.error(f"Startup embedding backfill failed: {e}")
+                # Don't fail startup - the scheduled job will retry later
+
         # Keep the service running since BackgroundScheduler doesn't block
         super().run_service()
 
@@ -632,6 +766,11 @@ class Scheduler(AppService):
         """Manually trigger execution accuracy alert checking."""
         return execution_accuracy_alerts()
 
+    @expose
+    def execute_ensure_embeddings_coverage(self):
+        """Manually trigger embedding backfill for approved store agents."""
+        return ensure_embeddings_coverage()
+
 
 class SchedulerClient(AppServiceClient):
     @classmethod
diff --git a/autogpt_platform/backend/backend/executor/utils.py b/autogpt_platform/backend/backend/executor/utils.py
index bcd3dcf3b6..25f0389e99 100644
--- a/autogpt_platform/backend/backend/executor/utils.py
+++ b/autogpt_platform/backend/backend/executor/utils.py
@@ -10,6 +10,7 @@ from pydantic import BaseModel, JsonValue, ValidationError
 
 from backend.data import execution as execution_db
 from backend.data import graph as graph_db
+from backend.data import onboarding as onboarding_db
 from backend.data import user as user_db
 from backend.data.block import (
     Block,
@@ -31,7 +32,6 @@ from backend.data.execution import (
     GraphExecutionStats,
     GraphExecutionWithNodes,
     NodesInputMasks,
-    get_graph_execution,
 )
 from backend.data.graph import GraphModel, Node
 from backend.data.model import USER_TIMEZONE_NOT_SET, CredentialsMetaInput
@@ -239,14 +239,19 @@ async def _validate_node_input_credentials(
     graph: GraphModel,
     user_id: str,
     nodes_input_masks: Optional[NodesInputMasks] = None,
-) -> dict[str, dict[str, str]]:
+) -> tuple[dict[str, dict[str, str]], set[str]]:
     """
-    Checks all credentials for all nodes of the graph and returns structured errors.
+    Checks all credentials for all nodes of the graph and returns structured errors
+    and a set of nodes that should be skipped due to optional missing credentials.
 
     Returns:
-        dict[node_id, dict[field_name, error_message]]: Credential validation errors per node
+        tuple[
+            dict[node_id, dict[field_name, error_message]]: Credential validation errors per node,
+            set[node_id]: Nodes that should be skipped (optional credentials not configured)
+        ]
     """
     credential_errors: dict[str, dict[str, str]] = defaultdict(dict)
+    nodes_to_skip: set[str] = set()
 
     for node in graph.nodes:
         block = node.block
@@ -256,27 +261,46 @@ async def _validate_node_input_credentials(
         if not credentials_fields:
             continue
 
+        # Track if any credential field is missing for this node
+        has_missing_credentials = False
+
         for field_name, credentials_meta_type in credentials_fields.items():
             try:
+                # Check nodes_input_masks first, then input_default
+                field_value = None
                 if (
                     nodes_input_masks
                     and (node_input_mask := nodes_input_masks.get(node.id))
                     and field_name in node_input_mask
                 ):
-                    credentials_meta = credentials_meta_type.model_validate(
-                        node_input_mask[field_name]
-                    )
+                    field_value = node_input_mask[field_name]
                 elif field_name in node.input_default:
-                    credentials_meta = credentials_meta_type.model_validate(
-                        node.input_default[field_name]
-                    )
-                else:
-                    # Missing credentials
-                    credential_errors[node.id][
-                        field_name
-                    ] = "These credentials are required"
-                    continue
+                    # For optional credentials, don't use input_default - treat as missing
+                    # This prevents stale credential IDs from failing validation
+                    if node.credentials_optional:
+                        field_value = None
+                    else:
+                        field_value = node.input_default[field_name]
+
+                # Check if credentials are missing (None, empty, or not present)
+                if field_value is None or (
+                    isinstance(field_value, dict) and not field_value.get("id")
+                ):
+                    has_missing_credentials = True
+                    # If node has credentials_optional flag, mark for skipping instead of error
+                    if node.credentials_optional:
+                        continue  # Don't add error, will be marked for skip after loop
+                    else:
+                        credential_errors[node.id][
+                            field_name
+                        ] = "These credentials are required"
+                        continue
+
+                credentials_meta = credentials_meta_type.model_validate(field_value)
+
             except ValidationError as e:
+                # Validation error means credentials were provided but invalid
+                # This should always be an error, even if optional
                 credential_errors[node.id][field_name] = f"Invalid credentials: {e}"
                 continue
 
@@ -287,6 +311,7 @@ async def _validate_node_input_credentials(
                 )
             except Exception as e:
                 # Handle any errors fetching credentials
+                # If credentials were explicitly configured but unavailable, it's an error
                 credential_errors[node.id][
                     field_name
                 ] = f"Credentials not available: {e}"
@@ -313,7 +338,19 @@ async def _validate_node_input_credentials(
                 ] = "Invalid credentials: type/provider mismatch"
                 continue
 
-    return credential_errors
+        # If node has optional credentials and any are missing, mark for skipping
+        # But only if there are no other errors for this node
+        if (
+            has_missing_credentials
+            and node.credentials_optional
+            and node.id not in credential_errors
+        ):
+            nodes_to_skip.add(node.id)
+            logger.info(
+                f"Node #{node.id} will be skipped: optional credentials not configured"
+            )
+
+    return credential_errors, nodes_to_skip
 
 
 def make_node_credentials_input_map(
@@ -355,21 +392,25 @@ async def validate_graph_with_credentials(
     graph: GraphModel,
     user_id: str,
     nodes_input_masks: Optional[NodesInputMasks] = None,
-) -> Mapping[str, Mapping[str, str]]:
+) -> tuple[Mapping[str, Mapping[str, str]], set[str]]:
     """
-    Validate graph including credentials and return structured errors per node.
+    Validate graph including credentials and return structured errors per node,
+    along with a set of nodes that should be skipped due to optional missing credentials.
 
     Returns:
-        dict[node_id, dict[field_name, error_message]]: Validation errors per node
+        tuple[
+            dict[node_id, dict[field_name, error_message]]: Validation errors per node,
+            set[node_id]: Nodes that should be skipped (optional credentials not configured)
+        ]
     """
     # Get input validation errors
     node_input_errors = GraphModel.validate_graph_get_errors(
         graph, for_run=True, nodes_input_masks=nodes_input_masks
     )
 
-    # Get credential input/availability/validation errors
-    node_credential_input_errors = await _validate_node_input_credentials(
-        graph, user_id, nodes_input_masks
+    # Get credential input/availability/validation errors and nodes to skip
+    node_credential_input_errors, nodes_to_skip = (
+        await _validate_node_input_credentials(graph, user_id, nodes_input_masks)
     )
 
     # Merge credential errors with structural errors
@@ -378,7 +419,7 @@ async def validate_graph_with_credentials(
             node_input_errors[node_id] = {}
         node_input_errors[node_id].update(field_errors)
 
-    return node_input_errors
+    return node_input_errors, nodes_to_skip
 
 
 async def _construct_starting_node_execution_input(
@@ -386,7 +427,7 @@ async def _construct_starting_node_execution_input(
     user_id: str,
     graph_inputs: BlockInput,
     nodes_input_masks: Optional[NodesInputMasks] = None,
-) -> list[tuple[str, BlockInput]]:
+) -> tuple[list[tuple[str, BlockInput]], set[str]]:
     """
     Validates and prepares the input data for executing a graph.
     This function checks the graph for starting nodes, validates the input data
@@ -400,11 +441,14 @@ async def _construct_starting_node_execution_input(
         node_credentials_map: `dict[node_id, dict[input_name, CredentialsMetaInput]]`
 
     Returns:
-        list[tuple[str, BlockInput]]: A list of tuples, each containing the node ID and
-            the corresponding input data for that node.
+        tuple[
+            list[tuple[str, BlockInput]]: A list of tuples, each containing the node ID
+                and the corresponding input data for that node.
+            set[str]: Node IDs that should be skipped (optional credentials not configured)
+        ]
     """
     # Use new validation function that includes credentials
-    validation_errors = await validate_graph_with_credentials(
+    validation_errors, nodes_to_skip = await validate_graph_with_credentials(
         graph, user_id, nodes_input_masks
     )
     n_error_nodes = len(validation_errors)
@@ -445,7 +489,7 @@ async def _construct_starting_node_execution_input(
             "No starting nodes found for the graph, make sure an AgentInput or blocks with no inbound links are present as starting nodes."
         )
 
-    return nodes_input
+    return nodes_input, nodes_to_skip
 
 
 async def validate_and_construct_node_execution_input(
@@ -456,7 +500,7 @@ async def validate_and_construct_node_execution_input(
     graph_credentials_inputs: Optional[Mapping[str, CredentialsMetaInput]] = None,
     nodes_input_masks: Optional[NodesInputMasks] = None,
     is_sub_graph: bool = False,
-) -> tuple[GraphModel, list[tuple[str, BlockInput]], NodesInputMasks]:
+) -> tuple[GraphModel, list[tuple[str, BlockInput]], NodesInputMasks, set[str]]:
     """
     Public wrapper that handles graph fetching, credential mapping, and validation+construction.
     This centralizes the logic used by both scheduler validation and actual execution.
@@ -473,6 +517,7 @@ async def validate_and_construct_node_execution_input(
         GraphModel: Full graph object for the given `graph_id`.
         list[tuple[node_id, BlockInput]]: Starting node IDs with corresponding inputs.
         dict[str, BlockInput]: Node input masks including all passed-in credentials.
+        set[str]: Node IDs that should be skipped (optional credentials not configured).
 
     Raises:
         NotFoundError: If the graph is not found.
@@ -514,14 +559,16 @@ async def validate_and_construct_node_execution_input(
         nodes_input_masks or {},
     )
 
-    starting_nodes_input = await _construct_starting_node_execution_input(
-        graph=graph,
-        user_id=user_id,
-        graph_inputs=graph_inputs,
-        nodes_input_masks=nodes_input_masks,
+    starting_nodes_input, nodes_to_skip = (
+        await _construct_starting_node_execution_input(
+            graph=graph,
+            user_id=user_id,
+            graph_inputs=graph_inputs,
+            nodes_input_masks=nodes_input_masks,
+        )
     )
 
-    return graph, starting_nodes_input, nodes_input_masks
+    return graph, starting_nodes_input, nodes_input_masks, nodes_to_skip
 
 
 def _merge_nodes_input_masks(
@@ -762,13 +809,14 @@ async def add_graph_execution(
         edb = execution_db
         udb = user_db
         gdb = graph_db
+        odb = onboarding_db
     else:
-        edb = udb = gdb = get_database_manager_async_client()
+        edb = udb = gdb = odb = get_database_manager_async_client()
 
     # Get or create the graph execution
     if graph_exec_id:
         # Resume existing execution
-        graph_exec = await get_graph_execution(
+        graph_exec = await edb.get_graph_execution(
             user_id=user_id,
             execution_id=graph_exec_id,
             include_node_executions=True,
@@ -779,6 +827,9 @@ async def add_graph_execution(
 
         # Use existing execution's compiled input masks
         compiled_nodes_input_masks = graph_exec.nodes_input_masks or {}
+        # For resumed executions, nodes_to_skip was already determined at creation time
+        # TODO: Consider storing nodes_to_skip in DB if we need to preserve it across resumes
+        nodes_to_skip: set[str] = set()
 
         logger.info(f"Resuming graph execution #{graph_exec.id} for graph #{graph_id}")
     else:
@@ -787,7 +838,7 @@ async def add_graph_execution(
         )
 
         # Create new execution
-        graph, starting_nodes_input, compiled_nodes_input_masks = (
+        graph, starting_nodes_input, compiled_nodes_input_masks, nodes_to_skip = (
             await validate_and_construct_node_execution_input(
                 graph_id=graph_id,
                 user_id=user_id,
@@ -836,10 +887,12 @@ async def add_graph_execution(
     try:
         graph_exec_entry = graph_exec.to_graph_execution_entry(
             compiled_nodes_input_masks=compiled_nodes_input_masks,
+            nodes_to_skip=nodes_to_skip,
             execution_context=execution_context,
         )
         logger.info(f"Publishing execution {graph_exec.id} to execution queue")
 
+        # Publish to execution queue for executor to pick up
         exec_queue = await get_async_execution_queue()
         await exec_queue.publish_message(
             routing_key=GRAPH_EXECUTION_ROUTING_KEY,
@@ -848,14 +901,12 @@ async def add_graph_execution(
         )
         logger.info(f"Published execution {graph_exec.id} to RabbitMQ queue")
 
+        # Update execution status to QUEUED
         graph_exec.status = ExecutionStatus.QUEUED
         await edb.update_graph_execution_stats(
             graph_exec_id=graph_exec.id,
             status=graph_exec.status,
         )
-        await get_async_execution_event_bus().publish(graph_exec)
-
-        return graph_exec
     except BaseException as e:
         err = str(e) or type(e).__name__
         if not graph_exec:
@@ -876,6 +927,24 @@ async def add_graph_execution(
         )
         raise
 
+    try:
+        await get_async_execution_event_bus().publish(graph_exec)
+        logger.info(f"Published update for execution #{graph_exec.id} to event bus")
+    except Exception as e:
+        logger.error(
+            f"Failed to publish execution event for graph exec #{graph_exec.id}: {e}"
+        )
+
+    try:
+        await odb.increment_onboarding_runs(user_id)
+        logger.info(
+            f"Incremented user #{user_id} onboarding runs for exec #{graph_exec.id}"
+        )
+    except Exception as e:
+        logger.error(f"Failed to increment onboarding runs for user #{user_id}: {e}")
+
+    return graph_exec
+
 
 # ============ Execution Output Helpers ============ #
 
diff --git a/autogpt_platform/backend/backend/executor/utils_test.py b/autogpt_platform/backend/backend/executor/utils_test.py
index 8854214e14..0e652f9627 100644
--- a/autogpt_platform/backend/backend/executor/utils_test.py
+++ b/autogpt_platform/backend/backend/executor/utils_test.py
@@ -367,10 +367,13 @@ async def test_add_graph_execution_is_repeatable(mocker: MockerFixture):
     )
 
     # Setup mock returns
+    # The function returns (graph, starting_nodes_input, compiled_nodes_input_masks, nodes_to_skip)
+    nodes_to_skip: set[str] = set()
     mock_validate.return_value = (
         mock_graph,
         starting_nodes_input,
         compiled_nodes_input_masks,
+        nodes_to_skip,
     )
     mock_prisma.is_connected.return_value = True
     mock_edb.create_graph_execution = mocker.AsyncMock(return_value=mock_graph_exec)
@@ -456,3 +459,212 @@ async def test_add_graph_execution_is_repeatable(mocker: MockerFixture):
     # Both executions should succeed (though they create different objects)
     assert result1 == mock_graph_exec
     assert result2 == mock_graph_exec_2
+
+
+# ============================================================================
+# Tests for Optional Credentials Feature
+# ============================================================================
+
+
+@pytest.mark.asyncio
+async def test_validate_node_input_credentials_returns_nodes_to_skip(
+    mocker: MockerFixture,
+):
+    """
+    Test that _validate_node_input_credentials returns nodes_to_skip set
+    for nodes with credentials_optional=True and missing credentials.
+    """
+    from backend.executor.utils import _validate_node_input_credentials
+
+    # Create a mock node with credentials_optional=True
+    mock_node = mocker.MagicMock()
+    mock_node.id = "node-with-optional-creds"
+    mock_node.credentials_optional = True
+    mock_node.input_default = {}  # No credentials configured
+
+    # Create a mock block with credentials field
+    mock_block = mocker.MagicMock()
+    mock_credentials_field_type = mocker.MagicMock()
+    mock_block.input_schema.get_credentials_fields.return_value = {
+        "credentials": mock_credentials_field_type
+    }
+    mock_node.block = mock_block
+
+    # Create mock graph
+    mock_graph = mocker.MagicMock()
+    mock_graph.nodes = [mock_node]
+
+    # Call the function
+    errors, nodes_to_skip = await _validate_node_input_credentials(
+        graph=mock_graph,
+        user_id="test-user-id",
+        nodes_input_masks=None,
+    )
+
+    # Node should be in nodes_to_skip, not in errors
+    assert mock_node.id in nodes_to_skip
+    assert mock_node.id not in errors
+
+
+@pytest.mark.asyncio
+async def test_validate_node_input_credentials_required_missing_creds_error(
+    mocker: MockerFixture,
+):
+    """
+    Test that _validate_node_input_credentials returns errors
+    for nodes with credentials_optional=False and missing credentials.
+    """
+    from backend.executor.utils import _validate_node_input_credentials
+
+    # Create a mock node with credentials_optional=False (required)
+    mock_node = mocker.MagicMock()
+    mock_node.id = "node-with-required-creds"
+    mock_node.credentials_optional = False
+    mock_node.input_default = {}  # No credentials configured
+
+    # Create a mock block with credentials field
+    mock_block = mocker.MagicMock()
+    mock_credentials_field_type = mocker.MagicMock()
+    mock_block.input_schema.get_credentials_fields.return_value = {
+        "credentials": mock_credentials_field_type
+    }
+    mock_node.block = mock_block
+
+    # Create mock graph
+    mock_graph = mocker.MagicMock()
+    mock_graph.nodes = [mock_node]
+
+    # Call the function
+    errors, nodes_to_skip = await _validate_node_input_credentials(
+        graph=mock_graph,
+        user_id="test-user-id",
+        nodes_input_masks=None,
+    )
+
+    # Node should be in errors, not in nodes_to_skip
+    assert mock_node.id in errors
+    assert "credentials" in errors[mock_node.id]
+    assert "required" in errors[mock_node.id]["credentials"].lower()
+    assert mock_node.id not in nodes_to_skip
+
+
+@pytest.mark.asyncio
+async def test_validate_graph_with_credentials_returns_nodes_to_skip(
+    mocker: MockerFixture,
+):
+    """
+    Test that validate_graph_with_credentials returns nodes_to_skip set
+    from _validate_node_input_credentials.
+    """
+    from backend.executor.utils import validate_graph_with_credentials
+
+    # Mock _validate_node_input_credentials to return specific values
+    mock_validate = mocker.patch(
+        "backend.executor.utils._validate_node_input_credentials"
+    )
+    expected_errors = {"node1": {"field": "error"}}
+    expected_nodes_to_skip = {"node2", "node3"}
+    mock_validate.return_value = (expected_errors, expected_nodes_to_skip)
+
+    # Mock GraphModel with validate_graph_get_errors method
+    mock_graph = mocker.MagicMock()
+    mock_graph.validate_graph_get_errors.return_value = {}
+
+    # Call the function
+    errors, nodes_to_skip = await validate_graph_with_credentials(
+        graph=mock_graph,
+        user_id="test-user-id",
+        nodes_input_masks=None,
+    )
+
+    # Verify nodes_to_skip is passed through
+    assert nodes_to_skip == expected_nodes_to_skip
+    assert "node1" in errors
+
+
+@pytest.mark.asyncio
+async def test_add_graph_execution_with_nodes_to_skip(mocker: MockerFixture):
+    """
+    Test that add_graph_execution properly passes nodes_to_skip
+    to the graph execution entry.
+    """
+    from backend.data.execution import GraphExecutionWithNodes
+    from backend.executor.utils import add_graph_execution
+
+    # Mock data
+    graph_id = "test-graph-id"
+    user_id = "test-user-id"
+    inputs = {"test_input": "test_value"}
+    graph_version = 1
+
+    # Mock the graph object
+    mock_graph = mocker.MagicMock()
+    mock_graph.version = graph_version
+
+    # Starting nodes and masks
+    starting_nodes_input = [("node1", {"input1": "value1"})]
+    compiled_nodes_input_masks = {}
+    nodes_to_skip = {"skipped-node-1", "skipped-node-2"}
+
+    # Mock the graph execution object
+    mock_graph_exec = mocker.MagicMock(spec=GraphExecutionWithNodes)
+    mock_graph_exec.id = "execution-id-123"
+    mock_graph_exec.node_executions = []
+
+    # Track what's passed to to_graph_execution_entry
+    captured_kwargs = {}
+
+    def capture_to_entry(**kwargs):
+        captured_kwargs.update(kwargs)
+        return mocker.MagicMock()
+
+    mock_graph_exec.to_graph_execution_entry.side_effect = capture_to_entry
+
+    # Setup mocks
+    mock_validate = mocker.patch(
+        "backend.executor.utils.validate_and_construct_node_execution_input"
+    )
+    mock_edb = mocker.patch("backend.executor.utils.execution_db")
+    mock_prisma = mocker.patch("backend.executor.utils.prisma")
+    mock_udb = mocker.patch("backend.executor.utils.user_db")
+    mock_gdb = mocker.patch("backend.executor.utils.graph_db")
+    mock_get_queue = mocker.patch("backend.executor.utils.get_async_execution_queue")
+    mock_get_event_bus = mocker.patch(
+        "backend.executor.utils.get_async_execution_event_bus"
+    )
+
+    # Setup returns - include nodes_to_skip in the tuple
+    mock_validate.return_value = (
+        mock_graph,
+        starting_nodes_input,
+        compiled_nodes_input_masks,
+        nodes_to_skip,  # This should be passed through
+    )
+    mock_prisma.is_connected.return_value = True
+    mock_edb.create_graph_execution = mocker.AsyncMock(return_value=mock_graph_exec)
+    mock_edb.update_graph_execution_stats = mocker.AsyncMock(
+        return_value=mock_graph_exec
+    )
+    mock_edb.update_node_execution_status_batch = mocker.AsyncMock()
+
+    mock_user = mocker.MagicMock()
+    mock_user.timezone = "UTC"
+    mock_settings = mocker.MagicMock()
+    mock_settings.human_in_the_loop_safe_mode = True
+
+    mock_udb.get_user_by_id = mocker.AsyncMock(return_value=mock_user)
+    mock_gdb.get_graph_settings = mocker.AsyncMock(return_value=mock_settings)
+    mock_get_queue.return_value = mocker.AsyncMock()
+    mock_get_event_bus.return_value = mocker.MagicMock(publish=mocker.AsyncMock())
+
+    # Call the function
+    await add_graph_execution(
+        graph_id=graph_id,
+        user_id=user_id,
+        inputs=inputs,
+        graph_version=graph_version,
+    )
+
+    # Verify nodes_to_skip was passed to to_graph_execution_entry
+    assert "nodes_to_skip" in captured_kwargs
+    assert captured_kwargs["nodes_to_skip"] == nodes_to_skip
diff --git a/autogpt_platform/backend/backend/integrations/credentials_store.py b/autogpt_platform/backend/backend/integrations/credentials_store.py
index 7d805913b2..40a6f7269c 100644
--- a/autogpt_platform/backend/backend/integrations/credentials_store.py
+++ b/autogpt_platform/backend/backend/integrations/credentials_store.py
@@ -96,9 +96,9 @@ jina_credentials = APIKeyCredentials(
 )
 unreal_credentials = APIKeyCredentials(
     id="66f20754-1b81-48e4-91d0-f4f0dd82145f",
-    provider="unreal",
+    provider="unreal_speech",
     api_key=SecretStr(settings.secrets.unreal_speech_api_key),
-    title="Use Credits for Unreal",
+    title="Use Credits for Unreal Speech",
     expires_at=None,
 )
 open_router_credentials = APIKeyCredentials(
@@ -216,6 +216,14 @@ webshare_proxy_credentials = UserPasswordCredentials(
     title="Use Credits for Webshare Proxy",
 )
 
+openweathermap_credentials = APIKeyCredentials(
+    id="8b3d4e5f-6a7b-8c9d-0e1f-2a3b4c5d6e7f",
+    provider="openweathermap",
+    api_key=SecretStr(settings.secrets.openweathermap_api_key),
+    title="Use Credits for OpenWeatherMap",
+    expires_at=None,
+)
+
 DEFAULT_CREDENTIALS = [
     ollama_credentials,
     revid_credentials,
@@ -243,8 +251,24 @@ DEFAULT_CREDENTIALS = [
     llama_api_credentials,
     v0_credentials,
     webshare_proxy_credentials,
+    openweathermap_credentials,
 ]
 
+SYSTEM_CREDENTIAL_IDS = {cred.id for cred in DEFAULT_CREDENTIALS}
+
+# Set of providers that have system credentials available
+SYSTEM_PROVIDERS = {cred.provider for cred in DEFAULT_CREDENTIALS}
+
+
+def is_system_credential(credential_id: str) -> bool:
+    """Check if a credential ID belongs to a system-managed credential."""
+    return credential_id in SYSTEM_CREDENTIAL_IDS
+
+
+def is_system_provider(provider: str) -> bool:
+    """Check if a provider has system-managed credentials available."""
+    return provider in SYSTEM_PROVIDERS
+
 
 class IntegrationCredentialsStore:
     def __init__(self):
@@ -331,11 +355,17 @@ class IntegrationCredentialsStore:
             all_credentials.append(zerobounce_credentials)
         if settings.secrets.google_maps_api_key:
             all_credentials.append(google_maps_credentials)
+        if settings.secrets.llama_api_key:
+            all_credentials.append(llama_api_credentials)
+        if settings.secrets.v0_api_key:
+            all_credentials.append(v0_credentials)
         if (
             settings.secrets.webshare_proxy_username
             and settings.secrets.webshare_proxy_password
         ):
             all_credentials.append(webshare_proxy_credentials)
+        if settings.secrets.openweathermap_api_key:
+            all_credentials.append(openweathermap_credentials)
         return all_credentials
 
     async def get_creds_by_id(
diff --git a/autogpt_platform/backend/backend/integrations/oauth/__init__.py b/autogpt_platform/backend/backend/integrations/oauth/__init__.py
index 137b9eadfd..1ea7a23ee7 100644
--- a/autogpt_platform/backend/backend/integrations/oauth/__init__.py
+++ b/autogpt_platform/backend/backend/integrations/oauth/__init__.py
@@ -8,6 +8,7 @@ from .discord import DiscordOAuthHandler
 from .github import GitHubOAuthHandler
 from .google import GoogleOAuthHandler
 from .notion import NotionOAuthHandler
+from .reddit import RedditOAuthHandler
 from .twitter import TwitterOAuthHandler
 
 if TYPE_CHECKING:
@@ -20,6 +21,7 @@ _ORIGINAL_HANDLERS = [
     GitHubOAuthHandler,
     GoogleOAuthHandler,
     NotionOAuthHandler,
+    RedditOAuthHandler,
     TwitterOAuthHandler,
     TodoistOAuthHandler,
 ]
diff --git a/autogpt_platform/backend/backend/integrations/oauth/reddit.py b/autogpt_platform/backend/backend/integrations/oauth/reddit.py
new file mode 100644
index 0000000000..a69e1e62c7
--- /dev/null
+++ b/autogpt_platform/backend/backend/integrations/oauth/reddit.py
@@ -0,0 +1,208 @@
+import time
+import urllib.parse
+from typing import ClassVar, Optional
+
+from pydantic import SecretStr
+
+from backend.data.model import OAuth2Credentials
+from backend.integrations.oauth.base import BaseOAuthHandler
+from backend.integrations.providers import ProviderName
+from backend.util.request import Requests
+from backend.util.settings import Settings
+
+settings = Settings()
+
+
+class RedditOAuthHandler(BaseOAuthHandler):
+    """
+    Reddit OAuth 2.0 handler.
+
+    Based on the documentation at:
+    - https://github.com/reddit-archive/reddit/wiki/OAuth2
+
+    Notes:
+    - Reddit requires `duration=permanent` to get refresh tokens
+    - Access tokens expire after 1 hour (3600 seconds)
+    - Reddit requires HTTP Basic Auth for token requests
+    - Reddit requires a unique User-Agent header
+    """
+
+    PROVIDER_NAME = ProviderName.REDDIT
+    DEFAULT_SCOPES: ClassVar[list[str]] = [
+        "identity",  # Get username, verify auth
+        "read",  # Access posts and comments
+        "submit",  # Submit new posts and comments
+        "edit",  # Edit own posts and comments
+        "history",  # Access user's post history
+        "privatemessages",  # Access inbox and send private messages
+        "flair",  # Access and set flair on posts/subreddits
+    ]
+
+    AUTHORIZE_URL = "https://www.reddit.com/api/v1/authorize"
+    TOKEN_URL = "https://www.reddit.com/api/v1/access_token"
+    USERNAME_URL = "https://oauth.reddit.com/api/v1/me"
+    REVOKE_URL = "https://www.reddit.com/api/v1/revoke_token"
+
+    def __init__(self, client_id: str, client_secret: str, redirect_uri: str):
+        self.client_id = client_id
+        self.client_secret = client_secret
+        self.redirect_uri = redirect_uri
+
+    def get_login_url(
+        self, scopes: list[str], state: str, code_challenge: Optional[str]
+    ) -> str:
+        """Generate Reddit OAuth 2.0 authorization URL"""
+        scopes = self.handle_default_scopes(scopes)
+
+        params = {
+            "response_type": "code",
+            "client_id": self.client_id,
+            "redirect_uri": self.redirect_uri,
+            "scope": " ".join(scopes),
+            "state": state,
+            "duration": "permanent",  # Required for refresh tokens
+        }
+
+        return f"{self.AUTHORIZE_URL}?{urllib.parse.urlencode(params)}"
+
+    async def exchange_code_for_tokens(
+        self, code: str, scopes: list[str], code_verifier: Optional[str]
+    ) -> OAuth2Credentials:
+        """Exchange authorization code for access tokens"""
+        scopes = self.handle_default_scopes(scopes)
+
+        headers = {
+            "Content-Type": "application/x-www-form-urlencoded",
+            "User-Agent": settings.config.reddit_user_agent,
+        }
+
+        data = {
+            "grant_type": "authorization_code",
+            "code": code,
+            "redirect_uri": self.redirect_uri,
+        }
+
+        # Reddit requires HTTP Basic Auth for token requests
+        auth = (self.client_id, self.client_secret)
+
+        response = await Requests().post(
+            self.TOKEN_URL, headers=headers, data=data, auth=auth
+        )
+
+        if not response.ok:
+            error_text = response.text()
+            raise ValueError(
+                f"Reddit token exchange failed: {response.status} - {error_text}"
+            )
+
+        tokens = response.json()
+
+        if "error" in tokens:
+            raise ValueError(f"Reddit OAuth error: {tokens.get('error')}")
+
+        username = await self._get_username(tokens["access_token"])
+
+        return OAuth2Credentials(
+            provider=self.PROVIDER_NAME,
+            title=None,
+            username=username,
+            access_token=tokens["access_token"],
+            refresh_token=tokens.get("refresh_token"),
+            access_token_expires_at=int(time.time()) + tokens.get("expires_in", 3600),
+            refresh_token_expires_at=None,  # Reddit refresh tokens don't expire
+            scopes=scopes,
+        )
+
+    async def _get_username(self, access_token: str) -> str:
+        """Get the username from the access token"""
+        headers = {
+            "Authorization": f"Bearer {access_token}",
+            "User-Agent": settings.config.reddit_user_agent,
+        }
+
+        response = await Requests().get(self.USERNAME_URL, headers=headers)
+
+        if not response.ok:
+            raise ValueError(f"Failed to get Reddit username: {response.status}")
+
+        data = response.json()
+        return data.get("name", "unknown")
+
+    async def _refresh_tokens(
+        self, credentials: OAuth2Credentials
+    ) -> OAuth2Credentials:
+        """Refresh access tokens using refresh token"""
+        if not credentials.refresh_token:
+            raise ValueError("No refresh token available")
+
+        headers = {
+            "Content-Type": "application/x-www-form-urlencoded",
+            "User-Agent": settings.config.reddit_user_agent,
+        }
+
+        data = {
+            "grant_type": "refresh_token",
+            "refresh_token": credentials.refresh_token.get_secret_value(),
+        }
+
+        auth = (self.client_id, self.client_secret)
+
+        response = await Requests().post(
+            self.TOKEN_URL, headers=headers, data=data, auth=auth
+        )
+
+        if not response.ok:
+            error_text = response.text()
+            raise ValueError(
+                f"Reddit token refresh failed: {response.status} - {error_text}"
+            )
+
+        tokens = response.json()
+
+        if "error" in tokens:
+            raise ValueError(f"Reddit OAuth error: {tokens.get('error')}")
+
+        username = await self._get_username(tokens["access_token"])
+
+        # Reddit may or may not return a new refresh token
+        new_refresh_token = tokens.get("refresh_token")
+        if new_refresh_token:
+            refresh_token: SecretStr | None = SecretStr(new_refresh_token)
+        elif credentials.refresh_token:
+            # Keep the existing refresh token
+            refresh_token = credentials.refresh_token
+        else:
+            refresh_token = None
+
+        return OAuth2Credentials(
+            id=credentials.id,
+            provider=self.PROVIDER_NAME,
+            title=credentials.title,
+            username=username,
+            access_token=tokens["access_token"],
+            refresh_token=refresh_token,
+            access_token_expires_at=int(time.time()) + tokens.get("expires_in", 3600),
+            refresh_token_expires_at=None,
+            scopes=credentials.scopes,
+        )
+
+    async def revoke_tokens(self, credentials: OAuth2Credentials) -> bool:
+        """Revoke the access token"""
+        headers = {
+            "Content-Type": "application/x-www-form-urlencoded",
+            "User-Agent": settings.config.reddit_user_agent,
+        }
+
+        data = {
+            "token": credentials.access_token.get_secret_value(),
+            "token_type_hint": "access_token",
+        }
+
+        auth = (self.client_id, self.client_secret)
+
+        response = await Requests().post(
+            self.REVOKE_URL, headers=headers, data=data, auth=auth
+        )
+
+        # Reddit returns 204 No Content on successful revocation
+        return response.ok
diff --git a/autogpt_platform/backend/backend/monitoring/late_execution_monitor.py b/autogpt_platform/backend/backend/monitoring/late_execution_monitor.py
index 1e0c99cac3..fd3d31cb47 100644
--- a/autogpt_platform/backend/backend/monitoring/late_execution_monitor.py
+++ b/autogpt_platform/backend/backend/monitoring/late_execution_monitor.py
@@ -60,8 +60,10 @@ class LateExecutionMonitor:
         if not all_late_executions:
             return "No late executions detected."
 
-        # Sort by created time (oldest first)
-        all_late_executions.sort(key=lambda x: x.started_at)
+        # Sort by started time (oldest first), with None values (unstarted) first
+        all_late_executions.sort(
+            key=lambda x: x.started_at or datetime.min.replace(tzinfo=timezone.utc)
+        )
 
         num_total_late = len(all_late_executions)
         num_queued = len(queued_late_executions)
@@ -74,7 +76,7 @@ class LateExecutionMonitor:
         was_truncated = num_total_late > tuncate_size
 
         late_execution_details = [
-            f"* `Execution ID: {exec.id}, Graph ID: {exec.graph_id}v{exec.graph_version}, User ID: {exec.user_id}, Status: {exec.status}, Created At: {exec.started_at.isoformat()}`"
+            f"* `Execution ID: {exec.id}, Graph ID: {exec.graph_id}v{exec.graph_version}, User ID: {exec.user_id}, Status: {exec.status}, Started At: {exec.started_at.isoformat() if exec.started_at else 'Not started'}`"
             for exec in truncated_executions
         ]
 
diff --git a/autogpt_platform/backend/backend/util/cache.py b/autogpt_platform/backend/backend/util/cache.py
index 757ba45b42..38c3667951 100644
--- a/autogpt_platform/backend/backend/util/cache.py
+++ b/autogpt_platform/backend/backend/util/cache.py
@@ -16,7 +16,7 @@ import pickle
 import threading
 import time
 from dataclasses import dataclass
-from functools import wraps
+from functools import cache, wraps
 from typing import Any, Callable, ParamSpec, Protocol, TypeVar, cast, runtime_checkable
 
 from redis import ConnectionPool, Redis
@@ -38,29 +38,34 @@ settings = Settings()
 #   maxmemory 2gb                   # Set memory limit (adjust based on your needs)
 #   save ""                         # Disable persistence if using Redis purely for caching
 
-# Create a dedicated Redis connection pool for caching (binary mode for pickle)
-_cache_pool: ConnectionPool | None = None
 
-
-@conn_retry("Redis", "Acquiring cache connection pool")
+@cache
 def _get_cache_pool() -> ConnectionPool:
-    """Get or create a connection pool for cache operations."""
-    global _cache_pool
-    if _cache_pool is None:
-        _cache_pool = ConnectionPool(
-            host=settings.config.redis_host,
-            port=settings.config.redis_port,
-            password=settings.config.redis_password or None,
-            decode_responses=False,  # Binary mode for pickle
-            max_connections=50,
-            socket_keepalive=True,
-            socket_connect_timeout=5,
-            retry_on_timeout=True,
-        )
-    return _cache_pool
+    """Get or create a connection pool for cache operations (lazy, thread-safe)."""
+    return ConnectionPool(
+        host=settings.config.redis_host,
+        port=settings.config.redis_port,
+        password=settings.config.redis_password or None,
+        decode_responses=False,  # Binary mode for pickle
+        max_connections=50,
+        socket_keepalive=True,
+        socket_connect_timeout=5,
+        retry_on_timeout=True,
+    )
 
 
-redis = Redis(connection_pool=_get_cache_pool())
+@cache
+@conn_retry("Redis", "Acquiring cache connection")
+def _get_redis() -> Redis:
+    """
+    Get the lazily-initialized Redis client for shared cache operations.
+    Uses @cache for thread-safe singleton behavior - connection is only
+    established when first accessed, allowing services that only use
+    in-memory caching to work without Redis configuration.
+    """
+    r = Redis(connection_pool=_get_cache_pool())
+    r.ping()  # Verify connection
+    return r
 
 
 @dataclass
@@ -179,9 +184,9 @@ def cached(
             try:
                 if refresh_ttl_on_get:
                     # Use GETEX to get value and refresh expiry atomically
-                    cached_bytes = redis.getex(redis_key, ex=ttl_seconds)
+                    cached_bytes = _get_redis().getex(redis_key, ex=ttl_seconds)
                 else:
-                    cached_bytes = redis.get(redis_key)
+                    cached_bytes = _get_redis().get(redis_key)
 
                 if cached_bytes and isinstance(cached_bytes, bytes):
                     return pickle.loads(cached_bytes)
@@ -195,7 +200,7 @@ def cached(
             """Set value in Redis with TTL."""
             try:
                 pickled_value = pickle.dumps(value, protocol=pickle.HIGHEST_PROTOCOL)
-                redis.setex(redis_key, ttl_seconds, pickled_value)
+                _get_redis().setex(redis_key, ttl_seconds, pickled_value)
             except Exception as e:
                 logger.error(
                     f"Redis error storing cache for {target_func.__name__}: {e}"
@@ -333,14 +338,18 @@ def cached(
                 if pattern:
                     # Clear entries matching pattern
                     keys = list(
-                        redis.scan_iter(f"cache:{target_func.__name__}:{pattern}")
+                        _get_redis().scan_iter(
+                            f"cache:{target_func.__name__}:{pattern}"
+                        )
                     )
                 else:
                     # Clear all cache keys
-                    keys = list(redis.scan_iter(f"cache:{target_func.__name__}:*"))
+                    keys = list(
+                        _get_redis().scan_iter(f"cache:{target_func.__name__}:*")
+                    )
 
                 if keys:
-                    pipeline = redis.pipeline()
+                    pipeline = _get_redis().pipeline()
                     for key in keys:
                         pipeline.delete(key)
                     pipeline.execute()
@@ -355,7 +364,9 @@ def cached(
 
         def cache_info() -> dict[str, int | None]:
             if shared_cache:
-                cache_keys = list(redis.scan_iter(f"cache:{target_func.__name__}:*"))
+                cache_keys = list(
+                    _get_redis().scan_iter(f"cache:{target_func.__name__}:*")
+                )
                 return {
                     "size": len(cache_keys),
                     "maxsize": None,  # Redis manages its own size
@@ -373,10 +384,8 @@ def cached(
             key = _make_hashable_key(args, kwargs)
             if shared_cache:
                 redis_key = _make_redis_key(key, target_func.__name__)
-                if redis.exists(redis_key):
-                    redis.delete(redis_key)
-                    return True
-                return False
+                deleted_count = cast(int, _get_redis().delete(redis_key))
+                return deleted_count > 0
             else:
                 if key in cache_storage:
                     del cache_storage[key]
diff --git a/autogpt_platform/backend/backend/util/clients.py b/autogpt_platform/backend/backend/util/clients.py
index bea8a5e2f9..570e9fa3de 100644
--- a/autogpt_platform/backend/backend/util/clients.py
+++ b/autogpt_platform/backend/backend/util/clients.py
@@ -10,6 +10,7 @@ from backend.util.settings import Settings
 settings = Settings()
 
 if TYPE_CHECKING:
+    from openai import AsyncOpenAI
     from supabase import AClient, Client
 
     from backend.data.execution import (
@@ -139,6 +140,24 @@ async def get_async_supabase() -> "AClient":
     )
 
 
+# ============ OpenAI Client ============ #
+
+
+@cached(ttl_seconds=3600)
+def get_openai_client() -> "AsyncOpenAI | None":
+    """
+    Get a process-cached async OpenAI client for embeddings.
+
+    Returns None if API key is not configured.
+    """
+    from openai import AsyncOpenAI
+
+    api_key = settings.secrets.openai_internal_api_key
+    if not api_key:
+        return None
+    return AsyncOpenAI(api_key=api_key)
+
+
 # ============ Notification Queue Helpers ============ #
 
 
diff --git a/autogpt_platform/backend/backend/util/settings.py b/autogpt_platform/backend/backend/util/settings.py
index 0f17b1215c..4448aeb77e 100644
--- a/autogpt_platform/backend/backend/util/settings.py
+++ b/autogpt_platform/backend/backend/util/settings.py
@@ -264,7 +264,7 @@ class Config(UpdateTrackingModel["Config"], BaseSettings):
     )
 
     reddit_user_agent: str = Field(
-        default="AutoGPT:1.0 (by /u/autogpt)",
+        default="web:AutoGPT:v0.6.0 (by /u/autogpt)",
         description="The user agent for the Reddit API",
     )
 
@@ -658,6 +658,14 @@ class Secrets(UpdateTrackingModel["Secrets"], BaseSettings):
 
     ayrshare_api_key: str = Field(default="", description="Ayrshare API Key")
     ayrshare_jwt_key: str = Field(default="", description="Ayrshare private Key")
+
+    # Langfuse prompt management
+    langfuse_public_key: str = Field(default="", description="Langfuse public key")
+    langfuse_secret_key: str = Field(default="", description="Langfuse secret key")
+    langfuse_host: str = Field(
+        default="https://cloud.langfuse.com", description="Langfuse host URL"
+    )
+
     # Add more secret fields as needed
     model_config = SettingsConfigDict(
         env_file=".env",
diff --git a/autogpt_platform/backend/gen_prisma_types_stub.py b/autogpt_platform/backend/gen_prisma_types_stub.py
new file mode 100644
index 0000000000..3f6073b2ff
--- /dev/null
+++ b/autogpt_platform/backend/gen_prisma_types_stub.py
@@ -0,0 +1,227 @@
+#!/usr/bin/env python3
+"""
+Generate a lightweight stub for prisma/types.py that collapses all exported
+symbols to Any. This prevents Pyright from spending time/budget on Prisma's
+query DSL types while keeping runtime behavior unchanged.
+
+Usage:
+    poetry run gen-prisma-stub
+
+This script automatically finds the prisma package location and generates
+the types.pyi stub file in the same directory as types.py.
+"""
+
+from __future__ import annotations
+
+import ast
+import importlib.util
+import sys
+from pathlib import Path
+from typing import Iterable, Set
+
+
+def _iter_assigned_names(target: ast.expr) -> Iterable[str]:
+    """Extract names from assignment targets (handles tuple unpacking)."""
+    if isinstance(target, ast.Name):
+        yield target.id
+    elif isinstance(target, (ast.Tuple, ast.List)):
+        for elt in target.elts:
+            yield from _iter_assigned_names(elt)
+
+
+def _is_private(name: str) -> bool:
+    """Check if a name is private (starts with _ but not __)."""
+    return name.startswith("_") and not name.startswith("__")
+
+
+def _is_safe_type_alias(node: ast.Assign) -> bool:
+    """Check if an assignment is a safe type alias that shouldn't be stubbed.
+
+    Safe types are:
+    - Literal types (don't cause type budget issues)
+    - Simple type references (SortMode, SortOrder, etc.)
+    - TypeVar definitions
+    """
+    if not node.value:
+        return False
+
+    # Check if it's a Subscript (like Literal[...], Union[...], TypeVar[...])
+    if isinstance(node.value, ast.Subscript):
+        # Get the base type name
+        if isinstance(node.value.value, ast.Name):
+            base_name = node.value.value.id
+            # Literal types are safe
+            if base_name == "Literal":
+                return True
+            # TypeVar is safe
+            if base_name == "TypeVar":
+                return True
+        elif isinstance(node.value.value, ast.Attribute):
+            # Handle typing_extensions.Literal etc.
+            if node.value.value.attr == "Literal":
+                return True
+
+    # Check if it's a simple Name reference (like SortMode = _types.SortMode)
+    if isinstance(node.value, ast.Attribute):
+        return True
+
+    # Check if it's a Call (like TypeVar(...))
+    if isinstance(node.value, ast.Call):
+        if isinstance(node.value.func, ast.Name):
+            if node.value.func.id == "TypeVar":
+                return True
+
+    return False
+
+
+def collect_top_level_symbols(
+    tree: ast.Module, source_lines: list[str]
+) -> tuple[Set[str], Set[str], list[str], Set[str]]:
+    """Collect all top-level symbols from an AST module.
+
+    Returns:
+        Tuple of (class_names, function_names, safe_variable_sources, unsafe_variable_names)
+        safe_variable_sources contains the actual source code lines for safe variables
+    """
+    classes: Set[str] = set()
+    functions: Set[str] = set()
+    safe_variable_sources: list[str] = []
+    unsafe_variables: Set[str] = set()
+
+    for node in tree.body:
+        if isinstance(node, ast.ClassDef):
+            if not _is_private(node.name):
+                classes.add(node.name)
+        elif isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef)):
+            if not _is_private(node.name):
+                functions.add(node.name)
+        elif isinstance(node, ast.Assign):
+            is_safe = _is_safe_type_alias(node)
+            names = []
+            for t in node.targets:
+                for n in _iter_assigned_names(t):
+                    if not _is_private(n):
+                        names.append(n)
+            if names:
+                if is_safe:
+                    # Extract the source code for this assignment
+                    start_line = node.lineno - 1  # 0-indexed
+                    end_line = node.end_lineno if node.end_lineno else node.lineno
+                    source = "\n".join(source_lines[start_line:end_line])
+                    safe_variable_sources.append(source)
+                else:
+                    unsafe_variables.update(names)
+        elif isinstance(node, ast.AnnAssign) and node.target:
+            # Annotated assignments are always stubbed
+            for n in _iter_assigned_names(node.target):
+                if not _is_private(n):
+                    unsafe_variables.add(n)
+
+    return classes, functions, safe_variable_sources, unsafe_variables
+
+
+def find_prisma_types_path() -> Path:
+    """Find the prisma types.py file in the installed package."""
+    spec = importlib.util.find_spec("prisma")
+    if spec is None or spec.origin is None:
+        raise RuntimeError("Could not find prisma package. Is it installed?")
+
+    prisma_dir = Path(spec.origin).parent
+    types_path = prisma_dir / "types.py"
+
+    if not types_path.exists():
+        raise RuntimeError(f"prisma/types.py not found at {types_path}")
+
+    return types_path
+
+
+def generate_stub(src_path: Path, stub_path: Path) -> int:
+    """Generate the .pyi stub file from the source types.py."""
+    code = src_path.read_text(encoding="utf-8", errors="ignore")
+    source_lines = code.splitlines()
+    tree = ast.parse(code, filename=str(src_path))
+    classes, functions, safe_variable_sources, unsafe_variables = (
+        collect_top_level_symbols(tree, source_lines)
+    )
+
+    header = """\
+# -*- coding: utf-8 -*-
+# Auto-generated stub file - DO NOT EDIT
+# Generated by gen_prisma_types_stub.py
+#
+# This stub intentionally collapses complex Prisma query DSL types to Any.
+# Prisma's generated types can explode Pyright's type inference budgets
+# on large schemas. We collapse them to Any so the rest of the codebase
+# can remain strongly typed while keeping runtime behavior unchanged.
+#
+# Safe types (Literal, TypeVar, simple references) are preserved from the
+# original types.py to maintain proper type checking where possible.
+
+from __future__ import annotations
+from typing import Any
+from typing_extensions import Literal
+
+# Re-export commonly used typing constructs that may be imported from this module
+from typing import TYPE_CHECKING, TypeVar, Generic, Union, Optional, List, Dict
+
+# Base type alias for stubbed Prisma types - allows any dict structure
+_PrismaDict = dict[str, Any]
+
+"""
+
+    lines = [header]
+
+    # Include safe variable definitions (Literal types, TypeVars, etc.)
+    lines.append("# Safe type definitions preserved from original types.py")
+    for source in safe_variable_sources:
+        lines.append(source)
+    lines.append("")
+
+    # Stub all classes and unsafe variables uniformly as dict[str, Any] aliases
+    # This allows:
+    # 1. Use in type annotations: x: SomeType
+    # 2. Constructor calls: SomeType(...)
+    # 3. Dict literal assignments: x: SomeType = {...}
+    lines.append(
+        "# Stubbed types (collapsed to dict[str, Any] to prevent type budget exhaustion)"
+    )
+    all_stubbed = sorted(classes | unsafe_variables)
+    for name in all_stubbed:
+        lines.append(f"{name} = _PrismaDict")
+
+    lines.append("")
+
+    # Stub functions
+    for name in sorted(functions):
+        lines.append(f"def {name}(*args: Any, **kwargs: Any) -> Any: ...")
+
+    lines.append("")
+
+    stub_path.write_text("\n".join(lines), encoding="utf-8")
+    return (
+        len(classes)
+        + len(functions)
+        + len(safe_variable_sources)
+        + len(unsafe_variables)
+    )
+
+
+def main() -> None:
+    """Main entry point."""
+    try:
+        types_path = find_prisma_types_path()
+        stub_path = types_path.with_suffix(".pyi")
+
+        print(f"Found prisma types.py at: {types_path}")
+        print(f"Generating stub at: {stub_path}")
+
+        num_symbols = generate_stub(types_path, stub_path)
+        print(f"Generated {stub_path.name} with {num_symbols} Any-typed symbols")
+
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/autogpt_platform/backend/linter.py b/autogpt_platform/backend/linter.py
index a86e6761f7..599aae4580 100644
--- a/autogpt_platform/backend/linter.py
+++ b/autogpt_platform/backend/linter.py
@@ -25,6 +25,9 @@ def run(*command: str) -> None:
 
 
 def lint():
+    # Generate Prisma types stub before running pyright to prevent type budget exhaustion
+    run("gen-prisma-stub")
+
     lint_step_args: list[list[str]] = [
         ["ruff", "check", *TARGET_DIRS, "--exit-zero"],
         ["ruff", "format", "--diff", "--check", LIBS_DIR],
@@ -49,4 +52,6 @@ def format():
     run("ruff", "format", LIBS_DIR)
     run("isort", "--profile", "black", BACKEND_DIR)
     run("black", BACKEND_DIR)
+    # Generate Prisma types stub before running pyright to prevent type budget exhaustion
+    run("gen-prisma-stub")
     run("pyright", *TARGET_DIRS)
diff --git a/autogpt_platform/backend/migrations/20260109181714_add_docs_embedding/migration.sql b/autogpt_platform/backend/migrations/20260109181714_add_docs_embedding/migration.sql
new file mode 100644
index 0000000000..0897e1865a
--- /dev/null
+++ b/autogpt_platform/backend/migrations/20260109181714_add_docs_embedding/migration.sql
@@ -0,0 +1,48 @@
+-- CreateExtension
+-- Supabase: pgvector must be enabled via Dashboard → Database → Extensions first
+-- Create in public schema so vector type is available across all schemas
+DO $$
+BEGIN
+    CREATE EXTENSION IF NOT EXISTS "vector" WITH SCHEMA "public";
+EXCEPTION WHEN OTHERS THEN
+    RAISE NOTICE 'vector extension not available or already exists, skipping';
+END $$;
+
+-- CreateEnum
+CREATE TYPE "ContentType" AS ENUM ('STORE_AGENT', 'BLOCK', 'INTEGRATION', 'DOCUMENTATION', 'LIBRARY_AGENT');
+
+-- CreateTable
+CREATE TABLE "UnifiedContentEmbedding" (
+    "id" TEXT NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+    "contentType" "ContentType" NOT NULL,
+    "contentId" TEXT NOT NULL,
+    "userId" TEXT,
+    "embedding" public.vector(1536) NOT NULL,
+    "searchableText" TEXT NOT NULL,
+    "metadata" JSONB NOT NULL DEFAULT '{}',
+
+    CONSTRAINT "UnifiedContentEmbedding_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "UnifiedContentEmbedding_contentType_idx" ON "UnifiedContentEmbedding"("contentType");
+
+-- CreateIndex
+CREATE INDEX "UnifiedContentEmbedding_userId_idx" ON "UnifiedContentEmbedding"("userId");
+
+-- CreateIndex
+CREATE INDEX "UnifiedContentEmbedding_contentType_userId_idx" ON "UnifiedContentEmbedding"("contentType", "userId");
+
+-- CreateIndex
+-- NULLS NOT DISTINCT ensures only one public (NULL userId) embedding per contentType+contentId
+-- Requires PostgreSQL 15+. Supabase uses PostgreSQL 15+.
+CREATE UNIQUE INDEX "UnifiedContentEmbedding_contentType_contentId_userId_key" ON "UnifiedContentEmbedding"("contentType", "contentId", "userId") NULLS NOT DISTINCT;
+
+-- CreateIndex
+-- HNSW index for fast vector similarity search on embeddings
+-- Uses cosine distance operator (<=>), which matches the query in hybrid_search.py
+-- Note: Drop first in case Prisma created a btree index (Prisma doesn't support HNSW)
+DROP INDEX IF EXISTS "UnifiedContentEmbedding_embedding_idx";
+CREATE INDEX "UnifiedContentEmbedding_embedding_idx" ON "UnifiedContentEmbedding" USING hnsw ("embedding" public.vector_cosine_ops);
diff --git a/autogpt_platform/backend/migrations/20260112173500_add_supabase_extensions_to_platform_schema/migration.sql b/autogpt_platform/backend/migrations/20260112173500_add_supabase_extensions_to_platform_schema/migration.sql
new file mode 100644
index 0000000000..ca91bc5cab
--- /dev/null
+++ b/autogpt_platform/backend/migrations/20260112173500_add_supabase_extensions_to_platform_schema/migration.sql
@@ -0,0 +1,71 @@
+-- Acknowledge Supabase-managed extensions to prevent drift warnings
+-- These extensions are pre-installed by Supabase in specific schemas
+-- This migration ensures they exist where available (Supabase) or skips gracefully (CI)
+
+-- Create schemas (safe in both CI and Supabase)
+CREATE SCHEMA IF NOT EXISTS "extensions";
+
+-- Extensions that exist in both CI and Supabase
+DO $$
+BEGIN
+    CREATE EXTENSION IF NOT EXISTS "pgcrypto" WITH SCHEMA "extensions";
+EXCEPTION WHEN OTHERS THEN
+    RAISE NOTICE 'pgcrypto extension not available, skipping';
+END $$;
+
+DO $$
+BEGIN
+    CREATE EXTENSION IF NOT EXISTS "uuid-ossp" WITH SCHEMA "extensions";
+EXCEPTION WHEN OTHERS THEN
+    RAISE NOTICE 'uuid-ossp extension not available, skipping';
+END $$;
+
+-- Supabase-specific extensions (skip gracefully in CI)
+DO $$
+BEGIN
+    CREATE EXTENSION IF NOT EXISTS "pg_stat_statements" WITH SCHEMA "extensions";
+EXCEPTION WHEN OTHERS THEN
+    RAISE NOTICE 'pg_stat_statements extension not available, skipping';
+END $$;
+
+DO $$
+BEGIN
+    CREATE EXTENSION IF NOT EXISTS "pg_net" WITH SCHEMA "extensions";
+EXCEPTION WHEN OTHERS THEN
+    RAISE NOTICE 'pg_net extension not available, skipping';
+END $$;
+
+DO $$
+BEGIN
+    CREATE EXTENSION IF NOT EXISTS "pgjwt" WITH SCHEMA "extensions";
+EXCEPTION WHEN OTHERS THEN
+    RAISE NOTICE 'pgjwt extension not available, skipping';
+END $$;
+
+DO $$
+BEGIN
+    CREATE SCHEMA IF NOT EXISTS "graphql";
+    CREATE EXTENSION IF NOT EXISTS "pg_graphql" WITH SCHEMA "graphql";
+EXCEPTION WHEN OTHERS THEN
+    RAISE NOTICE 'pg_graphql extension not available, skipping';
+END $$;
+
+DO $$
+BEGIN
+    CREATE SCHEMA IF NOT EXISTS "pgsodium";
+    CREATE EXTENSION IF NOT EXISTS "pgsodium" WITH SCHEMA "pgsodium";
+EXCEPTION WHEN OTHERS THEN
+    RAISE NOTICE 'pgsodium extension not available, skipping';
+END $$;
+
+DO $$
+BEGIN
+    CREATE SCHEMA IF NOT EXISTS "vault";
+    CREATE EXTENSION IF NOT EXISTS "supabase_vault" WITH SCHEMA "vault";
+EXCEPTION WHEN OTHERS THEN
+    RAISE NOTICE 'supabase_vault extension not available, skipping';
+END $$;
+
+
+-- Return to platform
+CREATE SCHEMA IF NOT EXISTS "platform";
\ No newline at end of file
diff --git a/autogpt_platform/backend/migrations/20260113170839_add_ended_at_to_agent_graph_execution/migration.sql b/autogpt_platform/backend/migrations/20260113170839_add_ended_at_to_agent_graph_execution/migration.sql
new file mode 100644
index 0000000000..95fa3a573a
--- /dev/null
+++ b/autogpt_platform/backend/migrations/20260113170839_add_ended_at_to_agent_graph_execution/migration.sql
@@ -0,0 +1,8 @@
+-- AlterTable
+ALTER TABLE "AgentGraphExecution" ADD COLUMN "endedAt" TIMESTAMP(3);
+
+-- Set endedAt to updatedAt for existing records with terminal status only
+UPDATE "AgentGraphExecution"
+SET "endedAt" = "updatedAt"
+WHERE "endedAt" IS NULL
+  AND "executionStatus" IN ('COMPLETED', 'FAILED', 'TERMINATED');
diff --git a/autogpt_platform/backend/migrations/20260115081736_add_chat_tables/migration.sql b/autogpt_platform/backend/migrations/20260115081736_add_chat_tables/migration.sql
new file mode 100644
index 0000000000..2c964858e6
--- /dev/null
+++ b/autogpt_platform/backend/migrations/20260115081736_add_chat_tables/migration.sql
@@ -0,0 +1,64 @@
+-- CreateTable
+CREATE TABLE "CoPilotUnderstanding" (
+    "id" TEXT NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "userId" TEXT NOT NULL,
+    "data" JSONB,
+
+    CONSTRAINT "CoPilotUnderstanding_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ChatSession" (
+    "id" TEXT NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "userId" TEXT NOT NULL,
+    "title" TEXT,
+    "credentials" JSONB NOT NULL DEFAULT '{}',
+    "successfulAgentRuns" JSONB NOT NULL DEFAULT '{}',
+    "successfulAgentSchedules" JSONB NOT NULL DEFAULT '{}',
+    "totalPromptTokens" INTEGER NOT NULL DEFAULT 0,
+    "totalCompletionTokens" INTEGER NOT NULL DEFAULT 0,
+
+    CONSTRAINT "ChatSession_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ChatMessage" (
+    "id" TEXT NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "sessionId" TEXT NOT NULL,
+    "role" TEXT NOT NULL,
+    "content" TEXT,
+    "name" TEXT,
+    "toolCallId" TEXT,
+    "refusal" TEXT,
+    "toolCalls" JSONB,
+    "functionCall" JSONB,
+    "sequence" INTEGER NOT NULL,
+
+    CONSTRAINT "ChatMessage_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "CoPilotUnderstanding_userId_key" ON "CoPilotUnderstanding"("userId");
+
+-- CreateIndex
+CREATE INDEX "CoPilotUnderstanding_userId_idx" ON "CoPilotUnderstanding"("userId");
+
+-- CreateIndex
+CREATE INDEX "ChatSession_userId_updatedAt_idx" ON "ChatSession"("userId", "updatedAt");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ChatMessage_sessionId_sequence_key" ON "ChatMessage"("sessionId", "sequence");
+
+-- AddForeignKey
+ALTER TABLE "CoPilotUnderstanding" ADD CONSTRAINT "CoPilotUnderstanding_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ChatSession" ADD CONSTRAINT "ChatSession_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ChatMessage" ADD CONSTRAINT "ChatMessage_sessionId_fkey" FOREIGN KEY ("sessionId") REFERENCES "ChatSession"("id") ON DELETE CASCADE ON UPDATE CASCADE;
diff --git a/autogpt_platform/backend/migrations/20260115200000_add_unified_search_tsvector/migration.sql b/autogpt_platform/backend/migrations/20260115200000_add_unified_search_tsvector/migration.sql
new file mode 100644
index 0000000000..be3062cbfb
--- /dev/null
+++ b/autogpt_platform/backend/migrations/20260115200000_add_unified_search_tsvector/migration.sql
@@ -0,0 +1,35 @@
+-- Add tsvector search column to UnifiedContentEmbedding for unified full-text search
+-- This enables hybrid search (semantic + lexical) across all content types
+
+-- Add search column (IF NOT EXISTS for idempotency)
+ALTER TABLE "UnifiedContentEmbedding" ADD COLUMN IF NOT EXISTS "search" tsvector DEFAULT ''::tsvector;
+
+-- Create GIN index for fast full-text search
+-- No @@index in schema.prisma - Prisma may generate DROP INDEX on migrate dev
+-- If that happens, just let it drop and this migration will recreate it, or manually re-run:
+--   CREATE INDEX IF NOT EXISTS "UnifiedContentEmbedding_search_idx" ON "UnifiedContentEmbedding" USING GIN ("search");
+DROP INDEX IF EXISTS "UnifiedContentEmbedding_search_idx";
+CREATE INDEX "UnifiedContentEmbedding_search_idx" ON "UnifiedContentEmbedding" USING GIN ("search");
+
+-- Drop existing trigger/function if exists
+DROP TRIGGER IF EXISTS "update_unified_tsvector" ON "UnifiedContentEmbedding";
+DROP FUNCTION IF EXISTS update_unified_tsvector_column();
+
+-- Create function to auto-update tsvector from searchableText
+CREATE OR REPLACE FUNCTION update_unified_tsvector_column() RETURNS TRIGGER AS $$
+BEGIN
+  NEW.search := to_tsvector('english', COALESCE(NEW."searchableText", ''));
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql SECURITY DEFINER SET search_path = platform, pg_temp;
+
+-- Create trigger to auto-update search column on insert/update
+CREATE TRIGGER "update_unified_tsvector"
+BEFORE INSERT OR UPDATE ON "UnifiedContentEmbedding"
+FOR EACH ROW
+EXECUTE FUNCTION update_unified_tsvector_column();
+
+-- Backfill existing rows
+UPDATE "UnifiedContentEmbedding"
+SET search = to_tsvector('english', COALESCE("searchableText", ''))
+WHERE search IS NULL OR search = ''::tsvector;
diff --git a/autogpt_platform/backend/migrations/20260115210000_remove_storelistingversion_search/migration.sql b/autogpt_platform/backend/migrations/20260115210000_remove_storelistingversion_search/migration.sql
new file mode 100644
index 0000000000..4550340330
--- /dev/null
+++ b/autogpt_platform/backend/migrations/20260115210000_remove_storelistingversion_search/migration.sql
@@ -0,0 +1,90 @@
+-- Remove the old search column from StoreListingVersion
+-- This column has been replaced by UnifiedContentEmbedding.search
+-- which provides unified hybrid search across all content types
+
+-- First drop the dependent view
+DROP VIEW IF EXISTS "StoreAgent";
+
+-- Drop the trigger and function for old search column
+-- The original trigger was created in 20251016093049_add_full_text_search
+DROP TRIGGER IF EXISTS "update_tsvector" ON "StoreListingVersion";
+DROP FUNCTION IF EXISTS update_tsvector_column();
+
+-- Drop the index
+DROP INDEX IF EXISTS "StoreListingVersion_search_idx";
+
+-- NOTE: Keeping search column for now to allow easy revert if needed
+-- Uncomment to fully remove once migration is verified in production:
+-- ALTER TABLE "StoreListingVersion" DROP COLUMN IF EXISTS "search";
+
+-- Recreate the StoreAgent view WITHOUT the search column
+-- (Search now handled by UnifiedContentEmbedding)
+CREATE OR REPLACE VIEW "StoreAgent" AS
+WITH latest_versions AS (
+    SELECT
+        "storeListingId",
+        MAX(version) AS max_version
+    FROM "StoreListingVersion"
+    WHERE "submissionStatus" = 'APPROVED'
+    GROUP BY "storeListingId"
+),
+agent_versions AS (
+    SELECT
+        "storeListingId",
+        array_agg(DISTINCT version::text ORDER BY version::text) AS versions
+    FROM "StoreListingVersion"
+    WHERE "submissionStatus" = 'APPROVED'
+    GROUP BY "storeListingId"
+),
+agent_graph_versions AS (
+    SELECT
+        "storeListingId",
+        array_agg(DISTINCT "agentGraphVersion"::text ORDER BY "agentGraphVersion"::text) AS graph_versions
+    FROM "StoreListingVersion"
+    WHERE "submissionStatus" = 'APPROVED'
+    GROUP BY "storeListingId"
+)
+SELECT
+    sl.id AS listing_id,
+    slv.id AS "storeListingVersionId",
+    slv."createdAt" AS updated_at,
+    sl.slug,
+    COALESCE(slv.name, '') AS agent_name,
+    slv."videoUrl" AS agent_video,
+    slv."agentOutputDemoUrl" AS agent_output_demo,
+    COALESCE(slv."imageUrls", ARRAY[]::text[]) AS agent_image,
+    slv."isFeatured" AS featured,
+    p.username AS creator_username,
+    p."avatarUrl" AS creator_avatar,
+    slv."subHeading" AS sub_heading,
+    slv.description,
+    slv.categories,
+    COALESCE(ar.run_count, 0::bigint) AS runs,
+    COALESCE(rs.avg_rating, 0.0)::double precision AS rating,
+    COALESCE(av.versions, ARRAY[slv.version::text]) AS versions,
+    COALESCE(agv.graph_versions, ARRAY[slv."agentGraphVersion"::text]) AS "agentGraphVersions",
+    slv."agentGraphId",
+    slv."isAvailable" AS is_available,
+    COALESCE(sl."useForOnboarding", false) AS "useForOnboarding"
+FROM "StoreListing" sl
+JOIN latest_versions lv
+    ON sl.id = lv."storeListingId"
+JOIN "StoreListingVersion" slv
+    ON slv."storeListingId" = lv."storeListingId"
+   AND slv.version = lv.max_version
+   AND slv."submissionStatus" = 'APPROVED'
+JOIN "AgentGraph" a
+    ON slv."agentGraphId" = a.id
+    AND slv."agentGraphVersion" = a.version
+LEFT JOIN "Profile" p
+    ON sl."owningUserId" = p."userId"
+LEFT JOIN "mv_review_stats" rs
+    ON sl.id = rs."storeListingId"
+LEFT JOIN "mv_agent_run_counts" ar
+    ON a.id = ar."agentGraphId"
+LEFT JOIN agent_versions av
+    ON sl.id = av."storeListingId"
+LEFT JOIN agent_graph_versions agv
+    ON sl.id = agv."storeListingId"
+WHERE sl."isDeleted" = false
+  AND sl."hasApprovedVersion" = true;
diff --git a/autogpt_platform/backend/poetry.lock b/autogpt_platform/backend/poetry.lock
index 9aa55a6c22..2aa55ce5b6 100644
--- a/autogpt_platform/backend/poetry.lock
+++ b/autogpt_platform/backend/poetry.lock
@@ -1906,16 +1906,32 @@ httpx = {version = ">=0.26,<0.29", extras = ["http2"]}
 pydantic = ">=1.10,<3"
 pyjwt = ">=2.10.1,<3.0.0"
 
+[[package]]
+name = "gravitas-md2gdocs"
+version = "0.1.0"
+description = "Convert Markdown to Google Docs API requests"
+optional = false
+python-versions = ">=3.10"
+groups = ["main"]
+files = [
+    {file = "gravitas_md2gdocs-0.1.0-py3-none-any.whl", hash = "sha256:0cb0627779fdd65c1604818af4142eea1b25d055060183363de1bae4d9e46508"},
+    {file = "gravitas_md2gdocs-0.1.0.tar.gz", hash = "sha256:bb3122fe9fa35c528f3f00b785d3f1398d350082d5d03f60f56c895bdcc68033"},
+]
+
+[package.extras]
+dev = ["google-auth-oauthlib (>=1.0.0)", "pytest (>=7.0.0)", "pytest-cov (>=4.0.0)", "python-dotenv (>=1.0.0)", "ruff (>=0.1.0)"]
+google = ["google-api-python-client (>=2.0.0)", "google-auth (>=2.0.0)"]
+
 [[package]]
 name = "gravitasml"
-version = "0.1.3"
+version = "0.1.4"
 description = ""
 optional = false
 python-versions = "<4.0,>=3.10"
 groups = ["main"]
 files = [
-    {file = "gravitasml-0.1.3-py3-none-any.whl", hash = "sha256:51ff98b4564b7a61f7796f18d5f2558b919d30b3722579296089645b7bc18b85"},
-    {file = "gravitasml-0.1.3.tar.gz", hash = "sha256:04d240b9fa35878252d57a36032130b6516487468847fcdced1022c032a20f57"},
+    {file = "gravitasml-0.1.4-py3-none-any.whl", hash = "sha256:671a18b11d3d8a0e270c6a80c72cd058458b18d5ef7560d00010e962ab1bca74"},
+    {file = "gravitasml-0.1.4.tar.gz", hash = "sha256:35d0d9fec7431817482d53d9c976e375557c3e041d1eb6928e809324a8c866e3"},
 ]
 
 [package.dependencies]
@@ -2761,6 +2777,30 @@ enabler = ["pytest-enabler (>=2.2)"]
 test = ["pyfakefs", "pytest (>=6,!=8.1.*)"]
 type = ["pygobject-stubs", "pytest-mypy", "shtab", "types-pywin32"]
 
+[[package]]
+name = "langfuse"
+version = "3.11.2"
+description = "A client library for accessing langfuse"
+optional = false
+python-versions = "<4.0,>=3.10"
+groups = ["main"]
+files = [
+    {file = "langfuse-3.11.2-py3-none-any.whl", hash = "sha256:84faea9f909694023cc7f0eb45696be190248c8790424f22af57ca4cd7a29f2d"},
+    {file = "langfuse-3.11.2.tar.gz", hash = "sha256:ab5f296a8056815b7288c7f25bc308a5e79f82a8634467b25daffdde99276e09"},
+]
+
+[package.dependencies]
+backoff = ">=1.10.0"
+httpx = ">=0.15.4,<1.0"
+openai = ">=0.27.8"
+opentelemetry-api = ">=1.33.1,<2.0.0"
+opentelemetry-exporter-otlp-proto-http = ">=1.33.1,<2.0.0"
+opentelemetry-sdk = ">=1.33.1,<2.0.0"
+packaging = ">=23.2,<26.0"
+pydantic = ">=1.10.7,<3.0"
+requests = ">=2,<3"
+wrapt = ">=1.14,<2.0"
+
 [[package]]
 name = "launchdarkly-eventsource"
 version = "1.3.0"
@@ -3452,6 +3492,90 @@ files = [
 importlib-metadata = ">=6.0,<8.8.0"
 typing-extensions = ">=4.5.0"
 
+[[package]]
+name = "opentelemetry-exporter-otlp-proto-common"
+version = "1.35.0"
+description = "OpenTelemetry Protobuf encoding"
+optional = false
+python-versions = ">=3.9"
+groups = ["main"]
+files = [
+    {file = "opentelemetry_exporter_otlp_proto_common-1.35.0-py3-none-any.whl", hash = "sha256:863465de697ae81279ede660f3918680b4480ef5f69dcdac04f30722ed7b74cc"},
+    {file = "opentelemetry_exporter_otlp_proto_common-1.35.0.tar.gz", hash = "sha256:6f6d8c39f629b9fa5c79ce19a2829dbd93034f8ac51243cdf40ed2196f00d7eb"},
+]
+
+[package.dependencies]
+opentelemetry-proto = "1.35.0"
+
+[[package]]
+name = "opentelemetry-exporter-otlp-proto-http"
+version = "1.35.0"
+description = "OpenTelemetry Collector Protobuf over HTTP Exporter"
+optional = false
+python-versions = ">=3.9"
+groups = ["main"]
+files = [
+    {file = "opentelemetry_exporter_otlp_proto_http-1.35.0-py3-none-any.whl", hash = "sha256:9a001e3df3c7f160fb31056a28ed7faa2de7df68877ae909516102ae36a54e1d"},
+    {file = "opentelemetry_exporter_otlp_proto_http-1.35.0.tar.gz", hash = "sha256:cf940147f91b450ef5f66e9980d40eb187582eed399fa851f4a7a45bb880de79"},
+]
+
+[package.dependencies]
+googleapis-common-protos = ">=1.52,<2.0"
+opentelemetry-api = ">=1.15,<2.0"
+opentelemetry-exporter-otlp-proto-common = "1.35.0"
+opentelemetry-proto = "1.35.0"
+opentelemetry-sdk = ">=1.35.0,<1.36.0"
+requests = ">=2.7,<3.0"
+typing-extensions = ">=4.5.0"
+
+[[package]]
+name = "opentelemetry-proto"
+version = "1.35.0"
+description = "OpenTelemetry Python Proto"
+optional = false
+python-versions = ">=3.9"
+groups = ["main"]
+files = [
+    {file = "opentelemetry_proto-1.35.0-py3-none-any.whl", hash = "sha256:98fffa803164499f562718384e703be8d7dfbe680192279a0429cb150a2f8809"},
+    {file = "opentelemetry_proto-1.35.0.tar.gz", hash = "sha256:532497341bd3e1c074def7c5b00172601b28bb83b48afc41a4b779f26eb4ee05"},
+]
+
+[package.dependencies]
+protobuf = ">=5.0,<7.0"
+
+[[package]]
+name = "opentelemetry-sdk"
+version = "1.35.0"
+description = "OpenTelemetry Python SDK"
+optional = false
+python-versions = ">=3.9"
+groups = ["main"]
+files = [
+    {file = "opentelemetry_sdk-1.35.0-py3-none-any.whl", hash = "sha256:223d9e5f5678518f4842311bb73966e0b6db5d1e0b74e35074c052cd2487f800"},
+    {file = "opentelemetry_sdk-1.35.0.tar.gz", hash = "sha256:2a400b415ab68aaa6f04e8a6a9f6552908fb3090ae2ff78d6ae0c597ac581954"},
+]
+
+[package.dependencies]
+opentelemetry-api = "1.35.0"
+opentelemetry-semantic-conventions = "0.56b0"
+typing-extensions = ">=4.5.0"
+
+[[package]]
+name = "opentelemetry-semantic-conventions"
+version = "0.56b0"
+description = "OpenTelemetry Semantic Conventions"
+optional = false
+python-versions = ">=3.9"
+groups = ["main"]
+files = [
+    {file = "opentelemetry_semantic_conventions-0.56b0-py3-none-any.whl", hash = "sha256:df44492868fd6b482511cc43a942e7194be64e94945f572db24df2e279a001a2"},
+    {file = "opentelemetry_semantic_conventions-0.56b0.tar.gz", hash = "sha256:c114c2eacc8ff6d3908cb328c811eaf64e6d68623840be9224dc829c4fd6c2ea"},
+]
+
+[package.dependencies]
+opentelemetry-api = "1.35.0"
+typing-extensions = ">=4.5.0"
+
 [[package]]
 name = "orjson"
 version = "3.11.3"
@@ -5215,6 +5339,24 @@ urllib3 = ">=1.26.14,<3"
 fastembed = ["fastembed (>=0.7,<0.8)"]
 fastembed-gpu = ["fastembed-gpu (>=0.7,<0.8)"]
 
+[[package]]
+name = "rank-bm25"
+version = "0.2.2"
+description = "Various BM25 algorithms for document ranking"
+optional = false
+python-versions = "*"
+groups = ["main"]
+files = [
+    {file = "rank_bm25-0.2.2-py3-none-any.whl", hash = "sha256:7bd4a95571adadfc271746fa146a4bcfd89c0cf731e49c3d1ad863290adbe8ae"},
+    {file = "rank_bm25-0.2.2.tar.gz", hash = "sha256:096ccef76f8188563419aaf384a02f0ea459503fdf77901378d4fd9d87e5e51d"},
+]
+
+[package.dependencies]
+numpy = "*"
+
+[package.extras]
+dev = ["pytest"]
+
 [[package]]
 name = "rapidfuzz"
 version = "3.13.0"
@@ -6906,6 +7048,97 @@ files = [
     {file = "websockets-15.0.1.tar.gz", hash = "sha256:82544de02076bafba038ce055ee6412d68da13ab47f0c60cab827346de828dee"},
 ]
 
+[[package]]
+name = "wrapt"
+version = "1.17.3"
+description = "Module for decorators, wrappers and monkey patching."
+optional = false
+python-versions = ">=3.8"
+groups = ["main"]
+files = [
+    {file = "wrapt-1.17.3-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:88bbae4d40d5a46142e70d58bf664a89b6b4befaea7b2ecc14e03cedb8e06c04"},
+    {file = "wrapt-1.17.3-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:e6b13af258d6a9ad602d57d889f83b9d5543acd471eee12eb51f5b01f8eb1bc2"},
+    {file = "wrapt-1.17.3-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:fd341868a4b6714a5962c1af0bd44f7c404ef78720c7de4892901e540417111c"},
+    {file = "wrapt-1.17.3-cp310-cp310-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:f9b2601381be482f70e5d1051a5965c25fb3625455a2bf520b5a077b22afb775"},
+    {file = "wrapt-1.17.3-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:343e44b2a8e60e06a7e0d29c1671a0d9951f59174f3709962b5143f60a2a98bd"},
+    {file = "wrapt-1.17.3-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:33486899acd2d7d3066156b03465b949da3fd41a5da6e394ec49d271baefcf05"},
+    {file = "wrapt-1.17.3-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:e6f40a8aa5a92f150bdb3e1c44b7e98fb7113955b2e5394122fa5532fec4b418"},
+    {file = "wrapt-1.17.3-cp310-cp310-win32.whl", hash = "sha256:a36692b8491d30a8c75f1dfee65bef119d6f39ea84ee04d9f9311f83c5ad9390"},
+    {file = "wrapt-1.17.3-cp310-cp310-win_amd64.whl", hash = "sha256:afd964fd43b10c12213574db492cb8f73b2f0826c8df07a68288f8f19af2ebe6"},
+    {file = "wrapt-1.17.3-cp310-cp310-win_arm64.whl", hash = "sha256:af338aa93554be859173c39c85243970dc6a289fa907402289eeae7543e1ae18"},
+    {file = "wrapt-1.17.3-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:273a736c4645e63ac582c60a56b0acb529ef07f78e08dc6bfadf6a46b19c0da7"},
+    {file = "wrapt-1.17.3-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:5531d911795e3f935a9c23eb1c8c03c211661a5060aab167065896bbf62a5f85"},
+    {file = "wrapt-1.17.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:0610b46293c59a3adbae3dee552b648b984176f8562ee0dba099a56cfbe4df1f"},
+    {file = "wrapt-1.17.3-cp311-cp311-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:b32888aad8b6e68f83a8fdccbf3165f5469702a7544472bdf41f582970ed3311"},
+    {file = "wrapt-1.17.3-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8cccf4f81371f257440c88faed6b74f1053eef90807b77e31ca057b2db74edb1"},
+    {file = "wrapt-1.17.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:d8a210b158a34164de8bb68b0e7780041a903d7b00c87e906fb69928bf7890d5"},
+    {file = "wrapt-1.17.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:79573c24a46ce11aab457b472efd8d125e5a51da2d1d24387666cd85f54c05b2"},
+    {file = "wrapt-1.17.3-cp311-cp311-win32.whl", hash = "sha256:c31eebe420a9a5d2887b13000b043ff6ca27c452a9a22fa71f35f118e8d4bf89"},
+    {file = "wrapt-1.17.3-cp311-cp311-win_amd64.whl", hash = "sha256:0b1831115c97f0663cb77aa27d381237e73ad4f721391a9bfb2fe8bc25fa6e77"},
+    {file = "wrapt-1.17.3-cp311-cp311-win_arm64.whl", hash = "sha256:5a7b3c1ee8265eb4c8f1b7d29943f195c00673f5ab60c192eba2d4a7eae5f46a"},
+    {file = "wrapt-1.17.3-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:ab232e7fdb44cdfbf55fc3afa31bcdb0d8980b9b95c38b6405df2acb672af0e0"},
+    {file = "wrapt-1.17.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:9baa544e6acc91130e926e8c802a17f3b16fbea0fd441b5a60f5cf2cc5c3deba"},
+    {file = "wrapt-1.17.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:6b538e31eca1a7ea4605e44f81a48aa24c4632a277431a6ed3f328835901f4fd"},
+    {file = "wrapt-1.17.3-cp312-cp312-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:042ec3bb8f319c147b1301f2393bc19dba6e176b7da446853406d041c36c7828"},
+    {file = "wrapt-1.17.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3af60380ba0b7b5aeb329bc4e402acd25bd877e98b3727b0135cb5c2efdaefe9"},
+    {file = "wrapt-1.17.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:0b02e424deef65c9f7326d8c19220a2c9040c51dc165cddb732f16198c168396"},
+    {file = "wrapt-1.17.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:74afa28374a3c3a11b3b5e5fca0ae03bef8450d6aa3ab3a1e2c30e3a75d023dc"},
+    {file = "wrapt-1.17.3-cp312-cp312-win32.whl", hash = "sha256:4da9f45279fff3543c371d5ababc57a0384f70be244de7759c85a7f989cb4ebe"},
+    {file = "wrapt-1.17.3-cp312-cp312-win_amd64.whl", hash = "sha256:e71d5c6ebac14875668a1e90baf2ea0ef5b7ac7918355850c0908ae82bcb297c"},
+    {file = "wrapt-1.17.3-cp312-cp312-win_arm64.whl", hash = "sha256:604d076c55e2fdd4c1c03d06dc1a31b95130010517b5019db15365ec4a405fc6"},
+    {file = "wrapt-1.17.3-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:a47681378a0439215912ef542c45a783484d4dd82bac412b71e59cf9c0e1cea0"},
+    {file = "wrapt-1.17.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:54a30837587c6ee3cd1a4d1c2ec5d24e77984d44e2f34547e2323ddb4e22eb77"},
+    {file = "wrapt-1.17.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:16ecf15d6af39246fe33e507105d67e4b81d8f8d2c6598ff7e3ca1b8a37213f7"},
+    {file = "wrapt-1.17.3-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:6fd1ad24dc235e4ab88cda009e19bf347aabb975e44fd5c2fb22a3f6e4141277"},
+    {file = "wrapt-1.17.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0ed61b7c2d49cee3c027372df5809a59d60cf1b6c2f81ee980a091f3afed6a2d"},
+    {file = "wrapt-1.17.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:423ed5420ad5f5529db9ce89eac09c8a2f97da18eb1c870237e84c5a5c2d60aa"},
+    {file = "wrapt-1.17.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:e01375f275f010fcbf7f643b4279896d04e571889b8a5b3f848423d91bf07050"},
+    {file = "wrapt-1.17.3-cp313-cp313-win32.whl", hash = "sha256:53e5e39ff71b3fc484df8a522c933ea2b7cdd0d5d15ae82e5b23fde87d44cbd8"},
+    {file = "wrapt-1.17.3-cp313-cp313-win_amd64.whl", hash = "sha256:1f0b2f40cf341ee8cc1a97d51ff50dddb9fcc73241b9143ec74b30fc4f44f6cb"},
+    {file = "wrapt-1.17.3-cp313-cp313-win_arm64.whl", hash = "sha256:7425ac3c54430f5fc5e7b6f41d41e704db073309acfc09305816bc6a0b26bb16"},
+    {file = "wrapt-1.17.3-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:cf30f6e3c077c8e6a9a7809c94551203c8843e74ba0c960f4a98cd80d4665d39"},
+    {file = "wrapt-1.17.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:e228514a06843cae89621384cfe3a80418f3c04aadf8a3b14e46a7be704e4235"},
+    {file = "wrapt-1.17.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:5ea5eb3c0c071862997d6f3e02af1d055f381b1d25b286b9d6644b79db77657c"},
+    {file = "wrapt-1.17.3-cp314-cp314-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:281262213373b6d5e4bb4353bc36d1ba4084e6d6b5d242863721ef2bf2c2930b"},
+    {file = "wrapt-1.17.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:dc4a8d2b25efb6681ecacad42fca8859f88092d8732b170de6a5dddd80a1c8fa"},
+    {file = "wrapt-1.17.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:373342dd05b1d07d752cecbec0c41817231f29f3a89aa8b8843f7b95992ed0c7"},
+    {file = "wrapt-1.17.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:d40770d7c0fd5cbed9d84b2c3f2e156431a12c9a37dc6284060fb4bec0b7ffd4"},
+    {file = "wrapt-1.17.3-cp314-cp314-win32.whl", hash = "sha256:fbd3c8319de8e1dc79d346929cd71d523622da527cca14e0c1d257e31c2b8b10"},
+    {file = "wrapt-1.17.3-cp314-cp314-win_amd64.whl", hash = "sha256:e1a4120ae5705f673727d3253de3ed0e016f7cd78dc463db1b31e2463e1f3cf6"},
+    {file = "wrapt-1.17.3-cp314-cp314-win_arm64.whl", hash = "sha256:507553480670cab08a800b9463bdb881b2edeed77dc677b0a5915e6106e91a58"},
+    {file = "wrapt-1.17.3-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:ed7c635ae45cfbc1a7371f708727bf74690daedc49b4dba310590ca0bd28aa8a"},
+    {file = "wrapt-1.17.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:249f88ed15503f6492a71f01442abddd73856a0032ae860de6d75ca62eed8067"},
+    {file = "wrapt-1.17.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:5a03a38adec8066d5a37bea22f2ba6bbf39fcdefbe2d91419ab864c3fb515454"},
+    {file = "wrapt-1.17.3-cp314-cp314t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:5d4478d72eb61c36e5b446e375bbc49ed002430d17cdec3cecb36993398e1a9e"},
+    {file = "wrapt-1.17.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:223db574bb38637e8230eb14b185565023ab624474df94d2af18f1cdb625216f"},
+    {file = "wrapt-1.17.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:e405adefb53a435f01efa7ccdec012c016b5a1d3f35459990afc39b6be4d5056"},
+    {file = "wrapt-1.17.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:88547535b787a6c9ce4086917b6e1d291aa8ed914fdd3a838b3539dc95c12804"},
+    {file = "wrapt-1.17.3-cp314-cp314t-win32.whl", hash = "sha256:41b1d2bc74c2cac6f9074df52b2efbef2b30bdfe5f40cb78f8ca22963bc62977"},
+    {file = "wrapt-1.17.3-cp314-cp314t-win_amd64.whl", hash = "sha256:73d496de46cd2cdbdbcce4ae4bcdb4afb6a11234a1df9c085249d55166b95116"},
+    {file = "wrapt-1.17.3-cp314-cp314t-win_arm64.whl", hash = "sha256:f38e60678850c42461d4202739f9bf1e3a737c7ad283638251e79cc49effb6b6"},
+    {file = "wrapt-1.17.3-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:70d86fa5197b8947a2fa70260b48e400bf2ccacdcab97bb7de47e3d1e6312225"},
+    {file = "wrapt-1.17.3-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:df7d30371a2accfe4013e90445f6388c570f103d61019b6b7c57e0265250072a"},
+    {file = "wrapt-1.17.3-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:caea3e9c79d5f0d2c6d9ab96111601797ea5da8e6d0723f77eabb0d4068d2b2f"},
+    {file = "wrapt-1.17.3-cp38-cp38-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:758895b01d546812d1f42204bd443b8c433c44d090248bf22689df673ccafe00"},
+    {file = "wrapt-1.17.3-cp38-cp38-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:02b551d101f31694fc785e58e0720ef7d9a10c4e62c1c9358ce6f63f23e30a56"},
+    {file = "wrapt-1.17.3-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:656873859b3b50eeebe6db8b1455e99d90c26ab058db8e427046dbc35c3140a5"},
+    {file = "wrapt-1.17.3-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:a9a2203361a6e6404f80b99234fe7fb37d1fc73487b5a78dc1aa5b97201e0f22"},
+    {file = "wrapt-1.17.3-cp38-cp38-win32.whl", hash = "sha256:55cbbc356c2842f39bcc553cf695932e8b30e30e797f961860afb308e6b1bb7c"},
+    {file = "wrapt-1.17.3-cp38-cp38-win_amd64.whl", hash = "sha256:ad85e269fe54d506b240d2d7b9f5f2057c2aa9a2ea5b32c66f8902f768117ed2"},
+    {file = "wrapt-1.17.3-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:30ce38e66630599e1193798285706903110d4f057aab3168a34b7fdc85569afc"},
+    {file = "wrapt-1.17.3-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:65d1d00fbfb3ea5f20add88bbc0f815150dbbde3b026e6c24759466c8b5a9ef9"},
+    {file = "wrapt-1.17.3-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:a7c06742645f914f26c7f1fa47b8bc4c91d222f76ee20116c43d5ef0912bba2d"},
+    {file = "wrapt-1.17.3-cp39-cp39-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:7e18f01b0c3e4a07fe6dfdb00e29049ba17eadbc5e7609a2a3a4af83ab7d710a"},
+    {file = "wrapt-1.17.3-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0f5f51a6466667a5a356e6381d362d259125b57f059103dd9fdc8c0cf1d14139"},
+    {file = "wrapt-1.17.3-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:59923aa12d0157f6b82d686c3fd8e1166fa8cdfb3e17b42ce3b6147ff81528df"},
+    {file = "wrapt-1.17.3-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:46acc57b331e0b3bcb3e1ca3b421d65637915cfcd65eb783cb2f78a511193f9b"},
+    {file = "wrapt-1.17.3-cp39-cp39-win32.whl", hash = "sha256:3e62d15d3cfa26e3d0788094de7b64efa75f3a53875cdbccdf78547aed547a81"},
+    {file = "wrapt-1.17.3-cp39-cp39-win_amd64.whl", hash = "sha256:1f23fa283f51c890eda8e34e4937079114c74b4c81d2b2f1f1d94948f5cc3d7f"},
+    {file = "wrapt-1.17.3-cp39-cp39-win_arm64.whl", hash = "sha256:24c2ed34dc222ed754247a2702b1e1e89fdbaa4016f324b4b8f1a802d4ffe87f"},
+    {file = "wrapt-1.17.3-py3-none-any.whl", hash = "sha256:7171ae35d2c33d326ac19dd8facb1e82e5fd04ef8c6c0e394d7af55a55051c22"},
+    {file = "wrapt-1.17.3.tar.gz", hash = "sha256:f66eb08feaa410fe4eebd17f2a2c8e2e46d3476e9f8c783daa8e09e0faa666d0"},
+]
+
 [[package]]
 name = "xattr"
 version = "1.2.0"
@@ -7279,4 +7512,4 @@ cffi = ["cffi (>=1.11)"]
 [metadata]
 lock-version = "2.1"
 python-versions = ">=3.10,<3.14"
-content-hash = "13b191b2a1989d3321ff713c66ff6f5f4f3b82d15df4d407e0e5dbf87d7522c4"
+content-hash = "18b92e09596298c82432e4d0a85cb6d80a40b4229bee0a0c15f0529fd6cb21a4"
diff --git a/autogpt_platform/backend/pyproject.toml b/autogpt_platform/backend/pyproject.toml
index fb06b65162..1f489d2bc4 100644
--- a/autogpt_platform/backend/pyproject.toml
+++ b/autogpt_platform/backend/pyproject.toml
@@ -27,12 +27,13 @@ google-api-python-client = "^2.177.0"
 google-auth-oauthlib = "^1.2.2"
 google-cloud-storage = "^3.2.0"
 googlemaps = "^4.10.0"
-gravitasml = "^0.1.3"
+gravitasml = "^0.1.4"
 groq = "^0.30.0"
 html2text = "^2024.2.26"
 jinja2 = "^3.1.6"
 jsonref = "^1.1.0"
 jsonschema = "^4.25.0"
+langfuse = "^3.11.0"
 launchdarkly-server-sdk = "^9.12.0"
 mem0ai = "^0.1.115"
 moviepy = "^2.1.2"
@@ -45,6 +46,7 @@ poetry = "2.1.1" # CHECK DEPENDABOT SUPPORT BEFORE UPGRADING
 postmarker = "^1.0"
 praw = "~7.8.1"
 prisma = "^0.15.0"
+rank-bm25 = "^0.2.2"
 prometheus-client = "^0.22.1"
 prometheus-fastapi-instrumentator = "^7.0.0"
 psutil = "^7.0.0"
@@ -82,6 +84,7 @@ firecrawl-py = "^4.3.6"
 exa-py = "^1.14.20"
 croniter = "^6.0.0"
 stagehand = "^0.5.1"
+gravitas-md2gdocs = "^0.1.0"
 
 [tool.poetry.group.dev.dependencies]
 aiohappyeyeballs = "^2.6.1"
@@ -116,6 +119,7 @@ lint = "linter:lint"
 test = "run_tests:test"
 load-store-agents = "test.load_store_agents:run"
 export-api-schema = "backend.cli.generate_openapi_json:main"
+gen-prisma-stub = "gen_prisma_types_stub:main"
 oauth-tool = "backend.cli.oauth_tool:cli"
 
 [tool.isort]
@@ -133,6 +137,9 @@ ignore_patterns = []
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
 asyncio_default_fixture_loop_scope = "session"
+# Disable syrupy plugin to avoid conflict with pytest-snapshot
+# Both provide --snapshot-update argument causing ArgumentError
+addopts = "-p no:syrupy"
 filterwarnings = [
     "ignore:'audioop' is deprecated:DeprecationWarning:discord.player",
     "ignore:invalid escape sequence:DeprecationWarning:tweepy.api",
diff --git a/autogpt_platform/backend/schema.prisma b/autogpt_platform/backend/schema.prisma
index 2f6c109c03..4a2a7b583a 100644
--- a/autogpt_platform/backend/schema.prisma
+++ b/autogpt_platform/backend/schema.prisma
@@ -1,14 +1,15 @@
 datasource db {
-  provider  = "postgresql"
-  url       = env("DATABASE_URL")
-  directUrl = env("DIRECT_URL")
+  provider   = "postgresql"
+  url        = env("DATABASE_URL")
+  directUrl  = env("DIRECT_URL")
+  extensions = [pgvector(map: "vector")]
 }
 
 generator client {
   provider               = "prisma-client-py"
   recursive_type_depth   = -1
   interface              = "asyncio"
-  previewFeatures        = ["views", "fullTextSearch"]
+  previewFeatures        = ["views", "fullTextSearch", "postgresqlExtensions"]
   partial_type_generator = "backend/data/partial_types.py"
 }
 
@@ -47,12 +48,13 @@ model User {
   AnalyticsMetrics     AnalyticsMetrics[]
   CreditTransactions   CreditTransaction[]
   UserBalance          UserBalance?
-
-  AgentPresets  AgentPreset[]
-  LibraryAgents LibraryAgent[]
+  ChatSessions         ChatSession[]
+  AgentPresets         AgentPreset[]
+  LibraryAgents        LibraryAgent[]
 
   Profile               Profile[]
   UserOnboarding        UserOnboarding?
+  CoPilotUnderstanding  CoPilotUnderstanding?
   BuilderSearchHistory  BuilderSearchHistory[]
   StoreListings         StoreListing[]
   StoreListingReviews   StoreListingReview[]
@@ -121,19 +123,84 @@ model UserOnboarding {
   User   User   @relation(fields: [userId], references: [id], onDelete: Cascade)
 }
 
+model CoPilotUnderstanding {
+  id        String   @id @default(uuid())
+  createdAt DateTime @default(now())
+  updatedAt DateTime @default(now()) @updatedAt
+
+  userId String @unique
+  User   User   @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  data Json?
+
+  @@index([userId])
+}
+
 model BuilderSearchHistory {
   id        String   @id @default(uuid())
   createdAt DateTime @default(now())
   updatedAt DateTime @default(now()) @updatedAt
 
   searchQuery String
-  filter      String[]  @default([])
-  byCreator   String[]  @default([])
+  filter      String[] @default([])
+  byCreator   String[] @default([])
 
   userId String
   User   User   @relation(fields: [userId], references: [id], onDelete: Cascade)
 }
 
+////////////////////////////////////////////////////////////
+////////////////////////////////////////////////////////////
+////////////////   CHAT SESSION TABLES   ///////////////////
+////////////////////////////////////////////////////////////
+////////////////////////////////////////////////////////////
+
+model ChatSession {
+  id        String   @id @default(uuid())
+  createdAt DateTime @default(now())
+  updatedAt DateTime @default(now()) @updatedAt
+
+  userId      String
+  User        User    @relation(fields: [userId], references: [id], onDelete: Cascade)
+  // Session metadata
+  title       String?
+  credentials Json    @default("{}") // Map of provider -> credential metadata
+
+  // Rate limiting counters (stored as JSON maps)
+  successfulAgentRuns      Json @default("{}") // Map of graph_id -> count
+  successfulAgentSchedules Json @default("{}") // Map of graph_id -> count
+
+  // Usage tracking
+  totalPromptTokens     Int @default(0)
+  totalCompletionTokens Int @default(0)
+
+  Messages ChatMessage[]
+
+  @@index([userId, updatedAt])
+}
+
+model ChatMessage {
+  id        String   @id @default(uuid())
+  createdAt DateTime @default(now())
+
+  sessionId String
+  Session   ChatSession @relation(fields: [sessionId], references: [id], onDelete: Cascade)
+
+  // Message content
+  role         String // "user", "assistant", "system", "tool", "function"
+  content      String?
+  name         String?
+  toolCallId   String?
+  refusal      String?
+  toolCalls    Json? // List of tool calls for assistant messages
+  functionCall Json? // Deprecated but kept for compatibility
+
+  // Ordering within session
+  sequence Int
+
+  @@unique([sessionId, sequence])
+}
+
 // This model describes the Agent Graph/Flow (Multi Agent System).
 model AgentGraph {
   id        String    @default(uuid())
@@ -383,6 +450,7 @@ model AgentGraphExecution {
   createdAt DateTime  @default(now())
   updatedAt DateTime? @updatedAt
   startedAt DateTime?
+  endedAt   DateTime?
 
   isDeleted Boolean @default(false)
 
@@ -721,26 +789,25 @@ view StoreAgent {
   storeListingVersionId String
   updated_at            DateTime
 
-  slug                String
-  agent_name          String
-  agent_video         String?
-  agent_output_demo   String?
-  agent_image         String[]
+  slug              String
+  agent_name        String
+  agent_video       String?
+  agent_output_demo String?
+  agent_image       String[]
 
-  featured         Boolean                  @default(false)
-  creator_username String?
-  creator_avatar   String?
-  sub_heading      String
-  description      String
-  categories       String[]
-  search           Unsupported("tsvector")? @default(dbgenerated("''::tsvector"))
-  runs                Int
-  rating              Float
-  versions            String[]
-  agentGraphVersions  String[]
-  agentGraphId        String
-  is_available        Boolean                  @default(true)
-  useForOnboarding    Boolean                  @default(false)
+  featured           Boolean  @default(false)
+  creator_username   String?
+  creator_avatar     String?
+  sub_heading        String
+  description        String
+  categories         String[]
+  runs               Int
+  rating             Float
+  versions           String[]
+  agentGraphVersions String[]
+  agentGraphId       String
+  is_available       Boolean  @default(true)
+  useForOnboarding   Boolean  @default(false)
 
   // Materialized views used (refreshed every 15 minutes via pg_cron):
   // - mv_agent_run_counts - Pre-aggregated agent execution counts by agentGraphId
@@ -856,14 +923,14 @@ model StoreListingVersion {
   AgentGraph        AgentGraph @relation(fields: [agentGraphId, agentGraphVersion], references: [id, version])
 
   // Content fields
-  name                String
-  subHeading          String
-  videoUrl            String?
-  agentOutputDemoUrl  String?
-  imageUrls           String[]
-  description         String
-  instructions        String?
-  categories          String[]
+  name               String
+  subHeading         String
+  videoUrl           String?
+  agentOutputDemoUrl String?
+  imageUrls          String[]
+  description        String
+  instructions       String?
+  categories         String[]
 
   isFeatured Boolean @default(false)
 
@@ -871,7 +938,7 @@ model StoreListingVersion {
   // Old versions can be made unavailable by the author if desired
   isAvailable Boolean @default(true)
 
-  search Unsupported("tsvector")? @default(dbgenerated("''::tsvector"))
+  // Note: search column removed - now using UnifiedContentEmbedding.search
 
   // Version workflow state
   submissionStatus SubmissionStatus @default(DRAFT)
@@ -899,6 +966,9 @@ model StoreListingVersion {
   // Reviews for this specific version
   Reviews StoreListingReview[]
 
+  // Note: Embeddings now stored in UnifiedContentEmbedding table
+  // Use contentType=STORE_AGENT and contentId=storeListingVersionId
+
   @@unique([storeListingId, version])
   @@index([storeListingId, submissionStatus, isAvailable])
   @@index([submissionStatus])
@@ -906,6 +976,45 @@ model StoreListingVersion {
   @@index([agentGraphId, agentGraphVersion]) // Non-unique index for efficient lookups
 }
 
+// Content type enum for unified search across store agents, blocks, docs
+// Note: BLOCK/INTEGRATION are file-based (Python classes), not DB records
+// DOCUMENTATION are file-based (.md files), not DB records  
+// Only STORE_AGENT and LIBRARY_AGENT are stored in database
+enum ContentType {
+  STORE_AGENT // Database: StoreListingVersion
+  BLOCK // File-based: Python classes in /backend/blocks/
+  INTEGRATION // File-based: Python classes (blocks with credentials)
+  DOCUMENTATION // File-based: .md/.mdx files
+  LIBRARY_AGENT // Database: User's personal agents
+}
+
+// Unified embeddings table for all searchable content types
+// Supports both public content (userId=null) and user-specific content (userId=userID)
+model UnifiedContentEmbedding {
+  id        String   @id @default(uuid())
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  // Content identification
+  contentType ContentType
+  contentId   String // DB ID (storeListingVersionId) or file identifier (block.id, file_path)
+  userId      String? // NULL for public content (store, blocks, docs), userId for private content (library agents)
+
+  // Search data
+  embedding      Unsupported("vector(1536)") // pgvector embedding (extension in platform schema)
+  searchableText String // Combined text for search and fallback
+  search         Unsupported("tsvector")? @default(dbgenerated("''::tsvector")) // Full-text search (auto-populated by trigger)
+  metadata       Json                        @default("{}") // Content-specific metadata
+
+  @@unique([contentType, contentId, userId], map: "UnifiedContentEmbedding_contentType_contentId_userId_key")
+  @@index([contentType])
+  @@index([userId])
+  @@index([contentType, userId])
+  @@index([embedding], map: "UnifiedContentEmbedding_embedding_idx")
+  // NO @@index for search - GIN index "UnifiedContentEmbedding_search_idx" created via SQL migration
+  // Prisma may generate DROP INDEX on migrate dev - that's okay, migration recreates it
+}
+
 model StoreListingReview {
   id        String   @id @default(uuid())
   createdAt DateTime @default(now())
@@ -998,16 +1107,16 @@ model OAuthApplication {
   updatedAt DateTime @updatedAt
 
   // Application metadata
-  name               String
-  description        String?
-  logoUrl            String? // URL to app logo stored in GCS
-  clientId           String @unique
-  clientSecret       String // Hashed with Scrypt (same as API keys)
-  clientSecretSalt   String // Salt for Scrypt hashing
+  name             String
+  description      String?
+  logoUrl          String? // URL to app logo stored in GCS
+  clientId         String  @unique
+  clientSecret     String // Hashed with Scrypt (same as API keys)
+  clientSecretSalt String // Salt for Scrypt hashing
 
   // OAuth configuration
   redirectUris String[] // Allowed callback URLs
-  grantTypes   String[] @default(["authorization_code", "refresh_token"])
+  grantTypes   String[]           @default(["authorization_code", "refresh_token"])
   scopes       APIKeyPermission[] // Which permissions the app can request
 
   // Application management
diff --git a/autogpt_platform/backend/scripts/generate_block_docs.py b/autogpt_platform/backend/scripts/generate_block_docs.py
new file mode 100644
index 0000000000..1a49cc8805
--- /dev/null
+++ b/autogpt_platform/backend/scripts/generate_block_docs.py
@@ -0,0 +1,864 @@
+#!/usr/bin/env python3
+"""
+Block Documentation Generator
+
+Generates markdown documentation for all blocks from code introspection.
+Preserves manually-written content between marker comments.
+
+Usage:
+    # Generate all docs
+    poetry run python scripts/generate_block_docs.py
+
+    # Check mode for CI (exits 1 if stale)
+    poetry run python scripts/generate_block_docs.py --check
+
+    # Verbose output
+    poetry run python scripts/generate_block_docs.py -v
+"""
+
+import argparse
+import inspect
+import logging
+import re
+import sys
+from collections import defaultdict
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Any
+
+# Add backend to path for imports
+backend_dir = Path(__file__).parent.parent
+sys.path.insert(0, str(backend_dir))
+
+logger = logging.getLogger(__name__)
+
+# Default output directory relative to repo root
+DEFAULT_OUTPUT_DIR = (
+    Path(__file__).parent.parent.parent.parent / "docs" / "integrations"
+)
+
+
+@dataclass
+class FieldDoc:
+    """Documentation for a single input/output field."""
+
+    name: str
+    description: str
+    type_str: str
+    required: bool
+    default: Any = None
+    advanced: bool = False
+    hidden: bool = False
+    placeholder: str | None = None
+
+
+@dataclass
+class BlockDoc:
+    """Documentation data extracted from a block."""
+
+    id: str
+    name: str
+    class_name: str
+    description: str
+    categories: list[str]
+    category_descriptions: dict[str, str]
+    inputs: list[FieldDoc]
+    outputs: list[FieldDoc]
+    block_type: str
+    source_file: str
+    contributors: list[str] = field(default_factory=list)
+
+
+# Category to human-readable name mapping
+CATEGORY_DISPLAY_NAMES = {
+    "AI": "AI and Language Models",
+    "BASIC": "Basic Operations",
+    "TEXT": "Text Processing",
+    "SEARCH": "Search and Information Retrieval",
+    "SOCIAL": "Social Media and Content",
+    "DEVELOPER_TOOLS": "Developer Tools",
+    "DATA": "Data Processing",
+    "LOGIC": "Logic and Control Flow",
+    "COMMUNICATION": "Communication",
+    "INPUT": "Input/Output",
+    "OUTPUT": "Input/Output",
+    "MULTIMEDIA": "Media Generation",
+    "PRODUCTIVITY": "Productivity",
+    "HARDWARE": "Hardware",
+    "AGENT": "Agent Integration",
+    "CRM": "CRM Services",
+    "SAFETY": "AI Safety",
+    "ISSUE_TRACKING": "Issue Tracking",
+    "MARKETING": "Marketing",
+}
+
+# Category to doc file mapping (for grouping related blocks)
+CATEGORY_FILE_MAP = {
+    "BASIC": "basic",
+    "TEXT": "text",
+    "AI": "llm",
+    "SEARCH": "search",
+    "DATA": "data",
+    "LOGIC": "logic",
+    "COMMUNICATION": "communication",
+    "MULTIMEDIA": "multimedia",
+    "PRODUCTIVITY": "productivity",
+}
+
+
+def class_name_to_display_name(class_name: str) -> str:
+    """Convert BlockClassName to 'Block Class Name'."""
+    # Remove 'Block' suffix (only at the end, not all occurrences)
+    name = class_name.removesuffix("Block")
+    # Insert space before capitals
+    name = re.sub(r"([a-z])([A-Z])", r"\1 \2", name)
+    # Handle consecutive capitals (e.g., 'HTTPRequest' -> 'HTTP Request')
+    name = re.sub(r"([A-Z]+)([A-Z][a-z])", r"\1 \2", name)
+    return name.strip()
+
+
+def type_to_readable(type_schema: dict[str, Any] | Any) -> str:
+    """Convert JSON schema type to human-readable string."""
+    if not isinstance(type_schema, dict):
+        return str(type_schema) if type_schema else "Any"
+
+    if "anyOf" in type_schema:
+        # Union type - show options
+        any_of = type_schema["anyOf"]
+        if not isinstance(any_of, list):
+            return "Any"
+        options = []
+        for opt in any_of:
+            if isinstance(opt, dict) and opt.get("type") == "null":
+                continue
+            options.append(type_to_readable(opt))
+        if not options:
+            return "None"
+        if len(options) == 1:
+            return options[0]
+        return " | ".join(options)
+
+    if "allOf" in type_schema:
+        all_of = type_schema["allOf"]
+        if not isinstance(all_of, list) or not all_of:
+            return "Any"
+        return type_to_readable(all_of[0])
+
+    schema_type = type_schema.get("type")
+
+    if schema_type == "array":
+        items = type_schema.get("items", {})
+        item_type = type_to_readable(items)
+        return f"List[{item_type}]"
+
+    if schema_type == "object":
+        if "additionalProperties" in type_schema:
+            additional_props = type_schema["additionalProperties"]
+            # additionalProperties: true means any value type is allowed
+            if additional_props is True:
+                return "Dict[str, Any]"
+            value_type = type_to_readable(additional_props)
+            return f"Dict[str, {value_type}]"
+        # Check if it's a specific model
+        title = type_schema.get("title", "Object")
+        return title
+
+    if schema_type == "string":
+        if "enum" in type_schema:
+            return " | ".join(f'"{v}"' for v in type_schema["enum"])
+        if "format" in type_schema:
+            return f"str ({type_schema['format']})"
+        return "str"
+
+    if schema_type == "integer":
+        return "int"
+
+    if schema_type == "number":
+        return "float"
+
+    if schema_type == "boolean":
+        return "bool"
+
+    if schema_type == "null":
+        return "None"
+
+    # Fallback
+    return type_schema.get("title", schema_type or "Any")
+
+
+def safe_get(d: Any, key: str, default: Any = None) -> Any:
+    """Safely get a value from a dict-like object."""
+    if isinstance(d, dict):
+        return d.get(key, default)
+    return default
+
+
+def file_path_to_title(file_path: str) -> str:
+    """Convert file path to a readable title.
+
+    Examples:
+        "github/issues.md" -> "GitHub Issues"
+        "basic.md" -> "Basic"
+        "llm.md" -> "LLM"
+        "google/sheets.md" -> "Google Sheets"
+    """
+    # Special case replacements (applied after title casing)
+    TITLE_FIXES = {
+        "Llm": "LLM",
+        "Github": "GitHub",
+        "Api": "API",
+        "Ai": "AI",
+        "Oauth": "OAuth",
+        "Url": "URL",
+        "Ci": "CI",
+        "Pr": "PR",
+        "Gmb": "GMB",  # Google My Business
+        "Hubspot": "HubSpot",
+        "Linkedin": "LinkedIn",
+        "Tiktok": "TikTok",
+        "Youtube": "YouTube",
+    }
+
+    def apply_fixes(text: str) -> str:
+        # Split into words, fix each word, rejoin
+        words = text.split()
+        fixed_words = [TITLE_FIXES.get(word, word) for word in words]
+        return " ".join(fixed_words)
+
+    path = Path(file_path)
+    name = path.stem  # e.g., "issues" or "sheets"
+
+    # Get parent dir if exists
+    parent = path.parent.name if path.parent.name != "." else None
+
+    # Title case and apply fixes
+    if parent:
+        parent_title = apply_fixes(parent.replace("_", " ").title())
+        name_title = apply_fixes(name.replace("_", " ").title())
+        return f"{parent_title} {name_title}"
+    return apply_fixes(name.replace("_", " ").title())
+
+
+def extract_block_doc(block_cls: type) -> BlockDoc:
+    """Extract documentation data from a block class."""
+    block = block_cls.create()
+
+    # Get source file
+    try:
+        source_file = inspect.getfile(block_cls)
+        # Make relative to blocks directory
+        blocks_dir = Path(source_file).parent
+        while blocks_dir.name != "blocks" and blocks_dir.parent != blocks_dir:
+            blocks_dir = blocks_dir.parent
+        source_file = str(Path(source_file).relative_to(blocks_dir.parent))
+    except (TypeError, ValueError):
+        source_file = "unknown"
+
+    # Extract input fields
+    input_schema = block.input_schema.jsonschema()
+    input_properties = safe_get(input_schema, "properties", {})
+    if not isinstance(input_properties, dict):
+        input_properties = {}
+    required_raw = safe_get(input_schema, "required", [])
+    # Handle edge cases where required might not be a list
+    if isinstance(required_raw, (list, set, tuple)):
+        required_inputs = set(required_raw)
+    else:
+        required_inputs = set()
+
+    inputs = []
+    for field_name, field_schema in input_properties.items():
+        if not isinstance(field_schema, dict):
+            continue
+        # Skip credentials fields in docs (they're auto-handled)
+        if "credentials" in field_name.lower():
+            continue
+
+        inputs.append(
+            FieldDoc(
+                name=field_name,
+                description=safe_get(field_schema, "description", ""),
+                type_str=type_to_readable(field_schema),
+                required=field_name in required_inputs,
+                default=safe_get(field_schema, "default"),
+                advanced=safe_get(field_schema, "advanced", False) or False,
+                hidden=safe_get(field_schema, "hidden", False) or False,
+                placeholder=safe_get(field_schema, "placeholder"),
+            )
+        )
+
+    # Extract output fields
+    output_schema = block.output_schema.jsonschema()
+    output_properties = safe_get(output_schema, "properties", {})
+    if not isinstance(output_properties, dict):
+        output_properties = {}
+
+    outputs = []
+    for field_name, field_schema in output_properties.items():
+        if not isinstance(field_schema, dict):
+            continue
+        outputs.append(
+            FieldDoc(
+                name=field_name,
+                description=safe_get(field_schema, "description", ""),
+                type_str=type_to_readable(field_schema),
+                required=True,  # Outputs are always produced
+                hidden=safe_get(field_schema, "hidden", False) or False,
+            )
+        )
+
+    # Get category info (sort for deterministic ordering since it's a set)
+    categories = []
+    category_descriptions = {}
+    for cat in sorted(block.categories, key=lambda c: c.name):
+        categories.append(cat.name)
+        category_descriptions[cat.name] = cat.value
+
+    # Get contributors
+    contributors = []
+    for contrib in block.contributors:
+        contributors.append(contrib.name if hasattr(contrib, "name") else str(contrib))
+
+    return BlockDoc(
+        id=block.id,
+        name=class_name_to_display_name(block.name),
+        class_name=block.name,
+        description=block.description,
+        categories=categories,
+        category_descriptions=category_descriptions,
+        inputs=inputs,
+        outputs=outputs,
+        block_type=block.block_type.value,
+        source_file=source_file,
+        contributors=contributors,
+    )
+
+
+def generate_anchor(name: str) -> str:
+    """Generate markdown anchor from block name."""
+    return name.lower().replace(" ", "-").replace("(", "").replace(")", "")
+
+
+def extract_manual_content(existing_content: str) -> dict[str, str]:
+    """Extract content between MANUAL markers from existing file."""
+    manual_sections = {}
+
+    # Pattern: <!-- MANUAL: section_name -->content<!-- END MANUAL -->
+    pattern = r"<!-- MANUAL: (\w+) -->\s*(.*?)\s*<!-- END MANUAL -->"
+    matches = re.findall(pattern, existing_content, re.DOTALL)
+
+    for section_name, content in matches:
+        manual_sections[section_name] = content.strip()
+
+    return manual_sections
+
+
+def generate_block_markdown(
+    block: BlockDoc,
+    manual_content: dict[str, str] | None = None,
+) -> str:
+    """Generate markdown documentation for a single block."""
+    manual_content = manual_content or {}
+    lines = []
+
+    # All blocks use ## heading, sections use ### (consistent siblings)
+    lines.append(f"## {block.name}")
+    lines.append("")
+
+    # What it is (full description)
+    lines.append(f"### What it is")
+    lines.append(block.description or "No description available.")
+    lines.append("")
+
+    # How it works (manual section)
+    lines.append(f"### How it works")
+    how_it_works = manual_content.get(
+        "how_it_works", "_Add technical explanation here._"
+    )
+    lines.append("<!-- MANUAL: how_it_works -->")
+    lines.append(how_it_works)
+    lines.append("<!-- END MANUAL -->")
+    lines.append("")
+
+    # Inputs table (auto-generated)
+    visible_inputs = [f for f in block.inputs if not f.hidden]
+    if visible_inputs:
+        lines.append(f"### Inputs")
+        lines.append("")
+        lines.append("| Input | Description | Type | Required |")
+        lines.append("|-------|-------------|------|----------|")
+        for inp in visible_inputs:
+            required = "Yes" if inp.required else "No"
+            desc = inp.description or "-"
+            type_str = inp.type_str or "-"
+            # Normalize newlines and escape pipes for valid table syntax
+            desc = desc.replace("\n", " ").replace("|", "\\|")
+            type_str = type_str.replace("|", "\\|")
+            lines.append(f"| {inp.name} | {desc} | {type_str} | {required} |")
+        lines.append("")
+
+    # Outputs table (auto-generated)
+    visible_outputs = [f for f in block.outputs if not f.hidden]
+    if visible_outputs:
+        lines.append(f"### Outputs")
+        lines.append("")
+        lines.append("| Output | Description | Type |")
+        lines.append("|--------|-------------|------|")
+        for out in visible_outputs:
+            desc = out.description or "-"
+            type_str = out.type_str or "-"
+            # Normalize newlines and escape pipes for valid table syntax
+            desc = desc.replace("\n", " ").replace("|", "\\|")
+            type_str = type_str.replace("|", "\\|")
+            lines.append(f"| {out.name} | {desc} | {type_str} |")
+        lines.append("")
+
+    # Possible use case (manual section)
+    lines.append(f"### Possible use case")
+    use_case = manual_content.get("use_case", "_Add practical use case examples here._")
+    lines.append("<!-- MANUAL: use_case -->")
+    lines.append(use_case)
+    lines.append("<!-- END MANUAL -->")
+    lines.append("")
+
+    lines.append("---")
+    lines.append("")
+
+    return "\n".join(lines)
+
+
+def get_block_file_mapping(blocks: list[BlockDoc]) -> dict[str, list[BlockDoc]]:
+    """
+    Map blocks to their documentation files.
+
+    Returns dict of {relative_file_path: [blocks]}
+    """
+    file_mapping = defaultdict(list)
+
+    for block in blocks:
+        # Determine file path based on source file or category
+        source_path = Path(block.source_file)
+
+        # If source is in a subdirectory (e.g., google/gmail.py), use that structure
+        if len(source_path.parts) > 2:  # blocks/subdir/file.py
+            subdir = source_path.parts[1]  # e.g., "google"
+            # Use the Python filename as the md filename
+            md_file = source_path.stem + ".md"  # e.g., "gmail.md"
+            file_path = f"{subdir}/{md_file}"
+        else:
+            # Use category-based grouping for top-level blocks
+            primary_category = block.categories[0] if block.categories else "BASIC"
+            file_name = CATEGORY_FILE_MAP.get(primary_category, "misc")
+            file_path = f"{file_name}.md"
+
+        file_mapping[file_path].append(block)
+
+    return dict(file_mapping)
+
+
+def generate_overview_table(blocks: list[BlockDoc]) -> str:
+    """Generate the overview table markdown (blocks.md)."""
+    lines = []
+
+    lines.append("# AutoGPT Blocks Overview")
+    lines.append("")
+    lines.append(
+        'AutoGPT uses a modular approach with various "blocks" to handle different tasks. These blocks are the building blocks of AutoGPT workflows, allowing users to create complex automations by combining simple, specialized components.'
+    )
+    lines.append("")
+    lines.append('!!! info "Creating Your Own Blocks"')
+    lines.append("    Want to create your own custom blocks? Check out our guides:")
+    lines.append("    ")
+    lines.append(
+        "    - [Build your own Blocks](https://docs.agpt.co/platform/new_blocks/) - Step-by-step tutorial with examples"
+    )
+    lines.append(
+        "    - [Block SDK Guide](https://docs.agpt.co/platform/block-sdk-guide/) - Advanced SDK patterns with OAuth, webhooks, and provider configuration"
+    )
+    lines.append("")
+    lines.append(
+        "Below is a comprehensive list of all available blocks, categorized by their primary function. Click on any block name to view its detailed documentation."
+    )
+    lines.append("")
+
+    # Group blocks by category
+    by_category = defaultdict(list)
+    for block in blocks:
+        primary_cat = block.categories[0] if block.categories else "BASIC"
+        by_category[primary_cat].append(block)
+
+    # Sort categories
+    category_order = [
+        "BASIC",
+        "DATA",
+        "TEXT",
+        "AI",
+        "SEARCH",
+        "SOCIAL",
+        "COMMUNICATION",
+        "DEVELOPER_TOOLS",
+        "MULTIMEDIA",
+        "PRODUCTIVITY",
+        "LOGIC",
+        "INPUT",
+        "OUTPUT",
+        "AGENT",
+        "CRM",
+        "SAFETY",
+        "ISSUE_TRACKING",
+        "HARDWARE",
+        "MARKETING",
+    ]
+
+    # Track emitted display names to avoid duplicate headers
+    # (e.g., INPUT and OUTPUT both map to "Input/Output")
+    emitted_display_names: set[str] = set()
+
+    for category in category_order:
+        if category not in by_category:
+            continue
+
+        display_name = CATEGORY_DISPLAY_NAMES.get(category, category)
+
+        # Collect all blocks for this display name (may span multiple categories)
+        if display_name in emitted_display_names:
+            # Already emitted header, just add rows to existing table
+            # Find the position before the last empty line and insert rows
+            cat_blocks = sorted(by_category[category], key=lambda b: b.name)
+            # Remove the trailing empty line, add rows, then re-add empty line
+            lines.pop()
+            for block in cat_blocks:
+                file_mapping = get_block_file_mapping([block])
+                file_path = list(file_mapping.keys())[0]
+                anchor = generate_anchor(block.name)
+                short_desc = (
+                    block.description.split(".")[0]
+                    if block.description
+                    else "No description"
+                )
+                short_desc = short_desc.replace("\n", " ").replace("|", "\\|")
+                lines.append(f"| [{block.name}]({file_path}#{anchor}) | {short_desc} |")
+            lines.append("")
+            continue
+
+        emitted_display_names.add(display_name)
+        cat_blocks = sorted(by_category[category], key=lambda b: b.name)
+
+        lines.append(f"## {display_name}")
+        lines.append("")
+        lines.append("| Block Name | Description |")
+        lines.append("|------------|-------------|")
+
+        for block in cat_blocks:
+            # Determine link path
+            file_mapping = get_block_file_mapping([block])
+            file_path = list(file_mapping.keys())[0]
+            anchor = generate_anchor(block.name)
+
+            # Short description (first sentence)
+            short_desc = (
+                block.description.split(".")[0]
+                if block.description
+                else "No description"
+            )
+            short_desc = short_desc.replace("\n", " ").replace("|", "\\|")
+
+            lines.append(f"| [{block.name}]({file_path}#{anchor}) | {short_desc} |")
+
+        lines.append("")
+
+    return "\n".join(lines)
+
+
+def load_all_blocks_for_docs() -> list[BlockDoc]:
+    """Load all blocks and extract documentation."""
+    from backend.blocks import load_all_blocks
+
+    block_classes = load_all_blocks()
+    blocks = []
+
+    for _block_id, block_cls in block_classes.items():
+        try:
+            block_doc = extract_block_doc(block_cls)
+            blocks.append(block_doc)
+        except Exception as e:
+            logger.warning(f"Failed to extract docs for {block_cls.__name__}: {e}")
+
+    return blocks
+
+
+def write_block_docs(
+    output_dir: Path,
+    blocks: list[BlockDoc],
+    verbose: bool = False,
+) -> dict[str, str]:
+    """
+    Write block documentation files.
+
+    Returns dict of {file_path: content} for all generated files.
+    """
+    output_dir = Path(output_dir)
+    output_dir.mkdir(parents=True, exist_ok=True)
+
+    file_mapping = get_block_file_mapping(blocks)
+    generated_files = {}
+
+    for file_path, file_blocks in file_mapping.items():
+        full_path = output_dir / file_path
+
+        # Create subdirectories if needed
+        full_path.parent.mkdir(parents=True, exist_ok=True)
+
+        # Load existing content for manual section preservation
+        existing_content = ""
+        if full_path.exists():
+            existing_content = full_path.read_text()
+
+        # Always generate title from file path (with fixes applied)
+        file_title = file_path_to_title(file_path)
+
+        # Extract existing file description if present (preserve manual content)
+        file_header_pattern = (
+            r"^# .+?\n<!-- MANUAL: file_description -->\n(.*?)\n<!-- END MANUAL -->"
+        )
+        file_header_match = re.search(file_header_pattern, existing_content, re.DOTALL)
+
+        if file_header_match:
+            file_description = file_header_match.group(1)
+        else:
+            file_description = "_Add a description of this category of blocks._"
+
+        # Generate file header
+        file_header = f"# {file_title}\n"
+        file_header += "<!-- MANUAL: file_description -->\n"
+        file_header += f"{file_description}\n"
+        file_header += "<!-- END MANUAL -->\n"
+
+        # Generate content for each block
+        content_parts = []
+        for block in sorted(file_blocks, key=lambda b: b.name):
+            # Extract manual content specific to this block
+            # Match block heading (h2) and capture until --- separator
+            block_pattern = rf"(?:^|\n)## {re.escape(block.name)}\s*\n(.*?)(?=\n---|\Z)"
+            block_match = re.search(block_pattern, existing_content, re.DOTALL)
+            if block_match:
+                manual_content = extract_manual_content(block_match.group(1))
+            else:
+                manual_content = {}
+
+            content_parts.append(
+                generate_block_markdown(
+                    block,
+                    manual_content,
+                )
+            )
+
+        full_content = file_header + "\n" + "\n".join(content_parts)
+        generated_files[str(file_path)] = full_content
+
+        if verbose:
+            print(f"  Writing {file_path} ({len(file_blocks)} blocks)")
+
+        full_path.write_text(full_content)
+
+    # Generate overview file
+    overview_content = generate_overview_table(blocks)
+    overview_path = output_dir / "README.md"
+    generated_files["README.md"] = overview_content
+    overview_path.write_text(overview_content)
+
+    if verbose:
+        print("  Writing README.md (overview)")
+
+    return generated_files
+
+
+def check_docs_in_sync(output_dir: Path, blocks: list[BlockDoc]) -> bool:
+    """
+    Check if generated docs match existing docs.
+
+    Returns True if in sync, False otherwise.
+    """
+    output_dir = Path(output_dir)
+    file_mapping = get_block_file_mapping(blocks)
+
+    all_match = True
+    out_of_sync_details: list[tuple[str, list[str]]] = []
+
+    for file_path, file_blocks in file_mapping.items():
+        full_path = output_dir / file_path
+
+        if not full_path.exists():
+            block_names = [b.name for b in sorted(file_blocks, key=lambda b: b.name)]
+            print(f"MISSING: {file_path}")
+            print(f"  Blocks: {', '.join(block_names)}")
+            out_of_sync_details.append((file_path, block_names))
+            all_match = False
+            continue
+
+        existing_content = full_path.read_text()
+
+        # Always generate title from file path (with fixes applied)
+        file_title = file_path_to_title(file_path)
+
+        # Extract existing file description if present (preserve manual content)
+        file_header_pattern = (
+            r"^# .+?\n<!-- MANUAL: file_description -->\n(.*?)\n<!-- END MANUAL -->"
+        )
+        file_header_match = re.search(file_header_pattern, existing_content, re.DOTALL)
+
+        if file_header_match:
+            file_description = file_header_match.group(1)
+        else:
+            file_description = "_Add a description of this category of blocks._"
+
+        # Generate expected file header
+        file_header = f"# {file_title}\n"
+        file_header += "<!-- MANUAL: file_description -->\n"
+        file_header += f"{file_description}\n"
+        file_header += "<!-- END MANUAL -->\n"
+
+        # Extract manual content from existing file
+        manual_sections_by_block = {}
+        for block in file_blocks:
+            block_pattern = rf"(?:^|\n)## {re.escape(block.name)}\s*\n(.*?)(?=\n---|\Z)"
+            block_match = re.search(block_pattern, existing_content, re.DOTALL)
+            if block_match:
+                manual_sections_by_block[block.name] = extract_manual_content(
+                    block_match.group(1)
+                )
+
+        # Generate expected content and check each block individually
+        content_parts = []
+        mismatched_blocks = []
+        for block in sorted(file_blocks, key=lambda b: b.name):
+            manual_content = manual_sections_by_block.get(block.name, {})
+            expected_block_content = generate_block_markdown(
+                block,
+                manual_content,
+            )
+            content_parts.append(expected_block_content)
+
+            # Check if this specific block's section exists and matches
+            # Include the --- separator to match generate_block_markdown output
+            block_pattern = rf"(?:^|\n)(## {re.escape(block.name)}\s*\n.*?\n---\n)"
+            block_match = re.search(block_pattern, existing_content, re.DOTALL)
+            if not block_match:
+                mismatched_blocks.append(f"{block.name} (missing)")
+            elif block_match.group(1).strip() != expected_block_content.strip():
+                mismatched_blocks.append(block.name)
+
+        expected_content = file_header + "\n" + "\n".join(content_parts)
+
+        if existing_content.strip() != expected_content.strip():
+            print(f"OUT OF SYNC: {file_path}")
+            if mismatched_blocks:
+                print(f"  Affected blocks: {', '.join(mismatched_blocks)}")
+            out_of_sync_details.append((file_path, mismatched_blocks))
+            all_match = False
+
+    # Check overview
+    overview_path = output_dir / "README.md"
+    if overview_path.exists():
+        existing_overview = overview_path.read_text()
+        expected_overview = generate_overview_table(blocks)
+        if existing_overview.strip() != expected_overview.strip():
+            print("OUT OF SYNC: README.md (overview)")
+            print("  The blocks overview table needs regeneration")
+            out_of_sync_details.append(("README.md", ["overview table"]))
+            all_match = False
+    else:
+        print("MISSING: README.md (overview)")
+        out_of_sync_details.append(("README.md", ["overview table"]))
+        all_match = False
+
+    # Check for unfilled manual sections
+    unfilled_patterns = [
+        "_Add a description of this category of blocks._",
+        "_Add technical explanation here._",
+        "_Add practical use case examples here._",
+    ]
+    files_with_unfilled = []
+    for file_path in file_mapping.keys():
+        full_path = output_dir / file_path
+        if full_path.exists():
+            content = full_path.read_text()
+            unfilled_count = sum(1 for p in unfilled_patterns if p in content)
+            if unfilled_count > 0:
+                files_with_unfilled.append((file_path, unfilled_count))
+
+    if files_with_unfilled:
+        print("\nWARNING: Files with unfilled manual sections:")
+        for file_path, count in sorted(files_with_unfilled):
+            print(f"  {file_path}: {count} unfilled section(s)")
+        print(
+            f"\nTotal: {len(files_with_unfilled)} files with unfilled manual sections"
+        )
+
+    return all_match
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Generate block documentation from code introspection"
+    )
+    parser.add_argument(
+        "--output-dir",
+        type=Path,
+        default=DEFAULT_OUTPUT_DIR,
+        help="Output directory for generated docs",
+    )
+    parser.add_argument(
+        "--check",
+        action="store_true",
+        help="Check if docs are in sync (for CI), exit 1 if not",
+    )
+    parser.add_argument(
+        "-v",
+        "--verbose",
+        action="store_true",
+        help="Verbose output",
+    )
+
+    args = parser.parse_args()
+
+    logging.basicConfig(
+        level=logging.DEBUG if args.verbose else logging.INFO,
+        format="%(levelname)s: %(message)s",
+    )
+
+    print("Loading blocks...")
+    blocks = load_all_blocks_for_docs()
+    print(f"Found {len(blocks)} blocks")
+
+    if args.check:
+        print(f"Checking docs in {args.output_dir}...")
+        in_sync = check_docs_in_sync(args.output_dir, blocks)
+        if in_sync:
+            print("All documentation is in sync!")
+            sys.exit(0)
+        else:
+            print("\n" + "=" * 60)
+            print("Documentation is out of sync!")
+            print("=" * 60)
+            print("\nTo fix this, run one of the following:")
+            print("\n  Option 1 - Run locally:")
+            print(
+                "    cd autogpt_platform/backend && poetry run python scripts/generate_block_docs.py"
+            )
+            print("\n  Option 2 - Ask Claude Code to run it:")
+            print('    "Run the block docs generator script to sync documentation"')
+            print("\n" + "=" * 60)
+            sys.exit(1)
+    else:
+        print(f"Generating docs to {args.output_dir}...")
+        write_block_docs(
+            args.output_dir,
+            blocks,
+            verbose=args.verbose,
+        )
+        print("Done!")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/autogpt_platform/backend/scripts/test_generate_block_docs.py b/autogpt_platform/backend/scripts/test_generate_block_docs.py
new file mode 100644
index 0000000000..a6d6d34992
--- /dev/null
+++ b/autogpt_platform/backend/scripts/test_generate_block_docs.py
@@ -0,0 +1,208 @@
+#!/usr/bin/env python3
+"""Tests for the block documentation generator."""
+import pytest
+
+from scripts.generate_block_docs import (
+    class_name_to_display_name,
+    extract_manual_content,
+    generate_anchor,
+    type_to_readable,
+)
+
+
+class TestClassNameToDisplayName:
+    """Tests for class_name_to_display_name function."""
+
+    def test_simple_block_name(self):
+        assert class_name_to_display_name("PrintBlock") == "Print"
+
+    def test_multi_word_block_name(self):
+        assert class_name_to_display_name("GetWeatherBlock") == "Get Weather"
+
+    def test_consecutive_capitals(self):
+        assert class_name_to_display_name("HTTPRequestBlock") == "HTTP Request"
+
+    def test_ai_prefix(self):
+        assert class_name_to_display_name("AIConditionBlock") == "AI Condition"
+
+    def test_no_block_suffix(self):
+        assert class_name_to_display_name("SomeClass") == "Some Class"
+
+
+class TestTypeToReadable:
+    """Tests for type_to_readable function."""
+
+    def test_string_type(self):
+        assert type_to_readable({"type": "string"}) == "str"
+
+    def test_integer_type(self):
+        assert type_to_readable({"type": "integer"}) == "int"
+
+    def test_number_type(self):
+        assert type_to_readable({"type": "number"}) == "float"
+
+    def test_boolean_type(self):
+        assert type_to_readable({"type": "boolean"}) == "bool"
+
+    def test_array_type(self):
+        result = type_to_readable({"type": "array", "items": {"type": "string"}})
+        assert result == "List[str]"
+
+    def test_object_type(self):
+        result = type_to_readable({"type": "object", "title": "MyModel"})
+        assert result == "MyModel"
+
+    def test_anyof_with_null(self):
+        result = type_to_readable({"anyOf": [{"type": "string"}, {"type": "null"}]})
+        assert result == "str"
+
+    def test_anyof_multiple_types(self):
+        result = type_to_readable({"anyOf": [{"type": "string"}, {"type": "integer"}]})
+        assert result == "str | int"
+
+    def test_enum_type(self):
+        result = type_to_readable(
+            {"type": "string", "enum": ["option1", "option2", "option3"]}
+        )
+        assert result == '"option1" | "option2" | "option3"'
+
+    def test_none_input(self):
+        assert type_to_readable(None) == "Any"
+
+    def test_non_dict_input(self):
+        assert type_to_readable("string") == "string"
+
+
+class TestExtractManualContent:
+    """Tests for extract_manual_content function."""
+
+    def test_extract_how_it_works(self):
+        content = """
+### How it works
+<!-- MANUAL: how_it_works -->
+This is how it works.
+<!-- END MANUAL -->
+"""
+        result = extract_manual_content(content)
+        assert result == {"how_it_works": "This is how it works."}
+
+    def test_extract_use_case(self):
+        content = """
+### Possible use case
+<!-- MANUAL: use_case -->
+Example use case here.
+<!-- END MANUAL -->
+"""
+        result = extract_manual_content(content)
+        assert result == {"use_case": "Example use case here."}
+
+    def test_extract_multiple_sections(self):
+        content = """
+<!-- MANUAL: how_it_works -->
+How it works content.
+<!-- END MANUAL -->
+
+<!-- MANUAL: use_case -->
+Use case content.
+<!-- END MANUAL -->
+"""
+        result = extract_manual_content(content)
+        assert result == {
+            "how_it_works": "How it works content.",
+            "use_case": "Use case content.",
+        }
+
+    def test_empty_content(self):
+        result = extract_manual_content("")
+        assert result == {}
+
+    def test_no_markers(self):
+        result = extract_manual_content("Some content without markers")
+        assert result == {}
+
+
+class TestGenerateAnchor:
+    """Tests for generate_anchor function."""
+
+    def test_simple_name(self):
+        assert generate_anchor("Print") == "print"
+
+    def test_multi_word_name(self):
+        assert generate_anchor("Get Weather") == "get-weather"
+
+    def test_name_with_parentheses(self):
+        assert generate_anchor("Something (Optional)") == "something-optional"
+
+    def test_already_lowercase(self):
+        assert generate_anchor("already lowercase") == "already-lowercase"
+
+
+class TestIntegration:
+    """Integration tests that require block loading."""
+
+    def test_load_blocks(self):
+        """Test that blocks can be loaded successfully."""
+        import logging
+        import sys
+        from pathlib import Path
+
+        logging.disable(logging.CRITICAL)
+        sys.path.insert(0, str(Path(__file__).parent.parent))
+
+        from scripts.generate_block_docs import load_all_blocks_for_docs
+
+        blocks = load_all_blocks_for_docs()
+        assert len(blocks) > 0, "Should load at least one block"
+
+    def test_block_doc_has_required_fields(self):
+        """Test that extracted block docs have required fields."""
+        import logging
+        import sys
+        from pathlib import Path
+
+        logging.disable(logging.CRITICAL)
+        sys.path.insert(0, str(Path(__file__).parent.parent))
+
+        from scripts.generate_block_docs import load_all_blocks_for_docs
+
+        blocks = load_all_blocks_for_docs()
+        block = blocks[0]
+
+        assert hasattr(block, "id")
+        assert hasattr(block, "name")
+        assert hasattr(block, "description")
+        assert hasattr(block, "categories")
+        assert hasattr(block, "inputs")
+        assert hasattr(block, "outputs")
+
+    def test_file_mapping_is_deterministic(self):
+        """Test that file mapping produces consistent results."""
+        import logging
+        import sys
+        from pathlib import Path
+
+        logging.disable(logging.CRITICAL)
+        sys.path.insert(0, str(Path(__file__).parent.parent))
+
+        from scripts.generate_block_docs import (
+            get_block_file_mapping,
+            load_all_blocks_for_docs,
+        )
+
+        # Load blocks twice and compare mappings
+        blocks1 = load_all_blocks_for_docs()
+        blocks2 = load_all_blocks_for_docs()
+
+        mapping1 = get_block_file_mapping(blocks1)
+        mapping2 = get_block_file_mapping(blocks2)
+
+        # Check same files are generated
+        assert set(mapping1.keys()) == set(mapping2.keys())
+
+        # Check same block counts per file
+        for file_path in mapping1:
+            assert len(mapping1[file_path]) == len(mapping2[file_path])
+
+
+if __name__ == "__main__":
+    pytest.main([__file__, "-v"])
diff --git a/autogpt_platform/backend/snapshots/grph_single b/autogpt_platform/backend/snapshots/grph_single
index 7ba26f6171..7ce8695e6b 100644
--- a/autogpt_platform/backend/snapshots/grph_single
+++ b/autogpt_platform/backend/snapshots/grph_single
@@ -2,6 +2,7 @@
   "created_at": "2025-09-04T13:37:00",
   "credentials_input_schema": {
     "properties": {},
+    "required": [],
     "title": "TestGraphCredentialsInputSchema",
     "type": "object"
   },
diff --git a/autogpt_platform/backend/snapshots/grphs_all b/autogpt_platform/backend/snapshots/grphs_all
index d54df2bc18..f69b45a6de 100644
--- a/autogpt_platform/backend/snapshots/grphs_all
+++ b/autogpt_platform/backend/snapshots/grphs_all
@@ -2,6 +2,7 @@
   {
     "credentials_input_schema": {
       "properties": {},
+      "required": [],
       "title": "TestGraphCredentialsInputSchema",
       "type": "object"
     },
diff --git a/autogpt_platform/backend/snapshots/lib_agts_search b/autogpt_platform/backend/snapshots/lib_agts_search
index d1feb7d16d..c8e3cc73a6 100644
--- a/autogpt_platform/backend/snapshots/lib_agts_search
+++ b/autogpt_platform/backend/snapshots/lib_agts_search
@@ -4,6 +4,7 @@
       "id": "test-agent-1",
       "graph_id": "test-agent-1",
       "graph_version": 1,
+      "owner_user_id": "3e53486c-cf57-477e-ba2a-cb02dc828e1a",
       "image_url": null,
       "creator_name": "Test Creator",
       "creator_image_url": "",
@@ -41,6 +42,7 @@
       "id": "test-agent-2",
       "graph_id": "test-agent-2",
       "graph_version": 1,
+      "owner_user_id": "3e53486c-cf57-477e-ba2a-cb02dc828e1a",
       "image_url": null,
       "creator_name": "Test Creator",
       "creator_image_url": "",
diff --git a/autogpt_platform/backend/snapshots/sub_success b/autogpt_platform/backend/snapshots/sub_success
index 13e2ec570d..268d577745 100644
--- a/autogpt_platform/backend/snapshots/sub_success
+++ b/autogpt_platform/backend/snapshots/sub_success
@@ -1,6 +1,7 @@
 {
   "submissions": [
     {
+      "listing_id": "test-listing-id",
       "agent_id": "test-agent-id",
       "agent_version": 1,
       "name": "Test Agent",
diff --git a/autogpt_platform/backend/test/blocks/test_google_docs_format_text_color.py b/autogpt_platform/backend/test/blocks/test_google_docs_format_text_color.py
new file mode 100644
index 0000000000..6a6e8e07c8
--- /dev/null
+++ b/autogpt_platform/backend/test/blocks/test_google_docs_format_text_color.py
@@ -0,0 +1,113 @@
+from unittest.mock import Mock
+
+from backend.blocks.google.docs import GoogleDocsFormatTextBlock
+
+
+def _make_mock_docs_service() -> Mock:
+    service = Mock()
+    # Ensure chained call exists: service.documents().batchUpdate(...).execute()
+    service.documents.return_value.batchUpdate.return_value.execute.return_value = {}
+    return service
+
+
+def test_format_text_parses_shorthand_hex_color():
+    block = GoogleDocsFormatTextBlock()
+    service = _make_mock_docs_service()
+
+    result = block._format_text(
+        service,
+        document_id="doc_1",
+        start_index=1,
+        end_index=2,
+        bold=False,
+        italic=False,
+        underline=False,
+        font_size=0,
+        foreground_color="#FFF",
+    )
+
+    assert result["success"] is True
+
+    # Verify request body contains correct rgbColor for white.
+    _, kwargs = service.documents.return_value.batchUpdate.call_args
+    requests = kwargs["body"]["requests"]
+    rgb = requests[0]["updateTextStyle"]["textStyle"]["foregroundColor"]["color"][
+        "rgbColor"
+    ]
+    assert rgb == {"red": 1.0, "green": 1.0, "blue": 1.0}
+
+
+def test_format_text_parses_full_hex_color():
+    block = GoogleDocsFormatTextBlock()
+    service = _make_mock_docs_service()
+
+    result = block._format_text(
+        service,
+        document_id="doc_1",
+        start_index=1,
+        end_index=2,
+        bold=False,
+        italic=False,
+        underline=False,
+        font_size=0,
+        foreground_color="#FF0000",
+    )
+
+    assert result["success"] is True
+
+    _, kwargs = service.documents.return_value.batchUpdate.call_args
+    requests = kwargs["body"]["requests"]
+    rgb = requests[0]["updateTextStyle"]["textStyle"]["foregroundColor"]["color"][
+        "rgbColor"
+    ]
+    assert rgb == {"red": 1.0, "green": 0.0, "blue": 0.0}
+
+
+def test_format_text_ignores_invalid_color_when_other_fields_present():
+    block = GoogleDocsFormatTextBlock()
+    service = _make_mock_docs_service()
+
+    result = block._format_text(
+        service,
+        document_id="doc_1",
+        start_index=1,
+        end_index=2,
+        bold=True,
+        italic=False,
+        underline=False,
+        font_size=0,
+        foreground_color="#GGG",
+    )
+
+    assert result["success"] is True
+    assert "warning" in result
+
+    # Should still apply bold, but should NOT include foregroundColor in textStyle.
+    _, kwargs = service.documents.return_value.batchUpdate.call_args
+    requests = kwargs["body"]["requests"]
+    text_style = requests[0]["updateTextStyle"]["textStyle"]
+    fields = requests[0]["updateTextStyle"]["fields"]
+
+    assert text_style == {"bold": True}
+    assert fields == "bold"
+
+
+def test_format_text_invalid_color_only_does_not_call_api():
+    block = GoogleDocsFormatTextBlock()
+    service = _make_mock_docs_service()
+
+    result = block._format_text(
+        service,
+        document_id="doc_1",
+        start_index=1,
+        end_index=2,
+        bold=False,
+        italic=False,
+        underline=False,
+        font_size=0,
+        foreground_color="#F",
+    )
+
+    assert result["success"] is False
+    assert "Invalid foreground_color" in result["message"]
+    service.documents.return_value.batchUpdate.assert_not_called()
diff --git a/autogpt_platform/backend/test/blocks/test_youtube.py b/autogpt_platform/backend/test/blocks/test_youtube.py
index 1af7c31b9b..4d3bd9d800 100644
--- a/autogpt_platform/backend/test/blocks/test_youtube.py
+++ b/autogpt_platform/backend/test/blocks/test_youtube.py
@@ -37,6 +37,18 @@ class TestTranscribeYoutubeVideoBlock:
         video_id = self.youtube_block.extract_video_id(url)
         assert video_id == "dQw4w9WgXcQ"
 
+    def test_extract_video_id_shorts_url(self):
+        """Test extracting video ID from YouTube Shorts URL."""
+        url = "https://www.youtube.com/shorts/dtUqwMu3e-g"
+        video_id = self.youtube_block.extract_video_id(url)
+        assert video_id == "dtUqwMu3e-g"
+
+    def test_extract_video_id_shorts_url_with_params(self):
+        """Test extracting video ID from YouTube Shorts URL with query parameters."""
+        url = "https://www.youtube.com/shorts/dtUqwMu3e-g?feature=share"
+        video_id = self.youtube_block.extract_video_id(url)
+        assert video_id == "dtUqwMu3e-g"
+
     @patch("backend.blocks.youtube.YouTubeTranscriptApi")
     def test_get_transcript_english_available(self, mock_api_class):
         """Test getting transcript when English is available."""
diff --git a/autogpt_platform/cloudflare_worker.js b/autogpt_platform/cloudflare_worker.js
new file mode 100644
index 0000000000..15e26a301d
--- /dev/null
+++ b/autogpt_platform/cloudflare_worker.js
@@ -0,0 +1,146 @@
+/**
+ * Cloudflare Workers Script for docs.agpt.co → agpt.co/docs migration
+ * 
+ * Deploy this script to handle all redirects with a single JavaScript file.
+ * No rule limits, easy to maintain, handles all edge cases.
+ */
+
+// URL mapping for special cases that don't follow patterns
+const SPECIAL_MAPPINGS = {
+  // Root page
+  '/': '/docs/platform',
+  
+  // Special cases that don't follow standard patterns
+  '/platform/d_id/': '/docs/integrations/block-integrations/d-id',
+  '/platform/blocks/blocks/': '/docs/integrations',
+  '/platform/blocks/decoder_block/': '/docs/integrations/block-integrations/text-decoder',
+  '/platform/blocks/http': '/docs/integrations/block-integrations/send-web-request',
+  '/platform/blocks/llm/': '/docs/integrations/block-integrations/ai-and-llm',
+  '/platform/blocks/time_blocks': '/docs/integrations/block-integrations/time-and-date',
+  '/platform/blocks/text_to_speech_block': '/docs/integrations/block-integrations/text-to-speech',
+  '/platform/blocks/ai_shortform_video_block': '/docs/integrations/block-integrations/ai-shortform-video',
+  '/platform/blocks/replicate_flux_advanced': '/docs/integrations/block-integrations/replicate-flux-advanced',
+  '/platform/blocks/flux_kontext': '/docs/integrations/block-integrations/flux-kontext',
+  '/platform/blocks/ai_condition/': '/docs/integrations/block-integrations/ai-condition',
+  '/platform/blocks/email_block': '/docs/integrations/block-integrations/email',
+  '/platform/blocks/google_maps': '/docs/integrations/block-integrations/google-maps',
+  '/platform/blocks/google/gmail': '/docs/integrations/block-integrations/gmail',
+  '/platform/blocks/github/issues/': '/docs/integrations/block-integrations/github-issues',
+  '/platform/blocks/github/repo/': '/docs/integrations/block-integrations/github-repo',
+  '/platform/blocks/github/pull_requests': '/docs/integrations/block-integrations/github-pull-requests',
+  '/platform/blocks/twitter/twitter': '/docs/integrations/block-integrations/twitter',
+  '/classic/setup/': '/docs/classic/setup/setting-up-autogpt-classic',
+  '/code-of-conduct/': '/docs/classic/help-us-improve-autogpt/code-of-conduct',
+  '/contributing/': '/docs/classic/contributing',
+  '/contribute/': '/docs/contribute',
+  '/forge/components/introduction/': '/docs/classic/forge/introduction'
+};
+
+/**
+ * Transform path by replacing underscores with hyphens and removing trailing slashes
+ */
+function transformPath(path) {
+  return path.replace(/_/g, '-').replace(/\/$/, '');
+}
+
+/**
+ * Handle docs.agpt.co redirects
+ */
+function handleDocsRedirect(url) {
+  const pathname = url.pathname;
+  
+  // Check special mappings first
+  if (SPECIAL_MAPPINGS[pathname]) {
+    return `https://agpt.co${SPECIAL_MAPPINGS[pathname]}`;
+  }
+  
+  // Pattern-based redirects
+  
+  // Platform blocks: /platform/blocks/* → /docs/integrations/block-integrations/*
+  if (pathname.startsWith('/platform/blocks/')) {
+    const blockName = pathname.substring('/platform/blocks/'.length);
+    const transformedName = transformPath(blockName);
+    return `https://agpt.co/docs/integrations/block-integrations/${transformedName}`;
+  }
+  
+  // Platform contributing: /platform/contributing/* → /docs/platform/contributing/*
+  if (pathname.startsWith('/platform/contributing/')) {
+    const subPath = pathname.substring('/platform/contributing/'.length);
+    return `https://agpt.co/docs/platform/contributing/${subPath}`;
+  }
+  
+  // Platform general: /platform/* → /docs/platform/* (with underscore→hyphen)
+  if (pathname.startsWith('/platform/')) {
+    const subPath = pathname.substring('/platform/'.length);
+    const transformedPath = transformPath(subPath);
+    return `https://agpt.co/docs/platform/${transformedPath}`;
+  }
+  
+  // Forge components: /forge/components/* → /docs/classic/forge/introduction/*
+  if (pathname.startsWith('/forge/components/')) {
+    const subPath = pathname.substring('/forge/components/'.length);
+    return `https://agpt.co/docs/classic/forge/introduction/${subPath}`;
+  }
+  
+  // Forge general: /forge/* → /docs/classic/forge/*
+  if (pathname.startsWith('/forge/')) {
+    const subPath = pathname.substring('/forge/'.length);
+    return `https://agpt.co/docs/classic/forge/${subPath}`;
+  }
+  
+  // Classic: /classic/* → /docs/classic/*
+  if (pathname.startsWith('/classic/')) {
+    const subPath = pathname.substring('/classic/'.length);
+    return `https://agpt.co/docs/classic/${subPath}`;
+  }
+  
+  // Default fallback
+  return 'https://agpt.co/docs/';
+}
+
+/**
+ * Main Worker function
+ */
+export default {
+  async fetch(request, env, ctx) {
+    const url = new URL(request.url);
+    
+    // Only handle docs.agpt.co requests
+    if (url.hostname === 'docs.agpt.co') {
+      const redirectUrl = handleDocsRedirect(url);
+      
+      return new Response(null, {
+        status: 301,
+        headers: {
+          'Location': redirectUrl,
+          'Cache-Control': 'max-age=300' // Cache redirects for 5 minutes
+        }
+      });
+    }
+    
+    // For non-docs requests, pass through or return 404
+    return new Response('Not Found', { status: 404 });
+  }
+};
+
+// Test function for local development
+export function testRedirects() {
+  const testCases = [
+    'https://docs.agpt.co/',
+    'https://docs.agpt.co/platform/getting-started/',
+    'https://docs.agpt.co/platform/advanced_setup/',
+    'https://docs.agpt.co/platform/blocks/basic/',
+    'https://docs.agpt.co/platform/blocks/ai_condition/',
+    'https://docs.agpt.co/classic/setup/',
+    'https://docs.agpt.co/forge/components/agents/',
+    'https://docs.agpt.co/contributing/',
+    'https://docs.agpt.co/unknown-page'
+  ];
+  
+  console.log('Testing redirects:');
+  testCases.forEach(testUrl => {
+    const url = new URL(testUrl);
+    const result = handleDocsRedirect(url);
+    console.log(`${testUrl} → ${result}`);
+  });
+}
\ No newline at end of file
diff --git a/autogpt_platform/docker-compose.platform.yml b/autogpt_platform/docker-compose.platform.yml
index b2df626029..de6ecfd612 100644
--- a/autogpt_platform/docker-compose.platform.yml
+++ b/autogpt_platform/docker-compose.platform.yml
@@ -37,7 +37,7 @@ services:
       context: ../
       dockerfile: autogpt_platform/backend/Dockerfile
       target: migrate
-    command: ["sh", "-c", "poetry run prisma generate && poetry run prisma migrate deploy"]
+    command: ["sh", "-c", "poetry run prisma generate && poetry run gen-prisma-stub && poetry run prisma migrate deploy"]
     develop:
       watch:
         - path: ./
diff --git a/autogpt_platform/frontend/CONTRIBUTING.md b/autogpt_platform/frontend/CONTRIBUTING.md
index 048c088350..1b2b810986 100644
--- a/autogpt_platform/frontend/CONTRIBUTING.md
+++ b/autogpt_platform/frontend/CONTRIBUTING.md
@@ -708,10 +708,7 @@ export function CreateButton() {
 
 ## 🧪 Testing & Storybook
 
-- End-to-end: [Playwright](https://playwright.dev/docs/intro) (`pnpm test`, `pnpm test-ui`)
-- [Storybook](https://storybook.js.org/docs) for isolated UI development (`pnpm storybook` / `pnpm build-storybook`)
-- For Storybook tests in CI, see [`@storybook/test-runner`](https://storybook.js.org/docs/writing-tests/test-runner) (`test-storybook:ci`)
-- When changing components in `src/components`, update or add stories and visually verify in Storybook/Chromatic
+- See `TESTING.md` for Playwright setup, E2E data seeding, and Storybook usage.
 
 ---
 
diff --git a/autogpt_platform/frontend/README.md b/autogpt_platform/frontend/README.md
index f4541cdd33..abea810fd2 100644
--- a/autogpt_platform/frontend/README.md
+++ b/autogpt_platform/frontend/README.md
@@ -5,6 +5,7 @@ This is the frontend for AutoGPT's next generation
 This project uses [**pnpm**](https://pnpm.io/) as the package manager via **corepack**. [Corepack](https://github.com/nodejs/corepack) is a Node.js tool that automatically manages package managers without requiring global installations.
 
 For architecture, conventions, data fetching, feature flags, design system usage, state management, and PR process, see [CONTRIBUTING.md](./CONTRIBUTING.md).
+For Playwright and Storybook testing setup, see [TESTING.md](./TESTING.md).
 
 ### Prerequisites
 
diff --git a/autogpt_platform/frontend/TESTING.md b/autogpt_platform/frontend/TESTING.md
new file mode 100644
index 0000000000..2995295c96
--- /dev/null
+++ b/autogpt_platform/frontend/TESTING.md
@@ -0,0 +1,57 @@
+# Frontend Testing 🧪
+
+## Quick Start (local) 🚀
+
+1. Start the backend + Supabase stack:
+   - From `autogpt_platform`: `docker compose --profile local up deps_backend -d`
+   - Or run the full stack: `docker compose up -d`
+2. Seed rich E2E data (creates `test123@gmail.com` with library agents):
+   - From `autogpt_platform/backend`: `poetry run python test/e2e_test_data.py`
+3. Run Playwright:
+   - From `autogpt_platform/frontend`: `pnpm test` or `pnpm test-ui`
+
+## How Playwright setup works 🎭
+
+- Playwright runs from `frontend/playwright.config.ts` with a global setup step.
+- The global setup creates a user pool via the real signup UI and stores it in `frontend/.auth/user-pool.json`.
+- Most tests call `getTestUser()` (from `src/tests/utils/auth.ts`) which pulls a random user from that pool.
+  - these users do not contain library agents, it's user that just "signed up" on the platform, hence some tests to make use of users created via script (see below) with more data
+
+## Test users 👤
+
+- **User pool (basic users)**  
+  Created automatically by the Playwright global setup through `/signup`.  
+  Used by `getTestUser()` in `src/tests/utils/auth.ts`.
+
+- **Rich user with library agents**  
+  Created by `backend/test/e2e_test_data.py`.  
+  Accessed via `getTestUserWithLibraryAgents()` in `src/tests/credentials/index.ts`.
+
+Use the rich user when a test needs existing library agents (e.g. `library.spec.ts`).
+
+## Resetting or wiping the DB 🔁
+
+If you reset the Docker DB and logins start failing:
+
+1. Delete `frontend/.auth/user-pool.json` so the pool is regenerated.
+2. Re-run the E2E data script to recreate the rich user + library agents:
+   - `poetry run python test/e2e_test_data.py`
+
+## Storybook 📚
+
+## Flow diagram 🗺️
+
+```mermaid
+flowchart TD
+  A[Start Docker stack] --> B[Run e2e_test_data.py]
+  B --> C[Run Playwright tests]
+  C --> D[Global setup creates user pool]
+  D --> E{Test needs rich data?}
+  E -->|No| F[getTestUser from user pool]
+  E -->|Yes| G[getTestUserWithLibraryAgents]
+```
+
+- `pnpm storybook` – Run Storybook locally
+- `pnpm build-storybook` – Build a static Storybook
+- CI runner: `pnpm test-storybook`
+- When changing components in `src/components`, update or add stories and verify in Storybook/Chromatic.
diff --git a/autogpt_platform/frontend/next.config.mjs b/autogpt_platform/frontend/next.config.mjs
index e4e4cdf544..bb4410039d 100644
--- a/autogpt_platform/frontend/next.config.mjs
+++ b/autogpt_platform/frontend/next.config.mjs
@@ -3,6 +3,13 @@ import { withSentryConfig } from "@sentry/nextjs";
 /** @type {import('next').NextConfig} */
 const nextConfig = {
   productionBrowserSourceMaps: true,
+  // Externalize OpenTelemetry packages to fix Turbopack HMR issues
+  serverExternalPackages: [
+    "@opentelemetry/instrumentation",
+    "@opentelemetry/sdk-node",
+    "import-in-the-middle",
+    "require-in-the-middle",
+  ],
   experimental: {
     serverActions: {
       bodySizeLimit: "256mb",
diff --git a/autogpt_platform/frontend/package.json b/autogpt_platform/frontend/package.json
index 4cbd867cd8..0823400c87 100644
--- a/autogpt_platform/frontend/package.json
+++ b/autogpt_platform/frontend/package.json
@@ -32,6 +32,7 @@
     "@hookform/resolvers": "5.2.2",
     "@next/third-parties": "15.4.6",
     "@phosphor-icons/react": "2.1.10",
+    "@radix-ui/react-accordion": "1.2.12",
     "@radix-ui/react-alert-dialog": "1.1.15",
     "@radix-ui/react-avatar": "1.1.10",
     "@radix-ui/react-checkbox": "1.3.3",
@@ -46,14 +47,15 @@
     "@radix-ui/react-scroll-area": "1.2.10",
     "@radix-ui/react-select": "2.2.6",
     "@radix-ui/react-separator": "1.1.7",
+    "@radix-ui/react-slider": "1.3.6",
     "@radix-ui/react-slot": "1.2.3",
     "@radix-ui/react-switch": "1.2.6",
     "@radix-ui/react-tabs": "1.1.13",
     "@radix-ui/react-toast": "1.2.15",
     "@radix-ui/react-tooltip": "1.2.8",
-    "@rjsf/core": "5.24.13",
-    "@rjsf/utils": "5.24.13",
-    "@rjsf/validator-ajv8": "5.24.13",
+    "@rjsf/core": "6.1.2",
+    "@rjsf/utils": "6.1.2",
+    "@rjsf/validator-ajv8": "6.1.2",
     "@sentry/nextjs": "10.27.0",
     "@supabase/ssr": "0.7.0",
     "@supabase/supabase-js": "2.78.0",
@@ -69,6 +71,7 @@
     "cmdk": "1.1.1",
     "cookie": "1.0.2",
     "date-fns": "4.1.0",
+    "dexie": "4.2.1",
     "dotenv": "17.2.3",
     "elliptic": "6.6.1",
     "embla-carousel-react": "8.6.0",
@@ -90,7 +93,6 @@
     "react-currency-input-field": "4.0.3",
     "react-day-picker": "9.11.1",
     "react-dom": "18.3.1",
-    "react-drag-drop-files": "2.4.0",
     "react-hook-form": "7.66.0",
     "react-icons": "5.5.0",
     "react-markdown": "9.0.3",
@@ -116,6 +118,7 @@
   },
   "devDependencies": {
     "@chromatic-com/storybook": "4.1.2",
+    "@opentelemetry/instrumentation": "0.209.0",
     "@playwright/test": "1.56.1",
     "@storybook/addon-a11y": "9.1.5",
     "@storybook/addon-docs": "9.1.5",
@@ -139,6 +142,7 @@
     "eslint": "8.57.1",
     "eslint-config-next": "15.5.7",
     "eslint-plugin-storybook": "9.1.5",
+    "import-in-the-middle": "2.0.2",
     "msw": "2.11.6",
     "msw-storybook-addon": "2.0.6",
     "orval": "7.13.0",
@@ -146,7 +150,7 @@
     "postcss": "8.5.6",
     "prettier": "3.6.2",
     "prettier-plugin-tailwindcss": "0.7.1",
-    "require-in-the-middle": "7.5.2",
+    "require-in-the-middle": "8.0.1",
     "storybook": "9.1.5",
     "tailwindcss": "3.4.17",
     "typescript": "5.9.3"
@@ -156,5 +160,10 @@
       "public"
     ]
   },
+  "pnpm": {
+    "overrides": {
+      "@opentelemetry/instrumentation": "0.209.0"
+    }
+  },
   "packageManager": "pnpm@10.20.0+sha512.cf9998222162dd85864d0a8102e7892e7ba4ceadebbf5a31f9c2fce48dfce317a9c53b9f6464d1ef9042cba2e02ae02a9f7c143a2b438cd93c91840f0192b9dd"
 }
diff --git a/autogpt_platform/frontend/pnpm-lock.yaml b/autogpt_platform/frontend/pnpm-lock.yaml
index 54843fc589..f503c23ea8 100644
--- a/autogpt_platform/frontend/pnpm-lock.yaml
+++ b/autogpt_platform/frontend/pnpm-lock.yaml
@@ -4,6 +4,9 @@ settings:
   autoInstallPeers: true
   excludeLinksFromLockfile: false
 
+overrides:
+  '@opentelemetry/instrumentation': 0.209.0
+
 importers:
 
   .:
@@ -16,10 +19,13 @@ importers:
         version: 5.2.2(react-hook-form@7.66.0(react@18.3.1))
       '@next/third-parties':
         specifier: 15.4.6
-        version: 15.4.6(next@15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react@18.3.1)
+        version: 15.4.6(next@15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react@18.3.1)
       '@phosphor-icons/react':
         specifier: 2.1.10
         version: 2.1.10(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@radix-ui/react-accordion':
+        specifier: 1.2.12
+        version: 1.2.12(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       '@radix-ui/react-alert-dialog':
         specifier: 1.1.15
         version: 1.1.15(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
@@ -62,6 +68,9 @@ importers:
       '@radix-ui/react-separator':
         specifier: 1.1.7
         version: 1.1.7(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@radix-ui/react-slider':
+        specifier: 1.3.6
+        version: 1.3.6(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       '@radix-ui/react-slot':
         specifier: 1.2.3
         version: 1.2.3(@types/react@18.3.17)(react@18.3.1)
@@ -78,17 +87,17 @@ importers:
         specifier: 1.2.8
         version: 1.2.8(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       '@rjsf/core':
-        specifier: 5.24.13
-        version: 5.24.13(@rjsf/utils@5.24.13(react@18.3.1))(react@18.3.1)
+        specifier: 6.1.2
+        version: 6.1.2(@rjsf/utils@6.1.2(react@18.3.1))(react@18.3.1)
       '@rjsf/utils':
-        specifier: 5.24.13
-        version: 5.24.13(react@18.3.1)
+        specifier: 6.1.2
+        version: 6.1.2(react@18.3.1)
       '@rjsf/validator-ajv8':
-        specifier: 5.24.13
-        version: 5.24.13(@rjsf/utils@5.24.13(react@18.3.1))
+        specifier: 6.1.2
+        version: 6.1.2(@rjsf/utils@6.1.2(react@18.3.1))
       '@sentry/nextjs':
         specifier: 10.27.0
-        version: 10.27.0(@opentelemetry/context-async-hooks@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/core@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/sdk-trace-base@2.2.0(@opentelemetry/api@1.9.0))(next@15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react@18.3.1)(webpack@5.101.3(esbuild@0.25.9))
+        version: 10.27.0(@opentelemetry/context-async-hooks@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/core@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/sdk-trace-base@2.2.0(@opentelemetry/api@1.9.0))(next@15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react@18.3.1)(webpack@5.104.1(esbuild@0.25.12))
       '@supabase/ssr':
         specifier: 0.7.0
         version: 0.7.0(@supabase/supabase-js@2.78.0)
@@ -106,13 +115,13 @@ importers:
         version: 0.2.4
       '@vercel/analytics':
         specifier: 1.5.0
-        version: 1.5.0(next@15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react@18.3.1)
+        version: 1.5.0(next@15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react@18.3.1)
       '@vercel/speed-insights':
         specifier: 1.2.0
-        version: 1.2.0(next@15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react@18.3.1)
+        version: 1.2.0(next@15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react@18.3.1)
       '@xyflow/react':
         specifier: 12.9.2
-        version: 12.9.2(@types/react@18.3.17)(immer@10.1.3)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+        version: 12.9.2(@types/react@18.3.17)(immer@11.1.3)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       boring-avatars:
         specifier: 1.11.2
         version: 1.11.2
@@ -131,6 +140,9 @@ importers:
       date-fns:
         specifier: 4.1.0
         version: 4.1.0
+      dexie:
+        specifier: 4.2.1
+        version: 4.2.1
       dotenv:
         specifier: 17.2.3
         version: 17.2.3
@@ -148,7 +160,7 @@ importers:
         version: 12.23.24(@emotion/is-prop-valid@1.2.2)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       geist:
         specifier: 1.5.1
-        version: 1.5.1(next@15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))
+        version: 1.5.1(next@15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))
       highlight.js:
         specifier: 11.11.1
         version: 11.11.1
@@ -172,13 +184,13 @@ importers:
         version: 2.30.1
       next:
         specifier: 15.4.10
-        version: 15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+        version: 15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       next-themes:
         specifier: 0.4.6
         version: 0.4.6(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       nuqs:
         specifier: 2.7.2
-        version: 2.7.2(next@15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react@18.3.1)
+        version: 2.7.2(next@15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react@18.3.1)
       party-js:
         specifier: 2.2.0
         version: 2.2.0
@@ -194,9 +206,6 @@ importers:
       react-dom:
         specifier: 18.3.1
         version: 18.3.1(react@18.3.1)
-      react-drag-drop-files:
-        specifier: 2.4.0
-        version: 2.4.0(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       react-hook-form:
         specifier: 7.66.0
         version: 7.66.0(react@18.3.1)
@@ -262,11 +271,14 @@ importers:
         version: 3.25.76
       zustand:
         specifier: 5.0.8
-        version: 5.0.8(@types/react@18.3.17)(immer@10.1.3)(react@18.3.1)(use-sync-external-store@1.5.0(react@18.3.1))
+        version: 5.0.8(@types/react@18.3.17)(immer@11.1.3)(react@18.3.1)(use-sync-external-store@1.6.0(react@18.3.1))
     devDependencies:
       '@chromatic-com/storybook':
         specifier: 4.1.2
         version: 4.1.2(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))
+      '@opentelemetry/instrumentation':
+        specifier: 0.209.0
+        version: 0.209.0(@opentelemetry/api@1.9.0)
       '@playwright/test':
         specifier: 1.56.1
         version: 1.56.1
@@ -284,7 +296,7 @@ importers:
         version: 9.1.5(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))
       '@storybook/nextjs':
         specifier: 9.1.5
-        version: 9.1.5(esbuild@0.25.9)(next@15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react-dom@18.3.1(react@18.3.1))(react@18.3.1)(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))(type-fest@4.41.0)(typescript@5.9.3)(webpack-hot-middleware@2.26.1)(webpack@5.101.3(esbuild@0.25.9))
+        version: 9.1.5(esbuild@0.25.12)(next@15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react-dom@18.3.1(react@18.3.1))(react@18.3.1)(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))(type-fest@4.41.0)(typescript@5.9.3)(webpack-hot-middleware@2.26.1)(webpack@5.104.1(esbuild@0.25.12))
       '@tanstack/eslint-plugin-query':
         specifier: 5.91.2
         version: 5.91.2(eslint@8.57.1)(typescript@5.9.3)
@@ -336,6 +348,9 @@ importers:
       eslint-plugin-storybook:
         specifier: 9.1.5
         version: 9.1.5(eslint@8.57.1)(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))(typescript@5.9.3)
+      import-in-the-middle:
+        specifier: 2.0.2
+        version: 2.0.2
       msw:
         specifier: 2.11.6
         version: 2.11.6(@types/node@24.10.0)(typescript@5.9.3)
@@ -358,8 +373,8 @@ importers:
         specifier: 0.7.1
         version: 0.7.1(prettier@3.6.2)
       require-in-the-middle:
-        specifier: 7.5.2
-        version: 7.5.2
+        specifier: 8.0.1
+        version: 8.0.1
       storybook:
         specifier: 9.1.5
         version: 9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2)
@@ -408,16 +423,16 @@ packages:
     resolution: {integrity: sha512-cjQ7ZlQ0Mv3b47hABuTevyTuYN4i+loJKGeV9flcCgIK37cCXRh+L1bd3iBHlynerhQ7BhCkn2BPbQUL+rGqFg==}
     engines: {node: '>=6.9.0'}
 
-  '@babel/compat-data@7.28.4':
-    resolution: {integrity: sha512-YsmSKC29MJwf0gF8Rjjrg5LQCmyh+j/nD8/eP7f+BeoQTKYqs9RoWbjGOdy0+1Ekr68RJZMUOPVQaQisnIo4Rw==}
+  '@babel/compat-data@7.28.5':
+    resolution: {integrity: sha512-6uFXyCayocRbqhZOB+6XcuZbkMNimwfVGFji8CTZnCzOHVGvDqzvitu1re2AU5LROliz7eQPhB8CpAMvnx9EjA==}
     engines: {node: '>=6.9.0'}
 
-  '@babel/core@7.28.4':
-    resolution: {integrity: sha512-2BCOP7TN8M+gVDj7/ht3hsaO/B/n5oDbiAyyvnRlNOs+u1o+JWNYTQrmpuNp1/Wq2gcFrI01JAW+paEKDMx/CA==}
+  '@babel/core@7.28.5':
+    resolution: {integrity: sha512-e7jT4DxYvIDLk1ZHmU/m/mB19rex9sv0c2ftBtjSBv+kVM/902eh0fINUzD7UwLLNR+jU585GxUJ8/EBfAM5fw==}
     engines: {node: '>=6.9.0'}
 
-  '@babel/generator@7.28.3':
-    resolution: {integrity: sha512-3lSpxGgvnmZznmBkCRnVREPUFJv2wrv9iAoFDvADJc0ypmdOxdUtcLeBgBJ6zE0PMeTKnxeQzyk0xTBq4Ep7zw==}
+  '@babel/generator@7.28.5':
+    resolution: {integrity: sha512-3EwLFhZ38J4VyIP6WNtt2kUdW9dokXA9Cr4IVIFHuCpZ3H8/YFOl5JjZHisrn1fATPBmKKqXzDFvh9fUwHz6CQ==}
     engines: {node: '>=6.9.0'}
 
   '@babel/helper-annotate-as-pure@7.27.3':
@@ -428,14 +443,14 @@ packages:
     resolution: {integrity: sha512-2+1thGUUWWjLTYTHZWK1n8Yga0ijBz1XAhUXcKy81rd5g6yh7hGqMp45v7cadSbEHc9G3OTv45SyneRN3ps4DQ==}
     engines: {node: '>=6.9.0'}
 
-  '@babel/helper-create-class-features-plugin@7.28.3':
-    resolution: {integrity: sha512-V9f6ZFIYSLNEbuGA/92uOvYsGCJNsuA8ESZ4ldc09bWk/j8H8TKiPw8Mk1eG6olpnO0ALHJmYfZvF4MEE4gajg==}
+  '@babel/helper-create-class-features-plugin@7.28.5':
+    resolution: {integrity: sha512-q3WC4JfdODypvxArsJQROfupPBq9+lMwjKq7C33GhbFYJsufD0yd/ziwD+hJucLeWsnFPWZjsU2DNFqBPE7jwQ==}
     engines: {node: '>=6.9.0'}
     peerDependencies:
       '@babel/core': ^7.0.0
 
-  '@babel/helper-create-regexp-features-plugin@7.27.1':
-    resolution: {integrity: sha512-uVDC72XVf8UbrH5qQTc18Agb8emwjTiZrQE11Nv3CuBEZmVvTwwE9CBUEvHku06gQCAyYf8Nv6ja1IN+6LMbxQ==}
+  '@babel/helper-create-regexp-features-plugin@7.28.5':
+    resolution: {integrity: sha512-N1EhvLtHzOvj7QQOUCCS3NrPJP8c5W6ZXCHDn7Yialuy1iu4r5EmIYkXlKNqT99Ciw+W0mDqWoR6HWMZlFP3hw==}
     engines: {node: '>=6.9.0'}
     peerDependencies:
       '@babel/core': ^7.0.0
@@ -449,8 +464,8 @@ packages:
     resolution: {integrity: sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==}
     engines: {node: '>=6.9.0'}
 
-  '@babel/helper-member-expression-to-functions@7.27.1':
-    resolution: {integrity: sha512-E5chM8eWjTp/aNoVpcbfM7mLxu9XGLWYise2eBKGQomAk/Mb4XoxyqXTZbuTohbsl8EKqdlMhnDI2CCLfcs9wA==}
+  '@babel/helper-member-expression-to-functions@7.28.5':
+    resolution: {integrity: sha512-cwM7SBRZcPCLgl8a7cY0soT1SptSzAlMH39vwiRpOQkJlh53r5hdHwLSCZpQdVLT39sZt+CRpNwYG4Y2v77atg==}
     engines: {node: '>=6.9.0'}
 
   '@babel/helper-module-imports@7.27.1':
@@ -491,8 +506,8 @@ packages:
     resolution: {integrity: sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==}
     engines: {node: '>=6.9.0'}
 
-  '@babel/helper-validator-identifier@7.27.1':
-    resolution: {integrity: sha512-D2hP9eA+Sqx1kBZgzxZh0y1trbuU+JoDkiEwqhQ36nodYqJwyEIhPSdMNd7lOm/4io72luTPWH20Yda0xOuUow==}
+  '@babel/helper-validator-identifier@7.28.5':
+    resolution: {integrity: sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==}
     engines: {node: '>=6.9.0'}
 
   '@babel/helper-validator-option@7.27.1':
@@ -507,13 +522,13 @@ packages:
     resolution: {integrity: sha512-HFN59MmQXGHVyYadKLVumYsA9dBFun/ldYxipEjzA4196jpLZd8UjEEBLkbEkvfYreDqJhZxYAWFPtrfhNpj4w==}
     engines: {node: '>=6.9.0'}
 
-  '@babel/parser@7.28.4':
-    resolution: {integrity: sha512-yZbBqeM6TkpP9du/I2pUZnJsRMGGvOuIrhjzC1AwHwW+6he4mni6Bp/m8ijn0iOuZuPI2BfkCoSRunpyjnrQKg==}
+  '@babel/parser@7.28.5':
+    resolution: {integrity: sha512-KKBU1VGYR7ORr3At5HAtUQ+TV3SzRCXmA/8OdDZiLDBIZxVyzXuztPjfLd3BV1PRAQGCMWWSHYhL0F8d5uHBDQ==}
     engines: {node: '>=6.0.0'}
     hasBin: true
 
-  '@babel/plugin-bugfix-firefox-class-in-computed-class-key@7.27.1':
-    resolution: {integrity: sha512-QPG3C9cCVRQLxAVwmefEmwdTanECuUBMQZ/ym5kiw3XKCGA7qkuQLcjWWHcrD/GKbn/WmJwaezfuuAOcyKlRPA==}
+  '@babel/plugin-bugfix-firefox-class-in-computed-class-key@7.28.5':
+    resolution: {integrity: sha512-87GDMS3tsmMSi/3bWOte1UblL+YUTFMV8SZPZ2eSEL17s74Cw/l63rR6NmGVKMYW2GYi85nE+/d6Hw5N0bEk2Q==}
     engines: {node: '>=6.9.0'}
     peerDependencies:
       '@babel/core': ^7.0.0
@@ -612,8 +627,8 @@ packages:
     peerDependencies:
       '@babel/core': ^7.0.0-0
 
-  '@babel/plugin-transform-block-scoping@7.28.4':
-    resolution: {integrity: sha512-1yxmvN0MJHOhPVmAsmoW5liWwoILobu/d/ShymZmj867bAdxGbehIrew1DuLpw2Ukv+qDSSPQdYW1dLNE7t11A==}
+  '@babel/plugin-transform-block-scoping@7.28.5':
+    resolution: {integrity: sha512-45DmULpySVvmq9Pj3X9B+62Xe+DJGov27QravQJU1LLcapR6/10i+gYVAucGGJpHBp5mYxIMK4nDAT/QDLr47g==}
     engines: {node: '>=6.9.0'}
     peerDependencies:
       '@babel/core': ^7.0.0-0
@@ -642,8 +657,8 @@ packages:
     peerDependencies:
       '@babel/core': ^7.0.0-0
 
-  '@babel/plugin-transform-destructuring@7.28.0':
-    resolution: {integrity: sha512-v1nrSMBiKcodhsyJ4Gf+Z0U/yawmJDBOTpEB3mcQY52r9RIyPneGyAS/yM6seP/8I+mWI3elOMtT5dB8GJVs+A==}
+  '@babel/plugin-transform-destructuring@7.28.5':
+    resolution: {integrity: sha512-Kl9Bc6D0zTUcFUvkNuQh4eGXPKKNDOJQXVyyM4ZAQPMveniJdxi8XMJwLo+xSoW3MIq81bD33lcUe9kZpl0MCw==}
     engines: {node: '>=6.9.0'}
     peerDependencies:
       '@babel/core': ^7.0.0-0
@@ -678,8 +693,8 @@ packages:
     peerDependencies:
       '@babel/core': ^7.0.0-0
 
-  '@babel/plugin-transform-exponentiation-operator@7.27.1':
-    resolution: {integrity: sha512-uspvXnhHvGKf2r4VVtBpeFnuDWsJLQ6MF6lGJLC89jBR1uoVeqM416AZtTuhTezOfgHicpJQmoD5YUakO/YmXQ==}
+  '@babel/plugin-transform-exponentiation-operator@7.28.5':
+    resolution: {integrity: sha512-D4WIMaFtwa2NizOp+dnoFjRez/ClKiC2BqqImwKd1X28nqBtZEyCYJ2ozQrrzlxAFrcrjxo39S6khe9RNDlGzw==}
     engines: {node: '>=6.9.0'}
     peerDependencies:
       '@babel/core': ^7.0.0-0
@@ -714,8 +729,8 @@ packages:
     peerDependencies:
       '@babel/core': ^7.0.0-0
 
-  '@babel/plugin-transform-logical-assignment-operators@7.27.1':
-    resolution: {integrity: sha512-SJvDs5dXxiae4FbSL1aBJlG4wvl594N6YEVVn9e3JGulwioy6z3oPjx/sQBO3Y4NwUu5HNix6KJ3wBZoewcdbw==}
+  '@babel/plugin-transform-logical-assignment-operators@7.28.5':
+    resolution: {integrity: sha512-axUuqnUTBuXyHGcJEVVh9pORaN6wC5bYfE7FGzPiaWa3syib9m7g+/IT/4VgCOe2Upef43PHzeAvcrVek6QuuA==}
     engines: {node: '>=6.9.0'}
     peerDependencies:
       '@babel/core': ^7.0.0-0
@@ -738,8 +753,8 @@ packages:
     peerDependencies:
       '@babel/core': ^7.0.0-0
 
-  '@babel/plugin-transform-modules-systemjs@7.27.1':
-    resolution: {integrity: sha512-w5N1XzsRbc0PQStASMksmUeqECuzKuTJer7kFagK8AXgpCMkeDMO5S+aaFb7A51ZYDF7XI34qsTX+fkHiIm5yA==}
+  '@babel/plugin-transform-modules-systemjs@7.28.5':
+    resolution: {integrity: sha512-vn5Jma98LCOeBy/KpeQhXcV2WZgaRUtjwQmjoBuLNlOmkg0fB5pdvYVeWRYI69wWKwK2cD1QbMiUQnoujWvrew==}
     engines: {node: '>=6.9.0'}
     peerDependencies:
       '@babel/core': ^7.0.0-0
@@ -792,8 +807,8 @@ packages:
     peerDependencies:
       '@babel/core': ^7.0.0-0
 
-  '@babel/plugin-transform-optional-chaining@7.27.1':
-    resolution: {integrity: sha512-BQmKPPIuc8EkZgNKsv0X4bPmOoayeu4F1YCwx2/CfmDSXDbp7GnzlUH+/ul5VGfRg1AoFPsrIThlEBj2xb4CAg==}
+  '@babel/plugin-transform-optional-chaining@7.28.5':
+    resolution: {integrity: sha512-N6fut9IZlPnjPwgiQkXNhb+cT8wQKFlJNqcZkWlcTqkcqx6/kU4ynGmLFoa4LViBSirn05YAwk+sQBbPfxtYzQ==}
     engines: {node: '>=6.9.0'}
     peerDependencies:
       '@babel/core': ^7.0.0-0
@@ -864,8 +879,8 @@ packages:
     peerDependencies:
       '@babel/core': ^7.0.0-0
 
-  '@babel/plugin-transform-runtime@7.28.3':
-    resolution: {integrity: sha512-Y6ab1kGqZ0u42Zv/4a7l0l72n9DKP/MKoKWaUSBylrhNZO2prYuqFOLbn5aW5SIFXwSH93yfjbgllL8lxuGKLg==}
+  '@babel/plugin-transform-runtime@7.28.5':
+    resolution: {integrity: sha512-20NUVgOrinudkIBzQ2bNxP08YpKprUkRTiRSd2/Z5GOdPImJGkoN4Z7IQe1T5AdyKI1i5L6RBmluqdSzvaq9/w==}
     engines: {node: '>=6.9.0'}
     peerDependencies:
       '@babel/core': ^7.0.0-0
@@ -900,8 +915,8 @@ packages:
     peerDependencies:
       '@babel/core': ^7.0.0-0
 
-  '@babel/plugin-transform-typescript@7.28.0':
-    resolution: {integrity: sha512-4AEiDEBPIZvLQaWlc9liCavE0xRM0dNca41WtBeM3jgFptfUOSG9z0uteLhq6+3rq+WB6jIvUwKDTpXEHPJ2Vg==}
+  '@babel/plugin-transform-typescript@7.28.5':
+    resolution: {integrity: sha512-x2Qa+v/CuEoX7Dr31iAfr0IhInrVOWZU/2vJMJ00FOR/2nM0BcBEclpaf9sWCDc+v5e9dMrhSH8/atq/kX7+bA==}
     engines: {node: '>=6.9.0'}
     peerDependencies:
       '@babel/core': ^7.0.0-0
@@ -930,8 +945,8 @@ packages:
     peerDependencies:
       '@babel/core': ^7.0.0
 
-  '@babel/preset-env@7.28.3':
-    resolution: {integrity: sha512-ROiDcM+GbYVPYBOeCR6uBXKkQpBExLl8k9HO1ygXEyds39j+vCCsjmj7S8GOniZQlEs81QlkdJZe76IpLSiqpg==}
+  '@babel/preset-env@7.28.5':
+    resolution: {integrity: sha512-S36mOoi1Sb6Fz98fBfE+UZSpYw5mJm0NUHtIKrOuNcqeFauy1J6dIvXm2KRVKobOSaGq4t/hBXdN4HGU3wL9Wg==}
     engines: {node: '>=6.9.0'}
     peerDependencies:
       '@babel/core': ^7.0.0-0
@@ -941,14 +956,14 @@ packages:
     peerDependencies:
       '@babel/core': ^7.0.0-0 || ^8.0.0-0 <8.0.0
 
-  '@babel/preset-react@7.27.1':
-    resolution: {integrity: sha512-oJHWh2gLhU9dW9HHr42q0cI0/iHHXTLGe39qvpAZZzagHy0MzYLCnCVV0symeRvzmjHyVU7mw2K06E6u/JwbhA==}
+  '@babel/preset-react@7.28.5':
+    resolution: {integrity: sha512-Z3J8vhRq7CeLjdC58jLv4lnZ5RKFUJWqH5emvxmv9Hv3BD1T9R/Im713R4MTKwvFaV74ejZ3sM01LyEKk4ugNQ==}
     engines: {node: '>=6.9.0'}
     peerDependencies:
       '@babel/core': ^7.0.0-0
 
-  '@babel/preset-typescript@7.27.1':
-    resolution: {integrity: sha512-l7WfQfX0WK4M0v2RudjuQK4u99BS6yLHYEmdtVPP7lKV013zr9DygFuWNlnbvQ9LR+LS0Egz/XAvGx5U9MX0fQ==}
+  '@babel/preset-typescript@7.28.5':
+    resolution: {integrity: sha512-+bQy5WOI2V6LJZpPVxY+yp66XdZ2yifu0Mc1aP5CQKgjn4QM5IN2i5fAZ4xKop47pr8rpVhiAeu+nDQa12C8+g==}
     engines: {node: '>=6.9.0'}
     peerDependencies:
       '@babel/core': ^7.0.0-0
@@ -961,12 +976,12 @@ packages:
     resolution: {integrity: sha512-LPDZ85aEJyYSd18/DkjNh4/y1ntkE5KwUHWTiqgRxruuZL2F1yuHligVHLvcHY2vMHXttKFpJn6LwfI7cw7ODw==}
     engines: {node: '>=6.9.0'}
 
-  '@babel/traverse@7.28.4':
-    resolution: {integrity: sha512-YEzuboP2qvQavAcjgQNVgsvHIDv6ZpwXvcvjmyySP2DIMuByS/6ioU5G9pYrWHM6T2YDfc7xga9iNzYOs12CFQ==}
+  '@babel/traverse@7.28.5':
+    resolution: {integrity: sha512-TCCj4t55U90khlYkVV/0TfkJkAkUg3jZFA3Neb7unZT8CPok7iiRfaX0F+WnqWqt7OxhOn0uBKXCw4lbL8W0aQ==}
     engines: {node: '>=6.9.0'}
 
-  '@babel/types@7.28.4':
-    resolution: {integrity: sha512-bkFqkLhh3pMBUQQkpVgWDWq/lqzc2678eUyDlTBhRqhCHFguYYGM0Efga7tYk4TogG/3x0EEl66/OQ+WGbWB/Q==}
+  '@babel/types@7.28.5':
+    resolution: {integrity: sha512-qQ5m48eI/MFLQ5PxQj4PFaprjyCTLI37ElWMmNs0K8Lk3dVeOdNpB3ks8jc7yM5CDmVC73eMVk/trk3fgmrUpA==}
     engines: {node: '>=6.9.0'}
 
   '@chromatic-com/storybook@4.1.2':
@@ -983,14 +998,11 @@ packages:
   '@date-fns/tz@1.4.1':
     resolution: {integrity: sha512-P5LUNhtbj6YfI3iJjw5EL9eUAG6OitD0W3fWQcpQjDRc/QIsL0tRNuO1PcDvPccWL1fSTXXdE1ds+l95DV/OFA==}
 
-  '@emnapi/core@1.7.1':
-    resolution: {integrity: sha512-o1uhUASyo921r2XtHYOHy7gdkGLge8ghBEQHMWmyJFoXlpU58kIrhhN3w26lpQb6dspetweapMn2CSNwQ8I4wg==}
+  '@emnapi/core@1.8.1':
+    resolution: {integrity: sha512-AvT9QFpxK0Zd8J0jopedNm+w/2fIzvtPKPjqyw9jwvBaReTTqPBk9Hixaz7KbjimP+QNz605/XnjFcDAL2pqBg==}
 
-  '@emnapi/runtime@1.5.0':
-    resolution: {integrity: sha512-97/BJ3iXHww3djw6hYIfErCZFee7qCtrneuLa20UXFCOTCfBM2cvQHjWJ2EG0s0MtdNwInarqCTz35i4wWXHsQ==}
-
-  '@emnapi/runtime@1.7.1':
-    resolution: {integrity: sha512-PVtJr5CmLwYAU9PZDMITZoR5iAOShYREoR45EyyLrbntV50mdePTgUn4AmOw90Ifcj+x2kRjdzr1HP3RrNiHGA==}
+  '@emnapi/runtime@1.8.1':
+    resolution: {integrity: sha512-mehfKSMWjjNol8659Z8KxEMrdSJDDot5SXMq00dM8BN4o+CLNXQ0xH2V7EchNHV4RmbZLmmPdEaXZc5H2FXmDg==}
 
   '@emnapi/wasi-threads@1.1.0':
     resolution: {integrity: sha512-WI0DdZ8xFSbgMjR1sFsKABJ/C5OnRrjT06JXbZKexJGrDuPTzZdDYfFlsgcCXCyf+suG5QU2e/y1Wo2V/OapLQ==}
@@ -1001,334 +1013,171 @@ packages:
   '@emotion/memoize@0.8.1':
     resolution: {integrity: sha512-W2P2c/VRW1/1tLox0mVUalvnWXxavmv/Oum2aPsRcoDJuob75FC3Y8FbpfLwUegRcxINtGUMPq0tFCvYNTBXNA==}
 
-  '@emotion/unitless@0.8.1':
-    resolution: {integrity: sha512-KOEGMu6dmJZtpadb476IsZBclKvILjopjUii3V+7MnXIQCYh8W3NgNcgwo21n9LXZX6EDIKvqfjYxXebDwxKmQ==}
-
   '@epic-web/invariant@1.0.0':
     resolution: {integrity: sha512-lrTPqgvfFQtR/eY/qkIzp98OGdNJu0m5ji3q/nJI8v3SXkRKEnWiOxMmbvcSoAIzv/cGiuvRy57k4suKQSAdwA==}
 
-  '@esbuild/aix-ppc64@0.25.11':
-    resolution: {integrity: sha512-Xt1dOL13m8u0WE8iplx9Ibbm+hFAO0GsU2P34UNoDGvZYkY8ifSiy6Zuc1lYxfG7svWE2fzqCUmFp5HCn51gJg==}
+  '@esbuild/aix-ppc64@0.25.12':
+    resolution: {integrity: sha512-Hhmwd6CInZ3dwpuGTF8fJG6yoWmsToE+vYgD4nytZVxcu1ulHpUQRAB1UJ8+N1Am3Mz4+xOByoQoSZf4D+CpkA==}
     engines: {node: '>=18'}
     cpu: [ppc64]
     os: [aix]
 
-  '@esbuild/aix-ppc64@0.25.9':
-    resolution: {integrity: sha512-OaGtL73Jck6pBKjNIe24BnFE6agGl+6KxDtTfHhy1HmhthfKouEcOhqpSL64K4/0WCtbKFLOdzD/44cJ4k9opA==}
-    engines: {node: '>=18'}
-    cpu: [ppc64]
-    os: [aix]
-
-  '@esbuild/android-arm64@0.25.11':
-    resolution: {integrity: sha512-9slpyFBc4FPPz48+f6jyiXOx/Y4v34TUeDDXJpZqAWQn/08lKGeD8aDp9TMn9jDz2CiEuHwfhRmGBvpnd/PWIQ==}
+  '@esbuild/android-arm64@0.25.12':
+    resolution: {integrity: sha512-6AAmLG7zwD1Z159jCKPvAxZd4y/VTO0VkprYy+3N2FtJ8+BQWFXU+OxARIwA46c5tdD9SsKGZ/1ocqBS/gAKHg==}
     engines: {node: '>=18'}
     cpu: [arm64]
     os: [android]
 
-  '@esbuild/android-arm64@0.25.9':
-    resolution: {integrity: sha512-IDrddSmpSv51ftWslJMvl3Q2ZT98fUSL2/rlUXuVqRXHCs5EUF1/f+jbjF5+NG9UffUDMCiTyh8iec7u8RlTLg==}
-    engines: {node: '>=18'}
-    cpu: [arm64]
-    os: [android]
-
-  '@esbuild/android-arm@0.25.11':
-    resolution: {integrity: sha512-uoa7dU+Dt3HYsethkJ1k6Z9YdcHjTrSb5NUy66ZfZaSV8hEYGD5ZHbEMXnqLFlbBflLsl89Zke7CAdDJ4JI+Gg==}
+  '@esbuild/android-arm@0.25.12':
+    resolution: {integrity: sha512-VJ+sKvNA/GE7Ccacc9Cha7bpS8nyzVv0jdVgwNDaR4gDMC/2TTRc33Ip8qrNYUcpkOHUT5OZ0bUcNNVZQ9RLlg==}
     engines: {node: '>=18'}
     cpu: [arm]
     os: [android]
 
-  '@esbuild/android-arm@0.25.9':
-    resolution: {integrity: sha512-5WNI1DaMtxQ7t7B6xa572XMXpHAaI/9Hnhk8lcxF4zVN4xstUgTlvuGDorBguKEnZO70qwEcLpfifMLoxiPqHQ==}
-    engines: {node: '>=18'}
-    cpu: [arm]
-    os: [android]
-
-  '@esbuild/android-x64@0.25.11':
-    resolution: {integrity: sha512-Sgiab4xBjPU1QoPEIqS3Xx+R2lezu0LKIEcYe6pftr56PqPygbB7+szVnzoShbx64MUupqoE0KyRlN7gezbl8g==}
+  '@esbuild/android-x64@0.25.12':
+    resolution: {integrity: sha512-5jbb+2hhDHx5phYR2By8GTWEzn6I9UqR11Kwf22iKbNpYrsmRB18aX/9ivc5cabcUiAT/wM+YIZ6SG9QO6a8kg==}
     engines: {node: '>=18'}
     cpu: [x64]
     os: [android]
 
-  '@esbuild/android-x64@0.25.9':
-    resolution: {integrity: sha512-I853iMZ1hWZdNllhVZKm34f4wErd4lMyeV7BLzEExGEIZYsOzqDWDf+y082izYUE8gtJnYHdeDpN/6tUdwvfiw==}
-    engines: {node: '>=18'}
-    cpu: [x64]
-    os: [android]
-
-  '@esbuild/darwin-arm64@0.25.11':
-    resolution: {integrity: sha512-VekY0PBCukppoQrycFxUqkCojnTQhdec0vevUL/EDOCnXd9LKWqD/bHwMPzigIJXPhC59Vd1WFIL57SKs2mg4w==}
+  '@esbuild/darwin-arm64@0.25.12':
+    resolution: {integrity: sha512-N3zl+lxHCifgIlcMUP5016ESkeQjLj/959RxxNYIthIg+CQHInujFuXeWbWMgnTo4cp5XVHqFPmpyu9J65C1Yg==}
     engines: {node: '>=18'}
     cpu: [arm64]
     os: [darwin]
 
-  '@esbuild/darwin-arm64@0.25.9':
-    resolution: {integrity: sha512-XIpIDMAjOELi/9PB30vEbVMs3GV1v2zkkPnuyRRURbhqjyzIINwj+nbQATh4H9GxUgH1kFsEyQMxwiLFKUS6Rg==}
-    engines: {node: '>=18'}
-    cpu: [arm64]
-    os: [darwin]
-
-  '@esbuild/darwin-x64@0.25.11':
-    resolution: {integrity: sha512-+hfp3yfBalNEpTGp9loYgbknjR695HkqtY3d3/JjSRUyPg/xd6q+mQqIb5qdywnDxRZykIHs3axEqU6l1+oWEQ==}
+  '@esbuild/darwin-x64@0.25.12':
+    resolution: {integrity: sha512-HQ9ka4Kx21qHXwtlTUVbKJOAnmG1ipXhdWTmNXiPzPfWKpXqASVcWdnf2bnL73wgjNrFXAa3yYvBSd9pzfEIpA==}
     engines: {node: '>=18'}
     cpu: [x64]
     os: [darwin]
 
-  '@esbuild/darwin-x64@0.25.9':
-    resolution: {integrity: sha512-jhHfBzjYTA1IQu8VyrjCX4ApJDnH+ez+IYVEoJHeqJm9VhG9Dh2BYaJritkYK3vMaXrf7Ogr/0MQ8/MeIefsPQ==}
-    engines: {node: '>=18'}
-    cpu: [x64]
-    os: [darwin]
-
-  '@esbuild/freebsd-arm64@0.25.11':
-    resolution: {integrity: sha512-CmKjrnayyTJF2eVuO//uSjl/K3KsMIeYeyN7FyDBjsR3lnSJHaXlVoAK8DZa7lXWChbuOk7NjAc7ygAwrnPBhA==}
+  '@esbuild/freebsd-arm64@0.25.12':
+    resolution: {integrity: sha512-gA0Bx759+7Jve03K1S0vkOu5Lg/85dou3EseOGUes8flVOGxbhDDh/iZaoek11Y8mtyKPGF3vP8XhnkDEAmzeg==}
     engines: {node: '>=18'}
     cpu: [arm64]
     os: [freebsd]
 
-  '@esbuild/freebsd-arm64@0.25.9':
-    resolution: {integrity: sha512-z93DmbnY6fX9+KdD4Ue/H6sYs+bhFQJNCPZsi4XWJoYblUqT06MQUdBCpcSfuiN72AbqeBFu5LVQTjfXDE2A6Q==}
-    engines: {node: '>=18'}
-    cpu: [arm64]
-    os: [freebsd]
-
-  '@esbuild/freebsd-x64@0.25.11':
-    resolution: {integrity: sha512-Dyq+5oscTJvMaYPvW3x3FLpi2+gSZTCE/1ffdwuM6G1ARang/mb3jvjxs0mw6n3Lsw84ocfo9CrNMqc5lTfGOw==}
+  '@esbuild/freebsd-x64@0.25.12':
+    resolution: {integrity: sha512-TGbO26Yw2xsHzxtbVFGEXBFH0FRAP7gtcPE7P5yP7wGy7cXK2oO7RyOhL5NLiqTlBh47XhmIUXuGciXEqYFfBQ==}
     engines: {node: '>=18'}
     cpu: [x64]
     os: [freebsd]
 
-  '@esbuild/freebsd-x64@0.25.9':
-    resolution: {integrity: sha512-mrKX6H/vOyo5v71YfXWJxLVxgy1kyt1MQaD8wZJgJfG4gq4DpQGpgTB74e5yBeQdyMTbgxp0YtNj7NuHN0PoZg==}
-    engines: {node: '>=18'}
-    cpu: [x64]
-    os: [freebsd]
-
-  '@esbuild/linux-arm64@0.25.11':
-    resolution: {integrity: sha512-Qr8AzcplUhGvdyUF08A1kHU3Vr2O88xxP0Tm8GcdVOUm25XYcMPp2YqSVHbLuXzYQMf9Bh/iKx7YPqECs6ffLA==}
+  '@esbuild/linux-arm64@0.25.12':
+    resolution: {integrity: sha512-8bwX7a8FghIgrupcxb4aUmYDLp8pX06rGh5HqDT7bB+8Rdells6mHvrFHHW2JAOPZUbnjUpKTLg6ECyzvas2AQ==}
     engines: {node: '>=18'}
     cpu: [arm64]
     os: [linux]
 
-  '@esbuild/linux-arm64@0.25.9':
-    resolution: {integrity: sha512-BlB7bIcLT3G26urh5Dmse7fiLmLXnRlopw4s8DalgZ8ef79Jj4aUcYbk90g8iCa2467HX8SAIidbL7gsqXHdRw==}
-    engines: {node: '>=18'}
-    cpu: [arm64]
-    os: [linux]
-
-  '@esbuild/linux-arm@0.25.11':
-    resolution: {integrity: sha512-TBMv6B4kCfrGJ8cUPo7vd6NECZH/8hPpBHHlYI3qzoYFvWu2AdTvZNuU/7hsbKWqu/COU7NIK12dHAAqBLLXgw==}
+  '@esbuild/linux-arm@0.25.12':
+    resolution: {integrity: sha512-lPDGyC1JPDou8kGcywY0YILzWlhhnRjdof3UlcoqYmS9El818LLfJJc3PXXgZHrHCAKs/Z2SeZtDJr5MrkxtOw==}
     engines: {node: '>=18'}
     cpu: [arm]
     os: [linux]
 
-  '@esbuild/linux-arm@0.25.9':
-    resolution: {integrity: sha512-HBU2Xv78SMgaydBmdor38lg8YDnFKSARg1Q6AT0/y2ezUAKiZvc211RDFHlEZRFNRVhcMamiToo7bDx3VEOYQw==}
-    engines: {node: '>=18'}
-    cpu: [arm]
-    os: [linux]
-
-  '@esbuild/linux-ia32@0.25.11':
-    resolution: {integrity: sha512-TmnJg8BMGPehs5JKrCLqyWTVAvielc615jbkOirATQvWWB1NMXY77oLMzsUjRLa0+ngecEmDGqt5jiDC6bfvOw==}
+  '@esbuild/linux-ia32@0.25.12':
+    resolution: {integrity: sha512-0y9KrdVnbMM2/vG8KfU0byhUN+EFCny9+8g202gYqSSVMonbsCfLjUO+rCci7pM0WBEtz+oK/PIwHkzxkyharA==}
     engines: {node: '>=18'}
     cpu: [ia32]
     os: [linux]
 
-  '@esbuild/linux-ia32@0.25.9':
-    resolution: {integrity: sha512-e7S3MOJPZGp2QW6AK6+Ly81rC7oOSerQ+P8L0ta4FhVi+/j/v2yZzx5CqqDaWjtPFfYz21Vi1S0auHrap3Ma3A==}
-    engines: {node: '>=18'}
-    cpu: [ia32]
-    os: [linux]
-
-  '@esbuild/linux-loong64@0.25.11':
-    resolution: {integrity: sha512-DIGXL2+gvDaXlaq8xruNXUJdT5tF+SBbJQKbWy/0J7OhU8gOHOzKmGIlfTTl6nHaCOoipxQbuJi7O++ldrxgMw==}
+  '@esbuild/linux-loong64@0.25.12':
+    resolution: {integrity: sha512-h///Lr5a9rib/v1GGqXVGzjL4TMvVTv+s1DPoxQdz7l/AYv6LDSxdIwzxkrPW438oUXiDtwM10o9PmwS/6Z0Ng==}
     engines: {node: '>=18'}
     cpu: [loong64]
     os: [linux]
 
-  '@esbuild/linux-loong64@0.25.9':
-    resolution: {integrity: sha512-Sbe10Bnn0oUAB2AalYztvGcK+o6YFFA/9829PhOCUS9vkJElXGdphz0A3DbMdP8gmKkqPmPcMJmJOrI3VYB1JQ==}
-    engines: {node: '>=18'}
-    cpu: [loong64]
-    os: [linux]
-
-  '@esbuild/linux-mips64el@0.25.11':
-    resolution: {integrity: sha512-Osx1nALUJu4pU43o9OyjSCXokFkFbyzjXb6VhGIJZQ5JZi8ylCQ9/LFagolPsHtgw6himDSyb5ETSfmp4rpiKQ==}
+  '@esbuild/linux-mips64el@0.25.12':
+    resolution: {integrity: sha512-iyRrM1Pzy9GFMDLsXn1iHUm18nhKnNMWscjmp4+hpafcZjrr2WbT//d20xaGljXDBYHqRcl8HnxbX6uaA/eGVw==}
     engines: {node: '>=18'}
     cpu: [mips64el]
     os: [linux]
 
-  '@esbuild/linux-mips64el@0.25.9':
-    resolution: {integrity: sha512-YcM5br0mVyZw2jcQeLIkhWtKPeVfAerES5PvOzaDxVtIyZ2NUBZKNLjC5z3/fUlDgT6w89VsxP2qzNipOaaDyA==}
-    engines: {node: '>=18'}
-    cpu: [mips64el]
-    os: [linux]
-
-  '@esbuild/linux-ppc64@0.25.11':
-    resolution: {integrity: sha512-nbLFgsQQEsBa8XSgSTSlrnBSrpoWh7ioFDUmwo158gIm5NNP+17IYmNWzaIzWmgCxq56vfr34xGkOcZ7jX6CPw==}
+  '@esbuild/linux-ppc64@0.25.12':
+    resolution: {integrity: sha512-9meM/lRXxMi5PSUqEXRCtVjEZBGwB7P/D4yT8UG/mwIdze2aV4Vo6U5gD3+RsoHXKkHCfSxZKzmDssVlRj1QQA==}
     engines: {node: '>=18'}
     cpu: [ppc64]
     os: [linux]
 
-  '@esbuild/linux-ppc64@0.25.9':
-    resolution: {integrity: sha512-++0HQvasdo20JytyDpFvQtNrEsAgNG2CY1CLMwGXfFTKGBGQT3bOeLSYE2l1fYdvML5KUuwn9Z8L1EWe2tzs1w==}
-    engines: {node: '>=18'}
-    cpu: [ppc64]
-    os: [linux]
-
-  '@esbuild/linux-riscv64@0.25.11':
-    resolution: {integrity: sha512-HfyAmqZi9uBAbgKYP1yGuI7tSREXwIb438q0nqvlpxAOs3XnZ8RsisRfmVsgV486NdjD7Mw2UrFSw51lzUk1ww==}
+  '@esbuild/linux-riscv64@0.25.12':
+    resolution: {integrity: sha512-Zr7KR4hgKUpWAwb1f3o5ygT04MzqVrGEGXGLnj15YQDJErYu/BGg+wmFlIDOdJp0PmB0lLvxFIOXZgFRrdjR0w==}
     engines: {node: '>=18'}
     cpu: [riscv64]
     os: [linux]
 
-  '@esbuild/linux-riscv64@0.25.9':
-    resolution: {integrity: sha512-uNIBa279Y3fkjV+2cUjx36xkx7eSjb8IvnL01eXUKXez/CBHNRw5ekCGMPM0BcmqBxBcdgUWuUXmVWwm4CH9kg==}
-    engines: {node: '>=18'}
-    cpu: [riscv64]
-    os: [linux]
-
-  '@esbuild/linux-s390x@0.25.11':
-    resolution: {integrity: sha512-HjLqVgSSYnVXRisyfmzsH6mXqyvj0SA7pG5g+9W7ESgwA70AXYNpfKBqh1KbTxmQVaYxpzA/SvlB9oclGPbApw==}
+  '@esbuild/linux-s390x@0.25.12':
+    resolution: {integrity: sha512-MsKncOcgTNvdtiISc/jZs/Zf8d0cl/t3gYWX8J9ubBnVOwlk65UIEEvgBORTiljloIWnBzLs4qhzPkJcitIzIg==}
     engines: {node: '>=18'}
     cpu: [s390x]
     os: [linux]
 
-  '@esbuild/linux-s390x@0.25.9':
-    resolution: {integrity: sha512-Mfiphvp3MjC/lctb+7D287Xw1DGzqJPb/J2aHHcHxflUo+8tmN/6d4k6I2yFR7BVo5/g7x2Monq4+Yew0EHRIA==}
-    engines: {node: '>=18'}
-    cpu: [s390x]
-    os: [linux]
-
-  '@esbuild/linux-x64@0.25.11':
-    resolution: {integrity: sha512-HSFAT4+WYjIhrHxKBwGmOOSpphjYkcswF449j6EjsjbinTZbp8PJtjsVK1XFJStdzXdy/jaddAep2FGY+wyFAQ==}
+  '@esbuild/linux-x64@0.25.12':
+    resolution: {integrity: sha512-uqZMTLr/zR/ed4jIGnwSLkaHmPjOjJvnm6TVVitAa08SLS9Z0VM8wIRx7gWbJB5/J54YuIMInDquWyYvQLZkgw==}
     engines: {node: '>=18'}
     cpu: [x64]
     os: [linux]
 
-  '@esbuild/linux-x64@0.25.9':
-    resolution: {integrity: sha512-iSwByxzRe48YVkmpbgoxVzn76BXjlYFXC7NvLYq+b+kDjyyk30J0JY47DIn8z1MO3K0oSl9fZoRmZPQI4Hklzg==}
-    engines: {node: '>=18'}
-    cpu: [x64]
-    os: [linux]
-
-  '@esbuild/netbsd-arm64@0.25.11':
-    resolution: {integrity: sha512-hr9Oxj1Fa4r04dNpWr3P8QKVVsjQhqrMSUzZzf+LZcYjZNqhA3IAfPQdEh1FLVUJSiu6sgAwp3OmwBfbFgG2Xg==}
+  '@esbuild/netbsd-arm64@0.25.12':
+    resolution: {integrity: sha512-xXwcTq4GhRM7J9A8Gv5boanHhRa/Q9KLVmcyXHCTaM4wKfIpWkdXiMog/KsnxzJ0A1+nD+zoecuzqPmCRyBGjg==}
     engines: {node: '>=18'}
     cpu: [arm64]
     os: [netbsd]
 
-  '@esbuild/netbsd-arm64@0.25.9':
-    resolution: {integrity: sha512-9jNJl6FqaUG+COdQMjSCGW4QiMHH88xWbvZ+kRVblZsWrkXlABuGdFJ1E9L7HK+T0Yqd4akKNa/lO0+jDxQD4Q==}
-    engines: {node: '>=18'}
-    cpu: [arm64]
-    os: [netbsd]
-
-  '@esbuild/netbsd-x64@0.25.11':
-    resolution: {integrity: sha512-u7tKA+qbzBydyj0vgpu+5h5AeudxOAGncb8N6C9Kh1N4n7wU1Xw1JDApsRjpShRpXRQlJLb9wY28ELpwdPcZ7A==}
+  '@esbuild/netbsd-x64@0.25.12':
+    resolution: {integrity: sha512-Ld5pTlzPy3YwGec4OuHh1aCVCRvOXdH8DgRjfDy/oumVovmuSzWfnSJg+VtakB9Cm0gxNO9BzWkj6mtO1FMXkQ==}
     engines: {node: '>=18'}
     cpu: [x64]
     os: [netbsd]
 
-  '@esbuild/netbsd-x64@0.25.9':
-    resolution: {integrity: sha512-RLLdkflmqRG8KanPGOU7Rpg829ZHu8nFy5Pqdi9U01VYtG9Y0zOG6Vr2z4/S+/3zIyOxiK6cCeYNWOFR9QP87g==}
-    engines: {node: '>=18'}
-    cpu: [x64]
-    os: [netbsd]
-
-  '@esbuild/openbsd-arm64@0.25.11':
-    resolution: {integrity: sha512-Qq6YHhayieor3DxFOoYM1q0q1uMFYb7cSpLD2qzDSvK1NAvqFi8Xgivv0cFC6J+hWVw2teCYltyy9/m/14ryHg==}
+  '@esbuild/openbsd-arm64@0.25.12':
+    resolution: {integrity: sha512-fF96T6KsBo/pkQI950FARU9apGNTSlZGsv1jZBAlcLL1MLjLNIWPBkj5NlSz8aAzYKg+eNqknrUJ24QBybeR5A==}
     engines: {node: '>=18'}
     cpu: [arm64]
     os: [openbsd]
 
-  '@esbuild/openbsd-arm64@0.25.9':
-    resolution: {integrity: sha512-YaFBlPGeDasft5IIM+CQAhJAqS3St3nJzDEgsgFixcfZeyGPCd6eJBWzke5piZuZ7CtL656eOSYKk4Ls2C0FRQ==}
-    engines: {node: '>=18'}
-    cpu: [arm64]
-    os: [openbsd]
-
-  '@esbuild/openbsd-x64@0.25.11':
-    resolution: {integrity: sha512-CN+7c++kkbrckTOz5hrehxWN7uIhFFlmS/hqziSFVWpAzpWrQoAG4chH+nN3Be+Kzv/uuo7zhX716x3Sn2Jduw==}
+  '@esbuild/openbsd-x64@0.25.12':
+    resolution: {integrity: sha512-MZyXUkZHjQxUvzK7rN8DJ3SRmrVrke8ZyRusHlP+kuwqTcfWLyqMOE3sScPPyeIXN/mDJIfGXvcMqCgYKekoQw==}
     engines: {node: '>=18'}
     cpu: [x64]
     os: [openbsd]
 
-  '@esbuild/openbsd-x64@0.25.9':
-    resolution: {integrity: sha512-1MkgTCuvMGWuqVtAvkpkXFmtL8XhWy+j4jaSO2wxfJtilVCi0ZE37b8uOdMItIHz4I6z1bWWtEX4CJwcKYLcuA==}
-    engines: {node: '>=18'}
-    cpu: [x64]
-    os: [openbsd]
-
-  '@esbuild/openharmony-arm64@0.25.11':
-    resolution: {integrity: sha512-rOREuNIQgaiR+9QuNkbkxubbp8MSO9rONmwP5nKncnWJ9v5jQ4JxFnLu4zDSRPf3x4u+2VN4pM4RdyIzDty/wQ==}
+  '@esbuild/openharmony-arm64@0.25.12':
+    resolution: {integrity: sha512-rm0YWsqUSRrjncSXGA7Zv78Nbnw4XL6/dzr20cyrQf7ZmRcsovpcRBdhD43Nuk3y7XIoW2OxMVvwuRvk9XdASg==}
     engines: {node: '>=18'}
     cpu: [arm64]
     os: [openharmony]
 
-  '@esbuild/openharmony-arm64@0.25.9':
-    resolution: {integrity: sha512-4Xd0xNiMVXKh6Fa7HEJQbrpP3m3DDn43jKxMjxLLRjWnRsfxjORYJlXPO4JNcXtOyfajXorRKY9NkOpTHptErg==}
-    engines: {node: '>=18'}
-    cpu: [arm64]
-    os: [openharmony]
-
-  '@esbuild/sunos-x64@0.25.11':
-    resolution: {integrity: sha512-nq2xdYaWxyg9DcIyXkZhcYulC6pQ2FuCgem3LI92IwMgIZ69KHeY8T4Y88pcwoLIjbed8n36CyKoYRDygNSGhA==}
+  '@esbuild/sunos-x64@0.25.12':
+    resolution: {integrity: sha512-3wGSCDyuTHQUzt0nV7bocDy72r2lI33QL3gkDNGkod22EsYl04sMf0qLb8luNKTOmgF/eDEDP5BFNwoBKH441w==}
     engines: {node: '>=18'}
     cpu: [x64]
     os: [sunos]
 
-  '@esbuild/sunos-x64@0.25.9':
-    resolution: {integrity: sha512-WjH4s6hzo00nNezhp3wFIAfmGZ8U7KtrJNlFMRKxiI9mxEK1scOMAaa9i4crUtu+tBr+0IN6JCuAcSBJZfnphw==}
-    engines: {node: '>=18'}
-    cpu: [x64]
-    os: [sunos]
-
-  '@esbuild/win32-arm64@0.25.11':
-    resolution: {integrity: sha512-3XxECOWJq1qMZ3MN8srCJ/QfoLpL+VaxD/WfNRm1O3B4+AZ/BnLVgFbUV3eiRYDMXetciH16dwPbbHqwe1uU0Q==}
+  '@esbuild/win32-arm64@0.25.12':
+    resolution: {integrity: sha512-rMmLrur64A7+DKlnSuwqUdRKyd3UE7oPJZmnljqEptesKM8wx9J8gx5u0+9Pq0fQQW8vqeKebwNXdfOyP+8Bsg==}
     engines: {node: '>=18'}
     cpu: [arm64]
     os: [win32]
 
-  '@esbuild/win32-arm64@0.25.9':
-    resolution: {integrity: sha512-mGFrVJHmZiRqmP8xFOc6b84/7xa5y5YvR1x8djzXpJBSv/UsNK6aqec+6JDjConTgvvQefdGhFDAs2DLAds6gQ==}
-    engines: {node: '>=18'}
-    cpu: [arm64]
-    os: [win32]
-
-  '@esbuild/win32-ia32@0.25.11':
-    resolution: {integrity: sha512-3ukss6gb9XZ8TlRyJlgLn17ecsK4NSQTmdIXRASVsiS2sQ6zPPZklNJT5GR5tE/MUarymmy8kCEf5xPCNCqVOA==}
+  '@esbuild/win32-ia32@0.25.12':
+    resolution: {integrity: sha512-HkqnmmBoCbCwxUKKNPBixiWDGCpQGVsrQfJoVGYLPT41XWF8lHuE5N6WhVia2n4o5QK5M4tYr21827fNhi4byQ==}
     engines: {node: '>=18'}
     cpu: [ia32]
     os: [win32]
 
-  '@esbuild/win32-ia32@0.25.9':
-    resolution: {integrity: sha512-b33gLVU2k11nVx1OhX3C8QQP6UHQK4ZtN56oFWvVXvz2VkDoe6fbG8TOgHFxEvqeqohmRnIHe5A1+HADk4OQww==}
-    engines: {node: '>=18'}
-    cpu: [ia32]
-    os: [win32]
-
-  '@esbuild/win32-x64@0.25.11':
-    resolution: {integrity: sha512-D7Hpz6A2L4hzsRpPaCYkQnGOotdUpDzSGRIv9I+1ITdHROSFUWW95ZPZWQmGka1Fg7W3zFJowyn9WGwMJ0+KPA==}
+  '@esbuild/win32-x64@0.25.12':
+    resolution: {integrity: sha512-alJC0uCZpTFrSL0CCDjcgleBXPnCrEAhTBILpeAp7M/OFgoqtAetfBzX0xM00MUsVVPpVjlPuMbREqnZCXaTnA==}
     engines: {node: '>=18'}
     cpu: [x64]
     os: [win32]
 
-  '@esbuild/win32-x64@0.25.9':
-    resolution: {integrity: sha512-PPOl1mi6lpLNQxnGoyAfschAodRFYXJ+9fs6WHXz7CSWKbOqiMZsubC+BQsVKuul+3vKLuwTHsS2c2y9EoKwxQ==}
-    engines: {node: '>=18'}
-    cpu: [x64]
-    os: [win32]
-
-  '@eslint-community/eslint-utils@4.9.0':
-    resolution: {integrity: sha512-ayVFHdtZ+hsq1t2Dy24wCmGXGe4q9Gu3smhLYALJrr473ZH27MsnSL+LKUlimp4BWJqMDMLmPpx/Q9R3OAlL4g==}
+  '@eslint-community/eslint-utils@4.9.1':
+    resolution: {integrity: sha512-phrYmNiYppR7znFEdqgfWHXR6NCkZEK7hwWDHZUjit/2/U0r6XvkDl0SYnoM51Hq7FhCGdLDT6zxCCOY1hexsQ==}
     engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
     peerDependencies:
       eslint: ^6.0.0 || ^7.0.0 || >=8.0.0
 
-  '@eslint-community/regexpp@4.12.1':
-    resolution: {integrity: sha512-CCZCDJuduB9OUkFkY2IgppNZMi2lBQgD2qzwXkEia16cge2pijY/aXi96CJMquDMn3nJdlPV1A5KrJEXwfLNzQ==}
-    engines: {node: ^12.0.0 || ^14.0.0 || >=16.0.0}
-
   '@eslint-community/regexpp@4.12.2':
     resolution: {integrity: sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==}
     engines: {node: ^12.0.0 || ^14.0.0 || >=16.0.0}
@@ -1351,11 +1200,11 @@ packages:
   '@floating-ui/core@1.7.3':
     resolution: {integrity: sha512-sGnvb5dmrJaKEZ+LDIpguvdX3bDlEllmv4/ClQ9awcmCZrlx5jQyyMWFM5kBI+EyNOCDDiKk8il0zeuX3Zlg/w==}
 
-  '@floating-ui/dom@1.7.3':
-    resolution: {integrity: sha512-uZA413QEpNuhtb3/iIKoYMSK07keHPYeXF02Zhd6e213j+d1NamLix/mCLxBUDW/Gx52sPH2m+chlUsyaBs/Ag==}
+  '@floating-ui/dom@1.7.4':
+    resolution: {integrity: sha512-OOchDgh4F2CchOX94cRVqhvy7b3AFb+/rQXyswmzmGakRfkMgoWVjfnLWkRirfLEfuD4ysVW16eXzwt3jHIzKA==}
 
-  '@floating-ui/react-dom@2.1.5':
-    resolution: {integrity: sha512-HDO/1/1oH9fjj4eLgegrlH3dklZpHtUYYFiVwMUwfGvk9jWDRWqkklA2/NFScknrcNSspbV868WjXORvreDX+Q==}
+  '@floating-ui/react-dom@2.1.6':
+    resolution: {integrity: sha512-4JX6rEatQEvlmgU80wZyq9RT96HZJa88q8hp0pBd+LrczeDI4o6uA2M+uvxngVHo4Ihr8uibXxH6+70zhAFrVw==}
     peerDependencies:
       react: '>=16.8.0'
       react-dom: '>=16.8.0'
@@ -1363,8 +1212,8 @@ packages:
   '@floating-ui/utils@0.2.10':
     resolution: {integrity: sha512-aGTxbpbg8/b5JfU1HXSrbH3wXZuLPJcNEcZQFMxLs3oSzgtVu6nFPkbbGGUvBcUjKV2YyB9Wxxabo+HEH9tcRQ==}
 
-  '@gerrit0/mini-shiki@3.14.0':
-    resolution: {integrity: sha512-c5X8fwPLOtUS8TVdqhynz9iV0GlOtFUT1ppXYzUUlEXe4kbZ/mvMT8wXoT8kCwUka+zsiloq7sD3pZ3+QVTuNQ==}
+  '@gerrit0/mini-shiki@3.20.0':
+    resolution: {integrity: sha512-Wa57i+bMpK6PGJZ1f2myxo3iO+K/kZikcyvH8NIqNNZhQUbDav7V9LQmWOXhf946mz5c1NZ19WMsGYiDKTryzQ==}
 
   '@hookform/resolvers@5.2.2':
     resolution: {integrity: sha512-A/IxlMLShx3KjV/HeTcTfaMxdwy690+L/ZADoeaTltLx+CVuzkeVIPuybK3jrRfw7YZnmdKsVVHAlEPIAEUNlA==}
@@ -1388,138 +1237,153 @@ packages:
     resolution: {integrity: sha512-AoFbSarOqFBYH+1TZ9Ahkm2IWYSi5v0pBk88fpV+5b3qGJukypX8PwvCWADjuyIccKg48/F73a6hTTkBzDQ2UA==}
     engines: {node: '>=16.0.0'}
 
-  '@ibm-cloud/openapi-ruleset@1.33.3':
-    resolution: {integrity: sha512-lOxglXIzUZwsw5WsbgZraxxzAYMdXYyiMNOioxYJYTd55ZuN4XEERoPdV5v1oPTdKedHEUSQu5siiSHToENFdA==}
+  '@ibm-cloud/openapi-ruleset@1.33.5':
+    resolution: {integrity: sha512-oT8USsTulFAA8FiBN0lA2rJqQI2lIt+HP2pdakGQXo3EviL2vqJTgpSCRwjl6mLJL158f1BVcdQUOEFGxomK3w==}
     engines: {node: '>=16.0.0'}
 
-  '@img/sharp-darwin-arm64@0.34.3':
-    resolution: {integrity: sha512-ryFMfvxxpQRsgZJqBd4wsttYQbCxsJksrv9Lw/v798JcQ8+w84mBWuXwl+TT0WJ/WrYOLaYpwQXi3sA9nTIaIg==}
+  '@img/colour@1.0.0':
+    resolution: {integrity: sha512-A5P/LfWGFSl6nsckYtjw9da+19jB8hkJ6ACTGcDfEJ0aE+l2n2El7dsVM7UVHZQ9s2lmYMWlrS21YLy2IR1LUw==}
+    engines: {node: '>=18'}
+
+  '@img/sharp-darwin-arm64@0.34.5':
+    resolution: {integrity: sha512-imtQ3WMJXbMY4fxb/Ndp6HBTNVtWCUI0WdobyheGf5+ad6xX8VIDO8u2xE4qc/fr08CKG/7dDseFtn6M6g/r3w==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [arm64]
     os: [darwin]
 
-  '@img/sharp-darwin-x64@0.34.3':
-    resolution: {integrity: sha512-yHpJYynROAj12TA6qil58hmPmAwxKKC7reUqtGLzsOHfP7/rniNGTL8tjWX6L3CTV4+5P4ypcS7Pp+7OB+8ihA==}
+  '@img/sharp-darwin-x64@0.34.5':
+    resolution: {integrity: sha512-YNEFAF/4KQ/PeW0N+r+aVVsoIY0/qxxikF2SWdp+NRkmMB7y9LBZAVqQ4yhGCm/H3H270OSykqmQMKLBhBJDEw==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [x64]
     os: [darwin]
 
-  '@img/sharp-libvips-darwin-arm64@1.2.0':
-    resolution: {integrity: sha512-sBZmpwmxqwlqG9ueWFXtockhsxefaV6O84BMOrhtg/YqbTaRdqDE7hxraVE3y6gVM4eExmfzW4a8el9ArLeEiQ==}
+  '@img/sharp-libvips-darwin-arm64@1.2.4':
+    resolution: {integrity: sha512-zqjjo7RatFfFoP0MkQ51jfuFZBnVE2pRiaydKJ1G/rHZvnsrHAOcQALIi9sA5co5xenQdTugCvtb1cuf78Vf4g==}
     cpu: [arm64]
     os: [darwin]
 
-  '@img/sharp-libvips-darwin-x64@1.2.0':
-    resolution: {integrity: sha512-M64XVuL94OgiNHa5/m2YvEQI5q2cl9d/wk0qFTDVXcYzi43lxuiFTftMR1tOnFQovVXNZJ5TURSDK2pNe9Yzqg==}
+  '@img/sharp-libvips-darwin-x64@1.2.4':
+    resolution: {integrity: sha512-1IOd5xfVhlGwX+zXv2N93k0yMONvUlANylbJw1eTah8K/Jtpi15KC+WSiaX/nBmbm2HxRM1gZ0nSdjSsrZbGKg==}
     cpu: [x64]
     os: [darwin]
 
-  '@img/sharp-libvips-linux-arm64@1.2.0':
-    resolution: {integrity: sha512-RXwd0CgG+uPRX5YYrkzKyalt2OJYRiJQ8ED/fi1tq9WQW2jsQIn0tqrlR5l5dr/rjqq6AHAxURhj2DVjyQWSOA==}
+  '@img/sharp-libvips-linux-arm64@1.2.4':
+    resolution: {integrity: sha512-excjX8DfsIcJ10x1Kzr4RcWe1edC9PquDRRPx3YVCvQv+U5p7Yin2s32ftzikXojb1PIFc/9Mt28/y+iRklkrw==}
     cpu: [arm64]
     os: [linux]
 
-  '@img/sharp-libvips-linux-arm@1.2.0':
-    resolution: {integrity: sha512-mWd2uWvDtL/nvIzThLq3fr2nnGfyr/XMXlq8ZJ9WMR6PXijHlC3ksp0IpuhK6bougvQrchUAfzRLnbsen0Cqvw==}
+  '@img/sharp-libvips-linux-arm@1.2.4':
+    resolution: {integrity: sha512-bFI7xcKFELdiNCVov8e44Ia4u2byA+l3XtsAj+Q8tfCwO6BQ8iDojYdvoPMqsKDkuoOo+X6HZA0s0q11ANMQ8A==}
     cpu: [arm]
     os: [linux]
 
-  '@img/sharp-libvips-linux-ppc64@1.2.0':
-    resolution: {integrity: sha512-Xod/7KaDDHkYu2phxxfeEPXfVXFKx70EAFZ0qyUdOjCcxbjqyJOEUpDe6RIyaunGxT34Anf9ue/wuWOqBW2WcQ==}
+  '@img/sharp-libvips-linux-ppc64@1.2.4':
+    resolution: {integrity: sha512-FMuvGijLDYG6lW+b/UvyilUWu5Ayu+3r2d1S8notiGCIyYU/76eig1UfMmkZ7vwgOrzKzlQbFSuQfgm7GYUPpA==}
     cpu: [ppc64]
     os: [linux]
 
-  '@img/sharp-libvips-linux-s390x@1.2.0':
-    resolution: {integrity: sha512-eMKfzDxLGT8mnmPJTNMcjfO33fLiTDsrMlUVcp6b96ETbnJmd4uvZxVJSKPQfS+odwfVaGifhsB07J1LynFehw==}
+  '@img/sharp-libvips-linux-riscv64@1.2.4':
+    resolution: {integrity: sha512-oVDbcR4zUC0ce82teubSm+x6ETixtKZBh/qbREIOcI3cULzDyb18Sr/Wcyx7NRQeQzOiHTNbZFF1UwPS2scyGA==}
+    cpu: [riscv64]
+    os: [linux]
+
+  '@img/sharp-libvips-linux-s390x@1.2.4':
+    resolution: {integrity: sha512-qmp9VrzgPgMoGZyPvrQHqk02uyjA0/QrTO26Tqk6l4ZV0MPWIW6LTkqOIov+J1yEu7MbFQaDpwdwJKhbJvuRxQ==}
     cpu: [s390x]
     os: [linux]
 
-  '@img/sharp-libvips-linux-x64@1.2.0':
-    resolution: {integrity: sha512-ZW3FPWIc7K1sH9E3nxIGB3y3dZkpJlMnkk7z5tu1nSkBoCgw2nSRTFHI5pB/3CQaJM0pdzMF3paf9ckKMSE9Tg==}
+  '@img/sharp-libvips-linux-x64@1.2.4':
+    resolution: {integrity: sha512-tJxiiLsmHc9Ax1bz3oaOYBURTXGIRDODBqhveVHonrHJ9/+k89qbLl0bcJns+e4t4rvaNBxaEZsFtSfAdquPrw==}
     cpu: [x64]
     os: [linux]
 
-  '@img/sharp-libvips-linuxmusl-arm64@1.2.0':
-    resolution: {integrity: sha512-UG+LqQJbf5VJ8NWJ5Z3tdIe/HXjuIdo4JeVNADXBFuG7z9zjoegpzzGIyV5zQKi4zaJjnAd2+g2nna8TZvuW9Q==}
+  '@img/sharp-libvips-linuxmusl-arm64@1.2.4':
+    resolution: {integrity: sha512-FVQHuwx1IIuNow9QAbYUzJ+En8KcVm9Lk5+uGUQJHaZmMECZmOlix9HnH7n1TRkXMS0pGxIJokIVB9SuqZGGXw==}
     cpu: [arm64]
     os: [linux]
 
-  '@img/sharp-libvips-linuxmusl-x64@1.2.0':
-    resolution: {integrity: sha512-SRYOLR7CXPgNze8akZwjoGBoN1ThNZoqpOgfnOxmWsklTGVfJiGJoC/Lod7aNMGA1jSsKWM1+HRX43OP6p9+6Q==}
+  '@img/sharp-libvips-linuxmusl-x64@1.2.4':
+    resolution: {integrity: sha512-+LpyBk7L44ZIXwz/VYfglaX/okxezESc6UxDSoyo2Ks6Jxc4Y7sGjpgU9s4PMgqgjj1gZCylTieNamqA1MF7Dg==}
     cpu: [x64]
     os: [linux]
 
-  '@img/sharp-linux-arm64@0.34.3':
-    resolution: {integrity: sha512-QdrKe3EvQrqwkDrtuTIjI0bu6YEJHTgEeqdzI3uWJOH6G1O8Nl1iEeVYRGdj1h5I21CqxSvQp1Yv7xeU3ZewbA==}
+  '@img/sharp-linux-arm64@0.34.5':
+    resolution: {integrity: sha512-bKQzaJRY/bkPOXyKx5EVup7qkaojECG6NLYswgktOZjaXecSAeCWiZwwiFf3/Y+O1HrauiE3FVsGxFg8c24rZg==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [arm64]
     os: [linux]
 
-  '@img/sharp-linux-arm@0.34.3':
-    resolution: {integrity: sha512-oBK9l+h6KBN0i3dC8rYntLiVfW8D8wH+NPNT3O/WBHeW0OQWCjfWksLUaPidsrDKpJgXp3G3/hkmhptAW0I3+A==}
+  '@img/sharp-linux-arm@0.34.5':
+    resolution: {integrity: sha512-9dLqsvwtg1uuXBGZKsxem9595+ujv0sJ6Vi8wcTANSFpwV/GONat5eCkzQo/1O6zRIkh0m/8+5BjrRr7jDUSZw==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [arm]
     os: [linux]
 
-  '@img/sharp-linux-ppc64@0.34.3':
-    resolution: {integrity: sha512-GLtbLQMCNC5nxuImPR2+RgrviwKwVql28FWZIW1zWruy6zLgA5/x2ZXk3mxj58X/tszVF69KK0Is83V8YgWhLA==}
+  '@img/sharp-linux-ppc64@0.34.5':
+    resolution: {integrity: sha512-7zznwNaqW6YtsfrGGDA6BRkISKAAE1Jo0QdpNYXNMHu2+0dTrPflTLNkpc8l7MUP5M16ZJcUvysVWWrMefZquA==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [ppc64]
     os: [linux]
 
-  '@img/sharp-linux-s390x@0.34.3':
-    resolution: {integrity: sha512-3gahT+A6c4cdc2edhsLHmIOXMb17ltffJlxR0aC2VPZfwKoTGZec6u5GrFgdR7ciJSsHT27BD3TIuGcuRT0KmQ==}
+  '@img/sharp-linux-riscv64@0.34.5':
+    resolution: {integrity: sha512-51gJuLPTKa7piYPaVs8GmByo7/U7/7TZOq+cnXJIHZKavIRHAP77e3N2HEl3dgiqdD/w0yUfiJnII77PuDDFdw==}
+    engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
+    cpu: [riscv64]
+    os: [linux]
+
+  '@img/sharp-linux-s390x@0.34.5':
+    resolution: {integrity: sha512-nQtCk0PdKfho3eC5MrbQoigJ2gd1CgddUMkabUj+rBevs8tZ2cULOx46E7oyX+04WGfABgIwmMC0VqieTiR4jg==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [s390x]
     os: [linux]
 
-  '@img/sharp-linux-x64@0.34.3':
-    resolution: {integrity: sha512-8kYso8d806ypnSq3/Ly0QEw90V5ZoHh10yH0HnrzOCr6DKAPI6QVHvwleqMkVQ0m+fc7EH8ah0BB0QPuWY6zJQ==}
+  '@img/sharp-linux-x64@0.34.5':
+    resolution: {integrity: sha512-MEzd8HPKxVxVenwAa+JRPwEC7QFjoPWuS5NZnBt6B3pu7EG2Ge0id1oLHZpPJdn3OQK+BQDiw9zStiHBTJQQQQ==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [x64]
     os: [linux]
 
-  '@img/sharp-linuxmusl-arm64@0.34.3':
-    resolution: {integrity: sha512-vAjbHDlr4izEiXM1OTggpCcPg9tn4YriK5vAjowJsHwdBIdx0fYRsURkxLG2RLm9gyBq66gwtWI8Gx0/ov+JKQ==}
+  '@img/sharp-linuxmusl-arm64@0.34.5':
+    resolution: {integrity: sha512-fprJR6GtRsMt6Kyfq44IsChVZeGN97gTD331weR1ex1c1rypDEABN6Tm2xa1wE6lYb5DdEnk03NZPqA7Id21yg==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [arm64]
     os: [linux]
 
-  '@img/sharp-linuxmusl-x64@0.34.3':
-    resolution: {integrity: sha512-gCWUn9547K5bwvOn9l5XGAEjVTTRji4aPTqLzGXHvIr6bIDZKNTA34seMPgM0WmSf+RYBH411VavCejp3PkOeQ==}
+  '@img/sharp-linuxmusl-x64@0.34.5':
+    resolution: {integrity: sha512-Jg8wNT1MUzIvhBFxViqrEhWDGzqymo3sV7z7ZsaWbZNDLXRJZoRGrjulp60YYtV4wfY8VIKcWidjojlLcWrd8Q==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [x64]
     os: [linux]
 
-  '@img/sharp-wasm32@0.34.3':
-    resolution: {integrity: sha512-+CyRcpagHMGteySaWos8IbnXcHgfDn7pO2fiC2slJxvNq9gDipYBN42/RagzctVRKgxATmfqOSulgZv5e1RdMg==}
+  '@img/sharp-wasm32@0.34.5':
+    resolution: {integrity: sha512-OdWTEiVkY2PHwqkbBI8frFxQQFekHaSSkUIJkwzclWZe64O1X4UlUjqqqLaPbUpMOQk6FBu/HtlGXNblIs0huw==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [wasm32]
 
-  '@img/sharp-win32-arm64@0.34.3':
-    resolution: {integrity: sha512-MjnHPnbqMXNC2UgeLJtX4XqoVHHlZNd+nPt1kRPmj63wURegwBhZlApELdtxM2OIZDRv/DFtLcNhVbd1z8GYXQ==}
+  '@img/sharp-win32-arm64@0.34.5':
+    resolution: {integrity: sha512-WQ3AgWCWYSb2yt+IG8mnC6Jdk9Whs7O0gxphblsLvdhSpSTtmu69ZG1Gkb6NuvxsNACwiPV6cNSZNzt0KPsw7g==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [arm64]
     os: [win32]
 
-  '@img/sharp-win32-ia32@0.34.3':
-    resolution: {integrity: sha512-xuCdhH44WxuXgOM714hn4amodJMZl3OEvf0GVTm0BEyMeA2to+8HEdRPShH0SLYptJY1uBw+SCFP9WVQi1Q/cw==}
+  '@img/sharp-win32-ia32@0.34.5':
+    resolution: {integrity: sha512-FV9m/7NmeCmSHDD5j4+4pNI8Cp3aW+JvLoXcTUo0IqyjSfAZJ8dIUmijx1qaJsIiU+Hosw6xM5KijAWRJCSgNg==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [ia32]
     os: [win32]
 
-  '@img/sharp-win32-x64@0.34.3':
-    resolution: {integrity: sha512-OWwz05d++TxzLEv4VnsTz5CmZ6mI6S05sfQGEMrNrQcOEERbX46332IvE7pO/EUiw7jUrrS40z/M7kPyjfl04g==}
+  '@img/sharp-win32-x64@0.34.5':
+    resolution: {integrity: sha512-+29YMsqY2/9eFEiW93eqWnuLcWcufowXewwSNIT6UwZdUUCrM3oFjMWH/Z6/TMmb4hlFenmfAVbpWeup2jryCw==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [x64]
     os: [win32]
 
-  '@inquirer/ansi@1.0.1':
-    resolution: {integrity: sha512-yqq0aJW/5XPhi5xOAL1xRCpe1eh8UFVgYFpFsjEqmIR8rKLyP+HINvFXwUaxYICflJrVlxnp7lLN6As735kVpw==}
+  '@inquirer/ansi@1.0.2':
+    resolution: {integrity: sha512-S8qNSZiYzFd0wAcyG5AXCvUHC5Sr7xpZ9wZ2py9XR88jUz8wooStVx5M6dRzczbBWjic9NP7+rY0Xi7qqK/aMQ==}
     engines: {node: '>=18'}
 
-  '@inquirer/confirm@5.1.19':
-    resolution: {integrity: sha512-wQNz9cfcxrtEnUyG5PndC8g3gZ7lGDBzmWiXZkX8ot3vfZ+/BLjR8EvyGX4YzQLeVqtAlY/YScZpW7CW8qMoDQ==}
+  '@inquirer/confirm@5.1.21':
+    resolution: {integrity: sha512-KR8edRkIsUayMXV+o3Gv+q4jlhENF9nMYUZs9PA2HzrXeHI8M5uDag70U7RJn9yyiMZSbtF5/UexBtAVtZGSbQ==}
     engines: {node: '>=18'}
     peerDependencies:
       '@types/node': '>=18'
@@ -1527,8 +1391,8 @@ packages:
       '@types/node':
         optional: true
 
-  '@inquirer/core@10.3.0':
-    resolution: {integrity: sha512-Uv2aPPPSK5jeCplQmQ9xadnFx2Zhj9b5Dj7bU6ZeCdDNNY11nhYy4btcSdtDguHqCT2h5oNeQTcUNSGGLA7NTA==}
+  '@inquirer/core@10.3.2':
+    resolution: {integrity: sha512-43RTuEbfP8MbKzedNqBrlhhNKVwoK//vUFNW3Q3vZ88BLcrs4kYpGg+B2mm5p2K/HfygoCxuKwJJiv8PbGmE0A==}
     engines: {node: '>=18'}
     peerDependencies:
       '@types/node': '>=18'
@@ -1536,12 +1400,12 @@ packages:
       '@types/node':
         optional: true
 
-  '@inquirer/figures@1.0.14':
-    resolution: {integrity: sha512-DbFgdt+9/OZYFM+19dbpXOSeAstPy884FPy1KjDu4anWwymZeOYhMY1mdFri172htv6mvc/uvIAAi7b7tvjJBQ==}
+  '@inquirer/figures@1.0.15':
+    resolution: {integrity: sha512-t2IEY+unGHOzAaVM5Xx6DEWKeXlDDcNPeDyUpsRc6CUhBfU3VQOEl+Vssh7VNp1dR8MdUJBWhuObjXCsVpjN5g==}
     engines: {node: '>=18'}
 
-  '@inquirer/type@3.0.9':
-    resolution: {integrity: sha512-QPaNt/nmE2bLGQa9b7wwyRJoLZ7pN6rcyXvzU0YCmivmJyq1BVo94G98tStRWkoD1RgDX5C+dPlhhHzNdu/W/w==}
+  '@inquirer/type@3.0.10':
+    resolution: {integrity: sha512-BvziSRxfz5Ov8ch0z/n3oijRSEcEsHnhggm4xFZe93DHcUCTlutlq9Ox4SVENAfcRD22UQq7T/atg9Wr3k09eA==}
     engines: {node: '>=18'}
     peerDependencies:
       '@types/node': '>=18'
@@ -1569,8 +1433,8 @@ packages:
   '@jridgewell/sourcemap-codec@1.5.5':
     resolution: {integrity: sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==}
 
-  '@jridgewell/trace-mapping@0.3.30':
-    resolution: {integrity: sha512-GQ7Nw5G2lTu/BtHTKfXhKHok2WGetd4XYcVKGx00SjAk8GMwgJM3zr6zORiPGuOE+/vkc90KtTosSSvaCjKb2Q==}
+  '@jridgewell/trace-mapping@0.3.31':
+    resolution: {integrity: sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==}
 
   '@jsep-plugin/assignment@1.3.0':
     resolution: {integrity: sha512-VVgV+CXrhbMI3aSusQyclHkenWSAm95WaiKrMxRFam3JSUiIaQjoMIw2sEs/OX4XifnqeQUN4DYbJjlA8EfktQ==}
@@ -1691,8 +1555,8 @@ packages:
   '@open-draft/until@2.1.0':
     resolution: {integrity: sha512-U69T3ItWHvLwGg5eJ0n3I62nWuE6ilHlmz7zM0npLBRvPRd7e6NYmg54vvRtP5mZG7kZqZCFVdsTWo7BPtBujg==}
 
-  '@opentelemetry/api-logs@0.208.0':
-    resolution: {integrity: sha512-CjruKY9V6NMssL/T1kAFgzosF1v9o6oeN+aX5JB/C/xPNtmgIJqcXHG7fA82Ou1zCpWGl4lROQUKwUNE1pMCyg==}
+  '@opentelemetry/api-logs@0.209.0':
+    resolution: {integrity: sha512-xomnUNi7TiAGtOgs0tb54LyrjRZLu9shJGGwkcN7NgtiPYOpNnKLkRJtzZvTjD/w6knSZH9sFZcUSUovYOPg6A==}
     engines: {node: '>=8.0.0'}
 
   '@opentelemetry/api@1.9.0':
@@ -1843,8 +1707,8 @@ packages:
     peerDependencies:
       '@opentelemetry/api': ^1.7.0
 
-  '@opentelemetry/instrumentation@0.208.0':
-    resolution: {integrity: sha512-Eju0L4qWcQS+oXxi6pgh7zvE2byogAkcsVv0OjHF/97iOz1N/aKE6etSGowYkie+YA1uo6DNwdSxaaNnLvcRlA==}
+  '@opentelemetry/instrumentation@0.209.0':
+    resolution: {integrity: sha512-Cwe863ojTCnFlxVuuhG7s6ODkAOzKsAEthKAcI4MDRYz1OmGWYnmSl4X2pbyS+hBxVTdvfZePfoEA01IjqcEyw==}
     engines: {node: ^18.19.0 || >=20.6.0}
     peerDependencies:
       '@opentelemetry/api': ^1.3.0
@@ -1865,8 +1729,8 @@ packages:
     peerDependencies:
       '@opentelemetry/api': '>=1.3.0 <1.10.0'
 
-  '@opentelemetry/semantic-conventions@1.37.0':
-    resolution: {integrity: sha512-JD6DerIKdJGmRp4jQyX5FlrQjA4tjOw1cvfsPAZXfOOEErMUHjPcPSICS+6WnM0nB0efSFARh0KAZss+bvExOA==}
+  '@opentelemetry/semantic-conventions@1.38.0':
+    resolution: {integrity: sha512-kocjix+/sSggfJhwXqClZ3i9Y/MI0fp7b+g7kCRm6psy2dsf8uApTRclwG18h8Avm7C9+fnt+O36PspJ/OzoWg==}
     engines: {node: '>=14'}
 
   '@opentelemetry/sql-common@0.41.2':
@@ -1958,6 +1822,19 @@ packages:
   '@radix-ui/primitive@1.1.3':
     resolution: {integrity: sha512-JTF99U/6XIjCBo0wqkU5sK10glYe27MRRsfwoiq5zzOEZLHU3A3KCMa5X/azekYRCJ0HlwI0crAXS/5dEHTzDg==}
 
+  '@radix-ui/react-accordion@1.2.12':
+    resolution: {integrity: sha512-T4nygeh9YE9dLRPhAHSeOZi7HBXo+0kYIPJXayZfvWOWA0+n3dESrZbjfDPUABkUNym6Hd+f2IR113To8D2GPA==}
+    peerDependencies:
+      '@types/react': '*'
+      '@types/react-dom': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+      react-dom: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+      '@types/react-dom':
+        optional: true
+
   '@radix-ui/react-alert-dialog@1.1.15':
     resolution: {integrity: sha512-oTVLkEw5GpdRe29BqJ0LSDFWI3qu0vR1M0mUkOQWDIUnY/QIkLpgDMWuKxP94c2NAC2LGcgVhG1ImF3jkZ5wXw==}
     peerDependencies:
@@ -2242,6 +2119,19 @@ packages:
       '@types/react-dom':
         optional: true
 
+  '@radix-ui/react-primitive@2.1.4':
+    resolution: {integrity: sha512-9hQc4+GNVtJAIEPEqlYqW5RiYdrr8ea5XQ0ZOnD6fgru+83kqT15mq2OCcbe8KnjRZl5vF3ks69AKz3kh1jrhg==}
+    peerDependencies:
+      '@types/react': '*'
+      '@types/react-dom': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+      react-dom: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+      '@types/react-dom':
+        optional: true
+
   '@radix-ui/react-radio-group@1.3.8':
     resolution: {integrity: sha512-VBKYIYImA5zsxACdisNQ3BjCBfmbGH3kQlnFVqlWU4tXwjy7cGX8ta80BcrO+WJXIn5iBylEH3K6ZTlee//lgQ==}
     peerDependencies:
@@ -2307,6 +2197,19 @@ packages:
       '@types/react-dom':
         optional: true
 
+  '@radix-ui/react-slider@1.3.6':
+    resolution: {integrity: sha512-JPYb1GuM1bxfjMRlNLE+BcmBC8onfCi60Blk7OBqi2MLTFdS+8401U4uFjnwkOr49BLmXxLC6JHkvAsx5OJvHw==}
+    peerDependencies:
+      '@types/react': '*'
+      '@types/react-dom': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+      react-dom: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+      '@types/react-dom':
+        optional: true
+
   '@radix-ui/react-slot@1.2.3':
     resolution: {integrity: sha512-aeNmHnBxbi2St0au6VBVC7JXFlhLlOnvIIlePNniyUNAClzmtAUEY8/pBiK3iHjufOlwA+c20/8jngo7xcrg8A==}
     peerDependencies:
@@ -2316,6 +2219,15 @@ packages:
       '@types/react':
         optional: true
 
+  '@radix-ui/react-slot@1.2.4':
+    resolution: {integrity: sha512-Jl+bCv8HxKnlTLVrcDE8zTMJ09R9/ukw4qBs/oZClOfoQk/cOTbDn+NceXfV7j09YPVQUryJPHurafcSg6EVKA==}
+    peerDependencies:
+      '@types/react': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+
   '@radix-ui/react-switch@1.2.6':
     resolution: {integrity: sha512-bByzr1+ep1zk4VubeEVViV592vu2lHE2BZY5OnzehZqOOgogN80+mNtCqPkhn2gklJqOpxWgPoYTSnhBCqpOXQ==}
     peerDependencies:
@@ -2465,8 +2377,8 @@ packages:
   '@radix-ui/rect@1.1.1':
     resolution: {integrity: sha512-HPwpGIzkl28mWyZqG52jiqDJ12waP11Pa1lGoiyUkIEuMLBP0oeK/C89esbXrxsky5we7dfd8U58nm0SgAWpVw==}
 
-  '@reduxjs/toolkit@2.9.0':
-    resolution: {integrity: sha512-fSfQlSRu9Z5yBkvsNhYF2rPS8cGXn/TZVrlwN1948QyZ8xMZ0JvP50S2acZNaf+o63u6aEeMjipFyksjIcWrog==}
+  '@reduxjs/toolkit@2.11.2':
+    resolution: {integrity: sha512-Kd6kAHTA6/nUpp8mySPqj3en3dm0tdMIgbttnQ1xFMVpufoj+ADi8pXLBsd4xzTRHQa7t/Jv8W5UnCuW4kuWMQ==}
     peerDependencies:
       react: ^16.9.0 || ^17.0.0 || ^18 || ^19
       react-redux: ^7.2.1 || ^8.1.3 || ^9.0.0
@@ -2476,24 +2388,24 @@ packages:
       react-redux:
         optional: true
 
-  '@rjsf/core@5.24.13':
-    resolution: {integrity: sha512-ONTr14s7LFIjx2VRFLuOpagL76sM/HPy6/OhdBfq6UukINmTIs6+aFN0GgcR0aXQHFDXQ7f/fel0o/SO05Htdg==}
-    engines: {node: '>=14'}
+  '@rjsf/core@6.1.2':
+    resolution: {integrity: sha512-fcEO6kArMcVIzTBoBxNStqxzAL417NDw049nmNx11pIcMwUnU5sAkSW18c8kgZOT6v1xaZhQrY+X5cBzzHy9+g==}
+    engines: {node: '>=20'}
     peerDependencies:
-      '@rjsf/utils': ^5.24.x
-      react: ^16.14.0 || >=17
+      '@rjsf/utils': ^6.x
+      react: '>=18'
 
-  '@rjsf/utils@5.24.13':
-    resolution: {integrity: sha512-rNF8tDxIwTtXzz5O/U23QU73nlhgQNYJ+Sv5BAwQOIyhIE2Z3S5tUiSVMwZHt0julkv/Ryfwi+qsD4FiE5rOuw==}
-    engines: {node: '>=14'}
+  '@rjsf/utils@6.1.2':
+    resolution: {integrity: sha512-Px3FIkE1KK0745Qng9v88RZ0O7hcLf/1JUu0j00g+r6C8Zyokna42Hz/5TKyyQSKJqgVYcj2Z47YroVLenUM3A==}
+    engines: {node: '>=20'}
     peerDependencies:
-      react: ^16.14.0 || >=17
+      react: '>=18'
 
-  '@rjsf/validator-ajv8@5.24.13':
-    resolution: {integrity: sha512-oWHP7YK581M8I5cF1t+UXFavnv+bhcqjtL1a7MG/Kaffi0EwhgcYjODrD8SsnrhncsEYMqSECr4ZOEoirnEUWw==}
-    engines: {node: '>=14'}
+  '@rjsf/validator-ajv8@6.1.2':
+    resolution: {integrity: sha512-9P3np2d+TaZcFTEFLocbj19fqrAWB/bxtY0Y8EjP8Oiz8LL+/wUITaN3Wx9uxzWerJyphfpZXWhUS9XkllDLig==}
+    engines: {node: '>=20'}
     peerDependencies:
-      '@rjsf/utils': ^5.24.x
+      '@rjsf/utils': ^6.x
 
   '@rollup/plugin-commonjs@28.0.1':
     resolution: {integrity: sha512-+tNWdlWKbpB3WgBN7ijjYkq9X5uhjmcvyjEght4NmH5fAU++zfQzAJ6wumLS+dNcvwEZhKx2Z+skY8m7v0wGSA==}
@@ -2513,113 +2425,128 @@ packages:
       rollup:
         optional: true
 
-  '@rollup/rollup-android-arm-eabi@4.52.2':
-    resolution: {integrity: sha512-o3pcKzJgSGt4d74lSZ+OCnHwkKBeAbFDmbEm5gg70eA8VkyCuC/zV9TwBnmw6VjDlRdF4Pshfb+WE9E6XY1PoQ==}
+  '@rollup/rollup-android-arm-eabi@4.55.1':
+    resolution: {integrity: sha512-9R0DM/ykwfGIlNu6+2U09ga0WXeZ9MRC2Ter8jnz8415VbuIykVuc6bhdrbORFZANDmTDvq26mJrEVTl8TdnDg==}
     cpu: [arm]
     os: [android]
 
-  '@rollup/rollup-android-arm64@4.52.2':
-    resolution: {integrity: sha512-cqFSWO5tX2vhC9hJTK8WAiPIm4Q8q/cU8j2HQA0L3E1uXvBYbOZMhE2oFL8n2pKB5sOCHY6bBuHaRwG7TkfJyw==}
+  '@rollup/rollup-android-arm64@4.55.1':
+    resolution: {integrity: sha512-eFZCb1YUqhTysgW3sj/55du5cG57S7UTNtdMjCW7LwVcj3dTTcowCsC8p7uBdzKsZYa8J7IDE8lhMI+HX1vQvg==}
     cpu: [arm64]
     os: [android]
 
-  '@rollup/rollup-darwin-arm64@4.52.2':
-    resolution: {integrity: sha512-vngduywkkv8Fkh3wIZf5nFPXzWsNsVu1kvtLETWxTFf/5opZmflgVSeLgdHR56RQh71xhPhWoOkEBvbehwTlVA==}
+  '@rollup/rollup-darwin-arm64@4.55.1':
+    resolution: {integrity: sha512-p3grE2PHcQm2e8PSGZdzIhCKbMCw/xi9XvMPErPhwO17vxtvCN5FEA2mSLgmKlCjHGMQTP6phuQTYWUnKewwGg==}
     cpu: [arm64]
     os: [darwin]
 
-  '@rollup/rollup-darwin-x64@4.52.2':
-    resolution: {integrity: sha512-h11KikYrUCYTrDj6h939hhMNlqU2fo/X4NB0OZcys3fya49o1hmFaczAiJWVAFgrM1NCP6RrO7lQKeVYSKBPSQ==}
+  '@rollup/rollup-darwin-x64@4.55.1':
+    resolution: {integrity: sha512-rDUjG25C9qoTm+e02Esi+aqTKSBYwVTaoS1wxcN47/Luqef57Vgp96xNANwt5npq9GDxsH7kXxNkJVEsWEOEaQ==}
     cpu: [x64]
     os: [darwin]
 
-  '@rollup/rollup-freebsd-arm64@4.52.2':
-    resolution: {integrity: sha512-/eg4CI61ZUkLXxMHyVlmlGrSQZ34xqWlZNW43IAU4RmdzWEx0mQJ2mN/Cx4IHLVZFL6UBGAh+/GXhgvGb+nVxw==}
+  '@rollup/rollup-freebsd-arm64@4.55.1':
+    resolution: {integrity: sha512-+JiU7Jbp5cdxekIgdte0jfcu5oqw4GCKr6i3PJTlXTCU5H5Fvtkpbs4XJHRmWNXF+hKmn4v7ogI5OQPaupJgOg==}
     cpu: [arm64]
     os: [freebsd]
 
-  '@rollup/rollup-freebsd-x64@4.52.2':
-    resolution: {integrity: sha512-QOWgFH5X9+p+S1NAfOqc0z8qEpJIoUHf7OWjNUGOeW18Mx22lAUOiA9b6r2/vpzLdfxi/f+VWsYjUOMCcYh0Ng==}
+  '@rollup/rollup-freebsd-x64@4.55.1':
+    resolution: {integrity: sha512-V5xC1tOVWtLLmr3YUk2f6EJK4qksksOYiz/TCsFHu/R+woubcLWdC9nZQmwjOAbmExBIVKsm1/wKmEy4z4u4Bw==}
     cpu: [x64]
     os: [freebsd]
 
-  '@rollup/rollup-linux-arm-gnueabihf@4.52.2':
-    resolution: {integrity: sha512-kDWSPafToDd8LcBYd1t5jw7bD5Ojcu12S3uT372e5HKPzQt532vW+rGFFOaiR0opxePyUkHrwz8iWYEyH1IIQA==}
+  '@rollup/rollup-linux-arm-gnueabihf@4.55.1':
+    resolution: {integrity: sha512-Rn3n+FUk2J5VWx+ywrG/HGPTD9jXNbicRtTM11e/uorplArnXZYsVifnPPqNNP5BsO3roI4n8332ukpY/zN7rQ==}
     cpu: [arm]
     os: [linux]
 
-  '@rollup/rollup-linux-arm-musleabihf@4.52.2':
-    resolution: {integrity: sha512-gKm7Mk9wCv6/rkzwCiUC4KnevYhlf8ztBrDRT9g/u//1fZLapSRc+eDZj2Eu2wpJ+0RzUKgtNijnVIB4ZxyL+w==}
+  '@rollup/rollup-linux-arm-musleabihf@4.55.1':
+    resolution: {integrity: sha512-grPNWydeKtc1aEdrJDWk4opD7nFtQbMmV7769hiAaYyUKCT1faPRm2av8CX1YJsZ4TLAZcg9gTR1KvEzoLjXkg==}
     cpu: [arm]
     os: [linux]
 
-  '@rollup/rollup-linux-arm64-gnu@4.52.2':
-    resolution: {integrity: sha512-66lA8vnj5mB/rtDNwPgrrKUOtCLVQypkyDa2gMfOefXK6rcZAxKLO9Fy3GkW8VkPnENv9hBkNOFfGLf6rNKGUg==}
+  '@rollup/rollup-linux-arm64-gnu@4.55.1':
+    resolution: {integrity: sha512-a59mwd1k6x8tXKcUxSyISiquLwB5pX+fJW9TkWU46lCqD/GRDe9uDN31jrMmVP3feI3mhAdvcCClhV8V5MhJFQ==}
     cpu: [arm64]
     os: [linux]
 
-  '@rollup/rollup-linux-arm64-musl@4.52.2':
-    resolution: {integrity: sha512-s+OPucLNdJHvuZHuIz2WwncJ+SfWHFEmlC5nKMUgAelUeBUnlB4wt7rXWiyG4Zn07uY2Dd+SGyVa9oyLkVGOjA==}
+  '@rollup/rollup-linux-arm64-musl@4.55.1':
+    resolution: {integrity: sha512-puS1MEgWX5GsHSoiAsF0TYrpomdvkaXm0CofIMG5uVkP6IBV+ZO9xhC5YEN49nsgYo1DuuMquF9+7EDBVYu4uA==}
     cpu: [arm64]
     os: [linux]
 
-  '@rollup/rollup-linux-loong64-gnu@4.52.2':
-    resolution: {integrity: sha512-8wTRM3+gVMDLLDdaT6tKmOE3lJyRy9NpJUS/ZRWmLCmOPIJhVyXwjBo+XbrrwtV33Em1/eCTd5TuGJm4+DmYjw==}
+  '@rollup/rollup-linux-loong64-gnu@4.55.1':
+    resolution: {integrity: sha512-r3Wv40in+lTsULSb6nnoudVbARdOwb2u5fpeoOAZjFLznp6tDU8kd+GTHmJoqZ9lt6/Sys33KdIHUaQihFcu7g==}
     cpu: [loong64]
     os: [linux]
 
-  '@rollup/rollup-linux-ppc64-gnu@4.52.2':
-    resolution: {integrity: sha512-6yqEfgJ1anIeuP2P/zhtfBlDpXUb80t8DpbYwXQ3bQd95JMvUaqiX+fKqYqUwZXqdJDd8xdilNtsHM2N0cFm6A==}
+  '@rollup/rollup-linux-loong64-musl@4.55.1':
+    resolution: {integrity: sha512-MR8c0+UxAlB22Fq4R+aQSPBayvYa3+9DrwG/i1TKQXFYEaoW3B5b/rkSRIypcZDdWjWnpcvxbNaAJDcSbJU3Lw==}
+    cpu: [loong64]
+    os: [linux]
+
+  '@rollup/rollup-linux-ppc64-gnu@4.55.1':
+    resolution: {integrity: sha512-3KhoECe1BRlSYpMTeVrD4sh2Pw2xgt4jzNSZIIPLFEsnQn9gAnZagW9+VqDqAHgm1Xc77LzJOo2LdigS5qZ+gw==}
     cpu: [ppc64]
     os: [linux]
 
-  '@rollup/rollup-linux-riscv64-gnu@4.52.2':
-    resolution: {integrity: sha512-sshYUiYVSEI2B6dp4jMncwxbrUqRdNApF2c3bhtLAU0qA8Lrri0p0NauOsTWh3yCCCDyBOjESHMExonp7Nzc0w==}
+  '@rollup/rollup-linux-ppc64-musl@4.55.1':
+    resolution: {integrity: sha512-ziR1OuZx0vdYZZ30vueNZTg73alF59DicYrPViG0NEgDVN8/Jl87zkAPu4u6VjZST2llgEUjaiNl9JM6HH1Vdw==}
+    cpu: [ppc64]
+    os: [linux]
+
+  '@rollup/rollup-linux-riscv64-gnu@4.55.1':
+    resolution: {integrity: sha512-uW0Y12ih2XJRERZ4jAfKamTyIHVMPQnTZcQjme2HMVDAHY4amf5u414OqNYC+x+LzRdRcnIG1YodLrrtA8xsxw==}
     cpu: [riscv64]
     os: [linux]
 
-  '@rollup/rollup-linux-riscv64-musl@4.52.2':
-    resolution: {integrity: sha512-duBLgd+3pqC4MMwBrKkFxaZerUxZcYApQVC5SdbF5/e/589GwVvlRUnyqMFbM8iUSb1BaoX/3fRL7hB9m2Pj8Q==}
+  '@rollup/rollup-linux-riscv64-musl@4.55.1':
+    resolution: {integrity: sha512-u9yZ0jUkOED1BFrqu3BwMQoixvGHGZ+JhJNkNKY/hyoEgOwlqKb62qu+7UjbPSHYjiVy8kKJHvXKv5coH4wDeg==}
     cpu: [riscv64]
     os: [linux]
 
-  '@rollup/rollup-linux-s390x-gnu@4.52.2':
-    resolution: {integrity: sha512-tzhYJJidDUVGMgVyE+PmxENPHlvvqm1KILjjZhB8/xHYqAGeizh3GBGf9u6WdJpZrz1aCpIIHG0LgJgH9rVjHQ==}
+  '@rollup/rollup-linux-s390x-gnu@4.55.1':
+    resolution: {integrity: sha512-/0PenBCmqM4ZUd0190j7J0UsQ/1nsi735iPRakO8iPciE7BQ495Y6msPzaOmvx0/pn+eJVVlZrNrSh4WSYLxNg==}
     cpu: [s390x]
     os: [linux]
 
-  '@rollup/rollup-linux-x64-gnu@4.52.2':
-    resolution: {integrity: sha512-opH8GSUuVcCSSyHHcl5hELrmnk4waZoVpgn/4FDao9iyE4WpQhyWJ5ryl5M3ocp4qkRuHfyXnGqg8M9oKCEKRA==}
+  '@rollup/rollup-linux-x64-gnu@4.55.1':
+    resolution: {integrity: sha512-a8G4wiQxQG2BAvo+gU6XrReRRqj+pLS2NGXKm8io19goR+K8lw269eTrPkSdDTALwMmJp4th2Uh0D8J9bEV1vg==}
     cpu: [x64]
     os: [linux]
 
-  '@rollup/rollup-linux-x64-musl@4.52.2':
-    resolution: {integrity: sha512-LSeBHnGli1pPKVJ79ZVJgeZWWZXkEe/5o8kcn23M8eMKCUANejchJbF/JqzM4RRjOJfNRhKJk8FuqL1GKjF5oQ==}
+  '@rollup/rollup-linux-x64-musl@4.55.1':
+    resolution: {integrity: sha512-bD+zjpFrMpP/hqkfEcnjXWHMw5BIghGisOKPj+2NaNDuVT+8Ds4mPf3XcPHuat1tz89WRL+1wbcxKY3WSbiT7w==}
     cpu: [x64]
     os: [linux]
 
-  '@rollup/rollup-openharmony-arm64@4.52.2':
-    resolution: {integrity: sha512-uPj7MQ6/s+/GOpolavm6BPo+6CbhbKYyZHUDvZ/SmJM7pfDBgdGisFX3bY/CBDMg2ZO4utfhlApkSfZ92yXw7Q==}
+  '@rollup/rollup-openbsd-x64@4.55.1':
+    resolution: {integrity: sha512-eLXw0dOiqE4QmvikfQ6yjgkg/xDM+MdU9YJuP4ySTibXU0oAvnEWXt7UDJmD4UkYialMfOGFPJnIHSe/kdzPxg==}
+    cpu: [x64]
+    os: [openbsd]
+
+  '@rollup/rollup-openharmony-arm64@4.55.1':
+    resolution: {integrity: sha512-xzm44KgEP11te3S2HCSyYf5zIzWmx3n8HDCc7EE59+lTcswEWNpvMLfd9uJvVX8LCg9QWG67Xt75AuHn4vgsXw==}
     cpu: [arm64]
     os: [openharmony]
 
-  '@rollup/rollup-win32-arm64-msvc@4.52.2':
-    resolution: {integrity: sha512-Z9MUCrSgIaUeeHAiNkm3cQyst2UhzjPraR3gYYfOjAuZI7tcFRTOD+4cHLPoS/3qinchth+V56vtqz1Tv+6KPA==}
+  '@rollup/rollup-win32-arm64-msvc@4.55.1':
+    resolution: {integrity: sha512-yR6Bl3tMC/gBok5cz/Qi0xYnVbIxGx5Fcf/ca0eB6/6JwOY+SRUcJfI0OpeTpPls7f194as62thCt/2BjxYN8g==}
     cpu: [arm64]
     os: [win32]
 
-  '@rollup/rollup-win32-ia32-msvc@4.52.2':
-    resolution: {integrity: sha512-+GnYBmpjldD3XQd+HMejo+0gJGwYIOfFeoBQv32xF/RUIvccUz20/V6Otdv+57NE70D5pa8W/jVGDoGq0oON4A==}
+  '@rollup/rollup-win32-ia32-msvc@4.55.1':
+    resolution: {integrity: sha512-3fZBidchE0eY0oFZBnekYCfg+5wAB0mbpCBuofh5mZuzIU/4jIVkbESmd2dOsFNS78b53CYv3OAtwqkZZmU5nA==}
     cpu: [ia32]
     os: [win32]
 
-  '@rollup/rollup-win32-x64-gnu@4.52.2':
-    resolution: {integrity: sha512-ApXFKluSB6kDQkAqZOKXBjiaqdF1BlKi+/eqnYe9Ee7U2K3pUDKsIyr8EYm/QDHTJIM+4X+lI0gJc3TTRhd+dA==}
+  '@rollup/rollup-win32-x64-gnu@4.55.1':
+    resolution: {integrity: sha512-xGGY5pXj69IxKb4yv/POoocPy/qmEGhimy/FoTpTSVju3FYXUQQMFCaZZXJVidsmGxRioZAwpThl/4zX41gRKg==}
     cpu: [x64]
     os: [win32]
 
-  '@rollup/rollup-win32-x64-msvc@4.52.2':
-    resolution: {integrity: sha512-ARz+Bs8kY6FtitYM96PqPEVvPXqEZmPZsSkXvyX19YzDqkCaIlhCieLLMI5hxO9SRZ2XtCtm8wxhy0iJ2jxNfw==}
+  '@rollup/rollup-win32-x64-msvc@4.55.1':
+    resolution: {integrity: sha512-SPEpaL6DX4rmcXtnhdrQYgzQ5W2uW3SCJch88lB2zImhJRhIIK44fkUrgIV/Q8yUNfw5oyZ5vkeQsZLhCb06lw==}
     cpu: [x64]
     os: [win32]
 
@@ -2648,10 +2575,6 @@ packages:
     resolution: {integrity: sha512-tKSzHq1hNzB619Ssrqo25cqdQJ84R3xSSLsUWEnkGO/wcXJvpZy94gwdoS+KmH18BB1iRRRGtnMxZcUkiPSesw==}
     engines: {node: '>=18'}
 
-  '@sentry/babel-plugin-component-annotate@4.3.0':
-    resolution: {integrity: sha512-OuxqBprXRyhe8Pkfyz/4yHQJc5c3lm+TmYWSSx8u48g5yKewSQDOxkiLU5pAk3WnbLPy8XwU/PN+2BG0YFU9Nw==}
-    engines: {node: '>= 14'}
-
   '@sentry/babel-plugin-component-annotate@4.6.1':
     resolution: {integrity: sha512-aSIk0vgBqv7PhX6/Eov+vlI4puCE0bRXzUG5HdCsHBpAfeMkI8Hva6kSOusnzKqs8bf04hU7s3Sf0XxGTj/1AA==}
     engines: {node: '>= 14'}
@@ -2660,115 +2583,59 @@ packages:
     resolution: {integrity: sha512-G8q362DdKp9y1b5qkQEmhTFzyWTOVB0ps1rflok0N6bVA75IEmSDX1pqJsNuY3qy14VsVHYVwQBJQsNltQLS0g==}
     engines: {node: '>=18'}
 
-  '@sentry/bundler-plugin-core@4.3.0':
-    resolution: {integrity: sha512-dmR4DJhJ4jqVWGWppuTL2blNFqOZZnt4aLkewbD1myFG3KVfUx8CrMQWEmGjkgPOtj5TO6xH9PyTJjXC6o5tnA==}
-    engines: {node: '>= 14'}
-
   '@sentry/bundler-plugin-core@4.6.1':
     resolution: {integrity: sha512-WPeRbnMXm927m4Kr69NTArPfI+p5/34FHftdCRI3LFPMyhZDzz6J3wLy4hzaVUgmMf10eLzmq2HGEMvpQmdynA==}
     engines: {node: '>= 14'}
 
-  '@sentry/cli-darwin@2.55.0':
-    resolution: {integrity: sha512-jGHE7SHHzqXUmnsmRLgorVH6nmMmTjQQXdPZbSL5tRtH8d3OIYrVNr5D72DSgD26XAPBDMV0ibqOQ9NKoiSpfA==}
+  '@sentry/cli-darwin@2.58.4':
+    resolution: {integrity: sha512-kbTD+P4X8O+nsNwPxCywtj3q22ecyRHWff98rdcmtRrvwz8CKi/T4Jxn/fnn2i4VEchy08OWBuZAqaA5Kh2hRQ==}
     engines: {node: '>=10'}
     os: [darwin]
 
-  '@sentry/cli-darwin@2.58.2':
-    resolution: {integrity: sha512-MArsb3zLhA2/cbd4rTm09SmTpnEuZCoZOpuZYkrpDw1qzBVJmRFA1W1hGAQ9puzBIk/ubY3EUhhzuU3zN2uD6w==}
-    engines: {node: '>=10'}
-    os: [darwin]
-
-  '@sentry/cli-linux-arm64@2.55.0':
-    resolution: {integrity: sha512-jNB/0/gFcOuDCaY/TqeuEpsy/k52dwyk1SOV3s1ku4DUsln6govTppeAGRewY3T1Rj9B2vgIWTrnB8KVh9+Rgg==}
+  '@sentry/cli-linux-arm64@2.58.4':
+    resolution: {integrity: sha512-0g0KwsOozkLtzN8/0+oMZoOuQ0o7W6O+hx+ydVU1bktaMGKEJLMAWxOQNjsh1TcBbNIXVOKM/I8l0ROhaAb8Ig==}
     engines: {node: '>=10'}
     cpu: [arm64]
     os: [linux, freebsd, android]
 
-  '@sentry/cli-linux-arm64@2.58.2':
-    resolution: {integrity: sha512-ay3OeObnbbPrt45cjeUyQjsx5ain1laj1tRszWj37NkKu55NZSp4QCg1gGBZ0gBGhckI9nInEsmKtix00alw2g==}
-    engines: {node: '>=10'}
-    cpu: [arm64]
-    os: [linux, freebsd, android]
-
-  '@sentry/cli-linux-arm@2.55.0':
-    resolution: {integrity: sha512-ATjU0PsiWADSPLF/kZroLZ7FPKd5W9TDWHVkKNwIUNTei702LFgTjNeRwOIzTgSvG3yTmVEqtwFQfFN/7hnVXQ==}
+  '@sentry/cli-linux-arm@2.58.4':
+    resolution: {integrity: sha512-rdQ8beTwnN48hv7iV7e7ZKucPec5NJkRdrrycMJMZlzGBPi56LqnclgsHySJ6Kfq506A2MNuQnKGaf/sBC9REA==}
     engines: {node: '>=10'}
     cpu: [arm]
     os: [linux, freebsd, android]
 
-  '@sentry/cli-linux-arm@2.58.2':
-    resolution: {integrity: sha512-HU9lTCzcHqCz/7Mt5n+cv+nFuJdc1hGD2h35Uo92GgxX3/IujNvOUfF+nMX9j6BXH6hUt73R5c0Ycq9+a3Parg==}
-    engines: {node: '>=10'}
-    cpu: [arm]
-    os: [linux, freebsd, android]
-
-  '@sentry/cli-linux-i686@2.55.0':
-    resolution: {integrity: sha512-8LZjo6PncTM6bWdaggscNOi5r7F/fqRREsCwvd51dcjGj7Kp1plqo9feEzYQ+jq+KUzVCiWfHrUjddFmYyZJrg==}
+  '@sentry/cli-linux-i686@2.58.4':
+    resolution: {integrity: sha512-NseoIQAFtkziHyjZNPTu1Gm1opeQHt7Wm1LbLrGWVIRvUOzlslO9/8i6wETUZ6TjlQxBVRgd3Q0lRBG2A8rFYA==}
     engines: {node: '>=10'}
     cpu: [x86, ia32]
     os: [linux, freebsd, android]
 
-  '@sentry/cli-linux-i686@2.58.2':
-    resolution: {integrity: sha512-CN9p0nfDFsAT1tTGBbzOUGkIllwS3hygOUyTK7LIm9z+UHw5uNgNVqdM/3Vg+02ymjkjISNB3/+mqEM5osGXdA==}
-    engines: {node: '>=10'}
-    cpu: [x86, ia32]
-    os: [linux, freebsd, android]
-
-  '@sentry/cli-linux-x64@2.55.0':
-    resolution: {integrity: sha512-5LUVvq74Yj2cZZy5g5o/54dcWEaX4rf3myTHy73AKhRj1PABtOkfexOLbF9xSrZy95WXWaXyeH+k5n5z/vtHfA==}
+  '@sentry/cli-linux-x64@2.58.4':
+    resolution: {integrity: sha512-d3Arz+OO/wJYTqCYlSN3Ktm+W8rynQ/IMtSZLK8nu0ryh5mJOh+9XlXY6oDXw4YlsM8qCRrNquR8iEI1Y/IH+Q==}
     engines: {node: '>=10'}
     cpu: [x64]
     os: [linux, freebsd, android]
 
-  '@sentry/cli-linux-x64@2.58.2':
-    resolution: {integrity: sha512-oX/LLfvWaJO50oBVOn4ZvG2SDWPq0MN8SV9eg5tt2nviq+Ryltfr7Rtoo+HfV+eyOlx1/ZXhq9Wm7OT3cQuz+A==}
-    engines: {node: '>=10'}
-    cpu: [x64]
-    os: [linux, freebsd, android]
-
-  '@sentry/cli-win32-arm64@2.55.0':
-    resolution: {integrity: sha512-cWIQdzm1pfLwPARsV6dUb8TVd6Y3V1A2VWxjTons3Ift6GvtVmiAe0OWL8t2Yt95i8v61kTD/6Tq21OAaogqzA==}
+  '@sentry/cli-win32-arm64@2.58.4':
+    resolution: {integrity: sha512-bqYrF43+jXdDBh0f8HIJU3tbvlOFtGyRjHB8AoRuMQv9TEDUfENZyCelhdjA+KwDKYl48R1Yasb4EHNzsoO83w==}
     engines: {node: '>=10'}
     cpu: [arm64]
     os: [win32]
 
-  '@sentry/cli-win32-arm64@2.58.2':
-    resolution: {integrity: sha512-+cl3x2HPVMpoSVGVM1IDWlAEREZrrVQj4xBb0TRKII7g3hUxRsAIcsrr7+tSkie++0FuH4go/b5fGAv51OEF3w==}
-    engines: {node: '>=10'}
-    cpu: [arm64]
-    os: [win32]
-
-  '@sentry/cli-win32-i686@2.55.0':
-    resolution: {integrity: sha512-ldepCn2t9r4I0wvgk7NRaA7coJyy4rTQAzM66u9j5nTEsUldf66xym6esd5ZZRAaJUjffqvHqUIr/lrieTIrVg==}
+  '@sentry/cli-win32-i686@2.58.4':
+    resolution: {integrity: sha512-3triFD6jyvhVcXOmGyttf+deKZcC1tURdhnmDUIBkiDPJKGT/N5xa4qAtHJlAB/h8L9jgYih9bvJnvvFVM7yug==}
     engines: {node: '>=10'}
     cpu: [x86, ia32]
     os: [win32]
 
-  '@sentry/cli-win32-i686@2.58.2':
-    resolution: {integrity: sha512-omFVr0FhzJ8oTJSg1Kf+gjLgzpYklY0XPfLxZ5iiMiYUKwF5uo1RJRdkUOiEAv0IqpUKnmKcmVCLaDxsWclB7Q==}
-    engines: {node: '>=10'}
-    cpu: [x86, ia32]
-    os: [win32]
-
-  '@sentry/cli-win32-x64@2.55.0':
-    resolution: {integrity: sha512-4hPc/I/9tXx+HLTdTGwlagtAfDSIa2AoTUP30tl32NAYQhx9a6niUbPAemK2qfxesiufJ7D2djX83rCw6WnJVA==}
+  '@sentry/cli-win32-x64@2.58.4':
+    resolution: {integrity: sha512-cSzN4PjM1RsCZ4pxMjI0VI7yNCkxiJ5jmWncyiwHXGiXrV1eXYdQ3n1LhUYLZ91CafyprR0OhDcE+RVZ26Qb5w==}
     engines: {node: '>=10'}
     cpu: [x64]
     os: [win32]
 
-  '@sentry/cli-win32-x64@2.58.2':
-    resolution: {integrity: sha512-2NAFs9UxVbRztQbgJSP5i8TB9eJQ7xraciwj/93djrSMHSEbJ0vC47TME0iifgvhlHMs5vqETOKJtfbbpQAQFA==}
-    engines: {node: '>=10'}
-    cpu: [x64]
-    os: [win32]
-
-  '@sentry/cli@2.55.0':
-    resolution: {integrity: sha512-cynvcIM2xL8ddwELyFRSpZQw4UtFZzoM2rId2l9vg7+wDREPDocMJB9lEQpBIo3eqhp9JswqUT037yjO6iJ5Sw==}
-    engines: {node: '>= 10'}
-    hasBin: true
-
-  '@sentry/cli@2.58.2':
-    resolution: {integrity: sha512-U4u62V4vaTWF+o40Mih8aOpQKqKUbZQt9A3LorIJwaE3tO3XFLRI70eWtW2se1Qmy0RZ74zB14nYcFNFl2t4Rw==}
+  '@sentry/cli@2.58.4':
+    resolution: {integrity: sha512-ArDrpuS8JtDYEvwGleVE+FgR+qHaOp77IgdGSacz6SZy6Lv90uX0Nu4UrHCQJz8/xwIcNxSqnN22lq0dH4IqTg==}
     engines: {node: '>= 10'}
     hasBin: true
 
@@ -2789,7 +2656,7 @@ packages:
       '@opentelemetry/api': ^1.9.0
       '@opentelemetry/context-async-hooks': ^1.30.1 || ^2.1.0 || ^2.2.0
       '@opentelemetry/core': ^1.30.1 || ^2.1.0 || ^2.2.0
-      '@opentelemetry/instrumentation': '>=0.57.1 <1'
+      '@opentelemetry/instrumentation': 0.209.0
       '@opentelemetry/resources': ^1.30.1 || ^2.1.0 || ^2.2.0
       '@opentelemetry/sdk-trace-base': ^1.30.1 || ^2.1.0 || ^2.2.0
       '@opentelemetry/semantic-conventions': ^1.37.0
@@ -2818,23 +2685,23 @@ packages:
     resolution: {integrity: sha512-uBfpOnzSNSd2ITMTMeX5bV9Jlci9iMyI+iOPuW8c3oc+0dITTN0OpKLyNd6nfm50bM5h/1qFVQrph+oFTrtuGQ==}
     engines: {node: '>=18'}
 
-  '@sentry/webpack-plugin@4.3.0':
-    resolution: {integrity: sha512-K4nU1SheK/tvyakBws2zfd+MN6hzmpW+wPTbSbDWn1+WL9+g9hsPh8hjFFiVe47AhhUoUZ3YgiH2HyeHXjHflA==}
+  '@sentry/webpack-plugin@4.6.1':
+    resolution: {integrity: sha512-CJgT/t2pQWsPsMx9VJ86goU/orCQhL2HhDj5ZYBol6fPPoEGeTqKOPCnv/xsbCAfGSp1uHpyRLTA/Gx96u7VVA==}
     engines: {node: '>= 14'}
     peerDependencies:
       webpack: '>=4.40.0'
 
-  '@shikijs/engine-oniguruma@3.14.0':
-    resolution: {integrity: sha512-TNcYTYMbJyy+ZjzWtt0bG5y4YyMIWC2nyePz+CFMWqm+HnZZyy9SWMgo8Z6KBJVIZnx8XUXS8U2afO6Y0g1Oug==}
+  '@shikijs/engine-oniguruma@3.21.0':
+    resolution: {integrity: sha512-OYknTCct6qiwpQDqDdf3iedRdzj6hFlOPv5hMvI+hkWfCKs5mlJ4TXziBG9nyabLwGulrUjHiCq3xCspSzErYQ==}
 
-  '@shikijs/langs@3.14.0':
-    resolution: {integrity: sha512-DIB2EQY7yPX1/ZH7lMcwrK5pl+ZkP/xoSpUzg9YC8R+evRCCiSQ7yyrvEyBsMnfZq4eBzLzBlugMyTAf13+pzg==}
+  '@shikijs/langs@3.21.0':
+    resolution: {integrity: sha512-g6mn5m+Y6GBJ4wxmBYqalK9Sp0CFkUqfNzUy2pJglUginz6ZpWbaWjDB4fbQ/8SHzFjYbtU6Ddlp1pc+PPNDVA==}
 
-  '@shikijs/themes@3.14.0':
-    resolution: {integrity: sha512-fAo/OnfWckNmv4uBoUu6dSlkcBc+SA1xzj5oUSaz5z3KqHtEbUypg/9xxgJARtM6+7RVm0Q6Xnty41xA1ma1IA==}
+  '@shikijs/themes@3.21.0':
+    resolution: {integrity: sha512-BAE4cr9EDiZyYzwIHEk7JTBJ9CzlPuM4PchfcA5ao1dWXb25nv6hYsoDiBq2aZK9E3dlt3WB78uI96UESD+8Mw==}
 
-  '@shikijs/types@3.14.0':
-    resolution: {integrity: sha512-bQGgC6vrY8U/9ObG1Z/vTro+uclbjjD/uG58RvfxKZVD5p9Yc1ka3tVyEFy7BNJLzxuWyHH5NWynP9zZZS59eQ==}
+  '@shikijs/types@3.21.0':
+    resolution: {integrity: sha512-zGrWOxZ0/+0ovPY7PvBU2gIS9tmhSUUt30jAcNV0Bq0gb2S98gwfjIs1vxlmH5zM7/4YxLamT6ChlqqAJmPPjA==}
 
   '@shikijs/vscode-textmate@10.0.2':
     resolution: {integrity: sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg==}
@@ -2842,6 +2709,9 @@ packages:
   '@standard-schema/spec@1.0.0':
     resolution: {integrity: sha512-m2bOd0f2RT9k8QJx1JN85cZYyH1RqFBdlwtkSlf4tBDYLCiiZnv1fIIwacK6cqwXavOydf0NPToMQgpKq+dVlA==}
 
+  '@standard-schema/spec@1.1.0':
+    resolution: {integrity: sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==}
+
   '@standard-schema/utils@0.3.0':
     resolution: {integrity: sha512-e7Mew686owMaPJVNNLs55PUvgz371nKgwsc4vxE49zsODpJEnxgxRo2y/OKrqueavXgZNMDVj3DdHFlaSAeU8g==}
 
@@ -2964,8 +2834,8 @@ packages:
   '@storybook/global@5.0.0':
     resolution: {integrity: sha512-FcOqPAXACP0I3oJ/ws6/rrPT9WGhu915Cg8D02a9YxLo0DE9zI+a9A5gRGvmQ09fiWPukqI8ZAEoQEdWUKMQdQ==}
 
-  '@storybook/icons@1.4.0':
-    resolution: {integrity: sha512-Td73IeJxOyalzvjQL+JXx72jlIYHgs+REaHiREOqfpo3A2AYYG71AUbcv+lg7mEDIweKVCxsMQ0UKo634c8XeA==}
+  '@storybook/icons@1.6.0':
+    resolution: {integrity: sha512-hcFZIjW8yQz8O8//2WTIXylm5Xsgc+lW9ISLgUk1xGmptIJQRdlhVIXCpSyLrQaaRiyhQRaVg7l3BD9S216BHw==}
     engines: {node: '>=14.0.0'}
     peerDependencies:
       react: ^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0-beta
@@ -3091,8 +2961,8 @@ packages:
     resolution: {integrity: sha512-o4PXJQidqJl82ckFaXUeoAW+XysPLauYI43Abki5hABd853iMhitooc6znOnczgbTYmEP6U6/y1ZyKAIsvMKGg==}
     engines: {node: '>=18'}
 
-  '@testing-library/jest-dom@6.8.0':
-    resolution: {integrity: sha512-WgXcWzVM6idy5JaftTVC8Vs83NKRmGJz4Hqs4oyOuO2J4r/y79vvKZsb+CaGyCSEbUPI6OsewfPd0G1A0/TUZQ==}
+  '@testing-library/jest-dom@6.9.1':
+    resolution: {integrity: sha512-zIcONa+hVtVSSep9UT3jZ5rizo2BsxgyDYU7WFD5eICBE7no3881HGeb/QkGfsJs6JTkY1aQhT7rIPC7e+0nnA==}
     engines: {node: '>=14', npm: '>=6', yarn: '>=1'}
 
   '@testing-library/user-event@14.6.1':
@@ -3122,14 +2992,14 @@ packages:
   '@types/canvas-confetti@1.9.0':
     resolution: {integrity: sha512-aBGj/dULrimR1XDZLtG9JwxX1b4HPRF6CX9Yfwh3NvstZEm1ZL7RBnel4keCPSqs1ANRu1u2Aoz9R+VmtjYuTg==}
 
-  '@types/chai@5.2.2':
-    resolution: {integrity: sha512-8kB30R7Hwqf40JPiKhVzodJs2Qc1ZJ5zuT3uzw5Hq/dhNCl3G3l83jfpdI1e20BP348+fV7VIL/+FxaXkqBmWg==}
+  '@types/chai@5.2.3':
+    resolution: {integrity: sha512-Mw558oeA9fFbv65/y4mHtXDs9bPnFMZAL/jxdPFUpOHHIXX91mcgEHbS5Lahr+pwZFR8A7GQleRWeI6cGFC2UA==}
 
   '@types/connect@3.4.38':
     resolution: {integrity: sha512-K6uROf1LD88uDQqJCktA4yzL1YYAK6NgfsI0v/mTgyPKWsX1CnJ0XPSDhViejru1GcRkLWb8RlzFYJRqGUbaug==}
 
-  '@types/d3-array@3.2.1':
-    resolution: {integrity: sha512-Y2Jn2idRrLzUfAKV2LyRImR+y4oa2AntrgID95SHJxuMUrkNXmanDSed71sRNZysveJVt1hLLemQZIady0FpEg==}
+  '@types/d3-array@3.2.2':
+    resolution: {integrity: sha512-hOLWVbm7uRza0BYXpIIW5pxfrKe0W+D5lrFiAEYR+pb6w3N2SwSMaJbXdUfSEv+dT4MfHBLtn5js0LAWaO6otw==}
 
   '@types/d3-color@3.1.3':
     resolution: {integrity: sha512-iO90scth9WAbmgv7ogoq57O9YpKmFBbmoEoCHDB2xMBY0+/KVrqAaCDyCE16dUspeOvIxFFRI+0sEtqDqy2b4A==}
@@ -3242,8 +3112,8 @@ packages:
   '@types/pg@8.15.6':
     resolution: {integrity: sha512-NoaMtzhxOrubeL/7UZuNTrejB4MPAJ0RpxZqXQf2qXuVlTPuG6Y8p4u9dKRaue4yjmC7ZhzVO2/Yyyn25znrPQ==}
 
-  '@types/phoenix@1.6.6':
-    resolution: {integrity: sha512-PIzZZlEppgrpoT2QgbnDU+MMzuR6BbCjllj0bM70lWoejMeNJAxCchxnv7J3XFkI8MpygtRpzXrIlmWUBclP5A==}
+  '@types/phoenix@1.6.7':
+    resolution: {integrity: sha512-oN9ive//QSBkf19rfDv45M7eZPi0eEXylht2OLEXicu5b4KoQ1OzXIw+xDSGWxSxe1JmepRR/ZH283vsu518/Q==}
 
   '@types/prop-types@15.7.15':
     resolution: {integrity: sha512-F6bEyamV9jKGAFBEmlQnesRPGOQqS2+Uwi0Em15xenOxHaf2hv6L8YCVn3rPdPJOiJfPiCnLIRyvwVaqMY3MIw==}
@@ -3271,9 +3141,6 @@ packages:
   '@types/statuses@2.0.6':
     resolution: {integrity: sha512-xMAgYwceFhRA2zY+XbEA7mxYbA093wdiW8Vu6gZPGWy9cmOyU9XesH1tNcEWsKFd5Vzrqx5T3D38PWx1FIIXkA==}
 
-  '@types/stylis@4.2.5':
-    resolution: {integrity: sha512-1Xve+NMN7FWjY14vLoY5tL3BVEQ/n42YLwaqJIPYhotZ9uBHt87VceMwWQpzmdEt2TNXIorIFG+YeCUUW7RInw==}
-
   '@types/tedious@4.0.14':
     resolution: {integrity: sha512-KHPsfX/FoVbUGbyYvk1q9MMQHLPeRZhRJZdO45Q4YjvFkv4hMNghCWTvy7rdKessBsmtz4euWCWAB6/tVpI1Iw==}
 
@@ -3292,137 +3159,63 @@ packages:
   '@types/ws@8.18.1':
     resolution: {integrity: sha512-ThVF6DCVhA8kUGy+aazFQ4kXQ7E1Ty7A3ypFOe0IcJV8O/M511G99AW24irKrW56Wt44yG9+ij8FaqoBGkuBXg==}
 
-  '@typescript-eslint/eslint-plugin@8.48.1':
-    resolution: {integrity: sha512-X63hI1bxl5ohelzr0LY5coufyl0LJNthld+abwxpCoo6Gq+hSqhKwci7MUWkXo67mzgUK6YFByhmaHmUcuBJmA==}
+  '@typescript-eslint/eslint-plugin@8.52.0':
+    resolution: {integrity: sha512-okqtOgqu2qmZJ5iN4TWlgfF171dZmx2FzdOv2K/ixL2LZWDStL8+JgQerI2sa8eAEfoydG9+0V96m7V+P8yE1Q==}
     engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
     peerDependencies:
-      '@typescript-eslint/parser': ^8.48.1
+      '@typescript-eslint/parser': ^8.52.0
       eslint: ^8.57.0 || ^9.0.0
       typescript: '>=4.8.4 <6.0.0'
 
-  '@typescript-eslint/parser@8.48.1':
-    resolution: {integrity: sha512-PC0PDZfJg8sP7cmKe6L3QIL8GZwU5aRvUFedqSIpw3B+QjRSUZeeITC2M5XKeMXEzL6wccN196iy3JLwKNvDVA==}
+  '@typescript-eslint/parser@8.52.0':
+    resolution: {integrity: sha512-iIACsx8pxRnguSYhHiMn2PvhvfpopO9FXHyn1mG5txZIsAaB6F0KwbFnUQN3KCiG3Jcuad/Cao2FAs1Wp7vAyg==}
     engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
     peerDependencies:
       eslint: ^8.57.0 || ^9.0.0
       typescript: '>=4.8.4 <6.0.0'
 
-  '@typescript-eslint/project-service@8.43.0':
-    resolution: {integrity: sha512-htB/+D/BIGoNTQYffZw4uM4NzzuolCoaA/BusuSIcC8YjmBYQioew5VUZAYdAETPjeed0hqCaW7EHg+Robq8uw==}
+  '@typescript-eslint/project-service@8.52.0':
+    resolution: {integrity: sha512-xD0MfdSdEmeFa3OmVqonHi+Cciab96ls1UhIF/qX/O/gPu5KXD0bY9lu33jj04fjzrXHcuvjBcBC+D3SNSadaw==}
     engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
     peerDependencies:
       typescript: '>=4.8.4 <6.0.0'
 
-  '@typescript-eslint/project-service@8.46.2':
-    resolution: {integrity: sha512-PULOLZ9iqwI7hXcmL4fVfIsBi6AN9YxRc0frbvmg8f+4hQAjQ5GYNKK0DIArNo+rOKmR/iBYwkpBmnIwin4wBg==}
+  '@typescript-eslint/scope-manager@8.52.0':
+    resolution: {integrity: sha512-ixxqmmCcc1Nf8S0mS0TkJ/3LKcC8mruYJPOU6Ia2F/zUUR4pApW7LzrpU3JmtePbRUTes9bEqRc1Gg4iyRnDzA==}
+    engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+
+  '@typescript-eslint/tsconfig-utils@8.52.0':
+    resolution: {integrity: sha512-jl+8fzr/SdzdxWJznq5nvoI7qn2tNYV/ZBAEcaFMVXf+K6jmXvAFrgo/+5rxgnL152f//pDEAYAhhBAZGrVfwg==}
     engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
     peerDependencies:
       typescript: '>=4.8.4 <6.0.0'
 
-  '@typescript-eslint/project-service@8.48.1':
-    resolution: {integrity: sha512-HQWSicah4s9z2/HifRPQ6b6R7G+SBx64JlFQpgSSHWPKdvCZX57XCbszg/bapbRsOEv42q5tayTYcEFpACcX1w==}
-    engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
-    peerDependencies:
-      typescript: '>=4.8.4 <6.0.0'
-
-  '@typescript-eslint/scope-manager@8.43.0':
-    resolution: {integrity: sha512-daSWlQ87ZhsjrbMLvpuuMAt3y4ba57AuvadcR7f3nl8eS3BjRc8L9VLxFLk92RL5xdXOg6IQ+qKjjqNEimGuAg==}
-    engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
-
-  '@typescript-eslint/scope-manager@8.46.2':
-    resolution: {integrity: sha512-LF4b/NmGvdWEHD2H4MsHD8ny6JpiVNDzrSZr3CsckEgCbAGZbYM4Cqxvi9L+WqDMT+51Ozy7lt2M+d0JLEuBqA==}
-    engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
-
-  '@typescript-eslint/scope-manager@8.48.1':
-    resolution: {integrity: sha512-rj4vWQsytQbLxC5Bf4XwZ0/CKd362DkWMUkviT7DCS057SK64D5lH74sSGzhI6PDD2HCEq02xAP9cX68dYyg1w==}
-    engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
-
-  '@typescript-eslint/tsconfig-utils@8.43.0':
-    resolution: {integrity: sha512-ALC2prjZcj2YqqL5X/bwWQmHA2em6/94GcbB/KKu5SX3EBDOsqztmmX1kMkvAJHzxk7TazKzJfFiEIagNV3qEA==}
-    engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
-    peerDependencies:
-      typescript: '>=4.8.4 <6.0.0'
-
-  '@typescript-eslint/tsconfig-utils@8.46.2':
-    resolution: {integrity: sha512-a7QH6fw4S57+F5y2FIxxSDyi5M4UfGF+Jl1bCGd7+L4KsaUY80GsiF/t0UoRFDHAguKlBaACWJRmdrc6Xfkkag==}
-    engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
-    peerDependencies:
-      typescript: '>=4.8.4 <6.0.0'
-
-  '@typescript-eslint/tsconfig-utils@8.48.1':
-    resolution: {integrity: sha512-k0Jhs4CpEffIBm6wPaCXBAD7jxBtrHjrSgtfCjUvPp9AZ78lXKdTR8fxyZO5y4vWNlOvYXRtngSZNSn+H53Jkw==}
-    engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
-    peerDependencies:
-      typescript: '>=4.8.4 <6.0.0'
-
-  '@typescript-eslint/type-utils@8.48.1':
-    resolution: {integrity: sha512-1jEop81a3LrJQLTf/1VfPQdhIY4PlGDBc/i67EVWObrtvcziysbLN3oReexHOM6N3jyXgCrkBsZpqwH0hiDOQg==}
+  '@typescript-eslint/type-utils@8.52.0':
+    resolution: {integrity: sha512-JD3wKBRWglYRQkAtsyGz1AewDu3mTc7NtRjR/ceTyGoPqmdS5oCdx/oZMWD5Zuqmo6/MpsYs0wp6axNt88/2EQ==}
     engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
     peerDependencies:
       eslint: ^8.57.0 || ^9.0.0
       typescript: '>=4.8.4 <6.0.0'
 
-  '@typescript-eslint/types@8.43.0':
-    resolution: {integrity: sha512-vQ2FZaxJpydjSZJKiSW/LJsabFFvV7KgLC5DiLhkBcykhQj8iK9BOaDmQt74nnKdLvceM5xmhaTF+pLekrxEkw==}
+  '@typescript-eslint/types@8.52.0':
+    resolution: {integrity: sha512-LWQV1V4q9V4cT4H5JCIx3481iIFxH1UkVk+ZkGGAV1ZGcjGI9IoFOfg3O6ywz8QqCDEp7Inlg6kovMofsNRaGg==}
     engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
 
-  '@typescript-eslint/types@8.46.2':
-    resolution: {integrity: sha512-lNCWCbq7rpg7qDsQrd3D6NyWYu+gkTENkG5IKYhUIcxSb59SQC/hEQ+MrG4sTgBVghTonNWq42bA/d4yYumldQ==}
-    engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
-
-  '@typescript-eslint/types@8.48.1':
-    resolution: {integrity: sha512-+fZ3LZNeiELGmimrujsDCT4CRIbq5oXdHe7chLiW8qzqyPMnn1puNstCrMNVAqwcl2FdIxkuJ4tOs/RFDBVc/Q==}
-    engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
-
-  '@typescript-eslint/typescript-estree@8.43.0':
-    resolution: {integrity: sha512-7Vv6zlAhPb+cvEpP06WXXy/ZByph9iL6BQRBDj4kmBsW98AqEeQHlj/13X+sZOrKSo9/rNKH4Ul4f6EICREFdw==}
+  '@typescript-eslint/typescript-estree@8.52.0':
+    resolution: {integrity: sha512-XP3LClsCc0FsTK5/frGjolyADTh3QmsLp6nKd476xNI9CsSsLnmn4f0jrzNoAulmxlmNIpeXuHYeEQv61Q6qeQ==}
     engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
     peerDependencies:
       typescript: '>=4.8.4 <6.0.0'
 
-  '@typescript-eslint/typescript-estree@8.46.2':
-    resolution: {integrity: sha512-f7rW7LJ2b7Uh2EiQ+7sza6RDZnajbNbemn54Ob6fRwQbgcIn+GWfyuHDHRYgRoZu1P4AayVScrRW+YfbTvPQoQ==}
-    engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
-    peerDependencies:
-      typescript: '>=4.8.4 <6.0.0'
-
-  '@typescript-eslint/typescript-estree@8.48.1':
-    resolution: {integrity: sha512-/9wQ4PqaefTK6POVTjJaYS0bynCgzh6ClJHGSBj06XEHjkfylzB+A3qvyaXnErEZSaxhIo4YdyBgq6j4RysxDg==}
-    engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
-    peerDependencies:
-      typescript: '>=4.8.4 <6.0.0'
-
-  '@typescript-eslint/utils@8.43.0':
-    resolution: {integrity: sha512-S1/tEmkUeeswxd0GGcnwuVQPFWo8NzZTOMxCvw8BX7OMxnNae+i8Tm7REQen/SwUIPoPqfKn7EaZ+YLpiB3k9g==}
+  '@typescript-eslint/utils@8.52.0':
+    resolution: {integrity: sha512-wYndVMWkweqHpEpwPhwqE2lnD2DxC6WVLupU/DOt/0/v+/+iQbbzO3jOHjmBMnhu0DgLULvOaU4h4pwHYi2oRQ==}
     engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
     peerDependencies:
       eslint: ^8.57.0 || ^9.0.0
       typescript: '>=4.8.4 <6.0.0'
 
-  '@typescript-eslint/utils@8.46.2':
-    resolution: {integrity: sha512-sExxzucx0Tud5tE0XqR0lT0psBQvEpnpiul9XbGUB1QwpWJJAps1O/Z7hJxLGiZLBKMCutjTzDgmd1muEhBnVg==}
-    engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
-    peerDependencies:
-      eslint: ^8.57.0 || ^9.0.0
-      typescript: '>=4.8.4 <6.0.0'
-
-  '@typescript-eslint/utils@8.48.1':
-    resolution: {integrity: sha512-fAnhLrDjiVfey5wwFRwrweyRlCmdz5ZxXz2G/4cLn0YDLjTapmN4gcCsTBR1N2rWnZSDeWpYtgLDsJt+FpmcwA==}
-    engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
-    peerDependencies:
-      eslint: ^8.57.0 || ^9.0.0
-      typescript: '>=4.8.4 <6.0.0'
-
-  '@typescript-eslint/visitor-keys@8.43.0':
-    resolution: {integrity: sha512-T+S1KqRD4sg/bHfLwrpF/K3gQLBM1n7Rp7OjjikjTEssI2YJzQpi5WXoynOaQ93ERIuq3O8RBTOUYDKszUCEHw==}
-    engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
-
-  '@typescript-eslint/visitor-keys@8.46.2':
-    resolution: {integrity: sha512-tUFMXI4gxzzMXt4xpGJEsBsTox0XbNQ1y94EwlD/CuZwFcQP79xfQqMhau9HsRc/J0cAPA/HZt1dZPtGn9V/7w==}
-    engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
-
-  '@typescript-eslint/visitor-keys@8.48.1':
-    resolution: {integrity: sha512-BmxxndzEWhE4TIEEMBs8lP3MBWN3jFPs/p6gPm/wkv02o41hI6cq9AuSmGAaTTHPtA1FTi2jBre4A9rm5ZmX+Q==}
+  '@typescript-eslint/visitor-keys@8.52.0':
+    resolution: {integrity: sha512-ink3/Zofus34nmBsPjow63FP5M7IGff0RKAgqR6+CFpdk22M7aLwC9gOcLGYqr7MczLPzZVERW9hRog3O4n1sQ==}
     engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
 
   '@ungap/structured-clone@1.3.0':
@@ -3640,6 +3433,9 @@ packages:
   '@webassemblyjs/wast-printer@1.14.1':
     resolution: {integrity: sha512-kPSSXE6De1XOR820C90RIo2ogvZG+c3KiHzqUoO/F34Y2shGzesfqv7o57xrxovZJH/MetF5UjroJ/R/3isoiw==}
 
+  '@x0k/json-schema-merge@1.0.2':
+    resolution: {integrity: sha512-1734qiJHNX3+cJGDMMw2yz7R+7kpbAtl5NdPs1c/0gO5kYT6s4dMbLXiIfpZNsOYhGZI3aH7FWrj4Zxz7epXNg==}
+
   '@xtuc/ieee754@1.2.0':
     resolution: {integrity: sha512-DX8nKgqcGwsc0eJSqYt5lwP4DH5FlHnmuWWBRy7X0NcaGR0ZtuyeESgMwTYVEtxmsNGY+qit4QYT/MIYTOTPeA==}
 
@@ -3848,12 +3644,8 @@ packages:
     resolution: {integrity: sha512-wvUjBtSGN7+7SjNpq/9M2Tg350UZD3q62IFZLbRAR1bSMlCo1ZaeW+BJ+D090e4hIIZLBcTDWe4Mh4jvUDajzQ==}
     engines: {node: '>= 0.4'}
 
-  axe-core@4.10.3:
-    resolution: {integrity: sha512-Xm7bpRXnDSX2YE2YFfBk2FnF0ep6tmG7xPh8iHee8MIcrgq762Nkce856dYtJYLkuIoYZvGfTs/PbZhideTcEg==}
-    engines: {node: '>=4'}
-
-  axe-core@4.11.0:
-    resolution: {integrity: sha512-ilYanEU8vxxBexpJd8cWM4ElSQq4QctCLKih0TSfjIfCQTeyH/6zVrmIJfLPrKTKJRbiG+cfnZbQIjAlJmF1jQ==}
+  axe-core@4.11.1:
+    resolution: {integrity: sha512-BASOg+YwO2C+346x3LZOeoovTIoTrRqEsqMa6fmfAV0P+U9mFr9NsyOEpiYvFjbc64NMrSswhV50WdXzdb/Z5A==}
     engines: {node: '>=4'}
 
   axe-html-reporter@2.2.11:
@@ -3902,6 +3694,10 @@ packages:
   base64-js@1.5.1:
     resolution: {integrity: sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==}
 
+  baseline-browser-mapping@2.9.11:
+    resolution: {integrity: sha512-Sg0xJUNDU1sJNGdfGWhVHX0kkZ+HWcvmVymJbj6NSgZZmW/8S9Y2HQ5euytnIgakgxN6papOAWiwDo1ctFDcoQ==}
+    hasBin: true
+
   better-opn@3.0.2:
     resolution: {integrity: sha512-aVNobHnJqLiUelTaHat9DZ1qM2w0C0Eym4LPI/3JxOnSokGVdsl1T1kN7TFvsEAD8G47A6VKQ0TVHqbBnYMJlQ==}
     engines: {node: '>=12.0.0'}
@@ -3951,15 +3747,15 @@ packages:
     resolution: {integrity: sha512-YBjSAiTqM04ZVei6sXighu679a3SqWORA3qZTEqZImnlkDIFtKc6pNutpjyZ8RJTjQtuYfeetkxM11GwoYXMIQ==}
     engines: {node: '>= 0.10'}
 
-  browserify-sign@4.2.3:
-    resolution: {integrity: sha512-JWCZW6SKhfhjJxO8Tyiiy+XYB7cqd2S5/+WeYHsKdNKFlCBhKbblba1A/HN/90YwtxKc8tCErjffZl++UNmGiw==}
-    engines: {node: '>= 0.12'}
+  browserify-sign@4.2.5:
+    resolution: {integrity: sha512-C2AUdAJg6rlM2W5QMp2Q4KGQMVBwR1lIimTsUnutJ8bMpW5B52pGpR2gEnNBNwijumDo5FojQ0L9JrXA8m4YEw==}
+    engines: {node: '>= 0.10'}
 
   browserify-zlib@0.2.0:
     resolution: {integrity: sha512-Z942RysHXmJrhqk88FmKBVq/v5tqmSkDz7p54G/MGyjMnCFFnC79XWNbg+Vta8W6Wb2qtSZTSxIGkJrRpCFEiA==}
 
-  browserslist@4.25.4:
-    resolution: {integrity: sha512-4jYpcjabC606xJ3kw2QwGEZKX0Aw7sgQdZCvIK9dhVSPh76BKo+C+btT1RRofH7B+8iNpEbgGNVWiLki5q93yg==}
+  browserslist@4.28.1:
+    resolution: {integrity: sha512-ZC5Bd0LgJXgwGqUknZY/vkUQ04r8NXnJZ3yYi4vDmSiZmC/pdSN0NbNRPxZpbtO4uAfDUAFffO8IZoM3Gj8IkA==}
     engines: {node: ^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7}
     hasBin: true
 
@@ -4001,11 +3797,8 @@ packages:
     resolution: {integrity: sha512-QOSvevhslijgYwRx6Rv7zKdMF8lbRmx+uQGx2+vDc+KI/eBnsy9kit5aj23AgGu3pa4t9AgwbnXWqS+iOY+2aA==}
     engines: {node: '>= 6'}
 
-  camelize@1.0.1:
-    resolution: {integrity: sha512-dU+Tx2fsypxTgtLoE36npi3UqcjSSMNYfkqgmoEhtZrraP5VWq0K7FkWVTYa8eMPtnU/G2txVsfdCJTn9uzpuQ==}
-
-  caniuse-lite@1.0.30001741:
-    resolution: {integrity: sha512-QGUGitqsc8ARjLdgAfxETDhRbJ0REsP6O3I96TAth/mVjh2cYzN2u+3AzPP3aVSm2FehEItaJw1xd+IGBXWeSw==}
+  caniuse-lite@1.0.30001762:
+    resolution: {integrity: sha512-PxZwGNvH7Ak8WX5iXzoK1KPZttBXNPuaOvI2ZYU7NrlM+d9Ov+TUvlLOBNGzVXAntMSMMlJPd+jY6ovrVjSmUw==}
 
   case-sensitive-paths-webpack-plugin@2.4.0:
     resolution: {integrity: sha512-roIFONhcxog0JSSWbvVAh3OocukmSgpqOH6YpMkCvav/ySIV3JKg4Dc8vYtQjYi/UxpNE36r/9v+VqTQqgkYmw==}
@@ -4034,8 +3827,8 @@ packages:
   character-reference-invalid@2.0.1:
     resolution: {integrity: sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw==}
 
-  check-error@2.1.1:
-    resolution: {integrity: sha512-OAlb+T7V4Op9OwdkjmguYRqncdlx5JiofwOAUkmTF+jNdHwzTaTs4sRAGpzLF3oOz5xAyDGrPgeIDFQmDOTiJw==}
+  check-error@2.1.3:
+    resolution: {integrity: sha512-PAJdDJusoxnwm1VwW07VWwUN1sl7smmC3OKggvndJFadxxDRyFJBX/ggnu/KE4kQAB7a3Dp8f/YXC1FlUprWmA==}
     engines: {node: '>= 16'}
 
   chokidar@3.6.0:
@@ -4119,13 +3912,6 @@ packages:
   color-name@1.1.4:
     resolution: {integrity: sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==}
 
-  color-string@1.9.1:
-    resolution: {integrity: sha512-shrVawQFojnZv6xM40anx4CkoDP+fZsw/ZerEMsW/pyzsRbElpsL/DBVW7q3ExxwusdNXI3lXpuhEZkzs8p5Eg==}
-
-  color@4.2.3:
-    resolution: {integrity: sha512-1rXeuUUiGGrykh+CeBdu5Ie7OJwinCgQY0bc7GCRxy5xVHy+moaqkpL/jqQq0MtQOeYcrqEz4abc5f0KtU7W4A==}
-    engines: {node: '>=12.5.0'}
-
   colorette@2.0.20:
     resolution: {integrity: sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w==}
 
@@ -4156,12 +3942,6 @@ packages:
   compare-versions@6.1.1:
     resolution: {integrity: sha512-4hm4VPpIecmlg59CHXnRDnqGplJFrbLG4aFEl5vl6cK1u76ws3LLvX7ikFnTDl5vo39sjWD6AaDPYodJp/NNHg==}
 
-  compute-gcd@1.2.1:
-    resolution: {integrity: sha512-TwMbxBNz0l71+8Sc4czv13h4kEqnchV9igQZBi6QUaz09dnz13juGnnaWWJTRsP3brxOoxeB4SA2WELLw1hCtg==}
-
-  compute-lcm@1.1.2:
-    resolution: {integrity: sha512-OFNPdQAXnQhDSKioX8/XYT6sdUlXwpeMjfd6ApxMJfyZ4GxmLR1xvMERctlYhlHwIiz6CSpBc2+qYKjHGZw4TQ==}
-
   concat-map@0.0.1:
     resolution: {integrity: sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==}
 
@@ -4186,11 +3966,11 @@ packages:
     resolution: {integrity: sha512-9Kr/j4O16ISv8zBBhJoi4bXOYNTkFLOqSL3UDB0njXxCXNezjeyVrJyGOWtgfs/q2km1gwBcfH8q1yEGoMYunA==}
     engines: {node: '>=18'}
 
-  core-js-compat@3.45.1:
-    resolution: {integrity: sha512-tqTt5T4PzsMIZ430XGviK4vzYSoeNJ6CXODi6c/voxOT6IZqBht5/EKaSNnYiEjjRYxjVz7DQIsOsY0XNi8PIA==}
+  core-js-compat@3.47.0:
+    resolution: {integrity: sha512-IGfuznZ/n7Kp9+nypamBhvwdwLsW6KC8IOaURw2doAK5e98AG3acVLdh0woOnEqCfUtS+Vu882JE4k/DAm3ItQ==}
 
-  core-js-pure@3.45.1:
-    resolution: {integrity: sha512-OHnWFKgTUshEU8MK+lOs1H8kC8GkTi9Z1tvNkxrCcw9wl3MJIO7q2ld77wjWn4/xuGrVu2X+nME1iIIPBSdyEQ==}
+  core-js-pure@3.47.0:
+    resolution: {integrity: sha512-BcxeDbzUrRnXGYIVAGFtcGQVNpFcUhVjr6W7F8XktvQW2iJP9e66GP6xdKotCRFlrxBvNIBrhwKteRXqMV86Nw==}
 
   core-util-is@1.0.3:
     resolution: {integrity: sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==}
@@ -4230,10 +4010,6 @@ packages:
     resolution: {integrity: sha512-r4ESw/IlusD17lgQi1O20Fa3qNnsckR126TdUuBgAu7GBYSIPvdNyONd3Zrxh0xCwA4+6w/TDArBPsMvhur+KQ==}
     engines: {node: '>= 0.10'}
 
-  css-color-keywords@1.0.0:
-    resolution: {integrity: sha512-FyyrDHZKEjXDpNJYvVsV960FiqQyXc/LlYmsxl2BcdMb2WPx0OGRVgTg55rPSyLSNMqP52R9r8geSp7apN3Ofg==}
-    engines: {node: '>=4'}
-
   css-loader@6.11.0:
     resolution: {integrity: sha512-CTJ+AEQJjq5NzLga5pE39qdiSV56F8ywCIsqNIRF0r7BDgWsN25aazToqAFg7ZrtA/U016xudB3ffgweORxX7g==}
     engines: {node: '>= 12.13.0'}
@@ -4249,9 +4025,6 @@ packages:
   css-select@4.3.0:
     resolution: {integrity: sha512-wPpOYtnsVontu2mODhA19JrqWxNsfdatRKd64kmpRbQgh1KtItko5sTnEpPdpSaJszTOhEMlF/RPz28qj4HqhQ==}
 
-  css-to-react-native@3.2.0:
-    resolution: {integrity: sha512-e8RKaLXMOFii+02mOlqwjbD00KSEKqblnpO9e++1aXS1fPQOpS1YoqdVHBqPjHNoxeF2mimzVqawm2KCbEdtHQ==}
-
   css-what@6.2.2:
     resolution: {integrity: sha512-u/O3vwbptzhMs3L1fQE82ZSLHQQfto5gyZzwteVIEyeaY5Fc7R4dapF/BvRoSYFeqfBk4m0V1Vafq5Pjv25wvA==}
     engines: {node: '>= 6'}
@@ -4264,8 +4037,8 @@ packages:
     engines: {node: '>=4'}
     hasBin: true
 
-  csstype@3.1.3:
-    resolution: {integrity: sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw==}
+  csstype@3.2.3:
+    resolution: {integrity: sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==}
 
   d3-array@3.2.4:
     resolution: {integrity: sha512-tdQAmyA18i4J7wprpYq8ClcxZy3SC31QMeByyCFyRt7BVHdREQZ5lpzoe5mFEYZUWe+oq8HBvk9JjpibyEV4Jg==}
@@ -4418,8 +4191,8 @@ packages:
   des.js@1.1.0:
     resolution: {integrity: sha512-r17GxjhUCjSRy8aiJpr8/UadFIzMzJGexI3Nmz4ADi9LYSFx4gTBp80+NaX/YsXWWLhpZ7v/v/ubEc/bCNfKwg==}
 
-  detect-libc@2.0.4:
-    resolution: {integrity: sha512-3UDv+G9CsCKO1WKMGw9fwq/SWJYbI0c5Y7LU1AXYoDdbhE2AHQ6N6Nb34sG8Fj7T5APy8qXDCKuuIHd1BR0tVA==}
+  detect-libc@2.1.2:
+    resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==}
     engines: {node: '>=8'}
 
   detect-node-es@1.1.0:
@@ -4428,6 +4201,9 @@ packages:
   devlop@1.1.0:
     resolution: {integrity: sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==}
 
+  dexie@4.2.1:
+    resolution: {integrity: sha512-Ckej0NS6jxQ4Po3OrSQBFddayRhTCic2DoCAG5zacOfOVB9P2Q5Xc5uL/nVa7ZVs+HdMnvUPzLFCB/JwpB6Csg==}
+
   didyoumean@1.2.2:
     resolution: {integrity: sha512-gxtyfqMg7GKyhQmb056K7M3xszy/myH8w+B4RT+QXBQsvAOdc3XymqDDPHx1BgPgsdAA5SIifona89YtRATDzw==}
 
@@ -4493,8 +4269,8 @@ packages:
   eastasianwidth@0.2.0:
     resolution: {integrity: sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==}
 
-  electron-to-chromium@1.5.214:
-    resolution: {integrity: sha512-TpvUNdha+X3ybfU78NoQatKvQEm1oq3lf2QbnmCEdw+Bd9RuIAY+hJTvq1avzHM0f7EJfnH3vbCnbzKzisc/9Q==}
+  electron-to-chromium@1.5.267:
+    resolution: {integrity: sha512-0Drusm6MVRXSOJpGbaSVgcQsuB4hEkMpHXaVstcPmhu5LIedxs1xNK/nIxmQIU/RPC0+1/o0AVZfBTkTNJOdUw==}
 
   elliptic@6.6.1:
     resolution: {integrity: sha512-RaddvvMatK2LJHqFJ+YA4WysVN5Ita9E35botqIYspQ4TkRAlCicdzKOjlyv/1Za5RyTNn7di//eEV0uTAfe3g==}
@@ -4525,8 +4301,8 @@ packages:
   endent@2.1.0:
     resolution: {integrity: sha512-r8VyPX7XL8U01Xgnb1CjZ3XV+z90cXIJ9JPE/R9SEC9vpw2P6CfsRPJmp20DppC5N7ZAMCmjYkJIa744Iyg96w==}
 
-  enhanced-resolve@5.18.3:
-    resolution: {integrity: sha512-d4lC8xfavMeBjzGr2vECC3fsGXziXZQyJxD868h2M/mBI3PwAuODxAkLkq5HYuvrPYcUtiLzsTo8U3PgX3Ocww==}
+  enhanced-resolve@5.18.4:
+    resolution: {integrity: sha512-LgQMM4WXU3QI+SYgEc2liRgznaD5ojbmY3sb8LxyguVkIg5FxdpTkvk72te2R38/TGKxH634oLxXRGY6d7AP+Q==}
     engines: {node: '>=10.13.0'}
 
   enquirer@2.4.1:
@@ -4548,14 +4324,14 @@ packages:
     resolution: {integrity: sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==}
     engines: {node: '>=6'}
 
-  error-ex@1.3.2:
-    resolution: {integrity: sha512-7dFHNmqeFSEt2ZBsCriorKnn3Z2pj+fd9kmI6QoWw4//DL+icEBfc0U7qJCisqrTsKTjw4fNFy2pW9OqStD84g==}
+  error-ex@1.3.4:
+    resolution: {integrity: sha512-sqQamAnR14VgCr1A618A3sGrygcpK+HEbenA/HiEAkkUwcZIIB/tgWqHFxWgOyDh4nB4JCRimh79dR5Ywc9MDQ==}
 
   error-stack-parser@2.1.4:
     resolution: {integrity: sha512-Sk5V6wVazPhq5MhpO+AUxJn5x7XSXGl1R93Vn7i+zS15KDVxQijejNCrz8340/2bgLBjR9GtEG8ZVKONDjcqGQ==}
 
-  es-abstract@1.24.0:
-    resolution: {integrity: sha512-WSzPgsdLtTcQwm4CROfS5ju2Wa1QQcVeT37jFjYzdFz1r9ahadC8B8/a4qxJxM+09F18iumCdRmlr96ZYkQvEg==}
+  es-abstract@1.24.1:
+    resolution: {integrity: sha512-zHXBLhP+QehSSbsS9Pt23Gg964240DPd6QCf8WpkqEXxQ7fhdZzYsocOr5u7apWonsS5EjZDmTF+/slGMyasvw==}
     engines: {node: '>= 0.4'}
 
   es-aggregate-error@1.0.14:
@@ -4570,13 +4346,16 @@ packages:
     resolution: {integrity: sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==}
     engines: {node: '>= 0.4'}
 
-  es-iterator-helpers@1.2.1:
-    resolution: {integrity: sha512-uDn+FE1yrDzyC0pCo961B2IHbdM8y/ACZsKD4dG6WqrjV53BADjwa7D+1aom2rsNVfLyDgU/eigvlJGJ08OQ4w==}
+  es-iterator-helpers@1.2.2:
+    resolution: {integrity: sha512-BrUQ0cPTB/IwXj23HtwHjS9n7O4h9FX94b4xc5zlTHxeLgTAdzYUDyy6KdExAl9lbN5rtfe44xpjpmj9grxs5w==}
     engines: {node: '>= 0.4'}
 
   es-module-lexer@1.7.0:
     resolution: {integrity: sha512-jEQoCwk8hyb2AZziIOLhDqpm5+2ww5uIE6lkO/6jcOCusfk6LhMHpXXfBLXTZ7Ydyt0j4VoUQv6uGNYbdW+kBA==}
 
+  es-module-lexer@2.0.0:
+    resolution: {integrity: sha512-5POEcUuZybH7IdmGsD8wlf0AI55wMecM9rVBTI/qEAy2c1kTOm3DjFYjrBdI2K3BaJjJYfYFeRtM0t9ssnRuxw==}
+
   es-object-atoms@1.1.1:
     resolution: {integrity: sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==}
     engines: {node: '>= 0.4'}
@@ -4593,8 +4372,8 @@ packages:
     resolution: {integrity: sha512-w+5mJ3GuFL+NjVtJlvydShqE1eN3h3PbI7/5LAsYJP/2qtuMXjfL2LpHSRqo4b4eSF5K/DH1JXKUAHSB2UW50g==}
     engines: {node: '>= 0.4'}
 
-  es-toolkit@1.39.10:
-    resolution: {integrity: sha512-E0iGnTtbDhkeczB0T+mxmoVlT4YNweEKBLq7oaU4p11mecdsZpNWOglI4895Vh4usbQ+LsJiuLuI2L0Vdmfm2w==}
+  es-toolkit@1.43.0:
+    resolution: {integrity: sha512-SKCT8AsWvYzBBuUqMk4NPwFlSdqLpJwmy6AP322ERn8W2YLIB6JBXnwMI2Qsh2gfphT3q7EKAxKb23cvFHFwKA==}
 
   es6-promise@3.3.1:
     resolution: {integrity: sha512-SOp9Phqvqn7jtEUxPWdWfWoLmyt2VaJ6MpvP9Comy1MceMXqE6bxvaTu4iaxpYYPzhny28Lc+M87/c2cPK6lDg==}
@@ -4604,13 +4383,8 @@ packages:
     peerDependencies:
       esbuild: '>=0.12 <1'
 
-  esbuild@0.25.11:
-    resolution: {integrity: sha512-KohQwyzrKTQmhXDW1PjCv3Tyspn9n5GcY2RTDqeORIdIJY8yKIF7sTSopFmn/wpMPW4rdPXI0UE5LJLuq3bx0Q==}
-    engines: {node: '>=18'}
-    hasBin: true
-
-  esbuild@0.25.9:
-    resolution: {integrity: sha512-CRbODhYyQx3qp7ZEwzxOk4JBqmD/seJrzPa/cGjY1VtIn5E09Oi9/dB4JwctnfZ8Q8iT7rioVv5k/FNT/uf54g==}
+  esbuild@0.25.12:
+    resolution: {integrity: sha512-bbPBYYrtZbkt6Os6FiTLCTFxvq4tt3JKall1vRwshA3fdVztsLAatFaZobhkBC8/BrPetoa0oksYoKXoG4ryJg==}
     engines: {node: '>=18'}
     hasBin: true
 
@@ -4738,8 +4512,8 @@ packages:
     engines: {node: '>=4'}
     hasBin: true
 
-  esquery@1.6.0:
-    resolution: {integrity: sha512-ca9pw9fomFcKPvFLXhBKUK90ZvGibiGOvRJNbjljY7s7uq/5YO4BOzcYtJqExdx99rF6aAcnRxHmcUHcz6sQsg==}
+  esquery@1.7.0:
+    resolution: {integrity: sha512-Ap6G0WQwcU/LHsvLwON1fAQX9Zp0A2Y6Y/cJBl9r/JbW90Zyg4/zbG6zzKa2OTALELarYHmKu0GhpM5EO+7T0g==}
     engines: {node: '>=0.10'}
 
   esrecurse@4.3.0:
@@ -4820,11 +4594,11 @@ packages:
   fast-safe-stringify@2.1.1:
     resolution: {integrity: sha512-W+KJc2dmILlPplD/H4K9l9LcAHAfPtP6BY84uVLXQ6Evcz9Lcg33Y2z1IVblT6xdY54PXYVHEv+0Wpq8Io6zkA==}
 
-  fast-uri@3.0.6:
-    resolution: {integrity: sha512-Atfo14OibSv5wAp4VWNsFYE1AchQRTv9cBGWET4pZWHzYshFSS9NQI6I57rdKn9croWVMbYFbLhJ+yJvmZIIHw==}
+  fast-uri@3.1.0:
+    resolution: {integrity: sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA==}
 
-  fastq@1.19.1:
-    resolution: {integrity: sha512-GwLTyxkCXjXbxqIhTsMI2Nui8huMPtnxg7krajPJAjnEG/iiOS7i+zCtWGZR9G0NBKbXKh6X9m9UIsYX/N6vvQ==}
+  fastq@1.20.1:
+    resolution: {integrity: sha512-GGToxJ/w1x32s/D2EKND7kTil4n8OVk/9mycTc4VDza13lOvpUZTGX3mFSCtV9ksdGBVzvsyAVLM6mHFThxXxw==}
 
   fdir@6.5.0:
     resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==}
@@ -4924,8 +4698,8 @@ packages:
     resolution: {integrity: sha512-oRXApq54ETRj4eMiFzGnHWGy+zo5raudjuxN0b8H7s/RU2oW0Wvsx9O0ACRN/kRq9E8Vu/ReskGB5o3ji+FzHQ==}
     engines: {node: '>=12'}
 
-  fs-extra@11.3.2:
-    resolution: {integrity: sha512-Xr9F6z6up6Ws+NjzMCZc6WXg2YFRlrLP9NQDO3VQrWrfiojdhS56TzueT88ze0uBdCTwEIhQ3ptnmKeWGFAe0A==}
+  fs-extra@11.3.3:
+    resolution: {integrity: sha512-VWSRii4t0AFm6ixFFmLLx1t7wS1gh+ckoa84aOeapGum0h+EZd1EhEumSB+ZdDLnEPuucsVB9oB7cxJHap6Afg==}
     engines: {node: '>=14.14'}
 
   fs-monkey@1.1.0:
@@ -5008,10 +4782,6 @@ packages:
   glob-to-regexp@0.4.1:
     resolution: {integrity: sha512-lkX1HJXwyMcprw/5YUZc2s7DrpAiHB21/V+E1rHUrVNokkvB6bqMzT0VfV6/86ZNabt1k14YOIaT7nDvOX3Iiw==}
 
-  glob@10.4.5:
-    resolution: {integrity: sha512-7Bv8RF0k6xjo7d4A/PxYLbUCfb6c+Vpd2/mB2yRDlew7Jb5hEXiCD9ibfO7wpk8i4sevK6DFny9h7EYbM3/sHg==}
-    hasBin: true
-
   glob@10.5.0:
     resolution: {integrity: sha512-DfXN8DfhJ7NH3Oe7cFmu3NCu1wKbkReJ8TorzSAFbSKrlNaQSKfIzqYqVY8zlbs2NLBbWpRiU52GX2PbaBVNkg==}
     hasBin: true
@@ -5020,10 +4790,6 @@ packages:
     resolution: {integrity: sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==}
     deprecated: Glob versions prior to v9 are no longer supported
 
-  glob@9.3.5:
-    resolution: {integrity: sha512-e1LleDykUz2Iu+MTYdkSsuWX8lvAjAcs0Xef0lNIu0S2wOAzuTxCJtcd9S3cijlwYF18EsU3rzb8jPVobxDh9Q==}
-    engines: {node: '>=16 || 14 >=14.17'}
-
   globals@13.24.0:
     resolution: {integrity: sha512-AhO5QUcj8llrbG09iWhPU2B204J1xnPeL8kQmVorSsy+Sjj1sk8gIyh6cUocGmH4L0UuhAJy+hJMRA4mgA4mFQ==}
     engines: {node: '>=8'}
@@ -5046,8 +4812,8 @@ packages:
   graphemer@1.4.0:
     resolution: {integrity: sha512-EtKwoO6kxCL9WO5xipiHTZlSzBm7WLT627TqC/uVRd0HKmq8NXyebnNYxDoBi7wt8eTWrUrKXCOVaFq9x1kgag==}
 
-  graphql@16.11.0:
-    resolution: {integrity: sha512-mS1lbMsxgQj6hge1XZ6p7GPhbrtFwUFYi3wRzXAC/FmYnyXMTvvI3td3rjmQ2u8ewXueaSvRPWaEcgVVOT9Jnw==}
+  graphql@16.12.0:
+    resolution: {integrity: sha512-DKKrynuQRne0PNpEbzuEdHlYOMksHSUI8Zc9Unei5gTsMNA2/vMpoMz/yKba50pejK56qj98qM0SjYxAKi13gQ==}
     engines: {node: ^12.22.0 || ^14.16.0 || ^16.0.0 || >=17.0.0}
 
   has-bigints@1.1.0:
@@ -5152,8 +4918,8 @@ packages:
   html-url-attributes@3.0.1:
     resolution: {integrity: sha512-ol6UPyBWqsrO6EJySPz2O7ZSr856WDrEzM5zMqp+FJJLGMW35cLYmmZnl0vztAZxRUoNZJFTCohfjuIJ8I4QBQ==}
 
-  html-webpack-plugin@5.6.4:
-    resolution: {integrity: sha512-V/PZeWsqhfpE27nKeX9EO2sbR+D17A+tLf6qU+ht66jdUsN0QLKJN27Z+1+gHrVMKgndBahes0PU6rRihDgHTw==}
+  html-webpack-plugin@5.6.5:
+    resolution: {integrity: sha512-4xynFbKNNk+WlzXeQQ+6YYsH2g7mpfPszQZUi3ovKlj+pDmngQ7vRXjrrmGROabmKwyQkcgcX5hqfOwHbFmK5g==}
     engines: {node: '>=10.13.0'}
     peerDependencies:
       '@rspack/core': 0.x || 1.x
@@ -5203,8 +4969,11 @@ packages:
     engines: {node: '>=16.x'}
     hasBin: true
 
-  immer@10.1.3:
-    resolution: {integrity: sha512-tmjF/k8QDKydUlm3mZU+tjM6zeq9/fFpPqH9SzWmBnVVKsPBg/V66qsMwb3/Bo90cgUN+ghdVBess+hPsxUyRw==}
+  immer@10.2.0:
+    resolution: {integrity: sha512-d/+XTN3zfODyjr89gM3mPq1WNX2B8pYsu7eORitdwyA2sBubnTl3laYlBk4sXY5FUa5qTZGBDPJICVbvqzjlbw==}
+
+  immer@11.1.3:
+    resolution: {integrity: sha512-6jQTc5z0KJFtr1UgFpIL3N9XSC3saRaI9PwWtzM2pSqkNGtiNkYY2OSwkOGDK2XcTRcLb1pi/aNkKZz0nxVH4Q==}
 
   immer@9.0.21:
     resolution: {integrity: sha512-bc4NBHqOqSfRW7POMkHd51LvClaeMXpm8dx0e8oE2GORbq5aRK7Bxl4FyzVLdGtLmvLKL7BTDBG5ACQm4HWjTA==}
@@ -5213,8 +4982,8 @@ packages:
     resolution: {integrity: sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==}
     engines: {node: '>=6'}
 
-  import-in-the-middle@2.0.0:
-    resolution: {integrity: sha512-yNZhyQYqXpkT0AKq3F3KLasUSK4fHvebNH5hOsKQw2dhGSALvQ4U0BqUc5suziKvydO5u5hgN2hy1RJaho8U5A==}
+  import-in-the-middle@2.0.2:
+    resolution: {integrity: sha512-qet/hkGt3EbNGVtbDfPu0BM+tCqBS8wT1SYrstPaDKoWtshsC6licOemz7DVtpBEyvDNzo8UTBf9/GwWuSDZ9w==}
 
   imurmurhash@0.1.4:
     resolution: {integrity: sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==}
@@ -5234,8 +5003,8 @@ packages:
   inherits@2.0.4:
     resolution: {integrity: sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==}
 
-  inline-style-parser@0.2.4:
-    resolution: {integrity: sha512-0aO8FkhNZlj/ZIbNi7Lxxr12obT7cL1moPfE4tg1LkX7LlLfC6DeX4l2ZEud1ukP9jNQyNnfzQVqwbwmAATY4Q==}
+  inline-style-parser@0.2.7:
+    resolution: {integrity: sha512-Nb2ctOyNR8DqQoR0OwRG95uNWIC0C1lCgf5Naz5H6Ji72KZ8OcFZLz2P5sNgwlyoJ8Yif11oMuYs5pBQa86csA==}
 
   internal-slot@1.1.0:
     resolution: {integrity: sha512-4gd7VpWNQNB4UKKCFFVcp1AVv+FMOgs9NKzjHKusc8jTMhd5eL1NqQqOpE0KzMds804/yHlglp3uxgluOqAPLw==}
@@ -5262,9 +5031,6 @@ packages:
   is-arrayish@0.2.1:
     resolution: {integrity: sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==}
 
-  is-arrayish@0.3.2:
-    resolution: {integrity: sha512-eVRqCvVlZbuw3GrM63ovNSNAeA1K16kaR/LRY/92w0zxQ5/1YzwblUX652i4Xs9RwAGjW9d9y6X88t8OaAJfWQ==}
-
   is-async-function@2.1.1:
     resolution: {integrity: sha512-9dgM/cZBnNvjzaMYHVoxxfPj2QXt22Ev7SuuPrs+xav0ukGB0S6d4ydZdEiM48kLx5kDV+QBPrpVnFyefL8kkQ==}
     engines: {node: '>= 0.4'}
@@ -5320,10 +5086,6 @@ packages:
     resolution: {integrity: sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==}
     engines: {node: '>=8'}
 
-  is-generator-function@1.1.0:
-    resolution: {integrity: sha512-nPUB5km40q9e8UfN/Zc24eLlzdSf9OfKByBw9CIdw4H1giPMeA0OIJvbchsCu4npfI2QcMVBsGEBHKZ7wLTWmQ==}
-    engines: {node: '>= 0.4'}
-
   is-generator-function@1.1.2:
     resolution: {integrity: sha512-upqt1SkGkODW9tsGNG5mtXTXtECizwtS2kA161M+gJPc1xdb/Ax629af6YrTwcOeQHbewrPNlE5Dx7kzvXTizA==}
     engines: {node: '>= 0.4'}
@@ -5440,8 +5202,8 @@ packages:
     resolution: {integrity: sha512-/imKNG4EbWNrVjoNC/1H5/9GFy+tqjGBHCaSsN+P2RnPqjsLmv6UD3Ej+Kj8nBWaRAwyk7kK5ZUc+OEatnTR3A==}
     hasBin: true
 
-  jiti@2.5.1:
-    resolution: {integrity: sha512-twQoecYPiVA5K/h6SxtORw/Bs3ar+mLUtoPSc7iMXzQzK8d7eJ/R09wmTwAjiamETn1cXYPGfNnu7DMoHgu12w==}
+  jiti@2.6.1:
+    resolution: {integrity: sha512-ekilCSN1jwRvIbgeg/57YFh8qQDNbwDb9xT/qu2DAHbFFZUicIl4ygVaAvzveMhMVr3LnpSKTNnwt8PoOfmKhQ==}
     hasBin: true
 
   js-tokens@4.0.0:
@@ -5451,15 +5213,14 @@ packages:
     resolution: {integrity: sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==}
     hasBin: true
 
+  js-yaml@4.1.1:
+    resolution: {integrity: sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==}
+    hasBin: true
+
   jsep@1.4.0:
     resolution: {integrity: sha512-B7qPcEVE3NVkmSJbaYxvv4cHkVW7DQsZz13pUMrfS8z8Q/BuShN+gcTXrUlPiGqM2/t/EEaI030bpxMqY8gMlw==}
     engines: {node: '>= 10.16.0'}
 
-  jsesc@3.0.2:
-    resolution: {integrity: sha512-xKqzzWXDttJuOcawBt4KnKHHIf5oQ/Cxax+0PWFG+DFDgHNAdi+TXECADI+RYiFUMmx8792xsMbbgXj4CwnP4g==}
-    engines: {node: '>=6'}
-    hasBin: true
-
   jsesc@3.1.0:
     resolution: {integrity: sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==}
     engines: {node: '>=6'}
@@ -5471,13 +5232,6 @@ packages:
   json-parse-even-better-errors@2.3.1:
     resolution: {integrity: sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==}
 
-  json-schema-compare@0.2.2:
-    resolution: {integrity: sha512-c4WYmDKyJXhs7WWvAWm3uIYnfyWFoIp+JEoX34rctVvEkMYCPGhXtvmFFXiffBbxfZsvQ0RNnV5H7GvDF5HCqQ==}
-
-  json-schema-merge-allof@0.8.1:
-    resolution: {integrity: sha512-CTUKmIlPJbsWfzRRnOXz+0MjIqvnleIXwFTzz+t9T86HnYX/Rozria6ZVGLktAU9e+NygNljveP+yxqtQp/Q4w==}
-    engines: {node: '>=12.0.0'}
-
   json-schema-traverse@0.4.1:
     resolution: {integrity: sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==}
 
@@ -5566,8 +5320,8 @@ packages:
   linkify-it@5.0.0:
     resolution: {integrity: sha512-5aHCbzQRADcdP+ATqnDuhhJ/MRIqDkZX5pyjFHRRysS8vZ5AbqGEoFIb6pYHPZ+L/OC2Lc+xT8uHVVR5CAK/wQ==}
 
-  loader-runner@4.3.0:
-    resolution: {integrity: sha512-3R/1M+yS3j5ou80Me59j7F9IMs4PXs3VqRrm0TU3AbKPxlmpoY1TNscJV/oGJXo8qCatFGTfDbY6W6ipGOYXfg==}
+  loader-runner@4.3.1:
+    resolution: {integrity: sha512-IWqP2SCPhyVFTBtRcgMHdzlf9ul25NwaFx4wCEH/KjAXuuHY4yNjvPXsBokp8jCB936PyWRaPKUNh8NvylLp2Q==}
     engines: {node: '>=6.11.5'}
 
   loader-utils@2.0.4:
@@ -5590,8 +5344,8 @@ packages:
     resolution: {integrity: sha512-gvVijfZvn7R+2qyPX8mAuKcFGDf6Nc61GdvGafQsHL0sBIxfKzA+usWn4GFC/bk+QdwPUD4kWFJLhElipq+0VA==}
     engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
 
-  lodash-es@4.17.21:
-    resolution: {integrity: sha512-mKnC+QJ9pWVzv+C4/U3rRsHapFfHvQFoFB92e52xeyGMcX6/OlIl78je1u8vePzYZSkkogMPJ2yjxxsb89cxyw==}
+  lodash-es@4.17.22:
+    resolution: {integrity: sha512-XEawp1t0gxSi9x01glktRZ5HDy0HXqrM0x5pXQM98EaI0NxO6jVM7omDOxsuEo5UIASAnm2bRp1Jt/e0a2XU8Q==}
 
   lodash.camelcase@4.3.0:
     resolution: {integrity: sha512-TwuEnCnxbc3rAvhf/LbG7tJUDzhqXyFnv3dtzLOPgCG/hODL7WFnsbwktkD7yUV0RrreP/l1PALq/YSg6VvjlA==}
@@ -5664,8 +5418,8 @@ packages:
     resolution: {integrity: sha512-h5bgJWpxJNswbU7qCrV0tIKQCaS3blPDrqKWx+QxzuzL1zGUzij9XCWLrSLsJPu5t+eWA/ycetzYAO5IOMcWAQ==}
     hasBin: true
 
-  magic-string@0.30.19:
-    resolution: {integrity: sha512-2N21sPY9Ws53PZvsEpVtNuSW+ScYbQdp4b9qUaL+9QkHUrGFKo56Lg9Emg5s9V/qrtNBmiR01sYhUOwu3H+VOw==}
+  magic-string@0.30.21:
+    resolution: {integrity: sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==}
 
   magic-string@0.30.8:
     resolution: {integrity: sha512-ISQTe55T2ao7XtlAStud6qwYPZjE4GK1S/BeVPus4jrq6JuOnQ00YKQC581RWhR122W7msZV263KzVeLoqidyQ==}
@@ -5682,11 +5436,14 @@ packages:
   markdown-table@3.0.4:
     resolution: {integrity: sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw==}
 
-  markdown-to-jsx@7.7.13:
-    resolution: {integrity: sha512-DiueEq2bttFcSxUs85GJcQVrOr0+VVsPfj9AEUPqmExJ3f8P/iQNvZHltV4tm1XVhu1kl0vWBZWT3l99izRMaA==}
+  markdown-to-jsx@8.0.0:
+    resolution: {integrity: sha512-hWEaRxeCDjes1CVUQqU+Ov0mCqBqkGhLKjL98KdbwHSgEWZZSJQeGlJQatVfeZ3RaxrfTrZZ3eczl2dhp5c/pA==}
     engines: {node: '>= 10'}
     peerDependencies:
       react: '>= 0.14.0'
+    peerDependenciesMeta:
+      react:
+        optional: true
 
   math-intrinsics@1.1.0:
     resolution: {integrity: sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==}
@@ -5734,8 +5491,8 @@ packages:
   mdast-util-phrasing@4.1.0:
     resolution: {integrity: sha512-TqICwyvJJpBwvGAMZjj4J2n0X8QWp21b9l0o7eXyVJ25YNWYbJDVIyD1bZXE6WtV6RmKJVYmQAKWa0zWOABz2w==}
 
-  mdast-util-to-hast@13.2.0:
-    resolution: {integrity: sha512-QGYKEuUsYT9ykKBCMOEDLsU5JRObWQusAolFMeko/tYPufNkRffBAQjIE+99jbA87xv6FgmjLtwjh9wBWajwAA==}
+  mdast-util-to-hast@13.2.1:
+    resolution: {integrity: sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA==}
 
   mdast-util-to-markdown@2.1.2:
     resolution: {integrity: sha512-xj68wMTvGXVOKonmog6LwyJKrYXZPvlwabaryTjLh9LuvovB/KAH+kvi8Gjj+7rJjsFi23nkUxRQv1KqSroMqA==}
@@ -5884,10 +5641,6 @@ packages:
     resolution: {integrity: sha512-sauLxniAmvnhhRjFwPNnJKaPFYyddAgbYdeUpHULtCT/GhzdCx/MDNy+Y40lBxTQUrMzDE8e0S43Z5uqfO0REg==}
     engines: {node: '>=10'}
 
-  minimatch@8.0.4:
-    resolution: {integrity: sha512-W0Wvr9HyFXZRGIDgCicunpQ299OKXs9RgZfaukz4qAW/pJhcpUfupc9c+OObPOFueNy8VSrZgEmDtk6Kh4WzDA==}
-    engines: {node: '>=16 || 14 >=14.17'}
-
   minimatch@9.0.5:
     resolution: {integrity: sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==}
     engines: {node: '>=16 || 14 >=14.17'}
@@ -5895,10 +5648,6 @@ packages:
   minimist@1.2.8:
     resolution: {integrity: sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==}
 
-  minipass@4.2.8:
-    resolution: {integrity: sha512-fNzuVyifolSLFL4NzpF+wEF4qrgqaaKX0haXPQEdQ7NKAN+WecoKMHV09YcuL/DHxrUsYQOK3MiuDf7Ip2OXfQ==}
-    engines: {node: '>=8'}
-
   minipass@7.1.2:
     resolution: {integrity: sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==}
     engines: {node: '>=16 || 14 >=14.17'}
@@ -5909,11 +5658,11 @@ packages:
   moment@2.30.1:
     resolution: {integrity: sha512-uEmtNhbDOrWPFS+hdjFCBfy9f2YoyzRpwcl+DqpC6taX21FzsTLQVbMV/W7PzNSX6x/bhC1zA3c2UQ5NzH6how==}
 
-  motion-dom@12.23.23:
-    resolution: {integrity: sha512-n5yolOs0TQQBRUFImrRfs/+6X4p3Q4n1dUEqt/H58Vx7OW6RF+foWEgmTVDhIWJIMXOuNNL0apKH2S16en9eiA==}
+  motion-dom@12.24.8:
+    resolution: {integrity: sha512-wX64WITk6gKOhaTqhsFqmIkayLAAx45SVFiMnJIxIrH5uqyrwrxjrfo8WX9Kh8CaUAixjeMn82iH0W0QT9wD5w==}
 
-  motion-utils@12.23.6:
-    resolution: {integrity: sha512-eAWoPgr4eFEOFfg2WjIsMoqJTW6Z8MTUCgn/GZ3VRpClWBdnbjryiA3ZSNLyxCTmCQx4RmYX6jX1iWHbenUPNQ==}
+  motion-utils@12.23.28:
+    resolution: {integrity: sha512-0W6cWd5Okoyf8jmessVK3spOmbyE0yTdNKujHctHH9XdAE4QDuZ1/LjSXC68rrhsJU+TkzXURC5OdSWh9ibOwQ==}
 
   ms@2.1.3:
     resolution: {integrity: sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==}
@@ -6019,8 +5768,8 @@ packages:
   node-readfiles@0.2.0:
     resolution: {integrity: sha512-SU00ZarexNlE4Rjdm83vglt5Y9yiQ+XI1XpflWlb7q7UTN1JUItm69xMeiQCTxtTfnzt+83T8Cx+vI2ED++VDA==}
 
-  node-releases@2.0.20:
-    resolution: {integrity: sha512-7gK6zSXEH6neM212JgfYFXe+GmZQM+fia5SsusuBIUgnPheLFBmIPhtFoAQRj8/7wASYQnbDlHPVwY0BefoFgA==}
+  node-releases@2.0.27:
+    resolution: {integrity: sha512-nmh3lCkYZ3grZvqcCH+fjmQ7X+H0OeZgP40OierEaAptX4XofMh5kwNbWh7lBduUzCcV/8kZ+NDLCwm2iorIlA==}
 
   normalize-path@3.0.0:
     resolution: {integrity: sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==}
@@ -6189,8 +5938,8 @@ packages:
     resolution: {integrity: sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==}
     engines: {node: '>=6'}
 
-  parse-asn1@5.1.7:
-    resolution: {integrity: sha512-CTM5kuWR3sx9IFamcl5ErfPl6ea/N8IYwiJ+vpeB2g+1iknv7zBl5uPwbMbRVznRVbrNY6lGuDoE5b30grmbqg==}
+  parse-asn1@5.1.9:
+    resolution: {integrity: sha512-fIYNuZ/HastSb80baGOuPRo1O9cf4baWw5WsAp7dBuUzeTD/BoaG8sVTdlPFksBE2lF21dN+A1AnrpIjSWqHHg==}
     engines: {node: '>= 0.10'}
 
   parse-entities@4.0.2:
@@ -6312,8 +6061,8 @@ packages:
     peerDependencies:
       postcss: ^8.0.0
 
-  postcss-js@4.0.1:
-    resolution: {integrity: sha512-dDLF8pEO191hJMtlHFPRa8xsizHaM82MLfNkUHdUtVEV3tgTp5oj+8qbEqYM57SLfc74KSbw//4SeJma2LRVIw==}
+  postcss-js@4.1.0:
+    resolution: {integrity: sha512-oIAOTqgIo7q2EOwbhb8UalYePMvYoIeRY2YKntdpFQXNosSu3vLrniGgmH9OKs/qAkfoj5oB3le/7mINW1LCfw==}
     engines: {node: ^12 || ^14 || >= 16}
     peerDependencies:
       postcss: ^8.4.21
@@ -6377,8 +6126,8 @@ packages:
     resolution: {integrity: sha512-Q8qQfPiZ+THO/3ZrOrO0cJJKfpYCagtMUkXbnEfmgUjwXg6z/WBeOyS9APBBPCTSiDV+s4SwQGu8yFsiMRIudg==}
     engines: {node: '>=4'}
 
-  postcss-selector-parser@7.1.0:
-    resolution: {integrity: sha512-8sLjZwK0R+JlxlYcTuVnyT2v+htpdrjDOKuMcOVdYjt52Lh8hWRYpxBPoKx/Zg+bcjc3wx6fmQevMmUztS/ccA==}
+  postcss-selector-parser@7.1.1:
+    resolution: {integrity: sha512-orRsuYpJVw8LdAwqqLykBj9ecS5/cRHlI5+nvTo8LcCKmzDmqVORXtOIYEEQuL9D4BxtA1lm5isAqzQZCoQ6Eg==}
     engines: {node: '>=4'}
 
   postcss-value-parser@4.2.0:
@@ -6388,10 +6137,6 @@ packages:
     resolution: {integrity: sha512-PS08Iboia9mts/2ygV3eLpY5ghnUcfLV/EXTOW1E2qYxJKGGBUtNjN76FYHnMs36RmARn41bC0AZmn+rR0OVpQ==}
     engines: {node: ^10 || ^12 || >=14}
 
-  postcss@8.4.49:
-    resolution: {integrity: sha512-OCVPnIObs4N29kxTjzLfUryOkvZEq+pf8jTF0lg8E7uETuWHA+v7j3c/xJmiqpX450191LlmZfUKkXxkTry7nA==}
-    engines: {node: ^10 || ^12 || >=14}
-
   postcss@8.5.6:
     resolution: {integrity: sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg==}
     engines: {node: ^10 || ^12 || >=14}
@@ -6400,8 +6145,8 @@ packages:
     resolution: {integrity: sha512-VpZrUqU5A69eQyW2c5CA1jtLecCsN2U/bD6VilrFDWq5+5UIEVO7nazS3TEcHf1zuPYO/sqGvUvW62g86RXZuA==}
     engines: {node: '>=4'}
 
-  postgres-bytea@1.0.0:
-    resolution: {integrity: sha512-xy3pmLuQqRBZBXDULy7KbaitYqLcmxigw14Q5sj8QBVLqEwXfeybIKVWiqAXTlcvdvb0+xkOtDbfQMOf4lST1w==}
+  postgres-bytea@1.0.1:
+    resolution: {integrity: sha512-5+5HqXnsZPE65IJZSMkZtURARZelel2oXUEO8rH83VS/hxH5vv1uHquPg5wZs8yMAfdv971IU+kcPUczi7NVBQ==}
     engines: {node: '>=0.10.0'}
 
   postgres-date@1.0.7:
@@ -6517,8 +6262,8 @@ packages:
     resolution: {integrity: sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==}
     engines: {node: '>=6'}
 
-  qs@6.14.0:
-    resolution: {integrity: sha512-YWWTjgABSKcvs/nWBi9PycY/JiPJqOD4JA6o9Sej2AtvSGarXxKC3OQSk4pAarbdQlKAh5D4FCQkJNkW+GAn3w==}
+  qs@6.14.1:
+    resolution: {integrity: sha512-4EK3+xJl8Ts67nLYNwqw/dsFVnCf+qR7RgXSK9jEEm9unao3njwMDdmsdvoKBKHzxd7tCYz5e5M+SnMjdtXGQQ==}
     engines: {node: '>=0.6'}
 
   querystring-es3@0.2.1:
@@ -6563,12 +6308,6 @@ packages:
     peerDependencies:
       react: ^18.3.1
 
-  react-drag-drop-files@2.4.0:
-    resolution: {integrity: sha512-MGPV3HVVnwXEXq3gQfLtSU3jz5j5jrabvGedokpiSEMoONrDHgYl/NpIOlfsqGQ4zBv1bzzv7qbKURZNOX32PA==}
-    peerDependencies:
-      react: ^18.0.0
-      react-dom: ^18.0.0
-
   react-hook-form@7.66.0:
     resolution: {integrity: sha512-xXBqsWGKrY46ZqaHDo+ZUYiMUgi8suYu5kdrS20EG8KiL7VRQitEbNjm+UcrDYrNi1YLyfpmAeGjCZYXLT9YBw==}
     engines: {node: '>=18.0.0'}
@@ -6630,8 +6369,8 @@ packages:
       '@types/react':
         optional: true
 
-  react-remove-scroll@2.7.1:
-    resolution: {integrity: sha512-HpMh8+oahmIdOuS5aFKKY6Pyog+FNaZV/XyJOq7b4YFwsFHe5yYfdbIalI4k3vU2nSDql7YskmUseHsRrJqIPA==}
+  react-remove-scroll@2.7.2:
+    resolution: {integrity: sha512-Iqb9NjCCTt6Hf+vOdNIZGdTiH1QSqr27H/Ek9sv/a97gfueI/5h1s3yRi1nngzMUaOOToin5dI1dXKdXiF+u0Q==}
     engines: {node: '>=10'}
     peerDependencies:
       '@types/react': '*'
@@ -6721,8 +6460,8 @@ packages:
   reftools@1.1.9:
     resolution: {integrity: sha512-OVede/NQE13xBQ+ob5CKd5KyeJYU2YInb1bmV4nRoOfquZPkAkxuOXicSe1PvqIuZZ4kD13sPKBbR7UFDmli6w==}
 
-  regenerate-unicode-properties@10.2.0:
-    resolution: {integrity: sha512-DqHn3DwbmmPVzeKj9woBadqmXxLvQoQIwu7nopMc72ztvxVmVk2SBhSnx67zuye5TP+lJsb/TBQsjLKhnDf3MA==}
+  regenerate-unicode-properties@10.2.2:
+    resolution: {integrity: sha512-m03P+zhBeQd1RGnYxrGyDAPpWX/epKirLrp8e3qevZdVkKtnCrjjWczIbYc8+xd6vcTStVlqfycTx1KR4LOr0g==}
     engines: {node: '>=4'}
 
   regenerate@1.4.2:
@@ -6735,15 +6474,15 @@ packages:
     resolution: {integrity: sha512-dYqgNSZbDwkaJ2ceRd9ojCGjBq+mOm9LmtXnAnEGyHhN/5R7iDW2TRw3h+o/jCFxus3P2LfWIIiwowAjANm7IA==}
     engines: {node: '>= 0.4'}
 
-  regexpu-core@6.2.0:
-    resolution: {integrity: sha512-H66BPQMrv+V16t8xtmq+UC0CBpiTBA60V8ibS1QVReIp8T1z8hwFxqcGzm9K6lgsN7sB5edVH8a+ze6Fqm4weA==}
+  regexpu-core@6.4.0:
+    resolution: {integrity: sha512-0ghuzq67LI9bLXpOX/ISfve/Mq33a4aFRzoQYhnnok1JOFpmE/A2TBGkNVenOGEeSBCjIiWcc6MVOG5HEQv0sA==}
     engines: {node: '>=4'}
 
   regjsgen@0.8.0:
     resolution: {integrity: sha512-RvwtGe3d7LvWiDQXeQw8p5asZUmfU1G/l6WbUXeHta7Y2PEIvBTwH6E2EfmYUK8pxcxEdEmaomqyp0vZZ7C+3Q==}
 
-  regjsparser@0.12.0:
-    resolution: {integrity: sha512-cnE+y8bz4NhMjISKbgeVJtqNbtf5QpjZP+Bslo+UqkIt9QPnX9q095eiRRASJG1/tz6dlNr6Z5NsBiWYokp6EQ==}
+  regjsparser@0.13.0:
+    resolution: {integrity: sha512-NZQZdC5wOE/H3UT28fVGL+ikOZcEzfMGk/c3iN9UGxzWHMa1op7274oyiUVrAG4B2EuFhus8SvkaYnhvW92p9Q==}
     hasBin: true
 
   rehype-autolink-headings@7.1.0:
@@ -6788,10 +6527,6 @@ packages:
     resolution: {integrity: sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==}
     engines: {node: '>=0.10.0'}
 
-  require-in-the-middle@7.5.2:
-    resolution: {integrity: sha512-gAZ+kLqBdHarXB64XpAe2VCjB7rIRv+mU8tfRWziHRJ5umKsIHN2tLLv6EtMw7WCdP19S0ERVMldNvxYCHnhSQ==}
-    engines: {node: '>=8.6.0'}
-
   require-in-the-middle@8.0.1:
     resolution: {integrity: sha512-QT7FVMXfWOYFbeRBF6nu+I6tr2Tf3u0q8RIEjNob/heKY/nh7drD/k7eeMFmSQgnTtCzLDcCu/XEnpW2wk4xCQ==}
     engines: {node: '>=9.3.0 || >=8.10.0 <9.0.0'}
@@ -6810,11 +6545,6 @@ packages:
     resolution: {integrity: sha512-uZtduh8/8srhBoMx//5bwqjQ+rfYOUq8zC9NrMUGtjBiGTtFJM42s58/36+hTqeqINcnYe08Nj3LkK9lW4N8Xg==}
     engines: {node: '>=12'}
 
-  resolve@1.22.10:
-    resolution: {integrity: sha512-NPRy+/ncIMeDlTAsuqwKIiferiawhefFJtkNSW0qZJEqMEb+qBt/77B/jGeeek+F0uOeN05CDa6HXbbIgtVX4w==}
-    engines: {node: '>= 0.4'}
-    hasBin: true
-
   resolve@1.22.11:
     resolution: {integrity: sha512-RfqAvLnMl313r7c9oclB1HhUEAezcpLjz95wFH4LVuhk9JF/r22qmVP9AMmOU4vMX7Q8pN8jwNg/CSpdFnMjTQ==}
     engines: {node: '>= 0.4'}
@@ -6844,8 +6574,8 @@ packages:
     resolution: {integrity: sha512-5Di9UC0+8h1L6ZD2d7awM7E/T4uA1fJRlx6zk/NvdCCVEoAnFqvHmCuNeIKoCeIixBX/q8uM+6ycDvF8woqosA==}
     engines: {node: '>= 0.8'}
 
-  rollup@4.52.2:
-    resolution: {integrity: sha512-I25/2QgoROE1vYV+NQ1En9T9UFB9Cmfm2CJ83zZOlaDpvz29wGQSZXWKw7MiNXau7wYgB/T9fVIdIuEQ+KbiiA==}
+  rollup@4.55.1:
+    resolution: {integrity: sha512-wDv/Ht1BNHB4upNbK74s9usvl7hObDnvVzknxqY/E/O3X6rW1U1rV1aENEfJ54eFZDTNo7zv1f5N4edCluH7+A==}
     engines: {node: '>=18.0.0', npm: '>=8.0.0'}
     hasBin: true
 
@@ -6876,8 +6606,8 @@ packages:
   safe-stable-stringify@1.1.1:
     resolution: {integrity: sha512-ERq4hUjKDbJfE4+XtZLFPCDi8Vb1JqaxAPTxWFLBx8XcAlf9Bda/ZJdVezs/NAfsMQScyIlUMx+Yeu7P7rx5jw==}
 
-  sass-loader@16.0.5:
-    resolution: {integrity: sha512-oL+CMBXrj6BZ/zOq4os+UECPL+bWqt6OAC6DWS8Ln8GZRcMDjlJ4JC3FBDuHJdYaFWIdKNIBYmtZtK2MaMkNIw==}
+  sass-loader@16.0.6:
+    resolution: {integrity: sha512-sglGzId5gmlfxNs4gK2U3h7HlVRfx278YK6Ono5lwzuvi1jxig80YiuHkaDBVsYIKFhx8wN7XSCI0M2IDS/3qA==}
     engines: {node: '>= 18.12.0'}
     peerDependencies:
       '@rspack/core': 0.x || 1.x
@@ -6904,19 +6634,14 @@ packages:
     resolution: {integrity: sha512-pN/yOAvcC+5rQ5nERGuwrjLlYvLTbCibnZ1I7B1LaiAz9BRBlE9GMgE/eqV30P7aJQUf7Ddimy/RsbYO/GrVGg==}
     engines: {node: '>= 10.13.0'}
 
-  schema-utils@4.3.2:
-    resolution: {integrity: sha512-Gn/JaSk/Mt9gYubxTtSn/QCV4em9mpAPiR1rqy/Ocu19u/G9J5WWdNoUT4SiV6mFC3y6cxyFcFwdzPM3FgxGAQ==}
+  schema-utils@4.3.3:
+    resolution: {integrity: sha512-eflK8wEtyOE6+hsaRVPxvUKYCpRgzLqDTb8krvAsRIwOGlHoSgYLgBXoubGgLd2fT41/OUYdb48v4k4WWHQurA==}
     engines: {node: '>= 10.13.0'}
 
   semver@6.3.1:
     resolution: {integrity: sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==}
     hasBin: true
 
-  semver@7.7.2:
-    resolution: {integrity: sha512-RF0Fw+rO5AMf9MAyaRXI4AV0Ulj5lMHqVxxdSgiVbixSCXoEmmX/jk0CuJw4+3SqroYO9VoUh+HcuJivvtJemA==}
-    engines: {node: '>=10'}
-    hasBin: true
-
   semver@7.7.3:
     resolution: {integrity: sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==}
     engines: {node: '>=10'}
@@ -6945,11 +6670,8 @@ packages:
     engines: {node: '>= 0.10'}
     hasBin: true
 
-  shallowequal@1.1.0:
-    resolution: {integrity: sha512-y0m1JoUZSlPAjXVtPPW70aZWfIL/dSP7AFkRnniLCrK/8MDKog3TySTBmckD+RObVxH0v4Tox67+F14PdED2oQ==}
-
-  sharp@0.34.3:
-    resolution: {integrity: sha512-eX2IQ6nFohW4DbvHIOLRB3MHFpYqaqvXd3Tp5e/T/dSH83fxaNJQRvDMhASmkNTsNTVF2/OOopzRCt7xokgPfg==}
+  sharp@0.34.5:
+    resolution: {integrity: sha512-Ou9I5Ft9WNcCbXrU9cMgPBcCK8LiwLqcbywW3t4oDV37n1pzpuNLsYiAV8eODnjbtQlSDwZ2cUEeQz4E54Hltg==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
 
   shebang-command@2.0.0:
@@ -7013,9 +6735,6 @@ packages:
     resolution: {integrity: sha512-LH7FpTAkeD+y5xQC4fzS+tFtaNlvt3Ib1zKzvhjv/Y+cioV4zIuw4IZr2yhRLu67CWL7FR9/6KXKnjRoZTvGGQ==}
     engines: {node: '>=12'}
 
-  simple-swizzle@0.2.2:
-    resolution: {integrity: sha512-JA//kQgZtbuY83m+xT+tXJkmJncGMTFT+C+g2h2R9uxkYIrE2yy9sgmcLhCnw57/WSD+Eh3J97FPEDFnbXnDUg==}
-
   slash@3.0.0:
     resolution: {integrity: sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==}
     engines: {node: '>=8'}
@@ -7144,8 +6863,8 @@ packages:
     resolution: {integrity: sha512-laJTa3Jb+VQpaC6DseHhF7dXVqHTfJPCRDaEbid/drOhgitgYku/letMUqOXFoWV0zIIUbjpdH2t+tYj4bQMRQ==}
     engines: {node: '>=8'}
 
-  strip-indent@4.0.0:
-    resolution: {integrity: sha512-mnVSV2l+Zv6BLpSD/8V87CW/y9EmmbYzGCIavsnsI6/nwn26DwffM/yztm30Z/I2DY9wdS3vXVCMnHDgZaVNoA==}
+  strip-indent@4.1.1:
+    resolution: {integrity: sha512-SlyRoSkdh1dYP0PzclLE7r0M9sgbFKKMFXpFRUMNuKhQSbC6VQIGzq3E0qsfvGJaUFJPGv6Ws1NZ/haTAjfbMA==}
     engines: {node: '>=12'}
 
   strip-json-comments@3.1.1:
@@ -7158,18 +6877,11 @@ packages:
     peerDependencies:
       webpack: ^5.0.0
 
-  style-to-js@1.1.17:
-    resolution: {integrity: sha512-xQcBGDxJb6jjFCTzvQtfiPn6YvvP2O8U1MDIPNfJQlWMYfktPy+iGsHE7cssjs7y84d9fQaK4UF3RIJaAHSoYA==}
+  style-to-js@1.1.21:
+    resolution: {integrity: sha512-RjQetxJrrUJLQPHbLku6U/ocGtzyjbJMP9lCNK7Ag0CNh690nSH8woqWH9u16nMjYBAok+i7JO1NP2pOy8IsPQ==}
 
-  style-to-object@1.0.9:
-    resolution: {integrity: sha512-G4qppLgKu/k6FwRpHiGiKPaPTFcG3g4wNVX/Qsfu+RqQM30E7Tyu/TEgxcL9PNLF5pdRLwQdE3YKKf+KF2Dzlw==}
-
-  styled-components@6.1.19:
-    resolution: {integrity: sha512-1v/e3Dl1BknC37cXMhwGomhO8AkYmN41CqyX9xhUDxry1ns3BFQy2lLDRQXJRdVVWB9OHemv/53xaStimvWyuA==}
-    engines: {node: '>= 16'}
-    peerDependencies:
-      react: '>= 16.8.0'
-      react-dom: '>= 16.8.0'
+  style-to-object@1.0.14:
+    resolution: {integrity: sha512-LIN7rULI0jBscWQYaSswptyderlarFkjQ+t79nzty8tcIAceVomEVlLzH5VP4Cmsv6MtKhs7qaAiwlcp+Mgaxw==}
 
   styled-jsx@5.1.6:
     resolution: {integrity: sha512-qSVyDTeMotdvQYoHWLNGwRFJHC+i+ZvdBRYosOFgC+Wg1vx4frN2/RG/NA7SYqqvKNLf39P2LSRA2pu6n0XYZA==}
@@ -7197,11 +6909,8 @@ packages:
       babel-plugin-macros:
         optional: true
 
-  stylis@4.3.2:
-    resolution: {integrity: sha512-bhtUjWd/z6ltJiQwg0dUfxEJ+W+jdqQd8TbWLWyeIJHlnsqmGLRFFd8e5mA0AZi/zx90smXRlN66YMTcaSFifg==}
-
-  sucrase@3.35.0:
-    resolution: {integrity: sha512-8EbVDiu9iN/nESwxeSxDKe0dunta1GOlHufmSSXxMD2z2/tMZpDMpvXQGsc+ajGo8y2uYUmixaSRUc/QPoQ0GA==}
+  sucrase@3.35.1:
+    resolution: {integrity: sha512-DhuTmvZWux4H1UOnWMB3sk0sbaCVOoQZjv8u1rDoTV0HTdGem9hkAZtl4JZy8P2z4Bg0nT+YMeOFyVr4zcG5Tw==}
     engines: {node: '>=16 || 14 >=14.17'}
     hasBin: true
 
@@ -7240,12 +6949,12 @@ packages:
     engines: {node: '>=14.0.0'}
     hasBin: true
 
-  tapable@2.2.3:
-    resolution: {integrity: sha512-ZL6DDuAlRlLGghwcfmSn9sK3Hr6ArtyudlSAiCqQ6IfE+b+HHbydbYDIG15IfS5do+7XQQBdBiubF/cV2dnDzg==}
+  tapable@2.3.0:
+    resolution: {integrity: sha512-g9ljZiwki/LfxmQADO3dEY1CbpmXT5Hm2fJ+QaGKwSXUylMybePR7/67YW7jOrrvjEgL1Fmz5kzyAjWVWLlucg==}
     engines: {node: '>=6'}
 
-  terser-webpack-plugin@5.3.14:
-    resolution: {integrity: sha512-vkZjpUjb6OMS7dhV+tILUW6BhpDR7P2L/aQSAv+Uwk+m8KATX9EccViHTJR2qDtACKPIYndLGCyl3FMo+r2LMw==}
+  terser-webpack-plugin@5.3.16:
+    resolution: {integrity: sha512-h9oBFCWrq78NyWWVcSwZarJkZ01c2AyGrzs1crmHZO3QUg9D61Wu4NPjBy69n7JqylFF5y+CsUZYmYEIZ3mR+Q==}
     engines: {node: '>= 10.13.0'}
     peerDependencies:
       '@swc/core': '*'
@@ -7260,8 +6969,8 @@ packages:
       uglify-js:
         optional: true
 
-  terser@5.44.0:
-    resolution: {integrity: sha512-nIVck8DK+GM/0Frwd+nIhZ84pR/BX7rmXMfYwyg+Sri5oGVE99/E3KvXqpC2xHFxyqXyGHTKBSioxxplrO4I4w==}
+  terser@5.44.1:
+    resolution: {integrity: sha512-t/R3R/n0MSwnnazuPpPNVO60LX0SKL45pyl9YlvxIdkH0Of7D5qM2EVe+yASRIlY5pZ73nclYJfNANGWPwFDZw==}
     engines: {node: '>=10'}
     hasBin: true
 
@@ -7293,15 +7002,15 @@ packages:
     resolution: {integrity: sha512-op4nsTR47R6p0vMUUoYl/a+ljLFVtlfaXkLQmqfLR1qHma1h/ysYk4hEXZ880bf2CYgTskvTa/e196Vd5dDQXw==}
     engines: {node: '>=14.0.0'}
 
-  tinyspy@4.0.3:
-    resolution: {integrity: sha512-t2T/WLB2WRgZ9EpE4jgPJ9w+i66UZfDc8wHh0xrwiRNN+UwH98GIJkTeZqX9rg0i0ptwzqW+uYeIF0T4F8LR7A==}
+  tinyspy@4.0.4:
+    resolution: {integrity: sha512-azl+t0z7pw/z958Gy9svOTuzqIk6xq+NSheJzn5MMWtWTFywIacg2wUlzKFGtt3cthx0r2SxMK0yzJOR0IES7Q==}
     engines: {node: '>=14.0.0'}
 
-  tldts-core@7.0.17:
-    resolution: {integrity: sha512-DieYoGrP78PWKsrXr8MZwtQ7GLCUeLxihtjC1jZsW1DnvSMdKPitJSe8OSYDM2u5H6g3kWJZpePqkp43TfLh0g==}
+  tldts-core@7.0.19:
+    resolution: {integrity: sha512-lJX2dEWx0SGH4O6p+7FPwYmJ/bu1JbcGJ8RLaG9b7liIgZ85itUVEPbMtWRVrde/0fnDPEPHW10ZsKW3kVsE9A==}
 
-  tldts@7.0.17:
-    resolution: {integrity: sha512-Y1KQBgDd/NUc+LfOtKS6mNsC9CCaH+m2P1RoIZy7RAPo3C3/t8X45+zgut31cRZtZ3xKPjfn3TkGTrctC2TQIQ==}
+  tldts@7.0.19:
+    resolution: {integrity: sha512-8PWx8tvC4jDB39BQw1m4x8y5MH1BcQ5xHeL2n7UVFulMPH/3Q0uiamahFJ3lXA0zO2SUyRXuVVbWSDmstlt9YA==}
     hasBin: true
 
   to-buffer@1.2.2:
@@ -7329,8 +7038,8 @@ packages:
   trough@2.2.0:
     resolution: {integrity: sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw==}
 
-  ts-api-utils@2.1.0:
-    resolution: {integrity: sha512-CUgTZL1irw8u29bzrOD/nH85jqyc74D6SshFgujOIA7osm2Rz7dYH77agkx7H4FBNxDq7Cjf+IjaX/8zwFW+ZQ==}
+  ts-api-utils@2.4.0:
+    resolution: {integrity: sha512-3TaVTaAv2gTiMB35i3FiGJaRfwb3Pyn/j3m/bfAvGe8FB7CF6u+LMYqYlDh7reQf7UNvoTvdfAqHGmPGOSsPmA==}
     engines: {node: '>=18.12'}
     peerDependencies:
       typescript: '>=4.8.4'
@@ -7366,9 +7075,6 @@ packages:
   tslib@1.14.1:
     resolution: {integrity: sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==}
 
-  tslib@2.6.2:
-    resolution: {integrity: sha512-AEYxH93jGFPn/a2iVAwW87VuUIkR1FVUKB77NwMF7nBTDkDrrT/Hpt/IrCJ0QXhW27jTBDcf5ZY7w6RiqTMw2Q==}
-
   tslib@2.8.1:
     resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==}
 
@@ -7423,8 +7129,8 @@ packages:
     peerDependencies:
       typedoc: 0.28.x
 
-  typedoc@0.28.14:
-    resolution: {integrity: sha512-ftJYPvpVfQvFzpkoSfHLkJybdA/geDJ8BGQt/ZnkkhnBYoYW6lBgPQXu6vqLxO4X75dA55hX8Af847H5KXlEFA==}
+  typedoc@0.28.15:
+    resolution: {integrity: sha512-mw2/2vTL7MlT+BVo43lOsufkkd2CJO4zeOSuWQQsiXoV2VuEn7f6IZp2jsUDPmBMABpgR0R5jlcJ2OGEFYmkyg==}
     engines: {node: '>= 18', pnpm: '>= 10'}
     hasBin: true
     peerDependencies:
@@ -7453,12 +7159,12 @@ packages:
     resolution: {integrity: sha512-5kaZCrbp5mmbz5ulBkDkbY0SsPOjKqVS35VpL9ulMPfSl0J0Xsm+9Evphv9CoIZFwre7aJoa94AY6seMKGVN5Q==}
     engines: {node: '>=4'}
 
-  unicode-match-property-value-ecmascript@2.2.0:
-    resolution: {integrity: sha512-4IehN3V/+kkr5YeSSDDQG8QLqO26XpL2XP3GQtqwlT/QYSECAwFztxVHjlbh0+gjJ3XmNLS0zDsbgs9jWKExLg==}
+  unicode-match-property-value-ecmascript@2.2.1:
+    resolution: {integrity: sha512-JQ84qTuMg4nVkx8ga4A16a1epI9H6uTXAknqxkGF/aFfRLw1xC/Bp24HNLaZhHSkWd3+84t8iXnp1J0kYcZHhg==}
     engines: {node: '>=4'}
 
-  unicode-property-aliases-ecmascript@2.1.0:
-    resolution: {integrity: sha512-6t3foTQI9qne+OZoVQB/8x8rk2k1eVy1gRXhV3oFQ5T6R1dqQ1xtin3XqSlx3+ATBkliTaR/hHyJBm+LVPNM8w==}
+  unicode-property-aliases-ecmascript@2.2.0:
+    resolution: {integrity: sha512-hpbDzxUY9BFwX+UeBnxv3Sh1q7HFxj48DTmXchNgRa46lO8uj3/1iEn3MiNUYTg1g9ctIqXCCERn8gYZhHC5lQ==}
     engines: {node: '>=4'}
 
   unicorn-magic@0.1.0:
@@ -7471,8 +7177,8 @@ packages:
   unist-util-find-after@5.0.0:
     resolution: {integrity: sha512-amQa0Ep2m6hE2g72AugUItjbuM8X8cGQnFoHk0pGfrFeT9GZhzN5SW8nRsiGKK7Aif4CrACPENkA6P/Lw6fHGQ==}
 
-  unist-util-is@6.0.0:
-    resolution: {integrity: sha512-2qCTHimwdxLfz+YzdGfkqNlH0tLi9xjTnHddPmJwtIG9MGsdbutfTc4P+haPD7l7Cjxf/WZj+we5qfVPvvxfYw==}
+  unist-util-is@6.0.1:
+    resolution: {integrity: sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g==}
 
   unist-util-position@5.0.0:
     resolution: {integrity: sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==}
@@ -7483,8 +7189,8 @@ packages:
   unist-util-stringify-position@4.0.0:
     resolution: {integrity: sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==}
 
-  unist-util-visit-parents@6.0.1:
-    resolution: {integrity: sha512-L/PqWzfTP9lzzEa6CKs0k2nARxTdZduw3zyh8d2NVBnsyvHjSX4TWse388YrrQKbvI8w20fGjGlhgT96WwKykw==}
+  unist-util-visit-parents@6.0.2:
+    resolution: {integrity: sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==}
 
   unist-util-visit@5.0.0:
     resolution: {integrity: sha512-MR04uvD+07cwl/yhVuVWAtw+3GOR/knlL55Nd/wAdblk27GCVt3lqpTivy/tkJcZoNPzTwS1Y+KMojlLDhoTzg==}
@@ -7506,8 +7212,8 @@ packages:
   until-async@3.0.2:
     resolution: {integrity: sha512-IiSk4HlzAMqTUseHHe3VhIGyuFmN90zMTpD3Z3y8jeQbzLIq500MVM7Jq2vUAnTKAFPJrqwkzr6PoTcPhGcOiw==}
 
-  update-browserslist-db@1.1.3:
-    resolution: {integrity: sha512-UxhIZQ+QInVdunkDAaiazvvT/+fXL5Osr0JZlJulepYu6Jd7qJtDZjlur0emRlT71EN3ScPoE7gvsuIKKNavKw==}
+  update-browserslist-db@1.2.3:
+    resolution: {integrity: sha512-Js0m9cx+qOgDxo0eMiFGEueWztz+d4+M3rGlmKPT+T4IS/jP4ylw3Nwpu6cpTTP8R1MAC1kF4VbdLt3ARf209w==}
     hasBin: true
     peerDependencies:
       browserslist: '>= 4.21.0'
@@ -7542,8 +7248,8 @@ packages:
       '@types/react':
         optional: true
 
-  use-sync-external-store@1.5.0:
-    resolution: {integrity: sha512-Rb46I4cGGVBmjamjphe8L/UnvJD+uPPtTkNvX5mZgqdbavhI4EbgIWJiIHXJ8bc/i9EQGPRh4DwEURJ552Do0A==}
+  use-sync-external-store@1.6.0:
+    resolution: {integrity: sha512-Pp6GSwGP/NrPIrxVFAIkOQeyw8lFenOHijQWkUTrDvrF4ALqylP2C/KCkeS9dpUM3KvYRQhna5vt7IL95+ZQ9w==}
     peerDependencies:
       react: ^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0
 
@@ -7572,23 +7278,8 @@ packages:
     resolution: {integrity: sha512-b+1eJOlsR9K8HJpow9Ok3fiWOWSIcIzXodvv0rQjVoOVNpWMpxf1wZNpt4y9h10odCNrqnYp1OBzRktckBe3sA==}
     hasBin: true
 
-  validate.io-array@1.0.6:
-    resolution: {integrity: sha512-DeOy7CnPEziggrOO5CZhVKJw6S3Yi7e9e65R1Nl/RTN1vTQKnzjfvks0/8kQ40FP/dsjRAOd4hxmJ7uLa6vxkg==}
-
-  validate.io-function@1.0.2:
-    resolution: {integrity: sha512-LlFybRJEriSuBnUhQyG5bwglhh50EpTL2ul23MPIuR1odjO7XaMLFV8vHGwp7AZciFxtYOeiSCT5st+XSPONiQ==}
-
-  validate.io-integer-array@1.0.0:
-    resolution: {integrity: sha512-mTrMk/1ytQHtCY0oNO3dztafHYyGU88KL+jRxWuzfOmQb+4qqnWmI+gykvGp8usKZOM0H7keJHEbRaFiYA0VrA==}
-
-  validate.io-integer@1.0.5:
-    resolution: {integrity: sha512-22izsYSLojN/P6bppBqhgUDjCkr5RY2jd+N2a3DCAUey8ydvrZ/OkGvFPR7qfOpwR2LC5p4Ngzxz36g5Vgr/hQ==}
-
-  validate.io-number@1.0.3:
-    resolution: {integrity: sha512-kRAyotcbNaSYoDnXvb4MHg/0a1egJdLwS6oJ38TJY7aw9n93Fl/3blIXdyYvPOp55CNxywooG/3BcrwNrBpcSg==}
-
-  validator@13.15.20:
-    resolution: {integrity: sha512-KxPOq3V2LmfQPP4eqf3Mq/zrT0Dqp2Vmx2Bn285LwVahLc+CsxOM0crBHczm8ijlcjZ0Q5Xd6LW3z3odTPnlrw==}
+  validator@13.15.26:
+    resolution: {integrity: sha512-spH26xU080ydGggxRyR1Yhcbgx+j3y5jbNXk/8L+iRvdIEQ4uTRH2Sgf2dokud6Q4oAtsbNvJ1Ft+9xmm6IZcA==}
     engines: {node: '>= 0.10'}
 
   vaul@1.1.2:
@@ -7615,8 +7306,8 @@ packages:
   warning@4.0.3:
     resolution: {integrity: sha512-rpJyN222KWIvHJ/F53XSZv0Zl/accqHR8et1kpaMTD/fLCRxtV8iX8czMzY7sVZupTI3zcUTg8eycS2kNF9l6w==}
 
-  watchpack@2.4.4:
-    resolution: {integrity: sha512-c5EGNOiyxxV5qmTtAB7rbiXxi1ooX1pQKMLX/MIabJjRA0SJBQOjKF+KSVfHkr9U1cADPon0mRiVe/riyaiDUA==}
+  watchpack@2.5.0:
+    resolution: {integrity: sha512-e6vZvY6xboSwLz2GD36c16+O/2Z6fKvIf4pOXptw2rY9MVwE/TXc6RGqxD3I3x0a28lwBY7DE+76uTPSsBrrCA==}
     engines: {node: '>=10.13.0'}
 
   web-namespaces@2.0.1:
@@ -7647,8 +7338,8 @@ packages:
   webpack-virtual-modules@0.6.2:
     resolution: {integrity: sha512-66/V2i5hQanC51vBQKPH4aI8NMAcBW59FVBs+rC7eGHupMyfn34q7rZIE+ETlJ+XTevqfUhVVBgSUNSW2flEUQ==}
 
-  webpack@5.101.3:
-    resolution: {integrity: sha512-7b0dTKR3Ed//AD/6kkx/o7duS8H3f1a4w3BYpIriX4BzIhjkn4teo05cptsxvLesHFKK5KObnadmCHBwGc+51A==}
+  webpack@5.104.1:
+    resolution: {integrity: sha512-Qphch25abbMNtekmEGJmeRUhLDbe+QfiWTiqpKYkpCOWY64v9eyl+KRRLmqOFA2AvKPpc9DC6+u2n76tQLBoaA==}
     engines: {node: '>=10.13.0'}
     hasBin: true
     peerDependencies:
@@ -7700,8 +7391,8 @@ packages:
   wrappy@1.0.2:
     resolution: {integrity: sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==}
 
-  ws@8.18.3:
-    resolution: {integrity: sha512-PEIGCY5tSlUt50cqyMXfCzX+oOPqN0vuGqWzbcJ2xvnkzkq46oOpz7dQaTDBdfICb4N14+GARUDw2XV2N4tvzg==}
+  ws@8.19.0:
+    resolution: {integrity: sha512-blAT2mjOEIi0ZzruJfIhb3nps74PRWTCz1IjglWEEpQl5XS/UNama6u2/rjFkDDouqr4L67ry+1aGIALViWjDg==}
     engines: {node: '>=10.0.0'}
     peerDependencies:
       bufferutil: ^4.0.1
@@ -7731,8 +7422,8 @@ packages:
     resolution: {integrity: sha512-r3vXyErRCYJ7wg28yvBY5VSoAF8ZvlcW9/BwUzEtUsjvX/DKs24dIkuwjtuprwJJHsbyUbLApepYTR1BN4uHrg==}
     engines: {node: '>= 6'}
 
-  yaml@2.8.1:
-    resolution: {integrity: sha512-lcYcMxX2PO9XMGvAJkJ3OsNMw+/7FKes7/hgerGUYWIoWu5j/+YQqcZr5JnPZWzOsEBgMbSbiSTn/dv/69Mkpw==}
+  yaml@2.8.2:
+    resolution: {integrity: sha512-mplynKqc1C2hTVYxd0PU2xQAc22TI1vShAYGksCCfxbn/dFwnHTNi1bvYsBTkhdUNtGIf5xNOg938rrSSYvS9A==}
     engines: {node: '>= 14.6'}
     hasBin: true
 
@@ -7748,8 +7439,8 @@ packages:
     resolution: {integrity: sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==}
     engines: {node: '>=10'}
 
-  yocto-queue@1.2.1:
-    resolution: {integrity: sha512-AyeEbWOu/TAXdxlV9wmGcR0+yh2j3vYPGOECcIj2S7MkrLyC7ne+oye2BKTItt0ii2PHk4cDy+95+LshzbXnGg==}
+  yocto-queue@1.2.2:
+    resolution: {integrity: sha512-4LCcse/U2MHZ63HAJVE+v71o7yOdIe4cZ70Wpf8D/IyjDKYQLV5GD46B+hSTjJsvV5PztjvHoU580EftxjDZFQ==}
     engines: {node: '>=12.20'}
 
   yoctocolors-cjs@2.1.3:
@@ -7836,23 +7527,23 @@ snapshots:
 
   '@babel/code-frame@7.27.1':
     dependencies:
-      '@babel/helper-validator-identifier': 7.27.1
+      '@babel/helper-validator-identifier': 7.28.5
       js-tokens: 4.0.0
       picocolors: 1.1.1
 
-  '@babel/compat-data@7.28.4': {}
+  '@babel/compat-data@7.28.5': {}
 
-  '@babel/core@7.28.4':
+  '@babel/core@7.28.5':
     dependencies:
       '@babel/code-frame': 7.27.1
-      '@babel/generator': 7.28.3
+      '@babel/generator': 7.28.5
       '@babel/helper-compilation-targets': 7.27.2
-      '@babel/helper-module-transforms': 7.28.3(@babel/core@7.28.4)
+      '@babel/helper-module-transforms': 7.28.3(@babel/core@7.28.5)
       '@babel/helpers': 7.28.4
-      '@babel/parser': 7.28.4
+      '@babel/parser': 7.28.5
       '@babel/template': 7.27.2
-      '@babel/traverse': 7.28.4
-      '@babel/types': 7.28.4
+      '@babel/traverse': 7.28.5
+      '@babel/types': 7.28.5
       '@jridgewell/remapping': 2.3.5
       convert-source-map: 2.0.0
       debug: 4.4.3
@@ -7862,49 +7553,49 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/generator@7.28.3':
+  '@babel/generator@7.28.5':
     dependencies:
-      '@babel/parser': 7.28.4
-      '@babel/types': 7.28.4
+      '@babel/parser': 7.28.5
+      '@babel/types': 7.28.5
       '@jridgewell/gen-mapping': 0.3.13
-      '@jridgewell/trace-mapping': 0.3.30
+      '@jridgewell/trace-mapping': 0.3.31
       jsesc: 3.1.0
 
   '@babel/helper-annotate-as-pure@7.27.3':
     dependencies:
-      '@babel/types': 7.28.4
+      '@babel/types': 7.28.5
 
   '@babel/helper-compilation-targets@7.27.2':
     dependencies:
-      '@babel/compat-data': 7.28.4
+      '@babel/compat-data': 7.28.5
       '@babel/helper-validator-option': 7.27.1
-      browserslist: 4.25.4
+      browserslist: 4.28.1
       lru-cache: 5.1.1
       semver: 6.3.1
 
-  '@babel/helper-create-class-features-plugin@7.28.3(@babel/core@7.28.4)':
+  '@babel/helper-create-class-features-plugin@7.28.5(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-annotate-as-pure': 7.27.3
-      '@babel/helper-member-expression-to-functions': 7.27.1
+      '@babel/helper-member-expression-to-functions': 7.28.5
       '@babel/helper-optimise-call-expression': 7.27.1
-      '@babel/helper-replace-supers': 7.27.1(@babel/core@7.28.4)
+      '@babel/helper-replace-supers': 7.27.1(@babel/core@7.28.5)
       '@babel/helper-skip-transparent-expression-wrappers': 7.27.1
-      '@babel/traverse': 7.28.4
+      '@babel/traverse': 7.28.5
       semver: 6.3.1
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/helper-create-regexp-features-plugin@7.27.1(@babel/core@7.28.4)':
+  '@babel/helper-create-regexp-features-plugin@7.28.5(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-annotate-as-pure': 7.27.3
-      regexpu-core: 6.2.0
+      regexpu-core: 6.4.0
       semver: 6.3.1
 
-  '@babel/helper-define-polyfill-provider@0.6.5(@babel/core@7.28.4)':
+  '@babel/helper-define-polyfill-provider@0.6.5(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-compilation-targets': 7.27.2
       '@babel/helper-plugin-utils': 7.27.1
       debug: 4.4.3
@@ -7915,646 +7606,646 @@ snapshots:
 
   '@babel/helper-globals@7.28.0': {}
 
-  '@babel/helper-member-expression-to-functions@7.27.1':
+  '@babel/helper-member-expression-to-functions@7.28.5':
     dependencies:
-      '@babel/traverse': 7.28.4
-      '@babel/types': 7.28.4
+      '@babel/traverse': 7.28.5
+      '@babel/types': 7.28.5
     transitivePeerDependencies:
       - supports-color
 
   '@babel/helper-module-imports@7.27.1':
     dependencies:
-      '@babel/traverse': 7.28.4
-      '@babel/types': 7.28.4
+      '@babel/traverse': 7.28.5
+      '@babel/types': 7.28.5
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/helper-module-transforms@7.28.3(@babel/core@7.28.4)':
+  '@babel/helper-module-transforms@7.28.3(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-module-imports': 7.27.1
-      '@babel/helper-validator-identifier': 7.27.1
-      '@babel/traverse': 7.28.4
+      '@babel/helper-validator-identifier': 7.28.5
+      '@babel/traverse': 7.28.5
     transitivePeerDependencies:
       - supports-color
 
   '@babel/helper-optimise-call-expression@7.27.1':
     dependencies:
-      '@babel/types': 7.28.4
+      '@babel/types': 7.28.5
 
   '@babel/helper-plugin-utils@7.27.1': {}
 
-  '@babel/helper-remap-async-to-generator@7.27.1(@babel/core@7.28.4)':
+  '@babel/helper-remap-async-to-generator@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-annotate-as-pure': 7.27.3
       '@babel/helper-wrap-function': 7.28.3
-      '@babel/traverse': 7.28.4
+      '@babel/traverse': 7.28.5
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/helper-replace-supers@7.27.1(@babel/core@7.28.4)':
+  '@babel/helper-replace-supers@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/helper-member-expression-to-functions': 7.27.1
+      '@babel/core': 7.28.5
+      '@babel/helper-member-expression-to-functions': 7.28.5
       '@babel/helper-optimise-call-expression': 7.27.1
-      '@babel/traverse': 7.28.4
+      '@babel/traverse': 7.28.5
     transitivePeerDependencies:
       - supports-color
 
   '@babel/helper-skip-transparent-expression-wrappers@7.27.1':
     dependencies:
-      '@babel/traverse': 7.28.4
-      '@babel/types': 7.28.4
+      '@babel/traverse': 7.28.5
+      '@babel/types': 7.28.5
     transitivePeerDependencies:
       - supports-color
 
   '@babel/helper-string-parser@7.27.1': {}
 
-  '@babel/helper-validator-identifier@7.27.1': {}
+  '@babel/helper-validator-identifier@7.28.5': {}
 
   '@babel/helper-validator-option@7.27.1': {}
 
   '@babel/helper-wrap-function@7.28.3':
     dependencies:
       '@babel/template': 7.27.2
-      '@babel/traverse': 7.28.4
-      '@babel/types': 7.28.4
+      '@babel/traverse': 7.28.5
+      '@babel/types': 7.28.5
     transitivePeerDependencies:
       - supports-color
 
   '@babel/helpers@7.28.4':
     dependencies:
       '@babel/template': 7.27.2
-      '@babel/types': 7.28.4
+      '@babel/types': 7.28.5
 
-  '@babel/parser@7.28.4':
+  '@babel/parser@7.28.5':
     dependencies:
-      '@babel/types': 7.28.4
+      '@babel/types': 7.28.5
 
-  '@babel/plugin-bugfix-firefox-class-in-computed-class-key@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-bugfix-firefox-class-in-computed-class-key@7.28.5(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
-      '@babel/traverse': 7.28.4
+      '@babel/traverse': 7.28.5
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-bugfix-safari-class-field-initializer-scope@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-bugfix-safari-class-field-initializer-scope@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
       '@babel/helper-skip-transparent-expression-wrappers': 7.27.1
-      '@babel/plugin-transform-optional-chaining': 7.27.1(@babel/core@7.28.4)
+      '@babel/plugin-transform-optional-chaining': 7.28.5(@babel/core@7.28.5)
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-bugfix-v8-static-class-fields-redefine-readonly@7.28.3(@babel/core@7.28.4)':
+  '@babel/plugin-bugfix-v8-static-class-fields-redefine-readonly@7.28.3(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
-      '@babel/traverse': 7.28.4
+      '@babel/traverse': 7.28.5
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-proposal-private-property-in-object@7.21.0-placeholder-for-preset-env.2(@babel/core@7.28.4)':
+  '@babel/plugin-proposal-private-property-in-object@7.21.0-placeholder-for-preset-env.2(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
 
-  '@babel/plugin-syntax-bigint@7.8.3(@babel/core@7.28.4)':
+  '@babel/plugin-syntax-bigint@7.8.3(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-syntax-dynamic-import@7.8.3(@babel/core@7.28.4)':
+  '@babel/plugin-syntax-dynamic-import@7.8.3(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-syntax-import-assertions@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-syntax-import-assertions@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-syntax-import-attributes@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-syntax-import-attributes@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-syntax-jsx@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-syntax-jsx@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-syntax-typescript@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-syntax-typescript@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-syntax-unicode-sets-regex@7.18.6(@babel/core@7.28.4)':
+  '@babel/plugin-syntax-unicode-sets-regex@7.18.6(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/helper-create-regexp-features-plugin': 7.27.1(@babel/core@7.28.4)
+      '@babel/core': 7.28.5
+      '@babel/helper-create-regexp-features-plugin': 7.28.5(@babel/core@7.28.5)
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-arrow-functions@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-arrow-functions@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-async-generator-functions@7.28.0(@babel/core@7.28.4)':
+  '@babel/plugin-transform-async-generator-functions@7.28.0(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
-      '@babel/helper-remap-async-to-generator': 7.27.1(@babel/core@7.28.4)
-      '@babel/traverse': 7.28.4
+      '@babel/helper-remap-async-to-generator': 7.27.1(@babel/core@7.28.5)
+      '@babel/traverse': 7.28.5
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-async-to-generator@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-async-to-generator@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-module-imports': 7.27.1
       '@babel/helper-plugin-utils': 7.27.1
-      '@babel/helper-remap-async-to-generator': 7.27.1(@babel/core@7.28.4)
+      '@babel/helper-remap-async-to-generator': 7.27.1(@babel/core@7.28.5)
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-block-scoped-functions@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-block-scoped-functions@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-block-scoping@7.28.4(@babel/core@7.28.4)':
+  '@babel/plugin-transform-block-scoping@7.28.5(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-class-properties@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-class-properties@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/helper-create-class-features-plugin': 7.28.3(@babel/core@7.28.4)
+      '@babel/core': 7.28.5
+      '@babel/helper-create-class-features-plugin': 7.28.5(@babel/core@7.28.5)
       '@babel/helper-plugin-utils': 7.27.1
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-class-static-block@7.28.3(@babel/core@7.28.4)':
+  '@babel/plugin-transform-class-static-block@7.28.3(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/helper-create-class-features-plugin': 7.28.3(@babel/core@7.28.4)
+      '@babel/core': 7.28.5
+      '@babel/helper-create-class-features-plugin': 7.28.5(@babel/core@7.28.5)
       '@babel/helper-plugin-utils': 7.27.1
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-classes@7.28.4(@babel/core@7.28.4)':
+  '@babel/plugin-transform-classes@7.28.4(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-annotate-as-pure': 7.27.3
       '@babel/helper-compilation-targets': 7.27.2
       '@babel/helper-globals': 7.28.0
       '@babel/helper-plugin-utils': 7.27.1
-      '@babel/helper-replace-supers': 7.27.1(@babel/core@7.28.4)
-      '@babel/traverse': 7.28.4
+      '@babel/helper-replace-supers': 7.27.1(@babel/core@7.28.5)
+      '@babel/traverse': 7.28.5
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-computed-properties@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-computed-properties@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
       '@babel/template': 7.27.2
 
-  '@babel/plugin-transform-destructuring@7.28.0(@babel/core@7.28.4)':
+  '@babel/plugin-transform-destructuring@7.28.5(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
-      '@babel/traverse': 7.28.4
+      '@babel/traverse': 7.28.5
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-dotall-regex@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-dotall-regex@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/helper-create-regexp-features-plugin': 7.27.1(@babel/core@7.28.4)
+      '@babel/core': 7.28.5
+      '@babel/helper-create-regexp-features-plugin': 7.28.5(@babel/core@7.28.5)
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-duplicate-keys@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-duplicate-keys@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-duplicate-named-capturing-groups-regex@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-duplicate-named-capturing-groups-regex@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/helper-create-regexp-features-plugin': 7.27.1(@babel/core@7.28.4)
+      '@babel/core': 7.28.5
+      '@babel/helper-create-regexp-features-plugin': 7.28.5(@babel/core@7.28.5)
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-dynamic-import@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-dynamic-import@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-explicit-resource-management@7.28.0(@babel/core@7.28.4)':
+  '@babel/plugin-transform-explicit-resource-management@7.28.0(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
-      '@babel/plugin-transform-destructuring': 7.28.0(@babel/core@7.28.4)
+      '@babel/plugin-transform-destructuring': 7.28.5(@babel/core@7.28.5)
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-exponentiation-operator@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-exponentiation-operator@7.28.5(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-export-namespace-from@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-export-namespace-from@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-for-of@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-for-of@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
       '@babel/helper-skip-transparent-expression-wrappers': 7.27.1
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-function-name@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-function-name@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-compilation-targets': 7.27.2
       '@babel/helper-plugin-utils': 7.27.1
-      '@babel/traverse': 7.28.4
+      '@babel/traverse': 7.28.5
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-json-strings@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-json-strings@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-literals@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-literals@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-logical-assignment-operators@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-logical-assignment-operators@7.28.5(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-member-expression-literals@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-member-expression-literals@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-modules-amd@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-modules-amd@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/helper-module-transforms': 7.28.3(@babel/core@7.28.4)
+      '@babel/core': 7.28.5
+      '@babel/helper-module-transforms': 7.28.3(@babel/core@7.28.5)
       '@babel/helper-plugin-utils': 7.27.1
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-modules-commonjs@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-modules-commonjs@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/helper-module-transforms': 7.28.3(@babel/core@7.28.4)
+      '@babel/core': 7.28.5
+      '@babel/helper-module-transforms': 7.28.3(@babel/core@7.28.5)
       '@babel/helper-plugin-utils': 7.27.1
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-modules-systemjs@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-modules-systemjs@7.28.5(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/helper-module-transforms': 7.28.3(@babel/core@7.28.4)
+      '@babel/core': 7.28.5
+      '@babel/helper-module-transforms': 7.28.3(@babel/core@7.28.5)
       '@babel/helper-plugin-utils': 7.27.1
-      '@babel/helper-validator-identifier': 7.27.1
-      '@babel/traverse': 7.28.4
+      '@babel/helper-validator-identifier': 7.28.5
+      '@babel/traverse': 7.28.5
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-modules-umd@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-modules-umd@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/helper-module-transforms': 7.28.3(@babel/core@7.28.4)
+      '@babel/core': 7.28.5
+      '@babel/helper-module-transforms': 7.28.3(@babel/core@7.28.5)
       '@babel/helper-plugin-utils': 7.27.1
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-named-capturing-groups-regex@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-named-capturing-groups-regex@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/helper-create-regexp-features-plugin': 7.27.1(@babel/core@7.28.4)
+      '@babel/core': 7.28.5
+      '@babel/helper-create-regexp-features-plugin': 7.28.5(@babel/core@7.28.5)
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-new-target@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-new-target@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-nullish-coalescing-operator@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-nullish-coalescing-operator@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-numeric-separator@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-numeric-separator@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-object-rest-spread@7.28.4(@babel/core@7.28.4)':
+  '@babel/plugin-transform-object-rest-spread@7.28.4(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-compilation-targets': 7.27.2
       '@babel/helper-plugin-utils': 7.27.1
-      '@babel/plugin-transform-destructuring': 7.28.0(@babel/core@7.28.4)
-      '@babel/plugin-transform-parameters': 7.27.7(@babel/core@7.28.4)
-      '@babel/traverse': 7.28.4
+      '@babel/plugin-transform-destructuring': 7.28.5(@babel/core@7.28.5)
+      '@babel/plugin-transform-parameters': 7.27.7(@babel/core@7.28.5)
+      '@babel/traverse': 7.28.5
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-object-super@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-object-super@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
-      '@babel/helper-replace-supers': 7.27.1(@babel/core@7.28.4)
+      '@babel/helper-replace-supers': 7.27.1(@babel/core@7.28.5)
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-optional-catch-binding@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-optional-catch-binding@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-optional-chaining@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-optional-chaining@7.28.5(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
       '@babel/helper-skip-transparent-expression-wrappers': 7.27.1
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-parameters@7.27.7(@babel/core@7.28.4)':
+  '@babel/plugin-transform-parameters@7.27.7(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-private-methods@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-private-methods@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/helper-create-class-features-plugin': 7.28.3(@babel/core@7.28.4)
+      '@babel/core': 7.28.5
+      '@babel/helper-create-class-features-plugin': 7.28.5(@babel/core@7.28.5)
       '@babel/helper-plugin-utils': 7.27.1
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-private-property-in-object@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-private-property-in-object@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-annotate-as-pure': 7.27.3
-      '@babel/helper-create-class-features-plugin': 7.28.3(@babel/core@7.28.4)
+      '@babel/helper-create-class-features-plugin': 7.28.5(@babel/core@7.28.5)
       '@babel/helper-plugin-utils': 7.27.1
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-property-literals@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-property-literals@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-react-display-name@7.28.0(@babel/core@7.28.4)':
+  '@babel/plugin-transform-react-display-name@7.28.0(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-react-jsx-development@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-react-jsx-development@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/plugin-transform-react-jsx': 7.27.1(@babel/core@7.28.4)
+      '@babel/core': 7.28.5
+      '@babel/plugin-transform-react-jsx': 7.27.1(@babel/core@7.28.5)
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-react-jsx@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-react-jsx@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-annotate-as-pure': 7.27.3
       '@babel/helper-module-imports': 7.27.1
       '@babel/helper-plugin-utils': 7.27.1
-      '@babel/plugin-syntax-jsx': 7.27.1(@babel/core@7.28.4)
-      '@babel/types': 7.28.4
+      '@babel/plugin-syntax-jsx': 7.27.1(@babel/core@7.28.5)
+      '@babel/types': 7.28.5
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-react-pure-annotations@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-react-pure-annotations@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-annotate-as-pure': 7.27.3
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-regenerator@7.28.4(@babel/core@7.28.4)':
+  '@babel/plugin-transform-regenerator@7.28.4(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-regexp-modifiers@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-regexp-modifiers@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/helper-create-regexp-features-plugin': 7.27.1(@babel/core@7.28.4)
+      '@babel/core': 7.28.5
+      '@babel/helper-create-regexp-features-plugin': 7.28.5(@babel/core@7.28.5)
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-reserved-words@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-reserved-words@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-runtime@7.28.3(@babel/core@7.28.4)':
+  '@babel/plugin-transform-runtime@7.28.5(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-module-imports': 7.27.1
       '@babel/helper-plugin-utils': 7.27.1
-      babel-plugin-polyfill-corejs2: 0.4.14(@babel/core@7.28.4)
-      babel-plugin-polyfill-corejs3: 0.13.0(@babel/core@7.28.4)
-      babel-plugin-polyfill-regenerator: 0.6.5(@babel/core@7.28.4)
+      babel-plugin-polyfill-corejs2: 0.4.14(@babel/core@7.28.5)
+      babel-plugin-polyfill-corejs3: 0.13.0(@babel/core@7.28.5)
+      babel-plugin-polyfill-regenerator: 0.6.5(@babel/core@7.28.5)
       semver: 6.3.1
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-shorthand-properties@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-shorthand-properties@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-spread@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-spread@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
       '@babel/helper-skip-transparent-expression-wrappers': 7.27.1
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-sticky-regex@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-sticky-regex@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-template-literals@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-template-literals@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-typeof-symbol@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-typeof-symbol@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-typescript@7.28.0(@babel/core@7.28.4)':
+  '@babel/plugin-transform-typescript@7.28.5(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-annotate-as-pure': 7.27.3
-      '@babel/helper-create-class-features-plugin': 7.28.3(@babel/core@7.28.4)
+      '@babel/helper-create-class-features-plugin': 7.28.5(@babel/core@7.28.5)
       '@babel/helper-plugin-utils': 7.27.1
       '@babel/helper-skip-transparent-expression-wrappers': 7.27.1
-      '@babel/plugin-syntax-typescript': 7.27.1(@babel/core@7.28.4)
+      '@babel/plugin-syntax-typescript': 7.27.1(@babel/core@7.28.5)
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/plugin-transform-unicode-escapes@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-unicode-escapes@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-unicode-property-regex@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-unicode-property-regex@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/helper-create-regexp-features-plugin': 7.27.1(@babel/core@7.28.4)
+      '@babel/core': 7.28.5
+      '@babel/helper-create-regexp-features-plugin': 7.28.5(@babel/core@7.28.5)
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-unicode-regex@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-unicode-regex@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/helper-create-regexp-features-plugin': 7.27.1(@babel/core@7.28.4)
+      '@babel/core': 7.28.5
+      '@babel/helper-create-regexp-features-plugin': 7.28.5(@babel/core@7.28.5)
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/plugin-transform-unicode-sets-regex@7.27.1(@babel/core@7.28.4)':
+  '@babel/plugin-transform-unicode-sets-regex@7.27.1(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/helper-create-regexp-features-plugin': 7.27.1(@babel/core@7.28.4)
+      '@babel/core': 7.28.5
+      '@babel/helper-create-regexp-features-plugin': 7.28.5(@babel/core@7.28.5)
       '@babel/helper-plugin-utils': 7.27.1
 
-  '@babel/preset-env@7.28.3(@babel/core@7.28.4)':
+  '@babel/preset-env@7.28.5(@babel/core@7.28.5)':
     dependencies:
-      '@babel/compat-data': 7.28.4
-      '@babel/core': 7.28.4
+      '@babel/compat-data': 7.28.5
+      '@babel/core': 7.28.5
       '@babel/helper-compilation-targets': 7.27.2
       '@babel/helper-plugin-utils': 7.27.1
       '@babel/helper-validator-option': 7.27.1
-      '@babel/plugin-bugfix-firefox-class-in-computed-class-key': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-bugfix-safari-class-field-initializer-scope': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-bugfix-v8-static-class-fields-redefine-readonly': 7.28.3(@babel/core@7.28.4)
-      '@babel/plugin-proposal-private-property-in-object': 7.21.0-placeholder-for-preset-env.2(@babel/core@7.28.4)
-      '@babel/plugin-syntax-import-assertions': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-syntax-import-attributes': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-syntax-unicode-sets-regex': 7.18.6(@babel/core@7.28.4)
-      '@babel/plugin-transform-arrow-functions': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-async-generator-functions': 7.28.0(@babel/core@7.28.4)
-      '@babel/plugin-transform-async-to-generator': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-block-scoped-functions': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-block-scoping': 7.28.4(@babel/core@7.28.4)
-      '@babel/plugin-transform-class-properties': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-class-static-block': 7.28.3(@babel/core@7.28.4)
-      '@babel/plugin-transform-classes': 7.28.4(@babel/core@7.28.4)
-      '@babel/plugin-transform-computed-properties': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-destructuring': 7.28.0(@babel/core@7.28.4)
-      '@babel/plugin-transform-dotall-regex': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-duplicate-keys': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-duplicate-named-capturing-groups-regex': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-dynamic-import': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-explicit-resource-management': 7.28.0(@babel/core@7.28.4)
-      '@babel/plugin-transform-exponentiation-operator': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-export-namespace-from': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-for-of': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-function-name': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-json-strings': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-literals': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-logical-assignment-operators': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-member-expression-literals': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-modules-amd': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-modules-commonjs': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-modules-systemjs': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-modules-umd': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-named-capturing-groups-regex': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-new-target': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-nullish-coalescing-operator': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-numeric-separator': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-object-rest-spread': 7.28.4(@babel/core@7.28.4)
-      '@babel/plugin-transform-object-super': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-optional-catch-binding': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-optional-chaining': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-parameters': 7.27.7(@babel/core@7.28.4)
-      '@babel/plugin-transform-private-methods': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-private-property-in-object': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-property-literals': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-regenerator': 7.28.4(@babel/core@7.28.4)
-      '@babel/plugin-transform-regexp-modifiers': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-reserved-words': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-shorthand-properties': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-spread': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-sticky-regex': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-template-literals': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-typeof-symbol': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-unicode-escapes': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-unicode-property-regex': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-unicode-regex': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-unicode-sets-regex': 7.27.1(@babel/core@7.28.4)
-      '@babel/preset-modules': 0.1.6-no-external-plugins(@babel/core@7.28.4)
-      babel-plugin-polyfill-corejs2: 0.4.14(@babel/core@7.28.4)
-      babel-plugin-polyfill-corejs3: 0.13.0(@babel/core@7.28.4)
-      babel-plugin-polyfill-regenerator: 0.6.5(@babel/core@7.28.4)
-      core-js-compat: 3.45.1
+      '@babel/plugin-bugfix-firefox-class-in-computed-class-key': 7.28.5(@babel/core@7.28.5)
+      '@babel/plugin-bugfix-safari-class-field-initializer-scope': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-bugfix-v8-static-class-fields-redefine-readonly': 7.28.3(@babel/core@7.28.5)
+      '@babel/plugin-proposal-private-property-in-object': 7.21.0-placeholder-for-preset-env.2(@babel/core@7.28.5)
+      '@babel/plugin-syntax-import-assertions': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-syntax-import-attributes': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-syntax-unicode-sets-regex': 7.18.6(@babel/core@7.28.5)
+      '@babel/plugin-transform-arrow-functions': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-async-generator-functions': 7.28.0(@babel/core@7.28.5)
+      '@babel/plugin-transform-async-to-generator': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-block-scoped-functions': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-block-scoping': 7.28.5(@babel/core@7.28.5)
+      '@babel/plugin-transform-class-properties': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-class-static-block': 7.28.3(@babel/core@7.28.5)
+      '@babel/plugin-transform-classes': 7.28.4(@babel/core@7.28.5)
+      '@babel/plugin-transform-computed-properties': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-destructuring': 7.28.5(@babel/core@7.28.5)
+      '@babel/plugin-transform-dotall-regex': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-duplicate-keys': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-duplicate-named-capturing-groups-regex': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-dynamic-import': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-explicit-resource-management': 7.28.0(@babel/core@7.28.5)
+      '@babel/plugin-transform-exponentiation-operator': 7.28.5(@babel/core@7.28.5)
+      '@babel/plugin-transform-export-namespace-from': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-for-of': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-function-name': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-json-strings': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-literals': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-logical-assignment-operators': 7.28.5(@babel/core@7.28.5)
+      '@babel/plugin-transform-member-expression-literals': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-modules-amd': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-modules-commonjs': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-modules-systemjs': 7.28.5(@babel/core@7.28.5)
+      '@babel/plugin-transform-modules-umd': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-named-capturing-groups-regex': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-new-target': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-nullish-coalescing-operator': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-numeric-separator': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-object-rest-spread': 7.28.4(@babel/core@7.28.5)
+      '@babel/plugin-transform-object-super': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-optional-catch-binding': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-optional-chaining': 7.28.5(@babel/core@7.28.5)
+      '@babel/plugin-transform-parameters': 7.27.7(@babel/core@7.28.5)
+      '@babel/plugin-transform-private-methods': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-private-property-in-object': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-property-literals': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-regenerator': 7.28.4(@babel/core@7.28.5)
+      '@babel/plugin-transform-regexp-modifiers': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-reserved-words': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-shorthand-properties': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-spread': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-sticky-regex': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-template-literals': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-typeof-symbol': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-unicode-escapes': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-unicode-property-regex': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-unicode-regex': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-unicode-sets-regex': 7.27.1(@babel/core@7.28.5)
+      '@babel/preset-modules': 0.1.6-no-external-plugins(@babel/core@7.28.5)
+      babel-plugin-polyfill-corejs2: 0.4.14(@babel/core@7.28.5)
+      babel-plugin-polyfill-corejs3: 0.13.0(@babel/core@7.28.5)
+      babel-plugin-polyfill-regenerator: 0.6.5(@babel/core@7.28.5)
+      core-js-compat: 3.47.0
       semver: 6.3.1
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/preset-modules@0.1.6-no-external-plugins(@babel/core@7.28.4)':
+  '@babel/preset-modules@0.1.6-no-external-plugins(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
-      '@babel/types': 7.28.4
+      '@babel/types': 7.28.5
       esutils: 2.0.3
 
-  '@babel/preset-react@7.27.1(@babel/core@7.28.4)':
+  '@babel/preset-react@7.28.5(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
       '@babel/helper-validator-option': 7.27.1
-      '@babel/plugin-transform-react-display-name': 7.28.0(@babel/core@7.28.4)
-      '@babel/plugin-transform-react-jsx': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-react-jsx-development': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-react-pure-annotations': 7.27.1(@babel/core@7.28.4)
+      '@babel/plugin-transform-react-display-name': 7.28.0(@babel/core@7.28.5)
+      '@babel/plugin-transform-react-jsx': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-react-jsx-development': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-react-pure-annotations': 7.27.1(@babel/core@7.28.5)
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/preset-typescript@7.27.1(@babel/core@7.28.4)':
+  '@babel/preset-typescript@7.28.5(@babel/core@7.28.5)':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@babel/helper-plugin-utils': 7.27.1
       '@babel/helper-validator-option': 7.27.1
-      '@babel/plugin-syntax-jsx': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-modules-commonjs': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-typescript': 7.28.0(@babel/core@7.28.4)
+      '@babel/plugin-syntax-jsx': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-modules-commonjs': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-typescript': 7.28.5(@babel/core@7.28.5)
     transitivePeerDependencies:
       - supports-color
 
@@ -8563,25 +8254,25 @@ snapshots:
   '@babel/template@7.27.2':
     dependencies:
       '@babel/code-frame': 7.27.1
-      '@babel/parser': 7.28.4
-      '@babel/types': 7.28.4
+      '@babel/parser': 7.28.5
+      '@babel/types': 7.28.5
 
-  '@babel/traverse@7.28.4':
+  '@babel/traverse@7.28.5':
     dependencies:
       '@babel/code-frame': 7.27.1
-      '@babel/generator': 7.28.3
+      '@babel/generator': 7.28.5
       '@babel/helper-globals': 7.28.0
-      '@babel/parser': 7.28.4
+      '@babel/parser': 7.28.5
       '@babel/template': 7.27.2
-      '@babel/types': 7.28.4
+      '@babel/types': 7.28.5
       debug: 4.4.3
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/types@7.28.4':
+  '@babel/types@7.28.5':
     dependencies:
       '@babel/helper-string-parser': 7.27.1
-      '@babel/helper-validator-identifier': 7.27.1
+      '@babel/helper-validator-identifier': 7.28.5
 
   '@chromatic-com/storybook@4.1.2(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))':
     dependencies:
@@ -8601,18 +8292,13 @@ snapshots:
 
   '@date-fns/tz@1.4.1': {}
 
-  '@emnapi/core@1.7.1':
+  '@emnapi/core@1.8.1':
     dependencies:
       '@emnapi/wasi-threads': 1.1.0
       tslib: 2.8.1
     optional: true
 
-  '@emnapi/runtime@1.5.0':
-    dependencies:
-      tslib: 2.8.1
-    optional: true
-
-  '@emnapi/runtime@1.7.1':
+  '@emnapi/runtime@1.8.1':
     dependencies:
       tslib: 2.8.1
     optional: true
@@ -8625,176 +8311,96 @@ snapshots:
   '@emotion/is-prop-valid@1.2.2':
     dependencies:
       '@emotion/memoize': 0.8.1
+    optional: true
 
-  '@emotion/memoize@0.8.1': {}
-
-  '@emotion/unitless@0.8.1': {}
+  '@emotion/memoize@0.8.1':
+    optional: true
 
   '@epic-web/invariant@1.0.0': {}
 
-  '@esbuild/aix-ppc64@0.25.11':
+  '@esbuild/aix-ppc64@0.25.12':
     optional: true
 
-  '@esbuild/aix-ppc64@0.25.9':
+  '@esbuild/android-arm64@0.25.12':
     optional: true
 
-  '@esbuild/android-arm64@0.25.11':
+  '@esbuild/android-arm@0.25.12':
     optional: true
 
-  '@esbuild/android-arm64@0.25.9':
+  '@esbuild/android-x64@0.25.12':
     optional: true
 
-  '@esbuild/android-arm@0.25.11':
+  '@esbuild/darwin-arm64@0.25.12':
     optional: true
 
-  '@esbuild/android-arm@0.25.9':
+  '@esbuild/darwin-x64@0.25.12':
     optional: true
 
-  '@esbuild/android-x64@0.25.11':
+  '@esbuild/freebsd-arm64@0.25.12':
     optional: true
 
-  '@esbuild/android-x64@0.25.9':
+  '@esbuild/freebsd-x64@0.25.12':
     optional: true
 
-  '@esbuild/darwin-arm64@0.25.11':
+  '@esbuild/linux-arm64@0.25.12':
     optional: true
 
-  '@esbuild/darwin-arm64@0.25.9':
+  '@esbuild/linux-arm@0.25.12':
     optional: true
 
-  '@esbuild/darwin-x64@0.25.11':
+  '@esbuild/linux-ia32@0.25.12':
     optional: true
 
-  '@esbuild/darwin-x64@0.25.9':
+  '@esbuild/linux-loong64@0.25.12':
     optional: true
 
-  '@esbuild/freebsd-arm64@0.25.11':
+  '@esbuild/linux-mips64el@0.25.12':
     optional: true
 
-  '@esbuild/freebsd-arm64@0.25.9':
+  '@esbuild/linux-ppc64@0.25.12':
     optional: true
 
-  '@esbuild/freebsd-x64@0.25.11':
+  '@esbuild/linux-riscv64@0.25.12':
     optional: true
 
-  '@esbuild/freebsd-x64@0.25.9':
+  '@esbuild/linux-s390x@0.25.12':
     optional: true
 
-  '@esbuild/linux-arm64@0.25.11':
+  '@esbuild/linux-x64@0.25.12':
     optional: true
 
-  '@esbuild/linux-arm64@0.25.9':
+  '@esbuild/netbsd-arm64@0.25.12':
     optional: true
 
-  '@esbuild/linux-arm@0.25.11':
+  '@esbuild/netbsd-x64@0.25.12':
     optional: true
 
-  '@esbuild/linux-arm@0.25.9':
+  '@esbuild/openbsd-arm64@0.25.12':
     optional: true
 
-  '@esbuild/linux-ia32@0.25.11':
+  '@esbuild/openbsd-x64@0.25.12':
     optional: true
 
-  '@esbuild/linux-ia32@0.25.9':
+  '@esbuild/openharmony-arm64@0.25.12':
     optional: true
 
-  '@esbuild/linux-loong64@0.25.11':
+  '@esbuild/sunos-x64@0.25.12':
     optional: true
 
-  '@esbuild/linux-loong64@0.25.9':
+  '@esbuild/win32-arm64@0.25.12':
     optional: true
 
-  '@esbuild/linux-mips64el@0.25.11':
+  '@esbuild/win32-ia32@0.25.12':
     optional: true
 
-  '@esbuild/linux-mips64el@0.25.9':
+  '@esbuild/win32-x64@0.25.12':
     optional: true
 
-  '@esbuild/linux-ppc64@0.25.11':
-    optional: true
-
-  '@esbuild/linux-ppc64@0.25.9':
-    optional: true
-
-  '@esbuild/linux-riscv64@0.25.11':
-    optional: true
-
-  '@esbuild/linux-riscv64@0.25.9':
-    optional: true
-
-  '@esbuild/linux-s390x@0.25.11':
-    optional: true
-
-  '@esbuild/linux-s390x@0.25.9':
-    optional: true
-
-  '@esbuild/linux-x64@0.25.11':
-    optional: true
-
-  '@esbuild/linux-x64@0.25.9':
-    optional: true
-
-  '@esbuild/netbsd-arm64@0.25.11':
-    optional: true
-
-  '@esbuild/netbsd-arm64@0.25.9':
-    optional: true
-
-  '@esbuild/netbsd-x64@0.25.11':
-    optional: true
-
-  '@esbuild/netbsd-x64@0.25.9':
-    optional: true
-
-  '@esbuild/openbsd-arm64@0.25.11':
-    optional: true
-
-  '@esbuild/openbsd-arm64@0.25.9':
-    optional: true
-
-  '@esbuild/openbsd-x64@0.25.11':
-    optional: true
-
-  '@esbuild/openbsd-x64@0.25.9':
-    optional: true
-
-  '@esbuild/openharmony-arm64@0.25.11':
-    optional: true
-
-  '@esbuild/openharmony-arm64@0.25.9':
-    optional: true
-
-  '@esbuild/sunos-x64@0.25.11':
-    optional: true
-
-  '@esbuild/sunos-x64@0.25.9':
-    optional: true
-
-  '@esbuild/win32-arm64@0.25.11':
-    optional: true
-
-  '@esbuild/win32-arm64@0.25.9':
-    optional: true
-
-  '@esbuild/win32-ia32@0.25.11':
-    optional: true
-
-  '@esbuild/win32-ia32@0.25.9':
-    optional: true
-
-  '@esbuild/win32-x64@0.25.11':
-    optional: true
-
-  '@esbuild/win32-x64@0.25.9':
-    optional: true
-
-  '@eslint-community/eslint-utils@4.9.0(eslint@8.57.1)':
+  '@eslint-community/eslint-utils@4.9.1(eslint@8.57.1)':
     dependencies:
       eslint: 8.57.1
       eslint-visitor-keys: 3.4.3
 
-  '@eslint-community/regexpp@4.12.1': {}
-
   '@eslint-community/regexpp@4.12.2': {}
 
   '@eslint/eslintrc@2.1.4':
@@ -8805,7 +8411,7 @@ snapshots:
       globals: 13.24.0
       ignore: 5.3.2
       import-fresh: 3.3.1
-      js-yaml: 4.1.0
+      js-yaml: 4.1.1
       minimatch: 3.1.2
       strip-json-comments: 3.1.1
     transitivePeerDependencies:
@@ -8821,25 +8427,25 @@ snapshots:
     dependencies:
       '@floating-ui/utils': 0.2.10
 
-  '@floating-ui/dom@1.7.3':
+  '@floating-ui/dom@1.7.4':
     dependencies:
       '@floating-ui/core': 1.7.3
       '@floating-ui/utils': 0.2.10
 
-  '@floating-ui/react-dom@2.1.5(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
+  '@floating-ui/react-dom@2.1.6(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
     dependencies:
-      '@floating-ui/dom': 1.7.3
+      '@floating-ui/dom': 1.7.4
       react: 18.3.1
       react-dom: 18.3.1(react@18.3.1)
 
   '@floating-ui/utils@0.2.10': {}
 
-  '@gerrit0/mini-shiki@3.14.0':
+  '@gerrit0/mini-shiki@3.20.0':
     dependencies:
-      '@shikijs/engine-oniguruma': 3.14.0
-      '@shikijs/langs': 3.14.0
-      '@shikijs/themes': 3.14.0
-      '@shikijs/types': 3.14.0
+      '@shikijs/engine-oniguruma': 3.21.0
+      '@shikijs/langs': 3.21.0
+      '@shikijs/themes': 3.21.0
+      '@shikijs/types': 3.21.0
       '@shikijs/vscode-textmate': 10.0.2
 
   '@hookform/resolvers@5.2.2(react-hook-form@7.66.0(react@18.3.1))':
@@ -8861,7 +8467,7 @@ snapshots:
 
   '@ibm-cloud/openapi-ruleset-utilities@1.9.0': {}
 
-  '@ibm-cloud/openapi-ruleset@1.33.3':
+  '@ibm-cloud/openapi-ruleset@1.33.5':
     dependencies:
       '@ibm-cloud/openapi-ruleset-utilities': 1.9.0
       '@stoplight/spectral-formats': 1.8.2
@@ -8874,110 +8480,121 @@ snapshots:
       loglevel: 1.9.2
       loglevel-plugin-prefix: 0.8.4
       minimatch: 6.2.0
-      validator: 13.15.20
+      validator: 13.15.26
     transitivePeerDependencies:
       - encoding
 
-  '@img/sharp-darwin-arm64@0.34.3':
+  '@img/colour@1.0.0':
+    optional: true
+
+  '@img/sharp-darwin-arm64@0.34.5':
     optionalDependencies:
-      '@img/sharp-libvips-darwin-arm64': 1.2.0
+      '@img/sharp-libvips-darwin-arm64': 1.2.4
     optional: true
 
-  '@img/sharp-darwin-x64@0.34.3':
+  '@img/sharp-darwin-x64@0.34.5':
     optionalDependencies:
-      '@img/sharp-libvips-darwin-x64': 1.2.0
+      '@img/sharp-libvips-darwin-x64': 1.2.4
     optional: true
 
-  '@img/sharp-libvips-darwin-arm64@1.2.0':
+  '@img/sharp-libvips-darwin-arm64@1.2.4':
     optional: true
 
-  '@img/sharp-libvips-darwin-x64@1.2.0':
+  '@img/sharp-libvips-darwin-x64@1.2.4':
     optional: true
 
-  '@img/sharp-libvips-linux-arm64@1.2.0':
+  '@img/sharp-libvips-linux-arm64@1.2.4':
     optional: true
 
-  '@img/sharp-libvips-linux-arm@1.2.0':
+  '@img/sharp-libvips-linux-arm@1.2.4':
     optional: true
 
-  '@img/sharp-libvips-linux-ppc64@1.2.0':
+  '@img/sharp-libvips-linux-ppc64@1.2.4':
     optional: true
 
-  '@img/sharp-libvips-linux-s390x@1.2.0':
+  '@img/sharp-libvips-linux-riscv64@1.2.4':
     optional: true
 
-  '@img/sharp-libvips-linux-x64@1.2.0':
+  '@img/sharp-libvips-linux-s390x@1.2.4':
     optional: true
 
-  '@img/sharp-libvips-linuxmusl-arm64@1.2.0':
+  '@img/sharp-libvips-linux-x64@1.2.4':
     optional: true
 
-  '@img/sharp-libvips-linuxmusl-x64@1.2.0':
+  '@img/sharp-libvips-linuxmusl-arm64@1.2.4':
     optional: true
 
-  '@img/sharp-linux-arm64@0.34.3':
+  '@img/sharp-libvips-linuxmusl-x64@1.2.4':
+    optional: true
+
+  '@img/sharp-linux-arm64@0.34.5':
     optionalDependencies:
-      '@img/sharp-libvips-linux-arm64': 1.2.0
+      '@img/sharp-libvips-linux-arm64': 1.2.4
     optional: true
 
-  '@img/sharp-linux-arm@0.34.3':
+  '@img/sharp-linux-arm@0.34.5':
     optionalDependencies:
-      '@img/sharp-libvips-linux-arm': 1.2.0
+      '@img/sharp-libvips-linux-arm': 1.2.4
     optional: true
 
-  '@img/sharp-linux-ppc64@0.34.3':
+  '@img/sharp-linux-ppc64@0.34.5':
     optionalDependencies:
-      '@img/sharp-libvips-linux-ppc64': 1.2.0
+      '@img/sharp-libvips-linux-ppc64': 1.2.4
     optional: true
 
-  '@img/sharp-linux-s390x@0.34.3':
+  '@img/sharp-linux-riscv64@0.34.5':
     optionalDependencies:
-      '@img/sharp-libvips-linux-s390x': 1.2.0
+      '@img/sharp-libvips-linux-riscv64': 1.2.4
     optional: true
 
-  '@img/sharp-linux-x64@0.34.3':
+  '@img/sharp-linux-s390x@0.34.5':
     optionalDependencies:
-      '@img/sharp-libvips-linux-x64': 1.2.0
+      '@img/sharp-libvips-linux-s390x': 1.2.4
     optional: true
 
-  '@img/sharp-linuxmusl-arm64@0.34.3':
+  '@img/sharp-linux-x64@0.34.5':
     optionalDependencies:
-      '@img/sharp-libvips-linuxmusl-arm64': 1.2.0
+      '@img/sharp-libvips-linux-x64': 1.2.4
     optional: true
 
-  '@img/sharp-linuxmusl-x64@0.34.3':
+  '@img/sharp-linuxmusl-arm64@0.34.5':
     optionalDependencies:
-      '@img/sharp-libvips-linuxmusl-x64': 1.2.0
+      '@img/sharp-libvips-linuxmusl-arm64': 1.2.4
     optional: true
 
-  '@img/sharp-wasm32@0.34.3':
+  '@img/sharp-linuxmusl-x64@0.34.5':
+    optionalDependencies:
+      '@img/sharp-libvips-linuxmusl-x64': 1.2.4
+    optional: true
+
+  '@img/sharp-wasm32@0.34.5':
     dependencies:
-      '@emnapi/runtime': 1.5.0
+      '@emnapi/runtime': 1.8.1
     optional: true
 
-  '@img/sharp-win32-arm64@0.34.3':
+  '@img/sharp-win32-arm64@0.34.5':
     optional: true
 
-  '@img/sharp-win32-ia32@0.34.3':
+  '@img/sharp-win32-ia32@0.34.5':
     optional: true
 
-  '@img/sharp-win32-x64@0.34.3':
+  '@img/sharp-win32-x64@0.34.5':
     optional: true
 
-  '@inquirer/ansi@1.0.1': {}
+  '@inquirer/ansi@1.0.2': {}
 
-  '@inquirer/confirm@5.1.19(@types/node@24.10.0)':
+  '@inquirer/confirm@5.1.21(@types/node@24.10.0)':
     dependencies:
-      '@inquirer/core': 10.3.0(@types/node@24.10.0)
-      '@inquirer/type': 3.0.9(@types/node@24.10.0)
+      '@inquirer/core': 10.3.2(@types/node@24.10.0)
+      '@inquirer/type': 3.0.10(@types/node@24.10.0)
     optionalDependencies:
       '@types/node': 24.10.0
 
-  '@inquirer/core@10.3.0(@types/node@24.10.0)':
+  '@inquirer/core@10.3.2(@types/node@24.10.0)':
     dependencies:
-      '@inquirer/ansi': 1.0.1
-      '@inquirer/figures': 1.0.14
-      '@inquirer/type': 3.0.9(@types/node@24.10.0)
+      '@inquirer/ansi': 1.0.2
+      '@inquirer/figures': 1.0.15
+      '@inquirer/type': 3.0.10(@types/node@24.10.0)
       cli-width: 4.1.0
       mute-stream: 2.0.0
       signal-exit: 4.1.0
@@ -8986,9 +8603,9 @@ snapshots:
     optionalDependencies:
       '@types/node': 24.10.0
 
-  '@inquirer/figures@1.0.14': {}
+  '@inquirer/figures@1.0.15': {}
 
-  '@inquirer/type@3.0.9(@types/node@24.10.0)':
+  '@inquirer/type@3.0.10(@types/node@24.10.0)':
     optionalDependencies:
       '@types/node': 24.10.0
 
@@ -9004,23 +8621,23 @@ snapshots:
   '@jridgewell/gen-mapping@0.3.13':
     dependencies:
       '@jridgewell/sourcemap-codec': 1.5.5
-      '@jridgewell/trace-mapping': 0.3.30
+      '@jridgewell/trace-mapping': 0.3.31
 
   '@jridgewell/remapping@2.3.5':
     dependencies:
       '@jridgewell/gen-mapping': 0.3.13
-      '@jridgewell/trace-mapping': 0.3.30
+      '@jridgewell/trace-mapping': 0.3.31
 
   '@jridgewell/resolve-uri@3.1.2': {}
 
   '@jridgewell/source-map@0.3.11':
     dependencies:
       '@jridgewell/gen-mapping': 0.3.13
-      '@jridgewell/trace-mapping': 0.3.30
+      '@jridgewell/trace-mapping': 0.3.31
 
   '@jridgewell/sourcemap-codec@1.5.5': {}
 
-  '@jridgewell/trace-mapping@0.3.30':
+  '@jridgewell/trace-mapping@0.3.31':
     dependencies:
       '@jridgewell/resolve-uri': 3.1.2
       '@jridgewell/sourcemap-codec': 1.5.5
@@ -9054,8 +8671,8 @@ snapshots:
 
   '@napi-rs/wasm-runtime@0.2.12':
     dependencies:
-      '@emnapi/core': 1.7.1
-      '@emnapi/runtime': 1.7.1
+      '@emnapi/core': 1.8.1
+      '@emnapi/runtime': 1.8.1
       '@tybys/wasm-util': 0.10.1
     optional: true
 
@@ -9091,9 +8708,9 @@ snapshots:
   '@next/swc-win32-x64-msvc@15.4.8':
     optional: true
 
-  '@next/third-parties@15.4.6(next@15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react@18.3.1)':
+  '@next/third-parties@15.4.6(next@15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react@18.3.1)':
     dependencies:
-      next: 15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      next: 15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       react: 18.3.1
       third-party-capital: 1.0.20
 
@@ -9107,7 +8724,7 @@ snapshots:
   '@nodelib/fs.walk@1.2.8':
     dependencies:
       '@nodelib/fs.scandir': 2.1.5
-      fastq: 1.19.1
+      fastq: 1.20.1
 
   '@nolyfill/is-core-module@1.0.39': {}
 
@@ -9120,7 +8737,7 @@ snapshots:
 
   '@open-draft/until@2.1.0': {}
 
-  '@opentelemetry/api-logs@0.208.0':
+  '@opentelemetry/api-logs@0.209.0':
     dependencies:
       '@opentelemetry/api': 1.9.0
 
@@ -9133,13 +8750,13 @@ snapshots:
   '@opentelemetry/core@2.2.0(@opentelemetry/api@1.9.0)':
     dependencies:
       '@opentelemetry/api': 1.9.0
-      '@opentelemetry/semantic-conventions': 1.37.0
+      '@opentelemetry/semantic-conventions': 1.38.0
 
   '@opentelemetry/instrumentation-amqplib@0.55.0(@opentelemetry/api@1.9.0)':
     dependencies:
       '@opentelemetry/api': 1.9.0
       '@opentelemetry/core': 2.2.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
     transitivePeerDependencies:
       - supports-color
 
@@ -9147,8 +8764,8 @@ snapshots:
     dependencies:
       '@opentelemetry/api': 1.9.0
       '@opentelemetry/core': 2.2.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/semantic-conventions': 1.37.0
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/semantic-conventions': 1.38.0
       '@types/connect': 3.4.38
     transitivePeerDependencies:
       - supports-color
@@ -9156,7 +8773,7 @@ snapshots:
   '@opentelemetry/instrumentation-dataloader@0.26.0(@opentelemetry/api@1.9.0)':
     dependencies:
       '@opentelemetry/api': 1.9.0
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
     transitivePeerDependencies:
       - supports-color
 
@@ -9164,8 +8781,8 @@ snapshots:
     dependencies:
       '@opentelemetry/api': 1.9.0
       '@opentelemetry/core': 2.2.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/semantic-conventions': 1.37.0
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/semantic-conventions': 1.38.0
     transitivePeerDependencies:
       - supports-color
 
@@ -9173,21 +8790,21 @@ snapshots:
     dependencies:
       '@opentelemetry/api': 1.9.0
       '@opentelemetry/core': 2.2.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
     transitivePeerDependencies:
       - supports-color
 
   '@opentelemetry/instrumentation-generic-pool@0.52.0(@opentelemetry/api@1.9.0)':
     dependencies:
       '@opentelemetry/api': 1.9.0
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
     transitivePeerDependencies:
       - supports-color
 
   '@opentelemetry/instrumentation-graphql@0.56.0(@opentelemetry/api@1.9.0)':
     dependencies:
       '@opentelemetry/api': 1.9.0
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
     transitivePeerDependencies:
       - supports-color
 
@@ -9195,8 +8812,8 @@ snapshots:
     dependencies:
       '@opentelemetry/api': 1.9.0
       '@opentelemetry/core': 2.2.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/semantic-conventions': 1.37.0
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/semantic-conventions': 1.38.0
     transitivePeerDependencies:
       - supports-color
 
@@ -9204,8 +8821,8 @@ snapshots:
     dependencies:
       '@opentelemetry/api': 1.9.0
       '@opentelemetry/core': 2.2.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/semantic-conventions': 1.37.0
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/semantic-conventions': 1.38.0
       forwarded-parse: 2.1.2
     transitivePeerDependencies:
       - supports-color
@@ -9213,7 +8830,7 @@ snapshots:
   '@opentelemetry/instrumentation-ioredis@0.56.0(@opentelemetry/api@1.9.0)':
     dependencies:
       '@opentelemetry/api': 1.9.0
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
       '@opentelemetry/redis-common': 0.38.2
     transitivePeerDependencies:
       - supports-color
@@ -9221,16 +8838,16 @@ snapshots:
   '@opentelemetry/instrumentation-kafkajs@0.18.0(@opentelemetry/api@1.9.0)':
     dependencies:
       '@opentelemetry/api': 1.9.0
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/semantic-conventions': 1.37.0
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/semantic-conventions': 1.38.0
     transitivePeerDependencies:
       - supports-color
 
   '@opentelemetry/instrumentation-knex@0.53.0(@opentelemetry/api@1.9.0)':
     dependencies:
       '@opentelemetry/api': 1.9.0
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/semantic-conventions': 1.37.0
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/semantic-conventions': 1.38.0
     transitivePeerDependencies:
       - supports-color
 
@@ -9238,22 +8855,22 @@ snapshots:
     dependencies:
       '@opentelemetry/api': 1.9.0
       '@opentelemetry/core': 2.2.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/semantic-conventions': 1.37.0
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/semantic-conventions': 1.38.0
     transitivePeerDependencies:
       - supports-color
 
   '@opentelemetry/instrumentation-lru-memoizer@0.53.0(@opentelemetry/api@1.9.0)':
     dependencies:
       '@opentelemetry/api': 1.9.0
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
     transitivePeerDependencies:
       - supports-color
 
   '@opentelemetry/instrumentation-mongodb@0.61.0(@opentelemetry/api@1.9.0)':
     dependencies:
       '@opentelemetry/api': 1.9.0
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
     transitivePeerDependencies:
       - supports-color
 
@@ -9261,15 +8878,15 @@ snapshots:
     dependencies:
       '@opentelemetry/api': 1.9.0
       '@opentelemetry/core': 2.2.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
     transitivePeerDependencies:
       - supports-color
 
   '@opentelemetry/instrumentation-mysql2@0.55.0(@opentelemetry/api@1.9.0)':
     dependencies:
       '@opentelemetry/api': 1.9.0
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/semantic-conventions': 1.37.0
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/semantic-conventions': 1.38.0
       '@opentelemetry/sql-common': 0.41.2(@opentelemetry/api@1.9.0)
     transitivePeerDependencies:
       - supports-color
@@ -9277,7 +8894,7 @@ snapshots:
   '@opentelemetry/instrumentation-mysql@0.54.0(@opentelemetry/api@1.9.0)':
     dependencies:
       '@opentelemetry/api': 1.9.0
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
       '@types/mysql': 2.15.27
     transitivePeerDependencies:
       - supports-color
@@ -9286,8 +8903,8 @@ snapshots:
     dependencies:
       '@opentelemetry/api': 1.9.0
       '@opentelemetry/core': 2.2.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/semantic-conventions': 1.37.0
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/semantic-conventions': 1.38.0
       '@opentelemetry/sql-common': 0.41.2(@opentelemetry/api@1.9.0)
       '@types/pg': 8.15.6
       '@types/pg-pool': 2.0.6
@@ -9297,16 +8914,16 @@ snapshots:
   '@opentelemetry/instrumentation-redis@0.57.0(@opentelemetry/api@1.9.0)':
     dependencies:
       '@opentelemetry/api': 1.9.0
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
       '@opentelemetry/redis-common': 0.38.2
-      '@opentelemetry/semantic-conventions': 1.37.0
+      '@opentelemetry/semantic-conventions': 1.38.0
     transitivePeerDependencies:
       - supports-color
 
   '@opentelemetry/instrumentation-tedious@0.27.0(@opentelemetry/api@1.9.0)':
     dependencies:
       '@opentelemetry/api': 1.9.0
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
       '@types/tedious': 4.0.14
     transitivePeerDependencies:
       - supports-color
@@ -9315,16 +8932,16 @@ snapshots:
     dependencies:
       '@opentelemetry/api': 1.9.0
       '@opentelemetry/core': 2.2.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/semantic-conventions': 1.37.0
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/semantic-conventions': 1.38.0
     transitivePeerDependencies:
       - supports-color
 
-  '@opentelemetry/instrumentation@0.208.0(@opentelemetry/api@1.9.0)':
+  '@opentelemetry/instrumentation@0.209.0(@opentelemetry/api@1.9.0)':
     dependencies:
       '@opentelemetry/api': 1.9.0
-      '@opentelemetry/api-logs': 0.208.0
-      import-in-the-middle: 2.0.0
+      '@opentelemetry/api-logs': 0.209.0
+      import-in-the-middle: 2.0.2
       require-in-the-middle: 8.0.1
     transitivePeerDependencies:
       - supports-color
@@ -9335,16 +8952,16 @@ snapshots:
     dependencies:
       '@opentelemetry/api': 1.9.0
       '@opentelemetry/core': 2.2.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/semantic-conventions': 1.37.0
+      '@opentelemetry/semantic-conventions': 1.38.0
 
   '@opentelemetry/sdk-trace-base@2.2.0(@opentelemetry/api@1.9.0)':
     dependencies:
       '@opentelemetry/api': 1.9.0
       '@opentelemetry/core': 2.2.0(@opentelemetry/api@1.9.0)
       '@opentelemetry/resources': 2.2.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/semantic-conventions': 1.37.0
+      '@opentelemetry/semantic-conventions': 1.38.0
 
-  '@opentelemetry/semantic-conventions@1.37.0': {}
+  '@opentelemetry/semantic-conventions@1.38.0': {}
 
   '@opentelemetry/sql-common@0.41.2(@opentelemetry/api@1.9.0)':
     dependencies:
@@ -9372,15 +8989,15 @@ snapshots:
   '@orval/core@7.13.0(openapi-types@12.1.3)(typescript@5.9.3)':
     dependencies:
       '@apidevtools/swagger-parser': 12.1.0(openapi-types@12.1.3)
-      '@ibm-cloud/openapi-ruleset': 1.33.3
+      '@ibm-cloud/openapi-ruleset': 1.33.5
       '@stoplight/spectral-core': 1.20.0
       acorn: 8.15.0
       chalk: 4.1.2
       compare-versions: 6.1.1
       debug: 4.4.3
-      esbuild: 0.25.11
+      esbuild: 0.25.12
       esutils: 2.0.3
-      fs-extra: 11.3.2
+      fs-extra: 11.3.3
       globby: 11.1.0
       lodash.isempty: 4.4.0
       lodash.uniq: 4.5.0
@@ -9389,7 +9006,7 @@ snapshots:
       micromatch: 4.0.8
       openapi3-ts: 4.5.0
       swagger2openapi: 7.0.8
-      typedoc: 0.28.14(typescript@5.9.3)
+      typedoc: 0.28.15(typescript@5.9.3)
     transitivePeerDependencies:
       - encoding
       - openapi-types
@@ -9410,7 +9027,7 @@ snapshots:
     dependencies:
       '@orval/core': 7.13.0(openapi-types@12.1.3)(typescript@5.9.3)
       '@orval/zod': 7.13.0(openapi-types@12.1.3)(typescript@5.9.3)
-      fs-extra: 11.3.2
+      fs-extra: 11.3.3
       lodash.uniq: 4.5.0
       openapi3-ts: 4.5.0
     transitivePeerDependencies:
@@ -9486,17 +9103,17 @@ snapshots:
     dependencies:
       playwright: 1.56.1
 
-  '@pmmmwh/react-refresh-webpack-plugin@0.5.17(react-refresh@0.14.2)(type-fest@4.41.0)(webpack-hot-middleware@2.26.1)(webpack@5.101.3(esbuild@0.25.9))':
+  '@pmmmwh/react-refresh-webpack-plugin@0.5.17(react-refresh@0.14.2)(type-fest@4.41.0)(webpack-hot-middleware@2.26.1)(webpack@5.104.1(esbuild@0.25.12))':
     dependencies:
       ansi-html: 0.0.9
-      core-js-pure: 3.45.1
+      core-js-pure: 3.47.0
       error-stack-parser: 2.1.4
       html-entities: 2.6.0
       loader-utils: 2.0.4
       react-refresh: 0.14.2
-      schema-utils: 4.3.2
+      schema-utils: 4.3.3
       source-map: 0.7.6
-      webpack: 5.101.3(esbuild@0.25.9)
+      webpack: 5.104.1(esbuild@0.25.12)
     optionalDependencies:
       type-fest: 4.41.0
       webpack-hot-middleware: 2.26.1
@@ -9504,7 +9121,7 @@ snapshots:
   '@prisma/instrumentation@6.19.0(@opentelemetry/api@1.9.0)':
     dependencies:
       '@opentelemetry/api': 1.9.0
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
     transitivePeerDependencies:
       - supports-color
 
@@ -9512,6 +9129,23 @@ snapshots:
 
   '@radix-ui/primitive@1.1.3': {}
 
+  '@radix-ui/react-accordion@1.2.12(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
+    dependencies:
+      '@radix-ui/primitive': 1.1.3
+      '@radix-ui/react-collapsible': 1.1.12(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@radix-ui/react-collection': 1.1.7(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@radix-ui/react-compose-refs': 1.1.2(@types/react@18.3.17)(react@18.3.1)
+      '@radix-ui/react-context': 1.1.2(@types/react@18.3.17)(react@18.3.1)
+      '@radix-ui/react-direction': 1.1.1(@types/react@18.3.17)(react@18.3.1)
+      '@radix-ui/react-id': 1.1.1(@types/react@18.3.17)(react@18.3.1)
+      '@radix-ui/react-primitive': 2.1.3(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@radix-ui/react-use-controllable-state': 1.2.2(@types/react@18.3.17)(react@18.3.1)
+      react: 18.3.1
+      react-dom: 18.3.1(react@18.3.1)
+    optionalDependencies:
+      '@types/react': 18.3.17
+      '@types/react-dom': 18.3.5(@types/react@18.3.17)
+
   '@radix-ui/react-alert-dialog@1.1.15(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
     dependencies:
       '@radix-ui/primitive': 1.1.3
@@ -9635,7 +9269,7 @@ snapshots:
       aria-hidden: 1.2.6
       react: 18.3.1
       react-dom: 18.3.1(react@18.3.1)
-      react-remove-scroll: 2.7.1(@types/react@18.3.17)(react@18.3.1)
+      react-remove-scroll: 2.7.2(@types/react@18.3.17)(react@18.3.1)
     optionalDependencies:
       '@types/react': 18.3.17
       '@types/react-dom': 18.3.5(@types/react@18.3.17)
@@ -9732,7 +9366,7 @@ snapshots:
       aria-hidden: 1.2.6
       react: 18.3.1
       react-dom: 18.3.1(react@18.3.1)
-      react-remove-scroll: 2.7.1(@types/react@18.3.17)(react@18.3.1)
+      react-remove-scroll: 2.7.2(@types/react@18.3.17)(react@18.3.1)
     optionalDependencies:
       '@types/react': 18.3.17
       '@types/react-dom': 18.3.5(@types/react@18.3.17)
@@ -9755,14 +9389,14 @@ snapshots:
       aria-hidden: 1.2.6
       react: 18.3.1
       react-dom: 18.3.1(react@18.3.1)
-      react-remove-scroll: 2.7.1(@types/react@18.3.17)(react@18.3.1)
+      react-remove-scroll: 2.7.2(@types/react@18.3.17)(react@18.3.1)
     optionalDependencies:
       '@types/react': 18.3.17
       '@types/react-dom': 18.3.5(@types/react@18.3.17)
 
   '@radix-ui/react-popper@1.2.8(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
     dependencies:
-      '@floating-ui/react-dom': 2.1.5(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@floating-ui/react-dom': 2.1.6(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       '@radix-ui/react-arrow': 1.1.7(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       '@radix-ui/react-compose-refs': 1.1.2(@types/react@18.3.17)(react@18.3.1)
       '@radix-ui/react-context': 1.1.2(@types/react@18.3.17)(react@18.3.1)
@@ -9807,6 +9441,15 @@ snapshots:
       '@types/react': 18.3.17
       '@types/react-dom': 18.3.5(@types/react@18.3.17)
 
+  '@radix-ui/react-primitive@2.1.4(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
+    dependencies:
+      '@radix-ui/react-slot': 1.2.4(@types/react@18.3.17)(react@18.3.1)
+      react: 18.3.1
+      react-dom: 18.3.1(react@18.3.1)
+    optionalDependencies:
+      '@types/react': 18.3.17
+      '@types/react-dom': 18.3.5(@types/react@18.3.17)
+
   '@radix-ui/react-radio-group@1.3.8(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
     dependencies:
       '@radix-ui/primitive': 1.1.3
@@ -9883,7 +9526,7 @@ snapshots:
       aria-hidden: 1.2.6
       react: 18.3.1
       react-dom: 18.3.1(react@18.3.1)
-      react-remove-scroll: 2.7.1(@types/react@18.3.17)(react@18.3.1)
+      react-remove-scroll: 2.7.2(@types/react@18.3.17)(react@18.3.1)
     optionalDependencies:
       '@types/react': 18.3.17
       '@types/react-dom': 18.3.5(@types/react@18.3.17)
@@ -9897,6 +9540,25 @@ snapshots:
       '@types/react': 18.3.17
       '@types/react-dom': 18.3.5(@types/react@18.3.17)
 
+  '@radix-ui/react-slider@1.3.6(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
+    dependencies:
+      '@radix-ui/number': 1.1.1
+      '@radix-ui/primitive': 1.1.3
+      '@radix-ui/react-collection': 1.1.7(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@radix-ui/react-compose-refs': 1.1.2(@types/react@18.3.17)(react@18.3.1)
+      '@radix-ui/react-context': 1.1.2(@types/react@18.3.17)(react@18.3.1)
+      '@radix-ui/react-direction': 1.1.1(@types/react@18.3.17)(react@18.3.1)
+      '@radix-ui/react-primitive': 2.1.3(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@radix-ui/react-use-controllable-state': 1.2.2(@types/react@18.3.17)(react@18.3.1)
+      '@radix-ui/react-use-layout-effect': 1.1.1(@types/react@18.3.17)(react@18.3.1)
+      '@radix-ui/react-use-previous': 1.1.1(@types/react@18.3.17)(react@18.3.1)
+      '@radix-ui/react-use-size': 1.1.1(@types/react@18.3.17)(react@18.3.1)
+      react: 18.3.1
+      react-dom: 18.3.1(react@18.3.1)
+    optionalDependencies:
+      '@types/react': 18.3.17
+      '@types/react-dom': 18.3.5(@types/react@18.3.17)
+
   '@radix-ui/react-slot@1.2.3(@types/react@18.3.17)(react@18.3.1)':
     dependencies:
       '@radix-ui/react-compose-refs': 1.1.2(@types/react@18.3.17)(react@18.3.1)
@@ -9904,6 +9566,13 @@ snapshots:
     optionalDependencies:
       '@types/react': 18.3.17
 
+  '@radix-ui/react-slot@1.2.4(@types/react@18.3.17)(react@18.3.1)':
+    dependencies:
+      '@radix-ui/react-compose-refs': 1.1.2(@types/react@18.3.17)(react@18.3.1)
+      react: 18.3.1
+    optionalDependencies:
+      '@types/react': 18.3.17
+
   '@radix-ui/react-switch@1.2.6(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
     dependencies:
       '@radix-ui/primitive': 1.1.3
@@ -10006,7 +9675,7 @@ snapshots:
   '@radix-ui/react-use-is-hydrated@0.1.0(@types/react@18.3.17)(react@18.3.1)':
     dependencies:
       react: 18.3.1
-      use-sync-external-store: 1.5.0(react@18.3.1)
+      use-sync-external-store: 1.6.0(react@18.3.1)
     optionalDependencies:
       '@types/react': 18.3.17
 
@@ -10047,11 +9716,11 @@ snapshots:
 
   '@radix-ui/rect@1.1.1': {}
 
-  '@reduxjs/toolkit@2.9.0(react-redux@9.2.0(@types/react@18.3.17)(react@18.3.1)(redux@5.0.1))(react@18.3.1)':
+  '@reduxjs/toolkit@2.11.2(react-redux@9.2.0(@types/react@18.3.17)(react@18.3.1)(redux@5.0.1))(react@18.3.1)':
     dependencies:
-      '@standard-schema/spec': 1.0.0
+      '@standard-schema/spec': 1.1.0
       '@standard-schema/utils': 0.3.0
-      immer: 10.1.3
+      immer: 11.1.3
       redux: 5.0.1
       redux-thunk: 3.1.0(redux@5.0.1)
       reselect: 5.1.1
@@ -10059,116 +9728,126 @@ snapshots:
       react: 18.3.1
       react-redux: 9.2.0(@types/react@18.3.17)(react@18.3.1)(redux@5.0.1)
 
-  '@rjsf/core@5.24.13(@rjsf/utils@5.24.13(react@18.3.1))(react@18.3.1)':
+  '@rjsf/core@6.1.2(@rjsf/utils@6.1.2(react@18.3.1))(react@18.3.1)':
     dependencies:
-      '@rjsf/utils': 5.24.13(react@18.3.1)
+      '@rjsf/utils': 6.1.2(react@18.3.1)
       lodash: 4.17.21
-      lodash-es: 4.17.21
-      markdown-to-jsx: 7.7.13(react@18.3.1)
+      lodash-es: 4.17.22
+      markdown-to-jsx: 8.0.0(react@18.3.1)
       prop-types: 15.8.1
       react: 18.3.1
 
-  '@rjsf/utils@5.24.13(react@18.3.1)':
+  '@rjsf/utils@6.1.2(react@18.3.1)':
     dependencies:
-      json-schema-merge-allof: 0.8.1
+      '@x0k/json-schema-merge': 1.0.2
+      fast-uri: 3.1.0
       jsonpointer: 5.0.1
       lodash: 4.17.21
-      lodash-es: 4.17.21
+      lodash-es: 4.17.22
       react: 18.3.1
       react-is: 18.3.1
 
-  '@rjsf/validator-ajv8@5.24.13(@rjsf/utils@5.24.13(react@18.3.1))':
+  '@rjsf/validator-ajv8@6.1.2(@rjsf/utils@6.1.2(react@18.3.1))':
     dependencies:
-      '@rjsf/utils': 5.24.13(react@18.3.1)
+      '@rjsf/utils': 6.1.2(react@18.3.1)
       ajv: 8.17.1
       ajv-formats: 2.1.1(ajv@8.17.1)
       lodash: 4.17.21
-      lodash-es: 4.17.21
+      lodash-es: 4.17.22
 
-  '@rollup/plugin-commonjs@28.0.1(rollup@4.52.2)':
+  '@rollup/plugin-commonjs@28.0.1(rollup@4.55.1)':
     dependencies:
-      '@rollup/pluginutils': 5.3.0(rollup@4.52.2)
+      '@rollup/pluginutils': 5.3.0(rollup@4.55.1)
       commondir: 1.0.1
       estree-walker: 2.0.2
       fdir: 6.5.0(picomatch@4.0.3)
       is-reference: 1.2.1
-      magic-string: 0.30.19
+      magic-string: 0.30.21
       picomatch: 4.0.3
     optionalDependencies:
-      rollup: 4.52.2
+      rollup: 4.55.1
 
-  '@rollup/pluginutils@5.3.0(rollup@4.52.2)':
+  '@rollup/pluginutils@5.3.0(rollup@4.55.1)':
     dependencies:
       '@types/estree': 1.0.8
       estree-walker: 2.0.2
       picomatch: 4.0.3
     optionalDependencies:
-      rollup: 4.52.2
+      rollup: 4.55.1
 
-  '@rollup/rollup-android-arm-eabi@4.52.2':
+  '@rollup/rollup-android-arm-eabi@4.55.1':
     optional: true
 
-  '@rollup/rollup-android-arm64@4.52.2':
+  '@rollup/rollup-android-arm64@4.55.1':
     optional: true
 
-  '@rollup/rollup-darwin-arm64@4.52.2':
+  '@rollup/rollup-darwin-arm64@4.55.1':
     optional: true
 
-  '@rollup/rollup-darwin-x64@4.52.2':
+  '@rollup/rollup-darwin-x64@4.55.1':
     optional: true
 
-  '@rollup/rollup-freebsd-arm64@4.52.2':
+  '@rollup/rollup-freebsd-arm64@4.55.1':
     optional: true
 
-  '@rollup/rollup-freebsd-x64@4.52.2':
+  '@rollup/rollup-freebsd-x64@4.55.1':
     optional: true
 
-  '@rollup/rollup-linux-arm-gnueabihf@4.52.2':
+  '@rollup/rollup-linux-arm-gnueabihf@4.55.1':
     optional: true
 
-  '@rollup/rollup-linux-arm-musleabihf@4.52.2':
+  '@rollup/rollup-linux-arm-musleabihf@4.55.1':
     optional: true
 
-  '@rollup/rollup-linux-arm64-gnu@4.52.2':
+  '@rollup/rollup-linux-arm64-gnu@4.55.1':
     optional: true
 
-  '@rollup/rollup-linux-arm64-musl@4.52.2':
+  '@rollup/rollup-linux-arm64-musl@4.55.1':
     optional: true
 
-  '@rollup/rollup-linux-loong64-gnu@4.52.2':
+  '@rollup/rollup-linux-loong64-gnu@4.55.1':
     optional: true
 
-  '@rollup/rollup-linux-ppc64-gnu@4.52.2':
+  '@rollup/rollup-linux-loong64-musl@4.55.1':
     optional: true
 
-  '@rollup/rollup-linux-riscv64-gnu@4.52.2':
+  '@rollup/rollup-linux-ppc64-gnu@4.55.1':
     optional: true
 
-  '@rollup/rollup-linux-riscv64-musl@4.52.2':
+  '@rollup/rollup-linux-ppc64-musl@4.55.1':
     optional: true
 
-  '@rollup/rollup-linux-s390x-gnu@4.52.2':
+  '@rollup/rollup-linux-riscv64-gnu@4.55.1':
     optional: true
 
-  '@rollup/rollup-linux-x64-gnu@4.52.2':
+  '@rollup/rollup-linux-riscv64-musl@4.55.1':
     optional: true
 
-  '@rollup/rollup-linux-x64-musl@4.52.2':
+  '@rollup/rollup-linux-s390x-gnu@4.55.1':
     optional: true
 
-  '@rollup/rollup-openharmony-arm64@4.52.2':
+  '@rollup/rollup-linux-x64-gnu@4.55.1':
     optional: true
 
-  '@rollup/rollup-win32-arm64-msvc@4.52.2':
+  '@rollup/rollup-linux-x64-musl@4.55.1':
     optional: true
 
-  '@rollup/rollup-win32-ia32-msvc@4.52.2':
+  '@rollup/rollup-openbsd-x64@4.55.1':
     optional: true
 
-  '@rollup/rollup-win32-x64-gnu@4.52.2':
+  '@rollup/rollup-openharmony-arm64@4.55.1':
     optional: true
 
-  '@rollup/rollup-win32-x64-msvc@4.52.2':
+  '@rollup/rollup-win32-arm64-msvc@4.55.1':
+    optional: true
+
+  '@rollup/rollup-win32-ia32-msvc@4.55.1':
+    optional: true
+
+  '@rollup/rollup-win32-x64-gnu@4.55.1':
+    optional: true
+
+  '@rollup/rollup-win32-x64-msvc@4.55.1':
     optional: true
 
   '@rtsao/scc@1.1.0': {}
@@ -10195,8 +9874,6 @@ snapshots:
       '@sentry-internal/browser-utils': 10.27.0
       '@sentry/core': 10.27.0
 
-  '@sentry/babel-plugin-component-annotate@4.3.0': {}
-
   '@sentry/babel-plugin-component-annotate@4.6.1': {}
 
   '@sentry/browser@10.27.0':
@@ -10207,25 +9884,11 @@ snapshots:
       '@sentry-internal/replay-canvas': 10.27.0
       '@sentry/core': 10.27.0
 
-  '@sentry/bundler-plugin-core@4.3.0':
-    dependencies:
-      '@babel/core': 7.28.4
-      '@sentry/babel-plugin-component-annotate': 4.3.0
-      '@sentry/cli': 2.55.0
-      dotenv: 16.6.1
-      find-up: 5.0.0
-      glob: 9.3.5
-      magic-string: 0.30.8
-      unplugin: 1.0.1
-    transitivePeerDependencies:
-      - encoding
-      - supports-color
-
   '@sentry/bundler-plugin-core@4.6.1':
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       '@sentry/babel-plugin-component-annotate': 4.6.1
-      '@sentry/cli': 2.58.2
+      '@sentry/cli': 2.58.4
       dotenv: 16.6.1
       find-up: 5.0.0
       glob: 10.5.0
@@ -10235,55 +9898,31 @@ snapshots:
       - encoding
       - supports-color
 
-  '@sentry/cli-darwin@2.55.0':
+  '@sentry/cli-darwin@2.58.4':
     optional: true
 
-  '@sentry/cli-darwin@2.58.2':
+  '@sentry/cli-linux-arm64@2.58.4':
     optional: true
 
-  '@sentry/cli-linux-arm64@2.55.0':
+  '@sentry/cli-linux-arm@2.58.4':
     optional: true
 
-  '@sentry/cli-linux-arm64@2.58.2':
+  '@sentry/cli-linux-i686@2.58.4':
     optional: true
 
-  '@sentry/cli-linux-arm@2.55.0':
+  '@sentry/cli-linux-x64@2.58.4':
     optional: true
 
-  '@sentry/cli-linux-arm@2.58.2':
+  '@sentry/cli-win32-arm64@2.58.4':
     optional: true
 
-  '@sentry/cli-linux-i686@2.55.0':
+  '@sentry/cli-win32-i686@2.58.4':
     optional: true
 
-  '@sentry/cli-linux-i686@2.58.2':
+  '@sentry/cli-win32-x64@2.58.4':
     optional: true
 
-  '@sentry/cli-linux-x64@2.55.0':
-    optional: true
-
-  '@sentry/cli-linux-x64@2.58.2':
-    optional: true
-
-  '@sentry/cli-win32-arm64@2.55.0':
-    optional: true
-
-  '@sentry/cli-win32-arm64@2.58.2':
-    optional: true
-
-  '@sentry/cli-win32-i686@2.55.0':
-    optional: true
-
-  '@sentry/cli-win32-i686@2.58.2':
-    optional: true
-
-  '@sentry/cli-win32-x64@2.55.0':
-    optional: true
-
-  '@sentry/cli-win32-x64@2.58.2':
-    optional: true
-
-  '@sentry/cli@2.55.0':
+  '@sentry/cli@2.58.4':
     dependencies:
       https-proxy-agent: 5.0.1
       node-fetch: 2.7.0
@@ -10291,56 +9930,36 @@ snapshots:
       proxy-from-env: 1.1.0
       which: 2.0.2
     optionalDependencies:
-      '@sentry/cli-darwin': 2.55.0
-      '@sentry/cli-linux-arm': 2.55.0
-      '@sentry/cli-linux-arm64': 2.55.0
-      '@sentry/cli-linux-i686': 2.55.0
-      '@sentry/cli-linux-x64': 2.55.0
-      '@sentry/cli-win32-arm64': 2.55.0
-      '@sentry/cli-win32-i686': 2.55.0
-      '@sentry/cli-win32-x64': 2.55.0
-    transitivePeerDependencies:
-      - encoding
-      - supports-color
-
-  '@sentry/cli@2.58.2':
-    dependencies:
-      https-proxy-agent: 5.0.1
-      node-fetch: 2.7.0
-      progress: 2.0.3
-      proxy-from-env: 1.1.0
-      which: 2.0.2
-    optionalDependencies:
-      '@sentry/cli-darwin': 2.58.2
-      '@sentry/cli-linux-arm': 2.58.2
-      '@sentry/cli-linux-arm64': 2.58.2
-      '@sentry/cli-linux-i686': 2.58.2
-      '@sentry/cli-linux-x64': 2.58.2
-      '@sentry/cli-win32-arm64': 2.58.2
-      '@sentry/cli-win32-i686': 2.58.2
-      '@sentry/cli-win32-x64': 2.58.2
+      '@sentry/cli-darwin': 2.58.4
+      '@sentry/cli-linux-arm': 2.58.4
+      '@sentry/cli-linux-arm64': 2.58.4
+      '@sentry/cli-linux-i686': 2.58.4
+      '@sentry/cli-linux-x64': 2.58.4
+      '@sentry/cli-win32-arm64': 2.58.4
+      '@sentry/cli-win32-i686': 2.58.4
+      '@sentry/cli-win32-x64': 2.58.4
     transitivePeerDependencies:
       - encoding
       - supports-color
 
   '@sentry/core@10.27.0': {}
 
-  '@sentry/nextjs@10.27.0(@opentelemetry/context-async-hooks@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/core@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/sdk-trace-base@2.2.0(@opentelemetry/api@1.9.0))(next@15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react@18.3.1)(webpack@5.101.3(esbuild@0.25.9))':
+  '@sentry/nextjs@10.27.0(@opentelemetry/context-async-hooks@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/core@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/sdk-trace-base@2.2.0(@opentelemetry/api@1.9.0))(next@15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react@18.3.1)(webpack@5.104.1(esbuild@0.25.12))':
     dependencies:
       '@opentelemetry/api': 1.9.0
-      '@opentelemetry/semantic-conventions': 1.37.0
-      '@rollup/plugin-commonjs': 28.0.1(rollup@4.52.2)
+      '@opentelemetry/semantic-conventions': 1.38.0
+      '@rollup/plugin-commonjs': 28.0.1(rollup@4.55.1)
       '@sentry-internal/browser-utils': 10.27.0
       '@sentry/bundler-plugin-core': 4.6.1
       '@sentry/core': 10.27.0
       '@sentry/node': 10.27.0
-      '@sentry/opentelemetry': 10.27.0(@opentelemetry/api@1.9.0)(@opentelemetry/context-async-hooks@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/core@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/sdk-trace-base@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/semantic-conventions@1.37.0)
+      '@sentry/opentelemetry': 10.27.0(@opentelemetry/api@1.9.0)(@opentelemetry/context-async-hooks@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/core@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/sdk-trace-base@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/semantic-conventions@1.38.0)
       '@sentry/react': 10.27.0(react@18.3.1)
       '@sentry/vercel-edge': 10.27.0
-      '@sentry/webpack-plugin': 4.3.0(webpack@5.101.3(esbuild@0.25.9))
-      next: 15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@sentry/webpack-plugin': 4.6.1(webpack@5.104.1(esbuild@0.25.12))
+      next: 15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       resolve: 1.22.8
-      rollup: 4.52.2
+      rollup: 4.55.1
       stacktrace-parser: 0.1.11
     transitivePeerDependencies:
       - '@opentelemetry/context-async-hooks'
@@ -10351,19 +9970,19 @@ snapshots:
       - supports-color
       - webpack
 
-  '@sentry/node-core@10.27.0(@opentelemetry/api@1.9.0)(@opentelemetry/context-async-hooks@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/core@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/instrumentation@0.208.0(@opentelemetry/api@1.9.0))(@opentelemetry/resources@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/sdk-trace-base@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/semantic-conventions@1.37.0)':
+  '@sentry/node-core@10.27.0(@opentelemetry/api@1.9.0)(@opentelemetry/context-async-hooks@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/core@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/instrumentation@0.209.0(@opentelemetry/api@1.9.0))(@opentelemetry/resources@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/sdk-trace-base@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/semantic-conventions@1.38.0)':
     dependencies:
       '@apm-js-collab/tracing-hooks': 0.3.1
       '@opentelemetry/api': 1.9.0
       '@opentelemetry/context-async-hooks': 2.2.0(@opentelemetry/api@1.9.0)
       '@opentelemetry/core': 2.2.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
       '@opentelemetry/resources': 2.2.0(@opentelemetry/api@1.9.0)
       '@opentelemetry/sdk-trace-base': 2.2.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/semantic-conventions': 1.37.0
+      '@opentelemetry/semantic-conventions': 1.38.0
       '@sentry/core': 10.27.0
-      '@sentry/opentelemetry': 10.27.0(@opentelemetry/api@1.9.0)(@opentelemetry/context-async-hooks@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/core@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/sdk-trace-base@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/semantic-conventions@1.37.0)
-      import-in-the-middle: 2.0.0
+      '@sentry/opentelemetry': 10.27.0(@opentelemetry/api@1.9.0)(@opentelemetry/context-async-hooks@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/core@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/sdk-trace-base@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/semantic-conventions@1.38.0)
+      import-in-the-middle: 2.0.2
     transitivePeerDependencies:
       - supports-color
 
@@ -10372,7 +9991,7 @@ snapshots:
       '@opentelemetry/api': 1.9.0
       '@opentelemetry/context-async-hooks': 2.2.0(@opentelemetry/api@1.9.0)
       '@opentelemetry/core': 2.2.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/instrumentation': 0.208.0(@opentelemetry/api@1.9.0)
+      '@opentelemetry/instrumentation': 0.209.0(@opentelemetry/api@1.9.0)
       '@opentelemetry/instrumentation-amqplib': 0.55.0(@opentelemetry/api@1.9.0)
       '@opentelemetry/instrumentation-connect': 0.52.0(@opentelemetry/api@1.9.0)
       '@opentelemetry/instrumentation-dataloader': 0.26.0(@opentelemetry/api@1.9.0)
@@ -10397,23 +10016,23 @@ snapshots:
       '@opentelemetry/instrumentation-undici': 0.19.0(@opentelemetry/api@1.9.0)
       '@opentelemetry/resources': 2.2.0(@opentelemetry/api@1.9.0)
       '@opentelemetry/sdk-trace-base': 2.2.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/semantic-conventions': 1.37.0
+      '@opentelemetry/semantic-conventions': 1.38.0
       '@prisma/instrumentation': 6.19.0(@opentelemetry/api@1.9.0)
       '@sentry/core': 10.27.0
-      '@sentry/node-core': 10.27.0(@opentelemetry/api@1.9.0)(@opentelemetry/context-async-hooks@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/core@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/instrumentation@0.208.0(@opentelemetry/api@1.9.0))(@opentelemetry/resources@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/sdk-trace-base@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/semantic-conventions@1.37.0)
-      '@sentry/opentelemetry': 10.27.0(@opentelemetry/api@1.9.0)(@opentelemetry/context-async-hooks@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/core@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/sdk-trace-base@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/semantic-conventions@1.37.0)
-      import-in-the-middle: 2.0.0
+      '@sentry/node-core': 10.27.0(@opentelemetry/api@1.9.0)(@opentelemetry/context-async-hooks@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/core@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/instrumentation@0.209.0(@opentelemetry/api@1.9.0))(@opentelemetry/resources@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/sdk-trace-base@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/semantic-conventions@1.38.0)
+      '@sentry/opentelemetry': 10.27.0(@opentelemetry/api@1.9.0)(@opentelemetry/context-async-hooks@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/core@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/sdk-trace-base@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/semantic-conventions@1.38.0)
+      import-in-the-middle: 2.0.2
       minimatch: 9.0.5
     transitivePeerDependencies:
       - supports-color
 
-  '@sentry/opentelemetry@10.27.0(@opentelemetry/api@1.9.0)(@opentelemetry/context-async-hooks@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/core@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/sdk-trace-base@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/semantic-conventions@1.37.0)':
+  '@sentry/opentelemetry@10.27.0(@opentelemetry/api@1.9.0)(@opentelemetry/context-async-hooks@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/core@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/sdk-trace-base@2.2.0(@opentelemetry/api@1.9.0))(@opentelemetry/semantic-conventions@1.38.0)':
     dependencies:
       '@opentelemetry/api': 1.9.0
       '@opentelemetry/context-async-hooks': 2.2.0(@opentelemetry/api@1.9.0)
       '@opentelemetry/core': 2.2.0(@opentelemetry/api@1.9.0)
       '@opentelemetry/sdk-trace-base': 2.2.0(@opentelemetry/api@1.9.0)
-      '@opentelemetry/semantic-conventions': 1.37.0
+      '@opentelemetry/semantic-conventions': 1.38.0
       '@sentry/core': 10.27.0
 
   '@sentry/react@10.27.0(react@18.3.1)':
@@ -10429,30 +10048,30 @@ snapshots:
       '@opentelemetry/resources': 2.2.0(@opentelemetry/api@1.9.0)
       '@sentry/core': 10.27.0
 
-  '@sentry/webpack-plugin@4.3.0(webpack@5.101.3(esbuild@0.25.9))':
+  '@sentry/webpack-plugin@4.6.1(webpack@5.104.1(esbuild@0.25.12))':
     dependencies:
-      '@sentry/bundler-plugin-core': 4.3.0
+      '@sentry/bundler-plugin-core': 4.6.1
       unplugin: 1.0.1
       uuid: 9.0.1
-      webpack: 5.101.3(esbuild@0.25.9)
+      webpack: 5.104.1(esbuild@0.25.12)
     transitivePeerDependencies:
       - encoding
       - supports-color
 
-  '@shikijs/engine-oniguruma@3.14.0':
+  '@shikijs/engine-oniguruma@3.21.0':
     dependencies:
-      '@shikijs/types': 3.14.0
+      '@shikijs/types': 3.21.0
       '@shikijs/vscode-textmate': 10.0.2
 
-  '@shikijs/langs@3.14.0':
+  '@shikijs/langs@3.21.0':
     dependencies:
-      '@shikijs/types': 3.14.0
+      '@shikijs/types': 3.21.0
 
-  '@shikijs/themes@3.14.0':
+  '@shikijs/themes@3.21.0':
     dependencies:
-      '@shikijs/types': 3.14.0
+      '@shikijs/types': 3.21.0
 
-  '@shikijs/types@3.14.0':
+  '@shikijs/types@3.21.0':
     dependencies:
       '@shikijs/vscode-textmate': 10.0.2
       '@types/hast': 3.0.4
@@ -10461,6 +10080,8 @@ snapshots:
 
   '@standard-schema/spec@1.0.0': {}
 
+  '@standard-schema/spec@1.1.0': {}
+
   '@standard-schema/utils@0.3.0': {}
 
   '@stoplight/better-ajv-errors@1.0.3(ajv@8.17.1)':
@@ -10480,7 +10101,7 @@ snapshots:
     dependencies:
       '@stoplight/json': 3.21.7
       '@stoplight/path': 1.3.2
-      '@stoplight/types': 13.20.0
+      '@stoplight/types': 13.6.0
       '@types/urijs': 1.19.26
       dependency-graph: 0.11.0
       fast-memoize: 2.5.2
@@ -10493,7 +10114,7 @@ snapshots:
     dependencies:
       '@stoplight/ordered-object-literal': 1.0.5
       '@stoplight/path': 1.3.2
-      '@stoplight/types': 13.20.0
+      '@stoplight/types': 13.6.0
       jsonc-parser: 2.2.1
       lodash: 4.17.21
       safe-stable-stringify: 1.1.1
@@ -10594,7 +10215,7 @@ snapshots:
     dependencies:
       '@stoplight/json': 3.21.7
       '@stoplight/path': 1.3.2
-      '@stoplight/types': 13.20.0
+      '@stoplight/types': 13.6.0
       abort-controller: 3.0.0
       lodash: 4.17.21
       node-fetch: 2.7.0
@@ -10629,14 +10250,14 @@ snapshots:
   '@storybook/addon-a11y@9.1.5(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))':
     dependencies:
       '@storybook/global': 5.0.0
-      axe-core: 4.10.3
+      axe-core: 4.11.1
       storybook: 9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2)
 
   '@storybook/addon-docs@9.1.5(@types/react@18.3.17)(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))':
     dependencies:
       '@mdx-js/react': 3.1.1(@types/react@18.3.17)(react@18.3.1)
       '@storybook/csf-plugin': 9.1.5(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))
-      '@storybook/icons': 1.4.0(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@storybook/icons': 1.6.0(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       '@storybook/react-dom-shim': 9.1.5(react-dom@18.3.1(react@18.3.1))(react@18.3.1)(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))
       react: 18.3.1
       react-dom: 18.3.1(react@18.3.1)
@@ -10656,22 +10277,22 @@ snapshots:
     dependencies:
       storybook: 9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2)
 
-  '@storybook/builder-webpack5@9.1.5(esbuild@0.25.9)(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))(typescript@5.9.3)':
+  '@storybook/builder-webpack5@9.1.5(esbuild@0.25.12)(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))(typescript@5.9.3)':
     dependencies:
       '@storybook/core-webpack': 9.1.5(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))
       case-sensitive-paths-webpack-plugin: 2.4.0
       cjs-module-lexer: 1.4.3
-      css-loader: 6.11.0(webpack@5.101.3(esbuild@0.25.9))
+      css-loader: 6.11.0(webpack@5.104.1(esbuild@0.25.12))
       es-module-lexer: 1.7.0
-      fork-ts-checker-webpack-plugin: 8.0.0(typescript@5.9.3)(webpack@5.101.3(esbuild@0.25.9))
-      html-webpack-plugin: 5.6.4(webpack@5.101.3(esbuild@0.25.9))
-      magic-string: 0.30.19
+      fork-ts-checker-webpack-plugin: 8.0.0(typescript@5.9.3)(webpack@5.104.1(esbuild@0.25.12))
+      html-webpack-plugin: 5.6.5(webpack@5.104.1(esbuild@0.25.12))
+      magic-string: 0.30.21
       storybook: 9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2)
-      style-loader: 3.3.4(webpack@5.101.3(esbuild@0.25.9))
-      terser-webpack-plugin: 5.3.14(esbuild@0.25.9)(webpack@5.101.3(esbuild@0.25.9))
+      style-loader: 3.3.4(webpack@5.104.1(esbuild@0.25.12))
+      terser-webpack-plugin: 5.3.16(esbuild@0.25.12)(webpack@5.104.1(esbuild@0.25.12))
       ts-dedent: 2.2.0
-      webpack: 5.101.3(esbuild@0.25.9)
-      webpack-dev-middleware: 6.1.3(webpack@5.101.3(esbuild@0.25.9))
+      webpack: 5.104.1(esbuild@0.25.12)
+      webpack-dev-middleware: 6.1.3(webpack@5.104.1(esbuild@0.25.12))
       webpack-hot-middleware: 2.26.1
       webpack-virtual-modules: 0.6.2
     optionalDependencies:
@@ -10695,53 +10316,53 @@ snapshots:
 
   '@storybook/global@5.0.0': {}
 
-  '@storybook/icons@1.4.0(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
+  '@storybook/icons@1.6.0(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
     dependencies:
       react: 18.3.1
       react-dom: 18.3.1(react@18.3.1)
 
-  '@storybook/nextjs@9.1.5(esbuild@0.25.9)(next@15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react-dom@18.3.1(react@18.3.1))(react@18.3.1)(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))(type-fest@4.41.0)(typescript@5.9.3)(webpack-hot-middleware@2.26.1)(webpack@5.101.3(esbuild@0.25.9))':
+  '@storybook/nextjs@9.1.5(esbuild@0.25.12)(next@15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react-dom@18.3.1(react@18.3.1))(react@18.3.1)(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))(type-fest@4.41.0)(typescript@5.9.3)(webpack-hot-middleware@2.26.1)(webpack@5.104.1(esbuild@0.25.12))':
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/plugin-syntax-bigint': 7.8.3(@babel/core@7.28.4)
-      '@babel/plugin-syntax-dynamic-import': 7.8.3(@babel/core@7.28.4)
-      '@babel/plugin-syntax-import-assertions': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-class-properties': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-export-namespace-from': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-numeric-separator': 7.27.1(@babel/core@7.28.4)
-      '@babel/plugin-transform-object-rest-spread': 7.28.4(@babel/core@7.28.4)
-      '@babel/plugin-transform-runtime': 7.28.3(@babel/core@7.28.4)
-      '@babel/preset-env': 7.28.3(@babel/core@7.28.4)
-      '@babel/preset-react': 7.27.1(@babel/core@7.28.4)
-      '@babel/preset-typescript': 7.27.1(@babel/core@7.28.4)
+      '@babel/core': 7.28.5
+      '@babel/plugin-syntax-bigint': 7.8.3(@babel/core@7.28.5)
+      '@babel/plugin-syntax-dynamic-import': 7.8.3(@babel/core@7.28.5)
+      '@babel/plugin-syntax-import-assertions': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-class-properties': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-export-namespace-from': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-numeric-separator': 7.27.1(@babel/core@7.28.5)
+      '@babel/plugin-transform-object-rest-spread': 7.28.4(@babel/core@7.28.5)
+      '@babel/plugin-transform-runtime': 7.28.5(@babel/core@7.28.5)
+      '@babel/preset-env': 7.28.5(@babel/core@7.28.5)
+      '@babel/preset-react': 7.28.5(@babel/core@7.28.5)
+      '@babel/preset-typescript': 7.28.5(@babel/core@7.28.5)
       '@babel/runtime': 7.28.4
-      '@pmmmwh/react-refresh-webpack-plugin': 0.5.17(react-refresh@0.14.2)(type-fest@4.41.0)(webpack-hot-middleware@2.26.1)(webpack@5.101.3(esbuild@0.25.9))
-      '@storybook/builder-webpack5': 9.1.5(esbuild@0.25.9)(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))(typescript@5.9.3)
-      '@storybook/preset-react-webpack': 9.1.5(esbuild@0.25.9)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))(typescript@5.9.3)
+      '@pmmmwh/react-refresh-webpack-plugin': 0.5.17(react-refresh@0.14.2)(type-fest@4.41.0)(webpack-hot-middleware@2.26.1)(webpack@5.104.1(esbuild@0.25.12))
+      '@storybook/builder-webpack5': 9.1.5(esbuild@0.25.12)(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))(typescript@5.9.3)
+      '@storybook/preset-react-webpack': 9.1.5(esbuild@0.25.12)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))(typescript@5.9.3)
       '@storybook/react': 9.1.5(react-dom@18.3.1(react@18.3.1))(react@18.3.1)(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))(typescript@5.9.3)
       '@types/semver': 7.7.1
-      babel-loader: 9.2.1(@babel/core@7.28.4)(webpack@5.101.3(esbuild@0.25.9))
-      css-loader: 6.11.0(webpack@5.101.3(esbuild@0.25.9))
+      babel-loader: 9.2.1(@babel/core@7.28.5)(webpack@5.104.1(esbuild@0.25.12))
+      css-loader: 6.11.0(webpack@5.104.1(esbuild@0.25.12))
       image-size: 2.0.2
       loader-utils: 3.3.1
-      next: 15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
-      node-polyfill-webpack-plugin: 2.0.1(webpack@5.101.3(esbuild@0.25.9))
+      next: 15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      node-polyfill-webpack-plugin: 2.0.1(webpack@5.104.1(esbuild@0.25.12))
       postcss: 8.5.6
-      postcss-loader: 8.2.0(postcss@8.5.6)(typescript@5.9.3)(webpack@5.101.3(esbuild@0.25.9))
+      postcss-loader: 8.2.0(postcss@8.5.6)(typescript@5.9.3)(webpack@5.104.1(esbuild@0.25.12))
       react: 18.3.1
       react-dom: 18.3.1(react@18.3.1)
       react-refresh: 0.14.2
       resolve-url-loader: 5.0.0
-      sass-loader: 16.0.5(webpack@5.101.3(esbuild@0.25.9))
-      semver: 7.7.2
+      sass-loader: 16.0.6(webpack@5.104.1(esbuild@0.25.12))
+      semver: 7.7.3
       storybook: 9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2)
-      style-loader: 3.3.4(webpack@5.101.3(esbuild@0.25.9))
-      styled-jsx: 5.1.7(@babel/core@7.28.4)(react@18.3.1)
+      style-loader: 3.3.4(webpack@5.104.1(esbuild@0.25.12))
+      styled-jsx: 5.1.7(@babel/core@7.28.5)(react@18.3.1)
       tsconfig-paths: 4.2.0
       tsconfig-paths-webpack-plugin: 4.2.0
     optionalDependencies:
       typescript: 5.9.3
-      webpack: 5.101.3(esbuild@0.25.9)
+      webpack: 5.104.1(esbuild@0.25.12)
     transitivePeerDependencies:
       - '@rspack/core'
       - '@swc/core'
@@ -10760,21 +10381,21 @@ snapshots:
       - webpack-hot-middleware
       - webpack-plugin-serve
 
-  '@storybook/preset-react-webpack@9.1.5(esbuild@0.25.9)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))(typescript@5.9.3)':
+  '@storybook/preset-react-webpack@9.1.5(esbuild@0.25.12)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))(typescript@5.9.3)':
     dependencies:
       '@storybook/core-webpack': 9.1.5(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))
-      '@storybook/react-docgen-typescript-plugin': 1.0.6--canary.9.0c3f3b7.0(typescript@5.9.3)(webpack@5.101.3(esbuild@0.25.9))
+      '@storybook/react-docgen-typescript-plugin': 1.0.6--canary.9.0c3f3b7.0(typescript@5.9.3)(webpack@5.104.1(esbuild@0.25.12))
       '@types/semver': 7.7.1
       find-up: 7.0.0
-      magic-string: 0.30.19
+      magic-string: 0.30.21
       react: 18.3.1
       react-docgen: 7.1.1
       react-dom: 18.3.1(react@18.3.1)
-      resolve: 1.22.10
-      semver: 7.7.2
+      resolve: 1.22.11
+      semver: 7.7.3
       storybook: 9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2)
       tsconfig-paths: 4.2.0
-      webpack: 5.101.3(esbuild@0.25.9)
+      webpack: 5.104.1(esbuild@0.25.12)
     optionalDependencies:
       typescript: 5.9.3
     transitivePeerDependencies:
@@ -10784,7 +10405,7 @@ snapshots:
       - uglify-js
       - webpack-cli
 
-  '@storybook/react-docgen-typescript-plugin@1.0.6--canary.9.0c3f3b7.0(typescript@5.9.3)(webpack@5.101.3(esbuild@0.25.9))':
+  '@storybook/react-docgen-typescript-plugin@1.0.6--canary.9.0c3f3b7.0(typescript@5.9.3)(webpack@5.104.1(esbuild@0.25.12))':
     dependencies:
       debug: 4.4.3
       endent: 2.1.0
@@ -10794,7 +10415,7 @@ snapshots:
       react-docgen-typescript: 2.4.0(typescript@5.9.3)
       tslib: 2.8.1
       typescript: 5.9.3
-      webpack: 5.101.3(esbuild@0.25.9)
+      webpack: 5.104.1(esbuild@0.25.12)
     transitivePeerDependencies:
       - supports-color
 
@@ -10836,10 +10457,10 @@ snapshots:
   '@supabase/realtime-js@2.78.0':
     dependencies:
       '@supabase/node-fetch': 2.6.15
-      '@types/phoenix': 1.6.6
+      '@types/phoenix': 1.6.7
       '@types/ws': 8.18.1
       tslib: 2.8.1
-      ws: 8.18.3
+      ws: 8.19.0
     transitivePeerDependencies:
       - bufferutil
       - utf-8-validate
@@ -10872,7 +10493,7 @@ snapshots:
 
   '@tanstack/eslint-plugin-query@5.91.2(eslint@8.57.1)(typescript@5.9.3)':
     dependencies:
-      '@typescript-eslint/utils': 8.46.2(eslint@8.57.1)(typescript@5.9.3)
+      '@typescript-eslint/utils': 8.52.0(eslint@8.57.1)(typescript@5.9.3)
       eslint: 8.57.1
     transitivePeerDependencies:
       - supports-color
@@ -10912,7 +10533,7 @@ snapshots:
       picocolors: 1.1.1
       pretty-format: 27.5.1
 
-  '@testing-library/jest-dom@6.8.0':
+  '@testing-library/jest-dom@6.9.1':
     dependencies:
       '@adobe/css-tools': 4.4.4
       aria-query: 5.3.2
@@ -10934,36 +10555,37 @@ snapshots:
 
   '@types/babel__core@7.20.5':
     dependencies:
-      '@babel/parser': 7.28.4
-      '@babel/types': 7.28.4
+      '@babel/parser': 7.28.5
+      '@babel/types': 7.28.5
       '@types/babel__generator': 7.27.0
       '@types/babel__template': 7.4.4
       '@types/babel__traverse': 7.28.0
 
   '@types/babel__generator@7.27.0':
     dependencies:
-      '@babel/types': 7.28.4
+      '@babel/types': 7.28.5
 
   '@types/babel__template@7.4.4':
     dependencies:
-      '@babel/parser': 7.28.4
-      '@babel/types': 7.28.4
+      '@babel/parser': 7.28.5
+      '@babel/types': 7.28.5
 
   '@types/babel__traverse@7.28.0':
     dependencies:
-      '@babel/types': 7.28.4
+      '@babel/types': 7.28.5
 
   '@types/canvas-confetti@1.9.0': {}
 
-  '@types/chai@5.2.2':
+  '@types/chai@5.2.3':
     dependencies:
       '@types/deep-eql': 4.0.2
+      assertion-error: 2.0.1
 
   '@types/connect@3.4.38':
     dependencies:
       '@types/node': 24.10.0
 
-  '@types/d3-array@3.2.1': {}
+  '@types/d3-array@3.2.2': {}
 
   '@types/d3-color@3.1.3': {}
 
@@ -11078,7 +10700,7 @@ snapshots:
       pg-protocol: 1.10.3
       pg-types: 2.2.0
 
-  '@types/phoenix@1.6.6': {}
+  '@types/phoenix@1.6.7': {}
 
   '@types/prop-types@15.7.15': {}
 
@@ -11097,7 +10719,7 @@ snapshots:
   '@types/react@18.3.17':
     dependencies:
       '@types/prop-types': 15.7.15
-      csstype: 3.1.3
+      csstype: 3.2.3
 
   '@types/resolve@1.20.6': {}
 
@@ -11105,8 +10727,6 @@ snapshots:
 
   '@types/statuses@2.0.6': {}
 
-  '@types/stylis@4.2.5': {}
-
   '@types/tedious@4.0.14':
     dependencies:
       '@types/node': 24.10.0
@@ -11123,200 +10743,95 @@ snapshots:
     dependencies:
       '@types/node': 24.10.0
 
-  '@typescript-eslint/eslint-plugin@8.48.1(@typescript-eslint/parser@8.48.1(eslint@8.57.1)(typescript@5.9.3))(eslint@8.57.1)(typescript@5.9.3)':
+  '@typescript-eslint/eslint-plugin@8.52.0(@typescript-eslint/parser@8.52.0(eslint@8.57.1)(typescript@5.9.3))(eslint@8.57.1)(typescript@5.9.3)':
     dependencies:
       '@eslint-community/regexpp': 4.12.2
-      '@typescript-eslint/parser': 8.48.1(eslint@8.57.1)(typescript@5.9.3)
-      '@typescript-eslint/scope-manager': 8.48.1
-      '@typescript-eslint/type-utils': 8.48.1(eslint@8.57.1)(typescript@5.9.3)
-      '@typescript-eslint/utils': 8.48.1(eslint@8.57.1)(typescript@5.9.3)
-      '@typescript-eslint/visitor-keys': 8.48.1
+      '@typescript-eslint/parser': 8.52.0(eslint@8.57.1)(typescript@5.9.3)
+      '@typescript-eslint/scope-manager': 8.52.0
+      '@typescript-eslint/type-utils': 8.52.0(eslint@8.57.1)(typescript@5.9.3)
+      '@typescript-eslint/utils': 8.52.0(eslint@8.57.1)(typescript@5.9.3)
+      '@typescript-eslint/visitor-keys': 8.52.0
       eslint: 8.57.1
-      graphemer: 1.4.0
       ignore: 7.0.5
       natural-compare: 1.4.0
-      ts-api-utils: 2.1.0(typescript@5.9.3)
+      ts-api-utils: 2.4.0(typescript@5.9.3)
       typescript: 5.9.3
     transitivePeerDependencies:
       - supports-color
 
-  '@typescript-eslint/parser@8.48.1(eslint@8.57.1)(typescript@5.9.3)':
+  '@typescript-eslint/parser@8.52.0(eslint@8.57.1)(typescript@5.9.3)':
     dependencies:
-      '@typescript-eslint/scope-manager': 8.48.1
-      '@typescript-eslint/types': 8.48.1
-      '@typescript-eslint/typescript-estree': 8.48.1(typescript@5.9.3)
-      '@typescript-eslint/visitor-keys': 8.48.1
+      '@typescript-eslint/scope-manager': 8.52.0
+      '@typescript-eslint/types': 8.52.0
+      '@typescript-eslint/typescript-estree': 8.52.0(typescript@5.9.3)
+      '@typescript-eslint/visitor-keys': 8.52.0
       debug: 4.4.3
       eslint: 8.57.1
       typescript: 5.9.3
     transitivePeerDependencies:
       - supports-color
 
-  '@typescript-eslint/project-service@8.43.0(typescript@5.9.3)':
+  '@typescript-eslint/project-service@8.52.0(typescript@5.9.3)':
     dependencies:
-      '@typescript-eslint/tsconfig-utils': 8.43.0(typescript@5.9.3)
-      '@typescript-eslint/types': 8.48.1
+      '@typescript-eslint/tsconfig-utils': 8.52.0(typescript@5.9.3)
+      '@typescript-eslint/types': 8.52.0
       debug: 4.4.3
       typescript: 5.9.3
     transitivePeerDependencies:
       - supports-color
 
-  '@typescript-eslint/project-service@8.46.2(typescript@5.9.3)':
+  '@typescript-eslint/scope-manager@8.52.0':
     dependencies:
-      '@typescript-eslint/tsconfig-utils': 8.46.2(typescript@5.9.3)
-      '@typescript-eslint/types': 8.48.1
-      debug: 4.4.3
-      typescript: 5.9.3
-    transitivePeerDependencies:
-      - supports-color
+      '@typescript-eslint/types': 8.52.0
+      '@typescript-eslint/visitor-keys': 8.52.0
 
-  '@typescript-eslint/project-service@8.48.1(typescript@5.9.3)':
-    dependencies:
-      '@typescript-eslint/tsconfig-utils': 8.48.1(typescript@5.9.3)
-      '@typescript-eslint/types': 8.48.1
-      debug: 4.4.3
-      typescript: 5.9.3
-    transitivePeerDependencies:
-      - supports-color
-
-  '@typescript-eslint/scope-manager@8.43.0':
-    dependencies:
-      '@typescript-eslint/types': 8.43.0
-      '@typescript-eslint/visitor-keys': 8.43.0
-
-  '@typescript-eslint/scope-manager@8.46.2':
-    dependencies:
-      '@typescript-eslint/types': 8.46.2
-      '@typescript-eslint/visitor-keys': 8.46.2
-
-  '@typescript-eslint/scope-manager@8.48.1':
-    dependencies:
-      '@typescript-eslint/types': 8.48.1
-      '@typescript-eslint/visitor-keys': 8.48.1
-
-  '@typescript-eslint/tsconfig-utils@8.43.0(typescript@5.9.3)':
+  '@typescript-eslint/tsconfig-utils@8.52.0(typescript@5.9.3)':
     dependencies:
       typescript: 5.9.3
 
-  '@typescript-eslint/tsconfig-utils@8.46.2(typescript@5.9.3)':
+  '@typescript-eslint/type-utils@8.52.0(eslint@8.57.1)(typescript@5.9.3)':
     dependencies:
-      typescript: 5.9.3
-
-  '@typescript-eslint/tsconfig-utils@8.48.1(typescript@5.9.3)':
-    dependencies:
-      typescript: 5.9.3
-
-  '@typescript-eslint/type-utils@8.48.1(eslint@8.57.1)(typescript@5.9.3)':
-    dependencies:
-      '@typescript-eslint/types': 8.48.1
-      '@typescript-eslint/typescript-estree': 8.48.1(typescript@5.9.3)
-      '@typescript-eslint/utils': 8.48.1(eslint@8.57.1)(typescript@5.9.3)
+      '@typescript-eslint/types': 8.52.0
+      '@typescript-eslint/typescript-estree': 8.52.0(typescript@5.9.3)
+      '@typescript-eslint/utils': 8.52.0(eslint@8.57.1)(typescript@5.9.3)
       debug: 4.4.3
       eslint: 8.57.1
-      ts-api-utils: 2.1.0(typescript@5.9.3)
+      ts-api-utils: 2.4.0(typescript@5.9.3)
       typescript: 5.9.3
     transitivePeerDependencies:
       - supports-color
 
-  '@typescript-eslint/types@8.43.0': {}
+  '@typescript-eslint/types@8.52.0': {}
 
-  '@typescript-eslint/types@8.46.2': {}
-
-  '@typescript-eslint/types@8.48.1': {}
-
-  '@typescript-eslint/typescript-estree@8.43.0(typescript@5.9.3)':
+  '@typescript-eslint/typescript-estree@8.52.0(typescript@5.9.3)':
     dependencies:
-      '@typescript-eslint/project-service': 8.43.0(typescript@5.9.3)
-      '@typescript-eslint/tsconfig-utils': 8.43.0(typescript@5.9.3)
-      '@typescript-eslint/types': 8.43.0
-      '@typescript-eslint/visitor-keys': 8.43.0
-      debug: 4.4.3
-      fast-glob: 3.3.3
-      is-glob: 4.0.3
-      minimatch: 9.0.5
-      semver: 7.7.3
-      ts-api-utils: 2.1.0(typescript@5.9.3)
-      typescript: 5.9.3
-    transitivePeerDependencies:
-      - supports-color
-
-  '@typescript-eslint/typescript-estree@8.46.2(typescript@5.9.3)':
-    dependencies:
-      '@typescript-eslint/project-service': 8.46.2(typescript@5.9.3)
-      '@typescript-eslint/tsconfig-utils': 8.46.2(typescript@5.9.3)
-      '@typescript-eslint/types': 8.46.2
-      '@typescript-eslint/visitor-keys': 8.46.2
-      debug: 4.4.3
-      fast-glob: 3.3.3
-      is-glob: 4.0.3
-      minimatch: 9.0.5
-      semver: 7.7.3
-      ts-api-utils: 2.1.0(typescript@5.9.3)
-      typescript: 5.9.3
-    transitivePeerDependencies:
-      - supports-color
-
-  '@typescript-eslint/typescript-estree@8.48.1(typescript@5.9.3)':
-    dependencies:
-      '@typescript-eslint/project-service': 8.48.1(typescript@5.9.3)
-      '@typescript-eslint/tsconfig-utils': 8.48.1(typescript@5.9.3)
-      '@typescript-eslint/types': 8.48.1
-      '@typescript-eslint/visitor-keys': 8.48.1
+      '@typescript-eslint/project-service': 8.52.0(typescript@5.9.3)
+      '@typescript-eslint/tsconfig-utils': 8.52.0(typescript@5.9.3)
+      '@typescript-eslint/types': 8.52.0
+      '@typescript-eslint/visitor-keys': 8.52.0
       debug: 4.4.3
       minimatch: 9.0.5
       semver: 7.7.3
       tinyglobby: 0.2.15
-      ts-api-utils: 2.1.0(typescript@5.9.3)
+      ts-api-utils: 2.4.0(typescript@5.9.3)
       typescript: 5.9.3
     transitivePeerDependencies:
       - supports-color
 
-  '@typescript-eslint/utils@8.43.0(eslint@8.57.1)(typescript@5.9.3)':
+  '@typescript-eslint/utils@8.52.0(eslint@8.57.1)(typescript@5.9.3)':
     dependencies:
-      '@eslint-community/eslint-utils': 4.9.0(eslint@8.57.1)
-      '@typescript-eslint/scope-manager': 8.43.0
-      '@typescript-eslint/types': 8.43.0
-      '@typescript-eslint/typescript-estree': 8.43.0(typescript@5.9.3)
+      '@eslint-community/eslint-utils': 4.9.1(eslint@8.57.1)
+      '@typescript-eslint/scope-manager': 8.52.0
+      '@typescript-eslint/types': 8.52.0
+      '@typescript-eslint/typescript-estree': 8.52.0(typescript@5.9.3)
       eslint: 8.57.1
       typescript: 5.9.3
     transitivePeerDependencies:
       - supports-color
 
-  '@typescript-eslint/utils@8.46.2(eslint@8.57.1)(typescript@5.9.3)':
+  '@typescript-eslint/visitor-keys@8.52.0':
     dependencies:
-      '@eslint-community/eslint-utils': 4.9.0(eslint@8.57.1)
-      '@typescript-eslint/scope-manager': 8.46.2
-      '@typescript-eslint/types': 8.46.2
-      '@typescript-eslint/typescript-estree': 8.46.2(typescript@5.9.3)
-      eslint: 8.57.1
-      typescript: 5.9.3
-    transitivePeerDependencies:
-      - supports-color
-
-  '@typescript-eslint/utils@8.48.1(eslint@8.57.1)(typescript@5.9.3)':
-    dependencies:
-      '@eslint-community/eslint-utils': 4.9.0(eslint@8.57.1)
-      '@typescript-eslint/scope-manager': 8.48.1
-      '@typescript-eslint/types': 8.48.1
-      '@typescript-eslint/typescript-estree': 8.48.1(typescript@5.9.3)
-      eslint: 8.57.1
-      typescript: 5.9.3
-    transitivePeerDependencies:
-      - supports-color
-
-  '@typescript-eslint/visitor-keys@8.43.0':
-    dependencies:
-      '@typescript-eslint/types': 8.43.0
-      eslint-visitor-keys: 4.2.1
-
-  '@typescript-eslint/visitor-keys@8.46.2':
-    dependencies:
-      '@typescript-eslint/types': 8.46.2
-      eslint-visitor-keys: 4.2.1
-
-  '@typescript-eslint/visitor-keys@8.48.1':
-    dependencies:
-      '@typescript-eslint/types': 8.48.1
+      '@typescript-eslint/types': 8.52.0
       eslint-visitor-keys: 4.2.1
 
   '@ungap/structured-clone@1.3.0': {}
@@ -11380,19 +10895,19 @@ snapshots:
   '@unrs/resolver-binding-win32-x64-msvc@1.11.1':
     optional: true
 
-  '@vercel/analytics@1.5.0(next@15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react@18.3.1)':
+  '@vercel/analytics@1.5.0(next@15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react@18.3.1)':
     optionalDependencies:
-      next: 15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      next: 15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       react: 18.3.1
 
-  '@vercel/speed-insights@1.2.0(next@15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react@18.3.1)':
+  '@vercel/speed-insights@1.2.0(next@15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react@18.3.1)':
     optionalDependencies:
-      next: 15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      next: 15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       react: 18.3.1
 
   '@vitest/expect@3.2.4':
     dependencies:
-      '@types/chai': 5.2.2
+      '@types/chai': 5.2.3
       '@vitest/spy': 3.2.4
       '@vitest/utils': 3.2.4
       chai: 5.3.3
@@ -11402,7 +10917,7 @@ snapshots:
     dependencies:
       '@vitest/spy': 3.2.4
       estree-walker: 3.0.3
-      magic-string: 0.30.19
+      magic-string: 0.30.21
     optionalDependencies:
       msw: 2.11.6(@types/node@24.10.0)(typescript@5.9.3)
 
@@ -11412,7 +10927,7 @@ snapshots:
 
   '@vitest/spy@3.2.4':
     dependencies:
-      tinyspy: 4.0.3
+      tinyspy: 4.0.4
 
   '@vitest/utils@3.2.4':
     dependencies:
@@ -11496,17 +11011,21 @@ snapshots:
       '@webassemblyjs/ast': 1.14.1
       '@xtuc/long': 4.2.2
 
+  '@x0k/json-schema-merge@1.0.2':
+    dependencies:
+      '@types/json-schema': 7.0.15
+
   '@xtuc/ieee754@1.2.0': {}
 
   '@xtuc/long@4.2.2': {}
 
-  '@xyflow/react@12.9.2(@types/react@18.3.17)(immer@10.1.3)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
+  '@xyflow/react@12.9.2(@types/react@18.3.17)(immer@11.1.3)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
     dependencies:
       '@xyflow/system': 0.0.72
       classcat: 5.0.5
       react: 18.3.1
       react-dom: 18.3.1(react@18.3.1)
-      zustand: 4.5.7(@types/react@18.3.17)(immer@10.1.3)(react@18.3.1)
+      zustand: 4.5.7(@types/react@18.3.17)(immer@11.1.3)(react@18.3.1)
     transitivePeerDependencies:
       - '@types/react'
       - immer
@@ -11583,7 +11102,7 @@ snapshots:
   ajv@8.17.1:
     dependencies:
       fast-deep-equal: 3.1.3
-      fast-uri: 3.0.6
+      fast-uri: 3.1.0
       json-schema-traverse: 1.0.0
       require-from-string: 2.0.2
 
@@ -11636,7 +11155,7 @@ snapshots:
       call-bind: 1.0.8
       call-bound: 1.0.4
       define-properties: 1.2.1
-      es-abstract: 1.24.0
+      es-abstract: 1.24.1
       es-object-atoms: 1.1.1
       get-intrinsic: 1.3.0
       is-string: 1.1.1
@@ -11648,7 +11167,7 @@ snapshots:
     dependencies:
       call-bind: 1.0.8
       define-properties: 1.2.1
-      es-abstract: 1.24.0
+      es-abstract: 1.24.1
       es-errors: 1.3.0
       es-object-atoms: 1.1.1
       es-shim-unscopables: 1.1.0
@@ -11658,7 +11177,7 @@ snapshots:
       call-bind: 1.0.8
       call-bound: 1.0.4
       define-properties: 1.2.1
-      es-abstract: 1.24.0
+      es-abstract: 1.24.1
       es-errors: 1.3.0
       es-object-atoms: 1.1.1
       es-shim-unscopables: 1.1.0
@@ -11667,21 +11186,21 @@ snapshots:
     dependencies:
       call-bind: 1.0.8
       define-properties: 1.2.1
-      es-abstract: 1.24.0
+      es-abstract: 1.24.1
       es-shim-unscopables: 1.1.0
 
   array.prototype.flatmap@1.3.3:
     dependencies:
       call-bind: 1.0.8
       define-properties: 1.2.1
-      es-abstract: 1.24.0
+      es-abstract: 1.24.1
       es-shim-unscopables: 1.1.0
 
   array.prototype.tosorted@1.1.4:
     dependencies:
       call-bind: 1.0.8
       define-properties: 1.2.1
-      es-abstract: 1.24.0
+      es-abstract: 1.24.1
       es-errors: 1.3.0
       es-shim-unscopables: 1.1.0
 
@@ -11690,7 +11209,7 @@ snapshots:
       array-buffer-byte-length: 1.0.2
       call-bind: 1.0.8
       define-properties: 1.2.1
-      es-abstract: 1.24.0
+      es-abstract: 1.24.1
       es-errors: 1.3.0
       get-intrinsic: 1.3.0
       is-array-buffer: 3.0.5
@@ -11725,54 +11244,52 @@ snapshots:
     dependencies:
       possible-typed-array-names: 1.1.0
 
-  axe-core@4.10.3: {}
+  axe-core@4.11.1: {}
 
-  axe-core@4.11.0: {}
-
-  axe-html-reporter@2.2.11(axe-core@4.11.0):
+  axe-html-reporter@2.2.11(axe-core@4.11.1):
     dependencies:
-      axe-core: 4.11.0
+      axe-core: 4.11.1
       mustache: 4.2.0
 
   axe-playwright@2.2.2(playwright@1.56.1):
     dependencies:
       '@types/junit-report-builder': 3.0.2
-      axe-core: 4.11.0
-      axe-html-reporter: 2.2.11(axe-core@4.11.0)
+      axe-core: 4.11.1
+      axe-html-reporter: 2.2.11(axe-core@4.11.1)
       junit-report-builder: 5.1.1
       picocolors: 1.1.1
       playwright: 1.56.1
 
   axobject-query@4.1.0: {}
 
-  babel-loader@9.2.1(@babel/core@7.28.4)(webpack@5.101.3(esbuild@0.25.9)):
+  babel-loader@9.2.1(@babel/core@7.28.5)(webpack@5.104.1(esbuild@0.25.12)):
     dependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
       find-cache-dir: 4.0.0
-      schema-utils: 4.3.2
-      webpack: 5.101.3(esbuild@0.25.9)
+      schema-utils: 4.3.3
+      webpack: 5.104.1(esbuild@0.25.12)
 
-  babel-plugin-polyfill-corejs2@0.4.14(@babel/core@7.28.4):
+  babel-plugin-polyfill-corejs2@0.4.14(@babel/core@7.28.5):
     dependencies:
-      '@babel/compat-data': 7.28.4
-      '@babel/core': 7.28.4
-      '@babel/helper-define-polyfill-provider': 0.6.5(@babel/core@7.28.4)
+      '@babel/compat-data': 7.28.5
+      '@babel/core': 7.28.5
+      '@babel/helper-define-polyfill-provider': 0.6.5(@babel/core@7.28.5)
       semver: 6.3.1
     transitivePeerDependencies:
       - supports-color
 
-  babel-plugin-polyfill-corejs3@0.13.0(@babel/core@7.28.4):
+  babel-plugin-polyfill-corejs3@0.13.0(@babel/core@7.28.5):
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/helper-define-polyfill-provider': 0.6.5(@babel/core@7.28.4)
-      core-js-compat: 3.45.1
+      '@babel/core': 7.28.5
+      '@babel/helper-define-polyfill-provider': 0.6.5(@babel/core@7.28.5)
+      core-js-compat: 3.47.0
     transitivePeerDependencies:
       - supports-color
 
-  babel-plugin-polyfill-regenerator@0.6.5(@babel/core@7.28.4):
+  babel-plugin-polyfill-regenerator@0.6.5(@babel/core@7.28.5):
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/helper-define-polyfill-provider': 0.6.5(@babel/core@7.28.4)
+      '@babel/core': 7.28.5
+      '@babel/helper-define-polyfill-provider': 0.6.5(@babel/core@7.28.5)
     transitivePeerDependencies:
       - supports-color
 
@@ -11782,6 +11299,8 @@ snapshots:
 
   base64-js@1.5.1: {}
 
+  baseline-browser-mapping@2.9.11: {}
+
   better-opn@3.0.2:
     dependencies:
       open: 8.4.2
@@ -11841,16 +11360,15 @@ snapshots:
       randombytes: 2.1.0
       safe-buffer: 5.2.1
 
-  browserify-sign@4.2.3:
+  browserify-sign@4.2.5:
     dependencies:
       bn.js: 5.2.2
       browserify-rsa: 4.1.1
       create-hash: 1.2.0
       create-hmac: 1.1.7
       elliptic: 6.6.1
-      hash-base: 3.0.5
       inherits: 2.0.4
-      parse-asn1: 5.1.7
+      parse-asn1: 5.1.9
       readable-stream: 2.3.8
       safe-buffer: 5.2.1
 
@@ -11858,12 +11376,13 @@ snapshots:
     dependencies:
       pako: 1.0.11
 
-  browserslist@4.25.4:
+  browserslist@4.28.1:
     dependencies:
-      caniuse-lite: 1.0.30001741
-      electron-to-chromium: 1.5.214
-      node-releases: 2.0.20
-      update-browserslist-db: 1.1.3(browserslist@4.25.4)
+      baseline-browser-mapping: 2.9.11
+      caniuse-lite: 1.0.30001762
+      electron-to-chromium: 1.5.267
+      node-releases: 2.0.27
+      update-browserslist-db: 1.2.3(browserslist@4.28.1)
 
   buffer-from@1.1.2: {}
 
@@ -11904,9 +11423,7 @@ snapshots:
 
   camelcase-css@2.0.1: {}
 
-  camelize@1.0.1: {}
-
-  caniuse-lite@1.0.30001741: {}
+  caniuse-lite@1.0.30001762: {}
 
   case-sensitive-paths-webpack-plugin@2.4.0: {}
 
@@ -11915,7 +11432,7 @@ snapshots:
   chai@5.3.3:
     dependencies:
       assertion-error: 2.0.1
-      check-error: 2.1.1
+      check-error: 2.1.3
       deep-eql: 5.0.2
       loupe: 3.2.1
       pathval: 2.0.1
@@ -11933,7 +11450,7 @@ snapshots:
 
   character-reference-invalid@2.0.1: {}
 
-  check-error@2.1.1: {}
+  check-error@2.1.3: {}
 
   chokidar@3.6.0:
     dependencies:
@@ -11992,7 +11509,7 @@ snapshots:
       '@radix-ui/react-compose-refs': 1.1.2(@types/react@18.3.17)(react@18.3.1)
       '@radix-ui/react-dialog': 1.1.15(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       '@radix-ui/react-id': 1.1.1(@types/react@18.3.17)(react@18.3.1)
-      '@radix-ui/react-primitive': 2.1.3(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@radix-ui/react-primitive': 2.1.4(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
       react: 18.3.1
       react-dom: 18.3.1(react@18.3.1)
     transitivePeerDependencies:
@@ -12005,18 +11522,6 @@ snapshots:
 
   color-name@1.1.4: {}
 
-  color-string@1.9.1:
-    dependencies:
-      color-name: 1.1.4
-      simple-swizzle: 0.2.2
-    optional: true
-
-  color@4.2.3:
-    dependencies:
-      color-convert: 2.0.1
-      color-string: 1.9.1
-    optional: true
-
   colorette@2.0.20: {}
 
   comma-separated-tokens@2.0.3: {}
@@ -12035,19 +11540,6 @@ snapshots:
 
   compare-versions@6.1.1: {}
 
-  compute-gcd@1.2.1:
-    dependencies:
-      validate.io-array: 1.0.6
-      validate.io-function: 1.0.2
-      validate.io-integer-array: 1.0.0
-
-  compute-lcm@1.1.2:
-    dependencies:
-      compute-gcd: 1.2.1
-      validate.io-array: 1.0.6
-      validate.io-function: 1.0.2
-      validate.io-integer-array: 1.0.0
-
   concat-map@0.0.1: {}
 
   concurrently@9.2.1:
@@ -12069,11 +11561,11 @@ snapshots:
 
   cookie@1.0.2: {}
 
-  core-js-compat@3.45.1:
+  core-js-compat@3.47.0:
     dependencies:
-      browserslist: 4.25.4
+      browserslist: 4.28.1
 
-  core-js-pure@3.45.1: {}
+  core-js-pure@3.47.0: {}
 
   core-util-is@1.0.3: {}
 
@@ -12089,7 +11581,7 @@ snapshots:
     dependencies:
       env-paths: 2.2.1
       import-fresh: 3.3.1
-      js-yaml: 4.1.0
+      js-yaml: 4.1.1
       parse-json: 5.2.0
     optionalDependencies:
       typescript: 5.9.3
@@ -12130,7 +11622,7 @@ snapshots:
   crypto-browserify@3.12.1:
     dependencies:
       browserify-cipher: 1.0.1
-      browserify-sign: 4.2.3
+      browserify-sign: 4.2.5
       create-ecdh: 4.0.4
       create-hash: 1.2.0
       create-hmac: 1.1.7
@@ -12142,9 +11634,7 @@ snapshots:
       randombytes: 2.1.0
       randomfill: 1.0.4
 
-  css-color-keywords@1.0.0: {}
-
-  css-loader@6.11.0(webpack@5.101.3(esbuild@0.25.9)):
+  css-loader@6.11.0(webpack@5.104.1(esbuild@0.25.12)):
     dependencies:
       icss-utils: 5.1.0(postcss@8.5.6)
       postcss: 8.5.6
@@ -12153,9 +11643,9 @@ snapshots:
       postcss-modules-scope: 3.2.1(postcss@8.5.6)
       postcss-modules-values: 4.0.0(postcss@8.5.6)
       postcss-value-parser: 4.2.0
-      semver: 7.7.2
+      semver: 7.7.3
     optionalDependencies:
-      webpack: 5.101.3(esbuild@0.25.9)
+      webpack: 5.104.1(esbuild@0.25.12)
 
   css-select@4.3.0:
     dependencies:
@@ -12165,19 +11655,13 @@ snapshots:
       domutils: 2.8.0
       nth-check: 2.1.1
 
-  css-to-react-native@3.2.0:
-    dependencies:
-      camelize: 1.0.1
-      css-color-keywords: 1.0.0
-      postcss-value-parser: 4.2.0
-
   css-what@6.2.2: {}
 
   css.escape@1.5.1: {}
 
   cssesc@3.0.0: {}
 
-  csstype@3.1.3: {}
+  csstype@3.2.3: {}
 
   d3-array@3.2.4:
     dependencies:
@@ -12314,7 +11798,7 @@ snapshots:
       inherits: 2.0.4
       minimalistic-assert: 1.0.1
 
-  detect-libc@2.0.4:
+  detect-libc@2.1.2:
     optional: true
 
   detect-node-es@1.1.0: {}
@@ -12323,6 +11807,8 @@ snapshots:
     dependencies:
       dequal: 2.0.3
 
+  dexie@4.2.1: {}
+
   didyoumean@1.2.2: {}
 
   diffie-hellman@5.0.3:
@@ -12390,7 +11876,7 @@ snapshots:
 
   eastasianwidth@0.2.0: {}
 
-  electron-to-chromium@1.5.214: {}
+  electron-to-chromium@1.5.267: {}
 
   elliptic@6.6.1:
     dependencies:
@@ -12426,10 +11912,10 @@ snapshots:
       fast-json-parse: 1.0.3
       objectorarray: 1.0.5
 
-  enhanced-resolve@5.18.3:
+  enhanced-resolve@5.18.4:
     dependencies:
       graceful-fs: 4.2.11
-      tapable: 2.2.3
+      tapable: 2.3.0
 
   enquirer@2.4.1:
     dependencies:
@@ -12444,7 +11930,7 @@ snapshots:
 
   env-paths@2.2.1: {}
 
-  error-ex@1.3.2:
+  error-ex@1.3.4:
     dependencies:
       is-arrayish: 0.2.1
 
@@ -12452,7 +11938,7 @@ snapshots:
     dependencies:
       stackframe: 1.3.4
 
-  es-abstract@1.24.0:
+  es-abstract@1.24.1:
     dependencies:
       array-buffer-byte-length: 1.0.2
       arraybuffer.prototype.slice: 1.0.4
@@ -12513,7 +11999,7 @@ snapshots:
     dependencies:
       define-data-property: 1.1.4
       define-properties: 1.2.1
-      es-abstract: 1.24.0
+      es-abstract: 1.24.1
       es-errors: 1.3.0
       function-bind: 1.1.2
       globalthis: 1.0.4
@@ -12524,12 +12010,12 @@ snapshots:
 
   es-errors@1.3.0: {}
 
-  es-iterator-helpers@1.2.1:
+  es-iterator-helpers@1.2.2:
     dependencies:
       call-bind: 1.0.8
       call-bound: 1.0.4
       define-properties: 1.2.1
-      es-abstract: 1.24.0
+      es-abstract: 1.24.1
       es-errors: 1.3.0
       es-set-tostringtag: 2.1.0
       function-bind: 1.1.2
@@ -12545,6 +12031,8 @@ snapshots:
 
   es-module-lexer@1.7.0: {}
 
+  es-module-lexer@2.0.0: {}
+
   es-object-atoms@1.1.1:
     dependencies:
       es-errors: 1.3.0
@@ -12566,74 +12054,45 @@ snapshots:
       is-date-object: 1.1.0
       is-symbol: 1.1.1
 
-  es-toolkit@1.39.10: {}
+  es-toolkit@1.43.0: {}
 
   es6-promise@3.3.1: {}
 
-  esbuild-register@3.6.0(esbuild@0.25.9):
+  esbuild-register@3.6.0(esbuild@0.25.12):
     dependencies:
       debug: 4.4.3
-      esbuild: 0.25.9
+      esbuild: 0.25.12
     transitivePeerDependencies:
       - supports-color
 
-  esbuild@0.25.11:
+  esbuild@0.25.12:
     optionalDependencies:
-      '@esbuild/aix-ppc64': 0.25.11
-      '@esbuild/android-arm': 0.25.11
-      '@esbuild/android-arm64': 0.25.11
-      '@esbuild/android-x64': 0.25.11
-      '@esbuild/darwin-arm64': 0.25.11
-      '@esbuild/darwin-x64': 0.25.11
-      '@esbuild/freebsd-arm64': 0.25.11
-      '@esbuild/freebsd-x64': 0.25.11
-      '@esbuild/linux-arm': 0.25.11
-      '@esbuild/linux-arm64': 0.25.11
-      '@esbuild/linux-ia32': 0.25.11
-      '@esbuild/linux-loong64': 0.25.11
-      '@esbuild/linux-mips64el': 0.25.11
-      '@esbuild/linux-ppc64': 0.25.11
-      '@esbuild/linux-riscv64': 0.25.11
-      '@esbuild/linux-s390x': 0.25.11
-      '@esbuild/linux-x64': 0.25.11
-      '@esbuild/netbsd-arm64': 0.25.11
-      '@esbuild/netbsd-x64': 0.25.11
-      '@esbuild/openbsd-arm64': 0.25.11
-      '@esbuild/openbsd-x64': 0.25.11
-      '@esbuild/openharmony-arm64': 0.25.11
-      '@esbuild/sunos-x64': 0.25.11
-      '@esbuild/win32-arm64': 0.25.11
-      '@esbuild/win32-ia32': 0.25.11
-      '@esbuild/win32-x64': 0.25.11
-
-  esbuild@0.25.9:
-    optionalDependencies:
-      '@esbuild/aix-ppc64': 0.25.9
-      '@esbuild/android-arm': 0.25.9
-      '@esbuild/android-arm64': 0.25.9
-      '@esbuild/android-x64': 0.25.9
-      '@esbuild/darwin-arm64': 0.25.9
-      '@esbuild/darwin-x64': 0.25.9
-      '@esbuild/freebsd-arm64': 0.25.9
-      '@esbuild/freebsd-x64': 0.25.9
-      '@esbuild/linux-arm': 0.25.9
-      '@esbuild/linux-arm64': 0.25.9
-      '@esbuild/linux-ia32': 0.25.9
-      '@esbuild/linux-loong64': 0.25.9
-      '@esbuild/linux-mips64el': 0.25.9
-      '@esbuild/linux-ppc64': 0.25.9
-      '@esbuild/linux-riscv64': 0.25.9
-      '@esbuild/linux-s390x': 0.25.9
-      '@esbuild/linux-x64': 0.25.9
-      '@esbuild/netbsd-arm64': 0.25.9
-      '@esbuild/netbsd-x64': 0.25.9
-      '@esbuild/openbsd-arm64': 0.25.9
-      '@esbuild/openbsd-x64': 0.25.9
-      '@esbuild/openharmony-arm64': 0.25.9
-      '@esbuild/sunos-x64': 0.25.9
-      '@esbuild/win32-arm64': 0.25.9
-      '@esbuild/win32-ia32': 0.25.9
-      '@esbuild/win32-x64': 0.25.9
+      '@esbuild/aix-ppc64': 0.25.12
+      '@esbuild/android-arm': 0.25.12
+      '@esbuild/android-arm64': 0.25.12
+      '@esbuild/android-x64': 0.25.12
+      '@esbuild/darwin-arm64': 0.25.12
+      '@esbuild/darwin-x64': 0.25.12
+      '@esbuild/freebsd-arm64': 0.25.12
+      '@esbuild/freebsd-x64': 0.25.12
+      '@esbuild/linux-arm': 0.25.12
+      '@esbuild/linux-arm64': 0.25.12
+      '@esbuild/linux-ia32': 0.25.12
+      '@esbuild/linux-loong64': 0.25.12
+      '@esbuild/linux-mips64el': 0.25.12
+      '@esbuild/linux-ppc64': 0.25.12
+      '@esbuild/linux-riscv64': 0.25.12
+      '@esbuild/linux-s390x': 0.25.12
+      '@esbuild/linux-x64': 0.25.12
+      '@esbuild/netbsd-arm64': 0.25.12
+      '@esbuild/netbsd-x64': 0.25.12
+      '@esbuild/openbsd-arm64': 0.25.12
+      '@esbuild/openbsd-x64': 0.25.12
+      '@esbuild/openharmony-arm64': 0.25.12
+      '@esbuild/sunos-x64': 0.25.12
+      '@esbuild/win32-arm64': 0.25.12
+      '@esbuild/win32-ia32': 0.25.12
+      '@esbuild/win32-x64': 0.25.12
 
   escalade@3.2.0: {}
 
@@ -12645,12 +12104,12 @@ snapshots:
     dependencies:
       '@next/eslint-plugin-next': 15.5.7
       '@rushstack/eslint-patch': 1.15.0
-      '@typescript-eslint/eslint-plugin': 8.48.1(@typescript-eslint/parser@8.48.1(eslint@8.57.1)(typescript@5.9.3))(eslint@8.57.1)(typescript@5.9.3)
-      '@typescript-eslint/parser': 8.48.1(eslint@8.57.1)(typescript@5.9.3)
+      '@typescript-eslint/eslint-plugin': 8.52.0(@typescript-eslint/parser@8.52.0(eslint@8.57.1)(typescript@5.9.3))(eslint@8.57.1)(typescript@5.9.3)
+      '@typescript-eslint/parser': 8.52.0(eslint@8.57.1)(typescript@5.9.3)
       eslint: 8.57.1
       eslint-import-resolver-node: 0.3.9
       eslint-import-resolver-typescript: 3.10.1(eslint-plugin-import@2.32.0)(eslint@8.57.1)
-      eslint-plugin-import: 2.32.0(@typescript-eslint/parser@8.48.1(eslint@8.57.1)(typescript@5.9.3))(eslint-import-resolver-typescript@3.10.1)(eslint@8.57.1)
+      eslint-plugin-import: 2.32.0(@typescript-eslint/parser@8.52.0(eslint@8.57.1)(typescript@5.9.3))(eslint-import-resolver-typescript@3.10.1)(eslint@8.57.1)
       eslint-plugin-jsx-a11y: 6.10.2(eslint@8.57.1)
       eslint-plugin-react: 7.37.5(eslint@8.57.1)
       eslint-plugin-react-hooks: 5.2.0(eslint@8.57.1)
@@ -12680,22 +12139,22 @@ snapshots:
       tinyglobby: 0.2.15
       unrs-resolver: 1.11.1
     optionalDependencies:
-      eslint-plugin-import: 2.32.0(@typescript-eslint/parser@8.48.1(eslint@8.57.1)(typescript@5.9.3))(eslint-import-resolver-typescript@3.10.1)(eslint@8.57.1)
+      eslint-plugin-import: 2.32.0(@typescript-eslint/parser@8.52.0(eslint@8.57.1)(typescript@5.9.3))(eslint-import-resolver-typescript@3.10.1)(eslint@8.57.1)
     transitivePeerDependencies:
       - supports-color
 
-  eslint-module-utils@2.12.1(@typescript-eslint/parser@8.48.1(eslint@8.57.1)(typescript@5.9.3))(eslint-import-resolver-node@0.3.9)(eslint-import-resolver-typescript@3.10.1)(eslint@8.57.1):
+  eslint-module-utils@2.12.1(@typescript-eslint/parser@8.52.0(eslint@8.57.1)(typescript@5.9.3))(eslint-import-resolver-node@0.3.9)(eslint-import-resolver-typescript@3.10.1)(eslint@8.57.1):
     dependencies:
       debug: 3.2.7
     optionalDependencies:
-      '@typescript-eslint/parser': 8.48.1(eslint@8.57.1)(typescript@5.9.3)
+      '@typescript-eslint/parser': 8.52.0(eslint@8.57.1)(typescript@5.9.3)
       eslint: 8.57.1
       eslint-import-resolver-node: 0.3.9
       eslint-import-resolver-typescript: 3.10.1(eslint-plugin-import@2.32.0)(eslint@8.57.1)
     transitivePeerDependencies:
       - supports-color
 
-  eslint-plugin-import@2.32.0(@typescript-eslint/parser@8.48.1(eslint@8.57.1)(typescript@5.9.3))(eslint-import-resolver-typescript@3.10.1)(eslint@8.57.1):
+  eslint-plugin-import@2.32.0(@typescript-eslint/parser@8.52.0(eslint@8.57.1)(typescript@5.9.3))(eslint-import-resolver-typescript@3.10.1)(eslint@8.57.1):
     dependencies:
       '@rtsao/scc': 1.1.0
       array-includes: 3.1.9
@@ -12706,7 +12165,7 @@ snapshots:
       doctrine: 2.1.0
       eslint: 8.57.1
       eslint-import-resolver-node: 0.3.9
-      eslint-module-utils: 2.12.1(@typescript-eslint/parser@8.48.1(eslint@8.57.1)(typescript@5.9.3))(eslint-import-resolver-node@0.3.9)(eslint-import-resolver-typescript@3.10.1)(eslint@8.57.1)
+      eslint-module-utils: 2.12.1(@typescript-eslint/parser@8.52.0(eslint@8.57.1)(typescript@5.9.3))(eslint-import-resolver-node@0.3.9)(eslint-import-resolver-typescript@3.10.1)(eslint@8.57.1)
       hasown: 2.0.2
       is-core-module: 2.16.1
       is-glob: 4.0.3
@@ -12718,7 +12177,7 @@ snapshots:
       string.prototype.trimend: 1.0.9
       tsconfig-paths: 3.15.0
     optionalDependencies:
-      '@typescript-eslint/parser': 8.48.1(eslint@8.57.1)(typescript@5.9.3)
+      '@typescript-eslint/parser': 8.52.0(eslint@8.57.1)(typescript@5.9.3)
     transitivePeerDependencies:
       - eslint-import-resolver-typescript
       - eslint-import-resolver-webpack
@@ -12730,7 +12189,7 @@ snapshots:
       array-includes: 3.1.9
       array.prototype.flatmap: 1.3.3
       ast-types-flow: 0.0.8
-      axe-core: 4.11.0
+      axe-core: 4.11.1
       axobject-query: 4.1.0
       damerau-levenshtein: 1.0.8
       emoji-regex: 9.2.2
@@ -12754,7 +12213,7 @@ snapshots:
       array.prototype.flatmap: 1.3.3
       array.prototype.tosorted: 1.1.4
       doctrine: 2.1.0
-      es-iterator-helpers: 1.2.1
+      es-iterator-helpers: 1.2.2
       eslint: 8.57.1
       estraverse: 5.3.0
       hasown: 2.0.2
@@ -12771,7 +12230,7 @@ snapshots:
 
   eslint-plugin-storybook@9.1.5(eslint@8.57.1)(storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2))(typescript@5.9.3):
     dependencies:
-      '@typescript-eslint/utils': 8.43.0(eslint@8.57.1)(typescript@5.9.3)
+      '@typescript-eslint/utils': 8.52.0(eslint@8.57.1)(typescript@5.9.3)
       eslint: 8.57.1
       storybook: 9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2)
     transitivePeerDependencies:
@@ -12794,8 +12253,8 @@ snapshots:
 
   eslint@8.57.1:
     dependencies:
-      '@eslint-community/eslint-utils': 4.9.0(eslint@8.57.1)
-      '@eslint-community/regexpp': 4.12.1
+      '@eslint-community/eslint-utils': 4.9.1(eslint@8.57.1)
+      '@eslint-community/regexpp': 4.12.2
       '@eslint/eslintrc': 2.1.4
       '@eslint/js': 8.57.1
       '@humanwhocodes/config-array': 0.13.0
@@ -12811,7 +12270,7 @@ snapshots:
       eslint-scope: 7.2.2
       eslint-visitor-keys: 3.4.3
       espree: 9.6.1
-      esquery: 1.6.0
+      esquery: 1.7.0
       esutils: 2.0.3
       fast-deep-equal: 3.1.3
       file-entry-cache: 6.0.1
@@ -12823,7 +12282,7 @@ snapshots:
       imurmurhash: 0.1.4
       is-glob: 4.0.3
       is-path-inside: 3.0.3
-      js-yaml: 4.1.0
+      js-yaml: 4.1.1
       json-stable-stringify-without-jsonify: 1.0.1
       levn: 0.4.1
       lodash.merge: 4.6.2
@@ -12843,7 +12302,7 @@ snapshots:
 
   esprima@4.0.1: {}
 
-  esquery@1.6.0:
+  esquery@1.7.0:
     dependencies:
       estraverse: 5.3.0
 
@@ -12922,9 +12381,9 @@ snapshots:
 
   fast-safe-stringify@2.1.1: {}
 
-  fast-uri@3.0.6: {}
+  fast-uri@3.1.0: {}
 
-  fastq@1.19.1:
+  fastq@1.20.1:
     dependencies:
       reusify: 1.1.0
 
@@ -12999,7 +12458,7 @@ snapshots:
       cross-spawn: 7.0.6
       signal-exit: 4.1.0
 
-  fork-ts-checker-webpack-plugin@8.0.0(typescript@5.9.3)(webpack@5.101.3(esbuild@0.25.9)):
+  fork-ts-checker-webpack-plugin@8.0.0(typescript@5.9.3)(webpack@5.104.1(esbuild@0.25.12)):
     dependencies:
       '@babel/code-frame': 7.27.1
       chalk: 4.1.2
@@ -13011,17 +12470,17 @@ snapshots:
       minimatch: 3.1.2
       node-abort-controller: 3.1.1
       schema-utils: 3.3.0
-      semver: 7.7.2
-      tapable: 2.2.3
+      semver: 7.7.3
+      tapable: 2.3.0
       typescript: 5.9.3
-      webpack: 5.101.3(esbuild@0.25.9)
+      webpack: 5.104.1(esbuild@0.25.12)
 
   forwarded-parse@2.1.2: {}
 
   framer-motion@12.23.24(@emotion/is-prop-valid@1.2.2)(react-dom@18.3.1(react@18.3.1))(react@18.3.1):
     dependencies:
-      motion-dom: 12.23.23
-      motion-utils: 12.23.6
+      motion-dom: 12.24.8
+      motion-utils: 12.23.28
       tslib: 2.8.1
     optionalDependencies:
       '@emotion/is-prop-valid': 1.2.2
@@ -13034,7 +12493,7 @@ snapshots:
       jsonfile: 6.2.0
       universalify: 2.0.1
 
-  fs-extra@11.3.2:
+  fs-extra@11.3.3:
     dependencies:
       graceful-fs: 4.2.11
       jsonfile: 6.2.0
@@ -13063,9 +12522,9 @@ snapshots:
 
   functions-have-names@1.2.3: {}
 
-  geist@1.5.1(next@15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)):
+  geist@1.5.1(next@15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)):
     dependencies:
-      next: 15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      next: 15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
 
   generator-function@2.0.1: {}
 
@@ -13117,15 +12576,6 @@ snapshots:
 
   glob-to-regexp@0.4.1: {}
 
-  glob@10.4.5:
-    dependencies:
-      foreground-child: 3.3.1
-      jackspeak: 3.4.3
-      minimatch: 9.0.5
-      minipass: 7.1.2
-      package-json-from-dist: 1.0.1
-      path-scurry: 1.11.1
-
   glob@10.5.0:
     dependencies:
       foreground-child: 3.3.1
@@ -13144,13 +12594,6 @@ snapshots:
       once: 1.4.0
       path-is-absolute: 1.0.1
 
-  glob@9.3.5:
-    dependencies:
-      fs.realpath: 1.0.0
-      minimatch: 8.0.4
-      minipass: 4.2.8
-      path-scurry: 1.11.1
-
   globals@13.24.0:
     dependencies:
       type-fest: 0.20.2
@@ -13175,7 +12618,7 @@ snapshots:
 
   graphemer@1.4.0: {}
 
-  graphql@16.11.0: {}
+  graphql@16.12.0: {}
 
   has-bigints@1.1.0: {}
 
@@ -13275,7 +12718,7 @@ snapshots:
       mdast-util-mdxjs-esm: 2.0.1
       property-information: 7.1.0
       space-separated-tokens: 2.0.2
-      style-to-js: 1.1.17
+      style-to-js: 1.1.21
       unist-util-position: 5.0.0
       vfile-message: 4.0.3
     transitivePeerDependencies:
@@ -13330,19 +12773,19 @@ snapshots:
       he: 1.2.0
       param-case: 3.0.4
       relateurl: 0.2.7
-      terser: 5.44.0
+      terser: 5.44.1
 
   html-url-attributes@3.0.1: {}
 
-  html-webpack-plugin@5.6.4(webpack@5.101.3(esbuild@0.25.9)):
+  html-webpack-plugin@5.6.5(webpack@5.104.1(esbuild@0.25.12)):
     dependencies:
       '@types/html-minifier-terser': 6.1.0
       html-minifier-terser: 6.1.0
       lodash: 4.17.21
       pretty-error: 4.0.0
-      tapable: 2.2.3
+      tapable: 2.3.0
     optionalDependencies:
-      webpack: 5.101.3(esbuild@0.25.9)
+      webpack: 5.104.1(esbuild@0.25.12)
 
   htmlparser2@6.1.0:
     dependencies:
@@ -13376,7 +12819,9 @@ snapshots:
 
   image-size@2.0.2: {}
 
-  immer@10.1.3: {}
+  immer@10.2.0: {}
+
+  immer@11.1.3: {}
 
   immer@9.0.21: {}
 
@@ -13385,7 +12830,7 @@ snapshots:
       parent-module: 1.0.1
       resolve-from: 4.0.0
 
-  import-in-the-middle@2.0.0:
+  import-in-the-middle@2.0.2:
     dependencies:
       acorn: 8.15.0
       acorn-import-attributes: 1.9.5(acorn@8.15.0)
@@ -13405,7 +12850,7 @@ snapshots:
 
   inherits@2.0.4: {}
 
-  inline-style-parser@0.2.4: {}
+  inline-style-parser@0.2.7: {}
 
   internal-slot@1.1.0:
     dependencies:
@@ -13435,9 +12880,6 @@ snapshots:
 
   is-arrayish@0.2.1: {}
 
-  is-arrayish@0.3.2:
-    optional: true
-
   is-async-function@2.1.1:
     dependencies:
       async-function: 1.0.0
@@ -13492,13 +12934,6 @@ snapshots:
 
   is-fullwidth-code-point@3.0.0: {}
 
-  is-generator-function@1.1.0:
-    dependencies:
-      call-bound: 1.0.4
-      get-proto: 1.0.1
-      has-tostringtag: 1.0.2
-      safe-regex-test: 1.1.0
-
   is-generator-function@1.1.2:
     dependencies:
       call-bound: 1.0.4
@@ -13615,7 +13050,7 @@ snapshots:
 
   jiti@1.21.7: {}
 
-  jiti@2.5.1: {}
+  jiti@2.6.1: {}
 
   js-tokens@4.0.0: {}
 
@@ -13623,9 +13058,11 @@ snapshots:
     dependencies:
       argparse: 2.0.1
 
-  jsep@1.4.0: {}
+  js-yaml@4.1.1:
+    dependencies:
+      argparse: 2.0.1
 
-  jsesc@3.0.2: {}
+  jsep@1.4.0: {}
 
   jsesc@3.1.0: {}
 
@@ -13633,16 +13070,6 @@ snapshots:
 
   json-parse-even-better-errors@2.3.1: {}
 
-  json-schema-compare@0.2.2:
-    dependencies:
-      lodash: 4.17.21
-
-  json-schema-merge-allof@0.8.1:
-    dependencies:
-      compute-lcm: 1.1.2
-      json-schema-compare: 0.2.2
-      lodash: 4.17.21
-
   json-schema-traverse@0.4.1: {}
 
   json-schema-traverse@1.0.0: {}
@@ -13734,7 +13161,7 @@ snapshots:
     dependencies:
       uc.micro: 2.1.0
 
-  loader-runner@4.3.0: {}
+  loader-runner@4.3.1: {}
 
   loader-utils@2.0.4:
     dependencies:
@@ -13756,7 +13183,7 @@ snapshots:
     dependencies:
       p-locate: 6.0.0
 
-  lodash-es@4.17.21: {}
+  lodash-es@4.17.22: {}
 
   lodash.camelcase@4.3.0: {}
 
@@ -13814,7 +13241,7 @@ snapshots:
 
   lz-string@1.5.0: {}
 
-  magic-string@0.30.19:
+  magic-string@0.30.21:
     dependencies:
       '@jridgewell/sourcemap-codec': 1.5.5
 
@@ -13837,8 +13264,8 @@ snapshots:
 
   markdown-table@3.0.4: {}
 
-  markdown-to-jsx@7.7.13(react@18.3.1):
-    dependencies:
+  markdown-to-jsx@8.0.0(react@18.3.1):
+    optionalDependencies:
       react: 18.3.1
 
   math-intrinsics@1.1.0: {}
@@ -13853,8 +13280,8 @@ snapshots:
     dependencies:
       '@types/mdast': 4.0.4
       escape-string-regexp: 5.0.0
-      unist-util-is: 6.0.0
-      unist-util-visit-parents: 6.0.1
+      unist-util-is: 6.0.1
+      unist-util-visit-parents: 6.0.2
 
   mdast-util-from-markdown@2.0.2:
     dependencies:
@@ -13984,9 +13411,9 @@ snapshots:
   mdast-util-phrasing@4.1.0:
     dependencies:
       '@types/mdast': 4.0.4
-      unist-util-is: 6.0.0
+      unist-util-is: 6.0.1
 
-  mdast-util-to-hast@13.2.0:
+  mdast-util-to-hast@13.2.1:
     dependencies:
       '@types/hast': 3.0.4
       '@types/mdast': 4.0.4
@@ -14259,29 +13686,23 @@ snapshots:
     dependencies:
       brace-expansion: 2.0.2
 
-  minimatch@8.0.4:
-    dependencies:
-      brace-expansion: 2.0.2
-
   minimatch@9.0.5:
     dependencies:
       brace-expansion: 2.0.2
 
   minimist@1.2.8: {}
 
-  minipass@4.2.8: {}
-
   minipass@7.1.2: {}
 
   module-details-from-path@1.0.4: {}
 
   moment@2.30.1: {}
 
-  motion-dom@12.23.23:
+  motion-dom@12.24.8:
     dependencies:
-      motion-utils: 12.23.6
+      motion-utils: 12.23.28
 
-  motion-utils@12.23.6: {}
+  motion-utils@12.23.28: {}
 
   ms@2.1.3: {}
 
@@ -14292,12 +13713,12 @@ snapshots:
 
   msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3):
     dependencies:
-      '@inquirer/confirm': 5.1.19(@types/node@24.10.0)
+      '@inquirer/confirm': 5.1.21(@types/node@24.10.0)
       '@mswjs/interceptors': 0.40.0
       '@open-draft/deferred-promise': 2.2.0
       '@types/statuses': 2.0.6
       cookie: 1.0.2
-      graphql: 16.11.0
+      graphql: 16.12.0
       headers-polyfill: 4.0.3
       is-node-process: 1.2.0
       outvariant: 1.4.3
@@ -14338,15 +13759,15 @@ snapshots:
       react: 18.3.1
       react-dom: 18.3.1(react@18.3.1)
 
-  next@15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1):
+  next@15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1):
     dependencies:
       '@next/env': 15.4.10
       '@swc/helpers': 0.5.15
-      caniuse-lite: 1.0.30001741
+      caniuse-lite: 1.0.30001762
       postcss: 8.4.31
       react: 18.3.1
       react-dom: 18.3.1(react@18.3.1)
-      styled-jsx: 5.1.6(@babel/core@7.28.4)(react@18.3.1)
+      styled-jsx: 5.1.6(@babel/core@7.28.5)(react@18.3.1)
     optionalDependencies:
       '@next/swc-darwin-arm64': 15.4.8
       '@next/swc-darwin-x64': 15.4.8
@@ -14358,7 +13779,7 @@ snapshots:
       '@next/swc-win32-x64-msvc': 15.4.8
       '@opentelemetry/api': 1.9.0
       '@playwright/test': 1.56.1
-      sharp: 0.34.3
+      sharp: 0.34.5
     transitivePeerDependencies:
       - '@babel/core'
       - babel-plugin-macros
@@ -14388,7 +13809,7 @@ snapshots:
     dependencies:
       whatwg-url: 5.0.0
 
-  node-polyfill-webpack-plugin@2.0.1(webpack@5.101.3(esbuild@0.25.9)):
+  node-polyfill-webpack-plugin@2.0.1(webpack@5.104.1(esbuild@0.25.12)):
     dependencies:
       assert: 2.1.0
       browserify-zlib: 0.2.0
@@ -14415,13 +13836,13 @@ snapshots:
       url: 0.11.4
       util: 0.12.5
       vm-browserify: 1.1.2
-      webpack: 5.101.3(esbuild@0.25.9)
+      webpack: 5.104.1(esbuild@0.25.12)
 
   node-readfiles@0.2.0:
     dependencies:
       es6-promise: 3.3.1
 
-  node-releases@2.0.20: {}
+  node-releases@2.0.27: {}
 
   normalize-path@3.0.0: {}
 
@@ -14433,12 +13854,12 @@ snapshots:
     dependencies:
       boolbase: 1.0.0
 
-  nuqs@2.7.2(next@15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react@18.3.1):
+  nuqs@2.7.2(next@15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1))(react@18.3.1):
     dependencies:
       '@standard-schema/spec': 1.0.0
       react: 18.3.1
     optionalDependencies:
-      next: 15.4.10(@babel/core@7.28.4)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      next: 15.4.10(@babel/core@7.28.5)(@opentelemetry/api@1.9.0)(@playwright/test@1.56.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
 
   oas-kit-common@1.0.8:
     dependencies:
@@ -14504,14 +13925,14 @@ snapshots:
     dependencies:
       call-bind: 1.0.8
       define-properties: 1.2.1
-      es-abstract: 1.24.0
+      es-abstract: 1.24.1
       es-object-atoms: 1.1.1
 
   object.groupby@1.0.3:
     dependencies:
       call-bind: 1.0.8
       define-properties: 1.2.1
-      es-abstract: 1.24.0
+      es-abstract: 1.24.1
 
   object.values@1.2.1:
     dependencies:
@@ -14540,7 +13961,7 @@ snapshots:
 
   openapi3-ts@4.5.0:
     dependencies:
-      yaml: 2.8.1
+      yaml: 2.8.2
 
   optionator@0.9.4:
     dependencies:
@@ -14571,15 +13992,15 @@ snapshots:
       enquirer: 2.4.1
       execa: 5.1.1
       find-up: 5.0.0
-      fs-extra: 11.3.2
+      fs-extra: 11.3.3
       js-yaml: 4.1.0
       lodash.uniq: 4.5.0
       openapi3-ts: 4.5.0
       string-argv: 0.3.2
       tsconfck: 2.1.2(typescript@5.9.3)
-      typedoc: 0.28.14(typescript@5.9.3)
-      typedoc-plugin-coverage: 4.0.2(typedoc@0.28.14(typescript@5.9.3))
-      typedoc-plugin-markdown: 4.9.0(typedoc@0.28.14(typescript@5.9.3))
+      typedoc: 0.28.15(typescript@5.9.3)
+      typedoc-plugin-coverage: 4.0.2(typedoc@0.28.15(typescript@5.9.3))
+      typedoc-plugin-markdown: 4.9.0(typedoc@0.28.15(typescript@5.9.3))
     transitivePeerDependencies:
       - encoding
       - openapi-types
@@ -14606,7 +14027,7 @@ snapshots:
 
   p-limit@4.0.0:
     dependencies:
-      yocto-queue: 1.2.1
+      yocto-queue: 1.2.2
 
   p-locate@4.1.0:
     dependencies:
@@ -14635,12 +14056,11 @@ snapshots:
     dependencies:
       callsites: 3.1.0
 
-  parse-asn1@5.1.7:
+  parse-asn1@5.1.9:
     dependencies:
       asn1.js: 4.10.1
       browserify-aes: 1.2.0
       evp_bytestokey: 1.0.3
-      hash-base: 3.0.5
       pbkdf2: 3.1.5
       safe-buffer: 5.2.1
 
@@ -14657,7 +14077,7 @@ snapshots:
   parse-json@5.2.0:
     dependencies:
       '@babel/code-frame': 7.27.1
-      error-ex: 1.3.2
+      error-ex: 1.3.4
       json-parse-even-better-errors: 2.3.1
       lines-and-columns: 1.2.4
 
@@ -14712,7 +14132,7 @@ snapshots:
     dependencies:
       pg-int8: 1.0.1
       postgres-array: 2.0.0
-      postgres-bytea: 1.0.0
+      postgres-bytea: 1.0.1
       postgres-date: 1.0.7
       postgres-interval: 1.2.0
 
@@ -14751,9 +14171,9 @@ snapshots:
       postcss: 8.5.6
       postcss-value-parser: 4.2.0
       read-cache: 1.0.0
-      resolve: 1.22.10
+      resolve: 1.22.11
 
-  postcss-js@4.0.1(postcss@8.5.6):
+  postcss-js@4.1.0(postcss@8.5.6):
     dependencies:
       camelcase-css: 2.0.1
       postcss: 8.5.6
@@ -14761,18 +14181,18 @@ snapshots:
   postcss-load-config@4.0.2(postcss@8.5.6):
     dependencies:
       lilconfig: 3.1.3
-      yaml: 2.8.1
+      yaml: 2.8.2
     optionalDependencies:
       postcss: 8.5.6
 
-  postcss-loader@8.2.0(postcss@8.5.6)(typescript@5.9.3)(webpack@5.101.3(esbuild@0.25.9)):
+  postcss-loader@8.2.0(postcss@8.5.6)(typescript@5.9.3)(webpack@5.104.1(esbuild@0.25.12)):
     dependencies:
       cosmiconfig: 9.0.0(typescript@5.9.3)
-      jiti: 2.5.1
+      jiti: 2.6.1
       postcss: 8.5.6
-      semver: 7.7.2
+      semver: 7.7.3
     optionalDependencies:
-      webpack: 5.101.3(esbuild@0.25.9)
+      webpack: 5.104.1(esbuild@0.25.12)
     transitivePeerDependencies:
       - typescript
 
@@ -14784,13 +14204,13 @@ snapshots:
     dependencies:
       icss-utils: 5.1.0(postcss@8.5.6)
       postcss: 8.5.6
-      postcss-selector-parser: 7.1.0
+      postcss-selector-parser: 7.1.1
       postcss-value-parser: 4.2.0
 
   postcss-modules-scope@3.2.1(postcss@8.5.6):
     dependencies:
       postcss: 8.5.6
-      postcss-selector-parser: 7.1.0
+      postcss-selector-parser: 7.1.1
 
   postcss-modules-values@4.0.0(postcss@8.5.6):
     dependencies:
@@ -14807,7 +14227,7 @@ snapshots:
       cssesc: 3.0.0
       util-deprecate: 1.0.2
 
-  postcss-selector-parser@7.1.0:
+  postcss-selector-parser@7.1.1:
     dependencies:
       cssesc: 3.0.0
       util-deprecate: 1.0.2
@@ -14820,12 +14240,6 @@ snapshots:
       picocolors: 1.1.1
       source-map-js: 1.2.1
 
-  postcss@8.4.49:
-    dependencies:
-      nanoid: 3.3.11
-      picocolors: 1.1.1
-      source-map-js: 1.2.1
-
   postcss@8.5.6:
     dependencies:
       nanoid: 3.3.11
@@ -14834,7 +14248,7 @@ snapshots:
 
   postgres-array@2.0.0: {}
 
-  postgres-bytea@1.0.0: {}
+  postgres-bytea@1.0.1: {}
 
   postgres-date@1.0.7: {}
 
@@ -14882,7 +14296,7 @@ snapshots:
       bn.js: 4.12.2
       browserify-rsa: 4.1.1
       create-hash: 1.2.0
-      parse-asn1: 5.1.7
+      parse-asn1: 5.1.9
       randombytes: 2.1.0
       safe-buffer: 5.2.1
 
@@ -14892,7 +14306,7 @@ snapshots:
 
   punycode@2.3.1: {}
 
-  qs@6.14.0:
+  qs@6.14.1:
     dependencies:
       side-channel: 1.1.0
 
@@ -14928,16 +14342,16 @@ snapshots:
 
   react-docgen@7.1.1:
     dependencies:
-      '@babel/core': 7.28.4
-      '@babel/traverse': 7.28.4
-      '@babel/types': 7.28.4
+      '@babel/core': 7.28.5
+      '@babel/traverse': 7.28.5
+      '@babel/types': 7.28.5
       '@types/babel__core': 7.20.5
       '@types/babel__traverse': 7.28.0
       '@types/doctrine': 0.0.9
       '@types/resolve': 1.20.6
       doctrine: 3.0.0
-      resolve: 1.22.10
-      strip-indent: 4.0.0
+      resolve: 1.22.11
+      strip-indent: 4.1.1
     transitivePeerDependencies:
       - supports-color
 
@@ -14947,13 +14361,6 @@ snapshots:
       react: 18.3.1
       scheduler: 0.23.2
 
-  react-drag-drop-files@2.4.0(react-dom@18.3.1(react@18.3.1))(react@18.3.1):
-    dependencies:
-      prop-types: 15.8.1
-      react: 18.3.1
-      react-dom: 18.3.1(react@18.3.1)
-      styled-components: 6.1.19(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
-
   react-hook-form@7.66.0(react@18.3.1):
     dependencies:
       react: 18.3.1
@@ -14977,7 +14384,7 @@ snapshots:
       devlop: 1.1.0
       hast-util-to-jsx-runtime: 2.3.6
       html-url-attributes: 3.0.1
-      mdast-util-to-hast: 13.2.0
+      mdast-util-to-hast: 13.2.1
       react: 18.3.1
       remark-parse: 11.0.0
       remark-rehype: 11.1.2
@@ -15000,7 +14407,7 @@ snapshots:
     dependencies:
       '@types/use-sync-external-store': 0.0.6
       react: 18.3.1
-      use-sync-external-store: 1.5.0(react@18.3.1)
+      use-sync-external-store: 1.6.0(react@18.3.1)
     optionalDependencies:
       '@types/react': 18.3.17
       redux: 5.0.1
@@ -15015,7 +14422,7 @@ snapshots:
     optionalDependencies:
       '@types/react': 18.3.17
 
-  react-remove-scroll@2.7.1(@types/react@18.3.17)(react@18.3.1):
+  react-remove-scroll@2.7.2(@types/react@18.3.17)(react@18.3.1):
     dependencies:
       react: 18.3.1
       react-remove-scroll-bar: 2.3.8(@types/react@18.3.17)(react@18.3.1)
@@ -15096,19 +14503,19 @@ snapshots:
 
   recharts@3.3.0(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react-is@18.3.1)(react@18.3.1)(redux@5.0.1):
     dependencies:
-      '@reduxjs/toolkit': 2.9.0(react-redux@9.2.0(@types/react@18.3.17)(react@18.3.1)(redux@5.0.1))(react@18.3.1)
+      '@reduxjs/toolkit': 2.11.2(react-redux@9.2.0(@types/react@18.3.17)(react@18.3.1)(redux@5.0.1))(react@18.3.1)
       clsx: 2.1.1
       decimal.js-light: 2.5.1
-      es-toolkit: 1.39.10
+      es-toolkit: 1.43.0
       eventemitter3: 5.0.1
-      immer: 10.1.3
+      immer: 10.2.0
       react: 18.3.1
       react-dom: 18.3.1(react@18.3.1)
       react-is: 18.3.1
       react-redux: 9.2.0(@types/react@18.3.17)(react@18.3.1)(redux@5.0.1)
       reselect: 5.1.1
       tiny-invariant: 1.3.3
-      use-sync-external-store: 1.5.0(react@18.3.1)
+      use-sync-external-store: 1.6.0(react@18.3.1)
       victory-vendor: 37.3.6
     transitivePeerDependencies:
       - '@types/react'
@@ -15129,7 +14536,7 @@ snapshots:
     dependencies:
       call-bind: 1.0.8
       define-properties: 1.2.1
-      es-abstract: 1.24.0
+      es-abstract: 1.24.1
       es-errors: 1.3.0
       es-object-atoms: 1.1.1
       get-intrinsic: 1.3.0
@@ -15138,7 +14545,7 @@ snapshots:
 
   reftools@1.1.9: {}
 
-  regenerate-unicode-properties@10.2.0:
+  regenerate-unicode-properties@10.2.2:
     dependencies:
       regenerate: 1.4.2
 
@@ -15155,20 +14562,20 @@ snapshots:
       gopd: 1.2.0
       set-function-name: 2.0.2
 
-  regexpu-core@6.2.0:
+  regexpu-core@6.4.0:
     dependencies:
       regenerate: 1.4.2
-      regenerate-unicode-properties: 10.2.0
+      regenerate-unicode-properties: 10.2.2
       regjsgen: 0.8.0
-      regjsparser: 0.12.0
+      regjsparser: 0.13.0
       unicode-match-property-ecmascript: 2.0.0
-      unicode-match-property-value-ecmascript: 2.2.0
+      unicode-match-property-value-ecmascript: 2.2.1
 
   regjsgen@0.8.0: {}
 
-  regjsparser@0.12.0:
+  regjsparser@0.13.0:
     dependencies:
-      jsesc: 3.0.2
+      jsesc: 3.1.0
 
   rehype-autolink-headings@7.1.0:
     dependencies:
@@ -15194,7 +14601,7 @@ snapshots:
       hast-util-from-html-isomorphic: 2.0.0
       hast-util-to-text: 4.0.2
       katex: 0.16.25
-      unist-util-visit-parents: 6.0.1
+      unist-util-visit-parents: 6.0.2
       vfile: 6.0.3
 
   rehype-slug@6.0.0:
@@ -15240,7 +14647,7 @@ snapshots:
     dependencies:
       '@types/hast': 3.0.4
       '@types/mdast': 4.0.4
-      mdast-util-to-hast: 13.2.0
+      mdast-util-to-hast: 13.2.1
       unified: 11.0.5
       vfile: 6.0.3
 
@@ -15262,14 +14669,6 @@ snapshots:
 
   require-from-string@2.0.2: {}
 
-  require-in-the-middle@7.5.2:
-    dependencies:
-      debug: 4.4.3
-      module-details-from-path: 1.0.4
-      resolve: 1.22.10
-    transitivePeerDependencies:
-      - supports-color
-
   require-in-the-middle@8.0.1:
     dependencies:
       debug: 4.4.3
@@ -15291,12 +14690,6 @@ snapshots:
       postcss: 8.5.6
       source-map: 0.6.1
 
-  resolve@1.22.10:
-    dependencies:
-      is-core-module: 2.16.1
-      path-parse: 1.0.7
-      supports-preserve-symlinks-flag: 1.0.0
-
   resolve@1.22.11:
     dependencies:
       is-core-module: 2.16.1
@@ -15328,32 +14721,35 @@ snapshots:
       hash-base: 3.1.2
       inherits: 2.0.4
 
-  rollup@4.52.2:
+  rollup@4.55.1:
     dependencies:
       '@types/estree': 1.0.8
     optionalDependencies:
-      '@rollup/rollup-android-arm-eabi': 4.52.2
-      '@rollup/rollup-android-arm64': 4.52.2
-      '@rollup/rollup-darwin-arm64': 4.52.2
-      '@rollup/rollup-darwin-x64': 4.52.2
-      '@rollup/rollup-freebsd-arm64': 4.52.2
-      '@rollup/rollup-freebsd-x64': 4.52.2
-      '@rollup/rollup-linux-arm-gnueabihf': 4.52.2
-      '@rollup/rollup-linux-arm-musleabihf': 4.52.2
-      '@rollup/rollup-linux-arm64-gnu': 4.52.2
-      '@rollup/rollup-linux-arm64-musl': 4.52.2
-      '@rollup/rollup-linux-loong64-gnu': 4.52.2
-      '@rollup/rollup-linux-ppc64-gnu': 4.52.2
-      '@rollup/rollup-linux-riscv64-gnu': 4.52.2
-      '@rollup/rollup-linux-riscv64-musl': 4.52.2
-      '@rollup/rollup-linux-s390x-gnu': 4.52.2
-      '@rollup/rollup-linux-x64-gnu': 4.52.2
-      '@rollup/rollup-linux-x64-musl': 4.52.2
-      '@rollup/rollup-openharmony-arm64': 4.52.2
-      '@rollup/rollup-win32-arm64-msvc': 4.52.2
-      '@rollup/rollup-win32-ia32-msvc': 4.52.2
-      '@rollup/rollup-win32-x64-gnu': 4.52.2
-      '@rollup/rollup-win32-x64-msvc': 4.52.2
+      '@rollup/rollup-android-arm-eabi': 4.55.1
+      '@rollup/rollup-android-arm64': 4.55.1
+      '@rollup/rollup-darwin-arm64': 4.55.1
+      '@rollup/rollup-darwin-x64': 4.55.1
+      '@rollup/rollup-freebsd-arm64': 4.55.1
+      '@rollup/rollup-freebsd-x64': 4.55.1
+      '@rollup/rollup-linux-arm-gnueabihf': 4.55.1
+      '@rollup/rollup-linux-arm-musleabihf': 4.55.1
+      '@rollup/rollup-linux-arm64-gnu': 4.55.1
+      '@rollup/rollup-linux-arm64-musl': 4.55.1
+      '@rollup/rollup-linux-loong64-gnu': 4.55.1
+      '@rollup/rollup-linux-loong64-musl': 4.55.1
+      '@rollup/rollup-linux-ppc64-gnu': 4.55.1
+      '@rollup/rollup-linux-ppc64-musl': 4.55.1
+      '@rollup/rollup-linux-riscv64-gnu': 4.55.1
+      '@rollup/rollup-linux-riscv64-musl': 4.55.1
+      '@rollup/rollup-linux-s390x-gnu': 4.55.1
+      '@rollup/rollup-linux-x64-gnu': 4.55.1
+      '@rollup/rollup-linux-x64-musl': 4.55.1
+      '@rollup/rollup-openbsd-x64': 4.55.1
+      '@rollup/rollup-openharmony-arm64': 4.55.1
+      '@rollup/rollup-win32-arm64-msvc': 4.55.1
+      '@rollup/rollup-win32-ia32-msvc': 4.55.1
+      '@rollup/rollup-win32-x64-gnu': 4.55.1
+      '@rollup/rollup-win32-x64-msvc': 4.55.1
       fsevents: 2.3.3
 
   run-parallel@1.2.0:
@@ -15389,11 +14785,11 @@ snapshots:
 
   safe-stable-stringify@1.1.1: {}
 
-  sass-loader@16.0.5(webpack@5.101.3(esbuild@0.25.9)):
+  sass-loader@16.0.6(webpack@5.104.1(esbuild@0.25.12)):
     dependencies:
       neo-async: 2.6.2
     optionalDependencies:
-      webpack: 5.101.3(esbuild@0.25.9)
+      webpack: 5.104.1(esbuild@0.25.12)
 
   scheduler@0.23.2:
     dependencies:
@@ -15405,7 +14801,7 @@ snapshots:
       ajv: 6.12.6
       ajv-keywords: 3.5.2(ajv@6.12.6)
 
-  schema-utils@4.3.2:
+  schema-utils@4.3.3:
     dependencies:
       '@types/json-schema': 7.0.15
       ajv: 8.17.1
@@ -15414,8 +14810,6 @@ snapshots:
 
   semver@6.3.1: {}
 
-  semver@7.7.2: {}
-
   semver@7.7.3: {}
 
   serialize-javascript@6.0.2:
@@ -15452,36 +14846,36 @@ snapshots:
       safe-buffer: 5.2.1
       to-buffer: 1.2.2
 
-  shallowequal@1.1.0: {}
-
-  sharp@0.34.3:
+  sharp@0.34.5:
     dependencies:
-      color: 4.2.3
-      detect-libc: 2.0.4
+      '@img/colour': 1.0.0
+      detect-libc: 2.1.2
       semver: 7.7.3
     optionalDependencies:
-      '@img/sharp-darwin-arm64': 0.34.3
-      '@img/sharp-darwin-x64': 0.34.3
-      '@img/sharp-libvips-darwin-arm64': 1.2.0
-      '@img/sharp-libvips-darwin-x64': 1.2.0
-      '@img/sharp-libvips-linux-arm': 1.2.0
-      '@img/sharp-libvips-linux-arm64': 1.2.0
-      '@img/sharp-libvips-linux-ppc64': 1.2.0
-      '@img/sharp-libvips-linux-s390x': 1.2.0
-      '@img/sharp-libvips-linux-x64': 1.2.0
-      '@img/sharp-libvips-linuxmusl-arm64': 1.2.0
-      '@img/sharp-libvips-linuxmusl-x64': 1.2.0
-      '@img/sharp-linux-arm': 0.34.3
-      '@img/sharp-linux-arm64': 0.34.3
-      '@img/sharp-linux-ppc64': 0.34.3
-      '@img/sharp-linux-s390x': 0.34.3
-      '@img/sharp-linux-x64': 0.34.3
-      '@img/sharp-linuxmusl-arm64': 0.34.3
-      '@img/sharp-linuxmusl-x64': 0.34.3
-      '@img/sharp-wasm32': 0.34.3
-      '@img/sharp-win32-arm64': 0.34.3
-      '@img/sharp-win32-ia32': 0.34.3
-      '@img/sharp-win32-x64': 0.34.3
+      '@img/sharp-darwin-arm64': 0.34.5
+      '@img/sharp-darwin-x64': 0.34.5
+      '@img/sharp-libvips-darwin-arm64': 1.2.4
+      '@img/sharp-libvips-darwin-x64': 1.2.4
+      '@img/sharp-libvips-linux-arm': 1.2.4
+      '@img/sharp-libvips-linux-arm64': 1.2.4
+      '@img/sharp-libvips-linux-ppc64': 1.2.4
+      '@img/sharp-libvips-linux-riscv64': 1.2.4
+      '@img/sharp-libvips-linux-s390x': 1.2.4
+      '@img/sharp-libvips-linux-x64': 1.2.4
+      '@img/sharp-libvips-linuxmusl-arm64': 1.2.4
+      '@img/sharp-libvips-linuxmusl-x64': 1.2.4
+      '@img/sharp-linux-arm': 0.34.5
+      '@img/sharp-linux-arm64': 0.34.5
+      '@img/sharp-linux-ppc64': 0.34.5
+      '@img/sharp-linux-riscv64': 0.34.5
+      '@img/sharp-linux-s390x': 0.34.5
+      '@img/sharp-linux-x64': 0.34.5
+      '@img/sharp-linuxmusl-arm64': 0.34.5
+      '@img/sharp-linuxmusl-x64': 0.34.5
+      '@img/sharp-wasm32': 0.34.5
+      '@img/sharp-win32-arm64': 0.34.5
+      '@img/sharp-win32-ia32': 0.34.5
+      '@img/sharp-win32-x64': 0.34.5
     optional: true
 
   shebang-command@2.0.0:
@@ -15494,7 +14888,7 @@ snapshots:
 
   shepherd.js@14.5.1:
     dependencies:
-      '@floating-ui/dom': 1.7.3
+      '@floating-ui/dom': 1.7.4
       '@scarf/scarf': 1.4.0
       deepmerge-ts: 7.1.5
 
@@ -15560,11 +14954,6 @@ snapshots:
     dependencies:
       jsep: 1.4.0
 
-  simple-swizzle@0.2.2:
-    dependencies:
-      is-arrayish: 0.3.2
-    optional: true
-
   slash@3.0.0: {}
 
   sonner@2.0.7(react-dom@18.3.1(react@18.3.1))(react@18.3.1):
@@ -15603,17 +14992,17 @@ snapshots:
   storybook@9.1.5(@testing-library/dom@10.4.1)(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))(prettier@3.6.2):
     dependencies:
       '@storybook/global': 5.0.0
-      '@testing-library/jest-dom': 6.8.0
+      '@testing-library/jest-dom': 6.9.1
       '@testing-library/user-event': 14.6.1(@testing-library/dom@10.4.1)
       '@vitest/expect': 3.2.4
       '@vitest/mocker': 3.2.4(msw@2.11.6(@types/node@24.10.0)(typescript@5.9.3))
       '@vitest/spy': 3.2.4
       better-opn: 3.0.2
-      esbuild: 0.25.9
-      esbuild-register: 3.6.0(esbuild@0.25.9)
+      esbuild: 0.25.12
+      esbuild-register: 3.6.0(esbuild@0.25.12)
       recast: 0.23.11
-      semver: 7.7.2
-      ws: 8.18.3
+      semver: 7.7.3
+      ws: 8.19.0
     optionalDependencies:
       prettier: 3.6.2
     transitivePeerDependencies:
@@ -15656,14 +15045,14 @@ snapshots:
     dependencies:
       call-bind: 1.0.8
       define-properties: 1.2.1
-      es-abstract: 1.24.0
+      es-abstract: 1.24.1
 
   string.prototype.matchall@4.0.12:
     dependencies:
       call-bind: 1.0.8
       call-bound: 1.0.4
       define-properties: 1.2.1
-      es-abstract: 1.24.0
+      es-abstract: 1.24.1
       es-errors: 1.3.0
       es-object-atoms: 1.1.1
       get-intrinsic: 1.3.0
@@ -15677,7 +15066,7 @@ snapshots:
   string.prototype.repeat@1.0.0:
     dependencies:
       define-properties: 1.2.1
-      es-abstract: 1.24.0
+      es-abstract: 1.24.1
 
   string.prototype.trim@1.2.10:
     dependencies:
@@ -15685,7 +15074,7 @@ snapshots:
       call-bound: 1.0.4
       define-data-property: 1.1.4
       define-properties: 1.2.1
-      es-abstract: 1.24.0
+      es-abstract: 1.24.1
       es-object-atoms: 1.1.1
       has-property-descriptors: 1.0.2
 
@@ -15731,62 +15120,44 @@ snapshots:
     dependencies:
       min-indent: 1.0.1
 
-  strip-indent@4.0.0:
-    dependencies:
-      min-indent: 1.0.1
+  strip-indent@4.1.1: {}
 
   strip-json-comments@3.1.1: {}
 
-  style-loader@3.3.4(webpack@5.101.3(esbuild@0.25.9)):
+  style-loader@3.3.4(webpack@5.104.1(esbuild@0.25.12)):
     dependencies:
-      webpack: 5.101.3(esbuild@0.25.9)
+      webpack: 5.104.1(esbuild@0.25.12)
 
-  style-to-js@1.1.17:
+  style-to-js@1.1.21:
     dependencies:
-      style-to-object: 1.0.9
+      style-to-object: 1.0.14
 
-  style-to-object@1.0.9:
+  style-to-object@1.0.14:
     dependencies:
-      inline-style-parser: 0.2.4
+      inline-style-parser: 0.2.7
 
-  styled-components@6.1.19(react-dom@18.3.1(react@18.3.1))(react@18.3.1):
-    dependencies:
-      '@emotion/is-prop-valid': 1.2.2
-      '@emotion/unitless': 0.8.1
-      '@types/stylis': 4.2.5
-      css-to-react-native: 3.2.0
-      csstype: 3.1.3
-      postcss: 8.4.49
-      react: 18.3.1
-      react-dom: 18.3.1(react@18.3.1)
-      shallowequal: 1.1.0
-      stylis: 4.3.2
-      tslib: 2.6.2
-
-  styled-jsx@5.1.6(@babel/core@7.28.4)(react@18.3.1):
+  styled-jsx@5.1.6(@babel/core@7.28.5)(react@18.3.1):
     dependencies:
       client-only: 0.0.1
       react: 18.3.1
     optionalDependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
 
-  styled-jsx@5.1.7(@babel/core@7.28.4)(react@18.3.1):
+  styled-jsx@5.1.7(@babel/core@7.28.5)(react@18.3.1):
     dependencies:
       client-only: 0.0.1
       react: 18.3.1
     optionalDependencies:
-      '@babel/core': 7.28.4
+      '@babel/core': 7.28.5
 
-  stylis@4.3.2: {}
-
-  sucrase@3.35.0:
+  sucrase@3.35.1:
     dependencies:
       '@jridgewell/gen-mapping': 0.3.13
       commander: 4.1.1
-      glob: 10.4.5
       lines-and-columns: 1.2.4
       mz: 2.7.0
       pirates: 4.0.7
+      tinyglobby: 0.2.15
       ts-interface-checker: 0.1.13
 
   supports-color@7.2.0:
@@ -15843,29 +15214,29 @@ snapshots:
       picocolors: 1.1.1
       postcss: 8.5.6
       postcss-import: 15.1.0(postcss@8.5.6)
-      postcss-js: 4.0.1(postcss@8.5.6)
+      postcss-js: 4.1.0(postcss@8.5.6)
       postcss-load-config: 4.0.2(postcss@8.5.6)
       postcss-nested: 6.2.0(postcss@8.5.6)
       postcss-selector-parser: 6.1.2
-      resolve: 1.22.10
-      sucrase: 3.35.0
+      resolve: 1.22.11
+      sucrase: 3.35.1
     transitivePeerDependencies:
       - ts-node
 
-  tapable@2.2.3: {}
+  tapable@2.3.0: {}
 
-  terser-webpack-plugin@5.3.14(esbuild@0.25.9)(webpack@5.101.3(esbuild@0.25.9)):
+  terser-webpack-plugin@5.3.16(esbuild@0.25.12)(webpack@5.104.1(esbuild@0.25.12)):
     dependencies:
-      '@jridgewell/trace-mapping': 0.3.30
+      '@jridgewell/trace-mapping': 0.3.31
       jest-worker: 27.5.1
-      schema-utils: 4.3.2
+      schema-utils: 4.3.3
       serialize-javascript: 6.0.2
-      terser: 5.44.0
-      webpack: 5.101.3(esbuild@0.25.9)
+      terser: 5.44.1
+      webpack: 5.104.1(esbuild@0.25.12)
     optionalDependencies:
-      esbuild: 0.25.9
+      esbuild: 0.25.12
 
-  terser@5.44.0:
+  terser@5.44.1:
     dependencies:
       '@jridgewell/source-map': 0.3.11
       acorn: 8.15.0
@@ -15897,13 +15268,13 @@ snapshots:
 
   tinyrainbow@2.0.0: {}
 
-  tinyspy@4.0.3: {}
+  tinyspy@4.0.4: {}
 
-  tldts-core@7.0.17: {}
+  tldts-core@7.0.19: {}
 
-  tldts@7.0.17:
+  tldts@7.0.19:
     dependencies:
-      tldts-core: 7.0.17
+      tldts-core: 7.0.19
 
   to-buffer@1.2.2:
     dependencies:
@@ -15917,7 +15288,7 @@ snapshots:
 
   tough-cookie@6.0.0:
     dependencies:
-      tldts: 7.0.17
+      tldts: 7.0.19
 
   tr46@0.0.3: {}
 
@@ -15927,7 +15298,7 @@ snapshots:
 
   trough@2.2.0: {}
 
-  ts-api-utils@2.1.0(typescript@5.9.3):
+  ts-api-utils@2.4.0(typescript@5.9.3):
     dependencies:
       typescript: 5.9.3
 
@@ -15942,8 +15313,8 @@ snapshots:
   tsconfig-paths-webpack-plugin@4.2.0:
     dependencies:
       chalk: 4.1.2
-      enhanced-resolve: 5.18.3
-      tapable: 2.2.3
+      enhanced-resolve: 5.18.4
+      tapable: 2.3.0
       tsconfig-paths: 4.2.0
 
   tsconfig-paths@3.15.0:
@@ -15961,8 +15332,6 @@ snapshots:
 
   tslib@1.14.1: {}
 
-  tslib@2.6.2: {}
-
   tslib@2.8.1: {}
 
   tty-browserify@0.0.1: {}
@@ -16012,22 +15381,22 @@ snapshots:
       possible-typed-array-names: 1.1.0
       reflect.getprototypeof: 1.0.10
 
-  typedoc-plugin-coverage@4.0.2(typedoc@0.28.14(typescript@5.9.3)):
+  typedoc-plugin-coverage@4.0.2(typedoc@0.28.15(typescript@5.9.3)):
     dependencies:
-      typedoc: 0.28.14(typescript@5.9.3)
+      typedoc: 0.28.15(typescript@5.9.3)
 
-  typedoc-plugin-markdown@4.9.0(typedoc@0.28.14(typescript@5.9.3)):
+  typedoc-plugin-markdown@4.9.0(typedoc@0.28.15(typescript@5.9.3)):
     dependencies:
-      typedoc: 0.28.14(typescript@5.9.3)
+      typedoc: 0.28.15(typescript@5.9.3)
 
-  typedoc@0.28.14(typescript@5.9.3):
+  typedoc@0.28.15(typescript@5.9.3):
     dependencies:
-      '@gerrit0/mini-shiki': 3.14.0
+      '@gerrit0/mini-shiki': 3.20.0
       lunr: 2.3.9
       markdown-it: 14.1.0
       minimatch: 9.0.5
       typescript: 5.9.3
-      yaml: 2.8.1
+      yaml: 2.8.2
 
   typescript@5.9.3: {}
 
@@ -16047,11 +15416,11 @@ snapshots:
   unicode-match-property-ecmascript@2.0.0:
     dependencies:
       unicode-canonical-property-names-ecmascript: 2.0.1
-      unicode-property-aliases-ecmascript: 2.1.0
+      unicode-property-aliases-ecmascript: 2.2.0
 
-  unicode-match-property-value-ecmascript@2.2.0: {}
+  unicode-match-property-value-ecmascript@2.2.1: {}
 
-  unicode-property-aliases-ecmascript@2.1.0: {}
+  unicode-property-aliases-ecmascript@2.2.0: {}
 
   unicorn-magic@0.1.0: {}
 
@@ -16068,9 +15437,9 @@ snapshots:
   unist-util-find-after@5.0.0:
     dependencies:
       '@types/unist': 3.0.3
-      unist-util-is: 6.0.0
+      unist-util-is: 6.0.1
 
-  unist-util-is@6.0.0:
+  unist-util-is@6.0.1:
     dependencies:
       '@types/unist': 3.0.3
 
@@ -16087,16 +15456,16 @@ snapshots:
     dependencies:
       '@types/unist': 3.0.3
 
-  unist-util-visit-parents@6.0.1:
+  unist-util-visit-parents@6.0.2:
     dependencies:
       '@types/unist': 3.0.3
-      unist-util-is: 6.0.0
+      unist-util-is: 6.0.1
 
   unist-util-visit@5.0.0:
     dependencies:
       '@types/unist': 3.0.3
-      unist-util-is: 6.0.0
-      unist-util-visit-parents: 6.0.1
+      unist-util-is: 6.0.1
+      unist-util-visit-parents: 6.0.2
 
   universalify@2.0.1: {}
 
@@ -16138,9 +15507,9 @@ snapshots:
 
   until-async@3.0.2: {}
 
-  update-browserslist-db@1.1.3(browserslist@4.25.4):
+  update-browserslist-db@1.2.3(browserslist@4.28.1):
     dependencies:
-      browserslist: 4.25.4
+      browserslist: 4.28.1
       escalade: 3.2.0
       picocolors: 1.1.1
 
@@ -16153,7 +15522,7 @@ snapshots:
   url@0.11.4:
     dependencies:
       punycode: 1.4.1
-      qs: 6.14.0
+      qs: 6.14.1
 
   use-callback-ref@1.3.3(@types/react@18.3.17)(react@18.3.1):
     dependencies:
@@ -16170,7 +15539,7 @@ snapshots:
     optionalDependencies:
       '@types/react': 18.3.17
 
-  use-sync-external-store@1.5.0(react@18.3.1):
+  use-sync-external-store@1.6.0(react@18.3.1):
     dependencies:
       react: 18.3.1
 
@@ -16180,7 +15549,7 @@ snapshots:
     dependencies:
       inherits: 2.0.4
       is-arguments: 1.2.0
-      is-generator-function: 1.1.0
+      is-generator-function: 1.1.2
       is-typed-array: 1.1.15
       which-typed-array: 1.1.19
 
@@ -16194,22 +15563,7 @@ snapshots:
 
   uuid@9.0.1: {}
 
-  validate.io-array@1.0.6: {}
-
-  validate.io-function@1.0.2: {}
-
-  validate.io-integer-array@1.0.0:
-    dependencies:
-      validate.io-array: 1.0.6
-      validate.io-integer: 1.0.5
-
-  validate.io-integer@1.0.5:
-    dependencies:
-      validate.io-number: 1.0.3
-
-  validate.io-number@1.0.3: {}
-
-  validator@13.15.20: {}
+  validator@13.15.26: {}
 
   vaul@1.1.2(@types/react-dom@18.3.5(@types/react@18.3.17))(@types/react@18.3.17)(react-dom@18.3.1(react@18.3.1))(react@18.3.1):
     dependencies:
@@ -16237,7 +15591,7 @@ snapshots:
 
   victory-vendor@37.3.6:
     dependencies:
-      '@types/d3-array': 3.2.1
+      '@types/d3-array': 3.2.2
       '@types/d3-ease': 3.0.2
       '@types/d3-interpolate': 3.0.4
       '@types/d3-scale': 4.0.9
@@ -16258,7 +15612,7 @@ snapshots:
     dependencies:
       loose-envify: 1.4.0
 
-  watchpack@2.4.4:
+  watchpack@2.5.0:
     dependencies:
       glob-to-regexp: 0.4.1
       graceful-fs: 4.2.11
@@ -16267,15 +15621,15 @@ snapshots:
 
   webidl-conversions@3.0.1: {}
 
-  webpack-dev-middleware@6.1.3(webpack@5.101.3(esbuild@0.25.9)):
+  webpack-dev-middleware@6.1.3(webpack@5.104.1(esbuild@0.25.12)):
     dependencies:
       colorette: 2.0.20
       memfs: 3.5.3
       mime-types: 2.1.35
       range-parser: 1.2.1
-      schema-utils: 4.3.2
+      schema-utils: 4.3.3
     optionalDependencies:
-      webpack: 5.101.3(esbuild@0.25.9)
+      webpack: 5.104.1(esbuild@0.25.12)
 
   webpack-hot-middleware@2.26.1:
     dependencies:
@@ -16289,7 +15643,7 @@ snapshots:
 
   webpack-virtual-modules@0.6.2: {}
 
-  webpack@5.101.3(esbuild@0.25.9):
+  webpack@5.104.1(esbuild@0.25.12):
     dependencies:
       '@types/eslint-scope': 3.7.7
       '@types/estree': 1.0.8
@@ -16299,22 +15653,22 @@ snapshots:
       '@webassemblyjs/wasm-parser': 1.14.1
       acorn: 8.15.0
       acorn-import-phases: 1.0.4(acorn@8.15.0)
-      browserslist: 4.25.4
+      browserslist: 4.28.1
       chrome-trace-event: 1.0.4
-      enhanced-resolve: 5.18.3
-      es-module-lexer: 1.7.0
+      enhanced-resolve: 5.18.4
+      es-module-lexer: 2.0.0
       eslint-scope: 5.1.1
       events: 3.3.0
       glob-to-regexp: 0.4.1
       graceful-fs: 4.2.11
       json-parse-even-better-errors: 2.3.1
-      loader-runner: 4.3.0
+      loader-runner: 4.3.1
       mime-types: 2.1.35
       neo-async: 2.6.2
-      schema-utils: 4.3.2
-      tapable: 2.2.3
-      terser-webpack-plugin: 5.3.14(esbuild@0.25.9)(webpack@5.101.3(esbuild@0.25.9))
-      watchpack: 2.4.4
+      schema-utils: 4.3.3
+      tapable: 2.3.0
+      terser-webpack-plugin: 5.3.16(esbuild@0.25.12)(webpack@5.104.1(esbuild@0.25.12))
+      watchpack: 2.5.0
       webpack-sources: 3.3.3
     transitivePeerDependencies:
       - '@swc/core'
@@ -16393,7 +15747,7 @@ snapshots:
 
   wrappy@1.0.2: {}
 
-  ws@8.18.3: {}
+  ws@8.19.0: {}
 
   xmlbuilder@15.1.1: {}
 
@@ -16405,7 +15759,7 @@ snapshots:
 
   yaml@1.10.2: {}
 
-  yaml@2.8.1: {}
+  yaml@2.8.2: {}
 
   yargs-parser@21.1.1: {}
 
@@ -16421,25 +15775,25 @@ snapshots:
 
   yocto-queue@0.1.0: {}
 
-  yocto-queue@1.2.1: {}
+  yocto-queue@1.2.2: {}
 
   yoctocolors-cjs@2.1.3: {}
 
   zod@3.25.76: {}
 
-  zustand@4.5.7(@types/react@18.3.17)(immer@10.1.3)(react@18.3.1):
+  zustand@4.5.7(@types/react@18.3.17)(immer@11.1.3)(react@18.3.1):
     dependencies:
-      use-sync-external-store: 1.5.0(react@18.3.1)
+      use-sync-external-store: 1.6.0(react@18.3.1)
     optionalDependencies:
       '@types/react': 18.3.17
-      immer: 10.1.3
+      immer: 11.1.3
       react: 18.3.1
 
-  zustand@5.0.8(@types/react@18.3.17)(immer@10.1.3)(react@18.3.1)(use-sync-external-store@1.5.0(react@18.3.1)):
+  zustand@5.0.8(@types/react@18.3.17)(immer@11.1.3)(react@18.3.1)(use-sync-external-store@1.6.0(react@18.3.1)):
     optionalDependencies:
       '@types/react': 18.3.17
-      immer: 10.1.3
+      immer: 11.1.3
       react: 18.3.1
-      use-sync-external-store: 1.5.0(react@18.3.1)
+      use-sync-external-store: 1.6.0(react@18.3.1)
 
   zwitch@2.0.4: {}
diff --git a/autogpt_platform/frontend/public/integrations/webshare_proxy.png b/autogpt_platform/frontend/public/integrations/webshare_proxy.png
new file mode 100644
index 0000000000..2b07ef8415
Binary files /dev/null and b/autogpt_platform/frontend/public/integrations/webshare_proxy.png differ
diff --git a/autogpt_platform/frontend/public/integrations/wordpress.png b/autogpt_platform/frontend/public/integrations/wordpress.png
new file mode 100644
index 0000000000..b8ba8bd3ff
Binary files /dev/null and b/autogpt_platform/frontend/public/integrations/wordpress.png differ
diff --git a/autogpt_platform/frontend/src/app/(no-navbar)/onboarding/5-run/components/AgentOnboardingCredentials/AgentOnboardingCredentials.tsx b/autogpt_platform/frontend/src/app/(no-navbar)/onboarding/5-run/components/AgentOnboardingCredentials/AgentOnboardingCredentials.tsx
index 3176ec7f70..f0bb652a06 100644
--- a/autogpt_platform/frontend/src/app/(no-navbar)/onboarding/5-run/components/AgentOnboardingCredentials/AgentOnboardingCredentials.tsx
+++ b/autogpt_platform/frontend/src/app/(no-navbar)/onboarding/5-run/components/AgentOnboardingCredentials/AgentOnboardingCredentials.tsx
@@ -1,6 +1,6 @@
-import { CredentialsInput } from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/CredentialsInputs";
 import { CredentialsMetaInput } from "@/app/api/__generated__/models/credentialsMetaInput";
 import { GraphMeta } from "@/app/api/__generated__/models/graphMeta";
+import { CredentialsInput } from "@/components/contextual/CredentialsInput/CredentialsInput";
 import { useState } from "react";
 import { getSchemaDefaultCredentials } from "../../helpers";
 import { areAllCredentialsSet, getCredentialFields } from "./helpers";
diff --git a/autogpt_platform/frontend/src/app/(no-navbar)/onboarding/5-run/page.tsx b/autogpt_platform/frontend/src/app/(no-navbar)/onboarding/5-run/page.tsx
index 30e1b67090..db04278d80 100644
--- a/autogpt_platform/frontend/src/app/(no-navbar)/onboarding/5-run/page.tsx
+++ b/autogpt_platform/frontend/src/app/(no-navbar)/onboarding/5-run/page.tsx
@@ -1,12 +1,12 @@
 "use client";
 
-import { RunAgentInputs } from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentInputs/RunAgentInputs";
 import {
   Card,
   CardContent,
   CardHeader,
   CardTitle,
 } from "@/components/__legacy__/ui/card";
+import { RunAgentInputs } from "@/components/contextual/RunAgentInputs/RunAgentInputs";
 import { ErrorCard } from "@/components/molecules/ErrorCard/ErrorCard";
 import { CircleNotchIcon } from "@phosphor-icons/react/dist/ssr";
 import { Play } from "lucide-react";
diff --git a/autogpt_platform/frontend/src/app/(platform)/admin/execution-analytics/components/AnalyticsResultsTable.tsx b/autogpt_platform/frontend/src/app/(platform)/admin/execution-analytics/components/AnalyticsResultsTable.tsx
index 56c52e2ceb..7ab251efb1 100644
--- a/autogpt_platform/frontend/src/app/(platform)/admin/execution-analytics/components/AnalyticsResultsTable.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/admin/execution-analytics/components/AnalyticsResultsTable.tsx
@@ -51,6 +51,8 @@ export function AnalyticsResultsTable({ results }: Props) {
       "Execution ID",
       "Status",
       "Score",
+      "Started At",
+      "Ended At",
       "Summary Text",
       "Error Message",
     ];
@@ -62,6 +64,8 @@ export function AnalyticsResultsTable({ results }: Props) {
       result.exec_id,
       result.status,
       result.score?.toString() || "",
+      result.started_at ? new Date(result.started_at).toLocaleString() : "",
+      result.ended_at ? new Date(result.ended_at).toLocaleString() : "",
       `"${(result.summary_text || "").replace(/"/g, '""')}"`, // Escape quotes in summary
       `"${(result.error_message || "").replace(/"/g, '""')}"`, // Escape quotes in error
     ]);
@@ -248,15 +252,13 @@ export function AnalyticsResultsTable({ results }: Props) {
                         )}
                       </td>
                       <td className="px-4 py-3">
-                        {(result.summary_text || result.error_message) && (
-                          <Button
-                            variant="ghost"
-                            size="small"
-                            onClick={() => toggleRowExpansion(result.exec_id)}
-                          >
-                            <EyeIcon size={16} />
-                          </Button>
-                        )}
+                        <Button
+                          variant="ghost"
+                          size="small"
+                          onClick={() => toggleRowExpansion(result.exec_id)}
+                        >
+                          <EyeIcon size={16} />
+                        </Button>
                       </td>
                     </tr>
 
@@ -264,6 +266,44 @@ export function AnalyticsResultsTable({ results }: Props) {
                       <tr>
                         <td colSpan={7} className="bg-gray-50 px-4 py-3">
                           <div className="space-y-3">
+                            {/* Timestamps section */}
+                            <div className="grid grid-cols-2 gap-4 border-b border-gray-200 pb-3">
+                              <div>
+                                <Text
+                                  variant="body"
+                                  className="text-xs font-medium text-gray-600"
+                                >
+                                  Started At:
+                                </Text>
+                                <Text
+                                  variant="body"
+                                  className="text-sm text-gray-700"
+                                >
+                                  {result.started_at
+                                    ? new Date(
+                                        result.started_at,
+                                      ).toLocaleString()
+                                    : "—"}
+                                </Text>
+                              </div>
+                              <div>
+                                <Text
+                                  variant="body"
+                                  className="text-xs font-medium text-gray-600"
+                                >
+                                  Ended At:
+                                </Text>
+                                <Text
+                                  variant="body"
+                                  className="text-sm text-gray-700"
+                                >
+                                  {result.ended_at
+                                    ? new Date(result.ended_at).toLocaleString()
+                                    : "—"}
+                                </Text>
+                              </div>
+                            </div>
+
                             {result.summary_text && (
                               <div>
                                 <Text
diff --git a/autogpt_platform/frontend/src/app/(platform)/admin/execution-analytics/components/ExecutionAnalyticsForm.tsx b/autogpt_platform/frontend/src/app/(platform)/admin/execution-analytics/components/ExecutionAnalyticsForm.tsx
index 5aced56090..fcdd60dde7 100644
--- a/autogpt_platform/frontend/src/app/(platform)/admin/execution-analytics/components/ExecutionAnalyticsForm.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/admin/execution-analytics/components/ExecutionAnalyticsForm.tsx
@@ -541,7 +541,19 @@ export function ExecutionAnalyticsForm() {
       {/* Accuracy Trends Display */}
       {trendsData && (
         <div className="space-y-4">
-          <h3 className="text-lg font-semibold">Execution Accuracy Trends</h3>
+          <div className="flex items-start justify-between">
+            <h3 className="text-lg font-semibold">Execution Accuracy Trends</h3>
+            <div className="rounded-md bg-blue-50 px-3 py-2 text-xs text-blue-700">
+              <p className="font-medium">
+                Chart Filters (matches monitoring system):
+              </p>
+              <ul className="mt-1 list-inside list-disc space-y-1">
+                <li>Only days with ≥1 execution with correctness score</li>
+                <li>Last 30 days</li>
+                <li>Averages calculated from scored executions only</li>
+              </ul>
+            </div>
+          </div>
 
           {/* Alert Section */}
           {trendsData.alert && (
diff --git a/autogpt_platform/frontend/src/app/(platform)/auth/integrations/oauth_callback/route.ts b/autogpt_platform/frontend/src/app/(platform)/auth/integrations/oauth_callback/route.ts
index df1de26300..41d05a9afb 100644
--- a/autogpt_platform/frontend/src/app/(platform)/auth/integrations/oauth_callback/route.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/auth/integrations/oauth_callback/route.ts
@@ -1,4 +1,4 @@
-import { OAuthPopupResultMessage } from "@/components/renderers/input-renderer/fields/CredentialField/models/OAuthCredentialModal/useOAuthCredentialModal";
+import { OAuthPopupResultMessage } from "./types";
 import { NextResponse } from "next/server";
 
 // This route is intended to be used as the callback for integration OAuth flows,
diff --git a/autogpt_platform/frontend/src/app/(platform)/auth/integrations/oauth_callback/types.ts b/autogpt_platform/frontend/src/app/(platform)/auth/integrations/oauth_callback/types.ts
new file mode 100644
index 0000000000..9000adf392
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/auth/integrations/oauth_callback/types.ts
@@ -0,0 +1,11 @@
+export type OAuthPopupResultMessage = { message_type: "oauth_popup_result" } & (
+  | {
+      success: true;
+      code: string;
+      state: string;
+    }
+  | {
+      success: false;
+      message: string;
+    }
+);
diff --git a/autogpt_platform/frontend/src/app/(platform)/auth/integrations/setup-wizard/page.tsx b/autogpt_platform/frontend/src/app/(platform)/auth/integrations/setup-wizard/page.tsx
index 3372772c89..9e2e637ef6 100644
--- a/autogpt_platform/frontend/src/app/(platform)/auth/integrations/setup-wizard/page.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/auth/integrations/setup-wizard/page.tsx
@@ -1,22 +1,22 @@
 "use client";
 
-import Image from "next/image";
-import Link from "next/link";
-import { useSearchParams } from "next/navigation";
-import { useState, useMemo, useRef } from "react";
-import { AuthCard } from "@/components/auth/AuthCard";
-import { Text } from "@/components/atoms/Text/Text";
+import { useGetOauthGetOauthAppInfo } from "@/app/api/__generated__/endpoints/oauth/oauth";
+import { okData } from "@/app/api/helpers";
 import { Button } from "@/components/atoms/Button/Button";
+import { Text } from "@/components/atoms/Text/Text";
+import { AuthCard } from "@/components/auth/AuthCard";
+import { CredentialsInput } from "@/components/contextual/CredentialsInput/CredentialsInput";
 import { ErrorCard } from "@/components/molecules/ErrorCard/ErrorCard";
-import { CredentialsInput } from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/CredentialsInputs";
 import type {
   BlockIOCredentialsSubSchema,
   CredentialsMetaInput,
   CredentialsType,
 } from "@/lib/autogpt-server-api";
 import { CheckIcon, CircleIcon } from "@phosphor-icons/react";
-import { useGetOauthGetOauthAppInfo } from "@/app/api/__generated__/endpoints/oauth/oauth";
-import { okData } from "@/app/api/helpers";
+import Image from "next/image";
+import Link from "next/link";
+import { useSearchParams } from "next/navigation";
+import { useMemo, useRef, useState } from "react";
 
 // All credential types - we accept any type of credential
 const ALL_CREDENTIAL_TYPES: CredentialsType[] = [
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/BuilderActions.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/BuilderActions.tsx
index 64eb624621..86e4a3eb9c 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/BuilderActions.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/BuilderActions.tsx
@@ -10,7 +10,10 @@ export const BuilderActions = memo(() => {
     flowID: parseAsString,
   });
   return (
-    <div className="absolute bottom-4 left-[50%] z-[100] flex -translate-x-1/2 items-center gap-4 rounded-full bg-white p-2 px-2 shadow-lg">
+    <div
+      data-id="builder-actions"
+      className="absolute bottom-4 left-[50%] z-[100] flex -translate-x-1/2 items-center gap-4 rounded-full bg-white p-2 px-2 shadow-lg"
+    >
       <AgentOutputs flowID={flowID} />
       <RunGraph flowID={flowID} />
       <ScheduleGraph flowID={flowID} />
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/AgentOutputs/AgentOutputs.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/AgentOutputs/AgentOutputs.tsx
index 237bea2ab0..cfea5d9452 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/AgentOutputs/AgentOutputs.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/AgentOutputs/AgentOutputs.tsx
@@ -1,11 +1,6 @@
 import { BlockUIType } from "@/app/(platform)/build/components/types";
 import { useGraphStore } from "@/app/(platform)/build/stores/graphStore";
 import { useNodeStore } from "@/app/(platform)/build/stores/nodeStore";
-import {
-  globalRegistry,
-  OutputActions,
-  OutputItem,
-} from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/OutputRenderers";
 import { Label } from "@/components/__legacy__/ui/label";
 import { ScrollArea } from "@/components/__legacy__/ui/scroll-area";
 import {
@@ -16,16 +11,21 @@ import {
   SheetTitle,
   SheetTrigger,
 } from "@/components/__legacy__/ui/sheet";
+import { Button } from "@/components/atoms/Button/Button";
 import {
   Tooltip,
   TooltipContent,
   TooltipProvider,
   TooltipTrigger,
 } from "@/components/atoms/Tooltip/BaseTooltip";
+import {
+  globalRegistry,
+  OutputActions,
+  OutputItem,
+} from "@/components/contextual/OutputRenderers";
 import { BookOpenIcon } from "@phosphor-icons/react";
 import { useMemo } from "react";
 import { useShallow } from "zustand/react/shallow";
-import { BuilderActionButton } from "../BuilderActionButton";
 
 export const AgentOutputs = ({ flowID }: { flowID: string | null }) => {
   const hasOutputs = useGraphStore(useShallow((state) => state.hasOutputs));
@@ -76,9 +76,14 @@ export const AgentOutputs = ({ flowID }: { flowID: string | null }) => {
         <Tooltip>
           <TooltipTrigger asChild>
             <SheetTrigger asChild>
-              <BuilderActionButton disabled={!flowID || !hasOutputs()}>
-                <BookOpenIcon className="size-6" />
-              </BuilderActionButton>
+              <Button
+                variant="outline"
+                size="icon"
+                data-id="agent-outputs-button"
+                disabled={!flowID || !hasOutputs()}
+              >
+                <BookOpenIcon className="size-4" />
+              </Button>
             </SheetTrigger>
           </TooltipTrigger>
           <TooltipContent>
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/BuilderActionButton.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/BuilderActionButton.tsx
deleted file mode 100644
index f8b3f1051e..0000000000
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/BuilderActionButton.tsx
+++ /dev/null
@@ -1,37 +0,0 @@
-import { Button } from "@/components/atoms/Button/Button";
-import { ButtonProps } from "@/components/atoms/Button/helpers";
-import { cn } from "@/lib/utils";
-import { CircleNotchIcon } from "@phosphor-icons/react";
-
-export const BuilderActionButton = ({
-  children,
-  className,
-  isLoading,
-  ...props
-}: ButtonProps & { isLoading?: boolean }) => {
-  return (
-    <Button
-      variant="icon"
-      size={"small"}
-      className={cn(
-        "relative h-12 w-12 min-w-0 text-lg",
-        "bg-gradient-to-br from-zinc-50 to-zinc-200",
-        "border border-zinc-200",
-        "shadow-[inset_0_3px_0_0_rgba(255,255,255,0.5),0_2px_4px_0_rgba(0,0,0,0.2)]",
-        "dark:shadow-[inset_0_1px_0_0_rgba(255,255,255,0.1),0_2px_4px_0_rgba(0,0,0,0.4)]",
-        "hover:shadow-[inset_0_1px_0_0_rgba(255,255,255,0.5),0_1px_2px_0_rgba(0,0,0,0.2)]",
-        "active:shadow-[inset_0_2px_4px_0_rgba(0,0,0,0.2)]",
-        "transition-all duration-150",
-        "disabled:cursor-not-allowed disabled:opacity-50",
-        className,
-      )}
-      {...props}
-    >
-      {!isLoading ? (
-        children
-      ) : (
-        <CircleNotchIcon className="size-6 animate-spin" />
-      )}
-    </Button>
-  );
-};
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/PublishToMarketplace/PublishToMarketplace.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/PublishToMarketplace/PublishToMarketplace.tsx
index 1e6545dfbd..e7381b7d52 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/PublishToMarketplace/PublishToMarketplace.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/PublishToMarketplace/PublishToMarketplace.tsx
@@ -1,12 +1,12 @@
-import { ShareIcon } from "@phosphor-icons/react";
-import { BuilderActionButton } from "../BuilderActionButton";
+import { Button } from "@/components/atoms/Button/Button";
 import {
   Tooltip,
   TooltipContent,
   TooltipTrigger,
 } from "@/components/atoms/Tooltip/BaseTooltip";
-import { usePublishToMarketplace } from "./usePublishToMarketplace";
 import { PublishAgentModal } from "@/components/contextual/PublishAgentModal/PublishAgentModal";
+import { ShareIcon } from "@phosphor-icons/react";
+import { usePublishToMarketplace } from "./usePublishToMarketplace";
 
 export const PublishToMarketplace = ({ flowID }: { flowID: string | null }) => {
   const { handlePublishToMarketplace, publishState, handleStateChange } =
@@ -16,12 +16,14 @@ export const PublishToMarketplace = ({ flowID }: { flowID: string | null }) => {
     <>
       <Tooltip>
         <TooltipTrigger asChild>
-          <BuilderActionButton
+          <Button
+            variant="outline"
+            size="icon"
             onClick={handlePublishToMarketplace}
             disabled={!flowID}
           >
-            <ShareIcon className="size-6 drop-shadow-sm" />
-          </BuilderActionButton>
+            <ShareIcon className="size-4" />
+          </Button>
         </TooltipTrigger>
         <TooltipContent>Publish to Marketplace</TooltipContent>
       </Tooltip>
@@ -30,6 +32,7 @@ export const PublishToMarketplace = ({ flowID }: { flowID: string | null }) => {
         targetState={publishState}
         onStateChange={handleStateChange}
         preSelectedAgentId={flowID || undefined}
+        showTrigger={false}
       />
     </>
   );
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/RunGraph/RunGraph.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/RunGraph/RunGraph.tsx
index f4c1a7331f..f381ccb93b 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/RunGraph/RunGraph.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/RunGraph/RunGraph.tsx
@@ -1,15 +1,14 @@
-import { useRunGraph } from "./useRunGraph";
 import { useGraphStore } from "@/app/(platform)/build/stores/graphStore";
-import { useShallow } from "zustand/react/shallow";
-import { PlayIcon, StopIcon } from "@phosphor-icons/react";
-import { cn } from "@/lib/utils";
-import { RunInputDialog } from "../RunInputDialog/RunInputDialog";
+import { Button } from "@/components/atoms/Button/Button";
 import {
   Tooltip,
   TooltipContent,
   TooltipTrigger,
 } from "@/components/atoms/Tooltip/BaseTooltip";
-import { BuilderActionButton } from "../BuilderActionButton";
+import { PlayIcon, StopIcon } from "@phosphor-icons/react";
+import { useShallow } from "zustand/react/shallow";
+import { RunInputDialog } from "../RunInputDialog/RunInputDialog";
+import { useRunGraph } from "./useRunGraph";
 
 export const RunGraph = ({ flowID }: { flowID: string | null }) => {
   const {
@@ -29,21 +28,20 @@ export const RunGraph = ({ flowID }: { flowID: string | null }) => {
     <>
       <Tooltip>
         <TooltipTrigger asChild>
-          <BuilderActionButton
-            className={cn(
-              isGraphRunning &&
-                "border-red-500 bg-gradient-to-br from-red-400 to-red-500 shadow-[inset_0_2px_0_0_rgba(255,255,255,0.5),0_2px_4px_0_rgba(0,0,0,0.2)]",
-            )}
+          <Button
+            size="icon"
+            variant={isGraphRunning ? "destructive" : "primary"}
+            data-id={isGraphRunning ? "stop-graph-button" : "run-graph-button"}
             onClick={isGraphRunning ? handleStopGraph : handleRunGraph}
             disabled={!flowID || isExecutingGraph || isTerminatingGraph}
-            isLoading={isExecutingGraph || isTerminatingGraph || isSaving}
+            loading={isExecutingGraph || isTerminatingGraph || isSaving}
           >
             {!isGraphRunning ? (
-              <PlayIcon className="size-6 drop-shadow-sm" />
+              <PlayIcon className="size-4" />
             ) : (
-              <StopIcon className="size-6 drop-shadow-sm" />
+              <StopIcon className="size-4" />
             )}
-          </BuilderActionButton>
+          </Button>
         </TooltipTrigger>
         <TooltipContent>
           {isGraphRunning ? "Stop agent" : "Run agent"}
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/RunGraph/useRunGraph.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/RunGraph/useRunGraph.ts
index b827cfdcb4..6980e95f11 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/RunGraph/useRunGraph.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/RunGraph/useRunGraph.ts
@@ -7,10 +7,11 @@ import { parseAsInteger, parseAsString, useQueryStates } from "nuqs";
 import { GraphExecutionMeta } from "@/app/(platform)/library/agents/[id]/components/OldAgentLibraryView/use-agent-runs";
 import { useGraphStore } from "@/app/(platform)/build/stores/graphStore";
 import { useShallow } from "zustand/react/shallow";
-import { useState } from "react";
+import { useEffect, useState } from "react";
 import { useSaveGraph } from "@/app/(platform)/build/hooks/useSaveGraph";
 import { useNodeStore } from "@/app/(platform)/build/stores/nodeStore";
 import { ApiError } from "@/lib/autogpt-server-api/helpers"; // Check if this exists
+import { useTutorialStore } from "@/app/(platform)/build/stores/tutorialStore";
 
 export const useRunGraph = () => {
   const { saveGraph, isSaving } = useSaveGraph({
@@ -33,6 +34,29 @@ export const useRunGraph = () => {
     useShallow((state) => state.clearAllNodeErrors),
   );
 
+  // Tutorial integration - force open dialog when tutorial requests it
+  const forceOpenRunInputDialog = useTutorialStore(
+    (state) => state.forceOpenRunInputDialog,
+  );
+  const setForceOpenRunInputDialog = useTutorialStore(
+    (state) => state.setForceOpenRunInputDialog,
+  );
+
+  // Sync tutorial state with dialog state
+  useEffect(() => {
+    if (forceOpenRunInputDialog && !openRunInputDialog) {
+      setOpenRunInputDialog(true);
+    }
+  }, [forceOpenRunInputDialog, openRunInputDialog]);
+
+  // Reset tutorial state when dialog closes
+  const handleSetOpenRunInputDialog = (isOpen: boolean) => {
+    setOpenRunInputDialog(isOpen);
+    if (!isOpen && forceOpenRunInputDialog) {
+      setForceOpenRunInputDialog(false);
+    }
+  };
+
   const [{ flowID, flowVersion, flowExecutionID }, setQueryStates] =
     useQueryStates({
       flowID: parseAsString,
@@ -138,6 +162,6 @@ export const useRunGraph = () => {
     isExecutingGraph,
     isTerminatingGraph,
     openRunInputDialog,
-    setOpenRunInputDialog,
+    setOpenRunInputDialog: handleSetOpenRunInputDialog,
   };
 };
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/RunInputDialog/RunInputDialog.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/RunInputDialog/RunInputDialog.tsx
index 2d9f51c8bf..df944da4f9 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/RunInputDialog/RunInputDialog.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/RunInputDialog/RunInputDialog.tsx
@@ -5,9 +5,11 @@ import { useGraphStore } from "@/app/(platform)/build/stores/graphStore";
 import { Button } from "@/components/atoms/Button/Button";
 import { ClockIcon, PlayIcon } from "@phosphor-icons/react";
 import { Text } from "@/components/atoms/Text/Text";
-import { FormRenderer } from "@/components/renderers/input-renderer/FormRenderer";
+import { FormRenderer } from "@/components/renderers/InputRenderer/FormRenderer";
 import { useRunInputDialog } from "./useRunInputDialog";
 import { CronSchedulerDialog } from "../CronSchedulerDialog/CronSchedulerDialog";
+import { useTutorialStore } from "@/app/(platform)/build/stores/tutorialStore";
+import { useEffect } from "react";
 
 export const RunInputDialog = ({
   isOpen,
@@ -37,6 +39,21 @@ export const RunInputDialog = ({
     isExecutingGraph,
   } = useRunInputDialog({ setIsOpen });
 
+  // Tutorial integration - track input values for the tutorial
+  const setTutorialInputValues = useTutorialStore(
+    (state) => state.setTutorialInputValues,
+  );
+  const isTutorialRunning = useTutorialStore(
+    (state) => state.isTutorialRunning,
+  );
+
+  // Update tutorial store when input values change
+  useEffect(() => {
+    if (isTutorialRunning) {
+      setTutorialInputValues(inputValues);
+    }
+  }, [inputValues, isTutorialRunning, setTutorialInputValues]);
+
   return (
     <>
       <Dialog
@@ -48,16 +65,16 @@ export const RunInputDialog = ({
         styling={{ maxWidth: "600px", minWidth: "600px" }}
       >
         <Dialog.Content>
-          <div className="space-y-6 p-1">
+          <div className="space-y-6 p-1" data-id="run-input-dialog-content">
             {/* Credentials Section */}
             {hasCredentials() && (
-              <div>
+              <div data-id="run-input-credentials-section">
                 <div className="mb-4">
                   <Text variant="h4" className="text-gray-900">
                     Credentials
                   </Text>
                 </div>
-                <div className="px-2">
+                <div className="px-2" data-id="run-input-credentials-form">
                   <FormRenderer
                     jsonSchema={credentialsSchema as RJSFSchema}
                     handleChange={(v) => handleCredentialChange(v.formData)}
@@ -66,6 +83,7 @@ export const RunInputDialog = ({
                     formContext={{
                       showHandles: false,
                       size: "large",
+                      showOptionalToggle: false,
                     }}
                   />
                 </div>
@@ -74,13 +92,13 @@ export const RunInputDialog = ({
 
             {/* Inputs Section */}
             {hasInputs() && (
-              <div>
+              <div data-id="run-input-inputs-section">
                 <div className="mb-4">
                   <Text variant="h4" className="text-gray-900">
                     Inputs
                   </Text>
                 </div>
-                <div className="px-2">
+                <div data-id="run-input-inputs-form">
                   <FormRenderer
                     jsonSchema={inputSchema as RJSFSchema}
                     handleChange={(v) => handleInputChange(v.formData)}
@@ -96,7 +114,10 @@ export const RunInputDialog = ({
             )}
 
             {/* Action Button */}
-            <div className="flex justify-end pt-2">
+            <div
+              className="flex justify-end pt-2"
+              data-id="run-input-actions-section"
+            >
               {purpose === "run" && (
                 <Button
                   variant="primary"
@@ -104,6 +125,7 @@ export const RunInputDialog = ({
                   className="group h-fit min-w-0 gap-2"
                   onClick={handleManualRun}
                   loading={isExecutingGraph}
+                  data-id="run-input-manual-run-button"
                 >
                   {!isExecutingGraph && (
                     <PlayIcon className="size-5 transition-transform group-hover:scale-110" />
@@ -117,6 +139,7 @@ export const RunInputDialog = ({
                   size="large"
                   className="group h-fit min-w-0 gap-2"
                   onClick={() => setOpenCronSchedulerDialog(true)}
+                  data-id="run-input-schedule-button"
                 >
                   <ClockIcon className="size-5 transition-transform group-hover:scale-110" />
                   <span className="font-semibold">Schedule Run</span>
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/RunInputDialog/useRunInputDialog.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/RunInputDialog/useRunInputDialog.ts
index f0bb3b1c98..358fd3ae7e 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/RunInputDialog/useRunInputDialog.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/RunInputDialog/useRunInputDialog.ts
@@ -1,14 +1,18 @@
 import { useGraphStore } from "@/app/(platform)/build/stores/graphStore";
 import { usePostV1ExecuteGraphAgent } from "@/app/api/__generated__/endpoints/graphs/graphs";
-import { useToast } from "@/components/molecules/Toast/use-toast";
+
 import {
+  ApiError,
   CredentialsMetaInput,
   GraphExecutionMeta,
 } from "@/lib/autogpt-server-api";
 import { parseAsInteger, parseAsString, useQueryStates } from "nuqs";
 import { useMemo, useState } from "react";
 import { uiSchema } from "../../../FlowEditor/nodes/uiSchema";
-import { isCredentialFieldSchema } from "@/components/renderers/input-renderer/fields/CredentialField/helpers";
+import { isCredentialFieldSchema } from "@/components/renderers/InputRenderer/custom/CredentialField/helpers";
+import { useNodeStore } from "@/app/(platform)/build/stores/nodeStore";
+import { useToast } from "@/components/molecules/Toast/use-toast";
+import { useReactFlow } from "@xyflow/react";
 
 export const useRunInputDialog = ({
   setIsOpen,
@@ -31,6 +35,7 @@ export const useRunInputDialog = ({
     flowVersion: parseAsInteger,
   });
   const { toast } = useToast();
+  const { setViewport } = useReactFlow();
 
   const { mutateAsync: executeGraph, isPending: isExecutingGraph } =
     usePostV1ExecuteGraphAgent({
@@ -42,13 +47,75 @@ export const useRunInputDialog = ({
           });
         },
         onError: (error) => {
-          // Reset running state on error
+          if (error instanceof ApiError && error.isGraphValidationError()) {
+            const errorData = error.response?.detail || {
+              node_errors: {},
+              message: undefined,
+            };
+            const nodeErrors = errorData.node_errors || {};
+
+            if (Object.keys(nodeErrors).length > 0) {
+              Object.entries(nodeErrors).forEach(
+                ([nodeId, nodeErrorsForNode]) => {
+                  useNodeStore
+                    .getState()
+                    .updateNodeErrors(
+                      nodeId,
+                      nodeErrorsForNode as { [key: string]: string },
+                    );
+                },
+              );
+            } else {
+              useNodeStore.getState().nodes.forEach((node) => {
+                useNodeStore.getState().updateNodeErrors(node.id, {});
+              });
+            }
+
+            toast({
+              title: errorData?.message || "Graph validation failed",
+              description:
+                "Please fix the validation errors on the highlighted nodes and try again.",
+              variant: "destructive",
+            });
+            setIsOpen(false);
+
+            const firstBackendId = Object.keys(nodeErrors)[0];
+
+            if (firstBackendId) {
+              const firstErrorNode = useNodeStore
+                .getState()
+                .nodes.find(
+                  (n) =>
+                    n.data.metadata?.backend_id === firstBackendId ||
+                    n.id === firstBackendId,
+                );
+
+              if (firstErrorNode) {
+                setTimeout(() => {
+                  setViewport(
+                    {
+                      x:
+                        -firstErrorNode.position.x * 0.8 +
+                        window.innerWidth / 2 -
+                        150,
+                      y: -firstErrorNode.position.y * 0.8 + 50,
+                      zoom: 0.8,
+                    },
+                    { duration: 500 },
+                  );
+                }, 50);
+              }
+            }
+          } else {
+            toast({
+              title: "Error running graph",
+              description:
+                (error as Error).message || "An unexpected error occurred.",
+              variant: "destructive",
+            });
+            setIsOpen(false);
+          }
           setIsGraphRunning(false);
-          toast({
-            title: (error.detail as string) ?? "An unexpected error occurred.",
-            description: "An unexpected error occurred.",
-            variant: "destructive",
-          });
         },
       },
     });
@@ -66,7 +133,7 @@ export const useRunInputDialog = ({
         if (isCredentialFieldSchema(fieldSchema)) {
           dynamicUiSchema[fieldName] = {
             ...dynamicUiSchema[fieldName],
-            "ui:field": "credentials",
+            "ui:field": "custom/credential_field",
           };
         }
       });
@@ -76,12 +143,18 @@ export const useRunInputDialog = ({
   }, [credentialsSchema]);
 
   const handleManualRun = async () => {
+    // Filter out incomplete credentials (those without a valid id)
+    // RJSF auto-populates const values (provider, type) but not id field
+    const validCredentials = Object.fromEntries(
+      Object.entries(credentialValues).filter(([_, cred]) => cred && cred.id),
+    );
+
     await executeGraph({
       graphId: flowID ?? "",
       graphVersion: flowVersion || null,
       data: {
         inputs: inputValues,
-        credentials_inputs: credentialValues,
+        credentials_inputs: validCredentials,
         source: "builder",
       },
     });
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/ScheduleGraph/ScheduleGraph.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/ScheduleGraph/ScheduleGraph.tsx
index be588fa9e7..854917154e 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/ScheduleGraph/ScheduleGraph.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderActions/components/ScheduleGraph/ScheduleGraph.tsx
@@ -1,14 +1,14 @@
-import { ClockIcon } from "@phosphor-icons/react";
-import { RunInputDialog } from "../RunInputDialog/RunInputDialog";
-import { useScheduleGraph } from "./useScheduleGraph";
+import { Button } from "@/components/atoms/Button/Button";
 import {
   Tooltip,
   TooltipContent,
   TooltipProvider,
   TooltipTrigger,
 } from "@/components/atoms/Tooltip/BaseTooltip";
+import { ClockIcon } from "@phosphor-icons/react";
 import { CronSchedulerDialog } from "../CronSchedulerDialog/CronSchedulerDialog";
-import { BuilderActionButton } from "../BuilderActionButton";
+import { RunInputDialog } from "../RunInputDialog/RunInputDialog";
+import { useScheduleGraph } from "./useScheduleGraph";
 
 export const ScheduleGraph = ({ flowID }: { flowID: string | null }) => {
   const {
@@ -23,12 +23,15 @@ export const ScheduleGraph = ({ flowID }: { flowID: string | null }) => {
       <TooltipProvider>
         <Tooltip>
           <TooltipTrigger asChild>
-            <BuilderActionButton
+            <Button
+              variant="outline"
+              size="icon"
+              data-id="schedule-graph-button"
               onClick={handleScheduleGraph}
               disabled={!flowID}
             >
-              <ClockIcon className="size-6" />
-            </BuilderActionButton>
+              <ClockIcon className="size-4" />
+            </Button>
           </TooltipTrigger>
           <TooltipContent>
             <p>Schedule Graph</p>
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/DraftRecoveryDialog/DraftRecoveryPopup.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/DraftRecoveryDialog/DraftRecoveryPopup.tsx
new file mode 100644
index 0000000000..905d1d4680
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/DraftRecoveryDialog/DraftRecoveryPopup.tsx
@@ -0,0 +1,160 @@
+"use client";
+
+import { Button } from "@/components/atoms/Button/Button";
+import { ClockCounterClockwiseIcon, XIcon } from "@phosphor-icons/react";
+import { cn } from "@/lib/utils";
+import { formatTimeAgo } from "@/lib/utils/time";
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipTrigger,
+} from "@/components/atoms/Tooltip/BaseTooltip";
+import { useDraftRecoveryPopup } from "./useDraftRecoveryPopup";
+import { Text } from "@/components/atoms/Text/Text";
+import { AnimatePresence, motion } from "framer-motion";
+import { DraftDiff } from "@/lib/dexie/draft-utils";
+
+interface DraftRecoveryPopupProps {
+  isInitialLoadComplete: boolean;
+}
+
+function formatDiffSummary(diff: DraftDiff | null): string {
+  if (!diff) return "";
+
+  const parts: string[] = [];
+
+  // Node changes
+  const nodeChanges: string[] = [];
+  if (diff.nodes.added > 0) nodeChanges.push(`+${diff.nodes.added}`);
+  if (diff.nodes.removed > 0) nodeChanges.push(`-${diff.nodes.removed}`);
+  if (diff.nodes.modified > 0) nodeChanges.push(`~${diff.nodes.modified}`);
+
+  if (nodeChanges.length > 0) {
+    parts.push(
+      `${nodeChanges.join("/")} block${diff.nodes.added + diff.nodes.removed + diff.nodes.modified !== 1 ? "s" : ""}`,
+    );
+  }
+
+  // Edge changes
+  const edgeChanges: string[] = [];
+  if (diff.edges.added > 0) edgeChanges.push(`+${diff.edges.added}`);
+  if (diff.edges.removed > 0) edgeChanges.push(`-${diff.edges.removed}`);
+  if (diff.edges.modified > 0) edgeChanges.push(`~${diff.edges.modified}`);
+
+  if (edgeChanges.length > 0) {
+    parts.push(
+      `${edgeChanges.join("/")} connection${diff.edges.added + diff.edges.removed + diff.edges.modified !== 1 ? "s" : ""}`,
+    );
+  }
+
+  return parts.join(", ");
+}
+
+export function DraftRecoveryPopup({
+  isInitialLoadComplete,
+}: DraftRecoveryPopupProps) {
+  const {
+    isOpen,
+    popupRef,
+    nodeCount,
+    edgeCount,
+    diff,
+    savedAt,
+    onLoad,
+    onDiscard,
+  } = useDraftRecoveryPopup(isInitialLoadComplete);
+
+  const diffSummary = formatDiffSummary(diff);
+
+  return (
+    <AnimatePresence>
+      {isOpen && (
+        <motion.div
+          ref={popupRef}
+          className={cn("absolute left-1/2 top-4 z-50")}
+          initial={{
+            opacity: 0,
+            x: "-50%",
+            y: "-150%",
+            scale: 0.5,
+            filter: "blur(20px)",
+          }}
+          animate={{
+            opacity: 1,
+            x: "-50%",
+            y: "0%",
+            scale: 1,
+            filter: "blur(0px)",
+          }}
+          exit={{
+            opacity: 0,
+            y: "-150%",
+            scale: 0.5,
+            filter: "blur(20px)",
+            transition: { duration: 0.4, type: "spring", bounce: 0.2 },
+          }}
+          transition={{ duration: 0.2, type: "spring", bounce: 0.2 }}
+        >
+          <div
+            className={cn(
+              "flex items-center gap-3 rounded-xlarge border border-amber-200 bg-amber-50 px-4 py-3 shadow-lg",
+            )}
+          >
+            <div className="flex items-center gap-2 text-amber-700 dark:text-amber-300">
+              <ClockCounterClockwiseIcon className="h-5 w-5" weight="fill" />
+            </div>
+
+            <div className="flex flex-col">
+              <Text
+                variant="small-medium"
+                className="text-amber-900 dark:text-amber-100"
+              >
+                Unsaved changes found
+              </Text>
+              <Text
+                variant="small"
+                className="text-amber-700 dark:text-amber-400"
+              >
+                {diffSummary ||
+                  `${nodeCount} block${nodeCount !== 1 ? "s" : ""}, ${edgeCount} connection${edgeCount !== 1 ? "s" : ""}`}{" "}
+                • {formatTimeAgo(new Date(savedAt).toISOString())}
+              </Text>
+            </div>
+
+            <div className="ml-2 flex items-center gap-2">
+              <Tooltip delayDuration={10}>
+                <TooltipTrigger asChild>
+                  <Button
+                    variant="primary"
+                    size="small"
+                    onClick={onLoad}
+                    className="aspect-square min-w-0 p-1.5"
+                  >
+                    <ClockCounterClockwiseIcon size={20} weight="fill" />
+                    <span className="sr-only">Restore changes</span>
+                  </Button>
+                </TooltipTrigger>
+                <TooltipContent>Restore changes</TooltipContent>
+              </Tooltip>
+              <Tooltip delayDuration={10}>
+                <TooltipTrigger asChild>
+                  <Button
+                    variant="destructive"
+                    size="icon"
+                    onClick={onDiscard}
+                    aria-label="Discard changes"
+                    className="aspect-square min-w-0 p-1.5"
+                  >
+                    <XIcon size={20} />
+                    <span className="sr-only">Discard changes</span>
+                  </Button>
+                </TooltipTrigger>
+                <TooltipContent>Discard changes</TooltipContent>
+              </Tooltip>
+            </div>
+          </div>
+        </motion.div>
+      )}
+    </AnimatePresence>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/DraftRecoveryDialog/useDraftRecoveryPopup.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/DraftRecoveryDialog/useDraftRecoveryPopup.tsx
new file mode 100644
index 0000000000..7a77f7b4cc
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/DraftRecoveryDialog/useDraftRecoveryPopup.tsx
@@ -0,0 +1,63 @@
+import { useEffect, useRef } from "react";
+import { useDraftManager } from "../FlowEditor/Flow/useDraftManager";
+
+export const useDraftRecoveryPopup = (isInitialLoadComplete: boolean) => {
+  const popupRef = useRef<HTMLDivElement>(null);
+
+  const {
+    isRecoveryOpen: isOpen,
+    savedAt,
+    nodeCount,
+    edgeCount,
+    diff,
+    loadDraft: onLoad,
+    discardDraft: onDiscard,
+  } = useDraftManager(isInitialLoadComplete);
+
+  useEffect(() => {
+    if (!isOpen) return;
+
+    const handleClickOutside = (event: MouseEvent) => {
+      if (
+        popupRef.current &&
+        !popupRef.current.contains(event.target as Node)
+      ) {
+        onDiscard();
+      }
+    };
+
+    const timeoutId = setTimeout(() => {
+      document.addEventListener("mousedown", handleClickOutside);
+    }, 100);
+
+    return () => {
+      clearTimeout(timeoutId);
+      document.removeEventListener("mousedown", handleClickOutside);
+    };
+  }, [isOpen, onDiscard]);
+
+  useEffect(() => {
+    if (!isOpen) return;
+
+    const handleKeyDown = (event: KeyboardEvent) => {
+      if (event.key === "Escape") {
+        onDiscard();
+      }
+    };
+
+    document.addEventListener("keydown", handleKeyDown);
+    return () => {
+      document.removeEventListener("keydown", handleKeyDown);
+    };
+  }, [isOpen, onDiscard]);
+  return {
+    popupRef,
+    isOpen,
+    nodeCount,
+    edgeCount,
+    diff,
+    savedAt,
+    onLoad,
+    onDiscard,
+  };
+};
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/Flow.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/Flow.tsx
index c9cf5296c6..87ae4300b8 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/Flow.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/Flow.tsx
@@ -1,26 +1,27 @@
-import { ReactFlow, Background } from "@xyflow/react";
-import NewControlPanel from "../../NewControlPanel/NewControlPanel";
-import CustomEdge from "../edges/CustomEdge";
-import { useFlow } from "./useFlow";
-import { useShallow } from "zustand/react/shallow";
-import { useNodeStore } from "../../../stores/nodeStore";
-import { useMemo, useEffect, useCallback } from "react";
-import { CustomNode } from "../nodes/CustomNode/CustomNode";
-import { useCustomEdge } from "../edges/useCustomEdge";
-import { useFlowRealtime } from "./useFlowRealtime";
-import { GraphLoadingBox } from "./components/GraphLoadingBox";
-import { BuilderActions } from "../../BuilderActions/BuilderActions";
-import { RunningBackground } from "./components/RunningBackground";
-import { useGraphStore } from "../../../stores/graphStore";
-import { useCopyPaste } from "./useCopyPaste";
-import { FloatingReviewsPanel } from "@/components/organisms/FloatingReviewsPanel/FloatingReviewsPanel";
-import { parseAsString, useQueryStates } from "nuqs";
-import { CustomControls } from "./components/CustomControl";
 import { useGetV1GetSpecificGraph } from "@/app/api/__generated__/endpoints/graphs/graphs";
 import { okData } from "@/app/api/helpers";
+import { FloatingReviewsPanel } from "@/components/organisms/FloatingReviewsPanel/FloatingReviewsPanel";
+import { Background, ReactFlow } from "@xyflow/react";
+import { parseAsString, useQueryStates } from "nuqs";
+import { useCallback, useMemo } from "react";
+import { useShallow } from "zustand/react/shallow";
+import { useGraphStore } from "../../../stores/graphStore";
+import { useNodeStore } from "../../../stores/nodeStore";
+import { BuilderActions } from "../../BuilderActions/BuilderActions";
+import { DraftRecoveryPopup } from "../../DraftRecoveryDialog/DraftRecoveryPopup";
+import { FloatingSafeModeToggle } from "../../FloatingSafeModeToogle";
+import NewControlPanel from "../../NewControlPanel/NewControlPanel";
+import CustomEdge from "../edges/CustomEdge";
+import { useCustomEdge } from "../edges/useCustomEdge";
+import { CustomNode } from "../nodes/CustomNode/CustomNode";
+import { CustomControls } from "./components/CustomControl";
+import { GraphLoadingBox } from "./components/GraphLoadingBox";
+import { RunningBackground } from "./components/RunningBackground";
 import { TriggerAgentBanner } from "./components/TriggerAgentBanner";
 import { resolveCollisions } from "./helpers/resolve-collision";
-import { FloatingSafeModeToggle } from "../../FloatingSafeModeToogle";
+import { useCopyPaste } from "./useCopyPaste";
+import { useFlow } from "./useFlow";
+import { useFlowRealtime } from "./useFlowRealtime";
 
 export const Flow = () => {
   const [{ flowID, flowExecutionID }] = useQueryStates({
@@ -41,48 +42,51 @@ export const Flow = () => {
 
   const nodes = useNodeStore(useShallow((state) => state.nodes));
   const setNodes = useNodeStore(useShallow((state) => state.setNodes));
+
   const onNodesChange = useNodeStore(
     useShallow((state) => state.onNodesChange),
   );
+
   const hasWebhookNodes = useNodeStore(
     useShallow((state) => state.hasWebhookNodes()),
   );
+
   const nodeTypes = useMemo(() => ({ custom: CustomNode }), []);
   const edgeTypes = useMemo(() => ({ custom: CustomEdge }), []);
+
   const onNodeDragStop = useCallback(() => {
+    const currentNodes = useNodeStore.getState().nodes;
     setNodes(
-      resolveCollisions(nodes, {
+      resolveCollisions(currentNodes, {
         maxIterations: Infinity,
         overlapThreshold: 0.5,
         margin: 15,
       }),
     );
-  }, [setNodes, nodes]);
+  }, [setNodes]);
+
   const { edges, onConnect, onEdgesChange } = useCustomEdge();
 
-  // We use this hook to load the graph and convert them into custom nodes and edges.
-  const { onDragOver, onDrop, isFlowContentLoading, isLocked, setIsLocked } =
-    useFlow();
+  // for loading purpose
+  const {
+    onDragOver,
+    onDrop,
+    isFlowContentLoading,
+    isInitialLoadComplete,
+    isLocked,
+    setIsLocked,
+  } = useFlow();
 
   // This hook is used for websocket realtime updates.
   useFlowRealtime();
 
   // Copy/paste functionality
-  const handleCopyPaste = useCopyPaste();
+  useCopyPaste();
 
-  useEffect(() => {
-    const handleKeyDown = (event: KeyboardEvent) => {
-      handleCopyPaste(event);
-    };
-
-    window.addEventListener("keydown", handleKeyDown);
-    return () => {
-      window.removeEventListener("keydown", handleKeyDown);
-    };
-  }, [handleCopyPaste]);
   const isGraphRunning = useGraphStore(
     useShallow((state) => state.isGraphRunning),
   );
+
   return (
     <div className="flex h-full w-full dark:bg-slate-900">
       <div className="relative flex-1">
@@ -95,6 +99,9 @@ export const Flow = () => {
           onConnect={onConnect}
           onEdgesChange={onEdgesChange}
           onNodeDragStop={onNodeDragStop}
+          onNodeContextMenu={(event) => {
+            event.preventDefault();
+          }}
           maxZoom={2}
           minZoom={0.1}
           onDragOver={onDragOver}
@@ -102,6 +109,7 @@ export const Flow = () => {
           nodesDraggable={!isLocked}
           nodesConnectable={!isLocked}
           elementsSelectable={!isLocked}
+          deleteKeyCode={["Backspace", "Delete"]}
         >
           <Background />
           <CustomControls setIsLocked={setIsLocked} isLocked={isLocked} />
@@ -115,6 +123,7 @@ export const Flow = () => {
               className="right-2 top-32 p-2"
             />
           )}
+          <DraftRecoveryPopup isInitialLoadComplete={isInitialLoadComplete} />
         </ReactFlow>
       </div>
       {/* TODO: Need to update it in future - also do not send executionId as prop - rather use useQueryState inside the component */}
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/components/CustomControl.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/components/CustomControl.tsx
index c6f8e8ded4..50e2034f75 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/components/CustomControl.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/components/CustomControl.tsx
@@ -6,12 +6,17 @@ import {
   TooltipTrigger,
 } from "@/components/atoms/Tooltip/BaseTooltip";
 import {
+  ChalkboardIcon,
+  CircleNotchIcon,
   FrameCornersIcon,
   MinusIcon,
   PlusIcon,
 } from "@phosphor-icons/react/dist/ssr";
 import { LockIcon, LockOpenIcon } from "lucide-react";
-import { memo } from "react";
+import { memo, useEffect, useState } from "react";
+import { useSearchParams, useRouter } from "next/navigation";
+import { useTutorialStore } from "@/app/(platform)/build/stores/tutorialStore";
+import { startTutorial, setTutorialLoadingCallback } from "../../tutorial";
 
 export const CustomControls = memo(
   ({
@@ -22,27 +27,65 @@ export const CustomControls = memo(
     setIsLocked: (isLocked: boolean) => void;
   }) => {
     const { zoomIn, zoomOut, fitView } = useReactFlow();
+    const { isTutorialRunning, setIsTutorialRunning } = useTutorialStore();
+    const [isTutorialLoading, setIsTutorialLoading] = useState(false);
+    const searchParams = useSearchParams();
+    const router = useRouter();
+
+    useEffect(() => {
+      setTutorialLoadingCallback(setIsTutorialLoading);
+      return () => setTutorialLoadingCallback(() => {});
+    }, []);
+
+    const handleTutorialClick = () => {
+      if (isTutorialLoading) return;
+
+      const flowId = searchParams.get("flowID");
+      if (flowId) {
+        router.push("/build?view=new");
+        return;
+      }
+
+      startTutorial();
+      setIsTutorialRunning(true);
+    };
 
     const controls = [
       {
+        id: "zoom-in-button",
         icon: <PlusIcon className="size-4" />,
         label: "Zoom In",
         onClick: () => zoomIn(),
         className: "h-10 w-10 border-none",
       },
       {
+        id: "zoom-out-button",
         icon: <MinusIcon className="size-4" />,
         label: "Zoom Out",
         onClick: () => zoomOut(),
         className: "h-10 w-10 border-none",
       },
       {
+        id: "tutorial-button",
+        icon: isTutorialLoading ? (
+          <CircleNotchIcon className="size-4 animate-spin" />
+        ) : (
+          <ChalkboardIcon className="size-4" />
+        ),
+        label: isTutorialLoading ? "Loading Tutorial..." : "Start Tutorial",
+        onClick: handleTutorialClick,
+        className: `h-10 w-10 border-none ${isTutorialRunning || isTutorialLoading ? "bg-zinc-100" : "bg-white"}`,
+        disabled: isTutorialLoading,
+      },
+      {
+        id: "fit-view-button",
         icon: <FrameCornersIcon className="size-4" />,
         label: "Fit View",
         onClick: () => fitView({ padding: 0.2, duration: 800, maxZoom: 1 }),
         className: "h-10 w-10 border-none",
       },
       {
+        id: "lock-button",
         icon: !isLocked ? (
           <LockOpenIcon className="size-4" />
         ) : (
@@ -55,15 +98,20 @@ export const CustomControls = memo(
     ];
 
     return (
-      <div className="absolute bottom-4 left-4 z-10 flex flex-col items-center gap-2 rounded-full bg-white px-1 py-2 shadow-lg">
-        {controls.map((control, index) => (
-          <Tooltip key={index} delayDuration={300}>
+      <div
+        data-id="custom-controls"
+        className="absolute bottom-4 left-4 z-10 flex flex-col items-center gap-2 rounded-full bg-white px-1 py-2 shadow-lg"
+      >
+        {controls.map((control) => (
+          <Tooltip key={control.id} delayDuration={0}>
             <TooltipTrigger asChild>
               <Button
                 variant="icon"
                 size={"small"}
                 onClick={control.onClick}
                 className={control.className}
+                data-id={control.id}
+                disabled={"disabled" in control ? control.disabled : false}
               >
                 {control.icon}
                 <span className="sr-only">{control.label}</span>
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/helpers/resolve-collision.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/helpers/resolve-collision.ts
index c05f00b5fb..890d1982c8 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/helpers/resolve-collision.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/helpers/resolve-collision.ts
@@ -48,8 +48,6 @@ export const resolveCollisions: CollisionAlgorithm = (
     const width = (node.width ?? node.measured?.width ?? 0) + margin * 2;
     const height = (node.height ?? node.measured?.height ?? 0) + margin * 2;
 
-    console.log("width", width);
-    console.log("height", height);
     const x = node.position.x - margin;
     const y = node.position.y - margin;
 
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/useCopyPaste.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/useCopyPaste.ts
index 7a8213da22..c6c54006d4 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/useCopyPaste.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/useCopyPaste.ts
@@ -1,4 +1,4 @@
-import { useCallback } from "react";
+import { useCallback, useEffect } from "react";
 import { useReactFlow } from "@xyflow/react";
 import { v4 as uuidv4 } from "uuid";
 import { useNodeStore } from "../../../stores/nodeStore";
@@ -151,5 +151,16 @@ export function useCopyPaste() {
     [getViewport, toast],
   );
 
+  useEffect(() => {
+    const handleKeyDown = (event: KeyboardEvent) => {
+      handleCopyPaste(event);
+    };
+
+    window.addEventListener("keydown", handleKeyDown);
+    return () => {
+      window.removeEventListener("keydown", handleKeyDown);
+    };
+  }, [handleCopyPaste]);
+
   return handleCopyPaste;
 }
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/useDraftManager.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/useDraftManager.ts
new file mode 100644
index 0000000000..a38def74f6
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/useDraftManager.ts
@@ -0,0 +1,319 @@
+import { useState, useCallback, useEffect, useRef } from "react";
+import { parseAsString, parseAsInteger, useQueryStates } from "nuqs";
+import {
+  draftService,
+  getTempFlowId,
+  getOrCreateTempFlowId,
+  DraftData,
+} from "@/services/builder-draft/draft-service";
+import { BuilderDraft } from "@/lib/dexie/db";
+import {
+  cleanNodes,
+  cleanEdges,
+  calculateDraftDiff,
+  DraftDiff,
+} from "@/lib/dexie/draft-utils";
+import { useNodeStore } from "../../../stores/nodeStore";
+import { useEdgeStore } from "../../../stores/edgeStore";
+import { useGraphStore } from "../../../stores/graphStore";
+import { useHistoryStore } from "../../../stores/historyStore";
+import isEqual from "lodash/isEqual";
+
+const AUTO_SAVE_INTERVAL_MS = 15000; // 15 seconds
+
+interface DraftRecoveryState {
+  isOpen: boolean;
+  draft: BuilderDraft | null;
+  diff: DraftDiff | null;
+}
+
+/**
+ * Consolidated hook for draft persistence and recovery
+ * - Auto-saves builder state every 15 seconds
+ * - Saves on beforeunload event
+ * - Checks for and manages unsaved drafts on load
+ */
+export function useDraftManager(isInitialLoadComplete: boolean) {
+  const [state, setState] = useState<DraftRecoveryState>({
+    isOpen: false,
+    draft: null,
+    diff: null,
+  });
+
+  const [{ flowID, flowVersion }] = useQueryStates({
+    flowID: parseAsString,
+    flowVersion: parseAsInteger,
+  });
+
+  const lastSavedStateRef = useRef<DraftData | null>(null);
+  const saveTimeoutRef = useRef<NodeJS.Timeout | null>(null);
+  const isDirtyRef = useRef(false);
+  const hasCheckedForDraft = useRef(false);
+
+  const getEffectiveFlowId = useCallback((): string => {
+    return flowID || getOrCreateTempFlowId();
+  }, [flowID]);
+
+  const getCurrentState = useCallback((): DraftData => {
+    const nodes = useNodeStore.getState().nodes;
+    const edges = useEdgeStore.getState().edges;
+    const nodeCounter = useNodeStore.getState().nodeCounter;
+    const graphStore = useGraphStore.getState();
+
+    return {
+      nodes,
+      edges,
+      graphSchemas: {
+        input: graphStore.inputSchema,
+        credentials: graphStore.credentialsInputSchema,
+        output: graphStore.outputSchema,
+      },
+      nodeCounter,
+      flowVersion: flowVersion ?? undefined,
+    };
+  }, [flowVersion]);
+
+  const cleanStateForComparison = useCallback((stateData: DraftData) => {
+    return {
+      nodes: cleanNodes(stateData.nodes),
+      edges: cleanEdges(stateData.edges),
+    };
+  }, []);
+
+  const hasChanges = useCallback((): boolean => {
+    const currentState = getCurrentState();
+
+    if (!lastSavedStateRef.current) {
+      return currentState.nodes.length > 0;
+    }
+
+    const currentClean = cleanStateForComparison(currentState);
+    const lastClean = cleanStateForComparison(lastSavedStateRef.current);
+
+    return !isEqual(currentClean, lastClean);
+  }, [getCurrentState, cleanStateForComparison]);
+
+  const saveDraft = useCallback(async () => {
+    const effectiveFlowId = getEffectiveFlowId();
+    const currentState = getCurrentState();
+
+    if (currentState.nodes.length === 0 && currentState.edges.length === 0) {
+      return;
+    }
+
+    if (!hasChanges()) {
+      return;
+    }
+
+    try {
+      await draftService.saveDraft(effectiveFlowId, currentState);
+      lastSavedStateRef.current = currentState;
+      isDirtyRef.current = false;
+    } catch (error) {
+      console.error("[DraftPersistence] Failed to save draft:", error);
+    }
+  }, [getEffectiveFlowId, getCurrentState, hasChanges]);
+
+  const scheduleSave = useCallback(() => {
+    isDirtyRef.current = true;
+
+    if (saveTimeoutRef.current) {
+      clearTimeout(saveTimeoutRef.current);
+    }
+
+    saveTimeoutRef.current = setTimeout(() => {
+      saveDraft();
+    }, AUTO_SAVE_INTERVAL_MS);
+  }, [saveDraft]);
+
+  useEffect(() => {
+    const unsubscribeNodes = useNodeStore.subscribe((storeState, prevState) => {
+      if (storeState.nodes !== prevState.nodes) {
+        scheduleSave();
+      }
+    });
+
+    const unsubscribeEdges = useEdgeStore.subscribe((storeState, prevState) => {
+      if (storeState.edges !== prevState.edges) {
+        scheduleSave();
+      }
+    });
+
+    return () => {
+      unsubscribeNodes();
+      unsubscribeEdges();
+    };
+  }, [scheduleSave]);
+
+  useEffect(() => {
+    const handleBeforeUnload = () => {
+      if (isDirtyRef.current) {
+        const effectiveFlowId = getEffectiveFlowId();
+        const currentState = getCurrentState();
+
+        if (
+          currentState.nodes.length === 0 &&
+          currentState.edges.length === 0
+        ) {
+          return;
+        }
+
+        draftService.saveDraft(effectiveFlowId, currentState).catch(() => {
+          // Ignore errors on unload
+        });
+      }
+    };
+
+    window.addEventListener("beforeunload", handleBeforeUnload);
+    return () => {
+      window.removeEventListener("beforeunload", handleBeforeUnload);
+    };
+  }, [getEffectiveFlowId, getCurrentState]);
+
+  useEffect(() => {
+    return () => {
+      if (saveTimeoutRef.current) {
+        clearTimeout(saveTimeoutRef.current);
+      }
+      if (isDirtyRef.current) {
+        saveDraft();
+      }
+    };
+  }, [saveDraft]);
+
+  useEffect(() => {
+    draftService.cleanupExpired().catch((error) => {
+      console.error(
+        "[DraftPersistence] Failed to cleanup expired drafts:",
+        error,
+      );
+    });
+  }, []);
+
+  const checkForDraft = useCallback(async () => {
+    const effectiveFlowId = flowID || getTempFlowId();
+
+    if (!effectiveFlowId) {
+      return;
+    }
+
+    try {
+      const draft = await draftService.loadDraft(effectiveFlowId);
+
+      if (!draft) {
+        return;
+      }
+
+      const currentNodes = useNodeStore.getState().nodes;
+      const currentEdges = useEdgeStore.getState().edges;
+
+      const isDifferent = draftService.isDraftDifferent(
+        draft,
+        currentNodes,
+        currentEdges,
+      );
+
+      if (isDifferent && (draft.nodes.length > 0 || draft.edges.length > 0)) {
+        const diff = calculateDraftDiff(
+          draft.nodes,
+          draft.edges,
+          currentNodes,
+          currentEdges,
+        );
+        setState({
+          isOpen: true,
+          draft,
+          diff,
+        });
+      } else {
+        await draftService.deleteDraft(effectiveFlowId);
+      }
+    } catch (error) {
+      console.error("[DraftRecovery] Failed to check for draft:", error);
+    }
+  }, [flowID]);
+
+  useEffect(() => {
+    if (isInitialLoadComplete && !hasCheckedForDraft.current) {
+      hasCheckedForDraft.current = true;
+      checkForDraft();
+    }
+  }, [isInitialLoadComplete, checkForDraft]);
+
+  useEffect(() => {
+    hasCheckedForDraft.current = false;
+    setState({
+      isOpen: false,
+      draft: null,
+      diff: null,
+    });
+  }, [flowID]);
+
+  const loadDraft = useCallback(async () => {
+    if (!state.draft) return;
+
+    const { draft } = state;
+
+    try {
+      useNodeStore.getState().setNodes(draft.nodes);
+      useEdgeStore.getState().setEdges(draft.edges);
+      draft.nodes.forEach((node) => {
+        useNodeStore.getState().syncHardcodedValuesWithHandleIds(node.id);
+      });
+
+      if (draft.nodeCounter !== undefined) {
+        useNodeStore.setState({ nodeCounter: draft.nodeCounter });
+      }
+
+      if (draft.graphSchemas) {
+        useGraphStore
+          .getState()
+          .setGraphSchemas(
+            draft.graphSchemas.input as Record<string, unknown> | null,
+            draft.graphSchemas.credentials as Record<string, unknown> | null,
+            draft.graphSchemas.output as Record<string, unknown> | null,
+          );
+      }
+
+      setTimeout(() => {
+        useHistoryStore.getState().initializeHistory();
+      }, 100);
+
+      await draftService.deleteDraft(draft.id);
+
+      setState({
+        isOpen: false,
+        draft: null,
+        diff: null,
+      });
+    } catch (error) {
+      console.error("[DraftRecovery] Failed to load draft:", error);
+    }
+  }, [state.draft]);
+
+  const discardDraft = useCallback(async () => {
+    if (!state.draft) {
+      setState({ isOpen: false, draft: null, diff: null });
+      return;
+    }
+
+    try {
+      await draftService.deleteDraft(state.draft.id);
+    } catch (error) {
+      console.error("[DraftRecovery] Failed to discard draft:", error);
+    }
+
+    setState({ isOpen: false, draft: null, diff: null });
+  }, [state.draft]);
+
+  return {
+    // Recovery popup props
+    isRecoveryOpen: state.isOpen,
+    savedAt: state.draft?.savedAt ?? 0,
+    nodeCount: state.draft?.nodes.length ?? 0,
+    edgeCount: state.draft?.edges.length ?? 0,
+    diff: state.diff,
+    loadDraft,
+    discardDraft,
+  };
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/useFlow.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/useFlow.ts
index be76c4ec2b..694c1be81b 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/useFlow.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/Flow/useFlow.ts
@@ -3,6 +3,7 @@ import { useGetV2GetSpecificBlocks } from "@/app/api/__generated__/endpoints/def
 import {
   useGetV1GetExecutionDetails,
   useGetV1GetSpecificGraph,
+  useGetV1ListUserGraphs,
 } from "@/app/api/__generated__/endpoints/graphs/graphs";
 import { BlockInfo } from "@/app/api/__generated__/models/blockInfo";
 import { GraphModel } from "@/app/api/__generated__/models/graphModel";
@@ -17,10 +18,12 @@ import { useReactFlow } from "@xyflow/react";
 import { useControlPanelStore } from "../../../stores/controlPanelStore";
 import { useHistoryStore } from "../../../stores/historyStore";
 import { AgentExecutionStatus } from "@/app/api/__generated__/models/agentExecutionStatus";
+import { okData } from "@/app/api/helpers";
 
 export const useFlow = () => {
   const [isLocked, setIsLocked] = useState(false);
   const [hasAutoFramed, setHasAutoFramed] = useState(false);
+  const [isInitialLoadComplete, setIsInitialLoadComplete] = useState(false);
   const addNodes = useNodeStore(useShallow((state) => state.addNodes));
   const addLinks = useEdgeStore(useShallow((state) => state.addLinks));
   const updateNodeStatus = useNodeStore(
@@ -35,6 +38,9 @@ export const useFlow = () => {
   const setGraphExecutionStatus = useGraphStore(
     useShallow((state) => state.setGraphExecutionStatus),
   );
+  const setAvailableSubGraphs = useGraphStore(
+    useShallow((state) => state.setAvailableSubGraphs),
+  );
   const updateEdgeBeads = useEdgeStore(
     useShallow((state) => state.updateEdgeBeads),
   );
@@ -61,6 +67,11 @@ export const useFlow = () => {
     },
   );
 
+  // Fetch all available graphs for sub-agent update detection
+  const { data: availableGraphs } = useGetV1ListUserGraphs({
+    query: { select: okData },
+  });
+
   const { data: graph, isLoading: isGraphLoading } = useGetV1GetSpecificGraph(
     flowID ?? "",
     flowVersion !== null ? { version: flowVersion } : {},
@@ -115,11 +126,27 @@ export const useFlow = () => {
     }
   }, [graph]);
 
+  // Update available sub-graphs in store for sub-agent update detection
+  useEffect(() => {
+    if (availableGraphs) {
+      setAvailableSubGraphs(availableGraphs);
+    }
+  }, [availableGraphs, setAvailableSubGraphs]);
+
   // adding nodes
   useEffect(() => {
     if (customNodes.length > 0) {
       useNodeStore.getState().setNodes([]);
+      useNodeStore.getState().clearResolutionState();
       addNodes(customNodes);
+
+      // Sync hardcoded values with handle IDs.
+      // If a key–value field has a key without a value, the backend omits it from hardcoded values.
+      // But if a handleId exists for that key, it causes inconsistency.
+      // This ensures hardcoded values stay in sync with handle IDs.
+      customNodes.forEach((node) => {
+        useNodeStore.getState().syncHardcodedValuesWithHandleIds(node.id);
+      });
     }
   }, [customNodes, addNodes]);
 
@@ -174,14 +201,27 @@ export const useFlow = () => {
     if (customNodes.length > 0 && graph?.links) {
       const timer = setTimeout(() => {
         useHistoryStore.getState().initializeHistory();
+        // Mark initial load as complete after history is initialized
+        setIsInitialLoadComplete(true);
       }, 100);
       return () => clearTimeout(timer);
     }
   }, [customNodes, graph?.links]);
 
+  // Also mark as complete for new flows (no flowID) after a short delay
+  useEffect(() => {
+    if (!flowID && !isGraphLoading && !isBlocksLoading) {
+      const timer = setTimeout(() => {
+        setIsInitialLoadComplete(true);
+      }, 200);
+      return () => clearTimeout(timer);
+    }
+  }, [flowID, isGraphLoading, isBlocksLoading]);
+
   useEffect(() => {
     return () => {
       useNodeStore.getState().setNodes([]);
+      useNodeStore.getState().clearResolutionState();
       useEdgeStore.getState().setEdges([]);
       useGraphStore.getState().reset();
       useEdgeStore.getState().resetEdgeBeads();
@@ -217,6 +257,7 @@ export const useFlow = () => {
 
   useEffect(() => {
     setHasAutoFramed(false);
+    setIsInitialLoadComplete(false);
   }, [flowID, flowVersion]);
 
   // Drag and drop block from block menu
@@ -253,6 +294,7 @@ export const useFlow = () => {
 
   return {
     isFlowContentLoading: isGraphLoading || isBlocksLoading,
+    isInitialLoadComplete,
     onDragOver,
     onDrop,
     isLocked,
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/edges/CustomEdge.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/edges/CustomEdge.tsx
index ff80fdc8ac..eb221b5d34 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/edges/CustomEdge.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/edges/CustomEdge.tsx
@@ -8,6 +8,7 @@ import {
   getBezierPath,
 } from "@xyflow/react";
 import { useEdgeStore } from "@/app/(platform)/build/stores/edgeStore";
+import { useNodeStore } from "@/app/(platform)/build/stores/nodeStore";
 import { XIcon } from "@phosphor-icons/react";
 import { cn } from "@/lib/utils";
 import { NodeExecutionResult } from "@/lib/autogpt-server-api";
@@ -35,6 +36,8 @@ const CustomEdge = ({
   selected,
 }: EdgeProps<CustomEdge>) => {
   const removeConnection = useEdgeStore((state) => state.removeEdge);
+  // Subscribe to the brokenEdgeIDs map and check if this edge is broken across any node
+  const isBroken = useNodeStore((state) => state.isEdgeBroken(id));
   const [isHovered, setIsHovered] = useState(false);
 
   const [edgePath, labelX, labelY] = getBezierPath({
@@ -50,6 +53,12 @@ const CustomEdge = ({
   const beadUp = data?.beadUp ?? 0;
   const beadDown = data?.beadDown ?? 0;
 
+  const handleRemoveEdge = () => {
+    removeConnection(id);
+    // Note: broken edge tracking is cleaned up automatically by useSubAgentUpdateState
+    // when it detects the edge no longer exists
+  };
+
   return (
     <>
       <BaseEdge
@@ -57,9 +66,11 @@ const CustomEdge = ({
         markerEnd={markerEnd}
         className={cn(
           isStatic && "!stroke-[1.5px] [stroke-dasharray:6]",
-          selected
-            ? "stroke-zinc-800"
-            : "stroke-zinc-500/50 hover:stroke-zinc-500",
+          isBroken
+            ? "!stroke-red-500 !stroke-[2px] [stroke-dasharray:4]"
+            : selected
+              ? "stroke-zinc-800"
+              : "stroke-zinc-500/50 hover:stroke-zinc-500",
         )}
       />
       <JSBeads
@@ -70,12 +81,16 @@ const CustomEdge = ({
       />
       <EdgeLabelRenderer>
         <Button
-          onClick={() => removeConnection(id)}
+          onClick={handleRemoveEdge}
           className={cn(
             "absolute h-fit min-w-0 p-1 transition-opacity",
-            isHovered ? "opacity-100" : "opacity-0",
+            isBroken
+              ? "bg-red-500 opacity-100 hover:bg-red-600"
+              : isHovered
+                ? "opacity-100"
+                : "opacity-0",
           )}
-          variant="secondary"
+          variant={isBroken ? "primary" : "secondary"}
           style={{
             transform: `translate(-50%, -50%) translate(${labelX}px, ${labelY}px)`,
             pointerEvents: "all",
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/edges/useCustomEdge.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/edges/useCustomEdge.ts
index 8d27f346ef..d8571749d3 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/edges/useCustomEdge.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/edges/useCustomEdge.ts
@@ -1,12 +1,18 @@
-import { Connection as RFConnection, EdgeChange } from "@xyflow/react";
+import {
+  Connection as RFConnection,
+  EdgeChange,
+  applyEdgeChanges,
+} from "@xyflow/react";
 import { useEdgeStore } from "@/app/(platform)/build/stores/edgeStore";
 import { useCallback } from "react";
 import { useNodeStore } from "../../../stores/nodeStore";
+import { useHistoryStore } from "../../../stores/historyStore";
+import { CustomEdge } from "./CustomEdge";
 
 export const useCustomEdge = () => {
   const edges = useEdgeStore((s) => s.edges);
   const addEdge = useEdgeStore((s) => s.addEdge);
-  const removeEdge = useEdgeStore((s) => s.removeEdge);
+  const setEdges = useEdgeStore((s) => s.setEdges);
 
   const onConnect = useCallback(
     (conn: RFConnection) => {
@@ -45,14 +51,23 @@ export const useCustomEdge = () => {
   );
 
   const onEdgesChange = useCallback(
-    (changes: EdgeChange[]) => {
-      changes.forEach((change) => {
-        if (change.type === "remove") {
-          removeEdge(change.id);
-        }
-      });
+    (changes: EdgeChange<CustomEdge>[]) => {
+      const hasRemoval = changes.some((change) => change.type === "remove");
+
+      const prevState = hasRemoval
+        ? {
+            nodes: useNodeStore.getState().nodes,
+            edges: edges,
+          }
+        : null;
+
+      setEdges(applyEdgeChanges(changes, edges));
+
+      if (prevState) {
+        useHistoryStore.getState().pushState(prevState);
+      }
     },
-    [removeEdge],
+    [edges, setEdges],
   );
 
   return { edges, onConnect, onEdgesChange };
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/handlers/NodeHandle.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/handlers/NodeHandle.tsx
index 4eb2437b65..fdec177788 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/handlers/NodeHandle.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/handlers/NodeHandle.tsx
@@ -1,31 +1,83 @@
 import { CircleIcon } from "@phosphor-icons/react";
 import { Handle, Position } from "@xyflow/react";
+import { useEdgeStore } from "../../../stores/edgeStore";
+import { cleanUpHandleId } from "@/components/renderers/InputRenderer/helpers";
+import { cn } from "@/lib/utils";
+import { useNodeStore } from "../../../stores/nodeStore";
 
-const NodeHandle = ({
+const InputNodeHandle = ({
   handleId,
-  isConnected,
-  side,
+  nodeId,
 }: {
   handleId: string;
-  isConnected: boolean;
-  side: "left" | "right";
+  nodeId: string;
 }) => {
+  const cleanedHandleId = cleanUpHandleId(handleId);
+  const isInputConnected = useEdgeStore((state) =>
+    state.isInputConnected(nodeId ?? "", cleanedHandleId),
+  );
+  const isInputBroken = useNodeStore((state) =>
+    state.isInputBroken(nodeId, cleanedHandleId),
+  );
+
   return (
     <Handle
-      type={side === "left" ? "target" : "source"}
-      position={side === "left" ? Position.Left : Position.Right}
-      id={handleId}
-      className={side === "left" ? "-ml-4 mr-2" : "-mr-2 ml-2"}
+      type={"target"}
+      position={Position.Left}
+      id={cleanedHandleId}
+      className={"-ml-6 mr-2"}
+      data-tutorial-id={`input-handler-${nodeId}-${cleanedHandleId}`}
     >
       <div className="pointer-events-none">
         <CircleIcon
           size={16}
-          weight={isConnected ? "fill" : "duotone"}
-          className={"text-gray-400 opacity-100"}
+          weight={isInputConnected ? "fill" : "duotone"}
+          className={cn(
+            "text-gray-400 opacity-100",
+            isInputBroken && "text-red-500",
+          )}
         />
       </div>
     </Handle>
   );
 };
 
-export default NodeHandle;
+const OutputNodeHandle = ({
+  field_name,
+  nodeId,
+  hexColor,
+  isBroken,
+}: {
+  field_name: string;
+  nodeId: string;
+  hexColor: string;
+  isBroken: boolean;
+}) => {
+  const isOutputConnected = useEdgeStore((state) =>
+    state.isOutputConnected(nodeId, field_name),
+  );
+
+  return (
+    <Handle
+      type={"source"}
+      position={Position.Right}
+      id={field_name}
+      className={"-mr-2 ml-2"}
+      data-tutorial-id={`output-handler-${nodeId}-${field_name}`}
+    >
+      <div className="pointer-events-none">
+        <CircleIcon
+          size={16}
+          weight={"duotone"}
+          color={isOutputConnected ? hexColor : "gray"}
+          className={cn(
+            "text-gray-400 opacity-100",
+            isBroken && "text-red-500",
+          )}
+        />
+      </div>
+    </Handle>
+  );
+};
+
+export { InputNodeHandle, OutputNodeHandle };
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/handlers/helpers.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/handlers/helpers.ts
index ecacc83146..afaa85a38a 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/handlers/helpers.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/handlers/helpers.ts
@@ -1,31 +1,4 @@
-/**
- * Handle ID Types for different input structures
- *
- * Examples:
- * SIMPLE: "message"
- * NESTED: "config.api_key"
- * ARRAY: "items_$_0", "items_$_1"
- * KEY_VALUE: "headers_#_Authorization", "params_#_limit"
- *
- * Note: All handle IDs are sanitized to remove spaces and special characters.
- * Spaces become underscores, and special characters are removed.
- * Example: "user name" becomes "user_name", "email@domain.com" becomes "emaildomaincom"
- */
-export enum HandleIdType {
-  SIMPLE = "SIMPLE",
-  NESTED = "NESTED",
-  ARRAY = "ARRAY",
-  KEY_VALUE = "KEY_VALUE",
-}
-
-const fromRjsfId = (id: string): string => {
-  if (!id) return "";
-  const parts = id.split("_");
-  const filtered = parts.filter(
-    (p) => p !== "root" && p !== "properties" && p.length > 0,
-  );
-  return filtered.join("_") || "";
-};
+// Here we are handling single level of nesting, if need more in future then i will update it
 
 const sanitizeForHandleId = (str: string): string => {
   if (!str) return "";
@@ -38,51 +11,53 @@ const sanitizeForHandleId = (str: string): string => {
     .replace(/^_|_$/g, ""); // Remove leading/trailing underscores
 };
 
-export const generateHandleId = (
+const cleanTitleId = (id: string): string => {
+  if (!id) return "";
+
+  if (id.endsWith("_title")) {
+    id = id.slice(0, -6);
+  }
+  const parts = id.split("_");
+  const filtered = parts.filter(
+    (p) => p !== "root" && p !== "properties" && p.length > 0,
+  );
+  const filtered_id = filtered.join("_") || "";
+  return filtered_id;
+};
+
+export const generateHandleIdFromTitleId = (
   fieldKey: string,
-  nestedValues: string[] = [],
-  type: HandleIdType = HandleIdType.SIMPLE,
+  {
+    isObjectProperty,
+    isAdditionalProperty,
+    isArrayItem,
+  }: {
+    isArrayItem?: boolean;
+    isObjectProperty?: boolean;
+    isAdditionalProperty?: boolean;
+  } = {
+    isArrayItem: false,
+    isObjectProperty: false,
+    isAdditionalProperty: false,
+  },
 ): string => {
   if (!fieldKey) return "";
 
-  fieldKey = fromRjsfId(fieldKey);
-  fieldKey = sanitizeForHandleId(fieldKey);
+  const filteredKey = cleanTitleId(fieldKey);
+  if (isAdditionalProperty || isArrayItem) {
+    return filteredKey;
+  }
+  const cleanedKey = sanitizeForHandleId(filteredKey);
 
-  if (type === HandleIdType.SIMPLE || nestedValues.length === 0) {
-    return fieldKey;
+  if (isObjectProperty) {
+    // "config_api_key" -> "config.api_key"
+    const parts = cleanedKey.split("_");
+    if (parts.length >= 2) {
+      const baseName = parts[0];
+      const propertyName = parts.slice(1).join("_");
+      return `${baseName}.${propertyName}`;
+    }
   }
 
-  const sanitizedNestedValues = nestedValues.map((value) =>
-    sanitizeForHandleId(value),
-  );
-
-  switch (type) {
-    case HandleIdType.NESTED:
-      return [fieldKey, ...sanitizedNestedValues].join(".");
-
-    case HandleIdType.ARRAY:
-      return [fieldKey, ...sanitizedNestedValues].join("_$_");
-
-    case HandleIdType.KEY_VALUE:
-      return [fieldKey, ...sanitizedNestedValues].join("_#_");
-
-    default:
-      return fieldKey;
-  }
-};
-
-export const parseKeyValueHandleId = (
-  handleId: string,
-  type: HandleIdType,
-): string => {
-  if (type === HandleIdType.KEY_VALUE) {
-    return handleId.split("_#_")[1];
-  } else if (type === HandleIdType.ARRAY) {
-    return handleId.split("_$_")[1];
-  } else if (type === HandleIdType.NESTED) {
-    return handleId.split(".")[1];
-  } else if (type === HandleIdType.SIMPLE) {
-    return handleId.split("_")[1];
-  }
-  return "";
+  return cleanedKey;
 };
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/CustomNode.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/CustomNode.tsx
index 52068f3acb..6306582c3b 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/CustomNode.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/CustomNode.tsx
@@ -1,24 +1,27 @@
-import React from "react";
-import { Node as XYNode, NodeProps } from "@xyflow/react";
-import { RJSFSchema } from "@rjsf/utils";
-import { BlockUIType } from "../../../types";
-import { StickyNoteBlock } from "./components/StickyNoteBlock";
-import { BlockInfoCategoriesItem } from "@/app/api/__generated__/models/blockInfoCategoriesItem";
-import { BlockCost } from "@/app/api/__generated__/models/blockCost";
 import { AgentExecutionStatus } from "@/app/api/__generated__/models/agentExecutionStatus";
+import { BlockCost } from "@/app/api/__generated__/models/blockCost";
+import { BlockInfoCategoriesItem } from "@/app/api/__generated__/models/blockInfoCategoriesItem";
 import { NodeExecutionResult } from "@/app/api/__generated__/models/nodeExecutionResult";
-import { NodeContainer } from "./components/NodeContainer";
-import { NodeHeader } from "./components/NodeHeader";
-import { FormCreator } from "../FormCreator";
-import { preprocessInputSchema } from "@/components/renderers/input-renderer/utils/input-schema-pre-processor";
-import { OutputHandler } from "../OutputHandler";
-import { NodeAdvancedToggle } from "./components/NodeAdvancedToggle";
-import { NodeDataRenderer } from "./components/NodeOutput/NodeOutput";
-import { NodeExecutionBadge } from "./components/NodeExecutionBadge";
-import { cn } from "@/lib/utils";
-import { WebhookDisclaimer } from "./components/WebhookDisclaimer";
-import { AyrshareConnectButton } from "./components/AyrshareConnectButton";
 import { NodeModelMetadata } from "@/app/api/__generated__/models/nodeModelMetadata";
+import { preprocessInputSchema } from "@/components/renderers/InputRenderer/utils/input-schema-pre-processor";
+import { cn } from "@/lib/utils";
+import { RJSFSchema } from "@rjsf/utils";
+import { NodeProps, Node as XYNode } from "@xyflow/react";
+import React from "react";
+import { BlockUIType } from "../../../types";
+import { FormCreator } from "../FormCreator";
+import { OutputHandler } from "../OutputHandler";
+import { AyrshareConnectButton } from "./components/AyrshareConnectButton";
+import { NodeAdvancedToggle } from "./components/NodeAdvancedToggle";
+import { NodeContainer } from "./components/NodeContainer";
+import { NodeExecutionBadge } from "./components/NodeExecutionBadge";
+import { NodeHeader } from "./components/NodeHeader";
+import { NodeDataRenderer } from "./components/NodeOutput/NodeOutput";
+import { NodeRightClickMenu } from "./components/NodeRightClickMenu";
+import { StickyNoteBlock } from "./components/StickyNoteBlock";
+import { WebhookDisclaimer } from "./components/WebhookDisclaimer";
+import { SubAgentUpdateFeature } from "./components/SubAgentUpdate/SubAgentUpdateFeature";
+import { useCustomNode } from "./useCustomNode";
 
 export type CustomNodeData = {
   hardcodedValues: {
@@ -44,6 +47,10 @@ export type CustomNode = XYNode<CustomNodeData, "custom">;
 
 export const CustomNode: React.FC<NodeProps<CustomNode>> = React.memo(
   ({ data, id: nodeId, selected }) => {
+    const { inputSchema, outputSchema } = useCustomNode({ data, nodeId });
+
+    const isAgent = data.uiType === BlockUIType.AGENT;
+
     if (data.uiType === BlockUIType.NOTE) {
       return (
         <StickyNoteBlock data={data} selected={selected} nodeId={nodeId} />
@@ -62,16 +69,6 @@ export const CustomNode: React.FC<NodeProps<CustomNode>> = React.memo(
 
     const isAyrshare = data.uiType === BlockUIType.AYRSHARE;
 
-    const inputSchema =
-      data.uiType === BlockUIType.AGENT
-        ? (data.hardcodedValues.input_schema ?? {})
-        : data.inputSchema;
-
-    const outputSchema =
-      data.uiType === BlockUIType.AGENT
-        ? (data.hardcodedValues.output_schema ?? {})
-        : data.outputSchema;
-
     const hasConfigErrors =
       data.errors &&
       Object.values(data.errors).some(
@@ -86,12 +83,11 @@ export const CustomNode: React.FC<NodeProps<CustomNode>> = React.memo(
 
     const hasErrors = hasConfigErrors || hasOutputError;
 
-    // Currently all blockTypes design are similar - that's why i am using the same component for all of them
-    // If in future - if we need some drastic change in some blockTypes design - we can create separate components for them
-    return (
+    const node = (
       <NodeContainer selected={selected} nodeId={nodeId} hasErrors={hasErrors}>
         <div className="rounded-xlarge bg-white">
           <NodeHeader data={data} nodeId={nodeId} />
+          {isAgent && <SubAgentUpdateFeature nodeID={nodeId} nodeData={data} />}
           {isWebhook && <WebhookDisclaimer nodeId={nodeId} />}
           {isAyrshare && <AyrshareConnectButton />}
           <FormCreator
@@ -99,7 +95,7 @@ export const CustomNode: React.FC<NodeProps<CustomNode>> = React.memo(
             nodeId={nodeId}
             uiType={data.uiType}
             className={cn(
-              "bg-white pr-6",
+              "bg-white px-4",
               isWebhook && "pointer-events-none opacity-50",
             )}
             showHandles={showHandles}
@@ -117,6 +113,15 @@ export const CustomNode: React.FC<NodeProps<CustomNode>> = React.memo(
         <NodeExecutionBadge nodeId={nodeId} />
       </NodeContainer>
     );
+
+    return (
+      <NodeRightClickMenu
+        nodeId={nodeId}
+        subGraphID={data.hardcodedValues?.graph_id}
+      >
+        {node}
+      </NodeRightClickMenu>
+    );
   },
 );
 
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeAdvancedToggle.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeAdvancedToggle.tsx
index 4903f2e020..950db1657f 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeAdvancedToggle.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeAdvancedToggle.tsx
@@ -8,7 +8,7 @@ export const NodeAdvancedToggle = ({ nodeId }: { nodeId: string }) => {
   );
   const setShowAdvanced = useNodeStore((state) => state.setShowAdvanced);
   return (
-    <div className="flex items-center justify-between gap-2 rounded-b-xlarge border-t border-slate-200/50 bg-white px-5 py-3.5">
+    <div className="flex items-center justify-between gap-2 rounded-b-xlarge border-t border-zinc-200 bg-white px-5 py-3.5">
       <Text variant="body" className="font-medium text-slate-700">
         Advanced
       </Text>
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeContainer.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeContainer.tsx
index f8d5b2e089..00004c3a8a 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeContainer.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeContainer.tsx
@@ -22,11 +22,12 @@ export const NodeContainer = ({
   return (
     <div
       className={cn(
-        "z-12 max-w-[370px] rounded-xlarge ring-1 ring-slate-200/60",
+        "z-12 w-[350px] rounded-xlarge ring-1 ring-slate-200/60",
         selected && "shadow-lg ring-2 ring-slate-200",
         status && nodeStyleBasedOnStatus[status],
         hasErrors ? nodeStyleBasedOnStatus[AgentExecutionStatus.FAILED] : "",
       )}
+      data-id={`custom-node-${nodeId}`}
     >
       {children}
     </div>
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeContextMenu.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeContextMenu.tsx
index 6e482122f6..1a0e23fead 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeContextMenu.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeContextMenu.tsx
@@ -1,26 +1,31 @@
-import { Separator } from "@/components/__legacy__/ui/separator";
+import { useCopyPasteStore } from "@/app/(platform)/build/stores/copyPasteStore";
+import { useNodeStore } from "@/app/(platform)/build/stores/nodeStore";
 import {
   DropdownMenu,
-  DropdownMenuContent,
-  DropdownMenuItem,
   DropdownMenuTrigger,
 } from "@/components/molecules/DropdownMenu/DropdownMenu";
-import { DotsThreeOutlineVerticalIcon } from "@phosphor-icons/react";
-import { Copy, Trash2, ExternalLink } from "lucide-react";
-import { useNodeStore } from "@/app/(platform)/build/stores/nodeStore";
-import { useCopyPasteStore } from "@/app/(platform)/build/stores/copyPasteStore";
+import {
+  SecondaryDropdownMenuContent,
+  SecondaryDropdownMenuItem,
+  SecondaryDropdownMenuSeparator,
+} from "@/components/molecules/SecondaryMenu/SecondaryMenu";
+import {
+  ArrowSquareOutIcon,
+  CopyIcon,
+  DotsThreeOutlineVerticalIcon,
+  TrashIcon,
+} from "@phosphor-icons/react";
 import { useReactFlow } from "@xyflow/react";
 
-export const NodeContextMenu = ({
-  nodeId,
-  subGraphID,
-}: {
+type Props = {
   nodeId: string;
   subGraphID?: string;
-}) => {
+};
+
+export const NodeContextMenu = ({ nodeId, subGraphID }: Props) => {
   const { deleteElements } = useReactFlow();
 
-  const handleCopy = () => {
+  function handleCopy() {
     useNodeStore.setState((state) => ({
       nodes: state.nodes.map((node) => ({
         ...node,
@@ -30,47 +35,47 @@ export const NodeContextMenu = ({
 
     useCopyPasteStore.getState().copySelectedNodes();
     useCopyPasteStore.getState().pasteNodes();
-  };
+  }
 
-  const handleDelete = () => {
+  function handleDelete() {
     deleteElements({ nodes: [{ id: nodeId }] });
-  };
+  }
 
   return (
     <DropdownMenu>
       <DropdownMenuTrigger className="py-2">
         <DotsThreeOutlineVerticalIcon size={16} weight="fill" />
       </DropdownMenuTrigger>
-      <DropdownMenuContent
-        side="right"
-        align="start"
-        className="rounded-xlarge"
-      >
-        <DropdownMenuItem onClick={handleCopy} className="hover:rounded-xlarge">
-          <Copy className="mr-2 h-4 w-4" />
-          Copy Node
-        </DropdownMenuItem>
+      <SecondaryDropdownMenuContent side="right" align="start">
+        <SecondaryDropdownMenuItem onClick={handleCopy}>
+          <CopyIcon size={20} className="mr-2 dark:text-gray-100" />
+          <span className="dark:text-gray-100">Copy</span>
+        </SecondaryDropdownMenuItem>
+        <SecondaryDropdownMenuSeparator />
 
         {subGraphID && (
-          <DropdownMenuItem
-            onClick={() => window.open(`/build?flowID=${subGraphID}`)}
-            className="hover:rounded-xlarge"
-          >
-            <ExternalLink className="mr-2 h-4 w-4" />
-            Open Agent
-          </DropdownMenuItem>
+          <>
+            <SecondaryDropdownMenuItem
+              onClick={() => window.open(`/build?flowID=${subGraphID}`)}
+            >
+              <ArrowSquareOutIcon
+                size={20}
+                className="mr-2 dark:text-gray-100"
+              />
+              <span className="dark:text-gray-100">Open agent</span>
+            </SecondaryDropdownMenuItem>
+            <SecondaryDropdownMenuSeparator />
+          </>
         )}
 
-        <Separator className="my-2" />
-
-        <DropdownMenuItem
-          onClick={handleDelete}
-          className="text-red-600 hover:rounded-xlarge"
-        >
-          <Trash2 className="mr-2 h-4 w-4" />
-          Delete
-        </DropdownMenuItem>
-      </DropdownMenuContent>
+        <SecondaryDropdownMenuItem variant="destructive" onClick={handleDelete}>
+          <TrashIcon
+            size={20}
+            className="mr-2 text-red-500 dark:text-red-400"
+          />
+          <span className="dark:text-red-400">Delete</span>
+        </SecondaryDropdownMenuItem>
+      </SecondaryDropdownMenuContent>
     </DropdownMenu>
   );
 };
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeHeader.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeHeader.tsx
index 42d14a81a0..c4659b8dcf 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeHeader.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeHeader.tsx
@@ -1,27 +1,30 @@
-import { Text } from "@/components/atoms/Text/Text";
-import { beautifyString, cn } from "@/lib/utils";
-import { NodeCost } from "./NodeCost";
-import { NodeBadges } from "./NodeBadges";
-import { NodeContextMenu } from "./NodeContextMenu";
-import { CustomNodeData } from "../CustomNode";
 import { useNodeStore } from "@/app/(platform)/build/stores/nodeStore";
-import { useState } from "react";
+import { Text } from "@/components/atoms/Text/Text";
 import {
   Tooltip,
   TooltipContent,
   TooltipProvider,
   TooltipTrigger,
 } from "@/components/atoms/Tooltip/BaseTooltip";
+import { beautifyString, cn } from "@/lib/utils";
+import { useState } from "react";
+import { CustomNodeData } from "../CustomNode";
+import { NodeBadges } from "./NodeBadges";
+import { NodeContextMenu } from "./NodeContextMenu";
+import { NodeCost } from "./NodeCost";
 
-export const NodeHeader = ({
-  data,
-  nodeId,
-}: {
+type Props = {
   data: CustomNodeData;
   nodeId: string;
-}) => {
+};
+
+export const NodeHeader = ({ data, nodeId }: Props) => {
   const updateNodeData = useNodeStore((state) => state.updateNodeData);
-  const title = (data.metadata?.customized_name as string) || data.title;
+  const title =
+    (data.metadata?.customized_name as string) ||
+    data.hardcodedValues?.agent_name ||
+    data.title;
+
   const [isEditingTitle, setIsEditingTitle] = useState(false);
   const [editedTitle, setEditedTitle] = useState(title);
 
@@ -41,7 +44,7 @@ export const NodeHeader = ({
   };
 
   return (
-    <div className="flex h-auto flex-col gap-1 rounded-xlarge border-b border-slate-200/50 bg-gradient-to-r from-slate-50/80 to-white/90 px-4 py-4 pt-3">
+    <div className="flex h-auto flex-col gap-1 rounded-xlarge border-b border-zinc-200 bg-gradient-to-r from-slate-50/80 to-white/90 px-4 py-4 pt-3">
       {/* Title row with context menu */}
       <div className="flex items-start justify-between gap-2">
         <div className="flex min-w-0 flex-1 items-center gap-2">
@@ -67,13 +70,16 @@ export const NodeHeader = ({
                 <Tooltip>
                   <TooltipTrigger asChild>
                     <div>
-                      <Text variant="large-semibold" className="line-clamp-1">
-                        {beautifyString(title)}
+                      <Text
+                        variant="large-semibold"
+                        className="line-clamp-1 hover:cursor-text"
+                      >
+                        {beautifyString(title).replace("Block", "").trim()}
                       </Text>
                     </div>
                   </TooltipTrigger>
                   <TooltipContent>
-                    <p>{beautifyString(title)}</p>
+                    <p>{beautifyString(title).replace("Block", "").trim()}</p>
                   </TooltipContent>
                 </Tooltip>
               </TooltipProvider>
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeOutput/NodeOutput.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeOutput/NodeOutput.tsx
index a4b53e3ac3..7189ab9ca7 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeOutput/NodeOutput.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeOutput/NodeOutput.tsx
@@ -23,7 +23,10 @@ export const NodeDataRenderer = ({ nodeId }: { nodeId: string }) => {
   }
 
   return (
-    <div className="flex flex-col gap-3 rounded-b-xl border-t border-slate-200/50 px-4 py-4">
+    <div
+      data-tutorial-id={`node-output`}
+      className="flex flex-col gap-3 rounded-b-xl border-t border-zinc-200 px-4 py-4"
+    >
       <div className="flex items-center justify-between">
         <Text variant="body-medium" className="!font-semibold text-slate-700">
           Node Output
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeOutput/components/ContentRenderer.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeOutput/components/ContentRenderer.tsx
index 9cb1a62e3d..6571bc7b6f 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeOutput/components/ContentRenderer.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeOutput/components/ContentRenderer.tsx
@@ -1,7 +1,7 @@
 "use client";
 
-import type { OutputMetadata } from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/OutputRenderers";
-import { globalRegistry } from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/OutputRenderers";
+import type { OutputMetadata } from "@/components/contextual/OutputRenderers";
+import { globalRegistry } from "@/components/contextual/OutputRenderers";
 
 export const TextRenderer: React.FC<{
   value: any;
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeOutput/components/NodeDataViewer/NodeDataViewer.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeOutput/components/NodeDataViewer/NodeDataViewer.tsx
index c505282e7b..0858db8f0e 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeOutput/components/NodeDataViewer/NodeDataViewer.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeOutput/components/NodeDataViewer/NodeDataViewer.tsx
@@ -1,7 +1,3 @@
-import {
-  OutputActions,
-  OutputItem,
-} from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/OutputRenderers";
 import { ScrollArea } from "@/components/__legacy__/ui/scroll-area";
 import { Button } from "@/components/atoms/Button/Button";
 import { Text } from "@/components/atoms/Text/Text";
@@ -11,6 +7,10 @@ import {
   TooltipProvider,
   TooltipTrigger,
 } from "@/components/atoms/Tooltip/BaseTooltip";
+import {
+  OutputActions,
+  OutputItem,
+} from "@/components/contextual/OutputRenderers";
 import { Dialog } from "@/components/molecules/Dialog/Dialog";
 import { beautifyString } from "@/lib/utils";
 import {
@@ -151,7 +151,7 @@ export const NodeDataViewer: FC<NodeDataViewerProps> = ({
         </div>
 
         <div className="flex justify-end pt-4">
-          {outputItems.length > 0 && (
+          {outputItems.length > 1 && (
             <OutputActions
               items={outputItems.map((item) => ({
                 value: item.value,
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeOutput/components/NodeDataViewer/useNodeDataViewer.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeOutput/components/NodeDataViewer/useNodeDataViewer.ts
index 1adec625a0..d3c555970c 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeOutput/components/NodeDataViewer/useNodeDataViewer.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeOutput/components/NodeDataViewer/useNodeDataViewer.ts
@@ -1,6 +1,6 @@
-import type { OutputMetadata } from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/OutputRenderers";
-import { globalRegistry } from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/OutputRenderers";
-import { downloadOutputs } from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/OutputRenderers/utils/download";
+import type { OutputMetadata } from "@/components/contextual/OutputRenderers";
+import { globalRegistry } from "@/components/contextual/OutputRenderers";
+import { downloadOutputs } from "@/components/contextual/OutputRenderers/utils/download";
 import { useToast } from "@/components/molecules/Toast/use-toast";
 import { beautifyString } from "@/lib/utils";
 import React, { useMemo, useState } from "react";
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeRightClickMenu.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeRightClickMenu.tsx
new file mode 100644
index 0000000000..a56e42544f
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeRightClickMenu.tsx
@@ -0,0 +1,104 @@
+import { useCopyPasteStore } from "@/app/(platform)/build/stores/copyPasteStore";
+import { useNodeStore } from "@/app/(platform)/build/stores/nodeStore";
+import {
+  SecondaryMenuContent,
+  SecondaryMenuItem,
+  SecondaryMenuSeparator,
+} from "@/components/molecules/SecondaryMenu/SecondaryMenu";
+import { ArrowSquareOutIcon, CopyIcon, TrashIcon } from "@phosphor-icons/react";
+import * as ContextMenu from "@radix-ui/react-context-menu";
+import { useReactFlow } from "@xyflow/react";
+import { useEffect, useRef } from "react";
+import { CustomNode } from "../CustomNode";
+
+type Props = {
+  nodeId: string;
+  subGraphID?: string;
+  children: React.ReactNode;
+};
+
+const DOUBLE_CLICK_TIMEOUT = 300;
+
+export function NodeRightClickMenu({ nodeId, subGraphID, children }: Props) {
+  const { deleteElements } = useReactFlow<CustomNode>();
+  const lastRightClickTime = useRef<number>(0);
+  const containerRef = useRef<HTMLDivElement>(null);
+
+  function copyNode() {
+    useNodeStore.setState((state) => ({
+      nodes: state.nodes.map((node) => ({
+        ...node,
+        selected: node.id === nodeId,
+      })),
+    }));
+
+    useCopyPasteStore.getState().copySelectedNodes();
+    useCopyPasteStore.getState().pasteNodes();
+  }
+
+  function deleteNode() {
+    deleteElements({ nodes: [{ id: nodeId }] });
+  }
+
+  useEffect(() => {
+    const container = containerRef.current;
+    if (!container) return;
+
+    function handleContextMenu(e: MouseEvent) {
+      const now = Date.now();
+      const timeSinceLastClick = now - lastRightClickTime.current;
+
+      if (timeSinceLastClick < DOUBLE_CLICK_TIMEOUT) {
+        e.stopImmediatePropagation();
+        lastRightClickTime.current = 0;
+        return;
+      }
+
+      lastRightClickTime.current = now;
+    }
+
+    container.addEventListener("contextmenu", handleContextMenu, true);
+
+    return () => {
+      container.removeEventListener("contextmenu", handleContextMenu, true);
+    };
+  }, []);
+
+  return (
+    <ContextMenu.Root>
+      <ContextMenu.Trigger asChild>
+        <div ref={containerRef}>{children}</div>
+      </ContextMenu.Trigger>
+      <SecondaryMenuContent>
+        <SecondaryMenuItem onSelect={copyNode}>
+          <CopyIcon size={20} className="mr-2 dark:text-gray-100" />
+          <span className="dark:text-gray-100">Copy</span>
+        </SecondaryMenuItem>
+        <SecondaryMenuSeparator />
+
+        {subGraphID && (
+          <>
+            <SecondaryMenuItem
+              onClick={() => window.open(`/build?flowID=${subGraphID}`)}
+            >
+              <ArrowSquareOutIcon
+                size={20}
+                className="mr-2 dark:text-gray-100"
+              />
+              <span className="dark:text-gray-100">Open agent</span>
+            </SecondaryMenuItem>
+            <SecondaryMenuSeparator />
+          </>
+        )}
+
+        <SecondaryMenuItem variant="destructive" onSelect={deleteNode}>
+          <TrashIcon
+            size={20}
+            className="mr-2 text-red-500 dark:text-red-400"
+          />
+          <span className="dark:text-red-400">Delete</span>
+        </SecondaryMenuItem>
+      </SecondaryMenuContent>
+    </ContextMenu.Root>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/StickyNoteBlock.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/StickyNoteBlock.tsx
index 5d57c6c5b6..f900b1633f 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/StickyNoteBlock.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/StickyNoteBlock.tsx
@@ -1,6 +1,6 @@
 import { useMemo } from "react";
 import { FormCreator } from "../../FormCreator";
-import { preprocessInputSchema } from "@/components/renderers/input-renderer/utils/input-schema-pre-processor";
+import { preprocessInputSchema } from "@/components/renderers/InputRenderer/utils/input-schema-pre-processor";
 import { CustomNodeData } from "../CustomNode";
 import { Text } from "@/components/atoms/Text/Text";
 import { cn } from "@/lib/utils";
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/SubAgentUpdate/SubAgentUpdateFeature.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/SubAgentUpdate/SubAgentUpdateFeature.tsx
new file mode 100644
index 0000000000..388349b2e0
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/SubAgentUpdate/SubAgentUpdateFeature.tsx
@@ -0,0 +1,118 @@
+import React from "react";
+import { ArrowUpIcon, WarningIcon } from "@phosphor-icons/react";
+import { Button } from "@/components/atoms/Button/Button";
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipTrigger,
+} from "@/components/atoms/Tooltip/BaseTooltip";
+import { cn, beautifyString } from "@/lib/utils";
+import { CustomNodeData } from "../../CustomNode";
+import { useSubAgentUpdateState } from "./useSubAgentUpdateState";
+import { IncompatibleUpdateDialog } from "./components/IncompatibleUpdateDialog";
+import { ResolutionModeBar } from "./components/ResolutionModeBar";
+
+/**
+ * Inline component for the update bar that can be placed after the header.
+ * Use this inside the node content where you want the bar to appear.
+ */
+type SubAgentUpdateFeatureProps = {
+  nodeID: string;
+  nodeData: CustomNodeData;
+};
+
+export function SubAgentUpdateFeature({
+  nodeID,
+  nodeData,
+}: SubAgentUpdateFeatureProps) {
+  const {
+    updateInfo,
+    isInResolutionMode,
+    handleUpdateClick,
+    showIncompatibilityDialog,
+    setShowIncompatibilityDialog,
+    handleConfirmIncompatibleUpdate,
+  } = useSubAgentUpdateState({ nodeID: nodeID, nodeData: nodeData });
+
+  const agentName = nodeData.title || "Agent";
+
+  if (!updateInfo.hasUpdate && !isInResolutionMode) {
+    return null;
+  }
+
+  return (
+    <>
+      {isInResolutionMode ? (
+        <ResolutionModeBar incompatibilities={updateInfo.incompatibilities} />
+      ) : (
+        <SubAgentUpdateAvailableBar
+          currentVersion={updateInfo.currentVersion}
+          latestVersion={updateInfo.latestVersion}
+          isCompatible={updateInfo.isCompatible}
+          onUpdate={handleUpdateClick}
+        />
+      )}
+      {/* Incompatibility dialog - rendered here since this component owns the state */}
+      {updateInfo.incompatibilities && (
+        <IncompatibleUpdateDialog
+          isOpen={showIncompatibilityDialog}
+          onClose={() => setShowIncompatibilityDialog(false)}
+          onConfirm={handleConfirmIncompatibleUpdate}
+          currentVersion={updateInfo.currentVersion}
+          latestVersion={updateInfo.latestVersion}
+          agentName={beautifyString(agentName)}
+          incompatibilities={updateInfo.incompatibilities}
+        />
+      )}
+    </>
+  );
+}
+
+type SubAgentUpdateAvailableBarProps = {
+  currentVersion: number;
+  latestVersion: number;
+  isCompatible: boolean;
+  onUpdate: () => void;
+};
+
+function SubAgentUpdateAvailableBar({
+  currentVersion,
+  latestVersion,
+  isCompatible,
+  onUpdate,
+}: SubAgentUpdateAvailableBarProps): React.ReactElement {
+  return (
+    <div className="flex items-center justify-between gap-2 rounded-t-xl bg-blue-50 px-3 py-2 dark:bg-blue-900/30">
+      <div className="flex items-center gap-2">
+        <ArrowUpIcon className="h-4 w-4 text-blue-600 dark:text-blue-400" />
+        <span className="text-sm text-blue-700 dark:text-blue-300">
+          Update available (v{currentVersion} → v{latestVersion})
+        </span>
+        {!isCompatible && (
+          <Tooltip>
+            <TooltipTrigger asChild>
+              <WarningIcon className="h-4 w-4 text-amber-500" />
+            </TooltipTrigger>
+            <TooltipContent className="max-w-xs">
+              <p className="font-medium">Incompatible changes detected</p>
+              <p className="text-xs text-gray-400">
+                Click Update to see details
+              </p>
+            </TooltipContent>
+          </Tooltip>
+        )}
+      </div>
+      <Button
+        size="small"
+        variant={isCompatible ? "primary" : "outline"}
+        onClick={onUpdate}
+        className={cn(
+          "h-7 text-xs",
+          !isCompatible && "border-amber-500 text-amber-600 hover:bg-amber-50",
+        )}
+      >
+        Update
+      </Button>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/SubAgentUpdate/components/IncompatibleUpdateDialog.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/SubAgentUpdate/components/IncompatibleUpdateDialog.tsx
new file mode 100644
index 0000000000..67f20789ed
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/SubAgentUpdate/components/IncompatibleUpdateDialog.tsx
@@ -0,0 +1,274 @@
+import React from "react";
+import {
+  WarningIcon,
+  XCircleIcon,
+  PlusCircleIcon,
+} from "@phosphor-icons/react";
+import { Button } from "@/components/atoms/Button/Button";
+import { Alert, AlertDescription } from "@/components/molecules/Alert/Alert";
+import { Dialog } from "@/components/molecules/Dialog/Dialog";
+import { beautifyString } from "@/lib/utils";
+import { IncompatibilityInfo } from "@/app/(platform)/build/hooks/useSubAgentUpdate/types";
+
+type IncompatibleUpdateDialogProps = {
+  isOpen: boolean;
+  onClose: () => void;
+  onConfirm: () => void;
+  currentVersion: number;
+  latestVersion: number;
+  agentName: string;
+  incompatibilities: IncompatibilityInfo;
+};
+
+export function IncompatibleUpdateDialog({
+  isOpen,
+  onClose,
+  onConfirm,
+  currentVersion,
+  latestVersion,
+  agentName,
+  incompatibilities,
+}: IncompatibleUpdateDialogProps) {
+  const hasMissingInputs = incompatibilities.missingInputs.length > 0;
+  const hasMissingOutputs = incompatibilities.missingOutputs.length > 0;
+  const hasNewInputs = incompatibilities.newInputs.length > 0;
+  const hasNewOutputs = incompatibilities.newOutputs.length > 0;
+  const hasNewRequired = incompatibilities.newRequiredInputs.length > 0;
+  const hasTypeMismatches = incompatibilities.inputTypeMismatches.length > 0;
+
+  const hasInputChanges = hasMissingInputs || hasNewInputs;
+  const hasOutputChanges = hasMissingOutputs || hasNewOutputs;
+
+  return (
+    <Dialog
+      title={
+        <div className="flex items-center gap-2">
+          <WarningIcon className="h-5 w-5 text-amber-500" weight="fill" />
+          Incompatible Update
+        </div>
+      }
+      controlled={{
+        isOpen,
+        set: async (open) => {
+          if (!open) onClose();
+        },
+      }}
+      onClose={onClose}
+      styling={{ maxWidth: "32rem" }}
+    >
+      <Dialog.Content>
+        <div className="space-y-4">
+          <p className="text-sm text-gray-600 dark:text-gray-400">
+            Updating <strong>{beautifyString(agentName)}</strong> from v
+            {currentVersion} to v{latestVersion} will break some connections.
+          </p>
+
+          {/* Input changes - two column layout */}
+          {hasInputChanges && (
+            <TwoColumnSection
+              title="Input Changes"
+              leftIcon={
+                <XCircleIcon className="h-4 w-4 text-red-500" weight="fill" />
+              }
+              leftTitle="Removed"
+              leftItems={incompatibilities.missingInputs}
+              rightIcon={
+                <PlusCircleIcon
+                  className="h-4 w-4 text-green-500"
+                  weight="fill"
+                />
+              }
+              rightTitle="Added"
+              rightItems={incompatibilities.newInputs}
+            />
+          )}
+
+          {/* Output changes - two column layout */}
+          {hasOutputChanges && (
+            <TwoColumnSection
+              title="Output Changes"
+              leftIcon={
+                <XCircleIcon className="h-4 w-4 text-red-500" weight="fill" />
+              }
+              leftTitle="Removed"
+              leftItems={incompatibilities.missingOutputs}
+              rightIcon={
+                <PlusCircleIcon
+                  className="h-4 w-4 text-green-500"
+                  weight="fill"
+                />
+              }
+              rightTitle="Added"
+              rightItems={incompatibilities.newOutputs}
+            />
+          )}
+
+          {hasTypeMismatches && (
+            <SingleColumnSection
+              icon={
+                <XCircleIcon className="h-4 w-4 text-red-500" weight="fill" />
+              }
+              title="Type Changed"
+              description="These connected inputs have a different type:"
+              items={incompatibilities.inputTypeMismatches.map(
+                (m) => `${m.name} (${m.oldType} → ${m.newType})`,
+              )}
+            />
+          )}
+
+          {hasNewRequired && (
+            <SingleColumnSection
+              icon={
+                <PlusCircleIcon
+                  className="h-4 w-4 text-amber-500"
+                  weight="fill"
+                />
+              }
+              title="New Required Inputs"
+              description="These inputs are now required:"
+              items={incompatibilities.newRequiredInputs}
+            />
+          )}
+
+          <Alert variant="warning">
+            <AlertDescription>
+              If you proceed, you&apos;ll need to remove the broken connections
+              before you can save or run your agent.
+            </AlertDescription>
+          </Alert>
+
+          <Dialog.Footer>
+            <Button variant="ghost" size="small" onClick={onClose}>
+              Cancel
+            </Button>
+            <Button
+              variant="primary"
+              size="small"
+              onClick={onConfirm}
+              className="border-amber-700 bg-amber-600 hover:bg-amber-700"
+            >
+              Update Anyway
+            </Button>
+          </Dialog.Footer>
+        </div>
+      </Dialog.Content>
+    </Dialog>
+  );
+}
+
+type TwoColumnSectionProps = {
+  title: string;
+  leftIcon: React.ReactNode;
+  leftTitle: string;
+  leftItems: string[];
+  rightIcon: React.ReactNode;
+  rightTitle: string;
+  rightItems: string[];
+};
+
+function TwoColumnSection({
+  title,
+  leftIcon,
+  leftTitle,
+  leftItems,
+  rightIcon,
+  rightTitle,
+  rightItems,
+}: TwoColumnSectionProps) {
+  return (
+    <div className="rounded-md border border-gray-200 p-3 dark:border-gray-700">
+      <span className="font-medium">{title}</span>
+      <div className="mt-2 grid grid-cols-2 items-start gap-4">
+        {/* Left column - Breaking changes */}
+        <div className="min-w-0">
+          <div className="flex items-center gap-1.5 text-sm text-gray-500 dark:text-gray-400">
+            {leftIcon}
+            <span>{leftTitle}</span>
+          </div>
+          <ul className="mt-1.5 space-y-1">
+            {leftItems.length > 0 ? (
+              leftItems.map((item) => (
+                <li
+                  key={item}
+                  className="text-sm text-gray-700 dark:text-gray-300"
+                >
+                  <code className="rounded bg-red-50 px-1 py-0.5 font-mono text-xs text-red-700 dark:bg-red-900/30 dark:text-red-300">
+                    {item}
+                  </code>
+                </li>
+              ))
+            ) : (
+              <li className="text-sm italic text-gray-400 dark:text-gray-500">
+                None
+              </li>
+            )}
+          </ul>
+        </div>
+
+        {/* Right column - Possible solutions */}
+        <div className="min-w-0">
+          <div className="flex items-center gap-1.5 text-sm text-gray-500 dark:text-gray-400">
+            {rightIcon}
+            <span>{rightTitle}</span>
+          </div>
+          <ul className="mt-1.5 space-y-1">
+            {rightItems.length > 0 ? (
+              rightItems.map((item) => (
+                <li
+                  key={item}
+                  className="text-sm text-gray-700 dark:text-gray-300"
+                >
+                  <code className="rounded bg-green-50 px-1 py-0.5 font-mono text-xs text-green-700 dark:bg-green-900/30 dark:text-green-300">
+                    {item}
+                  </code>
+                </li>
+              ))
+            ) : (
+              <li className="text-sm italic text-gray-400 dark:text-gray-500">
+                None
+              </li>
+            )}
+          </ul>
+        </div>
+      </div>
+    </div>
+  );
+}
+
+type SingleColumnSectionProps = {
+  icon: React.ReactNode;
+  title: string;
+  description: string;
+  items: string[];
+};
+
+function SingleColumnSection({
+  icon,
+  title,
+  description,
+  items,
+}: SingleColumnSectionProps) {
+  return (
+    <div className="rounded-md border border-gray-200 p-3 dark:border-gray-700">
+      <div className="flex items-center gap-2">
+        {icon}
+        <span className="font-medium">{title}</span>
+      </div>
+      <p className="mt-1 text-sm text-gray-500 dark:text-gray-400">
+        {description}
+      </p>
+      <ul className="mt-2 space-y-1">
+        {items.map((item) => (
+          <li
+            key={item}
+            className="ml-4 list-disc text-sm text-gray-700 dark:text-gray-300"
+          >
+            <code className="rounded bg-gray-100 px-1 py-0.5 font-mono text-xs dark:bg-gray-800">
+              {item}
+            </code>
+          </li>
+        ))}
+      </ul>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/SubAgentUpdate/components/ResolutionModeBar.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/SubAgentUpdate/components/ResolutionModeBar.tsx
new file mode 100644
index 0000000000..f60bd60c52
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/SubAgentUpdate/components/ResolutionModeBar.tsx
@@ -0,0 +1,107 @@
+import React from "react";
+import { InfoIcon, WarningIcon } from "@phosphor-icons/react";
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipTrigger,
+} from "@/components/atoms/Tooltip/BaseTooltip";
+import { IncompatibilityInfo } from "@/app/(platform)/build/hooks/useSubAgentUpdate/types";
+
+type ResolutionModeBarProps = {
+  incompatibilities: IncompatibilityInfo | null;
+};
+
+export function ResolutionModeBar({
+  incompatibilities,
+}: ResolutionModeBarProps): React.ReactElement {
+  const renderIncompatibilities = () => {
+    if (!incompatibilities) return <span>No incompatibilities</span>;
+
+    const sections: React.ReactNode[] = [];
+
+    if (incompatibilities.missingInputs.length > 0) {
+      sections.push(
+        <div key="missing-inputs" className="mb-1">
+          <span className="font-semibold">Missing inputs: </span>
+          {incompatibilities.missingInputs.map((name, i) => (
+            <React.Fragment key={name}>
+              <code className="font-mono">{name}</code>
+              {i < incompatibilities.missingInputs.length - 1 && ", "}
+            </React.Fragment>
+          ))}
+        </div>,
+      );
+    }
+    if (incompatibilities.missingOutputs.length > 0) {
+      sections.push(
+        <div key="missing-outputs" className="mb-1">
+          <span className="font-semibold">Missing outputs: </span>
+          {incompatibilities.missingOutputs.map((name, i) => (
+            <React.Fragment key={name}>
+              <code className="font-mono">{name}</code>
+              {i < incompatibilities.missingOutputs.length - 1 && ", "}
+            </React.Fragment>
+          ))}
+        </div>,
+      );
+    }
+    if (incompatibilities.newRequiredInputs.length > 0) {
+      sections.push(
+        <div key="new-required" className="mb-1">
+          <span className="font-semibold">New required inputs: </span>
+          {incompatibilities.newRequiredInputs.map((name, i) => (
+            <React.Fragment key={name}>
+              <code className="font-mono">{name}</code>
+              {i < incompatibilities.newRequiredInputs.length - 1 && ", "}
+            </React.Fragment>
+          ))}
+        </div>,
+      );
+    }
+    if (incompatibilities.inputTypeMismatches.length > 0) {
+      sections.push(
+        <div key="type-mismatches" className="mb-1">
+          <span className="font-semibold">Type changed: </span>
+          {incompatibilities.inputTypeMismatches.map((m, i) => (
+            <React.Fragment key={m.name}>
+              <code className="font-mono">{m.name}</code>
+              <span className="text-gray-400">
+                {" "}
+                ({m.oldType} → {m.newType})
+              </span>
+              {i < incompatibilities.inputTypeMismatches.length - 1 && ", "}
+            </React.Fragment>
+          ))}
+        </div>,
+      );
+    }
+
+    return <>{sections}</>;
+  };
+
+  return (
+    <div className="flex items-center justify-between gap-2 rounded-t-xl bg-amber-50 px-3 py-2 dark:bg-amber-900/30">
+      <div className="flex items-center gap-2">
+        <WarningIcon className="h-4 w-4 text-amber-600 dark:text-amber-400" />
+        <span className="text-sm text-amber-700 dark:text-amber-300">
+          Remove incompatible connections
+        </span>
+        <Tooltip>
+          <TooltipTrigger asChild>
+            <InfoIcon className="h-4 w-4 cursor-help text-amber-500" />
+          </TooltipTrigger>
+          <TooltipContent className="max-w-sm">
+            <p className="mb-2 font-semibold">Incompatible changes:</p>
+            <div className="text-xs">{renderIncompatibilities()}</div>
+            <p className="mt-2 text-xs text-gray-400">
+              {(incompatibilities?.newRequiredInputs.length ?? 0) > 0
+                ? "Replace / delete"
+                : "Delete"}{" "}
+              the red connections to continue
+            </p>
+          </TooltipContent>
+        </Tooltip>
+      </div>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/SubAgentUpdate/useSubAgentUpdateState.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/SubAgentUpdate/useSubAgentUpdateState.ts
new file mode 100644
index 0000000000..d4ba538172
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/SubAgentUpdate/useSubAgentUpdateState.ts
@@ -0,0 +1,194 @@
+import { useState, useCallback, useEffect } from "react";
+import { useShallow } from "zustand/react/shallow";
+import { useGraphStore } from "@/app/(platform)/build/stores/graphStore";
+import {
+  useNodeStore,
+  NodeResolutionData,
+} from "@/app/(platform)/build/stores/nodeStore";
+import { useEdgeStore } from "@/app/(platform)/build/stores/edgeStore";
+import {
+  useSubAgentUpdate,
+  createUpdatedAgentNodeInputs,
+  getBrokenEdgeIDs,
+} from "@/app/(platform)/build/hooks/useSubAgentUpdate";
+import { GraphInputSchema, GraphOutputSchema } from "@/lib/autogpt-server-api";
+import { CustomNodeData } from "../../CustomNode";
+
+// Stable empty set to avoid creating new references in selectors
+const EMPTY_SET: Set<string> = new Set();
+
+type UseSubAgentUpdateParams = {
+  nodeID: string;
+  nodeData: CustomNodeData;
+};
+
+export function useSubAgentUpdateState({
+  nodeID,
+  nodeData,
+}: UseSubAgentUpdateParams) {
+  const [showIncompatibilityDialog, setShowIncompatibilityDialog] =
+    useState(false);
+
+  // Get store actions
+  const updateNodeData = useNodeStore(
+    useShallow((state) => state.updateNodeData),
+  );
+  const setNodeResolutionMode = useNodeStore(
+    useShallow((state) => state.setNodeResolutionMode),
+  );
+  const isNodeInResolutionMode = useNodeStore(
+    useShallow((state) => state.isNodeInResolutionMode),
+  );
+  const setBrokenEdgeIDs = useNodeStore(
+    useShallow((state) => state.setBrokenEdgeIDs),
+  );
+  // Get this node's broken edge IDs from the per-node map
+  // Use EMPTY_SET as fallback to maintain referential stability
+  const brokenEdgeIDs = useNodeStore(
+    (state) => state.brokenEdgeIDs.get(nodeID) || EMPTY_SET,
+  );
+  const getNodeResolutionData = useNodeStore(
+    useShallow((state) => state.getNodeResolutionData),
+  );
+  const connectedEdges = useEdgeStore(
+    useShallow((state) => state.getNodeEdges(nodeID)),
+  );
+  const availableSubGraphs = useGraphStore(
+    useShallow((state) => state.availableSubGraphs),
+  );
+
+  // Extract agent-specific data
+  const graphID = nodeData.hardcodedValues?.graph_id as string | undefined;
+  const graphVersion = nodeData.hardcodedValues?.graph_version as
+    | number
+    | undefined;
+  const currentInputSchema = nodeData.hardcodedValues?.input_schema as
+    | GraphInputSchema
+    | undefined;
+  const currentOutputSchema = nodeData.hardcodedValues?.output_schema as
+    | GraphOutputSchema
+    | undefined;
+
+  // Use the sub-agent update hook
+  const updateInfo = useSubAgentUpdate(
+    nodeID,
+    graphID,
+    graphVersion,
+    currentInputSchema,
+    currentOutputSchema,
+    connectedEdges,
+    availableSubGraphs,
+  );
+
+  const isInResolutionMode = isNodeInResolutionMode(nodeID);
+
+  // Handle update button click
+  const handleUpdateClick = useCallback(() => {
+    if (!updateInfo.hasUpdate || !updateInfo.latestGraph) return;
+
+    if (updateInfo.isCompatible) {
+      // Compatible update - apply directly
+      const newHardcodedValues = createUpdatedAgentNodeInputs(
+        nodeData.hardcodedValues,
+        updateInfo.latestGraph,
+      );
+      updateNodeData(nodeID, { hardcodedValues: newHardcodedValues });
+    } else {
+      // Incompatible update - show dialog
+      setShowIncompatibilityDialog(true);
+    }
+  }, [
+    updateInfo.hasUpdate,
+    updateInfo.latestGraph,
+    updateInfo.isCompatible,
+    nodeData.hardcodedValues,
+    updateNodeData,
+    nodeID,
+  ]);
+
+  // Handle confirming an incompatible update
+  function handleConfirmIncompatibleUpdate() {
+    if (!updateInfo.latestGraph || !updateInfo.incompatibilities) return;
+
+    const latestGraph = updateInfo.latestGraph;
+
+    // Get the new schemas from the latest graph version
+    const newInputSchema =
+      (latestGraph.input_schema as Record<string, unknown>) || {};
+    const newOutputSchema =
+      (latestGraph.output_schema as Record<string, unknown>) || {};
+
+    // Create the updated hardcoded values but DON'T apply them yet
+    // We'll apply them when resolution is complete
+    const pendingHardcodedValues = createUpdatedAgentNodeInputs(
+      nodeData.hardcodedValues,
+      latestGraph,
+    );
+
+    // Get broken edge IDs and store them for this node
+    const brokenIds = getBrokenEdgeIDs(
+      connectedEdges,
+      updateInfo.incompatibilities,
+      nodeID,
+    );
+    setBrokenEdgeIDs(nodeID, brokenIds);
+
+    // Enter resolution mode with both old and new schemas
+    // DON'T apply the update yet - keep old schema so connections remain visible
+    const resolutionData: NodeResolutionData = {
+      incompatibilities: updateInfo.incompatibilities,
+      pendingUpdate: {
+        input_schema: newInputSchema,
+        output_schema: newOutputSchema,
+      },
+      currentSchema: {
+        input_schema: (currentInputSchema as Record<string, unknown>) || {},
+        output_schema: (currentOutputSchema as Record<string, unknown>) || {},
+      },
+      pendingHardcodedValues,
+    };
+    setNodeResolutionMode(nodeID, true, resolutionData);
+
+    setShowIncompatibilityDialog(false);
+  }
+
+  // Check if resolution is complete (all broken edges removed)
+  const resolutionData = getNodeResolutionData(nodeID);
+
+  // Auto-check resolution on edge changes
+  useEffect(() => {
+    if (!isInResolutionMode) return;
+
+    // Check if any broken edges still exist
+    const remainingBroken = Array.from(brokenEdgeIDs).filter((edgeId) =>
+      connectedEdges.some((e) => e.id === edgeId),
+    );
+
+    if (remainingBroken.length === 0) {
+      // Resolution complete - now apply the pending update
+      if (resolutionData?.pendingHardcodedValues) {
+        updateNodeData(nodeID, {
+          hardcodedValues: resolutionData.pendingHardcodedValues,
+        });
+      }
+      // setNodeResolutionMode will clean up this node's broken edges automatically
+      setNodeResolutionMode(nodeID, false);
+    }
+  }, [
+    isInResolutionMode,
+    brokenEdgeIDs,
+    connectedEdges,
+    resolutionData,
+    nodeID,
+  ]);
+
+  return {
+    updateInfo,
+    isInResolutionMode,
+    resolutionData,
+    showIncompatibilityDialog,
+    setShowIncompatibilityDialog,
+    handleUpdateClick,
+    handleConfirmIncompatibleUpdate,
+  };
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/WebhookDisclaimer.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/WebhookDisclaimer.tsx
index 044bf994ad..1fdee05a2a 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/WebhookDisclaimer.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/WebhookDisclaimer.tsx
@@ -1,10 +1,10 @@
-import { Alert, AlertDescription } from "@/components/molecules/Alert/Alert";
-import { Text } from "@/components/atoms/Text/Text";
-import Link from "next/link";
 import { useGetV2GetLibraryAgentByGraphId } from "@/app/api/__generated__/endpoints/library/library";
 import { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
-import { useQueryStates, parseAsString } from "nuqs";
-import { isValidUUID } from "@/app/(platform)/chat/helpers";
+import { Text } from "@/components/atoms/Text/Text";
+import { Alert, AlertDescription } from "@/components/molecules/Alert/Alert";
+import { isValidUUID } from "@/lib/utils";
+import Link from "next/link";
+import { parseAsString, useQueryStates } from "nuqs";
 
 export const WebhookDisclaimer = ({ nodeId }: { nodeId: string }) => {
   const [{ flowID }] = useQueryStates({
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/helpers.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/helpers.ts
index 8d228d0cd0..54ddf2a61d 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/helpers.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/helpers.ts
@@ -1,4 +1,6 @@
 import { AgentExecutionStatus } from "@/app/api/__generated__/models/agentExecutionStatus";
+import { NodeResolutionData } from "@/app/(platform)/build/stores/nodeStore";
+import { RJSFSchema } from "@rjsf/utils";
 
 export const nodeStyleBasedOnStatus: Record<AgentExecutionStatus, string> = {
   INCOMPLETE: "ring-slate-300 bg-slate-300",
@@ -9,3 +11,48 @@ export const nodeStyleBasedOnStatus: Record<AgentExecutionStatus, string> = {
   TERMINATED: "ring-orange-300 bg-orange-300 ",
   FAILED: "ring-red-300 bg-red-300",
 };
+
+/**
+ * Merges schemas during resolution mode to include removed inputs/outputs
+ * that still have connections, so users can see and delete them.
+ */
+export function mergeSchemaForResolution(
+  currentSchema: Record<string, unknown>,
+  newSchema: Record<string, unknown>,
+  resolutionData: NodeResolutionData,
+  type: "input" | "output",
+): Record<string, unknown> {
+  const newProps = (newSchema.properties as RJSFSchema) || {};
+  const currentProps = (currentSchema.properties as RJSFSchema) || {};
+  const mergedProps = { ...newProps };
+  const incomp = resolutionData.incompatibilities;
+
+  if (type === "input") {
+    // Add back missing inputs that have connections
+    incomp.missingInputs.forEach((inputName: string) => {
+      if (currentProps[inputName]) {
+        mergedProps[inputName] = currentProps[inputName];
+      }
+    });
+    // Add back inputs with type mismatches (keep old type so connection works visually)
+    incomp.inputTypeMismatches.forEach(
+      (mismatch: { name: string; oldType: string; newType: string }) => {
+        if (currentProps[mismatch.name]) {
+          mergedProps[mismatch.name] = currentProps[mismatch.name];
+        }
+      },
+    );
+  } else {
+    // Add back missing outputs that have connections
+    incomp.missingOutputs.forEach((outputName: string) => {
+      if (currentProps[outputName]) {
+        mergedProps[outputName] = currentProps[outputName];
+      }
+    });
+  }
+
+  return {
+    ...newSchema,
+    properties: mergedProps,
+  };
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/useCustomNode.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/useCustomNode.tsx
new file mode 100644
index 0000000000..e58d0ab12b
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/useCustomNode.tsx
@@ -0,0 +1,58 @@
+import { useNodeStore } from "@/app/(platform)/build/stores/nodeStore";
+import { CustomNodeData } from "./CustomNode";
+import { BlockUIType } from "../../../types";
+import { useMemo } from "react";
+import { mergeSchemaForResolution } from "./helpers";
+
+export const useCustomNode = ({
+  data,
+  nodeId,
+}: {
+  data: CustomNodeData;
+  nodeId: string;
+}) => {
+  const isInResolutionMode = useNodeStore((state) =>
+    state.nodesInResolutionMode.has(nodeId),
+  );
+  const resolutionData = useNodeStore((state) =>
+    state.nodeResolutionData.get(nodeId),
+  );
+
+  const isAgent = data.uiType === BlockUIType.AGENT;
+
+  const currentInputSchema = isAgent
+    ? (data.hardcodedValues.input_schema ?? {})
+    : data.inputSchema;
+  const currentOutputSchema = isAgent
+    ? (data.hardcodedValues.output_schema ?? {})
+    : data.outputSchema;
+
+  const inputSchema = useMemo(() => {
+    if (isAgent && isInResolutionMode && resolutionData) {
+      return mergeSchemaForResolution(
+        resolutionData.currentSchema.input_schema,
+        resolutionData.pendingUpdate.input_schema,
+        resolutionData,
+        "input",
+      );
+    }
+    return currentInputSchema;
+  }, [isAgent, isInResolutionMode, resolutionData, currentInputSchema]);
+
+  const outputSchema = useMemo(() => {
+    if (isAgent && isInResolutionMode && resolutionData) {
+      return mergeSchemaForResolution(
+        resolutionData.currentSchema.output_schema,
+        resolutionData.pendingUpdate.output_schema,
+        resolutionData,
+        "output",
+      );
+    }
+    return currentOutputSchema;
+  }, [isAgent, isInResolutionMode, resolutionData, currentOutputSchema]);
+
+  return {
+    inputSchema,
+    outputSchema,
+  };
+};
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/FormCreator.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/FormCreator.tsx
index cfee0bf89f..d6a3fabffa 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/FormCreator.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/FormCreator.tsx
@@ -3,22 +3,18 @@ import React from "react";
 import { uiSchema } from "./uiSchema";
 import { useNodeStore } from "../../../stores/nodeStore";
 import { BlockUIType } from "../../types";
-import { FormRenderer } from "@/components/renderers/input-renderer/FormRenderer";
+import { FormRenderer } from "@/components/renderers/InputRenderer/FormRenderer";
 
-export const FormCreator = React.memo(
-  ({
-    jsonSchema,
-    nodeId,
-    uiType,
-    showHandles = true,
-    className,
-  }: {
-    jsonSchema: RJSFSchema;
-    nodeId: string;
-    uiType: BlockUIType;
-    showHandles?: boolean;
-    className?: string;
-  }) => {
+interface FormCreatorProps {
+  jsonSchema: RJSFSchema;
+  nodeId: string;
+  uiType: BlockUIType;
+  showHandles?: boolean;
+  className?: string;
+}
+
+export const FormCreator: React.FC<FormCreatorProps> = React.memo(
+  ({ jsonSchema, nodeId, uiType, showHandles = true, className }) => {
     const updateNodeData = useNodeStore((state) => state.updateNodeData);
 
     const getHardCodedValues = useNodeStore(
@@ -48,7 +44,10 @@ export const FormCreator = React.memo(
         : hardcodedValues;
 
     return (
-      <div className={className}>
+      <div
+        className={className}
+        data-id={`form-creator-container-${nodeId}-node`}
+      >
         <FormRenderer
           jsonSchema={jsonSchema}
           handleChange={handleChange}
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/OutputHandler.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/OutputHandler.tsx
index ab3b648ba9..665a5bb7be 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/OutputHandler.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/OutputHandler.tsx
@@ -4,7 +4,7 @@ import { CaretDownIcon, InfoIcon } from "@phosphor-icons/react";
 import { RJSFSchema } from "@rjsf/utils";
 import { useState } from "react";
 
-import NodeHandle from "../handlers/NodeHandle";
+import { OutputNodeHandle } from "../handlers/NodeHandle";
 import {
   Tooltip,
   TooltipContent,
@@ -13,8 +13,9 @@ import {
 } from "@/components/atoms/Tooltip/BaseTooltip";
 import { useEdgeStore } from "@/app/(platform)/build/stores/edgeStore";
 import { getTypeDisplayInfo } from "./helpers";
-import { generateHandleId } from "../handlers/helpers";
 import { BlockUIType } from "../../types";
+import { cn } from "@/lib/utils";
+import { useBrokenOutputs } from "./useBrokenOutputs";
 
 export const OutputHandler = ({
   outputSchema,
@@ -28,9 +29,94 @@ export const OutputHandler = ({
   const { isOutputConnected } = useEdgeStore();
   const properties = outputSchema?.properties || {};
   const [isOutputVisible, setIsOutputVisible] = useState(true);
+  const brokenOutputs = useBrokenOutputs(nodeId);
+
+  const showHandles = uiType !== BlockUIType.OUTPUT;
+
+  const renderOutputHandles = (
+    schema: RJSFSchema,
+    keyPrefix: string = "",
+    titlePrefix: string = "",
+  ): React.ReactNode[] => {
+    return Object.entries(schema).map(
+      ([key, fieldSchema]: [string, RJSFSchema]) => {
+        const fullKey = keyPrefix ? `${keyPrefix}_#_${key}` : key;
+        const fieldTitle = titlePrefix + (fieldSchema?.title || key);
+
+        const isConnected = isOutputConnected(nodeId, fullKey);
+        const shouldShow = isConnected || isOutputVisible;
+        const { displayType, colorClass, hexColor } =
+          getTypeDisplayInfo(fieldSchema);
+        const isBroken = brokenOutputs.has(fullKey);
+
+        return shouldShow ? (
+          <div
+            key={fullKey}
+            className="flex flex-col items-end gap-2"
+            data-tutorial-id={`output-handler-${nodeId}-${fieldTitle}`}
+          >
+            <div className="relative flex items-center gap-2">
+              {fieldSchema?.description && (
+                <TooltipProvider>
+                  <Tooltip>
+                    <TooltipTrigger asChild>
+                      <span
+                        style={{ marginLeft: 6, cursor: "pointer" }}
+                        aria-label="info"
+                        tabIndex={0}
+                      >
+                        <InfoIcon />
+                      </span>
+                    </TooltipTrigger>
+                    <TooltipContent>{fieldSchema?.description}</TooltipContent>
+                  </Tooltip>
+                </TooltipProvider>
+              )}
+              <Text
+                variant="body"
+                className={cn(
+                  "text-slate-700",
+                  isBroken && "text-red-500 line-through",
+                )}
+              >
+                {fieldTitle}
+              </Text>
+              <Text
+                variant="small"
+                as="span"
+                className={cn(
+                  colorClass,
+                  isBroken && "!text-red-500 line-through",
+                )}
+              >
+                ({displayType})
+              </Text>
+
+              {showHandles && (
+                <OutputNodeHandle
+                  isBroken={isBroken}
+                  field_name={fullKey}
+                  nodeId={nodeId}
+                  hexColor={hexColor}
+                />
+              )}
+            </div>
+
+            {/* Recursively render nested properties */}
+            {fieldSchema?.properties &&
+              renderOutputHandles(
+                fieldSchema.properties,
+                fullKey,
+                `${fieldTitle}.`,
+              )}
+          </div>
+        ) : null;
+      },
+    );
+  };
 
   return (
-    <div className="flex flex-col items-end justify-between gap-2 rounded-b-xlarge border-t border-slate-200/50 bg-white py-3.5">
+    <div className="flex flex-col items-end justify-between gap-2 rounded-b-xlarge border-t border-zinc-200 bg-white py-3.5">
       <Button
         variant="ghost"
         className="mr-4 h-fit min-w-0 p-0 hover:border-transparent hover:bg-transparent"
@@ -49,50 +135,9 @@ export const OutputHandler = ({
         </Text>
       </Button>
 
-      {
-        <div className="flex flex-col items-end gap-2">
-          {Object.entries(properties).map(([key, property]: [string, any]) => {
-            const isConnected = isOutputConnected(nodeId, key);
-            const shouldShow = isConnected || isOutputVisible;
-            const { displayType, colorClass } = getTypeDisplayInfo(property);
-
-            return shouldShow ? (
-              <div key={key} className="relative flex items-center gap-2">
-                {property?.description && (
-                  <TooltipProvider>
-                    <Tooltip>
-                      <TooltipTrigger asChild>
-                        <span
-                          style={{ marginLeft: 6, cursor: "pointer" }}
-                          aria-label="info"
-                          tabIndex={0}
-                        >
-                          <InfoIcon />
-                        </span>
-                      </TooltipTrigger>
-                      <TooltipContent>{property?.description}</TooltipContent>
-                    </Tooltip>
-                  </TooltipProvider>
-                )}
-                <Text variant="body" className="text-slate-700">
-                  {property?.title || key}{" "}
-                </Text>
-                <Text variant="small" as="span" className={colorClass}>
-                  ({displayType})
-                </Text>
-
-                <NodeHandle
-                  handleId={
-                    uiType === BlockUIType.AGENT ? key : generateHandleId(key)
-                  }
-                  isConnected={isConnected}
-                  side="right"
-                />
-              </div>
-            ) : null;
-          })}
-        </div>
-      }
+      <div className="flex flex-col items-end gap-2">
+        {renderOutputHandles(properties)}
+      </div>
     </div>
   );
 };
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/helpers.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/helpers.ts
index 5572426dc7..46032a67ea 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/helpers.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/helpers.ts
@@ -89,17 +89,53 @@ export function extractOptions(
 
 // get display type and color for schema types [need for type display next to field name]
 export const getTypeDisplayInfo = (schema: any) => {
+  if (
+    schema?.type === "array" &&
+    "format" in schema &&
+    schema.format === "table"
+  ) {
+    return {
+      displayType: "table",
+      colorClass: "!text-indigo-500",
+      hexColor: "#6366f1",
+    };
+  }
+
   if (schema?.type === "string" && schema?.format) {
     const formatMap: Record<
       string,
-      { displayType: string; colorClass: string }
+      { displayType: string; colorClass: string; hexColor: string }
     > = {
-      file: { displayType: "file", colorClass: "!text-green-500" },
-      date: { displayType: "date", colorClass: "!text-blue-500" },
-      time: { displayType: "time", colorClass: "!text-blue-500" },
-      "date-time": { displayType: "datetime", colorClass: "!text-blue-500" },
-      "long-text": { displayType: "text", colorClass: "!text-green-500" },
-      "short-text": { displayType: "text", colorClass: "!text-green-500" },
+      file: {
+        displayType: "file",
+        colorClass: "!text-green-500",
+        hexColor: "#22c55e",
+      },
+      date: {
+        displayType: "date",
+        colorClass: "!text-blue-500",
+        hexColor: "#3b82f6",
+      },
+      time: {
+        displayType: "time",
+        colorClass: "!text-blue-500",
+        hexColor: "#3b82f6",
+      },
+      "date-time": {
+        displayType: "datetime",
+        colorClass: "!text-blue-500",
+        hexColor: "#3b82f6",
+      },
+      "long-text": {
+        displayType: "text",
+        colorClass: "!text-green-500",
+        hexColor: "#22c55e",
+      },
+      "short-text": {
+        displayType: "text",
+        colorClass: "!text-green-500",
+        hexColor: "#22c55e",
+      },
     };
 
     const formatInfo = formatMap[schema.format];
@@ -131,10 +167,23 @@ export const getTypeDisplayInfo = (schema: any) => {
     any: "!text-gray-500",
   };
 
+  const hexColorMap: Record<string, string> = {
+    string: "#22c55e",
+    number: "#3b82f6",
+    integer: "#3b82f6",
+    boolean: "#eab308",
+    object: "#a855f7",
+    array: "#6366f1",
+    null: "#6b7280",
+    any: "#6b7280",
+  };
+
   const colorClass = colorMap[schema?.type] || "!text-gray-500";
+  const hexColor = hexColorMap[schema?.type] || "#6b7280";
 
   return {
     displayType,
     colorClass,
+    hexColor,
   };
 };
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/uiSchema.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/uiSchema.ts
index ad1fab7c95..065e697828 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/uiSchema.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/uiSchema.ts
@@ -1,6 +1,6 @@
 export const uiSchema = {
   credentials: {
-    "ui:field": "credentials",
+    "ui:field": "custom/credential_field",
     provider: { "ui:widget": "hidden" },
     type: { "ui:widget": "hidden" },
     id: { "ui:autofocus": true },
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/useBrokenOutputs.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/useBrokenOutputs.ts
new file mode 100644
index 0000000000..61ef992a13
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/useBrokenOutputs.ts
@@ -0,0 +1,23 @@
+import { useMemo } from "react";
+import { useNodeStore } from "@/app/(platform)/build/stores/nodeStore";
+
+/**
+ * Hook to get the set of broken output names for a node in resolution mode.
+ */
+export function useBrokenOutputs(nodeID: string): Set<string> {
+  // Subscribe to the actual state values, not just methods
+  const isInResolution = useNodeStore((state) =>
+    state.nodesInResolutionMode.has(nodeID),
+  );
+  const resolutionData = useNodeStore((state) =>
+    state.nodeResolutionData.get(nodeID),
+  );
+
+  return useMemo(() => {
+    if (!isInResolution || !resolutionData) {
+      return new Set<string>();
+    }
+
+    return new Set(resolutionData.incompatibilities.missingOutputs);
+  }, [isInResolution, resolutionData]);
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/constants.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/constants.ts
new file mode 100644
index 0000000000..1a7e4176c6
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/constants.ts
@@ -0,0 +1,129 @@
+// Block IDs for tutorial blocks
+export const BLOCK_IDS = {
+  CALCULATOR: "b1ab9b19-67a6-406d-abf5-2dba76d00c79",
+  AGENT_INPUT: "c0a8e994-ebf1-4a9c-a4d8-89d09c86741b",
+  AGENT_OUTPUT: "363ae599-353e-4804-937e-b2ee3cef3da4",
+} as const;
+
+export const TUTORIAL_SELECTORS = {
+  // Custom nodes - These are all before saving
+  INPUT_NODE: '[data-id="custom-node-2"]',
+  OUTPUT_NODE: '[data-id="custom-node-3 "]',
+  CALCULATOR_NODE: '[data-id="custom-node-1"]',
+
+  // Paricular field selector
+  NAME_FIELD_OUTPUT_NODE: '[data-id="field-3-root_name"]',
+
+  // Output Handlers
+  SECOND_CALCULATOR_RESULT_OUTPUT_HANDLER:
+    '[data-tutorial-id="output-handler-2-result"]',
+  FIRST_CALCULATOR_RESULT_OUTPUT_HANDLER:
+    '[data-tutorial-id="output-handler-1-result"]',
+
+  // Input Handler
+  SECOND_CALCULATOR_NUMBER_A_INPUT_HANDLER:
+    '[data-tutorial-id="input-handler-2-a"]',
+  OUTPUT_VALUE_INPUT_HANDLEER: '[data-tutorial-id="label-3-root_value"]',
+
+  // Block Menu
+  BLOCKS_TRIGGER: '[data-id="blocks-control-popover-trigger"]',
+  BLOCKS_CONTENT: '[data-id="blocks-control-popover-content"]',
+  BLOCKS_SEARCH_INPUT:
+    '[data-id="blocks-control-search-bar"] input[type="text"]',
+  BLOCKS_SEARCH_INPUT_BOX: '[data-id="blocks-control-search-bar"]',
+
+  // Add a new selector that checks within search results
+
+  // Block Menu Sidebar
+  MENU_ITEM_INPUT_BLOCKS: '[data-id="menu-item-input_blocks"]',
+  MENU_ITEM_ALL_BLOCKS: '[data-id="menu-item-all_blocks"]',
+  MENU_ITEM_ACTION_BLOCKS: '[data-id="menu-item-action_blocks"]',
+  MENU_ITEM_OUTPUT_BLOCKS: '[data-id="menu-item-output_blocks"]',
+  MENU_ITEM_INTEGRATIONS: '[data-id="menu-item-integrations"]',
+  MENU_ITEM_MY_AGENTS: '[data-id="menu-item-my_agents"]',
+  MENU_ITEM_MARKETPLACE: '[data-id="menu-item-marketplace_agents"]',
+  MENU_ITEM_SUGGESTION: '[data-id="menu-item-suggestion"]',
+
+  // Block Cards
+  BLOCK_CARD_PREFIX: '[data-id^="block-card-"]',
+  BLOCK_CARD_AGENT_INPUT: '[data-id="block-card-AgentInputBlock"]',
+  // Calculator block - legacy ID used in old tutorial
+  BLOCK_CARD_CALCULATOR:
+    '[data-id="block-card-b1ab9b1967a6406dabf52dba76d00c79"]',
+  BLOCK_CARD_CALCULATOR_IN_SEARCH:
+    '[data-id="blocks-control-search-results"] [data-id="block-card-b1ab9b1967a6406dabf52dba76d00c79"]',
+
+  // Save Control
+  SAVE_TRIGGER: '[data-id="save-control-popover-trigger"]',
+  SAVE_CONTENT: '[data-id="save-control-popover-content"]',
+  SAVE_AGENT_BUTTON: '[data-id="save-control-save-agent"]',
+  SAVE_NAME_INPUT: '[data-id="save-control-name-input"]',
+  SAVE_DESCRIPTION_INPUT: '[data-id="save-control-description-input"]',
+
+  // Builder Actions (Run, Schedule, Outputs)
+  BUILDER_ACTIONS: '[data-id="builder-actions"]',
+  RUN_BUTTON: '[data-id="run-graph-button"]',
+  STOP_BUTTON: '[data-id="stop-graph-button"]',
+  SCHEDULE_BUTTON: '[data-id="schedule-graph-button"]',
+  AGENT_OUTPUTS_BUTTON: '[data-id="agent-outputs-button"]',
+
+  // Run Input Dialog
+  RUN_INPUT_DIALOG_CONTENT: '[data-id="run-input-dialog-content"]',
+  RUN_INPUT_CREDENTIALS_SECTION: '[data-id="run-input-credentials-section"]',
+  RUN_INPUT_CREDENTIALS_FORM: '[data-id="run-input-credentials-form"]',
+  RUN_INPUT_INPUTS_SECTION: '[data-id="run-input-inputs-section"]',
+  RUN_INPUT_INPUTS_FORM: '[data-id="run-input-inputs-form"]',
+  RUN_INPUT_ACTIONS_SECTION: '[data-id="run-input-actions-section"]',
+  RUN_INPUT_MANUAL_RUN_BUTTON: '[data-id="run-input-manual-run-button"]',
+  RUN_INPUT_SCHEDULE_BUTTON: '[data-id="run-input-schedule-button"]',
+
+  // Custom Controls (bottom left)
+  CUSTOM_CONTROLS: '[data-id="custom-controls"]',
+  ZOOM_IN_BUTTON: '[data-id="zoom-in-button"]',
+  ZOOM_OUT_BUTTON: '[data-id="zoom-out-button"]',
+  FIT_VIEW_BUTTON: '[data-id="fit-view-button"]',
+  LOCK_BUTTON: '[data-id="lock-button"]',
+  TUTORIAL_BUTTON: '[data-id="tutorial-button"]',
+
+  // Canvas
+  REACT_FLOW_CANVAS: ".react-flow__pane",
+  REACT_FLOW_NODE: ".react-flow__node",
+  REACT_FLOW_NODE_FIRST: '[data-testid^="rf__node-"]:first-child',
+  REACT_FLOW_EDGE: '[data-testid^="rf__edge-"]',
+
+  // Node elements
+  NODE_CONTAINER: '[data-id^="custom-node-"]',
+  NODE_HEADER: '[data-id^="node-header-"]',
+  NODE_INPUT_HANDLES: '[data-tutorial-id="input-handles"]',
+  NODE_OUTPUT_HANDLE: '[data-handlepos="right"]',
+  NODE_INPUT_HANDLE: "[data-nodeid]",
+  FIRST_CALCULATOR_NODE_OUTPUT: '[data-tutorial-id="node-output"]',
+  // These are the Id's of the nodes before saving
+  CALCULATOR_NODE_FORM_CONTAINER: '[data-id^="form-creator-container-1-node"]', // <-- Add this line
+  AGENT_INPUT_NODE_FORM_CONTAINER: '[data-id^="form-creator-container-2-node"]', // <-- Add this line
+  AGENT_OUTPUT_NODE_FORM_CONTAINER:
+    '[data-id^="form-creator-container-3-node"]', // <-- Add this line
+
+  // Execution badges
+  BADGE_QUEUED: '[data-id^="badge-"][data-id$="-QUEUED"]',
+  BADGE_COMPLETED: '[data-id^="badge-"][data-id$="-COMPLETED"]',
+
+  // Undo/Redo
+  UNDO_BUTTON: '[data-id="undo-button"]',
+  REDO_BUTTON: '[data-id="redo-button"]',
+} as const;
+
+export const CSS_CLASSES = {
+  DISABLE: "new-builder-tutorial-disable",
+  HIGHLIGHT: "new-builder-tutorial-highlight",
+  PULSE: "new-builder-tutorial-pulse",
+} as const;
+
+export const TUTORIAL_CONFIG = {
+  ELEMENT_CHECK_INTERVAL: 50, // ms
+  INPUT_CHECK_INTERVAL: 100, // ms
+  USE_MODAL_OVERLAY: true,
+  SCROLL_BEHAVIOR: "smooth" as const,
+  SCROLL_BLOCK: "center" as const,
+  SEARCH_TERM_CALCULATOR: "Calculator",
+} as const;
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/blocks.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/blocks.ts
new file mode 100644
index 0000000000..040991450f
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/blocks.ts
@@ -0,0 +1,89 @@
+import { BLOCK_IDS } from "../constants";
+import { useNodeStore } from "../../../../stores/nodeStore";
+import { getV2GetSpecificBlocks } from "@/app/api/__generated__/endpoints/default/default";
+import { BlockInfo } from "@/app/api/__generated__/models/blockInfo";
+
+const prefetchedBlocks: Map<string, BlockInfo> = new Map();
+
+export const prefetchTutorialBlocks = async (): Promise<void> => {
+  try {
+    const blockIds = [BLOCK_IDS.CALCULATOR];
+    const response = await getV2GetSpecificBlocks({ block_ids: blockIds });
+
+    if (response.status === 200 && response.data) {
+      response.data.forEach((block) => {
+        prefetchedBlocks.set(block.id, block);
+      });
+      console.debug("Tutorial blocks prefetched:", prefetchedBlocks.size);
+    }
+  } catch (error) {
+    console.error("Failed to prefetch tutorial blocks:", error);
+  }
+};
+
+export const getPrefetchedBlock = (blockId: string): BlockInfo | undefined => {
+  return prefetchedBlocks.get(blockId);
+};
+
+export const clearPrefetchedBlocks = (): void => {
+  prefetchedBlocks.clear();
+};
+
+export const addPrefetchedBlock = (
+  blockId: string,
+  position?: { x: number; y: number },
+): void => {
+  const block = prefetchedBlocks.get(blockId);
+  if (block) {
+    useNodeStore.getState().addBlock(block, {}, position);
+  } else {
+    console.error(`Block ${blockId} not found in prefetched blocks`);
+  }
+};
+
+export const getNodeByBlockId = (blockId: string) => {
+  const nodes = useNodeStore.getState().nodes;
+  return nodes.find((n) => n.data?.block_id === blockId);
+};
+
+export const addSecondCalculatorBlock = (): void => {
+  const firstCalculatorNode = getNodeByBlockId(BLOCK_IDS.CALCULATOR);
+
+  if (firstCalculatorNode) {
+    const calcX = firstCalculatorNode.position.x;
+    const calcY = firstCalculatorNode.position.y;
+
+    addPrefetchedBlock(BLOCK_IDS.CALCULATOR, {
+      x: calcX + 500,
+      y: calcY,
+    });
+  } else {
+    addPrefetchedBlock(BLOCK_IDS.CALCULATOR);
+  }
+};
+
+export const getCalculatorNodes = () => {
+  const nodes = useNodeStore.getState().nodes;
+  return nodes.filter((n) => n.data?.block_id === BLOCK_IDS.CALCULATOR);
+};
+
+export const getSecondCalculatorNode = () => {
+  const calculatorNodes = getCalculatorNodes();
+  return calculatorNodes.length >= 2 ? calculatorNodes[1] : null;
+};
+
+export const getFormContainerSelector = (blockId: string): string | null => {
+  const node = getNodeByBlockId(blockId);
+  if (node) {
+    return `[data-id="form-creator-container-${node.id}"]`;
+  }
+  return null;
+};
+
+export const getFormContainerElement = (blockId: string): Element | null => {
+  const selector = getFormContainerSelector(blockId);
+  if (selector) {
+    return document.querySelector(selector);
+  }
+  return null;
+};
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/canvas.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/canvas.ts
new file mode 100644
index 0000000000..dd3d8576d9
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/canvas.ts
@@ -0,0 +1,83 @@
+import { TUTORIAL_CONFIG, TUTORIAL_SELECTORS } from "../constants";
+import { useNodeStore } from "../../../../stores/nodeStore";
+
+export const waitForNodeOnCanvas = (
+  timeout = 10000,
+): Promise<Element | null> => {
+  return new Promise((resolve) => {
+    const startTime = Date.now();
+
+    const checkNode = () => {
+      const storeNodes = useNodeStore.getState().nodes;
+      if (storeNodes.length > 0) {
+        const domNode = document.querySelector(
+          TUTORIAL_SELECTORS.REACT_FLOW_NODE,
+        );
+        if (domNode) {
+          resolve(domNode);
+          return;
+        }
+      }
+
+      if (Date.now() - startTime > timeout) {
+        resolve(null);
+      } else {
+        setTimeout(checkNode, TUTORIAL_CONFIG.ELEMENT_CHECK_INTERVAL);
+      }
+    };
+    checkNode();
+  });
+};
+
+export const waitForNodesCount = (
+  count: number,
+  timeout = 10000,
+): Promise<boolean> => {
+  return new Promise((resolve) => {
+    const startTime = Date.now();
+
+    const checkNodes = () => {
+      const currentCount = useNodeStore.getState().nodes.length;
+      if (currentCount >= count) {
+        resolve(true);
+      } else if (Date.now() - startTime > timeout) {
+        resolve(false);
+      } else {
+        setTimeout(checkNodes, TUTORIAL_CONFIG.ELEMENT_CHECK_INTERVAL);
+      }
+    };
+    checkNodes();
+  });
+};
+
+export const getNodesCount = (): number => {
+  return useNodeStore.getState().nodes.length;
+};
+
+export const getFirstNode = () => {
+  const nodes = useNodeStore.getState().nodes;
+  return nodes.length > 0 ? nodes[0] : null;
+};
+
+export const getNodeById = (nodeId: string) => {
+  const nodes = useNodeStore.getState().nodes;
+  return nodes.find((n) => n.id === nodeId);
+};
+
+export const nodeHasValues = (nodeId: string): boolean => {
+  const node = getNodeById(nodeId);
+  if (!node) return false;
+  const hardcodedValues = node.data?.hardcodedValues || {};
+  return Object.values(hardcodedValues).some(
+    (value) => value !== undefined && value !== null && value !== "",
+  );
+};
+
+export const fitViewToScreen = () => {
+  const fitViewButton = document.querySelector(
+    TUTORIAL_SELECTORS.FIT_VIEW_BUTTON,
+  ) as HTMLButtonElement;
+  if (fitViewButton) {
+    fitViewButton.click();
+  }
+};
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/connections.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/connections.ts
new file mode 100644
index 0000000000..4ec8c4df74
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/connections.ts
@@ -0,0 +1,19 @@
+import { useNodeStore } from "../../../../stores/nodeStore";
+import { useEdgeStore } from "../../../../stores/edgeStore";
+
+export const isConnectionMade = (
+  sourceBlockId: string,
+  targetBlockId: string,
+): boolean => {
+  const edges = useEdgeStore.getState().edges;
+  const nodes = useNodeStore.getState().nodes;
+
+  const sourceNode = nodes.find((n) => n.data?.block_id === sourceBlockId);
+  const targetNode = nodes.find((n) => n.data?.block_id === targetBlockId);
+
+  if (!sourceNode || !targetNode) return false;
+
+  return edges.some((edge) => {
+    return edge.source === sourceNode.id && edge.target === targetNode.id;
+  });
+};
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/dom.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/dom.ts
new file mode 100644
index 0000000000..3ae9359cd9
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/dom.ts
@@ -0,0 +1,180 @@
+import { TUTORIAL_CONFIG, TUTORIAL_SELECTORS } from "../constants";
+
+export const waitForElement = (
+  selector: string,
+  timeout = 10000,
+): Promise<Element> => {
+  return new Promise((resolve, reject) => {
+    const startTime = Date.now();
+
+    const checkElement = () => {
+      const element = document.querySelector(selector);
+      if (element) {
+        resolve(element);
+      } else if (Date.now() - startTime > timeout) {
+        reject(new Error(`Element ${selector} not found within ${timeout}ms`));
+      } else {
+        setTimeout(checkElement, TUTORIAL_CONFIG.ELEMENT_CHECK_INTERVAL);
+      }
+    };
+    checkElement();
+  });
+};
+
+export const waitForInputValue = (
+  selector: string,
+  targetValue: string,
+  timeout = 30000,
+): Promise<void> => {
+  return new Promise((resolve) => {
+    const startTime = Date.now();
+
+    const checkInput = () => {
+      const input = document.querySelector(selector) as HTMLInputElement;
+      if (input) {
+        const currentValue = input.value.toLowerCase().trim();
+        const target = targetValue.toLowerCase().trim();
+
+        if (currentValue.includes(target) || target.includes(currentValue)) {
+          if (currentValue.length >= 4 || currentValue === target) {
+            resolve();
+            return;
+          }
+        }
+      }
+
+      if (Date.now() - startTime > timeout) {
+        resolve();
+      } else {
+        setTimeout(checkInput, TUTORIAL_CONFIG.INPUT_CHECK_INTERVAL);
+      }
+    };
+    checkInput();
+  });
+};
+
+export const waitForSearchResult = (
+  selector: string,
+  timeout = 15000,
+): Promise<Element | null> => {
+  return new Promise((resolve) => {
+    const startTime = Date.now();
+
+    const checkResult = () => {
+      const element = document.querySelector(selector);
+      if (element) {
+        resolve(element);
+      } else if (Date.now() - startTime > timeout) {
+        resolve(null);
+      } else {
+        setTimeout(checkResult, TUTORIAL_CONFIG.ELEMENT_CHECK_INTERVAL);
+      }
+    };
+    checkResult();
+  });
+};
+
+export const waitForAnyBlockCard = (
+  timeout = 10000,
+): Promise<Element | null> => {
+  return new Promise((resolve) => {
+    const startTime = Date.now();
+
+    const checkBlock = () => {
+      const block = document.querySelector(
+        TUTORIAL_SELECTORS.BLOCK_CARD_PREFIX,
+      );
+      if (block) {
+        resolve(block);
+      } else if (Date.now() - startTime > timeout) {
+        resolve(null);
+      } else {
+        setTimeout(checkBlock, TUTORIAL_CONFIG.ELEMENT_CHECK_INTERVAL);
+      }
+    };
+    checkBlock();
+  });
+};
+
+export const focusElement = (selector: string): void => {
+  const element = document.querySelector(selector) as HTMLElement;
+  if (element) {
+    element.focus();
+  }
+};
+
+export const scrollIntoView = (selector: string): void => {
+  const element = document.querySelector(selector);
+  if (element) {
+    element.scrollIntoView({
+      behavior: "smooth",
+      block: "center",
+    });
+  }
+};
+
+export const typeIntoInput = (selector: string, text: string) => {
+  const input = document.querySelector(selector) as HTMLInputElement;
+  if (input) {
+    input.focus();
+    input.value = text;
+    input.dispatchEvent(new Event("input", { bubbles: true }));
+    input.dispatchEvent(new Event("change", { bubbles: true }));
+  }
+};
+
+export const observeElement = (
+  selector: string,
+  callback: (element: Element) => void,
+): MutationObserver => {
+  const observer = new MutationObserver((mutations, obs) => {
+    const element = document.querySelector(selector);
+    if (element) {
+      callback(element);
+      obs.disconnect();
+    }
+  });
+
+  observer.observe(document.body, {
+    childList: true,
+    subtree: true,
+  });
+
+  const element = document.querySelector(selector);
+  if (element) {
+    callback(element);
+    observer.disconnect();
+  }
+
+  return observer;
+};
+
+export const watchSearchInput = (
+  targetValue: string,
+  onMatch: () => void,
+): (() => void) => {
+  const input = document.querySelector(
+    TUTORIAL_SELECTORS.BLOCKS_SEARCH_INPUT,
+  ) as HTMLInputElement;
+  if (!input) return () => {};
+
+  let hasMatched = false;
+
+  const handler = () => {
+    if (hasMatched) return;
+
+    const currentValue = input.value.toLowerCase().trim();
+    const target = targetValue.toLowerCase().trim();
+
+    if (currentValue.length >= 4 && target.startsWith(currentValue)) {
+      hasMatched = true;
+      onMatch();
+    }
+  };
+
+  input.addEventListener("input", handler);
+
+  return () => {
+    input.removeEventListener("input", handler);
+  };
+};
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/highlights.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/highlights.ts
new file mode 100644
index 0000000000..4f425f5c9c
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/highlights.ts
@@ -0,0 +1,56 @@
+import { CSS_CLASSES, TUTORIAL_SELECTORS } from "../constants";
+
+export const disableOtherBlocks = (targetBlockSelector: string) => {
+  document
+    .querySelectorAll(TUTORIAL_SELECTORS.BLOCK_CARD_PREFIX)
+    .forEach((block) => {
+      const isTarget = block.matches(targetBlockSelector);
+      block.classList.toggle(CSS_CLASSES.DISABLE, !isTarget);
+      block.classList.toggle(CSS_CLASSES.HIGHLIGHT, isTarget);
+    });
+};
+
+export const enableAllBlocks = () => {
+  document
+    .querySelectorAll(TUTORIAL_SELECTORS.BLOCK_CARD_PREFIX)
+    .forEach((block) => {
+      block.classList.remove(
+        CSS_CLASSES.DISABLE,
+        CSS_CLASSES.HIGHLIGHT,
+        CSS_CLASSES.PULSE,
+      );
+    });
+};
+
+export const highlightElement = (selector: string) => {
+  const element = document.querySelector(selector);
+  if (element) {
+    element.classList.add(CSS_CLASSES.HIGHLIGHT);
+  }
+};
+
+export const removeAllHighlights = () => {
+  document.querySelectorAll(`.${CSS_CLASSES.HIGHLIGHT}`).forEach((el) => {
+    el.classList.remove(CSS_CLASSES.HIGHLIGHT);
+  });
+  document.querySelectorAll(`.${CSS_CLASSES.PULSE}`).forEach((el) => {
+    el.classList.remove(CSS_CLASSES.PULSE);
+  });
+};
+
+export const pulseElement = (selector: string) => {
+  const element = document.querySelector(selector);
+  if (element) {
+    element.classList.add(CSS_CLASSES.PULSE);
+  }
+};
+
+export const highlightFirstBlockInSearch = () => {
+  const firstBlock = document.querySelector(
+    TUTORIAL_SELECTORS.BLOCK_CARD_PREFIX,
+  );
+  if (firstBlock) {
+    firstBlock.classList.add(CSS_CLASSES.PULSE);
+    firstBlock.scrollIntoView({ behavior: "smooth", block: "center" });
+  }
+};
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/index.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/index.ts
new file mode 100644
index 0000000000..bd60ef06bb
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/index.ts
@@ -0,0 +1,66 @@
+export {
+  waitForElement,
+  waitForInputValue,
+  waitForSearchResult,
+  waitForAnyBlockCard,
+  focusElement,
+  scrollIntoView,
+  typeIntoInput,
+  observeElement,
+  watchSearchInput,
+} from "./dom";
+
+export {
+  disableOtherBlocks,
+  enableAllBlocks,
+  highlightElement,
+  removeAllHighlights,
+  pulseElement,
+  highlightFirstBlockInSearch,
+} from "./highlights";
+
+export {
+  prefetchTutorialBlocks,
+  getPrefetchedBlock,
+  clearPrefetchedBlocks,
+  addPrefetchedBlock,
+  getNodeByBlockId,
+  addSecondCalculatorBlock,
+  getCalculatorNodes,
+  getSecondCalculatorNode,
+  getFormContainerSelector,
+  getFormContainerElement,
+} from "./blocks";
+
+export {
+  waitForNodeOnCanvas,
+  waitForNodesCount,
+  getNodesCount,
+  getFirstNode,
+  getNodeById,
+  nodeHasValues,
+  fitViewToScreen,
+} from "./canvas";
+
+export { isConnectionMade } from "./connections";
+
+export {
+  forceBlockMenuOpen,
+  openBlockMenu,
+  closeBlockMenu,
+  clearBlockMenuSearch,
+} from "./menu";
+
+export {
+  openSaveControl,
+  closeSaveControl,
+  forceSaveOpen,
+  clickSaveButton,
+  isAgentSaved,
+} from "./save";
+
+export {
+  handleTutorialCancel,
+  handleTutorialSkip,
+  handleTutorialComplete,
+} from "./state";
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/menu.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/menu.ts
new file mode 100644
index 0000000000..905e34dfb9
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/menu.ts
@@ -0,0 +1,25 @@
+import { TUTORIAL_SELECTORS } from "../constants";
+import { useControlPanelStore } from "../../../../stores/controlPanelStore";
+
+export const forceBlockMenuOpen = (force: boolean) => {
+  useControlPanelStore.getState().setForceOpenBlockMenu(force);
+};
+
+export const openBlockMenu = () => {
+  useControlPanelStore.getState().setBlockMenuOpen(true);
+};
+
+export const closeBlockMenu = () => {
+  useControlPanelStore.getState().setBlockMenuOpen(false);
+  useControlPanelStore.getState().setForceOpenBlockMenu(false);
+};
+
+export const clearBlockMenuSearch = () => {
+  const input = document.querySelector(
+    TUTORIAL_SELECTORS.BLOCKS_SEARCH_INPUT,
+  ) as HTMLInputElement;
+  if (input) {
+    input.value = "";
+    input.dispatchEvent(new Event("input", { bubbles: true }));
+  }
+};
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/save.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/save.ts
new file mode 100644
index 0000000000..e932ee1b84
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/save.ts
@@ -0,0 +1,31 @@
+import { TUTORIAL_SELECTORS } from "../constants";
+import { useControlPanelStore } from "../../../../stores/controlPanelStore";
+
+export const openSaveControl = () => {
+  useControlPanelStore.getState().setSaveControlOpen(true);
+};
+
+export const closeSaveControl = () => {
+  useControlPanelStore.getState().setSaveControlOpen(false);
+  useControlPanelStore.getState().setForceOpenSave(false);
+};
+
+export const forceSaveOpen = (force: boolean) => {
+  useControlPanelStore.getState().setForceOpenSave(force);
+};
+
+export const clickSaveButton = () => {
+  const saveButton = document.querySelector(
+    TUTORIAL_SELECTORS.SAVE_AGENT_BUTTON,
+  ) as HTMLButtonElement;
+  if (saveButton && !saveButton.disabled) {
+    saveButton.click();
+  }
+};
+
+export const isAgentSaved = (): boolean => {
+  const versionInput = document.querySelector(
+    '[data-tutorial-id="save-control-version-output"]',
+  ) as HTMLInputElement;
+  return !!(versionInput && versionInput.value && versionInput.value !== "-");
+};
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/state.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/state.ts
new file mode 100644
index 0000000000..43e19c40d4
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/helpers/state.ts
@@ -0,0 +1,49 @@
+import { Key, storage } from "@/services/storage/local-storage";
+import { closeBlockMenu } from "./menu";
+import { closeSaveControl, forceSaveOpen } from "./save";
+import { removeAllHighlights, enableAllBlocks } from "./highlights";
+
+const clearTutorialIntervals = () => {
+  const intervalKeys = [
+    "__tutorialCalcInterval",
+    "__tutorialCheckInterval",
+    "__tutorialSecondCalcInterval",
+  ];
+
+  intervalKeys.forEach((key) => {
+    if ((window as any)[key]) {
+      clearInterval((window as any)[key]);
+      delete (window as any)[key];
+    }
+  });
+};
+
+export const handleTutorialCancel = (_tour?: any) => {
+  clearTutorialIntervals();
+  closeBlockMenu();
+  closeSaveControl();
+  forceSaveOpen(false);
+  removeAllHighlights();
+  enableAllBlocks();
+  storage.set(Key.SHEPHERD_TOUR, "canceled");
+};
+
+export const handleTutorialSkip = (_tour?: any) => {
+  clearTutorialIntervals();
+  closeBlockMenu();
+  closeSaveControl();
+  forceSaveOpen(false);
+  removeAllHighlights();
+  enableAllBlocks();
+  storage.set(Key.SHEPHERD_TOUR, "skipped");
+};
+
+export const handleTutorialComplete = () => {
+  clearTutorialIntervals();
+  closeBlockMenu();
+  closeSaveControl();
+  forceSaveOpen(false);
+  removeAllHighlights();
+  enableAllBlocks();
+  storage.set(Key.SHEPHERD_TOUR, "completed");
+};
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/icons.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/icons.ts
new file mode 100644
index 0000000000..19e133ef7d
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/icons.ts
@@ -0,0 +1,7 @@
+// These are SVG Phosphor icons
+
+export const ICONS = {
+  ClickIcon: `<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="#000000" viewBox="0 0 256 256"><path d="M88,24V16a8,8,0,0,1,16,0v8a8,8,0,0,1-16,0ZM16,104h8a8,8,0,0,0,0-16H16a8,8,0,0,0,0,16ZM124.42,39.16a8,8,0,0,0,10.74-3.58l8-16a8,8,0,0,0-14.31-7.16l-8,16A8,8,0,0,0,124.42,39.16Zm-96,81.69-16,8a8,8,0,0,0,7.16,14.31l16-8a8,8,0,1,0-7.16-14.31ZM219.31,184a16,16,0,0,1,0,22.63l-12.68,12.68a16,16,0,0,1-22.63,0L132.7,168,115,214.09c0,.1-.08.21-.13.32a15.83,15.83,0,0,1-14.6,9.59l-.79,0a15.83,15.83,0,0,1-14.41-11L32.8,52.92A16,16,0,0,1,52.92,32.8L213,85.07a16,16,0,0,1,1.41,29.8l-.32.13L168,132.69ZM208,195.31,156.69,144h0a16,16,0,0,1,4.93-26l.32-.14,45.95-17.64L48,48l52.2,159.86,17.65-46c0-.11.08-.22.13-.33a16,16,0,0,1,11.69-9.34,16.72,16.72,0,0,1,3-.28,16,16,0,0,1,11.3,4.69L195.31,208Z"></path></svg>`,
+  Keyboard: `<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="#000000" viewBox="0 0 256 256"><path d="M224,48H32A16,16,0,0,0,16,64V192a16,16,0,0,0,16,16H224a16,16,0,0,0,16-16V64A16,16,0,0,0,224,48Zm0,144H32V64H224V192Zm-16-64a8,8,0,0,1-8,8H56a8,8,0,0,1,0-16H200A8,8,0,0,1,208,128Zm0-32a8,8,0,0,1-8,8H56a8,8,0,0,1,0-16H200A8,8,0,0,1,208,96ZM72,160a8,8,0,0,1-8,8H56a8,8,0,0,1,0-16h8A8,8,0,0,1,72,160Zm96,0a8,8,0,0,1-8,8H96a8,8,0,0,1,0-16h64A8,8,0,0,1,168,160Zm40,0a8,8,0,0,1-8,8h-8a8,8,0,0,1,0-16h8A8,8,0,0,1,208,160Z"></path></svg>`,
+  Drag: `<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="#000000" viewBox="0 0 256 256"><path d="M188,80a27.79,27.79,0,0,0-13.36,3.4,28,28,0,0,0-46.64-11A28,28,0,0,0,80,92v20H68a28,28,0,0,0-28,28v12a88,88,0,0,0,176,0V108A28,28,0,0,0,188,80Zm12,72a72,72,0,0,1-144,0V140a12,12,0,0,1,12-12H80v24a8,8,0,0,0,16,0V92a12,12,0,0,1,24,0v28a8,8,0,0,0,16,0V92a12,12,0,0,1,24,0v28a8,8,0,0,0,16,0V108a12,12,0,0,1,24,0Z"></path></svg>`,
+};
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/index.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/index.ts
new file mode 100644
index 0000000000..fac08ec145
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/index.ts
@@ -0,0 +1,81 @@
+import Shepherd from "shepherd.js";
+import { analytics } from "@/services/analytics";
+import { TUTORIAL_CONFIG } from "./constants";
+import { createTutorialSteps } from "./steps";
+import { injectTutorialStyles, removeTutorialStyles } from "./styles";
+import {
+  handleTutorialComplete,
+  handleTutorialCancel,
+  prefetchTutorialBlocks,
+  clearPrefetchedBlocks,
+} from "./helpers";
+import { useNodeStore } from "../../../stores/nodeStore";
+import { useEdgeStore } from "../../../stores/edgeStore";
+
+let isTutorialLoading = false;
+let tutorialLoadingCallback: ((loading: boolean) => void) | null = null;
+
+export const setTutorialLoadingCallback = (
+  callback: (loading: boolean) => void,
+) => {
+  tutorialLoadingCallback = callback;
+};
+
+export const getTutorialLoadingState = () => isTutorialLoading;
+
+export const startTutorial = async () => {
+  isTutorialLoading = true;
+  tutorialLoadingCallback?.(true);
+
+  useNodeStore.getState().setNodes([]);
+  useEdgeStore.getState().setEdges([]);
+  useNodeStore.getState().setNodeCounter(0);
+
+  try {
+    await prefetchTutorialBlocks();
+  } finally {
+    isTutorialLoading = false;
+    tutorialLoadingCallback?.(false);
+  }
+
+  const tour = new Shepherd.Tour({
+    useModalOverlay: TUTORIAL_CONFIG.USE_MODAL_OVERLAY,
+    defaultStepOptions: {
+      cancelIcon: { enabled: true },
+      scrollTo: {
+        behavior: TUTORIAL_CONFIG.SCROLL_BEHAVIOR,
+        block: TUTORIAL_CONFIG.SCROLL_BLOCK,
+      },
+      classes: "new-builder-tour",
+      modalOverlayOpeningRadius: 4,
+    },
+  });
+
+  injectTutorialStyles();
+
+  const steps = createTutorialSteps(tour);
+  steps.forEach((step) => tour.addStep(step));
+
+  tour.on("complete", () => {
+    handleTutorialComplete();
+    removeTutorialStyles();
+    clearPrefetchedBlocks();
+  });
+
+  tour.on("cancel", () => {
+    handleTutorialCancel(tour);
+    removeTutorialStyles();
+    clearPrefetchedBlocks();
+  });
+
+  for (const step of tour.steps) {
+    step.on("show", () => {
+      console.debug("sendTutorialStep", step.id);
+      analytics.sendGAEvent("event", "tutorial_step_shown", {
+        value: step.id,
+      });
+    });
+  }
+
+  tour.start();
+};
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/block-basics.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/block-basics.ts
new file mode 100644
index 0000000000..89be102a74
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/block-basics.ts
@@ -0,0 +1,114 @@
+import { StepOptions } from "shepherd.js";
+import { TUTORIAL_SELECTORS } from "../constants";
+import {
+  waitForElement,
+  waitForNodeOnCanvas,
+  closeBlockMenu,
+  fitViewToScreen,
+  highlightElement,
+  removeAllHighlights,
+} from "../helpers";
+import { ICONS } from "../icons";
+import { banner } from "../styles";
+
+export const createBlockBasicsSteps = (tour: any): StepOptions[] => [
+  {
+    id: "focus-new-block",
+    title: "Your First Block!",
+    text: `
+      <div class="text-sm leading-[1.375rem] text-zinc-800">
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0">Excellent! This is your <strong>Calculator Block</strong>.</p>
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0" style="margin-top: 0.5rem;">Let's explore how blocks work.</p>
+      </div>
+    `,
+    attachTo: {
+      element: TUTORIAL_SELECTORS.REACT_FLOW_NODE,
+      on: "right",
+    },
+    beforeShowPromise: async () => {
+      closeBlockMenu();
+      await waitForNodeOnCanvas(5000);
+      await new Promise((resolve) => setTimeout(resolve, 300));
+      fitViewToScreen();
+    },
+    when: {
+      show: () => {
+        const node = document.querySelector(TUTORIAL_SELECTORS.REACT_FLOW_NODE);
+        if (node) {
+          highlightElement(TUTORIAL_SELECTORS.REACT_FLOW_NODE);
+        }
+      },
+      hide: () => {
+        removeAllHighlights();
+      },
+    },
+    buttons: [
+      {
+        text: "Show me",
+        action: () => tour.next(),
+      },
+    ],
+  },
+
+  {
+    id: "input-handles",
+    title: "Input Handles",
+    text: `
+      <div class="text-sm leading-[1.375rem] text-zinc-800">
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0">On the <strong>left side</strong> of the block are <strong>input handles</strong>.</p>
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0" style="margin-top: 0.5rem;">These are where data flows <em>into</em> the block from other blocks.</p>
+      </div>
+    `,
+    attachTo: {
+      element: TUTORIAL_SELECTORS.NODE_INPUT_HANDLE,
+      on: "bottom",
+    },
+    classes: "new-builder-tour input-handles-step",
+    beforeShowPromise: () =>
+      waitForElement(TUTORIAL_SELECTORS.NODE_INPUT_HANDLE, 3000).catch(
+        () => {},
+      ),
+    buttons: [
+      {
+        text: "Back",
+        action: () => tour.back(),
+        classes: "shepherd-button-secondary",
+      },
+      {
+        text: "Next",
+        action: () => tour.next(),
+      },
+    ],
+  },
+
+  {
+    id: "output-handles",
+    title: "Output Handles",
+    text: `
+      <div class="text-sm leading-[1.375rem] text-zinc-800">
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0">On the <strong>right side</strong> is the <strong>output handle</strong>.</p>
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0" style="margin-top: 0.5rem;">This is where the result flows <em>out</em> to connect to other blocks.</p>
+        ${banner(ICONS.Drag, "You can drag from output to input handler to connect blocks", "info")}
+      </div>
+    `,
+    attachTo: {
+      element: TUTORIAL_SELECTORS.NODE_OUTPUT_HANDLE,
+      on: "right",
+    },
+    beforeShowPromise: () =>
+      waitForElement(TUTORIAL_SELECTORS.NODE_OUTPUT_HANDLE, 3000).catch(
+        () => {},
+      ),
+    buttons: [
+      {
+        text: "Back",
+        action: () => tour.back(),
+        classes: "shepherd-button-secondary",
+      },
+      {
+        text: "Next →",
+        action: () => tour.next(),
+      },
+    ],
+  },
+];
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/block-menu.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/block-menu.ts
new file mode 100644
index 0000000000..6a1eaf33d5
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/block-menu.ts
@@ -0,0 +1,198 @@
+import { StepOptions } from "shepherd.js";
+import { TUTORIAL_CONFIG, TUTORIAL_SELECTORS, BLOCK_IDS } from "../constants";
+import {
+  waitForElement,
+  forceBlockMenuOpen,
+  focusElement,
+  highlightElement,
+  removeAllHighlights,
+  disableOtherBlocks,
+  enableAllBlocks,
+  pulseElement,
+  highlightFirstBlockInSearch,
+} from "../helpers";
+import { ICONS } from "../icons";
+import { banner } from "../styles";
+import { useNodeStore } from "../../../../stores/nodeStore";
+
+export const createBlockMenuSteps = (tour: any): StepOptions[] => [
+  {
+    id: "open-block-menu",
+    title: "Open the Block Menu",
+    text: `
+      <div class="text-sm leading-[1.375rem] text-zinc-800">
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0">Let's start by opening the Block Menu.</p>
+        ${banner(ICONS.ClickIcon, "Click this button to open the menu", "action")}
+      </div>
+    `,
+    attachTo: {
+      element: TUTORIAL_SELECTORS.BLOCKS_TRIGGER,
+      on: "right",
+    },
+    advanceOn: {
+      selector: TUTORIAL_SELECTORS.BLOCKS_TRIGGER,
+      event: "click",
+    },
+    buttons: [],
+    when: {
+      show: () => {
+        highlightElement(TUTORIAL_SELECTORS.BLOCKS_TRIGGER);
+      },
+      hide: () => {
+        removeAllHighlights();
+      },
+    },
+  },
+
+  {
+    id: "block-menu-overview",
+    title: "The Block Menu",
+    text: `
+      <div class="text-sm leading-[1.375rem] text-zinc-800">
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0">This is the <strong>Block Menu</strong> — your toolbox for building agents.</p>
+        <p class="text-sm font-medium leading-[1.375rem] text-zinc-800 m-0" style="margin-top: 0.5rem;">Here you'll find:</p>
+        <ul>
+          <li><strong>Input Blocks</strong> — Entry points for data</li>
+          <li><strong>Action Blocks</strong> — Processing and AI operations</li>
+          <li><strong>Output Blocks</strong> — Results and responses</li>
+          <li><strong>Integrations</strong> — Third-party service blocks</li>
+          <li><strong>Library Agents</strong> — Your personal agents</li>
+          <li><strong>Marketplace Agents</strong> — Community agents</li>
+        </ul>
+      </div>
+    `,
+    attachTo: {
+      element: TUTORIAL_SELECTORS.BLOCKS_CONTENT,
+      on: "left",
+    },
+    beforeShowPromise: () => waitForElement(TUTORIAL_SELECTORS.BLOCKS_CONTENT),
+    when: {
+      show: () => forceBlockMenuOpen(true),
+    },
+    buttons: [
+      {
+        text: "Next",
+        action: () => tour.next(),
+      },
+    ],
+  },
+
+  {
+    id: "search-calculator",
+    title: "Search for a Block",
+    text: `
+      <div class="text-sm leading-[1.375rem] text-zinc-800">
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0">Let's add a Calculator block to start.</p>
+        ${banner(ICONS.Keyboard, "Type Calculator in the search bar", "action")}
+        <p class="text-xs font-normal leading-[1.125rem] text-zinc-500 m-0" style="margin-top: 0.5rem;">The search will filter blocks as you type.</p>
+      </div>
+    `,
+    attachTo: {
+      element: TUTORIAL_SELECTORS.BLOCKS_SEARCH_INPUT_BOX,
+      on: "bottom",
+    },
+    beforeShowPromise: () =>
+      waitForElement(TUTORIAL_SELECTORS.BLOCKS_SEARCH_INPUT_BOX),
+    when: {
+      show: () => {
+        forceBlockMenuOpen(true);
+        setTimeout(() => {
+          focusElement(TUTORIAL_SELECTORS.BLOCKS_SEARCH_INPUT_BOX);
+        }, 100);
+
+        const checkForCalculator = setInterval(() => {
+          const calcBlock = document.querySelector(
+            TUTORIAL_SELECTORS.BLOCK_CARD_CALCULATOR_IN_SEARCH,
+          );
+          if (calcBlock) {
+            clearInterval(checkForCalculator);
+
+            const searchInput = document.querySelector(
+              TUTORIAL_SELECTORS.BLOCKS_SEARCH_INPUT,
+            ) as HTMLInputElement;
+            if (searchInput) {
+              searchInput.blur();
+            }
+
+            disableOtherBlocks(
+              TUTORIAL_SELECTORS.BLOCK_CARD_CALCULATOR_IN_SEARCH,
+            );
+            pulseElement(TUTORIAL_SELECTORS.BLOCK_CARD_CALCULATOR_IN_SEARCH);
+            calcBlock.scrollIntoView({ behavior: "smooth", block: "center" });
+            setTimeout(() => {
+              tour.next();
+            }, 300);
+          }
+        }, TUTORIAL_CONFIG.ELEMENT_CHECK_INTERVAL);
+
+        (window as any).__tutorialCalcInterval = checkForCalculator;
+      },
+      hide: () => {
+        if ((window as any).__tutorialCalcInterval) {
+          clearInterval((window as any).__tutorialCalcInterval);
+          delete (window as any).__tutorialCalcInterval;
+        }
+        enableAllBlocks();
+      },
+    },
+    buttons: [],
+  },
+
+  {
+    id: "select-calculator",
+    title: "Add the Calculator Block",
+    text: `
+      <div class="text-sm leading-[1.375rem] text-zinc-800">
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0">You should see the <strong>Calculator</strong> block in the results.</p>
+        ${banner(ICONS.ClickIcon, "Click on the Calculator block to add it", "action")}
+        
+        <div class="bg-zinc-100 ring-1 ring-zinc-200 rounded-2xl p-2 px-4 mt-2 flex items-start gap-2 text-sm font-medium text-zinc-600">  
+          <span class="flex-shrink-0">${ICONS.Drag}</span>
+          <span>You can also drag blocks onto the canvas</span>
+        </div>
+      </div>
+    `,
+    attachTo: {
+      element: TUTORIAL_SELECTORS.BLOCK_CARD_CALCULATOR,
+      on: "left",
+    },
+    beforeShowPromise: async () => {
+      forceBlockMenuOpen(true);
+      await waitForElement(TUTORIAL_SELECTORS.BLOCK_CARD_CALCULATOR, 5000);
+      await new Promise((resolve) => setTimeout(resolve, 100));
+    },
+    when: {
+      show: () => {
+        const calcBlock = document.querySelector(
+          TUTORIAL_SELECTORS.BLOCK_CARD_CALCULATOR,
+        );
+        if (calcBlock) {
+          disableOtherBlocks(TUTORIAL_SELECTORS.BLOCK_CARD_CALCULATOR);
+        } else {
+          highlightFirstBlockInSearch();
+        }
+
+        const CALCULATOR_BLOCK_ID = BLOCK_IDS.CALCULATOR;
+
+        const initialNodeCount = useNodeStore.getState().nodes.length;
+
+        const unsubscribe = useNodeStore.subscribe((state) => {
+          if (state.nodes.length > initialNodeCount) {
+            const calculatorNode = state.nodes.find(
+              (node) => node.data?.block_id === CALCULATOR_BLOCK_ID,
+            );
+
+            if (calculatorNode) {
+              unsubscribe();
+              enableAllBlocks();
+              forceBlockMenuOpen(false);
+              tour.next();
+            }
+          }
+        });
+
+        (tour.getCurrentStep() as any)._nodeUnsubscribe = unsubscribe;
+      },
+    },
+  },
+];
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/completion.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/completion.ts
new file mode 100644
index 0000000000..12d3f3fd92
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/completion.ts
@@ -0,0 +1,51 @@
+import { StepOptions } from "shepherd.js";
+
+export const createCompletionSteps = (tour: any): StepOptions[] => [
+  {
+    id: "congratulations",
+    title: "Congratulations! 🎉",
+    text: `
+      <div class="text-sm leading-[1.375rem] text-zinc-800">
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0">You have successfully created and run your first agent flow!</p>
+        
+        <div class="mt-3 p-3 bg-green-50 ring-1 ring-green-200 rounded-2xl">
+          <p class="text-sm font-medium text-green-600 m-0">You learned how to:</p>
+          <ul class="text-[0.8125rem] text-green-600 m-0 pl-4 mt-2 space-y-1">
+            <li>• Add blocks from the Block Menu</li>
+            <li>• Understand input and output handles</li>
+            <li>• Configure block values</li>
+            <li>• Connect blocks together</li>
+            <li>• Save and run your agent</li>
+            <li>• View execution status and output</li>
+          </ul>
+        </div>
+        
+        <p class="text-sm font-medium leading-[1.375rem] text-zinc-800 m-0" style="margin-top: 0.75rem;">Happy building! 🚀</p>
+      </div>
+    `,
+    when: {
+      show: () => {
+        const modal = document.querySelector(
+          ".shepherd-modal-overlay-container",
+        );
+        if (modal) {
+          (modal as HTMLElement).style.opacity = "0.3";
+        }
+      },
+    },
+    buttons: [
+      {
+        text: "Restart Tutorial",
+        action: () => {
+          tour.cancel();
+          setTimeout(() => tour.start(), 100);
+        },
+        classes: "shepherd-button-secondary",
+      },
+      {
+        text: "Finish",
+        action: () => tour.complete(),
+      },
+    ],
+  },
+];
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/configure-calculator.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/configure-calculator.ts
new file mode 100644
index 0000000000..9a4a542437
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/configure-calculator.ts
@@ -0,0 +1,197 @@
+import { StepOptions } from "shepherd.js";
+import { TUTORIAL_SELECTORS } from "../constants";
+import {
+  fitViewToScreen,
+  highlightElement,
+  removeAllHighlights,
+  getFirstNode,
+} from "../helpers";
+import { ICONS } from "../icons";
+import { banner } from "../styles";
+
+const getRequirementsHtml = () => `
+  <div id="requirements-box" class="mt-3 p-3 bg-amber-50 ring-1 ring-amber-200 rounded-2xl">
+    <p id="requirements-title" class="text-sm font-medium text-amber-600 m-0 mb-2">⚠️ Required to continue:</p>
+    <ul id="requirements-list" class="text-[0.8125rem] text-amber-600 m-0 pl-4 space-y-1">
+      <li id="req-a" class="flex items-center gap-2">
+        <span class="req-icon">○</span> Enter a number in field <strong>A</strong> (e.g., 10)
+      </li>
+      <li id="req-b" class="flex items-center gap-2">
+        <span class="req-icon">○</span> Enter a number in field <strong>B</strong> (e.g., 5)
+      </li>
+      <li id="req-op" class="flex items-center gap-2">
+        <span class="req-icon">○</span> Select an <strong>Operation</strong> (Add, Multiply, etc.)
+      </li>
+    </ul>
+  </div>
+`;
+
+const updateToSuccessState = () => {
+  const reqBox = document.querySelector("#requirements-box");
+  const reqTitle = document.querySelector("#requirements-title");
+  const reqList = document.querySelector("#requirements-list");
+
+  if (reqBox && reqTitle) {
+    reqBox.classList.remove("bg-amber-50", "ring-amber-200");
+    reqBox.classList.add("bg-green-50", "ring-green-200");
+    reqTitle.classList.remove("text-amber-600");
+    reqTitle.classList.add("text-green-600");
+    reqTitle.innerHTML = "🎉 Hurray! All values are completed!";
+    if (reqList) {
+      reqList.classList.add("hidden");
+    }
+  }
+};
+
+const updateToWarningState = () => {
+  const reqBox = document.querySelector("#requirements-box");
+  const reqTitle = document.querySelector("#requirements-title");
+  const reqList = document.querySelector("#requirements-list");
+
+  if (reqBox && reqTitle) {
+    reqBox.classList.remove("bg-green-50", "ring-green-200");
+    reqBox.classList.add("bg-amber-50", "ring-amber-200");
+    reqTitle.classList.remove("text-green-600");
+    reqTitle.classList.add("text-amber-600");
+    reqTitle.innerHTML = "⚠️ Required to continue:";
+    if (reqList) {
+      reqList.classList.remove("hidden");
+    }
+  }
+};
+
+export const createConfigureCalculatorSteps = (tour: any): StepOptions[] => [
+  {
+    id: "enter-values",
+    title: "Enter Values",
+    text: `
+      <div class="text-sm leading-[1.375rem] text-zinc-800">
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0">Now let's configure the block with actual values.</p>
+        ${getRequirementsHtml()}
+        ${banner(ICONS.ClickIcon, "Fill in all the required fields above", "action")}
+      </div>
+    `,
+    beforeShowPromise: () => {
+      fitViewToScreen();
+      return Promise.resolve();
+    },
+    attachTo: {
+      element: TUTORIAL_SELECTORS.CALCULATOR_NODE_FORM_CONTAINER,
+      on: "right",
+    },
+    when: {
+      show: () => {
+        const node = getFirstNode();
+        if (node) {
+          highlightElement(`[data-id="custom-node-${node.id}"]`);
+        }
+
+        let wasComplete = false;
+
+        const checkInterval = setInterval(() => {
+          const node = getFirstNode();
+          if (!node) return;
+
+          const hardcodedValues = node.data?.hardcodedValues || {};
+          const hasA =
+            hardcodedValues.a !== undefined &&
+            hardcodedValues.a !== null &&
+            hardcodedValues.a !== "";
+          const hasB =
+            hardcodedValues.b !== undefined &&
+            hardcodedValues.b !== null &&
+            hardcodedValues.b !== "";
+          const hasOp =
+            hardcodedValues.operation !== undefined &&
+            hardcodedValues.operation !== null &&
+            hardcodedValues.operation !== "";
+
+          const allComplete = hasA && hasB && hasOp;
+
+          const reqA = document.querySelector("#req-a .req-icon");
+          const reqB = document.querySelector("#req-b .req-icon");
+          const reqOp = document.querySelector("#req-op .req-icon");
+
+          if (reqA) reqA.textContent = hasA ? "✓" : "○";
+          if (reqB) reqB.textContent = hasB ? "✓" : "○";
+          if (reqOp) reqOp.textContent = hasOp ? "✓" : "○";
+
+          const reqAEl = document.querySelector("#req-a");
+          const reqBEl = document.querySelector("#req-b");
+          const reqOpEl = document.querySelector("#req-op");
+
+          if (reqAEl) {
+            reqAEl.classList.toggle("text-green-600", hasA);
+            reqAEl.classList.toggle("text-amber-600", !hasA);
+          }
+          if (reqBEl) {
+            reqBEl.classList.toggle("text-green-600", hasB);
+            reqBEl.classList.toggle("text-amber-600", !hasB);
+          }
+          if (reqOpEl) {
+            reqOpEl.classList.toggle("text-green-600", hasOp);
+            reqOpEl.classList.toggle("text-amber-600", !hasOp);
+          }
+
+          if (allComplete && !wasComplete) {
+            updateToSuccessState();
+            wasComplete = true;
+          } else if (!allComplete && wasComplete) {
+            updateToWarningState();
+            wasComplete = false;
+          }
+
+          const nextBtn = document.querySelector(
+            ".shepherd-button-primary",
+          ) as HTMLButtonElement;
+          if (nextBtn) {
+            nextBtn.style.opacity = allComplete ? "1" : "0.5";
+            nextBtn.style.pointerEvents = allComplete ? "auto" : "none";
+          }
+        }, 300);
+
+        (window as any).__tutorialCheckInterval = checkInterval;
+      },
+      hide: () => {
+        removeAllHighlights();
+        if ((window as any).__tutorialCheckInterval) {
+          clearInterval((window as any).__tutorialCheckInterval);
+          delete (window as any).__tutorialCheckInterval;
+        }
+      },
+    },
+    buttons: [
+      {
+        text: "Back",
+        action: () => tour.back(),
+        classes: "shepherd-button-secondary",
+      },
+      {
+        text: "Continue",
+        action: () => {
+          const node = getFirstNode();
+          if (!node) return;
+
+          const hardcodedValues = node.data?.hardcodedValues || {};
+          const hasA =
+            hardcodedValues.a !== undefined &&
+            hardcodedValues.a !== null &&
+            hardcodedValues.a !== "";
+          const hasB =
+            hardcodedValues.b !== undefined &&
+            hardcodedValues.b !== null &&
+            hardcodedValues.b !== "";
+          const hasOp =
+            hardcodedValues.operation !== undefined &&
+            hardcodedValues.operation !== null &&
+            hardcodedValues.operation !== "";
+
+          if (hasA && hasB && hasOp) {
+            tour.next();
+          }
+        },
+        classes: "shepherd-button-primary",
+      },
+    ],
+  },
+];
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/connections.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/connections.ts
new file mode 100644
index 0000000000..7d0ebc9116
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/connections.ts
@@ -0,0 +1,276 @@
+import { StepOptions } from "shepherd.js";
+import {
+  fitViewToScreen,
+  highlightElement,
+  removeAllHighlights,
+} from "../helpers";
+import { ICONS } from "../icons";
+import { banner } from "../styles";
+import { useEdgeStore } from "../../../../stores/edgeStore";
+import { TUTORIAL_SELECTORS } from "../constants";
+
+const getConnectionStatusHtml = (id: string, isConnected: boolean = false) => `
+  <div id="${id}" class="mt-3 p-2 ${isConnected ? "bg-green-50 ring-1 ring-green-200" : "bg-amber-50 ring-1 ring-amber-200"} rounded-2xl text-center text-sm ${isConnected ? "text-green-600" : "text-amber-600"}">
+    ${isConnected ? "✅ Connected!" : "Waiting for connection..."}
+  </div>
+`;
+
+const updateConnectionStatus = (
+  id: string,
+  isConnected: boolean,
+  message?: string,
+) => {
+  const statusEl = document.querySelector(`#${id}`);
+  if (statusEl) {
+    statusEl.innerHTML =
+      message || (isConnected ? "✅ Connected!" : "Waiting for connection...");
+    statusEl.classList.remove(
+      "bg-amber-50",
+      "ring-amber-200",
+      "text-amber-600",
+      "bg-green-50",
+      "ring-green-200",
+      "text-green-600",
+    );
+    if (isConnected) {
+      statusEl.classList.add("bg-green-50", "ring-green-200", "text-green-600");
+    } else {
+      statusEl.classList.add("bg-amber-50", "ring-amber-200", "text-amber-600");
+    }
+  }
+};
+
+const hasAnyEdge = (): boolean => {
+  return useEdgeStore.getState().edges.length > 0;
+};
+
+export const createConnectionSteps = (tour: any): StepOptions[] => {
+  let isConnecting = false;
+
+  const handleMouseDown = () => {
+    isConnecting = true;
+
+    const inputSelector =
+      TUTORIAL_SELECTORS.FIRST_CALCULATOR_RESULT_OUTPUT_HANDLER;
+    if (inputSelector) {
+      highlightElement(inputSelector);
+    }
+
+    setTimeout(() => {
+      if (isConnecting) {
+        tour.next();
+      }
+    }, 100);
+  };
+
+  const resetConnectionState = () => {
+    isConnecting = false;
+  };
+
+  return [
+    {
+      id: "connect-blocks-output",
+      title: "Connect the Blocks: Output",
+      text: `
+        <div class="text-sm leading-[1.375rem] text-zinc-800">
+          <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0">Now, let's connect the <strong>Result output</strong> of the first Calculator to the <strong>input (A)</strong> of the second Calculator.</p>
+          
+          <div class="mt-3 p-3 bg-blue-50 ring-1 ring-blue-200 rounded-2xl">
+            <p class="text-sm font-medium text-blue-600 m-0 mb-2">Drag from the Result output:</p>
+            <p class="text-[0.8125rem] text-blue-600 m-0">Click and drag from the <strong>Result</strong> output pin (right side) of the <strong>first Calculator block</strong>.</p>
+          </div>
+          ${getConnectionStatusHtml("connection-status-output", false)}
+          ${banner(ICONS.Drag, "Drag from the Result output pin", "action")}
+        </div>
+      `,
+      attachTo: {
+        element: TUTORIAL_SELECTORS.FIRST_CALCULATOR_RESULT_OUTPUT_HANDLER,
+        on: "left",
+      },
+
+      when: {
+        show: () => {
+          resetConnectionState();
+
+          if (hasAnyEdge()) {
+            updateConnectionStatus(
+              "connection-status-output",
+              true,
+              "✅ Connection already exists!",
+            );
+            setTimeout(() => {
+              tour.next();
+            }, 1000);
+            return;
+          }
+
+          const outputSelector =
+            TUTORIAL_SELECTORS.FIRST_CALCULATOR_RESULT_OUTPUT_HANDLER;
+          if (outputSelector) {
+            const outputHandle = document.querySelector(outputSelector);
+            if (outputHandle) {
+              highlightElement(outputSelector);
+              outputHandle.addEventListener("mousedown", handleMouseDown);
+            }
+          }
+
+          const unsubscribe = useEdgeStore.subscribe(() => {
+            if (hasAnyEdge()) {
+              updateConnectionStatus("connection-status-output", true);
+              setTimeout(() => {
+                unsubscribe();
+                tour.next();
+              }, 500);
+            }
+          });
+
+          (tour.getCurrentStep() as any)._edgeUnsubscribe = unsubscribe;
+        },
+        hide: () => {
+          removeAllHighlights();
+          const step = tour.getCurrentStep() as any;
+          if (step?._edgeUnsubscribe) {
+            step._edgeUnsubscribe();
+          }
+          const outputSelector =
+            TUTORIAL_SELECTORS.FIRST_CALCULATOR_RESULT_OUTPUT_HANDLER;
+          if (outputSelector) {
+            const outputHandle = document.querySelector(outputSelector);
+            if (outputHandle) {
+              outputHandle.removeEventListener("mousedown", handleMouseDown);
+            }
+          }
+        },
+      },
+      buttons: [
+        {
+          text: "Back",
+          action: () => tour.back(),
+          classes: "shepherd-button-secondary",
+        },
+        {
+          text: "Skip (already connected)",
+          action: () => tour.show("connection-complete"),
+          classes: "shepherd-button-secondary",
+        },
+      ],
+    },
+
+    {
+      id: "connect-blocks-input",
+      title: "Connect the Blocks: Input",
+      text: `
+        <div class="text-sm leading-[1.375rem] text-zinc-800">
+          <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0">Now, connect to the <strong>input (A)</strong> of the second Calculator block.</p>
+          
+          <div class="mt-3 p-3 bg-blue-50 ring-1 ring-blue-200 rounded-2xl">
+            <p class="text-sm font-medium text-blue-600 m-0 mb-2">Drop on the A input:</p>
+            <p class="text-[0.8125rem] text-blue-600 m-0">Drag to the <strong>A</strong> input handle (left side) of the <strong>second Calculator block</strong>.</p>
+          </div>
+          ${getConnectionStatusHtml("connection-status-input", false)}
+        </div>
+      `,
+      attachTo: {
+        element: TUTORIAL_SELECTORS.SECOND_CALCULATOR_NUMBER_A_INPUT_HANDLER,
+        on: "right",
+      },
+      when: {
+        show: () => {
+          const inputSelector =
+            TUTORIAL_SELECTORS.SECOND_CALCULATOR_NUMBER_A_INPUT_HANDLER;
+          if (inputSelector) {
+            highlightElement(inputSelector);
+          }
+
+          if (hasAnyEdge()) {
+            updateConnectionStatus(
+              "connection-status-input",
+              true,
+              "✅ Connected!",
+            );
+            setTimeout(() => {
+              tour.next();
+            }, 500);
+            return;
+          }
+
+          const unsubscribe = useEdgeStore.subscribe(() => {
+            if (hasAnyEdge()) {
+              updateConnectionStatus("connection-status-input", true);
+              setTimeout(() => {
+                unsubscribe();
+                tour.next();
+              }, 500);
+            }
+          });
+
+          (tour.getCurrentStep() as any)._edgeUnsubscribe = unsubscribe;
+
+          const handleMouseUp = () => {
+            setTimeout(() => {
+              if (!hasAnyEdge()) {
+                isConnecting = false;
+                tour.show("connect-blocks-output");
+              }
+            }, 200);
+          };
+          document.addEventListener("mouseup", handleMouseUp, true);
+          (tour.getCurrentStep() as any)._mouseUpHandler = handleMouseUp;
+        },
+        hide: () => {
+          removeAllHighlights();
+          const step = tour.getCurrentStep() as any;
+          if (step?._edgeUnsubscribe) {
+            step._edgeUnsubscribe();
+          }
+          if (step?._mouseUpHandler) {
+            document.removeEventListener("mouseup", step._mouseUpHandler, true);
+          }
+        },
+      },
+      buttons: [
+        {
+          text: "Back",
+          action: () => tour.show("connect-blocks-output"),
+          classes: "shepherd-button-secondary",
+        },
+        {
+          text: "Skip (already connected)",
+          action: () => tour.next(),
+          classes: "shepherd-button-secondary",
+        },
+      ],
+    },
+
+    {
+      id: "connection-complete",
+      title: "Blocks Connected! 🎉",
+      text: `
+        <div class="text-sm leading-[1.375rem] text-zinc-800">
+          <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0">Excellent! Your Calculator blocks are now connected:</p>
+          
+          <div class="mt-3 p-3 bg-green-50 ring-1 ring-green-200 rounded-2xl">
+            <div class="flex items-center justify-center gap-2 text-sm font-medium text-green-600">
+              <span>Calculator 1</span>
+              <span>→</span>
+              <span>Calculator 2</span>
+            </div>
+            <p class="text-[0.75rem] text-green-500 m-0 mt-2 text-center italic">The result of Calculator 1 flows into Calculator 2's input A</p>
+          </div>
+          
+          <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0" style="margin-top: 0.75rem;">Now let's save and run your agent!</p>
+        </div>
+      `,
+      beforeShowPromise: async () => {
+        fitViewToScreen();
+        return Promise.resolve();
+      },
+      buttons: [
+        {
+          text: "Save My Agent",
+          action: () => tour.next(),
+        },
+      ],
+    },
+  ];
+};
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/index.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/index.ts
new file mode 100644
index 0000000000..657dbf76bb
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/index.ts
@@ -0,0 +1,22 @@
+import { StepOptions } from "shepherd.js";
+import { createWelcomeSteps } from "./welcome";
+import { createBlockMenuSteps } from "./block-menu";
+import { createBlockBasicsSteps } from "./block-basics";
+import { createConfigureCalculatorSteps } from "./configure-calculator";
+import { createSecondCalculatorSteps } from "./second-calculator";
+import { createConnectionSteps } from "./connections";
+import { createSaveSteps } from "./save";
+import { createRunSteps } from "./run";
+import { createCompletionSteps } from "./completion";
+
+export const createTutorialSteps = (tour: any): StepOptions[] => [
+  ...createWelcomeSteps(tour),
+  ...createBlockMenuSteps(tour),
+  ...createBlockBasicsSteps(tour),
+  ...createConfigureCalculatorSteps(tour),
+  ...createSecondCalculatorSteps(tour),
+  ...createConnectionSteps(tour),
+  ...createSaveSteps(),
+  ...createRunSteps(tour),
+  ...createCompletionSteps(tour),
+];
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/run.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/run.ts
new file mode 100644
index 0000000000..bebe69480d
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/run.ts
@@ -0,0 +1,97 @@
+import { StepOptions } from "shepherd.js";
+import { TUTORIAL_SELECTORS } from "../constants";
+import {
+  waitForElement,
+  fitViewToScreen,
+  highlightElement,
+  removeAllHighlights,
+} from "../helpers";
+import { ICONS } from "../icons";
+import { banner } from "../styles";
+
+export const createRunSteps = (tour: any): StepOptions[] => [
+  {
+    id: "press-run",
+    title: "Run Your Agent",
+    text: `
+      <div class="text-sm leading-[1.375rem] text-zinc-800">
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0">Your agent is saved and ready! Now let's <strong>run it</strong> to see it in action.</p>
+        ${banner(ICONS.ClickIcon, "Click the Run button", "action")}
+      </div>
+    `,
+    attachTo: {
+      element: TUTORIAL_SELECTORS.RUN_BUTTON,
+      on: "top",
+    },
+    advanceOn: {
+      selector: TUTORIAL_SELECTORS.RUN_BUTTON,
+      event: "click",
+    },
+    beforeShowPromise: () =>
+      waitForElement(TUTORIAL_SELECTORS.RUN_BUTTON, 3000).catch(() => {}),
+    when: {
+      show: () => {
+        highlightElement(TUTORIAL_SELECTORS.RUN_BUTTON);
+      },
+      hide: () => {
+        removeAllHighlights();
+        setTimeout(() => {
+          fitViewToScreen();
+        }, 500);
+      },
+    },
+    buttons: [],
+  },
+
+  {
+    id: "show-output",
+    title: "View the Output",
+    text: `
+      <div class="text-sm leading-[1.375rem] text-zinc-800">
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0">Here's the <strong>output</strong> of your block!</p>
+        
+        <div class="mt-3 p-3 bg-blue-50 ring-1 ring-blue-200 rounded-2xl">
+          <p class="text-sm font-medium text-blue-600 m-0">Latest Output:</p>
+          <p class="text-[0.8125rem] text-blue-600 m-0 mt-1">After each run, you can see the result of each block at the bottom of the block.</p>
+        </div>
+        
+        <div class="mt-2 p-2 bg-zinc-100 ring-1 ring-zinc-200 rounded-xl">
+          <p class="text-[0.8125rem] text-zinc-600 m-0">The output shows:</p>
+          <ul class="text-[0.8125rem] text-zinc-500 m-0 mt-1 pl-4">
+            <li>• The calculated result</li>
+            <li>• Execution timestamp</li>
+          </ul>
+        </div>
+      </div>
+    `,
+    attachTo: {
+      element: TUTORIAL_SELECTORS.FIRST_CALCULATOR_NODE_OUTPUT,
+      on: "top",
+    },
+    beforeShowPromise: () =>
+      new Promise((resolve) => {
+        setTimeout(() => {
+          waitForElement(TUTORIAL_SELECTORS.FIRST_CALCULATOR_NODE_OUTPUT, 5000)
+            .then(() => {
+              fitViewToScreen();
+              resolve(undefined);
+            })
+            .catch(resolve);
+        }, 300);
+      }),
+    when: {
+      show: () => {
+        highlightElement(TUTORIAL_SELECTORS.FIRST_CALCULATOR_NODE_OUTPUT);
+      },
+      hide: () => {
+        removeAllHighlights();
+      },
+    },
+    buttons: [
+      {
+        text: "Finish Tutorial",
+        action: () => tour.next(),
+      },
+    ],
+  },
+];
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/save.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/save.ts
new file mode 100644
index 0000000000..32c13844ff
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/save.ts
@@ -0,0 +1,71 @@
+import { StepOptions } from "shepherd.js";
+import { TUTORIAL_SELECTORS } from "../constants";
+import {
+  waitForElement,
+  highlightElement,
+  removeAllHighlights,
+  forceSaveOpen,
+} from "../helpers";
+import { ICONS } from "../icons";
+import { banner } from "../styles";
+export const createSaveSteps = (): StepOptions[] => [
+  {
+    id: "open-save",
+    title: "Save Your Agent",
+    text: `
+      <div class="text-sm leading-[1.375rem] text-zinc-800">
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0">Before running, we need to <strong>save</strong> your agent.</p>
+        ${banner(ICONS.ClickIcon, "Click the Save button", "action")}
+      </div>
+    `,
+    attachTo: {
+      element: TUTORIAL_SELECTORS.SAVE_TRIGGER,
+      on: "right",
+    },
+    advanceOn: {
+      selector: TUTORIAL_SELECTORS.SAVE_TRIGGER,
+      event: "click",
+    },
+    beforeShowPromise: () =>
+      waitForElement(TUTORIAL_SELECTORS.SAVE_TRIGGER, 3000).catch(() => {}),
+    buttons: [],
+    when: {
+      show: () => {
+        highlightElement(TUTORIAL_SELECTORS.SAVE_TRIGGER);
+      },
+      hide: () => {
+        removeAllHighlights();
+      },
+    },
+  },
+
+  {
+    id: "save-details",
+    title: "Name Your Agent",
+    text: `
+      <div class="text-sm leading-[1.375rem] text-zinc-800">
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0">Give your agent a <strong>name</strong> and optional description.</p>
+        ${banner(ICONS.ClickIcon, 'Enter a name and click "Save Agent"', "action")}
+        <p class="text-xs font-normal leading-[1.125rem] text-zinc-500 m-0" style="margin-top: 0.5rem;">Example: "My Calculator Agent"</p>
+      </div>
+    `,
+    attachTo: {
+      element: TUTORIAL_SELECTORS.SAVE_CONTENT,
+      on: "right",
+    },
+    advanceOn: {
+      selector: TUTORIAL_SELECTORS.SAVE_AGENT_BUTTON,
+      event: "click",
+    },
+    beforeShowPromise: () => waitForElement(TUTORIAL_SELECTORS.SAVE_CONTENT),
+    when: {
+      show: () => {
+        forceSaveOpen(true);
+      },
+      hide: () => {
+        forceSaveOpen(false);
+      },
+    },
+    buttons: [],
+  },
+];
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/second-calculator.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/second-calculator.ts
new file mode 100644
index 0000000000..276b2f88b9
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/second-calculator.ts
@@ -0,0 +1,272 @@
+import { StepOptions } from "shepherd.js";
+import {
+  waitForNodesCount,
+  fitViewToScreen,
+  highlightElement,
+  removeAllHighlights,
+  addSecondCalculatorBlock,
+  getSecondCalculatorNode,
+} from "../helpers";
+import { ICONS } from "../icons";
+import { banner } from "../styles";
+
+const getSecondCalculatorFormSelector = (): string | HTMLElement => {
+  const secondNode = getSecondCalculatorNode();
+  if (secondNode) {
+    const selector = `[data-id="form-creator-container-${secondNode.id}-node"]`;
+    const element = document.querySelector(selector);
+    if (element) {
+      return element as HTMLElement;
+    }
+    return selector;
+  }
+  const formContainers = document.querySelectorAll(
+    '[data-id^="form-creator-container-"]',
+  );
+  if (formContainers.length >= 2) {
+    return formContainers[1] as HTMLElement;
+  }
+  return '[data-id^="form-creator-container-"]';
+};
+
+const getSecondCalcRequirementsHtml = () => `
+  <div id="second-calc-requirements-box" class="mt-3 p-3 bg-amber-50 ring-1 ring-amber-200 rounded-2xl">
+    <p id="second-calc-requirements-title" class="text-sm font-medium text-amber-600 m-0 mb-2">⚠️ Required to continue:</p>
+    <ul id="second-calc-requirements-list" class="text-[0.8125rem] text-amber-600 m-0 pl-4 space-y-1">
+      <li id="req2-b" class="flex items-center gap-2">
+        <span class="req-icon">○</span> Enter a number in field <strong>B</strong> (e.g., 2)
+      </li>
+      <li id="req2-op" class="flex items-center gap-2">
+        <span class="req-icon">○</span> Select an <strong>Operation</strong> (e.g., Multiply)
+      </li>
+    </ul>
+    <p class="text-[0.75rem] text-amber-500 m-0 mt-2 italic">Note: Field A will be connected from the first Calculator's output</p>
+  </div>
+`;
+
+const updateSecondCalcToSuccessState = () => {
+  const reqBox = document.querySelector("#second-calc-requirements-box");
+  const reqTitle = document.querySelector("#second-calc-requirements-title");
+  const reqList = document.querySelector("#second-calc-requirements-list");
+
+  if (reqBox && reqTitle) {
+    reqBox.classList.remove("bg-amber-50", "ring-amber-200");
+    reqBox.classList.add("bg-green-50", "ring-green-200");
+    reqTitle.classList.remove("text-amber-600");
+    reqTitle.classList.add("text-green-600");
+    reqTitle.innerHTML = "🎉 Hurray! All values are completed!";
+    if (reqList) {
+      reqList.classList.add("hidden");
+    }
+  }
+};
+
+const updateSecondCalcToWarningState = () => {
+  const reqBox = document.querySelector("#second-calc-requirements-box");
+  const reqTitle = document.querySelector("#second-calc-requirements-title");
+  const reqList = document.querySelector("#second-calc-requirements-list");
+
+  if (reqBox && reqTitle) {
+    reqBox.classList.remove("bg-green-50", "ring-green-200");
+    reqBox.classList.add("bg-amber-50", "ring-amber-200");
+    reqTitle.classList.remove("text-green-600");
+    reqTitle.classList.add("text-amber-600");
+    reqTitle.innerHTML = "⚠️ Required to continue:";
+    if (reqList) {
+      reqList.classList.remove("hidden");
+    }
+  }
+};
+
+export const createSecondCalculatorSteps = (tour: any): StepOptions[] => [
+  {
+    id: "adding-second-calculator",
+    title: "Adding Second Calculator",
+    text: `
+      <div class="text-sm leading-[1.375rem] text-zinc-800">
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0">Great job configuring the first Calculator!</p>
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0" style="margin-top: 0.5rem;">Now let's add a <strong>second Calculator block</strong> and connect them together.</p>
+        
+        <div class="mt-3 p-3 bg-blue-50 ring-1 ring-blue-200 rounded-2xl">
+          <p class="text-sm font-medium text-blue-600 m-0 mb-1">We'll create a chain:</p>
+          <p class="text-[0.8125rem] text-blue-600 m-0">Calculator 1 → Calculator 2</p>
+          <p class="text-[0.75rem] text-blue-500 m-0 mt-1 italic">The output of the first will feed into the second!</p>
+        </div>
+      </div>
+    `,
+    buttons: [
+      {
+        text: "Back",
+        action: () => tour.back(),
+        classes: "shepherd-button-secondary",
+      },
+      {
+        text: "Add Second Calculator",
+        action: () => tour.next(),
+      },
+    ],
+  },
+
+  {
+    id: "second-calculator-added",
+    title: "Second Calculator Added! ✅",
+    text: `
+      <div class="text-sm leading-[1.375rem] text-zinc-800">
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0">I've added a <strong>second Calculator block</strong> to your canvas.</p>
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0" style="margin-top: 0.5rem;">Now let's configure it and connect them together.</p>
+        
+        <div class="mt-3 p-3 bg-green-50 ring-1 ring-green-200 rounded-2xl">
+          <p class="text-sm font-medium text-green-600 m-0">You now have 2 Calculator blocks!</p>
+        </div>
+      </div>
+    `,
+    beforeShowPromise: async () => {
+      addSecondCalculatorBlock();
+      await waitForNodesCount(2, 5000);
+      await new Promise((resolve) => setTimeout(resolve, 500));
+      fitViewToScreen();
+    },
+    buttons: [
+      {
+        text: "Let's configure it",
+        action: () => tour.next(),
+      },
+    ],
+  },
+
+  {
+    id: "configure-second-calculator",
+    title: "Configure Second Calculator",
+    text: `
+      <div class="text-sm leading-[1.375rem] text-zinc-800">
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0">Now configure the <strong>second Calculator block</strong>.</p>
+        ${getSecondCalcRequirementsHtml()}
+        ${banner(ICONS.ClickIcon, "Fill in field B and select an Operation", "action")}
+      </div>
+    `,
+    beforeShowPromise: async () => {
+      fitViewToScreen();
+      await new Promise<void>((resolve) => {
+        const checkNode = () => {
+          const secondNode = getSecondCalculatorNode();
+          if (secondNode) {
+            const formContainer = document.querySelector(
+              `[data-id="form-creator-container-${secondNode.id}-node"]`,
+            );
+            if (formContainer) {
+              resolve();
+            } else {
+              setTimeout(checkNode, 100);
+            }
+          } else {
+            setTimeout(checkNode, 100);
+          }
+        };
+        checkNode();
+      });
+    },
+    attachTo: {
+      element: getSecondCalculatorFormSelector,
+      on: "right",
+    },
+    when: {
+      show: () => {
+        const secondNode = getSecondCalculatorNode();
+        if (secondNode) {
+          highlightElement(`[data-id="custom-node-${secondNode.id}"]`);
+        }
+
+        let wasComplete = false;
+
+        const checkInterval = setInterval(() => {
+          const secondNode = getSecondCalculatorNode();
+          if (!secondNode) return;
+
+          const hardcodedValues = secondNode.data?.hardcodedValues || {};
+          const hasB =
+            hardcodedValues.b !== undefined &&
+            hardcodedValues.b !== null &&
+            hardcodedValues.b !== "";
+          const hasOp =
+            hardcodedValues.operation !== undefined &&
+            hardcodedValues.operation !== null &&
+            hardcodedValues.operation !== "";
+
+          const allComplete = hasB && hasOp;
+
+          const reqB = document.querySelector("#req2-b .req-icon");
+          const reqOp = document.querySelector("#req2-op .req-icon");
+
+          if (reqB) reqB.textContent = hasB ? "✓" : "○";
+          if (reqOp) reqOp.textContent = hasOp ? "✓" : "○";
+
+          const reqBEl = document.querySelector("#req2-b");
+          const reqOpEl = document.querySelector("#req2-op");
+
+          if (reqBEl) {
+            reqBEl.classList.toggle("text-green-600", hasB);
+            reqBEl.classList.toggle("text-amber-600", !hasB);
+          }
+          if (reqOpEl) {
+            reqOpEl.classList.toggle("text-green-600", hasOp);
+            reqOpEl.classList.toggle("text-amber-600", !hasOp);
+          }
+
+          if (allComplete && !wasComplete) {
+            updateSecondCalcToSuccessState();
+            wasComplete = true;
+          } else if (!allComplete && wasComplete) {
+            updateSecondCalcToWarningState();
+            wasComplete = false;
+          }
+
+          const nextBtn = document.querySelector(
+            ".shepherd-button-primary",
+          ) as HTMLButtonElement;
+          if (nextBtn) {
+            nextBtn.style.opacity = allComplete ? "1" : "0.5";
+            nextBtn.style.pointerEvents = allComplete ? "auto" : "none";
+          }
+        }, 300);
+
+        (window as any).__tutorialSecondCalcInterval = checkInterval;
+      },
+      hide: () => {
+        removeAllHighlights();
+        if ((window as any).__tutorialSecondCalcInterval) {
+          clearInterval((window as any).__tutorialSecondCalcInterval);
+          delete (window as any).__tutorialSecondCalcInterval;
+        }
+      },
+    },
+    buttons: [
+      {
+        text: "Back",
+        action: () => tour.back(),
+        classes: "shepherd-button-secondary",
+      },
+      {
+        text: "Continue",
+        action: () => {
+          const secondNode = getSecondCalculatorNode();
+          if (!secondNode) return;
+
+          const hardcodedValues = secondNode.data?.hardcodedValues || {};
+          const hasB =
+            hardcodedValues.b !== undefined &&
+            hardcodedValues.b !== null &&
+            hardcodedValues.b !== "";
+          const hasOp =
+            hardcodedValues.operation !== undefined &&
+            hardcodedValues.operation !== null &&
+            hardcodedValues.operation !== "";
+
+          if (hasB && hasOp) {
+            tour.next();
+          }
+        },
+        classes: "shepherd-button-primary",
+      },
+    ],
+  },
+];
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/welcome.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/welcome.ts
new file mode 100644
index 0000000000..78c7d078b9
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/steps/welcome.ts
@@ -0,0 +1,33 @@
+import { StepOptions } from "shepherd.js";
+import { handleTutorialSkip } from "../helpers";
+
+export const createWelcomeSteps = (tour: any): StepOptions[] => [
+  {
+    id: "welcome",
+    title: "Welcome to AutoGPT Builder! 👋🏻",
+    text: `
+      <div class="text-sm leading-[1.375rem] text-zinc-800">
+        <p class="text-sm font-normal leading-[1.375rem] text-zinc-800 m-0">This interactive tutorial will teach you how to build your first AI agent.</p>
+        <p class="text-sm font-medium leading-[1.375rem] text-zinc-800 m-0" style="margin-top: 0.75rem;">You'll learn how to:</p>
+        <ul class="pl-2 text-sm pt-2">
+          <li>- Add blocks to your workflow</li>
+          <li>- Understand block inputs and outputs</li>
+          <li>- Save and run your agent</li>
+          <li>- and much more...</li>
+        </ul>
+        <p class="text-xs font-normal leading-[1.125rem] text-zinc-500 m-0" style="margin-top: 0.75rem;">Estimated time: 3-4 minutes</p>
+      </div>
+    `,
+    buttons: [
+      {
+        text: "Skip Tutorial",
+        action: () => handleTutorialSkip(tour),
+        classes: "shepherd-button-secondary",
+      },
+      {
+        text: "Let's Begin",
+        action: () => tour.next(),
+      },
+    ],
+  },
+];
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/styles.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/styles.ts
new file mode 100644
index 0000000000..1b0cc5359e
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/styles.ts
@@ -0,0 +1,101 @@
+/**
+ * Tutorial Styles for New Builder
+ *
+ * CSS file contains:
+ * - Dynamic classes: .new-builder-tutorial-disable, .new-builder-tutorial-highlight, .new-builder-tutorial-pulse
+ * - Shepherd.js overrides
+ *
+ * Typography (body, small, action, info, tip, warning) uses Tailwind utilities directly in steps.ts
+ */
+import "./tutorial.css";
+
+export const injectTutorialStyles = () => {
+  if (typeof window !== "undefined") {
+    document.documentElement.setAttribute("data-tutorial-styles", "loaded");
+  }
+};
+
+export const removeTutorialStyles = () => {
+  if (typeof window !== "undefined") {
+    document.documentElement.removeAttribute("data-tutorial-styles");
+  }
+};
+
+// Reusable banner components with consistent styling
+
+type BannerVariant = "action" | "info" | "warning" | "success";
+
+const bannerStyles: Record<
+  BannerVariant,
+  { bg: string; ring: string; text: string }
+> = {
+  action: {
+    bg: "bg-violet-50",
+    ring: "ring-violet-200",
+    text: "text-violet-800",
+  },
+  info: {
+    bg: "bg-blue-50",
+    ring: "ring-blue-200",
+    text: "text-blue-800",
+  },
+  warning: {
+    bg: "bg-amber-50",
+    ring: "ring-amber-200",
+    text: "text-amber-800",
+  },
+  success: {
+    bg: "bg-green-50",
+    ring: "ring-green-200",
+    text: "text-green-800",
+  },
+};
+
+export const banner = (
+  icon: string,
+  content: string,
+  variant: BannerVariant = "action",
+  className?: string,
+) => {
+  const styles = bannerStyles[variant];
+  return `
+  <div class="${styles.bg} ring-1 ${styles.ring} rounded-2xl p-2 px-4 mt-2 flex items-start gap-2 text-sm font-medium ${styles.text} ${className || ""}">  
+    <span class="flex-shrink-0">${icon}</span>
+    <span>${content}</span>
+  </div>
+`;
+};
+
+// Requirement box components
+export const requirementBox = (
+  title: string,
+  items: string,
+  variant: "warning" | "success" = "warning",
+) => {
+  const isSuccess = variant === "success";
+  return `
+  <div id="requirements-box" class="mt-3 p-3 ${isSuccess ? "bg-green-50 ring-1 ring-green-200" : "bg-amber-50 ring-1 ring-amber-200"} rounded-2xl">
+    <p class="text-sm font-medium ${isSuccess ? "text-green-600" : "text-amber-600"} m-0 mb-2">${title}</p>
+    ${items}
+  </div>
+`;
+};
+
+export const requirementItem = (id: string, content: string) => `
+  <li id="${id}" class="flex items-center gap-2 text-amber-600">
+    <span class="req-icon">○</span> ${content}
+  </li>
+`;
+
+// Connection status box
+export const connectionStatusBox = (
+  id: string,
+  variant: "waiting" | "connected" = "waiting",
+) => {
+  const isConnected = variant === "connected";
+  return `
+  <div id="${id}" class="mt-3 p-2 ${isConnected ? "bg-green-50 ring-1 ring-green-200" : "bg-amber-50 ring-1 ring-amber-200"} rounded-2xl text-center text-sm ${isConnected ? "text-green-600" : "text-amber-600"}">
+    ${isConnected ? "✅ Connection already exists!" : "Waiting for connection..."}
+  </div>
+`;
+};
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/tutorial.css b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/tutorial.css
new file mode 100644
index 0000000000..6564a61888
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/tutorial/tutorial.css
@@ -0,0 +1,149 @@
+.new-builder-tutorial-highlight * {
+  opacity: 1 !important;
+  filter: none !important;
+}
+
+.new-builder-tutorial-pulse {
+  animation: new-builder-tutorial-pulse 2s ease-in-out infinite;
+}
+
+@keyframes new-builder-tutorial-pulse {
+  0%,
+  100% {
+    box-shadow:
+      0 0 0 4px white,
+      0 0 0 6px #7c3aed,
+      0 0 30px 8px rgba(124, 58, 237, 0.4);
+  }
+  50% {
+    box-shadow:
+      0 0 0 4px white,
+      0 0 0 8px #8b5cf6,
+      0 0 40px 12px rgba(124, 58, 237, 0.55);
+  }
+}
+
+.shepherd-element.new-builder-tour {
+  max-width: 420px !important;
+  border-radius: 1rem !important;
+  box-shadow:
+    0 0 0 1px rgba(0, 0, 0, 0.08),
+    0px 4px 6px -1px rgba(0, 0, 0, 0.1),
+    0 20px 25px -5px rgba(0, 0, 0, 0.1) !important;
+  background: white !important;
+  font-family: var(--font-geist-sans), system-ui, sans-serif !important;
+}
+
+.shepherd-element.new-builder-tour .shepherd-header {
+  padding: 1rem 1.25rem 0.5rem !important;
+  border-radius: 1rem 1rem 0 0 !important;
+  background: transparent !important;
+}
+
+.shepherd-element.new-builder-tour .shepherd-title {
+  font-family: var(--font-poppins), system-ui, sans-serif !important;
+  font-size: 1rem !important;
+  font-weight: 600 !important;
+  line-height: 1.5rem !important;
+  color: #18181b !important; /* zinc-900 */
+}
+
+.shepherd-element.new-builder-tour .shepherd-text {
+  padding: 0 1.25rem 1rem !important;
+  color: #52525b !important; /* zinc-600 */
+}
+
+.shepherd-element.new-builder-tour .shepherd-footer {
+  padding: 0.75rem 1.25rem 1rem !important;
+  border-top: 1px solid #e4e4e7 !important; /* zinc-200 */
+  gap: 0.5rem !important;
+  display: flex !important;
+  justify-content: flex-end !important;
+}
+
+.shepherd-element.new-builder-tour .shepherd-button {
+  display: inline-flex !important;
+  align-items: center !important;
+  justify-content: center !important;
+  white-space: nowrap !important;
+  font-family: var(--font-geist-sans), system-ui, sans-serif !important;
+  font-weight: 500 !important;
+  font-size: 0.875rem !important;
+  line-height: 1.25rem !important;
+  transition: all 150ms ease !important;
+  border-radius: 9999px !important; /* rounded-full */
+  min-width: 5rem !important;
+  padding: 0.5rem 1rem !important;
+  height: 2.25rem !important;
+  gap: 0.375rem !important;
+  cursor: pointer !important;
+}
+
+.shepherd-element.new-builder-tour
+  .shepherd-button:not(.shepherd-button-secondary) {
+  background-color: #27272a !important; /* zinc-800 */
+  border: 1px solid #27272a !important;
+  color: white !important;
+}
+
+.shepherd-element.new-builder-tour
+  .shepherd-button:not(.shepherd-button-secondary):hover {
+  background-color: #18181b !important; /* zinc-900 */
+  border-color: #18181b !important;
+}
+
+.shepherd-element.new-builder-tour
+  .shepherd-button:not(.shepherd-button-secondary):active {
+  transform: scale(0.98);
+}
+
+.shepherd-element.new-builder-tour .shepherd-button-secondary {
+  background-color: #f4f4f5 !important; /* zinc-100 */
+  border: 1px solid #f4f4f5 !important;
+  color: #52525b !important; /* zinc-600 */
+}
+
+.shepherd-element.new-builder-tour .shepherd-button-secondary:hover {
+  background-color: #e4e4e7 !important; /* zinc-200 */
+  border-color: #e4e4e7 !important;
+  color: #27272a !important; /* zinc-800 */
+}
+
+.shepherd-element.new-builder-tour .shepherd-button-secondary:active {
+  transform: scale(0.98);
+}
+
+.shepherd-element.new-builder-tour .shepherd-cancel-icon {
+  color: #a1a1aa !important; /* zinc-400 */
+  transition: color 150ms ease !important;
+  width: 1.5rem !important;
+  height: 1.5rem !important;
+}
+
+.shepherd-element.new-builder-tour .shepherd-cancel-icon:hover {
+  color: #52525b !important; /* zinc-600 */
+}
+
+.shepherd-element.new-builder-tour .shepherd-arrow {
+  transform: scale(1.2) !important;
+}
+
+.shepherd-element.new-builder-tour .shepherd-arrow:before {
+  background: white !important;
+}
+
+.shepherd-element.new-builder-tour[data-popper-placement^="top"] {
+  margin-bottom: 40px !important;
+}
+
+.shepherd-element.new-builder-tour[data-popper-placement^="bottom"] {
+  margin-top: 40px !important;
+}
+
+.shepherd-element.new-builder-tour[data-popper-placement^="left"] {
+  margin-right: 30px !important;
+}
+
+.shepherd-element.new-builder-tour[data-popper-placement^="right"] {
+  margin-left: 30px !important;
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/ControlPanelButton.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/ControlPanelButton.tsx
index b176a002a7..36834becf6 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/ControlPanelButton.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/ControlPanelButton.tsx
@@ -24,7 +24,7 @@ export const ControlPanelButton: React.FC<Props> = ({
       role={as === "div" ? "button" : undefined}
       disabled={as === "button" ? disabled : undefined}
       className={cn(
-        "flex h-[4.25rem] w-[4.25rem] items-center justify-center whitespace-normal bg-white p-[1.38rem] text-zinc-800 shadow-none hover:cursor-pointer hover:bg-zinc-100 hover:text-zinc-950 focus:ring-0",
+        "flex w-auto items-center justify-center whitespace-normal bg-white px-4 py-4 text-zinc-800 shadow-none hover:cursor-pointer hover:bg-zinc-100 hover:text-zinc-950 focus:ring-0",
         selected &&
           "bg-violet-50 text-violet-700 hover:cursor-default hover:bg-violet-50 hover:text-violet-700 active:bg-violet-50 active:text-violet-700",
         disabled && "cursor-not-allowed opacity-50 hover:cursor-not-allowed",
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/Block.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/Block.tsx
index 435aa62c61..10f4fc8a44 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/Block.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/Block.tsx
@@ -65,9 +65,15 @@ export const Block: BlockComponent = ({
     setTimeout(() => document.body.removeChild(dragPreview), 0);
   };
 
+  // Generate a data-id from the block id (e.g., "AgentInputBlock" -> "block-card-AgentInputBlock")
+  const blockDataId = blockData.id
+    ? `block-card-${blockData.id.replace(/[^a-zA-Z0-9]/g, "")}`
+    : undefined;
+
   return (
     <Button
       draggable={true}
+      data-id={blockDataId}
       className={cn(
         "group flex h-16 w-full min-w-[7.5rem] items-center justify-start space-x-3 whitespace-normal rounded-[0.75rem] bg-zinc-50 px-[0.875rem] py-[0.625rem] text-start shadow-none",
         "hover:cursor-default hover:bg-zinc-100 focus:ring-0 active:bg-zinc-100 active:ring-1 active:ring-zinc-300 disabled:cursor-not-allowed",
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenu/BlockMenu.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenu/BlockMenu.tsx
index bbaf410296..74b4485c80 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenu/BlockMenu.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenu/BlockMenu.tsx
@@ -1,24 +1,30 @@
-import React from "react";
+import { useControlPanelStore } from "@/app/(platform)/build/stores/controlPanelStore";
 import {
   Popover,
   PopoverContent,
   PopoverTrigger,
 } from "@/components/__legacy__/ui/popover";
-import { BlockMenuContent } from "../BlockMenuContent/BlockMenuContent";
-import { ControlPanelButton } from "../../ControlPanelButton";
-import { LegoIcon } from "@phosphor-icons/react";
-import { useControlPanelStore } from "@/app/(platform)/build/stores/controlPanelStore";
 import {
   Tooltip,
   TooltipContent,
   TooltipTrigger,
 } from "@/components/atoms/Tooltip/BaseTooltip";
+import { LegoIcon } from "@phosphor-icons/react";
+import { ControlPanelButton } from "../../ControlPanelButton";
+import { BlockMenuContent } from "../BlockMenuContent/BlockMenuContent";
 
 export const BlockMenu = () => {
-  const { blockMenuOpen, setBlockMenuOpen } = useControlPanelStore();
+  const { blockMenuOpen, setBlockMenuOpen, forceOpenBlockMenu } =
+    useControlPanelStore();
   return (
-    // pinBlocksPopover ? true : open
-    <Popover onOpenChange={setBlockMenuOpen} open={blockMenuOpen}>
+    <Popover
+      onOpenChange={(open) => {
+        if (!forceOpenBlockMenu || open) {
+          setBlockMenuOpen(open);
+        }
+      }}
+      open={forceOpenBlockMenu ? true : blockMenuOpen}
+    >
       <Tooltip delayDuration={100}>
         <TooltipTrigger asChild>
           <PopoverTrigger className="hover:cursor-pointer">
@@ -28,7 +34,7 @@ export const BlockMenu = () => {
               selected={blockMenuOpen}
               className="rounded-none"
             >
-              <LegoIcon className="h-6 w-6" />
+              <LegoIcon className="size-5" />
             </ControlPanelButton>
           </PopoverTrigger>
         </TooltipTrigger>
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuFilters/BlockMenuFilters.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuFilters/BlockMenuFilters.tsx
new file mode 100644
index 0000000000..ebcea9eee6
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuFilters/BlockMenuFilters.tsx
@@ -0,0 +1,57 @@
+import { useBlockMenuStore } from "@/app/(platform)/build/stores/blockMenuStore";
+import { FilterChip } from "../FilterChip";
+import { categories } from "./constants";
+import { FilterSheet } from "../FilterSheet/FilterSheet";
+import { GetV2BuilderSearchFilterAnyOfItem } from "@/app/api/__generated__/models/getV2BuilderSearchFilterAnyOfItem";
+
+export const BlockMenuFilters = () => {
+  const {
+    filters,
+    addFilter,
+    removeFilter,
+    categoryCounts,
+    creators,
+    addCreator,
+    removeCreator,
+  } = useBlockMenuStore();
+
+  const handleFilterClick = (filter: GetV2BuilderSearchFilterAnyOfItem) => {
+    if (filters.includes(filter)) {
+      removeFilter(filter);
+    } else {
+      addFilter(filter);
+    }
+  };
+
+  const handleCreatorClick = (creator: string) => {
+    if (creators.includes(creator)) {
+      removeCreator(creator);
+    } else {
+      addCreator(creator);
+    }
+  };
+
+  return (
+    <div className="flex flex-wrap gap-2">
+      <FilterSheet categories={categories} />
+      {creators.length > 0 &&
+        creators.map((creator) => (
+          <FilterChip
+            key={creator}
+            name={"Created by " + creator.slice(0, 10) + "..."}
+            selected={creators.includes(creator)}
+            onClick={() => handleCreatorClick(creator)}
+          />
+        ))}
+      {categories.map((category) => (
+        <FilterChip
+          key={category.key}
+          name={category.name}
+          selected={filters.includes(category.key)}
+          onClick={() => handleFilterClick(category.key)}
+          number={categoryCounts[category.key] ?? 0}
+        />
+      ))}
+    </div>
+  );
+};
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuFilters/constants.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuFilters/constants.ts
new file mode 100644
index 0000000000..b438aae91b
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuFilters/constants.ts
@@ -0,0 +1,15 @@
+import { GetV2BuilderSearchFilterAnyOfItem } from "@/app/api/__generated__/models/getV2BuilderSearchFilterAnyOfItem";
+import { CategoryKey } from "./types";
+
+export const categories: Array<{ key: CategoryKey; name: string }> = [
+  { key: GetV2BuilderSearchFilterAnyOfItem.blocks, name: "Blocks" },
+  {
+    key: GetV2BuilderSearchFilterAnyOfItem.integrations,
+    name: "Integrations",
+  },
+  {
+    key: GetV2BuilderSearchFilterAnyOfItem.marketplace_agents,
+    name: "Marketplace agents",
+  },
+  { key: GetV2BuilderSearchFilterAnyOfItem.my_agents, name: "My agents" },
+];
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuFilters/types.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuFilters/types.ts
new file mode 100644
index 0000000000..8fec9ef64d
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuFilters/types.ts
@@ -0,0 +1,26 @@
+import { GetV2BuilderSearchFilterAnyOfItem } from "@/app/api/__generated__/models/getV2BuilderSearchFilterAnyOfItem";
+
+export type DefaultStateType =
+  | "suggestion"
+  | "all_blocks"
+  | "input_blocks"
+  | "action_blocks"
+  | "output_blocks"
+  | "integrations"
+  | "marketplace_agents"
+  | "my_agents";
+
+export type CategoryKey = GetV2BuilderSearchFilterAnyOfItem;
+
+export interface Filters {
+  categories: {
+    blocks: boolean;
+    integrations: boolean;
+    marketplace_agents: boolean;
+    my_agents: boolean;
+    providers: boolean;
+  };
+  createdBy: string[];
+}
+
+export type CategoryCounts = Record<CategoryKey, number>;
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearch/BlockMenuSearch.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearch/BlockMenuSearch.tsx
index de339431e8..70055b77a9 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearch/BlockMenuSearch.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearch/BlockMenuSearch.tsx
@@ -1,111 +1,17 @@
 import { Text } from "@/components/atoms/Text/Text";
-import { useBlockMenuSearch } from "./useBlockMenuSearch";
-import { InfiniteScroll } from "@/components/contextual/InfiniteScroll/InfiniteScroll";
-import { LoadingSpinner } from "@/components/__legacy__/ui/loading";
-import { SearchResponseItemsItem } from "@/app/api/__generated__/models/searchResponseItemsItem";
-import { MarketplaceAgentBlock } from "../MarketplaceAgentBlock";
-import { Block } from "../Block";
-import { UGCAgentBlock } from "../UGCAgentBlock";
-import { getSearchItemType } from "./helper";
-import { useBlockMenuStore } from "../../../../stores/blockMenuStore";
 import { blockMenuContainerStyle } from "../style";
-import { cn } from "@/lib/utils";
-import { NoSearchResult } from "../NoSearchResult";
+import { BlockMenuFilters } from "../BlockMenuFilters/BlockMenuFilters";
+import { BlockMenuSearchContent } from "../BlockMenuSearchContent/BlockMenuSearchContent";
 
 export const BlockMenuSearch = () => {
-  const {
-    searchResults,
-    isFetchingNextPage,
-    fetchNextPage,
-    hasNextPage,
-    searchLoading,
-    handleAddLibraryAgent,
-    handleAddMarketplaceAgent,
-    addingLibraryAgentId,
-    addingMarketplaceAgentSlug,
-  } = useBlockMenuSearch();
-  const { searchQuery } = useBlockMenuStore();
-
-  if (searchLoading) {
-    return (
-      <div
-        className={cn(
-          blockMenuContainerStyle,
-          "flex items-center justify-center",
-        )}
-      >
-        <LoadingSpinner className="size-13" />
-      </div>
-    );
-  }
-
-  if (searchResults.length === 0) {
-    return <NoSearchResult />;
-  }
-
   return (
-    <div className={blockMenuContainerStyle}>
+    <div
+      className={blockMenuContainerStyle}
+      data-id="blocks-control-search-results"
+    >
+      <BlockMenuFilters />
       <Text variant="body-medium">Search results</Text>
-      <InfiniteScroll
-        isFetchingNextPage={isFetchingNextPage}
-        fetchNextPage={fetchNextPage}
-        hasNextPage={hasNextPage}
-        loader={<LoadingSpinner className="size-13" />}
-        className="space-y-2.5"
-      >
-        {searchResults.map((item: SearchResponseItemsItem, index: number) => {
-          const { type, data } = getSearchItemType(item);
-          // backend give support to these 3 types only [right now] - we need to give support to integration and ai agent types in follow up PRs
-          switch (type) {
-            case "store_agent":
-              return (
-                <MarketplaceAgentBlock
-                  key={index}
-                  slug={data.slug}
-                  highlightedText={searchQuery}
-                  title={data.agent_name}
-                  image_url={data.agent_image}
-                  creator_name={data.creator}
-                  number_of_runs={data.runs}
-                  loading={addingMarketplaceAgentSlug === data.slug}
-                  onClick={() =>
-                    handleAddMarketplaceAgent({
-                      creator_name: data.creator,
-                      slug: data.slug,
-                    })
-                  }
-                />
-              );
-            case "block":
-              return (
-                <Block
-                  key={index}
-                  title={data.name}
-                  highlightedText={searchQuery}
-                  description={data.description}
-                  blockData={data}
-                />
-              );
-
-            case "library_agent":
-              return (
-                <UGCAgentBlock
-                  key={index}
-                  title={data.name}
-                  highlightedText={searchQuery}
-                  image_url={data.image_url}
-                  version={data.graph_version}
-                  edited_time={data.updated_at}
-                  isLoading={addingLibraryAgentId === data.id}
-                  onClick={() => handleAddLibraryAgent(data)}
-                />
-              );
-
-            default:
-              return null;
-          }
-        })}
-      </InfiniteScroll>
+      <BlockMenuSearchContent />
     </div>
   );
 };
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearchBar/BlockMenuSearchBar.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearchBar/BlockMenuSearchBar.tsx
index 165a3f05ea..57a7b711b0 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearchBar/BlockMenuSearchBar.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearchBar/BlockMenuSearchBar.tsx
@@ -22,6 +22,7 @@ export const BlockMenuSearchBar: React.FC<BlockMenuSearchBarProps> = ({
 
   return (
     <div
+      data-id="blocks-control-search-bar"
       className={cn(
         "flex min-h-[3.5625rem] items-center gap-2.5 px-4",
         className,
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearchContent/BlockMenuSearchContent.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearchContent/BlockMenuSearchContent.tsx
new file mode 100644
index 0000000000..7229c44ed7
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearchContent/BlockMenuSearchContent.tsx
@@ -0,0 +1,108 @@
+import { SearchResponseItemsItem } from "@/app/api/__generated__/models/searchResponseItemsItem";
+import { LoadingSpinner } from "@/components/atoms/LoadingSpinner/LoadingSpinner";
+import { InfiniteScroll } from "@/components/contextual/InfiniteScroll/InfiniteScroll";
+import { getSearchItemType } from "./helper";
+import { MarketplaceAgentBlock } from "../MarketplaceAgentBlock";
+import { Block } from "../Block";
+import { UGCAgentBlock } from "../UGCAgentBlock";
+import { useBlockMenuSearchContent } from "./useBlockMenuSearchContent";
+import { useBlockMenuStore } from "@/app/(platform)/build/stores/blockMenuStore";
+import { cn } from "@/lib/utils";
+import { blockMenuContainerStyle } from "../style";
+import { NoSearchResult } from "../NoSearchResult";
+
+export const BlockMenuSearchContent = () => {
+  const {
+    searchResults,
+    isFetchingNextPage,
+    fetchNextPage,
+    hasNextPage,
+    searchLoading,
+    handleAddLibraryAgent,
+    handleAddMarketplaceAgent,
+    addingLibraryAgentId,
+    addingMarketplaceAgentSlug,
+  } = useBlockMenuSearchContent();
+
+  const { searchQuery } = useBlockMenuStore();
+
+  if (searchLoading) {
+    return (
+      <div
+        className={cn(
+          blockMenuContainerStyle,
+          "flex items-center justify-center",
+        )}
+      >
+        <LoadingSpinner className="size-13" />
+      </div>
+    );
+  }
+
+  if (searchResults.length === 0) {
+    return <NoSearchResult />;
+  }
+
+  return (
+    <InfiniteScroll
+      isFetchingNextPage={isFetchingNextPage}
+      fetchNextPage={fetchNextPage}
+      hasNextPage={hasNextPage}
+      loader={<LoadingSpinner className="size-13" />}
+      className="space-y-2.5"
+    >
+      {searchResults.map((item: SearchResponseItemsItem, index: number) => {
+        const { type, data } = getSearchItemType(item);
+        // backend give support to these 3 types only [right now] - we need to give support to integration and ai agent types in follow up PRs
+        switch (type) {
+          case "store_agent":
+            return (
+              <MarketplaceAgentBlock
+                key={index}
+                slug={data.slug}
+                highlightedText={searchQuery}
+                title={data.agent_name}
+                image_url={data.agent_image}
+                creator_name={data.creator}
+                number_of_runs={data.runs}
+                loading={addingMarketplaceAgentSlug === data.slug}
+                onClick={() =>
+                  handleAddMarketplaceAgent({
+                    creator_name: data.creator,
+                    slug: data.slug,
+                  })
+                }
+              />
+            );
+          case "block":
+            return (
+              <Block
+                key={index}
+                title={data.name}
+                highlightedText={searchQuery}
+                description={data.description}
+                blockData={data}
+              />
+            );
+
+          case "library_agent":
+            return (
+              <UGCAgentBlock
+                key={index}
+                title={data.name}
+                highlightedText={searchQuery}
+                image_url={data.image_url}
+                version={data.graph_version}
+                edited_time={data.updated_at}
+                isLoading={addingLibraryAgentId === data.id}
+                onClick={() => handleAddLibraryAgent(data)}
+              />
+            );
+
+          default:
+            return null;
+        }
+      })}
+    </InfiniteScroll>
+  );
+};
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearch/helper.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearchContent/helper.ts
similarity index 100%
rename from autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearch/helper.ts
rename to autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearchContent/helper.ts
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearch/useBlockMenuSearch.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearchContent/useBlockMenuSearchContent.tsx
similarity index 83%
rename from autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearch/useBlockMenuSearch.ts
rename to autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearchContent/useBlockMenuSearchContent.tsx
index beff80a984..9da9cb4cbc 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearch/useBlockMenuSearch.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSearchContent/useBlockMenuSearchContent.tsx
@@ -23,9 +23,19 @@ import { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
 import { getQueryClient } from "@/lib/react-query/queryClient";
 import { useToast } from "@/components/molecules/Toast/use-toast";
 import * as Sentry from "@sentry/nextjs";
+import { GetV2BuilderSearchFilterAnyOfItem } from "@/app/api/__generated__/models/getV2BuilderSearchFilterAnyOfItem";
+
+export const useBlockMenuSearchContent = () => {
+  const {
+    searchQuery,
+    searchId,
+    setSearchId,
+    filters,
+    setCreatorsList,
+    creators,
+    setCategoryCounts,
+  } = useBlockMenuStore();
 
-export const useBlockMenuSearch = () => {
-  const { searchQuery, searchId, setSearchId } = useBlockMenuStore();
   const { toast } = useToast();
   const { addAgentToBuilder, addLibraryAgentToBuilder } =
     useAddAgentToBuilder();
@@ -57,6 +67,8 @@ export const useBlockMenuSearch = () => {
       page_size: 8,
       search_query: searchQuery,
       search_id: searchId,
+      filter: filters.length > 0 ? filters : undefined,
+      by_creator: creators.length > 0 ? creators : undefined,
     },
     {
       query: { getNextPageParam: getPaginationNextPageNumber },
@@ -98,6 +110,26 @@ export const useBlockMenuSearch = () => {
     }
   }, [searchQueryData, searchId, setSearchId]);
 
+  // from all the results, we need to get all the unique creators
+  useEffect(() => {
+    if (!searchQueryData?.pages?.length) {
+      return;
+    }
+    const latestData = okData(searchQueryData.pages.at(-1));
+    setCategoryCounts(
+      (latestData?.total_items as Record<
+        GetV2BuilderSearchFilterAnyOfItem,
+        number
+      >) || {
+        blocks: 0,
+        integrations: 0,
+        marketplace_agents: 0,
+        my_agents: 0,
+      },
+    );
+    setCreatorsList(latestData?.items || []);
+  }, [searchQueryData]);
+
   useEffect(() => {
     if (searchId && !searchQuery) {
       resetSearchSession();
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSidebar/BlockMenuSidebar.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSidebar/BlockMenuSidebar.tsx
index 16b0ccb8fb..1872e610b6 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSidebar/BlockMenuSidebar.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/BlockMenuSidebar/BlockMenuSidebar.tsx
@@ -101,6 +101,7 @@ export const BlockMenuSidebar = () => {
           key={item.type}
           name={item.name}
           number={item.number}
+          menuItemType={item.type}
           selected={defaultState === item.type}
           onClick={() => setDefaultState(item.type as DefaultStateType)}
         />
@@ -111,6 +112,7 @@ export const BlockMenuSidebar = () => {
             key={item.type}
             name={item.name}
             number={item.number}
+            menuItemType={item.type}
             className="max-w-[11.5339rem]"
             selected={defaultState === item.type}
             onClick={() => setDefaultState(item.type as DefaultStateType)}
@@ -122,6 +124,7 @@ export const BlockMenuSidebar = () => {
           key={item.type}
           name={item.name}
           number={item.number}
+          menuItemType={item.type}
           selected={defaultState === item.type}
           onClick={
             item.onClick ||
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/FilterChip.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/FilterChip.tsx
index 69931958b3..23197ab612 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/FilterChip.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/FilterChip.tsx
@@ -1,7 +1,9 @@
 import { Button } from "@/components/__legacy__/ui/button";
 import { cn } from "@/lib/utils";
-import { X } from "lucide-react";
-import React, { ButtonHTMLAttributes } from "react";
+import { XIcon } from "@phosphor-icons/react";
+import { AnimatePresence, motion } from "framer-motion";
+
+import React, { ButtonHTMLAttributes, useState } from "react";
 
 interface Props extends ButtonHTMLAttributes<HTMLButtonElement> {
   selected?: boolean;
@@ -16,39 +18,51 @@ export const FilterChip: React.FC<Props> = ({
   className,
   ...rest
 }) => {
+  const [isHovered, setIsHovered] = useState(false);
   return (
-    <Button
-      className={cn(
-        "group w-fit space-x-1 rounded-[1.5rem] border border-zinc-300 bg-transparent px-[0.625rem] py-[0.375rem] shadow-none transition-transform duration-300 ease-in-out",
-        "hover:border-violet-500 hover:bg-transparent focus:ring-0 disabled:cursor-not-allowed",
-        selected && "border-0 bg-violet-700 hover:border",
-        className,
-      )}
-      {...rest}
-    >
-      <span
+    <AnimatePresence mode="wait">
+      <Button
+        onMouseEnter={() => setIsHovered(true)}
+        onMouseLeave={() => setIsHovered(false)}
         className={cn(
-          "font-sans text-sm font-medium leading-[1.375rem] text-zinc-600 group-hover:text-zinc-600 group-disabled:text-zinc-400",
-          selected && "text-zinc-50",
+          "group w-fit space-x-1 rounded-[1.5rem] border border-zinc-300 bg-transparent px-[0.625rem] py-[0.375rem] shadow-none",
+          "hover:border-violet-500 hover:bg-transparent focus:ring-0 disabled:cursor-not-allowed",
+          selected && "border-0 bg-violet-700 hover:border",
+          className,
         )}
+        {...rest}
       >
-        {name}
-      </span>
-      {selected && (
-        <>
-          <span className="flex h-4 w-4 items-center justify-center rounded-full bg-zinc-50 transition-all duration-300 ease-in-out group-hover:hidden">
-            <X
-              className="h-3 w-3 rounded-full text-violet-700"
-              strokeWidth={2}
-            />
-          </span>
-          {number !== undefined && (
-            <span className="hidden h-[1.375rem] items-center rounded-[1.25rem] bg-violet-700 p-[0.375rem] text-zinc-50 transition-all duration-300 ease-in-out animate-in fade-in zoom-in group-hover:flex">
-              {number > 100 ? "100+" : number}
-            </span>
+        <span
+          className={cn(
+            "font-sans text-sm font-medium leading-[1.375rem] text-zinc-600 group-hover:text-zinc-600 group-disabled:text-zinc-400",
+            selected && "text-zinc-50",
           )}
-        </>
-      )}
-    </Button>
+        >
+          {name}
+        </span>
+        {selected && !isHovered && (
+          <motion.span
+            initial={{ opacity: 0.5, scale: 0.5, filter: "blur(20px)" }}
+            animate={{ opacity: 1, scale: 1, filter: "blur(0px)" }}
+            exit={{ opacity: 0.5, scale: 0.5, filter: "blur(20px)" }}
+            transition={{ duration: 0.3, type: "spring", bounce: 0.2 }}
+            className="flex h-4 w-4 items-center justify-center rounded-full bg-zinc-50"
+          >
+            <XIcon size={12} weight="bold" className="text-violet-700" />
+          </motion.span>
+        )}
+        {number !== undefined && isHovered && (
+          <motion.span
+            initial={{ opacity: 0.5, scale: 0.5, filter: "blur(10px)" }}
+            animate={{ opacity: 1, scale: 1, filter: "blur(0px)" }}
+            exit={{ opacity: 0.5, scale: 0.5, filter: "blur(10px)" }}
+            transition={{ duration: 0.3, type: "spring", bounce: 0.2 }}
+            className="flex h-[1.375rem] items-center rounded-[1.25rem] bg-violet-700 p-[0.375rem] text-zinc-50"
+          >
+            {number > 100 ? "100+" : number}
+          </motion.span>
+        )}
+      </Button>
+    </AnimatePresence>
   );
 };
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/FilterSheet/FilterSheet.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/FilterSheet/FilterSheet.tsx
new file mode 100644
index 0000000000..dc7c428245
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/FilterSheet/FilterSheet.tsx
@@ -0,0 +1,156 @@
+import { FilterChip } from "../FilterChip";
+import { cn } from "@/lib/utils";
+import { CategoryKey } from "../BlockMenuFilters/types";
+import { AnimatePresence, motion } from "framer-motion";
+import { XIcon } from "@phosphor-icons/react";
+import { Button } from "@/components/atoms/Button/Button";
+import { Text } from "@/components/atoms/Text/Text";
+import { Separator } from "@/components/__legacy__/ui/separator";
+import { Checkbox } from "@/components/__legacy__/ui/checkbox";
+import { useFilterSheet } from "./useFilterSheet";
+import { INITIAL_CREATORS_TO_SHOW } from "./constant";
+
+export function FilterSheet({
+  categories,
+}: {
+  categories: Array<{ key: CategoryKey; name: string }>;
+}) {
+  const {
+    isOpen,
+    localCategories,
+    localCreators,
+    displayedCreatorsCount,
+    handleLocalCategoryChange,
+    handleToggleShowMoreCreators,
+    handleLocalCreatorChange,
+    handleClearFilters,
+    handleCloseButton,
+    handleApplyFilters,
+    hasLocalActiveFilters,
+    visibleCreators,
+    creators,
+    handleOpenFilters,
+    hasActiveFilters,
+  } = useFilterSheet();
+
+  return (
+    <div className="m-0 inline w-fit p-0">
+      <FilterChip
+        name={hasActiveFilters() ? "Edit filters" : "All filters"}
+        onClick={handleOpenFilters}
+      />
+
+      <AnimatePresence>
+        {isOpen && (
+          <motion.div
+            className={cn(
+              "absolute bottom-2 left-2 top-2 z-20 w-3/4 max-w-[22.5rem] space-y-4 overflow-hidden rounded-[0.75rem] bg-white pb-4 shadow-[0_4px_12px_2px_rgba(0,0,0,0.1)]",
+            )}
+            initial={{ x: "-100%", filter: "blur(10px)" }}
+            animate={{ x: 0, filter: "blur(0px)" }}
+            exit={{ x: "-110%", filter: "blur(10px)" }}
+            transition={{ duration: 0.4, type: "spring", bounce: 0.2 }}
+          >
+            {/* Top section */}
+            <div className="flex items-center justify-between px-5 pt-4">
+              <Text variant="body">Filters</Text>
+              <Button
+                className="p-0"
+                variant="ghost"
+                size="icon"
+                onClick={handleCloseButton}
+              >
+                <XIcon size={20} />
+              </Button>
+            </div>
+
+            <Separator className="h-[1px] w-full text-zinc-300" />
+
+            {/* Category section */}
+            <div className="space-y-4 px-5">
+              <Text variant="large">Categories</Text>
+              <div className="space-y-2">
+                {categories.map((category) => (
+                  <div
+                    key={category.key}
+                    className="flex items-center space-x-2"
+                  >
+                    <Checkbox
+                      id={category.key}
+                      checked={localCategories.includes(category.key)}
+                      onCheckedChange={() =>
+                        handleLocalCategoryChange(category.key)
+                      }
+                      className="border border-[#D4D4D4] shadow-none data-[state=checked]:border-none data-[state=checked]:bg-violet-700 data-[state=checked]:text-white"
+                    />
+                    <label
+                      htmlFor={category.key}
+                      className="font-sans text-sm leading-[1.375rem] text-zinc-600"
+                    >
+                      {category.name}
+                    </label>
+                  </div>
+                ))}
+              </div>
+            </div>
+
+            {/* Created by section */}
+            <div className="space-y-4 px-5">
+              <p className="font-sans text-base font-medium text-zinc-800">
+                Created by
+              </p>
+              <div className="space-y-2">
+                {visibleCreators.map((creator, i) => (
+                  <div key={i} className="flex items-center space-x-2">
+                    <Checkbox
+                      id={`creator-${creator}`}
+                      checked={localCreators.includes(creator)}
+                      onCheckedChange={() => handleLocalCreatorChange(creator)}
+                      className="border border-[#D4D4D4] shadow-none data-[state=checked]:border-none data-[state=checked]:bg-violet-700 data-[state=checked]:text-white"
+                    />
+                    <label
+                      htmlFor={`creator-${creator}`}
+                      className="font-sans text-sm leading-[1.375rem] text-zinc-600"
+                    >
+                      {creator}
+                    </label>
+                  </div>
+                ))}
+              </div>
+              {creators.length > INITIAL_CREATORS_TO_SHOW && (
+                <Button
+                  variant={"link"}
+                  className="m-0 p-0 font-sans text-sm font-medium leading-[1.375rem] text-zinc-800 underline hover:text-zinc-600"
+                  onClick={handleToggleShowMoreCreators}
+                >
+                  {displayedCreatorsCount < creators.length ? "More" : "Less"}
+                </Button>
+              )}
+            </div>
+
+            {/* Footer section */}
+            <div className="fixed bottom-0 flex w-full justify-between gap-3 border-t border-zinc-200 bg-white px-5 py-3">
+              <Button
+                size="small"
+                variant={"outline"}
+                onClick={handleClearFilters}
+                className="rounded-[8px] px-2 py-1.5"
+              >
+                Clear
+              </Button>
+
+              <Button
+                size="small"
+                onClick={handleApplyFilters}
+                disabled={!hasLocalActiveFilters()}
+                className="rounded-[8px] px-2 py-1.5"
+              >
+                Apply filters
+              </Button>
+            </div>
+          </motion.div>
+        )}
+      </AnimatePresence>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/FilterSheet/constant.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/FilterSheet/constant.ts
new file mode 100644
index 0000000000..8e05dc1037
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/FilterSheet/constant.ts
@@ -0,0 +1 @@
+export const INITIAL_CREATORS_TO_SHOW = 5;
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/FilterSheet/useFilterSheet.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/FilterSheet/useFilterSheet.ts
new file mode 100644
index 0000000000..200671f4e7
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/FilterSheet/useFilterSheet.ts
@@ -0,0 +1,100 @@
+import { useBlockMenuStore } from "@/app/(platform)/build/stores/blockMenuStore";
+import { useState } from "react";
+import { INITIAL_CREATORS_TO_SHOW } from "./constant";
+import { GetV2BuilderSearchFilterAnyOfItem } from "@/app/api/__generated__/models/getV2BuilderSearchFilterAnyOfItem";
+
+export const useFilterSheet = () => {
+  const { filters, creators_list, creators, setFilters, setCreators } =
+    useBlockMenuStore();
+
+  const [isOpen, setIsOpen] = useState(false);
+  const [localCategories, setLocalCategories] =
+    useState<GetV2BuilderSearchFilterAnyOfItem[]>(filters);
+  const [localCreators, setLocalCreators] = useState<string[]>(creators);
+  const [displayedCreatorsCount, setDisplayedCreatorsCount] = useState(
+    INITIAL_CREATORS_TO_SHOW,
+  );
+
+  const handleLocalCategoryChange = (
+    category: GetV2BuilderSearchFilterAnyOfItem,
+  ) => {
+    setLocalCategories((prev) => {
+      if (prev.includes(category)) {
+        return prev.filter((c) => c !== category);
+      }
+      return [...prev, category];
+    });
+  };
+
+  const hasActiveFilters = () => {
+    return filters.length > 0 || creators.length > 0;
+  };
+
+  const handleToggleShowMoreCreators = () => {
+    if (displayedCreatorsCount < creators.length) {
+      setDisplayedCreatorsCount(creators.length);
+    } else {
+      setDisplayedCreatorsCount(INITIAL_CREATORS_TO_SHOW);
+    }
+  };
+
+  const handleLocalCreatorChange = (creator: string) => {
+    setLocalCreators((prev) => {
+      if (prev.includes(creator)) {
+        return prev.filter((c) => c !== creator);
+      }
+      return [...prev, creator];
+    });
+  };
+
+  const handleClearFilters = () => {
+    setLocalCategories([]);
+    setLocalCreators([]);
+    setDisplayedCreatorsCount(INITIAL_CREATORS_TO_SHOW);
+  };
+
+  const handleCloseButton = () => {
+    setIsOpen(false);
+    setLocalCategories(filters);
+    setLocalCreators(creators);
+    setDisplayedCreatorsCount(INITIAL_CREATORS_TO_SHOW);
+  };
+
+  const handleApplyFilters = () => {
+    setFilters(localCategories);
+    setCreators(localCreators);
+    setIsOpen(false);
+  };
+
+  const handleOpenFilters = () => {
+    setIsOpen(true);
+    setLocalCategories(filters);
+    setLocalCreators(creators);
+  };
+
+  const hasLocalActiveFilters = () => {
+    return localCategories.length > 0 || localCreators.length > 0;
+  };
+
+  const visibleCreators = creators_list.slice(0, displayedCreatorsCount);
+
+  return {
+    creators,
+    isOpen,
+    setIsOpen,
+    localCategories,
+    localCreators,
+    displayedCreatorsCount,
+    setDisplayedCreatorsCount,
+    handleLocalCategoryChange,
+    handleToggleShowMoreCreators,
+    handleLocalCreatorChange,
+    handleClearFilters,
+    handleCloseButton,
+    handleOpenFilters,
+    handleApplyFilters,
+    hasLocalActiveFilters,
+    visibleCreators,
+    hasActiveFilters,
+  };
+};
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/MenuItem.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/MenuItem.tsx
index a1dbbb4c6a..b846c02cb7 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/MenuItem.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/MenuItem.tsx
@@ -8,6 +8,7 @@ interface Props extends ButtonHTMLAttributes<HTMLButtonElement> {
   selected?: boolean;
   number?: number;
   name?: string;
+  menuItemType?: string;
 }
 
 export const MenuItem: React.FC<Props> = ({
@@ -15,10 +16,12 @@ export const MenuItem: React.FC<Props> = ({
   number,
   name,
   className,
+  menuItemType,
   ...rest
 }) => {
   return (
     <Button
+      data-id={menuItemType ? `menu-item-${menuItemType}` : undefined}
       className={cn(
         "flex h-[2.375rem] w-[12.875rem] justify-between whitespace-normal rounded-[0.5rem] bg-transparent p-2 pl-3 shadow-none",
         "hover:cursor-default hover:bg-zinc-100 focus:ring-0",
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewControlPanel.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewControlPanel.tsx
index 4828a73af4..8c8bbf1842 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewControlPanel.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewControlPanel.tsx
@@ -7,10 +7,10 @@ import { useNewControlPanel } from "./useNewControlPanel";
 import { GraphExecutionID } from "@/lib/autogpt-server-api";
 // import { ControlPanelButton } from "../ControlPanelButton";
 // import { GraphSearchMenu } from "../GraphMenu/GraphMenu";
-import { Flag, useGetFlag } from "@/services/feature-flags/use-get-flag";
 import { Separator } from "@/components/__legacy__/ui/separator";
-import { NewSaveControl } from "./NewSaveControl/NewSaveControl";
+import { Flag, useGetFlag } from "@/services/feature-flags/use-get-flag";
 import { CustomNode } from "../FlowEditor/nodes/CustomNode/CustomNode";
+import { NewSaveControl } from "./NewSaveControl/NewSaveControl";
 import { UndoRedoButtons } from "./UndoRedoButtons";
 
 export type Control = {
@@ -56,7 +56,7 @@ export const NewControlPanel = memo(
     return (
       <section
         className={cn(
-          "absolute left-4 top-10 z-10 w-[4.25rem] overflow-hidden rounded-[1rem] border-none bg-white p-0 shadow-[0_1px_5px_0_rgba(0,0,0,0.1)]",
+          "absolute left-4 top-10 z-10 overflow-hidden rounded-[1rem] border-none bg-white p-0 shadow-[0_1px_5px_0_rgba(0,0,0,0.1)]",
         )}
       >
         <div className="flex flex-col items-center justify-center rounded-[1rem] p-0">
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewSaveControl/NewSaveControl.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewSaveControl/NewSaveControl.tsx
index beae5c1705..6769490ab3 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewSaveControl/NewSaveControl.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewSaveControl/NewSaveControl.tsx
@@ -1,29 +1,36 @@
-import React from "react";
+import { Card, CardContent, CardFooter } from "@/components/__legacy__/ui/card";
+import { Form, FormField } from "@/components/__legacy__/ui/form";
 import {
   Popover,
   PopoverContent,
   PopoverTrigger,
 } from "@/components/__legacy__/ui/popover";
-import { Card, CardContent, CardFooter } from "@/components/__legacy__/ui/card";
+import { Button } from "@/components/atoms/Button/Button";
+import { Input } from "@/components/atoms/Input/Input";
 import {
   Tooltip,
   TooltipContent,
   TooltipTrigger,
 } from "@/components/atoms/Tooltip/BaseTooltip";
-import { useNewSaveControl } from "./useNewSaveControl";
-import { Form, FormField } from "@/components/__legacy__/ui/form";
-import { ControlPanelButton } from "../ControlPanelButton";
-import { useControlPanelStore } from "../../../stores/controlPanelStore";
 import { FloppyDiskIcon } from "@phosphor-icons/react";
-import { Input } from "@/components/atoms/Input/Input";
-import { Button } from "@/components/atoms/Button/Button";
+import { useControlPanelStore } from "../../../stores/controlPanelStore";
+import { ControlPanelButton } from "../ControlPanelButton";
+import { useNewSaveControl } from "./useNewSaveControl";
 
 export const NewSaveControl = () => {
   const { form, isSaving, graphVersion, handleSave } = useNewSaveControl();
-  const { saveControlOpen, setSaveControlOpen } = useControlPanelStore();
+  const { saveControlOpen, setSaveControlOpen, forceOpenSave } =
+    useControlPanelStore();
 
   return (
-    <Popover onOpenChange={setSaveControlOpen}>
+    <Popover
+      onOpenChange={(open) => {
+        if (!forceOpenSave || open) {
+          setSaveControlOpen(open);
+        }
+      }}
+      open={forceOpenSave ? true : saveControlOpen}
+    >
       <Tooltip delayDuration={100}>
         <TooltipTrigger asChild>
           <PopoverTrigger asChild>
@@ -33,7 +40,7 @@ export const NewSaveControl = () => {
               selected={saveControlOpen}
               className="rounded-none"
             >
-              <FloppyDiskIcon className="h-6 w-6" />
+              <FloppyDiskIcon className="size-5" />
             </ControlPanelButton>
           </PopoverTrigger>
         </TooltipTrigger>
@@ -95,6 +102,7 @@ export const NewSaveControl = () => {
                       value={graphVersion || "-"}
                       disabled
                       data-testid="save-control-version-output"
+                      data-tutorial-id="save-control-version-output"
                       label="Version"
                       wrapperClassName="!mb-0"
                     />
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewSearchGraph/GraphMenu/GraphMenu.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewSearchGraph/GraphMenu/GraphMenu.tsx
index c886919642..8ff96a598b 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewSearchGraph/GraphMenu/GraphMenu.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewSearchGraph/GraphMenu/GraphMenu.tsx
@@ -1,13 +1,13 @@
-import React from "react";
+import { CustomNode } from "@/app/(platform)/build/components/legacy-builder/CustomNode/CustomNode";
 import {
   Popover,
   PopoverContent,
   PopoverTrigger,
 } from "@/components/__legacy__/ui/popover";
 import { MagnifyingGlassIcon } from "@phosphor-icons/react";
-import { GraphSearchContent } from "../GraphMenuContent/GraphContent";
+import React from "react";
 import { ControlPanelButton } from "../../ControlPanelButton";
-import { CustomNode } from "@/app/(platform)/build/components/legacy-builder/CustomNode/CustomNode";
+import { GraphSearchContent } from "../GraphMenuContent/GraphContent";
 import { useGraphMenu } from "./useGraphMenu";
 
 interface GraphSearchMenuProps {
@@ -50,7 +50,7 @@ export const GraphSearchMenu: React.FC<GraphSearchMenuProps> = ({
           selected={blockMenuSelected === "search"}
           className="rounded-none"
         >
-          <MagnifyingGlassIcon className="h-5 w-6" strokeWidth={2} />
+          <MagnifyingGlassIcon className="size-5" strokeWidth={2} />
         </ControlPanelButton>
       </PopoverTrigger>
 
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/UndoRedoButtons.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/UndoRedoButtons.tsx
index 6f134056c8..379f2743f8 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/UndoRedoButtons.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/UndoRedoButtons.tsx
@@ -1,12 +1,12 @@
 import { Separator } from "@/components/__legacy__/ui/separator";
-import { ControlPanelButton } from "./ControlPanelButton";
-import { ArrowUUpLeftIcon, ArrowUUpRightIcon } from "@phosphor-icons/react";
 import {
   Tooltip,
   TooltipContent,
   TooltipTrigger,
 } from "@/components/atoms/Tooltip/BaseTooltip";
+import { ArrowUUpLeftIcon, ArrowUUpRightIcon } from "@phosphor-icons/react";
 import { useHistoryStore } from "../../stores/historyStore";
+import { ControlPanelButton } from "./ControlPanelButton";
 
 import { useEffect } from "react";
 
@@ -42,8 +42,13 @@ export const UndoRedoButtons = () => {
     <>
       <Tooltip delayDuration={100}>
         <TooltipTrigger asChild>
-          <ControlPanelButton as="button" disabled={!canUndo()} onClick={undo}>
-            <ArrowUUpLeftIcon className="h-6 w-6" />
+          <ControlPanelButton
+            as="button"
+            data-id="undo-button"
+            disabled={!canUndo()}
+            onClick={undo}
+          >
+            <ArrowUUpLeftIcon className="size-5" />
           </ControlPanelButton>
         </TooltipTrigger>
         <TooltipContent side="right">Undo</TooltipContent>
@@ -51,8 +56,13 @@ export const UndoRedoButtons = () => {
       <Separator className="text-[#E1E1E1]" />
       <Tooltip delayDuration={100}>
         <TooltipTrigger asChild>
-          <ControlPanelButton as="button" disabled={!canRedo()} onClick={redo}>
-            <ArrowUUpRightIcon className="h-6 w-6" />
+          <ControlPanelButton
+            as="button"
+            data-id="redo-button"
+            disabled={!canRedo()}
+            onClick={redo}
+          >
+            <ArrowUUpRightIcon className="size-5" />
           </ControlPanelButton>
         </TooltipTrigger>
         <TooltipContent side="right">Redo</TooltipContent>
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/RIghtSidebar.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/RIghtSidebar.tsx
index 5e4211ce5d..cc0c7ff765 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/RIghtSidebar.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/RIghtSidebar.tsx
@@ -25,7 +25,7 @@ export const RightSidebar = () => {
     >
       <div className="mb-4">
         <h2 className="text-lg font-semibold text-slate-800 dark:text-slate-200">
-          Flow Debug Panel
+          Graph Debug Panel
         </h2>
       </div>
 
@@ -65,7 +65,7 @@ export const RightSidebar = () => {
                 {l.source_id}[{l.source_name}] → {l.sink_id}[{l.sink_name}]
               </div>
               <div className="mt-1 text-slate-500 dark:text-slate-400">
-                edge_id: {l.id}
+                edge.id: {l.id}
               </div>
             </div>
           ))}
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/BlocksControl.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/BlocksControl.tsx
index d3383cdc4f..f5451e6d4d 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/BlocksControl.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/BlocksControl.tsx
@@ -12,7 +12,14 @@ import {
   PopoverContent,
   PopoverTrigger,
 } from "@/components/__legacy__/ui/popover";
-import { Block, BlockUIType, SpecialBlockID } from "@/lib/autogpt-server-api";
+import {
+  Block,
+  BlockIORootSchema,
+  BlockUIType,
+  GraphInputSchema,
+  GraphOutputSchema,
+  SpecialBlockID,
+} from "@/lib/autogpt-server-api";
 import { MagnifyingGlassIcon, PlusIcon } from "@radix-ui/react-icons";
 import { IconToyBrick } from "@/components/__legacy__/ui/icons";
 import { getPrimaryCategoryColor } from "@/lib/utils";
@@ -24,8 +31,10 @@ import {
 import { GraphMeta } from "@/lib/autogpt-server-api";
 import jaro from "jaro-winkler";
 
-type _Block = Block & {
+type _Block = Omit<Block, "inputSchema" | "outputSchema"> & {
   uiKey?: string;
+  inputSchema: BlockIORootSchema | GraphInputSchema;
+  outputSchema: BlockIORootSchema | GraphOutputSchema;
   hardcodedValues?: Record<string, any>;
   _cached?: {
     blockName: string;
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/BuildActionBar.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/BuildActionBar.tsx
index 9671109422..9d12439d8d 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/BuildActionBar.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/BuildActionBar.tsx
@@ -2,7 +2,7 @@ import React from "react";
 import { cn } from "@/lib/utils";
 import { Button } from "@/components/__legacy__/ui/button";
 import { LogOut } from "lucide-react";
-import { ClockIcon } from "@phosphor-icons/react";
+import { ClockIcon, WarningIcon } from "@phosphor-icons/react";
 import { IconPlay, IconSquare } from "@/components/__legacy__/ui/icons";
 
 interface Props {
@@ -13,6 +13,7 @@ interface Props {
   isRunning: boolean;
   isDisabled: boolean;
   className?: string;
+  resolutionModeActive?: boolean;
 }
 
 export const BuildActionBar: React.FC<Props> = ({
@@ -23,9 +24,30 @@ export const BuildActionBar: React.FC<Props> = ({
   isRunning,
   isDisabled,
   className,
+  resolutionModeActive = false,
 }) => {
   const buttonClasses =
     "flex items-center gap-2 text-sm font-medium md:text-lg";
+
+  // Show resolution mode message instead of action buttons
+  if (resolutionModeActive) {
+    return (
+      <div
+        className={cn(
+          "flex w-fit select-none items-center justify-center p-4",
+          className,
+        )}
+      >
+        <div className="flex items-center gap-3 rounded-lg border border-amber-300 bg-amber-50 px-4 py-3 dark:border-amber-700 dark:bg-amber-900/30">
+          <WarningIcon className="size-5 text-amber-600 dark:text-amber-400" />
+          <span className="text-sm font-medium text-amber-800 dark:text-amber-200">
+            Remove incompatible connections to continue
+          </span>
+        </div>
+      </div>
+    );
+  }
+
   return (
     <div
       className={cn(
@@ -61,6 +83,7 @@ export const BuildActionBar: React.FC<Props> = ({
             title="Run the agent"
             aria-label="Run the agent"
             data-testid="primary-action-run-agent"
+            data-tutorial-id="primary-action-run-agent"
           >
             <IconPlay /> Run
           </Button>
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/CustomEdge/CustomEdge.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/CustomEdge/CustomEdge.tsx
index ce14add315..5ca5393d69 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/CustomEdge/CustomEdge.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/CustomEdge/CustomEdge.tsx
@@ -60,10 +60,16 @@ export function CustomEdge({
     targetY - 5,
   );
   const { deleteElements } = useReactFlow<Node, CustomEdge>();
-  const { visualizeBeads } = useContext(BuilderContext) ?? {
+  const builderContext = useContext(BuilderContext);
+  const { visualizeBeads } = builderContext ?? {
     visualizeBeads: "no",
   };
 
+  // Check if this edge is broken (during resolution mode)
+  const isBroken =
+    builderContext?.resolutionMode?.active &&
+    builderContext?.resolutionMode?.brokenEdgeIds?.includes(id);
+
   const onEdgeRemoveClick = () => {
     deleteElements({ edges: [{ id }] });
   };
@@ -171,12 +177,27 @@ export function CustomEdge({
 
   const middle = getPointForT(0.5);
 
+  // Determine edge color - red for broken edges
+  const baseColor = data?.edgeColor ?? "#555555";
+  const edgeColor = isBroken ? "#ef4444" : baseColor;
+  // Add opacity to hex color (99 = 60% opacity, 80 = 50% opacity)
+  const strokeColor = isBroken
+    ? `${edgeColor}99`
+    : selected
+      ? edgeColor
+      : `${edgeColor}80`;
+
   return (
     <>
       <BaseEdge
         path={svgPath}
         markerEnd={markerEnd}
-        className={`data-sentry-unmask transition-all duration-200 ${data?.isStatic ? "[stroke-dasharray:5_3]" : "[stroke-dasharray:0]"} [stroke-width:${data?.isStatic ? 2.5 : 2}px] hover:[stroke-width:${data?.isStatic ? 3.5 : 3}px] ${selected ? `[stroke:${data?.edgeColor ?? "#555555"}]` : `[stroke:${data?.edgeColor ?? "#555555"}80] hover:[stroke:${data?.edgeColor ?? "#555555"}]`}`}
+        style={{
+          stroke: strokeColor,
+          strokeWidth: data?.isStatic ? 2.5 : 2,
+          strokeDasharray: data?.isStatic ? "5 3" : undefined,
+        }}
+        className="data-sentry-unmask transition-all duration-200"
       />
       <path
         d={svgPath}
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/CustomNode/CustomNode.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/CustomNode/CustomNode.tsx
index f0a49080fa..94e917a4ac 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/CustomNode/CustomNode.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/CustomNode/CustomNode.tsx
@@ -18,6 +18,8 @@ import {
   BlockIOSubSchema,
   BlockUIType,
   Category,
+  GraphInputSchema,
+  GraphOutputSchema,
   NodeExecutionResult,
 } from "@/lib/autogpt-server-api";
 import {
@@ -62,14 +64,21 @@ import { NodeGenericInputField, NodeTextBoxInput } from "../NodeInputs";
 import NodeOutputs from "../NodeOutputs";
 import OutputModalComponent from "../OutputModalComponent";
 import "./customnode.css";
+import { SubAgentUpdateBar } from "./SubAgentUpdateBar";
+import { IncompatibilityDialog } from "./IncompatibilityDialog";
+import {
+  useSubAgentUpdate,
+  createUpdatedAgentNodeInputs,
+  getBrokenEdgeIDs,
+} from "../../../hooks/useSubAgentUpdate";
 
-export type ConnectionData = Array<{
-  edge_id: string;
+export type ConnectedEdge = {
+  id: string;
   source: string;
   sourceHandle: string;
   target: string;
   targetHandle: string;
-}>;
+};
 
 export type CustomNodeData = {
   blockType: string;
@@ -80,7 +89,7 @@ export type CustomNodeData = {
   inputSchema: BlockIORootSchema;
   outputSchema: BlockIORootSchema;
   hardcodedValues: { [key: string]: any };
-  connections: ConnectionData;
+  connections: ConnectedEdge[];
   isOutputOpen: boolean;
   status?: NodeExecutionResult["status"];
   /** executionResults contains outputs across multiple executions
@@ -127,20 +136,199 @@ export const CustomNode = React.memo(
 
     let subGraphID = "";
 
-    if (data.uiType === BlockUIType.AGENT) {
-      // Display the graph's schema instead AgentExecutorBlock's schema.
-      data.inputSchema = data.hardcodedValues?.input_schema || {};
-      data.outputSchema = data.hardcodedValues?.output_schema || {};
-      subGraphID = data.hardcodedValues?.graph_id || subGraphID;
-    }
-
     if (!builderContext) {
       throw new Error(
         "BuilderContext consumer must be inside FlowEditor component",
       );
     }
 
-    const { libraryAgent, setIsAnyModalOpen, getNextNodeId } = builderContext;
+    const {
+      libraryAgent,
+      setIsAnyModalOpen,
+      getNextNodeId,
+      availableFlows,
+      resolutionMode,
+      enterResolutionMode,
+    } = builderContext;
+
+    // Check if this node is in resolution mode (moved up for schema merge logic)
+    const isInResolutionMode =
+      resolutionMode.active && resolutionMode.nodeId === id;
+
+    if (data.uiType === BlockUIType.AGENT) {
+      // Display the graph's schema instead AgentExecutorBlock's schema.
+      const currentInputSchema = data.hardcodedValues?.input_schema || {};
+      const currentOutputSchema = data.hardcodedValues?.output_schema || {};
+      subGraphID = data.hardcodedValues?.graph_id || subGraphID;
+
+      // During resolution mode, merge old connected inputs/outputs with new schema
+      if (isInResolutionMode && resolutionMode.pendingUpdate) {
+        const newInputSchema =
+          (resolutionMode.pendingUpdate.input_schema as BlockIORootSchema) ||
+          {};
+        const newOutputSchema =
+          (resolutionMode.pendingUpdate.output_schema as BlockIORootSchema) ||
+          {};
+
+        // Merge input schemas: start with new schema, add old connected inputs that are missing
+        const mergedInputProps = { ...newInputSchema.properties };
+        const incomp = resolutionMode.incompatibilities;
+        if (incomp && currentInputSchema.properties) {
+          // Add back missing inputs that have connections (so user can see/delete them)
+          incomp.missingInputs.forEach((inputName) => {
+            if (currentInputSchema.properties[inputName]) {
+              mergedInputProps[inputName] =
+                currentInputSchema.properties[inputName];
+            }
+          });
+          // Add back inputs with type mismatches (keep old type so connection still works visually)
+          incomp.inputTypeMismatches.forEach((mismatch) => {
+            if (currentInputSchema.properties[mismatch.name]) {
+              mergedInputProps[mismatch.name] =
+                currentInputSchema.properties[mismatch.name];
+            }
+          });
+        }
+
+        // Merge output schemas: start with new schema, add old connected outputs that are missing
+        const mergedOutputProps = { ...newOutputSchema.properties };
+        if (incomp && currentOutputSchema.properties) {
+          incomp.missingOutputs.forEach((outputName) => {
+            if (currentOutputSchema.properties[outputName]) {
+              mergedOutputProps[outputName] =
+                currentOutputSchema.properties[outputName];
+            }
+          });
+        }
+
+        data.inputSchema = {
+          ...newInputSchema,
+          properties: mergedInputProps,
+        };
+        data.outputSchema = {
+          ...newOutputSchema,
+          properties: mergedOutputProps,
+        };
+      } else {
+        data.inputSchema = currentInputSchema;
+        data.outputSchema = currentOutputSchema;
+      }
+    }
+
+    const setHardcodedValues = useCallback(
+      (values: any) => {
+        updateNodeData(id, { hardcodedValues: values });
+      },
+      [id, updateNodeData],
+    );
+
+    // Sub-agent update detection
+    const isAgentBlock = data.uiType === BlockUIType.AGENT;
+    const graphId = isAgentBlock ? data.hardcodedValues?.graph_id : undefined;
+    const graphVersion = isAgentBlock
+      ? data.hardcodedValues?.graph_version
+      : undefined;
+
+    const subAgentUpdate = useSubAgentUpdate(
+      id,
+      graphId,
+      graphVersion,
+      isAgentBlock
+        ? (data.hardcodedValues?.input_schema as GraphInputSchema)
+        : undefined,
+      isAgentBlock
+        ? (data.hardcodedValues?.output_schema as GraphOutputSchema)
+        : undefined,
+      data.connections,
+      availableFlows,
+    );
+
+    const [showIncompatibilityDialog, setShowIncompatibilityDialog] =
+      useState(false);
+
+    // Helper to check if a handle is broken (for resolution mode)
+    const isInputHandleBroken = useCallback(
+      (handleName: string): boolean => {
+        if (!isInResolutionMode || !resolutionMode.incompatibilities) {
+          return false;
+        }
+        const incomp = resolutionMode.incompatibilities;
+        return (
+          incomp.missingInputs.includes(handleName) ||
+          incomp.inputTypeMismatches.some((m) => m.name === handleName)
+        );
+      },
+      [isInResolutionMode, resolutionMode.incompatibilities],
+    );
+
+    const isOutputHandleBroken = useCallback(
+      (handleName: string): boolean => {
+        if (!isInResolutionMode || !resolutionMode.incompatibilities) {
+          return false;
+        }
+        return resolutionMode.incompatibilities.missingOutputs.includes(
+          handleName,
+        );
+      },
+      [isInResolutionMode, resolutionMode.incompatibilities],
+    );
+
+    // Handle update button click
+    const handleUpdateClick = useCallback(() => {
+      if (!subAgentUpdate.latestGraph) return;
+
+      if (subAgentUpdate.isCompatible) {
+        // Compatible update - directly apply
+        const updatedValues = createUpdatedAgentNodeInputs(
+          data.hardcodedValues,
+          subAgentUpdate.latestGraph,
+        );
+        setHardcodedValues(updatedValues);
+        toast({
+          title: "Agent updated",
+          description: `Updated to version ${subAgentUpdate.latestVersion}`,
+        });
+      } else {
+        // Incompatible update - show dialog
+        setShowIncompatibilityDialog(true);
+      }
+    }, [subAgentUpdate, data.hardcodedValues, setHardcodedValues]);
+
+    // Handle confirm incompatible update
+    const handleConfirmIncompatibleUpdate = useCallback(() => {
+      if (!subAgentUpdate.latestGraph || !subAgentUpdate.incompatibilities) {
+        return;
+      }
+
+      // Create the updated values but DON'T apply them yet
+      const updatedValues = createUpdatedAgentNodeInputs(
+        data.hardcodedValues,
+        subAgentUpdate.latestGraph,
+      );
+
+      // Get broken edge IDs
+      const brokenEdgeIds = getBrokenEdgeIDs(
+        data.connections,
+        subAgentUpdate.incompatibilities,
+        id,
+      );
+
+      // Enter resolution mode with pending update (don't apply schema yet)
+      enterResolutionMode(
+        id,
+        subAgentUpdate.incompatibilities,
+        brokenEdgeIds,
+        updatedValues,
+      );
+
+      setShowIncompatibilityDialog(false);
+    }, [
+      subAgentUpdate,
+      data.hardcodedValues,
+      data.connections,
+      id,
+      enterResolutionMode,
+    ]);
 
     useEffect(() => {
       if (data.executionResults || data.status) {
@@ -156,13 +344,6 @@ export const CustomNode = React.memo(
       setIsAnyModalOpen?.(isModalOpen || isOutputModalOpen);
     }, [isModalOpen, isOutputModalOpen, data, setIsAnyModalOpen]);
 
-    const setHardcodedValues = useCallback(
-      (values: any) => {
-        updateNodeData(id, { hardcodedValues: values });
-      },
-      [id, updateNodeData],
-    );
-
     const handleTitleEdit = useCallback(() => {
       setIsEditingTitle(true);
       setTimeout(() => {
@@ -255,6 +436,7 @@ export const CustomNode = React.memo(
                 isConnected={isOutputHandleConnected(propKey)}
                 schema={fieldSchema}
                 side="right"
+                isBroken={isOutputHandleBroken(propKey)}
               />
               {"properties" in fieldSchema &&
                 renderHandles(
@@ -385,6 +567,7 @@ export const CustomNode = React.memo(
                       isRequired={isRequired}
                       schema={propSchema}
                       side="left"
+                      isBroken={isInputHandleBroken(propKey)}
                     />
                   ) : (
                     propKey !== "credentials" &&
@@ -873,6 +1056,22 @@ export const CustomNode = React.memo(
           <ContextMenuContent />
         </div>
 
+        {/* Sub-agent Update Bar - shown below header */}
+        {isAgentBlock && (subAgentUpdate.hasUpdate || isInResolutionMode) && (
+          <SubAgentUpdateBar
+            currentVersion={subAgentUpdate.currentVersion}
+            latestVersion={subAgentUpdate.latestVersion}
+            isCompatible={subAgentUpdate.isCompatible}
+            incompatibilities={
+              isInResolutionMode
+                ? resolutionMode.incompatibilities
+                : subAgentUpdate.incompatibilities
+            }
+            onUpdate={handleUpdateClick}
+            isInResolutionMode={isInResolutionMode}
+          />
+        )}
+
         {/* Body */}
         <div className="mx-5 my-6 rounded-b-xl">
           {/* Input Handles */}
@@ -1044,9 +1243,24 @@ export const CustomNode = React.memo(
     );
 
     return (
-      <ContextMenu.Root>
-        <ContextMenu.Trigger>{nodeContent()}</ContextMenu.Trigger>
-      </ContextMenu.Root>
+      <>
+        <ContextMenu.Root>
+          <ContextMenu.Trigger>{nodeContent()}</ContextMenu.Trigger>
+        </ContextMenu.Root>
+
+        {/* Incompatibility Dialog for sub-agent updates */}
+        {isAgentBlock && subAgentUpdate.incompatibilities && (
+          <IncompatibilityDialog
+            isOpen={showIncompatibilityDialog}
+            onClose={() => setShowIncompatibilityDialog(false)}
+            onConfirm={handleConfirmIncompatibleUpdate}
+            currentVersion={subAgentUpdate.currentVersion}
+            latestVersion={subAgentUpdate.latestVersion}
+            agentName={data.blockType || "Agent"}
+            incompatibilities={subAgentUpdate.incompatibilities}
+          />
+        )}
+      </>
     );
   },
   (prevProps, nextProps) => {
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/CustomNode/IncompatibilityDialog.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/CustomNode/IncompatibilityDialog.tsx
new file mode 100644
index 0000000000..951fe2eab5
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/CustomNode/IncompatibilityDialog.tsx
@@ -0,0 +1,244 @@
+import React from "react";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/components/__legacy__/ui/dialog";
+import { Button } from "@/components/__legacy__/ui/button";
+import { AlertTriangle, XCircle, PlusCircle } from "lucide-react";
+import { IncompatibilityInfo } from "../../../hooks/useSubAgentUpdate/types";
+import { beautifyString } from "@/lib/utils";
+import { Alert, AlertDescription } from "@/components/molecules/Alert/Alert";
+
+interface IncompatibilityDialogProps {
+  isOpen: boolean;
+  onClose: () => void;
+  onConfirm: () => void;
+  currentVersion: number;
+  latestVersion: number;
+  agentName: string;
+  incompatibilities: IncompatibilityInfo;
+}
+
+export const IncompatibilityDialog: React.FC<IncompatibilityDialogProps> = ({
+  isOpen,
+  onClose,
+  onConfirm,
+  currentVersion,
+  latestVersion,
+  agentName,
+  incompatibilities,
+}) => {
+  const hasMissingInputs = incompatibilities.missingInputs.length > 0;
+  const hasMissingOutputs = incompatibilities.missingOutputs.length > 0;
+  const hasNewInputs = incompatibilities.newInputs.length > 0;
+  const hasNewOutputs = incompatibilities.newOutputs.length > 0;
+  const hasNewRequired = incompatibilities.newRequiredInputs.length > 0;
+  const hasTypeMismatches = incompatibilities.inputTypeMismatches.length > 0;
+
+  const hasInputChanges = hasMissingInputs || hasNewInputs;
+  const hasOutputChanges = hasMissingOutputs || hasNewOutputs;
+
+  return (
+    <Dialog open={isOpen} onOpenChange={(open) => !open && onClose()}>
+      <DialogContent className="max-w-lg">
+        <DialogHeader>
+          <DialogTitle className="flex items-center gap-2">
+            <AlertTriangle className="h-5 w-5 text-amber-500" />
+            Incompatible Update
+          </DialogTitle>
+          <DialogDescription>
+            Updating <strong>{beautifyString(agentName)}</strong> from v
+            {currentVersion} to v{latestVersion} will break some connections.
+          </DialogDescription>
+        </DialogHeader>
+
+        <div className="space-y-4 py-2">
+          {/* Input changes - two column layout */}
+          {hasInputChanges && (
+            <TwoColumnSection
+              title="Input Changes"
+              leftIcon={<XCircle className="h-4 w-4 text-red-500" />}
+              leftTitle="Removed"
+              leftItems={incompatibilities.missingInputs}
+              rightIcon={<PlusCircle className="h-4 w-4 text-green-500" />}
+              rightTitle="Added"
+              rightItems={incompatibilities.newInputs}
+            />
+          )}
+
+          {/* Output changes - two column layout */}
+          {hasOutputChanges && (
+            <TwoColumnSection
+              title="Output Changes"
+              leftIcon={<XCircle className="h-4 w-4 text-red-500" />}
+              leftTitle="Removed"
+              leftItems={incompatibilities.missingOutputs}
+              rightIcon={<PlusCircle className="h-4 w-4 text-green-500" />}
+              rightTitle="Added"
+              rightItems={incompatibilities.newOutputs}
+            />
+          )}
+
+          {hasTypeMismatches && (
+            <SingleColumnSection
+              icon={<XCircle className="h-4 w-4 text-red-500" />}
+              title="Type Changed"
+              description="These connected inputs have a different type:"
+              items={incompatibilities.inputTypeMismatches.map(
+                (m) => `${m.name} (${m.oldType} → ${m.newType})`,
+              )}
+            />
+          )}
+
+          {hasNewRequired && (
+            <SingleColumnSection
+              icon={<PlusCircle className="h-4 w-4 text-amber-500" />}
+              title="New Required Inputs"
+              description="These inputs are now required:"
+              items={incompatibilities.newRequiredInputs}
+            />
+          )}
+        </div>
+
+        <Alert variant="warning">
+          <AlertDescription>
+            If you proceed, you&apos;ll need to remove the broken connections
+            before you can save or run your agent.
+          </AlertDescription>
+        </Alert>
+
+        <DialogFooter className="gap-2 sm:gap-0">
+          <Button variant="outline" onClick={onClose}>
+            Cancel
+          </Button>
+          <Button
+            variant="destructive"
+            onClick={onConfirm}
+            className="bg-amber-600 hover:bg-amber-700"
+          >
+            Update Anyway
+          </Button>
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  );
+};
+
+interface TwoColumnSectionProps {
+  title: string;
+  leftIcon: React.ReactNode;
+  leftTitle: string;
+  leftItems: string[];
+  rightIcon: React.ReactNode;
+  rightTitle: string;
+  rightItems: string[];
+}
+
+const TwoColumnSection: React.FC<TwoColumnSectionProps> = ({
+  title,
+  leftIcon,
+  leftTitle,
+  leftItems,
+  rightIcon,
+  rightTitle,
+  rightItems,
+}) => (
+  <div className="rounded-md border border-gray-200 p-3 dark:border-gray-700">
+    <span className="font-medium">{title}</span>
+    <div className="mt-2 grid grid-cols-2 items-start gap-4">
+      {/* Left column - Breaking changes */}
+      <div className="min-w-0">
+        <div className="flex items-center gap-1.5 text-sm text-gray-500 dark:text-gray-400">
+          {leftIcon}
+          <span>{leftTitle}</span>
+        </div>
+        <ul className="mt-1.5 space-y-1">
+          {leftItems.length > 0 ? (
+            leftItems.map((item) => (
+              <li
+                key={item}
+                className="text-sm text-gray-700 dark:text-gray-300"
+              >
+                <code className="rounded bg-red-50 px-1 py-0.5 font-mono text-xs text-red-700 dark:bg-red-900/30 dark:text-red-300">
+                  {item}
+                </code>
+              </li>
+            ))
+          ) : (
+            <li className="text-sm italic text-gray-400 dark:text-gray-500">
+              None
+            </li>
+          )}
+        </ul>
+      </div>
+
+      {/* Right column - Possible solutions */}
+      <div className="min-w-0">
+        <div className="flex items-center gap-1.5 text-sm text-gray-500 dark:text-gray-400">
+          {rightIcon}
+          <span>{rightTitle}</span>
+        </div>
+        <ul className="mt-1.5 space-y-1">
+          {rightItems.length > 0 ? (
+            rightItems.map((item) => (
+              <li
+                key={item}
+                className="text-sm text-gray-700 dark:text-gray-300"
+              >
+                <code className="rounded bg-green-50 px-1 py-0.5 font-mono text-xs text-green-700 dark:bg-green-900/30 dark:text-green-300">
+                  {item}
+                </code>
+              </li>
+            ))
+          ) : (
+            <li className="text-sm italic text-gray-400 dark:text-gray-500">
+              None
+            </li>
+          )}
+        </ul>
+      </div>
+    </div>
+  </div>
+);
+
+interface SingleColumnSectionProps {
+  icon: React.ReactNode;
+  title: string;
+  description: string;
+  items: string[];
+}
+
+const SingleColumnSection: React.FC<SingleColumnSectionProps> = ({
+  icon,
+  title,
+  description,
+  items,
+}) => (
+  <div className="rounded-md border border-gray-200 p-3 dark:border-gray-700">
+    <div className="flex items-center gap-2">
+      {icon}
+      <span className="font-medium">{title}</span>
+    </div>
+    <p className="mt-1 text-sm text-gray-500 dark:text-gray-400">
+      {description}
+    </p>
+    <ul className="mt-2 space-y-1">
+      {items.map((item) => (
+        <li
+          key={item}
+          className="ml-4 list-disc text-sm text-gray-700 dark:text-gray-300"
+        >
+          <code className="rounded bg-gray-100 px-1 py-0.5 font-mono text-xs dark:bg-gray-800">
+            {item}
+          </code>
+        </li>
+      ))}
+    </ul>
+  </div>
+);
+
+export default IncompatibilityDialog;
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/CustomNode/SubAgentUpdateBar.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/CustomNode/SubAgentUpdateBar.tsx
new file mode 100644
index 0000000000..5f421d90d8
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/CustomNode/SubAgentUpdateBar.tsx
@@ -0,0 +1,130 @@
+import React from "react";
+import { Button } from "@/components/__legacy__/ui/button";
+import { ArrowUp, AlertTriangle, Info } from "lucide-react";
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipTrigger,
+} from "@/components/atoms/Tooltip/BaseTooltip";
+import { IncompatibilityInfo } from "../../../hooks/useSubAgentUpdate/types";
+import { cn } from "@/lib/utils";
+
+interface SubAgentUpdateBarProps {
+  currentVersion: number;
+  latestVersion: number;
+  isCompatible: boolean;
+  incompatibilities: IncompatibilityInfo | null;
+  onUpdate: () => void;
+  isInResolutionMode?: boolean;
+}
+
+export const SubAgentUpdateBar: React.FC<SubAgentUpdateBarProps> = ({
+  currentVersion,
+  latestVersion,
+  isCompatible,
+  incompatibilities,
+  onUpdate,
+  isInResolutionMode = false,
+}) => {
+  if (isInResolutionMode) {
+    return <ResolutionModeBar incompatibilities={incompatibilities} />;
+  }
+
+  return (
+    <div className="flex items-center justify-between gap-2 rounded-t-lg bg-blue-50 px-3 py-2 dark:bg-blue-900/30">
+      <div className="flex items-center gap-2">
+        <ArrowUp className="h-4 w-4 text-blue-600 dark:text-blue-400" />
+        <span className="text-sm text-blue-700 dark:text-blue-300">
+          Update available (v{currentVersion} → v{latestVersion})
+        </span>
+        {!isCompatible && (
+          <Tooltip>
+            <TooltipTrigger asChild>
+              <AlertTriangle className="h-4 w-4 text-amber-500" />
+            </TooltipTrigger>
+            <TooltipContent className="max-w-xs">
+              <p className="font-medium">Incompatible changes detected</p>
+              <p className="text-xs text-gray-400">
+                Click Update to see details
+              </p>
+            </TooltipContent>
+          </Tooltip>
+        )}
+      </div>
+      <Button
+        size="sm"
+        variant={isCompatible ? "default" : "outline"}
+        onClick={onUpdate}
+        className={cn(
+          "h-7 text-xs",
+          !isCompatible && "border-amber-500 text-amber-600 hover:bg-amber-50",
+        )}
+      >
+        Update
+      </Button>
+    </div>
+  );
+};
+
+interface ResolutionModeBarProps {
+  incompatibilities: IncompatibilityInfo | null;
+}
+
+const ResolutionModeBar: React.FC<ResolutionModeBarProps> = ({
+  incompatibilities,
+}) => {
+  const formatIncompatibilities = () => {
+    if (!incompatibilities) return "No incompatibilities";
+
+    const items: string[] = [];
+
+    if (incompatibilities.missingInputs.length > 0) {
+      items.push(
+        `Missing inputs: ${incompatibilities.missingInputs.join(", ")}`,
+      );
+    }
+    if (incompatibilities.missingOutputs.length > 0) {
+      items.push(
+        `Missing outputs: ${incompatibilities.missingOutputs.join(", ")}`,
+      );
+    }
+    if (incompatibilities.newRequiredInputs.length > 0) {
+      items.push(
+        `New required inputs: ${incompatibilities.newRequiredInputs.join(", ")}`,
+      );
+    }
+    if (incompatibilities.inputTypeMismatches.length > 0) {
+      const mismatches = incompatibilities.inputTypeMismatches
+        .map((m) => `${m.name} (${m.oldType} → ${m.newType})`)
+        .join(", ");
+      items.push(`Type changed: ${mismatches}`);
+    }
+
+    return items.join("\n");
+  };
+
+  return (
+    <div className="flex items-center justify-between gap-2 rounded-t-lg bg-amber-50 px-3 py-2 dark:bg-amber-900/30">
+      <div className="flex items-center gap-2">
+        <AlertTriangle className="h-4 w-4 text-amber-600 dark:text-amber-400" />
+        <span className="text-sm text-amber-700 dark:text-amber-300">
+          Remove incompatible connections
+        </span>
+        <Tooltip>
+          <TooltipTrigger asChild>
+            <Info className="h-4 w-4 cursor-help text-amber-500" />
+          </TooltipTrigger>
+          <TooltipContent className="max-w-sm whitespace-pre-line">
+            <p className="font-medium">Incompatible changes:</p>
+            <p className="mt-1 text-xs">{formatIncompatibilities()}</p>
+            <p className="mt-2 text-xs text-gray-400">
+              Delete the red connections to continue
+            </p>
+          </TooltipContent>
+        </Tooltip>
+      </div>
+    </div>
+  );
+};
+
+export default SubAgentUpdateBar;
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/ExpandableOutputDialog.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/ExpandableOutputDialog.tsx
index 0050c6cf64..1ccb3d1261 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/ExpandableOutputDialog.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/ExpandableOutputDialog.tsx
@@ -1,22 +1,15 @@
-import type { OutputMetadata } from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/OutputRenderers";
+import type { OutputMetadata } from "@/components/contextual/OutputRenderers";
 import {
   globalRegistry,
   OutputActions,
   OutputItem,
-} from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/OutputRenderers";
+} from "@/components/contextual/OutputRenderers";
+import { Dialog } from "@/components/molecules/Dialog/Dialog";
 import { beautifyString } from "@/lib/utils";
 import { Flag, useGetFlag } from "@/services/feature-flags/use-get-flag";
 import { Clipboard, Maximize2 } from "lucide-react";
 import React, { FC, useMemo, useState } from "react";
 import { Button } from "../../../../../components/__legacy__/ui/button";
-import {
-  Dialog,
-  DialogContent,
-  DialogDescription,
-  DialogFooter,
-  DialogHeader,
-  DialogTitle,
-} from "../../../../../components/__legacy__/ui/dialog";
 import { ContentRenderer } from "../../../../../components/__legacy__/ui/render";
 import { ScrollArea } from "../../../../../components/__legacy__/ui/scroll-area";
 import { Separator } from "../../../../../components/__legacy__/ui/separator";
@@ -120,138 +113,155 @@ const ExpandableOutputDialog: FC<ExpandableOutputDialogProps> = ({
   };
 
   return (
-    <Dialog open={isOpen} onOpenChange={onClose}>
-      <DialogContent className="flex h-[90vh] w-[90vw] max-w-4xl flex-col">
-        <DialogHeader>
-          <DialogTitle className="flex items-center justify-between pr-8">
-            <div className="flex items-center gap-2">
-              <Maximize2 size={20} />
-              Full Output Preview
-            </div>
-            {enableEnhancedOutputHandling && (
-              <div className="flex items-center gap-3">
-                <label
-                  htmlFor="enhanced-rendering-toggle"
-                  className="cursor-pointer select-none text-sm font-normal text-gray-600"
-                >
-                  Enhanced Rendering
-                </label>
-                <Switch
-                  id="enhanced-rendering-toggle"
-                  checked={useEnhancedRenderer}
-                  onCheckedChange={setUseEnhancedRenderer}
-                />
-              </div>
-            )}
-          </DialogTitle>
-          <DialogDescription>
-            Execution ID: <span className="font-mono text-xs">{execId}</span>
-            <br />
-            Pin:{" "}
-            <span className="font-semibold">{beautifyString(pinName)}</span>
-          </DialogDescription>
-        </DialogHeader>
-
-        <div className="flex-1 overflow-hidden">
-          {useEnhancedRenderer && outputItems.length > 0 && (
-            <div className="border-b px-4 py-2">
-              <OutputActions
-                items={outputItems.map((item) => ({
-                  value: item.value,
-                  metadata: item.metadata,
-                  renderer: item.renderer,
-                }))}
+    <Dialog
+      title={
+        <div className="flex items-center justify-between pr-8">
+          <div className="flex items-center gap-2">
+            <Maximize2 size={20} />
+            Full Output Preview
+          </div>
+          {enableEnhancedOutputHandling && (
+            <div className="flex items-center gap-3">
+              <label
+                htmlFor="enhanced-rendering-toggle"
+                className="cursor-pointer select-none text-sm font-normal text-gray-600"
+              >
+                Enhanced Rendering
+              </label>
+              <Switch
+                id="enhanced-rendering-toggle"
+                checked={useEnhancedRenderer}
+                onCheckedChange={setUseEnhancedRenderer}
               />
             </div>
           )}
-          <ScrollArea className="h-full">
-            <div className="p-4">
-              {data.length > 0 ? (
-                useEnhancedRenderer ? (
-                  <div className="space-y-4">
-                    {outputItems.map((item) => (
-                      <OutputItem
-                        key={item.key}
-                        value={item.value}
-                        metadata={item.metadata}
-                        renderer={item.renderer}
-                        label={item.label}
-                      />
-                    ))}
-                  </div>
-                ) : (
-                  <div className="space-y-4">
-                    {data.map((item, index) => (
-                      <div
-                        key={index}
-                        className="rounded-lg border bg-gray-50 p-4"
-                      >
-                        <div className="mb-2 flex items-center justify-between">
-                          <span className="text-sm font-medium text-gray-600">
-                            Item {index + 1} of {data.length}
-                          </span>
-                          <Button
-                            variant="outline"
-                            size="sm"
-                            onClick={() => {
-                              const itemData =
-                                typeof item === "object"
-                                  ? JSON.stringify(item, null, 2)
-                                  : String(item);
-                              navigator.clipboard
-                                .writeText(itemData)
-                                .then(() => {
-                                  toast({
-                                    title: `Item ${index + 1} copied to clipboard!`,
-                                    duration: 2000,
-                                  });
-                                });
-                            }}
-                            className="flex items-center gap-1"
-                          >
-                            <Clipboard size={14} />
-                            Copy Item
-                          </Button>
-                        </div>
-                        <Separator className="mb-3" />
-                        <div className="whitespace-pre-wrap break-words font-mono text-sm">
-                          <ContentRenderer
-                            value={item}
-                            truncateLongData={false}
-                          />
-                        </div>
-                      </div>
-                    ))}
-                  </div>
-                )
-              ) : (
-                <div className="py-8 text-center text-gray-500">
-                  No data available
-                </div>
-              )}
-            </div>
-          </ScrollArea>
         </div>
+      }
+      controlled={{
+        isOpen,
+        set: (open) => {
+          if (!open) onClose();
+        },
+      }}
+      onClose={onClose}
+      styling={{
+        maxWidth: "56rem",
+        width: "90vw",
+        height: "90vh",
+      }}
+    >
+      <Dialog.Content>
+        <div className="flex h-full flex-col">
+          <div className="pb-4">
+            <p className="text-sm text-zinc-600">
+              Execution ID: <span className="font-mono text-xs">{execId}</span>
+              <br />
+              Pin:{" "}
+              <span className="font-semibold">{beautifyString(pinName)}</span>
+            </p>
+          </div>
 
-        <DialogFooter className="flex justify-between">
-          <div className="text-sm text-gray-600">
-            {data.length} item{data.length !== 1 ? "s" : ""} total
-          </div>
-          <div className="flex gap-2">
-            {!useEnhancedRenderer && (
-              <Button
-                variant="outline"
-                onClick={copyData}
-                className="flex items-center gap-1"
-              >
-                <Clipboard size={16} />
-                Copy All
-              </Button>
+          <div className="flex flex-1 flex-col overflow-hidden">
+            {useEnhancedRenderer && outputItems.length > 0 && (
+              <div className="border-b px-4 py-2">
+                <OutputActions
+                  items={outputItems.map((item) => ({
+                    value: item.value,
+                    metadata: item.metadata,
+                    renderer: item.renderer,
+                  }))}
+                />
+              </div>
             )}
-            <Button onClick={onClose}>Close</Button>
+            <ScrollArea className="h-full">
+              <div className="p-4">
+                {data.length > 0 ? (
+                  useEnhancedRenderer ? (
+                    <div className="space-y-4">
+                      {outputItems.map((item) => (
+                        <OutputItem
+                          key={item.key}
+                          value={item.value}
+                          metadata={item.metadata}
+                          renderer={item.renderer}
+                          label={item.label}
+                        />
+                      ))}
+                    </div>
+                  ) : (
+                    <div className="space-y-4">
+                      {data.map((item, index) => (
+                        <div
+                          key={index}
+                          className="rounded-lg border bg-gray-50 p-4"
+                        >
+                          <div className="mb-2 flex items-center justify-between">
+                            <span className="text-sm font-medium text-gray-600">
+                              Item {index + 1} of {data.length}
+                            </span>
+                            <Button
+                              variant="outline"
+                              size="sm"
+                              onClick={() => {
+                                const itemData =
+                                  typeof item === "object"
+                                    ? JSON.stringify(item, null, 2)
+                                    : String(item);
+                                navigator.clipboard
+                                  .writeText(itemData)
+                                  .then(() => {
+                                    toast({
+                                      title: `Item ${index + 1} copied to clipboard!`,
+                                      duration: 2000,
+                                    });
+                                  });
+                              }}
+                              className="flex items-center gap-1"
+                            >
+                              <Clipboard size={14} />
+                              Copy Item
+                            </Button>
+                          </div>
+                          <Separator className="mb-3" />
+                          <div className="whitespace-pre-wrap break-words font-mono text-sm">
+                            <ContentRenderer
+                              value={item}
+                              truncateLongData={false}
+                            />
+                          </div>
+                        </div>
+                      ))}
+                    </div>
+                  )
+                ) : (
+                  <div className="py-8 text-center text-gray-500">
+                    No data available
+                  </div>
+                )}
+              </div>
+            </ScrollArea>
           </div>
-        </DialogFooter>
-      </DialogContent>
+
+          <Dialog.Footer className="flex justify-between">
+            <div className="text-sm text-gray-600">
+              {data.length} item{data.length !== 1 ? "s" : ""} total
+            </div>
+            <div className="flex gap-2">
+              {!useEnhancedRenderer && (
+                <Button
+                  variant="outline"
+                  onClick={copyData}
+                  className="flex items-center gap-1"
+                >
+                  <Clipboard size={16} />
+                  Copy All
+                </Button>
+              )}
+              <Button onClick={onClose}>Close</Button>
+            </div>
+          </Dialog.Footer>
+        </div>
+      </Dialog.Content>
     </Dialog>
   );
 };
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/Flow/Flow.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/Flow/Flow.tsx
index 80a6fb022d..a54a9ef386 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/Flow/Flow.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/Flow/Flow.tsx
@@ -26,15 +26,17 @@ import {
   applyNodeChanges,
 } from "@xyflow/react";
 import "@xyflow/react/dist/style.css";
-import { CustomNode } from "../CustomNode/CustomNode";
+import { ConnectedEdge, CustomNode } from "../CustomNode/CustomNode";
 import "./flow.css";
 import {
   BlockUIType,
   formatEdgeID,
   GraphExecutionID,
   GraphID,
+  GraphMeta,
   LibraryAgent,
 } from "@/lib/autogpt-server-api";
+import { IncompatibilityInfo } from "../../../hooks/useSubAgentUpdate/types";
 import { Key, storage } from "@/services/storage/local-storage";
 import { findNewlyAddedBlockCoordinates, getTypeColor } from "@/lib/utils";
 import { history } from "../history";
@@ -72,12 +74,30 @@ import { FloatingSafeModeToggle } from "../../FloatingSafeModeToogle";
 // It helps to prevent spamming the history with small movements especially when pressing on a input in a block
 const MINIMUM_MOVE_BEFORE_LOG = 50;
 
+export type ResolutionModeState = {
+  active: boolean;
+  nodeId: string | null;
+  incompatibilities: IncompatibilityInfo | null;
+  brokenEdgeIds: string[];
+  pendingUpdate: Record<string, unknown> | null; // The hardcoded values to apply after resolution
+};
+
 type BuilderContextType = {
   libraryAgent: LibraryAgent | null;
   visualizeBeads: "no" | "static" | "animate";
   setIsAnyModalOpen: (isOpen: boolean) => void;
   getNextNodeId: () => string;
   getNodeTitle: (nodeID: string) => string | null;
+  availableFlows: GraphMeta[];
+  resolutionMode: ResolutionModeState;
+  enterResolutionMode: (
+    nodeId: string,
+    incompatibilities: IncompatibilityInfo,
+    brokenEdgeIds: string[],
+    pendingUpdate: Record<string, unknown>,
+  ) => void;
+  exitResolutionMode: () => void;
+  applyPendingUpdate: () => void;
 };
 
 export type NodeDimension = {
@@ -172,6 +192,92 @@ const FlowEditor: React.FC<{
   // It stores the dimension of all nodes with position as well
   const [nodeDimensions, setNodeDimensions] = useState<NodeDimension>({});
 
+  // Resolution mode state for sub-agent incompatible updates
+  const [resolutionMode, setResolutionMode] = useState<ResolutionModeState>({
+    active: false,
+    nodeId: null,
+    incompatibilities: null,
+    brokenEdgeIds: [],
+    pendingUpdate: null,
+  });
+
+  const enterResolutionMode = useCallback(
+    (
+      nodeId: string,
+      incompatibilities: IncompatibilityInfo,
+      brokenEdgeIds: string[],
+      pendingUpdate: Record<string, unknown>,
+    ) => {
+      setResolutionMode({
+        active: true,
+        nodeId,
+        incompatibilities,
+        brokenEdgeIds,
+        pendingUpdate,
+      });
+    },
+    [],
+  );
+
+  const exitResolutionMode = useCallback(() => {
+    setResolutionMode({
+      active: false,
+      nodeId: null,
+      incompatibilities: null,
+      brokenEdgeIds: [],
+      pendingUpdate: null,
+    });
+  }, []);
+
+  // Apply pending update after resolution mode completes
+  const applyPendingUpdate = useCallback(() => {
+    if (!resolutionMode.nodeId || !resolutionMode.pendingUpdate) return;
+
+    const node = nodes.find((n) => n.id === resolutionMode.nodeId);
+    if (node) {
+      const pendingUpdate = resolutionMode.pendingUpdate as {
+        [key: string]: any;
+      };
+      setNodes((nds) =>
+        nds.map((n) =>
+          n.id === resolutionMode.nodeId
+            ? { ...n, data: { ...n.data, hardcodedValues: pendingUpdate } }
+            : n,
+        ),
+      );
+    }
+    exitResolutionMode();
+    toast({
+      title: "Update complete",
+      description: "Agent has been updated to the new version.",
+    });
+  }, [resolutionMode, nodes, setNodes, exitResolutionMode, toast]);
+
+  // Check if all broken edges have been removed and auto-apply pending update
+  useEffect(() => {
+    if (!resolutionMode.active || resolutionMode.brokenEdgeIds.length === 0) {
+      return;
+    }
+
+    const currentEdgeIds = new Set(edges.map((e) => e.id));
+    const remainingBrokenEdges = resolutionMode.brokenEdgeIds.filter((id) =>
+      currentEdgeIds.has(id),
+    );
+
+    if (remainingBrokenEdges.length === 0) {
+      // All broken edges have been removed, apply pending update
+      applyPendingUpdate();
+    } else if (
+      remainingBrokenEdges.length !== resolutionMode.brokenEdgeIds.length
+    ) {
+      // Update the list of broken edges
+      setResolutionMode((prev) => ({
+        ...prev,
+        brokenEdgeIds: remainingBrokenEdges,
+      }));
+    }
+  }, [edges, resolutionMode, applyPendingUpdate]);
+
   // Set page title with or without graph name
   useEffect(() => {
     document.title = savedAgent
@@ -431,17 +537,19 @@ const FlowEditor: React.FC<{
                 ...node.data.connections.filter(
                   (conn) =>
                     !removedEdges.some(
-                      (removedEdge) => removedEdge.id === conn.edge_id,
+                      (removedEdge) => removedEdge.id === conn.id,
                     ),
                 ),
                 // Add node connections for added edges
-                ...addedEdges.map((addedEdge) => ({
-                  edge_id: addedEdge.item.id,
-                  source: addedEdge.item.source,
-                  target: addedEdge.item.target,
-                  sourceHandle: addedEdge.item.sourceHandle!,
-                  targetHandle: addedEdge.item.targetHandle!,
-                })),
+                ...addedEdges.map(
+                  (addedEdge): ConnectedEdge => ({
+                    id: addedEdge.item.id,
+                    source: addedEdge.item.source,
+                    target: addedEdge.item.target,
+                    sourceHandle: addedEdge.item.sourceHandle!,
+                    targetHandle: addedEdge.item.targetHandle!,
+                  }),
+                ),
               ],
             },
           }));
@@ -467,13 +575,15 @@ const FlowEditor: React.FC<{
             data: {
               ...node.data,
               connections: [
-                ...replaceEdges.map((replaceEdge) => ({
-                  edge_id: replaceEdge.item.id,
-                  source: replaceEdge.item.source,
-                  target: replaceEdge.item.target,
-                  sourceHandle: replaceEdge.item.sourceHandle!,
-                  targetHandle: replaceEdge.item.targetHandle!,
-                })),
+                ...replaceEdges.map(
+                  (replaceEdge): ConnectedEdge => ({
+                    id: replaceEdge.item.id,
+                    source: replaceEdge.item.source,
+                    target: replaceEdge.item.target,
+                    sourceHandle: replaceEdge.item.sourceHandle!,
+                    targetHandle: replaceEdge.item.targetHandle!,
+                  }),
+                ),
               ],
             },
           })),
@@ -890,8 +1000,23 @@ const FlowEditor: React.FC<{
       setIsAnyModalOpen,
       getNextNodeId,
       getNodeTitle,
+      availableFlows,
+      resolutionMode,
+      enterResolutionMode,
+      exitResolutionMode,
+      applyPendingUpdate,
     }),
-    [libraryAgent, visualizeBeads, getNextNodeId, getNodeTitle],
+    [
+      libraryAgent,
+      visualizeBeads,
+      getNextNodeId,
+      getNodeTitle,
+      availableFlows,
+      resolutionMode,
+      enterResolutionMode,
+      applyPendingUpdate,
+      exitResolutionMode,
+    ],
   );
 
   return (
@@ -991,6 +1116,7 @@ const FlowEditor: React.FC<{
               onClickScheduleButton={handleScheduleButton}
               isDisabled={!savedAgent}
               isRunning={isRunning}
+              resolutionModeActive={resolutionMode.active}
             />
           ) : (
             <Alert className="absolute bottom-4 left-1/2 z-20 w-auto -translate-x-1/2 select-none">
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/NodeHandle.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/NodeHandle.tsx
index 1377df62a0..932e50c499 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/NodeHandle.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/NodeHandle.tsx
@@ -1,6 +1,11 @@
 import { BlockIOSubSchema } from "@/lib/autogpt-server-api/types";
-import { cn } from "@/lib/utils";
-import { beautifyString, getTypeBgColor, getTypeTextColor } from "@/lib/utils";
+import {
+  cn,
+  beautifyString,
+  getTypeBgColor,
+  getTypeTextColor,
+  getEffectiveType,
+} from "@/lib/utils";
 import { FC, memo, useCallback } from "react";
 import { Handle, Position } from "@xyflow/react";
 import { InformationTooltip } from "@/components/molecules/InformationTooltip/InformationTooltip";
@@ -13,6 +18,7 @@ type HandleProps = {
   side: "left" | "right";
   title?: string;
   className?: string;
+  isBroken?: boolean;
 };
 
 // Move the constant out of the component to avoid re-creation on every render.
@@ -27,18 +33,23 @@ const TYPE_NAME: Record<string, string> = {
 };
 
 // Extract and memoize the Dot component so that it doesn't re-render unnecessarily.
-const Dot: FC<{ isConnected: boolean; type?: string }> = memo(
-  ({ isConnected, type }) => {
-    const color = isConnected
-      ? getTypeBgColor(type || "any")
-      : "border-gray-300 dark:border-gray-600";
+const Dot: FC<{ isConnected: boolean; type?: string; isBroken?: boolean }> =
+  memo(({ isConnected, type, isBroken }) => {
+    const color = isBroken
+      ? "border-red-500 bg-red-100 dark:bg-red-900/30"
+      : isConnected
+        ? getTypeBgColor(type || "any")
+        : "border-gray-300 dark:border-gray-600";
     return (
       <div
-        className={`${color} m-1 h-4 w-4 rounded-full border-2 bg-white transition-colors duration-100 group-hover:bg-gray-300 dark:bg-slate-800 dark:group-hover:bg-gray-700`}
+        className={cn(
+          "m-1 h-4 w-4 rounded-full border-2 bg-white transition-colors duration-100 group-hover:bg-gray-300 dark:bg-slate-800 dark:group-hover:bg-gray-700",
+          color,
+          isBroken && "opacity-50",
+        )}
       />
     );
-  },
-);
+  });
 Dot.displayName = "Dot";
 
 const NodeHandle: FC<HandleProps> = ({
@@ -49,24 +60,34 @@ const NodeHandle: FC<HandleProps> = ({
   side,
   title,
   className,
+  isBroken = false,
 }) => {
-  const typeClass = `text-sm ${getTypeTextColor(schema.type || "any")} ${
+  // Extract effective type from schema (handles anyOf/oneOf/allOf wrappers)
+  const effectiveType = getEffectiveType(schema);
+
+  const typeClass = `text-sm ${getTypeTextColor(effectiveType || "any")} ${
     side === "left" ? "text-left" : "text-right"
   }`;
 
   const label = (
-    <div className="flex flex-grow flex-row">
+    <div className={cn("flex flex-grow flex-row", isBroken && "opacity-50")}>
       <span
         className={cn(
           "data-sentry-unmask text-m green flex items-end pr-2 text-gray-900 dark:text-gray-100",
           className,
+          isBroken && "text-red-500 line-through",
         )}
       >
         {title || schema.title || beautifyString(keyName.toLowerCase())}
         {isRequired ? "*" : ""}
       </span>
-      <span className={`${typeClass} data-sentry-unmask flex items-end`}>
-        ({TYPE_NAME[schema.type as keyof typeof TYPE_NAME] || "any"})
+      <span
+        className={cn(
+          `${typeClass} data-sentry-unmask flex items-end`,
+          isBroken && "text-red-400",
+        )}
+      >
+        ({TYPE_NAME[effectiveType as keyof typeof TYPE_NAME] || "any"})
       </span>
     </div>
   );
@@ -84,7 +105,7 @@ const NodeHandle: FC<HandleProps> = ({
     return (
       <div
         key={keyName}
-        className="handle-container"
+        className={cn("handle-container", isBroken && "pointer-events-none")}
         onContextMenu={handleContextMenu}
       >
         <Handle
@@ -92,10 +113,15 @@ const NodeHandle: FC<HandleProps> = ({
           data-testid={`input-handle-${keyName}`}
           position={Position.Left}
           id={keyName}
-          className="group -ml-[38px]"
+          className={cn("group -ml-[38px]", isBroken && "cursor-not-allowed")}
+          isConnectable={!isBroken}
         >
           <div className="pointer-events-none flex items-center">
-            <Dot isConnected={isConnected} type={schema.type} />
+            <Dot
+              isConnected={isConnected}
+              type={effectiveType}
+              isBroken={isBroken}
+            />
             {label}
           </div>
         </Handle>
@@ -106,7 +132,10 @@ const NodeHandle: FC<HandleProps> = ({
     return (
       <div
         key={keyName}
-        className="handle-container justify-end"
+        className={cn(
+          "handle-container justify-end",
+          isBroken && "pointer-events-none",
+        )}
         onContextMenu={handleContextMenu}
       >
         <Handle
@@ -114,11 +143,16 @@ const NodeHandle: FC<HandleProps> = ({
           data-testid={`output-handle-${keyName}`}
           position={Position.Right}
           id={keyName}
-          className="group -mr-[38px]"
+          className={cn("group -mr-[38px]", isBroken && "cursor-not-allowed")}
+          isConnectable={!isBroken}
         >
           <div className="pointer-events-none flex items-center">
             {label}
-            <Dot isConnected={isConnected} type={schema.type} />
+            <Dot
+              isConnected={isConnected}
+              type={effectiveType}
+              isBroken={isBroken}
+            />
           </div>
         </Handle>
       </div>
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/NodeInputs.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/NodeInputs.tsx
index 683a854c21..51fed5bef1 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/NodeInputs.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/NodeInputs.tsx
@@ -1,8 +1,8 @@
 import {
-  ConnectionData,
+  ConnectedEdge,
   CustomNodeData,
 } from "@/app/(platform)/build/components/legacy-builder/CustomNode/CustomNode";
-import { CredentialsInput } from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/CredentialsInputs";
+import { NodeTableInput } from "@/app/(platform)/build/components/legacy-builder/NodeTableInput";
 import { Button } from "@/components/__legacy__/ui/button";
 import { Calendar } from "@/components/__legacy__/ui/calendar";
 import { LocalValuedInput } from "@/components/__legacy__/ui/input";
@@ -27,8 +27,8 @@ import {
   SelectValue,
 } from "@/components/__legacy__/ui/select";
 import { Switch } from "@/components/atoms/Switch/Switch";
+import { CredentialsInput } from "@/components/contextual/CredentialsInput/CredentialsInput";
 import { GoogleDrivePickerInput } from "@/components/contextual/GoogleDrivePicker/GoogleDrivePickerInput";
-import { NodeTableInput } from "@/components/node-table-input";
 import {
   BlockIOArraySubSchema,
   BlockIOBooleanSubSchema,
@@ -65,7 +65,7 @@ type NodeObjectInputTreeProps = {
   selfKey?: string;
   schema: BlockIORootSchema | BlockIOObjectSubSchema;
   object?: { [key: string]: any };
-  connections: ConnectionData;
+  connections: ConnectedEdge[];
   handleInputClick: (key: string) => void;
   handleInputChange: (key: string, value: any) => void;
   errors: { [key: string]: string | undefined };
@@ -585,7 +585,7 @@ const NodeOneOfDiscriminatorField: FC<{
   currentValue?: any;
   defaultValue?: any;
   errors: { [key: string]: string | undefined };
-  connections: ConnectionData;
+  connections: ConnectedEdge[];
   handleInputChange: (key: string, value: any) => void;
   handleInputClick: (key: string) => void;
   className?: string;
diff --git a/autogpt_platform/frontend/src/components/node-table-input.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/NodeTableInput.tsx
similarity index 95%
rename from autogpt_platform/frontend/src/components/node-table-input.tsx
rename to autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/NodeTableInput.tsx
index 9c1a8003ee..07a5b38520 100644
--- a/autogpt_platform/frontend/src/components/node-table-input.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/NodeTableInput.tsx
@@ -1,15 +1,16 @@
-import React, { FC, useCallback, useEffect, useState } from "react";
+import { FC, useCallback, useEffect, useState } from "react";
 
-import { PlusIcon, XIcon } from "@phosphor-icons/react";
-import { cn } from "@/lib/utils";
 import NodeHandle from "@/app/(platform)/build/components/legacy-builder/NodeHandle";
-import {
+import type {
   BlockIOTableSubSchema,
-  TableRow,
   TableCellValue,
+  TableRow,
 } from "@/lib/autogpt-server-api/types";
-import { Input } from "./atoms/Input/Input";
-import { Button } from "./atoms/Button/Button";
+import type { ConnectedEdge } from "./CustomNode/CustomNode";
+import { cn } from "@/lib/utils";
+import { PlusIcon, XIcon } from "@phosphor-icons/react";
+import { Button } from "@/components/atoms/Button/Button";
+import { Input } from "@/components/atoms/Input/Input";
 
 interface NodeTableInputProps {
   /** Unique identifier for the node in the builder graph */
@@ -25,13 +26,7 @@ interface NodeTableInputProps {
   /** Validation errors mapped by field key */
   errors: { [key: string]: string | undefined };
   /** Graph connections between nodes in the builder */
-  connections: {
-    edge_id: string;
-    source: string;
-    sourceHandle: string;
-    target: string;
-    targetHandle: string;
-  }[];
+  connections: ConnectedEdge[];
   /** Callback when table data changes */
   handleInputChange: (key: string, value: TableRow[]) => void;
   /** Callback when input field is clicked (for builder selection) */
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/RunnerInputUI.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/RunnerInputUI.tsx
index bff21c46f2..15983be9f5 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/RunnerInputUI.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/RunnerInputUI.tsx
@@ -1,17 +1,11 @@
-import React, { useCallback } from "react";
+import { useCallback } from "react";
 
+import { AgentRunDraftView } from "@/app/(platform)/library/agents/[id]/components/OldAgentLibraryView/components/agent-run-draft-view";
+import { Dialog } from "@/components/molecules/Dialog/Dialog";
 import type {
   CredentialsMetaInput,
   GraphMeta,
 } from "@/lib/autogpt-server-api/types";
-import {
-  Dialog,
-  DialogContent,
-  DialogHeader,
-  DialogTitle,
-  DialogDescription,
-} from "@/components/__legacy__/ui/dialog";
-import { AgentRunDraftView } from "@/app/(platform)/library/agents/[id]/components/OldAgentLibraryView/components/agent-run-draft-view";
 
 interface RunInputDialogProps {
   isOpen: boolean;
@@ -70,21 +64,33 @@ export function RunnerInputDialog({
   );
 
   return (
-    <Dialog open={isOpen} onOpenChange={doClose}>
-      <DialogContent className="flex w-[90vw] max-w-4xl flex-col p-10">
-        <DialogHeader>
-          <DialogTitle className="text-2xl">Run your agent</DialogTitle>
-          <DialogDescription className="mt-2">{graph.name}</DialogDescription>
-        </DialogHeader>
-        <AgentRunDraftView
-          className="p-0"
-          graph={graph}
-          doRun={doRun ? handleRun : undefined}
-          onRun={doRun ? undefined : doClose}
-          doCreateSchedule={doCreateSchedule ? handleSchedule : undefined}
-          onCreateSchedule={doCreateSchedule ? undefined : doClose}
-        />
-      </DialogContent>
+    <Dialog
+      title="Run your agent"
+      controlled={{
+        isOpen,
+        set: (open) => {
+          if (!open) doClose();
+        },
+      }}
+      onClose={doClose}
+      styling={{
+        maxWidth: "56rem",
+        width: "90vw",
+      }}
+    >
+      <Dialog.Content>
+        <div className="flex flex-col p-10">
+          <p className="mt-2 text-sm text-zinc-600">{graph.name}</p>
+          <AgentRunDraftView
+            className="p-0"
+            graph={graph}
+            doRun={doRun ? handleRun : undefined}
+            onRun={doRun ? undefined : doClose}
+            doCreateSchedule={doCreateSchedule ? handleSchedule : undefined}
+            onCreateSchedule={doCreateSchedule ? undefined : doClose}
+          />
+        </div>
+      </Dialog.Content>
     </Dialog>
   );
 }
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/tutorial.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/tutorial.ts
index 7adcfd9c1e..418d18782a 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/tutorial.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/tutorial.ts
@@ -328,16 +328,16 @@ export const startTutorial = (
     title: "Press Run",
     text: "Start your first flow by pressing the Run button!",
     attachTo: {
-      element: '[data-testid="primary-action-run-agent"]',
+      element: '[data-tutorial-id="primary-action-run-agent"]',
       on: "top",
     },
     advanceOn: {
-      selector: '[data-testid="primary-action-run-agent"]',
+      selector: '[data-tutorial-id="primary-action-run-agent"]',
       event: "click",
     },
     buttons: [],
     beforeShowPromise: () =>
-      waitForElement('[data-testid="primary-action-run-agent"]'),
+      waitForElement('[data-tutorial-id="primary-action-run-agent"]'),
     when: {
       hide: () => {
         setTimeout(() => {
@@ -508,16 +508,16 @@ export const startTutorial = (
     title: "Press Run Again",
     text: "Now, press the Run button again to execute the flow with the new Calculator Block added!",
     attachTo: {
-      element: '[data-testid="primary-action-run-agent"]',
+      element: '[data-tutorial-id="primary-action-run-agent"]',
       on: "top",
     },
     advanceOn: {
-      selector: '[data-testid="primary-action-run-agent"]',
+      selector: '[data-tutorial-id="primary-action-run-agent"]',
       event: "click",
     },
     buttons: [],
     beforeShowPromise: () =>
-      waitForElement('[data-testid="primary-action-run-agent"]'),
+      waitForElement('[data-tutorial-id="primary-action-run-agent"]'),
     when: {
       hide: () => {
         setTimeout(() => {
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/useCopyPaste.ts b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/useCopyPaste.ts
index a4f604506f..13628441fa 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/useCopyPaste.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/legacy-builder/useCopyPaste.ts
@@ -1,6 +1,7 @@
 import { useCallback } from "react";
 import { Node, Edge, useReactFlow } from "@xyflow/react";
 import { Key, storage } from "@/services/storage/local-storage";
+import { ConnectedEdge } from "./CustomNode/CustomNode";
 
 interface CopyableData {
   nodes: Node[];
@@ -111,13 +112,15 @@ export function useCopyPaste(getNextNodeId: () => string) {
                     (edge: Edge) =>
                       edge.source === node.id || edge.target === node.id,
                   )
-                  .map((edge: Edge) => ({
-                    edge_id: edge.id,
-                    source: edge.source,
-                    target: edge.target,
-                    sourceHandle: edge.sourceHandle,
-                    targetHandle: edge.targetHandle,
-                  }));
+                  .map(
+                    (edge: Edge): ConnectedEdge => ({
+                      id: edge.id,
+                      source: edge.source,
+                      target: edge.target,
+                      sourceHandle: edge.sourceHandle!,
+                      targetHandle: edge.targetHandle!,
+                    }),
+                  );
 
                 return {
                   ...node,
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/hooks/useSaveGraph.ts b/autogpt_platform/frontend/src/app/(platform)/build/hooks/useSaveGraph.ts
index d0b488f26c..505303cc1e 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/hooks/useSaveGraph.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/hooks/useSaveGraph.ts
@@ -15,6 +15,11 @@ import { useEdgeStore } from "../stores/edgeStore";
 import { graphsEquivalent } from "../components/NewControlPanel/NewSaveControl/helpers";
 import { useGraphStore } from "../stores/graphStore";
 import { useShallow } from "zustand/react/shallow";
+import {
+  draftService,
+  clearTempFlowId,
+  getTempFlowId,
+} from "@/services/builder-draft/draft-service";
 
 export type SaveGraphOptions = {
   showToast?: boolean;
@@ -52,12 +57,19 @@ export const useSaveGraph = ({
   const { mutateAsync: createNewGraph, isPending: isCreating } =
     usePostV1CreateNewGraph({
       mutation: {
-        onSuccess: (response) => {
+        onSuccess: async (response) => {
           const data = response.data as GraphModel;
           setQueryStates({
             flowID: data.id,
             flowVersion: data.version,
           });
+
+          const tempFlowId = getTempFlowId();
+          if (tempFlowId) {
+            await draftService.deleteDraft(tempFlowId);
+            clearTempFlowId();
+          }
+
           onSuccess?.(data);
           if (showToast) {
             toast({
@@ -82,12 +94,18 @@ export const useSaveGraph = ({
   const { mutateAsync: updateGraph, isPending: isUpdating } =
     usePutV1UpdateGraphVersion({
       mutation: {
-        onSuccess: (response) => {
+        onSuccess: async (response) => {
           const data = response.data as GraphModel;
           setQueryStates({
             flowID: data.id,
             flowVersion: data.version,
           });
+
+          // Clear the draft for this flow after successful save
+          if (data.id) {
+            await draftService.deleteDraft(data.id);
+          }
+
           onSuccess?.(data);
           if (showToast) {
             toast({
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/hooks/useSubAgentUpdate/helpers.ts b/autogpt_platform/frontend/src/app/(platform)/build/hooks/useSubAgentUpdate/helpers.ts
new file mode 100644
index 0000000000..aece7e9811
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/hooks/useSubAgentUpdate/helpers.ts
@@ -0,0 +1,104 @@
+import { GraphInputSchema } from "@/lib/autogpt-server-api";
+import { GraphMetaLike, IncompatibilityInfo } from "./types";
+
+// Helper type for schema properties - the generated types are too loose
+type SchemaProperties = Record<string, GraphInputSchema["properties"][string]>;
+type SchemaRequired = string[];
+
+// Helper to safely extract schema properties
+export function getSchemaProperties(schema: unknown): SchemaProperties {
+  if (
+    schema &&
+    typeof schema === "object" &&
+    "properties" in schema &&
+    typeof schema.properties === "object" &&
+    schema.properties !== null
+  ) {
+    return schema.properties as SchemaProperties;
+  }
+  return {};
+}
+
+export function getSchemaRequired(schema: unknown): SchemaRequired {
+  if (
+    schema &&
+    typeof schema === "object" &&
+    "required" in schema &&
+    Array.isArray(schema.required)
+  ) {
+    return schema.required as SchemaRequired;
+  }
+  return [];
+}
+
+/**
+ * Creates the updated agent node inputs for a sub-agent node
+ */
+export function createUpdatedAgentNodeInputs(
+  currentInputs: Record<string, unknown>,
+  latestSubGraphVersion: GraphMetaLike,
+): Record<string, unknown> {
+  return {
+    ...currentInputs,
+    graph_version: latestSubGraphVersion.version,
+    input_schema: latestSubGraphVersion.input_schema,
+    output_schema: latestSubGraphVersion.output_schema,
+  };
+}
+
+/** Generic edge type that works with both builders:
+ *  - New builder uses CustomEdge with (formally) optional handles
+ *  - Legacy builder uses ConnectedEdge type with required handles */
+export type EdgeLike = {
+  id: string;
+  source: string;
+  target: string;
+  sourceHandle?: string | null;
+  targetHandle?: string | null;
+};
+
+/**
+ * Determines which edges are broken after an incompatible update.
+ * Works with both legacy ConnectedEdge and new CustomEdge.
+ */
+export function getBrokenEdgeIDs(
+  connections: EdgeLike[],
+  incompatibilities: IncompatibilityInfo,
+  nodeID: string,
+): string[] {
+  const brokenEdgeIDs: string[] = [];
+  const typeMismatchInputNames = new Set(
+    incompatibilities.inputTypeMismatches.map((m) => m.name),
+  );
+
+  connections.forEach((conn) => {
+    // Check if this connection uses a missing input (node is target)
+    if (
+      conn.target === nodeID &&
+      conn.targetHandle &&
+      incompatibilities.missingInputs.includes(conn.targetHandle)
+    ) {
+      brokenEdgeIDs.push(conn.id);
+    }
+
+    // Check if this connection uses an input with a type mismatch (node is target)
+    if (
+      conn.target === nodeID &&
+      conn.targetHandle &&
+      typeMismatchInputNames.has(conn.targetHandle)
+    ) {
+      brokenEdgeIDs.push(conn.id);
+    }
+
+    // Check if this connection uses a missing output (node is source)
+    if (
+      conn.source === nodeID &&
+      conn.sourceHandle &&
+      incompatibilities.missingOutputs.includes(conn.sourceHandle)
+    ) {
+      brokenEdgeIDs.push(conn.id);
+    }
+  });
+
+  return brokenEdgeIDs;
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/hooks/useSubAgentUpdate/index.ts b/autogpt_platform/frontend/src/app/(platform)/build/hooks/useSubAgentUpdate/index.ts
new file mode 100644
index 0000000000..7dd1ffa3b0
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/hooks/useSubAgentUpdate/index.ts
@@ -0,0 +1,2 @@
+export { useSubAgentUpdate } from "./useSubAgentUpdate";
+export { createUpdatedAgentNodeInputs, getBrokenEdgeIDs } from "./helpers";
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/hooks/useSubAgentUpdate/types.ts b/autogpt_platform/frontend/src/app/(platform)/build/hooks/useSubAgentUpdate/types.ts
new file mode 100644
index 0000000000..83f83155db
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/hooks/useSubAgentUpdate/types.ts
@@ -0,0 +1,27 @@
+import type { GraphMeta as LegacyGraphMeta } from "@/lib/autogpt-server-api";
+import type { GraphMeta as GeneratedGraphMeta } from "@/app/api/__generated__/models/graphMeta";
+
+export type SubAgentUpdateInfo<T extends GraphMetaLike = GraphMetaLike> = {
+  hasUpdate: boolean;
+  currentVersion: number;
+  latestVersion: number;
+  latestGraph: T | null;
+  isCompatible: boolean;
+  incompatibilities: IncompatibilityInfo | null;
+};
+
+// Union type for GraphMeta that works with both legacy and new builder
+export type GraphMetaLike = LegacyGraphMeta | GeneratedGraphMeta;
+
+export type IncompatibilityInfo = {
+  missingInputs: string[]; // Connected inputs that no longer exist
+  missingOutputs: string[]; // Connected outputs that no longer exist
+  newInputs: string[]; // Inputs that exist in new version but not in current
+  newOutputs: string[]; // Outputs that exist in new version but not in current
+  newRequiredInputs: string[]; // New required inputs not in current version or not required
+  inputTypeMismatches: Array<{
+    name: string;
+    oldType: string;
+    newType: string;
+  }>; // Connected inputs where the type has changed
+};
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/hooks/useSubAgentUpdate/useSubAgentUpdate.ts b/autogpt_platform/frontend/src/app/(platform)/build/hooks/useSubAgentUpdate/useSubAgentUpdate.ts
new file mode 100644
index 0000000000..315e337cd6
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/hooks/useSubAgentUpdate/useSubAgentUpdate.ts
@@ -0,0 +1,160 @@
+import { useMemo } from "react";
+import { GraphInputSchema, GraphOutputSchema } from "@/lib/autogpt-server-api";
+import { getEffectiveType } from "@/lib/utils";
+import { EdgeLike, getSchemaProperties, getSchemaRequired } from "./helpers";
+import {
+  GraphMetaLike,
+  IncompatibilityInfo,
+  SubAgentUpdateInfo,
+} from "./types";
+
+/**
+ * Checks if a newer version of a sub-agent is available and determines compatibility
+ */
+export function useSubAgentUpdate<T extends GraphMetaLike>(
+  nodeID: string,
+  graphID: string | undefined,
+  graphVersion: number | undefined,
+  currentInputSchema: GraphInputSchema | undefined,
+  currentOutputSchema: GraphOutputSchema | undefined,
+  connections: EdgeLike[],
+  availableGraphs: T[],
+): SubAgentUpdateInfo<T> {
+  // Find the latest version of the same graph
+  const latestGraph = useMemo(() => {
+    if (!graphID) return null;
+    return availableGraphs.find((graph) => graph.id === graphID) || null;
+  }, [graphID, availableGraphs]);
+
+  // Check if there's an update available
+  const hasUpdate = useMemo(() => {
+    if (!latestGraph || graphVersion === undefined) return false;
+    return latestGraph.version! > graphVersion;
+  }, [latestGraph, graphVersion]);
+
+  // Get connected input and output handles for this specific node
+  const connectedHandles = useMemo(() => {
+    const inputHandles = new Set<string>();
+    const outputHandles = new Set<string>();
+
+    connections.forEach((conn) => {
+      // If this node is the target, the targetHandle is an input on this node
+      if (conn.target === nodeID && conn.targetHandle) {
+        inputHandles.add(conn.targetHandle);
+      }
+      // If this node is the source, the sourceHandle is an output on this node
+      if (conn.source === nodeID && conn.sourceHandle) {
+        outputHandles.add(conn.sourceHandle);
+      }
+    });
+
+    return { inputHandles, outputHandles };
+  }, [connections, nodeID]);
+
+  // Check schema compatibility
+  const compatibilityResult = useMemo((): {
+    isCompatible: boolean;
+    incompatibilities: IncompatibilityInfo | null;
+  } => {
+    if (!hasUpdate || !latestGraph) {
+      return { isCompatible: true, incompatibilities: null };
+    }
+
+    const newInputProps = getSchemaProperties(latestGraph.input_schema);
+    const newOutputProps = getSchemaProperties(latestGraph.output_schema);
+    const newRequiredInputs = getSchemaRequired(latestGraph.input_schema);
+
+    const currentInputProps = getSchemaProperties(currentInputSchema);
+    const currentOutputProps = getSchemaProperties(currentOutputSchema);
+    const currentRequiredInputs = getSchemaRequired(currentInputSchema);
+
+    const incompatibilities: IncompatibilityInfo = {
+      missingInputs: [],
+      missingOutputs: [],
+      newInputs: [],
+      newOutputs: [],
+      newRequiredInputs: [],
+      inputTypeMismatches: [],
+    };
+
+    // Check for missing connected inputs and type mismatches
+    connectedHandles.inputHandles.forEach((inputHandle) => {
+      if (!(inputHandle in newInputProps)) {
+        incompatibilities.missingInputs.push(inputHandle);
+      } else {
+        // Check for type mismatch on connected inputs
+        const currentProp = currentInputProps[inputHandle];
+        const newProp = newInputProps[inputHandle];
+        const currentType = getEffectiveType(currentProp);
+        const newType = getEffectiveType(newProp);
+
+        if (currentType && newType && currentType !== newType) {
+          incompatibilities.inputTypeMismatches.push({
+            name: inputHandle,
+            oldType: currentType,
+            newType: newType,
+          });
+        }
+      }
+    });
+
+    // Check for missing connected outputs
+    connectedHandles.outputHandles.forEach((outputHandle) => {
+      if (!(outputHandle in newOutputProps)) {
+        incompatibilities.missingOutputs.push(outputHandle);
+      }
+    });
+
+    // Check for new required inputs that didn't exist or weren't required before
+    newRequiredInputs.forEach((requiredInput) => {
+      const existedBefore = requiredInput in currentInputProps;
+      const wasRequiredBefore = currentRequiredInputs.includes(
+        requiredInput as string,
+      );
+
+      if (!existedBefore || !wasRequiredBefore) {
+        incompatibilities.newRequiredInputs.push(requiredInput as string);
+      }
+    });
+
+    // Check for new inputs that don't exist in the current version
+    Object.keys(newInputProps).forEach((inputName) => {
+      if (!(inputName in currentInputProps)) {
+        incompatibilities.newInputs.push(inputName);
+      }
+    });
+
+    // Check for new outputs that don't exist in the current version
+    Object.keys(newOutputProps).forEach((outputName) => {
+      if (!(outputName in currentOutputProps)) {
+        incompatibilities.newOutputs.push(outputName);
+      }
+    });
+
+    const hasIncompatibilities =
+      incompatibilities.missingInputs.length > 0 ||
+      incompatibilities.missingOutputs.length > 0 ||
+      incompatibilities.newRequiredInputs.length > 0 ||
+      incompatibilities.inputTypeMismatches.length > 0;
+
+    return {
+      isCompatible: !hasIncompatibilities,
+      incompatibilities: hasIncompatibilities ? incompatibilities : null,
+    };
+  }, [
+    hasUpdate,
+    latestGraph,
+    currentInputSchema,
+    currentOutputSchema,
+    connectedHandles,
+  ]);
+
+  return {
+    hasUpdate,
+    currentVersion: graphVersion || 0,
+    latestVersion: latestGraph?.version || 0,
+    latestGraph,
+    isCompatible: compatibilityResult.isCompatible,
+    incompatibilities: compatibilityResult.incompatibilities,
+  };
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/page.tsx b/autogpt_platform/frontend/src/app/(platform)/build/page.tsx
index f60c863657..f1d62ee5fb 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/page.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/page.tsx
@@ -8,8 +8,8 @@ import { ReactFlowProvider } from "@xyflow/react";
 import { useSearchParams } from "next/navigation";
 import { useEffect } from "react";
 import { BuilderViewTabs } from "./components/BuilderViewTabs/BuilderViewTabs";
-import { useBuilderView } from "./components/BuilderViewTabs/useBuilderViewTabs";
 import { Flow } from "./components/FlowEditor/Flow/Flow";
+import { useBuilderView } from "./useBuilderView";
 
 function BuilderContent() {
   const query = useSearchParams();
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/stores/blockMenuStore.ts b/autogpt_platform/frontend/src/app/(platform)/build/stores/blockMenuStore.ts
index ea50a03979..31b9eda338 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/stores/blockMenuStore.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/stores/blockMenuStore.ts
@@ -1,12 +1,30 @@
 import { create } from "zustand";
 import { DefaultStateType } from "../components/NewControlPanel/NewBlockMenu/types";
+import { SearchResponseItemsItem } from "@/app/api/__generated__/models/searchResponseItemsItem";
+import { getSearchItemType } from "../components/NewControlPanel/NewBlockMenu/BlockMenuSearchContent/helper";
+import { StoreAgent } from "@/app/api/__generated__/models/storeAgent";
+import { GetV2BuilderSearchFilterAnyOfItem } from "@/app/api/__generated__/models/getV2BuilderSearchFilterAnyOfItem";
 
 type BlockMenuStore = {
   searchQuery: string;
   searchId: string | undefined;
   defaultState: DefaultStateType;
   integration: string | undefined;
+  filters: GetV2BuilderSearchFilterAnyOfItem[];
+  creators: string[];
+  creators_list: string[];
+  categoryCounts: Record<GetV2BuilderSearchFilterAnyOfItem, number>;
 
+  setCategoryCounts: (
+    counts: Record<GetV2BuilderSearchFilterAnyOfItem, number>,
+  ) => void;
+  setCreatorsList: (searchData: SearchResponseItemsItem[]) => void;
+  addCreator: (creator: string) => void;
+  setCreators: (creators: string[]) => void;
+  removeCreator: (creator: string) => void;
+  addFilter: (filter: GetV2BuilderSearchFilterAnyOfItem) => void;
+  setFilters: (filters: GetV2BuilderSearchFilterAnyOfItem[]) => void;
+  removeFilter: (filter: GetV2BuilderSearchFilterAnyOfItem) => void;
   setSearchQuery: (query: string) => void;
   setSearchId: (id: string | undefined) => void;
   setDefaultState: (state: DefaultStateType) => void;
@@ -19,11 +37,44 @@ export const useBlockMenuStore = create<BlockMenuStore>((set) => ({
   searchId: undefined,
   defaultState: DefaultStateType.SUGGESTION,
   integration: undefined,
+  filters: [],
+  creators: [], // creator filters that are applied to the search results
+  creators_list: [], // all creators that are available to filter by
+  categoryCounts: {
+    blocks: 0,
+    integrations: 0,
+    marketplace_agents: 0,
+    my_agents: 0,
+  },
 
+  setCategoryCounts: (counts) => set({ categoryCounts: counts }),
+  setCreatorsList: (searchData) => {
+    const marketplaceAgents = searchData.filter((item) => {
+      return getSearchItemType(item).type === "store_agent";
+    }) as StoreAgent[];
+
+    const newCreators = marketplaceAgents.map((agent) => agent.creator);
+
+    set((state) => ({
+      creators_list: Array.from(
+        new Set([...state.creators_list, ...newCreators]),
+      ),
+    }));
+  },
+  setCreators: (creators) => set({ creators }),
+  setFilters: (filters) => set({ filters }),
   setSearchQuery: (query) => set({ searchQuery: query }),
   setSearchId: (id) => set({ searchId: id }),
   setDefaultState: (state) => set({ defaultState: state }),
   setIntegration: (integration) => set({ integration }),
+  addFilter: (filter) =>
+    set((state) => ({ filters: [...state.filters, filter] })),
+  removeFilter: (filter) =>
+    set((state) => ({ filters: state.filters.filter((f) => f !== filter) })),
+  addCreator: (creator) =>
+    set((state) => ({ creators: [...state.creators, creator] })),
+  removeCreator: (creator) =>
+    set((state) => ({ creators: state.creators.filter((c) => c !== creator) })),
   reset: () =>
     set({
       searchQuery: "",
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/stores/controlPanelStore.ts b/autogpt_platform/frontend/src/app/(platform)/build/stores/controlPanelStore.ts
index 6847d769bd..5dcb11c121 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/stores/controlPanelStore.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/stores/controlPanelStore.ts
@@ -3,20 +3,32 @@ import { create } from "zustand";
 type ControlPanelStore = {
   blockMenuOpen: boolean;
   saveControlOpen: boolean;
+  forceOpenBlockMenu: boolean;
+  forceOpenSave: boolean;
+
   setBlockMenuOpen: (open: boolean) => void;
   setSaveControlOpen: (open: boolean) => void;
+  setForceOpenBlockMenu: (force: boolean) => void;
+  setForceOpenSave: (force: boolean) => void;
+
   reset: () => void;
 };
 
 export const useControlPanelStore = create<ControlPanelStore>((set) => ({
   blockMenuOpen: false,
   saveControlOpen: false,
+  forceOpenBlockMenu: false,
+  forceOpenSave: false,
 
+  setForceOpenBlockMenu: (force) => set({ forceOpenBlockMenu: force }),
+  setForceOpenSave: (force) => set({ forceOpenSave: force }),
   setBlockMenuOpen: (open) => set({ blockMenuOpen: open }),
   setSaveControlOpen: (open) => set({ saveControlOpen: open }),
   reset: () =>
     set({
       blockMenuOpen: false,
       saveControlOpen: false,
+      forceOpenBlockMenu: false,
+      forceOpenSave: false,
     }),
 }));
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/stores/edgeStore.ts b/autogpt_platform/frontend/src/app/(platform)/build/stores/edgeStore.ts
index 0d0e4202fb..6a45b9e1e2 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/stores/edgeStore.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/stores/edgeStore.ts
@@ -4,6 +4,9 @@ import { CustomEdge } from "../components/FlowEditor/edges/CustomEdge";
 import { customEdgeToLink, linkToCustomEdge } from "../components/helper";
 import { MarkerType } from "@xyflow/react";
 import { NodeExecutionResult } from "@/app/api/__generated__/models/nodeExecutionResult";
+import { cleanUpHandleId } from "@/components/renderers/InputRenderer/helpers";
+import { useHistoryStore } from "./historyStore";
+import { useNodeStore } from "./nodeStore";
 
 type EdgeStore = {
   edges: CustomEdge[];
@@ -13,6 +16,8 @@ type EdgeStore = {
   removeEdge: (edgeId: string) => void;
   upsertMany: (edges: CustomEdge[]) => void;
 
+  removeEdgesByHandlePrefix: (nodeId: string, handlePrefix: string) => void;
+
   getNodeEdges: (nodeId: string) => CustomEdge[];
   isInputConnected: (nodeId: string, handle: string) => boolean;
   isOutputConnected: (nodeId: string, handle: string) => boolean;
@@ -50,25 +55,36 @@ export const useEdgeStore = create<EdgeStore>((set, get) => ({
       id,
     };
 
-    set((state) => {
-      const exists = state.edges.some(
-        (e) =>
-          e.source === newEdge.source &&
-          e.target === newEdge.target &&
-          e.sourceHandle === newEdge.sourceHandle &&
-          e.targetHandle === newEdge.targetHandle,
-      );
-      if (exists) return state;
-      return { edges: [...state.edges, newEdge] };
-    });
+    const exists = get().edges.some(
+      (e) =>
+        e.source === newEdge.source &&
+        e.target === newEdge.target &&
+        e.sourceHandle === newEdge.sourceHandle &&
+        e.targetHandle === newEdge.targetHandle,
+    );
+    if (exists) return newEdge;
+    const prevState = {
+      nodes: useNodeStore.getState().nodes,
+      edges: get().edges,
+    };
+
+    set((state) => ({ edges: [...state.edges, newEdge] }));
+    useHistoryStore.getState().pushState(prevState);
 
     return newEdge;
   },
 
-  removeEdge: (edgeId) =>
+  removeEdge: (edgeId) => {
+    const prevState = {
+      nodes: useNodeStore.getState().nodes,
+      edges: get().edges,
+    };
+
     set((state) => ({
       edges: state.edges.filter((e) => e.id !== edgeId),
-    })),
+    }));
+    useHistoryStore.getState().pushState(prevState);
+  },
 
   upsertMany: (edges) =>
     set((state) => {
@@ -79,11 +95,27 @@ export const useEdgeStore = create<EdgeStore>((set, get) => ({
       return { edges: Array.from(byKey.values()) };
     }),
 
+  removeEdgesByHandlePrefix: (nodeId, handlePrefix) =>
+    set((state) => ({
+      edges: state.edges.filter(
+        (e) =>
+          !(
+            e.target === nodeId &&
+            e.targetHandle &&
+            e.targetHandle.startsWith(handlePrefix)
+          ),
+      ),
+    })),
+
   getNodeEdges: (nodeId) =>
     get().edges.filter((e) => e.source === nodeId || e.target === nodeId),
 
-  isInputConnected: (nodeId, handle) =>
-    get().edges.some((e) => e.target === nodeId && e.targetHandle === handle),
+  isInputConnected: (nodeId, handle) => {
+    const cleanedHandle = cleanUpHandleId(handle);
+    return get().edges.some(
+      (e) => e.target === nodeId && e.targetHandle === cleanedHandle,
+    );
+  },
 
   isOutputConnected: (nodeId, handle) =>
     get().edges.some((e) => e.source === nodeId && e.sourceHandle === handle),
@@ -105,20 +137,21 @@ export const useEdgeStore = create<EdgeStore>((set, get) => ({
     targetNodeId: string,
     executionResult: NodeExecutionResult,
   ) => {
-    set((state) => ({
-      edges: state.edges.map((edge) => {
+    set((state) => {
+      let hasChanges = false;
+
+      const newEdges = state.edges.map((edge) => {
         if (edge.target !== targetNodeId) {
           return edge;
         }
 
-        const beadData =
-          edge.data?.beadData ??
-          new Map<string, NodeExecutionResult["status"]>();
+        const beadData = new Map(edge.data?.beadData ?? new Map());
 
-        if (
-          edge.targetHandle &&
-          edge.targetHandle in executionResult.input_data
-        ) {
+        const inputValue = edge.targetHandle
+          ? executionResult.input_data[edge.targetHandle]
+          : undefined;
+
+        if (inputValue !== undefined && inputValue !== null) {
           beadData.set(executionResult.node_exec_id, executionResult.status);
         }
 
@@ -136,6 +169,11 @@ export const useEdgeStore = create<EdgeStore>((set, get) => ({
           beadUp = beadDown + 1;
         }
 
+        if (edge.data?.beadUp === beadUp && edge.data?.beadDown === beadDown) {
+          return edge;
+        }
+
+        hasChanges = true;
         return {
           ...edge,
           data: {
@@ -145,8 +183,10 @@ export const useEdgeStore = create<EdgeStore>((set, get) => ({
             beadData,
           },
         };
-      }),
-    }));
+      });
+
+      return hasChanges ? { edges: newEdges } : state;
+    });
   },
 
   resetEdgeBeads: () => {
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/stores/graphStore.ts b/autogpt_platform/frontend/src/app/(platform)/build/stores/graphStore.ts
index 44142881a8..6961884732 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/stores/graphStore.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/stores/graphStore.ts
@@ -1,5 +1,6 @@
 import { create } from "zustand";
 import { AgentExecutionStatus } from "@/app/api/__generated__/models/agentExecutionStatus";
+import { GraphMeta } from "@/app/api/__generated__/models/graphMeta";
 
 interface GraphStore {
   graphExecutionStatus: AgentExecutionStatus | undefined;
@@ -17,6 +18,10 @@ interface GraphStore {
     outputSchema: Record<string, any> | null,
   ) => void;
 
+  // Available graphs; used for sub-graph updates
+  availableSubGraphs: GraphMeta[];
+  setAvailableSubGraphs: (graphs: GraphMeta[]) => void;
+
   hasInputs: () => boolean;
   hasCredentials: () => boolean;
   hasOutputs: () => boolean;
@@ -29,6 +34,7 @@ export const useGraphStore = create<GraphStore>((set, get) => ({
   inputSchema: null,
   credentialsInputSchema: null,
   outputSchema: null,
+  availableSubGraphs: [],
 
   setGraphExecutionStatus: (status: AgentExecutionStatus | undefined) => {
     set({
@@ -46,6 +52,8 @@ export const useGraphStore = create<GraphStore>((set, get) => ({
   setGraphSchemas: (inputSchema, credentialsInputSchema, outputSchema) =>
     set({ inputSchema, credentialsInputSchema, outputSchema }),
 
+  setAvailableSubGraphs: (graphs) => set({ availableSubGraphs: graphs }),
+
   hasOutputs: () => {
     const { outputSchema } = get();
     return Object.keys(outputSchema?.properties ?? {}).length > 0;
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/stores/historyStore.ts b/autogpt_platform/frontend/src/app/(platform)/build/stores/historyStore.ts
index 4eea5741a4..3a67bb8dcd 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/stores/historyStore.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/stores/historyStore.ts
@@ -37,6 +37,15 @@ export const useHistoryStore = create<HistoryStore>((set, get) => ({
       return;
     }
 
+    const actualCurrentState = {
+      nodes: useNodeStore.getState().nodes,
+      edges: useEdgeStore.getState().edges,
+    };
+
+    if (isEqual(state, actualCurrentState)) {
+      return;
+    }
+
     set((prev) => ({
       past: [...prev.past.slice(-MAX_HISTORY + 1), state],
       future: [],
@@ -55,18 +64,25 @@ export const useHistoryStore = create<HistoryStore>((set, get) => ({
 
   undo: () => {
     const { past, future } = get();
-    if (past.length <= 1) return;
+    if (past.length === 0) return;
 
-    const currentState = past[past.length - 1];
+    const actualCurrentState = {
+      nodes: useNodeStore.getState().nodes,
+      edges: useEdgeStore.getState().edges,
+    };
 
-    const previousState = past[past.length - 2];
+    const previousState = past[past.length - 1];
+
+    if (isEqual(actualCurrentState, previousState)) {
+      return;
+    }
 
     useNodeStore.getState().setNodes(previousState.nodes);
     useEdgeStore.getState().setEdges(previousState.edges);
 
     set({
-      past: past.slice(0, -1),
-      future: [currentState, ...future],
+      past: past.length > 1 ? past.slice(0, -1) : past,
+      future: [actualCurrentState, ...future],
     });
   },
 
@@ -74,18 +90,36 @@ export const useHistoryStore = create<HistoryStore>((set, get) => ({
     const { past, future } = get();
     if (future.length === 0) return;
 
+    const actualCurrentState = {
+      nodes: useNodeStore.getState().nodes,
+      edges: useEdgeStore.getState().edges,
+    };
+
     const nextState = future[0];
 
     useNodeStore.getState().setNodes(nextState.nodes);
     useEdgeStore.getState().setEdges(nextState.edges);
 
+    const lastPast = past[past.length - 1];
+    const shouldPushToPast =
+      !lastPast || !isEqual(actualCurrentState, lastPast);
+
     set({
-      past: [...past, nextState],
+      past: shouldPushToPast ? [...past, actualCurrentState] : past,
       future: future.slice(1),
     });
   },
 
-  canUndo: () => get().past.length > 1,
+  canUndo: () => {
+    const { past } = get();
+    if (past.length === 0) return false;
+
+    const actualCurrentState = {
+      nodes: useNodeStore.getState().nodes,
+      edges: useEdgeStore.getState().edges,
+    };
+    return !isEqual(actualCurrentState, past[past.length - 1]);
+  },
   canRedo: () => get().future.length > 0,
 
   clear: () => set({ past: [{ nodes: [], edges: [] }], future: [] }),
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/stores/nodeStore.ts b/autogpt_platform/frontend/src/app/(platform)/build/stores/nodeStore.ts
index 2f41c3bb46..5502a8780d 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/stores/nodeStore.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/stores/nodeStore.ts
@@ -1,6 +1,7 @@
 import { create } from "zustand";
 import { NodeChange, XYPosition, applyNodeChanges } from "@xyflow/react";
 import { CustomNode } from "../components/FlowEditor/nodes/CustomNode/CustomNode";
+import { CustomEdge } from "../components/FlowEditor/edges/CustomEdge";
 import { BlockInfo } from "@/app/api/__generated__/models/blockInfo";
 import {
   convertBlockInfoIntoCustomNodeData,
@@ -13,6 +14,29 @@ import { useHistoryStore } from "./historyStore";
 import { useEdgeStore } from "./edgeStore";
 import { BlockUIType } from "../components/types";
 import { pruneEmptyValues } from "@/lib/utils";
+import {
+  ensurePathExists,
+  parseHandleIdToPath,
+} from "@/components/renderers/InputRenderer/helpers";
+import { IncompatibilityInfo } from "../hooks/useSubAgentUpdate/types";
+
+// Resolution mode data stored per node
+export type NodeResolutionData = {
+  incompatibilities: IncompatibilityInfo;
+  // The NEW schema from the update (what we're updating TO)
+  pendingUpdate: {
+    input_schema: Record<string, unknown>;
+    output_schema: Record<string, unknown>;
+  };
+  // The OLD schema before the update (what we're updating FROM)
+  // Needed to merge and show removed inputs during resolution
+  currentSchema: {
+    input_schema: Record<string, unknown>;
+    output_schema: Record<string, unknown>;
+  };
+  // The full updated hardcoded values to apply when resolution completes
+  pendingHardcodedValues: Record<string, unknown>;
+};
 
 // Minimum movement (in pixels) required before logging position change to history
 // Prevents spamming history with small movements when clicking on inputs inside blocks
@@ -21,9 +45,12 @@ const MINIMUM_MOVE_BEFORE_LOG = 50;
 // Track initial positions when drag starts (outside store to avoid re-renders)
 const dragStartPositions: Record<string, XYPosition> = {};
 
+let dragStartState: { nodes: CustomNode[]; edges: CustomEdge[] } | null = null;
+
 type NodeStore = {
   nodes: CustomNode[];
   nodeCounter: number;
+  setNodeCounter: (nodeCounter: number) => void;
   nodeAdvancedStates: Record<string, boolean>;
   setNodes: (nodes: CustomNode[]) => void;
   onNodesChange: (changes: NodeChange<CustomNode>[]) => void;
@@ -61,27 +88,59 @@ type NodeStore = {
     backendId: string,
     errors: { [key: string]: string },
   ) => void;
-  clearAllNodeErrors: () => void; // Add this
+
+  syncHardcodedValuesWithHandleIds: (nodeId: string) => void;
+
+  setCredentialsOptional: (nodeId: string, optional: boolean) => void;
+  clearAllNodeErrors: () => void;
+
+  nodesInResolutionMode: Set<string>;
+  brokenEdgeIDs: Map<string, Set<string>>;
+  nodeResolutionData: Map<string, NodeResolutionData>;
+  setNodeResolutionMode: (
+    nodeID: string,
+    inResolution: boolean,
+    resolutionData?: NodeResolutionData,
+  ) => void;
+  isNodeInResolutionMode: (nodeID: string) => boolean;
+  getNodeResolutionData: (nodeID: string) => NodeResolutionData | undefined;
+  setBrokenEdgeIDs: (nodeID: string, edgeIDs: string[]) => void;
+  removeBrokenEdgeID: (nodeID: string, edgeID: string) => void;
+  isEdgeBroken: (edgeID: string) => boolean;
+  clearResolutionState: () => void;
+
+  isInputBroken: (nodeID: string, handleID: string) => boolean;
+  getInputTypeMismatch: (
+    nodeID: string,
+    handleID: string,
+  ) => string | undefined;
 };
 
 export const useNodeStore = create<NodeStore>((set, get) => ({
   nodes: [],
   setNodes: (nodes) => set({ nodes }),
   nodeCounter: 0,
+  setNodeCounter: (nodeCounter) => set({ nodeCounter }),
   nodeAdvancedStates: {},
   incrementNodeCounter: () =>
     set((state) => ({
       nodeCounter: state.nodeCounter + 1,
     })),
   onNodesChange: (changes) => {
-    const prevState = {
-      nodes: get().nodes,
-      edges: useEdgeStore.getState().edges,
-    };
-
-    // Track initial positions when drag starts
     changes.forEach((change) => {
       if (change.type === "position" && change.dragging === true) {
+        if (!dragStartState) {
+          const currentNodes = get().nodes;
+          const currentEdges = useEdgeStore.getState().edges;
+          dragStartState = {
+            nodes: currentNodes.map((n) => ({
+              ...n,
+              position: { ...n.position },
+              data: { ...n.data },
+            })),
+            edges: currentEdges.map((e) => ({ ...e })),
+          };
+        }
         if (!dragStartPositions[change.id]) {
           const node = get().nodes.find((n) => n.id === change.id);
           if (node) {
@@ -91,12 +150,17 @@ export const useNodeStore = create<NodeStore>((set, get) => ({
       }
     });
 
-    // Check if we should track this change in history
-    let shouldTrack = changes.some(
-      (change) => change.type === "remove" || change.type === "add",
-    );
+    let shouldTrack = changes.some((change) => change.type === "remove");
+    let stateToTrack: { nodes: CustomNode[]; edges: CustomEdge[] } | null =
+      null;
+
+    if (shouldTrack) {
+      stateToTrack = {
+        nodes: get().nodes,
+        edges: useEdgeStore.getState().edges,
+      };
+    }
 
-    // For position changes, only track if movement exceeds threshold
     if (!shouldTrack) {
       changes.forEach((change) => {
         if (change.type === "position" && change.dragging === false) {
@@ -108,20 +172,23 @@ export const useNodeStore = create<NodeStore>((set, get) => ({
             );
             if (distanceMoved > MINIMUM_MOVE_BEFORE_LOG) {
               shouldTrack = true;
+              stateToTrack = dragStartState;
             }
           }
-          // Clean up tracked position after drag ends
           delete dragStartPositions[change.id];
         }
       });
+      if (Object.keys(dragStartPositions).length === 0) {
+        dragStartState = null;
+      }
     }
 
     set((state) => ({
       nodes: applyNodeChanges(changes, state.nodes),
     }));
 
-    if (shouldTrack) {
-      useHistoryStore.getState().pushState(prevState);
+    if (shouldTrack && stateToTrack) {
+      useHistoryStore.getState().pushState(stateToTrack);
     }
   },
 
@@ -135,6 +202,11 @@ export const useNodeStore = create<NodeStore>((set, get) => ({
     hardcodedValues?: Record<string, any>,
     position?: XYPosition,
   ) => {
+    const prevState = {
+      nodes: get().nodes,
+      edges: useEdgeStore.getState().edges,
+    };
+
     const customNodeData = convertBlockInfoIntoCustomNodeData(
       block,
       hardcodedValues,
@@ -168,21 +240,24 @@ export const useNodeStore = create<NodeStore>((set, get) => ({
     set((state) => ({
       nodes: [...state.nodes, customNode],
     }));
+
+    useHistoryStore.getState().pushState(prevState);
+
     return customNode;
   },
   updateNodeData: (nodeId, data) => {
+    const prevState = {
+      nodes: get().nodes,
+      edges: useEdgeStore.getState().edges,
+    };
+
     set((state) => ({
       nodes: state.nodes.map((n) =>
         n.id === nodeId ? { ...n, data: { ...n.data, ...data } } : n,
       ),
     }));
 
-    const newState = {
-      nodes: get().nodes,
-      edges: useEdgeStore.getState().edges,
-    };
-
-    useHistoryStore.getState().pushState(newState);
+    useHistoryStore.getState().pushState(prevState);
   },
   toggleAdvanced: (nodeId: string) =>
     set((state) => ({
@@ -220,6 +295,9 @@ export const useNodeStore = create<NodeStore>((set, get) => ({
         ...(node.data.metadata?.customized_name !== undefined && {
           customized_name: node.data.metadata.customized_name,
         }),
+        ...(node.data.metadata?.credentials_optional !== undefined && {
+          credentials_optional: node.data.metadata.credentials_optional,
+        }),
       },
     };
   },
@@ -305,4 +383,156 @@ export const useNodeStore = create<NodeStore>((set, get) => ({
       })),
     }));
   },
+
+  syncHardcodedValuesWithHandleIds: (nodeId: string) => {
+    const node = get().nodes.find((n) => n.id === nodeId);
+    if (!node) return;
+
+    const handleIds = useEdgeStore.getState().getAllHandleIdsOfANode(nodeId);
+    const additionalHandles = handleIds.filter((h) => h.includes("_#_"));
+
+    if (additionalHandles.length === 0) return;
+
+    const hardcodedValues = JSON.parse(
+      JSON.stringify(node.data.hardcodedValues || {}),
+    );
+
+    let modified = false;
+
+    additionalHandles.forEach((handleId) => {
+      const segments = parseHandleIdToPath(handleId);
+      if (ensurePathExists(hardcodedValues, segments)) {
+        modified = true;
+      }
+    });
+
+    if (modified) {
+      set((state) => ({
+        nodes: state.nodes.map((n) =>
+          n.id === nodeId ? { ...n, data: { ...n.data, hardcodedValues } } : n,
+        ),
+      }));
+    }
+  },
+
+  setCredentialsOptional: (nodeId: string, optional: boolean) => {
+    const prevState = {
+      nodes: get().nodes,
+      edges: useEdgeStore.getState().edges,
+    };
+
+    set((state) => ({
+      nodes: state.nodes.map((n) =>
+        n.id === nodeId
+          ? {
+              ...n,
+              data: {
+                ...n.data,
+                metadata: {
+                  ...n.data.metadata,
+                  credentials_optional: optional,
+                },
+              },
+            }
+          : n,
+      ),
+    }));
+
+    useHistoryStore.getState().pushState(prevState);
+  },
+
+  // Sub-agent resolution mode state
+  nodesInResolutionMode: new Set<string>(),
+  brokenEdgeIDs: new Map<string, Set<string>>(),
+  nodeResolutionData: new Map<string, NodeResolutionData>(),
+
+  setNodeResolutionMode: (
+    nodeID: string,
+    inResolution: boolean,
+    resolutionData?: NodeResolutionData,
+  ) => {
+    set((state) => {
+      const newNodesSet = new Set(state.nodesInResolutionMode);
+      const newResolutionDataMap = new Map(state.nodeResolutionData);
+      const newBrokenEdgeIDs = new Map(state.brokenEdgeIDs);
+
+      if (inResolution) {
+        newNodesSet.add(nodeID);
+        if (resolutionData) {
+          newResolutionDataMap.set(nodeID, resolutionData);
+        }
+      } else {
+        newNodesSet.delete(nodeID);
+        newResolutionDataMap.delete(nodeID);
+        newBrokenEdgeIDs.delete(nodeID); // Clean up broken edges when exiting resolution mode
+      }
+
+      return {
+        nodesInResolutionMode: newNodesSet,
+        nodeResolutionData: newResolutionDataMap,
+        brokenEdgeIDs: newBrokenEdgeIDs,
+      };
+    });
+  },
+
+  isNodeInResolutionMode: (nodeID: string) => {
+    return get().nodesInResolutionMode.has(nodeID);
+  },
+
+  getNodeResolutionData: (nodeID: string) => {
+    return get().nodeResolutionData.get(nodeID);
+  },
+
+  setBrokenEdgeIDs: (nodeID: string, edgeIDs: string[]) => {
+    set((state) => {
+      const newMap = new Map(state.brokenEdgeIDs);
+      newMap.set(nodeID, new Set(edgeIDs));
+      return { brokenEdgeIDs: newMap };
+    });
+  },
+
+  removeBrokenEdgeID: (nodeID: string, edgeID: string) => {
+    set((state) => {
+      const newMap = new Map(state.brokenEdgeIDs);
+      const nodeSet = new Set(newMap.get(nodeID) || []);
+      nodeSet.delete(edgeID);
+      newMap.set(nodeID, nodeSet);
+      return { brokenEdgeIDs: newMap };
+    });
+  },
+
+  isEdgeBroken: (edgeID: string) => {
+    // Check across all nodes
+    const brokenEdgeIDs = get().brokenEdgeIDs;
+    for (const edgeSet of brokenEdgeIDs.values()) {
+      if (edgeSet.has(edgeID)) {
+        return true;
+      }
+    }
+    return false;
+  },
+
+  clearResolutionState: () => {
+    set({
+      nodesInResolutionMode: new Set<string>(),
+      brokenEdgeIDs: new Map<string, Set<string>>(),
+      nodeResolutionData: new Map<string, NodeResolutionData>(),
+    });
+  },
+
+  // Helper functions for input renderers
+  isInputBroken: (nodeID: string, handleID: string) => {
+    const resolutionData = get().nodeResolutionData.get(nodeID);
+    if (!resolutionData) return false;
+    return resolutionData.incompatibilities.missingInputs.includes(handleID);
+  },
+
+  getInputTypeMismatch: (nodeID: string, handleID: string) => {
+    const resolutionData = get().nodeResolutionData.get(nodeID);
+    if (!resolutionData) return undefined;
+    const mismatch = resolutionData.incompatibilities.inputTypeMismatches.find(
+      (m) => m.name === handleID,
+    );
+    return mismatch?.newType;
+  },
 }));
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/stores/tutorialStore.ts b/autogpt_platform/frontend/src/app/(platform)/build/stores/tutorialStore.ts
new file mode 100644
index 0000000000..581dda44c9
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/stores/tutorialStore.ts
@@ -0,0 +1,32 @@
+import { create } from "zustand";
+
+type TutorialStore = {
+  isTutorialRunning: boolean;
+  setIsTutorialRunning: (isTutorialRunning: boolean) => void;
+
+  currentStep: number;
+  setCurrentStep: (currentStep: number) => void;
+
+  // Force open the run input dialog from the tutorial
+  forceOpenRunInputDialog: boolean;
+  setForceOpenRunInputDialog: (forceOpen: boolean) => void;
+
+  // Track input values filled in the dialog
+  tutorialInputValues: Record<string, any>;
+  setTutorialInputValues: (values: Record<string, any>) => void;
+};
+
+export const useTutorialStore = create<TutorialStore>((set) => ({
+  isTutorialRunning: false,
+  setIsTutorialRunning: (isTutorialRunning) => set({ isTutorialRunning }),
+
+  currentStep: 0,
+  setCurrentStep: (currentStep) => set({ currentStep }),
+
+  forceOpenRunInputDialog: false,
+  setForceOpenRunInputDialog: (forceOpen) =>
+    set({ forceOpenRunInputDialog: forceOpen }),
+
+  tutorialInputValues: {},
+  setTutorialInputValues: (values) => set({ tutorialInputValues: values }),
+}));
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderViewTabs/useBuilderViewTabs.ts b/autogpt_platform/frontend/src/app/(platform)/build/useBuilderView.ts
similarity index 95%
rename from autogpt_platform/frontend/src/app/(platform)/build/components/BuilderViewTabs/useBuilderViewTabs.ts
rename to autogpt_platform/frontend/src/app/(platform)/build/useBuilderView.ts
index ac02becca5..e0e524ddf8 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/BuilderViewTabs/useBuilderViewTabs.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/build/useBuilderView.ts
@@ -1,7 +1,7 @@
 import { Flag, useGetFlag } from "@/services/feature-flags/use-get-flag";
 import { usePathname, useRouter, useSearchParams } from "next/navigation";
 import { useEffect, useMemo } from "react";
-import { BuilderView } from "./BuilderViewTabs";
+import { BuilderView } from "./components/BuilderViewTabs/BuilderViewTabs";
 
 export function useBuilderView() {
   const isNewFlowEditorEnabled = useGetFlag(Flag.NEW_FLOW_EDITOR);
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/Chat.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/Chat.tsx
new file mode 100644
index 0000000000..461c885dc3
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/Chat.tsx
@@ -0,0 +1,134 @@
+"use client";
+
+import { Button } from "@/components/atoms/Button/Button";
+import { Text } from "@/components/atoms/Text/Text";
+import { cn } from "@/lib/utils";
+import { List } from "@phosphor-icons/react";
+import React, { useState } from "react";
+import { ChatContainer } from "./components/ChatContainer/ChatContainer";
+import { ChatErrorState } from "./components/ChatErrorState/ChatErrorState";
+import { ChatLoadingState } from "./components/ChatLoadingState/ChatLoadingState";
+import { SessionsDrawer } from "./components/SessionsDrawer/SessionsDrawer";
+import { useChat } from "./useChat";
+
+export interface ChatProps {
+  className?: string;
+  headerTitle?: React.ReactNode;
+  showHeader?: boolean;
+  showSessionInfo?: boolean;
+  showNewChatButton?: boolean;
+  onNewChat?: () => void;
+  headerActions?: React.ReactNode;
+}
+
+export function Chat({
+  className,
+  headerTitle = "AutoGPT Copilot",
+  showHeader = true,
+  showSessionInfo = true,
+  showNewChatButton = true,
+  onNewChat,
+  headerActions,
+}: ChatProps) {
+  const {
+    messages,
+    isLoading,
+    isCreating,
+    error,
+    sessionId,
+    createSession,
+    clearSession,
+    loadSession,
+  } = useChat();
+
+  const [isSessionsDrawerOpen, setIsSessionsDrawerOpen] = useState(false);
+
+  const handleNewChat = () => {
+    clearSession();
+    onNewChat?.();
+  };
+
+  const handleSelectSession = async (sessionId: string) => {
+    try {
+      await loadSession(sessionId);
+    } catch (err) {
+      console.error("Failed to load session:", err);
+    }
+  };
+
+  return (
+    <div className={cn("flex h-full flex-col", className)}>
+      {/* Header */}
+      {showHeader && (
+        <header className="shrink-0 border-t border-zinc-200 bg-white p-3">
+          <div className="flex items-center justify-between">
+            <div className="flex items-center gap-3">
+              <button
+                aria-label="View sessions"
+                onClick={() => setIsSessionsDrawerOpen(true)}
+                className="flex size-8 items-center justify-center rounded hover:bg-zinc-100"
+              >
+                <List width="1.25rem" height="1.25rem" />
+              </button>
+              {typeof headerTitle === "string" ? (
+                <Text variant="h2" className="text-lg font-semibold">
+                  {headerTitle}
+                </Text>
+              ) : (
+                headerTitle
+              )}
+            </div>
+            <div className="flex items-center gap-3">
+              {showSessionInfo && sessionId && (
+                <>
+                  {showNewChatButton && (
+                    <Button
+                      variant="outline"
+                      size="small"
+                      onClick={handleNewChat}
+                    >
+                      New Chat
+                    </Button>
+                  )}
+                </>
+              )}
+              {headerActions}
+            </div>
+          </div>
+        </header>
+      )}
+
+      {/* Main Content */}
+      <main className="flex min-h-0 flex-1 flex-col overflow-hidden">
+        {/* Loading State - show when explicitly loading/creating OR when we don't have a session yet and no error */}
+        {(isLoading || isCreating || (!sessionId && !error)) && (
+          <ChatLoadingState
+            message={isCreating ? "Creating session..." : "Loading..."}
+          />
+        )}
+
+        {/* Error State */}
+        {error && !isLoading && (
+          <ChatErrorState error={error} onRetry={createSession} />
+        )}
+
+        {/* Session Content */}
+        {sessionId && !isLoading && !error && (
+          <ChatContainer
+            sessionId={sessionId}
+            initialMessages={messages}
+            className="flex-1"
+          />
+        )}
+      </main>
+
+      {/* Sessions Drawer */}
+      <SessionsDrawer
+        isOpen={isSessionsDrawerOpen}
+        onClose={() => setIsSessionsDrawerOpen(false)}
+        onSelectSession={handleSelectSession}
+        currentSessionId={sessionId}
+      />
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/AgentCarouselMessage/AgentCarouselMessage.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/AgentCarouselMessage/AgentCarouselMessage.tsx
similarity index 65%
rename from autogpt_platform/frontend/src/app/(platform)/chat/components/AgentCarouselMessage/AgentCarouselMessage.tsx
rename to autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/AgentCarouselMessage/AgentCarouselMessage.tsx
index 125f834e05..582b24de5e 100644
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/AgentCarouselMessage/AgentCarouselMessage.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/AgentCarouselMessage/AgentCarouselMessage.tsx
@@ -1,15 +1,16 @@
-import React from "react";
-import { Text } from "@/components/atoms/Text/Text";
 import { Button } from "@/components/atoms/Button/Button";
 import { Card } from "@/components/atoms/Card/Card";
-import { List, Robot, ArrowRight } from "@phosphor-icons/react";
+import { Text } from "@/components/atoms/Text/Text";
 import { cn } from "@/lib/utils";
+import { ArrowRight, List, Robot } from "@phosphor-icons/react";
+import Image from "next/image";
 
 export interface Agent {
   id: string;
   name: string;
   description: string;
   version?: number;
+  image_url?: string;
 }
 
 export interface AgentCarouselMessageProps {
@@ -30,7 +31,7 @@ export function AgentCarouselMessage({
   return (
     <div
       className={cn(
-        "mx-4 my-2 flex flex-col gap-4 rounded-lg border border-purple-200 bg-purple-50 p-6 dark:border-purple-900 dark:bg-purple-950",
+        "mx-4 my-2 flex flex-col gap-4 rounded-lg border border-purple-200 bg-purple-50 p-6",
         className,
       )}
     >
@@ -40,13 +41,10 @@ export function AgentCarouselMessage({
           <List size={24} weight="bold" className="text-white" />
         </div>
         <div>
-          <Text variant="h3" className="text-purple-900 dark:text-purple-100">
+          <Text variant="h3" className="text-purple-900">
             Found {displayCount} {displayCount === 1 ? "Agent" : "Agents"}
           </Text>
-          <Text
-            variant="small"
-            className="text-purple-700 dark:text-purple-300"
-          >
+          <Text variant="small" className="text-purple-700">
             Select an agent to view details or run it
           </Text>
         </div>
@@ -57,40 +55,49 @@ export function AgentCarouselMessage({
         {agents.map((agent) => (
           <Card
             key={agent.id}
-            className="border border-purple-200 bg-white p-4 dark:border-purple-800 dark:bg-purple-900"
+            className="border border-purple-200 bg-white p-4"
           >
             <div className="flex gap-3">
-              <div className="flex h-10 w-10 flex-shrink-0 items-center justify-center rounded-lg bg-purple-100 dark:bg-purple-800">
-                <Robot size={20} weight="bold" className="text-purple-600" />
+              <div className="relative h-10 w-10 flex-shrink-0 overflow-hidden rounded-lg bg-purple-100">
+                {agent.image_url ? (
+                  <Image
+                    src={agent.image_url}
+                    alt={`${agent.name} preview image`}
+                    fill
+                    className="object-cover"
+                  />
+                ) : (
+                  <div className="flex h-full w-full items-center justify-center">
+                    <Robot
+                      size={20}
+                      weight="bold"
+                      className="text-purple-600"
+                    />
+                  </div>
+                )}
               </div>
               <div className="flex-1 space-y-2">
                 <div>
                   <Text
                     variant="body"
-                    className="font-semibold text-purple-900 dark:text-purple-100"
+                    className="font-semibold text-purple-900"
                   >
                     {agent.name}
                   </Text>
                   {agent.version && (
-                    <Text
-                      variant="small"
-                      className="text-purple-600 dark:text-purple-400"
-                    >
+                    <Text variant="small" className="text-purple-600">
                       v{agent.version}
                     </Text>
                   )}
                 </div>
-                <Text
-                  variant="small"
-                  className="line-clamp-2 text-purple-700 dark:text-purple-300"
-                >
+                <Text variant="small" className="line-clamp-2 text-purple-700">
                   {agent.description}
                 </Text>
                 {onSelectAgent && (
                   <Button
                     onClick={() => onSelectAgent(agent.id)}
                     variant="ghost"
-                    className="mt-2 flex items-center gap-1 p-0 text-sm text-purple-600 hover:text-purple-800 dark:text-purple-400 dark:hover:text-purple-200"
+                    className="mt-2 flex items-center gap-1 p-0 text-sm text-purple-600 hover:text-purple-800"
                   >
                     View details
                     <ArrowRight size={16} weight="bold" />
@@ -103,10 +110,7 @@ export function AgentCarouselMessage({
       </div>
 
       {totalCount && totalCount > agents.length && (
-        <Text
-          variant="small"
-          className="text-center text-purple-600 dark:text-purple-400"
-        >
+        <Text variant="small" className="text-center text-purple-600">
           Showing {agents.length} of {totalCount} results
         </Text>
       )}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/AgentInputsSetup/AgentInputsSetup.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/AgentInputsSetup/AgentInputsSetup.tsx
new file mode 100644
index 0000000000..3ef71eca09
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/AgentInputsSetup/AgentInputsSetup.tsx
@@ -0,0 +1,246 @@
+"use client";
+
+import { Button } from "@/components/atoms/Button/Button";
+import { Card } from "@/components/atoms/Card/Card";
+import { Text } from "@/components/atoms/Text/Text";
+import { CredentialsInput } from "@/components/contextual/CredentialsInput/CredentialsInput";
+import { RunAgentInputs } from "@/components/contextual/RunAgentInputs/RunAgentInputs";
+
+import type { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
+import {
+  BlockIOCredentialsSubSchema,
+  BlockIOSubSchema,
+} from "@/lib/autogpt-server-api/types";
+import { cn, isEmpty } from "@/lib/utils";
+import { PlayIcon, WarningIcon } from "@phosphor-icons/react";
+import { useMemo } from "react";
+import { useAgentInputsSetup } from "./useAgentInputsSetup";
+
+type LibraryAgentInputSchemaProperties = LibraryAgent["input_schema"] extends {
+  properties: infer P;
+}
+  ? P extends Record<string, BlockIOSubSchema>
+    ? P
+    : Record<string, BlockIOSubSchema>
+  : Record<string, BlockIOSubSchema>;
+
+type LibraryAgentCredentialsInputSchemaProperties =
+  LibraryAgent["credentials_input_schema"] extends {
+    properties: infer P;
+  }
+    ? P extends Record<string, BlockIOCredentialsSubSchema>
+      ? P
+      : Record<string, BlockIOCredentialsSubSchema>
+    : Record<string, BlockIOCredentialsSubSchema>;
+
+interface Props {
+  agentName?: string;
+  inputSchema: LibraryAgentInputSchemaProperties | Record<string, any>;
+  credentialsSchema?:
+    | LibraryAgentCredentialsInputSchemaProperties
+    | Record<string, any>;
+  message: string;
+  requiredFields?: string[];
+  onRun: (
+    inputs: Record<string, any>,
+    credentials: Record<string, any>,
+  ) => void;
+  onCancel?: () => void;
+  className?: string;
+}
+
+export function AgentInputsSetup({
+  agentName,
+  inputSchema,
+  credentialsSchema,
+  message,
+  requiredFields,
+  onRun,
+  onCancel,
+  className,
+}: Props) {
+  const { inputValues, setInputValue, credentialsValues, setCredentialsValue } =
+    useAgentInputsSetup();
+
+  const inputSchemaObj = useMemo(() => {
+    if (!inputSchema) return { properties: {}, required: [] };
+    if ("properties" in inputSchema && "type" in inputSchema) {
+      return inputSchema as {
+        properties: Record<string, any>;
+        required?: string[];
+      };
+    }
+    return { properties: inputSchema as Record<string, any>, required: [] };
+  }, [inputSchema]);
+
+  const credentialsSchemaObj = useMemo(() => {
+    if (!credentialsSchema) return { properties: {}, required: [] };
+    if ("properties" in credentialsSchema && "type" in credentialsSchema) {
+      return credentialsSchema as {
+        properties: Record<string, any>;
+        required?: string[];
+      };
+    }
+    return {
+      properties: credentialsSchema as Record<string, any>,
+      required: [],
+    };
+  }, [credentialsSchema]);
+
+  const agentInputFields = useMemo(() => {
+    const properties = inputSchemaObj.properties || {};
+    return Object.fromEntries(
+      Object.entries(properties).filter(
+        ([_, subSchema]: [string, any]) => !subSchema.hidden,
+      ),
+    );
+  }, [inputSchemaObj]);
+
+  const agentCredentialsInputFields = useMemo(() => {
+    return credentialsSchemaObj.properties || {};
+  }, [credentialsSchemaObj]);
+
+  const inputFields = Object.entries(agentInputFields);
+  const credentialFields = Object.entries(agentCredentialsInputFields);
+
+  const defaultsFromSchema = useMemo(() => {
+    const defaults: Record<string, any> = {};
+    Object.entries(agentInputFields).forEach(([key, schema]) => {
+      if ("default" in schema && schema.default !== undefined) {
+        defaults[key] = schema.default;
+      }
+    });
+    return defaults;
+  }, [agentInputFields]);
+
+  const defaultsFromCredentialsSchema = useMemo(() => {
+    const defaults: Record<string, any> = {};
+    Object.entries(agentCredentialsInputFields).forEach(([key, schema]) => {
+      if ("default" in schema && schema.default !== undefined) {
+        defaults[key] = schema.default;
+      }
+    });
+    return defaults;
+  }, [agentCredentialsInputFields]);
+
+  const mergedInputValues = useMemo(() => {
+    return { ...defaultsFromSchema, ...inputValues };
+  }, [defaultsFromSchema, inputValues]);
+
+  const mergedCredentialsValues = useMemo(() => {
+    return { ...defaultsFromCredentialsSchema, ...credentialsValues };
+  }, [defaultsFromCredentialsSchema, credentialsValues]);
+
+  const allRequiredInputsAreSet = useMemo(() => {
+    const requiredInputs = new Set(
+      requiredFields || (inputSchemaObj.required as string[]) || [],
+    );
+    const nonEmptyInputs = new Set(
+      Object.keys(mergedInputValues).filter(
+        (k) => !isEmpty(mergedInputValues[k]),
+      ),
+    );
+    const missing = [...requiredInputs].filter(
+      (input) => !nonEmptyInputs.has(input),
+    );
+    return missing.length === 0;
+  }, [inputSchemaObj.required, mergedInputValues, requiredFields]);
+
+  const allCredentialsAreSet = useMemo(() => {
+    const requiredCredentials = new Set(
+      (credentialsSchemaObj.required as string[]) || [],
+    );
+    if (requiredCredentials.size === 0) {
+      return true;
+    }
+    const missing = [...requiredCredentials].filter((key) => {
+      const cred = mergedCredentialsValues[key];
+      return !cred || !cred.id;
+    });
+    return missing.length === 0;
+  }, [credentialsSchemaObj.required, mergedCredentialsValues]);
+
+  const canRun = allRequiredInputsAreSet && allCredentialsAreSet;
+
+  function handleRun() {
+    if (canRun) {
+      onRun(mergedInputValues, mergedCredentialsValues);
+    }
+  }
+
+  return (
+    <Card
+      className={cn(
+        "mx-4 my-2 overflow-hidden border-blue-200 bg-blue-50",
+        className,
+      )}
+    >
+      <div className="flex items-start gap-4 p-6">
+        <div className="flex h-12 w-12 flex-shrink-0 items-center justify-center rounded-full bg-blue-500">
+          <WarningIcon size={24} weight="bold" className="text-white" />
+        </div>
+        <div className="flex-1">
+          <Text variant="h3" className="mb-2 text-blue-900">
+            {agentName ? `Configure ${agentName}` : "Agent Configuration"}
+          </Text>
+          <Text variant="body" className="mb-4 text-blue-700">
+            {message}
+          </Text>
+
+          {inputFields.length > 0 && (
+            <div className="mb-4 space-y-4">
+              {inputFields.map(([key, inputSubSchema]) => (
+                <RunAgentInputs
+                  key={key}
+                  schema={inputSubSchema}
+                  value={inputValues[key] ?? inputSubSchema.default}
+                  placeholder={inputSubSchema.description}
+                  onChange={(value) => setInputValue(key, value)}
+                />
+              ))}
+            </div>
+          )}
+
+          {credentialFields.length > 0 && (
+            <div className="mb-4 space-y-4">
+              {credentialFields.map(([key, schema]) => {
+                const requiredCredentials = new Set(
+                  (credentialsSchemaObj.required as string[]) || [],
+                );
+                return (
+                  <CredentialsInput
+                    key={key}
+                    schema={schema}
+                    selectedCredentials={credentialsValues[key]}
+                    onSelectCredentials={(value) =>
+                      setCredentialsValue(key, value)
+                    }
+                    siblingInputs={mergedInputValues}
+                    isOptional={!requiredCredentials.has(key)}
+                  />
+                );
+              })}
+            </div>
+          )}
+
+          <div className="flex gap-2">
+            <Button
+              variant="primary"
+              size="small"
+              onClick={handleRun}
+              disabled={!canRun}
+            >
+              <PlayIcon className="mr-2 h-4 w-4" weight="bold" />
+              Run Agent
+            </Button>
+            {onCancel && (
+              <Button variant="outline" size="small" onClick={onCancel}>
+                Cancel
+              </Button>
+            )}
+          </div>
+        </div>
+      </div>
+    </Card>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/AgentInputsSetup/useAgentInputsSetup.ts b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/AgentInputsSetup/useAgentInputsSetup.ts
new file mode 100644
index 0000000000..e36a3f3c5d
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/AgentInputsSetup/useAgentInputsSetup.ts
@@ -0,0 +1,38 @@
+import type { CredentialsMetaInput } from "@/lib/autogpt-server-api/types";
+import { useState } from "react";
+
+export function useAgentInputsSetup() {
+  const [inputValues, setInputValues] = useState<Record<string, any>>({});
+  const [credentialsValues, setCredentialsValues] = useState<
+    Record<string, CredentialsMetaInput>
+  >({});
+
+  function setInputValue(key: string, value: any) {
+    setInputValues((prev) => ({
+      ...prev,
+      [key]: value,
+    }));
+  }
+
+  function setCredentialsValue(key: string, value?: CredentialsMetaInput) {
+    if (value) {
+      setCredentialsValues((prev) => ({
+        ...prev,
+        [key]: value,
+      }));
+    } else {
+      setCredentialsValues((prev) => {
+        const next = { ...prev };
+        delete next[key];
+        return next;
+      });
+    }
+  }
+
+  return {
+    inputValues,
+    setInputValue,
+    credentialsValues,
+    setCredentialsValue,
+  };
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/AuthPromptWidget/AuthPromptWidget.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/AuthPromptWidget/AuthPromptWidget.tsx
similarity index 84%
rename from autogpt_platform/frontend/src/app/(platform)/chat/components/AuthPromptWidget/AuthPromptWidget.tsx
rename to autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/AuthPromptWidget/AuthPromptWidget.tsx
index 885a06e92a..33f02e660f 100644
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/AuthPromptWidget/AuthPromptWidget.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/AuthPromptWidget/AuthPromptWidget.tsx
@@ -1,10 +1,9 @@
 "use client";
 
-import React from "react";
-import { useRouter } from "next/navigation";
 import { Button } from "@/components/atoms/Button/Button";
-import { SignInIcon, UserPlusIcon, ShieldIcon } from "@phosphor-icons/react";
 import { cn } from "@/lib/utils";
+import { ShieldIcon, SignInIcon, UserPlusIcon } from "@phosphor-icons/react";
+import { useRouter } from "next/navigation";
 
 export interface AuthPromptWidgetProps {
   message: string;
@@ -54,8 +53,8 @@ export function AuthPromptWidget({
   return (
     <div
       className={cn(
-        "my-4 overflow-hidden rounded-lg border border-violet-200 dark:border-violet-800",
-        "bg-gradient-to-br from-violet-50 to-purple-50 dark:from-violet-950/30 dark:to-purple-950/30",
+        "my-4 overflow-hidden rounded-lg border border-violet-200",
+        "bg-gradient-to-br from-violet-50 to-purple-50",
         "duration-500 animate-in fade-in-50 slide-in-from-bottom-2",
         className,
       )}
@@ -66,21 +65,19 @@ export function AuthPromptWidget({
             <ShieldIcon size={20} weight="fill" className="text-white" />
           </div>
           <div>
-            <h3 className="text-lg font-semibold text-neutral-900 dark:text-neutral-100">
+            <h3 className="text-lg font-semibold text-neutral-900">
               Authentication Required
             </h3>
-            <p className="text-sm text-neutral-600 dark:text-neutral-400">
+            <p className="text-sm text-neutral-600">
               Sign in to set up and manage agents
             </p>
           </div>
         </div>
 
-        <div className="mb-5 rounded-md bg-white/50 p-4 dark:bg-neutral-900/50">
-          <p className="text-sm text-neutral-700 dark:text-neutral-300">
-            {message}
-          </p>
+        <div className="mb-5 rounded-md bg-white/50 p-4">
+          <p className="text-sm text-neutral-700">{message}</p>
           {agentInfo && (
-            <div className="mt-3 text-xs text-neutral-600 dark:text-neutral-400">
+            <div className="mt-3 text-xs text-neutral-600">
               <p>
                 Ready to set up:{" "}
                 <span className="font-medium">{agentInfo.name}</span>
@@ -114,7 +111,7 @@ export function AuthPromptWidget({
           </Button>
         </div>
 
-        <div className="mt-4 text-center text-xs text-neutral-500 dark:text-neutral-500">
+        <div className="mt-4 text-center text-xs text-neutral-500">
           Your chat session will be preserved after signing in
         </div>
       </div>
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatContainer/ChatContainer.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatContainer/ChatContainer.tsx
new file mode 100644
index 0000000000..6f7a0e8f51
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatContainer/ChatContainer.tsx
@@ -0,0 +1,88 @@
+import type { SessionDetailResponse } from "@/app/api/__generated__/models/sessionDetailResponse";
+import { cn } from "@/lib/utils";
+import { useCallback } from "react";
+import { usePageContext } from "../../usePageContext";
+import { ChatInput } from "../ChatInput/ChatInput";
+import { MessageList } from "../MessageList/MessageList";
+import { QuickActionsWelcome } from "../QuickActionsWelcome/QuickActionsWelcome";
+import { useChatContainer } from "./useChatContainer";
+
+export interface ChatContainerProps {
+  sessionId: string | null;
+  initialMessages: SessionDetailResponse["messages"];
+  className?: string;
+}
+
+export function ChatContainer({
+  sessionId,
+  initialMessages,
+  className,
+}: ChatContainerProps) {
+  const { messages, streamingChunks, isStreaming, sendMessage } =
+    useChatContainer({
+      sessionId,
+      initialMessages,
+    });
+  const { capturePageContext } = usePageContext();
+
+  // Wrap sendMessage to automatically capture page context
+  const sendMessageWithContext = useCallback(
+    async (content: string, isUserMessage: boolean = true) => {
+      const context = capturePageContext();
+      await sendMessage(content, isUserMessage, context);
+    },
+    [sendMessage, capturePageContext],
+  );
+
+  const quickActions = [
+    "Find agents for social media management",
+    "Show me agents for content creation",
+    "Help me automate my business",
+    "What can you help me with?",
+  ];
+
+  return (
+    <div
+      className={cn("flex h-full min-h-0 flex-col", className)}
+      style={{
+        backgroundColor: "#ffffff",
+        backgroundImage:
+          "radial-gradient(#e5e5e5 0.5px, transparent 0.5px), radial-gradient(#e5e5e5 0.5px, #ffffff 0.5px)",
+        backgroundSize: "20px 20px",
+        backgroundPosition: "0 0, 10px 10px",
+      }}
+    >
+      {/* Messages or Welcome Screen */}
+      <div className="flex min-h-0 flex-1 flex-col overflow-hidden pb-24">
+        {messages.length === 0 ? (
+          <QuickActionsWelcome
+            title="Welcome to AutoGPT Copilot"
+            description="Start a conversation to discover and run AI agents."
+            actions={quickActions}
+            onActionClick={sendMessageWithContext}
+            disabled={isStreaming || !sessionId}
+          />
+        ) : (
+          <MessageList
+            messages={messages}
+            streamingChunks={streamingChunks}
+            isStreaming={isStreaming}
+            onSendMessage={sendMessageWithContext}
+            className="flex-1"
+          />
+        )}
+      </div>
+
+      {/* Input - Always visible */}
+      <div className="fixed bottom-0 left-0 right-0 z-50 border-t border-zinc-200 bg-white p-4">
+        <ChatInput
+          onSend={sendMessageWithContext}
+          disabled={isStreaming || !sessionId}
+          placeholder={
+            sessionId ? "Type your message..." : "Creating session..."
+          }
+        />
+      </div>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatContainer/createStreamEventDispatcher.ts b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatContainer/createStreamEventDispatcher.ts
similarity index 95%
rename from autogpt_platform/frontend/src/app/(platform)/chat/components/ChatContainer/createStreamEventDispatcher.ts
rename to autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatContainer/createStreamEventDispatcher.ts
index b8421c3386..844f126d49 100644
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatContainer/createStreamEventDispatcher.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatContainer/createStreamEventDispatcher.ts
@@ -1,14 +1,14 @@
 import { toast } from "sonner";
-import type { StreamChunk } from "@/app/(platform)/chat/useChatStream";
+import { StreamChunk } from "../../useChatStream";
 import type { HandlerDependencies } from "./useChatContainer.handlers";
 import {
+  handleError,
+  handleLoginNeeded,
+  handleStreamEnd,
   handleTextChunk,
   handleTextEnded,
   handleToolCallStart,
   handleToolResponse,
-  handleLoginNeeded,
-  handleStreamEnd,
-  handleError,
 } from "./useChatContainer.handlers";
 
 export function createStreamEventDispatcher(
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatContainer/helpers.ts b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatContainer/helpers.ts
similarity index 68%
rename from autogpt_platform/frontend/src/app/(platform)/chat/components/ChatContainer/helpers.ts
rename to autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatContainer/helpers.ts
index 3a94dab1ea..cd05563369 100644
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatContainer/helpers.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatContainer/helpers.ts
@@ -1,5 +1,24 @@
-import type { ChatMessageData } from "@/app/(platform)/chat/components/ChatMessage/useChatMessage";
 import type { ToolResult } from "@/types/chat";
+import type { ChatMessageData } from "../ChatMessage/useChatMessage";
+
+export function removePageContext(content: string): string {
+  // Remove "Page URL: ..." pattern at start of line (case insensitive, handles various formats)
+  let cleaned = content.replace(/^\s*Page URL:\s*[^\n\r]*/gim, "");
+
+  // Find "User Message:" marker at start of line to preserve the actual user message
+  const userMessageMatch = cleaned.match(/^\s*User Message:\s*([\s\S]*)$/im);
+  if (userMessageMatch) {
+    // If we found "User Message:", extract everything after it
+    cleaned = userMessageMatch[1];
+  } else {
+    // If no "User Message:" marker, remove "Page Content:" and everything after it at start of line
+    cleaned = cleaned.replace(/^\s*Page Content:[\s\S]*$/gim, "");
+  }
+
+  // Clean up extra whitespace and newlines
+  cleaned = cleaned.replace(/\n\s*\n\s*\n+/g, "\n\n").trim();
+  return cleaned;
+}
 
 export function createUserMessage(content: string): ChatMessageData {
   return {
@@ -63,6 +82,7 @@ export function isAgentArray(value: unknown): value is Array<{
   name: string;
   description: string;
   version?: number;
+  image_url?: string;
 }> {
   if (!Array.isArray(value)) {
     return false;
@@ -77,7 +97,8 @@ export function isAgentArray(value: unknown): value is Array<{
       typeof item.name === "string" &&
       "description" in item &&
       typeof item.description === "string" &&
-      (!("version" in item) || typeof item.version === "number"),
+      (!("version" in item) || typeof item.version === "number") &&
+      (!("image_url" in item) || typeof item.image_url === "string"),
   );
 }
 
@@ -232,6 +253,7 @@ export function isSetupInfo(value: unknown): value is {
 
 export function extractCredentialsNeeded(
   parsedResult: Record<string, unknown>,
+  toolName: string = "run_agent",
 ): ChatMessageData | null {
   try {
     const setupInfo = parsedResult?.setup_info as
@@ -244,7 +266,7 @@ export function extractCredentialsNeeded(
       | Record<string, Record<string, unknown>>
       | undefined;
     if (missingCreds && Object.keys(missingCreds).length > 0) {
-      const agentName = (setupInfo?.agent_name as string) || "this agent";
+      const agentName = (setupInfo?.agent_name as string) || "this block";
       const credentials = Object.values(missingCreds).map((credInfo) => ({
         provider: (credInfo.provider as string) || "unknown",
         providerName:
@@ -264,7 +286,7 @@ export function extractCredentialsNeeded(
       }));
       return {
         type: "credentials_needed",
-        toolName: "run_agent",
+        toolName,
         credentials,
         message: `To run ${agentName}, you need to add ${credentials.length === 1 ? "credentials" : `${credentials.length} credentials`}.`,
         agentName,
@@ -277,3 +299,92 @@ export function extractCredentialsNeeded(
     return null;
   }
 }
+
+export function extractInputsNeeded(
+  parsedResult: Record<string, unknown>,
+  toolName: string = "run_agent",
+): ChatMessageData | null {
+  try {
+    const setupInfo = parsedResult?.setup_info as
+      | Record<string, unknown>
+      | undefined;
+    const requirements = setupInfo?.requirements as
+      | Record<string, unknown>
+      | undefined;
+    const inputs = requirements?.inputs as
+      | Array<Record<string, unknown>>
+      | undefined;
+    const credentials = requirements?.credentials as
+      | Array<Record<string, unknown>>
+      | undefined;
+
+    if (!inputs || inputs.length === 0) {
+      return null;
+    }
+
+    const agentName = (setupInfo?.agent_name as string) || "this agent";
+    const agentId = parsedResult?.graph_id as string | undefined;
+    const graphVersion = parsedResult?.graph_version as number | undefined;
+
+    const properties: Record<string, any> = {};
+    const requiredProps: string[] = [];
+    inputs.forEach((input) => {
+      const name = input.name as string;
+      if (name) {
+        properties[name] = {
+          title: input.name as string,
+          description: (input.description as string) || "",
+          type: (input.type as string) || "string",
+          default: input.default,
+          enum: input.options,
+          format: input.format,
+        };
+        if ((input.required as boolean) === true) {
+          requiredProps.push(name);
+        }
+      }
+    });
+
+    const inputSchema: Record<string, any> = {
+      type: "object",
+      properties,
+    };
+    if (requiredProps.length > 0) {
+      inputSchema.required = requiredProps;
+    }
+
+    const credentialsSchema: Record<string, any> = {};
+    if (credentials && credentials.length > 0) {
+      credentials.forEach((cred) => {
+        const id = cred.id as string;
+        if (id) {
+          credentialsSchema[id] = {
+            type: "object",
+            properties: {},
+            credentials_provider: [cred.provider as string],
+            credentials_types: [(cred.type as string) || "api_key"],
+            credentials_scopes: cred.scopes as string[] | undefined,
+          };
+        }
+      });
+    }
+
+    return {
+      type: "inputs_needed",
+      toolName,
+      agentName,
+      agentId,
+      graphVersion,
+      inputSchema,
+      credentialsSchema:
+        Object.keys(credentialsSchema).length > 0
+          ? credentialsSchema
+          : undefined,
+      message: `Please provide the required inputs to run ${agentName}.`,
+      timestamp: new Date(),
+    };
+  } catch (err) {
+    console.error("Failed to extract inputs from setup info:", err);
+    return null;
+  }
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatContainer/useChatContainer.handlers.ts b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatContainer/useChatContainer.handlers.ts
similarity index 85%
rename from autogpt_platform/frontend/src/app/(platform)/chat/components/ChatContainer/useChatContainer.handlers.ts
rename to autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatContainer/useChatContainer.handlers.ts
index fdbecb5d61..064b847064 100644
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatContainer/useChatContainer.handlers.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatContainer/useChatContainer.handlers.ts
@@ -1,13 +1,18 @@
-import type { Dispatch, SetStateAction, MutableRefObject } from "react";
-import type { StreamChunk } from "@/app/(platform)/chat/useChatStream";
-import type { ChatMessageData } from "@/app/(platform)/chat/components/ChatMessage/useChatMessage";
-import { parseToolResponse, extractCredentialsNeeded } from "./helpers";
+import type { Dispatch, MutableRefObject, SetStateAction } from "react";
+import { StreamChunk } from "../../useChatStream";
+import type { ChatMessageData } from "../ChatMessage/useChatMessage";
+import {
+  extractCredentialsNeeded,
+  extractInputsNeeded,
+  parseToolResponse,
+} from "./helpers";
 
 export interface HandlerDependencies {
   setHasTextChunks: Dispatch<SetStateAction<boolean>>;
   setStreamingChunks: Dispatch<SetStateAction<string[]>>;
   streamingChunksRef: MutableRefObject<string[]>;
   setMessages: Dispatch<SetStateAction<ChatMessageData[]>>;
+  setIsStreamingInitiated: Dispatch<SetStateAction<boolean>>;
   sessionId: string;
 }
 
@@ -100,11 +105,18 @@ export function handleToolResponse(
       parsedResult = null;
     }
     if (
-      chunk.tool_name === "run_agent" &&
+      (chunk.tool_name === "run_agent" || chunk.tool_name === "run_block") &&
       chunk.success &&
       parsedResult?.type === "setup_requirements"
     ) {
-      const credentialsMessage = extractCredentialsNeeded(parsedResult);
+      const inputsMessage = extractInputsNeeded(parsedResult, chunk.tool_name);
+      if (inputsMessage) {
+        deps.setMessages((prev) => [...prev, inputsMessage]);
+      }
+      const credentialsMessage = extractCredentialsNeeded(
+        parsedResult,
+        chunk.tool_name,
+      );
       if (credentialsMessage) {
         deps.setMessages((prev) => [...prev, credentialsMessage]);
       }
@@ -197,10 +209,15 @@ export function handleStreamEnd(
   deps.setStreamingChunks([]);
   deps.streamingChunksRef.current = [];
   deps.setHasTextChunks(false);
+  deps.setIsStreamingInitiated(false);
   console.log("[Stream End] Stream complete, messages in local state");
 }
 
-export function handleError(chunk: StreamChunk, _deps: HandlerDependencies) {
+export function handleError(chunk: StreamChunk, deps: HandlerDependencies) {
   const errorMessage = chunk.message || chunk.content || "An error occurred";
   console.error("Stream error:", errorMessage);
+  deps.setIsStreamingInitiated(false);
+  deps.setHasTextChunks(false);
+  deps.setStreamingChunks([]);
+  deps.streamingChunksRef.current = [];
 }
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatContainer/useChatContainer.ts b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatContainer/useChatContainer.ts
new file mode 100644
index 0000000000..8e7dee7718
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatContainer/useChatContainer.ts
@@ -0,0 +1,206 @@
+import type { SessionDetailResponse } from "@/app/api/__generated__/models/sessionDetailResponse";
+import { useCallback, useMemo, useRef, useState } from "react";
+import { toast } from "sonner";
+import { useChatStream } from "../../useChatStream";
+import type { ChatMessageData } from "../ChatMessage/useChatMessage";
+import { createStreamEventDispatcher } from "./createStreamEventDispatcher";
+import {
+  createUserMessage,
+  filterAuthMessages,
+  isToolCallArray,
+  isValidMessage,
+  parseToolResponse,
+  removePageContext,
+} from "./helpers";
+
+interface Args {
+  sessionId: string | null;
+  initialMessages: SessionDetailResponse["messages"];
+}
+
+export function useChatContainer({ sessionId, initialMessages }: Args) {
+  const [messages, setMessages] = useState<ChatMessageData[]>([]);
+  const [streamingChunks, setStreamingChunks] = useState<string[]>([]);
+  const [hasTextChunks, setHasTextChunks] = useState(false);
+  const [isStreamingInitiated, setIsStreamingInitiated] = useState(false);
+  const streamingChunksRef = useRef<string[]>([]);
+  const { error, sendMessage: sendStreamMessage } = useChatStream();
+  const isStreaming = isStreamingInitiated || hasTextChunks;
+
+  const allMessages = useMemo(() => {
+    const processedInitialMessages: ChatMessageData[] = [];
+    // Map to track tool calls by their ID so we can look up tool names for tool responses
+    const toolCallMap = new Map<string, string>();
+
+    for (const msg of initialMessages) {
+      if (!isValidMessage(msg)) {
+        console.warn("Invalid message structure from backend:", msg);
+        continue;
+      }
+
+      let content = String(msg.content || "");
+      const role = String(msg.role || "assistant").toLowerCase();
+      const toolCalls = msg.tool_calls;
+      const timestamp = msg.timestamp
+        ? new Date(msg.timestamp as string)
+        : undefined;
+
+      // Remove page context from user messages when loading existing sessions
+      if (role === "user") {
+        content = removePageContext(content);
+        // Skip user messages that become empty after removing page context
+        if (!content.trim()) {
+          continue;
+        }
+        processedInitialMessages.push({
+          type: "message",
+          role: "user",
+          content,
+          timestamp,
+        });
+        continue;
+      }
+
+      // Handle assistant messages first (before tool messages) to build tool call map
+      if (role === "assistant") {
+        // Strip <thinking> tags from content
+        content = content
+          .replace(/<thinking>[\s\S]*?<\/thinking>/gi, "")
+          .trim();
+
+        // If assistant has tool calls, create tool_call messages for each
+        if (toolCalls && isToolCallArray(toolCalls) && toolCalls.length > 0) {
+          for (const toolCall of toolCalls) {
+            const toolName = toolCall.function.name;
+            const toolId = toolCall.id;
+            // Store tool name for later lookup
+            toolCallMap.set(toolId, toolName);
+
+            try {
+              const args = JSON.parse(toolCall.function.arguments || "{}");
+              processedInitialMessages.push({
+                type: "tool_call",
+                toolId,
+                toolName,
+                arguments: args,
+                timestamp,
+              });
+            } catch (err) {
+              console.warn("Failed to parse tool call arguments:", err);
+              processedInitialMessages.push({
+                type: "tool_call",
+                toolId,
+                toolName,
+                arguments: {},
+                timestamp,
+              });
+            }
+          }
+          // Only add assistant message if there's content after stripping thinking tags
+          if (content.trim()) {
+            processedInitialMessages.push({
+              type: "message",
+              role: "assistant",
+              content,
+              timestamp,
+            });
+          }
+        } else if (content.trim()) {
+          // Assistant message without tool calls, but with content
+          processedInitialMessages.push({
+            type: "message",
+            role: "assistant",
+            content,
+            timestamp,
+          });
+        }
+        continue;
+      }
+
+      // Handle tool messages - look up tool name from tool call map
+      if (role === "tool") {
+        const toolCallId = (msg.tool_call_id as string) || "";
+        const toolName = toolCallMap.get(toolCallId) || "unknown";
+        const toolResponse = parseToolResponse(
+          content,
+          toolCallId,
+          toolName,
+          timestamp,
+        );
+        if (toolResponse) {
+          processedInitialMessages.push(toolResponse);
+        }
+        continue;
+      }
+
+      // Handle other message types (system, etc.)
+      if (content.trim()) {
+        processedInitialMessages.push({
+          type: "message",
+          role: role as "user" | "assistant" | "system",
+          content,
+          timestamp,
+        });
+      }
+    }
+
+    return [...processedInitialMessages, ...messages];
+  }, [initialMessages, messages]);
+
+  const sendMessage = useCallback(
+    async function sendMessage(
+      content: string,
+      isUserMessage: boolean = true,
+      context?: { url: string; content: string },
+    ) {
+      if (!sessionId) {
+        console.error("Cannot send message: no session ID");
+        return;
+      }
+      if (isUserMessage) {
+        const userMessage = createUserMessage(content);
+        setMessages((prev) => [...filterAuthMessages(prev), userMessage]);
+      } else {
+        setMessages((prev) => filterAuthMessages(prev));
+      }
+      setStreamingChunks([]);
+      streamingChunksRef.current = [];
+      setHasTextChunks(false);
+      setIsStreamingInitiated(true);
+      const dispatcher = createStreamEventDispatcher({
+        setHasTextChunks,
+        setStreamingChunks,
+        streamingChunksRef,
+        setMessages,
+        sessionId,
+        setIsStreamingInitiated,
+      });
+      try {
+        await sendStreamMessage(
+          sessionId,
+          content,
+          dispatcher,
+          isUserMessage,
+          context,
+        );
+      } catch (err) {
+        console.error("Failed to send message:", err);
+        setIsStreamingInitiated(false);
+        const errorMessage =
+          err instanceof Error ? err.message : "Failed to send message";
+        toast.error("Failed to send message", {
+          description: errorMessage,
+        });
+      }
+    },
+    [sessionId, sendStreamMessage],
+  );
+
+  return {
+    messages: allMessages,
+    streamingChunks,
+    isStreaming,
+    error,
+    sendMessage,
+  };
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatCredentialsSetup/ChatCredentialsSetup.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatCredentialsSetup/ChatCredentialsSetup.tsx
new file mode 100644
index 0000000000..4b9da57286
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatCredentialsSetup/ChatCredentialsSetup.tsx
@@ -0,0 +1,149 @@
+import { Text } from "@/components/atoms/Text/Text";
+import { CredentialsInput } from "@/components/contextual/CredentialsInput/CredentialsInput";
+import type { BlockIOCredentialsSubSchema } from "@/lib/autogpt-server-api";
+import { cn } from "@/lib/utils";
+import { CheckIcon, RobotIcon, WarningIcon } from "@phosphor-icons/react";
+import { useEffect, useRef } from "react";
+import { useChatCredentialsSetup } from "./useChatCredentialsSetup";
+
+export interface CredentialInfo {
+  provider: string;
+  providerName: string;
+  credentialType: "api_key" | "oauth2" | "user_password" | "host_scoped";
+  title: string;
+  scopes?: string[];
+}
+
+interface Props {
+  credentials: CredentialInfo[];
+  agentName?: string;
+  message: string;
+  onAllCredentialsComplete: () => void;
+  onCancel: () => void;
+  className?: string;
+}
+
+function createSchemaFromCredentialInfo(
+  credential: CredentialInfo,
+): BlockIOCredentialsSubSchema {
+  return {
+    type: "object",
+    properties: {},
+    credentials_provider: [credential.provider],
+    credentials_types: [credential.credentialType],
+    credentials_scopes: credential.scopes,
+    discriminator: undefined,
+    discriminator_mapping: undefined,
+    discriminator_values: undefined,
+  };
+}
+
+export function ChatCredentialsSetup({
+  credentials,
+  agentName: _agentName,
+  message,
+  onAllCredentialsComplete,
+  onCancel: _onCancel,
+}: Props) {
+  const { selectedCredentials, isAllComplete, handleCredentialSelect } =
+    useChatCredentialsSetup(credentials);
+
+  // Track if we've already called completion to prevent double calls
+  const hasCalledCompleteRef = useRef(false);
+
+  // Reset the completion flag when credentials change (new credential setup flow)
+  useEffect(
+    function resetCompletionFlag() {
+      hasCalledCompleteRef.current = false;
+    },
+    [credentials],
+  );
+
+  // Auto-call completion when all credentials are configured
+  useEffect(
+    function autoCompleteWhenReady() {
+      if (isAllComplete && !hasCalledCompleteRef.current) {
+        hasCalledCompleteRef.current = true;
+        onAllCredentialsComplete();
+      }
+    },
+    [isAllComplete, onAllCredentialsComplete],
+  );
+
+  return (
+    <div className="group relative flex w-full justify-start gap-3 px-4 py-3">
+      <div className="flex w-full max-w-3xl gap-3">
+        <div className="flex-shrink-0">
+          <div className="flex h-7 w-7 items-center justify-center rounded-lg bg-indigo-500">
+            <RobotIcon className="h-4 w-4 text-indigo-50" />
+          </div>
+        </div>
+
+        <div className="flex min-w-0 flex-1 flex-col">
+          <div className="group relative min-w-20 overflow-hidden rounded-xl border border-slate-100 bg-slate-50/20 px-6 py-2.5 text-sm leading-relaxed backdrop-blur-xl">
+            <div className="absolute inset-0 bg-gradient-to-br from-slate-200/20 via-slate-300/10 to-transparent" />
+            <div className="relative z-10 space-y-3 text-slate-900">
+              <div>
+                <Text variant="h4" className="mb-1 text-slate-900">
+                  Credentials Required
+                </Text>
+                <Text variant="small" className="text-slate-600">
+                  {message}
+                </Text>
+              </div>
+
+              <div className="space-y-3">
+                {credentials.map((cred, index) => {
+                  const schema = createSchemaFromCredentialInfo(cred);
+                  const isSelected = !!selectedCredentials[cred.provider];
+
+                  return (
+                    <div
+                      key={`${cred.provider}-${index}`}
+                      className={cn(
+                        "relative rounded-lg border p-3",
+                        isSelected
+                          ? "border-green-500 bg-green-50/50"
+                          : "border-slate-200 bg-white/50",
+                      )}
+                    >
+                      <div className="mb-2 flex items-center gap-2">
+                        {isSelected ? (
+                          <CheckIcon
+                            size={16}
+                            className="text-green-500"
+                            weight="bold"
+                          />
+                        ) : (
+                          <WarningIcon
+                            size={16}
+                            className="text-slate-500"
+                            weight="bold"
+                          />
+                        )}
+                        <Text
+                          variant="small"
+                          className="font-semibold text-slate-900"
+                        >
+                          {cred.providerName}
+                        </Text>
+                      </div>
+
+                      <CredentialsInput
+                        schema={schema}
+                        selectedCredentials={selectedCredentials[cred.provider]}
+                        onSelectCredentials={(credMeta) =>
+                          handleCredentialSelect(cred.provider, credMeta)
+                        }
+                      />
+                    </div>
+                  );
+                })}
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatCredentialsSetup/useChatCredentialsSetup.ts b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatCredentialsSetup/useChatCredentialsSetup.ts
similarity index 100%
rename from autogpt_platform/frontend/src/app/(platform)/chat/components/ChatCredentialsSetup/useChatCredentialsSetup.ts
rename to autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatCredentialsSetup/useChatCredentialsSetup.ts
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatErrorState/ChatErrorState.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatErrorState/ChatErrorState.tsx
similarity index 100%
rename from autogpt_platform/frontend/src/app/(platform)/chat/components/ChatErrorState/ChatErrorState.tsx
rename to autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatErrorState/ChatErrorState.tsx
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatInput/ChatInput.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatInput/ChatInput.tsx
new file mode 100644
index 0000000000..3101174a11
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatInput/ChatInput.tsx
@@ -0,0 +1,64 @@
+import { Input } from "@/components/atoms/Input/Input";
+import { cn } from "@/lib/utils";
+import { ArrowUpIcon } from "@phosphor-icons/react";
+import { useChatInput } from "./useChatInput";
+
+export interface ChatInputProps {
+  onSend: (message: string) => void;
+  disabled?: boolean;
+  placeholder?: string;
+  className?: string;
+}
+
+export function ChatInput({
+  onSend,
+  disabled = false,
+  placeholder = "Type your message...",
+  className,
+}: ChatInputProps) {
+  const inputId = "chat-input";
+  const { value, setValue, handleKeyDown, handleSend } = useChatInput({
+    onSend,
+    disabled,
+    maxRows: 5,
+    inputId,
+  });
+
+  return (
+    <div className={cn("relative flex-1", className)}>
+      <Input
+        id={inputId}
+        label="Chat message input"
+        hideLabel
+        type="textarea"
+        value={value}
+        onChange={(e) => setValue(e.target.value)}
+        onKeyDown={handleKeyDown}
+        placeholder={placeholder}
+        disabled={disabled}
+        rows={1}
+        wrapperClassName="mb-0 relative"
+        className="pr-12"
+      />
+      <span id="chat-input-hint" className="sr-only">
+        Press Enter to send, Shift+Enter for new line
+      </span>
+
+      <button
+        onClick={handleSend}
+        disabled={disabled || !value.trim()}
+        className={cn(
+          "absolute right-3 top-1/2 flex h-8 w-8 -translate-y-1/2 items-center justify-center rounded-full",
+          "border border-zinc-800 bg-zinc-800 text-white",
+          "hover:border-zinc-900 hover:bg-zinc-900",
+          "disabled:border-zinc-200 disabled:bg-zinc-200 disabled:text-white disabled:opacity-50",
+          "transition-colors focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-neutral-950",
+          "disabled:pointer-events-none",
+        )}
+        aria-label="Send message"
+      >
+        <ArrowUpIcon className="h-3 w-3" weight="bold" />
+      </button>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatInput/useChatInput.ts b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatInput/useChatInput.ts
similarity index 65%
rename from autogpt_platform/frontend/src/app/(platform)/chat/components/ChatInput/useChatInput.ts
rename to autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatInput/useChatInput.ts
index 2efae95483..08cf565daa 100644
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatInput/useChatInput.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatInput/useChatInput.ts
@@ -1,21 +1,22 @@
-import { KeyboardEvent, useCallback, useState, useRef, useEffect } from "react";
+import { KeyboardEvent, useCallback, useEffect, useState } from "react";
 
 interface UseChatInputArgs {
   onSend: (message: string) => void;
   disabled?: boolean;
   maxRows?: number;
+  inputId?: string;
 }
 
 export function useChatInput({
   onSend,
   disabled = false,
   maxRows = 5,
+  inputId = "chat-input",
 }: UseChatInputArgs) {
   const [value, setValue] = useState("");
-  const textareaRef = useRef<HTMLTextAreaElement>(null);
 
   useEffect(() => {
-    const textarea = textareaRef.current;
+    const textarea = document.getElementById(inputId) as HTMLTextAreaElement;
     if (!textarea) return;
     textarea.style.height = "auto";
     const lineHeight = parseInt(
@@ -27,23 +28,25 @@ export function useChatInput({
     textarea.style.height = `${newHeight}px`;
     textarea.style.overflowY =
       textarea.scrollHeight > maxHeight ? "auto" : "hidden";
-  }, [value, maxRows]);
+  }, [value, maxRows, inputId]);
 
   const handleSend = useCallback(() => {
     if (disabled || !value.trim()) return;
     onSend(value.trim());
     setValue("");
-    if (textareaRef.current) {
-      textareaRef.current.style.height = "auto";
+    const textarea = document.getElementById(inputId) as HTMLTextAreaElement;
+    if (textarea) {
+      textarea.style.height = "auto";
     }
-  }, [value, onSend, disabled]);
+  }, [value, onSend, disabled, inputId]);
 
   const handleKeyDown = useCallback(
-    (event: KeyboardEvent<HTMLTextAreaElement>) => {
+    (event: KeyboardEvent<HTMLInputElement | HTMLTextAreaElement>) => {
       if (event.key === "Enter" && !event.shiftKey) {
         event.preventDefault();
         handleSend();
       }
+      // Shift+Enter allows default behavior (new line) - no need to handle explicitly
     },
     [handleSend],
   );
@@ -53,6 +56,5 @@ export function useChatInput({
     setValue,
     handleKeyDown,
     handleSend,
-    textareaRef,
   };
 }
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatLoadingState/ChatLoadingState.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatLoadingState/ChatLoadingState.tsx
new file mode 100644
index 0000000000..c0cdb33c50
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatLoadingState/ChatLoadingState.tsx
@@ -0,0 +1,19 @@
+import { LoadingSpinner } from "@/components/atoms/LoadingSpinner/LoadingSpinner";
+import { cn } from "@/lib/utils";
+
+export interface ChatLoadingStateProps {
+  message?: string;
+  className?: string;
+}
+
+export function ChatLoadingState({ className }: ChatLoadingStateProps) {
+  return (
+    <div
+      className={cn("flex flex-1 items-center justify-center p-6", className)}
+    >
+      <div className="flex flex-col items-center gap-4 text-center">
+        <LoadingSpinner />
+      </div>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatMessage/ChatMessage.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatMessage/ChatMessage.tsx
new file mode 100644
index 0000000000..69a1ab63fb
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatMessage/ChatMessage.tsx
@@ -0,0 +1,341 @@
+"use client";
+
+import { useGetV2GetUserProfile } from "@/app/api/__generated__/endpoints/store/store";
+import Avatar, {
+  AvatarFallback,
+  AvatarImage,
+} from "@/components/atoms/Avatar/Avatar";
+import { Button } from "@/components/atoms/Button/Button";
+import { useSupabase } from "@/lib/supabase/hooks/useSupabase";
+import { cn } from "@/lib/utils";
+import {
+  ArrowClockwise,
+  CheckCircleIcon,
+  CheckIcon,
+  CopyIcon,
+  RobotIcon,
+} from "@phosphor-icons/react";
+import { useRouter } from "next/navigation";
+import { useCallback, useState } from "react";
+import { getToolActionPhrase } from "../../helpers";
+import { AgentCarouselMessage } from "../AgentCarouselMessage/AgentCarouselMessage";
+import { AuthPromptWidget } from "../AuthPromptWidget/AuthPromptWidget";
+import { ChatCredentialsSetup } from "../ChatCredentialsSetup/ChatCredentialsSetup";
+import { ExecutionStartedMessage } from "../ExecutionStartedMessage/ExecutionStartedMessage";
+import { MarkdownContent } from "../MarkdownContent/MarkdownContent";
+import { MessageBubble } from "../MessageBubble/MessageBubble";
+import { NoResultsMessage } from "../NoResultsMessage/NoResultsMessage";
+import { ToolCallMessage } from "../ToolCallMessage/ToolCallMessage";
+import { ToolResponseMessage } from "../ToolResponseMessage/ToolResponseMessage";
+import { useChatMessage, type ChatMessageData } from "./useChatMessage";
+export interface ChatMessageProps {
+  message: ChatMessageData;
+  className?: string;
+  onDismissLogin?: () => void;
+  onDismissCredentials?: () => void;
+  onSendMessage?: (content: string, isUserMessage?: boolean) => void;
+  agentOutput?: ChatMessageData;
+}
+
+export function ChatMessage({
+  message,
+  className,
+  onDismissCredentials,
+  onSendMessage,
+  agentOutput,
+}: ChatMessageProps) {
+  const { user } = useSupabase();
+  const router = useRouter();
+  const [copied, setCopied] = useState(false);
+  const {
+    isUser,
+    isToolCall,
+    isToolResponse,
+    isLoginNeeded,
+    isCredentialsNeeded,
+  } = useChatMessage(message);
+
+  const { data: profile } = useGetV2GetUserProfile({
+    query: {
+      select: (res) => (res.status === 200 ? res.data : null),
+      enabled: isUser && !!user,
+      queryKey: ["/api/store/profile", user?.id],
+    },
+  });
+
+  const handleAllCredentialsComplete = useCallback(
+    function handleAllCredentialsComplete() {
+      // Send a user message that explicitly asks to retry the setup
+      // This ensures the LLM calls get_required_setup_info again and proceeds with execution
+      if (onSendMessage) {
+        onSendMessage(
+          "I've configured the required credentials. Please check if everything is ready and proceed with setting up the agent.",
+        );
+      }
+      // Optionally dismiss the credentials prompt
+      if (onDismissCredentials) {
+        onDismissCredentials();
+      }
+    },
+    [onSendMessage, onDismissCredentials],
+  );
+
+  function handleCancelCredentials() {
+    // Dismiss the credentials prompt
+    if (onDismissCredentials) {
+      onDismissCredentials();
+    }
+  }
+
+  const handleCopy = useCallback(async () => {
+    if (message.type !== "message") return;
+
+    try {
+      await navigator.clipboard.writeText(message.content);
+      setCopied(true);
+      setTimeout(() => setCopied(false), 2000);
+    } catch (error) {
+      console.error("Failed to copy:", error);
+    }
+  }, [message]);
+
+  const handleTryAgain = useCallback(() => {
+    if (message.type !== "message" || !onSendMessage) return;
+    onSendMessage(message.content, message.role === "user");
+  }, [message, onSendMessage]);
+
+  const handleViewExecution = useCallback(() => {
+    if (message.type === "execution_started" && message.libraryAgentLink) {
+      router.push(message.libraryAgentLink);
+    }
+  }, [message, router]);
+
+  // Render credentials needed messages
+  if (isCredentialsNeeded && message.type === "credentials_needed") {
+    return (
+      <ChatCredentialsSetup
+        credentials={message.credentials}
+        agentName={message.agentName}
+        message={message.message}
+        onAllCredentialsComplete={handleAllCredentialsComplete}
+        onCancel={handleCancelCredentials}
+        className={className}
+      />
+    );
+  }
+
+  // Render login needed messages
+  if (isLoginNeeded && message.type === "login_needed") {
+    // If user is already logged in, show success message instead of auth prompt
+    if (user) {
+      return (
+        <div className={cn("px-4 py-2", className)}>
+          <div className="my-4 overflow-hidden rounded-lg border border-green-200 bg-gradient-to-br from-green-50 to-emerald-50">
+            <div className="px-6 py-4">
+              <div className="flex items-center gap-3">
+                <div className="flex h-10 w-10 items-center justify-center rounded-full bg-green-600">
+                  <CheckCircleIcon
+                    size={20}
+                    weight="fill"
+                    className="text-white"
+                  />
+                </div>
+                <div>
+                  <h3 className="text-lg font-semibold text-neutral-900">
+                    Successfully Authenticated
+                  </h3>
+                  <p className="text-sm text-neutral-600">
+                    You&apos;re now signed in and ready to continue
+                  </p>
+                </div>
+              </div>
+            </div>
+          </div>
+        </div>
+      );
+    }
+
+    // Show auth prompt if not logged in
+    return (
+      <div className={cn("px-4 py-2", className)}>
+        <AuthPromptWidget
+          message={message.message}
+          sessionId={message.sessionId}
+          agentInfo={message.agentInfo}
+        />
+      </div>
+    );
+  }
+
+  // Render tool call messages
+  if (isToolCall && message.type === "tool_call") {
+    return (
+      <div className={cn("px-4 py-2", className)}>
+        <ToolCallMessage toolName={message.toolName} />
+      </div>
+    );
+  }
+
+  // Render no_results messages - use dedicated component, not ToolResponseMessage
+  if (message.type === "no_results") {
+    return (
+      <div className={cn("px-4 py-2", className)}>
+        <NoResultsMessage
+          message={message.message}
+          suggestions={message.suggestions}
+        />
+      </div>
+    );
+  }
+
+  // Render agent_carousel messages - use dedicated component, not ToolResponseMessage
+  if (message.type === "agent_carousel") {
+    return (
+      <div className={cn("px-4 py-2", className)}>
+        <AgentCarouselMessage
+          agents={message.agents}
+          totalCount={message.totalCount}
+        />
+      </div>
+    );
+  }
+
+  // Render execution_started messages - use dedicated component, not ToolResponseMessage
+  if (message.type === "execution_started") {
+    return (
+      <div className={cn("px-4 py-2", className)}>
+        <ExecutionStartedMessage
+          executionId={message.executionId}
+          agentName={message.agentName}
+          message={message.message}
+          onViewExecution={
+            message.libraryAgentLink ? handleViewExecution : undefined
+          }
+        />
+      </div>
+    );
+  }
+
+  // Render tool response messages (but skip agent_output if it's being rendered inside assistant message)
+  if (isToolResponse && message.type === "tool_response") {
+    // Check if this is an agent_output that should be rendered inside assistant message
+    if (message.result) {
+      let parsedResult: Record<string, unknown> | null = null;
+      try {
+        parsedResult =
+          typeof message.result === "string"
+            ? JSON.parse(message.result)
+            : (message.result as Record<string, unknown>);
+      } catch {
+        parsedResult = null;
+      }
+      if (parsedResult?.type === "agent_output") {
+        // Skip rendering - this will be rendered inside the assistant message
+        return null;
+      }
+    }
+
+    return (
+      <div className={cn("px-4 py-2", className)}>
+        <ToolResponseMessage
+          toolName={getToolActionPhrase(message.toolName)}
+          result={message.result}
+        />
+      </div>
+    );
+  }
+
+  // Render regular chat messages
+  if (message.type === "message") {
+    return (
+      <div
+        className={cn(
+          "group relative flex w-full gap-3 px-4 py-3",
+          isUser ? "justify-end" : "justify-start",
+          className,
+        )}
+      >
+        <div className="flex w-full max-w-3xl gap-3">
+          {!isUser && (
+            <div className="flex-shrink-0">
+              <div className="flex h-7 w-7 items-center justify-center rounded-lg bg-indigo-500">
+                <RobotIcon className="h-4 w-4 text-indigo-50" />
+              </div>
+            </div>
+          )}
+
+          <div
+            className={cn(
+              "flex min-w-0 flex-1 flex-col",
+              isUser && "items-end",
+            )}
+          >
+            <MessageBubble variant={isUser ? "user" : "assistant"}>
+              <MarkdownContent content={message.content} />
+              {agentOutput &&
+                agentOutput.type === "tool_response" &&
+                !isUser && (
+                  <div className="mt-4">
+                    <ToolResponseMessage
+                      toolName={
+                        agentOutput.toolName
+                          ? getToolActionPhrase(agentOutput.toolName)
+                          : "Agent Output"
+                      }
+                      result={agentOutput.result}
+                    />
+                  </div>
+                )}
+            </MessageBubble>
+            <div
+              className={cn(
+                "mt-1 flex gap-1",
+                isUser ? "justify-end" : "justify-start",
+              )}
+            >
+              {isUser && onSendMessage && (
+                <Button
+                  variant="ghost"
+                  size="icon"
+                  onClick={handleTryAgain}
+                  aria-label="Try again"
+                >
+                  <ArrowClockwise className="size-3 text-neutral-500" />
+                </Button>
+              )}
+              <Button
+                variant="ghost"
+                size="icon"
+                onClick={handleCopy}
+                aria-label="Copy message"
+              >
+                {copied ? (
+                  <CheckIcon className="size-3 text-green-600" />
+                ) : (
+                  <CopyIcon className="size-3 text-neutral-500" />
+                )}
+              </Button>
+            </div>
+          </div>
+
+          {isUser && (
+            <div className="flex-shrink-0">
+              <Avatar className="h-7 w-7">
+                <AvatarImage
+                  src={profile?.avatar_url ?? ""}
+                  alt={profile?.username ?? "User"}
+                />
+                <AvatarFallback className="rounded-lg bg-neutral-200 text-neutral-600">
+                  {profile?.username?.charAt(0)?.toUpperCase() || "U"}
+                </AvatarFallback>
+              </Avatar>
+            </div>
+          )}
+        </div>
+      </div>
+    );
+  }
+
+  // Fallback for unknown message types
+  return null;
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatMessage/useChatMessage.ts b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatMessage/useChatMessage.ts
similarity index 88%
rename from autogpt_platform/frontend/src/app/(platform)/chat/components/ChatMessage/useChatMessage.ts
rename to autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatMessage/useChatMessage.ts
index ae4f48f35b..9a597d4b26 100644
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatMessage/useChatMessage.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ChatMessage/useChatMessage.ts
@@ -1,5 +1,5 @@
-import { formatDistanceToNow } from "date-fns";
 import type { ToolArguments, ToolResult } from "@/types/chat";
+import { formatDistanceToNow } from "date-fns";
 
 export type ChatMessageData =
   | {
@@ -65,6 +65,7 @@ export type ChatMessageData =
         name: string;
         description: string;
         version?: number;
+        image_url?: string;
       }>;
       totalCount?: number;
       timestamp?: string | Date;
@@ -77,6 +78,17 @@ export type ChatMessageData =
       message?: string;
       libraryAgentLink?: string;
       timestamp?: string | Date;
+    }
+  | {
+      type: "inputs_needed";
+      toolName: string;
+      agentName?: string;
+      agentId?: string;
+      graphVersion?: number;
+      inputSchema: Record<string, any>;
+      credentialsSchema?: Record<string, any>;
+      message: string;
+      timestamp?: string | Date;
     };
 
 export function useChatMessage(message: ChatMessageData) {
@@ -96,5 +108,6 @@ export function useChatMessage(message: ChatMessageData) {
     isNoResults: message.type === "no_results",
     isAgentCarousel: message.type === "agent_carousel",
     isExecutionStarted: message.type === "execution_started",
+    isInputsNeeded: message.type === "inputs_needed",
   };
 }
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/ExecutionStartedMessage/ExecutionStartedMessage.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ExecutionStartedMessage/ExecutionStartedMessage.tsx
similarity index 67%
rename from autogpt_platform/frontend/src/app/(platform)/chat/components/ExecutionStartedMessage/ExecutionStartedMessage.tsx
rename to autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ExecutionStartedMessage/ExecutionStartedMessage.tsx
index 77c7f8fe9b..1ac3b440e0 100644
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/ExecutionStartedMessage/ExecutionStartedMessage.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ExecutionStartedMessage/ExecutionStartedMessage.tsx
@@ -1,8 +1,7 @@
-import React from "react";
-import { Text } from "@/components/atoms/Text/Text";
 import { Button } from "@/components/atoms/Button/Button";
-import { CheckCircle, Play, ArrowSquareOut } from "@phosphor-icons/react";
+import { Text } from "@/components/atoms/Text/Text";
 import { cn } from "@/lib/utils";
+import { ArrowSquareOut, CheckCircle, Play } from "@phosphor-icons/react";
 
 export interface ExecutionStartedMessageProps {
   executionId: string;
@@ -22,7 +21,7 @@ export function ExecutionStartedMessage({
   return (
     <div
       className={cn(
-        "mx-4 my-2 flex flex-col gap-4 rounded-lg border border-green-200 bg-green-50 p-6 dark:border-green-900 dark:bg-green-950",
+        "mx-4 my-2 flex flex-col gap-4 rounded-lg border border-green-200 bg-green-50 p-6",
         className,
       )}
     >
@@ -32,48 +31,33 @@ export function ExecutionStartedMessage({
           <CheckCircle size={24} weight="bold" className="text-white" />
         </div>
         <div className="flex-1">
-          <Text
-            variant="h3"
-            className="mb-1 text-green-900 dark:text-green-100"
-          >
+          <Text variant="h3" className="mb-1 text-green-900">
             Execution Started
           </Text>
-          <Text variant="body" className="text-green-700 dark:text-green-300">
+          <Text variant="body" className="text-green-700">
             {message}
           </Text>
         </div>
       </div>
 
       {/* Details */}
-      <div className="rounded-md bg-green-100 p-4 dark:bg-green-900">
+      <div className="rounded-md bg-green-100 p-4">
         <div className="space-y-2">
           {agentName && (
             <div className="flex items-center justify-between">
-              <Text
-                variant="small"
-                className="font-semibold text-green-900 dark:text-green-100"
-              >
+              <Text variant="small" className="font-semibold text-green-900">
                 Agent:
               </Text>
-              <Text
-                variant="body"
-                className="text-green-800 dark:text-green-200"
-              >
+              <Text variant="body" className="text-green-800">
                 {agentName}
               </Text>
             </div>
           )}
           <div className="flex items-center justify-between">
-            <Text
-              variant="small"
-              className="font-semibold text-green-900 dark:text-green-100"
-            >
+            <Text variant="small" className="font-semibold text-green-900">
               Execution ID:
             </Text>
-            <Text
-              variant="small"
-              className="font-mono text-green-800 dark:text-green-200"
-            >
+            <Text variant="small" className="font-mono text-green-800">
               {executionId.slice(0, 16)}...
             </Text>
           </div>
@@ -94,7 +78,7 @@ export function ExecutionStartedMessage({
         </div>
       )}
 
-      <div className="flex items-center gap-2 text-green-600 dark:text-green-400">
+      <div className="flex items-center gap-2 text-green-600">
         <Play size={16} weight="fill" />
         <Text variant="small">
           Your agent is now running. You can monitor its progress in the monitor
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/MarkdownContent/MarkdownContent.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/MarkdownContent/MarkdownContent.tsx
similarity index 80%
rename from autogpt_platform/frontend/src/app/(platform)/chat/components/MarkdownContent/MarkdownContent.tsx
rename to autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/MarkdownContent/MarkdownContent.tsx
index e82e29c438..51a0794090 100644
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/MarkdownContent/MarkdownContent.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/MarkdownContent/MarkdownContent.tsx
@@ -1,9 +1,9 @@
 "use client";
 
+import { cn } from "@/lib/utils";
 import React from "react";
 import ReactMarkdown from "react-markdown";
 import remarkGfm from "remark-gfm";
-import { cn } from "@/lib/utils";
 
 interface MarkdownContentProps {
   content: string;
@@ -41,7 +41,7 @@ export function MarkdownContent({ content, className }: MarkdownContentProps) {
             if (isInline) {
               return (
                 <code
-                  className="rounded bg-zinc-100 px-1.5 py-0.5 font-mono text-sm text-zinc-800 dark:bg-zinc-800 dark:text-zinc-200"
+                  className="rounded bg-zinc-100 px-1.5 py-0.5 font-mono text-sm text-zinc-800"
                   {...props}
                 >
                   {children}
@@ -49,17 +49,14 @@ export function MarkdownContent({ content, className }: MarkdownContentProps) {
               );
             }
             return (
-              <code
-                className="font-mono text-sm text-zinc-100 dark:text-zinc-200"
-                {...props}
-              >
+              <code className="font-mono text-sm text-zinc-100" {...props}>
                 {children}
               </code>
             );
           },
           pre: ({ children, ...props }) => (
             <pre
-              className="my-2 overflow-x-auto rounded-md bg-zinc-900 p-3 dark:bg-zinc-950"
+              className="my-2 overflow-x-auto rounded-md bg-zinc-900 p-3"
               {...props}
             >
               {children}
@@ -70,7 +67,7 @@ export function MarkdownContent({ content, className }: MarkdownContentProps) {
               href={href}
               target="_blank"
               rel="noopener noreferrer"
-              className="text-purple-600 underline decoration-1 underline-offset-2 hover:text-purple-700 dark:text-purple-400 dark:hover:text-purple-300"
+              className="text-purple-600 underline decoration-1 underline-offset-2 hover:text-purple-700"
               {...props}
             >
               {children}
@@ -126,7 +123,7 @@ export function MarkdownContent({ content, className }: MarkdownContentProps) {
               return (
                 <input
                   type="checkbox"
-                  className="mr-2 h-4 w-4 rounded border-zinc-300 text-purple-600 focus:ring-purple-500 disabled:cursor-not-allowed disabled:opacity-70 dark:border-zinc-600"
+                  className="mr-2 h-4 w-4 rounded border-zinc-300 text-purple-600 focus:ring-purple-500 disabled:cursor-not-allowed disabled:opacity-70"
                   disabled
                   {...props}
                 />
@@ -136,57 +133,42 @@ export function MarkdownContent({ content, className }: MarkdownContentProps) {
           },
           blockquote: ({ children, ...props }) => (
             <blockquote
-              className="my-2 border-l-4 border-zinc-300 pl-3 italic text-zinc-700 dark:border-zinc-600 dark:text-zinc-300"
+              className="my-2 border-l-4 border-zinc-300 pl-3 italic text-zinc-700"
               {...props}
             >
               {children}
             </blockquote>
           ),
           h1: ({ children, ...props }) => (
-            <h1
-              className="my-2 text-xl font-bold text-zinc-900 dark:text-zinc-100"
-              {...props}
-            >
+            <h1 className="my-2 text-xl font-bold text-zinc-900" {...props}>
               {children}
             </h1>
           ),
           h2: ({ children, ...props }) => (
-            <h2
-              className="my-2 text-lg font-semibold text-zinc-800 dark:text-zinc-200"
-              {...props}
-            >
+            <h2 className="my-2 text-lg font-semibold text-zinc-800" {...props}>
               {children}
             </h2>
           ),
           h3: ({ children, ...props }) => (
             <h3
-              className="my-1 text-base font-semibold text-zinc-800 dark:text-zinc-200"
+              className="my-1 text-base font-semibold text-zinc-800"
               {...props}
             >
               {children}
             </h3>
           ),
           h4: ({ children, ...props }) => (
-            <h4
-              className="my-1 text-sm font-medium text-zinc-700 dark:text-zinc-300"
-              {...props}
-            >
+            <h4 className="my-1 text-sm font-medium text-zinc-700" {...props}>
               {children}
             </h4>
           ),
           h5: ({ children, ...props }) => (
-            <h5
-              className="my-1 text-sm font-medium text-zinc-700 dark:text-zinc-300"
-              {...props}
-            >
+            <h5 className="my-1 text-sm font-medium text-zinc-700" {...props}>
               {children}
             </h5>
           ),
           h6: ({ children, ...props }) => (
-            <h6
-              className="my-1 text-xs font-medium text-zinc-600 dark:text-zinc-400"
-              {...props}
-            >
+            <h6 className="my-1 text-xs font-medium text-zinc-600" {...props}>
               {children}
             </h6>
           ),
@@ -196,15 +178,12 @@ export function MarkdownContent({ content, className }: MarkdownContentProps) {
             </p>
           ),
           hr: ({ ...props }) => (
-            <hr
-              className="my-3 border-zinc-300 dark:border-zinc-700"
-              {...props}
-            />
+            <hr className="my-3 border-zinc-300" {...props} />
           ),
           table: ({ children, ...props }) => (
             <div className="my-2 overflow-x-auto">
               <table
-                className="min-w-full divide-y divide-zinc-200 rounded border border-zinc-200 dark:divide-zinc-700 dark:border-zinc-700"
+                className="min-w-full divide-y divide-zinc-200 rounded border border-zinc-200"
                 {...props}
               >
                 {children}
@@ -213,7 +192,7 @@ export function MarkdownContent({ content, className }: MarkdownContentProps) {
           ),
           th: ({ children, ...props }) => (
             <th
-              className="bg-zinc-50 px-3 py-2 text-left text-xs font-semibold text-zinc-700 dark:bg-zinc-800 dark:text-zinc-300"
+              className="bg-zinc-50 px-3 py-2 text-left text-xs font-semibold text-zinc-700"
               {...props}
             >
               {children}
@@ -221,7 +200,7 @@ export function MarkdownContent({ content, className }: MarkdownContentProps) {
           ),
           td: ({ children, ...props }) => (
             <td
-              className="border-t border-zinc-200 px-3 py-2 text-sm dark:border-zinc-700"
+              className="border-t border-zinc-200 px-3 py-2 text-sm"
               {...props}
             >
               {children}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/MessageBubble/MessageBubble.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/MessageBubble/MessageBubble.tsx
new file mode 100644
index 0000000000..98b50f3d28
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/MessageBubble/MessageBubble.tsx
@@ -0,0 +1,56 @@
+import { cn } from "@/lib/utils";
+import { ReactNode } from "react";
+
+export interface MessageBubbleProps {
+  children: ReactNode;
+  variant: "user" | "assistant";
+  className?: string;
+}
+
+export function MessageBubble({
+  children,
+  variant,
+  className,
+}: MessageBubbleProps) {
+  const userTheme = {
+    bg: "bg-slate-900",
+    border: "border-slate-800",
+    gradient: "from-slate-900/30 via-slate-800/20 to-transparent",
+    text: "text-slate-50",
+  };
+
+  const assistantTheme = {
+    bg: "bg-slate-50/20",
+    border: "border-slate-100",
+    gradient: "from-slate-200/20 via-slate-300/10 to-transparent",
+    text: "text-slate-900",
+  };
+
+  const theme = variant === "user" ? userTheme : assistantTheme;
+
+  return (
+    <div
+      className={cn(
+        "group relative min-w-20 overflow-hidden rounded-xl border px-6 py-2.5 text-sm leading-relaxed backdrop-blur-xl transition-all duration-500 ease-in-out",
+        theme.bg,
+        theme.border,
+        variant === "user" && "text-right",
+        variant === "assistant" && "text-left",
+        className,
+      )}
+    >
+      {/* Gradient flare background */}
+      <div
+        className={cn("absolute inset-0 bg-gradient-to-br", theme.gradient)}
+      />
+      <div
+        className={cn(
+          "relative z-10 transition-all duration-500 ease-in-out",
+          theme.text,
+        )}
+      >
+        {children}
+      </div>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/MessageList/MessageList.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/MessageList/MessageList.tsx
new file mode 100644
index 0000000000..22b51c0a92
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/MessageList/MessageList.tsx
@@ -0,0 +1,121 @@
+"use client";
+
+import { cn } from "@/lib/utils";
+import { ChatMessage } from "../ChatMessage/ChatMessage";
+import type { ChatMessageData } from "../ChatMessage/useChatMessage";
+import { StreamingMessage } from "../StreamingMessage/StreamingMessage";
+import { ThinkingMessage } from "../ThinkingMessage/ThinkingMessage";
+import { useMessageList } from "./useMessageList";
+
+export interface MessageListProps {
+  messages: ChatMessageData[];
+  streamingChunks?: string[];
+  isStreaming?: boolean;
+  className?: string;
+  onStreamComplete?: () => void;
+  onSendMessage?: (content: string) => void;
+}
+
+export function MessageList({
+  messages,
+  streamingChunks = [],
+  isStreaming = false,
+  className,
+  onStreamComplete,
+  onSendMessage,
+}: MessageListProps) {
+  const { messagesEndRef, messagesContainerRef } = useMessageList({
+    messageCount: messages.length,
+    isStreaming,
+  });
+
+  return (
+    <div
+      ref={messagesContainerRef}
+      className={cn(
+        "flex-1 overflow-y-auto",
+        "scrollbar-thin scrollbar-track-transparent scrollbar-thumb-zinc-300",
+        className,
+      )}
+    >
+      <div className="mx-auto flex max-w-3xl flex-col py-4">
+        {/* Render all persisted messages */}
+        {messages.map((message, index) => {
+          // Check if current message is an agent_output tool_response
+          // and if previous message is an assistant message
+          let agentOutput: ChatMessageData | undefined;
+
+          if (message.type === "tool_response" && message.result) {
+            let parsedResult: Record<string, unknown> | null = null;
+            try {
+              parsedResult =
+                typeof message.result === "string"
+                  ? JSON.parse(message.result)
+                  : (message.result as Record<string, unknown>);
+            } catch {
+              parsedResult = null;
+            }
+            if (parsedResult?.type === "agent_output") {
+              const prevMessage = messages[index - 1];
+              if (
+                prevMessage &&
+                prevMessage.type === "message" &&
+                prevMessage.role === "assistant"
+              ) {
+                // This agent output will be rendered inside the previous assistant message
+                // Skip rendering this message separately
+                return null;
+              }
+            }
+          }
+
+          // Check if next message is an agent_output tool_response to include in current assistant message
+          if (message.type === "message" && message.role === "assistant") {
+            const nextMessage = messages[index + 1];
+            if (
+              nextMessage &&
+              nextMessage.type === "tool_response" &&
+              nextMessage.result
+            ) {
+              let parsedResult: Record<string, unknown> | null = null;
+              try {
+                parsedResult =
+                  typeof nextMessage.result === "string"
+                    ? JSON.parse(nextMessage.result)
+                    : (nextMessage.result as Record<string, unknown>);
+              } catch {
+                parsedResult = null;
+              }
+              if (parsedResult?.type === "agent_output") {
+                agentOutput = nextMessage;
+              }
+            }
+          }
+
+          return (
+            <ChatMessage
+              key={index}
+              message={message}
+              onSendMessage={onSendMessage}
+              agentOutput={agentOutput}
+            />
+          );
+        })}
+
+        {/* Render thinking message when streaming but no chunks yet */}
+        {isStreaming && streamingChunks.length === 0 && <ThinkingMessage />}
+
+        {/* Render streaming message if active */}
+        {isStreaming && streamingChunks.length > 0 && (
+          <StreamingMessage
+            chunks={streamingChunks}
+            onComplete={onStreamComplete}
+          />
+        )}
+
+        {/* Invisible div to scroll to */}
+        <div ref={messagesEndRef} />
+      </div>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/MessageList/useMessageList.ts b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/MessageList/useMessageList.ts
similarity index 100%
rename from autogpt_platform/frontend/src/app/(platform)/chat/components/MessageList/useMessageList.ts
rename to autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/MessageList/useMessageList.ts
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/NoResultsMessage/NoResultsMessage.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/NoResultsMessage/NoResultsMessage.tsx
similarity index 72%
rename from autogpt_platform/frontend/src/app/(platform)/chat/components/NoResultsMessage/NoResultsMessage.tsx
rename to autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/NoResultsMessage/NoResultsMessage.tsx
index 38eac24bce..b6adc8b93c 100644
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/NoResultsMessage/NoResultsMessage.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/NoResultsMessage/NoResultsMessage.tsx
@@ -1,7 +1,6 @@
-import React from "react";
 import { Text } from "@/components/atoms/Text/Text";
-import { MagnifyingGlass, X } from "@phosphor-icons/react";
 import { cn } from "@/lib/utils";
+import { MagnifyingGlass, X } from "@phosphor-icons/react";
 
 export interface NoResultsMessageProps {
   message: string;
@@ -17,26 +16,26 @@ export function NoResultsMessage({
   return (
     <div
       className={cn(
-        "mx-4 my-2 flex flex-col items-center gap-4 rounded-lg border border-gray-200 bg-gray-50 p-6 dark:border-gray-800 dark:bg-gray-900",
+        "mx-4 my-2 flex flex-col items-center gap-4 rounded-lg border border-gray-200 bg-gray-50 p-6",
         className,
       )}
     >
       {/* Icon */}
       <div className="relative flex h-16 w-16 items-center justify-center">
-        <div className="flex h-16 w-16 items-center justify-center rounded-full bg-gray-200 dark:bg-gray-700">
+        <div className="flex h-16 w-16 items-center justify-center rounded-full bg-gray-200">
           <MagnifyingGlass size={32} weight="bold" className="text-gray-500" />
         </div>
-        <div className="absolute -right-1 -top-1 flex h-8 w-8 items-center justify-center rounded-full bg-gray-400 dark:bg-gray-600">
+        <div className="absolute -right-1 -top-1 flex h-8 w-8 items-center justify-center rounded-full bg-gray-400">
           <X size={20} weight="bold" className="text-white" />
         </div>
       </div>
 
       {/* Content */}
       <div className="text-center">
-        <Text variant="h3" className="mb-2 text-gray-900 dark:text-gray-100">
+        <Text variant="h3" className="mb-2 text-gray-900">
           No Results Found
         </Text>
-        <Text variant="body" className="text-gray-700 dark:text-gray-300">
+        <Text variant="body" className="text-gray-700">
           {message}
         </Text>
       </div>
@@ -44,17 +43,14 @@ export function NoResultsMessage({
       {/* Suggestions */}
       {suggestions.length > 0 && (
         <div className="w-full space-y-2">
-          <Text
-            variant="small"
-            className="font-semibold text-gray-900 dark:text-gray-100"
-          >
+          <Text variant="small" className="font-semibold text-gray-900">
             Try these suggestions:
           </Text>
-          <ul className="space-y-1 rounded-md bg-gray-100 p-4 dark:bg-gray-800">
+          <ul className="space-y-1 rounded-md bg-gray-100 p-4">
             {suggestions.map((suggestion, index) => (
               <li
                 key={index}
-                className="flex items-start gap-2 text-sm text-gray-700 dark:text-gray-300"
+                className="flex items-start gap-2 text-sm text-gray-700"
               >
                 <span className="mt-1 text-gray-500">•</span>
                 <span>{suggestion}</span>
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/QuickActionsWelcome/QuickActionsWelcome.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/QuickActionsWelcome/QuickActionsWelcome.tsx
new file mode 100644
index 0000000000..dd76fd9fb6
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/QuickActionsWelcome/QuickActionsWelcome.tsx
@@ -0,0 +1,94 @@
+"use client";
+
+import { Text } from "@/components/atoms/Text/Text";
+import { cn } from "@/lib/utils";
+
+export interface QuickActionsWelcomeProps {
+  title: string;
+  description: string;
+  actions: string[];
+  onActionClick: (action: string) => void;
+  disabled?: boolean;
+  className?: string;
+}
+
+export function QuickActionsWelcome({
+  title,
+  description,
+  actions,
+  onActionClick,
+  disabled = false,
+  className,
+}: QuickActionsWelcomeProps) {
+  return (
+    <div
+      className={cn("flex flex-1 items-center justify-center p-8", className)}
+    >
+      <div className="w-full max-w-3xl">
+        <div className="mb-12 text-center">
+          <Text
+            variant="h2"
+            className="mb-3 text-2xl font-semibold text-zinc-900"
+          >
+            {title}
+          </Text>
+          <Text variant="body" className="text-zinc-500">
+            {description}
+          </Text>
+        </div>
+        <div className="grid gap-3 sm:grid-cols-2">
+          {actions.map((action) => {
+            // Use slate theme for all cards
+            const theme = {
+              bg: "bg-slate-50/10",
+              border: "border-slate-100",
+              hoverBg: "hover:bg-slate-50/20",
+              hoverBorder: "hover:border-slate-200",
+              gradient: "from-slate-200/20 via-slate-300/10 to-transparent",
+              text: "text-slate-900",
+              hoverText: "group-hover:text-slate-900",
+            };
+
+            return (
+              <button
+                key={action}
+                onClick={() => onActionClick(action)}
+                disabled={disabled}
+                className={cn(
+                  "group relative overflow-hidden rounded-xl border p-5 text-left backdrop-blur-xl",
+                  "transition-all duration-200",
+                  theme.bg,
+                  theme.border,
+                  theme.hoverBg,
+                  theme.hoverBorder,
+                  "hover:shadow-sm",
+                  "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-white/50 focus-visible:ring-offset-2",
+                  "disabled:cursor-not-allowed disabled:opacity-50 disabled:hover:shadow-none",
+                )}
+              >
+                {/* Gradient flare background */}
+                <div
+                  className={cn(
+                    "absolute inset-0 bg-gradient-to-br",
+                    theme.gradient,
+                  )}
+                />
+
+                <Text
+                  variant="body"
+                  className={cn(
+                    "relative z-10 font-medium",
+                    theme.text,
+                    theme.hoverText,
+                  )}
+                >
+                  {action}
+                </Text>
+              </button>
+            );
+          })}
+        </div>
+      </div>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/SessionsDrawer/SessionsDrawer.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/SessionsDrawer/SessionsDrawer.tsx
new file mode 100644
index 0000000000..74aa709a46
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/SessionsDrawer/SessionsDrawer.tsx
@@ -0,0 +1,136 @@
+"use client";
+
+import { useGetV2ListSessions } from "@/app/api/__generated__/endpoints/chat/chat";
+import { Text } from "@/components/atoms/Text/Text";
+import { scrollbarStyles } from "@/components/styles/scrollbars";
+import { cn } from "@/lib/utils";
+import { X } from "@phosphor-icons/react";
+import { formatDistanceToNow } from "date-fns";
+import { Drawer } from "vaul";
+
+interface SessionsDrawerProps {
+  isOpen: boolean;
+  onClose: () => void;
+  onSelectSession: (sessionId: string) => void;
+  currentSessionId?: string | null;
+}
+
+export function SessionsDrawer({
+  isOpen,
+  onClose,
+  onSelectSession,
+  currentSessionId,
+}: SessionsDrawerProps) {
+  const { data, isLoading } = useGetV2ListSessions(
+    { limit: 100 },
+    {
+      query: {
+        enabled: isOpen,
+      },
+    },
+  );
+
+  const sessions =
+    data?.status === 200
+      ? data.data.sessions.filter((session) => {
+          // Filter out sessions without messages (sessions that were never updated)
+          // If updated_at equals created_at, the session was created but never had messages
+          return session.updated_at !== session.created_at;
+        })
+      : [];
+
+  function handleSelectSession(sessionId: string) {
+    onSelectSession(sessionId);
+    onClose();
+  }
+
+  return (
+    <Drawer.Root
+      open={isOpen}
+      onOpenChange={(open) => !open && onClose()}
+      direction="right"
+    >
+      <Drawer.Portal>
+        <Drawer.Overlay className="fixed inset-0 z-[60] bg-black/10 backdrop-blur-sm" />
+        <Drawer.Content
+          className={cn(
+            "fixed right-0 top-0 z-[70] flex h-full w-96 flex-col border-l border-zinc-200 bg-white",
+            scrollbarStyles,
+          )}
+        >
+          <div className="shrink-0 p-4">
+            <div className="flex items-center justify-between">
+              <Drawer.Title className="text-lg font-semibold">
+                Chat Sessions
+              </Drawer.Title>
+              <button
+                aria-label="Close"
+                onClick={onClose}
+                className="flex size-8 items-center justify-center rounded hover:bg-zinc-100"
+              >
+                <X width="1.25rem" height="1.25rem" />
+              </button>
+            </div>
+          </div>
+
+          <div className="flex-1 overflow-y-auto p-4">
+            {isLoading ? (
+              <div className="flex items-center justify-center py-8">
+                <Text variant="body" className="text-zinc-500">
+                  Loading sessions...
+                </Text>
+              </div>
+            ) : sessions.length === 0 ? (
+              <div className="flex items-center justify-center py-8">
+                <Text variant="body" className="text-zinc-500">
+                  No sessions found
+                </Text>
+              </div>
+            ) : (
+              <div className="space-y-2">
+                {sessions.map((session) => {
+                  const isActive = session.id === currentSessionId;
+                  const updatedAt = session.updated_at
+                    ? formatDistanceToNow(new Date(session.updated_at), {
+                        addSuffix: true,
+                      })
+                    : "";
+
+                  return (
+                    <button
+                      key={session.id}
+                      onClick={() => handleSelectSession(session.id)}
+                      className={cn(
+                        "w-full rounded-lg border p-3 text-left transition-colors",
+                        isActive
+                          ? "border-indigo-500 bg-zinc-50"
+                          : "border-zinc-200 bg-zinc-100/50 hover:border-zinc-300 hover:bg-zinc-50",
+                      )}
+                    >
+                      <div className="flex flex-col gap-1">
+                        <Text
+                          variant="body"
+                          className={cn(
+                            "font-medium",
+                            isActive ? "text-indigo-900" : "text-zinc-900",
+                          )}
+                        >
+                          {session.title || "Untitled Chat"}
+                        </Text>
+                        <div className="flex items-center gap-2 text-xs text-zinc-500">
+                          <span>{session.id.slice(0, 8)}...</span>
+                          {updatedAt && <span>•</span>}
+                          <span>{updatedAt}</span>
+                        </div>
+                      </div>
+                    </button>
+                  );
+                })}
+              </div>
+            )}
+          </div>
+        </Drawer.Content>
+      </Drawer.Portal>
+    </Drawer.Root>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/StreamingMessage/StreamingMessage.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/StreamingMessage/StreamingMessage.tsx
new file mode 100644
index 0000000000..2a6e3d5822
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/StreamingMessage/StreamingMessage.tsx
@@ -0,0 +1,42 @@
+import { cn } from "@/lib/utils";
+import { RobotIcon } from "@phosphor-icons/react";
+import { MarkdownContent } from "../MarkdownContent/MarkdownContent";
+import { MessageBubble } from "../MessageBubble/MessageBubble";
+import { useStreamingMessage } from "./useStreamingMessage";
+
+export interface StreamingMessageProps {
+  chunks: string[];
+  className?: string;
+  onComplete?: () => void;
+}
+
+export function StreamingMessage({
+  chunks,
+  className,
+  onComplete,
+}: StreamingMessageProps) {
+  const { displayText } = useStreamingMessage({ chunks, onComplete });
+
+  return (
+    <div
+      className={cn(
+        "group relative flex w-full justify-start gap-3 px-4 py-3",
+        className,
+      )}
+    >
+      <div className="flex w-full max-w-3xl gap-3">
+        <div className="flex-shrink-0">
+          <div className="flex h-7 w-7 items-center justify-center rounded-lg bg-indigo-600">
+            <RobotIcon className="h-4 w-4 text-indigo-50" />
+          </div>
+        </div>
+
+        <div className="flex min-w-0 flex-1 flex-col">
+          <MessageBubble variant="assistant">
+            <MarkdownContent content={displayText} />
+          </MessageBubble>
+        </div>
+      </div>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/StreamingMessage/useStreamingMessage.ts b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/StreamingMessage/useStreamingMessage.ts
similarity index 100%
rename from autogpt_platform/frontend/src/app/(platform)/chat/components/StreamingMessage/useStreamingMessage.ts
rename to autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/StreamingMessage/useStreamingMessage.ts
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ThinkingMessage/ThinkingMessage.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ThinkingMessage/ThinkingMessage.tsx
new file mode 100644
index 0000000000..d8adddf416
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ThinkingMessage/ThinkingMessage.tsx
@@ -0,0 +1,70 @@
+import { cn } from "@/lib/utils";
+import { RobotIcon } from "@phosphor-icons/react";
+import { useEffect, useRef, useState } from "react";
+import { MessageBubble } from "../MessageBubble/MessageBubble";
+
+export interface ThinkingMessageProps {
+  className?: string;
+}
+
+export function ThinkingMessage({ className }: ThinkingMessageProps) {
+  const [showSlowLoader, setShowSlowLoader] = useState(false);
+  const timerRef = useRef<NodeJS.Timeout | null>(null);
+
+  useEffect(() => {
+    if (timerRef.current === null) {
+      timerRef.current = setTimeout(() => {
+        setShowSlowLoader(true);
+      }, 8000);
+    }
+
+    return () => {
+      if (timerRef.current) {
+        clearTimeout(timerRef.current);
+        timerRef.current = null;
+      }
+    };
+  }, []);
+
+  return (
+    <div
+      className={cn(
+        "group relative flex w-full justify-start gap-3 px-4 py-3",
+        className,
+      )}
+    >
+      <div className="flex w-full max-w-3xl gap-3">
+        <div className="flex-shrink-0">
+          <div className="flex h-7 w-7 items-center justify-center rounded-lg bg-indigo-500">
+            <RobotIcon className="h-4 w-4 text-indigo-50" />
+          </div>
+        </div>
+
+        <div className="flex min-w-0 flex-1 flex-col">
+          <MessageBubble variant="assistant">
+            <div className="transition-all duration-500 ease-in-out">
+              {showSlowLoader ? (
+                <div className="flex flex-col items-center gap-3 py-2">
+                  <div className="loader" style={{ flexShrink: 0 }} />
+                  <p className="text-sm text-slate-700">
+                    Taking a bit longer to think, wait a moment please
+                  </p>
+                </div>
+              ) : (
+                <span
+                  className="inline-block bg-gradient-to-r from-neutral-400 via-neutral-600 to-neutral-400 bg-clip-text text-transparent"
+                  style={{
+                    backgroundSize: "200% 100%",
+                    animation: "shimmer 2s ease-in-out infinite",
+                  }}
+                >
+                  Thinking...
+                </span>
+              )}
+            </div>
+          </MessageBubble>
+        </div>
+      </div>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ToolCallMessage/ToolCallMessage.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ToolCallMessage/ToolCallMessage.tsx
new file mode 100644
index 0000000000..97590ae0cf
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ToolCallMessage/ToolCallMessage.tsx
@@ -0,0 +1,24 @@
+import { Text } from "@/components/atoms/Text/Text";
+import { cn } from "@/lib/utils";
+import { WrenchIcon } from "@phosphor-icons/react";
+import { getToolActionPhrase } from "../../helpers";
+
+export interface ToolCallMessageProps {
+  toolName: string;
+  className?: string;
+}
+
+export function ToolCallMessage({ toolName, className }: ToolCallMessageProps) {
+  return (
+    <div className={cn("flex items-center justify-center gap-2", className)}>
+      <WrenchIcon
+        size={14}
+        weight="bold"
+        className="flex-shrink-0 text-neutral-500"
+      />
+      <Text variant="small" className="text-neutral-500">
+        {getToolActionPhrase(toolName)}...
+      </Text>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ToolResponseMessage/ToolResponseMessage.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ToolResponseMessage/ToolResponseMessage.tsx
new file mode 100644
index 0000000000..b84204c3ff
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/components/ToolResponseMessage/ToolResponseMessage.tsx
@@ -0,0 +1,260 @@
+import { Text } from "@/components/atoms/Text/Text";
+import "@/components/contextual/OutputRenderers";
+import {
+  globalRegistry,
+  OutputItem,
+} from "@/components/contextual/OutputRenderers";
+import { cn } from "@/lib/utils";
+import type { ToolResult } from "@/types/chat";
+import { WrenchIcon } from "@phosphor-icons/react";
+import { getToolActionPhrase } from "../../helpers";
+
+export interface ToolResponseMessageProps {
+  toolName: string;
+  result?: ToolResult;
+  success?: boolean;
+  className?: string;
+}
+
+export function ToolResponseMessage({
+  toolName,
+  result,
+  success: _success = true,
+  className,
+}: ToolResponseMessageProps) {
+  if (!result) {
+    return (
+      <div className={cn("flex items-center justify-center gap-2", className)}>
+        <WrenchIcon
+          size={14}
+          weight="bold"
+          className="flex-shrink-0 text-neutral-500"
+        />
+        <Text variant="small" className="text-neutral-500">
+          {getToolActionPhrase(toolName)}...
+        </Text>
+      </div>
+    );
+  }
+
+  let parsedResult: Record<string, unknown> | null = null;
+  try {
+    parsedResult =
+      typeof result === "string"
+        ? JSON.parse(result)
+        : (result as Record<string, unknown>);
+  } catch {
+    parsedResult = null;
+  }
+
+  if (parsedResult && typeof parsedResult === "object") {
+    const responseType = parsedResult.type as string | undefined;
+
+    if (responseType === "agent_output") {
+      const execution = parsedResult.execution as
+        | {
+            outputs?: Record<string, unknown[]>;
+          }
+        | null
+        | undefined;
+      const outputs = execution?.outputs || {};
+      const message = parsedResult.message as string | undefined;
+
+      return (
+        <div className={cn("space-y-4 px-4 py-2", className)}>
+          <div className="flex items-center gap-2">
+            <WrenchIcon
+              size={14}
+              weight="bold"
+              className="flex-shrink-0 text-neutral-500"
+            />
+            <Text variant="small" className="text-neutral-500">
+              {getToolActionPhrase(toolName)}
+            </Text>
+          </div>
+          {message && (
+            <div className="rounded border p-4">
+              <Text variant="small" className="text-neutral-600">
+                {message}
+              </Text>
+            </div>
+          )}
+          {Object.keys(outputs).length > 0 && (
+            <div className="space-y-4">
+              {Object.entries(outputs).map(([outputName, values]) =>
+                values.map((value, index) => {
+                  const renderer = globalRegistry.getRenderer(value);
+                  if (renderer) {
+                    return (
+                      <OutputItem
+                        key={`${outputName}-${index}`}
+                        value={value}
+                        renderer={renderer}
+                        label={outputName}
+                      />
+                    );
+                  }
+                  return (
+                    <div
+                      key={`${outputName}-${index}`}
+                      className="rounded border p-4"
+                    >
+                      <Text variant="large-medium" className="mb-2 capitalize">
+                        {outputName}
+                      </Text>
+                      <pre className="overflow-auto text-sm">
+                        {JSON.stringify(value, null, 2)}
+                      </pre>
+                    </div>
+                  );
+                }),
+              )}
+            </div>
+          )}
+        </div>
+      );
+    }
+
+    if (responseType === "block_output" && parsedResult.outputs) {
+      const outputs = parsedResult.outputs as Record<string, unknown[]>;
+
+      return (
+        <div className={cn("space-y-4 px-4 py-2", className)}>
+          <div className="flex items-center gap-2">
+            <WrenchIcon
+              size={14}
+              weight="bold"
+              className="flex-shrink-0 text-neutral-500"
+            />
+            <Text variant="small" className="text-neutral-500">
+              {getToolActionPhrase(toolName)}
+            </Text>
+          </div>
+          <div className="space-y-4">
+            {Object.entries(outputs).map(([outputName, values]) =>
+              values.map((value, index) => {
+                const renderer = globalRegistry.getRenderer(value);
+                if (renderer) {
+                  return (
+                    <OutputItem
+                      key={`${outputName}-${index}`}
+                      value={value}
+                      renderer={renderer}
+                      label={outputName}
+                    />
+                  );
+                }
+                return (
+                  <div
+                    key={`${outputName}-${index}`}
+                    className="rounded border p-4"
+                  >
+                    <Text variant="large-medium" className="mb-2 capitalize">
+                      {outputName}
+                    </Text>
+                    <pre className="overflow-auto text-sm">
+                      {JSON.stringify(value, null, 2)}
+                    </pre>
+                  </div>
+                );
+              }),
+            )}
+          </div>
+        </div>
+      );
+    }
+
+    // Handle other response types with a message field (e.g., understanding_updated)
+    if (parsedResult.message && typeof parsedResult.message === "string") {
+      // Format tool name from snake_case to Title Case
+      const formattedToolName = toolName
+        .split("_")
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(" ");
+
+      // Clean up message - remove incomplete user_name references
+      let cleanedMessage = parsedResult.message;
+      // Remove "Updated understanding with: user_name" pattern if user_name is just a placeholder
+      cleanedMessage = cleanedMessage.replace(
+        /Updated understanding with:\s*user_name\.?\s*/gi,
+        "",
+      );
+      // Remove standalone user_name references
+      cleanedMessage = cleanedMessage.replace(/\buser_name\b\.?\s*/gi, "");
+      cleanedMessage = cleanedMessage.trim();
+
+      // Only show message if it has content after cleaning
+      if (!cleanedMessage) {
+        return (
+          <div
+            className={cn(
+              "flex items-center justify-center gap-2 px-4 py-2",
+              className,
+            )}
+          >
+            <WrenchIcon
+              size={14}
+              weight="bold"
+              className="flex-shrink-0 text-neutral-500"
+            />
+            <Text variant="small" className="text-neutral-500">
+              {formattedToolName}
+            </Text>
+          </div>
+        );
+      }
+
+      return (
+        <div className={cn("space-y-2 px-4 py-2", className)}>
+          <div className="flex items-center justify-center gap-2">
+            <WrenchIcon
+              size={14}
+              weight="bold"
+              className="flex-shrink-0 text-neutral-500"
+            />
+            <Text variant="small" className="text-neutral-500">
+              {formattedToolName}
+            </Text>
+          </div>
+          <div className="rounded border p-4">
+            <Text variant="small" className="text-neutral-600">
+              {cleanedMessage}
+            </Text>
+          </div>
+        </div>
+      );
+    }
+  }
+
+  const renderer = globalRegistry.getRenderer(result);
+  if (renderer) {
+    return (
+      <div className={cn("px-4 py-2", className)}>
+        <div className="mb-2 flex items-center gap-2">
+          <WrenchIcon
+            size={14}
+            weight="bold"
+            className="flex-shrink-0 text-neutral-500"
+          />
+          <Text variant="small" className="text-neutral-500">
+            {getToolActionPhrase(toolName)}
+          </Text>
+        </div>
+        <OutputItem value={result} renderer={renderer} />
+      </div>
+    );
+  }
+
+  return (
+    <div className={cn("flex items-center justify-center gap-2", className)}>
+      <WrenchIcon
+        size={14}
+        weight="bold"
+        className="flex-shrink-0 text-neutral-500"
+      />
+      <Text variant="small" className="text-neutral-500">
+        {getToolActionPhrase(toolName)}...
+      </Text>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/helpers.ts b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/helpers.ts
similarity index 92%
rename from autogpt_platform/frontend/src/app/(platform)/chat/helpers.ts
rename to autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/helpers.ts
index 5a1e5eb93f..0fade56b73 100644
--- a/autogpt_platform/frontend/src/app/(platform)/chat/helpers.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/helpers.ts
@@ -64,10 +64,3 @@ export function getToolCompletionPhrase(toolName: string): string {
     `Finished ${toolName.replace(/_/g, " ").replace("...", "")}`
   );
 }
-
-/** Validate UUID v4 format */
-export function isValidUUID(value: string): boolean {
-  const uuidRegex =
-    /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-  return uuidRegex.test(value);
-}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/useChatPage.ts b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/useChat.ts
similarity index 78%
rename from autogpt_platform/frontend/src/app/(platform)/chat/useChatPage.ts
rename to autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/useChat.ts
index 4f1db5471a..8445d68b3f 100644
--- a/autogpt_platform/frontend/src/app/(platform)/chat/useChatPage.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/useChat.ts
@@ -1,17 +1,12 @@
 "use client";
 
-import { useEffect, useRef } from "react";
-import { useRouter, useSearchParams } from "next/navigation";
-import { toast } from "sonner";
-import { useChatSession } from "@/app/(platform)/chat/useChatSession";
 import { useSupabase } from "@/lib/supabase/hooks/useSupabase";
-import { useChatStream } from "@/app/(platform)/chat/useChatStream";
+import { useEffect, useRef } from "react";
+import { toast } from "sonner";
+import { useChatSession } from "./useChatSession";
+import { useChatStream } from "./useChatStream";
 
-export function useChatPage() {
-  const router = useRouter();
-  const searchParams = useSearchParams();
-  const urlSessionId =
-    searchParams.get("session_id") || searchParams.get("session");
+export function useChat() {
   const hasCreatedSessionRef = useRef(false);
   const hasClaimedSessionRef = useRef(false);
   const { user } = useSupabase();
@@ -25,29 +20,24 @@ export function useChatPage() {
     isCreating,
     error,
     createSession,
-    refreshSession,
     claimSession,
     clearSession: clearSessionBase,
+    loadSession,
   } = useChatSession({
-    urlSessionId,
+    urlSessionId: null,
     autoCreate: false,
   });
 
   useEffect(
     function autoCreateSession() {
-      if (
-        !urlSessionId &&
-        !hasCreatedSessionRef.current &&
-        !isCreating &&
-        !sessionIdFromHook
-      ) {
+      if (!hasCreatedSessionRef.current && !isCreating && !sessionIdFromHook) {
         hasCreatedSessionRef.current = true;
         createSession().catch((_err) => {
           hasCreatedSessionRef.current = false;
         });
       }
     },
-    [urlSessionId, isCreating, sessionIdFromHook, createSession],
+    [isCreating, sessionIdFromHook, createSession],
   );
 
   useEffect(
@@ -111,7 +101,6 @@ export function useChatPage() {
     clearSessionBase();
     hasCreatedSessionRef.current = false;
     hasClaimedSessionRef.current = false;
-    router.push("/chat");
   }
 
   return {
@@ -121,8 +110,8 @@ export function useChatPage() {
     isCreating,
     error,
     createSession,
-    refreshSession,
     clearSession,
+    loadSession,
     sessionId: sessionIdFromHook,
   };
 }
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/useChatDrawer.ts b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/useChatDrawer.ts
new file mode 100644
index 0000000000..62e1a5a569
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/useChatDrawer.ts
@@ -0,0 +1,17 @@
+"use client";
+
+import { create } from "zustand";
+
+interface ChatDrawerState {
+  isOpen: boolean;
+  open: () => void;
+  close: () => void;
+  toggle: () => void;
+}
+
+export const useChatDrawer = create<ChatDrawerState>((set) => ({
+  isOpen: false,
+  open: () => set({ isOpen: true }),
+  close: () => set({ isOpen: false }),
+  toggle: () => set((state) => ({ isOpen: !state.isOpen })),
+}));
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/useChatSession.ts b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/useChatSession.ts
similarity index 89%
rename from autogpt_platform/frontend/src/app/(platform)/chat/useChatSession.ts
rename to autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/useChatSession.ts
index 99f4efc093..a54dc9e32a 100644
--- a/autogpt_platform/frontend/src/app/(platform)/chat/useChatSession.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/useChatSession.ts
@@ -1,17 +1,18 @@
-import { useCallback, useEffect, useState, useRef, useMemo } from "react";
-import { useQueryClient } from "@tanstack/react-query";
-import { toast } from "sonner";
 import {
-  usePostV2CreateSession,
+  getGetV2GetSessionQueryKey,
+  getGetV2GetSessionQueryOptions,
   postV2CreateSession,
   useGetV2GetSession,
   usePatchV2SessionAssignUser,
-  getGetV2GetSessionQueryKey,
+  usePostV2CreateSession,
 } from "@/app/api/__generated__/endpoints/chat/chat";
 import type { SessionDetailResponse } from "@/app/api/__generated__/models/sessionDetailResponse";
-import { storage, Key } from "@/services/storage/local-storage";
-import { isValidUUID } from "@/app/(platform)/chat/helpers";
 import { okData } from "@/app/api/helpers";
+import { isValidUUID } from "@/lib/utils";
+import { Key, storage } from "@/services/storage/local-storage";
+import { useQueryClient } from "@tanstack/react-query";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { toast } from "sonner";
 
 interface UseChatSessionArgs {
   urlSessionId?: string | null;
@@ -155,10 +156,22 @@ export function useChatSession({
     async function loadSession(id: string) {
       try {
         setError(null);
+        // Invalidate the query cache for this session to force a fresh fetch
+        await queryClient.invalidateQueries({
+          queryKey: getGetV2GetSessionQueryKey(id),
+        });
+        // Set sessionId after invalidation to ensure the hook refetches
         setSessionId(id);
         storage.set(Key.CHAT_SESSION_ID, id);
-        const result = await refetch();
-        if (!result.data || result.isError) {
+        // Force fetch with fresh data (bypass cache)
+        const queryOptions = getGetV2GetSessionQueryOptions(id, {
+          query: {
+            staleTime: 0, // Force fresh fetch
+            retry: 1,
+          },
+        });
+        const result = await queryClient.fetchQuery(queryOptions);
+        if (!result || ("status" in result && result.status !== 200)) {
           console.warn("Session not found on server, clearing local state");
           storage.clean(Key.CHAT_SESSION_ID);
           setSessionId(null);
@@ -171,7 +184,7 @@ export function useChatSession({
         throw error;
       }
     },
-    [refetch],
+    [queryClient],
   );
 
   const refreshSession = useCallback(
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/useChatStream.ts b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/useChatStream.ts
new file mode 100644
index 0000000000..1471a13a71
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/useChatStream.ts
@@ -0,0 +1,371 @@
+import type { ToolArguments, ToolResult } from "@/types/chat";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { toast } from "sonner";
+
+const MAX_RETRIES = 3;
+const INITIAL_RETRY_DELAY = 1000;
+
+export interface StreamChunk {
+  type:
+    | "text_chunk"
+    | "text_ended"
+    | "tool_call"
+    | "tool_call_start"
+    | "tool_response"
+    | "login_needed"
+    | "need_login"
+    | "credentials_needed"
+    | "error"
+    | "usage"
+    | "stream_end";
+  timestamp?: string;
+  content?: string;
+  message?: string;
+  tool_id?: string;
+  tool_name?: string;
+  arguments?: ToolArguments;
+  result?: ToolResult;
+  success?: boolean;
+  idx?: number;
+  session_id?: string;
+  agent_info?: {
+    graph_id: string;
+    name: string;
+    trigger_type: string;
+  };
+  provider?: string;
+  provider_name?: string;
+  credential_type?: string;
+  scopes?: string[];
+  title?: string;
+  [key: string]: unknown;
+}
+
+type VercelStreamChunk =
+  | { type: "start"; messageId: string }
+  | { type: "finish" }
+  | { type: "text-start"; id: string }
+  | { type: "text-delta"; id: string; delta: string }
+  | { type: "text-end"; id: string }
+  | { type: "tool-input-start"; toolCallId: string; toolName: string }
+  | {
+      type: "tool-input-available";
+      toolCallId: string;
+      toolName: string;
+      input: ToolArguments;
+    }
+  | {
+      type: "tool-output-available";
+      toolCallId: string;
+      toolName?: string;
+      output: ToolResult;
+      success?: boolean;
+    }
+  | {
+      type: "usage";
+      promptTokens: number;
+      completionTokens: number;
+      totalTokens: number;
+    }
+  | {
+      type: "error";
+      errorText: string;
+      code?: string;
+      details?: Record<string, unknown>;
+    };
+
+const LEGACY_STREAM_TYPES = new Set<StreamChunk["type"]>([
+  "text_chunk",
+  "text_ended",
+  "tool_call",
+  "tool_call_start",
+  "tool_response",
+  "login_needed",
+  "need_login",
+  "credentials_needed",
+  "error",
+  "usage",
+  "stream_end",
+]);
+
+function isLegacyStreamChunk(
+  chunk: StreamChunk | VercelStreamChunk,
+): chunk is StreamChunk {
+  return LEGACY_STREAM_TYPES.has(chunk.type as StreamChunk["type"]);
+}
+
+function normalizeStreamChunk(
+  chunk: StreamChunk | VercelStreamChunk,
+): StreamChunk | null {
+  if (isLegacyStreamChunk(chunk)) {
+    return chunk;
+  }
+  switch (chunk.type) {
+    case "text-delta":
+      return { type: "text_chunk", content: chunk.delta };
+    case "text-end":
+      return { type: "text_ended" };
+    case "tool-input-available":
+      return {
+        type: "tool_call_start",
+        tool_id: chunk.toolCallId,
+        tool_name: chunk.toolName,
+        arguments: chunk.input,
+      };
+    case "tool-output-available":
+      return {
+        type: "tool_response",
+        tool_id: chunk.toolCallId,
+        tool_name: chunk.toolName,
+        result: chunk.output,
+        success: chunk.success ?? true,
+      };
+    case "usage":
+      return {
+        type: "usage",
+        promptTokens: chunk.promptTokens,
+        completionTokens: chunk.completionTokens,
+        totalTokens: chunk.totalTokens,
+      };
+    case "error":
+      return {
+        type: "error",
+        message: chunk.errorText,
+        code: chunk.code,
+        details: chunk.details,
+      };
+    case "finish":
+      return { type: "stream_end" };
+    case "start":
+    case "text-start":
+    case "tool-input-start":
+      return null;
+  }
+}
+
+export function useChatStream() {
+  const [isStreaming, setIsStreaming] = useState(false);
+  const [error, setError] = useState<Error | null>(null);
+  const retryCountRef = useRef<number>(0);
+  const retryTimeoutRef = useRef<NodeJS.Timeout | null>(null);
+  const abortControllerRef = useRef<AbortController | null>(null);
+
+  const stopStreaming = useCallback(() => {
+    if (abortControllerRef.current) {
+      abortControllerRef.current.abort();
+      abortControllerRef.current = null;
+    }
+    if (retryTimeoutRef.current) {
+      clearTimeout(retryTimeoutRef.current);
+      retryTimeoutRef.current = null;
+    }
+    setIsStreaming(false);
+  }, []);
+
+  useEffect(() => {
+    return () => {
+      stopStreaming();
+    };
+  }, [stopStreaming]);
+
+  const sendMessage = useCallback(
+    async (
+      sessionId: string,
+      message: string,
+      onChunk: (chunk: StreamChunk) => void,
+      isUserMessage: boolean = true,
+      context?: { url: string; content: string },
+      isRetry: boolean = false,
+    ) => {
+      stopStreaming();
+
+      const abortController = new AbortController();
+      abortControllerRef.current = abortController;
+
+      if (abortController.signal.aborted) {
+        return Promise.reject(new Error("Request aborted"));
+      }
+
+      if (!isRetry) {
+        retryCountRef.current = 0;
+      }
+      setIsStreaming(true);
+      setError(null);
+
+      try {
+        const url = `/api/chat/sessions/${sessionId}/stream`;
+        const body = JSON.stringify({
+          message,
+          is_user_message: isUserMessage,
+          context: context || null,
+        });
+
+        const response = await fetch(url, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Accept: "text/event-stream",
+          },
+          body,
+          signal: abortController.signal,
+        });
+
+        if (!response.ok) {
+          const errorText = await response.text();
+          throw new Error(errorText || `HTTP ${response.status}`);
+        }
+
+        if (!response.body) {
+          throw new Error("Response body is null");
+        }
+
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+
+        return new Promise<void>((resolve, reject) => {
+          let didDispatchStreamEnd = false;
+
+          function dispatchStreamEnd() {
+            if (didDispatchStreamEnd) return;
+            didDispatchStreamEnd = true;
+            onChunk({ type: "stream_end" });
+          }
+
+          const cleanup = () => {
+            reader.cancel().catch(() => {
+              // Ignore cancel errors
+            });
+          };
+
+          async function readStream() {
+            try {
+              while (true) {
+                const { done, value } = await reader.read();
+
+                if (done) {
+                  cleanup();
+                  dispatchStreamEnd();
+                  retryCountRef.current = 0;
+                  stopStreaming();
+                  resolve();
+                  return;
+                }
+
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split("\n");
+                buffer = lines.pop() || "";
+
+                for (const line of lines) {
+                  if (line.startsWith("data: ")) {
+                    const data = line.slice(6);
+                    if (data === "[DONE]") {
+                      cleanup();
+                      dispatchStreamEnd();
+                      retryCountRef.current = 0;
+                      stopStreaming();
+                      resolve();
+                      return;
+                    }
+
+                    try {
+                      const rawChunk = JSON.parse(data) as
+                        | StreamChunk
+                        | VercelStreamChunk;
+                      const chunk = normalizeStreamChunk(rawChunk);
+                      if (!chunk) {
+                        continue;
+                      }
+
+                      // Call the chunk handler
+                      onChunk(chunk);
+
+                      // Handle stream lifecycle
+                      if (chunk.type === "stream_end") {
+                        didDispatchStreamEnd = true;
+                        cleanup();
+                        retryCountRef.current = 0;
+                        stopStreaming();
+                        resolve();
+                        return;
+                      } else if (chunk.type === "error") {
+                        cleanup();
+                        reject(
+                          new Error(
+                            chunk.message || chunk.content || "Stream error",
+                          ),
+                        );
+                        return;
+                      }
+                    } catch (err) {
+                      // Skip invalid JSON lines
+                      console.warn("Failed to parse SSE chunk:", err, data);
+                    }
+                  }
+                }
+              }
+            } catch (err) {
+              if (err instanceof Error && err.name === "AbortError") {
+                cleanup();
+                return;
+              }
+
+              const streamError =
+                err instanceof Error ? err : new Error("Failed to read stream");
+
+              if (retryCountRef.current < MAX_RETRIES) {
+                retryCountRef.current += 1;
+                const retryDelay =
+                  INITIAL_RETRY_DELAY * Math.pow(2, retryCountRef.current - 1);
+
+                toast.info("Connection interrupted", {
+                  description: `Retrying in ${retryDelay / 1000} seconds...`,
+                });
+
+                retryTimeoutRef.current = setTimeout(() => {
+                  sendMessage(
+                    sessionId,
+                    message,
+                    onChunk,
+                    isUserMessage,
+                    context,
+                    true,
+                  ).catch((_err) => {
+                    // Retry failed
+                  });
+                }, retryDelay);
+              } else {
+                setError(streamError);
+                toast.error("Connection Failed", {
+                  description:
+                    "Unable to connect to chat service. Please try again.",
+                });
+                cleanup();
+                dispatchStreamEnd();
+                retryCountRef.current = 0;
+                stopStreaming();
+                reject(streamError);
+              }
+            }
+          }
+
+          readStream();
+        });
+      } catch (err) {
+        const streamError =
+          err instanceof Error ? err : new Error("Failed to start stream");
+        setError(streamError);
+        setIsStreaming(false);
+        throw streamError;
+      }
+    },
+    [stopStreaming],
+  );
+
+  return {
+    isStreaming,
+    error,
+    sendMessage,
+    stopStreaming,
+  };
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/usePageContext.ts b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/usePageContext.ts
new file mode 100644
index 0000000000..c567422a5c
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/components/Chat/usePageContext.ts
@@ -0,0 +1,98 @@
+import { useCallback } from "react";
+
+export interface PageContext {
+  url: string;
+  content: string;
+}
+
+const MAX_CONTENT_CHARS = 10000;
+
+/**
+ * Hook to capture the current page context (URL + full page content)
+ * Privacy-hardened: removes sensitive inputs and enforces content size limits
+ */
+export function usePageContext() {
+  const capturePageContext = useCallback((): PageContext => {
+    if (typeof window === "undefined" || typeof document === "undefined") {
+      return { url: "", content: "" };
+    }
+
+    const url = window.location.href;
+
+    // Clone document to avoid modifying the original
+    const clone = document.cloneNode(true) as Document;
+
+    // Remove script, style, and noscript elements
+    const scripts = clone.querySelectorAll("script, style, noscript");
+    scripts.forEach((el) => el.remove());
+
+    // Remove sensitive elements and their content
+    const sensitiveSelectors = [
+      "input",
+      "textarea",
+      "[contenteditable]",
+      'input[type="password"]',
+      'input[type="email"]',
+      'input[type="tel"]',
+      'input[type="search"]',
+      'input[type="hidden"]',
+      "form",
+      "[data-sensitive]",
+      "[data-sensitive='true']",
+    ];
+
+    sensitiveSelectors.forEach((selector) => {
+      const elements = clone.querySelectorAll(selector);
+      elements.forEach((el) => {
+        // For form elements, remove the entire element
+        if (el.tagName === "FORM") {
+          el.remove();
+        } else {
+          // For inputs and textareas, clear their values but keep the element structure
+          if (
+            el instanceof HTMLInputElement ||
+            el instanceof HTMLTextAreaElement
+          ) {
+            el.value = "";
+            el.textContent = "";
+          } else {
+            // For other sensitive elements, remove them entirely
+            el.remove();
+          }
+        }
+      });
+    });
+
+    // Strip any remaining input values that might have been missed
+    const allInputs = clone.querySelectorAll("input, textarea");
+    allInputs.forEach((el) => {
+      if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
+        el.value = "";
+        el.textContent = "";
+      }
+    });
+
+    // Get text content from body
+    const body = clone.body;
+    const content = body?.textContent || body?.innerText || "";
+
+    // Clean up whitespace
+    let cleanedContent = content
+      .replace(/\s+/g, " ")
+      .replace(/\n\s*\n/g, "\n")
+      .trim();
+
+    // Enforce maximum content size
+    if (cleanedContent.length > MAX_CONTENT_CHARS) {
+      cleanedContent =
+        cleanedContent.substring(0, MAX_CONTENT_CHARS) + "... [truncated]";
+    }
+
+    return {
+      url,
+      content: cleanedContent,
+    };
+  }, []);
+
+  return { capturePageContext };
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatContainer/ChatContainer.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatContainer/ChatContainer.tsx
deleted file mode 100644
index 32f9d6c6eb..0000000000
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatContainer/ChatContainer.tsx
+++ /dev/null
@@ -1,68 +0,0 @@
-import { cn } from "@/lib/utils";
-import { ChatInput } from "@/app/(platform)/chat/components/ChatInput/ChatInput";
-import { MessageList } from "@/app/(platform)/chat/components/MessageList/MessageList";
-import { QuickActionsWelcome } from "@/app/(platform)/chat/components/QuickActionsWelcome/QuickActionsWelcome";
-import { useChatContainer } from "./useChatContainer";
-import type { SessionDetailResponse } from "@/app/api/__generated__/models/sessionDetailResponse";
-
-export interface ChatContainerProps {
-  sessionId: string | null;
-  initialMessages: SessionDetailResponse["messages"];
-  onRefreshSession: () => Promise<void>;
-  className?: string;
-}
-
-export function ChatContainer({
-  sessionId,
-  initialMessages,
-  onRefreshSession,
-  className,
-}: ChatContainerProps) {
-  const { messages, streamingChunks, isStreaming, sendMessage } =
-    useChatContainer({
-      sessionId,
-      initialMessages,
-      onRefreshSession,
-    });
-
-  const quickActions = [
-    "Find agents for social media management",
-    "Show me agents for content creation",
-    "Help me automate my business",
-    "What can you help me with?",
-  ];
-
-  return (
-    <div className={cn("flex h-full flex-col", className)}>
-      {/* Messages or Welcome Screen */}
-      {messages.length === 0 ? (
-        <QuickActionsWelcome
-          title="Welcome to AutoGPT Chat"
-          description="Start a conversation to discover and run AI agents."
-          actions={quickActions}
-          onActionClick={sendMessage}
-          disabled={isStreaming || !sessionId}
-        />
-      ) : (
-        <MessageList
-          messages={messages}
-          streamingChunks={streamingChunks}
-          isStreaming={isStreaming}
-          onSendMessage={sendMessage}
-          className="flex-1"
-        />
-      )}
-
-      {/* Input - Always visible */}
-      <div className="border-t border-zinc-200 p-4 dark:border-zinc-800">
-        <ChatInput
-          onSend={sendMessage}
-          disabled={isStreaming || !sessionId}
-          placeholder={
-            sessionId ? "Type your message..." : "Creating session..."
-          }
-        />
-      </div>
-    </div>
-  );
-}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatContainer/useChatContainer.ts b/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatContainer/useChatContainer.ts
deleted file mode 100644
index c75ad587a5..0000000000
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatContainer/useChatContainer.ts
+++ /dev/null
@@ -1,130 +0,0 @@
-import { useState, useCallback, useRef, useMemo } from "react";
-import { toast } from "sonner";
-import { useChatStream } from "@/app/(platform)/chat/useChatStream";
-import type { SessionDetailResponse } from "@/app/api/__generated__/models/sessionDetailResponse";
-import type { ChatMessageData } from "@/app/(platform)/chat/components/ChatMessage/useChatMessage";
-import {
-  parseToolResponse,
-  isValidMessage,
-  isToolCallArray,
-  createUserMessage,
-  filterAuthMessages,
-} from "./helpers";
-import { createStreamEventDispatcher } from "./createStreamEventDispatcher";
-
-interface UseChatContainerArgs {
-  sessionId: string | null;
-  initialMessages: SessionDetailResponse["messages"];
-  onRefreshSession: () => Promise<void>;
-}
-
-export function useChatContainer({
-  sessionId,
-  initialMessages,
-}: UseChatContainerArgs) {
-  const [messages, setMessages] = useState<ChatMessageData[]>([]);
-  const [streamingChunks, setStreamingChunks] = useState<string[]>([]);
-  const [hasTextChunks, setHasTextChunks] = useState(false);
-  const streamingChunksRef = useRef<string[]>([]);
-  const { error, sendMessage: sendStreamMessage } = useChatStream();
-  const isStreaming = hasTextChunks;
-
-  const allMessages = useMemo(() => {
-    const processedInitialMessages = initialMessages
-      .filter((msg: Record<string, unknown>) => {
-        if (!isValidMessage(msg)) {
-          console.warn("Invalid message structure from backend:", msg);
-          return false;
-        }
-        const content = String(msg.content || "").trim();
-        const toolCalls = msg.tool_calls;
-        return (
-          content.length > 0 ||
-          (toolCalls && Array.isArray(toolCalls) && toolCalls.length > 0)
-        );
-      })
-      .map((msg: Record<string, unknown>) => {
-        const content = String(msg.content || "");
-        const role = String(msg.role || "assistant").toLowerCase();
-        const toolCalls = msg.tool_calls;
-        if (
-          role === "assistant" &&
-          toolCalls &&
-          isToolCallArray(toolCalls) &&
-          toolCalls.length > 0
-        ) {
-          return null;
-        }
-        if (role === "tool") {
-          const timestamp = msg.timestamp
-            ? new Date(msg.timestamp as string)
-            : undefined;
-          const toolResponse = parseToolResponse(
-            content,
-            (msg.tool_call_id as string) || "",
-            "unknown",
-            timestamp,
-          );
-          if (!toolResponse) {
-            return null;
-          }
-          return toolResponse;
-        }
-        return {
-          type: "message",
-          role: role as "user" | "assistant" | "system",
-          content,
-          timestamp: msg.timestamp
-            ? new Date(msg.timestamp as string)
-            : undefined,
-        };
-      })
-      .filter((msg): msg is ChatMessageData => msg !== null);
-
-    return [...processedInitialMessages, ...messages];
-  }, [initialMessages, messages]);
-
-  const sendMessage = useCallback(
-    async function sendMessage(content: string, isUserMessage: boolean = true) {
-      if (!sessionId) {
-        console.error("Cannot send message: no session ID");
-        return;
-      }
-      if (isUserMessage) {
-        const userMessage = createUserMessage(content);
-        setMessages((prev) => [...filterAuthMessages(prev), userMessage]);
-      } else {
-        setMessages((prev) => filterAuthMessages(prev));
-      }
-      setStreamingChunks([]);
-      streamingChunksRef.current = [];
-      setHasTextChunks(false);
-      const dispatcher = createStreamEventDispatcher({
-        setHasTextChunks,
-        setStreamingChunks,
-        streamingChunksRef,
-        setMessages,
-        sessionId,
-      });
-      try {
-        await sendStreamMessage(sessionId, content, dispatcher, isUserMessage);
-      } catch (err) {
-        console.error("Failed to send message:", err);
-        const errorMessage =
-          err instanceof Error ? err.message : "Failed to send message";
-        toast.error("Failed to send message", {
-          description: errorMessage,
-        });
-      }
-    },
-    [sessionId, sendStreamMessage],
-  );
-
-  return {
-    messages: allMessages,
-    streamingChunks,
-    isStreaming,
-    error,
-    sendMessage,
-  };
-}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatCredentialsSetup/ChatCredentialsSetup.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatCredentialsSetup/ChatCredentialsSetup.tsx
deleted file mode 100644
index 1f70f7740f..0000000000
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatCredentialsSetup/ChatCredentialsSetup.tsx
+++ /dev/null
@@ -1,153 +0,0 @@
-import { CredentialsInput } from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/CredentialsInputs";
-import { Card } from "@/components/atoms/Card/Card";
-import { Text } from "@/components/atoms/Text/Text";
-import type { BlockIOCredentialsSubSchema } from "@/lib/autogpt-server-api";
-import { cn } from "@/lib/utils";
-import { CheckIcon, KeyIcon, WarningIcon } from "@phosphor-icons/react";
-import { useEffect, useRef } from "react";
-import { useChatCredentialsSetup } from "./useChatCredentialsSetup";
-
-export interface CredentialInfo {
-  provider: string;
-  providerName: string;
-  credentialType: "api_key" | "oauth2" | "user_password" | "host_scoped";
-  title: string;
-  scopes?: string[];
-}
-
-interface Props {
-  credentials: CredentialInfo[];
-  agentName?: string;
-  message: string;
-  onAllCredentialsComplete: () => void;
-  onCancel: () => void;
-  className?: string;
-}
-
-function createSchemaFromCredentialInfo(
-  credential: CredentialInfo,
-): BlockIOCredentialsSubSchema {
-  return {
-    type: "object",
-    properties: {},
-    credentials_provider: [credential.provider],
-    credentials_types: [credential.credentialType],
-    credentials_scopes: credential.scopes,
-    discriminator: undefined,
-    discriminator_mapping: undefined,
-    discriminator_values: undefined,
-  };
-}
-
-export function ChatCredentialsSetup({
-  credentials,
-  agentName: _agentName,
-  message,
-  onAllCredentialsComplete,
-  onCancel: _onCancel,
-  className,
-}: Props) {
-  const { selectedCredentials, isAllComplete, handleCredentialSelect } =
-    useChatCredentialsSetup(credentials);
-
-  // Track if we've already called completion to prevent double calls
-  const hasCalledCompleteRef = useRef(false);
-
-  // Reset the completion flag when credentials change (new credential setup flow)
-  useEffect(
-    function resetCompletionFlag() {
-      hasCalledCompleteRef.current = false;
-    },
-    [credentials],
-  );
-
-  // Auto-call completion when all credentials are configured
-  useEffect(
-    function autoCompleteWhenReady() {
-      if (isAllComplete && !hasCalledCompleteRef.current) {
-        hasCalledCompleteRef.current = true;
-        onAllCredentialsComplete();
-      }
-    },
-    [isAllComplete, onAllCredentialsComplete],
-  );
-
-  return (
-    <Card
-      className={cn(
-        "mx-4 my-2 overflow-hidden border-orange-200 bg-orange-50 dark:border-orange-900 dark:bg-orange-950",
-        className,
-      )}
-    >
-      <div className="flex items-start gap-4 p-6">
-        <div className="flex h-12 w-12 flex-shrink-0 items-center justify-center rounded-full bg-orange-500">
-          <KeyIcon size={24} weight="bold" className="text-white" />
-        </div>
-        <div className="flex-1">
-          <Text
-            variant="h3"
-            className="mb-2 text-orange-900 dark:text-orange-100"
-          >
-            Credentials Required
-          </Text>
-          <Text
-            variant="body"
-            className="mb-4 text-orange-700 dark:text-orange-300"
-          >
-            {message}
-          </Text>
-
-          <div className="space-y-3">
-            {credentials.map((cred, index) => {
-              const schema = createSchemaFromCredentialInfo(cred);
-              const isSelected = !!selectedCredentials[cred.provider];
-
-              return (
-                <div
-                  key={`${cred.provider}-${index}`}
-                  className={cn(
-                    "relative rounded-lg border border-orange-200 bg-white p-4 dark:border-orange-800 dark:bg-orange-900/20",
-                    isSelected &&
-                      "border-green-500 bg-green-50 dark:border-green-700 dark:bg-green-950/30",
-                  )}
-                >
-                  <div className="mb-2 flex items-center justify-between">
-                    <div className="flex items-center gap-2">
-                      {isSelected ? (
-                        <CheckIcon
-                          size={20}
-                          className="text-green-500"
-                          weight="bold"
-                        />
-                      ) : (
-                        <WarningIcon
-                          size={20}
-                          className="text-orange-500"
-                          weight="bold"
-                        />
-                      )}
-                      <Text
-                        variant="body"
-                        className="font-semibold text-orange-900 dark:text-orange-100"
-                      >
-                        {cred.providerName}
-                      </Text>
-                    </div>
-                  </div>
-
-                  <CredentialsInput
-                    schema={schema}
-                    selectedCredentials={selectedCredentials[cred.provider]}
-                    onSelectCredentials={(credMeta) =>
-                      handleCredentialSelect(cred.provider, credMeta)
-                    }
-                  />
-                </div>
-              );
-            })}
-          </div>
-        </div>
-      </div>
-    </Card>
-  );
-}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatInput/ChatInput.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatInput/ChatInput.tsx
deleted file mode 100644
index f1caceef70..0000000000
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatInput/ChatInput.tsx
+++ /dev/null
@@ -1,63 +0,0 @@
-import { cn } from "@/lib/utils";
-import { PaperPlaneRightIcon } from "@phosphor-icons/react";
-import { Button } from "@/components/atoms/Button/Button";
-import { useChatInput } from "./useChatInput";
-
-export interface ChatInputProps {
-  onSend: (message: string) => void;
-  disabled?: boolean;
-  placeholder?: string;
-  className?: string;
-}
-
-export function ChatInput({
-  onSend,
-  disabled = false,
-  placeholder = "Type your message...",
-  className,
-}: ChatInputProps) {
-  const { value, setValue, handleKeyDown, handleSend, textareaRef } =
-    useChatInput({
-      onSend,
-      disabled,
-      maxRows: 5,
-    });
-
-  return (
-    <div className={cn("flex gap-2", className)}>
-      <textarea
-        ref={textareaRef}
-        value={value}
-        onChange={(e) => setValue(e.target.value)}
-        onKeyDown={handleKeyDown}
-        placeholder={placeholder}
-        disabled={disabled}
-        rows={1}
-        autoComplete="off"
-        aria-label="Chat message input"
-        aria-describedby="chat-input-hint"
-        className={cn(
-          "flex-1 resize-none rounded-lg border border-neutral-200 bg-white px-4 py-2 text-sm",
-          "placeholder:text-neutral-400",
-          "focus:border-violet-600 focus:outline-none focus:ring-2 focus:ring-violet-600/20",
-          "dark:border-neutral-800 dark:bg-neutral-900 dark:text-neutral-100 dark:placeholder:text-neutral-500",
-          "disabled:cursor-not-allowed disabled:opacity-50",
-        )}
-      />
-      <span id="chat-input-hint" className="sr-only">
-        Press Enter to send, Shift+Enter for new line
-      </span>
-
-      <Button
-        variant="primary"
-        size="small"
-        onClick={handleSend}
-        disabled={disabled || !value.trim()}
-        className="self-end"
-        aria-label="Send message"
-      >
-        <PaperPlaneRightIcon className="h-4 w-4" weight="fill" />
-      </Button>
-    </div>
-  );
-}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatLoadingState/ChatLoadingState.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatLoadingState/ChatLoadingState.tsx
deleted file mode 100644
index 20f2a980f0..0000000000
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatLoadingState/ChatLoadingState.tsx
+++ /dev/null
@@ -1,31 +0,0 @@
-import React from "react";
-import { Text } from "@/components/atoms/Text/Text";
-import { ArrowClockwiseIcon } from "@phosphor-icons/react";
-import { cn } from "@/lib/utils";
-
-export interface ChatLoadingStateProps {
-  message?: string;
-  className?: string;
-}
-
-export function ChatLoadingState({
-  message = "Loading...",
-  className,
-}: ChatLoadingStateProps) {
-  return (
-    <div
-      className={cn("flex flex-1 items-center justify-center p-6", className)}
-    >
-      <div className="flex flex-col items-center gap-4 text-center">
-        <ArrowClockwiseIcon
-          size={32}
-          weight="bold"
-          className="animate-spin text-purple-500"
-        />
-        <Text variant="body" className="text-zinc-600 dark:text-zinc-400">
-          {message}
-        </Text>
-      </div>
-    </div>
-  );
-}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatMessage/ChatMessage.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatMessage/ChatMessage.tsx
deleted file mode 100644
index 6d8fdacb9a..0000000000
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/ChatMessage/ChatMessage.tsx
+++ /dev/null
@@ -1,194 +0,0 @@
-"use client";
-
-import { cn } from "@/lib/utils";
-import { RobotIcon, UserIcon, CheckCircleIcon } from "@phosphor-icons/react";
-import { useCallback } from "react";
-import { MessageBubble } from "@/app/(platform)/chat/components/MessageBubble/MessageBubble";
-import { MarkdownContent } from "@/app/(platform)/chat/components/MarkdownContent/MarkdownContent";
-import { ToolCallMessage } from "@/app/(platform)/chat/components/ToolCallMessage/ToolCallMessage";
-import { ToolResponseMessage } from "@/app/(platform)/chat/components/ToolResponseMessage/ToolResponseMessage";
-import { AuthPromptWidget } from "@/app/(platform)/chat/components/AuthPromptWidget/AuthPromptWidget";
-import { ChatCredentialsSetup } from "@/app/(platform)/chat/components/ChatCredentialsSetup/ChatCredentialsSetup";
-import { useSupabase } from "@/lib/supabase/hooks/useSupabase";
-import { useChatMessage, type ChatMessageData } from "./useChatMessage";
-import { getToolActionPhrase } from "@/app/(platform)/chat/helpers";
-export interface ChatMessageProps {
-  message: ChatMessageData;
-  className?: string;
-  onDismissLogin?: () => void;
-  onDismissCredentials?: () => void;
-  onSendMessage?: (content: string, isUserMessage?: boolean) => void;
-}
-
-export function ChatMessage({
-  message,
-  className,
-  onDismissCredentials,
-  onSendMessage,
-}: ChatMessageProps) {
-  const { user } = useSupabase();
-  const {
-    formattedTimestamp,
-    isUser,
-    isAssistant,
-    isToolCall,
-    isToolResponse,
-    isLoginNeeded,
-    isCredentialsNeeded,
-  } = useChatMessage(message);
-
-  const handleAllCredentialsComplete = useCallback(
-    function handleAllCredentialsComplete() {
-      // Send a user message that explicitly asks to retry the setup
-      // This ensures the LLM calls get_required_setup_info again and proceeds with execution
-      if (onSendMessage) {
-        onSendMessage(
-          "I've configured the required credentials. Please check if everything is ready and proceed with setting up the agent.",
-        );
-      }
-      // Optionally dismiss the credentials prompt
-      if (onDismissCredentials) {
-        onDismissCredentials();
-      }
-    },
-    [onSendMessage, onDismissCredentials],
-  );
-
-  function handleCancelCredentials() {
-    // Dismiss the credentials prompt
-    if (onDismissCredentials) {
-      onDismissCredentials();
-    }
-  }
-
-  // Render credentials needed messages
-  if (isCredentialsNeeded && message.type === "credentials_needed") {
-    return (
-      <ChatCredentialsSetup
-        credentials={message.credentials}
-        agentName={message.agentName}
-        message={message.message}
-        onAllCredentialsComplete={handleAllCredentialsComplete}
-        onCancel={handleCancelCredentials}
-        className={className}
-      />
-    );
-  }
-
-  // Render login needed messages
-  if (isLoginNeeded && message.type === "login_needed") {
-    // If user is already logged in, show success message instead of auth prompt
-    if (user) {
-      return (
-        <div className={cn("px-4 py-2", className)}>
-          <div className="my-4 overflow-hidden rounded-lg border border-green-200 bg-gradient-to-br from-green-50 to-emerald-50 dark:border-green-800 dark:from-green-950/30 dark:to-emerald-950/30">
-            <div className="px-6 py-4">
-              <div className="flex items-center gap-3">
-                <div className="flex h-10 w-10 items-center justify-center rounded-full bg-green-600">
-                  <CheckCircleIcon
-                    size={20}
-                    weight="fill"
-                    className="text-white"
-                  />
-                </div>
-                <div>
-                  <h3 className="text-lg font-semibold text-neutral-900 dark:text-neutral-100">
-                    Successfully Authenticated
-                  </h3>
-                  <p className="text-sm text-neutral-600 dark:text-neutral-400">
-                    You&apos;re now signed in and ready to continue
-                  </p>
-                </div>
-              </div>
-            </div>
-          </div>
-        </div>
-      );
-    }
-
-    // Show auth prompt if not logged in
-    return (
-      <div className={cn("px-4 py-2", className)}>
-        <AuthPromptWidget
-          message={message.message}
-          sessionId={message.sessionId}
-          agentInfo={message.agentInfo}
-          returnUrl="/chat"
-        />
-      </div>
-    );
-  }
-
-  // Render tool call messages
-  if (isToolCall && message.type === "tool_call") {
-    return (
-      <div className={cn("px-4 py-2", className)}>
-        <ToolCallMessage toolName={message.toolName} />
-      </div>
-    );
-  }
-
-  // Render tool response messages
-  if (
-    (isToolResponse && message.type === "tool_response") ||
-    message.type === "no_results" ||
-    message.type === "agent_carousel" ||
-    message.type === "execution_started"
-  ) {
-    return (
-      <div className={cn("px-4 py-2", className)}>
-        <ToolResponseMessage toolName={getToolActionPhrase(message.toolName)} />
-      </div>
-    );
-  }
-
-  // Render regular chat messages
-  if (message.type === "message") {
-    return (
-      <div
-        className={cn(
-          "flex gap-3 px-4 py-4",
-          isUser && "flex-row-reverse",
-          className,
-        )}
-      >
-        {/* Avatar */}
-        <div className="flex-shrink-0">
-          <div
-            className={cn(
-              "flex h-8 w-8 items-center justify-center rounded-full",
-              isUser && "bg-zinc-200 dark:bg-zinc-700",
-              isAssistant && "bg-purple-600 dark:bg-purple-500",
-            )}
-          >
-            {isUser ? (
-              <UserIcon className="h-5 w-5 text-zinc-700 dark:text-zinc-200" />
-            ) : (
-              <RobotIcon className="h-5 w-5 text-white" />
-            )}
-          </div>
-        </div>
-
-        {/* Message Content */}
-        <div className={cn("flex max-w-[70%] flex-col", isUser && "items-end")}>
-          <MessageBubble variant={isUser ? "user" : "assistant"}>
-            <MarkdownContent content={message.content} />
-          </MessageBubble>
-
-          {/* Timestamp */}
-          <span
-            className={cn(
-              "mt-1 text-xs text-zinc-500 dark:text-zinc-400",
-              isUser && "text-right",
-            )}
-          >
-            {formattedTimestamp}
-          </span>
-        </div>
-      </div>
-    );
-  }
-
-  // Fallback for unknown message types
-  return null;
-}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/MessageBubble/MessageBubble.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/MessageBubble/MessageBubble.tsx
deleted file mode 100644
index 96798493a1..0000000000
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/MessageBubble/MessageBubble.tsx
+++ /dev/null
@@ -1,28 +0,0 @@
-import { cn } from "@/lib/utils";
-import { ReactNode } from "react";
-
-export interface MessageBubbleProps {
-  children: ReactNode;
-  variant: "user" | "assistant";
-  className?: string;
-}
-
-export function MessageBubble({
-  children,
-  variant,
-  className,
-}: MessageBubbleProps) {
-  return (
-    <div
-      className={cn(
-        "rounded-lg px-4 py-3 text-sm",
-        variant === "user" && "bg-violet-600 text-white dark:bg-violet-500",
-        variant === "assistant" &&
-          "border border-neutral-200 bg-white dark:border-neutral-700 dark:bg-neutral-900 dark:text-neutral-100",
-        className,
-      )}
-    >
-      {children}
-    </div>
-  );
-}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/MessageList/MessageList.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/MessageList/MessageList.tsx
deleted file mode 100644
index aa8c4d9772..0000000000
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/MessageList/MessageList.tsx
+++ /dev/null
@@ -1,61 +0,0 @@
-import { cn } from "@/lib/utils";
-import { ChatMessage } from "../ChatMessage/ChatMessage";
-import type { ChatMessageData } from "../ChatMessage/useChatMessage";
-import { StreamingMessage } from "../StreamingMessage/StreamingMessage";
-import { useMessageList } from "./useMessageList";
-
-export interface MessageListProps {
-  messages: ChatMessageData[];
-  streamingChunks?: string[];
-  isStreaming?: boolean;
-  className?: string;
-  onStreamComplete?: () => void;
-  onSendMessage?: (content: string) => void;
-}
-
-export function MessageList({
-  messages,
-  streamingChunks = [],
-  isStreaming = false,
-  className,
-  onStreamComplete,
-  onSendMessage,
-}: MessageListProps) {
-  const { messagesEndRef, messagesContainerRef } = useMessageList({
-    messageCount: messages.length,
-    isStreaming,
-  });
-
-  return (
-    <div
-      ref={messagesContainerRef}
-      className={cn(
-        "flex-1 overflow-y-auto",
-        "scrollbar-thin scrollbar-track-transparent scrollbar-thumb-zinc-300 dark:scrollbar-thumb-zinc-700",
-        className,
-      )}
-    >
-      <div className="space-y-0">
-        {/* Render all persisted messages */}
-        {messages.map((message, index) => (
-          <ChatMessage
-            key={index}
-            message={message}
-            onSendMessage={onSendMessage}
-          />
-        ))}
-
-        {/* Render streaming message if active */}
-        {isStreaming && streamingChunks.length > 0 && (
-          <StreamingMessage
-            chunks={streamingChunks}
-            onComplete={onStreamComplete}
-          />
-        )}
-
-        {/* Invisible div to scroll to */}
-        <div ref={messagesEndRef} />
-      </div>
-    </div>
-  );
-}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/QuickActionsWelcome/QuickActionsWelcome.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/QuickActionsWelcome/QuickActionsWelcome.tsx
deleted file mode 100644
index 0cf637542a..0000000000
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/QuickActionsWelcome/QuickActionsWelcome.tsx
+++ /dev/null
@@ -1,51 +0,0 @@
-import React from "react";
-import { Text } from "@/components/atoms/Text/Text";
-import { cn } from "@/lib/utils";
-
-export interface QuickActionsWelcomeProps {
-  title: string;
-  description: string;
-  actions: string[];
-  onActionClick: (action: string) => void;
-  disabled?: boolean;
-  className?: string;
-}
-
-export function QuickActionsWelcome({
-  title,
-  description,
-  actions,
-  onActionClick,
-  disabled = false,
-  className,
-}: QuickActionsWelcomeProps) {
-  return (
-    <div
-      className={cn("flex flex-1 items-center justify-center p-4", className)}
-    >
-      <div className="max-w-2xl text-center">
-        <Text
-          variant="h2"
-          className="mb-4 text-3xl font-bold text-zinc-900 dark:text-zinc-100"
-        >
-          {title}
-        </Text>
-        <Text variant="body" className="mb-8 text-zinc-600 dark:text-zinc-400">
-          {description}
-        </Text>
-        <div className="grid gap-2 sm:grid-cols-2">
-          {actions.map((action) => (
-            <button
-              key={action}
-              onClick={() => onActionClick(action)}
-              disabled={disabled}
-              className="rounded-lg border border-zinc-200 bg-white p-4 text-left text-sm hover:bg-zinc-50 disabled:cursor-not-allowed disabled:opacity-50 dark:border-zinc-800 dark:bg-zinc-900 dark:hover:bg-zinc-800"
-            >
-              {action}
-            </button>
-          ))}
-        </div>
-      </div>
-    </div>
-  );
-}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/StreamingMessage/StreamingMessage.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/StreamingMessage/StreamingMessage.tsx
deleted file mode 100644
index 73b0419740..0000000000
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/StreamingMessage/StreamingMessage.tsx
+++ /dev/null
@@ -1,42 +0,0 @@
-import { cn } from "@/lib/utils";
-import { Robot } from "@phosphor-icons/react";
-import { MessageBubble } from "@/app/(platform)/chat/components/MessageBubble/MessageBubble";
-import { MarkdownContent } from "@/app/(platform)/chat/components/MarkdownContent/MarkdownContent";
-import { useStreamingMessage } from "./useStreamingMessage";
-
-export interface StreamingMessageProps {
-  chunks: string[];
-  className?: string;
-  onComplete?: () => void;
-}
-
-export function StreamingMessage({
-  chunks,
-  className,
-  onComplete,
-}: StreamingMessageProps) {
-  const { displayText } = useStreamingMessage({ chunks, onComplete });
-
-  return (
-    <div className={cn("flex gap-3 px-4 py-4", className)}>
-      {/* Avatar */}
-      <div className="flex-shrink-0">
-        <div className="flex h-8 w-8 items-center justify-center rounded-full bg-purple-600 dark:bg-purple-500">
-          <Robot className="h-5 w-5 text-white" />
-        </div>
-      </div>
-
-      {/* Message Content */}
-      <div className="flex max-w-[70%] flex-col">
-        <MessageBubble variant="assistant">
-          <MarkdownContent content={displayText} />
-        </MessageBubble>
-
-        {/* Timestamp */}
-        <span className="mt-1 text-xs text-neutral-500 dark:text-neutral-400">
-          Typing...
-        </span>
-      </div>
-    </div>
-  );
-}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/ToolCallMessage/ToolCallMessage.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/ToolCallMessage/ToolCallMessage.tsx
deleted file mode 100644
index c1babc587c..0000000000
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/ToolCallMessage/ToolCallMessage.tsx
+++ /dev/null
@@ -1,49 +0,0 @@
-import React from "react";
-import { WrenchIcon } from "@phosphor-icons/react";
-import { cn } from "@/lib/utils";
-import { getToolActionPhrase } from "@/app/(platform)/chat/helpers";
-
-export interface ToolCallMessageProps {
-  toolName: string;
-  className?: string;
-}
-
-export function ToolCallMessage({ toolName, className }: ToolCallMessageProps) {
-  return (
-    <div
-      className={cn(
-        "mx-10 max-w-[70%] overflow-hidden rounded-lg border transition-all duration-200",
-        "border-neutral-200 dark:border-neutral-700",
-        "bg-white dark:bg-neutral-900",
-        "animate-in fade-in-50 slide-in-from-top-1",
-        className,
-      )}
-    >
-      {/* Header */}
-      <div
-        className={cn(
-          "flex items-center justify-between px-3 py-2",
-          "bg-gradient-to-r from-neutral-50 to-neutral-100 dark:from-neutral-800/20 dark:to-neutral-700/20",
-        )}
-      >
-        <div className="flex items-center gap-2 overflow-hidden">
-          <WrenchIcon
-            size={16}
-            weight="bold"
-            className="flex-shrink-0 text-neutral-500 dark:text-neutral-400"
-          />
-          <span className="relative inline-block overflow-hidden text-sm font-medium text-neutral-700 dark:text-neutral-300">
-            {getToolActionPhrase(toolName)}...
-            <span
-              className={cn(
-                "absolute inset-0 bg-gradient-to-r from-transparent via-white/50 to-transparent",
-                "dark:via-white/20",
-                "animate-shimmer",
-              )}
-            />
-          </span>
-        </div>
-      </div>
-    </div>
-  );
-}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/components/ToolResponseMessage/ToolResponseMessage.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/components/ToolResponseMessage/ToolResponseMessage.tsx
deleted file mode 100644
index fe5d858461..0000000000
--- a/autogpt_platform/frontend/src/app/(platform)/chat/components/ToolResponseMessage/ToolResponseMessage.tsx
+++ /dev/null
@@ -1,52 +0,0 @@
-import React from "react";
-import { WrenchIcon } from "@phosphor-icons/react";
-import { cn } from "@/lib/utils";
-import { getToolActionPhrase } from "@/app/(platform)/chat/helpers";
-
-export interface ToolResponseMessageProps {
-  toolName: string;
-  success?: boolean;
-  className?: string;
-}
-
-export function ToolResponseMessage({
-  toolName,
-  success = true,
-  className,
-}: ToolResponseMessageProps) {
-  return (
-    <div
-      className={cn(
-        "mx-10 max-w-[70%] overflow-hidden rounded-lg border transition-all duration-200",
-        success
-          ? "border-neutral-200 dark:border-neutral-700"
-          : "border-red-200 dark:border-red-800",
-        "bg-white dark:bg-neutral-900",
-        "animate-in fade-in-50 slide-in-from-top-1",
-        className,
-      )}
-    >
-      {/* Header */}
-      <div
-        className={cn(
-          "flex items-center justify-between px-3 py-2",
-          "bg-gradient-to-r",
-          success
-            ? "from-neutral-50 to-neutral-100 dark:from-neutral-800/20 dark:to-neutral-700/20"
-            : "from-red-50 to-red-100 dark:from-red-900/20 dark:to-red-800/20",
-        )}
-      >
-        <div className="flex items-center gap-2">
-          <WrenchIcon
-            size={16}
-            weight="bold"
-            className="text-neutral-500 dark:text-neutral-400"
-          />
-          <span className="text-sm font-medium text-neutral-700 dark:text-neutral-300">
-            {getToolActionPhrase(toolName)}...
-          </span>
-        </div>
-      </div>
-    </div>
-  );
-}
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/page.tsx b/autogpt_platform/frontend/src/app/(platform)/chat/page.tsx
index 09e530c296..9c04e40594 100644
--- a/autogpt_platform/frontend/src/app/(platform)/chat/page.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/chat/page.tsx
@@ -1,30 +1,17 @@
 "use client";
 
-import { useChatPage } from "./useChatPage";
-import { ChatContainer } from "./components/ChatContainer/ChatContainer";
-import { ChatErrorState } from "./components/ChatErrorState/ChatErrorState";
-import { ChatLoadingState } from "./components/ChatLoadingState/ChatLoadingState";
-import { useGetFlag, Flag } from "@/services/feature-flags/use-get-flag";
+import { Flag, useGetFlag } from "@/services/feature-flags/use-get-flag";
 import { useRouter } from "next/navigation";
 import { useEffect } from "react";
+import { Chat } from "./components/Chat/Chat";
 
 export default function ChatPage() {
   const isChatEnabled = useGetFlag(Flag.CHAT);
   const router = useRouter();
-  const {
-    messages,
-    isLoading,
-    isCreating,
-    error,
-    sessionId,
-    createSession,
-    clearSession,
-    refreshSession,
-  } = useChatPage();
 
   useEffect(() => {
     if (isChatEnabled === false) {
-      router.push("/404");
+      router.push("/marketplace");
     }
   }, [isChatEnabled, router]);
 
@@ -34,50 +21,7 @@ export default function ChatPage() {
 
   return (
     <div className="flex h-full flex-col">
-      {/* Header */}
-      <header className="border-b border-zinc-200 bg-white p-4 dark:border-zinc-800 dark:bg-zinc-900">
-        <div className="container mx-auto flex items-center justify-between">
-          <h1 className="text-xl font-semibold">Chat</h1>
-          {sessionId && (
-            <div className="flex items-center gap-4">
-              <span className="text-sm text-zinc-600 dark:text-zinc-400">
-                Session: {sessionId.slice(0, 8)}...
-              </span>
-              <button
-                onClick={clearSession}
-                className="text-sm text-zinc-600 hover:text-zinc-900 dark:text-zinc-400 dark:hover:text-zinc-100"
-              >
-                New Chat
-              </button>
-            </div>
-          )}
-        </div>
-      </header>
-
-      {/* Main Content */}
-      <main className="container mx-auto flex flex-1 flex-col overflow-hidden">
-        {/* Loading State - show when explicitly loading/creating OR when we don't have a session yet and no error */}
-        {(isLoading || isCreating || (!sessionId && !error)) && (
-          <ChatLoadingState
-            message={isCreating ? "Creating session..." : "Loading..."}
-          />
-        )}
-
-        {/* Error State */}
-        {error && !isLoading && (
-          <ChatErrorState error={error} onRetry={createSession} />
-        )}
-
-        {/* Session Content */}
-        {sessionId && !isLoading && !error && (
-          <ChatContainer
-            sessionId={sessionId}
-            initialMessages={messages}
-            onRefreshSession={refreshSession}
-            className="flex-1"
-          />
-        )}
-      </main>
+      <Chat className="flex-1" />
     </div>
   );
 }
diff --git a/autogpt_platform/frontend/src/app/(platform)/chat/useChatStream.ts b/autogpt_platform/frontend/src/app/(platform)/chat/useChatStream.ts
deleted file mode 100644
index 40455e9979..0000000000
--- a/autogpt_platform/frontend/src/app/(platform)/chat/useChatStream.ts
+++ /dev/null
@@ -1,204 +0,0 @@
-import { useState, useCallback, useRef, useEffect } from "react";
-import { toast } from "sonner";
-import type { ToolArguments, ToolResult } from "@/types/chat";
-
-const MAX_RETRIES = 3;
-const INITIAL_RETRY_DELAY = 1000;
-
-export interface StreamChunk {
-  type:
-    | "text_chunk"
-    | "text_ended"
-    | "tool_call"
-    | "tool_call_start"
-    | "tool_response"
-    | "login_needed"
-    | "need_login"
-    | "credentials_needed"
-    | "error"
-    | "usage"
-    | "stream_end";
-  timestamp?: string;
-  content?: string;
-  message?: string;
-  tool_id?: string;
-  tool_name?: string;
-  arguments?: ToolArguments;
-  result?: ToolResult;
-  success?: boolean;
-  idx?: number;
-  session_id?: string;
-  agent_info?: {
-    graph_id: string;
-    name: string;
-    trigger_type: string;
-  };
-  provider?: string;
-  provider_name?: string;
-  credential_type?: string;
-  scopes?: string[];
-  title?: string;
-  [key: string]: unknown;
-}
-
-export function useChatStream() {
-  const [isStreaming, setIsStreaming] = useState(false);
-  const [error, setError] = useState<Error | null>(null);
-  const eventSourceRef = useRef<EventSource | null>(null);
-  const retryCountRef = useRef<number>(0);
-  const retryTimeoutRef = useRef<NodeJS.Timeout | null>(null);
-  const abortControllerRef = useRef<AbortController | null>(null);
-
-  const stopStreaming = useCallback(() => {
-    if (abortControllerRef.current) {
-      abortControllerRef.current.abort();
-      abortControllerRef.current = null;
-    }
-    if (eventSourceRef.current) {
-      eventSourceRef.current.close();
-      eventSourceRef.current = null;
-    }
-    if (retryTimeoutRef.current) {
-      clearTimeout(retryTimeoutRef.current);
-      retryTimeoutRef.current = null;
-    }
-    retryCountRef.current = 0;
-    setIsStreaming(false);
-  }, []);
-
-  useEffect(() => {
-    return () => {
-      stopStreaming();
-    };
-  }, [stopStreaming]);
-
-  const sendMessage = useCallback(
-    async (
-      sessionId: string,
-      message: string,
-      onChunk: (chunk: StreamChunk) => void,
-      isUserMessage: boolean = true,
-    ) => {
-      stopStreaming();
-
-      const abortController = new AbortController();
-      abortControllerRef.current = abortController;
-
-      if (abortController.signal.aborted) {
-        return Promise.reject(new Error("Request aborted"));
-      }
-
-      retryCountRef.current = 0;
-      setIsStreaming(true);
-      setError(null);
-
-      try {
-        const url = `/api/chat/sessions/${sessionId}/stream?message=${encodeURIComponent(
-          message,
-        )}&is_user_message=${isUserMessage}`;
-
-        const eventSource = new EventSource(url);
-        eventSourceRef.current = eventSource;
-
-        abortController.signal.addEventListener("abort", () => {
-          eventSource.close();
-          eventSourceRef.current = null;
-        });
-
-        return new Promise<void>((resolve, reject) => {
-          const cleanup = () => {
-            eventSource.removeEventListener("message", messageHandler);
-            eventSource.removeEventListener("error", errorHandler);
-          };
-
-          const messageHandler = (event: MessageEvent) => {
-            try {
-              const chunk = JSON.parse(event.data) as StreamChunk;
-
-              if (retryCountRef.current > 0) {
-                retryCountRef.current = 0;
-              }
-
-              // Call the chunk handler
-              onChunk(chunk);
-
-              // Handle stream lifecycle
-              if (chunk.type === "stream_end") {
-                cleanup();
-                stopStreaming();
-                resolve();
-              } else if (chunk.type === "error") {
-                cleanup();
-                reject(
-                  new Error(chunk.message || chunk.content || "Stream error"),
-                );
-              }
-            } catch (err) {
-              const parseError =
-                err instanceof Error
-                  ? err
-                  : new Error("Failed to parse stream chunk");
-              setError(parseError);
-              cleanup();
-              reject(parseError);
-            }
-          };
-
-          const errorHandler = () => {
-            if (eventSourceRef.current) {
-              eventSourceRef.current.close();
-              eventSourceRef.current = null;
-            }
-
-            if (retryCountRef.current < MAX_RETRIES) {
-              retryCountRef.current += 1;
-              const retryDelay =
-                INITIAL_RETRY_DELAY * Math.pow(2, retryCountRef.current - 1);
-
-              toast.info("Connection interrupted", {
-                description: `Retrying in ${retryDelay / 1000} seconds...`,
-              });
-
-              retryTimeoutRef.current = setTimeout(() => {
-                sendMessage(sessionId, message, onChunk, isUserMessage).catch(
-                  (_err) => {
-                    // Retry failed
-                  },
-                );
-              }, retryDelay);
-            } else {
-              const streamError = new Error(
-                "Stream connection failed after multiple retries",
-              );
-              setError(streamError);
-              toast.error("Connection Failed", {
-                description:
-                  "Unable to connect to chat service. Please try again.",
-              });
-              cleanup();
-              stopStreaming();
-              reject(streamError);
-            }
-          };
-
-          eventSource.addEventListener("message", messageHandler);
-          eventSource.addEventListener("error", errorHandler);
-        });
-      } catch (err) {
-        const streamError =
-          err instanceof Error ? err : new Error("Failed to start stream");
-        setError(streamError);
-        setIsStreaming(false);
-        throw streamError;
-      }
-    },
-    [stopStreaming],
-  );
-
-  return {
-    isStreaming,
-    error,
-    sendMessage,
-    stopStreaming,
-  };
-}
diff --git a/autogpt_platform/frontend/src/app/(platform)/error.tsx b/autogpt_platform/frontend/src/app/(platform)/error.tsx
index 12ff33f838..6bf7572069 100644
--- a/autogpt_platform/frontend/src/app/(platform)/error.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/error.tsx
@@ -18,7 +18,7 @@ function ErrorPageContent() {
     ) {
       window.location.href = "/login";
     } else {
-      window.location.href = "/marketplace";
+      window.document.location.reload();
     }
   }
 
diff --git a/autogpt_platform/frontend/src/app/(platform)/layout.tsx b/autogpt_platform/frontend/src/app/(platform)/layout.tsx
index 2975e7d097..f5e3f3b99b 100644
--- a/autogpt_platform/frontend/src/app/(platform)/layout.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/layout.tsx
@@ -1,6 +1,6 @@
 import { Navbar } from "@/components/layout/Navbar/Navbar";
-import { AdminImpersonationBanner } from "./admin/components/AdminImpersonationBanner";
 import { ReactNode } from "react";
+import { AdminImpersonationBanner } from "./admin/components/AdminImpersonationBanner";
 
 export default function PlatformLayout({ children }: { children: ReactNode }) {
   return (
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/NewAgentLibraryView.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/NewAgentLibraryView.tsx
index 3768a0d150..b9091584bf 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/NewAgentLibraryView.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/NewAgentLibraryView.tsx
@@ -1,32 +1,31 @@
 "use client";
 
 import { Button } from "@/components/atoms/Button/Button";
+import { PublishAgentModal } from "@/components/contextual/PublishAgentModal/PublishAgentModal";
 import { Breadcrumbs } from "@/components/molecules/Breadcrumbs/Breadcrumbs";
 import { ErrorCard } from "@/components/molecules/ErrorCard/ErrorCard";
 import { cn } from "@/lib/utils";
 import { PlusIcon } from "@phosphor-icons/react";
 import { useEffect, useState } from "react";
-import { RunAgentModal } from "./components/modals/RunAgentModal/RunAgentModal";
-import { useMarketplaceUpdate } from "./hooks/useMarketplaceUpdate";
 import { AgentVersionChangelog } from "./components/AgentVersionChangelog";
-import { MarketplaceBanners } from "@/components/contextual/MarketplaceBanners/MarketplaceBanners";
-import { PublishAgentModal } from "@/components/contextual/PublishAgentModal/PublishAgentModal";
-import { AgentSettingsButton } from "./components/other/AgentSettingsButton";
+import { AgentSettingsModal } from "./components/modals/AgentSettingsModal/AgentSettingsModal";
+import { RunAgentModal } from "./components/modals/RunAgentModal/RunAgentModal";
 import { AgentRunsLoading } from "./components/other/AgentRunsLoading";
 import { EmptySchedules } from "./components/other/EmptySchedules";
 import { EmptyTasks } from "./components/other/EmptyTasks";
 import { EmptyTemplates } from "./components/other/EmptyTemplates";
 import { EmptyTriggers } from "./components/other/EmptyTriggers";
+import { MarketplaceBanners } from "./components/other/MarketplaceBanners";
 import { SectionWrap } from "./components/other/SectionWrap";
 import { LoadingSelectedContent } from "./components/selected-views/LoadingSelectedContent";
 import { SelectedRunView } from "./components/selected-views/SelectedRunView/SelectedRunView";
 import { SelectedScheduleView } from "./components/selected-views/SelectedScheduleView/SelectedScheduleView";
-import { SelectedSettingsView } from "./components/selected-views/SelectedSettingsView/SelectedSettingsView";
 import { SelectedTemplateView } from "./components/selected-views/SelectedTemplateView/SelectedTemplateView";
 import { SelectedTriggerView } from "./components/selected-views/SelectedTriggerView/SelectedTriggerView";
 import { SelectedViewLayout } from "./components/selected-views/SelectedViewLayout";
 import { SidebarRunsList } from "./components/sidebar/SidebarRunsList/SidebarRunsList";
 import { AGENT_LIBRARY_SECTION_PADDING_X } from "./helpers";
+import { useMarketplaceUpdate } from "./hooks/useMarketplaceUpdate";
 import { useNewAgentLibraryView } from "./useNewAgentLibraryView";
 
 export function NewAgentLibraryView() {
@@ -45,7 +44,6 @@ export function NewAgentLibraryView() {
     handleSelectRun,
     handleCountsChange,
     handleClearSelectedRun,
-    handleSelectSettings,
     onRunInitiated,
     onTriggerSetup,
     onScheduleCreated,
@@ -137,13 +135,16 @@ export function NewAgentLibraryView() {
     return (
       <>
         <div className="flex h-full flex-col">
-          <div className="mx-6 pt-4">
-            <Breadcrumbs
-              items={[
-                { name: "My Library", link: "/library" },
-                { name: agent.name, link: `/library/agents/${agentId}` },
-              ]}
-            />
+          <div className="mx-6 flex flex-col gap-4 pt-4">
+            <div className="flex items-center justify-between">
+              <Breadcrumbs
+                items={[
+                  { name: "My Library", link: "/library" },
+                  { name: agent.name, link: `/library/agents/${agentId}` },
+                ]}
+              />
+              <AgentSettingsModal agent={agent} />
+            </div>
           </div>
           <div className="flex min-h-0 flex-1">
             <EmptyTasks
@@ -162,7 +163,7 @@ export function NewAgentLibraryView() {
 
   return (
     <>
-      <div className="mx-4 grid h-full grid-cols-1 gap-0 pt-3 md:ml-4 md:mr-0 md:gap-4 lg:grid-cols-[25%_70%]">
+      <div className="mx-4 grid h-full w-full grid-cols-1 gap-0 pt-3 md:ml-4 md:mr-0 md:gap-4 lg:grid-cols-[25%_70%]">
         <SectionWrap className="mb-3 block">
           <div
             className={cn(
@@ -170,31 +171,24 @@ export function NewAgentLibraryView() {
               AGENT_LIBRARY_SECTION_PADDING_X,
             )}
           >
-            <div className="flex items-center gap-2">
-              <RunAgentModal
-                triggerSlot={
-                  <Button
-                    variant="primary"
-                    size="large"
-                    className="flex-1"
-                    disabled={isTemplateLoading && activeTab === "templates"}
-                  >
-                    <PlusIcon size={20} /> New task
-                  </Button>
-                }
-                agent={agent}
-                onRunCreated={onRunInitiated}
-                onScheduleCreated={onScheduleCreated}
-                onTriggerSetup={onTriggerSetup}
-                initialInputValues={activeTemplate?.inputs}
-                initialInputCredentials={activeTemplate?.credentials}
-              />
-              <AgentSettingsButton
-                agent={agent}
-                onSelectSettings={handleSelectSettings}
-                selected={activeItem === "settings"}
-              />
-            </div>
+            <RunAgentModal
+              triggerSlot={
+                <Button
+                  variant="primary"
+                  size="large"
+                  className="w-full"
+                  disabled={isTemplateLoading && activeTab === "templates"}
+                >
+                  <PlusIcon size={20} /> New task
+                </Button>
+              }
+              agent={agent}
+              onRunCreated={onRunInitiated}
+              onScheduleCreated={onScheduleCreated}
+              onTriggerSetup={onTriggerSetup}
+              initialInputValues={activeTemplate?.inputs}
+              initialInputCredentials={activeTemplate?.credentials}
+            />
           </div>
 
           <SidebarRunsList
@@ -208,12 +202,7 @@ export function NewAgentLibraryView() {
         </SectionWrap>
 
         {activeItem ? (
-          activeItem === "settings" ? (
-            <SelectedSettingsView
-              agent={agent}
-              onClearSelectedRun={handleClearSelectedRun}
-            />
-          ) : activeTab === "scheduled" ? (
+          activeTab === "scheduled" ? (
             <SelectedScheduleView
               agent={agent}
               scheduleId={activeItem}
@@ -246,8 +235,6 @@ export function NewAgentLibraryView() {
               onSelectRun={handleSelectRun}
               onClearSelectedRun={handleClearSelectedRun}
               banner={renderMarketplaceUpdateBanner()}
-              onSelectSettings={handleSelectSettings}
-              selectedSettings={activeItem === "settings"}
             />
           )
         ) : sidebarLoading ? (
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/AgentInputsReadOnly/AgentInputsReadOnly.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/AgentInputsReadOnly/AgentInputsReadOnly.tsx
index bc9918c2bb..88a2be9b34 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/AgentInputsReadOnly/AgentInputsReadOnly.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/AgentInputsReadOnly/AgentInputsReadOnly.tsx
@@ -2,8 +2,9 @@
 
 import type { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
 import { Text } from "@/components/atoms/Text/Text";
+import { CredentialsInput } from "@/components/contextual/CredentialsInput/CredentialsInput";
+import { isSystemCredential } from "@/components/contextual/CredentialsInput/helpers";
 import type { CredentialsMetaInput } from "@/lib/autogpt-server-api/types";
-import { CredentialsInput } from "../CredentialsInputs/CredentialsInputs";
 import { RunAgentInputs } from "../RunAgentInputs/RunAgentInputs";
 import { getAgentCredentialsFields, getAgentInputFields } from "./helpers";
 
@@ -71,6 +72,7 @@ export function AgentInputsReadOnly({
           {credentialFieldEntries.map(([key, inputSubSchema]) => {
             const credential = credentialInputs![key];
             if (!credential) return null;
+            if (isSystemCredential(credential)) return null;
 
             return (
               <CredentialsInput
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/AgentSettingsModal/AgentSettingsModal.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/AgentSettingsModal/AgentSettingsModal.tsx
new file mode 100644
index 0000000000..7886f7adaf
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/AgentSettingsModal/AgentSettingsModal.tsx
@@ -0,0 +1,81 @@
+"use client";
+
+import { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
+import { Button } from "@/components/atoms/Button/Button";
+import { Switch } from "@/components/atoms/Switch/Switch";
+import { Text } from "@/components/atoms/Text/Text";
+import { Dialog } from "@/components/molecules/Dialog/Dialog";
+import { useAgentSafeMode } from "@/hooks/useAgentSafeMode";
+import { GearIcon } from "@phosphor-icons/react";
+import { useState } from "react";
+
+interface Props {
+  agent: LibraryAgent;
+  controlledOpen?: boolean;
+  onOpenChange?: (open: boolean) => void;
+}
+
+export function AgentSettingsModal({
+  agent,
+  controlledOpen,
+  onOpenChange,
+}: Props) {
+  const [internalIsOpen, setInternalIsOpen] = useState(false);
+  const isOpen = controlledOpen !== undefined ? controlledOpen : internalIsOpen;
+
+  function setIsOpen(open: boolean) {
+    if (onOpenChange) {
+      onOpenChange(open);
+    } else {
+      setInternalIsOpen(open);
+    }
+  }
+
+  const { currentSafeMode, isPending, hasHITLBlocks, handleToggle } =
+    useAgentSafeMode(agent);
+
+  if (!hasHITLBlocks) return null;
+
+  return (
+    <Dialog
+      controlled={{ isOpen, set: setIsOpen }}
+      styling={{ maxWidth: "600px", maxHeight: "90vh" }}
+      title="Agent Settings"
+    >
+      {controlledOpen === undefined && (
+        <Dialog.Trigger>
+          <Button
+            variant="ghost"
+            size="small"
+            className="m-0 min-w-0 rounded-full p-0 px-1"
+            aria-label="Agent Settings"
+          >
+            <GearIcon size={18} className="text-zinc-600" />
+            <Text variant="small">Agent Settings</Text>
+          </Button>
+        </Dialog.Trigger>
+      )}
+      <Dialog.Content>
+        <div className="space-y-6">
+          <div className="flex w-full flex-col items-start gap-4 rounded-xl border border-zinc-100 bg-white p-6">
+            <div className="flex w-full items-start justify-between gap-4">
+              <div className="flex-1">
+                <Text variant="large-semibold">Require human approval</Text>
+                <Text variant="large" className="mt-1 text-zinc-900">
+                  The agent will pause and wait for your review before
+                  continuing
+                </Text>
+              </div>
+              <Switch
+                checked={currentSafeMode || false}
+                onCheckedChange={handleToggle}
+                disabled={isPending}
+                className="mt-1"
+              />
+            </div>
+          </div>
+        </div>
+      </Dialog.Content>
+    </Dialog>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/components/CredentialsSelect/CredentialsSelect.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/components/CredentialsSelect/CredentialsSelect.tsx
deleted file mode 100644
index 7adfa5772b..0000000000
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/components/CredentialsSelect/CredentialsSelect.tsx
+++ /dev/null
@@ -1,86 +0,0 @@
-import {
-  Select,
-  SelectContent,
-  SelectItem,
-  SelectTrigger,
-  SelectValue,
-} from "@/components/__legacy__/ui/select";
-import { Text } from "@/components/atoms/Text/Text";
-import { CredentialsMetaInput } from "@/lib/autogpt-server-api/types";
-import { useEffect } from "react";
-import { getCredentialDisplayName } from "../../helpers";
-import { CredentialRow } from "../CredentialRow/CredentialRow";
-
-interface Props {
-  credentials: Array<{
-    id: string;
-    title?: string;
-    username?: string;
-    type: string;
-    provider: string;
-  }>;
-  provider: string;
-  displayName: string;
-  selectedCredentials?: CredentialsMetaInput;
-  onSelectCredential: (credentialId: string) => void;
-  readOnly?: boolean;
-}
-
-export function CredentialsSelect({
-  credentials,
-  provider,
-  displayName,
-  selectedCredentials,
-  onSelectCredential,
-  readOnly = false,
-}: Props) {
-  // Auto-select first credential if none is selected
-  useEffect(() => {
-    if (!selectedCredentials && credentials.length > 0) {
-      onSelectCredential(credentials[0].id);
-    }
-  }, [selectedCredentials, credentials, onSelectCredential]);
-
-  return (
-    <div className="mb-4 w-full">
-      <Select
-        value={selectedCredentials?.id || ""}
-        onValueChange={(value) => onSelectCredential(value)}
-      >
-        <SelectTrigger className="h-auto min-h-12 w-full rounded-medium border-zinc-200 p-0 pr-4 shadow-none">
-          {selectedCredentials ? (
-            <SelectValue key={selectedCredentials.id} asChild>
-              <CredentialRow
-                credential={{
-                  id: selectedCredentials.id,
-                  title: selectedCredentials.title || undefined,
-                  type: selectedCredentials.type,
-                  provider: selectedCredentials.provider,
-                }}
-                provider={provider}
-                displayName={displayName}
-                onSelect={() => {}}
-                onDelete={() => {}}
-                readOnly={readOnly}
-                asSelectTrigger={true}
-              />
-            </SelectValue>
-          ) : (
-            <SelectValue key="placeholder" placeholder="Select credential" />
-          )}
-        </SelectTrigger>
-        <SelectContent>
-          {credentials.map((credential) => (
-            <SelectItem key={credential.id} value={credential.id}>
-              <div className="flex items-center gap-2">
-                <Text variant="body" className="tracking-tight">
-                  {getCredentialDisplayName(credential, displayName)}
-                </Text>
-              </div>
-            </SelectItem>
-          ))}
-        </SelectContent>
-      </Select>
-    </div>
-  );
-}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentInputs/RunAgentInputs.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentInputs/RunAgentInputs.tsx
index d3e6fd9669..72d04d634b 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentInputs/RunAgentInputs.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentInputs/RunAgentInputs.tsx
@@ -68,9 +68,15 @@ export function RunAgentInputs({
           type="number"
           value={value ?? ""}
           placeholder={placeholder || "Enter number"}
-          onChange={(e) =>
-            onChange(Number((e.target as HTMLInputElement).value))
-          }
+          onChange={(e) => {
+            const v = (e.target as HTMLInputElement).value;
+            if (!v || v.trim() === "") {
+              onChange(undefined);
+            } else {
+              const numValue = Number(v);
+              onChange(isNaN(numValue) ? undefined : numValue);
+            }
+          }}
           {...props}
         />
       );
@@ -125,14 +131,32 @@ export function RunAgentInputs({
       );
       break;
 
-    case DataType.DATE:
+    case DataType.DATE: {
+      function normalizeDateValue(val: any): Date | null {
+        if (!val) return null;
+        if (val instanceof Date) {
+          return isNaN(val.getTime()) ? null : val;
+        }
+        if (typeof val === "string") {
+          if (/^\d{4}-\d{2}-\d{2}$/.test(val)) {
+            const [y, m, d] = val.split("-").map(Number);
+            const date = new Date(y, m - 1, d);
+            return isNaN(date.getTime()) ? null : date;
+          }
+          const date = new Date(val);
+          return isNaN(date.getTime()) ? null : date;
+        }
+        return null;
+      }
+
+      const dateValue = normalizeDateValue(value);
       innerInputElement = (
         <DSInput
           id={`${baseId}-date`}
           label={schema.title ?? placeholder ?? "Date"}
           hideLabel
           type="date"
-          value={value ? format(value as Date, "yyyy-MM-dd") : ""}
+          value={dateValue ? format(dateValue, "yyyy-MM-dd") : ""}
           onChange={(e) => {
             const v = (e.target as HTMLInputElement).value;
             if (!v) onChange(undefined);
@@ -146,6 +170,7 @@ export function RunAgentInputs({
         />
       );
       break;
+    }
 
     case DataType.TIME:
       innerInputElement = (
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentModal/RunAgentModal.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentModal/RunAgentModal.tsx
index e53f31a349..cd0c666be6 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentModal/RunAgentModal.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentModal/RunAgentModal.tsx
@@ -12,7 +12,7 @@ import {
   TooltipTrigger,
 } from "@/components/atoms/Tooltip/BaseTooltip";
 import { Dialog } from "@/components/molecules/Dialog/Dialog";
-import { useState } from "react";
+import { useEffect, useRef, useState } from "react";
 import { ScheduleAgentModal } from "../ScheduleAgentModal/ScheduleAgentModal";
 import { ModalHeader } from "./components/ModalHeader/ModalHeader";
 import { ModalRunSection } from "./components/ModalRunSection/ModalRunSection";
@@ -82,6 +82,8 @@ export function RunAgentModal({
   });
 
   const [isScheduleModalOpen, setIsScheduleModalOpen] = useState(false);
+  const [hasOverflow, setHasOverflow] = useState(false);
+  const contentRef = useRef<HTMLDivElement>(null);
 
   const hasAnySetupFields =
     Object.keys(agentInputFields || {}).length > 0 ||
@@ -89,6 +91,43 @@ export function RunAgentModal({
 
   const isTriggerRunType = defaultRunType.includes("trigger");
 
+  useEffect(() => {
+    if (!isOpen) return;
+
+    function checkOverflow() {
+      if (!contentRef.current) return;
+      const scrollableParent = contentRef.current
+        .closest("[data-dialog-content]")
+        ?.querySelector('[class*="overflow-y-auto"]');
+      if (scrollableParent) {
+        setHasOverflow(
+          scrollableParent.scrollHeight > scrollableParent.clientHeight,
+        );
+      }
+    }
+
+    const timeoutId = setTimeout(checkOverflow, 100);
+    const resizeObserver = new ResizeObserver(checkOverflow);
+    if (contentRef.current) {
+      const scrollableParent = contentRef.current
+        .closest("[data-dialog-content]")
+        ?.querySelector('[class*="overflow-y-auto"]');
+      if (scrollableParent) {
+        resizeObserver.observe(scrollableParent);
+      }
+    }
+
+    return () => {
+      clearTimeout(timeoutId);
+      resizeObserver.disconnect();
+    };
+  }, [
+    isOpen,
+    hasAnySetupFields,
+    agentInputFields,
+    agentCredentialsInputFields,
+  ]);
+
   function handleInputChange(key: string, value: string) {
     setInputValues((prev) => ({
       ...prev,
@@ -134,91 +173,97 @@ export function RunAgentModal({
       >
         <Dialog.Trigger>{triggerSlot}</Dialog.Trigger>
         <Dialog.Content>
-          {/* Header */}
-          <ModalHeader agent={agent} />
+          <div ref={contentRef} className="flex min-h-full flex-col">
+            <div className="flex-1">
+              {/* Header */}
+              <ModalHeader agent={agent} />
 
-          {/* Content */}
-          {hasAnySetupFields ? (
-            <div className="mt-10">
-              <RunAgentModalContextProvider
-                value={{
-                  agent,
-                  defaultRunType,
-                  presetName,
-                  setPresetName,
-                  presetDescription,
-                  setPresetDescription,
-                  inputValues,
-                  setInputValue: handleInputChange,
-                  agentInputFields,
-                  inputCredentials,
-                  setInputCredentialsValue: handleCredentialsChange,
-                  agentCredentialsInputFields,
-                }}
-              >
-                <ModalRunSection />
-              </RunAgentModalContextProvider>
+              {/* Content */}
+              {hasAnySetupFields ? (
+                <div className="mt-10 pb-32">
+                  <RunAgentModalContextProvider
+                    value={{
+                      agent,
+                      defaultRunType,
+                      presetName,
+                      setPresetName,
+                      presetDescription,
+                      setPresetDescription,
+                      inputValues,
+                      setInputValue: handleInputChange,
+                      agentInputFields,
+                      inputCredentials,
+                      setInputCredentialsValue: handleCredentialsChange,
+                      agentCredentialsInputFields,
+                    }}
+                  >
+                    <ModalRunSection />
+                  </RunAgentModalContextProvider>
+                </div>
+              ) : null}
             </div>
-          ) : null}
 
-          <Dialog.Footer className="mt-6 bg-white pt-4">
-            <div className="flex items-center justify-end gap-3">
-              {isTriggerRunType ? null : !allRequiredInputsAreSet ? (
-                <TooltipProvider>
-                  <Tooltip>
-                    <TooltipTrigger asChild>
-                      <span>
-                        <Button
-                          variant="secondary"
-                          onClick={handleOpenScheduleModal}
-                          disabled={
-                            isExecuting ||
-                            isSettingUpTrigger ||
-                            !allRequiredInputsAreSet
-                          }
-                        >
-                          Schedule Task
-                        </Button>
-                      </span>
-                    </TooltipTrigger>
-                    <TooltipContent>
-                      <p>
-                        Please set up all required inputs and credentials before
-                        scheduling
-                      </p>
-                    </TooltipContent>
-                  </Tooltip>
-                </TooltipProvider>
-              ) : (
-                <Button
-                  variant="secondary"
-                  onClick={handleOpenScheduleModal}
-                  disabled={
-                    isExecuting ||
-                    isSettingUpTrigger ||
-                    !allRequiredInputsAreSet
-                  }
-                >
-                  Schedule Task
-                </Button>
-              )}
-              <RunActions
-                defaultRunType={defaultRunType}
-                onRun={handleRun}
-                isExecuting={isExecuting}
-                isSettingUpTrigger={isSettingUpTrigger}
-                isRunReady={allRequiredInputsAreSet}
+            <Dialog.Footer
+              className={`sticky bottom-0 z-10 bg-white pt-4 ${
+                hasOverflow
+                  ? "border-t border-neutral-100 shadow-[0_-2px_8px_rgba(0,0,0,0.04)]"
+                  : ""
+              }`}
+            >
+              <div className="flex items-center justify-end gap-3">
+                {isTriggerRunType ? null : !allRequiredInputsAreSet ? (
+                  <TooltipProvider>
+                    <Tooltip>
+                      <TooltipTrigger asChild>
+                        <span>
+                          <Button
+                            variant="secondary"
+                            onClick={handleOpenScheduleModal}
+                            disabled={
+                              isExecuting ||
+                              isSettingUpTrigger ||
+                              !allRequiredInputsAreSet
+                            }
+                          >
+                            Schedule Task
+                          </Button>
+                        </span>
+                      </TooltipTrigger>
+                      <TooltipContent>
+                        <p>
+                          Please set up all required inputs and credentials
+                          before scheduling
+                        </p>
+                      </TooltipContent>
+                    </Tooltip>
+                  </TooltipProvider>
+                ) : (
+                  <Button
+                    variant="secondary"
+                    onClick={handleOpenScheduleModal}
+                    disabled={isExecuting || isSettingUpTrigger}
+                  >
+                    Schedule Task
+                  </Button>
+                )}
+                <RunActions
+                  defaultRunType={defaultRunType}
+                  onRun={handleRun}
+                  isExecuting={isExecuting}
+                  isSettingUpTrigger={isSettingUpTrigger}
+                  isRunReady={allRequiredInputsAreSet}
+                />
+              </div>
+              <ScheduleAgentModal
+                isOpen={isScheduleModalOpen}
+                onClose={handleCloseScheduleModal}
+                agent={agent}
+                inputValues={inputValues}
+                inputCredentials={inputCredentials}
+                onScheduleCreated={handleScheduleCreated}
               />
-            </div>
-            <ScheduleAgentModal
-              isOpen={isScheduleModalOpen}
-              onClose={handleCloseScheduleModal}
-              agent={agent}
-              inputValues={inputValues}
-              inputCredentials={inputCredentials}
-              onScheduleCreated={handleScheduleCreated}
-            />
-          </Dialog.Footer>
+            </Dialog.Footer>
+          </div>
         </Dialog.Content>
       </Dialog>
     </>
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentModal/components/CredentialsGroupedView/CredentialsGroupedView.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentModal/components/CredentialsGroupedView/CredentialsGroupedView.tsx
new file mode 100644
index 0000000000..2ae159e739
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentModal/components/CredentialsGroupedView/CredentialsGroupedView.tsx
@@ -0,0 +1,181 @@
+import { CredentialsInput } from "@/components/contextual/CredentialsInput/CredentialsInput";
+import {
+  Accordion,
+  AccordionContent,
+  AccordionItem,
+  AccordionTrigger,
+} from "@/components/molecules/Accordion/Accordion";
+import { CredentialsProvidersContext } from "@/providers/agent-credentials/credentials-provider";
+import { SlidersHorizontal } from "@phosphor-icons/react";
+import { useContext, useEffect, useMemo, useRef } from "react";
+import { useRunAgentModalContext } from "../../context";
+import {
+  areSystemCredentialProvidersLoading,
+  CredentialField,
+  findSavedCredentialByProviderAndType,
+  hasMissingRequiredSystemCredentials,
+  splitCredentialFieldsBySystem,
+} from "../helpers";
+
+type Props = {
+  credentialFields: CredentialField[];
+  requiredCredentials: Set<string>;
+};
+
+export function CredentialsGroupedView({
+  credentialFields,
+  requiredCredentials,
+}: Props) {
+  const allProviders = useContext(CredentialsProvidersContext);
+  const { inputCredentials, setInputCredentialsValue, inputValues } =
+    useRunAgentModalContext();
+
+  const { userCredentialFields, systemCredentialFields } = useMemo(
+    () =>
+      splitCredentialFieldsBySystem(
+        credentialFields,
+        allProviders,
+        inputCredentials,
+      ),
+    [credentialFields, allProviders, inputCredentials],
+  );
+
+  const hasSystemCredentials = systemCredentialFields.length > 0;
+  const hasUserCredentials = userCredentialFields.length > 0;
+  const hasAttemptedAutoSelect = useRef(false);
+
+  const isLoadingProviders = useMemo(
+    () =>
+      areSystemCredentialProvidersLoading(systemCredentialFields, allProviders),
+    [systemCredentialFields, allProviders],
+  );
+
+  const hasMissingSystemCredentials = useMemo(() => {
+    if (isLoadingProviders) return false;
+    return hasMissingRequiredSystemCredentials(
+      systemCredentialFields,
+      requiredCredentials,
+      inputCredentials,
+      allProviders,
+    );
+  }, [
+    isLoadingProviders,
+    systemCredentialFields,
+    requiredCredentials,
+    inputCredentials,
+    allProviders,
+  ]);
+
+  useEffect(() => {
+    if (hasAttemptedAutoSelect.current) return;
+    if (!hasSystemCredentials) return;
+    if (isLoadingProviders) return;
+
+    for (const [key, schema] of systemCredentialFields) {
+      const alreadySelected = inputCredentials?.[key];
+      const isRequired = requiredCredentials.has(key);
+      if (alreadySelected || !isRequired) continue;
+
+      const providerNames = schema.credentials_provider || [];
+      const credentialTypes = schema.credentials_types || [];
+      const requiredScopes = schema.credentials_scopes;
+      const savedCredential = findSavedCredentialByProviderAndType(
+        providerNames,
+        credentialTypes,
+        requiredScopes,
+        allProviders,
+      );
+
+      if (savedCredential) {
+        setInputCredentialsValue(key, {
+          id: savedCredential.id,
+          provider: savedCredential.provider,
+          type: savedCredential.type,
+          title: (savedCredential as { title?: string }).title,
+        });
+      }
+    }
+
+    hasAttemptedAutoSelect.current = true;
+  }, [
+    allProviders,
+    hasSystemCredentials,
+    systemCredentialFields,
+    requiredCredentials,
+    inputCredentials,
+    setInputCredentialsValue,
+    isLoadingProviders,
+  ]);
+
+  return (
+    <div className="space-y-6">
+      {hasUserCredentials && (
+        <>
+          {userCredentialFields.map(
+            ([key, inputSubSchema]: CredentialField) => {
+              const selectedCred = inputCredentials?.[key];
+
+              return (
+                <CredentialsInput
+                  key={key}
+                  schema={
+                    { ...inputSubSchema, discriminator: undefined } as any
+                  }
+                  selectedCredentials={selectedCred}
+                  onSelectCredentials={(value) => {
+                    setInputCredentialsValue(key, value);
+                  }}
+                  siblingInputs={inputValues}
+                  isOptional={!requiredCredentials.has(key)}
+                />
+              );
+            },
+          )}
+        </>
+      )}
+
+      {hasSystemCredentials && (
+        <Accordion
+          type="single"
+          collapsible
+          className={hasUserCredentials ? "mt-4" : ""}
+        >
+          <AccordionItem value="system-credentials" className="border-none">
+            <AccordionTrigger className="py-2 text-sm text-muted-foreground hover:no-underline">
+              <div className="flex items-center gap-1">
+                <SlidersHorizontal size={16} weight="bold" /> System credentials
+                {hasMissingSystemCredentials && (
+                  <span className="text-destructive">(missing)</span>
+                )}
+              </div>
+            </AccordionTrigger>
+            <AccordionContent>
+              <div className="space-y-6 px-1 pt-2">
+                {systemCredentialFields.map(
+                  ([key, inputSubSchema]: CredentialField) => {
+                    const selectedCred = inputCredentials?.[key];
+
+                    return (
+                      <CredentialsInput
+                        key={key}
+                        schema={
+                          { ...inputSubSchema, discriminator: undefined } as any
+                        }
+                        selectedCredentials={selectedCred}
+                        onSelectCredentials={(value) => {
+                          setInputCredentialsValue(key, value);
+                        }}
+                        siblingInputs={inputValues}
+                        isOptional={!requiredCredentials.has(key)}
+                      />
+                    );
+                  },
+                )}
+              </div>
+            </AccordionContent>
+          </AccordionItem>
+        </Accordion>
+      )}
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentModal/components/ModalRunSection/ModalRunSection.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentModal/components/ModalRunSection/ModalRunSection.tsx
index f3b02bfbc9..7660de7c15 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentModal/components/ModalRunSection/ModalRunSection.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentModal/components/ModalRunSection/ModalRunSection.tsx
@@ -1,13 +1,15 @@
-import { CredentialsInput } from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/CredentialsInputs";
 import { Input } from "@/components/atoms/Input/Input";
 import { InformationTooltip } from "@/components/molecules/InformationTooltip/InformationTooltip";
+import { useMemo } from "react";
 import { RunAgentInputs } from "../../../RunAgentInputs/RunAgentInputs";
 import { useRunAgentModalContext } from "../../context";
+import { CredentialsGroupedView } from "../CredentialsGroupedView/CredentialsGroupedView";
 import { ModalSection } from "../ModalSection/ModalSection";
 import { WebhookTriggerBanner } from "../WebhookTriggerBanner/WebhookTriggerBanner";
 
 export function ModalRunSection() {
   const {
+    agent,
     defaultRunType,
     presetName,
     setPresetName,
@@ -16,13 +18,19 @@ export function ModalRunSection() {
     inputValues,
     setInputValue,
     agentInputFields,
-    inputCredentials,
-    setInputCredentialsValue,
     agentCredentialsInputFields,
   } = useRunAgentModalContext();
 
   const inputFields = Object.entries(agentInputFields || {});
-  const credentialFields = Object.entries(agentCredentialsInputFields || {});
+
+  const credentialFields = useMemo(() => {
+    if (!agentCredentialsInputFields) return [];
+    return Object.entries(agentCredentialsInputFields);
+  }, [agentCredentialsInputFields]);
+
+  const requiredCredentials = new Set(
+    (agent.credentials_input_schema?.required as string[]) || [],
+  );
 
   return (
     <div className="flex flex-col gap-4">
@@ -91,26 +99,10 @@ export function ModalRunSection() {
           title="Task Credentials"
           subtitle="These are the credentials the agent will use to perform this task"
         >
-          <div className="space-y-6">
-            {Object.entries(agentCredentialsInputFields || {}).map(
-              ([key, inputSubSchema]) => (
-                <CredentialsInput
-                  key={key}
-                  schema={
-                    { ...inputSubSchema, discriminator: undefined } as any
-                  }
-                  selectedCredentials={
-                    (inputCredentials && inputCredentials[key]) ??
-                    inputSubSchema.default
-                  }
-                  onSelectCredentials={(value) =>
-                    setInputCredentialsValue(key, value)
-                  }
-                  siblingInputs={inputValues}
-                />
-              ),
-            )}
-          </div>
+          <CredentialsGroupedView
+            credentialFields={credentialFields}
+            requiredCredentials={requiredCredentials}
+          />
         </ModalSection>
       ) : null}
     </div>
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentModal/components/helpers.ts b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentModal/components/helpers.ts
new file mode 100644
index 0000000000..72f0fcb451
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentModal/components/helpers.ts
@@ -0,0 +1,210 @@
+import { CredentialsProvidersContextType } from "@/providers/agent-credentials/credentials-provider";
+import { getSystemCredentials } from "../../../../../../../../../../../components/contextual/CredentialsInput/helpers";
+
+export type CredentialField = [string, any];
+
+type SavedCredential = {
+  id: string;
+  provider: string;
+  type: string;
+  title?: string | null;
+};
+
+function hasRequiredScopes(
+  credential: { scopes?: string[]; type: string },
+  requiredScopes?: string[],
+) {
+  if (credential.type !== "oauth2") return true;
+  if (!requiredScopes || requiredScopes.length === 0) return true;
+  const grantedScopes = new Set(credential.scopes || []);
+  for (const scope of requiredScopes) {
+    if (!grantedScopes.has(scope)) return false;
+  }
+  return true;
+}
+
+export function splitCredentialFieldsBySystem(
+  credentialFields: CredentialField[],
+  allProviders: CredentialsProvidersContextType | null,
+  inputCredentials?: Record<string, unknown>,
+) {
+  if (!allProviders || credentialFields.length === 0) {
+    return {
+      userCredentialFields: [] as CredentialField[],
+      systemCredentialFields: [] as CredentialField[],
+    };
+  }
+
+  const userFields: CredentialField[] = [];
+  const systemFields: CredentialField[] = [];
+
+  for (const [key, schema] of credentialFields) {
+    const providerNames = schema.credentials_provider || [];
+    const isSystemField = providerNames.some((providerName: string) => {
+      const providerData = allProviders[providerName];
+      return providerData?.isSystemProvider === true;
+    });
+
+    if (isSystemField) {
+      systemFields.push([key, schema]);
+    } else {
+      userFields.push([key, schema]);
+    }
+  }
+
+  const sortByUnsetFirst = (a: CredentialField, b: CredentialField) => {
+    const aIsSet = Boolean(inputCredentials?.[a[0]]);
+    const bIsSet = Boolean(inputCredentials?.[b[0]]);
+
+    if (aIsSet === bIsSet) return 0;
+    return aIsSet ? 1 : -1;
+  };
+
+  return {
+    userCredentialFields: userFields.sort(sortByUnsetFirst),
+    systemCredentialFields: systemFields.sort(sortByUnsetFirst),
+  };
+}
+
+export function areSystemCredentialProvidersLoading(
+  systemCredentialFields: CredentialField[],
+  allProviders: CredentialsProvidersContextType | null,
+): boolean {
+  if (!systemCredentialFields.length) return false;
+  if (allProviders === null) return true;
+
+  for (const [_, schema] of systemCredentialFields) {
+    const providerNames = schema.credentials_provider || [];
+    const hasAllProviders = providerNames.every(
+      (providerName: string) => allProviders?.[providerName] !== undefined,
+    );
+    if (!hasAllProviders) return true;
+  }
+
+  return false;
+}
+
+export function hasMissingRequiredSystemCredentials(
+  systemCredentialFields: CredentialField[],
+  requiredCredentials: Set<string>,
+  inputCredentials?: Record<string, unknown>,
+  allProviders?: CredentialsProvidersContextType | null,
+) {
+  if (systemCredentialFields.length === 0) return false;
+  if (allProviders === null) return false;
+
+  return systemCredentialFields.some(([key, schema]) => {
+    if (!requiredCredentials.has(key)) return false;
+    if (inputCredentials?.[key]) return false;
+
+    const providerNames = schema.credentials_provider || [];
+    const credentialTypes = schema.credentials_types || [];
+    const requiredScopes = schema.credentials_scopes;
+
+    return !hasAvailableSystemCredential(
+      providerNames,
+      credentialTypes,
+      requiredScopes,
+      allProviders,
+    );
+  });
+}
+
+function hasAvailableSystemCredential(
+  providerNames: string[],
+  credentialTypes: string[],
+  requiredScopes: string[] | undefined,
+  allProviders: CredentialsProvidersContextType | null | undefined,
+) {
+  if (!allProviders) return false;
+
+  for (const providerName of providerNames) {
+    const providerData = allProviders[providerName];
+    if (!providerData) continue;
+
+    const systemCredentials = getSystemCredentials(
+      providerData.savedCredentials ?? [],
+    );
+
+    for (const credential of systemCredentials) {
+      const typeMatches =
+        credentialTypes.length === 0 ||
+        credentialTypes.includes(credential.type);
+      const scopesMatch = hasRequiredScopes(credential, requiredScopes);
+
+      if (!typeMatches) continue;
+      if (!scopesMatch) continue;
+
+      return true;
+    }
+
+    const allCredentials = providerData.savedCredentials ?? [];
+    for (const credential of allCredentials) {
+      const typeMatches =
+        credentialTypes.length === 0 ||
+        credentialTypes.includes(credential.type);
+      const scopesMatch = hasRequiredScopes(credential, requiredScopes);
+
+      if (!typeMatches) continue;
+      if (!scopesMatch) continue;
+
+      return true;
+    }
+  }
+
+  return false;
+}
+
+export function findSavedCredentialByProviderAndType(
+  providerNames: string[],
+  credentialTypes: string[],
+  requiredScopes: string[] | undefined,
+  allProviders: CredentialsProvidersContextType | null,
+): SavedCredential | undefined {
+  for (const providerName of providerNames) {
+    const providerData = allProviders?.[providerName];
+    if (!providerData) continue;
+
+    const systemCredentials = getSystemCredentials(
+      providerData.savedCredentials ?? [],
+    );
+
+    const matchingCredentials: SavedCredential[] = [];
+
+    for (const credential of systemCredentials) {
+      const typeMatches =
+        credentialTypes.length === 0 ||
+        credentialTypes.includes(credential.type);
+      const scopesMatch = hasRequiredScopes(credential, requiredScopes);
+
+      if (!typeMatches) continue;
+      if (!scopesMatch) continue;
+
+      matchingCredentials.push(credential as SavedCredential);
+    }
+
+    if (matchingCredentials.length === 0) {
+      const allCredentials = providerData.savedCredentials ?? [];
+      for (const credential of allCredentials) {
+        const typeMatches =
+          credentialTypes.length === 0 ||
+          credentialTypes.includes(credential.type);
+        const scopesMatch = hasRequiredScopes(credential, requiredScopes);
+
+        if (!typeMatches) continue;
+        if (!scopesMatch) continue;
+
+        matchingCredentials.push(credential as SavedCredential);
+      }
+    }
+
+    if (matchingCredentials.length === 1) {
+      return matchingCredentials[0];
+    }
+    if (matchingCredentials.length > 1) {
+      return undefined;
+    }
+  }
+
+  return undefined;
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentModal/useAgentRunModal.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentModal/useAgentRunModal.tsx
index b997a33fcf..c867b11098 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentModal/useAgentRunModal.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentModal/useAgentRunModal.tsx
@@ -11,9 +11,18 @@ import { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
 import { LibraryAgentPreset } from "@/app/api/__generated__/models/libraryAgentPreset";
 import { useToast } from "@/components/molecules/Toast/use-toast";
 import { isEmpty } from "@/lib/utils";
+import { CredentialsProvidersContext } from "@/providers/agent-credentials/credentials-provider";
 import { analytics } from "@/services/analytics";
 import { useQueryClient } from "@tanstack/react-query";
-import { useCallback, useEffect, useMemo, useState } from "react";
+import {
+  useCallback,
+  useContext,
+  useEffect,
+  useMemo,
+  useRef,
+  useState,
+} from "react";
+import { getSystemCredentials } from "../../../../../../../../../../components/contextual/CredentialsInput/helpers";
 import { showExecutionErrorToast } from "./errorHelpers";
 
 export type RunVariant =
@@ -42,8 +51,10 @@ export function useAgentRunModal(
   const [inputCredentials, setInputCredentials] = useState<Record<string, any>>(
     callbacks?.initialInputCredentials || {},
   );
+
   const [presetName, setPresetName] = useState<string>("");
   const [presetDescription, setPresetDescription] = useState<string>("");
+  const hasInitializedSystemCreds = useRef(false);
 
   // Determine the default run type based on agent capabilities
   const defaultRunType: RunVariant = agent.trigger_setup_info
@@ -58,6 +69,91 @@ export function useAgentRunModal(
     setInputCredentials(callbacks?.initialInputCredentials || {});
   }, [callbacks?.initialInputValues, callbacks?.initialInputCredentials]);
 
+  const allProviders = useContext(CredentialsProvidersContext);
+
+  // Initialize credentials with default system credentials
+  useEffect(() => {
+    if (!allProviders || !agent.credentials_input_schema?.properties) return;
+    if (callbacks?.initialInputCredentials) {
+      hasInitializedSystemCreds.current = true;
+      return;
+    }
+    if (hasInitializedSystemCreds.current) return;
+
+    const properties = agent.credentials_input_schema.properties as Record<
+      string,
+      any
+    >;
+
+    setInputCredentials((currentCreds) => {
+      const credsToAdd: Record<string, any> = {};
+
+      for (const [key, schema] of Object.entries(properties)) {
+        if (currentCreds[key]) continue;
+
+        const providerNames = schema.credentials_provider || [];
+        const supportedTypes = schema.credentials_types || [];
+        const requiredScopes = schema.credentials_scopes;
+
+        for (const providerName of providerNames) {
+          const providerData = allProviders[providerName];
+          if (!providerData) continue;
+
+          const systemCreds = getSystemCredentials(
+            providerData.savedCredentials ?? [],
+          );
+          const matchingSystemCreds = systemCreds.filter((cred) => {
+            if (!supportedTypes.includes(cred.type)) return false;
+
+            if (
+              cred.type === "oauth2" &&
+              requiredScopes &&
+              requiredScopes.length > 0
+            ) {
+              const grantedScopes = new Set(cred.scopes || []);
+              const hasAllRequiredScopes = requiredScopes.every(
+                (scope: string) => grantedScopes.has(scope),
+              );
+              if (!hasAllRequiredScopes) return false;
+            }
+
+            return true;
+          });
+
+          if (matchingSystemCreds.length === 1) {
+            const systemCred = matchingSystemCreds[0];
+            credsToAdd[key] = {
+              id: systemCred.id,
+              type: systemCred.type,
+              provider: providerName,
+              title: systemCred.title,
+            };
+            break;
+          }
+        }
+      }
+
+      if (Object.keys(credsToAdd).length > 0) {
+        hasInitializedSystemCreds.current = true;
+        return {
+          ...currentCreds,
+          ...credsToAdd,
+        };
+      }
+
+      return currentCreds;
+    });
+  }, [
+    allProviders,
+    agent.credentials_input_schema,
+    callbacks?.initialInputCredentials,
+  ]);
+
+  // Reset initialization flag when modal closes/opens or agent changes
+  useEffect(() => {
+    hasInitializedSystemCreds.current = false;
+  }, [isOpen, agent.graph_id]);
+
   // API mutations
   const executeGraphMutation = usePostV1ExecuteGraphAgent({
     mutation: {
@@ -66,7 +162,6 @@ export function useAgentRunModal(
           toast({
             title: "Agent execution started",
           });
-          // Invalidate runs list for this graph
           queryClient.invalidateQueries({
             queryKey: getGetV1ListGraphExecutionsQueryKey(agent.graph_id),
           });
@@ -163,22 +258,23 @@ export function useAgentRunModal(
   }, [agentInputSchema.required, inputValues]);
 
   const [allCredentialsAreSet, missingCredentials] = useMemo(() => {
-    const availableCredentials = new Set(Object.keys(inputCredentials));
-    const allCredentials = new Set(
-      Object.keys(agentCredentialsInputFields || {}) ?? [],
-    );
-    const missing = [...allCredentials].filter(
-      (key) => !availableCredentials.has(key),
+    const requiredCredentials = new Set(
+      (agent.credentials_input_schema?.required as string[]) || [],
     );
+
+    const missing = [...requiredCredentials].filter((key) => {
+      const cred = inputCredentials[key];
+      return !cred || !cred.id;
+    });
+
     return [missing.length === 0, missing];
-  }, [agentCredentialsInputFields, inputCredentials]);
+  }, [agent.credentials_input_schema, inputCredentials]);
 
   const credentialsRequired = useMemo(
     () => Object.keys(agentCredentialsInputFields || {}).length > 0,
     [agentCredentialsInputFields],
   );
 
-  // Final readiness flag combining inputs + credentials when credentials are shown
   const allRequiredInputsAreSet = useMemo(
     () =>
       allRequiredInputsAreSetRaw &&
@@ -217,7 +313,6 @@ export function useAgentRunModal(
       defaultRunType === "automatic-trigger" ||
       defaultRunType === "manual-trigger"
     ) {
-      // Setup trigger
       if (!presetName.trim()) {
         toast({
           title: "⚠️ Trigger name required",
@@ -238,13 +333,16 @@ export function useAgentRunModal(
         },
       });
     } else {
-      // Manual execution
+      const validCredentials = Object.fromEntries(
+        Object.entries(inputCredentials).filter(([_, cred]) => cred && cred.id),
+      );
+
       executeGraphMutation.mutate({
         graphId: agent.graph_id,
         graphVersion: agent.graph_version,
         data: {
           inputs: inputValues,
-          credentials_inputs: inputCredentials,
+          credentials_inputs: validCredentials,
           source: "library",
         },
       });
@@ -268,41 +366,24 @@ export function useAgentRunModal(
   }, [agentInputFields]);
 
   return {
-    // UI state
     isOpen,
     setIsOpen,
-
-    // Run mode
     defaultRunType: defaultRunType as RunVariant,
-
-    // Form: regular inputs
     inputValues,
     setInputValues,
-
-    // Form: credentials
     inputCredentials,
     setInputCredentials,
-
-    // Preset/trigger labels
     presetName,
     presetDescription,
     setPresetName,
     setPresetDescription,
-
-    // Validation/readiness
     allRequiredInputsAreSet,
     missingInputs,
-
-    // Schemas for rendering
     agentInputFields,
     agentCredentialsInputFields,
     hasInputFields,
-
-    // Async states
     isExecuting: executeGraphMutation.isPending,
     isSettingUpTrigger: setupTriggerMutation.isPending,
-
-    // Actions
     handleRun,
   };
 }
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/AgentSettingsButton.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/AgentSettingsButton.tsx
index 11dcbd943f..95fdf826a2 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/AgentSettingsButton.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/AgentSettingsButton.tsx
@@ -1,37 +1,17 @@
 import { Button } from "@/components/atoms/Button/Button";
+import { Text } from "@/components/atoms/Text/Text";
 import { GearIcon } from "@phosphor-icons/react";
-import { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
-import { useAgentSafeMode } from "@/hooks/useAgentSafeMode";
-
-interface Props {
-  agent: LibraryAgent;
-  onSelectSettings: () => void;
-  selected?: boolean;
-}
-
-export function AgentSettingsButton({
-  agent,
-  onSelectSettings,
-  selected,
-}: Props) {
-  const { hasHITLBlocks } = useAgentSafeMode(agent);
-
-  if (!hasHITLBlocks) {
-    return null;
-  }
 
+export function AgentSettingsButton() {
   return (
     <Button
-      variant={selected ? "secondary" : "ghost"}
+      variant="ghost"
       size="small"
       className="m-0 min-w-0 rounded-full p-0 px-1"
-      onClick={onSelectSettings}
       aria-label="Agent Settings"
     >
-      <GearIcon
-        size={18}
-        className={selected ? "text-zinc-900" : "text-zinc-600"}
-      />
+      <GearIcon size={18} className="text-zinc-600" />
+      <Text variant="small">Agent Settings</Text>
     </Button>
   );
 }
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/EmptySchedules.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/EmptySchedules.tsx
index 97492d8a59..4c781b2896 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/EmptySchedules.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/EmptySchedules.tsx
@@ -1,3 +1,5 @@
+"use client";
+
 import { Text } from "@/components/atoms/Text/Text";
 
 export function EmptySchedules() {
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/EmptyTasks.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/EmptyTasks.tsx
index 3446611827..5ac3745bd4 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/EmptyTasks.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/EmptyTasks.tsx
@@ -1,17 +1,25 @@
 "use client";
 
 import { getV1GetGraphVersion } from "@/app/api/__generated__/endpoints/graphs/graphs";
+import {
+  getGetV2ListLibraryAgentsQueryKey,
+  useDeleteV2DeleteLibraryAgent,
+} from "@/app/api/__generated__/endpoints/library/library";
 import { GraphExecutionJobInfo } from "@/app/api/__generated__/models/graphExecutionJobInfo";
 import { GraphExecutionMeta } from "@/app/api/__generated__/models/graphExecutionMeta";
 import { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
 import { LibraryAgentPreset } from "@/app/api/__generated__/models/libraryAgentPreset";
 import { Button } from "@/components/atoms/Button/Button";
 import { Text } from "@/components/atoms/Text/Text";
+import { Dialog } from "@/components/molecules/Dialog/Dialog";
 import { ShowMoreText } from "@/components/molecules/ShowMoreText/ShowMoreText";
 import { useToast } from "@/components/molecules/Toast/use-toast";
 import { exportAsJSONFile } from "@/lib/utils";
 import { formatDate } from "@/lib/utils/time";
+import { useQueryClient } from "@tanstack/react-query";
 import Link from "next/link";
+import { useRouter } from "next/navigation";
+import { useState } from "react";
 import { RunAgentModal } from "../modals/RunAgentModal/RunAgentModal";
 import { RunDetailCard } from "../selected-views/RunDetailCard/RunDetailCard";
 import { EmptyTasksIllustration } from "./EmptyTasksIllustration";
@@ -30,6 +38,41 @@ export function EmptyTasks({
   onScheduleCreated,
 }: Props) {
   const { toast } = useToast();
+  const queryClient = useQueryClient();
+  const router = useRouter();
+  const [showDeleteDialog, setShowDeleteDialog] = useState(false);
+  const [isDeletingAgent, setIsDeletingAgent] = useState(false);
+
+  const { mutateAsync: deleteAgent } = useDeleteV2DeleteLibraryAgent();
+
+  async function handleDeleteAgent() {
+    if (!agent.id) return;
+
+    setIsDeletingAgent(true);
+
+    try {
+      await deleteAgent({ libraryAgentId: agent.id });
+
+      await queryClient.refetchQueries({
+        queryKey: getGetV2ListLibraryAgentsQueryKey(),
+      });
+
+      toast({ title: "Agent deleted" });
+      setShowDeleteDialog(false);
+      router.push("/library");
+    } catch (error: unknown) {
+      toast({
+        title: "Failed to delete agent",
+        description:
+          error instanceof Error
+            ? error.message
+            : "An unexpected error occurred.",
+        variant: "destructive",
+      });
+    } finally {
+      setIsDeletingAgent(false);
+    }
+  }
 
   async function handleExport() {
     try {
@@ -147,9 +190,50 @@ export function EmptyTasks({
             <Button variant="secondary" size="small" onClick={handleExport}>
               Export agent to file
             </Button>
+            <Button
+              variant="secondary"
+              size="small"
+              onClick={() => setShowDeleteDialog(true)}
+            >
+              Delete agent
+            </Button>
           </div>
         </div>
       </div>
+
+      <Dialog
+        controlled={{
+          isOpen: showDeleteDialog,
+          set: setShowDeleteDialog,
+        }}
+        styling={{ maxWidth: "32rem" }}
+        title="Delete agent"
+      >
+        <Dialog.Content>
+          <div>
+            <Text variant="large">
+              Are you sure you want to delete this agent? This action cannot be
+              undone.
+            </Text>
+            <Dialog.Footer>
+              <Button
+                variant="secondary"
+                disabled={isDeletingAgent}
+                onClick={() => setShowDeleteDialog(false)}
+              >
+                Cancel
+              </Button>
+              <Button
+                variant="destructive"
+                onClick={handleDeleteAgent}
+                loading={isDeletingAgent}
+              >
+                Delete Agent
+              </Button>
+            </Dialog.Footer>
+          </div>
+        </Dialog.Content>
+      </Dialog>
     </div>
   );
 }
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/EmptyTemplates.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/EmptyTemplates.tsx
index c33abe69ad..364b762167 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/EmptyTemplates.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/EmptyTemplates.tsx
@@ -1,3 +1,5 @@
+"use client";
+
 import { Text } from "@/components/atoms/Text/Text";
 
 export function EmptyTemplates() {
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/EmptyTriggers.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/EmptyTriggers.tsx
index 0d9dc47fff..06d09ff9a0 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/EmptyTriggers.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/EmptyTriggers.tsx
@@ -1,3 +1,5 @@
+"use client";
+
 import { Text } from "@/components/atoms/Text/Text";
 
 export function EmptyTriggers() {
diff --git a/autogpt_platform/frontend/src/components/contextual/MarketplaceBanners/MarketplaceBanners.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/MarketplaceBanners.tsx
similarity index 97%
rename from autogpt_platform/frontend/src/components/contextual/MarketplaceBanners/MarketplaceBanners.tsx
rename to autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/MarketplaceBanners.tsx
index 4f826f6e85..00edcc721f 100644
--- a/autogpt_platform/frontend/src/components/contextual/MarketplaceBanners/MarketplaceBanners.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/MarketplaceBanners.tsx
@@ -3,7 +3,7 @@
 import { Button } from "@/components/atoms/Button/Button";
 import { Text } from "@/components/atoms/Text/Text";
 
-interface MarketplaceBannersProps {
+interface Props {
   hasUpdate?: boolean;
   latestVersion?: number;
   hasUnpublishedChanges?: boolean;
@@ -21,7 +21,7 @@ export function MarketplaceBanners({
   isUpdating,
   onUpdate,
   onPublish,
-}: MarketplaceBannersProps) {
+}: Props) {
   const renderUpdateBanner = () => {
     if (hasUpdate && latestVersion) {
       return (
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/SectionWrap.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/SectionWrap.tsx
index 75571dd856..f88d91bb0d 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/SectionWrap.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/SectionWrap.tsx
@@ -1,3 +1,5 @@
+"use client";
+
 import { cn } from "@/lib/utils";
 
 type Props = {
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/LoadingSelectedContent.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/LoadingSelectedContent.tsx
index dc2bb7cac2..bc5548afd0 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/LoadingSelectedContent.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/LoadingSelectedContent.tsx
@@ -1,22 +1,16 @@
+import { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
 import { Skeleton } from "@/components/__legacy__/ui/skeleton";
 import { cn } from "@/lib/utils";
-import { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
 import { AGENT_LIBRARY_SECTION_PADDING_X } from "../../helpers";
 import { SelectedViewLayout } from "./SelectedViewLayout";
 
 interface Props {
   agent: LibraryAgent;
-  onSelectSettings?: () => void;
-  selectedSettings?: boolean;
 }
 
 export function LoadingSelectedContent(props: Props) {
   return (
-    <SelectedViewLayout
-      agent={props.agent}
-      onSelectSettings={props.onSelectSettings}
-      selectedSettings={props.selectedSettings}
-    >
+    <SelectedViewLayout agent={props.agent}>
       <div
         className={cn("flex flex-col gap-4", AGENT_LIBRARY_SECTION_PADDING_X)}
       >
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/OutputRenderers/renderers/CodeRenderer.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/OutputRenderers/renderers/CodeRenderer.tsx
index 93df7d8ddd..a204890a3a 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/OutputRenderers/renderers/CodeRenderer.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/OutputRenderers/renderers/CodeRenderer.tsx
@@ -83,7 +83,9 @@ function renderCode(
         </div>
       )}
       <pre className="overflow-x-auto rounded-md bg-muted p-3">
-        <code className="font-mono text-sm">{codeValue}</code>
+        <code className="whitespace-pre-wrap break-words font-mono text-sm">
+          {codeValue}
+        </code>
       </pre>
     </div>
   );
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedRunView/SelectedRunView.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedRunView/SelectedRunView.tsx
index c66f0e9245..05da986583 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedRunView/SelectedRunView.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedRunView/SelectedRunView.tsx
@@ -33,8 +33,6 @@ interface Props {
   onSelectRun?: (id: string) => void;
   onClearSelectedRun?: () => void;
   banner?: React.ReactNode;
-  onSelectSettings?: () => void;
-  selectedSettings?: boolean;
 }
 
 export function SelectedRunView({
@@ -43,8 +41,6 @@ export function SelectedRunView({
   onSelectRun,
   onClearSelectedRun,
   banner,
-  onSelectSettings,
-  selectedSettings,
 }: Props) {
   const { run, preset, isLoading, responseError, httpError } =
     useSelectedRunView(agent.graph_id, runId);
@@ -84,12 +80,7 @@ export function SelectedRunView({
   return (
     <div className="flex h-full w-full gap-4">
       <div className="flex min-h-0 min-w-0 flex-1 flex-col">
-        <SelectedViewLayout
-          agent={agent}
-          banner={banner}
-          onSelectSettings={onSelectSettings}
-          selectedSettings={selectedSettings}
-        >
+        <SelectedViewLayout agent={agent} banner={banner}>
           <div className="flex flex-col gap-4">
             <RunDetailHeader agent={agent} run={run} />
 
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedRunView/components/RunOutputs.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedRunView/components/RunOutputs.tsx
index 20e218abb2..9824283c40 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedRunView/components/RunOutputs.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedRunView/components/RunOutputs.tsx
@@ -3,12 +3,12 @@
 import type {
   OutputMetadata,
   OutputRenderer,
-} from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/OutputRenderers";
+} from "@/components/contextual/OutputRenderers";
 import {
   globalRegistry,
   OutputActions,
   OutputItem,
-} from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/OutputRenderers";
+} from "@/components/contextual/OutputRenderers";
 import React, { useMemo } from "react";
 
 type OutputsRecord = Record<string, Array<unknown>>;
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedScheduleView/SelectedScheduleView.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedScheduleView/SelectedScheduleView.tsx
index 4cc6d8c5b0..e0a81dba5f 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedScheduleView/SelectedScheduleView.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedScheduleView/SelectedScheduleView.tsx
@@ -13,7 +13,7 @@ import { LoadingSelectedContent } from "../LoadingSelectedContent";
 import { RunDetailCard } from "../RunDetailCard/RunDetailCard";
 import { RunDetailHeader } from "../RunDetailHeader/RunDetailHeader";
 import { SelectedViewLayout } from "../SelectedViewLayout";
-import { SelectedScheduleActions } from "./components/SelectedScheduleActions";
+import { SelectedScheduleActions } from "./components/SelectedScheduleActions/SelectedScheduleActions";
 import { useSelectedScheduleView } from "./useSelectedScheduleView";
 
 interface Props {
@@ -21,8 +21,6 @@ interface Props {
   scheduleId: string;
   onClearSelectedRun?: () => void;
   banner?: React.ReactNode;
-  onSelectSettings?: () => void;
-  selectedSettings?: boolean;
 }
 
 export function SelectedScheduleView({
@@ -30,8 +28,6 @@ export function SelectedScheduleView({
   scheduleId,
   onClearSelectedRun,
   banner,
-  onSelectSettings,
-  selectedSettings,
 }: Props) {
   const { schedule, isLoading, error } = useSelectedScheduleView(
     agent.graph_id,
@@ -76,12 +72,7 @@ export function SelectedScheduleView({
   return (
     <div className="flex h-full w-full gap-4">
       <div className="flex min-h-0 min-w-0 flex-1 flex-col">
-        <SelectedViewLayout
-          agent={agent}
-          banner={banner}
-          onSelectSettings={onSelectSettings}
-          selectedSettings={selectedSettings}
-        >
+        <SelectedViewLayout agent={agent} banner={banner}>
           <div className="flex flex-col gap-4">
             <div className="flex w-full flex-col gap-0">
               <RunDetailHeader
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedScheduleView/components/SelectedScheduleActions.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedScheduleView/components/SelectedScheduleActions.tsx
deleted file mode 100644
index 0fd34851fd..0000000000
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedScheduleView/components/SelectedScheduleActions.tsx
+++ /dev/null
@@ -1,40 +0,0 @@
-import { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
-import { Button } from "@/components/atoms/Button/Button";
-import { EyeIcon } from "@phosphor-icons/react";
-import { AgentActionsDropdown } from "../../AgentActionsDropdown";
-import { useScheduleDetailHeader } from "../../RunDetailHeader/useScheduleDetailHeader";
-import { SelectedActionsWrap } from "../../SelectedActionsWrap";
-
-type Props = {
-  agent: LibraryAgent;
-  scheduleId: string;
-  onDeleted?: () => void;
-};
-
-export function SelectedScheduleActions({ agent, scheduleId }: Props) {
-  const { openInBuilderHref } = useScheduleDetailHeader(
-    agent.graph_id,
-    scheduleId,
-    agent.graph_version,
-  );
-
-  return (
-    <>
-      <SelectedActionsWrap>
-        {openInBuilderHref && (
-          <Button
-            variant="icon"
-            size="icon"
-            as="NextLink"
-            href={openInBuilderHref}
-            target="_blank"
-            aria-label="View scheduled task details"
-          >
-            <EyeIcon weight="bold" size={18} className="text-zinc-700" />
-          </Button>
-        )}
-        <AgentActionsDropdown agent={agent} scheduleId={scheduleId} />
-      </SelectedActionsWrap>
-    </>
-  );
-}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedScheduleView/components/SelectedScheduleActions/SelectedScheduleActions.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedScheduleView/components/SelectedScheduleActions/SelectedScheduleActions.tsx
new file mode 100644
index 0000000000..9088cb112b
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedScheduleView/components/SelectedScheduleActions/SelectedScheduleActions.tsx
@@ -0,0 +1,96 @@
+"use client";
+
+import { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
+import { Button } from "@/components/atoms/Button/Button";
+import { LoadingSpinner } from "@/components/atoms/LoadingSpinner/LoadingSpinner";
+import { Text } from "@/components/atoms/Text/Text";
+import { Dialog } from "@/components/molecules/Dialog/Dialog";
+import { EyeIcon, TrashIcon } from "@phosphor-icons/react";
+import { AgentActionsDropdown } from "../../../AgentActionsDropdown";
+import { SelectedActionsWrap } from "../../../SelectedActionsWrap";
+import { useSelectedScheduleActions } from "./useSelectedScheduleActions";
+
+type Props = {
+  agent: LibraryAgent;
+  scheduleId: string;
+  onDeleted?: () => void;
+};
+
+export function SelectedScheduleActions({
+  agent,
+  scheduleId,
+  onDeleted,
+}: Props) {
+  const {
+    openInBuilderHref,
+    showDeleteDialog,
+    setShowDeleteDialog,
+    handleDelete,
+    isDeleting,
+  } = useSelectedScheduleActions({ agent, scheduleId, onDeleted });
+
+  return (
+    <>
+      <SelectedActionsWrap>
+        {openInBuilderHref && (
+          <Button
+            variant="icon"
+            size="icon"
+            as="NextLink"
+            href={openInBuilderHref}
+            target="_blank"
+            aria-label="View scheduled task details"
+          >
+            <EyeIcon weight="bold" size={18} className="text-zinc-700" />
+          </Button>
+        )}
+        <Button
+          variant="icon"
+          size="icon"
+          aria-label="Delete schedule"
+          onClick={() => setShowDeleteDialog(true)}
+          disabled={isDeleting}
+        >
+          {isDeleting ? (
+            <LoadingSpinner size="small" />
+          ) : (
+            <TrashIcon weight="bold" size={18} />
+          )}
+        </Button>
+        <AgentActionsDropdown agent={agent} scheduleId={scheduleId} />
+      </SelectedActionsWrap>
+
+      <Dialog
+        controlled={{
+          isOpen: showDeleteDialog,
+          set: setShowDeleteDialog,
+        }}
+        styling={{ maxWidth: "32rem" }}
+        title="Delete schedule"
+      >
+        <Dialog.Content>
+          <Text variant="large">
+            Are you sure you want to delete this schedule? This action cannot be
+            undone.
+          </Text>
+          <Dialog.Footer>
+            <Button
+              variant="secondary"
+              onClick={() => setShowDeleteDialog(false)}
+              disabled={isDeleting}
+            >
+              Cancel
+            </Button>
+            <Button
+              variant="destructive"
+              onClick={handleDelete}
+              loading={isDeleting}
+            >
+              Delete Schedule
+            </Button>
+          </Dialog.Footer>
+        </Dialog.Content>
+      </Dialog>
+    </>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedScheduleView/components/SelectedScheduleActions/useSelectedScheduleActions.ts b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedScheduleView/components/SelectedScheduleActions/useSelectedScheduleActions.ts
new file mode 100644
index 0000000000..1e22b764eb
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedScheduleView/components/SelectedScheduleActions/useSelectedScheduleActions.ts
@@ -0,0 +1,65 @@
+"use client";
+
+import {
+  getGetV1ListExecutionSchedulesForAGraphQueryOptions,
+  useDeleteV1DeleteExecutionSchedule,
+} from "@/app/api/__generated__/endpoints/schedules/schedules";
+import { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
+import { useToast } from "@/components/molecules/Toast/use-toast";
+import { useQueryClient } from "@tanstack/react-query";
+import { useState } from "react";
+
+interface UseSelectedScheduleActionsProps {
+  agent: LibraryAgent;
+  scheduleId: string;
+  onDeleted?: () => void;
+}
+
+export function useSelectedScheduleActions({
+  agent,
+  scheduleId,
+  onDeleted,
+}: UseSelectedScheduleActionsProps) {
+  const { toast } = useToast();
+  const queryClient = useQueryClient();
+  const [showDeleteDialog, setShowDeleteDialog] = useState(false);
+
+  const deleteMutation = useDeleteV1DeleteExecutionSchedule({
+    mutation: {
+      onSuccess: () => {
+        toast({ title: "Schedule deleted" });
+        queryClient.invalidateQueries({
+          queryKey: getGetV1ListExecutionSchedulesForAGraphQueryOptions(
+            agent.graph_id,
+          ).queryKey,
+        });
+        setShowDeleteDialog(false);
+        onDeleted?.();
+      },
+      onError: (error: unknown) =>
+        toast({
+          title: "Failed to delete schedule",
+          description:
+            error instanceof Error
+              ? error.message
+              : "An unexpected error occurred.",
+          variant: "destructive",
+        }),
+    },
+  });
+
+  function handleDelete() {
+    if (!scheduleId) return;
+    deleteMutation.mutate({ scheduleId });
+  }
+
+  const openInBuilderHref = `/build?flowID=${agent.graph_id}&flowVersion=${agent.graph_version}`;
+
+  return {
+    openInBuilderHref,
+    showDeleteDialog,
+    setShowDeleteDialog,
+    handleDelete,
+    isDeleting: deleteMutation.isPending,
+  };
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedSettingsView/SelectedSettingsView.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedSettingsView/SelectedSettingsView.tsx
index 68622458f6..57d7055e1c 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedSettingsView/SelectedSettingsView.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedSettingsView/SelectedSettingsView.tsx
@@ -1,11 +1,11 @@
 import { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
-import { Text } from "@/components/atoms/Text/Text";
-import { Switch } from "@/components/atoms/Switch/Switch";
 import { Button } from "@/components/atoms/Button/Button";
-import { ArrowLeftIcon } from "@phosphor-icons/react";
+import { Switch } from "@/components/atoms/Switch/Switch";
+import { Text } from "@/components/atoms/Text/Text";
 import { useAgentSafeMode } from "@/hooks/useAgentSafeMode";
-import { SelectedViewLayout } from "../SelectedViewLayout";
+import { ArrowLeftIcon } from "@phosphor-icons/react";
 import { AGENT_LIBRARY_SECTION_PADDING_X } from "../../../helpers";
+import { SelectedViewLayout } from "../SelectedViewLayout";
 
 interface Props {
   agent: LibraryAgent;
@@ -17,7 +17,7 @@ export function SelectedSettingsView({ agent, onClearSelectedRun }: Props) {
     useAgentSafeMode(agent);
 
   return (
-    <SelectedViewLayout agent={agent} onSelectSettings={() => {}}>
+    <SelectedViewLayout agent={agent}>
       <div className="flex flex-col gap-4">
         <div
           className={`${AGENT_LIBRARY_SECTION_PADDING_X} mb-8 flex items-center gap-3`}
@@ -33,15 +33,8 @@ export function SelectedSettingsView({ agent, onClearSelectedRun }: Props) {
           <Text variant="h2">Agent Settings</Text>
         </div>
 
-        <div className={AGENT_LIBRARY_SECTION_PADDING_X}>
-          {!hasHITLBlocks ? (
-            <div className="rounded-xl border border-zinc-100 bg-white p-6">
-              <Text variant="body" className="text-muted-foreground">
-                This agent doesn&apos;t have any human-in-the-loop blocks, so
-                there are no settings to configure.
-              </Text>
-            </div>
-          ) : (
+        <div className={`${AGENT_LIBRARY_SECTION_PADDING_X} space-y-6`}>
+          {hasHITLBlocks ? (
             <div className="flex w-full max-w-2xl flex-col items-start gap-4 rounded-xl border border-zinc-100 bg-white p-6">
               <div className="flex w-full items-start justify-between gap-4">
                 <div className="flex-1">
@@ -59,6 +52,12 @@ export function SelectedSettingsView({ agent, onClearSelectedRun }: Props) {
                 />
               </div>
             </div>
+          ) : (
+            <div className="rounded-xl border border-zinc-100 bg-white p-6">
+              <Text variant="body" className="text-muted-foreground">
+                This agent doesn&apos;t have any configurable settings.
+              </Text>
+            </div>
           )}
         </div>
       </div>
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedTemplateView/SelectedTemplateView.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedTemplateView/SelectedTemplateView.tsx
index b5ecb7ae5c..bc411d37e6 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedTemplateView/SelectedTemplateView.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedTemplateView/SelectedTemplateView.tsx
@@ -4,11 +4,11 @@ import type { GraphExecutionMeta } from "@/app/api/__generated__/models/graphExe
 import type { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
 import { Input } from "@/components/atoms/Input/Input";
 import { ErrorCard } from "@/components/molecules/ErrorCard/ErrorCard";
+import { CredentialsInput } from "../../../../../../../../../../components/contextual/CredentialsInput/CredentialsInput";
 import {
   getAgentCredentialsFields,
   getAgentInputFields,
 } from "../../modals/AgentInputsReadOnly/helpers";
-import { CredentialsInput } from "../../modals/CredentialsInputs/CredentialsInputs";
 import { RunAgentInputs } from "../../modals/RunAgentInputs/RunAgentInputs";
 import { LoadingSelectedContent } from "../LoadingSelectedContent";
 import { RunDetailCard } from "../RunDetailCard/RunDetailCard";
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedTriggerView/SelectedTriggerView.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedTriggerView/SelectedTriggerView.tsx
index f92c91112e..74dfbd12c2 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedTriggerView/SelectedTriggerView.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedTriggerView/SelectedTriggerView.tsx
@@ -2,12 +2,12 @@
 
 import type { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
 import { Input } from "@/components/atoms/Input/Input";
+import { CredentialsInput } from "@/components/contextual/CredentialsInput/CredentialsInput";
 import { ErrorCard } from "@/components/molecules/ErrorCard/ErrorCard";
 import {
   getAgentCredentialsFields,
   getAgentInputFields,
 } from "../../modals/AgentInputsReadOnly/helpers";
-import { CredentialsInput } from "../../modals/CredentialsInputs/CredentialsInputs";
 import { RunAgentInputs } from "../../modals/RunAgentInputs/RunAgentInputs";
 import { LoadingSelectedContent } from "../LoadingSelectedContent";
 import { RunDetailCard } from "../RunDetailCard/RunDetailCard";
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedViewLayout.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedViewLayout.tsx
index 8a4e46a606..fe824604df 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedViewLayout.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/selected-views/SelectedViewLayout.tsx
@@ -1,7 +1,7 @@
-import { Breadcrumbs } from "@/components/molecules/Breadcrumbs/Breadcrumbs";
-import { AgentSettingsButton } from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/other/AgentSettingsButton";
 import { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
+import { Breadcrumbs } from "@/components/molecules/Breadcrumbs/Breadcrumbs";
 import { AGENT_LIBRARY_SECTION_PADDING_X } from "../../helpers";
+import { AgentSettingsModal } from "../modals/AgentSettingsModal/AgentSettingsModal";
 import { SectionWrap } from "../other/SectionWrap";
 
 interface Props {
@@ -9,8 +9,6 @@ interface Props {
   children: React.ReactNode;
   banner?: React.ReactNode;
   additionalBreadcrumb?: { name: string; link?: string };
-  onSelectSettings?: () => void;
-  selectedSettings?: boolean;
 }
 
 export function SelectedViewLayout(props: Props) {
@@ -19,8 +17,8 @@ export function SelectedViewLayout(props: Props) {
       <div
         className={`${AGENT_LIBRARY_SECTION_PADDING_X} flex-shrink-0 border-b border-zinc-100 pb-0 lg:pb-4`}
       >
-        {props.banner && <div className="mb-4">{props.banner}</div>}
-        <div className="relative flex w-fit items-center gap-2">
+        {props.banner}
+        <div className="relative flex w-full items-center justify-between">
           <Breadcrumbs
             items={[
               { name: "My Library", link: "/library" },
@@ -33,15 +31,9 @@ export function SelectedViewLayout(props: Props) {
                 : []),
             ]}
           />
-          {props.agent && props.onSelectSettings && (
-            <div className="absolute -right-8">
-              <AgentSettingsButton
-                agent={props.agent}
-                onSelectSettings={props.onSelectSettings}
-                selected={props.selectedSettings}
-              />
-            </div>
-          )}
+          <div className="absolute right-0">
+            <AgentSettingsModal agent={props.agent} />
+          </div>
         </div>
       </div>
       <div className="flex min-h-0 flex-1 flex-col overflow-y-auto overflow-x-visible">
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/hooks/useMarketplaceUpdate.ts b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/hooks/useMarketplaceUpdate.ts
index 4ae146e514..158fd3f134 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/hooks/useMarketplaceUpdate.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/hooks/useMarketplaceUpdate.ts
@@ -40,15 +40,17 @@ export function useMarketplaceUpdate({ agent }: UseMarketplaceUpdateProps) {
     },
   );
 
-  // Get user's submissions to check for pending submissions
-  const { data: submissionsData } = useGetV2ListMySubmissions(
-    { page: 1, page_size: 50 }, // Get enough to cover recent submissions
-    {
-      query: {
-        enabled: !!user?.id, // Only fetch if user is authenticated
+  // Get user's submissions - only fetch if user is the creator
+  const { data: submissionsData, isLoading: isSubmissionsLoading } =
+    useGetV2ListMySubmissions(
+      { page: 1, page_size: 50 },
+      {
+        query: {
+          // Only fetch if user is the creator
+          enabled: !!(user?.id && agent?.owner_user_id === user.id),
+        },
       },
-    },
-  );
+    );
 
   const updateToLatestMutation = usePatchV2UpdateLibraryAgent({
     mutation: {
@@ -78,16 +80,45 @@ export function useMarketplaceUpdate({ agent }: UseMarketplaceUpdateProps) {
   // Check if marketplace has a newer version than user's current version
   const marketplaceUpdateInfo = React.useMemo(() => {
     const storeAgent = okData(storeAgentData) as any;
-    if (!agent || !storeAgent) {
+
+    if (!agent || isSubmissionsLoading) {
       return {
         hasUpdate: false,
         latestVersion: undefined,
         isUserCreator: false,
+        hasPublishUpdate: false,
+      };
+    }
+
+    const isUserCreator = agent?.owner_user_id === user?.id;
+
+    const submissionsResponse = okData(submissionsData) as any;
+    const agentSubmissions =
+      submissionsResponse?.submissions?.filter(
+        (submission: StoreSubmission) => submission.agent_id === agent.graph_id,
+      ) || [];
+
+    const highestSubmittedVersion =
+      agentSubmissions.length > 0
+        ? Math.max(
+            ...agentSubmissions.map(
+              (submission: StoreSubmission) => submission.agent_version,
+            ),
+          )
+        : 0;
+
+    const hasUnpublishedChanges =
+      isUserCreator && agent.graph_version > highestSubmittedVersion;
+
+    if (!storeAgent) {
+      return {
+        hasUpdate: false,
+        latestVersion: undefined,
+        isUserCreator,
+        hasPublishUpdate: agentSubmissions.length > 0 && hasUnpublishedChanges,
       };
     }
 
-    // Get the latest version from the marketplace
-    // agentGraphVersions array contains graph version numbers as strings, get the highest one
     const latestMarketplaceVersion =
       storeAgent.agentGraphVersions?.length > 0
         ? Math.max(
@@ -97,32 +128,11 @@ export function useMarketplaceUpdate({ agent }: UseMarketplaceUpdateProps) {
           )
         : undefined;
 
-    // Determine if the user is the creator of this agent
-    // Compare current user ID with the marketplace listing creator ID
-    const isUserCreator =
-      user?.id && agent.marketplace_listing?.creator.id === user.id;
-
-    // Check if there's a pending submission for this specific agent version
-    const submissionsResponse = okData(submissionsData) as any;
-    const hasPendingSubmissionForCurrentVersion =
-      isUserCreator &&
-      submissionsResponse?.submissions?.some(
-        (submission: StoreSubmission) =>
-          submission.agent_id === agent.graph_id &&
-          submission.agent_version === agent.graph_version &&
-          submission.status === "PENDING",
-      );
-
-    // If user is creator and their version is newer than marketplace, show publish update banner
-    // BUT only if there's no pending submission for this version
     const hasPublishUpdate =
       isUserCreator &&
-      !hasPendingSubmissionForCurrentVersion &&
-      latestMarketplaceVersion !== undefined &&
-      agent.graph_version > latestMarketplaceVersion;
+      agent.graph_version >
+        Math.max(latestMarketplaceVersion || 0, highestSubmittedVersion);
 
-    // If marketplace version is newer than user's version, show update banner
-    // This applies to both creators and non-creators
     const hasMarketplaceUpdate =
       latestMarketplaceVersion !== undefined &&
       latestMarketplaceVersion > agent.graph_version;
@@ -133,7 +143,7 @@ export function useMarketplaceUpdate({ agent }: UseMarketplaceUpdateProps) {
       isUserCreator,
       hasPublishUpdate,
     };
-  }, [agent, storeAgentData, user, submissionsData]);
+  }, [agent, storeAgentData, user, submissionsData, isSubmissionsLoading]);
 
   const handlePublishUpdate = () => {
     setModalOpen(true);
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/OldAgentLibraryView/OldAgentLibraryView.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/OldAgentLibraryView/OldAgentLibraryView.tsx
index dff1b5a7bb..54cc07878d 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/OldAgentLibraryView/OldAgentLibraryView.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/OldAgentLibraryView/OldAgentLibraryView.tsx
@@ -173,8 +173,9 @@ export function OldAgentLibraryView() {
     if (agentRuns.length > 0) {
       // select latest run
       const latestRun = agentRuns.reduce((latest, current) => {
-        if (latest.started_at && !current.started_at) return current;
-        else if (!latest.started_at) return latest;
+        if (!latest.started_at && !current.started_at) return latest;
+        if (!latest.started_at) return current;
+        if (!current.started_at) return latest;
         return latest.started_at > current.started_at ? latest : current;
       }, agentRuns[0]);
       selectRun(latestRun.id as GraphExecutionID);
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/OldAgentLibraryView/components/agent-run-draft-view.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/OldAgentLibraryView/components/agent-run-draft-view.tsx
index 5f57032618..53a7e8b860 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/OldAgentLibraryView/components/agent-run-draft-view.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/OldAgentLibraryView/components/agent-run-draft-view.tsx
@@ -12,7 +12,6 @@ import {
 } from "@/lib/autogpt-server-api";
 import { useBackendAPI } from "@/lib/autogpt-server-api/context";
 
-import { CredentialsInput } from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/CredentialsInputs";
 import { RunAgentInputs } from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/RunAgentInputs/RunAgentInputs";
 import { ScheduleTaskDialog } from "@/app/(platform)/library/agents/[id]/components/OldAgentLibraryView/components/cron-scheduler-dialog";
 import ActionButtonGroup from "@/components/__legacy__/action-button-group";
@@ -30,6 +29,7 @@ import {
 } from "@/components/__legacy__/ui/icons";
 import { Input } from "@/components/__legacy__/ui/input";
 import { Button } from "@/components/atoms/Button/Button";
+import { CredentialsInput } from "@/components/contextual/CredentialsInput/CredentialsInput";
 import { InformationTooltip } from "@/components/molecules/InformationTooltip/InformationTooltip";
 import {
   useToast,
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/OldAgentLibraryView/components/agent-run-output-view.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/OldAgentLibraryView/components/agent-run-output-view.tsx
index e55914b4ea..668ac2e215 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/OldAgentLibraryView/components/agent-run-output-view.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/OldAgentLibraryView/components/agent-run-output-view.tsx
@@ -11,12 +11,12 @@ import {
 } from "@/components/__legacy__/ui/card";
 
 import LoadingBox from "@/components/__legacy__/ui/loading";
-import type { OutputMetadata } from "../../NewAgentLibraryView/components/selected-views/OutputRenderers";
+import type { OutputMetadata } from "../../../../../../../../components/contextual/OutputRenderers";
 import {
   globalRegistry,
   OutputActions,
   OutputItem,
-} from "../../NewAgentLibraryView/components/selected-views/OutputRenderers";
+} from "../../../../../../../../components/contextual/OutputRenderers";
 
 export function AgentRunOutputView({
   agentRunOutputs,
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/OldAgentLibraryView/components/agent-runs-selector-list.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/OldAgentLibraryView/components/agent-runs-selector-list.tsx
index 5931404846..49d93b4319 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/OldAgentLibraryView/components/agent-runs-selector-list.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/OldAgentLibraryView/components/agent-runs-selector-list.tsx
@@ -184,9 +184,11 @@ export function AgentRunsSelectorList({
                     ))}
                   {agentPresets.length > 0 && <Separator className="my-1" />}
                   {agentRuns
-                    .toSorted(
-                      (a, b) => b.started_at.getTime() - a.started_at.getTime(),
-                    )
+                    .toSorted((a, b) => {
+                      const aTime = a.started_at?.getTime() ?? 0;
+                      const bTime = b.started_at?.getTime() ?? 0;
+                      return bTime - aTime;
+                    })
                     .map((run) => (
                       <AgentRunSummaryCard
                         className={listItemClasses}
@@ -199,7 +201,7 @@ export function AgentRunsSelectorList({
                                 ?.name
                             : null) ?? agent.name
                         }
-                        timestamp={run.started_at}
+                        timestamp={run.started_at ?? undefined}
                         selected={selectedView.id === run.id}
                         onClick={() => onSelectRun(run.id)}
                         onDelete={() => doDeleteRun(run as GraphExecutionMeta)}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/page.tsx b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/page.tsx
index 9ada590dd8..147c0aef45 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/page.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/page.tsx
@@ -1,14 +1,7 @@
 "use client";
 
-import { Flag, useGetFlag } from "@/services/feature-flags/use-get-flag";
 import { NewAgentLibraryView } from "./components/NewAgentLibraryView/NewAgentLibraryView";
-import { OldAgentLibraryView } from "./components/OldAgentLibraryView/OldAgentLibraryView";
 
 export default function AgentLibraryPage() {
-  const isNewLibraryPageEnabled = useGetFlag(Flag.NEW_AGENT_RUNS);
-  return isNewLibraryPageEnabled ? (
-    <NewAgentLibraryView />
-  ) : (
-    <OldAgentLibraryView />
-  );
+  return <NewAgentLibraryView />;
 }
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/FavoritesSection/FavoritesSection.tsx b/autogpt_platform/frontend/src/app/(platform)/library/components/FavoritesSection/FavoritesSection.tsx
index 7ed372f296..d1167cc747 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/components/FavoritesSection/FavoritesSection.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/FavoritesSection/FavoritesSection.tsx
@@ -1,16 +1,17 @@
 "use client";
 
-import React from "react";
-import { useFavoriteAgents } from "../../hooks/useFavoriteAgents";
-import LibraryAgentCard from "../LibraryAgentCard/LibraryAgentCard";
-import { useGetFlag, Flag } from "@/services/feature-flags/use-get-flag";
-import { Heart } from "lucide-react";
-import { Skeleton } from "@/components/__legacy__/ui/skeleton";
-import { InfiniteScroll } from "@/components/contextual/InfiniteScroll/InfiniteScroll";
 import { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
+import { Text } from "@/components/atoms/Text/Text";
+import { InfiniteScroll } from "@/components/contextual/InfiniteScroll/InfiniteScroll";
+import { HeartIcon } from "@phosphor-icons/react";
+import { useFavoriteAgents } from "../../hooks/useFavoriteAgents";
+import { LibraryAgentCard } from "../LibraryAgentCard/LibraryAgentCard";
 
-export default function FavoritesSection() {
-  const isAgentFavoritingEnabled = useGetFlag(Flag.AGENT_FAVORITING);
+interface Props {
+  searchTerm: string;
+}
+
+export function FavoritesSection({ searchTerm }: Props) {
   const {
     allAgents: favoriteAgents,
     agentLoading: isLoading,
@@ -18,60 +19,50 @@ export default function FavoritesSection() {
     hasNextPage,
     fetchNextPage,
     isFetchingNextPage,
-  } = useFavoriteAgents();
+  } = useFavoriteAgents({ searchTerm });
 
-  // Only show this section if the feature flag is enabled
-  if (!isAgentFavoritingEnabled) {
-    return null;
-  }
-
-  // Don't show the section if there are no favorites
-  if (!isLoading && favoriteAgents.length === 0) {
+  if (isLoading || favoriteAgents.length === 0) {
     return null;
   }
 
   return (
-    <div className="mb-8">
-      <div className="flex items-center gap-[10px] p-2 pb-[10px]">
-        <Heart className="h-5 w-5 fill-red-500 text-red-500" />
-        <span className="font-poppin text-[18px] font-semibold leading-[28px] text-neutral-800">
-          Favorites
-        </span>
-        {!isLoading && (
-          <span className="font-sans text-[14px] font-normal leading-6">
-            {agentCount} {agentCount === 1 ? "agent" : "agents"}
-          </span>
-        )}
+    <div className="!mb-8">
+      <div className="mb-3 flex items-center gap-2 p-2">
+        <HeartIcon className="h-5 w-5" weight="fill" />
+        <div className="flex items-baseline gap-2">
+          <Text variant="h4">Favorites</Text>
+          {!isLoading && (
+            <Text
+              variant="body"
+              data-testid="agents-count"
+              className="relative bottom-px text-zinc-500"
+            >
+              {agentCount}
+            </Text>
+          )}
+        </div>
       </div>
 
       <div className="relative">
-        {isLoading ? (
+        <InfiniteScroll
+          isFetchingNextPage={isFetchingNextPage}
+          fetchNextPage={fetchNextPage}
+          hasNextPage={hasNextPage}
+          loader={
+            <div className="flex h-8 w-full items-center justify-center">
+              <div className="h-6 w-6 animate-spin rounded-full border-b-2 border-t-2 border-neutral-800" />
+            </div>
+          }
+        >
           <div className="grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4">
-            {[...Array(4)].map((_, i) => (
-              <Skeleton key={i} className="h-48 w-full rounded-lg" />
+            {favoriteAgents.map((agent: LibraryAgent) => (
+              <LibraryAgentCard key={agent.id} agent={agent} />
             ))}
           </div>
-        ) : (
-          <InfiniteScroll
-            isFetchingNextPage={isFetchingNextPage}
-            fetchNextPage={fetchNextPage}
-            hasNextPage={hasNextPage}
-            loader={
-              <div className="flex h-8 w-full items-center justify-center">
-                <div className="h-6 w-6 animate-spin rounded-full border-b-2 border-t-2 border-neutral-800" />
-              </div>
-            }
-          >
-            <div className="grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4">
-              {favoriteAgents.map((agent: LibraryAgent) => (
-                <LibraryAgentCard key={agent.id} agent={agent} />
-              ))}
-            </div>
-          </InfiniteScroll>
-        )}
+        </InfiniteScroll>
       </div>
 
-      {favoriteAgents.length > 0 && <div className="mt-6 border-t pt-6" />}
+      {favoriteAgents.length > 0 && <div className="!mt-10 border-t" />}
     </div>
   );
 }
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryActionHeader/LibraryActionHeader.tsx b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryActionHeader/LibraryActionHeader.tsx
index 11011945fb..139f753563 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryActionHeader/LibraryActionHeader.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryActionHeader/LibraryActionHeader.tsx
@@ -1,34 +1,28 @@
-// import LibraryNotificationDropdown from "./library-notification-dropdown";
+import { LibrarySearchBar } from "../LibrarySearchBar/LibrarySearchBar";
 import LibraryUploadAgentDialog from "../LibraryUploadAgentDialog/LibraryUploadAgentDialog";
-import LibrarySearchBar from "../LibrarySearchBar/LibrarySearchBar";
 
-type LibraryActionHeaderProps = Record<string, never>;
+interface Props {
+  setSearchTerm: (value: string) => void;
+}
 
-/**
- * LibraryActionHeader component - Renders a header with search, notifications and filters
- */
-const LibraryActionHeader: React.FC<LibraryActionHeaderProps> = ({}) => {
+export function LibraryActionHeader({ setSearchTerm }: Props) {
   return (
     <>
-      <div className="mb-[32px] hidden items-start justify-between md:flex">
-        {/* <LibraryNotificationDropdown /> */}
-        <LibrarySearchBar />
+      <div className="mb-[32px] hidden items-center justify-center gap-4 md:flex">
+        <LibrarySearchBar setSearchTerm={setSearchTerm} />
         <LibraryUploadAgentDialog />
       </div>
 
       {/* Mobile and tablet */}
       <div className="flex flex-col gap-4 p-4 pt-[52px] md:hidden">
         <div className="flex w-full justify-between">
-          {/* <LibraryNotificationDropdown /> */}
           <LibraryUploadAgentDialog />
         </div>
 
         <div className="flex items-center justify-center">
-          <LibrarySearchBar />
+          <LibrarySearchBar setSearchTerm={setSearchTerm} />
         </div>
       </div>
     </>
   );
-};
-
-export default LibraryActionHeader;
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryActionSubHeader/LibraryActionSubHeader.tsx b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryActionSubHeader/LibraryActionSubHeader.tsx
index be1ebe1aef..edefa52911 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryActionSubHeader/LibraryActionSubHeader.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryActionSubHeader/LibraryActionSubHeader.tsx
@@ -1,28 +1,28 @@
 "use client";
 
-import LibrarySortMenu from "../LibrarySortMenu/LibrarySortMenu";
+import { LibraryAgentSort } from "@/app/api/__generated__/models/libraryAgentSort";
+import { Text } from "@/components/atoms/Text/Text";
+import { LibrarySortMenu } from "../LibrarySortMenu/LibrarySortMenu";
 
-interface LibraryActionSubHeaderProps {
+interface Props {
   agentCount: number;
+  setLibrarySort: (value: LibraryAgentSort) => void;
 }
 
-export default function LibraryActionSubHeader({
-  agentCount,
-}: LibraryActionSubHeaderProps) {
+export function LibraryActionSubHeader({ agentCount, setLibrarySort }: Props) {
   return (
-    <div className="flex items-center justify-between pb-[10px]">
-      <div className="flex items-center gap-[10px] p-2">
-        <span className="font-poppin w-[96px] text-[18px] font-semibold leading-[28px] text-neutral-800">
-          My agents
-        </span>
-        <span
-          className="w-[70px] font-sans text-[14px] font-normal leading-6"
+    <div className="flex items-baseline justify-between">
+      <div className="flex items-baseline gap-4">
+        <Text variant="h4">My agents</Text>
+        <Text
+          variant="body"
           data-testid="agents-count"
+          className="text-zinc-500"
         >
-          {agentCount} agents
-        </span>
+          {agentCount}
+        </Text>
       </div>
-      <LibrarySortMenu />
+      <LibrarySortMenu setLibrarySort={setLibrarySort} />
     </div>
   );
 }
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/LibraryAgentCard.tsx b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/LibraryAgentCard.tsx
index ef2662f735..1327de5347 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/LibraryAgentCard.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/LibraryAgentCard.tsx
@@ -1,332 +1,126 @@
 "use client";
 
-import Link from "next/link";
+import { Text } from "@/components/atoms/Text/Text";
+import { CaretCircleRightIcon } from "@phosphor-icons/react";
 import Image from "next/image";
-import { Heart } from "@phosphor-icons/react";
-import { useState, useEffect } from "react";
-import { getQueryClient } from "@/lib/react-query/queryClient";
-import { InfiniteData } from "@tanstack/react-query";
+import NextLink from "next/link";
 
 import { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
-import {
-  getV2ListLibraryAgentsResponse,
-  getV2ListFavoriteLibraryAgentsResponse,
-} from "@/app/api/__generated__/endpoints/library/library";
-import BackendAPI, { LibraryAgentID } from "@/lib/autogpt-server-api";
-import { cn } from "@/lib/utils";
-import { useToast } from "@/components/molecules/Toast/use-toast";
-import { Flag, useGetFlag } from "@/services/feature-flags/use-get-flag";
 import Avatar, {
   AvatarFallback,
   AvatarImage,
 } from "@/components/atoms/Avatar/Avatar";
+import { Link } from "@/components/atoms/Link/Link";
+import { AgentCardMenu } from "./components/AgentCardMenu";
+import { FavoriteButton } from "./components/FavoriteButton";
+import { useLibraryAgentCard } from "./useLibraryAgentCard";
 
-interface LibraryAgentCardProps {
+interface Props {
   agent: LibraryAgent;
 }
 
-export default function LibraryAgentCard({
-  agent: {
-    id,
-    name,
-    description,
-    graph_id,
-    can_access_graph,
+export function LibraryAgentCard({ agent }: Props) {
+  const { id, name, graph_id, can_access_graph, image_url } = agent;
+
+  const {
+    isFromMarketplace,
+    isFavorite,
+    profile,
     creator_image_url,
-    image_url,
-    is_favorite,
-  },
-}: LibraryAgentCardProps) {
-  const isAgentFavoritingEnabled = useGetFlag(Flag.AGENT_FAVORITING);
-  const [isFavorite, setIsFavorite] = useState(is_favorite);
-  const [isUpdating, setIsUpdating] = useState(false);
-  const { toast } = useToast();
-  const api = new BackendAPI();
-  const queryClient = getQueryClient();
-
-  // Sync local state with prop when it changes (e.g., after query invalidation)
-  useEffect(() => {
-    setIsFavorite(is_favorite);
-  }, [is_favorite]);
-
-  const updateQueryData = (newIsFavorite: boolean) => {
-    // Update the agent in all library agent queries
-    queryClient.setQueriesData(
-      { queryKey: ["/api/library/agents"] },
-      (
-        oldData:
-          | InfiniteData<getV2ListLibraryAgentsResponse, number | undefined>
-          | undefined,
-      ) => {
-        if (!oldData?.pages) return oldData;
-
-        return {
-          ...oldData,
-          pages: oldData.pages.map((page) => {
-            if (page.status !== 200) return page;
-
-            return {
-              ...page,
-              data: {
-                ...page.data,
-                agents: page.data.agents.map((agent: LibraryAgent) =>
-                  agent.id === id
-                    ? { ...agent, is_favorite: newIsFavorite }
-                    : agent,
-                ),
-              },
-            };
-          }),
-        };
-      },
-    );
-
-    // Update or remove from favorites query based on new state
-    queryClient.setQueriesData(
-      { queryKey: ["/api/library/agents/favorites"] },
-      (
-        oldData:
-          | InfiniteData<
-              getV2ListFavoriteLibraryAgentsResponse,
-              number | undefined
-            >
-          | undefined,
-      ) => {
-        if (!oldData?.pages) return oldData;
-
-        if (newIsFavorite) {
-          // Add to favorites if not already there
-          const exists = oldData.pages.some(
-            (page) =>
-              page.status === 200 &&
-              page.data.agents.some((agent: LibraryAgent) => agent.id === id),
-          );
-
-          if (!exists) {
-            const firstPage = oldData.pages[0];
-            if (firstPage?.status === 200) {
-              const updatedAgent = {
-                id,
-                name,
-                description,
-                graph_id,
-                can_access_graph,
-                creator_image_url,
-                image_url,
-                is_favorite: true,
-              };
-
-              return {
-                ...oldData,
-                pages: [
-                  {
-                    ...firstPage,
-                    data: {
-                      ...firstPage.data,
-                      agents: [updatedAgent, ...firstPage.data.agents],
-                      pagination: {
-                        ...firstPage.data.pagination,
-                        total_items: firstPage.data.pagination.total_items + 1,
-                      },
-                    },
-                  },
-                  ...oldData.pages.slice(1).map((page) =>
-                    page.status === 200
-                      ? {
-                          ...page,
-                          data: {
-                            ...page.data,
-                            pagination: {
-                              ...page.data.pagination,
-                              total_items: page.data.pagination.total_items + 1,
-                            },
-                          },
-                        }
-                      : page,
-                  ),
-                ],
-              };
-            }
-          }
-        } else {
-          // Remove from favorites
-          let removedCount = 0;
-          return {
-            ...oldData,
-            pages: oldData.pages.map((page) => {
-              if (page.status !== 200) return page;
-
-              const filteredAgents = page.data.agents.filter(
-                (agent: LibraryAgent) => agent.id !== id,
-              );
-
-              if (filteredAgents.length < page.data.agents.length) {
-                removedCount = 1;
-              }
-
-              return {
-                ...page,
-                data: {
-                  ...page.data,
-                  agents: filteredAgents,
-                  pagination: {
-                    ...page.data.pagination,
-                    total_items:
-                      page.data.pagination.total_items - removedCount,
-                  },
-                },
-              };
-            }),
-          };
-        }
-
-        return oldData;
-      },
-    );
-  };
-
-  const handleToggleFavorite = async (e: React.MouseEvent) => {
-    e.preventDefault(); // Prevent navigation when clicking the heart
-    e.stopPropagation();
-
-    if (isUpdating || !isAgentFavoritingEnabled) return;
-
-    const newIsFavorite = !isFavorite;
-
-    // Optimistic update
-    setIsFavorite(newIsFavorite);
-    updateQueryData(newIsFavorite);
-
-    setIsUpdating(true);
-    try {
-      await api.updateLibraryAgent(id as LibraryAgentID, {
-        is_favorite: newIsFavorite,
-      });
-
-      toast({
-        title: newIsFavorite ? "Added to favorites" : "Removed from favorites",
-        description: `${name} has been ${newIsFavorite ? "added to" : "removed from"} your favorites.`,
-      });
-    } catch (error) {
-      // Revert on error
-      console.error("Failed to update favorite status:", error);
-      setIsFavorite(!newIsFavorite);
-      updateQueryData(!newIsFavorite);
-
-      toast({
-        title: "Error",
-        description: "Failed to update favorite status. Please try again.",
-        variant: "destructive",
-      });
-    } finally {
-      setIsUpdating(false);
-    }
-  };
+    handleToggleFavorite,
+  } = useLibraryAgentCard({ agent });
 
   return (
     <div
       data-testid="library-agent-card"
       data-agent-id={id}
-      className="group inline-flex w-full max-w-[434px] flex-col items-start justify-start gap-2.5 rounded-[26px] bg-white transition-all duration-300 hover:shadow-lg dark:bg-transparent dark:hover:shadow-gray-700"
+      className="group relative inline-flex h-[10.625rem] w-full max-w-[25rem] flex-col items-start justify-start gap-2.5 rounded-medium border border-zinc-100 bg-white transition-all duration-300 hover:shadow-md"
     >
-      <Link
-        href={`/library/agents/${id}`}
-        className="relative h-[200px] w-full overflow-hidden rounded-[20px]"
-      >
-        {!image_url ? (
-          <div
-            className={`h-full w-full ${
-              [
-                "bg-gradient-to-r from-green-200 to-blue-200",
-                "bg-gradient-to-r from-pink-200 to-purple-200",
-                "bg-gradient-to-r from-yellow-200 to-orange-200",
-                "bg-gradient-to-r from-blue-200 to-cyan-200",
-                "bg-gradient-to-r from-indigo-200 to-purple-200",
-              ][parseInt(id.slice(0, 8), 16) % 5]
-            }`}
-            style={{
-              backgroundSize: "200% 200%",
-              animation: "gradient 15s ease infinite",
-            }}
-          />
-        ) : (
-          <Image
-            src={image_url}
-            alt={`${name} preview image`}
-            fill
-            className="object-cover"
-          />
-        )}
-        {isAgentFavoritingEnabled && (
-          <button
-            onClick={handleToggleFavorite}
-            className={cn(
-              "absolute right-4 top-4 rounded-full bg-white/90 p-2 backdrop-blur-sm transition-all duration-200",
-              "hover:scale-110 hover:bg-white",
-              "focus:outline-none focus:ring-2 focus:ring-red-500 focus:ring-offset-2",
-              isUpdating && "cursor-not-allowed opacity-50",
-              !isFavorite && "opacity-0 group-hover:opacity-100",
-            )}
-            disabled={isUpdating}
-            aria-label={
-              isFavorite ? "Remove from favorites" : "Add to favorites"
-            }
-          >
-            <Heart
-              size={20}
-              weight={isFavorite ? "fill" : "regular"}
-              className={cn(
-                "transition-colors duration-200",
-                isFavorite
-                  ? "text-red-500"
-                  : "text-gray-600 hover:text-red-500",
-              )}
-            />
-          </button>
-        )}
-        <div className="absolute bottom-4 left-4">
-          <Avatar className="h-16 w-16">
+      <NextLink href={`/library/agents/${id}`} className="flex-shrink-0">
+        <div className="relative flex items-center gap-2 px-4 pt-3">
+          <Avatar className="h-4 w-4 rounded-full">
             <AvatarImage
               src={
-                creator_image_url
-                  ? creator_image_url
-                  : "/avatar-placeholder.png"
+                isFromMarketplace
+                  ? creator_image_url || "/avatar-placeholder.png"
+                  : profile?.avatar_url || "/avatar-placeholder.png"
               }
               alt={`${name} creator avatar`}
             />
-            <AvatarFallback size={64}>{name.charAt(0)}</AvatarFallback>
+            <AvatarFallback size={48}>{name.charAt(0)}</AvatarFallback>
           </Avatar>
+          <Text
+            variant="small-medium"
+            className="uppercase tracking-wide text-zinc-400"
+          >
+            {isFromMarketplace ? "FROM MARKETPLACE" : "Built by you"}
+          </Text>
         </div>
-      </Link>
+      </NextLink>
+      <FavoriteButton
+        isFavorite={isFavorite}
+        onClick={handleToggleFavorite}
+        className="absolute right-10 top-0"
+      />
+      <AgentCardMenu agent={agent} />
 
-      <div className="flex w-full flex-1 flex-col px-4 py-4">
-        <Link href={`/library/agents/${id}`}>
-          <h3 className="mb-2 line-clamp-2 font-poppins text-2xl font-semibold leading-tight text-[#272727] dark:text-neutral-100">
+      <div className="flex w-full flex-1 flex-col px-4 pb-2">
+        <Link
+          href={`/library/agents/${id}`}
+          className="flex w-full items-start justify-between gap-2 no-underline hover:no-underline"
+        >
+          <Text
+            variant="h5"
+            data-testid="library-agent-card-name"
+            className="line-clamp-3 hyphens-auto break-words no-underline hover:no-underline"
+          >
             {name}
-          </h3>
+          </Text>
 
-          <p className="line-clamp-3 flex-1 text-sm text-gray-600 dark:text-gray-400">
-            {description}
-          </p>
+          {!image_url ? (
+            <div
+              className={`h-[3.64rem] w-[6.70rem] flex-shrink-0 rounded-small ${
+                [
+                  "bg-gradient-to-r from-green-200 to-blue-200",
+                  "bg-gradient-to-r from-pink-200 to-purple-200",
+                  "bg-gradient-to-r from-yellow-200 to-orange-200",
+                  "bg-gradient-to-r from-blue-200 to-cyan-200",
+                  "bg-gradient-to-r from-indigo-200 to-purple-200",
+                ][parseInt(id.slice(0, 8), 16) % 5]
+              }`}
+              style={{
+                backgroundSize: "200% 200%",
+                animation: "gradient 15s ease infinite",
+              }}
+            />
+          ) : (
+            <Image
+              src={image_url}
+              alt={`${name} preview image`}
+              width={107}
+              height={58}
+              className="flex-shrink-0 rounded-small object-cover"
+            />
+          )}
         </Link>
 
-        <div className="flex-grow" />
-        {/* Spacer */}
-
-        <div className="items-between mt-4 flex w-full justify-between gap-3">
+        <div className="mt-auto flex w-full justify-start gap-6 border-t border-zinc-100 pb-1 pt-3">
           <Link
             href={`/library/agents/${id}`}
-            className="text-lg font-semibold text-neutral-800 hover:underline dark:text-neutral-200"
+            data-testid="library-agent-card-see-runs-link"
+            className="flex items-center gap-1 text-[13px]"
           >
-            See runs
+            See runs <CaretCircleRightIcon size={20} />
           </Link>
 
           {can_access_graph && (
             <Link
               href={`/build?flowID=${graph_id}`}
-              className="text-lg font-semibold text-neutral-800 hover:underline dark:text-neutral-200"
+              data-testid="library-agent-card-open-in-builder-link"
+              className="flex items-center gap-1 text-[13px]"
+              isExternal
             >
-              Open in builder
+              Open in builder <CaretCircleRightIcon size={20} />
             </Link>
           )}
         </div>
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/components/AgentCardMenu.tsx b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/components/AgentCardMenu.tsx
new file mode 100644
index 0000000000..933cdd34fa
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/components/AgentCardMenu.tsx
@@ -0,0 +1,188 @@
+"use client";
+
+import {
+  getGetV2ListLibraryAgentsQueryKey,
+  useDeleteV2DeleteLibraryAgent,
+  usePostV2ForkLibraryAgent,
+} from "@/app/api/__generated__/endpoints/library/library";
+import { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
+import { Button } from "@/components/atoms/Button/Button";
+import { Text } from "@/components/atoms/Text/Text";
+import { Dialog } from "@/components/molecules/Dialog/Dialog";
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuSeparator,
+  DropdownMenuTrigger,
+} from "@/components/molecules/DropdownMenu/DropdownMenu";
+import { useToast } from "@/components/molecules/Toast/use-toast";
+import { DotsThree } from "@phosphor-icons/react";
+import { useQueryClient } from "@tanstack/react-query";
+import Link from "next/link";
+import { useRouter } from "next/navigation";
+import { useState } from "react";
+
+interface AgentCardMenuProps {
+  agent: LibraryAgent;
+}
+
+export function AgentCardMenu({ agent }: AgentCardMenuProps) {
+  const { toast } = useToast();
+  const queryClient = useQueryClient();
+  const router = useRouter();
+  const [showDeleteDialog, setShowDeleteDialog] = useState(false);
+  const [isDeletingAgent, setIsDeletingAgent] = useState(false);
+  const [isDuplicatingAgent, setIsDuplicatingAgent] = useState(false);
+
+  const { mutateAsync: deleteAgent } = useDeleteV2DeleteLibraryAgent();
+  const { mutateAsync: forkAgent } = usePostV2ForkLibraryAgent();
+
+  async function handleDuplicateAgent() {
+    if (!agent.id) return;
+
+    setIsDuplicatingAgent(true);
+
+    try {
+      const result = await forkAgent({ libraryAgentId: agent.id });
+
+      if (result.status === 200) {
+        await queryClient.refetchQueries({
+          queryKey: getGetV2ListLibraryAgentsQueryKey(),
+        });
+
+        toast({
+          title: "Agent duplicated",
+          description: `${result.data.name} has been created.`,
+        });
+      }
+    } catch (error: unknown) {
+      toast({
+        title: "Failed to duplicate agent",
+        description:
+          error instanceof Error
+            ? error.message
+            : "An unexpected error occurred.",
+        variant: "destructive",
+      });
+    } finally {
+      setIsDuplicatingAgent(false);
+    }
+  }
+
+  async function handleDeleteAgent() {
+    if (!agent.id) return;
+
+    setIsDeletingAgent(true);
+
+    try {
+      await deleteAgent({ libraryAgentId: agent.id });
+
+      await queryClient.refetchQueries({
+        queryKey: getGetV2ListLibraryAgentsQueryKey(),
+      });
+
+      toast({ title: "Agent deleted" });
+      setShowDeleteDialog(false);
+      router.push("/library");
+    } catch (error: unknown) {
+      toast({
+        title: "Failed to delete agent",
+        description:
+          error instanceof Error
+            ? error.message
+            : "An unexpected error occurred.",
+        variant: "destructive",
+      });
+    } finally {
+      setIsDeletingAgent(false);
+    }
+  }
+
+  return (
+    <>
+      <DropdownMenu>
+        <DropdownMenuTrigger asChild>
+          <button
+            className="absolute right-2 top-1 rounded p-1.5 transition-opacity hover:bg-neutral-100"
+            onClick={(e) => e.stopPropagation()}
+            aria-label="More actions"
+          >
+            <DotsThree className="h-5 w-5 text-neutral-600" />
+          </button>
+        </DropdownMenuTrigger>
+        <DropdownMenuContent align="end">
+          {agent.can_access_graph && (
+            <>
+              <DropdownMenuItem asChild>
+                <Link
+                  href={`/build?flowID=${agent.graph_id}&flowVersion=${agent.graph_version}`}
+                  target="_blank"
+                  className="flex items-center gap-2"
+                  onClick={(e) => e.stopPropagation()}
+                >
+                  Edit agent
+                </Link>
+              </DropdownMenuItem>
+              <DropdownMenuSeparator />
+            </>
+          )}
+          <DropdownMenuItem
+            onClick={(e) => {
+              e.stopPropagation();
+              handleDuplicateAgent();
+            }}
+            disabled={isDuplicatingAgent}
+            className="flex items-center gap-2"
+          >
+            Duplicate agent
+          </DropdownMenuItem>
+          <DropdownMenuSeparator />
+          <DropdownMenuItem
+            onClick={(e) => {
+              e.stopPropagation();
+              setShowDeleteDialog(true);
+            }}
+            className="flex items-center gap-2 text-red-600 focus:bg-red-50 focus:text-red-600"
+          >
+            Delete agent
+          </DropdownMenuItem>
+        </DropdownMenuContent>
+      </DropdownMenu>
+
+      <Dialog
+        controlled={{
+          isOpen: showDeleteDialog,
+          set: setShowDeleteDialog,
+        }}
+        styling={{ maxWidth: "32rem" }}
+        title="Delete agent"
+      >
+        <Dialog.Content>
+          <div>
+            <Text variant="large">
+              Are you sure you want to delete this agent? This action cannot be
+              undone.
+            </Text>
+            <Dialog.Footer>
+              <Button
+                variant="secondary"
+                disabled={isDeletingAgent}
+                onClick={() => setShowDeleteDialog(false)}
+              >
+                Cancel
+              </Button>
+              <Button
+                variant="destructive"
+                onClick={handleDeleteAgent}
+                loading={isDeletingAgent}
+              >
+                Delete Agent
+              </Button>
+            </Dialog.Footer>
+          </div>
+        </Dialog.Content>
+      </Dialog>
+    </>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/components/FavoriteButton.tsx b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/components/FavoriteButton.tsx
new file mode 100644
index 0000000000..df11553ec1
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/components/FavoriteButton.tsx
@@ -0,0 +1,39 @@
+"use client";
+
+import { cn } from "@/lib/utils";
+import { HeartIcon } from "@phosphor-icons/react";
+import type { MouseEvent } from "react";
+
+interface FavoriteButtonProps {
+  isFavorite: boolean;
+  onClick: (e: MouseEvent<HTMLButtonElement>) => void;
+  className?: string;
+}
+
+export function FavoriteButton({
+  isFavorite,
+  onClick,
+  className,
+}: FavoriteButtonProps) {
+  return (
+    <button
+      onClick={onClick}
+      className={cn(
+        "rounded-full p-2 transition-all duration-200",
+        "hover:scale-110",
+        !isFavorite && "opacity-0 group-hover:opacity-100",
+        className,
+      )}
+      aria-label={isFavorite ? "Remove from favorites" : "Add to favorites"}
+    >
+      <HeartIcon
+        size={20}
+        weight={isFavorite ? "fill" : "regular"}
+        className={cn(
+          "transition-colors duration-200",
+          isFavorite ? "text-red-500" : "text-gray-600 hover:text-red-500",
+        )}
+      />
+    </button>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/helpers.ts b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/helpers.ts
new file mode 100644
index 0000000000..40449e2344
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/helpers.ts
@@ -0,0 +1,150 @@
+import { InfiniteData, QueryClient } from "@tanstack/react-query";
+
+import {
+  getV2ListFavoriteLibraryAgentsResponse,
+  getV2ListLibraryAgentsResponse,
+} from "@/app/api/__generated__/endpoints/library/library";
+import { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
+
+interface UpdateFavoriteInQueriesParams {
+  queryClient: QueryClient;
+  agentId: string;
+  agent: LibraryAgent;
+  newIsFavorite: boolean;
+}
+
+export function updateFavoriteInQueries({
+  queryClient,
+  agentId,
+  agent,
+  newIsFavorite,
+}: UpdateFavoriteInQueriesParams) {
+  queryClient.setQueriesData(
+    { queryKey: ["/api/library/agents"] },
+    (
+      oldData:
+        | InfiniteData<getV2ListLibraryAgentsResponse, number | undefined>
+        | undefined,
+    ) => {
+      if (!oldData?.pages) return oldData;
+
+      return {
+        ...oldData,
+        pages: oldData.pages.map((page) => {
+          if (page.status !== 200) return page;
+
+          return {
+            ...page,
+            data: {
+              ...page.data,
+              agents: page.data.agents.map((currentAgent: LibraryAgent) =>
+                currentAgent.id === agentId
+                  ? { ...currentAgent, is_favorite: newIsFavorite }
+                  : currentAgent,
+              ),
+            },
+          };
+        }),
+      };
+    },
+  );
+
+  queryClient.setQueriesData(
+    { queryKey: ["/api/library/agents/favorites"] },
+    (
+      oldData:
+        | InfiniteData<
+            getV2ListFavoriteLibraryAgentsResponse,
+            number | undefined
+          >
+        | undefined,
+    ) => {
+      if (!oldData?.pages) return oldData;
+
+      if (newIsFavorite) {
+        const exists = oldData.pages.some(
+          (page) =>
+            page.status === 200 &&
+            page.data.agents.some(
+              (currentAgent: LibraryAgent) => currentAgent.id === agentId,
+            ),
+        );
+
+        if (!exists) {
+          const firstPage = oldData.pages[0];
+          if (firstPage?.status === 200) {
+            const updatedAgent = {
+              id: agent.id,
+              name: agent.name,
+              description: agent.description,
+              graph_id: agent.graph_id,
+              can_access_graph: agent.can_access_graph,
+              creator_image_url: agent.creator_image_url,
+              image_url: agent.image_url,
+              is_favorite: true,
+            };
+
+            return {
+              ...oldData,
+              pages: [
+                {
+                  ...firstPage,
+                  data: {
+                    ...firstPage.data,
+                    agents: [updatedAgent, ...firstPage.data.agents],
+                    pagination: {
+                      ...firstPage.data.pagination,
+                      total_items: firstPage.data.pagination.total_items + 1,
+                    },
+                  },
+                },
+                ...oldData.pages.slice(1).map((page) =>
+                  page.status === 200
+                    ? {
+                        ...page,
+                        data: {
+                          ...page.data,
+                          pagination: {
+                            ...page.data.pagination,
+                            total_items: page.data.pagination.total_items + 1,
+                          },
+                        },
+                      }
+                    : page,
+                ),
+              ],
+            };
+          }
+        }
+      } else {
+        return {
+          ...oldData,
+          pages: oldData.pages.map((page) => {
+            if (page.status !== 200) return page;
+
+            const filteredAgents = page.data.agents.filter(
+              (currentAgent: LibraryAgent) => currentAgent.id !== agentId,
+            );
+
+            const removedCount =
+              filteredAgents.length < page.data.agents.length ? 1 : 0;
+
+            return {
+              ...page,
+              data: {
+                ...page.data,
+                agents: filteredAgents,
+                pagination: {
+                  ...page.data.pagination,
+                  total_items: page.data.pagination.total_items - removedCount,
+                },
+              },
+            };
+          }),
+        };
+      }
+
+      return oldData;
+    },
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/useLibraryAgentCard.ts b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/useLibraryAgentCard.ts
new file mode 100644
index 0000000000..4232847226
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/useLibraryAgentCard.ts
@@ -0,0 +1,84 @@
+"use client";
+
+import { getQueryClient } from "@/lib/react-query/queryClient";
+import { useEffect, useState } from "react";
+
+import { usePatchV2UpdateLibraryAgent } from "@/app/api/__generated__/endpoints/library/library";
+import { useGetV2GetUserProfile } from "@/app/api/__generated__/endpoints/store/store";
+import { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
+import { okData } from "@/app/api/helpers";
+import { useToast } from "@/components/molecules/Toast/use-toast";
+import { updateFavoriteInQueries } from "./helpers";
+
+interface Props {
+  agent: LibraryAgent;
+}
+
+export function useLibraryAgentCard({ agent }: Props) {
+  const { id, name, is_favorite, creator_image_url, marketplace_listing } =
+    agent;
+
+  const isFromMarketplace = Boolean(marketplace_listing);
+  const [isFavorite, setIsFavorite] = useState(is_favorite);
+  const { toast } = useToast();
+  const queryClient = getQueryClient();
+  const { mutateAsync: updateLibraryAgent } = usePatchV2UpdateLibraryAgent();
+
+  const { data: profile } = useGetV2GetUserProfile({
+    query: {
+      select: okData,
+    },
+  });
+
+  useEffect(() => {
+    setIsFavorite(is_favorite);
+  }, [is_favorite]);
+
+  function updateQueryData(newIsFavorite: boolean) {
+    updateFavoriteInQueries({
+      queryClient,
+      agentId: id,
+      agent,
+      newIsFavorite,
+    });
+  }
+
+  async function handleToggleFavorite(e: React.MouseEvent) {
+    e.preventDefault();
+    e.stopPropagation();
+
+    const newIsFavorite = !isFavorite;
+
+    setIsFavorite(newIsFavorite);
+    updateQueryData(newIsFavorite);
+
+    try {
+      await updateLibraryAgent({
+        libraryAgentId: id,
+        data: { is_favorite: newIsFavorite },
+      });
+
+      toast({
+        title: newIsFavorite ? "Added to favorites" : "Removed from favorites",
+        description: `${name} has been ${newIsFavorite ? "added to" : "removed from"} your favorites.`,
+      });
+    } catch {
+      setIsFavorite(!newIsFavorite);
+      updateQueryData(!newIsFavorite);
+
+      toast({
+        title: "Error",
+        description: "Failed to update favorite status. Please try again.",
+        variant: "destructive",
+      });
+    }
+  }
+
+  return {
+    isFromMarketplace,
+    isFavorite,
+    profile,
+    creator_image_url,
+    handleToggleFavorite,
+  };
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentList/LibraryAgentList.tsx b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentList/LibraryAgentList.tsx
index 1b3926a6e1..074cd8ae26 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentList/LibraryAgentList.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentList/LibraryAgentList.tsx
@@ -1,10 +1,22 @@
 "use client";
-import LibraryActionSubHeader from "../LibraryActionSubHeader/LibraryActionSubHeader";
-import LibraryAgentCard from "../LibraryAgentCard/LibraryAgentCard";
+import { LibraryAgentSort } from "@/app/api/__generated__/models/libraryAgentSort";
+import { LoadingSpinner } from "@/components/atoms/LoadingSpinner/LoadingSpinner";
 import { InfiniteScroll } from "@/components/contextual/InfiniteScroll/InfiniteScroll";
+import { LibraryActionSubHeader } from "../LibraryActionSubHeader/LibraryActionSubHeader";
+import { LibraryAgentCard } from "../LibraryAgentCard/LibraryAgentCard";
 import { useLibraryAgentList } from "./useLibraryAgentList";
 
-export default function LibraryAgentList() {
+interface Props {
+  searchTerm: string;
+  librarySort: LibraryAgentSort;
+  setLibrarySort: (value: LibraryAgentSort) => void;
+}
+
+export function LibraryAgentList({
+  searchTerm,
+  librarySort,
+  setLibrarySort,
+}: Props) {
   const {
     agentLoading,
     agentCount,
@@ -12,28 +24,27 @@ export default function LibraryAgentList() {
     hasNextPage,
     isFetchingNextPage,
     fetchNextPage,
-  } = useLibraryAgentList();
-
-  const LoadingSpinner = () => (
-    <div className="h-8 w-8 animate-spin rounded-full border-b-2 border-t-2 border-neutral-800" />
-  );
+  } = useLibraryAgentList({ searchTerm, librarySort });
 
   return (
     <>
-      <LibraryActionSubHeader agentCount={agentCount} />
+      <LibraryActionSubHeader
+        agentCount={agentCount}
+        setLibrarySort={setLibrarySort}
+      />
       <div className="px-2">
         {agentLoading ? (
           <div className="flex h-[200px] items-center justify-center">
-            <LoadingSpinner />
+            <LoadingSpinner size="large" />
           </div>
         ) : (
           <InfiniteScroll
             isFetchingNextPage={isFetchingNextPage}
             fetchNextPage={fetchNextPage}
             hasNextPage={hasNextPage}
-            loader={<LoadingSpinner />}
+            loader={<LoadingSpinner size="medium" />}
           >
-            <div className="grid grid-cols-1 gap-3 sm:grid-cols-2 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4">
+            <div className="grid grid-cols-1 gap-6 sm:grid-cols-2 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4">
               {agents.map((agent) => (
                 <LibraryAgentCard key={agent.id} agent={agent} />
               ))}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentList/useLibraryAgentList.ts b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentList/useLibraryAgentList.ts
index e9db9a02da..0b102ff545 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentList/useLibraryAgentList.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentList/useLibraryAgentList.ts
@@ -1,18 +1,23 @@
 "use client";
 
+import { useGetV2ListLibraryAgentsInfinite } from "@/app/api/__generated__/endpoints/library/library";
+import { LibraryAgentSort } from "@/app/api/__generated__/models/libraryAgentSort";
 import {
   getPaginatedTotalCount,
   getPaginationNextPageNumber,
   unpaginate,
 } from "@/app/api/helpers";
-import { useGetV2ListLibraryAgentsInfinite } from "@/app/api/__generated__/endpoints/library/library";
-import { useLibraryPageContext } from "../state-provider";
-import { useLibraryAgentsStore } from "@/hooks/useLibraryAgents/store";
-import { getInitialData } from "./helpers";
+import { getQueryClient } from "@/lib/react-query/queryClient";
+import { useEffect, useRef } from "react";
 
-export const useLibraryAgentList = () => {
-  const { searchTerm, librarySort } = useLibraryPageContext();
-  const { agents: cachedAgents } = useLibraryAgentsStore();
+interface Props {
+  searchTerm: string;
+  librarySort: LibraryAgentSort;
+}
+
+export function useLibraryAgentList({ searchTerm, librarySort }: Props) {
+  const queryClient = getQueryClient();
+  const prevSortRef = useRef<LibraryAgentSort | null>(null);
 
   const {
     data: agentsQueryData,
@@ -23,18 +28,28 @@ export const useLibraryAgentList = () => {
   } = useGetV2ListLibraryAgentsInfinite(
     {
       page: 1,
-      page_size: 8,
+      page_size: 20,
       search_term: searchTerm || undefined,
       sort_by: librarySort,
     },
     {
       query: {
-        initialData: getInitialData(cachedAgents, searchTerm, 8),
         getNextPageParam: getPaginationNextPageNumber,
       },
     },
   );
 
+  // Reset queries when sort changes to ensure fresh data with correct sorting
+  useEffect(() => {
+    if (prevSortRef.current !== null && prevSortRef.current !== librarySort) {
+      // Reset all library agent queries to ensure fresh fetch with new sort
+      queryClient.resetQueries({
+        queryKey: ["/api/library/agents"],
+      });
+    }
+    prevSortRef.current = librarySort;
+  }, [librarySort, queryClient]);
+
   const allAgents = agentsQueryData
     ? unpaginate(agentsQueryData, "agents")
     : [];
@@ -48,4 +63,4 @@ export const useLibraryAgentList = () => {
     isFetchingNextPage,
     fetchNextPage,
   };
-};
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryNotificationCard/LibraryNotificationCard.tsx b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryNotificationCard/LibraryNotificationCard.tsx
deleted file mode 100644
index 51520e4445..0000000000
--- a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryNotificationCard/LibraryNotificationCard.tsx
+++ /dev/null
@@ -1,175 +0,0 @@
-import Image from "next/image";
-import { Button } from "@/components/__legacy__/ui/button";
-import { Separator } from "@/components/__legacy__/ui/separator";
-import {
-  CirclePlayIcon,
-  ClipboardCopy,
-  ImageIcon,
-  PlayCircle,
-  Share2,
-  X,
-} from "lucide-react";
-
-export interface NotificationCardData {
-  type: "text" | "image" | "video" | "audio";
-  title: string;
-  id: string;
-  content?: string;
-  mediaUrl?: string;
-}
-
-interface NotificationCardProps {
-  notification: NotificationCardData;
-  onClose: () => void;
-}
-
-const NotificationCard = ({
-  notification: { type, title, content, mediaUrl },
-  onClose,
-}: NotificationCardProps) => {
-  const barHeights = Array.from({ length: 60 }, () =>
-    Math.floor(Math.random() * (34 - 20 + 1) + 20),
-  );
-
-  const handleClose = (e: React.MouseEvent<HTMLButtonElement>) => {
-    e.preventDefault();
-    onClose();
-  };
-
-  return (
-    <div className="w-[430px] space-y-[22px] rounded-[14px] border border-neutral-100 bg-neutral-50 p-[16px] pt-[12px]">
-      <div className="flex items-center justify-between">
-        {/* count */}
-        <div className="flex items-center gap-[10px]">
-          <p className="font-sans text-[12px] font-medium text-neutral-500">
-            1/4
-          </p>
-          <p className="h-[26px] rounded-[45px] bg-green-100 px-[9px] py-[3px] font-sans text-[12px] font-medium text-green-800">
-            Success
-          </p>
-        </div>
-
-        {/* cross icon */}
-        <Button
-          variant="ghost"
-          className="p-0 hover:bg-transparent"
-          onClick={handleClose}
-        >
-          <X
-            className="h-6 w-6 text-[#020617] hover:scale-105"
-            strokeWidth={1.25}
-          />
-        </Button>
-      </div>
-
-      <div className="space-y-[6px] p-0">
-        <p className="font-sans text-[14px] font-medium leading-[20px] text-neutral-500">
-          New Output Ready!
-        </p>
-        <h2 className="font-poppin text-[20px] font-medium leading-7 text-neutral-800">
-          {title}
-        </h2>
-        {type === "text" && <Separator />}
-      </div>
-
-      <div className="p-0">
-        {type === "text" && (
-          // Maybe in future we give markdown support
-          <div className="mt-[-8px] line-clamp-6 font-sans text-sm font-[400px] text-neutral-600">
-            {content}
-          </div>
-        )}
-
-        {type === "image" &&
-          (mediaUrl ? (
-            <div className="relative h-[200px] w-full">
-              <Image
-                src={mediaUrl}
-                alt={title}
-                fill
-                className="rounded-lg object-cover"
-              />
-            </div>
-          ) : (
-            <div className="flex h-[244px] w-full items-center justify-center rounded-lg bg-[#D9D9D9]">
-              <ImageIcon
-                className="h-[138px] w-[138px] text-neutral-400"
-                strokeWidth={1}
-              />
-            </div>
-          ))}
-
-        {type === "video" && (
-          <div className="space-y-4">
-            {mediaUrl ? (
-              <video src={mediaUrl} controls className="w-full rounded-lg" />
-            ) : (
-              <div className="flex h-[219px] w-[398px] items-center justify-center rounded-lg bg-[#D9D9D9]">
-                <PlayCircle
-                  className="h-16 w-16 text-neutral-500"
-                  strokeWidth={1}
-                />
-              </div>
-            )}
-          </div>
-        )}
-
-        {type === "audio" && (
-          <div className="flex gap-2">
-            <CirclePlayIcon
-              className="h-10 w-10 rounded-full bg-neutral-800 text-white"
-              strokeWidth={1}
-            />
-            <div className="flex flex-1 items-center justify-between">
-              {/* <audio src={mediaUrl} controls className="w-full" /> */}
-              {barHeights.map((h, i) => {
-                return (
-                  <div
-                    key={i}
-                    className={`rounded-[8px] bg-neutral-500`}
-                    style={{
-                      height: `${h}px`,
-                      width: "3px",
-                    }}
-                  />
-                );
-              })}
-            </div>
-          </div>
-        )}
-      </div>
-
-      <div className="flex justify-between gap-2 p-0">
-        <div className="space-x-3">
-          <Button
-            variant="outline"
-            onClick={() => {
-              navigator.share({
-                title,
-                text: content,
-                url: mediaUrl,
-              });
-            }}
-            className="h-10 w-10 rounded-full border-neutral-800 p-0"
-          >
-            <Share2 className="h-5 w-5" strokeWidth={1} />
-          </Button>
-          <Button
-            variant="outline"
-            onClick={() =>
-              navigator.clipboard.writeText(content || mediaUrl || "")
-            }
-            className="h-10 w-10 rounded-full border-neutral-800 p-0"
-          >
-            <ClipboardCopy className="h-5 w-5" strokeWidth={1} />
-          </Button>
-        </div>
-        <Button className="h-[40px] rounded-[52px] bg-neutral-800 px-4 py-2">
-          See run
-        </Button>
-      </div>
-    </div>
-  );
-};
-
-export default NotificationCard;
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryNotificationDropdown/LibraryNotificationDropdown.tsx b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryNotificationDropdown/LibraryNotificationDropdown.tsx
deleted file mode 100644
index cd863a21af..0000000000
--- a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryNotificationDropdown/LibraryNotificationDropdown.tsx
+++ /dev/null
@@ -1,132 +0,0 @@
-"use client";
-import React, { useState, useEffect, useMemo } from "react";
-
-import { motion, useAnimationControls } from "framer-motion";
-import { BellIcon, X } from "lucide-react";
-import { Button } from "@/components/__legacy__/Button";
-import {
-  DropdownMenu,
-  DropdownMenuContent,
-  DropdownMenuItem,
-  DropdownMenuLabel,
-  DropdownMenuTrigger,
-} from "@/components/__legacy__/ui/dropdown-menu";
-import NotificationCard, {
-  NotificationCardData,
-} from "../LibraryNotificationCard/LibraryNotificationCard";
-
-export default function LibraryNotificationDropdown(): React.ReactNode {
-  const controls = useAnimationControls();
-  const [open, setOpen] = useState(false);
-  const [notifications, setNotifications] = useState<
-    NotificationCardData[] | null
-  >(null);
-
-  const initialNotificationData = useMemo(
-    () =>
-      [
-        {
-          type: "audio",
-          title: "Audio Processing Complete",
-          id: "4",
-        },
-        {
-          type: "text",
-          title: "LinkedIn Post Generator: YouTube to Professional Content",
-          id: "1",
-          content:
-            "As artificial intelligence (AI) continues to evolve, it's increasingly clear that AI isn't just a trend—it's reshaping the way we work, innovate, and solve complex problems. However, for many professionals, the question remains: How can I leverage AI to drive meaningful results in my own field? In this article, we'll explore how AI can empower businesses and individuals alike to be more efficient, make better decisions, and unlock new opportunities. Whether you're in tech, finance, healthcare, or any other industry, understanding the potential of AI can set you apart.",
-        },
-        {
-          type: "image",
-          title: "New Image Upload",
-          id: "2",
-        },
-        {
-          type: "video",
-          title: "Video Processing Complete",
-          id: "3",
-        },
-      ] as NotificationCardData[],
-    [],
-  );
-
-  useEffect(() => {
-    if (initialNotificationData) {
-      setNotifications(initialNotificationData);
-    }
-  }, [initialNotificationData]);
-
-  const handleHoverStart = () => {
-    controls.start({
-      rotate: [0, -10, 10, -10, 10, 0],
-      transition: { duration: 0.5 },
-    });
-  };
-
-  return (
-    <DropdownMenu open={open} onOpenChange={setOpen}>
-      <DropdownMenuTrigger className="sm:flex-1" asChild>
-        <Button
-          variant={open ? "primary" : "outline"}
-          onMouseEnter={handleHoverStart}
-          onMouseLeave={handleHoverStart}
-          className="w-fit max-w-[161px] transition-all duration-200 ease-in-out sm:w-[161px]"
-        >
-          <motion.div animate={controls}>
-            <BellIcon
-              className="h-5 w-5 transition-all duration-200 ease-in-out sm:mr-2"
-              strokeWidth={2}
-            />
-          </motion.div>
-          <motion.div
-            initial={{ opacity: 1 }}
-            animate={{ opacity: 1 }}
-            exit={{ opacity: 0 }}
-            className="hidden items-center transition-opacity duration-300 sm:inline-flex"
-          >
-            Your updates
-            <span className="ml-2 text-[14px]">
-              {notifications?.length || 0}
-            </span>
-          </motion.div>
-        </Button>
-      </DropdownMenuTrigger>
-      <DropdownMenuContent
-        sideOffset={22}
-        className="relative left-[16px] h-[80vh] w-fit overflow-y-auto rounded-[26px] bg-[#C5C5CA] p-5"
-      >
-        <DropdownMenuLabel className="z-10 mb-4 font-sans text-[18px] text-white">
-          Agent run updates
-        </DropdownMenuLabel>
-        <button
-          className="absolute right-[10px] top-[20px] h-fit w-fit"
-          onClick={() => setOpen(false)}
-        >
-          <X className="h-6 w-6 text-white hover:text-white/60" />
-        </button>
-        <div className="space-y-[12px]">
-          {notifications && notifications.length ? (
-            notifications.map((notification) => (
-              <DropdownMenuItem key={notification.id} className="p-0">
-                <NotificationCard
-                  notification={notification}
-                  onClose={() =>
-                    setNotifications((prev) => {
-                      if (!prev) return null;
-                      return prev.filter((n) => n.id !== notification.id);
-                    })
-                  }
-                />
-              </DropdownMenuItem>
-            ))
-          ) : (
-            <div className="w-[464px] py-4 text-center text-white">
-              No notifications present
-            </div>
-          )}
-        </div>
-      </DropdownMenuContent>
-    </DropdownMenu>
-  );
-}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/LibrarySearchBar/LibrarySearchBar.tsx b/autogpt_platform/frontend/src/app/(platform)/library/components/LibrarySearchBar/LibrarySearchBar.tsx
index ee36347874..cf63c300d6 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/components/LibrarySearchBar/LibrarySearchBar.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/LibrarySearchBar/LibrarySearchBar.tsx
@@ -1,40 +1,37 @@
 "use client";
-import { Input } from "@/components/__legacy__/ui/input";
-import { Search, X } from "lucide-react";
+
+import { Input } from "@/components/atoms/Input/Input";
+import { MagnifyingGlassIcon } from "@phosphor-icons/react";
 import { useLibrarySearchbar } from "./useLibrarySearchbar";
 
-export default function LibrarySearchBar(): React.ReactNode {
-  const { handleSearchInput, handleClear, setIsFocused, isFocused, inputRef } =
-    useLibrarySearchbar();
+interface Props {
+  setSearchTerm: (value: string) => void;
+}
+
+export function LibrarySearchBar({ setSearchTerm }: Props) {
+  const { handleSearchInput } = useLibrarySearchbar({ setSearchTerm });
+
   return (
     <div
       data-testid="search-bar"
-      onClick={() => inputRef.current?.focus()}
-      className="relative z-[21] mx-auto flex h-[50px] w-full max-w-[500px] flex-1 cursor-pointer items-center rounded-[45px] bg-[#EDEDED] px-[24px] py-[10px]"
+      className="relative z-[21] -mb-6 flex w-full items-center md:w-auto"
     >
-      <Search
-        className="mr-2 h-[29px] w-[29px] text-neutral-900"
-        strokeWidth={1.25}
+      <MagnifyingGlassIcon
+        width={18}
+        height={18}
+        className="absolute left-4 top-[34%] z-20 -translate-y-1/2 text-zinc-800"
       />
 
       <Input
-        ref={inputRef}
-        onFocus={() => setIsFocused(true)}
-        onBlur={() => !inputRef.current?.value && setIsFocused(false)}
+        label="Search agents"
+        id="library-search-bar"
+        hideLabel
         onChange={handleSearchInput}
-        className="flex-1 border-none font-sans text-[16px] font-normal leading-7 shadow-none focus:shadow-none focus:ring-0"
+        className="min-w-[18rem] pl-12 lg:min-w-[30rem]"
         type="text"
         data-testid="library-textbox"
         placeholder="Search agents"
       />
-
-      {isFocused && inputRef.current?.value && (
-        <X
-          className="ml-2 h-[29px] w-[29px] cursor-pointer text-neutral-900"
-          strokeWidth={1.25}
-          onClick={handleClear}
-        />
-      )}
     </div>
   );
 }
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/LibrarySearchBar/useLibrarySearchbar.tsx b/autogpt_platform/frontend/src/app/(platform)/library/components/LibrarySearchBar/useLibrarySearchbar.tsx
index f6428c6c4e..74b8e9874c 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/components/LibrarySearchBar/useLibrarySearchbar.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/LibrarySearchBar/useLibrarySearchbar.tsx
@@ -1,36 +1,30 @@
-import { useRef, useState } from "react";
-import { useLibraryPageContext } from "../state-provider";
 import { debounce } from "lodash";
+import { useCallback, useEffect } from "react";
 
-export const useLibrarySearchbar = () => {
-  const inputRef = useRef<HTMLInputElement>(null);
-  const [isFocused, setIsFocused] = useState(false);
-  const { setSearchTerm } = useLibraryPageContext();
+interface Props {
+  setSearchTerm: (value: string) => void;
+}
 
-  const debouncedSearch = debounce((value: string) => {
-    setSearchTerm(value);
-  }, 300);
+export function useLibrarySearchbar({ setSearchTerm }: Props) {
+  const debouncedSearch = useCallback(
+    debounce((value: string) => {
+      setSearchTerm(value);
+    }, 300),
+    [setSearchTerm],
+  );
 
-  const handleSearchInput = (e: React.ChangeEvent<HTMLInputElement>) => {
+  useEffect(() => {
+    return () => {
+      debouncedSearch.cancel();
+    };
+  }, [debouncedSearch]);
+
+  function handleSearchInput(e: React.ChangeEvent<HTMLInputElement>) {
     const searchTerm = e.target.value;
     debouncedSearch(searchTerm);
-  };
-
-  const handleClear = (e: React.MouseEvent) => {
-    if (inputRef.current) {
-      inputRef.current.value = "";
-      inputRef.current.blur();
-      setSearchTerm("");
-      e.preventDefault();
-    }
-    setIsFocused(false);
-  };
+  }
 
   return {
-    handleClear,
     handleSearchInput,
-    isFocused,
-    inputRef,
-    setIsFocused,
   };
-};
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/LibrarySortMenu/LibrarySortMenu.tsx b/autogpt_platform/frontend/src/app/(platform)/library/components/LibrarySortMenu/LibrarySortMenu.tsx
index ac4ed060f2..de37af5fad 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/components/LibrarySortMenu/LibrarySortMenu.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/LibrarySortMenu/LibrarySortMenu.tsx
@@ -1,5 +1,5 @@
 "use client";
-import { ArrowDownNarrowWideIcon } from "lucide-react";
+import { LibraryAgentSort } from "@/app/api/__generated__/models/libraryAgentSort";
 import {
   Select,
   SelectContent,
@@ -8,11 +8,15 @@ import {
   SelectTrigger,
   SelectValue,
 } from "@/components/__legacy__/ui/select";
-import { LibraryAgentSort } from "@/app/api/__generated__/models/libraryAgentSort";
+import { ArrowDownNarrowWideIcon } from "lucide-react";
 import { useLibrarySortMenu } from "./useLibrarySortMenu";
 
-export default function LibrarySortMenu(): React.ReactNode {
-  const { handleSortChange } = useLibrarySortMenu();
+interface Props {
+  setLibrarySort: (value: LibraryAgentSort) => void;
+}
+
+export function LibrarySortMenu({ setLibrarySort }: Props) {
+  const { handleSortChange } = useLibrarySortMenu({ setLibrarySort });
   return (
     <div className="flex items-center" data-testid="sort-by-dropdown">
       <span className="hidden whitespace-nowrap sm:inline">sort by</span>
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/LibrarySortMenu/useLibrarySortMenu.ts b/autogpt_platform/frontend/src/app/(platform)/library/components/LibrarySortMenu/useLibrarySortMenu.ts
index d2575c8936..e6d6f2d127 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/components/LibrarySortMenu/useLibrarySortMenu.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/LibrarySortMenu/useLibrarySortMenu.ts
@@ -1,11 +1,11 @@
 import { LibraryAgentSort } from "@/app/api/__generated__/models/libraryAgentSort";
-import { useLibraryPageContext } from "../state-provider";
 
-export const useLibrarySortMenu = () => {
-  const { setLibrarySort } = useLibraryPageContext();
+interface Props {
+  setLibrarySort: (value: LibraryAgentSort) => void;
+}
 
+export function useLibrarySortMenu({ setLibrarySort }: Props) {
   const handleSortChange = (value: LibraryAgentSort) => {
-    // Simply updating the sort state - React Query will handle the rest
     setLibrarySort(value);
   };
 
@@ -24,4 +24,4 @@ export const useLibrarySortMenu = () => {
     handleSortChange,
     getSortLabel,
   };
-};
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryUploadAgentDialog/LibraryUploadAgentDialog.tsx b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryUploadAgentDialog/LibraryUploadAgentDialog.tsx
index d92bbe86fe..1a6999721e 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryUploadAgentDialog/LibraryUploadAgentDialog.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryUploadAgentDialog/LibraryUploadAgentDialog.tsx
@@ -1,192 +1,134 @@
 "use client";
-import { Upload, X } from "lucide-react";
-import { Button } from "@/components/__legacy__/Button";
-import {
-  Dialog,
-  DialogContent,
-  DialogDescription,
-  DialogHeader,
-  DialogTitle,
-  DialogTrigger,
-} from "@/components/__legacy__/ui/dialog";
-import { z } from "zod";
-import { FileUploader } from "react-drag-drop-files";
+import { Button } from "@/components/atoms/Button/Button";
+import { FileInput } from "@/components/atoms/FileInput/FileInput";
+import { Input } from "@/components/atoms/Input/Input";
+import { Dialog } from "@/components/molecules/Dialog/Dialog";
 import {
   Form,
   FormControl,
   FormField,
   FormItem,
-  FormLabel,
   FormMessage,
-} from "@/components/__legacy__/ui/form";
-import { Input } from "@/components/__legacy__/ui/input";
-import { Textarea } from "@/components/__legacy__/ui/textarea";
+} from "@/components/molecules/Form/Form";
+import { UploadSimpleIcon } from "@phosphor-icons/react";
+import { z } from "zod";
 import { useLibraryUploadAgentDialog } from "./useLibraryUploadAgentDialog";
 
-const fileTypes = ["JSON"];
-
-const fileSchema = z.custom<File>((val) => val instanceof File, {
-  message: "Must be a File object",
-});
-
 export const uploadAgentFormSchema = z.object({
-  agentFile: fileSchema,
+  agentFile: z.string().min(1, "Agent file is required"),
   agentName: z.string().min(1, "Agent name is required"),
   agentDescription: z.string(),
 });
 
-export default function LibraryUploadAgentDialog(): React.ReactNode {
-  const {
-    onSubmit,
-    isUploading,
-    isOpen,
-    setIsOpen,
-    isDroped,
-    handleChange,
-    form,
-    setisDroped,
-    agentObject,
-    clearAgentFile,
-  } = useLibraryUploadAgentDialog();
+export default function LibraryUploadAgentDialog() {
+  const { onSubmit, isUploading, isOpen, setIsOpen, form, agentObject } =
+    useLibraryUploadAgentDialog();
+
   return (
-    <Dialog open={isOpen} onOpenChange={setIsOpen}>
-      <DialogTrigger asChild>
+    <Dialog
+      title="Upload Agent"
+      styling={{ maxWidth: "30rem" }}
+      controlled={{
+        isOpen,
+        set: setIsOpen,
+      }}
+      onClose={() => {
+        setIsOpen(false);
+      }}
+    >
+      <Dialog.Trigger>
         <Button
           data-testid="upload-agent-button"
           variant="primary"
-          className="w-fit sm:w-[177px]"
+          className="h-[2.78rem] w-full md:w-[12rem]"
+          size="small"
         >
-          <Upload className="h-5 w-5 sm:mr-2" />
-          <span className="hidden items-center sm:inline-flex">
-            Upload an agent
-          </span>
+          <UploadSimpleIcon width={18} height={18} />
+          <span className="">Upload agent</span>
         </Button>
-      </DialogTrigger>
-      <DialogContent>
-        <DialogHeader>
-          <DialogTitle className="mb-8 text-center">Upload Agent</DialogTitle>
-          <DialogDescription>
-            Upload your agent by providing a name, description, and JSON file.
-          </DialogDescription>
-        </DialogHeader>
+      </Dialog.Trigger>
+      <Dialog.Content>
+        <Form
+          form={form}
+          onSubmit={onSubmit}
+          className="flex flex-col justify-center gap-0 px-1"
+        >
+          <FormField
+            control={form.control}
+            name="agentName"
+            render={({ field }) => (
+              <FormItem>
+                <FormControl>
+                  <Input
+                    {...field}
+                    id={field.name}
+                    label="Agent name"
+                    className="w-full rounded-[10px]"
+                  />
+                </FormControl>
+                <FormMessage />
+              </FormItem>
+            )}
+          />
 
-        <Form {...form}>
-          <form onSubmit={form.handleSubmit(onSubmit)} className="space-y-4">
-            <FormField
-              control={form.control}
-              name="agentName"
-              render={({ field }) => (
-                <FormItem>
-                  <FormLabel>Agent name</FormLabel>
-                  <FormControl>
-                    <Input {...field} className="w-full rounded-[10px]" />
-                  </FormControl>
-                  <FormMessage />
-                </FormItem>
-              )}
-            />
+          <FormField
+            control={form.control}
+            name="agentDescription"
+            render={({ field }) => (
+              <FormItem>
+                <FormControl>
+                  <Input
+                    {...field}
+                    id={field.name}
+                    label="Agent description"
+                    type="textarea"
+                    className="w-full rounded-[10px]"
+                  />
+                </FormControl>
+                <FormMessage />
+              </FormItem>
+            )}
+          />
 
-            <FormField
-              control={form.control}
-              name="agentDescription"
-              render={({ field }) => (
-                <FormItem>
-                  <FormLabel>Description</FormLabel>
-                  <FormControl>
-                    <Textarea {...field} className="w-full rounded-[10px]" />
-                  </FormControl>
-                  <FormMessage />
-                </FormItem>
-              )}
-            />
+          <FormField
+            control={form.control}
+            name="agentFile"
+            render={({ field }) => (
+              <FormItem>
+                <FormControl>
+                  <FileInput
+                    mode="base64"
+                    value={field.value}
+                    onChange={field.onChange}
+                    accept=".json,application/json"
+                    placeholder="Agent file"
+                    maxFileSize={10 * 1024 * 1024}
+                    showStorageNote={false}
+                    className="mb-8 mt-4"
+                  />
+                </FormControl>
+                <FormMessage />
+              </FormItem>
+            )}
+          />
 
-            <FormField
-              control={form.control}
-              name="agentFile"
-              render={({ field }) => (
-                <FormItem className="rounded-xl border-2 border-dashed border-neutral-300 hover:border-neutral-600">
-                  <FormControl>
-                    {field.value ? (
-                      <div className="relative flex rounded-[10px] border p-2 font-sans text-sm font-medium text-[#525252] outline-none">
-                        <span className="line-clamp-1">{field.value.name}</span>
-                        <Button
-                          onClick={clearAgentFile}
-                          className="absolute left-[-10px] top-[-16px] mt-2 h-fit border-none bg-red-200 p-1"
-                        >
-                          <X
-                            className="m-0 h-[12px] w-[12px] text-red-600"
-                            strokeWidth={3}
-                          />
-                        </Button>
-                      </div>
-                    ) : (
-                      <FileUploader
-                        handleChange={handleChange}
-                        name="file"
-                        types={fileTypes}
-                        label={"Upload your agent here..!!"}
-                        uploadedLabel={"Uploading Successful"}
-                        required={true}
-                        hoverTitle={"Drop your agent here...!!"}
-                        maxSize={10}
-                        classes={"drop-style"}
-                        onDrop={() => {
-                          setisDroped(true);
-                        }}
-                        onSelect={() => setisDroped(true)}
-                      >
-                        <div
-                          style={{
-                            minHeight: "150px",
-                            display: "flex",
-                            flexDirection: "column",
-                            justifyContent: "center",
-                            alignItems: "center",
-                            outline: "none",
-                            color: "#525252",
-                            fontSize: "14px",
-                            fontWeight: "500",
-                            borderWidth: "0px",
-                          }}
-                        >
-                          {isDroped ? (
-                            <div className="flex items-center justify-center py-4">
-                              <div className="h-8 w-8 animate-spin rounded-full border-b-2 border-t-2 border-neutral-800"></div>
-                            </div>
-                          ) : (
-                            <>
-                              <span>Drop your agent here</span>
-                              <span>or</span>
-                              <span>Click to upload</span>
-                            </>
-                          )}
-                        </div>
-                      </FileUploader>
-                    )}
-                  </FormControl>
-                  <FormMessage />
-                </FormItem>
-              )}
-            />
-
-            <Button
-              type="submit"
-              variant="primary"
-              className="mt-2 self-end"
-              disabled={!agentObject || isUploading}
-            >
-              {isUploading ? (
-                <div className="flex items-center gap-2">
-                  <div className="h-4 w-4 animate-spin rounded-full border-b-2 border-t-2 border-white"></div>
-                  <span>Uploading...</span>
-                </div>
-              ) : (
-                "Upload Agent"
-              )}
-            </Button>
-          </form>
+          <Button
+            type="submit"
+            variant="primary"
+            className="min-w-[18rem]"
+            disabled={!agentObject || isUploading}
+          >
+            {isUploading ? (
+              <div className="flex items-center gap-2">
+                <div className="h-4 w-4 animate-spin rounded-full border-b-2 border-t-2 border-white"></div>
+                <span>Uploading...</span>
+              </div>
+            ) : (
+              "Upload"
+            )}
+          </Button>
         </Form>
-      </DialogContent>
+      </Dialog.Content>
     </Dialog>
   );
 }
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryUploadAgentDialog/useLibraryUploadAgentDialog.ts b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryUploadAgentDialog/useLibraryUploadAgentDialog.ts
index 689753a340..e5e9c5d6df 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryUploadAgentDialog/useLibraryUploadAgentDialog.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryUploadAgentDialog/useLibraryUploadAgentDialog.ts
@@ -1,16 +1,15 @@
+import { usePostV1CreateNewGraph } from "@/app/api/__generated__/endpoints/graphs/graphs";
+import { Graph } from "@/app/api/__generated__/models/graph";
+import { GraphModel } from "@/app/api/__generated__/models/graphModel";
+import { useToast } from "@/components/molecules/Toast/use-toast";
+import { sanitizeImportedGraph } from "@/lib/autogpt-server-api";
 import { zodResolver } from "@hookform/resolvers/zod";
+import { useEffect, useRef, useState } from "react";
 import { useForm } from "react-hook-form";
 import { z } from "zod";
 import { uploadAgentFormSchema } from "./LibraryUploadAgentDialog";
-import { usePostV1CreateNewGraph } from "@/app/api/__generated__/endpoints/graphs/graphs";
-import { GraphModel } from "@/app/api/__generated__/models/graphModel";
-import { useToast } from "@/components/molecules/Toast/use-toast";
-import { useState } from "react";
-import { Graph } from "@/app/api/__generated__/models/graph";
-import { sanitizeImportedGraph } from "@/lib/autogpt-server-api";
 
-export const useLibraryUploadAgentDialog = () => {
-  const [isDroped, setisDroped] = useState(false);
+export function useLibraryUploadAgentDialog() {
   const [isOpen, setIsOpen] = useState(false);
   const { toast } = useToast();
   const [agentObject, setAgentObject] = useState<Graph | null>(null);
@@ -43,9 +42,78 @@ export const useLibraryUploadAgentDialog = () => {
     defaultValues: {
       agentName: "",
       agentDescription: "",
+      agentFile: "",
     },
   });
 
+  const agentFileValue = form.watch("agentFile");
+  const prevAgentObjectRef = useRef<Graph | null>(null);
+
+  useEffect(() => {
+    if (!agentFileValue) {
+      const prevAgent = prevAgentObjectRef.current;
+      if (prevAgent) {
+        const currentName = form.getValues("agentName");
+        const currentDescription = form.getValues("agentDescription");
+        if (currentName === prevAgent.name) {
+          form.setValue("agentName", "");
+        }
+        if (currentDescription === prevAgent.description) {
+          form.setValue("agentDescription", "");
+        }
+      }
+      setAgentObject(null);
+      prevAgentObjectRef.current = null;
+      return;
+    }
+
+    try {
+      const base64Match = agentFileValue.match(/^data:[^;]+;base64,(.+)$/);
+      if (!base64Match) {
+        throw new Error("Invalid base64 data URL format");
+      }
+
+      const base64String = base64Match[1];
+      const jsonString = atob(base64String);
+      const obj = JSON.parse(jsonString);
+
+      if (
+        !["name", "description", "nodes", "links"].every(
+          (key) => key in obj && obj[key] != null,
+        )
+      ) {
+        throw new Error(
+          "Invalid agent file. Please upload a valid agent.json file that has been previously exported from the AutoGPT platform. The file must contain the required fields: name, description, nodes, and links.",
+        );
+      }
+
+      const agent = obj as Graph;
+      sanitizeImportedGraph(agent);
+      setAgentObject(agent);
+      prevAgentObjectRef.current = agent;
+
+      if (!form.getValues("agentName")) {
+        form.setValue("agentName", agent.name);
+      }
+      if (!form.getValues("agentDescription")) {
+        form.setValue("agentDescription", agent.description);
+      }
+    } catch (error) {
+      console.error("Error loading agent file:", error);
+
+      toast({
+        title: "Invalid Agent File",
+        description:
+          "Please upload a valid agent.json file that has been previously exported from the AutoGPT platform. The file must contain the required fields: name, description, nodes, and links.",
+        duration: 5000,
+        variant: "destructive",
+      });
+
+      form.resetField("agentFile");
+      setAgentObject(null);
+    }
+  }, [agentFileValue, form, toast]);
+
   const onSubmit = async (values: z.infer<typeof uploadAgentFormSchema>) => {
     if (!agentObject) {
       form.setError("root", { message: "No Agent object to save" });
@@ -67,69 +135,6 @@ export const useLibraryUploadAgentDialog = () => {
     });
   };
 
-  const handleChange = (file: File) => {
-    setTimeout(() => {
-      setisDroped(false);
-    }, 2000);
-
-    form.setValue("agentFile", file);
-    const reader = new FileReader();
-    reader.onload = (event) => {
-      try {
-        const obj = JSON.parse(event.target?.result as string);
-        if (
-          !["name", "description", "nodes", "links"].every(
-            (key) => key in obj && obj[key] != null,
-          )
-        ) {
-          throw new Error(
-            "Invalid agent file. Please upload a valid agent.json file that has been previously exported from the AutoGPT platform. The file must contain the required fields: name, description, nodes, and links.",
-          );
-        }
-        const agent = obj as Graph;
-        sanitizeImportedGraph(agent);
-        setAgentObject(agent);
-        if (!form.getValues("agentName")) {
-          form.setValue("agentName", agent.name);
-        }
-        if (!form.getValues("agentDescription")) {
-          form.setValue("agentDescription", agent.description);
-        }
-      } catch (error) {
-        console.error("Error loading agent file:", error);
-
-        toast({
-          title: "Invalid Agent File",
-          description:
-            "Please upload a valid agent.json file that has been previously exported from the AutoGPT platform. The file must contain the required fields: name, description, nodes, and links.",
-          duration: 5000,
-          variant: "destructive",
-        });
-
-        form.resetField("agentFile");
-        setAgentObject(null);
-      }
-    };
-    reader.readAsText(file);
-    setisDroped(false);
-  };
-
-  const clearAgentFile = () => {
-    const currentName = form.getValues("agentName");
-    const currentDescription = form.getValues("agentDescription");
-    const prevAgent = agentObject;
-
-    form.setValue("agentFile", undefined as any);
-    if (prevAgent && currentName === prevAgent.name) {
-      form.setValue("agentName", "");
-    }
-    if (prevAgent && currentDescription === prevAgent.description) {
-      form.setValue("agentDescription", "");
-    }
-
-    setAgentObject(null);
-  };
-
   return {
     onSubmit,
     isUploading,
@@ -137,9 +142,5 @@ export const useLibraryUploadAgentDialog = () => {
     setIsOpen,
     form,
     agentObject,
-    isDroped,
-    handleChange,
-    setisDroped,
-    clearAgentFile,
   };
-};
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/state-provider.tsx b/autogpt_platform/frontend/src/app/(platform)/library/components/state-provider.tsx
deleted file mode 100644
index 20afbc9cd5..0000000000
--- a/autogpt_platform/frontend/src/app/(platform)/library/components/state-provider.tsx
+++ /dev/null
@@ -1,59 +0,0 @@
-"use client";
-
-import { LibraryAgentSort } from "@/app/api/__generated__/models/libraryAgentSort";
-import {
-  createContext,
-  useState,
-  ReactNode,
-  useContext,
-  Dispatch,
-  SetStateAction,
-} from "react";
-
-interface LibraryPageContextType {
-  searchTerm: string;
-  setSearchTerm: Dispatch<SetStateAction<string>>;
-  uploadedFile: File | null;
-  setUploadedFile: Dispatch<SetStateAction<File | null>>;
-  librarySort: LibraryAgentSort;
-  setLibrarySort: Dispatch<SetStateAction<LibraryAgentSort>>;
-}
-
-export const LibraryPageContext = createContext<LibraryPageContextType>(
-  {} as LibraryPageContextType,
-);
-
-export function LibraryPageStateProvider({
-  children,
-}: {
-  children: ReactNode;
-}) {
-  const [searchTerm, setSearchTerm] = useState<string>("");
-  const [uploadedFile, setUploadedFile] = useState<File | null>(null);
-  const [librarySort, setLibrarySort] = useState<LibraryAgentSort>(
-    LibraryAgentSort.updatedAt,
-  );
-
-  return (
-    <LibraryPageContext.Provider
-      value={{
-        searchTerm,
-        setSearchTerm,
-        uploadedFile,
-        setUploadedFile,
-        librarySort,
-        setLibrarySort,
-      }}
-    >
-      {children}
-    </LibraryPageContext.Provider>
-  );
-}
-
-export function useLibraryPageContext(): LibraryPageContextType {
-  const context = useContext(LibraryPageContext);
-  if (!context) {
-    throw new Error("Error in context of Library page");
-  }
-  return context;
-}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/useLibraryListPage.ts b/autogpt_platform/frontend/src/app/(platform)/library/components/useLibraryListPage.ts
new file mode 100644
index 0000000000..94a8fe9fab
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/useLibraryListPage.ts
@@ -0,0 +1,41 @@
+"use client";
+
+import { LibraryAgentSort } from "@/app/api/__generated__/models/libraryAgentSort";
+import { parseAsStringEnum, useQueryState } from "nuqs";
+import { useCallback, useEffect, useMemo, useState } from "react";
+
+const sortParser = parseAsStringEnum(Object.values(LibraryAgentSort));
+
+export function useLibraryListPage() {
+  const [searchTerm, setSearchTerm] = useState<string>("");
+  const [uploadedFile, setUploadedFile] = useState<File | null>(null);
+  const [librarySortRaw, setLibrarySortRaw] = useQueryState("sort", sortParser);
+
+  // Ensure sort param is always present in URL (even if default)
+  useEffect(() => {
+    if (!librarySortRaw) {
+      setLibrarySortRaw(LibraryAgentSort.updatedAt, { shallow: false });
+    }
+  }, [librarySortRaw, setLibrarySortRaw]);
+
+  const librarySort = librarySortRaw || LibraryAgentSort.updatedAt;
+
+  const setLibrarySort = useCallback(
+    (value: LibraryAgentSort) => {
+      setLibrarySortRaw(value, { shallow: false });
+    },
+    [setLibrarySortRaw],
+  );
+
+  return useMemo(
+    () => ({
+      searchTerm,
+      setSearchTerm,
+      uploadedFile,
+      setUploadedFile,
+      librarySort,
+      setLibrarySort,
+    }),
+    [searchTerm, uploadedFile, librarySort, setLibrarySort],
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/hooks/useFavoriteAgents.ts b/autogpt_platform/frontend/src/app/(platform)/library/hooks/useFavoriteAgents.ts
index 933670ca80..d5f8cce057 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/hooks/useFavoriteAgents.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/library/hooks/useFavoriteAgents.ts
@@ -1,13 +1,15 @@
 "use client";
 
-import {
-  getPaginatedTotalCount,
-  getPaginationNextPageNumber,
-  unpaginate,
-} from "@/app/api/helpers";
 import { useGetV2ListFavoriteLibraryAgentsInfinite } from "@/app/api/__generated__/endpoints/library/library";
+import { getPaginationNextPageNumber, unpaginate } from "@/app/api/helpers";
+import { useMemo } from "react";
+import { filterAgents } from "../components/LibraryAgentList/helpers";
 
-export function useFavoriteAgents() {
+interface Props {
+  searchTerm: string;
+}
+
+export function useFavoriteAgents({ searchTerm }: Props) {
   const {
     data: agentsQueryData,
     fetchNextPage,
@@ -27,10 +29,16 @@ export function useFavoriteAgents() {
   const allAgents = agentsQueryData
     ? unpaginate(agentsQueryData, "agents")
     : [];
-  const agentCount = getPaginatedTotalCount(agentsQueryData);
+
+  const filteredAgents = useMemo(
+    () => filterAgents(allAgents, searchTerm),
+    [allAgents, searchTerm],
+  );
+
+  const agentCount = filteredAgents.length;
 
   return {
-    allAgents,
+    allAgents: filteredAgents,
     agentLoading,
     hasNextPage,
     agentCount,
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/page.tsx b/autogpt_platform/frontend/src/app/(platform)/library/page.tsx
index c4c3f5ab21..c619d480e0 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/page.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/page.tsx
@@ -1,23 +1,28 @@
 "use client";
 
 import { useEffect } from "react";
-import FavoritesSection from "./components/FavoritesSection/FavoritesSection";
-import LibraryActionHeader from "./components/LibraryActionHeader/LibraryActionHeader";
-import LibraryAgentList from "./components/LibraryAgentList/LibraryAgentList";
-import { LibraryPageStateProvider } from "./components/state-provider";
+import { FavoritesSection } from "./components/FavoritesSection/FavoritesSection";
+import { LibraryActionHeader } from "./components/LibraryActionHeader/LibraryActionHeader";
+import { LibraryAgentList } from "./components/LibraryAgentList/LibraryAgentList";
+import { useLibraryListPage } from "./components/useLibraryListPage";
 
 export default function LibraryPage() {
+  const { searchTerm, setSearchTerm, librarySort, setLibrarySort } =
+    useLibraryListPage();
+
   useEffect(() => {
     document.title = "Library – AutoGPT Platform";
   }, []);
 
   return (
     <main className="pt-160 container min-h-screen space-y-4 pb-20 pt-16 sm:px-8 md:px-12">
-      <LibraryPageStateProvider>
-        <LibraryActionHeader />
-        <FavoritesSection />
-        <LibraryAgentList />
-      </LibraryPageStateProvider>
+      <LibraryActionHeader setSearchTerm={setSearchTerm} />
+      <FavoritesSection searchTerm={searchTerm} />
+      <LibraryAgentList
+        searchTerm={searchTerm}
+        librarySort={librarySort}
+        setLibrarySort={setLibrarySort}
+      />
     </main>
   );
 }
diff --git a/autogpt_platform/frontend/src/app/(platform)/marketplace/agent/[creator]/[slug]/page.tsx b/autogpt_platform/frontend/src/app/(platform)/marketplace/agent/[creator]/[slug]/page.tsx
index 124db89385..8106694fe7 100644
--- a/autogpt_platform/frontend/src/app/(platform)/marketplace/agent/[creator]/[slug]/page.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/marketplace/agent/[creator]/[slug]/page.tsx
@@ -1,15 +1,15 @@
-import { Metadata } from "next";
-import { getServerUser } from "@/lib/supabase/server/getServerUser";
+import { prefetchGetV2GetAgentByStoreIdQuery } from "@/app/api/__generated__/endpoints/library/library";
 import {
   getV2GetSpecificAgent,
   prefetchGetV2GetSpecificAgentQuery,
   prefetchGetV2ListStoreAgentsQuery,
 } from "@/app/api/__generated__/endpoints/store/store";
 import { StoreAgentDetails } from "@/app/api/__generated__/models/storeAgentDetails";
-import { MainAgentPage } from "../../../components/MainAgentPage/MainAgentPage";
 import { getQueryClient } from "@/lib/react-query/queryClient";
-import { prefetchGetV2GetAgentByStoreIdQuery } from "@/app/api/__generated__/endpoints/library/library";
+import { getServerUser } from "@/lib/supabase/server/getServerUser";
 import { dehydrate, HydrationBoundary } from "@tanstack/react-query";
+import { Metadata } from "next";
+import { MainAgentPage } from "../../../components/MainAgentPage/MainAgentPage";
 
 export const dynamic = "force-dynamic";
 
diff --git a/autogpt_platform/frontend/src/app/(platform)/marketplace/components/AgentInfo/AgentInfo.tsx b/autogpt_platform/frontend/src/app/(platform)/marketplace/components/AgentInfo/AgentInfo.tsx
index a7a690c67e..8098af7405 100644
--- a/autogpt_platform/frontend/src/app/(platform)/marketplace/components/AgentInfo/AgentInfo.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/marketplace/components/AgentInfo/AgentInfo.tsx
@@ -12,6 +12,7 @@ import type { GetV2GetSpecificAgentParams } from "@/app/api/__generated__/models
 import { useAgentInfo } from "./useAgentInfo";
 import { useGetV2GetSpecificAgent } from "@/app/api/__generated__/endpoints/store/store";
 import { Text } from "@/components/atoms/Text/Text";
+import { formatTimeAgo } from "@/lib/utils/time";
 import * as React from "react";
 
 interface AgentInfoProps {
@@ -258,23 +259,29 @@ export const AgentInfo = ({
           </div>
         </div>
 
-        {/* Changelog */}
+        {/* Version history */}
         <div className="flex w-full flex-col gap-1.5 sm:gap-2">
-          <div className="decoration-skip-ink-none mb-1.5 text-base font-medium leading-6 text-neutral-800 dark:text-neutral-200 sm:mb-2">
-            Changelog
+          <div className="decoration-skip-ink-none text-base font-medium leading-6 text-neutral-800 dark:text-neutral-200">
+            Version history
           </div>
-          <div className="decoration-skip-ink-none text-base font-normal leading-6 text-neutral-600 underline-offset-[from-font] dark:text-neutral-400">
-            Last updated {lastUpdated}
+          <div className="decoration-skip-ink-none text-sm font-normal leading-6 text-neutral-600 underline-offset-[from-font] dark:text-neutral-400">
+            Last updated {formatTimeAgo(lastUpdated)}
+          </div>
+          <div className="decoration-skip-ink-none text-xs text-neutral-600 dark:text-neutral-400 sm:text-sm">
+            Version {version}.0
           </div>
 
           {/* Version List */}
           {agentVersions.length > 0 ? (
-            <div className="mt-4">
+            <div className="mt-3">
+              <div className="decoration-skip-ink-none mb-1.5 text-base font-medium leading-6 text-neutral-900 dark:text-neutral-200 sm:mb-2">
+                Changelog
+              </div>
               {agentVersions.map(renderVersionItem)}
               {hasMoreVersions && (
                 <button
                   onClick={() => setVisibleVersionCount((prev) => prev + 3)}
-                  className="mt-2 flex items-center gap-1 text-sm font-medium text-neutral-900 hover:text-neutral-700 dark:text-neutral-100 dark:hover:text-neutral-300"
+                  className="mt-2 flex items-center gap-1 text-sm font-medium text-neutral-700 hover:text-neutral-700 dark:text-neutral-100 dark:hover:text-neutral-300"
                 >
                   <svg
                     width="16"
@@ -297,7 +304,7 @@ export const AgentInfo = ({
             </div>
           ) : (
             <div className="text-xs text-neutral-600 dark:text-neutral-400 sm:text-sm">
-              Version {version}
+              Version {version}.0
             </div>
           )}
         </div>
diff --git a/autogpt_platform/frontend/src/app/(platform)/marketplace/creator/[creator]/page.tsx b/autogpt_platform/frontend/src/app/(platform)/marketplace/creator/[creator]/page.tsx
index 7d8158b123..e2c9f2ee01 100644
--- a/autogpt_platform/frontend/src/app/(platform)/marketplace/creator/[creator]/page.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/marketplace/creator/[creator]/page.tsx
@@ -1,13 +1,13 @@
-import { getQueryClient } from "@/lib/react-query/queryClient";
 import {
   getV2GetCreatorDetails,
   prefetchGetV2GetCreatorDetailsQuery,
   prefetchGetV2ListStoreAgentsQuery,
 } from "@/app/api/__generated__/endpoints/store/store";
-import { dehydrate, HydrationBoundary } from "@tanstack/react-query";
-import { MainCreatorPage } from "../../components/MainCreatorPage/MainCreatorPage";
-import { Metadata } from "next";
 import { CreatorDetails } from "@/app/api/__generated__/models/creatorDetails";
+import { getQueryClient } from "@/lib/react-query/queryClient";
+import { dehydrate, HydrationBoundary } from "@tanstack/react-query";
+import { Metadata } from "next";
+import { MainCreatorPage } from "../../components/MainCreatorPage/MainCreatorPage";
 
 export const dynamic = "force-dynamic";
 
diff --git a/autogpt_platform/frontend/src/app/(platform)/marketplace/page.tsx b/autogpt_platform/frontend/src/app/(platform)/marketplace/page.tsx
index e95e230377..9b7e6ae93b 100644
--- a/autogpt_platform/frontend/src/app/(platform)/marketplace/page.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/marketplace/page.tsx
@@ -1,11 +1,11 @@
-import { Metadata } from "next";
-import { Suspense } from "react";
 import {
   prefetchGetV2ListStoreAgentsQuery,
   prefetchGetV2ListStoreCreatorsQuery,
 } from "@/app/api/__generated__/endpoints/store/store";
 import { getQueryClient } from "@/lib/react-query/queryClient";
 import { dehydrate, HydrationBoundary } from "@tanstack/react-query";
+import { Metadata } from "next";
+import { Suspense } from "react";
 import { MainMarkeplacePage } from "./components/MainMarketplacePage/MainMarketplacePage";
 import { MainMarketplacePageLoading } from "./components/MainMarketplacePageLoading";
 
@@ -48,11 +48,6 @@ export const metadata: Metadata = {
     description: "Find and use AI Agents created by our community",
     images: ["/images/store-twitter.png"],
   },
-  icons: {
-    icon: "/favicon.ico",
-    shortcut: "/favicon-16x16.png",
-    apple: "/apple-touch-icon.png",
-  },
 };
 
 export default async function MarketplacePage(): Promise<React.ReactElement> {
diff --git a/autogpt_platform/frontend/src/app/(platform)/monitoring/components/AgentFlowList.tsx b/autogpt_platform/frontend/src/app/(platform)/monitoring/components/AgentFlowList.tsx
index d4cb6fc649..badba61bf1 100644
--- a/autogpt_platform/frontend/src/app/(platform)/monitoring/components/AgentFlowList.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/monitoring/components/AgentFlowList.tsx
@@ -120,9 +120,11 @@ export const AgentFlowList = ({
                   lastRun =
                     runCount == 0
                       ? null
-                      : _flowRuns.reduce((a, c) =>
-                          a.started_at > c.started_at ? a : c,
-                        );
+                      : _flowRuns.reduce((a, c) => {
+                          const aTime = a.started_at?.getTime() ?? 0;
+                          const cTime = c.started_at?.getTime() ?? 0;
+                          return aTime > cTime ? a : c;
+                        });
                 }
                 return { flow, runCount, lastRun };
               })
@@ -130,10 +132,9 @@ export const AgentFlowList = ({
                 if (!a.lastRun && !b.lastRun) return 0;
                 if (!a.lastRun) return 1;
                 if (!b.lastRun) return -1;
-                return (
-                  b.lastRun.started_at.getTime() -
-                  a.lastRun.started_at.getTime()
-                );
+                const bTime = b.lastRun.started_at?.getTime() ?? 0;
+                const aTime = a.lastRun.started_at?.getTime() ?? 0;
+                return bTime - aTime;
               })
               .map(({ flow, runCount, lastRun }) => (
                 <TableRow
diff --git a/autogpt_platform/frontend/src/app/(platform)/monitoring/components/FlowRunsStatus.tsx b/autogpt_platform/frontend/src/app/(platform)/monitoring/components/FlowRunsStatus.tsx
index 603982cba5..c545ac2998 100644
--- a/autogpt_platform/frontend/src/app/(platform)/monitoring/components/FlowRunsStatus.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/monitoring/components/FlowRunsStatus.tsx
@@ -29,7 +29,10 @@ export const FlowRunsStatus: React.FC<{
         : statsSince;
   const filteredFlowRuns =
     statsSinceTimestamp != null
-      ? executions.filter((fr) => fr.started_at.getTime() > statsSinceTimestamp)
+      ? executions.filter(
+          (fr) =>
+            fr.started_at && fr.started_at.getTime() > statsSinceTimestamp,
+        )
       : executions;
 
   return (
diff --git a/autogpt_platform/frontend/src/app/(platform)/monitoring/components/FlowRunsTimeline.tsx b/autogpt_platform/frontend/src/app/(platform)/monitoring/components/FlowRunsTimeline.tsx
index 02050627f5..ee01d67234 100644
--- a/autogpt_platform/frontend/src/app/(platform)/monitoring/components/FlowRunsTimeline.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/monitoring/components/FlowRunsTimeline.tsx
@@ -98,40 +98,43 @@ export const FlowRunsTimeline = ({
         <Scatter
           key={flow.id}
           data={executions
-            .filter((e) => e.graph_id == flow.graph_id)
+            .filter((e) => e.graph_id == flow.graph_id && e.started_at)
             .map((e) => ({
               ...e,
               time:
-                e.started_at.getTime() + (e.stats?.node_exec_time ?? 0) * 1000,
+                (e.started_at?.getTime() ?? 0) +
+                (e.stats?.node_exec_time ?? 0) * 1000,
               _duration: e.stats?.node_exec_time ?? 0,
             }))}
           name={flow.name}
           fill={`hsl(${(hashString(flow.id) * 137.5) % 360}, 70%, 50%)`}
         />
       ))}
-      {executions.map((execution) => (
-        <Line
-          key={execution.id}
-          type="linear"
-          dataKey="_duration"
-          data={[
-            {
-              ...execution,
-              time: execution.started_at.getTime(),
-              _duration: 0,
-            },
-            {
-              ...execution,
-              time: execution.ended_at.getTime(),
-              _duration: execution.stats?.node_exec_time ?? 0,
-            },
-          ]}
-          stroke={`hsl(${(hashString(execution.graph_id) * 137.5) % 360}, 70%, 50%)`}
-          strokeWidth={2}
-          dot={false}
-          legendType="none"
-        />
-      ))}
+      {executions
+        .filter((e) => e.started_at && e.ended_at)
+        .map((execution) => (
+          <Line
+            key={execution.id}
+            type="linear"
+            dataKey="_duration"
+            data={[
+              {
+                ...execution,
+                time: execution.started_at!.getTime(),
+                _duration: 0,
+              },
+              {
+                ...execution,
+                time: execution.ended_at!.getTime(),
+                _duration: execution.stats?.node_exec_time ?? 0,
+              },
+            ]}
+            stroke={`hsl(${(hashString(execution.graph_id) * 137.5) % 360}, 70%, 50%)`}
+            strokeWidth={2}
+            dot={false}
+            legendType="none"
+          />
+        ))}
       <Legend
         content={<ScrollableLegend />}
         wrapperStyle={{
diff --git a/autogpt_platform/frontend/src/app/(platform)/monitoring/page.tsx b/autogpt_platform/frontend/src/app/(platform)/monitoring/page.tsx
index 3b5aa46839..4c356dabef 100644
--- a/autogpt_platform/frontend/src/app/(platform)/monitoring/page.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/monitoring/page.tsx
@@ -98,7 +98,11 @@ const Monitor = () => {
           ...(selectedFlow
             ? executions.filter((v) => v.graph_id == selectedFlow.graph_id)
             : executions),
-        ].sort((a, b) => b.started_at.getTime() - a.started_at.getTime())}
+        ].sort((a, b) => {
+          const aTime = a.started_at?.getTime() ?? 0;
+          const bTime = b.started_at?.getTime() ?? 0;
+          return bTime - aTime;
+        })}
         selectedRun={selectedRun}
         onSelectRun={(r) => setSelectedRun(r.id == selectedRun?.id ? null : r)}
       />
diff --git a/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableCard/AgentTableCard.tsx b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableCard/AgentTableCard.tsx
index a8d5d23912..0e1a6ac095 100644
--- a/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableCard/AgentTableCard.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableCard/AgentTableCard.tsx
@@ -18,6 +18,7 @@ export interface AgentTableCardProps {
   runs: number;
   rating: number;
   id: number;
+  listing_id?: string;
   onViewSubmission: (submission: StoreSubmission) => void;
 }
 
@@ -32,10 +33,12 @@ export const AgentTableCard = ({
   status,
   runs,
   rating,
+  listing_id,
   onViewSubmission,
 }: AgentTableCardProps) => {
   const onView = () => {
     onViewSubmission({
+      listing_id: listing_id || "",
       agent_id,
       agent_version,
       slug: "",
@@ -62,9 +65,14 @@ export const AgentTableCard = ({
           />
         </div>
         <div className="flex-1">
-          <h3 className="text-[15px] font-medium text-neutral-800 dark:text-neutral-200">
-            {agentName}
-          </h3>
+          <div className="flex items-center gap-2">
+            <h3 className="text-[15px] font-medium text-neutral-800 dark:text-neutral-200">
+              {agentName}
+            </h3>
+            <span className="text-[13px] text-neutral-500 dark:text-neutral-400">
+              v{agent_version}
+            </span>
+          </div>
           <p className="line-clamp-2 text-sm text-neutral-600 dark:text-neutral-400">
             {description}
           </p>
diff --git a/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableRow/AgentTableRow.tsx b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableRow/AgentTableRow.tsx
index 5b85ade1ae..917b872df1 100644
--- a/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableRow/AgentTableRow.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableRow/AgentTableRow.tsx
@@ -9,11 +9,11 @@ import { useAgentTableRow } from "./useAgentTableRow";
 import { StoreSubmission } from "@/app/api/__generated__/models/storeSubmission";
 import {
   DotsThreeVerticalIcon,
-  Eye,
+  EyeIcon,
   ImageBroken,
-  Star,
-  Trash,
-  PencilSimple,
+  StarIcon,
+  TrashIcon,
+  PencilIcon,
 } from "@phosphor-icons/react/dist/ssr";
 import { SubmissionStatus } from "@/app/api/__generated__/models/submissionStatus";
 import { StoreSubmissionEditRequest } from "@/app/api/__generated__/models/storeSubmissionEditRequest";
@@ -34,6 +34,7 @@ export interface AgentTableRowProps {
   categories?: string[];
   store_listing_version_id?: string;
   changes_summary?: string;
+  listing_id?: string;
   onViewSubmission: (submission: StoreSubmission) => void;
   onDeleteSubmission: (submission_id: string) => void;
   onEditSubmission: (
@@ -60,6 +61,7 @@ export const AgentTableRow = ({
   categories,
   store_listing_version_id,
   changes_summary,
+  listing_id,
   onViewSubmission,
   onDeleteSubmission,
   onEditSubmission,
@@ -83,11 +85,10 @@ export const AgentTableRow = ({
     categories,
     store_listing_version_id,
     changes_summary,
+    listing_id,
   });
 
-  // Determine if we should show Edit or View button
-  const canEdit =
-    status === SubmissionStatus.APPROVED || status === SubmissionStatus.PENDING;
+  const canModify = status === SubmissionStatus.PENDING;
 
   return (
     <div
@@ -114,13 +115,22 @@ export const AgentTableRow = ({
             </div>
           )}
           <div className="flex flex-col">
-            <Text
-              variant="h3"
-              className="line-clamp-1 text-ellipsis text-neutral-800 dark:text-neutral-200"
-              size="large-medium"
-            >
-              {agentName}
-            </Text>
+            <div className="flex items-center gap-2">
+              <Text
+                variant="h3"
+                className="line-clamp-1 text-ellipsis text-neutral-800 dark:text-neutral-200"
+                size="large-medium"
+              >
+                {agentName}
+              </Text>
+              <Text
+                variant="body"
+                size="small"
+                className="text-neutral-500 dark:text-neutral-400"
+              >
+                v{agent_version}
+              </Text>
+            </div>
             <Text
               variant="body"
               className="line-clamp-1 text-ellipsis text-neutral-600 dark:text-neutral-400"
@@ -150,7 +160,7 @@ export const AgentTableRow = ({
           {rating ? (
             <div className="flex items-center justify-end gap-1">
               <span className="text-sm font-medium">{rating.toFixed(1)}</span>
-              <Star weight="fill" className="h-2 w-2" />
+              <StarIcon weight="fill" className="h-2 w-2" />
             </div>
           ) : (
             <span className="text-sm text-neutral-600 dark:text-neutral-400">
@@ -166,12 +176,12 @@ export const AgentTableRow = ({
               <DotsThreeVerticalIcon className="h-5 w-5 text-neutral-800" />
             </DropdownMenu.Trigger>
             <DropdownMenu.Content className="z-10 rounded-xl border bg-white p-1 shadow-md dark:bg-gray-800">
-              {canEdit ? (
+              {canModify ? (
                 <DropdownMenu.Item
                   onSelect={handleEdit}
                   className="flex cursor-pointer items-center rounded-md px-3 py-2 hover:bg-gray-100 dark:hover:bg-gray-700"
                 >
-                  <PencilSimple className="mr-2 h-4 w-4 dark:text-gray-100" />
+                  <PencilIcon className="mr-2 h-4 w-4 dark:text-gray-100" />
                   <span className="dark:text-gray-100">Edit</span>
                 </DropdownMenu.Item>
               ) : (
@@ -179,18 +189,22 @@ export const AgentTableRow = ({
                   onSelect={handleView}
                   className="flex cursor-pointer items-center rounded-md px-3 py-2 hover:bg-gray-100 dark:hover:bg-gray-700"
                 >
-                  <Eye className="mr-2 h-4 w-4 dark:text-gray-100" />
+                  <EyeIcon className="mr-2 h-4 w-4 dark:text-gray-100" />
                   <span className="dark:text-gray-100">View</span>
                 </DropdownMenu.Item>
               )}
-              <DropdownMenu.Separator className="my-1 h-px bg-gray-300 dark:bg-gray-600" />
-              <DropdownMenu.Item
-                onSelect={handleDelete}
-                className="flex cursor-pointer items-center rounded-md px-3 py-2 text-red-500 hover:bg-gray-100 dark:hover:bg-gray-700"
-              >
-                <Trash className="mr-2 h-4 w-4 text-red-500 dark:text-red-400" />
-                <span className="dark:text-red-400">Delete</span>
-              </DropdownMenu.Item>
+              {canModify && (
+                <>
+                  <DropdownMenu.Separator className="my-1 h-px bg-gray-300 dark:bg-gray-600" />
+                  <DropdownMenu.Item
+                    onSelect={handleDelete}
+                    className="flex cursor-pointer items-center rounded-md px-3 py-2 text-red-500 hover:bg-gray-100 dark:hover:bg-gray-700"
+                  >
+                    <TrashIcon className="mr-2 h-4 w-4 text-red-500 dark:text-red-400" />
+                    <span className="dark:text-red-400">Delete</span>
+                  </DropdownMenu.Item>
+                </>
+              )}
             </DropdownMenu.Content>
           </DropdownMenu.Root>
         </div>
diff --git a/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableRow/useAgentTableRow.ts b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableRow/useAgentTableRow.ts
index 14fbac4336..7879446d27 100644
--- a/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableRow/useAgentTableRow.ts
+++ b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableRow/useAgentTableRow.ts
@@ -26,6 +26,7 @@ interface useAgentTableRowProps {
   categories?: string[];
   store_listing_version_id?: string;
   changes_summary?: string;
+  listing_id?: string;
 }
 
 export const useAgentTableRow = ({
@@ -46,9 +47,11 @@ export const useAgentTableRow = ({
   categories,
   store_listing_version_id,
   changes_summary,
+  listing_id,
 }: useAgentTableRowProps) => {
   const handleView = () => {
     onViewSubmission({
+      listing_id: listing_id || "",
       agent_id,
       agent_version,
       slug: "",
@@ -81,7 +84,14 @@ export const useAgentTableRow = ({
   };
 
   const handleDelete = () => {
-    onDeleteSubmission(agent_id);
+    // Backend only accepts StoreListingVersion IDs for deletion
+    if (!store_listing_version_id) {
+      console.error(
+        "Cannot delete submission: store_listing_version_id is required",
+      );
+      return;
+    }
+    onDeleteSubmission(store_listing_version_id);
   };
 
   return { handleView, handleDelete, handleEdit };
diff --git a/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/MainDashboardPage/MainDashboardPage.tsx b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/MainDashboardPage/MainDashboardPage.tsx
index e53244db77..9bfc536d8b 100644
--- a/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/MainDashboardPage/MainDashboardPage.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/MainDashboardPage/MainDashboardPage.tsx
@@ -99,6 +99,7 @@ export const MainDashboardPage = () => {
               store_listing_version_id:
                 submission.store_listing_version_id || undefined,
               changes_summary: submission.changes_summary || undefined,
+              listing_id: submission.listing_id,
             }))}
             onViewSubmission={onViewSubmission}
             onDeleteSubmission={onDeleteSubmission}
diff --git a/autogpt_platform/frontend/src/app/(platform)/profile/(user)/integrations/page.tsx b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/integrations/page.tsx
index 7d8ead9df7..ebea63b0b6 100644
--- a/autogpt_platform/frontend/src/app/(platform)/profile/(user)/integrations/page.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/integrations/page.tsx
@@ -13,7 +13,7 @@ import {
 import { Button } from "@/components/atoms/Button/Button";
 import { Dialog } from "@/components/molecules/Dialog/Dialog";
 import { useToast } from "@/components/molecules/Toast/use-toast";
-import { providerIcons } from "@/components/renderers/input-renderer/fields/CredentialField/helpers";
+import { providerIcons } from "@/components/renderers/InputRenderer/custom/CredentialField/helpers";
 import { CredentialsProviderName } from "@/lib/autogpt-server-api";
 import { useSupabase } from "@/lib/supabase/hooks/useSupabase";
 import { CredentialsProvidersContext } from "@/providers/agent-credentials/credentials-provider";
@@ -116,6 +116,9 @@ export default function UserIntegrationsPage() {
       "63a6e279-2dc2-448e-bf57-85776f7176dc", // ZeroBounce
       "9aa1bde0-4947-4a70-a20c-84daa3850d52", // Google Maps
       "d44045af-1c33-4833-9e19-752313214de2", // Llama API
+      "c4e6d1a0-3b5f-4789-a8e2-9b123456789f", // V0 by Vercel
+      "a5b3c7d9-2e4f-4a6b-8c1d-9e0f1a2b3c4d", // Webshare Proxy
+      "8b3d4e5f-6a7b-8c9d-0e1f-2a3b4c5d6e7f", // OpenWeatherMap
     ],
     [],
   );
diff --git a/autogpt_platform/frontend/src/app/(platform)/profile/(user)/layout.tsx b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/layout.tsx
index ca0e846557..c7b19cfe49 100644
--- a/autogpt_platform/frontend/src/app/(platform)/profile/(user)/layout.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/layout.tsx
@@ -29,7 +29,7 @@ export default function Layout({ children }: { children: React.ReactNode }) {
           href: "/profile/dashboard",
           icon: <StorefrontIcon className="size-5" />,
         },
-        ...(isPaymentEnabled || true
+        ...(isPaymentEnabled
           ? [
               {
                 text: "Billing",
diff --git a/autogpt_platform/frontend/src/app/api/chat/sessions/[sessionId]/stream/route.ts b/autogpt_platform/frontend/src/app/api/chat/sessions/[sessionId]/stream/route.ts
index ca33483587..d63eed0ca2 100644
--- a/autogpt_platform/frontend/src/app/api/chat/sessions/[sessionId]/stream/route.ts
+++ b/autogpt_platform/frontend/src/app/api/chat/sessions/[sessionId]/stream/route.ts
@@ -4,8 +4,91 @@ import { NextRequest } from "next/server";
 
 /**
  * SSE Proxy for chat streaming.
- * EventSource doesn't support custom headers, so we need a server-side proxy
- * that adds authentication and forwards the SSE stream to the client.
+ * Supports POST with context (page content + URL) in the request body.
+ */
+export async function POST(
+  request: NextRequest,
+  { params }: { params: Promise<{ sessionId: string }> },
+) {
+  const { sessionId } = await params;
+
+  try {
+    const body = await request.json();
+    const { message, is_user_message, context } = body;
+
+    if (!message) {
+      return new Response(
+        JSON.stringify({ error: "Missing message parameter" }),
+        { status: 400, headers: { "Content-Type": "application/json" } },
+      );
+    }
+
+    // Get auth token from server-side session
+    const token = await getServerAuthToken();
+
+    // Build backend URL
+    const backendUrl = environment.getAGPTServerBaseUrl();
+    const streamUrl = new URL(
+      `/api/chat/sessions/${sessionId}/stream`,
+      backendUrl,
+    );
+
+    // Forward request to backend with auth header
+    const headers: Record<string, string> = {
+      "Content-Type": "application/json",
+      Accept: "text/event-stream",
+      "Cache-Control": "no-cache",
+      Connection: "keep-alive",
+    };
+
+    if (token) {
+      headers["Authorization"] = `Bearer ${token}`;
+    }
+
+    const response = await fetch(streamUrl.toString(), {
+      method: "POST",
+      headers,
+      body: JSON.stringify({
+        message,
+        is_user_message: is_user_message ?? true,
+        context: context || null,
+      }),
+    });
+
+    if (!response.ok) {
+      const error = await response.text();
+      return new Response(error, {
+        status: response.status,
+        headers: { "Content-Type": "application/json" },
+      });
+    }
+
+    // Return the SSE stream directly
+    return new Response(response.body, {
+      headers: {
+        "Content-Type": "text/event-stream",
+        "Cache-Control": "no-cache, no-transform",
+        Connection: "keep-alive",
+        "X-Accel-Buffering": "no",
+      },
+    });
+  } catch (error) {
+    console.error("SSE proxy error:", error);
+    return new Response(
+      JSON.stringify({
+        error: "Failed to connect to chat service",
+        detail: error instanceof Error ? error.message : String(error),
+      }),
+      {
+        status: 500,
+        headers: { "Content-Type": "application/json" },
+      },
+    );
+  }
+}
+
+/**
+ * Legacy GET endpoint for backward compatibility
  */
 export async function GET(
   request: NextRequest,
diff --git a/autogpt_platform/frontend/src/app/api/mutators/custom-mutator.ts b/autogpt_platform/frontend/src/app/api/mutators/custom-mutator.ts
index 315b68ab87..4578ac03fe 100644
--- a/autogpt_platform/frontend/src/app/api/mutators/custom-mutator.ts
+++ b/autogpt_platform/frontend/src/app/api/mutators/custom-mutator.ts
@@ -41,11 +41,9 @@ export const customMutator = async <
   T extends { data: any; status: number; headers: Headers },
 >(
   url: string,
-  options: RequestInit & {
-    params?: any;
-  } = {},
+  options: RequestInit,
 ): Promise<T> => {
-  const { params, ...requestOptions } = options;
+  const requestOptions = options;
   const method = (requestOptions.method || "GET") as
     | "GET"
     | "POST"
@@ -87,14 +85,11 @@ export const customMutator = async <
     headers["Content-Type"] = "application/json";
   }
 
-  const queryString = params
-    ? "?" + new URLSearchParams(params).toString()
-    : "";
-
   const baseUrl = getBaseUrl();
 
   // The caching in React Query in our system depends on the url, so the base_url could be different for the server and client sides.
-  const fullUrl = `${baseUrl}${url}${queryString}`;
+  // here url also contains encoded query params
+  const fullUrl = `${baseUrl}${url}`;
 
   if (environment.isServerSide()) {
     try {
diff --git a/autogpt_platform/frontend/src/app/api/openapi.json b/autogpt_platform/frontend/src/app/api/openapi.json
index ea3bbcc5d8..fc4e737651 100644
--- a/autogpt_platform/frontend/src/app/api/openapi.json
+++ b/autogpt_platform/frontend/src/app/api/openapi.json
@@ -921,7 +921,7 @@
       "get": {
         "tags": ["v2", "chat", "chat"],
         "summary": "Health Check",
-        "description": "Health check endpoint for the chat service.\n\nPerforms a full cycle test of session creation, assignment, and retrieval. Should always return healthy\nif the service and data layer are operational.\n\nReturns:\n    dict: A status dictionary indicating health, service name, and API version.",
+        "description": "Health check endpoint for the chat service.\n\nPerforms a full cycle test of session creation and retrieval. Should always return healthy\nif the service and data layer are operational.\n\nReturns:\n    dict: A status dictionary indicating health, service name, and API version.",
         "operationId": "getV2HealthCheck",
         "responses": {
           "200": {
@@ -940,11 +940,67 @@
       }
     },
     "/api/chat/sessions": {
+      "get": {
+        "tags": ["v2", "chat", "chat"],
+        "summary": "List Sessions",
+        "description": "List chat sessions for the authenticated user.\n\nReturns a paginated list of chat sessions belonging to the current user,\nordered by most recently updated.\n\nArgs:\n    user_id: The authenticated user's ID.\n    limit: Maximum number of sessions to return (1-100).\n    offset: Number of sessions to skip for pagination.\n\nReturns:\n    ListSessionsResponse: List of session summaries and total count.",
+        "operationId": "getV2ListSessions",
+        "security": [{ "HTTPBearerJWT": [] }],
+        "parameters": [
+          {
+            "name": "limit",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "maximum": 100,
+              "minimum": 1,
+              "default": 50,
+              "title": "Limit"
+            }
+          },
+          {
+            "name": "offset",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "minimum": 0,
+              "default": 0,
+              "title": "Offset"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ListSessionsResponse"
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/HTTP401NotAuthenticatedError"
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": { "$ref": "#/components/schemas/HTTPValidationError" }
+              }
+            }
+          }
+        }
+      },
       "post": {
         "tags": ["v2", "chat", "chat"],
         "summary": "Create Session",
-        "description": "Create a new chat session.\n\nInitiates a new chat session for either an authenticated or anonymous user.\n\nArgs:\n    user_id: The optional authenticated user ID parsed from the JWT. If missing, creates an anonymous session.\n\nReturns:\n    CreateSessionResponse: Details of the created session.",
+        "description": "Create a new chat session.\n\nInitiates a new chat session for the authenticated user.\n\nArgs:\n    user_id: The authenticated user ID parsed from the JWT (required).\n\nReturns:\n    CreateSessionResponse: Details of the created session.",
         "operationId": "postV2CreateSession",
+        "security": [{ "HTTPBearerJWT": [] }],
         "responses": {
           "200": {
             "description": "Successful Response",
@@ -959,8 +1015,7 @@
           "401": {
             "$ref": "#/components/responses/HTTP401NotAuthenticatedError"
           }
-        },
-        "security": [{ "HTTPBearerJWT": [] }]
+        }
       }
     },
     "/api/chat/sessions/{session_id}": {
@@ -1048,9 +1103,9 @@
     "/api/chat/sessions/{session_id}/stream": {
       "get": {
         "tags": ["v2", "chat", "chat"],
-        "summary": "Stream Chat",
-        "description": "Stream chat responses for a session.\n\nStreams the AI/completion responses in real time over Server-Sent Events (SSE), including:\n  - Text fragments as they are generated\n  - Tool call UI elements (if invoked)\n  - Tool execution results\n\nArgs:\n    session_id: The chat session identifier to associate with the streamed messages.\n    message: The user's new message to process.\n    user_id: Optional authenticated user ID.\n    is_user_message: Whether the message is a user message.\nReturns:\n    StreamingResponse: SSE-formatted response chunks.",
-        "operationId": "getV2StreamChat",
+        "summary": "Stream Chat Get",
+        "description": "Stream chat responses for a session (GET - legacy endpoint).\n\nStreams the AI/completion responses in real time over Server-Sent Events (SSE), including:\n  - Text fragments as they are generated\n  - Tool call UI elements (if invoked)\n  - Tool execution results\n\nArgs:\n    session_id: The chat session identifier to associate with the streamed messages.\n    message: The user's new message to process.\n    user_id: Optional authenticated user ID.\n    is_user_message: Whether the message is a user message.\nReturns:\n    StreamingResponse: SSE-formatted response chunks.",
+        "operationId": "getV2StreamChatGet",
         "security": [{ "HTTPBearerJWT": [] }],
         "parameters": [
           {
@@ -1098,6 +1153,46 @@
             }
           }
         }
+      },
+      "post": {
+        "tags": ["v2", "chat", "chat"],
+        "summary": "Stream Chat Post",
+        "description": "Stream chat responses for a session (POST with context support).\n\nStreams the AI/completion responses in real time over Server-Sent Events (SSE), including:\n  - Text fragments as they are generated\n  - Tool call UI elements (if invoked)\n  - Tool execution results\n\nArgs:\n    session_id: The chat session identifier to associate with the streamed messages.\n    request: Request body containing message, is_user_message, and optional context.\n    user_id: Optional authenticated user ID.\nReturns:\n    StreamingResponse: SSE-formatted response chunks.",
+        "operationId": "postV2StreamChatPost",
+        "security": [{ "HTTPBearerJWT": [] }],
+        "parameters": [
+          {
+            "name": "session_id",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string", "title": "Session Id" }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": { "$ref": "#/components/schemas/StreamChatRequest" }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": { "application/json": { "schema": {} } }
+          },
+          "401": {
+            "$ref": "#/components/responses/HTTP401NotAuthenticatedError"
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": { "$ref": "#/components/schemas/HTTPValidationError" }
+              }
+            }
+          }
+        }
       }
     },
     "/api/credits": {
@@ -2775,6 +2870,28 @@
         }
       }
     },
+    "/api/integrations/providers/system": {
+      "get": {
+        "tags": ["v1", "integrations"],
+        "summary": "List System Providers",
+        "description": "Get a list of providers that have platform credits (system credentials) available.\n\nThese providers can be used without the user providing their own API keys.",
+        "operationId": "getV1ListSystemProviders",
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "items": { "type": "string" },
+                  "type": "array",
+                  "title": "Response Getv1Listsystemproviders"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/integrations/webhooks/{webhook_id}/ping": {
       "post": {
         "tags": ["v1", "integrations"],
@@ -5504,6 +5621,69 @@
         "security": [{ "HTTPBearerJWT": [] }]
       }
     },
+    "/api/store/search": {
+      "get": {
+        "tags": ["v2", "store", "public"],
+        "summary": "Unified search across all content types",
+        "description": "Search across all content types (store agents, blocks, documentation) using hybrid search.\n\nCombines semantic (embedding-based) and lexical (text-based) search for best results.\n\nArgs:\n    query: The search query string\n    content_types: Optional list of content types to filter by (STORE_AGENT, BLOCK, DOCUMENTATION)\n    page: Page number for pagination (default 1)\n    page_size: Number of results per page (default 20)\n    user_id: Optional authenticated user ID (for user-scoped content in future)\n\nReturns:\n    UnifiedSearchResponse: Paginated list of search results with relevance scores",
+        "operationId": "getV2Unified search across all content types",
+        "security": [{ "HTTPBearer": [] }],
+        "parameters": [
+          {
+            "name": "query",
+            "in": "query",
+            "required": true,
+            "schema": { "type": "string", "title": "Query" }
+          },
+          {
+            "name": "content_types",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                { "type": "array", "items": { "type": "string" } },
+                { "type": "null" }
+              ],
+              "description": "Content types to search: STORE_AGENT, BLOCK, DOCUMENTATION. If not specified, searches all.",
+              "title": "Content Types"
+            },
+            "description": "Content types to search: STORE_AGENT, BLOCK, DOCUMENTATION. If not specified, searches all."
+          },
+          {
+            "name": "page",
+            "in": "query",
+            "required": false,
+            "schema": { "type": "integer", "default": 1, "title": "Page" }
+          },
+          {
+            "name": "page_size",
+            "in": "query",
+            "required": false,
+            "schema": { "type": "integer", "default": 20, "title": "Page Size" }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UnifiedSearchResponse"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": { "$ref": "#/components/schemas/HTTPValidationError" }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/store/submissions": {
       "get": {
         "tags": ["v2", "store", "private"],
@@ -6968,6 +7148,20 @@
           "error_message": {
             "anyOf": [{ "type": "string" }, { "type": "null" }],
             "title": "Error Message"
+          },
+          "started_at": {
+            "anyOf": [
+              { "type": "string", "format": "date-time" },
+              { "type": "null" }
+            ],
+            "title": "Started At"
+          },
+          "ended_at": {
+            "anyOf": [
+              { "type": "string", "format": "date-time" },
+              { "type": "null" }
+            ],
+            "title": "Ended At"
           }
         },
         "type": "object",
@@ -7074,14 +7268,20 @@
           },
           "status": { "$ref": "#/components/schemas/AgentExecutionStatus" },
           "started_at": {
-            "type": "string",
-            "format": "date-time",
-            "title": "Started At"
+            "anyOf": [
+              { "type": "string", "format": "date-time" },
+              { "type": "null" }
+            ],
+            "title": "Started At",
+            "description": "When execution started running. Null if not yet started (QUEUED)."
           },
           "ended_at": {
-            "type": "string",
-            "format": "date-time",
-            "title": "Ended At"
+            "anyOf": [
+              { "type": "string", "format": "date-time" },
+              { "type": "null" }
+            ],
+            "title": "Ended At",
+            "description": "When execution finished. Null if not yet completed (QUEUED, RUNNING, INCOMPLETE, REVIEW)."
           },
           "is_shared": {
             "type": "boolean",
@@ -7115,8 +7315,6 @@
           "nodes_input_masks",
           "preset_id",
           "status",
-          "started_at",
-          "ended_at",
           "stats",
           "outputs"
         ],
@@ -7215,14 +7413,20 @@
           },
           "status": { "$ref": "#/components/schemas/AgentExecutionStatus" },
           "started_at": {
-            "type": "string",
-            "format": "date-time",
-            "title": "Started At"
+            "anyOf": [
+              { "type": "string", "format": "date-time" },
+              { "type": "null" }
+            ],
+            "title": "Started At",
+            "description": "When execution started running. Null if not yet started (QUEUED)."
           },
           "ended_at": {
-            "type": "string",
-            "format": "date-time",
-            "title": "Ended At"
+            "anyOf": [
+              { "type": "string", "format": "date-time" },
+              { "type": "null" }
+            ],
+            "title": "Ended At",
+            "description": "When execution finished. Null if not yet completed (QUEUED, RUNNING, INCOMPLETE, REVIEW)."
           },
           "is_shared": {
             "type": "boolean",
@@ -7251,8 +7455,6 @@
           "nodes_input_masks",
           "preset_id",
           "status",
-          "started_at",
-          "ended_at",
           "stats"
         ],
         "title": "GraphExecutionMeta"
@@ -7299,14 +7501,20 @@
           },
           "status": { "$ref": "#/components/schemas/AgentExecutionStatus" },
           "started_at": {
-            "type": "string",
-            "format": "date-time",
-            "title": "Started At"
+            "anyOf": [
+              { "type": "string", "format": "date-time" },
+              { "type": "null" }
+            ],
+            "title": "Started At",
+            "description": "When execution started running. Null if not yet started (QUEUED)."
           },
           "ended_at": {
-            "type": "string",
-            "format": "date-time",
-            "title": "Ended At"
+            "anyOf": [
+              { "type": "string", "format": "date-time" },
+              { "type": "null" }
+            ],
+            "title": "Ended At",
+            "description": "When execution finished. Null if not yet completed (QUEUED, RUNNING, INCOMPLETE, REVIEW)."
           },
           "is_shared": {
             "type": "boolean",
@@ -7345,8 +7553,6 @@
           "nodes_input_masks",
           "preset_id",
           "status",
-          "started_at",
-          "ended_at",
           "stats",
           "outputs",
           "node_executions"
@@ -7665,6 +7871,7 @@
           "id": { "type": "string", "title": "Id" },
           "graph_id": { "type": "string", "title": "Graph Id" },
           "graph_version": { "type": "integer", "title": "Graph Version" },
+          "owner_user_id": { "type": "string", "title": "Owner User Id" },
           "image_url": {
             "anyOf": [{ "type": "string" }, { "type": "null" }],
             "title": "Image Url"
@@ -7747,6 +7954,7 @@
           "id",
           "graph_id",
           "graph_version",
+          "owner_user_id",
           "image_url",
           "creator_name",
           "creator_image_url",
@@ -8017,6 +8225,20 @@
         "required": ["source_id", "sink_id", "source_name", "sink_name"],
         "title": "Link"
       },
+      "ListSessionsResponse": {
+        "properties": {
+          "sessions": {
+            "items": { "$ref": "#/components/schemas/SessionSummaryResponse" },
+            "type": "array",
+            "title": "Sessions"
+          },
+          "total": { "type": "integer", "title": "Total" }
+        },
+        "type": "object",
+        "required": ["sessions", "total"],
+        "title": "ListSessionsResponse",
+        "description": "Response model for listing chat sessions."
+      },
       "LogRawMetricRequest": {
         "properties": {
           "metric_name": {
@@ -9346,6 +9568,21 @@
         "title": "SessionDetailResponse",
         "description": "Response model providing complete details for a chat session, including messages."
       },
+      "SessionSummaryResponse": {
+        "properties": {
+          "id": { "type": "string", "title": "Id" },
+          "created_at": { "type": "string", "title": "Created At" },
+          "updated_at": { "type": "string", "title": "Updated At" },
+          "title": {
+            "anyOf": [{ "type": "string" }, { "type": "null" }],
+            "title": "Title"
+          }
+        },
+        "type": "object",
+        "required": ["id", "created_at", "updated_at"],
+        "title": "SessionSummaryResponse",
+        "description": "Response model for a session summary (without messages)."
+      },
       "SetGraphActiveVersion": {
         "properties": {
           "active_graph_version": {
@@ -9686,6 +9923,7 @@
       },
       "StoreSubmission": {
         "properties": {
+          "listing_id": { "type": "string", "title": "Listing Id" },
           "agent_id": { "type": "string", "title": "Agent Id" },
           "agent_version": { "type": "integer", "title": "Agent Version" },
           "name": { "type": "string", "title": "Name" },
@@ -9757,6 +9995,7 @@
         },
         "type": "object",
         "required": [
+          "listing_id",
           "agent_id",
           "agent_version",
           "name",
@@ -9819,8 +10058,18 @@
       },
       "StoreSubmissionRequest": {
         "properties": {
-          "agent_id": { "type": "string", "title": "Agent Id" },
-          "agent_version": { "type": "integer", "title": "Agent Version" },
+          "agent_id": {
+            "type": "string",
+            "minLength": 1,
+            "title": "Agent Id",
+            "description": "Agent ID cannot be empty"
+          },
+          "agent_version": {
+            "type": "integer",
+            "exclusiveMinimum": 0.0,
+            "title": "Agent Version",
+            "description": "Agent version must be greater than 0"
+          },
           "slug": { "type": "string", "title": "Slug" },
           "name": { "type": "string", "title": "Name" },
           "sub_heading": { "type": "string", "title": "Sub Heading" },
@@ -9885,6 +10134,30 @@
         "required": ["submissions", "pagination"],
         "title": "StoreSubmissionsResponse"
       },
+      "StreamChatRequest": {
+        "properties": {
+          "message": { "type": "string", "title": "Message" },
+          "is_user_message": {
+            "type": "boolean",
+            "title": "Is User Message",
+            "default": true
+          },
+          "context": {
+            "anyOf": [
+              {
+                "additionalProperties": { "type": "string" },
+                "type": "object"
+              },
+              { "type": "null" }
+            ],
+            "title": "Context"
+          }
+        },
+        "type": "object",
+        "required": ["message"],
+        "title": "StreamChatRequest",
+        "description": "Request model for streaming chat with optional context."
+      },
       "SubmissionStatus": {
         "type": "string",
         "enum": ["DRAFT", "PENDING", "APPROVED", "REJECTED"],
@@ -10715,6 +10988,57 @@
         "required": ["name", "graph_id", "graph_version", "trigger_config"],
         "title": "TriggeredPresetSetupRequest"
       },
+      "UnifiedSearchResponse": {
+        "properties": {
+          "results": {
+            "items": { "$ref": "#/components/schemas/UnifiedSearchResult" },
+            "type": "array",
+            "title": "Results"
+          },
+          "pagination": { "$ref": "#/components/schemas/Pagination" }
+        },
+        "type": "object",
+        "required": ["results", "pagination"],
+        "title": "UnifiedSearchResponse",
+        "description": "Response model for unified search across all content types."
+      },
+      "UnifiedSearchResult": {
+        "properties": {
+          "content_type": { "type": "string", "title": "Content Type" },
+          "content_id": { "type": "string", "title": "Content Id" },
+          "searchable_text": { "type": "string", "title": "Searchable Text" },
+          "metadata": {
+            "anyOf": [
+              { "additionalProperties": true, "type": "object" },
+              { "type": "null" }
+            ],
+            "title": "Metadata"
+          },
+          "updated_at": {
+            "anyOf": [
+              { "type": "string", "format": "date-time" },
+              { "type": "null" }
+            ],
+            "title": "Updated At"
+          },
+          "combined_score": {
+            "anyOf": [{ "type": "number" }, { "type": "null" }],
+            "title": "Combined Score"
+          },
+          "semantic_score": {
+            "anyOf": [{ "type": "number" }, { "type": "null" }],
+            "title": "Semantic Score"
+          },
+          "lexical_score": {
+            "anyOf": [{ "type": "number" }, { "type": "null" }],
+            "title": "Lexical Score"
+          }
+        },
+        "type": "object",
+        "required": ["content_type", "content_id", "searchable_text"],
+        "title": "UnifiedSearchResult",
+        "description": "A single result from unified hybrid search across all content types."
+      },
       "UpdateAppLogoRequest": {
         "properties": {
           "logo_url": {
@@ -11679,6 +12003,7 @@
         "in": "header",
         "name": "X-Postmark-Webhook-Token"
       },
+      "HTTPBearer": { "type": "http", "scheme": "bearer" },
       "HTTPBearerJWT": {
         "type": "http",
         "scheme": "bearer",
diff --git a/autogpt_platform/frontend/src/app/global-error.tsx b/autogpt_platform/frontend/src/app/global-error.tsx
index 07b22f1c15..5391c2e433 100644
--- a/autogpt_platform/frontend/src/app/global-error.tsx
+++ b/autogpt_platform/frontend/src/app/global-error.tsx
@@ -1,16 +1,15 @@
 "use client";
 
-import * as Sentry from "@sentry/nextjs";
 import { ErrorCard } from "@/components/molecules/ErrorCard/ErrorCard";
+import * as Sentry from "@sentry/nextjs";
 import { useEffect } from "react";
 
-export default function GlobalError({
-  error,
-  reset,
-}: {
+interface Props {
   error: Error & { digest?: string };
   reset: () => void;
-}) {
+}
+
+export default function GlobalError({ error, reset }: Props) {
   useEffect(() => {
     Sentry.captureException(error);
   }, [error]);
diff --git a/autogpt_platform/frontend/src/app/globals.css b/autogpt_platform/frontend/src/app/globals.css
index 1f782f753b..0625c26082 100644
--- a/autogpt_platform/frontend/src/app/globals.css
+++ b/autogpt_platform/frontend/src/app/globals.css
@@ -141,6 +141,52 @@
   }
 }
 
+@keyframes shimmer {
+  0% {
+    background-position: -200% 0;
+  }
+  100% {
+    background-position: 200% 0;
+  }
+}
+
+@keyframes l3 {
+  25% {
+    background-position:
+      0 0,
+      100% 100%,
+      100% calc(100% - 5px);
+  }
+  50% {
+    background-position:
+      0 100%,
+      100% 100%,
+      0 calc(100% - 5px);
+  }
+  75% {
+    background-position:
+      0 100%,
+      100% 0,
+      100% 5px;
+  }
+}
+
+.loader {
+  width: 80px;
+  height: 70px;
+  border: 5px solid rgb(241 245 249);
+  padding: 0 8px;
+  box-sizing: border-box;
+  background:
+    linear-gradient(rgb(15 23 42) 0 0) 0 0/8px 20px,
+    linear-gradient(rgb(15 23 42) 0 0) 100% 0/8px 20px,
+    radial-gradient(farthest-side, rgb(15 23 42) 90%, #0000) 0 5px/8px 8px
+      content-box,
+    transparent;
+  background-repeat: no-repeat;
+  animation: l3 2s infinite linear;
+}
+
 input[type="number"]::-webkit-outer-spin-button,
 input[type="number"]::-webkit-inner-spin-button {
   -webkit-appearance: none;
diff --git a/autogpt_platform/frontend/src/app/layout.tsx b/autogpt_platform/frontend/src/app/layout.tsx
index ff2590dc61..1836b1d4f2 100644
--- a/autogpt_platform/frontend/src/app/layout.tsx
+++ b/autogpt_platform/frontend/src/app/layout.tsx
@@ -15,9 +15,21 @@ import { environment } from "@/services/environment";
 import { ReactQueryDevtools } from "@tanstack/react-query-devtools";
 import { headers } from "next/headers";
 
+const isDev = environment.isDev();
+const isLocal = environment.isLocal();
+
+const faviconPath = isDev
+  ? "/favicon-dev.ico"
+  : isLocal
+    ? "/favicon-local.ico"
+    : "/favicon.ico";
+
 export const metadata: Metadata = {
   title: "AutoGPT Platform",
   description: "Your one stop shop to creating AI Agents",
+  icons: {
+    icon: faviconPath,
+  },
 };
 
 export default async function RootLayout({
@@ -27,8 +39,6 @@ export default async function RootLayout({
 }>) {
   const headersList = await headers();
   const host = headersList.get("host") || "";
-  const isDev = environment.isDev();
-  const isLocal = environment.isLocal();
 
   return (
     <html
@@ -37,16 +47,6 @@ export default async function RootLayout({
       suppressHydrationWarning
     >
       <head>
-        <link
-          rel="icon"
-          href={
-            isLocal
-              ? "/favicon-local.ico"
-              : isDev
-                ? "/favicon-dev.ico"
-                : "/favicon.ico"
-          }
-        />
         <SetupAnalytics
           host={host}
           ga={{
@@ -54,7 +54,7 @@ export default async function RootLayout({
           }}
         />
       </head>
-      <body>
+      <body className="min-h-screen">
         <ErrorBoundary context="application">
           <Providers
             attribute="class"
diff --git a/autogpt_platform/frontend/src/components/atoms/Button/Button.tsx b/autogpt_platform/frontend/src/components/atoms/Button/Button.tsx
index de1dec2d25..ab7b90e098 100644
--- a/autogpt_platform/frontend/src/components/atoms/Button/Button.tsx
+++ b/autogpt_platform/frontend/src/components/atoms/Button/Button.tsx
@@ -20,6 +20,7 @@ export function Button(props: ButtonProps) {
     rightIcon,
     children,
     as = "button",
+    asChild: _asChild, // Destructure to prevent passing to DOM
     ...restProps
   } = props;
 
diff --git a/autogpt_platform/frontend/src/components/atoms/Button/helpers.ts b/autogpt_platform/frontend/src/components/atoms/Button/helpers.ts
index 4d9706838c..27594bf4e3 100644
--- a/autogpt_platform/frontend/src/components/atoms/Button/helpers.ts
+++ b/autogpt_platform/frontend/src/components/atoms/Button/helpers.ts
@@ -32,7 +32,7 @@ export const extendedButtonVariants = cva(
         ),
       },
       size: {
-        small: "px-3 py-2 text-sm gap-1.5 h-[2.25rem]",
+        small: "px-3 py-2 text-sm gap-1.5 h-[2.25rem] min-w-[5.5rem]",
         large: "px-4 py-3 text-sm gap-2 h-[3.25rem]",
         icon: "p-3 !min-w-0",
       },
diff --git a/autogpt_platform/frontend/src/components/atoms/Input/Input.tsx b/autogpt_platform/frontend/src/components/atoms/Input/Input.tsx
index f59c01e77d..413ecf5d33 100644
--- a/autogpt_platform/frontend/src/components/atoms/Input/Input.tsx
+++ b/autogpt_platform/frontend/src/components/atoms/Input/Input.tsx
@@ -92,7 +92,7 @@ export function Input({
           className={cn(
             baseStyles,
             errorStyles,
-            "-mb-1 h-auto min-h-[2.875rem] rounded-medium",
+            "-mb-1 h-auto min-h-[2.875rem] rounded-3xl",
             // Size variants for textarea
             size === "small" && [
               "min-h-[2.25rem]", // 36px minimum
@@ -107,6 +107,11 @@ export function Input({
           )}
           placeholder={placeholder || label}
           onChange={handleTextareaChange}
+          onKeyDown={
+            props.onKeyDown as
+              | React.KeyboardEventHandler<HTMLTextAreaElement>
+              | undefined
+          }
           rows={props.rows || 3}
           {...(hideLabel ? { "aria-label": label } : {})}
           id={props.id}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/CredentialsInputs.tsx b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/CredentialsInput.tsx
similarity index 54%
rename from autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/CredentialsInputs.tsx
rename to autogpt_platform/frontend/src/components/contextual/CredentialsInput/CredentialsInput.tsx
index 07350fb610..eba814fe08 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/CredentialsInputs.tsx
+++ b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/CredentialsInput.tsx
@@ -1,6 +1,6 @@
-import { Button } from "@/components/atoms/Button/Button";
+"use client";
+
 import { Text } from "@/components/atoms/Text/Text";
-import { InformationTooltip } from "@/components/molecules/InformationTooltip/InformationTooltip";
 import {
   BlockIOCredentialsSubSchema,
   CredentialsMetaInput,
@@ -8,13 +8,11 @@ import {
 import { cn } from "@/lib/utils";
 import { toDisplayName } from "@/providers/agent-credentials/helper";
 import { APIKeyCredentialsModal } from "./components/APIKeyCredentialsModal/APIKeyCredentialsModal";
-import { CredentialRow } from "./components/CredentialRow/CredentialRow";
-import { CredentialsSelect } from "./components/CredentialsSelect/CredentialsSelect";
-import { DeleteConfirmationModal } from "./components/DeleteConfirmationModal/DeleteConfirmationModal";
+import { CredentialsFlatView } from "./components/CredentialsFlatView/CredentialsFlatView";
 import { HostScopedCredentialsModal } from "./components/HotScopedCredentialsModal/HotScopedCredentialsModal";
 import { OAuthFlowWaitingModal } from "./components/OAuthWaitingModal/OAuthWaitingModal";
 import { PasswordCredentialsModal } from "./components/PasswordCredentialsModal/PasswordCredentialsModal";
-import { getCredentialDisplayName } from "./helpers";
+import { isSystemCredential } from "./helpers";
 import {
   CredentialsInputState,
   useCredentialsInput,
@@ -34,7 +32,9 @@ type Props = {
   onSelectCredentials: (newValue?: CredentialsMetaInput) => void;
   onLoaded?: (loaded: boolean) => void;
   readOnly?: boolean;
+  isOptional?: boolean;
   showTitle?: boolean;
+  variant?: "default" | "node";
 };
 
 export function CredentialsInput({
@@ -45,7 +45,9 @@ export function CredentialsInput({
   siblingInputs,
   onLoaded,
   readOnly = false,
+  isOptional = false,
   showTitle = true,
+  variant = "default",
 }: Props) {
   const hookData = useCredentialsInput({
     schema,
@@ -54,6 +56,7 @@ export function CredentialsInput({
     siblingInputs,
     onLoaded,
     readOnly,
+    isOptional,
   });
 
   if (!isLoaded(hookData)) {
@@ -67,103 +70,53 @@ export function CredentialsInput({
     supportsOAuth2,
     supportsUserPassword,
     supportsHostScoped,
-    credentialsToShow,
+    userCredentials,
+    systemCredentials,
     oAuthError,
     isAPICredentialsModalOpen,
     isUserPasswordCredentialsModalOpen,
     isHostScopedCredentialsModalOpen,
     isOAuth2FlowInProgress,
     oAuthPopupController,
-    credentialToDelete,
-    deleteCredentialsMutation,
     actionButtonText,
     setAPICredentialsModalOpen,
     setUserPasswordCredentialsModalOpen,
     setHostScopedCredentialsModalOpen,
-    setCredentialToDelete,
     handleActionButtonClick,
     handleCredentialSelect,
-    handleDeleteCredential,
-    handleDeleteConfirm,
   } = hookData;
 
   const displayName = toDisplayName(provider);
-  const hasCredentialsToShow = credentialsToShow.length > 0;
+  const selectedCredentialIsSystem =
+    selectedCredential && isSystemCredential(selectedCredential);
+
+  const allCredentials = [...userCredentials, ...systemCredentials];
+
+  if (readOnly && selectedCredentialIsSystem) {
+    return null;
+  }
 
   return (
     <div className={cn("mb-6", className)}>
-      {showTitle && (
-        <div className="mb-2 flex items-center gap-2">
-          <Text variant="large-medium">{displayName} credentials</Text>
-          {schema.description && (
-            <InformationTooltip description={schema.description} />
-          )}
-        </div>
-      )}
-
-      {hasCredentialsToShow ? (
-        <>
-          {credentialsToShow.length > 1 && !readOnly ? (
-            <CredentialsSelect
-              credentials={credentialsToShow}
-              provider={provider}
-              displayName={displayName}
-              selectedCredentials={selectedCredential}
-              onSelectCredential={handleCredentialSelect}
-              readOnly={readOnly}
-            />
-          ) : (
-            <div className="mb-4 space-y-2">
-              {credentialsToShow.map((credential) => {
-                return (
-                  <CredentialRow
-                    key={credential.id}
-                    credential={credential}
-                    provider={provider}
-                    displayName={displayName}
-                    onSelect={() => handleCredentialSelect(credential.id)}
-                    onDelete={() =>
-                      handleDeleteCredential({
-                        id: credential.id,
-                        title: getCredentialDisplayName(
-                          credential,
-                          displayName,
-                        ),
-                      })
-                    }
-                    readOnly={readOnly}
-                  />
-                );
-              })}
-            </div>
-          )}
-          {!readOnly && (
-            <Button
-              variant="secondary"
-              size="small"
-              onClick={handleActionButtonClick}
-              className="w-fit"
-            >
-              {actionButtonText}
-            </Button>
-          )}
-        </>
-      ) : (
-        !readOnly && (
-          <Button
-            variant="secondary"
-            size="small"
-            onClick={handleActionButtonClick}
-            className="w-fit"
-          >
-            {actionButtonText}
-          </Button>
-        )
-      )}
+      <CredentialsFlatView
+        schema={schema}
+        provider={provider}
+        displayName={displayName}
+        credentials={allCredentials}
+        selectedCredential={selectedCredential}
+        onSelectCredential={handleCredentialSelect}
+        onClearCredential={() => onSelectCredential(undefined)}
+        onAddCredential={handleActionButtonClick}
+        actionButtonText={actionButtonText}
+        isOptional={isOptional}
+        showTitle={showTitle}
+        readOnly={readOnly}
+        variant={variant}
+      />
 
       {!readOnly && (
         <>
-          {supportsApiKey ? (
+          {supportsApiKey && (
             <APIKeyCredentialsModal
               schema={schema}
               open={isAPICredentialsModalOpen}
@@ -174,15 +127,15 @@ export function CredentialsInput({
               }}
               siblingInputs={siblingInputs}
             />
-          ) : null}
-          {supportsOAuth2 ? (
+          )}
+          {supportsOAuth2 && (
             <OAuthFlowWaitingModal
               open={isOAuth2FlowInProgress}
               onClose={() => oAuthPopupController?.abort("canceled")}
               providerName={providerName}
             />
-          ) : null}
-          {supportsUserPassword ? (
+          )}
+          {supportsUserPassword && (
             <PasswordCredentialsModal
               schema={schema}
               open={isUserPasswordCredentialsModalOpen}
@@ -193,8 +146,8 @@ export function CredentialsInput({
               }}
               siblingInputs={siblingInputs}
             />
-          ) : null}
-          {supportsHostScoped ? (
+          )}
+          {supportsHostScoped && (
             <HostScopedCredentialsModal
               schema={schema}
               open={isHostScopedCredentialsModalOpen}
@@ -205,20 +158,13 @@ export function CredentialsInput({
               }}
               siblingInputs={siblingInputs}
             />
-          ) : null}
+          )}
 
-          {oAuthError ? (
+          {oAuthError && (
             <Text variant="body" className="mt-2 text-red-500">
               Error: {oAuthError}
             </Text>
-          ) : null}
-
-          <DeleteConfirmationModal
-            credentialToDelete={credentialToDelete}
-            isDeleting={deleteCredentialsMutation.isPending}
-            onClose={() => setCredentialToDelete(null)}
-            onConfirm={handleDeleteConfirm}
-          />
+          )}
         </>
       )}
     </div>
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/components/APIKeyCredentialsModal/APIKeyCredentialsModal.tsx b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/APIKeyCredentialsModal/APIKeyCredentialsModal.tsx
similarity index 72%
rename from autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/components/APIKeyCredentialsModal/APIKeyCredentialsModal.tsx
rename to autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/APIKeyCredentialsModal/APIKeyCredentialsModal.tsx
index 0180c4ebf9..90f6c0ff70 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/components/APIKeyCredentialsModal/APIKeyCredentialsModal.tsx
+++ b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/APIKeyCredentialsModal/APIKeyCredentialsModal.tsx
@@ -1,11 +1,11 @@
-import { Input } from "@/components/atoms/Input/Input";
-import { Button } from "@/components/atoms/Button/Button";
-import { Dialog } from "@/components/molecules/Dialog/Dialog";
 import {
   Form,
   FormDescription,
   FormField,
 } from "@/components/__legacy__/ui/form";
+import { Button } from "@/components/atoms/Button/Button";
+import { Input } from "@/components/atoms/Input/Input";
+import { Dialog } from "@/components/molecules/Dialog/Dialog";
 import {
   BlockIOCredentialsSubSchema,
   CredentialsMetaInput,
@@ -60,7 +60,23 @@ export function APIKeyCredentialsModal({
         )}
 
         <Form {...form}>
-          <form onSubmit={form.handleSubmit(onSubmit)} className="space-y-2">
+          <form
+            onSubmit={form.handleSubmit(onSubmit)}
+            className="space-y-2 px-2"
+          >
+            <FormField
+              control={form.control}
+              name="title"
+              render={({ field }) => (
+                <Input
+                  id="title"
+                  label="Name"
+                  type="text"
+                  placeholder="Enter a name for this API Key..."
+                  {...field}
+                />
+              )}
+            />
             <FormField
               control={form.control}
               name="apiKey"
@@ -70,8 +86,7 @@ export function APIKeyCredentialsModal({
                     id="apiKey"
                     label="API Key"
                     type="password"
-                    placeholder="Enter API key..."
-                    size="small"
+                    placeholder="Enter API Key..."
                     hint={
                       schema.credentials_scopes ? (
                         <FormDescription>
@@ -90,20 +105,7 @@ export function APIKeyCredentialsModal({
                 </>
               )}
             />
-            <FormField
-              control={form.control}
-              name="title"
-              render={({ field }) => (
-                <Input
-                  id="title"
-                  label="Name"
-                  type="text"
-                  placeholder="Enter a name for this API key..."
-                  size="small"
-                  {...field}
-                />
-              )}
-            />
+
             <FormField
               control={form.control}
               name="expiresAt"
@@ -113,13 +115,31 @@ export function APIKeyCredentialsModal({
                   label="Expiration Date"
                   type="datetime-local"
                   placeholder="Select expiration date..."
-                  size="small"
-                  {...field}
+                  value={field.value}
+                  onChange={(e) => {
+                    const value = e.target.value;
+                    if (value) {
+                      const dateTime = new Date(value);
+                      dateTime.setHours(0, 0, 0, 0);
+                      const year = dateTime.getFullYear();
+                      const month = String(dateTime.getMonth() + 1).padStart(
+                        2,
+                        "0",
+                      );
+                      const day = String(dateTime.getDate()).padStart(2, "0");
+                      const normalizedValue = `${year}-${month}-${day}T00:00`;
+                      field.onChange(normalizedValue);
+                    } else {
+                      field.onChange(value);
+                    }
+                  }}
+                  onBlur={field.onBlur}
+                  name={field.name}
                 />
               )}
             />
-            <Button type="submit" size="small" className="min-w-68">
-              Save & use this API key
+            <Button type="submit" className="min-w-68">
+              Add API Key
             </Button>
           </form>
         </Form>
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/components/APIKeyCredentialsModal/useAPIKeyCredentialsModal.ts b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/APIKeyCredentialsModal/useAPIKeyCredentialsModal.ts
similarity index 79%
rename from autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/components/APIKeyCredentialsModal/useAPIKeyCredentialsModal.ts
rename to autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/APIKeyCredentialsModal/useAPIKeyCredentialsModal.ts
index 391633bed5..72599a2e79 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/components/APIKeyCredentialsModal/useAPIKeyCredentialsModal.ts
+++ b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/APIKeyCredentialsModal/useAPIKeyCredentialsModal.ts
@@ -1,11 +1,11 @@
-import { z } from "zod";
-import { useForm, type UseFormReturn } from "react-hook-form";
-import { zodResolver } from "@hookform/resolvers/zod";
 import useCredentials from "@/hooks/useCredentials";
 import {
   BlockIOCredentialsSubSchema,
   CredentialsMetaInput,
 } from "@/lib/autogpt-server-api/types";
+import { zodResolver } from "@hookform/resolvers/zod";
+import { useForm, type UseFormReturn } from "react-hook-form";
+import { z } from "zod";
 
 export type APIKeyFormValues = {
   apiKey: string;
@@ -40,12 +40,24 @@ export function useAPIKeyCredentialsModal({
     expiresAt: z.string().optional(),
   });
 
+  function getDefaultExpirationDate(): string {
+    const tomorrow = new Date();
+    tomorrow.setDate(tomorrow.getDate() + 1);
+    tomorrow.setHours(0, 0, 0, 0);
+    const year = tomorrow.getFullYear();
+    const month = String(tomorrow.getMonth() + 1).padStart(2, "0");
+    const day = String(tomorrow.getDate()).padStart(2, "0");
+    const hours = String(tomorrow.getHours()).padStart(2, "0");
+    const minutes = String(tomorrow.getMinutes()).padStart(2, "0");
+    return `${year}-${month}-${day}T${hours}:${minutes}`;
+  }
+
   const form = useForm<APIKeyFormValues>({
     resolver: zodResolver(formSchema),
     defaultValues: {
       apiKey: "",
       title: "",
-      expiresAt: "",
+      expiresAt: getDefaultExpirationDate(),
     },
   });
 
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/components/CredentialRow/CredentialRow.tsx b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/CredentialRow/CredentialRow.tsx
similarity index 52%
rename from autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/components/CredentialRow/CredentialRow.tsx
rename to autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/CredentialRow/CredentialRow.tsx
index 21ec1200e4..dc69c34d93 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/components/CredentialRow/CredentialRow.tsx
+++ b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/CredentialRow/CredentialRow.tsx
@@ -7,7 +7,8 @@ import {
   DropdownMenuTrigger,
 } from "@/components/molecules/DropdownMenu/DropdownMenu";
 import { cn } from "@/lib/utils";
-import { CaretDown, DotsThreeVertical } from "@phosphor-icons/react";
+import { CaretDownIcon, DotsThreeVertical } from "@phosphor-icons/react";
+import { useEffect, useRef, useState } from "react";
 import {
   fallbackIcon,
   getCredentialDisplayName,
@@ -26,10 +27,12 @@ type CredentialRowProps = {
   provider: string;
   displayName: string;
   onSelect: () => void;
-  onDelete: () => void;
+  onDelete?: () => void;
   readOnly?: boolean;
   showCaret?: boolean;
   asSelectTrigger?: boolean;
+  /** When "node", applies compact styling for node context */
+  variant?: "default" | "node";
 };
 
 export function CredentialRow({
@@ -41,14 +44,43 @@ export function CredentialRow({
   readOnly = false,
   showCaret = false,
   asSelectTrigger = false,
+  variant = "default",
 }: CredentialRowProps) {
   const ProviderIcon = providerIcons[provider] || fallbackIcon;
+  const isNodeVariant = variant === "node";
+  const containerRef = useRef<HTMLDivElement>(null);
+  const [showMaskedKey, setShowMaskedKey] = useState(true);
+
+  useEffect(() => {
+    const container = containerRef.current;
+    if (!container) return;
+
+    const resizeObserver = new ResizeObserver((entries) => {
+      for (const entry of entries) {
+        const width = entry.contentRect.width;
+        setShowMaskedKey(width >= 360);
+      }
+    });
+
+    resizeObserver.observe(container);
+
+    return () => {
+      resizeObserver.disconnect();
+    };
+  }, []);
 
   return (
     <div
+      ref={containerRef}
       className={cn(
-        "flex items-center gap-3 rounded-medium border border-zinc-200 bg-white p-3 transition-colors",
-        asSelectTrigger ? "border-0 bg-transparent" : readOnly ? "w-fit" : "",
+        "flex min-w-[20rem] items-center gap-3 rounded-medium border border-zinc-200 bg-white p-3 transition-colors",
+        asSelectTrigger && isNodeVariant
+          ? "min-w-0 flex-1 overflow-hidden border-0 bg-transparent"
+          : asSelectTrigger
+            ? "border-0 bg-transparent"
+            : readOnly
+              ? "w-fit"
+              : "",
       )}
       onClick={readOnly || showCaret || asSelectTrigger ? undefined : onSelect}
       style={
@@ -61,24 +93,37 @@ export function CredentialRow({
         <ProviderIcon className="h-3 w-3 text-white" />
       </div>
       <IconKey className="h-5 w-5 shrink-0 text-zinc-800" />
-      <div className="flex min-w-0 flex-1 flex-nowrap items-center gap-4">
+      <div
+        className={cn(
+          "relative flex min-w-0 flex-1 flex-nowrap items-center gap-4",
+          isNodeVariant && "overflow-hidden",
+        )}
+      >
         <Text
           variant="body"
-          className="line-clamp-1 flex-[0_0_50%] text-ellipsis tracking-tight"
+          className={cn(
+            "min-w-0 flex-1 tracking-tight",
+            isNodeVariant ? "truncate" : "line-clamp-1 text-ellipsis",
+          )}
         >
           {getCredentialDisplayName(credential, displayName)}
         </Text>
-        <Text
-          variant="large"
-          className="lex-[0_0_40%] relative top-1 hidden overflow-hidden whitespace-nowrap font-mono tracking-tight md:block"
-        >
-          {"*".repeat(MASKED_KEY_LENGTH)}
-        </Text>
+        {!(asSelectTrigger && isNodeVariant) && showMaskedKey && (
+          <Text
+            variant="large"
+            className={cn(
+              "absolute top-[65%] -translate-y-1/2 overflow-hidden whitespace-nowrap font-mono tracking-tight",
+              asSelectTrigger ? "right-0" : "right-6",
+            )}
+          >
+            {"*".repeat(MASKED_KEY_LENGTH)}
+          </Text>
+        )}
       </div>
-      {showCaret && !asSelectTrigger && (
-        <CaretDown className="h-4 w-4 shrink-0 text-gray-400" />
+      {(showCaret || (asSelectTrigger && !readOnly)) && (
+        <CaretDownIcon className="h-4 w-4 shrink-0 text-gray-400" />
       )}
-      {!readOnly && !showCaret && !asSelectTrigger && (
+      {!readOnly && !showCaret && !asSelectTrigger && onDelete && (
         <DropdownMenu>
           <DropdownMenuTrigger asChild>
             <button
diff --git a/autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/CredentialsAccordionView/CredentialsAccordionView.tsx b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/CredentialsAccordionView/CredentialsAccordionView.tsx
new file mode 100644
index 0000000000..9204a4d9b0
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/CredentialsAccordionView/CredentialsAccordionView.tsx
@@ -0,0 +1,203 @@
+import { Button } from "@/components/atoms/Button/Button";
+import { Text } from "@/components/atoms/Text/Text";
+import {
+  Accordion,
+  AccordionContent,
+  AccordionItem,
+  AccordionTrigger,
+} from "@/components/molecules/Accordion/Accordion";
+import { InformationTooltip } from "@/components/molecules/InformationTooltip/InformationTooltip";
+import {
+  BlockIOCredentialsSubSchema,
+  CredentialsMetaInput,
+} from "@/lib/autogpt-server-api/types";
+import { SlidersHorizontalIcon } from "lucide-react";
+import { CredentialRow } from "../CredentialRow/CredentialRow";
+import { CredentialsSelect } from "../CredentialsSelect/CredentialsSelect";
+
+type Credential = {
+  id: string;
+  title?: string;
+  username?: string;
+  type: string;
+  provider: string;
+};
+
+type Props = {
+  schema: BlockIOCredentialsSubSchema;
+  provider: string;
+  displayName: string;
+  userCredentials: Credential[];
+  systemCredentials: Credential[];
+  isSystemProvider: boolean;
+  selectedCredential?: CredentialsMetaInput;
+  onSelectCredential: (credentialId: string) => void;
+  onClearCredential: () => void;
+  onAddCredential: () => void;
+  actionButtonText: string;
+  isOptional: boolean;
+  showTitle: boolean;
+  variant: "default" | "node";
+};
+
+export function CredentialsAccordionView({
+  schema,
+  provider,
+  displayName,
+  userCredentials,
+  systemCredentials,
+  isSystemProvider,
+  selectedCredential,
+  onSelectCredential,
+  onClearCredential,
+  onAddCredential,
+  actionButtonText,
+  isOptional,
+  showTitle,
+  variant,
+}: Props) {
+  const allCredentials = [...userCredentials, ...systemCredentials];
+  const hasSystemCredentials = systemCredentials.length > 0;
+  const hasUserCredentials = userCredentials.length > 0;
+
+  const credentialsInAccordion = isSystemProvider
+    ? allCredentials
+    : systemCredentials;
+
+  const shouldOpenAccordionByDefault =
+    hasSystemCredentials && !isOptional && !selectedCredential;
+
+  const showUserCredentialsOutsideAccordion =
+    !isSystemProvider && hasUserCredentials;
+
+  return (
+    <>
+      {showTitle && showUserCredentialsOutsideAccordion && (
+        <div className="mb-2 flex items-center gap-2">
+          <Text variant="large-medium">
+            {displayName} credentials
+            {isOptional && (
+              <span className="ml-1 text-sm font-normal text-gray-500">
+                (optional)
+              </span>
+            )}
+          </Text>
+          {schema.description && (
+            <InformationTooltip description={schema.description} />
+          )}
+        </div>
+      )}
+
+      {showUserCredentialsOutsideAccordion && (
+        <>
+          {userCredentials.length > 1 || isOptional ? (
+            <CredentialsSelect
+              credentials={userCredentials}
+              provider={provider}
+              displayName={displayName}
+              selectedCredentials={selectedCredential}
+              onSelectCredential={onSelectCredential}
+              onClearCredential={onClearCredential}
+              allowNone={isOptional}
+              variant={variant}
+            />
+          ) : (
+            <div className="mb-4 space-y-2">
+              {userCredentials.map((credential) => (
+                <CredentialRow
+                  key={credential.id}
+                  credential={credential}
+                  provider={provider}
+                  displayName={displayName}
+                  onSelect={() => onSelectCredential(credential.id)}
+                />
+              ))}
+            </div>
+          )}
+          <Button
+            variant="secondary"
+            size="small"
+            onClick={onAddCredential}
+            className="w-fit"
+            type="button"
+          >
+            {actionButtonText}
+          </Button>
+        </>
+      )}
+
+      {hasSystemCredentials && (
+        <Accordion
+          type="single"
+          collapsible
+          defaultValue={
+            shouldOpenAccordionByDefault ? "system-credentials" : undefined
+          }
+          className={showUserCredentialsOutsideAccordion ? "mt-4" : ""}
+        >
+          <AccordionItem value="system-credentials" className="border-none">
+            <AccordionTrigger className="py-2 text-sm text-muted-foreground hover:no-underline">
+              <div className="flex items-center gap-1">
+                <SlidersHorizontalIcon className="size-4" /> System credentials
+              </div>
+            </AccordionTrigger>
+            <AccordionContent>
+              <div className="space-y-4 px-1 pt-2">
+                {showTitle && (
+                  <div className="flex items-center gap-2">
+                    <Text variant="large-medium">
+                      {displayName} credentials
+                      {isOptional && (
+                        <span className="ml-1 text-sm font-normal text-gray-500">
+                          (optional)
+                        </span>
+                      )}
+                    </Text>
+                    {schema.description && (
+                      <InformationTooltip description={schema.description} />
+                    )}
+                  </div>
+                )}
+                {credentialsInAccordion.length > 0 && (
+                  <CredentialsSelect
+                    credentials={credentialsInAccordion}
+                    provider={provider}
+                    displayName={displayName}
+                    selectedCredentials={selectedCredential}
+                    onSelectCredential={onSelectCredential}
+                    onClearCredential={onClearCredential}
+                    allowNone={isOptional}
+                    variant={variant}
+                  />
+                )}
+                {isSystemProvider && (
+                  <Button
+                    variant="secondary"
+                    size="small"
+                    onClick={onAddCredential}
+                    className="w-fit"
+                    type="button"
+                  >
+                    {actionButtonText}
+                  </Button>
+                )}
+              </div>
+            </AccordionContent>
+          </AccordionItem>
+        </Accordion>
+      )}
+
+      {!showUserCredentialsOutsideAccordion && !isSystemProvider && (
+        <Button
+          variant="secondary"
+          size="small"
+          onClick={onAddCredential}
+          className="w-fit"
+          type="button"
+        >
+          {actionButtonText}
+        </Button>
+      )}
+    </>
+  );
+}
diff --git a/autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/CredentialsFlatView/CredentialsFlatView.tsx b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/CredentialsFlatView/CredentialsFlatView.tsx
new file mode 100644
index 0000000000..4d220a5359
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/CredentialsFlatView/CredentialsFlatView.tsx
@@ -0,0 +1,134 @@
+import { Button } from "@/components/atoms/Button/Button";
+import { Text } from "@/components/atoms/Text/Text";
+import { InformationTooltip } from "@/components/molecules/InformationTooltip/InformationTooltip";
+import {
+  BlockIOCredentialsSubSchema,
+  CredentialsMetaInput,
+} from "@/lib/autogpt-server-api/types";
+import { ExclamationTriangleIcon } from "@radix-ui/react-icons";
+import { CredentialRow } from "../CredentialRow/CredentialRow";
+import { CredentialsSelect } from "../CredentialsSelect/CredentialsSelect";
+
+type Credential = {
+  id: string;
+  title?: string;
+  username?: string;
+  type: string;
+  provider: string;
+};
+
+type Props = {
+  schema: BlockIOCredentialsSubSchema;
+  provider: string;
+  displayName: string;
+  credentials: Credential[];
+  selectedCredential?: CredentialsMetaInput;
+  actionButtonText: string;
+  isOptional: boolean;
+  showTitle: boolean;
+  readOnly: boolean;
+  variant: "default" | "node";
+  onSelectCredential: (credentialId: string) => void;
+  onClearCredential: () => void;
+  onAddCredential: () => void;
+};
+
+export function CredentialsFlatView({
+  schema,
+  provider,
+  displayName,
+  credentials,
+  selectedCredential,
+  actionButtonText,
+  isOptional,
+  showTitle,
+  readOnly,
+  variant,
+  onSelectCredential,
+  onClearCredential,
+  onAddCredential,
+}: Props) {
+  const hasCredentials = credentials.length > 0;
+
+  return (
+    <>
+      {showTitle && (
+        <div className="mb-2 flex items-center gap-2">
+          <Text variant="large-medium" className="flex items-center gap-2">
+            <span className="inline-flex items-center gap-1">
+              {displayName} credentials
+              {isOptional && (
+                <span className="text-sm font-normal text-gray-500">
+                  (optional)
+                </span>
+              )}
+              {!isOptional && !selectedCredential && (
+                <span className="inline-flex items-center gap-1 text-red-600">
+                  <ExclamationTriangleIcon className="size-4" />
+                  <span className="text-sm font-normal">required</span>
+                </span>
+              )}
+            </span>
+          </Text>
+          {schema.description && (
+            <InformationTooltip description={schema.description} />
+          )}
+        </div>
+      )}
+
+      {hasCredentials ? (
+        <>
+          {(credentials.length > 1 || isOptional) && !readOnly ? (
+            <CredentialsSelect
+              credentials={credentials}
+              provider={provider}
+              displayName={displayName}
+              selectedCredentials={selectedCredential}
+              onSelectCredential={onSelectCredential}
+              onClearCredential={onClearCredential}
+              readOnly={readOnly}
+              allowNone={isOptional}
+              variant={variant}
+            />
+          ) : (
+            <div className="mb-4 space-y-2">
+              {credentials.map((credential) => (
+                <CredentialRow
+                  key={credential.id}
+                  credential={credential}
+                  provider={provider}
+                  displayName={displayName}
+                  onSelect={() => onSelectCredential(credential.id)}
+                  readOnly={readOnly}
+                />
+              ))}
+            </div>
+          )}
+          {!readOnly && (
+            <Button
+              variant="secondary"
+              size="small"
+              onClick={onAddCredential}
+              className="w-fit"
+              type="button"
+            >
+              {actionButtonText}
+            </Button>
+          )}
+        </>
+      ) : (
+        !readOnly && (
+          <Button
+            variant="secondary"
+            size="small"
+            onClick={onAddCredential}
+            className="w-fit"
+            type="button"
+          >
+            {actionButtonText}
+          </Button>
+        )
+      )}
+    </>
+  );
+}
diff --git a/autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/CredentialsSelect/CredentialsSelect.tsx b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/CredentialsSelect/CredentialsSelect.tsx
new file mode 100644
index 0000000000..18e772dd00
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/CredentialsSelect/CredentialsSelect.tsx
@@ -0,0 +1,108 @@
+import { CredentialsMetaInput } from "@/app/api/__generated__/models/credentialsMetaInput";
+import { getCredentialDisplayName } from "../../helpers";
+import { CredentialRow } from "../CredentialRow/CredentialRow";
+
+interface Props {
+  credentials: Array<{
+    id: string;
+    title?: string;
+    username?: string;
+    type: string;
+    provider: string;
+  }>;
+  provider: string;
+  displayName: string;
+  selectedCredentials?: CredentialsMetaInput;
+  onSelectCredential: (credentialId: string) => void;
+  onClearCredential?: () => void;
+  readOnly?: boolean;
+  allowNone?: boolean;
+  /** When "node", applies compact styling for node context */
+  variant?: "default" | "node";
+}
+
+export function CredentialsSelect({
+  credentials,
+  provider,
+  displayName,
+  selectedCredentials,
+  onSelectCredential,
+  onClearCredential,
+  readOnly = false,
+  allowNone = true,
+  variant = "default",
+}: Props) {
+  function handleValueChange(e: React.ChangeEvent<HTMLSelectElement>) {
+    const value = e.target.value;
+    if (value === "__none__") {
+      onClearCredential?.();
+    } else {
+      onSelectCredential(value);
+    }
+  }
+
+  const selectedCredential = selectedCredentials
+    ? credentials.find((c) => c.id === selectedCredentials.id)
+    : null;
+
+  const displayCredential = selectedCredential
+    ? {
+        id: selectedCredential.id,
+        title: selectedCredential.title,
+        username: selectedCredential.username,
+        type: selectedCredential.type,
+        provider: selectedCredential.provider,
+      }
+    : allowNone
+      ? {
+          id: "__none__",
+          title: "None (skip this credential)",
+          type: "none",
+          provider: provider,
+        }
+      : {
+          id: "__placeholder__",
+          title: "Select credential",
+          type: "placeholder",
+          provider: provider,
+        };
+
+  return (
+    <div className="mb-4 w-full">
+      <div className="relative">
+        <select
+          value={selectedCredentials?.id ?? "__none__"}
+          onChange={handleValueChange}
+          disabled={readOnly}
+          className="absolute inset-0 z-10 cursor-pointer opacity-0"
+          aria-label={`Select ${displayName} credential`}
+        >
+          {allowNone ? (
+            <option value="__none__">None (skip this credential)</option>
+          ) : (
+            <option value="__none__" disabled hidden>
+              Select a credential
+            </option>
+          )}
+          {credentials.map((credential) => (
+            <option key={credential.id} value={credential.id}>
+              {getCredentialDisplayName(credential, displayName)}
+            </option>
+          ))}
+        </select>
+        <div className="rounded-medium border border-zinc-200 bg-white">
+          <CredentialRow
+            credential={displayCredential}
+            provider={provider}
+            displayName={displayName}
+            onSelect={() => {}}
+            onDelete={() => {}}
+            readOnly={readOnly}
+            asSelectTrigger={true}
+            variant={variant}
+          />
+        </div>
+      </div>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/components/DeleteConfirmationModal/DeleteConfirmationModal.tsx b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/DeleteConfirmationModal/DeleteConfirmationModal.tsx
similarity index 100%
rename from autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/components/DeleteConfirmationModal/DeleteConfirmationModal.tsx
rename to autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/DeleteConfirmationModal/DeleteConfirmationModal.tsx
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/components/HotScopedCredentialsModal/HotScopedCredentialsModal.tsx b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/HotScopedCredentialsModal/HotScopedCredentialsModal.tsx
similarity index 100%
rename from autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/components/HotScopedCredentialsModal/HotScopedCredentialsModal.tsx
rename to autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/HotScopedCredentialsModal/HotScopedCredentialsModal.tsx
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/components/OAuthWaitingModal/OAuthWaitingModal.tsx b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/OAuthWaitingModal/OAuthWaitingModal.tsx
similarity index 100%
rename from autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/components/OAuthWaitingModal/OAuthWaitingModal.tsx
rename to autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/OAuthWaitingModal/OAuthWaitingModal.tsx
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/components/PasswordCredentialsModal/PasswordCredentialsModal.tsx b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/PasswordCredentialsModal/PasswordCredentialsModal.tsx
similarity index 100%
rename from autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/components/PasswordCredentialsModal/PasswordCredentialsModal.tsx
rename to autogpt_platform/frontend/src/components/contextual/CredentialsInput/components/PasswordCredentialsModal/PasswordCredentialsModal.tsx
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/helpers.ts b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/helpers.ts
similarity index 75%
rename from autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/helpers.ts
rename to autogpt_platform/frontend/src/components/contextual/CredentialsInput/helpers.ts
index 4cca825747..ef965d5382 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/helpers.ts
+++ b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/helpers.ts
@@ -99,4 +99,30 @@ export function getCredentialDisplayName(
 }
 
 export const OAUTH_TIMEOUT_MS = 5 * 60 * 1000;
-export const MASKED_KEY_LENGTH = 30;
+export const MASKED_KEY_LENGTH = 15;
+
+export function isSystemCredential(credential: {
+  title?: string | null;
+  is_system?: boolean;
+}): boolean {
+  if (credential.is_system === true) return true;
+  if (!credential.title) return false;
+  const titleLower = credential.title.toLowerCase();
+  return (
+    titleLower.includes("system") ||
+    titleLower.startsWith("use credits for") ||
+    titleLower.includes("use credits")
+  );
+}
+
+export function filterSystemCredentials<
+  T extends { title?: string; is_system?: boolean },
+>(credentials: T[]): T[] {
+  return credentials.filter((cred) => !isSystemCredential(cred));
+}
+
+export function getSystemCredentials<
+  T extends { title?: string; is_system?: boolean },
+>(credentials: T[]): T[] {
+  return credentials.filter((cred) => isSystemCredential(cred));
+}
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/useCredentialsInput.ts b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/useCredentialsInput.ts
similarity index 82%
rename from autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/useCredentialsInput.ts
rename to autogpt_platform/frontend/src/components/contextual/CredentialsInput/useCredentialsInput.ts
index 6f5ca48126..8876ddcba9 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/useCredentialsInput.ts
+++ b/autogpt_platform/frontend/src/components/contextual/CredentialsInput/useCredentialsInput.ts
@@ -6,9 +6,11 @@ import {
   CredentialsMetaInput,
 } from "@/lib/autogpt-server-api/types";
 import { useQueryClient } from "@tanstack/react-query";
-import { useEffect, useMemo, useState } from "react";
+import { useEffect, useRef, useState } from "react";
 import {
+  filterSystemCredentials,
   getActionButtonText,
+  getSystemCredentials,
   OAUTH_TIMEOUT_MS,
   OAuthPopupResultMessage,
 } from "./helpers";
@@ -22,6 +24,7 @@ type Params = {
   siblingInputs?: Record<string, any>;
   onLoaded?: (loaded: boolean) => void;
   readOnly?: boolean;
+  isOptional?: boolean;
 };
 
 export function useCredentialsInput({
@@ -31,6 +34,7 @@ export function useCredentialsInput({
   siblingInputs,
   onLoaded,
   readOnly = false,
+  isOptional = false,
 }: Params) {
   const [isAPICredentialsModalOpen, setAPICredentialsModalOpen] =
     useState(false);
@@ -52,6 +56,7 @@ export function useCredentialsInput({
   const api = useBackendAPI();
   const queryClient = useQueryClient();
   const credentials = useCredentials(schema, siblingInputs);
+  const hasAttemptedAutoSelect = useRef(false);
 
   const deleteCredentialsMutation = useDeleteV1DeleteCredentials({
     mutation: {
@@ -80,32 +85,52 @@ export function useCredentialsInput({
   useEffect(() => {
     if (readOnly) return;
     if (!credentials || !("savedCredentials" in credentials)) return;
+    const availableCreds = credentials.savedCredentials;
     if (
       selectedCredential &&
-      !credentials.savedCredentials.some((c) => c.id === selectedCredential.id)
+      !availableCreds.some((c) => c.id === selectedCredential.id)
     ) {
       onSelectCredential(undefined);
+      // Reset auto-selection flag so it can run again after unsetting invalid credential
+      hasAttemptedAutoSelect.current = false;
     }
   }, [credentials, selectedCredential, onSelectCredential, readOnly]);
 
-  // The available credential, if there is only one
-  const singleCredential = useMemo(() => {
-    if (!credentials || !("savedCredentials" in credentials)) {
-      return null;
-    }
-
-    return credentials.savedCredentials.length === 1
-      ? credentials.savedCredentials[0]
-      : null;
-  }, [credentials]);
-
-  // Auto-select the one available credential
+  // Auto-select the first available credential on initial mount
+  // Once a user has made a selection, we don't override it
   useEffect(() => {
     if (readOnly) return;
-    if (singleCredential && !selectedCredential) {
-      onSelectCredential(singleCredential);
+    if (!credentials || !("savedCredentials" in credentials)) return;
+
+    // If already selected, don't auto-select
+    if (selectedCredential?.id) return;
+
+    // Only attempt auto-selection once
+    if (hasAttemptedAutoSelect.current) return;
+    hasAttemptedAutoSelect.current = true;
+
+    // If optional, don't auto-select (user can choose "None")
+    if (isOptional) return;
+
+    const savedCreds = credentials.savedCredentials;
+
+    // Auto-select the first credential if any are available
+    if (savedCreds.length > 0) {
+      const cred = savedCreds[0];
+      onSelectCredential({
+        id: cred.id,
+        type: cred.type,
+        provider: credentials.provider,
+        title: (cred as any).title,
+      });
     }
-  }, [singleCredential, selectedCredential, onSelectCredential, readOnly]);
+  }, [
+    credentials,
+    selectedCredential?.id,
+    readOnly,
+    isOptional,
+    onSelectCredential,
+  ]);
 
   if (
     !credentials ||
@@ -126,8 +151,13 @@ export function useCredentialsInput({
     supportsHostScoped,
     savedCredentials,
     oAuthCallback,
+    isSystemProvider,
   } = credentials;
 
+  // Split credentials into user and system
+  const userCredentials = filterSystemCredentials(savedCredentials);
+  const systemCredentials = getSystemCredentials(savedCredentials);
+
   async function handleOAuthLogin() {
     setOAuthError(null);
     const { login_url, state_token } = await api.oAuthLogin(
@@ -282,7 +312,10 @@ export function useCredentialsInput({
     supportsOAuth2,
     supportsUserPassword,
     supportsHostScoped,
-    credentialsToShow: savedCredentials,
+    isSystemProvider,
+    userCredentials,
+    systemCredentials,
+    allCredentials: savedCredentials,
     selectedCredential,
     oAuthError,
     isAPICredentialsModalOpen,
@@ -297,7 +330,7 @@ export function useCredentialsInput({
       supportsApiKey,
       supportsUserPassword,
       supportsHostScoped,
-      savedCredentials.length > 0,
+      userCredentials.length > 0,
     ),
     setAPICredentialsModalOpen,
     setUserPasswordCredentialsModalOpen,
diff --git a/autogpt_platform/frontend/src/components/contextual/EditAgentModal/EditAgentModal.tsx b/autogpt_platform/frontend/src/components/contextual/EditAgentModal/EditAgentModal.tsx
index 501650a36b..243b478f49 100644
--- a/autogpt_platform/frontend/src/components/contextual/EditAgentModal/EditAgentModal.tsx
+++ b/autogpt_platform/frontend/src/components/contextual/EditAgentModal/EditAgentModal.tsx
@@ -27,6 +27,7 @@ export function EditAgentModal({
 
   return (
     <Dialog
+      title="Edit Agent"
       styling={{
         maxWidth: "45rem",
       }}
diff --git a/autogpt_platform/frontend/src/components/contextual/EditAgentModal/components/EditAgentForm.tsx b/autogpt_platform/frontend/src/components/contextual/EditAgentModal/components/EditAgentForm.tsx
index 7f04f91a92..5c0c4fa1de 100644
--- a/autogpt_platform/frontend/src/components/contextual/EditAgentModal/components/EditAgentForm.tsx
+++ b/autogpt_platform/frontend/src/components/contextual/EditAgentModal/components/EditAgentForm.tsx
@@ -8,7 +8,6 @@ import { Form, FormField } from "@/components/__legacy__/ui/form";
 import { StoreSubmission } from "@/app/api/__generated__/models/storeSubmission";
 import { ThumbnailImages } from "../../PublishAgentModal/components/AgentInfoStep/components/ThumbnailImages";
 import { StoreSubmissionEditRequest } from "@/app/api/__generated__/models/storeSubmissionEditRequest";
-import { StepHeader } from "../../PublishAgentModal/components/StepHeader";
 import { useEditAgentForm } from "./useEditAgentForm";
 
 interface EditAgentFormProps {
@@ -31,12 +30,10 @@ export function EditAgentForm({
     isSubmitting,
     handleFormSubmit,
     handleImagesChange,
-  } = useEditAgentForm({ submission, onSuccess });
+  } = useEditAgentForm({ submission, onSuccess, onClose });
 
   return (
     <div className="mx-auto flex w-full flex-col rounded-3xl">
-      <StepHeader title="Edit Agent" description="Update your agent details" />
-
       <Form {...form}>
         <form
           onSubmit={form.handleSubmit(handleFormSubmit)}
@@ -75,7 +72,7 @@ export function EditAgentForm({
           <ThumbnailImages
             agentId={submission.agent_id}
             onImagesChange={handleImagesChange}
-            initialImages={submission.image_urls || []}
+            initialImages={Array.from(new Set(submission.image_urls || []))}
             initialSelectedImage={submission.image_urls?.[0] || null}
             errorMessage={form.formState.errors.root?.message}
           />
@@ -136,7 +133,7 @@ export function EditAgentForm({
               <Input
                 id={field.name}
                 label="Changes Summary"
-                type="text"
+                type="textarea"
                 placeholder="Briefly describe what you changed"
                 error={form.formState.errors.changes_summary?.message}
                 {...field}
diff --git a/autogpt_platform/frontend/src/components/contextual/EditAgentModal/components/useEditAgentForm.ts b/autogpt_platform/frontend/src/components/contextual/EditAgentModal/components/useEditAgentForm.ts
index 8de7c43659..4f2ea49506 100644
--- a/autogpt_platform/frontend/src/components/contextual/EditAgentModal/components/useEditAgentForm.ts
+++ b/autogpt_platform/frontend/src/components/contextual/EditAgentModal/components/useEditAgentForm.ts
@@ -19,11 +19,13 @@ interface useEditAgentFormProps {
     agent_id: string;
   };
   onSuccess: (submission: StoreSubmission) => void;
+  onClose: () => void;
 }
 
 export const useEditAgentForm = ({
   submission,
   onSuccess,
+  onClose,
 }: useEditAgentFormProps) => {
   const editAgentSchema = z.object({
     title: z
@@ -45,7 +47,7 @@ export const useEditAgentForm = ({
     changes_summary: z
       .string()
       .min(1, "Changes summary is required")
-      .max(200, "Changes summary must be less than 200 characters"),
+      .max(500, "Changes summary must be less than 500 characters"),
     agentOutputDemo: z
       .string()
       .refine(validateYouTubeUrl, "Please enter a valid YouTube URL"),
@@ -54,19 +56,11 @@ export const useEditAgentForm = ({
   type EditAgentFormData = z.infer<typeof editAgentSchema>;
 
   const [images, setImages] = React.useState<string[]>(
-    submission.image_urls || [],
+    Array.from(new Set(submission.image_urls || [])), // Remove duplicates
   );
   const [isSubmitting, setIsSubmitting] = React.useState(false);
 
-  const { mutateAsync: editSubmission } = usePutV2EditStoreSubmission({
-    mutation: {
-      onSuccess: () => {
-        queryClient.invalidateQueries({
-          queryKey: getGetV2ListMySubmissionsQueryKey(),
-        });
-      },
-    },
-  });
+  const { mutateAsync: editSubmission } = usePutV2EditStoreSubmission();
 
   const queryClient = useQueryClient();
   const { toast } = useToast();
@@ -132,7 +126,20 @@ export const useEditAgentForm = ({
 
       // Extract the StoreSubmission from the response
       if (response.status === 200 && response.data) {
+        toast({
+          title: "Agent Updated",
+          description: "Your agent submission has been updated successfully.",
+          duration: 3000,
+          variant: "default",
+        });
+
+        queryClient.invalidateQueries({
+          queryKey: getGetV2ListMySubmissionsQueryKey(),
+        });
+
+        // Call onSuccess and explicitly close the modal
         onSuccess(response.data);
+        onClose();
       } else {
         throw new Error("Failed to update submission");
       }
diff --git a/autogpt_platform/frontend/src/components/contextual/GoogleDrivePicker/GoogleDrivePicker.tsx b/autogpt_platform/frontend/src/components/contextual/GoogleDrivePicker/GoogleDrivePicker.tsx
index 01b98bcdac..b05bab8a9a 100644
--- a/autogpt_platform/frontend/src/components/contextual/GoogleDrivePicker/GoogleDrivePicker.tsx
+++ b/autogpt_platform/frontend/src/components/contextual/GoogleDrivePicker/GoogleDrivePicker.tsx
@@ -1,7 +1,7 @@
 "use client";
 
-import { CredentialsInput } from "@/app/(platform)/library/agents/[id]/components/NewAgentLibraryView/components/modals/CredentialsInputs/CredentialsInputs";
 import { Button } from "@/components/atoms/Button/Button";
+import { CredentialsInput } from "@/components/contextual/CredentialsInput/CredentialsInput";
 import { CircleNotchIcon, FolderOpenIcon } from "@phosphor-icons/react";
 import {
   Props as BaseProps,
@@ -49,6 +49,7 @@ export function GoogleDrivePicker(props: Props) {
       )}
       <Button
         size="small"
+        type="button"
         onClick={handleOpenPicker}
         disabled={props.disabled || isLoading || isAuthInProgress}
       >
diff --git a/autogpt_platform/frontend/src/components/contextual/GoogleDrivePicker/GoogleDrivePickerInput.tsx b/autogpt_platform/frontend/src/components/contextual/GoogleDrivePicker/GoogleDrivePickerInput.tsx
index 2a1ada5012..66700cbdf6 100644
--- a/autogpt_platform/frontend/src/components/contextual/GoogleDrivePicker/GoogleDrivePickerInput.tsx
+++ b/autogpt_platform/frontend/src/components/contextual/GoogleDrivePicker/GoogleDrivePickerInput.tsx
@@ -4,6 +4,7 @@ import { cn } from "@/lib/utils";
 import { Cross2Icon } from "@radix-ui/react-icons";
 import React, { useCallback } from "react";
 import { GoogleDrivePicker } from "./GoogleDrivePicker";
+import { isValidFile } from "./helpers";
 
 export interface Props {
   config: GoogleDrivePickerConfig;
@@ -27,13 +28,15 @@ export function GoogleDrivePickerInput({
   const hasAutoCredentials = !!config.auto_credentials;
 
   // Strip _credentials_id from value for display purposes
-  const currentFiles = isMultiSelect
-    ? Array.isArray(value)
-      ? value
-      : []
-    : value
-      ? [value]
-      : [];
+  // Only show files section when there are valid file objects
+  const currentFiles = React.useMemo(() => {
+    if (isMultiSelect) {
+      if (!Array.isArray(value)) return [];
+      return value.filter(isValidFile);
+    }
+    if (!value || !isValidFile(value)) return [];
+    return [value];
+  }, [value, isMultiSelect]);
 
   const handlePicked = useCallback(
     (files: any[], credentialId?: string) => {
@@ -85,23 +88,27 @@ export function GoogleDrivePickerInput({
 
   return (
     <div className={cn("flex flex-col gap-2", className)}>
-      {/* Picker Button */}
-      <GoogleDrivePicker
-        multiselect={config.multiselect || false}
-        views={config.allowed_views || ["DOCS"]}
-        scopes={config.scopes || ["https://www.googleapis.com/auth/drive.file"]}
-        disabled={false}
-        requirePlatformCredentials={hasAutoCredentials}
-        onPicked={handlePicked}
-        onCanceled={() => {
-          // User canceled - no action needed
-        }}
-        onError={handleError}
-      />
+      <div className="mb-4">
+        {/* Picker Button */}
+        <GoogleDrivePicker
+          multiselect={config.multiselect || false}
+          views={config.allowed_views || ["DOCS"]}
+          scopes={
+            config.scopes || ["https://www.googleapis.com/auth/drive.file"]
+          }
+          disabled={false}
+          requirePlatformCredentials={hasAutoCredentials}
+          onPicked={handlePicked}
+          onCanceled={() => {
+            // User canceled - no action needed
+          }}
+          onError={handleError}
+        />
+      </div>
 
       {/* Display Selected Files */}
       {currentFiles.length > 0 && (
-        <div className="space-y-1">
+        <div className="mb-8 space-y-1">
           {currentFiles.map((file: any, idx: number) => (
             <div
               key={file.id || idx}
diff --git a/autogpt_platform/frontend/src/components/contextual/GoogleDrivePicker/helpers.ts b/autogpt_platform/frontend/src/components/contextual/GoogleDrivePicker/helpers.ts
index 0525a91f6a..05b591ebf6 100644
--- a/autogpt_platform/frontend/src/components/contextual/GoogleDrivePicker/helpers.ts
+++ b/autogpt_platform/frontend/src/components/contextual/GoogleDrivePicker/helpers.ts
@@ -119,3 +119,14 @@ export function getCredentialsSchema(scopes: string[]) {
     secret: true,
   } satisfies BlockIOCredentialsSubSchema;
 }
+
+export function isValidFile(
+  file: unknown,
+): file is { id?: string; name?: string } {
+  return (
+    typeof file === "object" &&
+    file !== null &&
+    (typeof (file as { id?: unknown }).id === "string" ||
+      typeof (file as { name?: unknown }).name === "string")
+  );
+}
diff --git a/autogpt_platform/frontend/src/components/contextual/InfiniteScroll/InfiniteScroll.tsx b/autogpt_platform/frontend/src/components/contextual/InfiniteScroll/InfiniteScroll.tsx
index 12aa95d564..adf93fa8d6 100644
--- a/autogpt_platform/frontend/src/components/contextual/InfiniteScroll/InfiniteScroll.tsx
+++ b/autogpt_platform/frontend/src/components/contextual/InfiniteScroll/InfiniteScroll.tsx
@@ -1,9 +1,9 @@
 "use client";
 
-import React from "react";
+import { LoadingSpinner } from "@/components/atoms/LoadingSpinner/LoadingSpinner";
 import { cn } from "@/lib/utils";
+import React from "react";
 import { useInfiniteScroll } from "./useInfiniteScroll";
-import LoadingBox from "@/components/__legacy__/ui/loading";
 
 type InfiniteScrollProps = {
   children: React.ReactNode;
@@ -47,7 +47,7 @@ export const InfiniteScroll: React.FC<InfiniteScrollProps> = ({
     hasNextPage,
   });
 
-  const defaultLoader = <LoadingBox className="w-full py-4" spinnerSize={12} />;
+  const defaultLoader = <LoadingSpinner size="medium" />;
 
   return (
     <div
diff --git a/autogpt_platform/frontend/src/components/contextual/InfiniteScroll/useInfiniteScroll.ts b/autogpt_platform/frontend/src/components/contextual/InfiniteScroll/useInfiniteScroll.ts
index 7fa0aa936c..259ef5ffe3 100644
--- a/autogpt_platform/frontend/src/components/contextual/InfiniteScroll/useInfiniteScroll.ts
+++ b/autogpt_platform/frontend/src/components/contextual/InfiniteScroll/useInfiniteScroll.ts
@@ -49,7 +49,26 @@ export const useInfiniteScroll = ({
 
     observer.observe(endOfListRef.current);
 
+    // Check if element is initially in view after a short delay to ensure DOM is ready
+    const checkInitialView = () => {
+      if (endOfListRef.current) {
+        const rect = endOfListRef.current.getBoundingClientRect();
+        const isInitiallyInView =
+          rect.top <= window.innerHeight + scrollThreshold &&
+          rect.bottom >= -scrollThreshold;
+
+        if (isInitiallyInView) {
+          setIsInView(true);
+        }
+      }
+    };
+
+    // Check immediately and after a short delay to catch cases where DOM updates
+    checkInitialView();
+    const timeoutId = setTimeout(checkInitialView, 100);
+
     return () => {
+      clearTimeout(timeoutId);
       observer.disconnect();
     };
   }, [hasNextPage, scrollThreshold]);
@@ -58,7 +77,7 @@ export const useInfiniteScroll = ({
     if (isInView && hasNextPage && !isLoadingRef.current) {
       loadMore();
     }
-  }, [isInView, hasNextPage]);
+  }, [isInView, hasNextPage, loadMore]);
 
   return {
     containerRef,
diff --git a/autogpt_platform/frontend/src/components/contextual/OutputRenderers/components/OutputActions.tsx b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/components/OutputActions.tsx
new file mode 100644
index 0000000000..cfe69e8709
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/components/OutputActions.tsx
@@ -0,0 +1,106 @@
+"use client";
+
+import React, { useState } from "react";
+import { CheckIcon, CopyIcon, DownloadIcon } from "@phosphor-icons/react";
+import { Button } from "@/components/atoms/Button/Button";
+import { OutputRenderer, OutputMetadata } from "../types";
+import { downloadOutputs } from "../utils/download";
+import { cn } from "@/lib/utils";
+
+interface OutputActionsProps {
+  items: Array<{
+    value: unknown;
+    metadata?: OutputMetadata;
+    renderer: OutputRenderer;
+  }>;
+  isPrimary?: boolean;
+  className?: string;
+}
+
+export function OutputActions({
+  items,
+  isPrimary = false,
+}: OutputActionsProps) {
+  const [copied, setCopied] = useState(false);
+
+  const handleCopyAll = async () => {
+    const textContents: string[] = [];
+
+    for (const item of items) {
+      const copyContent = item.renderer.getCopyContent(
+        item.value,
+        item.metadata,
+      );
+      if (
+        copyContent &&
+        item.renderer.isConcatenable(item.value, item.metadata)
+      ) {
+        // For concatenable items, extract the text
+        let text: string;
+        if (typeof copyContent.data === "string") {
+          text = copyContent.data;
+        } else if (copyContent.fallbackText) {
+          text = copyContent.fallbackText;
+        } else {
+          continue;
+        }
+        textContents.push(text);
+      }
+    }
+
+    if (textContents.length > 0) {
+      const combinedText = textContents.join("\n\n");
+      try {
+        await navigator.clipboard.writeText(combinedText);
+        setCopied(true);
+        setTimeout(() => setCopied(false), 2000);
+      } catch (error) {
+        console.error("Failed to copy:", error);
+      }
+    }
+  };
+
+  const handleDownloadAll = () => {
+    downloadOutputs(items);
+  };
+
+  return (
+    <div className="flex items-center gap-3">
+      <Button
+        variant={isPrimary ? "primary" : "ghost"}
+        size={isPrimary ? "small" : "icon"}
+        onClick={handleCopyAll}
+        aria-label="Copy all text outputs"
+        className={cn(isPrimary ? "min-w-0" : "")}
+      >
+        {copied ? (
+          <CheckIcon className="size-4 text-green-600" />
+        ) : (
+          <CopyIcon
+            className={cn(
+              "size-4",
+              isPrimary ? "text-white" : "text-neutral-500",
+            )}
+          />
+        )}
+        {isPrimary && <span>Copy All</span>}
+      </Button>
+
+      <Button
+        variant={isPrimary ? "primary" : "ghost"}
+        size={isPrimary ? "small" : "icon"}
+        onClick={handleDownloadAll}
+        aria-label="Download outputs"
+        className={cn(isPrimary ? "min-w-0" : "")}
+      >
+        <DownloadIcon
+          className={cn(
+            "size-4",
+            isPrimary ? "text-white" : "text-neutral-500",
+          )}
+        />
+        {isPrimary && <span>Download All</span>}
+      </Button>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/components/contextual/OutputRenderers/components/OutputItem.tsx b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/components/OutputItem.tsx
new file mode 100644
index 0000000000..c5c91d5d48
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/components/OutputItem.tsx
@@ -0,0 +1,30 @@
+"use client";
+
+import { Text } from "@/components/atoms/Text/Text";
+import { OutputMetadata, OutputRenderer } from "../types";
+
+interface OutputItemProps {
+  value: any;
+  metadata?: OutputMetadata;
+  renderer: OutputRenderer;
+  label?: string;
+}
+
+export function OutputItem({
+  value,
+  metadata,
+  renderer,
+  label,
+}: OutputItemProps) {
+  return (
+    <div className="relative">
+      {label && (
+        <Text variant="large-medium" className="capitalize">
+          {label}
+        </Text>
+      )}
+
+      <div className="relative">{renderer.render(value, metadata)}</div>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/components/contextual/OutputRenderers/index.ts b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/index.ts
new file mode 100644
index 0000000000..ba26054eb2
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/index.ts
@@ -0,0 +1,20 @@
+import { globalRegistry } from "./types";
+import { textRenderer } from "./renderers/TextRenderer";
+import { codeRenderer } from "./renderers/CodeRenderer";
+import { imageRenderer } from "./renderers/ImageRenderer";
+import { videoRenderer } from "./renderers/VideoRenderer";
+import { jsonRenderer } from "./renderers/JSONRenderer";
+import { markdownRenderer } from "./renderers/MarkdownRenderer";
+
+// Register all renderers in priority order
+globalRegistry.register(videoRenderer);
+globalRegistry.register(imageRenderer);
+globalRegistry.register(codeRenderer);
+globalRegistry.register(markdownRenderer);
+globalRegistry.register(jsonRenderer);
+globalRegistry.register(textRenderer);
+
+export { globalRegistry };
+export type { OutputRenderer, OutputMetadata, DownloadContent } from "./types";
+export { OutputItem } from "./components/OutputItem";
+export { OutputActions } from "./components/OutputActions";
diff --git a/autogpt_platform/frontend/src/components/contextual/OutputRenderers/renderers/CodeRenderer.tsx b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/renderers/CodeRenderer.tsx
new file mode 100644
index 0000000000..93df7d8ddd
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/renderers/CodeRenderer.tsx
@@ -0,0 +1,135 @@
+import React from "react";
+import {
+  OutputRenderer,
+  OutputMetadata,
+  DownloadContent,
+  CopyContent,
+} from "../types";
+
+function getFileExtension(language: string): string {
+  const extensionMap: Record<string, string> = {
+    javascript: "js",
+    typescript: "ts",
+    python: "py",
+    java: "java",
+    csharp: "cs",
+    cpp: "cpp",
+    c: "c",
+    html: "html",
+    css: "css",
+    json: "json",
+    xml: "xml",
+    yaml: "yaml",
+    markdown: "md",
+    sql: "sql",
+    bash: "sh",
+    shell: "sh",
+    plaintext: "txt",
+  };
+
+  return extensionMap[language.toLowerCase()] || "txt";
+}
+
+function canRenderCode(value: unknown, metadata?: OutputMetadata): boolean {
+  if (metadata?.type === "code" || metadata?.language) {
+    return typeof value === "string";
+  }
+
+  if (typeof value !== "string") return false;
+
+  const markdownIndicators = [
+    /^#{1,6}\s+/m,
+    /\*\*[^*]+\*\*/,
+    /\[([^\]]+)\]\(([^)]+)\)/,
+    /^>\s+/m,
+    /^\s*[-*+]\s+\w+/m,
+    /!\[([^\]]*)\]\(([^)]+)\)/,
+  ];
+
+  let markdownMatches = 0;
+  for (const pattern of markdownIndicators) {
+    if (pattern.test(value)) {
+      markdownMatches++;
+      if (markdownMatches >= 2) {
+        return false;
+      }
+    }
+  }
+
+  const codeIndicators = [
+    /^(function|const|let|var|class|import|export|if|for|while)\s/m,
+    /^def\s+\w+\s*\(/m,
+    /^import\s+/m,
+    /^from\s+\w+\s+import/m,
+    /^\s*<[^>]+>/,
+    /[{}[\]();]/,
+  ];
+
+  return codeIndicators.some((pattern) => pattern.test(value));
+}
+
+function renderCode(
+  value: unknown,
+  metadata?: OutputMetadata,
+): React.ReactNode {
+  const codeValue = String(value);
+  const language = metadata?.language || "plaintext";
+
+  return (
+    <div className="group relative">
+      {metadata?.language && (
+        <div className="absolute right-2 top-2 rounded bg-background/80 px-2 py-1 text-xs text-muted-foreground">
+          {language}
+        </div>
+      )}
+      <pre className="overflow-x-auto rounded-md bg-muted p-3">
+        <code className="font-mono text-sm">{codeValue}</code>
+      </pre>
+    </div>
+  );
+}
+
+function getCopyContentCode(
+  value: unknown,
+  _metadata?: OutputMetadata,
+): CopyContent | null {
+  const codeValue = String(value);
+  return {
+    mimeType: "text/plain",
+    data: codeValue,
+    fallbackText: codeValue,
+  };
+}
+
+function getDownloadContentCode(
+  value: unknown,
+  metadata?: OutputMetadata,
+): DownloadContent | null {
+  const codeValue = String(value);
+  const language = metadata?.language || "txt";
+  const extension = getFileExtension(language);
+  const blob = new Blob([codeValue], { type: "text/plain" });
+
+  return {
+    data: blob,
+    filename: metadata?.filename || `code.${extension}`,
+    mimeType: "text/plain",
+  };
+}
+
+function isConcatenableCode(
+  _value: unknown,
+  _metadata?: OutputMetadata,
+): boolean {
+  return true;
+}
+
+export const codeRenderer: OutputRenderer = {
+  name: "CodeRenderer",
+  priority: 30,
+  canRender: canRenderCode,
+  render: renderCode,
+  getCopyContent: getCopyContentCode,
+  getDownloadContent: getDownloadContentCode,
+  isConcatenable: isConcatenableCode,
+};
diff --git a/autogpt_platform/frontend/src/components/contextual/OutputRenderers/renderers/ImageRenderer.tsx b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/renderers/ImageRenderer.tsx
new file mode 100644
index 0000000000..f2a7636c6e
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/renderers/ImageRenderer.tsx
@@ -0,0 +1,209 @@
+import React from "react";
+import {
+  OutputRenderer,
+  OutputMetadata,
+  DownloadContent,
+  CopyContent,
+} from "../types";
+
+const imageExtensions = [
+  ".jpg",
+  ".jpeg",
+  ".png",
+  ".gif",
+  ".bmp",
+  ".svg",
+  ".webp",
+  ".ico",
+];
+
+const imageMimeTypes = [
+  "image/jpeg",
+  "image/png",
+  "image/gif",
+  "image/bmp",
+  "image/svg+xml",
+  "image/webp",
+  "image/x-icon",
+];
+
+function guessMimeType(url: string): string | null {
+  const extension = url.split(".").pop()?.toLowerCase();
+  const mimeMap: Record<string, string> = {
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    png: "image/png",
+    gif: "image/gif",
+    bmp: "image/bmp",
+    svg: "image/svg+xml",
+    webp: "image/webp",
+    ico: "image/x-icon",
+  };
+  return extension ? mimeMap[extension] || null : null;
+}
+
+function canRenderImage(value: unknown, metadata?: OutputMetadata): boolean {
+  if (
+    metadata?.type === "image" ||
+    (metadata?.mimeType && imageMimeTypes.includes(metadata.mimeType))
+  ) {
+    return true;
+  }
+
+  if (typeof value === "object" && value !== null) {
+    const obj = value as any;
+    if (obj.url || obj.data || obj.path) {
+      const urlOrData = obj.url || obj.data || obj.path;
+
+      if (typeof urlOrData === "string") {
+        if (urlOrData.startsWith("data:image/")) {
+          return true;
+        }
+
+        if (
+          urlOrData.startsWith("http://") ||
+          urlOrData.startsWith("https://")
+        ) {
+          const hasImageExt = imageExtensions.some((ext) =>
+            urlOrData.toLowerCase().includes(ext),
+          );
+          return hasImageExt;
+        }
+      }
+    }
+
+    if (obj.filename) {
+      const hasImageExt = imageExtensions.some((ext) =>
+        obj.filename.toLowerCase().endsWith(ext),
+      );
+      return hasImageExt;
+    }
+  }
+
+  if (typeof value === "string") {
+    if (value.startsWith("data:image/")) {
+      return true;
+    }
+
+    if (value.startsWith("http://") || value.startsWith("https://")) {
+      const hasImageExt = imageExtensions.some((ext) =>
+        value.toLowerCase().includes(ext),
+      );
+      return hasImageExt;
+    }
+
+    if (metadata?.filename) {
+      const hasImageExt = imageExtensions.some((ext) =>
+        metadata.filename!.toLowerCase().endsWith(ext),
+      );
+      return hasImageExt;
+    }
+  }
+
+  return false;
+}
+
+function renderImage(
+  value: unknown,
+  metadata?: OutputMetadata,
+): React.ReactNode {
+  const imageUrl = String(value);
+  const altText = metadata?.filename || "Output image";
+
+  return (
+    <div className="group relative">
+      {/* eslint-disable-next-line @next/next/no-img-element */}
+      <img
+        src={imageUrl}
+        alt={altText}
+        className="h-auto max-w-full rounded-md border border-gray-200"
+        loading="lazy"
+      />
+    </div>
+  );
+}
+
+function getCopyContentImage(
+  value: unknown,
+  metadata?: OutputMetadata,
+): CopyContent | null {
+  const imageUrl = String(value);
+
+  if (imageUrl.startsWith("data:")) {
+    const mimeMatch = imageUrl.match(/data:([^;]+)/);
+    const mimeType = mimeMatch?.[1] || "image/png";
+
+    return {
+      mimeType: mimeType,
+      data: async () => {
+        const response = await fetch(imageUrl);
+        return await response.blob();
+      },
+      alternativeMimeTypes: ["image/png", "text/plain"],
+      fallbackText: imageUrl,
+    };
+  }
+
+  const mimeType = metadata?.mimeType || guessMimeType(imageUrl) || "image/png";
+
+  return {
+    mimeType: mimeType,
+    data: async () => {
+      const response = await fetch(imageUrl);
+      return await response.blob();
+    },
+    alternativeMimeTypes: ["image/png", "text/plain"],
+    fallbackText: imageUrl,
+  };
+}
+
+function getDownloadContentImage(
+  value: unknown,
+  metadata?: OutputMetadata,
+): DownloadContent | null {
+  const imageUrl = String(value);
+
+  if (imageUrl.startsWith("data:")) {
+    const [mimeInfo, base64Data] = imageUrl.split(",");
+    const mimeType = mimeInfo.match(/data:([^;]+)/)?.[1] || "image/png";
+    const byteCharacters = atob(base64Data);
+    const byteNumbers = new Array(byteCharacters.length);
+
+    for (let i = 0; i < byteCharacters.length; i++) {
+      byteNumbers[i] = byteCharacters.charCodeAt(i);
+    }
+
+    const byteArray = new Uint8Array(byteNumbers);
+    const blob = new Blob([byteArray], { type: mimeType });
+
+    const extension = mimeType.split("/")[1] || "png";
+    return {
+      data: blob,
+      filename: metadata?.filename || `image.${extension}`,
+      mimeType,
+    };
+  }
+
+  return {
+    data: imageUrl,
+    filename: metadata?.filename || "image.png",
+    mimeType: metadata?.mimeType || "image/png",
+  };
+}
+
+function isConcatenableImage(
+  _value: unknown,
+  _metadata?: OutputMetadata,
+): boolean {
+  return false;
+}
+
+export const imageRenderer: OutputRenderer = {
+  name: "ImageRenderer",
+  priority: 40,
+  canRender: canRenderImage,
+  render: renderImage,
+  getCopyContent: getCopyContentImage,
+  getDownloadContent: getDownloadContentImage,
+  isConcatenable: isConcatenableImage,
+};
diff --git a/autogpt_platform/frontend/src/components/contextual/OutputRenderers/renderers/JSONRenderer.tsx b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/renderers/JSONRenderer.tsx
new file mode 100644
index 0000000000..668f9179c3
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/renderers/JSONRenderer.tsx
@@ -0,0 +1,204 @@
+"use client";
+
+import React, { useState } from "react";
+import { CaretDown, CaretRight } from "@phosphor-icons/react";
+import {
+  OutputRenderer,
+  OutputMetadata,
+  DownloadContent,
+  CopyContent,
+} from "../types";
+
+function canRenderJSON(value: unknown, _metadata?: OutputMetadata): boolean {
+  if (_metadata?.type === "json") {
+    return true;
+  }
+
+  if (typeof value === "object" && value !== null) {
+    return true;
+  }
+
+  if (typeof value === "string") {
+    try {
+      JSON.parse(value);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  return false;
+}
+
+function renderJSON(
+  value: unknown,
+  _metadata?: OutputMetadata,
+): React.ReactNode {
+  let jsonData = value;
+
+  if (typeof value === "string") {
+    try {
+      jsonData = JSON.parse(value);
+    } catch {
+      return null;
+    }
+  }
+
+  return <JSONViewer data={jsonData} />;
+}
+
+function getCopyContentJSON(
+  value: unknown,
+  _metadata?: OutputMetadata,
+): CopyContent | null {
+  const jsonString =
+    typeof value === "string" ? value : JSON.stringify(value, null, 2);
+
+  return {
+    mimeType: "application/json",
+    data: jsonString,
+    alternativeMimeTypes: ["text/plain"],
+    fallbackText: jsonString,
+  };
+}
+
+function getDownloadContentJSON(
+  value: unknown,
+  _metadata?: OutputMetadata,
+): DownloadContent | null {
+  const jsonString =
+    typeof value === "string" ? value : JSON.stringify(value, null, 2);
+  const blob = new Blob([jsonString], { type: "application/json" });
+
+  return {
+    data: blob,
+    filename: _metadata?.filename || "output.json",
+    mimeType: "application/json",
+  };
+}
+
+function isConcatenableJSON(
+  _value: unknown,
+  _metadata?: OutputMetadata,
+): boolean {
+  return true;
+}
+
+export const jsonRenderer: OutputRenderer = {
+  name: "JSONRenderer",
+  priority: 20,
+  canRender: canRenderJSON,
+  render: renderJSON,
+  getCopyContent: getCopyContentJSON,
+  getDownloadContent: getDownloadContentJSON,
+  isConcatenable: isConcatenableJSON,
+};
+
+function JSONViewer({ data }: { data: any }) {
+  const [collapsed, setCollapsed] = useState<Record<string, boolean>>({});
+
+  const toggleCollapse = (key: string) => {
+    setCollapsed((prev) => ({ ...prev, [key]: !prev[key] }));
+  };
+
+  const renderValue = (value: any, key: string = ""): React.ReactNode => {
+    if (value === null)
+      return <span className="text-muted-foreground">null</span>;
+    if (value === undefined)
+      return <span className="text-muted-foreground">undefined</span>;
+
+    if (typeof value === "boolean") {
+      return <span className="text-blue-600">{value.toString()}</span>;
+    }
+
+    if (typeof value === "number") {
+      return <span className="text-green-600">{value}</span>;
+    }
+
+    if (typeof value === "string") {
+      return <span className="text-orange-600">&quot;{value}&quot;</span>;
+    }
+
+    if (Array.isArray(value)) {
+      const isCollapsed = collapsed[key];
+      const itemCount = value.length;
+
+      if (itemCount === 0) {
+        return <span className="text-muted-foreground">[]</span>;
+      }
+
+      return (
+        <div className="inline-block">
+          <button
+            onClick={() => toggleCollapse(key)}
+            className="inline-flex items-center rounded px-1 hover:bg-muted"
+          >
+            {isCollapsed ? (
+              <CaretRight className="size-3" />
+            ) : (
+              <CaretDown className="size-3" />
+            )}
+            <span className="ml-1 text-muted-foreground">
+              Array({itemCount})
+            </span>
+          </button>
+          {!isCollapsed && (
+            <div className="ml-4 mt-1">
+              {value.map((item, index) => (
+                <div key={index} className="flex">
+                  <span className="mr-2 text-muted-foreground">{index}:</span>
+                  {renderValue(item, `${key}[${index}]`)}
+                </div>
+              ))}
+            </div>
+          )}
+        </div>
+      );
+    }
+
+    if (typeof value === "object") {
+      const isCollapsed = collapsed[key];
+      const keys = Object.keys(value);
+
+      if (keys.length === 0) {
+        return <span className="text-muted-foreground">{"{}"}</span>;
+      }
+
+      return (
+        <div className="inline-block">
+          <button
+            onClick={() => toggleCollapse(key)}
+            className="inline-flex items-center rounded px-1 hover:bg-muted"
+          >
+            {isCollapsed ? (
+              <CaretRight className="size-3" />
+            ) : (
+              <CaretDown className="size-3" />
+            )}
+            <span className="ml-1 text-muted-foreground">Object</span>
+          </button>
+          {!isCollapsed && (
+            <div className="ml-4 mt-1">
+              {keys.map((objKey) => (
+                <div key={objKey} className="flex">
+                  <span className="mr-2 text-purple-600">
+                    &quot;{objKey}&quot;:
+                  </span>
+                  {renderValue(value[objKey], `${key}.${objKey}`)}
+                </div>
+              ))}
+            </div>
+          )}
+        </div>
+      );
+    }
+
+    return <span className="text-muted-foreground">{String(value)}</span>;
+  };
+
+  return (
+    <div className="overflow-x-auto rounded-md bg-muted p-3 font-mono text-sm">
+      {renderValue(data, "root")}
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/components/contextual/OutputRenderers/renderers/MarkdownRenderer.tsx b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/renderers/MarkdownRenderer.tsx
new file mode 100644
index 0000000000..d94966c6c8
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/renderers/MarkdownRenderer.tsx
@@ -0,0 +1,456 @@
+"use client";
+
+import React from "react";
+import ReactMarkdown from "react-markdown";
+import remarkGfm from "remark-gfm";
+import remarkMath from "remark-math";
+import rehypeKatex from "rehype-katex";
+import rehypeHighlight from "rehype-highlight";
+import rehypeSlug from "rehype-slug";
+import rehypeAutolinkHeadings from "rehype-autolink-headings";
+import {
+  OutputRenderer,
+  OutputMetadata,
+  DownloadContent,
+  CopyContent,
+} from "../types";
+import "highlight.js/styles/github-dark.css";
+import "katex/dist/katex.min.css";
+
+const markdownPatterns = [
+  /```[\s\S]*?```/u, // Fenced code blocks (check first)
+  /^#{1,6}\s+\S+/gmu, // ATX headers (require content)
+  /\*\*[^*\n]+?\*\*/u, // **bold**
+  /__(?!_)[^_\n]+?__(?!_)/u, // __bold__ (avoid ___/snake_case_)
+  /(?<!\*)\*(?!\*)(?:[^*\n]|(?<=\\)\*)+?(?<!\\)\*(?!\*)/u, // *italic* (try to avoid **)
+  /(?<!_)_(?!_)(?:[^_\n]|(?<=\\)_)+?(?<!\\)_(?!_)/u, // _italic_ with guards
+  /\[([^\]\n]+)\]\(([^)\s]+)(?:\s+"[^"]*")?\)/u, // Links with optional title (simple)
+  /!\[([^\]\n]*)\]\(([^)\s]+)(?:\s+"[^"]*")?\)/u, // Images with optional title (simple)
+  /`[^`\n]+`/u, // Inline code
+  /^(?:\s*[-*+]\s+\S.*)(?:\n\s*[-*+]\s+\S.*)+$/gmu, // UL list (≥2 items)
+  /^(?:\s*\d+\.\s+\S.*)(?:\n\s*\d+\.\s+\S.*)+$/gmu, // OL list (≥2 items)
+  /^>\s+\S.*/gm, // Blockquotes
+  /^\|[^|\n]+(\|[^|\n]+)+\|\s*$/gm, // Table row (at least two cells)
+  /^\s*\|(?:\s*:?[-=]{3,}\s*\|)+\s*$/gm, // Table separator row
+  /\$\$[\s\S]+?\$\$/u, // Display math
+  /(?<!\\)(?<!\w)\$[^$\n]+?\$(?!\w)/u, // Inline math: avoid prices/ids
+];
+
+const videoExtensions = [".mp4", ".webm", ".ogg", ".mov", ".avi"];
+
+function isVideoUrl(url: string): boolean {
+  if (url.includes("youtube.com/watch") || url.includes("youtu.be/")) {
+    return true;
+  }
+  try {
+    const parsed = new URL(url);
+    if (
+      parsed.hostname === "vimeo.com" ||
+      parsed.hostname === "www.vimeo.com"
+    ) {
+      return true;
+    }
+  } catch {
+    // If URL parsing fails, treat as not a Vimeo URL.
+  }
+  return videoExtensions.some((ext) => url.toLowerCase().includes(ext));
+}
+
+function getVideoEmbedUrl(url: string): string | null {
+  const youtubeMatch = url.match(
+    /(?:youtube\.com\/watch\?v=|youtu\.be\/)([^&\s]+)/,
+  );
+  if (youtubeMatch) {
+    return `https://www.youtube.com/embed/${youtubeMatch[1]}`;
+  }
+
+  const vimeoMatch = url.match(/vimeo\.com\/(\d+)/);
+  if (vimeoMatch) {
+    return `https://player.vimeo.com/video/${vimeoMatch[1]}`;
+  }
+
+  if (videoExtensions.some((ext) => url.toLowerCase().includes(ext))) {
+    return url;
+  }
+
+  return null;
+}
+
+function renderVideoEmbed(url: string): React.ReactNode {
+  const embedUrl = getVideoEmbedUrl(url);
+
+  if (!embedUrl) {
+    return (
+      <a
+        href={url}
+        target="_blank"
+        rel="noopener noreferrer"
+        className="text-blue-600 underline"
+      >
+        {url}
+      </a>
+    );
+  }
+
+  if (videoExtensions.some((ext) => embedUrl.toLowerCase().includes(ext))) {
+    return (
+      <div className="my-4">
+        <video
+          controls
+          className="w-full max-w-2xl rounded-lg shadow-md"
+          preload="metadata"
+        >
+          <source src={embedUrl} />
+          Your browser does not support the video tag.
+        </video>
+      </div>
+    );
+  }
+
+  return (
+    <div className="my-4">
+      <div className="relative aspect-video">
+        <iframe
+          src={embedUrl}
+          title="Embedded video player"
+          className="absolute left-0 top-0 h-full w-full rounded-lg shadow-md"
+          allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+          allowFullScreen
+        />
+      </div>
+    </div>
+  );
+}
+
+function canRenderMarkdown(value: unknown, metadata?: OutputMetadata): boolean {
+  if (
+    metadata?.type === "markdown" ||
+    metadata?.mimeType === "text/markdown" ||
+    metadata?.mimeType === "text/x-markdown"
+  ) {
+    return true;
+  }
+
+  if (typeof value !== "string") {
+    return false;
+  }
+
+  if (metadata?.filename?.toLowerCase().endsWith(".md")) {
+    return true;
+  }
+
+  let matchCount = 0;
+  const requiredMatches = 2;
+
+  for (const pattern of markdownPatterns) {
+    if (pattern.test(value)) {
+      matchCount++;
+      if (matchCount >= requiredMatches) {
+        return true;
+      }
+    }
+  }
+
+  return false;
+}
+
+function renderMarkdown(
+  value: unknown,
+  _metadata?: OutputMetadata,
+): React.ReactNode {
+  const markdownContent = String(value);
+
+  return (
+    <div className="markdown-output">
+      <ReactMarkdown
+        className="prose prose-sm dark:prose-invert max-w-none"
+        remarkPlugins={[
+          remarkGfm, // GitHub Flavored Markdown (tables, task lists, strikethrough)
+          [remarkMath, { singleDollarTextMath: false }], // Math support for LaTeX
+        ]}
+        rehypePlugins={[
+          rehypeKatex, // Render math with KaTeX
+          rehypeHighlight, // Syntax highlighting for code blocks
+          rehypeSlug, // Add IDs to headings
+          [rehypeAutolinkHeadings, { behavior: "wrap" }], // Make headings clickable
+        ]}
+        components={{
+          // Custom components for better rendering
+          pre: ({ children, ...props }) => (
+            <pre
+              className="my-4 overflow-x-auto rounded-md bg-gray-900 p-4 dark:bg-gray-950"
+              {...props}
+            >
+              {children}
+            </pre>
+          ),
+          code: ({ children, ...props }: any) => {
+            // Check if it's inline code by looking at the parent
+            const isInline = !props.className?.includes("language-");
+            if (isInline) {
+              return (
+                <code
+                  className="rounded bg-gray-100 px-1.5 py-0.5 font-mono text-sm text-gray-800 dark:bg-gray-800 dark:text-gray-200"
+                  {...props}
+                >
+                  {children}
+                </code>
+              );
+            }
+            // Block code is handled by rehype-highlight
+            return (
+              <code className="font-mono text-sm text-gray-100" {...props}>
+                {children}
+              </code>
+            );
+          },
+          a: ({ children, href, ...props }) => (
+            <a
+              href={href}
+              target="_blank"
+              rel="noopener noreferrer"
+              className="text-black underline decoration-1 underline-offset-2 transition-colors"
+              {...props}
+            >
+              {children}
+            </a>
+          ),
+          blockquote: ({ children, ...props }) => (
+            <blockquote
+              className="my-4 border-l-4 border-blue-500 pl-4 italic text-gray-700 dark:border-blue-400 dark:text-gray-300"
+              {...props}
+            >
+              {children}
+            </blockquote>
+          ),
+          table: ({ children, ...props }) => (
+            <div className="my-4 overflow-x-auto">
+              <table
+                className="min-w-full divide-y divide-gray-200 rounded-lg border border-gray-200 dark:divide-gray-700 dark:border-gray-700"
+                {...props}
+              >
+                {children}
+              </table>
+            </div>
+          ),
+          th: ({ children, ...props }) => (
+            <th
+              className="bg-gray-50 px-4 py-3 text-left text-xs font-semibold uppercase tracking-wider text-gray-700 dark:bg-gray-800 dark:text-gray-300"
+              {...props}
+            >
+              {children}
+            </th>
+          ),
+          td: ({ children, ...props }) => (
+            <td
+              className="border-t border-gray-200 px-4 py-3 text-sm text-gray-600 dark:border-gray-700 dark:text-gray-400"
+              {...props}
+            >
+              {children}
+            </td>
+          ),
+          // GitHub Flavored Markdown task lists
+          input: ({ ...props }: any) => {
+            if (props.type === "checkbox") {
+              return (
+                <input
+                  type="checkbox"
+                  className="mr-2 h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500 disabled:cursor-not-allowed disabled:opacity-70"
+                  disabled
+                  {...props}
+                />
+              );
+            }
+            return <input {...props} />;
+          },
+          // Better list styling
+          ul: ({ children, ...props }: any) => (
+            <ul
+              className={`my-4 list-disc space-y-2 pl-6 ${
+                props.className?.includes("contains-task-list")
+                  ? "list-none pl-0"
+                  : ""
+              }`}
+              {...props}
+            >
+              {children}
+            </ul>
+          ),
+          ol: ({ children, ...props }) => (
+            <ol className="my-4 list-decimal space-y-2 pl-6" {...props}>
+              {children}
+            </ol>
+          ),
+          li: ({ children, ...props }: any) => (
+            <li
+              className={`text-gray-700 dark:text-gray-300 ${
+                props.className?.includes("task-list-item")
+                  ? "flex items-start"
+                  : ""
+              }`}
+              {...props}
+            >
+              {children}
+            </li>
+          ),
+          // Better heading styles
+          h1: ({ children, ...props }) => (
+            <h1
+              className="my-6 text-3xl font-bold text-gray-900 dark:text-gray-100"
+              {...props}
+            >
+              {children}
+            </h1>
+          ),
+          h2: ({ children, ...props }) => (
+            <h2
+              className="my-5 text-2xl font-semibold text-gray-800 dark:text-gray-200"
+              {...props}
+            >
+              {children}
+            </h2>
+          ),
+          h3: ({ children, ...props }) => (
+            <h3
+              className="my-4 text-xl font-semibold text-gray-800 dark:text-gray-200"
+              {...props}
+            >
+              {children}
+            </h3>
+          ),
+          h4: ({ children, ...props }) => (
+            <h4
+              className="my-3 text-lg font-medium text-gray-700 dark:text-gray-300"
+              {...props}
+            >
+              {children}
+            </h4>
+          ),
+          h5: ({ children, ...props }) => (
+            <h5
+              className="my-2 text-base font-medium text-gray-700 dark:text-gray-300"
+              {...props}
+            >
+              {children}
+            </h5>
+          ),
+          h6: ({ children, ...props }) => (
+            <h6
+              className="my-2 text-sm font-medium text-gray-600 dark:text-gray-400"
+              {...props}
+            >
+              {children}
+            </h6>
+          ),
+          // Horizontal rule
+          hr: ({ ...props }) => (
+            <hr
+              className="my-6 border-gray-300 dark:border-gray-700"
+              {...props}
+            />
+          ),
+          // Strikethrough (GFM)
+          del: ({ children, ...props }) => (
+            <del
+              className="text-gray-500 line-through dark:text-gray-500"
+              {...props}
+            >
+              {children}
+            </del>
+          ),
+          // Image handling
+          img: ({ src, alt, ...props }) => {
+            // Check if it's a video URL pattern
+            if (src && isVideoUrl(src)) {
+              return renderVideoEmbed(src);
+            }
+
+            return (
+              // eslint-disable-next-line @next/next/no-img-element
+              <img
+                src={src}
+                alt={alt}
+                className="my-4 h-auto max-w-full rounded-lg shadow-md"
+                loading="lazy"
+                {...props}
+              />
+            );
+          },
+          // Custom paragraph to handle standalone video URLs
+          p: ({ children, ...props }) => {
+            // Check if paragraph contains just a video URL
+            if (typeof children === "string" && isVideoUrl(children.trim())) {
+              return renderVideoEmbed(children.trim());
+            }
+
+            // Check for video URLs in link children
+            if (React.Children.count(children) === 1) {
+              const child = React.Children.toArray(children)[0];
+              if (React.isValidElement(child) && child.type === "a") {
+                const href = child.props.href;
+                if (href && isVideoUrl(href)) {
+                  return renderVideoEmbed(href);
+                }
+              }
+            }
+
+            return (
+              <p
+                className="my-3 leading-relaxed text-gray-700 dark:text-gray-300"
+                {...props}
+              >
+                {children}
+              </p>
+            );
+          },
+        }}
+      >
+        {markdownContent}
+      </ReactMarkdown>
+    </div>
+  );
+}
+
+function getCopyContentMarkdown(
+  value: unknown,
+  _metadata?: OutputMetadata,
+): CopyContent | null {
+  const markdownText = String(value);
+  return {
+    mimeType: "text/markdown",
+    data: markdownText,
+    fallbackText: markdownText,
+    alternativeMimeTypes: ["text/plain"],
+  };
+}
+
+function getDownloadContentMarkdown(
+  value: unknown,
+  metadata?: OutputMetadata,
+): DownloadContent | null {
+  const markdownText = String(value);
+  const blob = new Blob([markdownText], { type: "text/markdown" });
+
+  return {
+    data: blob,
+    filename: metadata?.filename || "output.md",
+    mimeType: "text/markdown",
+  };
+}
+
+function isConcatenableMarkdown(
+  _value: unknown,
+  _metadata?: OutputMetadata,
+): boolean {
+  return true;
+}
+
+export const markdownRenderer: OutputRenderer = {
+  name: "MarkdownRenderer",
+  priority: 35,
+  canRender: canRenderMarkdown,
+  render: renderMarkdown,
+  getCopyContent: getCopyContentMarkdown,
+  getDownloadContent: getDownloadContentMarkdown,
+  isConcatenable: isConcatenableMarkdown,
+};
diff --git a/autogpt_platform/frontend/src/components/contextual/OutputRenderers/renderers/TextRenderer.tsx b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/renderers/TextRenderer.tsx
new file mode 100644
index 0000000000..725743fb7e
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/renderers/TextRenderer.tsx
@@ -0,0 +1,71 @@
+import React from "react";
+import {
+  OutputRenderer,
+  OutputMetadata,
+  DownloadContent,
+  CopyContent,
+} from "../types";
+
+function canRenderText(value: unknown, _metadata?: OutputMetadata): boolean {
+  return (
+    typeof value === "string" ||
+    typeof value === "number" ||
+    typeof value === "boolean"
+  );
+}
+
+function renderText(
+  value: unknown,
+  _metadata?: OutputMetadata,
+): React.ReactNode {
+  const textValue = String(value);
+
+  return (
+    <p className="resize-none overflow-x-auto whitespace-pre-wrap break-words border-none text-sm text-neutral-700">
+      {textValue}
+    </p>
+  );
+}
+
+function getCopyContentText(
+  value: unknown,
+  _metadata?: OutputMetadata,
+): CopyContent | null {
+  const textValue = String(value);
+  return {
+    mimeType: "text/plain",
+    data: textValue,
+    fallbackText: textValue,
+  };
+}
+
+function getDownloadContentText(
+  value: unknown,
+  _metadata?: OutputMetadata,
+): DownloadContent | null {
+  const textValue = String(value);
+  const blob = new Blob([textValue], { type: "text/plain" });
+
+  return {
+    data: blob,
+    filename: _metadata?.filename || "output.txt",
+    mimeType: "text/plain",
+  };
+}
+
+function isConcatenableText(
+  _value: unknown,
+  _metadata?: OutputMetadata,
+): boolean {
+  return true;
+}
+
+export const textRenderer: OutputRenderer = {
+  name: "TextRenderer",
+  priority: 0,
+  canRender: canRenderText,
+  render: renderText,
+  getCopyContent: getCopyContentText,
+  getDownloadContent: getDownloadContentText,
+  isConcatenable: isConcatenableText,
+};
diff --git a/autogpt_platform/frontend/src/components/contextual/OutputRenderers/renderers/VideoRenderer.tsx b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/renderers/VideoRenderer.tsx
new file mode 100644
index 0000000000..bd74eacbd6
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/renderers/VideoRenderer.tsx
@@ -0,0 +1,169 @@
+import React from "react";
+import {
+  OutputRenderer,
+  OutputMetadata,
+  DownloadContent,
+  CopyContent,
+} from "../types";
+
+const videoExtensions = [
+  ".mp4",
+  ".webm",
+  ".ogg",
+  ".mov",
+  ".avi",
+  ".mkv",
+  ".m4v",
+];
+
+const videoMimeTypes = [
+  "video/mp4",
+  "video/webm",
+  "video/ogg",
+  "video/quicktime",
+  "video/x-msvideo",
+  "video/x-matroska",
+];
+
+function guessMimeType(url: string): string | null {
+  const extension = url.split(".").pop()?.toLowerCase();
+  const mimeMap: Record<string, string> = {
+    mp4: "video/mp4",
+    webm: "video/webm",
+    ogg: "video/ogg",
+    mov: "video/quicktime",
+    avi: "video/x-msvideo",
+    mkv: "video/x-matroska",
+    m4v: "video/mp4",
+  };
+  return extension ? mimeMap[extension] || null : null;
+}
+
+function canRenderVideo(value: unknown, metadata?: OutputMetadata): boolean {
+  if (
+    metadata?.type === "video" ||
+    (metadata?.mimeType && videoMimeTypes.includes(metadata.mimeType))
+  ) {
+    return true;
+  }
+
+  if (typeof value === "string") {
+    if (value.startsWith("data:video/")) {
+      return true;
+    }
+
+    if (value.startsWith("http://") || value.startsWith("https://")) {
+      return videoExtensions.some((ext) => value.toLowerCase().includes(ext));
+    }
+
+    if (metadata?.filename) {
+      return videoExtensions.some((ext) =>
+        metadata.filename!.toLowerCase().endsWith(ext),
+      );
+    }
+  }
+
+  return false;
+}
+
+function renderVideo(
+  value: unknown,
+  metadata?: OutputMetadata,
+): React.ReactNode {
+  const videoUrl = String(value);
+
+  return (
+    <div className="group relative">
+      <video
+        controls
+        className="h-auto max-w-full rounded-md border border-gray-200"
+        preload="metadata"
+      >
+        <source src={videoUrl} type={metadata?.mimeType || "video/mp4"} />
+        Your browser does not support the video tag.
+      </video>
+    </div>
+  );
+}
+
+function getCopyContentVideo(
+  value: unknown,
+  metadata?: OutputMetadata,
+): CopyContent | null {
+  const videoUrl = String(value);
+
+  if (videoUrl.startsWith("data:")) {
+    const mimeMatch = videoUrl.match(/data:([^;]+)/);
+    const mimeType = mimeMatch?.[1] || "video/mp4";
+
+    return {
+      mimeType: mimeType,
+      data: videoUrl,
+      alternativeMimeTypes: ["text/plain"],
+      fallbackText: videoUrl,
+    };
+  }
+
+  const mimeType = metadata?.mimeType || guessMimeType(videoUrl) || "video/mp4";
+
+  return {
+    mimeType: mimeType,
+    data: async () => {
+      const response = await fetch(videoUrl);
+      return await response.blob();
+    },
+    alternativeMimeTypes: ["text/plain"],
+    fallbackText: videoUrl,
+  };
+}
+
+function getDownloadContentVideo(
+  value: unknown,
+  metadata?: OutputMetadata,
+): DownloadContent | null {
+  const videoUrl = String(value);
+
+  if (videoUrl.startsWith("data:")) {
+    const [mimeInfo, base64Data] = videoUrl.split(",");
+    const mimeType = mimeInfo.match(/data:([^;]+)/)?.[1] || "video/mp4";
+    const byteCharacters = atob(base64Data);
+    const byteNumbers = new Array(byteCharacters.length);
+
+    for (let i = 0; i < byteCharacters.length; i++) {
+      byteNumbers[i] = byteCharacters.charCodeAt(i);
+    }
+
+    const byteArray = new Uint8Array(byteNumbers);
+    const blob = new Blob([byteArray], { type: mimeType });
+
+    const extension = mimeType.split("/")[1] || "mp4";
+    return {
+      data: blob,
+      filename: metadata?.filename || `video.${extension}`,
+      mimeType,
+    };
+  }
+
+  return {
+    data: videoUrl,
+    filename: metadata?.filename || "video.mp4",
+    mimeType: metadata?.mimeType || "video/mp4",
+  };
+}
+
+function isConcatenableVideo(
+  _value: unknown,
+  _metadata?: OutputMetadata,
+): boolean {
+  return false;
+}
+
+export const videoRenderer: OutputRenderer = {
+  name: "VideoRenderer",
+  priority: 45,
+  canRender: canRenderVideo,
+  render: renderVideo,
+  getCopyContent: getCopyContentVideo,
+  getDownloadContent: getDownloadContentVideo,
+  isConcatenable: isConcatenableVideo,
+};
diff --git a/autogpt_platform/frontend/src/components/contextual/OutputRenderers/types.ts b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/types.ts
new file mode 100644
index 0000000000..0b2c8ed6bf
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/types.ts
@@ -0,0 +1,60 @@
+import { ReactNode } from "react";
+
+export interface OutputMetadata {
+  type?: string;
+  language?: string;
+  mimeType?: string;
+  filename?: string;
+  [key: string]: any;
+}
+
+export interface DownloadContent {
+  data: Blob | string;
+  filename: string;
+  mimeType: string;
+}
+
+export interface CopyContent {
+  mimeType: string; // Primary MIME type to try
+  data: Blob | string | (() => Promise<Blob | string>); // Data or async function to get data
+  fallbackText?: string; // Optional fallback text if rich copy fails
+  alternativeMimeTypes?: string[]; // Alternative MIME types to try if primary isn't supported
+}
+
+export interface OutputRenderer {
+  name: string;
+  priority: number;
+  canRender(value: any, metadata?: OutputMetadata): boolean;
+  render(value: any, metadata?: OutputMetadata): ReactNode;
+  getCopyContent(value: any, metadata?: OutputMetadata): CopyContent | null;
+  getDownloadContent(
+    value: any,
+    metadata?: OutputMetadata,
+  ): DownloadContent | null;
+  isConcatenable(value: any, metadata?: OutputMetadata): boolean;
+}
+
+export class OutputRendererRegistry {
+  private renderers: OutputRenderer[] = [];
+
+  register(renderer: OutputRenderer): void {
+    const index = this.renderers.findIndex(
+      (r) => r.priority < renderer.priority,
+    );
+    if (index === -1) {
+      this.renderers.push(renderer);
+    } else {
+      this.renderers.splice(index, 0, renderer);
+    }
+  }
+
+  getRenderer(value: any, metadata?: OutputMetadata): OutputRenderer | null {
+    return this.renderers.find((r) => r.canRender(value, metadata)) || null;
+  }
+
+  getAllRenderers(): OutputRenderer[] {
+    return [...this.renderers];
+  }
+}
+
+export const globalRegistry = new OutputRendererRegistry();
diff --git a/autogpt_platform/frontend/src/components/contextual/OutputRenderers/utils/copy.ts b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/utils/copy.ts
new file mode 100644
index 0000000000..5b18f44669
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/utils/copy.ts
@@ -0,0 +1,115 @@
+import { CopyContent } from "../types";
+
+export function isClipboardTypeSupported(mimeType: string): boolean {
+  // ClipboardItem.supports() is the proper way to check
+  if ("ClipboardItem" in window && "supports" in ClipboardItem) {
+    return ClipboardItem.supports(mimeType);
+  }
+
+  // Fallback for browsers that don't support the supports() method
+  // These are generally supported
+  const fallbackSupported = ["text/plain", "text/html", "image/png"];
+
+  return fallbackSupported.includes(mimeType);
+}
+
+export function getSupportedClipboardType(
+  preferredTypes: string[],
+): string | null {
+  for (const type of preferredTypes) {
+    if (isClipboardTypeSupported(type)) {
+      return type;
+    }
+  }
+  return null;
+}
+
+export async function copyToClipboard(copyContent: CopyContent): Promise<void> {
+  try {
+    // Determine the best supported MIME type
+    const supportedTypes = [
+      copyContent.mimeType,
+      ...(copyContent.alternativeMimeTypes || []),
+    ];
+    const bestType = getSupportedClipboardType(supportedTypes);
+
+    if (!bestType) {
+      // No supported type found, use fallback text if available
+      if (copyContent.fallbackText) {
+        await navigator.clipboard.writeText(copyContent.fallbackText);
+        return;
+      }
+      throw new Error(
+        `None of the MIME types are supported: ${supportedTypes.join(", ")}`,
+      );
+    }
+
+    // Get the data (resolve if it's a function)
+    let data = copyContent.data;
+    if (typeof data === "function") {
+      data = await data();
+    }
+
+    // If data is already a Blob, use it directly
+    if (data instanceof Blob) {
+      // If we need a different MIME type than the blob has, recreate it
+      if (bestType !== data.type && bestType !== copyContent.mimeType) {
+        data = new Blob([data], { type: bestType });
+      }
+
+      await navigator.clipboard.write([
+        new ClipboardItem({
+          [bestType]: data,
+        }),
+      ]);
+      return;
+    }
+
+    // If data is a string
+    if (typeof data === "string") {
+      // For plain text, use the simpler writeText API
+      if (bestType === "text/plain") {
+        await navigator.clipboard.writeText(data);
+        return;
+      }
+
+      // For other text formats (HTML, JSON, etc.), create a blob
+      const blob = new Blob([data], { type: bestType });
+      await navigator.clipboard.write([
+        new ClipboardItem({
+          [bestType]: blob,
+        }),
+      ]);
+    }
+  } catch (_error) {
+    // If rich copy fails and we have fallback text, try that
+    if (copyContent.fallbackText) {
+      try {
+        await navigator.clipboard.writeText(copyContent.fallbackText);
+        return;
+      } catch {
+        // Even fallback failed
+      }
+    }
+    throw _error;
+  }
+}
+
+export async function fetchAndCopyImage(imageUrl: string): Promise<void> {
+  try {
+    const response = await fetch(imageUrl);
+    if (!response.ok) throw new Error("Failed to fetch image");
+
+    const blob = await response.blob();
+    const mimeType = blob.type || "image/png";
+
+    await navigator.clipboard.write([
+      new ClipboardItem({
+        [mimeType]: blob,
+      }),
+    ]);
+  } catch (_error) {
+    // If fetching fails (e.g., CORS), fall back to copying the URL
+    await navigator.clipboard.writeText(imageUrl);
+  }
+}
diff --git a/autogpt_platform/frontend/src/components/contextual/OutputRenderers/utils/download.ts b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/utils/download.ts
new file mode 100644
index 0000000000..78adda8029
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/contextual/OutputRenderers/utils/download.ts
@@ -0,0 +1,74 @@
+import { OutputRenderer, OutputMetadata } from "../types";
+
+export interface DownloadItem {
+  value: any;
+  metadata?: OutputMetadata;
+  renderer: OutputRenderer;
+}
+
+export async function downloadOutputs(items: DownloadItem[]) {
+  const concatenableTexts: string[] = [];
+  const nonConcatenableDownloads: Array<{ blob: Blob; filename: string }> = [];
+
+  for (const item of items) {
+    if (item.renderer.isConcatenable(item.value, item.metadata)) {
+      const copyContent = item.renderer.getCopyContent(
+        item.value,
+        item.metadata,
+      );
+      if (copyContent) {
+        // Extract text from CopyContent
+        let text: string;
+        if (typeof copyContent.data === "string") {
+          text = copyContent.data;
+        } else if (copyContent.fallbackText) {
+          text = copyContent.fallbackText;
+        } else {
+          continue;
+        }
+        concatenableTexts.push(text);
+      }
+    } else {
+      const downloadContent = item.renderer.getDownloadContent(
+        item.value,
+        item.metadata,
+      );
+      if (downloadContent) {
+        if (typeof downloadContent.data === "string") {
+          if (downloadContent.data.startsWith("http")) {
+            const link = document.createElement("a");
+            link.href = downloadContent.data;
+            link.download = downloadContent.filename;
+            link.click();
+          }
+        } else {
+          nonConcatenableDownloads.push({
+            blob: downloadContent.data as Blob,
+            filename: downloadContent.filename,
+          });
+        }
+      }
+    }
+  }
+
+  if (concatenableTexts.length > 0) {
+    const combinedText = concatenableTexts.join("\n\n---\n\n");
+    const blob = new Blob([combinedText], { type: "text/plain" });
+    downloadBlob(blob, "combined_output.txt");
+  }
+
+  for (const download of nonConcatenableDownloads) {
+    downloadBlob(download.blob, download.filename);
+  }
+}
+
+function downloadBlob(blob: Blob, filename: string) {
+  const url = URL.createObjectURL(blob);
+  const link = document.createElement("a");
+  link.href = url;
+  link.download = filename;
+  document.body.appendChild(link);
+  link.click();
+  document.body.removeChild(link);
+  URL.revokeObjectURL(url);
+}
diff --git a/autogpt_platform/frontend/src/components/contextual/PublishAgentModal/PublishAgentModal.tsx b/autogpt_platform/frontend/src/components/contextual/PublishAgentModal/PublishAgentModal.tsx
index dd91094f9c..da3324f600 100644
--- a/autogpt_platform/frontend/src/components/contextual/PublishAgentModal/PublishAgentModal.tsx
+++ b/autogpt_platform/frontend/src/components/contextual/PublishAgentModal/PublishAgentModal.tsx
@@ -20,6 +20,7 @@ export function PublishAgentModal({
   onStateChange,
   preSelectedAgentId,
   preSelectedAgentVersion,
+  showTrigger = true,
 }: Props) {
   const {
     // State
@@ -121,9 +122,11 @@ export function PublishAgentModal({
           },
         }}
       >
-        <Dialog.Trigger>
-          {trigger || <Button size="small">Publish Agent</Button>}
-        </Dialog.Trigger>
+        {showTrigger && (
+          <Dialog.Trigger>
+            {trigger || <Button size="small">Publish Agent</Button>}
+          </Dialog.Trigger>
+        )}
         <Dialog.Content>
           <div data-testid="publish-agent-modal">{renderContent()}</div>
         </Dialog.Content>
diff --git a/autogpt_platform/frontend/src/components/contextual/PublishAgentModal/components/AgentInfoStep/useAgentInfoStep.ts b/autogpt_platform/frontend/src/components/contextual/PublishAgentModal/components/AgentInfoStep/useAgentInfoStep.ts
index f3dcfa1f21..448d65b195 100644
--- a/autogpt_platform/frontend/src/components/contextual/PublishAgentModal/components/AgentInfoStep/useAgentInfoStep.ts
+++ b/autogpt_platform/frontend/src/components/contextual/PublishAgentModal/components/AgentInfoStep/useAgentInfoStep.ts
@@ -1,10 +1,8 @@
 import { useEffect, useCallback, useState } from "react";
 import { useForm } from "react-hook-form";
 import { zodResolver } from "@hookform/resolvers/zod";
-import { useQueryClient } from "@tanstack/react-query";
 import { useToast } from "@/components/molecules/Toast/use-toast";
 import { useBackendAPI } from "@/lib/autogpt-server-api/context";
-import { getGetV2ListMySubmissionsQueryKey } from "@/app/api/__generated__/endpoints/store/store";
 import * as Sentry from "@sentry/nextjs";
 import {
   PublishAgentFormData,
@@ -33,7 +31,6 @@ export function useAgentInfoStep({
   const [images, setImages] = useState<string[]>([]);
   const [isSubmitting, setIsSubmitting] = useState(false);
 
-  const queryClient = useQueryClient();
   const { toast } = useToast();
   const api = useBackendAPI();
 
@@ -54,23 +51,26 @@ export function useAgentInfoStep({
   });
 
   useEffect(() => {
-    if (initialData) {
+    if (initialData?.agent_id) {
       setAgentId(initialData.agent_id);
-      const initialImages = [
-        ...(initialData?.thumbnailSrc ? [initialData.thumbnailSrc] : []),
-        ...(initialData.additionalImages || []),
-      ];
-      setImages(initialImages);
-
-      // Update form with initial data
+      setImages(
+        Array.from(
+          new Set([
+            ...(initialData?.thumbnailSrc ? [initialData.thumbnailSrc] : []),
+            ...(initialData.additionalImages || []),
+          ]),
+        ),
+      );
       form.reset({
-        changesSummary: initialData.changesSummary || "",
+        changesSummary: isMarketplaceUpdate
+          ? ""
+          : initialData.changesSummary || "",
         title: initialData.title,
         subheader: initialData.subheader,
         slug: initialData.slug.toLocaleLowerCase().trim(),
         youtubeLink: initialData.youtubeLink,
         category: initialData.category,
-        description: initialData.description,
+        description: isMarketplaceUpdate ? "" : initialData.description,
         recommendedScheduleCron: initialData.recommendedScheduleCron || "",
         instructions: initialData.instructions || "",
         agentOutputDemo: initialData.agentOutputDemo || "",
@@ -78,6 +78,13 @@ export function useAgentInfoStep({
     }
   }, [initialData, form]);
 
+  // Ensure agentId is set from selectedAgentId if initialData doesn't have it
+  useEffect(() => {
+    if (selectedAgentId && !agentId) {
+      setAgentId(selectedAgentId);
+    }
+  }, [selectedAgentId, agentId]);
+
   const handleImagesChange = useCallback((newImages: string[]) => {
     setImages(newImages);
   }, []);
@@ -92,6 +99,16 @@ export function useAgentInfoStep({
       return;
     }
 
+    // Validate that an agent is selected before submission
+    if (!selectedAgentId || !selectedAgentVersion) {
+      toast({
+        title: "Agent Selection Required",
+        description: "Please select an agent before submitting to the store.",
+        variant: "destructive",
+      });
+      return;
+    }
+
     const categories = data.category ? [data.category] : [];
     const filteredCategories = categories.filter(Boolean);
 
@@ -106,18 +123,14 @@ export function useAgentInfoStep({
         image_urls: images,
         video_url: data.youtubeLink || "",
         agent_output_demo_url: data.agentOutputDemo || "",
-        agent_id: selectedAgentId || "",
-        agent_version: selectedAgentVersion || 0,
+        agent_id: selectedAgentId,
+        agent_version: selectedAgentVersion,
         slug: (data.slug || "").replace(/\s+/g, "-"),
         categories: filteredCategories,
         recommended_schedule_cron: data.recommendedScheduleCron || null,
         changes_summary: data.changesSummary || null,
       } as any);
 
-      await queryClient.invalidateQueries({
-        queryKey: getGetV2ListMySubmissionsQueryKey(),
-      });
-
       onSuccess(response);
     } catch (error) {
       Sentry.captureException(error);
@@ -139,12 +152,7 @@ export function useAgentInfoStep({
     agentId,
     images,
     isSubmitting,
-    initialImages: initialData
-      ? [
-          ...(initialData?.thumbnailSrc ? [initialData.thumbnailSrc] : []),
-          ...(initialData.additionalImages || []),
-        ]
-      : [],
+    initialImages: images,
     initialSelectedImage: initialData?.thumbnailSrc || null,
     handleImagesChange,
     handleSubmit: form.handleSubmit(handleFormSubmit),
diff --git a/autogpt_platform/frontend/src/components/contextual/PublishAgentModal/usePublishAgentModal.ts b/autogpt_platform/frontend/src/components/contextual/PublishAgentModal/usePublishAgentModal.ts
index f83698d8e7..69bbb6c866 100644
--- a/autogpt_platform/frontend/src/components/contextual/PublishAgentModal/usePublishAgentModal.ts
+++ b/autogpt_platform/frontend/src/components/contextual/PublishAgentModal/usePublishAgentModal.ts
@@ -6,9 +6,11 @@ import { emptyModalState } from "./helpers";
 import {
   useGetV2GetMyAgents,
   useGetV2ListMySubmissions,
+  getGetV2ListMySubmissionsQueryKey,
 } from "@/app/api/__generated__/endpoints/store/store";
 import { okData } from "@/app/api/helpers";
 import type { MyAgent } from "@/app/api/__generated__/models/myAgent";
+import { useQueryClient } from "@tanstack/react-query";
 
 const defaultTargetState: PublishState = {
   isOpen: false,
@@ -30,6 +32,7 @@ export interface Props {
   onStateChange?: (state: PublishState) => void;
   preSelectedAgentId?: string;
   preSelectedAgentVersion?: number;
+  showTrigger?: boolean;
 }
 
 export function usePublishAgentModal({
@@ -64,6 +67,7 @@ export function usePublishAgentModal({
   >(preSelectedAgentVersion || null);
 
   const router = useRouter();
+  const queryClient = useQueryClient();
 
   // Fetch agent data for pre-populating form when agent is pre-selected
   const { data: myAgents } = useGetV2GetMyAgents();
@@ -76,14 +80,18 @@ export function usePublishAgentModal({
     }
   }, [targetState]);
 
-  // Reset internal state when modal opens
+  // Reset internal state when modal opens (only on initial open, not on every targetState change)
+  const [hasOpened, setHasOpened] = useState(false);
   useEffect(() => {
     if (!targetState) return;
-    if (targetState.isOpen) {
+    if (targetState.isOpen && !hasOpened) {
       setSelectedAgent(null);
       setSelectedAgentId(preSelectedAgentId || null);
       setSelectedAgentVersion(preSelectedAgentVersion || null);
       setInitialData(emptyModalState);
+      setHasOpened(true);
+    } else if (!targetState.isOpen && hasOpened) {
+      setHasOpened(false);
     }
   }, [targetState, preSelectedAgentId, preSelectedAgentVersion]);
 
@@ -171,6 +179,11 @@ export function usePublishAgentModal({
     setSelectedAgentVersion(null);
     setInitialData(emptyModalState);
 
+    // Invalidate submissions query to refresh the data after modal closes
+    queryClient.invalidateQueries({
+      queryKey: getGetV2ListMySubmissionsQueryKey(),
+    });
+
     // Update parent with clean closed state
     const newState = {
       isOpen: false,
diff --git a/autogpt_platform/frontend/src/components/contextual/RunAgentInputs/RunAgentInputs.tsx b/autogpt_platform/frontend/src/components/contextual/RunAgentInputs/RunAgentInputs.tsx
new file mode 100644
index 0000000000..bc054e42b8
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/contextual/RunAgentInputs/RunAgentInputs.tsx
@@ -0,0 +1,389 @@
+import { format } from "date-fns";
+import React from "react";
+
+import { Input as DSInput } from "@/components/atoms/Input/Input";
+import { Select as DSSelect } from "@/components/atoms/Select/Select";
+import { MultiToggle } from "@/components/molecules/MultiToggle/MultiToggle";
+// Removed shadcn Select usage in favor of DS Select for time picker
+import { Button } from "@/components/atoms/Button/Button";
+import { FileInput } from "@/components/atoms/FileInput/FileInput";
+import { Switch } from "@/components/atoms/Switch/Switch";
+import { GoogleDrivePickerInput } from "@/components/contextual/GoogleDrivePicker/GoogleDrivePickerInput";
+import { InformationTooltip } from "@/components/molecules/InformationTooltip/InformationTooltip";
+import { TimePicker } from "@/components/molecules/TimePicker/TimePicker";
+import {
+  BlockIOObjectSubSchema,
+  BlockIOSubSchema,
+  BlockIOTableSubSchema,
+  DataType,
+  determineDataType,
+  TableRow,
+} from "@/lib/autogpt-server-api/types";
+import { PlusIcon, XIcon } from "@phosphor-icons/react";
+import { useRunAgentInputs } from "./useRunAgentInputs";
+
+/**
+ * A generic prop structure for the TypeBasedInput.
+ *
+ * onChange expects an event-like object with e.target.value so the parent
+ * can do something like setInputValues(e.target.value).
+ */
+interface Props {
+  schema: BlockIOSubSchema;
+  value?: any;
+  placeholder?: string;
+  onChange: (value: any) => void;
+  readOnly?: boolean;
+}
+
+/**
+ * A generic, data-type-based input component that uses Shadcn UI.
+ * It inspects the schema via `determineDataType` and renders
+ * the correct UI component.
+ */
+export function RunAgentInputs({
+  schema,
+  value,
+  placeholder,
+  onChange,
+  readOnly = false,
+  ...props
+}: Props & React.HTMLAttributes<HTMLElement>) {
+  const { handleUploadFile, uploadProgress } = useRunAgentInputs();
+
+  const dataType = determineDataType(schema);
+
+  const baseId = String(schema.title ?? "input")
+    .replace(/\s+/g, "-")
+    .toLowerCase();
+
+  let innerInputElement: React.ReactNode = null;
+  switch (dataType) {
+    case DataType.NUMBER:
+      innerInputElement = (
+        <DSInput
+          id={`${baseId}-number`}
+          label={schema.title ?? placeholder ?? "Number"}
+          hideLabel
+          type="number"
+          value={value ?? ""}
+          placeholder={placeholder || "Enter number"}
+          onChange={(e) => {
+            const v = (e.target as HTMLInputElement).value;
+            if (!v || v.trim() === "") {
+              onChange(undefined);
+            } else {
+              const numValue = Number(v);
+              onChange(isNaN(numValue) ? undefined : numValue);
+            }
+          }}
+          {...props}
+        />
+      );
+      break;
+
+    case DataType.LONG_TEXT:
+      innerInputElement = (
+        <DSInput
+          id={`${baseId}-textarea`}
+          label={schema.title ?? placeholder ?? "Text"}
+          hideLabel
+          type="textarea"
+          rows={3}
+          value={value ?? ""}
+          placeholder={placeholder || "Enter text"}
+          onChange={(e) => onChange((e.target as HTMLInputElement).value)}
+          {...props}
+        />
+      );
+      break;
+
+    case DataType.GOOGLE_DRIVE_PICKER: {
+      const pickerSchema = schema as any;
+      const config: import("@/lib/autogpt-server-api/types").GoogleDrivePickerConfig =
+        pickerSchema.google_drive_picker_config || {};
+
+      innerInputElement = (
+        <GoogleDrivePickerInput
+          config={config}
+          value={value}
+          onChange={onChange}
+          className="w-full"
+          showRemoveButton={!readOnly}
+        />
+      );
+      break;
+    }
+
+    case DataType.BOOLEAN:
+      innerInputElement = (
+        <>
+          <span className="text-sm text-gray-500">
+            {placeholder || (value ? "Enabled" : "Disabled")}
+          </span>
+          <Switch
+            className="ml-auto"
+            checked={!!value}
+            onCheckedChange={(checked: boolean) => onChange(checked)}
+            {...props}
+          />
+        </>
+      );
+      break;
+
+    case DataType.DATE: {
+      function normalizeDateValue(val: any): Date | null {
+        if (!val) return null;
+        if (val instanceof Date) {
+          return isNaN(val.getTime()) ? null : val;
+        }
+        if (typeof val === "string") {
+          if (/^\d{4}-\d{2}-\d{2}$/.test(val)) {
+            const [y, m, d] = val.split("-").map(Number);
+            const date = new Date(y, m - 1, d);
+            return isNaN(date.getTime()) ? null : date;
+          }
+          const date = new Date(val);
+          return isNaN(date.getTime()) ? null : date;
+        }
+        return null;
+      }
+
+      const dateValue = normalizeDateValue(value);
+      innerInputElement = (
+        <DSInput
+          id={`${baseId}-date`}
+          label={schema.title ?? placeholder ?? "Date"}
+          hideLabel
+          type="date"
+          value={dateValue ? format(dateValue, "yyyy-MM-dd") : ""}
+          onChange={(e) => {
+            const v = (e.target as HTMLInputElement).value;
+            if (!v) onChange(undefined);
+            else {
+              const [y, m, d] = v.split("-").map(Number);
+              onChange(new Date(y, m - 1, d));
+            }
+          }}
+          placeholder={placeholder || "Pick a date"}
+          {...props}
+        />
+      );
+      break;
+    }
+
+    case DataType.TIME:
+      innerInputElement = (
+        <TimePicker value={value?.toString()} onChange={onChange} />
+      );
+      break;
+
+    case DataType.DATE_TIME:
+      innerInputElement = (
+        <DSInput
+          id={`${baseId}-datetime`}
+          label={schema.title ?? placeholder ?? "Date time"}
+          hideLabel
+          type="datetime-local"
+          value={value ?? ""}
+          onChange={(e) => onChange((e.target as HTMLInputElement).value)}
+          placeholder={placeholder || "Enter date and time"}
+          {...props}
+        />
+      );
+      break;
+
+    case DataType.FILE:
+      innerInputElement = (
+        <FileInput
+          value={value}
+          placeholder={placeholder}
+          onChange={onChange}
+          onUploadFile={handleUploadFile}
+          uploadProgress={uploadProgress}
+          {...props}
+        />
+      );
+      break;
+
+    case DataType.SELECT:
+      if (
+        "enum" in schema &&
+        Array.isArray(schema.enum) &&
+        schema.enum.length > 0
+      ) {
+        innerInputElement = (
+          <DSSelect
+            id={`${baseId}-select`}
+            label={schema.title ?? placeholder ?? "Select"}
+            hideLabel
+            value={value ?? ""}
+            onValueChange={(val: string) => onChange(val)}
+            placeholder={placeholder || "Select an option"}
+            options={schema.enum
+              .filter((opt) => opt)
+              .map((opt) => ({ value: opt, label: String(opt) }))}
+          />
+        );
+        break;
+      }
+
+    case DataType.MULTI_SELECT: {
+      const _schema = schema as BlockIOObjectSubSchema;
+      const properties = _schema.properties || {};
+      const allKeys = Object.keys(properties);
+      const selectedValues = Object.entries(value || {})
+        .filter(([_, v]) => v)
+        .map(([k]) => k);
+
+      innerInputElement = (
+        <MultiToggle
+          items={allKeys.map((key) => ({
+            value: key,
+            label: properties[key]?.title ?? key,
+          }))}
+          selectedValues={selectedValues}
+          onChange={(values: string[]) =>
+            onChange(
+              Object.fromEntries(
+                allKeys.map((opt) => [opt, values.includes(opt)]),
+              ),
+            )
+          }
+          className="nodrag"
+          aria-label={schema.title}
+        />
+      );
+      break;
+    }
+
+    case DataType.TABLE: {
+      // Render a simple table UI for the run modal
+      const tableSchema = schema as BlockIOTableSubSchema;
+      const headers = tableSchema.items?.properties
+        ? Object.keys(tableSchema.items.properties)
+        : ["Column 1", "Column 2", "Column 3"];
+
+      const tableData: TableRow[] = Array.isArray(value) ? value : [];
+
+      const updateRow = (index: number, header: string, newValue: string) => {
+        const newData = [...tableData];
+        if (!newData[index]) {
+          newData[index] = {};
+        }
+        newData[index][header] = newValue;
+        onChange(newData);
+      };
+
+      const addRow = () => {
+        const newRow: TableRow = {};
+        headers.forEach((header) => {
+          newRow[header] = "";
+        });
+        onChange([...tableData, newRow]);
+      };
+
+      const removeRow = (index: number) => {
+        const newData = tableData.filter((_, i) => i !== index);
+        onChange(newData);
+      };
+
+      innerInputElement = (
+        <div className="w-full space-y-2">
+          <div className="overflow-hidden rounded-md border">
+            <table className="w-full text-sm">
+              <thead>
+                <tr className="bg-gray-50 dark:bg-gray-800">
+                  {headers.map((header) => (
+                    <th
+                      key={header}
+                      className="px-3 py-2 text-left font-medium"
+                    >
+                      {header}
+                    </th>
+                  ))}
+                  <th className="w-10 px-3 py-2"></th>
+                </tr>
+              </thead>
+              <tbody>
+                {tableData.map((row, rowIndex) => (
+                  <tr key={rowIndex} className="border-t dark:border-gray-700">
+                    {headers.map((header) => (
+                      <td key={header} className="px-3 py-1">
+                        <input
+                          type="text"
+                          value={String(row[header] || "")}
+                          onChange={(e) =>
+                            updateRow(rowIndex, header, e.target.value)
+                          }
+                          className="w-full rounded border px-2 py-1 dark:border-gray-700 dark:bg-gray-900"
+                          placeholder={`Enter ${header}`}
+                        />
+                      </td>
+                    ))}
+                    <td className="px-3 py-1">
+                      <Button
+                        type="button"
+                        variant="ghost"
+                        size="small"
+                        onClick={() => removeRow(rowIndex)}
+                        className="h-8 w-8 p-0"
+                      >
+                        <XIcon className="h-4 w-4" weight="bold" />
+                      </Button>
+                    </td>
+                  </tr>
+                ))}
+              </tbody>
+            </table>
+          </div>
+          <Button
+            type="button"
+            variant="outline"
+            size="small"
+            onClick={addRow}
+            className="w-full"
+          >
+            <PlusIcon className="mr-2 h-4 w-4" weight="bold" />
+            Add Row
+          </Button>
+        </div>
+      );
+      break;
+    }
+
+    case DataType.SHORT_TEXT:
+    default:
+      innerInputElement = (
+        <DSInput
+          id={`${baseId}-text`}
+          label={schema.title ?? placeholder ?? "Text"}
+          hideLabel
+          type="text"
+          value={value ?? ""}
+          onChange={(e) => onChange((e.target as HTMLInputElement).value)}
+          placeholder={placeholder || "Enter text"}
+          disabled={readOnly}
+          {...props}
+        />
+      );
+  }
+
+  return (
+    <div className="flex w-full flex-col gap-0 space-y-2">
+      <label className="large-medium flex items-center gap-1 font-medium">
+        {schema.title || placeholder}
+        <InformationTooltip description={schema.description} />
+      </label>
+      <div className="no-drag relative flex w-full">
+        {readOnly ? (
+          <div style={{ pointerEvents: "none", opacity: 0.7 }}>
+            {innerInputElement}
+          </div>
+        ) : (
+          innerInputElement
+        )}
+      </div>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/components/contextual/RunAgentInputs/useRunAgentInputs.ts b/autogpt_platform/frontend/src/components/contextual/RunAgentInputs/useRunAgentInputs.ts
new file mode 100644
index 0000000000..38fe30b9ea
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/contextual/RunAgentInputs/useRunAgentInputs.ts
@@ -0,0 +1,19 @@
+import BackendAPI from "@/lib/autogpt-server-api";
+import { useState } from "react";
+
+export function useRunAgentInputs() {
+  const api = new BackendAPI();
+  const [uploadProgress, setUploadProgress] = useState(0);
+
+  async function handleUploadFile(file: File) {
+    const result = await api.uploadFile(file, "gcs", 24, (progress) =>
+      setUploadProgress(progress),
+    );
+    return result;
+  }
+
+  return {
+    uploadProgress,
+    handleUploadFile,
+  };
+}
diff --git a/autogpt_platform/frontend/src/components/layout/Navbar/Navbar.tsx b/autogpt_platform/frontend/src/components/layout/Navbar/Navbar.tsx
index 1441cbfb65..c5e9cabd63 100644
--- a/autogpt_platform/frontend/src/components/layout/Navbar/Navbar.tsx
+++ b/autogpt_platform/frontend/src/components/layout/Navbar/Navbar.tsx
@@ -1,13 +1,157 @@
+"use client";
+
+import { useGetV2GetUserProfile } from "@/app/api/__generated__/endpoints/store/store";
+import { okData } from "@/app/api/helpers";
+import { IconAutoGPTLogo, IconType } from "@/components/__legacy__/ui/icons";
+import { PreviewBanner } from "@/components/layout/Navbar/components/PreviewBanner/PreviewBanner";
+import { useBreakpoint } from "@/lib/hooks/useBreakpoint";
+import { useSupabase } from "@/lib/supabase/hooks/useSupabase";
 import { environment } from "@/services/environment";
+import { Flag, useGetFlag } from "@/services/feature-flags/use-get-flag";
+import { AccountMenu } from "./components/AccountMenu/AccountMenu";
+import { AgentActivityDropdown } from "./components/AgentActivityDropdown/AgentActivityDropdown";
+import { LoginButton } from "./components/LoginButton";
+import { MobileNavBar } from "./components/MobileNavbar/MobileNavBar";
+import { NavbarLink } from "./components/NavbarLink";
+import { NavbarLoading } from "./components/NavbarLoading";
+import { Wallet } from "./components/Wallet/Wallet";
+import { getAccountMenuItems, loggedInLinks, loggedOutLinks } from "./helpers";
 
-import { NavbarView } from "./components/NavbarView";
-import { getNavbarAccountData } from "./data";
-
-export async function Navbar() {
-  const { isLoggedIn } = await getNavbarAccountData();
+export function Navbar() {
+  const { user, isLoggedIn, isUserLoading } = useSupabase();
+  const breakpoint = useBreakpoint();
+  const isSmallScreen = breakpoint === "sm" || breakpoint === "base";
+  const dynamicMenuItems = getAccountMenuItems(user?.role);
+  const isChatEnabled = useGetFlag(Flag.CHAT);
   const previewBranchName = environment.getPreviewStealingDev();
 
+  const { data: profile, isLoading: isProfileLoading } = useGetV2GetUserProfile(
+    {
+      query: {
+        select: okData,
+        enabled: isLoggedIn && !!user,
+        // Include user ID in query key to ensure cache invalidation when user changes
+        queryKey: ["/api/store/profile", user?.id],
+      },
+    },
+  );
+
+  const isLoadingProfile = isProfileLoading || isUserLoading;
+
+  const shouldShowPreviewBanner = Boolean(isLoggedIn && previewBranchName);
+
+  const actualLoggedInLinks =
+    isChatEnabled === true
+      ? loggedInLinks.concat([{ name: "Chat", href: "/chat" }])
+      : loggedInLinks;
+
+  if (isUserLoading) {
+    return <NavbarLoading />;
+  }
+
   return (
-    <NavbarView isLoggedIn={isLoggedIn} previewBranchName={previewBranchName} />
+    <>
+      <div className="sticky top-0 z-40 w-full">
+        {shouldShowPreviewBanner && previewBranchName ? (
+          <PreviewBanner branchName={previewBranchName} />
+        ) : null}
+        <nav className="border-zinc-[#EFEFF0] inline-flex h-[60px] w-full items-center border border-[#EFEFF0] bg-[#F3F4F6]/20 p-3 backdrop-blur-[26px]">
+          {/* Left section */}
+          {!isSmallScreen ? (
+            <div className="flex flex-1 items-center gap-5">
+              {isLoggedIn
+                ? actualLoggedInLinks.map((link) => (
+                    <NavbarLink
+                      key={link.name}
+                      name={link.name}
+                      href={link.href}
+                    />
+                  ))
+                : loggedOutLinks.map((link) => (
+                    <NavbarLink
+                      key={link.name}
+                      name={link.name}
+                      href={link.href}
+                    />
+                  ))}
+            </div>
+          ) : null}
+
+          {/* Centered logo */}
+          <div className="static h-auto w-[4.5rem] md:absolute md:left-1/2 md:top-1/2 md:w-[5.5rem] md:-translate-x-1/2 md:-translate-y-1/2">
+            <IconAutoGPTLogo className="h-full w-full" />
+          </div>
+
+          {/* Right section */}
+          {isLoggedIn && !isSmallScreen ? (
+            <div className="flex flex-1 items-center justify-end gap-4">
+              <div className="flex items-center gap-4">
+                <AgentActivityDropdown />
+                {profile && <Wallet key={profile.username} />}
+                <AccountMenu
+                  userName={profile?.username}
+                  userEmail={profile?.name}
+                  avatarSrc={profile?.avatar_url ?? ""}
+                  menuItemGroups={dynamicMenuItems}
+                  isLoading={isLoadingProfile}
+                />
+              </div>
+            </div>
+          ) : !isLoggedIn ? (
+            <div className="flex w-full items-center justify-end">
+              <LoginButton />
+            </div>
+          ) : null}
+          {/* <ThemeToggle /> */}
+        </nav>
+      </div>
+      {/* Mobile Navbar - Adjust positioning */}
+      <>
+        {isLoggedIn && isSmallScreen ? (
+          <div className="fixed right-0 top-2 z-50 flex items-center gap-0">
+            <Wallet />
+            <MobileNavBar
+              userName={profile?.username}
+              menuItemGroups={[
+                {
+                  groupName: "Navigation",
+                  items: actualLoggedInLinks
+                    .map((link) => {
+                      if (link.name === "Chat" && !isChatEnabled) {
+                        return null;
+                      }
+
+                      return {
+                        icon:
+                          link.name === "Marketplace"
+                            ? IconType.Marketplace
+                            : link.name === "Library"
+                              ? IconType.Library
+                              : link.name === "Build"
+                                ? IconType.Builder
+                                : link.name === "Chat"
+                                  ? IconType.Chat
+                                  : link.name === "Monitor"
+                                    ? IconType.Library
+                                    : IconType.LayoutDashboard,
+                        text: link.name,
+                        href: link.href,
+                      };
+                    })
+                    .filter((item) => item !== null) as Array<{
+                    icon: IconType;
+                    text: string;
+                    href: string;
+                  }>,
+                },
+                ...dynamicMenuItems,
+              ]}
+              userEmail={profile?.name}
+              avatarSrc={profile?.avatar_url ?? ""}
+            />
+          </div>
+        ) : null}
+      </>
+    </>
   );
 }
diff --git a/autogpt_platform/frontend/src/components/layout/Navbar/components/AccountMenu/components/AccountLogoutOption.tsx b/autogpt_platform/frontend/src/components/layout/Navbar/components/AccountMenu/components/AccountLogoutOption.tsx
index b0061ec2c9..570f05ca89 100644
--- a/autogpt_platform/frontend/src/components/layout/Navbar/components/AccountMenu/components/AccountLogoutOption.tsx
+++ b/autogpt_platform/frontend/src/components/layout/Navbar/components/AccountMenu/components/AccountLogoutOption.tsx
@@ -6,45 +6,42 @@ import { useSupabase } from "@/lib/supabase/hooks/useSupabase";
 import { cn } from "@/lib/utils";
 import * as Sentry from "@sentry/nextjs";
 import { useRouter } from "next/navigation";
-import { useState } from "react";
+import { useTransition } from "react";
 
 export function AccountLogoutOption() {
-  const [isLoggingOut, setIsLoggingOut] = useState(false);
+  const [isPending, startTransition] = useTransition();
   const supabase = useSupabase();
   const router = useRouter();
   const { toast } = useToast();
 
-  async function handleLogout() {
-    setIsLoggingOut(true);
-    try {
-      await supabase.logOut();
-      router.push("/login");
-    } catch (e) {
-      Sentry.captureException(e);
-      toast({
-        title: "Error logging out",
-        description:
-          "Something went wrong when logging out. Please try again. If the problem persists, please contact support.",
-        variant: "destructive",
-      });
-    } finally {
-      setTimeout(() => {
-        setIsLoggingOut(false);
-      }, 3000);
-    }
+  function handleLogout() {
+    startTransition(async () => {
+      try {
+        await supabase.logOut();
+        router.replace("/login");
+      } catch (e) {
+        Sentry.captureException(e);
+        toast({
+          title: "Error logging out",
+          description:
+            "Something went wrong when logging out. Please try again. If the problem persists, please contact support.",
+          variant: "destructive",
+        });
+      }
+    });
   }
 
   return (
     <div
       className={cn(
         "inline-flex w-full items-center justify-start gap-2.5",
-        isLoggingOut && "justify-center opacity-50",
+        isPending && "justify-center opacity-50",
       )}
       onClick={handleLogout}
       role="button"
       tabIndex={0}
     >
-      {isLoggingOut ? (
+      {isPending ? (
         <LoadingSpinner className="size-5" />
       ) : (
         <>
diff --git a/autogpt_platform/frontend/src/components/layout/Navbar/components/AgentActivityDropdown/components/ActivityItem.tsx b/autogpt_platform/frontend/src/components/layout/Navbar/components/AgentActivityDropdown/components/ActivityItem.tsx
index 1ebca96b05..17576e1665 100644
--- a/autogpt_platform/frontend/src/components/layout/Navbar/components/AgentActivityDropdown/components/ActivityItem.tsx
+++ b/autogpt_platform/frontend/src/components/layout/Navbar/components/AgentActivityDropdown/components/ActivityItem.tsx
@@ -50,7 +50,9 @@ export function ActivityItem({ execution }: Props) {
       execution.status === AgentExecutionStatus.QUEUED;
 
     if (isActiveStatus) {
-      const timeAgo = formatTimeAgo(execution.started_at.toString());
+      const timeAgo = execution.started_at
+        ? formatTimeAgo(execution.started_at.toString())
+        : "recently";
       const statusText =
         execution.status === AgentExecutionStatus.QUEUED ? "queued" : "running";
       return [
@@ -61,7 +63,9 @@ export function ActivityItem({ execution }: Props) {
     // Handle all other statuses with time display
     const timeAgo = execution.ended_at
       ? formatTimeAgo(execution.ended_at.toString())
-      : formatTimeAgo(execution.started_at.toString());
+      : execution.started_at
+        ? formatTimeAgo(execution.started_at.toString())
+        : "recently";
 
     let statusText = "ended";
     switch (execution.status) {
diff --git a/autogpt_platform/frontend/src/components/layout/Navbar/components/AgentActivityDropdown/useAgentActivityDropdown.ts b/autogpt_platform/frontend/src/components/layout/Navbar/components/AgentActivityDropdown/useAgentActivityDropdown.ts
index 9dbd8aaf7e..24c3e308c3 100644
--- a/autogpt_platform/frontend/src/components/layout/Navbar/components/AgentActivityDropdown/useAgentActivityDropdown.ts
+++ b/autogpt_platform/frontend/src/components/layout/Navbar/components/AgentActivityDropdown/useAgentActivityDropdown.ts
@@ -1,10 +1,10 @@
 import { useGetV1ListAllExecutions } from "@/app/api/__generated__/endpoints/graphs/graphs";
 
+import { okData } from "@/app/api/helpers";
 import { useExecutionEvents } from "@/hooks/useExecutionEvents";
 import { useLibraryAgents } from "@/hooks/useLibraryAgents/useLibraryAgents";
 import type { GraphExecution } from "@/lib/autogpt-server-api/types";
-import { useCallback, useEffect, useMemo, useState } from "react";
-import { okData } from "@/app/api/helpers";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import {
   NotificationState,
   categorizeExecutions,
@@ -47,10 +47,22 @@ export function useAgentActivityDropdown() {
   );
 
   // Process initial execution state when data loads
+  // Use a ref to track if we've already processed to avoid infinite loops
+  const processedExecutionsRef = useRef<string | null>(null);
   useEffect(() => {
-    if (executions && executionsSuccess && agentInfoMap.size > 0) {
+    const executionKey = executions
+      ? `${executions.length}-${executionsSuccess}`
+      : null;
+
+    if (
+      executions &&
+      executionsSuccess &&
+      agentInfoMap.size > 0 &&
+      processedExecutionsRef.current !== executionKey
+    ) {
       const notifications = categorizeExecutions(executions, agentInfoMap);
       setNotifications(notifications);
+      processedExecutionsRef.current = executionKey;
     }
   }, [executions, executionsSuccess, agentInfoMap]);
 
diff --git a/autogpt_platform/frontend/src/components/layout/Navbar/components/NavbarLoading.tsx b/autogpt_platform/frontend/src/components/layout/Navbar/components/NavbarLoading.tsx
index 42362d24d4..322574fdb0 100644
--- a/autogpt_platform/frontend/src/components/layout/Navbar/components/NavbarLoading.tsx
+++ b/autogpt_platform/frontend/src/components/layout/Navbar/components/NavbarLoading.tsx
@@ -5,16 +5,15 @@ export function NavbarLoading() {
   return (
     <nav className="sticky top-0 z-40 hidden h-16 items-center rounded-bl-2xl rounded-br-2xl border border-white/50 bg-white/5 p-3 backdrop-blur-[26px] md:inline-flex">
       <div className="flex flex-1 items-center gap-6">
-        <Skeleton className="h-4 w-20 bg-white/20" />
-        <Skeleton className="h-4 w-16 bg-white/20" />
-        <Skeleton className="h-4 w-12 bg-white/20" />
+        <Skeleton className="h-6 w-24 bg-zinc-200/60" />
+        <Skeleton className="h-6 w-24 bg-zinc-200/60" />
+        <Skeleton className="h-6 w-16 bg-zinc-200/60" />
       </div>
       <div className="absolute left-1/2 top-1/2 h-10 w-[88.87px] -translate-x-1/2 -translate-y-1/2">
         <IconAutoGPTLogo className="h-full w-full" />
       </div>
       <div className="flex flex-1 items-center justify-end gap-4">
-        <Skeleton className="h-8 w-8 rounded-full bg-white/20" />
-        <Skeleton className="h-8 w-8 rounded-full bg-white/20" />
+        <Skeleton className="h-8 w-8 rounded-full bg-zinc-200/60" />
       </div>
     </nav>
   );
diff --git a/autogpt_platform/frontend/src/components/layout/Navbar/components/NavbarView.tsx b/autogpt_platform/frontend/src/components/layout/Navbar/components/NavbarView.tsx
deleted file mode 100644
index 863b9f601f..0000000000
--- a/autogpt_platform/frontend/src/components/layout/Navbar/components/NavbarView.tsx
+++ /dev/null
@@ -1,144 +0,0 @@
-"use client";
-
-import { useGetV2GetUserProfile } from "@/app/api/__generated__/endpoints/store/store";
-import { IconAutoGPTLogo, IconType } from "@/components/__legacy__/ui/icons";
-import { PreviewBanner } from "@/components/layout/Navbar/components/PreviewBanner/PreviewBanner";
-import { useBreakpoint } from "@/lib/hooks/useBreakpoint";
-import { useSupabase } from "@/lib/supabase/hooks/useSupabase";
-import { Flag, useGetFlag } from "@/services/feature-flags/use-get-flag";
-import { useMemo } from "react";
-import { okData } from "@/app/api/helpers";
-import { getAccountMenuItems, loggedInLinks, loggedOutLinks } from "../helpers";
-import { AccountMenu } from "./AccountMenu/AccountMenu";
-import { AgentActivityDropdown } from "./AgentActivityDropdown/AgentActivityDropdown";
-import { LoginButton } from "./LoginButton";
-import { MobileNavBar } from "./MobileNavbar/MobileNavBar";
-import { NavbarLink } from "./NavbarLink";
-import { Wallet } from "./Wallet/Wallet";
-interface NavbarViewProps {
-  isLoggedIn: boolean;
-  previewBranchName?: string | null;
-}
-
-export function NavbarView({ isLoggedIn, previewBranchName }: NavbarViewProps) {
-  const { user } = useSupabase();
-  const breakpoint = useBreakpoint();
-  const isSmallScreen = breakpoint === "sm" || breakpoint === "base";
-  const dynamicMenuItems = getAccountMenuItems(user?.role);
-  const isChatEnabled = useGetFlag(Flag.CHAT);
-
-  const { data: profile, isLoading: isProfileLoading } = useGetV2GetUserProfile(
-    {
-      query: {
-        select: okData,
-        enabled: isLoggedIn && !!user,
-        // Include user ID in query key to ensure cache invalidation when user changes
-        queryKey: ["/api/store/profile", user?.id],
-      },
-    },
-  );
-
-  const { isUserLoading } = useSupabase();
-  const isLoadingProfile = isProfileLoading || isUserLoading;
-
-  const linksWithChat = useMemo(() => {
-    const chatLink = { name: "Chat", href: "/chat" };
-    return isChatEnabled ? [...loggedInLinks, chatLink] : loggedInLinks;
-  }, [isChatEnabled]);
-
-  const shouldShowPreviewBanner = Boolean(isLoggedIn && previewBranchName);
-
-  return (
-    <>
-      <div className="sticky top-0 z-40 w-full">
-        {shouldShowPreviewBanner && previewBranchName ? (
-          <PreviewBanner branchName={previewBranchName} />
-        ) : null}
-        <nav className="border-zinc-[#EFEFF0] inline-flex h-[60px] w-full items-center border border-[#EFEFF0] bg-[#F3F4F6]/20 p-3 backdrop-blur-[26px]">
-          {/* Left section */}
-          {!isSmallScreen ? (
-            <div className="flex flex-1 items-center gap-5">
-              {isLoggedIn
-                ? linksWithChat.map((link) => (
-                    <NavbarLink
-                      key={link.name}
-                      name={link.name}
-                      href={link.href}
-                    />
-                  ))
-                : loggedOutLinks.map((link) => (
-                    <NavbarLink
-                      key={link.name}
-                      name={link.name}
-                      href={link.href}
-                    />
-                  ))}
-            </div>
-          ) : null}
-
-          {/* Centered logo */}
-          <div className="static h-auto w-[4.5rem] md:absolute md:left-1/2 md:top-1/2 md:w-[5.5rem] md:-translate-x-1/2 md:-translate-y-1/2">
-            <IconAutoGPTLogo className="h-full w-full" />
-          </div>
-
-          {/* Right section */}
-          {isLoggedIn && !isSmallScreen ? (
-            <div className="flex flex-1 items-center justify-end gap-4">
-              <div className="flex items-center gap-4">
-                <AgentActivityDropdown />
-                {profile && <Wallet key={profile.username} />}
-                <AccountMenu
-                  userName={profile?.username}
-                  userEmail={profile?.name}
-                  avatarSrc={profile?.avatar_url ?? ""}
-                  menuItemGroups={dynamicMenuItems}
-                  isLoading={isLoadingProfile}
-                />
-              </div>
-            </div>
-          ) : !isLoggedIn ? (
-            <div className="flex w-full items-center justify-end">
-              <LoginButton />
-            </div>
-          ) : null}
-          {/* <ThemeToggle /> */}
-        </nav>
-      </div>
-      {/* Mobile Navbar - Adjust positioning */}
-      <>
-        {isLoggedIn && isSmallScreen ? (
-          <div className="fixed right-0 top-2 z-50 flex items-center gap-0">
-            <Wallet />
-            <MobileNavBar
-              userName={profile?.username}
-              menuItemGroups={[
-                {
-                  groupName: "Navigation",
-                  items: linksWithChat.map((link) => ({
-                    icon:
-                      link.name === "Marketplace"
-                        ? IconType.Marketplace
-                        : link.name === "Library"
-                          ? IconType.Library
-                          : link.name === "Build"
-                            ? IconType.Builder
-                            : link.name === "Chat"
-                              ? IconType.Chat
-                              : link.name === "Monitor"
-                                ? IconType.Library
-                                : IconType.LayoutDashboard,
-                    text: link.name,
-                    href: link.href,
-                  })),
-                },
-                ...dynamicMenuItems,
-              ]}
-              userEmail={profile?.name}
-              avatarSrc={profile?.avatar_url ?? ""}
-            />
-          </div>
-        ) : null}
-      </>
-    </>
-  );
-}
diff --git a/autogpt_platform/frontend/src/components/layout/Navbar/data.ts b/autogpt_platform/frontend/src/components/layout/Navbar/data.ts
deleted file mode 100644
index 0d07cef78b..0000000000
--- a/autogpt_platform/frontend/src/components/layout/Navbar/data.ts
+++ /dev/null
@@ -1,25 +0,0 @@
-import { prefetchGetV2GetUserProfileQuery } from "@/app/api/__generated__/endpoints/store/store";
-import { getQueryClient } from "@/lib/react-query/queryClient";
-import { getServerUser } from "@/lib/supabase/server/getServerUser";
-
-export async function getNavbarAccountData() {
-  const { user } = await getServerUser();
-  const isLoggedIn = Boolean(user);
-  const queryClient = getQueryClient();
-
-  if (!isLoggedIn) {
-    return {
-      profile: null,
-      isLoggedIn,
-    };
-  }
-  try {
-    await prefetchGetV2GetUserProfileQuery(queryClient);
-  } catch (error) {
-    console.error("Error fetching profile:", error);
-  }
-
-  return {
-    isLoggedIn,
-  };
-}
diff --git a/autogpt_platform/frontend/src/components/molecules/Accordion/Accordion.stories.tsx b/autogpt_platform/frontend/src/components/molecules/Accordion/Accordion.stories.tsx
new file mode 100644
index 0000000000..d0fce53e0e
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/molecules/Accordion/Accordion.stories.tsx
@@ -0,0 +1,203 @@
+import type { Meta } from "@storybook/nextjs";
+import {
+  Accordion,
+  AccordionContent,
+  AccordionItem,
+  AccordionTrigger,
+} from "./Accordion";
+
+const meta: Meta<typeof Accordion> = {
+  title: "Molecules/Accordion",
+  component: Accordion,
+  parameters: {
+    layout: "centered",
+    docs: {
+      description: {
+        component: `
+## Accordion Component
+
+A vertically stacked set of interactive headings that each reveal an associated section of content.
+
+### ✨ Features
+
+- **Built on Radix UI** - Uses @radix-ui/react-accordion for accessibility and functionality
+- **Single or multiple** - Supports single or multiple items open at once
+- **Smooth animations** - Built-in expand/collapse animations
+- **Accessible** - Full keyboard navigation and screen reader support
+- **Customizable** - Style with Tailwind CSS classes
+
+### 🎯 Usage
+
+\`\`\`tsx
+<Accordion type="single" collapsible>
+  <AccordionItem value="item-1">
+    <AccordionTrigger>Is it accessible?</AccordionTrigger>
+    <AccordionContent>
+      Yes. It adheres to the WAI-ARIA design pattern.
+    </AccordionContent>
+  </AccordionItem>
+</Accordion>
+\`\`\`
+
+### Props
+
+**Accordion**:
+- **type**: "single" | "multiple" - Whether one or multiple items can be open
+- **collapsible**: boolean - When type is "single", allows closing all items
+- **defaultValue**: string | string[] - Default open item(s)
+- **value**: string | string[] - Controlled open item(s)
+- **onValueChange**: (value) => void - Callback when value changes
+
+**AccordionItem**:
+- **value**: string - Unique identifier for the item
+- **disabled**: boolean - Whether the item is disabled
+
+**AccordionTrigger**:
+- Standard button props
+
+**AccordionContent**:
+- Standard div props
+        `,
+      },
+    },
+  },
+  tags: ["autodocs"],
+  argTypes: {
+    type: {
+      control: "radio",
+      options: ["single", "multiple"],
+      description: "Whether one or multiple items can be open at the same time",
+      table: {
+        defaultValue: { summary: "single" },
+      },
+    },
+    collapsible: {
+      control: "boolean",
+      description:
+        'When type is "single", allows closing content when clicking on open trigger',
+      table: {
+        defaultValue: { summary: "false" },
+      },
+    },
+  },
+};
+
+export default meta;
+
+export function Default() {
+  return (
+    <Accordion type="single" collapsible className="w-96">
+      <AccordionItem value="item-1">
+        <AccordionTrigger>Is it accessible?</AccordionTrigger>
+        <AccordionContent>
+          Yes. It adheres to the WAI-ARIA design pattern.
+        </AccordionContent>
+      </AccordionItem>
+      <AccordionItem value="item-2">
+        <AccordionTrigger>Is it styled?</AccordionTrigger>
+        <AccordionContent>
+          Yes. It comes with default styles that match your design system.
+        </AccordionContent>
+      </AccordionItem>
+      <AccordionItem value="item-3">
+        <AccordionTrigger>Is it animated?</AccordionTrigger>
+        <AccordionContent>
+          Yes. It&apos;s animated by default with smooth expand/collapse
+          transitions.
+        </AccordionContent>
+      </AccordionItem>
+    </Accordion>
+  );
+}
+
+export function Multiple() {
+  return (
+    <Accordion type="multiple" className="w-96">
+      <AccordionItem value="item-1">
+        <AccordionTrigger>First section</AccordionTrigger>
+        <AccordionContent>
+          Multiple items can be open at the same time when type is set to
+          &quot;multiple&quot;.
+        </AccordionContent>
+      </AccordionItem>
+      <AccordionItem value="item-2">
+        <AccordionTrigger>Second section</AccordionTrigger>
+        <AccordionContent>
+          Try opening this one while the first is still open.
+        </AccordionContent>
+      </AccordionItem>
+      <AccordionItem value="item-3">
+        <AccordionTrigger>Third section</AccordionTrigger>
+        <AccordionContent>
+          All three can be open simultaneously.
+        </AccordionContent>
+      </AccordionItem>
+    </Accordion>
+  );
+}
+
+export function DefaultOpen() {
+  return (
+    <Accordion type="single" collapsible defaultValue="item-2" className="w-96">
+      <AccordionItem value="item-1">
+        <AccordionTrigger>Closed by default</AccordionTrigger>
+        <AccordionContent>This item starts closed.</AccordionContent>
+      </AccordionItem>
+      <AccordionItem value="item-2">
+        <AccordionTrigger>Open by default</AccordionTrigger>
+        <AccordionContent>
+          This item starts open because defaultValue is set to
+          &quot;item-2&quot;.
+        </AccordionContent>
+      </AccordionItem>
+      <AccordionItem value="item-3">
+        <AccordionTrigger>Also closed</AccordionTrigger>
+        <AccordionContent>This item also starts closed.</AccordionContent>
+      </AccordionItem>
+    </Accordion>
+  );
+}
+
+export function WithDisabledItem() {
+  return (
+    <Accordion type="single" collapsible className="w-96">
+      <AccordionItem value="item-1">
+        <AccordionTrigger>Available item</AccordionTrigger>
+        <AccordionContent>This item can be toggled.</AccordionContent>
+      </AccordionItem>
+      <AccordionItem value="item-2" disabled>
+        <AccordionTrigger>Disabled item</AccordionTrigger>
+        <AccordionContent>
+          This content cannot be accessed because the item is disabled.
+        </AccordionContent>
+      </AccordionItem>
+      <AccordionItem value="item-3">
+        <AccordionTrigger>Another available item</AccordionTrigger>
+        <AccordionContent>This item can also be toggled.</AccordionContent>
+      </AccordionItem>
+    </Accordion>
+  );
+}
+
+export function CustomStyled() {
+  return (
+    <Accordion type="single" collapsible className="w-96">
+      <AccordionItem value="item-1" className="border-none">
+        <AccordionTrigger className="rounded-lg bg-zinc-100 px-4 hover:bg-zinc-200 hover:no-underline">
+          Custom styled trigger
+        </AccordionTrigger>
+        <AccordionContent className="px-4 pt-2">
+          You can customize the styling using className props.
+        </AccordionContent>
+      </AccordionItem>
+      <AccordionItem value="item-2" className="mt-2 border-none">
+        <AccordionTrigger className="rounded-lg bg-blue-50 px-4 text-blue-700 hover:bg-blue-100 hover:no-underline">
+          Blue themed
+        </AccordionTrigger>
+        <AccordionContent className="px-4 pt-2 text-blue-600">
+          Each item can have different styles.
+        </AccordionContent>
+      </AccordionItem>
+    </Accordion>
+  );
+}
diff --git a/autogpt_platform/frontend/src/components/molecules/Accordion/Accordion.tsx b/autogpt_platform/frontend/src/components/molecules/Accordion/Accordion.tsx
new file mode 100644
index 0000000000..b071fc1d37
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/molecules/Accordion/Accordion.tsx
@@ -0,0 +1,8 @@
+"use client";
+
+export {
+  Accordion,
+  AccordionContent,
+  AccordionItem,
+  AccordionTrigger,
+} from "@/components/ui/accordion";
diff --git a/autogpt_platform/frontend/src/components/molecules/Dialog/components/DrawerWrap.tsx b/autogpt_platform/frontend/src/components/molecules/Dialog/components/DrawerWrap.tsx
index d00817bf59..3bfa321538 100644
--- a/autogpt_platform/frontend/src/components/molecules/Dialog/components/DrawerWrap.tsx
+++ b/autogpt_platform/frontend/src/components/molecules/Dialog/components/DrawerWrap.tsx
@@ -22,6 +22,9 @@ export function DrawerWrap({
   handleClose,
   isForceOpen,
 }: Props) {
+  const accessibleTitle = title ?? "Dialog";
+  const hasVisibleTitle = Boolean(title);
+
   const closeBtn = (
     <Button
       variant="link"
@@ -44,15 +47,19 @@ export function DrawerWrap({
       >
         <div
           className={`flex w-full shrink-0 items-center justify-between ${
-            title ? "pb-6" : "pb-0"
+            hasVisibleTitle ? "pb-6" : "pb-0"
           }`}
         >
-          {title ? (
-            <Drawer.Title className={drawerStyles.title}>{title}</Drawer.Title>
-          ) : null}
+          {hasVisibleTitle ? (
+            <Drawer.Title className={drawerStyles.title}>
+              {accessibleTitle}
+            </Drawer.Title>
+          ) : (
+            <Drawer.Title className="sr-only">{accessibleTitle}</Drawer.Title>
+          )}
 
           {!isForceOpen ? (
-            title ? (
+            hasVisibleTitle ? (
               closeBtn
             ) : (
               <div
diff --git a/autogpt_platform/frontend/src/components/molecules/Form/Form.tsx b/autogpt_platform/frontend/src/components/molecules/Form/Form.tsx
new file mode 100644
index 0000000000..686807b202
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/molecules/Form/Form.tsx
@@ -0,0 +1,209 @@
+"use client";
+
+import * as LabelPrimitive from "@radix-ui/react-label";
+import { Slot } from "@radix-ui/react-slot";
+import * as React from "react";
+import {
+  Controller,
+  ControllerProps,
+  FieldPath,
+  FieldValues,
+  FormProvider,
+  useFormContext,
+} from "react-hook-form";
+
+import { cn } from "@/lib/utils";
+import type { UseFormReturn } from "react-hook-form";
+
+type FormProps<TFieldValues extends FieldValues = FieldValues> = {
+  form: UseFormReturn<TFieldValues>;
+  onSubmit: (values: TFieldValues) => void | Promise<void>;
+  className?: string;
+} & Omit<React.FormHTMLAttributes<HTMLFormElement>, "onSubmit">;
+
+function Form<TFieldValues extends FieldValues = FieldValues>({
+  form,
+  onSubmit,
+  className,
+  children,
+  ...props
+}: FormProps<TFieldValues>) {
+  return (
+    <FormProvider {...form}>
+      <form
+        onSubmit={form.handleSubmit(onSubmit)}
+        className={cn("space-y-4", className)}
+        {...props}
+      >
+        {children}
+      </form>
+    </FormProvider>
+  );
+}
+
+type FormFieldContextValue<
+  TFieldValues extends FieldValues = FieldValues,
+  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,
+> = {
+  name: TName;
+};
+
+const FormFieldContext = React.createContext<FormFieldContextValue>(
+  {} as FormFieldContextValue,
+);
+
+const FormField = <
+  TFieldValues extends FieldValues = FieldValues,
+  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,
+>({
+  ...props
+}: ControllerProps<TFieldValues, TName>) => {
+  return (
+    <FormFieldContext.Provider value={{ name: props.name }}>
+      <Controller {...props} />
+    </FormFieldContext.Provider>
+  );
+};
+
+const useFormField = () => {
+  const fieldContext = React.useContext(FormFieldContext);
+  const itemContext = React.useContext(FormItemContext);
+  const { getFieldState, formState } = useFormContext();
+
+  const fieldState = getFieldState(fieldContext.name, formState);
+
+  if (!fieldContext) {
+    throw new Error("useFormField should be used within <FormField>");
+  }
+
+  const { id } = itemContext;
+
+  return {
+    id,
+    name: fieldContext.name,
+    formItemId: `${id}-form-item`,
+    formDescriptionId: `${id}-form-item-description`,
+    formMessageId: `${id}-form-item-message`,
+    ...fieldState,
+  };
+};
+
+type FormItemContextValue = {
+  id: string;
+};
+
+const FormItemContext = React.createContext<FormItemContextValue>(
+  {} as FormItemContextValue,
+);
+
+const FormItem = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => {
+  const id = React.useId();
+
+  return (
+    <FormItemContext.Provider value={{ id }}>
+      <div ref={ref} className={cn("space-y-2", className)} {...props} />
+    </FormItemContext.Provider>
+  );
+});
+FormItem.displayName = "FormItem";
+
+const FormLabel = React.forwardRef<
+  React.ElementRef<typeof LabelPrimitive.Root>,
+  React.ComponentPropsWithoutRef<typeof LabelPrimitive.Root>
+>(({ className, ...props }, ref) => {
+  const { error, formItemId } = useFormField();
+
+  return (
+    <LabelPrimitive.Root
+      ref={ref}
+      className={cn(error && "text-red-500 dark:text-red-900", className)}
+      htmlFor={formItemId}
+      {...props}
+    />
+  );
+});
+FormLabel.displayName = "FormLabel";
+
+const FormControl = React.forwardRef<
+  React.ElementRef<typeof Slot>,
+  React.ComponentPropsWithoutRef<typeof Slot>
+>(({ ...props }, ref) => {
+  const { error, formItemId, formDescriptionId, formMessageId } =
+    useFormField();
+
+  return (
+    <Slot
+      ref={ref}
+      id={formItemId}
+      aria-describedby={
+        !error
+          ? `${formDescriptionId}`
+          : `${formDescriptionId} ${formMessageId}`
+      }
+      aria-invalid={!!error}
+      {...props}
+    />
+  );
+});
+FormControl.displayName = "FormControl";
+
+const FormDescription = React.forwardRef<
+  HTMLParagraphElement,
+  React.HTMLAttributes<HTMLParagraphElement>
+>(({ className, ...props }, ref) => {
+  const { formDescriptionId } = useFormField();
+
+  return (
+    <p
+      ref={ref}
+      id={formDescriptionId}
+      className={cn(
+        "font-sans text-[0.75rem] font-[400] leading-[1.125rem] text-neutral-500 dark:text-neutral-400",
+        className,
+      )}
+      {...props}
+    />
+  );
+});
+FormDescription.displayName = "FormDescription";
+
+const FormMessage = React.forwardRef<
+  HTMLParagraphElement,
+  React.HTMLAttributes<HTMLParagraphElement>
+>(({ className, children, ...props }, ref) => {
+  const { error, formMessageId } = useFormField();
+  const body = error ? String(error?.message) : children;
+
+  if (!body) {
+    return null;
+  }
+
+  return (
+    <p
+      ref={ref}
+      id={formMessageId}
+      className={cn(
+        "font-sans text-[0.75rem] font-[500] leading-[1.125rem] text-red-500 dark:text-red-900",
+        className,
+      )}
+      {...props}
+    >
+      {body}
+    </p>
+  );
+});
+FormMessage.displayName = "FormMessage";
+
+export {
+  Form,
+  FormControl,
+  FormDescription,
+  FormField,
+  FormItem,
+  FormLabel,
+  FormMessage,
+  useFormField,
+};
diff --git a/autogpt_platform/frontend/src/components/molecules/SecondaryMenu/SecondaryMenu.stories.tsx b/autogpt_platform/frontend/src/components/molecules/SecondaryMenu/SecondaryMenu.stories.tsx
new file mode 100644
index 0000000000..907a552056
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/molecules/SecondaryMenu/SecondaryMenu.stories.tsx
@@ -0,0 +1,99 @@
+import { Button } from "@/components/atoms/Button/Button";
+import {
+  DropdownMenu,
+  DropdownMenuTrigger,
+} from "@/components/molecules/DropdownMenu/DropdownMenu";
+import {
+  ArrowSquareOutIcon,
+  CopyIcon,
+  DotsThreeOutlineVerticalIcon,
+  TrashIcon,
+} from "@phosphor-icons/react";
+import * as ContextMenu from "@radix-ui/react-context-menu";
+import type { Meta, StoryObj } from "@storybook/nextjs";
+import {
+  SecondaryDropdownMenuContent,
+  SecondaryDropdownMenuItem,
+  SecondaryDropdownMenuSeparator,
+  SecondaryMenuContent,
+  SecondaryMenuItem,
+  SecondaryMenuSeparator,
+} from "./SecondaryMenu";
+
+const meta: Meta = {
+  title: "Molecules/SecondaryMenu",
+  component: SecondaryMenuContent,
+};
+
+export default meta;
+type Story = StoryObj<typeof SecondaryMenuContent>;
+
+export const ContextMenuExample: Story = {
+  render: () => (
+    <div className="flex h-96 items-center justify-center">
+      <ContextMenu.Root>
+        <ContextMenu.Trigger asChild>
+          <div className="flex h-32 w-64 cursor-pointer items-center justify-center rounded-lg border border-gray-300 bg-gray-50 dark:border-gray-600 dark:bg-gray-800">
+            Right-click me
+          </div>
+        </ContextMenu.Trigger>
+        <SecondaryMenuContent>
+          <SecondaryMenuItem onSelect={() => alert("Copy")}>
+            <CopyIcon size={20} className="mr-2 dark:text-gray-100" />
+            <span className="dark:text-gray-100">Copy</span>
+          </SecondaryMenuItem>
+          <SecondaryMenuItem onSelect={() => alert("Open agent")}>
+            <ArrowSquareOutIcon size={20} className="mr-2 dark:text-gray-100" />
+            <span className="dark:text-gray-100">Open agent</span>
+          </SecondaryMenuItem>
+          <SecondaryMenuSeparator />
+          <SecondaryMenuItem
+            variant="destructive"
+            onSelect={() => alert("Delete")}
+          >
+            <TrashIcon
+              size={20}
+              className="mr-2 text-red-500 dark:text-red-400"
+            />
+            <span className="dark:text-red-400">Delete</span>
+          </SecondaryMenuItem>
+        </SecondaryMenuContent>
+      </ContextMenu.Root>
+    </div>
+  ),
+};
+
+export const DropdownMenuExample: Story = {
+  render: () => (
+    <div className="flex h-96 items-center justify-center">
+      <DropdownMenu>
+        <DropdownMenuTrigger asChild>
+          <Button variant="secondary" size="small">
+            <DotsThreeOutlineVerticalIcon size={16} weight="fill" />
+          </Button>
+        </DropdownMenuTrigger>
+        <SecondaryDropdownMenuContent side="right" align="start">
+          <SecondaryDropdownMenuItem onClick={() => alert("Copy")}>
+            <CopyIcon size={20} className="mr-2 dark:text-gray-100" />
+            <span className="dark:text-gray-100">Copy</span>
+          </SecondaryDropdownMenuItem>
+          <SecondaryDropdownMenuItem onClick={() => alert("Open agent")}>
+            <ArrowSquareOutIcon size={20} className="mr-2 dark:text-gray-100" />
+            <span className="dark:text-gray-100">Open agent</span>
+          </SecondaryDropdownMenuItem>
+          <SecondaryDropdownMenuSeparator />
+          <SecondaryDropdownMenuItem
+            variant="destructive"
+            onClick={() => alert("Delete")}
+          >
+            <TrashIcon
+              size={20}
+              className="mr-2 text-red-500 dark:text-red-400"
+            />
+            <span className="dark:text-red-400">Delete</span>
+          </SecondaryDropdownMenuItem>
+        </SecondaryDropdownMenuContent>
+      </DropdownMenu>
+    </div>
+  ),
+};
diff --git a/autogpt_platform/frontend/src/components/molecules/SecondaryMenu/SecondaryMenu.tsx b/autogpt_platform/frontend/src/components/molecules/SecondaryMenu/SecondaryMenu.tsx
new file mode 100644
index 0000000000..fd445491e7
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/molecules/SecondaryMenu/SecondaryMenu.tsx
@@ -0,0 +1,103 @@
+"use client";
+
+import { cn } from "@/lib/utils";
+import * as ContextMenu from "@radix-ui/react-context-menu";
+import * as DropdownMenuPrimitive from "@radix-ui/react-dropdown-menu";
+import React from "react";
+
+const secondaryMenuContentClassName =
+  "z-10 rounded-xl border bg-white p-1 shadow-md dark:bg-gray-800";
+
+const secondaryMenuItemClassName =
+  "flex cursor-pointer items-center rounded-md px-3 py-2 hover:bg-gray-100 dark:hover:bg-gray-700";
+
+const secondaryMenuSeparatorClassName =
+  "my-1 h-px bg-gray-300 dark:bg-gray-600";
+
+export const SecondaryMenuContent = React.forwardRef<
+  React.ElementRef<typeof ContextMenu.Content>,
+  React.ComponentPropsWithoutRef<typeof ContextMenu.Content>
+>(({ className, ...props }, ref) => (
+  <ContextMenu.Content
+    ref={ref}
+    className={cn(secondaryMenuContentClassName, className)}
+    {...props}
+  />
+));
+SecondaryMenuContent.displayName = "SecondaryMenuContent";
+
+export const SecondaryMenuItem = React.forwardRef<
+  React.ElementRef<typeof ContextMenu.Item>,
+  React.ComponentPropsWithoutRef<typeof ContextMenu.Item> & {
+    variant?: "default" | "destructive";
+  }
+>(({ className, variant = "default", ...props }, ref) => (
+  <ContextMenu.Item
+    ref={ref}
+    className={cn(
+      secondaryMenuItemClassName,
+      variant === "destructive" &&
+        "text-red-500 hover:bg-gray-100 dark:hover:bg-gray-700",
+      className,
+    )}
+    {...props}
+  />
+));
+SecondaryMenuItem.displayName = "SecondaryMenuItem";
+
+export const SecondaryMenuSeparator = React.forwardRef<
+  React.ElementRef<typeof ContextMenu.Separator>,
+  React.ComponentPropsWithoutRef<typeof ContextMenu.Separator>
+>(({ className, ...props }, ref) => (
+  <ContextMenu.Separator
+    ref={ref}
+    className={cn(secondaryMenuSeparatorClassName, className)}
+    {...props}
+  />
+));
+SecondaryMenuSeparator.displayName = "SecondaryMenuSeparator";
+
+export const SecondaryDropdownMenuContent = React.forwardRef<
+  React.ElementRef<typeof DropdownMenuPrimitive.Content>,
+  React.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Content>
+>(({ className, ...props }, ref) => (
+  <DropdownMenuPrimitive.Portal>
+    <DropdownMenuPrimitive.Content
+      ref={ref}
+      className={cn(secondaryMenuContentClassName, className)}
+      {...props}
+    />
+  </DropdownMenuPrimitive.Portal>
+));
+SecondaryDropdownMenuContent.displayName = "SecondaryDropdownMenuContent";
+
+export const SecondaryDropdownMenuItem = React.forwardRef<
+  React.ElementRef<typeof DropdownMenuPrimitive.Item>,
+  React.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Item> & {
+    variant?: "default" | "destructive";
+  }
+>(({ className, variant = "default", ...props }, ref) => (
+  <DropdownMenuPrimitive.Item
+    ref={ref}
+    className={cn(
+      secondaryMenuItemClassName,
+      variant === "destructive" &&
+        "text-red-500 hover:bg-gray-100 dark:hover:bg-gray-700",
+      className,
+    )}
+    {...props}
+  />
+));
+SecondaryDropdownMenuItem.displayName = "SecondaryDropdownMenuItem";
+
+export const SecondaryDropdownMenuSeparator = React.forwardRef<
+  React.ElementRef<typeof DropdownMenuPrimitive.Separator>,
+  React.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Separator>
+>(({ className, ...props }, ref) => (
+  <DropdownMenuPrimitive.Separator
+    ref={ref}
+    className={cn(secondaryMenuSeparatorClassName, className)}
+    {...props}
+  />
+));
+SecondaryDropdownMenuSeparator.displayName = "SecondaryDropdownMenuSeparator";
diff --git a/autogpt_platform/frontend/src/components/molecules/Table/Table.stories.tsx b/autogpt_platform/frontend/src/components/molecules/Table/Table.stories.tsx
new file mode 100644
index 0000000000..6dfb0b378f
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/molecules/Table/Table.stories.tsx
@@ -0,0 +1,116 @@
+import type { Meta, StoryObj } from "@storybook/nextjs";
+import { TooltipProvider } from "@/components/atoms/Tooltip/BaseTooltip";
+import { Table } from "./Table";
+
+const meta = {
+  title: "Molecules/Table",
+  component: Table,
+  decorators: [
+    (Story) => (
+      <TooltipProvider>
+        <Story />
+      </TooltipProvider>
+    ),
+  ],
+  parameters: {
+    layout: "centered",
+  },
+  tags: ["autodocs"],
+  argTypes: {
+    allowAddRow: {
+      control: "boolean",
+      description: "Whether to show the Add row button",
+    },
+    allowDeleteRow: {
+      control: "boolean",
+      description: "Whether to show delete buttons for each row",
+    },
+    readOnly: {
+      control: "boolean",
+      description:
+        "Whether the table is read-only (renders text instead of inputs)",
+    },
+    addRowLabel: {
+      control: "text",
+      description: "Label for the Add row button",
+    },
+  },
+} satisfies Meta<typeof Table>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {
+  args: {
+    columns: ["name", "email", "role"],
+    allowAddRow: true,
+    allowDeleteRow: true,
+  },
+};
+
+export const WithDefaultValues: Story = {
+  args: {
+    columns: ["name", "email", "role"],
+    defaultValues: [
+      { name: "John Doe", email: "john@example.com", role: "Admin" },
+      { name: "Jane Smith", email: "jane@example.com", role: "User" },
+      { name: "Bob Wilson", email: "bob@example.com", role: "Editor" },
+    ],
+    allowAddRow: true,
+    allowDeleteRow: true,
+  },
+};
+
+export const ReadOnly: Story = {
+  args: {
+    columns: ["name", "email"],
+    defaultValues: [
+      { name: "John Doe", email: "john@example.com" },
+      { name: "Jane Smith", email: "jane@example.com" },
+    ],
+    readOnly: true,
+  },
+};
+
+export const NoAddOrDelete: Story = {
+  args: {
+    columns: ["name", "email"],
+    defaultValues: [
+      { name: "John Doe", email: "john@example.com" },
+      { name: "Jane Smith", email: "jane@example.com" },
+    ],
+    allowAddRow: false,
+    allowDeleteRow: false,
+  },
+};
+
+export const SingleColumn: Story = {
+  args: {
+    columns: ["item"],
+    allowAddRow: true,
+    allowDeleteRow: true,
+    addRowLabel: "Add item",
+  },
+};
+
+export const CustomAddLabel: Story = {
+  args: {
+    columns: ["key", "value"],
+    allowAddRow: true,
+    allowDeleteRow: true,
+    addRowLabel: "Add new entry",
+  },
+};
+
+export const KeyValuePairs: Story = {
+  args: {
+    columns: ["key", "value"],
+    defaultValues: [
+      { key: "API_KEY", value: "sk-..." },
+      { key: "DATABASE_URL", value: "postgres://..." },
+    ],
+    allowAddRow: true,
+    allowDeleteRow: true,
+    addRowLabel: "Add variable",
+  },
+};
diff --git a/autogpt_platform/frontend/src/components/molecules/Table/Table.tsx b/autogpt_platform/frontend/src/components/molecules/Table/Table.tsx
new file mode 100644
index 0000000000..a09a8344a5
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/molecules/Table/Table.tsx
@@ -0,0 +1,133 @@
+import * as React from "react";
+import {
+  Table as BaseTable,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/components/__legacy__/ui/table";
+import { Button } from "@/components/atoms/Button/Button";
+import { Input } from "@/components/atoms/Input/Input";
+import { Text } from "@/components/atoms/Text/Text";
+import { Plus, Trash2 } from "lucide-react";
+import { cn } from "@/lib/utils";
+import { useTable, RowData } from "./useTable";
+import { formatColumnTitle, formatPlaceholder } from "./helpers";
+
+export interface TableProps {
+  columns: string[];
+  defaultValues?: RowData[];
+  onChange?: (rows: RowData[]) => void;
+  allowAddRow?: boolean;
+  allowDeleteRow?: boolean;
+  addRowLabel?: string;
+  className?: string;
+  readOnly?: boolean;
+}
+
+export function Table({
+  columns,
+  defaultValues,
+  onChange,
+  allowAddRow = true,
+  allowDeleteRow = true,
+  addRowLabel = "Add row",
+  className,
+  readOnly = false,
+}: TableProps) {
+  const { rows, handleAddRow, handleDeleteRow, handleCellChange } = useTable({
+    columns,
+    defaultValues,
+    onChange,
+  });
+
+  const showDeleteColumn = allowDeleteRow && !readOnly;
+  const showAddButton = allowAddRow && !readOnly;
+
+  return (
+    <div className={cn("flex flex-col gap-3", className)}>
+      <div className="overflow-hidden rounded-xl border border-zinc-200 bg-white">
+        <BaseTable>
+          <TableHeader>
+            <TableRow className="border-b border-zinc-100 bg-zinc-50/50">
+              {columns.map((column) => (
+                <TableHead
+                  key={column}
+                  className="h-10 px-3 text-sm font-medium text-zinc-600"
+                >
+                  {formatColumnTitle(column)}
+                </TableHead>
+              ))}
+              {showDeleteColumn && <TableHead className="w-[50px]" />}
+            </TableRow>
+          </TableHeader>
+          <TableBody>
+            {rows.map((row, rowIndex) => (
+              <TableRow key={rowIndex} className="border-none">
+                {columns.map((column) => (
+                  <TableCell key={`${rowIndex}-${column}`} className="p-2">
+                    {readOnly ? (
+                      <Text
+                        variant="body"
+                        className="px-3 py-2 text-sm text-zinc-800"
+                      >
+                        {row[column] || "-"}
+                      </Text>
+                    ) : (
+                      <Input
+                        id={`table-${rowIndex}-${column}`}
+                        label={formatColumnTitle(column)}
+                        hideLabel
+                        value={row[column] ?? ""}
+                        onChange={(e) =>
+                          handleCellChange(rowIndex, column, e.target.value)
+                        }
+                        placeholder={formatPlaceholder(column)}
+                        size="small"
+                        wrapperClassName="mb-0"
+                      />
+                    )}
+                  </TableCell>
+                ))}
+                {showDeleteColumn && (
+                  <TableCell className="p-2">
+                    <Button
+                      variant="icon"
+                      size="icon"
+                      onClick={() => handleDeleteRow(rowIndex)}
+                      aria-label="Delete row"
+                      className="text-zinc-400 transition-colors hover:text-red-500"
+                    >
+                      <Trash2 className="h-4 w-4" />
+                    </Button>
+                  </TableCell>
+                )}
+              </TableRow>
+            ))}
+            {showAddButton && (
+              <TableRow>
+                <TableCell
+                  colSpan={columns.length + (showDeleteColumn ? 1 : 0)}
+                  className="p-2"
+                >
+                  <Button
+                    variant="outline"
+                    size="small"
+                    onClick={handleAddRow}
+                    leftIcon={<Plus className="h-4 w-4" />}
+                    className="w-fit"
+                  >
+                    {addRowLabel}
+                  </Button>
+                </TableCell>
+              </TableRow>
+            )}
+          </TableBody>
+        </BaseTable>
+      </div>
+    </div>
+  );
+}
+
+export { type RowData } from "./useTable";
diff --git a/autogpt_platform/frontend/src/components/molecules/Table/helpers.ts b/autogpt_platform/frontend/src/components/molecules/Table/helpers.ts
new file mode 100644
index 0000000000..3ea116095a
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/molecules/Table/helpers.ts
@@ -0,0 +1,7 @@
+export const formatColumnTitle = (key: string): string => {
+  return key.charAt(0).toUpperCase() + key.slice(1);
+};
+
+export const formatPlaceholder = (key: string): string => {
+  return `Enter ${key.toLowerCase()}`;
+};
diff --git a/autogpt_platform/frontend/src/components/molecules/Table/useTable.ts b/autogpt_platform/frontend/src/components/molecules/Table/useTable.ts
new file mode 100644
index 0000000000..085c18aa74
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/molecules/Table/useTable.ts
@@ -0,0 +1,81 @@
+import { useState, useEffect } from "react";
+
+export type RowData = Record<string, string>;
+
+interface UseTableOptions {
+  columns: string[];
+  defaultValues?: RowData[];
+  onChange?: (rows: RowData[]) => void;
+}
+
+export function useTable({
+  columns,
+  defaultValues,
+  onChange,
+}: UseTableOptions) {
+  const createEmptyRow = (): RowData => {
+    const emptyRow: RowData = {};
+    columns.forEach((column) => {
+      emptyRow[column] = "";
+    });
+    return emptyRow;
+  };
+
+  const [rows, setRows] = useState<RowData[]>(() => {
+    if (defaultValues && defaultValues.length > 0) {
+      return defaultValues;
+    }
+    return [];
+  });
+
+  useEffect(() => {
+    if (defaultValues !== undefined) {
+      setRows(defaultValues);
+    }
+  }, [defaultValues]);
+
+  const updateRows = (newRows: RowData[]) => {
+    setRows(newRows);
+    onChange?.(newRows);
+  };
+
+  const handleAddRow = () => {
+    const newRows = [...rows, createEmptyRow()];
+    updateRows(newRows);
+  };
+
+  const handleDeleteRow = (rowIndex: number) => {
+    const newRows = rows.filter((_, index) => index !== rowIndex);
+    updateRows(newRows);
+  };
+
+  const handleCellChange = (
+    rowIndex: number,
+    columnKey: string,
+    value: string,
+  ) => {
+    const newRows = rows.map((row, index) => {
+      if (index === rowIndex) {
+        return {
+          ...row,
+          [columnKey]: value,
+        };
+      }
+      return row;
+    });
+    updateRows(newRows);
+  };
+
+  const clearAll = () => {
+    updateRows([]);
+  };
+
+  return {
+    rows,
+    handleAddRow,
+    handleDeleteRow,
+    handleCellChange,
+    clearAll,
+    createEmptyRow,
+  };
+}
diff --git a/autogpt_platform/frontend/src/components/molecules/TallyPoup/TallyPopup.tsx b/autogpt_platform/frontend/src/components/molecules/TallyPoup/TallyPopup.tsx
index d8b7a6027d..be00982084 100644
--- a/autogpt_platform/frontend/src/components/molecules/TallyPoup/TallyPopup.tsx
+++ b/autogpt_platform/frontend/src/components/molecules/TallyPoup/TallyPopup.tsx
@@ -3,9 +3,14 @@
 import React from "react";
 import { useTallyPopup } from "./useTallyPopup";
 import { Button } from "@/components/atoms/Button/Button";
+import { usePathname, useSearchParams } from "next/navigation";
 
 export function TallyPopupSimple() {
   const { state, handlers } = useTallyPopup();
+  const searchParams = useSearchParams();
+  const pathname = usePathname();
+  const isNewBuilder =
+    pathname.includes("build") && searchParams.get("view") === "new";
 
   if (state.isFormVisible) {
     return null;
@@ -13,7 +18,7 @@ export function TallyPopupSimple() {
 
   return (
     <div className="fixed bottom-1 right-0 z-20 hidden select-none items-center gap-4 p-3 transition-all duration-300 ease-in-out md:flex">
-      {state.showTutorial && (
+      {state.showTutorial && !isNewBuilder && (
         <Button
           variant="primary"
           onClick={handlers.handleResetTutorial}
diff --git a/autogpt_platform/frontend/src/components/molecules/Toast/styles.module.css b/autogpt_platform/frontend/src/components/molecules/Toast/styles.module.css
index ec8271958f..d1daaaa88b 100644
--- a/autogpt_platform/frontend/src/components/molecules/Toast/styles.module.css
+++ b/autogpt_platform/frontend/src/components/molecules/Toast/styles.module.css
@@ -37,11 +37,3 @@ html body .toastDescription {
   font-size: 0.75rem !important;
   line-height: 1.25rem !important;
 }
-
-/* Position close button on the right */
-/* stylelint-disable-next-line selector-pseudo-class-no-unknown */
-#root [data-sonner-toast] [data-close-button="true"] {
-  left: unset !important;
-  right: -18px !important;
-  top: -3px !important;
-}
diff --git a/autogpt_platform/frontend/src/components/molecules/Toast/toaster.tsx b/autogpt_platform/frontend/src/components/molecules/Toast/toaster.tsx
index adb88831af..80b228f03b 100644
--- a/autogpt_platform/frontend/src/components/molecules/Toast/toaster.tsx
+++ b/autogpt_platform/frontend/src/components/molecules/Toast/toaster.tsx
@@ -1,6 +1,5 @@
 "use client";
 
-import { CheckCircle, Info, Warning, XCircle } from "@phosphor-icons/react";
 import { Toaster as SonnerToaster } from "sonner";
 import styles from "./styles.module.css";
 
@@ -23,10 +22,10 @@ export function Toaster() {
       }}
       className="custom__toast"
       icons={{
-        success: <CheckCircle className="h-4 w-4" color="#fff" weight="fill" />,
-        error: <XCircle className="h-4 w-4" color="#fff" weight="fill" />,
-        warning: <Warning className="h-4 w-4" color="#fff" weight="fill" />,
-        info: <Info className="h-4 w-4" color="#fff" weight="fill" />,
+        success: null,
+        error: null,
+        warning: null,
+        info: null,
       }}
     />
   );
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/FormRenderer.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/FormRenderer.tsx
similarity index 57%
rename from autogpt_platform/frontend/src/components/renderers/input-renderer/FormRenderer.tsx
rename to autogpt_platform/frontend/src/components/renderers/InputRenderer/FormRenderer.tsx
index 22c5496efb..fc388cc343 100644
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/FormRenderer.tsx
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/FormRenderer.tsx
@@ -1,26 +1,17 @@
-import { BlockUIType } from "@/app/(platform)/build/components/types";
-import Form from "@rjsf/core";
 import { RJSFSchema } from "@rjsf/utils";
-import { fields } from "./fields";
-import { templates } from "./templates";
-import { widgets } from "./widgets";
 import { preprocessInputSchema } from "./utils/input-schema-pre-processor";
 import { useMemo } from "react";
 import { customValidator } from "./utils/custom-validator";
-
-type FormContextType = {
-  nodeId?: string;
-  uiType?: BlockUIType;
-  showHandles?: boolean;
-  size?: "small" | "medium" | "large";
-};
+import Form from "./registry";
+import { ExtendedFormContextType } from "./types";
+import { generateUiSchemaForCustomFields } from "./utils/generate-ui-schema";
 
 type FormRendererProps = {
   jsonSchema: RJSFSchema;
   handleChange: (formData: any) => void;
   uiSchema: any;
   initialValues: any;
-  formContext: FormContextType;
+  formContext: ExtendedFormContextType;
 };
 
 export const FormRenderer = ({
@@ -33,19 +24,25 @@ export const FormRenderer = ({
   const preprocessedSchema = useMemo(() => {
     return preprocessInputSchema(jsonSchema);
   }, [jsonSchema]);
+
+  // Merge custom field ui:field settings with existing uiSchema
+  const mergedUiSchema = useMemo(() => {
+    return generateUiSchemaForCustomFields(preprocessedSchema, uiSchema);
+  }, [preprocessedSchema, uiSchema]);
+
+  console.log("preprocessedSchema", preprocessedSchema);
+
   return (
-    <div className={"mt-4"}>
+    <div className={"mb-6 mt-4"} data-tutorial-id="input-handles">
       <Form
+        formContext={formContext}
+        idPrefix="agpt"
+        idSeparator="_%_"
         schema={preprocessedSchema}
         validator={customValidator}
-        fields={fields}
-        templates={templates}
-        widgets={widgets}
-        formContext={formContext}
         onChange={handleChange}
-        uiSchema={uiSchema}
+        uiSchema={mergedUiSchema}
         formData={initialValues}
-        noValidate={true}
         liveValidate={false}
       />
     </div>
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/anyof/AnyOfField.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/anyof/AnyOfField.tsx
new file mode 100644
index 0000000000..6514ce9af0
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/anyof/AnyOfField.tsx
@@ -0,0 +1,108 @@
+import { FieldProps, getUiOptions, getWidget } from "@rjsf/utils";
+import { AnyOfFieldTitle } from "./components/AnyOfFieldTitle";
+import { isEmpty } from "lodash";
+import { useAnyOfField } from "./useAnyOfField";
+import { cleanUpHandleId, getHandleId, updateUiOption } from "../../helpers";
+import { useEdgeStore } from "@/app/(platform)/build/stores/edgeStore";
+import { ANY_OF_FLAG } from "../../constants";
+import { findCustomFieldId } from "../../registry";
+import { useNodeStore } from "@/app/(platform)/build/stores/nodeStore";
+import { cn } from "@/lib/utils";
+
+export const AnyOfField = (props: FieldProps) => {
+  const { registry, schema } = props;
+  const { fields } = registry;
+  const { SchemaField: _SchemaField } = fields;
+  const { nodeId } = registry.formContext;
+  const { isInputConnected } = useEdgeStore();
+  const {
+    handleOptionChange,
+    enumOptions,
+    selectedOption,
+    optionSchema,
+    field_id,
+  } = useAnyOfField(props);
+
+  const isInputBroken = useNodeStore((state) => state.isInputBroken);
+
+  const parentCustomFieldId = findCustomFieldId(schema);
+  if (parentCustomFieldId) {
+    return null;
+  }
+
+  const uiOptions = getUiOptions(props.uiSchema, props.globalUiOptions);
+
+  const Widget = getWidget({ type: "string" }, "select", registry.widgets);
+
+  const handleId = getHandleId({
+    uiOptions,
+    id: field_id + ANY_OF_FLAG,
+    schema: schema,
+  });
+
+  const updatedUiSchema = updateUiOption(props.uiSchema, {
+    handleId: handleId,
+    label: false,
+    fromAnyOf: true,
+  });
+
+  const isHandleConnected = isInputConnected(nodeId, handleId);
+  const isAnyOfInputBroken = isInputBroken(nodeId, cleanUpHandleId(handleId));
+
+  // Now anyOf can render - custom fields if the option schema matches a custom field
+  const optionCustomFieldId = optionSchema
+    ? findCustomFieldId(optionSchema)
+    : null;
+
+  const optionUiSchema = optionCustomFieldId
+    ? { ...updatedUiSchema, "ui:field": optionCustomFieldId }
+    : updatedUiSchema;
+
+  const optionsSchemaField =
+    (optionSchema && optionSchema.type !== "null" && (
+      <_SchemaField
+        {...props}
+        schema={optionSchema}
+        uiSchema={optionUiSchema}
+      />
+    )) ||
+    null;
+
+  const selector = (
+    <Widget
+      id={field_id}
+      name={`${props.name}${schema.oneOf ? "__oneof_select" : "__anyof_select"}`}
+      schema={{ type: "number", default: 0 }}
+      onChange={handleOptionChange}
+      onBlur={props.onBlur}
+      onFocus={props.onFocus}
+      disabled={props.disabled || isEmpty(enumOptions)}
+      multiple={false}
+      value={selectedOption >= 0 ? selectedOption : undefined}
+      options={{ enumOptions }}
+      registry={registry}
+      placeholder={props.placeholder}
+      autocomplete={props.autocomplete}
+      className={cn(
+        "-ml-1 h-[22px] w-fit gap-1 px-1 pl-2 text-xs font-medium",
+        isAnyOfInputBroken &&
+          "border-red-500 bg-red-100 text-red-600 line-through",
+      )}
+      autofocus={props.autofocus}
+      label=""
+      hideLabel={true}
+      readonly={props.readonly}
+    />
+  );
+
+  return (
+    <div>
+      <AnyOfFieldTitle
+        {...props}
+        selector={selector}
+        uiSchema={updatedUiSchema}
+      />
+      {!isHandleConnected && !isAnyOfInputBroken && optionsSchemaField}
+    </div>
+  );
+};
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/anyof/components/AnyOfFieldTitle.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/anyof/components/AnyOfFieldTitle.tsx
new file mode 100644
index 0000000000..48b6d83b70
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/anyof/components/AnyOfFieldTitle.tsx
@@ -0,0 +1,94 @@
+import {
+  descriptionId,
+  FieldProps,
+  getTemplate,
+  getUiOptions,
+  titleId,
+} from "@rjsf/utils";
+import { shouldShowTypeSelector } from "../helpers";
+import { useIsArrayItem } from "../../array/context/array-item-context";
+import { cleanUpHandleId } from "../../../helpers";
+import { useEdgeStore } from "@/app/(platform)/build/stores/edgeStore";
+import { Text } from "@/components/atoms/Text/Text";
+import { isOptionalType } from "../../../utils/schema-utils";
+import { getTypeDisplayInfo } from "@/app/(platform)/build/components/FlowEditor/nodes/helpers";
+import { cn } from "@/lib/utils";
+import { useNodeStore } from "@/app/(platform)/build/stores/nodeStore";
+
+interface customFieldProps extends FieldProps {
+  selector: JSX.Element;
+}
+
+export const AnyOfFieldTitle = (props: customFieldProps) => {
+  const { uiSchema, schema, required, name, registry, fieldPathId, selector } =
+    props;
+  const { isInputConnected } = useEdgeStore();
+  const { nodeId } = registry.formContext;
+
+  const uiOptions = getUiOptions(uiSchema);
+  const TitleFieldTemplate = getTemplate(
+    "TitleFieldTemplate",
+    registry,
+    uiOptions,
+  );
+  const DescriptionFieldTemplate = getTemplate(
+    "DescriptionFieldTemplate",
+    registry,
+    uiOptions,
+  );
+
+  const title_id = titleId(fieldPathId ?? "");
+  const description_id = descriptionId(fieldPathId ?? "");
+
+  const isArrayItem = useIsArrayItem();
+
+  const handleId = cleanUpHandleId(uiOptions.handleId);
+  const isHandleConnected = isInputConnected(nodeId, handleId);
+
+  const { isOptional, type } = isOptionalType(schema); // If we have something like int | null = we will treat it as optional int
+  const { displayType, colorClass } = getTypeDisplayInfo(type);
+
+  const shouldShowSelector =
+    shouldShowTypeSelector(schema) && !isArrayItem && !isHandleConnected;
+  const shoudlShowType = isHandleConnected || (isOptional && type);
+
+  const isInputBroken = useNodeStore((state) =>
+    state.isInputBroken(nodeId, cleanUpHandleId(uiOptions.handleId)),
+  );
+  const inputMismatch = useNodeStore((state) =>
+    state.getInputTypeMismatch(nodeId, cleanUpHandleId(uiOptions.handleId)),
+  );
+
+  return (
+    <div className="flex items-center gap-2">
+      <TitleFieldTemplate
+        id={title_id}
+        title={schema.title || name || ""}
+        required={required}
+        schema={schema}
+        registry={registry}
+        uiSchema={uiSchema}
+      />
+      {shoudlShowType && (
+        <Text
+          variant="small"
+          className={cn(
+            "text-zinc-700",
+            isInputBroken && "line-through",
+            colorClass,
+            inputMismatch && "rounded-md bg-red-100 px-1 !text-red-500",
+          )}
+        >
+          {isOptional ? `(${inputMismatch || displayType})` : "(any)"}
+        </Text>
+      )}
+      {shouldShowSelector && selector}
+      <DescriptionFieldTemplate
+        id={description_id}
+        description={schema.description || ""}
+        schema={schema}
+        registry={registry}
+      />
+    </div>
+  );
+};
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/anyof/helpers.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/anyof/helpers.ts
new file mode 100644
index 0000000000..0a18bbf4d7
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/anyof/helpers.ts
@@ -0,0 +1,61 @@
+import { RJSFSchema, StrictRJSFSchema } from "@rjsf/utils";
+
+const TYPE_PRIORITY = [
+  "string",
+  "number",
+  "integer",
+  "boolean",
+  "array",
+  "object",
+] as const;
+
+export function getDefaultTypeIndex(options: StrictRJSFSchema[]): number {
+  for (const preferredType of TYPE_PRIORITY) {
+    const index = options.findIndex((opt) => opt.type === preferredType);
+    if (index >= 0) return index;
+  }
+
+  const nonNullIndex = options.findIndex((opt) => opt.type !== "null");
+  return nonNullIndex >= 0 ? nonNullIndex : 0;
+}
+
+/**
+ * Determines if a type selector should be shown for an anyOf schema
+ * Returns false for simple optional types (type | null)
+ * Returns true for complex anyOf (3+ types or multiple non-null types)
+ */
+export function shouldShowTypeSelector(
+  schema: RJSFSchema | undefined,
+): boolean {
+  const anyOf = schema?.anyOf;
+  if (!anyOf || !Array.isArray(anyOf) || anyOf.length === 0) {
+    return false;
+  }
+
+  if (anyOf.length === 2 && anyOf.some((opt: any) => opt.type === "null")) {
+    return false;
+  }
+
+  return anyOf.length >= 3;
+}
+
+export function isSimpleOptional(schema: RJSFSchema | undefined): boolean {
+  const anyOf = schema?.anyOf;
+  return (
+    Array.isArray(anyOf) &&
+    anyOf.length === 2 &&
+    anyOf.some((opt: any) => opt.type === "null")
+  );
+}
+
+export function getOptionalType(
+  schema: RJSFSchema | undefined,
+): string | undefined {
+  if (!isSimpleOptional(schema)) {
+    return undefined;
+  }
+
+  const anyOf = schema?.anyOf;
+  const nonNullOption = anyOf?.find((opt: any) => opt.type !== "null");
+  return nonNullOption ? (nonNullOption as any).type : undefined;
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/anyof/useAnyOfField.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/anyof/useAnyOfField.ts
new file mode 100644
index 0000000000..15825902b6
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/anyof/useAnyOfField.ts
@@ -0,0 +1,96 @@
+import { FieldProps, getFirstMatchingOption, mergeSchemas } from "@rjsf/utils";
+import { useRef, useState } from "react";
+import validator from "@rjsf/validator-ajv8";
+import { getDefaultTypeIndex } from "./helpers";
+import { cleanUpHandleId } from "../../helpers";
+import { useEdgeStore } from "@/app/(platform)/build/stores/edgeStore";
+
+export const useAnyOfField = (props: FieldProps) => {
+  const { registry, schema, options, onChange, formData } = props;
+  const { schemaUtils } = registry;
+
+  const getInitialOption = () => {
+    if (formData !== undefined && formData !== null) {
+      const option = getFirstMatchingOption(
+        validator,
+        formData,
+        options,
+        schema,
+      );
+      return option !== undefined ? option : getDefaultTypeIndex(options);
+    }
+    return getDefaultTypeIndex(options);
+  };
+
+  const [selectedOption, setSelectedOption] =
+    useState<number>(getInitialOption());
+  const retrievedOptions = useRef<any[]>(
+    options.map((opt: any) => schemaUtils.retrieveSchema(opt, formData)),
+  );
+
+  const option =
+    selectedOption >= 0
+      ? retrievedOptions.current[selectedOption] || null
+      : null;
+  let optionSchema: any | undefined | null;
+
+  // adding top level required to each option schema
+  if (option) {
+    const { required } = schema;
+    optionSchema = required
+      ? (mergeSchemas({ required }, option) as any)
+      : option;
+  }
+
+  const field_id = props.fieldPathId.$id;
+
+  const handleOptionChange = (option?: string) => {
+    const intOption = option !== undefined ? parseInt(option, 10) : -1;
+    if (intOption === selectedOption) return;
+
+    const newOption =
+      intOption >= 0 ? retrievedOptions.current[intOption] : undefined;
+    const oldOption =
+      selectedOption >= 0
+        ? retrievedOptions.current[selectedOption]
+        : undefined;
+
+    //   When we change the option, we need to clean the form data
+    let newFormData = schemaUtils.sanitizeDataForNewSchema(
+      newOption,
+      oldOption,
+      formData,
+    );
+
+    const handlePrefix = cleanUpHandleId(field_id);
+    console.log("handlePrefix", handlePrefix);
+    useEdgeStore
+      .getState()
+      .removeEdgesByHandlePrefix(registry.formContext.nodeId, handlePrefix);
+
+    // We have cleaned the form data, now we need to get the default form state of new selected option
+    if (newOption) {
+      newFormData = schemaUtils.getDefaultFormState(
+        newOption,
+        newFormData,
+        "excludeObjectChildren",
+      ) as any;
+    }
+
+    setSelectedOption(intOption);
+    onChange(newFormData, props.fieldPathId.path, undefined, field_id);
+  };
+
+  const enumOptions = retrievedOptions.current.map((option, index) => ({
+    value: index,
+    label: option.type,
+  }));
+
+  return {
+    handleOptionChange,
+    enumOptions,
+    selectedOption,
+    optionSchema,
+    field_id,
+  };
+};
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/array/ArrayFieldItemTemplate.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/array/ArrayFieldItemTemplate.tsx
new file mode 100644
index 0000000000..f6b1583b14
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/array/ArrayFieldItemTemplate.tsx
@@ -0,0 +1,34 @@
+import {
+  ArrayFieldItemTemplateProps,
+  getTemplate,
+  getUiOptions,
+} from "@rjsf/utils";
+
+export default function ArrayFieldItemTemplate(
+  props: ArrayFieldItemTemplateProps,
+) {
+  const { children, buttonsProps, hasToolbar, uiSchema, registry } = props;
+  const uiOptions = getUiOptions(uiSchema);
+  const ArrayFieldItemButtonsTemplate = getTemplate(
+    "ArrayFieldItemButtonsTemplate",
+    registry,
+    uiOptions,
+  );
+
+  return (
+    <div>
+      <div className="mb-2 flex flex-row flex-wrap items-center">
+        <div className="shrink grow">
+          <div className="shrink grow">{children}</div>
+        </div>
+        <div className="flex items-end justify-end">
+          {hasToolbar && (
+            <div className="-mt-4 mb-2 flex gap-2">
+              <ArrayFieldItemButtonsTemplate {...buttonsProps} />
+            </div>
+          )}
+        </div>
+      </div>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/array/ArrayFieldTemplate.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/array/ArrayFieldTemplate.tsx
new file mode 100644
index 0000000000..2ece545339
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/array/ArrayFieldTemplate.tsx
@@ -0,0 +1,116 @@
+import {
+  ArrayFieldTemplateProps,
+  buttonId,
+  getTemplate,
+  getUiOptions,
+} from "@rjsf/utils";
+import { cleanUpHandleId, getHandleId, updateUiOption } from "../../helpers";
+import { useEdgeStore } from "@/app/(platform)/build/stores/edgeStore";
+
+export default function ArrayFieldTemplate(props: ArrayFieldTemplateProps) {
+  const {
+    canAdd,
+    disabled,
+    fieldPathId,
+    uiSchema,
+    items,
+    optionalDataControl,
+    onAddClick,
+    readonly,
+    registry,
+    required,
+    schema,
+    title,
+  } = props;
+
+  const uiOptions = getUiOptions(uiSchema);
+  const { isInputConnected } = useEdgeStore();
+
+  const ArrayFieldDescriptionTemplate = getTemplate(
+    "ArrayFieldDescriptionTemplate",
+    registry,
+    uiOptions,
+  );
+  const ArrayFieldTitleTemplate = getTemplate(
+    "ArrayFieldTitleTemplate",
+    registry,
+    uiOptions,
+  );
+  const showOptionalDataControlInTitle = !readonly && !disabled;
+
+  const {
+    ButtonTemplates: { AddButton },
+  } = registry.templates;
+
+  const { fromAnyOf } = uiOptions;
+
+  const handleId = getHandleId({
+    uiOptions,
+    id: fieldPathId.$id,
+    schema: schema,
+  });
+  const updatedUiSchema = updateUiOption(uiSchema, {
+    handleId: handleId,
+  });
+
+  const shouldShowChildren = !isInputConnected(
+    registry.formContext.nodeId,
+    cleanUpHandleId(handleId),
+  );
+
+  return (
+    <div>
+      <div className="m-0 flex p-0">
+        <div className="m-0 w-full space-y-4 p-0">
+          {!fromAnyOf && (
+            <div className="flex items-center gap-2">
+              <ArrayFieldTitleTemplate
+                fieldPathId={fieldPathId}
+                title={uiOptions.title || title}
+                schema={schema}
+                uiSchema={updatedUiSchema}
+                required={required}
+                registry={registry}
+                optionalDataControl={
+                  showOptionalDataControlInTitle
+                    ? optionalDataControl
+                    : undefined
+                }
+              />
+              <ArrayFieldDescriptionTemplate
+                fieldPathId={fieldPathId}
+                description={uiOptions.description || schema.description}
+                schema={schema}
+                uiSchema={updatedUiSchema}
+                registry={registry}
+              />
+            </div>
+          )}
+          {shouldShowChildren && (
+            <div
+              key={`array-item-list-${fieldPathId.$id}`}
+              className="m-0 mb-2 w-full p-0"
+            >
+              {!showOptionalDataControlInTitle
+                ? optionalDataControl
+                : undefined}
+              {items}
+              {canAdd && (
+                <div className="mt-4 flex justify-end">
+                  <AddButton
+                    id={buttonId(fieldPathId, "add")}
+                    className="rjsf-array-item-add"
+                    onClick={onAddClick}
+                    disabled={disabled || readonly}
+                    uiSchema={updatedUiSchema}
+                    registry={registry}
+                  />
+                </div>
+              )}
+            </div>
+          )}
+        </div>
+      </div>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/array/ArraySchemaField.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/array/ArraySchemaField.tsx
new file mode 100644
index 0000000000..b926b71f9a
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/array/ArraySchemaField.tsx
@@ -0,0 +1,29 @@
+import { FieldProps, getUiOptions } from "@rjsf/utils";
+import { getHandleId, updateUiOption } from "../../helpers";
+import { ARRAY_ITEM_FLAG } from "../../constants";
+
+const ArraySchemaField = (props: FieldProps) => {
+  const { index, registry, fieldPathId } = props;
+  const { SchemaField } = registry.fields;
+
+  const uiOptions = getUiOptions(props.uiSchema);
+
+  const handleId = getHandleId({
+    uiOptions,
+    id: fieldPathId.$id,
+    schema: props.schema,
+  });
+  const updatedUiSchema = updateUiOption(props.uiSchema, {
+    handleId: handleId + ARRAY_ITEM_FLAG,
+  });
+
+  return (
+    <SchemaField
+      {...props}
+      uiSchema={updatedUiSchema}
+      title={"_item-" + index.toString()}
+    />
+  );
+};
+
+export default ArraySchemaField;
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/array/context/array-item-context.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/array/context/array-item-context.tsx
new file mode 100644
index 0000000000..d4da5b9ea4
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/array/context/array-item-context.tsx
@@ -0,0 +1,33 @@
+import React, { createContext, useContext } from "react";
+
+interface ArrayItemContextValue {
+  isArrayItem: boolean;
+  arrayItemHandleId: string;
+}
+
+const ArrayItemContext = createContext<ArrayItemContextValue>({
+  isArrayItem: false,
+  arrayItemHandleId: "",
+});
+
+export const ArrayItemProvider: React.FC<{
+  children: React.ReactNode;
+  arrayItemHandleId: string;
+}> = ({ children, arrayItemHandleId }) => {
+  return (
+    <ArrayItemContext.Provider value={{ isArrayItem: true, arrayItemHandleId }}>
+      {children}
+    </ArrayItemContext.Provider>
+  );
+};
+
+export const useIsArrayItem = (): boolean => {
+  // here this will be true if field is inside an array
+  const context = useContext(ArrayItemContext);
+  return context.isArrayItem;
+};
+
+export const useArrayItemHandleId = (): string => {
+  const context = useContext(ArrayItemContext);
+  return context.arrayItemHandleId;
+};
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/array/helpers.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/array/helpers.ts
new file mode 100644
index 0000000000..96e74e1381
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/array/helpers.ts
@@ -0,0 +1,3 @@
+export const generateArrayItemHandleId = (id: string) => {
+  return `array-item-${id}`;
+};
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/array/index.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/array/index.ts
new file mode 100644
index 0000000000..eb496d3d6d
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/array/index.ts
@@ -0,0 +1,7 @@
+export { default as ArrayFieldTemplate } from "./ArrayFieldTemplate";
+export { default as ArrayFieldItemTemplate } from "./ArrayFieldItemTemplate";
+export { default as ArraySchemaField } from "./ArraySchemaField";
+export {
+  ArrayItemProvider,
+  useIsArrayItem,
+} from "./context/array-item-context";
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/base-registry.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/base-registry.ts
new file mode 100644
index 0000000000..253e13cbea
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/base-registry.ts
@@ -0,0 +1,71 @@
+import {
+  RegistryFieldsType,
+  RegistryWidgetsType,
+  TemplatesType,
+} from "@rjsf/utils";
+import { AnyOfField } from "./anyof/AnyOfField";
+import {
+  ArrayFieldItemTemplate,
+  ArrayFieldTemplate,
+  ArraySchemaField,
+} from "./array";
+import {
+  ObjectFieldTemplate,
+  OptionalDataControlsTemplate,
+  WrapIfAdditionalTemplate,
+} from "./object";
+import { DescriptionField, FieldTemplate, TitleField } from "./standard";
+import { AddButton, CopyButton, RemoveButton } from "./standard/buttons";
+import {
+  CheckboxWidget,
+  DateTimeWidget,
+  DateWidget,
+  FileWidget,
+  GoogleDrivePickerWidget,
+  SelectWidget,
+  TextWidget,
+  TimeWidget,
+} from "./standard/widgets";
+
+const NoButton = () => null;
+
+export function generateBaseFields(): RegistryFieldsType {
+  return {
+    AnyOfField,
+    ArraySchemaField,
+  };
+}
+
+export function generateBaseTemplates(): Partial<TemplatesType> {
+  return {
+    ArrayFieldItemTemplate,
+    ArrayFieldTemplate,
+    ButtonTemplates: {
+      AddButton,
+      CopyButton,
+      MoveDownButton: NoButton,
+      MoveUpButton: NoButton,
+      RemoveButton,
+      SubmitButton: NoButton,
+    },
+    DescriptionFieldTemplate: DescriptionField,
+    FieldTemplate,
+    ObjectFieldTemplate,
+    OptionalDataControlsTemplate,
+    TitleFieldTemplate: TitleField,
+    WrapIfAdditionalTemplate,
+  };
+}
+
+export function generateBaseWidgets(): RegistryWidgetsType {
+  return {
+    TextWidget,
+    SelectWidget,
+    CheckboxWidget,
+    FileWidget,
+    DateWidget,
+    TimeWidget,
+    DateTimeWidget,
+    GoogleDrivePickerWidget,
+  };
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/index.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/index.ts
new file mode 100644
index 0000000000..cfd0a86fa4
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/index.ts
@@ -0,0 +1,5 @@
+export * from "./array";
+export * from "./object";
+export * from "./standard";
+export * from "./standard/widgets";
+export * from "./standard/buttons";
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/object/ObjectFieldTemplate.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/object/ObjectFieldTemplate.tsx
new file mode 100644
index 0000000000..ca105d04f4
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/object/ObjectFieldTemplate.tsx
@@ -0,0 +1,132 @@
+import {
+  ADDITIONAL_PROPERTY_FLAG,
+  buttonId,
+  canExpand,
+  descriptionId,
+  getTemplate,
+  getUiOptions,
+  ObjectFieldTemplateProps,
+  titleId,
+} from "@rjsf/utils";
+import { cleanUpHandleId, getHandleId, updateUiOption } from "../../helpers";
+import React from "react";
+import { useEdgeStore } from "@/app/(platform)/build/stores/edgeStore";
+
+export default function ObjectFieldTemplate(props: ObjectFieldTemplateProps) {
+  const {
+    description,
+    title,
+    properties,
+    required,
+    uiSchema,
+    fieldPathId,
+    schema,
+    formData,
+    optionalDataControl,
+    onAddProperty,
+    disabled,
+    readonly,
+    registry,
+  } = props;
+  const uiOptions = getUiOptions(uiSchema);
+
+  const { isInputConnected } = useEdgeStore();
+
+  const TitleFieldTemplate = getTemplate(
+    "TitleFieldTemplate",
+    registry,
+    uiOptions,
+  );
+
+  const DescriptionFieldTemplate = getTemplate(
+    "DescriptionFieldTemplate",
+    registry,
+    uiOptions,
+  );
+  const showOptionalDataControlInTitle = !readonly && !disabled;
+
+  const {
+    ButtonTemplates: { AddButton },
+  } = registry.templates;
+
+  const additional = ADDITIONAL_PROPERTY_FLAG in schema;
+
+  const handleId = getHandleId({
+    uiOptions,
+    id: fieldPathId.$id,
+    schema,
+  });
+
+  const updatedUiSchema = updateUiOption(uiSchema, {
+    handleId: handleId,
+  });
+
+  const shouldShowChildren = !isInputConnected(
+    registry.formContext.nodeId,
+    cleanUpHandleId(handleId),
+  );
+
+  return (
+    <>
+      <div className="flex items-center gap-2">
+        {title && !additional && (
+          <TitleFieldTemplate
+            id={titleId(fieldPathId)}
+            title={title}
+            required={required}
+            schema={schema}
+            uiSchema={updatedUiSchema}
+            registry={registry}
+            optionalDataControl={true ? optionalDataControl : undefined}
+          />
+        )}
+        {description && (
+          <DescriptionFieldTemplate
+            id={descriptionId(fieldPathId)}
+            description={description}
+            schema={schema}
+            uiSchema={updatedUiSchema}
+            registry={registry}
+          />
+        )}
+      </div>
+
+      {shouldShowChildren && (
+        <div className="flex flex-col">
+          {!showOptionalDataControlInTitle ? optionalDataControl : undefined}
+
+          {/* I have cloned it - so i could pass updated uiSchema to the nested children */}
+          {properties.map((element: any, index: number) => {
+            const clonedContent = React.cloneElement(element.content, {
+              ...element.content.props,
+              uiSchema: updateUiOption(element.content.props.uiSchema, {
+                handleId: handleId,
+              }),
+            });
+
+            return (
+              <div
+                key={index}
+                className={`${element.hidden ? "hidden" : ""} flex`}
+              >
+                <div className="w-full">{clonedContent}</div>
+              </div>
+            );
+          })}
+          {canExpand(schema, uiSchema, formData) ? (
+            <div className="mt-2 flex justify-end">
+              <AddButton
+                id={buttonId(fieldPathId, "add")}
+                onClick={onAddProperty}
+                disabled={disabled || readonly}
+                className="rjsf-object-property-expand"
+                uiSchema={updatedUiSchema}
+                registry={registry}
+              />
+            </div>
+          ) : null}
+        </div>
+      )}
+    </>
+  );
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/object/OptionalDataControlsTemplate.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/object/OptionalDataControlsTemplate.tsx
new file mode 100644
index 0000000000..dc53c6ce5b
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/object/OptionalDataControlsTemplate.tsx
@@ -0,0 +1,35 @@
+import { OptionalDataControlsTemplateProps } from "@rjsf/utils";
+import { PlusCircle } from "lucide-react";
+
+import { IconButton, RemoveButton } from "../standard/buttons";
+
+export default function OptionalDataControlsTemplate(
+  props: OptionalDataControlsTemplateProps,
+) {
+  const { id, registry, label, onAddClick, onRemoveClick } = props;
+  if (onAddClick) {
+    return (
+      <IconButton
+        id={id}
+        registry={registry}
+        className="rjsf-add-optional-data"
+        onClick={onAddClick}
+        title={label}
+        icon={<PlusCircle />}
+        size="small"
+      />
+    );
+  } else if (onRemoveClick) {
+    return (
+      <RemoveButton
+        id={id}
+        registry={registry}
+        className="rjsf-remove-optional-data"
+        onClick={onRemoveClick}
+        title={label}
+        size="small"
+      />
+    );
+  }
+  return <em id={id}>{label}</em>;
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/object/WrapIfAdditionalTemplate.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/object/WrapIfAdditionalTemplate.tsx
new file mode 100644
index 0000000000..97478e9eaf
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/object/WrapIfAdditionalTemplate.tsx
@@ -0,0 +1,114 @@
+import {
+  ADDITIONAL_PROPERTY_FLAG,
+  buttonId,
+  getTemplate,
+  getUiOptions,
+  titleId,
+  WrapIfAdditionalTemplateProps,
+} from "@rjsf/utils";
+
+import { Input } from "@/components/atoms/Input/Input";
+import { useEdgeStore } from "@/app/(platform)/build/stores/edgeStore";
+
+export default function WrapIfAdditionalTemplate(
+  props: WrapIfAdditionalTemplateProps,
+) {
+  const {
+    classNames,
+    style,
+    children,
+    disabled,
+    id,
+    label,
+    onRemoveProperty,
+    onKeyRenameBlur,
+    readonly,
+    required,
+    schema,
+    uiSchema,
+    registry,
+  } = props;
+  const { templates, formContext } = registry;
+  const uiOptions = getUiOptions(uiSchema);
+  // Button templates are not overridden in the uiSchema
+  const { RemoveButton } = templates.ButtonTemplates;
+  const { isInputConnected } = useEdgeStore();
+
+  const additional = ADDITIONAL_PROPERTY_FLAG in schema;
+  const { nodeId } = formContext;
+  const handleId = uiOptions.handleId;
+
+  const TitleFieldTemplate = getTemplate(
+    "TitleFieldTemplate",
+    registry,
+    uiOptions,
+  );
+
+  if (!additional) {
+    return (
+      <div className={classNames} style={style}>
+        {children}
+      </div>
+    );
+  }
+
+  const keyId = `${id}-key`;
+  const generateObjectPropertyTitleId = (id: string, label: string) => {
+    return id.replace(`_${label}`, `_#_${label}`);
+  };
+  const title_id = generateObjectPropertyTitleId(id, label);
+
+  const handleBlur = (e: React.FocusEvent<HTMLInputElement>) => {
+    if (e.target.value == "") {
+      onRemoveProperty();
+    } else {
+      onKeyRenameBlur(e);
+    }
+  };
+
+  const isHandleConnected = isInputConnected(nodeId, handleId);
+
+  return (
+    <>
+      <div className={`mb-4 flex flex-col gap-1`} style={style}>
+        <TitleFieldTemplate
+          id={titleId(title_id)}
+          title={`#${label}`}
+          required={required}
+          schema={schema}
+          registry={registry}
+          uiSchema={uiSchema}
+        />
+        {!isHandleConnected && (
+          <div className="flex flex-1 items-center gap-2">
+            <Input
+              label={""}
+              hideLabel={true}
+              required={required}
+              defaultValue={label}
+              disabled={disabled || readonly}
+              id={keyId}
+              wrapperClassName="mb-2 w-30"
+              name={keyId}
+              onBlur={!readonly ? handleBlur : undefined}
+              type="text"
+              size="small"
+            />
+            <div className="mt-2"> {children}</div>
+          </div>
+        )}
+        {!isHandleConnected && (
+          <div className="-mt-4">
+            <RemoveButton
+              id={buttonId(id, "remove")}
+              disabled={disabled || readonly}
+              onClick={onRemoveProperty}
+              uiSchema={uiSchema}
+              registry={registry}
+            />
+          </div>
+        )}
+      </div>
+    </>
+  );
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/object/index.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/object/index.ts
new file mode 100644
index 0000000000..84bf8baa16
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/object/index.ts
@@ -0,0 +1,3 @@
+export { default as ObjectFieldTemplate } from "./ObjectFieldTemplate";
+export { default as WrapIfAdditionalTemplate } from "./WrapIfAdditionalTemplate";
+export { default as OptionalDataControlsTemplate } from "./OptionalDataControlsTemplate";
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/DescriptionField.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/DescriptionField.tsx
new file mode 100644
index 0000000000..65b5e4be43
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/DescriptionField.tsx
@@ -0,0 +1,32 @@
+import { DescriptionFieldProps } from "@rjsf/utils";
+import { RichDescription } from "@rjsf/core";
+import { InfoIcon } from "@phosphor-icons/react";
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipTrigger,
+} from "@/components/atoms/Tooltip/BaseTooltip";
+
+export default function DescriptionField(props: DescriptionFieldProps) {
+  const { id, description, registry, uiSchema } = props;
+  if (!description) {
+    return null;
+  }
+
+  return (
+    <div id={id} className="0 inline w-fit">
+      <Tooltip>
+        <TooltipTrigger asChild>
+          <InfoIcon size={16} className="cursor-pointer" />
+        </TooltipTrigger>
+        <TooltipContent>
+          <RichDescription
+            description={description}
+            registry={registry}
+            uiSchema={uiSchema}
+          />
+        </TooltipContent>
+      </Tooltip>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/FieldError.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/FieldError.tsx
new file mode 100644
index 0000000000..e25a9bc80f
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/FieldError.tsx
@@ -0,0 +1,27 @@
+import { useNodeStore } from "@/app/(platform)/build/stores/nodeStore";
+import { Text } from "@/components/atoms/Text/Text";
+
+export const FieldError = ({
+  nodeId,
+  fieldId,
+}: {
+  nodeId: string;
+  fieldId: string;
+}) => {
+  const nodeErrors = useNodeStore((state) => {
+    const node = state.nodes.find((n) => n.id === nodeId);
+    return node?.data?.errors;
+  });
+  const fieldError =
+    nodeErrors?.[fieldId] || nodeErrors?.[fieldId.replace(/_%_/g, ".")] || null;
+
+  return (
+    <div>
+      {fieldError && (
+        <Text variant="small" className="mt-1 pl-4 !text-red-600">
+          {fieldError}
+        </Text>
+      )}
+    </div>
+  );
+};
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/FieldTemplate.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/FieldTemplate.tsx
new file mode 100644
index 0000000000..705afbcaaa
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/FieldTemplate.tsx
@@ -0,0 +1,141 @@
+import {
+  ADDITIONAL_PROPERTY_FLAG,
+  FieldTemplateProps,
+  getTemplate,
+  getUiOptions,
+  titleId,
+} from "@rjsf/utils";
+
+import { isAnyOfChild, isAnyOfSchema } from "../../utils/schema-utils";
+import {
+  cleanUpHandleId,
+  getHandleId,
+  isPartOfAnyOf,
+  updateUiOption,
+} from "../../helpers";
+
+import { useNodeStore } from "@/app/(platform)/build/stores/nodeStore";
+import { useEdgeStore } from "@/app/(platform)/build/stores/edgeStore";
+import { FieldError } from "./FieldError";
+import { BlockUIType } from "@/app/(platform)/build/components/types";
+
+export default function FieldTemplate(props: FieldTemplateProps) {
+  const {
+    id,
+    children,
+    displayLabel,
+    description,
+    rawDescription,
+    label,
+    hidden,
+    required,
+    schema,
+    uiSchema,
+    registry,
+    classNames,
+    style,
+    disabled,
+    onKeyRename,
+    onKeyRenameBlur,
+    onRemoveProperty,
+    readonly,
+  } = props;
+  const { nodeId, uiType } = registry.formContext;
+
+  const { isInputConnected } = useEdgeStore();
+  const showAdvanced = useNodeStore(
+    (state) => state.nodeAdvancedStates[registry.formContext.nodeId ?? ""],
+  );
+
+  if (hidden) {
+    return <div className="hidden">{children}</div>;
+  }
+
+  if (uiType === BlockUIType.NOTE) {
+    return children;
+  }
+
+  const uiOptions = getUiOptions(uiSchema);
+  const TitleFieldTemplate = getTemplate(
+    "TitleFieldTemplate",
+    registry,
+    uiOptions,
+  );
+  const WrapIfAdditionalTemplate = getTemplate(
+    "WrapIfAdditionalTemplate",
+    registry,
+    uiOptions,
+  );
+
+  const additional = ADDITIONAL_PROPERTY_FLAG in schema;
+
+  const handleId = getHandleId({
+    uiOptions,
+    id: id,
+    schema: schema,
+  });
+  const updatedUiSchema = updateUiOption(uiSchema, {
+    handleId: handleId,
+  });
+  const isHandleConnected = isInputConnected(nodeId, cleanUpHandleId(handleId));
+
+  const shouldDisplayLabel =
+    displayLabel ||
+    (schema.type === "boolean" && !isAnyOfChild(uiSchema as any));
+  const shouldShowTitleSection = !isAnyOfSchema(schema) && !additional;
+
+  const shouldShowChildren =
+    schema.type === "object" ||
+    schema.type === "array" ||
+    isAnyOfSchema(schema) ||
+    !isHandleConnected;
+
+  const isAdvancedField = (schema as any).advanced === true;
+  if (!showAdvanced && isAdvancedField && !isHandleConnected) {
+    return null;
+  }
+
+  const marginBottom =
+    isPartOfAnyOf({ uiOptions }) || isAnyOfSchema(schema) ? 0 : 16;
+
+  return (
+    <WrapIfAdditionalTemplate
+      classNames={classNames}
+      style={style}
+      disabled={disabled}
+      id={id}
+      label={label}
+      displayLabel={displayLabel}
+      onKeyRename={onKeyRename}
+      onKeyRenameBlur={onKeyRenameBlur}
+      onRemoveProperty={onRemoveProperty}
+      rawDescription={rawDescription}
+      readonly={readonly}
+      required={required}
+      schema={schema}
+      uiSchema={updatedUiSchema}
+      registry={registry}
+    >
+      <div className="flex flex-col gap-2" style={{ marginBottom }}>
+        {shouldShowTitleSection && (
+          <div className="flex items-center gap-2">
+            {shouldDisplayLabel && (
+              <TitleFieldTemplate
+                id={titleId(id)}
+                title={label}
+                required={required}
+                schema={schema}
+                uiSchema={updatedUiSchema}
+                registry={registry}
+              />
+            )}
+            {shouldDisplayLabel && rawDescription && <span>{description}</span>}
+          </div>
+        )}
+        {shouldShowChildren && children}
+
+        <FieldError nodeId={nodeId} fieldId={cleanUpHandleId(id)} />
+      </div>
+    </WrapIfAdditionalTemplate>
+  );
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/TitleField.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/TitleField.tsx
new file mode 100644
index 0000000000..f657003463
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/TitleField.tsx
@@ -0,0 +1,67 @@
+import {
+  ADDITIONAL_PROPERTY_FLAG,
+  descriptionId,
+  getUiOptions,
+  TitleFieldProps,
+} from "@rjsf/utils";
+
+import { Text } from "@/components/atoms/Text/Text";
+import { getTypeDisplayInfo } from "@/app/(platform)/build/components/FlowEditor/nodes/helpers";
+import { isAnyOfSchema } from "../../utils/schema-utils";
+import { cn } from "@/lib/utils";
+import { cleanUpHandleId, isArrayItem } from "../../helpers";
+import { InputNodeHandle } from "@/app/(platform)/build/components/FlowEditor/handlers/NodeHandle";
+import { useNodeStore } from "@/app/(platform)/build/stores/nodeStore";
+
+export default function TitleField(props: TitleFieldProps) {
+  const { id, title, required, schema, registry, uiSchema } = props;
+  const { nodeId, showHandles } = registry.formContext;
+  const uiOptions = getUiOptions(uiSchema);
+
+  const isAnyOf = isAnyOfSchema(schema);
+  const { displayType, colorClass } = getTypeDisplayInfo(schema);
+  const description_id = descriptionId(id);
+
+  const additional = ADDITIONAL_PROPERTY_FLAG in schema;
+  const isArrayItemFlag = isArrayItem({ uiOptions });
+  const smallText = isArrayItemFlag || additional;
+
+  const showHandle = uiOptions.showHandles ?? showHandles;
+
+  const fieldPath = id.replace(/^agpt_%_/, "");
+  const tutorialId = nodeId ? `label-${nodeId}-${fieldPath}` : undefined;
+  const isInputBroken = useNodeStore((state) =>
+    state.isInputBroken(nodeId, cleanUpHandleId(uiOptions.handleId)),
+  );
+
+  return (
+    <div className="flex items-center" data-tutorial-id={tutorialId}>
+      {showHandle !== false && (
+        <InputNodeHandle handleId={uiOptions.handleId} nodeId={nodeId} />
+      )}
+      <Text
+        variant={isArrayItemFlag ? "small" : "body"}
+        id={id}
+        className={cn(
+          "line-clamp-1",
+          smallText && "text-sm text-zinc-700",
+          isInputBroken && "text-red-500 line-through",
+        )}
+      >
+        {title}
+      </Text>
+      <Text variant="small" className={"mr-1 text-red-500"}>
+        {required ? "*" : null}
+      </Text>
+      {!isAnyOf && (
+        <Text
+          variant="small"
+          className={cn("ml-2", isInputBroken && "line-through", colorClass)}
+          id={description_id}
+        >
+          ({displayType})
+        </Text>
+      )}
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/buttons/AddButton.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/buttons/AddButton.tsx
new file mode 100644
index 0000000000..901716f56a
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/buttons/AddButton.tsx
@@ -0,0 +1,27 @@
+import { IconButtonProps, TranslatableString } from "@rjsf/utils";
+import { cn } from "@/lib/utils";
+import { Button } from "@/components/atoms/Button/Button";
+import { PlusIcon } from "@phosphor-icons/react";
+
+export default function AddButton({
+  registry,
+  className,
+  uiSchema: _uiSchema,
+  ...props
+}: IconButtonProps) {
+  const { translateString } = registry;
+  return (
+    <div className="m-0 w-full p-0">
+      <Button
+        {...props}
+        size="small"
+        className={cn("w-full gap-4", className)}
+        variant="secondary"
+        type="button"
+      >
+        <PlusIcon size={16} weight="bold" />
+        {translateString(TranslatableString.AddItemButton)}
+      </Button>
+    </div>
+  );
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/buttons/IconButton.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/buttons/IconButton.tsx
new file mode 100644
index 0000000000..4a7f011b82
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/buttons/IconButton.tsx
@@ -0,0 +1,101 @@
+import {
+  FormContextType,
+  IconButtonProps,
+  RJSFSchema,
+  StrictRJSFSchema,
+  TranslatableString,
+} from "@rjsf/utils";
+import { ChevronDown, ChevronUp, Copy } from "lucide-react";
+import type { VariantProps } from "class-variance-authority";
+
+import { Button } from "@/components/atoms/Button/Button";
+import { extendedButtonVariants } from "@/components/atoms/Button/helpers";
+import { TrashIcon } from "@phosphor-icons/react";
+import { cn } from "@/lib/utils";
+import { Text } from "@/components/atoms/Text/Text";
+
+export type AutogptIconButtonProps<
+  T = any,
+  S extends StrictRJSFSchema = RJSFSchema,
+  F extends FormContextType = any,
+> = IconButtonProps<T, S, F> & VariantProps<typeof extendedButtonVariants>;
+
+export default function IconButton(props: AutogptIconButtonProps) {
+  const {
+    icon,
+    className,
+    uiSchema: _uiSchema,
+    registry: _registry,
+    iconType: _iconType,
+    ...otherProps
+  } = props;
+
+  return (
+    <Button
+      size="icon"
+      variant="secondary"
+      className={cn(className, "w-fit border border-zinc-200 p-1.5 px-4")}
+      {...otherProps}
+      type="button"
+    >
+      {icon}
+      <Text variant="body" className="ml-2">
+        {" "}
+        Remove Item{" "}
+      </Text>
+    </Button>
+  );
+}
+
+export function CopyButton(props: AutogptIconButtonProps) {
+  const {
+    registry: { translateString },
+  } = props;
+  return (
+    <IconButton
+      title={translateString(TranslatableString.CopyButton)}
+      {...props}
+      icon={<Copy className="h-4 w-4" />}
+    />
+  );
+}
+
+export function MoveDownButton(props: AutogptIconButtonProps) {
+  const {
+    registry: { translateString },
+  } = props;
+  return (
+    <IconButton
+      title={translateString(TranslatableString.MoveDownButton)}
+      {...props}
+      icon={<ChevronDown className="h-4 w-4" />}
+    />
+  );
+}
+
+export function MoveUpButton(props: AutogptIconButtonProps) {
+  const {
+    registry: { translateString },
+  } = props;
+  return (
+    <IconButton
+      title={translateString(TranslatableString.MoveUpButton)}
+      {...props}
+      icon={<ChevronUp className="h-4 w-4" />}
+    />
+  );
+}
+
+export function RemoveButton(props: AutogptIconButtonProps) {
+  const {
+    registry: { translateString },
+  } = props;
+  return (
+    <IconButton
+      title={translateString(TranslatableString.RemoveButton)}
+      {...props}
+      className={"border-destructive"}
+      icon={<TrashIcon size={16} className="!text-zinc-800" />}
+    />
+  );
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/buttons/index.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/buttons/index.ts
new file mode 100644
index 0000000000..f083306249
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/buttons/index.ts
@@ -0,0 +1,8 @@
+export { default as AddButton } from "./AddButton";
+export {
+  default as IconButton,
+  CopyButton,
+  RemoveButton,
+  MoveUpButton,
+  MoveDownButton,
+} from "./IconButton";
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/errors/ErrorList.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/errors/ErrorList.tsx
new file mode 100644
index 0000000000..39175ef13e
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/errors/ErrorList.tsx
@@ -0,0 +1,24 @@
+import { ErrorListProps, TranslatableString } from "@rjsf/utils";
+import { AlertCircle } from "lucide-react";
+
+import {
+  Alert,
+  AlertDescription,
+  AlertTitle,
+} from "@/components/molecules/Alert/Alert";
+
+export default function ErrorList(props: ErrorListProps) {
+  const { errors, registry } = props;
+  const { translateString } = registry;
+  return (
+    <Alert variant="error" className="mb-2">
+      <AlertCircle className="h-4 w-4" />
+      <AlertTitle>{translateString(TranslatableString.ErrorsLabel)}</AlertTitle>
+      <AlertDescription className="flex flex-col gap-1">
+        {errors.map((error, i: number) => {
+          return <span key={i}>&#x2022; {error.stack}</span>;
+        })}
+      </AlertDescription>
+    </Alert>
+  );
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/errors/index.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/errors/index.ts
new file mode 100644
index 0000000000..ccecd3c8c6
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/errors/index.ts
@@ -0,0 +1 @@
+export { default as ErrorList } from "./ErrorList";
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/helpers.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/helpers.ts
new file mode 100644
index 0000000000..327a0e06b6
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/helpers.ts
@@ -0,0 +1,76 @@
+import { RJSFSchema } from "@rjsf/utils";
+
+export function parseFieldPath(
+  rootSchema: RJSFSchema,
+  id: string,
+  additional: boolean,
+  idSeparator: string = "_%_",
+): { path: string[]; typeHints: string[] } {
+  const segments = id.split(idSeparator).filter(Boolean);
+  const typeHints: string[] = [];
+
+  let currentSchema = rootSchema;
+
+  for (let i = 0; i < segments.length; i++) {
+    const segment = segments[i];
+    const isNumeric = /^\d+$/.test(segment);
+
+    if (isNumeric) {
+      typeHints.push("array");
+    } else {
+      if (additional) {
+        typeHints.push("object-key");
+      } else {
+        typeHints.push("object-property");
+      }
+      currentSchema = (currentSchema.properties?.[segment] as RJSFSchema) || {};
+    }
+  }
+
+  return { path: segments, typeHints };
+}
+
+// This helper work is simple - it just help us to convert rjsf id to our backend compatible id
+// Example : List[dict] = agpt_%_List_0_dict__title -> List_$_0_#_dict
+// We remove the prefix and suffix and then we split id by our custom delimiter (_%_)
+// then add _$_ delimiter for array and _#_ delimiter for object-key
+// and for normal property we add . delimiter
+
+export function getHandleId(
+  rootSchema: RJSFSchema,
+  id: string,
+  additional: boolean,
+  idSeparator: string = "_%_",
+): string {
+  const idPrefix = "agpt_%_";
+  const idSuffix = "__title";
+
+  if (id.startsWith(idPrefix)) {
+    id = id.slice(idPrefix.length);
+  }
+  if (id.endsWith(idSuffix)) {
+    id = id.slice(0, -idSuffix.length);
+  }
+
+  const { path, typeHints } = parseFieldPath(
+    rootSchema,
+    id,
+    additional,
+    idSeparator,
+  );
+
+  return path
+    .map((seg, i) => {
+      const type = typeHints[i];
+      if (type === "array") {
+        return `_$_${seg}`;
+      }
+      if (type === "object-key") {
+        return `_${seg}`; // we haven't added _#_ delimiter for object-key because it's already added in the id - check WrapIfAdditionalTemplate.tsx
+      }
+
+      return `.${seg}`;
+    })
+    .join("")
+    .slice(1);
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/index.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/index.ts
new file mode 100644
index 0000000000..870753151c
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/index.ts
@@ -0,0 +1,3 @@
+export { default as FieldTemplate } from "./FieldTemplate";
+export { default as TitleField } from "./TitleField";
+export { default as DescriptionField } from "./DescriptionField";
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/SwitchWidget.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/CheckboxInput/CheckBoxWidget.tsx
similarity index 87%
rename from autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/SwitchWidget.tsx
rename to autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/CheckboxInput/CheckBoxWidget.tsx
index d15ec18a9a..ff93528492 100644
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/SwitchWidget.tsx
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/CheckboxInput/CheckBoxWidget.tsx
@@ -1,8 +1,9 @@
 import { WidgetProps } from "@rjsf/utils";
 import { Switch } from "@/components/atoms/Switch/Switch";
 
-export function SwitchWidget(props: WidgetProps) {
+export function CheckboxWidget(props: WidgetProps) {
   const { value = false, onChange, disabled, readonly, autofocus, id } = props;
+
   return (
     <Switch
       id={id}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/CheckboxInput/index.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/CheckboxInput/index.ts
new file mode 100644
index 0000000000..d04c6a67b5
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/CheckboxInput/index.ts
@@ -0,0 +1 @@
+export { CheckboxWidget } from "./CheckBoxWidget";
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/DateInputWidget.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/DateInput/DateWidget.tsx
similarity index 88%
rename from autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/DateInputWidget.tsx
rename to autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/DateInput/DateWidget.tsx
index 9e7cc3f058..1a861821e5 100644
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/DateInputWidget.tsx
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/DateInput/DateWidget.tsx
@@ -1,8 +1,7 @@
-import * as React from "react";
 import { WidgetProps } from "@rjsf/utils";
 import { DateInput } from "@/components/atoms/DateInput/DateInput";
 
-export const DateInputWidget = (props: WidgetProps) => {
+export const DateWidget = (props: WidgetProps) => {
   const {
     value,
     onChange,
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/DateInput/index.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/DateInput/index.ts
new file mode 100644
index 0000000000..3ba465c4f4
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/DateInput/index.ts
@@ -0,0 +1 @@
+export { DateWidget } from "./DateWidget";
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/DateTimeInputWidget.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/DateTimeInput/DateTimeWidget.tsx
similarity index 91%
rename from autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/DateTimeInputWidget.tsx
rename to autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/DateTimeInput/DateTimeWidget.tsx
index 2e85a610b5..50f6e378fb 100644
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/DateTimeInputWidget.tsx
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/DateTimeInput/DateTimeWidget.tsx
@@ -1,7 +1,7 @@
 import { WidgetProps } from "@rjsf/utils";
 import { DateTimeInput } from "@/components/atoms/DateTimeInput/DateTimeInput";
 
-export const DateTimeInputWidget = (props: WidgetProps) => {
+export const DateTimeWidget = (props: WidgetProps) => {
   const {
     value,
     onChange,
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/DateTimeInput/index.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/DateTimeInput/index.ts
new file mode 100644
index 0000000000..bf7c084f5a
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/DateTimeInput/index.ts
@@ -0,0 +1 @@
+export { DateTimeWidget } from "./DateTimeWidget";
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/FileWidget.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/FileInput/FileWidget.tsx
similarity index 100%
rename from autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/FileWidget.tsx
rename to autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/FileInput/FileWidget.tsx
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/FileInput/index.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/FileInput/index.ts
new file mode 100644
index 0000000000..e23b50bfd0
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/FileInput/index.ts
@@ -0,0 +1 @@
+export { FileWidget } from "./FileWidget";
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/GoogleDrivePicker/GoogleDrivePicketWidget.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/GoogleDrivePicker/GoogleDrivePicketWidget.tsx
new file mode 100644
index 0000000000..45ed9611cf
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/GoogleDrivePicker/GoogleDrivePicketWidget.tsx
@@ -0,0 +1,55 @@
+import { useNodeStore } from "@/app/(platform)/build/stores/nodeStore";
+import { GoogleDrivePickerInput } from "@/components/contextual/GoogleDrivePicker/GoogleDrivePickerInput";
+import { getFieldErrorKey } from "@/components/renderers/InputRenderer/utils/helpers";
+import type { GoogleDrivePickerConfig } from "@/lib/autogpt-server-api/types";
+import { cn } from "@/lib/utils";
+import { WidgetProps } from "@rjsf/utils";
+
+function hasGoogleDrivePickerConfig(
+  schema: unknown,
+): schema is { google_drive_picker_config?: GoogleDrivePickerConfig } {
+  return (
+    typeof schema === "object" &&
+    schema !== null &&
+    "google_drive_picker_config" in schema
+  );
+}
+
+export function GoogleDrivePickerWidget(props: WidgetProps) {
+  const { onChange, disabled, readonly, value, schema, id, formContext } =
+    props;
+  const { nodeId } = formContext || {};
+
+  const nodeErrors = useNodeStore((state) => {
+    const node = state.nodes.find((n) => n.id === nodeId);
+    return node?.data?.errors;
+  });
+
+  const fieldErrorKey = getFieldErrorKey(id ?? "");
+  const fieldError =
+    nodeErrors?.[fieldErrorKey] ||
+    nodeErrors?.[fieldErrorKey.replace(/_/g, ".")] ||
+    nodeErrors?.[fieldErrorKey.replace(/\./g, "_")] ||
+    undefined;
+
+  const config: GoogleDrivePickerConfig = hasGoogleDrivePickerConfig(schema)
+    ? schema.google_drive_picker_config || {}
+    : {};
+
+  function handleChange(newValue: unknown) {
+    onChange(newValue);
+  }
+
+  return (
+    <GoogleDrivePickerInput
+      config={config}
+      value={value}
+      onChange={handleChange}
+      error={fieldError}
+      className={cn(
+        disabled || readonly ? "pointer-events-none opacity-50" : undefined,
+      )}
+      showRemoveButton={true}
+    />
+  );
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/GoogleDrivePicker/index.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/GoogleDrivePicker/index.ts
new file mode 100644
index 0000000000..c0608ac9fe
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/GoogleDrivePicker/index.ts
@@ -0,0 +1 @@
+export { GoogleDrivePickerWidget } from "./GoogleDrivePicketWidget";
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/SelectWidget.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/SelectInput/SelectWidget.tsx
similarity index 87%
rename from autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/SelectWidget.tsx
rename to autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/SelectInput/SelectWidget.tsx
index db68a1628c..894004db40 100644
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/SelectWidget.tsx
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/SelectInput/SelectWidget.tsx
@@ -14,8 +14,16 @@ import {
 } from "@/components/__legacy__/ui/multiselect";
 
 export const SelectWidget = (props: WidgetProps) => {
-  const { options, value, onChange, disabled, readonly, id, formContext } =
-    props;
+  const {
+    options,
+    value,
+    onChange,
+    disabled,
+    readonly,
+    className,
+    id,
+    formContext,
+  } = props;
   const enumOptions = options.enumOptions || [];
   const type = mapJsonSchemaTypeToInputType(props.schema);
   const { size = "small" } = formContext || {};
@@ -36,7 +44,7 @@ export const SelectWidget = (props: WidgetProps) => {
           </MultiSelectorTrigger>
           <MultiSelectorContent>
             <MultiSelectorList>
-              {enumOptions?.map((option) => (
+              {enumOptions?.map((option: any) => (
                 <MultiSelectorItem key={option.value} value={option.value}>
                   {option.label}
                 </MultiSelectorItem>
@@ -56,12 +64,13 @@ export const SelectWidget = (props: WidgetProps) => {
         value={value ?? ""}
         onValueChange={onChange}
         options={
-          enumOptions?.map((option) => ({
+          enumOptions?.map((option: any) => ({
             value: option.value,
             label: option.label,
           })) || []
         }
         wrapperClassName="!mb-0 "
+        className={className}
       />
     );
   };
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/SelectInput/index.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/SelectInput/index.ts
new file mode 100644
index 0000000000..9a64291abc
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/SelectInput/index.ts
@@ -0,0 +1 @@
+export { SelectWidget } from "./SelectWidget";
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/TextInputWidget/InputExpanderModal.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/TextInput/TextInputExpanderModal.tsx
similarity index 94%
rename from autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/TextInputWidget/InputExpanderModal.tsx
rename to autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/TextInput/TextInputExpanderModal.tsx
index 5b19874bfb..a28b460ea5 100644
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/TextInputWidget/InputExpanderModal.tsx
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/TextInput/TextInputExpanderModal.tsx
@@ -17,6 +17,7 @@ interface InputExpanderModalProps {
   defaultValue: string;
   description?: string;
   placeholder?: string;
+  inputType?: "text" | "json";
 }
 
 export const InputExpanderModal: FC<InputExpanderModalProps> = ({
@@ -27,6 +28,7 @@ export const InputExpanderModal: FC<InputExpanderModalProps> = ({
   defaultValue,
   description,
   placeholder,
+  inputType = "text",
 }) => {
   const [tempValue, setTempValue] = useState(defaultValue);
   const [isCopied, setIsCopied] = useState(false);
@@ -78,7 +80,10 @@ export const InputExpanderModal: FC<InputExpanderModalProps> = ({
             hideLabel
             id="input-expander-modal"
             value={tempValue}
-            className="!min-h-[300px] rounded-2xlarge"
+            className={cn(
+              "!min-h-[300px] rounded-2xlarge",
+              inputType === "json" && "font-mono text-sm",
+            )}
             onChange={(e) => setTempValue(e.target.value)}
             placeholder={placeholder || "Enter text..."}
             autoFocus
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/TextInputWidget/TextInputWidget.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/TextInput/TextWidget.tsx
similarity index 91%
rename from autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/TextInputWidget/TextInputWidget.tsx
rename to autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/TextInput/TextWidget.tsx
index d9fea28a8d..33a55581c7 100644
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/TextInputWidget/TextInputWidget.tsx
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/TextInput/TextWidget.tsx
@@ -14,15 +14,12 @@ import {
   TooltipTrigger,
 } from "@/components/atoms/Tooltip/BaseTooltip";
 import { BlockUIType } from "@/lib/autogpt-server-api/types";
-import { InputExpanderModal } from "./InputExpanderModal";
 import { ArrowsOutIcon } from "@phosphor-icons/react";
+import { InputExpanderModal } from "./TextInputExpanderModal";
 
-export const TextInputWidget = (props: WidgetProps) => {
-  const { schema, formContext } = props;
-  const { uiType, size = "small" } = formContext as {
-    uiType: BlockUIType;
-    size?: string;
-  };
+export default function TextWidget(props: WidgetProps) {
+  const { schema, placeholder, registry } = props;
+  const { size, uiType } = registry.formContext;
 
   const [isModalOpen, setIsModalOpen] = useState(false);
 
@@ -122,7 +119,7 @@ export const TextInputWidget = (props: WidgetProps) => {
           wrapperClassName="mb-0 flex-1"
           value={props.value ?? ""}
           onChange={handleChange}
-          placeholder={schema.placeholder || config.placeholder}
+          placeholder={placeholder || config.placeholder}
           required={props.required}
           disabled={props.disabled}
           className={showExpandButton ? "pr-8" : ""}
@@ -152,8 +149,8 @@ export const TextInputWidget = (props: WidgetProps) => {
         title={schema.title || "Edit value"}
         description={schema.description || ""}
         defaultValue={props.value ?? ""}
-        placeholder={schema.placeholder || config.placeholder}
+        placeholder={placeholder || config.placeholder}
       />
     </>
   );
-};
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/TextInput/index.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/TextInput/index.ts
new file mode 100644
index 0000000000..102db07ade
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/TextInput/index.ts
@@ -0,0 +1,2 @@
+export { default } from "./TextWidget";
+export { InputExpanderModal } from "./TextInputExpanderModal";
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/TimeInputWidget.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/TimeInput/TimeWidget.tsx
similarity index 91%
rename from autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/TimeInputWidget.tsx
rename to autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/TimeInput/TimeWidget.tsx
index 032c33e62c..152aae7298 100644
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/TimeInputWidget.tsx
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/TimeInput/TimeWidget.tsx
@@ -1,7 +1,7 @@
 import { WidgetProps } from "@rjsf/utils";
 import { TimeInput } from "@/components/atoms/TimeInput/TimeInput";
 
-export const TimeInputWidget = (props: WidgetProps) => {
+export const TimeWidget = (props: WidgetProps) => {
   const { value, onChange, disabled, readonly, placeholder, id, formContext } =
     props;
   const { size = "small" } = formContext || {};
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/TimeInput/index.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/TimeInput/index.ts
new file mode 100644
index 0000000000..488e184c08
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/TimeInput/index.ts
@@ -0,0 +1 @@
+export { TimeWidget } from "./TimeWidget";
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/index.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/index.ts
new file mode 100644
index 0000000000..f68117fa83
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/base/standard/widgets/index.ts
@@ -0,0 +1,8 @@
+export { CheckboxWidget } from "./CheckboxInput";
+export { DateWidget } from "./DateInput";
+export { DateTimeWidget } from "./DateTimeInput";
+export { FileWidget } from "./FileInput";
+export { GoogleDrivePickerWidget } from "./GoogleDrivePicker";
+export { SelectWidget } from "./SelectInput";
+export { default as TextWidget } from "./TextInput";
+export { TimeWidget } from "./TimeInput";
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/constants.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/constants.ts
new file mode 100644
index 0000000000..144d850a00
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/constants.ts
@@ -0,0 +1,8 @@
+export const ANY_OF_FLAG = "__anyOf";
+export const ARRAY_FLAG = "__array";
+export const OBJECT_FLAG = "__object";
+export const KEY_PAIR_FLAG = "__keyPair";
+export const TITLE_FLAG = "__title";
+export const ARRAY_ITEM_FLAG = "__arrayItem";
+export const ID_PREFIX = "agpt_@_";
+export const ID_PREFIX_ARRAY = "agpt_%_";
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/CredentialField/CredentialField.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/CredentialField/CredentialField.tsx
new file mode 100644
index 0000000000..7e34673125
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/CredentialField/CredentialField.tsx
@@ -0,0 +1,117 @@
+import { useNodeStore } from "@/app/(platform)/build/stores/nodeStore";
+import { Switch } from "@/components/atoms/Switch/Switch";
+import { CredentialsInput } from "@/components/contextual/CredentialsInput/CredentialsInput";
+import {
+  BlockIOCredentialsSubSchema,
+  CredentialsMetaInput,
+} from "@/lib/autogpt-server-api";
+import { FieldProps, getUiOptions } from "@rjsf/utils";
+import { useMemo } from "react";
+import { useShallow } from "zustand/react/shallow";
+import { CredentialFieldTitle } from "./components/CredentialFieldTitle";
+
+export const CredentialsField = (props: FieldProps) => {
+  const { formData, onChange, schema, registry, fieldPathId, required } = props;
+
+  const formContext = registry.formContext;
+  const uiOptions = getUiOptions(props.uiSchema);
+  const nodeId = formContext?.nodeId;
+
+  // Get sibling inputs (hardcoded values) and credentials optional state from the node store
+  // Note: We select the node data directly instead of using getter functions to avoid
+  // creating new object references that would cause infinite re-render loops with useShallow
+  const { node, setCredentialsOptional } = useNodeStore(
+    useShallow((state) => ({
+      node: nodeId ? state.nodes.find((n) => n.id === nodeId) : undefined,
+      setCredentialsOptional: state.setCredentialsOptional,
+    })),
+  );
+
+  const hardcodedValues = useMemo(
+    () => node?.data?.hardcodedValues || {},
+    [node?.data?.hardcodedValues],
+  );
+  const credentialsOptional = useMemo(() => {
+    const value = node?.data?.metadata?.credentials_optional;
+    return typeof value === "boolean" ? value : false;
+  }, [node?.data?.metadata?.credentials_optional]);
+
+  const handleChange = (newValue: any) => {
+    onChange(newValue, fieldPathId?.path);
+  };
+
+  const handleSelectCredentials = (credentialsMeta?: CredentialsMetaInput) => {
+    if (credentialsMeta) {
+      handleChange({
+        id: credentialsMeta.id,
+        provider: credentialsMeta.provider,
+        title: credentialsMeta.title,
+        type: credentialsMeta.type,
+      });
+    } else {
+      handleChange(undefined);
+    }
+  };
+
+  // Convert formData to CredentialsMetaInput format
+  const selectedCredentials: CredentialsMetaInput | undefined = useMemo(
+    () =>
+      formData?.id
+        ? {
+            id: formData.id,
+            provider: formData.provider,
+            title: formData.title,
+            type: formData.type,
+          }
+        : undefined,
+    [formData?.id, formData?.provider, formData?.title, formData?.type],
+  );
+
+  // In builder canvas (nodeId exists): show star based on credentialsOptional toggle
+  // In run dialogs (no nodeId): show star based on schema's required array
+  const isRequired = nodeId ? !credentialsOptional : required;
+
+  return (
+    <div className="flex flex-col gap-2">
+      <CredentialFieldTitle
+        fieldPathId={fieldPathId}
+        registry={registry}
+        uiOptions={uiOptions}
+        schema={schema}
+        required={isRequired}
+      />
+      <CredentialsInput
+        schema={schema as BlockIOCredentialsSubSchema}
+        selectedCredentials={selectedCredentials}
+        onSelectCredentials={handleSelectCredentials}
+        siblingInputs={hardcodedValues}
+        showTitle={false}
+        readOnly={formContext?.readOnly}
+        isOptional={!isRequired}
+        className="w-full"
+        variant="node"
+      />
+
+      {/* Optional credentials toggle - only show in builder canvas, not run dialogs */}
+      {nodeId &&
+        !formContext?.readOnly &&
+        formContext?.showOptionalToggle !== false && (
+          <div className="mt-1 flex items-center gap-2">
+            <Switch
+              id={`credentials-optional-${nodeId}`}
+              checked={credentialsOptional}
+              onCheckedChange={(checked) =>
+                setCredentialsOptional(nodeId, checked)
+              }
+            />
+            <label
+              htmlFor={`credentials-optional-${nodeId}`}
+              className="cursor-pointer text-xs text-gray-500"
+            >
+              Optional - skip block if not configured
+            </label>
+          </div>
+        )}
+    </div>
+  );
+};
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/CredentialField/components/CredentialFieldTitle.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/CredentialField/components/CredentialFieldTitle.tsx
new file mode 100644
index 0000000000..347f4e089a
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/CredentialField/components/CredentialFieldTitle.tsx
@@ -0,0 +1,67 @@
+import {
+  getTemplate,
+  UiSchema,
+  Registry,
+  RJSFSchema,
+  FieldPathId,
+  titleId,
+  descriptionId,
+} from "@rjsf/utils";
+import { getCredentialProviderFromSchema, toDisplayName } from "../helpers";
+import { useNodeStore } from "@/app/(platform)/build/stores/nodeStore";
+import { BlockIOCredentialsSubSchema } from "@/lib/autogpt-server-api";
+import { updateUiOption } from "../../../helpers";
+import { uiSchema } from "@/app/(platform)/build/components/FlowEditor/nodes/uiSchema";
+
+export const CredentialFieldTitle = (props: {
+  registry: Registry;
+  uiOptions: UiSchema;
+  schema: RJSFSchema;
+  fieldPathId: FieldPathId;
+  required?: boolean;
+}) => {
+  const { registry, uiOptions, schema, fieldPathId, required = false } = props;
+  const { nodeId } = registry.formContext;
+
+  const TitleFieldTemplate = getTemplate(
+    "TitleFieldTemplate",
+    registry,
+    uiOptions,
+  );
+
+  const DescriptionFieldTemplate = getTemplate(
+    "DescriptionFieldTemplate",
+    registry,
+    uiOptions,
+  );
+
+  const credentialProvider = toDisplayName(
+    getCredentialProviderFromSchema(
+      useNodeStore.getState().getHardCodedValues(nodeId),
+      schema as BlockIOCredentialsSubSchema,
+    ) ?? "",
+  );
+
+  const updatedUiSchema = updateUiOption(uiSchema, {
+    showHandles: false,
+  });
+
+  return (
+    <div className="flex items-center gap-2">
+      <TitleFieldTemplate
+        id={titleId(fieldPathId ?? "")}
+        title={credentialProvider ?? ""}
+        required={required}
+        schema={schema}
+        registry={registry}
+        uiSchema={updatedUiSchema}
+      />
+      <DescriptionFieldTemplate
+        id={descriptionId(fieldPathId ?? "")}
+        description={schema.description || ""}
+        schema={schema}
+        registry={registry}
+      />
+    </div>
+  );
+};
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/helpers.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/CredentialField/helpers.ts
similarity index 100%
rename from autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/helpers.ts
rename to autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/CredentialField/helpers.ts
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/GoogleDrivePickerField/GoogleDrivePickerField.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/GoogleDrivePickerField/GoogleDrivePickerField.tsx
new file mode 100644
index 0000000000..dff6274189
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/GoogleDrivePickerField/GoogleDrivePickerField.tsx
@@ -0,0 +1,32 @@
+import { BlockUIType } from "@/app/(platform)/build/components/types";
+import { GoogleDrivePickerInput } from "@/components/contextual/GoogleDrivePicker/GoogleDrivePickerInput";
+import { GoogleDrivePickerConfig } from "@/lib/autogpt-server-api";
+import { FieldProps, getUiOptions } from "@rjsf/utils";
+
+export const GoogleDrivePickerField = (props: FieldProps) => {
+  const { schema, uiSchema, onChange, fieldPathId, formData, registry } = props;
+  const uiOptions = getUiOptions(uiSchema);
+  const config: GoogleDrivePickerConfig = schema.google_drive_picker_config;
+
+  const uiType = registry.formContext?.uiType;
+
+  if (uiType === BlockUIType.INPUT) {
+    return (
+      <div className="rounded-3xl border border-gray-200 p-2 pl-4 text-xs text-gray-500 hover:cursor-not-allowed">
+        Select files when you run the graph
+      </div>
+    );
+  }
+
+  return (
+    <div>
+      <GoogleDrivePickerInput
+        config={config}
+        value={formData}
+        onChange={(value) => onChange(value, fieldPathId.path)}
+        className={uiOptions.className}
+        showRemoveButton={true}
+      />
+    </div>
+  );
+};
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/JsonTextField/JsonTextField.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/JsonTextField/JsonTextField.tsx
new file mode 100644
index 0000000000..dc7738320a
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/JsonTextField/JsonTextField.tsx
@@ -0,0 +1,124 @@
+"use client";
+
+import { FieldProps, getTemplate, getUiOptions } from "@rjsf/utils";
+import { Input } from "@/components/atoms/Input/Input";
+import { Button } from "@/components/atoms/Button/Button";
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipTrigger,
+} from "@/components/atoms/Tooltip/BaseTooltip";
+import { ArrowsOutIcon } from "@phosphor-icons/react";
+import { InputExpanderModal } from "../../base/standard/widgets/TextInput/TextInputExpanderModal";
+import { getHandleId, updateUiOption } from "../../helpers";
+import { useJsonTextField } from "./useJsonTextField";
+import { getPlaceholder } from "./helpers";
+
+export const JsonTextField = (props: FieldProps) => {
+  const {
+    formData,
+    onChange,
+    schema,
+    registry,
+    uiSchema,
+    required,
+    name,
+    fieldPathId,
+  } = props;
+
+  const uiOptions = getUiOptions(uiSchema);
+
+  const TitleFieldTemplate = getTemplate(
+    "TitleFieldTemplate",
+    registry,
+    uiOptions,
+  );
+
+  const fieldId = fieldPathId?.$id ?? props.id ?? "json-field";
+
+  const handleId = getHandleId({
+    uiOptions,
+    id: fieldId,
+    schema: schema,
+  });
+
+  const updatedUiSchema = updateUiOption(uiSchema, {
+    handleId: handleId,
+  });
+
+  const {
+    textValue,
+    isModalOpen,
+    handleChange,
+    handleModalOpen,
+    handleModalClose,
+    handleModalSave,
+  } = useJsonTextField({
+    formData,
+    onChange,
+    path: fieldPathId?.path,
+  });
+
+  const placeholder = getPlaceholder(schema);
+  const title = schema.title || name || "JSON Value";
+
+  return (
+    <div className="flex flex-col gap-2">
+      <TitleFieldTemplate
+        id={fieldId}
+        title={title}
+        required={required}
+        schema={schema}
+        uiSchema={updatedUiSchema}
+        registry={registry}
+      />
+      <div className="nodrag relative flex items-center gap-2">
+        <Input
+          id={fieldId}
+          hideLabel={true}
+          type="textarea"
+          label=""
+          size="small"
+          wrapperClassName="mb-0 flex-1 "
+          value={textValue}
+          onChange={handleChange}
+          placeholder={placeholder}
+          required={required}
+          disabled={props.disabled}
+          className="min-h-[60px] pr-8 font-mono text-xs"
+        />
+
+        <Tooltip delayDuration={0}>
+          <TooltipTrigger asChild>
+            <Button
+              variant="ghost"
+              size="icon"
+              onClick={handleModalOpen}
+              type="button"
+              className="p-1"
+            >
+              <ArrowsOutIcon className="size-4" />
+            </Button>
+          </TooltipTrigger>
+          <TooltipContent>Expand input</TooltipContent>
+        </Tooltip>
+      </div>
+      {schema.description && (
+        <span className="text-xs text-gray-500">{schema.description}</span>
+      )}
+
+      <InputExpanderModal
+        isOpen={isModalOpen}
+        onClose={handleModalClose}
+        onSave={handleModalSave}
+        title={`Edit ${title}`}
+        description={schema.description || "Enter valid JSON"}
+        defaultValue={textValue}
+        placeholder={placeholder}
+        inputType="json"
+      />
+    </div>
+  );
+};
+
+export default JsonTextField;
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/JsonTextField/helpers.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/JsonTextField/helpers.ts
new file mode 100644
index 0000000000..fea0f20dbc
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/JsonTextField/helpers.ts
@@ -0,0 +1,67 @@
+import { RJSFSchema } from "@rjsf/utils";
+
+/**
+ * Converts form data to a JSON string for display
+ * @param formData - The data to stringify
+ * @returns JSON string or empty string if data is null/undefined
+ */
+export function stringifyFormData(formData: unknown): string {
+  if (formData === undefined || formData === null) {
+    return "";
+  }
+  try {
+    return JSON.stringify(formData, null, 2);
+  } catch {
+    return "";
+  }
+}
+
+/**
+ * Parses a JSON string into an object/array
+ * @param value - The JSON string to parse
+ * @returns Parsed value or undefined if parsing fails or empty
+ */
+export function parseJsonValue(value: string): unknown | undefined {
+  const trimmed = value.trim();
+  if (trimmed === "") {
+    return undefined;
+  }
+
+  try {
+    return JSON.parse(trimmed);
+  } catch {
+    return undefined;
+  }
+}
+
+/**
+ * Gets the appropriate placeholder text based on schema type
+ * @param schema - The JSON schema
+ * @returns Placeholder string
+ */
+export function getPlaceholder(schema: RJSFSchema): string {
+  if (schema.type === "array") {
+    return '["item1", "item2"] or [{"key": "value"}]';
+  }
+  if (schema.type === "object") {
+    return '{"key": "value"}';
+  }
+  return "Enter JSON value...";
+}
+
+/**
+ * Checks if a JSON string is valid
+ * @param value - The JSON string to validate
+ * @returns true if valid JSON, false otherwise
+ */
+export function isValidJson(value: string): boolean {
+  if (value.trim() === "") {
+    return true; // Empty is considered valid (will be undefined)
+  }
+  try {
+    JSON.parse(value);
+    return true;
+  } catch {
+    return false;
+  }
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/JsonTextField/useJsonTextField.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/JsonTextField/useJsonTextField.ts
new file mode 100644
index 0000000000..85dc69cfd3
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/JsonTextField/useJsonTextField.ts
@@ -0,0 +1,107 @@
+import { useState, useEffect, useCallback } from "react";
+import { FieldProps } from "@rjsf/utils";
+import { stringifyFormData, parseJsonValue, isValidJson } from "./helpers";
+
+type FieldOnChange = FieldProps["onChange"];
+type FieldPathId = FieldProps["fieldPathId"];
+
+interface UseJsonTextFieldOptions {
+  formData: unknown;
+  onChange: FieldOnChange;
+  path?: FieldPathId["path"];
+}
+
+interface UseJsonTextFieldReturn {
+  textValue: string;
+  isModalOpen: boolean;
+  hasError: boolean;
+  handleChange: (
+    e: React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement>,
+  ) => void;
+  handleModalOpen: () => void;
+  handleModalClose: () => void;
+  handleModalSave: (value: string) => void;
+}
+
+/**
+ * Custom hook for managing JSON text field state and handlers
+ */
+export function useJsonTextField({
+  formData,
+  onChange,
+  path,
+}: UseJsonTextFieldOptions): UseJsonTextFieldReturn {
+  const [textValue, setTextValue] = useState(() => stringifyFormData(formData));
+  const [isModalOpen, setIsModalOpen] = useState(false);
+  const [hasError, setHasError] = useState(false);
+
+  // Update text value when formData changes externally
+  useEffect(() => {
+    const newValue = stringifyFormData(formData);
+    setTextValue(newValue);
+    setHasError(false);
+  }, [formData]);
+
+  const handleChange = useCallback(
+    (e: React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement>) => {
+      const value = e.target.value;
+      setTextValue(value);
+
+      // Validate JSON and update error state
+      const valid = isValidJson(value);
+      setHasError(!valid);
+
+      // Try to parse and update formData
+      if (value.trim() === "") {
+        onChange(undefined, path ?? []);
+        return;
+      }
+
+      const parsed = parseJsonValue(value);
+      if (parsed !== undefined) {
+        onChange(parsed, path ?? []);
+      }
+    },
+    [onChange, path],
+  );
+
+  const handleModalOpen = useCallback(() => {
+    setIsModalOpen(true);
+  }, []);
+
+  const handleModalClose = useCallback(() => {
+    setIsModalOpen(false);
+  }, []);
+
+  const handleModalSave = useCallback(
+    (value: string) => {
+      setTextValue(value);
+      setIsModalOpen(false);
+
+      // Validate and update
+      const valid = isValidJson(value);
+      setHasError(!valid);
+
+      if (value.trim() === "") {
+        onChange(undefined, path ?? []);
+        return;
+      }
+
+      const parsed = parseJsonValue(value);
+      if (parsed !== undefined) {
+        onChange(parsed, path ?? []);
+      }
+    },
+    [onChange, path],
+  );
+
+  return {
+    textValue,
+    isModalOpen,
+    hasError,
+    handleChange,
+    handleModalOpen,
+    handleModalClose,
+    handleModalSave,
+  };
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/MultiSelectField/MultiSelectField.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/MultiSelectField/MultiSelectField.tsx
new file mode 100644
index 0000000000..dcae2f3bed
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/MultiSelectField/MultiSelectField.tsx
@@ -0,0 +1,57 @@
+import React from "react";
+import { FieldProps, getUiOptions } from "@rjsf/utils";
+import { BlockIOObjectSubSchema } from "@/lib/autogpt-server-api/types";
+import {
+  MultiSelector,
+  MultiSelectorContent,
+  MultiSelectorInput,
+  MultiSelectorItem,
+  MultiSelectorList,
+  MultiSelectorTrigger,
+} from "@/components/__legacy__/ui/multiselect";
+import { cn } from "@/lib/utils";
+import { useMultiSelectField } from "./useMultiSelectField";
+
+export const MultiSelectField = (props: FieldProps) => {
+  const { schema, formData, onChange, fieldPathId } = props;
+  const uiOptions = getUiOptions(props.uiSchema);
+
+  const { optionSchema, options, selection, createChangeHandler } =
+    useMultiSelectField({
+      schema: schema as BlockIOObjectSubSchema,
+      formData,
+    });
+
+  const handleValuesChange = createChangeHandler(onChange, fieldPathId);
+
+  const displayName = schema.title || "options";
+
+  return (
+    <div className={cn("flex flex-col", uiOptions.className)}>
+      <MultiSelector
+        className="nodrag"
+        values={selection}
+        onValuesChange={handleValuesChange}
+      >
+        <MultiSelectorTrigger className="rounded-3xl border border-zinc-200 bg-white px-2 shadow-none">
+          <MultiSelectorInput
+            placeholder={
+              (schema as any).placeholder ?? `Select ${displayName}...`
+            }
+          />
+        </MultiSelectorTrigger>
+        <MultiSelectorContent className="nowheel">
+          <MultiSelectorList>
+            {options
+              .map((key) => ({ ...optionSchema[key], key }))
+              .map(({ key, title, description }) => (
+                <MultiSelectorItem key={key} value={key} title={description}>
+                  {title ?? key}
+                </MultiSelectorItem>
+              ))}
+          </MultiSelectorList>
+        </MultiSelectorContent>
+      </MultiSelector>
+    </div>
+  );
+};
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/MultiSelectField/index.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/MultiSelectField/index.ts
new file mode 100644
index 0000000000..4d49ec7dbb
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/MultiSelectField/index.ts
@@ -0,0 +1 @@
+export { MultiSelectField } from "./MultiSelectField";
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/MultiSelectField/useMultiSelectField.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/MultiSelectField/useMultiSelectField.ts
new file mode 100644
index 0000000000..c04173dcfe
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/MultiSelectField/useMultiSelectField.ts
@@ -0,0 +1,65 @@
+import { FieldProps } from "@rjsf/utils";
+import { BlockIOObjectSubSchema } from "@/lib/autogpt-server-api/types";
+
+type FormData = Record<string, boolean> | null | undefined;
+
+interface UseMultiSelectFieldOptions {
+  schema: BlockIOObjectSubSchema;
+  formData: FormData;
+}
+
+export function useMultiSelectField({
+  schema,
+  formData,
+}: UseMultiSelectFieldOptions) {
+  const getOptionSchema = (): Record<string, BlockIOObjectSubSchema> => {
+    if (schema.properties) {
+      return schema.properties as Record<string, BlockIOObjectSubSchema>;
+    }
+    if (
+      "anyOf" in schema &&
+      Array.isArray(schema.anyOf) &&
+      schema.anyOf.length > 0 &&
+      "properties" in schema.anyOf[0]
+    ) {
+      return (schema.anyOf[0] as BlockIOObjectSubSchema).properties as Record<
+        string,
+        BlockIOObjectSubSchema
+      >;
+    }
+    return {};
+  };
+
+  const optionSchema = getOptionSchema();
+  const options = Object.keys(optionSchema);
+
+  const getSelection = (): string[] => {
+    if (!formData || typeof formData !== "object") {
+      return [];
+    }
+    return Object.entries(formData)
+      .filter(([_, value]) => value === true)
+      .map(([key]) => key);
+  };
+
+  const selection = getSelection();
+
+  const createChangeHandler =
+    (
+      onChange: FieldProps["onChange"],
+      fieldPathId: FieldProps["fieldPathId"],
+    ) =>
+    (values: string[]) => {
+      const newValue = Object.fromEntries(
+        options.map((opt) => [opt, values.includes(opt)]),
+      );
+      onChange(newValue, fieldPathId?.path);
+    };
+
+  return {
+    optionSchema,
+    options,
+    selection,
+    createChangeHandler,
+  };
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/TableField/TableField.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/TableField/TableField.tsx
new file mode 100644
index 0000000000..b48eca3238
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/TableField/TableField.tsx
@@ -0,0 +1,52 @@
+import { descriptionId, FieldProps, getTemplate, titleId } from "@rjsf/utils";
+import { Table, RowData } from "@/components/molecules/Table/Table";
+import { useMemo } from "react";
+
+export const TableField = (props: FieldProps) => {
+  const { schema, formData, onChange, fieldPathId, registry, uiSchema } = props;
+
+  const itemSchema = schema.items as any;
+  const properties = itemSchema?.properties || {};
+
+  const columns: string[] = useMemo(() => {
+    return Object.keys(properties);
+  }, [properties]);
+
+  const handleChange = (rows: RowData[]) => {
+    onChange(rows, fieldPathId?.path.slice(0, -1));
+  };
+
+  const TitleFieldTemplate = getTemplate("TitleFieldTemplate", registry);
+  const DescriptionFieldTemplate = getTemplate(
+    "DescriptionFieldTemplate",
+    registry,
+  );
+
+  return (
+    <div className="flex flex-col gap-2">
+      <TitleFieldTemplate
+        id={titleId(fieldPathId)}
+        title={schema.title || ""}
+        required={true}
+        schema={schema}
+        uiSchema={uiSchema}
+        registry={registry}
+      />
+      <DescriptionFieldTemplate
+        id={descriptionId(fieldPathId)}
+        description={schema.description || ""}
+        schema={schema}
+        registry={registry}
+      />
+
+      <Table
+        columns={columns}
+        defaultValues={formData}
+        onChange={handleChange}
+        allowAddRow={true}
+        allowDeleteRow={true}
+        addRowLabel="Add row"
+      />
+    </div>
+  );
+};
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/custom-registry.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/custom-registry.ts
new file mode 100644
index 0000000000..257a98ad93
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/custom-registry.ts
@@ -0,0 +1,79 @@
+import { FieldProps, RJSFSchema, RegistryFieldsType } from "@rjsf/utils";
+import { CredentialsField } from "./CredentialField/CredentialField";
+import { GoogleDrivePickerField } from "./GoogleDrivePickerField/GoogleDrivePickerField";
+import { JsonTextField } from "./JsonTextField/JsonTextField";
+import { MultiSelectField } from "./MultiSelectField/MultiSelectField";
+import {
+  isGoogleDrivePickerSchema,
+  isMultiSelectSchema,
+} from "../utils/schema-utils";
+import { TableField } from "./TableField/TableField";
+
+export interface CustomFieldDefinition {
+  id: string;
+  matcher: (schema: any) => boolean;
+  component: (props: FieldProps<any, RJSFSchema, any>) => JSX.Element | null;
+}
+
+/** Field ID for JsonTextField - used to render nested complex types as text input */
+export const JSON_TEXT_FIELD_ID = "custom/json_text_field";
+
+export const CUSTOM_FIELDS: CustomFieldDefinition[] = [
+  {
+    id: "custom/credential_field",
+    matcher: (schema: any) => {
+      return (
+        typeof schema === "object" &&
+        schema !== null &&
+        "credentials_provider" in schema
+      );
+    },
+    component: CredentialsField,
+  },
+  {
+    id: "custom/google_drive_picker_field",
+    matcher: isGoogleDrivePickerSchema,
+    component: GoogleDrivePickerField,
+  },
+  {
+    id: "custom/json_text_field",
+    // Not matched by schema - assigned via uiSchema for nested complex types
+    matcher: () => false,
+    component: JsonTextField,
+  },
+  {
+    id: "custom/multi_select_field",
+    matcher: isMultiSelectSchema,
+    component: MultiSelectField,
+  },
+  {
+    id: "custom/table_field",
+    matcher: (schema: any) => {
+      return (
+        schema.type === "array" &&
+        "format" in schema &&
+        schema.format === "table"
+      );
+    },
+    component: TableField,
+  },
+];
+
+export function findCustomFieldId(schema: any): string | null {
+  for (const field of CUSTOM_FIELDS) {
+    if (field.matcher(schema)) {
+      return field.id;
+    }
+  }
+  return null;
+}
+
+export function generateCustomFields(): RegistryFieldsType {
+  return CUSTOM_FIELDS.reduce(
+    (acc, field) => {
+      acc[field.id] = field.component;
+      return acc;
+    },
+    {} as Record<string, any>,
+  );
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/docs/HEIRARCHY.md b/autogpt_platform/frontend/src/components/renderers/InputRenderer/docs/HEIRARCHY.md
new file mode 100644
index 0000000000..45b4276946
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/docs/HEIRARCHY.md
@@ -0,0 +1,291 @@
+# Input Renderer 2 - Hierarchy
+
+## Flow Overview
+
+```
+FormRenderer2 → Form (RJSF) → ObjectFieldTemplate → FieldTemplate → Widget/Field
+```
+
+---
+
+## Component Layers
+
+### 1. Root (FormRenderer2)
+
+- Entry point
+- Preprocesses schema
+- Passes to RJSF Form
+
+### 2. Form (registry/Form.tsx)
+
+- RJSF themed form
+- Combines: templates + widgets + fields
+
+### 3. Templates (decide layout/structure)
+
+| Template                   | When Used                                   |
+| -------------------------- | ------------------------------------------- |
+| `ObjectFieldTemplate`      | `type: "object"`                            |
+| `ArrayFieldTemplate`       | `type: "array"`                             |
+| `FieldTemplate`            | Wraps every field (title, errors, children) |
+| `ArrayFieldItemTemplate`   | Each array item                             |
+| `WrapIfAdditionalTemplate` | Additional properties in objects            |
+
+### 4. Fields (custom rendering logic)
+
+| Field              | When Used                    |
+| ------------------ | ---------------------------- |
+| `AnyOfField`       | `anyOf` or `oneOf` in schema |
+| `ArraySchemaField` | Array type handling          |
+
+### 5. Widgets (actual input elements)
+
+| Widget           | Input Type              |
+| ---------------- | ----------------------- |
+| `TextWidget`     | string, number, integer |
+| `SelectWidget`   | enum, anyOf selector    |
+| `CheckboxWidget` | boolean                 |
+| `FileWidget`     | file upload             |
+| `DateWidget`     | date                    |
+| `TimeWidget`     | time                    |
+| `DateTimeWidget` | datetime                |
+
+---
+
+## Your Schema Hierarchy
+
+```
+Root (type: object)
+└── ObjectFieldTemplate
+    │
+    ├── name (string, required)
+    │   └── FieldTemplate → TextWidget
+    │
+    ├── value (anyOf)
+    │   └── FieldTemplate → AnyOfField
+    │       └── Selector dropdown + selected type:
+    │           ├── String → TextWidget
+    │           ├── Number → TextWidget
+    │           ├── Integer → TextWidget
+    │           ├── Boolean → CheckboxWidget
+    │           ├── Array → ArrayFieldTemplate → items
+    │           ├── Object → ObjectFieldTemplate
+    │           └── Null → nothing
+    │
+    ├── title (anyOf: string | null)
+    │   └── FieldTemplate → AnyOfField
+    │       └── String → TextWidget OR Null → nothing
+    │
+    ├── description (anyOf: string | null)
+    │   └── FieldTemplate → AnyOfField
+    │       └── String → TextWidget OR Null → nothing
+    │
+    ├── placeholder_values (array of strings)
+    │   └── FieldTemplate → ArrayFieldTemplate
+    │       └── ArrayFieldItemTemplate (per item)
+    │           └── TextWidget
+    │
+    ├── advanced (boolean)
+    │   └── FieldTemplate → CheckboxWidget
+    │
+    └── secret (boolean)
+        └── FieldTemplate → CheckboxWidget
+```
+
+---
+
+## Nested Examples (up to 3 levels)
+
+### Simple Array (strings)
+
+```json
+{ "tags": { "type": "array", "items": { "type": "string" } } }
+```
+
+```
+Level 1: ObjectFieldTemplate (root)
+└── Level 2: FieldTemplate → ArrayFieldTemplate
+    └── Level 3: ArrayFieldItemTemplate → TextWidget
+```
+
+### Array of Objects
+
+```json
+{
+  "users": {
+    "type": "array",
+    "items": {
+      "type": "object",
+      "properties": {
+        "name": { "type": "string" },
+        "age": { "type": "integer" }
+      }
+    }
+  }
+}
+```
+
+```
+Level 1: ObjectFieldTemplate (root)
+└── Level 2: FieldTemplate → ArrayFieldTemplate
+    └── Level 3: ArrayFieldItemTemplate → ObjectFieldTemplate
+        ├── FieldTemplate → TextWidget (name)
+        └── FieldTemplate → TextWidget (age)
+```
+
+### Nested Object (3 levels)
+
+```json
+{
+  "config": {
+    "type": "object",
+    "properties": {
+      "database": {
+        "type": "object",
+        "properties": {
+          "host": { "type": "string" },
+          "port": { "type": "integer" }
+        }
+      }
+    }
+  }
+}
+```
+
+```
+Level 1: ObjectFieldTemplate (root)
+└── config
+    └── Level 2: FieldTemplate → ObjectFieldTemplate
+        └── database
+            └── Level 3: FieldTemplate → ObjectFieldTemplate
+                ├── FieldTemplate → TextWidget (host)
+                └── FieldTemplate → TextWidget (port)
+```
+
+### Array of Arrays (nested array)
+
+```json
+{
+  "matrix": {
+    "type": "array",
+    "items": {
+      "type": "array",
+      "items": { "type": "number" }
+    }
+  }
+}
+```
+
+```
+Level 1: ObjectFieldTemplate (root)
+└── Level 2: FieldTemplate → ArrayFieldTemplate
+    └── Level 3: ArrayFieldItemTemplate → ArrayFieldTemplate
+        └── ArrayFieldItemTemplate → TextWidget
+```
+
+### Complex: Object → Array → Object
+
+```json
+{
+  "company": {
+    "type": "object",
+    "properties": {
+      "departments": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "name": { "type": "string" },
+            "budget": { "type": "number" }
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+```
+Level 1: ObjectFieldTemplate (root)
+└── company
+    └── Level 2: FieldTemplate → ObjectFieldTemplate
+        └── departments
+            └── Level 3: FieldTemplate → ArrayFieldTemplate
+                └── ArrayFieldItemTemplate → ObjectFieldTemplate
+                    ├── FieldTemplate → TextWidget (name)
+                    └── FieldTemplate → TextWidget (budget)
+```
+
+### anyOf inside Array
+
+```json
+{
+  "items": {
+    "type": "array",
+    "items": {
+      "anyOf": [
+        { "type": "string" },
+        { "type": "object", "properties": { "id": { "type": "string" } } }
+      ]
+    }
+  }
+}
+```
+
+```
+Level 1: ObjectFieldTemplate (root)
+└── Level 2: FieldTemplate → ArrayFieldTemplate
+    └── Level 3: ArrayFieldItemTemplate → AnyOfField
+        └── Selector + selected:
+            ├── String → TextWidget
+            └── Object → ObjectFieldTemplate
+                └── FieldTemplate → TextWidget (id)
+```
+
+---
+
+## Nesting Pattern Summary
+
+| Parent Type | Child Wrapper                                   |
+| ----------- | ----------------------------------------------- |
+| object      | `ObjectFieldTemplate` → `FieldTemplate`         |
+| array       | `ArrayFieldTemplate` → `ArrayFieldItemTemplate` |
+| anyOf       | `AnyOfField` → selected schema's template       |
+| primitive   | `Widget` (leaf - no children)                   |
+
+**Pattern:** Each level adds FieldTemplate wrapper except array items (use ArrayFieldItemTemplate)
+
+---
+
+## Key Points
+
+1. **FieldTemplate wraps everything** - handles title, description, errors
+2. **anyOf = AnyOfField** - shows dropdown to pick type, then renders selected schema
+3. **ObjectFieldTemplate loops properties** - each property gets FieldTemplate
+4. **ArrayFieldTemplate loops items** - each item gets ArrayFieldItemTemplate
+5. **Widgets are leaf nodes** - actual input controls user interacts with
+6. **Nesting repeats the pattern** - object/array/anyOf can contain object/array/anyOf recursively
+
+---
+
+## Decision Flow
+
+```
+Schema Type?
+├── object → ObjectFieldTemplate → loop properties
+├── array → ArrayFieldTemplate → loop items
+├── anyOf/oneOf → AnyOfField → selector + selected schema
+└── primitive (string/number/boolean) → Widget
+```
+
+---
+
+## Template Wrapping Order
+
+```
+ObjectFieldTemplate (root)
+└── FieldTemplate (per property)
+    └── WrapIfAdditionalTemplate (if additionalProperties)
+        └── TitleField + DescriptionField + children
+            └── Widget OR nested Template/Field
+```
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/helpers.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/helpers.ts
new file mode 100644
index 0000000000..1a0b52c0b4
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/helpers.ts
@@ -0,0 +1,278 @@
+import {
+  RJSFSchema,
+  UIOptionsType,
+  StrictRJSFSchema,
+  FormContextType,
+  ADDITIONAL_PROPERTY_FLAG,
+} from "@rjsf/utils";
+
+import {
+  ANY_OF_FLAG,
+  ARRAY_ITEM_FLAG,
+  ID_PREFIX,
+  ID_PREFIX_ARRAY,
+  KEY_PAIR_FLAG,
+  OBJECT_FLAG,
+} from "./constants";
+import { PathSegment } from "./types";
+
+export function updateUiOption<T extends Record<string, any>>(
+  uiSchema: T | undefined,
+  options: Record<string, any>,
+): T & { "ui:options": Record<string, any> } {
+  return {
+    ...(uiSchema || {}),
+    "ui:options": {
+      ...uiSchema?.["ui:options"],
+      ...options,
+    },
+  } as T & { "ui:options": Record<string, any> };
+}
+
+export const cleanUpHandleId = (handleId: string) => {
+  if (!handleId) return "";
+
+  let newHandleId = handleId;
+  if (handleId.includes(ANY_OF_FLAG)) {
+    newHandleId = newHandleId.replace(ANY_OF_FLAG, "");
+  }
+  if (handleId.includes(ARRAY_ITEM_FLAG)) {
+    newHandleId = newHandleId.replace(ARRAY_ITEM_FLAG, "");
+  }
+  if (handleId.includes(KEY_PAIR_FLAG)) {
+    newHandleId = newHandleId.replace(KEY_PAIR_FLAG, "");
+  }
+  if (handleId.includes(OBJECT_FLAG)) {
+    newHandleId = newHandleId.replace(OBJECT_FLAG, "");
+  }
+  if (handleId.includes(ID_PREFIX_ARRAY)) {
+    newHandleId = newHandleId.replace(ID_PREFIX_ARRAY, "");
+  }
+  if (handleId.includes(ID_PREFIX)) {
+    newHandleId = newHandleId.replace(ID_PREFIX, "");
+  }
+  return newHandleId;
+};
+
+export const isArrayItem = <
+  T = any,
+  S extends StrictRJSFSchema = RJSFSchema,
+  F extends FormContextType = any,
+>({
+  uiOptions,
+}: {
+  uiOptions: UIOptionsType<T, S, F>;
+}) => {
+  return uiOptions.handleId?.endsWith(ARRAY_ITEM_FLAG);
+};
+
+export const isKeyValuePair = ({ schema }: { schema: RJSFSchema }) => {
+  return ADDITIONAL_PROPERTY_FLAG in schema;
+};
+
+export const isNormal = <
+  T = any,
+  S extends StrictRJSFSchema = RJSFSchema,
+  F extends FormContextType = any,
+>({
+  uiOptions,
+}: {
+  uiOptions: UIOptionsType<T, S, F>;
+}) => {
+  return uiOptions.handleId === undefined;
+};
+
+export const isPartOfAnyOf = <
+  T = any,
+  S extends StrictRJSFSchema = RJSFSchema,
+  F extends FormContextType = any,
+>({
+  uiOptions,
+}: {
+  uiOptions: UIOptionsType<T, S, F>;
+}) => {
+  return uiOptions.handleId?.endsWith(ANY_OF_FLAG);
+};
+export const isObjectProperty = <
+  T = any,
+  S extends StrictRJSFSchema = RJSFSchema,
+  F extends FormContextType = any,
+>({
+  uiOptions,
+  schema,
+}: {
+  uiOptions: UIOptionsType<T, S, F>;
+  schema: RJSFSchema;
+}) => {
+  return (
+    !isArrayItem({ uiOptions }) &&
+    !isKeyValuePair({ schema }) &&
+    !isNormal({ uiOptions }) &&
+    !isPartOfAnyOf({ uiOptions })
+  );
+};
+
+export const getHandleId = <
+  T = any,
+  S extends StrictRJSFSchema = RJSFSchema,
+  F extends FormContextType = any,
+>({
+  id,
+  schema,
+  uiOptions,
+}: {
+  id: string;
+  schema: RJSFSchema;
+  uiOptions: UIOptionsType<T, S, F>;
+}) => {
+  const parentHandleId = uiOptions.handleId;
+
+  if (isNormal({ uiOptions })) {
+    return id;
+  }
+
+  if (isPartOfAnyOf({ uiOptions })) {
+    return parentHandleId + ANY_OF_FLAG;
+  }
+
+  if (isKeyValuePair({ schema })) {
+    const key = id.split("_%_").at(-1);
+    let prefix = "";
+    if (parentHandleId) {
+      prefix = parentHandleId;
+    } else {
+      prefix = id.split("_%_").slice(0, -1).join("_%_");
+    }
+
+    const handleId = `${prefix}_#_${key}`;
+    return handleId + KEY_PAIR_FLAG;
+  }
+
+  if (isArrayItem({ uiOptions })) {
+    const index = id.split("_%_").at(-1);
+    const prefix = id.split("_%_").slice(0, -1).join("_%_");
+    const handleId = `${prefix}_$_${index}`;
+    return handleId + ARRAY_ITEM_FLAG;
+  }
+
+  if (isObjectProperty({ uiOptions, schema })) {
+    const key = id.split("_%_").at(-1);
+    const prefix = id.split("_%_").slice(0, -1).join("_%_");
+    const handleId = `${prefix}_@_${key}`;
+    return handleId + OBJECT_FLAG;
+  }
+  return parentHandleId;
+};
+
+export function isCredentialFieldSchema(schema: any): boolean {
+  return (
+    typeof schema === "object" &&
+    schema !== null &&
+    "credentials_provider" in schema
+  );
+}
+
+export function parseHandleIdToPath(handleId: string): PathSegment[] {
+  const cleanedId = cleanUpHandleId(handleId);
+  const segments: PathSegment[] = [];
+  const parts = cleanedId.split(/(_#_|_@_|_\$_|\.)/);
+
+  let currentType: "property" | "item" | "additional" | "normal" = "normal";
+
+  for (let i = 0; i < parts.length; i++) {
+    const part = parts[i];
+
+    if (part === "_#_") {
+      currentType = "additional";
+    } else if (part === "_@_") {
+      currentType = "property";
+    } else if (part === "_$_") {
+      currentType = "item";
+    } else if (part === ".") {
+      currentType = "normal";
+    } else if (part) {
+      const isNumeric = /^\d+$/.test(part);
+      if (currentType === "item" && isNumeric) {
+        segments.push({
+          key: part,
+          type: "item",
+          index: parseInt(part, 10),
+        });
+      } else {
+        segments.push({
+          key: part,
+          type: currentType,
+        });
+      }
+      currentType = "normal";
+    }
+  }
+
+  return segments;
+}
+
+/**
+ * Ensure a path exists in an object, creating intermediate objects/arrays as needed
+ * Returns true if any modifications were made
+ */
+export function ensurePathExists(
+  obj: Record<string, any>,
+  segments: PathSegment[],
+): boolean {
+  if (segments.length === 0) return false;
+
+  let current = obj;
+  let modified = false;
+
+  for (let i = 0; i < segments.length; i++) {
+    const segment = segments[i];
+    const isLast = i === segments.length - 1;
+    const nextSegment = segments[i + 1];
+
+    const getDefaultValue = () => {
+      if (isLast) {
+        return "";
+      }
+      if (nextSegment?.type === "item") {
+        return [];
+      }
+      return {};
+    };
+
+    if (segment.type === "item" && segment.index !== undefined) {
+      if (!Array.isArray(current)) {
+        return modified;
+      }
+
+      while (current.length <= segment.index) {
+        current.push(isLast ? "" : {});
+        modified = true;
+      }
+
+      if (!isLast) {
+        if (
+          current[segment.index] === undefined ||
+          current[segment.index] === null
+        ) {
+          current[segment.index] = getDefaultValue();
+          modified = true;
+        }
+        current = current[segment.index];
+      }
+    } else {
+      if (!(segment.key in current)) {
+        current[segment.key] = getDefaultValue();
+        modified = true;
+      } else if (!isLast && current[segment.key] === undefined) {
+        current[segment.key] = getDefaultValue();
+        modified = true;
+      }
+
+      if (!isLast) {
+        current = current[segment.key];
+      }
+    }
+  }
+
+  return modified;
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/index.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/index.ts
new file mode 100644
index 0000000000..c25af0b231
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/index.ts
@@ -0,0 +1,3 @@
+export { FormRenderer } from "./FormRenderer";
+export { default as Form } from "./registry";
+export type { ExtendedFormContextType } from "./types";
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/registry/Form.tsx b/autogpt_platform/frontend/src/components/renderers/InputRenderer/registry/Form.tsx
new file mode 100644
index 0000000000..5bf720a994
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/registry/Form.tsx
@@ -0,0 +1,23 @@
+import { ComponentType } from "react";
+import { FormProps, withTheme, ThemeProps } from "@rjsf/core";
+import {
+  generateBaseFields,
+  generateBaseTemplates,
+  generateBaseWidgets,
+} from "../base/base-registry";
+import { generateCustomFields } from "../custom/custom-registry";
+
+export function generateForm(): ComponentType<FormProps> {
+  const theme: ThemeProps = {
+    templates: generateBaseTemplates(),
+    widgets: generateBaseWidgets(),
+    fields: {
+      ...generateBaseFields(),
+      ...generateCustomFields(),
+    },
+  };
+
+  return withTheme(theme);
+}
+
+export default generateForm();
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/registry/index.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/registry/index.ts
new file mode 100644
index 0000000000..641c2a97d6
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/registry/index.ts
@@ -0,0 +1,10 @@
+export { default, generateForm } from "./Form";
+export {
+  generateBaseFields,
+  generateBaseTemplates,
+  generateBaseWidgets,
+} from "../base/base-registry";
+export {
+  generateCustomFields,
+  findCustomFieldId,
+} from "../custom/custom-registry";
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/registry/types.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/registry/types.ts
new file mode 100644
index 0000000000..cab84afcc3
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/registry/types.ts
@@ -0,0 +1,7 @@
+import { BlockUIType } from "@/app/(platform)/build/components/types";
+
+export type ExtraContext = {
+  nodeId?: string;
+  uiType?: BlockUIType;
+  size?: "small" | "medium" | "large";
+};
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/types.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/types.ts
new file mode 100644
index 0000000000..e667e27e2d
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/types.ts
@@ -0,0 +1,16 @@
+import { BlockUIType } from "@/lib/autogpt-server-api/types";
+import { FormContextType } from "@rjsf/utils";
+
+export interface ExtendedFormContextType extends FormContextType {
+  nodeId?: string;
+  uiType?: BlockUIType;
+  showHandles?: boolean;
+  size?: "small" | "medium" | "large";
+  showOptionalToggle?: boolean;
+}
+
+export type PathSegment = {
+  key: string;
+  type: "property" | "item" | "additional" | "normal";
+  index?: number;
+};
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/utils/custom-validator.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/utils/custom-validator.ts
similarity index 100%
rename from autogpt_platform/frontend/src/components/renderers/input-renderer/utils/custom-validator.ts
rename to autogpt_platform/frontend/src/components/renderers/InputRenderer/utils/custom-validator.ts
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/utils/generate-ui-schema.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/utils/generate-ui-schema.ts
new file mode 100644
index 0000000000..4012c39068
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/utils/generate-ui-schema.ts
@@ -0,0 +1,199 @@
+import { RJSFSchema, UiSchema } from "@rjsf/utils";
+import {
+  findCustomFieldId,
+  JSON_TEXT_FIELD_ID,
+} from "../custom/custom-registry";
+
+function isComplexType(schema: RJSFSchema): boolean {
+  return schema.type === "object" || schema.type === "array";
+}
+
+function hasComplexAnyOfOptions(schema: RJSFSchema): boolean {
+  const options = schema.anyOf || schema.oneOf;
+  if (!Array.isArray(options)) return false;
+  return options.some(
+    (opt: any) =>
+      opt &&
+      typeof opt === "object" &&
+      (opt.type === "object" || opt.type === "array"),
+  );
+}
+
+/**
+ * Generates uiSchema with ui:field settings for custom fields based on schema matchers.
+ * This is the standard RJSF way to route fields to custom components.
+ *
+ * Nested complex types (arrays/objects inside arrays/objects) are rendered as JsonTextField
+ * to avoid deeply nested form UIs. Users can enter raw JSON for these fields.
+ *
+ * @param schema - The JSON schema
+ * @param existingUiSchema - Existing uiSchema to merge with
+ * @param insideComplexType - Whether we're already inside a complex type (object/array)
+ */
+export function generateUiSchemaForCustomFields(
+  schema: RJSFSchema,
+  existingUiSchema: UiSchema = {},
+  insideComplexType: boolean = false,
+): UiSchema {
+  const uiSchema: UiSchema = { ...existingUiSchema };
+
+  if (schema.properties) {
+    for (const [key, propSchema] of Object.entries(schema.properties)) {
+      if (propSchema && typeof propSchema === "object") {
+        // First check for custom field matchers (credentials, google drive, etc.)
+        const customFieldId = findCustomFieldId(propSchema);
+
+        if (customFieldId) {
+          uiSchema[key] = {
+            ...(uiSchema[key] as object),
+            "ui:field": customFieldId,
+          };
+          // Skip further processing for custom fields
+          continue;
+        }
+
+        // Handle nested complex types - render as JsonTextField
+        if (insideComplexType && isComplexType(propSchema as RJSFSchema)) {
+          uiSchema[key] = {
+            ...(uiSchema[key] as object),
+            "ui:field": JSON_TEXT_FIELD_ID,
+          };
+          // Don't recurse further - this field is now a text input
+          continue;
+        }
+
+        // Handle anyOf/oneOf inside complex types
+        if (
+          insideComplexType &&
+          hasComplexAnyOfOptions(propSchema as RJSFSchema)
+        ) {
+          uiSchema[key] = {
+            ...(uiSchema[key] as object),
+            "ui:field": JSON_TEXT_FIELD_ID,
+          };
+          continue;
+        }
+
+        // Recurse into object properties
+        if (
+          propSchema.type === "object" &&
+          propSchema.properties &&
+          typeof propSchema.properties === "object"
+        ) {
+          const nestedUiSchema = generateUiSchemaForCustomFields(
+            propSchema as RJSFSchema,
+            (uiSchema[key] as UiSchema) || {},
+            true, // Now inside a complex type
+          );
+          uiSchema[key] = {
+            ...(uiSchema[key] as object),
+            ...nestedUiSchema,
+          };
+        }
+
+        // Handle arrays
+        if (propSchema.type === "array" && propSchema.items) {
+          const itemsSchema = propSchema.items as RJSFSchema;
+          if (itemsSchema && typeof itemsSchema === "object") {
+            // Check for custom field on array items
+            const itemsCustomFieldId = findCustomFieldId(itemsSchema);
+            if (itemsCustomFieldId) {
+              uiSchema[key] = {
+                ...(uiSchema[key] as object),
+                items: {
+                  "ui:field": itemsCustomFieldId,
+                },
+              };
+            } else if (isComplexType(itemsSchema)) {
+              // Array items that are complex types become JsonTextField
+              uiSchema[key] = {
+                ...(uiSchema[key] as object),
+                items: {
+                  "ui:field": JSON_TEXT_FIELD_ID,
+                },
+              };
+            } else if (hasComplexAnyOfOptions(itemsSchema)) {
+              // Array items with anyOf containing complex types become JsonTextField
+              uiSchema[key] = {
+                ...(uiSchema[key] as object),
+                items: {
+                  "ui:field": JSON_TEXT_FIELD_ID,
+                },
+              };
+            } else if (itemsSchema.properties) {
+              // Recurse into object items (but they're now inside a complex type)
+              const itemsUiSchema = generateUiSchemaForCustomFields(
+                itemsSchema,
+                ((uiSchema[key] as UiSchema)?.items as UiSchema) || {},
+                true, // Inside complex type (array)
+              );
+              if (Object.keys(itemsUiSchema).length > 0) {
+                uiSchema[key] = {
+                  ...(uiSchema[key] as object),
+                  items: itemsUiSchema,
+                };
+              }
+            }
+          }
+        }
+
+        // Handle anyOf/oneOf at root level - process complex options
+        if (!insideComplexType) {
+          const anyOfOptions = propSchema.anyOf || propSchema.oneOf;
+
+          if (Array.isArray(anyOfOptions)) {
+            for (let i = 0; i < anyOfOptions.length; i++) {
+              const option = anyOfOptions[i] as RJSFSchema;
+              if (option && typeof option === "object") {
+                // Handle anyOf array options with complex items
+                if (option.type === "array" && option.items) {
+                  const itemsSchema = option.items as RJSFSchema;
+                  if (itemsSchema && typeof itemsSchema === "object") {
+                    // Array items that are complex types become JsonTextField
+                    if (isComplexType(itemsSchema)) {
+                      uiSchema[key] = {
+                        ...(uiSchema[key] as object),
+                        items: {
+                          "ui:field": JSON_TEXT_FIELD_ID,
+                        },
+                      };
+                    } else if (hasComplexAnyOfOptions(itemsSchema)) {
+                      uiSchema[key] = {
+                        ...(uiSchema[key] as object),
+                        items: {
+                          "ui:field": JSON_TEXT_FIELD_ID,
+                        },
+                      };
+                    }
+                  }
+                }
+
+                // Recurse into anyOf object options with properties
+                if (
+                  option.type === "object" &&
+                  option.properties &&
+                  typeof option.properties === "object"
+                ) {
+                  const optionUiSchema = generateUiSchemaForCustomFields(
+                    option,
+                    {},
+                    true, // Inside complex type (anyOf object option)
+                  );
+                  if (Object.keys(optionUiSchema).length > 0) {
+                    // Store under the property key - RJSF will apply it
+                    uiSchema[key] = {
+                      ...(uiSchema[key] as object),
+                      ...optionUiSchema,
+                    };
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+
+  return uiSchema;
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/utils/helpers.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/utils/helpers.ts
similarity index 100%
rename from autogpt_platform/frontend/src/components/renderers/input-renderer/utils/helpers.ts
rename to autogpt_platform/frontend/src/components/renderers/InputRenderer/utils/helpers.ts
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/utils/input-schema-pre-processor.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/utils/input-schema-pre-processor.ts
similarity index 97%
rename from autogpt_platform/frontend/src/components/renderers/input-renderer/utils/input-schema-pre-processor.ts
rename to autogpt_platform/frontend/src/components/renderers/InputRenderer/utils/input-schema-pre-processor.ts
index ffbcbf52b2..9d1aa2c60c 100644
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/utils/input-schema-pre-processor.ts
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/utils/input-schema-pre-processor.ts
@@ -4,6 +4,7 @@ import { RJSFSchema } from "@rjsf/utils";
  * Pre-processes the input schema to ensure all properties have a type defined.
  * If a property doesn't have a type, it assigns a union of all supported JSON Schema types.
  */
+
 export function preprocessInputSchema(schema: RJSFSchema): RJSFSchema {
   if (!schema || typeof schema !== "object") {
     return schema;
@@ -32,7 +33,7 @@ export function preprocessInputSchema(schema: RJSFSchema): RJSFSchema {
             { type: "integer" },
             { type: "boolean" },
             { type: "array", items: { type: "string" } },
-            { type: "object" },
+            { type: "object", title: "Object", additionalProperties: true },
             { type: "null" },
           ];
         }
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/utils/rjsf-utils.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/utils/rjsf-utils.ts
new file mode 100644
index 0000000000..365058cebd
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/utils/rjsf-utils.ts
@@ -0,0 +1,6 @@
+import { type ClassValue, clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}
diff --git a/autogpt_platform/frontend/src/components/renderers/InputRenderer/utils/schema-utils.ts b/autogpt_platform/frontend/src/components/renderers/InputRenderer/utils/schema-utils.ts
new file mode 100644
index 0000000000..c7dd9680d7
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/renderers/InputRenderer/utils/schema-utils.ts
@@ -0,0 +1,92 @@
+import { getUiOptions, RJSFSchema, UiSchema } from "@rjsf/utils";
+
+export function isAnyOfSchema(schema: RJSFSchema | undefined): boolean {
+  return (
+    Array.isArray(schema?.anyOf) &&
+    schema!.anyOf.length > 0 &&
+    schema?.enum === undefined
+  );
+}
+
+export const isAnyOfChild = (
+  uiSchema: UiSchema<any, RJSFSchema, any> | undefined,
+): boolean => {
+  const uiOptions = getUiOptions(uiSchema);
+  return uiOptions.label === false;
+};
+
+export function isOptionalType(schema: RJSFSchema | undefined): {
+  isOptional: boolean;
+  type?: any;
+} {
+  if (
+    !Array.isArray(schema?.anyOf) ||
+    schema!.anyOf.length !== 2 ||
+    !schema!.anyOf.some((opt: any) => opt.type === "null")
+  ) {
+    return { isOptional: false };
+  }
+
+  const nonNullType = schema!.anyOf?.find((opt: any) => opt.type !== "null");
+
+  return {
+    isOptional: true,
+    type: nonNullType,
+  };
+}
+export function isAnyOfSelector(name: string) {
+  return name.includes("anyof_select");
+}
+
+export function isMultiSelectSchema(schema: RJSFSchema | undefined): boolean {
+  if (typeof schema !== "object" || schema === null) {
+    return false;
+  }
+
+  if ("anyOf" in schema || "oneOf" in schema) {
+    return false;
+  }
+
+  return !!(
+    schema.type === "object" &&
+    schema.properties &&
+    Object.values(schema.properties).every(
+      (prop: any) => prop.type === "boolean",
+    )
+  );
+}
+
+const isGoogleDriveFileObject = (obj: RJSFSchema): boolean => {
+  if (obj.type !== "object" || !obj.properties) {
+    return false;
+  }
+  const props = obj.properties;
+  const hasId = "id" in props;
+  const hasMimeType = "mimeType" in props || "mime_type" in props;
+  const hasIconUrl = "iconUrl" in props || "icon_url" in props;
+  const hasIsFolder = "isFolder" in props || "is_folder" in props;
+  return hasId && hasMimeType && (hasIconUrl || hasIsFolder);
+};
+
+export const isGoogleDrivePickerSchema = (
+  schema: RJSFSchema | undefined,
+): boolean => {
+  if (!schema) {
+    return false;
+  }
+
+  // highest priority
+  if (
+    "google_drive_picker_config" in schema ||
+    ("format" in schema && schema.format === "google-drive-picker")
+  ) {
+    return true;
+  }
+
+  // In the Input type block, we do not add the format for the GoogleFile field, so we need to include this extra check.
+  if (isGoogleDriveFileObject(schema)) {
+    return true;
+  }
+
+  return false;
+};
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/ARCHITECTURE_INPUT_RENDERER.md b/autogpt_platform/frontend/src/components/renderers/input-renderer/ARCHITECTURE_INPUT_RENDERER.md
deleted file mode 100644
index 7ae3d2b546..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/ARCHITECTURE_INPUT_RENDERER.md
+++ /dev/null
@@ -1,938 +0,0 @@
-# Input-Renderer Architecture Documentation
-
-## Overview
-
-The Input-Renderer is a **JSON Schema-based form generation system** built on top of **React JSON Schema Form (RJSF)**. It dynamically creates form inputs for block nodes in the FlowEditor based on JSON schemas defined in the backend.
-
-This system allows blocks to define their input requirements declaratively, and the frontend automatically generates appropriate UI components.
-
----
-
-## High-Level Architecture
-
-```
-┌─────────────────────────────────────────────────────────┐
-│                    FormRenderer                         │
-│         (Entry point, wraps RJSF Form)                 │
-└─────────────────────┬───────────────────────────────────┘
-                      │
-            ┌─────────▼─────────┐
-            │   RJSF Core       │
-            │   <Form />        │
-            └───────┬───────────┘
-                    │
-        ┌───────────┼───────────┬──────────────┐
-        │           │           │              │
-   ┌────▼────┐ ┌───▼────┐ ┌────▼─────┐  ┌────▼────┐
-   │ Fields  │ │Templates│ │ Widgets  │  │ Schemas │
-   └─────────┘ └─────────┘ └──────────┘  └─────────┘
-        │           │           │              │
-        │           │           │              │
-    Handles     Wrapper      Actual       JSON Schema
-    complex     layouts      input       (from backend)
-    types       & labels    components
-```
-
----
-
-## What is RJSF (React JSON Schema Form)?
-
-**RJSF** is a library that generates React forms from JSON Schema definitions. It follows a specific hierarchy to render forms:
-
-### **RJSF Rendering Flow:**
-
-```
-1. JSON Schema (defines data structure)
-   ↓
-2. Schema Field (decides which Field component to use)
-   ↓
-3. Field Component (handles specific type logic)
-   ↓
-4. Field Template (wraps field with label, description)
-   ↓
-5. Widget (actual input element - TextInput, Select, etc.)
-```
-
-### **Example Flow:**
-
-```json
-// JSON Schema
-{
-  "type": "object",
-  "properties": {
-    "name": {
-      "type": "string",
-      "title": "Name"
-    }
-  }
-}
-```
-
-**Becomes:**
-
-```
-SchemaField (detects "string" type)
-   ↓
-StringField (default RJSF field)
-   ↓
-FieldTemplate (adds label "Name")
-   ↓
-TextWidget (renders <input type="text" />)
-```
-
----
-
-## Core Components of Input-Renderer
-
-### 1. **FormRenderer** (`FormRenderer.tsx`)
-
-The main entry point that wraps RJSF `<Form />` component.
-
-```typescript
-export const FormRenderer = ({
-  jsonSchema,        // JSON Schema from backend
-  handleChange,      // Callback when form changes
-  uiSchema,          // UI customization
-  initialValues,     // Pre-filled values
-  formContext,       // Extra context (nodeId, uiType, etc.)
-}: FormRendererProps) => {
-  const preprocessedSchema = preprocessInputSchema(jsonSchema);
-
-  return (
-    <Form
-      schema={preprocessedSchema}      // Modified schema
-      validator={customValidator}      // Custom validation logic
-      fields={fields}                  // Custom field components
-      templates={templates}            // Custom layout templates
-      widgets={widgets}                // Custom input widgets
-      formContext={formContext}        // Pass context down
-      onChange={handleChange}          // Form change handler
-      uiSchema={uiSchema}             // UI customization
-      formData={initialValues}        // Initial values
-    />
-  );
-};
-```
-
-**Key Props:**
-
-- **`fields`** - Custom components for complex types (anyOf, credentials, objects)
-- **`templates`** - Layout wrappers (FieldTemplate, ArrayFieldTemplate)
-- **`widgets`** - Actual input components (TextInput, Select, FileWidget)
-- **`formContext`** - Shared data (nodeId, showHandles, size)
-
----
-
-### 2. **Schema Pre-Processing** (`utils/input-schema-pre-processor.ts`)
-
-Before rendering, schemas are transformed to ensure RJSF compatibility.
-
-**Purpose:**
-
-- Add missing `type` fields (prevents RJSF errors)
-- Recursively process nested objects and arrays
-- Normalize inconsistent schemas from backend
-
-**Example:**
-
-```typescript
-// Backend schema (missing type)
-{
-  "properties": {
-    "value": {}  // No type defined!
-  }
-}
-
-// After pre-processing
-{
-  "properties": {
-    "value": {
-      "anyOf": [
-        { "type": "string" },
-        { "type": "number" },
-        { "type": "boolean" },
-        // ... all possible types
-      ]
-    }
-  }
-}
-```
-
-**Why?** RJSF requires explicit types. Without this, it would crash or render incorrectly.
-
----
-
-## The Three Pillars: Fields, Templates, Widgets
-
-### **A. Fields** (`fields/`)
-
-Fields handle **complex type logic** that goes beyond simple inputs.
-
-**Registered Fields:**
-
-```typescript
-export const fields: RegistryFieldsType = {
-  AnyOfField: AnyOfField, // Handles anyOf/oneOf
-  credentials: CredentialsField, // OAuth/API key handling
-  ObjectField: ObjectField, // Free-form objects
-};
-```
-
-#### **1. AnyOfField** (`fields/AnyOfField/AnyOfField.tsx`)
-
-Handles schemas with multiple possible types (union types).
-
-**When Used:**
-
-```json
-{
-  "anyOf": [{ "type": "string" }, { "type": "number" }, { "type": "boolean" }]
-}
-```
-
-**Rendering:**
-
-```
-┌─────────────────────────────────────┐
-│ Parameter Name (string) ▼           │ ← Type selector dropdown
-├─────────────────────────────────────┤
-│ [Text Input]                        │ ← Widget for selected type
-└─────────────────────────────────────┘
-```
-
-**Features:**
-
-- Type selector dropdown
-- Nullable types (with toggle switch)
-- Recursive rendering (can contain arrays, objects)
-- Connection-aware (hides input when connected)
-
-**Special Case: Nullable Types**
-
-```json
-{
-  "anyOf": [{ "type": "string" }, { "type": "null" }]
-}
-```
-
-**Renders as:**
-
-```
-┌─────────────────────────────────────┐
-│ Parameter Name (string | null) [✓]  │ ← Toggle switch
-├─────────────────────────────────────┤
-│ [Text Input] (only if enabled)      │
-└─────────────────────────────────────┘
-```
-
----
-
-#### **2. CredentialsField** (`fields/CredentialField/CredentialField.tsx`)
-
-Handles authentication credentials (OAuth, API Keys, Passwords).
-
-**When Used:**
-
-```json
-{
-  "type": "object",
-  "credentials": {
-    "provider": "google",
-    "scopes": ["email", "profile"]
-  }
-}
-```
-
-**Flow:**
-
-```
-1. Renders SelectCredential dropdown
-   ↓
-2. User selects existing credential OR clicks "Add New"
-   ↓
-3. Modal opens (OAuthModal/APIKeyModal/PasswordModal)
-   ↓
-4. User authorizes/enters credentials
-   ↓
-5. Credential saved to backend
-   ↓
-6. Dropdown shows selected credential
-```
-
-**Credential Types:**
-
-- **OAuth** - 3rd party authorization (Google, GitHub, etc.)
-- **API Key** - Simple key-based auth
-- **Password** - Username/password pairs
-
----
-
-#### **3. ObjectField** (`fields/ObjectField.tsx`)
-
-Handles free-form objects (key-value pairs).
-
-**When Used:**
-
-```json
-{
-  "type": "object",
-  "additionalProperties": true // Free-form
-}
-```
-
-vs
-
-```json
-{
-  "type": "object",
-  "properties": {
-    "name": { "type": "string" } // Fixed schema
-  }
-}
-```
-
-**Behavior:**
-
-- **Fixed schema** → Uses default RJSF rendering
-- **Free-form** → Uses ObjectEditorWidget (JSON editor)
-
----
-
-### **B. Templates** (`templates/`)
-
-Templates control **layout and wrapping** of fields.
-
-#### **1. FieldTemplate** (`templates/FieldTemplate.tsx`)
-
-Wraps every field with label, type indicator, and connection handle.
-
-**Rendering Structure:**
-
-```
-┌────────────────────────────────────────┐
-│ ○ Label (type) ⓘ                      │ ← Handle + Label + Type + Info icon
-├────────────────────────────────────────┤
-│   [Actual Input Widget]                │ ← The input itself
-└────────────────────────────────────────┘
-```
-
-**Responsibilities:**
-
-- Shows/hides input based on connection status
-- Renders connection handle (NodeHandle)
-- Displays type information
-- Shows tooltip with description
-- Handles "advanced" field visibility
-- Formats credential field labels
-
-**Key Logic:**
-
-```typescript
-// Hide input if connected
-{(isAnyOf || !isConnected) && (
-  <div>{children}</div>
-)}
-
-// Show handle for most fields
-{shouldShowHandle && (
-  <NodeHandle handleId={handleId} isConnected={isConnected} />
-)}
-```
-
-**Context-Aware Behavior:**
-
-- Inside `AnyOfField` → No handle (parent handles it)
-- Credential field → Special label formatting
-- Array item → Uses parent handle
-- INPUT/OUTPUT/WEBHOOK blocks → Different handle positioning
-
----
-
-#### **2. ArrayFieldTemplate** (`templates/ArrayFieldTemplate.tsx`)
-
-Wraps array fields to use custom ArrayEditorWidget.
-
-**Simple Wrapper:**
-
-```typescript
-function ArrayFieldTemplate(props: ArrayFieldTemplateProps) {
-  const { items, canAdd, onAddClick, nodeId } = props;
-
-  return (
-    <ArrayEditorWidget
-      items={items}
-      nodeId={nodeId}
-      canAdd={canAdd}
-      onAddClick={onAddClick}
-    />
-  );
-}
-```
-
----
-
-### **C. Widgets** (`widgets/`)
-
-Widgets are **actual input components** - the final rendered HTML elements.
-
-**Registered Widgets:**
-
-```typescript
-export const widgets: RegistryWidgetsType = {
-  TextWidget: TextInputWidget, // <input type="text" />
-  SelectWidget: SelectWidget, // <select> dropdown
-  CheckboxWidget: SwitchWidget, // <Switch> toggle
-  FileWidget: FileWidget, // File upload
-  DateWidget: DateInputWidget, // Date picker
-  TimeWidget: TimeInputWidget, // Time picker
-  DateTimeWidget: DateTimeInputWidget, // Combined date+time
-};
-```
-
-#### **Widget Selection Logic (RJSF)**
-
-RJSF automatically picks the right widget based on schema:
-
-```json
-{ "type": "string" }                    → TextWidget
-{ "type": "string", "enum": [...] }     → SelectWidget
-{ "type": "boolean" }                   → CheckboxWidget
-{ "type": "string", "format": "date" }  → DateWidget
-{ "type": "string", "format": "time" }  → TimeWidget
-```
-
-#### **Special Widgets:**
-
-**1. ArrayEditorWidget** (`widgets/ArrayEditorWidget/`)
-
-```
-┌─────────────────────────────────────┐
-│ ○ Item 1 [Text Input]  [X Remove]  │
-│ ○ Item 2 [Text Input]  [X Remove]  │
-│ [+ Add Item]                        │
-└─────────────────────────────────────┘
-```
-
-**Features:**
-
-- Each array item gets its own connection handle
-- Remove button per item
-- Add button at bottom
-- Context provider for handle management
-
-**ArrayEditorContext:**
-
-```typescript
-{
-  isArrayItem: true,
-  arrayFieldHandleId: "input-items-0", // Unique per item
-  isConnected: false
-}
-```
-
-**2. ObjectEditorWidget** (`widgets/ObjectEditorWidget/`)
-
-- JSON editor for free-form objects
-- Key-value pair management
-- Used by ObjectField for `additionalProperties: true`
-
----
-
-## The Complete Rendering Flow
-
-### **Example: Rendering a Text Input**
-
-```json
-// Backend Schema
-{
-  "type": "object",
-  "properties": {
-    "message": {
-      "type": "string",
-      "title": "Message",
-      "description": "Enter your message"
-    }
-  }
-}
-```
-
-**Step-by-Step:**
-
-```
-1. FormRenderer receives schema
-   ↓
-2. preprocessInputSchema() normalizes it
-   ↓
-3. RJSF <Form /> starts rendering
-   ↓
-4. SchemaField detects "string" type
-   ↓
-5. Uses default StringField
-   ↓
-6. FieldTemplate wraps it:
-   - Adds NodeHandle (connection point)
-   - Adds label "Message (string)"
-   - Adds info icon with description
-   ↓
-7. TextWidget renders <input />
-   ↓
-8. User types "Hello"
-   ↓
-9. onChange callback fires
-   ↓
-10. FormCreator updates nodeStore.updateNodeData()
-```
-
----
-
-### **Example: Rendering AnyOf Field**
-
-```json
-// Backend Schema
-{
-  "anyOf": [{ "type": "string" }, { "type": "number" }],
-  "title": "Value"
-}
-```
-
-**Rendering Flow:**
-
-```
-1. RJSF detects "anyOf"
-   ↓
-2. Uses AnyOfField (custom field)
-   ↓
-3. AnyOfField renders:
-   ┌─────────────────────────────────┐
-   │ ○ Value (string) ▼              │ ← Self-managed handle & selector
-   ├─────────────────────────────────┤
-   │   [Text Input]                  │ ← Recursively renders SchemaField
-   └─────────────────────────────────┘
-   ↓
-4. User changes type to "number"
-   ↓
-5. AnyOfField re-renders with NumberWidget
-   ↓
-6. User enters "42"
-   ↓
-7. onChange({ type: "number", value: 42 })
-```
-
-**Key Point:** AnyOfField **does NOT use FieldTemplate** for itself. It manages its own handle and label to avoid duplication. But it **recursively calls SchemaField** for the selected type, which may use FieldTemplate.
-
----
-
-### **Example: Rendering Array Field**
-
-```json
-// Backend Schema
-{
-  "type": "array",
-  "items": {
-    "type": "string"
-  },
-  "title": "Tags"
-}
-```
-
-**Rendering Flow:**
-
-```
-1. RJSF detects "array" type
-   ↓
-2. Uses ArrayFieldTemplate
-   ↓
-3. ArrayFieldTemplate passes to ArrayEditorWidget
-   ↓
-4. ArrayEditorWidget renders:
-   ┌─────────────────────────────────┐
-   │ ○ Tag 1 [Text Input] [X]        │ ← Each item wrapped in context
-   │ ○ Tag 2 [Text Input] [X]        │
-   │ [+ Add Item]                    │
-   └─────────────────────────────────┘
-   ↓
-5. Each item wrapped in ArrayEditorContext
-   ↓
-6. FieldTemplate reads context:
-   - isArrayItem = true
-   - Uses arrayFieldHandleId instead of own handle
-   ↓
-7. TextWidget renders for each item
-```
-
----
-
-## Hierarchy: What Comes First?
-
-This is the **order of execution** from schema to rendered input:
-
-```
-1. JSON Schema (from backend)
-   ↓
-2. preprocessInputSchema() (normalization)
-   ↓
-3. RJSF <Form /> (library entry point)
-   ↓
-4. SchemaField (RJSF internal - decides which field)
-   ↓
-5. Field Component (AnyOfField, CredentialsField, or default)
-   ↓
-6. Template (FieldTemplate or ArrayFieldTemplate)
-   ↓
-7. Widget (TextWidget, SelectWidget, etc.)
-   ↓
-8. Actual HTML (<input>, <select>, etc.)
-```
-
----
-
-## Key Concepts Explained
-
-### **1. Why Custom Fields?**
-
-RJSF's default fields don't handle:
-
-- **AnyOf** - Type selection + dynamic widget switching
-- **Credentials** - OAuth flows, modal management
-- **Free-form Objects** - JSON editor instead of fixed fields
-
-Custom fields fill these gaps.
-
----
-
-### **2. Why Templates?**
-
-Templates add **FlowEditor-specific UI**:
-
-- Connection handles (left side dots)
-- Type indicators
-- Tooltips
-- Advanced field hiding
-- Connection-aware rendering
-
-Default RJSF templates don't support these features.
-
----
-
-### **3. Why Custom Widgets?**
-
-Custom widgets provide:
-
-- Consistent styling with design system
-- Integration with Zustand stores
-- Custom behaviors (e.g., FileWidget uploads)
-- Better UX (e.g., SwitchWidget vs checkbox)
-
----
-
-### **4. FormContext - The Shared State**
-
-FormContext passes data down the RJSF tree:
-
-```typescript
-type FormContextType = {
-  nodeId?: string; // Which node this form belongs to
-  uiType?: BlockUIType; // Block type (INPUT, OUTPUT, etc.)
-  showHandles?: boolean; // Show connection handles?
-  size?: "small" | "large"; // Form size variant
-};
-```
-
-**Why?** RJSF components don't have direct access to React props from parent. FormContext provides a channel.
-
-**Usage:**
-
-```typescript
-// In FieldTemplate
-const { nodeId, showHandles, size } = formContext;
-
-// Check if input is connected
-const isConnected = useEdgeStore().isInputConnected(nodeId, handleId);
-
-// Hide input if connected
-{!isConnected && <div>{children}</div>}
-```
-
----
-
-### **5. Handle Management**
-
-Connection handles are the **left-side dots** on nodes where edges connect.
-
-**Handle ID Format:**
-
-```typescript
-// Regular field
-generateHandleId("root_message") → "input-message"
-
-// Array item
-generateHandleId("root_tags", ["0"]) → "input-tags-0"
-generateHandleId("root_tags", ["1"]) → "input-tags-1"
-
-// Nested field
-generateHandleId("root_config_api_key") → "input-config-api_key"
-```
-
-**Context Provider Pattern (Arrays):**
-
-```typescript
-// ArrayEditorWidget wraps each item
-<ArrayEditorContext.Provider
-  value={{
-    isArrayItem: true,
-    arrayFieldHandleId: "input-tags-0"
-  }}
->
-  {element.children}  // ← FieldTemplate renders here
-</ArrayEditorContext.Provider>
-
-// FieldTemplate reads context
-const { isArrayItem, arrayFieldHandleId } = useContext(ArrayEditorContext);
-
-// Use array handle instead of generating own
-const handleId = isArrayItem ? arrayFieldHandleId : generateHandleId(fieldId);
-```
-
----
-
-## Connection-Aware Rendering
-
-One of the most important features: **hiding inputs when connected**.
-
-**Flow:**
-
-```
-1. User connects edge to input handle
-   ↓
-2. edgeStore.addEdge() creates connection
-   ↓
-3. Next render cycle:
-   - FieldTemplate calls isInputConnected(nodeId, handleId)
-   - Returns true
-   ↓
-4. FieldTemplate hides input:
-   {!isConnected && <div>{children}</div>}
-   ↓
-5. Only handle visible (with blue highlight)
-```
-
-**Why?** When a value comes from another node's output, manual input is disabled. The connection provides the value.
-
-**Exception:** AnyOf fields still show type selector when connected (but hide the input).
-
----
-
-## Advanced Features
-
-### **1. Advanced Field Toggle**
-
-Some fields marked as `advanced: true` in schema are hidden by default.
-
-**Logic in FieldTemplate:**
-
-```typescript
-const showAdvanced = useNodeStore((state) => state.nodeAdvancedStates[nodeId]);
-
-if (!showAdvanced && schema.advanced === true && !isConnected) {
-  return null; // Hide field
-}
-```
-
-**UI:** NodeAdvancedToggle button in CustomNode shows/hides these fields.
-
----
-
-### **2. Nullable Type Handling**
-
-```json
-{
-  "anyOf": [{ "type": "string" }, { "type": "null" }]
-}
-```
-
-**AnyOfField detects this pattern and renders:**
-
-```
-┌─────────────────────────────────────┐
-│ Parameter (string | null)  [✓]      │ ← Switch to enable/disable
-├─────────────────────────────────────┤
-│ [Input only if enabled]             │
-└─────────────────────────────────────┘
-```
-
-**State Management:**
-
-```typescript
-const [isEnabled, setIsEnabled] = useState(formData !== null);
-
-const handleNullableToggle = (checked: boolean) => {
-  setIsEnabled(checked);
-  onChange(checked ? "" : null); // Send null when disabled
-};
-```
-
----
-
-### **3. Recursive Schema Rendering**
-
-AnyOfField, ObjectField, and ArrayField all recursively call `SchemaField`:
-
-```typescript
-const SchemaField = registry.fields.SchemaField;
-
-<SchemaField
-  schema={nestedSchema}
-  formData={formData}
-  onChange={handleChange}
-  // ... propagate all props
-/>
-```
-
-This allows **infinite nesting**: arrays of objects, objects with anyOf fields, etc.
-
----
-
-## Common Patterns
-
-### **Adding a New Widget**
-
-1. Create widget component in `widgets/`:
-
-```typescript
-export const MyWidget = ({ value, onChange, ...props }: WidgetProps) => {
-  return <input value={value} onChange={(e) => onChange(e.target.value)} />;
-};
-```
-
-2. Register in `widgets/index.ts`:
-
-```typescript
-export const widgets: RegistryWidgetsType = {
-  // ...
-  MyCustomWidget: MyWidget,
-};
-```
-
-3. Use in uiSchema or schema format:
-
-```json
-{
-  "type": "string",
-  "format": "my-custom-format" // RJSF maps format → widget
-}
-```
-
----
-
-### **Adding a New Field**
-
-1. Create field component in `fields/`:
-
-```typescript
-export const MyField = ({ schema, formData, onChange, ...props }: FieldProps) => {
-  // Custom logic here
-  return <div>...</div>;
-};
-```
-
-2. Register in `fields/index.ts`:
-
-```typescript
-export const fields: RegistryFieldsType = {
-  // ...
-  MyField: MyField,
-};
-```
-
-3. RJSF uses it based on schema structure (e.g., custom keyword).
-
----
-
-## Integration with FlowEditor
-
-```
-CustomNode
-    ↓
-FormCreator
-    ↓
-FormRenderer  ← YOU ARE HERE
-    ↓
-RJSF <Form />
-    ↓
-(Fields, Templates, Widgets)
-    ↓
-User Input
-    ↓
-onChange callback
-    ↓
-FormCreator.handleChange()
-    ↓
-nodeStore.updateNodeData(nodeId, { hardcodedValues })
-    ↓
-historyStore.pushState() (undo/redo)
-```
-
----
-
-## Debugging Tips
-
-### **Field Not Rendering**
-
-- Check if `preprocessInputSchema()` is handling it correctly
-- Verify schema has `type` field
-- Check RJSF console for validation errors
-
-### **Widget Wrong Type**
-
-- Check schema `type` and `format` fields
-- Verify widget is registered in `widgets/index.ts`
-- Check if custom field is overriding default behavior
-
-### **Handle Not Appearing**
-
-- Check `showHandles` in formContext
-- Verify not inside `fromAnyOf` context
-- Check if field is credential or array item
-
-### **Value Not Saving**
-
-- Verify `onChange` callback is firing
-- Check `handleChange` in FormCreator
-- Look for console errors in `updateNodeData`
-
----
-
-## Summary
-
-The Input-Renderer is a sophisticated form system that:
-
-1. **Uses RJSF** as the foundation for JSON Schema → React forms
-2. **Extends RJSF** with custom Fields, Templates, and Widgets
-3. **Integrates** with FlowEditor's connection system
-4. **Handles** complex types (anyOf, credentials, free-form objects)
-5. **Provides** connection-aware, type-safe input rendering
-
-**Key Hierarchy (What Comes First):**
-
-```
-JSON Schema
-  → Pre-processing
-    → RJSF Form
-      → SchemaField (RJSF internal)
-        → Field (AnyOfField, CredentialsField, etc.)
-          → Template (FieldTemplate, ArrayFieldTemplate)
-            → Widget (TextWidget, SelectWidget, etc.)
-              → HTML Element
-```
-
-**Mental Model:**
-
-- **Fields** = Smart logic layers (type selection, OAuth flows)
-- **Templates** = Layout wrappers (handles, labels, tooltips)
-- **Widgets** = Actual inputs (text boxes, dropdowns)
-
-**Integration Point:**
-
-- FormRenderer receives schema from `node.data.inputSchema`
-- User edits form → `onChange` → `nodeStore.updateNodeData()`
-- Values saved as `node.data.hardcodedValues`
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/AnyOfField/AnyOfField.tsx b/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/AnyOfField/AnyOfField.tsx
deleted file mode 100644
index 79fa15304d..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/AnyOfField/AnyOfField.tsx
+++ /dev/null
@@ -1,232 +0,0 @@
-import React from "react";
-import { FieldProps, RJSFSchema } from "@rjsf/utils";
-
-import { Text } from "@/components/atoms/Text/Text";
-import { Switch } from "@/components/atoms/Switch/Switch";
-import { Select } from "@/components/atoms/Select/Select";
-import {
-  InputType,
-  mapJsonSchemaTypeToInputType,
-} from "@/app/(platform)/build/components/FlowEditor/nodes/helpers";
-
-import { InfoIcon } from "@phosphor-icons/react";
-import { useAnyOfField } from "./useAnyOfField";
-import NodeHandle from "@/app/(platform)/build/components/FlowEditor/handlers/NodeHandle";
-import { useEdgeStore } from "@/app/(platform)/build/stores/edgeStore";
-import { generateHandleId } from "@/app/(platform)/build/components/FlowEditor/handlers/helpers";
-import { getTypeDisplayInfo } from "@/app/(platform)/build/components/FlowEditor/nodes/helpers";
-import merge from "lodash/merge";
-import {
-  Tooltip,
-  TooltipContent,
-  TooltipProvider,
-  TooltipTrigger,
-} from "@/components/atoms/Tooltip/BaseTooltip";
-import { cn } from "@/lib/utils";
-import { BlockUIType } from "@/app/(platform)/build/components/types";
-
-type TypeOption = {
-  type: string;
-  title: string;
-  index: number;
-  format?: string;
-  enum?: any[];
-  secret?: boolean;
-  schema: RJSFSchema;
-};
-
-export const AnyOfField = ({
-  schema,
-  formData,
-  onChange,
-  name,
-  idSchema,
-  formContext,
-  registry,
-  uiSchema,
-  disabled,
-  onBlur,
-  onFocus,
-}: FieldProps) => {
-  const handleId =
-    formContext.uiType === BlockUIType.AGENT
-      ? (idSchema.$id ?? "")
-          .split("_")
-          .filter((p) => p !== "root" && p !== "properties" && p.length > 0)
-          .join("_") || ""
-      : generateHandleId(idSchema.$id ?? "");
-
-  const updatedFormContexrt = { ...formContext, fromAnyOf: true };
-
-  const { nodeId, showHandles = true } = updatedFormContexrt;
-  const { isInputConnected } = useEdgeStore();
-  const isConnected = showHandles ? isInputConnected(nodeId, handleId) : false;
-  const {
-    isNullableType,
-    nonNull,
-    selectedType,
-    handleTypeChange,
-    handleNullableToggle,
-    handleValueChange,
-    currentTypeOption,
-    isEnabled,
-    typeOptions,
-  } = useAnyOfField(schema, formData, onChange);
-
-  const renderInput = (typeOption: TypeOption) => {
-    const optionSchema = (typeOption.schema || {
-      type: typeOption.type,
-      format: typeOption.format,
-      secret: typeOption.secret,
-      enum: typeOption.enum,
-    }) as RJSFSchema;
-    const inputType = mapJsonSchemaTypeToInputType(optionSchema);
-
-    // Help us to tell the field under the anyOf field that you are a part of anyOf field.
-    // We can't use formContext in this case that's why we are using this.
-    // We could use context api here, but i think it's better to keep it simple.
-    const uiSchemaFromAnyOf = merge({}, uiSchema, {
-      "ui:options": { fromAnyOf: true },
-    });
-
-    // We are using SchemaField to render the field recursively.
-    if (inputType === InputType.ARRAY_EDITOR) {
-      const SchemaField = registry.fields.SchemaField;
-      return (
-        <div className="-ml-2">
-          <SchemaField
-            schema={optionSchema}
-            formData={formData}
-            idSchema={idSchema}
-            uiSchema={uiSchemaFromAnyOf}
-            onChange={handleValueChange}
-            onBlur={onBlur}
-            onFocus={onFocus}
-            name={name}
-            registry={registry}
-            disabled={disabled}
-            formContext={updatedFormContexrt}
-          />
-        </div>
-      );
-    }
-
-    const SchemaField = registry.fields.SchemaField;
-    return (
-      <div className="-ml-2">
-        <SchemaField
-          schema={optionSchema}
-          formData={formData}
-          idSchema={idSchema}
-          uiSchema={uiSchemaFromAnyOf}
-          onChange={handleValueChange}
-          onBlur={onBlur}
-          onFocus={onFocus}
-          name={name}
-          registry={registry}
-          disabled={disabled}
-          formContext={updatedFormContexrt}
-        />
-      </div>
-    );
-  };
-
-  // I am doing this, because we need different UI for optional types.
-  if (isNullableType && nonNull) {
-    const { displayType, colorClass } = getTypeDisplayInfo(nonNull);
-
-    return (
-      <div className="mb-0 flex flex-col">
-        <div className="flex items-center justify-between gap-2">
-          <div
-            className={cn(
-              "ml-1 flex items-center gap-1",
-              showHandles && "-ml-2",
-            )}
-          >
-            {showHandles && (
-              <NodeHandle
-                handleId={handleId}
-                isConnected={isConnected}
-                side="left"
-              />
-            )}
-            <Text
-              variant={formContext.size === "small" ? "body" : "body-medium"}
-            >
-              {schema.title || name.charAt(0).toUpperCase() + name.slice(1)}
-            </Text>
-            <Text variant="small" className={colorClass}>
-              ({displayType} | null)
-            </Text>
-          </div>
-          {!isConnected && (
-            <Switch
-              className="z-10"
-              checked={isEnabled}
-              onCheckedChange={handleNullableToggle}
-            />
-          )}
-        </div>
-        <div className="mt-2">
-          {!isConnected && isEnabled && renderInput(nonNull)}
-        </div>
-      </div>
-    );
-  }
-
-  return (
-    <div className="mb-0 flex flex-col">
-      <div
-        className={cn("ml-1 flex items-center gap-1", showHandles && "-ml-2")}
-      >
-        {showHandles && (
-          <NodeHandle
-            handleId={handleId}
-            isConnected={isConnected}
-            side="left"
-          />
-        )}
-        <Text variant={formContext.size === "small" ? "body" : "body-medium"}>
-          {schema.title || name.charAt(0).toUpperCase() + name.slice(1)}
-        </Text>
-        {!isConnected && (
-          <Select
-            label=""
-            id={`${name}-type-select`}
-            hideLabel={true}
-            value={selectedType}
-            onValueChange={handleTypeChange}
-            options={typeOptions.map((o) => {
-              const { displayType } = getTypeDisplayInfo(o);
-              return { value: o.type, label: displayType };
-            })}
-            size="small"
-            wrapperClassName="!mb-0 "
-            className="h-6 w-fit gap-1 pl-3 pr-2"
-          />
-        )}
-
-        {schema.description && (
-          <TooltipProvider>
-            <Tooltip>
-              <TooltipTrigger asChild>
-                <span
-                  style={{ marginLeft: 6, cursor: "pointer" }}
-                  aria-label="info"
-                  tabIndex={0}
-                >
-                  <InfoIcon />
-                </span>
-              </TooltipTrigger>
-              <TooltipContent>{schema.description}</TooltipContent>
-            </Tooltip>
-          </TooltipProvider>
-        )}
-      </div>
-      <div className="mt-2">
-        {!isConnected && currentTypeOption && renderInput(currentTypeOption)}
-      </div>
-    </div>
-  );
-};
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/AnyOfField/useAnyOfField.tsx b/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/AnyOfField/useAnyOfField.tsx
deleted file mode 100644
index 7b35776476..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/AnyOfField/useAnyOfField.tsx
+++ /dev/null
@@ -1,97 +0,0 @@
-import { useMemo, useState } from "react";
-import { RJSFSchema } from "@rjsf/utils";
-
-const getDefaultValueForType = (type?: string): any => {
-  if (!type) return "";
-
-  switch (type) {
-    case "string":
-      return "";
-    case "number":
-    case "integer":
-      return 0;
-    case "boolean":
-      return false;
-    case "array":
-      return [];
-    case "object":
-      return {};
-    default:
-      return "";
-  }
-};
-
-export const useAnyOfField = (
-  schema: RJSFSchema,
-  formData: any,
-  onChange: (value: any) => void,
-) => {
-  const typeOptions: any[] = useMemo(
-    () =>
-      schema.anyOf?.map((opt: any, i: number) => ({
-        type: opt.type || "string",
-        title: opt.title || `Option ${i + 1}`,
-        index: i,
-        format: opt.format,
-        enum: opt.enum,
-        secret: opt.secret,
-        schema: opt,
-      })) || [],
-    [schema.anyOf],
-  );
-
-  const isNullableType = useMemo(
-    () =>
-      typeOptions.length === 2 &&
-      typeOptions.some((o) => o.type === "null") &&
-      typeOptions.some((o) => o.type !== "null"),
-    [typeOptions],
-  );
-
-  const nonNull = useMemo(
-    () => (isNullableType ? typeOptions.find((o) => o.type !== "null") : null),
-    [isNullableType, typeOptions],
-  );
-
-  const initialSelectedType = useMemo(() => {
-    const def = schema.default;
-    const first = typeOptions[0]?.type || "string";
-    if (isNullableType) return nonNull?.type || "string";
-    if (typeof def === "string" && typeOptions.some((o) => o.type === def))
-      return def;
-    return first;
-  }, [schema.default, typeOptions, isNullableType, nonNull?.type]);
-
-  const [selectedType, setSelectedType] = useState<string>(initialSelectedType);
-
-  const isEnabled = formData !== null && formData !== undefined;
-
-  const handleTypeChange = (t: string) => {
-    setSelectedType(t);
-    onChange(undefined); // clear current value when switching type
-  };
-
-  const handleNullableToggle = (checked: boolean) => {
-    if (checked) {
-      onChange(getDefaultValueForType(nonNull?.type));
-    } else {
-      onChange(null);
-    }
-  };
-
-  const handleValueChange = (value: any) => onChange(value);
-
-  const currentTypeOption = typeOptions.find((o) => o.type === selectedType);
-
-  return {
-    isNullableType,
-    nonNull,
-    selectedType,
-    handleTypeChange,
-    handleNullableToggle,
-    handleValueChange,
-    currentTypeOption,
-    isEnabled,
-    typeOptions,
-  };
-};
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/CredentialField.tsx b/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/CredentialField.tsx
deleted file mode 100644
index a61d2f0b16..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/CredentialField.tsx
+++ /dev/null
@@ -1,87 +0,0 @@
-import React from "react";
-import { FieldProps } from "@rjsf/utils";
-import { useCredentialField } from "./useCredentialField";
-import { SelectCredential } from "./SelectCredential";
-import { Skeleton } from "@/components/__legacy__/ui/skeleton";
-import { BlockIOCredentialsSubSchema } from "@/lib/autogpt-server-api";
-import { APIKeyCredentialsModal } from "./models/APIKeyCredentialModal/APIKeyCredentialModal";
-import { OAuthCredentialModal } from "./models/OAuthCredentialModal/OAuthCredentialModal";
-import { PasswordCredentialsModal } from "./models/PasswordCredentialModal/PasswordCredentialModal";
-import { HostScopedCredentialsModal } from "./models/HostScopedCredentialsModal/HostScopedCredentialsModal";
-
-export const CredentialsField = (props: FieldProps) => {
-  const {
-    formData = {},
-    onChange,
-    required: _required,
-    schema,
-    formContext,
-  } = props;
-  const {
-    credentials,
-    isCredentialListLoading,
-    supportsApiKey,
-    supportsOAuth2,
-    supportsUserPassword,
-    supportsHostScoped,
-    credentialsExists,
-    credentialProvider,
-    setCredential,
-    discriminatorValue,
-  } = useCredentialField({
-    credentialSchema: schema as BlockIOCredentialsSubSchema,
-    formData,
-    nodeId: formContext.nodeId,
-    onChange,
-  });
-
-  if (isCredentialListLoading) {
-    return (
-      <div className="flex flex-col gap-2">
-        <Skeleton className="h-8 w-full rounded-xlarge" />
-        <Skeleton className="h-8 w-[30%] rounded-xlarge" />
-      </div>
-    );
-  }
-
-  if (!credentialProvider) {
-    return null;
-  }
-
-  return (
-    <div className="flex flex-col gap-2">
-      {credentialsExists && (
-        <SelectCredential
-          credentials={credentials}
-          value={formData.id || ""}
-          onChange={setCredential}
-          disabled={false}
-          label="Credential"
-          placeholder="Select credential"
-        />
-      )}
-
-      <div className="flex flex-wrap gap-2">
-        {supportsApiKey && (
-          <APIKeyCredentialsModal
-            schema={schema as BlockIOCredentialsSubSchema}
-            provider={credentialProvider}
-          />
-        )}
-        {supportsOAuth2 && (
-          <OAuthCredentialModal provider={credentialProvider} />
-        )}
-        {supportsUserPassword && (
-          <PasswordCredentialsModal provider={credentialProvider} />
-        )}
-        {supportsHostScoped && discriminatorValue && (
-          <HostScopedCredentialsModal
-            schema={schema as BlockIOCredentialsSubSchema}
-            provider={credentialProvider}
-            discriminatorValue={discriminatorValue}
-          />
-        )}
-      </div>
-    </div>
-  );
-};
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/SelectCredential.tsx b/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/SelectCredential.tsx
deleted file mode 100644
index 55081332aa..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/SelectCredential.tsx
+++ /dev/null
@@ -1,93 +0,0 @@
-import React from "react";
-import { Select } from "@/components/atoms/Select/Select";
-import { CredentialsMetaResponse } from "@/app/api/__generated__/models/credentialsMetaResponse";
-import {
-  ArrowSquareOutIcon,
-  KeyholeIcon,
-  KeyIcon,
-} from "@phosphor-icons/react";
-import { Button } from "@/components/atoms/Button/Button";
-import { providerIcons } from "./helpers";
-
-type SelectCredentialProps = {
-  credentials: CredentialsMetaResponse[];
-  value?: string;
-  defaultValue?: string;
-  onChange: (credentialId: string) => void;
-  disabled?: boolean;
-  label?: string;
-  placeholder?: string;
-};
-
-export const SelectCredential: React.FC<SelectCredentialProps> = ({
-  credentials,
-  value,
-  onChange,
-  disabled = false,
-  label = "Credential",
-  placeholder = "Select credential",
-}) => {
-  const options = credentials.map((cred) => {
-    const details: string[] = [];
-    if (cred.title && cred.title !== cred.provider) {
-      details.push(cred.title);
-    }
-    if (cred.username) {
-      details.push(cred.username);
-    }
-    if (cred.host) {
-      details.push(cred.host);
-    }
-    const label =
-      details.length > 0
-        ? `${cred.provider} (${details.join(" - ")})`
-        : cred.provider;
-
-    const Icon = providerIcons[cred.provider];
-    const icon =
-      cred.type === "oauth2" ? (
-        Icon ? (
-          <Icon />
-        ) : (
-          <KeyholeIcon />
-        )
-      ) : (
-        <KeyIcon className="h-4 w-4" />
-      );
-
-    return {
-      value: cred.id,
-      label,
-      icon,
-    };
-  });
-
-  return (
-    <div className="flex w-full items-center gap-2">
-      <Select
-        label={label}
-        id="select-credential"
-        wrapperClassName="!mb-0 flex-1 !max-w-[90%]"
-        value={value}
-        onValueChange={onChange}
-        options={options}
-        disabled={disabled}
-        placeholder={placeholder}
-        size="small"
-        hideLabel
-      />
-
-      <Button
-        as="NextLink"
-        href="/profile/integrations"
-        target="_blank"
-        rel="noopener noreferrer"
-        variant="outline"
-        size="icon"
-        className="h-8 w-8 !min-w-8 border-zinc-300 p-0"
-      >
-        <ArrowSquareOutIcon className="h-4 w-4 text-zinc-600" />
-      </Button>
-    </div>
-  );
-};
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/APIKeyCredentialModal/APIKeyCredentialModal.tsx b/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/APIKeyCredentialModal/APIKeyCredentialModal.tsx
deleted file mode 100644
index 5a51e1e36c..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/APIKeyCredentialModal/APIKeyCredentialModal.tsx
+++ /dev/null
@@ -1,123 +0,0 @@
-import { Input } from "@/components/atoms/Input/Input";
-import { Button } from "@/components/atoms/Button/Button";
-import { Dialog } from "@/components/molecules/Dialog/Dialog";
-import {
-  Form,
-  FormDescription,
-  FormField,
-} from "@/components/__legacy__/ui/form";
-import { BlockIOCredentialsSubSchema } from "@/lib/autogpt-server-api/types"; // we need to find a way to replace it with autogenerated types
-import { useAPIKeyCredentialsModal } from "./useAPIKeyCredentialsModal";
-import { toDisplayName } from "../../helpers";
-import { KeyIcon } from "@phosphor-icons/react";
-import { Text } from "@/components/atoms/Text/Text";
-
-type Props = {
-  schema: BlockIOCredentialsSubSchema;
-  provider: string;
-};
-
-export function APIKeyCredentialsModal({ schema, provider }: Props) {
-  const { form, schemaDescription, onSubmit, isOpen, setIsOpen } =
-    useAPIKeyCredentialsModal({ schema, provider });
-
-  return (
-    <>
-      <Dialog
-        title={`Add new API key for ${toDisplayName(provider) ?? ""}`}
-        controlled={{
-          isOpen: isOpen,
-          set: (isOpen) => {
-            if (!isOpen) setIsOpen(false);
-          },
-        }}
-        onClose={() => setIsOpen(false)}
-        styling={{
-          maxWidth: "25rem",
-        }}
-      >
-        <Dialog.Content>
-          {schemaDescription && (
-            <p className="mb-4 text-sm text-zinc-600">{schemaDescription}</p>
-          )}
-
-          <Form {...form}>
-            <form onSubmit={form.handleSubmit(onSubmit)} className="space-y-2">
-              <FormField
-                control={form.control}
-                name="apiKey"
-                render={({ field }) => (
-                  <>
-                    <Input
-                      id="apiKey"
-                      label="API Key"
-                      type="password"
-                      placeholder="Enter API key..."
-                      size="small"
-                      hint={
-                        schema.credentials_scopes ? (
-                          <FormDescription>
-                            Required scope(s) for this block:{" "}
-                            {schema.credentials_scopes?.map((s, i, a) => (
-                              <span key={i}>
-                                <code className="text-xs font-bold">{s}</code>
-                                {i < a.length - 1 && ", "}
-                              </span>
-                            ))}
-                          </FormDescription>
-                        ) : null
-                      }
-                      {...field}
-                    />
-                  </>
-                )}
-              />
-              <FormField
-                control={form.control}
-                name="title"
-                render={({ field }) => (
-                  <Input
-                    id="title"
-                    label="Name"
-                    type="text"
-                    placeholder="Enter a name for this API key..."
-                    size="small"
-                    {...field}
-                  />
-                )}
-              />
-              <FormField
-                control={form.control}
-                name="expiresAt"
-                render={({ field }) => (
-                  <Input
-                    id="expiresAt"
-                    label="Expiration Date"
-                    type="datetime-local"
-                    placeholder="Select expiration date..."
-                    size="small"
-                    {...field}
-                  />
-                )}
-              />
-              <Button type="submit" size="small" className="min-w-68">
-                Save & use this API key
-              </Button>
-            </form>
-          </Form>
-        </Dialog.Content>
-      </Dialog>
-      <Button
-        type="button"
-        className="w-fit px-2"
-        size="small"
-        onClick={() => setIsOpen(true)}
-      >
-        <KeyIcon />
-        <Text variant="small" className="!text-white opacity-100">
-          Add API key
-        </Text>
-      </Button>
-    </>
-  );
-}
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/APIKeyCredentialModal/useAPIKeyCredentialsModal.ts b/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/APIKeyCredentialModal/useAPIKeyCredentialsModal.ts
deleted file mode 100644
index 499cacf1ce..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/APIKeyCredentialModal/useAPIKeyCredentialsModal.ts
+++ /dev/null
@@ -1,103 +0,0 @@
-import { z } from "zod";
-import { useForm, type UseFormReturn } from "react-hook-form";
-import { zodResolver } from "@hookform/resolvers/zod";
-import { BlockIOCredentialsSubSchema } from "@/lib/autogpt-server-api/types";
-import {
-  getGetV1ListCredentialsQueryKey,
-  usePostV1CreateCredentials,
-} from "@/app/api/__generated__/endpoints/integrations/integrations";
-import { useToast } from "@/components/molecules/Toast/use-toast";
-import { APIKeyCredentials } from "@/app/api/__generated__/models/aPIKeyCredentials";
-import { useQueryClient } from "@tanstack/react-query";
-import { useState } from "react";
-
-export type APIKeyFormValues = {
-  apiKey: string;
-  title: string;
-  expiresAt?: string;
-};
-
-type useAPIKeyCredentialsModalType = {
-  schema: BlockIOCredentialsSubSchema;
-  provider: string;
-};
-
-export function useAPIKeyCredentialsModal({
-  schema,
-  provider,
-}: useAPIKeyCredentialsModalType): {
-  form: UseFormReturn<APIKeyFormValues>;
-  schemaDescription?: string;
-  onSubmit: (values: APIKeyFormValues) => Promise<void>;
-  isOpen: boolean;
-  setIsOpen: (isOpen: boolean) => void;
-} {
-  const { toast } = useToast();
-  const [isOpen, setIsOpen] = useState(false);
-  const queryClient = useQueryClient();
-
-  const { mutateAsync: createCredentials } = usePostV1CreateCredentials({
-    mutation: {
-      onSuccess: async () => {
-        form.reset();
-        setIsOpen(false);
-        toast({
-          title: "Success",
-          description: "Credentials created successfully",
-          variant: "default",
-        });
-
-        await queryClient.refetchQueries({
-          queryKey: getGetV1ListCredentialsQueryKey(),
-        });
-      },
-      onError: () => {
-        toast({
-          title: "Error",
-          description: "Failed to create credentials.",
-          variant: "destructive",
-        });
-      },
-    },
-  });
-
-  const formSchema = z.object({
-    apiKey: z.string().min(1, "API Key is required"),
-    title: z.string().min(1, "Name is required"),
-    expiresAt: z.string().optional(),
-  });
-
-  const form = useForm<APIKeyFormValues>({
-    resolver: zodResolver(formSchema),
-    defaultValues: {
-      apiKey: "",
-      title: "",
-      expiresAt: "",
-    },
-  });
-
-  async function onSubmit(values: APIKeyFormValues) {
-    const expiresAt = values.expiresAt
-      ? new Date(values.expiresAt).getTime() / 1000
-      : undefined;
-
-    createCredentials({
-      provider: provider,
-      data: {
-        provider: provider,
-        type: "api_key",
-        api_key: values.apiKey,
-        title: values.title,
-        expires_at: expiresAt,
-      } as APIKeyCredentials,
-    });
-  }
-
-  return {
-    form,
-    schemaDescription: schema.description,
-    onSubmit,
-    isOpen,
-    setIsOpen,
-  };
-}
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/HostScopedCredentialsModal/HostScopedCredentialsModal.tsx b/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/HostScopedCredentialsModal/HostScopedCredentialsModal.tsx
deleted file mode 100644
index 3264fca76f..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/HostScopedCredentialsModal/HostScopedCredentialsModal.tsx
+++ /dev/null
@@ -1,185 +0,0 @@
-import { Input } from "@/components/atoms/Input/Input";
-import { Button } from "@/components/atoms/Button/Button";
-import { Dialog } from "@/components/molecules/Dialog/Dialog";
-import {
-  Form,
-  FormDescription,
-  FormField,
-  FormLabel,
-} from "@/components/__legacy__/ui/form";
-import { BlockIOCredentialsSubSchema } from "@/lib/autogpt-server-api/types";
-import { useHostScopedCredentialsModal } from "./useHostScopedCredentialsModal";
-import { toDisplayName } from "../../helpers";
-import { GlobeIcon, PlusIcon, TrashIcon } from "@phosphor-icons/react";
-import { Text } from "@/components/atoms/Text/Text";
-
-type Props = {
-  schema: BlockIOCredentialsSubSchema;
-  provider: string;
-  discriminatorValue?: string;
-};
-
-export function HostScopedCredentialsModal({
-  schema,
-  provider,
-  discriminatorValue,
-}: Props) {
-  const {
-    form,
-    schemaDescription,
-    onSubmit,
-    isOpen,
-    setIsOpen,
-    headerPairs,
-    addHeaderPair,
-    removeHeaderPair,
-    updateHeaderPair,
-    currentHost,
-  } = useHostScopedCredentialsModal({ schema, provider, discriminatorValue });
-
-  return (
-    <>
-      <Dialog
-        title={`Add sensitive headers for ${toDisplayName(provider) ?? ""}`}
-        controlled={{
-          isOpen: isOpen,
-          set: (isOpen) => {
-            if (!isOpen) setIsOpen(false);
-          },
-        }}
-        onClose={() => setIsOpen(false)}
-        styling={{
-          maxWidth: "38rem",
-        }}
-      >
-        <Dialog.Content>
-          <div className="px-1">
-            {schemaDescription && (
-              <p className="mb-4 text-sm text-zinc-600">{schemaDescription}</p>
-            )}
-
-            <Form {...form}>
-              <form
-                onSubmit={form.handleSubmit(onSubmit)}
-                className="space-y-4"
-              >
-                <FormField
-                  control={form.control}
-                  name="host"
-                  render={({ field }) => (
-                    <Input
-                      id="host"
-                      label="Host Pattern"
-                      type="text"
-                      size="small"
-                      readOnly={!!currentHost}
-                      hint={
-                        currentHost
-                          ? "Auto-populated from the URL field. Headers will be applied to requests to this host."
-                          : "Enter the host/domain to match against request URLs (e.g., api.example.com)."
-                      }
-                      placeholder={
-                        currentHost
-                          ? undefined
-                          : "Enter host (e.g., api.example.com)"
-                      }
-                      {...field}
-                    />
-                  )}
-                />
-
-                <FormField
-                  control={form.control}
-                  name="title"
-                  render={({ field }) => (
-                    <Input
-                      id="title"
-                      label="Name (optional)"
-                      type="text"
-                      placeholder="Enter a name for these credentials..."
-                      size="small"
-                      {...field}
-                    />
-                  )}
-                />
-
-                <div className="space-y-2">
-                  <FormLabel>Headers</FormLabel>
-                  <FormDescription className="max-w-md">
-                    Add sensitive headers (like Authorization, X-API-Key) that
-                    should be automatically included in requests to the
-                    specified host.
-                  </FormDescription>
-
-                  {headerPairs.map((pair, index) => (
-                    <div key={index} className="flex w-full items-center gap-2">
-                      <Input
-                        id={`header-${index}-key`}
-                        label="Header Name"
-                        placeholder="e.g., Authorization"
-                        size="small"
-                        value={pair.key}
-                        className="flex-1"
-                        onChange={(e) =>
-                          updateHeaderPair(index, "key", e.target.value)
-                        }
-                      />
-
-                      <Input
-                        id={`header-${index}-value`}
-                        label="Header Value"
-                        size="small"
-                        type="password"
-                        className="flex-1"
-                        placeholder="e.g., Bearer token123"
-                        value={pair.value}
-                        onChange={(e) =>
-                          updateHeaderPair(index, "value", e.target.value)
-                        }
-                      />
-                      <Button
-                        type="button"
-                        variant="secondary"
-                        size="small"
-                        onClick={() => removeHeaderPair(index)}
-                        disabled={headerPairs.length === 1}
-                        className="min-w-0"
-                      >
-                        <TrashIcon className="size-4" />
-                      </Button>
-                    </div>
-                  ))}
-
-                  <Button
-                    type="button"
-                    variant="outline"
-                    size="small"
-                    onClick={addHeaderPair}
-                  >
-                    <PlusIcon className="size-4" /> Add Another Header
-                  </Button>
-                </div>
-
-                <Button type="submit" size="small" className="min-w-68">
-                  Save & use these credentials
-                </Button>
-              </form>
-            </Form>
-          </div>
-        </Dialog.Content>
-      </Dialog>
-      <Button
-        type="button"
-        className="w-fit px-2"
-        size="small"
-        onClick={() => setIsOpen(true)}
-      >
-        <GlobeIcon />
-        <Text variant="small" className="truncate !text-white opacity-100">
-          Add sensitive headers for{" "}
-          {toDisplayName(discriminatorValue || provider) ?? ""}
-        </Text>
-      </Button>
-    </>
-  );
-}
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/HostScopedCredentialsModal/useHostScopedCredentialsModal.ts b/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/HostScopedCredentialsModal/useHostScopedCredentialsModal.ts
deleted file mode 100644
index 066bc05b51..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/HostScopedCredentialsModal/useHostScopedCredentialsModal.ts
+++ /dev/null
@@ -1,167 +0,0 @@
-import { z } from "zod";
-import { useForm, type UseFormReturn } from "react-hook-form";
-import { zodResolver } from "@hookform/resolvers/zod";
-import { BlockIOCredentialsSubSchema } from "@/lib/autogpt-server-api/types";
-import {
-  getGetV1ListCredentialsQueryKey,
-  usePostV1CreateCredentials,
-} from "@/app/api/__generated__/endpoints/integrations/integrations";
-import { useToast } from "@/components/molecules/Toast/use-toast";
-import { HostScopedCredentialsInput } from "@/app/api/__generated__/models/hostScopedCredentialsInput";
-import { useQueryClient } from "@tanstack/react-query";
-import { useState } from "react";
-import { getHostFromUrl } from "@/lib/utils/url";
-
-export type HeaderPair = {
-  key: string;
-  value: string;
-};
-
-export type HostScopedFormValues = {
-  host: string;
-  title?: string;
-};
-
-type UseHostScopedCredentialsModalType = {
-  schema: BlockIOCredentialsSubSchema;
-  provider: string;
-  discriminatorValue?: string;
-};
-
-export function useHostScopedCredentialsModal({
-  schema,
-  provider,
-  discriminatorValue,
-}: UseHostScopedCredentialsModalType): {
-  form: UseFormReturn<HostScopedFormValues>;
-  schemaDescription?: string;
-  onSubmit: (values: HostScopedFormValues) => Promise<void>;
-  isOpen: boolean;
-  setIsOpen: (isOpen: boolean) => void;
-  headerPairs: HeaderPair[];
-  addHeaderPair: () => void;
-  removeHeaderPair: (index: number) => void;
-  updateHeaderPair: (
-    index: number,
-    field: "key" | "value",
-    value: string,
-  ) => void;
-  currentHost: string | null;
-} {
-  const { toast } = useToast();
-  const [isOpen, setIsOpen] = useState(false);
-  const [headerPairs, setHeaderPairs] = useState<HeaderPair[]>([
-    { key: "", value: "" },
-  ]);
-  const queryClient = useQueryClient();
-
-  // Get current host from discriminatorValue (URL field)
-  const currentHost = discriminatorValue
-    ? getHostFromUrl(discriminatorValue)
-    : null;
-
-  const { mutateAsync: createCredentials } = usePostV1CreateCredentials({
-    mutation: {
-      onSuccess: async () => {
-        form.reset();
-        setHeaderPairs([{ key: "", value: "" }]);
-        setIsOpen(false);
-        toast({
-          title: "Success",
-          description: "Host-scoped credentials created successfully",
-          variant: "default",
-        });
-
-        await queryClient.refetchQueries({
-          queryKey: getGetV1ListCredentialsQueryKey(),
-        });
-      },
-      onError: () => {
-        toast({
-          title: "Error",
-          description: "Failed to create host-scoped credentials.",
-          variant: "destructive",
-        });
-      },
-    },
-  });
-
-  const formSchema = z.object({
-    host: z.string().min(1, "Host is required"),
-    title: z.string().optional().default(""),
-  });
-
-  const form = useForm<HostScopedFormValues>({
-    resolver: zodResolver(formSchema),
-    defaultValues: {
-      host: currentHost || "",
-      title: currentHost || "Manual Entry",
-    },
-  });
-
-  // Update form values when modal opens and discriminatorValue changes
-  const handleSetIsOpen = (open: boolean) => {
-    if (open && currentHost) {
-      form.setValue("host", currentHost);
-      form.setValue("title", currentHost);
-    }
-    setIsOpen(open);
-  };
-
-  const addHeaderPair = () => {
-    setHeaderPairs([...headerPairs, { key: "", value: "" }]);
-  };
-
-  const removeHeaderPair = (index: number) => {
-    if (headerPairs.length > 1) {
-      setHeaderPairs(headerPairs.filter((_, i) => i !== index));
-    }
-  };
-
-  const updateHeaderPair = (
-    index: number,
-    field: "key" | "value",
-    value: string,
-  ) => {
-    const newPairs = [...headerPairs];
-    newPairs[index][field] = value;
-    setHeaderPairs(newPairs);
-  };
-
-  async function onSubmit(values: HostScopedFormValues) {
-    // Convert header pairs to object, filtering out empty pairs
-    const headers = headerPairs.reduce(
-      (acc, pair) => {
-        if (pair.key.trim() && pair.value.trim()) {
-          acc[pair.key.trim()] = pair.value.trim();
-        }
-        return acc;
-      },
-      {} as Record<string, string>,
-    );
-
-    createCredentials({
-      provider: provider,
-      data: {
-        provider: provider,
-        type: "host_scoped",
-        host: values.host,
-        title: values.title || values.host,
-        headers: headers,
-      } as HostScopedCredentialsInput,
-    });
-  }
-
-  return {
-    form,
-    schemaDescription: schema.description,
-    onSubmit,
-    isOpen,
-    setIsOpen: handleSetIsOpen,
-    headerPairs,
-    addHeaderPair,
-    removeHeaderPair,
-    updateHeaderPair,
-    currentHost,
-  };
-}
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/OAuthCredentialModal/OAuthCredentialModal.tsx b/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/OAuthCredentialModal/OAuthCredentialModal.tsx
deleted file mode 100644
index 9824ace169..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/OAuthCredentialModal/OAuthCredentialModal.tsx
+++ /dev/null
@@ -1,63 +0,0 @@
-import { Button } from "@/components/atoms/Button/Button";
-import { Dialog } from "@/components/molecules/Dialog/Dialog";
-import { providerIcons, toDisplayName } from "../../helpers";
-import { useOAuthCredentialModal } from "./useOAuthCredentialModal";
-import { Text } from "@/components/atoms/Text/Text";
-
-type OAuthCredentialModalProps = {
-  provider: string;
-};
-
-export const OAuthCredentialModal = ({
-  provider,
-}: OAuthCredentialModalProps) => {
-  const Icon = providerIcons[provider];
-  const { handleOAuthLogin, loading, error, onClose, open, setOpen } =
-    useOAuthCredentialModal({
-      provider,
-    });
-  return (
-    <>
-      <Dialog
-        title={`Waiting on ${toDisplayName(provider)} sign-in process...`}
-        controlled={{
-          isOpen: open,
-          set: (isOpen) => {
-            if (!isOpen) setOpen(false);
-          },
-        }}
-        onClose={onClose}
-      >
-        <Dialog.Content>
-          <p className="text-sm text-zinc-600">
-            Complete the sign-in process in the pop-up window.
-            <br />
-            Closing this dialog will cancel the sign-in process.
-          </p>
-        </Dialog.Content>
-      </Dialog>
-
-      <Button
-        type="button"
-        className="w-fit px-2"
-        size="small"
-        onClick={() => {
-          handleOAuthLogin();
-        }}
-        disabled={loading}
-      >
-        {Icon && <Icon className="size-4" />}
-        <Text variant="small" className="!text-white opacity-100">
-          Add OAuth2
-        </Text>
-      </Button>
-      {error && (
-        <div className="mt-2 flex w-fit items-center rounded-full bg-red-50 p-1 px-3 ring-1 ring-red-600">
-          <Text variant="small" className="!text-red-600">
-            {error as string}
-          </Text>
-        </div>
-      )}
-    </>
-  );
-};
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/OAuthCredentialModal/useOAuthCredentialModal.ts b/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/OAuthCredentialModal/useOAuthCredentialModal.ts
deleted file mode 100644
index cf82ebca70..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/OAuthCredentialModal/useOAuthCredentialModal.ts
+++ /dev/null
@@ -1,196 +0,0 @@
-import {
-  getGetV1ListCredentialsQueryKey,
-  useGetV1InitiateOauthFlow,
-  usePostV1ExchangeOauthCodeForTokens,
-} from "@/app/api/__generated__/endpoints/integrations/integrations";
-import { LoginResponse } from "@/app/api/__generated__/models/loginResponse";
-import { useToast } from "@/components/molecules/Toast/use-toast";
-import { useQueryClient } from "@tanstack/react-query";
-import { useState } from "react";
-
-type useOAuthCredentialModalProps = {
-  provider: string;
-  scopes?: string[];
-};
-
-export type OAuthPopupResultMessage = { message_type: "oauth_popup_result" } & (
-  | {
-      success: true;
-      code: string;
-      state: string;
-    }
-  | {
-      success: false;
-      message: string;
-    }
-);
-
-export const useOAuthCredentialModal = ({
-  provider,
-  scopes,
-}: useOAuthCredentialModalProps) => {
-  const { toast } = useToast();
-
-  const [open, setOpen] = useState(false);
-  const [oAuthPopupController, setOAuthPopupController] =
-    useState<AbortController | null>(null);
-  const [oAuthError, setOAuthError] = useState<string | null>(null);
-  const [isOAuth2FlowInProgress, setOAuth2FlowInProgress] = useState(false);
-
-  const queryClient = useQueryClient();
-
-  const {
-    refetch: initiateOauthFlow,
-    isRefetching: isInitiatingOauthFlow,
-    isRefetchError: initiatingOauthFlowError,
-  } = useGetV1InitiateOauthFlow(
-    provider,
-    {
-      scopes: scopes?.join(","),
-    },
-    {
-      query: {
-        enabled: false,
-        select: (res) => {
-          return res.data as LoginResponse;
-        },
-      },
-    },
-  );
-
-  const {
-    mutateAsync: oAuthCallback,
-    isPending: isOAuthCallbackPending,
-    error: oAuthCallbackError,
-  } = usePostV1ExchangeOauthCodeForTokens({
-    mutation: {
-      onSuccess: () => {
-        queryClient.invalidateQueries({
-          queryKey: getGetV1ListCredentialsQueryKey(),
-        });
-        setOpen(false);
-        toast({
-          title: "Success",
-          description: "Credential added successfully",
-          variant: "default",
-        });
-      },
-    },
-  });
-
-  const handleOAuthLogin = async () => {
-    const { data } = await initiateOauthFlow();
-    if (!data || !data.login_url || !data.state_token) {
-      toast({
-        title: "Failed to initiate OAuth flow",
-        variant: "destructive",
-      });
-      setOAuthError(
-        data && typeof data === "object" && "detail" in data
-          ? (data.detail as string)
-          : "Failed to initiate OAuth flow",
-      );
-      return;
-    }
-
-    setOpen(true);
-    setOAuth2FlowInProgress(true);
-
-    const { login_url, state_token } = data;
-
-    const popup = window.open(login_url, "_blank", "popup=true");
-
-    if (!popup) {
-      throw new Error(
-        "Failed to open popup window. Please allow popups for this site.",
-      );
-    }
-
-    const controller = new AbortController();
-    setOAuthPopupController(controller);
-
-    controller.signal.onabort = () => {
-      console.debug("OAuth flow aborted");
-      popup.close();
-    };
-
-    const handleMessage = async (e: MessageEvent<OAuthPopupResultMessage>) => {
-      console.debug("Message received:", e.data);
-      if (
-        typeof e.data != "object" ||
-        !("message_type" in e.data) ||
-        e.data.message_type !== "oauth_popup_result"
-      ) {
-        console.debug("Ignoring irrelevant message");
-        return;
-      }
-
-      if (!e.data.success) {
-        console.error("OAuth flow failed:", e.data.message);
-        setOAuthError(`OAuth flow failed: ${e.data.message}`);
-        setOAuth2FlowInProgress(false);
-        return;
-      }
-
-      if (e.data.state !== state_token) {
-        console.error("Invalid state token received");
-        setOAuthError("Invalid state token received");
-        setOAuth2FlowInProgress(false);
-        return;
-      }
-
-      try {
-        console.debug("Processing OAuth callback");
-        await oAuthCallback({
-          provider,
-          data: {
-            code: e.data.code,
-            state_token: e.data.state,
-          },
-        });
-
-        console.debug("OAuth callback processed successfully");
-      } catch (error) {
-        console.error("Error in OAuth callback:", error);
-        setOAuthError(
-          `Error in OAuth callback: ${
-            error instanceof Error ? error.message : String(error)
-          }`,
-        );
-      } finally {
-        console.debug("Finalizing OAuth flow");
-        setOAuth2FlowInProgress(false);
-        controller.abort("success");
-      }
-    };
-
-    window.addEventListener("message", handleMessage, {
-      signal: controller.signal,
-    });
-
-    setTimeout(
-      () => {
-        console.debug("OAuth flow timed out");
-        controller.abort("timeout");
-        setOAuth2FlowInProgress(false);
-        setOAuthError("OAuth flow timed out");
-      },
-      5 * 60 * 1000,
-    );
-  };
-
-  const onClose = () => {
-    oAuthPopupController?.abort("canceled");
-    setOpen(false);
-  };
-
-  return {
-    handleOAuthLogin,
-    loading:
-      isOAuth2FlowInProgress || isOAuthCallbackPending || isInitiatingOauthFlow,
-    error: oAuthError || initiatingOauthFlowError || oAuthCallbackError,
-    onClose,
-    open,
-    setOpen,
-  };
-};
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/PasswordCredentialModal/PasswordCredentialModal.tsx b/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/PasswordCredentialModal/PasswordCredentialModal.tsx
deleted file mode 100644
index 9abaa8b328..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/PasswordCredentialModal/PasswordCredentialModal.tsx
+++ /dev/null
@@ -1,102 +0,0 @@
-import { Input } from "@/components/atoms/Input/Input";
-import { Button } from "@/components/atoms/Button/Button";
-import { Dialog } from "@/components/molecules/Dialog/Dialog";
-import { Form, FormField } from "@/components/__legacy__/ui/form";
-import { usePasswordCredentialModal } from "./usePasswordCredentialModal";
-import { toDisplayName } from "../../helpers";
-import { UserIcon } from "@phosphor-icons/react";
-import { Text } from "@/components/atoms/Text/Text";
-
-type Props = {
-  provider: string;
-};
-
-export function PasswordCredentialsModal({ provider }: Props) {
-  const { form, onSubmit, open, setOpen } = usePasswordCredentialModal({
-    provider,
-  });
-
-  return (
-    <>
-      <Dialog
-        title={`Add new username & password for ${toDisplayName(provider)}`}
-        controlled={{
-          isOpen: open,
-          set: (isOpen) => {
-            if (!isOpen) setOpen(false);
-          },
-        }}
-        onClose={() => setOpen(false)}
-        styling={{
-          maxWidth: "25rem",
-        }}
-      >
-        <Dialog.Content>
-          <Form {...form}>
-            <form
-              onSubmit={form.handleSubmit(onSubmit)}
-              className="space-y-2 pt-4"
-            >
-              <FormField
-                control={form.control}
-                name="username"
-                render={({ field }) => (
-                  <Input
-                    id="username"
-                    label="Username"
-                    type="text"
-                    placeholder="Enter username..."
-                    size="small"
-                    {...field}
-                  />
-                )}
-              />
-              <FormField
-                control={form.control}
-                name="password"
-                render={({ field }) => (
-                  <Input
-                    id="password"
-                    label="Password"
-                    type="password"
-                    placeholder="Enter password..."
-                    size="small"
-                    {...field}
-                  />
-                )}
-              />
-              <FormField
-                control={form.control}
-                name="title"
-                render={({ field }) => (
-                  <Input
-                    id="title"
-                    label="Name"
-                    type="text"
-                    placeholder="Enter a name for this user login..."
-                    size="small"
-                    {...field}
-                  />
-                )}
-              />
-              <Button type="submit" size="small" className="min-w-68">
-                Save & use this user login
-              </Button>
-            </form>
-          </Form>
-        </Dialog.Content>
-      </Dialog>
-      <Button
-        type="button"
-        className="w-fit px-2"
-        size="small"
-        onClick={() => setOpen(true)}
-      >
-        <UserIcon className="size-4" />
-        <Text variant="small" className="!text-white opacity-100">
-          Add username & password
-        </Text>
-      </Button>
-    </>
-  );
-}
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/PasswordCredentialModal/usePasswordCredentialModal.ts b/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/PasswordCredentialModal/usePasswordCredentialModal.ts
deleted file mode 100644
index e0a4e4a805..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/models/PasswordCredentialModal/usePasswordCredentialModal.ts
+++ /dev/null
@@ -1,75 +0,0 @@
-import { useState } from "react";
-import z from "zod";
-import { useForm } from "react-hook-form";
-import { zodResolver } from "@hookform/resolvers/zod";
-import {
-  getGetV1ListCredentialsQueryKey,
-  usePostV1CreateCredentials,
-} from "@/app/api/__generated__/endpoints/integrations/integrations";
-import { useToast } from "@/components/molecules/Toast/use-toast";
-import { useQueryClient } from "@tanstack/react-query";
-
-type usePasswordCredentialModalType = {
-  provider: string;
-};
-
-export const usePasswordCredentialModal = ({
-  provider,
-}: usePasswordCredentialModalType) => {
-  const [open, setOpen] = useState(false);
-  const { toast } = useToast();
-  const queryClient = useQueryClient();
-
-  const formSchema = z.object({
-    username: z.string().min(1, "Username is required"),
-    password: z.string().min(1, "Password is required"),
-    title: z.string().min(1, "Name is required"),
-  });
-
-  const form = useForm<z.infer<typeof formSchema>>({
-    resolver: zodResolver(formSchema),
-    defaultValues: {
-      username: "",
-      password: "",
-      title: "",
-    },
-  });
-
-  const { mutateAsync: createCredentials } = usePostV1CreateCredentials({
-    mutation: {
-      onSuccess: async () => {
-        form.reset();
-        setOpen(false);
-        toast({
-          title: "Success",
-          description: "Credentials created successfully",
-          variant: "default",
-        });
-
-        await queryClient.refetchQueries({
-          queryKey: getGetV1ListCredentialsQueryKey(),
-        });
-      },
-    },
-  });
-
-  async function onSubmit(values: z.infer<typeof formSchema>) {
-    createCredentials({
-      provider: provider,
-      data: {
-        provider: provider,
-        type: "user_password",
-        username: values.username,
-        password: values.password,
-        title: values.title,
-      },
-    });
-  }
-
-  return {
-    form,
-    onSubmit,
-    open,
-    setOpen,
-  };
-};
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/useCredentialField.ts b/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/useCredentialField.ts
deleted file mode 100644
index a90add8aeb..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/CredentialField/useCredentialField.ts
+++ /dev/null
@@ -1,141 +0,0 @@
-import { useGetV1ListCredentials } from "@/app/api/__generated__/endpoints/integrations/integrations";
-import { CredentialsMetaResponse } from "@/app/api/__generated__/models/credentialsMetaResponse";
-import { BlockIOCredentialsSubSchema } from "@/lib/autogpt-server-api";
-import {
-  filterCredentialsByProvider,
-  getCredentialProviderFromSchema,
-  getDiscriminatorValue,
-} from "./helpers";
-import { useNodeStore } from "@/app/(platform)/build/stores/nodeStore";
-import { useEffect, useRef } from "react";
-import { useShallow } from "zustand/react/shallow";
-
-export const useCredentialField = ({
-  credentialSchema,
-  formData,
-  nodeId,
-  onChange,
-}: {
-  credentialSchema: BlockIOCredentialsSubSchema; // Here we are using manual typing, we need to fix it with automatic one
-  formData: Record<string, any>;
-  nodeId: string;
-  onChange: (value: Record<string, any>) => void;
-}) => {
-  const previousProviderRef = useRef<string | null>(null);
-
-  // Fetch all the credentials from the backend
-  // We will save it in cache for 10 min, if user edits the credential, we will invalidate the cache
-  // Whenever user adds a block, we filter the credentials list and check if this block's provider is in the list
-  const { data: credentials, isLoading: isCredentialListLoading } =
-    useGetV1ListCredentials({
-      query: {
-        refetchInterval: 10 * 60 * 1000,
-        select: (x) => {
-          return x.data as CredentialsMetaResponse[];
-        },
-      },
-    });
-
-  const hardcodedValues = useNodeStore(
-    useShallow((state) => state.getHardCodedValues(nodeId)),
-  );
-
-  const credentialProvider = getCredentialProviderFromSchema(
-    hardcodedValues,
-    credentialSchema,
-  );
-
-  const discriminatorValue = getDiscriminatorValue(
-    hardcodedValues,
-    credentialSchema,
-  );
-
-  const supportsApiKey = credentialSchema.credentials_types.includes("api_key");
-  const supportsOAuth2 = credentialSchema.credentials_types.includes("oauth2");
-  const supportsUserPassword =
-    credentialSchema.credentials_types.includes("user_password");
-  const supportsHostScoped =
-    credentialSchema.credentials_types.includes("host_scoped");
-
-  const { credentials: filteredCredentials, exists: credentialsExists } =
-    filterCredentialsByProvider(
-      credentials,
-      credentialProvider ?? "",
-      credentialSchema,
-      discriminatorValue,
-    );
-
-  const setCredential = (credentialId: string) => {
-    const selectedCredential = filteredCredentials.find(
-      (c) => c.id === credentialId,
-    );
-    if (selectedCredential) {
-      onChange({
-        ...formData,
-        id: selectedCredential.id,
-        provider: selectedCredential.provider,
-        title: selectedCredential.title,
-        type: selectedCredential.type,
-      });
-    }
-  };
-
-  // This side effect is used to clear the hardcoded value in credential formData when the provider changes
-  useEffect(() => {
-    if (!credentialProvider) return;
-    // If provider has changed and we have a credential selected
-    if (
-      previousProviderRef.current !== null &&
-      previousProviderRef.current !== credentialProvider &&
-      formData.id
-    ) {
-      // Check if the current credential belongs to the new provider
-      const currentCredentialBelongsToProvider = filteredCredentials.some(
-        (c) => c.id === formData.id,
-      );
-
-      // If not, clear the credential
-      if (!currentCredentialBelongsToProvider) {
-        onChange({
-          id: "",
-          provider: "",
-          title: "",
-          type: "",
-        });
-      }
-    }
-    previousProviderRef.current = credentialProvider;
-  }, [credentialProvider, formData.id, credentials, onChange]);
-
-  // This side effect is used to auto-select the latest credential when none is selected [latest means last one in the list of credentials]
-  useEffect(() => {
-    if (
-      !isCredentialListLoading &&
-      filteredCredentials.length > 0 &&
-      !formData.id && // No credential currently selected
-      credentialProvider // Provider is set
-    ) {
-      const latestCredential =
-        filteredCredentials[filteredCredentials.length - 1];
-      setCredential(latestCredential.id);
-    }
-  }, [
-    isCredentialListLoading,
-    filteredCredentials.length,
-    formData.id,
-    credentialProvider,
-  ]);
-
-  return {
-    credentials: filteredCredentials,
-    isCredentialListLoading,
-    setCredential,
-    supportsApiKey,
-    supportsOAuth2,
-    supportsUserPassword,
-    supportsHostScoped,
-    credentialsExists,
-    credentialProvider,
-    discriminatorValue,
-  };
-};
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/ObjectField.tsx b/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/ObjectField.tsx
deleted file mode 100644
index 8189116a4e..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/ObjectField.tsx
+++ /dev/null
@@ -1,42 +0,0 @@
-import React from "react";
-import { FieldProps } from "@rjsf/utils";
-import { getDefaultRegistry } from "@rjsf/core";
-import { generateHandleId } from "@/app/(platform)/build/components/FlowEditor/handlers/helpers";
-import { ObjectEditor } from "../widgets/ObjectEditorWidget/ObjectEditorWidget";
-
-export const ObjectField = (props: FieldProps) => {
-  const {
-    schema,
-    formData = {},
-    onChange,
-    name,
-    idSchema,
-    formContext,
-  } = props;
-  const DefaultObjectField = getDefaultRegistry().fields.ObjectField;
-
-  // Let the default field render for root or fixed-schema objects
-  let isFreeForm = false;
-  if ("additionalProperties" in schema || !("properties" in schema)) {
-    isFreeForm = true;
-  }
-
-  if (idSchema?.$id === "root" || !isFreeForm) {
-    // TODO : We need to create better one
-    return <DefaultObjectField {...props} />;
-  }
-
-  const fieldKey = generateHandleId(idSchema.$id ?? "");
-  const { nodeId } = formContext;
-
-  return (
-    <ObjectEditor
-      id={idSchema?.$id ?? ""}
-      nodeId={nodeId}
-      fieldKey={fieldKey}
-      value={formData}
-      onChange={onChange}
-      placeholder={`Enter ${name || "Contact Data"}`}
-    />
-  );
-};
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/index.ts b/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/index.ts
deleted file mode 100644
index 6f826495d1..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/fields/index.ts
+++ /dev/null
@@ -1,10 +0,0 @@
-import { RegistryFieldsType } from "@rjsf/utils";
-import { CredentialsField } from "./CredentialField/CredentialField";
-import { AnyOfField } from "./AnyOfField/AnyOfField";
-import { ObjectField } from "./ObjectField";
-
-export const fields: RegistryFieldsType = {
-  AnyOfField: AnyOfField,
-  credentials: CredentialsField,
-  ObjectField: ObjectField,
-};
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/templates/ArrayFieldTemplate.tsx b/autogpt_platform/frontend/src/components/renderers/input-renderer/templates/ArrayFieldTemplate.tsx
deleted file mode 100644
index e9f708de5a..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/templates/ArrayFieldTemplate.tsx
+++ /dev/null
@@ -1,30 +0,0 @@
-import React from "react";
-import { ArrayFieldTemplateProps } from "@rjsf/utils";
-import { ArrayEditorWidget } from "../widgets/ArrayEditorWidget/ArrayEditorWidget";
-
-function ArrayFieldTemplate(props: ArrayFieldTemplateProps) {
-  const {
-    items,
-    canAdd,
-    onAddClick,
-    disabled,
-    readonly,
-    formContext,
-    idSchema,
-  } = props;
-  const { nodeId } = formContext;
-
-  return (
-    <ArrayEditorWidget
-      items={items}
-      nodeId={nodeId}
-      canAdd={canAdd}
-      onAddClick={onAddClick}
-      disabled={disabled}
-      readonly={readonly}
-      id={idSchema.$id}
-    />
-  );
-}
-
-export default ArrayFieldTemplate;
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/templates/FieldTemplate.tsx b/autogpt_platform/frontend/src/components/renderers/input-renderer/templates/FieldTemplate.tsx
deleted file mode 100644
index ebc8a1f038..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/templates/FieldTemplate.tsx
+++ /dev/null
@@ -1,184 +0,0 @@
-import React, { useContext } from "react";
-import { FieldTemplateProps } from "@rjsf/utils";
-import { InfoIcon } from "@phosphor-icons/react";
-import {
-  Tooltip,
-  TooltipContent,
-  TooltipProvider,
-  TooltipTrigger,
-} from "@/components/atoms/Tooltip/BaseTooltip";
-import { Text } from "@/components/atoms/Text/Text";
-
-import { useEdgeStore } from "@/app/(platform)/build/stores/edgeStore";
-import { useNodeStore } from "@/app/(platform)/build/stores/nodeStore";
-import { generateHandleId } from "@/app/(platform)/build/components/FlowEditor/handlers/helpers";
-import { getTypeDisplayInfo } from "@/app/(platform)/build/components/FlowEditor/nodes/helpers";
-import { ArrayEditorContext } from "../widgets/ArrayEditorWidget/ArrayEditorContext";
-import {
-  isCredentialFieldSchema,
-  toDisplayName,
-  getCredentialProviderFromSchema,
-} from "../fields/CredentialField/helpers";
-import { cn } from "@/lib/utils";
-import { BlockIOCredentialsSubSchema } from "@/lib/autogpt-server-api";
-import { BlockUIType } from "@/lib/autogpt-server-api";
-import NodeHandle from "@/app/(platform)/build/components/FlowEditor/handlers/NodeHandle";
-import { getFieldErrorKey } from "../utils/helpers";
-
-const FieldTemplate: React.FC<FieldTemplateProps> = ({
-  id: fieldId,
-  label,
-  required,
-  description,
-  children,
-  schema,
-  formContext,
-  uiSchema,
-}) => {
-  const { isInputConnected } = useEdgeStore();
-  const { nodeId, showHandles = true, size = "small" } = formContext;
-  const uiType = formContext.uiType;
-
-  const showAdvanced = useNodeStore(
-    (state) => state.nodeAdvancedStates[nodeId] ?? false,
-  );
-
-  const nodeErrors = useNodeStore((state) => {
-    const node = state.nodes.find((n) => n.id === nodeId);
-    return node?.data?.errors;
-  });
-
-  const { isArrayItem, arrayFieldHandleId } = useContext(ArrayEditorContext);
-
-  const isAnyOf =
-    Array.isArray((schema as any)?.anyOf) && !(schema as any)?.enum;
-  const isOneOf = Array.isArray((schema as any)?.oneOf);
-  const isCredential = isCredentialFieldSchema(schema);
-  const suppressHandle = isAnyOf || isOneOf;
-
-  let handleId = null;
-  if (!isArrayItem) {
-    if (uiType === BlockUIType.AGENT) {
-      const parts = fieldId.split("_");
-      const filtered = parts.filter(
-        (p) => p !== "root" && p !== "properties" && p.length > 0,
-      );
-      handleId = filtered.join("_") || "";
-    } else {
-      handleId = generateHandleId(fieldId);
-    }
-  } else {
-    handleId = arrayFieldHandleId;
-  }
-
-  const isConnected = showHandles ? isInputConnected(nodeId, handleId) : false;
-
-  if (!showAdvanced && schema.advanced === true && !isConnected) {
-    return null;
-  }
-
-  const fromAnyOf =
-    Boolean((uiSchema as any)?.["ui:options"]?.fromAnyOf) ||
-    Boolean((formContext as any)?.fromAnyOf);
-
-  const { displayType, colorClass } = getTypeDisplayInfo(schema);
-
-  let credentialProvider = null;
-  if (isCredential) {
-    credentialProvider = getCredentialProviderFromSchema(
-      useNodeStore.getState().getHardCodedValues(nodeId),
-      schema as BlockIOCredentialsSubSchema,
-    );
-  }
-  if (formContext.uiType === BlockUIType.NOTE) {
-    return <div className="w-full space-y-1">{children}</div>;
-  }
-
-  // Size-based styling
-  let shouldShowHandle =
-    showHandles && !suppressHandle && !fromAnyOf && !isCredential;
-
-  // We do not want handle for output block's name field
-  if (uiType === BlockUIType.OUTPUT && fieldId === "root_name") {
-    shouldShowHandle = false;
-  }
-
-  const fieldErrorKey = getFieldErrorKey(fieldId);
-  const fieldError =
-    nodeErrors?.[fieldErrorKey] ||
-    nodeErrors?.[fieldErrorKey.replace(/_/g, ".")] ||
-    nodeErrors?.[fieldErrorKey.replace(/\./g, "_")] ||
-    null;
-
-  return (
-    <div
-      className={cn(
-        "mb-4 space-y-2",
-        fromAnyOf && "mb-0",
-        size === "small" ? "w-[350px]" : "w-full",
-      )}
-    >
-      {!isAnyOf && !fromAnyOf && label && (
-        <label htmlFor={fieldId} className="flex items-center gap-1">
-          {shouldShowHandle && (
-            <NodeHandle
-              handleId={handleId}
-              isConnected={isConnected}
-              side="left"
-            />
-          )}
-          <Text
-            variant={formContext.size === "small" ? "body" : "body-medium"}
-            className={cn(
-              "line-clamp-1",
-              isCredential && !shouldShowHandle && "ml-3",
-              size == "large" && "ml-0",
-              uiType === BlockUIType.OUTPUT &&
-                fieldId === "root_name" &&
-                "ml-3",
-              uiType === BlockUIType.INPUT && "ml-3",
-              uiType === BlockUIType.WEBHOOK && "ml-3",
-              uiType === BlockUIType.WEBHOOK_MANUAL && "ml-3",
-            )}
-          >
-            {isCredential && credentialProvider
-              ? toDisplayName(credentialProvider) + " credentials"
-              : schema.title || label}
-          </Text>
-          <Text variant="small" className={colorClass}>
-            ({displayType})
-          </Text>
-          {required && <span style={{ color: "red" }}>*</span>}
-          {description?.props?.description && (
-            <TooltipProvider>
-              <Tooltip>
-                <TooltipTrigger asChild>
-                  <span
-                    style={{ marginLeft: 6, cursor: "pointer" }}
-                    aria-label="info"
-                    tabIndex={0}
-                  >
-                    <InfoIcon />
-                  </span>
-                </TooltipTrigger>
-                <TooltipContent>{description}</TooltipContent>
-              </Tooltip>
-            </TooltipProvider>
-          )}
-        </label>
-      )}
-      {(isAnyOf || !isConnected) && (
-        <div className={cn(size === "small" ? "max-w-[340px] pl-2" : "")}>
-          {children}
-        </div>
-      )}
-      {fieldError && (
-        <Text variant="small" className="mt-1 pl-4 !text-red-600">
-          {fieldError}
-        </Text>
-      )}
-    </div>
-  );
-};
-
-export default FieldTemplate;
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/templates/index.ts b/autogpt_platform/frontend/src/components/renderers/input-renderer/templates/index.ts
deleted file mode 100644
index 203526cd75..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/templates/index.ts
+++ /dev/null
@@ -1,10 +0,0 @@
-import ArrayFieldTemplate from "./ArrayFieldTemplate";
-import FieldTemplate from "./FieldTemplate";
-
-const NoSubmitButton = () => null;
-
-export const templates = {
-  FieldTemplate,
-  ButtonTemplates: { SubmitButton: NoSubmitButton },
-  ArrayFieldTemplate,
-};
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/ArrayEditorWidget/ArrayEditorContext.tsx b/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/ArrayEditorWidget/ArrayEditorContext.tsx
deleted file mode 100644
index 09fe11bc94..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/ArrayEditorWidget/ArrayEditorContext.tsx
+++ /dev/null
@@ -1,11 +0,0 @@
-import { createContext } from "react";
-
-export const ArrayEditorContext = createContext<{
-  isArrayItem: boolean;
-  arrayFieldHandleId: string;
-  isConnected: boolean;
-}>({
-  isArrayItem: false,
-  arrayFieldHandleId: "",
-  isConnected: false,
-});
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/ArrayEditorWidget/ArrayEditorWidget.tsx b/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/ArrayEditorWidget/ArrayEditorWidget.tsx
deleted file mode 100644
index 01a2af2e40..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/ArrayEditorWidget/ArrayEditorWidget.tsx
+++ /dev/null
@@ -1,92 +0,0 @@
-import { ArrayFieldTemplateItemType, RJSFSchema } from "@rjsf/utils";
-import { ArrayEditorContext } from "./ArrayEditorContext";
-import { Button } from "@/components/atoms/Button/Button";
-import { PlusIcon, XIcon } from "@phosphor-icons/react";
-import { useEdgeStore } from "@/app/(platform)/build/stores/edgeStore";
-import {
-  generateHandleId,
-  HandleIdType,
-} from "@/app/(platform)/build/components/FlowEditor/handlers/helpers";
-
-export interface ArrayEditorProps {
-  items?: ArrayFieldTemplateItemType<any, RJSFSchema, any>[];
-  nodeId: string;
-  canAdd: boolean | undefined;
-  onAddClick?: () => void;
-  disabled: boolean | undefined;
-  readonly: boolean | undefined;
-  id: string;
-}
-
-export const ArrayEditorWidget = ({
-  items,
-  nodeId,
-  canAdd,
-  onAddClick,
-  disabled,
-  readonly,
-  id: fieldId,
-}: ArrayEditorProps) => {
-  const { isInputConnected } = useEdgeStore();
-
-  return (
-    <div className="space-y-2">
-      <div className="flex items-center gap-2">
-        <div className="max-w-[345px] flex-1">
-          {items?.map((element) => {
-            const arrayFieldHandleId = generateHandleId(
-              fieldId,
-              [element.index.toString()],
-              HandleIdType.ARRAY,
-            );
-            const isConnected = isInputConnected(nodeId, arrayFieldHandleId);
-            return (
-              <div
-                key={element.key}
-                className="-ml-2 flex max-w-[350px] items-center gap-2"
-              >
-                <ArrayEditorContext.Provider
-                  value={{
-                    isArrayItem: true,
-                    arrayFieldHandleId: arrayFieldHandleId,
-                    isConnected,
-                  }}
-                >
-                  {element.children}
-                </ArrayEditorContext.Provider>
-
-                {element.hasRemove &&
-                  !readonly &&
-                  !disabled &&
-                  !isConnected && (
-                    <Button
-                      type="button"
-                      variant="secondary"
-                      className="relative top-1.5 min-w-0 p-2 px-3"
-                      size="small"
-                      onClick={element.onDropIndexClick(element.index)}
-                    >
-                      <XIcon className="size-4" />
-                    </Button>
-                  )}
-              </div>
-            );
-          })}
-        </div>
-      </div>
-
-      {canAdd && !readonly && !disabled && (
-        <Button
-          type="button"
-          variant="secondary"
-          size="small"
-          onClick={onAddClick}
-          className="w-full"
-        >
-          <PlusIcon className="mr-2 h-4 w-4" />
-          Add Item
-        </Button>
-      )}
-    </div>
-  );
-};
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/ObjectEditorWidget/ObjectEditorWidget.tsx b/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/ObjectEditorWidget/ObjectEditorWidget.tsx
deleted file mode 100644
index 80d504421d..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/ObjectEditorWidget/ObjectEditorWidget.tsx
+++ /dev/null
@@ -1,183 +0,0 @@
-"use client";
-
-import React from "react";
-import { Plus, X } from "lucide-react";
-import { Text } from "@/components/atoms/Text/Text";
-import { Button } from "@/components/atoms/Button/Button";
-import { Input } from "@/components/atoms/Input/Input";
-import NodeHandle from "@/app/(platform)/build/components/FlowEditor/handlers/NodeHandle";
-import { useEdgeStore } from "@/app/(platform)/build/stores/edgeStore";
-import {
-  generateHandleId,
-  HandleIdType,
-  parseKeyValueHandleId,
-} from "@/app/(platform)/build/components/FlowEditor/handlers/helpers";
-
-export interface ObjectEditorProps {
-  id: string;
-  value?: Record<string, any>;
-  onChange?: (value: Record<string, any>) => void;
-  placeholder?: string;
-  disabled?: boolean;
-  className?: string;
-  nodeId: string;
-  fieldKey: string;
-}
-
-export const ObjectEditor = React.forwardRef<HTMLDivElement, ObjectEditorProps>(
-  (
-    {
-      id: parentFieldId,
-      value = {},
-      onChange,
-      placeholder = "Enter value",
-      disabled = false,
-      className,
-      nodeId,
-    },
-    ref,
-  ) => {
-    const getAllHandleIdsOfANode = useEdgeStore(
-      (state) => state.getAllHandleIdsOfANode,
-    );
-    const setProperty = (key: string, propertyValue: any) => {
-      if (!onChange) return;
-
-      const newData: Record<string, any> = { ...value };
-      if (propertyValue === undefined || propertyValue === "") {
-        delete newData[key];
-      } else {
-        newData[key] = propertyValue;
-      }
-      onChange(newData);
-    };
-
-    const addProperty = () => {
-      if (!onChange) return;
-      onChange({ ...value, [""]: "" });
-    };
-
-    const removeProperty = (key: string) => {
-      if (!onChange) return;
-      const newData = { ...value };
-      delete newData[key];
-      onChange(newData);
-    };
-
-    const updateKey = (oldKey: string, newKey: string) => {
-      if (!onChange || oldKey === newKey) return;
-
-      const propertyValue = value[oldKey];
-      const newData: Record<string, any> = { ...value };
-      delete newData[oldKey];
-      newData[newKey] = propertyValue;
-      onChange(newData);
-    };
-
-    const hasEmptyKeys = Object.keys(value).some((key) => key.trim() === "");
-
-    const { isInputConnected } = useEdgeStore();
-
-    const allHandleIdsOfANode = getAllHandleIdsOfANode(nodeId);
-    const allKeyValueHandleIdsOfANode = allHandleIdsOfANode.filter((handleId) =>
-      handleId.includes("_#_"),
-    );
-    allKeyValueHandleIdsOfANode.forEach((handleId) => {
-      const key = parseKeyValueHandleId(handleId, HandleIdType.KEY_VALUE);
-      if (!value[key]) {
-        value[key] = null;
-      }
-    });
-
-    // Note: ObjectEditor is always used in node context, so showHandles is always true
-    // If you need to use it in dialog context, you'll need to pass showHandles via props
-    const showHandles = true;
-
-    return (
-      <div
-        ref={ref}
-        className={`flex flex-col gap-2 ${className || ""}`}
-        id={parentFieldId}
-      >
-        {Object.entries(value).map(([key, propertyValue], idx) => {
-          const handleId = generateHandleId(
-            parentFieldId,
-            [key],
-            HandleIdType.KEY_VALUE,
-          );
-          const isDynamicPropertyConnected = isInputConnected(nodeId, handleId);
-
-          return (
-            <div key={idx} className="flex flex-col gap-2">
-              <div className="-ml-2 flex items-center gap-1">
-                {showHandles && (
-                  <NodeHandle
-                    isConnected={isDynamicPropertyConnected}
-                    handleId={handleId}
-                    side="left"
-                  />
-                )}
-                <Text variant="small" className="!text-gray-500">
-                  #{key.trim() === "" ? "" : key}
-                </Text>
-                <Text variant="small" className="!text-green-500">
-                  (string)
-                </Text>
-              </div>
-              {!isDynamicPropertyConnected && (
-                <div className="flex items-center gap-2">
-                  <Input
-                    hideLabel={true}
-                    label=""
-                    id={`key-${idx}`}
-                    size="small"
-                    value={key}
-                    onChange={(e) => updateKey(key, e.target.value)}
-                    placeholder="Key"
-                    wrapperClassName="mb-0"
-                    disabled={disabled}
-                  />
-                  <Input
-                    hideLabel={true}
-                    label=""
-                    id={`value-${idx}`}
-                    size="small"
-                    value={propertyValue ?? ""}
-                    onChange={(e) => setProperty(key, e.target.value)}
-                    placeholder={placeholder}
-                    wrapperClassName="mb-0"
-                    disabled={disabled}
-                  />
-                  <Button
-                    type="button"
-                    variant="secondary"
-                    size="small"
-                    className="min-w-10"
-                    onClick={() => removeProperty(key)}
-                    disabled={disabled}
-                  >
-                    <X className="h-4 w-4" />
-                  </Button>
-                </div>
-              )}
-            </div>
-          );
-        })}
-
-        <Button
-          type="button"
-          variant="secondary"
-          size="small"
-          onClick={addProperty}
-          className="w-fit"
-          disabled={hasEmptyKeys || disabled}
-        >
-          <Plus className="h-4 w-4" />
-          Add Property
-        </Button>
-      </div>
-    );
-  },
-);
-
-ObjectEditor.displayName = "ObjectEditor";
diff --git a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/index.ts b/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/index.ts
deleted file mode 100644
index 3788e74fbf..0000000000
--- a/autogpt_platform/frontend/src/components/renderers/input-renderer/widgets/index.ts
+++ /dev/null
@@ -1,18 +0,0 @@
-import { RegistryWidgetsType } from "@rjsf/utils";
-import { SelectWidget } from "./SelectWidget";
-import { TextInputWidget } from "./TextInputWidget/TextInputWidget";
-import { SwitchWidget } from "./SwitchWidget";
-import { FileWidget } from "./FileWidget";
-import { DateInputWidget } from "./DateInputWidget";
-import { TimeInputWidget } from "./TimeInputWidget";
-import { DateTimeInputWidget } from "./DateTimeInputWidget";
-
-export const widgets: RegistryWidgetsType = {
-  TextWidget: TextInputWidget,
-  SelectWidget: SelectWidget,
-  CheckboxWidget: SwitchWidget,
-  FileWidget: FileWidget,
-  DateWidget: DateInputWidget,
-  TimeWidget: TimeInputWidget,
-  DateTimeWidget: DateTimeInputWidget,
-};
diff --git a/autogpt_platform/frontend/src/components/ui/accordion.tsx b/autogpt_platform/frontend/src/components/ui/accordion.tsx
new file mode 100644
index 0000000000..47216c6d9e
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/ui/accordion.tsx
@@ -0,0 +1,57 @@
+"use client";
+
+import * as AccordionPrimitive from "@radix-ui/react-accordion";
+import { ChevronDown } from "lucide-react";
+import * as React from "react";
+
+import { cn } from "@/lib/utils";
+
+const Accordion = AccordionPrimitive.Root;
+
+const AccordionItem = React.forwardRef<
+  React.ElementRef<typeof AccordionPrimitive.Item>,
+  React.ComponentPropsWithoutRef<typeof AccordionPrimitive.Item>
+>(({ className, ...props }, ref) => (
+  <AccordionPrimitive.Item
+    ref={ref}
+    className={cn("border-b", className)}
+    {...props}
+  />
+));
+AccordionItem.displayName = "AccordionItem";
+
+const AccordionTrigger = React.forwardRef<
+  React.ElementRef<typeof AccordionPrimitive.Trigger>,
+  React.ComponentPropsWithoutRef<typeof AccordionPrimitive.Trigger>
+>(({ className, children, ...props }, ref) => (
+  <AccordionPrimitive.Header className="flex">
+    <AccordionPrimitive.Trigger
+      ref={ref}
+      className={cn(
+        "flex flex-1 items-center justify-between py-4 text-left text-sm font-medium transition-all hover:underline [&[data-state=open]>svg]:rotate-180",
+        className,
+      )}
+      {...props}
+    >
+      {children}
+      <ChevronDown className="h-4 w-4 shrink-0 text-neutral-500 transition-transform duration-200 dark:text-neutral-400" />
+    </AccordionPrimitive.Trigger>
+  </AccordionPrimitive.Header>
+));
+AccordionTrigger.displayName = AccordionPrimitive.Trigger.displayName;
+
+const AccordionContent = React.forwardRef<
+  React.ElementRef<typeof AccordionPrimitive.Content>,
+  React.ComponentPropsWithoutRef<typeof AccordionPrimitive.Content>
+>(({ className, children, ...props }, ref) => (
+  <AccordionPrimitive.Content
+    ref={ref}
+    className="overflow-hidden text-sm data-[state=closed]:animate-accordion-up data-[state=open]:animate-accordion-down"
+    {...props}
+  >
+    <div className={cn("pb-4 pt-0", className)}>{children}</div>
+  </AccordionPrimitive.Content>
+));
+AccordionContent.displayName = AccordionPrimitive.Content.displayName;
+
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger };
diff --git a/autogpt_platform/frontend/src/hooks/useAgentGraph.tsx b/autogpt_platform/frontend/src/hooks/useAgentGraph.tsx
index 16304e509c..6c097c395e 100644
--- a/autogpt_platform/frontend/src/hooks/useAgentGraph.tsx
+++ b/autogpt_platform/frontend/src/hooks/useAgentGraph.tsx
@@ -233,13 +233,14 @@ export default function useAgentGraph(
         title: `${block.name} ${node.id}`,
         inputSchema: block.inputSchema,
         outputSchema: block.outputSchema,
+        isOutputStatic: block.staticOutput,
         hardcodedValues: node.input_default,
         uiType: block.uiType,
         metadata: metadata,
         connections: graph.links
           .filter((l) => [l.source_id, l.sink_id].includes(node.id))
           .map((link) => ({
-            edge_id: formatEdgeID(link),
+            id: formatEdgeID(link),
             source: link.source_id,
             sourceHandle: link.source_name,
             target: link.sink_id,
diff --git a/autogpt_platform/frontend/src/hooks/useLibraryAgents/store.ts b/autogpt_platform/frontend/src/hooks/useLibraryAgents/store.ts
index 4a6e08d717..e84d997dd0 100644
--- a/autogpt_platform/frontend/src/hooks/useLibraryAgents/store.ts
+++ b/autogpt_platform/frontend/src/hooks/useLibraryAgents/store.ts
@@ -1,114 +1,7 @@
-import { create } from "zustand";
-import * as Sentry from "@sentry/nextjs";
-import { storage, Key } from "@/services/storage/local-storage";
-import {
-  getV2ListLibraryAgents,
-  type getV2ListLibraryAgentsResponse,
-} from "@/app/api/__generated__/endpoints/library/library";
 import type { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
 
 export type AgentInfo = LibraryAgent;
 
-type AgentStore = {
-  agents: AgentInfo[];
-  lastUpdatedAt?: number;
-  isRefreshing: boolean;
-  error?: unknown;
-  loadFromCache: () => void;
-  refreshAll: () => Promise<void>;
-};
-
-type CachedAgents = {
-  agents: LibraryAgent[];
-  lastUpdatedAt: number;
-};
-
-async function fetchAllLibraryAgents() {
-  const pageSize = 100;
-  let page = 1;
-  const all: LibraryAgent[] = [];
-
-  let res: getV2ListLibraryAgentsResponse | undefined;
-  try {
-    res = await getV2ListLibraryAgents({ page, page_size: pageSize });
-  } catch (err) {
-    Sentry.captureException(err, { tags: { context: "library_agents_fetch" } });
-    throw err;
-  }
-
-  if (!res || res.status !== 200) return all;
-
-  const { agents, pagination } = res.data;
-  all.push(...agents);
-
-  const totalPages = pagination?.total_pages ?? 1;
-
-  for (page = 2; page <= totalPages; page += 1) {
-    try {
-      const next = await getV2ListLibraryAgents({ page, page_size: pageSize });
-      if (next.status === 200) {
-        all.push(...next.data.agents);
-      }
-    } catch (err) {
-      Sentry.captureException(err, {
-        tags: { context: "library_agents_fetch" },
-      });
-    }
-  }
-
-  return all;
-}
-
-function persistCache(cached: CachedAgents) {
-  try {
-    storage.set(Key.LIBRARY_AGENTS_CACHE, JSON.stringify(cached));
-  } catch (error) {
-    // Ignore cache failures
-    // eslint-disable-next-line no-console
-    console.error("Failed to persist library agents cache", error);
-    Sentry.captureException(error, {
-      tags: { context: "library_agents_cache_persist" },
-    });
-  }
-}
-
-function readCache(): CachedAgents | undefined {
-  try {
-    const raw = storage.get(Key.LIBRARY_AGENTS_CACHE);
-    if (!raw) return;
-    return JSON.parse(raw) as CachedAgents;
-  } catch {
-    return;
-  }
-}
-
-export const useLibraryAgentsStore = create<AgentStore>((set, get) => ({
-  agents: [],
-  lastUpdatedAt: undefined,
-  isRefreshing: false,
-  error: undefined,
-  loadFromCache: () => {
-    const cached = readCache();
-    if (cached?.agents?.length) {
-      set({ agents: cached.agents, lastUpdatedAt: cached.lastUpdatedAt });
-    }
-  },
-  refreshAll: async () => {
-    if (get().isRefreshing) return;
-    set({ isRefreshing: true, error: undefined });
-    try {
-      const agents = await fetchAllLibraryAgents();
-      const snapshot: CachedAgents = { agents, lastUpdatedAt: Date.now() };
-      persistCache(snapshot);
-      set({ agents, lastUpdatedAt: snapshot.lastUpdatedAt });
-    } catch (error) {
-      set({ error });
-    } finally {
-      set({ isRefreshing: false });
-    }
-  },
-}));
-
 export function buildAgentInfoMap(agents: AgentInfo[]) {
   const map = new Map<
     string,
diff --git a/autogpt_platform/frontend/src/hooks/useLibraryAgents/useLibraryAgents.ts b/autogpt_platform/frontend/src/hooks/useLibraryAgents/useLibraryAgents.ts
index 906b822794..8f0fc51405 100644
--- a/autogpt_platform/frontend/src/hooks/useLibraryAgents/useLibraryAgents.ts
+++ b/autogpt_platform/frontend/src/hooks/useLibraryAgents/useLibraryAgents.ts
@@ -1,21 +1,34 @@
-import { useEffect, useMemo } from "react";
-import { buildAgentInfoMap, useLibraryAgentsStore } from "./store";
-
-let initialized = false;
+import { useGetV2ListLibraryAgentsInfinite } from "@/app/api/__generated__/endpoints/library/library";
+import { getPaginationNextPageNumber, unpaginate } from "@/app/api/helpers";
+import { useMemo } from "react";
+import { buildAgentInfoMap } from "./store";
 
 export function useLibraryAgents() {
-  const { agents, isRefreshing, lastUpdatedAt, loadFromCache, refreshAll } =
-    useLibraryAgentsStore();
+  const { data: agentsQueryData, isLoading: isRefreshing } =
+    useGetV2ListLibraryAgentsInfinite(
+      {
+        page: 1,
+        page_size: 100,
+      },
+      {
+        query: {
+          getNextPageParam: getPaginationNextPageNumber,
+          // Don't block rendering - fetch in background
+          refetchOnMount: false,
+          refetchOnWindowFocus: false,
+          staleTime: 5 * 60 * 1000, // 5 minutes
+        },
+      },
+    );
 
-  useEffect(() => {
-    if (!initialized) {
-      loadFromCache();
-      void refreshAll();
-      initialized = true;
-    }
-  }, [loadFromCache, refreshAll]);
+  const agents = agentsQueryData ? unpaginate(agentsQueryData, "agents") : [];
 
-  const agentInfoMap = useMemo(() => buildAgentInfoMap(agents), [agents]);
+  // Use agents.length as dependency to avoid recreating map unnecessarily
+  const agentInfoMap = useMemo(
+    () => buildAgentInfoMap(agents),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [agents.length, agents.map((a) => a.id).join(",")],
+  );
 
-  return { agents, agentInfoMap, isRefreshing, lastUpdatedAt };
+  return { agents, agentInfoMap, isRefreshing, lastUpdatedAt: undefined };
 }
diff --git a/autogpt_platform/frontend/src/lib/autogpt-server-api/client.ts b/autogpt_platform/frontend/src/lib/autogpt-server-api/client.ts
index 682fc14108..e58b5f6020 100644
--- a/autogpt_platform/frontend/src/lib/autogpt-server-api/client.ts
+++ b/autogpt_platform/frontend/src/lib/autogpt-server-api/client.ts
@@ -352,6 +352,10 @@ export default class BackendAPI {
     return this._get("/integrations/providers");
   }
 
+  listSystemProviders(): Promise<string[]> {
+    return this._get("/integrations/providers/system");
+  }
+
   listCredentials(provider?: string): Promise<CredentialsMetaResponse[]> {
     return this._get(
       provider
diff --git a/autogpt_platform/frontend/src/lib/autogpt-server-api/types.ts b/autogpt_platform/frontend/src/lib/autogpt-server-api/types.ts
index 2f27ef126d..82c03bc9f1 100644
--- a/autogpt_platform/frontend/src/lib/autogpt-server-api/types.ts
+++ b/autogpt_platform/frontend/src/lib/autogpt-server-api/types.ts
@@ -245,8 +245,8 @@ export type BlockIONullSubSchema = BlockIOSubSchemaMeta & {
 // At the time of writing, combined schemas only occur on the first nested level in a
 // block schema. It is typed this way to make the use of these objects less tedious.
 type BlockIOCombinedTypeSubSchema = BlockIOSubSchemaMeta & {
-  type: never;
-  const: never;
+  type?: never;
+  const?: never;
 } & (
     | {
         allOf: [BlockIOSimpleTypeSubSchema];
@@ -327,8 +327,8 @@ export type GraphExecutionMeta = {
     | "FAILED"
     | "INCOMPLETE"
     | "REVIEW";
-  started_at: Date;
-  ended_at: Date;
+  started_at: Date | null;
+  ended_at: Date | null;
   stats: {
     error: string | null;
     cost: number;
@@ -368,8 +368,8 @@ export type GraphMeta = {
   recommended_schedule_cron: string | null;
   forked_from_id?: GraphID | null;
   forked_from_version?: number | null;
-  input_schema: GraphIOSchema;
-  output_schema: GraphIOSchema;
+  input_schema: GraphInputSchema;
+  output_schema: GraphOutputSchema;
   credentials_input_schema: CredentialsInputSchema;
 } & (
   | {
@@ -385,19 +385,51 @@ export type GraphMeta = {
 export type GraphID = Brand<string, "GraphID">;
 
 /* Derived from backend/data/graph.py:Graph._generate_schema() */
-export type GraphIOSchema = {
+export type GraphInputSchema = {
   type: "object";
-  properties: Record<string, GraphIOSubSchema>;
-  required: (keyof BlockIORootSchema["properties"])[];
+  properties: Record<string, GraphInputSubSchema>;
+  required: (keyof GraphInputSchema["properties"])[];
 };
-export type GraphIOSubSchema = Omit<
-  BlockIOSubSchemaMeta,
-  "placeholder" | "depends_on" | "hidden"
-> & {
-  type: never; // bodge to avoid type checking hell; doesn't exist at runtime
-  default?: string;
+export type GraphInputSubSchema = GraphOutputSubSchema &
+  (
+    | { type?: never; default: any | null } // AgentInputBlock (generic Any type)
+    | { type: "string"; format: "short-text"; default: string | null } // AgentShortTextInputBlock
+    | { type: "string"; format: "long-text"; default: string | null } // AgentLongTextInputBlock
+    | { type: "integer"; default: number | null } // AgentNumberInputBlock
+    | { type: "string"; format: "date"; default: string | null } // AgentDateInputBlock
+    | { type: "string"; format: "time"; default: string | null } // AgentTimeInputBlock
+    | { type: "string"; format: "file"; default: string | null } // AgentFileInputBlock
+    | { type: "string"; enum: string[]; default: string | null } // AgentDropdownInputBlock
+    | { type: "boolean"; default: boolean } // AgentToggleInputBlock
+    | {
+        // AgentTableInputBlock
+        type: "array";
+        format: "table";
+        items: {
+          type: "object";
+          properties: Record<string, { type: "string" }>;
+        };
+        default: Array<Record<string, string>> | null;
+      }
+    | {
+        // AgentGoogleDriveFileInputBlock
+        type: "object";
+        format: "google-drive-picker";
+        google_drive_picker_config?: GoogleDrivePickerConfig;
+        default: GoogleDriveFile | null;
+      }
+  );
+export type GraphOutputSchema = {
+  type: "object";
+  properties: Record<string, GraphOutputSubSchema>;
+  required: (keyof GraphOutputSchema["properties"])[];
+};
+export type GraphOutputSubSchema = {
+  // TODO: typed outputs based on the incoming edges?
+  title: string;
+  description?: string;
+  advanced: boolean;
   secret: boolean;
-  metadata?: any;
 };
 
 export type CredentialsInputSchema = {
@@ -440,8 +472,8 @@ export type GraphUpdateable = Omit<
   is_active?: boolean;
   nodes: NodeCreatable[];
   links: LinkCreatable[];
-  input_schema?: GraphIOSchema;
-  output_schema?: GraphIOSchema;
+  input_schema?: GraphInputSchema;
+  output_schema?: GraphOutputSchema;
 };
 
 export type GraphCreatable = _GraphCreatableInner & {
@@ -497,8 +529,8 @@ export type LibraryAgent = {
   name: string;
   description: string;
   instructions?: string | null;
-  input_schema: GraphIOSchema;
-  output_schema: GraphIOSchema;
+  input_schema: GraphInputSchema;
+  output_schema: GraphOutputSchema;
   credentials_input_schema: CredentialsInputSchema;
   new_output: boolean;
   can_access_graph: boolean;
@@ -593,6 +625,7 @@ export type CredentialsMetaResponse = {
   scopes?: Array<string>;
   username?: string;
   host?: string;
+  is_system?: boolean;
 };
 
 /* Mirror of backend/server/integrations/router.py:CredentialsDeletionResponse */
diff --git a/autogpt_platform/frontend/src/lib/dexie/db.ts b/autogpt_platform/frontend/src/lib/dexie/db.ts
new file mode 100644
index 0000000000..05e749ca4b
--- /dev/null
+++ b/autogpt_platform/frontend/src/lib/dexie/db.ts
@@ -0,0 +1,46 @@
+import Dexie, { type EntityTable } from "dexie";
+import type { CustomNode } from "@/app/(platform)/build/components/FlowEditor/nodes/CustomNode/CustomNode";
+import type { CustomEdge } from "@/app/(platform)/build/components/FlowEditor/edges/CustomEdge";
+
+// 24 hrs expiry
+export const DRAFT_EXPIRY_MS = 24 * 60 * 60 * 1000;
+
+export interface BuilderDraft {
+  id: string;
+  nodes: CustomNode[];
+  edges: CustomEdge[];
+  graphSchemas: {
+    input: Record<string, unknown> | null;
+    credentials: Record<string, unknown> | null;
+    output: Record<string, unknown> | null;
+  };
+  nodeCounter: number;
+  savedAt: number;
+  flowVersion?: number;
+}
+
+class BuilderDatabase extends Dexie {
+  drafts!: EntityTable<BuilderDraft, "id">;
+
+  constructor() {
+    super("AutoGPTBuilderDB");
+
+    this.version(1).stores({
+      drafts: "id, savedAt",
+    });
+  }
+}
+
+// Singleton database instance
+export const db = new BuilderDatabase();
+
+export async function cleanupExpiredDrafts(): Promise<number> {
+  const expiryThreshold = Date.now() - DRAFT_EXPIRY_MS;
+
+  const deletedCount = await db.drafts
+    .where("savedAt")
+    .below(expiryThreshold)
+    .delete();
+
+  return deletedCount;
+}
diff --git a/autogpt_platform/frontend/src/lib/dexie/draft-utils.ts b/autogpt_platform/frontend/src/lib/dexie/draft-utils.ts
new file mode 100644
index 0000000000..03232ede30
--- /dev/null
+++ b/autogpt_platform/frontend/src/lib/dexie/draft-utils.ts
@@ -0,0 +1,112 @@
+import type { CustomNode } from "@/app/(platform)/build/components/FlowEditor/nodes/CustomNode/CustomNode";
+import type { CustomEdge } from "@/app/(platform)/build/components/FlowEditor/edges/CustomEdge";
+import isEqual from "lodash/isEqual";
+
+export function cleanNode(node: CustomNode) {
+  return {
+    id: node.id,
+    position: node.position,
+    data: {
+      hardcodedValues: node.data.hardcodedValues,
+      title: node.data.title,
+      block_id: node.data.block_id,
+      metadata: node.data.metadata,
+    },
+  };
+}
+
+export function cleanEdge(edge: CustomEdge) {
+  return {
+    id: edge.id,
+    source: edge.source,
+    target: edge.target,
+    sourceHandle: edge.sourceHandle,
+    targetHandle: edge.targetHandle,
+  };
+}
+
+export function cleanNodes(nodes: CustomNode[]) {
+  return nodes.map(cleanNode);
+}
+
+export function cleanEdges(edges: CustomEdge[]) {
+  return edges.map(cleanEdge);
+}
+
+export interface DraftDiff {
+  nodes: {
+    added: number;
+    removed: number;
+    modified: number;
+  };
+  edges: {
+    added: number;
+    removed: number;
+    modified: number;
+  };
+}
+
+/**
+ * Calculate the diff between draft and current nodes/edges.
+ * - Added: items in draft but not in current (will be restored)
+ * - Removed: items in current but not in draft (will be removed if draft is loaded)
+ * - Modified: items with same ID but different content
+ */
+export function calculateDraftDiff(
+  draftNodes: CustomNode[],
+  draftEdges: CustomEdge[],
+  currentNodes: CustomNode[],
+  currentEdges: CustomEdge[],
+): DraftDiff {
+  const draftNodeIds = new Set(draftNodes.map((n) => n.id));
+  const currentNodeIds = new Set(currentNodes.map((n) => n.id));
+  const draftEdgeIds = new Set(draftEdges.map((e) => e.id));
+  const currentEdgeIds = new Set(currentEdges.map((e) => e.id));
+
+  // Nodes diff
+  const nodesAdded = draftNodes.filter((n) => !currentNodeIds.has(n.id)).length;
+  const nodesRemoved = currentNodes.filter(
+    (n) => !draftNodeIds.has(n.id),
+  ).length;
+
+  // Modified nodes: same ID but different content
+  const draftNodeMap = new Map(draftNodes.map((n) => [n.id, cleanNode(n)]));
+  const currentNodeMap = new Map(currentNodes.map((n) => [n.id, cleanNode(n)]));
+  let nodesModified = 0;
+  for (const [id, draftClean] of draftNodeMap) {
+    const currentClean = currentNodeMap.get(id);
+    if (currentClean && !isEqual(draftClean, currentClean)) {
+      nodesModified++;
+    }
+  }
+
+  // Edges diff
+  const edgesAdded = draftEdges.filter((e) => !currentEdgeIds.has(e.id)).length;
+  const edgesRemoved = currentEdges.filter(
+    (e) => !draftEdgeIds.has(e.id),
+  ).length;
+
+  // Modified edges: same ID but different content
+  const draftEdgeMap = new Map(draftEdges.map((e) => [e.id, cleanEdge(e)]));
+  const currentEdgeMap = new Map(currentEdges.map((e) => [e.id, cleanEdge(e)]));
+  let edgesModified = 0;
+  for (const [id, draftClean] of draftEdgeMap) {
+    const currentClean = currentEdgeMap.get(id);
+    if (currentClean && !isEqual(draftClean, currentClean)) {
+      edgesModified++;
+    }
+  }
+
+  return {
+    nodes: {
+      added: nodesAdded,
+      removed: nodesRemoved,
+      modified: nodesModified,
+    },
+    edges: {
+      added: edgesAdded,
+      removed: edgesRemoved,
+      modified: edgesModified,
+    },
+  };
+}
diff --git a/autogpt_platform/frontend/src/lib/utils.ts b/autogpt_platform/frontend/src/lib/utils.ts
index 71f38aeb33..d3abc56b6c 100644
--- a/autogpt_platform/frontend/src/lib/utils.ts
+++ b/autogpt_platform/frontend/src/lib/utils.ts
@@ -6,7 +6,10 @@ import { NodeDimension } from "@/app/(platform)/build/components/legacy-builder/
 import {
   BlockIOObjectSubSchema,
   BlockIORootSchema,
+  BlockIOSubSchema,
   Category,
+  GraphInputSubSchema,
+  GraphOutputSubSchema,
 } from "@/lib/autogpt-server-api/types";
 
 export function cn(...inputs: ClassValue[]) {
@@ -76,8 +79,8 @@ export function getTypeBgColor(type: string | null): string {
   );
 }
 
-export function getTypeColor(type: string | null): string {
-  if (type === null) return "#6b7280";
+export function getTypeColor(type: string | undefined): string {
+  if (!type) return "#6b7280";
   return (
     {
       string: "#22c55e",
@@ -88,11 +91,59 @@ export function getTypeColor(type: string | null): string {
       array: "#6366f1",
       null: "#6b7280",
       any: "#6b7280",
-      "": "#6b7280",
     }[type] || "#6b7280"
   );
 }
 
+/**
+ * Extracts the effective type from a JSON schema, handling anyOf/oneOf/allOf wrappers.
+ * Returns the first non-null type found in the schema structure.
+ */
+export function getEffectiveType(
+  schema:
+    | BlockIOSubSchema
+    | GraphInputSubSchema
+    | GraphOutputSubSchema
+    | null
+    | undefined,
+): string | undefined {
+  if (!schema) return undefined;
+
+  // Direct type property
+  if ("type" in schema && schema.type) {
+    return String(schema.type);
+  }
+
+  // Handle allOf - typically a single-item wrapper
+  if (
+    "allOf" in schema &&
+    Array.isArray(schema.allOf) &&
+    schema.allOf.length > 0
+  ) {
+    return getEffectiveType(schema.allOf[0]);
+  }
+
+  // Handle anyOf - e.g. [{ type: "string" }, { type: "null" }]
+  if ("anyOf" in schema && Array.isArray(schema.anyOf)) {
+    for (const item of schema.anyOf) {
+      if ("type" in item && item.type !== "null") {
+        return String(item.type);
+      }
+    }
+  }
+
+  // Handle oneOf
+  if ("oneOf" in schema && Array.isArray(schema.oneOf)) {
+    for (const item of schema.oneOf) {
+      if ("type" in item && item.type !== "null") {
+        return String(item.type);
+      }
+    }
+  }
+
+  return undefined;
+}
+
 export function beautifyString(name: string): string {
   // Regular expression to identify places to split, considering acronyms
   const result = name
@@ -445,3 +496,9 @@ export function validateYouTubeUrl(val: string): boolean {
     return false;
   }
 }
+
+export function isValidUUID(value: string): boolean {
+  const uuidRegex =
+    /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+  return uuidRegex.test(value);
+}
diff --git a/autogpt_platform/frontend/src/providers/agent-credentials/credentials-provider.tsx b/autogpt_platform/frontend/src/providers/agent-credentials/credentials-provider.tsx
index bf6b91205d..e47cc65e13 100644
--- a/autogpt_platform/frontend/src/providers/agent-credentials/credentials-provider.tsx
+++ b/autogpt_platform/frontend/src/providers/agent-credentials/credentials-provider.tsx
@@ -1,5 +1,4 @@
-import { createContext, useCallback, useEffect, useState } from "react";
-import { useSupabase } from "@/lib/supabase/hooks/useSupabase";
+import { useToastOnFail } from "@/components/molecules/Toast/use-toast";
 import {
   APIKeyCredentials,
   CredentialsDeleteNeedConfirmationResponse,
@@ -10,8 +9,9 @@ import {
   UserPasswordCredentials,
 } from "@/lib/autogpt-server-api";
 import { useBackendAPI } from "@/lib/autogpt-server-api/context";
-import { useToastOnFail } from "@/components/molecules/Toast/use-toast";
+import { useSupabase } from "@/lib/supabase/hooks/useSupabase";
 import { toDisplayName } from "@/providers/agent-credentials/helper";
+import { createContext, useCallback, useEffect, useState } from "react";
 
 type APIKeyCredentialsCreatable = Omit<
   APIKeyCredentials,
@@ -32,6 +32,8 @@ export type CredentialsProviderData = {
   provider: CredentialsProviderName;
   providerName: string;
   savedCredentials: CredentialsMetaResponse[];
+  /** Whether this provider has platform credits available (system credentials) */
+  isSystemProvider: boolean;
   oAuthCallback: (
     code: string,
     state_token: string,
@@ -68,6 +70,9 @@ export default function CredentialsProvider({
   const [providers, setProviders] =
     useState<CredentialsProvidersContextType | null>(null);
   const [providerNames, setProviderNames] = useState<string[]>([]);
+  const [systemProviders, setSystemProviders] = useState<Set<string>>(
+    new Set(),
+  );
   const { isLoggedIn } = useSupabase();
   const api = useBackendAPI();
   const onFailToast = useToastOnFail();
@@ -218,17 +223,7 @@ export default function CredentialsProvider({
     [api, onFailToast],
   );
 
-  // Fetch provider names on mount
-  useEffect(() => {
-    api
-      .listProviders()
-      .then((names) => {
-        setProviderNames(names);
-      })
-      .catch(onFailToast("load provider names"));
-  }, [api, onFailToast]);
-
-  useEffect(() => {
+  const loadCredentials = useCallback(() => {
     if (!isLoggedIn || providerNames.length === 0) {
       if (isLoggedIn == false) setProviders({});
       return;
@@ -251,27 +246,32 @@ export default function CredentialsProvider({
         setProviders((prev) => ({
           ...prev,
           ...Object.fromEntries(
-            providerNames.map((provider) => [
-              provider,
-              {
+            providerNames.map((provider) => {
+              const providerCredentials = credentialsByProvider[provider] ?? [];
+
+              return [
                 provider,
-                providerName: toDisplayName(provider as string),
-                savedCredentials: credentialsByProvider[provider] ?? [],
-                oAuthCallback: (code: string, state_token: string) =>
-                  oAuthCallback(provider, code, state_token),
-                createAPIKeyCredentials: (
-                  credentials: APIKeyCredentialsCreatable,
-                ) => createAPIKeyCredentials(provider, credentials),
-                createUserPasswordCredentials: (
-                  credentials: UserPasswordCredentialsCreatable,
-                ) => createUserPasswordCredentials(provider, credentials),
-                createHostScopedCredentials: (
-                  credentials: HostScopedCredentialsCreatable,
-                ) => createHostScopedCredentials(provider, credentials),
-                deleteCredentials: (id: string, force: boolean = false) =>
-                  deleteCredentials(provider, id, force),
-              } satisfies CredentialsProviderData,
-            ]),
+                {
+                  provider,
+                  providerName: toDisplayName(provider as string),
+                  savedCredentials: providerCredentials,
+                  isSystemProvider: systemProviders.has(provider),
+                  oAuthCallback: (code: string, state_token: string) =>
+                    oAuthCallback(provider, code, state_token),
+                  createAPIKeyCredentials: (
+                    credentials: APIKeyCredentialsCreatable,
+                  ) => createAPIKeyCredentials(provider, credentials),
+                  createUserPasswordCredentials: (
+                    credentials: UserPasswordCredentialsCreatable,
+                  ) => createUserPasswordCredentials(provider, credentials),
+                  createHostScopedCredentials: (
+                    credentials: HostScopedCredentialsCreatable,
+                  ) => createHostScopedCredentials(provider, credentials),
+                  deleteCredentials: (id: string, force: boolean = false) =>
+                    deleteCredentials(provider, id, force),
+                } satisfies CredentialsProviderData,
+              ];
+            }),
           ),
         }));
       })
@@ -280,6 +280,7 @@ export default function CredentialsProvider({
     api,
     isLoggedIn,
     providerNames,
+    systemProviders,
     createAPIKeyCredentials,
     createUserPasswordCredentials,
     createHostScopedCredentials,
@@ -288,6 +289,20 @@ export default function CredentialsProvider({
     onFailToast,
   ]);
 
+  // Fetch provider names and system providers on mount
+  useEffect(() => {
+    Promise.all([api.listProviders(), api.listSystemProviders()])
+      .then(([names, systemList]) => {
+        setProviderNames(names);
+        setSystemProviders(new Set(systemList));
+      })
+      .catch(onFailToast("Load provider names"));
+  }, [api, onFailToast]);
+
+  useEffect(() => {
+    loadCredentials();
+  }, [loadCredentials]);
+
   return (
     <CredentialsProvidersContext.Provider value={providers}>
       {children}
diff --git a/autogpt_platform/frontend/src/services/builder-draft/draft-service.ts b/autogpt_platform/frontend/src/services/builder-draft/draft-service.ts
new file mode 100644
index 0000000000..6d35d23bf4
--- /dev/null
+++ b/autogpt_platform/frontend/src/services/builder-draft/draft-service.ts
@@ -0,0 +1,118 @@
+import {
+  db,
+  BuilderDraft,
+  DRAFT_EXPIRY_MS,
+  cleanupExpiredDrafts,
+} from "../../lib/dexie/db";
+import type { CustomNode } from "@/app/(platform)/build/components/FlowEditor/nodes/CustomNode/CustomNode";
+import type { CustomEdge } from "@/app/(platform)/build/components/FlowEditor/edges/CustomEdge";
+import { cleanNodes, cleanEdges } from "../../lib/dexie/draft-utils";
+import isEqual from "lodash/isEqual";
+import { environment } from "@/services/environment";
+
+const SESSION_TEMP_ID_KEY = "builder_temp_flow_id";
+
+export function getOrCreateTempFlowId(): string {
+  if (environment.isServerSide()) {
+    return `temp_${crypto.randomUUID()}`;
+  }
+
+  let tempId = sessionStorage.getItem(SESSION_TEMP_ID_KEY);
+  if (!tempId) {
+    tempId = `temp_${crypto.randomUUID()}`;
+    sessionStorage.setItem(SESSION_TEMP_ID_KEY, tempId);
+  }
+  return tempId;
+}
+
+export function clearTempFlowId(): void {
+  if (environment.isClientSide()) {
+    sessionStorage.removeItem(SESSION_TEMP_ID_KEY);
+  }
+}
+
+export function getTempFlowId(): string | null {
+  if (environment.isServerSide()) {
+    return null;
+  }
+  return sessionStorage.getItem(SESSION_TEMP_ID_KEY);
+}
+
+export interface DraftData {
+  nodes: CustomNode[];
+  edges: CustomEdge[];
+  graphSchemas: {
+    input: Record<string, unknown> | null;
+    credentials: Record<string, unknown> | null;
+    output: Record<string, unknown> | null;
+  };
+  nodeCounter: number;
+  flowVersion?: number;
+}
+
+export const draftService = {
+  async saveDraft(flowId: string, data: DraftData): Promise<void> {
+    const draft: BuilderDraft = {
+      id: flowId,
+      nodes: data.nodes,
+      edges: data.edges,
+      graphSchemas: data.graphSchemas,
+      nodeCounter: data.nodeCounter,
+      savedAt: Date.now(),
+      flowVersion: data.flowVersion,
+    };
+
+    await db.drafts.put(draft);
+  },
+
+  async loadDraft(flowId: string): Promise<BuilderDraft | null> {
+    const draft = await db.drafts.get(flowId);
+
+    if (!draft) {
+      return null;
+    }
+    const age = Date.now() - draft.savedAt;
+    if (age > DRAFT_EXPIRY_MS) {
+      await this.deleteDraft(flowId);
+      return null;
+    }
+
+    return draft;
+  },
+
+  async deleteDraft(flowId: string): Promise<void> {
+    await db.drafts.delete(flowId);
+  },
+
+  async hasDraft(flowId: string): Promise<boolean> {
+    const draft = await db.drafts.get(flowId);
+    if (!draft) return false;
+
+    // Check expiry
+    const age = Date.now() - draft.savedAt;
+    if (age > DRAFT_EXPIRY_MS) {
+      await this.deleteDraft(flowId);
+      return false;
+    }
+
+    return true;
+  },
+
+  isDraftDifferent(
+    draft: BuilderDraft,
+    currentNodes: CustomNode[],
+    currentEdges: CustomEdge[],
+  ): boolean {
+    const draftNodesClean = cleanNodes(draft.nodes);
+    const currentNodesClean = cleanNodes(currentNodes);
+    const draftEdgesClean = cleanEdges(draft.edges);
+    const currentEdgesClean = cleanEdges(currentEdges);
+
+    const nodesDifferent = !isEqual(draftNodesClean, currentNodesClean);
+    const edgesDifferent = !isEqual(draftEdgesClean, currentEdgesClean);
+
+    return nodesDifferent || edgesDifferent;
+  },
+
+  cleanupExpired: cleanupExpiredDrafts,
+};
diff --git a/autogpt_platform/frontend/src/services/feature-flags/use-get-flag.ts b/autogpt_platform/frontend/src/services/feature-flags/use-get-flag.ts
index e80adeb7b5..64b69895f3 100644
--- a/autogpt_platform/frontend/src/services/feature-flags/use-get-flag.ts
+++ b/autogpt_platform/frontend/src/services/feature-flags/use-get-flag.ts
@@ -2,7 +2,6 @@
 
 import { DEFAULT_SEARCH_TERMS } from "@/app/(platform)/marketplace/components/HeroSection/helpers";
 import { useFlags } from "launchdarkly-react-client-sdk";
-import { environment } from "../environment";
 
 export enum Flag {
   BETA_BLOCKS = "beta-blocks",
@@ -40,7 +39,7 @@ const mockFlags = {
   [Flag.BETA_BLOCKS]: [],
   [Flag.NEW_BLOCK_MENU]: false,
   [Flag.NEW_AGENT_RUNS]: false,
-  [Flag.GRAPH_SEARCH]: true,
+  [Flag.GRAPH_SEARCH]: false,
   [Flag.ENABLE_ENHANCED_OUTPUT_HANDLING]: false,
   [Flag.NEW_FLOW_EDITOR]: false,
   [Flag.BUILDER_VIEW_SWITCH]: false,
@@ -48,17 +47,20 @@ const mockFlags = {
   [Flag.AGENT_FAVORITING]: false,
   [Flag.MARKETPLACE_SEARCH_TERMS]: DEFAULT_SEARCH_TERMS,
   [Flag.ENABLE_PLATFORM_PAYMENT]: false,
-  [Flag.CHAT]: true,
+  [Flag.CHAT]: false,
 };
 
 export function useGetFlag<T extends Flag>(flag: T): FlagValues[T] | null {
   const currentFlags = useFlags<FlagValues>();
   const flagValue = currentFlags[flag];
-  const isCloud = environment.isCloud();
 
-  if ((isPwMockEnabled && !isCloud) || flagValue === undefined) {
+  const envEnabled = process.env.NEXT_PUBLIC_LAUNCHDARKLY_ENABLED === "true";
+  const clientId = process.env.NEXT_PUBLIC_LAUNCHDARKLY_CLIENT_ID;
+  const isLaunchDarklyConfigured = envEnabled && Boolean(clientId);
+
+  if (!isLaunchDarklyConfigured || isPwMockEnabled) {
     return mockFlags[flag];
   }
 
-  return flagValue;
+  return flagValue ?? mockFlags[flag];
 }
diff --git a/autogpt_platform/frontend/src/tests/agent-activity.spec.ts b/autogpt_platform/frontend/src/tests/agent-activity.spec.ts
index 02956fe4e9..96c19a8020 100644
--- a/autogpt_platform/frontend/src/tests/agent-activity.spec.ts
+++ b/autogpt_platform/frontend/src/tests/agent-activity.spec.ts
@@ -1,17 +1,17 @@
 import test, { expect } from "@playwright/test";
-import { hasTextContent, hasUrl, isVisible } from "./utils/assertion";
-import { getSelectors } from "./utils/selectors";
-import { getTestUser } from "./utils/auth";
-import { LoginPage } from "./pages/login.page";
 import { BuildPage } from "./pages/build.page";
 import * as LibraryPage from "./pages/library.page";
+import { LoginPage } from "./pages/login.page";
+import { hasTextContent, hasUrl, isVisible } from "./utils/assertion";
+import { getTestUser } from "./utils/auth";
+import { getSelectors } from "./utils/selectors";
 
 test.beforeEach(async ({ page }) => {
   const loginPage = new LoginPage(page);
   const buildPage = new BuildPage(page);
   const testUser = await getTestUser();
 
-  const { getId, getText } = getSelectors(page);
+  const { getId } = getSelectors(page);
 
   await page.goto("/login");
   await loginPage.login(testUser.email, testUser.password);
@@ -39,9 +39,9 @@ test.beforeEach(async ({ page }) => {
   await page.waitForTimeout(1000);
 
   await page.goto("/library");
-  await LibraryPage.clickFirstAgent(page);
+  // Navigate to the specific agent we just created, not just the first one
+  await LibraryPage.navigateToAgentByName(page, "Test Agent");
   await LibraryPage.waitForAgentPageLoad(page);
-  await isVisible(getText("Test Agent"), 8000);
 });
 
 test("shows badge with count when agent is running", async ({ page }) => {
diff --git a/autogpt_platform/frontend/src/tests/agent-dashboard.spec.ts b/autogpt_platform/frontend/src/tests/agent-dashboard.spec.ts
index 87dfff10ca..fe93e7c258 100644
--- a/autogpt_platform/frontend/src/tests/agent-dashboard.spec.ts
+++ b/autogpt_platform/frontend/src/tests/agent-dashboard.spec.ts
@@ -1,13 +1,14 @@
-import { LoginPage } from "./pages/login.page";
 import test, { expect } from "@playwright/test";
-import { TEST_CREDENTIALS } from "./credentials";
-import { getSelectors } from "./utils/selectors";
+import { getTestUserWithLibraryAgents } from "./credentials";
+import { LoginPage } from "./pages/login.page";
 import { hasUrl, isHidden } from "./utils/assertion";
+import { getSelectors } from "./utils/selectors";
 
 test.beforeEach(async ({ page }) => {
   const loginPage = new LoginPage(page);
   await page.goto("/login");
-  await loginPage.login(TEST_CREDENTIALS.email, TEST_CREDENTIALS.password);
+  const richUser = getTestUserWithLibraryAgents();
+  await loginPage.login(richUser.email, richUser.password);
   await hasUrl(page, "/marketplace");
 });
 
@@ -83,7 +84,7 @@ test("agent table delete action works correctly", async ({ page }) => {
 
   const rows = agentTable.getByTestId("agent-table-row");
 
-  // Delete button testing — delete the first agent in the list
+  // Delete button testing — only works for PENDING submissions
   const beforeCount = await rows.count();
 
   if (beforeCount === 0) {
@@ -91,11 +92,18 @@ test("agent table delete action works correctly", async ({ page }) => {
     return;
   }
 
-  const firstRow = rows.first();
-  const deletedSubmissionId = await firstRow.getAttribute("data-submission-id");
-  await firstRow.scrollIntoViewIfNeeded();
+  // Find a PENDING submission to delete
+  const pendingRow = rows.filter({ hasText: "Pending" }).first();
+  if (!(await pendingRow.count())) {
+    console.log("No pending agents available; skipping delete flow.");
+    return;
+  }
 
-  const delActionsButton = firstRow.getByTestId("agent-table-row-actions");
+  const deletedSubmissionId =
+    await pendingRow.getAttribute("data-submission-id");
+  await pendingRow.scrollIntoViewIfNeeded();
+
+  const delActionsButton = pendingRow.getByTestId("agent-table-row-actions");
   await delActionsButton.waitFor({ state: "visible", timeout: 10000 });
   await delActionsButton.scrollIntoViewIfNeeded();
   await delActionsButton.click();
@@ -108,7 +116,7 @@ test("agent table delete action works correctly", async ({ page }) => {
   await isHidden(page.locator(`[data-submission-id="${deletedSubmissionId}"]`));
 });
 
-test("edit action is unavailable for rejected agents (view only)", async ({
+test("edit and delete actions are unavailable for non-pending submissions", async ({
   page,
 }) => {
   await page.goto("/profile/dashboard");
@@ -118,27 +126,39 @@ test("edit action is unavailable for rejected agents (view only)", async ({
 
   const rows = agentTable.getByTestId("agent-table-row");
 
+  // Test with rejected submissions (view only)
   const rejectedRow = rows.filter({ hasText: "Rejected" }).first();
-  if (!(await rejectedRow.count())) {
-    console.log("No rejected agents available; skipping rejected edit test.");
-    return;
+  if (await rejectedRow.count()) {
+    await rejectedRow.scrollIntoViewIfNeeded();
+    const actionsButton = rejectedRow.getByTestId("agent-table-row-actions");
+    await actionsButton.waitFor({ state: "visible", timeout: 10000 });
+    await actionsButton.scrollIntoViewIfNeeded();
+    await actionsButton.click();
+
+    await expect(page.getByRole("menuitem", { name: "View" })).toBeVisible();
+    await expect(page.getByRole("menuitem", { name: "Edit" })).toHaveCount(0);
+    await expect(page.getByRole("menuitem", { name: "Delete" })).toHaveCount(0);
+
+    // Close the menu
+    await page.keyboard.press("Escape");
   }
 
-  await rejectedRow.scrollIntoViewIfNeeded();
+  // Test with approved submissions (view only)
+  const approvedRow = rows.filter({ hasText: "Approved" }).first();
+  if (await approvedRow.count()) {
+    await approvedRow.scrollIntoViewIfNeeded();
+    const actionsButton = approvedRow.getByTestId("agent-table-row-actions");
+    await actionsButton.waitFor({ state: "visible", timeout: 10000 });
+    await actionsButton.scrollIntoViewIfNeeded();
+    await actionsButton.click();
 
-  const actionsButton = rejectedRow.getByTestId("agent-table-row-actions");
-  await actionsButton.waitFor({ state: "visible", timeout: 10000 });
-  await actionsButton.scrollIntoViewIfNeeded();
-  await actionsButton.click();
-
-  // Rejected should not show Edit, only View
-  await expect(page.getByRole("menuitem", { name: "View" })).toBeVisible();
-  await expect(page.getByRole("menuitem", { name: "Edit" })).toHaveCount(0);
+    await expect(page.getByRole("menuitem", { name: "View" })).toBeVisible();
+    await expect(page.getByRole("menuitem", { name: "Edit" })).toHaveCount(0);
+    await expect(page.getByRole("menuitem", { name: "Delete" })).toHaveCount(0);
+  }
 });
 
-test("editing an approved agent creates a new pending submission", async ({
-  page,
-}) => {
+test("editing a pending submission works correctly", async ({ page }) => {
   await page.goto("/profile/dashboard");
 
   const agentTable = page.getByTestId("agent-table");
@@ -146,16 +166,17 @@ test("editing an approved agent creates a new pending submission", async ({
 
   const rows = agentTable.getByTestId("agent-table-row");
 
-  const approvedRow = rows.filter({ hasText: "Approved" }).first();
-  if (!(await approvedRow.count())) {
-    console.log("No approved agents available; skipping approved edit test.");
+  // Find a PENDING submission to edit (only PENDING submissions can be edited)
+  const pendingRow = rows.filter({ hasText: "Pending" }).first();
+  if (!(await pendingRow.count())) {
+    console.log("No pending agents available; skipping edit test.");
     return;
   }
 
   const beforeCount = await rows.count();
 
-  await approvedRow.scrollIntoViewIfNeeded();
-  const actionsButton = approvedRow.getByTestId("agent-table-row-actions");
+  await pendingRow.scrollIntoViewIfNeeded();
+  const actionsButton = pendingRow.getByTestId("agent-table-row-actions");
   await actionsButton.waitFor({ state: "visible", timeout: 10000 });
   await actionsButton.scrollIntoViewIfNeeded();
   await actionsButton.click();
@@ -167,11 +188,11 @@ test("editing an approved agent creates a new pending submission", async ({
   const editModal = page.getByTestId("edit-agent-modal");
   await expect(editModal).toBeVisible();
 
-  const newTitle = `E2E Edit Approved ${Date.now()}`;
+  const newTitle = `E2E Edit Pending ${Date.now()}`;
   await page.getByRole("textbox", { name: "Title" }).fill(newTitle);
   await page
     .getByRole("textbox", { name: "Changes Summary" })
-    .fill("E2E change - approved -> new pending submission");
+    .fill("E2E change - updating pending submission");
 
   await page.getByRole("button", { name: "Update submission" }).click();
   await expect(editModal).not.toBeVisible();
diff --git a/autogpt_platform/frontend/src/tests/api-keys.spec.ts b/autogpt_platform/frontend/src/tests/api-keys.spec.ts
index e2a5575aed..813272ce5e 100644
--- a/autogpt_platform/frontend/src/tests/api-keys.spec.ts
+++ b/autogpt_platform/frontend/src/tests/api-keys.spec.ts
@@ -1,6 +1,6 @@
 import { expect, test } from "@playwright/test";
+import { getTestUserWithLibraryAgents } from "./credentials";
 import { LoginPage } from "./pages/login.page";
-import { TEST_CREDENTIALS } from "./credentials";
 import { hasUrl } from "./utils/assertion";
 import { getSelectors } from "./utils/selectors";
 
@@ -8,7 +8,8 @@ test.describe("API Keys Page", () => {
   test.beforeEach(async ({ page }) => {
     const loginPage = new LoginPage(page);
     await page.goto("/login");
-    await loginPage.login(TEST_CREDENTIALS.email, TEST_CREDENTIALS.password);
+    const richUser = getTestUserWithLibraryAgents();
+    await loginPage.login(richUser.email, richUser.password);
     await hasUrl(page, "/marketplace");
   });
 
diff --git a/autogpt_platform/frontend/src/tests/build.spec.ts b/autogpt_platform/frontend/src/tests/build.spec.ts
index 1d534d3f7a..abdd3ea63b 100644
--- a/autogpt_platform/frontend/src/tests/build.spec.ts
+++ b/autogpt_platform/frontend/src/tests/build.spec.ts
@@ -18,6 +18,7 @@ test.describe("Build", () => { //(1)!
   // Reason Ignore: admonishment is in the wrong place visually with correct prettier rules
   // prettier-ignore
   test.beforeEach(async ({ page }) => { //(3)! ts-ignore
+    test.setTimeout(25000);
     const loginPage = new LoginPage(page);
     const testUser = await getTestUser();
 
diff --git a/autogpt_platform/frontend/src/tests/credentials/index.ts b/autogpt_platform/frontend/src/tests/credentials/index.ts
index ebf7528b63..bc4663a045 100644
--- a/autogpt_platform/frontend/src/tests/credentials/index.ts
+++ b/autogpt_platform/frontend/src/tests/credentials/index.ts
@@ -4,6 +4,10 @@ export const TEST_CREDENTIALS = {
   password: "testpassword123",
 } as const;
 
+export function getTestUserWithLibraryAgents() {
+  return TEST_CREDENTIALS;
+}
+
 // Dummy constant to help developers identify agents that don't need input
 export const DummyInput = "DummyInput";
 
diff --git a/autogpt_platform/frontend/src/tests/library.spec.ts b/autogpt_platform/frontend/src/tests/library.spec.ts
index 20dcf62975..1972e94522 100644
--- a/autogpt_platform/frontend/src/tests/library.spec.ts
+++ b/autogpt_platform/frontend/src/tests/library.spec.ts
@@ -1,10 +1,10 @@
-import { LibraryPage } from "./pages/library.page";
-import path from "path";
 import test, { expect } from "@playwright/test";
-import { TEST_CREDENTIALS } from "./credentials";
+import path from "path";
+import { getTestUserWithLibraryAgents } from "./credentials";
+import { LibraryPage } from "./pages/library.page";
 import { LoginPage } from "./pages/login.page";
-import { getSelectors } from "./utils/selectors";
 import { hasUrl } from "./utils/assertion";
+import { getSelectors } from "./utils/selectors";
 
 test.describe("Library", () => {
   let libraryPage: LibraryPage;
@@ -14,7 +14,8 @@ test.describe("Library", () => {
 
     await page.goto("/login");
     const loginPage = new LoginPage(page);
-    await loginPage.login(TEST_CREDENTIALS.email, TEST_CREDENTIALS.password);
+    const richUser = getTestUserWithLibraryAgents();
+    await loginPage.login(richUser.email, richUser.password);
     await hasUrl(page, "/marketplace");
   });
 
@@ -47,13 +48,18 @@ test.describe("Library", () => {
     );
 
     if (agentWithBuilder) {
-      await libraryPage.clickOpenInBuilder(agentWithBuilder);
-      await page.waitForURL("**/build**");
-      test.expect(page.url()).toContain(`/build`);
+      const [newPage] = await Promise.all([
+        page.context().waitForEvent("page"),
+        libraryPage.clickOpenInBuilder(agentWithBuilder),
+      ]);
+      await newPage.waitForLoadState();
+      test.expect(newPage.url()).toContain(`/build`);
+      await newPage.close();
     }
   });
 
-  test("pagination works correctly", async ({ page }) => {
+  test("pagination works correctly", async ({ page }, testInfo) => {
+    test.setTimeout(testInfo.timeout * 3); // Increase timeout for pagination operations
     await page.goto("/library");
 
     const paginationResult = await libraryPage.testPagination();
@@ -80,6 +86,9 @@ test.describe("Library", () => {
     const allAgents = await libraryPage.getAgents();
     expect(allAgents.length).toBeGreaterThan(0);
 
+    const initialAgentCount = await libraryPage.getAgentCount();
+    expect(initialAgentCount).toBeGreaterThan(0);
+
     const firstAgent = allAgents[0];
     await libraryPage.searchAgents(firstAgent.name);
     await libraryPage.waitForAgentsToLoad();
@@ -117,8 +126,8 @@ test.describe("Library", () => {
     await libraryPage.clearSearch();
     await libraryPage.waitForAgentsToLoad();
 
-    const clearedSearchResults = await libraryPage.getAgents();
-    test.expect(clearedSearchResults.length).toEqual(allAgents.length);
+    const clearedSearchCount = await libraryPage.getAgentCount();
+    test.expect(clearedSearchCount).toEqual(initialAgentCount);
 
     const clearedSearchValue = await libraryPage.getSearchValue();
     test.expect(clearedSearchValue).toBe("");
@@ -200,11 +209,14 @@ test.describe("Library", () => {
     );
     await fileInput.setInputFiles(testAgentPath);
 
-    await page.waitForTimeout(1000);
+    // Wait for file to be processed and upload button to be enabled
+    const uploadButton = page.getByRole("button", { name: "Upload" });
+    await uploadButton.waitFor({ state: "visible", timeout: 10000 });
+    await expect(uploadButton).toBeEnabled({ timeout: 10000 });
 
     expect(await libraryPage.isUploadButtonEnabled()).toBeTruthy();
 
-    await page.getByRole("button", { name: "Upload Agent" }).click();
+    await page.getByRole("button", { name: "Upload" }).click();
 
     await page.waitForURL("**/build**", { timeout: 10000 });
     expect(page.url()).toContain("/build");
@@ -224,28 +236,10 @@ test.describe("Library", () => {
 
     if (uploadedAgent) {
       test.expect(uploadedAgent.name).toContain(testAgentName);
-      test.expect(uploadedAgent.description).toContain(testAgentDescription);
       test.expect(uploadedAgent.seeRunsUrl).toBeTruthy();
       test.expect(uploadedAgent.openInBuilderUrl).toBeTruthy();
-
-      await libraryPage.clickAgent(uploadedAgent);
-      await page.waitForURL(`**/library/agents/${uploadedAgent.id}**`, {
-        timeout: 10000,
-      });
-
-      await page.getByRole("button", { name: "Delete agent" }).click();
-      await page.waitForTimeout(500);
-      await page.getByRole("button", { name: "Delete" }).click();
-
-      await page.waitForTimeout(1000);
-      await libraryPage.navigateToLibrary();
-      await libraryPage.waitForAgentsToLoad();
-
-      await libraryPage.searchAgents(testAgentName);
-      await libraryPage.waitForAgentsToLoad();
-      const deletedSearchResults = await libraryPage.getAgentCount();
-      expect(deletedSearchResults).toBe(0);
     }
+
     await libraryPage.clearSearch();
     await libraryPage.waitForAgentsToLoad();
   });
diff --git a/autogpt_platform/frontend/src/tests/marketplace-agent.spec.ts b/autogpt_platform/frontend/src/tests/marketplace-agent.spec.ts
index 9964d58e60..75efb134d5 100644
--- a/autogpt_platform/frontend/src/tests/marketplace-agent.spec.ts
+++ b/autogpt_platform/frontend/src/tests/marketplace-agent.spec.ts
@@ -1,10 +1,14 @@
-import { test, expect } from "@playwright/test";
-import { MarketplacePage } from "./pages/marketplace.page";
+import { expect, test } from "@playwright/test";
+import { getTestUserWithLibraryAgents } from "./credentials";
 import { LoginPage } from "./pages/login.page";
-import { isVisible, hasUrl, matchesUrl } from "./utils/assertion";
-import { TEST_CREDENTIALS } from "./credentials";
+import { MarketplacePage } from "./pages/marketplace.page";
+import { hasUrl, isVisible, matchesUrl } from "./utils/assertion";
 import { getSelectors } from "./utils/selectors";
 
+function escapeRegExp(value: string) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
 test.describe("Marketplace Agent Page - Basic Functionality", () => {
   test("User can access agent page when logged out", async ({ page }) => {
     const marketplacePage = new MarketplacePage(page);
@@ -24,7 +28,8 @@ test.describe("Marketplace Agent Page - Basic Functionality", () => {
     const marketplacePage = new MarketplacePage(page);
 
     await loginPage.goto();
-    await loginPage.login(TEST_CREDENTIALS.email, TEST_CREDENTIALS.password);
+    const richUser = getTestUserWithLibraryAgents();
+    await loginPage.login(richUser.email, richUser.password);
     await hasUrl(page, "/marketplace");
     await marketplacePage.goto(page);
     await hasUrl(page, "/marketplace");
@@ -85,7 +90,8 @@ test.describe("Marketplace Agent Page - Basic Functionality", () => {
     const marketplacePage = new MarketplacePage(page);
 
     await loginPage.goto();
-    await loginPage.login(TEST_CREDENTIALS.email, TEST_CREDENTIALS.password);
+    const richUser = getTestUserWithLibraryAgents();
+    await loginPage.login(richUser.email, richUser.password);
     await hasUrl(page, "/marketplace");
     await marketplacePage.goto(page);
 
@@ -93,6 +99,12 @@ test.describe("Marketplace Agent Page - Basic Functionality", () => {
     await firstStoreCard.click();
     await page.waitForURL("**/marketplace/agent/**");
 
+    const agentTitle = await getId("agent-title").textContent();
+    if (!agentTitle || !agentTitle.trim()) {
+      throw new Error("Agent title not found on marketplace agent page");
+    }
+    const agentName = agentTitle.trim();
+
     const addToLibraryButton = getId("agent-add-library-button");
     await isVisible(addToLibraryButton);
     await addToLibraryButton.click();
@@ -101,9 +113,8 @@ test.describe("Marketplace Agent Page - Basic Functionality", () => {
     await isVisible(addSuccessMessage);
 
     await page.waitForURL("**/library/agents/**");
-    const agentNameOnLibrary = await getId("agent-title").textContent();
-    expect(
-      agentNameOnLibrary && agentNameOnLibrary.trim().length,
-    ).toBeGreaterThan(0);
+    await expect(page).toHaveTitle(
+      new RegExp(`${escapeRegExp(agentName)} - Library - AutoGPT Platform`),
+    );
   });
 });
diff --git a/autogpt_platform/frontend/src/tests/marketplace-creator.spec.ts b/autogpt_platform/frontend/src/tests/marketplace-creator.spec.ts
index 8b3e2e1e64..3558f0672c 100644
--- a/autogpt_platform/frontend/src/tests/marketplace-creator.spec.ts
+++ b/autogpt_platform/frontend/src/tests/marketplace-creator.spec.ts
@@ -1,8 +1,8 @@
 import { test } from "@playwright/test";
-import { MarketplacePage } from "./pages/marketplace.page";
+import { getTestUserWithLibraryAgents } from "./credentials";
 import { LoginPage } from "./pages/login.page";
-import { isVisible, hasUrl, matchesUrl } from "./utils/assertion";
-import { TEST_CREDENTIALS } from "./credentials";
+import { MarketplacePage } from "./pages/marketplace.page";
+import { hasUrl, isVisible, matchesUrl } from "./utils/assertion";
 import { getSelectors } from "./utils/selectors";
 
 test.describe("Marketplace Creator Page – Basic Functionality", () => {
@@ -25,7 +25,8 @@ test.describe("Marketplace Creator Page – Basic Functionality", () => {
     const marketplacePage = new MarketplacePage(page);
 
     await loginPage.goto();
-    await loginPage.login(TEST_CREDENTIALS.email, TEST_CREDENTIALS.password);
+    const richUser = getTestUserWithLibraryAgents();
+    await loginPage.login(richUser.email, richUser.password);
     await hasUrl(page, "/marketplace");
 
     await marketplacePage.goto(page);
diff --git a/autogpt_platform/frontend/src/tests/marketplace.spec.ts b/autogpt_platform/frontend/src/tests/marketplace.spec.ts
index 8bbc1cef90..6f06f7addb 100644
--- a/autogpt_platform/frontend/src/tests/marketplace.spec.ts
+++ b/autogpt_platform/frontend/src/tests/marketplace.spec.ts
@@ -1,8 +1,8 @@
-import { test, expect } from "@playwright/test";
-import { MarketplacePage } from "./pages/marketplace.page";
+import { expect, test } from "@playwright/test";
+import { getTestUserWithLibraryAgents } from "./credentials";
 import { LoginPage } from "./pages/login.page";
-import { isVisible, hasUrl, hasMinCount, matchesUrl } from "./utils/assertion";
-import { TEST_CREDENTIALS } from "./credentials";
+import { MarketplacePage } from "./pages/marketplace.page";
+import { hasMinCount, hasUrl, isVisible, matchesUrl } from "./utils/assertion";
 
 test.describe("Marketplace – Basic Functionality", () => {
   test("User can access marketplace page when logged out", async ({ page }) => {
@@ -24,7 +24,8 @@ test.describe("Marketplace – Basic Functionality", () => {
     const marketplacePage = new MarketplacePage(page);
 
     await loginPage.goto();
-    await loginPage.login(TEST_CREDENTIALS.email, TEST_CREDENTIALS.password);
+    const richUser = getTestUserWithLibraryAgents();
+    await loginPage.login(richUser.email, richUser.password);
     await hasUrl(page, "/marketplace");
 
     await marketplacePage.goto(page);
diff --git a/autogpt_platform/frontend/src/tests/pages/library.page.ts b/autogpt_platform/frontend/src/tests/pages/library.page.ts
index c75fc51c93..3a7695ec3a 100644
--- a/autogpt_platform/frontend/src/tests/pages/library.page.ts
+++ b/autogpt_platform/frontend/src/tests/pages/library.page.ts
@@ -1,6 +1,6 @@
-import { BasePage } from "./base.page";
 import { Locator, Page } from "@playwright/test";
 import { getSelectors } from "../utils/selectors";
+import { BasePage } from "./base.page";
 
 export interface Agent {
   id: string;
@@ -109,7 +109,7 @@ export class LibraryPage extends BasePage {
 
   async openUploadDialog(): Promise<void> {
     console.log(`opening upload dialog`);
-    await this.page.getByRole("button", { name: "Upload an agent" }).click();
+    await this.page.getByRole("button", { name: "Upload agent" }).click();
 
     // Wait for dialog to appear
     await this.page.getByRole("dialog", { name: "Upload Agent" }).waitFor({
@@ -149,7 +149,7 @@ export class LibraryPage extends BasePage {
 
     // Fill description
     await this.page
-      .getByRole("textbox", { name: "Description" })
+      .getByRole("textbox", { name: "Agent description" })
       .fill(description);
   }
 
@@ -157,7 +157,7 @@ export class LibraryPage extends BasePage {
     console.log(`checking if upload button is enabled`);
     try {
       const uploadButton = this.page.getByRole("button", {
-        name: "Upload Agent",
+        name: "Upload",
       });
       return await uploadButton.isEnabled();
     } catch {
@@ -175,26 +175,32 @@ export class LibraryPage extends BasePage {
     const agentCards = await getId("library-agent-card").all();
 
     for (const card of agentCards) {
-      const name = await card.locator("h3").textContent();
-      const description = await card.locator("p").textContent();
-      const seeRunsLink = card.locator("a", { hasText: "See runs" });
-      const openInBuilderLink = card.locator("a", {
-        hasText: "Open in builder",
-      });
+      const name = await getId("library-agent-card-name", card).textContent();
+      const seeRunsLink = getId("library-agent-card-see-runs-link", card);
+      const openInBuilderLink = getId(
+        "library-agent-card-open-in-builder-link",
+        card,
+      );
 
       const seeRunsUrl = await seeRunsLink.getAttribute("href");
-      const openInBuilderUrl = await openInBuilderLink.getAttribute("href");
 
-      if (name && description && seeRunsUrl && openInBuilderUrl) {
+      // Check if the "Open in builder" link exists before getting its href
+      const openInBuilderLinkCount = await openInBuilderLink.count();
+      const openInBuilderUrl =
+        openInBuilderLinkCount > 0
+          ? await openInBuilderLink.getAttribute("href")
+          : null;
+
+      if (name && seeRunsUrl) {
         const idMatch = seeRunsUrl.match(/\/library\/agents\/([^\/]+)/);
         const id = idMatch ? idMatch[1] : "";
 
         agents.push({
           id,
           name: name.trim(),
-          description: description.trim(),
+          description: "", // Description is not currently rendered in the card
           seeRunsUrl,
-          openInBuilderUrl,
+          openInBuilderUrl: openInBuilderUrl || "",
         });
       }
     }
@@ -204,28 +210,36 @@ export class LibraryPage extends BasePage {
   }
 
   async clickAgent(agent: Agent): Promise<void> {
-    await this.page
-      .getByRole("heading", { name: agent.name, level: 3 })
-      .first()
-      .click();
+    const { getId } = getSelectors(this.page);
+    const nameElement = getId("library-agent-card-name").filter({
+      hasText: agent.name,
+    });
+    await nameElement.first().click();
   }
 
   async clickSeeRuns(agent: Agent): Promise<void> {
     console.log(`clicking see runs for agent: ${agent.name}`);
 
-    // Find the "See runs" link for this specific agent
-    const agentCard = this.page.locator(`[href="${agent.seeRunsUrl}"]`).first();
-    await agentCard.click();
+    const { getId } = getSelectors(this.page);
+    const agentCard = getId("library-agent-card").filter({
+      hasText: agent.name,
+    });
+    const seeRunsLink = getId("library-agent-card-see-runs-link", agentCard);
+    await seeRunsLink.first().click();
   }
 
   async clickOpenInBuilder(agent: Agent): Promise<void> {
     console.log(`clicking open in builder for agent: ${agent.name}`);
 
-    // Find the "Open in builder" link for this specific agent
-    const builderLink = this.page
-      .locator(`[href="${agent.openInBuilderUrl}"]`)
-      .first();
-    await builderLink.click();
+    const { getId } = getSelectors(this.page);
+    const agentCard = getId("library-agent-card").filter({
+      hasText: agent.name,
+    });
+    const builderLink = getId(
+      "library-agent-card-open-in-builder-link",
+      agentCard,
+    );
+    await builderLink.first().click();
   }
 
   async waitForAgentsToLoad(): Promise<void> {
@@ -359,9 +373,9 @@ export class LibraryPage extends BasePage {
     let previousCount = 0;
     let currentCount = 0;
     let stableChecks = 0;
-    const maxChecks = 10;
+    const maxChecks = 5; // Reduced from 10 to prevent excessive waiting
 
-    while (stableChecks < 3 && stableChecks < maxChecks) {
+    while (stableChecks < 2 && stableChecks < maxChecks) {
       currentCount = await this.getAgentCount();
 
       if (currentCount === previousCount) {
@@ -371,7 +385,10 @@ export class LibraryPage extends BasePage {
       }
 
       previousCount = currentCount;
-      await this.page.waitForTimeout(500);
+      if (stableChecks < 2) {
+        // Only wait if we haven't stabilized yet
+        await this.page.waitForTimeout(500);
+      }
     }
 
     console.log(`Pagination load stabilized with ${currentCount} agents`);
@@ -433,21 +450,72 @@ export async function navigateToAgentByName(
   agentName: string,
 ): Promise<void> {
   const agentCard = getAgentCards(page).filter({ hasText: agentName }).first();
+  // Wait for the agent card to be visible before clicking
+  // This handles async loading of agents after page navigation
+  await agentCard.waitFor({ state: "visible", timeout: 15000 });
   await agentCard.click();
 }
 
 export async function clickRunButton(page: Page): Promise<void> {
   const { getId } = getSelectors(page);
+
+  // Wait for page to stabilize and buttons to render
+  // The NewAgentLibraryView shows either "Setup your task" (empty state)
+  // or "New task" (with items) button
+  const setupTaskButton = page.getByRole("button", {
+    name: /Setup your task/i,
+  });
+  const newTaskButton = page.getByRole("button", { name: /New task/i });
   const runButton = getId("agent-run-button");
   const runAgainButton = getId("run-again-button");
 
+  // Use Promise.race with waitFor to wait for any of the buttons to appear
+  // This handles the async rendering in CI environments
+  try {
+    await Promise.race([
+      setupTaskButton.waitFor({ state: "visible", timeout: 15000 }),
+      newTaskButton.waitFor({ state: "visible", timeout: 15000 }),
+      runButton.waitFor({ state: "visible", timeout: 15000 }),
+      runAgainButton.waitFor({ state: "visible", timeout: 15000 }),
+    ]);
+  } catch {
+    throw new Error(
+      "Could not find run/start task button - none of the expected buttons appeared",
+    );
+  }
+
+  // Now check which button is visible and click it
+  if (await setupTaskButton.isVisible()) {
+    await setupTaskButton.click();
+    const startTaskButton = page
+      .getByRole("button", { name: /Start Task/i })
+      .first();
+    await startTaskButton.waitFor({ state: "visible", timeout: 10000 });
+    await startTaskButton.click();
+    return;
+  }
+
+  if (await newTaskButton.isVisible()) {
+    await newTaskButton.click();
+    const startTaskButton = page
+      .getByRole("button", { name: /Start Task/i })
+      .first();
+    await startTaskButton.waitFor({ state: "visible", timeout: 10000 });
+    await startTaskButton.click();
+    return;
+  }
+
   if (await runButton.isVisible()) {
     await runButton.click();
-  } else if (await runAgainButton.isVisible()) {
-    await runAgainButton.click();
-  } else {
-    throw new Error("Neither run button nor run again button is visible");
+    return;
   }
+
+  if (await runAgainButton.isVisible()) {
+    await runAgainButton.click();
+    return;
+  }
+
+  throw new Error("Could not find run/start task button");
 }
 
 export async function clickNewRunButton(page: Page): Promise<void> {
diff --git a/autogpt_platform/frontend/src/tests/profile-form.spec.ts b/autogpt_platform/frontend/src/tests/profile-form.spec.ts
index 1fc1008e9c..e9b018858f 100644
--- a/autogpt_platform/frontend/src/tests/profile-form.spec.ts
+++ b/autogpt_platform/frontend/src/tests/profile-form.spec.ts
@@ -1,8 +1,8 @@
 import test, { expect } from "@playwright/test";
-import { ProfileFormPage } from "./pages/profile-form.page";
+import { getTestUserWithLibraryAgents } from "./credentials";
 import { LoginPage } from "./pages/login.page";
+import { ProfileFormPage } from "./pages/profile-form.page";
 import { hasUrl } from "./utils/assertion";
-import { TEST_CREDENTIALS } from "./credentials";
 
 test.describe("Profile Form", () => {
   let profileFormPage: ProfileFormPage;
@@ -12,7 +12,8 @@ test.describe("Profile Form", () => {
 
     const loginPage = new LoginPage(page);
     await loginPage.goto();
-    await loginPage.login(TEST_CREDENTIALS.email, TEST_CREDENTIALS.password);
+    const richUser = getTestUserWithLibraryAgents();
+    await loginPage.login(richUser.email, richUser.password);
     await hasUrl(page, "/marketplace");
   });
 
diff --git a/autogpt_platform/frontend/src/tests/publish-agent.spec.ts b/autogpt_platform/frontend/src/tests/publish-agent.spec.ts
index 42cdee5536..6e1811e25d 100644
--- a/autogpt_platform/frontend/src/tests/publish-agent.spec.ts
+++ b/autogpt_platform/frontend/src/tests/publish-agent.spec.ts
@@ -1,7 +1,6 @@
 import test from "@playwright/test";
+import { getTestUserWithLibraryAgents } from "./credentials";
 import { LoginPage } from "./pages/login.page";
-import { TEST_CREDENTIALS } from "./credentials";
-import { getSelectors } from "./utils/selectors";
 import {
   hasUrl,
   isDisabled,
@@ -9,6 +8,7 @@ import {
   isHidden,
   isVisible,
 } from "./utils/assertion";
+import { getSelectors } from "./utils/selectors";
 
 test("user can publish an agent through the complete flow", async ({
   page,
@@ -17,7 +17,8 @@ test("user can publish an agent through the complete flow", async ({
 
   const loginPage = new LoginPage(page);
   await page.goto("/login");
-  await loginPage.login(TEST_CREDENTIALS.email, TEST_CREDENTIALS.password);
+  const richUser = getTestUserWithLibraryAgents();
+  await loginPage.login(richUser.email, richUser.password);
   await hasUrl(page, "/marketplace");
 
   await page.goto("/marketplace");
@@ -95,7 +96,8 @@ test("should validate all form fields in publish agent form", async ({
 
   const loginPage = new LoginPage(page);
   await page.goto("/login");
-  await loginPage.login(TEST_CREDENTIALS.email, TEST_CREDENTIALS.password);
+  const richUser = getTestUserWithLibraryAgents();
+  await loginPage.login(richUser.email, richUser.password);
   await hasUrl(page, "/marketplace");
 
   await page.goto("/marketplace");
diff --git a/autogpt_platform/frontend/tailwind.config.ts b/autogpt_platform/frontend/tailwind.config.ts
index ab3ea9bc74..f5a72e7916 100644
--- a/autogpt_platform/frontend/tailwind.config.ts
+++ b/autogpt_platform/frontend/tailwind.config.ts
@@ -22,13 +22,7 @@ const config = {
         poppins: ["var(--font-poppins)"],
       },
       colors: {
-        // *** APPROVED DESIGN SYSTEM COLORS ***
-        // These are the ONLY colors that should be used in our app
         ...colors,
-
-        // Legacy colors - DO NOT USE THESE IN NEW CODE
-        // These are kept only to prevent breaking existing styles
-        // Use the approved design system colors above instead
         border: "hsl(var(--border))",
         input: "hsl(var(--input))",
         ring: "hsl(var(--ring))",
@@ -63,70 +57,66 @@ const config = {
           foreground: "hsl(var(--card-foreground))",
         },
         customGray: {
-          100: "#d9d9d9",
-          200: "#a8a8a8",
-          300: "#878787",
-          400: "#646464",
-          500: "#474747",
-          600: "#282828",
-          700: "#272727",
+          "100": "#d9d9d9",
+          "200": "#a8a8a8",
+          "300": "#878787",
+          "400": "#646464",
+          "500": "#474747",
+          "600": "#282828",
+          "700": "#272727",
         },
       },
       spacing: {
-        // Tailwind spacing + custom sizes
-        0: "0rem", // 0px
-        0.5: "0.125rem", // 2px
-        1: "0.25rem", // 4px
-        1.5: "0.375rem", // 6px
-        2: "0.5rem", // 8px
-        2.5: "0.625rem", // 10px
-        3: "0.75rem", // 12px
-        3.5: "0.875rem", // 14px
-        4: "1rem", // 16px
-        5: "1.25rem", // 20px
-        6: "1.5rem", // 24px
-        7: "1.75rem", // 28px
-        7.5: "1.875rem", // 30px
-        8: "2rem", // 32px
-        8.5: "2.125rem", // 34px
-        9: "2.25rem", // 36px
-        10: "2.5rem", // 40px
-        11: "2.75rem", // 44px
-        12: "3rem", // 48px
-        14: "3.5rem", // 56px
-        16: "4rem", // 64px
-        18: "4.5rem", // 72px
-        20: "5rem", // 80px
-        24: "6rem", // 96px
-        28: "7rem", // 112px
-        32: "8rem", // 128px
-        36: "9rem", // 144px
-        40: "10rem", // 160px
-        44: "11rem", // 176px
-        48: "12rem", // 192px
-        52: "13rem", // 208px
-        56: "14rem", // 224px
-        60: "15rem", // 240px
-        64: "16rem", // 256px
-        68: "17rem", // 272px
-        70: "17.5rem", // 280px
-        71: "17.75rem", // 284px
-        72: "18rem", // 288px
-        76: "19rem", // 304px
-        80: "20rem", // 320px
-        96: "24rem", // 384px
+        "0": "0rem",
+        "1": "0.25rem",
+        "2": "0.5rem",
+        "3": "0.75rem",
+        "4": "1rem",
+        "5": "1.25rem",
+        "6": "1.5rem",
+        "7": "1.75rem",
+        "8": "2rem",
+        "9": "2.25rem",
+        "10": "2.5rem",
+        "11": "2.75rem",
+        "12": "3rem",
+        "14": "3.5rem",
+        "16": "4rem",
+        "18": "4.5rem",
+        "20": "5rem",
+        "24": "6rem",
+        "28": "7rem",
+        "32": "8rem",
+        "36": "9rem",
+        "40": "10rem",
+        "44": "11rem",
+        "48": "12rem",
+        "52": "13rem",
+        "56": "14rem",
+        "60": "15rem",
+        "64": "16rem",
+        "68": "17rem",
+        "70": "17.5rem",
+        "71": "17.75rem",
+        "72": "18rem",
+        "76": "19rem",
+        "80": "20rem",
+        "96": "24rem",
+        "0.5": "0.125rem",
+        "1.5": "0.375rem",
+        "2.5": "0.625rem",
+        "3.5": "0.875rem",
+        "7.5": "1.875rem",
+        "8.5": "2.125rem",
       },
       borderRadius: {
-        // Design system border radius tokens from Figma
-        xsmall: "0.25rem", // 4px
-        small: "0.5rem", // 8px
-        medium: "0.75rem", // 12px
-        large: "1rem", // 16px
-        xlarge: "1.25rem", // 20px
-        "2xlarge": "1.5rem", // 24px
-        full: "9999px", // For pill buttons
-
-        // Legacy values - kept for backward compatibility
+        xsmall: "0.25rem",
+        small: "0.5rem",
+        medium: "0.75rem",
+        large: "1rem",
+        xlarge: "1.25rem",
+        "2xlarge": "1.5rem",
+        full: "9999px",
         lg: "var(--radius)",
         md: "calc(var(--radius) - 2px)",
         sm: "calc(var(--radius) - 4px)",
@@ -136,16 +126,28 @@ const config = {
       },
       keyframes: {
         "accordion-down": {
-          from: { height: "0" },
-          to: { height: "var(--radix-accordion-content-height)" },
+          from: {
+            height: "0",
+          },
+          to: {
+            height: "var(--radix-accordion-content-height)",
+          },
         },
         "accordion-up": {
-          from: { height: "var(--radix-accordion-content-height)" },
-          to: { height: "0" },
+          from: {
+            height: "var(--radix-accordion-content-height)",
+          },
+          to: {
+            height: "0",
+          },
         },
         "fade-in": {
-          "0%": { opacity: "0" }, // Start with opacity 0
-          "100%": { opacity: "1" }, // End with opacity 1
+          "0%": {
+            opacity: "0",
+          },
+          "100%": {
+            opacity: "1",
+          },
         },
       },
       animation: {
diff --git a/backend/blocks/video/__init__.py b/backend/blocks/video/__init__.py
new file mode 100644
index 0000000000..fd95ef9a58
--- /dev/null
+++ b/backend/blocks/video/__init__.py
@@ -0,0 +1 @@
+# Video editing blocks
diff --git a/docs/_javascript/mathjax.js b/docs/_javascript/mathjax.js
deleted file mode 100644
index a80ddbff75..0000000000
--- a/docs/_javascript/mathjax.js
+++ /dev/null
@@ -1,16 +0,0 @@
-window.MathJax = {
-    tex: {
-        inlineMath: [["\\(", "\\)"]],
-        displayMath: [["\\[", "\\]"]],
-        processEscapes: true,
-        processEnvironments: true
-    },
-    options: {
-        ignoreHtmlClass: ".*|",
-        processHtmlClass: "arithmatex"
-    }
-};
-
-document$.subscribe(() => {
-    MathJax.typesetPromise()
-})
\ No newline at end of file
diff --git a/docs/_javascript/tablesort.js b/docs/_javascript/tablesort.js
deleted file mode 100644
index ee04e90082..0000000000
--- a/docs/_javascript/tablesort.js
+++ /dev/null
@@ -1,6 +0,0 @@
-document$.subscribe(function () {
-    var tables = document.querySelectorAll("article table:not([class])")
-    tables.forEach(function (table) {
-        new Tablesort(table)
-    })
-})
\ No newline at end of file
diff --git a/docs/content/contribute/index.md b/docs/content/contribute/index.md
index 4cce72aacf..3b458a04df 100644
--- a/docs/content/contribute/index.md
+++ b/docs/content/contribute/index.md
@@ -1,48 +1,35 @@
 # Contributing to the Docs
 
-We welcome contributions to our documentation! If you would like to contribute, please follow the steps below.
+We welcome contributions to our documentation! Our docs are hosted on GitBook and synced with GitHub.
 
-## Setting up the Docs
+## How It Works
 
-1. Clone the repository:
+- Documentation lives in the `docs/` directory on the `gitbook` branch
+- GitBook automatically syncs changes from GitHub
+- You can edit docs directly on GitHub or locally
+
+## Editing Docs Locally
+
+1. Clone the repository and switch to the gitbook branch:
 
     ```shell
-    git clone github.com/Significant-Gravitas/AutoGPT.git
+    git clone https://github.com/Significant-Gravitas/AutoGPT.git
+    cd AutoGPT
+    git checkout gitbook
     ```
 
-1. Install the dependencies:
+2. Make your changes to markdown files in `docs/`
 
-    ```shell
-    python -m pip install -r docs/requirements.txt
-    ```
+3. Preview changes:
+   - Push to a branch and create a PR - GitBook will generate a preview
+   - Or use any markdown preview tool locally
 
-    or
+## Adding a New Page
 
-    ```shell
-    python3 -m pip install -r docs/requirements.txt
-    ```
-
-1. Start iterating using mkdocs' live server:
-
-    ```shell
-    mkdocs serve
-    ```
-
-1. Open your browser and navigate to `http://127.0.0.1:8000`.
-
-1. The server will automatically reload the docs when you save your changes.
-
-## Adding a new page
-
-1. Create a new markdown file in the `docs/content` directory.
-1. Add the new page to the `nav` section in the `mkdocs.yml` file.
-1. Add the content to the new markdown file.
-1. Run `mkdocs serve` to see your changes.
-
-## Checking links
-
-To check for broken links in the documentation, run `mkdocs build` and look for warnings in the console output.
+1. Create a new markdown file in the appropriate `docs/` subdirectory
+2. Add the new page to the relevant `SUMMARY.md` file to include it in the navigation
+3. Submit a pull request to the `gitbook` branch
 
 ## Submitting a Pull Request
 
-When you're ready to submit your changes, please create a pull request. We will review your changes and merge them if they are appropriate.
+When you're ready to submit your changes, create a pull request targeting the `gitbook` branch. We will review your changes and merge them if appropriate.
diff --git a/docs/content/platform/blocks/basic.md b/docs/content/platform/blocks/basic.md
deleted file mode 100644
index a2df3badc1..0000000000
--- a/docs/content/platform/blocks/basic.md
+++ /dev/null
@@ -1,223 +0,0 @@
-# Basic Operations Blocks
-
-## Store Value
-
-### What it is
-A basic block that stores and forwards a value.
-
-### What it does
-This block takes an input value and stores it, allowing it to be reused without changes.
-
-### How it works
-It accepts an input value and optionally a data value. If a data value is provided, it is used as the output. Otherwise, the input value is used as the output.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Input | The value to be stored or forwarded |
-| Data | An optional constant value to be stored instead of the input |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Output | The stored value (either the input or the data) |
-
-### Possible use case
-Storing a user's name at the beginning of a workflow to use it in multiple subsequent blocks without asking for it again.
-
----
-
-## Print to Console
-
-### What it is
-A basic block that prints text to the console for debugging purposes.
-
-### What it does
-This block takes a text input and prints it to the console, then outputs a status message.
-
-### How it works
-It receives a text input, prints it to the console with a "Print: " prefix, and then yields a "printed" status.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Text | The text to be printed to the console |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Status | A message indicating that the text was printed ("printed") |
-
-### Possible use case
-Debugging a workflow by printing intermediate results or messages at various stages.
-
----
-
-## Find in Dictionary
-
-### What it is
-A basic block that looks up a value in a dictionary, object, or list using a given key.
-
-### What it does
-This block searches for a specified key in the input data structure and returns the corresponding value if found.
-
-### How it works
-It accepts an input (dictionary, object, or list) and a key. It then attempts to find the key in the input and return the corresponding value. If the key is not found, it returns the entire input as "missing".
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Input | The dictionary, object, or list to search in |
-| Key | The key to look up in the input |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Output | The value found for the given key |
-| Missing | The entire input if the key was not found |
-
-### Possible use case
-Extracting specific information from a complex data structure, such as finding a user's email address in a user profile dictionary.
-
----
-
-## Agent Input
-
-### What it is
-An input block that provides a way to accept user input in a workflow.
-
-### What it does
-This block allows users to input values into the workflow, with options for naming, describing, and setting placeholder values.
-
-### How it works
-It accepts a value from the user, along with metadata such as name, description, and optional placeholder values. The block then outputs the provided value.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Value | The actual input value provided by the user |
-| Name | A name for the input field |
-| Description | An optional description of the input |
-| Placeholder Values | Optional list of suggested values |
-| Limit to Placeholder Values | Option to restrict input to placeholder values only |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Result | The value provided as input |
-
-### Possible use case
-Collecting user preferences at the start of a personalized recommendation workflow.
-
----
-
-## Agent Output
-
-### What it is
-An output block that records and formats the final results of a workflow.
-
-### What it does
-This block takes a value and associated metadata, optionally formats it, and presents it as the output of the workflow.
-
-### How it works
-It accepts an input value along with a name, description, and optional format string. If a format string is provided, it attempts to apply the formatting to the input value before outputting it.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Value | The value to be recorded as output |
-| Name | A name for the output |
-| Description | An optional description of the output |
-| Format | An optional format string to apply to the value |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Output | The formatted (if applicable) output value |
-
-### Possible use case
-Presenting the final results of a data analysis workflow in a specific format.
-
----
-
-## Add to Dictionary
-
-### What it is
-A basic block that adds a new key-value pair to a dictionary.
-
-### What it does
-This block takes an existing dictionary (or creates a new one), a key, and a value, and adds the key-value pair to the dictionary.
-
-### How it works
-It accepts an optional input dictionary, a key, and a value. If no dictionary is provided, it creates a new one. It then adds the key-value pair to the dictionary and returns the updated dictionary.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Dictionary | An optional existing dictionary to add to |
-| Key | The key for the new entry |
-| Value | The value for the new entry |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Updated Dictionary | The dictionary with the new entry added |
-| Error | An error message if the operation fails |
-
-### Possible use case
-Building a user profile by gradually adding new information as it's collected throughout a workflow.
-
----
-
-## Add to List
-
-### What it is
-A basic block that adds a new entry to a list.
-
-### What it does
-This block takes an existing list (or creates a new one) and adds a new entry to it, optionally at a specified position.
-
-### How it works
-It accepts an optional input list, an entry to add, and an optional position. If no list is provided, it creates a new one. It then adds the entry to the list at the specified position (or at the end if no position is given) and returns the updated list.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| List | An optional existing list to add to |
-| Entry | The new item to add to the list |
-| Position | An optional position to insert the new entry |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Updated List | The list with the new entry added |
-| Error | An error message if the operation fails |
-
-### Possible use case
-Maintaining a to-do list in a task management workflow, where new tasks can be added at specific priorities (positions).
-
----
-
-## Note
-
-### What it is
-A basic block that displays a sticky note with custom text.
-
-### What it does
-This block takes a text input and displays it as a sticky note in the workflow interface.
-
-### How it works
-It simply accepts a text input and passes it through as an output to be displayed as a note.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Text | The text to display in the sticky note |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Output | The text to display in the sticky note |
-
-### Possible use case
-Adding explanatory notes or reminders within a complex workflow to help users understand different stages or provide additional context.
\ No newline at end of file
diff --git a/docs/content/platform/blocks/blocks.md b/docs/content/platform/blocks/blocks.md
deleted file mode 100644
index 146454f143..0000000000
--- a/docs/content/platform/blocks/blocks.md
+++ /dev/null
@@ -1,206 +0,0 @@
-# AutoGPT Blocks Overview
-
-AutoGPT uses a modular approach with various "blocks" to handle different tasks. These blocks are the building blocks of AutoGPT workflows, allowing users to create complex automations by combining simple, specialized components.
-
-!!! info "Creating Your Own Blocks"
-    Want to create your own custom blocks? Check out our guides:
-    
-    - [Build your own Blocks](../new_blocks.md) - Step-by-step tutorial with examples
-    - [Block SDK Guide](../block-sdk-guide.md) - Advanced SDK patterns with OAuth, webhooks, and provider configuration
-
-Below is a comprehensive list of all available blocks, categorized by their primary function. Click on any block name to view its detailed documentation.
-
-## Basic Operations
-| Block Name | Description |
-|------------|-------------|
-| [Store Value](basic.md#store-value) | Stores and forwards a value |
-| [Print to Console](basic.md#print-to-console) | Outputs text to the console for debugging |
-| [Find in Dictionary](basic.md#find-in-dictionary) | Looks up a value in a dictionary or list |
-| [Agent Input](basic.md#agent-input) | Accepts user input in a workflow |
-| [Agent Output](basic.md#agent-output) | Records and formats workflow results |
-| [Add to Dictionary](basic.md#add-to-dictionary) | Adds a new key-value pair to a dictionary |
-| [Add to List](basic.md#add-to-list) | Adds a new entry to a list |
-| [Note](basic.md#note) | Displays a sticky note in the workflow |
-
-## Data Processing
-| Block Name | Description |
-|------------|-------------|
-| [Read CSV](csv.md#read-csv) | Processes and extracts data from CSV files |
-| [Data Sampling](sampling.md#data-sampling) | Selects a subset of data using various sampling methods |
-
-## Text Processing
-| Block Name | Description |
-|------------|-------------|
-| [Match Text Pattern](text.md#match-text-pattern) | Checks if text matches a specified pattern |
-| [Extract Text Information](text.md#extract-text-information) | Extracts specific information from text using patterns |
-| [Fill Text Template](text.md#fill-text-template) | Populates a template with provided values |
-| [Combine Texts](text.md#combine-texts) | Merges multiple text inputs into one |
-| [Text Decoder](decoder_block.md#text-decoder) | Converts encoded text into readable format |
-
-## AI and Language Models
-| Block Name | Description |
-|------------|-------------|
-| [AI Structured Response Generator](llm.md#ai-structured-response-generator) | Generates structured responses using LLMs |
-| [AI Text Generator](llm.md#ai-text-generator) | Produces text responses using LLMs |
-| [AI Text Summarizer](llm.md#ai-text-summarizer) | Summarizes long texts using LLMs |
-| [AI Conversation](llm.md#ai-conversation) | Facilitates multi-turn conversations with LLMs |
-| [AI List Generator](llm.md#ai-list-generator) | Creates lists based on prompts using LLMs |
-
-## Web and API Interactions
-| Block Name | Description |
-|------------|-------------|
-| [Send Web Request](http.md#send-web-request) | Makes HTTP requests to specified web addresses |
-| [Read RSS Feed](rss.md#read-rss-feed) | Retrieves and processes entries from RSS feeds |
-| [Get Weather Information](search.md#get-weather-information) | Fetches current weather data for a location |
-| [Google Maps Search](google_maps.md#google-maps-search) | Searches for local businesses using Google Maps API |
-
-## Social Media and Content
-| Block Name | Description |
-|------------|-------------|
-| [Get Reddit Posts](reddit.md#get-reddit-posts) | Retrieves posts from specified subreddits |
-| [Post Reddit Comment](reddit.md#post-reddit-comment) | Posts comments on Reddit |
-| [Publish to Medium](medium.md#publish-to-medium) | Publishes content directly to Medium |
-| [Read Discord Messages](discord.md#read-discord-messages) | Retrieves messages from Discord channels |
-| [Send Discord Message](discord.md#send-discord-message) | Sends messages to Discord channels |
-
-## Search and Information Retrieval
-| Block Name | Description |
-|------------|-------------|
-| [Get Wikipedia Summary](search.md#get-wikipedia-summary) | Fetches summaries of topics from Wikipedia |
-| [Search The Web](search.md#search-the-web) | Performs web searches and returns results |
-| [Extract Website Content](search.md#extract-website-content) | Retrieves and extracts content from websites |
-
-## Time and Date
-| Block Name | Description |
-|------------|-------------|
-| [Get Current Time](time_blocks.md#get-current-time) | Provides the current time |
-| [Get Current Date](time_blocks.md#get-current-date) | Provides the current date |
-| [Get Current Date and Time](time_blocks.md#get-current-date-and-time) | Provides both current date and time |
-| [Countdown Timer](time_blocks.md#countdown-timer) | Acts as a countdown timer |
-
-## Math and Calculations
-| Block Name | Description |
-|------------|-------------|
-| [Calculator](maths.md#calculator) | Performs basic mathematical operations |
-| [Count Items](maths.md#count-items) | Counts items in a collection |
-
-## Media Generation
-| Block Name | Description |
-|------------|-------------|
-| [Ideogram Model](ideogram.md#ideogram-model) | Generates images based on text prompts |
-| [Create Talking Avatar Video](talking_head.md#create-talking-avatar-video) | Creates videos with talking avatars |
-| [Unreal Text to Speech](text_to_speech_block.md#unreal-text-to-speech) | Converts text to speech using Unreal Speech API |
-| [AI Shortform Video Creator](ai_shortform_video_block.md#ai-shortform-video-creator) | Generates short-form videos using AI |
-| [Replicate Flux Advanced Model](replicate_flux_advanced.md#replicate-flux-advanced-model) | Creates images using Replicate's Flux models |
-| [Flux Kontext](flux_kontext.md#flux-kontext) | Text-based image editing using Flux Kontext |
-
-## Miscellaneous
-| Block Name | Description |
-|------------|-------------|
-| [Transcribe YouTube Video](youtube.md#transcribe-youtube-video) | Transcribes audio from YouTube videos |
-| [Send Email](email_block.md#send-email) | Sends emails using SMTP |
-| [Condition Block](branching.md#condition-block) | Evaluates conditions for workflow branching |
-| [Step Through Items](iteration.md#step-through-items) | Iterates through lists or dictionaries |
-
-## Google Services
-| Block Name | Description |
-|------------|-------------|
-| [Gmail Read](google/gmail.md#gmail-read) | Retrieves and reads emails from a Gmail account |
-| [Gmail Get Thread](google/gmail.md#gmail-get-thread) | Returns every message in a Gmail thread |
-| [Gmail Reply](google/gmail.md#gmail-reply) | Sends a reply that stays in the same thread |
-| [Gmail Send](google/gmail.md#gmail-send) | Sends emails using a Gmail account |
-| [Gmail List Labels](google/gmail.md#gmail-list-labels) | Retrieves all labels from a Gmail account |
-| [Gmail Add Label](google/gmail.md#gmail-add-label) | Adds a label to a specific email in a Gmail account |
-| [Gmail Remove Label](google/gmail.md#gmail-remove-label) | Removes a label from a specific email in a Gmail account |
-| [Google Sheets Read](google/sheet.md#google-sheets-read) | Reads data from a Google Sheets spreadsheet |
-| [Google Sheets Write](google/sheet.md#google-sheets-write) | Writes data to a Google Sheets spreadsheet |
-| [Google Maps Search](google_maps.md#google-maps-search) | Searches for local businesses using the Google Maps API |
-
-## GitHub Integration
-| Block Name | Description |
-|------------|-------------|
-| [GitHub Comment](github/issues.md#github-comment) | Posts comments on GitHub issues or pull requests |
-| [GitHub Make Issue](github/issues.md#github-make-issue) | Creates new issues on GitHub repositories |
-| [GitHub Read Issue](github/issues.md#github-read-issue) | Retrieves information about a specific GitHub issue |
-| [GitHub List Issues](github/issues.md#github-list-issues) | Retrieves a list of issues from a GitHub repository |
-| [GitHub Add Label](github/issues.md#github-add-label) | Adds a label to a GitHub issue or pull request |
-| [GitHub Remove Label](github/issues.md#github-remove-label) | Removes a label from a GitHub issue or pull request |
-| [GitHub Assign Issue](github/issues.md#github-assign-issue) | Assigns a user to a GitHub issue |
-| [GitHub List Tags](github/repo.md#github-list-tags) | Retrieves and lists all tags for a specified GitHub repository |
-| [GitHub List Branches](github/repo.md#github-list-branches) | Retrieves and lists all branches for a specified GitHub repository |
-| [GitHub List Discussions](github/repo.md#github-list-discussions) | Retrieves and lists recent discussions for a specified GitHub repository |
-| [GitHub Make Branch](github/repo.md#github-make-branch) | Creates a new branch in a GitHub repository |
-| [GitHub Delete Branch](github/repo.md#github-delete-branch) | Deletes a specified branch from a GitHub repository |
-| [GitHub List Pull Requests](github/pull_requests.md#github-list-pull-requests) | Retrieves a list of pull requests from a specified GitHub repository |
-| [GitHub Make Pull Request](github/pull_requests.md#github-make-pull-request) | Creates a new pull request in a specified GitHub repository |
-| [GitHub Read Pull Request](github/pull_requests.md#github-read-pull-request) | Retrieves detailed information about a specific GitHub pull request |
-| [GitHub Assign PR Reviewer](github/pull_requests.md#github-assign-pr-reviewer) | Assigns a reviewer to a specific GitHub pull request |
-| [GitHub Unassign PR Reviewer](github/pull_requests.md#github-unassign-pr-reviewer) | Removes an assigned reviewer from a specific GitHub pull request |
-| [GitHub List PR Reviewers](github/pull_requests.md#github-list-pr-reviewers) | Retrieves a list of all assigned reviewers for a specific GitHub pull request |
-
-## Twitter Integration
-| Block Name | Description |
-|------------|-------------|
-| [Twitter Post Tweet](twitter/twitter.md#twitter-post-tweet-block) | Creates a tweet on Twitter with text content and optional attachments including media, polls, quotes, or deep links |
-| [Twitter Delete Tweet](twitter/twitter.md#twitter-delete-tweet-block) | Deletes a specified tweet using its tweet ID |
-| [Twitter Search Recent Tweets](twitter/twitter.md#twitter-search-recent-tweets-block) | Searches for tweets matching specified criteria with options for filtering and pagination |
-| [Twitter Get Quote Tweets](twitter/twitter.md#twitter-get-quote-tweets-block) | Gets tweets that quote a specified tweet ID with options for pagination and filtering |
-| [Twitter Retweet](twitter/twitter.md#twitter-retweet-block) | Creates a retweet of a specified tweet using its tweet ID |
-| [Twitter Remove Retweet](twitter/twitter.md#twitter-remove-retweet-block) | Removes an existing retweet of a specified tweet |
-| [Twitter Get Retweeters](twitter/twitter.md#twitter-get-retweeters-block) | Gets list of users who have retweeted a specified tweet with pagination and filtering options |
-| [Twitter Get User Mentions](twitter/twitter.md#twitter-get-user-mentions-block) | Gets tweets where a specific user is mentioned using their user ID |
-| [Twitter Get Home Timeline](twitter/twitter.md#twitter-get-home-timeline-block) | Gets recent tweets and retweets from authenticated user and followed accounts |
-| [Twitter Get User](twitter/twitter.md#twitter-get-user-block) | Gets detailed profile information for a single Twitter user |
-| [Twitter Get Users](twitter/twitter.md#twitter-get-users-block) | Gets profile information for multiple Twitter users (up to 100) |
-| [Twitter Search Spaces](twitter/twitter.md#twitter-search-spaces-block) | Searches for Twitter Spaces matching title keywords with state filtering |
-| [Twitter Get Spaces](twitter/twitter.md#twitter-get-spaces-block) | Gets information about multiple Twitter Spaces by Space IDs or creator IDs |
-| [Twitter Get Space By Id](twitter/twitter.md#twitter-get-space-by-id-block) | Gets detailed information about a single Twitter Space |
-| [Twitter Get Space Tweets](twitter/twitter.md#twitter-get-space-tweets-block) | Gets tweets that were shared during a Twitter Space session |
-| [Twitter Follow List](twitter/twitter.md#twitter-follow-list-block) | Follows a Twitter List using its List ID |
-| [Twitter Unfollow List](twitter/twitter.md#twitter-unfollow-list-block) | Unfollows a previously followed Twitter List |
-| [Twitter Get List](twitter/twitter.md#twitter-get-list-block) | Gets detailed information about a specific Twitter List |
-| [Twitter Get Owned Lists](twitter/twitter.md#twitter-get-owned-lists-block) | Gets all Twitter Lists owned by a specified user |
-| [Twitter Get List Members](twitter/twitter.md#twitter-get-list-members-block) | Gets information about members of a specified Twitter List |
-| [Twitter Add List Member](twitter/twitter.md#twitter-add-list-member-block) | Adds a specified user as a member to a Twitter List |
-| [Twitter Remove List Member](twitter/twitter.md#twitter-remove-list-member-block) | Removes a specified user from a Twitter List |
-| [Twitter Get List Tweets](twitter/twitter.md#twitter-get-list-tweets-block) | Gets tweets posted within a specified Twitter List |
-| [Twitter Create List](twitter/twitter.md#twitter-create-list-block) | Creates a new Twitter List with specified name and settings |
-| [Twitter Update List](twitter/twitter.md#twitter-update-list-block) | Updates name and/or description of an existing Twitter List |
-| [Twitter Delete List](twitter/twitter.md#twitter-delete-list-block) | Deletes a specified Twitter List |
-| [Twitter Pin List](twitter/twitter.md#twitter-pin-list-block) | Pins a Twitter List to appear at top of Lists |
-| [Twitter Unpin List](twitter/twitter.md#twitter-unpin-list-block) | Removes a Twitter List from pinned Lists |
-| [Twitter Get Pinned Lists](twitter/twitter.md#twitter-get-pinned-lists-block) | Gets all Twitter Lists that are currently pinned |
-| Twitter List Get Followers | Working... Gets all followers of a specified Twitter List |
-| Twitter Get Followed Lists | Working... Gets all Lists that a user follows |
-| Twitter Get DM Events | Working... Retrieves direct message events for a user |
-| Twitter Send Direct Message | Working... Sends a direct message to a specified user |
-| Twitter Create DM Conversation | Working... Creates a new direct message conversation |
-
-## Todoist Integration
-| Block Name | Description |
-|------------|-------------|
-| [Todoist Create Label](todoist.md#todoist-create-label) | Creates a new label in Todoist |
-| [Todoist List Labels](todoist.md#todoist-list-labels) | Retrieves all personal labels from Todoist |
-| [Todoist Get Label](todoist.md#todoist-get-label) | Retrieves a specific label by ID |
-| [Todoist Create Task](todoist.md#todoist-create-task) | Creates a new task in Todoist |
-| [Todoist Get Tasks](todoist.md#todoist-get-tasks) | Retrieves active tasks from Todoist |
-| [Todoist Update Task](todoist.md#todoist-update-task) | Updates an existing task |
-| [Todoist Close Task](todoist.md#todoist-close-task) | Completes/closes a task |
-| [Todoist Reopen Task](todoist.md#todoist-reopen-task) | Reopens a completed task |
-| [Todoist Delete Task](todoist.md#todoist-delete-task) | Permanently deletes a task |
-| [Todoist List Projects](todoist.md#todoist-list-projects) | Retrieves all projects from Todoist |
-| [Todoist Create Project](todoist.md#todoist-create-project) | Creates a new project in Todoist |
-| [Todoist Get Project](todoist.md#todoist-get-project) | Retrieves details for a specific project |
-| [Todoist Update Project](todoist.md#todoist-update-project) | Updates an existing project |
-| [Todoist Delete Project](todoist.md#todoist-delete-project) | Deletes a project and its contents |
-| [Todoist List Collaborators](todoist.md#todoist-list-collaborators) | Retrieves collaborators on a project |
-| [Todoist List Sections](todoist.md#todoist-list-sections) | Retrieves sections from Todoist |
-| [Todoist Get Section](todoist.md#todoist-get-section) | Retrieves details for a specific section |
-| [Todoist Delete Section](todoist.md#todoist-delete-section) | Deletes a section and its tasks |
-| [Todoist Create Comment](todoist.md#todoist-create-comment) | Creates a new comment on a task or project |
-| [Todoist Get Comments](todoist.md#todoist-get-comments) | Retrieves all comments for a task or project |
-| [Todoist Get Comment](todoist.md#todoist-get-comment) | Retrieves a specific comment by ID |
-| [Todoist Update Comment](todoist.md#todoist-update-comment) | Updates an existing comment |
-| [Todoist Delete Comment](todoist.md#todoist-delete-comment) | Deletes a comment |
-
-This comprehensive list covers all the blocks available in AutoGPT. Each block is designed to perform a specific task, and they can be combined to create powerful, automated workflows. For more detailed information on each block, click on its name to view the full documentation.
diff --git a/docs/content/platform/blocks/github/issues.md b/docs/content/platform/blocks/github/issues.md
deleted file mode 100644
index 2727e10acb..0000000000
--- a/docs/content/platform/blocks/github/issues.md
+++ /dev/null
@@ -1,236 +0,0 @@
-# GitHub Issues
-
-## Github Comment
-
-### What it is
-A block that posts comments on GitHub issues or pull requests.
-
-### What it does
-This block allows users to add comments to existing GitHub issues or pull requests using the GitHub API.
-
-### How it works
-The block takes the GitHub credentials, the URL of the issue or pull request, and the comment text as inputs. It then sends a request to the GitHub API to post the comment on the specified issue or pull request.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication information |
-| Issue URL | The URL of the GitHub issue or pull request where the comment will be posted |
-| Comment | The text content of the comment to be posted |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| ID | The unique identifier of the created comment |
-| URL | The direct link to the posted comment on GitHub |
-| Error | Any error message if the comment posting fails |
-
-### Possible use case
-Automating responses to issues in a GitHub repository, such as thanking contributors for their submissions or providing status updates on reported bugs.
-
----
-
-## Github Make Issue
-
-### What it is
-A block that creates new issues on GitHub repositories.
-
-### What it does
-This block allows users to create new issues in a specified GitHub repository with a title and body content.
-
-### How it works
-The block takes the GitHub credentials, repository URL, issue title, and issue body as inputs. It then sends a request to the GitHub API to create a new issue with the provided information.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication information |
-| Repo URL | The URL of the GitHub repository where the issue will be created |
-| Title | The title of the new issue |
-| Body | The main content or description of the new issue |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Number | The issue number assigned by GitHub |
-| URL | The direct link to the newly created issue on GitHub |
-| Error | Any error message if the issue creation fails |
-
-### Possible use case
-Automatically creating issues for bug reports or feature requests submitted through an external system or form.
-
----
-
-## Github Read Issue
-
-### What it is
-A block that retrieves information about a specific GitHub issue.
-
-### What it does
-This block fetches the details of a given GitHub issue, including its title, body content, and the user who created it.
-
-### How it works
-The block takes the GitHub credentials and the issue URL as inputs. It then sends a request to the GitHub API to fetch the issue's details and returns the relevant information.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication information |
-| Issue URL | The URL of the GitHub issue to be read |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Title | The title of the issue |
-| Body | The main content or description of the issue |
-| User | The username of the person who created the issue |
-| Error | Any error message if reading the issue fails |
-
-### Possible use case
-Gathering information about reported issues for analysis or to display on a dashboard.
-
----
-
-## Github List Issues
-
-### What it is
-A block that retrieves a list of issues from a GitHub repository.
-
-### What it does
-This block fetches all open issues from a specified GitHub repository and provides their titles and URLs.
-
-### How it works
-The block takes the GitHub credentials and repository URL as inputs. It then sends a request to the GitHub API to fetch the list of issues and returns their details.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication information |
-| Repo URL | The URL of the GitHub repository to list issues from |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Issue | A list of issues, each containing: |
-| - Title | The title of the issue |
-| - URL | The direct link to the issue on GitHub |
-| Error | Any error message if listing the issues fails |
-
-### Possible use case
-Creating a summary of open issues for a project status report or displaying them on a project management dashboard.
-
----
-
-## Github Add Label
-
-### What it is
-A block that adds a label to a GitHub issue or pull request.
-
-### What it does
-This block allows users to add a specified label to an existing GitHub issue or pull request.
-
-### How it works
-The block takes the GitHub credentials, the URL of the issue or pull request, and the label to be added as inputs. It then sends a request to the GitHub API to add the label to the specified issue or pull request.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication information |
-| Issue URL | The URL of the GitHub issue or pull request to add the label to |
-| Label | The name of the label to be added |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Status | A message indicating whether the label was successfully added |
-| Error | Any error message if adding the label fails |
-
-### Possible use case
-Automatically categorizing issues based on their content or assigning priority labels to newly created issues.
-
----
-
-## Github Remove Label
-
-### What it is
-A block that removes a label from a GitHub issue or pull request.
-
-### What it does
-This block allows users to remove a specified label from an existing GitHub issue or pull request.
-
-### How it works
-The block takes the GitHub credentials, the URL of the issue or pull request, and the label to be removed as inputs. It then sends a request to the GitHub API to remove the label from the specified issue or pull request.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication information |
-| Issue URL | The URL of the GitHub issue or pull request to remove the label from |
-| Label | The name of the label to be removed |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Status | A message indicating whether the label was successfully removed |
-| Error | Any error message if removing the label fails |
-
-### Possible use case
-Updating the status of issues as they progress through a workflow, such as removing a "In Progress" label when an issue is completed.
-
----
-
-## Github Assign Issue
-
-### What it is
-A block that assigns a user to a GitHub issue.
-
-### What it does
-This block allows users to assign a specific GitHub user to an existing issue.
-
-### How it works
-The block takes the GitHub credentials, the URL of the issue, and the username of the person to be assigned as inputs. It then sends a request to the GitHub API to assign the specified user to the issue.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication information |
-| Issue URL | The URL of the GitHub issue to assign |
-| Assignee | The username of the person to be assigned to the issue |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Status | A message indicating whether the issue was successfully assigned |
-| Error | Any error message if assigning the issue fails |
-
-### Possible use case
-Automatically assigning new issues to team members based on their expertise or workload.
-
----
-
-## Github Unassign Issue
-
-### What it is
-A block that unassigns a user from a GitHub issue.
-
-### What it does
-This block allows users to remove a specific GitHub user's assignment from an existing issue.
-
-### How it works
-The block takes the GitHub credentials, the URL of the issue, and the username of the person to be unassigned as inputs. It then sends a request to the GitHub API to remove the specified user's assignment from the issue.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication information |
-| Issue URL | The URL of the GitHub issue to unassign |
-| Assignee | The username of the person to be unassigned from the issue |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Status | A message indicating whether the issue was successfully unassigned |
-| Error | Any error message if unassigning the issue fails |
-
-### Possible use case
-Automatically unassigning issues that have been inactive for a certain period or when reassigning workload among team members.
\ No newline at end of file
diff --git a/docs/content/platform/blocks/github/pull_requests.md b/docs/content/platform/blocks/github/pull_requests.md
deleted file mode 100644
index ef72e4de5c..0000000000
--- a/docs/content/platform/blocks/github/pull_requests.md
+++ /dev/null
@@ -1,182 +0,0 @@
-# Pull Requests
-
-## GitHub List Pull Requests
-
-### What it is
-A block that retrieves a list of pull requests from a specified GitHub repository.
-
-### What it does
-This block fetches all open pull requests for a given GitHub repository and provides their titles and URLs.
-
-### How it works
-It connects to the GitHub API using the provided credentials and repository URL, then retrieves the list of pull requests and formats the information for easy viewing.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication details to access the repository |
-| Repository URL | The URL of the GitHub repository to fetch pull requests from |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Pull Request | A list of pull requests, each containing: |
-| - Title | The title of the pull request |
-| - URL | The web address of the pull request |
-| Error | An error message if the operation fails |
-
-### Possible use case
-A development team leader wants to quickly review all open pull requests in their project repository to prioritize code reviews.
-
----
-
-## GitHub Make Pull Request
-
-### What it is
-A block that creates a new pull request in a specified GitHub repository.
-
-### What it does
-This block allows users to create a new pull request by providing details such as title, body, and branch information.
-
-### How it works
-It uses the GitHub API to create a new pull request with the given information, including the source and target branches for the changes.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication details to access the repository |
-| Repository URL | The URL of the GitHub repository where the pull request will be created |
-| Title | The title of the new pull request |
-| Body | The description or content of the pull request |
-| Head | The name of the branch containing the changes |
-| Base | The name of the branch you want to merge the changes into |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Number | The unique identifier of the created pull request |
-| URL | The web address of the newly created pull request |
-| Error | An error message if the pull request creation fails |
-
-### Possible use case
-A developer has finished working on a new feature in a separate branch and wants to create a pull request to merge their changes into the main branch for review.
-
----
-
-## GitHub Read Pull Request
-
-### What it is
-A block that retrieves detailed information about a specific GitHub pull request.
-
-### What it does
-This block fetches and provides comprehensive information about a given pull request, including its title, body, author, and optionally, the changes made.
-
-### How it works
-It connects to the GitHub API using the provided credentials and pull request URL, then retrieves and formats the requested information.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication details to access the repository |
-| Pull Request URL | The URL of the specific GitHub pull request to read |
-| Include PR Changes | An option to include the actual changes made in the pull request |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Title | The title of the pull request |
-| Body | The description or content of the pull request |
-| Author | The username of the person who created the pull request |
-| Changes | A list of changes made in the pull request (if requested) |
-| Error | An error message if reading the pull request fails |
-
-### Possible use case
-A code reviewer wants to get a comprehensive overview of a pull request, including its description and changes, before starting the review process.
-
----
-
-## GitHub Assign PR Reviewer
-
-### What it is
-A block that assigns a reviewer to a specific GitHub pull request.
-
-### What it does
-This block allows users to assign a designated reviewer to a given pull request in a GitHub repository.
-
-### How it works
-It uses the GitHub API to add the specified user as a reviewer for the given pull request.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication details to access the repository |
-| Pull Request URL | The URL of the specific GitHub pull request to assign a reviewer to |
-| Reviewer | The username of the GitHub user to be assigned as a reviewer |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Status | A message indicating whether the reviewer was successfully assigned |
-| Error | An error message if the reviewer assignment fails |
-
-### Possible use case
-A project manager wants to assign a specific team member to review a newly created pull request for a critical feature.
-
----
-
-## GitHub Unassign PR Reviewer
-
-### What it is
-A block that removes an assigned reviewer from a specific GitHub pull request.
-
-### What it does
-This block allows users to unassign a previously designated reviewer from a given pull request in a GitHub repository.
-
-### How it works
-It uses the GitHub API to remove the specified user from the list of reviewers for the given pull request.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication details to access the repository |
-| Pull Request URL | The URL of the specific GitHub pull request to unassign a reviewer from |
-| Reviewer | The username of the GitHub user to be unassigned as a reviewer |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Status | A message indicating whether the reviewer was successfully unassigned |
-| Error | An error message if the reviewer unassignment fails |
-
-### Possible use case
-A team lead realizes that an assigned reviewer is unavailable and wants to remove them from a pull request to reassign it to another team member.
-
----
-
-## GitHub List PR Reviewers
-
-### What it is
-A block that retrieves a list of all assigned reviewers for a specific GitHub pull request.
-
-### What it does
-This block fetches and provides information about all the reviewers currently assigned to a given pull request in a GitHub repository.
-
-### How it works
-It connects to the GitHub API using the provided credentials and pull request URL, then retrieves and formats the list of assigned reviewers.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication details to access the repository |
-| Pull Request URL | The URL of the specific GitHub pull request to list reviewers for |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Reviewer | A list of assigned reviewers, each containing: |
-| - Username | The GitHub username of the reviewer |
-| - URL | The profile URL of the reviewer |
-| Error | An error message if listing the reviewers fails |
-
-### Possible use case
-A project coordinator wants to check who is currently assigned to review a specific pull request to ensure all necessary team members are involved in the code review process.
\ No newline at end of file
diff --git a/docs/content/platform/blocks/github/repo.md b/docs/content/platform/blocks/github/repo.md
deleted file mode 100644
index 26e680c97b..0000000000
--- a/docs/content/platform/blocks/github/repo.md
+++ /dev/null
@@ -1,234 +0,0 @@
-# Repository
-
-## GitHub List Tags
-
-### What it is
-A block that retrieves and lists all tags for a specified GitHub repository.
-
-### What it does
-This block fetches all tags associated with a given GitHub repository and provides their names and URLs.
-
-### How it works
-The block connects to the GitHub API using provided credentials, sends a request to retrieve tag information for the specified repository, and then processes the response to extract tag names and URLs.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication credentials required to access the repository |
-| Repository URL | The URL of the GitHub repository to fetch tags from |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Tag | Information about each tag, including its name and URL |
-| Error | Any error message if the tag listing process fails |
-
-### Possible use case
-A developer wants to quickly view all release tags for a project to identify the latest version or track the project's release history.
-
----
-
-## GitHub List Branches
-
-### What it is
-A block that retrieves and lists all branches for a specified GitHub repository.
-
-### What it does
-This block fetches all branches associated with a given GitHub repository and provides their names and URLs.
-
-### How it works
-The block authenticates with the GitHub API, sends a request to get branch information for the specified repository, and then processes the response to extract branch names and URLs.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication credentials required to access the repository |
-| Repository URL | The URL of the GitHub repository to fetch branches from |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Branch | Information about each branch, including its name and URL |
-| Error | Any error message if the branch listing process fails |
-
-### Possible use case
-A project manager wants to review all active branches in a repository to track ongoing development efforts and feature implementations.
-
----
-
-## GitHub List Discussions
-
-### What it is
-A block that retrieves and lists recent discussions for a specified GitHub repository.
-
-### What it does
-This block fetches a specified number of recent discussions from a given GitHub repository and provides their titles and URLs.
-
-### How it works
-The block uses the GitHub GraphQL API to request discussion data for the specified repository, processes the response, and extracts discussion titles and URLs.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication credentials required to access the repository |
-| Repository URL | The URL of the GitHub repository to fetch discussions from |
-| Number of Discussions | The number of recent discussions to retrieve (default is 5) |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Discussion | Information about each discussion, including its title and URL |
-| Error | Any error message if the discussion listing process fails |
-
-### Possible use case
-A community manager wants to monitor recent discussions in a project's repository to identify trending topics or issues that need attention.
-
----
-
-## GitHub List Releases
-
-### What it is
-A block that retrieves and lists all releases for a specified GitHub repository.
-
-### What it does
-This block fetches all releases associated with a given GitHub repository and provides their names and URLs.
-
-### How it works
-The block connects to the GitHub API, sends a request to get release information for the specified repository, and then processes the response to extract release names and URLs.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication credentials required to access the repository |
-| Repository URL | The URL of the GitHub repository to fetch releases from |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Release | Information about each release, including its name and URL |
-| Error | Any error message if the release listing process fails |
-
-### Possible use case
-A user wants to view all official releases of a software project to choose the appropriate version for installation or to track the project's release history.
-
----
-
-## GitHub Read File
-
-### What it is
-A block that reads the content of a specified file from a GitHub repository.
-
-### What it does
-This block retrieves the content of a specified file from a given GitHub repository, providing both the raw and decoded text content along with the file size.
-
-### How it works
-The block authenticates with the GitHub API, sends a request to fetch the specified file's content, and then processes the response to provide the file's raw content, decoded text content, and size.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication credentials required to access the repository |
-| Repository URL | The URL of the GitHub repository containing the file |
-| File Path | The path to the file within the repository |
-| Branch | The branch name to read from (defaults to "master") |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Text Content | The content of the file decoded as UTF-8 text |
-| Raw Content | The raw base64-encoded content of the file |
-| Size | The size of the file in bytes |
-| Error | Any error message if the file reading process fails |
-
-### Possible use case
-A developer wants to quickly view the contents of a configuration file or source code file in a GitHub repository without having to clone the entire repository.
-
----
-
-## GitHub Read Folder
-
-### What it is
-A block that reads the content of a specified folder from a GitHub repository.
-
-### What it does
-This block retrieves the list of files and directories within a specified folder from a given GitHub repository.
-
-### How it works
-The block connects to the GitHub API, sends a request to fetch the contents of the specified folder, and then processes the response to provide information about files and directories within that folder.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication credentials required to access the repository |
-| Repository URL | The URL of the GitHub repository containing the folder |
-| Folder Path | The path to the folder within the repository |
-| Branch | The branch name to read from (defaults to "master") |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| File | Information about each file in the folder, including its name, path, and size |
-| Directory | Information about each directory in the folder, including its name and path |
-| Error | Any error message if the folder reading process fails |
-
-### Possible use case
-A project manager wants to explore the structure of a repository or specific folder to understand the organization of files and directories without cloning the entire repository.
-
----
-
-## GitHub Make Branch
-
-### What it is
-A block that creates a new branch in a GitHub repository.
-
-### What it does
-This block creates a new branch in a specified GitHub repository, based on an existing source branch.
-
-### How it works
-The block authenticates with the GitHub API, retrieves the latest commit SHA of the source branch, and then creates a new branch pointing to that commit.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication credentials required to access the repository |
-| Repository URL | The URL of the GitHub repository where the new branch will be created |
-| New Branch | The name of the new branch to create |
-| Source Branch | The name of the existing branch to use as the starting point for the new branch |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Status | A message indicating the success of the branch creation operation |
-| Error | Any error message if the branch creation process fails |
-
-### Possible use case
-A developer wants to start working on a new feature and needs to create a new branch based on the current state of the main development branch.
-
----
-
-## GitHub Delete Branch
-
-### What it is
-A block that deletes a specified branch from a GitHub repository.
-
-### What it does
-This block removes a specified branch from a given GitHub repository.
-
-### How it works
-The block authenticates with the GitHub API and sends a delete request for the specified branch.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | GitHub authentication credentials required to access the repository |
-| Repository URL | The URL of the GitHub repository containing the branch to be deleted |
-| Branch | The name of the branch to delete |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Status | A message indicating the success of the branch deletion operation |
-| Error | Any error message if the branch deletion process fails |
-
-### Possible use case
-After merging a feature branch into the main development branch, a developer wants to clean up the repository by removing the now-obsolete feature branch.
\ No newline at end of file
diff --git a/docs/content/platform/blocks/google/gmail.md b/docs/content/platform/blocks/google/gmail.md
deleted file mode 100644
index f5c8a9e571..0000000000
--- a/docs/content/platform/blocks/google/gmail.md
+++ /dev/null
@@ -1,203 +0,0 @@
-# Gmail
-
-## Gmail Read
-
-### What it is
-A block that retrieves and reads emails from a Gmail account.
-
-### What it does
-This block searches for and retrieves emails from a specified Gmail account based on given search criteria. It can fetch multiple emails and provide detailed information about each email, including subject, sender, recipient, date, body content, and attachments.
-
-### How it works
-The block connects to the user's Gmail account using their credentials, performs a search based on the provided query, and retrieves the specified number of email messages. It then processes each email to extract relevant information and returns the results.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | The user's Gmail account credentials for authentication |
-| Query | A search query to filter emails (e.g., "is:unread" for unread emails). Ignored if using only the `gmail.metadata` scope. |
-| Max Results | The maximum number of emails to retrieve |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Email | Detailed information about a single email (now includes `threadId`) |
-| Emails | A list of email data for multiple emails |
-| Error | An error message if something goes wrong during the process |
-
-### Possible use case
-Automatically checking for new customer inquiries in a support email inbox and organizing them for quick response.
-
----
-
-## Gmail Send
-
-### What it is
-A block that sends emails using a Gmail account.
-
-### What it does
-This block allows users to compose and send emails through their Gmail account. It handles the creation of the email message and sends it to the specified recipient.
-
-### How it works
-The block authenticates with the user's Gmail account, creates an email message with the provided details (recipient, subject, and body), and then sends the email using Gmail's API.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | The user's Gmail account credentials for authentication |
-| To | The recipient's email address |
-| Subject | The subject line of the email |
-| Body | The main content of the email |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Result | Confirmation of the sent email, including a message ID |
-| Error | An error message if something goes wrong during the process |
-
-### Possible use case
-Automatically sending confirmation emails to customers after they make a purchase on an e-commerce website.
-
----
-
-## Gmail List Labels
-
-### What it is
-A block that retrieves all labels (categories) from a Gmail account.
-
-### What it does
-This block fetches and lists all the labels or categories that are set up in the user's Gmail account. These labels are used to organize and categorize emails.
-
-### How it works
-The block connects to the user's Gmail account and requests a list of all labels. It then processes this information and returns a simplified list of label names and their corresponding IDs.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | The user's Gmail account credentials for authentication |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Result | A list of labels, including their names and IDs |
-| Error | An error message if something goes wrong during the process |
-
-### Possible use case
-Creating a dashboard that shows an overview of how many emails are in each category or label in a business email account.
-
----
-
-## Gmail Add Label
-
-### What it is
-A block that adds a label to a specific email in a Gmail account.
-
-### What it does
-This block allows users to add a label (category) to a particular email message in their Gmail account. If the label doesn't exist, it creates a new one.
-
-### How it works
-The block first checks if the specified label exists in the user's Gmail account. If it doesn't, it creates the label. Then, it adds the label to the specified email message using the message ID.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | The user's Gmail account credentials for authentication |
-| Message ID | The unique identifier of the email message to be labeled |
-| Label Name | The name of the label to add to the email |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Result | Confirmation of the label addition, including the label ID |
-| Error | An error message if something goes wrong during the process |
-
-### Possible use case
-Automatically categorizing incoming customer emails based on their content, adding labels like "Urgent," "Feedback," or "Invoice" for easier processing.
-
----
-
-## Gmail Remove Label
-
-### What it is
-A block that removes a label from a specific email in a Gmail account.
-
-### What it does
-This block allows users to remove a label (category) from a particular email message in their Gmail account.
-
-### How it works
-The block first finds the ID of the specified label in the user's Gmail account. If the label exists, it removes it from the specified email message using the message ID.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | The user's Gmail account credentials for authentication |
-| Message ID | The unique identifier of the email message to remove the label from |
-| Label Name | The name of the label to remove from the email |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Result | Confirmation of the label removal, including the label ID |
-| Error | An error message if something goes wrong during the process |
-
-### Possible use case
-Automatically removing the "Unread" label from emails after they have been processed by a customer service representative.
-
----
-
-## Gmail Get Thread
-
-### What it is
-A block that retrieves an entire Gmail thread.
-
-### What it does
-Given a `threadId`, this block fetches all messages in that thread and decodes the text bodies.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | The user's Gmail account credentials for authentication |
-| threadId | The ID of the thread to fetch |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Thread | Gmail thread with decoded messages |
-| Error | An error message if something goes wrong |
-
-### Possible use case
-Checking if a recipient replied in an existing conversation.
-
----
-
-## Gmail Reply
-
-### What it is
-A block that sends a reply within an existing Gmail thread.
-
-### What it does
-This block builds a properly formatted reply email and sends it so Gmail keeps it in the same conversation.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Credentials | The user's Gmail account credentials for authentication |
-| threadId | The thread to reply in |
-| parentMessageId | The ID of the message you are replying to |
-| To | List of recipients |
-| Cc | List of CC recipients |
-| Bcc | List of BCC recipients |
-| Subject | Optional subject (defaults to `Re:` prefix) |
-| Body | The email body |
-| Attachments | Optional files to include |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| MessageId | The ID of the sent message |
-| ThreadId | The thread the reply belongs to |
-| Message | Full Gmail message object |
-| Error | Error message if something goes wrong |
-
-### Possible use case
-Automatically respond "Thanks, see you then" to a scheduling email while keeping the conversation tidy.
diff --git a/docs/content/platform/blocks/llm.md b/docs/content/platform/blocks/llm.md
deleted file mode 100644
index 4eafa62bee..0000000000
--- a/docs/content/platform/blocks/llm.md
+++ /dev/null
@@ -1,173 +0,0 @@
-# Large Language Model (LLM) Blocks
-
-## AI Structured Response Generator
-
-### What it is
-A block that generates structured responses using a Large Language Model (LLM).
-
-### What it does
-It takes a prompt and other parameters, sends them to an LLM, and returns a structured response in a specified format.
-
-### How it works
-The block sends the input prompt to a chosen LLM, along with any system prompts and expected response format. It then processes the LLM's response, ensuring it matches the expected format, and returns the structured data.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Prompt | The main text prompt to send to the LLM |
-| Expected Format | A dictionary specifying the structure of the desired response |
-| Model | The specific LLM to use (e.g., GPT-4 Turbo, Claude 3) |
-| API Key | The secret key for accessing the LLM service |
-| System Prompt | An optional prompt to guide the LLM's behavior |
-| Retry | Number of attempts to generate a valid response |
-| Prompt Values | Dictionary of values to fill in the prompt template |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Response | The structured response from the LLM |
-| Error | Any error message if the process fails |
-
-### Possible use case
-Extracting specific information from unstructured text, such as generating a product description with predefined fields (name, features, price) from a lengthy product review.
-
----
-
-## AI Text Generator
-
-### What it is
-A block that generates text responses using a Large Language Model (LLM).
-
-### What it does
-It takes a prompt and other parameters, sends them to an LLM, and returns a text response.
-
-### How it works
-The block sends the input prompt to a chosen LLM, processes the response, and returns the generated text.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Prompt | The main text prompt to send to the LLM |
-| Model | The specific LLM to use (e.g., GPT-4 Turbo, Claude 3) |
-| API Key | The secret key for accessing the LLM service |
-| System Prompt | An optional prompt to guide the LLM's behavior |
-| Retry | Number of attempts to generate a valid response |
-| Prompt Values | Dictionary of values to fill in the prompt template |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Response | The text response from the LLM |
-| Error | Any error message if the process fails |
-
-### Possible use case
-Generating creative writing, such as short stories or poetry, based on a given theme or starting sentence.
-
----
-
-## AI Text Summarizer
-
-### What it is
-A block that summarizes long texts using a Large Language Model (LLM).
-
-### What it does
-It takes a long text, breaks it into manageable chunks, summarizes each chunk, and then combines these summaries into a final summary.
-
-### How it works
-The block splits the input text into smaller chunks, sends each chunk to an LLM for summarization, and then combines these summaries. If the combined summary is still too long, it repeats the process until a concise summary is achieved.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Text | The long text to be summarized |
-| Model | The specific LLM to use for summarization |
-| Focus | The main topic or aspect to focus on in the summary |
-| Style | The desired style of the summary (e.g., concise, detailed, bullet points) |
-| API Key | The secret key for accessing the LLM service |
-| Max Tokens | The maximum number of tokens for each chunk |
-| Chunk Overlap | The number of overlapping tokens between chunks |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Summary | The final summarized text |
-| Error | Any error message if the process fails |
-
-### Possible use case
-Summarizing lengthy research papers or articles to quickly grasp the main points and key findings.
-
----
-
-## AI Conversation
-
-### What it is
-A block that facilitates multi-turn conversations using a Large Language Model (LLM).
-
-### What it does
-It takes a list of conversation messages, sends them to an LLM, and returns the model's response to continue the conversation.
-
-### How it works
-The block sends the entire conversation history to the chosen LLM, including system messages, user inputs, and previous responses. It then returns the LLM's response as the next part of the conversation.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Messages | A list of previous messages in the conversation |
-| Model | The specific LLM to use for the conversation |
-| API Key | The secret key for accessing the LLM service |
-| Max Tokens | The maximum number of tokens to generate in the response |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Response | The LLM's response to continue the conversation |
-| Error | Any error message if the process fails |
-
-### Possible use case
-Creating an interactive chatbot that can maintain context over multiple exchanges, such as a customer service assistant or a language learning companion.
-
----
-
-## AI List Generator
-
-### What it is
-A block that generates lists based on given prompts or source data using a Large Language Model (LLM).
-
-### What it does
-It takes a focus or source data, sends it to an LLM, and returns a generated list based on the input.
-
-### How it works
-The block formulates a prompt based on the given focus or source data, sends it to the chosen LLM, and then processes the response to ensure it's a valid Python list. It can retry multiple times if the initial attempts fail.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Focus | The main topic or theme for the list to be generated |
-| Source Data | Optional data to use as a basis for list generation |
-| Model | The specific LLM to use for list generation |
-| API Key | The secret key for accessing the LLM service |
-| Max Retries | The maximum number of attempts to generate a valid list |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Generated List | The full list generated by the LLM |
-| List Item | Each individual item in the generated list |
-| Error | Any error message if the process fails |
-
-### Possible use case
-Automatically generating a list of key points or action items from a long meeting transcript or summarizing the main topics discussed in a series of documents.
-
-# Providers
-There are severals providers that AutoGPT users can use for running inference with LLM models.
-
-## Llama API
-Llama API is a Meta-hosted API service that helps you integrate Llama models quickly and efficiently. Using OpenAI comptability endpoints, you can easily access the power of Llama models without the need for complex setup or configuration!
-
-Join the [waitlist](https://llama.developer.meta.com?utm_source=partner-autogpt&utm_medium=readme) to get access!
-
-Try the Llama API provider by selecting any of the following LLM Model names from the AI blocks mentioned above:
-- Llama-4-Scout-17B-16E-Instruct-FP8
-- Llama-4-Maverick-17B-128E-Instruct-FP8
-- Llama-3.3-8B-Instruct
-- Llama-3-70B-Instruct
diff --git a/docs/content/platform/blocks/search.md b/docs/content/platform/blocks/search.md
deleted file mode 100644
index bd10cef264..0000000000
--- a/docs/content/platform/blocks/search.md
+++ /dev/null
@@ -1,111 +0,0 @@
-## Get Wikipedia Summary
-
-### What it is
-A block that retrieves a summary of a given topic from Wikipedia.
-
-### What it does
-This block takes a topic as input and fetches a concise summary about that topic from Wikipedia's API.
-
-### How it works
-The block sends a request to Wikipedia's API with the provided topic. It then extracts the summary from the response and returns it. If there's an error during this process, it will return an error message instead.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Topic | The subject you want to get a summary about from Wikipedia |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Summary | A brief overview of the requested topic from Wikipedia |
-| Error | An error message if the summary retrieval fails |
-
-### Possible use case
-A student researching for a project could use this block to quickly get overviews of various topics, helping them decide which areas to focus on for more in-depth study.
-
----
-
-## Search The Web
-
-### What it is
-A block that performs web searches and returns the results.
-
-### What it does
-This block takes a search query and returns a list of relevant web pages, including their titles, URLs, and brief descriptions.
-
-### How it works
-The block sends the search query to a search engine API, processes the results, and returns them in a structured format.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Query | The search term or phrase to look up on the web |
-| Number of Results | How many search results to return (optional, default may vary) |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Results | A list of search results, each containing a title, URL, and description |
-| Error | An error message if the search fails |
-
-### Possible use case
-A content creator could use this block to research trending topics in their field, gathering ideas for new articles or videos.
-
----
-
-## Extract Website Content
-
-### What it is
-A block that retrieves and extracts content from specified websites.
-
-### What it does
-This block takes a URL as input, visits the webpage, and extracts the main content, removing navigation elements, ads, and other non-essential parts.
-
-### How it works
-The block sends a request to the given URL, downloads the HTML content, and uses content extraction algorithms to identify and extract the main text content of the page.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| URL | The web address of the page to extract content from |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Content | The main text content extracted from the webpage |
-| Title | The title of the webpage |
-| Error | An error message if the content extraction fails |
-
-### Possible use case
-A data analyst could use this block to automatically extract article content from news websites for sentiment analysis or topic modeling.
-
----
-
-## Get Weather Information
-
-### What it is
-A block that fetches current weather data for a specified location.
-
-### What it does
-This block takes a location name as input and returns current weather information such as temperature, humidity, and weather conditions.
-
-### How it works
-The block sends a request to a weather API (like OpenWeatherMap) with the provided location. It then processes the response to extract relevant weather data.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Location | The city or area you want to get weather information for |
-| API Key | Your personal OpenWeatherMap API key (this is kept secret) |
-| Use Celsius | An option to choose between Celsius (true) or Fahrenheit (false) for temperature |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Temperature | The current temperature in the specified location |
-| Humidity | The current humidity percentage in the specified location |
-| Condition | A description of the current weather condition (e.g., "overcast clouds") |
-| Error | A message explaining what went wrong if the weather data retrieval fails |
-
-### Possible use case
-A travel planning application could use this block to provide users with current weather information for their destination cities.
\ No newline at end of file
diff --git a/docs/content/platform/blocks/text.md b/docs/content/platform/blocks/text.md
deleted file mode 100644
index 20a55690f9..0000000000
--- a/docs/content/platform/blocks/text.md
+++ /dev/null
@@ -1,113 +0,0 @@
-## Match Text Pattern
-
-### What it is
-A block that matches text against a specified pattern.
-
-### What it does
-This block takes input text and a pattern, then checks if the text matches the pattern. It forwards the data to either a positive or negative output based on whether a match is found.
-
-### How it works
-The block uses regular expressions to search for the specified pattern within the input text. It considers options like case sensitivity and whether the dot should match all characters.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Text | The text to be matched against the pattern |
-| Match | The pattern (regular expression) to search for in the text |
-| Data | Additional information to be forwarded to the output |
-| Case sensitive | Option to make the match case-sensitive or not |
-| Dot all | Option to make the dot character match all characters, including newlines |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Positive | The output data if a match is found |
-| Negative | The output data if no match is found |
-
-### Possible use case
-Filtering customer feedback messages based on specific keywords or phrases to categorize them as positive or negative reviews.
-
----
-
-## Extract Text Information
-
-### What it is
-A block that extracts specific information from text using a pattern.
-
-### What it does
-This block searches for a pattern within the input text and extracts a portion of the text based on that pattern.
-
-### How it works
-The block uses regular expressions to find the specified pattern in the text. It then extracts a particular group from the match, which can be the entire match or a specific captured group.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Text | The text from which to extract information |
-| Pattern | The pattern (regular expression) used to find the desired information |
-| Group | The group number to extract from the match (0 for the entire match) |
-| Case sensitive | Option to make the match case-sensitive or not |
-| Dot all | Option to make the dot character match all characters, including newlines |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Positive | The extracted text if a match is found |
-| Negative | The original text if no match is found |
-
-### Possible use case
-Extracting phone numbers or email addresses from a large body of text, such as a customer database.
-
----
-
-## Fill Text Template
-
-### What it is
-A block that fills a text template with provided values.
-
-### What it does
-This block takes a template string and a dictionary of values, then replaces placeholders in the template with the corresponding values.
-
-### How it works
-The block uses a template engine to replace placeholders in the format string with the provided values. It supports both simple placeholder replacement and more complex operations like loops.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Values | A dictionary containing the values to be inserted into the template |
-| Format | The template string with placeholders for the values |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Output | The formatted text with placeholders replaced by actual values |
-
-### Possible use case
-Generating personalized email messages by filling a template with customer-specific information like name, order details, or account status.
-
----
-
-## Combine Texts
-
-### What it is
-A block that combines multiple text inputs into a single output.
-
-### What it does
-This block takes a list of text inputs and joins them together, optionally using a specified delimiter.
-
-### How it works
-The block concatenates all the input texts in the order they are provided, inserting the specified delimiter (if any) between each text.
-
-### Inputs
-| Input | Description |
-|-------|-------------|
-| Input | A list of text strings to be combined |
-| Delimiter | An optional string to be inserted between each text input (default is an empty string) |
-
-### Outputs
-| Output | Description |
-|--------|-------------|
-| Output | The combined text |
-
-### Possible use case
-Merging multiple parts of an address (street, city, state, zip code) into a single, formatted address string.
\ No newline at end of file
diff --git a/docs/home/.gitbook/assets/AGPT_Platform.png b/docs/home/.gitbook/assets/AGPT_Platform.png
new file mode 100644
index 0000000000..25df18a82a
Binary files /dev/null and b/docs/home/.gitbook/assets/AGPT_Platform.png differ
diff --git a/docs/home/.gitbook/assets/Banner_image.png b/docs/home/.gitbook/assets/Banner_image.png
new file mode 100644
index 0000000000..6dbcd2b632
Binary files /dev/null and b/docs/home/.gitbook/assets/Banner_image.png differ
diff --git a/docs/home/.gitbook/assets/Contribute.png b/docs/home/.gitbook/assets/Contribute.png
new file mode 100644
index 0000000000..b9fb058898
Binary files /dev/null and b/docs/home/.gitbook/assets/Contribute.png differ
diff --git a/docs/home/.gitbook/assets/Integrations.png b/docs/home/.gitbook/assets/Integrations.png
new file mode 100644
index 0000000000..9941a5ff08
Binary files /dev/null and b/docs/home/.gitbook/assets/Integrations.png differ
diff --git a/docs/home/.gitbook/assets/Screenshot 2025-08-11 at 12.21.17 PM.png b/docs/home/.gitbook/assets/Screenshot 2025-08-11 at 12.21.17 PM.png
new file mode 100644
index 0000000000..87cb432f95
Binary files /dev/null and b/docs/home/.gitbook/assets/Screenshot 2025-08-11 at 12.21.17 PM.png differ
diff --git a/docs/home/.gitbook/assets/api-reference.jpg b/docs/home/.gitbook/assets/api-reference.jpg
new file mode 100644
index 0000000000..13440be7dc
Binary files /dev/null and b/docs/home/.gitbook/assets/api-reference.jpg differ
diff --git a/docs/home/.gitbook/assets/hosted.jpg b/docs/home/.gitbook/assets/hosted.jpg
new file mode 100644
index 0000000000..d5f275ebf9
Binary files /dev/null and b/docs/home/.gitbook/assets/hosted.jpg differ
diff --git a/docs/home/.gitbook/assets/no-code.jpg b/docs/home/.gitbook/assets/no-code.jpg
new file mode 100644
index 0000000000..fdf54211a3
Binary files /dev/null and b/docs/home/.gitbook/assets/no-code.jpg differ
diff --git a/docs/home/.gitbook/assets/replicate-prediction-yt6p2d3gjhrma0ctdsv8vp1t70.jpeg b/docs/home/.gitbook/assets/replicate-prediction-yt6p2d3gjhrma0ctdsv8vp1t70.jpeg
new file mode 100644
index 0000000000..d52ba99c76
Binary files /dev/null and b/docs/home/.gitbook/assets/replicate-prediction-yt6p2d3gjhrma0ctdsv8vp1t70.jpeg differ
diff --git a/docs/home/README.md b/docs/home/README.md
new file mode 100644
index 0000000000..66d96c7e02
--- /dev/null
+++ b/docs/home/README.md
@@ -0,0 +1,52 @@
+---
+description: Welcome to your team’s developer platform
+cover: .gitbook/assets/Banner_image.png
+coverY: 56.53835084561286
+layout:
+  width: wide
+  cover:
+    visible: true
+    size: full
+  title:
+    visible: false
+  description:
+    visible: false
+  tableOfContents:
+    visible: false
+  outline:
+    visible: false
+  pagination:
+    visible: false
+  metadata:
+    visible: true
+---
+
+# Developer Platform
+
+<h2 align="center">AutoGPT Documentation</h2>
+
+<p align="center">Create innovative agents that amplify human potential</p>
+
+
+
+<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><h4><i class="fa-leaf">:leaf:</i></h4></td><td><strong>AutoGPT Platform</strong></td><td>Get started with the developer platform in 5 minutes.</td><td><a href="https://app.gitbook.com/o/ouZP6hgdu8LtbWil2Hvb/s/iMDOYkb9SC1mijdHzvKF/">AutoGPT Platform</a></td><td><a href=".gitbook/assets/AGPT_Platform.png">AGPT_Platform.png</a></td></tr><tr><td><h4><i class="fa-server">:server:</i></h4></td><td><strong>Integrations</strong></td><td>Learn more about hosting the developer platform.</td><td><a href="https://app.gitbook.com/o/ouZP6hgdu8LtbWil2Hvb/s/InwWrtMw9tc0NCzvPVK4/">Integrations</a></td><td><a href=".gitbook/assets/Integrations.png">Integrations.png</a></td></tr><tr><td><h4><i class="fa-terminal">:terminal:</i></h4></td><td><strong>Contribute</strong></td><td>Browse, test, and implement APIs.</td><td><a href="https://app.gitbook.com/s/x9A8W5T9IXYWENaFbHqO/">Contributing to the Docs</a></td><td><a href=".gitbook/assets/Contribute.png">Contribute.png</a></td></tr></tbody></table>
+
+{% columns %}
+{% column valign="middle" %}
+<p align="center"><a href="https://github.com/Significant-Gravitas/AutoGPT/blob/master/LICENSE">AutoGPT License on GitHub</a></p>
+{% endcolumn %}
+
+{% column %}
+<p align="center"><a href="https://app.gitbook.com/s/dDGesk9atyMLUMMo4QuI/autogpt-classic/introduction">AutoGPT Classic (Local Installation)</a></p>
+{% endcolumn %}
+{% endcolumns %}
+
+***
+
+
+
+<h2 align="center">Join a community of 65,000+ developers</h2>
+
+<p align="center">Join our Discord community or create your first PR in just a few steps.</p>
+
+<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><i class="fa-discord">:discord:</i></h4></td><td><strong>Discord community</strong></td><td>Join our Discord community to post questions, get help, and share resources with our growing community of over 55,000 members.</td><td><a href="https://www.gitbook.com/" class="button secondary">Join Discord</a></td><td></td><td><a href="https://discord.com/invite/autogpt">https://discord.com/invite/autogpt</a></td></tr><tr><td><h4><i class="fa-github">:github:</i></h4></td><td><strong>GitHub</strong></td><td>Our product is 100% open source and built by developers just like you. Head to our GitHub repository to learn how to submit your first PR.</td><td><a href="https://www.gitbook.com/" class="button secondary">Submit a PR</a></td><td></td><td><a href="https://github.com/Significant-Gravitas/AutoGPT">https://github.com/Significant-Gravitas/AutoGPT</a></td></tr></tbody></table>
diff --git a/docs/home/SUMMARY.md b/docs/home/SUMMARY.md
new file mode 100644
index 0000000000..d338256bc0
--- /dev/null
+++ b/docs/home/SUMMARY.md
@@ -0,0 +1,3 @@
+# Table of contents
+
+* [Developer Platform](README.md)
diff --git a/docs/integrations/README.md b/docs/integrations/README.md
new file mode 100644
index 0000000000..f954ac530f
--- /dev/null
+++ b/docs/integrations/README.md
@@ -0,0 +1,558 @@
+# AutoGPT Blocks Overview
+
+AutoGPT uses a modular approach with various "blocks" to handle different tasks. These blocks are the building blocks of AutoGPT workflows, allowing users to create complex automations by combining simple, specialized components.
+
+!!! info "Creating Your Own Blocks"
+    Want to create your own custom blocks? Check out our guides:
+    
+    - [Build your own Blocks](https://docs.agpt.co/platform/new_blocks/) - Step-by-step tutorial with examples
+    - [Block SDK Guide](https://docs.agpt.co/platform/block-sdk-guide/) - Advanced SDK patterns with OAuth, webhooks, and provider configuration
+
+Below is a comprehensive list of all available blocks, categorized by their primary function. Click on any block name to view its detailed documentation.
+
+## Basic Operations
+
+| Block Name | Description |
+|------------|-------------|
+| [Add Memory](basic.md#add-memory) | Add new memories to Mem0 with user segmentation |
+| [Add To Dictionary](basic.md#add-to-dictionary) | Adds a new key-value pair to a dictionary |
+| [Add To Library From Store](system/library_operations.md#add-to-library-from-store) | Add an agent from the store to your personal library |
+| [Add To List](basic.md#add-to-list) | Adds a new entry to a list |
+| [Agent Date Input](basic.md#agent-date-input) | Block for date input |
+| [Agent Dropdown Input](basic.md#agent-dropdown-input) | Block for dropdown text selection |
+| [Agent File Input](basic.md#agent-file-input) | Block for file upload input (string path for example) |
+| [Agent Google Drive File Input](basic.md#agent-google-drive-file-input) | Block for selecting a file from Google Drive |
+| [Agent Input](basic.md#agent-input) | A block that accepts and processes user input values within a workflow, supporting various input types and validation |
+| [Agent Long Text Input](basic.md#agent-long-text-input) | Block for long text input (multi-line) |
+| [Agent Number Input](basic.md#agent-number-input) | Block for number input |
+| [Agent Output](basic.md#agent-output) | A block that records and formats workflow results for display to users, with optional Jinja2 template formatting support |
+| [Agent Short Text Input](basic.md#agent-short-text-input) | Block for short text input (single-line) |
+| [Agent Table Input](basic.md#agent-table-input) | Block for table data input with customizable headers |
+| [Agent Time Input](basic.md#agent-time-input) | Block for time input |
+| [Agent Toggle Input](basic.md#agent-toggle-input) | Block for boolean toggle input |
+| [Block Installation](basic.md#block-installation) | Given a code string, this block allows the verification and installation of a block code into the system |
+| [Dictionary Is Empty](basic.md#dictionary-is-empty) | Checks if a dictionary is empty |
+| [File Store](basic.md#file-store) | Stores the input file in the temporary directory |
+| [Find In Dictionary](basic.md#find-in-dictionary) | A block that looks up a value in a dictionary, list, or object by key or index and returns the corresponding value |
+| [Find In List](basic.md#find-in-list) | Finds the index of the value in the list |
+| [Get All Memories](basic.md#get-all-memories) | Retrieve all memories from Mem0 with optional conversation filtering |
+| [Get Latest Memory](basic.md#get-latest-memory) | Retrieve the latest memory from Mem0 with optional key filtering |
+| [Get List Item](basic.md#get-list-item) | Returns the element at the given index |
+| [Get Store Agent Details](system/store_operations.md#get-store-agent-details) | Get detailed information about an agent from the store |
+| [Get Weather Information](basic.md#get-weather-information) | Retrieves weather information for a specified location using OpenWeatherMap API |
+| [Human In The Loop](basic.md#human-in-the-loop) | Pause execution and wait for human approval or modification of data |
+| [Linear Search Issues](linear/issues.md#linear-search-issues) | Searches for issues on Linear |
+| [List Is Empty](basic.md#list-is-empty) | Checks if a list is empty |
+| [List Library Agents](system/library_operations.md#list-library-agents) | List all agents in your personal library |
+| [Note](basic.md#note) | A visual annotation block that displays a sticky note in the workflow editor for documentation and organization purposes |
+| [Print To Console](basic.md#print-to-console) | A debugging block that outputs text to the console for monitoring and troubleshooting workflow execution |
+| [Remove From Dictionary](basic.md#remove-from-dictionary) | Removes a key-value pair from a dictionary |
+| [Remove From List](basic.md#remove-from-list) | Removes an item from a list by value or index |
+| [Replace Dictionary Value](basic.md#replace-dictionary-value) | Replaces the value for a specified key in a dictionary |
+| [Replace List Item](basic.md#replace-list-item) | Replaces an item at the specified index |
+| [Reverse List Order](basic.md#reverse-list-order) | Reverses the order of elements in a list |
+| [Search Memory](basic.md#search-memory) | Search memories in Mem0 by user |
+| [Search Store Agents](system/store_operations.md#search-store-agents) | Search for agents in the store |
+| [Slant3D Cancel Order](slant3d/order.md#slant3d-cancel-order) | Cancel an existing order |
+| [Slant3D Create Order](slant3d/order.md#slant3d-create-order) | Create a new print order |
+| [Slant3D Estimate Order](slant3d/order.md#slant3d-estimate-order) | Get order cost estimate |
+| [Slant3D Estimate Shipping](slant3d/order.md#slant3d-estimate-shipping) | Get shipping cost estimate |
+| [Slant3D Filament](slant3d/filament.md#slant3d-filament) | Get list of available filaments |
+| [Slant3D Get Orders](slant3d/order.md#slant3d-get-orders) | Get all orders for the account |
+| [Slant3D Slicer](slant3d/slicing.md#slant3d-slicer) | Slice a 3D model file and get pricing information |
+| [Slant3D Tracking](slant3d/order.md#slant3d-tracking) | Track order status and shipping |
+| [Store Value](basic.md#store-value) | A basic block that stores and forwards a value throughout workflows, allowing it to be reused without changes across multiple blocks |
+| [Universal Type Converter](basic.md#universal-type-converter) | This block is used to convert a value to a universal type |
+| [XML Parser](basic.md#xml-parser) | Parses XML using gravitasml to tokenize and coverts it to dict |
+
+## Data Processing
+
+| Block Name | Description |
+|------------|-------------|
+| [Airtable Create Base](airtable/bases.md#airtable-create-base) | Create or find a base in Airtable |
+| [Airtable Create Field](airtable/schema.md#airtable-create-field) | Add a new field to an Airtable table |
+| [Airtable Create Records](airtable/records.md#airtable-create-records) | Create records in an Airtable table |
+| [Airtable Create Table](airtable/schema.md#airtable-create-table) | Create a new table in an Airtable base |
+| [Airtable Delete Records](airtable/records.md#airtable-delete-records) | Delete records from an Airtable table |
+| [Airtable Get Record](airtable/records.md#airtable-get-record) | Get a single record from Airtable |
+| [Airtable List Bases](airtable/bases.md#airtable-list-bases) | List all bases in Airtable |
+| [Airtable List Records](airtable/records.md#airtable-list-records) | List records from an Airtable table |
+| [Airtable List Schema](airtable/schema.md#airtable-list-schema) | Get the complete schema of an Airtable base |
+| [Airtable Update Field](airtable/schema.md#airtable-update-field) | Update field properties in an Airtable table |
+| [Airtable Update Records](airtable/records.md#airtable-update-records) | Update records in an Airtable table |
+| [Airtable Update Table](airtable/schema.md#airtable-update-table) | Update table properties |
+| [Airtable Webhook Trigger](airtable/triggers.md#airtable-webhook-trigger) | Starts a flow whenever Airtable emits a webhook event |
+| [Baas Bot Delete Recording](baas/bots.md#baas-bot-delete-recording) | Permanently delete a meeting's recorded data |
+| [Baas Bot Fetch Meeting Data](baas/bots.md#baas-bot-fetch-meeting-data) | Retrieve recorded meeting data |
+| [Create Dictionary](data.md#create-dictionary) | Creates a dictionary with the specified key-value pairs |
+| [Create List](data.md#create-list) | Creates a list with the specified values |
+| [Data For Seo Keyword Suggestions](dataforseo/keyword_suggestions.md#data-for-seo-keyword-suggestions) | Get keyword suggestions from DataForSEO Labs Google API |
+| [Data For Seo Related Keywords](dataforseo/related_keywords.md#data-for-seo-related-keywords) | Get related keywords from DataForSEO Labs Google API |
+| [Exa Create Import](exa/websets_import_export.md#exa-create-import) | Import CSV data to use with websets for targeted searches |
+| [Exa Delete Import](exa/websets_import_export.md#exa-delete-import) | Delete an import |
+| [Exa Export Webset](exa/websets_import_export.md#exa-export-webset) | Export webset data in JSON, CSV, or JSON Lines format |
+| [Exa Get Import](exa/websets_import_export.md#exa-get-import) | Get the status and details of an import |
+| [Exa Get New Items](exa/websets_items.md#exa-get-new-items) | Get items added since a cursor - enables incremental processing without reprocessing |
+| [Exa List Imports](exa/websets_import_export.md#exa-list-imports) | List all imports with pagination support |
+| [File Read](data.md#file-read) | Reads a file and returns its content as a string, with optional chunking by delimiter and size limits |
+| [Google Calendar Read Events](google/calendar.md#google-calendar-read-events) | Retrieves upcoming events from a Google Calendar with filtering options |
+| [Google Docs Append Markdown](google/docs.md#google-docs-append-markdown) | Append Markdown content to the end of a Google Doc with full formatting - ideal for LLM/AI output |
+| [Google Docs Append Plain Text](google/docs.md#google-docs-append-plain-text) | Append plain text to the end of a Google Doc (no formatting applied) |
+| [Google Docs Create](google/docs.md#google-docs-create) | Create a new Google Doc |
+| [Google Docs Delete Content](google/docs.md#google-docs-delete-content) | Delete a range of content from a Google Doc |
+| [Google Docs Export](google/docs.md#google-docs-export) | Export a Google Doc to PDF, Word, text, or other formats |
+| [Google Docs Find Replace Plain Text](google/docs.md#google-docs-find-replace-plain-text) | Find and replace plain text in a Google Doc (no formatting applied to replacement) |
+| [Google Docs Format Text](google/docs.md#google-docs-format-text) | Apply formatting (bold, italic, color, etc |
+| [Google Docs Get Metadata](google/docs.md#google-docs-get-metadata) | Get metadata about a Google Doc |
+| [Google Docs Get Structure](google/docs.md#google-docs-get-structure) | Get document structure with index positions for precise editing operations |
+| [Google Docs Insert Markdown At](google/docs.md#google-docs-insert-markdown-at) | Insert formatted Markdown at a specific position in a Google Doc - ideal for LLM/AI output |
+| [Google Docs Insert Page Break](google/docs.md#google-docs-insert-page-break) | Insert a page break into a Google Doc |
+| [Google Docs Insert Plain Text](google/docs.md#google-docs-insert-plain-text) | Insert plain text at a specific position in a Google Doc (no formatting applied) |
+| [Google Docs Insert Table](google/docs.md#google-docs-insert-table) | Insert a table into a Google Doc, optionally with content and Markdown formatting |
+| [Google Docs Read](google/docs.md#google-docs-read) | Read text content from a Google Doc |
+| [Google Docs Replace All With Markdown](google/docs.md#google-docs-replace-all-with-markdown) | Replace entire Google Doc content with formatted Markdown - ideal for LLM/AI output |
+| [Google Docs Replace Content With Markdown](google/docs.md#google-docs-replace-content-with-markdown) | Find text and replace it with formatted Markdown - ideal for LLM/AI output and templates |
+| [Google Docs Replace Range With Markdown](google/docs.md#google-docs-replace-range-with-markdown) | Replace a specific index range in a Google Doc with formatted Markdown - ideal for LLM/AI output |
+| [Google Docs Set Public Access](google/docs.md#google-docs-set-public-access) | Make a Google Doc public or private |
+| [Google Docs Share](google/docs.md#google-docs-share) | Share a Google Doc with specific users |
+| [Google Sheets Add Column](google/sheets.md#google-sheets-add-column) | Add a new column with a header |
+| [Google Sheets Add Dropdown](google/sheets.md#google-sheets-add-dropdown) | Add a dropdown list (data validation) to cells |
+| [Google Sheets Add Note](google/sheets.md#google-sheets-add-note) | Add a note to a cell in a Google Sheet |
+| [Google Sheets Append Row](google/sheets.md#google-sheets-append-row) | Append or Add a single row to the end of a Google Sheet |
+| [Google Sheets Batch Operations](google/sheets.md#google-sheets-batch-operations) | This block performs multiple operations on a Google Sheets spreadsheet in a single batch request |
+| [Google Sheets Clear](google/sheets.md#google-sheets-clear) | This block clears data from a specified range in a Google Sheets spreadsheet |
+| [Google Sheets Copy To Spreadsheet](google/sheets.md#google-sheets-copy-to-spreadsheet) | Copy a sheet from one spreadsheet to another |
+| [Google Sheets Create Named Range](google/sheets.md#google-sheets-create-named-range) | Create a named range to reference cells by name instead of A1 notation |
+| [Google Sheets Create Spreadsheet](google/sheets.md#google-sheets-create-spreadsheet) | This block creates a new Google Sheets spreadsheet with specified sheets |
+| [Google Sheets Delete Column](google/sheets.md#google-sheets-delete-column) | Delete a column by header name or column letter |
+| [Google Sheets Delete Rows](google/sheets.md#google-sheets-delete-rows) | Delete specific rows from a Google Sheet by their row indices |
+| [Google Sheets Export Csv](google/sheets.md#google-sheets-export-csv) | Export a Google Sheet as CSV data |
+| [Google Sheets Filter Rows](google/sheets.md#google-sheets-filter-rows) | Filter rows in a Google Sheet based on a column condition |
+| [Google Sheets Find](google/sheets.md#google-sheets-find) | Find text in a Google Sheets spreadsheet |
+| [Google Sheets Find Replace](google/sheets.md#google-sheets-find-replace) | This block finds and replaces text in a Google Sheets spreadsheet |
+| [Google Sheets Format](google/sheets.md#google-sheets-format) | Format a range in a Google Sheet (sheet optional) |
+| [Google Sheets Get Column](google/sheets.md#google-sheets-get-column) | Extract all values from a specific column |
+| [Google Sheets Get Notes](google/sheets.md#google-sheets-get-notes) | Get notes from cells in a Google Sheet |
+| [Google Sheets Get Row](google/sheets.md#google-sheets-get-row) | Get a specific row by its index |
+| [Google Sheets Get Row Count](google/sheets.md#google-sheets-get-row-count) | Get row count and dimensions of a Google Sheet |
+| [Google Sheets Get Unique Values](google/sheets.md#google-sheets-get-unique-values) | Get unique values from a column |
+| [Google Sheets Import Csv](google/sheets.md#google-sheets-import-csv) | Import CSV data into a Google Sheet |
+| [Google Sheets Insert Row](google/sheets.md#google-sheets-insert-row) | Insert a single row at a specific position |
+| [Google Sheets List Named Ranges](google/sheets.md#google-sheets-list-named-ranges) | List all named ranges in a spreadsheet |
+| [Google Sheets Lookup Row](google/sheets.md#google-sheets-lookup-row) | Look up a row by finding a value in a specific column |
+| [Google Sheets Manage Sheet](google/sheets.md#google-sheets-manage-sheet) | Create, delete, or copy sheets (sheet optional) |
+| [Google Sheets Metadata](google/sheets.md#google-sheets-metadata) | This block retrieves metadata about a Google Sheets spreadsheet including sheet names and properties |
+| [Google Sheets Protect Range](google/sheets.md#google-sheets-protect-range) | Protect a cell range or entire sheet from editing |
+| [Google Sheets Read](google/sheets.md#google-sheets-read) | A block that reads data from a Google Sheets spreadsheet using A1 notation range selection |
+| [Google Sheets Remove Duplicates](google/sheets.md#google-sheets-remove-duplicates) | Remove duplicate rows based on specified columns |
+| [Google Sheets Set Public Access](google/sheets.md#google-sheets-set-public-access) | Make a Google Spreadsheet public or private |
+| [Google Sheets Share Spreadsheet](google/sheets.md#google-sheets-share-spreadsheet) | Share a Google Spreadsheet with users or get shareable link |
+| [Google Sheets Sort](google/sheets.md#google-sheets-sort) | Sort a Google Sheet by one or two columns |
+| [Google Sheets Update Cell](google/sheets.md#google-sheets-update-cell) | Update a single cell in a Google Sheets spreadsheet |
+| [Google Sheets Update Row](google/sheets.md#google-sheets-update-row) | Update a specific row by its index |
+| [Google Sheets Write](google/sheets.md#google-sheets-write) | A block that writes data to a Google Sheets spreadsheet at a specified A1 notation range |
+| [Keyword Suggestion Extractor](dataforseo/keyword_suggestions.md#keyword-suggestion-extractor) | Extract individual fields from a KeywordSuggestion object |
+| [Persist Information](data.md#persist-information) | Persist key-value information for the current user |
+| [Read Spreadsheet](data.md#read-spreadsheet) | Reads CSV and Excel files and outputs the data as a list of dictionaries and individual rows |
+| [Related Keyword Extractor](dataforseo/related_keywords.md#related-keyword-extractor) | Extract individual fields from a RelatedKeyword object |
+| [Retrieve Information](data.md#retrieve-information) | Retrieve key-value information for the current user |
+| [Screenshot Web Page](data.md#screenshot-web-page) | Takes a screenshot of a specified website using ScreenshotOne API |
+
+## Text Processing
+
+| Block Name | Description |
+|------------|-------------|
+| [Code Extraction](text.md#code-extraction) | Extracts code blocks from text and identifies their programming languages |
+| [Combine Texts](text.md#combine-texts) | This block combines multiple input texts into a single output text |
+| [Countdown Timer](text.md#countdown-timer) | This block triggers after a specified duration |
+| [Extract Text Information](text.md#extract-text-information) | This block extracts the text from the given text using the pattern (regex) |
+| [Fill Text Template](text.md#fill-text-template) | This block formats the given texts using the format template |
+| [Get Current Date](text.md#get-current-date) | This block outputs the current date with an optional offset |
+| [Get Current Date And Time](text.md#get-current-date-and-time) | This block outputs the current date and time |
+| [Get Current Time](text.md#get-current-time) | This block outputs the current time |
+| [Match Text Pattern](text.md#match-text-pattern) | Matches text against a regex pattern and forwards data to positive or negative output based on the match |
+| [Text Decoder](text.md#text-decoder) | Decodes a string containing escape sequences into actual text |
+| [Text Replace](text.md#text-replace) | This block is used to replace a text with a new text |
+| [Text Split](text.md#text-split) | This block is used to split a text into a list of strings |
+| [Word Character Count](text.md#word-character-count) | Counts the number of words and characters in a given text |
+
+## AI and Language Models
+
+| Block Name | Description |
+|------------|-------------|
+| [AI Ad Maker Video Creator](llm.md#ai-ad-maker-video-creator) | Creates an AI‑generated 30‑second advert (text + images) |
+| [AI Condition](llm.md#ai-condition) | Uses AI to evaluate natural language conditions and provide conditional outputs |
+| [AI Conversation](llm.md#ai-conversation) | A block that facilitates multi-turn conversations with a Large Language Model (LLM), maintaining context across message exchanges |
+| [AI Image Customizer](llm.md#ai-image-customizer) | Generate and edit custom images using Google's Nano-Banana model from Gemini 2 |
+| [AI Image Editor](llm.md#ai-image-editor) | Edit images using BlackForest Labs' Flux Kontext models |
+| [AI Image Generator](llm.md#ai-image-generator) | Generate images using various AI models through a unified interface |
+| [AI List Generator](llm.md#ai-list-generator) | A block that creates lists of items based on prompts using a Large Language Model (LLM), with optional source data for context |
+| [AI Music Generator](llm.md#ai-music-generator) | This block generates music using Meta's MusicGen model on Replicate |
+| [AI Screenshot To Video Ad](llm.md#ai-screenshot-to-video-ad) | Turns a screenshot into an engaging, avatar‑narrated video advert |
+| [AI Shortform Video Creator](llm.md#ai-shortform-video-creator) | Creates a shortform video using revid |
+| [AI Structured Response Generator](llm.md#ai-structured-response-generator) | A block that generates structured JSON responses using a Large Language Model (LLM), with schema validation and format enforcement |
+| [AI Text Generator](llm.md#ai-text-generator) | A block that produces text responses using a Large Language Model (LLM) based on customizable prompts and system instructions |
+| [AI Text Summarizer](llm.md#ai-text-summarizer) | A block that summarizes long texts using a Large Language Model (LLM), with configurable focus topics and summary styles |
+| [AI Video Generator](fal/ai_video_generator.md#ai-video-generator) | Generate videos using FAL AI models |
+| [Bannerbear Text Overlay](bannerbear/text_overlay.md#bannerbear-text-overlay) | Add text overlay to images using Bannerbear templates |
+| [Code Generation](llm.md#code-generation) | Generate or refactor code using OpenAI's Codex (Responses API) |
+| [Create Talking Avatar Video](llm.md#create-talking-avatar-video) | This block integrates with D-ID to create video clips and retrieve their URLs |
+| [Exa Answer](exa/answers.md#exa-answer) | Get an LLM answer to a question informed by Exa search results |
+| [Exa Create Enrichment](exa/websets_enrichment.md#exa-create-enrichment) | Create enrichments to extract additional structured data from webset items |
+| [Exa Create Research](exa/research.md#exa-create-research) | Create research task with optional waiting - explores web and synthesizes findings with citations |
+| [Ideogram Model](llm.md#ideogram-model) | This block runs Ideogram models with both simple and advanced settings |
+| [Jina Chunking](jina/chunking.md#jina-chunking) | Chunks texts using Jina AI's segmentation service |
+| [Jina Embedding](jina/embeddings.md#jina-embedding) | Generates embeddings using Jina AI |
+| [Perplexity](llm.md#perplexity) | Query Perplexity's sonar models with real-time web search capabilities and receive annotated responses with source citations |
+| [Replicate Flux Advanced Model](replicate/flux_advanced.md#replicate-flux-advanced-model) | This block runs Flux models on Replicate with advanced settings |
+| [Replicate Model](replicate/replicate_block.md#replicate-model) | Run Replicate models synchronously |
+| [Smart Decision Maker](llm.md#smart-decision-maker) | Uses AI to intelligently decide what tool to use |
+| [Stagehand Act](stagehand/blocks.md#stagehand-act) | Interact with a web page by performing actions on a web page |
+| [Stagehand Extract](stagehand/blocks.md#stagehand-extract) | Extract structured data from a webpage |
+| [Stagehand Observe](stagehand/blocks.md#stagehand-observe) | Find suggested actions for your workflows |
+| [Unreal Text To Speech](llm.md#unreal-text-to-speech) | Converts text to speech using the Unreal Speech API |
+
+## Search and Information Retrieval
+
+| Block Name | Description |
+|------------|-------------|
+| [Ask Wolfram](wolfram/llm_api.md#ask-wolfram) | Ask Wolfram Alpha a question |
+| [Exa Bulk Webset Items](exa/websets_items.md#exa-bulk-webset-items) | Get all items from a webset in bulk (with configurable limits) |
+| [Exa Cancel Enrichment](exa/websets_enrichment.md#exa-cancel-enrichment) | Cancel a running enrichment operation |
+| [Exa Cancel Webset](exa/websets.md#exa-cancel-webset) | Cancel all operations being performed on a Webset |
+| [Exa Cancel Webset Search](exa/websets_search.md#exa-cancel-webset-search) | Cancel a running webset search |
+| [Exa Contents](exa/contents.md#exa-contents) | Retrieves document contents using Exa's contents API |
+| [Exa Create Monitor](exa/websets_monitor.md#exa-create-monitor) | Create automated monitors to keep websets updated with fresh data on a schedule |
+| [Exa Create Or Find Webset](exa/websets.md#exa-create-or-find-webset) | Create a new webset or return existing one by external_id (idempotent operation) |
+| [Exa Create Webset](exa/websets.md#exa-create-webset) | Create a new Exa Webset for persistent web search collections with optional waiting for initial results |
+| [Exa Create Webset Search](exa/websets_search.md#exa-create-webset-search) | Add a new search to an existing webset to find more items |
+| [Exa Delete Enrichment](exa/websets_enrichment.md#exa-delete-enrichment) | Delete an enrichment from a webset |
+| [Exa Delete Monitor](exa/websets_monitor.md#exa-delete-monitor) | Delete a monitor from a webset |
+| [Exa Delete Webset](exa/websets.md#exa-delete-webset) | Delete a Webset and all its items |
+| [Exa Delete Webset Item](exa/websets_items.md#exa-delete-webset-item) | Delete a specific item from a webset |
+| [Exa Find Or Create Search](exa/websets_search.md#exa-find-or-create-search) | Find existing search by query or create new - prevents duplicate searches in workflows |
+| [Exa Find Similar](exa/similar.md#exa-find-similar) | Finds similar links using Exa's findSimilar API |
+| [Exa Get Enrichment](exa/websets_enrichment.md#exa-get-enrichment) | Get the status and details of a webset enrichment |
+| [Exa Get Monitor](exa/websets_monitor.md#exa-get-monitor) | Get the details and status of a webset monitor |
+| [Exa Get Research](exa/research.md#exa-get-research) | Get status and results of a research task |
+| [Exa Get Webset](exa/websets.md#exa-get-webset) | Retrieve a Webset by ID or external ID |
+| [Exa Get Webset Item](exa/websets_items.md#exa-get-webset-item) | Get a specific item from a webset by its ID |
+| [Exa Get Webset Search](exa/websets_search.md#exa-get-webset-search) | Get the status and details of a webset search |
+| [Exa List Monitors](exa/websets_monitor.md#exa-list-monitors) | List all monitors with optional webset filtering |
+| [Exa List Research](exa/research.md#exa-list-research) | List all research tasks with pagination support |
+| [Exa List Webset Items](exa/websets_items.md#exa-list-webset-items) | List items in a webset with pagination support |
+| [Exa List Websets](exa/websets.md#exa-list-websets) | List all Websets with pagination support |
+| [Exa Preview Webset](exa/websets.md#exa-preview-webset) | Preview how a search query will be interpreted before creating a webset |
+| [Exa Search](exa/search.md#exa-search) | Searches the web using Exa's advanced search API |
+| [Exa Update Enrichment](exa/websets_enrichment.md#exa-update-enrichment) | Update an existing enrichment configuration |
+| [Exa Update Monitor](exa/websets_monitor.md#exa-update-monitor) | Update a monitor's status, schedule, or metadata |
+| [Exa Update Webset](exa/websets.md#exa-update-webset) | Update metadata for an existing Webset |
+| [Exa Wait For Enrichment](exa/websets_polling.md#exa-wait-for-enrichment) | Wait for a webset enrichment to complete with progress tracking |
+| [Exa Wait For Research](exa/research.md#exa-wait-for-research) | Wait for a research task to complete with configurable timeout |
+| [Exa Wait For Search](exa/websets_polling.md#exa-wait-for-search) | Wait for a specific webset search to complete with progress tracking |
+| [Exa Wait For Webset](exa/websets_polling.md#exa-wait-for-webset) | Wait for a webset to reach a specific status with progress tracking |
+| [Exa Webset Items Summary](exa/websets_items.md#exa-webset-items-summary) | Get a summary of webset items without retrieving all data |
+| [Exa Webset Status](exa/websets.md#exa-webset-status) | Get a quick status overview of a webset |
+| [Exa Webset Summary](exa/websets.md#exa-webset-summary) | Get a comprehensive summary of a webset with samples and statistics |
+| [Extract Website Content](jina/search.md#extract-website-content) | This block scrapes the content from the given web URL |
+| [Fact Checker](jina/fact_checker.md#fact-checker) | This block checks the factuality of a given statement using Jina AI's Grounding API |
+| [Firecrawl Crawl](firecrawl/crawl.md#firecrawl-crawl) | Firecrawl crawls websites to extract comprehensive data while bypassing blockers |
+| [Firecrawl Extract](firecrawl/extract.md#firecrawl-extract) | Firecrawl crawls websites to extract comprehensive data while bypassing blockers |
+| [Firecrawl Map Website](firecrawl/map.md#firecrawl-map-website) | Firecrawl maps a website to extract all the links |
+| [Firecrawl Scrape](firecrawl/scrape.md#firecrawl-scrape) | Firecrawl scrapes a website to extract comprehensive data while bypassing blockers |
+| [Firecrawl Search](firecrawl/search.md#firecrawl-search) | Firecrawl searches the web for the given query |
+| [Get Person Detail](apollo/person.md#get-person-detail) | Get detailed person data with Apollo API, including email reveal |
+| [Get Wikipedia Summary](search.md#get-wikipedia-summary) | This block fetches the summary of a given topic from Wikipedia |
+| [Google Maps Search](search.md#google-maps-search) | This block searches for local businesses using Google Maps API |
+| [Search Organizations](apollo/organization.md#search-organizations) | Search for organizations in Apollo |
+| [Search People](apollo/people.md#search-people) | Search for people in Apollo |
+| [Search The Web](jina/search.md#search-the-web) | This block searches the internet for the given search query |
+| [Validate Emails](zerobounce/validate_emails.md#validate-emails) | Validate emails |
+
+## Social Media and Content
+
+| Block Name | Description |
+|------------|-------------|
+| [Create Discord Thread](discord/bot_blocks.md#create-discord-thread) | Creates a new thread in a Discord channel |
+| [Create Reddit Post](misc.md#create-reddit-post) | Create a new post on a subreddit |
+| [Delete Reddit Comment](misc.md#delete-reddit-comment) | Delete a Reddit comment that you own |
+| [Delete Reddit Post](misc.md#delete-reddit-post) | Delete a Reddit post that you own |
+| [Discord Channel Info](discord/bot_blocks.md#discord-channel-info) | Resolves Discord channel names to IDs and vice versa |
+| [Discord Get Current User](discord/oauth_blocks.md#discord-get-current-user) | Gets information about the currently authenticated Discord user using OAuth2 credentials |
+| [Discord User Info](discord/bot_blocks.md#discord-user-info) | Gets information about a Discord user by their ID |
+| [Edit Reddit Post](misc.md#edit-reddit-post) | Edit the body text of an existing Reddit post that you own |
+| [Get Linkedin Profile](enrichlayer/linkedin.md#get-linkedin-profile) | Fetch LinkedIn profile data using Enrichlayer |
+| [Get Linkedin Profile Picture](enrichlayer/linkedin.md#get-linkedin-profile-picture) | Get LinkedIn profile pictures using Enrichlayer |
+| [Get Reddit Comment](misc.md#get-reddit-comment) | Get details about a specific Reddit comment by its ID |
+| [Get Reddit Comment Replies](misc.md#get-reddit-comment-replies) | Get replies to a specific Reddit comment |
+| [Get Reddit Inbox](misc.md#get-reddit-inbox) | Get messages, mentions, and comment replies from your Reddit inbox |
+| [Get Reddit Post](misc.md#get-reddit-post) | Get detailed information about a specific Reddit post by its ID |
+| [Get Reddit Post Comments](misc.md#get-reddit-post-comments) | Get top-level comments on a Reddit post |
+| [Get Reddit Posts](misc.md#get-reddit-posts) | This block fetches Reddit posts from a defined subreddit name |
+| [Get Reddit User Info](misc.md#get-reddit-user-info) | Get information about a Reddit user including karma, account age, and verification status |
+| [Get Subreddit Flairs](misc.md#get-subreddit-flairs) | Get available link flair options for a subreddit |
+| [Get Subreddit Info](misc.md#get-subreddit-info) | Get information about a subreddit including subscriber count, description, and rules |
+| [Get Subreddit Rules](misc.md#get-subreddit-rules) | Get the rules for a subreddit to ensure compliance before posting |
+| [Get User Posts](misc.md#get-user-posts) | Fetch posts by a specific Reddit user |
+| [Linkedin Person Lookup](enrichlayer/linkedin.md#linkedin-person-lookup) | Look up LinkedIn profiles by person information using Enrichlayer |
+| [Linkedin Role Lookup](enrichlayer/linkedin.md#linkedin-role-lookup) | Look up LinkedIn profiles by role in a company using Enrichlayer |
+| [Post Reddit Comment](misc.md#post-reddit-comment) | This block posts a Reddit comment on a specified Reddit post |
+| [Post To Bluesky](ayrshare/post_to_bluesky.md#post-to-bluesky) | Post to Bluesky using Ayrshare |
+| [Post To Facebook](ayrshare/post_to_facebook.md#post-to-facebook) | Post to Facebook using Ayrshare |
+| [Post To GMB](ayrshare/post_to_gmb.md#post-to-gmb) | Post to Google My Business using Ayrshare |
+| [Post To Instagram](ayrshare/post_to_instagram.md#post-to-instagram) | Post to Instagram using Ayrshare |
+| [Post To Linked In](ayrshare/post_to_linkedin.md#post-to-linked-in) | Post to LinkedIn using Ayrshare |
+| [Post To Pinterest](ayrshare/post_to_pinterest.md#post-to-pinterest) | Post to Pinterest using Ayrshare |
+| [Post To Reddit](ayrshare/post_to_reddit.md#post-to-reddit) | Post to Reddit using Ayrshare |
+| [Post To Snapchat](ayrshare/post_to_snapchat.md#post-to-snapchat) | Post to Snapchat using Ayrshare |
+| [Post To Telegram](ayrshare/post_to_telegram.md#post-to-telegram) | Post to Telegram using Ayrshare |
+| [Post To Threads](ayrshare/post_to_threads.md#post-to-threads) | Post to Threads using Ayrshare |
+| [Post To Tik Tok](ayrshare/post_to_tiktok.md#post-to-tik-tok) | Post to TikTok using Ayrshare |
+| [Post To X](ayrshare/post_to_x.md#post-to-x) | Post to X / Twitter using Ayrshare |
+| [Post To You Tube](ayrshare/post_to_youtube.md#post-to-you-tube) | Post to YouTube using Ayrshare |
+| [Publish To Medium](misc.md#publish-to-medium) | Publishes a post to Medium |
+| [Read Discord Messages](discord/bot_blocks.md#read-discord-messages) | Reads messages from a Discord channel using a bot token |
+| [Reddit Get My Posts](misc.md#reddit-get-my-posts) | Fetch posts created by the authenticated Reddit user (you) |
+| [Reply To Discord Message](discord/bot_blocks.md#reply-to-discord-message) | Replies to a specific Discord message |
+| [Reply To Reddit Comment](misc.md#reply-to-reddit-comment) | Reply to a specific Reddit comment |
+| [Search Reddit](misc.md#search-reddit) | Search Reddit for posts matching a query |
+| [Send Discord DM](discord/bot_blocks.md#send-discord-dm) | Sends a direct message to a Discord user using their user ID |
+| [Send Discord Embed](discord/bot_blocks.md#send-discord-embed) | Sends a rich embed message to a Discord channel |
+| [Send Discord File](discord/bot_blocks.md#send-discord-file) | Sends a file attachment to a Discord channel |
+| [Send Discord Message](discord/bot_blocks.md#send-discord-message) | Sends a message to a Discord channel using a bot token |
+| [Send Reddit Message](misc.md#send-reddit-message) | Send a private message (DM) to a Reddit user |
+| [Transcribe Youtube Video](misc.md#transcribe-youtube-video) | Transcribes a YouTube video using a proxy |
+| [Twitter Add List Member](twitter/list_members.md#twitter-add-list-member) | This block adds a specified user to a Twitter List owned by the authenticated user |
+| [Twitter Bookmark Tweet](twitter/bookmark.md#twitter-bookmark-tweet) | This block bookmarks a tweet on Twitter |
+| [Twitter Create List](twitter/manage_lists.md#twitter-create-list) | This block creates a new Twitter List for the authenticated user |
+| [Twitter Delete List](twitter/manage_lists.md#twitter-delete-list) | This block deletes a specified Twitter List owned by the authenticated user |
+| [Twitter Delete Tweet](twitter/manage.md#twitter-delete-tweet) | This block deletes a tweet on Twitter |
+| [Twitter Follow List](twitter/list_follows.md#twitter-follow-list) | This block follows a specified Twitter list for the authenticated user |
+| [Twitter Follow User](twitter/follows.md#twitter-follow-user) | This block follows a specified Twitter user |
+| [Twitter Get Blocked Users](twitter/blocks.md#twitter-get-blocked-users) | This block retrieves a list of users blocked by the authenticating user |
+| [Twitter Get Bookmarked Tweets](twitter/bookmark.md#twitter-get-bookmarked-tweets) | This block retrieves bookmarked tweets from Twitter |
+| [Twitter Get Followers](twitter/follows.md#twitter-get-followers) | This block retrieves followers of a specified Twitter user |
+| [Twitter Get Following](twitter/follows.md#twitter-get-following) | This block retrieves the users that a specified Twitter user is following |
+| [Twitter Get Home Timeline](twitter/timeline.md#twitter-get-home-timeline) | This block retrieves the authenticated user's home timeline |
+| [Twitter Get Liked Tweets](twitter/like.md#twitter-get-liked-tweets) | This block gets information about tweets liked by a user |
+| [Twitter Get Liking Users](twitter/like.md#twitter-get-liking-users) | This block gets information about users who liked a tweet |
+| [Twitter Get List](twitter/list_lookup.md#twitter-get-list) | This block retrieves information about a specified Twitter List |
+| [Twitter Get List Members](twitter/list_members.md#twitter-get-list-members) | This block retrieves the members of a specified Twitter List |
+| [Twitter Get List Memberships](twitter/list_members.md#twitter-get-list-memberships) | This block retrieves all Lists that a specified user is a member of |
+| [Twitter Get List Tweets](twitter/list_tweets_lookup.md#twitter-get-list-tweets) | This block retrieves tweets from a specified Twitter list |
+| [Twitter Get Muted Users](twitter/mutes.md#twitter-get-muted-users) | This block gets a list of users muted by the authenticating user |
+| [Twitter Get Owned Lists](twitter/list_lookup.md#twitter-get-owned-lists) | This block retrieves all Lists owned by a specified Twitter user |
+| [Twitter Get Pinned Lists](twitter/pinned_lists.md#twitter-get-pinned-lists) | This block returns the Lists pinned by the authenticated user |
+| [Twitter Get Quote Tweets](twitter/quote.md#twitter-get-quote-tweets) | This block gets quote tweets for a specific tweet |
+| [Twitter Get Retweeters](twitter/retweet.md#twitter-get-retweeters) | This block gets information about who has retweeted a tweet |
+| [Twitter Get Space Buyers](twitter/spaces_lookup.md#twitter-get-space-buyers) | This block retrieves a list of users who purchased tickets to a Twitter Space |
+| [Twitter Get Space By Id](twitter/spaces_lookup.md#twitter-get-space-by-id) | This block retrieves information about a single Twitter Space |
+| [Twitter Get Space Tweets](twitter/spaces_lookup.md#twitter-get-space-tweets) | This block retrieves tweets shared in a Twitter Space |
+| [Twitter Get Spaces](twitter/spaces_lookup.md#twitter-get-spaces) | This block retrieves information about multiple Twitter Spaces |
+| [Twitter Get Tweet](twitter/tweet_lookup.md#twitter-get-tweet) | This block retrieves information about a specific Tweet |
+| [Twitter Get Tweets](twitter/tweet_lookup.md#twitter-get-tweets) | This block retrieves information about multiple Tweets |
+| [Twitter Get User](twitter/user_lookup.md#twitter-get-user) | This block retrieves information about a specified Twitter user |
+| [Twitter Get User Mentions](twitter/timeline.md#twitter-get-user-mentions) | This block retrieves Tweets mentioning a specific user |
+| [Twitter Get User Tweets](twitter/timeline.md#twitter-get-user-tweets) | This block retrieves Tweets composed by a single user |
+| [Twitter Get Users](twitter/user_lookup.md#twitter-get-users) | This block retrieves information about multiple Twitter users |
+| [Twitter Hide Reply](twitter/hide.md#twitter-hide-reply) | This block hides a reply to a tweet |
+| [Twitter Like Tweet](twitter/like.md#twitter-like-tweet) | This block likes a tweet |
+| [Twitter Mute User](twitter/mutes.md#twitter-mute-user) | This block mutes a specified Twitter user |
+| [Twitter Pin List](twitter/pinned_lists.md#twitter-pin-list) | This block allows the authenticated user to pin a specified List |
+| [Twitter Post Tweet](twitter/manage.md#twitter-post-tweet) | This block posts a tweet on Twitter |
+| [Twitter Remove Bookmark Tweet](twitter/bookmark.md#twitter-remove-bookmark-tweet) | This block removes a bookmark from a tweet on Twitter |
+| [Twitter Remove List Member](twitter/list_members.md#twitter-remove-list-member) | This block removes a specified user from a Twitter List owned by the authenticated user |
+| [Twitter Remove Retweet](twitter/retweet.md#twitter-remove-retweet) | This block removes a retweet on Twitter |
+| [Twitter Retweet](twitter/retweet.md#twitter-retweet) | This block retweets a tweet on Twitter |
+| [Twitter Search Recent Tweets](twitter/manage.md#twitter-search-recent-tweets) | This block searches all public Tweets in Twitter history |
+| [Twitter Search Spaces](twitter/search_spaces.md#twitter-search-spaces) | This block searches for Twitter Spaces based on specified terms |
+| [Twitter Unfollow List](twitter/list_follows.md#twitter-unfollow-list) | This block unfollows a specified Twitter list for the authenticated user |
+| [Twitter Unfollow User](twitter/follows.md#twitter-unfollow-user) | This block unfollows a specified Twitter user |
+| [Twitter Unhide Reply](twitter/hide.md#twitter-unhide-reply) | This block unhides a reply to a tweet |
+| [Twitter Unlike Tweet](twitter/like.md#twitter-unlike-tweet) | This block unlikes a tweet |
+| [Twitter Unmute User](twitter/mutes.md#twitter-unmute-user) | This block unmutes a specified Twitter user |
+| [Twitter Unpin List](twitter/pinned_lists.md#twitter-unpin-list) | This block allows the authenticated user to unpin a specified List |
+| [Twitter Update List](twitter/manage_lists.md#twitter-update-list) | This block updates a specified Twitter List owned by the authenticated user |
+
+## Communication
+
+| Block Name | Description |
+|------------|-------------|
+| [Baas Bot Join Meeting](baas/bots.md#baas-bot-join-meeting) | Deploy a bot to join and record a meeting |
+| [Baas Bot Leave Meeting](baas/bots.md#baas-bot-leave-meeting) | Remove a bot from an ongoing meeting |
+| [Gmail Add Label](google/gmail.md#gmail-add-label) | A block that adds a label to a specific email message in Gmail, creating the label if it doesn't exist |
+| [Gmail Create Draft](google/gmail.md#gmail-create-draft) | Create draft emails in Gmail with automatic HTML detection and proper text formatting |
+| [Gmail Draft Reply](google/gmail.md#gmail-draft-reply) | Create draft replies to Gmail threads with automatic HTML detection and proper text formatting |
+| [Gmail Forward](google/gmail.md#gmail-forward) | Forward Gmail messages to other recipients with automatic HTML detection and proper formatting |
+| [Gmail Get Profile](google/gmail.md#gmail-get-profile) | Get the authenticated user's Gmail profile details including email address and message statistics |
+| [Gmail Get Thread](google/gmail.md#gmail-get-thread) | A block that retrieves an entire Gmail thread (email conversation) by ID, returning all messages with decoded bodies for reading complete conversations |
+| [Gmail List Labels](google/gmail.md#gmail-list-labels) | A block that retrieves all labels (categories) from a Gmail account for organizing and categorizing emails |
+| [Gmail Read](google/gmail.md#gmail-read) | A block that retrieves and reads emails from a Gmail account based on search criteria, returning detailed message information including subject, sender, body, and attachments |
+| [Gmail Remove Label](google/gmail.md#gmail-remove-label) | A block that removes a label from a specific email message in a Gmail account |
+| [Gmail Reply](google/gmail.md#gmail-reply) | Reply to Gmail threads with automatic HTML detection and proper text formatting |
+| [Gmail Send](google/gmail.md#gmail-send) | Send emails via Gmail with automatic HTML detection and proper text formatting |
+| [Hub Spot Engagement](hubspot/engagement.md#hub-spot-engagement) | Manages HubSpot engagements - sends emails and tracks engagement metrics |
+
+## Developer Tools
+
+| Block Name | Description |
+|------------|-------------|
+| [Exa Code Context](exa/code_context.md#exa-code-context) | Search billions of GitHub repos, docs, and Stack Overflow for relevant code examples |
+| [Execute Code](misc.md#execute-code) | Executes code in a sandbox environment with internet access |
+| [Execute Code Step](misc.md#execute-code-step) | Execute code in a previously instantiated sandbox |
+| [Github Add Label](github/issues.md#github-add-label) | A block that adds a label to a GitHub issue or pull request for categorization and organization |
+| [Github Assign Issue](github/issues.md#github-assign-issue) | A block that assigns a GitHub user to an issue for task ownership and tracking |
+| [Github Assign PR Reviewer](github/pull_requests.md#github-assign-pr-reviewer) | This block assigns a reviewer to a specified GitHub pull request |
+| [Github Comment](github/issues.md#github-comment) | A block that posts comments on GitHub issues or pull requests using the GitHub API |
+| [Github Create Check Run](github/checks.md#github-create-check-run) | Creates a new check run for a specific commit in a GitHub repository |
+| [Github Create Comment Object](github/reviews.md#github-create-comment-object) | Creates a comment object for use with GitHub blocks |
+| [Github Create File](github/repo.md#github-create-file) | This block creates a new file in a GitHub repository |
+| [Github Create PR Review](github/reviews.md#github-create-pr-review) | This block creates a review on a GitHub pull request with optional inline comments |
+| [Github Create Repository](github/repo.md#github-create-repository) | This block creates a new GitHub repository |
+| [Github Create Status](github/statuses.md#github-create-status) | Creates a new commit status in a GitHub repository |
+| [Github Delete Branch](github/repo.md#github-delete-branch) | This block deletes a specified branch |
+| [Github Discussion Trigger](github/triggers.md#github-discussion-trigger) | This block triggers on GitHub Discussions events |
+| [Github Get CI Results](github/ci.md#github-get-ci-results) | This block gets CI results for a commit or PR, with optional search for specific errors/warnings in logs |
+| [Github Get PR Review Comments](github/reviews.md#github-get-pr-review-comments) | This block gets all review comments from a GitHub pull request or from a specific review |
+| [Github Issues Trigger](github/triggers.md#github-issues-trigger) | This block triggers on GitHub issues events |
+| [Github List Branches](github/repo.md#github-list-branches) | This block lists all branches for a specified GitHub repository |
+| [Github List Comments](github/issues.md#github-list-comments) | A block that retrieves all comments from a GitHub issue or pull request, including comment metadata and content |
+| [Github List Discussions](github/repo.md#github-list-discussions) | This block lists recent discussions for a specified GitHub repository |
+| [Github List Issues](github/issues.md#github-list-issues) | A block that retrieves a list of issues from a GitHub repository with their titles and URLs |
+| [Github List PR Reviewers](github/pull_requests.md#github-list-pr-reviewers) | This block lists all reviewers for a specified GitHub pull request |
+| [Github List PR Reviews](github/reviews.md#github-list-pr-reviews) | This block lists all reviews for a specified GitHub pull request |
+| [Github List Pull Requests](github/pull_requests.md#github-list-pull-requests) | This block lists all pull requests for a specified GitHub repository |
+| [Github List Releases](github/repo.md#github-list-releases) | This block lists all releases for a specified GitHub repository |
+| [Github List Stargazers](github/repo.md#github-list-stargazers) | This block lists all users who have starred a specified GitHub repository |
+| [Github List Tags](github/repo.md#github-list-tags) | This block lists all tags for a specified GitHub repository |
+| [Github Make Branch](github/repo.md#github-make-branch) | This block creates a new branch from a specified source branch |
+| [Github Make Issue](github/issues.md#github-make-issue) | A block that creates new issues on GitHub repositories with a title and body content |
+| [Github Make Pull Request](github/pull_requests.md#github-make-pull-request) | This block creates a new pull request on a specified GitHub repository |
+| [Github Pull Request Trigger](github/triggers.md#github-pull-request-trigger) | This block triggers on pull request events and outputs the event type and payload |
+| [Github Read File](github/repo.md#github-read-file) | This block reads the content of a specified file from a GitHub repository |
+| [Github Read Folder](github/repo.md#github-read-folder) | This block reads the content of a specified folder from a GitHub repository |
+| [Github Read Issue](github/issues.md#github-read-issue) | A block that retrieves information about a specific GitHub issue, including its title, body content, and creator |
+| [Github Read Pull Request](github/pull_requests.md#github-read-pull-request) | This block reads the body, title, user, and changes of a specified GitHub pull request |
+| [Github Release Trigger](github/triggers.md#github-release-trigger) | This block triggers on GitHub release events |
+| [Github Remove Label](github/issues.md#github-remove-label) | A block that removes a label from a GitHub issue or pull request |
+| [Github Resolve Review Discussion](github/reviews.md#github-resolve-review-discussion) | This block resolves or unresolves a review discussion thread on a GitHub pull request |
+| [Github Star Trigger](github/triggers.md#github-star-trigger) | This block triggers on GitHub star events |
+| [Github Submit Pending Review](github/reviews.md#github-submit-pending-review) | This block submits a pending (draft) review on a GitHub pull request |
+| [Github Unassign Issue](github/issues.md#github-unassign-issue) | A block that removes a user's assignment from a GitHub issue |
+| [Github Unassign PR Reviewer](github/pull_requests.md#github-unassign-pr-reviewer) | This block unassigns a reviewer from a specified GitHub pull request |
+| [Github Update Check Run](github/checks.md#github-update-check-run) | Updates an existing check run in a GitHub repository |
+| [Github Update Comment](github/issues.md#github-update-comment) | A block that updates an existing comment on a GitHub issue or pull request |
+| [Github Update File](github/repo.md#github-update-file) | This block updates an existing file in a GitHub repository |
+| [Instantiate Code Sandbox](misc.md#instantiate-code-sandbox) | Instantiate a sandbox environment with internet access in which you can execute code with the Execute Code Step block |
+| [Slant3D Order Webhook](slant3d/webhook.md#slant3d-order-webhook) | This block triggers on Slant3D order status updates and outputs the event details, including tracking information when orders are shipped |
+
+## Media Generation
+
+| Block Name | Description |
+|------------|-------------|
+| [Add Audio To Video](multimedia.md#add-audio-to-video) | Block to attach an audio file to a video file using moviepy |
+| [Loop Video](multimedia.md#loop-video) | Block to loop a video to a given duration or number of repeats |
+| [Media Duration](multimedia.md#media-duration) | Block to get the duration of a media file |
+
+## Productivity
+
+| Block Name | Description |
+|------------|-------------|
+| [Google Calendar Create Event](google/calendar.md#google-calendar-create-event) | This block creates a new event in Google Calendar with customizable parameters |
+| [Notion Create Page](notion/create_page.md#notion-create-page) | Create a new page in Notion |
+| [Notion Read Database](notion/read_database.md#notion-read-database) | Query a Notion database with optional filtering and sorting, returning structured entries |
+| [Notion Read Page](notion/read_page.md#notion-read-page) | Read a Notion page by its ID and return its raw JSON |
+| [Notion Read Page Markdown](notion/read_page_markdown.md#notion-read-page-markdown) | Read a Notion page and convert it to Markdown format with proper formatting for headings, lists, links, and rich text |
+| [Notion Search](notion/search.md#notion-search) | Search your Notion workspace for pages and databases by text query |
+| [Todoist Close Task](todoist/tasks.md#todoist-close-task) | Closes a task in Todoist |
+| [Todoist Create Comment](todoist/comments.md#todoist-create-comment) | Creates a new comment on a Todoist task or project |
+| [Todoist Create Label](todoist/labels.md#todoist-create-label) | Creates a new label in Todoist, It will not work if same name already exists |
+| [Todoist Create Project](todoist/projects.md#todoist-create-project) | Creates a new project in Todoist |
+| [Todoist Create Task](todoist/tasks.md#todoist-create-task) | Creates a new task in a Todoist project |
+| [Todoist Delete Comment](todoist/comments.md#todoist-delete-comment) | Deletes a Todoist comment |
+| [Todoist Delete Label](todoist/labels.md#todoist-delete-label) | Deletes a personal label in Todoist |
+| [Todoist Delete Project](todoist/projects.md#todoist-delete-project) | Deletes a Todoist project and all its contents |
+| [Todoist Delete Section](todoist/sections.md#todoist-delete-section) | Deletes a section and all its tasks from Todoist |
+| [Todoist Delete Task](todoist/tasks.md#todoist-delete-task) | Deletes a task in Todoist |
+| [Todoist Get Comment](todoist/comments.md#todoist-get-comment) | Get a single comment from Todoist |
+| [Todoist Get Comments](todoist/comments.md#todoist-get-comments) | Get all comments for a Todoist task or project |
+| [Todoist Get Label](todoist/labels.md#todoist-get-label) | Gets a personal label from Todoist by ID |
+| [Todoist Get Project](todoist/projects.md#todoist-get-project) | Gets details for a specific Todoist project |
+| [Todoist Get Section](todoist/sections.md#todoist-get-section) | Gets a single section by ID from Todoist |
+| [Todoist Get Shared Labels](todoist/labels.md#todoist-get-shared-labels) | Gets all shared labels from Todoist |
+| [Todoist Get Task](todoist/tasks.md#todoist-get-task) | Get an active task from Todoist |
+| [Todoist Get Tasks](todoist/tasks.md#todoist-get-tasks) | Get active tasks from Todoist |
+| [Todoist List Collaborators](todoist/projects.md#todoist-list-collaborators) | Gets all collaborators for a specific Todoist project |
+| [Todoist List Labels](todoist/labels.md#todoist-list-labels) | Gets all personal labels from Todoist |
+| [Todoist List Projects](todoist/projects.md#todoist-list-projects) | Gets all projects and their details from Todoist |
+| [Todoist List Sections](todoist/sections.md#todoist-list-sections) | Gets all sections and their details from Todoist |
+| [Todoist Remove Shared Labels](todoist/labels.md#todoist-remove-shared-labels) | Removes all instances of a shared label |
+| [Todoist Rename Shared Labels](todoist/labels.md#todoist-rename-shared-labels) | Renames all instances of a shared label |
+| [Todoist Reopen Task](todoist/tasks.md#todoist-reopen-task) | Reopens a task in Todoist |
+| [Todoist Update Comment](todoist/comments.md#todoist-update-comment) | Updates a Todoist comment |
+| [Todoist Update Label](todoist/labels.md#todoist-update-label) | Updates a personal label in Todoist |
+| [Todoist Update Project](todoist/projects.md#todoist-update-project) | Updates an existing project in Todoist |
+| [Todoist Update Task](todoist/tasks.md#todoist-update-task) | Updates an existing task in Todoist |
+
+## Logic and Control Flow
+
+| Block Name | Description |
+|------------|-------------|
+| [Calculator](logic.md#calculator) | Performs a mathematical operation on two numbers |
+| [Condition](logic.md#condition) | Handles conditional logic based on comparison operators |
+| [Count Items](logic.md#count-items) | Counts the number of items in a collection |
+| [Data Sampling](logic.md#data-sampling) | This block samples data from a given dataset using various sampling methods |
+| [Exa Webset Ready Check](exa/websets.md#exa-webset-ready-check) | Check if webset is ready for next operation - enables conditional workflow branching |
+| [If Input Matches](logic.md#if-input-matches) | Handles conditional logic based on comparison operators |
+| [Pinecone Init](logic.md#pinecone-init) | Initializes a Pinecone index |
+| [Pinecone Insert](logic.md#pinecone-insert) | Upload data to a Pinecone index |
+| [Pinecone Query](logic.md#pinecone-query) | Queries a Pinecone index |
+| [Step Through Items](logic.md#step-through-items) | Iterates over a list or dictionary and outputs each item |
+
+## Input/Output
+
+| Block Name | Description |
+|------------|-------------|
+| [Exa Webset Webhook](exa/webhook_blocks.md#exa-webset-webhook) | Receive webhook notifications for Exa webset events |
+| [Generic Webhook Trigger](generic_webhook/triggers.md#generic-webhook-trigger) | This block will output the contents of the generic input for the webhook |
+| [Read RSS Feed](misc.md#read-rss-feed) | Reads RSS feed entries from a given URL |
+| [Send Authenticated Web Request](misc.md#send-authenticated-web-request) | Make an authenticated HTTP request with host-scoped credentials (JSON / form / multipart) |
+| [Send Email](misc.md#send-email) | This block sends an email using the provided SMTP credentials |
+| [Send Web Request](misc.md#send-web-request) | Make an HTTP request (JSON / form / multipart) |
+
+## Agent Integration
+
+| Block Name | Description |
+|------------|-------------|
+| [Agent Executor](misc.md#agent-executor) | Executes an existing agent inside your agent |
+
+## CRM Services
+
+| Block Name | Description |
+|------------|-------------|
+| [Add Lead To Campaign](smartlead/campaign.md#add-lead-to-campaign) | Add a lead to a campaign in SmartLead |
+| [Create Campaign](smartlead/campaign.md#create-campaign) | Create a campaign in SmartLead |
+| [Hub Spot Company](hubspot/company.md#hub-spot-company) | Manages HubSpot companies - create, update, and retrieve company information |
+| [Hub Spot Contact](hubspot/contact.md#hub-spot-contact) | Manages HubSpot contacts - create, update, and retrieve contact information |
+| [Save Campaign Sequences](smartlead/campaign.md#save-campaign-sequences) | Save sequences within a campaign |
+
+## AI Safety
+
+| Block Name | Description |
+|------------|-------------|
+| [Nvidia Deepfake Detect](nvidia/deepfake.md#nvidia-deepfake-detect) | Detects potential deepfakes in images using Nvidia's AI API |
+
+## Issue Tracking
+
+| Block Name | Description |
+|------------|-------------|
+| [Linear Create Comment](linear/comment.md#linear-create-comment) | Creates a new comment on a Linear issue |
+| [Linear Create Issue](linear/issues.md#linear-create-issue) | Creates a new issue on Linear |
+| [Linear Get Project Issues](linear/issues.md#linear-get-project-issues) | Gets issues from a Linear project filtered by status and assignee |
+| [Linear Search Projects](linear/projects.md#linear-search-projects) | Searches for projects on Linear |
+
+## Hardware
+
+| Block Name | Description |
+|------------|-------------|
+| [Compass AI Trigger](compass/triggers.md#compass-ai-trigger) | This block will output the contents of the compass transcription |
diff --git a/docs/content/platform/blocks/ai_condition.md b/docs/integrations/ai_condition.md
similarity index 100%
rename from docs/content/platform/blocks/ai_condition.md
rename to docs/integrations/ai_condition.md
diff --git a/docs/content/platform/blocks/ai_shortform_video_block.md b/docs/integrations/ai_shortform_video_block.md
similarity index 100%
rename from docs/content/platform/blocks/ai_shortform_video_block.md
rename to docs/integrations/ai_shortform_video_block.md
diff --git a/docs/integrations/airtable/bases.md b/docs/integrations/airtable/bases.md
new file mode 100644
index 0000000000..fac928f0ae
--- /dev/null
+++ b/docs/integrations/airtable/bases.md
@@ -0,0 +1,84 @@
+# Airtable Bases
+<!-- MANUAL: file_description -->
+Blocks for creating and managing Airtable bases, which are the top-level containers for tables, records, and data in Airtable.
+<!-- END MANUAL -->
+
+## Airtable Create Base
+
+### What it is
+Create or find a base in Airtable
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a new Airtable base in a specified workspace, or finds an existing one with the same name. When creating, you can optionally define initial tables and their fields to set up the schema.
+
+Enable find_existing to search for a base with the same name before creating a new one, preventing duplicates in your workspace.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| workspace_id | The workspace ID where the base will be created | str | Yes |
+| name | The name of the new base | str | Yes |
+| find_existing | If true, return existing base with same name instead of creating duplicate | bool | No |
+| tables | At least one table and field must be specified. Array of table objects to create in the base. Each table should have 'name' and 'fields' properties | List[Dict[str, Any]] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| base_id | The ID of the created or found base | str |
+| tables | Array of table objects | List[Dict[str, Any]] |
+| table | A single table object | Dict[str, Any] |
+| was_created | True if a new base was created, False if existing was found | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Project Setup**: Automatically create new bases when projects start with predefined table structures.
+
+**Template Deployment**: Deploy standardized base templates across teams or clients.
+
+**Multi-Tenant Apps**: Create separate bases for each customer or project programmatically.
+<!-- END MANUAL -->
+
+---
+
+## Airtable List Bases
+
+### What it is
+List all bases in Airtable
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves a list of all Airtable bases accessible to your connected account. It returns basic information about each base including ID, name, and permission level.
+
+Results are paginated; use the offset output to retrieve additional pages if there are more bases than returned in a single call.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| trigger | Trigger the block to run - value is ignored | str | No |
+| offset | Pagination offset from previous request | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| bases | Array of base objects | List[Dict[str, Any]] |
+| offset | Offset for next page (null if no more bases) | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Base Discovery**: Find available bases for building dynamic dropdowns or navigation.
+
+**Inventory Management**: List all bases in an organization for auditing or documentation.
+
+**Cross-Base Operations**: Enumerate bases to perform operations across multiple databases.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/airtable/records.md b/docs/integrations/airtable/records.md
new file mode 100644
index 0000000000..28d2dad1ce
--- /dev/null
+++ b/docs/integrations/airtable/records.md
@@ -0,0 +1,214 @@
+# Airtable Records
+<!-- MANUAL: file_description -->
+Blocks for creating, reading, updating, and deleting records in Airtable tables.
+<!-- END MANUAL -->
+
+## Airtable Create Records
+
+### What it is
+Create records in an Airtable table
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates new records in an Airtable table using the Airtable API. Each record is specified with a fields object containing field names and values. You can create up to 10 records in a single call.
+
+Enable typecast to automatically convert string values to appropriate field types (dates, numbers, etc.). The block returns the created records with their assigned IDs.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| base_id | The Airtable base ID | str | Yes |
+| table_id_or_name | Table ID or name | str | Yes |
+| records | Array of records to create (each with 'fields' object) | List[Dict[str, Any]] | Yes |
+| skip_normalization | Skip output normalization to get raw Airtable response (faster but may have missing fields) | bool | No |
+| typecast | Automatically convert string values to appropriate types | bool | No |
+| return_fields_by_field_id | Return fields by field ID | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| records | Array of created record objects | List[Dict[str, Any]] |
+| details | Details of the created records | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Data Import**: Bulk import data from external sources into Airtable tables.
+
+**Form Submissions**: Create records from form submissions or API integrations.
+
+**Workflow Output**: Save workflow results or processed data to Airtable for tracking.
+<!-- END MANUAL -->
+
+---
+
+## Airtable Delete Records
+
+### What it is
+Delete records from an Airtable table
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block deletes records from an Airtable table by their record IDs. You can delete up to 10 records in a single call. The operation is permanent and cannot be undone.
+
+Provide an array of record IDs to delete. Using the table ID instead of the name is recommended for reliability.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| base_id | The Airtable base ID | str | Yes |
+| table_id_or_name | Table ID or name - It's better to use the table ID instead of the name | str | Yes |
+| record_ids | Array of upto 10 record IDs to delete | List[str] | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| records | Array of deletion results | List[Dict[str, Any]] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Data Cleanup**: Remove outdated or duplicate records from tables.
+
+**Workflow Cleanup**: Delete temporary records after processing is complete.
+
+**Batch Removal**: Remove multiple records that match certain criteria.
+<!-- END MANUAL -->
+
+---
+
+## Airtable Get Record
+
+### What it is
+Get a single record from Airtable
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves a single record from an Airtable table by its ID. The record includes all field values and metadata like creation time. Enable normalize_output to ensure all fields are included with proper empty values.
+
+Optionally include field metadata for type information and configuration details about each field.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| base_id | The Airtable base ID | str | Yes |
+| table_id_or_name | Table ID or name | str | Yes |
+| record_id | The record ID to retrieve | str | Yes |
+| normalize_output | Normalize output to include all fields with proper empty values (disable to skip schema fetch and get raw Airtable response) | bool | No |
+| include_field_metadata | Include field type and configuration metadata (requires normalize_output=true) | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| id | The record ID | str |
+| fields | The record fields | Dict[str, Any] |
+| created_time | The record created time | str |
+| field_metadata | Field type and configuration metadata (only when include_field_metadata=true) | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Detail View**: Fetch complete record data for display or detailed processing.
+
+**Record Lookup**: Retrieve specific records by ID from webhook payloads or references.
+
+**Data Validation**: Check record contents before performing updates or related operations.
+<!-- END MANUAL -->
+
+---
+
+## Airtable List Records
+
+### What it is
+List records from an Airtable table
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries records from an Airtable table with optional filtering, sorting, and pagination. Use Airtable formulas to filter records and specify sort order by field and direction.
+
+Results can be limited, paginated with offsets, and restricted to specific fields. Enable normalize_output for consistent field values across records.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| base_id | The Airtable base ID | str | Yes |
+| table_id_or_name | Table ID or name | str | Yes |
+| filter_formula | Airtable formula to filter records | str | No |
+| view | View ID or name to use | str | No |
+| sort | Sort configuration (array of {field, direction}) | List[Dict[str, Any]] | No |
+| max_records | Maximum number of records to return | int | No |
+| page_size | Number of records per page (max 100) | int | No |
+| offset | Pagination offset from previous request | str | No |
+| return_fields | Specific fields to return (comma-separated) | List[str] | No |
+| normalize_output | Normalize output to include all fields with proper empty values (disable to skip schema fetch and get raw Airtable response) | bool | No |
+| include_field_metadata | Include field type and configuration metadata (requires normalize_output=true) | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| records | Array of record objects | List[Dict[str, Any]] |
+| offset | Offset for next page (null if no more records) | str |
+| field_metadata | Field type and configuration metadata (only when include_field_metadata=true) | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Report Generation**: Query records with filters to build reports or dashboards.
+
+**Data Export**: Fetch records matching criteria for export to other systems.
+
+**Batch Processing**: List records to process in subsequent workflow steps.
+<!-- END MANUAL -->
+
+---
+
+## Airtable Update Records
+
+### What it is
+Update records in an Airtable table
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block updates existing records in an Airtable table. Each record update requires the record ID and a fields object with the values to update. Only specified fields are modified; other fields remain unchanged.
+
+Enable typecast to automatically convert string values to appropriate types. You can update up to 10 records per call.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| base_id | The Airtable base ID | str | Yes |
+| table_id_or_name | Table ID or name - It's better to use the table ID instead of the name | str | Yes |
+| records | Array of records to update (each with 'id' and 'fields') | List[Dict[str, Any]] | Yes |
+| typecast | Automatically convert string values to appropriate types | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| records | Array of updated record objects | List[Dict[str, Any]] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Status Updates**: Update record status fields as workflows progress.
+
+**Data Enrichment**: Add computed or fetched data to existing records.
+
+**Batch Modifications**: Update multiple records based on processed results.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/airtable/schema.md b/docs/integrations/airtable/schema.md
new file mode 100644
index 0000000000..286a25ddb1
--- /dev/null
+++ b/docs/integrations/airtable/schema.md
@@ -0,0 +1,202 @@
+# Airtable Schema
+<!-- MANUAL: file_description -->
+Blocks for managing Airtable schema including tables, fields, and their configurations.
+<!-- END MANUAL -->
+
+## Airtable Create Field
+
+### What it is
+Add a new field to an Airtable table
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block adds a new field to an existing Airtable table using the Airtable API. Specify the field type (text, email, URL, etc.), name, and optional description and configuration options.
+
+The field is created immediately and becomes available for use in all records. Returns the created field object with its assigned ID.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| base_id | The Airtable base ID | str | Yes |
+| table_id | The table ID to add field to | str | Yes |
+| field_type | The type of the field to create | "singleLineText" \| "email" \| "url" \| "multilineText" \| "number" \| "percent" \| "currency" \| "singleSelect" \| "multipleSelects" \| "singleCollaborator" \| "multipleCollaborators" \| "multipleRecordLinks" \| "date" \| "dateTime" \| "phoneNumber" \| "multipleAttachments" \| "checkbox" \| "formula" \| "createdTime" \| "rollup" \| "count" \| "lookup" \| "multipleLookupValues" \| "autoNumber" \| "barcode" \| "rating" \| "richText" \| "duration" \| "lastModifiedTime" \| "button" \| "createdBy" \| "lastModifiedBy" \| "externalSyncSource" \| "aiText" | No |
+| name | The name of the field to create | str | Yes |
+| description | The description of the field to create | str | No |
+| options | The options of the field to create | Dict[str, str] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| field | Created field object | Dict[str, Any] |
+| field_id | ID of the created field | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Schema Evolution**: Add new fields to tables as application requirements grow.
+
+**Dynamic Forms**: Create fields based on user configuration or form builder settings.
+
+**Data Integration**: Add fields to capture data from newly integrated external systems.
+<!-- END MANUAL -->
+
+---
+
+## Airtable Create Table
+
+### What it is
+Create a new table in an Airtable base
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a new table in an Airtable base with the specified name and optional field definitions. Each field definition includes name, type, and type-specific options.
+
+The table is created with the defined schema and is immediately ready for use. Returns the created table object with its ID.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| base_id | The Airtable base ID | str | Yes |
+| table_name | The name of the table to create | str | Yes |
+| table_fields | Table fields with name, type, and options | List[Dict[str, Any]] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| table | Created table object | Dict[str, Any] |
+| table_id | ID of the created table | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Application Scaffolding**: Create tables programmatically when setting up new application modules.
+
+**Multi-Tenant Setup**: Generate customer-specific tables dynamically.
+
+**Feature Expansion**: Add new tables as features are enabled or installed.
+<!-- END MANUAL -->
+
+---
+
+## Airtable List Schema
+
+### What it is
+Get the complete schema of an Airtable base
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves the complete schema of an Airtable base, including all tables, their fields, field types, and views. This metadata is essential for building dynamic integrations that need to understand table structure.
+
+The schema includes field configurations, validation rules, and relationship definitions between tables.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| base_id | The Airtable base ID | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| base_schema | Complete base schema with tables, fields, and views | Dict[str, Any] |
+| tables | Array of table objects | List[Dict[str, Any]] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Schema Discovery**: Understand table structure for building dynamic forms or queries.
+
+**Documentation**: Generate documentation of database schema automatically.
+
+**Migration Planning**: Analyze schema before migrating data to other systems.
+<!-- END MANUAL -->
+
+---
+
+## Airtable Update Field
+
+### What it is
+Update field properties in an Airtable table
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block updates properties of an existing field in an Airtable table. You can modify the field name and description. Note that field type cannot be changed after creation.
+
+Changes take effect immediately across all records and views that use the field.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| base_id | The Airtable base ID | str | Yes |
+| table_id | The table ID containing the field | str | Yes |
+| field_id | The field ID to update | str | Yes |
+| name | The name of the field to update | str | No |
+| description | The description of the field to update | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| field | Updated field object | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Field Renaming**: Update field names to match evolving terminology or standards.
+
+**Documentation Updates**: Add or update field descriptions for better team understanding.
+
+**Schema Maintenance**: Keep field metadata current as application requirements change.
+<!-- END MANUAL -->
+
+---
+
+## Airtable Update Table
+
+### What it is
+Update table properties
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block updates table properties in an Airtable base. You can change the table name, description, and date dependency settings. Changes apply immediately and affect all users accessing the table.
+
+This is useful for maintaining table metadata and organizing your base structure.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| base_id | The Airtable base ID | str | Yes |
+| table_id | The table ID to update | str | Yes |
+| table_name | The name of the table to update | str | No |
+| table_description | The description of the table to update | str | No |
+| date_dependency | The date dependency of the table to update | Dict[str, Any] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| table | Updated table object | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Table Organization**: Rename tables to follow naming conventions or reflect current usage.
+
+**Description Management**: Update table descriptions for documentation purposes.
+
+**Configuration Updates**: Modify table settings like date dependencies as requirements change.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/airtable/triggers.md b/docs/integrations/airtable/triggers.md
new file mode 100644
index 0000000000..0eea41ade6
--- /dev/null
+++ b/docs/integrations/airtable/triggers.md
@@ -0,0 +1,42 @@
+# Airtable Triggers
+<!-- MANUAL: file_description -->
+Blocks for triggering workflows based on Airtable events like record creation, updates, and deletions.
+<!-- END MANUAL -->
+
+## Airtable Webhook Trigger
+
+### What it is
+Starts a flow whenever Airtable emits a webhook event
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block subscribes to Airtable webhook events for a specific base and table. When records are created, updated, or deleted, Airtable sends a webhook notification that triggers your workflow.
+
+You specify which events to listen for using the event selector. The webhook payload includes details about the changed records and the type of change that occurred.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| base_id | Airtable base ID | str | Yes |
+| table_id_or_name | Airtable table ID or name | str | Yes |
+| events | Airtable webhook event filter | AirtableEventSelector | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| payload | Airtable webhook payload | WebhookPayload |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Real-Time Sync**: Automatically sync Airtable changes to other systems like CRMs or databases.
+
+**Notification Workflows**: Send alerts when specific records are created or modified in Airtable.
+
+**Automated Processing**: Trigger document generation or emails when new entries are added to a table.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/apollo/organization.md b/docs/integrations/apollo/organization.md
new file mode 100644
index 0000000000..ca245ffb15
--- /dev/null
+++ b/docs/integrations/apollo/organization.md
@@ -0,0 +1,47 @@
+# Apollo Organization
+<!-- MANUAL: file_description -->
+Blocks for searching and retrieving organization data from Apollo's B2B database.
+<!-- END MANUAL -->
+
+## Search Organizations
+
+### What it is
+Search for organizations in Apollo
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block searches the Apollo database for organizations using various filters like employee count, location, and keywords. Apollo maintains a comprehensive database of company information for sales and marketing purposes.
+
+Results can be filtered by headquarters location, excluded locations, industry keywords, and specific Apollo organization IDs.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| organization_num_employees_range | The number range of employees working for the company. This enables you to find companies based on headcount. You can add multiple ranges to expand your search results.  Each range you add needs to be a string, with the upper and lower numbers of the range separated only by a comma. | List[int] | No |
+| organization_locations | The location of the company headquarters. You can search across cities, US states, and countries.  If a company has several office locations, results are still based on the headquarters location. For example, if you search chicago but a company's HQ location is in boston, any Boston-based companies will not appear in your search results, even if they match other parameters.  To exclude companies based on location, use the organization_not_locations parameter.  | List[str] | No |
+| organizations_not_locations | Exclude companies from search results based on the location of the company headquarters. You can use cities, US states, and countries as locations to exclude.  This parameter is useful for ensuring you do not prospect in an undesirable territory. For example, if you use ireland as a value, no Ireland-based companies will appear in your search results.  | List[str] | No |
+| q_organization_keyword_tags | Filter search results based on keywords associated with companies. For example, you can enter mining as a value to return only companies that have an association with the mining industry. | List[str] | No |
+| q_organization_name | Filter search results to include a specific company name.  If the value you enter for this parameter does not match with a company's name, the company will not appear in search results, even if it matches other parameters. Partial matches are accepted. For example, if you filter by the value marketing, a company called NY Marketing Unlimited would still be eligible as a search result, but NY Market Analysis would not be eligible. | str | No |
+| organization_ids | The Apollo IDs for the companies you want to include in your search results. Each company in the Apollo database is assigned a unique ID.  To find IDs, identify the values for organization_id when you call this endpoint. | List[str] | No |
+| max_results | The maximum number of results to return. If you don't specify this parameter, the default is 100. | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the search failed | str |
+| organizations | List of organizations found | List[Dict[str, Any]] |
+| organization | Each found organization, one at a time | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Market Research**: Find companies matching specific criteria for market analysis.
+
+**Lead List Building**: Build targeted lists of companies for outbound sales campaigns.
+
+**Competitive Intelligence**: Research competitors and similar companies in your market.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/apollo/people.md b/docs/integrations/apollo/people.md
new file mode 100644
index 0000000000..d451a67a49
--- /dev/null
+++ b/docs/integrations/apollo/people.md
@@ -0,0 +1,50 @@
+# Apollo People
+<!-- MANUAL: file_description -->
+Blocks for searching people in Apollo's B2B contact database with various filters.
+<!-- END MANUAL -->
+
+## Search People
+
+### What it is
+Search for people in Apollo
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block searches Apollo's database for people based on job titles, seniority, location, company, and other criteria. It's designed for finding prospects and contacts for sales and marketing.
+
+Enable enrich_info to get detailed contact information including verified email addresses (costs more credits).
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| person_titles | Job titles held by the people you want to find. For a person to be included in search results, they only need to match 1 of the job titles you add. Adding more job titles expands your search results.          Results also include job titles with the same terms, even if they are not exact matches. For example, searching for marketing manager might return people with the job title content marketing manager.          Use this parameter in combination with the person_seniorities[] parameter to find people based on specific job functions and seniority levels.          | List[str] | No |
+| person_locations | The location where people live. You can search across cities, US states, and countries.          To find people based on the headquarters locations of their current employer, use the organization_locations parameter. | List[str] | No |
+| person_seniorities | The job seniority that people hold within their current employer. This enables you to find people that currently hold positions at certain reporting levels, such as Director level or senior IC level.          For a person to be included in search results, they only need to match 1 of the seniorities you add. Adding more seniorities expands your search results.          Searches only return results based on their current job title, so searching for Director-level employees only returns people that currently hold a Director-level title. If someone was previously a Director, but is currently a VP, they would not be included in your search results.          Use this parameter in combination with the person_titles[] parameter to find people based on specific job functions and seniority levels. | List["owner" \| "founder" \| "c_suite" \| "partner" \| "vp" \| "head" \| "director" \| "manager" \| "senior" \| "entry" \| "intern"] | No |
+| organization_locations | The location of the company headquarters for a person's current employer. You can search across cities, US states, and countries.          If a company has several office locations, results are still based on the headquarters location. For example, if you search chicago but a company's HQ location is in boston, people that work for the Boston-based company will not appear in your results, even if they match other parameters.          To find people based on their personal location, use the person_locations parameter. | List[str] | No |
+| q_organization_domains | The domain name for the person's employer. This can be the current employer or a previous employer. Do not include www., the @ symbol, or similar.          You can add multiple domains to search across companies.            Examples: apollo.io and microsoft.com | List[str] | No |
+| contact_email_statuses | The email statuses for the people you want to find. You can add multiple statuses to expand your search. | List["verified" \| "unverified" \| "likely_to_engage" \| "unavailable"] | No |
+| organization_ids | The Apollo IDs for the companies (employers) you want to include in your search results. Each company in the Apollo database is assigned a unique ID.          To find IDs, call the Organization Search endpoint and identify the values for organization_id. | List[str] | No |
+| organization_num_employees_range | The number range of employees working for the company. This enables you to find companies based on headcount. You can add multiple ranges to expand your search results.          Each range you add needs to be a string, with the upper and lower numbers of the range separated only by a comma. | List[int] | No |
+| q_keywords | A string of words over which we want to filter the results | str | No |
+| max_results | The maximum number of results to return. If you don't specify this parameter, the default is 25. Limited to 500 to prevent overspending. | int | No |
+| enrich_info | Whether to enrich contacts with detailed information including real email addresses. This will double the search cost. | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the search failed | str |
+| people | List of people found | List[Dict[str, Any]] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Prospecting**: Find decision-makers at target companies for outbound sales.
+
+**Recruiting**: Search for candidates with specific titles and experience.
+
+**ABM Campaigns**: Build contact lists at specific accounts for account-based marketing.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/apollo/person.md b/docs/integrations/apollo/person.md
new file mode 100644
index 0000000000..8162b1fc91
--- /dev/null
+++ b/docs/integrations/apollo/person.md
@@ -0,0 +1,49 @@
+# Apollo Person
+<!-- MANUAL: file_description -->
+Blocks for enriching individual person data including contact details and email discovery.
+<!-- END MANUAL -->
+
+## Get Person Detail
+
+### What it is
+Get detailed person data with Apollo API, including email reveal
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block enriches person data using Apollo's API. You can look up by Apollo person ID for best accuracy, or match by name plus company information, LinkedIn URL, or email address.
+
+Returns comprehensive contact details including email addresses (if available), job title, company information, and social profiles.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| person_id | Apollo person ID to enrich (most accurate method) | str | No |
+| first_name | First name of the person to enrich | str | No |
+| last_name | Last name of the person to enrich | str | No |
+| name | Full name of the person to enrich (alternative to first_name + last_name) | str | No |
+| email | Known email address of the person (helps with matching) | str | No |
+| domain | Company domain of the person (e.g., 'google.com') | str | No |
+| company | Company name of the person | str | No |
+| linkedin_url | LinkedIn URL of the person | str | No |
+| organization_id | Apollo organization ID of the person's company | str | No |
+| title | Job title of the person to enrich | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if enrichment failed | str |
+| contact | Enriched contact information | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Contact Enrichment**: Get full contact details from partial information like name and company.
+
+**Email Discovery**: Find verified email addresses for outreach campaigns.
+
+**Profile Completion**: Fill in missing contact details in your CRM or database.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/ayrshare/post_to_bluesky.md b/docs/integrations/ayrshare/post_to_bluesky.md
new file mode 100644
index 0000000000..9931a2edb0
--- /dev/null
+++ b/docs/integrations/ayrshare/post_to_bluesky.md
@@ -0,0 +1,52 @@
+# Ayrshare Post To Bluesky
+<!-- MANUAL: file_description -->
+Blocks for posting content to Bluesky using the Ayrshare social media management API.
+<!-- END MANUAL -->
+
+## Post To Bluesky
+
+### What it is
+Post to Bluesky using Ayrshare
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Ayrshare's social media API to publish content to Bluesky. It handles text posts (up to 300 characters), images (up to 4), and video content with support for scheduling, accessibility features like alt text, and link shortening.
+
+The block authenticates through your Ayrshare credentials and sends the post data to Ayrshare's unified API, which then publishes to Bluesky. It returns post identifiers and status information upon completion, or error details if the operation fails.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| post | The post text to be published (max 300 characters for Bluesky) | str | No |
+| media_urls | Optional list of media URLs to include. Bluesky supports up to 4 images or 1 video. | List[str] | No |
+| is_video | Whether the media is a video | bool | No |
+| schedule_date | UTC datetime for scheduling (YYYY-MM-DDThh:mm:ssZ) | str (date-time) | No |
+| disable_comments | Whether to disable comments | bool | No |
+| shorten_links | Whether to shorten links | bool | No |
+| unsplash | Unsplash image configuration | str | No |
+| requires_approval | Whether to enable approval workflow | bool | No |
+| random_post | Whether to generate random post text | bool | No |
+| random_media_url | Whether to generate random media | bool | No |
+| notes | Additional notes for the post | str | No |
+| alt_text | Alt text for each media item (accessibility) | List[str] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| post_result | The result of the post | PostResponse |
+| post | The result of the post | PostIds |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Cross-Platform Publishing**: Automatically share content across Bluesky and other social networks from a single workflow.
+
+**Scheduled Content Calendar**: Queue up posts with specific publishing times to maintain consistent presence on Bluesky.
+
+**Visual Content Sharing**: Share image galleries with accessibility-friendly alt text for photo-focused content strategies.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/ayrshare/post_to_facebook.md b/docs/integrations/ayrshare/post_to_facebook.md
new file mode 100644
index 0000000000..ee41ded42c
--- /dev/null
+++ b/docs/integrations/ayrshare/post_to_facebook.md
@@ -0,0 +1,68 @@
+# Ayrshare Post To Facebook
+<!-- MANUAL: file_description -->
+Blocks for posting content to Facebook Pages using the Ayrshare social media management API.
+<!-- END MANUAL -->
+
+## Post To Facebook
+
+### What it is
+Post to Facebook using Ayrshare
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Ayrshare's social media API to publish content to Facebook Pages. It supports text posts, images, videos, carousels (2-10 items), Reels, and Stories, with features like audience targeting by age and country, location tagging, and scheduling.
+
+The block authenticates through Ayrshare and leverages the Meta Graph API to handle various Facebook-specific formats. Advanced options include draft mode for Meta Business Suite, custom link previews, and video thumbnails. Results include post IDs for tracking engagement.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| post | The post text to be published | str | No |
+| media_urls | Optional list of media URLs to include. Set is_video in advanced settings to true if you want to upload videos. | List[str] | No |
+| is_video | Whether the media is a video | bool | No |
+| schedule_date | UTC datetime for scheduling (YYYY-MM-DDThh:mm:ssZ) | str (date-time) | No |
+| disable_comments | Whether to disable comments | bool | No |
+| shorten_links | Whether to shorten links | bool | No |
+| unsplash | Unsplash image configuration | str | No |
+| requires_approval | Whether to enable approval workflow | bool | No |
+| random_post | Whether to generate random post text | bool | No |
+| random_media_url | Whether to generate random media | bool | No |
+| notes | Additional notes for the post | str | No |
+| is_carousel | Whether to post a carousel | bool | No |
+| carousel_link | The URL for the 'See More At' button in the carousel | str | No |
+| carousel_items | List of carousel items with name, link and picture URLs. Min 2, max 10 items. | List[CarouselItem] | No |
+| is_reels | Whether to post to Facebook Reels | bool | No |
+| reels_title | Title for the Reels video (max 255 chars) | str | No |
+| reels_thumbnail | Thumbnail URL for Reels video (JPEG/PNG, <10MB) | str | No |
+| is_story | Whether to post as a Facebook Story | bool | No |
+| media_captions | Captions for each media item | List[str] | No |
+| location_id | Facebook Page ID or name for location tagging | str | No |
+| age_min | Minimum age for audience targeting (13,15,18,21,25) | int | No |
+| target_countries | List of country codes to target (max 25) | List[str] | No |
+| alt_text | Alt text for each media item | List[str] | No |
+| video_title | Title for video post | str | No |
+| video_thumbnail | Thumbnail URL for video post | str | No |
+| is_draft | Save as draft in Meta Business Suite | bool | No |
+| scheduled_publish_date | Schedule publish time in Meta Business Suite (UTC) | str | No |
+| preview_link | URL for custom link preview | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| post_result | The result of the post | PostResponse |
+| post | The result of the post | PostIds |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Product Launches**: Create carousel posts showcasing multiple product images with links to purchase pages.
+
+**Event Promotion**: Share event details with age-targeted reach and location tagging for local business events.
+
+**Short-Form Video**: Automatically publish Reels with custom thumbnails to maximize video content reach.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/ayrshare/post_to_gmb.md b/docs/integrations/ayrshare/post_to_gmb.md
new file mode 100644
index 0000000000..4ada1bd966
--- /dev/null
+++ b/docs/integrations/ayrshare/post_to_gmb.md
@@ -0,0 +1,64 @@
+# Ayrshare Post To GMB
+<!-- MANUAL: file_description -->
+Blocks for posting content to Google My Business profiles using the Ayrshare social media management API.
+<!-- END MANUAL -->
+
+## Post To GMB
+
+### What it is
+Post to Google My Business using Ayrshare
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Ayrshare's API to publish content to Google My Business profiles. It supports standard posts, photo/video posts (categorized by type like exterior, interior, product), and special post types including events and promotional offers with coupon codes.
+
+The block integrates with Google's Business Profile API through Ayrshare, enabling call-to-action buttons (book, order, shop, learn more, sign up, call), event scheduling with start/end dates, and promotional offers with terms and redemption URLs.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| post | The post text to be published | str | No |
+| media_urls | Optional list of media URLs. GMB supports only one image or video per post. | List[str] | No |
+| is_video | Whether the media is a video | bool | No |
+| schedule_date | UTC datetime for scheduling (YYYY-MM-DDThh:mm:ssZ) | str (date-time) | No |
+| disable_comments | Whether to disable comments | bool | No |
+| shorten_links | Whether to shorten links | bool | No |
+| unsplash | Unsplash image configuration | str | No |
+| requires_approval | Whether to enable approval workflow | bool | No |
+| random_post | Whether to generate random post text | bool | No |
+| random_media_url | Whether to generate random media | bool | No |
+| notes | Additional notes for the post | str | No |
+| is_photo_video | Whether this is a photo/video post (appears in Photos section) | bool | No |
+| photo_category | Category for photo/video: cover, profile, logo, exterior, interior, product, at_work, food_and_drink, menu, common_area, rooms, teams | str | No |
+| call_to_action_type | Type of action button: 'book', 'order', 'shop', 'learn_more', 'sign_up', or 'call' | str | No |
+| call_to_action_url | URL for the action button (not required for 'call' action) | str | No |
+| event_title | Event title for event posts | str | No |
+| event_start_date | Event start date in ISO format (e.g., '2024-03-15T09:00:00Z') | str | No |
+| event_end_date | Event end date in ISO format (e.g., '2024-03-15T17:00:00Z') | str | No |
+| offer_title | Offer title for promotional posts | str | No |
+| offer_start_date | Offer start date in ISO format (e.g., '2024-03-15T00:00:00Z') | str | No |
+| offer_end_date | Offer end date in ISO format (e.g., '2024-04-15T23:59:59Z') | str | No |
+| offer_coupon_code | Coupon code for the offer (max 58 characters) | str | No |
+| offer_redeem_online_url | URL where customers can redeem the offer online | str | No |
+| offer_terms_conditions | Terms and conditions for the offer | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| post_result | The result of the post | PostResponse |
+| post | The result of the post | PostIds |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Local Business Updates**: Post daily specials, new arrivals, or service announcements directly to your Google Business Profile.
+
+**Promotional Campaigns**: Create time-limited offers with coupon codes and online redemption links to drive sales.
+
+**Event Marketing**: Announce upcoming events with dates, descriptions, and call-to-action buttons for reservations.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/ayrshare/post_to_instagram.md b/docs/integrations/ayrshare/post_to_instagram.md
new file mode 100644
index 0000000000..63ea5a3208
--- /dev/null
+++ b/docs/integrations/ayrshare/post_to_instagram.md
@@ -0,0 +1,61 @@
+# Ayrshare Post To Instagram
+<!-- MANUAL: file_description -->
+Blocks for posting content to Instagram using the Ayrshare social media management API.
+<!-- END MANUAL -->
+
+## Post To Instagram
+
+### What it is
+Post to Instagram using Ayrshare. Requires a Business or Creator Instagram Account connected with a Facebook Page
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Ayrshare's API to publish content to Instagram Business or Creator accounts. It supports feed posts, Stories (24-hour expiration), Reels, and carousels (up to 10 images/videos), with features like collaborator invitations, location tagging, and user tags with coordinates.
+
+The block requires an Instagram account connected to a Facebook Page and authenticates through Meta's Graph API via Ayrshare. Instagram-specific features include auto-resize for optimal dimensions, audio naming for Reels, and thumbnail customization with frame offset control.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| post | The post text (max 2,200 chars, up to 30 hashtags, 3 @mentions) | str | No |
+| media_urls | Optional list of media URLs. Instagram supports up to 10 images/videos in a carousel. | List[str] | No |
+| is_video | Whether the media is a video | bool | No |
+| schedule_date | UTC datetime for scheduling (YYYY-MM-DDThh:mm:ssZ) | str (date-time) | No |
+| disable_comments | Whether to disable comments | bool | No |
+| shorten_links | Whether to shorten links | bool | No |
+| unsplash | Unsplash image configuration | str | No |
+| requires_approval | Whether to enable approval workflow | bool | No |
+| random_post | Whether to generate random post text | bool | No |
+| random_media_url | Whether to generate random media | bool | No |
+| notes | Additional notes for the post | str | No |
+| is_story | Whether to post as Instagram Story (24-hour expiration) | bool | No |
+| share_reels_feed | Whether Reel should appear in both Feed and Reels tabs | bool | No |
+| audio_name | Audio name for Reels (e.g., 'The Weeknd - Blinding Lights') | str | No |
+| thumbnail | Thumbnail URL for Reel video | str | No |
+| thumbnail_offset | Thumbnail frame offset in milliseconds (default: 0) | int | No |
+| alt_text | Alt text for each media item (up to 1,000 chars each, accessibility feature), each item in the list corresponds to a media item in the media_urls list | List[str] | No |
+| location_id | Facebook Page ID or name for location tagging (e.g., '7640348500' or '@guggenheimmuseum') | str | No |
+| user_tags | List of users to tag with coordinates for images | List[Dict[str, Any]] | No |
+| collaborators | Instagram usernames to invite as collaborators (max 3, public accounts only) | List[str] | No |
+| auto_resize | Auto-resize images to 1080x1080px for Instagram | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| post_result | The result of the post | PostResponse |
+| post | The result of the post | PostIds |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Influencer Collaborations**: Create posts with collaborator tags to feature brand partnerships across multiple accounts.
+
+**E-commerce Product Showcases**: Share carousel posts of product images with location tags for local discovery.
+
+**Reels Automation**: Automatically publish short-form video content with custom thumbnails and trending audio.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/ayrshare/post_to_linkedin.md b/docs/integrations/ayrshare/post_to_linkedin.md
new file mode 100644
index 0000000000..5d062a02a3
--- /dev/null
+++ b/docs/integrations/ayrshare/post_to_linkedin.md
@@ -0,0 +1,63 @@
+# Ayrshare Post To LinkedIn
+<!-- MANUAL: file_description -->
+Blocks for posting content to LinkedIn using the Ayrshare social media management API.
+<!-- END MANUAL -->
+
+## Post To Linked In
+
+### What it is
+Post to LinkedIn using Ayrshare
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Ayrshare's social media API to post content to LinkedIn. It handles text posts, images, videos, and documents, with support for scheduling and audience targeting. The block authenticates through Ayrshare's API.
+
+LinkedIn-specific features include visibility controls, comment management, and targeting by country, seniority, industry, and other demographics (requires 300+ followers in target audience).
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| post | The post text (max 3,000 chars, hashtags supported with #) | str | No |
+| media_urls | Optional list of media URLs. LinkedIn supports up to 9 images, videos, or documents (PPT, PPTX, DOC, DOCX, PDF <100MB, <300 pages). | List[str] | No |
+| is_video | Whether the media is a video | bool | No |
+| schedule_date | UTC datetime for scheduling (YYYY-MM-DDThh:mm:ssZ) | str (date-time) | No |
+| disable_comments | Whether to disable comments | bool | No |
+| shorten_links | Whether to shorten links | bool | No |
+| unsplash | Unsplash image configuration | str | No |
+| requires_approval | Whether to enable approval workflow | bool | No |
+| random_post | Whether to generate random post text | bool | No |
+| random_media_url | Whether to generate random media | bool | No |
+| notes | Additional notes for the post | str | No |
+| visibility | Post visibility: 'public' (default), 'connections' (personal only), 'loggedin' | str | No |
+| alt_text | Alt text for each image (accessibility feature, not supported for videos/documents) | List[str] | No |
+| titles | Title/caption for each image or video | List[str] | No |
+| document_title | Title for document posts (max 400 chars, uses filename if not specified) | str | No |
+| thumbnail | Thumbnail URL for video (PNG/JPG, same dimensions as video, <10MB) | str | No |
+| targeting_countries | Country codes for targeting (e.g., ['US', 'IN', 'DE', 'GB']). Requires 300+ followers in target audience. | List[str] | No |
+| targeting_seniorities | Seniority levels for targeting (e.g., ['Senior', 'VP']). Requires 300+ followers in target audience. | List[str] | No |
+| targeting_degrees | Education degrees for targeting. Requires 300+ followers in target audience. | List[str] | No |
+| targeting_fields_of_study | Fields of study for targeting. Requires 300+ followers in target audience. | List[str] | No |
+| targeting_industries | Industry categories for targeting. Requires 300+ followers in target audience. | List[str] | No |
+| targeting_job_functions | Job function categories for targeting. Requires 300+ followers in target audience. | List[str] | No |
+| targeting_staff_count_ranges | Company size ranges for targeting. Requires 300+ followers in target audience. | List[str] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| post_result | The result of the post | PostResponse |
+| post | The result of the post | PostIds |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Thought Leadership**: Automatically share blog posts or industry insights with professional network.
+
+**Scheduled Content**: Queue up a week's worth of LinkedIn posts with scheduled publishing times.
+
+**Targeted Announcements**: Share company updates targeted to specific industries or seniority levels.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/ayrshare/post_to_pinterest.md b/docs/integrations/ayrshare/post_to_pinterest.md
new file mode 100644
index 0000000000..f548e69749
--- /dev/null
+++ b/docs/integrations/ayrshare/post_to_pinterest.md
@@ -0,0 +1,58 @@
+# Ayrshare Post To Pinterest
+<!-- MANUAL: file_description -->
+Blocks for posting pins to Pinterest using the Ayrshare social media management API.
+<!-- END MANUAL -->
+
+## Post To Pinterest
+
+### What it is
+Post to Pinterest using Ayrshare
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Ayrshare's API to publish pins to Pinterest boards. It supports image pins, video pins (with required thumbnails), and carousel pins (up to 5 images), with customizable titles, descriptions, destination links, and private notes.
+
+The block connects to Pinterest's API through Ayrshare, allowing you to specify target boards, add alt text for accessibility, and configure per-image carousel options including individual titles, links, and descriptions. Pins can be scheduled for future publishing.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| post | Pin description (max 500 chars, links not clickable - use link field instead) | str | No |
+| media_urls | Required image/video URLs. Pinterest requires at least one image. Videos need thumbnail. Up to 5 images for carousel. | List[str] | No |
+| is_video | Whether the media is a video | bool | No |
+| schedule_date | UTC datetime for scheduling (YYYY-MM-DDThh:mm:ssZ) | str (date-time) | No |
+| disable_comments | Whether to disable comments | bool | No |
+| shorten_links | Whether to shorten links | bool | No |
+| unsplash | Unsplash image configuration | str | No |
+| requires_approval | Whether to enable approval workflow | bool | No |
+| random_post | Whether to generate random post text | bool | No |
+| random_media_url | Whether to generate random media | bool | No |
+| notes | Additional notes for the post | str | No |
+| pin_title | Pin title displayed in 'Add your title' section (max 100 chars) | str | No |
+| link | Clickable destination URL when users click the pin (max 2048 chars) | str | No |
+| board_id | Pinterest Board ID to post to (from /user/details endpoint, uses default board if not specified) | str | No |
+| note | Private note for the pin (only visible to you and board collaborators) | str | No |
+| thumbnail | Required thumbnail URL for video pins (must have valid image Content-Type) | str | No |
+| carousel_options | Options for each image in carousel (title, link, description per image) | List[PinterestCarouselOption] | No |
+| alt_text | Alt text for each image/video (max 500 chars each, accessibility feature) | List[str] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| post_result | The result of the post | PostResponse |
+| post | The result of the post | PostIds |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Product Catalog Distribution**: Automatically pin product images with direct links to purchase pages organized by board category.
+
+**Content Repurposing**: Convert blog posts and articles into visual pins with clickable destination URLs.
+
+**Visual Inspiration Boards**: Create carousel pins showcasing design ideas, recipes, or tutorials with step-by-step images.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/ayrshare/post_to_reddit.md b/docs/integrations/ayrshare/post_to_reddit.md
new file mode 100644
index 0000000000..1fab74fd8a
--- /dev/null
+++ b/docs/integrations/ayrshare/post_to_reddit.md
@@ -0,0 +1,51 @@
+# Ayrshare Post To Reddit
+<!-- MANUAL: file_description -->
+Blocks for posting content to Reddit using the Ayrshare social media management API.
+<!-- END MANUAL -->
+
+## Post To Reddit
+
+### What it is
+Post to Reddit using Ayrshare
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Ayrshare's API to publish content to Reddit. It supports text posts, image posts, and video submissions with optional scheduling and link shortening features.
+
+The block authenticates through Ayrshare and submits content to your connected Reddit account. Common options include approval workflows for content review before publishing, random content generation, and Unsplash integration for sourcing images.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| post | The post text to be published | str | No |
+| media_urls | Optional list of media URLs to include. Set is_video in advanced settings to true if you want to upload videos. | List[str] | No |
+| is_video | Whether the media is a video | bool | No |
+| schedule_date | UTC datetime for scheduling (YYYY-MM-DDThh:mm:ssZ) | str (date-time) | No |
+| disable_comments | Whether to disable comments | bool | No |
+| shorten_links | Whether to shorten links | bool | No |
+| unsplash | Unsplash image configuration | str | No |
+| requires_approval | Whether to enable approval workflow | bool | No |
+| random_post | Whether to generate random post text | bool | No |
+| random_media_url | Whether to generate random media | bool | No |
+| notes | Additional notes for the post | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| post_result | The result of the post | PostResponse |
+| post | The result of the post | PostIds |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Community Engagement**: Share relevant content to niche subreddits as part of community marketing strategies.
+
+**Content Distribution**: Cross-post blog articles or announcements to relevant Reddit communities for broader reach.
+
+**Brand Monitoring Response**: Automatically share updates or responses in communities where your brand is discussed.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/ayrshare/post_to_snapchat.md b/docs/integrations/ayrshare/post_to_snapchat.md
new file mode 100644
index 0000000000..247f49f8c5
--- /dev/null
+++ b/docs/integrations/ayrshare/post_to_snapchat.md
@@ -0,0 +1,53 @@
+# Ayrshare Post To Snapchat
+<!-- MANUAL: file_description -->
+Blocks for posting video content to Snapchat using the Ayrshare social media management API.
+<!-- END MANUAL -->
+
+## Post To Snapchat
+
+### What it is
+Post to Snapchat using Ayrshare
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Ayrshare's API to publish video content to Snapchat. Snapchat only supports video content, with three destination options: Stories (24-hour ephemeral content), Saved Stories (persistent Stories), and Spotlight (public discovery feed).
+
+The block authenticates through Ayrshare and uploads video content with optional custom thumbnails. Videos can be scheduled for future publishing and support approval workflows for content review before going live.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| post | The post text (optional for video-only content) | str | No |
+| media_urls | Required video URL for Snapchat posts. Snapchat only supports video content. | List[str] | No |
+| is_video | Whether the media is a video | bool | No |
+| schedule_date | UTC datetime for scheduling (YYYY-MM-DDThh:mm:ssZ) | str (date-time) | No |
+| disable_comments | Whether to disable comments | bool | No |
+| shorten_links | Whether to shorten links | bool | No |
+| unsplash | Unsplash image configuration | str | No |
+| requires_approval | Whether to enable approval workflow | bool | No |
+| random_post | Whether to generate random post text | bool | No |
+| random_media_url | Whether to generate random media | bool | No |
+| notes | Additional notes for the post | str | No |
+| story_type | Type of Snapchat content: 'story' (24-hour Stories), 'saved_story' (Saved Stories), or 'spotlight' (Spotlight posts) | str | No |
+| video_thumbnail | Thumbnail URL for video content (optional, auto-generated if not provided) | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| post_result | The result of the post | PostResponse |
+| post | The result of the post | PostIds |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Ephemeral Marketing**: Share time-sensitive promotions or behind-the-scenes content that creates urgency through 24-hour Stories.
+
+**Public Discovery**: Post engaging video content to Spotlight to reach new audiences beyond your followers.
+
+**Scheduled Story Series**: Plan and schedule a sequence of video Stories for product launches or events.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/ayrshare/post_to_telegram.md b/docs/integrations/ayrshare/post_to_telegram.md
new file mode 100644
index 0000000000..c2c082d7b6
--- /dev/null
+++ b/docs/integrations/ayrshare/post_to_telegram.md
@@ -0,0 +1,51 @@
+# Ayrshare Post To Telegram
+<!-- MANUAL: file_description -->
+Blocks for posting messages to Telegram channels using the Ayrshare social media management API.
+<!-- END MANUAL -->
+
+## Post To Telegram
+
+### What it is
+Post to Telegram using Ayrshare
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Ayrshare's API to publish messages to Telegram channels. It supports text messages, images, videos, and animated GIFs, with automatic link preview generation unless media is included.
+
+The block authenticates through Ayrshare and sends content to your connected Telegram channel or bot. User mentions are supported via @handle syntax, and content can be scheduled for future delivery.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| post | The post text (empty string allowed). Use @handle to mention other Telegram users. | str | No |
+| media_urls | Optional list of media URLs. For animated GIFs, only one URL is allowed. Telegram will auto-preview links unless image/video is included. | List[str] | No |
+| is_video | Whether the media is a video. Set to true for animated GIFs that don't end in .gif/.GIF extension. | bool | No |
+| schedule_date | UTC datetime for scheduling (YYYY-MM-DDThh:mm:ssZ) | str (date-time) | No |
+| disable_comments | Whether to disable comments | bool | No |
+| shorten_links | Whether to shorten links | bool | No |
+| unsplash | Unsplash image configuration | str | No |
+| requires_approval | Whether to enable approval workflow | bool | No |
+| random_post | Whether to generate random post text | bool | No |
+| random_media_url | Whether to generate random media | bool | No |
+| notes | Additional notes for the post | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| post_result | The result of the post | PostResponse |
+| post | The result of the post | PostIds |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Channel Broadcasting**: Automatically distribute announcements, updates, or news to Telegram channel subscribers.
+
+**Alert Systems**: Send automated notifications with media attachments to monitoring or alert channels.
+
+**Content Syndication**: Cross-post content from other platforms to Telegram communities for broader reach.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/ayrshare/post_to_threads.md b/docs/integrations/ayrshare/post_to_threads.md
new file mode 100644
index 0000000000..65c5fdbe99
--- /dev/null
+++ b/docs/integrations/ayrshare/post_to_threads.md
@@ -0,0 +1,51 @@
+# Ayrshare Post To Threads
+<!-- MANUAL: file_description -->
+Blocks for posting content to Threads using the Ayrshare social media management API.
+<!-- END MANUAL -->
+
+## Post To Threads
+
+### What it is
+Post to Threads using Ayrshare
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Ayrshare's API to publish content to Threads (Meta's text-based social platform). It supports text posts (up to 500 characters with one hashtag), images, videos, and carousels (up to 20 items), with automatic link previews when no media is attached.
+
+The block authenticates through Meta's API via Ayrshare. Content can mention users via @handle syntax, be scheduled for future publishing, and include approval workflows for content review.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| post | The post text (max 500 chars, empty string allowed). Only 1 hashtag allowed. Use @handle to mention users. | str | No |
+| media_urls | Optional list of media URLs. Supports up to 20 images/videos in a carousel. Auto-preview links unless media is included. | List[str] | No |
+| is_video | Whether the media is a video | bool | No |
+| schedule_date | UTC datetime for scheduling (YYYY-MM-DDThh:mm:ssZ) | str (date-time) | No |
+| disable_comments | Whether to disable comments | bool | No |
+| shorten_links | Whether to shorten links | bool | No |
+| unsplash | Unsplash image configuration | str | No |
+| requires_approval | Whether to enable approval workflow | bool | No |
+| random_post | Whether to generate random post text | bool | No |
+| random_media_url | Whether to generate random media | bool | No |
+| notes | Additional notes for the post | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| post_result | The result of the post | PostResponse |
+| post | The result of the post | PostIds |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Thought Leadership**: Share quick insights, opinions, or industry commentary in a conversational format.
+
+**Cross-Platform Text Content**: Automatically syndicate text-based content from other platforms to Threads.
+
+**Community Engagement**: Post discussion prompts or responses to engage with your Threads audience.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/ayrshare/post_to_tiktok.md b/docs/integrations/ayrshare/post_to_tiktok.md
new file mode 100644
index 0000000000..f6bff7b940
--- /dev/null
+++ b/docs/integrations/ayrshare/post_to_tiktok.md
@@ -0,0 +1,62 @@
+# Ayrshare Post To TikTok
+<!-- MANUAL: file_description -->
+Blocks for posting videos and image slideshows to TikTok using the Ayrshare social media management API.
+<!-- END MANUAL -->
+
+## Post To Tik Tok
+
+### What it is
+Post to TikTok using Ayrshare
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Ayrshare's API to publish content to TikTok. It supports video posts and image slideshows (up to 35 images), with extensive options for content labeling including AI-generated disclosure, branded content, and brand organic content tags.
+
+The block connects to TikTok's API through Ayrshare with controls for visibility, duet/stitch permissions, comment settings, auto-music, and thumbnail selection. Videos can be posted as drafts for final review, and scheduled for future publishing.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| post | The post text (max 2,200 chars, empty string allowed). Use @handle to mention users. Line breaks will be ignored. | str | Yes |
+| media_urls | Required media URLs. Either 1 video OR up to 35 images (JPG/JPEG/WEBP only). Cannot mix video and images. | List[str] | No |
+| is_video | Whether the media is a video | bool | No |
+| schedule_date | UTC datetime for scheduling (YYYY-MM-DDThh:mm:ssZ) | str (date-time) | No |
+| disable_comments | Disable comments on the published post | bool | No |
+| shorten_links | Whether to shorten links | bool | No |
+| unsplash | Unsplash image configuration | str | No |
+| requires_approval | Whether to enable approval workflow | bool | No |
+| random_post | Whether to generate random post text | bool | No |
+| random_media_url | Whether to generate random media | bool | No |
+| notes | Additional notes for the post | str | No |
+| auto_add_music | Whether to automatically add recommended music to the post. If you set this field to true, you can change the music later in the TikTok app. | bool | No |
+| disable_duet | Disable duets on published video (video only) | bool | No |
+| disable_stitch | Disable stitch on published video (video only) | bool | No |
+| is_ai_generated | If you enable the toggle, your video will be labeled as “Creator labeled as AI-generated” once posted and can’t be changed. The “Creator labeled as AI-generated” label indicates that the content was completely AI-generated or significantly edited with AI. | bool | No |
+| is_branded_content | Whether to enable the Branded Content toggle. If this field is set to true, the video will be labeled as Branded Content, indicating you are in a paid partnership with a brand. A “Paid partnership” label will be attached to the video. | bool | No |
+| is_brand_organic | Whether to enable the Brand Organic Content toggle. If this field is set to true, the video will be labeled as Brand Organic Content, indicating you are promoting yourself or your own business. A “Promotional content” label will be attached to the video. | bool | No |
+| image_cover_index | Index of image to use as cover (0-based, image posts only) | int | No |
+| title | Title for image posts | str | No |
+| thumbnail_offset | Video thumbnail frame offset in milliseconds (video only) | int | No |
+| visibility | Post visibility: 'public', 'private', 'followers', or 'friends' | "public" \| "private" \| "followers" | No |
+| draft | Create as draft post (video only) | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| post_result | The result of the post | PostResponse |
+| post | The result of the post | PostIds |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Creator Content Pipeline**: Automate video uploads with proper AI disclosure labels and visibility settings for content creators.
+
+**Brand Campaigns**: Publish branded content with proper disclosure labels to maintain FTC compliance and platform guidelines.
+
+**Image Slideshow Posts**: Create TikTok slideshows from product images or photo series with automatic cover selection.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/ayrshare/post_to_x.md b/docs/integrations/ayrshare/post_to_x.md
new file mode 100644
index 0000000000..9881107505
--- /dev/null
+++ b/docs/integrations/ayrshare/post_to_x.md
@@ -0,0 +1,64 @@
+# Ayrshare Post To X
+<!-- MANUAL: file_description -->
+Blocks for posting tweets and threads to X (Twitter) using the Ayrshare social media management API.
+<!-- END MANUAL -->
+
+## Post To X
+
+### What it is
+Post to X / Twitter using Ayrshare
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Ayrshare's API to publish content to X (formerly Twitter). It supports standard tweets (280 characters, or 25,000 for Premium users), threads, polls, quote tweets, and replies, with up to 4 media attachments including video with subtitles.
+
+The block authenticates through Ayrshare and handles X-specific features like automatic thread breaking using double newlines, thread numbering, per-post media attachments, and long-form video uploads (with approval). Poll options and duration can be configured for engagement posts.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| post | The post text (max 280 chars, up to 25,000 for Premium users). Use @handle to mention users. Use \n\n for thread breaks. | str | Yes |
+| media_urls | Optional list of media URLs. X supports up to 4 images or videos per tweet. Auto-preview links unless media is included. | List[str] | No |
+| is_video | Whether the media is a video | bool | No |
+| schedule_date | UTC datetime for scheduling (YYYY-MM-DDThh:mm:ssZ) | str (date-time) | No |
+| disable_comments | Whether to disable comments | bool | No |
+| shorten_links | Whether to shorten links | bool | No |
+| unsplash | Unsplash image configuration | str | No |
+| requires_approval | Whether to enable approval workflow | bool | No |
+| random_post | Whether to generate random post text | bool | No |
+| random_media_url | Whether to generate random media | bool | No |
+| notes | Additional notes for the post | str | No |
+| reply_to_id | ID of the tweet to reply to | str | No |
+| quote_tweet_id | ID of the tweet to quote (low-level Tweet ID) | str | No |
+| poll_options | Poll options (2-4 choices) | List[str] | No |
+| poll_duration | Poll duration in minutes (1-10080) | int | No |
+| alt_text | Alt text for each image (max 1,000 chars each, not supported for videos) | List[str] | No |
+| is_thread | Whether to automatically break post into thread based on line breaks | bool | No |
+| thread_number | Add thread numbers (1/n format) to each thread post | bool | No |
+| thread_media_urls | Media URLs for thread posts (one per thread, use 'null' to skip) | List[str] | No |
+| long_post | Force long form post (requires Premium X account) | bool | No |
+| long_video | Enable long video upload (requires approval and Business/Enterprise plan) | bool | No |
+| subtitle_url | URL to SRT subtitle file for videos (must be HTTPS and end in .srt) | str | No |
+| subtitle_language | Language code for subtitles (default: 'en') | str | No |
+| subtitle_name | Name of caption track (max 150 chars, default: 'English') | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| post_result | The result of the post | PostResponse |
+| post | The result of the post | PostIds |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Thread Publishing**: Automatically format and publish long-form content as numbered thread sequences.
+
+**Engagement Polls**: Create polls to gather audience feedback or drive interaction with scheduled posting.
+
+**Reply Automation**: Build workflows that automatically respond to mentions or engage in conversations.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/ayrshare/post_to_youtube.md b/docs/integrations/ayrshare/post_to_youtube.md
new file mode 100644
index 0000000000..4210ac8571
--- /dev/null
+++ b/docs/integrations/ayrshare/post_to_youtube.md
@@ -0,0 +1,67 @@
+# Ayrshare Post To YouTube
+<!-- MANUAL: file_description -->
+Blocks for uploading videos to YouTube using the Ayrshare social media management API.
+<!-- END MANUAL -->
+
+## Post To You Tube
+
+### What it is
+Post to YouTube using Ayrshare
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Ayrshare's API to upload videos to YouTube. It handles video uploads with extensive metadata including titles, descriptions, tags, custom thumbnails, playlist assignment, category selection, and visibility controls (public, private, unlisted).
+
+The block supports YouTube Shorts (up to 3 minutes), geographic targeting to allow or block specific countries, subtitle files (SRT/SBV format), synthetic/AI content disclosure, kids content labeling, and subscriber notification controls. Videos can be scheduled for specific publish times.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| post | Video description (max 5,000 chars, empty string allowed). Cannot contain < or > characters. | str | Yes |
+| media_urls | Required video URL. YouTube only supports 1 video per post. | List[str] | No |
+| is_video | Whether the media is a video | bool | No |
+| schedule_date | UTC datetime for scheduling (YYYY-MM-DDThh:mm:ssZ) | str (date-time) | No |
+| disable_comments | Whether to disable comments | bool | No |
+| shorten_links | Whether to shorten links | bool | No |
+| unsplash | Unsplash image configuration | str | No |
+| requires_approval | Whether to enable approval workflow | bool | No |
+| random_post | Whether to generate random post text | bool | No |
+| random_media_url | Whether to generate random media | bool | No |
+| notes | Additional notes for the post | str | No |
+| title | Video title (max 100 chars, required). Cannot contain < or > characters. | str | Yes |
+| visibility | Video visibility: 'private' (default), 'public' , or 'unlisted' | "private" \| "public" \| "unlisted" | No |
+| thumbnail | Thumbnail URL (JPEG/PNG under 2MB, must end in .png/.jpg/.jpeg). Requires phone verification. | str | No |
+| playlist_id | Playlist ID to add video (user must own playlist) | str | No |
+| tags | Video tags (min 2 chars each, max 500 chars total) | List[str] | No |
+| made_for_kids | Self-declared kids content | bool | No |
+| is_shorts | Post as YouTube Short (max 3 minutes, adds #shorts) | bool | No |
+| notify_subscribers | Send notification to subscribers | bool | No |
+| category_id | Video category ID (e.g., 24 = Entertainment) | int | No |
+| contains_synthetic_media | Disclose realistic AI/synthetic content | bool | No |
+| publish_at | UTC publish time (YouTube controlled, format: 2022-10-08T21:18:36Z) | str | No |
+| targeting_block_countries | Country codes to block from viewing (e.g., ['US', 'CA']) | List[str] | No |
+| targeting_allow_countries | Country codes to allow viewing (e.g., ['GB', 'AU']) | List[str] | No |
+| subtitle_url | URL to SRT or SBV subtitle file (must be HTTPS and end in .srt/.sbv, under 100MB) | str | No |
+| subtitle_language | Language code for subtitles (default: 'en') | str | No |
+| subtitle_name | Name of caption track (max 150 chars, default: 'English') | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| post_result | The result of the post | PostResponse |
+| post | The result of the post | PostIds |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Video Publishing Pipeline**: Automate video uploads with thumbnails, descriptions, and playlist organization for content creators.
+
+**YouTube Shorts Automation**: Publish short-form vertical videos to YouTube Shorts with proper metadata and hashtags.
+
+**Multi-Region Content**: Upload videos with geographic restrictions for region-specific content licensing or compliance.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/baas/bots.md b/docs/integrations/baas/bots.md
new file mode 100644
index 0000000000..38cf9028cd
--- /dev/null
+++ b/docs/integrations/baas/bots.md
@@ -0,0 +1,160 @@
+# Baas Bots
+<!-- MANUAL: file_description -->
+Blocks for deploying and managing meeting recording bots using the BaaS (Bot as a Service) API.
+<!-- END MANUAL -->
+
+## Baas Bot Delete Recording
+
+### What it is
+Permanently delete a meeting's recorded data
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block permanently deletes the recorded data for a meeting bot using the BaaS (Bot as a Service) API. The deletion is irreversible and removes all associated recording files and transcripts.
+
+Provide the bot_id from a previous recording session to delete that specific meeting's data.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| bot_id | UUID of the bot whose data to delete | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| deleted | Whether the data was successfully deleted | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Privacy Compliance**: Delete recordings to comply with data retention policies or user requests.
+
+**Storage Management**: Clean up old recordings to manage storage costs.
+
+**Post-Processing Cleanup**: Delete recordings after extracting needed information.
+<!-- END MANUAL -->
+
+---
+
+## Baas Bot Fetch Meeting Data
+
+### What it is
+Retrieve recorded meeting data
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves recorded meeting data including video URL, transcript, and metadata from a completed bot session. The video URL is time-limited and should be downloaded promptly.
+
+Enable include_transcripts to receive the full meeting transcript with speaker identification and timestamps.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| bot_id | UUID of the bot whose data to fetch | str | Yes |
+| include_transcripts | Include transcript data in response | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| mp4_url | URL to download the meeting recording (time-limited) | str |
+| transcript | Meeting transcript data | List[Any] |
+| metadata | Meeting metadata and bot information | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Meeting Summarization**: Retrieve transcripts for AI summarization and action item extraction.
+
+**Recording Archive**: Download and store meeting recordings for compliance or reference.
+
+**Analytics**: Extract meeting metadata for participation and duration analytics.
+<!-- END MANUAL -->
+
+---
+
+## Baas Bot Join Meeting
+
+### What it is
+Deploy a bot to join and record a meeting
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block deploys a recording bot to join a video meeting (Zoom, Google Meet, Teams). Configure the bot's display name, avatar, and entry message. The bot joins, records, and transcribes the meeting.
+
+Use webhooks to receive notifications when the meeting ends and recordings are ready.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| meeting_url | The URL of the meeting the bot should join | str | Yes |
+| bot_name | Display name for the bot in the meeting | str | Yes |
+| bot_image | URL to an image for the bot's avatar (16:9 ratio recommended) | str | No |
+| entry_message | Chat message the bot will post upon entry | str | No |
+| reserved | Use a reserved bot slot (joins 4 min before meeting) | bool | No |
+| start_time | Unix timestamp (ms) when bot should join | int | No |
+| webhook_url | URL to receive webhook events for this bot | str | No |
+| timeouts | Automatic leave timeouts configuration | Dict[str, Any] | No |
+| extra | Custom metadata to attach to the bot | Dict[str, Any] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| bot_id | UUID of the deployed bot | str |
+| join_response | Full response from join operation | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Automated Recording**: Record meetings automatically without requiring host intervention.
+
+**Meeting Assistant**: Deploy bots to take notes and transcribe customer or team meetings.
+
+**Compliance Recording**: Ensure all meetings are recorded for compliance or quality assurance.
+<!-- END MANUAL -->
+
+---
+
+## Baas Bot Leave Meeting
+
+### What it is
+Remove a bot from an ongoing meeting
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block removes a recording bot from an ongoing meeting. Use this when you need to stop recording before the meeting naturally ends.
+
+The bot leaves gracefully and recording data becomes available for retrieval.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| bot_id | UUID of the bot to remove from meeting | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| left | Whether the bot successfully left | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Early Termination**: Stop recording when a meeting transitions to an off-record discussion.
+
+**Time-Based Recording**: Leave after capturing a specific portion of a meeting.
+
+**Error Recovery**: Remove and redeploy bots when issues occur during recording.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/bannerbear/text_overlay.md b/docs/integrations/bannerbear/text_overlay.md
new file mode 100644
index 0000000000..80ac9bd236
--- /dev/null
+++ b/docs/integrations/bannerbear/text_overlay.md
@@ -0,0 +1,49 @@
+# Bannerbear Text Overlay
+<!-- MANUAL: file_description -->
+Blocks for generating dynamic images with text overlays using Bannerbear templates.
+<!-- END MANUAL -->
+
+## Bannerbear Text Overlay
+
+### What it is
+Add text overlay to images using Bannerbear templates. Perfect for creating social media graphics, marketing materials, and dynamic image content.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Bannerbear's API to generate images by populating templates with dynamic text and images. Create templates in Bannerbear with text layers, then modify layer content programmatically.
+
+Webhooks can notify you when asynchronous generation completes. Include custom metadata for tracking generated images.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| template_id | The unique ID of your Bannerbear template | str | Yes |
+| project_id | Optional: Project ID (required when using Master API Key) | str | No |
+| text_modifications | List of text layers to modify in the template | List[TextModification] | Yes |
+| image_url | Optional: URL of an image to use in the template | str | No |
+| image_layer_name | Optional: Name of the image layer in the template | str | No |
+| webhook_url | Optional: URL to receive webhook notification when image is ready | str | No |
+| metadata | Optional: Custom metadata to attach to the image | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the image generation was successfully initiated | bool |
+| image_url | URL of the generated image (if synchronous) or placeholder | str |
+| uid | Unique identifier for the generated image | str |
+| status | Status of the image generation | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Social Media Graphics**: Generate personalized social posts with dynamic quotes, stats, or headlines.
+
+**Marketing Banners**: Create ad banners with different product names, prices, or offers.
+
+**Certificates & Cards**: Generate personalized certificates, invitations, or greeting cards.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/basic.md b/docs/integrations/basic.md
new file mode 100644
index 0000000000..367299ffa7
--- /dev/null
+++ b/docs/integrations/basic.md
@@ -0,0 +1,1418 @@
+# Basic
+<!-- MANUAL: file_description -->
+Core utility blocks for storing values, printing output, file operations, type conversion, and basic data manipulation.
+<!-- END MANUAL -->
+
+## Add Memory
+
+### What it is
+Add new memories to Mem0 with user segmentation
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block integrates with Mem0, a memory layer service that stores and retrieves information across conversations. When you add a memory, the content is stored with the user's context and can optionally be segmented by run or agent, allowing for scoped memory retrieval later.
+
+The block accepts either plain text or structured message objects (like those from AI blocks). You can attach metadata to memories for better organization and filtering. Memories persist across workflow executions, enabling your agents to "remember" past interactions.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| content | Content to add - either a string or list of message objects as output from an AI block | Content | No |
+| metadata | Optional metadata for the memory | Dict[str, Any] | No |
+| limit_memory_to_run | Limit the memory to the run | bool | No |
+| limit_memory_to_agent | Limit the memory to the agent | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| action | Action of the operation | str |
+| memory | Memory created | str |
+| results | List of all results from the operation | List[Dict[str, str]] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Personalized Assistants**: Store user preferences, past interactions, or learned information so your AI agent can provide personalized responses in future conversations.
+
+**Context Carryover**: Save important details from one workflow run (like customer issues or project context) to reference in subsequent runs without asking the user again.
+
+**Knowledge Building**: Accumulate facts and insights over time, creating a growing knowledge base that improves your agent's helpfulness with each interaction.
+<!-- END MANUAL -->
+
+---
+
+## Add To Dictionary
+
+### What it is
+Adds a new key-value pair to a dictionary. If no dictionary is provided, a new one is created.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block adds one or more key-value pairs to a dictionary. If you don't provide an existing dictionary, it creates a new one. You can add entries one at a time using the key/value fields, or add multiple entries at once using the entries field.
+
+The block outputs the updated dictionary with all new entries added. This is useful for building up structured data objects as your workflow progresses, collecting information from multiple sources into a single data structure.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| dictionary | The dictionary to add the entry to. If not provided, a new dictionary will be created. | Dict[str, Any] | No |
+| key | The key for the new entry. | str | No |
+| value | The value for the new entry. | Value | No |
+| entries | The entries to add to the dictionary. This is the batch version of the `key` and `value` fields. | Dict[str, Any] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| updated_dictionary | The dictionary with the new entry added. | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Building API Payloads**: Construct complex JSON objects by adding fields from different workflow branches before sending to an API.
+
+**Aggregating Form Data**: Collect user inputs from multiple form fields into a single structured object for processing or storage.
+
+**Creating Configuration Objects**: Build up settings or configuration dictionaries dynamically based on conditional logic in your workflow.
+<!-- END MANUAL -->
+
+---
+
+## Add To List
+
+### What it is
+Adds a new entry to a list. The entry can be of any type. If no list is provided, a new one is created.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block appends items to a list or creates a new list if none is provided. You can add a single entry or multiple entries at once. The optional position parameter lets you insert items at a specific index rather than appending to the end.
+
+Items can be of any type—strings, numbers, dictionaries, or other lists. This flexibility makes the block useful for building up collections of data as your workflow processes multiple items or accumulates results.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| list | The list to add the entry to. If not provided, a new list will be created. | List[Any] | No |
+| entry | The entry to add to the list. Can be of any type (string, int, dict, etc.). | Entry | No |
+| entries | The entries to add to the list. This is the batch version of the `entry` field. | List[Any] | No |
+| position | The position to insert the new entry. If not provided, the entry will be appended to the end of the list. | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| updated_list | The list with the new entry added. | List[Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Collecting Search Results**: Accumulate items from paginated API responses into a single list for batch processing or display.
+
+**Building Email Recipients**: Gather email addresses from various sources into a recipient list before sending a message.
+
+**Aggregating Errors**: Collect validation errors or warnings from multiple checks into a list for consolidated error reporting.
+<!-- END MANUAL -->
+
+---
+
+## Agent Date Input
+
+### What it is
+Block for date input.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block provides a date picker input field for users interacting with your agent. When the agent runs, users see a calendar widget to select a date, which is then passed to your workflow in YYYY-MM-DD format.
+
+The block is part of the Agent Input family, allowing you to collect structured input from users at runtime rather than hardcoding values. This makes your agents interactive and reusable for different scenarios.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| name | The name of the input. | str | Yes |
+| value | Date input (YYYY-MM-DD). | str (date) | No |
+| title | The title of the input. | str | No |
+| description | The description of the input. | str | No |
+| advanced | Whether to show the input in the advanced section, if the field is not required. | bool | No |
+| secret | Whether the input should be treated as a secret. | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| result | Date result. | str (date) |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Appointment Scheduling**: Let users select a date for booking appointments, meetings, or reservations through your agent.
+
+**Report Generation**: Allow users to specify a date range start or end point for generating custom reports.
+
+**Deadline Setting**: Enable users to set due dates for tasks or projects when creating them through your workflow.
+<!-- END MANUAL -->
+
+---
+
+## Agent Dropdown Input
+
+### What it is
+Block for dropdown text selection.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block provides a dropdown selection input for users interacting with your agent. You define the available options using placeholder_values, and users select one option from the list at runtime.
+
+This is ideal when you want to constrain user input to a predefined set of choices, ensuring valid input and simplifying the user experience. The selected value is passed to downstream blocks in your workflow.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| name | The name of the input. | str | Yes |
+| value | Text selected from a dropdown. | str | No |
+| title | The title of the input. | str | No |
+| description | The description of the input. | str | No |
+| placeholder_values | Possible values for the dropdown. | List[Any] | No |
+| advanced | Whether to show the input in the advanced section, if the field is not required. | bool | No |
+| secret | Whether the input should be treated as a secret. | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| result | Selected dropdown value. | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Service Selection**: Let users choose from available service tiers (Basic, Pro, Enterprise) when configuring their request.
+
+**Language Selection**: Allow users to select their preferred language from a list of supported options.
+
+**Category Filtering**: Enable users to select a category (Sales, Support, Billing) to route their inquiry appropriately.
+<!-- END MANUAL -->
+
+---
+
+## Agent File Input
+
+### What it is
+Block for file upload input (string path for example).
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block provides a file upload input for users interacting with your agent. Users can upload files which are stored temporarily and passed to your workflow as a file path reference.
+
+By default, the block outputs a file path string that other blocks can use to access the uploaded file. The optional base64 mode converts the file content to base64 encoding, though using file paths is generally recommended for better performance with large files.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| name | The name of the input. | str | Yes |
+| value | Path or reference to an uploaded file. | str (file) | No |
+| title | The title of the input. | str | No |
+| description | The description of the input. | str | No |
+| advanced | Whether to show the input in the advanced section, if the field is not required. | bool | No |
+| secret | Whether the input should be treated as a secret. | bool | No |
+| base_64 | Whether produce an output in base64 format (not recommended, you can pass the string path just fine accross blocks). | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| result | File reference/path result. | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Document Processing**: Accept PDF or Word documents from users for analysis, summarization, or data extraction.
+
+**Image Upload**: Allow users to upload images for processing, resizing, or AI-based analysis.
+
+**Data Import**: Enable users to upload CSV or Excel files to import data into your workflow for processing.
+<!-- END MANUAL -->
+
+---
+
+## Agent Google Drive File Input
+
+### What it is
+Block for selecting a file from Google Drive.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block integrates with Google Drive to let users select files directly from their connected Drive account. The Google Drive file picker appears at runtime, allowing users to browse and select files without manually copying file IDs or URLs.
+
+You can configure which file types to display (documents, spreadsheets, presentations) using the allowed_views option. The block outputs the selected file's metadata including its ID, name, and URL for use by other Google-integrated blocks.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| name | The name of the input. | str | Yes |
+| value | The selected Google Drive file. | GoogleDriveFile | No |
+| title | The title of the input. | str | No |
+| description | The description of the input. | str | No |
+| advanced | Whether to show the input in the advanced section, if the field is not required. | bool | No |
+| secret | Whether the input should be treated as a secret. | bool | No |
+| allowed_views | Which views to show in the file picker (DOCS, SPREADSHEETS, PRESENTATIONS, etc.). | List["DOCS" \| "DOCUMENTS" \| "SPREADSHEETS" \| "PRESENTATIONS" \| "DOCS_IMAGES" \| "FOLDERS"] | No |
+| allow_folder_selection | Whether to allow selecting folders. | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| result | The selected Google Drive file with ID, name, URL, and other metadata. | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Document Workflow**: Let users select a Google Doc to read, analyze, or append content to without knowing the file ID.
+
+**Spreadsheet Data Import**: Allow users to pick a Google Sheet to import data from for processing or analysis.
+
+**File Organization**: Enable users to select folders or files for bulk operations like moving, copying, or organizing content.
+<!-- END MANUAL -->
+
+---
+
+## Agent Input
+
+### What it is
+A block that accepts and processes user input values within a workflow, supporting various input types and validation.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+It accepts a value from the user, along with metadata such as name, description, and optional placeholder values. The block then outputs the provided value.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| name | The name of the input. | str | Yes |
+| value | The value to be passed as input. | Value | No |
+| title | The title of the input. | str | No |
+| description | The description of the input. | str | No |
+| advanced | Whether to show the input in the advanced section, if the field is not required. | bool | No |
+| secret | Whether the input should be treated as a secret. | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| result | The value passed as input. | Result |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Collecting user preferences at the start of a personalized recommendation workflow.
+<!-- END MANUAL -->
+
+---
+
+## Agent Long Text Input
+
+### What it is
+Block for long text input (multi-line).
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block provides a multi-line text area input for users interacting with your agent. Unlike the short text input, this displays a larger text area suitable for paragraphs, descriptions, or any content that may span multiple lines.
+
+The block is ideal for collecting longer-form content like messages, descriptions, or code snippets from users at runtime. The text is passed as-is to downstream blocks in your workflow.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| name | The name of the input. | str | Yes |
+| value | Long text input (potentially multi-line). | str (long-text) | No |
+| title | The title of the input. | str | No |
+| description | The description of the input. | str | No |
+| advanced | Whether to show the input in the advanced section, if the field is not required. | bool | No |
+| secret | Whether the input should be treated as a secret. | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| result | Long text result. | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Feedback Collection**: Accept detailed user feedback, reviews, or comments that may require multiple paragraphs.
+
+**Content Submission**: Let users submit articles, blog posts, or documentation content for processing or publication.
+
+**Query Input**: Allow users to enter complex questions or prompts for AI processing that require detailed context.
+<!-- END MANUAL -->
+
+---
+
+## Agent Number Input
+
+### What it is
+Block for number input.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block provides a numeric input field for users interacting with your agent. The input validates that the user enters a valid integer, preventing text or invalid values from being submitted.
+
+This is useful when you need numeric parameters like quantities, counts, limits, or any integer value from users at runtime. The number is passed to downstream blocks for use in calculations or configurations.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| name | The name of the input. | str | Yes |
+| value | Number input. | int | No |
+| title | The title of the input. | str | No |
+| description | The description of the input. | str | No |
+| advanced | Whether to show the input in the advanced section, if the field is not required. | bool | No |
+| secret | Whether the input should be treated as a secret. | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| result | Number result. | int |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Quantity Selection**: Let users specify how many items to process, order, or generate.
+
+**Pagination Control**: Allow users to specify page numbers or result limits for data retrieval.
+
+**Threshold Setting**: Enable users to set numeric thresholds or limits for alerts, filtering, or processing logic.
+<!-- END MANUAL -->
+
+---
+
+## Agent Output
+
+### What it is
+A block that records and formats workflow results for display to users, with optional Jinja2 template formatting support.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+It accepts an input value along with a name, description, and optional format string. If a format string is provided, it attempts to apply the formatting to the input value before outputting it.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| value | The value to be recorded as output. | Value | No |
+| name | The name of the output. | str | Yes |
+| title | The title of the output. | str | No |
+| description | The description of the output. | str | No |
+| format | The format string to be used to format the recorded_value. Use Jinja2 syntax. | str | No |
+| escape_html | Whether to escape special characters in the inserted values to be HTML-safe. Enable for HTML output, disable for plain text. | bool | No |
+| advanced | Whether to treat the output as advanced. | bool | No |
+| secret | Whether the output should be treated as a secret. | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| output | The value recorded as output. | Output |
+| name | The name of the value recorded as output. | Name |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Presenting the final results of a data analysis workflow in a specific format.
+<!-- END MANUAL -->
+
+---
+
+## Agent Short Text Input
+
+### What it is
+Block for short text input (single-line).
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block provides a single-line text input field for users interacting with your agent. It's designed for brief text entries like names, titles, URLs, or short responses.
+
+The input displays as a standard text field and passes the entered text to downstream blocks. Use this for collecting concise information that doesn't require multiple lines or extensive formatting.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| name | The name of the input. | str | Yes |
+| value | Short text input. | str (short-text) | No |
+| title | The title of the input. | str | No |
+| description | The description of the input. | str | No |
+| advanced | Whether to show the input in the advanced section, if the field is not required. | bool | No |
+| secret | Whether the input should be treated as a secret. | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| result | Short text result. | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Name Collection**: Gather user names, company names, or project names for personalization.
+
+**Search Queries**: Accept search terms or keywords from users to drive search functionality.
+
+**URL Input**: Let users provide URLs for websites, APIs, or resources to process in your workflow.
+<!-- END MANUAL -->
+
+---
+
+## Agent Table Input
+
+### What it is
+Block for table data input with customizable headers.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block provides a tabular data input interface for users interacting with your agent. Users can enter data in a spreadsheet-like table format with customizable column headers.
+
+The table input is ideal for structured data entry where users need to provide multiple records with consistent fields. The block outputs the data as a list of dictionaries, with each row becoming a dictionary where column headers are keys.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| name | The name of the input. | str | Yes |
+| value | The table data as a list of dictionaries. | List[Dict[str, Any]] | No |
+| title | The title of the input. | str | No |
+| description | The description of the input. | str | No |
+| advanced | Whether to show the input in the advanced section, if the field is not required. | bool | No |
+| secret | Whether the input should be treated as a secret. | bool | No |
+| column_headers | Column headers for the table. | List[str] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| result | The table data as a list of dictionaries with headers as keys. | List[Dict[str, Any]] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Bulk Data Entry**: Let users input multiple records at once, like a list of contacts with name, email, and phone columns.
+
+**Order Processing**: Accept line items for an order with product, quantity, and price columns.
+
+**Task Lists**: Allow users to submit multiple tasks with columns for title, assignee, and priority.
+<!-- END MANUAL -->
+
+---
+
+## Agent Time Input
+
+### What it is
+Block for time input.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block provides a time picker input for users interacting with your agent. Users select a time (hours, minutes, and optionally seconds) which is passed to your workflow in HH:MM:SS format.
+
+The time picker provides a user-friendly interface for selecting times without requiring users to type in a specific format. This ensures valid time values and improves the user experience.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| name | The name of the input. | str | Yes |
+| value | Time input (HH:MM:SS). | str (time) | No |
+| title | The title of the input. | str | No |
+| description | The description of the input. | str | No |
+| advanced | Whether to show the input in the advanced section, if the field is not required. | bool | No |
+| secret | Whether the input should be treated as a secret. | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| result | Time result. | str (time) |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Appointment Scheduling**: Let users specify a time for meetings, calls, or appointments.
+
+**Reminder Setting**: Allow users to set reminder times for notifications or alerts.
+
+**Shift Configuration**: Enable users to define start or end times for work shifts or availability windows.
+<!-- END MANUAL -->
+
+---
+
+## Agent Toggle Input
+
+### What it is
+Block for boolean toggle input.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block provides a boolean toggle (on/off switch) input for users interacting with your agent. Users simply click to toggle between true and false states, making yes/no decisions quick and error-free.
+
+The toggle is ideal for binary choices like enabling features, confirming actions, or setting preferences. The boolean value is passed to downstream blocks for conditional logic.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| name | The name of the input. | str | Yes |
+| value | Boolean toggle input. | bool | No |
+| title | The title of the input. | str | No |
+| description | The description of the input. | str | No |
+| advanced | Whether to show the input in the advanced section, if the field is not required. | bool | No |
+| secret | Whether the input should be treated as a secret. | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| result | Boolean toggle result. | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Feature Flags**: Let users enable or disable optional features in your workflow.
+
+**Confirmation Toggles**: Require users to acknowledge terms, confirm destructive actions, or opt into notifications.
+
+**Mode Selection**: Allow users to switch between modes like "test mode" vs "production mode" or "verbose" vs "quiet" output.
+<!-- END MANUAL -->
+
+---
+
+## Block Installation
+
+### What it is
+Given a code string, this block allows the verification and installation of a block code into the system.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block allows dynamic installation of new block types into the system from Python code. The code is verified for safety and correctness before installation. Once installed, the new block becomes available for use in workflows.
+
+This enables extensibility by allowing custom blocks to be added without modifying the core system, though it requires the code to follow the block specification format.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| code | Python code of the block to be installed | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the block installation fails | str |
+| success | Success message if the block is installed successfully | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Custom Integrations**: Install blocks that connect to proprietary or internal APIs not covered by built-in blocks.
+
+**Dynamic Workflows**: Allow administrators to extend workflow capabilities without redeploying the entire system.
+
+**Experimental Features**: Test new block implementations before formally adding them to the block library.
+<!-- END MANUAL -->
+
+---
+
+## Dictionary Is Empty
+
+### What it is
+Checks if a dictionary is empty.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block checks whether a dictionary has any entries and returns a boolean result. An empty dictionary (no key-value pairs) returns true, while a dictionary with any entries returns false.
+
+This is useful for conditional logic where you need to verify if data was returned from an API, if user input was provided, or if a collection process yielded any results.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| dictionary | The dictionary to check. | Dict[str, Any] | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| is_empty | True if the dictionary is empty. | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Response Validation**: Check if an API returned an empty response before processing data.
+
+**Input Verification**: Verify that user-provided form data contains at least one field before submission.
+
+**Conditional Processing**: Skip processing steps when no matching data was found in a search or filter operation.
+<!-- END MANUAL -->
+
+---
+
+## File Store
+
+### What it is
+Stores the input file in the temporary directory.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block takes a file from various sources (URL, data URI, or local path) and stores it in a temporary directory for use by other blocks in your workflow. This normalizes file handling regardless of the original source.
+
+The block outputs a file path that other blocks can use to access the stored file. The optional base64 output mode is available but file paths are recommended for better performance with large files.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| file_in | The file to store in the temporary directory, it can be a URL, data URI, or local path. | str (file) | Yes |
+| base_64 | Whether produce an output in base64 format (not recommended, you can pass the string path just fine accross blocks). | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| file_out | The relative path to the stored file in the temporary directory. | str (file) |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**URL File Download**: Fetch a file from a URL and make it available for local processing by other blocks.
+
+**Data URI Conversion**: Convert base64-encoded data URIs (like from a web form) into accessible file paths.
+
+**File Normalization**: Standardize file access across different input sources (URLs, uploads, local files) for consistent downstream processing.
+<!-- END MANUAL -->
+
+---
+
+## Find In Dictionary
+
+### What it is
+A block that looks up a value in a dictionary, list, or object by key or index and returns the corresponding value.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block extracts a value from a dictionary (object) or list using a key or index. If the key exists, the value is output through the "output" pin. If the key is missing, the original input is output through the "missing" pin.
+
+This enables safe data access with built-in handling for missing keys, preventing workflow errors when expected data isn't present. You can use string keys for dictionaries or integer indices for lists.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| input | Dictionary to lookup from | Input | Yes |
+| key | Key to lookup in the dictionary | str \| int | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| output | Value found for the given key | Output |
+| missing | Value of the input that missing the key | Missing |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**API Response Parsing**: Extract specific fields (like "data" or "results") from API response objects.
+
+**Configuration Access**: Retrieve settings from a configuration dictionary by key name.
+
+**User Data Extraction**: Pull specific user attributes (name, email, preferences) from a user profile object.
+<!-- END MANUAL -->
+
+---
+
+## Find In List
+
+### What it is
+Finds the index of the value in the list.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block searches a list for a specific value and returns its position (index). If found, it outputs the zero-based index and sets "found" to true. If not found, it outputs the original value through "not_found_value" and sets "found" to false.
+
+This enables conditional logic based on list membership and helps locate items for subsequent list operations like replacement or removal.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| list | The list to search in. | List[Any] | Yes |
+| value | The value to search for. | Value | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| index | The index of the value in the list. | int |
+| found | Whether the value was found in the list. | bool |
+| not_found_value | The value that was not found in the list. | Not Found Value |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Duplicate Detection**: Check if an item already exists in a list before adding it.
+
+**Status Lookup**: Find if a value is in a list of valid states or allowed values.
+
+**Position Finding**: Locate an item's position for subsequent operations like updates or removals.
+<!-- END MANUAL -->
+
+---
+
+## Get All Memories
+
+### What it is
+Retrieve all memories from Mem0 with optional conversation filtering
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves all stored memories from Mem0 for the current user context. You can filter results by categories or metadata, and scope the retrieval to the current run or agent using the limit options.
+
+Memories are returned as a list that your workflow can iterate through. This is useful for reviewing accumulated knowledge, debugging what your agent has learned, or aggregating past interactions for analysis.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| trigger | An unused field that is used to trigger the block when you have no other inputs | bool | No |
+| categories | Filter by categories | List[str] | No |
+| metadata_filter | Optional metadata filters to apply | Dict[str, Any] | No |
+| limit_memory_to_run | Limit the memory to the run | bool | No |
+| limit_memory_to_agent | Limit the memory to the agent | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| memories | List of memories | Memories |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Context Review**: Retrieve all memories at the start of a session to understand what your agent already knows about a user.
+
+**Memory Export**: Collect all stored memories for backup, analysis, or migration to another system.
+
+**Memory Management**: List all memories to identify outdated or incorrect information that needs updating.
+<!-- END MANUAL -->
+
+---
+
+## Get Latest Memory
+
+### What it is
+Retrieve the latest memory from Mem0 with optional key filtering
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves the most recently stored memory from Mem0. You can filter by categories, metadata, or conversation ID to find the latest relevant memory. The block indicates whether a memory was found and returns it if available.
+
+This is useful for quickly accessing the last piece of information stored without iterating through all memories, such as checking the most recent user preference or the last conversation topic.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| trigger | An unused field that is used to trigger the block when you have no other inputs | bool | No |
+| categories | Filter by categories | List[str] | No |
+| conversation_id | Optional conversation ID to retrieve the latest memory from (uses run_id) | str | No |
+| metadata_filter | Optional metadata filters to apply | Dict[str, Any] | No |
+| limit_memory_to_run | Limit the memory to the run | bool | No |
+| limit_memory_to_agent | Limit the memory to the agent | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| memory | Latest memory if found | Dict[str, Any] |
+| found | Whether a memory was found | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Conversation Continuity**: Retrieve the last topic discussed to provide context when resuming a conversation.
+
+**Status Tracking**: Get the most recent status update or progress report stored during a workflow.
+
+**Quick Recall**: Access the last user preference or setting without loading the full memory history.
+<!-- END MANUAL -->
+
+---
+
+## Get List Item
+
+### What it is
+Returns the element at the given index.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves an item from a list at a specific index position. It uses zero-based indexing (first item is 0) and supports negative indices for accessing items from the end (e.g., -1 for the last item).
+
+If the index is out of range, the block outputs an error. This is useful for accessing specific elements without iterating through the entire list.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| list | The list to get the item from. | List[Any] | Yes |
+| index | The 0-based index of the item (supports negative indices). | int | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| item | The item at the specified index. | Item |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**First/Last Item Access**: Get the first item (index 0) or last item (index -1) from a list of results.
+
+**Ordered Selection**: Access a specific position in a ranked list, like the second-highest score or third most recent entry.
+
+**Array Unpacking**: Extract individual elements from a fixed-structure list where each position has a known meaning.
+<!-- END MANUAL -->
+
+---
+
+## Get Weather Information
+
+### What it is
+Retrieves weather information for a specified location using OpenWeatherMap API.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block sends a request to a weather API (like OpenWeatherMap) with the provided location. It then processes the response to extract relevant weather data.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| location | Location to get weather information for | str | Yes |
+| use_celsius | Whether to use Celsius or Fahrenheit for temperature | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the weather information cannot be retrieved | str |
+| temperature | Temperature in the specified location | str |
+| humidity | Humidity in the specified location | str |
+| condition | Weather condition in the specified location | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+A travel planning application could use this block to provide users with current weather information for their destination cities.
+<!-- END MANUAL -->
+
+---
+
+## Human In The Loop
+
+### What it is
+Pause execution and wait for human approval or modification of data
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block pauses workflow execution and presents data to a human reviewer for approval. The workflow waits until the human approves or rejects the data, then routes to the corresponding output. If editable is enabled, the reviewer can modify the data before approving.
+
+This enables human oversight at critical points in automated workflows, ensuring important decisions have human verification before proceeding.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| data | The data to be reviewed by a human user | Data | Yes |
+| name | A descriptive name for what this data represents | str | Yes |
+| editable | Whether the human reviewer can edit the data | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| approved_data | The data when approved (may be modified by reviewer) | Approved Data |
+| rejected_data | The data when rejected (may be modified by reviewer) | Rejected Data |
+| review_message | Any message provided by the reviewer | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Moderation**: Review AI-generated content before publishing to ensure quality and appropriateness.
+
+**Approval Workflows**: Require manager approval for actions like large purchases, access requests, or configuration changes.
+
+**Quality Assurance**: Let reviewers verify data transformations or calculations before they're committed to production systems.
+<!-- END MANUAL -->
+
+---
+
+## List Is Empty
+
+### What it is
+Checks if a list is empty.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block checks whether a list contains any items and returns a boolean result. An empty list (no elements) returns true, while a list with any elements returns false.
+
+This is useful for conditional logic where you need to verify if search results were found, if items are available for processing, or if a collection has any entries to iterate over.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| list | The list to check. | List[Any] | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| is_empty | True if the list is empty. | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Search Result Handling**: Check if a search returned any results before processing, displaying "no results found" when empty.
+
+**Batch Processing Guard**: Verify that a list has items before starting a batch operation to avoid empty iterations.
+
+**Conditional Messaging**: Send different notifications based on whether pending items exist or the queue is empty.
+<!-- END MANUAL -->
+
+---
+
+## Note
+
+### What it is
+A visual annotation block that displays a sticky note in the workflow editor for documentation and organization purposes.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+It simply accepts a text input and passes it through as an output to be displayed as a note.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| text | The text to display in the sticky note. | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| output | The text to display in the sticky note. | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Adding explanatory notes or reminders within a complex workflow to help users understand different stages or provide additional context.
+<!-- END MANUAL -->
+
+---
+
+## Print To Console
+
+### What it is
+A debugging block that outputs text to the console for monitoring and troubleshooting workflow execution.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block outputs the provided data to the server console log and passes it through as output. It's primarily used for debugging workflows by allowing you to inspect values at any point in the data flow.
+
+The block accepts any data type and both prints it for debugging visibility and forwards it to downstream blocks, making it easy to insert into existing connections without disrupting the workflow.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| text | The data to print to the console. | Text | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| output | The data printed to the console. | Output |
+| status | The status of the print operation. | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Workflow Debugging**: Insert at any point to inspect what data is flowing through that connection during testing.
+
+**Variable Inspection**: Log the values of variables or API responses to understand what your workflow is receiving.
+
+**Progress Tracking**: Add print statements at key stages to monitor workflow progress in the server logs.
+<!-- END MANUAL -->
+
+---
+
+## Remove From Dictionary
+
+### What it is
+Removes a key-value pair from a dictionary.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block removes a key-value pair from a dictionary by specifying the key. The updated dictionary without that entry is output. Optionally, you can retrieve the value that was removed by enabling return_value.
+
+If the key doesn't exist in the dictionary, the operation may error or return the dictionary unchanged depending on the implementation. This is useful for cleaning up data or extracting and removing values in one step.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| dictionary | The dictionary to modify. | Dict[str, Any] | Yes |
+| key | Key to remove from the dictionary. | str \| int | Yes |
+| return_value | Whether to return the removed value. | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| updated_dictionary | The dictionary after removal. | Dict[str, Any] |
+| removed_value | The removed value if requested. | Removed Value |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Data Cleaning**: Remove sensitive fields (like passwords or tokens) from data before logging or storing.
+
+**Pop Pattern**: Extract and remove a value from a dictionary in a single operation, like dequeuing items.
+
+**Object Trimming**: Remove unnecessary or deprecated fields from configuration objects before processing.
+<!-- END MANUAL -->
+
+---
+
+## Remove From List
+
+### What it is
+Removes an item from a list by value or index.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block removes an item from a list either by value (remove first occurrence) or by index (remove at specific position). Negative indices are supported for removal from the end. Optionally, the removed item can be returned.
+
+This provides flexibility for both "remove this specific item" and "remove the item at this position" use cases in a single block.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| list | The list to modify. | List[Any] | Yes |
+| value | Value to remove from the list. | Value | No |
+| index | Index of the item to pop (supports negative indices). | int | No |
+| return_item | Whether to return the removed item. | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| updated_list | The list after removal. | List[Any] |
+| removed_item | The removed item if requested. | Removed Item |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Queue Processing**: Pop items from the front of a list to process them one at a time (FIFO queue).
+
+**Exclusion Lists**: Remove specific values from a list, like filtering out certain options or invalid entries.
+
+**Stack Operations**: Pop items from the end of a list for last-in-first-out processing.
+<!-- END MANUAL -->
+
+---
+
+## Replace Dictionary Value
+
+### What it is
+Replaces the value for a specified key in a dictionary.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block updates the value for an existing key in a dictionary. The old value is replaced with the new one, and the updated dictionary is output. The block also returns the old value that was replaced.
+
+This is useful for updating specific fields in a data object while preserving all other fields, or for tracking what value was changed during an update operation.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| dictionary | The dictionary to modify. | Dict[str, Any] | Yes |
+| key | Key to replace the value for. | str \| int | Yes |
+| value | The new value for the given key. | Value | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| updated_dictionary | The dictionary after replacement. | Dict[str, Any] |
+| old_value | The value that was replaced. | Old Value |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Status Updates**: Change the status field in a record from "pending" to "completed" while preserving all other data.
+
+**Configuration Changes**: Update a single setting in a configuration object without rebuilding the entire config.
+
+**Field Transformations**: Replace a raw value with a processed or formatted version while tracking the original.
+<!-- END MANUAL -->
+
+---
+
+## Replace List Item
+
+### What it is
+Replaces an item at the specified index.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block replaces an item at a specific position in a list with a new value. It uses zero-based indexing and supports negative indices for accessing positions from the end. The old item that was replaced is also returned.
+
+This is useful for updating specific elements in an ordered list without rebuilding the entire list or losing other elements.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| list | The list to modify. | List[Any] | Yes |
+| index | Index of the item to replace (supports negative indices). | int | Yes |
+| value | The new value for the given index. | Value | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| updated_list | The list after replacement. | List[Any] |
+| old_item | The item that was replaced. | Old Item |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**List Updates**: Replace an outdated entry in a list with updated information while keeping other entries intact.
+
+**Correction Workflows**: Fix a specific item in a results list after validation identifies an error at a known position.
+
+**Value Swapping**: Replace placeholder values in a list with computed or fetched actual values at known positions.
+<!-- END MANUAL -->
+
+---
+
+## Reverse List Order
+
+### What it is
+Reverses the order of elements in a list
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block takes a list and returns a new list with all elements in reverse order. The first element becomes the last, and the last element becomes the first. The original list is not modified.
+
+This is useful for changing the processing order of items or displaying lists in a different order than they were collected.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| input_list | The list to reverse | List[Any] | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| reversed_list | The list in reversed order | List[Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Chronological Reversal**: Display the most recent items first when data was collected oldest-to-newest.
+
+**Processing Order Change**: Process a stack of items last-in-first-out by reversing a first-in-first-out list.
+
+**Display Formatting**: Reverse leaderboard rankings to show from lowest to highest or vice versa.
+<!-- END MANUAL -->
+
+---
+
+## Search Memory
+
+### What it is
+Search memories in Mem0 by user
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block searches through stored memories using a natural language query. It uses semantic search to find memories that are relevant to your query, not just exact matches. Results can be filtered by categories or metadata.
+
+The search is performed against the Mem0 memory store and returns memories ranked by relevance to your query. This enables intelligent recall of past information based on meaning rather than keywords.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| query | Search query | str | Yes |
+| trigger | An unused field that is used to (re-)trigger the block when you have no other inputs | bool | No |
+| categories_filter | Categories to filter by | List[str] | No |
+| metadata_filter | Optional metadata filters to apply | Dict[str, Any] | No |
+| limit_memory_to_run | Limit the memory to the run | bool | No |
+| limit_memory_to_agent | Limit the memory to the agent | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| memories | List of matching memories | Memories |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Contextual Recall**: Search for memories related to a user's current question to provide informed, contextual responses.
+
+**Knowledge Retrieval**: Find previously stored facts or insights that are relevant to a new task or decision.
+
+**Conversation History**: Search past interactions to recall what was discussed about a specific topic or person.
+<!-- END MANUAL -->
+
+---
+
+## Store Value
+
+### What it is
+A basic block that stores and forwards a value throughout workflows, allowing it to be reused without changes across multiple blocks.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+It accepts an input value and optionally a data value. If a data value is provided, it is used as the output. Otherwise, the input value is used as the output.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| input | Trigger the block to produce the output. The value is only used when `data` is None. | Input | Yes |
+| data | The constant data to be retained in the block. This value is passed as `output`. | Data | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| output | The stored data retained in the block. | Output |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Storing a user's name at the beginning of a workflow to use it in multiple subsequent blocks without asking for it again.
+<!-- END MANUAL -->
+
+---
+
+## Universal Type Converter
+
+### What it is
+This block is used to convert a value to a universal type.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block converts values between common data types: string, number, boolean, list, and dictionary. It handles type coercion intelligently—for example, converting the string "true" to boolean true, or the string "42" to the number 42.
+
+This is useful when data from different sources needs to be in a consistent type for processing, comparison, or API requirements.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| value | The value to convert to a universal type. | Value | Yes |
+| type | The type to convert the value to. | "string" \| "number" \| "boolean" \| "list" \| "dictionary" | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| value | The converted value. | Value |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**API Compatibility**: Convert string inputs to numbers or booleans as required by specific API parameters.
+
+**User Input Processing**: Transform user-entered text values into appropriate types for calculations or logic.
+
+**Data Normalization**: Standardize mixed-type data from various sources into consistent types for processing.
+<!-- END MANUAL -->
+
+---
+
+## XML Parser
+
+### What it is
+Parses XML using gravitasml to tokenize and coverts it to dict
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block parses XML content and converts it into a dictionary structure that can be easily navigated and processed in workflows. It uses the gravitasml library to tokenize the XML and produces a nested dictionary matching the XML hierarchy.
+
+This makes XML data accessible using standard dictionary operations, allowing you to extract values, iterate over elements, and process XML-based API responses or data files.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| input_xml | input xml to be parsed | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error in parsing | str |
+| parsed_xml | output parsed xml to dict | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**API Response Processing**: Parse XML responses from SOAP APIs or legacy systems to extract the data you need.
+
+**Configuration File Reading**: Read XML configuration files and convert them to dictionaries for easy access.
+
+**Data Import**: Transform XML data exports from other systems into a format suitable for your workflow processing.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/content/platform/blocks/branching.md b/docs/integrations/branching.md
similarity index 100%
rename from docs/content/platform/blocks/branching.md
rename to docs/integrations/branching.md
diff --git a/docs/integrations/compass/triggers.md b/docs/integrations/compass/triggers.md
new file mode 100644
index 0000000000..802dad1aad
--- /dev/null
+++ b/docs/integrations/compass/triggers.md
@@ -0,0 +1,34 @@
+# Compass Triggers
+<!-- MANUAL: file_description -->
+Blocks for triggering workflows from Compass AI transcription events.
+<!-- END MANUAL -->
+
+## Compass AI Trigger
+
+### What it is
+This block will output the contents of the compass transcription.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block triggers when a Compass AI transcription is received. It outputs the transcription text content, enabling workflows that process voice input or meeting transcripts from Compass AI.
+
+The transcription is output as a string for downstream processing, analysis, or storage.
+<!-- END MANUAL -->
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| transcription | The contents of the compass transcription. | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Voice Command Processing**: Trigger workflows from voice commands transcribed by Compass AI.
+
+**Meeting Automation**: Process meeting transcripts to extract action items or summaries.
+
+**Transcription Analysis**: Analyze transcribed content for sentiment, topics, or key information.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/content/platform/blocks/csv.md b/docs/integrations/csv.md
similarity index 100%
rename from docs/content/platform/blocks/csv.md
rename to docs/integrations/csv.md
diff --git a/docs/integrations/data.md b/docs/integrations/data.md
new file mode 100644
index 0000000000..73abef5a6b
--- /dev/null
+++ b/docs/integrations/data.md
@@ -0,0 +1,285 @@
+# Data
+<!-- MANUAL: file_description -->
+Blocks for creating, reading, and manipulating data structures including lists, dictionaries, spreadsheets, and persistent storage.
+<!-- END MANUAL -->
+
+## Create Dictionary
+
+### What it is
+Creates a dictionary with the specified key-value pairs. Use this when you know all the values you want to add upfront.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a new dictionary from specified key-value pairs in a single operation. It's designed for cases where you know all the data upfront, rather than building the dictionary incrementally.
+
+The block takes a dictionary input and outputs it as-is, making it useful as a starting point for workflows that need to pass structured data between blocks.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| values | Key-value pairs to create the dictionary with | Dict[str, Any] | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if dictionary creation failed | str |
+| dictionary | The created dictionary containing the specified key-value pairs | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**API Request Payloads**: Create complete request body objects with all required fields before sending to an API.
+
+**Configuration Objects**: Build settings dictionaries with predefined values for initializing services or workflows.
+
+**Data Mapping**: Transform input data into a structured format with specific keys expected by downstream blocks.
+<!-- END MANUAL -->
+
+---
+
+## Create List
+
+### What it is
+Creates a list with the specified values. Use this when you know all the values you want to add upfront. This block can also yield the list in batches based on a maximum size or token limit.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a list from provided values and can optionally chunk it into smaller batches. When max_size is set, the list is yielded in chunks of that size. When max_tokens is set, chunks are sized to fit within token limits for LLM processing.
+
+This batching capability is particularly useful when processing large datasets that need to be split for API limits or memory constraints.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| values | A list of values to be combined into a new list. | List[Any] | Yes |
+| max_size | Maximum size of the list. If provided, the list will be yielded in chunks of this size. | int | No |
+| max_tokens | Maximum tokens for the list. If provided, the list will be yielded in chunks that fit within this token limit. | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| list | The created list containing the specified values. | List[Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Batch Processing**: Split large datasets into manageable chunks for API calls with rate limits.
+
+**LLM Token Management**: Divide text content into token-limited batches for processing by language models.
+
+**Parallel Processing**: Create batches of work items that can be processed concurrently by multiple blocks.
+<!-- END MANUAL -->
+
+---
+
+## File Read
+
+### What it is
+Reads a file and returns its content as a string, with optional chunking by delimiter and size limits
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block reads file content from various sources (URL, data URI, or local path) and returns it as a string. It supports chunking via delimiter (like newlines) or size limits, yielding content in manageable pieces.
+
+Use skip_rows and skip_size to skip header content or initial bytes. When delimiter and limits are set, content is yielded chunk by chunk, enabling processing of large files without loading everything into memory.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| file_input | The file to read from (URL, data URI, or local path) | str (file) | Yes |
+| delimiter | Delimiter to split the content into rows/chunks (e.g., '\n' for lines) | str | No |
+| size_limit | Maximum size in bytes per chunk to yield (0 for no limit) | int | No |
+| row_limit | Maximum number of rows to process (0 for no limit, requires delimiter) | int | No |
+| skip_size | Number of characters to skip from the beginning of the file | int | No |
+| skip_rows | Number of rows to skip from the beginning (requires delimiter) | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| content | File content, yielded as individual chunks when delimiter or size limits are applied | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Log File Processing**: Read and process log files line by line, filtering or transforming each entry.
+
+**Large Document Analysis**: Read large text files in chunks for summarization or analysis without memory issues.
+
+**Data Import**: Read text-based data files and process them row by row for database import.
+<!-- END MANUAL -->
+
+---
+
+## Persist Information
+
+### What it is
+Persist key-value information for the current user
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block stores key-value data that persists across workflow runs. You can scope the persistence to either within_agent (available to all runs of this specific agent) or across_agents (available to all agents for this user).
+
+The stored data remains available until explicitly overwritten, enabling state management and configuration persistence between workflow executions.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| key | Key to store the information under | str | Yes |
+| value | Value to store | Value | Yes |
+| scope | Scope of persistence: within_agent (shared across all runs of this agent) or across_agents (shared across all agents for this user) | "within_agent" \| "across_agents" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| value | Value that was stored | Value |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**User Preferences**: Store user settings like preferred language or notification preferences for future runs.
+
+**Progress Tracking**: Save the last processed item ID to resume batch processing where you left off.
+
+**API Token Caching**: Store refreshed API tokens that can be reused across multiple workflow executions.
+<!-- END MANUAL -->
+
+---
+
+## Read Spreadsheet
+
+### What it is
+Reads CSV and Excel files and outputs the data as a list of dictionaries and individual rows. Excel files are automatically converted to CSV format.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block parses CSV and Excel files, converting each row into a dictionary with column headers as keys. Excel files are automatically converted to CSV format before processing.
+
+Configure delimiter, quote character, and escape character for proper CSV parsing. Use skip_rows to ignore headers or initial rows, and skip_columns to exclude unwanted columns from the output.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| contents | The contents of the CSV/spreadsheet data to read | str | No |
+| file_input | CSV or Excel file to read from (URL, data URI, or local path). Excel files are automatically converted to CSV | str (file) | No |
+| delimiter | The delimiter used in the CSV/spreadsheet data | str | No |
+| quotechar | The character used to quote fields | str | No |
+| escapechar | The character used to escape the delimiter | str | No |
+| has_header | Whether the CSV file has a header row | bool | No |
+| skip_rows | The number of rows to skip from the start of the file | int | No |
+| strip | Whether to strip whitespace from the values | bool | No |
+| skip_columns | The columns to skip from the start of the row | List[str] | No |
+| produce_singular_result | If True, yield individual 'row' outputs only (can be slow). If False, yield both 'rows' (all data) | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| row | The data produced from each row in the spreadsheet | Dict[str, str] |
+| rows | All the data in the spreadsheet as a list of rows | List[Dict[str, str]] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Data Import**: Import product catalogs, contact lists, or inventory data from spreadsheet exports.
+
+**Report Processing**: Parse generated CSV reports from other systems for analysis or transformation.
+
+**Bulk Operations**: Process spreadsheets of email addresses, user records, or configuration data row by row.
+<!-- END MANUAL -->
+
+---
+
+## Retrieve Information
+
+### What it is
+Retrieve key-value information for the current user
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves previously stored key-value data for the current user. Specify the key and scope to fetch the corresponding value. If the key doesn't exist, the default_value is returned.
+
+Use within_agent scope for agent-specific data or across_agents for data shared across all user agents.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| key | Key to retrieve the information for | str | Yes |
+| scope | Scope of persistence: within_agent (shared across all runs of this agent) or across_agents (shared across all agents for this user) | "within_agent" \| "across_agents" | No |
+| default_value | Default value to return if key is not found | Default Value | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| value | Retrieved value or default value | Value |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Resume Processing**: Retrieve the last processed item ID to continue batch operations from where you left off.
+
+**Load Preferences**: Fetch stored user preferences at workflow start to customize behavior.
+
+**State Restoration**: Retrieve workflow state saved from a previous run to maintain continuity.
+<!-- END MANUAL -->
+
+---
+
+## Screenshot Web Page
+
+### What it is
+Takes a screenshot of a specified website using ScreenshotOne API
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the ScreenshotOne API to capture screenshots of web pages. Configure viewport dimensions, output format, and whether to capture the full page or just the visible area.
+
+Optional features include blocking ads, cookie banners, and chat widgets for cleaner screenshots. Caching can be enabled to improve performance for repeated captures of the same page.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| url | URL of the website to screenshot | str | Yes |
+| viewport_width | Width of the viewport in pixels | int | No |
+| viewport_height | Height of the viewport in pixels | int | No |
+| full_page | Whether to capture the full page length | bool | No |
+| format | Output format (png, jpeg, webp) | "png" \| "jpeg" \| "webp" | No |
+| block_ads | Whether to block ads | bool | No |
+| block_cookie_banners | Whether to block cookie banners | bool | No |
+| block_chats | Whether to block chat widgets | bool | No |
+| cache | Whether to enable caching | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| image | The screenshot image data | str (file) |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Visual Documentation**: Capture screenshots of web pages for documentation, reports, or archives.
+
+**Competitive Monitoring**: Regularly screenshot competitor websites to track design and content changes.
+
+**Visual Testing**: Capture page renders for visual regression testing or design verification workflows.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/dataforseo/keyword_suggestions.md b/docs/integrations/dataforseo/keyword_suggestions.md
new file mode 100644
index 0000000000..3500f7e434
--- /dev/null
+++ b/docs/integrations/dataforseo/keyword_suggestions.md
@@ -0,0 +1,91 @@
+# Dataforseo Keyword Suggestions
+<!-- MANUAL: file_description -->
+Blocks for getting keyword suggestions with search volume and competition metrics from DataForSEO.
+<!-- END MANUAL -->
+
+## Data For Seo Keyword Suggestions
+
+### What it is
+Get keyword suggestions from DataForSEO Labs Google API
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block calls the DataForSEO Labs Google Keyword Suggestions API to generate keyword ideas based on a seed keyword. It provides search volume, competition metrics, CPC data, and keyword difficulty scores for each suggestion.
+
+Configure location and language targeting to get region-specific results. Optional SERP and clickstream data provide additional insights into search behavior and click patterns.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| keyword | Seed keyword to get suggestions for | str | Yes |
+| location_code | Location code for targeting (e.g., 2840 for USA) | int | No |
+| language_code | Language code (e.g., 'en' for English) | str | No |
+| include_seed_keyword | Include the seed keyword in results | bool | No |
+| include_serp_info | Include SERP information | bool | No |
+| include_clickstream_data | Include clickstream metrics | bool | No |
+| limit | Maximum number of results (up to 3000) | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| suggestions | List of keyword suggestions with metrics | List[KeywordSuggestion] |
+| suggestion | A single keyword suggestion with metrics | KeywordSuggestion |
+| total_count | Total number of suggestions returned | int |
+| seed_keyword | The seed keyword used for the query | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Planning**: Generate blog post and article ideas based on keyword suggestions with high search volume.
+
+**SEO Strategy**: Discover new keyword opportunities to target based on competition and difficulty metrics.
+
+**PPC Campaigns**: Find keywords for advertising campaigns using CPC and competition data.
+<!-- END MANUAL -->
+
+---
+
+## Keyword Suggestion Extractor
+
+### What it is
+Extract individual fields from a KeywordSuggestion object
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block extracts individual fields from a KeywordSuggestion object returned by the Keyword Suggestions block. It decomposes the suggestion into separate outputs for easier use in workflows.
+
+Each field including keyword text, search volume, competition level, CPC, difficulty score, and optional SERP/clickstream data becomes available as individual outputs for downstream processing.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| suggestion | The keyword suggestion object to extract fields from | KeywordSuggestion | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| keyword | The keyword suggestion | str |
+| search_volume | Monthly search volume | int |
+| competition | Competition level (0-1) | float |
+| cpc | Cost per click in USD | float |
+| keyword_difficulty | Keyword difficulty score | int |
+| serp_info | data from SERP for each keyword | Dict[str, Any] |
+| clickstream_data | Clickstream data metrics | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Keyword Filtering**: Extract search volume and difficulty to filter keywords meeting specific thresholds.
+
+**Data Analysis**: Access individual metrics for comparison, sorting, or custom scoring algorithms.
+
+**Report Generation**: Pull specific fields like CPC and competition for SEO or PPC reports.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/dataforseo/related_keywords.md b/docs/integrations/dataforseo/related_keywords.md
new file mode 100644
index 0000000000..c5dab36467
--- /dev/null
+++ b/docs/integrations/dataforseo/related_keywords.md
@@ -0,0 +1,92 @@
+# Dataforseo Related Keywords
+<!-- MANUAL: file_description -->
+Blocks for finding semantically related keywords using the DataForSEO Labs API.
+<!-- END MANUAL -->
+
+## Data For Seo Related Keywords
+
+### What it is
+Get related keywords from DataForSEO Labs Google API
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the DataForSEO Labs Google Related Keywords API to find semantically related keywords based on a seed keyword. It returns keywords that share similar search intent or topic relevance.
+
+The depth parameter controls the breadth of the search, with higher values returning exponentially more related keywords. Results include search metrics, competition data, and optional SERP/clickstream information.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| keyword | Seed keyword to find related keywords for | str | Yes |
+| location_code | Location code for targeting (e.g., 2840 for USA) | int | No |
+| language_code | Language code (e.g., 'en' for English) | str | No |
+| include_seed_keyword | Include the seed keyword in results | bool | No |
+| include_serp_info | Include SERP information | bool | No |
+| include_clickstream_data | Include clickstream metrics | bool | No |
+| limit | Maximum number of results (up to 3000) | int | No |
+| depth | Keyword search depth (0-4). Controls the number of returned keywords: 0=1 keyword, 1=~8 keywords, 2=~72 keywords, 3=~584 keywords, 4=~4680 keywords | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| related_keywords | List of related keywords with metrics | List[RelatedKeyword] |
+| related_keyword | A related keyword with metrics | RelatedKeyword |
+| total_count | Total number of related keywords returned | int |
+| seed_keyword | The seed keyword used for the query | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Topic Clustering**: Group related keywords to build comprehensive content clusters around a topic.
+
+**Semantic SEO**: Discover LSI (latent semantic indexing) keywords to improve content relevance.
+
+**Keyword Expansion**: Expand targeting beyond exact match to capture related search traffic.
+<!-- END MANUAL -->
+
+---
+
+## Related Keyword Extractor
+
+### What it is
+Extract individual fields from a RelatedKeyword object
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block extracts individual fields from a RelatedKeyword object returned by the Related Keywords block. It separates the compound object into distinct outputs for workflow integration.
+
+Outputs include the keyword text, search volume, competition score, CPC, keyword difficulty, and any SERP or clickstream data that was requested in the original search.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| related_keyword | The related keyword object to extract fields from | RelatedKeyword | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| keyword | The related keyword | str |
+| search_volume | Monthly search volume | int |
+| competition | Competition level (0-1) | float |
+| cpc | Cost per click in USD | float |
+| keyword_difficulty | Keyword difficulty score | int |
+| serp_info | SERP data for the keyword | Dict[str, Any] |
+| clickstream_data | Clickstream data metrics | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Keyword Prioritization**: Extract metrics to rank related keywords by opportunity score.
+
+**Content Optimization**: Access keyword difficulty and search volume for content planning decisions.
+
+**Competitive Analysis**: Pull competition and CPC data to assess keyword viability.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/content/platform/blocks/decoder_block.md b/docs/integrations/decoder_block.md
similarity index 100%
rename from docs/content/platform/blocks/decoder_block.md
rename to docs/integrations/decoder_block.md
diff --git a/docs/content/platform/blocks/discord.md b/docs/integrations/discord.md
similarity index 100%
rename from docs/content/platform/blocks/discord.md
rename to docs/integrations/discord.md
diff --git a/docs/integrations/discord/bot_blocks.md b/docs/integrations/discord/bot_blocks.md
new file mode 100644
index 0000000000..978cdd021e
--- /dev/null
+++ b/docs/integrations/discord/bot_blocks.md
@@ -0,0 +1,358 @@
+# Discord Bot Blocks
+<!-- MANUAL: file_description -->
+Blocks for interacting with Discord using bot tokens, including sending messages, managing threads, and reading channel data.
+<!-- END MANUAL -->
+
+## Create Discord Thread
+
+### What it is
+Creates a new thread in a Discord channel.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Discord API with a bot token to create a new thread in a specified channel. Threads can be public or private (private requires Boost Level 2+).
+
+Configure auto-archive duration and optionally send an initial message when the thread is created.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| channel_name | Channel ID or channel name to create the thread in | str | Yes |
+| server_name | Server name (only needed if using channel name) | str | No |
+| thread_name | The name of the thread to create | str | Yes |
+| is_private | Whether to create a private thread (requires Boost Level 2+) or public thread | bool | No |
+| auto_archive_duration | Duration before the thread is automatically archived | "60" \| "1440" \| "4320" \| "10080" | No |
+| message_content | Optional initial message to send in the thread | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| status | Operation status | str |
+| thread_id | ID of the created thread | str |
+| thread_name | Name of the created thread | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Support Tickets**: Create threads for individual support conversations to keep channels organized.
+
+**Discussion Topics**: Automatically create threads for new topics or announcements.
+
+**Project Channels**: Spin up discussion threads for specific tasks or features.
+<!-- END MANUAL -->
+
+---
+
+## Discord Channel Info
+
+### What it is
+Resolves Discord channel names to IDs and vice versa.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block resolves Discord channel identifiers, converting between channel names and IDs. It queries the Discord API to find the channel and returns comprehensive information including server details.
+
+Useful for workflows that receive channel names but need IDs for other Discord operations.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| channel_identifier | Channel name or channel ID to look up | str | Yes |
+| server_name | Server name (optional, helps narrow down search) | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| channel_id | The channel's ID | str |
+| channel_name | The channel's name | str |
+| server_id | The server's ID | str |
+| server_name | The server's name | str |
+| channel_type | Type of channel (text, voice, etc) | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Dynamic Routing**: Look up channel IDs to route messages to user-specified channels by name.
+
+**Validation**: Verify channel existence before attempting to send messages.
+
+**Workflow Setup**: Get channel details during workflow configuration.
+<!-- END MANUAL -->
+
+---
+
+## Discord User Info
+
+### What it is
+Gets information about a Discord user by their ID.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves information about a Discord user by their ID. It queries the Discord API and returns profile details including username, display name, avatar, and account creation date.
+
+The user must be visible to your bot (share a server with your bot).
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| user_id | The Discord user ID to get information about | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| user_id | The user's ID (passed through for chaining) | str |
+| username | The user's username | str |
+| display_name | The user's display name | str |
+| discriminator | The user's discriminator (if applicable) | str |
+| avatar_url | URL to the user's avatar | str |
+| is_bot | Whether the user is a bot | bool |
+| created_at | When the account was created | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**User Profiling**: Get user details to personalize responses or create user profiles.
+
+**Mention Resolution**: Look up user information when processing mentions in messages.
+
+**Activity Logging**: Retrieve user details for logging or analytics purposes.
+<!-- END MANUAL -->
+
+---
+
+## Read Discord Messages
+
+### What it is
+Reads messages from a Discord channel using a bot token.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block uses a Discord bot to log into a server and listen for new messages. When a message is received, it extracts the content, channel name, and username of the sender. If the message contains a text file attachment, the block also retrieves and includes the file's content.
+<!-- END MANUAL -->
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| message_content | The content of the message received | str |
+| message_id | The ID of the message | str |
+| channel_id | The ID of the channel | str |
+| channel_name | The name of the channel the message was received from | str |
+| user_id | The ID of the user who sent the message | str |
+| username | The username of the user who sent the message | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+This block could be used to monitor a Discord channel for support requests. When a user posts a message, the block captures it, allowing another part of the system to process and respond to the request.
+<!-- END MANUAL -->
+
+---
+
+## Reply To Discord Message
+
+### What it is
+Replies to a specific Discord message.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block sends a reply to a specific Discord message, creating a threaded reply that references the original message. Optionally mention the original author to notify them.
+
+The reply appears linked to the original message in Discord's UI, maintaining conversation context.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| channel_id | The channel ID where the message to reply to is located | str | Yes |
+| message_id | The ID of the message to reply to | str | Yes |
+| reply_content | The content of the reply | str | Yes |
+| mention_author | Whether to mention the original message author | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| status | Operation status | str |
+| reply_id | ID of the reply message | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Conversation Bots**: Reply to user questions maintaining conversation context.
+
+**Support Responses**: Respond to support requests by replying to the original message.
+
+**Interactive Commands**: Reply to command messages with results or confirmations.
+<!-- END MANUAL -->
+
+---
+
+## Send Discord DM
+
+### What it is
+Sends a direct message to a Discord user using their user ID.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block sends a direct message to a Discord user. It opens a DM channel with the user (if not already open) and sends the message. The user must allow DMs from server members or share a server with your bot.
+
+Returns the message ID of the sent DM for tracking purposes.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| user_id | The Discord user ID to send the DM to (e.g., '123456789012345678') | str | Yes |
+| message_content | The content of the direct message to send | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| status | The status of the operation | str |
+| message_id | The ID of the sent message | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Private Notifications**: Send private alerts or notifications to specific users.
+
+**Welcome Messages**: DM new server members with welcome information.
+
+**Verification Systems**: Send verification codes or instructions via DM.
+<!-- END MANUAL -->
+
+---
+
+## Send Discord Embed
+
+### What it is
+Sends a rich embed message to a Discord channel.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block sends a rich embed message to a Discord channel. Embeds support formatted content with titles, descriptions, colors, images, thumbnails, author sections, footers, and structured fields.
+
+Configure the embed's appearance with colors, images, and multiple fields for organized information display.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| channel_identifier | Channel ID or channel name to send the embed to | str | Yes |
+| server_name | Server name (only needed if using channel name) | str | No |
+| title | The title of the embed | str | No |
+| description | The main content/description of the embed | str | No |
+| color | Embed color as integer (e.g., 0x00ff00 for green) | int | No |
+| thumbnail_url | URL for the thumbnail image | str | No |
+| image_url | URL for the main embed image | str | No |
+| author_name | Author name to display | str | No |
+| footer_text | Footer text | str | No |
+| fields | List of field dictionaries with 'name', 'value', and optional 'inline' keys | List[Dict[str, Any]] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| status | Operation status | str |
+| message_id | ID of the sent embed message | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Status Updates**: Send formatted status updates with colors and structured information.
+
+**Data Displays**: Present data in organized embed fields for easy reading.
+
+**Announcements**: Create visually appealing announcements with images and branding.
+<!-- END MANUAL -->
+
+---
+
+## Send Discord File
+
+### What it is
+Sends a file attachment to a Discord channel.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uploads and sends a file attachment to a Discord channel. It supports various file types including images, documents, and other media. Files can be provided as URLs, data URIs, or local paths.
+
+Optionally include a message along with the file attachment.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| channel_identifier | Channel ID or channel name to send the file to | str | Yes |
+| server_name | Server name (only needed if using channel name) | str | No |
+| file | The file to send (URL, data URI, or local path). Supports images, videos, documents, etc. | str (file) | Yes |
+| filename | Name of the file when sent (e.g., 'report.pdf', 'image.png') | str | No |
+| message_content | Optional message to send with the file | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| status | Operation status | str |
+| message_id | ID of the sent message | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Report Sharing**: Send generated reports or documents to Discord channels.
+
+**Image Posting**: Share images from workflows or external sources.
+
+**Backup Distribution**: Share backup files or exports with team channels.
+<!-- END MANUAL -->
+
+---
+
+## Send Discord Message
+
+### What it is
+Sends a message to a Discord channel using a bot token.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block uses a Discord bot to log into a server, locate the specified channel, and send the provided message. If the message is longer than Discord's character limit, it automatically splits the message into smaller chunks and sends them sequentially.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| message_content | The content of the message to send | str | Yes |
+| channel_name | Channel ID or channel name to send the message to | str | Yes |
+| server_name | Server name (only needed if using channel name) | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| status | The status of the operation (e.g., 'Message sent', 'Error') | str |
+| message_id | The ID of the sent message | str |
+| channel_id | The ID of the channel where the message was sent | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+This block could be used as part of an automated notification system. For example, it could send alerts to a Discord channel when certain events occur in another system, such as when a new user signs up or when a critical error is detected.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/discord/oauth_blocks.md b/docs/integrations/discord/oauth_blocks.md
new file mode 100644
index 0000000000..bd402ca51f
--- /dev/null
+++ b/docs/integrations/discord/oauth_blocks.md
@@ -0,0 +1,38 @@
+# Discord OAuth Blocks
+<!-- MANUAL: file_description -->
+Blocks for Discord OAuth2 authentication and retrieving user information.
+<!-- END MANUAL -->
+
+## Discord Get Current User
+
+### What it is
+Gets information about the currently authenticated Discord user using OAuth2 credentials.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Discord's OAuth2 API to retrieve information about the currently authenticated user. It requires valid OAuth2 credentials that have been obtained through Discord's authorization flow with the `identify` scope.
+
+The block queries the Discord `/users/@me` endpoint and returns the user's profile information including their unique ID, username, avatar, and customization settings like banner and accent color.
+<!-- END MANUAL -->
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| user_id | The authenticated user's Discord ID | str |
+| username | The user's username | str |
+| avatar_url | URL to the user's avatar image | str |
+| banner_url | URL to the user's banner image (if set) | str |
+| accent_color | The user's accent color as an integer | int |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**User Authentication**: Verify user identity after OAuth login to personalize experiences or grant access.
+
+**Profile Integration**: Display Discord user information in external applications or dashboards.
+
+**Account Linking**: Connect Discord accounts with other services using the unique user ID.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/content/platform/blocks/email_block.md b/docs/integrations/email_block.md
similarity index 100%
rename from docs/content/platform/blocks/email_block.md
rename to docs/integrations/email_block.md
diff --git a/docs/integrations/enrichlayer/linkedin.md b/docs/integrations/enrichlayer/linkedin.md
new file mode 100644
index 0000000000..5e2f14c34b
--- /dev/null
+++ b/docs/integrations/enrichlayer/linkedin.md
@@ -0,0 +1,164 @@
+# Enrichlayer LinkedIn
+<!-- MANUAL: file_description -->
+Blocks for enriching LinkedIn profile data and looking up profiles using the Enrichlayer API.
+<!-- END MANUAL -->
+
+## Get Linkedin Profile
+
+### What it is
+Fetch LinkedIn profile data using Enrichlayer
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves comprehensive LinkedIn profile data using Enrichlayer's API. Provide a LinkedIn profile URL to fetch details including work history, education, skills, and contact information.
+
+Configure caching options for performance and optionally include additional data like inferred salary, personal email, or social media links.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| linkedin_url | LinkedIn profile URL to fetch data from | str | Yes |
+| fallback_to_cache | Cache usage if live fetch fails | "on-error" \| "never" | No |
+| use_cache | Cache utilization strategy | "if-present" \| "never" | No |
+| include_skills | Include skills data | bool | No |
+| include_inferred_salary | Include inferred salary data | bool | No |
+| include_personal_email | Include personal email | bool | No |
+| include_personal_contact_number | Include personal contact number | bool | No |
+| include_social_media | Include social media profiles | bool | No |
+| include_extra | Include additional data | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| profile | LinkedIn profile data | PersonProfileResponse |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Lead Enrichment**: Enrich sales leads with detailed professional background information.
+
+**Recruitment Research**: Gather candidate information for hiring and outreach workflows.
+
+**Contact Discovery**: Find contact details associated with LinkedIn profiles.
+<!-- END MANUAL -->
+
+---
+
+## Get Linkedin Profile Picture
+
+### What it is
+Get LinkedIn profile pictures using Enrichlayer
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves the profile picture URL for a LinkedIn profile using Enrichlayer's API. Provide the LinkedIn profile URL to get a direct link to the user's profile photo.
+
+The returned URL can be used for display, download, or further image processing.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| linkedin_profile_url | LinkedIn profile URL | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| profile_picture_url | LinkedIn profile picture URL | str (file) |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**CRM Enhancement**: Add profile photos to contact records for visual identification.
+
+**Personalized Outreach**: Include profile pictures in personalized email or message templates.
+
+**Identity Verification**: Retrieve profile photos for manual identity verification workflows.
+<!-- END MANUAL -->
+
+---
+
+## Linkedin Person Lookup
+
+### What it is
+Look up LinkedIn profiles by person information using Enrichlayer
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block finds LinkedIn profiles by matching person details like name, company, and title using Enrichlayer's API. Provide first name and company domain as minimum inputs, with optional last name, location, and title for better matching.
+
+Enable similarity checks and profile enrichment for more detailed results.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| first_name | Person's first name | str | Yes |
+| last_name | Person's last name | str | No |
+| company_domain | Domain of the company they work for (optional) | str | Yes |
+| location | Person's location (optional) | str | No |
+| title | Person's job title (optional) | str | No |
+| include_similarity_checks | Include similarity checks | bool | No |
+| enrich_profile | Enrich the profile with additional data | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| lookup_result | LinkedIn profile lookup result | PersonLookupResponse |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Lead Discovery**: Find LinkedIn profiles for leads when you only have name and company.
+
+**Contact Matching**: Match CRM contacts to their LinkedIn profiles for enrichment.
+
+**Prospecting**: Discover LinkedIn profiles of people at target companies.
+<!-- END MANUAL -->
+
+---
+
+## Linkedin Role Lookup
+
+### What it is
+Look up LinkedIn profiles by role in a company using Enrichlayer
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block finds LinkedIn profiles by role title and company using Enrichlayer's API. Specify a role like CEO, CTO, or VP of Sales along with the company name to find matching profiles.
+
+Enable enrich_profile to automatically fetch full profile data for the matched result.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| role | Role title (e.g., CEO, CTO) | str | Yes |
+| company_name | Name of the company | str | Yes |
+| enrich_profile | Enrich the profile with additional data | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| role_lookup_result | LinkedIn role lookup result | RoleLookupResponse |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Decision Maker Discovery**: Find key decision makers at target companies for sales outreach.
+
+**Executive Research**: Look up C-suite executives for account-based marketing.
+
+**Org Chart Building**: Map leadership at companies by looking up specific roles.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/exa/answers.md b/docs/integrations/exa/answers.md
new file mode 100644
index 0000000000..ae1994ef8b
--- /dev/null
+++ b/docs/integrations/exa/answers.md
@@ -0,0 +1,43 @@
+# Exa Answers
+<!-- MANUAL: file_description -->
+Blocks for getting AI-generated answers to questions using Exa's search-informed answer API.
+<!-- END MANUAL -->
+
+## Exa Answer
+
+### What it is
+Get an LLM answer to a question informed by Exa search results
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block sends your question to the Exa Answer API, which performs a semantic search across billions of web pages to find relevant information. The API then uses an LLM to synthesize the search results into a coherent answer with citations.
+
+The block returns both the generated answer and the source citations that informed it. You can optionally include full text content from the search results for more comprehensive answers.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| query | The question or query to answer | str | Yes |
+| text | Include full text content in the search results used for the answer | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the request failed | str |
+| answer | The generated answer based on search results | str |
+| citations | Search results used to generate the answer | List[AnswerCitation] |
+| citation | Individual citation from the answer | AnswerCitation |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Research Assistance**: Get quick, sourced answers to complex questions without manually searching multiple websites.
+
+**Fact Verification**: Verify claims or statements by getting answers backed by real web sources with citations.
+
+**Content Creation**: Generate research-backed content by asking questions about topics and using the cited sources.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/exa/code_context.md b/docs/integrations/exa/code_context.md
new file mode 100644
index 0000000000..90079c5b3b
--- /dev/null
+++ b/docs/integrations/exa/code_context.md
@@ -0,0 +1,47 @@
+# Exa Code Context
+<!-- MANUAL: file_description -->
+Blocks for searching code repositories and documentation using Exa's code context API.
+<!-- END MANUAL -->
+
+## Exa Code Context
+
+### What it is
+Search billions of GitHub repos, docs, and Stack Overflow for relevant code examples
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Exa's specialized code search API to find relevant code examples from GitHub repositories, official documentation, and Stack Overflow. The search is optimized for code context, returning formatted snippets with source references.
+
+The block returns code snippets along with metadata including the source URL, search time, and token counts. You can control response size with the tokens_num parameter to balance comprehensiveness with cost.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| query | Search query to find relevant code snippets. Describe what you're trying to do or what code you're looking for. | str | Yes |
+| tokens_num | Token limit for response. Use 'dynamic' for automatic sizing, 5000 for standard queries, or 10000 for comprehensive examples. | str \| int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| request_id | Unique identifier for this request | str |
+| query | The search query used | str |
+| response | Formatted code snippets and contextual examples with sources | str |
+| results_count | Number of code sources found and included | int |
+| cost_dollars | Cost of this request in dollars | str |
+| search_time | Time taken to search in milliseconds | float |
+| output_tokens | Number of tokens in the response | int |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**API Integration Examples**: Find real-world code examples showing how to integrate with specific APIs or libraries.
+
+**Debugging Assistance**: Search for code patterns related to error messages or specific programming challenges.
+
+**Learning New Technologies**: Discover implementation examples when learning a new framework or programming language.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/exa/contents.md b/docs/integrations/exa/contents.md
new file mode 100644
index 0000000000..7dece2536f
--- /dev/null
+++ b/docs/integrations/exa/contents.md
@@ -0,0 +1,54 @@
+# Exa Contents
+<!-- MANUAL: file_description -->
+Blocks for retrieving and extracting content from web pages using Exa's contents API.
+<!-- END MANUAL -->
+
+## Exa Contents
+
+### What it is
+Retrieves document contents using Exa's contents API
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves full content from web pages using Exa's contents API. You can provide URLs directly or document IDs from previous searches. The API supports live crawling to fetch fresh content and can extract text, highlights, and AI-generated summaries.
+
+The block supports subpage crawling to gather related content and offers various content retrieval options including full text extraction, relevant highlights, and customizable summary generation. Results are formatted for easy use with LLMs.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| urls | Array of URLs to crawl (preferred over 'ids') | List[str] | No |
+| ids | [DEPRECATED - use 'urls' instead] Array of document IDs obtained from searches | List[str] | No |
+| text | Retrieve text content from pages | bool | No |
+| highlights | Text snippets most relevant from each page | HighlightSettings | No |
+| summary | LLM-generated summary of the webpage | SummarySettings | No |
+| livecrawl | Livecrawling options: never, fallback (default), always, preferred | "never" \| "fallback" \| "always" \| "preferred" | No |
+| livecrawl_timeout | Timeout for livecrawling in milliseconds | int | No |
+| subpages | Number of subpages to crawl | int | No |
+| subpage_target | Keyword(s) to find specific subpages of search results | str \| List[str] | No |
+| extras | Extra parameters for additional content | ExtrasSettings | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the request failed | str |
+| results | List of document contents with metadata | List[ExaSearchResults] |
+| result | Single document content result | ExaSearchResults |
+| context | A formatted string of the results ready for LLMs | str |
+| request_id | Unique identifier for the request | str |
+| statuses | Status information for each requested URL | List[ContentStatus] |
+| cost_dollars | Cost breakdown for the request | CostDollars |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Aggregation**: Retrieve full article content from multiple URLs for analysis or summarization.
+
+**Competitive Research**: Crawl competitor websites to extract product information, pricing, or feature details.
+
+**Data Enrichment**: Fetch detailed content from URLs discovered through Exa searches to build comprehensive datasets.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/exa/research.md b/docs/integrations/exa/research.md
new file mode 100644
index 0000000000..67f05052d0
--- /dev/null
+++ b/docs/integrations/exa/research.md
@@ -0,0 +1,186 @@
+# Exa Research
+<!-- MANUAL: file_description -->
+Blocks for creating and managing autonomous research tasks using Exa's Research API.
+<!-- END MANUAL -->
+
+## Exa Create Research
+
+### What it is
+Create research task with optional waiting - explores web and synthesizes findings with citations
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates an asynchronous research task using Exa's Research API. The API autonomously explores the web, searches for relevant information, and synthesizes findings into a comprehensive report with citations.
+
+You can choose from different model tiers (fast, standard, pro) depending on your speed vs. depth requirements. The block supports structured output via JSON Schema and can optionally wait for completion to return results immediately.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| instructions | Research instructions - clearly define what information to find, how to conduct research, and desired output format. | str | Yes |
+| model | Research model: 'fast' for quick results, 'standard' for balanced quality, 'pro' for thorough analysis | "exa-research-fast" \| "exa-research" \| "exa-research-pro" | No |
+| output_schema | JSON Schema to enforce structured output. When provided, results are validated and returned as parsed JSON. | Dict[str, Any] | No |
+| wait_for_completion | Wait for research to complete before returning. Ensures you get results immediately. | bool | No |
+| polling_timeout | Maximum time to wait for completion in seconds (only if wait_for_completion is True) | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| research_id | Unique identifier for tracking this research request | str |
+| status | Final status of the research | str |
+| model | The research model used | str |
+| instructions | The research instructions provided | str |
+| created_at | When the research was created (Unix timestamp in ms) | int |
+| output_content | Research output as text (only if wait_for_completion was True and completed) | str |
+| output_parsed | Structured JSON output (only if wait_for_completion and outputSchema were provided) | Dict[str, Any] |
+| cost_total | Total cost in USD (only if wait_for_completion was True and completed) | float |
+| elapsed_time | Time taken to complete in seconds (only if wait_for_completion was True) | float |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Market Research**: Automatically research market trends, competitors, or industry developments with cited sources.
+
+**Due Diligence**: Conduct comprehensive background research on companies, people, or technologies.
+
+**Content Research**: Gather research on topics for articles, reports, or presentations with proper citations.
+<!-- END MANUAL -->
+
+---
+
+## Exa Get Research
+
+### What it is
+Get status and results of a research task
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves the current status and results of a previously created research task. You can check whether the research is still running, completed, or failed.
+
+When the research is complete, the block returns the full output content along with cost breakdown including searches performed, pages crawled, and tokens used. You can also optionally retrieve the detailed event log of research operations.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| research_id | The ID of the research task to retrieve | str | Yes |
+| include_events | Include detailed event log of research operations | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| research_id | The research task identifier | str |
+| status | Current status: pending, running, completed, canceled, or failed | str |
+| instructions | The original research instructions | str |
+| model | The research model used | str |
+| created_at | When research was created (Unix timestamp in ms) | int |
+| finished_at | When research finished (Unix timestamp in ms, if completed/canceled/failed) | int |
+| output_content | Research output as text (if completed) | str |
+| output_parsed | Structured JSON output matching outputSchema (if provided and completed) | Dict[str, Any] |
+| cost_total | Total cost in USD (if completed) | float |
+| cost_searches | Number of searches performed (if completed) | int |
+| cost_pages | Number of pages crawled (if completed) | int |
+| cost_reasoning_tokens | AI tokens used for reasoning (if completed) | int |
+| error_message | Error message if research failed | str |
+| events | Detailed event log (if include_events was True) | List[Dict[str, Any]] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Status Monitoring**: Check progress of long-running research tasks that were started asynchronously.
+
+**Result Retrieval**: Fetch completed research results from tasks started earlier in your workflow.
+
+**Cost Tracking**: Review the cost breakdown of completed research for budgeting and optimization.
+<!-- END MANUAL -->
+
+---
+
+## Exa List Research
+
+### What it is
+List all research tasks with pagination support
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves a list of all your research tasks, ordered by creation time with newest first. It supports pagination for handling large numbers of tasks.
+
+The block returns basic information about each task including its ID, status, instructions, and timestamps. Use this to find specific research tasks or monitor all ongoing research activities.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| cursor | Cursor for pagination through results | str | No |
+| limit | Number of research tasks to return (1-50) | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| research_tasks | List of research tasks ordered by creation time (newest first) | List[ResearchTaskModel] |
+| research_task | Individual research task (yielded for each task) | ResearchTaskModel |
+| has_more | Whether there are more tasks to paginate through | bool |
+| next_cursor | Cursor for the next page of results | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Research Management**: View all active and completed research tasks for project management.
+
+**Task Discovery**: Find previously created research tasks to retrieve their results or check status.
+
+**Activity Auditing**: Review research activity history for compliance or reporting purposes.
+<!-- END MANUAL -->
+
+---
+
+## Exa Wait For Research
+
+### What it is
+Wait for a research task to complete with configurable timeout
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block polls a research task until it completes or times out. It periodically checks the task status at configurable intervals and returns the final results when done.
+
+The block is useful when you need to block workflow execution until research completes. It returns whether the operation timed out, allowing you to handle incomplete research gracefully.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| research_id | The ID of the research task to wait for | str | Yes |
+| timeout | Maximum time to wait in seconds | int | No |
+| check_interval | Seconds between status checks | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| research_id | The research task identifier | str |
+| final_status | Final status when polling stopped | str |
+| output_content | Research output as text (if completed) | str |
+| output_parsed | Structured JSON output (if outputSchema was provided and completed) | Dict[str, Any] |
+| cost_total | Total cost in USD | float |
+| elapsed_time | Total time waited in seconds | float |
+| timed_out | Whether polling timed out before completion | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Sequential Workflows**: Ensure research completes before proceeding to dependent workflow steps.
+
+**Synchronous Integration**: Convert asynchronous research into synchronous operations for simpler workflow logic.
+
+**Timeout Handling**: Implement research with graceful timeout handling for time-sensitive applications.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/exa/search.md b/docs/integrations/exa/search.md
new file mode 100644
index 0000000000..e7ddbe02fd
--- /dev/null
+++ b/docs/integrations/exa/search.md
@@ -0,0 +1,59 @@
+# Exa Search
+<!-- MANUAL: file_description -->
+Blocks for searching the web using Exa's advanced neural and keyword search API.
+<!-- END MANUAL -->
+
+## Exa Search
+
+### What it is
+Searches the web using Exa's advanced search API
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Exa's advanced search API to find web content. Unlike traditional search engines, Exa offers neural search that understands semantic meaning, making it excellent for finding specific types of content. You can choose between keyword search (traditional), neural search (semantic understanding), or fast search.
+
+The block supports powerful filtering by domain, date ranges, content categories (companies, research papers, news, etc.), and text patterns. Results include URLs, titles, and optionally full content extraction.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| query | The search query | str | Yes |
+| type | Type of search | "keyword" \| "neural" \| "fast" \| "auto" | No |
+| category | Category to search within: company, research paper, news, pdf, github, tweet, personal site, linkedin profile, financial report | "company" \| "research paper" \| "news" \| "pdf" \| "github" \| "tweet" \| "personal site" \| "linkedin profile" \| "financial report" | No |
+| user_location | The two-letter ISO country code of the user (e.g., 'US') | str | No |
+| number_of_results | Number of results to return | int | No |
+| include_domains | Domains to include in search | List[str] | No |
+| exclude_domains | Domains to exclude from search | List[str] | No |
+| start_crawl_date | Start date for crawled content | str (date-time) | No |
+| end_crawl_date | End date for crawled content | str (date-time) | No |
+| start_published_date | Start date for published content | str (date-time) | No |
+| end_published_date | End date for published content | str (date-time) | No |
+| include_text | Text patterns to include | List[str] | No |
+| exclude_text | Text patterns to exclude | List[str] | No |
+| contents | Content retrieval settings | ContentSettings | No |
+| moderation | Enable content moderation to filter unsafe content from search results | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the request failed | str |
+| results | List of search results | List[ExaSearchResults] |
+| result | Single search result | ExaSearchResults |
+| context | A formatted string of the search results ready for LLMs. | str |
+| search_type | For auto searches, indicates which search type was selected. | str |
+| resolved_search_type | The search type that was actually used for this request (neural or keyword) | str |
+| cost_dollars | Cost breakdown for the request | CostDollars |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Competitive Research**: Search for companies in a specific industry, filtered by recent news or funding announcements.
+
+**Content Curation**: Find relevant articles and research papers on specific topics for newsletters or content aggregation.
+
+**Lead Generation**: Search for companies matching specific criteria (industry, size, recent activity) for sales prospecting.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/exa/similar.md b/docs/integrations/exa/similar.md
new file mode 100644
index 0000000000..f768c549f0
--- /dev/null
+++ b/docs/integrations/exa/similar.md
@@ -0,0 +1,55 @@
+# Exa Similar
+<!-- MANUAL: file_description -->
+Blocks for finding semantically similar web pages using Exa's findSimilar API.
+<!-- END MANUAL -->
+
+## Exa Find Similar
+
+### What it is
+Finds similar links using Exa's findSimilar API
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Exa's findSimilar API to discover web pages that are semantically similar to a given URL. The API analyzes the content and context of the provided page to find related content across the web.
+
+The block supports filtering by domains, date ranges, and text patterns to refine results. You can retrieve content directly with results and enable content moderation to filter unsafe content.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| url | The url for which you would like to find similar links | str | Yes |
+| number_of_results | Number of results to return | int | No |
+| include_domains | List of domains to include in the search. If specified, results will only come from these domains. | List[str] | No |
+| exclude_domains | Domains to exclude from search | List[str] | No |
+| start_crawl_date | Start date for crawled content | str (date-time) | No |
+| end_crawl_date | End date for crawled content | str (date-time) | No |
+| start_published_date | Start date for published content | str (date-time) | No |
+| end_published_date | End date for published content | str (date-time) | No |
+| include_text | Text patterns to include (max 1 string, up to 5 words) | List[str] | No |
+| exclude_text | Text patterns to exclude (max 1 string, up to 5 words) | List[str] | No |
+| contents | Content retrieval settings | ContentSettings | No |
+| moderation | Enable content moderation to filter unsafe content from search results | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the request failed | str |
+| results | List of similar documents with metadata and content | List[ExaSearchResults] |
+| result | Single similar document result | ExaSearchResults |
+| context | A formatted string of the results ready for LLMs. | str |
+| request_id | Unique identifier for the request | str |
+| cost_dollars | Cost breakdown for the request | CostDollars |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Discovery**: Find related articles, blog posts, or resources similar to content you already like.
+
+**Competitor Analysis**: Discover similar companies or products by finding pages similar to known competitors.
+
+**Research Expansion**: Expand your research by finding additional sources similar to key reference materials.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/exa/webhook_blocks.md b/docs/integrations/exa/webhook_blocks.md
new file mode 100644
index 0000000000..2c6c312d2a
--- /dev/null
+++ b/docs/integrations/exa/webhook_blocks.md
@@ -0,0 +1,46 @@
+# Exa Webhook Blocks
+<!-- MANUAL: file_description -->
+Blocks for receiving webhook notifications from Exa webset events.
+<!-- END MANUAL -->
+
+## Exa Webset Webhook
+
+### What it is
+Receive webhook notifications for Exa webset events
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block acts as a webhook receiver for Exa webset events. When events occur on your websets (like new items found, searches completed, or enrichments finished), Exa sends notifications to this webhook endpoint.
+
+The block can filter events by webset ID and event type. It parses incoming webhook payloads and outputs structured event data including the event type, affected webset, and event-specific details.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The webset ID to monitor (optional, monitors all if empty) | str | No |
+| event_filter | Configure which events to receive | WebsetEventFilter | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| event_type | Type of event that occurred | str |
+| event_id | Unique identifier for this event | str |
+| webset_id | ID of the affected webset | str |
+| data | Event-specific data | Dict[str, Any] |
+| timestamp | When the event occurred | str |
+| metadata | Additional event metadata | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Real-Time Processing**: Trigger workflows automatically when new items are added to websets without polling.
+
+**Alert Systems**: Receive instant notifications when webset searches find new relevant results.
+
+**Integration Pipelines**: Build event-driven integrations that react to webset changes in real time.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/exa/websets.md b/docs/integrations/exa/websets.md
new file mode 100644
index 0000000000..d3b3870e0e
--- /dev/null
+++ b/docs/integrations/exa/websets.md
@@ -0,0 +1,484 @@
+# Exa Websets
+<!-- MANUAL: file_description -->
+Blocks for creating and managing Exa websets for continuous web monitoring.
+<!-- END MANUAL -->
+
+## Exa Cancel Webset
+
+### What it is
+Cancel all operations being performed on a Webset
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block cancels all running operations (searches, enrichments) on a webset. The webset transitions to an idle state and any in-progress operations are stopped.
+
+The block is useful for stopping long-running operations that are no longer needed or when you need to modify the webset configuration. Items already processed before cancellation are retained.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset to cancel | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| webset_id | The unique identifier for the webset | str |
+| status | The status of the webset after cancellation | str |
+| external_id | The external identifier for the webset | str |
+| success | Whether the cancellation was successful | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Resource Management**: Stop expensive operations on websets that are no longer needed.
+
+**Configuration Updates**: Cancel operations before making changes to webset settings.
+
+**Error Recovery**: Stop problematic operations and restart with corrected parameters.
+<!-- END MANUAL -->
+
+---
+
+## Exa Create Or Find Webset
+
+### What it is
+Create a new webset or return existing one by external_id (idempotent operation)
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block implements idempotent webset creation using an external ID. If a webset with the given external_id already exists, it returns that webset. Otherwise, it creates a new one.
+
+This pattern prevents duplicate websets when workflows retry or run multiple times. The block indicates whether the webset was newly created or already existed.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| external_id | External identifier for this webset - used to find existing or create new | str | Yes |
+| search_query | Search query (optional - only needed if creating new webset) | str | No |
+| search_count | Number of items to find in initial search | int | No |
+| metadata | Key-value pairs to associate with the webset | Dict[str, Any] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| webset | The webset (existing or newly created) | Webset |
+| was_created | True if webset was newly created, False if it already existed | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Idempotent Workflows**: Safely re-run workflows without creating duplicate websets.
+
+**External System Integration**: Map websets to IDs from your own systems for easy reference.
+
+**Retry-Safe Operations**: Handle workflow retries gracefully by reusing existing websets.
+<!-- END MANUAL -->
+
+---
+
+## Exa Create Webset
+
+### What it is
+Create a new Exa Webset for persistent web search collections with optional waiting for initial results
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a new Exa Webset, a persistent collection that stores web search results. You define a search query, entity type, and optional criteria that items must meet. The webset continuously evaluates potential matches against your criteria.
+
+The block supports advanced features like scoped searches (searching within specific imports or other websets), enrichments for extracting structured data, and relationship-based "hop" searches. You can wait for initial results or return immediately for asynchronous processing.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| search_query | Your search query. Use this to describe what you are looking for. Any URL provided will be crawled and used as context for the search. | str | Yes |
+| search_count | Number of items the search will attempt to find. The actual number of items found may be less than this number depending on the search complexity. | int | No |
+| search_entity_type | Entity type: 'company', 'person', 'article', 'research_paper', or 'custom'. If not provided, we automatically detect the entity from the query. | "company" \| "person" \| "article" \| "research_paper" \| "custom" \| "auto" | No |
+| search_entity_description | Description for custom entity type (required when search_entity_type is 'custom') | str | No |
+| search_criteria | List of criteria descriptions that every item will be evaluated against. If not provided, we automatically detect the criteria from the query. | List[str] | No |
+| search_exclude_sources | List of source IDs (imports or websets) to exclude from search results | List[str] | No |
+| search_exclude_types | List of source types corresponding to exclude sources ('import' or 'webset') | List["import" \| "webset"] | No |
+| search_scope_sources | List of source IDs (imports or websets) to limit search scope to | List[str] | No |
+| search_scope_types | List of source types corresponding to scope sources ('import' or 'webset') | List["import" \| "webset"] | No |
+| search_scope_relationships | List of relationship definitions for hop searches (optional, one per scope source) | List[str] | No |
+| search_scope_relationship_limits | List of limits on the number of related entities to find (optional, one per scope relationship) | List[int] | No |
+| import_sources | List of source IDs to import from | List[str] | No |
+| import_types | List of source types corresponding to import sources ('import' or 'webset') | List["import" \| "webset"] | No |
+| enrichment_descriptions | List of enrichment task descriptions to perform on each webset item | List[str] | No |
+| enrichment_formats | List of formats for enrichment responses ('text', 'date', 'number', 'options', 'email', 'phone'). If not specified, we automatically select the best format. | List["text" \| "date" \| "number" \| "options" \| "email" \| "phone"] | No |
+| enrichment_options | List of option lists for enrichments with 'options' format. Each inner list contains the option labels. | List[List[str]] | No |
+| enrichment_metadata | List of metadata dictionaries for enrichments | List[Dict[str, Any]] | No |
+| external_id | External identifier for the webset. You can use this to reference the webset by your own internal identifiers. | str | No |
+| metadata | Key-value pairs to associate with this webset | Dict[str, Any] | No |
+| wait_for_initial_results | Wait for the initial search to complete before returning. This ensures you get results immediately. | bool | No |
+| polling_timeout | Maximum time to wait for completion in seconds (only used if wait_for_initial_results is True) | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| webset | The created webset with full details | Webset |
+| initial_item_count | Number of items found in the initial search (only if wait_for_initial_results was True) | int |
+| completion_time | Time taken to complete the initial search in seconds (only if wait_for_initial_results was True) | float |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Lead Generation**: Create websets to find companies or people matching specific criteria for sales outreach.
+
+**Competitive Intelligence**: Build persistent collections tracking competitors, market entrants, or industry news.
+
+**Research Databases**: Compile curated collections of articles, papers, or resources on specific topics.
+<!-- END MANUAL -->
+
+---
+
+## Exa Delete Webset
+
+### What it is
+Delete a Webset and all its items
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block permanently deletes a webset and all of its items, searches, enrichments, and monitors. The operation cannot be undone.
+
+Use this to clean up websets that are no longer needed or to remove test data. The block accepts either the Exa-generated ID or your custom external_id.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset to delete | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| webset_id | The unique identifier for the deleted webset | str |
+| external_id | The external identifier for the deleted webset | str |
+| status | The status of the deleted webset | str |
+| success | Whether the deletion was successful | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Cleanup Operations**: Remove completed or abandoned websets to maintain organization.
+
+**Data Management**: Delete websets containing outdated or irrelevant data.
+
+**Cost Control**: Remove unused websets to prevent unnecessary storage costs.
+<!-- END MANUAL -->
+
+---
+
+## Exa Get Webset
+
+### What it is
+Retrieve a Webset by ID or external ID
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves detailed information about a specific webset including its status, configured searches, enrichments, and monitors.
+
+The block returns the webset's current state, metadata, and timestamps. Use this to check webset configuration or monitor status before performing operations.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset to retrieve | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| webset_id | The unique identifier for the webset | str |
+| status | The status of the webset | str |
+| external_id | The external identifier for the webset | str |
+| searches | The searches performed on the webset | List[Dict[str, Any]] |
+| enrichments | The enrichments applied to the webset | List[Dict[str, Any]] |
+| monitors | The monitors for the webset | List[Dict[str, Any]] |
+| metadata | Key-value pairs associated with the webset | Dict[str, Any] |
+| created_at | The date and time the webset was created | str |
+| updated_at | The date and time the webset was last updated | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Configuration Review**: Retrieve webset details to verify settings before making changes.
+
+**Status Checking**: Check the current status and configuration of a webset.
+
+**Workflow Integration**: Fetch webset information for use in downstream workflow steps.
+<!-- END MANUAL -->
+
+---
+
+## Exa List Websets
+
+### What it is
+List all Websets with pagination support
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves a paginated list of all your websets. Results include basic webset information and can be paginated through using cursor tokens.
+
+Use this to discover existing websets, find specific websets by browsing, or build management interfaces for your webset collections.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| trigger | Trigger for the webset, value is ignored! | Any | No |
+| cursor | Cursor for pagination through results | str | No |
+| limit | Number of websets to return (1-100) | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| websets | List of websets | List[Webset] |
+| has_more | Whether there are more results to paginate through | bool |
+| next_cursor | Cursor for the next page of results | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Inventory Management**: List all websets to understand your current data collections.
+
+**Bulk Operations**: Iterate through websets to perform batch updates or cleanup.
+
+**Dashboard Building**: Retrieve webset listings for management dashboards or reporting.
+<!-- END MANUAL -->
+
+---
+
+## Exa Preview Webset
+
+### What it is
+Preview how a search query will be interpreted before creating a webset. Helps understand entity detection, criteria generation, and available enrichments.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block analyzes your search query and shows how Exa will interpret it before you create a webset. It reveals the detected entity type, generated criteria, and available enrichment columns.
+
+Use this to refine your query and understand what results to expect. The block also provides suggestions for improving your query for better results.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| query | Your search query to preview. Use this to see how Exa will interpret your search before creating a webset. | str | Yes |
+| entity_type | Entity type to force: 'company', 'person', 'article', 'research_paper', or 'custom'. If not provided, Exa will auto-detect. | "company" \| "person" \| "article" \| "research_paper" \| "custom" \| "auto" | No |
+| entity_description | Description for custom entity type (required when entity_type is 'custom') | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| preview | Full preview response with search and enrichment details | PreviewWebsetModel |
+| entity_type | The detected or specified entity type | str |
+| entity_description | Description of the entity type | str |
+| criteria | Generated search criteria that will be used | List[PreviewCriterionModel] |
+| enrichment_columns | Available enrichment columns that can be extracted | List[PreviewEnrichmentModel] |
+| interpretation | Human-readable interpretation of how the query will be processed | str |
+| suggestions | Suggestions for improving the query | List[str] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Query Optimization**: Test and refine search queries before committing to webset creation.
+
+**Entity Validation**: Verify that Exa correctly detects the entity type for your use case.
+
+**Enrichment Planning**: Discover available enrichment columns to plan data extraction.
+<!-- END MANUAL -->
+
+---
+
+## Exa Update Webset
+
+### What it is
+Update metadata for an existing Webset
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block updates the metadata associated with an existing webset. Metadata is stored as key-value pairs and can be used to organize, tag, or annotate websets.
+
+Setting metadata to null clears all existing metadata. This operation does not affect the webset's items, searches, or enrichments.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset to update | str | Yes |
+| metadata | Key-value pairs to associate with this webset (set to null to clear) | Dict[str, Any] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| webset_id | The unique identifier for the webset | str |
+| status | The status of the webset | str |
+| external_id | The external identifier for the webset | str |
+| metadata | Updated metadata for the webset | Dict[str, Any] |
+| updated_at | The date and time the webset was updated | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Tagging Systems**: Add tags or labels to websets for organization and filtering.
+
+**Project Association**: Link websets to specific projects or campaigns via metadata.
+
+**Workflow State**: Store workflow-related state or flags in webset metadata.
+<!-- END MANUAL -->
+
+---
+
+## Exa Webset Ready Check
+
+### What it is
+Check if webset is ready for next operation - enables conditional workflow branching
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block checks if a webset is idle (no running operations) and optionally has a minimum number of items. It returns a boolean ready status along with a recommendation for the next action.
+
+Use this block for conditional workflow branching to decide whether to proceed with processing, wait for more results, or add additional searches.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset to check | str | Yes |
+| min_items | Minimum number of items required to be 'ready' | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| is_ready | True if webset is idle AND has minimum items | bool |
+| status | Current webset status | str |
+| item_count | Number of items in webset | int |
+| has_searches | Whether webset has any searches configured | bool |
+| has_enrichments | Whether webset has any enrichments | bool |
+| recommendation | Suggested next action (ready_to_process, waiting_for_results, needs_search, etc.) | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Workflow Gating**: Only proceed with data processing when webset has enough items.
+
+**Conditional Branching**: Route workflow based on webset readiness for different scenarios.
+
+**Polling Logic**: Implement smart polling by checking readiness before fetching items.
+<!-- END MANUAL -->
+
+---
+
+## Exa Webset Status
+
+### What it is
+Get a quick status overview of a webset
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block returns a lightweight status overview of a webset without retrieving full item data. It includes counts for items, searches, enrichments, and monitors along with the current processing status.
+
+Use this for quick status checks and monitoring without the overhead of retrieving complete webset details or items.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| webset_id | The webset identifier | str |
+| status | Current status (idle, running, paused, etc.) | str |
+| item_count | Total number of items in the webset | int |
+| search_count | Number of searches performed | int |
+| enrichment_count | Number of enrichments configured | int |
+| monitor_count | Number of monitors configured | int |
+| last_updated | When the webset was last updated | str |
+| is_processing | Whether any operations are currently running | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Status Dashboards**: Display webset status in monitoring dashboards.
+
+**Health Checks**: Verify websets are active and processing as expected.
+
+**Lightweight Polling**: Check status without fetching full webset data.
+<!-- END MANUAL -->
+
+---
+
+## Exa Webset Summary
+
+### What it is
+Get a comprehensive summary of a webset with samples and statistics
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block generates a comprehensive summary of a webset including statistics, sample items, and detailed breakdowns of searches and enrichments. It provides an overview useful for reporting and analysis.
+
+You can control what to include in the summary such as sample items, search details, and enrichment details to balance comprehensiveness with response size.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset | str | Yes |
+| include_sample_items | Include sample items in the summary | bool | No |
+| sample_size | Number of sample items to include | int | No |
+| include_search_details | Include details about searches | bool | No |
+| include_enrichment_details | Include details about enrichments | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| webset_id | The webset identifier | str |
+| status | Current status | str |
+| entity_type | Type of entities in the webset | str |
+| total_items | Total number of items | int |
+| sample_items | Sample items from the webset | List[Dict[str, Any]] |
+| search_summary | Summary of searches performed | SearchSummaryModel |
+| enrichment_summary | Summary of enrichments applied | EnrichmentSummaryModel |
+| monitor_summary | Summary of monitors configured | MonitorSummaryModel |
+| statistics | Various statistics about the webset | WebsetStatisticsModel |
+| created_at | When the webset was created | str |
+| updated_at | When the webset was last updated | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Executive Reporting**: Generate summaries of webset collections for stakeholder reports.
+
+**Quality Review**: Review sample items and statistics to assess webset quality.
+
+**Progress Tracking**: Monitor webset growth and activity through periodic summaries.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/exa/websets_enrichment.md b/docs/integrations/exa/websets_enrichment.md
new file mode 100644
index 0000000000..016ded5010
--- /dev/null
+++ b/docs/integrations/exa/websets_enrichment.md
@@ -0,0 +1,226 @@
+# Exa Websets Enrichment
+<!-- MANUAL: file_description -->
+Blocks for enriching webset items with additional data using Exa's enrichment API.
+<!-- END MANUAL -->
+
+## Exa Cancel Enrichment
+
+### What it is
+Cancel a running enrichment operation
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block stops a running enrichment operation on a webset. Items already enriched before cancellation retain their enrichment data, but remaining items will not be processed.
+
+Use this when an enrichment is taking too long, producing unexpected results, or is no longer needed. The block returns the approximate number of items enriched before cancellation.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset | str | Yes |
+| enrichment_id | The ID of the enrichment to cancel | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| enrichment_id | The ID of the canceled enrichment | str |
+| status | Status after cancellation | str |
+| items_enriched_before_cancel | Approximate number of items enriched before cancellation | int |
+| success | Whether the cancellation was successful | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Cost Control**: Stop enrichments that are exceeding budget or taking too long.
+
+**Error Handling**: Cancel enrichments producing incorrect results to fix configuration.
+
+**Priority Changes**: Stop lower-priority enrichments to free resources for urgent tasks.
+<!-- END MANUAL -->
+
+---
+
+## Exa Create Enrichment
+
+### What it is
+Create enrichments to extract additional structured data from webset items
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates an enrichment task that extracts specific data from each webset item using AI. You define what to extract via a description, and the enrichment runs against all current and future items in the webset.
+
+Enrichments support various output formats including text, dates, numbers, and predefined options. You can apply enrichments to existing items immediately or configure them to run only on new items.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset | str | Yes |
+| description | What data to extract from each item | str | Yes |
+| title | Short title for this enrichment (auto-generated if not provided) | str | No |
+| format | Expected format of the extracted data | "text" \| "date" \| "number" \| "options" \| "email" \| "phone" | No |
+| options | Available options when format is 'options' | List[str] | No |
+| apply_to_existing | Apply this enrichment to existing items in the webset | bool | No |
+| metadata | Metadata to attach to the enrichment | Dict[str, Any] | No |
+| wait_for_completion | Wait for the enrichment to complete on existing items | bool | No |
+| polling_timeout | Maximum time to wait for completion in seconds | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| enrichment_id | The unique identifier for the created enrichment | str |
+| webset_id | The webset this enrichment belongs to | str |
+| status | Current status of the enrichment | str |
+| title | Title of the enrichment | str |
+| description | Description of what data is extracted | str |
+| format | Format of the extracted data | str |
+| instructions | Generated instructions for the enrichment | str |
+| items_enriched | Number of items enriched (if wait_for_completion was True) | int |
+| completion_time | Time taken to complete in seconds (if wait_for_completion was True) | float |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Data Extraction**: Extract specific fields like founding dates, employee counts, or contact info from company profiles.
+
+**Classification**: Categorize items into predefined buckets using the options format.
+
+**Sentiment Analysis**: Analyze sentiment or tone from article content or reviews.
+<!-- END MANUAL -->
+
+---
+
+## Exa Delete Enrichment
+
+### What it is
+Delete an enrichment from a webset
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block removes an enrichment configuration from a webset. The enrichment will no longer be applied to new items, but existing enrichment data on items is not deleted.
+
+Use this to clean up enrichments that are no longer needed or to remove misconfigured enrichments before creating corrected ones.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset | str | Yes |
+| enrichment_id | The ID of the enrichment to delete | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| enrichment_id | The ID of the deleted enrichment | str |
+| success | Whether the deletion was successful | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Configuration Cleanup**: Remove enrichments that are no longer relevant to your data needs.
+
+**Reconfiguration**: Delete misconfigured enrichments before creating corrected replacements.
+
+**Cost Optimization**: Remove unnecessary enrichments to reduce processing costs on new items.
+<!-- END MANUAL -->
+
+---
+
+## Exa Get Enrichment
+
+### What it is
+Get the status and details of a webset enrichment
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves detailed information about a specific enrichment including its configuration, current status, and processing progress.
+
+Use this to monitor enrichment progress, verify configuration, or troubleshoot issues with enrichment results. Returns the full enrichment specification along with timestamps.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset | str | Yes |
+| enrichment_id | The ID of the enrichment to retrieve | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| enrichment_id | The unique identifier for the enrichment | str |
+| status | Current status of the enrichment | str |
+| title | Title of the enrichment | str |
+| description | Description of what data is extracted | str |
+| format | Format of the extracted data | str |
+| options | Available options (for 'options' format) | List[str] |
+| instructions | Generated instructions for the enrichment | str |
+| created_at | When the enrichment was created | str |
+| updated_at | When the enrichment was last updated | str |
+| metadata | Metadata attached to the enrichment | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Progress Monitoring**: Check enrichment status to monitor completion of large batch operations.
+
+**Configuration Verification**: Retrieve enrichment details to verify settings before making changes.
+
+**Debugging**: Investigate enrichment configuration when results don't match expectations.
+<!-- END MANUAL -->
+
+---
+
+## Exa Update Enrichment
+
+### What it is
+Update an existing enrichment configuration
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block modifies an existing enrichment's configuration. You can update the description, output format, available options, or metadata without recreating the enrichment.
+
+Changes apply to future items; existing enrichment data is not reprocessed unless you explicitly re-run the enrichment on existing items.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset | str | Yes |
+| enrichment_id | The ID of the enrichment to update | str | Yes |
+| description | New description for what data to extract | str | No |
+| format | New format for the extracted data | "text" \| "date" \| "number" \| "options" \| "email" \| "phone" | No |
+| options | New options when format is 'options' | List[str] | No |
+| metadata | New metadata to attach to the enrichment | Dict[str, Any] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| enrichment_id | The unique identifier for the enrichment | str |
+| status | Current status of the enrichment | str |
+| title | Title of the enrichment | str |
+| description | Updated description | str |
+| format | Updated format | str |
+| success | Whether the update was successful | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Refinement**: Improve enrichment descriptions based on initial results to get better extractions.
+
+**Option Updates**: Add or modify options for classification enrichments as needs evolve.
+
+**Metadata Management**: Update enrichment metadata for organization or tracking purposes.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/exa/websets_import_export.md b/docs/integrations/exa/websets_import_export.md
new file mode 100644
index 0000000000..af0934aabd
--- /dev/null
+++ b/docs/integrations/exa/websets_import_export.md
@@ -0,0 +1,222 @@
+# Exa Websets Import Export
+<!-- MANUAL: file_description -->
+Blocks for importing and exporting data with Exa websets.
+<!-- END MANUAL -->
+
+## Exa Create Import
+
+### What it is
+Import CSV data to use with websets for targeted searches
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates an import from CSV data that can be used as a source for webset searches. Imports allow you to bring your own data (like company lists or contact lists) and use them for scoped or exclusion searches.
+
+You specify the entity type and which columns contain identifiers and URLs. The import becomes available as a source that can be referenced when creating webset searches.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| title | Title for this import | str | Yes |
+| csv_data | CSV data to import (as a string) | str | Yes |
+| entity_type | Type of entities being imported | "company" \| "person" \| "article" \| "research_paper" \| "custom" | No |
+| entity_description | Description for custom entity type | str | No |
+| identifier_column | Column index containing the identifier (0-based) | int | No |
+| url_column | Column index containing URLs (optional) | int | No |
+| metadata | Metadata to attach to the import | Dict[str, Any] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| import_id | The unique identifier for the created import | str |
+| status | Current status of the import | str |
+| title | Title of the import | str |
+| count | Number of items in the import | int |
+| entity_type | Type of entities imported | str |
+| upload_url | Upload URL for CSV data (only if csv_data not provided in request) | str |
+| upload_valid_until | Expiration time for upload URL (only if upload_url is provided) | str |
+| created_at | When the import was created | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Customer Enrichment**: Import your customer list to find similar companies or related contacts.
+
+**Exclusion Lists**: Import existing leads to exclude from new prospecting searches.
+
+**Targeted Expansion**: Use imported data as a starting point for relationship-based searches.
+<!-- END MANUAL -->
+
+---
+
+## Exa Delete Import
+
+### What it is
+Delete an import
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block permanently deletes an import and its data. Any websets that reference this import for scoped or exclusion searches will no longer have access to it.
+
+Use this to clean up imports that are no longer needed or contain outdated data. The deletion cannot be undone.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| import_id | The ID of the import to delete | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| import_id | The ID of the deleted import | str |
+| success | Whether the deletion was successful | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Data Refresh**: Delete outdated imports before uploading updated versions.
+
+**Cleanup Operations**: Remove imports that are no longer used in any webset searches.
+
+**Compliance**: Delete imports containing data that needs to be removed for privacy compliance.
+<!-- END MANUAL -->
+
+---
+
+## Exa Export Webset
+
+### What it is
+Export webset data in JSON, CSV, or JSON Lines format
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block exports all items from a webset in your chosen format. You can include full content and enrichment data in the export, and limit the number of items exported.
+
+Supported formats include JSON for structured data, CSV for spreadsheet compatibility, and JSON Lines for streaming or large dataset processing.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset to export | str | Yes |
+| format | Export format | "json" \| "csv" \| "jsonl" | No |
+| include_content | Include full content in export | bool | No |
+| include_enrichments | Include enrichment data in export | bool | No |
+| max_items | Maximum number of items to export | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| export_data | Exported data in the requested format | str |
+| item_count | Number of items exported | int |
+| total_items | Total number of items in the webset | int |
+| truncated | Whether the export was truncated due to max_items limit | bool |
+| format | Format of the exported data | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**CRM Integration**: Export webset data as CSV to import into CRM or marketing automation systems.
+
+**Reporting**: Generate exports for analysis in spreadsheets or business intelligence tools.
+
+**Backup**: Create periodic exports of valuable webset data for archival purposes.
+<!-- END MANUAL -->
+
+---
+
+## Exa Get Import
+
+### What it is
+Get the status and details of an import
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves detailed information about an import including its status, item count, and configuration. Use this to check if an import is ready to use or to troubleshoot failed imports.
+
+The block returns upload status information if the import is pending data upload, or failure details if the import encountered errors.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| import_id | The ID of the import to retrieve | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| import_id | The unique identifier for the import | str |
+| status | Current status of the import | str |
+| title | Title of the import | str |
+| format | Format of the imported data | str |
+| entity_type | Type of entities imported | str |
+| count | Number of items imported | int |
+| upload_url | Upload URL for CSV data (if import not yet uploaded) | str |
+| upload_valid_until | Expiration time for upload URL (if applicable) | str |
+| failed_reason | Reason for failure (if applicable) | str |
+| failed_message | Detailed failure message (if applicable) | str |
+| created_at | When the import was created | str |
+| updated_at | When the import was last updated | str |
+| metadata | Metadata attached to the import | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Status Verification**: Check import status after upload to confirm data is ready for use.
+
+**Error Investigation**: Retrieve import details to understand why an import failed.
+
+**Audit Trail**: Review import configuration and metadata for documentation purposes.
+<!-- END MANUAL -->
+
+---
+
+## Exa List Imports
+
+### What it is
+List all imports with pagination support
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves a paginated list of all your imports. Results include basic information about each import such as title, status, and item count.
+
+Use this to discover existing imports that can be referenced in webset searches or to manage your import library.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| limit | Number of imports to return | int | No |
+| cursor | Cursor for pagination | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| imports | List of imports | List[Dict[str, Any]] |
+| import_item | Individual import (yielded for each import) | Dict[str, Any] |
+| has_more | Whether there are more imports to paginate through | bool |
+| next_cursor | Cursor for the next page of results | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Import Discovery**: Find existing imports to reference when creating new webset searches.
+
+**Library Management**: Review all imports to identify outdated data that can be cleaned up.
+
+**Source Selection**: Browse available imports when setting up scoped or exclusion searches.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/exa/websets_items.md b/docs/integrations/exa/websets_items.md
new file mode 100644
index 0000000000..0992d914b3
--- /dev/null
+++ b/docs/integrations/exa/websets_items.md
@@ -0,0 +1,254 @@
+# Exa Websets Items
+<!-- MANUAL: file_description -->
+Blocks for retrieving and managing items within Exa websets.
+<!-- END MANUAL -->
+
+## Exa Bulk Webset Items
+
+### What it is
+Get all items from a webset in bulk (with configurable limits)
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves all items from a webset in a single operation, automatically handling pagination internally. You can specify a maximum number of items and choose whether to include enrichments and full content.
+
+Use this for batch processing when you need all webset data at once rather than paginating through results manually.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset | str | Yes |
+| max_items | Maximum number of items to retrieve (1-1000). Note: Large values may take longer. | int | No |
+| include_enrichments | Include enrichment data for each item | bool | No |
+| include_content | Include full content for each item | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| items | All items from the webset | List[WebsetItemModel] |
+| item | Individual item (yielded for each item) | WebsetItemModel |
+| total_retrieved | Total number of items retrieved | int |
+| truncated | Whether results were truncated due to max_items limit | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Batch Processing**: Retrieve all webset items for bulk analysis or processing in external systems.
+
+**Data Export**: Get complete webset data for integration with other tools or databases.
+
+**Full Dataset Analysis**: Analyze entire webset contents when pagination isn't practical.
+<!-- END MANUAL -->
+
+---
+
+## Exa Delete Webset Item
+
+### What it is
+Delete a specific item from a webset
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block permanently removes a specific item from a webset. The item and all its enrichment data are deleted and cannot be recovered.
+
+Use this to clean up irrelevant results, remove duplicates, or curate webset contents by removing items that don't meet your quality standards.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset | str | Yes |
+| item_id | The ID of the item to delete | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| item_id | The ID of the deleted item | str |
+| success | Whether the deletion was successful | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Data Curation**: Remove irrelevant or low-quality items to improve webset accuracy.
+
+**Duplicate Removal**: Delete duplicate entries discovered during review.
+
+**Compliance**: Remove items that shouldn't be included for legal or policy reasons.
+<!-- END MANUAL -->
+
+---
+
+## Exa Get New Items
+
+### What it is
+Get items added since a cursor - enables incremental processing without reprocessing
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves only items added to a webset since your last check, identified by a cursor. This enables efficient incremental processing without re-fetching previously processed items.
+
+Save the returned next_cursor for subsequent calls to implement continuous incremental processing of new webset additions.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset | str | Yes |
+| since_cursor | Cursor from previous run - only items after this will be returned. Leave empty on first run. | str | No |
+| max_items | Maximum number of new items to retrieve | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| new_items | Items added since the cursor | List[WebsetItemModel] |
+| item | Individual item (yielded for each new item) | WebsetItemModel |
+| count | Number of new items found | int |
+| next_cursor | Save this cursor for the next run to get only newer items | str |
+| has_more | Whether there are more new items beyond max_items | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Incremental Processing**: Process only new webset items in scheduled workflows without duplicating work.
+
+**Real-Time Pipelines**: Build efficient pipelines that react to new data without full dataset scans.
+
+**Change Detection**: Track what's new in websets for alerting or notification systems.
+<!-- END MANUAL -->
+
+---
+
+## Exa Get Webset Item
+
+### What it is
+Get a specific item from a webset by its ID
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves detailed information about a specific webset item including its content, entity data, and enrichments. Use this when you need complete data for a particular item.
+
+The block returns the full item record with all available data, timestamps, and any enrichment results that have been applied.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset | str | Yes |
+| item_id | The ID of the specific item to retrieve | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| item_id | The unique identifier for the item | str |
+| url | The URL of the original source | str |
+| title | The title of the item | str |
+| content | The main content of the item | str |
+| entity_data | Entity-specific structured data | Dict[str, Any] |
+| enrichments | Enrichment data added to the item | Dict[str, Any] |
+| created_at | When the item was added to the webset | str |
+| updated_at | When the item was last updated | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Detail View**: Fetch complete item data for display in detail views or profiles.
+
+**Enrichment Review**: Retrieve item with enrichments to verify data extraction quality.
+
+**Reference Lookup**: Get specific items by ID for cross-referencing or validation.
+<!-- END MANUAL -->
+
+---
+
+## Exa List Webset Items
+
+### What it is
+List items in a webset with pagination support
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves a paginated list of items from a webset. You control page size and can optionally wait for items if the webset is still processing.
+
+Use pagination cursors to iterate through large websets efficiently. Each page returns items along with metadata about whether more pages exist.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset | str | Yes |
+| limit | Number of items to return (1-100) | int | No |
+| cursor | Cursor for pagination through results | str | No |
+| wait_for_items | Wait for items to be available if webset is still processing | bool | No |
+| wait_timeout | Maximum time to wait for items in seconds | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| items | List of webset items | List[WebsetItemModel] |
+| webset_id | The ID of the webset | str |
+| item | Individual item (yielded for each item in the list) | WebsetItemModel |
+| has_more | Whether there are more items to paginate through | bool |
+| next_cursor | Cursor for the next page of results | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Paginated Display**: Build UIs that display webset items with pagination controls.
+
+**Streaming Processing**: Process webset items in manageable batches to avoid memory issues.
+
+**Controlled Iteration**: Step through large websets methodically for thorough analysis.
+<!-- END MANUAL -->
+
+---
+
+## Exa Webset Items Summary
+
+### What it is
+Get a summary of webset items without retrieving all data
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block provides a lightweight summary of webset items including total count, entity type, available enrichment columns, and optional sample items. It's efficient for getting an overview without fetching full data.
+
+Use this to understand webset contents at a glance, check enrichment availability, or get sample data for validation.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset | str | Yes |
+| sample_size | Number of sample items to include | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| total_items | Total number of items in the webset | int |
+| entity_type | Type of entities in the webset | str |
+| sample_items | Sample of items from the webset | List[WebsetItemModel] |
+| enrichment_columns | List of enrichment columns available | List[str] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Quick Overview**: Get webset statistics and samples without loading all data.
+
+**Schema Discovery**: Check what enrichment columns are available before building exports.
+
+**Validation**: Review sample items to verify webset quality before full processing.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/exa/websets_monitor.md b/docs/integrations/exa/websets_monitor.md
new file mode 100644
index 0000000000..65ac38ec1a
--- /dev/null
+++ b/docs/integrations/exa/websets_monitor.md
@@ -0,0 +1,227 @@
+# Exa Websets Monitor
+<!-- MANUAL: file_description -->
+Blocks for creating scheduled monitors to automatically update Exa websets.
+<!-- END MANUAL -->
+
+## Exa Create Monitor
+
+### What it is
+Create automated monitors to keep websets updated with fresh data on a schedule
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a scheduled monitor that automatically updates a webset on a cron schedule. Monitors can either search for new items matching criteria or refresh existing item content and enrichments.
+
+Configure the cron expression for your desired frequency (daily, weekly, etc.) and choose between search behavior to find new items or refresh behavior to update existing data.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset to monitor | str | Yes |
+| cron_expression | Cron expression for scheduling (5 fields, max once per day) | str | Yes |
+| timezone | IANA timezone for the schedule | str | No |
+| behavior_type | Type of monitor behavior (search for new items or refresh existing) | "search" \| "refresh" | No |
+| search_query | Search query for finding new items (required for search behavior) | str | No |
+| search_count | Number of items to find in each search | int | No |
+| search_criteria | Criteria that items must meet | List[str] | No |
+| search_behavior | How new results interact with existing items | "append" \| "override" | No |
+| entity_type | Type of entity to search for (company, person, etc.) | str | No |
+| refresh_content | Refresh content from source URLs (for refresh behavior) | bool | No |
+| refresh_enrichments | Re-run enrichments on items (for refresh behavior) | bool | No |
+| metadata | Metadata to attach to the monitor | Dict[str, Any] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| monitor_id | The unique identifier for the created monitor | str |
+| webset_id | The webset this monitor belongs to | str |
+| status | Status of the monitor | str |
+| behavior_type | Type of monitor behavior | str |
+| next_run_at | When the monitor will next run | str |
+| cron_expression | The schedule cron expression | str |
+| timezone | The timezone for scheduling | str |
+| created_at | When the monitor was created | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Continuous Lead Generation**: Schedule daily searches to find new companies matching your criteria.
+
+**News Monitoring**: Set up monitors to discover fresh articles on topics of interest.
+
+**Data Freshness**: Schedule periodic refreshes to keep enrichment data current.
+<!-- END MANUAL -->
+
+---
+
+## Exa Delete Monitor
+
+### What it is
+Delete a monitor from a webset
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block permanently deletes a monitor, stopping all future scheduled runs. Any data already collected by the monitor remains in the webset.
+
+Use this to clean up monitors that are no longer needed or to stop scheduled operations before deleting a webset.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| monitor_id | The ID of the monitor to delete | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| monitor_id | The ID of the deleted monitor | str |
+| success | Whether the deletion was successful | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Project Completion**: Delete monitors when monitoring campaigns or projects conclude.
+
+**Cost Management**: Remove monitors that are no longer providing value to reduce costs.
+
+**Configuration Cleanup**: Delete old monitors before creating updated replacements.
+<!-- END MANUAL -->
+
+---
+
+## Exa Get Monitor
+
+### What it is
+Get the details and status of a webset monitor
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves detailed information about a monitor including its configuration, schedule, current status, and information about the last run.
+
+Use this to verify monitor settings, check when the next run is scheduled, or review results from recent executions.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| monitor_id | The ID of the monitor to retrieve | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| monitor_id | The unique identifier for the monitor | str |
+| webset_id | The webset this monitor belongs to | str |
+| status | Current status of the monitor | str |
+| behavior_type | Type of monitor behavior | str |
+| behavior_config | Configuration for the monitor behavior | Dict[str, Any] |
+| cron_expression | The schedule cron expression | str |
+| timezone | The timezone for scheduling | str |
+| next_run_at | When the monitor will next run | str |
+| last_run | Information about the last run | Dict[str, Any] |
+| created_at | When the monitor was created | str |
+| updated_at | When the monitor was last updated | str |
+| metadata | Metadata attached to the monitor | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Schedule Verification**: Check when monitors are scheduled to run next.
+
+**Performance Review**: Examine last run details to assess monitor effectiveness.
+
+**Configuration Audit**: Retrieve monitor settings for documentation or troubleshooting.
+<!-- END MANUAL -->
+
+---
+
+## Exa List Monitors
+
+### What it is
+List all monitors with optional webset filtering
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves a paginated list of all monitors, optionally filtered by webset. Results include basic monitor information such as status, schedule, and next run time.
+
+Use this to get an overview of all active monitors or find monitors associated with a specific webset.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | Filter monitors by webset ID | str | No |
+| limit | Number of monitors to return | int | No |
+| cursor | Cursor for pagination | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| monitors | List of monitors | List[Dict[str, Any]] |
+| monitor | Individual monitor (yielded for each monitor) | Dict[str, Any] |
+| has_more | Whether there are more monitors to paginate through | bool |
+| next_cursor | Cursor for the next page of results | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Monitor Dashboard**: Build dashboards showing all active monitors and their schedules.
+
+**Webset Management**: Find monitors associated with websets before making changes.
+
+**Activity Overview**: Review all scheduled monitoring activity across your account.
+<!-- END MANUAL -->
+
+---
+
+## Exa Update Monitor
+
+### What it is
+Update a monitor's status, schedule, or metadata
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block modifies an existing monitor's configuration. You can enable, disable, or pause monitors, change their schedule, update the timezone, or modify metadata.
+
+Changes take effect immediately. Disabling a monitor stops future scheduled runs until re-enabled.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| monitor_id | The ID of the monitor to update | str | Yes |
+| status | New status for the monitor | "enabled" \| "disabled" \| "paused" | No |
+| cron_expression | New cron expression for scheduling | str | No |
+| timezone | New timezone for the schedule | str | No |
+| metadata | New metadata for the monitor | Dict[str, Any] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| monitor_id | The unique identifier for the monitor | str |
+| status | Updated status of the monitor | str |
+| next_run_at | When the monitor will next run | str |
+| updated_at | When the monitor was updated | str |
+| success | Whether the update was successful | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Schedule Changes**: Adjust monitor frequency based on data velocity or business needs.
+
+**Pause/Resume**: Temporarily pause monitors during maintenance or when not needed.
+
+**Status Management**: Enable or disable monitors programmatically based on conditions.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/exa/websets_polling.md b/docs/integrations/exa/websets_polling.md
new file mode 100644
index 0000000000..6212604095
--- /dev/null
+++ b/docs/integrations/exa/websets_polling.md
@@ -0,0 +1,143 @@
+# Exa Websets Polling
+<!-- MANUAL: file_description -->
+Blocks for polling and waiting on Exa webset operations to complete.
+<!-- END MANUAL -->
+
+## Exa Wait For Enrichment
+
+### What it is
+Wait for a webset enrichment to complete with progress tracking
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block polls an enrichment operation until it completes or times out. It checks status at configurable intervals and can include sample results when done.
+
+Use this to block workflow execution until enrichments finish, enabling sequential operations that depend on enrichment data being available.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset | str | Yes |
+| enrichment_id | The ID of the enrichment to monitor | str | Yes |
+| timeout | Maximum time to wait in seconds | int | No |
+| check_interval | Initial interval between status checks in seconds | int | No |
+| sample_results | Include sample enrichment results in output | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| enrichment_id | The enrichment ID that was monitored | str |
+| final_status | The final status of the enrichment | str |
+| items_enriched | Number of items successfully enriched | int |
+| enrichment_title | Title/description of the enrichment | str |
+| elapsed_time | Total time elapsed in seconds | float |
+| sample_data | Sample of enriched data (if requested) | List[SampleEnrichmentModel] |
+| timed_out | Whether the operation timed out | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Sequential Processing**: Wait for enrichments to complete before proceeding to export or analysis.
+
+**Data Validation**: Ensure enrichments finish and review samples before continuing workflow.
+
+**Synchronous Workflows**: Convert async enrichment operations to blocking calls for simpler logic.
+<!-- END MANUAL -->
+
+---
+
+## Exa Wait For Search
+
+### What it is
+Wait for a specific webset search to complete with progress tracking
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block polls a webset search operation until it completes or times out. It provides progress information including items found, items analyzed, and completion percentage.
+
+Use this when you need search results before proceeding with downstream operations like enrichments or exports.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset | str | Yes |
+| search_id | The ID of the search to monitor | str | Yes |
+| timeout | Maximum time to wait in seconds | int | No |
+| check_interval | Initial interval between status checks in seconds | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| search_id | The search ID that was monitored | str |
+| final_status | The final status of the search | str |
+| items_found | Number of items found by the search | int |
+| items_analyzed | Number of items analyzed | int |
+| completion_percentage | Completion percentage (0-100) | int |
+| elapsed_time | Total time elapsed in seconds | float |
+| recall_info | Information about expected results and confidence | Dict[str, Any] |
+| timed_out | Whether the operation timed out | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Search Completion**: Wait for initial webset population before accessing items.
+
+**Progress Monitoring**: Track search progress in long-running operations.
+
+**Sequential Workflows**: Ensure searches complete before starting enrichments.
+<!-- END MANUAL -->
+
+---
+
+## Exa Wait For Webset
+
+### What it is
+Wait for a webset to reach a specific status with progress tracking
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block polls a webset until it reaches a target status (idle, completed, or running). It uses exponential backoff for efficient polling and provides detailed progress information.
+
+Use this for general-purpose waiting on webset operations when you don't need to track a specific search or enrichment.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset to monitor | str | Yes |
+| target_status | Status to wait for (idle=all operations complete, completed=search done, running=actively processing) | "idle" \| "completed" \| "running" \| "paused" \| "any_complete" | No |
+| timeout | Maximum time to wait in seconds | int | No |
+| check_interval | Initial interval between status checks in seconds | int | No |
+| max_interval | Maximum interval between checks (for exponential backoff) | int | No |
+| include_progress | Include detailed progress information in output | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| webset_id | The webset ID that was monitored | str |
+| final_status | The final status of the webset | str |
+| elapsed_time | Total time elapsed in seconds | float |
+| item_count | Number of items found | int |
+| search_progress | Detailed search progress information | Dict[str, Any] |
+| enrichment_progress | Detailed enrichment progress information | Dict[str, Any] |
+| timed_out | Whether the operation timed out | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Workflow Orchestration**: Wait for all webset operations to complete before next workflow steps.
+
+**Idle State Detection**: Ensure webset is fully idle before making configuration changes.
+
+**Completion Gates**: Block workflow until webset reaches a specific readiness state.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/exa/websets_search.md b/docs/integrations/exa/websets_search.md
new file mode 100644
index 0000000000..8ed7b90d70
--- /dev/null
+++ b/docs/integrations/exa/websets_search.md
@@ -0,0 +1,195 @@
+# Exa Websets Search
+<!-- MANUAL: file_description -->
+Blocks for running and managing searches within Exa websets.
+<!-- END MANUAL -->
+
+## Exa Cancel Webset Search
+
+### What it is
+Cancel a running webset search
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block stops a running search operation on a webset. Items already found before cancellation are retained in the webset.
+
+Use this when a search is taking too long, returning unexpected results, or is no longer needed. The block returns the number of items found before cancellation.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset | str | Yes |
+| search_id | The ID of the search to cancel | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| search_id | The ID of the canceled search | str |
+| status | Status after cancellation | str |
+| items_found_before_cancel | Number of items found before cancellation | int |
+| success | Whether the cancellation was successful | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Resource Control**: Stop searches that are taking longer than expected.
+
+**Query Refinement**: Cancel searches to adjust query and restart with better parameters.
+
+**Partial Results**: Stop searches early when you have enough items for your needs.
+<!-- END MANUAL -->
+
+---
+
+## Exa Create Webset Search
+
+### What it is
+Add a new search to an existing webset to find more items
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block adds a new search to an existing webset to expand its contents. You define the search query, target count, and how results should integrate with existing items (append, override, or merge).
+
+Searches support scoped and exclusion sources, criteria validation, and relationship-based "hop" searches to find related entities.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset | str | Yes |
+| query | Search query describing what to find | str | Yes |
+| count | Number of items to find | int | No |
+| entity_type | Type of entity to search for | "company" \| "person" \| "article" \| "research_paper" \| "custom" \| "auto" | No |
+| entity_description | Description for custom entity type | str | No |
+| criteria | List of criteria that items must meet. If not provided, auto-detected from query. | List[str] | No |
+| behavior | How new results interact with existing items | "override" \| "append" \| "merge" | No |
+| recall | Enable recall estimation for expected results | bool | No |
+| exclude_source_ids | IDs of imports/websets to exclude from results | List[str] | No |
+| exclude_source_types | Types of sources to exclude ('import' or 'webset') | List[str] | No |
+| scope_source_ids | IDs of imports/websets to limit search scope to | List[str] | No |
+| scope_source_types | Types of scope sources ('import' or 'webset') | List[str] | No |
+| scope_relationships | Relationship definitions for hop searches | List[str] | No |
+| scope_relationship_limits | Limits on related entities to find | List[int] | No |
+| metadata | Metadata to attach to the search | Dict[str, Any] | No |
+| wait_for_completion | Wait for the search to complete before returning | bool | No |
+| polling_timeout | Maximum time to wait for completion in seconds | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| search_id | The unique identifier for the created search | str |
+| webset_id | The webset this search belongs to | str |
+| status | Current status of the search | str |
+| query | The search query | str |
+| expected_results | Recall estimation of expected results | Dict[str, Any] |
+| items_found | Number of items found (if wait_for_completion was True) | int |
+| completion_time | Time taken to complete in seconds (if wait_for_completion was True) | float |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Webset Expansion**: Add more items to existing websets with new or refined queries.
+
+**Multi-Criteria Collection**: Run multiple searches with different criteria to build comprehensive datasets.
+
+**Iterative Building**: Progressively expand websets based on analysis of initial results.
+<!-- END MANUAL -->
+
+---
+
+## Exa Find Or Create Search
+
+### What it is
+Find existing search by query or create new - prevents duplicate searches in workflows
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block implements idempotent search creation. If a search with the same query already exists in the webset, it returns that search. Otherwise, it creates a new one.
+
+Use this pattern to prevent duplicate searches when workflows retry or run multiple times with the same parameters.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset | str | Yes |
+| query | Search query to find or create | str | Yes |
+| count | Number of items to find (only used if creating new search) | int | No |
+| entity_type | Entity type (only used if creating) | "company" \| "person" \| "article" \| "research_paper" \| "custom" \| "auto" | No |
+| behavior | Search behavior (only used if creating) | "override" \| "append" \| "merge" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| search_id | The search ID (existing or new) | str |
+| webset_id | The webset ID | str |
+| status | Current search status | str |
+| query | The search query | str |
+| was_created | True if search was newly created, False if already existed | bool |
+| items_found | Number of items found (0 if still running) | int |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Retry-Safe Workflows**: Safely handle workflow retries without creating duplicate searches.
+
+**Deduplication**: Avoid running the same search multiple times when called from different workflow branches.
+
+**Efficient Operations**: Skip search creation when results from identical queries already exist.
+<!-- END MANUAL -->
+
+---
+
+## Exa Get Webset Search
+
+### What it is
+Get the status and details of a webset search
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves detailed information about a webset search including its query, criteria, progress, and recall estimation.
+
+Use this to monitor search progress, verify search configuration, or investigate search behavior when results don't match expectations.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| webset_id | The ID or external ID of the Webset | str | Yes |
+| search_id | The ID of the search to retrieve | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| search_id | The unique identifier for the search | str |
+| status | Current status of the search | str |
+| query | The search query | str |
+| entity_type | Type of entity being searched | str |
+| criteria | Criteria used for verification | List[Dict[str, Any]] |
+| progress | Search progress information | Dict[str, Any] |
+| recall | Recall estimation information | Dict[str, Any] |
+| created_at | When the search was created | str |
+| updated_at | When the search was last updated | str |
+| canceled_at | When the search was canceled (if applicable) | str |
+| canceled_reason | Reason for cancellation (if applicable) | str |
+| metadata | Metadata attached to the search | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Progress Tracking**: Monitor search completion and items found during long-running operations.
+
+**Configuration Review**: Retrieve search details to verify criteria and settings are correct.
+
+**Debugging**: Investigate search configuration when results don't match expectations.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/fal/ai_video_generator.md b/docs/integrations/fal/ai_video_generator.md
new file mode 100644
index 0000000000..16c8cb18d5
--- /dev/null
+++ b/docs/integrations/fal/ai_video_generator.md
@@ -0,0 +1,42 @@
+# Fal AI Video Generator
+<!-- MANUAL: file_description -->
+Blocks for generating AI videos using FAL.ai models.
+<!-- END MANUAL -->
+
+## AI Video Generator
+
+### What it is
+Generate videos using FAL AI models.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block generates videos from text prompts using FAL.ai's video generation models including Mochi, Luma Dream Machine, and Veo3. Describe the video you want to create, and the AI generates it.
+
+The generated video URL is returned along with progress logs for monitoring longer generation jobs.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| prompt | Description of the video to generate. | str | Yes |
+| model | The FAL model to use for video generation. | "fal-ai/mochi-v1" \| "fal-ai/luma-dream-machine" \| "fal-ai/veo3" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if video generation failed. | str |
+| video_url | The URL of the generated video. | str |
+| logs | Generation progress logs. | List[str] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Creation**: Generate video clips for social media, ads, or creative projects.
+
+**Visualization**: Create visual representations of concepts, products, or stories.
+
+**Prototyping**: Generate video mockups for creative ideation and storyboarding.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/firecrawl/crawl.md b/docs/integrations/firecrawl/crawl.md
new file mode 100644
index 0000000000..38c2f3174c
--- /dev/null
+++ b/docs/integrations/firecrawl/crawl.md
@@ -0,0 +1,53 @@
+# Firecrawl Crawl
+<!-- MANUAL: file_description -->
+Blocks for crawling multiple pages of a website using Firecrawl.
+<!-- END MANUAL -->
+
+## Firecrawl Crawl
+
+### What it is
+Firecrawl crawls websites to extract comprehensive data while bypassing blockers.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Firecrawl's API to crawl multiple pages of a website starting from a given URL. It navigates through links, handling JavaScript rendering and bypassing anti-bot measures to extract clean content from each page.
+
+Configure the crawl depth with the limit parameter, choose output formats (markdown, HTML, or raw HTML), and optionally filter to main content only. The block supports caching with configurable max age and wait times for dynamic content.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| url | The URL to crawl | str | Yes |
+| limit | The number of pages to crawl | int | No |
+| only_main_content | Only return the main content of the page excluding headers, navs, footers, etc. | bool | No |
+| max_age | The maximum age of the page in milliseconds - default is 1 hour | int | No |
+| wait_for | Specify a delay in milliseconds before fetching the content, allowing the page sufficient time to load. | int | No |
+| formats | The format of the crawl | List["markdown" \| "html" \| "rawHtml" \| "links" \| "screenshot" \| "screenshot@fullPage" \| "json" \| "changeTracking"] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the crawl failed | str |
+| data | The result of the crawl | List[Dict[str, Any]] |
+| markdown | The markdown of the crawl | str |
+| html | The html of the crawl | str |
+| raw_html | The raw html of the crawl | str |
+| links | The links of the crawl | List[str] |
+| screenshot | The screenshot of the crawl | str |
+| screenshot_full_page | The screenshot full page of the crawl | str |
+| json_data | The json data of the crawl | Dict[str, Any] |
+| change_tracking | The change tracking of the crawl | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Documentation Indexing**: Crawl entire documentation sites to build searchable knowledge bases or training data.
+
+**Competitor Research**: Extract content from competitor websites for market analysis and comparison.
+
+**Content Archival**: Systematically archive website content for backup or compliance purposes.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/firecrawl/extract.md b/docs/integrations/firecrawl/extract.md
new file mode 100644
index 0000000000..9590fdd910
--- /dev/null
+++ b/docs/integrations/firecrawl/extract.md
@@ -0,0 +1,43 @@
+# Firecrawl Extract
+<!-- MANUAL: file_description -->
+Blocks for extracting structured data from web pages using Firecrawl's AI extraction.
+<!-- END MANUAL -->
+
+## Firecrawl Extract
+
+### What it is
+Firecrawl crawls websites to extract comprehensive data while bypassing blockers.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Firecrawl's extraction API to pull structured data from web pages based on a prompt or schema. It crawls the specified URLs and uses AI to extract information matching your requirements.
+
+Define the data structure you want using a JSON schema for precise extraction, or use natural language prompts for flexible extraction. Wildcards in URLs allow extracting data from multiple pages matching a pattern.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| urls | The URLs to crawl - at least one is required. Wildcards are supported. (/*) | List[str] | Yes |
+| prompt | The prompt to use for the crawl | str | No |
+| output_schema | A Json Schema describing the output structure if more rigid structure is desired. | Dict[str, Any] | No |
+| enable_web_search | When true, extraction can follow links outside the specified domain. | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the extraction failed | str |
+| data | The result of the crawl | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Product Data Extraction**: Extract structured product information (prices, specs, reviews) from e-commerce sites.
+
+**Contact Scraping**: Pull business contact information from company websites in a structured format.
+
+**Data Pipeline Input**: Automatically extract and structure web data for analysis or database population.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/firecrawl/map.md b/docs/integrations/firecrawl/map.md
new file mode 100644
index 0000000000..6bab1aa588
--- /dev/null
+++ b/docs/integrations/firecrawl/map.md
@@ -0,0 +1,41 @@
+# Firecrawl Map
+<!-- MANUAL: file_description -->
+Blocks for mapping website structure and discovering all links using Firecrawl.
+<!-- END MANUAL -->
+
+## Firecrawl Map Website
+
+### What it is
+Firecrawl maps a website to extract all the links.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Firecrawl's mapping API to discover all links on a website without extracting full content. It quickly scans the site structure and returns a comprehensive list of URLs found.
+
+The block is useful for understanding site architecture before performing targeted scraping or for building site maps. Results include both the raw list of links and structured results with titles and descriptions.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| url | The website url to map | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the map failed | str |
+| links | List of URLs found on the website | List[str] |
+| results | List of search results with url, title, and description | List[Dict[str, Any]] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Site Audit**: Map all pages on a website to identify broken links, orphan pages, or SEO issues.
+
+**Crawl Planning**: Discover site structure before deciding which pages to scrape in detail.
+
+**Content Discovery**: Find all blog posts, product pages, or documentation entries on a site.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/firecrawl/scrape.md b/docs/integrations/firecrawl/scrape.md
new file mode 100644
index 0000000000..7dead595d7
--- /dev/null
+++ b/docs/integrations/firecrawl/scrape.md
@@ -0,0 +1,53 @@
+# Firecrawl Scrape
+<!-- MANUAL: file_description -->
+Blocks for scraping individual web pages and extracting content using Firecrawl.
+<!-- END MANUAL -->
+
+## Firecrawl Scrape
+
+### What it is
+Firecrawl scrapes a website to extract comprehensive data while bypassing blockers.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Firecrawl's scraping API to extract content from a single URL. It handles JavaScript rendering, bypasses anti-bot measures, and can return content in multiple formats including markdown, HTML, and screenshots.
+
+Configure output formats, filter to main content only, and set wait times for dynamic pages. The block returns comprehensive results including extracted content, links found on the page, and optional change tracking data.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| url | The URL to crawl | str | Yes |
+| limit | The number of pages to crawl | int | No |
+| only_main_content | Only return the main content of the page excluding headers, navs, footers, etc. | bool | No |
+| max_age | The maximum age of the page in milliseconds - default is 1 hour | int | No |
+| wait_for | Specify a delay in milliseconds before fetching the content, allowing the page sufficient time to load. | int | No |
+| formats | The format of the crawl | List["markdown" \| "html" \| "rawHtml" \| "links" \| "screenshot" \| "screenshot@fullPage" \| "json" \| "changeTracking"] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the scrape failed | str |
+| data | The result of the crawl | Dict[str, Any] |
+| markdown | The markdown of the crawl | str |
+| html | The html of the crawl | str |
+| raw_html | The raw html of the crawl | str |
+| links | The links of the crawl | List[str] |
+| screenshot | The screenshot of the crawl | str |
+| screenshot_full_page | The screenshot full page of the crawl | str |
+| json_data | The json data of the crawl | Dict[str, Any] |
+| change_tracking | The change tracking of the crawl | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Article Extraction**: Scrape news articles or blog posts to extract clean, readable content.
+
+**Price Monitoring**: Regularly scrape product pages to track price changes over time.
+
+**Content Backup**: Create markdown backups of important web pages for offline reference.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/firecrawl/search.md b/docs/integrations/firecrawl/search.md
new file mode 100644
index 0000000000..67ce63d196
--- /dev/null
+++ b/docs/integrations/firecrawl/search.md
@@ -0,0 +1,45 @@
+# Firecrawl Search
+<!-- MANUAL: file_description -->
+Blocks for searching the web and extracting content using Firecrawl.
+<!-- END MANUAL -->
+
+## Firecrawl Search
+
+### What it is
+Firecrawl searches the web for the given query.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Firecrawl's search API to find web pages matching your query and optionally extract their content. It performs a web search and can return results with full page content in your chosen format.
+
+Configure the number of results to return, output formats (markdown, HTML, raw HTML), and caching behavior. The wait_for parameter allows time for JavaScript-heavy pages to fully render before extraction.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| query | The query to search for | str | Yes |
+| limit | The number of pages to crawl | int | No |
+| max_age | The maximum age of the page in milliseconds - default is 1 hour | int | No |
+| wait_for | Specify a delay in milliseconds before fetching the content, allowing the page sufficient time to load. | int | No |
+| formats | Returns the content of the search if specified | List["markdown" \| "html" \| "rawHtml" \| "links" \| "screenshot" \| "screenshot@fullPage" \| "json" \| "changeTracking"] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the search failed | str |
+| data | The result of the search | Dict[str, Any] |
+| site | The site of the search | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Research Automation**: Search for topics and automatically extract content from relevant pages for analysis.
+
+**Lead Generation**: Find companies or contacts matching specific criteria across the web.
+
+**Content Aggregation**: Gather articles, reviews, or information on specific topics from multiple sources.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/content/platform/blocks/flux_kontext.md b/docs/integrations/flux_kontext.md
similarity index 100%
rename from docs/content/platform/blocks/flux_kontext.md
rename to docs/integrations/flux_kontext.md
diff --git a/docs/integrations/generic_webhook/triggers.md b/docs/integrations/generic_webhook/triggers.md
new file mode 100644
index 0000000000..3ca6562438
--- /dev/null
+++ b/docs/integrations/generic_webhook/triggers.md
@@ -0,0 +1,41 @@
+# Generic Webhook Triggers
+<!-- MANUAL: file_description -->
+Blocks for receiving and processing generic webhook payloads from external services.
+<!-- END MANUAL -->
+
+## Generic Webhook Trigger
+
+### What it is
+This block will output the contents of the generic input for the webhook.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a webhook endpoint that receives and outputs any incoming HTTP payload. When external services send data to this webhook URL, the block triggers and outputs the complete payload as a dictionary.
+
+Constants can be configured to pass additional static values alongside the dynamic webhook data.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| constants | The constants to be set when the block is put on the graph | Dict[str, Any] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| payload | The complete webhook payload that was received from the generic webhook. | Dict[str, Any] |
+| constants | The constants to be set when the block is put on the graph | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**External Integrations**: Receive data from any third-party service that supports webhooks.
+
+**Custom Triggers**: Create custom workflow triggers from external systems or internal tools.
+
+**Event Processing**: Capture and process events from IoT devices, payment processors, or notification services.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/github/checks.md b/docs/integrations/github/checks.md
new file mode 100644
index 0000000000..b11f3592c5
--- /dev/null
+++ b/docs/integrations/github/checks.md
@@ -0,0 +1,90 @@
+# GitHub Checks
+<!-- MANUAL: file_description -->
+Blocks for creating and updating GitHub check runs, enabling custom CI integration and detailed status reporting on commits and pull requests.
+<!-- END MANUAL -->
+
+## Github Create Check Run
+
+### What it is
+Creates a new check run for a specific commit in a GitHub repository
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a new check run associated with a specific commit using the GitHub Checks API. Check runs represent individual test suites, linting tools, or other CI processes that report status against commits or pull requests.
+
+You specify the commit SHA, check name, and current status. For completed checks, provide a conclusion (success, failure, or neutral) and optional detailed output including title, summary, and extended text for rich reporting in the GitHub UI.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo_url | URL of the GitHub repository | str | Yes |
+| name | The name of the check run (e.g., 'code-coverage') | str | Yes |
+| head_sha | The SHA of the commit to check | str | Yes |
+| status | Current status of the check run | "queued" \| "in_progress" \| "completed" \| "waiting" \| "requested" \| "pending" | No |
+| conclusion | The final conclusion of the check (required if status is completed) | "success" \| "failure" \| "neutral" \| "cancelled" \| "timed_out" \| "action_required" \| "skipped" | No |
+| details_url | The URL for the full details of the check | str | No |
+| output_title | Title of the check run output | str | No |
+| output_summary | Summary of the check run output | str | No |
+| output_text | Detailed text of the check run output | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if check run creation failed | str |
+| check_run | Details of the created check run | CheckRunResult |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Custom CI Integration**: Create check runs for external CI systems that aren't natively integrated with GitHub.
+
+**Code Quality Reporting**: Report linting, security scan, or test coverage results directly on commits and PRs.
+
+**Deployment Status**: Track deployment progress by creating check runs that show pending, in-progress, and completed states.
+<!-- END MANUAL -->
+
+---
+
+## Github Update Check Run
+
+### What it is
+Updates an existing check run in a GitHub repository
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block updates an existing check run's status, conclusion, and output details via the GitHub Checks API. Use it to report progress as your CI process advances through different stages.
+
+You can update the status from queued to in_progress to completed, and set the final conclusion when done. The output fields allow you to provide detailed results, annotations, and summaries visible in the GitHub UI.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo_url | URL of the GitHub repository | str | Yes |
+| check_run_id | The ID of the check run to update | int | Yes |
+| status | New status of the check run | "queued" \| "in_progress" \| "completed" \| "waiting" \| "requested" \| "pending" | Yes |
+| conclusion | The final conclusion of the check (required if status is completed) | "success" \| "failure" \| "neutral" \| "cancelled" \| "timed_out" \| "action_required" \| "skipped" | Yes |
+| output_title | New title of the check run output | str | No |
+| output_summary | New summary of the check run output | str | No |
+| output_text | New detailed text of the check run output | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| check_run | Details of the updated check run | CheckRunResult |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Progress Reporting**: Update check runs as your CI pipeline progresses through build, test, and deployment stages.
+
+**Real-Time Feedback**: Provide immediate feedback on pull requests as tests complete, rather than waiting for the entire suite.
+
+**Failure Details**: Update check runs with detailed error messages and output when tests fail.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/github/ci.md b/docs/integrations/github/ci.md
new file mode 100644
index 0000000000..8b8be57897
--- /dev/null
+++ b/docs/integrations/github/ci.md
@@ -0,0 +1,51 @@
+# GitHub CI
+<!-- MANUAL: file_description -->
+Blocks for retrieving CI check results from commits or pull requests, including overall status, pass/fail counts, and optional log searching.
+<!-- END MANUAL -->
+
+## Github Get CI Results
+
+### What it is
+This block gets CI results for a commit or PR, with optional search for specific errors/warnings in logs.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves CI check results for a specific commit or pull request using the GitHub Checks API. It aggregates results from all CI checks, providing an overall status summary along with individual check details.
+
+Optionally search through CI logs using regex patterns to find specific errors or warnings. You can filter by check name to focus on particular CI jobs. The block returns comprehensive results including pass/fail counts and matched log lines.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo | GitHub repository | str | Yes |
+| target | Commit SHA or PR number to get CI results for | str \| int | Yes |
+| search_pattern | Optional regex pattern to search for in CI logs (e.g., error messages, file names) | str | No |
+| check_name_filter | Optional filter for specific check names (supports wildcards) | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| check_run | Individual CI check run with details | Check Run |
+| check_runs | List of all CI check runs | List[CheckRunItem] |
+| matched_line | Line matching the search pattern with context | Matched Line |
+| matched_lines | All lines matching the search pattern across all checks | List[MatchedLine] |
+| overall_status | Overall CI status (pending, success, failure) | str |
+| overall_conclusion | Overall CI conclusion if completed | str |
+| total_checks | Total number of CI checks | int |
+| passed_checks | Number of passed checks | int |
+| failed_checks | Number of failed checks | int |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**CI Status Monitoring**: Check the overall CI status of commits or PRs before merging or deploying.
+
+**Error Diagnosis**: Search CI logs for specific error patterns to quickly identify why builds are failing.
+
+**Automated PR Validation**: Verify all required checks pass before automatically proceeding with merge or deployment workflows.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/github/issues.md b/docs/integrations/github/issues.md
new file mode 100644
index 0000000000..300eda5c5e
--- /dev/null
+++ b/docs/integrations/github/issues.md
@@ -0,0 +1,333 @@
+# GitHub Issues
+<!-- MANUAL: file_description -->
+Blocks for managing GitHub issues including creating, reading, listing, commenting, labeling, and assigning issues programmatically.
+<!-- END MANUAL -->
+
+## Github Add Label
+
+### What it is
+A block that adds a label to a GitHub issue or pull request for categorization and organization.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block takes the GitHub credentials, the URL of the issue or pull request, and the label to be added as inputs. It then sends a request to the GitHub API to add the label to the specified issue or pull request.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| issue_url | URL of the GitHub issue or pull request | str | Yes |
+| label | Label to add to the issue or pull request | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the label addition failed | str |
+| status | Status of the label addition operation | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Automatically categorizing issues based on their content or assigning priority labels to newly created issues.
+<!-- END MANUAL -->
+
+---
+
+## Github Assign Issue
+
+### What it is
+A block that assigns a GitHub user to an issue for task ownership and tracking.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block takes the GitHub credentials, the URL of the issue, and the username of the person to be assigned as inputs. It then sends a request to the GitHub API to assign the specified user to the issue.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| issue_url | URL of the GitHub issue | str | Yes |
+| assignee | Username to assign to the issue | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the issue assignment failed | str |
+| status | Status of the issue assignment operation | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Automatically assigning new issues to team members based on their expertise or workload.
+<!-- END MANUAL -->
+
+---
+
+## Github Comment
+
+### What it is
+A block that posts comments on GitHub issues or pull requests using the GitHub API.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block takes the GitHub credentials, the URL of the issue or pull request, and the comment text as inputs. It then sends a request to the GitHub API to post the comment on the specified issue or pull request.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| issue_url | URL of the GitHub issue or pull request | str | Yes |
+| comment | Comment to post on the issue or pull request | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the comment posting failed | str |
+| id | ID of the created comment | int |
+| url | URL to the comment on GitHub | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Automating responses to issues in a GitHub repository, such as thanking contributors for their submissions or providing status updates on reported bugs.
+<!-- END MANUAL -->
+
+---
+
+## Github List Comments
+
+### What it is
+A block that retrieves all comments from a GitHub issue or pull request, including comment metadata and content.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves all comments from a GitHub issue or pull request via the GitHub API. It authenticates using your GitHub credentials and fetches the complete comment history, returning both individual comments and a list of all comments with their metadata.
+
+Each comment includes the comment ID, body text, author username, and a direct URL to the comment on GitHub.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| issue_url | URL of the GitHub issue or pull request | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| comment | Comments with their ID, body, user, and URL | Comment |
+| comments | List of comments with their ID, body, user, and URL | List[CommentItem] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Conversation Analysis**: Extract all comments from an issue to analyze the discussion or generate a summary of the conversation.
+
+**Comment Monitoring**: Track all responses on specific issues to monitor team communication or customer feedback.
+
+**Audit Trails**: Collect comment history for compliance or documentation purposes.
+<!-- END MANUAL -->
+
+---
+
+## Github List Issues
+
+### What it is
+A block that retrieves a list of issues from a GitHub repository with their titles and URLs.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block takes the GitHub credentials and repository URL as inputs. It then sends a request to the GitHub API to fetch the list of issues and returns their details.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo_url | URL of the GitHub repository | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| issue | Issues with their title and URL | Issue |
+| issues | List of issues with their title and URL | List[IssueItem] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Creating a summary of open issues for a project status report or displaying them on a project management dashboard.
+<!-- END MANUAL -->
+
+---
+
+## Github Make Issue
+
+### What it is
+A block that creates new issues on GitHub repositories with a title and body content.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block takes the GitHub credentials, repository URL, issue title, and issue body as inputs. It then sends a request to the GitHub API to create a new issue with the provided information.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo_url | URL of the GitHub repository | str | Yes |
+| title | Title of the issue | str | Yes |
+| body | Body of the issue | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the issue creation failed | str |
+| number | Number of the created issue | int |
+| url | URL of the created issue | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Automatically creating issues for bug reports or feature requests submitted through an external system or form.
+<!-- END MANUAL -->
+
+---
+
+## Github Read Issue
+
+### What it is
+A block that retrieves information about a specific GitHub issue, including its title, body content, and creator.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block takes the GitHub credentials and the issue URL as inputs. It then sends a request to the GitHub API to fetch the issue's details and returns the relevant information.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| issue_url | URL of the GitHub issue | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if reading the issue failed | str |
+| title | Title of the issue | str |
+| body | Body of the issue | str |
+| user | User who created the issue | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Gathering information about reported issues for analysis or to display on a dashboard.
+<!-- END MANUAL -->
+
+---
+
+## Github Remove Label
+
+### What it is
+A block that removes a label from a GitHub issue or pull request.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block takes the GitHub credentials, the URL of the issue or pull request, and the label to be removed as inputs. It then sends a request to the GitHub API to remove the label from the specified issue or pull request.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| issue_url | URL of the GitHub issue or pull request | str | Yes |
+| label | Label to remove from the issue or pull request | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the label removal failed | str |
+| status | Status of the label removal operation | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Updating the status of issues as they progress through a workflow, such as removing a "In Progress" label when an issue is completed.
+<!-- END MANUAL -->
+
+---
+
+## Github Unassign Issue
+
+### What it is
+A block that removes a user's assignment from a GitHub issue.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block takes the GitHub credentials, the URL of the issue, and the username of the person to be unassigned as inputs. It then sends a request to the GitHub API to remove the specified user's assignment from the issue.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| issue_url | URL of the GitHub issue | str | Yes |
+| assignee | Username to unassign from the issue | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the issue unassignment failed | str |
+| status | Status of the issue unassignment operation | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Automatically unassigning issues that have been inactive for a certain period or when reassigning workload among team members.
+<!-- END MANUAL -->
+
+---
+
+## Github Update Comment
+
+### What it is
+A block that updates an existing comment on a GitHub issue or pull request.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block updates an existing comment on a GitHub issue or pull request. You can identify the comment to update using either the direct comment URL, or a combination of the issue URL and comment ID. The block sends a PATCH request to the GitHub API to replace the comment's content.
+
+The updated comment retains its original author and timestamp context while replacing the body text with your new content.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| comment_url | URL of the GitHub comment | str | No |
+| issue_url | URL of the GitHub issue or pull request | str | No |
+| comment_id | ID of the GitHub comment | str | No |
+| comment | Comment to update | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the comment update failed | str |
+| id | ID of the updated comment | int |
+| url | URL to the comment on GitHub | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Status Updates**: Modify a pinned status comment to reflect current progress on an issue.
+
+**Bot Maintenance**: Update automated bot comments with new information instead of creating duplicate comments.
+
+**Error Corrections**: Fix typos or incorrect information in previously posted comments.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/github/pull_requests.md b/docs/integrations/github/pull_requests.md
new file mode 100644
index 0000000000..dd5c194ea3
--- /dev/null
+++ b/docs/integrations/github/pull_requests.md
@@ -0,0 +1,233 @@
+# GitHub Pull Requests
+<!-- MANUAL: file_description -->
+Blocks for managing GitHub pull requests including creating, reading, listing PRs, and assigning or unassigning reviewers.
+<!-- END MANUAL -->
+
+## Github Assign PR Reviewer
+
+### What it is
+This block assigns a reviewer to a specified GitHub pull request.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block requests a code review from a specific user on a GitHub pull request. It uses the GitHub API to add the specified username to the list of requested reviewers, triggering a notification to that user.
+
+The reviewer must have access to the repository. Organization members can typically be assigned as reviewers on any repository they have at least read access to.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| pr_url | URL of the GitHub pull request | str | Yes |
+| reviewer | Username of the reviewer to assign | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the reviewer assignment failed | str |
+| status | Status of the reviewer assignment operation | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Automated Code Review Assignment**: Automatically assign reviewers based on the files changed or the PR author.
+
+**Round-Robin Reviews**: Distribute code review load evenly across team members.
+
+**Expertise-Based Routing**: Assign reviewers who are experts in the specific area of code being modified.
+<!-- END MANUAL -->
+
+---
+
+## Github List PR Reviewers
+
+### What it is
+This block lists all reviewers for a specified GitHub pull request.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves the list of requested reviewers for a GitHub pull request. It queries the GitHub API to fetch all users who have been requested to review the PR, returning their usernames and profile URLs.
+
+This includes both pending review requests and users who have already submitted reviews.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| pr_url | URL of the GitHub pull request | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if listing reviewers failed | str |
+| reviewer | Reviewers with their username and profile URL | Reviewer |
+| reviewers | List of reviewers with their username and profile URL | List[ReviewerItem] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Review Status Monitoring**: Check which reviewers have been assigned to a PR and send reminders to those who haven't responded.
+
+**Workflow Validation**: Verify that required reviewers have been assigned before a PR can be merged.
+
+**Team Dashboard**: Display reviewer assignments across multiple PRs for team visibility.
+<!-- END MANUAL -->
+
+---
+
+## Github List Pull Requests
+
+### What it is
+This block lists all pull requests for a specified GitHub repository.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block fetches all open pull requests from a GitHub repository. It queries the GitHub API and returns a list of PRs with their titles and URLs, outputting both individual PRs and a complete list.
+
+The block returns open pull requests by default, allowing you to monitor pending code changes in a repository.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo_url | URL of the GitHub repository | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if listing pull requests failed | str |
+| pull_request | PRs with their title and URL | Pull Request |
+| pull_requests | List of pull requests with their title and URL | List[PRItem] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**PR Dashboard**: Create a dashboard showing all open pull requests across your repositories.
+
+**Merge Queue Monitoring**: Track pending PRs to prioritize code reviews and identify bottlenecks.
+
+**Stale PR Detection**: List PRs to identify those that have been open too long and need attention.
+<!-- END MANUAL -->
+
+---
+
+## Github Make Pull Request
+
+### What it is
+This block creates a new pull request on a specified GitHub repository.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a new pull request on a GitHub repository. It uses the GitHub API to submit a PR from your source branch (head) to the target branch (base), with the specified title and description.
+
+For cross-repository PRs, format the head branch as "username:branch". The branches must exist and have divergent commits for the PR to be created successfully.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo_url | URL of the GitHub repository | str | Yes |
+| title | Title of the pull request | str | Yes |
+| body | Body of the pull request | str | Yes |
+| head | The name of the branch where your changes are implemented. For cross-repository pull requests in the same network, namespace head with a user like this: username:branch. | str | Yes |
+| base | The name of the branch you want the changes pulled into. | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the pull request creation failed | str |
+| number | Number of the created pull request | int |
+| url | URL of the created pull request | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Automated Releases**: Create PRs automatically when a release branch is ready to merge to main.
+
+**Dependency Updates**: Programmatically create PRs for dependency updates after testing passes.
+
+**Feature Flags**: Automatically create PRs to enable feature flags in configuration files.
+<!-- END MANUAL -->
+
+---
+
+## Github Read Pull Request
+
+### What it is
+This block reads the body, title, user, and changes of a specified GitHub pull request.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block reads the details of a GitHub pull request including its title, description, author, and optionally the code diff. It fetches this information via the GitHub API using your credentials.
+
+When include_pr_changes is enabled, the block also retrieves the full diff of all changes in the PR, which can be useful for code review automation or analysis.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| pr_url | URL of the GitHub pull request | str | Yes |
+| include_pr_changes | Whether to include the changes made in the pull request | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if reading the pull request failed | str |
+| title | Title of the pull request | str |
+| body | Body of the pull request | str |
+| author | User who created the pull request | str |
+| changes | Changes made in the pull request | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Automated Code Review**: Read PR content and changes to perform automated code analysis or send to AI for review.
+
+**Changelog Generation**: Extract PR titles and descriptions to automatically compile release notes.
+
+**PR Summarization**: Read PR details to generate summaries for stakeholder updates.
+<!-- END MANUAL -->
+
+---
+
+## Github Unassign PR Reviewer
+
+### What it is
+This block unassigns a reviewer from a specified GitHub pull request.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block removes a reviewer from a GitHub pull request's review request list. It uses the GitHub API to remove the specified user from pending reviewers, which stops further review notifications to that user.
+
+This is useful for reassigning reviews or removing reviewers who are unavailable.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| pr_url | URL of the GitHub pull request | str | Yes |
+| reviewer | Username of the reviewer to unassign | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the reviewer unassignment failed | str |
+| status | Status of the reviewer unassignment operation | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Reviewer Reassignment**: Remove unavailable reviewers and replace them with available team members.
+
+**Load Balancing**: Unassign reviewers who have too many pending reviews.
+
+**Vacation Coverage**: Automatically remove reviewers who are out of office.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/github/repo.md b/docs/integrations/github/repo.md
new file mode 100644
index 0000000000..c68f138dba
--- /dev/null
+++ b/docs/integrations/github/repo.md
@@ -0,0 +1,467 @@
+# GitHub Repo
+<!-- MANUAL: file_description -->
+Blocks for managing GitHub repositories, branches, files, and repository metadata.
+<!-- END MANUAL -->
+
+## Github Create File
+
+### What it is
+This block creates a new file in a GitHub repository.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a new file in a GitHub repository using the GitHub Contents API. It commits the file with the specified content to the chosen branch (or the default branch if not specified).
+
+The commit message can be customized, and the block returns the URL of the created file along with the commit SHA for tracking purposes.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo_url | URL of the GitHub repository | str | Yes |
+| file_path | Path where the file should be created | str | Yes |
+| content | Content to write to the file | str | Yes |
+| branch | Branch where the file should be created | str | No |
+| commit_message | Message for the commit | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the file creation failed | str |
+| url | URL of the created file | str |
+| sha | SHA of the commit | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Configuration Deployment**: Automatically add configuration files to repositories during project setup.
+
+**Documentation Generation**: Create markdown files or documentation pages programmatically.
+
+**Template Deployment**: Add boilerplate files like LICENSE, .gitignore, or CI configs to repositories.
+<!-- END MANUAL -->
+
+---
+
+## Github Create Repository
+
+### What it is
+This block creates a new GitHub repository.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a new GitHub repository under your account using the GitHub API. You can configure visibility (public/private), add a description, and optionally initialize with a README and .gitignore file based on common templates.
+
+The block returns both the web URL for viewing the repository and the clone URL for git operations.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| name | Name of the repository to create | str | Yes |
+| description | Description of the repository | str | No |
+| private | Whether the repository should be private | bool | No |
+| auto_init | Whether to initialize the repository with a README | bool | No |
+| gitignore_template | Git ignore template to use (e.g., Python, Node, Java) | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the repository creation failed | str |
+| url | URL of the created repository | str |
+| clone_url | Git clone URL of the repository | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Project Bootstrapping**: Automatically create repositories with standard configuration when starting new projects.
+
+**Template Deployment**: Create pre-configured repositories from templates for team members.
+
+**Automated Workflows**: Generate repositories programmatically as part of onboarding or project management workflows.
+<!-- END MANUAL -->
+
+---
+
+## Github Delete Branch
+
+### What it is
+This block deletes a specified branch.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block deletes a specified branch from a GitHub repository using the GitHub References API. The branch is permanently removed, so use with caution—this cannot be undone without re-pushing the branch.
+
+Protected branches cannot be deleted unless protection rules are first removed.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo_url | URL of the GitHub repository | str | Yes |
+| branch | Name of the branch to delete | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the branch deletion failed | str |
+| status | Status of the branch deletion operation | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Post-Merge Cleanup**: Automatically delete feature branches after they've been merged.
+
+**Stale Branch Management**: Clean up old or abandoned branches to keep the repository tidy.
+
+**CI/CD Automation**: Delete temporary branches created during build or deployment processes.
+<!-- END MANUAL -->
+
+---
+
+## Github List Branches
+
+### What it is
+This block lists all branches for a specified GitHub repository.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves all branches from a GitHub repository. It queries the GitHub API and returns each branch with its name and a URL to browse the files at that branch.
+
+This provides visibility into all development streams in a repository.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo_url | URL of the GitHub repository | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| branch | Branches with their name and file tree browser URL | Branch |
+| branches | List of branches with their name and file tree browser URL | List[BranchItem] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Branch Inventory**: Create a dashboard showing all active branches across repositories.
+
+**Naming Convention Validation**: Check branch names against team conventions.
+
+**Active Development Tracking**: Monitor which branches exist to track parallel development efforts.
+<!-- END MANUAL -->
+
+---
+
+## Github List Discussions
+
+### What it is
+This block lists recent discussions for a specified GitHub repository.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block fetches recent discussions from a GitHub repository using the GitHub GraphQL API. Discussions are a forum-style feature for community conversations separate from issues and PRs.
+
+You can limit the number of discussions retrieved with the num_discussions parameter.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo_url | URL of the GitHub repository | str | Yes |
+| num_discussions | Number of discussions to fetch | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if listing discussions failed | str |
+| discussion | Discussions with their title and URL | Discussion |
+| discussions | List of discussions with their title and URL | List[DiscussionItem] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Community Monitoring**: Track community discussions to identify popular topics or user concerns.
+
+**Q&A Automation**: Monitor discussions for questions that can be answered automatically.
+
+**Content Aggregation**: Collect discussion topics for community newsletters or summaries.
+<!-- END MANUAL -->
+
+---
+
+## Github List Releases
+
+### What it is
+This block lists all releases for a specified GitHub repository.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves all releases from a GitHub repository. Releases are versioned packages of your software that may include release notes, binaries, and source code archives.
+
+The block returns release information including names and URLs, outputting both individual releases and a complete list.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo_url | URL of the GitHub repository | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| release | Releases with their name and file tree browser URL | Release |
+| releases | List of releases with their name and file tree browser URL | List[ReleaseItem] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Version Tracking**: Monitor releases across dependencies to stay current with updates.
+
+**Changelog Compilation**: Gather release information for documentation or announcement purposes.
+
+**Dependency Monitoring**: Track when new versions of libraries your project depends on are released.
+<!-- END MANUAL -->
+
+---
+
+## Github List Stargazers
+
+### What it is
+This block lists all users who have starred a specified GitHub repository.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves the list of users who have starred a GitHub repository. Stars are a way for users to bookmark or show appreciation for repositories.
+
+Each stargazer entry includes their username and a link to their GitHub profile.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo_url | URL of the GitHub repository | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if listing stargazers failed | str |
+| stargazer | Stargazers with their username and profile URL | Stargazer |
+| stargazers | List of stargazers with their username and profile URL | List[StargazerItem] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Community Engagement**: Identify and thank users who have starred your repository.
+
+**Growth Analytics**: Track repository popularity over time by monitoring star growth.
+
+**User Research**: Analyze who is interested in your project based on their profiles.
+<!-- END MANUAL -->
+
+---
+
+## Github List Tags
+
+### What it is
+This block lists all tags for a specified GitHub repository.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves all git tags from a GitHub repository. Tags are typically used to mark release points or significant milestones in the repository history.
+
+Each tag includes its name and a URL to browse the repository files at that tag.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo_url | URL of the GitHub repository | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| tag | Tags with their name and file tree browser URL | Tag |
+| tags | List of tags with their name and file tree browser URL | List[TagItem] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Version Enumeration**: List all versions of a project to check for available updates.
+
+**Release Verification**: Confirm that tags exist for expected release versions.
+
+**Historical Code Access**: Find tags to access the codebase at specific historical points.
+<!-- END MANUAL -->
+
+---
+
+## Github Make Branch
+
+### What it is
+This block creates a new branch from a specified source branch.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a new branch in a GitHub repository based on an existing source branch. It uses the GitHub References API to create a new ref pointing to the same commit as the source branch.
+
+The new branch immediately contains all the code from the source branch at the time of creation.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo_url | URL of the GitHub repository | str | Yes |
+| new_branch | Name of the new branch | str | Yes |
+| source_branch | Name of the source branch | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the branch creation failed | str |
+| status | Status of the branch creation operation | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Feature Branch Creation**: Automatically create feature branches from main when work begins.
+
+**Release Preparation**: Create release branches from development when ready to stabilize.
+
+**Hotfix Workflows**: Quickly create hotfix branches from production for urgent fixes.
+<!-- END MANUAL -->
+
+---
+
+## Github Read File
+
+### What it is
+This block reads the content of a specified file from a GitHub repository.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block reads the contents of a file from a GitHub repository using the Contents API. You can specify which branch to read from, defaulting to the repository's default branch.
+
+The block returns both the decoded text content (for text files) and the raw base64-encoded content, along with the file size.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo_url | URL of the GitHub repository | str | Yes |
+| file_path | Path to the file in the repository | str | Yes |
+| branch | Branch to read from | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| text_content | Content of the file (decoded as UTF-8 text) | str |
+| raw_content | Raw base64-encoded content of the file | str |
+| size | The size of the file (in bytes) | int |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Configuration Reading**: Fetch configuration files from repositories for processing or validation.
+
+**Code Analysis**: Read source files for automated analysis, linting, or documentation generation.
+
+**Version Comparison**: Compare file contents across different branches or versions.
+<!-- END MANUAL -->
+
+---
+
+## Github Read Folder
+
+### What it is
+This block reads the content of a specified folder from a GitHub repository.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block lists the contents of a folder in a GitHub repository. It returns separate outputs for files and directories found in the specified path, allowing you to explore the repository structure.
+
+You can specify which branch to read from; it defaults to master if not specified.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo_url | URL of the GitHub repository | str | Yes |
+| folder_path | Path to the folder in the repository | str | Yes |
+| branch | Branch name to read from (defaults to master) | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if reading the folder failed | str |
+| file | Files in the folder | FileEntry |
+| dir | Directories in the folder | DirEntry |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Repository Exploration**: Browse repository structure to understand project organization.
+
+**File Discovery**: Find specific file types in directories for batch processing.
+
+**Directory Monitoring**: Check for expected files in specific locations.
+<!-- END MANUAL -->
+
+---
+
+## Github Update File
+
+### What it is
+This block updates an existing file in a GitHub repository.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block updates an existing file in a GitHub repository using the Contents API. It creates a new commit with the updated file content. The block automatically handles the required SHA of the existing file.
+
+You can customize the commit message and specify which branch to update.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo_url | URL of the GitHub repository | str | Yes |
+| file_path | Path to the file to update | str | Yes |
+| content | New content for the file | str | Yes |
+| branch | Branch containing the file | str | No |
+| commit_message | Message for the commit | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| url | URL of the updated file | str |
+| sha | SHA of the commit | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Configuration Updates**: Programmatically update configuration files in repositories.
+
+**Version Bumping**: Automatically update version numbers in package files.
+
+**Documentation Sync**: Update documentation files based on code changes.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/github/reviews.md b/docs/integrations/github/reviews.md
new file mode 100644
index 0000000000..fac3818b6c
--- /dev/null
+++ b/docs/integrations/github/reviews.md
@@ -0,0 +1,245 @@
+# GitHub Reviews
+<!-- MANUAL: file_description -->
+Blocks for creating and managing GitHub pull request reviews and review comments.
+<!-- END MANUAL -->
+
+## Github Create Comment Object
+
+### What it is
+Creates a comment object for use with GitHub blocks. Note: For review comments, only path, body, and position are used. Side fields are only for standalone PR comments.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a structured comment object that can be used with GitHub review blocks. It formats the comment data according to GitHub API requirements, including file path, body text, and position information.
+
+For review comments, only path, body, and position fields are used. The side, start_line, and start_side fields are only applicable for standalone PR comments, not review comments.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| path | The file path to comment on | str | Yes |
+| body | The comment text | str | Yes |
+| position | Position in the diff (line number from first @@ hunk). Use this OR line. | int | No |
+| line | Line number in the file (will be used as position if position not provided) | int | No |
+| side | Side of the diff to comment on (NOTE: Only for standalone comments, not review comments) | str | No |
+| start_line | Start line for multi-line comments (NOTE: Only for standalone comments, not review comments) | int | No |
+| start_side | Side for the start of multi-line comments (NOTE: Only for standalone comments, not review comments) | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| comment_object | The comment object formatted for GitHub API | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Automated Code Review**: Generate comment objects for automated review systems that analyze code changes.
+
+**Batch Comments**: Create multiple comment objects to submit together in a single review.
+
+**Template Responses**: Build reusable comment templates for common code review feedback patterns.
+<!-- END MANUAL -->
+
+---
+
+## Github Create PR Review
+
+### What it is
+This block creates a review on a GitHub pull request with optional inline comments. You can create it as a draft or post immediately. Note: For inline comments, 'position' should be the line number in the diff (starting from the first @@ hunk header).
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a code review on a GitHub pull request using the Reviews API. Reviews can include a summary comment and optionally inline comments on specific lines of code in the diff.
+
+You can create reviews as drafts (pending) for later submission, or post them immediately with an action: COMMENT for neutral feedback, APPROVE to approve the changes, or REQUEST_CHANGES to block merging until addressed.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo | GitHub repository | str | Yes |
+| pr_number | Pull request number | int | Yes |
+| body | Body of the review comment | str | Yes |
+| event | The review action to perform | "COMMENT" \| "APPROVE" \| "REQUEST_CHANGES" | No |
+| create_as_draft | Create the review as a draft (pending) or post it immediately | bool | No |
+| comments | Optional inline comments to add to specific files/lines. Note: Only path, body, and position are supported. Position is line number in diff from first @@ hunk. | List[ReviewComment] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the review creation failed | str |
+| review_id | ID of the created review | int |
+| state | State of the review (e.g., PENDING, COMMENTED, APPROVED, CHANGES_REQUESTED) | str |
+| html_url | URL of the created review | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Automated Code Review**: Submit AI-generated code reviews with inline comments on specific lines.
+
+**Review Workflows**: Create structured reviews as part of automated CI/CD pipelines.
+
+**Approval Automation**: Automatically approve PRs that pass all automated checks and criteria.
+<!-- END MANUAL -->
+
+---
+
+## Github Get PR Review Comments
+
+### What it is
+This block gets all review comments from a GitHub pull request or from a specific review.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves review comments from a GitHub pull request. Review comments are inline comments made on specific lines of code during code review, distinct from general issue-style comments.
+
+You can get all review comments on the PR, or filter to comments from a specific review by providing the review ID. Each comment includes metadata like the file path, line number, author, and comment body.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo | GitHub repository | str | Yes |
+| pr_number | Pull request number | int | Yes |
+| review_id | ID of a specific review to get comments from (optional) | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| comment | Individual review comment with details | Comment |
+| comments | List of all review comments on the pull request | List[CommentItem] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Review Analysis**: Extract all review comments to analyze feedback patterns or generate summaries.
+
+**Comment Tracking**: Monitor which review feedback has been addressed by comparing comments to code changes.
+
+**Documentation**: Collect review discussions for documentation or knowledge base purposes.
+<!-- END MANUAL -->
+
+---
+
+## Github List PR Reviews
+
+### What it is
+This block lists all reviews for a specified GitHub pull request.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves all reviews submitted on a GitHub pull request. It returns information about each review including the reviewer, their verdict (approve, request changes, or comment), and the review body.
+
+Use this to check approval status, see who has reviewed, or analyze the review history of a pull request.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo | GitHub repository | str | Yes |
+| pr_number | Pull request number | int | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| review | Individual review with details | Review |
+| reviews | List of all reviews on the pull request | List[ReviewItem] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Approval Status Check**: Verify that required reviewers have approved before proceeding with merge.
+
+**Review Metrics**: Track review participation and response times across team members.
+
+**Merge Readiness**: Check review states to determine if a PR meets merge requirements.
+<!-- END MANUAL -->
+
+---
+
+## Github Resolve Review Discussion
+
+### What it is
+This block resolves or unresolves a review discussion thread on a GitHub pull request.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block resolves or unresolves a review discussion thread on a GitHub pull request using the GraphQL API. Resolved discussions are collapsed in the GitHub UI, indicating the feedback has been addressed.
+
+Specify the comment ID of the thread to resolve. Set resolve to true to mark as resolved, or false to reopen the discussion.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo | GitHub repository | str | Yes |
+| pr_number | Pull request number | int | Yes |
+| comment_id | ID of the review comment to resolve/unresolve | int | Yes |
+| resolve | Whether to resolve (true) or unresolve (false) the discussion | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the operation was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Automated Resolution**: Mark discussions as resolved when automated systems verify the feedback was addressed.
+
+**Review Cleanup**: Bulk resolve outdated discussions that no longer apply after significant refactoring.
+
+**Review Management**: Programmatically manage discussion states as part of review workflows.
+<!-- END MANUAL -->
+
+---
+
+## Github Submit Pending Review
+
+### What it is
+This block submits a pending (draft) review on a GitHub pull request.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block submits a pending (draft) review on a GitHub pull request. Draft reviews allow you to compose multiple inline comments before publishing them together as a cohesive review.
+
+When submitting, choose the review event: COMMENT for general feedback, APPROVE to approve the PR, or REQUEST_CHANGES to request modifications before merging.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo | GitHub repository | str | Yes |
+| pr_number | Pull request number | int | Yes |
+| review_id | ID of the pending review to submit | int | Yes |
+| event | The review action to perform when submitting | "COMMENT" \| "APPROVE" \| "REQUEST_CHANGES" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the review submission failed | str |
+| state | State of the submitted review | str |
+| html_url | URL of the submitted review | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Batch Review Submission**: Build up multiple comments in a draft, then submit them all at once.
+
+**Review Finalization**: Complete the review process after adding all inline comments and deciding on the verdict.
+
+**Two-Phase Review**: Create draft reviews for internal review before officially submitting to the PR author.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/github/statuses.md b/docs/integrations/github/statuses.md
new file mode 100644
index 0000000000..e1d5656ac4
--- /dev/null
+++ b/docs/integrations/github/statuses.md
@@ -0,0 +1,45 @@
+# GitHub Statuses
+<!-- MANUAL: file_description -->
+Blocks for creating and managing GitHub commit statuses for CI/CD integration.
+<!-- END MANUAL -->
+
+## Github Create Status
+
+### What it is
+Creates a new commit status in a GitHub repository
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a commit status using the GitHub Status API. Commit statuses are simpler than check runs and appear as colored indicators (pending yellow, success green, failure red, error red) on commits and pull requests.
+
+Provide a context label to differentiate this status from others, an optional target URL for detailed results, and a description. Multiple statuses can exist on the same commit with different context labels.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo_url | URL of the GitHub repository | str | Yes |
+| sha | The SHA of the commit to set status for | str | Yes |
+| state | The state of the status (error, failure, pending, success) | "error" \| "failure" \| "pending" \| "success" | Yes |
+| target_url | URL with additional details about this status | str | No |
+| description | Short description of the status | str | No |
+| check_name | Label to differentiate this status from others | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| status | Details of the created status | StatusResult |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**External CI Integration**: Report build status from CI systems that don't have native GitHub integration.
+
+**Deployment Tracking**: Set commit statuses to indicate deployment state (pending, deployed, failed).
+
+**Required Status Checks**: Create statuses that GitHub branch protection rules require before merging.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/github/triggers.md b/docs/integrations/github/triggers.md
new file mode 100644
index 0000000000..11e83b5ee4
--- /dev/null
+++ b/docs/integrations/github/triggers.md
@@ -0,0 +1,230 @@
+# GitHub Triggers
+<!-- MANUAL: file_description -->
+Blocks for triggering workflows from GitHub webhook events like pull requests, issues, releases, and stars.
+<!-- END MANUAL -->
+
+## Github Discussion Trigger
+
+### What it is
+This block triggers on GitHub Discussions events. Great for syncing Q&A to Discord or auto-responding to common questions. Note: Discussions must be enabled on the repository.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a webhook subscription to GitHub Discussions events using the GitHub Webhooks API. When a discussion event occurs (created, edited, answered, etc.), GitHub sends a webhook payload that triggers your workflow.
+
+The block parses the webhook payload and extracts discussion details including the title, body, category, state, and the user who triggered the event. Note that GitHub Discussions must be enabled on the repository.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo | Repository to subscribe to.  **Note:** Make sure your GitHub credentials have permissions to create webhooks on this repo. | str | Yes |
+| events | The discussion events to subscribe to | Events | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the payload could not be processed | str |
+| payload | The complete webhook payload that was received from GitHub. Includes information about the affected resource (e.g. pull request), the event, and the user who triggered the event. | Dict[str, Any] |
+| triggered_by_user | Object representing the GitHub user who triggered the event | Dict[str, Any] |
+| event | The discussion event that triggered the webhook | str |
+| number | The discussion number | int |
+| discussion | The full discussion object | Dict[str, Any] |
+| discussion_url | URL to the discussion | str |
+| title | The discussion title | str |
+| body | The discussion body | str |
+| category | The discussion category object | Dict[str, Any] |
+| category_name | Name of the category | str |
+| state | Discussion state | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Discord Sync**: Post new discussions to Discord channels to keep the community engaged across platforms.
+
+**Auto-Responder**: Automatically respond to common questions in discussions with helpful resources.
+
+**Q&A Routing**: Route discussion questions to the appropriate team members based on category or content.
+<!-- END MANUAL -->
+
+---
+
+## Github Issues Trigger
+
+### What it is
+This block triggers on GitHub issues events. Useful for automated triage, notifications, and welcoming first-time contributors.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a webhook subscription to GitHub Issues events. When an issue event occurs (opened, closed, labeled, assigned, etc.), GitHub sends a webhook payload that triggers your workflow.
+
+The block extracts issue details including the title, body, labels, assignees, state, and the user who triggered the event. Use this for automated triage, notifications, and issue management workflows.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo | Repository to subscribe to.  **Note:** Make sure your GitHub credentials have permissions to create webhooks on this repo. | str | Yes |
+| events | The issue events to subscribe to | Events | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the payload could not be processed | str |
+| payload | The complete webhook payload that was received from GitHub. Includes information about the affected resource (e.g. pull request), the event, and the user who triggered the event. | Dict[str, Any] |
+| triggered_by_user | Object representing the GitHub user who triggered the event | Dict[str, Any] |
+| event | The issue event that triggered the webhook (e.g., 'opened') | str |
+| number | The issue number | int |
+| issue | The full issue object | Dict[str, Any] |
+| issue_url | URL to the issue | str |
+| issue_title | The issue title | str |
+| issue_body | The issue body/description | str |
+| labels | List of labels on the issue | List[Any] |
+| assignees | List of assignees | List[Any] |
+| state | Issue state ('open' or 'closed') | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Automated Triage**: Automatically label new issues based on keywords in title or description.
+
+**Welcome Messages**: Send welcome messages to first-time contributors when they open their first issue.
+
+**Slack Notifications**: Post notifications to Slack when issues are opened or closed.
+<!-- END MANUAL -->
+
+---
+
+## Github Pull Request Trigger
+
+### What it is
+This block triggers on pull request events and outputs the event type and payload.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a webhook subscription to GitHub Pull Request events. When a PR event occurs (opened, closed, merged, review requested, etc.), GitHub sends a webhook payload that triggers your workflow.
+
+The block extracts PR details including the number, URL, and full pull request object. This enables automated code review, CI/CD pipelines, and notification workflows.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo | Repository to subscribe to.  **Note:** Make sure your GitHub credentials have permissions to create webhooks on this repo. | str | Yes |
+| events | The events to subscribe to | Events | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the payload could not be processed | str |
+| payload | The complete webhook payload that was received from GitHub. Includes information about the affected resource (e.g. pull request), the event, and the user who triggered the event. | Dict[str, Any] |
+| triggered_by_user | Object representing the GitHub user who triggered the event | Dict[str, Any] |
+| event | The PR event that triggered the webhook (e.g. 'opened') | str |
+| number | The number of the affected pull request | int |
+| pull_request | Object representing the affected pull request | Dict[str, Any] |
+| pull_request_url | The URL of the affected pull request | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Automated Code Review**: Trigger AI-powered code review when new PRs are opened.
+
+**CI/CD Automation**: Start builds and tests when PRs are created or updated.
+
+**Reviewer Assignment**: Automatically assign reviewers based on files changed or PR author.
+<!-- END MANUAL -->
+
+---
+
+## Github Release Trigger
+
+### What it is
+This block triggers on GitHub release events. Perfect for automating announcements to Discord, Twitter, or other platforms.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a webhook subscription to GitHub Release events. When a release event occurs (published, created, edited, etc.), GitHub sends a webhook payload that triggers your workflow.
+
+The block extracts release details including tag name, release name, release notes, prerelease flag, and associated assets. Use this to automate announcements and deployment workflows.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo | Repository to subscribe to.  **Note:** Make sure your GitHub credentials have permissions to create webhooks on this repo. | str | Yes |
+| events | The release events to subscribe to | Events | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the payload could not be processed | str |
+| payload | The complete webhook payload that was received from GitHub. Includes information about the affected resource (e.g. pull request), the event, and the user who triggered the event. | Dict[str, Any] |
+| triggered_by_user | Object representing the GitHub user who triggered the event | Dict[str, Any] |
+| event | The release event that triggered the webhook (e.g., 'published') | str |
+| release | The full release object | Dict[str, Any] |
+| release_url | URL to the release page | str |
+| tag_name | The release tag name (e.g., 'v1.0.0') | str |
+| release_name | Human-readable release name | str |
+| body | Release notes/description | str |
+| prerelease | Whether this is a prerelease | bool |
+| draft | Whether this is a draft release | bool |
+| assets | List of release assets/files | List[Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Release Announcements**: Post release announcements to Discord, Twitter, or Slack when new versions are published.
+
+**Changelog Distribution**: Automatically send release notes to mailing lists or documentation sites.
+
+**Deployment Triggers**: Initiate deployment workflows when releases are published.
+<!-- END MANUAL -->
+
+---
+
+## Github Star Trigger
+
+### What it is
+This block triggers on GitHub star events. Useful for celebrating milestones (e.g., 1k, 10k stars) or tracking engagement.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a webhook subscription to GitHub Star events. When someone stars or unstars your repository, GitHub sends a webhook payload that triggers your workflow.
+
+The block extracts star details including the timestamp, current star count, repository name, and the user who starred. Use this to track engagement and celebrate milestones.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| repo | Repository to subscribe to.  **Note:** Make sure your GitHub credentials have permissions to create webhooks on this repo. | str | Yes |
+| events | The star events to subscribe to | Events | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the payload could not be processed | str |
+| payload | The complete webhook payload that was received from GitHub. Includes information about the affected resource (e.g. pull request), the event, and the user who triggered the event. | Dict[str, Any] |
+| triggered_by_user | Object representing the GitHub user who triggered the event | Dict[str, Any] |
+| event | The star event that triggered the webhook ('created' or 'deleted') | str |
+| starred_at | ISO timestamp when the repo was starred (empty if deleted) | str |
+| stargazers_count | Current number of stars on the repository | int |
+| repository_name | Full name of the repository (owner/repo) | str |
+| repository_url | URL to the repository | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Milestone Celebrations**: Announce when your repository reaches star milestones (100, 1k, 10k stars).
+
+**Engagement Tracking**: Log star events to track repository popularity over time.
+
+**Thank You Messages**: Send personalized thank you messages to users who star your repository.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/google/calendar.md b/docs/integrations/google/calendar.md
new file mode 100644
index 0000000000..07d286ce6a
--- /dev/null
+++ b/docs/integrations/google/calendar.md
@@ -0,0 +1,94 @@
+# Google Calendar
+<!-- MANUAL: file_description -->
+Blocks for creating and reading events from Google Calendar.
+<!-- END MANUAL -->
+
+## Google Calendar Create Event
+
+### What it is
+This block creates a new event in Google Calendar with customizable parameters.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates events in Google Calendar via the Google Calendar API. It handles various event parameters including timing, location, guest invitations, Google Meet links, and recurring schedules. The block authenticates using your connected Google account credentials.
+
+When you specify guests, they receive email invitations (if notifications are enabled). The Google Meet option adds a video conference link to the event automatically.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| event_title | Title of the event | str | Yes |
+| location | Location of the event | str | No |
+| description | Description of the event | str | No |
+| timing | Specify when the event starts and ends | Timing | No |
+| calendar_id | Calendar ID (use 'primary' for your main calendar) | str | No |
+| guest_emails | Email addresses of guests to invite | List[str] | No |
+| send_notifications | Send email notifications to guests | bool | No |
+| add_google_meet | Include a Google Meet video conference link | bool | No |
+| recurrence | Whether the event repeats | Recurrence | No |
+| reminder_minutes | When to send reminders before the event | List[int] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| event_id | ID of the created event | str |
+| event_link | Link to view the event in Google Calendar | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Automated Meeting Scheduling**: Create calendar events when appointments are booked through a form or scheduling system.
+
+**Event Reminders**: Schedule events with custom reminder notifications for team deadlines or milestones.
+
+**Team Coordination**: Create recurring meetings with Google Meet links when onboarding new team members.
+<!-- END MANUAL -->
+
+---
+
+## Google Calendar Read Events
+
+### What it is
+Retrieves upcoming events from a Google Calendar with filtering options
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block fetches upcoming events from Google Calendar using the Calendar API. It retrieves events within a specified time range, with options to filter by search term or exclude declined events. Pagination support allows handling large numbers of events.
+
+Events are returned with details like title, time, location, and attendees. Use 'primary' as the calendar_id to access your main calendar.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| calendar_id | Calendar ID (use 'primary' for your main calendar) | str | No |
+| max_events | Maximum number of events to retrieve | int | No |
+| start_time | Retrieve events starting from this time | str (date-time) | No |
+| time_range_days | Number of days to look ahead for events | int | No |
+| search_term | Optional search term to filter events by | str | No |
+| page_token | Page token from previous request to get the next batch of events. You can use this if you have lots of events you want to process in a loop | str | No |
+| include_declined_events | Include events you've declined | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the request failed | str |
+| events | List of calendar events in the requested time range | List[CalendarEvent] |
+| event | One of the calendar events in the requested time range | CalendarEvent |
+| next_page_token | Token for retrieving the next page of events if more exist | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Daily Briefings**: Fetch today's events to generate a morning summary or prepare for upcoming meetings.
+
+**Schedule Conflicts**: Check for overlapping events before scheduling new appointments.
+
+**Meeting Preparation**: Retrieve upcoming meetings to pre-load relevant documents or send reminders.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/google/docs.md b/docs/integrations/google/docs.md
new file mode 100644
index 0000000000..b0bf16abc3
--- /dev/null
+++ b/docs/integrations/google/docs.md
@@ -0,0 +1,758 @@
+# Google Docs
+<!-- MANUAL: file_description -->
+Blocks for creating and editing Google Docs documents.
+<!-- END MANUAL -->
+
+## Google Docs Append Markdown
+
+### What it is
+Append Markdown content to the end of a Google Doc with full formatting - ideal for LLM/AI output
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block appends Markdown content to the end of a Google Doc and automatically converts it to native Google Docs formatting using the Google Docs API. It supports headers, bold, italic, links, lists, and code formatting.
+
+Set add_newline to true to insert a line break before the appended content. The document is returned for chaining with other document operations.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| document | Select a Google Doc to append to | Document | No |
+| markdown | Markdown content to append to the document | str | Yes |
+| add_newline | Add a newline before the appended content | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if operation failed | str |
+| result | Result of the append operation | Dict[str, Any] |
+| document | The document for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**AI Report Generation**: Append LLM-generated analysis or summaries to existing report documents with proper formatting.
+
+**Content Aggregation**: Continuously add formatted content from multiple sources to a running document.
+
+**Meeting Notes**: Append AI-transcribed and formatted meeting notes to shared team documents.
+<!-- END MANUAL -->
+
+---
+
+## Google Docs Append Plain Text
+
+### What it is
+Append plain text to the end of a Google Doc (no formatting applied)
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block appends unformatted text to the end of a Google Doc using the Google Docs API. Unlike the Markdown version, text is inserted exactly as provided without any formatting interpretation.
+
+The block finds the document's end index and inserts the text there, with an optional newline prefix. This is useful for log entries, raw data, or when formatting is handled elsewhere.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| document | Select a Google Doc to append to | Document | No |
+| text | Plain text to append (no formatting applied) | str | Yes |
+| add_newline | Add a newline before the appended text | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if append failed | str |
+| result | Result of the append operation | Dict[str, Any] |
+| document | The document for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Activity Logging**: Append timestamped log entries to document-based activity logs.
+
+**Data Capture**: Add raw data or transcript text that will be formatted later.
+
+**Simple Notes**: Quickly add text notes without worrying about formatting.
+<!-- END MANUAL -->
+
+---
+
+## Google Docs Create
+
+### What it is
+Create a new Google Doc
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a new Google Doc in the user's Google Drive using the Google Docs API. You specify a title for the document and optionally provide initial text content.
+
+The newly created document is returned with its ID and URL, allowing immediate access and chaining to other document operations like formatting or sharing.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| title | Title for the new document | str | Yes |
+| initial_content | Optional initial text content | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if creation failed | str |
+| document | The created document | GoogleDriveFile |
+| document_id | ID of the created document | str |
+| document_url | URL to open the document | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Report Templates**: Create new documents for each report cycle with standardized titles.
+
+**Dynamic Document Generation**: Generate personalized documents for customers or projects.
+
+**Workflow Automation**: Create documents as part of onboarding or project kickoff workflows.
+<!-- END MANUAL -->
+
+---
+
+## Google Docs Delete Content
+
+### What it is
+Delete a range of content from a Google Doc
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block removes content from a Google Doc by specifying start and end index positions using the Google Docs API. Index positions are 1-based (index 0 is reserved for a section break).
+
+Use the Get Structure block first to find the correct index positions for content you want to delete. The deletion operation shifts all subsequent content to fill the gap.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| document | Select a Google Doc | Document | No |
+| start_index | Start index of content to delete (must be >= 1, as index 0 is a section break) | int | Yes |
+| end_index | End index of content to delete | int | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if operation failed | str |
+| result | Result of delete operation | Dict[str, Any] |
+| document | The document for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Cleanup**: Remove outdated sections or placeholder text from templates.
+
+**Document Restructuring**: Delete sections as part of document reorganization workflows.
+
+**Revision Management**: Remove draft content before finalizing documents.
+<!-- END MANUAL -->
+
+---
+
+## Google Docs Export
+
+### What it is
+Export a Google Doc to PDF, Word, text, or other formats
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block exports a Google Doc to various formats (PDF, DOCX, ODT) using the Google Drive API's export functionality. The exported content is returned as base64-encoded data for binary formats.
+
+The export preserves document formatting as closely as possible in the target format. PDF exports are ideal for final distribution, while DOCX exports enable further editing in Microsoft Word.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| document | Select a Google Doc to export | Document | No |
+| format | Export format | "application/pdf" \| "application/vnd.openxmlformats-officedocument.wordprocessingml.document" \| "application/vnd.oasis.opendocument.text" \| "text/plain" \| "text/html" \| "application/epub+zip" \| "application/rtf" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if export failed | str |
+| content | Exported content (base64 encoded for binary formats) | str |
+| mime_type | MIME type of exported content | str |
+| document | The document for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Report Distribution**: Export finalized reports as PDF for email distribution or archival.
+
+**Cross-Platform Sharing**: Export to Word format for recipients who don't use Google Docs.
+
+**Backup Creation**: Create periodic PDF exports of important documents for offline storage.
+<!-- END MANUAL -->
+
+---
+
+## Google Docs Find Replace Plain Text
+
+### What it is
+Find and replace plain text in a Google Doc (no formatting applied to replacement)
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block performs a find-and-replace operation across the entire Google Doc using the Google Docs API. It searches for all occurrences of the specified text and replaces them with the provided replacement text.
+
+The replacement preserves the surrounding formatting but does not apply any new formatting to the replacement text. Case-matching is configurable.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| document | Select a Google Doc | Document | No |
+| find_text | Plain text to find | str | Yes |
+| replace_text | Plain text to replace with (no formatting applied) | str | Yes |
+| match_case | Match case when finding text | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if operation failed | str |
+| result | Result with replacement count | Dict[str, Any] |
+| document | The document for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Template Population**: Replace placeholder tokens like {{NAME}} with actual values in document templates.
+
+**Batch Updates**: Update company names, dates, or other text across multiple documents.
+
+**Error Correction**: Fix common typos or outdated terminology across documents.
+<!-- END MANUAL -->
+
+---
+
+## Google Docs Format Text
+
+### What it is
+Apply formatting (bold, italic, color, etc.) to text in a Google Doc
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block applies text formatting to a specific range within a Google Doc using the Google Docs API. You specify start and end indexes and choose formatting options like bold, italic, underline, font size, and text color.
+
+Use the Get Structure block to identify the correct index positions. Multiple formatting options can be applied simultaneously in a single request.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| document | Select a Google Doc | Document | No |
+| start_index | Start index of text to format (must be >= 1, as index 0 is a section break) | int | Yes |
+| end_index | End index of text to format | int | Yes |
+| bold | Make text bold | bool | No |
+| italic | Make text italic | bool | No |
+| underline | Underline text | bool | No |
+| font_size | Font size in points (0 = no change) | int | No |
+| foreground_color | Text color as hex (e.g., #FF0000 for red) | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if operation failed | str |
+| result | Result of format operation | Dict[str, Any] |
+| document | The document for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Highlight Important Content**: Apply bold or color formatting to emphasize key findings or action items.
+
+**Conditional Formatting**: Format text based on workflow conditions (e.g., red for overdue items).
+
+**Document Styling**: Apply consistent formatting to generated content that matches brand guidelines.
+<!-- END MANUAL -->
+
+---
+
+## Google Docs Get Metadata
+
+### What it is
+Get metadata about a Google Doc
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves document metadata from a Google Doc using the Google Docs API. It returns information including the document title, unique ID, current revision ID, and the URL for accessing the document.
+
+This metadata is useful for tracking document versions, building document inventories, or generating links for sharing.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| document | Select a Google Doc | Document | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if operation failed | str |
+| title | Document title | str |
+| document_id | Document ID | str |
+| revision_id | Current revision ID | str |
+| document_url | URL to open the document | str |
+| document | The document for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Document Inventory**: Gather metadata from multiple documents for tracking and cataloging.
+
+**Version Monitoring**: Track revision IDs to detect when documents have been modified.
+
+**Link Generation**: Extract document URLs for sharing via email or other channels.
+<!-- END MANUAL -->
+
+---
+
+## Google Docs Get Structure
+
+### What it is
+Get document structure with index positions for precise editing operations
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block analyzes a Google Doc's structure and returns detailed information about content segments with their index positions using the Google Docs API. Use flat mode for a simple list of segments or detailed mode for full hierarchical structure.
+
+The index positions are essential for precise editing operations like formatting, deletion, or insertion at specific locations within the document.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| document | Select a Google Doc to analyze | Document | No |
+| detailed | Return full hierarchical structure instead of flat segments | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if operation failed | str |
+| segments | Flat list of content segments with indexes (when detailed=False) | List[Dict[str, Any]] |
+| structure | Full hierarchical document structure (when detailed=True) | Dict[str, Any] |
+| document | The document for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Position Discovery**: Find correct index positions before performing insert or delete operations.
+
+**Document Analysis**: Understand document structure for content extraction or manipulation.
+
+**Navigation Aid**: Map document sections to enable targeted content operations.
+<!-- END MANUAL -->
+
+---
+
+## Google Docs Insert Markdown At
+
+### What it is
+Insert formatted Markdown at a specific position in a Google Doc - ideal for LLM/AI output
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block inserts Markdown content at a specific index position within a Google Doc, converting the Markdown to native Google Docs formatting using the Google Docs API. Index 1 inserts at the document start.
+
+The Markdown parser handles headers, bold, italic, links, lists, and code formatting. This enables inserting AI-generated content with proper formatting at precise document locations.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| document | Select a Google Doc to insert into | Document | No |
+| markdown | Markdown content to insert | str | Yes |
+| index | Position index to insert at (1 = start of document) | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if operation failed | str |
+| result | Result of the insert operation | Dict[str, Any] |
+| document | The document for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Insertion**: Insert AI-generated sections at specific locations in templates.
+
+**Document Assembly**: Build documents by inserting formatted content blocks at designated positions.
+
+**Dynamic Reports**: Insert data-driven formatted content at specific sections of report templates.
+<!-- END MANUAL -->
+
+---
+
+## Google Docs Insert Page Break
+
+### What it is
+Insert a page break into a Google Doc
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block inserts a page break at a specified index position in a Google Doc using the Google Docs API. Setting index to 0 inserts at the end of the document.
+
+Page breaks force subsequent content to start on a new page, useful for separating document sections for printing or PDF generation.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| document | Select a Google Doc | Document | No |
+| index | Position to insert page break (0 = end of document) | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if operation failed | str |
+| result | Result of page break insertion | Dict[str, Any] |
+| document | The document for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Report Formatting**: Add page breaks between major sections of generated reports.
+
+**Print Preparation**: Insert page breaks to control page layout before PDF export.
+
+**Document Structure**: Separate document chapters or sections for better readability.
+<!-- END MANUAL -->
+
+---
+
+## Google Docs Insert Plain Text
+
+### What it is
+Insert plain text at a specific position in a Google Doc (no formatting applied)
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block inserts unformatted text at a specific index position within a Google Doc using the Google Docs API. Index 1 inserts at the document start.
+
+Unlike the Markdown insert, text is inserted exactly as provided without any formatting interpretation, preserving surrounding document formatting.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| document | Select a Google Doc to insert into | Document | No |
+| text | Plain text to insert (no formatting applied) | str | Yes |
+| index | Position index to insert at (1 = start of document) | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if insert failed | str |
+| result | Result of the insert operation | Dict[str, Any] |
+| document | The document for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Data Insertion**: Insert raw data values at specific positions in documents.
+
+**Template Variables**: Insert variable values at designated template positions.
+
+**Sequential Content**: Add text entries to specific locations in running documents.
+<!-- END MANUAL -->
+
+---
+
+## Google Docs Insert Table
+
+### What it is
+Insert a table into a Google Doc, optionally with content and Markdown formatting
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block inserts a table into a Google Doc at a specified position using the Google Docs API. You can create empty tables by specifying row/column counts, or provide a 2D array of cell content to create pre-populated tables.
+
+Cell content can optionally be formatted as Markdown, enabling rich formatting like bold headers or links within table cells.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| document | Select a Google Doc | Document | No |
+| rows | Number of rows (ignored if content provided) | int | No |
+| columns | Number of columns (ignored if content provided) | int | No |
+| content | Optional 2D array of cell content, e.g. [['Header1', 'Header2'], ['Row1Col1', 'Row1Col2']]. If provided, rows/columns are derived from this. | List[List[str]] | No |
+| index | Position to insert table (0 = end of document) | int | No |
+| format_as_markdown | Format cell content as Markdown (headers, bold, links, etc.) | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if operation failed | str |
+| result | Result of table insertion | Dict[str, Any] |
+| document | The document for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Data Presentation**: Insert tables to display structured data from APIs or databases.
+
+**Report Tables**: Add summary tables with metrics, comparisons, or status information.
+
+**Template Tables**: Create table structures that get populated with dynamic content.
+<!-- END MANUAL -->
+
+---
+
+## Google Docs Read
+
+### What it is
+Read text content from a Google Doc
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block extracts the plain text content from a Google Doc using the Google Docs API. It returns the document's text content without formatting information, along with the document title.
+
+Use this for content analysis, text processing, or feeding document content to AI models for summarization or other processing.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| document | Select a Google Doc to read | Document | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if read failed | str |
+| text | Plain text content of the document | str |
+| title | Document title | str |
+| document | The document for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Extraction**: Read document text for processing, analysis, or AI summarization.
+
+**Search and Index**: Extract text from documents for full-text search indexing.
+
+**Content Migration**: Read document content to transform or migrate to other systems.
+<!-- END MANUAL -->
+
+---
+
+## Google Docs Replace All With Markdown
+
+### What it is
+Replace entire Google Doc content with formatted Markdown - ideal for LLM/AI output
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block clears all existing content from a Google Doc and replaces it with new formatted Markdown content using the Google Docs API. The Markdown is converted to native Google Docs formatting.
+
+This is ideal for completely regenerating document content from AI-generated Markdown output.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| document | Select a Google Doc to replace content in | Document | No |
+| markdown | Markdown content to replace the document with | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if operation failed | str |
+| result | Result of the replace operation | Dict[str, Any] |
+| document | The document for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Document Regeneration**: Completely replace document content with newly generated AI output.
+
+**Content Refresh**: Update recurring documents with fresh content while preserving the document.
+
+**Template Reset**: Clear and repopulate template documents for new projects or periods.
+<!-- END MANUAL -->
+
+---
+
+## Google Docs Replace Content With Markdown
+
+### What it is
+Find text and replace it with formatted Markdown - ideal for LLM/AI output and templates
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block finds specific text (like a placeholder token) in a Google Doc and replaces it with formatted Markdown content using the Google Docs API. The Markdown is converted to native Google Docs formatting.
+
+Use this for template systems where placeholders like {{SECTION}} are replaced with AI-generated formatted content.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| document | Select a Google Doc | Document | No |
+| find_text | Text to find and replace (e.g., '{{PLACEHOLDER}}' or any text) | str | Yes |
+| markdown | Markdown content to replace the found text with | str | Yes |
+| match_case | Match case when finding text | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if operation failed | str |
+| result | Result with replacement count | Dict[str, Any] |
+| document | The document for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Smart Templates**: Replace placeholder tokens with AI-generated formatted content in templates.
+
+**Dynamic Sections**: Populate document sections with contextual formatted content.
+
+**Mail Merge Plus**: Advanced mail merge with formatted content replacement, not just plain text.
+<!-- END MANUAL -->
+
+---
+
+## Google Docs Replace Range With Markdown
+
+### What it is
+Replace a specific index range in a Google Doc with formatted Markdown - ideal for LLM/AI output
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block replaces content between specific start and end index positions with formatted Markdown content using the Google Docs API. The existing content in the range is deleted and replaced with the new formatted content.
+
+Use Get Structure to find the correct index positions. This enables precise replacement of specific document sections with new formatted content.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| document | Select a Google Doc | Document | No |
+| markdown | Markdown content to insert in place of the range | str | Yes |
+| start_index | Start index of the range to replace (must be >= 1) | int | Yes |
+| end_index | End index of the range to replace | int | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if operation failed | str |
+| result | Result of the replace operation | Dict[str, Any] |
+| document | The document for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Section Updates**: Replace specific document sections with updated content while preserving the rest.
+
+**Targeted Regeneration**: Regenerate specific portions of documents with new AI-generated content.
+
+**Incremental Updates**: Update identified sections of recurring reports without affecting other areas.
+<!-- END MANUAL -->
+
+---
+
+## Google Docs Set Public Access
+
+### What it is
+Make a Google Doc public or private
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block modifies the sharing permissions of a Google Doc using the Google Drive API to make it publicly accessible or private. You can set the access level to reader (view only) or commenter.
+
+When made public, anyone with the link can access the document according to the specified role. The share link is returned for distribution.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| document | Select a Google Doc | Document | No |
+| public | True to make public, False to make private | bool | No |
+| role | Permission role for public access | "reader" \| "commenter" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if operation failed | str |
+| result | Result of the operation | Dict[str, Any] |
+| share_link | Link to the document | str |
+| document | The document for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Public Publishing**: Make finalized documents publicly accessible for broad distribution.
+
+**Access Toggle**: Automate switching document access based on workflow stages.
+
+**Link Sharing**: Generate shareable links for documents that don't require individual access grants.
+<!-- END MANUAL -->
+
+---
+
+## Google Docs Share
+
+### What it is
+Share a Google Doc with specific users
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block shares a Google Doc with specific users by email address using the Google Drive API. You can set the permission level (reader, writer, commenter) and optionally send a notification email with a custom message.
+
+Leave the email blank to just generate a shareable link. The block returns the share link for easy distribution.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| document | Select a Google Doc to share | Document | No |
+| email | Email address to share with. Leave empty for link sharing. | str | No |
+| role | Permission role for the user | "reader" \| "writer" \| "commenter" | No |
+| send_notification | Send notification email to the user | bool | No |
+| message | Optional message to include in notification email | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if share failed | str |
+| result | Result of the share operation | Dict[str, Any] |
+| share_link | Link to the document | str |
+| document | The document for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Automated Collaboration**: Share generated documents with stakeholders automatically after creation.
+
+**Workflow Notifications**: Share documents and notify recipients as part of approval workflows.
+
+**Client Delivery**: Share completed deliverables with clients including notification messages.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/google/gmail.md b/docs/integrations/google/gmail.md
new file mode 100644
index 0000000000..08d0a71a5b
--- /dev/null
+++ b/docs/integrations/google/gmail.md
@@ -0,0 +1,408 @@
+# Google Gmail
+<!-- MANUAL: file_description -->
+Blocks for reading, sending, and managing emails in Gmail.
+<!-- END MANUAL -->
+
+## Gmail Add Label
+
+### What it is
+A block that adds a label to a specific email message in Gmail, creating the label if it doesn't exist.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block first checks if the specified label exists in the user's Gmail account. If it doesn't, it creates the label. Then, it adds the label to the specified email message using the message ID.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| message_id | Message ID to add label to | str | Yes |
+| label_name | Label name to add | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | Label addition result | GmailLabelResult |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Automatically categorizing incoming customer emails based on their content, adding labels like "Urgent," "Feedback," or "Invoice" for easier processing.
+<!-- END MANUAL -->
+
+---
+
+## Gmail Create Draft
+
+### What it is
+Create draft emails in Gmail with automatic HTML detection and proper text formatting. Plain text drafts preserve natural paragraph flow without 78-character line wrapping. HTML content is automatically detected and formatted correctly.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a draft email in Gmail without sending it. The draft is saved to your Drafts folder where you can review and send it manually. The block automatically detects HTML content or you can explicitly set the content type.
+
+Plain text emails preserve natural formatting without forced line breaks. HTML emails support rich formatting. File attachments are supported by providing file paths.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| to | Recipient email addresses | List[str] | Yes |
+| subject | Email subject | str | Yes |
+| body | Email body (plain text or HTML) | str | Yes |
+| cc | CC recipients | List[str] | No |
+| bcc | BCC recipients | List[str] | No |
+| content_type | Content type: 'auto' (default - detects HTML), 'plain', or 'html' | "auto" \| "plain" \| "html" | No |
+| attachments | Files to attach | List[str (file)] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | Draft creation result | GmailDraftResult |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Email Review Workflow**: Create draft emails for human review before sending important communications.
+
+**Newsletter Preparation**: Build email drafts with dynamic content that can be finalized before distribution.
+
+**Template Saving**: Save email templates as drafts for quick access and reuse.
+<!-- END MANUAL -->
+
+---
+
+## Gmail Draft Reply
+
+### What it is
+Create draft replies to Gmail threads with automatic HTML detection and proper text formatting. Plain text draft replies maintain natural paragraph flow without 78-character line wrapping. HTML content is automatically detected and formatted correctly.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a draft reply within an existing email thread. The draft maintains proper threading so your reply appears in the conversation. Use replyAll to respond to all original recipients, or specify custom recipients.
+
+The block preserves the thread context and adds proper email headers for threading. Draft replies can be reviewed in Gmail before sending.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| threadId | Thread ID to reply in | str | Yes |
+| parentMessageId | ID of the message being replied to | str | Yes |
+| to | To recipients | List[str] | No |
+| cc | CC recipients | List[str] | No |
+| bcc | BCC recipients | List[str] | No |
+| replyAll | Reply to all original recipients | bool | No |
+| subject | Email subject | str | No |
+| body | Email body (plain text or HTML) | str | Yes |
+| content_type | Content type: 'auto' (default - detects HTML), 'plain', or 'html' | "auto" \| "plain" \| "html" | No |
+| attachments | Files to attach | List[str (file)] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| draftId | Created draft ID | str |
+| messageId | Draft message ID | str |
+| threadId | Thread ID | str |
+| status | Draft creation status | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Support Response Preparation**: Draft replies to customer inquiries for review before sending.
+
+**Approval Workflows**: Create reply drafts that require manager approval before being sent.
+
+**Scheduled Responses**: Prepare replies to be reviewed and sent at appropriate times.
+<!-- END MANUAL -->
+
+---
+
+## Gmail Forward
+
+### What it is
+Forward Gmail messages to other recipients with automatic HTML detection and proper formatting. Preserves original message threading and attachments.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block forwards an existing Gmail message to new recipients. The original message content is preserved and can include attachments from the original email. You can add your own message before the forwarded content.
+
+The block handles proper email threading and formatting, prepending "Fwd:" to the subject unless you specify a custom subject.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| messageId | ID of the message to forward | str | Yes |
+| to | Recipients to forward the message to | List[str] | Yes |
+| cc | CC recipients | List[str] | No |
+| bcc | BCC recipients | List[str] | No |
+| subject | Optional custom subject (defaults to 'Fwd: [original subject]') | str | No |
+| forwardMessage | Optional message to include before the forwarded content | str | No |
+| includeAttachments | Include attachments from the original message | bool | No |
+| content_type | Content type: 'auto' (default - detects HTML), 'plain', or 'html' | "auto" \| "plain" \| "html" | No |
+| additionalAttachments | Additional files to attach | List[str (file)] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| messageId | Forwarded message ID | str |
+| threadId | Thread ID | str |
+| status | Forward status | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Email Escalation**: Automatically forward emails matching certain criteria to managers or specialists.
+
+**Team Distribution**: Forward important updates to relevant team members based on content.
+
+**Record Keeping**: Forward copies of important communications to an archive address.
+<!-- END MANUAL -->
+
+---
+
+## Gmail Get Profile
+
+### What it is
+Get the authenticated user's Gmail profile details including email address and message statistics.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves profile information for the authenticated Gmail user via the Gmail API. It returns the email address, total message count, thread count, and storage usage statistics.
+
+This is useful for verifying which account is connected and gathering basic mailbox statistics.
+<!-- END MANUAL -->
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| profile | Gmail user profile information | Profile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Account Verification**: Confirm which Gmail account is connected before performing operations.
+
+**Usage Monitoring**: Check storage usage and message counts for mailbox management.
+
+**Multi-Account Workflows**: Get the current user's email address to route workflows appropriately.
+<!-- END MANUAL -->
+
+---
+
+## Gmail Get Thread
+
+### What it is
+A block that retrieves an entire Gmail thread (email conversation) by ID, returning all messages with decoded bodies for reading complete conversations.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves a complete Gmail thread (email conversation) by its thread ID. It returns all messages in the thread with decoded bodies, allowing you to read the full conversation history.
+
+The thread includes all messages, their senders, timestamps, and content, making it easy to analyze entire email conversations.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| threadId | Gmail thread ID | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| thread | Gmail thread with decoded message bodies | Thread |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Conversation Analysis**: Read an entire email thread to understand the full context of a discussion.
+
+**Reply Detection**: Check if a recipient has responded within a conversation thread.
+
+**Thread Summarization**: Gather all messages in a thread for AI-powered summarization.
+<!-- END MANUAL -->
+
+---
+
+## Gmail List Labels
+
+### What it is
+A block that retrieves all labels (categories) from a Gmail account for organizing and categorizing emails.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block connects to the user's Gmail account and requests a list of all labels. It then processes this information and returns a simplified list of label names and their corresponding IDs.
+<!-- END MANUAL -->
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | List of labels | List[Dict[str, Any]] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Creating a dashboard that shows an overview of how many emails are in each category or label in a business email account.
+<!-- END MANUAL -->
+
+---
+
+## Gmail Read
+
+### What it is
+A block that retrieves and reads emails from a Gmail account based on search criteria, returning detailed message information including subject, sender, body, and attachments.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block connects to the user's Gmail account using their credentials, performs a search based on the provided query, and retrieves the specified number of email messages. It then processes each email to extract relevant information and returns the results.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| query | Search query for reading emails | str | No |
+| max_results | Maximum number of emails to retrieve | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| email | Email data | Email |
+| emails | List of email data | List[Email] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Automatically checking for new customer inquiries in a support email inbox and organizing them for quick response.
+<!-- END MANUAL -->
+
+---
+
+## Gmail Remove Label
+
+### What it is
+A block that removes a label from a specific email message in a Gmail account.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block first finds the ID of the specified label in the user's Gmail account. If the label exists, it removes it from the specified email message using the message ID.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| message_id | Message ID to remove label from | str | Yes |
+| label_name | Label name to remove | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | Label removal result | GmailLabelResult |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Automatically removing the "Unread" label from emails after they have been processed by a customer service representative.
+<!-- END MANUAL -->
+
+---
+
+## Gmail Reply
+
+### What it is
+Reply to Gmail threads with automatic HTML detection and proper text formatting. Plain text replies maintain natural paragraph flow without 78-character line wrapping. HTML content is automatically detected and sent with correct MIME type.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block sends a reply directly within an existing Gmail thread. Unlike the draft reply block, this immediately sends the message. The reply maintains proper threading and appears in the conversation.
+
+Use replyAll to respond to all recipients, or specify custom recipients. The block handles email headers and threading automatically.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| threadId | Thread ID to reply in | str | Yes |
+| parentMessageId | ID of the message being replied to | str | Yes |
+| to | To recipients | List[str] | No |
+| cc | CC recipients | List[str] | No |
+| bcc | BCC recipients | List[str] | No |
+| replyAll | Reply to all original recipients | bool | No |
+| subject | Email subject | str | No |
+| body | Email body (plain text or HTML) | str | Yes |
+| content_type | Content type: 'auto' (default - detects HTML), 'plain', or 'html' | "auto" \| "plain" \| "html" | No |
+| attachments | Files to attach | List[str (file)] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| messageId | Sent message ID | str |
+| threadId | Thread ID | str |
+| message | Raw Gmail message object | Dict[str, Any] |
+| email | Parsed email object with decoded body and attachments | Email |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Auto-Acknowledgments**: Automatically send acknowledgment replies to incoming support requests.
+
+**Scheduled Follow-ups**: Reply to threads with follow-up messages at appropriate times.
+
+**Conversation Continuity**: Respond to ongoing threads while keeping all messages organized.
+<!-- END MANUAL -->
+
+---
+
+## Gmail Send
+
+### What it is
+Send emails via Gmail with automatic HTML detection and proper text formatting. Plain text emails are sent without 78-character line wrapping, preserving natural paragraph flow. HTML emails are automatically detected and sent with correct MIME type.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block authenticates with the user's Gmail account, creates an email message with the provided details (recipient, subject, and body), and then sends the email using Gmail's API.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| to | Recipient email addresses | List[str] | Yes |
+| subject | Email subject | str | Yes |
+| body | Email body (plain text or HTML) | str | Yes |
+| cc | CC recipients | List[str] | No |
+| bcc | BCC recipients | List[str] | No |
+| content_type | Content type: 'auto' (default - detects HTML), 'plain', or 'html' | "auto" \| "plain" \| "html" | No |
+| attachments | Files to attach | List[str (file)] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | Send confirmation | GmailSendResult |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Automatically sending confirmation emails to customers after they make a purchase on an e-commerce website.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/content/platform/blocks/google/sheet.md b/docs/integrations/google/sheet.md
similarity index 100%
rename from docs/content/platform/blocks/google/sheet.md
rename to docs/integrations/google/sheet.md
diff --git a/docs/integrations/google/sheets.md b/docs/integrations/google/sheets.md
new file mode 100644
index 0000000000..38393819e5
--- /dev/null
+++ b/docs/integrations/google/sheets.md
@@ -0,0 +1,1470 @@
+# Google Sheets
+<!-- MANUAL: file_description -->
+Blocks for creating, reading, and editing Google Sheets spreadsheets.
+<!-- END MANUAL -->
+
+## Google Sheets Add Column
+
+### What it is
+Add a new column with a header. Can add at the end or insert at a specific position.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block adds a new column to a Google Sheet with a specified header name. You can add the column at the end or insert it before a specific column position. If you provide a default value, all existing data rows will be populated with that value.
+
+The block uses the Google Sheets API to perform the insertion, shifting existing columns to the right when inserting in the middle.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| sheet_name | Sheet name (optional, defaults to first sheet) | str | No |
+| header | Header name for the new column | str | Yes |
+| position | Where to add: 'end' for last column, or column letter (e.g., 'C') to insert before | str | No |
+| default_value | Default value to fill in all data rows (optional). Requires existing data rows. | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | Result of the operation | Dict[str, Any] |
+| column_letter | Letter of the new column (e.g., 'D') | str |
+| column_index | 0-based index of the new column | int |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Schema Evolution**: Add new data fields to existing tracking sheets as requirements change.
+
+**Status Tracking**: Add a "Status" or "Processed" column to mark items as they flow through a workflow.
+
+**Data Enhancement**: Add computed or lookup columns to enrich existing datasets.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Add Dropdown
+
+### What it is
+Add a dropdown list (data validation) to cells. Useful for enforcing valid inputs.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block adds data validation rules to a cell range using the Google Sheets API, creating dropdown menus with predefined options. You can enforce strict validation (reject invalid inputs) or show warnings for non-list values.
+
+The dropdown arrow appears in cells when enabled, providing users with a list of valid choices.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| sheet_name | Sheet name (optional, defaults to first sheet) | str | No |
+| range | Cell range to add dropdown to (e.g., 'B2:B100') | str | Yes |
+| options | List of dropdown options | List[str] | Yes |
+| strict | Reject input not in the list | bool | No |
+| show_dropdown | Show dropdown arrow in cells | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | Result of the operation | Dict[str, Any] |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Status Tracking**: Add status dropdowns (Pending, In Progress, Complete) to task tracking sheets.
+
+**Data Entry Control**: Restrict input options to valid categories, departments, or product types.
+
+**Survey Forms**: Create structured input fields with predefined response options.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Add Note
+
+### What it is
+Add a note to a cell in a Google Sheet
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block adds a text note to a specific cell using the Google Sheets API. Notes appear when hovering over a cell and provide additional context without affecting cell values.
+
+Notes are useful for documentation, explanations, or audit trails that shouldn't modify the underlying data.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | The spreadsheet to add note to | Spreadsheet | No |
+| cell | Cell to add note to (e.g., A1, B2) | str | Yes |
+| note | Note text to add | str | Yes |
+| sheet_name | Name of the sheet. Defaults to first sheet. | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if operation failed | str |
+| result | Result of the operation | Dict[str, Any] |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Audit Trail**: Add notes documenting who modified data and when.
+
+**Data Documentation**: Explain calculation logic or data sources for specific cells.
+
+**Error Flagging**: Mark cells with notes explaining validation issues or anomalies.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Append Row
+
+### What it is
+Append or Add a single row to the end of a Google Sheet. The row is added after the last row with data.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block appends a new row to the end of a Google Sheet after the last row containing data. You provide values as a list that maps to columns in order. The value_input_option controls whether values are parsed (like formulas or dates) or stored as raw text.
+
+This is ideal for continuously adding records to a log or database-style sheet.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| row | Row values to append (e.g., ['Alice', 'alice@example.com', '25']) | List[str] | Yes |
+| sheet_name | Sheet to append to (optional, defaults to first sheet) | str | No |
+| value_input_option | How values are interpreted. USER_ENTERED: parsed like typed input (e.g., '=SUM(A1:A5)' becomes a formula, '1/2/2024' becomes a date). RAW: stored as-is without parsing. | "RAW" \| "USER_ENTERED" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | Append API response | Dict[str, Any] |
+| spreadsheet | The spreadsheet for chaining to other blocks | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Lead Capture**: Append new leads from forms or webhooks to a sales tracking sheet.
+
+**Event Logging**: Add timestamped entries to an activity log or audit trail.
+
+**Data Collection**: Continuously gather data points from sensors, APIs, or user submissions.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Batch Operations
+
+### What it is
+This block performs multiple operations on a Google Sheets spreadsheet in a single batch request.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block combines multiple spreadsheet operations into a single API call using the Google Sheets API's batch update functionality. This is more efficient than making separate calls for each operation.
+
+Operations execute in order and can include various actions like formatting, data validation, and protection. The batch fails if any operation fails.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| operations | List of operations to perform | List[BatchOperation] | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | The result of the batch operations | Dict[str, Any] |
+| spreadsheet | The spreadsheet as a GoogleDriveFile (for chaining to other blocks) | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Bulk Setup**: Apply multiple formatting rules, validations, and protections when setting up new sheets.
+
+**Performance Optimization**: Reduce API calls by batching multiple updates together.
+
+**Atomic Updates**: Ensure multiple related changes succeed or fail together.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Clear
+
+### What it is
+This block clears data from a specified range in a Google Sheets spreadsheet.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block removes all values from a specified cell range using the Google Sheets API. The cells remain but their contents are deleted, preserving any formatting.
+
+Use A1 notation (e.g., "A1:D10" or "Sheet1!B2:C5") to specify the range to clear.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| range | The A1 notation of the range to clear | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | The result of the clear operation | Dict[str, Any] |
+| spreadsheet | The spreadsheet as a GoogleDriveFile (for chaining to other blocks) | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Data Reset**: Clear data areas before importing fresh data from external sources.
+
+**Template Preparation**: Reset input areas of templates before distributing new copies.
+
+**Periodic Cleanup**: Clear temporary or staging data areas as part of scheduled workflows.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Copy To Spreadsheet
+
+### What it is
+Copy a sheet from one spreadsheet to another.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block copies an entire sheet (tab) from one Google Spreadsheet to another using the Google Sheets API. The copied sheet includes all data, formatting, formulas, and structure.
+
+The new sheet is added to the destination spreadsheet with a potentially modified name if a sheet with the same name already exists.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| source_spreadsheet | Select the source spreadsheet | Source Spreadsheet | No |
+| source_sheet_name | Sheet to copy (optional, defaults to first sheet) | str | No |
+| destination_spreadsheet_id | ID of the destination spreadsheet | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | Result of the copy operation | Dict[str, Any] |
+| new_sheet_id | ID of the new sheet in the destination | int |
+| new_sheet_name | Name of the new sheet | str |
+| spreadsheet | The source spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Template Distribution**: Copy template sheets to individual project or client spreadsheets.
+
+**Report Consolidation**: Copy data sheets from multiple sources into a master spreadsheet.
+
+**Backup Creation**: Copy important sheets to backup spreadsheets for archival.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Create Named Range
+
+### What it is
+Create a named range to reference cells by name instead of A1 notation.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a named range in a Google Spreadsheet using the Google Sheets API. Named ranges allow you to reference cells by descriptive names instead of A1 notation, making formulas more readable.
+
+Named ranges can be used in formulas across the spreadsheet and make maintenance easier when data locations change.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| sheet_name | Sheet name (optional, defaults to first sheet) | str | No |
+| name | Name for the range (e.g., 'SalesData', 'CustomerList') | str | Yes |
+| range | Cell range in A1 notation (e.g., 'A1:D10', 'B2:B100') | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | Result of the operation | Dict[str, Any] |
+| named_range_id | ID of the created named range | str |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Formula Clarity**: Create named ranges like "SalesData" or "TaxRate" for clearer formulas.
+
+**Dynamic References**: Define named ranges that formulas reference, simplifying updates.
+
+**Data Source Setup**: Create named ranges for areas that serve as data sources for charts or lookups.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Create Spreadsheet
+
+### What it is
+This block creates a new Google Sheets spreadsheet with specified sheets.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a brand new Google Sheets spreadsheet with a specified title and optional sheet names. The spreadsheet is created in the user's Google Drive and immediately accessible via the returned URL.
+
+The spreadsheet output can be chained to other Sheets blocks for immediate data population.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| title | The title of the new spreadsheet | str | Yes |
+| sheet_names | List of sheet names to create (optional, defaults to single 'Sheet1') | List[str] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | The result containing spreadsheet ID and URL | Dict[str, Any] |
+| spreadsheet | The created spreadsheet as a GoogleDriveFile (for chaining to other blocks) | GoogleDriveFile |
+| spreadsheet_id | The ID of the created spreadsheet | str |
+| spreadsheet_url | The URL of the created spreadsheet | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Report Generation**: Create new spreadsheets for periodic reports with dedicated sheets for different data sections.
+
+**Project Setup**: Automatically create project tracking spreadsheets with pre-defined sheet structures.
+
+**Data Export**: Create new spreadsheets to export data from other systems for sharing.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Delete Column
+
+### What it is
+Delete a column by header name or column letter.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block removes an entire column from a Google Sheet using the Google Sheets API. You can specify the column by its header name or column letter (A, B, C, etc.).
+
+All data in the column is permanently deleted and subsequent columns shift left to fill the gap.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| sheet_name | Sheet name (optional, defaults to first sheet) | str | No |
+| column | Column to delete (header name or column letter like 'A', 'B') | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | Result of the delete operation | Dict[str, Any] |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Schema Cleanup**: Remove deprecated or unused columns from data sheets.
+
+**Data Reduction**: Delete columns containing sensitive or unnecessary information before sharing.
+
+**Structure Maintenance**: Remove temporary calculation columns after processing.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Delete Rows
+
+### What it is
+Delete specific rows from a Google Sheet by their row indices. Works well with FilterRowsBlock output.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block removes specific rows from a Google Sheet by their 1-based row indices using the Google Sheets API. It handles multiple deletions efficiently by processing from bottom to top to maintain correct indices.
+
+Works seamlessly with the Filter Rows block output to delete rows matching specific criteria.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| sheet_name | Sheet name (optional, defaults to first sheet) | str | No |
+| row_indices | 1-based row indices to delete (e.g., [2, 5, 7]) | List[int] | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | Result of the delete operation | Dict[str, Any] |
+| deleted_count | Number of rows deleted | int |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Data Cleanup**: Delete rows with invalid or incomplete data identified by filtering.
+
+**Record Removal**: Remove processed or archived records from active sheets.
+
+**Conditional Deletion**: Delete rows matching specific criteria like outdated entries or cancelled items.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Export Csv
+
+### What it is
+Export a Google Sheet as CSV data
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block exports data from a Google Sheet as a CSV-formatted string using the Google Sheets API. You can choose whether to include headers and specify which sheet to export.
+
+The CSV data can be used for integration with other systems, file downloads, or data processing pipelines.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | The spreadsheet to export from | Spreadsheet | No |
+| sheet_name | Name of the sheet to export. Defaults to first sheet. | str | No |
+| include_headers | Include the first row (headers) in the CSV output | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if export failed | str |
+| csv_data | The sheet data as CSV string | str |
+| row_count | Number of rows exported | int |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**System Integration**: Export data as CSV for import into external systems or databases.
+
+**File Distribution**: Generate CSV exports for email attachments or file downloads.
+
+**Data Backup**: Create periodic CSV backups of spreadsheet data.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Filter Rows
+
+### What it is
+Filter rows in a Google Sheet based on a column condition. Returns matching rows and their indices.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block filters rows in a Google Sheet based on conditions applied to a specific column using the Google Sheets API. Supports operators like equals, not_equals, contains, is_empty, and is_not_empty.
+
+Returns matching rows along with their original 1-based row indices, making it easy to chain with delete or update operations.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| sheet_name | Sheet name (optional, defaults to first sheet) | str | No |
+| filter_column | Column to filter on (header name or column letter like 'A', 'B') | str | Yes |
+| filter_value | Value to filter by (not used for is_empty/is_not_empty operators) | str | No |
+| operator | Filter comparison operator | "equals" \| "not_equals" \| "contains" \| "not_contains" \| "greater_than" \| "less_than" \| "greater_than_or_equal" \| "less_than_or_equal" \| "is_empty" \| "is_not_empty" | No |
+| match_case | Whether to match case in comparisons | bool | No |
+| include_header | Include header row in output | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| rows | Filtered rows (including header if requested) | List[List[str]] |
+| row_indices | Original 1-based row indices of matching rows (useful for deletion) | List[int] |
+| count | Number of matching rows (excluding header) | int |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Conditional Processing**: Filter rows by status to process only pending or active items.
+
+**Data Extraction**: Extract rows matching specific criteria for reports or analysis.
+
+**Cleanup Preparation**: Identify rows to delete based on conditions like empty values or specific statuses.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Find
+
+### What it is
+Find text in a Google Sheets spreadsheet. Returns locations and count of occurrences. Can find all occurrences or just the first one.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block searches for text across a Google Spreadsheet using the Google Sheets API. You can search entire spreadsheets or specific sheets/ranges, with options for case matching and whole-cell matching.
+
+Returns the locations (sheet, row, column) of all matches or just the first one, along with the total count.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| find_text | The text to find | str | Yes |
+| sheet_id | The ID of the specific sheet to search (optional, searches all sheets if not provided) | int | No |
+| match_case | Whether to match case | bool | No |
+| match_entire_cell | Whether to match entire cell | bool | No |
+| find_all | Whether to find all occurrences (true) or just the first one (false) | bool | No |
+| range | The A1 notation range to search in (optional, searches entire sheet if not provided) | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | The result of the find operation including locations and count | Dict[str, Any] |
+| locations | List of cell locations where the text was found | List[Dict[str, Any]] |
+| count | Number of occurrences found | int |
+| spreadsheet | The spreadsheet as a GoogleDriveFile (for chaining to other blocks) | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Data Validation**: Find specific values to verify data presence or locate errors.
+
+**Position Lookup**: Find where specific text appears to determine update locations.
+
+**Audit Checks**: Search for specific terms across spreadsheets for compliance verification.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Find Replace
+
+### What it is
+This block finds and replaces text in a Google Sheets spreadsheet.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block performs find-and-replace operations across a Google Spreadsheet using the Google Sheets API. You can target all sheets or specific ones, with options for case matching and whole-cell matching.
+
+Returns the number of replacements made, enabling verification of the operation's scope.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| find_text | The text to find | str | Yes |
+| replace_text | The text to replace with | str | Yes |
+| sheet_id | The ID of the specific sheet to search (optional, searches all sheets if not provided) | int | No |
+| match_case | Whether to match case | bool | No |
+| match_entire_cell | Whether to match entire cell | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | The result of the find/replace operation including number of replacements | Dict[str, Any] |
+| spreadsheet | The spreadsheet as a GoogleDriveFile (for chaining to other blocks) | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Data Standardization**: Replace variations of terms with standardized values.
+
+**Batch Updates**: Update company names, status values, or codes across entire spreadsheets.
+
+**Error Correction**: Fix systematic typos or outdated values across all sheets.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Format
+
+### What it is
+Format a range in a Google Sheet (sheet optional)
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block applies visual formatting to cell ranges in a Google Sheet using the Google Sheets API. Options include background color, text color, bold, italic, and font size.
+
+Formatting enhances readability and can highlight important data or create visual structure in reports.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| range | A1 notation – sheet optional | str | Yes |
+| background_color | - | Dict[str, Any] | No |
+| text_color | - | Dict[str, Any] | No |
+| bold | - | bool | No |
+| italic | - | bool | No |
+| font_size | - | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | API response or success flag | Dict[str, Any] |
+| spreadsheet | The spreadsheet as a GoogleDriveFile (for chaining to other blocks) | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Header Styling**: Format header rows with bold text and background colors.
+
+**Conditional Highlighting**: Apply colors to highlight important values or warnings.
+
+**Report Presentation**: Style sheets for professional presentation before sharing.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Get Column
+
+### What it is
+Extract all values from a specific column. Useful for getting a list of emails, IDs, or any single field.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block extracts all values from a specific column in a Google Sheet using the Google Sheets API. You can reference the column by header name or column letter, with options to skip empty cells and include/exclude headers.
+
+Returns values as a list for easy iteration or processing in subsequent blocks.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| sheet_name | Sheet name (optional, defaults to first sheet) | str | No |
+| column | Column to extract (header name or column letter like 'A', 'B') | str | Yes |
+| include_header | Include the header in output | bool | No |
+| skip_empty | Skip empty cells | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| values | List of values from the column | List[str] |
+| count | Number of values (excluding header if not included) | int |
+| column_index | 0-based column index | int |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Email Lists**: Extract email column values for sending notifications or marketing.
+
+**ID Processing**: Get all IDs from a column to process records individually.
+
+**Data Validation**: Extract values to check against allowed lists or external databases.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Get Notes
+
+### What it is
+Get notes from cells in a Google Sheet
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves cell notes from a specified range in a Google Sheet using the Google Sheets API. Notes are the comments that appear when hovering over cells.
+
+Returns a list of notes with their cell locations, useful for extracting documentation or audit information.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | The spreadsheet to get notes from | Spreadsheet | No |
+| range | Range to get notes from (e.g., A1:B10) | str | No |
+| sheet_name | Name of the sheet. Defaults to first sheet. | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if operation failed | str |
+| notes | List of notes with cell and text | List[Dict[str, Any]] |
+| count | Number of notes found | int |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Audit Extraction**: Retrieve notes documenting changes or approvals for compliance reports.
+
+**Documentation Review**: Gather explanatory notes for documentation or training purposes.
+
+**Quality Check**: Review cells with notes to identify items requiring attention.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Get Row
+
+### What it is
+Get a specific row by its index. Returns both list and dict formats.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves a specific row from a Google Sheet by its 1-based row index using the Google Sheets API. The row data is returned both as a list (ordered values) and as a dictionary with header names as keys.
+
+The dictionary format makes it easy to access specific fields by name rather than position.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| sheet_name | Sheet name (optional, defaults to first sheet) | str | No |
+| row_index | 1-based row index to retrieve | int | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| row | The row values as a list | List[str] |
+| row_dict | The row as a dictionary (header: value) | Dict[str, str] |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Record Retrieval**: Fetch a specific record by its row number for display or processing.
+
+**Sequential Processing**: Get rows one at a time in a loop for individual processing.
+
+**Verification**: Retrieve specific rows to verify data or confirm updates.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Get Row Count
+
+### What it is
+Get row count and dimensions of a Google Sheet. Useful for knowing where data ends.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block analyzes a Google Sheet to determine its dimensions using the Google Sheets API. It returns total row count, data rows (excluding header), the last row with data, and column count.
+
+This information is essential for determining loop boundaries or validating data presence.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| sheet_name | Sheet name (optional, defaults to first sheet) | str | No |
+| include_header | Include header row in count | bool | No |
+| count_empty | Count rows with only empty cells | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| total_rows | Total number of rows | int |
+| data_rows | Number of data rows (excluding header) | int |
+| last_row | 1-based index of the last row with data | int |
+| column_count | Number of columns | int |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Loop Boundaries**: Determine how many rows to iterate through when processing data.
+
+**Empty Check**: Verify if a sheet has data before attempting to process it.
+
+**Progress Tracking**: Track how many records exist for reporting or dashboards.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Get Unique Values
+
+### What it is
+Get unique values from a column. Useful for building dropdown options or finding distinct categories.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block extracts unique values from a column in a Google Sheet using the Google Sheets API. Optionally includes counts for each value and can sort results by frequency.
+
+Useful for discovering data categories, building dynamic dropdown lists, or analyzing data distribution.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| sheet_name | Sheet name (optional, defaults to first sheet) | str | No |
+| column | Column to get unique values from (header name or column letter) | str | Yes |
+| include_count | Include count of each unique value | bool | No |
+| sort_by_count | Sort results by count (most frequent first) | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| values | List of unique values | List[str] |
+| counts | Count of each unique value (if include_count is True) | Dict[str, int] |
+| total_unique | Total number of unique values | int |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Dynamic Dropdowns**: Build dropdown options from actual data values in the sheet.
+
+**Category Analysis**: Discover all unique categories or types in a dataset.
+
+**Data Quality**: Identify unexpected values or typos by reviewing unique entries.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Import Csv
+
+### What it is
+Import CSV data into a Google Sheet
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block imports CSV-formatted data into a Google Sheet using the Google Sheets API. You can specify the target sheet, starting cell, and whether to clear existing data first.
+
+The CSV string is parsed and written to the sheet, enabling data import from external sources or API responses.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | The spreadsheet to import into | Spreadsheet | No |
+| csv_data | CSV data to import | str | Yes |
+| sheet_name | Name of the sheet. Defaults to first sheet. | str | No |
+| start_cell | Cell to start importing at (e.g., A1, B2) | str | No |
+| clear_existing | Clear existing data before importing | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if import failed | str |
+| result | Import result | Dict[str, Any] |
+| rows_imported | Number of rows imported | int |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Data Import**: Import CSV data from external APIs or file uploads into Google Sheets.
+
+**Bulk Updates**: Replace sheet data with fresh CSV exports from other systems.
+
+**Migration**: Transfer data from CSV-based systems into Google Sheets.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Insert Row
+
+### What it is
+Insert a single row at a specific position. Existing rows shift down.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block inserts a row at a specific position in a Google Sheet using the Google Sheets API. Existing rows at and below the insertion point shift down to make room.
+
+Use value_input_option to control whether values are parsed (USER_ENTERED) or stored as-is (RAW).
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| row | Row values to insert (e.g., ['Alice', 'alice@example.com', '25']) | List[str] | Yes |
+| row_index | 1-based row index where to insert (existing rows shift down) | int | Yes |
+| sheet_name | Sheet name (optional, defaults to first sheet) | str | No |
+| value_input_option | How values are interpreted. USER_ENTERED: parsed like typed input (e.g., '=SUM(A1:A5)' becomes a formula, '1/2/2024' becomes a date). RAW: stored as-is without parsing. | "RAW" \| "USER_ENTERED" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | Result of the insert operation | Dict[str, Any] |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Priority Insertion**: Insert high-priority items at the top of lists.
+
+**Ordered Data Entry**: Add new records at specific positions to maintain sorting.
+
+**Template Rows**: Insert pre-formatted rows at designated positions.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets List Named Ranges
+
+### What it is
+List all named ranges in a spreadsheet.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves all named ranges defined in a Google Spreadsheet using the Google Sheets API. Returns each range's name, ID, and the cell range it references.
+
+Useful for discovering available named ranges or auditing spreadsheet configuration.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| named_ranges | List of named ranges with name, id, and range info | List[Dict[str, Any]] |
+| count | Number of named ranges | int |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Configuration Discovery**: List available named ranges to understand spreadsheet structure.
+
+**Formula Building**: Get named range names for building formulas programmatically.
+
+**Audit Documentation**: Generate documentation of named ranges for spreadsheet templates.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Lookup Row
+
+### What it is
+Look up a row by finding a value in a specific column. Returns the first matching row and optionally specific columns.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block performs a lookup operation similar to VLOOKUP—it finds a row where a specific column matches your search value, then returns that row's data. You can return all columns or just specific ones.
+
+This is useful for database-style lookups where you need to find a record by ID, email, or any unique identifier.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| sheet_name | Sheet name (optional, defaults to first sheet) | str | No |
+| lookup_column | Column to search in (header name or column letter) | str | Yes |
+| lookup_value | Value to search for | str | Yes |
+| return_columns | Columns to return (header names or letters). Empty = all columns. | List[str] | No |
+| match_case | Whether to match case | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| row | The matching row (all or selected columns) | List[str] |
+| row_dict | The matching row as a dictionary (header: value) | Dict[str, str] |
+| row_index | 1-based row index of the match | int |
+| found | Whether a match was found | bool |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Customer Lookup**: Find customer details by email address or customer ID.
+
+**Inventory Check**: Look up product information by SKU or product name.
+
+**Configuration Retrieval**: Fetch settings for a specific entity from a configuration sheet.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Manage Sheet
+
+### What it is
+Create, delete, or copy sheets (sheet optional)
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block manages sheets (tabs) within a Google Spreadsheet using the Google Sheets API. Operations include creating new sheets, deleting existing sheets, or copying sheets within the same spreadsheet.
+
+Use this to dynamically organize spreadsheet structure as part of workflows.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| operation | Operation to perform | "create" \| "delete" \| "copy" | Yes |
+| sheet_name | Target sheet name (defaults to first sheet for delete) | str | No |
+| source_sheet_id | Source sheet ID for copy | int | No |
+| destination_sheet_name | New sheet name for copy | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | Operation result | Dict[str, Any] |
+| spreadsheet | The spreadsheet as a GoogleDriveFile (for chaining to other blocks) | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Dynamic Structure**: Create new sheets for each month, project, or category as needed.
+
+**Template Duplication**: Copy template sheets for new data entry cycles.
+
+**Cleanup Operations**: Delete outdated or temporary sheets after processing.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Metadata
+
+### What it is
+This block retrieves metadata about a Google Sheets spreadsheet including sheet names and properties.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves spreadsheet metadata using the Google Sheets API, including title, sheet names, sheet IDs, and properties like row/column counts and frozen rows.
+
+Useful for understanding spreadsheet structure before performing operations.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | The metadata of the spreadsheet including sheets info | Dict[str, Any] |
+| spreadsheet | The spreadsheet as a GoogleDriveFile (for chaining to other blocks) | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Structure Discovery**: Get sheet names and IDs before performing sheet-specific operations.
+
+**Validation**: Verify spreadsheet structure matches expectations before data operations.
+
+**Dynamic Routing**: Determine which sheets exist to route data appropriately.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Protect Range
+
+### What it is
+Protect a cell range or entire sheet from editing.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block adds protection to cell ranges or entire sheets using the Google Sheets API. Protected ranges can either block editing completely or show warnings while still allowing edits.
+
+Use this to prevent accidental changes to important formulas, headers, or reference data.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| sheet_name | Sheet name (optional, defaults to first sheet) | str | No |
+| range | Cell range to protect (e.g., 'A1:D10'). Leave empty to protect entire sheet. | str | No |
+| description | Description for the protected range | str | No |
+| warning_only | Show warning but allow editing (vs blocking completely) | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | Result of the operation | Dict[str, Any] |
+| protection_id | ID of the protection | int |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Formula Protection**: Protect cells containing critical formulas from accidental modification.
+
+**Header Lock**: Prevent changes to header rows that could break data processing.
+
+**Reference Data**: Protect lookup tables or configuration values from unauthorized changes.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Read
+
+### What it is
+A block that reads data from a Google Sheets spreadsheet using A1 notation range selection.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block connects to Google Sheets using provided credentials, then fetches data from the specified spreadsheet and range.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| range | The A1 notation of the range to read | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | The data read from the spreadsheet | List[List[str]] |
+| spreadsheet | The spreadsheet as a GoogleDriveFile (for chaining to other blocks) | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+A marketing team could use this block to automatically retrieve the latest campaign performance data from a shared Google Sheets document for analysis and reporting.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Remove Duplicates
+
+### What it is
+Remove duplicate rows based on specified columns. Keeps either the first or last occurrence.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block identifies and removes duplicate rows from a Google Sheet using the Google Sheets API. You can specify which columns to check for duplicates and whether to keep the first or last occurrence.
+
+Case sensitivity is configurable for text comparisons.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| sheet_name | Sheet name (optional, defaults to first sheet) | str | No |
+| columns | Columns to check for duplicates (header names or letters). Empty = all columns. | List[str] | No |
+| keep | Which duplicate to keep: 'first' or 'last' | str | No |
+| match_case | Whether to match case when comparing | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | Result of the operation | Dict[str, Any] |
+| removed_count | Number of duplicate rows removed | int |
+| remaining_rows | Number of rows remaining | int |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Data Deduplication**: Clean up sheets containing duplicate entries from multiple data sources.
+
+**Import Cleanup**: Remove duplicates after importing data from external systems.
+
+**List Maintenance**: Keep email lists or contact lists free of duplicate entries.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Set Public Access
+
+### What it is
+Make a Google Spreadsheet public or private
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block modifies the sharing settings of a Google Spreadsheet using the Google Drive API to make it publicly accessible or private. You can set the access level to reader or commenter.
+
+When made public, anyone with the link can access the spreadsheet. The share link is returned for distribution.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | The spreadsheet to modify access for | Spreadsheet | No |
+| public | True to make public, False to make private | bool | No |
+| role | Permission role for public access | "reader" \| "commenter" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if operation failed | str |
+| result | Result of the operation | Dict[str, Any] |
+| share_link | Link to the spreadsheet | str |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Public Dashboards**: Make report spreadsheets publicly viewable for stakeholders.
+
+**Resource Sharing**: Publish reference data or templates for public access.
+
+**Access Control**: Toggle between public and private access based on workflow stages.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Share Spreadsheet
+
+### What it is
+Share a Google Spreadsheet with users or get shareable link
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block shares a Google Spreadsheet with specific users by email address using the Google Drive API. You can set permission levels (reader, writer, commenter) and optionally send notification emails with custom messages.
+
+Leave the email blank to just generate a shareable link.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | The spreadsheet to share | Spreadsheet | No |
+| email | Email address to share with. Leave empty for link sharing. | str | No |
+| role | Permission role for the user | "reader" \| "writer" \| "commenter" | No |
+| send_notification | Send notification email to the user | bool | No |
+| message | Optional message to include in notification email | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if share failed | str |
+| result | Result of the share operation | Dict[str, Any] |
+| share_link | Link to the spreadsheet | str |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Automated Collaboration**: Share generated reports with stakeholders automatically.
+
+**Team Onboarding**: Grant access to project spreadsheets for new team members.
+
+**Client Delivery**: Share completed deliverables with clients including notification messages.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Sort
+
+### What it is
+Sort a Google Sheet by one or two columns. The sheet is sorted in-place.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block sorts data in a Google Sheet by one or two columns using the Google Sheets API. You can specify ascending or descending order for each column and whether to preserve a header row.
+
+Sorting is performed in-place, modifying the sheet directly.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| sheet_name | Sheet name (optional, defaults to first sheet) | str | No |
+| sort_column | Primary column to sort by (header name or column letter) | str | Yes |
+| sort_order | Sort order for primary column | "ascending" \| "descending" | No |
+| secondary_column | Secondary column to sort by (optional) | str | No |
+| secondary_order | Sort order for secondary column | "ascending" \| "descending" | No |
+| has_header | Whether the data has a header row (header won't be sorted) | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | Result of the sort operation | Dict[str, Any] |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Report Organization**: Sort data by date, priority, or status before generating reports.
+
+**Data Presentation**: Organize data alphabetically or numerically for better readability.
+
+**Processing Order**: Sort items by priority to process high-priority items first.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Update Cell
+
+### What it is
+Update a single cell in a Google Sheets spreadsheet.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block updates a single cell in a Google Sheet using the Google Sheets API. Use A1 notation to specify the cell (e.g., "A1" or "Sheet1!B2").
+
+Use value_input_option to control whether values are parsed (USER_ENTERED) or stored as-is (RAW).
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| cell | Cell address in A1 notation (e.g., 'A1', 'Sheet1!B2') | str | Yes |
+| value | Value to write to the cell | str | Yes |
+| value_input_option | How input data should be interpreted | "RAW" \| "USER_ENTERED" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | The result of the update operation | Dict[str, Any] |
+| spreadsheet | The spreadsheet as a GoogleDriveFile (for chaining to other blocks) | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Status Updates**: Update a status cell when processing completes.
+
+**Timestamp Recording**: Write timestamps to cells marking when records were processed.
+
+**Single Value Updates**: Change individual values like totals, flags, or configuration settings.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Update Row
+
+### What it is
+Update a specific row by its index. Can use list or dict format for values.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block updates an entire row in a Google Sheet by its 1-based row index using the Google Sheets API. You can provide values as an ordered list or as a dictionary with header names as keys.
+
+The dictionary format is convenient when you only need to update specific columns.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| sheet_name | Sheet name (optional, defaults to first sheet) | str | No |
+| row_index | 1-based row index to update | int | Yes |
+| values | New values for the row (in column order) | List[str] | No |
+| dict_values | Values as dict with column headers as keys (alternative to values) | Dict[str, str] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | Result of the update operation | Dict[str, Any] |
+| spreadsheet | The spreadsheet for chaining | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Record Updates**: Update specific records identified by row index after lookup.
+
+**Batch Field Updates**: Change multiple fields in a row simultaneously.
+
+**Processing Results**: Write results back to source rows after processing.
+<!-- END MANUAL -->
+
+---
+
+## Google Sheets Write
+
+### What it is
+A block that writes data to a Google Sheets spreadsheet at a specified A1 notation range.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block authenticates with Google Sheets using provided credentials, then updates the specified spreadsheet range with the given data.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| spreadsheet | Select a Google Sheets spreadsheet | Spreadsheet | No |
+| range | The A1 notation of the range to write | str | Yes |
+| values | The data to write to the spreadsheet | List[List[str]] | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if any | str |
+| result | The result of the write operation | Dict[str, Any] |
+| spreadsheet | The spreadsheet as a GoogleDriveFile (for chaining to other blocks) | GoogleDriveFile |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+An automated inventory system could use this block to update stock levels in a Google Sheets spreadsheet whenever products are sold or restocked, ensuring real-time inventory tracking.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/content/platform/blocks/google_maps.md b/docs/integrations/google_maps.md
similarity index 100%
rename from docs/content/platform/blocks/google_maps.md
rename to docs/integrations/google_maps.md
diff --git a/docs/content/platform/blocks/http.md b/docs/integrations/http.md
similarity index 100%
rename from docs/content/platform/blocks/http.md
rename to docs/integrations/http.md
diff --git a/docs/integrations/hubspot/company.md b/docs/integrations/hubspot/company.md
new file mode 100644
index 0000000000..7502a6bbfe
--- /dev/null
+++ b/docs/integrations/hubspot/company.md
@@ -0,0 +1,43 @@
+# HubSpot Company
+<!-- MANUAL: file_description -->
+Blocks for managing HubSpot company records in the CRM.
+<!-- END MANUAL -->
+
+## Hub Spot Company
+
+### What it is
+Manages HubSpot companies - create, update, and retrieve company information
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block interacts with the HubSpot CRM API to manage company records. It supports three operations: create new companies, update existing companies, and retrieve company information by domain.
+
+Company data is passed as a dictionary with standard HubSpot company properties like name, domain, industry, and custom properties.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| operation | Operation to perform (create, update, get) | str | No |
+| company_data | Company data for create/update operations | Dict[str, Any] | No |
+| domain | Company domain for get/update operations | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| company | Company information | Dict[str, Any] |
+| status | Operation status | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Lead Enrichment**: Create or update company records when new leads come in from forms or integrations.
+
+**Data Sync**: Keep company information synchronized between HubSpot and other business systems.
+
+**Account Management**: Retrieve company details to personalize communications or trigger workflows.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/hubspot/contact.md b/docs/integrations/hubspot/contact.md
new file mode 100644
index 0000000000..5958e45a78
--- /dev/null
+++ b/docs/integrations/hubspot/contact.md
@@ -0,0 +1,43 @@
+# HubSpot Contact
+<!-- MANUAL: file_description -->
+Blocks for managing HubSpot contact records in the CRM.
+<!-- END MANUAL -->
+
+## Hub Spot Contact
+
+### What it is
+Manages HubSpot contacts - create, update, and retrieve contact information
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block interacts with the HubSpot CRM API to manage contact records. It supports creating new contacts, updating existing contacts, and retrieving contacts by email address.
+
+Contact data includes standard properties like email, first name, last name, phone, and any custom properties defined in your HubSpot account.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| operation | Operation to perform (create, update, get) | str | No |
+| contact_data | Contact data for create/update operations | Dict[str, Any] | No |
+| email | Email address for get/update operations | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| contact | Contact information | Dict[str, Any] |
+| status | Operation status | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Lead Capture**: Create contacts automatically from form submissions or integrations.
+
+**Contact Updates**: Update contact information when customers change their details.
+
+**CRM Lookup**: Retrieve contact details for personalization or workflow decisions.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/hubspot/engagement.md b/docs/integrations/hubspot/engagement.md
new file mode 100644
index 0000000000..46b93b5ed5
--- /dev/null
+++ b/docs/integrations/hubspot/engagement.md
@@ -0,0 +1,44 @@
+# HubSpot Engagement
+<!-- MANUAL: file_description -->
+Blocks for managing HubSpot engagements like emails and tracking metrics.
+<!-- END MANUAL -->
+
+## Hub Spot Engagement
+
+### What it is
+Manages HubSpot engagements - sends emails and tracks engagement metrics
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block manages HubSpot engagements including sending emails and tracking engagement metrics. Use send_email to send emails through HubSpot, or track_engagement to retrieve engagement history for a contact.
+
+Engagement tracking returns metrics like email opens, clicks, and other interactions within a specified timeframe.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| operation | Operation to perform (send_email, track_engagement) | str | No |
+| email_data | Email data including recipient, subject, content | Dict[str, Any] | No |
+| contact_id | Contact ID for engagement tracking | str | No |
+| timeframe_days | Number of days to look back for engagement | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| result | Operation result | Dict[str, Any] |
+| status | Operation status | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Automated Outreach**: Send personalized emails to contacts based on triggers or workflows.
+
+**Engagement Scoring**: Track contact engagement to prioritize outreach efforts.
+
+**Follow-Up Automation**: Trigger follow-up actions based on engagement metrics.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/content/platform/blocks/ideogram.md b/docs/integrations/ideogram.md
similarity index 100%
rename from docs/content/platform/blocks/ideogram.md
rename to docs/integrations/ideogram.md
diff --git a/docs/content/platform/blocks/iteration.md b/docs/integrations/iteration.md
similarity index 100%
rename from docs/content/platform/blocks/iteration.md
rename to docs/integrations/iteration.md
diff --git a/docs/integrations/jina/chunking.md b/docs/integrations/jina/chunking.md
new file mode 100644
index 0000000000..ecfc78ff6f
--- /dev/null
+++ b/docs/integrations/jina/chunking.md
@@ -0,0 +1,43 @@
+# Jina Chunking
+<!-- MANUAL: file_description -->
+Blocks for splitting text into semantic chunks using Jina AI.
+<!-- END MANUAL -->
+
+## Jina Chunking
+
+### What it is
+Chunks texts using Jina AI's segmentation service
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Jina AI's segmentation service to split texts into semantically meaningful chunks. Unlike simple splitting by character count, Jina's chunking preserves semantic coherence, making it ideal for RAG applications.
+
+Configure maximum chunk length and optionally return token information for each chunk.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| texts | List of texts to chunk | List[Any] | Yes |
+| max_chunk_length | Maximum length of each chunk | int | No |
+| return_tokens | Whether to return token information | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| chunks | List of chunked texts | List[Any] |
+| tokens | List of token information for each chunk | List[Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**RAG Preprocessing**: Chunk documents for retrieval-augmented generation systems.
+
+**Embedding Preparation**: Split long texts into optimal chunks for embedding generation.
+
+**Document Processing**: Break down large documents for analysis or storage in vector databases.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/jina/embeddings.md b/docs/integrations/jina/embeddings.md
new file mode 100644
index 0000000000..c0b217ee92
--- /dev/null
+++ b/docs/integrations/jina/embeddings.md
@@ -0,0 +1,41 @@
+# Jina Embeddings
+<!-- MANUAL: file_description -->
+Blocks for generating text embeddings using Jina AI.
+<!-- END MANUAL -->
+
+## Jina Embedding
+
+### What it is
+Generates embeddings using Jina AI
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block generates vector embeddings for text using Jina AI's embedding models. Embeddings are numerical representations that capture semantic meaning, enabling similarity search and clustering.
+
+Optionally specify which Jina model to use for embedding generation.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| texts | List of texts to embed | List[Any] | Yes |
+| model | Jina embedding model to use | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| embeddings | List of embeddings | List[Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Semantic Search**: Generate embeddings to enable semantic similarity search over documents.
+
+**Vector Database**: Create embeddings for storage in vector databases like Pinecone or Weaviate.
+
+**Document Clustering**: Embed documents to cluster similar content or find related items.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/jina/fact_checker.md b/docs/integrations/jina/fact_checker.md
new file mode 100644
index 0000000000..a1c85d3adf
--- /dev/null
+++ b/docs/integrations/jina/fact_checker.md
@@ -0,0 +1,43 @@
+# Jina Fact Checker
+<!-- MANUAL: file_description -->
+Blocks for verifying statement factuality using Jina AI's Grounding API.
+<!-- END MANUAL -->
+
+## Fact Checker
+
+### What it is
+This block checks the factuality of a given statement using Jina AI's Grounding API.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Jina AI's Grounding API to verify the factuality of statements. It analyzes the statement against reliable sources and returns a factuality score, result, reasoning, and supporting references.
+
+The API searches for evidence and determines whether the statement is supported, contradicted, or uncertain based on available information.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| statement | The statement to check for factuality | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| factuality | The factuality score of the statement | float |
+| result | The result of the factuality check | bool |
+| reason | The reason for the factuality result | str |
+| references | List of references supporting or contradicting the statement | List[Reference] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Verification**: Verify claims in articles or social media posts before publishing.
+
+**AI Output Validation**: Check factuality of AI-generated content to ensure accuracy.
+
+**Research Support**: Validate statements in research or journalism with supporting references.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/jina/search.md b/docs/integrations/jina/search.md
new file mode 100644
index 0000000000..9ce7db9a6f
--- /dev/null
+++ b/docs/integrations/jina/search.md
@@ -0,0 +1,65 @@
+# Jina Search
+<!-- MANUAL: file_description -->
+Blocks for extracting website content and performing web searches using Jina AI.
+<!-- END MANUAL -->
+
+## Extract Website Content
+
+### What it is
+This block scrapes the content from the given web URL.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block sends a request to the given URL, downloads the HTML content, and uses content extraction algorithms to identify and extract the main text content of the page.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| url | The URL to scrape the content from | str | Yes |
+| raw_content | Whether to do a raw scrape of the content or use Jina-ai Reader to scrape the content | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the content cannot be retrieved | str |
+| content | The scraped content from the given URL | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+A data analyst could use this block to automatically extract article content from news websites for sentiment analysis or topic modeling.
+<!-- END MANUAL -->
+
+---
+
+## Search The Web
+
+### What it is
+This block searches the internet for the given search query.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block sends the search query to a search engine API, processes the results, and returns them in a structured format.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| query | The search query to search the web for | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| results | The search results including content from top 5 URLs | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+A content creator could use this block to research trending topics in their field, gathering ideas for new articles or videos.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/linear/comment.md b/docs/integrations/linear/comment.md
new file mode 100644
index 0000000000..ef76c91a75
--- /dev/null
+++ b/docs/integrations/linear/comment.md
@@ -0,0 +1,42 @@
+# Linear Comment
+<!-- MANUAL: file_description -->
+Blocks for creating and managing comments on Linear issues.
+<!-- END MANUAL -->
+
+## Linear Create Comment
+
+### What it is
+Creates a new comment on a Linear issue
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a new comment on a Linear issue using the Linear GraphQL API. Provide the issue ID and comment text, and the block posts the comment and returns its ID.
+
+Comments appear in the issue's activity timeline and notify relevant team members.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| issue_id | ID of the issue to comment on | str | Yes |
+| comment | Comment text to add to the issue | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| comment_id | ID of the created comment | str |
+| comment_body | Text content of the created comment | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Automated Updates**: Post status updates or progress reports to issues automatically.
+
+**Integration Comments**: Add comments when external systems (CI/CD, monitoring) detect relevant changes.
+
+**Cross-Tool Communication**: Post comments from chatbots or customer support integrations.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/linear/issues.md b/docs/integrations/linear/issues.md
new file mode 100644
index 0000000000..8955ba761e
--- /dev/null
+++ b/docs/integrations/linear/issues.md
@@ -0,0 +1,120 @@
+# Linear Issues
+<!-- MANUAL: file_description -->
+Blocks for creating and managing Linear issues.
+<!-- END MANUAL -->
+
+## Linear Create Issue
+
+### What it is
+Creates a new issue on Linear
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a new issue in Linear using the GraphQL API. Specify the team, title, description, and optionally priority and project. The issue is created immediately and assigned to the specified team's workflow.
+
+Returns the created issue's ID and title for tracking or further operations.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| title | Title of the issue | str | Yes |
+| description | Description of the issue | str | Yes |
+| team_name | Name of the team to create the issue on | str | Yes |
+| priority | Priority of the issue | int | No |
+| project_name | Name of the project to create the issue on | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| issue_id | ID of the created issue | str |
+| issue_title | Title of the created issue | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Bug Reporting**: Automatically create issues from error monitoring or customer reports.
+
+**Feature Requests**: Convert feature requests from forms or support tickets into Linear issues.
+
+**Task Automation**: Create issues based on scheduled events or external triggers.
+<!-- END MANUAL -->
+
+---
+
+## Linear Get Project Issues
+
+### What it is
+Gets issues from a Linear project filtered by status and assignee
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves issues from a Linear project with optional filtering by status and assignee. It queries the Linear GraphQL API and returns matching issues with their details.
+
+Optionally include comments in the response for comprehensive issue data.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| project | Name of the project to get issues from | str | Yes |
+| status | Status/state name to filter issues by (e.g., 'In Progress', 'Done') | str | Yes |
+| is_assigned | Filter by assignee status - True to get assigned issues, False to get unassigned issues | bool | No |
+| include_comments | Whether to include comments in the response | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| issues | List of issues matching the criteria | List[Issue] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Sprint Reports**: Generate reports of issues in specific states for sprint reviews.
+
+**Workload Analysis**: Find unassigned or overdue issues across projects.
+
+**Status Dashboards**: Build dashboards showing issue distribution by status.
+<!-- END MANUAL -->
+
+---
+
+## Linear Search Issues
+
+### What it is
+Searches for issues on Linear
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block searches for issues in Linear using a text query. It searches across issue titles, descriptions, and other fields to find matching issues.
+
+Returns a list of issues matching the search term.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| term | Term to search for issues | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| issues | List of issues | List[Issue] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Duplicate Detection**: Search for existing issues before creating new ones.
+
+**Related Issues**: Find issues related to a specific topic or feature.
+
+**Quick Lookup**: Search for issues by keyword for customer support or research.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/linear/projects.md b/docs/integrations/linear/projects.md
new file mode 100644
index 0000000000..2df88fcd96
--- /dev/null
+++ b/docs/integrations/linear/projects.md
@@ -0,0 +1,40 @@
+# Linear Projects
+<!-- MANUAL: file_description -->
+Blocks for searching and managing Linear projects.
+<!-- END MANUAL -->
+
+## Linear Search Projects
+
+### What it is
+Searches for projects on Linear
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block searches for projects in Linear using a text query. It queries the Linear GraphQL API to find projects matching the search term.
+
+Returns a list of projects with their details for further use in workflows.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| term | Term to search for projects | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| projects | List of projects | List[Project] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Project Discovery**: Find projects by name to use in issue creation or queries.
+
+**Portfolio Overview**: Search for projects to build portfolio dashboards.
+
+**Dynamic Forms**: Populate project dropdowns in custom interfaces.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/llm.md b/docs/integrations/llm.md
new file mode 100644
index 0000000000..4e75714e56
--- /dev/null
+++ b/docs/integrations/llm.md
@@ -0,0 +1,777 @@
+# LLM
+<!-- MANUAL: file_description -->
+Blocks for interacting with Large Language Models including AI conversations, image generation, video creation, and intelligent condition evaluation.
+<!-- END MANUAL -->
+
+## AI Ad Maker Video Creator
+
+### What it is
+Creates an AI‑generated 30‑second advert (text + images)
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block generates video advertisements by combining AI-generated visuals with narrated scripts. Line breaks in the script create scene transitions. Choose from various voices and background music options.
+
+Optionally provide your own images via input_media_urls, or let the AI generate visuals. The finished video is returned as a URL for download or embedding.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| script | Short advertising copy. Line breaks create new scenes. | str | Yes |
+| ratio | Aspect ratio | str | No |
+| target_duration | Desired length of the ad in seconds. | int | No |
+| voice | Narration voice | "Lily" \| "Daniel" \| "Brian" \| "Jessica" \| "Charlotte" \| "Callum" \| "Eva" | No |
+| background_music | Background track | "Observer" \| "Futuristic Beat" \| "Science Documentary" \| "Hotline" \| "Bladerunner 2049" \| "A Future" \| "Elysian Embers" \| "Inspiring Cinematic" \| "Bladerunner Remix" \| "Izzamuzzic" \| "Nas" \| "Paris - Else" \| "Snowfall" \| "Burlesque" \| "Corny Candy" \| "Highway Nocturne" \| "I Don't Think So" \| "Losing Your Marbles" \| "Refresher" \| "Tourist" \| "Twin Tyches" \| "Dont Stop Me Abstract Future Bass" | No |
+| input_media_urls | List of image URLs to feature in the advert. | List[str] | No |
+| use_only_provided_media | Restrict visuals to supplied images only. | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| video_url | URL of the finished advert | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Product Marketing**: Create quick promotional videos for products or services.
+
+**Social Media Ads**: Generate short video ads for social media advertising campaigns.
+
+**Content Automation**: Automatically create video ads from product descriptions or scripts.
+<!-- END MANUAL -->
+
+---
+
+## AI Condition
+
+### What it is
+Uses AI to evaluate natural language conditions and provide conditional outputs
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses an LLM to evaluate natural language conditions that can't be expressed with simple comparisons. Describe the condition in plain English, and the AI determines if it's true or false for the given input.
+
+The result routes data to yes_output or no_output, enabling intelligent branching based on meaning, sentiment, or complex criteria.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| input_value | The input value to evaluate with the AI condition | Input Value | Yes |
+| condition | A plaintext English description of the condition to evaluate | str | Yes |
+| yes_value | (Optional) Value to output if the condition is true. If not provided, input_value will be used. | Yes Value | No |
+| no_value | (Optional) Value to output if the condition is false. If not provided, input_value will be used. | No Value | No |
+| model | The language model to use for evaluating the condition. | "o3-mini" \| "o3-2025-04-16" \| "o1" \| "o1-mini" \| "gpt-5.2-2025-12-11" \| "gpt-5.1-2025-11-13" \| "gpt-5-2025-08-07" \| "gpt-5-mini-2025-08-07" \| "gpt-5-nano-2025-08-07" \| "gpt-5-chat-latest" \| "gpt-4.1-2025-04-14" \| "gpt-4.1-mini-2025-04-14" \| "gpt-4o-mini" \| "gpt-4o" \| "gpt-4-turbo" \| "gpt-3.5-turbo" \| "claude-opus-4-1-20250805" \| "claude-opus-4-20250514" \| "claude-sonnet-4-20250514" \| "claude-opus-4-5-20251101" \| "claude-sonnet-4-5-20250929" \| "claude-haiku-4-5-20251001" \| "claude-3-7-sonnet-20250219" \| "claude-3-haiku-20240307" \| "Qwen/Qwen2.5-72B-Instruct-Turbo" \| "nvidia/llama-3.1-nemotron-70b-instruct" \| "meta-llama/Llama-3.3-70B-Instruct-Turbo" \| "meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo" \| "meta-llama/Llama-3.2-3B-Instruct-Turbo" \| "llama-3.3-70b-versatile" \| "llama-3.1-8b-instant" \| "llama3.3" \| "llama3.2" \| "llama3" \| "llama3.1:405b" \| "dolphin-mistral:latest" \| "openai/gpt-oss-120b" \| "openai/gpt-oss-20b" \| "google/gemini-2.5-pro-preview-03-25" \| "google/gemini-3-pro-preview" \| "google/gemini-2.5-flash" \| "google/gemini-2.0-flash-001" \| "google/gemini-2.5-flash-lite-preview-06-17" \| "google/gemini-2.0-flash-lite-001" \| "mistralai/mistral-nemo" \| "cohere/command-r-08-2024" \| "cohere/command-r-plus-08-2024" \| "deepseek/deepseek-chat" \| "deepseek/deepseek-r1-0528" \| "perplexity/sonar" \| "perplexity/sonar-pro" \| "perplexity/sonar-deep-research" \| "nousresearch/hermes-3-llama-3.1-405b" \| "nousresearch/hermes-3-llama-3.1-70b" \| "amazon/nova-lite-v1" \| "amazon/nova-micro-v1" \| "amazon/nova-pro-v1" \| "microsoft/wizardlm-2-8x22b" \| "gryphe/mythomax-l2-13b" \| "meta-llama/llama-4-scout" \| "meta-llama/llama-4-maverick" \| "x-ai/grok-4" \| "x-ai/grok-4-fast" \| "x-ai/grok-4.1-fast" \| "x-ai/grok-code-fast-1" \| "moonshotai/kimi-k2" \| "qwen/qwen3-235b-a22b-thinking-2507" \| "qwen/qwen3-coder" \| "Llama-4-Scout-17B-16E-Instruct-FP8" \| "Llama-4-Maverick-17B-128E-Instruct-FP8" \| "Llama-3.3-8B-Instruct" \| "Llama-3.3-70B-Instruct" \| "v0-1.5-md" \| "v0-1.5-lg" \| "v0-1.0-md" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the AI evaluation is uncertain or fails | str |
+| result | The result of the AI condition evaluation (True or False) | bool |
+| yes_output | The output value if the condition is true | Yes Output |
+| no_output | The output value if the condition is false | No Output |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Sentiment Routing**: Route messages differently based on whether they express frustration or satisfaction.
+
+**Content Moderation**: Check if content contains inappropriate material or policy violations.
+
+**Intent Detection**: Determine if a user message is a question, complaint, or request.
+<!-- END MANUAL -->
+
+---
+
+## AI Conversation
+
+### What it is
+A block that facilitates multi-turn conversations with a Large Language Model (LLM), maintaining context across message exchanges.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block sends the entire conversation history to the chosen LLM, including system messages, user inputs, and previous responses. It then returns the LLM's response as the next part of the conversation.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| prompt | The prompt to send to the language model. | str | No |
+| messages | List of messages in the conversation. | List[Any] | Yes |
+| model | The language model to use for the conversation. | "o3-mini" \| "o3-2025-04-16" \| "o1" \| "o1-mini" \| "gpt-5.2-2025-12-11" \| "gpt-5.1-2025-11-13" \| "gpt-5-2025-08-07" \| "gpt-5-mini-2025-08-07" \| "gpt-5-nano-2025-08-07" \| "gpt-5-chat-latest" \| "gpt-4.1-2025-04-14" \| "gpt-4.1-mini-2025-04-14" \| "gpt-4o-mini" \| "gpt-4o" \| "gpt-4-turbo" \| "gpt-3.5-turbo" \| "claude-opus-4-1-20250805" \| "claude-opus-4-20250514" \| "claude-sonnet-4-20250514" \| "claude-opus-4-5-20251101" \| "claude-sonnet-4-5-20250929" \| "claude-haiku-4-5-20251001" \| "claude-3-7-sonnet-20250219" \| "claude-3-haiku-20240307" \| "Qwen/Qwen2.5-72B-Instruct-Turbo" \| "nvidia/llama-3.1-nemotron-70b-instruct" \| "meta-llama/Llama-3.3-70B-Instruct-Turbo" \| "meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo" \| "meta-llama/Llama-3.2-3B-Instruct-Turbo" \| "llama-3.3-70b-versatile" \| "llama-3.1-8b-instant" \| "llama3.3" \| "llama3.2" \| "llama3" \| "llama3.1:405b" \| "dolphin-mistral:latest" \| "openai/gpt-oss-120b" \| "openai/gpt-oss-20b" \| "google/gemini-2.5-pro-preview-03-25" \| "google/gemini-3-pro-preview" \| "google/gemini-2.5-flash" \| "google/gemini-2.0-flash-001" \| "google/gemini-2.5-flash-lite-preview-06-17" \| "google/gemini-2.0-flash-lite-001" \| "mistralai/mistral-nemo" \| "cohere/command-r-08-2024" \| "cohere/command-r-plus-08-2024" \| "deepseek/deepseek-chat" \| "deepseek/deepseek-r1-0528" \| "perplexity/sonar" \| "perplexity/sonar-pro" \| "perplexity/sonar-deep-research" \| "nousresearch/hermes-3-llama-3.1-405b" \| "nousresearch/hermes-3-llama-3.1-70b" \| "amazon/nova-lite-v1" \| "amazon/nova-micro-v1" \| "amazon/nova-pro-v1" \| "microsoft/wizardlm-2-8x22b" \| "gryphe/mythomax-l2-13b" \| "meta-llama/llama-4-scout" \| "meta-llama/llama-4-maverick" \| "x-ai/grok-4" \| "x-ai/grok-4-fast" \| "x-ai/grok-4.1-fast" \| "x-ai/grok-code-fast-1" \| "moonshotai/kimi-k2" \| "qwen/qwen3-235b-a22b-thinking-2507" \| "qwen/qwen3-coder" \| "Llama-4-Scout-17B-16E-Instruct-FP8" \| "Llama-4-Maverick-17B-128E-Instruct-FP8" \| "Llama-3.3-8B-Instruct" \| "Llama-3.3-70B-Instruct" \| "v0-1.5-md" \| "v0-1.5-lg" \| "v0-1.0-md" | No |
+| max_tokens | The maximum number of tokens to generate in the chat completion. | int | No |
+| ollama_host | Ollama host for local  models | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| response | The model's response to the conversation. | str |
+| prompt | The prompt sent to the language model. | List[Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Creating an interactive chatbot that can maintain context over multiple exchanges, such as a customer service assistant or a language learning companion.
+<!-- END MANUAL -->
+
+---
+
+## AI Image Customizer
+
+### What it is
+Generate and edit custom images using Google's Nano-Banana model from Gemini 2.5. Provide a prompt and optional reference images to create or modify images.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Google's Gemini Nano-Banana models for image generation and editing. Provide a text prompt describing the desired image, and optionally include reference images for style guidance or modification.
+
+Configure aspect ratio to match your needs and choose between JPG or PNG output format. The generated image is returned as a URL.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| prompt | A text description of the image you want to generate | str | Yes |
+| model | The AI model to use for image generation and editing | "google/nano-banana" \| "google/nano-banana-pro" | No |
+| images | Optional list of input images to reference or modify | List[str (file)] | No |
+| aspect_ratio | Aspect ratio of the generated image | "match_input_image" \| "1:1" \| "2:3" \| "3:2" \| "3:4" \| "4:3" \| "4:5" \| "5:4" \| "9:16" \| "16:9" \| "21:9" | No |
+| output_format | Format of the output image | "jpg" \| "png" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| image_url | URL of the generated image | str (file) |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Product Visualization**: Generate product images with different backgrounds or settings.
+
+**Creative Content**: Create unique images for marketing, social media, or presentations.
+
+**Image Modification**: Edit existing images by providing them as references with modification prompts.
+<!-- END MANUAL -->
+
+---
+
+## AI Image Editor
+
+### What it is
+Edit images using BlackForest Labs' Flux Kontext models. Provide a prompt and optional reference image to generate a modified image.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses BlackForest Labs' Flux Kontext models for context-aware image editing. Describe the desired edit in the prompt, and optionally provide an input image to modify.
+
+Choose between Flux Kontext Pro or Max for different quality/speed tradeoffs. Set a seed for reproducible results across multiple runs.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| prompt | Text instruction describing the desired edit | str | Yes |
+| input_image | Reference image URI (jpeg, png, gif, webp) | str (file) | No |
+| aspect_ratio | Aspect ratio of the generated image | "match_input_image" \| "1:1" \| "16:9" \| "9:16" \| "4:3" \| "3:4" \| "3:2" \| "2:3" \| "4:5" \| "5:4" \| "21:9" \| "9:21" \| "2:1" \| "1:2" | No |
+| seed | Random seed. Set for reproducible generation | int | No |
+| model | Model variant to use | "Flux Kontext Pro" \| "Flux Kontext Max" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| output_image | URL of the transformed image | str (file) |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Style Transfer**: Transform images to match different artistic styles or moods.
+
+**Object Editing**: Add, remove, or modify specific elements in existing images.
+
+**Background Changes**: Replace or modify image backgrounds while preserving subjects.
+<!-- END MANUAL -->
+
+---
+
+## AI Image Generator
+
+### What it is
+Generate images using various AI models through a unified interface
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block generates images from text prompts using your choice of AI models including Flux and Recraft. Select the image size (square, landscape, portrait, wide, or tall) and visual style to match your needs.
+
+The unified interface allows switching between models without changing your workflow, making it easy to compare results or adapt to different use cases.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| prompt | Text prompt for image generation | str | Yes |
+| model | The AI model to use for image generation | "Flux 1.1 Pro" \| "Flux 1.1 Pro Ultra" \| "Recraft v3" \| "Stable Diffusion 3.5 Medium" \| "Nano Banana Pro" | No |
+| size | Format of the generated image: - Square: Perfect for profile pictures, icons - Landscape: Traditional photo format - Portrait: Vertical photos, portraits - Wide: Cinematic format, desktop wallpapers - Tall: Mobile wallpapers, social media stories | "square" \| "landscape" \| "portrait" \| "wide" \| "tall" | No |
+| style | Visual style for the generated image | "any" \| "realistic_image" \| "realistic_image/b_and_w" \| "realistic_image/hdr" \| "realistic_image/natural_light" \| "realistic_image/studio_portrait" \| "realistic_image/enterprise" \| "realistic_image/hard_flash" \| "realistic_image/motion_blur" \| "digital_illustration" \| "digital_illustration/pixel_art" \| "digital_illustration/hand_drawn" \| "digital_illustration/grain" \| "digital_illustration/infantile_sketch" \| "digital_illustration/2d_art_poster" \| "digital_illustration/2d_art_poster_2" \| "digital_illustration/handmade_3d" \| "digital_illustration/hand_drawn_outline" \| "digital_illustration/engraving_color" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| image_url | URL of the generated image | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Creation**: Generate images for blog posts, articles, or social media.
+
+**Marketing Visuals**: Create product images, banners, or promotional graphics.
+
+**Illustration**: Generate custom illustrations for presentations or documents.
+<!-- END MANUAL -->
+
+---
+
+## AI List Generator
+
+### What it is
+A block that creates lists of items based on prompts using a Large Language Model (LLM), with optional source data for context.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block formulates a prompt based on the given focus or source data, sends it to the chosen LLM, and then processes the response to ensure it's a valid Python list. It can retry multiple times if the initial attempts fail.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| focus | The focus of the list to generate. | str | No |
+| source_data | The data to generate the list from. | str | No |
+| model | The language model to use for generating the list. | "o3-mini" \| "o3-2025-04-16" \| "o1" \| "o1-mini" \| "gpt-5.2-2025-12-11" \| "gpt-5.1-2025-11-13" \| "gpt-5-2025-08-07" \| "gpt-5-mini-2025-08-07" \| "gpt-5-nano-2025-08-07" \| "gpt-5-chat-latest" \| "gpt-4.1-2025-04-14" \| "gpt-4.1-mini-2025-04-14" \| "gpt-4o-mini" \| "gpt-4o" \| "gpt-4-turbo" \| "gpt-3.5-turbo" \| "claude-opus-4-1-20250805" \| "claude-opus-4-20250514" \| "claude-sonnet-4-20250514" \| "claude-opus-4-5-20251101" \| "claude-sonnet-4-5-20250929" \| "claude-haiku-4-5-20251001" \| "claude-3-7-sonnet-20250219" \| "claude-3-haiku-20240307" \| "Qwen/Qwen2.5-72B-Instruct-Turbo" \| "nvidia/llama-3.1-nemotron-70b-instruct" \| "meta-llama/Llama-3.3-70B-Instruct-Turbo" \| "meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo" \| "meta-llama/Llama-3.2-3B-Instruct-Turbo" \| "llama-3.3-70b-versatile" \| "llama-3.1-8b-instant" \| "llama3.3" \| "llama3.2" \| "llama3" \| "llama3.1:405b" \| "dolphin-mistral:latest" \| "openai/gpt-oss-120b" \| "openai/gpt-oss-20b" \| "google/gemini-2.5-pro-preview-03-25" \| "google/gemini-3-pro-preview" \| "google/gemini-2.5-flash" \| "google/gemini-2.0-flash-001" \| "google/gemini-2.5-flash-lite-preview-06-17" \| "google/gemini-2.0-flash-lite-001" \| "mistralai/mistral-nemo" \| "cohere/command-r-08-2024" \| "cohere/command-r-plus-08-2024" \| "deepseek/deepseek-chat" \| "deepseek/deepseek-r1-0528" \| "perplexity/sonar" \| "perplexity/sonar-pro" \| "perplexity/sonar-deep-research" \| "nousresearch/hermes-3-llama-3.1-405b" \| "nousresearch/hermes-3-llama-3.1-70b" \| "amazon/nova-lite-v1" \| "amazon/nova-micro-v1" \| "amazon/nova-pro-v1" \| "microsoft/wizardlm-2-8x22b" \| "gryphe/mythomax-l2-13b" \| "meta-llama/llama-4-scout" \| "meta-llama/llama-4-maverick" \| "x-ai/grok-4" \| "x-ai/grok-4-fast" \| "x-ai/grok-4.1-fast" \| "x-ai/grok-code-fast-1" \| "moonshotai/kimi-k2" \| "qwen/qwen3-235b-a22b-thinking-2507" \| "qwen/qwen3-coder" \| "Llama-4-Scout-17B-16E-Instruct-FP8" \| "Llama-4-Maverick-17B-128E-Instruct-FP8" \| "Llama-3.3-8B-Instruct" \| "Llama-3.3-70B-Instruct" \| "v0-1.5-md" \| "v0-1.5-lg" \| "v0-1.0-md" | No |
+| max_retries | Maximum number of retries for generating a valid list. | int | No |
+| force_json_output | Whether to force the LLM to produce a JSON-only response. This can increase the block's reliability, but may also reduce the quality of the response because it prohibits the LLM from reasoning before providing its JSON response. | bool | No |
+| max_tokens | The maximum number of tokens to generate in the chat completion. | int | No |
+| ollama_host | Ollama host for local  models | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| generated_list | The generated list. | List[str] |
+| list_item | Each individual item in the list. | str |
+| prompt | The prompt sent to the language model. | List[Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Automatically generating a list of key points or action items from a long meeting transcript or summarizing the main topics discussed in a series of documents.
+<!-- END MANUAL -->
+
+---
+
+## AI Music Generator
+
+### What it is
+This block generates music using Meta's MusicGen model on Replicate.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Meta's MusicGen model to generate original music from text descriptions. Describe the desired music style, mood, and instruments in the prompt, and the AI creates a matching audio track.
+
+Configure duration, temperature (for variety), and output format. Higher temperature produces more diverse results, while lower values stay closer to typical patterns.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| prompt | A description of the music you want to generate | str | Yes |
+| music_gen_model_version | Model to use for generation | "stereo-large" \| "melody-large" \| "large" | No |
+| duration | Duration of the generated audio in seconds | int | No |
+| temperature | Controls the 'conservativeness' of the sampling process. Higher temperature means more diversity | float | No |
+| top_k | Reduces sampling to the k most likely tokens | int | No |
+| top_p | Reduces sampling to tokens with cumulative probability of p. When set to 0 (default), top_k sampling is used | float | No |
+| classifier_free_guidance | Increases the influence of inputs on the output. Higher values produce lower-variance outputs that adhere more closely to inputs | int | No |
+| output_format | Output format for generated audio | "wav" \| "mp3" | No |
+| normalization_strategy | Strategy for normalizing audio | "loudness" \| "clip" \| "peak" \| "rms" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| result | URL of the generated audio file | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Video Soundtracks**: Generate background music for videos, podcasts, or presentations.
+
+**Content Creation**: Create original music for social media or marketing content.
+
+**Prototyping**: Quickly generate music concepts for creative projects.
+<!-- END MANUAL -->
+
+---
+
+## AI Screenshot To Video Ad
+
+### What it is
+Turns a screenshot into an engaging, avatar‑narrated video advert.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates video advertisements featuring a screenshot with AI-generated narration. Provide the screenshot URL and narration script, and the block generates a video with voice and background music.
+
+Choose from various voices and music tracks. The video showcases the screenshot while the AI narrator reads your script.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| script | Narration that will accompany the screenshot. | str | Yes |
+| screenshot_url | Screenshot or image URL to showcase. | str | Yes |
+| ratio | - | str | No |
+| target_duration | - | int | No |
+| voice | - | "Lily" \| "Daniel" \| "Brian" \| "Jessica" \| "Charlotte" \| "Callum" \| "Eva" | No |
+| background_music | - | "Observer" \| "Futuristic Beat" \| "Science Documentary" \| "Hotline" \| "Bladerunner 2049" \| "A Future" \| "Elysian Embers" \| "Inspiring Cinematic" \| "Bladerunner Remix" \| "Izzamuzzic" \| "Nas" \| "Paris - Else" \| "Snowfall" \| "Burlesque" \| "Corny Candy" \| "Highway Nocturne" \| "I Don't Think So" \| "Losing Your Marbles" \| "Refresher" \| "Tourist" \| "Twin Tyches" \| "Dont Stop Me Abstract Future Bass" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| video_url | Rendered video URL | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**App Demos**: Create narrated demonstrations of software features from screenshots.
+
+**Product Tours**: Turn product screenshots into engaging video walkthroughs.
+
+**Tutorial Videos**: Generate instructional videos from step-by-step screenshots.
+<!-- END MANUAL -->
+
+---
+
+## AI Shortform Video Creator
+
+### What it is
+Creates a shortform video using revid.ai
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates short-form videos from scripts using revid.ai. Format scripts with line breaks for scene changes and use [brackets] to guide visual generation. Text outside brackets becomes narration.
+
+Choose video style (stock video, moving images, or AI-generated), voice, background music, and generation presets. The finished video URL is returned for download or sharing.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| script | 1. Use short and punctuated sentences  2. Use linebreaks to create a new clip  3. Text outside of brackets is spoken by the AI, and [text between brackets] will be used to guide the visual generation. For example, [close-up of a cat] will show a close-up of a cat. | str | Yes |
+| ratio | Aspect ratio of the video | str | No |
+| resolution | Resolution of the video | str | No |
+| frame_rate | Frame rate of the video | int | No |
+| generation_preset | Generation preset for visual style - only affects AI-generated visuals | "Default" \| "Anime" \| "Realist" \| "Illustration" \| "Sketch Color" \| "Sketch B&W" \| "Pixar" \| "Japanese Ink" \| "3D Render" \| "Lego" \| "Sci-Fi" \| "Retro Cartoon" \| "Pixel Art" \| "Creative" \| "Photography" \| "Raytraced" \| "Environment" \| "Fantasy" \| "Anime Realism" \| "Movie" \| "Stylized Illustration" \| "Manga" \| "DEFAULT" | No |
+| background_music | Background music track | "Observer" \| "Futuristic Beat" \| "Science Documentary" \| "Hotline" \| "Bladerunner 2049" \| "A Future" \| "Elysian Embers" \| "Inspiring Cinematic" \| "Bladerunner Remix" \| "Izzamuzzic" \| "Nas" \| "Paris - Else" \| "Snowfall" \| "Burlesque" \| "Corny Candy" \| "Highway Nocturne" \| "I Don't Think So" \| "Losing Your Marbles" \| "Refresher" \| "Tourist" \| "Twin Tyches" \| "Dont Stop Me Abstract Future Bass" | No |
+| voice | AI voice to use for narration | "Lily" \| "Daniel" \| "Brian" \| "Jessica" \| "Charlotte" \| "Callum" \| "Eva" | No |
+| video_style | Type of visual media to use for the video | "stockVideo" \| "movingImage" \| "aiVideo" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| video_url | The URL of the created video | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Social Media Content**: Create TikTok, Reels, or Shorts content automatically.
+
+**Explainer Videos**: Generate short educational or promotional videos.
+
+**Content Repurposing**: Convert written content into engaging short-form video.
+<!-- END MANUAL -->
+
+---
+
+## AI Structured Response Generator
+
+### What it is
+A block that generates structured JSON responses using a Large Language Model (LLM), with schema validation and format enforcement.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block sends the input prompt to a chosen LLM, along with any system prompts and expected response format. It then processes the LLM's response, ensuring it matches the expected format, and returns the structured data.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| prompt | The prompt to send to the language model. | str | Yes |
+| expected_format | Expected format of the response. If provided, the response will be validated against this format. The keys should be the expected fields in the response, and the values should be the description of the field. | Dict[str, str] | Yes |
+| list_result | Whether the response should be a list of objects in the expected format. | bool | No |
+| model | The language model to use for answering the prompt. | "o3-mini" \| "o3-2025-04-16" \| "o1" \| "o1-mini" \| "gpt-5.2-2025-12-11" \| "gpt-5.1-2025-11-13" \| "gpt-5-2025-08-07" \| "gpt-5-mini-2025-08-07" \| "gpt-5-nano-2025-08-07" \| "gpt-5-chat-latest" \| "gpt-4.1-2025-04-14" \| "gpt-4.1-mini-2025-04-14" \| "gpt-4o-mini" \| "gpt-4o" \| "gpt-4-turbo" \| "gpt-3.5-turbo" \| "claude-opus-4-1-20250805" \| "claude-opus-4-20250514" \| "claude-sonnet-4-20250514" \| "claude-opus-4-5-20251101" \| "claude-sonnet-4-5-20250929" \| "claude-haiku-4-5-20251001" \| "claude-3-7-sonnet-20250219" \| "claude-3-haiku-20240307" \| "Qwen/Qwen2.5-72B-Instruct-Turbo" \| "nvidia/llama-3.1-nemotron-70b-instruct" \| "meta-llama/Llama-3.3-70B-Instruct-Turbo" \| "meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo" \| "meta-llama/Llama-3.2-3B-Instruct-Turbo" \| "llama-3.3-70b-versatile" \| "llama-3.1-8b-instant" \| "llama3.3" \| "llama3.2" \| "llama3" \| "llama3.1:405b" \| "dolphin-mistral:latest" \| "openai/gpt-oss-120b" \| "openai/gpt-oss-20b" \| "google/gemini-2.5-pro-preview-03-25" \| "google/gemini-3-pro-preview" \| "google/gemini-2.5-flash" \| "google/gemini-2.0-flash-001" \| "google/gemini-2.5-flash-lite-preview-06-17" \| "google/gemini-2.0-flash-lite-001" \| "mistralai/mistral-nemo" \| "cohere/command-r-08-2024" \| "cohere/command-r-plus-08-2024" \| "deepseek/deepseek-chat" \| "deepseek/deepseek-r1-0528" \| "perplexity/sonar" \| "perplexity/sonar-pro" \| "perplexity/sonar-deep-research" \| "nousresearch/hermes-3-llama-3.1-405b" \| "nousresearch/hermes-3-llama-3.1-70b" \| "amazon/nova-lite-v1" \| "amazon/nova-micro-v1" \| "amazon/nova-pro-v1" \| "microsoft/wizardlm-2-8x22b" \| "gryphe/mythomax-l2-13b" \| "meta-llama/llama-4-scout" \| "meta-llama/llama-4-maverick" \| "x-ai/grok-4" \| "x-ai/grok-4-fast" \| "x-ai/grok-4.1-fast" \| "x-ai/grok-code-fast-1" \| "moonshotai/kimi-k2" \| "qwen/qwen3-235b-a22b-thinking-2507" \| "qwen/qwen3-coder" \| "Llama-4-Scout-17B-16E-Instruct-FP8" \| "Llama-4-Maverick-17B-128E-Instruct-FP8" \| "Llama-3.3-8B-Instruct" \| "Llama-3.3-70B-Instruct" \| "v0-1.5-md" \| "v0-1.5-lg" \| "v0-1.0-md" | No |
+| force_json_output | Whether to force the LLM to produce a JSON-only response. This can increase the block's reliability, but may also reduce the quality of the response because it prohibits the LLM from reasoning before providing its JSON response. | bool | No |
+| sys_prompt | The system prompt to provide additional context to the model. | str | No |
+| conversation_history | The conversation history to provide context for the prompt. | List[Dict[str, Any]] | No |
+| retry | Number of times to retry the LLM call if the response does not match the expected format. | int | No |
+| prompt_values | Values used to fill in the prompt. The values can be used in the prompt by putting them in a double curly braces, e.g. {{variable_name}}. | Dict[str, str] | No |
+| max_tokens | The maximum number of tokens to generate in the chat completion. | int | No |
+| compress_prompt_to_fit | Whether to compress the prompt to fit within the model's context window. | bool | No |
+| ollama_host | Ollama host for local  models | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| response | The response object generated by the language model. | Dict[str, Any] \| List[Dict[str, Any]] |
+| prompt | The prompt sent to the language model. | List[Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Extracting specific information from unstructured text, such as generating a product description with predefined fields (name, features, price) from a lengthy product review.
+<!-- END MANUAL -->
+
+---
+
+## AI Text Generator
+
+### What it is
+A block that produces text responses using a Large Language Model (LLM) based on customizable prompts and system instructions.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block sends the input prompt to a chosen LLM, processes the response, and returns the generated text.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| prompt | The prompt to send to the language model. You can use any of the {keys} from Prompt Values to fill in the prompt with values from the prompt values dictionary by putting them in curly braces. | str | Yes |
+| model | The language model to use for answering the prompt. | "o3-mini" \| "o3-2025-04-16" \| "o1" \| "o1-mini" \| "gpt-5.2-2025-12-11" \| "gpt-5.1-2025-11-13" \| "gpt-5-2025-08-07" \| "gpt-5-mini-2025-08-07" \| "gpt-5-nano-2025-08-07" \| "gpt-5-chat-latest" \| "gpt-4.1-2025-04-14" \| "gpt-4.1-mini-2025-04-14" \| "gpt-4o-mini" \| "gpt-4o" \| "gpt-4-turbo" \| "gpt-3.5-turbo" \| "claude-opus-4-1-20250805" \| "claude-opus-4-20250514" \| "claude-sonnet-4-20250514" \| "claude-opus-4-5-20251101" \| "claude-sonnet-4-5-20250929" \| "claude-haiku-4-5-20251001" \| "claude-3-7-sonnet-20250219" \| "claude-3-haiku-20240307" \| "Qwen/Qwen2.5-72B-Instruct-Turbo" \| "nvidia/llama-3.1-nemotron-70b-instruct" \| "meta-llama/Llama-3.3-70B-Instruct-Turbo" \| "meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo" \| "meta-llama/Llama-3.2-3B-Instruct-Turbo" \| "llama-3.3-70b-versatile" \| "llama-3.1-8b-instant" \| "llama3.3" \| "llama3.2" \| "llama3" \| "llama3.1:405b" \| "dolphin-mistral:latest" \| "openai/gpt-oss-120b" \| "openai/gpt-oss-20b" \| "google/gemini-2.5-pro-preview-03-25" \| "google/gemini-3-pro-preview" \| "google/gemini-2.5-flash" \| "google/gemini-2.0-flash-001" \| "google/gemini-2.5-flash-lite-preview-06-17" \| "google/gemini-2.0-flash-lite-001" \| "mistralai/mistral-nemo" \| "cohere/command-r-08-2024" \| "cohere/command-r-plus-08-2024" \| "deepseek/deepseek-chat" \| "deepseek/deepseek-r1-0528" \| "perplexity/sonar" \| "perplexity/sonar-pro" \| "perplexity/sonar-deep-research" \| "nousresearch/hermes-3-llama-3.1-405b" \| "nousresearch/hermes-3-llama-3.1-70b" \| "amazon/nova-lite-v1" \| "amazon/nova-micro-v1" \| "amazon/nova-pro-v1" \| "microsoft/wizardlm-2-8x22b" \| "gryphe/mythomax-l2-13b" \| "meta-llama/llama-4-scout" \| "meta-llama/llama-4-maverick" \| "x-ai/grok-4" \| "x-ai/grok-4-fast" \| "x-ai/grok-4.1-fast" \| "x-ai/grok-code-fast-1" \| "moonshotai/kimi-k2" \| "qwen/qwen3-235b-a22b-thinking-2507" \| "qwen/qwen3-coder" \| "Llama-4-Scout-17B-16E-Instruct-FP8" \| "Llama-4-Maverick-17B-128E-Instruct-FP8" \| "Llama-3.3-8B-Instruct" \| "Llama-3.3-70B-Instruct" \| "v0-1.5-md" \| "v0-1.5-lg" \| "v0-1.0-md" | No |
+| sys_prompt | The system prompt to provide additional context to the model. | str | No |
+| retry | Number of times to retry the LLM call if the response does not match the expected format. | int | No |
+| prompt_values | Values used to fill in the prompt. The values can be used in the prompt by putting them in a double curly braces, e.g. {{variable_name}}. | Dict[str, str] | No |
+| ollama_host | Ollama host for local  models | str | No |
+| max_tokens | The maximum number of tokens to generate in the chat completion. | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| response | The response generated by the language model. | str |
+| prompt | The prompt sent to the language model. | List[Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Generating creative writing, such as short stories or poetry, based on a given theme or starting sentence.
+<!-- END MANUAL -->
+
+---
+
+## AI Text Summarizer
+
+### What it is
+A block that summarizes long texts using a Large Language Model (LLM), with configurable focus topics and summary styles.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block splits the input text into smaller chunks, sends each chunk to an LLM for summarization, and then combines these summaries. If the combined summary is still too long, it repeats the process until a concise summary is achieved.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| text | The text to summarize. | str | Yes |
+| model | The language model to use for summarizing the text. | "o3-mini" \| "o3-2025-04-16" \| "o1" \| "o1-mini" \| "gpt-5.2-2025-12-11" \| "gpt-5.1-2025-11-13" \| "gpt-5-2025-08-07" \| "gpt-5-mini-2025-08-07" \| "gpt-5-nano-2025-08-07" \| "gpt-5-chat-latest" \| "gpt-4.1-2025-04-14" \| "gpt-4.1-mini-2025-04-14" \| "gpt-4o-mini" \| "gpt-4o" \| "gpt-4-turbo" \| "gpt-3.5-turbo" \| "claude-opus-4-1-20250805" \| "claude-opus-4-20250514" \| "claude-sonnet-4-20250514" \| "claude-opus-4-5-20251101" \| "claude-sonnet-4-5-20250929" \| "claude-haiku-4-5-20251001" \| "claude-3-7-sonnet-20250219" \| "claude-3-haiku-20240307" \| "Qwen/Qwen2.5-72B-Instruct-Turbo" \| "nvidia/llama-3.1-nemotron-70b-instruct" \| "meta-llama/Llama-3.3-70B-Instruct-Turbo" \| "meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo" \| "meta-llama/Llama-3.2-3B-Instruct-Turbo" \| "llama-3.3-70b-versatile" \| "llama-3.1-8b-instant" \| "llama3.3" \| "llama3.2" \| "llama3" \| "llama3.1:405b" \| "dolphin-mistral:latest" \| "openai/gpt-oss-120b" \| "openai/gpt-oss-20b" \| "google/gemini-2.5-pro-preview-03-25" \| "google/gemini-3-pro-preview" \| "google/gemini-2.5-flash" \| "google/gemini-2.0-flash-001" \| "google/gemini-2.5-flash-lite-preview-06-17" \| "google/gemini-2.0-flash-lite-001" \| "mistralai/mistral-nemo" \| "cohere/command-r-08-2024" \| "cohere/command-r-plus-08-2024" \| "deepseek/deepseek-chat" \| "deepseek/deepseek-r1-0528" \| "perplexity/sonar" \| "perplexity/sonar-pro" \| "perplexity/sonar-deep-research" \| "nousresearch/hermes-3-llama-3.1-405b" \| "nousresearch/hermes-3-llama-3.1-70b" \| "amazon/nova-lite-v1" \| "amazon/nova-micro-v1" \| "amazon/nova-pro-v1" \| "microsoft/wizardlm-2-8x22b" \| "gryphe/mythomax-l2-13b" \| "meta-llama/llama-4-scout" \| "meta-llama/llama-4-maverick" \| "x-ai/grok-4" \| "x-ai/grok-4-fast" \| "x-ai/grok-4.1-fast" \| "x-ai/grok-code-fast-1" \| "moonshotai/kimi-k2" \| "qwen/qwen3-235b-a22b-thinking-2507" \| "qwen/qwen3-coder" \| "Llama-4-Scout-17B-16E-Instruct-FP8" \| "Llama-4-Maverick-17B-128E-Instruct-FP8" \| "Llama-3.3-8B-Instruct" \| "Llama-3.3-70B-Instruct" \| "v0-1.5-md" \| "v0-1.5-lg" \| "v0-1.0-md" | No |
+| focus | The topic to focus on in the summary | str | No |
+| style | The style of the summary to generate. | "concise" \| "detailed" \| "bullet points" \| "numbered list" | No |
+| max_tokens | The maximum number of tokens to generate in the chat completion. | int | No |
+| chunk_overlap | The number of overlapping tokens between chunks to maintain context. | int | No |
+| ollama_host | Ollama host for local  models | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| summary | The final summary of the text. | str |
+| prompt | The prompt sent to the language model. | List[Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Summarizing lengthy research papers or articles to quickly grasp the main points and key findings.
+<!-- END MANUAL -->
+
+---
+
+## Code Generation
+
+### What it is
+Generate or refactor code using OpenAI's Codex (Responses API).
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses OpenAI's Codex model optimized for code generation and refactoring. Provide a prompt describing the code you need, and optionally a system prompt with coding guidelines or context.
+
+Configure reasoning_effort to control how much the model "thinks" before responding. The block returns generated code along with any reasoning the model produced.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| prompt | Primary coding request passed to the Codex model. | str | Yes |
+| system_prompt | Optional instructions injected via the Responses API instructions field. | str | No |
+| model | Codex-optimized model served via the Responses API. | "gpt-5.1-codex" | No |
+| reasoning_effort | Controls the Responses API reasoning budget. Select 'none' to skip reasoning configs. | "none" \| "low" \| "medium" \| "high" | No |
+| max_output_tokens | Upper bound for generated tokens (hard limit 128,000). Leave blank to let OpenAI decide. | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| response | Code-focused response returned by the Codex model. | str |
+| reasoning | Reasoning summary returned by the model, if available. | str |
+| response_id | ID of the Responses API call for auditing/debugging. | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Code Automation**: Generate boilerplate code, functions, or entire modules from descriptions.
+
+**Refactoring**: Transform existing code to follow different patterns or conventions.
+
+**Code Completion**: Fill in missing implementation details based on signatures or comments.
+<!-- END MANUAL -->
+
+---
+
+## Create Talking Avatar Video
+
+### What it is
+This block integrates with D-ID to create video clips and retrieve their URLs.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block sends a request to the D-ID API with your specified parameters. It then regularly checks the status of the video creation process until it's complete or an error occurs.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| script_input | The text input for the script | str | Yes |
+| provider | The voice provider to use | "microsoft" \| "elevenlabs" \| "amazon" | No |
+| voice_id | The voice ID to use, see [available voice IDs](https://agpt.co/docs/platform/using-ai-services/d_id) | str | No |
+| presenter_id | The presenter ID to use | str | No |
+| driver_id | The driver ID to use | str | No |
+| result_format | The desired result format | "mp4" \| "gif" \| "wav" | No |
+| crop_type | The crop type for the presenter | "wide" \| "square" \| "vertical" | No |
+| subtitles | Whether to include subtitles | bool | No |
+| ssml | Whether the input is SSML | bool | No |
+| max_polling_attempts | Maximum number of polling attempts | int | No |
+| polling_interval | Interval between polling attempts in seconds | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| video_url | The URL of the created video | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+A marketing team could use this block to create engaging video content for social media. They could input a script promoting a new product, select a friendly-looking avatar, and generate a video that explains the product's features in an appealing way.
+<!-- END MANUAL -->
+
+---
+
+## Ideogram Model
+
+### What it is
+This block runs Ideogram models with both simple and advanced settings.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block generates images using Ideogram's models (V1, V2, V3) which excel at rendering text within images. Configure aspect ratio, style type, and optionally enable MagicPrompt for enhanced results.
+
+Advanced options include upscaling, custom color palettes, and negative prompts to exclude unwanted elements. Set a seed for reproducible generation.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| prompt | Text prompt for image generation | str | Yes |
+| ideogram_model_name | The name of the Image Generation Model, e.g., V_3 | "V_3" \| "V_2" \| "V_1" \| "V_1_TURBO" \| "V_2_TURBO" | No |
+| aspect_ratio | Aspect ratio for the generated image | "ASPECT_10_16" \| "ASPECT_16_10" \| "ASPECT_9_16" \| "ASPECT_16_9" \| "ASPECT_3_2" \| "ASPECT_2_3" \| "ASPECT_4_3" \| "ASPECT_3_4" \| "ASPECT_1_1" \| "ASPECT_1_3" \| "ASPECT_3_1" | No |
+| upscale | Upscale the generated image | "AI Upscale" \| "No Upscale" | No |
+| magic_prompt_option | Whether to use MagicPrompt for enhancing the request | "AUTO" \| "ON" \| "OFF" | No |
+| seed | Random seed. Set for reproducible generation | int | No |
+| style_type | Style type to apply, applicable for V_2 and above | "AUTO" \| "GENERAL" \| "REALISTIC" \| "DESIGN" \| "RENDER_3D" \| "ANIME" | No |
+| negative_prompt | Description of what to exclude from the image | str | No |
+| color_palette_name | Color palette preset name, choose 'None' to skip | "NONE" \| "EMBER" \| "FRESH" \| "JUNGLE" \| "MAGIC" \| "MELON" \| "MOSAIC" \| "PASTEL" \| "ULTRAMARINE" | No |
+| custom_color_palette | Only available for model version V_2 or V_2_TURBO. Provide one or more color hex codes (e.g., ['#000030', '#1C0C47', '#9900FF', '#4285F4', '#FFFFFF']) to define a custom color palette. Only used if 'color_palette_name' is 'NONE'. | List[str] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| result | Generated image URL | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Text-Heavy Graphics**: Create images with logos, signs, or text overlays.
+
+**Marketing Materials**: Generate promotional images with clear, readable text.
+
+**Social Media Graphics**: Create quote images, announcements, or branded content with text.
+<!-- END MANUAL -->
+
+---
+
+## Perplexity
+
+### What it is
+Query Perplexity's sonar models with real-time web search capabilities and receive annotated responses with source citations.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries Perplexity's sonar models which combine LLM capabilities with real-time web search. Responses include source citations as annotations, providing verifiable references for the information.
+
+Choose from different sonar model variants including deep-research for comprehensive analysis. The block returns both the response text and structured citation data.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| prompt | The query to send to the Perplexity model. | str | Yes |
+| model | The Perplexity sonar model to use. | "perplexity/sonar" \| "perplexity/sonar-pro" \| "perplexity/sonar-deep-research" | No |
+| system_prompt | Optional system prompt to provide context to the model. | str | No |
+| max_tokens | The maximum number of tokens to generate. | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| response | The response from the Perplexity model. | str |
+| annotations | List of URL citations and annotations from the response. | List[Dict[str, Any]] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Research Automation**: Get answers to questions with verifiable sources for fact-checking.
+
+**Current Events**: Query real-time information that LLMs with static training data can't provide.
+
+**Competitive Intelligence**: Research companies, products, or markets with cited sources.
+<!-- END MANUAL -->
+
+---
+
+## Smart Decision Maker
+
+### What it is
+Uses AI to intelligently decide what tool to use.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block enables agentic behavior by letting an LLM decide which tools to use based on the prompt. Connect tool outputs to feed back results, creating autonomous reasoning loops.
+
+Configure agent_mode_max_iterations to control loop behavior: 0 for single decisions, -1 for infinite looping, or a positive number for max iterations. The block outputs tool calls or a finished message.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| prompt | The prompt to send to the language model. | str | Yes |
+| model | The language model to use for answering the prompt. | "o3-mini" \| "o3-2025-04-16" \| "o1" \| "o1-mini" \| "gpt-5.2-2025-12-11" \| "gpt-5.1-2025-11-13" \| "gpt-5-2025-08-07" \| "gpt-5-mini-2025-08-07" \| "gpt-5-nano-2025-08-07" \| "gpt-5-chat-latest" \| "gpt-4.1-2025-04-14" \| "gpt-4.1-mini-2025-04-14" \| "gpt-4o-mini" \| "gpt-4o" \| "gpt-4-turbo" \| "gpt-3.5-turbo" \| "claude-opus-4-1-20250805" \| "claude-opus-4-20250514" \| "claude-sonnet-4-20250514" \| "claude-opus-4-5-20251101" \| "claude-sonnet-4-5-20250929" \| "claude-haiku-4-5-20251001" \| "claude-3-7-sonnet-20250219" \| "claude-3-haiku-20240307" \| "Qwen/Qwen2.5-72B-Instruct-Turbo" \| "nvidia/llama-3.1-nemotron-70b-instruct" \| "meta-llama/Llama-3.3-70B-Instruct-Turbo" \| "meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo" \| "meta-llama/Llama-3.2-3B-Instruct-Turbo" \| "llama-3.3-70b-versatile" \| "llama-3.1-8b-instant" \| "llama3.3" \| "llama3.2" \| "llama3" \| "llama3.1:405b" \| "dolphin-mistral:latest" \| "openai/gpt-oss-120b" \| "openai/gpt-oss-20b" \| "google/gemini-2.5-pro-preview-03-25" \| "google/gemini-3-pro-preview" \| "google/gemini-2.5-flash" \| "google/gemini-2.0-flash-001" \| "google/gemini-2.5-flash-lite-preview-06-17" \| "google/gemini-2.0-flash-lite-001" \| "mistralai/mistral-nemo" \| "cohere/command-r-08-2024" \| "cohere/command-r-plus-08-2024" \| "deepseek/deepseek-chat" \| "deepseek/deepseek-r1-0528" \| "perplexity/sonar" \| "perplexity/sonar-pro" \| "perplexity/sonar-deep-research" \| "nousresearch/hermes-3-llama-3.1-405b" \| "nousresearch/hermes-3-llama-3.1-70b" \| "amazon/nova-lite-v1" \| "amazon/nova-micro-v1" \| "amazon/nova-pro-v1" \| "microsoft/wizardlm-2-8x22b" \| "gryphe/mythomax-l2-13b" \| "meta-llama/llama-4-scout" \| "meta-llama/llama-4-maverick" \| "x-ai/grok-4" \| "x-ai/grok-4-fast" \| "x-ai/grok-4.1-fast" \| "x-ai/grok-code-fast-1" \| "moonshotai/kimi-k2" \| "qwen/qwen3-235b-a22b-thinking-2507" \| "qwen/qwen3-coder" \| "Llama-4-Scout-17B-16E-Instruct-FP8" \| "Llama-4-Maverick-17B-128E-Instruct-FP8" \| "Llama-3.3-8B-Instruct" \| "Llama-3.3-70B-Instruct" \| "v0-1.5-md" \| "v0-1.5-lg" \| "v0-1.0-md" | No |
+| multiple_tool_calls | Whether to allow multiple tool calls in a single response. | bool | No |
+| sys_prompt | The system prompt to provide additional context to the model. | str | No |
+| conversation_history | The conversation history to provide context for the prompt. | List[Dict[str, Any]] | No |
+| last_tool_output | The output of the last tool that was called. | Last Tool Output | No |
+| retry | Number of times to retry the LLM call if the response does not match the expected format. | int | No |
+| prompt_values | Values used to fill in the prompt. The values can be used in the prompt by putting them in a double curly braces, e.g. {{variable_name}}. | Dict[str, str] | No |
+| max_tokens | The maximum number of tokens to generate in the chat completion. | int | No |
+| ollama_host | Ollama host for local  models | str | No |
+| agent_mode_max_iterations | Maximum iterations for agent mode. 0 = traditional mode (single LLM call, yield tool calls for external execution), -1 = infinite agent mode (loop until finished), 1+ = agent mode with max iterations limit. | int | No |
+| conversation_compaction | Automatically compact the context window once it hits the limit | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| tools | The tools that are available to use. | Tools |
+| finished | The finished message to display to the user. | str |
+| conversations | The conversation history to provide context for the prompt. | List[Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Autonomous Agents**: Build agents that can independently decide which tools to use for tasks.
+
+**Dynamic Workflows**: Create workflows that adapt their execution path based on AI decisions.
+
+**Multi-Tool Orchestration**: Let AI coordinate multiple tools to accomplish complex goals.
+<!-- END MANUAL -->
+
+---
+
+## Unreal Text To Speech
+
+### What it is
+Converts text to speech using the Unreal Speech API
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block converts text into natural-sounding speech using Unreal Speech API. Provide the text content and optionally select a specific voice ID to customize the audio output.
+
+The generated audio is returned as an MP3 URL that can be downloaded, played, or used as input for video creation blocks.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| text | The text to be converted to speech | str | Yes |
+| voice_id | The voice ID to use for text-to-speech conversion | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| mp3_url | The URL of the generated MP3 file | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Voiceover Generation**: Create narration audio for videos, presentations, or tutorials.
+
+**Accessibility**: Convert written content to audio for visually impaired users.
+
+**Audio Content**: Generate podcast intros, announcements, or automated phone messages.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/logic.md b/docs/integrations/logic.md
new file mode 100644
index 0000000000..178ed252a3
--- /dev/null
+++ b/docs/integrations/logic.md
@@ -0,0 +1,351 @@
+# Logic
+<!-- MANUAL: file_description -->
+Blocks for conditional logic, comparisons, calculations, data sampling, and control flow operations in workflows.
+<!-- END MANUAL -->
+
+## Calculator
+
+### What it is
+Performs a mathematical operation on two numbers.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The Calculator block takes in two numbers and an operation choice. It then applies the chosen operation to the numbers and returns the result. If rounding is selected, it rounds the result to the nearest whole number.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| operation | Choose the math operation you want to perform | "Add" \| "Subtract" \| "Multiply" \| "Divide" \| "Power" | Yes |
+| a | Enter the first number (A) | float | Yes |
+| b | Enter the second number (B) | float | Yes |
+| round_result | Do you want to round the result to a whole number? | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| result | The result of your calculation | float |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+A user wants to quickly perform a calculation, such as adding two numbers or calculating a percentage. They can input the numbers and operation into this block and receive the result instantly.
+<!-- END MANUAL -->
+
+---
+
+## Condition
+
+### What it is
+Handles conditional logic based on comparison operators
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block compares two values using standard operators (==, !=, >, <, >=, <=) and routes data based on the result. The comparison result determines which output receives data: yes_output for true conditions, no_output for false.
+
+Optionally specify yes_value and no_value to output different data than the input values. If not specified, value1 is used as the output value.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| value1 | Enter the first value for comparison | Value1 | Yes |
+| operator | Choose the comparison operator | "==" \| "!=" \| ">" \| "<" \| ">=" \| "<=" | Yes |
+| value2 | Enter the second value for comparison | Value2 | Yes |
+| yes_value | (Optional) Value to output if the condition is true. If not provided, value1 will be used. | Yes Value | No |
+| no_value | (Optional) Value to output if the condition is false. If not provided, value1 will be used. | No Value | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| result | The result of the condition evaluation (True or False) | bool |
+| yes_output | The output value if the condition is true | Yes Output |
+| no_output | The output value if the condition is false | No Output |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Threshold Checks**: Route workflow differently when values exceed limits (e.g., order total > $100 triggers approval).
+
+**Status Validation**: Check if a status equals "complete" or "error" to branch workflow logic.
+
+**Numeric Comparisons**: Compare scores, counts, or metrics to conditionally trigger actions.
+<!-- END MANUAL -->
+
+---
+
+## Count Items
+
+### What it is
+Counts the number of items in a collection.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The Count Items block receives a collection as input. It then determines the type of collection and uses the appropriate method to count the items. For most collections, it uses the length function. For other iterable objects, it counts the items one by one.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| collection | Enter the collection you want to count. This can be a list, dictionary, string, or any other iterable. | Collection | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| count | The number of items in the collection | int |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+A user has a list of customer names and wants to quickly determine how many customers are in the list. They can input the list into this block and receive the total count immediately.
+<!-- END MANUAL -->
+
+---
+
+## Data Sampling
+
+### What it is
+This block samples data from a given dataset using various sampling methods.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block extracts a sample from a dataset using various methods: random sampling, systematic sampling (every nth item), or top-N selection. Advanced options include stratified sampling by key, weighted sampling, and cluster sampling.
+
+Configure sample_size to control how many items to select. Use random_seed for reproducible results. The accumulate option collects data before sampling, useful when processing streaming inputs.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| data | The dataset to sample from. Can be a single dictionary, a list of dictionaries, or a list of lists. | Dict[str, Any] \| List[Dict[str, Any] \| List[Any]] | Yes |
+| sample_size | The number of samples to take from the dataset. | int | No |
+| sampling_method | The method to use for sampling. | "random" \| "systematic" \| "top" \| "bottom" \| "stratified" \| "weighted" \| "reservoir" \| "cluster" | No |
+| accumulate | Whether to accumulate data before sampling. | bool | No |
+| random_seed | Seed for random number generator (optional). | int | No |
+| stratify_key | Key to use for stratified sampling (required for stratified sampling). | str | No |
+| weight_key | Key to use for weighted sampling (required for weighted sampling). | str | No |
+| cluster_key | Key to use for cluster sampling (required for cluster sampling). | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| sampled_data | The sampled subset of the input data. | List[Dict[str, Any] \| List[Any]] |
+| sample_indices | The indices of the sampled data in the original dataset. | List[int] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**A/B Testing**: Randomly sample users or records for testing different workflow paths.
+
+**Representative Subsets**: Extract stratified samples from large datasets for analysis or testing.
+
+**Performance Testing**: Select a smaller sample from large data for workflow development and debugging.
+<!-- END MANUAL -->
+
+---
+
+## If Input Matches
+
+### What it is
+Handles conditional logic based on comparison operators
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block checks if an input matches a specified value and routes data accordingly. When the input equals the value, data flows to yes_output; otherwise, it goes to no_output.
+
+Use yes_value and no_value to specify what data to output in each case. This provides a simple equality check for branching workflow logic.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| input | The input to match against | Input | Yes |
+| value | The value to output if the input matches | Value | Yes |
+| yes_value | The value to output if the input matches | Yes Value | No |
+| no_value | The value to output if the input does not match | No Value | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| result | The result of the condition evaluation (True or False) | bool |
+| yes_output | The output value if the condition is true | Yes Output |
+| no_output | The output value if the condition is false | No Output |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Category Routing**: Route items to different processing paths based on their category or type.
+
+**Feature Flags**: Check if a feature flag equals "enabled" to conditionally execute new functionality.
+
+**Status Handling**: Branch workflow based on specific status values like "pending", "approved", or "rejected".
+<!-- END MANUAL -->
+
+---
+
+## Pinecone Init
+
+### What it is
+Initializes a Pinecone index
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block initializes or connects to a Pinecone vector database index. Specify the index name, vector dimension, and distance metric (cosine, euclidean, or dot product) for new indexes.
+
+For serverless deployment, configure the cloud provider and region. The block returns the initialized index name for use with insert and query operations.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| index_name | Name of the Pinecone index | str | Yes |
+| dimension | Dimension of the vectors | int | No |
+| metric | Distance metric for the index | str | No |
+| cloud | Cloud provider for serverless | str | No |
+| region | Region for serverless | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| index | Name of the initialized Pinecone index | str |
+| message | Status message | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**RAG Pipeline Setup**: Initialize a vector index for storing document embeddings in retrieval-augmented generation.
+
+**Semantic Search**: Set up a vector database for similarity search across products, documents, or media.
+
+**Knowledge Base**: Create a searchable vector store for FAQ answers or support documentation.
+<!-- END MANUAL -->
+
+---
+
+## Pinecone Insert
+
+### What it is
+Upload data to a Pinecone index
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uploads vectors and associated text chunks to a Pinecone index. Each chunk is paired with its embedding vector, and optional metadata can be attached for filtering during queries.
+
+Use namespaces to organize vectors into logical groups within the same index. The upsert operation adds new vectors or updates existing ones with matching IDs.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| index | Initialized Pinecone index | str | Yes |
+| chunks | List of text chunks to ingest | List[Any] | Yes |
+| embeddings | List of embeddings corresponding to the chunks | List[Any] | Yes |
+| namespace | Namespace to use in Pinecone | str | No |
+| metadata | Additional metadata to store with each vector | Dict[str, Any] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| upsert_response | Response from Pinecone upsert operation | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Document Indexing**: Store document chunks with their embeddings for later semantic search.
+
+**Knowledge Ingestion**: Add FAQ entries, product descriptions, or support articles to a searchable index.
+
+**Memory Storage**: Store conversation history or agent memories as searchable vectors.
+<!-- END MANUAL -->
+
+---
+
+## Pinecone Query
+
+### What it is
+Queries a Pinecone index
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block searches a Pinecone index for vectors similar to a query vector. Specify top_k to control how many results to return, and use namespace to search within a specific partition.
+
+Results include similarity scores and optionally the vector values and metadata. Combined results aggregate the text chunks for easy use in RAG pipelines.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| query_vector | Query vector | List[Any] | Yes |
+| namespace | Namespace to query in Pinecone | str | No |
+| top_k | Number of top results to return | int | No |
+| include_values | Whether to include vector values in the response | bool | No |
+| include_metadata | Whether to include metadata in the response | bool | No |
+| host | Host for pinecone | str | No |
+| idx_name | Index name for pinecone | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| results | Query results from Pinecone | Results |
+| combined_results | Combined results from Pinecone | Combined Results |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Semantic Search**: Find the most relevant documents or answers based on meaning, not just keywords.
+
+**RAG Context**: Retrieve relevant context passages to augment LLM prompts with domain-specific knowledge.
+
+**Similar Content**: Find products, articles, or media similar to a reference item.
+<!-- END MANUAL -->
+
+---
+
+## Step Through Items
+
+### What it is
+Iterates over a list or dictionary and outputs each item.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+When given a list or dictionary, the block processes each item individually. For lists, it keeps track of the item's position (index). For dictionaries, it focuses on the values, using the value as both the item and the key in the output.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| items | The list or dictionary of items to iterate over | List[Any] | No |
+| items_object | The list or dictionary of items to iterate over | Dict[str, Any] | No |
+| items_str | The list or dictionary of items to iterate over | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| item | The current item in the iteration | Item |
+| key | The key or index of the current item in the iteration | Key |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Imagine you have a list of customer names and you want to perform a specific action for each customer, like sending a personalized email. This block could help you go through the list one by one, allowing you to process each customer individually.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/content/platform/blocks/maths.md b/docs/integrations/maths.md
similarity index 100%
rename from docs/content/platform/blocks/maths.md
rename to docs/integrations/maths.md
diff --git a/docs/content/platform/blocks/medium.md b/docs/integrations/medium.md
similarity index 100%
rename from docs/content/platform/blocks/medium.md
rename to docs/integrations/medium.md
diff --git a/docs/integrations/misc.md b/docs/integrations/misc.md
new file mode 100644
index 0000000000..4c199bebb4
--- /dev/null
+++ b/docs/integrations/misc.md
@@ -0,0 +1,1111 @@
+# Misc
+<!-- MANUAL: file_description -->
+Miscellaneous blocks including agent execution, scheduling, HTTP requests, webhooks, and other utility functions.
+<!-- END MANUAL -->
+
+## Agent Executor
+
+### What it is
+Executes an existing agent inside your agent
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block runs another agent as a sub-agent within your workflow. You provide the agent's graph ID, version, and input data, and the block executes that agent and returns its outputs.
+
+Input and output schemas define the expected data structure for communication between the parent and child agents, enabling modular, reusable agent composition.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| user_id | User ID | str | Yes |
+| graph_id | Graph ID | str | Yes |
+| graph_version | Graph Version | int | Yes |
+| agent_name | Name to display in the Builder UI | str | No |
+| inputs | Input data for the graph | Dict[str, Any] | Yes |
+| input_schema | Input schema for the graph | Dict[str, Any] | Yes |
+| output_schema | Output schema for the graph | Dict[str, Any] | Yes |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Modular Workflows**: Break complex workflows into smaller, reusable agents that can be composed together.
+
+**Specialized Agents**: Call domain-specific agents (like a research agent or formatter) from a main orchestration agent.
+
+**Dynamic Routing**: Execute different agents based on input type or user preferences.
+<!-- END MANUAL -->
+
+---
+
+## Create Reddit Post
+
+### What it is
+Create a new post on a subreddit. Can create text posts or link posts.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Reddit API via PRAW to create a new post in the specified subreddit. Provide the title and either text content for a self-post or a URL for a link post. Optionally apply flair using a flair ID from the GetSubredditFlairsBlock.
+
+The block returns the created post's ID and URL, which can be used for chaining with comment blocks or monitoring.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| subreddit | Subreddit to post to, excluding the /r/ prefix | str | Yes |
+| title | Title of the post | str | Yes |
+| content | Body text of the post (for text posts) | str | No |
+| url | URL to submit (for link posts). If provided, content is ignored. | str | No |
+| flair_id | Flair template ID to apply to the post (from GetSubredditFlairsBlock) | str | No |
+| flair_text | Custom flair text (only used if the flair template allows editing) | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| post_id | ID of the created post | str |
+| post_url | URL of the created post | str |
+| subreddit | The subreddit name (pass-through for chaining) | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Distribution**: Automatically share articles or content to relevant subreddits.
+
+**Community Engagement**: Post updates or announcements to subreddit communities.
+
+**Automated Posting**: Schedule and post content to Reddit based on workflow triggers.
+<!-- END MANUAL -->
+
+---
+
+## Delete Reddit Comment
+
+### What it is
+Delete a Reddit comment that you own.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Reddit API via PRAW to delete a comment you previously posted. The deletion is permanent and removes the comment from the post thread. You can only delete your own comments.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| comment_id | The ID of the comment to delete (must be your own comment) | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if deletion failed | str |
+| success | Whether the deletion was successful | bool |
+| comment_id | The comment ID (pass-through for chaining) | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Cleanup**: Remove outdated or incorrect comments from discussions.
+
+**Automated Moderation**: Delete comments that fail quality checks or receive negative feedback.
+<!-- END MANUAL -->
+
+---
+
+## Delete Reddit Post
+
+### What it is
+Delete a Reddit post that you own.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Reddit API via PRAW to delete a post you previously created. The deletion is permanent and removes the post from the subreddit. You can only delete your own posts.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| post_id | The ID of the post to delete (must be your own post) | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if deletion failed | str |
+| success | Whether the deletion was successful | bool |
+| post_id | The post ID (pass-through for chaining) | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Management**: Remove posts that are no longer relevant or contain errors.
+
+**Automated Cleanup**: Delete posts based on performance metrics or time-based rules.
+<!-- END MANUAL -->
+
+---
+
+## Edit Reddit Post
+
+### What it is
+Edit the body text of an existing Reddit post that you own. Only works for self/text posts.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Reddit API via PRAW to edit the body text of a self-post you created. Link posts cannot be edited. The new content replaces the existing post body.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| post_id | The ID of the post to edit (must be your own post) | str | Yes |
+| new_content | The new body text for the post | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the edit failed | str |
+| success | Whether the edit was successful | bool |
+| post_id | The post ID (pass-through for chaining) | str |
+| post_url | URL of the edited post | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Updates**: Update posts with new information or corrections.
+
+**Dynamic Content**: Modify post content based on changing data or feedback.
+<!-- END MANUAL -->
+
+---
+
+## Execute Code
+
+### What it is
+Executes code in a sandbox environment with internet access.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block executes Python, JavaScript, or Bash code in an isolated E2B sandbox with internet access. Use setup_commands to install dependencies before running your code.
+
+The sandbox includes pip and npm pre-installed. Set timeout to limit execution time, and use dispose_sandbox to clean up after execution or keep the sandbox running for follow-up steps.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| setup_commands | Shell commands to set up the sandbox before running the code. You can use `curl` or `git` to install your desired Debian based package manager. `pip` and `npm` are pre-installed.  These commands are executed with `sh`, in the foreground. | List[str] | No |
+| code | Code to execute in the sandbox | str | No |
+| language | Programming language to execute | "python" \| "js" \| "bash" \| "r" \| "java" | No |
+| timeout | Execution timeout in seconds | int | No |
+| dispose_sandbox | Whether to dispose of the sandbox immediately after execution. If disabled, the sandbox will run until its timeout expires. | bool | No |
+| template_id | You can use an E2B sandbox template by entering its ID here. Check out the E2B docs for more details: [E2B - Sandbox template](https://e2b.dev/docs/sandbox-template) | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| main_result | The main result from the code execution | Main Result |
+| results | List of results from the code execution | List[CodeExecutionResult] |
+| response | Text output (if any) of the main execution result | str |
+| stdout_logs | Standard output logs from execution | str |
+| stderr_logs | Standard error logs from execution | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Data Processing**: Run Python scripts to transform, analyze, or visualize data that can't be handled by standard blocks.
+
+**Custom Integrations**: Execute code to call APIs or services not covered by built-in blocks.
+
+**Dynamic Computation**: Generate and execute code based on AI suggestions for flexible problem-solving.
+<!-- END MANUAL -->
+
+---
+
+## Execute Code Step
+
+### What it is
+Execute code in a previously instantiated sandbox.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block executes additional code in a sandbox that was previously created with the Instantiate Code Sandbox block. The sandbox maintains state between steps, so variables and installed packages persist.
+
+Use this for multi-step code execution where each step builds on previous results. Set dispose_sandbox to true on the final step to clean up.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| sandbox_id | ID of the sandbox instance to execute the code in | str | Yes |
+| step_code | Code to execute in the sandbox | str | No |
+| language | Programming language to execute | "python" \| "js" \| "bash" \| "r" \| "java" | No |
+| dispose_sandbox | Whether to dispose of the sandbox after executing this code. | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| main_result | The main result from the code execution | Main Result |
+| results | List of results from the code execution | List[CodeExecutionResult] |
+| response | Text output (if any) of the main execution result | str |
+| stdout_logs | Standard output logs from execution | str |
+| stderr_logs | Standard error logs from execution | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Iterative Processing**: Load data in one step, transform it in another, and export in a third.
+
+**Stateful Computation**: Build up results across multiple code executions with shared variables.
+
+**Interactive Analysis**: Run exploratory data analysis steps sequentially in the same environment.
+<!-- END MANUAL -->
+
+---
+
+## Get Reddit Comment
+
+### What it is
+Get details about a specific Reddit comment by its ID.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Reddit API via PRAW to retrieve detailed information about a specific comment by its ID. Returns the comment content, author, score, timestamp, and other metadata.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| comment_id | The ID of the comment to fetch | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if comment couldn't be fetched | str |
+| comment | The comment details | RedditComment |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Comment Analysis**: Analyze specific comments for sentiment or content moderation.
+
+**Thread Tracking**: Monitor specific comments for engagement or replies.
+<!-- END MANUAL -->
+
+---
+
+## Get Reddit Comment Replies
+
+### What it is
+Get replies to a specific Reddit comment.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Reddit API via PRAW to fetch replies to a specific comment. Returns a list of direct replies with their content, authors, and metadata.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| comment_id | The ID of the comment to get replies from | str | Yes |
+| post_id | The ID of the post containing the comment | str | Yes |
+| limit | Maximum number of replies to fetch (max 50) | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if replies couldn't be fetched | str |
+| reply | A reply to the comment | RedditComment |
+| replies | All replies | List[RedditComment] |
+| comment_id | The parent comment ID (pass-through for chaining) | str |
+| post_id | The post ID (pass-through for chaining) | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Conversation Threading**: Build complete comment threads for analysis or display.
+
+**Response Monitoring**: Track replies to your comments for engagement purposes.
+<!-- END MANUAL -->
+
+---
+
+## Get Reddit Inbox
+
+### What it is
+Get messages, mentions, and comment replies from your Reddit inbox.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Reddit API via PRAW to fetch items from your Reddit inbox. Filter by type to get all items, unread only, direct messages, username mentions, or replies to your comments.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| inbox_type | Type of inbox items to fetch | "all" \| "unread" \| "messages" \| "mentions" \| "comment_replies" | No |
+| limit | Maximum number of items to fetch | int | No |
+| mark_read | Whether to mark fetched items as read | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if fetch failed | str |
+| item | An inbox item | RedditInboxItem |
+| items | All fetched items | List[RedditInboxItem] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Inbox Monitoring**: Check for new messages or mentions to respond to.
+
+**Engagement Tracking**: Monitor comment replies to stay engaged with discussions.
+<!-- END MANUAL -->
+
+---
+
+## Get Reddit Post
+
+### What it is
+Get detailed information about a specific Reddit post by its ID.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Reddit API via PRAW to retrieve complete details about a specific post by its ID. Returns the post title, content, author, score, comment count, and other metadata.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| post_id | The ID of the post to fetch (e.g., 'abc123' or full ID 't3_abc123') | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the post couldn't be fetched | str |
+| post | Detailed post information | RedditPostDetails |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Post Analysis**: Analyze specific posts for content quality or engagement metrics.
+
+**Content Verification**: Verify post details before interacting with it programmatically.
+<!-- END MANUAL -->
+
+---
+
+## Get Reddit Post Comments
+
+### What it is
+Get top-level comments on a Reddit post.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Reddit API via PRAW to fetch top-level comments on a post. Configure the sort order and limit to control which comments are returned.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| post_id | The ID of the post to get comments from | str | Yes |
+| limit | Maximum number of top-level comments to fetch (max 100) | int | No |
+| sort | Sort order for comments | "best" \| "top" \| "new" \| "controversial" \| "old" \| "qa" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if comments couldn't be fetched | str |
+| comment | A comment on the post | RedditComment |
+| comments | All fetched comments | List[RedditComment] |
+| post_id | The post ID (pass-through for chaining) | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Sentiment Analysis**: Analyze comments to gauge community sentiment on a topic.
+
+**Content Moderation**: Review comments for compliance with community guidelines.
+<!-- END MANUAL -->
+
+---
+
+## Get Reddit Posts
+
+### What it is
+This block fetches Reddit posts from a defined subreddit name.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block connects to Reddit using provided credentials, accesses the specified subreddit, and retrieves posts based on the given parameters. It can limit the number of posts, stop at a specific post, or fetch posts within a certain time frame.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| subreddit | Subreddit name, excluding the /r/ prefix | str | No |
+| last_minutes | Post time to stop minutes ago while fetching posts | int | No |
+| last_post | Post ID to stop when reached while fetching posts | str | No |
+| post_limit | Number of posts to fetch | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| post | Reddit post | RedditPost |
+| posts | List of all Reddit posts | List[RedditPost] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+A content curator could use this block to gather recent posts from a specific subreddit for analysis, summarization, or inclusion in a newsletter.
+<!-- END MANUAL -->
+
+---
+
+## Get Reddit User Info
+
+### What it is
+Get information about a Reddit user including karma, account age, and verification status.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Reddit API via PRAW to retrieve public profile information about a Reddit user, including karma scores, account age, and verification status.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| username | The Reddit username to look up (without /u/ prefix) | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if user lookup failed | str |
+| user | User information | RedditUserInfo |
+| username | The username (pass-through for chaining) | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**User Verification**: Check user account age and karma before engaging.
+
+**User Research**: Gather user profile data for analysis or outreach decisions.
+<!-- END MANUAL -->
+
+---
+
+## Get Subreddit Flairs
+
+### What it is
+Get available link flair options for a subreddit.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Reddit API via PRAW to retrieve available link flair options for a subreddit. Use the flair IDs with the Create Reddit Post block to apply flair to your posts.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| subreddit | Subreddit name (without /r/ prefix) | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if fetch failed | str |
+| flair | A flair option | SubredditFlair |
+| flairs | All available flairs | List[SubredditFlair] |
+| subreddit | The subreddit name (pass-through for chaining) | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Post Preparation**: Get available flairs before creating posts to ensure proper categorization.
+
+**Flair Selection**: Present flair options to users or select appropriate flair programmatically.
+<!-- END MANUAL -->
+
+---
+
+## Get Subreddit Info
+
+### What it is
+Get information about a subreddit including subscriber count, description, and rules.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Reddit API via PRAW to retrieve metadata about a subreddit including subscriber count, description, creation date, and posting rules.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| subreddit | Subreddit name (without /r/ prefix) | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the subreddit couldn't be fetched | str |
+| info | Subreddit information | SubredditInfo |
+| subreddit | The subreddit name (pass-through for chaining) | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Subreddit Research**: Analyze subreddits before deciding to post or engage.
+
+**Community Analysis**: Compare subreddit sizes and activity for market research.
+<!-- END MANUAL -->
+
+---
+
+## Get Subreddit Rules
+
+### What it is
+Get the rules for a subreddit to ensure compliance before posting.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Reddit API via PRAW to retrieve the posting rules for a subreddit. Review these rules before posting to ensure compliance.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| subreddit | Subreddit name (without /r/ prefix) | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if fetch failed | str |
+| rule | A subreddit rule | SubredditRule |
+| rules | All subreddit rules | List[SubredditRule] |
+| subreddit | The subreddit name (pass-through for chaining) | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Compliance Check**: Review rules before automated posting to avoid violations.
+
+**Content Guidelines**: Display rules to users before they submit content to a subreddit.
+<!-- END MANUAL -->
+
+---
+
+## Get User Posts
+
+### What it is
+Fetch posts by a specific Reddit user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Reddit API via PRAW to fetch posts submitted by a specific user. Configure sort order and limit to control which posts are returned.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| username | Reddit username to fetch posts from (without /u/ prefix) | str | Yes |
+| post_limit | Maximum number of posts to fetch | int | No |
+| sort | Sort order for user posts | "new" \| "hot" \| "top" \| "controversial" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if posts couldn't be fetched | str |
+| post | A post by the user | RedditPost |
+| posts | All posts by the user | List[RedditPost] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**User Analysis**: Analyze a user's posting history for content patterns or topics.
+
+**Influencer Research**: Research prolific posters in specific communities.
+<!-- END MANUAL -->
+
+---
+
+## Instantiate Code Sandbox
+
+### What it is
+Instantiate a sandbox environment with internet access in which you can execute code with the Execute Code Step block.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a persistent E2B sandbox environment that can be used for multiple code execution steps. Run setup_commands and setup_code to prepare the environment with dependencies and initial state.
+
+The sandbox persists until its timeout expires or it's explicitly disposed. Use the returned sandbox_id with Execute Code Step blocks for subsequent code execution.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| setup_commands | Shell commands to set up the sandbox before running the code. You can use `curl` or `git` to install your desired Debian based package manager. `pip` and `npm` are pre-installed.  These commands are executed with `sh`, in the foreground. | List[str] | No |
+| setup_code | Code to execute in the sandbox | str | No |
+| language | Programming language to execute | "python" \| "js" \| "bash" \| "r" \| "java" | No |
+| timeout | Execution timeout in seconds | int | No |
+| template_id | You can use an E2B sandbox template by entering its ID here. Check out the E2B docs for more details: [E2B - Sandbox template](https://e2b.dev/docs/sandbox-template) | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| sandbox_id | ID of the sandbox instance | str |
+| response | Text result (if any) of the setup code execution | str |
+| stdout_logs | Standard output logs from execution | str |
+| stderr_logs | Standard error logs from execution | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Complex Pipelines**: Set up an environment with data science libraries for multi-step analysis.
+
+**Persistent State**: Create a sandbox with loaded models or data that multiple workflow branches can access.
+
+**Custom Environments**: Configure specialized environments with specific package versions for reproducible execution.
+<!-- END MANUAL -->
+
+---
+
+## Post Reddit Comment
+
+### What it is
+This block posts a Reddit comment on a specified Reddit post.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block connects to Reddit using the provided credentials, locates the specified post, and then adds the given comment to that post.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| post_id | The ID of the post to comment on | str | Yes |
+| comment | The content of the comment to post | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| comment_id | Posted comment ID | str |
+| post_id | The post ID (pass-through for chaining) | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+An automated moderation system could use this block to post pre-defined responses or warnings on Reddit posts that violate community guidelines.
+<!-- END MANUAL -->
+
+---
+
+## Publish To Medium
+
+### What it is
+Publishes a post to Medium.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block publishes articles to Medium using their API. Provide the content in HTML or Markdown format along with a title, tags, and publishing options. The author_id can be obtained from Medium's /me API endpoint.
+
+Configure publish_status to publish immediately, save as draft, or make unlisted. The block returns the published post's ID and URL.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| author_id | The Medium AuthorID of the user. You can get this by calling the /me endpoint of the Medium API.  curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" https://api.medium.com/v1/me  The response will contain the authorId field. | str | No |
+| title | The title of your Medium post | str | Yes |
+| content | The main content of your Medium post | str | Yes |
+| content_format | The format of the content: 'html' or 'markdown' | str | Yes |
+| tags | List of tags for your Medium post (up to 5) | List[str] | Yes |
+| canonical_url | The original home of this content, if it was originally published elsewhere | str | No |
+| publish_status | The publish status | "public" \| "draft" \| "unlisted" | Yes |
+| license | The license of the post: 'all-rights-reserved', 'cc-40-by', 'cc-40-by-sa', 'cc-40-by-nd', 'cc-40-by-nc', 'cc-40-by-nc-nd', 'cc-40-by-nc-sa', 'cc-40-zero', 'public-domain' | str | No |
+| notify_followers | Whether to notify followers that the user has published | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the post creation failed | str |
+| post_id | The ID of the created Medium post | str |
+| post_url | The URL of the created Medium post | str |
+| published_at | The timestamp when the post was published | int |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Syndication**: Automatically publish blog posts or newsletters to Medium to reach a wider audience.
+
+**AI Content Publishing**: Generate articles with AI and publish them directly to Medium.
+
+**Cross-Posting**: Republish existing content from other platforms to Medium with proper canonical URL attribution.
+<!-- END MANUAL -->
+
+---
+
+## Read RSS Feed
+
+### What it is
+Reads RSS feed entries from a given URL.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block fetches and parses RSS or Atom feeds from a URL. Filter entries by time_period to only get recent items. When run_continuously is enabled, the block polls the feed at the specified polling_rate interval.
+
+Each entry is output individually, enabling processing of new content as it appears. The block also outputs all entries as a list for batch processing.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| rss_url | The URL of the RSS feed to read | str | Yes |
+| time_period | The time period to check in minutes relative to the run block runtime, e.g. 60 would check for new entries in the last hour. | int | No |
+| polling_rate | The number of seconds to wait between polling attempts. | int | Yes |
+| run_continuously | Whether to run the block continuously or just once. | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| entry | The RSS item | RSSEntry |
+| entries | List of all RSS entries | List[RSSEntry] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**News Monitoring**: Track industry news feeds and process new articles for summarization or alerts.
+
+**Content Aggregation**: Collect posts from multiple RSS feeds for a curated digest or newsletter.
+
+**Blog Triggers**: Monitor a competitor's blog feed to trigger analysis or response workflows.
+<!-- END MANUAL -->
+
+---
+
+## Reddit Get My Posts
+
+### What it is
+Fetch posts created by the authenticated Reddit user (you).
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Reddit API via PRAW to fetch posts you've submitted to Reddit. Useful for managing or analyzing your own posting history.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| post_limit | Maximum number of posts to fetch | int | No |
+| sort | Sort order for posts | "new" \| "hot" \| "top" \| "controversial" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if posts couldn't be fetched | str |
+| post | A post by you | RedditPost |
+| posts | All your posts | List[RedditPost] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Management**: Review and manage your Reddit posting history.
+
+**Performance Tracking**: Analyze the engagement of your previous posts.
+<!-- END MANUAL -->
+
+---
+
+## Reply To Reddit Comment
+
+### What it is
+Reply to a specific Reddit comment. Useful for threaded conversations.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Reddit API via PRAW to post a reply to an existing comment. The reply appears as a nested response in the comment thread.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| comment_id | The ID of the comment to reply to | str | Yes |
+| reply_text | The text content of the reply | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if reply failed | str |
+| comment_id | ID of the newly created reply | str |
+| parent_comment_id | The parent comment ID (pass-through for chaining) | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Automated Responses**: Reply to comments that mention your product or brand.
+
+**Conversation Engagement**: Participate in discussions by responding to relevant comments.
+<!-- END MANUAL -->
+
+---
+
+## Search Reddit
+
+### What it is
+Search Reddit for posts matching a query. Can search all of Reddit or a specific subreddit.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Reddit API via PRAW to search for posts matching your query. Optionally limit the search to a specific subreddit and configure sort order and time filters.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| query | Search query string | str | Yes |
+| subreddit | Limit search to a specific subreddit (without /r/ prefix) | str | No |
+| sort | Sort order for search results | "relevance" \| "hot" \| "top" \| "new" \| "comments" | No |
+| time_filter | Time filter for search results | "all" \| "day" \| "hour" \| "month" \| "week" \| "year" | No |
+| limit | Maximum number of results to return | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if search failed | str |
+| result | A search result | RedditSearchResult |
+| results | All search results | List[RedditSearchResult] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Brand Monitoring**: Search for mentions of your product or company across Reddit.
+
+**Topic Research**: Find discussions about specific topics or keywords.
+<!-- END MANUAL -->
+
+---
+
+## Send Authenticated Web Request
+
+### What it is
+Make an authenticated HTTP request with host-scoped credentials (JSON / form / multipart).
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block makes HTTP requests with automatic credential injection based on the request URL's host. Credentials are managed separately and applied when the URL matches a configured host pattern.
+
+Supports JSON, form-encoded, and multipart requests with file uploads. The response is parsed and returned along with separate error outputs for client (4xx) and server (5xx) errors.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| url | The URL to send the request to | str | Yes |
+| method | The HTTP method to use for the request | "GET" \| "POST" \| "PUT" \| "DELETE" \| "PATCH" \| "OPTIONS" \| "HEAD" | No |
+| headers | The headers to include in the request | Dict[str, str] | No |
+| json_format | If true, send the body as JSON (unless files are also present). | bool | No |
+| body | Form/JSON body payload. If files are supplied, this must be a mapping of form‑fields. | Dict[str, Any] | No |
+| files_name | The name of the file field in the form data. | str | No |
+| files | Mapping of *form field name* → Image url / path / base64 url. | List[str (file)] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Errors for all other exceptions | str |
+| response | The response from the server | Response |
+| client_error | Errors on 4xx status codes | Client Error |
+| server_error | Errors on 5xx status codes | Server Error |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Private API Access**: Call APIs that require authentication without exposing credentials in the workflow.
+
+**OAuth Integrations**: Access protected resources using pre-configured OAuth tokens.
+
+**Multi-Tenant APIs**: Make requests to APIs where credentials vary by host or endpoint.
+<!-- END MANUAL -->
+
+---
+
+## Send Email
+
+### What it is
+This block sends an email using the provided SMTP credentials.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block sends emails via SMTP using your configured email server credentials. Provide the recipient address, subject, and body content. The SMTP configuration includes server host, port, username, and password.
+
+The block handles connection, authentication, and message delivery, returning a status indicating success or failure.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| to_email | Recipient email address | str | Yes |
+| subject | Subject of the email | str | Yes |
+| body | Body of the email | str | Yes |
+| config | SMTP Config | SMTP Config | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the email sending failed | str |
+| status | Status of the email sending operation | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Notification Emails**: Send automated notifications when workflow events occur.
+
+**Report Delivery**: Email generated reports or summaries to stakeholders.
+
+**Alert System**: Send email alerts when monitoring workflows detect issues or thresholds.
+<!-- END MANUAL -->
+
+---
+
+## Send Reddit Message
+
+### What it is
+Send a private message (DM) to a Reddit user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Reddit API via PRAW to send a private message to another Reddit user. The message appears in their inbox.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| username | The Reddit username to send a message to (without /u/ prefix) | str | Yes |
+| subject | The subject line of the message | str | Yes |
+| message | The body content of the message | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if sending failed | str |
+| success | Whether the message was sent | bool |
+| username | The username (pass-through for chaining) | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Outreach**: Send direct messages to users for collaboration or feedback requests.
+
+**Support**: Provide private support or follow-up to users who engaged with your content.
+<!-- END MANUAL -->
+
+---
+
+## Send Web Request
+
+### What it is
+Make an HTTP request (JSON / form / multipart).
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block makes HTTP requests to any URL. Configure the method (GET, POST, PUT, DELETE, PATCH), headers, and request body. Supports JSON, form-encoded, and multipart content types with file uploads.
+
+The response body is parsed and returned. Separate error outputs distinguish between client errors (4xx), server errors (5xx), and other failures.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| url | The URL to send the request to | str | Yes |
+| method | The HTTP method to use for the request | "GET" \| "POST" \| "PUT" \| "DELETE" \| "PATCH" \| "OPTIONS" \| "HEAD" | No |
+| headers | The headers to include in the request | Dict[str, str] | No |
+| json_format | If true, send the body as JSON (unless files are also present). | bool | No |
+| body | Form/JSON body payload. If files are supplied, this must be a mapping of form‑fields. | Dict[str, Any] | No |
+| files_name | The name of the file field in the form data. | str | No |
+| files | Mapping of *form field name* → Image url / path / base64 url. | List[str (file)] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Errors for all other exceptions | str |
+| response | The response from the server | Response |
+| client_error | Errors on 4xx status codes | Client Error |
+| server_error | Errors on 5xx status codes | Server Error |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**API Integration**: Call REST APIs to fetch data, trigger actions, or send updates.
+
+**Webhook Delivery**: Send webhook notifications to external services when events occur.
+
+**Custom Services**: Integrate with services that don't have dedicated blocks using their HTTP APIs.
+<!-- END MANUAL -->
+
+---
+
+## Transcribe Youtube Video
+
+### What it is
+Transcribes a YouTube video using a proxy.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block extracts transcripts from YouTube videos using a proxy service. It parses the YouTube URL to get the video ID and retrieves the available transcript, typically the auto-generated or manually uploaded captions.
+
+The transcript text is returned as a single string, suitable for summarization, analysis, or other text processing.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| youtube_url | The URL of the YouTube video to transcribe | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Any error message if the transcription fails | str |
+| video_id | The extracted YouTube video ID | str |
+| transcript | The transcribed text of the video | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Video Summarization**: Extract video transcripts for AI summarization or key point extraction.
+
+**Content Repurposing**: Convert YouTube content into written articles, social posts, or documentation.
+
+**Research Automation**: Transcribe educational or informational videos for analysis and note-taking.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/multimedia.md b/docs/integrations/multimedia.md
new file mode 100644
index 0000000000..e2d11cfbf7
--- /dev/null
+++ b/docs/integrations/multimedia.md
@@ -0,0 +1,119 @@
+# Multimedia
+<!-- MANUAL: file_description -->
+Blocks for processing and manipulating video and audio files.
+<!-- END MANUAL -->
+
+## Add Audio To Video
+
+### What it is
+Block to attach an audio file to a video file using moviepy.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block combines a video file with an audio file using the moviepy library. The audio track is attached to the video, optionally with volume adjustment via the volume parameter (1.0 = original volume).
+
+Input files can be URLs, data URIs, or local paths. The output can be returned as either a file path or base64 data URI.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| video_in | Video input (URL, data URI, or local path). | str (file) | Yes |
+| audio_in | Audio input (URL, data URI, or local path). | str (file) | Yes |
+| volume | Volume scale for the newly attached audio track (1.0 = original). | float | No |
+| output_return_type | Return the final output as a relative path or base64 data URI. | "file_path" \| "data_uri" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| video_out | Final video (with attached audio), as a path or data URI. | str (file) |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Add Voiceover**: Combine generated voiceover audio with video content for narrated videos.
+
+**Background Music**: Add music tracks to silent videos or replace existing audio.
+
+**Audio Replacement**: Swap the audio track of a video for localization or accessibility.
+<!-- END MANUAL -->
+
+---
+
+## Loop Video
+
+### What it is
+Block to loop a video to a given duration or number of repeats.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block extends a video by repeating it to reach a target duration or number of loops. Set duration to specify the total length in seconds, or use n_loops to repeat the video a specific number of times.
+
+The looped video is seamlessly concatenated and can be output as a file path or base64 data URI.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| video_in | The input video (can be a URL, data URI, or local path). | str (file) | Yes |
+| duration | Target duration (in seconds) to loop the video to. If omitted, defaults to no looping. | float | No |
+| n_loops | Number of times to repeat the video. If omitted, defaults to 1 (no repeat). | int | No |
+| output_return_type | How to return the output video. Either a relative path or base64 data URI. | "file_path" \| "data_uri" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| video_out | Looped video returned either as a relative path or a data URI. | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Background Videos**: Loop short clips to match the duration of longer audio or content.
+
+**GIF-Like Content**: Create seamlessly looping video content for social media.
+
+**Filler Content**: Extend short video clips to meet minimum duration requirements.
+<!-- END MANUAL -->
+
+---
+
+## Media Duration
+
+### What it is
+Block to get the duration of a media file.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block analyzes a media file and returns its duration in seconds. Set is_video to true for video files or false for audio files to ensure proper parsing.
+
+The input can be a URL, data URI, or local file path. The duration is returned as a float for precise timing calculations.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| media_in | Media input (URL, data URI, or local path). | str (file) | Yes |
+| is_video | Whether the media is a video (True) or audio (False). | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| duration | Duration of the media file (in seconds). | float |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Video Processing Prep**: Get video duration before deciding how to loop, trim, or synchronize it.
+
+**Audio Matching**: Determine audio length to generate matching-length video content.
+
+**Content Validation**: Verify that uploaded media meets duration requirements.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/notion/create_page.md b/docs/integrations/notion/create_page.md
new file mode 100644
index 0000000000..abcd919300
--- /dev/null
+++ b/docs/integrations/notion/create_page.md
@@ -0,0 +1,46 @@
+# Notion Create Page
+<!-- MANUAL: file_description -->
+Blocks for creating new pages in Notion workspaces and databases.
+<!-- END MANUAL -->
+
+## Notion Create Page
+
+### What it is
+Create a new page in Notion. Requires EITHER a parent_page_id OR parent_database_id. Supports markdown content.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a new page in Notion using the Notion API. You can create pages as children of existing pages or as entries in a database. The parent must be accessible to your integration.
+
+Content can be provided as markdown, which gets converted to Notion blocks. For database pages, you can set additional properties like Status or Priority. Optionally add an emoji icon to the page.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| parent_page_id | Parent page ID to create the page under. Either this OR parent_database_id is required. | str | No |
+| parent_database_id | Parent database ID to create the page in. Either this OR parent_page_id is required. | str | No |
+| title | Title of the new page | str | Yes |
+| content | Content for the page. Can be plain text or markdown - will be converted to Notion blocks. | str | No |
+| properties | Additional properties for database pages (e.g., {'Status': 'In Progress', 'Priority': 'High'}) | Dict[str, Any] | No |
+| icon_emoji | Emoji to use as the page icon (e.g., '📄', '🚀') | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| page_id | ID of the created page. | str |
+| page_url | URL of the created page. | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Meeting Notes**: Automatically create meeting notes pages from calendar events with template content.
+
+**Task Creation**: Add new entries to a task database when issues are created in other systems.
+
+**Content Publishing**: Create draft pages in a content calendar from AI-generated or imported content.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/notion/read_database.md b/docs/integrations/notion/read_database.md
new file mode 100644
index 0000000000..9d9b687015
--- /dev/null
+++ b/docs/integrations/notion/read_database.md
@@ -0,0 +1,50 @@
+# Notion Read Database
+<!-- MANUAL: file_description -->
+Blocks for querying and reading data from Notion databases.
+<!-- END MANUAL -->
+
+## Notion Read Database
+
+### What it is
+Query a Notion database with optional filtering and sorting, returning structured entries.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries a Notion database using the Notion API. It retrieves entries with optional filtering by property values and sorting. The block requires your Notion integration to have access to the database.
+
+Results include all property values for each entry, the entry IDs for further operations, and the total count. The database connection must be shared with your integration from Notion.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| database_id | Notion database ID. Must be accessible by the connected integration. | str | Yes |
+| filter_property | Property name to filter by (e.g., 'Status', 'Priority') | str | No |
+| filter_value | Value to filter for in the specified property | str | No |
+| sort_property | Property name to sort by | str | No |
+| sort_direction | Sort direction: 'ascending' or 'descending' | str | No |
+| limit | Maximum number of entries to retrieve | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| entries | List of database entries with their properties. | List[Dict[str, Any]] |
+| entry | Individual database entry (yields one per entry found). | Dict[str, Any] |
+| entry_ids | List of entry IDs for batch operations. | List[str] |
+| entry_id | Individual entry ID (yields one per entry found). | str |
+| count | Number of entries retrieved. | int |
+| database_title | Title of the database. | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Task Management**: Query a Notion task database to find items with a specific status or assigned to a particular person.
+
+**Content Pipeline**: Read entries from a content calendar database to identify posts scheduled for today or this week.
+
+**CRM Sync**: Fetch customer records from a Notion database to sync with other systems or trigger workflows.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/notion/read_page.md b/docs/integrations/notion/read_page.md
new file mode 100644
index 0000000000..acf65f5f2c
--- /dev/null
+++ b/docs/integrations/notion/read_page.md
@@ -0,0 +1,40 @@
+# Notion Read Page
+<!-- MANUAL: file_description -->
+Blocks for reading Notion pages and retrieving their raw JSON data.
+<!-- END MANUAL -->
+
+## Notion Read Page
+
+### What it is
+Read a Notion page by its ID and return its raw JSON.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves a Notion page by its ID using the Notion API. The page must be accessible to your connected integration, which requires sharing the page with your integration from within Notion.
+
+The block returns the raw JSON representation of the page, including all properties, metadata, and block IDs. This format is useful for programmatic processing or when you need full access to page data.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| page_id | Notion page ID. Must be accessible by the connected integration. You can get this from the page URL notion.so/A-Page-586edd711467478da59fe3ce29a1ffab would be 586edd711467478da59fe35e29a1ffab | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| page | Raw Notion page JSON. | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Data Extraction**: Read page properties and metadata for analysis or migration to other systems.
+
+**Automation Triggers**: Check page properties to decide what actions to take in a workflow.
+
+**Content Backup**: Retrieve full page data for archival or backup purposes.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/notion/read_page_markdown.md b/docs/integrations/notion/read_page_markdown.md
new file mode 100644
index 0000000000..120dc39144
--- /dev/null
+++ b/docs/integrations/notion/read_page_markdown.md
@@ -0,0 +1,42 @@
+# Notion Read Page Markdown
+<!-- MANUAL: file_description -->
+Blocks for reading Notion pages and converting them to Markdown format.
+<!-- END MANUAL -->
+
+## Notion Read Page Markdown
+
+### What it is
+Read a Notion page and convert it to Markdown format with proper formatting for headings, lists, links, and rich text.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block reads a Notion page and converts its content to Markdown format. It handles Notion's block structure and rich text, translating headings, lists, links, bold, italic, and other formatting into standard Markdown.
+
+The conversion preserves the document structure while making the content portable and usable in other contexts. Optionally include the page title as a top-level header in the output.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| page_id | Notion page ID. Must be accessible by the connected integration. You can get this from the page URL notion.so/A-Page-586edd711467478da59fe35e29a1ffab would be 586edd711467478da59fe35e29a1ffab | str | Yes |
+| include_title | Whether to include the page title as a header in the markdown | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| markdown | Page content in Markdown format. | str |
+| title | Page title. | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Export**: Export Notion pages as Markdown for use in static site generators or documentation tools.
+
+**AI Processing**: Convert Notion content to Markdown for LLM processing, summarization, or analysis.
+
+**Cross-Platform Publishing**: Use Notion as a CMS and export content as Markdown for blogs or wikis.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/notion/search.md b/docs/integrations/notion/search.md
new file mode 100644
index 0000000000..f77992ae4f
--- /dev/null
+++ b/docs/integrations/notion/search.md
@@ -0,0 +1,45 @@
+# Notion Search
+<!-- MANUAL: file_description -->
+Blocks for searching pages and databases in a Notion workspace.
+<!-- END MANUAL -->
+
+## Notion Search
+
+### What it is
+Search your Notion workspace for pages and databases by text query.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block searches across your Notion workspace using the Notion Search API. It finds pages and databases matching your query text, with optional filtering by type (page or database).
+
+Results include titles, types, URLs, and metadata for each match. Leave the query empty to retrieve all accessible pages and databases. Pagination is handled automatically up to the specified limit.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| query | Search query text. Leave empty to get all accessible pages/databases. | str | No |
+| filter_type | Filter results by type: 'page' or 'database'. Leave empty for both. | str | No |
+| limit | Maximum number of results to return | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| results | List of search results with title, type, URL, and metadata. | List[NotionSearchResult] |
+| result | Individual search result (yields one per result found). | NotionSearchResult |
+| result_ids | List of IDs from search results for batch operations. | List[str] |
+| count | Number of results found. | int |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Discovery**: Find relevant pages in your workspace based on keywords or topics.
+
+**Database Lookup**: Search for specific databases to use in subsequent operations.
+
+**Knowledge Retrieval**: Search your Notion workspace to find answers or related documentation.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/nvidia/deepfake.md b/docs/integrations/nvidia/deepfake.md
new file mode 100644
index 0000000000..72961a7b30
--- /dev/null
+++ b/docs/integrations/nvidia/deepfake.md
@@ -0,0 +1,43 @@
+# Nvidia Deepfake
+<!-- MANUAL: file_description -->
+Blocks for detecting deepfakes and synthetic image manipulation using Nvidia AI.
+<!-- END MANUAL -->
+
+## Nvidia Deepfake Detect
+
+### What it is
+Detects potential deepfakes in images using Nvidia's AI API
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block analyzes images using Nvidia's AI-powered deepfake detection model. It returns a probability score (0-1) indicating the likelihood that an image has been synthetically manipulated.
+
+Set return_image to true to receive a processed image with detection markings highlighting areas of concern.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| image_base64 | Image to analyze for deepfakes | str (file) | Yes |
+| return_image | Whether to return the processed image with markings | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| status | Detection status (SUCCESS, ERROR, CONTENT_FILTERED) | str |
+| image | Processed image with detection markings (if return_image=True) | str (file) |
+| is_deepfake | Probability that the image is a deepfake (0-1) | float |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Verification**: Verify authenticity of user-uploaded profile photos or identity documents.
+
+**Media Integrity**: Screen submitted images for signs of AI manipulation.
+
+**Trust & Safety**: Detect potentially misleading synthetic content in social or news platforms.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/content/platform/blocks/reddit.md b/docs/integrations/reddit.md
similarity index 100%
rename from docs/content/platform/blocks/reddit.md
rename to docs/integrations/reddit.md
diff --git a/docs/integrations/replicate/flux_advanced.md b/docs/integrations/replicate/flux_advanced.md
new file mode 100644
index 0000000000..0a9fa0544d
--- /dev/null
+++ b/docs/integrations/replicate/flux_advanced.md
@@ -0,0 +1,54 @@
+# Replicate Flux Advanced
+<!-- MANUAL: file_description -->
+Blocks for generating images using Flux models on Replicate with advanced settings.
+<!-- END MANUAL -->
+
+## Replicate Flux Advanced Model
+
+### What it is
+This block runs Flux models on Replicate with advanced settings.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block takes a text prompt and several customization options as input. It then sends this information to the selected Flux model on the Replicate platform. The AI model processes the input and generates an image based on the provided specifications. Finally, the block returns a URL to the generated image.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| prompt | Text prompt for image generation | str | Yes |
+| replicate_model_name | The name of the Image Generation Model, i.e Flux Schnell | "Flux Schnell" \| "Flux Pro" \| "Flux Pro 1.1" | No |
+| seed | Random seed. Set for reproducible generation | int | No |
+| steps | Number of diffusion steps | int | No |
+| guidance | Controls the balance between adherence to the text prompt and image quality/diversity. Higher values make the output more closely match the prompt but may reduce overall image quality. | float | No |
+| interval | Interval is a setting that increases the variance in possible outputs. Setting this value low will ensure strong prompt following with more consistent outputs. | float | No |
+| aspect_ratio | Aspect ratio for the generated image | str | No |
+| output_format | File format of the output image | "webp" \| "jpg" \| "png" | No |
+| output_quality | Quality when saving the output images, from 0 to 100. Not relevant for .png outputs | int | No |
+| safety_tolerance | Safety tolerance, 1 is most strict and 5 is most permissive | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| result | Generated output | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+A graphic designer could use this block to quickly generate concept art for a sci-fi game. They might input a prompt like "A futuristic spaceport on a distant planet with multiple moons in the sky" and adjust the settings to get the desired style and quality. The generated image could then serve as inspiration or a starting point for further design work.
+- API Key: Your Replicate API key for authentication
+- Prompt: A text description of the image you want to generate (e.g., "A futuristic cityscape at sunset")
+- Image Generation Model: Choose from Flux Schnell, Flux Pro, or Flux Pro 1.1
+- Seed: An optional number for reproducible image generation
+- Steps: The number of diffusion steps in the image generation process
+- Guidance: Controls how closely the image follows the text prompt
+- Interval: Affects the variety of possible outputs
+- Aspect Ratio: The width-to-height ratio of the generated image
+- Output Format: Choose between WEBP, JPG, or PNG file formats
+- Output Quality: Image quality setting (0-100) for JPG and WEBP formats
+- Safety Tolerance: Content safety setting, from 1 (strictest) to 5 (most permissive)
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/replicate/replicate_block.md b/docs/integrations/replicate/replicate_block.md
new file mode 100644
index 0000000000..16505741f2
--- /dev/null
+++ b/docs/integrations/replicate/replicate_block.md
@@ -0,0 +1,44 @@
+# Replicate Replicate Block
+<!-- MANUAL: file_description -->
+Blocks for running any AI model hosted on the Replicate platform.
+<!-- END MANUAL -->
+
+## Replicate Model
+
+### What it is
+Run Replicate models synchronously
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block runs any model hosted on Replicate using their API. Specify the model name in owner/model format, provide inputs as a dictionary, and optionally pin to a specific version.
+
+The block waits for completion and returns the model output along with status information.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| model_name | The Replicate model name (format: 'owner/model-name') | str | Yes |
+| model_inputs | Dictionary of inputs to pass to the model | Dict[str, str \| int] | No |
+| version | Specific version hash of the model (optional) | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| result | The output from the Replicate model | str |
+| status | Status of the prediction | str |
+| model_name | Name of the model used | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Model Flexibility**: Access thousands of open-source AI models from a single interface.
+
+**Custom Models**: Run your own models deployed on Replicate in workflows.
+
+**Specialized AI Tasks**: Use best-of-breed models for specific tasks like upscaling, segmentation, or captioning.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/content/platform/blocks/replicate_flux_advanced.md b/docs/integrations/replicate_flux_advanced.md
similarity index 100%
rename from docs/content/platform/blocks/replicate_flux_advanced.md
rename to docs/integrations/replicate_flux_advanced.md
diff --git a/docs/content/platform/blocks/rss.md b/docs/integrations/rss.md
similarity index 100%
rename from docs/content/platform/blocks/rss.md
rename to docs/integrations/rss.md
diff --git a/docs/content/platform/blocks/sampling.md b/docs/integrations/sampling.md
similarity index 100%
rename from docs/content/platform/blocks/sampling.md
rename to docs/integrations/sampling.md
diff --git a/docs/integrations/search.md b/docs/integrations/search.md
new file mode 100644
index 0000000000..bc6e775233
--- /dev/null
+++ b/docs/integrations/search.md
@@ -0,0 +1,72 @@
+# Search
+<!-- MANUAL: file_description -->
+Blocks for web searching, content extraction, and information retrieval from various search engines and APIs.
+<!-- END MANUAL -->
+
+## Get Wikipedia Summary
+
+### What it is
+This block fetches the summary of a given topic from Wikipedia.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block sends a request to Wikipedia's API with the provided topic. It then extracts the summary from the response and returns it. If there's an error during this process, it will return an error message instead.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| topic | The topic to fetch the summary for | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the summary cannot be retrieved | str |
+| summary | The summary of the given topic | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+A student researching for a project could use this block to quickly get overviews of various topics, helping them decide which areas to focus on for more in-depth study.
+<!-- END MANUAL -->
+
+---
+
+## Google Maps Search
+
+### What it is
+This block searches for local businesses using Google Maps API.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Google Maps Places API to search for businesses and locations based on a query. Configure radius (up to 50km) to limit the search area and max_results (up to 60) to control how many places are returned.
+
+Each place result includes name, address, rating, reviews, and geographic coordinates for integration with mapping or navigation workflows.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| query | Search query for local businesses | str | Yes |
+| radius | Search radius in meters (max 50000) | int | No |
+| max_results | Maximum number of results to return (max 60) | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| place | Place found | Place |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Lead Generation**: Find businesses in a specific area for sales outreach.
+
+**Competitive Analysis**: Search for competitors in target locations to analyze their presence and ratings.
+
+**Local SEO**: Gather data on local businesses for market research or directory building.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/slant3d/filament.md b/docs/integrations/slant3d/filament.md
new file mode 100644
index 0000000000..d6a39b112b
--- /dev/null
+++ b/docs/integrations/slant3d/filament.md
@@ -0,0 +1,34 @@
+# Slant3D Filament
+<!-- MANUAL: file_description -->
+Blocks for getting available filament options from Slant3D.
+<!-- END MANUAL -->
+
+## Slant3D Filament
+
+### What it is
+Get list of available filaments
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Slant3D API to retrieve a list of all available filament options for 3D printing. Each filament includes details like color, material type, and availability.
+
+Use this to populate filament selection dropdowns or validate filament choices before placing orders.
+<!-- END MANUAL -->
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| filaments | List of available filaments | List[Filament] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Product Configurator**: Display available filament options in a custom 3D printing order form.
+
+**Inventory Display**: Show current filament availability to customers before they place orders.
+
+**Material Validation**: Verify that requested filaments are available before processing orders.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/slant3d/order.md b/docs/integrations/slant3d/order.md
new file mode 100644
index 0000000000..0d82191c70
--- /dev/null
+++ b/docs/integrations/slant3d/order.md
@@ -0,0 +1,224 @@
+# Slant3D Order
+<!-- MANUAL: file_description -->
+Blocks for managing 3D print orders through Slant3D.
+<!-- END MANUAL -->
+
+## Slant3D Cancel Order
+
+### What it is
+Cancel an existing order
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block cancels an existing order in the Slant3D system using the order ID. The cancellation request is sent to the Slant3D API and returns a status message confirming the cancellation.
+
+Orders can only be cancelled before they enter production. Check order status before attempting cancellation.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| order_id | Slant3D order ID to cancel | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| status | Cancellation status message | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Customer Cancellations**: Allow customers to cancel orders through your interface.
+
+**Error Recovery**: Cancel orders placed with incorrect details or specifications.
+
+**Order Management**: Implement cancellation functionality in order management dashboards.
+<!-- END MANUAL -->
+
+---
+
+## Slant3D Create Order
+
+### What it is
+Create a new print order
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a new 3D print order through the Slant3D API. Provide customer shipping details and a list of items to print (STL files with specifications). Each item includes file URL, quantity, and filament selection.
+
+The block returns the Slant3D order ID which you can use for tracking and status updates.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| order_number | Your custom order number (or leave blank for a random one) | str | No |
+| customer | Customer details for where to ship the item | CustomerDetails | Yes |
+| items | List of items to print | List[OrderItem] | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| order_id | Slant3D order ID | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**E-Commerce Integration**: Automatically submit 3D print orders from your online store.
+
+**Custom Product Fulfillment**: Create orders for on-demand 3D printed products.
+
+**Automated Manufacturing**: Trigger print orders based on inventory levels or customer requests.
+<!-- END MANUAL -->
+
+---
+
+## Slant3D Estimate Order
+
+### What it is
+Get order cost estimate
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block calculates a cost estimate for a potential order without actually placing it. Provide the same details as a create order request, and receive a breakdown of printing and shipping costs.
+
+Use this for price quotes before customers commit to orders.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| order_number | Your custom order number (or leave blank for a random one) | str | No |
+| customer | Customer details for where to ship the item | CustomerDetails | Yes |
+| items | List of items to print | List[OrderItem] | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| total_price | Total price in USD | float |
+| shipping_cost | Shipping cost | float |
+| printing_cost | Printing cost | float |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Price Quoting**: Provide customers with accurate pricing before they commit to orders.
+
+**Budget Planning**: Calculate costs for batch orders or production runs.
+
+**Comparison Shopping**: Get estimates to compare with other printing services.
+<!-- END MANUAL -->
+
+---
+
+## Slant3D Estimate Shipping
+
+### What it is
+Get shipping cost estimate
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block calculates shipping costs for a potential order based on the destination and items. It provides an estimate before placing the full order.
+
+Use this to display shipping costs at checkout or calculate delivery options for customers.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| order_number | Your custom order number (or leave blank for a random one) | str | No |
+| customer | Customer details for where to ship the item | CustomerDetails | Yes |
+| items | List of items to print | List[OrderItem] | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| shipping_cost | Estimated shipping cost | float |
+| currency_code | Currency code (e.g., 'usd') | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Checkout Display**: Show shipping costs to customers before they complete orders.
+
+**International Pricing**: Calculate shipping for different destinations to optimize pricing.
+
+**Cost Breakdown**: Provide transparent shipping cost breakdowns to customers.
+<!-- END MANUAL -->
+
+---
+
+## Slant3D Get Orders
+
+### What it is
+Get all orders for the account
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves all orders associated with your Slant3D account. It returns a list of orders with their current status and details.
+
+Use this for order management dashboards or to sync order data with your systems.
+<!-- END MANUAL -->
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| orders | List of orders with their details | List[str] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Order Dashboard**: Build dashboards showing all orders and their current status.
+
+**Sync Operations**: Regularly sync Slant3D orders with your internal order management system.
+
+**Reporting**: Generate reports on order volume and status distribution.
+<!-- END MANUAL -->
+
+---
+
+## Slant3D Tracking
+
+### What it is
+Track order status and shipping
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves the current status and shipping tracking information for a specific order. It returns the order status and any available tracking numbers.
+
+Use this to provide customers with real-time order status updates.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| order_id | Slant3D order ID to track | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| status | Order status | str |
+| tracking_numbers | List of tracking numbers | List[str] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Order Status Page**: Display current order status to customers on your website.
+
+**Shipping Notifications**: Get tracking numbers to send shipping notifications to customers.
+
+**Customer Support**: Look up order status quickly for customer service inquiries.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/slant3d/slicing.md b/docs/integrations/slant3d/slicing.md
new file mode 100644
index 0000000000..a008379480
--- /dev/null
+++ b/docs/integrations/slant3d/slicing.md
@@ -0,0 +1,41 @@
+# Slant3D Slicing
+<!-- MANUAL: file_description -->
+Blocks for slicing 3D models and getting pricing information from Slant3D.
+<!-- END MANUAL -->
+
+## Slant3D Slicer
+
+### What it is
+Slice a 3D model file and get pricing information
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block sends an STL file to Slant3D's slicing service to analyze the 3D model. The slicer calculates print parameters and returns pricing information based on the model's complexity, size, and material requirements.
+
+Provide the URL to your STL file, and the block returns the calculated price for printing the model.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| file_url | URL of the 3D model file to slice (STL) | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| message | Response message | str |
+| price | Calculated price for printing | float |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Price Quoting**: Get instant price quotes for 3D models uploaded by customers.
+
+**Model Validation**: Verify that STL files are printable before accepting orders.
+
+**Cost Estimation**: Calculate printing costs as part of an automated quoting system.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/slant3d/webhook.md b/docs/integrations/slant3d/webhook.md
new file mode 100644
index 0000000000..9d5a9d7d47
--- /dev/null
+++ b/docs/integrations/slant3d/webhook.md
@@ -0,0 +1,44 @@
+# Slant3D Webhook
+<!-- MANUAL: file_description -->
+Blocks for receiving webhook notifications about Slant3D order status updates.
+<!-- END MANUAL -->
+
+## Slant3D Order Webhook
+
+### What it is
+This block triggers on Slant3D order status updates and outputs the event details, including tracking information when orders are shipped.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block subscribes to Slant3D webhook events for order status updates. When an order's status changes (e.g., printing, shipped, delivered), Slant3D sends a webhook notification that triggers your workflow.
+
+The payload includes order details and, when applicable, shipping information like tracking numbers and carrier codes for fulfillment tracking.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| events | Order status events to subscribe to | Events | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if payload processing failed | str |
+| payload | The complete webhook payload received from Slant3D | Dict[str, Any] |
+| order_id | The ID of the affected order | str |
+| status | The new status of the order | str |
+| tracking_number | The tracking number for the shipment | str |
+| carrier_code | The carrier code (e.g., 'usps') | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Customer Notifications**: Automatically notify customers via email or SMS when their 3D print order ships.
+
+**Order Tracking**: Update your internal systems with shipping information when orders are fulfilled.
+
+**Inventory Management**: Trigger restocking workflows when orders are completed.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/smartlead/campaign.md b/docs/integrations/smartlead/campaign.md
new file mode 100644
index 0000000000..738d244cf2
--- /dev/null
+++ b/docs/integrations/smartlead/campaign.md
@@ -0,0 +1,124 @@
+# Smartlead Campaign
+<!-- MANUAL: file_description -->
+Blocks for managing email outreach campaigns in SmartLead.
+<!-- END MANUAL -->
+
+## Add Lead To Campaign
+
+### What it is
+Add a lead to a campaign in SmartLead
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block adds up to 100 leads to an existing SmartLead campaign using the SmartLead API. Each lead includes contact details and optional custom fields for personalization.
+
+Configure upload settings to control duplicate handling and campaign status. The response includes counts for successful uploads, duplicates, and invalid entries.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| campaign_id | The ID of the campaign to add the lead to | int | Yes |
+| lead_list | An array of JSON objects, each representing a lead's details. Can hold max 100 leads. | List[LeadInput] | No |
+| settings | Settings for lead upload | LeadUploadSettings | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the lead was not added to the campaign | str |
+| campaign_id | The ID of the campaign the lead was added to (passed through) | int |
+| upload_count | The number of leads added to the campaign | int |
+| already_added_to_campaign | The number of leads that were already added to the campaign | int |
+| duplicate_count | The number of emails that were duplicates | int |
+| invalid_email_count | The number of emails that were invalidly formatted | int |
+| is_lead_limit_exhausted | Whether the lead limit was exhausted | bool |
+| lead_import_stopped_count | The number of leads that were not added to the campaign because the lead import was stopped | int |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Lead Import**: Bulk import leads from CRM exports, web forms, or enrichment services.
+
+**Campaign Automation**: Automatically add qualifying leads to outreach campaigns.
+
+**Multi-Source Aggregation**: Consolidate leads from multiple sources into unified campaigns.
+<!-- END MANUAL -->
+
+---
+
+## Create Campaign
+
+### What it is
+Create a campaign in SmartLead
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block creates a new email campaign in SmartLead using the SmartLead API. Provide a campaign name and the block returns the created campaign's ID and metadata.
+
+Use the campaign ID with other SmartLead blocks to add leads, configure sequences, and manage the campaign.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| name | The name of the campaign | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the search failed | str |
+| id | The ID of the created campaign | int |
+| name | The name of the created campaign | str |
+| created_at | The date and time the campaign was created | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Dynamic Campaigns**: Create campaigns programmatically for different products or segments.
+
+**Workflow Automation**: Spin up new outreach campaigns as part of sales or marketing workflows.
+
+**Campaign Templating**: Create campaigns from templates with standardized configurations.
+<!-- END MANUAL -->
+
+---
+
+## Save Campaign Sequences
+
+### What it is
+Save sequences within a campaign
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block saves email sequences to an existing SmartLead campaign. Sequences define the email content, timing, and follow-up structure for the campaign's outreach.
+
+Each sequence includes the email subject, body, and delay settings for automated follow-up emails.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| campaign_id | The ID of the campaign to save sequences for | int | Yes |
+| sequences | The sequences to save | List[Sequence] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the sequences were not saved | str |
+| data | Data from the API | Dict[str, Any] \| str |
+| message | Message from the API | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Email Automation**: Define multi-step email sequences for nurturing leads.
+
+**A/B Testing**: Create variant sequences to test different messaging approaches.
+
+**Campaign Configuration**: Set up complete outreach flows programmatically.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/stagehand/blocks.md b/docs/integrations/stagehand/blocks.md
new file mode 100644
index 0000000000..dac0586fa2
--- /dev/null
+++ b/docs/integrations/stagehand/blocks.md
@@ -0,0 +1,134 @@
+# Stagehand Blocks
+<!-- MANUAL: file_description -->
+Blocks for AI-powered browser automation using Stagehand and Browserbase.
+<!-- END MANUAL -->
+
+## Stagehand Act
+
+### What it is
+Interact with a web page by performing actions on a web page. Use it to build self-healing and deterministic automations that adapt to website chang.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Stagehand with Browserbase to perform web actions using AI-powered element detection. Actions like click, fill, type, scroll, and select are described in natural language and executed reliably even if the page structure changes.
+
+Configure timeouts for DOM settlement and page loading. Variables can be passed to actions for dynamic data entry.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| browserbase_project_id | Browserbase project ID (required if using Browserbase) | str | Yes |
+| model | LLM to use for Stagehand (provider is inferred) | "gpt-4.1-2025-04-14" \| "gpt-4.1-mini-2025-04-14" \| "claude-3-7-sonnet-20250219" | No |
+| url | URL to navigate to. | str | Yes |
+| action | Action to perform. Suggested actions are: click, fill, type, press, scroll, select from dropdown. For multi-step actions, add an entry for each step. | List[str] | Yes |
+| variables | Variables to use in the action. Variables contains data you want the action to use. | Dict[str, str] | No |
+| iframes | Whether to search within iframes. If True, Stagehand will search for actions within iframes. | bool | No |
+| domSettleTimeoutMs | Timeout in milliseconds for DOM settlement.Wait longer for dynamic content | int | No |
+| timeoutMs | Timeout in milliseconds for DOM ready. Extended timeout for slow-loading forms | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the action was completed successfully | bool |
+| message | Details about the action’s execution. | str |
+| action | Action performed | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Form Automation**: Fill out web forms, submit applications, or complete checkout flows.
+
+**Self-Healing Scrapers**: Build automations that adapt to website changes without breaking.
+
+**Testing Workflows**: Automate testing of web applications with resilient element targeting.
+<!-- END MANUAL -->
+
+---
+
+## Stagehand Extract
+
+### What it is
+Extract structured data from a webpage.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses Stagehand with Browserbase to extract data from web pages using natural language instructions. Describe what data you want to extract, and the AI identifies and returns the matching content.
+
+Supports searching within iframes and configurable timeouts for dynamic content that loads after the initial page render.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| browserbase_project_id | Browserbase project ID (required if using Browserbase) | str | Yes |
+| model | LLM to use for Stagehand (provider is inferred) | "gpt-4.1-2025-04-14" \| "gpt-4.1-mini-2025-04-14" \| "claude-3-7-sonnet-20250219" | No |
+| url | URL to navigate to. | str | Yes |
+| instruction | Natural language description of elements or actions to discover. | str | Yes |
+| iframes | Whether to search within iframes. If True, Stagehand will search for actions within iframes. | bool | No |
+| domSettleTimeoutMs | Timeout in milliseconds for DOM settlement.Wait longer for dynamic content | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| extraction | Extracted data from the page. | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Data Scraping**: Extract product details, prices, or contact information from websites.
+
+**Competitive Intelligence**: Pull data from competitor pages for analysis and monitoring.
+
+**Research Automation**: Gather information from multiple web sources for research workflows.
+<!-- END MANUAL -->
+
+---
+
+## Stagehand Observe
+
+### What it is
+Find suggested actions for your workflows
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block analyzes a web page to discover available actions based on natural language instructions. It returns XPath selectors, action methods, and descriptions for elements matching your query.
+
+Use this to explore a page's interactive elements before building automated workflows.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| browserbase_project_id | Browserbase project ID (required if using Browserbase) | str | Yes |
+| model | LLM to use for Stagehand (provider is inferred) | "gpt-4.1-2025-04-14" \| "gpt-4.1-mini-2025-04-14" \| "claude-3-7-sonnet-20250219" | No |
+| url | URL to navigate to. | str | Yes |
+| instruction | Natural language description of elements or actions to discover. | str | Yes |
+| iframes | Whether to search within iframes. If True, Stagehand will search for actions within iframes. | bool | No |
+| domSettleTimeoutMs | Timeout in milliseconds for DOM settlement.Wait longer for dynamic content | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| selector | XPath selector to locate element. | str |
+| description | Human-readable description | str |
+| method | Suggested action method | str |
+| arguments | Additional action parameters | List[str] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Workflow Discovery**: Identify available actions on a page before building automations.
+
+**Dynamic Navigation**: Discover clickable elements for pages with changing layouts.
+
+**Automation Development**: Build robust automation workflows by understanding page structure.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/system/library_operations.md b/docs/integrations/system/library_operations.md
new file mode 100644
index 0000000000..6e58ca3066
--- /dev/null
+++ b/docs/integrations/system/library_operations.md
@@ -0,0 +1,88 @@
+# System Library Operations
+<!-- MANUAL: file_description -->
+Blocks for managing agents in your personal AutoGPT library.
+<!-- END MANUAL -->
+
+## Add To Library From Store
+
+### What it is
+Add an agent from the store to your personal library
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block copies an agent from the public store into your personal library using its store_listing_version_id. Optionally provide a custom agent_name to rename it in your library.
+
+The block returns the library entry ID and agent graph ID, which can be used to execute the agent or manage your library.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| store_listing_version_id | The ID of the store listing version to add to library | str | Yes |
+| agent_name | Optional custom name for the agent in your library | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the agent was successfully added to library | bool |
+| library_agent_id | The ID of the library agent entry | str |
+| agent_id | The ID of the agent graph | str |
+| agent_version | The version number of the agent graph | int |
+| agent_name | The name of the agent | str |
+| message | Success or error message | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Agent Provisioning**: Automatically add recommended agents to a user's library.
+
+**Onboarding Flows**: Set up a user's library with starter agents during onboarding.
+
+**Dynamic Agent Access**: Add agents on-demand when users request specific capabilities.
+<!-- END MANUAL -->
+
+---
+
+## List Library Agents
+
+### What it is
+List all agents in your personal library
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves all agents stored in your personal library. Use search_query to filter by name, and limit/page for pagination through large libraries.
+
+Results include each agent's metadata and are output both as a complete list and individually for iteration.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| search_query | Optional search query to filter agents | str | No |
+| limit | Maximum number of agents to return | int | No |
+| page | Page number for pagination | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| agents | List of agents in the library | List[LibraryAgent] |
+| agent | Individual library agent (yielded for each agent) | LibraryAgent |
+| total_count | Total number of agents in library | int |
+| page | Current page number | int |
+| total_pages | Total number of pages | int |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Agent Selection**: Display available agents for users to choose from in a workflow.
+
+**Library Management**: Build interfaces for users to manage and organize their agent library.
+
+**Agent Inventory**: Check what agents are available before deciding which to execute.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/system/store_operations.md b/docs/integrations/system/store_operations.md
new file mode 100644
index 0000000000..6ff47daca9
--- /dev/null
+++ b/docs/integrations/system/store_operations.md
@@ -0,0 +1,89 @@
+# System Store Operations
+<!-- MANUAL: file_description -->
+Blocks for browsing and retrieving agent details from the AutoGPT store.
+<!-- END MANUAL -->
+
+## Get Store Agent Details
+
+### What it is
+Get detailed information about an agent from the store
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves detailed metadata about a specific agent from the AutoGPT store using the creator's username and agent slug. It returns the agent's name, description, categories, run count, and average rating.
+
+The store_listing_version_id can be used with other blocks to add the agent to your library or execute it.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| creator | The username of the agent creator | str | Yes |
+| slug | The name of the agent | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| found | Whether the agent was found in the store | bool |
+| store_listing_version_id | The store listing version ID | str |
+| agent_name | Name of the agent | str |
+| description | Description of the agent | str |
+| creator | Creator of the agent | str |
+| categories | Categories the agent belongs to | List[str] |
+| runs | Number of times the agent has been run | int |
+| rating | Average rating of the agent | float |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Agent Discovery**: Fetch details about a specific agent before adding it to your library.
+
+**Agent Validation**: Check an agent's ratings and run count to assess quality and popularity.
+
+**Dynamic Agent Selection**: Get agent metadata to decide which version or variant to use.
+<!-- END MANUAL -->
+
+---
+
+## Search Store Agents
+
+### What it is
+Search for agents in the store
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block searches the AutoGPT agent store using a query string. Filter results by category and sort by rating, runs, or name. Limit controls the maximum number of results returned.
+
+Results include basic agent information and are output both as a list and individually for workflow iteration.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| query | Search query to find agents | str | No |
+| category | Filter by category | str | No |
+| sort_by | How to sort the results | "rating" \| "runs" \| "name" \| "updated_at" | No |
+| limit | Maximum number of results to return | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| agents | List of agents matching the search criteria | List[StoreAgent] |
+| agent | Basic information of the agent | StoreAgent |
+| total_count | Total number of agents found | int |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Agent Recommendation**: Search for agents that match user needs and recommend the best options.
+
+**Marketplace Browse**: Allow users to explore available agents by category or keyword.
+
+**Agent Orchestration**: Find and compose multiple specialized agents for complex workflows.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/content/platform/blocks/talking_head.md b/docs/integrations/talking_head.md
similarity index 100%
rename from docs/content/platform/blocks/talking_head.md
rename to docs/integrations/talking_head.md
diff --git a/docs/integrations/text.md b/docs/integrations/text.md
new file mode 100644
index 0000000000..e47375196c
--- /dev/null
+++ b/docs/integrations/text.md
@@ -0,0 +1,494 @@
+# Text
+<!-- MANUAL: file_description -->
+Blocks for text processing including formatting, extraction, transformation, splitting, combining, and template rendering.
+<!-- END MANUAL -->
+
+## Code Extraction
+
+### What it is
+Extracts code blocks from text and identifies their programming languages
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block parses text content (typically from AI responses) and extracts code blocks enclosed in markdown-style triple backticks. It identifies the programming language from the code fence annotation (e.g., ```python) and routes each extracted code block to the appropriate language-specific output.
+
+The block supports 16 programming languages including Python, JavaScript, HTML, CSS, SQL, and more. Any text that remains after extracting all code blocks is output as "remaining_text", allowing you to process both the code and surrounding context separately.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| text | Text containing code blocks to extract (e.g., AI response) | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| html | Extracted HTML code | str |
+| css | Extracted CSS code | str |
+| javascript | Extracted JavaScript code | str |
+| python | Extracted Python code | str |
+| sql | Extracted SQL code | str |
+| java | Extracted Java code | str |
+| cpp | Extracted C++ code | str |
+| csharp | Extracted C# code | str |
+| json_code | Extracted JSON code | str |
+| bash | Extracted Bash code | str |
+| php | Extracted PHP code | str |
+| ruby | Extracted Ruby code | str |
+| yaml | Extracted YAML code | str |
+| markdown | Extracted Markdown code | str |
+| typescript | Extracted TypeScript code | str |
+| xml | Extracted XML code | str |
+| remaining_text | Remaining text after code extraction | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**AI Code Generation Pipeline**: When an AI model generates a response containing multiple code blocks (HTML, CSS, JavaScript), use this block to separate each language into individual files for a complete web component.
+
+**Code Review Automation**: Extract Python code from documentation or chat logs to run automated linting, testing, or security scanning on the code portions only.
+
+**Technical Documentation Processing**: Parse developer tutorials or README files to extract executable code samples while preserving the explanatory text for different processing paths.
+<!-- END MANUAL -->
+
+---
+
+## Combine Texts
+
+### What it is
+This block combines multiple input texts into a single output text.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block concatenates all the input texts in the order they are provided, inserting the specified delimiter (if any) between each text.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| input | text input to combine | List[str] | Yes |
+| delimiter | Delimiter to combine texts | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| output | Combined text | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Merging multiple parts of an address (street, city, state, zip code) into a single, formatted address string.
+<!-- END MANUAL -->
+
+---
+
+## Countdown Timer
+
+### What it is
+This block triggers after a specified duration.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The Countdown Timer block pauses workflow execution for a specified duration before continuing. You can set the delay using any combination of seconds, minutes, hours, and days. When the timer completes, it outputs your specified message (or "timer finished" by default).
+
+The block supports a repeat parameter, allowing the timer to fire multiple times in sequence—useful for creating periodic triggers within your workflow. The timer uses async sleep, so it doesn't block other concurrent operations in the system.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| input_message | Message to output after the timer finishes | Input Message | No |
+| seconds | Duration in seconds | int \| str | No |
+| minutes | Duration in minutes | int \| str | No |
+| hours | Duration in hours | int \| str | No |
+| days | Duration in days | int \| str | No |
+| repeat | Number of times to repeat the timer | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| output_message | Message after the timer finishes | Output Message |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Rate Limiting**: Add a delay between API calls to respect rate limits when processing large batches of data through external services.
+
+**Scheduled Notifications**: Create a workflow that waits a specific time after an event (like a form submission) before sending a follow-up email or notification.
+
+**Polling Workflows**: Use the repeat feature to periodically check for updates, such as monitoring a file location or checking an API endpoint every few minutes.
+<!-- END MANUAL -->
+
+---
+
+## Extract Text Information
+
+### What it is
+This block extracts the text from the given text using the pattern (regex).
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block uses regular expressions to find the specified pattern in the text. It then extracts a particular group from the match, which can be the entire match or a specific captured group.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| text | Text to parse | Text | Yes |
+| pattern | Pattern (Regex) to parse | str | Yes |
+| group | Group number to extract | int | No |
+| case_sensitive | Case sensitive match | bool | No |
+| dot_all | Dot matches all | bool | No |
+| find_all | Find all matches | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| positive | Extracted text | str |
+| negative | Original text | str |
+| matched_results | List of matched results | List[str] |
+| matched_count | Number of matched results | int |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Extracting phone numbers or email addresses from a large body of text, such as a customer database.
+<!-- END MANUAL -->
+
+---
+
+## Fill Text Template
+
+### What it is
+This block formats the given texts using the format template.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block uses a template engine to replace placeholders in the format string with the provided values. It supports both simple placeholder replacement and more complex operations like loops.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| values | Values (dict) to be used in format. These values can be used by putting them in double curly braces in the format template. e.g. {{value_name}}. | Dict[str, Any] | Yes |
+| format | Template to format the text using `values`. Use Jinja2 syntax. | str | Yes |
+| escape_html | Whether to escape special characters in the inserted values to be HTML-safe. Enable for HTML output, disable for plain text. | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| output | Formatted text | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Generating personalized email messages by filling a template with customer-specific information like name, order details, or account status.
+<!-- END MANUAL -->
+
+---
+
+## Get Current Date
+
+### What it is
+This block outputs the current date with an optional offset.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves the current date from the system clock and formats it according to your preferences. You can specify an offset in days to get past or future dates (negative values for past dates, positive for future).
+
+The block supports two format types: strftime (customizable format strings like "%Y-%m-%d" or "%B %d, %Y") and ISO 8601 (standard format YYYY-MM-DD). You can also configure the timezone—either specify a specific timezone or use the user's profile timezone setting.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| trigger | Trigger any data to output the current date | str | Yes |
+| offset | Offset in days from the current date | int \| str | No |
+| format_type | Format type for date output (strftime with custom format or ISO 8601) | Format Type | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| date | Current date in the specified format (default: YYYY-MM-DD) | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Daily Report Generation**: Use the current date as a filename suffix or report header when generating automated daily summaries or exports.
+
+**Deadline Tracking**: Calculate dates relative to today using the offset feature—for example, find the date 30 days from now for payment due dates or project milestones.
+
+**Date-Based Filtering**: Get today's date to filter records, events, or tasks that are relevant to the current day in your workflow.
+<!-- END MANUAL -->
+
+---
+
+## Get Current Date And Time
+
+### What it is
+This block outputs the current date and time.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block outputs the current date and time from the system clock, formatted according to your specifications. It supports both strftime custom formats (like "%Y-%m-%d %H:%M:%S") and ISO 8601/RFC 3339 format for maximum compatibility with APIs and databases.
+
+You can configure the timezone to use either a specific timezone (e.g., "America/New_York") or the user's profile timezone. The ISO 8601 format option includes an optional microseconds precision setting for applications requiring high-resolution timestamps.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| trigger | Trigger any data to output the current date and time | str | Yes |
+| format_type | Format type for date and time output (strftime with custom format or ISO 8601/RFC 3339) | Format Type | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| date_time | Current date and time in the specified format (default: YYYY-MM-DD HH:MM:SS) | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Audit Logging**: Add precise timestamps to records when logging user actions, system events, or data changes in your workflow.
+
+**API Requests**: Generate ISO 8601 formatted timestamps required by many REST APIs for request authentication or data submission.
+
+**Scheduling Logic**: Compare the current date/time against scheduled events to trigger time-sensitive automations like sending reminders or processing batch jobs.
+<!-- END MANUAL -->
+
+---
+
+## Get Current Time
+
+### What it is
+This block outputs the current time.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block outputs just the current time (without date) from the system clock. It supports strftime custom formats (like "%H:%M:%S" for 24-hour time or "%I:%M %p" for 12-hour time with AM/PM) and ISO 8601 time format.
+
+The timezone can be configured to a specific timezone or to use the user's profile timezone setting. When using ISO 8601 format, the output includes the timezone offset and an optional microseconds component for precision timing needs.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| trigger | Trigger any data to output the current time | str | Yes |
+| format_type | Format type for time output (strftime with custom format or ISO 8601) | Format Type | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| time | Current time in the specified format (default: %H:%M:%S) | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Business Hours Check**: Get the current time to determine if a request falls within business hours and route it accordingly (live support vs. after-hours message).
+
+**Time-Based Greetings**: Generate personalized greetings ("Good morning", "Good afternoon") based on the current time of day.
+
+**Shift Scheduling**: Determine which team or process should handle a task based on the current time and configured shift schedules.
+<!-- END MANUAL -->
+
+---
+
+## Match Text Pattern
+
+### What it is
+Matches text against a regex pattern and forwards data to positive or negative output based on the match.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+The block uses regular expressions to search for the specified pattern within the input text. It considers options like case sensitivity and whether the dot should match all characters.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| text | Text to match | Text | Yes |
+| match | Pattern (Regex) to match | str | Yes |
+| data | Data to be forwarded to output | Data | Yes |
+| case_sensitive | Case sensitive match | bool | No |
+| dot_all | Dot matches all | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| positive | Output data if match is found | Positive |
+| negative | Output data if match is not found | Negative |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Filtering customer feedback messages based on specific keywords or phrases to categorize them as positive or negative reviews.
+<!-- END MANUAL -->
+
+---
+
+## Text Decoder
+
+### What it is
+Decodes a string containing escape sequences into actual text
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block processes a text string and converts escape sequences (like \n, \t, \\, \uXXXX) into their actual character representations. For example, the literal text "Hello\nWorld" becomes "Hello" followed by an actual newline, then "World".
+
+This is useful when working with data from APIs or files where escape sequences are stored as literal text rather than being interpreted as special characters. The block handles standard escape sequences including newlines, tabs, Unicode characters, and more.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| text | A string containing escaped characters to be decoded | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| decoded_text | The decoded text with escape sequences processed | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**JSON Data Processing**: When parsing JSON strings that contain escaped characters (like "\n" for newlines in a message field), decode them to display properly formatted text to users.
+
+**Log File Processing**: Process log entries where special characters are escaped, converting them to their actual representations for proper parsing or display.
+
+**API Response Handling**: Decode text from APIs that return escaped content, ensuring special characters like tabs and newlines render correctly in your output.
+<!-- END MANUAL -->
+
+---
+
+## Text Replace
+
+### What it is
+This block is used to replace a text with a new text.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block performs a simple find-and-replace operation on text. It searches for all occurrences of the "old" string within your input text and replaces each one with the "new" string. The replacement is case-sensitive and matches exact strings.
+
+Unlike regex-based replacements, this block performs literal string matching, making it straightforward and predictable for common text substitution tasks. All instances of the target string are replaced in a single operation.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| text | The text to replace. | str | Yes |
+| old | The old text to replace. | str | Yes |
+| new | The new text to replace with. | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| output | The text with the replaced text. | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Data Sanitization**: Replace sensitive information like placeholder tokens with actual values, or redact personal information before displaying or storing text.
+
+**Template Customization**: Swap out placeholder text in templates (like "[COMPANY_NAME]" or "{{user}}") with actual values before sending emails or generating documents.
+
+**URL Manipulation**: Modify URLs by replacing domain names, query parameters, or path segments to redirect requests or update links dynamically.
+<!-- END MANUAL -->
+
+---
+
+## Text Split
+
+### What it is
+This block is used to split a text into a list of strings.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block takes a text string and divides it into a list of substrings based on a specified delimiter. For example, splitting "apple,banana,cherry" by comma results in ["apple", "banana", "cherry"].
+
+By default, the block also strips whitespace from each resulting substring (controlled by the "strip" option). If your input text is empty, the block returns an empty list. This is useful for parsing structured text data like CSV values, tags, or any delimited content.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| text | The text to split. | str | Yes |
+| delimiter | The delimiter to split the text by. | str | Yes |
+| strip | Whether to strip the text. | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| texts | The text split into a list of strings. | List[str] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Tag Processing**: Split a comma-separated list of tags or keywords into individual items for processing, filtering, or database storage.
+
+**Line-by-Line Processing**: Split a multi-line text file by newline characters to process each line independently in your workflow.
+
+**Parsing User Input**: Break apart user-submitted lists (like email addresses separated by semicolons) into individual items for validation and processing.
+<!-- END MANUAL -->
+
+---
+
+## Word Character Count
+
+### What it is
+Counts the number of words and characters in a given text.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block analyzes input text and returns two metrics: the total number of words and the total number of characters. Words are counted by splitting the text on whitespace, so "Hello World" counts as 2 words. Characters include all characters in the text, including spaces and punctuation.
+
+This provides a quick way to measure text length for validation, summarization checks, or content analysis without needing custom logic.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| text | Input text to count words and characters | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the counting operation failed | str |
+| word_count | Number of words in the input text | int |
+| character_count | Number of characters in the input text | int |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Validation**: Check if user-submitted text (like reviews or comments) meets minimum or maximum length requirements before accepting it.
+
+**AI Prompt Optimization**: Measure prompt length to ensure it fits within token limits before sending to language models, potentially triggering summarization if too long.
+
+**Social Media Preparation**: Verify that text content fits within platform character limits (like Twitter's 280 characters) before attempting to post.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/content/platform/blocks/text_to_speech_block.md b/docs/integrations/text_to_speech_block.md
similarity index 100%
rename from docs/content/platform/blocks/text_to_speech_block.md
rename to docs/integrations/text_to_speech_block.md
diff --git a/docs/content/platform/blocks/time_blocks.md b/docs/integrations/time_blocks.md
similarity index 100%
rename from docs/content/platform/blocks/time_blocks.md
rename to docs/integrations/time_blocks.md
diff --git a/docs/content/platform/blocks/todoist.md b/docs/integrations/todoist.md
similarity index 100%
rename from docs/content/platform/blocks/todoist.md
rename to docs/integrations/todoist.md
diff --git a/docs/integrations/todoist/comments.md b/docs/integrations/todoist/comments.md
new file mode 100644
index 0000000000..b11859ad63
--- /dev/null
+++ b/docs/integrations/todoist/comments.md
@@ -0,0 +1,166 @@
+# Todoist Comments
+<!-- MANUAL: file_description -->
+Blocks for creating and managing comments on Todoist tasks and projects.
+<!-- END MANUAL -->
+
+## Todoist Create Comment
+
+### What it is
+Creates a new comment on a Todoist task or project
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Takes comment content and task/project ID, creates comment via Todoist API.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| content | Comment content | str | Yes |
+| id_type | Specify either task_id or project_id to comment on | Id Type | No |
+| attachment | Optional file attachment | Dict[str, Any] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| id | ID of created comment | str |
+| content | Comment content | str |
+| posted_at | Comment timestamp | str |
+| task_id | Associated task ID | str |
+| project_id | Associated project ID | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Adding notes and comments to tasks or projects automatically.
+<!-- END MANUAL -->
+
+---
+
+## Todoist Delete Comment
+
+### What it is
+Deletes a Todoist comment
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Uses comment ID to delete via Todoist API.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| comment_id | Comment ID to delete | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the deletion was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Removing outdated or incorrect comments from tasks/projects.
+<!-- END MANUAL -->
+
+---
+
+## Todoist Get Comment
+
+### What it is
+Get a single comment from Todoist
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Uses comment ID to retrieve details via Todoist API.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| comment_id | Comment ID to retrieve | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| content | Comment content | str |
+| id | Comment ID | str |
+| posted_at | Comment timestamp | str |
+| project_id | Associated project ID | str |
+| task_id | Associated task ID | str |
+| attachment | Optional file attachment | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Looking up specific comment details for reference.
+<!-- END MANUAL -->
+
+---
+
+## Todoist Get Comments
+
+### What it is
+Get all comments for a Todoist task or project
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Uses task/project ID to get comments list via Todoist API.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| id_type | Specify either task_id or project_id to get comments for | Id Type | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| comments | List of comments | List[Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Reviewing comment history on tasks or projects.
+<!-- END MANUAL -->
+
+---
+
+## Todoist Update Comment
+
+### What it is
+Updates a Todoist comment
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Takes comment ID and new content, updates via Todoist API.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| comment_id | Comment ID to update | str | Yes |
+| content | New content for the comment | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the update was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Modifying existing comments to fix errors or update information.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/todoist/labels.md b/docs/integrations/todoist/labels.md
new file mode 100644
index 0000000000..2a31a6418e
--- /dev/null
+++ b/docs/integrations/todoist/labels.md
@@ -0,0 +1,280 @@
+# Todoist Labels
+<!-- MANUAL: file_description -->
+Blocks for creating and managing labels in Todoist.
+<!-- END MANUAL -->
+
+## Todoist Create Label
+
+### What it is
+Creates a new label in Todoist, It will not work if same name already exists
+
+### How it works
+<!-- MANUAL: how_it_works -->
+It takes label details as input, connects to Todoist API, creates the label and returns the created label's details.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| name | Name of the label | str | Yes |
+| order | Label order | int | No |
+| color | The color of the label icon | "berry_red" \| "red" \| "orange" \| "yellow" \| "olive_green" \| "lime_green" \| "green" \| "mint_green" \| "teal" \| "sky_blue" \| "light_blue" \| "blue" \| "grape" \| "violet" \| "lavender" \| "magenta" \| "salmon" \| "charcoal" \| "grey" \| "taupe" | No |
+| is_favorite | Whether the label is a favorite | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| id | ID of the created label | str |
+| name | Name of the label | str |
+| color | Color of the label | str |
+| order | Label order | int |
+| is_favorite | Favorite status | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Creating new labels to organize and categorize tasks in Todoist.
+<!-- END MANUAL -->
+
+---
+
+## Todoist Delete Label
+
+### What it is
+Deletes a personal label in Todoist
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block permanently removes a personal label from Todoist using the label's unique ID. The deletion is processed through the Todoist REST API and removes the label from all tasks it was assigned to.
+
+The operation is irreversible, so any tasks previously tagged with this label will lose that categorization after deletion.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| label_id | ID of the label to delete | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the deletion was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Label Cleanup**: Remove obsolete labels when reorganizing your task management system.
+
+**Workflow Automation**: Delete temporary labels after a project phase is complete.
+
+**Bulk Management**: Remove labels as part of a larger cleanup workflow.
+<!-- END MANUAL -->
+
+---
+
+## Todoist Get Label
+
+### What it is
+Gets a personal label from Todoist by ID
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Uses the label ID to retrieve label details from Todoist API.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| label_id | ID of the label to retrieve | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| id | ID of the label | str |
+| name | Name of the label | str |
+| color | Color of the label | str |
+| order | Label order | int |
+| is_favorite | Favorite status | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Looking up details of a specific label for editing or verification.
+<!-- END MANUAL -->
+
+---
+
+## Todoist Get Shared Labels
+
+### What it is
+Gets all shared labels from Todoist
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves all shared labels that exist across collaborative projects in your Todoist account. Shared labels are labels that appear on tasks in projects shared with other users.
+
+The API returns a list of label names that are currently in use across shared projects, enabling cross-project label management.
+<!-- END MANUAL -->
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| labels | List of shared label names | List[Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Collaboration Audit**: Review which labels are being used across shared projects.
+
+**Label Consistency**: Ensure consistent labeling conventions across team projects.
+
+**Cross-Project Analytics**: Analyze label usage patterns in collaborative workspaces.
+<!-- END MANUAL -->
+
+---
+
+## Todoist List Labels
+
+### What it is
+Gets all personal labels from Todoist
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Connects to Todoist API using provided credentials and retrieves all labels.
+<!-- END MANUAL -->
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| labels | List of complete label data | List[Any] |
+| label_ids | List of label IDs | List[Any] |
+| label_names | List of label names | List[Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Getting an overview of all labels to organize tasks or find specific labels.
+<!-- END MANUAL -->
+
+---
+
+## Todoist Remove Shared Labels
+
+### What it is
+Removes all instances of a shared label
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block removes a shared label by name from all tasks across all shared projects. Unlike deleting a personal label, this operation targets labels by name rather than ID since shared labels are name-based.
+
+The removal affects all instances of the label across collaborative projects, untagging every task that had this label applied.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| name | The name of the label to remove | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the removal was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Deprecate Labels**: Remove labels that are no longer part of your workflow conventions.
+
+**Team Cleanup**: Remove shared labels when reorganizing cross-project categorization.
+
+**Merge Labels**: Remove a duplicate label after migrating tasks to a standardized label.
+<!-- END MANUAL -->
+
+---
+
+## Todoist Rename Shared Labels
+
+### What it is
+Renames all instances of a shared label
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block renames a shared label across all tasks in all shared projects. It takes the existing label name and a new name, then updates every instance where that label appears.
+
+The rename is atomic across the entire account, ensuring consistent label naming in collaborative environments.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| name | The name of the existing label to rename | str | Yes |
+| new_name | The new name for the label | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the rename was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Standardize Naming**: Rename labels to follow consistent naming conventions.
+
+**Rebrand Categories**: Update label names when workflow terminology changes.
+
+**Fix Typos**: Correct misspelled labels across all shared projects.
+<!-- END MANUAL -->
+
+---
+
+## Todoist Update Label
+
+### What it is
+Updates a personal label in Todoist
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block modifies an existing personal label's properties using the Todoist API. You can update the label's name, display order, color, and favorite status.
+
+Only the fields you provide are updated; omitted fields retain their current values. The label ID is required to identify which label to modify.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| label_id | ID of the label to update | str | Yes |
+| name | New name of the label | str | No |
+| order | Label order | int | No |
+| color | The color of the label icon | "berry_red" \| "red" \| "orange" \| "yellow" \| "olive_green" \| "lime_green" \| "green" \| "mint_green" \| "teal" \| "sky_blue" \| "light_blue" \| "blue" \| "grape" \| "violet" \| "lavender" \| "magenta" \| "salmon" \| "charcoal" \| "grey" \| "taupe" | No |
+| is_favorite | Whether the label is a favorite (true/false) | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the update was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Visual Organization**: Change label colors to create visual groupings of related labels.
+
+**Priority Adjustment**: Update favorite status to surface frequently used labels.
+
+**Reorganization**: Modify label order to reflect current workflow priorities.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/todoist/projects.md b/docs/integrations/todoist/projects.md
new file mode 100644
index 0000000000..fbc94ab503
--- /dev/null
+++ b/docs/integrations/todoist/projects.md
@@ -0,0 +1,195 @@
+# Todoist Projects
+<!-- MANUAL: file_description -->
+Blocks for creating and managing projects in Todoist.
+<!-- END MANUAL -->
+
+## Todoist Create Project
+
+### What it is
+Creates a new project in Todoist
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Takes project details and creates via Todoist API.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| name | Name of the project | str | Yes |
+| parent_id | Parent project ID | str | No |
+| color | Color of the project icon | "berry_red" \| "red" \| "orange" \| "yellow" \| "olive_green" \| "lime_green" \| "green" \| "mint_green" \| "teal" \| "sky_blue" \| "light_blue" \| "blue" \| "grape" \| "violet" \| "lavender" \| "magenta" \| "salmon" \| "charcoal" \| "grey" \| "taupe" | No |
+| is_favorite | Whether the project is a favorite | bool | No |
+| view_style | Display style (list or board) | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the creation was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Creating new projects programmatically for workflow automation.
+<!-- END MANUAL -->
+
+---
+
+## Todoist Delete Project
+
+### What it is
+Deletes a Todoist project and all its contents
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Uses project ID to delete via Todoist API.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| project_id | ID of project to delete | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the deletion was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Removing completed or obsolete projects.
+<!-- END MANUAL -->
+
+---
+
+## Todoist Get Project
+
+### What it is
+Gets details for a specific Todoist project
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Uses project ID to retrieve details via Todoist API.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| project_id | ID of the project to get details for | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| project_id | ID of project | str |
+| project_name | Name of project | str |
+| project_url | URL of project | str |
+| complete_data | Complete project data including all fields | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Looking up project details for verification or editing.
+<!-- END MANUAL -->
+
+---
+
+## Todoist List Collaborators
+
+### What it is
+Gets all collaborators for a specific Todoist project
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Uses project ID to get collaborator list via Todoist API.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| project_id | ID of the project to get collaborators for | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| collaborator_ids | List of collaborator IDs | List[str] |
+| collaborator_names | List of collaborator names | List[str] |
+| collaborator_emails | List of collaborator email addresses | List[str] |
+| complete_data | Complete collaborator data including all fields | List[Dict[str, Any]] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Managing project sharing and collaboration.
+<!-- END MANUAL -->
+
+---
+
+## Todoist List Projects
+
+### What it is
+Gets all projects and their details from Todoist
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Connects to Todoist API using provided credentials and retrieves all projects.
+<!-- END MANUAL -->
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| names_list | List of project names | List[str] |
+| ids_list | List of project IDs | List[str] |
+| url_list | List of project URLs | List[str] |
+| complete_data | Complete project data including all fields | List[Dict[str, Any]] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Getting an overview of all projects for organization or automation.
+<!-- END MANUAL -->
+
+---
+
+## Todoist Update Project
+
+### What it is
+Updates an existing project in Todoist
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Takes project ID and updated fields, applies via Todoist API.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| project_id | ID of project to update | str | Yes |
+| name | New name for the project | str | No |
+| color | New color for the project icon | "berry_red" \| "red" \| "orange" \| "yellow" \| "olive_green" \| "lime_green" \| "green" \| "mint_green" \| "teal" \| "sky_blue" \| "light_blue" \| "blue" \| "grape" \| "violet" \| "lavender" \| "magenta" \| "salmon" \| "charcoal" \| "grey" \| "taupe" | No |
+| is_favorite | Whether the project should be a favorite | bool | No |
+| view_style | Display style (list or board) | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the update was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Modifying project settings or reorganizing projects.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/todoist/sections.md b/docs/integrations/todoist/sections.md
new file mode 100644
index 0000000000..1c0d9da19b
--- /dev/null
+++ b/docs/integrations/todoist/sections.md
@@ -0,0 +1,99 @@
+# Todoist Sections
+<!-- MANUAL: file_description -->
+Blocks for managing sections within Todoist projects.
+<!-- END MANUAL -->
+
+## Todoist Delete Section
+
+### What it is
+Deletes a section and all its tasks from Todoist
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Uses section ID to delete via Todoist API.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| section_id | ID of section to delete | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether section was successfully deleted | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Removing unused sections or reorganizing projects.
+<!-- END MANUAL -->
+
+---
+
+## Todoist Get Section
+
+### What it is
+Gets a single section by ID from Todoist
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Uses section ID to retrieve details via Todoist API.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| section_id | ID of section to fetch | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| id | ID of section | str |
+| project_id | Project ID the section belongs to | str |
+| order | Order of the section | int |
+| name | Name of the section | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Looking up section details for task management.
+<!-- END MANUAL -->
+
+---
+
+## Todoist List Sections
+
+### What it is
+Gets all sections and their details from Todoist
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Connects to Todoist API to retrieve sections list.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| project_id | Optional project ID to filter sections | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| names_list | List of section names | List[str] |
+| ids_list | List of section IDs | List[str] |
+| complete_data | Complete section data including all fields | List[Dict[str, Any]] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Getting section information for task organization.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/todoist/tasks.md b/docs/integrations/todoist/tasks.md
new file mode 100644
index 0000000000..a09e5d960e
--- /dev/null
+++ b/docs/integrations/todoist/tasks.md
@@ -0,0 +1,256 @@
+# Todoist Tasks
+<!-- MANUAL: file_description -->
+Blocks for creating, updating, and managing tasks in Todoist.
+<!-- END MANUAL -->
+
+## Todoist Close Task
+
+### What it is
+Closes a task in Todoist
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Uses task ID to mark it complete via Todoist API.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| task_id | Task ID to close | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the task was successfully closed | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Marking tasks as done in automated workflows.
+<!-- END MANUAL -->
+
+---
+
+## Todoist Create Task
+
+### What it is
+Creates a new task in a Todoist project
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Takes task details and creates a new task via Todoist API.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| content | Task content | str | Yes |
+| description | Task description | str | No |
+| project_id | Project ID this task should belong to | str | No |
+| section_id | Section ID this task should belong to | str | No |
+| parent_id | Parent task ID | str | No |
+| order | Optional order among other tasks,[Non-zero integer value used by clients to sort tasks under the same parent] | int | No |
+| labels | Task labels | List[str] | No |
+| priority | Task priority from 1 (normal) to 4 (urgent) | int | No |
+| due_date | Due date in YYYY-MM-DD format | str (date-time) | No |
+| deadline_date | Specific date in YYYY-MM-DD format relative to user's timezone | str (date-time) | No |
+| assignee_id | Responsible user ID | str | No |
+| duration_unit | Task duration unit (minute/day) | str | No |
+| duration | Task duration amount, You need to selecct the duration unit first | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| id | Task ID | str |
+| url | Task URL | str |
+| complete_data | Complete task data as dictionary | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Creating new tasks with full customization of parameters.
+<!-- END MANUAL -->
+
+---
+
+## Todoist Delete Task
+
+### What it is
+Deletes a task in Todoist
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Uses task ID to delete via Todoist API.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| task_id | Task ID to delete | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the task was successfully deleted | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Removing unwanted or obsolete tasks from the system.
+<!-- END MANUAL -->
+
+---
+
+## Todoist Get Task
+
+### What it is
+Get an active task from Todoist
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block retrieves a single active task from Todoist using the task's unique ID. It queries the Todoist REST API and returns comprehensive task details including content, description, due dates, labels, and project association.
+
+Only active (uncompleted) tasks can be retrieved; closed tasks are not accessible through this endpoint.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| task_id | Task ID to retrieve | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| project_id | Project ID containing the task | str |
+| url | Task URL | str |
+| complete_data | Complete task data as dictionary | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Task Details Retrieval**: Fetch complete information about a specific task for display or processing in workflows.
+
+**Workflow Branching**: Get task details to make decisions based on due dates, labels, or priority levels.
+
+**Task Auditing**: Retrieve individual tasks to verify their current state before performing updates or other operations.
+<!-- END MANUAL -->
+
+---
+
+## Todoist Get Tasks
+
+### What it is
+Get active tasks from Todoist
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Queries Todoist API with provided filters to get matching tasks.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| project_id | Filter tasks by project ID | str | No |
+| section_id | Filter tasks by section ID | str | No |
+| label | Filter tasks by label name | str | No |
+| filter | Filter by any supported filter, You can see How to use filters or create one of your one here - https://todoist.com/help/articles/introduction-to-filters-V98wIH | str | No |
+| lang | IETF language tag for filter language | str | No |
+| ids | List of task IDs to retrieve | List[str] | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| ids | Task IDs | List[str] |
+| urls | Task URLs | List[str] |
+| complete_data | Complete task data as dictionary | List[Dict[str, Any]] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Retrieving tasks matching specific criteria for review or processing.
+<!-- END MANUAL -->
+
+---
+
+## Todoist Reopen Task
+
+### What it is
+Reopens a task in Todoist
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Uses task ID to reactivate via Todoist API.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| task_id | Task ID to reopen | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the task was successfully reopened | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Reactivating tasks that were closed accidentally or need to be repeated.
+<!-- END MANUAL -->
+
+---
+
+## Todoist Update Task
+
+### What it is
+Updates an existing task in Todoist
+
+### How it works
+<!-- MANUAL: how_it_works -->
+Takes task ID and updated fields, applies changes via Todoist API.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| task_id | Task ID to update | str | Yes |
+| content | Task content | str | Yes |
+| description | Task description | str | No |
+| project_id | Project ID this task should belong to | str | No |
+| section_id | Section ID this task should belong to | str | No |
+| parent_id | Parent task ID | str | No |
+| order | Optional order among other tasks,[Non-zero integer value used by clients to sort tasks under the same parent] | int | No |
+| labels | Task labels | List[str] | No |
+| priority | Task priority from 1 (normal) to 4 (urgent) | int | No |
+| due_date | Due date in YYYY-MM-DD format | str (date-time) | No |
+| deadline_date | Specific date in YYYY-MM-DD format relative to user's timezone | str (date-time) | No |
+| assignee_id | Responsible user ID | str | No |
+| duration_unit | Task duration unit (minute/day) | str | No |
+| duration | Task duration amount, You need to selecct the duration unit first | int | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the update was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+Modifying task details like due dates, priority etc.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/twitter/blocks.md b/docs/integrations/twitter/blocks.md
new file mode 100644
index 0000000000..b63084caaf
--- /dev/null
+++ b/docs/integrations/twitter/blocks.md
@@ -0,0 +1,48 @@
+# Twitter Blocks
+<!-- MANUAL: file_description -->
+Blocks for managing blocked users on Twitter/X.
+<!-- END MANUAL -->
+
+## Twitter Get Blocked Users
+
+### What it is
+This block retrieves a list of users blocked by the authenticating user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to retrieve a paginated list of users that the authenticated account has blocked. It authenticates using OAuth 2.0 with the required scopes (users.read, block.read) and sends a request to Twitter's blocked users endpoint.
+
+The response includes user IDs and usernames by default, with optional expansions to include additional data like pinned tweets. Pagination is supported through tokens, allowing retrieval of large block lists in batches of up to 1,000 users per request.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with user data. Currently only 'pinned_tweet_id' is available to see a user's pinned tweet. | UserExpansionsFilter | No |
+| tweet_fields | Select what tweet information you want to see in pinned tweets. This only works if you select 'pinned_tweet_id' in expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see, like username, bio, profile picture, etc. | TweetUserFieldsFilter | No |
+| max_results | Maximum number of results to return (1-1000, default 100) | int | No |
+| pagination_token | Token for retrieving next/previous page of results | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| user_ids | List of blocked user IDs | List[str] |
+| usernames_ | List of blocked usernames | List[str] |
+| included | Additional data requested via expansions | Dict[str, Any] |
+| meta | Metadata including pagination info | Dict[str, Any] |
+| next_token | Next token for pagination | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Block List Audit**: Review your block list periodically to identify accounts you may want to unblock or to analyze blocking patterns.
+
+**Safety Monitoring**: Track blocked accounts as part of a harassment monitoring workflow, documenting problematic accounts.
+
+**Account Migration**: Export your block list when setting up a new account or for backup purposes.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/twitter/bookmark.md b/docs/integrations/twitter/bookmark.md
new file mode 100644
index 0000000000..a27022fdfb
--- /dev/null
+++ b/docs/integrations/twitter/bookmark.md
@@ -0,0 +1,126 @@
+# Twitter Bookmark
+<!-- MANUAL: file_description -->
+Blocks for managing Twitter/X bookmarks.
+<!-- END MANUAL -->
+
+## Twitter Bookmark Tweet
+
+### What it is
+This block bookmarks a tweet on Twitter.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to add a tweet to the authenticated user's bookmarks. The bookmark is private and only visible to you—the tweet author is not notified.
+
+The block authenticates using OAuth 2.0 with bookmark write permissions and sends a POST request to add the specified tweet ID to your bookmarks. Returns a success indicator confirming the bookmark was added.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| tweet_id | ID of the tweet to bookmark | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the bookmark was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Curation**: Save interesting tweets for later reading or to compile into a newsletter or blog post.
+
+**Research Collection**: Bookmark tweets containing valuable information or sources for ongoing research projects.
+
+**Reference Library**: Build a collection of useful tips, tutorials, or resource links shared on Twitter.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Get Bookmarked Tweets
+
+### What it is
+This block retrieves bookmarked tweets from Twitter.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve tweets that the authenticated user has bookmarked. Results are returned in reverse chronological order (most recently bookmarked first) with pagination support.
+
+The block uses Tweepy with OAuth 2.0 authentication and supports extensive expansions to include additional data like media, author information, and location details. Returns tweet IDs, text content, author information, and complete tweet data objects.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with your tweets. For example: - Select 'Media_Keys' to get media details - Select 'Author_User_ID' to get user information - Select 'Place_ID' to get location details | ExpansionFilter | No |
+| media_fields | Select what media information you want to see (images, videos, etc). To use this, you must first select 'Media_Keys' in the expansions above. | TweetMediaFieldsFilter | No |
+| place_fields | Select what location information you want to see (country, coordinates, etc). To use this, you must first select 'Place_ID' in the expansions above. | TweetPlaceFieldsFilter | No |
+| poll_fields | Select what poll information you want to see (options, voting status, etc). To use this, you must first select 'Poll_IDs' in the expansions above. | TweetPollFieldsFilter | No |
+| tweet_fields | Select what tweet information you want to see. For referenced tweets (like retweets), select 'Referenced_Tweet_ID' in the expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see. To use this, you must first select one of these in expansions above: - 'Author_User_ID' for tweet authors - 'Mentioned_Usernames' for mentioned users - 'Reply_To_User_ID' for users being replied to - 'Referenced_Tweet_Author_ID' for authors of referenced tweets | TweetUserFieldsFilter | No |
+| max_results | Maximum number of results to return (1-100) | int | No |
+| pagination_token | Token for pagination | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| id | All Tweet IDs | List[str] |
+| text | All Tweet texts | List[str] |
+| userId | IDs of the tweet authors | List[str] |
+| userName | Usernames of the tweet authors | List[str] |
+| data | Complete Tweet data | List[Dict[str, Any]] |
+| included | Additional data that you have requested (Optional) via Expansions field | Dict[str, Any] |
+| meta | Provides metadata such as pagination info (next_token) or result counts | Dict[str, Any] |
+| next_token | Next token for pagination | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Review**: Process your bookmarked tweets to extract and organize information you've saved.
+
+**Bookmark Cleanup**: Review and categorize bookmarks to identify content to keep, share, or remove.
+
+**Reading List Management**: Retrieve bookmarked tweets to create a structured reading list or export to another system.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Remove Bookmark Tweet
+
+### What it is
+This block removes a bookmark from a tweet on Twitter.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to remove a tweet from the authenticated user's bookmarks. The operation is private—no one else is notified that you unbookmarked the tweet.
+
+The block authenticates using OAuth 2.0 with bookmark write permissions and sends a DELETE request to remove the specified tweet ID from your bookmarks. Returns a success indicator confirming the bookmark was removed.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| tweet_id | ID of the tweet to remove bookmark from | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the bookmark removal failed | str |
+| success | Whether the bookmark was successfully removed | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Bookmark Cleanup**: Remove tweets you've already read or that are no longer relevant from your bookmarks.
+
+**Content Processing**: Automatically remove bookmarks after extracting or processing the content.
+
+**List Management**: Maintain a manageable bookmark collection by removing older or processed items.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/twitter/follows.md b/docs/integrations/twitter/follows.md
new file mode 100644
index 0000000000..f19023ae2b
--- /dev/null
+++ b/docs/integrations/twitter/follows.md
@@ -0,0 +1,168 @@
+# Twitter Follows
+<!-- MANUAL: file_description -->
+Blocks for following and unfollowing users on Twitter/X.
+<!-- END MANUAL -->
+
+## Twitter Follow User
+
+### What it is
+This block follows a specified Twitter user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to create a follow relationship from the authenticated user to the specified target user. The follow action is public—the target user will be notified and can see that you followed them.
+
+The block authenticates using OAuth 2.0 with follow write permissions. If the target user has a protected account, a follow request is sent instead of an immediate follow. Returns a success indicator confirming the action.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| target_user_id | The user ID of the user that you would like to follow | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the follow action was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Influencer Engagement**: Automatically follow industry influencers or thought leaders you want to engage with.
+
+**Community Building**: Follow users who interact with your content to build reciprocal relationships.
+
+**Network Expansion**: Follow users in specific niches or communities to expand your network strategically.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Get Followers
+
+### What it is
+This block retrieves followers of a specified Twitter user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve a paginated list of users who follow a specified account. Results include user IDs, usernames, and optionally expanded profile data.
+
+The block uses Tweepy with OAuth 2.0 authentication. Followers are returned in reverse chronological order (most recent first), with pagination support for accounts with many followers. Expansions can include pinned tweet data for each follower.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with user data. Currently only 'pinned_tweet_id' is available to see a user's pinned tweet. | UserExpansionsFilter | No |
+| tweet_fields | Select what tweet information you want to see in pinned tweets. This only works if you select 'pinned_tweet_id' in expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see, like username, bio, profile picture, etc. | TweetUserFieldsFilter | No |
+| target_user_id | The user ID whose followers you would like to retrieve | str | Yes |
+| max_results | Maximum number of results to return (1-1000, default 100) | int | No |
+| pagination_token | Token for retrieving next/previous page of results | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| ids | List of follower user IDs | List[str] |
+| usernames | List of follower usernames | List[str] |
+| next_token | Next token for pagination | str |
+| data | Complete user data for followers | List[Dict[str, Any]] |
+| includes | Additional data requested via expansions | Dict[str, Any] |
+| meta | Metadata including pagination info | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Audience Analysis**: Analyze the followers of a competitor or influencer to understand their audience demographics.
+
+**Follower Monitoring**: Track new followers over time to identify growth patterns or notable new followers.
+
+**Engagement Targeting**: Identify active followers for targeted engagement or outreach campaigns.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Get Following
+
+### What it is
+This block retrieves the users that a specified Twitter user is following.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve a paginated list of users that a specified account follows. Results include user IDs, usernames, and optionally expanded profile data.
+
+The block uses Tweepy with OAuth 2.0 authentication. Following lists are returned with pagination support for accounts following many users. Expansions can include pinned tweet data for each followed account.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with user data. Currently only 'pinned_tweet_id' is available to see a user's pinned tweet. | UserExpansionsFilter | No |
+| tweet_fields | Select what tweet information you want to see in pinned tweets. This only works if you select 'pinned_tweet_id' in expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see, like username, bio, profile picture, etc. | TweetUserFieldsFilter | No |
+| target_user_id | The user ID whose following you would like to retrieve | str | Yes |
+| max_results | Maximum number of results to return (1-1000, default 100) | int | No |
+| pagination_token | Token for retrieving next/previous page of results | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| ids | List of following user IDs | List[str] |
+| usernames | List of following usernames | List[str] |
+| next_token | Next token for pagination | str |
+| data | Complete user data for following | List[Dict[str, Any]] |
+| includes | Additional data requested via expansions | Dict[str, Any] |
+| meta | Metadata including pagination info | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Interest Analysis**: Analyze who an influencer or competitor follows to understand their interests and network.
+
+**Discover Accounts**: Find relevant accounts to follow by examining the following lists of users in your niche.
+
+**Relationship Mapping**: Map professional networks by analyzing mutual follows and connections.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Unfollow User
+
+### What it is
+This block unfollows a specified Twitter user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to remove a follow relationship from the authenticated user to the specified target user. The unfollow is processed silently—the target user is not notified.
+
+The block authenticates using OAuth 2.0 with follow write permissions and sends a DELETE request to remove the follow relationship. Returns a success indicator confirming the unfollow was processed.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| target_user_id | The user ID of the user that you would like to unfollow | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the unfollow action was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Account Cleanup**: Unfollow inactive accounts or accounts that no longer post relevant content.
+
+**Feed Curation**: Unfollow accounts to reduce noise in your timeline and focus on important content.
+
+**Following List Management**: Maintain a manageable following count by periodically unfollowing accounts.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/twitter/hide.md b/docs/integrations/twitter/hide.md
new file mode 100644
index 0000000000..8daa0e19e1
--- /dev/null
+++ b/docs/integrations/twitter/hide.md
@@ -0,0 +1,76 @@
+# Twitter Hide
+<!-- MANUAL: file_description -->
+Blocks for hiding and unhiding tweet replies on Twitter/X.
+<!-- END MANUAL -->
+
+## Twitter Hide Reply
+
+### What it is
+This block hides a reply to a tweet.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to hide a reply to one of your tweets. Hidden replies are not deleted—they're moved behind a "View hidden replies" option that viewers can click to see. Only the original tweet author can hide replies.
+
+The block authenticates using OAuth 2.0 and sends a PUT request to change the reply's hidden status. This is useful for managing conversation threads and reducing visibility of off-topic or inappropriate replies.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| tweet_id | ID of the tweet reply to hide | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the operation was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Conversation Moderation**: Hide off-topic or spam replies to keep your tweet threads focused and readable.
+
+**Brand Protection**: Hide inappropriate or offensive replies to maintain a professional appearance on brand accounts.
+
+**Community Management**: Moderate discussions by hiding replies that violate community guidelines without deleting them entirely.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Unhide Reply
+
+### What it is
+This block unhides a reply to a tweet.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to restore visibility of a previously hidden reply. The reply will appear normally in the conversation thread again.
+
+The block authenticates using OAuth 2.0 and sends a PUT request to change the reply's hidden status back to visible. Only the original tweet author can unhide replies they previously hid.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| tweet_id | ID of the tweet reply to unhide | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the operation was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Moderation Review**: Restore replies after reviewing them and determining they were hidden incorrectly.
+
+**Context Restoration**: Unhide replies that provide important context that was initially overlooked.
+
+**User Appeals**: Restore hidden replies after a user explains their intent or edits problematic content.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/twitter/like.md b/docs/integrations/twitter/like.md
new file mode 100644
index 0000000000..a0dd4ffdc6
--- /dev/null
+++ b/docs/integrations/twitter/like.md
@@ -0,0 +1,173 @@
+# Twitter Like
+<!-- MANUAL: file_description -->
+Blocks for liking tweets and retrieving liked tweets on Twitter/X.
+<!-- END MANUAL -->
+
+## Twitter Get Liked Tweets
+
+### What it is
+This block gets information about tweets liked by a user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve tweets that a specified user has liked. Results are returned in reverse chronological order (most recently liked first) with pagination support.
+
+The block uses Tweepy with OAuth 2.0 authentication and supports extensive expansions to include additional data like media, author information, and location details. Returns tweet IDs, text content, author information, and complete tweet data objects.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with your tweets. For example: - Select 'Media_Keys' to get media details - Select 'Author_User_ID' to get user information - Select 'Place_ID' to get location details | ExpansionFilter | No |
+| media_fields | Select what media information you want to see (images, videos, etc). To use this, you must first select 'Media_Keys' in the expansions above. | TweetMediaFieldsFilter | No |
+| place_fields | Select what location information you want to see (country, coordinates, etc). To use this, you must first select 'Place_ID' in the expansions above. | TweetPlaceFieldsFilter | No |
+| poll_fields | Select what poll information you want to see (options, voting status, etc). To use this, you must first select 'Poll_IDs' in the expansions above. | TweetPollFieldsFilter | No |
+| tweet_fields | Select what tweet information you want to see. For referenced tweets (like retweets), select 'Referenced_Tweet_ID' in the expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see. To use this, you must first select one of these in expansions above: - 'Author_User_ID' for tweet authors - 'Mentioned_Usernames' for mentioned users - 'Reply_To_User_ID' for users being replied to - 'Referenced_Tweet_Author_ID' for authors of referenced tweets | TweetUserFieldsFilter | No |
+| user_id | ID of the user to get liked tweets for | str | Yes |
+| max_results | Maximum number of results to return (5-100) | int | No |
+| pagination_token | Token for getting next/previous page of results | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| ids | All Tweet IDs | List[str] |
+| texts | All Tweet texts | List[str] |
+| userIds | List of user ids that authored the tweets | List[str] |
+| userNames | List of user names that authored the tweets | List[str] |
+| next_token | Next token for pagination | str |
+| data | Complete Tweet data | List[Dict[str, Any]] |
+| included | Additional data that you have requested (Optional) via Expansions field | Dict[str, Any] |
+| meta | Provides metadata such as pagination info (next_token) or result counts | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Interest Analysis**: Analyze a user's liked tweets to understand their interests, preferences, and sentiment.
+
+**Content Discovery**: Find high-quality content by examining tweets liked by influencers in your niche.
+
+**Engagement Research**: Study what types of content resonate with your target audience based on their likes.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Get Liking Users
+
+### What it is
+This block gets information about users who liked a tweet.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve a paginated list of users who have liked a specific tweet. Results include user IDs, usernames, and optionally expanded profile data.
+
+The block uses Tweepy with OAuth 2.0 authentication. Users are returned with pagination support for tweets with many likes. Expansions can include pinned tweet data for each user who liked the tweet.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with user data. Currently only 'pinned_tweet_id' is available to see a user's pinned tweet. | UserExpansionsFilter | No |
+| tweet_fields | Select what tweet information you want to see in pinned tweets. This only works if you select 'pinned_tweet_id' in expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see, like username, bio, profile picture, etc. | TweetUserFieldsFilter | No |
+| tweet_id | ID of the tweet to get liking users for | str | Yes |
+| max_results | Maximum number of results to return (1-100) | int | No |
+| pagination_token | Token for getting next/previous page of results | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| id | All User IDs who liked the tweet | List[str] |
+| username | All User usernames who liked the tweet | List[str] |
+| next_token | Next token for pagination | str |
+| data | Complete Tweet data | List[Dict[str, Any]] |
+| included | Additional data that you have requested (Optional) via Expansions field | Dict[str, Any] |
+| meta | Provides metadata such as pagination info (next_token) or result counts | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Engagement Analysis**: Identify who is engaging with your content to understand your audience better.
+
+**Influencer Identification**: Find influential users who liked your tweet for potential outreach or collaboration.
+
+**Community Discovery**: Discover potential community members or customers by analyzing who engages with relevant content.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Like Tweet
+
+### What it is
+This block likes a tweet.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to like a tweet on behalf of the authenticated user. The like is public—the tweet author and others can see that you liked the tweet.
+
+The block authenticates using OAuth 2.0 with like write permissions and sends a POST request to add a like to the specified tweet. Returns a success indicator confirming the like was added.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| tweet_id | ID of the tweet to like | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the operation was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Engagement Automation**: Like tweets from accounts you want to engage with to increase visibility and interaction.
+
+**Content Appreciation**: Automatically like tweets that mention your brand positively or use specific hashtags.
+
+**Community Building**: Like tweets from community members to acknowledge their contributions and encourage further engagement.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Unlike Tweet
+
+### What it is
+This block unlikes a tweet.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to remove a like from a tweet. The unlike action is processed silently—the tweet author is not specifically notified that you unliked.
+
+The block authenticates using OAuth 2.0 with like write permissions and sends a DELETE request to remove the like from the specified tweet. Returns a success indicator confirming the like was removed.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| tweet_id | ID of the tweet to unlike | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the operation was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Like Cleanup**: Remove likes from tweets you no longer want associated with your account.
+
+**Content Review**: Unlike tweets after reviewing them and determining they don't align with your values.
+
+**Engagement Adjustment**: Adjust your like history as part of curating your public engagement profile.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/twitter/list_follows.md b/docs/integrations/twitter/list_follows.md
new file mode 100644
index 0000000000..2aef98c549
--- /dev/null
+++ b/docs/integrations/twitter/list_follows.md
@@ -0,0 +1,76 @@
+# Twitter List Follows
+<!-- MANUAL: file_description -->
+Blocks for following and unfollowing Twitter/X lists.
+<!-- END MANUAL -->
+
+## Twitter Follow List
+
+### What it is
+This block follows a specified Twitter list for the authenticated user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to follow a Twitter List. Following a list adds it to your Lists tab and shows tweets from list members in your timeline when viewing that list.
+
+The block authenticates using OAuth 2.0 with list write permissions and sends a POST request to add the follow relationship. Returns a success indicator confirming the list was followed.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| list_id | The ID of the List to follow | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the follow was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Curated Content Discovery**: Follow lists curated by industry experts to access filtered content streams.
+
+**Topic Monitoring**: Follow lists focused on specific topics to stay informed without following individual accounts.
+
+**Research Organization**: Follow competitor or industry lists to monitor activity without cluttering your main timeline.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Unfollow List
+
+### What it is
+This block unfollows a specified Twitter list for the authenticated user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to unfollow a Twitter List. The list is removed from your Lists tab but remains accessible if it's public.
+
+The block authenticates using OAuth 2.0 with list write permissions and sends a DELETE request to remove the follow relationship. Returns a success indicator confirming the list was unfollowed.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| list_id | The ID of the List to unfollow | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the unfollow was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**List Cleanup**: Unfollow lists that are no longer relevant or useful to your interests.
+
+**Focus Management**: Reduce information overload by unfollowing less important lists.
+
+**Account Organization**: Clean up your followed lists as part of regular account maintenance.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/twitter/list_lookup.md b/docs/integrations/twitter/list_lookup.md
new file mode 100644
index 0000000000..d8ba82c8df
--- /dev/null
+++ b/docs/integrations/twitter/list_lookup.md
@@ -0,0 +1,95 @@
+# Twitter List Lookup
+<!-- MANUAL: file_description -->
+Blocks for retrieving information about Twitter/X lists.
+<!-- END MANUAL -->
+
+## Twitter Get List
+
+### What it is
+This block retrieves information about a specified Twitter List.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve detailed information about a specific Twitter List by its ID. Returns list metadata including name, description, member count, follower count, and privacy status.
+
+The block uses Tweepy with OAuth 2.0 authentication and supports expansions to include owner profile data. Works for both public lists and private lists you own or follow.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with your Twitter Lists: - Select 'List_Owner_ID' to get details about who owns the list  This will let you see more details about the list owner when you also select user fields below. | ListExpansionsFilter | No |
+| user_fields | Choose what information you want to see about list owners. This only works when you select 'List_Owner_ID' in expansions above.  You can see things like: - Their username - Profile picture - Account details - And more | TweetUserFieldsFilter | No |
+| list_fields | Choose what information you want to see about the Twitter Lists themselves, such as: - List name - Description - Number of followers - Number of members - Whether it's private - Creation date - And more | ListFieldsFilter | No |
+| list_id | The ID of the List to lookup | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| id | ID of the Twitter List | str |
+| name | Name of the Twitter List | str |
+| owner_id | ID of the List owner | str |
+| owner_username | Username of the List owner | str |
+| data | Complete list data | Dict[str, Any] |
+| included | Additional data requested via expansions | Dict[str, Any] |
+| meta | Metadata about the response | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**List Verification**: Verify a list exists and check its current details before performing operations on it.
+
+**List Discovery**: Retrieve information about interesting lists to decide whether to follow them.
+
+**Analytics Preparation**: Gather list metadata for reporting or analysis purposes.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Get Owned Lists
+
+### What it is
+This block retrieves all Lists owned by a specified Twitter user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve all Twitter Lists created by a specific user. Results include list IDs, names, and detailed metadata with pagination support for users with many lists.
+
+The block uses Tweepy with OAuth 2.0 authentication and supports expansions to include owner profile data. Only returns public lists unless querying your own account.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with your Twitter Lists: - Select 'List_Owner_ID' to get details about who owns the list  This will let you see more details about the list owner when you also select user fields below. | ListExpansionsFilter | No |
+| user_fields | Choose what information you want to see about list owners. This only works when you select 'List_Owner_ID' in expansions above.  You can see things like: - Their username - Profile picture - Account details - And more | TweetUserFieldsFilter | No |
+| list_fields | Choose what information you want to see about the Twitter Lists themselves, such as: - List name - Description - Number of followers - Number of members - Whether it's private - Creation date - And more | ListFieldsFilter | No |
+| user_id | The user ID whose owned Lists to retrieve | str | Yes |
+| max_results | Maximum number of results per page (1-100) | int | No |
+| pagination_token | Token for pagination | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| list_ids | List ids of the owned lists | List[str] |
+| list_names | List names of the owned lists | List[str] |
+| next_token | Token for next page of results | str |
+| data | Complete owned lists data | List[Dict[str, Any]] |
+| included | Additional data requested via expansions | Dict[str, Any] |
+| meta | Metadata about the response | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**List Discovery**: Find all public lists created by influencers or thought leaders in your industry.
+
+**Account Audit**: Review all lists you own to identify ones to update or delete.
+
+**Competitive Analysis**: Discover how competitors organize their Twitter following through their public lists.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/twitter/list_members.md b/docs/integrations/twitter/list_members.md
new file mode 100644
index 0000000000..357ab4fa9d
--- /dev/null
+++ b/docs/integrations/twitter/list_members.md
@@ -0,0 +1,169 @@
+# Twitter List Members
+<!-- MANUAL: file_description -->
+Blocks for managing members of Twitter/X lists.
+<!-- END MANUAL -->
+
+## Twitter Add List Member
+
+### What it is
+This block adds a specified user to a Twitter List owned by the authenticated user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to add a user to a Twitter List that you own. The added user will appear in the list's member roster and their tweets will show in the list timeline.
+
+The block authenticates using OAuth 2.0 with list write permissions. Only the list owner can add members. The target user does not need to approve being added to public lists.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| list_id | The ID of the List to add the member to | str | Yes |
+| user_id | The ID of the user to add to the List | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the member was successfully added | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**List Curation**: Build curated lists by adding relevant accounts you discover.
+
+**Community Organization**: Add new community members or contributors to tracking lists.
+
+**Research Lists**: Add accounts to research lists for ongoing monitoring projects.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Get List Members
+
+### What it is
+This block retrieves the members of a specified Twitter List.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve all members of a specific Twitter List. Results include user IDs, usernames, and optionally expanded profile data with pagination support.
+
+The block uses Tweepy with OAuth 2.0 authentication. Works for public lists and private lists you own or are a member of. Returns member data in batches of up to 100 users.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with user data. Currently only 'pinned_tweet_id' is available to see a user's pinned tweet. | UserExpansionsFilter | No |
+| tweet_fields | Select what tweet information you want to see in pinned tweets. This only works if you select 'pinned_tweet_id' in expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see, like username, bio, profile picture, etc. | TweetUserFieldsFilter | No |
+| list_id | The ID of the List to get members from | str | Yes |
+| max_results | Maximum number of results per page (1-100) | int | No |
+| pagination_token | Token for pagination of results | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| ids | List of member user IDs | List[str] |
+| usernames | List of member usernames | List[str] |
+| next_token | Next token for pagination | str |
+| data | Complete user data for list members | List[Dict[str, Any]] |
+| included | Additional data requested via expansions | Dict[str, Any] |
+| meta | Metadata including pagination info | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Audience Analysis**: Analyze the composition of curated lists to understand target audiences.
+
+**List Export**: Export list members for analysis or to recreate lists on other platforms.
+
+**Member Verification**: Check if specific users are members of a particular list.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Get List Memberships
+
+### What it is
+This block retrieves all Lists that a specified user is a member of.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve all Lists that include a specific user as a member. This shows which curated lists have added this account.
+
+The block uses Tweepy with OAuth 2.0 authentication and supports expansions for list owner data. Returns paginated results with list IDs and metadata. Only returns public lists unless querying your own memberships.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with your Twitter Lists: - Select 'List_Owner_ID' to get details about who owns the list  This will let you see more details about the list owner when you also select user fields below. | ListExpansionsFilter | No |
+| user_fields | Choose what information you want to see about list owners. This only works when you select 'List_Owner_ID' in expansions above.  You can see things like: - Their username - Profile picture - Account details - And more | TweetUserFieldsFilter | No |
+| list_fields | Choose what information you want to see about the Twitter Lists themselves, such as: - List name - Description - Number of followers - Number of members - Whether it's private - Creation date - And more | ListFieldsFilter | No |
+| user_id | The ID of the user whose List memberships to retrieve | str | Yes |
+| max_results | Maximum number of results per page (1-100) | int | No |
+| pagination_token | Token for pagination of results | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| list_ids | List of list IDs | List[str] |
+| next_token | Next token for pagination | str |
+| data | List membership data | List[Dict[str, Any]] |
+| included | Additional data requested via expansions | Dict[str, Any] |
+| meta | Metadata about pagination | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Influence Analysis**: Discover what curated lists include an influencer or competitor.
+
+**Profile Research**: Understand how others categorize a specific account.
+
+**Visibility Assessment**: See which lists feature your own account for reputation tracking.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Remove List Member
+
+### What it is
+This block removes a specified user from a Twitter List owned by the authenticated user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to remove a user from a Twitter List that you own. The removed user will no longer appear in the list and their tweets won't show in the list timeline.
+
+The block authenticates using OAuth 2.0 with list write permissions. Only the list owner can remove members. The removed user is not notified.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| list_id | The ID of the List to remove the member from | str | Yes |
+| user_id | The ID of the user to remove from the List | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the member was successfully removed | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**List Maintenance**: Remove inactive or irrelevant accounts from your curated lists.
+
+**Quality Control**: Remove accounts that no longer meet the list's criteria or purpose.
+
+**List Cleanup**: Periodically clean up lists by removing accounts that have changed focus.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/twitter/list_tweets_lookup.md b/docs/integrations/twitter/list_tweets_lookup.md
new file mode 100644
index 0000000000..9eebc930c4
--- /dev/null
+++ b/docs/integrations/twitter/list_tweets_lookup.md
@@ -0,0 +1,53 @@
+# Twitter List Tweets Lookup
+<!-- MANUAL: file_description -->
+Blocks for retrieving tweets from Twitter/X lists.
+<!-- END MANUAL -->
+
+## Twitter Get List Tweets
+
+### What it is
+This block retrieves tweets from a specified Twitter list.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve tweets posted by members of a specific Twitter List. Results include all tweets from list members in reverse chronological order, providing a curated timeline based on the list's membership.
+
+The block uses Tweepy with OAuth 2.0 authentication and supports extensive expansions to include additional data like media, author profiles, and referenced tweets. Pagination allows retrieving large volumes of list content in batches of up to 100 tweets.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with your tweets. For example: - Select 'Media_Keys' to get media details - Select 'Author_User_ID' to get user information - Select 'Place_ID' to get location details | ExpansionFilter | No |
+| media_fields | Select what media information you want to see (images, videos, etc). To use this, you must first select 'Media_Keys' in the expansions above. | TweetMediaFieldsFilter | No |
+| place_fields | Select what location information you want to see (country, coordinates, etc). To use this, you must first select 'Place_ID' in the expansions above. | TweetPlaceFieldsFilter | No |
+| poll_fields | Select what poll information you want to see (options, voting status, etc). To use this, you must first select 'Poll_IDs' in the expansions above. | TweetPollFieldsFilter | No |
+| tweet_fields | Select what tweet information you want to see. For referenced tweets (like retweets), select 'Referenced_Tweet_ID' in the expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see. To use this, you must first select one of these in expansions above: - 'Author_User_ID' for tweet authors - 'Mentioned_Usernames' for mentioned users - 'Reply_To_User_ID' for users being replied to - 'Referenced_Tweet_Author_ID' for authors of referenced tweets | TweetUserFieldsFilter | No |
+| list_id | The ID of the List whose Tweets you would like to retrieve | str | Yes |
+| max_results | Maximum number of results per page (1-100) | int | No |
+| pagination_token | Token for paginating through results | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| tweet_ids | List of tweet IDs | List[str] |
+| texts | List of tweet texts | List[str] |
+| next_token | Token for next page of results | str |
+| data | Complete list tweets data | List[Dict[str, Any]] |
+| included | Additional data requested via expansions | Dict[str, Any] |
+| meta | Response metadata including pagination tokens | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Industry News Aggregation**: Retrieve tweets from curated industry expert lists to create automated news digests.
+
+**Topic Monitoring**: Monitor tweets from lists focused on specific topics like AI, crypto, or sports for trend analysis.
+
+**Content Curation**: Pull tweets from influencer lists to identify high-quality content for sharing or engagement.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/twitter/manage.md b/docs/integrations/twitter/manage.md
new file mode 100644
index 0000000000..00957bf5b3
--- /dev/null
+++ b/docs/integrations/twitter/manage.md
@@ -0,0 +1,136 @@
+# Twitter Manage
+<!-- MANUAL: file_description -->
+Blocks for posting, deleting, and managing tweets on Twitter/X.
+<!-- END MANUAL -->
+
+## Twitter Delete Tweet
+
+### What it is
+This block deletes a tweet on Twitter.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to permanently delete a tweet from the authenticated user's account. The deletion is immediate and cannot be undone.
+
+The block authenticates using OAuth 2.0 with tweet write permissions and sends a DELETE request for the specified tweet ID. Only the tweet's author can delete their own tweets. Returns a success indicator confirming the deletion.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| tweet_id | ID of the tweet to delete | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the tweet deletion failed | str |
+| success | Whether the tweet was successfully deleted | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Cleanup**: Remove outdated tweets that contain incorrect information or expired promotions.
+
+**Error Correction**: Delete tweets with typos or mistakes before reposting corrected versions.
+
+**Reputation Management**: Remove tweets that may no longer align with your brand messaging or values.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Post Tweet
+
+### What it is
+This block posts a tweet on Twitter.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to publish a new tweet from the authenticated user's account. The tweet can include text, media attachments, polls, location tags, and quote references.
+
+The block supports advanced features like restricting replies to mentioned users or followers only, posting exclusively for Super Followers, and threading by replying to existing tweets. Returns the created tweet's ID and URL on success.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| tweet_text | Text of the tweet to post | str | No |
+| for_super_followers_only | Tweet exclusively for Super Followers | bool | No |
+| attachment | Additional tweet data (media, deep link, poll, place or quote) | Any | No |
+| exclude_reply_user_ids | User IDs to exclude from reply Tweet thread. [ex - 6253282] | List[str] | No |
+| in_reply_to_tweet_id | Tweet ID being replied to. Please note that in_reply_to_tweet_id needs to be in the request if exclude_reply_user_ids is present | str | No |
+| reply_settings | Who can reply to the Tweet (mentionedUsers or following) | TweetReplySettingsFilter | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the tweet posting failed | str |
+| tweet_id | ID of the created tweet | str |
+| tweet_url | URL to the tweet | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Automated Publishing**: Schedule and post tweets automatically based on content calendars or triggers.
+
+**Bot Responses**: Create bots that post helpful information or automated responses.
+
+**Content Distribution**: Automatically share new blog posts, product updates, or announcements on Twitter.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Search Recent Tweets
+
+### What it is
+This block searches all public Tweets in Twitter history.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to search for public tweets matching a query. The search supports Twitter's advanced query syntax including boolean operators, hashtags, mentions, and filters for engagement metrics.
+
+Results can be filtered by time range (start/end times), sorted by recency or relevance, and paginated for retrieving large result sets. The block supports expansions to include additional data like media, author information, and referenced tweets.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| start_time | Start time in YYYY-MM-DDTHH:mm:ssZ format. If set to a time less than 10 seconds ago, it will be automatically adjusted to 10 seconds ago (Twitter API requirement). | str (date-time) | No |
+| end_time | End time in YYYY-MM-DDTHH:mm:ssZ format | str (date-time) | No |
+| since_id | Returns results with Tweet ID  greater than this (more recent than), we give priority to since_id over start_time | str | No |
+| until_id | Returns results with Tweet ID less than this (that is, older than), and used with since_id | str | No |
+| sort_order | Order of returned tweets (recency or relevancy) | str | No |
+| expansions | Choose what extra information you want to get with your tweets. For example: - Select 'Media_Keys' to get media details - Select 'Author_User_ID' to get user information - Select 'Place_ID' to get location details | ExpansionFilter | No |
+| media_fields | Select what media information you want to see (images, videos, etc). To use this, you must first select 'Media_Keys' in the expansions above. | TweetMediaFieldsFilter | No |
+| place_fields | Select what location information you want to see (country, coordinates, etc). To use this, you must first select 'Place_ID' in the expansions above. | TweetPlaceFieldsFilter | No |
+| poll_fields | Select what poll information you want to see (options, voting status, etc). To use this, you must first select 'Poll_IDs' in the expansions above. | TweetPollFieldsFilter | No |
+| tweet_fields | Select what tweet information you want to see. For referenced tweets (like retweets), select 'Referenced_Tweet_ID' in the expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see. To use this, you must first select one of these in expansions above: - 'Author_User_ID' for tweet authors - 'Mentioned_Usernames' for mentioned users - 'Reply_To_User_ID' for users being replied to - 'Referenced_Tweet_Author_ID' for authors of referenced tweets | TweetUserFieldsFilter | No |
+| query | Search query (up to 1024 characters) | str | Yes |
+| max_results | Maximum number of results per page (10-500) | int | No |
+| pagination | Token for pagination | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| tweet_ids | All Tweet IDs | List[str] |
+| tweet_texts | All Tweet texts | List[str] |
+| next_token | Next token for pagination | str |
+| data | Complete Tweet data | List[Dict[str, Any]] |
+| included | Additional data that you have requested (Optional) via Expansions field | Dict[str, Any] |
+| meta | Provides metadata such as pagination info (next_token) or result counts | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Brand Monitoring**: Search for mentions of your brand, products, or key terms to monitor sentiment and engagement.
+
+**Competitor Analysis**: Track competitor mentions and campaigns to understand market positioning.
+
+**Trend Research**: Search for trending topics or hashtags to identify opportunities for engagement or content creation.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/twitter/manage_lists.md b/docs/integrations/twitter/manage_lists.md
new file mode 100644
index 0000000000..fce3a1a2c2
--- /dev/null
+++ b/docs/integrations/twitter/manage_lists.md
@@ -0,0 +1,117 @@
+# Twitter Manage Lists
+<!-- MANUAL: file_description -->
+Blocks for creating, updating, and deleting Twitter/X lists.
+<!-- END MANUAL -->
+
+## Twitter Create List
+
+### What it is
+This block creates a new Twitter List for the authenticated user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to create a new Twitter List under your account. You can specify the list name, description, and whether it should be public or private.
+
+The block authenticates using OAuth 2.0 with list write permissions and sends a POST request to create the list. Returns the new list's ID and URL upon successful creation.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| name | The name of the List to be created | str | No |
+| description | Description of the List | str | No |
+| private | Whether the List should be private | bool | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| url | URL of the created list | str |
+| list_id | ID of the created list | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Automated List Setup**: Programmatically create lists as part of onboarding workflows or project initialization.
+
+**Campaign Organization**: Create dedicated lists for tracking accounts related to specific marketing campaigns.
+
+**Research Projects**: Set up new lists to organize accounts for research or monitoring initiatives.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Delete List
+
+### What it is
+This block deletes a specified Twitter List owned by the authenticated user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to permanently delete a Twitter List that you own. The list and all its member associations are removed and cannot be recovered.
+
+The block authenticates using OAuth 2.0 with list write permissions and sends a DELETE request. Only lists you own can be deleted. Returns a success indicator confirming the deletion.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| list_id | The ID of the List to be deleted | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the deletion was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Account Cleanup**: Remove outdated or unused lists as part of regular account maintenance.
+
+**Project Completion**: Delete temporary lists created for campaigns or projects that have concluded.
+
+**Privacy Management**: Remove lists that are no longer needed to reduce your public profile footprint.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Update List
+
+### What it is
+This block updates a specified Twitter List owned by the authenticated user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to update the metadata of a Twitter List you own. You can modify the list name and description without affecting the list's members.
+
+The block authenticates using OAuth 2.0 with list write permissions and sends a PUT request with the updated fields. Returns a success indicator confirming the changes were applied.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| list_id | The ID of the List to be updated | str | Yes |
+| name | New name for the List | str | No |
+| description | New description for the List | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the update was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**List Rebranding**: Update list names and descriptions to better reflect their evolving purpose.
+
+**Seasonal Updates**: Modify list descriptions to indicate current focus areas or time periods.
+
+**Organization Improvement**: Rename lists to follow consistent naming conventions across your account.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/twitter/mutes.md b/docs/integrations/twitter/mutes.md
new file mode 100644
index 0000000000..d7db2ebd09
--- /dev/null
+++ b/docs/integrations/twitter/mutes.md
@@ -0,0 +1,121 @@
+# Twitter Mutes
+<!-- MANUAL: file_description -->
+Blocks for managing muted users on Twitter/X.
+<!-- END MANUAL -->
+
+## Twitter Get Muted Users
+
+### What it is
+This block gets a list of users muted by the authenticating user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block connects to the Twitter API v2 via Tweepy to retrieve all users that the authenticated account has muted. It uses OAuth 2.0 authentication with appropriate scopes and returns paginated results with user IDs, usernames, and optional expanded data.
+
+The mute list is returned in batches (default 100, up to 1,000 per page), with pagination tokens for navigating large lists. Unlike blocking, muted users can still see and interact with your content—they're simply hidden from your timeline.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with user data. Currently only 'pinned_tweet_id' is available to see a user's pinned tweet. | UserExpansionsFilter | No |
+| tweet_fields | Select what tweet information you want to see in pinned tweets. This only works if you select 'pinned_tweet_id' in expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see, like username, bio, profile picture, etc. | TweetUserFieldsFilter | No |
+| max_results | The maximum number of results to be returned per page (1-1000). Default is 100. | int | No |
+| pagination_token | Token to request next/previous page of results | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| ids | List of muted user IDs | List[str] |
+| usernames | List of muted usernames | List[str] |
+| next_token | Next token for pagination | str |
+| data | Complete user data for muted users | List[Dict[str, Any]] |
+| includes | Additional data requested via expansions | Dict[str, Any] |
+| meta | Metadata including pagination info | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Timeline Cleanup**: Review which accounts you've muted to decide if you want to unmute any or convert mutes to blocks.
+
+**Noise Reduction Audit**: Analyze your mute list to understand what types of content you're filtering from your feed.
+
+**Account Management**: Export your mute list for backup or to apply similar muting patterns to another account.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Mute User
+
+### What it is
+This block mutes a specified Twitter user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block sends a mute request to the Twitter API v2 for a specified user ID. The authenticated user will no longer see tweets from the muted account in their timeline, but the muted user is not notified and can still view and interact with your content.
+
+The mute action is performed using Tweepy's client interface with OAuth 2.0 authentication. The block returns a success indicator confirming whether the mute was applied.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| target_user_id | The user ID of the user that you would like to mute | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the mute action was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Automated Filtering**: Mute accounts that post frequently about topics you want to temporarily avoid without unfollowing.
+
+**Event Management**: Mute accounts live-tweeting events you can't attend to avoid spoilers.
+
+**Conversation Management**: Mute accounts during heated discussions without blocking them permanently.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Unmute User
+
+### What it is
+This block unmutes a specified Twitter user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block sends an unmute request to the Twitter API v2 for a specified user ID. Once unmuted, tweets from that account will appear in your timeline again as normal.
+
+The unmute action uses Tweepy's client interface with OAuth 2.0 authentication. The block returns a success indicator confirming whether the mute was removed.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| target_user_id | The user ID of the user that you would like to unmute | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the unmute action was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Post-Event Restore**: Unmute accounts after an event ends that you were avoiding spoilers for.
+
+**Periodic Review**: Unmute accounts as part of a scheduled review of your mute list.
+
+**Relationship Repair**: Restore visibility of accounts after cooling-off periods from disagreements.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/twitter/pinned_lists.md b/docs/integrations/twitter/pinned_lists.md
new file mode 100644
index 0000000000..e40a570faa
--- /dev/null
+++ b/docs/integrations/twitter/pinned_lists.md
@@ -0,0 +1,118 @@
+# Twitter Pinned Lists
+<!-- MANUAL: file_description -->
+Blocks for managing pinned lists on Twitter/X.
+<!-- END MANUAL -->
+
+## Twitter Get Pinned Lists
+
+### What it is
+This block returns the Lists pinned by the authenticated user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve all Lists that the authenticated user has pinned for quick access. Pinned lists appear prominently in the user's Lists tab on Twitter.
+
+The block uses Tweepy with OAuth 2.0 authentication and supports expansions to include owner profile data and detailed list metadata. Returns list IDs, names, and complete list data objects.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with your Twitter Lists: - Select 'List_Owner_ID' to get details about who owns the list  This will let you see more details about the list owner when you also select user fields below. | ListExpansionsFilter | No |
+| user_fields | Choose what information you want to see about list owners. This only works when you select 'List_Owner_ID' in expansions above.  You can see things like: - Their username - Profile picture - Account details - And more | TweetUserFieldsFilter | No |
+| list_fields | Choose what information you want to see about the Twitter Lists themselves, such as: - List name - Description - Number of followers - Number of members - Whether it's private - Creation date - And more | ListFieldsFilter | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| list_ids | List IDs of the pinned lists | List[str] |
+| list_names | List names of the pinned lists | List[str] |
+| data | Response data containing pinned lists | List[Dict[str, Any]] |
+| included | Additional data requested via expansions | Dict[str, Any] |
+| meta | Metadata about the response | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Workflow Configuration**: Retrieve pinned lists to understand which lists are prioritized in user workflows.
+
+**Settings Backup**: Export pinned list configurations for backup or account migration purposes.
+
+**Dashboard Setup**: Identify pinned lists to build monitoring dashboards around priority content sources.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Pin List
+
+### What it is
+This block allows the authenticated user to pin a specified List.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to pin a Twitter List for quick access. Pinned lists appear at the top of your Lists tab on Twitter for easy navigation.
+
+The block authenticates using OAuth 2.0 with list write permissions and sends a POST request to create the pin relationship. You can pin both your own lists and lists created by others.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| list_id | The ID of the List to pin | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the pin was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Priority Organization**: Pin important lists to ensure they're easily accessible for daily monitoring.
+
+**Workflow Setup**: Automatically pin newly created lists as part of project initialization workflows.
+
+**Quick Access Configuration**: Pin frequently used lists to streamline content discovery.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Unpin List
+
+### What it is
+This block allows the authenticated user to unpin a specified List.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to unpin a Twitter List from your quick access area. The list remains followed but no longer appears in your pinned section.
+
+The block authenticates using OAuth 2.0 with list write permissions and sends a DELETE request to remove the pin relationship. Returns a success indicator confirming the list was unpinned.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| list_id | The ID of the List to unpin | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the unpin was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Pin Management**: Unpin lists that are no longer priorities to make room for more relevant ones.
+
+**Workflow Cleanup**: Remove pins from project-specific lists after campaigns or initiatives conclude.
+
+**Organization Maintenance**: Periodically unpin outdated lists to keep your pinned section focused.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/twitter/quote.md b/docs/integrations/twitter/quote.md
new file mode 100644
index 0000000000..7c144b63ca
--- /dev/null
+++ b/docs/integrations/twitter/quote.md
@@ -0,0 +1,54 @@
+# Twitter Quote
+<!-- MANUAL: file_description -->
+Blocks for retrieving quote tweets on Twitter/X.
+<!-- END MANUAL -->
+
+## Twitter Get Quote Tweets
+
+### What it is
+This block gets quote tweets for a specific tweet.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve tweets that quote a specific tweet. Quote tweets are retweets with added commentary, allowing users to share the original tweet while adding their own thoughts.
+
+The block uses Tweepy with OAuth 2.0 authentication and supports extensive expansions to include additional data like media, author information, and location details. Returns paginated results with tweet IDs, text content, and complete tweet data.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with your tweets. For example: - Select 'Media_Keys' to get media details - Select 'Author_User_ID' to get user information - Select 'Place_ID' to get location details | ExpansionFilter | No |
+| media_fields | Select what media information you want to see (images, videos, etc). To use this, you must first select 'Media_Keys' in the expansions above. | TweetMediaFieldsFilter | No |
+| place_fields | Select what location information you want to see (country, coordinates, etc). To use this, you must first select 'Place_ID' in the expansions above. | TweetPlaceFieldsFilter | No |
+| poll_fields | Select what poll information you want to see (options, voting status, etc). To use this, you must first select 'Poll_IDs' in the expansions above. | TweetPollFieldsFilter | No |
+| tweet_fields | Select what tweet information you want to see. For referenced tweets (like retweets), select 'Referenced_Tweet_ID' in the expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see. To use this, you must first select one of these in expansions above: - 'Author_User_ID' for tweet authors - 'Mentioned_Usernames' for mentioned users - 'Reply_To_User_ID' for users being replied to - 'Referenced_Tweet_Author_ID' for authors of referenced tweets | TweetUserFieldsFilter | No |
+| tweet_id | ID of the tweet to get quotes for | str | Yes |
+| max_results | Number of results to return (max 100) | int | No |
+| exclude | Types of tweets to exclude | TweetExcludesFilter | No |
+| pagination_token | Token for pagination | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| ids | All Tweet IDs  | List[Any] |
+| texts | All Tweet texts | List[Any] |
+| next_token | Next token for pagination | str |
+| data | Complete Tweet data | List[Dict[str, Any]] |
+| included | Additional data that you have requested (Optional) via Expansions field | Dict[str, Any] |
+| meta | Provides metadata such as pagination info (next_token) or result counts | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Sentiment Analysis**: Analyze how users are commenting on your tweets through quote tweets to understand sentiment.
+
+**Engagement Monitoring**: Track quote tweets to identify discussions and conversations sparked by your content.
+
+**Influencer Discovery**: Find users who quote-tweet your content to identify potential advocates or collaborators.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/twitter/retweet.md b/docs/integrations/twitter/retweet.md
new file mode 100644
index 0000000000..26b87180a2
--- /dev/null
+++ b/docs/integrations/twitter/retweet.md
@@ -0,0 +1,123 @@
+# Twitter Retweet
+<!-- MANUAL: file_description -->
+Blocks for retweeting and getting retweet information on Twitter/X.
+<!-- END MANUAL -->
+
+## Twitter Get Retweeters
+
+### What it is
+This block gets information about who has retweeted a tweet.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve a paginated list of users who have retweeted a specific tweet. Results include user IDs, usernames, display names, and optionally expanded profile data.
+
+The block uses Tweepy with OAuth 2.0 authentication. Users are returned with pagination support for tweets with many retweets. Expansions can include pinned tweet data for each user who retweeted.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with user data. Currently only 'pinned_tweet_id' is available to see a user's pinned tweet. | UserExpansionsFilter | No |
+| tweet_fields | Select what tweet information you want to see in pinned tweets. This only works if you select 'pinned_tweet_id' in expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see, like username, bio, profile picture, etc. | TweetUserFieldsFilter | No |
+| tweet_id | ID of the tweet to get retweeters for | str | Yes |
+| max_results | Maximum number of results per page (1-100) | int | No |
+| pagination_token | Token for pagination | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| ids | List of user ids who retweeted | List[Any] |
+| names | List of user names who retweeted | List[Any] |
+| usernames | List of user usernames who retweeted | List[Any] |
+| next_token | Token for next page of results | str |
+| data | Complete Tweet data | List[Dict[str, Any]] |
+| included | Additional data that you have requested (Optional) via Expansions field | Dict[str, Any] |
+| meta | Provides metadata such as pagination info (next_token) or result counts | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Reach Analysis**: Identify who is amplifying your content to understand your audience's network.
+
+**Influencer Identification**: Find influential users who retweet your content for potential partnerships.
+
+**Campaign Tracking**: Monitor retweets during campaigns to measure virality and engagement.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Remove Retweet
+
+### What it is
+This block removes a retweet on Twitter.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to remove a retweet from the authenticated user's account. The original tweet remains unaffected—only your retweet is removed.
+
+The block authenticates using OAuth 2.0 with tweet write permissions and sends a DELETE request to undo the retweet. Returns a success indicator confirming the retweet was removed.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| tweet_id | ID of the tweet to remove retweet | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the retweet was successfully removed | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Curation**: Remove retweets that are no longer relevant or that you no longer want to amplify.
+
+**Account Cleanup**: Undo accidental retweets or clean up your timeline.
+
+**Brand Alignment**: Remove retweets of content that no longer aligns with your messaging or values.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Retweet
+
+### What it is
+This block retweets a tweet on Twitter.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the Twitter API v2 via Tweepy to retweet a tweet on behalf of the authenticated user. The retweet shares the original tweet with your followers without adding commentary.
+
+The block authenticates using OAuth 2.0 with tweet write permissions and sends a POST request to create the retweet. Returns a success indicator confirming the retweet was created.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| tweet_id | ID of the tweet to retweet | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| success | Whether the retweet was successful | bool |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Amplification**: Automatically retweet content from partner accounts or industry news sources.
+
+**Community Engagement**: Retweet positive mentions or user-generated content to show appreciation.
+
+**Information Sharing**: Amplify important announcements or breaking news to your followers.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/twitter/search_spaces.md b/docs/integrations/twitter/search_spaces.md
new file mode 100644
index 0000000000..d89c5f5246
--- /dev/null
+++ b/docs/integrations/twitter/search_spaces.md
@@ -0,0 +1,51 @@
+# Twitter Search Spaces
+<!-- MANUAL: file_description -->
+Blocks for searching Twitter/X Spaces live audio conversations.
+<!-- END MANUAL -->
+
+## Twitter Search Spaces
+
+### What it is
+This block searches for Twitter Spaces based on specified terms.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to search for Twitter Spaces (live audio conversations) matching a search term. Results can be filtered by state (live, scheduled, or all) and include Space metadata like title, host information, and participant counts.
+
+The block uses Tweepy with OAuth 2.0 authentication and supports expansions to include additional data about creators, hosts, speakers, invited users, and topics. Returns paginated results with Space IDs, titles, and host information.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose additional information you want to get with your Twitter Spaces: - Select 'Invited_Users' to see who was invited - Select 'Speakers' to see who can speak - Select 'Creator' to get details about who made the Space - Select 'Hosts' to see who's hosting - Select 'Topics' to see Space topics | SpaceExpansionsFilter | No |
+| space_fields | Choose what Space details you want to see, such as: - Title - Start/End times - Number of participants - Language - State (live/scheduled) - And more | SpaceFieldsFilter | No |
+| user_fields | Choose what user information you want to see. This works when you select any of these in expansions above: - 'Creator' for Space creator details - 'Hosts' for host information - 'Speakers' for speaker details - 'Invited_Users' for invited user information | TweetUserFieldsFilter | No |
+| query | Search term to find in Space titles | str | Yes |
+| max_results | Maximum number of results to return (1-100) | int | No |
+| state | Type of Spaces to return (live, scheduled, or all) | "live" \| "scheduled" \| "all" | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| ids | List of space IDs | List[str] |
+| titles | List of space titles | List[str] |
+| host_ids | List of host IDs | List[Any] |
+| next_token | Next token for pagination | str |
+| data | Complete space data | List[Dict[str, Any]] |
+| includes | Additional data requested via expansions | Dict[str, Any] |
+| meta | Metadata including pagination info | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Event Discovery**: Find live or upcoming Spaces about topics you're interested in to join or monitor.
+
+**Industry Monitoring**: Track Spaces related to your industry to stay informed about discussions and trends.
+
+**Competitor Analysis**: Search for Spaces hosted by competitors to understand their community engagement strategies.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/twitter/spaces_lookup.md b/docs/integrations/twitter/spaces_lookup.md
new file mode 100644
index 0000000000..58311c19ac
--- /dev/null
+++ b/docs/integrations/twitter/spaces_lookup.md
@@ -0,0 +1,177 @@
+# Twitter Spaces Lookup
+<!-- MANUAL: file_description -->
+Blocks for retrieving information about Twitter/X Spaces.
+<!-- END MANUAL -->
+
+## Twitter Get Space Buyers
+
+### What it is
+This block retrieves a list of users who purchased tickets to a Twitter Space.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve a list of users who purchased tickets to a ticketed Twitter Space. Only the Space creator or hosts can access buyer information.
+
+The block uses Tweepy with OAuth 2.0 authentication and returns buyer user IDs, usernames, and optionally expanded profile data. This is useful for managing ticketed events and understanding your paying audience.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with user data. Currently only 'pinned_tweet_id' is available to see a user's pinned tweet. | UserExpansionsFilter | No |
+| tweet_fields | Select what tweet information you want to see in pinned tweets. This only works if you select 'pinned_tweet_id' in expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see, like username, bio, profile picture, etc. | TweetUserFieldsFilter | No |
+| space_id | Space ID to lookup buyers for | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| buyer_ids | List of buyer IDs | List[str] |
+| usernames | List of buyer usernames | List[str] |
+| data | Complete space buyers data | List[Dict[str, Any]] |
+| includes | Additional data requested via expansions | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Audience Management**: Track who purchased tickets to manage attendee lists and send follow-ups.
+
+**Revenue Tracking**: Monitor ticket buyers for ticketed Spaces to understand revenue and audience composition.
+
+**Exclusive Content Delivery**: Identify ticket buyers to provide exclusive content or resources to paid attendees.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Get Space By Id
+
+### What it is
+This block retrieves information about a single Twitter Space.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve detailed information about a specific Twitter Space by its ID. Returns Space metadata including title, state, host information, and timing details.
+
+The block uses Tweepy with OAuth 2.0 authentication and supports expansions for additional data about creators, hosts, speakers, and topics. Works for both live and scheduled Spaces.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose additional information you want to get with your Twitter Spaces: - Select 'Invited_Users' to see who was invited - Select 'Speakers' to see who can speak - Select 'Creator' to get details about who made the Space - Select 'Hosts' to see who's hosting - Select 'Topics' to see Space topics | SpaceExpansionsFilter | No |
+| space_fields | Choose what Space details you want to see, such as: - Title - Start/End times - Number of participants - Language - State (live/scheduled) - And more | SpaceFieldsFilter | No |
+| user_fields | Choose what user information you want to see. This works when you select any of these in expansions above: - 'Creator' for Space creator details - 'Hosts' for host information - 'Speakers' for speaker details - 'Invited_Users' for invited user information | TweetUserFieldsFilter | No |
+| space_id | Space ID to lookup | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| id | Space ID | str |
+| title | Space title | str |
+| host_ids | Host ID | List[str] |
+| data | Complete space data | Dict[str, Any] |
+| includes | Additional data requested via expansions | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Space Monitoring**: Check the status and details of a specific Space you're interested in or hosting.
+
+**Event Tracking**: Monitor when a scheduled Space goes live or verify its current state.
+
+**Analytics Preparation**: Gather Space metadata before or after an event for reporting and analysis.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Get Space Tweets
+
+### What it is
+This block retrieves tweets shared in a Twitter Space.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve tweets that were shared during a Twitter Space. This includes tweets pinned or shared by hosts and speakers during the live audio session.
+
+The block uses Tweepy with OAuth 2.0 authentication and supports extensive expansions to include additional data like media, author information, and referenced tweets. Returns tweet IDs, text content, and complete tweet data.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with your tweets. For example: - Select 'Media_Keys' to get media details - Select 'Author_User_ID' to get user information - Select 'Place_ID' to get location details | ExpansionFilter | No |
+| media_fields | Select what media information you want to see (images, videos, etc). To use this, you must first select 'Media_Keys' in the expansions above. | TweetMediaFieldsFilter | No |
+| place_fields | Select what location information you want to see (country, coordinates, etc). To use this, you must first select 'Place_ID' in the expansions above. | TweetPlaceFieldsFilter | No |
+| poll_fields | Select what poll information you want to see (options, voting status, etc). To use this, you must first select 'Poll_IDs' in the expansions above. | TweetPollFieldsFilter | No |
+| tweet_fields | Select what tweet information you want to see. For referenced tweets (like retweets), select 'Referenced_Tweet_ID' in the expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see. To use this, you must first select one of these in expansions above: - 'Author_User_ID' for tweet authors - 'Mentioned_Usernames' for mentioned users - 'Reply_To_User_ID' for users being replied to - 'Referenced_Tweet_Author_ID' for authors of referenced tweets | TweetUserFieldsFilter | No |
+| space_id | Space ID to lookup tweets for | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| tweet_ids | List of tweet IDs | List[str] |
+| texts | List of tweet texts | List[str] |
+| data | Complete space tweets data | List[Dict[str, Any]] |
+| includes | Additional data requested via expansions | Dict[str, Any] |
+| meta | Response metadata | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Curation**: Collect tweets shared during a Space to create summaries or follow-up content.
+
+**Resource Compilation**: Gather links and resources shared during educational or informational Spaces.
+
+**Event Documentation**: Archive tweets from important Spaces for reference or community sharing.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Get Spaces
+
+### What it is
+This block retrieves information about multiple Twitter Spaces.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve information about multiple Twitter Spaces in a single request. You can look up Spaces by their IDs or by creator user IDs, making it efficient for batch operations.
+
+The block uses Tweepy with OAuth 2.0 authentication and supports expansions for additional data about creators, hosts, speakers, and topics. Returns arrays of Space IDs, titles, and complete Space data objects.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose additional information you want to get with your Twitter Spaces: - Select 'Invited_Users' to see who was invited - Select 'Speakers' to see who can speak - Select 'Creator' to get details about who made the Space - Select 'Hosts' to see who's hosting - Select 'Topics' to see Space topics | SpaceExpansionsFilter | No |
+| space_fields | Choose what Space details you want to see, such as: - Title - Start/End times - Number of participants - Language - State (live/scheduled) - And more | SpaceFieldsFilter | No |
+| user_fields | Choose what user information you want to see. This works when you select any of these in expansions above: - 'Creator' for Space creator details - 'Hosts' for host information - 'Speakers' for speaker details - 'Invited_Users' for invited user information | TweetUserFieldsFilter | No |
+| identifier | Choose whether to lookup spaces by their IDs or by creator user IDs | Identifier | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| ids | List of space IDs | List[str] |
+| titles | List of space titles | List[str] |
+| data | Complete space data | List[Dict[str, Any]] |
+| includes | Additional data requested via expansions | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Creator Monitoring**: Track all Spaces hosted by specific creators or influencers you follow.
+
+**Batch Analysis**: Retrieve information about multiple Spaces at once for comparative analysis.
+
+**Schedule Tracking**: Monitor upcoming Spaces from multiple accounts to plan your participation.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/twitter/timeline.md b/docs/integrations/twitter/timeline.md
new file mode 100644
index 0000000000..3ad5a0d5ef
--- /dev/null
+++ b/docs/integrations/twitter/timeline.md
@@ -0,0 +1,171 @@
+# Twitter Timeline
+<!-- MANUAL: file_description -->
+Blocks for retrieving Twitter/X timelines and user tweets.
+<!-- END MANUAL -->
+
+## Twitter Get Home Timeline
+
+### What it is
+This block retrieves the authenticated user's home timeline.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve the authenticated user's home timeline—tweets from accounts they follow and their own tweets. Results are returned in reverse chronological order with optional filtering by time range.
+
+The block uses Tweepy with OAuth 2.0 authentication and supports extensive expansions to include additional data like media, author information, and referenced tweets. Pagination allows retrieving large timelines in batches of up to 100 tweets.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| start_time | Start time in YYYY-MM-DDTHH:mm:ssZ format. If set to a time less than 10 seconds ago, it will be automatically adjusted to 10 seconds ago (Twitter API requirement). | str (date-time) | No |
+| end_time | End time in YYYY-MM-DDTHH:mm:ssZ format | str (date-time) | No |
+| since_id | Returns results with Tweet ID  greater than this (more recent than), we give priority to since_id over start_time | str | No |
+| until_id | Returns results with Tweet ID less than this (that is, older than), and used with since_id | str | No |
+| sort_order | Order of returned tweets (recency or relevancy) | str | No |
+| expansions | Choose what extra information you want to get with your tweets. For example: - Select 'Media_Keys' to get media details - Select 'Author_User_ID' to get user information - Select 'Place_ID' to get location details | ExpansionFilter | No |
+| media_fields | Select what media information you want to see (images, videos, etc). To use this, you must first select 'Media_Keys' in the expansions above. | TweetMediaFieldsFilter | No |
+| place_fields | Select what location information you want to see (country, coordinates, etc). To use this, you must first select 'Place_ID' in the expansions above. | TweetPlaceFieldsFilter | No |
+| poll_fields | Select what poll information you want to see (options, voting status, etc). To use this, you must first select 'Poll_IDs' in the expansions above. | TweetPollFieldsFilter | No |
+| tweet_fields | Select what tweet information you want to see. For referenced tweets (like retweets), select 'Referenced_Tweet_ID' in the expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see. To use this, you must first select one of these in expansions above: - 'Author_User_ID' for tweet authors - 'Mentioned_Usernames' for mentioned users - 'Reply_To_User_ID' for users being replied to - 'Referenced_Tweet_Author_ID' for authors of referenced tweets | TweetUserFieldsFilter | No |
+| max_results | Number of tweets to retrieve (5-100) | int | No |
+| pagination_token | Token for pagination | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| ids | List of Tweet IDs | List[str] |
+| texts | All Tweet texts | List[str] |
+| userIds | List of user ids that authored the tweets | List[str] |
+| userNames | List of user names that authored the tweets | List[str] |
+| next_token | Next token for pagination | str |
+| data | Complete Tweet data | List[Dict[str, Any]] |
+| included | Additional data that you have requested (Optional) via Expansions field | Dict[str, Any] |
+| meta | Provides metadata such as pagination info (next_token) or result counts | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Digest**: Create automated summaries of your timeline for daily or weekly review.
+
+**Trend Detection**: Monitor your timeline for emerging topics or conversations among accounts you follow.
+
+**Engagement Automation**: Process timeline content to identify tweets worth engaging with or responding to.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Get User Mentions
+
+### What it is
+This block retrieves Tweets mentioning a specific user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve tweets that @mention a specific user. Results include replies to the user's tweets, direct mentions, and tagged responses from other accounts.
+
+The block uses Tweepy with OAuth 2.0 authentication and supports time-based filtering and pagination. Expansions allow including additional data like media, author information, and referenced tweets. Returns tweet IDs, text, author information, and complete tweet data.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| start_time | Start time in YYYY-MM-DDTHH:mm:ssZ format. If set to a time less than 10 seconds ago, it will be automatically adjusted to 10 seconds ago (Twitter API requirement). | str (date-time) | No |
+| end_time | End time in YYYY-MM-DDTHH:mm:ssZ format | str (date-time) | No |
+| since_id | Returns results with Tweet ID  greater than this (more recent than), we give priority to since_id over start_time | str | No |
+| until_id | Returns results with Tweet ID less than this (that is, older than), and used with since_id | str | No |
+| sort_order | Order of returned tweets (recency or relevancy) | str | No |
+| expansions | Choose what extra information you want to get with your tweets. For example: - Select 'Media_Keys' to get media details - Select 'Author_User_ID' to get user information - Select 'Place_ID' to get location details | ExpansionFilter | No |
+| media_fields | Select what media information you want to see (images, videos, etc). To use this, you must first select 'Media_Keys' in the expansions above. | TweetMediaFieldsFilter | No |
+| place_fields | Select what location information you want to see (country, coordinates, etc). To use this, you must first select 'Place_ID' in the expansions above. | TweetPlaceFieldsFilter | No |
+| poll_fields | Select what poll information you want to see (options, voting status, etc). To use this, you must first select 'Poll_IDs' in the expansions above. | TweetPollFieldsFilter | No |
+| tweet_fields | Select what tweet information you want to see. For referenced tweets (like retweets), select 'Referenced_Tweet_ID' in the expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see. To use this, you must first select one of these in expansions above: - 'Author_User_ID' for tweet authors - 'Mentioned_Usernames' for mentioned users - 'Reply_To_User_ID' for users being replied to - 'Referenced_Tweet_Author_ID' for authors of referenced tweets | TweetUserFieldsFilter | No |
+| user_id | Unique identifier of the user for whom to return Tweets mentioning the user | str | Yes |
+| max_results | Number of tweets to retrieve (5-100) | int | No |
+| pagination_token | Token for pagination | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| ids | List of Tweet IDs | List[str] |
+| texts | All Tweet texts | List[str] |
+| userIds | List of user ids that mentioned the user | List[str] |
+| userNames | List of user names that mentioned the user | List[str] |
+| next_token | Next token for pagination | str |
+| data | Complete Tweet data | List[Dict[str, Any]] |
+| included | Additional data that you have requested (Optional) via Expansions field | Dict[str, Any] |
+| meta | Provides metadata such as pagination info (next_token) or result counts | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Mention Monitoring**: Track all mentions of your account for customer service or community management.
+
+**Engagement Response**: Identify mentions that require responses or engagement for timely replies.
+
+**Sentiment Analysis**: Analyze mentions to understand how users are talking about you or your brand.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Get User Tweets
+
+### What it is
+This block retrieves Tweets composed by a single user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve tweets posted by a specific user. Results include original tweets, replies, and retweets from that user's timeline in reverse chronological order.
+
+The block uses Tweepy with OAuth 2.0 authentication and supports time-based filtering and pagination. Expansions allow including additional data like media, mentioned users, and referenced tweets. Returns tweet IDs, text content, and complete tweet data.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| start_time | Start time in YYYY-MM-DDTHH:mm:ssZ format. If set to a time less than 10 seconds ago, it will be automatically adjusted to 10 seconds ago (Twitter API requirement). | str (date-time) | No |
+| end_time | End time in YYYY-MM-DDTHH:mm:ssZ format | str (date-time) | No |
+| since_id | Returns results with Tweet ID  greater than this (more recent than), we give priority to since_id over start_time | str | No |
+| until_id | Returns results with Tweet ID less than this (that is, older than), and used with since_id | str | No |
+| sort_order | Order of returned tweets (recency or relevancy) | str | No |
+| expansions | Choose what extra information you want to get with your tweets. For example: - Select 'Media_Keys' to get media details - Select 'Author_User_ID' to get user information - Select 'Place_ID' to get location details | ExpansionFilter | No |
+| media_fields | Select what media information you want to see (images, videos, etc). To use this, you must first select 'Media_Keys' in the expansions above. | TweetMediaFieldsFilter | No |
+| place_fields | Select what location information you want to see (country, coordinates, etc). To use this, you must first select 'Place_ID' in the expansions above. | TweetPlaceFieldsFilter | No |
+| poll_fields | Select what poll information you want to see (options, voting status, etc). To use this, you must first select 'Poll_IDs' in the expansions above. | TweetPollFieldsFilter | No |
+| tweet_fields | Select what tweet information you want to see. For referenced tweets (like retweets), select 'Referenced_Tweet_ID' in the expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see. To use this, you must first select one of these in expansions above: - 'Author_User_ID' for tweet authors - 'Mentioned_Usernames' for mentioned users - 'Reply_To_User_ID' for users being replied to - 'Referenced_Tweet_Author_ID' for authors of referenced tweets | TweetUserFieldsFilter | No |
+| user_id | Unique identifier of the Twitter account (user ID) for whom to return results | str | Yes |
+| max_results | Number of tweets to retrieve (5-100) | int | No |
+| pagination_token | Token for pagination | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| ids | List of Tweet IDs | List[str] |
+| texts | All Tweet texts | List[str] |
+| userIds | List of user ids that authored the tweets | List[str] |
+| userNames | List of user names that authored the tweets | List[str] |
+| next_token | Next token for pagination | str |
+| data | Complete Tweet data | List[Dict[str, Any]] |
+| included | Additional data that you have requested (Optional) via Expansions field | Dict[str, Any] |
+| meta | Provides metadata such as pagination info (next_token) or result counts | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Competitor Monitoring**: Track tweets from competitor accounts to understand their messaging and strategy.
+
+**Content Archiving**: Archive tweets from specific accounts for research or compliance purposes.
+
+**Influencer Analysis**: Analyze posting patterns and content from influencers in your industry.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/twitter/tweet_lookup.md b/docs/integrations/twitter/tweet_lookup.md
new file mode 100644
index 0000000000..c1deebfde7
--- /dev/null
+++ b/docs/integrations/twitter/tweet_lookup.md
@@ -0,0 +1,100 @@
+# Twitter Tweet Lookup
+<!-- MANUAL: file_description -->
+Blocks for retrieving information about specific tweets on Twitter/X.
+<!-- END MANUAL -->
+
+## Twitter Get Tweet
+
+### What it is
+This block retrieves information about a specific Tweet.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve detailed information about a specific tweet by its ID. Returns tweet content, author information, engagement metrics, and any requested expanded data.
+
+The block uses Tweepy with OAuth 2.0 authentication and supports extensive expansions to include additional data like media, author profile, location, poll results, and referenced tweets. Useful for analyzing individual tweets or verifying tweet content.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with your tweets. For example: - Select 'Media_Keys' to get media details - Select 'Author_User_ID' to get user information - Select 'Place_ID' to get location details | ExpansionFilter | No |
+| media_fields | Select what media information you want to see (images, videos, etc). To use this, you must first select 'Media_Keys' in the expansions above. | TweetMediaFieldsFilter | No |
+| place_fields | Select what location information you want to see (country, coordinates, etc). To use this, you must first select 'Place_ID' in the expansions above. | TweetPlaceFieldsFilter | No |
+| poll_fields | Select what poll information you want to see (options, voting status, etc). To use this, you must first select 'Poll_IDs' in the expansions above. | TweetPollFieldsFilter | No |
+| tweet_fields | Select what tweet information you want to see. For referenced tweets (like retweets), select 'Referenced_Tweet_ID' in the expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see. To use this, you must first select one of these in expansions above: - 'Author_User_ID' for tweet authors - 'Mentioned_Usernames' for mentioned users - 'Reply_To_User_ID' for users being replied to - 'Referenced_Tweet_Author_ID' for authors of referenced tweets | TweetUserFieldsFilter | No |
+| tweet_id | Unique identifier of the Tweet to request (ex: 1460323737035677698) | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| id | Tweet ID | str |
+| text | Tweet text | str |
+| userId | ID of the tweet author | str |
+| userName | Username of the tweet author | str |
+| data | Tweet data | Dict[str, Any] |
+| included | Additional data that you have requested (Optional) via Expansions field | Dict[str, Any] |
+| meta | Metadata about the tweet | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Content Verification**: Retrieve a specific tweet to verify its content, author, or current engagement metrics.
+
+**Thread Analysis**: Look up individual tweets in a thread to analyze specific parts of a conversation.
+
+**Link Processing**: Fetch tweet details when processing shared Twitter links in your workflows.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Get Tweets
+
+### What it is
+This block retrieves information about multiple Tweets.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve detailed information about multiple tweets in a single request. Accepts up to 100 tweet IDs and returns comprehensive data for all of them efficiently.
+
+The block uses Tweepy with OAuth 2.0 authentication and supports extensive expansions to include additional data like media, author profiles, and referenced tweets. Returns arrays of tweet IDs, text content, author information, and complete tweet data objects.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with your tweets. For example: - Select 'Media_Keys' to get media details - Select 'Author_User_ID' to get user information - Select 'Place_ID' to get location details | ExpansionFilter | No |
+| media_fields | Select what media information you want to see (images, videos, etc). To use this, you must first select 'Media_Keys' in the expansions above. | TweetMediaFieldsFilter | No |
+| place_fields | Select what location information you want to see (country, coordinates, etc). To use this, you must first select 'Place_ID' in the expansions above. | TweetPlaceFieldsFilter | No |
+| poll_fields | Select what poll information you want to see (options, voting status, etc). To use this, you must first select 'Poll_IDs' in the expansions above. | TweetPollFieldsFilter | No |
+| tweet_fields | Select what tweet information you want to see. For referenced tweets (like retweets), select 'Referenced_Tweet_ID' in the expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see. To use this, you must first select one of these in expansions above: - 'Author_User_ID' for tweet authors - 'Mentioned_Usernames' for mentioned users - 'Reply_To_User_ID' for users being replied to - 'Referenced_Tweet_Author_ID' for authors of referenced tweets | TweetUserFieldsFilter | No |
+| tweet_ids | List of Tweet IDs to request (up to 100) | List[str] | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| ids | All Tweet IDs | List[str] |
+| texts | All Tweet texts | List[str] |
+| userIds | List of user ids that authored the tweets | List[str] |
+| userNames | List of user names that authored the tweets | List[str] |
+| data | Complete Tweet data | List[Dict[str, Any]] |
+| included | Additional data that you have requested (Optional) via Expansions field | Dict[str, Any] |
+| meta | Metadata about the tweets | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Batch Processing**: Efficiently retrieve data for multiple tweets at once, such as all tweets in a thread.
+
+**Content Analysis**: Analyze multiple tweets for sentiment, engagement patterns, or content classification.
+
+**Report Generation**: Gather data on multiple tweets for creating engagement reports or content audits.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/content/platform/blocks/twitter/twitter.md b/docs/integrations/twitter/twitter.md
similarity index 100%
rename from docs/content/platform/blocks/twitter/twitter.md
rename to docs/integrations/twitter/twitter.md
diff --git a/docs/integrations/twitter/user_lookup.md b/docs/integrations/twitter/user_lookup.md
new file mode 100644
index 0000000000..5826e73727
--- /dev/null
+++ b/docs/integrations/twitter/user_lookup.md
@@ -0,0 +1,90 @@
+# Twitter User Lookup
+<!-- MANUAL: file_description -->
+Blocks for looking up Twitter/X user profiles and information.
+<!-- END MANUAL -->
+
+## Twitter Get User
+
+### What it is
+This block retrieves information about a specified Twitter user.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve detailed information about a single user. You can look up users either by their unique Twitter ID or by their username (handle). The block uses Tweepy with OAuth 2.0 authentication.
+
+Optional expansions allow you to include additional data such as the user's pinned tweet. The response includes profile information like display name, bio, follower count, and profile image URL based on the user_fields selected.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with user data. Currently only 'pinned_tweet_id' is available to see a user's pinned tweet. | UserExpansionsFilter | No |
+| tweet_fields | Select what tweet information you want to see in pinned tweets. This only works if you select 'pinned_tweet_id' in expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see, like username, bio, profile picture, etc. | TweetUserFieldsFilter | No |
+| identifier | Choose whether to identify the user by their unique Twitter ID or by their username | Identifier | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| id | User ID | str |
+| username_ | User username | str |
+| name_ | User name | str |
+| data | Complete user data | Dict[str, Any] |
+| included | Additional data requested via expansions | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Profile Verification**: Look up a user's profile to verify their identity or check their account details before engaging.
+
+**User Research**: Gather information about a specific account for competitive analysis or influencer research.
+
+**Account Validation**: Verify that a username or user ID exists and is active before performing other operations.
+<!-- END MANUAL -->
+
+---
+
+## Twitter Get Users
+
+### What it is
+This block retrieves information about multiple Twitter users.
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries the Twitter API v2 to retrieve detailed information about multiple users in a single request. You can look up users by their Twitter IDs or usernames (handles), making it efficient for batch operations.
+
+The block uses Tweepy with OAuth 2.0 authentication and supports expansions for additional data like pinned tweets. Returns arrays of user IDs, usernames, display names, and complete user data objects.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| expansions | Choose what extra information you want to get with user data. Currently only 'pinned_tweet_id' is available to see a user's pinned tweet. | UserExpansionsFilter | No |
+| tweet_fields | Select what tweet information you want to see in pinned tweets. This only works if you select 'pinned_tweet_id' in expansions above. | TweetFieldsFilter | No |
+| user_fields | Select what user information you want to see, like username, bio, profile picture, etc. | TweetUserFieldsFilter | No |
+| identifier | Choose whether to identify users by their unique Twitter IDs or by their usernames | Identifier | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| ids | User IDs | List[str] |
+| usernames_ | User usernames | List[str] |
+| names_ | User names | List[str] |
+| data | Complete users data | List[Dict[str, Any]] |
+| included | Additional data requested via expansions | Dict[str, Any] |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Batch Profile Lookup**: Retrieve profile information for a list of users at once, such as all participants in a conversation.
+
+**Influencer Analysis**: Gather profile data for multiple influencers in a specific niche for comparison.
+
+**Follow List Enrichment**: Get detailed information about accounts in your following or followers list.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/integrations/wolfram/llm_api.md b/docs/integrations/wolfram/llm_api.md
new file mode 100644
index 0000000000..2771268db9
--- /dev/null
+++ b/docs/integrations/wolfram/llm_api.md
@@ -0,0 +1,40 @@
+# Wolfram LLM API
+<!-- MANUAL: file_description -->
+Blocks for querying Wolfram Alpha's computational knowledge engine.
+<!-- END MANUAL -->
+
+## Ask Wolfram
+
+### What it is
+Ask Wolfram Alpha a question
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block queries Wolfram Alpha's LLM API with a natural language question and returns a computed answer. It leverages Wolfram's computational knowledge engine for math, science, geography, and factual queries.
+
+The answer is returned as a string suitable for display or further processing in your workflow.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| question | The question to ask | str | Yes |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the operation failed | str |
+| answer | The answer to the question | str |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**Factual Queries**: Get accurate answers to math, science, or geography questions.
+
+**Calculations**: Perform complex mathematical or unit conversion calculations.
+
+**Data Lookups**: Retrieve factual data like population statistics, chemical properties, or historical dates.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/content/platform/blocks/youtube.md b/docs/integrations/youtube.md
similarity index 100%
rename from docs/content/platform/blocks/youtube.md
rename to docs/integrations/youtube.md
diff --git a/docs/integrations/zerobounce/validate_emails.md b/docs/integrations/zerobounce/validate_emails.md
new file mode 100644
index 0000000000..ba99216373
--- /dev/null
+++ b/docs/integrations/zerobounce/validate_emails.md
@@ -0,0 +1,41 @@
+# Zerobounce Validate Emails
+<!-- MANUAL: file_description -->
+Blocks for validating email deliverability using ZeroBounce.
+<!-- END MANUAL -->
+
+## Validate Emails
+
+### What it is
+Validate emails
+
+### How it works
+<!-- MANUAL: how_it_works -->
+This block uses the ZeroBounce API to validate email addresses for deliverability. It checks if an email is valid, invalid, catch-all, spamtrap, abuse, or disposable. Optionally provide an IP address for additional validation context.
+
+The response includes detailed status information, SMTP provider, and recommendation on whether to send emails to that address.
+<!-- END MANUAL -->
+
+### Inputs
+
+| Input | Description | Type | Required |
+|-------|-------------|------|----------|
+| email | Email to validate | str | Yes |
+| ip_address | IP address to validate | str | No |
+
+### Outputs
+
+| Output | Description | Type |
+|--------|-------------|------|
+| error | Error message if the search failed | str |
+| response | Response from ZeroBounce | Response |
+
+### Possible use case
+<!-- MANUAL: use_case -->
+**List Cleaning**: Validate email lists before campaigns to reduce bounce rates.
+
+**Lead Qualification**: Verify lead email addresses as part of intake workflows.
+
+**Form Validation**: Check email validity in real-time during user registration or contact form submissions.
+<!-- END MANUAL -->
+
+---
diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml
deleted file mode 100644
index 876467633e..0000000000
--- a/docs/mkdocs.yml
+++ /dev/null
@@ -1,194 +0,0 @@
-site_name: AutoGPT Documentation
-site_url: https://docs.agpt.co/
-repo_url: https://github.com/Significant-Gravitas/AutoGPT
-repo_name: AutoGPT
-edit_uri: edit/master/docs/content
-docs_dir: content
-nav:
-  - Home: index.md
-
-  - The AutoGPT Platform 🆕:
-    - Getting Started:
-        - Setup AutoGPT (Local-Host): platform/getting-started.md
-        - Edit an Agent: platform/edit-agent.md
-        - Delete an Agent: platform/delete-agent.md
-        - Download & Import and Agent: platform/download-agent-from-marketplace-local.md
-        - Create a Basic Agent: platform/create-basic-agent.md
-        - Submit an Agent to the Marketplace: platform/submit-agent-to-marketplace.md
-    - Advanced Setup: platform/advanced_setup.md
-    - Agent Blocks: platform/agent-blocks.md
-    - Build your own Blocks: platform/new_blocks.md
-    - Block SDK Guide: platform/block-sdk-guide.md
-    - Using Ollama: platform/ollama.md
-    - Using AI/ML API: platform/aimlapi.md
-    - Using D-ID: platform/d_id.md
-    - Blocks: platform/blocks/blocks.md
-    - API:
-      - Introduction: platform/integrating/api-guide.md
-      - OAuth & SSO: platform/integrating/oauth-guide.md
-    - Contributing:
-        - Tests: platform/contributing/tests.md
-        - OAuth Flows: platform/contributing/oauth-integration-flow.md
-  - AutoGPT Classic:
-      - Introduction: classic/index.md
-      - Setup:
-          - Setting up AutoGPT: classic/setup/index.md
-          - Set up with Docker: classic/setup/docker.md
-          - For Developers: classic/setup/for-developers.md
-          - Configuration:
-              - Options: classic/configuration/options.md
-              - Search: classic/configuration/search.md
-              - Voice: classic/configuration/voice.md
-      - Usage: classic/usage.md
-      - Help us improve AutoGPT:
-          - Share your debug logs with us: classic/share-your-logs.md
-          - Contribution guide: contributing.md
-          - Running tests: classic/testing.md
-          - Code of Conduct: code-of-conduct.md
-      - Benchmark:
-          - Readme: https://github.com/Significant-Gravitas/AutoGPT/blob/master/classic/benchmark/README.md
-      - Forge:
-         - Introduction: forge/get-started.md
-         - Components:
-             - Introduction: forge/components/introduction.md
-             - Agents: forge/components/agents.md
-             - Components: forge/components/components.md
-             - Protocols: forge/components/protocols.md
-             - Commands: forge/components/commands.md
-             - Built in Components: forge/components/built-in-components.md
-             - Creating Components: forge/components/creating-components.md
-      - Frontend:
-         - Readme: https://github.com/Significant-Gravitas/AutoGPT/blob/master/classic/frontend/README.md
-
-  - Contribute: 
-        - Introduction: contribute/index.md
-        - Testing: ../../autogpt_platform/backend/TESTING.md
-    
-  # - Challenges:
-  #     - Introduction: challenges/introduction.md
-  #     - List of Challenges:
-  #         - Memory:
-  #             - Introduction: challenges/memory/introduction.md
-  #             - Memory Challenge A: challenges/memory/challenge_a.md
-  #             - Memory Challenge B: challenges/memory/challenge_b.md
-  #             - Memory Challenge C: challenges/memory/challenge_c.md
-  #             - Memory Challenge D: challenges/memory/challenge_d.md
-  #         - Information retrieval:
-  #             - Introduction: challenges/information_retrieval/introduction.md
-  #             - Information Retrieval Challenge A: challenges/information_retrieval/challenge_a.md
-  #             - Information Retrieval Challenge B: challenges/information_retrieval/challenge_b.md
-  # - Submit a Challenge: challenges/submit.md
-  # - Beat a Challenge: challenges/beat.md
-
-  - License: https://github.com/Significant-Gravitas/AutoGPT/blob/master/LICENSE
-
-theme:
-  name: material
-  custom_dir: overrides
-  language: en
-  icon:
-    repo: fontawesome/brands/github
-    logo: material/book-open-variant
-    edit: material/pencil
-    view: material/eye
-  favicon: assets/favicon.png
-  features:
-    - navigation.sections
-    - navigation.footer
-    - navigation.top
-    - navigation.tracking
-    - navigation.tabs
-    # - navigation.path
-    - toc.follow
-    - toc.integrate
-    - content.action.edit
-    - content.action.view
-    - content.code.copy
-    - content.code.annotate
-    - content.tabs.link
-  palette:
-    # Palette toggle for light mode
-    - media: "(prefers-color-scheme: light)"
-      scheme: default
-      toggle:
-        icon: material/weather-night
-        name: Switch to dark mode
-
-    # Palette toggle for dark mode
-    - media: "(prefers-color-scheme: dark)"
-      scheme: slate
-      toggle:
-        icon: material/weather-sunny
-        name: Switch to light mode
-
-markdown_extensions:
-  # Python Markdown
-  - abbr
-  - admonition
-  - attr_list
-  - def_list
-  - footnotes
-  - md_in_html
-  - toc:
-      permalink: true
-  - tables
-
-  # Python Markdown Extensions
-  - pymdownx.arithmatex:
-      generic: true
-  - pymdownx.betterem:
-      smart_enable: all
-  - pymdownx.critic
-  - pymdownx.caret
-  - pymdownx.details
-  - pymdownx.emoji:
-      emoji_index: !!python/name:material.extensions.emoji.twemoji
-      emoji_generator: !!python/name:material.extensions.emoji.to_svg
-  - pymdownx.highlight
-  - pymdownx.inlinehilite
-  - pymdownx.keys
-  - pymdownx.mark
-  - pymdownx.smartsymbols
-  - pymdownx.snippets:
-      base_path: ['.','../']
-      check_paths: true
-      dedent_subsections: true
-  - pymdownx.superfences:
-      custom_fences:
-        - name: mermaid
-          class: mermaid
-          format: !!python/name:pymdownx.superfences.fence_code_format
-  - pymdownx.tabbed:
-      alternate_style: true
-  - pymdownx.tasklist:
-      custom_checkbox: true
-  - pymdownx.tilde
-
-plugins:
-  - table-reader
-  - search
-  - git-revision-date-localized:
-      enable_creation_date: true
-
-extra:
-  social:
-    - icon: fontawesome/brands/github
-      link: https://github.com/Significant-Gravitas/AutoGPT
-    - icon: fontawesome/brands/x-twitter
-      link: https://x.com/Auto_GPT
-    - icon: fontawesome/brands/instagram
-      link: https://www.instagram.com/autogpt/
-    - icon: fontawesome/brands/discord
-      link: https://discord.gg/autogpt
-      
-extra:
-  analytics:
-    provider: google
-    property: G-XKPNKB9XG6
-
-extra_javascript:
-  - https://unpkg.com/tablesort@5.3.0/dist/tablesort.min.js
-  - _javascript/tablesort.js
-  - _javascript/mathjax.js
-  - https://cdnjs.cloudflare.com/polyfill/v3/polyfill.min.js?features=es6
-  - https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js
diff --git a/docs/netlify.toml b/docs/netlify.toml
deleted file mode 100644
index c07b733a57..0000000000
--- a/docs/netlify.toml
+++ /dev/null
@@ -1,5 +0,0 @@
-# Netlify config for AutoGPT docs
-
-[build]
-  publish = "public/"
-  command = "mkdocs build -d public"
diff --git a/docs/overrides/assets/favicon.png b/docs/overrides/assets/favicon.png
deleted file mode 100644
index 69bded6abf..0000000000
Binary files a/docs/overrides/assets/favicon.png and /dev/null differ
diff --git a/docs/overrides/main.html b/docs/overrides/main.html
deleted file mode 100644
index b376724b8b..0000000000
--- a/docs/overrides/main.html
+++ /dev/null
@@ -1,61 +0,0 @@
-{% extends "base.html" %}
-
-
-{% block extrahead %}
-<style>
-  svg.ms-w-12 {
-    width: 2rem !important;
-  }
-  svg.ms-h-12 {
-    height: 2rem !important;
-  }
-  /* Temporary solution for the font sizes  */
-  #headlessui-dialog-panel-2 p{
-    font-size: 16px;
-  }
-  #headlessui-dialog-panel-2 textarea{
-    font-size: 16px;
-  }
-  #headlessui-dialog-panel-2 span{
-    font-size: 14px;
-
-  }
-  #headlessui-dialog-panel-2 div{
-    font-size: 16px;
-  }
-  #headlessui-dialog-panel-2 a{
-    font-size: 14px;
-    line-height: 1rem;
-  }
-  #headlessui-dialog-panel-2 button{
-    border: 1px solid #0000001d;
-    line-height: 1rem;
-
-}
-  /* Temporary solution for the font size  */
-  #headlessui-dialog-panel-2 > div > div > div > div.ms-w-full.ms-rounded-xl.ms-flex.ms-flex-col.ms-relative > div > div > div > div > div.ms-flex.ms-flex-row.ms-items-center.ms-justify-between.ms-gap-1 > p{
-    font-size: 14px;
-    line-height: 1rem;
-  }
-
-</style>
-
-<div id="my-component-root" class="mendable-search"></div>
-
-<script src="https://unpkg.com/@mendable/search@0.0.155/dist/umd/mendable-bundle.min.js"></script>
-{% raw %}
-<script>
-    Mendable.initialize({
-      anon_key: 'a0bd44db-eb3b-412f-8924-b31c58244a64',
-      type: 'floatingButton',
-      style : { accentColor: '#3F51B5', darkMode: false },
-      floatingButtonStyle:{
-        backgroundColor: '#3F51B5',
-        color: '#fff',
-      },
-      icon: "https://mendable-storage.s3.amazonaws.com/autoGPT.gif",
-      botIcon: "https://mendable-storage.s3.amazonaws.com/autoGPTbot.gif",
-    })
-  </script>
-{% endraw %}
-{% endblock %}
\ No newline at end of file
diff --git a/docs/platform/SUMMARY.md b/docs/platform/SUMMARY.md
new file mode 100644
index 0000000000..b71f6dc929
--- /dev/null
+++ b/docs/platform/SUMMARY.md
@@ -0,0 +1,34 @@
+# Table of contents
+
+* [What is the AutoGPT Platform?](what-is-autogpt-platform.md)
+
+## Getting Started
+
+* [Setting Up Auto-GPT (Local Host)](getting-started.md)
+* [AutoGPT Platform Installer](installer.md)
+* [Edit an Agent](edit-agent.md)
+* [Delete an Agent](delete-agent.md)
+* [Download & Import an Agent](download-agent-from-marketplace-local.md)
+* [Create a Basic Agent](create-basic-agent.md)
+* [Submit an Agent to the Marketplace](submit-agent-to-marketplace.md)
+
+## Advanced Setup
+
+* [Advanced Setup](advanced_setup.md)
+
+## Building Blocks
+
+* [Agent Blocks Overview](agent-blocks.md)
+* [Build your own Blocks](new_blocks.md)
+* [Block SDK Guide](block-sdk-guide.md)
+
+## Using AI Services
+
+* [Using Ollama](ollama.md)
+* [Using AI/ML API](aimlapi.md)
+* [Using D-ID](d_id.md)
+
+## API & Integrations
+
+* [API Introduction](integrating/api-guide.md)
+* [OAuth & SSO](integrating/oauth-guide.md)
diff --git a/docs/content/platform/advanced_setup.md b/docs/platform/advanced_setup.md
similarity index 100%
rename from docs/content/platform/advanced_setup.md
rename to docs/platform/advanced_setup.md
diff --git a/docs/content/platform/agent-blocks.md b/docs/platform/agent-blocks.md
similarity index 100%
rename from docs/content/platform/agent-blocks.md
rename to docs/platform/agent-blocks.md
diff --git a/docs/content/platform/aimlapi.md b/docs/platform/aimlapi.md
similarity index 100%
rename from docs/content/platform/aimlapi.md
rename to docs/platform/aimlapi.md
diff --git a/docs/content/platform/block-sdk-guide.md b/docs/platform/block-sdk-guide.md
similarity index 96%
rename from docs/content/platform/block-sdk-guide.md
rename to docs/platform/block-sdk-guide.md
index 1f8fc545e9..5b3eda5184 100644
--- a/docs/content/platform/block-sdk-guide.md
+++ b/docs/platform/block-sdk-guide.md
@@ -227,7 +227,7 @@ backend/blocks/my_provider/
 
 ## Best Practices
 
-1. **Error Handling**: Error output pin is already defined on BlockSchemaOutput
+1. **Error Handling**: Use `BlockInputError` for validation failures and `BlockExecutionError` for runtime errors (import from `backend.util.exceptions`). These inherit from `ValueError` so the executor treats them as user-fixable. See [Error Handling in new_blocks.md](new_blocks.md#error-handling) for details.
 2. **Credentials**: Use the provider's `credentials_field()` method
 3. **Validation**: Use SchemaField constraints (ge, le, min_length, etc.)
 4. **Categories**: Choose appropriate categories for discoverability
diff --git a/docs/content/platform/contributing/oauth-integration-flow.md b/docs/platform/contributing/oauth-integration-flow.md
similarity index 100%
rename from docs/content/platform/contributing/oauth-integration-flow.md
rename to docs/platform/contributing/oauth-integration-flow.md
diff --git a/docs/content/platform/contributing/tests.md b/docs/platform/contributing/tests.md
similarity index 100%
rename from docs/content/platform/contributing/tests.md
rename to docs/platform/contributing/tests.md
diff --git a/docs/content/platform/create-basic-agent.md b/docs/platform/create-basic-agent.md
similarity index 100%
rename from docs/content/platform/create-basic-agent.md
rename to docs/platform/create-basic-agent.md
diff --git a/docs/content/platform/d_id.md b/docs/platform/d_id.md
similarity index 100%
rename from docs/content/platform/d_id.md
rename to docs/platform/d_id.md
diff --git a/docs/content/platform/delete-agent.md b/docs/platform/delete-agent.md
similarity index 100%
rename from docs/content/platform/delete-agent.md
rename to docs/platform/delete-agent.md
diff --git a/docs/content/platform/download-agent-from-marketplace-local.md b/docs/platform/download-agent-from-marketplace-local.md
similarity index 100%
rename from docs/content/platform/download-agent-from-marketplace-local.md
rename to docs/platform/download-agent-from-marketplace-local.md
diff --git a/docs/content/platform/edit-agent.md b/docs/platform/edit-agent.md
similarity index 100%
rename from docs/content/platform/edit-agent.md
rename to docs/platform/edit-agent.md
diff --git a/docs/content/platform/getting-started.md b/docs/platform/getting-started.md
similarity index 100%
rename from docs/content/platform/getting-started.md
rename to docs/platform/getting-started.md
diff --git a/docs/content/platform/installer.md b/docs/platform/installer.md
similarity index 100%
rename from docs/content/platform/installer.md
rename to docs/platform/installer.md
diff --git a/docs/content/platform/integrating/api-guide.md b/docs/platform/integrating/api-guide.md
similarity index 100%
rename from docs/content/platform/integrating/api-guide.md
rename to docs/platform/integrating/api-guide.md
diff --git a/docs/content/platform/integrating/oauth-guide.md b/docs/platform/integrating/oauth-guide.md
similarity index 100%
rename from docs/content/platform/integrating/oauth-guide.md
rename to docs/platform/integrating/oauth-guide.md
diff --git a/docs/content/platform/new_blocks.md b/docs/platform/new_blocks.md
similarity index 93%
rename from docs/content/platform/new_blocks.md
rename to docs/platform/new_blocks.md
index 8e6324b937..d9d329ff51 100644
--- a/docs/content/platform/new_blocks.md
+++ b/docs/platform/new_blocks.md
@@ -616,7 +616,59 @@ custom_requests = Requests(
 
 ### Error Handling
 
-All blocks should have an error output that catches all reasonable errors that a user can handle, wrap them in a ValueError, and re-raise. Don't catch things the system admin would need to fix like being out of money or unreachable addresses.  
+Blocks should raise appropriate exceptions for errors that users can fix. The executor classifies errors based on whether they inherit from `ValueError` - these are treated as "expected failures" (user-fixable) rather than system errors.
+
+#### Block Exception Classes
+
+Import from `backend.util.exceptions`:
+
+```python
+from backend.util.exceptions import BlockInputError, BlockExecutionError
+```
+
+| Exception | Use Case | Example |
+|-----------|----------|---------|
+| `BlockInputError` | Invalid user input, validation failures, missing required fields | Bad API key format, invalid URL, missing credentials |
+| `BlockExecutionError` | Runtime failures the user can address | API errors, auth failures, resource not found, rate limits |
+| `ValueError` | Simple cases (auto-wrapped to `BlockExecutionError`) | Basic validation errors |
+
+#### Raising Exceptions
+
+```python
+from backend.util.exceptions import BlockInputError, BlockExecutionError
+
+class MyBlock(Block):
+    async def run(self, input_data: Input, **kwargs) -> BlockOutput:
+        # Input validation - use BlockInputError
+        if not input_data.api_key:
+            raise BlockInputError(
+                message="API key is required",
+                block_name=self.name,
+                block_id=self.id,
+            )
+
+        try:
+            result = await self.call_api(input_data)
+            yield "result", result
+        except AuthenticationError as e:
+            # API/runtime errors - use BlockExecutionError
+            raise BlockExecutionError(
+                message=f"Authentication failed: {e}",
+                block_name=self.name,
+                block_id=self.id,
+            ) from e
+```
+
+#### What NOT to Catch
+
+Don't catch errors that require system admin intervention:
+
+- Out of money/credits
+- Unreachable infrastructure
+- Database connection failures
+- Internal server errors from your own services
+
+Let these propagate as unexpected errors so they get proper attention.  
 
 ### Data Models
 
diff --git a/docs/content/platform/ollama.md b/docs/platform/ollama.md
similarity index 100%
rename from docs/content/platform/ollama.md
rename to docs/platform/ollama.md
diff --git a/docs/content/platform/submit-agent-to-marketplace.md b/docs/platform/submit-agent-to-marketplace.md
similarity index 100%
rename from docs/content/platform/submit-agent-to-marketplace.md
rename to docs/platform/submit-agent-to-marketplace.md
diff --git a/docs/platform/what-is-autogpt-platform.md b/docs/platform/what-is-autogpt-platform.md
new file mode 100644
index 0000000000..b0d1ff0f74
--- /dev/null
+++ b/docs/platform/what-is-autogpt-platform.md
@@ -0,0 +1,82 @@
+# What is the AutoGPT Platform?
+
+The AutoGPT Platform is a groundbreaking system that revolutionizes AI utilization for businesses and individuals. It enables the creation, deployment, and management of continuous agents that work tirelessly on your behalf, bringing unprecedented efficiency and innovation to your workflows.
+
+## Key Features
+
+* **Seamless Integration and Low-Code Workflows**: Rapidly create complex workflows without extensive coding knowledge.
+* **Autonomous Operation and Continuous Agents**: Deploy cloud-based assistants that run indefinitely, activating on relevant triggers.
+* **Intelligent Automation and Maximum Efficiency**: Streamline workflows by automating repetitive processes.
+* **Reliable Performance and Predictable Execution**: Enjoy consistent and dependable long-running processes.
+
+## Platform Architecture
+
+The AutoGPT Platform consists of two main components:
+
+### 1. AutoGPT Server
+
+The powerhouse of our platform, containing:
+
+* **Source Code**: Core logic driving agents and automation processes.
+* **Infrastructure**: Robust systems ensuring reliable and scalable performance.
+* **Marketplace**: A comprehensive marketplace for pre-built agents.
+
+### 2. AutoGPT Frontend
+
+The user interface where you interact with the platform:
+
+* **Agent Builder**: Design and configure your own AI agents.
+* **Workflow Management**: Build, modify, and optimize automation workflows.
+* **Deployment Controls**: Manage the lifecycle of your agents.
+* **Ready-to-Use Agents**: Select from pre-configured agents.
+* **Agent Interaction**: Run and interact with agents through a user-friendly interface.
+* **Monitoring and Analytics**: Track agent performance and gain insights.
+
+## Platform Components
+
+### Agents and Workflows
+
+In the platform, you can create highly customized workflows to build agents. An agent is essentially an automated workflow that you design to perform specific tasks or processes. Create customized workflows to build agents for various tasks, including:
+
+* Data processing and analysis
+* Task scheduling and management
+* Communication and notification systems
+* Integration between different software tools
+* AI-powered decision making and content generation
+
+### Blocks as Integrations
+
+Blocks represent actions and are the building blocks of your workflows, including:
+
+* Connections to external services
+* Data processing tools
+* AI models for various tasks
+* Custom scripts or functions
+* Conditional logic and decision-making components
+
+You can learn more under: [Build your own Blocks](new_blocks.md)
+
+## Available Language Models
+
+The platform comes pre-integrated with cutting-edge LLM providers:
+
+* OpenAI - <https://openai.com/>
+* Anthropic - <https://www.anthropic.com/>
+* Groq - <https://groq.com/>
+* Llama - <https://llamaindex.ai/>
+* AI/ML API - <https://aimlapi.com/>
+  * AI/ML API provides 300+ AI models including Deepseek, Gemini, ChatGPT. The models run at enterprise-grade rate limits and uptimes.
+
+## License Overview
+
+We've adopted a dual-license approach to balance open collaboration with sustainable development:
+
+* **MIT License**: The majority of the AutoGPT repository remains under this license.
+* **Polyform Shield License**: Applies to the new `autogpt_platform` folder.
+
+This strategy allows us to share previously closed-source components, fostering a vibrant ecosystem of developers and users.
+
+## Ready to Get Started?
+
+* Read the [Getting Started docs](getting-started.md) to self-host.
+* [Join the waitlist](https://agpt.co/waitlist) for the cloud-hosted beta.
diff --git a/docs/requirements.txt b/docs/requirements.txt
deleted file mode 100644
index ea0eab8c2a..0000000000
--- a/docs/requirements.txt
+++ /dev/null
@@ -1,8 +0,0 @@
-mkdocs
-mkdocs-material
-mkdocs-table-reader-plugin
-pymdown-extensions
-mkdocs-git-revision-date-localized-plugin
-zipp>=3.19.1 # not directly required, pinned by Snyk to avoid a vulnerability
-urllib3>=2.2.2 # not directly required, pinned by Snyk to avoid a vulnerability
-requests>=2.32.4 # not directly required, pinned by Snyk to avoid a vulnerability