@melite/models-kimodo 0.1.4-alpha → 0.2.0-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.
package/README.md ADDED
@@ -0,0 +1,44 @@
1
+ ---
2
+ description: NVIDIA Kimodo-SOMA text-to-pose motion family — SOMA-77 NPZ clips plus an optional rigged-GLB bake at 30 fps.
3
+ kind: package-library
4
+ ---
5
+
6
+ # kimodo
7
+
8
+ kimodo registers the NVIDIA Kimodo-SOMA family (form `form_motion_kimodo`, genre `motion`): text-to-motion generation over the SOMA-77 skeleton, shipped as pose NPZ clips, with an optional bake onto a rigged GLB. Weights come from the nvidia/Kimodo-SOMA-RP-v1.1 release; the family provisions `skin_standard.npz`, the SOMA-77 skin template.
9
+
10
+ ## The compose action
11
+
12
+ `compose` outputs two handles: `motion_npz` (kind MOTION) and `animated_glb` (kind GLB). The build wires KimodoLoader → KimodoTextToPose, then — when chained motion inputs or a rigged GLB are present — RaySomaxBake at 30 fps.
13
+
14
+ Params: `prompt` (required — the family's one relation), `duration_sec` [1, 10] (default 5), `diffusion_steps` [10, 200] (default 25), `num_samples` [1, 4] (default 1), `num_transition_frames` [0, 60] (default 10), `cfg_type` (`separated` / `regular` / `nocfg`; default `separated`), `cfg_weight_a` and `cfg_weight_b` [0, 15] (defaults 2.5 and 5), the chaining inputs `motion_npz`, `motion_prompts`, `motion_constraints`, `preview_glb`, and `seed` (seed-sentinel rule; default 42).
15
+
16
+ ## Recipes
17
+
18
+ Two recipe rows plus the no-op: `draft` (10 diffusion steps — fast iteration) and `polished` (200 steps — final quality).
19
+
20
+ ## Model Experience
21
+
22
+ ### Request context and condition
23
+
24
+ A run needs the prompt and the duration; everything else has a declared default. Chained `motion_npz` / `motion_prompts` / `motion_constraints` extend or stitch a clip; `preview_glb` carries the rigged mesh the bake arm dresses.
25
+
26
+ #### What the model sees
27
+
28
+ The prompt, duration, step count, the CFG type and weight pair, any chained motion inputs, and the optional rigged GLB; the graph is the loader → text-to-pose chain above, with the bake at 30 fps when rigged output is requested.
29
+
30
+ #### Token effect
31
+
32
+ Zero-direct: the action composes an engine graph, not a token stream. No value this family declares is measured in model tokens.
33
+
34
+ #### KV Cache effect
35
+
36
+ Independent: each run is self-contained; no shared context is declared.
37
+
38
+ ## Known Limitations and Deferred Work
39
+
40
+ - **Single skeleton** — SOMA-77 only; no retargeting or skeleton-choice surface is declared.
41
+ - **Fixed bake rate** — RaySomaxBake runs at 30 fps; the params surface offers no fps override.
42
+ - **Live behavior unobserved** — defaults and bounds are documented from the DECL and the action build, not verified against the running model.
43
+
44
+ Exports: the plugin root, `./package.json`.
package/lib/index.d.ts CHANGED
@@ -1,6 +1,7 @@
1
1
  import type { Plugin } from "@deepseek-ai/cordis";
2
- import type { ModelDecl } from "@melite/comfyui-cordis/model-contract";
2
+ import type { ModelDecl } from '@melite/comfyui-card-kit/model-contract';
3
3
  export declare const DECL: ModelDecl;
4
4
  export declare const family: Plugin;
5
5
  export { compose } from "./actions.js";
6
+ export { family as default };
6
7
  //# sourceMappingURL=index.d.ts.map
package/lib/index.js CHANGED
@@ -23,12 +23,33 @@ export const DECL = {
23
23
  "studio": {
24
24
  "tenant": "motion/motion",
25
25
  "owns_params": false,
26
- "writes": [],
26
+
27
+ // studio persists motion_bg_image into stage.params (its own
28
+ // onSave merge-patch), and the compose door refused every
29
+ // bg-carrying stage — "unknown param(s) on the motion card:
30
+ // motion_bg_image" — because no surface declared it. The cited
31
+ // strip home (compile.ts _KNOWN_NON_SIG_PARAMS) was purged with
32
+
33
+ // key admits at the door; the graph builder consumes none of it
34
+ // (UI-only — it never rides the wire; the card.spec hop-5 arm
35
+ // pins that half). preview_glb rides beside it (the
36
+
37
+ // persists it through the same onSave merge-patch (picker /
38
+ // unwire / rail clear) — it is ALSO a declared knob (params
39
+ // below), so the row is truth-telling, not a new admission.
40
+ "writes": ["motion_bg_image", "preview_glb"],
27
41
  "kind": "custom",
28
42
  "size": "normal",
29
43
  "layout": "studio"
30
44
  },
31
45
  "genre": "motion",
46
+
47
+ // user-provided seat(s) — the compose caller provides them. No
48
+ // variant-class rows: this family's served face exposes no
49
+ // steps+cfg pair (the census's surface-derived carve).
50
+ "required_defaults": [
51
+ { "name": "prompt", "class": "user" }
52
+ ],
32
53
  "variants": [
33
54
  {
34
55
  "id": "standard",
@@ -92,9 +113,32 @@ export const DECL = {
92
113
  "size_bytes": 531434
93
114
  }
94
115
  ],
116
+ "snapshot_provisions": [
117
+ {
118
+
119
+ // demand is satisfied only by a row that FETCHES or a stated
120
+ // placement — the source repo id alone composes no download
121
+
122
+ // owner's HF CLI; the on-disk tree matches upstream file for
123
+ // file.
124
+ "name": "Kimodo-SOMA-RP-v1.1",
125
+ "folder": "avatar/kimodo",
126
+ "repo_id": "nvidia/Kimodo-SOMA-RP-v1.1",
127
+ "revision": "6c9233af1180b8151e3c4703477104af5dce9dd5",
128
+ "allow_patterns": [
129
+ "config.yaml",
130
+ "model.safetensors",
131
+ "stats/**"
132
+ ]
133
+ }
134
+ ],
95
135
  "lane_inputs": {
96
136
  "model_path": "Kimodo-SOMA-RP-v1.1"
97
137
  },
138
+ // THE DECLARED HOME (the lane-presence cure): the store folder this
139
+ // pack-specific lane file lives in — the run gate probes it at press
140
+ // instead of dying untyped at the engine.
141
+ "lane_homes": { "model_path": "avatar/kimodo" },
98
142
 
99
143
  // the GAP-7 shape on the legacy lanes): the card's compose seat has
100
144
  // refused this field since the merge, imperatively, while the bench
@@ -112,6 +156,26 @@ export const DECL = {
112
156
  },
113
157
  ],
114
158
  },
159
+ // THE LANE SURFACE (the z-image precedent): exactly the knobs the
160
+ // motion card serves — the prompt, the sampling tail, and the
161
+ // motion-segment inputs.
162
+
163
+ // motion_npz row states what the compose action READS; the VALUE's
164
+ // home is the graph wiring — motion_npz chains from the previous
165
+ // motion's last frame as a graph-wired data channel (the motion
166
+ // card's flowKinds + flowOutputBindings, card.ts:88-93), not a
167
+ // hand-typed param seat. The admission census's group-scope
168
+ // statement names it not-judged on that seam
169
+ // (cards-admission-matrix.spec.ts T8; its condition arm reds if
170
+ // the channel ever gains a hand-typed admission seat).
171
+ "params": [
172
+ "prompt", "seed",
173
+ "duration_sec", "diffusion_steps",
174
+ "num_samples", "num_transition_frames",
175
+ "cfg_type", "cfg_weight_a", "cfg_weight_b",
176
+ "motion_npz", "motion_prompts", "motion_constraints",
177
+ "preview_glb",
178
+ ],
115
179
  // the compose action the motion card binds (the motion_t1
116
180
  // lane tree).
117
181
  "actions": [compose],
@@ -124,4 +188,9 @@ export const family = {
124
188
  },
125
189
  };
