Skip to main content

Testing Automation Nodes

The Lumio CLI provides a local dev server for testing automation nodes without deploying.

Start the dev server​

lumio dev --automation-node

Output:

Automation Node Dev Server
Extension: My Custom Action
Node type: action

Commands:
  /execute [json]     - Execute the node with input data
  /webhook [json]     - Simulate a webhook POST payload
  /poll               - Trigger a poll cycle
  /config [json]      - Set node instance config
  /install-config [j] - Set extension install config
  /quit               - Exit

>

The dev server automatically detects category: "automation_node" in lumio.config.json and launches the appropriate simulator.

Testing action nodes​

Use /execute to invoke the action handler with input data:

> /config {"query": "latest posts"}
  Node config updated.

> /execute {"message": "Hello from automation"}
  [action] Executing with input: {"message":"Hello from automation"}
  [action] Result: { output: { result: "Processed: Hello from automation" }, status: "success" }
  [action] Completed in 12ms

Testing trigger nodes​

Webhook triggers​

Simulate a webhook payload with /webhook:

> /webhook {"event": "order.created", "id": "12345", "customer": {"name": "Alice"}, "total_price": 59.99, "currency": "USD"}
  [trigger:webhook] Received payload: {"event":"order.created",...}
  [trigger:webhook] Result: { fired: true, output: { order_id: "12345", customer_name: "Alice", total: 59.99, currency: "USD" } }

Polling triggers​

Trigger a poll cycle with /poll:

> /poll
  [trigger:poll] Polling...
  [trigger:poll] Result: { fired: false }

> /poll
  [trigger:poll] Polling...
  [trigger:poll] Result: { fired: true, output: { ... } }

Testing logic nodes​

Use /execute to test branching:

> /config {"threshold": 100}
  Node config updated.

> /execute {"amount": 150}
  [logic] Executing with input: {"amount":150}
  [logic] Branch: "above"

> /execute {"amount": 50}
  [logic] Executing with input: {"amount":50}
  [logic] Branch: "below"

Setting config​

Set the per-node config to test different configurations:

> /config {"threshold": 100, "comparison": "greater_than"}
  Node config updated.

Set the extension install config to test install-level settings:

> /install-config {"api_key": "test-key-123"}
  Install config updated.

Hot-reload​

The dev server watches server/handler.ts for changes and reloads automatically:

[hot-reload] Detected change in server/handler.ts
[hot-reload] Handler reloaded

Deploy​

Build and deploy like any other extension:

lumio deploy

After deployment, the automation node appears in the Automation Builder toolbar under the "Extensions" section.

Next steps​