Skip to content

Make videos on the computer you already own. FreeVideo runs MiniMax H3 in as little as 8 GB of VRAM and 16 GB of RAM, and adapts its acceleration path to your hardware.

Agent MCP: return plain-text tool errors to the Agent as readable messages

Bowen Xue2ac422d7e0fb
diff --git a/freevideo_engine/agent/errors.py b/freevideo_engine/agent/errors.py
index 0dbad56..982299d 100644
--- a/freevideo_engine/agent/errors.py
+++ b/freevideo_engine/agent/errors.py
@@ -443,9 +443,13 @@ def validation(errors, code='invalid_request'):
def text(error):
+ """One line for the Agent; a plain-text error (a failed white-model scene) is its own message."""
+ if not isinstance(error, dict):
+ return str(error).strip() or 'failed: The request did not finish.'
reason = error.get('reason') or {}
- message = reason.get('en') or error['message']
- diagnostic = image_failure(error['code'], error.get('report_id'))['report_id'] if reason else None
- return '%s: %s%s%s' % (error['code'], message,
+ code = error.get('code') or 'failed'
+ message = reason.get('en') or error.get('message') or ''
+ diagnostic = image_failure(code, error.get('report_id'))['report_id'] if reason else None
+ return '%s: %s%s%s' % (code, message,
' Diagnostic report: /freevideo/image-gen/report/' + diagnostic if diagnostic else '',
' Next: ' + error['next'] if error.get('next') else '')
diff --git a/freevideo_engine/agent/schema.py b/freevideo_engine/agent/schema.py
index 21cd016..a9660bb 100644
--- a/freevideo_engine/agent/schema.py
+++ b/freevideo_engine/agent/schema.py
@@ -741,7 +741,7 @@ WHITEBOX_TOOLS = dict(submit='freevideo_whitebox_submit', get='freevideo_whitebo
def whitebox_schema(name):
if name == 'submit':
- return obj(dict(code=string(65536, description='JavaScript that defines build(THREE) and returns {scene, camera, update(t)}.'),
+ return obj(dict(code=string(65536, description='An ES module with export function build(THREE) that returns {scene, camera, update(t)}.'),
summary=string(500, description='One sentence on what the scene shows, for the confirm card.')), ('code',))
return obj({'wait': WAIT})