@forgeax-extension/character-3d 0.1.2

package/schemas/gen3d-asset-manifest.json

@@ -0,0 +1,281 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gen3d-asset-manifest",
+  "title": "Gen3DAssetManifest",
+  "type": "object",
+  "properties": {
+    "manifestVersion": {
+      "const": 1
+    },
+    "assetId": {
+      "type": "string"
+    },
+    "kind": {
+      "enum": [
+        "mesh",
+        "animation"
+      ]
+    },
+    "provider": {
+      "enum": [
+        "meshy",
+        "hunyuan_workflow",
+        "hunyuan_rest",
+        "rodin",
+        "visvise"
+      ]
+    },
+    "providerMode": {
+      "enum": [
+        "mock",
+        "real"
+      ]
+    },
+    "mode": {
+      "enum": [
+        "text",
+        "image",
+        "views",
+        "refine"
+      ]
+    },
+    "sourceJobId": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "sourceInputAssetIds": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "prompt": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "files": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "fileId": {
+            "type": "string"
+          },
+          "role": {
+            "enum": [
+              "source_mesh",
+              "rigged_model",
+              "preview_image",
+              "texture",
+              "animation_clip",
+              "animated_model"
+            ]
+          },
+          "format": {
+            "enum": [
+              "glb",
+              "fbx",
+              "obj",
+              "mtl",
+              "usdz",
+              "stl",
+              "png",
+              "jpg",
+              "mp4"
+            ]
+          },
+          "storageKey": {
+            "type": "string"
+          },
+          "bytes": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "sha256": {
+            "type": "string"
+          },
+          "localUrl": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "hasSkeleton": {
+            "type": "boolean"
+          },
+          "skeletonProfile": {
+            "enum": [
+              "humanoid",
+              "unknown"
+            ]
+          },
+          "animationInputReady": {
+            "type": "boolean"
+          },
+          "motionType": {
+            "type": "integer",
+            "minimum": 9,
+            "maximum": 16,
+            "description": "Present only on role=animated_model files: the motion_retarget v1 motion this clip is (9 跨步 / 10 摔倒 / 11 跳跃 / 12 踢腿 / 13 挥击 / 14 步行 / 15 跑步 / 16 跳舞). Structural so multiple motions coexist per asset. Absent for non-animated roles."
+          }
+        },
+        "required": [
+          "fileId",
+          "role",
+          "format",
+          "storageKey",
+          "bytes",
+          "sha256",
+          "localUrl",
+          "hasSkeleton",
+          "skeletonProfile",
+          "animationInputReady"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "readiness": {
+      "type": "object",
+      "properties": {
+        "hasSourceMesh": {
+          "type": "boolean"
+        },
+        "rigged": {
+          "type": "boolean"
+        },
+        "animated": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "hasSourceMesh",
+        "rigged",
+        "animated"
+      ],
+      "additionalProperties": false
+    },
+    "quality": {
+      "type": "object",
+      "properties": {
+        "geometry": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "topology": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "texture": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "pbr": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "prompt_fidelity": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "total": {
+          "type": [
+            "number",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "geometry",
+        "topology",
+        "texture",
+        "pbr",
+        "prompt_fidelity",
+        "total"
+      ],
+      "additionalProperties": false
+    },
+    "createdAt": {
+      "type": "string"
+    },
+    "updatedAt": {
+      "type": "string"
+    },
+    "meshyTaskRefs": {
+      "type": "object",
+      "description": "Meshy preview vs result task ids. Manual refine uses previewTaskId; rig uses resultTaskId.",
+      "properties": {
+        "previewTaskId": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "resultTaskId": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "previewTaskId",
+        "resultTaskId"
+      ],
+      "additionalProperties": false
+    },
+    "visviseRefs": {
+      "type": "object",
+      "description": "VISVISE COS URLs from generate/rig. Downstream rig/motion must reuse these; do not re-host on ForgeaX COS first.",
+      "properties": {
+        "meshUrl": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "rigUrl": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "meshUrl",
+        "rigUrl"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "manifestVersion",
+    "assetId",
+    "kind",
+    "provider",
+    "providerMode",
+    "mode",
+    "sourceJobId",
+    "sourceInputAssetIds",
+    "prompt",
+    "files",
+    "readiness",
+    "quality",
+    "createdAt",
+    "updatedAt"
+  ],
+  "additionalProperties": false
+}

package/schemas/generate-meshy-text-mock.args.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "gen3d:generate-meshy-text-mock args",
+  "type": "object",
+  "properties": {
+    "slug": {
+      "type": "string",
+      "description": "Active game slug. The workbench UI fills this automatically for manual use; an AI/agent caller MUST pass the active game's slug (e.g. 'mini-gta'). Required."
+    },
+    "assetSlot": {
+      "type": "string",
+      "enum": ["characters", "meshes"],
+      "default": "meshes",
+      "description": "3D asset slot (subdir under assets/3d/)."
+    },
+    "assetName": {
+      "type": "string",
+      "description": "Desired base file name (without extension). Sanitized + de-duplicated by the store."
+    },
+    "prompt": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Text prompt for the mock Meshy text-to-3D result."
+    },
+    "promptCategory": {
+      "enum": ["character", "prop", "scene"],
+      "default": "prop"
+    },
+    "enablePbr": {
+      "type": "boolean",
+      "default": true
+    },
+    "targetPolycount": {
+      "type": "integer",
+      "minimum": 1000,
+      "maximum": 300000,
+      "default": 30000
+    }
+  },
+  "required": ["slug", "prompt"],
+  "additionalProperties": false
+}

package/schemas/generate-meshy-text-mock.returns.json

@@ -0,0 +1,301 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "gen3d:generate-meshy-text-mock returns",
+  "type": "object",
+  "properties": {
+    "ok": {
+      "const": true
+    },
+    "quotaSafe": {
+      "const": true
+    },
+    "cacheKey": {
+      "type": "string"
+    },
+    "manifest": {
+      "type": "object",
+      "properties": {
+        "manifestVersion": {
+          "const": 1
+        },
+        "assetId": {
+          "type": "string"
+        },
+        "kind": {
+          "enum": [
+            "mesh",
+            "animation"
+          ]
+        },
+        "provider": {
+          "enum": [
+            "meshy",
+            "hunyuan_workflow",
+            "hunyuan_rest",
+            "rodin",
+            "visvise"
+          ]
+        },
+        "providerMode": {
+          "enum": [
+            "mock",
+            "real"
+          ]
+        },
+        "mode": {
+          "enum": [
+            "text",
+            "image",
+            "views",
+            "refine"
+          ]
+        },
+        "sourceJobId": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "sourceInputAssetIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "prompt": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "files": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "fileId": {
+                "type": "string"
+              },
+              "role": {
+                "enum": [
+                  "source_mesh",
+                  "rigged_model",
+                  "preview_image",
+                  "texture",
+                  "animation_clip",
+                  "animated_model"
+                ]
+              },
+              "format": {
+                "enum": [
+                  "glb",
+                  "fbx",
+                  "obj",
+                  "mtl",
+                  "usdz",
+                  "stl",
+                  "png",
+                  "jpg",
+                  "mp4"
+                ]
+              },
+              "storageKey": {
+                "type": "string"
+              },
+              "bytes": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "sha256": {
+                "type": "string"
+              },
+              "localUrl": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "hasSkeleton": {
+                "type": "boolean"
+              },
+              "skeletonProfile": {
+                "enum": [
+                  "humanoid",
+                  "unknown"
+                ]
+              },
+              "animationInputReady": {
+                "type": "boolean"
+              },
+              "motionType": {
+                "type": "integer",
+                "minimum": 9,
+                "maximum": 16,
+                "description": "Present only on role=animated_model files: the motion_retarget v1 motion this clip is (9 跨步 / 10 摔倒 / 11 跳跃 / 12 踢腿 / 13 挥击 / 14 步行 / 15 跑步 / 16 跳舞). Structural so multiple motions coexist per asset. Absent for non-animated roles."
+              }
+            },
+            "required": [
+              "fileId",
+              "role",
+              "format",
+              "storageKey",
+              "bytes",
+              "sha256",
+              "localUrl",
+              "hasSkeleton",
+              "skeletonProfile",
+              "animationInputReady"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "readiness": {
+          "type": "object",
+          "properties": {
+            "hasSourceMesh": {
+              "type": "boolean"
+            },
+            "rigged": {
+              "type": "boolean"
+            },
+            "animated": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "hasSourceMesh",
+            "rigged",
+            "animated"
+          ],
+          "additionalProperties": false
+        },
+        "quality": {
+          "type": "object",
+          "properties": {
+            "geometry": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "topology": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "texture": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "pbr": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "prompt_fidelity": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "total": {
+              "type": [
+                "number",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "geometry",
+            "topology",
+            "texture",
+            "pbr",
+            "prompt_fidelity",
+            "total"
+          ],
+          "additionalProperties": false
+        },
+        "createdAt": {
+          "type": "string"
+        },
+        "updatedAt": {
+          "type": "string"
+        },
+        "meshyTaskRefs": {
+          "type": "object",
+          "description": "Meshy preview vs result task ids. Manual refine uses previewTaskId; rig uses resultTaskId.",
+          "properties": {
+            "previewTaskId": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "resultTaskId": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "previewTaskId",
+            "resultTaskId"
+          ],
+          "additionalProperties": false
+        },
+        "visviseRefs": {
+          "type": "object",
+          "description": "VISVISE COS URLs from generate/rig. Downstream rig/motion must reuse these; do not re-host on ForgeaX COS first.",
+          "properties": {
+            "meshUrl": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "rigUrl": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "meshUrl",
+            "rigUrl"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "manifestVersion",
+        "assetId",
+        "kind",
+        "provider",
+        "providerMode",
+        "mode",
+        "sourceJobId",
+        "sourceInputAssetIds",
+        "prompt",
+        "files",
+        "readiness",
+        "quality",
+        "createdAt",
+        "updatedAt"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "ok",
+    "quotaSafe",
+    "cacheKey",
+    "manifest"
+  ],
+  "additionalProperties": false
+}

package/schemas/get-credentials.args.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "gen3d:get-credentials args",
+  "type": "object",
+  "properties": {},
+  "additionalProperties": false
+}

package/schemas/get-credentials.returns.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "gen3d:get-credentials returns",
+  "type": "object",
+  "properties": {
+    "ok": { "const": true },
+    "realProvidersEnabled": {
+      "type": "boolean",
+      "description": "True when GEN3D_ENABLE_REAL_PROVIDERS resolves to \"1\" (process.env wins over the plugin .env)."
+    },
+    "litellmConfigured": {
+      "type": "boolean",
+      "description": "Read-only. True when Studio global .env has a 3D gateway key (priority FORGEAX_3D_GATEWAY_KEY > ANTHROPIC_API_KEY > LITELLM_PROXY_KEY)."
+    },
+    "litellmProxyKey": {
+      "type": ["string", "null"],
+      "description": "Read-only masked 3D gateway key from Studio Settings (first4...last4, or *** when <= 8 chars), or null when unset. Never plaintext. The plugin .env never holds this key."
+    },
+    "credentials": {
+      "type": "object",
+      "properties": {
+        "COS_SECRET_ID": {
+          "type": ["string", "null"],
+          "description": "Masked COS SecretId (first4...last4, or *** when <= 8 chars) or null when unset. Never plaintext."
+        },
+        "COS_SECRET_KEY": {
+          "type": ["string", "null"],
+          "description": "Masked COS SecretKey or null when unset. Never plaintext."
+        },
+        "COS_BUCKET": {
+          "type": ["string", "null"],
+          "description": "Plaintext COS bucket name (an address, not a secret) or null when unset."
+        },
+        "COS_REGION": {
+          "type": ["string", "null"],
+          "description": "Plaintext COS region (an address, not a secret) or null when unset."
+        }
+      },
+      "required": ["COS_SECRET_ID", "COS_SECRET_KEY", "COS_BUCKET", "COS_REGION"],
+      "additionalProperties": false
+    }
+  },
+  "required": ["ok", "realProvidersEnabled", "litellmConfigured", "litellmProxyKey", "credentials"],
+  "additionalProperties": false
+}

package/schemas/get-playable-profile.args.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "gen3d:get-playable-profile args",
+  "type": "object",
+  "properties": {
+    "slug": { "type": "string" },
+    "assetPath": { "type": "string" }
+  },
+  "required": ["slug"],
+  "additionalProperties": false
+}