Merge branch 'dev' into hackathon-copilot-backend

## Changes 🏗️

- Added a new `MultiSelectField` component for handling multiple boolean
selections in a dropdown format
- Implemented `useMultiSelectField` hook to manage the state and logic
of the multi-select component
- Added support for custom fields in `AnyOfField` by checking if the
option schema matches a custom field
- Added `isMultiSelectSchema` utility function to detect schemas
suitable for the multi-select component
- Added hover cursor styling to node headers to indicate text
editability

![Screenshot 2026-01-10 at
11.15.12 AM.png](https://app.graphite.com/user-attachments/assets/8254497b-604f-4ccc-a40b-eb8994c073b4.png)

### Checklist 📋

#### For code changes:
- [x] I have clearly listed my changes in the PR description
- [x] I have made a test plan
- [x] I have tested my changes according to the test plan:
  - [x] Verified that multi-select fields render correctly in the UI
  - [x] Confirmed that selecting multiple options works as expected
  - [x] Tested that the node header shows the text cursor on hover
- [x] Verified that AnyOf fields correctly use custom field renderers
when applicable

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Added a multi-select field allowing selection of multiple options with
improved selection UI.
* AnyOf options can now resolve and render custom field types, improving
form composition when schemas map to custom controls.

* **Style**
  * Tooltip header cursor updated for clearer hover feedback.

<sub>✏️ Tip: You can customize this high-level summary in your review
settings.</sub>
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

.github/workflows/docs-block-sync.yml

@@ -1,74 +0,0 @@
-name: Block Documentation Sync Check
-
-on:
-  push:
-    branches: [master, dev]
-    paths:
-      - "autogpt_platform/backend/backend/blocks/**"
-      - "docs/content/platform/blocks/**"
-      - "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/content/platform/blocks/**"
-      - "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()
-        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 "Changes detected:"
-          git diff docs/content/platform/blocks/ || true

.github/workflows/docs-claude-review.yml

@@ -1,94 +0,0 @@
-name: Claude Block Docs Review
-
-on:
-  pull_request:
-    types: [opened, synchronize]
-    paths:
-      - "docs/content/platform/blocks/**"
-      - "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
-
-    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:
-          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
-          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.

.github/workflows/docs-enhance.yml

@@ -1,193 +0,0 @@
-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
-
-    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:
-          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
-          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/content/platform/blocks/`
-               Pattern: ${{ inputs.block_pattern }}
-
-               Use: `find docs/content/platform/blocks -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/content/platform/blocks/; 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/content/platform/blocks/
-          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

autogpt_platform/Makefile

@@ -6,9 +6,10 @@ 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
@@ -60,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"
+	@echo "  load-store-agents - Load store agents from agents/ folder into test database"

autogpt_platform/backend/backend/api/features/chat/config.py

@@ -12,7 +12,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(
@@ -72,8 +76,31 @@ class ChatConfig(BaseSettings):
                 v = "https://openrouter.ai/api/v1"
         return v
 
+    # Prompt paths for different contexts
+    PROMPT_PATHS: dict[str, str] = {
+        "default": "prompts/chat_system.md",
+        "onboarding": "prompts/onboarding_system.md",
+    }
+
+    def get_system_prompt_for_type(
+        self, prompt_type: str = "default", **template_vars
+    ) -> str:
+        """Load and render a system prompt by type.
+
+        Args:
+            prompt_type: The type of prompt to load ("default" or "onboarding")
+            **template_vars: Variables to substitute in the template
+
+        Returns:
+            Rendered system prompt string
+        """
+        prompt_path_str = self.PROMPT_PATHS.get(
+            prompt_type, self.PROMPT_PATHS["default"]
+        )
+        return self._load_prompt_from_path(prompt_path_str, **template_vars)
+
     def get_system_prompt(self, **template_vars) -> str:
-        """Load and render the system prompt from file.
+        """Load and render the default system prompt from file.
 
         Args:
             **template_vars: Variables to substitute in the template
@@ -82,9 +109,21 @@ class ChatConfig(BaseSettings):
             Rendered system prompt string
 
         """
+        return self._load_prompt_from_path(self.system_prompt_path, **template_vars)
+
+    def _load_prompt_from_path(self, prompt_path_str: str, **template_vars) -> str:
+        """Load and render a system prompt from a given path.
+
+        Args:
+            prompt_path_str: Path to the prompt file relative to chat module
+            **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
+        prompt_path = module_dir / prompt_path_str
 
         # Check for .j2 extension first (Jinja2 template)
         j2_path = Path(str(prompt_path) + ".j2")

autogpt_platform/backend/backend/api/features/chat/db.py

@@ -0,0 +1,215 @@
+"""Database operations for chat sessions."""
+
+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,
+)
+
+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 since Prisma doesn't support order_by in include
+        session.Messages.sort(key=lambda m: m.sequence)
+    return session
+
+
+async def create_chat_session(
+    session_id: str,
+    user_id: str | None,
+) -> 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:
+        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 the input dict dynamically - only include optional fields when they
+    # have values, as Prisma TypedDict validation fails when optional fields
+    # are explicitly set to None
+    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)
+
+    # Update session's updatedAt timestamp
+    await PrismaChatSession.prisma().update(
+        where={"id": session_id},
+        data={"updatedAt": datetime.now(UTC)},
+    )
+
+    return await PrismaChatMessage.prisma().create(
+        data=cast(ChatMessageCreateInput, data)
+    )
+
+
+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."""
+    if not messages:
+        return []
+
+    created_messages = []
+    for i, msg in enumerate(messages):
+        # Build the input dict dynamically - only include optional JSON fields
+        # when they have values, as Prisma TypedDict validation fails when
+        # optional fields are explicitly set to None
+        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().create(
+            data=cast(ChatMessageCreateInput, data)
+        )
+        created_messages.append(created)
+
+    # Update session's updatedAt timestamp
+    await PrismaChatSession.prisma().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) -> bool:
+    """Delete a chat session and all its messages."""
+    try:
+        await PrismaChatSession.prisma().delete(where={"id": session_id})
+        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

autogpt_platform/backend/backend/api/features/chat/model.py

@@ -16,11 +16,15 @@ 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 import json
 from backend.util.exceptions import RedisError
 
+from . import db as chat_db
 from .config import ChatConfig
 
 logger = logging.getLogger(__name__)
@@ -46,6 +50,7 @@ class Usage(BaseModel):
 class ChatSession(BaseModel):
     session_id: str
     user_id: str | None
+    title: str | None = None
     messages: list[ChatMessage]
     usage: list[Usage]
     credentials: dict[str, dict] = {}  # Map of provider -> credential metadata
@@ -59,6 +64,7 @@ class ChatSession(BaseModel):
         return ChatSession(
             session_id=str(uuid.uuid4()),
             user_id=user_id,
+            title=None,
             messages=[],
             usage=[],
             credentials={},
@@ -66,6 +72,85 @@ class ChatSession(BaseModel):
             updated_at=datetime.now(UTC),
         )
 
+    @staticmethod
+    def from_prisma(
+        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:
+                tool_calls = None
+                if msg.toolCalls:
+                    tool_calls = (
+                        json.loads(msg.toolCalls)
+                        if isinstance(msg.toolCalls, str)
+                        else msg.toolCalls
+                    )
+
+                function_call = None
+                if msg.functionCall:
+                    function_call = (
+                        json.loads(msg.functionCall)
+                        if isinstance(msg.functionCall, str)
+                        else msg.functionCall
+                    )
+
+                messages.append(
+                    ChatMessage(
+                        role=msg.role,
+                        content=msg.content,
+                        name=msg.name,
+                        tool_call_id=msg.toolCallId,
+                        refusal=msg.refusal,
+                        tool_calls=tool_calls,
+                        function_call=function_call,
+                    )
+                )
+
+        # Parse JSON fields from Prisma
+        credentials = (
+            json.loads(prisma_session.credentials)
+            if isinstance(prisma_session.credentials, str)
+            else prisma_session.credentials or {}
+        )
+        successful_agent_runs = (
+            json.loads(prisma_session.successfulAgentRuns)
+            if isinstance(prisma_session.successfulAgentRuns, str)
+            else prisma_session.successfulAgentRuns or {}
+        )
+        successful_agent_schedules = (
+            json.loads(prisma_session.successfulAgentSchedules)
+            if isinstance(prisma_session.successfulAgentSchedules, str)
+            else prisma_session.successfulAgentSchedules or {}
+        )
+
+        # 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 +240,234 @@ 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."""
+async def _get_session_from_cache(session_id: str) -> ChatSession | None:
+    """Get a chat session from Redis cache."""
     redis_key = f"chat:session:{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
 
+
+async def _cache_session(session: ChatSession) -> None:
+    """Cache a chat session in Redis."""
+    redis_key = f"chat:session:{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_prisma(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,
+) -> 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.
+    """
+    # Try cache first
+    try:
+        session = await _get_session_from_cache(session_id)
+        if session:
+            # Verify user ownership
+            if session.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 session.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."""
-
-    redis_key = f"chat:session:{session.session_id}"
-
-    async_redis = await get_redis_async()
-    resp = await async_redis.setex(
-        redis_key, config.session_ttl, session.model_dump_json()
+    """Update a chat session in both cache and database."""
+    # Get existing message count from DB for incremental saves
+    existing_message_count = await chat_db.get_chat_session_message_count(
+        session.session_id
     )
 
-    if not resp:
+    # Save to database
+    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}")
+        # Continue to cache even if DB fails
+
+    # Save to cache
+    try:
+        await _cache_session(session)
+    except Exception as e:
         raise RedisError(
-            f"Failed to persist chat session {session.session_id} to Redis: {resp}"
-        )
+            f"Failed to persist chat session {session.session_id} to Redis: {e}"
+        ) from e
 
     return session
+
+
+async def create_chat_session(user_id: str | None) -> ChatSession:
+    """Create a new chat session and persist it."""
+    session = ChatSession.new(user_id)
+
+    # Create in database first
+    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 in database: {e}")
+        # Continue even if DB fails - cache will still work
+
+    # Cache the session
+    try:
+        await _cache_session(session)
+    except Exception as e:
+        logger.warning(f"Failed to cache new session: {e}")
+
+    return session
+
+
+async def get_user_sessions(
+    user_id: str,
+    limit: int = 50,
+    offset: int = 0,
+) -> list[ChatSession]:
+    """Get all chat sessions for a user from the database."""
+    prisma_sessions = await chat_db.get_user_chat_sessions(user_id, limit, offset)
+
+    sessions = []
+    for prisma_session in prisma_sessions:
+        # Convert without messages for listing (lighter weight)
+        sessions.append(ChatSession.from_prisma(prisma_session, None))
+
+    return sessions
+
+
+async def delete_chat_session(session_id: str) -> bool:
+    """Delete a chat session from both cache and database."""
+    # Delete from cache
+    try:
+        redis_key = f"chat:session:{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}")
+
+    # Delete from database
+    return await chat_db.delete_chat_session(session_id)

autogpt_platform/backend/backend/api/features/chat/model_test.py

@@ -68,3 +68,50 @@ async def test_chatsession_redis_storage_user_id_mismatch():
     s2 = await get_chat_session(s.session_id, None)
 
     assert s2 is None
