improvement(buffer): explicit mediaType override instead of guessing on ambiguous media

[waleedlatif1]

Summary

• Follow-up to feat(buffer): add Buffer integration with posts, channels, and ideas #5637 (merged before this landed): addresses Greptile's final P1 about silent media-type guessing
• Adds a mediaType param (auto | image | video, default auto) to buffer_create_post / buffer_edit_post, the route contract, and the block (advanced dropdown)
• In auto mode, when the MIME type, URL extension, and DNS-pinned HEAD probe are all inconclusive, the route now returns a clear 400 asking for an explicit mediaType instead of defaulting the asset to image

Type of Change

• Improvement

Testing

Typecheck, lint, check:api-validation:strict pass; docs regenerated

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)

[vercel]

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

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
docs	Skipped		Jul 13, 2026 8:42pm

[cursor]

PR Summary

Medium Risk
Changes media classification (may break ambiguous URLs that silently worked as images) and broadens presigned URL lifetime for Buffer only; file-utils behavior for keyed uploads is stricter about reminting URLs.

Overview
Adds mediaType (auto | image | video, default auto) to Buffer create/edit post flows—API contracts, routes, tools, block advanced UI, and docs—so callers can force attachment kind when MIME, extension, and HEAD probe are inconclusive. Auto mode no longer guesses image; the route returns a 400 with a clear message to set mediaType explicitly.

For scheduled/queued posts, Buffer media resolution now requests 7-day presigned URLs (via configurable presignExpirySeconds on file resolution), and stored files with a key always get a freshly minted presign at that TTL instead of reusing possibly stale embedded URLs. Docs note that uploads are link-valid for 7 days and public URLs are better for longer schedules.

^{Reviewed by Cursor Bugbot for commit 8770cd5. Configure here.}

[waleedlatif1]

@greptile

[waleedlatif1]

@cursor review

[greptile-apps]

Greptile Summary

This PR adds explicit Buffer media type handling for ambiguous attachments. The main changes are:

• mediaType is exposed on the Buffer create and edit tools.
• Create and edit routes forward mediaType into media resolution.
• Explicit image and video values skip auto-detection.
• Ambiguous auto media now returns a clear request error.
• Stored Buffer media URLs use a longer presign window.

Confidence Score: 5/5

This looks safe to merge.

• No blocking issues found in the changed code.

Important Files Changed

Filename	Overview
apps/sim/app/api/tools/buffer/create-post/route.ts	The create route now forwards the validated media type into the shared Buffer mutation helper.
apps/sim/app/api/tools/buffer/edit-post/route.ts	The edit route now forwards the validated media type into the shared Buffer mutation helper.
apps/sim/app/api/tools/buffer/server-utils.ts	Media resolution now honors explicit attachment types, rejects inconclusive auto-detection, and uses longer presigned links for Buffer media.
apps/sim/lib/api/contracts/tools/buffer.ts	The shared Buffer contract now accepts auto, image, and video media type values.
apps/sim/lib/uploads/utils/file-utils.server.ts	Stored file URL resolution now supports caller-provided presign expiry values.
apps/sim/tools/buffer/create_post.ts	The create tool now exposes and sends the media type option.
apps/sim/tools/buffer/edit_post.ts	The edit tool now exposes and sends the media type option.
apps/sim/tools/buffer/types.ts	Buffer create and edit parameter types now include the media type option.
apps/sim/blocks/blocks/buffer.ts	The Buffer block now includes an advanced media type dropdown.
apps/docs/content/docs/en/integrations/buffer.mdx	The Buffer docs now describe the media type option and uploaded media link lifetime.

_{Reviews (8): Last reviewed commit: "fix(buffer): always mint fresh presigned..." | Re-trigger Greptile}

[greptile-apps]

Greptile Summary

This PR adds Buffer as a social scheduling integration. The main changes are:

• New Buffer block, tool registry entries, icons, and docs.
• New Buffer GraphQL tool implementations for posts, channels, ideas, and account data.
• New create/edit post API routes with media resolution and explicit mediaType support.
• Updated API validation contracts for Buffer post mutations.

Confidence Score: 4/5

The Buffer create/edit media path needs a fix before merging.

• Explicit image/video overrides are validated and sent by the tools.
• The create and edit routes drop that value before calling the media resolver.
• Ambiguous media can still fail with the new error even when callers provide the override.

apps/sim/app/api/tools/buffer/create-post/route.ts, apps/sim/app/api/tools/buffer/edit-post/route.ts

Important Files Changed

Filename	Overview
apps/sim/app/api/tools/buffer/create-post/route.ts	Adds a contract-bound create route, but drops the validated mediaType before media resolution.
apps/sim/app/api/tools/buffer/edit-post/route.ts	Adds a contract-bound edit route, but drops the validated mediaType before media replacement.
apps/sim/app/api/tools/buffer/server-utils.ts	Adds Buffer post mutation forwarding and media auto-detection with support for explicit image/video overrides.
apps/sim/blocks/blocks/buffer.ts	Adds the Buffer block definition, operations, media fields, templates, and parameter mapping.
apps/sim/lib/api/contracts/tools/buffer.ts	Adds shared create/edit post route contracts with scheduling and media validation.
apps/sim/tools/buffer/create_post.ts	Adds the create-post tool and sends Buffer create requests through the internal route.
apps/sim/tools/buffer/edit_post.ts	Adds the edit-post tool and sends Buffer edit requests through the internal route.
apps/sim/tools/buffer/types.ts	Adds shared Buffer GraphQL selections, types, response mapping, and error handling helpers.

_{Reviews (2): Last reviewed commit: "improvement(buffer): explicit mediaType ..." | Re-trigger Greptile}

[waleedlatif1]

@greptile review

[waleedlatif1]

@cursor review

[waleedlatif1]

@greptile review

[waleedlatif1]

@cursor review

[cursor]

✅ Bugbot reviewed your changes and found no new issues!

1 issue from previous review remains unresolved.

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit c5ecd7a. Configure here.}

[waleedlatif1]

@greptile review

[waleedlatif1]

@cursor review

[waleedlatif1]

@greptile review

[waleedlatif1]

@cursor review

[waleedlatif1]

@greptile review

[waleedlatif1]

@cursor review

[cursor]

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 8770cd5. Configure here.}

[waleedlatif1]

@greptile