Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > MiniMaxH3-Studio > H3 Full Reference Timeline Producer

ComfyUI Node: H3 Full Reference Timeline Producer

Class Name

comfyui_h3_context.H3Context.FullReferenceTimelineProducer

Category
h3_context/assembly
Author
rookiestar28 (Account age: 1077days)
Extension
MiniMaxH3-Studio
Latest Updated
2026-11-05
Github Stars
0.16K

How to Install MiniMaxH3-Studio

Install this extension via the ComfyUI Manager by searching for MiniMaxH3-Studio
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter MiniMaxH3-Studio in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

H3 Full Reference Timeline Producer Description

Builds partial reference timelines from qualified CFR video observations, flagging missing data.

H3 Full Reference Timeline Producer:

The H3 Full Reference Timeline Producer is an assembly-stage node that builds a partial reference timeline from qualified video observations. Its purpose is to organize supported visual observations into a time-based representation that later H3 processing stages can use, while keeping unavailable perception distinguishable from a usable result. The node specifically supports qualified observations from decoded constant-frame-rate (CFR) video, meaning video frames decoded on a regular timing basis. Despite “Full Reference” in its name, the documented capability is partial timeline construction, not a guarantee of complete coverage of every reference or moment. When qualified perception is missing, it retains an explicit unavailable fallback rather than inventing timeline content. This makes it useful when you need reference-based planning that remains clear about the limits of the available visual evidence.

H3 Full Reference Timeline Producer Input Parameters:

request

Required connection of type H3_CONTEXT_REQUEST, represented internally as a RawContextRequest. This supplies the context request associated with the timeline operation and is passed into the downstream producer together with the reference and analysis data. It also participates in the provenance information used by the unavailable fallback report, helping associate that report with the request being processed. The supplied code does not expose the request’s internal fields or show how individual request settings affect timeline construction. No default, minimum, maximum, or selectable options are declared for this socket.

reference_registry

Required connection of type H3_REFERENCE_REGISTRY, represented internally as a ReferenceRegistry. This provides the reference registry associated with the request, giving the timeline stage its reference context alongside the media and analytical data. It is passed into the producer and included among the source objects associated with the unavailable fallback report. The supplied code does not show the registry’s internal structure or reference-selection rules, so you should not treat this socket as a direct control for choosing frame ranges or timeline duration. No default, minimum, maximum, or selectable options are declared.

media

Required connection of type H3_MEDIA_PRODUCER_RESULT, represented internally as a PerceptionProducerResult. This carries the media producer’s structured result into the timeline stage; it is not declared as a standard ComfyUI image, video, or file-path input. It provides part of the upstream context used by the producer and its fallback reporting. Connecting this required result alone does not establish qualified visual perception: the node description explicitly calls for a qualified visual result to enable its partial-timeline capability. No default, minimum, maximum, or selectable options are declared.

evidence_graph

Required connection of type H3_UNIFIED_EVIDENCE_GRAPH, represented internally as a UnifiedEvidenceGraph. This supplies the unified evidence structure associated with the timeline request, so the producer receives the upstream evidence context rather than only the media result. The supplied implementation forwards this object to the downstream producer and includes it in the unavailable report’s source context, but does not reveal rules for translating individual evidence items into timeline entries. Connect the evidence graph belonging to the same processing context as your other inputs. No default, minimum, maximum, or selectable options are declared.

evidence_report

Required connection of type H3_DOWNSTREAM_PRODUCER_REPORT, represented internally as a DownstreamProducerReport. This supplies the producer report associated with the evidence stage, accompanying evidence_graph with that stage’s reporting information. It is forwarded into the timeline producer, although the supplied excerpt does not show the specific checks performed on its contents. Because several sockets share this report type, the socket type alone does not distinguish an evidence report from another stage’s report; connect the report produced alongside your evidence graph. No default, minimum, maximum, or selectable options are declared.

cross_reference_graph

