Return Octane X app, bridge heartbeat, and command queue status.

Return Octane X process state, generated bridge paths, and bridge heartbeat age.

Run a generated Octane bridge script from the Scripts menu via AppleScript.

Run hermes_bridge_oneshot.generated.lua via AppleScript for batch queue draining.

Run hermes_bridge_persistent.generated.lua via AppleScript to open/manage the persistent bridge.

Read the local OctaneX MCP recipe book of successes, failures, and reusable patterns.

Append a compact success/failure note to docs/recipe-book.md for future agents.

List checked-in example recipes with normalized metadata and preview/native verification status.

Load a checked-in recipe by slug, including command sequence and resolved asset paths.

Queue a checked-in recipe command sequence by slug, with optional per-op payload overrides.

Validate checked-in recipe metadata, required files, previews, and command payloads.

WP9 RAGS retrieval: find the nearest existing corpus grammar to warm-start a new subject.

Searches the harvested reference corpus (corpus/) for entries whose labels / domain / subject / title / dominant colors match query. Returns ranked matches, each carrying its pixel-derived derived_acceptance spec so a new render can be conditioned against the closest prior reference. Pure offline ranking: keyword + hue-overlap + era, no embeddings, no network.

Args: query: free-text subject, e.g. "red sphere" or "blue ceramic vase". top_k: max matches to return (default 3). domain: optional domain filter (e.g. "photoreal", "stylized"). only_converged: if true, only return entries that have a rendered preview.

Validate one JSON command envelope before it is queued or replayed.

Return the supported command schema, operation list, limits, and examples.

Validate all queued command JSON files in the current workspace.

Queue a ping command for the Octane Lua bridge.

Create a small OBJ cube asset and queue an import_geometry command.

Queue an import_geometry command for OBJ/USD/FBX/Alembic/etc.

Queue a material creation/update command with optional PBR fields.

Any non-default PBR field is forwarded to the bridge. Octane pins that are unavailable on the current build are acknowledged with a warning by the Lua handler rather than crashing the command.

Queue a native light creation command (area, sun, environment, emissive, etc.).

The bridge creates the matching Octane light/environment node and wires it to the active render target, acking unsupported pins with a warning.

Queue a material assignment command.

Queue a camera placement command.

Queue a lighting preset command.

Queue a render start/restart command.

Queue a render-ready preview image save command.

Convergence ceiling: pass quality to pick a preset tier (standard=30s, high=60s, ultra=120s, final=unlimited). Either the Octane film maxRenderTime or the Lua timeout_seconds poll acts as the cap; the render stops at whichever is hit first and the frame is saved (best-effort on timeout). Raw samples/min_samples/ timeout_seconds/max_render_time override the tier when given.

Set progressive=True to also emit an early low-spp frame at preview_progressive.png before the final frame (bridge C1).

Review a saved PNG preview for blank/clipped/low-contrast output using image-level QA metrics.

Suggest a camera patch from preview QA output and asset bounds.

Suggest a lighting/render patch from preview QA output.

Queue a high-level concept build request plus deterministic starter scene commands.

Validate and save a semantic scene plan manifest without queueing commands.

Build a semantic scene plan: save its manifest and queue validated Octane commands.

Load a saved semantic scene manifest by scene_id.

Add one object to a saved scene manifest and resave it.

Update one object in a saved scene manifest and resave it.

Remove one object from a saved scene manifest and resave it.

Load a saved scene manifest and queue its validated commands again.

Visualize numeric values as a 3D bar chart in Octane.

Visualize z=f(x,y) as a 3D surface. Expression may use x, y, r and safe math funcs.

Visualize xyz points as a 3D scatter plot in Octane.

Show Hermes' geometric avatar face as a scene guide in Octane.

Visualize GeoJSON (or a shapely geometry) as extruded geometry in Octane (WP7 geo grammar).

Accepts a GeoJSON FeatureCollection / Feature / bare geometry dict, or any object exposing geo_interface (e.g. a shapely geometry). Points become marker boxes; lines and polygons become extruded walls. Requires the optional geo extra (shapely) — if it is not installed the tool fails with an exact install hint rather than an import traceback.

Returns the generated asset path, the queued render commands, and the current bridge status, so the caller knows the next Octane action required.

Queue the Photoreal Product Studio recipe as a first-class tool (WP6).

Queue a photoreal planet scene (WP6). planet='earth' -> photoreal-earth-space, 'saturn' -> saturn-moons-space.

Queue the Knowledge Graph / network topology recipe as a first-class tool (WP6).