Import bridge
Detect, plan and run imports from other engines and file formats.
bridge_detect
Fingerprint an external file or engine-project directory through the CLI-owned HELIX Bridge and return helix.bridge-detection/1 JSON. This is read-only and runs no converter or plugin executable.
| Argument | Type | Required | Description |
|---|---|---|---|
source | string | yes | Absolute path to the external asset, archive, mod export, or engine project |
bridge_doctor
List built-in/installed Bridge Plugins and optional Unreal, Unity, Godot, and Blender adapter configuration.
| Argument | Type | Required | Description |
|---|---|---|---|
pluginDirs | string[] | no |
bridge_import
Execute the CLI-owned HELIX Bridge pipeline: detect, plan, convert, package, and write checksummed provenance. For every command-backed capability, including a packaged official adapter, allowPermissions must contain every permission named by bridge_plan and expectedPlanKey must equal that reviewed plan deterministicKey; never add permissions merely to make a blocked plan run. Only an in-process built-in-only route with no command needs no additional acknowledgement.
| Argument | Type | Required | Description |
|---|---|---|---|
source | string | yes | Absolute path to the external source |
output | string | yes | Absolute path to a new output directory that does not already exist; ignored by dryRun |
type | "auto" | "asset" | "character" | "addon" | "scene" | "animation" | "extract" | no | |
target | "web" | "unreal" | "mobile" | "canonical" | no | |
plugins | string[] | no | |
pluginDirs | string[] | no | |
headTexture | string | no | MetaHuman baked head texture (required for a detected MetaHuman face) |
eyeTexture | string | no | MetaHuman eye bake override; omit to use the PR #99 canonical bake packaged in the CLI |
canonical | string | no | Canonical helix-humanoid body override |
boneMap | string | no | Custom skeleton/bone map JSON |
inputs | object | no | Additional named input paths required by the selected plugin plan |
expectedPlanKey | string | no | Reviewed bridge_plan deterministicKey; mandatory for non-dry-run command-backed execution |
allowPermissions | ("filesystem.read-source" | "filesystem.write-output" | "unrestricted-host-execution" | "network" | "spawn-process" | "unreal-editor" | "unity-editor" | "blender" | "gpu")[] | no | Exact bridge_plan permissions approved for command-backed execution; unrestricted-host-execution authorizes a local process, not a sandbox |
dryRun | boolean | no | Plan only; execute and write nothing |
bridge_inspect
Inspect an external source through HELIX Bridge and return structural evidence plus every viable installed-plugin plan. Read-only: it does not install or execute plugins.
| Argument | Type | Required | Description |
|---|---|---|---|
source | string | yes | Absolute path to the external source |
pluginDirs | string[] | no | Additional local plugin directories to inspect without installing |
bridge_plan
Resolve an external source into a deterministic helix.bridge-plan/1 capability graph. Always call this before granting permissions to any command-backed capability, including a packaged official adapter, or when the source is unfamiliar. Read-only and safe to use on untrusted plugins.
| Argument | Type | Required | Description |
|---|---|---|---|
source | string | yes | Absolute path to the external source |
type | "auto" | "asset" | "character" | "addon" | "scene" | "animation" | "extract" | no | Desired content domain; auto uses detection evidence |
target | "web" | "unreal" | "mobile" | "canonical" | no | Runtime representation target (default web) |
plugins | string[] | no | Installed plugin ids to include explicitly |
pluginDirs | string[] | no | Additional local plugin directories to inspect without installing |
headTexture | string | no | MetaHuman baked head texture to fingerprint into the reviewed plan |
eyeTexture | string | no | MetaHuman eye bake override to fingerprint; omit for the CLI-packaged canonical bake |
canonical | string | no | Canonical helix-humanoid body override to fingerprint |
boneMap | string | no | Custom skeleton/bone map JSON to fingerprint |
inputs | object | no | Additional named input paths to fingerprint into the reviewed plan |
bridge_plugin_create
Scaffold a new local Bridge Plugin directory with bridge-plugin.json and an executable JSON-stdin handler.
| Argument | Type | Required | Description |
|---|---|---|---|
directory | string | yes | Absolute path to a new empty directory |
id | string | yes | Stable lowercase plugin id |
name | string | no |
bridge_plugin_inspect
Validate and inspect an installed Bridge Plugin id or an uninstalled local plugin directory without running it.
| Argument | Type | Required | Description |
|---|---|---|---|
plugin | string | yes | Installed id or absolute plugin directory |
bridge_plugin_install
Validate and atomically install a local Bridge Plugin directory. Installation makes it discoverable but does not grant execution permissions. Use force only when replacing the same installed id is part of the requested task.
| Argument | Type | Required | Description |
|---|---|---|---|
directory | string | yes | Absolute plugin directory containing bridge-plugin.json |
force | boolean | no |
bridge_plugin_remove
Remove one installed community/local Bridge Plugin. Built-in HELIX plugins cannot be removed.
| Argument | Type | Required | Description |
|---|---|---|---|
id | string | yes | Installed plugin id |
bridge_plugin_test
Validate a local Bridge Plugin manifest, file bounds, and declared executable handlers without executing conversion capabilities.
| Argument | Type | Required | Description |
|---|---|---|---|
directory | string | yes | Absolute plugin directory |
bridge_plugins_list
List built-in, installed, and optionally local Bridge Plugins with capabilities, versions, trust, permissions, and roots.
| Argument | Type | Required | Description |
|---|---|---|---|
pluginDirs | string[] | no |
bridge_validate
Validate a Bridge output, provenance record, or combined base-avatar GLB through the CLI. Set baseAvatar for the PR #99 three-LOD + textured-eye publication gate.
| Argument | Type | Required | Description |
|---|---|---|---|
artifact | string | yes | Absolute path to the artifact or bridge-provenance.json |
baseAvatar | boolean | no |