Nicholas Tindle 2c678f2658 refactor(backend): rename return_format options for clarity and add auto-fallback ...

Rename store_media_file() return_format options to make intent clear:
- "local_path" -> "for_local_processing" (ffmpeg, MoviePy, PIL)
- "data_uri" -> "for_external_api" (Replicate, OpenAI APIs)
- "workspace_ref" -> "for_block_output" (auto-adapts to context)

The "for_block_output" format now gracefully handles both contexts:
- CoPilot (has workspace): returns workspace:// reference
- Graph execution (no workspace): falls back to data URI

This prevents blocks from failing in graph execution while still
providing workspace persistence in CoPilot.

Also adds documentation to CLAUDE.md, new_blocks.md, and
block-sdk-guide.md explaining when to use each format.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-27 21:53:09 -06:00

..

contributing

feat(docs): update dev from gitbook changes (#11740)

2026-01-09 19:22:05 +00:00

integrating

feat(docs): update dev from gitbook changes (#11740)

2026-01-09 19:22:05 +00:00

advanced_setup.md

feat(docs): update dev from gitbook changes (#11740)

2026-01-09 19:22:05 +00:00

agent-blocks.md

feat(docs): update dev from gitbook changes (#11740)

2026-01-09 19:22:05 +00:00

aimlapi.md

feat(docs): update dev from gitbook changes (#11740)

2026-01-09 19:22:05 +00:00

block-sdk-guide.md

refactor(backend): rename return_format options for clarity and add auto-fallback

2026-01-27 21:53:09 -06:00

create-basic-agent.md

feat(docs): update dev from gitbook changes (#11740)

2026-01-09 19:22:05 +00:00

d_id.md

feat(docs): update dev from gitbook changes (#11740)

2026-01-09 19:22:05 +00:00

delete-agent.md

feat(docs): update dev from gitbook changes (#11740)

2026-01-09 19:22:05 +00:00

download-agent-from-marketplace-local.md

feat(docs): update dev from gitbook changes (#11740)

2026-01-09 19:22:05 +00:00

edit-agent.md

feat(docs): update dev from gitbook changes (#11740)

2026-01-09 19:22:05 +00:00

getting-started.md

feat(docs): update dev from gitbook changes (#11740)

2026-01-09 19:22:05 +00:00

installer.md

feat(docs): update dev from gitbook changes (#11740)

2026-01-09 19:22:05 +00:00

new_blocks.md

refactor(backend): rename return_format options for clarity and add auto-fallback

2026-01-27 21:53:09 -06:00

ollama.md

feat(docs): update dev from gitbook changes (#11740)

2026-01-09 19:22:05 +00:00

submit-agent-to-marketplace.md

feat(docs): update dev from gitbook changes (#11740)

2026-01-09 19:22:05 +00:00

SUMMARY.md

feat(docs): update dev from gitbook changes (#11740)

2026-01-09 19:22:05 +00:00

what-is-autogpt-platform.md

feat(docs): update dev from gitbook changes (#11740)

2026-01-09 19:22:05 +00:00