+
+
+@pytest.mark.asyncio(loop_scope="session")
+async def test_chatsession_db_storage():
+    """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=None)
+    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)

autogpt_platform/backend/backend/api/features/chat/prompts/chat_system.md

@@ -1,12 +1,80 @@
-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.
+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, create, 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)
+**Understanding & Discovery:**
+1. **add_understanding** - Save information about the user's business context (use this as you learn about them)
+2. **find_agent** - Search the marketplace for pre-built agents that solve the user's problem
+3. **find_library_agent** - Search the user's personal library of saved agents
+4. **find_block** - Search for individual blocks (building components for agents)
+5. **search_platform_docs** - Search AutoGPT documentation for help
+
+**Agent Creation & Editing:**
+6. **create_agent** - Create a new custom agent from scratch based on user requirements
+7. **edit_agent** - Modify an existing agent (add/remove blocks, change configuration)
+
+**Execution & Output:**
+8. **run_agent** - Run or schedule an agent (automatically handles setup)
+9. **run_block** - Run a single block directly without creating an agent
+10. **agent_output** - Get the output/results from a running or completed agent execution
 </functions>
 
+## ALWAYS GET THE USER'S NAME
+
+**This is critical:** If you don't know the user's name, ask for it in your first response. Use a friendly, natural approach:
+- "Hi! I'm Otto. What's your name?"
+- "Hey there! Before we dive in, what should I call you?"
+
+Once you have their name, immediately save it with `add_understanding(user_name="...")` and use it throughout the conversation.
+
+## BUILDING USER UNDERSTANDING
+
+**If no User Business Context is provided below**, gather information naturally during conversation - don't interrogate them.
+
+**Key information to gather (in priority order):**
+1. Their name (ALWAYS first if unknown)
+2. Their job title and role
+3. Their business/company and industry
+4. Pain points and what they want to automate
+5. Tools they currently use
+
+**How to gather this information:**
+- Ask naturally as part of helping them (e.g., "What's your role?" or "What industry are you in?")
+- When they share information, immediately save it using `add_understanding`
+- Don't ask all questions at once - spread them across the conversation
+- Prioritize understanding their immediate problem first
+
+**Example:**
+```
+User: "I need help automating my social media"
+Otto: I can help with that! I'm Otto - what's your name?
+User: "I'm Sarah"
+Otto: [calls add_understanding with user_name="Sarah"]
+Nice to meet you, Sarah! What's your role - are you a social media manager or business owner?
+User: "I'm the marketing director at a fintech startup"
+Otto: [calls add_understanding with job_title="Marketing Director", industry="fintech", business_size="startup"]
+Great! Let me find social media automation agents for you.
+[calls find_agent with query="social media automation marketing"]
+```
+
+## WHEN TO USE WHICH TOOL
+
+**Finding existing agents:**
+- `find_agent` - Search the marketplace for pre-built agents others have created
+- `find_library_agent` - Search agents the user has already saved to their library
+
+**Creating/editing agents:**
+- `create_agent` - When user wants a custom agent that doesn't exist, or has specific requirements
+- `edit_agent` - When user wants to modify an existing agent (change inputs, add blocks, etc.)
+
+**Running agents:**
+- `run_agent` - To execute an agent (handles credentials and inputs automatically)
+- `agent_output` - To check the results of a running or completed agent execution
+
+**Direct execution:**
+- `run_block` - Run a single block directly without needing a full agent
+
 ## HOW run_agent WORKS
 
 The `run_agent` tool automatically handles the entire setup flow:
@@ -21,49 +89,61 @@ Parameters:
 - `use_defaults`: Set to `true` to run with default values (only after user confirms)
 - `schedule_name` + `cron`: For scheduled execution
 
+## HOW create_agent WORKS
+
+Use `create_agent` when the user wants to build a custom automation:
+- Describe what the agent should do
+- The tool will create the agent structure with appropriate blocks
+- Returns the agent ID for further editing or running
+
+## HOW agent_output WORKS
+
+Use `agent_output` to get results from agent executions:
+- Pass the execution_id from a run_agent response
+- Returns the current status and any outputs produced
+- Useful for checking if an agent has completed and what it produced
+
 ## 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`
+1. **Get their name** - If unknown, ask for it first
+2. **Understand context** - Ask 1-2 questions about their problem while helping
+3. **Find or create** - Use find_agent for existing solutions, create_agent for custom needs
+4. **Set up and run** - Use run_agent to execute, agent_output to get results
 
 ## YOUR APPROACH
 
-**Step 1: Understand the Problem**
+**Step 1: Greet and Identify**
+- If you don't know their name, ask for it
+- Be friendly and conversational
+
+**Step 2: Understand the Problem**
 - Ask maximum 1-2 targeted questions
 - Focus on: What business problem are they solving?
-- Move quickly to searching for solutions
+- If they want to create/edit an agent, understand what it should do
 
-**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: Find or Create**
+- For existing solutions: Use `find_agent` with relevant keywords
+- For custom needs: Use `create_agent` with their requirements
+- For modifications: Use `edit_agent` on an existing agent
 
-**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: Execute**
+- Call `run_agent` without inputs first to see what's available
+- Ask user what values they want or if defaults are okay
+- Call `run_agent` again with inputs or `use_defaults=true`
+- Use `agent_output` to check results when needed
 
-**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
+## USING add_understanding
 
-**For Scheduled Execution:**
-- Add `schedule_name` and `cron` parameters
-- Example: `run_agent(username_agent_slug="...", inputs={...}, schedule_name="Daily Report", cron="0 9 * * *")`
+Call `add_understanding` whenever you learn something about the user:
 
-## FUNCTION CALL FORMAT
+**User info:** `user_name`, `job_title`
+**Business:** `business_name`, `industry`, `business_size` (1-10, 11-50, 51-200, 201-1000, 1000+), `user_role` (decision maker, implementer, end user)
+**Processes:** `key_workflows` (array), `daily_activities` (array)
+**Pain points:** `pain_points` (array), `bottlenecks` (array), `manual_tasks` (array), `automation_goals` (array)
+**Tools:** `current_software` (array), `existing_automation` (array)
+**Other:** `additional_notes`
 
-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>`
+Example: `add_understanding(user_name="Sarah", job_title="Marketing Director", industry="fintech")`
 
 ## KEY RULES
 
@@ -73,8 +153,12 @@ Examples:
 - 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
+- Don't interrogate users with many questions - gather info naturally
 
 **What You DO:**
+- ALWAYS ask for user's name if you don't have it
+- Save user information with `add_understanding` as you learn it
+- Use their name when addressing them
 - 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
@@ -87,18 +171,22 @@ Examples:
 ## RESPONSE STRUCTURE
 
 Before responding, wrap your analysis in <thinking> tags to systematically plan your approach:
+- Check if you know the user's name - if not, ask for it
+- Check if you have user context - if not, plan to gather some naturally
 - 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>
+User: "Hi, I want to build an agent that monitors my competitors"
+Otto: <thinking>I don't know this user's name. I should ask for it while acknowledging their request.</thinking>
+Hi! I'm Otto and I'd love to help you build a competitor monitoring agent. What's your name?
+User: "I'm Mike"
+Otto: [calls add_understanding with user_name="Mike"]
+<thinking>Now I know Mike wants competitor monitoring. I should search for existing agents first.</thinking>
+Great to meet you, Mike! Let me search for competitor monitoring agents.
+[calls find_agent with query="competitor monitoring analysis"]
 ```
 
 KEEP ANSWERS TO 3 SENTENCES

autogpt_platform/backend/backend/api/features/chat/prompts/onboarding_system.md

@@ -0,0 +1,155 @@
+You are Otto, an AI Co-Pilot helping new users get started with AutoGPT, an AI Business Automation platform. Your mission is to welcome them, learn about their needs, and help them run their first successful agent.
+
+Here are the functions available to you:
+
+<functions>
+**Understanding & Discovery:**
+1. **add_understanding** - Save information about the user's business context (use this as you learn about them)
+2. **find_agent** - Search the marketplace for pre-built agents that solve the user's problem
+3. **find_library_agent** - Search the user's personal library of saved agents
+4. **find_block** - Search for individual blocks (building components for agents)
+5. **search_platform_docs** - Search AutoGPT documentation for help
+
+**Agent Creation & Editing:**
+6. **create_agent** - Create a new custom agent from scratch based on user requirements
+7. **edit_agent** - Modify an existing agent (add/remove blocks, change configuration)
+
+**Execution & Output:**
+8. **run_agent** - Run or schedule an agent (automatically handles setup)
+9. **run_block** - Run a single block directly without creating an agent
+10. **agent_output** - Get the output/results from a running or completed agent execution
+</functions>
+
+## YOUR ONBOARDING MISSION
+
+You are guiding a new user through their first experience with AutoGPT. Your goal is to:
+1. Welcome them warmly and get their name
+2. Learn about them and their business
+3. Find or create an agent that solves a real problem for them
+4. Get that agent running successfully
+5. Celebrate their success and point them to next steps
+
+## PHASE 1: WELCOME & INTRODUCTION
+
+**Start every conversation by:**
+- Giving a warm, friendly greeting
+- Introducing yourself as Otto, their AI assistant
+- Asking for their name immediately
+
+**Example opening:**
+```
+Hi! I'm Otto, your AI assistant. Welcome to AutoGPT! I'm here to help you set up your first automation. What's your name?
+```
+
+Once you have their name, save it immediately with `add_understanding(user_name="...")` and use it throughout.
+
+## PHASE 2: DISCOVERY
+
+**After getting their name, learn about them:**
+- What's their role/job title?
+- What industry/business are they in?
+- What's one thing they'd love to automate?
+
+**Keep it conversational - don't interrogate. Example:**
+```
+Nice to meet you, Sarah! What do you do for work, and what's one task you wish you could automate?
+```
+
+Save everything you learn with `add_understanding`.
+
+## PHASE 3: FIND OR CREATE AN AGENT
+
+**Once you understand their need:**
+- Search for existing agents with `find_agent`
+- Present the best match and explain how it helps them
+- If nothing fits, offer to create a custom agent with `create_agent`
+
+**Be enthusiastic about the solution:**
+```
+I found a great agent for you! The "Social Media Scheduler" can automatically post to your accounts on a schedule. Want to try it?
+```
+
+## PHASE 4: SETUP & RUN
+
+**Guide them through running the agent:**
+1. Call `run_agent` without inputs first to see what's needed
+2. Explain each input in simple terms
+3. Ask what values they want to use
+4. Run the agent with their inputs or defaults
+
+**Don't mention credentials** - the UI handles that automatically.
+
+## PHASE 5: CELEBRATE & HANDOFF
+
+**After successful execution:**
+- Congratulate them on their first automation!
+- Tell them where to find this agent (their Library)
+- Mention they can explore more agents in the Marketplace
+- Offer to help with anything else
+
+**Example:**
+```
+You did it! Your first agent is running. You can find it anytime in your Library. Ready to explore more automations?
+```
+
+## KEY RULES
+
+**What You DON'T Do:**
+- Don't help with login (frontend handles this)
+- Don't mention credentials (UI handles automatically)
+- Don't run agents without showing inputs first
+- Don't use `use_defaults=true` without explicit confirmation
+- Don't write responses longer than 3 sentences
+- Don't overwhelm with too many questions at once
+
+**What You DO:**
+- ALWAYS get the user's name first
+- Be warm, encouraging, and celebratory
+- Save info with `add_understanding` as you learn it
+- Use their name when addressing them
+- Keep responses to maximum 3 sentences
+- Make them feel successful at each step
+
+## USING add_understanding
+
+Save information as you learn it:
+
+**User info:** `user_name`, `job_title`
+**Business:** `business_name`, `industry`, `business_size`, `user_role`
+**Pain points:** `pain_points`, `manual_tasks`, `automation_goals`
+**Tools:** `current_software`
+
+Example: `add_understanding(user_name="Sarah", job_title="Marketing Manager", automation_goals=["social media scheduling"])`
+
+## HOW run_agent WORKS
+
+1. **First call** (no inputs) → Shows available inputs
+2. **Credentials** → UI handles automatically (don't mention)
+3. **Execution** → Run with `inputs={...}` or `use_defaults=true`
+
+## RESPONSE STRUCTURE
+
+Before responding, plan your approach in <thinking> tags:
+- What phase am I in? (Welcome/Discovery/Find/Setup/Celebrate)
+- Do I know their name? If not, ask for it
+- What's the next step to move them forward?
+- Keep response under 3 sentences
+
+**Example flow:**
+```
+User: "Hi"
+Otto: <thinking>Phase 1 - I need to welcome them and get their name.</thinking>
+Hi! I'm Otto, welcome to AutoGPT! I'm here to help you set up your first automation - what's your name?
+
+User: "I'm Alex"
+Otto: [calls add_understanding with user_name="Alex"]
+<thinking>Got their name. Phase 2 - learn about them.</thinking>
+Great to meet you, Alex! What do you do for work, and what's one task you'd love to automate?
+
+User: "I run an e-commerce store and spend hours on customer support emails"
+Otto: [calls add_understanding with industry="e-commerce", pain_points=["customer support emails"]]
+<thinking>Phase 3 - search for agents.</thinking>
+[calls find_agent with query="customer support email automation"]
+```
+
+KEEP ANSWERS TO 3 SENTENCES - Be warm, helpful, and focused on their success!

autogpt_platform/backend/backend/api/features/chat/routes.py

@@ -26,6 +26,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,9 +52,64 @@ 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 = await chat_service.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=None,  # TODO: Add title support
+            )
+            for session in sessions
+        ],
+        total=len(sessions),
+    )
+
+
 @router.post(
     "/sessions",
 )
@@ -102,26 +165,89 @@ async def get_session(
     session = await chat_service.get_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.
+
+    """
+    # 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)
+
+    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()
+
+    return StreamingResponse(
+        event_generator(),
+        media_type="text/event-stream",
+        headers={
+            "Cache-Control": "no-cache",
+            "Connection": "keep-alive",
+            "X-Accel-Buffering": "no",  # Disable nginx buffering
+        },
     )
 
 
 @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
