@melite/models-kimodo 0.1.5-pre-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.
package/README.md CHANGED
@@ -1,8 +1,3 @@
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
1
  # kimodo
7
2
 
8
3
  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.
package/lib/actions.js CHANGED
@@ -2,13 +2,28 @@ import { requireText } from "@melite/comfyui-card-kit/facts";
2
2
  // fps is LANE-INTERNAL (MotionT1Doc default 30.0 — moved verbatim
3
3
  // from the lane).
4
4
  const MOTION_BAKE_FPS = 30.0;
5
+
6
+
7
+
8
+
9
+
10
+
11
+
12
+ const SEAT_CLAUSE = ' — seat the model at lane home "avatar/kimodo" (snapshot provision "Kimodo-SOMA-RP-v1.1" fetches the rig tree)';
5
13
  /** The compose facts door: the resolved lane_inputs parsed into
6
14
  * the closed shape — a missing model_path refuses field-named
7
15
  * here, never composes a KimodoLoader on an empty directory.
8
16
  * @param raw the resolved lane_inputs (family ⊕ variant)
9
17
  * @returns the typed facts the segment factory reads */
10
18
  export function parseKimodoFacts(raw) {
11
- return { model_path: requireText(raw, "model_path", "kimodo compose") };
19
+ try {
20
+ return { model_path: requireText(raw, "model_path", "kimodo compose") };
21
+ }
22
+ catch (e) {
23
+ if (e instanceof Error)
24
+ throw new Error(e.message + SEAT_CLAUSE);
25
+ throw e;
26
+ }
12
27
  }
13
28
  /** The compose action: the motion_t1 block — Kimodo checkpoint
14
29
  * lane + optional preview bake (the prompt admission stays on the
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",
@@ -138,6 +159,15 @@ export const DECL = {
138
159
  // THE LANE SURFACE (the z-image precedent): exactly the knobs the
139
160
  // motion card serves — the prompt, the sampling tail, and the
140
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).
141
171
  "params": [
142
172
  "prompt", "seed",
143
173
  "duration_sec", "diffusion_steps",
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@melite/models-kimodo",
3
- "version": "0.1.5-pre-alpha",
4
- "license": "SSPL-1.0",
3
+ "version": "0.2.2-alpha",
4
+ "license": "AGPL-3.0-or-later",
5
5
  "type": "module",
6
6
  "exports": {
7
7
  ".": {
@@ -11,12 +11,7 @@
11
11
  "./package.json": "./package.json"
12
12
  },
13
13
  "dependencies": {
14
- "@melite/comfyui-card-kit": "0.1.5-pre-alpha"
15
- },
16
- "devDependencies": {
17
- "@types/node": "^22.20.0",
18
- "typescript": "^5.9.3",
19
- "@deepseek-ai/cordis": "^4.0.4"
14
+ "@melite/comfyui-card-kit": "0.2.2-alpha"
20
15
  },
21
16
  "files": [
22
17
  "lib/index.js",
@@ -24,12 +19,29 @@
24
19
  "lib/**/*.d.ts"
25
20
  ],
26
21
  "peerDependencies": {
27
- "@deepseek-ai/cordis": "^4.0.4"
22
+ "@deepseek-ai/cordis": "^4.0.5"
23
+ },
24
+ "description": "NVIDIA Kimodo-SOMA text-to-pose motion family — SOMA-77 NPZ clips plus an optional rigged-GLB bake at 30 fps.",
25
+ "repository": {
26
+ "type": "git",
27
+ "url": "https://github.com/JayDataEngineer/melite.git",
28
+ "directory": "packages/models/kimodo"
28
29
  },
30
+ "keywords": [
31
+ "melite",
32
+ "comfyui",
33
+ "cordis",
34
+ "agent",
35
+ "media-generation",
36
+ "library"
37
+ ],
29
38
  "scripts": {
30
39
  "build": "tsc -p tsconfig.build.json",
31
40
  "typecheck": "tsc --noEmit"
32
41
  },
42
+ "engines": {
43
+ "node": ">=22.18.0"
44
+ },
33
45
  "publishConfig": {
34
46
  "access": "public"
35
47
  }