export_sample_frames
Sample pixels from the exact current Export
Pure-read pixel inspection of one exact rendered Export MP4, including burned overlays and captions. Requires the exact export_id, expected_render_generation, and expected_render_plan_hash from render_status plus 1–4 finite nonnegative Export-timeline seconds. This does not settle status, mint URLs, publish frames, bill, render, or mutate. Exact retained Export frames establish only the content of each sampled still, including burned overlays and captions at that instant. A sampled still shows only literal visible content at that sampled instant; a visible anomaly in it is a candidate for further review. A still alone does not establish an objective Export or renderer defect, its cause, a violated invariant, or overall quality. Those conclusions require independently bound temporal or implementation evidence, or human review. Program structure, sampled still pixels, decoded temporal artifact evidence, implementation evidence, and human judgment are distinct evidence classes. Not observable from isolated stills: motion, transition smoothness, cut abruptness or naturalness, caption synchronization or correctness across time, audio, overall taste, and human acceptance. A still inspection pass is one bounded 1–4-frame board; identical or subset points in the same user turn repeat evidence already held, and at most one explicitly novel follow-up adds new evidence. For a short multi-cut Export, retained inspection includes the opening picture, the near-EOF final picture, and both sides of every render_status-flagged Junction. When four frames cannot cover that set, the allowed novel follow-up covers the rest. A seam-only board leaves endpoint inspection incomplete and cannot support a quality-ready or finished claim. Render-ready remains lifecycle state. Tool-use-only custody; no capability URLs. render_status observes no pixels. Frames are tool-use-only; no capability URLs.
Surface: Default model and app
Product release 185ad8f4adfa21ae055b5bd6f97968d9044480d1
Public contract commit d2ab41fab4088c07c0f6b924fa4f3c63481b936a
Public contract SHA-256 2365c73c2aef7b9f85e8434d8e29ea29f40824bc3a46a72a356155ea328757fc
Captured 2026-10-29T03:35:56.855Z. Review or improve this contract on GitHub.
These blocks show the complete MCP descriptors captured from serving Rails. Security schemes and resource URIs can differ by connected host.
Default model descriptor
{
"name": "export_sample_frames",
"title": "Sample pixels from the exact current Export",
"description": "Pure-read pixel inspection of one exact rendered Export MP4, including burned overlays and captions. Requires the exact export_id, expected_render_generation, and expected_render_plan_hash from render_status plus 1–4 finite nonnegative Export-timeline seconds. This does not settle status, mint URLs, publish frames, bill, render, or mutate. Exact retained Export frames establish only the content of each sampled still, including burned overlays and captions at that instant. A sampled still shows only literal visible content at that sampled instant; a visible anomaly in it is a candidate for further review. A still alone does not establish an objective Export or renderer defect, its cause, a violated invariant, or overall quality. Those conclusions require independently bound temporal or implementation evidence, or human review. Program structure, sampled still pixels, decoded temporal artifact evidence, implementation evidence, and human judgment are distinct evidence classes. Not observable from isolated stills: motion, transition smoothness, cut abruptness or naturalness, caption synchronization or correctness across time, audio, overall taste, and human acceptance. A still inspection pass is one bounded 1–4-frame board; identical or subset points in the same user turn repeat evidence already held, and at most one explicitly novel follow-up adds new evidence. For a short multi-cut Export, retained inspection includes the opening picture, the near-EOF final picture, and both sides of every render_status-flagged Junction. When four frames cannot cover that set, the allowed novel follow-up covers the rest. A seam-only board leaves endpoint inspection incomplete and cannot support a quality-ready or finished claim. Render-ready remains lifecycle state. Tool-use-only custody; no capability URLs. render_status observes no pixels. Frames are tool-use-only; no capability URLs.",
"inputSchema": {
"type": "object",
"properties": {
"export_id": {
"type": "string",
"description": "Exact retained Export handle (rxpt_...) from render_status or result delivery. Foreign handles fail closed and no handle redirects to another generation."
},
"expected_render_generation": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "Exact 64-hex current render generation for this Export. A mismatch fails closed."
},
"expected_render_plan_hash": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "Exact 64-hex current render-plan hash for this Export. A mismatch fails closed."
},
"times": {
"type": "array",
"description": "Explicit Export-timeline seconds to sample from the finished MP4. A still inspection pass is one bounded 1–4-frame board; identical or subset points in the same user turn repeat evidence already held. One through four finite nonnegative values only. At most one explicitly novel follow-up adds new evidence.",
"items": {
"type": "number",
"minimum": 0
},
"minItems": 1,
"maxItems": 4
}
},
"required": [
"export_id",
"expected_render_generation",
"expected_render_plan_hash",
"times"
],
"additionalProperties": false
},
"annotations": {
"title": "Sample pixels from the exact current Export",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
},
"securitySchemes": [
{
"type": "noauth"
}
],
"_meta": {
"securitySchemes": [
{
"type": "noauth"
}
]
}
}App descriptor
{
"name": "export_sample_frames",
"title": "Sample pixels from the exact current Export",
"description": "Pure-read pixel inspection of one exact rendered Export MP4, including burned overlays and captions. Requires the exact export_id, expected_render_generation, and expected_render_plan_hash from render_status plus 1–4 finite nonnegative Export-timeline seconds. This does not settle status, mint URLs, publish frames, bill, render, or mutate. Exact retained Export frames establish only the content of each sampled still, including burned overlays and captions at that instant. A sampled still shows only literal visible content at that sampled instant; a visible anomaly in it is a candidate for further review. A still alone does not establish an objective Export or renderer defect, its cause, a violated invariant, or overall quality. Those conclusions require independently bound temporal or implementation evidence, or human review. Program structure, sampled still pixels, decoded temporal artifact evidence, implementation evidence, and human judgment are distinct evidence classes. Not observable from isolated stills: motion, transition smoothness, cut abruptness or naturalness, caption synchronization or correctness across time, audio, overall taste, and human acceptance. A still inspection pass is one bounded 1–4-frame board; identical or subset points in the same user turn repeat evidence already held, and at most one explicitly novel follow-up adds new evidence. For a short multi-cut Export, retained inspection includes the opening picture, the near-EOF final picture, and both sides of every render_status-flagged Junction. When four frames cannot cover that set, the allowed novel follow-up covers the rest. A seam-only board leaves endpoint inspection incomplete and cannot support a quality-ready or finished claim. Render-ready remains lifecycle state. Tool-use-only custody; no capability URLs. render_status observes no pixels. Frames are tool-use-only; no capability URLs.",
"inputSchema": {
"type": "object",
"properties": {
"export_id": {
"type": "string",
"description": "Exact retained Export handle (rxpt_...) from render_status or result delivery. Foreign handles fail closed and no handle redirects to another generation."
},
"expected_render_generation": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "Exact 64-hex current render generation for this Export. A mismatch fails closed."
},
"expected_render_plan_hash": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "Exact 64-hex current render-plan hash for this Export. A mismatch fails closed."
},
"times": {
"type": "array",
"description": "Explicit Export-timeline seconds to sample from the finished MP4. A still inspection pass is one bounded 1–4-frame board; identical or subset points in the same user turn repeat evidence already held. One through four finite nonnegative values only. At most one explicitly novel follow-up adds new evidence.",
"items": {
"type": "number",
"minimum": 0
},
"minItems": 1,
"maxItems": 4
}
},
"required": [
"export_id",
"expected_render_generation",
"expected_render_plan_hash",
"times"
],
"additionalProperties": false
},
"annotations": {
"title": "Sample pixels from the exact current Export",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
},
"securitySchemes": [
{
"type": "noauth"
}
],
"_meta": {
"securitySchemes": [
{
"type": "noauth"
}
]
},
"outputSchema": {
"type": "object",
"properties": {
"export_id": {
"type": "string",
"description": "Exact Export sampled."
},
"clip_id": {
"type": "string",
"description": "Composition handle of the Clip or Episode that owns this Export."
},
"composition_id": {
"type": "string",
"description": "Same Composition handle as clip_id."
},
"render_generation": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "Exact generation sampled."
},
"render_plan_hash": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "Exact render-plan hash sampled."
},
"duration_seconds": {
"type": "number",
"description": "Export timeline duration."
},
"model_image_count": {
"type": "integer",
"description": "Number of adjacent JPEG image blocks; at most four."
},
"custody": {
"type": "string",
"enum": [
"tool_use_only"
],
"description": "Frames exist only for this tool turn. They mint no capability URLs."
},
"limitations": {
"type": "string",
"description": "Exact retained Export frames establish only the content of each sampled still, including burned overlays and captions at that instant. A sampled still shows only literal visible content at that sampled instant; a visible anomaly in it is a candidate for further review. A still alone does not establish an objective Export or renderer defect, its cause, a violated invariant, or overall quality. Those conclusions require independently bound temporal or implementation evidence, or human review. Program structure, sampled still pixels, decoded temporal artifact evidence, implementation evidence, and human judgment are distinct evidence classes. Not observable from isolated stills: motion, transition smoothness, cut abruptness or naturalness, caption synchronization or correctness across time, audio, overall taste, and human acceptance. A still inspection pass is one bounded 1–4-frame board; identical or subset points in the same user turn repeat evidence already held, and at most one explicitly novel follow-up adds new evidence. For a short multi-cut Export, retained inspection includes the opening picture, the near-EOF final picture, and both sides of every render_status-flagged Junction. When four frames cannot cover that set, the allowed novel follow-up covers the rest. A seam-only board leaves endpoint inspection incomplete and cannot support a quality-ready or finished claim. Render-ready remains lifecycle state. Tool-use-only custody; no capability URLs."
},
"frames": {
"type": "array",
"description": "Per-frame Export-timeline captions and dimensions. Adjacent MCP image blocks are the pixels; no gallery or capability URLs.",
"items": {
"type": "object",
"properties": {
"caption": {
"type": "string",
"description": "Truthful Export-timeline caption bound to this export, generation, and plan. Each still establishes only that frame's pixels; isolated stills cannot observe motion, cut abruptness, or caption synchronization across time. A sampled still shows only literal visible content at that sampled instant; a visible anomaly in it is a candidate for further review. A still alone does not establish an objective Export or renderer defect, its cause, a violated invariant, or overall quality. Those conclusions require independently bound temporal or implementation evidence, or human review. Program structure, sampled still pixels, decoded temporal artifact evidence, implementation evidence, and human judgment are distinct evidence classes."
},
"export_seconds": {
"type": "number"
},
"export_timecode": {
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"mime_type": {
"type": "string",
"enum": [
"image/jpeg"
]
}
},
"required": [
"caption",
"export_seconds",
"export_timecode",
"width",
"height",
"mime_type"
]
}
}
},
"required": [
"export_id",
"clip_id",
"composition_id",
"render_generation",
"render_plan_hash",
"duration_seconds",
"model_image_count",
"custody",
"limitations",
"frames"
],
"additionalProperties": false
}
}Live Workspace descriptor
{
"name": "export_sample_frames",
"title": "Sample pixels from the exact current Export",
"description": "Pure-read pixel inspection of one exact rendered Export MP4, including burned overlays and captions. Requires the exact export_id, expected_render_generation, and expected_render_plan_hash from render_status plus 1–4 finite nonnegative Export-timeline seconds. This does not settle status, mint URLs, publish frames, bill, render, or mutate. Exact retained Export frames establish only the content of each sampled still, including burned overlays and captions at that instant. A sampled still shows only literal visible content at that sampled instant; a visible anomaly in it is a candidate for further review. A still alone does not establish an objective Export or renderer defect, its cause, a violated invariant, or overall quality. Those conclusions require independently bound temporal or implementation evidence, or human review. Program structure, sampled still pixels, decoded temporal artifact evidence, implementation evidence, and human judgment are distinct evidence classes. Not observable from isolated stills: motion, transition smoothness, cut abruptness or naturalness, caption synchronization or correctness across time, audio, overall taste, and human acceptance. A still inspection pass is one bounded 1–4-frame board; identical or subset points in the same user turn repeat evidence already held, and at most one explicitly novel follow-up adds new evidence. For a short multi-cut Export, retained inspection includes the opening picture, the near-EOF final picture, and both sides of every render_status-flagged Junction. When four frames cannot cover that set, the allowed novel follow-up covers the rest. A seam-only board leaves endpoint inspection incomplete and cannot support a quality-ready or finished claim. Render-ready remains lifecycle state. Tool-use-only custody; no capability URLs. render_status observes no pixels. Frames are tool-use-only; no capability URLs.",
"inputSchema": {
"type": "object",
"properties": {
"export_id": {
"type": "string",
"description": "Exact retained Export handle (rxpt_...) from render_status or result delivery. Foreign handles fail closed and no handle redirects to another generation."
},
"expected_render_generation": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "Exact 64-hex current render generation for this Export. A mismatch fails closed."
},
"expected_render_plan_hash": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "Exact 64-hex current render-plan hash for this Export. A mismatch fails closed."
},
"times": {
"type": "array",
"description": "Explicit Export-timeline seconds to sample from the finished MP4. A still inspection pass is one bounded 1–4-frame board; identical or subset points in the same user turn repeat evidence already held. One through four finite nonnegative values only. At most one explicitly novel follow-up adds new evidence.",
"items": {
"type": "number",
"minimum": 0
},
"minItems": 1,
"maxItems": 4
}
},
"required": [
"export_id",
"expected_render_generation",
"expected_render_plan_hash",
"times"
],
"additionalProperties": false
},
"annotations": {
"title": "Sample pixels from the exact current Export",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
},
"securitySchemes": [
{
"type": "noauth"
}
],
"_meta": {
"securitySchemes": [
{
"type": "noauth"
}
]
},
"outputSchema": {
"type": "object",
"properties": {
"export_id": {
"type": "string",
"description": "Exact Export sampled."
},
"clip_id": {
"type": "string",
"description": "Composition handle of the Clip or Episode that owns this Export."
},
"composition_id": {
"type": "string",
"description": "Same Composition handle as clip_id."
},
"render_generation": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "Exact generation sampled."
},
"render_plan_hash": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "Exact render-plan hash sampled."
},
"duration_seconds": {
"type": "number",
"description": "Export timeline duration."
},
"model_image_count": {
"type": "integer",
"description": "Number of adjacent JPEG image blocks; at most four."
},
"custody": {
"type": "string",
"enum": [
"tool_use_only"
],
"description": "Frames exist only for this tool turn. They mint no capability URLs."
},
"limitations": {
"type": "string",
"description": "Exact retained Export frames establish only the content of each sampled still, including burned overlays and captions at that instant. A sampled still shows only literal visible content at that sampled instant; a visible anomaly in it is a candidate for further review. A still alone does not establish an objective Export or renderer defect, its cause, a violated invariant, or overall quality. Those conclusions require independently bound temporal or implementation evidence, or human review. Program structure, sampled still pixels, decoded temporal artifact evidence, implementation evidence, and human judgment are distinct evidence classes. Not observable from isolated stills: motion, transition smoothness, cut abruptness or naturalness, caption synchronization or correctness across time, audio, overall taste, and human acceptance. A still inspection pass is one bounded 1–4-frame board; identical or subset points in the same user turn repeat evidence already held, and at most one explicitly novel follow-up adds new evidence. For a short multi-cut Export, retained inspection includes the opening picture, the near-EOF final picture, and both sides of every render_status-flagged Junction. When four frames cannot cover that set, the allowed novel follow-up covers the rest. A seam-only board leaves endpoint inspection incomplete and cannot support a quality-ready or finished claim. Render-ready remains lifecycle state. Tool-use-only custody; no capability URLs."
},
"frames": {
"type": "array",
"description": "Per-frame Export-timeline captions and dimensions. Adjacent MCP image blocks are the pixels; no gallery or capability URLs.",
"items": {
"type": "object",
"properties": {
"caption": {
"type": "string",
"description": "Truthful Export-timeline caption bound to this export, generation, and plan. Each still establishes only that frame's pixels; isolated stills cannot observe motion, cut abruptness, or caption synchronization across time. A sampled still shows only literal visible content at that sampled instant; a visible anomaly in it is a candidate for further review. A still alone does not establish an objective Export or renderer defect, its cause, a violated invariant, or overall quality. Those conclusions require independently bound temporal or implementation evidence, or human review. Program structure, sampled still pixels, decoded temporal artifact evidence, implementation evidence, and human judgment are distinct evidence classes."
},
"export_seconds": {
"type": "number"
},
"export_timecode": {
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"mime_type": {
"type": "string",
"enum": [
"image/jpeg"
]
}
},
"required": [
"caption",
"export_seconds",
"export_timecode",
"width",
"height",
"mime_type"
]
}
}
},
"required": [
"export_id",
"clip_id",
"composition_id",
"render_generation",
"render_plan_hash",
"duration_seconds",
"model_image_count",
"custody",
"limitations",
"frames"
],
"additionalProperties": false
}
}Errors
[
"invalid_input",
"time_out_of_range",
"export_not_found",
"export_not_current",
"render_changed",
"render_output_unavailable",
"ffmpeg_busy",
"ffmpeg_missing",
"export_sample_timeout",
"frame_extraction_failed",
"frame_extraction_containment_unknown",
"frame_sample_cleanup_failed",
"payload_budget_exceeded"
]Examples
[
{
"label": "Inspect two points on the exact current Export",
"input": {
"export_id": "rxpt_...",
"expected_render_generation": "0000000000000000000000000000000000000000000000000000000000000000",
"expected_render_plan_hash": "0000000000000000000000000000000000000000000000000000000000000000",
"times": [
0,
1.2
]
}
}
]