# Runtime Modules

Mount runtime hook modules into this directory and point
`LOCAL_3D_RUNTIME_MODULE` at the file inside the container, for example:

```text
LOCAL_3D_RUNTIME_MODULE=/app/runtime-modules/trellis-runtime.mjs
```

The module can export either:

- a default object with `onSubmit` and optional `onCancel`
- a `createLocal3DContainerRuntime(environment)` factory returning that object

Each hook receives the provider API controller so it can call `updateTask(...)`,
`completeTask(...)`, `failTask(...)`, and `cancelTask(...)` while reusing the
packaged REST, SSE, and health-check surface.