@@ -193,6 +319,133 @@ async def session_assign_user(
     return {"status": "ok"}
 
 
+# ========== Onboarding Routes ==========
+# These routes use a specialized onboarding system prompt
+
+
+@router.post(
+    "/onboarding/sessions",
+)
+async def create_onboarding_session(
+    user_id: Annotated[str | None, Depends(auth.get_user_id)],
+) -> CreateSessionResponse:
+    """
+    Create a new onboarding chat session.
+
+    Initiates a new chat session specifically for user onboarding,
+    using a specialized prompt that guides users through their first
+    experience with AutoGPT.
+
+    Args:
+        user_id: The optional authenticated user ID parsed from the JWT.
+
+    Returns:
+        CreateSessionResponse: Details of the created onboarding session.
+    """
+    logger.info(
+        f"Creating onboarding session with user_id: "
+        f"...{user_id[-8:] if user_id and len(user_id) > 8 else '<redacted>'}"
+    )
+
+    session = await chat_service.create_chat_session(user_id)
+
+    return CreateSessionResponse(
+        id=session.session_id,
+        created_at=session.started_at.isoformat(),
+        user_id=session.user_id or None,
+    )
+
+
+@router.get(
+    "/onboarding/sessions/{session_id}",
+)
+async def get_onboarding_session(
+    session_id: str,
+    user_id: Annotated[str | None, Depends(auth.get_user_id)],
+) -> SessionDetailResponse:
+    """
+    Retrieve the details of an onboarding chat session.
+
+    Args:
+        session_id: The unique identifier for the onboarding session.
+        user_id: The optional authenticated user ID.
+
+    Returns:
+        SessionDetailResponse: Details for the requested session.
+    """
+    session = await chat_service.get_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 onboarding 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=messages,
+    )
+
+
+@router.post(
+    "/onboarding/sessions/{session_id}/stream",
+)
+async def stream_onboarding_chat(
+    session_id: str,
+    request: StreamChatRequest,
+    user_id: str | None = Depends(auth.get_user_id),
+):
+    """
+    Stream onboarding chat responses for a session.
+
+    Uses the specialized onboarding system prompt to guide new users
+    through their first experience with AutoGPT. Streams AI responses
+    in real time over Server-Sent Events (SSE).
+
+    Args:
+        session_id: The onboarding session identifier.
+        request: Request body containing message and optional context.
+        user_id: Optional authenticated user ID.
+
+    Returns:
+        StreamingResponse: SSE-formatted response chunks.
+    """
+    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)
+
+    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,
+            context=request.context,
+            prompt_type="onboarding",  # Use onboarding system prompt
+        ):
+            yield chunk.to_sse()
+
+    return StreamingResponse(
+        event_generator(),
+        media_type="text/event-stream",
+        headers={
+            "Cache-Control": "no-cache",
+            "Connection": "keep-alive",
+            "X-Accel-Buffering": "no",
+        },
+    )
+
+
 # ========== Health Check ==========
 
 

autogpt_platform/backend/backend/api/features/chat/service.py

@@ -7,16 +7,17 @@ import orjson
 from openai import AsyncOpenAI
 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 . import db as chat_db
 from .config import ChatConfig