126
190
  export { compose } from "./actions.js";
191
+ // The Loader-row face: DSH loads plugin rows by bare specifier and
192
+ // unwraps `exports.default ?? exports` (vendor/cordis_plugins/loader
193
+ // unwrapExports) — the default export IS the row-loadable plugin. The
194
+ // named `family` stays the library face (engine loadFamilies).
195
+ export { family as default };
127
196
  //# sourceMappingURL=index.js.map
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@melite/models-kimodo",
3
- "version": "0.1.4-alpha",
4
- "license": "SSPL-1.0",
3
+ "version": "0.2.0-alpha",
4
+ "license": "AGPL-3.0-or-later",
5
5
  "type": "module",
6
6
  "exports": {
7
7
  ".": {
@@ -11,13 +11,12 @@
11
11
  "./package.json": "./package.json"
12
12
  },
13
13
  "dependencies": {
14
- "@melite/comfyui-card-kit": "0.1.4-alpha",
15
- "@melite/comfyui-cordis": "0.1.4-alpha"
14
+ "@melite/comfyui-card-kit": "0.2.0-alpha"
16
15
  },
17
16
  "devDependencies": {
18
17
  "@types/node": "^22.20.0",
19
18
  "typescript": "^5.9.3",
20
- "@deepseek-ai/cordis": "^4.0.4"
19
+ "@deepseek-ai/cordis": "^4.0.5"
21
20
  },
22
21
  "files": [
23
22
  "lib/index.js",
@@ -25,7 +24,7 @@
25
24
  "lib/**/*.d.ts"
26
25
  ],
27
26
  "peerDependencies": {
28
- "@deepseek-ai/cordis": "^4.0.4"
27
+ "@deepseek-ai/cordis": "^4.0.5"
29
28
  },
30
29
  "scripts": {
31
30
  "build": "tsc -p tsconfig.build.json",