Required connection of type H3_CROSS_REFERENCE_GRAPH, represented internally as a CrossReferenceGraph. This provides the cross-reference structure associated with the request, supplying relationship context alongside the unified evidence and reference registry. The object is forwarded into the timeline producer and participates in the source context of the unavailable fallback report. The supplied code does not document its internal relationships or how they influence individual timeline entries, so it should be treated as an upstream structured result rather than a manual timeline-editing control. No default, minimum, maximum, or selectable options are declared.

cross_reference_report

Required connection of type H3_DOWNSTREAM_PRODUCER_REPORT, represented internally as a DownstreamProducerReport. This carries the report associated with the cross-reference stage and is passed into the producer alongside cross_reference_graph. It supplies stage-reporting context, but the provided implementation does not expose the exact conditions under which its contents affect acceptance or timeline construction. Connect the report corresponding to your cross-reference graph, rather than an unrelated report that happens to use the same socket type. No default, minimum, maximum, or selectable options are declared.

directive_authority

Required connection of type H3_DIRECTIVE_AUTHORITY, represented internally as a DirectiveAuthorityBundle. This supplies the directive-authority data associated with the current request, providing the timeline stage with the upstream representation of directive authority. It is forwarded into the producer and included in the source context recorded by the unavailable fallback. The supplied code does not expose directive priorities, conflict-resolution rules, or editable authority settings, so those behaviors cannot be specified from this excerpt. No default, minimum, maximum, or selectable options are declared.

directive_report

Required connection of type H3_DOWNSTREAM_PRODUCER_REPORT, represented internally as a DownstreamProducerReport. This supplies the producer report accompanying the directive-authority stage. It is passed to the timeline producer together with directive_authority, allowing that stage’s reporting information to travel with its structured result. The excerpt does not show which report conditions are checked during qualified timeline production. Use the report associated with the connected directive-authority bundle. No default, minimum, maximum, or selectable options are declared.

intent_graph

Required connection of type H3_INTENT_GRAPH, represented internally as an IntentGraph. This supplies the upstream intent structure for the timeline operation, alongside the evidence, cross-reference, and directive context. The producer receives this object, and the unavailable fallback includes it among the objects associated with its report. The supplied code does not reveal the graph’s fields or rules for converting intent into timeline decisions; this socket is therefore a structured upstream dependency, not a direct prompt or timing control. No default, minimum, maximum, or selectable options are declared.

intent_report

Required connection of type H3_DOWNSTREAM_PRODUCER_REPORT, represented internally as a DownstreamProducerReport. This carries the producer report associated with the intent stage and is forwarded alongside intent_graph. It provides the corresponding stage-reporting context, although the supplied excerpt does not document its detailed validation or effect on timeline content. Connect the report produced for the intent graph you are using, especially because the other report sockets accept the same declared type. No default, minimum, maximum, or selectable options are declared.

visual_result

Optional connection of type H3_VISUAL_PRODUCER_RESULT, represented internally as a QualifiedPerceptionResult when present. This is the key connection for enabling the node’s documented partial-timeline capability: it should provide qualified decoded-CFR video observations. Although optional in the socket schema, its absence leaves the node without the qualified perception required for that capability. Validation recognizes a correctly typed connection or a supplied non-None value, but the source comments make clear that execution still verifies internal authority; simply attaching an arbitrary object does not prove qualification. The execution default is None. No numeric minimum, maximum, or selectable options are declared.

H3 Full Reference Timeline Producer Output Parameters:

timeline

Output of type H3_FULL_REFERENCE_TIMELINE, represented internally as a FullReferenceTimelineResult. This is a structured timeline result, not rendered video or an image sequence. With suitable qualified perception, the node is documented to support a partial timeline based on decoded-CFR video observations. The supplied excerpts do not show the successful result’s field layout, timing units, or coverage guarantees. In the explicitly shown unavailable fallback, the result is constructed with two None values and an error diagnostic identifying unavailable perception for full_reference_timeline. Interpret that fallback as the absence of a usable timeline, not as a successful empty timeline, and inspect the accompanying report before relying on it downstream.

producer_report