-from .model import (
-    ChatMessage,
-    ChatSession,
-    Usage,
-    get_chat_session,
-    upsert_chat_session,
-)
+from .model import ChatMessage, ChatSession, Usage
+from .model import create_chat_session as model_create_chat_session
+from .model import get_chat_session, upsert_chat_session
 from .response_model import (
     StreamBaseResponse,
     StreamEnd,
@@ -36,15 +37,109 @@ config = ChatConfig()
 client = AsyncOpenAI(api_key=config.api_key, base_url=config.base_url)
 
 
+async def _is_first_session(user_id: str) -> bool:
+    """Check if this is the user's first chat session.
+
+    Returns True if the user has 1 or fewer sessions (meaning this is their first).
+    """
+    try:
+        session_count = await chat_db.get_user_session_count(user_id)
+        return session_count <= 1
+    except Exception as e:
+        logger.warning(f"Failed to check session count for user {user_id}: {e}")
+        return False  # Default to non-onboarding if we can't check
+
+
+async def _build_system_prompt(
+    user_id: str | None, prompt_type: str = "default"
+) -> str:
+    """Build the full system prompt including business understanding if available.
+
+    Args:
+        user_id: The user ID for fetching business understanding
+        prompt_type: The type of prompt to load ("default" or "onboarding")
+                     If "default" and this is the user's first session, will use "onboarding" instead.
+
+    Returns:
+        The full system prompt with business understanding context if available
+    """
+    # Auto-detect: if using default prompt and this is user's first session, use onboarding
+    effective_prompt_type = prompt_type
+    if prompt_type == "default" and user_id:
+        if await _is_first_session(user_id):
+            logger.info("First session detected for user, using onboarding prompt")
+            effective_prompt_type = "onboarding"
+
+    # Start with the base system prompt for the specified type
+    base_prompt = config.get_system_prompt_for_type(effective_prompt_type)
+
+    # If user is authenticated, try to fetch their business understanding
+    if user_id:
+        try:
+            understanding = await get_business_understanding(user_id)
+            if understanding:
+                context = format_understanding_for_prompt(understanding)
+                if context:
+                    return (
+                        f"{base_prompt}\n\n---\n\n"
+                        f"{context}\n\n"
+                        "Use this context to provide more personalized recommendations "
+                        "and to better understand the user's business needs when "
+                        "suggesting agents and automations."
+                    )
+        except Exception as e:
+            logger.warning(f"Failed to fetch business understanding: {e}")
+
+    return base_prompt
+
+
+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
+    """
+    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,
+            temperature=0.7,
+        )
+        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 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)
+    return await model_create_chat_session(user_id)
 
 
 async def get_session(
@@ -57,6 +152,19 @@ async def get_session(
     return await get_chat_session(session_id, user_id)
 
 
+async def get_user_sessions(
+    user_id: str,
+    limit: int = 50,
+    offset: int = 0,
+) -> list[ChatSession]:
+    """
+    Get all chat sessions for a user.
+    """
+    from .model import get_user_sessions as model_get_user_sessions
+
+    return await model_get_user_sessions(user_id, limit, offset)
+
+
 async def assign_user_to_session(
     session_id: str,
     user_id: str,
@@ -78,6 +186,8 @@ async def stream_chat_completion(
     user_id: str | None = None,
     retry_count: int = 0,
     session: ChatSession | None = None,
+    context: dict[str, str] | None = None,  # {url: str, content: str}
+    prompt_type: str = "default",
 ) -> AsyncGenerator[StreamBaseResponse, None]:
     """Main entry point for streaming chat completions with database handling.
 
@@ -89,6 +199,7 @@ async def stream_chat_completion(
         user_message: User's input message
         user_id: User ID for authentication (None for anonymous)
         session: Optional pre-loaded session object (for recursive calls to avoid Redis refetch)
+        prompt_type: The type of prompt to use ("default" or "onboarding")
 
     Yields:
         StreamBaseResponse objects formatted as SSE
@@ -121,9 +232,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(
@@ -141,6 +261,32 @@ async def stream_chat_completion(
     session = await upsert_chat_session(session)
     assert session, "Session not found"
 
+    # 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
+
+            async def _update_title():
+                try:
+                    title = await _generate_session_title(message)
+                    if title:
+                        session.title = title
+                        await upsert_chat_session(session)
+                        logger.info(
+                            f"Generated title for session {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 = await _build_system_prompt(user_id, prompt_type)
+
     assistant_response = ChatMessage(
         role="assistant",
         content="",
@@ -159,6 +305,7 @@ async def stream_chat_completion(
         async for chunk in _stream_chat_chunks(
             session=session,
             tools=tools,
+            system_prompt=system_prompt,
         ):
 
             if isinstance(chunk, StreamTextChunk):
@@ -279,6 +426,7 @@ async def stream_chat_completion(
             user_id=user_id,
             retry_count=retry_count + 1,
             session=session,
+            prompt_type=prompt_type,
         ):
             yield chunk
         return  # Exit after retry to avoid double-saving in finally block
@@ -324,6 +472,7 @@ async def stream_chat_completion(
             session_id=session.session_id,
             user_id=user_id,
             session=session,  # Pass session object to avoid Redis refetch
+            prompt_type=prompt_type,
         ):
             yield chunk
 
@@ -331,6 +480,7 @@ async def stream_chat_completion(
 async def _stream_chat_chunks(
     session: ChatSession,
     tools: list[ChatCompletionToolParam],
+    system_prompt: str | None = None,
 ) -> AsyncGenerator[StreamBaseResponse, None]:
     """
     Pure streaming function for OpenAI chat completions with tool calling.
@@ -338,9 +488,9 @@ async def _stream_chat_chunks(
     This function is database-agnostic and focuses only on streaming logic.
 
     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,6 +500,17 @@ 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:
@@ -358,7 +519,7 @@ async def _stream_chat_chunks(
             # Create the stream with proper types
             stream = await client.chat.completions.create(
                 model=model,
-                messages=session.to_openai_messages(),
+                messages=messages,
                 tools=tools,
                 tool_choice="auto",
                 stream=True,
@@ -502,8 +663,12 @@ async def _yield_tool_call(
     """
     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"],

autogpt_platform/backend/backend/api/features/chat/tools/__init__.py

@@ -4,21 +4,30 @@ 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 .find_agent import FindAgentTool
+from .find_library_agent import FindLibraryAgentTool
 from .run_agent import RunAgentTool
 
 if TYPE_CHECKING:
     from backend.api.features.chat.response_model import StreamToolExecutionResult
 
 # Initialize tool instances
+add_understanding_tool = AddUnderstandingTool()
 find_agent_tool = FindAgentTool()
+find_library_agent_tool = FindLibraryAgentTool()
 run_agent_tool = RunAgentTool()
+agent_output_tool = AgentOutputTool()
 
 # Export tools as OpenAI format
 tools: list[ChatCompletionToolParam] = [
+    add_understanding_tool.as_openai_tool(),
     find_agent_tool.as_openai_tool(),
+    find_library_agent_tool.as_openai_tool(),
     run_agent_tool.as_openai_tool(),
+    agent_output_tool.as_openai_tool(),
 ]
 
 
@@ -31,8 +40,11 @@ async def execute_tool(
 ) -> "StreamToolExecutionResult":
 
     tool_map: dict[str, BaseTool] = {
+        "add_understanding": add_understanding_tool,
         "find_agent": find_agent_tool,
+        "find_library_agent": find_library_agent_tool,
         "run_agent": run_agent_tool,
+        "agent_output": agent_output_tool,
     }
     if tool_name not in tool_map:
         raise ValueError(f"Tool {tool_name} not found")

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
@@ -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

autogpt_platform/backend/backend/api/features/chat/tools/add_understanding.py

@@ -0,0 +1,202 @@
+"""Tool for capturing user business understanding incrementally."""
+
+import logging
+from typing import Any
+
+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]:
+        return {
+            "type": "object",
+            "properties": {
+                "user_name": {
+                    "type": "string",
+                    "description": "The user's name",
+                },
+                "job_title": {
+                    "type": "string",
+                    "description": "The user's job title (e.g., 'Marketing Manager', 'CEO', 'Software Engineer')",
+                },
+                "business_name": {
+                    "type": "string",
+                    "description": "Name of the user's business or organization",
+                },
+                "industry": {
+                    "type": "string",
+                    "description": "Industry or sector (e.g., 'e-commerce', 'healthcare', 'finance')",
+                },
+                "business_size": {
+                    "type": "string",
+                    "description": "Company size: '1-10', '11-50', '51-200', '201-1000', or '1000+'",
+                },
+                "user_role": {
+                    "type": "string",
+                    "description": "User's role in organization context (e.g., 'decision maker', 'implementer', 'end user')",
+                },
+                "key_workflows": {
+                    "type": "array",
+                    "items": {"type": "string"},
+                    "description": "Key business workflows (e.g., 'lead qualification', 'content publishing')",
+                },
+                "daily_activities": {
+                    "type": "array",
+                    "items": {"type": "string"},
+                    "description": "Regular daily activities the user performs",
+                },
+                "pain_points": {
+                    "type": "array",
+                    "items": {"type": "string"},
+                    "description": "Current pain points or challenges",
+                },
+                "bottlenecks": {
+                    "type": "array",
+                    "items": {"type": "string"},
+                    "description": "Process bottlenecks slowing things down",
+                },
+                "manual_tasks": {
+                    "type": "array",
+                    "items": {"type": "string"},
+                    "description": "Manual or repetitive tasks that could be automated",
+                },
+                "automation_goals": {
+                    "type": "array",
+                    "items": {"type": "string"},
+                    "description": "Desired automation outcomes or goals",
+                },
+                "current_software": {
+                    "type": "array",
+                    "items": {"type": "string"},
+                    "description": "Software and tools currently in use",
+                },
+                "existing_automation": {
+                    "type": "array",
+                    "items": {"type": "string"},
+                    "description": "Any existing automations or integrations",
+                },
+                "additional_notes": {
+                    "type": "string",
+                    "description": "Any other relevant context or notes",
+                },
+            },
+            "required": [],
+        }
+
+    @property
+    def requires_auth(self) -> bool:
+        """Requires authentication to store user-specific data."""
+        return True
+
+    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
+        input_data = BusinessUnderstandingInput(
+            user_name=kwargs.get("user_name"),
+            job_title=kwargs.get("job_title"),
+            business_name=kwargs.get("business_name"),
+            industry=kwargs.get("industry"),
+            business_size=kwargs.get("business_size"),
+            user_role=kwargs.get("user_role"),
+            key_workflows=kwargs.get("key_workflows"),
+            daily_activities=kwargs.get("daily_activities"),
+            pain_points=kwargs.get("pain_points"),
+            bottlenecks=kwargs.get("bottlenecks"),
+            manual_tasks=kwargs.get("manual_tasks"),
+            automation_goals=kwargs.get("automation_goals"),
+            current_software=kwargs.get("current_software"),
+            existing_automation=kwargs.get("existing_automation"),
+            additional_notes=kwargs.get("additional_notes"),
+        )
+
+        # Track which fields were updated
+        updated_fields = [k for k, v in kwargs.items() if v is not None]
+
+        # Upsert with merge
+        understanding = await upsert_business_understanding(user_id, input_data)
+
+        # Build current understanding summary for the response
+        current_understanding = {
+            "user_name": understanding.user_name,
+            "job_title": understanding.job_title,
+            "business_name": understanding.business_name,
+            "industry": understanding.industry,
+            "business_size": understanding.business_size,
+            "user_role": understanding.user_role,
+            "key_workflows": understanding.key_workflows,
+            "daily_activities": understanding.daily_activities,
+            "pain_points": understanding.pain_points,
+            "bottlenecks": understanding.bottlenecks,
+            "manual_tasks": understanding.manual_tasks,
+            "automation_goals": understanding.automation_goals,
+            "current_software": understanding.current_software,
+            "existing_automation": understanding.existing_automation,
+            "additional_notes": understanding.additional_notes,
+        }
+
+        # Filter out empty values for cleaner response
+        current_understanding = {
+            k: v
+            for k, v in current_understanding.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,
+        )

autogpt_platform/backend/backend/api/features/chat/tools/agent_output.py

@@ -0,0 +1,455 @@
+"""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 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" or None -> returns (None, None) to get most recent
+    - "yesterday" -> 24h window for yesterday
+    - "today" -> Today from midnight
+    - "last week" / "last 7 days" -> 7 day window
+    - "last month" / "last 30 days" -> 30 day window
+    - ISO date "YYYY-MM-DD" -> 24h window for that date
+    """
+    if not time_expr or time_expr.lower() == "latest":
+        return None, None
+
+    now = datetime.now(timezone.utc)
+    expr = time_expr.lower().strip()
+
+    # Relative expressions
+    if expr == "yesterday":
+        end = now.replace(hour=0, minute=0, second=0, microsecond=0)
+        start = end - timedelta(days=1)
+        return start, end
+
+    if expr in ("last week", "last 7 days"):
+        return now - timedelta(days=7), now
+
+    if expr in ("last month", "last 30 days"):
+        return now - timedelta(days=30), now
+
+    if expr == "today":
+        start = now.replace(hour=0, minute=0, second=0, microsecond=0)
+        return start, now
+
+    # Try ISO date format (YYYY-MM-DD)
+    date_match = re.match(r"^(\d{4})-(\d{2})-(\d{2})$", expr)
+    if date_match:
+        year, month, day = map(int, date_match.groups())
+        start = datetime(year, month, day, 0, 0, 0, tzinfo=timezone.utc)
+        end = start + timedelta(days=1)
+        return start, end
+
+    # Try ISO datetime
+    try:
+        parsed = datetime.fromisoformat(expr.replace("Z", "+00:00"))
+        if parsed.tzinfo is None:
+            parsed = parsed.replace(tzinfo=timezone.utc)
+        # Return +/- 1 hour window around the specified time
+        return parsed - timedelta(hours=1), parsed + timedelta(hours=1)
+    except ValueError:
+        pass
+
+    # Fallback: treat as "latest"
+    return None, None
+
+
+class AgentOutputTool(BaseTool):
+    """Tool for retrieving execution outputs from user's library agents."""
+
+    @property
+    def name(self) -> str:
+        return "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,
+        )
+
+    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)

autogpt_platform/backend/backend/api/features/chat/tools/find_library_agent.py

@@ -0,0 +1,157 @@
+"""Tool for searching agents in the user's library."""
+
+import logging
+from typing import Any
+
+from backend.api.features.chat.model import ChatSession
+from backend.api.features.library import db as library_db
+from backend.util.exceptions import DatabaseError
+
+from .base import BaseTool
+from .models import (
+    AgentCarouselResponse,
+    AgentInfo,
+    ErrorResponse,
+    NoResultsResponse,
+    ToolResponseBase,
+)
+
+logger = logging.getLogger(__name__)
+
+
+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. "
+                        "Use keywords for best results."
+                    ),
+                },
+            },
+            "required": ["query"],
+        }
+
+    @property
+    def requires_auth(self) -> bool:
+        return True
+
+    async def _execute(
+        self,
+        user_id: str | None,
+        session: ChatSession,
+        **kwargs,
+    ) -> ToolResponseBase:
+        """Search for agents in the user's library.
+
+        Args:
+            user_id: User ID (required)
+            session: Chat session
+            query: Search query
+
+        Returns:
+            AgentCarouselResponse: List of agents found in the library
+            NoResultsResponse: No agents 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,
+            )
+
+        if not user_id:
+            return ErrorResponse(
+                message="User authentication required to search library",
+                session_id=session_id,
+            )
+
+        agents = []
+        try:
+            logger.info(f"Searching user library for: {query}")
+            library_results = await library_db.list_library_agents(
+                user_id=user_id,
+                search_term=query,
+                page_size=10,
+            )
+
+            logger.info(
+                f"Find library agents tool found {len(library_results.agents)} agents"
+            )
+
+            for agent in library_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,
+                    ),
+                )
+
+        except DatabaseError as e:
+            logger.error(f"Error searching library agents: {e}", exc_info=True)
+            return ErrorResponse(
+                message="Failed to search library. Please try again.",
+                error=str(e),
+                session_id=session_id,
+            )
+
+        if not agents:
+            return NoResultsResponse(
+                message=(
+                    f"No agents found matching '{query}' in your library. "
+                    "Try different keywords or use find_agent to search the marketplace."
+                ),
+                session_id=session_id,
+                suggestions=[
+                    "Try more general terms",
+                    "Use find_agent to search the marketplace",
+                    "Check your library at /library",
+                ],
+            )
+
+        title = (
+            f"Found {len(agents)} agent{'s' if len(agents) != 1 else ''} "
+            f"in your library for '{query}'"
+        )
+
+        return AgentCarouselResponse(
+            message=(
+                "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."
+            ),
+            title=title,
+            agents=agents,
+            count=len(agents),
+            session_id=session_id,
+        )

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
 
@@ -19,6 +20,15 @@ class ResponseType(str, Enum):
     ERROR = "error"
     NO_RESULTS = "no_results"
     SUCCESS = "success"
+    DOC_SEARCH_RESULTS = "doc_search_results"
+    AGENT_OUTPUT = "agent_output"
+    BLOCK_LIST = "block_list"
+    BLOCK_OUTPUT = "block_output"
+    UNDERSTANDING_UPDATED = "understanding_updated"
+    # Agent generation responses
+    AGENT_PREVIEW = "agent_preview"
+    AGENT_SAVED = "agent_saved"
+    CLARIFICATION_NEEDED = "clarification_needed"
 
 
 # Base response model
@@ -173,3 +183,128 @@ class ErrorResponse(ToolResponseBase):
     type: ResponseType = ResponseType.ERROR
     error: str | None = None
     details: dict[str, Any] | None = None
+
+
+# Documentation search models
+class DocSearchResult(BaseModel):
+    """A single documentation search result."""
+
+    title: str
+    path: str
+    section: str
+    snippet: str  # Short excerpt for UI display
+    content: str  # Full text content for LLM to read and understand
+    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
+
+
+# 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
+
+
+# Block models
+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]
+
+
+class BlockListResponse(ToolResponseBase):
+    """Response for find_block tool."""
+
+    type: ResponseType = ResponseType.BLOCK_LIST
+    blocks: list[BlockInfoSummary]
+    count: int
+    query: str
+
+
+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
+
+
+# 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)

autogpt_platform/backend/backend/api/features/chat/tools/run_agent.py

@@ -7,6 +7,7 @@ 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 +58,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 +66,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 +97,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 +105,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 +120,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 +146,7 @@ class RunAgentTool(BaseTool):
                     "description": "IANA timezone for schedule (default: UTC)",
                 },
             },
-            "required": ["username_agent_slug"],
+            "required": [],
         }
 
     @property
@@ -149,10 +164,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 +188,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,
                 )
 

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="A basic block that stores and forwards a value throughout workflows, allowing it to be reused without changes across multiple blocks.",
+            description="This block forwards an input value as output, allowing reuse without change.",
             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="A debugging block that outputs text to the console for monitoring and troubleshooting workflow execution.",
+            description="Print the given text to the console, this is used for a debugging purpose.",
             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="A visual annotation block that displays a sticky note in the workflow editor for documentation and organization purposes.",
+            description="This block is used to display a sticky note with the given text.",
             categories={BlockCategory.BASIC},
             input_schema=NoteBlock.Input,
             output_schema=NoteBlock.Output,

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="A block that looks up a value in a dictionary, list, or object by key or index and returns the corresponding value.",
+            description="Lookup the given key in the input dictionary/object/list and return the value.",
             input_schema=FindInDictionaryBlock.Input,
             output_schema=FindInDictionaryBlock.Output,
             test_input=[

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="A block that posts comments on GitHub issues or pull requests using the GitHub API.",
+            description="This block posts a comment on a specified GitHub issue or pull request.",
             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="A block that updates an existing comment on a GitHub issue or pull request.",
+            description="This block updates a comment on a specified 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="A block that retrieves all comments from a GitHub issue or pull request, including comment metadata and content.",
+            description="This block lists all comments for a specified GitHub issue or pull request.",
             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="A block that creates new issues on GitHub repositories with a title and body content.",
+            description="This block creates a new issue on a specified GitHub repository.",
             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="A block that retrieves information about a specific GitHub issue, including its title, body content, and creator.",
+            description="This block reads the body, title, and user of a specified GitHub issue.",
             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="A block that retrieves a list of issues from a GitHub repository with their titles and URLs.",
+            description="This block lists all issues for a specified GitHub repository.",
             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="A block that adds a label to a GitHub issue or pull request for categorization and organization.",
+            description="This block adds a label to a specified GitHub issue or pull request.",
             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="A block that removes a label from a GitHub issue or pull request.",
+            description="This block removes a label from a specified 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="A block that assigns a GitHub user to an issue for task ownership and tracking.",
+            description="This block assigns a user to a specified GitHub issue.",
             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="A block that removes a user's assignment from a GitHub issue.",
+            description="This block unassigns a user from a specified GitHub issue.",
             categories={BlockCategory.DEVELOPER_TOOLS},
             input_schema=GithubUnassignIssueBlock.Input,
             output_schema=GithubUnassignIssueBlock.Output,

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="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.",
+            description="This block reads emails from Gmail.",
             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="A block that retrieves all labels (categories) from a Gmail account for organizing and categorizing emails.",
+            description="This block lists all labels in Gmail.",
             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="A block that adds a label to a specific email message in Gmail, creating the label if it doesn't exist.",
+            description="This block adds a label to a Gmail message.",
             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="A block that removes a label from a specific email message in a Gmail account.",
+            description="This block removes a label from a Gmail message.",
             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="A block that retrieves an entire Gmail thread (email conversation) by ID, returning all messages with decoded bodies for reading complete conversations.",
+            description="Get a full Gmail thread by ID",
             categories={BlockCategory.COMMUNICATION},
             input_schema=GmailGetThreadBlock.Input,
             output_schema=GmailGetThreadBlock.Output,

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="A block that reads data from a Google Sheets spreadsheet using A1 notation range selection.",
+            description="This block reads data from a Google Sheets spreadsheet.",
             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="A block that writes data to a Google Sheets spreadsheet at a specified A1 notation range.",
+            description="This block writes data to a Google Sheets spreadsheet.",
             categories={BlockCategory.DATA},
             input_schema=GoogleSheetsWriteBlock.Input,
             output_schema=GoogleSheetsWriteBlock.Output,

autogpt_platform/backend/backend/blocks/io.py

@@ -76,7 +76,7 @@ class AgentInputBlock(Block):
         super().__init__(
             **{
                 "id": "c0a8e994-ebf1-4a9c-a4d8-89d09c86741b",
-                "description": "A block that accepts and processes user input values within a workflow, supporting various input types and validation.",
+                "description": "Base block for user inputs.",
                 "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="A block that records and formats workflow results for display to users, with optional Jinja2 template formatting support.",
+            description="Stores the output of the graph for users to see.",
             input_schema=AgentOutputBlock.Input,
             output_schema=AgentOutputBlock.Output,
             test_input=[

autogpt_platform/backend/backend/blocks/llm.py

@@ -854,7 +854,7 @@ class AIStructuredResponseGeneratorBlock(AIBlockBase):
     def __init__(self):
         super().__init__(
             id="ed55ac19-356e-4243-a6cb-bc599e9b716f",
-            description="A block that generates structured JSON responses using a Large Language Model (LLM), with schema validation and format enforcement.",
+            description="Call a Large Language Model (LLM) to generate formatted object based on the given prompt.",
             categories={BlockCategory.AI},
             input_schema=AIStructuredResponseGeneratorBlock.Input,
             output_schema=AIStructuredResponseGeneratorBlock.Output,
@@ -1265,7 +1265,7 @@ class AITextGeneratorBlock(AIBlockBase):
     def __init__(self):
         super().__init__(
             id="1f292d4a-41a4-4977-9684-7c8d560b9f91",
-            description="A block that produces text responses using a Large Language Model (LLM) based on customizable prompts and system instructions.",
+            description="Call a Large Language Model (LLM) to generate a string based on the given prompt.",
             categories={BlockCategory.AI},
             input_schema=AITextGeneratorBlock.Input,
             output_schema=AITextGeneratorBlock.Output,
@@ -1361,7 +1361,7 @@ class AITextSummarizerBlock(AIBlockBase):
     def __init__(self):
         super().__init__(
             id="a0a69be1-4528-491c-a85a-a4ab6873e3f0",
-            description="A block that summarizes long texts using a Large Language Model (LLM), with configurable focus topics and summary styles.",
+            description="Utilize a Large Language Model (LLM) to summarize a long text.",
             categories={BlockCategory.AI, BlockCategory.TEXT},
             input_schema=AITextSummarizerBlock.Input,
             output_schema=AITextSummarizerBlock.Output,
@@ -1562,7 +1562,7 @@ class AIConversationBlock(AIBlockBase):
     def __init__(self):
         super().__init__(
             id="32a87eab-381e-4dd4-bdb8-4c47151be35a",
-            description="A block that facilitates multi-turn conversations with a Large Language Model (LLM), maintaining context across message exchanges.",
+            description="Advanced LLM call that takes a list of messages and sends them to the language model.",
             categories={BlockCategory.AI},
             input_schema=AIConversationBlock.Input,
             output_schema=AIConversationBlock.Output,
@@ -1682,7 +1682,7 @@ class AIListGeneratorBlock(AIBlockBase):
     def __init__(self):
         super().__init__(
             id="9c0b0450-d199-458b-a731-072189dd6593",
-            description="A block that creates lists of items based on prompts using a Large Language Model (LLM), with optional source data for context.",
+            description="Generate a list of values based on the given prompt using a Large Language Model (LLM).",
             categories={BlockCategory.AI, BlockCategory.TEXT},
             input_schema=AIListGeneratorBlock.Input,
             output_schema=AIListGeneratorBlock.Output,

autogpt_platform/backend/backend/blocks/smart_decision_maker.py

@@ -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}
@@ -1147,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",

autogpt_platform/backend/backend/blocks/test/test_smart_decision_maker.py

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

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 = [

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(
@@ -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):

autogpt_platform/backend/backend/data/understanding.py

@@ -0,0 +1,429 @@
+"""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 UserBusinessUnderstanding
+from prisma.types import (
+    UserBusinessUnderstandingCreateInput,
+    UserBusinessUnderstandingUpdateInput,
+)
+
+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: UserBusinessUnderstanding) -> "BusinessUnderstanding":
+        """Convert database record to Pydantic model."""
+        return cls(
+            id=db_record.id,
+            user_id=db_record.userId,
+            created_at=db_record.createdAt,
+            updated_at=db_record.updatedAt,
+            user_name=db_record.userName,
+            job_title=db_record.jobTitle,
+            business_name=db_record.businessName,
+            industry=db_record.industry,
+            business_size=db_record.businessSize,
+            user_role=db_record.userRole,
+            key_workflows=_json_to_list(db_record.keyWorkflows),
+            daily_activities=_json_to_list(db_record.dailyActivities),
+            pain_points=_json_to_list(db_record.painPoints),
+            bottlenecks=_json_to_list(db_record.bottlenecks),
+            manual_tasks=_json_to_list(db_record.manualTasks),
+            automation_goals=_json_to_list(db_record.automationGoals),
+            current_software=_json_to_list(db_record.currentSoftware),
+            existing_automation=_json_to_list(db_record.existingAutomation),
+            additional_notes=db_record.additionalNotes,
+        )
+
+
+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 UserBusinessUnderstanding.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,
+    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)
+    """
+    # Get existing record for merge
+    existing = await UserBusinessUnderstanding.prisma().find_unique(
+        where={"userId": user_id}
+    )
+
+    # Build update data with merge strategy
+    update_data: UserBusinessUnderstandingUpdateInput = {}
+    create_data: dict[str, Any] = {"userId": user_id}
+
+    # String fields - overwrite if provided
+    if data.user_name is not None:
+        update_data["userName"] = data.user_name
+        create_data["userName"] = data.user_name
+    if data.job_title is not None:
+        update_data["jobTitle"] = data.job_title
+        create_data["jobTitle"] = data.job_title
+    if data.business_name is not None:
+        update_data["businessName"] = data.business_name
+        create_data["businessName"] = data.business_name
+    if data.industry is not None:
+        update_data["industry"] = data.industry
+        create_data["industry"] = data.industry
+    if data.business_size is not None:
+        update_data["businessSize"] = data.business_size
+        create_data["businessSize"] = data.business_size
+    if data.user_role is not None:
+        update_data["userRole"] = data.user_role
+        create_data["userRole"] = data.user_role
+    if data.additional_notes is not None:
+        update_data["additionalNotes"] = data.additional_notes
+        create_data["additionalNotes"] = data.additional_notes
+
+    # List fields - merge with existing
+    if data.key_workflows is not None:
+        existing_list = _json_to_list(existing.keyWorkflows) if existing else None
+        merged = _merge_lists(existing_list, data.key_workflows)
+        update_data["keyWorkflows"] = SafeJson(merged)
+        create_data["keyWorkflows"] = SafeJson(merged)
+
+    if data.daily_activities is not None:
+        existing_list = _json_to_list(existing.dailyActivities) if existing else None
+        merged = _merge_lists(existing_list, data.daily_activities)
+        update_data["dailyActivities"] = SafeJson(merged)
+        create_data["dailyActivities"] = SafeJson(merged)
+
+    if data.pain_points is not None:
+        existing_list = _json_to_list(existing.painPoints) if existing else None
+        merged = _merge_lists(existing_list, data.pain_points)
+        update_data["painPoints"] = SafeJson(merged)
+        create_data["painPoints"] = SafeJson(merged)
+
+    if data.bottlenecks is not None:
+        existing_list = _json_to_list(existing.bottlenecks) if existing else None
+        merged = _merge_lists(existing_list, data.bottlenecks)
+        update_data["bottlenecks"] = SafeJson(merged)
+        create_data["bottlenecks"] = SafeJson(merged)
+
+    if data.manual_tasks is not None:
+        existing_list = _json_to_list(existing.manualTasks) if existing else None
+        merged = _merge_lists(existing_list, data.manual_tasks)
+        update_data["manualTasks"] = SafeJson(merged)
+        create_data["manualTasks"] = SafeJson(merged)
+
+    if data.automation_goals is not None:
+        existing_list = _json_to_list(existing.automationGoals) if existing else None
+        merged = _merge_lists(existing_list, data.automation_goals)
+        update_data["automationGoals"] = SafeJson(merged)
+        create_data["automationGoals"] = SafeJson(merged)
+
+    if data.current_software is not None:
+        existing_list = _json_to_list(existing.currentSoftware) if existing else None
+        merged = _merge_lists(existing_list, data.current_software)
+        update_data["currentSoftware"] = SafeJson(merged)
+        create_data["currentSoftware"] = SafeJson(merged)
+
+    if data.existing_automation is not None:
+        existing_list = _json_to_list(existing.existingAutomation) if existing else None
+        merged = _merge_lists(existing_list, data.existing_automation)
+        update_data["existingAutomation"] = SafeJson(merged)
+        create_data["existingAutomation"] = SafeJson(merged)
+
+    # Upsert
+    record = await UserBusinessUnderstanding.prisma().upsert(
+        where={"userId": user_id},
+        data={
+            "create": UserBusinessUnderstandingCreateInput(**create_data),
+            "update": update_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 UserBusinessUnderstanding.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."""
+    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)

