feat(agent, file-block): files in agent block, file block v4

[Sg312]

Summary

Brief description of what this PR does and why.

Fixes #(issue)

Type of Change

• Bug fix
• New feature
• Breaking change
• Documentation
• Other: ___________

Testing

How has this been tested? What should reviewers focus on?

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

Screenshots/Videos

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
docs	Skipped		May 15, 2026 2:14am

[greptile-apps]

Greptile Summary

This PR adds file attachment support to the agent block (upload or wire files into any agent's latest user message) and introduces a new file_v4 block with dedicated Read, Fetch, Write, and Append operations, replacing the legacy v3 block in the toolbar.

• A new attachments.ts module centralises per-provider content building (OpenAI Responses API, Anthropic document blocks, Gemini inlineData, Bedrock native blocks, OpenRouter, and image-only adapters); all provider files now call into it to strip the files field before sending the payload.
• attachFilesToLastUserMessage in the agent handler hydrates user-provided files and appends them to the last user message; the early guard that should reject unsupported providers (xai, deepseek, cerebras) does not fire because getAttachmentProvider returns a non-null value for them, causing unnecessary file hydration and a test that will fail in CI.
• file_v4 introduces a file_read tool backed by the existing /api/tools/file/manage route (new read operation) and a file_fetch tool that reuses the parse endpoint with optional custom headers for authenticated downloads.

Confidence Score: 3/5

The file attachment pipeline works correctly end-to-end for all supported providers, but the early guard in the agent handler silently passes for three declared-unsupported providers, causing wasted file hydration and a broken test.

The early rejection check in attachFilesToLastUserMessage passes for xai, deepseek, and cerebras because getAttachmentProvider returns a non-null string for them. In production the error is eventually thrown inside the provider's formatter, but only after files are fetched and decoded. In the test suite executeProviderRequest is mocked, so the formatter never runs and the new test "should reject files for providers without attachment support" will fail in CI.

apps/sim/executor/handlers/agent/agent-handler.ts and apps/sim/executor/handlers/agent/agent-handler.test.ts need the most attention.

Important Files Changed

Filename	Overview
apps/sim/executor/handlers/agent/agent-handler.ts	Adds file attachment support to agent blocks; early provider validation check misses xai/deepseek/cerebras providers, causing unnecessary file hydration and a broken test.
apps/sim/providers/attachments.ts	New module handling per-provider content building (OpenAI, Anthropic, Gemini, Bedrock, OpenRouter, image-only providers); well-structured with correct unsupported-provider throws, but UNSUPPORTED_FILE_PROVIDERS is unexported, preventing upstream callers from doing early validation.
apps/sim/blocks/blocks/file.ts	Introduces FileV4Block with Read/Fetch/Write/Append operations, hides FileV3Block from toolbar; param routing logic looks correct.
apps/sim/blocks/blocks/agent.ts	Adds file-upload and advanced file subblocks to the agent block, normalized through normalizeFileInput before passing to the provider request.
apps/sim/app/api/tools/file/manage/route.ts	Adds a new read operation supporting both workspace file IDs and direct file input objects, with correct 404 handling for missing IDs.
apps/sim/executor/handlers/agent/agent-handler.test.ts	New test for rejecting files on deepseek/unsupported providers will fail because the guard it tests does not actually throw for those providers.
apps/sim/tools/file/parser.ts	Extracts parseFileParserV3Response as a shared helper, adds fileFetchTool with headers normalization; small, clean refactor.

Sequence Diagram

sequenceDiagram
    participant UI as Agent Block UI
    participant AH as AgentBlockHandler
    participant AT as attachments.ts
    participant HY as hydrateUserFilesWithBase64
    participant PR as Provider (openai/anthropic/…)

    UI->>AH: execute(inputs.files)
    AH->>AH: normalizeFileInput(filesInput)
    AH->>AH: getAttachmentProvider(providerId) — guard
    Note over AH: xai/deepseek/cerebras pass guard (non-null) ⚠️
    AH->>HY: hydrateUserFilesWithBase64(userFiles)
    HY-->>AH: UserFile[] with base64
    AH->>AH: attach files to last user message
    AH->>PR: executeProviderRequest(messages with files)
    PR->>AT: buildXxxMessageContent / formatMessagesForProvider
    AT->>AT: prepareProviderAttachments
    Note over AT: Throws for xai/deepseek/cerebras here
    AT-->>PR: formatted content parts
    PR-->>AH: ProviderResponse

Loading

_{Reviews (1): Last reviewed commit: "Clean up attachments" | Re-trigger Greptile}