nodel-use

Interacting with Running Nodel Instances

Inspect and manage live Nodel hosts through their REST API.

Workflow

1. Identify the correct host and port. With no configured port, Nodel reuses its cached last port or falls back to 8085.
2. List nodes and confirm the exact target name before using a node-scoped endpoint.
3. Read console, activity, parameters, actions, and events before mutating state.
4. Test the narrowest safe action or diagnostic call, then re-read logs and state.
5. Use restart, rename, deletion, script, parameter, binding, or file writes only when the requested change requires them.

Quick Start

URL-encode node names in paths (My Node becomes My%20Node).

# List local nodes
curl http://localhost:8085/REST/nodes

# Read recent console entries
curl "http://localhost:8085/REST/nodes/My%20Node/console?from=0&max=50"

# Invoke a string action
curl -X POST "http://localhost:8085/REST/nodes/My%20Node/actions/Power/call" \
  -H "Content-Type: application/json" \
  -d '{"arg":"On"}'

Safety and Response Rules

• Inspect an action's metadata before choosing its argument shape.
• Send JSON to service endpoints, including {} when a POST has no explicit payload.
• Treat /files/save as the raw-file-content exception.
• Use the previous ISO started timestamp with hasRestarted when waiting for a restart.
• Require confirm=true for node removal and confirm the target name immediately beforehand.
• Add ?trace only when diagnosing serialization, Python, or unexpected server errors; routing and not-found failures deliberately omit stack traces.
• Preserve unrelated nodes, parameters, bindings, scripts, and files.

Debugging Order

1. Confirm the node exists and inspect discovery when remote visibility matters.
2. Read console for startup or protocol errors.
3. Read action/event activity and current parameters.
4. Inspect action and event metadata before invoking or evaluating anything.
5. Use eval for a narrow expression and exec only for deliberate diagnostic code.
6. Re-read the console after every active test.