autogpt_platform/backend/migrations/20260108110428_add_chat_tables/migration.sql

@@ -0,0 +1,81 @@
+-- DropIndex
+DROP INDEX "StoreListingVersion_storeListingId_version_key";
+
+-- CreateTable
+CREATE TABLE "UserBusinessUnderstanding" (
+    "id" TEXT NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "userId" TEXT NOT NULL,
+    "userName" TEXT,
+    "jobTitle" TEXT,
+    "businessName" TEXT,
+    "industry" TEXT,
+    "businessSize" TEXT,
+    "userRole" TEXT,
+    "keyWorkflows" JSONB,
+    "dailyActivities" JSONB,
+    "painPoints" JSONB,
+    "bottlenecks" JSONB,
+    "manualTasks" JSONB,
+    "automationGoals" JSONB,
+    "currentSoftware" JSONB,
+    "existingAutomation" JSONB,
+    "additionalNotes" TEXT,
+
+    CONSTRAINT "UserBusinessUnderstanding_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,
+    "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 "UserBusinessUnderstanding_userId_key" ON "UserBusinessUnderstanding"("userId");
+
+-- CreateIndex
+CREATE INDEX "UserBusinessUnderstanding_userId_idx" ON "UserBusinessUnderstanding"("userId");
+
+-- CreateIndex
+CREATE INDEX "ChatSession_userId_updatedAt_idx" ON "ChatSession"("userId", "updatedAt");
+
+-- CreateIndex
+CREATE INDEX "ChatMessage_sessionId_sequence_idx" ON "ChatMessage"("sessionId", "sequence");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ChatMessage_sessionId_sequence_key" ON "ChatMessage"("sessionId", "sequence");
+
+-- AddForeignKey
+ALTER TABLE "UserBusinessUnderstanding" ADD CONSTRAINT "UserBusinessUnderstanding_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;

autogpt_platform/backend/schema.prisma

@@ -53,6 +53,7 @@ model User {
 
   Profile               Profile[]
   UserOnboarding        UserOnboarding?
+  BusinessUnderstanding UserBusinessUnderstanding?
   BuilderSearchHistory  BuilderSearchHistory[]
   StoreListings         StoreListing[]
   StoreListingReviews   StoreListingReview[]
@@ -121,19 +122,109 @@ model UserOnboarding {
   User   User   @relation(fields: [userId], references: [id], onDelete: Cascade)
 }
 
+model UserBusinessUnderstanding {
+  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)
+
+  // User info
+  userName String?
+  jobTitle String?
+
+  // Business basics (string columns)
+  businessName String?
+  industry     String?
+  businessSize String? // "1-10", "11-50", "51-200", "201-1000", "1000+"
+  userRole     String? // Role in organization context (e.g., "decision maker", "implementer")
+
+  // Processes & activities (JSON arrays)
+  keyWorkflows    Json?
+  dailyActivities Json?
+
+  // Pain points & goals (JSON arrays)
+  painPoints      Json?
+  bottlenecks     Json?
+  manualTasks     Json?
+  automationGoals Json?
+
+  // Current tools (JSON arrays)
+  currentSoftware    Json?
+  existingAutomation Json?
+
+  additionalNotes String?
+
+  @@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?
+
+  // 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])
+  @@index([sessionId, sequence])
+}
+
 // This model describes the Agent Graph/Flow (Multi Agent System).
 model AgentGraph {
   id        String    @default(uuid())
@@ -721,26 +812,26 @@ 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[]
+  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)
 
   // Materialized views used (refreshed every 15 minutes via pg_cron):
   // - mv_agent_run_counts - Pre-aggregated agent execution counts by agentGraphId
@@ -856,14 +947,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)
 
