@melite/models-h3 0.2.0-alpha → 0.2.2-alpha

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -146,9 +146,11 @@ export interface MaskedChainSeat {
146
146
  readonly assemble: ChainAssembleSeat | null;
147
147
  }
148
148
  /** The spine's returned handles: the loop-trimmed window (the seat's
149
- * file join consumes its streams) and, when assembled, the
150
- * ChainAssemble node's video_path (the assembled film's absolute
151
- * path — the compose join's append member). */
149
+ * file join consumes its streams), the ChainAssemble node's video_path
150
+ * when the seat assembles, and the plan node's own width/height — the
151
+ * shot geometry every window renders at, engine-derived from the
152
+ * source frames (the seat-side consumer is the extend seat's raw
153
+ * prior join, the F34 shape-true cure). */
152
154
  export interface ChainRender {
153
155
  /** MiniMaxH3LoopTrim — out(0) frames, out(1) audio, out(2) the
154
156
  * with-overlap images. */
@@ -157,6 +159,13 @@ export interface ChainRender {
157
159
  };
158
160
  /** ChainAssemble's video_path when the seat assembles; else null. */
159
161
  readonly assemblePath: OutputHandle | null;
162
+ /** THE CHAIN PLAN'S SHOT GEOMETRY (the F34 cure): the plan node's
163
+ * width/height outputs — the canvas the chain renders, derived by
164
+ * the engine from the source's own frames under the stated tier. */
165
+ readonly planShape: {
166
+ width: OutputHandle;
167
+ height: OutputHandle;
168
+ };
160
169
  }
161
170
 
162
171
 
