Library and media

library_search

Search Delightex Nova's library for matching objects.

Example prompt

“Find a tree in Nova's library.”

Example response

{
  "items": [
    {
      "name": "Example Tree",
      "category": "Nature",
      "description": "An example tree model."
    }
  ]
}

NOTE: Names and descriptions are illustrative. Use the exact names returned by a real search to inspect or add objects. No file upload is needed.

‍

library_get_item_details

Inspect a library object before adding or configuring it.

Example prompt

“Inspect the tree returned by the library search.”

Example response (excerpt)

{
  "items": [
    {
      "id": "LIBRARY_EXAMPLE",
      "name": "Example Tree",
      "category": "Nature",
      "description": "An example tree model."
    }
  ],
  "missingNames": []
}

NOTE: This excerpt omits each item's scene object, which contains the full model structure. Inspect up to 10 exact library names together.

‍

media_upload_prepare

Prepare upload links for an external image, sound, video, or 3D model.

Example prompt

“Prepare this mission-badge.png file for upload to my Project.”

Example response

{
  "uploadHandle": "UPLOAD_EXAMPLE",
  "files": [
    {
      "name": "mission-badge.png",
      "uploadUrl": "https://uploads.example/FILE_EXAMPLE",
      "requiredHeaders": {
        "Content-Type": "image/png",
        "Content-Length": "12345"
      }
    }
  ]
}

NOTE:  The assistant must transfer the file using the returned upload URL and headers. This step alone does not upload or import the file.

‍

scene_import_media

Finish a transferred upload and register it as a Project asset.

Example prompt

“Finish importing the uploaded file as Mission Badge.”

Example response

{
  "assetIds": [
    "ASSET_EXAMPLE"
  ]
}

NOTE: Requires a prepared upload whose files were transferred successfully. The asset is added to the Project; placing it in a scene is a separate step.

‍

Tool index · About these examples