@@ -899,7 +990,6 @@ model StoreListingVersion {
   // Reviews for this specific version
   Reviews StoreListingReview[]
 
-  @@unique([storeListingId, version])
   @@index([storeListingId, submissionStatus, isAvailable])
   @@index([submissionStatus])
   @@index([reviewerId])
@@ -998,16 +1088,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

autogpt_platform/backend/scripts/generate_block_docs.py

@@ -1,746 +0,0 @@
-#!/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
-
-    # Migrate existing docs (add markers, preserve content)
-    poetry run python scripts/generate_block_docs.py --migrate
-
-    # 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" / "platform" / "blocks"
-)
-
-
-@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
-    name = class_name.replace("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]) -> 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 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:
-            value_type = type_to_readable(type_schema["additionalProperties"])
-            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"][:3])
-        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 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 strip_markers(content: str) -> str:
-    """Remove MANUAL markers from content."""
-    # Remove opening markers
-    content = re.sub(r"<!-- MANUAL: \w+ -->\s*", "", content)
-    # Remove closing markers
-    content = re.sub(r"\s*<!-- END MANUAL -->", "", content)
-    return content.strip()
-
-
-def extract_legacy_content(existing_content: str) -> dict[str, str]:
-    """Extract content from legacy docs without markers (for migration)."""
-    manual_sections = {}
-
-    # Try to extract "How it works" section
-    how_it_works_match = re.search(
-        r"### How it works\s*\n(.*?)(?=\n### |\n## |\Z)", existing_content, re.DOTALL
-    )
-    if how_it_works_match:
-        content = strip_markers(how_it_works_match.group(1).strip())
-        if content and not content.startswith("|"):  # Not a table
-            manual_sections["how_it_works"] = content
-
-    # Try to extract "Possible use case" section
-    use_case_match = re.search(
-        r"### Possible use case\s*\n(.*?)(?=\n### |\n## |\n---|\Z)",
-        existing_content,
-        re.DOTALL,
-    )
-    if use_case_match:
-        content = strip_markers(use_case_match.group(1).strip())
-        if content:
-            manual_sections["use_case"] = content
-
-    return manual_sections
-
-
-def generate_block_markdown(
-    block: BlockDoc,
-    manual_content: dict[str, str] | None = None,
-    is_first_in_file: bool = True,
-) -> str:
-    """Generate markdown documentation for a single block."""
-    manual_content = manual_content or {}
-    lines = []
-
-    # Block heading
-    heading_level = "#" if is_first_in_file else "##"
-    lines.append(f"{heading_level} {block.name}")
-    lines.append("")
-
-    # What it is (full description)
-    lines.append("### What it is")
-    lines.append(block.description or "No description available.")
-    lines.append("")
-
-    # How it works (manual section)
-    lines.append("### 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("### Inputs")
-        lines.append("| Input | Description | Type | Required |")
-        lines.append("|-------|-------------|------|----------|")
-        for inp in visible_inputs:
-            required = "Yes" if inp.required else "No"
-            desc = inp.description or "-"
-            # Escape pipes in description
-            desc = desc.replace("|", "\\|")
-            lines.append(f"| {inp.name} | {desc} | {inp.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("### Outputs")
-        lines.append("| Output | Description | Type |")
-        lines.append("|--------|-------------|------|")
-        for out in visible_outputs:
-            desc = out.description or "-"
-            desc = desc.replace("|", "\\|")
-            lines.append(f"| {out.name} | {desc} | {out.type_str} |")
-        lines.append("")
-
-    # Possible use case (manual section)
-    lines.append("### 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](../new_blocks.md) - Step-by-step tutorial with examples"
-    )
-    lines.append(
-        "    - [Block SDK Guide](../block-sdk-guide.md) - 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",
-    ]
-
-    for category in category_order:
-        if category not in by_category:
-            continue
-
-        cat_blocks = sorted(by_category[category], key=lambda b: b.name)
-        display_name = CATEGORY_DISPLAY_NAMES.get(category, category)
-
-        lines.append(f"## {display_name}")
-        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("|", "\\|")
-
-            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],
-    migrate: bool = False,
-    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()
-
-        # Generate content for each block
-        content_parts = []
-        for i, block in enumerate(sorted(file_blocks, key=lambda b: b.name)):
-            # Try to extract manual content
-            if migrate:
-                manual_content = extract_legacy_content(existing_content)
-            else:
-                # Extract manual content specific to this block
-                # Look for content after the block heading
-                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,
-                    is_first_in_file=(i == 0),
-                )
-            )
-
-        full_content = "\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 / "blocks.md"
-    generated_files["blocks.md"] = overview_content
-    overview_path.write_text(overview_content)
-
-    if verbose:
-        print("  Writing blocks.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
-
-    for file_path, file_blocks in file_mapping.items():
-        full_path = output_dir / file_path
-
-        if not full_path.exists():
-            print(f"MISSING: {file_path}")
-            all_match = False
-            continue
-
-        existing_content = full_path.read_text()
-
-        # 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
-        content_parts = []
-        for i, block in enumerate(sorted(file_blocks, key=lambda b: b.name)):
-            manual_content = manual_sections_by_block.get(block.name, {})
-            content_parts.append(
-                generate_block_markdown(
-                    block,
-                    manual_content,
-                    is_first_in_file=(i == 0),
-                )
-            )
-
-        expected_content = "\n".join(content_parts)
-
-        if existing_content.strip() != expected_content.strip():
-            print(f"OUT OF SYNC: {file_path}")
-            all_match = False
-
-    # Check overview
-    overview_path = output_dir / "blocks.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: blocks.md (overview)")
-            all_match = False
-    else:
-        print("MISSING: blocks.md (overview)")
-        all_match = False
-
-    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(
-        "--migrate",
-        action="store_true",
-        help="Migrate existing docs (extract legacy manual content)",
-    )
-    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("\nDocumentation is out of sync!")
-            print(
-                "Run: cd autogpt_platform/backend && poetry run python scripts/generate_block_docs.py"
-            )
-            sys.exit(1)
-    else:
-        print(f"Generating docs to {args.output_dir}...")
-        write_block_docs(
-            args.output_dir,
-            blocks,
-            migrate=args.migrate,
-            verbose=args.verbose,
-        )
-        print("Done!")
-
-
-if __name__ == "__main__":
-    main()

autogpt_platform/backend/scripts/migrate_block_docs.py

@@ -1,211 +0,0 @@
-#!/usr/bin/env python3
-"""
-Migration script to preserve manual content from existing docs.
-
-This script:
-1. Reads all existing block documentation (from git HEAD)
-2. Extracts manual content (How it works, Possible use case) by block name
-3. Creates a JSON mapping of block_name -> manual_content
-4. Generates new docs using current block structure while preserving manual content
-"""
-
-import json
-import re
-import subprocess
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent.parent))
-
-from scripts.generate_block_docs import (
-    generate_block_markdown,
-    generate_overview_table,
-    get_block_file_mapping,
-    load_all_blocks_for_docs,
-    strip_markers,
-)
-
-
-def get_git_file_content(file_path: str) -> str | None:
-    """Get file content from git HEAD."""
-    try:
-        result = subprocess.run(
-            ["git", "show", f"HEAD:{file_path}"],
-            capture_output=True,
-            text=True,
-            cwd=Path(__file__).parent.parent.parent.parent,  # repo root
-        )
-        if result.returncode == 0:
-            return result.stdout
-        return None
-    except Exception:
-        return None
-
-
-def extract_blocks_from_doc(content: str) -> dict[str, dict[str, str]]:
-    """Extract all block sections and their manual content from a doc file."""
-    blocks = {}
-
-    # Find all block headings (# or ##)
-    block_pattern = r"(?:^|\n)(##?) ([^\n]+)\n"
-    matches = list(re.finditer(block_pattern, content))
-
-    for i, match in enumerate(matches):
-        block_name = match.group(2).strip()
-        start = match.end()
-
-        # Find end (next heading or end of file)
-        if i + 1 < len(matches):
-            end = matches[i + 1].start()
-        else:
-            end = len(content)
-
-        block_content = content[start:end]
-
-        # Extract manual sections
-        manual_content = {}
-
-        # How it works
-        how_match = re.search(
-            r"### How it works\s*\n(.*?)(?=\n### |\Z)", block_content, re.DOTALL
-        )
-        if how_match:
-            text = strip_markers(how_match.group(1).strip())
-            # Skip if it's just placeholder or a table
-            if text and not text.startswith("|") and not text.startswith("_Add"):
-                manual_content["how_it_works"] = text
-
-        # Possible use case
-        use_case_match = re.search(
-            r"### Possible use case\s*\n(.*?)(?=\n### |\n## |\n---|\Z)",
-            block_content,
-            re.DOTALL,
-        )
-        if use_case_match:
-            text = strip_markers(use_case_match.group(1).strip())
-            if text and not text.startswith("_Add"):
-                manual_content["use_case"] = text
-
-        if manual_content:
-            blocks[block_name] = manual_content
-
-    return blocks
-
-
-def collect_existing_manual_content() -> dict[str, dict[str, str]]:
-    """Collect all manual content from existing git HEAD docs."""
-    all_manual_content = {}
-
-    # Find all existing md files via git
-    result = subprocess.run(
-        ["git", "ls-files", "docs/content/platform/blocks/"],
-        capture_output=True,
-        text=True,
-        cwd=Path(__file__).parent.parent.parent.parent,
-    )
-
-    if result.returncode != 0:
-        print("Failed to list git files")
-        return {}
-
-    for file_path in result.stdout.strip().split("\n"):
-        if not file_path.endswith(".md"):
-            continue
-        if file_path.endswith("blocks.md"):  # Skip overview
-            continue
-
-        print(f"Processing: {file_path}")
-        content = get_git_file_content(file_path)
-        if content:
-            blocks = extract_blocks_from_doc(content)
-            for block_name, manual_content in blocks.items():
-                if block_name in all_manual_content:
-                    # Merge if already exists
-                    all_manual_content[block_name].update(manual_content)
-                else:
-                    all_manual_content[block_name] = manual_content
-
-    return all_manual_content
-
-
-def run_migration():
-    """Run the migration."""
-    print("Step 1: Collecting existing manual content from git HEAD...")
-    manual_content_cache = collect_existing_manual_content()
-
-    print(f"\nFound manual content for {len(manual_content_cache)} blocks")
-
-    # Show some examples
-    for name, content in list(manual_content_cache.items())[:3]:
-        print(f"  - {name}: {list(content.keys())}")
-
-    # Save cache for reference
-    cache_path = Path(__file__).parent / "manual_content_cache.json"
-    with open(cache_path, "w") as f:
-        json.dump(manual_content_cache, f, indent=2)
-    print(f"\nSaved cache to {cache_path}")
-
-    print("\nStep 2: Loading blocks from code...")
-    blocks = load_all_blocks_for_docs()
-    print(f"Found {len(blocks)} blocks")
-
-    print("\nStep 3: Generating new documentation...")
-    output_dir = (
-        Path(__file__).parent.parent.parent.parent
-        / "docs"
-        / "content"
-        / "platform"
-        / "blocks"
-    )
-
-    file_mapping = get_block_file_mapping(blocks)
-
-    # Track statistics
-    preserved_count = 0
-    missing_count = 0
-
-    for file_path, file_blocks in file_mapping.items():
-        full_path = output_dir / file_path
-        full_path.parent.mkdir(parents=True, exist_ok=True)
-
-        content_parts = []
-        for i, block in enumerate(sorted(file_blocks, key=lambda b: b.name)):
-            # Look up manual content by block name
-            manual_content = manual_content_cache.get(block.name, {})
-
-            if manual_content:
-                preserved_count += 1
-            else:
-                # Try with class name
-                manual_content = manual_content_cache.get(block.class_name, {})
-                if not manual_content:
-                    missing_count += 1
-
-            content_parts.append(
-                generate_block_markdown(
-                    block,
-                    manual_content,
-                    is_first_in_file=(i == 0),
-                )
-            )
-
-        full_content = "\n".join(content_parts)
-        full_path.write_text(full_content)
-        print(f"  Wrote {file_path} ({len(file_blocks)} blocks)")
-
-    # Generate overview
-    overview_content = generate_overview_table(blocks)
-    overview_path = output_dir / "blocks.md"
-    overview_path.write_text(overview_content)
-    print("  Wrote blocks.md (overview)")
-
-    print("\nMigration complete!")
-    print(f"  - Blocks with preserved manual content: {preserved_count}")
-    print(f"  - Blocks without manual content: {missing_count}")
-    print(
-        "\nYou can now run `poetry run python scripts/generate_block_docs.py --check` to verify"
-    )
-
-
-if __name__ == "__main__":
-    run_migration()