Output of type H3_DOWNSTREAM_PRODUCER_REPORT, represented internally as a DownstreamProducerReport. This reports the outcome of the full-reference timeline production stage, giving you a way to distinguish an unavailable operation from a usable result. In the shown fallback, the stage is FULL_REFERENCE_TIMELINE, the disposition is UNAVAILABLE, and the reason is identified by PERCEPTION_PROFILE_UNAVAILABLE. The report also associates the outcome with upstream context objects, including the request, registry, media, evidence, cross-reference, directives, and intent. These names are code identifiers shown in the source; the excerpt does not provide every serialized value or the exact human-readable reason message.

H3 Full Reference Timeline Producer Usage Tips:

  • Connect visual_result when you want the qualified partial-timeline capability. Its optional socket status does not mean the node can build that timeline without qualified perception.
  • Use qualified decoded-CFR video observations from the appropriate H3 perception workflow. A generic image, video object, or manually relabeled connection is not equivalent to a qualified H3_VISUAL_PRODUCER_RESULT.
  • Keep the request, registry, media, graphs, authority bundle, and reports together from the same processing context. This is a practical way to avoid mixing unrelated upstream results; the supplied excerpt does not specify every consistency check.
  • Match each report to its corresponding stage. In particular, evidence_report, cross_reference_report, directive_report, and intent_report all accept the same socket type, so type compatibility alone cannot help you identify an accidentally swapped report.
  • Inspect producer_report before treating timeline as usable. The node can return a structured result that explicitly represents unavailable perception rather than a completed timeline.
  • Plan for partial coverage. The documented capability does not promise a complete timeline for all reference material, even though the node’s name includes “Full Reference.”
  • Configure video decoding and perception upstream. This node exposes no frame-rate, sampling, duration, quality, or performance widgets, so there are no local numeric settings to tune for those tasks.

H3 Full Reference Timeline Producer Common Errors and Solutions:

linked_input_type_mismatch

  • Explanation: This exact validation string is returned when supplied linked-input metadata is not a dictionary, contains non-string names or type values, refers to an undeclared input, or specifies a type that does not exactly match the socket’s declared type. Validation checks every linked socket, not just visual_result.
  • Solution: Reconnect each input to an output with the exact declared H3 socket type. If your workflow is generated or modified programmatically, ensure that input names and linked type strings match the node interface exactly, and remove obsolete or unknown input names.

PERCEPTION_PROFILE_UNAVAILABLE

  • Explanation: This is the reason-code identifier shown for the unavailable fallback, not a confirmed literal human-readable error message. The fallback creates an error diagnostic and an UNAVAILABLE producer report when the qualified perception needed for the timeline is unavailable. A connected media result alone does not establish that qualification.
  • Solution: Supply a qualified H3_VISUAL_PRODUCER_RESULT through visual_result and check the upstream perception stage if it cannot produce one. If qualified perception is not available in your workflow, treat this stage as unavailable rather than expecting a timeline from the remaining required inputs.

Qualified timeline capability is not established during validation

  • Explanation: This is a descriptive condition rather than an exact error string supplied in the excerpt. The validation hook selects the unavailable capability when it sees neither a non-None visual result nor a correctly typed visual_result link. The exact validation message returned by the capability object is not shown.
  • Solution: Connect the qualified visual producer’s result to visual_result and validate the workflow again. If you are assembling the workflow through code, preserve the declared socket type instead of substituting a generic media type.

A correctly typed visual connection does not establish runtime qualification

  • Explanation: This is a troubleshooting condition, not a quoted error message. The source explicitly distinguishes accepting a linked placeholder during validation from proving internal authority during execution. A connection can therefore satisfy the visible type check without that alone proving that its eventual contents are qualified; the excerpt does not show the exact runtime diagnostic for this situation.
  • Solution: Use the original result from the appropriate qualified H3 perception stage rather than a fabricated or manually converted object. Check that upstream result and the returned producer_report for available diagnostic information before attempting downstream timeline processing.

H3 Full Reference Timeline Producer Related Nodes

Go back to the extension to check out more related nodes.
MiniMaxH3-Studio
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

H3 Full Reference Timeline Producer