package/lib/chainEdit.js CHANGED
@@ -314,8 +314,9 @@ export function renderMaskedEditChain(g, seat) {
314
314
  // ── the terminal: ChainAssemble when the seat assembles in-chain
315
315
  // (the latent-seam machinery — blend_schedule 'plan' rides the
316
316
  // policy's own overlaps); null when the seat joins by file. ──
317
- if (seat.assemble === null)
318
- return { trimmed, assemblePath: null };
317
+ if (seat.assemble === null) {
318
+ return { trimmed, assemblePath: null, planShape: { width: plan.out(1), height: plan.out(2) } };
319
+ }
319
320
  const assemble = g.node('MiniMaxH3ChainAssemble', {
320
321
  audio_source: seat.assemble.audioSource,
321
322
  filename: seat.assemble.filename,
@@ -325,6 +326,9 @@ export function renderMaskedEditChain(g, seat) {
325
326
  generated_audio_join: 'av_overlap',
326
327
  manifest: loopEnd.out(0),
327
328
  });
328
- return { trimmed, assemblePath: assemble.out(0) };
329
+ return {
330
+ trimmed, assemblePath: assemble.out(0),
331
+ planShape: { width: plan.out(1), height: plan.out(2) },
332
+ };
329
333
  }
330
334
  //# sourceMappingURL=chainEdit.js.map
package/lib/extend.d.ts CHANGED
@@ -1,6 +1,14 @@
1
1
  import type { GraphBuilder } from '@melite/comfyui-card-kit/graph';
2
2
  import type { H3Facts } from './actions.js';
3
3
  export { solveWindowComposition, type WindowComposition } from './timelineContract.js';
4
+
5
+
6
+
7
+
8
+
9
+
10
+
11
+ export declare const LAST_FRAME_BATCH_INDEX = 16384;
4
12
  /** The extend renderer: validates the bound entry, then composes the
5
13
  * fresh-continuation chain plus the join. Like the swap and repair,
6
14
  * the film path never reaches here (the card branches on a non-empty
package/lib/extend.js CHANGED
@@ -2,6 +2,14 @@ import { chainSaveBoundaries, concatSavedFilms, filmJoinAudio } from './actions.
2
2
  import { assertGridLength, solveWindowComposition, CONTEXT_OVERLAP_FRAMES, GRID_MAX_FRAMES, } from './timelineContract.js';
3
3
  export { solveWindowComposition } from './timelineContract.js';
4
4
  import { loadVideo, renderMaskedEditChain } from './chainEdit.js';
5
+
6
+
7
+
8
+
9
+
10
+
11
+
12
+ export const LAST_FRAME_BATCH_INDEX = 16384;
5
13
  /** The extend entry's required seats (the reshoot/repair idiom: an
6
14
  * armed doc with an empty seat refuses loud naming the seat). */
7
15
  const REQUIRED_SEATS = [
@@ -53,10 +61,11 @@ export function renderH3Extend(entry, p, facts, g, runId) {
53
61
  const clipSeconds = composition.windowFrames / 24;
54
62
  // ── the staged media: the WHOLE prior clip on the VHS seat
55
63
  // (force_rate 24 — the one clock) and its LAST FRAME as the
56
- // in-graph anchor (negative batch index, engine core) ──
64
+ // in-graph anchor (a positive out-of-band index the engine clamps
65
+ // to the final row — see LAST_FRAME_BATCH_INDEX) ──
57
66
  const [priorFrames, priorAudio] = loadVideo(g, str(entry, 'source_clip'));
58
67
  const lastFrame = g.node('ImageFromBatch', {
59
- image: priorFrames, batch_index: -1, length: 1,
68
+ image: priorFrames, batch_index: LAST_FRAME_BATCH_INDEX, length: 1,
60
69
  }).out(0);
61
70
  // ── THE SEAT'S OWN PLAN (clause 3): N continuation shots — the
62
71
  // literal rules, plan_json_input stays UNWIRED (the plan node's
@@ -66,7 +75,7 @@ export function renderH3Extend(entry, p, facts, g, runId) {
66
75
  id: `extend-${i + 1}`, prompt: str(entry, 'extend_prompt'),
67
76
  }));
68
77
  const planJson = JSON.stringify({ shots });
69
- const { trimmed, assemblePath } = renderMaskedEditChain(g, {
78
+ const { trimmed, assemblePath, planShape } = renderMaskedEditChain(g, {
70
79
  p, facts,
71
80
  clipSeconds,
72
81
  overlapFrames,
@@ -126,9 +135,47 @@ export function renderH3Extend(entry, p, facts, g, runId) {
126
135
  mask_conversion: 'H3 exact (causal/token max)',
127
136
  target_latent: edit, mask: whiteMask,
128
137
  }).out(0);
129
- return { conditioning: r2v.out(0), targetLatent: target };
138
+
139
+ // ref_image ride above is a SOFT prior — the model is free to
140
+ // introduce new content in the appended clip's FIRST frame, and
141
+ // the poncho burn did exactly that (a second figure at full
142
+ // size on the first extended frame: a hard pop, no entry). Pin
143
+ // the source's LAST frame at frame_idx 0 through the same
144
+ // H3-native guide lane the reshoot pins its warp with
145
+ // (MiniMaxH3AddGuide, one frame → guide_frames 1): the first
146
+ // appended frame is then FORCED to be the clip's last frame,
147
+ // so anything new must develop from it frame by frame instead
148
+ // of appearing whole.
149
+ const guided = g.node('MiniMaxH3AddGuide', {
150
+ positive: r2v.out(0),
151
+ vae: vaeVideo,
152
+ latent: target,
153
+ image: lastFrame,
154
+ frame_idx: 0,
155
+ }).out(0);
156
+ return { conditioning: guided, targetLatent: target };
130
157
  },
131
158
  });
159
+
160
+ // run-89976b95026b-8f22c399): the raw prior joins the chain's
161
+ // output at the CHAIN PLAN'S OWN SHOT GEOMETRY — the plan node
162
+ // derives the canvas from the SOURCE'S OWN FRAMES (its aspect)
163
+ // under the stated tier, so an extension whose tier short edge
164
+ // differs from the prior's own (the burn: a 1344×768 source under
165
+ // the default 736p tier rendered the extension at 1280×736 and the
166
+ // engine's concat refused `Expected size 768 but got size 736`)
167
+ // aligns HERE instead of crashing mid-render. The canvas is read
168
+ // off the plan's own width/height outputs — never assumed from a
169
+ // declared width/height row — and nearest-exact keeps the align
170
+ // pixel-verbatim when the plan canvas already equals the source's
171
+ // own (the extension never rewrites history). ──
172
+ const alignedPrior = g.node('ImageScale', {
173
+ image: priorFrames,
174
+ width: planShape.width,
175
+ height: planShape.height,
176
+ upscale_method: 'nearest-exact',
177
+ crop: 'disabled',
178
+ }).out(0);
132
179
  // ── THE JOIN (the file-join primitive; the initial raw boundary
133
180
  // is the exception the latent carry cannot cross — clause 4) ──
134
181
  if (assemblePath !== null) {
@@ -139,7 +186,7 @@ export function renderH3Extend(entry, p, facts, g, runId) {
139
186
  // saved-file path (ChainAssemble's video_path output, wired:
140
187
  // the DAG itself proves the assembly completed before the join).
141
188
  const priorCreated = g.node('CreateVideo', {
142
- images: priorFrames, audio: filmJoinAudio(g, priorAudio), fps: 24, bit_depth: 8,
189
+ images: alignedPrior, audio: filmJoinAudio(g, priorAudio), fps: 24, bit_depth: 8,
143
190
  });
144
191
  const priorSaved = g.node('SaveVideo', {
145
192
  video: priorCreated.out(), filename_prefix: `${runId}/x0`,
@@ -162,7 +209,7 @@ export function renderH3Extend(entry, p, facts, g, runId) {
162
209
  format: 'mp4', codec: 'h264',
163
210
  }).out();
164
211
  const priorCreated = g.node('CreateVideo', {
165
- images: priorFrames, audio: filmJoinAudio(g, priorAudio), fps: 24, bit_depth: 8,
212
+ images: alignedPrior, audio: filmJoinAudio(g, priorAudio), fps: 24, bit_depth: 8,
166
213
  });
167
214
  const priorSaved = g.node('SaveVideo', {
168
215
  video: priorCreated.out(), filename_prefix: `${runId}/x0`,
package/lib/filmMix.d.ts CHANGED
@@ -12,8 +12,10 @@ export interface FilmMixClip {
12
12
  }
13
13
  /** Parse raw audio_clips rows — the card's one law for what a clip
14
14
  * IS: a src without a numeric start_frame refuses loud (never a
15
- * silent misplacement); a row without src is junk and skips; the
16
- * class auto law (text → dialogue, textless → music) rides here. */
15
+ * silent misplacement); a row that states anything without src
16
+ * refuses loud (never a silent phantom row); only the contentless
17
+ * row (no stated key at all) is junk and skips; the class auto law
18
+ * (text → dialogue, textless → music) rides here. */
17
19
  export declare function parseFilmMixClips(rows: readonly unknown[]): FilmMixClip[];
18
20
  /** One window's doc span + seam for the owner map. */
19
21
  export interface FilmMixSpan {
package/lib/filmMix.js CHANGED
@@ -20,8 +20,10 @@ import { DOC_FPS_DEFAULT, spanOverlap, spanStanzaFrames } from './timelineContra
20
20
  export { spanOverlap, spanStanzaFrames } from './timelineContract.js';
21
21
  /** Parse raw audio_clips rows — the card's one law for what a clip
22
22
  * IS: a src without a numeric start_frame refuses loud (never a
23
- * silent misplacement); a row without src is junk and skips; the
24
- * class auto law (text → dialogue, textless → music) rides here. */
23
+ * silent misplacement); a row that states anything without src
24
+ * refuses loud (never a silent phantom row); only the contentless
25
+ * row (no stated key at all) is junk and skips; the class auto law
26
+ * (text → dialogue, textless → music) rides here. */
25
27
  export function parseFilmMixClips(rows) {
26
28
  const clips = [];
27
29
  // THE ROW-LEVEL NUMERIC RESTORE (attempt-035's wire family, the
@@ -49,6 +51,19 @@ export function parseFilmMixClips(rows) {
49
51
  if (positioned) {
50
52
  throw new Error('audio_clips: a positioned clip row has no src — the film mix cannot place a source-less row');
51
53
  }
54
+ // THE SOURCE-LESS ROW LAW (F3-06, R-P3-16): the old whitelist
55
+ // refused only six "positioning" keys and let every OTHER
56
+ // stated key take the silent `continue` — {gain: 0.5} beside a
57
+ // lawful film COMPOSED as a phantom no-op (the run completed,
58
+ // the row performed nothing, nothing said so). A row that
59
+ // states ANYTHING and carries no src places nothing and mixes
60
+ // nothing: refuse it in its own voice. The blank law stays the
61
+ // only tolerance — a row with NO stated key is still skippable
62
+ // authoring junk.
63
+ const stated = Object.keys(row).some((k) => row[k] !== undefined);
64
+ if (stated) {
65
+ throw new Error('audio_clips: a clip row has no src — the film mix cannot mix a source-less row; state src or drop the row');
66
+ }
52
67
  continue;
53
68
  }
54
69
  if (typeof row.start_frame !== 'number' || !Number.isFinite(row.start_frame)) {
package/lib/finalize.js CHANGED
@@ -17,9 +17,14 @@ export const H3_T4_STRIP = {
17
17
  'attention_mode', 'blocks_to_swap', 'cache_model', 'offload_device',
18
18
  'swap_io_components'
19
19
  ],
20
+ // decode_tiled is NOT stripped: the SR decode's memory law states
21
+ // it (a 90-frame 1080p decode OOM'd the estate card in one pass),
22
+ // and a strip entry would delete the law on the t4 lane — the very
23
+ // lane the final press derives. The sizes/overlap stay stripped:
24
+ // the node's own declared defaults own them.
20
25
  SeedVR2LoadVAEModel: [
21
26
  'cache_model', 'decode_tile_overlap', 'decode_tile_size',
22
- 'decode_tiled', 'encode_tile_overlap', 'encode_tile_size',
27
+ 'encode_tile_overlap', 'encode_tile_size',
23
28
  'encode_tiled', 'offload_device', 'tile_debug'
24
29
  ],
25
30
  SeedVR2VideoUpscaler: [
package/lib/index.d.ts CHANGED
@@ -5,8 +5,8 @@ export declare const family: Plugin;
5
5
  export { finalizeH3, H3_T4_STRIP } from "./finalize.js";
6
6
  export { renderH3Swap } from "./swap.js";
7
7
  export { renderH3Repair } from "./repair.js";
8
- export { renderH3Extend } from "./extend.js";
9
- export { refineArmed, renderH3Refine, renderH3RefineWindow, renderH3RefineWindows, refineWindowCount, refineWindowStarts, REFINE_UPSCALE_MODEL, REFINE_2X_OOM_FRAMES, REFINE_DEFAULT_CLIP_SECONDS } from "./refine.js";
8
+ export { renderH3Extend, LAST_FRAME_BATCH_INDEX } from "./extend.js";
9
+ export { refineArmed, renderH3Refine, renderH3RefineBag, renderH3RefineCarry, renderH3RefineWindow, renderH3RefineWindows, refineWindowCount, refineWindowStarts, tokenExactCarry, nextTokenExact, lawfulCarryStart, REFINE_UPSCALE_MODEL, REFINE_2X_OOM_FRAMES, REFINE_DEFAULT_CLIP_SECONDS, REFINE_DEFAULT_OVERLAP_FRAMES } from "./refine.js";
10
10
  export { refinePlaneSchema, REFINE_PLANE_KEYS } from "./schema.js";
11
11
  export { MAX_COMPOSED_WINDOWS, SEAM_OVERLAP_FRAMES } from "./timelineContract.js";
12
12
  export type { RefineWindowSeat } from "./refine.js";
package/lib/index.js CHANGED
@@ -182,11 +182,16 @@ export const DECL = {
182
182
  ]
183
183
  },
184
184
 
185
- // Larry + LightX2V dareties merge — preferred for detail at 8
186
- // steps; the standalone LightX2V turbos stay in the catalog for
187
- // the audio/dialogue routes). The artifact is silveroxides'
188
- // `minimax_h3_fl2v_lightx2v_turbo_4to8step_v0.1-v1.0_768p_v4_step600_dareties.safetensors`
189
- // (catalog row h3_lightx2v_turbo, provisioned below with its sha).
185
+ // lora to the silveroxides merge" — SILVEROXIDES IS THE MERGE,
186
+ // LIGHTX2V IS NOT). The artifact is silveroxides' OFFICIAL
187
+ // `minimax_h3_fl2v_turbo_silver_dareties_comfy_pruned_v2.safetensors`
188
+ // (silver_official_releases/; catalog row h3_silver_dareties,
189
+ // labelled "Silveroxides DARE-TIES Merge", provisioned below
190
+
191
+ // experimental/ LightX2V-turbo × dareties file (row
192
+ // h3_lightx2v_turbo) as "the merge" — the F34b class again: a
193
+ // merge the catalog never held; that row stays PICK-ONLY under
194
+ // its honest experimental label.
190
195
 
191
196
 
192
197
 
@@ -202,33 +207,34 @@ export const DECL = {
202
207
  // payload mirrors a hand pick exactly (declared keys only):
203
208
  // SELECTION ONLY (#36). STEPS IS UNSTATED BY DESIGN — the row
204
209
  // owns its married 8 (the marriage law: the bag resolves unstated
205
- // steps, so the default run takes the turbo's full count, not a
206
- // departed lora's 4); stamping steps would hard-pin what the bag
207
- // resolves. The file's door is the lane gate (lane_inputs loras +
210
+ // steps, so the default run takes the merge's full 8-step count,
211
+ // the designed 6–8 band's top — the dareties settings thread);
212
+ // stamping steps would hard-pin what the bag resolves. The
213
+ // file's door is the lane gate (lane_inputs loras +
208
214
  // the provision row below): absent on disk, the run refuses with
209
215
  // the fetch hint — the web popup's install button and the agent
210
216
  // seat both ride that one refusal.
211
217
  {
212
218
  "id": "standard",
213
219
  "label": "Standard",
214
- "hint": "The default — the Larry + LightX2V merge (dareties, 768p) at the calibrated 1344×768. Steps derive from the lora marriage (8).",
220
+ "hint": "The default — the Silveroxides DARE-TIES Merge at the calibrated 1344×768. Steps derive from the lora marriage (8).",
215
221
  "group": "Recipe",
216
222
  "wire_defaults": {
217
- "loras": [{ "id": "h3_lightx2v_turbo" }],
223
+ "loras": [{ "id": "h3_silver_dareties" }],
218
224
  },
219
225
  "cells": [],
220
226
  },
221
227
  // DRAFT (operator, this session: "for low resolution, that is
222
228
  // good for the draft recipe"): the fast iteration tier — the
223
- // same turbo bag at draft geometry 768×448. Steps stay
229
+ // same merge bag at draft geometry 768×448. Steps stay
224
230
  // unstated (the marriage law).
225
231
  {
226
232
  "id": "draft",
227
233
  "label": "Draft",
228
- "hint": "Fast iteration — the same merge bag at draft geometry (768×448). Steps derive from the lora marriage (8).",
234
+ "hint": "Fast iteration — the same Silveroxides merge bag at draft geometry (768×448). Steps derive from the lora marriage (8).",
229
235
  "group": "Recipe",
230
236
  "wire_defaults": {
231
- "loras": [{ "id": "h3_lightx2v_turbo" }],
237
+ "loras": [{ "id": "h3_silver_dareties" }],
232
238
  "width": 768,
233
239
  "height": 448,
234
240
  },
@@ -247,10 +253,10 @@ export const DECL = {
247
253
  {
248
254
  "id": "final",
249
255
  "label": "Final Cut",
250
- "hint": "The finishing pass — the merge bag plus the spec's latent handoff: 2.0× 3D latent upscale with a 0.35 refine window on the un-distilled base. Pixel super-res and interpolation stay explicit picks.",
256
+ "hint": "The finishing pass — the Silveroxides merge bag plus the spec's latent handoff: 2.0× 3D latent upscale with a 0.35 refine window on the un-distilled base. Pixel super-res and interpolation stay explicit picks.",
251
257
  "group": "Recipe",
252
258
  "wire_defaults": {
253
- "loras": [{ "id": "h3_lightx2v_turbo" }],
259
+ "loras": [{ "id": "h3_silver_dareties" }],
254
260
  "second_pass_enabled": true,
255
261
  "upscale_route": "latent_2x",
256
262
  },
@@ -286,12 +292,16 @@ export const DECL = {
286
292
 
287
293
 
288
294
 
289
- // without the file refuses through the lane gate — the web
290
- // popup's install button and the agent seat both key on that one
291
- // refusal; "that is how it works").
295
+
296
+ // DEFAULT: the operator's order "switch the default lora to the
297
+ // silveroxides merge" — the official silver_official_releases
298
+ // DARE-TIES merge, not the experimental/ LightX2V file that row
299
+ // named): a run without the file refuses through the lane gate
300
+ // — the web popup's install button and the agent seat both key
301
+ // on that one refusal; "that is how it works".
292
302
  // BARE NAME: the gate probes the provision row's own folder
293
303
  // (loras/h3) as its last leg; the row below is the fetch truth.
294
- "loras": "minimax_h3_fl2v_lightx2v_turbo_4to8step_v0.1-v1.0_768p_v4_step600_dareties.safetensors",
304
+ "loras": "minimax_h3_fl2v_turbo_silver_dareties_comfy_pruned_v2.safetensors",
295
305
  },
296
306
  // THE LANE SURFACE (the z-image precedent): exactly the knobs the
297
307
  // h3-timeline card serves — the window inputs, the shared render
@@ -301,13 +311,14 @@ export const DECL = {
301
311
  // schema.ts and this surface drops it with it, else the claim law
302
312
  // names a dead declaration the card cannot carry).
303
313
 
304
- // window-family key law in the served spelling, verbatim off the
305
- // contract module (one owner — FAMILY_LAW IS the law the walk
306
- // enforces; the served copy cannot drift, the contract wall pins
307
- // the agreement). The generic seats (composeValidate's family
308
- // clause, the studio rail's group omit) judge the t4r refusals
309
- // from this data at the gesture and at the render, one hop before
310
- // the door.
314
+
315
+ // spelling, verbatim off the contract module (one owner —
316
+ // FAMILY_LAW IS the data deriveWindowFamily walks; the served
317
+ // copy cannot drift, the contract wall pins the agreement). The
318
+ // lanes still label the studio's family readouts; deadKeys is
319
+ // EMPTY since the t4r arm gained the post chain — no finish key
320
+ // is lane-dead, so the generic composeValidate clause admits
321
+ // every key on every lane.
311
322
  "familyLaw": FAMILY_LAW,
312
323
 
313
324
  // the round-48 sampler five): every row below either rides a graph
@@ -321,7 +332,7 @@ export const DECL = {
321
332
  // sla_switch is NOT retired — the t4r arm reads it at the pick (31).
322
333
  // attention_backend → ModelAttentionBackend (16). interp/sr → the
323
334
  // FILM + SeedVR2 pairs behind the second-pass master (17);
324
- // sharpen_* → the ImageSharpenKJ grouped dict (18). refine_* → the
335
+ // sharpen_* → the ImageSharpenKJ V3 combo wires (18 + U2 ARMs 48-50). refine_* → the
325
336
  // rider loader/scheduler (4/4b/7). Media/refmod/duck/image_name →
326
337
  // 19/20/22. k → the window save name (21); noise_seed → RandomNoise
327
338
  // per stanza (2/34). STAND-DOWNS, named: fps_seconds is INTERNAL —
@@ -408,6 +419,20 @@ export const DECL = {
408
419
  "sha256": "7c1f131492e7eddacaac9069a61b81bdd39de5cc96561e677c5eab1cdce5e522",
409
420
  "size_bytes": 5207808496
410
421
  },
422
+
423
+ // lora to the silveroxides merge" — the OFFICIAL
424
+ // silver_official_releases DARE-TIES merge, pruned v2; the
425
+ // operator named this exact file: "pruned. That one is the same
426
+ // and less file size"). Digest + size: downloaded and
427
+ // sha256-verified against the HF tree API's xet lfs oid
428
+ // (d90eed1d…) — the landed bytes in both trees ARE this pin.
429
+ {
430
+ "name": "minimax_h3_fl2v_turbo_silver_dareties_comfy_pruned_v2.safetensors",
431
+ "url": "https://huggingface.co/silveroxides/MiniMax-H3_tests/resolve/main/silver_official_releases/minimax_h3_fl2v_turbo_silver_dareties_comfy_pruned_v2.safetensors",
432
+ "folder": "loras/h3",
433
+ "sha256": "d90eed1d6b29c78851a8a9332c2581fa90cd2b10b46972a2a20e817f4180dbe9",
434
+ "size_bytes": 765591085
435
+ },
411
436
  {
412
437
  "name": "minimax_h3_fl2v_lightx2v_v0.1_dareties_v4_step600_comfy_fro.safetensors",
413
438
  "url": "https://huggingface.co/silveroxides/MiniMax-H3_tests/resolve/main/minimax_h3_fl2v_lightx2v_v0.1_dareties_v4_step600_comfy_fro.safetensors",
@@ -559,8 +584,8 @@ export const family = {
559
584
  export { finalizeH3, H3_T4_STRIP } from "./finalize.js";
560
585
  export { renderH3Swap } from "./swap.js";
561
586
  export { renderH3Repair } from "./repair.js";
562
- export { renderH3Extend } from "./extend.js";
563
- export { refineArmed, renderH3Refine, renderH3RefineWindow, renderH3RefineWindows, refineWindowCount, refineWindowStarts, REFINE_UPSCALE_MODEL, REFINE_2X_OOM_FRAMES, REFINE_DEFAULT_CLIP_SECONDS } from "./refine.js";
587
+ export { renderH3Extend, LAST_FRAME_BATCH_INDEX } from "./extend.js";
588
+ export { refineArmed, renderH3Refine, renderH3RefineBag, renderH3RefineCarry, renderH3RefineWindow, renderH3RefineWindows, refineWindowCount, refineWindowStarts, tokenExactCarry, nextTokenExact, lawfulCarryStart, REFINE_UPSCALE_MODEL, REFINE_2X_OOM_FRAMES, REFINE_DEFAULT_CLIP_SECONDS, REFINE_DEFAULT_OVERLAP_FRAMES } from "./refine.js";
564
589
  export { refinePlaneSchema, REFINE_PLANE_KEYS } from "./schema.js";
565
590
  export { MAX_COMPOSED_WINDOWS, SEAM_OVERLAP_FRAMES } from "./timelineContract.js";
566
591
  export { H3_DEFAULT_LORA_ID, h3DefaultLoraEntry } from "./actions.js";
package/lib/mods/loras.js CHANGED
@@ -1,5 +1,15 @@
1
1
  export const inject = ['comfyui'];
2
2
  export const H3_LORA_ROWS = [
3
+
4
+ // silveroxides merge"; file named by the operator: the pruned v2,
5
+ // "That one is the same and less file size"): silveroxides'
6
+ // OFFICIAL silver_official_releases DARE-TIES merge — the v2
7
+ // attention-config build (his README: the v2 layers are optimized
8
+ // for inference, no attention backend patcher needed). 766 MB
9
+ // class (765,591,085 bytes), sha256 pinned in the provisions
10
+ // table (src/index.ts) — the two trees' bytes verified against
11
+ // the HF xet lfs oid. ──
12
+ { id: 'h3_silver_dareties', filename: 'h3/minimax_h3_fl2v_turbo_silver_dareties_comfy_pruned_v2.safetensors', source_url: 'https://huggingface.co/silveroxides/MiniMax-H3_tests/resolve/main/silver_official_releases/minimax_h3_fl2v_turbo_silver_dareties_comfy_pruned_v2.safetensors', label: 'Silveroxides DARE-TIES Merge', category: 'distill', default_strength: 0.8, steps: 8, steps_min: 4, steps_max: 8, shift_video: 8 },
3
13
  // ── THE MARRIED SHIFT COLUMN (SOTA limb 2, H3_TIMELINE_RESERACH
4
14
 
5
15
  // training contract — the 8-step LightX2V variants and every
@@ -12,7 +22,11 @@ export const H3_LORA_ROWS = [
12
22
  // native/default. shift_audio is 3.0 across every source — the
13
23
  // schema's own declared default already speaks it (no column). ──
14
24
  { id: 'h3_lightx2v_dareties', filename: 'h3/minimax_h3_fl2v_lightx2v_v0.1_dareties_v4_step600_comfy_fro.safetensors', source_url: 'https://huggingface.co/silveroxides/MiniMax-H3_tests/resolve/main/minimax_h3_fl2v_lightx2v_v0.1_dareties_v4_step600_comfy_fro.safetensors', label: 'LightX2V dareties v4', category: 'distill', default_strength: 0.8, steps: 4, steps_min: 4, steps_max: 4, shift_video: 6 },
15
- { id: 'h3_lightx2v_turbo', filename: 'h3/minimax_h3_fl2v_lightx2v_turbo_4to8step_v0.1-v1.0_768p_v4_step600_dareties.safetensors', source_url: 'https://huggingface.co/silveroxides/MiniMax-H3_tests/resolve/main/experimental/minimax_h3_fl2v_lightx2v_turbo_4to8step_v0.1-v1.0_768p_v4_step600_dareties.safetensors', label: 'LightX2V Turbo 4-8 step', category: 'distill', default_strength: 0.6, steps: 8, steps_min: 4, steps_max: 8, shift_video: 12 },
25
+
26
+ // this is silveroxides' EXPERIMENTAL/ LightX2V-turbo × dareties
27
+ // file — the label names it honestly; it is NOT the official
28
+ // silver_dareties merge the default seat holds.
29
+ { id: 'h3_lightx2v_turbo', filename: 'h3/minimax_h3_fl2v_lightx2v_turbo_4to8step_v0.1-v1.0_768p_v4_step600_dareties.safetensors', source_url: 'https://huggingface.co/silveroxides/MiniMax-H3_tests/resolve/main/experimental/minimax_h3_fl2v_lightx2v_turbo_4to8step_v0.1-v1.0_768p_v4_step600_dareties.safetensors', label: 'LightX2V Turbo × Dareties (silveroxides experimental)', category: 'distill', default_strength: 0.6, steps: 8, steps_min: 4, steps_max: 8, shift_video: 12 },
16
30
  { id: 'h3_turbo4_v1', filename: 'h3/minimax_h3_fl2v_turbo_4step_v1.0_768p_comfyui_bf16.safetensors', source_url: 'https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/loras/minimax_h3_fl2v_turbo_4step_v1.0_768p_comfyui_bf16.safetensors', label: 'LightX2V Turbo 4-Step v1.0 (768p)', category: 'distill', default_strength: 1, steps: 4, steps_min: 4, steps_max: 4, shift_video: 6 },
17
31
  { id: 'h3_turbo8_v1', filename: 'h3/minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16.safetensors', source_url: 'https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/loras/minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16.safetensors', label: 'LightX2V Turbo 8-Step v1.0', category: 'distill', default_strength: 1, steps: 8, steps_min: 8, steps_max: 8, shift_video: 12 },
18
32
  { id: 'h3_ref2v_turbo4', filename: 'h3/minimax_h3_ref2v_turbo_4step_v0.1_comfyui_bf16.safetensors', source_url: 'https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/loras/minimax_h3_ref2v_turbo_4step_v0.1_comfyui_bf16.safetensors', label: 'LightX2V Ref Turbo 4-Step v0.1', category: 'distill', default_strength: 1, steps: 4, steps_min: 4, steps_max: 4, shift_video: 12 },
package/lib/refine.d.ts CHANGED
@@ -18,6 +18,15 @@ export declare const REFINE_2X_OOM_FRAMES = 141;
18
18
 
19
19
 
20
20
  export declare const REFINE_DEFAULT_CLIP_SECONDS = 3.75;
21
+ /** The refine auto-tile's default carried overlap, in frames at the
22
+ * film clock — the film's own seam (SEAM_OVERLAP_FRAMES), which is
23
+ * also token-exact (5, 22, 39 …), so the default auto-tile takes the
24
+ * carry face: the windows chain through the film's own latent
25
+ * continuation across every join. Imported, never hand-typed
26
+ * (refine-window audit D1: the card must never carry a hand-typed
27
+ * copy of a measured constant — and the overlap that matches the
28
+ * generation seam grid is the family contract's own number). */
29
+ export declare const REFINE_DEFAULT_OVERLAP_FRAMES = 22;
21
30
  /** The arm predicate: BAG PRESENCE — the same law as the
22
31
  * replace/repair/extend/reshoot arms (a commission is armed when
23
32
  * its bag is a NON-EMPTY ARRAY). Absent or empty bag = the compose
@@ -38,9 +47,17 @@ export interface RefineWindowSeat {
38
47
  /** this window's SaveVideo prefix (the run tree's own spelling) */
39
48
  prefix: string;
40
49
  }
41
-
42
-
43
-
50
+ /** THE FAMILY PLANE, the five seats every refine window rides: the
51
+ * film's own masked-edit plane (one unet stack with the lora bag,
52
+ * one clip, the two VAEs). The carry face composes it ONCE for the
53
+ * whole film; a standalone window builds its own. */
54
+ export interface RefinePlane {
55
+ readonly sigmaModel: OutputHandle;
56
+ readonly samplerSel: OutputHandle;
57
+ readonly clip: OutputHandle;
58
+ readonly vaeVideo: OutputHandle;
59
+ readonly vaeAudio: OutputHandle;
60
+ }
44
61
 
45
62
 
46
63
 
@@ -66,8 +83,13 @@ export declare function renderH3RefineWindow(entry: Record<string, unknown>, p:
66
83
  * — the family plane this refine renders under)
67
84
  * @param facts the family's lane facts (unet off the DECL row)
68
85
  * @param g the run's graph builder
69
- * @param runId the run tree's id (the refine filename rides it) */
70
- export declare function renderH3Refine(entry: Record<string, unknown>, p: Record<string, unknown>, facts: H3Facts, g: GraphBuilder, runId: string): void;
86
+ * @param runId the run tree's id (the refine filename rides it)
87
+ * @returns the window's SaveVideo passthrough (the bag carrier's
88
+ * N=1 delegate returns the same handle; statement callers ignore it) */
89
+ export declare function renderH3Refine(entry: Record<string, unknown>, p: Record<string, unknown>, facts: H3Facts, g: GraphBuilder, runId: string): OutputHandle;
90
+
91
+
92
+
71
93
 
72
94
 
73
95
 
@@ -79,6 +101,31 @@ export declare function renderH3Refine(entry: Record<string, unknown>, p: Record
79
101
 
80
102
 
81
103
 
104
+ export declare const tokenExactCarry: (frames: number) => boolean;
105
+ /** The next token-exact carry at or above a measured span — the rung
106
+ * a refusal names so the fix is a stated number, not a search.
107
+ * @param frames the measured carry in frames
108
+ * @returns the smallest token-exact carry ≥ `frames` */
109
+ export declare const nextTokenExact: (frames: number) => number;
110
+ /** The most truthful start for the next window: the film's own 22 f
111
+ * seam when the previous window can hold it, else the largest
112
+ * token-exact carry the window can still advance from. The refusal
113
+ * names this frame, so the fix is one edited Start seconds.
114
+ * @param prev the previous window's origin (cap + skip at the film clock)
115
+ * @returns the next window's start frame, or null when the window is
116
+ * too short for any carried join */
117
+ export declare const lawfulCarryStart: (prev: {
118
+ cap: number;
119
+ skip: number;
120
+ }) => number | null;
121
+ export declare function renderH3RefineCarry(entries: ReadonlyArray<Record<string, unknown>>, p: Record<string, unknown>, facts: H3Facts, g: GraphBuilder, windows: ReadonlyArray<{
122
+ cap: number;
123
+ skip: number;
124
+ }>, carries: readonly number[], runId: string): OutputHandle;
125
+ export declare function renderH3RefineBag(bag: Array<Record<string, unknown>>, p: Record<string, unknown>, facts: H3Facts, g: GraphBuilder, runId: string): OutputHandle;
126
+
127
+
128
+
82
129
 
83
130
 
84
131