autogpt_platform/backend/scripts/test_generate_block_docs.py

@@ -1,233 +0,0 @@
-#!/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,
-    strip_markers,
-    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 TestStripMarkers:
-    """Tests for strip_markers function."""
-
-    def test_strip_opening_marker(self):
-        content = "<!-- MANUAL: how_it_works -->\nContent here"
-        result = strip_markers(content)
-        assert result == "Content here"
-
-    def test_strip_closing_marker(self):
-        content = "Content here\n<!-- END MANUAL -->"
-        result = strip_markers(content)
-        assert result == "Content here"
-
-    def test_strip_both_markers(self):
-        content = "<!-- MANUAL: section -->\nContent here\n<!-- END MANUAL -->"
-        result = strip_markers(content)
-        assert result == "Content here"
-
-    def test_no_markers(self):
-        content = "Content without markers"
-        result = strip_markers(content)
-        assert result == "Content without markers"
-
-
-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"])

autogpt_platform/frontend/src/app/(platform)/build/components/FlowEditor/nodes/CustomNode/components/NodeHeader.tsx

@@ -68,7 +68,10 @@ export const NodeHeader = ({ data, nodeId }: Props) => {
                 <Tooltip>
                   <TooltipTrigger asChild>
                     <div>
-                      <Text variant="large-semibold" className="line-clamp-1">
+                      <Text
+                        variant="large-semibold"
+                        className="line-clamp-1 hover:cursor-text"
+                      >
                         {beautifyString(title).replace("Block", "").trim()}
                       </Text>
                     </div>

autogpt_platform/frontend/src/app/api/openapi.json

@@ -939,12 +939,12 @@
         }
       }
     },
-    "/api/chat/sessions": {
+    "/api/chat/onboarding/sessions": {
       "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.",
-        "operationId": "postV2CreateSession",
+        "summary": "Create Onboarding Session",
+        "description": "Create a new onboarding chat session.\n\nInitiates a new chat session specifically for user onboarding,\nusing a specialized prompt that guides users through their first\nexperience with AutoGPT.\n\nArgs:\n    user_id: The optional authenticated user ID parsed from the JWT.\n\nReturns:\n    CreateSessionResponse: Details of the created onboarding session.",
+        "operationId": "postV2CreateOnboardingSession",
         "responses": {
           "200": {
             "description": "Successful Response",
@@ -963,6 +963,167 @@
         "security": [{ "HTTPBearerJWT": [] }]
       }
     },
+    "/api/chat/onboarding/sessions/{session_id}": {
+      "get": {
+        "tags": ["v2", "chat", "chat"],
+        "summary": "Get Onboarding Session",
+        "description": "Retrieve the details of an onboarding chat session.\n\nArgs:\n    session_id: The unique identifier for the onboarding session.\n    user_id: The optional authenticated user ID.\n\nReturns:\n    SessionDetailResponse: Details for the requested session.",
+        "operationId": "getV2GetOnboardingSession",
+        "security": [{ "HTTPBearerJWT": [] }],
+        "parameters": [
+          {
+            "name": "session_id",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string", "title": "Session Id" }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SessionDetailResponse"
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/HTTP401NotAuthenticatedError"
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": { "$ref": "#/components/schemas/HTTPValidationError" }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/chat/onboarding/sessions/{session_id}/stream": {
+      "post": {
+        "tags": ["v2", "chat", "chat"],
+        "summary": "Stream Onboarding Chat",
+        "description": "Stream onboarding chat responses for a session.\n\nUses the specialized onboarding system prompt to guide new users\nthrough their first experience with AutoGPT. Streams AI responses\nin real time over Server-Sent Events (SSE).\n\nArgs:\n    session_id: The onboarding session identifier.\n    request: Request body containing message and optional context.\n    user_id: Optional authenticated user ID.\n\nReturns:\n    StreamingResponse: SSE-formatted response chunks.",
+        "operationId": "postV2StreamOnboardingChat",
+        "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/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.",
+        "operationId": "postV2CreateSession",
+        "security": [{ "HTTPBearerJWT": [] }],
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CreateSessionResponse"
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/HTTP401NotAuthenticatedError"
+          }
+        }
+      }
+    },
     "/api/chat/sessions/{session_id}": {
       "get": {
         "tags": ["v2", "chat", "chat"],
@@ -1048,9 +1209,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 +1259,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": {
@@ -8019,6 +8220,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": {
@@ -9348,6 +9563,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": {
@@ -9899,6 +10129,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"],

autogpt_platform/frontend/src/components/renderers/InputRenderer/base/anyof/AnyOfField.tsx

@@ -5,6 +5,7 @@ import { useAnyOfField } from "./useAnyOfField";
 import { getHandleId, updateUiOption } from "../../helpers";
 import { useEdgeStore } from "@/app/(platform)/build/stores/edgeStore";
 import { ANY_OF_FLAG } from "../../constants";
+import { findCustomFieldId } from "../../registry";
 
 export const AnyOfField = (props: FieldProps) => {
   const { registry, schema } = props;
@@ -40,12 +41,21 @@ export const AnyOfField = (props: FieldProps) => {
 
   const isHandleConnected = isInputConnected(nodeId, 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={updatedUiSchema}
+        uiSchema={optionUiSchema}
       />
     )) ||
     null;

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>
+  );
+};

autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/MultiSelectField/index.ts

@@ -0,0 +1 @@
+export { MultiSelectField } from "./MultiSelectField";

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,
+  };
+}

autogpt_platform/frontend/src/components/renderers/InputRenderer/custom/custom-registry.ts

@@ -1,6 +1,8 @@
 import { FieldProps, RJSFSchema, RegistryFieldsType } from "@rjsf/utils";
 import { CredentialsField } from "./CredentialField/CredentialField";
 import { GoogleDrivePickerField } from "./GoogleDrivePickerField/GoogleDrivePickerField";
+import { MultiSelectField } from "./MultiSelectField/MultiSelectField";
+import { isMultiSelectSchema } from "../utils/schema-utils";
 
 export interface CustomFieldDefinition {
   id: string;
@@ -30,6 +32,11 @@ export const CUSTOM_FIELDS: CustomFieldDefinition[] = [
     },
     component: GoogleDrivePickerField,
   },
+  {
+    id: "custom/multi_select_field",
+    matcher: isMultiSelectSchema,
+    component: MultiSelectField,
+  },
 ];
 
 export function findCustomFieldId(schema: any): string | null {

autogpt_platform/frontend/src/components/renderers/InputRenderer/utils/schema-utils.ts

@@ -1,7 +1,11 @@
 import { getUiOptions, RJSFSchema, UiSchema } from "@rjsf/utils";
 
 export function isAnyOfSchema(schema: RJSFSchema | undefined): boolean {
-  return Array.isArray(schema?.anyOf) && schema!.anyOf.length > 0;
+  return (
+    Array.isArray(schema?.anyOf) &&
+    schema!.anyOf.length > 0 &&
+    schema?.enum === undefined
+  );
 }
 
 export const isAnyOfChild = (
@@ -33,3 +37,21 @@ export function isOptionalType(schema: RJSFSchema | undefined): {
 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",
+    )
+  );
+}

docs/platform/blocks/airtable/bases.md

@@ -1,75 +0,0 @@
-# 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, True]] | 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, True]] |
-| table | A single table object | Dict[str, True] |
-| 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, True]] |
-| 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 -->
-
----

docs/platform/blocks/airtable/records.md

@@ -1,199 +0,0 @@
-# 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, True]] | 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, True]] |
-| details | Details of the created records | Dict[str, True] |
-
-### 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, True]] |
-
-### 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, True] |
-| created_time | The record created time | str |
-| field_metadata | Field type and configuration metadata (only when include_field_metadata=true) | Dict[str, True] |
-
-### 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, True]] | 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, True]] |
-| 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, True] |
-
-### 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, True]] | 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, True]] |
-
-### 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 -->
-
----

docs/platform/blocks/airtable/schema.md

@@ -1,187 +0,0 @@
-# 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" | 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, True] |
-| 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, True]] | No |
-
-### Outputs
-| Output | Description | Type |
-|--------|-------------|------|
-| error | Error message if the operation failed | str |
-| table | Created table object | Dict[str, True] |
-| 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, True] |
-| tables | Array of table objects | List[Dict[str, True]] |
-
-### 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, True] |
-
-### 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, True] | No |
-
-### Outputs
-| Output | Description | Type |
-|--------|-------------|------|
-| error | Error message if the operation failed | str |
-| table | Updated table object | Dict[str, True] |
-
-### 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 -->
-
----

docs/platform/blocks/airtable/triggers.md

@@ -1,35 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/apollo/organization.md

@@ -1,54 +0,0 @@
-# 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 appearch 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, True]] |
-| organization | Each found organization, one at a time | Dict[str, True] |
-
-### 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 -->
-
----

docs/platform/blocks/apollo/people.md

@@ -1,68 +0,0 @@
-# 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"] | 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"] | 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, True]] |
-
-### 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 -->
-
----

docs/platform/blocks/apollo/person.md

@@ -1,42 +0,0 @@
-# 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, True] |
-
-### 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 -->
-
----

docs/platform/blocks/ayrshare/post_to_bluesky.md

@@ -1,45 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/ayrshare/post_to_facebook.md

@@ -1,61 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/ayrshare/post_to_gmb.md

@@ -1,57 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/ayrshare/post_to_instagram.md

@@ -1,54 +0,0 @@
-# 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, True]] | 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 -->
-
----

docs/platform/blocks/ayrshare/post_to_linkedin.md

@@ -1,56 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/ayrshare/post_to_pinterest.md

@@ -1,51 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/ayrshare/post_to_reddit.md

@@ -1,44 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/ayrshare/post_to_snapchat.md

@@ -1,46 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/ayrshare/post_to_telegram.md

@@ -1,44 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/ayrshare/post_to_threads.md

@@ -1,44 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/ayrshare/post_to_tiktok.md

@@ -1,55 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/ayrshare/post_to_x.md

@@ -1,57 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/ayrshare/post_to_youtube.md

@@ -1,60 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/baas/bots.md

@@ -1,147 +0,0 @@
-# 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, True] |
-
-### 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, True] | No |
-| extra | Custom metadata to attach to the bot | Dict[str, True] | 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, True] |
-
-### 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 -->
-
----

docs/platform/blocks/bannerbear/text_overlay.md

@@ -1,42 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/blocks.md

@@ -13,515 +13,194 @@ Below is a comprehensive list of all available blocks, categorized by their prim
 ## 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 |
-| [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 |
-| [Installation](basic.md#installation) | Given a code string, this block allows the verification and installation of a block code into the system |
-| [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 |
+| [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 |
 |------------|-------------|
-| [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 |
+| [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 |
 |------------|-------------|
-| [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 |
+| [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 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 |
+| [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 |
 
-## Search and Information Retrieval
+## Web and API Interactions
 | 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 |
+| [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 |
 |------------|-------------|
-| [Create Discord Thread](discord/bot_blocks.md#create-discord-thread) | Creates a new thread in a Discord channel |
-| [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 |
-| [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 Posts](misc.md#get-reddit-posts) | This block fetches Reddit posts from a defined subreddit name |
-| [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 |
-| [Reply To Discord Message](discord/bot_blocks.md#reply-to-discord-message) | Replies to a specific Discord message |
-| [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 |
-| [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 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 Geted Users](twitter/blocks.md#twitter-geted-users) | This block retrieves a list of users blocked by the authenticating user |
-| [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 |
+| [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 |
 
-## Communication
+## Search and Information Retrieval
 | 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 |
+| [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 |
 
-## Developer Tools
+## Time and Date
 | 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 |
+| [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 |
 |------------|-------------|
-| [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 |
+| [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 |
 
-## Productivity
+## Miscellaneous
 | 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 |
+| [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 |
 
-## Logic and Control Flow
+## Google Services
 | 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 |
+| [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 |
 
-## Input/Output
+## GitHub Integration
 | 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 |
+| [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 |
 
-## Input/Output
+## Twitter Integration
 | Block Name | Description |
 |------------|-------------|
-| [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) |
+| [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 |
 
-## Agent Integration
+## Todoist Integration
 | Block Name | Description |
 |------------|-------------|
-| [Agent Executor](misc.md#agent-executor) | Executes an existing agent inside your agent |
+| [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 |
 
-## 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 |
+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.

docs/platform/blocks/compass/triggers.md

@@ -1,28 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/data.md

@@ -1,266 +0,0 @@
-# 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, True] | 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, True] |
-
-### 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 -->
-
----

docs/platform/blocks/dataforseo/keyword_suggestions.md

@@ -1,82 +0,0 @@
-# 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, True] |
-| clickstream_data | Clickstream data metrics | Dict[str, True] |
-
-### 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 -->
-
----

docs/platform/blocks/dataforseo/related_keywords.md

@@ -1,83 +0,0 @@
-# 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, True] |
-| clickstream_data | Clickstream data metrics | Dict[str, True] |
-
-### 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 -->
-
----

docs/platform/blocks/discord/bot_blocks.md

@@ -1,336 +0,0 @@
-# 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" | 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, True]] | 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 -->
-
----

docs/platform/blocks/discord/oauth_blocks.md

@@ -1,32 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/enrichlayer/linkedin.md

@@ -1,151 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/exa/answers.md

@@ -1,36 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/exa/code_context.md

@@ -1,40 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/exa/contents.md

@@ -1,47 +0,0 @@
-# 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" | 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 -->
-
----

docs/platform/blocks/exa/research.md

@@ -1,173 +0,0 @@
-# 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, True] | 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, True] |
-| 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, True] |
-| 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, True]] |
-
-### 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, True] |
-| 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 -->
-
----

docs/platform/blocks/exa/search.md

@@ -1,52 +0,0 @@
-# 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" | No |
-| category | Category to search within: company, research paper, news, pdf, github, tweet, personal site, linkedin profile, financial report | "company" | "research paper" | "news" | 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 -->
-
----

docs/platform/blocks/exa/similar.md

@@ -1,48 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/exa/webhook_blocks.md

@@ -1,39 +0,0 @@
-# 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, True] |
-| timestamp | When the event occurred | str |
-| metadata | Additional event metadata | Dict[str, True] |
-
-### 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 -->
-
----

docs/platform/blocks/exa/websets.md

@@ -1,457 +0,0 @@
-# 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, True] | 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" | 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"] | 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, True]] | 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, True] | 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, True]] |
-| enrichments | The enrichments applied to the webset | List[Dict[str, True]] |
-| monitors | The monitors for the webset | List[Dict[str, True]] |
-| metadata | Key-value pairs associated with the webset | Dict[str, True] |
-| 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" | 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, True] | 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, True] |
-| 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, True]] |
-| 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 -->
-
----

docs/platform/blocks/exa/websets_enrichment.md

@@ -1,211 +0,0 @@
-# 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" | 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, True] | 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, True] |
-
-### 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" | No |
-| options | New options when format is 'options' | List[str] | No |
-| metadata | New metadata to attach to the enrichment | Dict[str, True] | 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 -->
-
----

docs/platform/blocks/exa/websets_import_export.md

@@ -1,207 +0,0 @@
-# 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" | 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, True] | 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, True] |
-
-### 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, True]] |
-| import_item | Individual import (yielded for each import) | Dict[str, True] |
-| 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 -->
-
----

docs/platform/blocks/exa/websets_items.md

@@ -1,237 +0,0 @@
-# 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, True] |
-| enrichments | Enrichment data added to the item | Dict[str, True] |
-| 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 -->
-
----

docs/platform/blocks/exa/websets_monitor.md

@@ -1,212 +0,0 @@
-# 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, True] | 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, True] |
-| 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, True] |
-| 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, True] |
-
-### 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, True]] |
-| monitor | Individual monitor (yielded for each monitor) | Dict[str, True] |
-| 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, True] | 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 -->
-
----

docs/platform/blocks/exa/websets_polling.md

@@ -1,132 +0,0 @@
-# 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, True] |
-| 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" | 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, True] |
-| enrichment_progress | Detailed enrichment progress information | Dict[str, True] |
-| 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 -->
-
----

docs/platform/blocks/exa/websets_search.md

@@ -1,182 +0,0 @@
-# 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" | 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, True] | 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, True] |
-| 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" | 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, True]] |
-| progress | Search progress information | Dict[str, True] |
-| recall | Recall estimation information | Dict[str, True] |
-| 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, True] |
-
-### 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 -->
-
----

docs/platform/blocks/fal/ai_video_generator.md

@@ -1,35 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/firecrawl/crawl.md

@@ -1,46 +0,0 @@
-# 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"] | No |
-
-### Outputs
-| Output | Description | Type |
-|--------|-------------|------|
-| error | Error message if the crawl failed | str |
-| data | The result of the crawl | List[Dict[str, True]] |
-| 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, True] |
-| change_tracking | The change tracking of the crawl | Dict[str, True] |
-
-### 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 -->
-
----

docs/platform/blocks/firecrawl/extract.md

@@ -1,36 +0,0 @@
-# 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, True] | 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, True] |
-
-### 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 -->
-
----

docs/platform/blocks/firecrawl/map.md

@@ -1,34 +0,0 @@
-# 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, True]] |
-
-### 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 -->
-
----

docs/platform/blocks/firecrawl/scrape.md

@@ -1,46 +0,0 @@
-# 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"] | No |
-
-### Outputs
-| Output | Description | Type |
-|--------|-------------|------|
-| error | Error message if the scrape failed | str |
-| data | The result of the crawl | Dict[str, True] |
-| 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, True] |
-| change_tracking | The change tracking of the crawl | Dict[str, True] |
-
-### 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 -->
-
----

docs/platform/blocks/firecrawl/search.md

@@ -1,38 +0,0 @@
-# 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"] | No |
-
-### Outputs
-| Output | Description | Type |
-|--------|-------------|------|
-| error | Error message if the search failed | str |
-| data | The result of the search | Dict[str, True] |
-| site | The site of the search | Dict[str, True] |
-
-### 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 -->
-
----

docs/platform/blocks/generic_webhook/triggers.md

@@ -1,34 +0,0 @@
-# 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, True] | 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, True] |
-| constants | The constants to be set when the block is put on the graph | Dict[str, True] |
-
-### 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 -->
-
----

docs/platform/blocks/github/checks.md

@@ -1,81 +0,0 @@
-# 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" | No |
-| conclusion | The final conclusion of the check (required if status is completed) | "success" | "failure" | "neutral" | 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" | Yes |
-| conclusion | The final conclusion of the check (required if status is completed) | "success" | "failure" | "neutral" | 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 -->
-
----

docs/platform/blocks/github/ci.md

@@ -1,44 +0,0 @@
-# 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 -->
-
----

docs/platform/blocks/github/issues.md

@@ -1,213 +1,152 @@
-# 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 Issues
 
 ## Github Comment
 
 ### What it is
-A block that posts comments on GitHub issues or pull requests using the GitHub API.
+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
-<!-- 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 |
+| 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 | 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 |
+| 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
-<!-- 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.
+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
-<!-- 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 |
+| 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 | Type |
-|--------|-------------|------|
-| error | Error message if the issue creation failed | str |
-| number | Number of the created issue | int |
-| url | URL of the created issue | str |
+| 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
-<!-- 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.
+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
-<!-- 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 |
+| Input | Description |
+|-------|-------------|
+| Credentials | GitHub authentication information |
+| Issue URL | The URL of the GitHub issue to be read |
 
 ### 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 |
+| 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
-<!-- MANUAL: use_case -->
 Gathering information about reported issues for analysis or to display on a dashboard.
-<!-- END MANUAL -->
+
+---
+
+## 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.
 
 ---
 
@@ -216,93 +155,82 @@ Gathering information about reported issues for analysis or to display on a dash
 ### 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
-<!-- 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 |
+| 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 | Type |
-|--------|-------------|------|
-| error | Error message if the label removal failed | str |
-| status | Status of the label removal operation | str |
+| Output | Description |
+|--------|-------------|
+| Status | A message indicating whether the label was successfully removed |
+| Error | Any error message if removing the label fails |
 
 ### 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 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 removes a user's assignment from a GitHub issue.
+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
-<!-- 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 |
+| 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 | Type |
-|--------|-------------|------|
-| error | Error message if the issue unassignment failed | str |
-| status | Status of the issue unassignment operation | str |
+| Output | Description |
+|--------|-------------|
+| Status | A message indicating whether the issue was successfully unassigned |
+| Error | Any error message if unassigning the issue fails |
 
 ### 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 -->
-
----
+Automatically unassigning issues that have been inactive for a certain period or when reassigning workload among team members.

docs/platform/blocks/github/pull_requests.md

@@ -1,216 +1,182 @@
-# Github Assign PR Reviewer
+# Pull Requests
+
+## GitHub List Pull Requests
 
 ### What it is
-This block assigns a reviewer to a specified GitHub pull request.
+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
-<!-- 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 -->
+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 | Type | Required |
-|-------|-------------|------|----------|
-| pr_url | URL of the GitHub pull request | str | Yes |
-| reviewer | Username of the reviewer to assign | str | Yes |
+| 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 | Type |
-|--------|-------------|------|
-| error | Error message if the reviewer assignment failed | str |
-| status | Status of the reviewer assignment operation | str |
+| 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
-<!-- 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 -->
+A development team leader wants to quickly review all open pull requests in their project repository to prioritize code reviews.
 
 ---
 
-## Github List PR Reviewers
+## GitHub Make Pull Request
 
 ### What it is
-This block lists all reviewers for a specified GitHub pull request.
+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
-<!-- 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 -->
+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 | Type | Required |
-|-------|-------------|------|----------|
-| pr_url | URL of the GitHub pull request | str | Yes |
+| 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 | 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] |
+| 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
-<!-- 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 -->
+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 List Pull Requests
+## GitHub Read Pull Request
 
 ### What it is
-This block lists all pull requests for a specified GitHub repository.
+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
-<!-- 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 -->
+It connects to the GitHub API using the provided credentials and pull request URL, then retrieves and formats the requested information.
 
 ### Inputs
-| Input | Description | Type | Required |
-|-------|-------------|------|----------|
-| repo_url | URL of the GitHub repository | str | Yes |
+| 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 | 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] |
+| 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
-<!-- 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 -->
+A code reviewer wants to get a comprehensive overview of a pull request, including its description and changes, before starting the review process.
 
 ---
 
-## Github Make Pull Request
+## GitHub Assign PR Reviewer
 
 ### What it is
-This block creates a new pull request on a specified GitHub repository.
+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
-<!-- 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 -->
+It uses the GitHub API to add the specified user as a reviewer for the given pull request.
 
 ### 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 |
+| 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 | 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 |
+| Output | Description |
+|--------|-------------|
+| Status | A message indicating whether the reviewer was successfully assigned |
+| Error | An error message if the reviewer assignment fails |
 
 ### 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 -->
+A project manager wants to assign a specific team member to review a newly created pull request for a critical feature.
 
 ---
 
-## Github Read Pull Request
+## GitHub Unassign PR Reviewer
 
 ### What it is
-This block reads the body, title, user, and changes of a specified GitHub pull request.
+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
-<!-- 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 -->
+It uses the GitHub API to remove the specified user from the list of reviewers for the given pull request.
 
 ### 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 |
+| 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 | 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 |
+| Output | Description |
+|--------|-------------|
+| Status | A message indicating whether the reviewer was successfully unassigned |
+| Error | An error message if the reviewer unassignment fails |
 
 ### 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 -->
+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 Unassign PR Reviewer
+## GitHub List PR Reviewers
 
 ### What it is
-This block unassigns a reviewer from a specified GitHub pull request.
+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
-<!-- 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 -->
+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 | Type | Required |
-|-------|-------------|------|----------|
-| pr_url | URL of the GitHub pull request | str | Yes |
-| reviewer | Username of the reviewer to unassign | str | Yes |
+| 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 | Type |
-|--------|-------------|------|
-| error | Error message if the reviewer unassignment failed | str |
-| status | Status of the reviewer unassignment operation | str |
+| 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
-<!-- 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 -->
-
----
+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.